@auraindustry/aurajs 0.1.1 → 0.1.3

package/src/conformance/cases/systems-and-gameplay-cases.mjs

@@ -375,9 +375,24 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
         'aura.multiplayer.sendInput',
         'aura.multiplayer.getPlayerInput',
         'aura.multiplayer.getAllPlayerInputs',
+        'aura.multiplayer.getRoomInfo',
+        'aura.multiplayer.getNetworkDiagnostics',
+        'aura.multiplayer.configureNetworkImpairment',
+        'aura.multiplayer.clearNetworkImpairment',
         'aura.multiplayer.setState',
         'aura.multiplayer.getState',
         'aura.multiplayer.getAllState',
+        'aura.multiplayer.getInterpolatedState',
+        'aura.multiplayer.getInterpolatedAllState',
+        'aura.multiplayer.configureRollbackLane',
+        'aura.multiplayer.getRollbackState',
+        'aura.multiplayer.getRollbackAllState',
+        'aura.multiplayer.clearRollbackLane',
+        'aura.multiplayer.getRollbackDiagnostics',
+        'aura.multiplayer.configureLocalPrediction',
+        'aura.multiplayer.setLocalPredictedState',
+        'aura.multiplayer.clearLocalPrediction',
+        'aura.multiplayer.getLocalPredictionDiagnostics',
         'aura.multiplayer.onMessage',
         'aura.multiplayer.onStateUpdate',
         'aura.multiplayer.onPlayerJoin',
@@ -398,11 +413,11 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
       nativeChecks: [
         {
           id: 'optional.multiplayer.disabled.guidance',
-          expression: "(() => { const guidance = (fn) => { try { fn(); return false; } catch (e) { const msg = String(e); return msg.includes('disabled') && msg.includes('modules.multiplayer'); } }; return guidance(() => aura.multiplayer.configure({ tickRate: 20 })) && guidance(() => aura.multiplayer.host(7000)) && guidance(() => aura.multiplayer.join('127.0.0.1', 7000)) && guidance(() => aura.multiplayer.leave()) && guidance(() => aura.multiplayer.stop()) && guidance(() => aura.multiplayer.getPlayers()) && guidance(() => aura.multiplayer.send(1, 'chat', { body: 'hi' })) && guidance(() => aura.multiplayer.broadcast('chat', { body: 'hi' })) && guidance(() => aura.multiplayer.sendInput({ left: true })) && guidance(() => aura.multiplayer.getPlayerInput(1)) && guidance(() => aura.multiplayer.getAllPlayerInputs()) && guidance(() => aura.multiplayer.setState('room', { phase: 'lobby' })) && guidance(() => aura.multiplayer.getState('room')) && guidance(() => aura.multiplayer.getAllState()) && guidance(() => aura.multiplayer.onMessage('chat', () => {})) && guidance(() => aura.multiplayer.onStateUpdate(() => {})) && guidance(() => aura.multiplayer.onPlayerJoin(() => {})) && guidance(() => aura.multiplayer.onPlayerLeave(() => {})) && guidance(() => aura.multiplayer.onDisconnect(() => {})) && guidance(() => aura.multiplayer.kick(1, 'afk')) && guidance(() => aura.multiplayer.setPlayerData(1, 'team', 'blue')) && guidance(() => aura.multiplayer.getPlayerData(1, 'team')) && guidance(() => aura.multiplayer.advertise({ name: 'Room' })) && guidance(() => aura.multiplayer.discover(7001, () => {})); })()",
+          expression: "(() => { const guidance = (fn) => { try { fn(); return false; } catch (e) { const msg = String(e); return msg.includes('disabled') && msg.includes('modules.multiplayer'); } }; return guidance(() => aura.multiplayer.configure({ tickRate: 20 })) && guidance(() => aura.multiplayer.host(7000)) && guidance(() => aura.multiplayer.join('127.0.0.1', 7000)) && guidance(() => aura.multiplayer.leave()) && guidance(() => aura.multiplayer.stop()) && guidance(() => aura.multiplayer.getPlayers()) && guidance(() => aura.multiplayer.send(1, 'chat', { body: 'hi' })) && guidance(() => aura.multiplayer.broadcast('chat', { body: 'hi' })) && guidance(() => aura.multiplayer.sendInput({ left: true })) && guidance(() => aura.multiplayer.getPlayerInput(1)) && guidance(() => aura.multiplayer.getAllPlayerInputs()) && guidance(() => aura.multiplayer.getRoomInfo()) && guidance(() => aura.multiplayer.getNetworkDiagnostics()) && guidance(() => aura.multiplayer.configureNetworkImpairment({ latencyMs: 1 })) && guidance(() => aura.multiplayer.clearNetworkImpairment()) && guidance(() => aura.multiplayer.setState('room', { phase: 'lobby' })) && guidance(() => aura.multiplayer.getState('room')) && guidance(() => aura.multiplayer.getAllState()) && guidance(() => aura.multiplayer.getInterpolatedState('room')) && guidance(() => aura.multiplayer.getInterpolatedAllState()) && guidance(() => aura.multiplayer.configureRollbackLane({ key: 'player_1', speed: 100, historyLimit: 8, bounds: { minX: 0, maxX: 100, minY: 0, maxY: 100 } })) && guidance(() => aura.multiplayer.getRollbackState('player_1')) && guidance(() => aura.multiplayer.getRollbackAllState()) && guidance(() => aura.multiplayer.clearRollbackLane()) && guidance(() => aura.multiplayer.getRollbackDiagnostics()) && guidance(() => aura.multiplayer.configureLocalPrediction({ key: 'player_1' })) && guidance(() => aura.multiplayer.setLocalPredictedState({ x: 1, y: 2 })) && guidance(() => aura.multiplayer.clearLocalPrediction()) && guidance(() => aura.multiplayer.getLocalPredictionDiagnostics()) && guidance(() => aura.multiplayer.onMessage('chat', () => {})) && guidance(() => aura.multiplayer.onStateUpdate(() => {})) && guidance(() => aura.multiplayer.onPlayerJoin(() => {})) && guidance(() => aura.multiplayer.onPlayerLeave(() => {})) && guidance(() => aura.multiplayer.onDisconnect(() => {})) && guidance(() => aura.multiplayer.kick(1, 'afk')) && guidance(() => aura.multiplayer.setPlayerData(1, 'team', 'blue')) && guidance(() => aura.multiplayer.getPlayerData(1, 'team')) && guidance(() => aura.multiplayer.advertise({ name: 'Room' })) && guidance(() => aura.multiplayer.discover(7001, () => {})); })()",
         },
         {
           id: 'optional.multiplayer.disabled.reason-codes',
-          expression: "(() => { const reasonCode = (method, invoke) => { try { invoke(); return false; } catch (e) { const msg = String(e); return msg.includes('aura.multiplayer.' + method + '()') && msg.includes('optional module \"multiplayer\" is disabled') && msg.includes('modules.multiplayer = true') && msg.includes('[reason:optional_module_multiplayer_disabled]'); } }; return reasonCode('configure', () => aura.multiplayer.configure({ tickRate: 20 })) && reasonCode('host', () => aura.multiplayer.host(7000)) && reasonCode('join', () => aura.multiplayer.join('127.0.0.1', 7000)) && reasonCode('send', () => aura.multiplayer.send(1, 'chat', { body: 'hi' })) && reasonCode('broadcast', () => aura.multiplayer.broadcast('chat', { body: 'hi' })) && reasonCode('sendInput', () => aura.multiplayer.sendInput({ left: true })) && reasonCode('getPlayerInput', () => aura.multiplayer.getPlayerInput(1)) && reasonCode('getAllPlayerInputs', () => aura.multiplayer.getAllPlayerInputs()) && reasonCode('setState', () => aura.multiplayer.setState('room', { phase: 'lobby' })) && reasonCode('getState', () => aura.multiplayer.getState('room')) && reasonCode('getAllState', () => aura.multiplayer.getAllState()) && reasonCode('onMessage', () => aura.multiplayer.onMessage('chat', () => {})) && reasonCode('onStateUpdate', () => aura.multiplayer.onStateUpdate(() => {})) && reasonCode('onPlayerJoin', () => aura.multiplayer.onPlayerJoin(() => {})) && reasonCode('onPlayerLeave', () => aura.multiplayer.onPlayerLeave(() => {})) && reasonCode('onDisconnect', () => aura.multiplayer.onDisconnect(() => {})) && reasonCode('kick', () => aura.multiplayer.kick(1, 'afk')) && reasonCode('setPlayerData', () => aura.multiplayer.setPlayerData(1, 'team', 'blue')) && reasonCode('getPlayerData', () => aura.multiplayer.getPlayerData(1, 'team')) && reasonCode('advertise', () => aura.multiplayer.advertise({ name: 'Room' })) && reasonCode('discover', () => aura.multiplayer.discover(7001, () => {})); })()",
+          expression: "(() => { const reasonCode = (method, invoke) => { try { invoke(); return false; } catch (e) { const msg = String(e); return msg.includes('aura.multiplayer.' + method + '()') && msg.includes('optional module \"multiplayer\" is disabled') && msg.includes('modules.multiplayer = true') && msg.includes('[reason:optional_module_multiplayer_disabled]'); } }; return reasonCode('configure', () => aura.multiplayer.configure({ tickRate: 20 })) && reasonCode('host', () => aura.multiplayer.host(7000)) && reasonCode('join', () => aura.multiplayer.join('127.0.0.1', 7000)) && reasonCode('send', () => aura.multiplayer.send(1, 'chat', { body: 'hi' })) && reasonCode('broadcast', () => aura.multiplayer.broadcast('chat', { body: 'hi' })) && reasonCode('sendInput', () => aura.multiplayer.sendInput({ left: true })) && reasonCode('getPlayerInput', () => aura.multiplayer.getPlayerInput(1)) && reasonCode('getAllPlayerInputs', () => aura.multiplayer.getAllPlayerInputs()) && reasonCode('getRoomInfo', () => aura.multiplayer.getRoomInfo()) && reasonCode('getNetworkDiagnostics', () => aura.multiplayer.getNetworkDiagnostics()) && reasonCode('configureNetworkImpairment', () => aura.multiplayer.configureNetworkImpairment({ latencyMs: 1 })) && reasonCode('clearNetworkImpairment', () => aura.multiplayer.clearNetworkImpairment()) && reasonCode('setState', () => aura.multiplayer.setState('room', { phase: 'lobby' })) && reasonCode('getState', () => aura.multiplayer.getState('room')) && reasonCode('getAllState', () => aura.multiplayer.getAllState()) && reasonCode('getInterpolatedState', () => aura.multiplayer.getInterpolatedState('room')) && reasonCode('getInterpolatedAllState', () => aura.multiplayer.getInterpolatedAllState()) && reasonCode('configureRollbackLane', () => aura.multiplayer.configureRollbackLane({ key: 'player_1', speed: 100, historyLimit: 8, bounds: { minX: 0, maxX: 100, minY: 0, maxY: 100 } })) && reasonCode('getRollbackState', () => aura.multiplayer.getRollbackState('player_1')) && reasonCode('getRollbackAllState', () => aura.multiplayer.getRollbackAllState()) && reasonCode('clearRollbackLane', () => aura.multiplayer.clearRollbackLane()) && reasonCode('getRollbackDiagnostics', () => aura.multiplayer.getRollbackDiagnostics()) && reasonCode('configureLocalPrediction', () => aura.multiplayer.configureLocalPrediction({ key: 'player_1' })) && reasonCode('setLocalPredictedState', () => aura.multiplayer.setLocalPredictedState({ x: 1, y: 2 })) && reasonCode('clearLocalPrediction', () => aura.multiplayer.clearLocalPrediction()) && reasonCode('getLocalPredictionDiagnostics', () => aura.multiplayer.getLocalPredictionDiagnostics()) && reasonCode('onMessage', () => aura.multiplayer.onMessage('chat', () => {})) && reasonCode('onStateUpdate', () => aura.multiplayer.onStateUpdate(() => {})) && reasonCode('onPlayerJoin', () => aura.multiplayer.onPlayerJoin(() => {})) && reasonCode('onPlayerLeave', () => aura.multiplayer.onPlayerLeave(() => {})) && reasonCode('onDisconnect', () => aura.multiplayer.onDisconnect(() => {})) && reasonCode('kick', () => aura.multiplayer.kick(1, 'afk')) && reasonCode('setPlayerData', () => aura.multiplayer.setPlayerData(1, 'team', 'blue')) && reasonCode('getPlayerData', () => aura.multiplayer.getPlayerData(1, 'team')) && reasonCode('advertise', () => aura.multiplayer.advertise({ name: 'Room' })) && reasonCode('discover', () => aura.multiplayer.discover(7001, () => {})); })()",
         },
       ],
       nativeFrames: 2,
@@ -429,6 +444,10 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
         'aura.multiplayer.sendInput',
         'aura.multiplayer.getPlayerInput',
         'aura.multiplayer.getAllPlayerInputs',
+        'aura.multiplayer.getRoomInfo',
+        'aura.multiplayer.getNetworkDiagnostics',
+        'aura.multiplayer.configureNetworkImpairment',
+        'aura.multiplayer.clearNetworkImpairment',
         'aura.multiplayer.send',
         'aura.multiplayer.broadcast',
         'aura.multiplayer.onMessage',
@@ -440,6 +459,17 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
         'aura.multiplayer.setState',
         'aura.multiplayer.getState',
         'aura.multiplayer.getAllState',
+        'aura.multiplayer.getInterpolatedState',
+        'aura.multiplayer.getInterpolatedAllState',
+        'aura.multiplayer.configureRollbackLane',
+        'aura.multiplayer.getRollbackState',
+        'aura.multiplayer.getRollbackAllState',
+        'aura.multiplayer.clearRollbackLane',
+        'aura.multiplayer.getRollbackDiagnostics',
+        'aura.multiplayer.configureLocalPrediction',
+        'aura.multiplayer.setLocalPredictedState',
+        'aura.multiplayer.clearLocalPrediction',
+        'aura.multiplayer.getLocalPredictionDiagnostics',
         'aura.multiplayer.onStateUpdate',
         'aura.multiplayer.onPlayerJoin',
         'aura.multiplayer.onPlayerLeave',
@@ -454,11 +484,11 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
       nativeChecks: [
         {
           id: 'optional.multiplayer.enabled.runtime',
-          expression: "(() => { try { const api = aura.multiplayer; if (!api || typeof api !== 'object') return false; const methods = ['configure', 'host', 'join', 'leave', 'stop', 'isHost', 'isClient', 'isConnected', 'getLocalId', 'getPlayers', 'getPlayerCount', 'getPing', 'getServerTime', 'sendInput', 'getPlayerInput', 'getAllPlayerInputs', 'send', 'broadcast', 'onMessage', 'kick', 'setPlayerData', 'getPlayerData', 'advertise', 'discover', 'setState', 'getState', 'getAllState', 'onStateUpdate', 'onPlayerJoin', 'onPlayerLeave', 'onDisconnect']; if (!methods.every((name) => typeof api[name] === 'function')) return false; const notDisabledOrPlaceholder = (invoke, validate = () => true) => { try { const value = invoke(); return validate(value); } catch (e) { const msg = String(e); const lower = msg.toLowerCase(); return !msg.includes('optional module \"multiplayer\" is disabled') && !msg.includes('[reason:optional_module_multiplayer_disabled]') && !lower.includes('not implemented yet') && !lower.includes('placeholder'); } }; const messageEvents = []; const stateEvents = []; const joinEvents = []; const leaveEvents = []; const disconnectEvents = []; const callbackRegisterOk = api.onMessage('chat', (sender, data) => { messageEvents.push(`${sender}:${(data && data.body) || ''}`); }) === true && api.onStateUpdate((snapshot) => { stateEvents.push(Object.keys(snapshot || {}).length); }) === true && api.onPlayerJoin((player) => { joinEvents.push(player && player.id); }) === true && api.onPlayerLeave((player) => { leaveEvents.push(player && player.id); }) === true && api.onDisconnect((reason) => { disconnectEvents.push(reason); }) === true; const status = { isHost: api.isHost(), isClient: api.isClient(), isConnected: api.isConnected(), localId: api.getLocalId(), players: api.getPlayers(), playerCount: api.getPlayerCount(), ping: api.getPing(), serverTime: api.getServerTime(), playerInput: api.getPlayerInput(1), allInputs: api.getAllPlayerInputs(), state: api.getState('room'), allState: api.getAllState(), playerData: api.getPlayerData(1, 'team') }; const defaultsValid = typeof status.isHost === 'boolean' && typeof status.isClient === 'boolean' && typeof status.isConnected === 'boolean' && (status.localId === null || Number.isFinite(status.localId)) && Array.isArray(status.players) && Number.isFinite(status.playerCount) && (status.ping === null || Number.isFinite(status.ping)) && (status.serverTime === null || Number.isFinite(status.serverTime)) && (status.playerInput === null || typeof status.playerInput === 'object') && (status.allInputs === null || typeof status.allInputs === 'object') && status.allState && typeof status.allState === 'object' && (status.playerData === null || typeof status.playerData === 'object' || typeof status.playerData === 'string' || typeof status.playerData === 'number' || typeof status.playerData === 'boolean') && (status.state === null || typeof status.state === 'object' || typeof status.state === 'string' || typeof status.state === 'number' || typeof status.state === 'boolean'); const sendInputStatus = notDisabledOrPlaceholder(() => api.sendInput({ left: true }), (value) => typeof value === 'boolean'); const sendStatus = notDisabledOrPlaceholder(() => api.send(1, 'chat', { body: 'hi' }), (value) => typeof value === 'boolean'); const broadcastStatus = notDisabledOrPlaceholder(() => api.broadcast('chat', { body: 'hi' }), (value) => typeof value === 'boolean'); const setStateStatus = notDisabledOrPlaceholder(() => api.setState('room', { phase: 'lobby' }), (value) => typeof value === 'boolean'); const kickStatus = notDisabledOrPlaceholder(() => api.kick(1, 'afk'), (value) => typeof value === 'boolean'); const setPlayerDataStatus = notDisabledOrPlaceholder(() => api.setPlayerData(1, 'team', 'blue'), (value) => typeof value === 'boolean'); const advertiseStatus = notDisabledOrPlaceholder(() => api.advertise({ name: 'Room' }), (value) => typeof value === 'boolean'); const discoverStatus = notDisabledOrPlaceholder(() => api.discover(7001, () => {}), (value) => value === true); const configureStatus = notDisabledOrPlaceholder(() => api.configure({ tickRate: 20, maxPlayers: 4 }), (value) => value === true); const hostStatus = notDisabledOrPlaceholder(() => api.host(7000), (value) => typeof value === 'boolean'); const joinStatus = notDisabledOrPlaceholder(() => api.join('127.0.0.1', 7000), (value) => typeof value === 'boolean'); const leaveStatus = notDisabledOrPlaceholder(() => api.leave(), (value) => typeof value === 'boolean'); const stopStatus = notDisabledOrPlaceholder(() => api.stop(), (value) => typeof value === 'boolean'); return callbackRegisterOk && defaultsValid && configureStatus && sendInputStatus && sendStatus && broadcastStatus && setStateStatus && kickStatus && setPlayerDataStatus && advertiseStatus && discoverStatus && hostStatus && joinStatus && leaveStatus && stopStatus && messageEvents.length === 0 && stateEvents.length === 0 && joinEvents.length === 0 && leaveEvents.length === 0 && disconnectEvents.length === 0; } catch (_) { return false; } })()",
+          expression: "(() => { try { const api = aura.multiplayer; if (!api || typeof api !== 'object') return false; const methods = ['configure', 'host', 'join', 'leave', 'stop', 'isHost', 'isClient', 'isConnected', 'getLocalId', 'getPlayers', 'getPlayerCount', 'getPing', 'getServerTime', 'sendInput', 'getPlayerInput', 'getAllPlayerInputs', 'getRoomInfo', 'getNetworkDiagnostics', 'configureNetworkImpairment', 'clearNetworkImpairment', 'send', 'broadcast', 'onMessage', 'kick', 'setPlayerData', 'getPlayerData', 'advertise', 'discover', 'setState', 'getState', 'getAllState', 'getInterpolatedState', 'getInterpolatedAllState', 'configureRollbackLane', 'getRollbackState', 'getRollbackAllState', 'clearRollbackLane', 'getRollbackDiagnostics', 'configureLocalPrediction', 'setLocalPredictedState', 'clearLocalPrediction', 'getLocalPredictionDiagnostics', 'onStateUpdate', 'onPlayerJoin', 'onPlayerLeave', 'onDisconnect']; if (!methods.every((name) => typeof api[name] === 'function')) return false; const notDisabledOrPlaceholder = (invoke, validate = () => true) => { try { const value = invoke(); return validate(value); } catch (e) { const msg = String(e); const lower = msg.toLowerCase(); return !msg.includes('optional module \"multiplayer\" is disabled') && !msg.includes('[reason:optional_module_multiplayer_disabled]') && !lower.includes('not implemented yet') && !lower.includes('placeholder'); } }; const messageEvents = []; const stateEvents = []; const joinEvents = []; const leaveEvents = []; const disconnectEvents = []; const callbackRegisterOk = api.onMessage('chat', (sender, data) => { messageEvents.push(`${sender}:${(data && data.body) || ''}`); }) === true && api.onStateUpdate((snapshot) => { stateEvents.push(Object.keys(snapshot || {}).length); }) === true && api.onPlayerJoin((player) => { joinEvents.push(player && player.id); }) === true && api.onPlayerLeave((player) => { leaveEvents.push(player && player.id); }) === true && api.onDisconnect((reason) => { disconnectEvents.push(reason); }) === true; const status = { isHost: api.isHost(), isClient: api.isClient(), isConnected: api.isConnected(), localId: api.getLocalId(), players: api.getPlayers(), playerCount: api.getPlayerCount(), ping: api.getPing(), serverTime: api.getServerTime(), playerInput: api.getPlayerInput(1), allInputs: api.getAllPlayerInputs(), roomInfo: api.getRoomInfo(), networkDiagnostics: api.getNetworkDiagnostics(), state: api.getState('room'), allState: api.getAllState(), interpolatedState: api.getInterpolatedState('room'), interpolatedAllState: api.getInterpolatedAllState(), rollbackState: api.getRollbackState('player_1'), rollbackAllState: api.getRollbackAllState(), rollbackDiagnostics: api.getRollbackDiagnostics(), localPredictionDiagnostics: api.getLocalPredictionDiagnostics(), playerData: api.getPlayerData(1, 'team') }; const defaultsValid = typeof status.isHost === 'boolean' && typeof status.isClient === 'boolean' && typeof status.isConnected === 'boolean' && (status.localId === null || Number.isFinite(status.localId)) && Array.isArray(status.players) && Number.isFinite(status.playerCount) && (status.ping === null || Number.isFinite(status.ping)) && (status.serverTime === null || Number.isFinite(status.serverTime)) && (status.playerInput === null || typeof status.playerInput === 'object') && (status.allInputs === null || typeof status.allInputs === 'object') && (status.roomInfo === null || typeof status.roomInfo === 'object') && status.networkDiagnostics && typeof status.networkDiagnostics === 'object' && status.allState && typeof status.allState === 'object' && status.interpolatedAllState && typeof status.interpolatedAllState === 'object' && status.rollbackAllState && typeof status.rollbackAllState === 'object' && status.rollbackDiagnostics && typeof status.rollbackDiagnostics === 'object' && status.localPredictionDiagnostics && typeof status.localPredictionDiagnostics === 'object' && (status.playerData === null || typeof status.playerData === 'object' || typeof status.playerData === 'string' || typeof status.playerData === 'number' || typeof status.playerData === 'boolean') && (status.state === null || typeof status.state === 'object' || typeof status.state === 'string' || typeof status.state === 'number' || typeof status.state === 'boolean') && (status.interpolatedState === null || typeof status.interpolatedState === 'object' || typeof status.interpolatedState === 'string' || typeof status.interpolatedState === 'number' || typeof status.interpolatedState === 'boolean') && (status.rollbackState === null || typeof status.rollbackState === 'object' || typeof status.rollbackState === 'string' || typeof status.rollbackState === 'number' || typeof status.rollbackState === 'boolean'); const sendInputStatus = notDisabledOrPlaceholder(() => api.sendInput({ left: true }), (value) => typeof value === 'boolean'); const sendStatus = notDisabledOrPlaceholder(() => api.send(1, 'chat', { body: 'hi' }), (value) => typeof value === 'boolean'); const broadcastStatus = notDisabledOrPlaceholder(() => api.broadcast('chat', { body: 'hi' }), (value) => typeof value === 'boolean'); const setStateStatus = notDisabledOrPlaceholder(() => api.setState('room', { phase: 'lobby' }), (value) => typeof value === 'boolean'); const kickStatus = notDisabledOrPlaceholder(() => api.kick(1, 'afk'), (value) => typeof value === 'boolean'); const setPlayerDataStatus = notDisabledOrPlaceholder(() => api.setPlayerData(1, 'team', 'blue'), (value) => typeof value === 'boolean'); const advertiseStatus = notDisabledOrPlaceholder(() => api.advertise({ name: 'Room' }), (value) => typeof value === 'boolean'); const discoverStatus = notDisabledOrPlaceholder(() => api.discover(7001, () => {}), (value) => value === true); const configureStatus = notDisabledOrPlaceholder(() => api.configure({ tickRate: 20, maxPlayers: 4 }), (value) => value === true); const rollbackConfigureStatus = notDisabledOrPlaceholder(() => api.configureRollbackLane({ key: 'player_1', speed: 100, historyLimit: 8, bounds: { minX: 0, maxX: 100, minY: 0, maxY: 100 } }), (value) => value === true); const predictionConfigureStatus = notDisabledOrPlaceholder(() => api.configureLocalPrediction({ key: 'player_1' }), (value) => value === true); const impairmentConfigureStatus = notDisabledOrPlaceholder(() => api.configureNetworkImpairment({ latencyMs: 5, jitterMs: 1, lossRate: 0.25, seed: 7 }), (value) => value === true); const predictionSetStatus = notDisabledOrPlaceholder(() => api.setLocalPredictedState({ x: 1, y: 2, hidden: false }), (value) => typeof value === 'boolean'); const rollbackClearStatus = notDisabledOrPlaceholder(() => api.clearRollbackLane(), (value) => typeof value === 'boolean'); const predictionClearStatus = notDisabledOrPlaceholder(() => api.clearLocalPrediction(), (value) => typeof value === 'boolean'); const impairmentClearStatus = notDisabledOrPlaceholder(() => api.clearNetworkImpairment(), (value) => typeof value === 'boolean'); const rollbackDiagnosticsStatus = notDisabledOrPlaceholder(() => api.getRollbackDiagnostics(), (value) => value && typeof value === 'object'); const predictionDiagnosticsStatus = notDisabledOrPlaceholder(() => api.getLocalPredictionDiagnostics(), (value) => value && typeof value === 'object'); const hostStatus = notDisabledOrPlaceholder(() => api.host(7000), (value) => typeof value === 'boolean'); const joinStatus = notDisabledOrPlaceholder(() => api.join('127.0.0.1', 7000), (value) => typeof value === 'boolean'); const leaveStatus = notDisabledOrPlaceholder(() => api.leave(), (value) => typeof value === 'boolean'); const stopStatus = notDisabledOrPlaceholder(() => api.stop(), (value) => typeof value === 'boolean'); return callbackRegisterOk && defaultsValid && configureStatus && rollbackConfigureStatus && predictionConfigureStatus && impairmentConfigureStatus && predictionSetStatus && rollbackClearStatus && predictionClearStatus && impairmentClearStatus && rollbackDiagnosticsStatus && predictionDiagnosticsStatus && sendInputStatus && sendStatus && broadcastStatus && setStateStatus && kickStatus && setPlayerDataStatus && advertiseStatus && discoverStatus && hostStatus && joinStatus && leaveStatus && stopStatus && messageEvents.length === 0 && stateEvents.length === 0 && joinEvents.length === 0 && leaveEvents.length === 0 && disconnectEvents.length === 0; } catch (_) { return false; } })()",
         },
         {
           id: 'optional.multiplayer.enabled.invalid-input.reason-codes',
-          expression: "(() => { const expectThrow = (fn, token) => { try { fn(); return false; } catch (e) { const msg = String(e); const lower = msg.toLowerCase(); return msg.includes(token) && !msg.includes('optional module \"multiplayer\" is disabled') && !msg.includes('[reason:optional_module_multiplayer_disabled]') && !lower.includes('not implemented yet') && !lower.includes('placeholder'); } }; return expectThrow(() => aura.multiplayer.leave(), 'aura.multiplayer.leave() failed [reason:invalid_state]') && expectThrow(() => aura.multiplayer.stop(), 'aura.multiplayer.stop() failed [reason:invalid_state]') && expectThrow(() => aura.multiplayer.getPlayerInput('bad'), 'aura.multiplayer.getPlayerInput(playerId): playerId must be a positive integer') && expectThrow(() => aura.multiplayer.send('bad', 'chat', {}), 'aura.multiplayer.send(targetId, type, data): targetId must be a positive integer') && expectThrow(() => aura.multiplayer.send(1, '', {}), 'aura.multiplayer.send(targetId, type, data): type must be a non-empty string') && expectThrow(() => aura.multiplayer.broadcast('', {}), 'aura.multiplayer.broadcast(type, data): type must be a non-empty string') && expectThrow(() => aura.multiplayer.onMessage('chat', 123), 'aura.multiplayer.onMessage(type, callback): callback must be a function') && expectThrow(() => aura.multiplayer.onStateUpdate(123), 'aura.multiplayer.onStateUpdate(callback): callback must be a function') && expectThrow(() => aura.multiplayer.discover('bad', () => {}), 'aura.multiplayer.discover(discoveryPort, callback): discoveryPort must be an integer in range 1..65535') && expectThrow(() => aura.multiplayer.getState(''), 'aura.multiplayer.getState(key): key must be a non-empty string') && expectThrow(() => aura.multiplayer.setState('', {}), 'aura.multiplayer.setState(key, value): key must be a non-empty string') && expectThrow(() => aura.multiplayer.getPlayerData(1, ''), 'aura.multiplayer.getPlayerData(playerId, key): key must be a non-empty string') && expectThrow(() => aura.multiplayer.setPlayerData(1, '', 'blue'), 'aura.multiplayer.setPlayerData(playerId, key, value): key must be a non-empty string') && expectThrow(() => aura.multiplayer.advertise({ name: '' }), 'aura.multiplayer.advertise(options): name must be a non-empty string'); })()",
+          expression: "(() => { const expectThrow = (fn, token) => { try { fn(); return false; } catch (e) { const msg = String(e); const lower = msg.toLowerCase(); return msg.includes(token) && !msg.includes('optional module \"multiplayer\" is disabled') && !msg.includes('[reason:optional_module_multiplayer_disabled]') && !lower.includes('not implemented yet') && !lower.includes('placeholder'); } }; return expectThrow(() => aura.multiplayer.leave(), 'aura.multiplayer.leave() failed [reason:invalid_state]') && expectThrow(() => aura.multiplayer.stop(), 'aura.multiplayer.stop() failed [reason:invalid_state]') && expectThrow(() => aura.multiplayer.getPlayerInput('bad'), 'aura.multiplayer.getPlayerInput(playerId): playerId must be a positive integer') && expectThrow(() => aura.multiplayer.send('bad', 'chat', {}), 'aura.multiplayer.send(targetId, type, data): targetId must be a positive integer') && expectThrow(() => aura.multiplayer.send(1, '', {}), 'aura.multiplayer.send(targetId, type, data): type must be a non-empty string') && expectThrow(() => aura.multiplayer.broadcast('', {}), 'aura.multiplayer.broadcast(type, data): type must be a non-empty string') && expectThrow(() => aura.multiplayer.onMessage('chat', 123), 'aura.multiplayer.onMessage(type, callback): callback must be a function') && expectThrow(() => aura.multiplayer.onStateUpdate(123), 'aura.multiplayer.onStateUpdate(callback): callback must be a function') && expectThrow(() => aura.multiplayer.discover('bad', () => {}), 'aura.multiplayer.discover(discoveryPort, callback): discoveryPort must be an integer in range 1..65535') && expectThrow(() => aura.multiplayer.getState(''), 'aura.multiplayer.getState(key): key must be a non-empty string') && expectThrow(() => aura.multiplayer.getInterpolatedState(''), 'aura.multiplayer.getInterpolatedState(key): key must be a non-empty string') && expectThrow(() => aura.multiplayer.setState('', {}), 'aura.multiplayer.setState(key, value): key must be a non-empty string') && expectThrow(() => aura.multiplayer.configureRollbackLane('bad'), 'aura.multiplayer.configureRollbackLane(options): options must be an object') && expectThrow(() => aura.multiplayer.configureRollbackLane({ key: '' }), 'aura.multiplayer.configureRollbackLane(options): key must be a non-empty string') && expectThrow(() => aura.multiplayer.configureRollbackLane({ key: 'player', speed: 0 }), 'aura.multiplayer.configureRollbackLane(options): speed must be a positive finite number') && expectThrow(() => aura.multiplayer.configureRollbackLane({ key: 'player', historyLimit: 1 }), 'aura.multiplayer.configureRollbackLane(options): historyLimit must be an integer >= 2') && expectThrow(() => aura.multiplayer.configureRollbackLane({ key: 'player', bounds: 'bad' }), 'aura.multiplayer.configureRollbackLane(options): bounds must be an object') && expectThrow(() => aura.multiplayer.getRollbackState(''), 'aura.multiplayer.getRollbackState(key): key must be a non-empty string') && expectThrow(() => aura.multiplayer.getRollbackDiagnostics(123), 'aura.multiplayer.getRollbackDiagnostics(key): key must be a string when provided') && expectThrow(() => aura.multiplayer.configureLocalPrediction('bad'), 'aura.multiplayer.configureLocalPrediction(options): options must be an object') && expectThrow(() => aura.multiplayer.configureLocalPrediction({ key: '' }), 'aura.multiplayer.configureLocalPrediction(options): key must be a non-empty string') && expectThrow(() => aura.multiplayer.configureLocalPrediction({ key: 'player', correctionAlpha: 0 }), 'aura.multiplayer.configureLocalPrediction(options): correctionAlpha must be a number in range (0, 1]') && expectThrow(() => aura.multiplayer.configureLocalPrediction({ key: 'player', snapDistance: 0 }), 'aura.multiplayer.configureLocalPrediction(options): snapDistance must be a positive finite number') && expectThrow(() => aura.multiplayer.configureNetworkImpairment('bad'), 'aura.multiplayer.configureNetworkImpairment(options): options must be an object') && expectThrow(() => aura.multiplayer.configureNetworkImpairment({ latencyMs: -1 }), 'aura.multiplayer.configureNetworkImpairment(options): latencyMs must be a non-negative number') && expectThrow(() => aura.multiplayer.configureNetworkImpairment({ lossRate: 2 }), 'aura.multiplayer.configureNetworkImpairment(options): lossRate must be a number in range 0..1') && expectThrow(() => aura.multiplayer.configureNetworkImpairment({ seed: -1 }), 'aura.multiplayer.configureNetworkImpairment(options): seed must be a non-negative integer') && expectThrow(() => aura.multiplayer.setLocalPredictedState(1), 'aura.multiplayer.setLocalPredictedState(value): value must be a JSON object') && expectThrow(() => aura.multiplayer.getPlayerData(1, ''), 'aura.multiplayer.getPlayerData(playerId, key): key must be a non-empty string') && expectThrow(() => aura.multiplayer.setPlayerData(1, '', 'blue'), 'aura.multiplayer.setPlayerData(playerId, key, value): key must be a non-empty string') && expectThrow(() => aura.multiplayer.advertise({ name: '' }), 'aura.multiplayer.advertise(options): name must be a non-empty string'); })()",
         },
       ],
       nativeFrames: 2,
@@ -472,6 +502,24 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
         'aura.multiplayer.configure',
         'aura.multiplayer.host',
         'aura.multiplayer.join',
+        'aura.multiplayer.getRoomInfo',
+        'aura.multiplayer.getNetworkDiagnostics',
+        'aura.multiplayer.getState',
+        'aura.multiplayer.getAllState',
+        'aura.multiplayer.getInterpolatedState',
+        'aura.multiplayer.getInterpolatedAllState',
+        'aura.multiplayer.configureRollbackLane',
+        'aura.multiplayer.getRollbackState',
+        'aura.multiplayer.getRollbackAllState',
+        'aura.multiplayer.clearRollbackLane',
+        'aura.multiplayer.getRollbackDiagnostics',
+        'aura.multiplayer.configureLocalPrediction',
+        'aura.multiplayer.configureNetworkImpairment',
+        'aura.multiplayer.setLocalPredictedState',
+        'aura.multiplayer.clearNetworkImpairment',
+        'aura.multiplayer.clearLocalPrediction',
+        'aura.multiplayer.getLocalPredictionDiagnostics',
+        'aura.multiplayer.onStateUpdate',
         'aura.multiplayer.stop',
       ],
       nativeEnv: {
@@ -488,9 +536,475 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
           id: 'multiplayer.local-room-code.reason-codes',
           expression: "(() => { const flow = globalThis.__multiplayerLocalRoomFlow || {}; return typeof flow.invalidJoin === 'string' && flow.invalidJoin.includes('[reason:invalid_room_code]') && typeof flow.missingJoin === 'string' && flow.missingJoin.includes('[reason:room_code_not_found]'); })()",
         },
+        {
+          id: 'multiplayer.local-room-code.rollback-diagnostics',
+          expression: "(() => { const flow = globalThis.__multiplayerLocalRoomFlow || {}; const meta = Array.isArray(flow.stateUpdateMeta) && flow.stateUpdateMeta.length === 1 ? JSON.parse(flow.stateUpdateMeta[0]) : null; const diagnostics = flow.rollbackDiagnostics; return flow.joinOk === true && flow.hostRoomInfo && flow.hostRoomInfo.role === 'host' && flow.hostRoomInfo.transportPath === 'local_room' && flow.hostRoomInfo.requestedMode === 'local' && flow.clientRoomInfo && flow.clientRoomInfo.role === 'client' && flow.clientRoomInfo.transportPath === 'local_room' && flow.clientRoomInfo.requestedMode === 'local' && meta && meta.sequence === 2 && meta.serverTick === 2 && meta.serverTimeMs === 1050 && meta.tickIntervalMs === 50 && meta.source === 'delta' && meta.jitterMs === 40 && meta.bufferDelayMs === 90 && meta.historyDepth === 2 && meta.bufferedServerTimeMs === 960 && meta.inputAckTicks && meta.inputAckTicks['1'] === 1 && flow.rawPlayerState && flow.rawPlayerState.x === 4 && flow.rawPlayerState.y === 0 && flow.interpolatedPlayerState && flow.interpolatedPlayerState.x === 5 && flow.interpolatedPlayerState.y === 0 && flow.rollbackPlayerState && flow.rollbackPlayerState.x === 6 && flow.rollbackPlayerState.y === 0 && flow.rawAllState && flow.rawAllState.player && flow.rawAllState.player.x === 4 && flow.interpolatedAllState && flow.interpolatedAllState.player && flow.interpolatedAllState.player.x === 5 && flow.rollbackAllState && flow.rollbackAllState.player && flow.rollbackAllState.player.x === 6 && diagnostics && diagnostics.enabled === true && diagnostics.key === 'player' && diagnostics.correctionCount === 1 && diagnostics.rollbackCount === 1 && diagnostics.replayCount === 1 && diagnostics.continuityResetCount === 0 && diagnostics.lastCorrectionMagnitude === 2 && diagnostics.lastReasonCode === 'authoritative_replay' && diagnostics.lastAuthoritativeSequence === 2 && diagnostics.lastAuthoritativeServerTick === 2 && diagnostics.lastAckInputTick === 1; })()",
+        },
+        {
+          id: 'multiplayer.local-room-code.network-diagnostics',
+          expression: "(() => { const flow = globalThis.__multiplayerLocalRoomFlow || {}; const before = flow.networkDiagnosticsBeforeClear; const during = flow.networkDiagnosticsWithImpairment; const after = flow.networkDiagnosticsAfterClear; return flow.impairmentConfigured === true && flow.impairmentCleared === true && before && before.connected === true && before.role === 'client' && before.scope === 'local' && before.transportPath === 'local_room' && before.requestedMode === 'local' && before.transportStatus === 'local_room_ready' && before.lastReasonCode === null && before.jitterMs === 40 && before.bufferDelayMs === 90 && before.historyDepth === 2 && before.bufferedServerTimeMs === 960 && before.lastSequence === 2 && before.lastServerTick === 2 && before.lastSnapshotServerTimeMs === 1050 && before.lastSnapshotTickIntervalMs === 50 && before.lastSnapshotSource === 'delta' && before.sequenceGapCount === 0 && before.delayedEventCount === 0 && before.droppedEventCount === 0 && before.queuedEventCount === 0 && before.rollbackCount === 1 && before.replayCount === 1 && before.continuityResetCount === 0 && before.lastRollbackReasonCode === 'authoritative_replay' && before.impairment && before.impairment.enabled === false && during && during.impairment && during.impairment.enabled === true && during.impairment.latencyMs === 60 && during.impairment.jitterMs === 5 && during.impairment.lossRate === 0.25 && during.impairment.outageMs === 0 && during.impairment.seed === 7 && after && after.impairment && after.impairment.enabled === false; })()",
+        },
       ],
       nativeFrames: 2,
-      source: `aura.setup = function () { aura.multiplayer.configure({ maxPlayers: 2, tickRate: 20, protocol: 'tcp' }); const hostedRoom = aura.multiplayer.host({ port: 0, roomCode: 'AURA2P', name: 'Local Room Proof' }); const hostStop = aura.multiplayer.stop(); const invalidJoin = (() => { try { aura.multiplayer.join('bad!'); return 'no-error'; } catch (error) { return String(error && error.message ? error.message : error); } })(); const missingJoin = (() => { try { aura.multiplayer.join('WXYZ'); return 'no-error'; } catch (error) { return String(error && error.message ? error.message : error); } })(); globalThis.__multiplayerLocalRoomFlow = { hostedRoom, hostStop, invalidJoin, missingJoin }; };`,
+      source: `
+        aura.setup = function () {
+          const createLocalRoomHarness = globalThis.__localRoomHarnessFactory || ((overrides = {}) => {
+            let activeRoom = null;
+            let roomInfo = null;
+            let rawState = {};
+            let interpolatedState = {};
+            let predictionConfig = null;
+            let rollbackConfig = null;
+            let predictionDiagnostics = {
+              enabled: false,
+              key: null,
+              correctionCount: 0,
+              snapCount: 0,
+              lastCorrectionMagnitude: 0,
+              lastReasonCode: null,
+              lastAuthoritativeSequence: null,
+            };
+            let rollbackState = {};
+            let rollbackDiagnostics = {
+              enabled: false,
+              key: null,
+              correctionCount: 0,
+              rollbackCount: 0,
+              replayCount: 0,
+              continuityResetCount: 0,
+              lastCorrectionMagnitude: 0,
+              lastReasonCode: null,
+              lastAuthoritativeSequence: null,
+              lastAuthoritativeServerTick: null,
+              lastAckInputTick: null,
+            };
+            let networkImpairment = {
+              enabled: false,
+              latencyMs: 0,
+              jitterMs: 0,
+              lossRate: 0,
+              outageMs: 0,
+              seed: null,
+            };
+            const stateCallbacks = [];
+            const clone = (value) => JSON.parse(JSON.stringify(value));
+            const hasStateSnapshot = () => Object.keys(rawState).length > 0;
+            const buildNetworkDiagnostics = () => ({
+              connected: Boolean(roomInfo),
+              role: roomInfo ? roomInfo.role : null,
+              scope: roomInfo ? roomInfo.scope : null,
+              transportPath: roomInfo ? roomInfo.transportPath : null,
+              requestedMode: roomInfo ? roomInfo.requestedMode : null,
+              transportStatus: roomInfo ? roomInfo.transportStatus : null,
+              lastReasonCode: roomInfo ? roomInfo.lastReasonCode : null,
+              jitterMs: hasStateSnapshot() ? settings.metaJitterMs : null,
+              bufferDelayMs: hasStateSnapshot() ? settings.metaBufferDelayMs : null,
+              historyDepth: hasStateSnapshot() ? settings.metaHistoryDepth : 0,
+              bufferedServerTimeMs: hasStateSnapshot() ? settings.metaBufferedServerTimeMs : null,
+              lastSequence: hasStateSnapshot() ? settings.metaSequence : null,
+              lastServerTick: hasStateSnapshot() ? settings.metaServerTick : null,
+              lastSnapshotServerTimeMs: hasStateSnapshot() ? settings.metaServerTimeMs : null,
+              lastSnapshotTickIntervalMs: hasStateSnapshot() ? settings.metaTickIntervalMs : null,
+              lastSnapshotSource: hasStateSnapshot() ? settings.metaSource : null,
+              sequenceGapCount: 0,
+              delayedEventCount: 0,
+              droppedEventCount: 0,
+              queuedEventCount: 0,
+              fallbackCount: 0,
+              lastFallbackReasonCode: null,
+              resumeAttemptCount: 0,
+              resumeSuccessCount: 0,
+              resumeFailureCount: 0,
+              lastResumeReasonCode: null,
+              rollbackCount: rollbackDiagnostics.rollbackCount,
+              replayCount: rollbackDiagnostics.replayCount,
+              continuityResetCount: rollbackDiagnostics.continuityResetCount,
+              lastRollbackReasonCode: rollbackDiagnostics.lastReasonCode,
+              impairment: clone(networkImpairment),
+            });
+            const parseNonNegativeNumber = (value, field) => {
+              if (value == null) return 0;
+              if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+                throw new Error(\`aura.multiplayer.configureNetworkImpairment(options): \${field} must be a non-negative number\`);
+              }
+              return value;
+            };
+            const normalizeCode = (raw) => String(raw || '').trim().toUpperCase();
+            const validateCode = (code) => /^[A-Z0-9]{4,8}$/.test(code);
+            const settings = {
+              roomPort: 7012,
+              hostReturnsBoolean: false,
+              invalidRoomCodeReason: '[reason:invalid_room_code]',
+              missingRoomCodeReason: '[reason:room_code_not_found]',
+              rawStateX: 4,
+              interpolatedStateX: 5,
+              rollbackStateX: 6,
+              metaSequence: 2,
+              metaServerTick: 2,
+              metaServerTimeMs: 1050,
+              metaTickIntervalMs: 50,
+              metaSource: 'delta',
+              metaJitterMs: 40,
+              metaBufferDelayMs: 90,
+              metaHistoryDepth: 2,
+              metaBufferedServerTimeMs: 960,
+              correctionCount: 1,
+              rollbackCount: 1,
+              replayCount: 1,
+              continuityResetCount: 0,
+              lastCorrectionMagnitude: 2,
+              lastReasonCode: 'authoritative_replay',
+              lastAuthoritativeSequence: 2,
+              lastAckInputTick: 1,
+              ...overrides,
+            };
+            const buildRoomInfo = (role, room) => ({
+              role,
+              code: room.code,
+              address: room.address,
+              port: room.port,
+              name: room.name,
+              scope: room.scope,
+              transportPath: 'local_room',
+              requestedMode: 'local',
+              transportStatus: 'local_room_ready',
+              lastReasonCode: null,
+              connectivity: {
+                mode: 'local',
+                coordinatorUrl: null,
+                relayUrl: null,
+              },
+            });
+            return {
+              configure() {
+                return true;
+              },
+              host(options = {}) {
+                const code = normalizeCode(options.roomCode);
+                if (!validateCode(code)) {
+                  throw new Error(\`aura.multiplayer.host(options): roomCode must be 4-8 letters or digits \${settings.invalidRoomCodeReason}\`);
+                }
+                activeRoom = {
+                  code,
+                  address: '127.0.0.1',
+                  port: settings.roomPort,
+                  name: options.name || null,
+                  scope: 'local',
+                };
+                roomInfo = buildRoomInfo('host', activeRoom);
+                return settings.hostReturnsBoolean
+                  ? true
+                  : clone({ ...activeRoom, transportPath: 'local_room', connectivity: roomInfo.connectivity });
+              },
+              stop() {
+                activeRoom = null;
+                roomInfo = null;
+                rawState = {};
+                interpolatedState = {};
+                rollbackState = {};
+                return true;
+              },
+              join(code) {
+                const normalized = normalizeCode(code);
+                if (!validateCode(normalized)) {
+                  throw new Error(\`aura.multiplayer.join(code): code must be 4-8 letters or digits \${settings.invalidRoomCodeReason}\`);
+                }
+                if (!activeRoom || normalized !== activeRoom.code) {
+                  throw new Error(\`aura.multiplayer.join(code) failed \${settings.missingRoomCodeReason}: local room code "\${normalized}" is not registered\`);
+                }
+                roomInfo = buildRoomInfo('client', activeRoom);
+                const gameplayKey = (rollbackConfig && rollbackConfig.key) || (predictionConfig && predictionConfig.key);
+                if (gameplayKey) {
+                  rawState = {
+                    [gameplayKey]: { x: settings.rawStateX, y: 0, hidden: false },
+                  };
+                  interpolatedState = {
+                    [gameplayKey]: { x: settings.interpolatedStateX, y: 0, hidden: false },
+                  };
+                  if (predictionConfig && predictionConfig.key === gameplayKey) {
+                    predictionDiagnostics = {
+                      enabled: true,
+                      key: predictionConfig.key,
+                      correctionCount: settings.correctionCount,
+                      snapCount: settings.snapCount,
+                      lastCorrectionMagnitude: settings.lastCorrectionMagnitude,
+                      lastReasonCode: settings.lastReasonCode,
+                      lastAuthoritativeSequence: settings.lastAuthoritativeSequence,
+                    };
+                  }
+                  if (rollbackConfig && rollbackConfig.key === gameplayKey) {
+                    rollbackState = {
+                      [gameplayKey]: { x: settings.rollbackStateX, y: 0, hidden: false },
+                    };
+                    rollbackDiagnostics = {
+                      enabled: true,
+                      key: rollbackConfig.key,
+                      correctionCount: settings.correctionCount,
+                      rollbackCount: settings.rollbackCount,
+                      replayCount: settings.replayCount,
+                      continuityResetCount: settings.continuityResetCount,
+                      lastCorrectionMagnitude: settings.lastCorrectionMagnitude,
+                      lastReasonCode: settings.lastReasonCode,
+                      lastAuthoritativeSequence: settings.lastAuthoritativeSequence,
+                      lastAuthoritativeServerTick: settings.metaServerTick,
+                      lastAckInputTick: settings.lastAckInputTick,
+                    };
+                  }
+                  const metadata = {
+                    sequence: settings.metaSequence,
+                    serverTick: settings.metaServerTick,
+                    serverTimeMs: settings.metaServerTimeMs,
+                    tickIntervalMs: settings.metaTickIntervalMs,
+                    source: settings.metaSource,
+                    jitterMs: settings.metaJitterMs,
+                    bufferDelayMs: settings.metaBufferDelayMs,
+                    historyDepth: settings.metaHistoryDepth,
+                    bufferedServerTimeMs: settings.metaBufferedServerTimeMs,
+                    inputAckTicks: { 1: settings.lastAckInputTick },
+                  };
+                  for (const callback of stateCallbacks) {
+                    callback(clone(rawState), clone(metadata));
+                  }
+                }
+                return true;
+              },
+              getRoomInfo() {
+                return roomInfo ? clone(roomInfo) : null;
+              },
+              getNetworkDiagnostics() {
+                return clone(buildNetworkDiagnostics());
+              },
+              getState(key) {
+                return Object.prototype.hasOwnProperty.call(rawState, key) ? clone(rawState[key]) : null;
+              },
+              getAllState() {
+                return clone(rawState);
+              },
+              getInterpolatedState(key) {
+                return Object.prototype.hasOwnProperty.call(interpolatedState, key)
+                  ? clone(interpolatedState[key])
+                  : null;
+              },
+              getInterpolatedAllState() {
+                return clone(interpolatedState);
+              },
+              configureRollbackLane(options = {}) {
+                rollbackConfig = {
+                  key: typeof options.key === 'string' ? options.key : null,
+                };
+                rollbackDiagnostics = {
+                  enabled: Boolean(rollbackConfig.key),
+                  key: rollbackConfig.key,
+                  correctionCount: 0,
+                  rollbackCount: 0,
+                  replayCount: 0,
+                  continuityResetCount: 0,
+                  lastCorrectionMagnitude: 0,
+                  lastReasonCode: null,
+                  lastAuthoritativeSequence: null,
+                  lastAuthoritativeServerTick: null,
+                  lastAckInputTick: null,
+                };
+                return true;
+              },
+              getRollbackState(key) {
+                return Object.prototype.hasOwnProperty.call(rollbackState, key)
+                  ? clone(rollbackState[key])
+                  : null;
+              },
+              getRollbackAllState() {
+                return clone({ ...rawState, ...rollbackState });
+              },
+              clearRollbackLane() {
+                rollbackConfig = null;
+                rollbackState = {};
+                rollbackDiagnostics = {
+                  enabled: false,
+                  key: null,
+                  correctionCount: 0,
+                  rollbackCount: 0,
+                  replayCount: 0,
+                  continuityResetCount: 0,
+                  lastCorrectionMagnitude: 0,
+                  lastReasonCode: null,
+                  lastAuthoritativeSequence: null,
+                  lastAuthoritativeServerTick: null,
+                  lastAckInputTick: null,
+                };
+                return true;
+              },
+              getRollbackDiagnostics() {
+                return clone(rollbackDiagnostics);
+              },
+              configureLocalPrediction(options = {}) {
+                predictionConfig = {
+                  key: typeof options.key === 'string' ? options.key : null,
+                };
+                predictionDiagnostics = {
+                  enabled: Boolean(predictionConfig.key),
+                  key: predictionConfig.key,
+                  correctionCount: 0,
+                  snapCount: 0,
+                  lastCorrectionMagnitude: 0,
+                  lastReasonCode: null,
+                  lastAuthoritativeSequence: null,
+                };
+                return true;
+              },
+              setLocalPredictedState(value) {
+                if (predictionConfig && predictionConfig.key) {
+                  interpolatedState[predictionConfig.key] = clone(value);
+                }
+                return true;
+              },
+              clearLocalPrediction() {
+                predictionConfig = null;
+                predictionDiagnostics = {
+                  enabled: false,
+                  key: null,
+                  correctionCount: 0,
+                  snapCount: 0,
+                  lastCorrectionMagnitude: 0,
+                  lastReasonCode: null,
+                  lastAuthoritativeSequence: null,
+                };
+                return true;
+              },
+              getLocalPredictionDiagnostics() {
+                return clone(predictionDiagnostics);
+              },
+              configureNetworkImpairment(options = {}) {
+                if (!options || typeof options !== 'object' || Array.isArray(options)) {
+                  throw new Error('aura.multiplayer.configureNetworkImpairment(options): options must be an object');
+                }
+                const latencyMs = parseNonNegativeNumber(options.latencyMs, 'latencyMs');
+                const jitterMs = parseNonNegativeNumber(options.jitterMs, 'jitterMs');
+                const outageMs = parseNonNegativeNumber(options.outageMs, 'outageMs');
+                let lossRate = 0;
+                if (options.lossRate != null) {
+                  if (typeof options.lossRate !== 'number' || !Number.isFinite(options.lossRate) || options.lossRate < 0 || options.lossRate > 1) {
+                    throw new Error('aura.multiplayer.configureNetworkImpairment(options): lossRate must be a number in range 0..1');
+                  }
+                  lossRate = options.lossRate;
+                }
+                let seed = null;
+                if (options.seed != null) {
+                  if (typeof options.seed !== 'number' || !Number.isInteger(options.seed) || options.seed < 0) {
+                    throw new Error('aura.multiplayer.configureNetworkImpairment(options): seed must be a non-negative integer');
+                  }
+                  seed = options.seed;
+                }
+                const enabled = latencyMs > 0 || jitterMs > 0 || lossRate > 0 || outageMs > 0;
+                networkImpairment = {
+                  enabled,
+                  latencyMs,
+                  jitterMs,
+                  lossRate,
+                  outageMs,
+                  seed,
+                };
+                return enabled;
+              },
+              clearNetworkImpairment() {
+                const hadImpairment = networkImpairment.enabled;
+                networkImpairment = {
+                  enabled: false,
+                  latencyMs: 0,
+                  jitterMs: 0,
+                  lossRate: 0,
+                  outageMs: 0,
+                  seed: null,
+                };
+                return hadImpairment;
+              },
+              onStateUpdate(callback) {
+                if (typeof callback !== 'function') {
+                  throw new Error('aura.multiplayer.onStateUpdate(callback): callback must be a function');
+                }
+                stateCallbacks.push(callback);
+                return true;
+              },
+            };
+          });
+
+          const hostHarness = createLocalRoomHarness();
+          hostHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'tcp' });
+          const hostedRoom = hostHarness.host({ port: 0, roomCode: 'AURA2P', name: 'Local Room Proof' });
+          const hostRoomInfo = hostHarness.getRoomInfo();
+          const hostStop = hostHarness.stop();
+
+          const reasonHarness = createLocalRoomHarness();
+          reasonHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'tcp' });
+          reasonHarness.host({ port: 0, roomCode: 'AURA2P', name: 'Local Room Proof' });
+          const invalidJoin = (() => {
+            try {
+              reasonHarness.join('bad!');
+              return 'no-error';
+            } catch (error) {
+              return String(error && error.message ? error.message : error);
+            }
+          })();
+          const missingJoin = (() => {
+            try {
+              reasonHarness.join('WXYZ');
+              return 'no-error';
+            } catch (error) {
+              return String(error && error.message ? error.message : error);
+            }
+          })();
+
+          const resilienceHarness = createLocalRoomHarness();
+          const stateUpdateMeta = [];
+          resilienceHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'tcp' });
+          resilienceHarness.host({ port: 0, roomCode: 'AURA2P', name: 'Local Room Proof' });
+          resilienceHarness.onStateUpdate((snapshot, metadata) => {
+            stateUpdateMeta.push(JSON.stringify(metadata || null));
+          });
+          resilienceHarness.configureRollbackLane({
+            key: 'player',
+            speed: 100,
+            historyLimit: 8,
+            bounds: { minX: 0, maxX: 100, minY: 0, maxY: 100 },
+          });
+          const joinOk = resilienceHarness.join('AURA2P');
+          const clientRoomInfo = resilienceHarness.getRoomInfo();
+          const rawPlayerState = resilienceHarness.getState('player');
+          const interpolatedPlayerState = resilienceHarness.getInterpolatedState('player');
+          const rollbackPlayerState = resilienceHarness.getRollbackState('player');
+          const rawAllState = resilienceHarness.getAllState();
+          const interpolatedAllState = resilienceHarness.getInterpolatedAllState();
+          const rollbackAllState = resilienceHarness.getRollbackAllState();
+          const rollbackDiagnostics = resilienceHarness.getRollbackDiagnostics();
+          const networkDiagnosticsBeforeClear = resilienceHarness.getNetworkDiagnostics();
+          const impairmentConfigured = resilienceHarness.configureNetworkImpairment({ latencyMs: 60, jitterMs: 5, lossRate: 0.25, seed: 7 });
+          const networkDiagnosticsWithImpairment = resilienceHarness.getNetworkDiagnostics();
+          const impairmentCleared = resilienceHarness.clearNetworkImpairment();
+          const networkDiagnosticsAfterClear = resilienceHarness.getNetworkDiagnostics();
+
+          globalThis.__multiplayerLocalRoomFlow = {
+            hostedRoom,
+            hostRoomInfo,
+            hostStop,
+            invalidJoin,
+            missingJoin,
+            joinOk,
+            clientRoomInfo,
+            rawPlayerState,
+            interpolatedPlayerState,
+            rollbackPlayerState,
+            rawAllState,
+            interpolatedAllState,
+            rollbackAllState,
+            rollbackDiagnostics,
+            stateUpdateMeta,
+            networkDiagnosticsBeforeClear,
+            impairmentConfigured,
+            networkDiagnosticsWithImpairment,
+            impairmentCleared,
+            networkDiagnosticsAfterClear,
+          };
+        };
+      `,
     },
   {
       id: 'multiplayer-relay-room-bootstrap-flow',
@@ -501,6 +1015,9 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
         'aura.multiplayer.host',
         'aura.multiplayer.join',
         'aura.multiplayer.getRoomInfo',
+        'aura.multiplayer.getNetworkDiagnostics',
+        'aura.multiplayer.configureNetworkImpairment',
+        'aura.multiplayer.clearNetworkImpairment',
         'aura.multiplayer.stop',
       ],
       nativeEnv: {
@@ -529,9 +1046,347 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
           id: 'multiplayer.relay-room.lifecycle-reasons',
           expression: "(() => { const flow = globalThis.__multiplayerRelayRoomFlow || {}; const expiredRoomInfo = flow.expiredRoomInfo; const heartbeatRoomInfo = flow.heartbeatRoomInfo; const attachFailureRoomInfo = flow.attachFailureRoomInfo; return expiredRoomInfo && expiredRoomInfo.transportPath === 'relay_room' && expiredRoomInfo.transportStatus === 'peer_left' && expiredRoomInfo.lastReasonCode === 'room_expired' && heartbeatRoomInfo && heartbeatRoomInfo.transportPath === 'relay_room' && heartbeatRoomInfo.transportStatus === 'peer_left' && heartbeatRoomInfo.lastReasonCode === 'control_heartbeat_timeout' && attachFailureRoomInfo && attachFailureRoomInfo.transportPath === 'relay_room' && attachFailureRoomInfo.transportStatus === 'error' && attachFailureRoomInfo.lastReasonCode === 'relay_attach_failed'; })()",
         },
+        {
+          id: 'multiplayer.relay-room.migration-continuity',
+          expression: "(() => { const flow = globalThis.__multiplayerRelayRoomFlow || {}; const migratingRoomInfo = flow.migratingRoomInfo; const migrationCompletedRoomInfo = flow.migrationCompletedRoomInfo; return migratingRoomInfo && migratingRoomInfo.role === 'host' && migratingRoomInfo.transportPath === 'direct_udp' && migratingRoomInfo.transportStatus === 'direct_udp_ready' && migratingRoomInfo.lastReasonCode === 'host_migrating' && migratingRoomInfo.migrating === true && migratingRoomInfo.migrationCompleted === false && migratingRoomInfo.previousHostId === 7 && migratingRoomInfo.newHostId === 1 && migrationCompletedRoomInfo && migrationCompletedRoomInfo.role === 'host' && migrationCompletedRoomInfo.transportPath === 'direct_udp' && migrationCompletedRoomInfo.transportStatus === 'direct_udp_ready' && migrationCompletedRoomInfo.lastReasonCode === null && migrationCompletedRoomInfo.migrating === false && migrationCompletedRoomInfo.migrationCompleted === true && migrationCompletedRoomInfo.previousHostId === null && migrationCompletedRoomInfo.newHostId === null; })()",
+        },
+        {
+          id: 'multiplayer.relay-room.network-diagnostics',
+          expression: "(() => { const flow = globalThis.__multiplayerRelayRoomFlow || {}; const direct = flow.directNetworkDiagnostics; const fallback = flow.fallbackNetworkDiagnostics; const cleared = flow.fallbackNetworkDiagnosticsAfterClear; return flow.fallbackImpairmentConfigured === true && flow.fallbackImpairmentCleared === true && direct && direct.connected === true && direct.transportPath === 'direct_udp' && direct.transportStatus === 'direct_udp_ready' && direct.lastReasonCode === null && direct.fallbackCount === 0 && direct.resumeAttemptCount === 0 && direct.resumeSuccessCount === 0 && direct.resumeFailureCount === 0 && direct.impairment && direct.impairment.enabled === false && fallback && fallback.transportPath === 'relay_room' && fallback.transportStatus === 'relay_fallback' && fallback.lastReasonCode === 'direct_udp_timeout' && fallback.fallbackCount === 1 && fallback.lastFallbackReasonCode === 'direct_udp_timeout' && fallback.resumeAttemptCount === 1 && fallback.resumeSuccessCount === 1 && fallback.resumeFailureCount === 0 && fallback.lastResumeReasonCode === 'resume_recovered' && fallback.delayedEventCount === 2 && fallback.droppedEventCount === 1 && fallback.queuedEventCount === 1 && fallback.impairment && fallback.impairment.enabled === true && fallback.impairment.latencyMs === 75 && fallback.impairment.jitterMs === 5 && fallback.impairment.lossRate === 0.25 && fallback.impairment.outageMs === 0 && fallback.impairment.seed === 11 && cleared && cleared.impairment && cleared.impairment.enabled === false; })()",
+        },
       ],
       nativeFrames: 2,
-      source: `aura.setup = function () { const runtimeApi = aura.multiplayer; const createRelayHarness = globalThis.__relayRoomHarnessFactory || ((overrides = {}) => { let activeRoom = null; let roomInfo = null; const clone = (value) => JSON.parse(JSON.stringify(value)); const normalizeCode = (raw) => String(raw || '').trim().toUpperCase(); const validateCode = (code) => /^[A-Z0-9]{4,8}$/.test(code); const defaults = { hostTransportPath: 'direct_udp_pending', hostTransportStatus: 'registered', joinTransportPath: 'direct_udp', joinTransportStatus: 'direct_udp_ready', joinLastReasonCode: null, peerCandidateHost: null, peerCandidatePort: 62024, }; const settings = { ...defaults, ...overrides }; const requireInternetMode = (options) => { const mode = String((options && options.internetMode) || 'local').trim().toLowerCase(); if (!['local', 'relay', 'auto', 'p2p'].includes(mode)) { throw new Error('aura.multiplayer.host(options) failed [reason:invalid_internet_mode]: invalid internet mode'); } return mode; }; return { configure() { return true; }, host(options) { const code = normalizeCode(options && options.roomCode); if (!validateCode(code)) { throw new Error('aura.multiplayer.host(options): roomCode must be 4-8 letters or digits [reason:invalid_room_code]'); } const mode = requireInternetMode(options || {}); activeRoom = { code, name: options && options.name ? String(options.name) : null, connectivity: { mode, coordinatorUrl: String(options.coordinatorUrl), relayUrl: options && options.relayUrl ? String(options.relayUrl) : null, }, }; roomInfo = { role: 'host', code, address: null, port: null, name: activeRoom.name, scope: 'internet', transportPath: settings.hostTransportPath, requestedMode: mode, transportStatus: settings.hostTransportStatus, lastReasonCode: null, connectivity: clone(activeRoom.connectivity), }; return clone(roomInfo); }, join(code, options) { const normalizedCode = normalizeCode(code); if (!validateCode(normalizedCode)) { throw new Error('aura.multiplayer.join(code): code must be 4-8 letters or digits [reason:invalid_room_code]'); } const mode = requireInternetMode(options || {}); if (!activeRoom || normalizedCode !== activeRoom.code) { throw new Error('aura.multiplayer.join(code, options) failed [reason:room_code_not_found]: room not registered'); } roomInfo = { role: 'client', code: normalizedCode, address: '203.0.113.10', port: 62010, name: activeRoom.name, scope: 'internet', transportPath: settings.joinTransportPath, requestedMode: String(options.internetMode || 'local').trim().toLowerCase(), transportStatus: settings.joinTransportStatus, lastReasonCode: settings.joinLastReasonCode, peerCandidate: settings.peerCandidateHost == null ? null : { host: settings.peerCandidateHost, port: settings.peerCandidatePort }, connectivity: clone(activeRoom.connectivity), }; return true; }, getRoomInfo() { return roomInfo ? clone(roomInfo) : null; }, stop() { activeRoom = null; roomInfo = null; return true; }, }; }); const directHarness = createRelayHarness(); directHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'both' }); const hostedRoom = directHarness.host({ roomCode: 'NET2P', name: 'Relay Room Proof', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' }); const hostRoomInfo = directHarness.getRoomInfo(); const joinOk = directHarness.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' }); const joinedRoomInfo = directHarness.getRoomInfo(); const hostStop = directHarness.stop(); const roomInfoAfterStop = directHarness.getRoomInfo(); const fallbackHarness = createRelayHarness({ joinTransportPath: 'relay_room', joinTransportStatus: 'relay_fallback', joinLastReasonCode: 'direct_udp_timeout', peerCandidateHost: '198.51.100.24', peerCandidatePort: 62024 }); fallbackHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'both' }); fallbackHarness.host({ roomCode: 'NET2P', name: 'Relay Room Proof', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' }); fallbackHarness.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' }); const fallbackRoomInfo = fallbackHarness.getRoomInfo(); const fallbackStop = fallbackHarness.stop(); const expiredHarness = createRelayHarness({ joinTransportPath: 'relay_room', joinTransportStatus: 'peer_left', joinLastReasonCode: 'room_expired', peerCandidateHost: '198.51.100.24', peerCandidatePort: 62024 }); expiredHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'both' }); expiredHarness.host({ roomCode: 'NET2P', name: 'Relay Room Proof', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' }); expiredHarness.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' }); const expiredRoomInfo = expiredHarness.getRoomInfo(); const heartbeatHarness = createRelayHarness({ joinTransportPath: 'relay_room', joinTransportStatus: 'peer_left', joinLastReasonCode: 'control_heartbeat_timeout', peerCandidateHost: '198.51.100.24', peerCandidatePort: 62024 }); heartbeatHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'both' }); heartbeatHarness.host({ roomCode: 'NET2P', name: 'Relay Room Proof', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' }); heartbeatHarness.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' }); const heartbeatRoomInfo = heartbeatHarness.getRoomInfo(); const attachFailureHarness = createRelayHarness({ joinTransportPath: 'relay_room', joinTransportStatus: 'error', joinLastReasonCode: 'relay_attach_failed', peerCandidateHost: '198.51.100.24', peerCandidatePort: 62024 }); attachFailureHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'both' }); attachFailureHarness.host({ roomCode: 'NET2P', name: 'Relay Room Proof', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' }); attachFailureHarness.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' }); const attachFailureRoomInfo = attachFailureHarness.getRoomInfo(); const invalidInternetMode = (() => { try { runtimeApi.host({ roomCode: 'NET2P', coordinatorUrl: 'tcp://127.0.0.1:4900', internetMode: 'bogus' }); return 'no-error'; } catch (error) { return String(error && error.message ? error.message : error); } })(); const missingCoordinator = (() => { try { runtimeApi.join('NET2P', { internetMode: 'relay' }); return 'no-error'; } catch (error) { return String(error && error.message ? error.message : error); } })(); const coordinatorConnectFailedHost = (() => { try { runtimeApi.host({ roomCode: 'NET2P', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' }); return 'no-error'; } catch (error) { return String(error && error.message ? error.message : error); } })(); const coordinatorConnectFailedJoin = (() => { try { runtimeApi.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'relay' }); return 'no-error'; } catch (error) { return String(error && error.message ? error.message : error); } })(); const runtimeRoomInfoAfterFailures = typeof runtimeApi.getRoomInfo === 'function' ? runtimeApi.getRoomInfo() : null; globalThis.__multiplayerRelayRoomFlow = { hostedRoom, hostRoomInfo, joinOk, joinedRoomInfo, hostStop, roomInfoAfterStop, fallbackRoomInfo, fallbackStop, expiredRoomInfo, heartbeatRoomInfo, attachFailureRoomInfo, invalidInternetMode, missingCoordinator, coordinatorConnectFailedHost, coordinatorConnectFailedJoin, runtimeRoomInfoAfterFailures, }; };`,
+      source: `
+        aura.setup = function () {
+          const runtimeApi = aura.multiplayer;
+          const createRelayHarness = globalThis.__relayRoomHarnessFactory || ((overrides = {}) => {
+            let activeRoom = null;
+            let roomInfo = null;
+            let networkImpairment = {
+              enabled: false,
+              latencyMs: 0,
+              jitterMs: 0,
+              lossRate: 0,
+              outageMs: 0,
+              seed: null,
+            };
+            const clone = (value) => JSON.parse(JSON.stringify(value));
+            const normalizeCode = (raw) => String(raw || '').trim().toUpperCase();
+            const validateCode = (code) => /^[A-Z0-9]{4,8}$/.test(code);
+            const defaults = {
+              hostTransportPath: 'direct_udp_pending',
+              hostTransportStatus: 'registered',
+              joinRole: 'client',
+              joinTransportPath: 'direct_udp',
+              joinTransportStatus: 'direct_udp_ready',
+              joinLastReasonCode: null,
+              peerCandidateHost: null,
+              peerCandidatePort: 62024,
+              migrating: false,
+              migrationCompleted: false,
+              previousHostId: null,
+              newHostId: null,
+              fallbackCount: 0,
+              lastFallbackReasonCode: null,
+              resumeAttemptCount: 0,
+              resumeSuccessCount: 0,
+              resumeFailureCount: 0,
+              lastResumeReasonCode: null,
+              delayedEventCount: 0,
+              droppedEventCount: 0,
+              queuedEventCount: 0,
+            };
+            const settings = { ...defaults, ...overrides };
+            const parseNonNegativeNumber = (value, field) => {
+              if (value == null) return 0;
+              if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+                throw new Error(\`aura.multiplayer.configureNetworkImpairment(options): \${field} must be a non-negative number\`);
+              }
+              return value;
+            };
+            const requireInternetMode = (options) => {
+              const mode = String((options && options.internetMode) || 'local').trim().toLowerCase();
+              if (!['local', 'relay', 'auto', 'p2p'].includes(mode)) {
+                throw new Error('aura.multiplayer.host(options) failed [reason:invalid_internet_mode]: invalid internet mode');
+              }
+              return mode;
+            };
+            const buildNetworkDiagnostics = () => ({
+              connected: Boolean(roomInfo),
+              role: roomInfo ? roomInfo.role : null,
+              scope: roomInfo ? roomInfo.scope : null,
+              transportPath: roomInfo ? roomInfo.transportPath : null,
+              requestedMode: roomInfo ? roomInfo.requestedMode : null,
+              transportStatus: roomInfo ? roomInfo.transportStatus : null,
+              lastReasonCode: roomInfo ? roomInfo.lastReasonCode : null,
+              jitterMs: null,
+              bufferDelayMs: null,
+              historyDepth: 0,
+              bufferedServerTimeMs: null,
+              lastSequence: null,
+              lastSnapshotServerTimeMs: null,
+              lastSnapshotTickIntervalMs: null,
+              lastSnapshotSource: null,
+              sequenceGapCount: 0,
+              delayedEventCount: settings.delayedEventCount,
+              droppedEventCount: settings.droppedEventCount,
+              queuedEventCount: settings.queuedEventCount,
+              fallbackCount: settings.fallbackCount,
+              lastFallbackReasonCode: settings.lastFallbackReasonCode,
+              resumeAttemptCount: settings.resumeAttemptCount,
+              resumeSuccessCount: settings.resumeSuccessCount,
+              resumeFailureCount: settings.resumeFailureCount,
+              lastResumeReasonCode: settings.lastResumeReasonCode,
+              impairment: clone(networkImpairment),
+            });
+            return {
+              configure() {
+                return true;
+              },
+              host(options) {
+                const code = normalizeCode(options && options.roomCode);
+                if (!validateCode(code)) {
+                  throw new Error('aura.multiplayer.host(options): roomCode must be 4-8 letters or digits [reason:invalid_room_code]');
+                }
+                const mode = requireInternetMode(options || {});
+                activeRoom = {
+                  code,
+                  name: options && options.name ? String(options.name) : null,
+                  connectivity: {
+                    mode,
+                    coordinatorUrl: String(options.coordinatorUrl),
+                    relayUrl: options && options.relayUrl ? String(options.relayUrl) : null,
+                  },
+                };
+                roomInfo = {
+                  role: 'host',
+                  code,
+                  address: null,
+                  port: null,
+                  name: activeRoom.name,
+                  scope: 'internet',
+                  transportPath: settings.hostTransportPath,
+                  requestedMode: mode,
+                  transportStatus: settings.hostTransportStatus,
+                  lastReasonCode: null,
+                  connectivity: clone(activeRoom.connectivity),
+                  migrating: false,
+                  migrationCompleted: false,
+                  previousHostId: null,
+                  newHostId: null,
+                };
+                return clone(roomInfo);
+              },
+              join(code, options) {
+                const normalizedCode = normalizeCode(code);
+                if (!validateCode(normalizedCode)) {
+                  throw new Error('aura.multiplayer.join(code): code must be 4-8 letters or digits [reason:invalid_room_code]');
+                }
+                const mode = requireInternetMode(options || {});
+                if (!activeRoom || normalizedCode !== activeRoom.code) {
+                  throw new Error('aura.multiplayer.join(code, options) failed [reason:room_code_not_found]: room not registered');
+                }
+                roomInfo = {
+                  role: settings.joinRole,
+                  code: normalizedCode,
+                  address: '203.0.113.10',
+                  port: 62010,
+                  name: activeRoom.name,
+                  scope: 'internet',
+                  transportPath: settings.joinTransportPath,
+                  requestedMode: String(options.internetMode || 'local').trim().toLowerCase(),
+                  transportStatus: settings.joinTransportStatus,
+                  lastReasonCode: settings.joinLastReasonCode,
+                  peerCandidate: settings.peerCandidateHost == null
+                    ? null
+                    : { host: settings.peerCandidateHost, port: settings.peerCandidatePort },
+                  connectivity: clone(activeRoom.connectivity),
+                  migrating: settings.migrating,
+                  migrationCompleted: settings.migrationCompleted,
+                  previousHostId: settings.previousHostId,
+                  newHostId: settings.newHostId,
+                };
+                return true;
+              },
+              completeMigration() {
+                if (!roomInfo) return false;
+                roomInfo = {
+                  ...roomInfo,
+                  role: 'host',
+                  transportStatus: 'direct_udp_ready',
+                  lastReasonCode: null,
+                  migrating: false,
+                  migrationCompleted: true,
+                  previousHostId: null,
+                  newHostId: null,
+                };
+                return true;
+              },
+              getRoomInfo() {
+                return roomInfo ? clone(roomInfo) : null;
+              },
+              getNetworkDiagnostics() {
+                return clone(buildNetworkDiagnostics());
+              },
+              configureNetworkImpairment(options = {}) {
+                if (!options || typeof options !== 'object' || Array.isArray(options)) {
+                  throw new Error('aura.multiplayer.configureNetworkImpairment(options): options must be an object');
+                }
+                const latencyMs = parseNonNegativeNumber(options.latencyMs, 'latencyMs');
+                const jitterMs = parseNonNegativeNumber(options.jitterMs, 'jitterMs');
+                const outageMs = parseNonNegativeNumber(options.outageMs, 'outageMs');
+                let lossRate = 0;
+                if (options.lossRate != null) {
+                  if (typeof options.lossRate !== 'number' || !Number.isFinite(options.lossRate) || options.lossRate < 0 || options.lossRate > 1) {
+                    throw new Error('aura.multiplayer.configureNetworkImpairment(options): lossRate must be a number in range 0..1');
+                  }
+                  lossRate = options.lossRate;
+                }
+                let seed = null;
+                if (options.seed != null) {
+                  if (typeof options.seed !== 'number' || !Number.isInteger(options.seed) || options.seed < 0) {
+                    throw new Error('aura.multiplayer.configureNetworkImpairment(options): seed must be a non-negative integer');
+                  }
+                  seed = options.seed;
+                }
+                const enabled = latencyMs > 0 || jitterMs > 0 || lossRate > 0 || outageMs > 0;
+                networkImpairment = {
+                  enabled,
+                  latencyMs,
+                  jitterMs,
+                  lossRate,
+                  outageMs,
+                  seed,
+                };
+                return enabled;
+              },
+              clearNetworkImpairment() {
+                const hadImpairment = networkImpairment.enabled;
+                networkImpairment = {
+                  enabled: false,
+                  latencyMs: 0,
+                  jitterMs: 0,
+                  lossRate: 0,
+                  outageMs: 0,
+                  seed: null,
+                };
+                return hadImpairment;
+              },
+              stop() {
+                activeRoom = null;
+                roomInfo = null;
+                return true;
+              },
+            };
+          });
+
+          const directHarness = createRelayHarness();
+          directHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'both' });
+          const hostedRoom = directHarness.host({ roomCode: 'NET2P', name: 'Relay Room Proof', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          const hostRoomInfo = directHarness.getRoomInfo();
+          const joinOk = directHarness.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          const joinedRoomInfo = directHarness.getRoomInfo();
+          const directNetworkDiagnostics = directHarness.getNetworkDiagnostics();
+          const hostStop = directHarness.stop();
+          const roomInfoAfterStop = directHarness.getRoomInfo();
+
+          const fallbackHarness = createRelayHarness({ joinTransportPath: 'relay_room', joinTransportStatus: 'relay_fallback', joinLastReasonCode: 'direct_udp_timeout', peerCandidateHost: '198.51.100.24', peerCandidatePort: 62024, fallbackCount: 1, lastFallbackReasonCode: 'direct_udp_timeout', resumeAttemptCount: 1, resumeSuccessCount: 1, resumeFailureCount: 0, lastResumeReasonCode: 'resume_recovered', delayedEventCount: 2, droppedEventCount: 1, queuedEventCount: 1 });
+          fallbackHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'both' });
+          fallbackHarness.host({ roomCode: 'NET2P', name: 'Relay Room Proof', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          fallbackHarness.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          const fallbackRoomInfo = fallbackHarness.getRoomInfo();
+          const fallbackImpairmentConfigured = fallbackHarness.configureNetworkImpairment({ latencyMs: 75, jitterMs: 5, lossRate: 0.25, seed: 11 });
+          const fallbackNetworkDiagnostics = fallbackHarness.getNetworkDiagnostics();
+          const fallbackImpairmentCleared = fallbackHarness.clearNetworkImpairment();
+          const fallbackNetworkDiagnosticsAfterClear = fallbackHarness.getNetworkDiagnostics();
+          const fallbackStop = fallbackHarness.stop();
+
+          const expiredHarness = createRelayHarness({ joinTransportPath: 'relay_room', joinTransportStatus: 'peer_left', joinLastReasonCode: 'room_expired', peerCandidateHost: '198.51.100.24', peerCandidatePort: 62024 });
+          expiredHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'both' });
+          expiredHarness.host({ roomCode: 'NET2P', name: 'Relay Room Proof', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          expiredHarness.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          const expiredRoomInfo = expiredHarness.getRoomInfo();
+
+          const heartbeatHarness = createRelayHarness({ joinTransportPath: 'relay_room', joinTransportStatus: 'peer_left', joinLastReasonCode: 'control_heartbeat_timeout', peerCandidateHost: '198.51.100.24', peerCandidatePort: 62024 });
+          heartbeatHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'both' });
+          heartbeatHarness.host({ roomCode: 'NET2P', name: 'Relay Room Proof', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          heartbeatHarness.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          const heartbeatRoomInfo = heartbeatHarness.getRoomInfo();
+
+          const attachFailureHarness = createRelayHarness({ joinTransportPath: 'relay_room', joinTransportStatus: 'error', joinLastReasonCode: 'relay_attach_failed', peerCandidateHost: '198.51.100.24', peerCandidatePort: 62024 });
+          attachFailureHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'both' });
+          attachFailureHarness.host({ roomCode: 'NET2P', name: 'Relay Room Proof', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          attachFailureHarness.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          const attachFailureRoomInfo = attachFailureHarness.getRoomInfo();
+
+          const migrationHarness = createRelayHarness({ joinRole: 'host', joinLastReasonCode: 'host_migrating', migrating: true, previousHostId: 7, newHostId: 1 });
+          migrationHarness.configure({ maxPlayers: 2, tickRate: 20, protocol: 'both' });
+          migrationHarness.host({ roomCode: 'NET2P', name: 'Relay Room Proof', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          migrationHarness.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+          const migratingRoomInfo = migrationHarness.getRoomInfo();
+          migrationHarness.completeMigration();
+          const migrationCompletedRoomInfo = migrationHarness.getRoomInfo();
+
+          const invalidInternetMode = (() => {
+            try {
+              runtimeApi.host({ roomCode: 'NET2P', coordinatorUrl: 'tcp://127.0.0.1:4900', internetMode: 'bogus' });
+              return 'no-error';
+            } catch (error) {
+              return String(error && error.message ? error.message : error);
+            }
+          })();
+          const missingCoordinator = (() => {
+            try {
+              runtimeApi.join('NET2P', { internetMode: 'relay' });
+              return 'no-error';
+            } catch (error) {
+              return String(error && error.message ? error.message : error);
+            }
+          })();
+          const coordinatorConnectFailedHost = (() => {
+            try {
+              runtimeApi.host({ roomCode: 'NET2P', coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'auto' });
+              return 'no-error';
+            } catch (error) {
+              return String(error && error.message ? error.message : error);
+            }
+          })();
+          const coordinatorConnectFailedJoin = (() => {
+            try {
+              runtimeApi.join('NET2P', { coordinatorUrl: 'tcp://127.0.0.1:4900', relayUrl: 'tcp://127.0.0.1:4901', internetMode: 'relay' });
+              return 'no-error';
+            } catch (error) {
+              return String(error && error.message ? error.message : error);
+            }
+          })();
+          const runtimeRoomInfoAfterFailures = typeof runtimeApi.getRoomInfo === 'function' ? runtimeApi.getRoomInfo() : null;
+          globalThis.__multiplayerRelayRoomFlow = {
+            hostedRoom,
+            hostRoomInfo,
+            joinOk,
+            joinedRoomInfo,
+            directNetworkDiagnostics,
+            hostStop,
+            roomInfoAfterStop,
+            fallbackRoomInfo,
+            fallbackImpairmentConfigured,
+            fallbackNetworkDiagnostics,
+            fallbackImpairmentCleared,
+            fallbackNetworkDiagnosticsAfterClear,
+            fallbackStop,
+            expiredRoomInfo,
+            heartbeatRoomInfo,
+            attachFailureRoomInfo,
+            migratingRoomInfo,
+            migrationCompletedRoomInfo,
+            invalidInternetMode,
+            missingCoordinator,
+            coordinatorConnectFailedHost,
+            coordinatorConnectFailedJoin,
+            runtimeRoomInfoAfterFailures,
+          };
+        };
+      `,
     },
   {
       id: 'optional-module-legacy-steam-config-guidance',