const { test } = require('node:test'); const assert = require('node:assert/strict'); const { loadPlayback, captureEvents, dispatch, makeTarget, makeAdapter, diagnosticsSnapshot } = require('./playback_test_harness'); const { loadCapabilities } = require('./capabilities_test_harness'); test('playback reports no-owner no-handler and unsupported command outcomes explicitly', async () => { const noOwnerWindow = loadCapabilities(); const noOwner = await noOwnerWindow.feedBack.capabilities.dispatch({ capability: 'playback', command: 'inspect', requester: 'test' }); assert.equal(noOwner.status, 'no-owner'); const noHandlerWindow = loadCapabilities(); noHandlerWindow.feedBack.capabilities.registerOwner('playback', { pluginId: 'test-owner', commands: ['inspect'], events: [] }); const noHandler = await noHandlerWindow.feedBack.capabilities.dispatch({ capability: 'playback', command: 'inspect', requester: 'test' }); assert.equal(noHandler.status, 'no-handler'); const unsupportedWindow = loadPlayback(); const unsupported = await dispatch(unsupportedWindow, 'teleport', { requesterId: 'test' }); assert.equal(unsupported.status, 'unsupported-command'); }); test('playback registers as an active core owner', async () => { const window = loadPlayback(); const snapshot = window.feedBack.capabilities.snapshotDiagnostics(); const playback = snapshot.pipelines.find(pipeline => pipeline.name === 'playback'); assert.ok(playback, 'playback pipeline exists'); assert.equal(playback.review.lifecycle, 'active'); assert.ok(playback.participants.some(participant => participant.pluginId === 'core.playback' && participant.roles.includes('owner'))); assert.ok(playback.participants[0].commands.includes('start')); assert.ok(playback.participants[0].events.includes('seeked')); }); test('start requires a target and explicit user authorization for fresh audible playback', async () => { const window = loadPlayback(); const missing = await dispatch(window, 'start', { requesterId: 'plugin.practice', authorization: 'user-action' }); assert.equal(missing.status, 'no-target'); const noGesture = await dispatch(window, 'start', { requesterId: 'plugin.practice', target: makeTarget() }); assert.equal(noGesture.status, 'user-action-required'); const adapter = makeAdapter(); window.feedBack.playback.registerTransportAdapter(adapter); const events = captureEvents(window, 'playback:ready'); const result = await dispatch(window, 'start', { requesterId: 'core.player.controls', authorization: 'user-action', target: makeTarget() }); assert.equal(result.status, 'ready'); assert.ok(adapter.calls.some(call => call[0] === 'start')); assert.equal(events.length, 1); const state = diagnosticsSnapshot(window).state; assert.equal(state.state, 'ready'); assert.equal(state.target.targetId.startsWith('target-'), true); assert.match(state.target.settingsKey, /^settings-v1-[a-z0-9]{7}$/); assert.equal(events[0].payload.target.settingsKey, state.target.settingsKey); }); test('settings key is stable across arrangements while target id remains arrangement scoped', async () => { const window = loadPlayback(); window.feedBack.playback.registerTransportAdapter(makeAdapter()); const base = makeTarget({ filename: '/Users/example/DLC/Artist - Song_p.archive', arrangement: 'Lead', arrangementIndex: 0 }); await dispatch(window, 'start', { requesterId: 'core.player.controls', authorization: 'user-action', target: base }); const leadTarget = diagnosticsSnapshot(window).state.target; await dispatch(window, 'start', { requesterId: 'core.player.controls', authorization: 'user-action', target: { ...base, arrangement: 'Bass', arrangementIndex: 1 } }); const bassTarget = diagnosticsSnapshot(window).state.target; assert.match(leadTarget.settingsKey, /^settings-v1-[a-z0-9]{7}$/); assert.equal(bassTarget.settingsKey, leadTarget.settingsKey); assert.notEqual(bassTarget.targetId, leadTarget.targetId); }); test('unsafe caller-supplied settings keys are hashed before exposure', async () => { const window = loadPlayback(); window.feedBack.playback.registerTransportAdapter(makeAdapter()); await dispatch(window, 'start', { requesterId: 'core.player.controls', authorization: 'user-action', target: makeTarget({ settingsKey: 'settings-private-song-name' }), }); const encoded = JSON.stringify(diagnosticsSnapshot(window)); assert.match(diagnosticsSnapshot(window).state.target.settingsKey, /^settings-v1-[a-z0-9]{7}$/); assert.doesNotMatch(encoded, /private-song-name/); }); test('unsafe caller-supplied target ids are hashed before exposure', async () => { const window = loadPlayback(); window.feedBack.playback.registerTransportAdapter(makeAdapter()); await dispatch(window, 'start', { requesterId: 'core.player.controls', authorization: 'user-action', target: makeTarget({ targetId: 'target-private-song-name' }), }); const encoded = JSON.stringify(diagnosticsSnapshot(window)); assert.match(diagnosticsSnapshot(window).state.target.targetId, /^target-[a-z0-9]+$/); assert.doesNotMatch(encoded, /private-song-name/); }); test('dispatch requester owns playback command attribution', async () => { const window = loadPlayback(); window.feedBack.playback.registerTransportAdapter(makeAdapter()); const started = await dispatch(window, 'start', { requesterId: 'core.player.controls', authorization: 'user-action', target: makeTarget() }, 'plugin.remote'); const paused = await dispatch(window, 'pause', { requesterId: 'core.player.controls' }, 'plugin.remote'); const snapshot = diagnosticsSnapshot(window); const outcomeIds = snapshot.history.current.recentOutcomes.map(item => item.requesterId).join(','); assert.equal(started.status, 'ready'); assert.equal(paused.status, 'paused'); assert.equal(snapshot.state.transport.requesterId, 'plugin.remote'); assert.equal(outcomeIds.includes('core.player.controls'), false); assert.equal(outcomeIds.includes('plugin.remote'), true); }); test('transport commands emit ordered lifecycle events and normalize outcomes', async () => { const window = loadPlayback(); const adapter = makeAdapter({ duration: 10 }); window.feedBack.playback.registerTransportAdapter(adapter); const events = []; for (const eventName of ['playback:requested', 'playback:loading', 'playback:ready', 'playback:paused', 'playback:resumed', 'playback:seeking', 'playback:seeked', 'playback:loop-set', 'playback:loop-cleared']) { window.feedBack.on(eventName, event => events.push(event.type.replace('playback:', ''))); } await dispatch(window, 'start', { authorization: 'user-action', requesterId: 'core.player.controls', target: makeTarget() }); await dispatch(window, 'pause', { requesterId: 'core.player.controls', priority: 'user' }); await dispatch(window, 'resume', { requesterId: 'core.player.controls', priority: 'user' }); const seek = await dispatch(window, 'seek', { requesterId: 'core.player.controls', time: 999 }); const loop = await dispatch(window, 'set-loop', { requesterId: 'core.player.controls', startTime: 2, endTime: 4 }); const cleared = await dispatch(window, 'clear-loop', { requesterId: 'core.player.controls' }); assert.deepEqual(events.slice(0, 3), ['requested', 'loading', 'ready']); assert.ok(events.indexOf('seeking') < events.indexOf('seeked')); assert.equal(seek.status, 'clamped'); assert.equal(seek.payload.landedTime, 10); assert.equal(loop.status, 'active'); assert.equal(cleared.status, 'cleared'); }); test('seek preserves pre-seek playback state and external seek events update state', async () => { const window = loadPlayback(); window.feedBack.playback.registerTransportAdapter(makeAdapter({ startPlaying: true, seekResult: { completed: true, from: 1, to: 5 } })); await dispatch(window, 'start', { authorization: 'user-action', requesterId: 'core.player.controls', target: makeTarget() }); const seek = await dispatch(window, 'seek', { requesterId: 'core.player.controls', time: 5 }); assert.equal(seek.status, 'completed'); assert.equal(diagnosticsSnapshot(window).state.state, 'playing'); window.feedBack.playback.transportEvent('seeking', { requesterId: 'core.player.controls', media: { currentTime: 5 }, isPlaying: true }); assert.equal(diagnosticsSnapshot(window).state.state, 'seeking'); window.feedBack.playback.transportEvent('seeked', { requesterId: 'core.player.controls', media: { currentTime: 9 }, isPlaying: true }); assert.equal(diagnosticsSnapshot(window).state.state, 'playing'); }); test('clear-loop requires an active playback session', async () => { const window = loadPlayback(); window.feedBack.playback.registerTransportAdapter(makeAdapter()); const cleared = await dispatch(window, 'clear-loop', { requesterId: 'core.player.controls' }); assert.equal(cleared.status, 'no-target'); }); test('ended transport events and seek failure/rollback outcomes are distinguishable', async () => { const window = loadPlayback(); window.feedBack.playback.registerTransportAdapter(makeAdapter({ seekResult: { completed: true, from: 5, to: 4.5 } })); await dispatch(window, 'start', { authorization: 'user-action', requesterId: 'core.player.controls', target: makeTarget() }); const rolledBack = await dispatch(window, 'seek', { requesterId: 'core.player.controls', time: 8 }); assert.equal(rolledBack.status, 'rolled-back'); const failedWindow = loadPlayback(); failedWindow.feedBack.playback.registerTransportAdapter(makeAdapter({ seekError: 'seek failed' })); await dispatch(failedWindow, 'start', { authorization: 'user-action', requesterId: 'core.player.controls', target: makeTarget() }); const failed = await dispatch(failedWindow, 'seek', { requesterId: 'core.player.controls', time: 3 }); assert.equal(failed.status, 'failed'); assert.equal(failed.outcome, 'failed'); assert.equal(diagnosticsSnapshot(failedWindow).state.state, 'paused'); const unsupportedWindow = loadPlayback(); unsupportedWindow.feedBack.playback.registerTransportAdapter({ inspect: () => ({ currentTime: 0, duration: 120, isPlaying: true }), start: () => ({ currentTime: 0, duration: 120, isPlaying: true }) }); await dispatch(unsupportedWindow, 'start', { authorization: 'user-action', requesterId: 'core.player.controls', target: makeTarget() }); const unsupported = await dispatch(unsupportedWindow, 'seek', { requesterId: 'core.player.controls', time: 3 }); assert.equal(unsupported.status, 'unsupported-command'); assert.equal(diagnosticsSnapshot(unsupportedWindow).state.state, 'playing'); const malformedWindow = loadPlayback(); malformedWindow.feedBack.playback.registerTransportAdapter(makeAdapter({ seekResult: { completed: true, from: 2, to: NaN } })); await dispatch(malformedWindow, 'start', { authorization: 'user-action', requesterId: 'core.player.controls', target: makeTarget() }); const malformed = await dispatch(malformedWindow, 'seek', { requesterId: 'core.player.controls', time: 6 }); assert.equal(malformed.status, 'failed'); assert.match(malformed.reason, /malformed seek result/i); window.feedBack.playback.transportEvent('ended', { requesterId: 'core.player.controls', currentTime: 120 }); assert.equal(diagnosticsSnapshot(window).state.state, 'ended'); }); test('invalid loop boundaries do not mutate an active loop', async () => { const window = loadPlayback(); window.feedBack.playback.registerTransportAdapter(makeAdapter()); await dispatch(window, 'start', { authorization: 'user-action', requesterId: 'core.player.controls', target: makeTarget() }); await dispatch(window, 'set-loop', { requesterId: 'core.player.controls', startTime: 2, endTime: 4 }); const rejected = await dispatch(window, 'set-loop', { requesterId: 'core.player.controls', startTime: 8, endTime: 4 }); const loop = diagnosticsSnapshot(window).state.loop; assert.equal(rejected.status, 'rejected'); assert.equal(loop.state, 'active'); assert.equal(loop.startTime, 2); assert.equal(loop.endTime, 4); }); test('normal resume is denied after a user-priority pause until a user action resumes', async () => { const window = loadPlayback(); window.feedBack.playback.registerTransportAdapter(makeAdapter()); await dispatch(window, 'start', { authorization: 'user-action', requesterId: 'core.player.controls', target: makeTarget() }); await dispatch(window, 'pause', { requesterId: 'core.player.controls', priority: 'user' }); const blocked = await dispatch(window, 'resume', { requesterId: 'plugin.remote', priority: 'normal' }); assert.equal(blocked.status, 'denied'); const accepted = await dispatch(window, 'resume', { requesterId: 'core.player.controls', priority: 'user' }); assert.equal(accepted.status, 'playing'); }); test('stale and cancelled operations are reported distinctly', async () => { const window = loadPlayback(); window.feedBack.playback.registerTransportAdapter(makeAdapter({ seekResult: { completed: false, from: 2, to: NaN } })); await dispatch(window, 'start', { authorization: 'user-action', requesterId: 'core.player.controls', target: makeTarget() }); const sessionId = diagnosticsSnapshot(window).state.sessionId; const stale = await dispatch(window, 'pause', { requesterId: 'plugin.remote', sessionId: `${sessionId}-old` }); const cancelled = await dispatch(window, 'seek', { requesterId: 'core.player.controls', time: 8 }); assert.equal(stale.status, 'stale'); assert.equal(cancelled.status, 'cancelled'); });