@smoregg/sdk 1.0.0 → 1.1.0

package/dist/cjs/testing.cjs

@@ -14,6 +14,7 @@ function createMockScreen(options = {}) {
     onControllerReconnect: onReconnectCb,
     onCharacterUpdated: onCharacterUpdatedCb,
     onRateLimited: onRateLimitedCb,
+    onAllReady: onAllReadyCb,
     onError: onErrorCb
   } = options;
   let _controllers = [...initialControllers];
@@ -27,6 +28,7 @@ function createMockScreen(options = {}) {
   let onControllerReconnectCallback;
   let onCharacterUpdatedCallback;
   let onRateLimitedCallback;
+  let onAllReadyCallback;
   let onErrorCallback;
   onReadyCallback = onReadyCb;
   onControllerJoinCallback = onJoinCb;
@@ -35,6 +37,7 @@ function createMockScreen(options = {}) {
   onControllerReconnectCallback = onReconnectCb;
   onCharacterUpdatedCallback = onCharacterUpdatedCb;
   onRateLimitedCallback = onRateLimitedCb;
+  onAllReadyCallback = onAllReadyCb;
   onErrorCallback = onErrorCb;
   const broadcasts = [];
   const sends = [];
@@ -109,6 +112,14 @@ function createMockScreen(options = {}) {
       }
       broadcasts.push({ event: "smore:game-over", data: { results } });
     },
+    signalReady() {
+      if (_isDestroyed) {
+        throw new Error("Cannot call signalReady: screen is destroyed");
+      }
+      if (!_isReady) {
+        throw new Error("Cannot call signalReady: screen is not ready");
+      }
+    },
     // === Event Subscription ===
     on(event, handler) {
       events.validateEventName(event);
@@ -242,6 +253,11 @@ function createMockScreen(options = {}) {
         onRateLimitedCallback(event);
       }
     },
+    simulateAllReady() {
+      if (onAllReadyCallback) {
+        onAllReadyCallback();
+      }
+    },
     simulateError(error) {
       if (onErrorCallback) {
         onErrorCallback(error);
@@ -281,6 +297,7 @@ function createMockController(options = {}) {
     onControllerReconnect: onReconnectCb,
     onCharacterUpdated: onCharacterUpdatedCb,
     onRateLimited: onRateLimitedCb,
+    onAllReady: onAllReadyCb,
     onError: onErrorCb
   } = options;
   let _isReady = false;
@@ -294,6 +311,7 @@ function createMockController(options = {}) {
   let onControllerReconnectCallback;
   let onCharacterUpdatedCallback;
   let onRateLimitedCallback;
+  let onAllReadyCallback;
   let onErrorCallback;
   onReadyCallback = onReadyCb;
   onControllerJoinCallback = onJoinCb;
@@ -302,6 +320,7 @@ function createMockController(options = {}) {
   onControllerReconnectCallback = onReconnectCb;
   onCharacterUpdatedCallback = onCharacterUpdatedCb;
   onRateLimitedCallback = onRateLimitedCb;
+  onAllReadyCallback = onAllReadyCb;
   onErrorCallback = onErrorCb;
   const sentEvents = [];
   const controller = {
@@ -339,6 +358,14 @@ function createMockController(options = {}) {
       events.validateEventName(event);
       sentEvents.push({ event, data });
     },
+    signalReady() {
+      if (_isDestroyed) {
+        throw new Error("Cannot call signalReady: controller is destroyed");
+      }
+      if (!_isReady) {
+        throw new Error("Cannot call signalReady: controller is not ready");
+      }
+    },
     // === Event Subscription ===
     on(event, handler) {
       events.validateEventName(event);
@@ -483,6 +510,11 @@ function createMockController(options = {}) {
         onRateLimitedCallback(event);
       }
     },
+    simulateAllReady() {
+      if (onAllReadyCallback) {
+        onAllReadyCallback();
+      }
+    },
     simulateError(error) {
       if (onErrorCallback) {
         onErrorCallback(error);

package/dist/cjs/testing.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.cjs","sources":["../../src/testing.ts"],"sourcesContent":["/**\n * @smoregg/sdk - Testing Utilities\n *\n * Mock implementations of Screen and Controller for unit testing.\n * All methods work synchronously for predictable test execution.\n *\n * @packageDocumentation\n */\n\nimport type {\n  EventMap,\n  EventNames,\n  EventData,\n  CharacterAppearance,\n  ControllerInfo,\n  PlayerIndex,\n  GameResults,\n  ScreenEventHandler,\n  ControllerEventHandler,\n  MockScreen,\n  MockController,\n  MockOptions,\n} from './types';\nimport { validateEventName } from './events';\n\n// =============================================================================\n// MOCK SCREEN IMPLEMENTATION\n// =============================================================================\n\ninterface RecordedBroadcast {\n  event: string;\n  data: unknown;\n}\n\ninterface RecordedSend {\n  playerIndex: PlayerIndex;\n  event: string;\n  data: unknown;\n}\n\n/**\n * Create a mock Screen for testing game logic.\n *\n * All methods work synchronously. Events can be simulated and recorded\n * for assertions in unit tests.\n *\n * @example\n * ```ts\n * const screen = createMockScreen<MyEvents>({\n *   controllers: [\n *     { playerIndex: 0, nickname: 'Player 1', connected: true },\n *     { playerIndex: 1, nickname: 'Player 2', connected: true },\n *   ],\n * });\n *\n * // Simulate player input\n * screen.simulateEvent(0, 'tap', { x: 100, y: 200 });\n *\n * // Check what was broadcast\n * expect(screen.getBroadcasts()).toContainEqual({\n *   event: 'score-update',\n *   data: { scores: { 0: 10 } },\n * });\n * ```\n */\nexport function createMockScreen<TEvents extends EventMap = EventMap>(\n  options: MockOptions = {},\n): MockScreen<TEvents> {\n  const {\n    roomCode = 'TEST',\n    controllers: initialControllers = [],\n    autoReady = true,\n    onReady: onReadyCb,\n    onControllerJoin: onJoinCb,\n    onControllerLeave: onLeaveCb,\n    onControllerDisconnect: onDisconnectCb,\n    onControllerReconnect: onReconnectCb,\n    onCharacterUpdated: onCharacterUpdatedCb,\n    onRateLimited: onRateLimitedCb,\n    onError: onErrorCb,\n  } = options;\n\n  // Internal state\n  let _controllers: ControllerInfo[] = [...initialControllers];\n  let _isReady = false;\n  let _isDestroyed = false;\n\n  // Event listeners\n  const listeners = new Map<string, Set<ScreenEventHandler>>();\n\n  // Lifecycle callbacks\n  let onReadyCallback: (() => void) | undefined;\n  let onControllerJoinCallback:\n    | ((index: PlayerIndex, info: ControllerInfo) => void)\n    | undefined;\n  let onControllerLeaveCallback: ((index: PlayerIndex) => void) | undefined;\n  let onControllerDisconnectCallback: ((index: PlayerIndex) => void) | undefined;\n  let onControllerReconnectCallback:\n    | ((index: PlayerIndex, info: ControllerInfo) => void)\n    | undefined;\n  let onCharacterUpdatedCallback:\n    | ((index: PlayerIndex, appearance: CharacterAppearance | null) => void)\n    | undefined;\n  let onRateLimitedCallback: ((event: string) => void) | undefined;\n  let onErrorCallback: ((error: any) => void) | undefined;\n\n  // Assign callbacks from options\n  onReadyCallback = onReadyCb;\n  onControllerJoinCallback = onJoinCb;\n  onControllerLeaveCallback = onLeaveCb;\n  onControllerDisconnectCallback = onDisconnectCb;\n  onControllerReconnectCallback = onReconnectCb;\n  onCharacterUpdatedCallback = onCharacterUpdatedCb;\n  onRateLimitedCallback = onRateLimitedCb;\n  onErrorCallback = onErrorCb;\n\n  // Recorded events for testing\n  const broadcasts: RecordedBroadcast[] = [];\n  const sends: RecordedSend[] = [];\n\n  // Screen implementation\n  const screen: MockScreen<TEvents> = {\n    // === Properties ===\n    get controllers() {\n      return [..._controllers];\n    },\n    get roomCode() {\n      return roomCode;\n    },\n    get isReady() {\n      return _isReady;\n    },\n    get isDestroyed() {\n      return _isDestroyed;\n    },\n\n    // === Communication Methods ===\n    broadcast<K extends EventNames<TEvents>>(\n      event: K,\n      data: EventData<TEvents, K>,\n    ): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot broadcast: screen is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot broadcast: screen is not ready');\n      }\n      validateEventName(event as string);\n      broadcasts.push({ event: event as string, data });\n    },\n\n    broadcastRaw(event: string, data?: unknown): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot broadcast: screen is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot broadcast: screen is not ready');\n      }\n      validateEventName(event);\n      broadcasts.push({ event, data });\n    },\n\n    sendToController<K extends EventNames<TEvents>>(\n      playerIndex: PlayerIndex,\n      event: K,\n      data: EventData<TEvents, K>,\n    ): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot send: screen is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot send: screen is not ready');\n      }\n      validateEventName(event as string);\n      if (!_controllers.some((c) => c.playerIndex === playerIndex)) {\n        throw new Error(`Invalid player index: ${playerIndex}`);\n      }\n      sends.push({ playerIndex, event: event as string, data });\n    },\n\n    sendToControllerRaw(\n      playerIndex: PlayerIndex,\n      event: string,\n      data?: unknown,\n    ): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot send: screen is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot send: screen is not ready');\n      }\n      validateEventName(event);\n      if (!_controllers.some((c) => c.playerIndex === playerIndex)) {\n        throw new Error(`Invalid player index: ${playerIndex}`);\n      }\n      sends.push({ playerIndex, event, data });\n    },\n\n    // === Game Lifecycle ===\n    gameOver(results?: GameResults): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot call gameOver: screen is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot call gameOver: screen is not ready');\n      }\n      broadcasts.push({ event: 'smore:game-over', data: { results } });\n    },\n\n    // === Event Subscription ===\n    on<K extends EventNames<TEvents>>(\n      event: K,\n      handler: ScreenEventHandler<EventData<TEvents, K>>,\n    ): () => void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      if (!listeners.has(eventStr)) {\n        listeners.set(eventStr, new Set());\n      }\n      listeners.get(eventStr)!.add(handler as ScreenEventHandler);\n\n      return () => {\n        listeners.get(eventStr)?.delete(handler as ScreenEventHandler);\n      };\n    },\n\n    once<K extends EventNames<TEvents>>(\n      event: K,\n      handler: ScreenEventHandler<EventData<TEvents, K>>,\n    ): () => void {\n      validateEventName(event as string);\n      const wrapper: ScreenEventHandler<EventData<TEvents, K>> = (playerIndex, data) => {\n        handler(playerIndex, data);\n        screen.off(event, wrapper);\n      };\n      return screen.on(event, wrapper);\n    },\n\n    off<K extends EventNames<TEvents>>(\n      event: K,\n      handler?: ScreenEventHandler<EventData<TEvents, K>>,\n    ): void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      if (!handler) {\n        listeners.delete(eventStr);\n      } else {\n        listeners.get(eventStr)?.delete(handler as ScreenEventHandler);\n      }\n    },\n\n    // === Utilities ===\n    getController(playerIndex: PlayerIndex): ControllerInfo | undefined {\n      return _controllers.find((c) => c.playerIndex === playerIndex);\n    },\n\n    getControllerCount(): number {\n      return _controllers.filter(c => c.connected).length;\n    },\n\n    hasAnyConnectedControllers(): boolean {\n      return _controllers.some(c => c.connected);\n    },\n\n    // === Cleanup ===\n    /**\n     * Note: destroy() clears recorded broadcast/event arrays. Call getBroadcasts() before destroy() if assertions are needed.\n     */\n    destroy(): void {\n      _isDestroyed = true;\n      listeners.clear();\n      broadcasts.length = 0;\n      sends.length = 0;\n    },\n\n    // === Mock-specific methods ===\n    simulateEvent<K extends EventNames<TEvents>>(\n      playerIndex: PlayerIndex,\n      event: K,\n      data: EventData<TEvents, K>,\n    ): void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      const handlers = listeners.get(eventStr);\n      if (handlers) {\n        handlers.forEach((handler) => {\n          handler(playerIndex, data);\n        });\n      }\n    },\n\n    simulateControllerJoin(info: ControllerInfo): void {\n      _controllers.push(info);\n      if (onControllerJoinCallback) {\n        onControllerJoinCallback(info.playerIndex, info);\n      }\n    },\n\n    simulateControllerLeave(playerIndex: PlayerIndex): void {\n      _controllers = _controllers.filter((c) => c.playerIndex !== playerIndex);\n      if (onControllerLeaveCallback) {\n        onControllerLeaveCallback(playerIndex);\n      }\n    },\n\n    /**\n     * Simulate a controller network disconnect (player still in room but unreachable).\n     *\n     * @example\n     * ```ts\n     * screen.simulateControllerDisconnect(0);\n     * expect(screen.getController(0)?.connected).toBe(false);\n     * ```\n     */\n    simulateControllerDisconnect(playerIndex: PlayerIndex): void {\n      const controller = _controllers.find((c) => c.playerIndex === playerIndex);\n      if (!controller) {\n        throw new Error(`Controller ${playerIndex} not found`);\n      }\n      // Mark as disconnected (need to create new object since ControllerInfo is readonly)\n      _controllers = _controllers.map((c) =>\n        c.playerIndex === playerIndex\n          ? { ...c, connected: false }\n          : c\n      );\n      if (onControllerDisconnectCallback) {\n        onControllerDisconnectCallback(playerIndex);\n      }\n    },\n\n    /**\n     * Simulate a controller network reconnect after disconnect.\n     *\n     * @example\n     * ```ts\n     * screen.simulateControllerDisconnect(0);\n     * screen.simulateControllerReconnect(0);\n     * expect(screen.getController(0)?.connected).toBe(true);\n     * ```\n     */\n    simulateControllerReconnect(playerIndex: PlayerIndex): void {\n      const controller = _controllers.find((c) => c.playerIndex === playerIndex);\n      if (!controller) {\n        throw new Error(`Controller ${playerIndex} not found`);\n      }\n      // Mark as connected (need to create new object since ControllerInfo is readonly)\n      const reconnectedController = { ...controller, connected: true };\n      _controllers = _controllers.map((c) =>\n        c.playerIndex === playerIndex ? reconnectedController : c\n      );\n      if (onControllerReconnectCallback) {\n        onControllerReconnectCallback(playerIndex, reconnectedController);\n      }\n    },\n\n    simulateCharacterUpdate(playerIndex: PlayerIndex, appearance: CharacterAppearance | null): void {\n      const controller = _controllers.find((c) => c.playerIndex === playerIndex);\n      if (!controller) {\n        throw new Error(`Controller ${playerIndex} not found`);\n      }\n      _controllers = _controllers.map((c) =>\n        c.playerIndex === playerIndex ? { ...c, appearance } : c\n      );\n      if (onCharacterUpdatedCallback) {\n        onCharacterUpdatedCallback(playerIndex, appearance);\n      }\n    },\n\n    simulateRateLimited(event: string): void {\n      if (onRateLimitedCallback) {\n        onRateLimitedCallback(event);\n      }\n    },\n\n    simulateError(error: any): void {\n      if (onErrorCallback) {\n        onErrorCallback(error);\n      }\n    },\n\n    getBroadcasts(): Array<{ event: string; data: unknown }> {\n      return [...broadcasts];\n    },\n\n    getSentToController(\n      playerIndex: PlayerIndex,\n    ): Array<{ event: string; data: unknown }> {\n      return sends\n        .filter((s) => s.playerIndex === playerIndex)\n        .map((s) => ({ event: s.event, data: s.data }));\n    },\n\n    clearRecordedEvents(): void {\n      broadcasts.length = 0;\n      sends.length = 0;\n    },\n\n    triggerReady(): void {\n      _isReady = true;\n      if (onReadyCallback) {\n        onReadyCallback();\n      }\n    },\n  };\n\n  /**\n   * Auto-trigger ready if enabled.\n   *\n   * **Note:** `autoReady` uses `setTimeout(0)` which fires asynchronously (next tick).\n   * For synchronous test control, use `autoReady: false` and call `triggerReady()` manually.\n   */\n  if (autoReady) {\n    setTimeout(() => screen.triggerReady(), 0);\n  }\n\n  return screen;\n}\n\n// =============================================================================\n// MOCK CONTROLLER IMPLEMENTATION\n// =============================================================================\n\ninterface RecordedEvent {\n  event: string;\n  data: unknown;\n}\n\n/**\n * Create a mock Controller for testing player input logic.\n *\n * All methods work synchronously. Events can be simulated and recorded\n * for assertions in unit tests.\n *\n * @example\n * ```ts\n * const controller = createMockController<MyEvents>({\n *   myIndex: 0,\n * });\n *\n * // Simulate receiving from screen\n * controller.simulateEvent('your-turn', { timeLimit: 30 });\n *\n * // Check what was sent\n * expect(controller.getSentEvents()).toContainEqual({\n *   event: 'answer',\n *   data: { choice: 2 },\n * });\n * ```\n */\nexport function createMockController<TEvents extends EventMap = EventMap>(\n  options: MockOptions = {},\n): MockController<TEvents> {\n  const {\n    roomCode = 'TEST',\n    myIndex = 0,\n    autoReady = true,\n    onReady: onReadyCb,\n    onControllerJoin: onJoinCb,\n    onControllerLeave: onLeaveCb,\n    onControllerDisconnect: onDisconnectCb,\n    onControllerReconnect: onReconnectCb,\n    onCharacterUpdated: onCharacterUpdatedCb,\n    onRateLimited: onRateLimitedCb,\n    onError: onErrorCb,\n  } = options;\n\n  // Internal state -- uses a full ControllerInfo[] array (matching MockScreen pattern)\n  // to preserve nickname/appearance data from simulatePlayerJoin()\n  let _isReady = false;\n  let _isDestroyed = false;\n  let _controllers: ControllerInfo[] = options.controllers ?? [];\n\n  // Event listeners\n  const listeners = new Map<string, Set<ControllerEventHandler>>();\n\n  // Lifecycle callbacks\n  let onReadyCallback: (() => void) | undefined;\n  let onControllerJoinCallback:\n    | ((index: PlayerIndex, info: ControllerInfo) => void)\n    | undefined;\n  let onControllerLeaveCallback: ((index: PlayerIndex) => void) | undefined;\n  let onControllerDisconnectCallback: ((index: PlayerIndex) => void) | undefined;\n  let onControllerReconnectCallback:\n    | ((index: PlayerIndex, info: ControllerInfo) => void)\n    | undefined;\n  let onCharacterUpdatedCallback:\n    | ((index: PlayerIndex, appearance: CharacterAppearance | null) => void)\n    | undefined;\n  let onRateLimitedCallback: ((event: string) => void) | undefined;\n  let onErrorCallback: ((error: any) => void) | undefined;\n\n  // Assign callbacks from options\n  onReadyCallback = onReadyCb;\n  onControllerJoinCallback = onJoinCb;\n  onControllerLeaveCallback = onLeaveCb;\n  onControllerDisconnectCallback = onDisconnectCb;\n  onControllerReconnectCallback = onReconnectCb;\n  onCharacterUpdatedCallback = onCharacterUpdatedCb;\n  onRateLimitedCallback = onRateLimitedCb;\n  onErrorCallback = onErrorCb;\n\n  // Recorded events for testing\n  const sentEvents: RecordedEvent[] = [];\n\n  // Controller implementation\n  const controller: MockController<TEvents> = {\n    // === Properties ===\n    get myIndex() {\n      return myIndex;\n    },\n    get roomCode() {\n      return roomCode;\n    },\n    get isReady() {\n      return _isReady;\n    },\n    get isDestroyed() {\n      return _isDestroyed;\n    },\n\n    get controllers(): readonly ControllerInfo[] {\n      return [..._controllers];\n    },\n\n    getControllerCount(): number {\n      return _controllers.filter(c => c.connected).length;\n    },\n\n    // === Communication Methods ===\n    send<K extends EventNames<TEvents>>(\n      event: K,\n      data: EventData<TEvents, K>,\n    ): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot send: controller is destroyed');\n      }\n      validateEventName(event as string);\n      sentEvents.push({ event: event as string, data });\n    },\n\n    sendRaw(event: string, data?: unknown): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot send: controller is destroyed');\n      }\n      validateEventName(event);\n      sentEvents.push({ event, data });\n    },\n\n    // === Event Subscription ===\n    on<K extends EventNames<TEvents>>(\n      event: K,\n      handler: ControllerEventHandler<EventData<TEvents, K>>,\n    ): () => void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      if (!listeners.has(eventStr)) {\n        listeners.set(eventStr, new Set());\n      }\n      listeners.get(eventStr)!.add(handler as ControllerEventHandler);\n\n      return () => {\n        listeners.get(eventStr)?.delete(handler as ControllerEventHandler);\n      };\n    },\n\n    once<K extends EventNames<TEvents>>(\n      event: K,\n      handler: ControllerEventHandler<EventData<TEvents, K>>,\n    ): () => void {\n      validateEventName(event as string);\n      const wrapper: ControllerEventHandler<EventData<TEvents, K>> = (data) => {\n        handler(data);\n        controller.off(event, wrapper);\n      };\n      return controller.on(event, wrapper);\n    },\n\n    off<K extends EventNames<TEvents>>(\n      event: K,\n      handler?: ControllerEventHandler<EventData<TEvents, K>>,\n    ): void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      if (!handler) {\n        listeners.delete(eventStr);\n      } else {\n        listeners.get(eventStr)?.delete(handler as ControllerEventHandler);\n      }\n    },\n\n    // === Cleanup ===\n    destroy(): void {\n      _isDestroyed = true;\n      listeners.clear();\n      sentEvents.length = 0;\n    },\n\n    // === Mock-specific methods ===\n    simulateEvent<K extends EventNames<TEvents>>(\n      event: K,\n      data: EventData<TEvents, K>,\n    ): void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      const handlers = listeners.get(eventStr);\n      if (handlers) {\n        handlers.forEach((handler) => {\n          handler(data);\n        });\n      }\n    },\n\n    getSentEvents(): Array<{ event: string; data: unknown }> {\n      return [...sentEvents];\n    },\n\n    clearRecordedEvents(): void {\n      sentEvents.length = 0;\n    },\n\n    triggerReady(): void {\n      _isReady = true;\n      if (onReadyCallback) {\n        onReadyCallback();\n      }\n    },\n\n    /**\n     * Simulate a new player joining the room.\n     * Stores full ControllerInfo (nickname, appearance, etc.) for later retrieval.\n     *\n     * @example\n     * ```ts\n     * controller.simulatePlayerJoin(2, { playerIndex: 2, nickname: 'Alice', connected: true });\n     * expect(controller.getControllerCount()).toBe(3);\n     * expect(controller.controllers.find(c => c.playerIndex === 2)?.nickname).toBe('Alice');\n     * ```\n     */\n    simulatePlayerJoin(playerIndex: PlayerIndex, info: ControllerInfo): void {\n      if (!_controllers.some(c => c.playerIndex === playerIndex)) {\n        _controllers = [..._controllers, { ...info, connected: info.connected ?? true }];\n      }\n      if (onControllerJoinCallback) {\n        onControllerJoinCallback(playerIndex, info);\n      }\n    },\n\n    /**\n     * Simulate a player leaving the room (fully removed).\n     *\n     * @example\n     * ```ts\n     * controller.simulatePlayerLeave(1);\n     * expect(controller.controllers.some(c => c.playerIndex === 1)).toBe(false);\n     * ```\n     */\n    simulatePlayerLeave(playerIndex: PlayerIndex): void {\n      _controllers = _controllers.filter(c => c.playerIndex !== playerIndex);\n      if (onControllerLeaveCallback) {\n        onControllerLeaveCallback(playerIndex);\n      }\n    },\n\n    /**\n     * Simulate a player network disconnect (player still in room but unreachable).\n     *\n     * @example\n     * ```ts\n     * controller.simulatePlayerDisconnect(1);\n     * expect(controller.controllers.find(c => c.playerIndex === 1)?.connected).toBe(false);\n     * ```\n     */\n    simulatePlayerDisconnect(playerIndex: PlayerIndex): void {\n      _controllers = _controllers.map(c =>\n        c.playerIndex === playerIndex ? { ...c, connected: false } : c\n      );\n      if (onControllerDisconnectCallback) {\n        onControllerDisconnectCallback(playerIndex);\n      }\n    },\n\n    /**\n     * Simulate a player network reconnect after disconnect.\n     *\n     * @example\n     * ```ts\n     * controller.simulatePlayerDisconnect(1);\n     * controller.simulatePlayerReconnect(1, { playerIndex: 1, nickname: 'Bob', connected: true });\n     * expect(controller.controllers.find(c => c.playerIndex === 1)?.connected).toBe(true);\n     * ```\n     */\n    simulatePlayerReconnect(playerIndex: PlayerIndex, info: ControllerInfo): void {\n      _controllers = _controllers.map(c =>\n        c.playerIndex === playerIndex ? { ...info, connected: true } : c\n      );\n      if (onControllerReconnectCallback) {\n        onControllerReconnectCallback(playerIndex, info);\n      }\n    },\n\n    simulateCharacterUpdate(playerIndex: PlayerIndex, appearance: CharacterAppearance | null): void {\n      const controller = _controllers.find((c) => c.playerIndex === playerIndex);\n      if (!controller) {\n        throw new Error(`Controller ${playerIndex} not found`);\n      }\n      _controllers = _controllers.map((c) =>\n        c.playerIndex === playerIndex ? { ...c, appearance } : c\n      );\n      if (onCharacterUpdatedCallback) {\n        onCharacterUpdatedCallback(playerIndex, appearance);\n      }\n    },\n\n    simulateRateLimited(event: string): void {\n      if (onRateLimitedCallback) {\n        onRateLimitedCallback(event);\n      }\n    },\n\n    simulateError(error: any): void {\n      if (onErrorCallback) {\n        onErrorCallback(error);\n      }\n    },\n  };\n\n  /**\n   * Auto-trigger ready if enabled.\n   *\n   * **Note:** `autoReady` uses `setTimeout(0)` which fires asynchronously (next tick).\n   * For synchronous test control, use `autoReady: false` and call `triggerReady()` manually.\n   */\n  if (autoReady) {\n    setTimeout(() => controller.triggerReady(), 0);\n  }\n\n  return controller;\n}\n\n// =============================================================================\n// EXPORTS\n// =============================================================================\n\nexport type { MockScreen, MockController, MockOptions };\n"],"names":["validateEventName","controller"],"mappings":"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"}
+{"version":3,"file":"testing.cjs","sources":["../../src/testing.ts"],"sourcesContent":["/**\n * @smoregg/sdk - Testing Utilities\n *\n * Mock implementations of Screen and Controller for unit testing.\n * All methods work synchronously for predictable test execution.\n *\n * @packageDocumentation\n */\n\nimport type {\n  EventMap,\n  EventNames,\n  EventData,\n  CharacterAppearance,\n  ControllerInfo,\n  PlayerIndex,\n  GameResults,\n  ScreenEventHandler,\n  ControllerEventHandler,\n  MockScreen,\n  MockController,\n  MockOptions,\n} from './types';\nimport { validateEventName } from './events';\n\n// =============================================================================\n// MOCK SCREEN IMPLEMENTATION\n// =============================================================================\n\ninterface RecordedBroadcast {\n  event: string;\n  data: unknown;\n}\n\ninterface RecordedSend {\n  playerIndex: PlayerIndex;\n  event: string;\n  data: unknown;\n}\n\n/**\n * Create a mock Screen for testing game logic.\n *\n * All methods work synchronously. Events can be simulated and recorded\n * for assertions in unit tests.\n *\n * @example\n * ```ts\n * const screen = createMockScreen<MyEvents>({\n *   controllers: [\n *     { playerIndex: 0, nickname: 'Player 1', connected: true },\n *     { playerIndex: 1, nickname: 'Player 2', connected: true },\n *   ],\n * });\n *\n * // Simulate player input\n * screen.simulateEvent(0, 'tap', { x: 100, y: 200 });\n *\n * // Check what was broadcast\n * expect(screen.getBroadcasts()).toContainEqual({\n *   event: 'score-update',\n *   data: { scores: { 0: 10 } },\n * });\n * ```\n */\nexport function createMockScreen<TEvents extends EventMap = EventMap>(\n  options: MockOptions = {},\n): MockScreen<TEvents> {\n  const {\n    roomCode = 'TEST',\n    controllers: initialControllers = [],\n    autoReady = true,\n    onReady: onReadyCb,\n    onControllerJoin: onJoinCb,\n    onControllerLeave: onLeaveCb,\n    onControllerDisconnect: onDisconnectCb,\n    onControllerReconnect: onReconnectCb,\n    onCharacterUpdated: onCharacterUpdatedCb,\n    onRateLimited: onRateLimitedCb,\n    onAllReady: onAllReadyCb,\n    onError: onErrorCb,\n  } = options;\n\n  // Internal state\n  let _controllers: ControllerInfo[] = [...initialControllers];\n  let _isReady = false;\n  let _isDestroyed = false;\n\n  // Event listeners\n  const listeners = new Map<string, Set<ScreenEventHandler>>();\n\n  // Lifecycle callbacks\n  let onReadyCallback: (() => void) | undefined;\n  let onControllerJoinCallback:\n    | ((index: PlayerIndex, info: ControllerInfo) => void)\n    | undefined;\n  let onControllerLeaveCallback: ((index: PlayerIndex) => void) | undefined;\n  let onControllerDisconnectCallback: ((index: PlayerIndex) => void) | undefined;\n  let onControllerReconnectCallback:\n    | ((index: PlayerIndex, info: ControllerInfo) => void)\n    | undefined;\n  let onCharacterUpdatedCallback:\n    | ((index: PlayerIndex, appearance: CharacterAppearance | null) => void)\n    | undefined;\n  let onRateLimitedCallback: ((event: string) => void) | undefined;\n  let onAllReadyCallback: (() => void) | undefined;\n  let onErrorCallback: ((error: any) => void) | undefined;\n\n  // Assign callbacks from options\n  onReadyCallback = onReadyCb;\n  onControllerJoinCallback = onJoinCb;\n  onControllerLeaveCallback = onLeaveCb;\n  onControllerDisconnectCallback = onDisconnectCb;\n  onControllerReconnectCallback = onReconnectCb;\n  onCharacterUpdatedCallback = onCharacterUpdatedCb;\n  onRateLimitedCallback = onRateLimitedCb;\n  onAllReadyCallback = onAllReadyCb;\n  onErrorCallback = onErrorCb;\n\n  // Recorded events for testing\n  const broadcasts: RecordedBroadcast[] = [];\n  const sends: RecordedSend[] = [];\n\n  // Screen implementation\n  const screen: MockScreen<TEvents> = {\n    // === Properties ===\n    get controllers() {\n      return [..._controllers];\n    },\n    get roomCode() {\n      return roomCode;\n    },\n    get isReady() {\n      return _isReady;\n    },\n    get isDestroyed() {\n      return _isDestroyed;\n    },\n\n    // === Communication Methods ===\n    broadcast<K extends EventNames<TEvents>>(\n      event: K,\n      data: EventData<TEvents, K>,\n    ): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot broadcast: screen is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot broadcast: screen is not ready');\n      }\n      validateEventName(event as string);\n      broadcasts.push({ event: event as string, data });\n    },\n\n    broadcastRaw(event: string, data?: unknown): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot broadcast: screen is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot broadcast: screen is not ready');\n      }\n      validateEventName(event);\n      broadcasts.push({ event, data });\n    },\n\n    sendToController<K extends EventNames<TEvents>>(\n      playerIndex: PlayerIndex,\n      event: K,\n      data: EventData<TEvents, K>,\n    ): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot send: screen is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot send: screen is not ready');\n      }\n      validateEventName(event as string);\n      if (!_controllers.some((c) => c.playerIndex === playerIndex)) {\n        throw new Error(`Invalid player index: ${playerIndex}`);\n      }\n      sends.push({ playerIndex, event: event as string, data });\n    },\n\n    sendToControllerRaw(\n      playerIndex: PlayerIndex,\n      event: string,\n      data?: unknown,\n    ): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot send: screen is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot send: screen is not ready');\n      }\n      validateEventName(event);\n      if (!_controllers.some((c) => c.playerIndex === playerIndex)) {\n        throw new Error(`Invalid player index: ${playerIndex}`);\n      }\n      sends.push({ playerIndex, event, data });\n    },\n\n    // === Game Lifecycle ===\n    gameOver(results?: GameResults): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot call gameOver: screen is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot call gameOver: screen is not ready');\n      }\n      broadcasts.push({ event: 'smore:game-over', data: { results } });\n    },\n\n    signalReady(): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot call signalReady: screen is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot call signalReady: screen is not ready');\n      }\n      // No-op in mock (real implementation emits to server)\n    },\n\n    // === Event Subscription ===\n    on<K extends EventNames<TEvents>>(\n      event: K,\n      handler: ScreenEventHandler<EventData<TEvents, K>>,\n    ): () => void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      if (!listeners.has(eventStr)) {\n        listeners.set(eventStr, new Set());\n      }\n      listeners.get(eventStr)!.add(handler as ScreenEventHandler);\n\n      return () => {\n        listeners.get(eventStr)?.delete(handler as ScreenEventHandler);\n      };\n    },\n\n    once<K extends EventNames<TEvents>>(\n      event: K,\n      handler: ScreenEventHandler<EventData<TEvents, K>>,\n    ): () => void {\n      validateEventName(event as string);\n      const wrapper: ScreenEventHandler<EventData<TEvents, K>> = (playerIndex, data) => {\n        handler(playerIndex, data);\n        screen.off(event, wrapper);\n      };\n      return screen.on(event, wrapper);\n    },\n\n    off<K extends EventNames<TEvents>>(\n      event: K,\n      handler?: ScreenEventHandler<EventData<TEvents, K>>,\n    ): void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      if (!handler) {\n        listeners.delete(eventStr);\n      } else {\n        listeners.get(eventStr)?.delete(handler as ScreenEventHandler);\n      }\n    },\n\n    // === Utilities ===\n    getController(playerIndex: PlayerIndex): ControllerInfo | undefined {\n      return _controllers.find((c) => c.playerIndex === playerIndex);\n    },\n\n    getControllerCount(): number {\n      return _controllers.filter(c => c.connected).length;\n    },\n\n    hasAnyConnectedControllers(): boolean {\n      return _controllers.some(c => c.connected);\n    },\n\n    // === Cleanup ===\n    /**\n     * Note: destroy() clears recorded broadcast/event arrays. Call getBroadcasts() before destroy() if assertions are needed.\n     */\n    destroy(): void {\n      _isDestroyed = true;\n      listeners.clear();\n      broadcasts.length = 0;\n      sends.length = 0;\n    },\n\n    // === Mock-specific methods ===\n    simulateEvent<K extends EventNames<TEvents>>(\n      playerIndex: PlayerIndex,\n      event: K,\n      data: EventData<TEvents, K>,\n    ): void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      const handlers = listeners.get(eventStr);\n      if (handlers) {\n        handlers.forEach((handler) => {\n          handler(playerIndex, data);\n        });\n      }\n    },\n\n    simulateControllerJoin(info: ControllerInfo): void {\n      _controllers.push(info);\n      if (onControllerJoinCallback) {\n        onControllerJoinCallback(info.playerIndex, info);\n      }\n    },\n\n    simulateControllerLeave(playerIndex: PlayerIndex): void {\n      _controllers = _controllers.filter((c) => c.playerIndex !== playerIndex);\n      if (onControllerLeaveCallback) {\n        onControllerLeaveCallback(playerIndex);\n      }\n    },\n\n    /**\n     * Simulate a controller network disconnect (player still in room but unreachable).\n     *\n     * @example\n     * ```ts\n     * screen.simulateControllerDisconnect(0);\n     * expect(screen.getController(0)?.connected).toBe(false);\n     * ```\n     */\n    simulateControllerDisconnect(playerIndex: PlayerIndex): void {\n      const controller = _controllers.find((c) => c.playerIndex === playerIndex);\n      if (!controller) {\n        throw new Error(`Controller ${playerIndex} not found`);\n      }\n      // Mark as disconnected (need to create new object since ControllerInfo is readonly)\n      _controllers = _controllers.map((c) =>\n        c.playerIndex === playerIndex\n          ? { ...c, connected: false }\n          : c\n      );\n      if (onControllerDisconnectCallback) {\n        onControllerDisconnectCallback(playerIndex);\n      }\n    },\n\n    /**\n     * Simulate a controller network reconnect after disconnect.\n     *\n     * @example\n     * ```ts\n     * screen.simulateControllerDisconnect(0);\n     * screen.simulateControllerReconnect(0);\n     * expect(screen.getController(0)?.connected).toBe(true);\n     * ```\n     */\n    simulateControllerReconnect(playerIndex: PlayerIndex): void {\n      const controller = _controllers.find((c) => c.playerIndex === playerIndex);\n      if (!controller) {\n        throw new Error(`Controller ${playerIndex} not found`);\n      }\n      // Mark as connected (need to create new object since ControllerInfo is readonly)\n      const reconnectedController = { ...controller, connected: true };\n      _controllers = _controllers.map((c) =>\n        c.playerIndex === playerIndex ? reconnectedController : c\n      );\n      if (onControllerReconnectCallback) {\n        onControllerReconnectCallback(playerIndex, reconnectedController);\n      }\n    },\n\n    simulateCharacterUpdate(playerIndex: PlayerIndex, appearance: CharacterAppearance | null): void {\n      const controller = _controllers.find((c) => c.playerIndex === playerIndex);\n      if (!controller) {\n        throw new Error(`Controller ${playerIndex} not found`);\n      }\n      _controllers = _controllers.map((c) =>\n        c.playerIndex === playerIndex ? { ...c, appearance } : c\n      );\n      if (onCharacterUpdatedCallback) {\n        onCharacterUpdatedCallback(playerIndex, appearance);\n      }\n    },\n\n    simulateRateLimited(event: string): void {\n      if (onRateLimitedCallback) {\n        onRateLimitedCallback(event);\n      }\n    },\n\n    simulateAllReady(): void {\n      if (onAllReadyCallback) {\n        onAllReadyCallback();\n      }\n    },\n\n    simulateError(error: any): void {\n      if (onErrorCallback) {\n        onErrorCallback(error);\n      }\n    },\n\n    getBroadcasts(): Array<{ event: string; data: unknown }> {\n      return [...broadcasts];\n    },\n\n    getSentToController(\n      playerIndex: PlayerIndex,\n    ): Array<{ event: string; data: unknown }> {\n      return sends\n        .filter((s) => s.playerIndex === playerIndex)\n        .map((s) => ({ event: s.event, data: s.data }));\n    },\n\n    clearRecordedEvents(): void {\n      broadcasts.length = 0;\n      sends.length = 0;\n    },\n\n    triggerReady(): void {\n      _isReady = true;\n      if (onReadyCallback) {\n        onReadyCallback();\n      }\n    },\n  };\n\n  /**\n   * Auto-trigger ready if enabled.\n   *\n   * **Note:** `autoReady` uses `setTimeout(0)` which fires asynchronously (next tick).\n   * For synchronous test control, use `autoReady: false` and call `triggerReady()` manually.\n   */\n  if (autoReady) {\n    setTimeout(() => screen.triggerReady(), 0);\n  }\n\n  return screen;\n}\n\n// =============================================================================\n// MOCK CONTROLLER IMPLEMENTATION\n// =============================================================================\n\ninterface RecordedEvent {\n  event: string;\n  data: unknown;\n}\n\n/**\n * Create a mock Controller for testing player input logic.\n *\n * All methods work synchronously. Events can be simulated and recorded\n * for assertions in unit tests.\n *\n * @example\n * ```ts\n * const controller = createMockController<MyEvents>({\n *   myIndex: 0,\n * });\n *\n * // Simulate receiving from screen\n * controller.simulateEvent('your-turn', { timeLimit: 30 });\n *\n * // Check what was sent\n * expect(controller.getSentEvents()).toContainEqual({\n *   event: 'answer',\n *   data: { choice: 2 },\n * });\n * ```\n */\nexport function createMockController<TEvents extends EventMap = EventMap>(\n  options: MockOptions = {},\n): MockController<TEvents> {\n  const {\n    roomCode = 'TEST',\n    myIndex = 0,\n    autoReady = true,\n    onReady: onReadyCb,\n    onControllerJoin: onJoinCb,\n    onControllerLeave: onLeaveCb,\n    onControllerDisconnect: onDisconnectCb,\n    onControllerReconnect: onReconnectCb,\n    onCharacterUpdated: onCharacterUpdatedCb,\n    onRateLimited: onRateLimitedCb,\n    onAllReady: onAllReadyCb,\n    onError: onErrorCb,\n  } = options;\n\n  // Internal state -- uses a full ControllerInfo[] array (matching MockScreen pattern)\n  // to preserve nickname/appearance data from simulatePlayerJoin()\n  let _isReady = false;\n  let _isDestroyed = false;\n  let _controllers: ControllerInfo[] = options.controllers ?? [];\n\n  // Event listeners\n  const listeners = new Map<string, Set<ControllerEventHandler>>();\n\n  // Lifecycle callbacks\n  let onReadyCallback: (() => void) | undefined;\n  let onControllerJoinCallback:\n    | ((index: PlayerIndex, info: ControllerInfo) => void)\n    | undefined;\n  let onControllerLeaveCallback: ((index: PlayerIndex) => void) | undefined;\n  let onControllerDisconnectCallback: ((index: PlayerIndex) => void) | undefined;\n  let onControllerReconnectCallback:\n    | ((index: PlayerIndex, info: ControllerInfo) => void)\n    | undefined;\n  let onCharacterUpdatedCallback:\n    | ((index: PlayerIndex, appearance: CharacterAppearance | null) => void)\n    | undefined;\n  let onRateLimitedCallback: ((event: string) => void) | undefined;\n  let onAllReadyCallback: (() => void) | undefined;\n  let onErrorCallback: ((error: any) => void) | undefined;\n\n  // Assign callbacks from options\n  onReadyCallback = onReadyCb;\n  onControllerJoinCallback = onJoinCb;\n  onControllerLeaveCallback = onLeaveCb;\n  onControllerDisconnectCallback = onDisconnectCb;\n  onControllerReconnectCallback = onReconnectCb;\n  onCharacterUpdatedCallback = onCharacterUpdatedCb;\n  onRateLimitedCallback = onRateLimitedCb;\n  onAllReadyCallback = onAllReadyCb;\n  onErrorCallback = onErrorCb;\n\n  // Recorded events for testing\n  const sentEvents: RecordedEvent[] = [];\n\n  // Controller implementation\n  const controller: MockController<TEvents> = {\n    // === Properties ===\n    get myIndex() {\n      return myIndex;\n    },\n    get roomCode() {\n      return roomCode;\n    },\n    get isReady() {\n      return _isReady;\n    },\n    get isDestroyed() {\n      return _isDestroyed;\n    },\n\n    get controllers(): readonly ControllerInfo[] {\n      return [..._controllers];\n    },\n\n    getControllerCount(): number {\n      return _controllers.filter(c => c.connected).length;\n    },\n\n    // === Communication Methods ===\n    send<K extends EventNames<TEvents>>(\n      event: K,\n      data: EventData<TEvents, K>,\n    ): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot send: controller is destroyed');\n      }\n      validateEventName(event as string);\n      sentEvents.push({ event: event as string, data });\n    },\n\n    sendRaw(event: string, data?: unknown): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot send: controller is destroyed');\n      }\n      validateEventName(event);\n      sentEvents.push({ event, data });\n    },\n\n    signalReady(): void {\n      if (_isDestroyed) {\n        throw new Error('Cannot call signalReady: controller is destroyed');\n      }\n      if (!_isReady) {\n        throw new Error('Cannot call signalReady: controller is not ready');\n      }\n      // No-op in mock (real implementation emits to server)\n    },\n\n    // === Event Subscription ===\n    on<K extends EventNames<TEvents>>(\n      event: K,\n      handler: ControllerEventHandler<EventData<TEvents, K>>,\n    ): () => void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      if (!listeners.has(eventStr)) {\n        listeners.set(eventStr, new Set());\n      }\n      listeners.get(eventStr)!.add(handler as ControllerEventHandler);\n\n      return () => {\n        listeners.get(eventStr)?.delete(handler as ControllerEventHandler);\n      };\n    },\n\n    once<K extends EventNames<TEvents>>(\n      event: K,\n      handler: ControllerEventHandler<EventData<TEvents, K>>,\n    ): () => void {\n      validateEventName(event as string);\n      const wrapper: ControllerEventHandler<EventData<TEvents, K>> = (data) => {\n        handler(data);\n        controller.off(event, wrapper);\n      };\n      return controller.on(event, wrapper);\n    },\n\n    off<K extends EventNames<TEvents>>(\n      event: K,\n      handler?: ControllerEventHandler<EventData<TEvents, K>>,\n    ): void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      if (!handler) {\n        listeners.delete(eventStr);\n      } else {\n        listeners.get(eventStr)?.delete(handler as ControllerEventHandler);\n      }\n    },\n\n    // === Cleanup ===\n    destroy(): void {\n      _isDestroyed = true;\n      listeners.clear();\n      sentEvents.length = 0;\n    },\n\n    // === Mock-specific methods ===\n    simulateEvent<K extends EventNames<TEvents>>(\n      event: K,\n      data: EventData<TEvents, K>,\n    ): void {\n      validateEventName(event as string);\n      const eventStr = event as string;\n      const handlers = listeners.get(eventStr);\n      if (handlers) {\n        handlers.forEach((handler) => {\n          handler(data);\n        });\n      }\n    },\n\n    getSentEvents(): Array<{ event: string; data: unknown }> {\n      return [...sentEvents];\n    },\n\n    clearRecordedEvents(): void {\n      sentEvents.length = 0;\n    },\n\n    triggerReady(): void {\n      _isReady = true;\n      if (onReadyCallback) {\n        onReadyCallback();\n      }\n    },\n\n    /**\n     * Simulate a new player joining the room.\n     * Stores full ControllerInfo (nickname, appearance, etc.) for later retrieval.\n     *\n     * @example\n     * ```ts\n     * controller.simulatePlayerJoin(2, { playerIndex: 2, nickname: 'Alice', connected: true });\n     * expect(controller.getControllerCount()).toBe(3);\n     * expect(controller.controllers.find(c => c.playerIndex === 2)?.nickname).toBe('Alice');\n     * ```\n     */\n    simulatePlayerJoin(playerIndex: PlayerIndex, info: ControllerInfo): void {\n      if (!_controllers.some(c => c.playerIndex === playerIndex)) {\n        _controllers = [..._controllers, { ...info, connected: info.connected ?? true }];\n      }\n      if (onControllerJoinCallback) {\n        onControllerJoinCallback(playerIndex, info);\n      }\n    },\n\n    /**\n     * Simulate a player leaving the room (fully removed).\n     *\n     * @example\n     * ```ts\n     * controller.simulatePlayerLeave(1);\n     * expect(controller.controllers.some(c => c.playerIndex === 1)).toBe(false);\n     * ```\n     */\n    simulatePlayerLeave(playerIndex: PlayerIndex): void {\n      _controllers = _controllers.filter(c => c.playerIndex !== playerIndex);\n      if (onControllerLeaveCallback) {\n        onControllerLeaveCallback(playerIndex);\n      }\n    },\n\n    /**\n     * Simulate a player network disconnect (player still in room but unreachable).\n     *\n     * @example\n     * ```ts\n     * controller.simulatePlayerDisconnect(1);\n     * expect(controller.controllers.find(c => c.playerIndex === 1)?.connected).toBe(false);\n     * ```\n     */\n    simulatePlayerDisconnect(playerIndex: PlayerIndex): void {\n      _controllers = _controllers.map(c =>\n        c.playerIndex === playerIndex ? { ...c, connected: false } : c\n      );\n      if (onControllerDisconnectCallback) {\n        onControllerDisconnectCallback(playerIndex);\n      }\n    },\n\n    /**\n     * Simulate a player network reconnect after disconnect.\n     *\n     * @example\n     * ```ts\n     * controller.simulatePlayerDisconnect(1);\n     * controller.simulatePlayerReconnect(1, { playerIndex: 1, nickname: 'Bob', connected: true });\n     * expect(controller.controllers.find(c => c.playerIndex === 1)?.connected).toBe(true);\n     * ```\n     */\n    simulatePlayerReconnect(playerIndex: PlayerIndex, info: ControllerInfo): void {\n      _controllers = _controllers.map(c =>\n        c.playerIndex === playerIndex ? { ...info, connected: true } : c\n      );\n      if (onControllerReconnectCallback) {\n        onControllerReconnectCallback(playerIndex, info);\n      }\n    },\n\n    simulateCharacterUpdate(playerIndex: PlayerIndex, appearance: CharacterAppearance | null): void {\n      const controller = _controllers.find((c) => c.playerIndex === playerIndex);\n      if (!controller) {\n        throw new Error(`Controller ${playerIndex} not found`);\n      }\n      _controllers = _controllers.map((c) =>\n        c.playerIndex === playerIndex ? { ...c, appearance } : c\n      );\n      if (onCharacterUpdatedCallback) {\n        onCharacterUpdatedCallback(playerIndex, appearance);\n      }\n    },\n\n    simulateRateLimited(event: string): void {\n      if (onRateLimitedCallback) {\n        onRateLimitedCallback(event);\n      }\n    },\n\n    simulateAllReady(): void {\n      if (onAllReadyCallback) {\n        onAllReadyCallback();\n      }\n    },\n\n    simulateError(error: any): void {\n      if (onErrorCallback) {\n        onErrorCallback(error);\n      }\n    },\n  };\n\n  /**\n   * Auto-trigger ready if enabled.\n   *\n   * **Note:** `autoReady` uses `setTimeout(0)` which fires asynchronously (next tick).\n   * For synchronous test control, use `autoReady: false` and call `triggerReady()` manually.\n   */\n  if (autoReady) {\n    setTimeout(() => controller.triggerReady(), 0);\n  }\n\n  return controller;\n}\n\n// =============================================================================\n// EXPORTS\n// =============================================================================\n\nexport type { MockScreen, MockController, MockOptions };\n"],"names":["validateEventName","controller"],"mappings":"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"}

package/dist/esm/controller.js

@@ -149,6 +149,10 @@ class ControllerImpl {
       myIndex: this._myIndex
     });
     this.config.onReady?.();
+    if (this.config.autoReady !== false) {
+      this.logger.lifecycle("Auto-signaling ready (autoReady enabled)");
+      this.signalReady();
+    }
     resolve();
   }
   handleUpdate(msg) {
@@ -278,6 +282,10 @@ class ControllerImpl {
       this.logger.warn(`Rate limited: ${event}`);
       this.config.onRateLimited?.(event);
     });
+    this.registerHandler(SMORE_EVENTS.ALL_READY, () => {
+      this.logger.lifecycle("All participants ready");
+      this.config.onAllReady?.();
+    });
     if (this.config.onHostDisconnect) {
       this.logger.warn("onHostDisconnect is reserved for future use and currently non-functional");
     }
@@ -339,6 +347,11 @@ class ControllerImpl {
     this.logSend(event, data);
     this.transport.emit(event, data);
   }
+  signalReady() {
+    this.ensureReady("signalReady");
+    this.logSend(SMORE_EVENTS.GAME_READY, {});
+    this.transport.emit(SMORE_EVENTS.GAME_READY, {});
+  }
   // ---------------------------------------------------------------------------
   // Event Subscription
   // ---------------------------------------------------------------------------

package/dist/esm/controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"controller.js","sources":["../../src/controller.ts"],"sourcesContent":["/**\n * createController - Factory function for creating a Controller instance.\n *\n * Returns a Promise that resolves when the controller is ready and initialized.\n * Uses PostMessageTransport for iframe communication with parent window.\n *\n * @example Promise-based (recommended)\n * ```ts\n * const controller = await createController<MyEvents>({\n *   listeners: {\n *     'phase-update': (data) => setPhase(data.phase),\n *   },\n * });\n *\n * console.log(`Ready! My index: ${controller.myIndex}`);\n * controller.send('tap', { x: 100, y: 200 });\n * ```\n *\n * @example Callback-based\n * ```ts\n * const controller = createController<MyEvents>({\n *   onReady: () => {\n *     console.log('Ready!');\n *   },\n *   listeners: { ... },\n * });\n * // Use controller.instance for immediate access\n * ```\n */\n\nimport type {\n  Controller,\n  ControllerConfig,\n  ControllerEventHandler,\n  ControllerInfo,\n  EventData,\n  EventMap,\n  EventNames,\n  PlayerIndex,\n  RoomCode,\n} from './types';\nimport { PostMessageTransport } from './transport/PostMessageTransport';\nimport type { TransportEventHandler } from './transport/types';\nimport {\n  isBridgeMessage,\n  validateInitPayload,\n  type BridgeInitMessage,\n  type BridgeUpdateMessage,\n} from './transport/protocol';\nimport { SmoreSDKError } from './errors';\nimport { SMORE_EVENTS, validateEventName } from './events';\nimport { DebugLogger } from './logger';\n\n// =============================================================================\n// CONSTANTS\n// =============================================================================\n\nconst DEFAULT_TIMEOUT = 10000;\n\n// =============================================================================\n// CONTROLLER IMPLEMENTATION\n// =============================================================================\n\nclass ControllerImpl<TEvents extends EventMap> implements Controller<TEvents> {\n  private transport: PostMessageTransport | null = null;\n  private config: ControllerConfig<TEvents>;\n  private logger: DebugLogger;\n  private _roomCode: RoomCode = '';\n  private _myIndex: PlayerIndex = -1;\n  private _isReady: boolean = false;\n  private _isDestroyed: boolean = false;\n  private boundMessageHandler: ((e: MessageEvent) => void) | null = null;\n  private registeredHandlers: Array<{ event: string; handler: TransportEventHandler }> = [];\n  private eventListeners = new Map<string, Set<ControllerEventHandler<unknown>>>();\n  // Maps user-facing handler -> transport wrappedHandler for proper cleanup in on()/off()\n  private handlerToTransport = new Map<Function, { event: string; transportHandler: TransportEventHandler }>();\n  private _controllers: ControllerInfo[] = [];\n  // Tracks event names registered via config.listeners so off(event) without handler won't remove them\n  private _configListenerEvents = new Set<string>();\n\n  constructor(config: ControllerConfig<TEvents> = {}) {\n    this.config = config;\n    this.logger = new DebugLogger(config.debug, '[SmoreController]');\n\n    // Validate event names in listeners\n    if (config.listeners) {\n      for (const event of Object.keys(config.listeners)) {\n        validateEventName(event);\n      }\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Properties (readonly)\n  // ---------------------------------------------------------------------------\n\n  get myIndex(): PlayerIndex {\n    return this._myIndex;\n  }\n\n  get roomCode(): RoomCode {\n    return this._roomCode;\n  }\n\n  get isReady(): boolean {\n    return this._isReady;\n  }\n\n  get isDestroyed(): boolean {\n    return this._isDestroyed;\n  }\n\n  /**\n   * Read-only list of all known controllers (players) in the room.\n   * Returns full ControllerInfo including playerIndex, nickname, connected status, and appearance.\n   *\n   * Returns a new shallow copy on every access. Cache the result if accessing\n   * repeatedly in the same frame/tick.\n   */\n  get controllers(): readonly ControllerInfo[] {\n    return [...this._controllers];\n  }\n\n  /**\n   * Returns the number of currently connected players.\n   */\n  getControllerCount(): number {\n    return this._controllers.filter(c => c.connected).length;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Initialization\n  // ---------------------------------------------------------------------------\n\n  async initialize(): Promise<void> {\n    const parentOrigin = this.config.parentOrigin ?? '*';\n    const timeout = this.config.timeout ?? DEFAULT_TIMEOUT;\n\n    this.logger.lifecycle('Initializing controller...', { parentOrigin, timeout });\n\n    return new Promise<void>((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        this.cleanup();\n        const error = new SmoreSDKError(\n          'TIMEOUT',\n          `Controller initialization timed out after ${timeout}ms. ` +\n            `Make sure the parent window sends _bridge:init message. ` +\n            `Check that the iframe has correct sandbox attributes (allow-scripts required) and same-origin/cross-origin settings. ` +\n            `Create a new Controller instance to retry (this instance has been cleaned up).`,\n          { details: { timeout } },\n        );\n        this.handleError(error);\n        reject(error);\n      }, timeout);\n\n      // Listen for init message from parent\n      this.boundMessageHandler = (e: MessageEvent) => {\n        if (parentOrigin !== '*' && e.origin !== parentOrigin) return;\n\n        const msg = e.data;\n        if (!isBridgeMessage(msg)) return;\n\n        if (msg.type === '_bridge:init') {\n          clearTimeout(timeoutId);\n          this.handleInit(msg as BridgeInitMessage, parentOrigin, resolve, reject);\n        } else if (msg.type === '_bridge:update') {\n          this.handleUpdate(msg as BridgeUpdateMessage);\n        }\n      };\n\n      window.addEventListener('message', this.boundMessageHandler);\n\n      // Signal ready to parent\n      this.logger.lifecycle('Sending _bridge:ready to parent');\n      window.parent.postMessage({ type: '_bridge:ready' }, parentOrigin);\n    });\n  }\n\n  private handleInit(\n    msg: BridgeInitMessage,\n    parentOrigin: string,\n    resolve: () => void,\n    reject: (err: Error) => void,\n  ): void {\n    const initPayload = msg.payload;\n\n    this.logger.debug('Received _bridge:init', initPayload);\n\n    // MIN-A1-1: Runtime validation of _bridge:init payload structure\n    try {\n      validateInitPayload(initPayload);\n    } catch (err) {\n      const error = new SmoreSDKError(\n        'INIT_FAILED',\n        `Invalid _bridge:init payload: ${err instanceof Error ? err.message : String(err)}`,\n        { details: { payload: initPayload } }\n      );\n      this.logger.warn('_bridge:init validation failed', error);\n      this.handleError(error);\n      reject(error);\n      return;\n    }\n\n    const initData = initPayload;\n\n    if (initData.side !== 'player') {\n      const error = new SmoreSDKError(\n        'INIT_FAILED',\n        `Controller received init for wrong side: ${initData.side}`,\n        { details: { side: initData.side } },\n      );\n      this.handleError(error);\n      reject(error);\n      return;\n    }\n\n    if (initData.myIndex === undefined) {\n      const error = new SmoreSDKError(\n        'INIT_FAILED',\n        'Missing myIndex in init payload',\n        { details: initData },\n      );\n      this.handleError(error);\n      reject(error);\n      return;\n    }\n\n    // Initialize transport\n    this.transport = new PostMessageTransport(parentOrigin);\n    this._roomCode = initData.roomCode;\n    this._myIndex = initData.myIndex;\n\n    // Track known players for join/leave detection (full ControllerInfo)\n    const initPlayers = initData.players as Record<string, unknown>[];\n    this._controllers = initPlayers\n      .filter(p => typeof p.playerIndex === 'number')\n      .map((p) => ({\n        playerIndex: (p.playerIndex as number),\n        nickname: (p.nickname as string) || (p.name as string) || `Player ${(p.playerIndex as number) + 1}`,\n        connected: p.connected !== false,\n        appearance: (p.appearance ?? p.character) as ControllerInfo['appearance'],\n      }));\n\n    this.setupEventHandlers();\n\n    this._isReady = true;\n    this.logger.lifecycle('Controller ready', {\n      roomCode: this._roomCode,\n      myIndex: this._myIndex,\n    });\n\n    this.config.onReady?.();\n    resolve();\n  }\n\n  private handleUpdate(msg: BridgeUpdateMessage): void {\n    if (!this._isReady) {\n      this.logger.debug('Ignoring _bridge:update before init completes');\n      return;\n    }\n    const updateData = msg.payload;\n    this.logger.debug('Received _bridge:update', updateData);\n\n    if (updateData.players && Array.isArray(updateData.players)) {\n      const players = updateData.players as Record<string, unknown>[];\n      const newControllers: ControllerInfo[] = players\n        .filter(p => typeof p.playerIndex === 'number')\n        .map(p => ({\n          playerIndex: p.playerIndex as number,\n          nickname: (p.nickname as string) || (p.name as string) || `Player ${(p.playerIndex as number) + 1}`,\n          connected: p.connected !== false,\n          appearance: (p.appearance ?? p.character) as ControllerInfo['appearance'],\n        }));\n\n      const oldControllers = this._controllers;\n\n      // Detect joins\n      for (const nc of newControllers) {\n        if (!oldControllers.some(oc => oc.playerIndex === nc.playerIndex)) {\n          this.config.onControllerJoin?.(nc.playerIndex, nc);\n        }\n      }\n\n      // Detect leaves\n      for (const oc of oldControllers) {\n        if (!newControllers.some(nc => nc.playerIndex === oc.playerIndex)) {\n          this.config.onControllerLeave?.(oc.playerIndex);\n        }\n      }\n\n      // Update connected state for existing players and fire disconnect/reconnect callbacks\n      for (const nc of newControllers) {\n        const oc = oldControllers.find(c => c.playerIndex === nc.playerIndex);\n        if (oc) {\n          // Detect disconnect (was connected, now not)\n          if (oc.connected && !nc.connected) {\n            this.logger.debug('Player disconnected (via update)', { playerIndex: nc.playerIndex });\n            this.config.onControllerDisconnect?.(nc.playerIndex);\n          }\n          // Detect reconnect (was disconnected, now connected)\n          if (!oc.connected && nc.connected) {\n            this.logger.debug('Player reconnected (via update)', { playerIndex: nc.playerIndex });\n            this.config.onControllerReconnect?.(nc.playerIndex, nc);\n          }\n        }\n      }\n\n      this._controllers = newControllers;\n    }\n  }\n\n  private setupEventHandlers(): void {\n    if (!this.transport) return;\n\n    // System events: player join/leave\n    // These smore:* events are forwarded by IframeGameBridge's GAME_FACING_EVENTS allowlist.\n    // Each handler updates _controllers to stay consistent and prevent duplicate\n    // callbacks if _bridge:update also fires with the same data.\n    this.registerHandler(SMORE_EVENTS.PLAYER_JOINED, (raw: unknown) => {\n      const data = raw as { player?: Record<string, unknown>; playerIndex?: number };\n      const playerInfo = data.player as Record<string, unknown> | undefined;\n      const playerIndex = playerInfo?.playerIndex as number | undefined ?? data.playerIndex;\n      if (playerIndex !== undefined) {\n        if (this._controllers.some(c => c.playerIndex === playerIndex)) return;\n        const controllerInfo: ControllerInfo = playerInfo ? {\n          playerIndex,\n          nickname: (playerInfo.nickname as string) || (playerInfo.name as string) || `Player ${playerIndex + 1}`,\n          connected: playerInfo.connected !== false,\n          appearance: (playerInfo.appearance ?? playerInfo.character) as ControllerInfo['appearance'],\n        } : {\n          playerIndex,\n          nickname: `Player ${playerIndex + 1}`,\n          connected: true,\n        };\n        this._controllers = [...this._controllers, controllerInfo];\n        this.logger.debug('Player joined', { playerIndex });\n        this.config.onControllerJoin?.(playerIndex, controllerInfo);\n      }\n    });\n\n    this.registerHandler(SMORE_EVENTS.PLAYER_LEFT, (raw: unknown) => {\n      const data = raw as { player?: { playerIndex?: number }; playerIndex?: number };\n      const playerIndex = data.player?.playerIndex ?? data.playerIndex;\n      if (playerIndex !== undefined) {\n        if (!this._controllers.some(c => c.playerIndex === playerIndex)) return;\n        this._controllers = this._controllers.filter(c => c.playerIndex !== playerIndex);\n        this.logger.debug('Player left', { playerIndex });\n        this.config.onControllerLeave?.(playerIndex);\n      }\n    });\n\n    this.registerHandler(SMORE_EVENTS.PLAYER_DISCONNECTED, (raw: unknown) => {\n      const data = raw as { player?: Record<string, unknown>; playerIndex?: number };\n      const playerData = data.player;\n      const playerIndex = (playerData?.playerIndex as number | undefined) ?? data.playerIndex;\n      if (playerIndex !== undefined) {\n        // Update connected state in _controllers\n        this._controllers = this._controllers.map(c =>\n          c.playerIndex === playerIndex ? { ...c, connected: false } : c\n        );\n        this.logger.debug('Player disconnected', { playerIndex });\n        this.config.onControllerDisconnect?.(playerIndex);\n      }\n    });\n\n    this.registerHandler(SMORE_EVENTS.PLAYER_RECONNECTED, (raw: unknown) => {\n      const data = raw as { player?: Record<string, unknown>; playerIndex?: number };\n      const playerData = data.player;\n      const playerIndex = (playerData?.playerIndex as number | undefined) ?? data.playerIndex;\n      if (playerIndex !== undefined) {\n        // Build ControllerInfo to match Screen SDK behavior\n        const controllerInfo: ControllerInfo = playerData ? {\n          playerIndex,\n          nickname: (playerData.nickname as string) || (playerData.name as string) || `Player ${playerIndex + 1}`,\n          connected: true,\n          appearance: (playerData.appearance ?? playerData.character) as ControllerInfo['appearance'],\n        } : {\n          playerIndex,\n          nickname: `Player ${playerIndex + 1}`,\n          connected: true,\n        };\n        // Update full ControllerInfo in _controllers (reconnect may carry updated data)\n        this._controllers = this._controllers.map(c =>\n          c.playerIndex === playerIndex ? controllerInfo : c\n        );\n        this.logger.debug('Player reconnected', { playerIndex });\n        this.config.onControllerReconnect?.(playerIndex, controllerInfo);\n      }\n    });\n\n    // Character updated: update appearance in _controllers\n    // Server emits { player: player.toDTO(), room: room.toDTO() }\n    this.registerHandler(SMORE_EVENTS.PLAYER_CHARACTER_UPDATED, (raw: unknown) => {\n      const payload = raw as { player?: { playerIndex?: number; character?: Record<string, unknown> | null; name?: string; nickname?: string } };\n      const playerData = payload?.player;\n      if (playerData && typeof playerData.playerIndex === 'number') {\n        const appearance = (playerData.character ?? null) as ControllerInfo['appearance'];\n        this._controllers = this._controllers.map(c =>\n          c.playerIndex === playerData.playerIndex ? { ...c, appearance } : c\n        );\n        this.logger.debug('Player character updated', { playerIndex: playerData.playerIndex });\n        this.config.onCharacterUpdated?.(playerData.playerIndex, appearance ?? null);\n      }\n    });\n\n    // Rate limited: notify when server rate-limits an event\n    this.registerHandler(SMORE_EVENTS.RATE_LIMITED, (raw: unknown) => {\n      const data = raw as { event?: string };\n      const event = data?.event ?? 'unknown';\n      this.logger.warn(`Rate limited: ${event}`);\n      this.config.onRateLimited?.(event);\n    });\n\n    // Host disconnect/reconnect callbacks (@experimental)\n    // The server emits 'smore:host-disconnected' and 'smore:host-reconnected' events,\n    // but they are not in IframeGameBridge's GAME_FACING_EVENTS allowlist, so they\n    // won't reach SDK games. Once GAME_FACING_EVENTS is updated to include these,\n    // register handlers here:\n    //   this.registerHandler('smore:host-disconnected', () => this.config.onHostDisconnect?.());\n    //   this.registerHandler('smore:host-reconnected', () => this.config.onHostReconnect?.());\n    if (this.config.onHostDisconnect) {\n      this.logger.warn('onHostDisconnect is reserved for future use and currently non-functional');\n    }\n    if (this.config.onHostReconnect) {\n      this.logger.warn('onHostReconnect is reserved for future use and currently non-functional');\n    }\n\n    // User event listeners from config\n    // These are tracked in _configListenerEvents so off(event) without handler won't remove them.\n    if (this.config.listeners) {\n      for (const [event, handler] of Object.entries(this.config.listeners)) {\n        if (!handler) continue;\n        this._configListenerEvents.add(event);\n\n        this.registerHandler(event, (data: unknown) => {\n          this.logReceive(event, data);\n          try {\n            (handler as ControllerEventHandler<unknown>)(data);\n          } catch (err) {\n            this.handleError(\n              new SmoreSDKError('UNKNOWN', `Error in handler for event \"${event}\"`, {\n                cause: err instanceof Error ? err : undefined,\n                details: { event },\n              })\n            );\n          }\n        });\n      }\n    }\n  }\n\n  private registerHandler(event: string, handler: TransportEventHandler): void {\n    if (!this.transport) return;\n    this.transport.on(event, handler);\n    this.registeredHandlers.push({ event, handler });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Communication Methods\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Send an event to the Screen. Controller-to-Controller direct communication\n   * is not supported; all messages must go through the Screen.\n   *\n   * Data is sent to the Screen only (not to other controllers). For Screen→Controller communication,\n   * Screen uses broadcast() or sendToController().\n   *\n   * @note Fire-and-forget sends (no callback) will silently fail if rate-limited.\n   * Use the onError callback or smore:rate-limited event to detect rate limiting.\n   */\n  send<K extends EventNames<TEvents>>(event: K, data: EventData<TEvents, K>): void {\n    this.ensureReady('send');\n    validateEventName(event);\n\n    if (typeof data !== 'object' || data === null) {\n      this.logger.warn(\n        'Event data should be an object. Primitive values will be wrapped as { data: value } by the relay server. ' +\n        'To avoid confusion, wrap explicitly: send(\"event\", { value: 42 }) instead of send(\"event\", 42).'\n      );\n    }\n\n    this.logSend(event, data);\n    this.transport!.emit(event, data);\n  }\n\n  sendRaw(event: string, data?: unknown): void {\n    this.ensureReady('sendRaw');\n    validateEventName(event);\n\n    this.logSend(event, data);\n    this.transport!.emit(event, data);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Event Subscription\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Register a handler for custom events.\n   *\n   * When receiving events from Screen's `broadcast()`:\n   *   handler receives `(data)` — no playerIndex included.\n   *\n   * When receiving events from Screen's `sendToController()`:\n   *   handler receives `(data)` — targeted to this specific controller.\n   *\n   * @note Unlike Screen's `on()` which receives `(playerIndex, data)`,\n   * Controller's `on()` receives only `(data)` since there's only one player per controller.\n   *\n   * Controller's on() handler signature: (data) => void\n   * Unlike Screen's (playerIndex, data) => void, Controller doesn't receive playerIndex\n   * because Controller only receives events from Screen, not from other controllers.\n   * The sender is always the Screen, so playerIndex is not applicable.\n   *\n   * **Important:** If called before the Controller is ready (i.e., before `await createController()`\n   * resolves or before the `onReady` callback fires), the handler is stored locally but\n   * will NOT receive events until the transport is initialized. Always call `on()` after\n   * initialization completes, or use `config.listeners` for handlers needed from the start.\n   */\n  on<K extends EventNames<TEvents>>(\n    event: K,\n    handler: ControllerEventHandler<EventData<TEvents, K>>,\n  ): () => void {\n    validateEventName(event);\n\n    // Add to local listeners map\n    let listeners = this.eventListeners.get(event);\n    if (!listeners) {\n      listeners = new Set();\n      this.eventListeners.set(event, listeners);\n    }\n    listeners.add(handler as ControllerEventHandler<unknown>);\n\n    // Register with transport if ready\n    const transportHandler: TransportEventHandler = (data: unknown) => {\n      this.logReceive(event, data);\n      try {\n        (handler as ControllerEventHandler<unknown>)(data);\n      } catch (err) {\n        this.handleError(\n          new SmoreSDKError('UNKNOWN', `Error in handler for event \"${event}\"`, {\n            cause: err instanceof Error ? err : undefined,\n            details: { event },\n          })\n        );\n      }\n    };\n\n    if (this.transport) {\n      this.transport.on(event, transportHandler);\n      this.registeredHandlers.push({ event, handler: transportHandler });\n      this.handlerToTransport.set(handler as Function, { event, transportHandler });\n    }\n\n    // Return unsubscribe function\n    return () => {\n      listeners?.delete(handler as ControllerEventHandler<unknown>);\n      if (listeners?.size === 0) {\n        this.eventListeners.delete(event);\n      }\n      this.transport?.off(event, transportHandler);\n      this.registeredHandlers = this.registeredHandlers.filter(\n        (h) => h.handler !== transportHandler,\n      );\n      this.handlerToTransport.delete(handler as Function);\n    };\n  }\n\n  /**\n   * Add a one-time listener that auto-removes after first call.\n   *\n   * @note The handler is internally wrapped, so it cannot be removed via\n   * `off(event, originalHandler)`. Use the returned unsubscribe function instead.\n   *\n   * @example\n   * ```ts\n   * const unsubscribe = controller.once('game-start', (data) => {\n   *   console.log('Game started!', data);\n   * });\n   *\n   * // To cancel before it fires:\n   * unsubscribe();\n   * ```\n   */\n  once<K extends EventNames<TEvents>>(\n    event: K,\n    handler: ControllerEventHandler<EventData<TEvents, K>>,\n  ): () => void {\n    const unsubscribe = this.on(event, ((data: EventData<TEvents, K>) => {\n      unsubscribe();\n      handler(data);\n    }) as ControllerEventHandler<EventData<TEvents, K>>);\n    return unsubscribe;\n  }\n\n  off<K extends EventNames<TEvents>>(\n    event: K,\n    handler?: ControllerEventHandler<EventData<TEvents, K>>,\n  ): void {\n    if (!handler) {\n      // Remove all dynamically-added listeners for this event, but preserve\n      // config listeners (registered via ControllerConfig.listeners) which are\n      // permanent for the lifetime of the Controller instance.\n      if (this._configListenerEvents.has(event)) {\n        // Only remove handlers that were added via on(), not config listeners.\n        for (const [key, val] of this.handlerToTransport) {\n          if (val.event === event) {\n            this.transport?.off(event, val.transportHandler);\n            this.registeredHandlers = this.registeredHandlers.filter(\n              (h) => h.handler !== val.transportHandler,\n            );\n            this.handlerToTransport.delete(key);\n          }\n        }\n      } else {\n        // No config listener for this event -- safe to remove everything\n        this.eventListeners.delete(event);\n        this.transport?.off(event);\n        this.registeredHandlers = this.registeredHandlers.filter((h) => h.event !== event);\n        for (const [key, val] of this.handlerToTransport) {\n          if (val.event === event) this.handlerToTransport.delete(key);\n        }\n      }\n    } else {\n      // Remove specific handler\n      const listeners = this.eventListeners.get(event);\n      listeners?.delete(handler as ControllerEventHandler<unknown>);\n      if (listeners?.size === 0) {\n        this.eventListeners.delete(event);\n      }\n      // Remove specific transport handler via handlerToTransport map\n      const entry = this.handlerToTransport.get(handler as Function);\n      if (entry) {\n        this.transport?.off(event, entry.transportHandler);\n        this.registeredHandlers = this.registeredHandlers.filter(\n          (h) => h.handler !== entry.transportHandler,\n        );\n        this.handlerToTransport.delete(handler as Function);\n      }\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Cleanup\n  // ---------------------------------------------------------------------------\n\n  destroy(): void {\n    if (this._isDestroyed) return;\n\n    this.logger.lifecycle('Destroying controller');\n    this.cleanup();\n    this._isDestroyed = true;\n  }\n\n  private cleanup(): void {\n    this._isReady = false;\n\n    // Remove all registered handlers\n    for (const { event, handler } of this.registeredHandlers) {\n      this.transport?.off(event, handler);\n    }\n    this.registeredHandlers = [];\n\n    // Clear event listeners\n    this.eventListeners.clear();\n    this.handlerToTransport.clear();\n\n    // Destroy transport\n    if (this.transport) {\n      this.transport.destroy();\n      this.transport = null;\n    }\n\n    // Remove message listener\n    if (this.boundMessageHandler) {\n      window.removeEventListener('message', this.boundMessageHandler);\n      this.boundMessageHandler = null;\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private Helpers\n  // ---------------------------------------------------------------------------\n\n  private ensureReady(method: string): void {\n    if (this._isDestroyed) {\n      throw new SmoreSDKError(\n        'DESTROYED',\n        `Cannot call ${method}() after destroy()`,\n        { details: { method } },\n      );\n    }\n    if (!this._isReady || !this.transport) {\n      throw new SmoreSDKError(\n        'NOT_READY',\n        `Cannot call ${method}() before controller is ready. ` +\n          `Use await createController() or wait for onReady callback.`,\n        { details: { method, isReady: this._isReady } },\n      );\n    }\n  }\n\n  private handleError(error: SmoreSDKError): void {\n    // Always log at warn level so errors are never completely silent\n    this.logger.warn(`Error in handler: ${error.message}`);\n    if (this.config.onError) {\n      this.config.onError(error.toSmoreError());\n    } else {\n      this.logger.error(error.message, error.details);\n    }\n  }\n\n  private logSend(event: string, data?: unknown): void {\n    this.logger.send(event, data);\n  }\n\n  private logReceive(event: string, data?: unknown): void {\n    this.logger.receive(event, data);\n  }\n}\n\n// =============================================================================\n// FACTORY FUNCTION\n// =============================================================================\n\n/**\n * Create a Controller instance for the player/phone side of your game.\n *\n * Returns a Promise that resolves when the controller is ready.\n * The returned object also has an `instance` property for immediate access.\n *\n * @template TEvents - Event map type for type-safe events\n * @param config - Controller configuration\n * @returns Promise that resolves to the Controller instance when ready\n *\n * @example Promise-based (recommended)\n * ```ts\n * const controller = await createController<MyEvents>({\n *   listeners: {\n *     'phase-update': (data) => setPhase(data.phase),\n *   },\n * });\n *\n * controller.send('tap', { x: 100, y: 200 });\n * ```\n *\n * @example Callback-based\n * ```ts\n * const result = createController<MyEvents>({\n *   onReady: () => {\n *     result.instance.send('ready', {});\n *   },\n *   listeners: { ... },\n * });\n * ```\n */\nexport function createController<TEvents extends EventMap = EventMap>(\n  config?: ControllerConfig<TEvents>,\n): Promise<Controller<TEvents>> & { instance: Controller<TEvents> } {\n  const controller = new ControllerImpl<TEvents>(config ?? {});\n\n  const promise = controller.initialize().then(() => controller as Controller<TEvents>);\n\n  // Attach instance property for immediate access\n  (promise as Promise<Controller<TEvents>> & { instance: Controller<TEvents> }).instance =\n    controller;\n\n  return promise as Promise<Controller<TEvents>> & { instance: Controller<TEvents> };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"controller.js","sources":["../../src/controller.ts"],"sourcesContent":["/**\n * createController - Factory function for creating a Controller instance.\n *\n * Returns a Promise that resolves when the controller is ready and initialized.\n * Uses PostMessageTransport for iframe communication with parent window.\n *\n * @example Promise-based (recommended)\n * ```ts\n * const controller = await createController<MyEvents>({\n *   listeners: {\n *     'phase-update': (data) => setPhase(data.phase),\n *   },\n * });\n *\n * console.log(`Ready! My index: ${controller.myIndex}`);\n * controller.send('tap', { x: 100, y: 200 });\n * ```\n *\n * @example Callback-based\n * ```ts\n * const controller = createController<MyEvents>({\n *   onReady: () => {\n *     console.log('Ready!');\n *   },\n *   listeners: { ... },\n * });\n * // Use controller.instance for immediate access\n * ```\n */\n\nimport type {\n  Controller,\n  ControllerConfig,\n  ControllerEventHandler,\n  ControllerInfo,\n  EventData,\n  EventMap,\n  EventNames,\n  PlayerIndex,\n  RoomCode,\n} from './types';\nimport { PostMessageTransport } from './transport/PostMessageTransport';\nimport type { TransportEventHandler } from './transport/types';\nimport {\n  isBridgeMessage,\n  validateInitPayload,\n  type BridgeInitMessage,\n  type BridgeUpdateMessage,\n} from './transport/protocol';\nimport { SmoreSDKError } from './errors';\nimport { SMORE_EVENTS, validateEventName } from './events';\nimport { DebugLogger } from './logger';\n\n// =============================================================================\n// CONSTANTS\n// =============================================================================\n\nconst DEFAULT_TIMEOUT = 10000;\n\n// =============================================================================\n// CONTROLLER IMPLEMENTATION\n// =============================================================================\n\nclass ControllerImpl<TEvents extends EventMap> implements Controller<TEvents> {\n  private transport: PostMessageTransport | null = null;\n  private config: ControllerConfig<TEvents>;\n  private logger: DebugLogger;\n  private _roomCode: RoomCode = '';\n  private _myIndex: PlayerIndex = -1;\n  private _isReady: boolean = false;\n  private _isDestroyed: boolean = false;\n  private boundMessageHandler: ((e: MessageEvent) => void) | null = null;\n  private registeredHandlers: Array<{ event: string; handler: TransportEventHandler }> = [];\n  private eventListeners = new Map<string, Set<ControllerEventHandler<unknown>>>();\n  // Maps user-facing handler -> transport wrappedHandler for proper cleanup in on()/off()\n  private handlerToTransport = new Map<Function, { event: string; transportHandler: TransportEventHandler }>();\n  private _controllers: ControllerInfo[] = [];\n  // Tracks event names registered via config.listeners so off(event) without handler won't remove them\n  private _configListenerEvents = new Set<string>();\n\n  constructor(config: ControllerConfig<TEvents> = {}) {\n    this.config = config;\n    this.logger = new DebugLogger(config.debug, '[SmoreController]');\n\n    // Validate event names in listeners\n    if (config.listeners) {\n      for (const event of Object.keys(config.listeners)) {\n        validateEventName(event);\n      }\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Properties (readonly)\n  // ---------------------------------------------------------------------------\n\n  get myIndex(): PlayerIndex {\n    return this._myIndex;\n  }\n\n  get roomCode(): RoomCode {\n    return this._roomCode;\n  }\n\n  get isReady(): boolean {\n    return this._isReady;\n  }\n\n  get isDestroyed(): boolean {\n    return this._isDestroyed;\n  }\n\n  /**\n   * Read-only list of all known controllers (players) in the room.\n   * Returns full ControllerInfo including playerIndex, nickname, connected status, and appearance.\n   *\n   * Returns a new shallow copy on every access. Cache the result if accessing\n   * repeatedly in the same frame/tick.\n   */\n  get controllers(): readonly ControllerInfo[] {\n    return [...this._controllers];\n  }\n\n  /**\n   * Returns the number of currently connected players.\n   */\n  getControllerCount(): number {\n    return this._controllers.filter(c => c.connected).length;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Initialization\n  // ---------------------------------------------------------------------------\n\n  async initialize(): Promise<void> {\n    const parentOrigin = this.config.parentOrigin ?? '*';\n    const timeout = this.config.timeout ?? DEFAULT_TIMEOUT;\n\n    this.logger.lifecycle('Initializing controller...', { parentOrigin, timeout });\n\n    return new Promise<void>((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        this.cleanup();\n        const error = new SmoreSDKError(\n          'TIMEOUT',\n          `Controller initialization timed out after ${timeout}ms. ` +\n            `Make sure the parent window sends _bridge:init message. ` +\n            `Check that the iframe has correct sandbox attributes (allow-scripts required) and same-origin/cross-origin settings. ` +\n            `Create a new Controller instance to retry (this instance has been cleaned up).`,\n          { details: { timeout } },\n        );\n        this.handleError(error);\n        reject(error);\n      }, timeout);\n\n      // Listen for init message from parent\n      this.boundMessageHandler = (e: MessageEvent) => {\n        if (parentOrigin !== '*' && e.origin !== parentOrigin) return;\n\n        const msg = e.data;\n        if (!isBridgeMessage(msg)) return;\n\n        if (msg.type === '_bridge:init') {\n          clearTimeout(timeoutId);\n          this.handleInit(msg as BridgeInitMessage, parentOrigin, resolve, reject);\n        } else if (msg.type === '_bridge:update') {\n          this.handleUpdate(msg as BridgeUpdateMessage);\n        }\n      };\n\n      window.addEventListener('message', this.boundMessageHandler);\n\n      // Signal ready to parent\n      this.logger.lifecycle('Sending _bridge:ready to parent');\n      window.parent.postMessage({ type: '_bridge:ready' }, parentOrigin);\n    });\n  }\n\n  private handleInit(\n    msg: BridgeInitMessage,\n    parentOrigin: string,\n    resolve: () => void,\n    reject: (err: Error) => void,\n  ): void {\n    const initPayload = msg.payload;\n\n    this.logger.debug('Received _bridge:init', initPayload);\n\n    // MIN-A1-1: Runtime validation of _bridge:init payload structure\n    try {\n      validateInitPayload(initPayload);\n    } catch (err) {\n      const error = new SmoreSDKError(\n        'INIT_FAILED',\n        `Invalid _bridge:init payload: ${err instanceof Error ? err.message : String(err)}`,\n        { details: { payload: initPayload } }\n      );\n      this.logger.warn('_bridge:init validation failed', error);\n      this.handleError(error);\n      reject(error);\n      return;\n    }\n\n    const initData = initPayload;\n\n    if (initData.side !== 'player') {\n      const error = new SmoreSDKError(\n        'INIT_FAILED',\n        `Controller received init for wrong side: ${initData.side}`,\n        { details: { side: initData.side } },\n      );\n      this.handleError(error);\n      reject(error);\n      return;\n    }\n\n    if (initData.myIndex === undefined) {\n      const error = new SmoreSDKError(\n        'INIT_FAILED',\n        'Missing myIndex in init payload',\n        { details: initData },\n      );\n      this.handleError(error);\n      reject(error);\n      return;\n    }\n\n    // Initialize transport\n    this.transport = new PostMessageTransport(parentOrigin);\n    this._roomCode = initData.roomCode;\n    this._myIndex = initData.myIndex;\n\n    // Track known players for join/leave detection (full ControllerInfo)\n    const initPlayers = initData.players as Record<string, unknown>[];\n    this._controllers = initPlayers\n      .filter(p => typeof p.playerIndex === 'number')\n      .map((p) => ({\n        playerIndex: (p.playerIndex as number),\n        nickname: (p.nickname as string) || (p.name as string) || `Player ${(p.playerIndex as number) + 1}`,\n        connected: p.connected !== false,\n        appearance: (p.appearance ?? p.character) as ControllerInfo['appearance'],\n      }));\n\n    this.setupEventHandlers();\n\n    this._isReady = true;\n    this.logger.lifecycle('Controller ready', {\n      roomCode: this._roomCode,\n      myIndex: this._myIndex,\n    });\n\n    this.config.onReady?.();\n\n    // Auto-signal ready unless explicitly disabled\n    if (this.config.autoReady !== false) {\n      this.logger.lifecycle('Auto-signaling ready (autoReady enabled)');\n      this.signalReady();\n    }\n\n    resolve();\n  }\n\n  private handleUpdate(msg: BridgeUpdateMessage): void {\n    if (!this._isReady) {\n      this.logger.debug('Ignoring _bridge:update before init completes');\n      return;\n    }\n    const updateData = msg.payload;\n    this.logger.debug('Received _bridge:update', updateData);\n\n    if (updateData.players && Array.isArray(updateData.players)) {\n      const players = updateData.players as Record<string, unknown>[];\n      const newControllers: ControllerInfo[] = players\n        .filter(p => typeof p.playerIndex === 'number')\n        .map(p => ({\n          playerIndex: p.playerIndex as number,\n          nickname: (p.nickname as string) || (p.name as string) || `Player ${(p.playerIndex as number) + 1}`,\n          connected: p.connected !== false,\n          appearance: (p.appearance ?? p.character) as ControllerInfo['appearance'],\n        }));\n\n      const oldControllers = this._controllers;\n\n      // Detect joins\n      for (const nc of newControllers) {\n        if (!oldControllers.some(oc => oc.playerIndex === nc.playerIndex)) {\n          this.config.onControllerJoin?.(nc.playerIndex, nc);\n        }\n      }\n\n      // Detect leaves\n      for (const oc of oldControllers) {\n        if (!newControllers.some(nc => nc.playerIndex === oc.playerIndex)) {\n          this.config.onControllerLeave?.(oc.playerIndex);\n        }\n      }\n\n      // Update connected state for existing players and fire disconnect/reconnect callbacks\n      for (const nc of newControllers) {\n        const oc = oldControllers.find(c => c.playerIndex === nc.playerIndex);\n        if (oc) {\n          // Detect disconnect (was connected, now not)\n          if (oc.connected && !nc.connected) {\n            this.logger.debug('Player disconnected (via update)', { playerIndex: nc.playerIndex });\n            this.config.onControllerDisconnect?.(nc.playerIndex);\n          }\n          // Detect reconnect (was disconnected, now connected)\n          if (!oc.connected && nc.connected) {\n            this.logger.debug('Player reconnected (via update)', { playerIndex: nc.playerIndex });\n            this.config.onControllerReconnect?.(nc.playerIndex, nc);\n          }\n        }\n      }\n\n      this._controllers = newControllers;\n    }\n  }\n\n  private setupEventHandlers(): void {\n    if (!this.transport) return;\n\n    // System events: player join/leave\n    // These smore:* events are forwarded by IframeGameBridge's GAME_FACING_EVENTS allowlist.\n    // Each handler updates _controllers to stay consistent and prevent duplicate\n    // callbacks if _bridge:update also fires with the same data.\n    this.registerHandler(SMORE_EVENTS.PLAYER_JOINED, (raw: unknown) => {\n      const data = raw as { player?: Record<string, unknown>; playerIndex?: number };\n      const playerInfo = data.player as Record<string, unknown> | undefined;\n      const playerIndex = playerInfo?.playerIndex as number | undefined ?? data.playerIndex;\n      if (playerIndex !== undefined) {\n        if (this._controllers.some(c => c.playerIndex === playerIndex)) return;\n        const controllerInfo: ControllerInfo = playerInfo ? {\n          playerIndex,\n          nickname: (playerInfo.nickname as string) || (playerInfo.name as string) || `Player ${playerIndex + 1}`,\n          connected: playerInfo.connected !== false,\n          appearance: (playerInfo.appearance ?? playerInfo.character) as ControllerInfo['appearance'],\n        } : {\n          playerIndex,\n          nickname: `Player ${playerIndex + 1}`,\n          connected: true,\n        };\n        this._controllers = [...this._controllers, controllerInfo];\n        this.logger.debug('Player joined', { playerIndex });\n        this.config.onControllerJoin?.(playerIndex, controllerInfo);\n      }\n    });\n\n    this.registerHandler(SMORE_EVENTS.PLAYER_LEFT, (raw: unknown) => {\n      const data = raw as { player?: { playerIndex?: number }; playerIndex?: number };\n      const playerIndex = data.player?.playerIndex ?? data.playerIndex;\n      if (playerIndex !== undefined) {\n        if (!this._controllers.some(c => c.playerIndex === playerIndex)) return;\n        this._controllers = this._controllers.filter(c => c.playerIndex !== playerIndex);\n        this.logger.debug('Player left', { playerIndex });\n        this.config.onControllerLeave?.(playerIndex);\n      }\n    });\n\n    this.registerHandler(SMORE_EVENTS.PLAYER_DISCONNECTED, (raw: unknown) => {\n      const data = raw as { player?: Record<string, unknown>; playerIndex?: number };\n      const playerData = data.player;\n      const playerIndex = (playerData?.playerIndex as number | undefined) ?? data.playerIndex;\n      if (playerIndex !== undefined) {\n        // Update connected state in _controllers\n        this._controllers = this._controllers.map(c =>\n          c.playerIndex === playerIndex ? { ...c, connected: false } : c\n        );\n        this.logger.debug('Player disconnected', { playerIndex });\n        this.config.onControllerDisconnect?.(playerIndex);\n      }\n    });\n\n    this.registerHandler(SMORE_EVENTS.PLAYER_RECONNECTED, (raw: unknown) => {\n      const data = raw as { player?: Record<string, unknown>; playerIndex?: number };\n      const playerData = data.player;\n      const playerIndex = (playerData?.playerIndex as number | undefined) ?? data.playerIndex;\n      if (playerIndex !== undefined) {\n        // Build ControllerInfo to match Screen SDK behavior\n        const controllerInfo: ControllerInfo = playerData ? {\n          playerIndex,\n          nickname: (playerData.nickname as string) || (playerData.name as string) || `Player ${playerIndex + 1}`,\n          connected: true,\n          appearance: (playerData.appearance ?? playerData.character) as ControllerInfo['appearance'],\n        } : {\n          playerIndex,\n          nickname: `Player ${playerIndex + 1}`,\n          connected: true,\n        };\n        // Update full ControllerInfo in _controllers (reconnect may carry updated data)\n        this._controllers = this._controllers.map(c =>\n          c.playerIndex === playerIndex ? controllerInfo : c\n        );\n        this.logger.debug('Player reconnected', { playerIndex });\n        this.config.onControllerReconnect?.(playerIndex, controllerInfo);\n      }\n    });\n\n    // Character updated: update appearance in _controllers\n    // Server emits { player: player.toDTO(), room: room.toDTO() }\n    this.registerHandler(SMORE_EVENTS.PLAYER_CHARACTER_UPDATED, (raw: unknown) => {\n      const payload = raw as { player?: { playerIndex?: number; character?: Record<string, unknown> | null; name?: string; nickname?: string } };\n      const playerData = payload?.player;\n      if (playerData && typeof playerData.playerIndex === 'number') {\n        const appearance = (playerData.character ?? null) as ControllerInfo['appearance'];\n        this._controllers = this._controllers.map(c =>\n          c.playerIndex === playerData.playerIndex ? { ...c, appearance } : c\n        );\n        this.logger.debug('Player character updated', { playerIndex: playerData.playerIndex });\n        this.config.onCharacterUpdated?.(playerData.playerIndex, appearance ?? null);\n      }\n    });\n\n    // Rate limited: notify when server rate-limits an event\n    this.registerHandler(SMORE_EVENTS.RATE_LIMITED, (raw: unknown) => {\n      const data = raw as { event?: string };\n      const event = data?.event ?? 'unknown';\n      this.logger.warn(`Rate limited: ${event}`);\n      this.config.onRateLimited?.(event);\n    });\n\n    // All ready: all participants have signaled ready\n    this.registerHandler(SMORE_EVENTS.ALL_READY, () => {\n      this.logger.lifecycle('All participants ready');\n      this.config.onAllReady?.();\n    });\n\n    // Host disconnect/reconnect callbacks (@experimental)\n    // The server emits 'smore:host-disconnected' and 'smore:host-reconnected' events,\n    // but they are not in IframeGameBridge's GAME_FACING_EVENTS allowlist, so they\n    // won't reach SDK games. Once GAME_FACING_EVENTS is updated to include these,\n    // register handlers here:\n    //   this.registerHandler('smore:host-disconnected', () => this.config.onHostDisconnect?.());\n    //   this.registerHandler('smore:host-reconnected', () => this.config.onHostReconnect?.());\n    if (this.config.onHostDisconnect) {\n      this.logger.warn('onHostDisconnect is reserved for future use and currently non-functional');\n    }\n    if (this.config.onHostReconnect) {\n      this.logger.warn('onHostReconnect is reserved for future use and currently non-functional');\n    }\n\n    // User event listeners from config\n    // These are tracked in _configListenerEvents so off(event) without handler won't remove them.\n    if (this.config.listeners) {\n      for (const [event, handler] of Object.entries(this.config.listeners)) {\n        if (!handler) continue;\n        this._configListenerEvents.add(event);\n\n        this.registerHandler(event, (data: unknown) => {\n          this.logReceive(event, data);\n          try {\n            (handler as ControllerEventHandler<unknown>)(data);\n          } catch (err) {\n            this.handleError(\n              new SmoreSDKError('UNKNOWN', `Error in handler for event \"${event}\"`, {\n                cause: err instanceof Error ? err : undefined,\n                details: { event },\n              })\n            );\n          }\n        });\n      }\n    }\n  }\n\n  private registerHandler(event: string, handler: TransportEventHandler): void {\n    if (!this.transport) return;\n    this.transport.on(event, handler);\n    this.registeredHandlers.push({ event, handler });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Communication Methods\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Send an event to the Screen. Controller-to-Controller direct communication\n   * is not supported; all messages must go through the Screen.\n   *\n   * Data is sent to the Screen only (not to other controllers). For Screen→Controller communication,\n   * Screen uses broadcast() or sendToController().\n   *\n   * @note Fire-and-forget sends (no callback) will silently fail if rate-limited.\n   * Use the onError callback or smore:rate-limited event to detect rate limiting.\n   */\n  send<K extends EventNames<TEvents>>(event: K, data: EventData<TEvents, K>): void {\n    this.ensureReady('send');\n    validateEventName(event);\n\n    if (typeof data !== 'object' || data === null) {\n      this.logger.warn(\n        'Event data should be an object. Primitive values will be wrapped as { data: value } by the relay server. ' +\n        'To avoid confusion, wrap explicitly: send(\"event\", { value: 42 }) instead of send(\"event\", 42).'\n      );\n    }\n\n    this.logSend(event, data);\n    this.transport!.emit(event, data);\n  }\n\n  sendRaw(event: string, data?: unknown): void {\n    this.ensureReady('sendRaw');\n    validateEventName(event);\n\n    this.logSend(event, data);\n    this.transport!.emit(event, data);\n  }\n\n  signalReady(): void {\n    this.ensureReady('signalReady');\n    this.logSend(SMORE_EVENTS.GAME_READY, {});\n    this.transport!.emit(SMORE_EVENTS.GAME_READY, {});\n  }\n\n  // ---------------------------------------------------------------------------\n  // Event Subscription\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Register a handler for custom events.\n   *\n   * When receiving events from Screen's `broadcast()`:\n   *   handler receives `(data)` — no playerIndex included.\n   *\n   * When receiving events from Screen's `sendToController()`:\n   *   handler receives `(data)` — targeted to this specific controller.\n   *\n   * @note Unlike Screen's `on()` which receives `(playerIndex, data)`,\n   * Controller's `on()` receives only `(data)` since there's only one player per controller.\n   *\n   * Controller's on() handler signature: (data) => void\n   * Unlike Screen's (playerIndex, data) => void, Controller doesn't receive playerIndex\n   * because Controller only receives events from Screen, not from other controllers.\n   * The sender is always the Screen, so playerIndex is not applicable.\n   *\n   * **Important:** If called before the Controller is ready (i.e., before `await createController()`\n   * resolves or before the `onReady` callback fires), the handler is stored locally but\n   * will NOT receive events until the transport is initialized. Always call `on()` after\n   * initialization completes, or use `config.listeners` for handlers needed from the start.\n   */\n  on<K extends EventNames<TEvents>>(\n    event: K,\n    handler: ControllerEventHandler<EventData<TEvents, K>>,\n  ): () => void {\n    validateEventName(event);\n\n    // Add to local listeners map\n    let listeners = this.eventListeners.get(event);\n    if (!listeners) {\n      listeners = new Set();\n      this.eventListeners.set(event, listeners);\n    }\n    listeners.add(handler as ControllerEventHandler<unknown>);\n\n    // Register with transport if ready\n    const transportHandler: TransportEventHandler = (data: unknown) => {\n      this.logReceive(event, data);\n      try {\n        (handler as ControllerEventHandler<unknown>)(data);\n      } catch (err) {\n        this.handleError(\n          new SmoreSDKError('UNKNOWN', `Error in handler for event \"${event}\"`, {\n            cause: err instanceof Error ? err : undefined,\n            details: { event },\n          })\n        );\n      }\n    };\n\n    if (this.transport) {\n      this.transport.on(event, transportHandler);\n      this.registeredHandlers.push({ event, handler: transportHandler });\n      this.handlerToTransport.set(handler as Function, { event, transportHandler });\n    }\n\n    // Return unsubscribe function\n    return () => {\n      listeners?.delete(handler as ControllerEventHandler<unknown>);\n      if (listeners?.size === 0) {\n        this.eventListeners.delete(event);\n      }\n      this.transport?.off(event, transportHandler);\n      this.registeredHandlers = this.registeredHandlers.filter(\n        (h) => h.handler !== transportHandler,\n      );\n      this.handlerToTransport.delete(handler as Function);\n    };\n  }\n\n  /**\n   * Add a one-time listener that auto-removes after first call.\n   *\n   * @note The handler is internally wrapped, so it cannot be removed via\n   * `off(event, originalHandler)`. Use the returned unsubscribe function instead.\n   *\n   * @example\n   * ```ts\n   * const unsubscribe = controller.once('game-start', (data) => {\n   *   console.log('Game started!', data);\n   * });\n   *\n   * // To cancel before it fires:\n   * unsubscribe();\n   * ```\n   */\n  once<K extends EventNames<TEvents>>(\n    event: K,\n    handler: ControllerEventHandler<EventData<TEvents, K>>,\n  ): () => void {\n    const unsubscribe = this.on(event, ((data: EventData<TEvents, K>) => {\n      unsubscribe();\n      handler(data);\n    }) as ControllerEventHandler<EventData<TEvents, K>>);\n    return unsubscribe;\n  }\n\n  off<K extends EventNames<TEvents>>(\n    event: K,\n    handler?: ControllerEventHandler<EventData<TEvents, K>>,\n  ): void {\n    if (!handler) {\n      // Remove all dynamically-added listeners for this event, but preserve\n      // config listeners (registered via ControllerConfig.listeners) which are\n      // permanent for the lifetime of the Controller instance.\n      if (this._configListenerEvents.has(event)) {\n        // Only remove handlers that were added via on(), not config listeners.\n        for (const [key, val] of this.handlerToTransport) {\n          if (val.event === event) {\n            this.transport?.off(event, val.transportHandler);\n            this.registeredHandlers = this.registeredHandlers.filter(\n              (h) => h.handler !== val.transportHandler,\n            );\n            this.handlerToTransport.delete(key);\n          }\n        }\n      } else {\n        // No config listener for this event -- safe to remove everything\n        this.eventListeners.delete(event);\n        this.transport?.off(event);\n        this.registeredHandlers = this.registeredHandlers.filter((h) => h.event !== event);\n        for (const [key, val] of this.handlerToTransport) {\n          if (val.event === event) this.handlerToTransport.delete(key);\n        }\n      }\n    } else {\n      // Remove specific handler\n      const listeners = this.eventListeners.get(event);\n      listeners?.delete(handler as ControllerEventHandler<unknown>);\n      if (listeners?.size === 0) {\n        this.eventListeners.delete(event);\n      }\n      // Remove specific transport handler via handlerToTransport map\n      const entry = this.handlerToTransport.get(handler as Function);\n      if (entry) {\n        this.transport?.off(event, entry.transportHandler);\n        this.registeredHandlers = this.registeredHandlers.filter(\n          (h) => h.handler !== entry.transportHandler,\n        );\n        this.handlerToTransport.delete(handler as Function);\n      }\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Cleanup\n  // ---------------------------------------------------------------------------\n\n  destroy(): void {\n    if (this._isDestroyed) return;\n\n    this.logger.lifecycle('Destroying controller');\n    this.cleanup();\n    this._isDestroyed = true;\n  }\n\n  private cleanup(): void {\n    this._isReady = false;\n\n    // Remove all registered handlers\n    for (const { event, handler } of this.registeredHandlers) {\n      this.transport?.off(event, handler);\n    }\n    this.registeredHandlers = [];\n\n    // Clear event listeners\n    this.eventListeners.clear();\n    this.handlerToTransport.clear();\n\n    // Destroy transport\n    if (this.transport) {\n      this.transport.destroy();\n      this.transport = null;\n    }\n\n    // Remove message listener\n    if (this.boundMessageHandler) {\n      window.removeEventListener('message', this.boundMessageHandler);\n      this.boundMessageHandler = null;\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private Helpers\n  // ---------------------------------------------------------------------------\n\n  private ensureReady(method: string): void {\n    if (this._isDestroyed) {\n      throw new SmoreSDKError(\n        'DESTROYED',\n        `Cannot call ${method}() after destroy()`,\n        { details: { method } },\n      );\n    }\n    if (!this._isReady || !this.transport) {\n      throw new SmoreSDKError(\n        'NOT_READY',\n        `Cannot call ${method}() before controller is ready. ` +\n          `Use await createController() or wait for onReady callback.`,\n        { details: { method, isReady: this._isReady } },\n      );\n    }\n  }\n\n  private handleError(error: SmoreSDKError): void {\n    // Always log at warn level so errors are never completely silent\n    this.logger.warn(`Error in handler: ${error.message}`);\n    if (this.config.onError) {\n      this.config.onError(error.toSmoreError());\n    } else {\n      this.logger.error(error.message, error.details);\n    }\n  }\n\n  private logSend(event: string, data?: unknown): void {\n    this.logger.send(event, data);\n  }\n\n  private logReceive(event: string, data?: unknown): void {\n    this.logger.receive(event, data);\n  }\n}\n\n// =============================================================================\n// FACTORY FUNCTION\n// =============================================================================\n\n/**\n * Create a Controller instance for the player/phone side of your game.\n *\n * Returns a Promise that resolves when the controller is ready.\n * The returned object also has an `instance` property for immediate access.\n *\n * @template TEvents - Event map type for type-safe events\n * @param config - Controller configuration\n * @returns Promise that resolves to the Controller instance when ready\n *\n * @example Promise-based (recommended)\n * ```ts\n * const controller = await createController<MyEvents>({\n *   listeners: {\n *     'phase-update': (data) => setPhase(data.phase),\n *   },\n * });\n *\n * controller.send('tap', { x: 100, y: 200 });\n * ```\n *\n * @example Callback-based\n * ```ts\n * const result = createController<MyEvents>({\n *   onReady: () => {\n *     result.instance.send('ready', {});\n *   },\n *   listeners: { ... },\n * });\n * ```\n */\nexport function createController<TEvents extends EventMap = EventMap>(\n  config?: ControllerConfig<TEvents>,\n): Promise<Controller<TEvents>> & { instance: Controller<TEvents> } {\n  const controller = new ControllerImpl<TEvents>(config ?? {});\n\n  const promise = controller.initialize().then(() => controller as Controller<TEvents>);\n\n  // Attach instance property for immediate access\n  (promise as Promise<Controller<TEvents>> & { instance: Controller<TEvents> }).instance =\n    controller;\n\n  return promise as Promise<Controller<TEvents>> & { instance: Controller<TEvents> };\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/events.js

@@ -14,6 +14,9 @@ const SMORE_EVENTS = {
   PLAYER_CHARACTER_UPDATED: "smore:player-character-updated",
   // Rate limiting
   RATE_LIMITED: "smore:rate-limited",
+  // Game ready sync
+  GAME_READY: "smore:game-ready",
+  ALL_READY: "smore:all-ready",
   // Send to specific player (internal use)
   SEND_TO_PLAYER: "smore:send-to-player"
   // Used internally by platform, not handled by SDK

package/dist/esm/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sources":["../../src/events.ts"],"sourcesContent":["/**\n * SDK system event constants (socket level)\n *\n * smore:* prefix = platform service events\n * User events are validated to prevent ':' usage via validateEventName()\n *\n * Note: iframe ↔ parent internal communication uses _bridge:* prefix (transport/protocol.ts)\n */\n\nimport { SmoreSDKError } from './errors';\n\n/**\n * Platform system event names (internal use only).\n *\n * These events are reserved by the S'MORE platform and cannot be used by game code.\n * All platform events use the `smore:` prefix to avoid conflicts with user events.\n *\n * User-defined events are validated to prevent `:` usage via validateEventName().\n *\n * @internal Not part of the public SDK API. Do not import directly.\n */\nexport const SMORE_EVENTS = {\n  // Game lifecycle\n  GAME_OVER: 'smore:game-over',\n  RETURN_TO_LOBBY: 'smore:return-to-lobby', // Used internally by platform, not handled by SDK\n\n  // Player management\n  PLAYER_JOINED: 'smore:player-joined',\n  PLAYER_LEFT: 'smore:player-left',\n  PLAYER_DISCONNECTED: 'smore:player-disconnected',\n  PLAYER_RECONNECTED: 'smore:player-reconnected',\n\n  // Character change\n  PLAYER_CHARACTER_UPDATED: 'smore:player-character-updated',\n\n  // Rate limiting\n  RATE_LIMITED: 'smore:rate-limited',\n\n  // Send to specific player (internal use)\n  SEND_TO_PLAYER: 'smore:send-to-player', // Used internally by platform, not handled by SDK\n} as const;\n\nexport type SmoreEvent = typeof SMORE_EVENTS[keyof typeof SMORE_EVENTS];\n\nexport const SYSTEM_EVENTS: ReadonlySet<string> = new Set(\n  Object.values(SMORE_EVENTS)\n);\n\n\nexport const EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z0-9_-]*[a-zA-Z0-9])?$/;\n\nexport const EVENT_NAME_MAX_LENGTH = 128;\n\n/**\n * Validate a user-defined event name.\n *\n * Enforces naming rules to prevent conflicts with platform system events:\n * - Must start with a letter\n * - Can contain letters, numbers, hyphens, underscores\n * - Must end with a letter or number\n * - Cannot contain `:` (reserved for platform events like `smore:*`)\n * - Maximum length: 128 characters\n *\n * @throws {SmoreSDKError} INVALID_EVENT if validation fails\n *\n * @example\n * ```ts\n * validateEventName('player-ready'); // OK\n * validateEventName('score_update'); // OK\n * validateEventName('tap123'); // OK\n * validateEventName('smore:internal'); // Throws: colon not allowed\n * validateEventName('123start'); // Throws: must start with letter\n * ```\n */\nexport function validateEventName(event: string): void {\n  if (!event || typeof event !== 'string') {\n    throw new SmoreSDKError('INVALID_EVENT', 'Event name must be a non-empty string');\n  }\n  if (event.length > EVENT_NAME_MAX_LENGTH) {\n    throw new SmoreSDKError(\n      'INVALID_EVENT',\n      `Event name exceeds maximum length of ${EVENT_NAME_MAX_LENGTH} characters (got ${event.length}).`,\n      { details: { event: event.slice(0, 50) + '...' } }\n    );\n  }\n  if (!EVENT_NAME_REGEX.test(event)) {\n    throw new SmoreSDKError(\n      'INVALID_EVENT',\n      `Invalid event name \"${event}\". Event names must start with a letter, ` +\n        `contain only letters, numbers, hyphens, or underscores, and end with a letter or number.`,\n      { details: { event } }\n    );\n  }\n}\n\n/**\n * Check if an event name is a system event.\n *\n * System events use the `smore:` prefix and are reserved for platform use.\n * Prefix-based check is intentional for forward-compatibility with new system events.\n *\n * @param event - Event name to check\n * @returns true if the event is a system event\n */\nexport function isSystemEvent(event: string): boolean {\n  return event.startsWith('smore:');\n}\n"],"names":[],"mappings":";;AAqBO,MAAM,YAAA,GAAe;AAAA;AAAA,EAE1B,SAAA,EAAW,iBAAA;AAAA,EACX,eAAA,EAAiB,uBAAA;AAAA;AAAA;AAAA,EAGjB,aAAA,EAAe,qBAAA;AAAA,EACf,WAAA,EAAa,mBAAA;AAAA,EACb,mBAAA,EAAqB,2BAAA;AAAA,EACrB,kBAAA,EAAoB,0BAAA;AAAA;AAAA,EAGpB,wBAAA,EAA0B,gCAAA;AAAA;AAAA,EAG1B,YAAA,EAAc,oBAAA;AAAA;AAAA,EAGd,cAAA,EAAgB;AAAA;AAClB;AAIkD,IAAI,GAAA;AAAA,EACpD,MAAA,CAAO,OAAO,YAAY;AAC5B;AAGO,MAAM,gBAAA,GAAmB;AAEzB,MAAM,qBAAA,GAAwB;AAuB9B,SAAS,kBAAkB,KAAA,EAAqB;AACrD,EAAA,IAAI,CAAC,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,EAAU;AACvC,IAAA,MAAM,IAAI,aAAA,CAAc,eAAA,EAAiB,uCAAuC,CAAA;AAAA,EAClF;AACA,EAAA,IAAI,KAAA,CAAM,SAAS,qBAAA,EAAuB;AACxC,IAAA,MAAM,IAAI,aAAA;AAAA,MACR,eAAA;AAAA,MACA,CAAA,qCAAA,EAAwC,qBAAqB,CAAA,iBAAA,EAAoB,KAAA,CAAM,MAAM,CAAA,EAAA,CAAA;AAAA,MAC7F,EAAE,OAAA,EAAS,EAAE,KAAA,EAAO,KAAA,CAAM,MAAM,CAAA,EAAG,EAAE,CAAA,GAAI,KAAA,EAAM;AAAE,KACnD;AAAA,EACF;AACA,EAAA,IAAI,CAAC,gBAAA,CAAiB,IAAA,CAAK,KAAK,CAAA,EAAG;AACjC,IAAA,MAAM,IAAI,aAAA;AAAA,MACR,eAAA;AAAA,MACA,uBAAuB,KAAK,CAAA,iIAAA,CAAA;AAAA,MAE5B,EAAE,OAAA,EAAS,EAAE,KAAA,EAAM;AAAE,KACvB;AAAA,EACF;AACF;;;;"}
+{"version":3,"file":"events.js","sources":["../../src/events.ts"],"sourcesContent":["/**\n * SDK system event constants (socket level)\n *\n * smore:* prefix = platform service events\n * User events are validated to prevent ':' usage via validateEventName()\n *\n * Note: iframe ↔ parent internal communication uses _bridge:* prefix (transport/protocol.ts)\n */\n\nimport { SmoreSDKError } from './errors';\n\n/**\n * Platform system event names (internal use only).\n *\n * These events are reserved by the S'MORE platform and cannot be used by game code.\n * All platform events use the `smore:` prefix to avoid conflicts with user events.\n *\n * User-defined events are validated to prevent `:` usage via validateEventName().\n *\n * @internal Not part of the public SDK API. Do not import directly.\n */\nexport const SMORE_EVENTS = {\n  // Game lifecycle\n  GAME_OVER: 'smore:game-over',\n  RETURN_TO_LOBBY: 'smore:return-to-lobby', // Used internally by platform, not handled by SDK\n\n  // Player management\n  PLAYER_JOINED: 'smore:player-joined',\n  PLAYER_LEFT: 'smore:player-left',\n  PLAYER_DISCONNECTED: 'smore:player-disconnected',\n  PLAYER_RECONNECTED: 'smore:player-reconnected',\n\n  // Character change\n  PLAYER_CHARACTER_UPDATED: 'smore:player-character-updated',\n\n  // Rate limiting\n  RATE_LIMITED: 'smore:rate-limited',\n\n  // Game ready sync\n  GAME_READY: 'smore:game-ready',\n  ALL_READY: 'smore:all-ready',\n\n  // Send to specific player (internal use)\n  SEND_TO_PLAYER: 'smore:send-to-player', // Used internally by platform, not handled by SDK\n} as const;\n\nexport type SmoreEvent = typeof SMORE_EVENTS[keyof typeof SMORE_EVENTS];\n\nexport const SYSTEM_EVENTS: ReadonlySet<string> = new Set(\n  Object.values(SMORE_EVENTS)\n);\n\n\nexport const EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z0-9_-]*[a-zA-Z0-9])?$/;\n\nexport const EVENT_NAME_MAX_LENGTH = 128;\n\n/**\n * Validate a user-defined event name.\n *\n * Enforces naming rules to prevent conflicts with platform system events:\n * - Must start with a letter\n * - Can contain letters, numbers, hyphens, underscores\n * - Must end with a letter or number\n * - Cannot contain `:` (reserved for platform events like `smore:*`)\n * - Maximum length: 128 characters\n *\n * @throws {SmoreSDKError} INVALID_EVENT if validation fails\n *\n * @example\n * ```ts\n * validateEventName('player-ready'); // OK\n * validateEventName('score_update'); // OK\n * validateEventName('tap123'); // OK\n * validateEventName('smore:internal'); // Throws: colon not allowed\n * validateEventName('123start'); // Throws: must start with letter\n * ```\n */\nexport function validateEventName(event: string): void {\n  if (!event || typeof event !== 'string') {\n    throw new SmoreSDKError('INVALID_EVENT', 'Event name must be a non-empty string');\n  }\n  if (event.length > EVENT_NAME_MAX_LENGTH) {\n    throw new SmoreSDKError(\n      'INVALID_EVENT',\n      `Event name exceeds maximum length of ${EVENT_NAME_MAX_LENGTH} characters (got ${event.length}).`,\n      { details: { event: event.slice(0, 50) + '...' } }\n    );\n  }\n  if (!EVENT_NAME_REGEX.test(event)) {\n    throw new SmoreSDKError(\n      'INVALID_EVENT',\n      `Invalid event name \"${event}\". Event names must start with a letter, ` +\n        `contain only letters, numbers, hyphens, or underscores, and end with a letter or number.`,\n      { details: { event } }\n    );\n  }\n}\n\n/**\n * Check if an event name is a system event.\n *\n * System events use the `smore:` prefix and are reserved for platform use.\n * Prefix-based check is intentional for forward-compatibility with new system events.\n *\n * @param event - Event name to check\n * @returns true if the event is a system event\n */\nexport function isSystemEvent(event: string): boolean {\n  return event.startsWith('smore:');\n}\n"],"names":[],"mappings":";;AAqBO,MAAM,YAAA,GAAe;AAAA;AAAA,EAE1B,SAAA,EAAW,iBAAA;AAAA,EACX,eAAA,EAAiB,uBAAA;AAAA;AAAA;AAAA,EAGjB,aAAA,EAAe,qBAAA;AAAA,EACf,WAAA,EAAa,mBAAA;AAAA,EACb,mBAAA,EAAqB,2BAAA;AAAA,EACrB,kBAAA,EAAoB,0BAAA;AAAA;AAAA,EAGpB,wBAAA,EAA0B,gCAAA;AAAA;AAAA,EAG1B,YAAA,EAAc,oBAAA;AAAA;AAAA,EAGd,UAAA,EAAY,kBAAA;AAAA,EACZ,SAAA,EAAW,iBAAA;AAAA;AAAA,EAGX,cAAA,EAAgB;AAAA;AAClB;AAIkD,IAAI,GAAA;AAAA,EACpD,MAAA,CAAO,OAAO,YAAY;AAC5B;AAGO,MAAM,gBAAA,GAAmB;AAEzB,MAAM,qBAAA,GAAwB;AAuB9B,SAAS,kBAAkB,KAAA,EAAqB;AACrD,EAAA,IAAI,CAAC,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,EAAU;AACvC,IAAA,MAAM,IAAI,aAAA,CAAc,eAAA,EAAiB,uCAAuC,CAAA;AAAA,EAClF;AACA,EAAA,IAAI,KAAA,CAAM,SAAS,qBAAA,EAAuB;AACxC,IAAA,MAAM,IAAI,aAAA;AAAA,MACR,eAAA;AAAA,MACA,CAAA,qCAAA,EAAwC,qBAAqB,CAAA,iBAAA,EAAoB,KAAA,CAAM,MAAM,CAAA,EAAA,CAAA;AAAA,MAC7F,EAAE,OAAA,EAAS,EAAE,KAAA,EAAO,KAAA,CAAM,MAAM,CAAA,EAAG,EAAE,CAAA,GAAI,KAAA,EAAM;AAAE,KACnD;AAAA,EACF;AACA,EAAA,IAAI,CAAC,gBAAA,CAAiB,IAAA,CAAK,KAAK,CAAA,EAAG;AACjC,IAAA,MAAM,IAAI,aAAA;AAAA,MACR,eAAA;AAAA,MACA,uBAAuB,KAAK,CAAA,iIAAA,CAAA;AAAA,MAE5B,EAAE,OAAA,EAAS,EAAE,KAAA,EAAM;AAAE,KACvB;AAAA,EACF;AACF;;;;"}

package/dist/esm/screen.js

@@ -103,6 +103,10 @@ class ScreenImpl {
             controllers: this._controllers.length
           });
           this.config.onReady?.();
+          if (this.config.autoReady !== false) {
+            this.logger.lifecycle("Auto-signaling ready (autoReady enabled)");
+            this.signalReady();
+          }
           resolve();
         } else if (msg.type === "_bridge:update") {
           if (!this._isReady) {
@@ -221,6 +225,10 @@ class ScreenImpl {
       this.logger.warn(`Rate limited: ${event}`);
       this.config.onRateLimited?.(event);
     });
+    this.registerTransportHandler(SMORE_EVENTS.ALL_READY, () => {
+      this.logger.lifecycle("All participants ready");
+      this.config.onAllReady?.();
+    });
     if (this.config.listeners) {
       for (const [event, handler] of Object.entries(this.config.listeners)) {
         if (!handler) continue;
@@ -390,6 +398,11 @@ class ScreenImpl {
     this.logger.lifecycle("Game over", results);
     this.transport.emit(SMORE_EVENTS.GAME_OVER, { results });
   }
+  signalReady() {
+    this.ensureReady("signalReady");
+    this.logger.lifecycle("Signaling ready");
+    this.transport.emit(SMORE_EVENTS.GAME_READY, {});
+  }
   // ---------------------------------------------------------------------------
   // Event Subscription
   // ---------------------------------------------------------------------------