@smoregg/sdk 0.5.0 → 0.6.1

package/dist/cjs/testing.cjs

@@ -0,0 +1,257 @@
+'use strict';
+
+function createMockScreen(options = {}) {
+  const {
+    roomCode = "TEST",
+    controllers: initialControllers = [],
+    autoReady = true
+  } = options;
+  let _controllers = [...initialControllers];
+  let _isReady = false;
+  let _isDestroyed = false;
+  let _leaderIndex = initialControllers[0]?.playerIndex ?? -1;
+  const listeners = /* @__PURE__ */ new Map();
+  const broadcasts = [];
+  const sends = [];
+  const screen = {
+    // === Properties ===
+    get controllers() {
+      return [..._controllers];
+    },
+    get roomCode() {
+      return roomCode;
+    },
+    get leaderIndex() {
+      return _leaderIndex;
+    },
+    get isReady() {
+      return _isReady;
+    },
+    get isDestroyed() {
+      return _isDestroyed;
+    },
+    // === Communication Methods ===
+    broadcast(event, data) {
+      if (_isDestroyed) {
+        throw new Error("Cannot broadcast: screen is destroyed");
+      }
+      broadcasts.push({ event, data });
+    },
+    broadcastRaw(event, data) {
+      if (_isDestroyed) {
+        throw new Error("Cannot broadcast: screen is destroyed");
+      }
+      broadcasts.push({ event, data });
+    },
+    sendToController(playerIndex, event, data) {
+      if (_isDestroyed) {
+        throw new Error("Cannot send: screen is destroyed");
+      }
+      if (!_controllers.some((c) => c.playerIndex === playerIndex)) {
+        throw new Error(`Invalid player index: ${playerIndex}`);
+      }
+      sends.push({ playerIndex, event, data });
+    },
+    sendToControllerRaw(playerIndex, event, data) {
+      if (_isDestroyed) {
+        throw new Error("Cannot send: screen is destroyed");
+      }
+      if (!_controllers.some((c) => c.playerIndex === playerIndex)) {
+        throw new Error(`Invalid player index: ${playerIndex}`);
+      }
+      sends.push({ playerIndex, event, data });
+    },
+    // === Game Lifecycle ===
+    gameOver(results) {
+      screen.broadcastRaw("game-over", results);
+    },
+    // === Event Subscription ===
+    on(event, handler) {
+      const eventStr = event;
+      if (!listeners.has(eventStr)) {
+        listeners.set(eventStr, /* @__PURE__ */ new Set());
+      }
+      listeners.get(eventStr).add(handler);
+      return () => {
+        listeners.get(eventStr)?.delete(handler);
+      };
+    },
+    once(event, handler) {
+      const wrapper = (playerIndex, data) => {
+        handler(playerIndex, data);
+        screen.off(event, wrapper);
+      };
+      return screen.on(event, wrapper);
+    },
+    off(event, handler) {
+      const eventStr = event;
+      if (!handler) {
+        listeners.delete(eventStr);
+      } else {
+        listeners.get(eventStr)?.delete(handler);
+      }
+    },
+    // === Utilities ===
+    getController(playerIndex) {
+      return _controllers.find((c) => c.playerIndex === playerIndex);
+    },
+    isLeader(playerIndex) {
+      return playerIndex === _leaderIndex;
+    },
+    getControllerCount() {
+      return _controllers.length;
+    },
+    // === Cleanup ===
+    destroy() {
+      _isDestroyed = true;
+      listeners.clear();
+      broadcasts.length = 0;
+      sends.length = 0;
+    },
+    // === Mock-specific methods ===
+    simulateEvent(playerIndex, event, data) {
+      const eventStr = event;
+      const handlers = listeners.get(eventStr);
+      if (handlers) {
+        handlers.forEach((handler) => {
+          handler(playerIndex, data);
+        });
+      }
+    },
+    simulateControllerJoin(info) {
+      _controllers.push(info);
+      if (_leaderIndex === -1) {
+        _leaderIndex = info.playerIndex;
+      }
+    },
+    simulateControllerLeave(playerIndex) {
+      _controllers = _controllers.filter((c) => c.playerIndex !== playerIndex);
+      if (_leaderIndex === playerIndex) {
+        _leaderIndex = _controllers[0]?.playerIndex ?? -1;
+      }
+    },
+    getBroadcasts() {
+      return [...broadcasts];
+    },
+    getSentToController(playerIndex) {
+      return sends.filter((s) => s.playerIndex === playerIndex).map((s) => ({ event: s.event, data: s.data }));
+    },
+    clearRecordedEvents() {
+      broadcasts.length = 0;
+      sends.length = 0;
+    },
+    triggerReady() {
+      _isReady = true;
+    }
+  };
+  if (autoReady) {
+    setTimeout(() => screen.triggerReady(), 0);
+  }
+  return screen;
+}
+function createMockController(options = {}) {
+  const {
+    roomCode = "TEST",
+    myIndex = 0,
+    isLeader: initialIsLeader = false,
+    autoReady = true
+  } = options;
+  let _isReady = false;
+  let _isDestroyed = false;
+  let _isLeader = initialIsLeader;
+  const listeners = /* @__PURE__ */ new Map();
+  const sentEvents = [];
+  const controller = {
+    // === Properties ===
+    get myIndex() {
+      return myIndex;
+    },
+    get isLeader() {
+      return _isLeader;
+    },
+    get roomCode() {
+      return roomCode;
+    },
+    get isReady() {
+      return _isReady;
+    },
+    get isDestroyed() {
+      return _isDestroyed;
+    },
+    // === Communication Methods ===
+    send(event, data) {
+      if (_isDestroyed) {
+        throw new Error("Cannot send: controller is destroyed");
+      }
+      sentEvents.push({ event, data });
+    },
+    sendRaw(event, data) {
+      if (_isDestroyed) {
+        throw new Error("Cannot send: controller is destroyed");
+      }
+      sentEvents.push({ event, data });
+    },
+    // === Event Subscription ===
+    on(event, handler) {
+      const eventStr = event;
+      if (!listeners.has(eventStr)) {
+        listeners.set(eventStr, /* @__PURE__ */ new Set());
+      }
+      listeners.get(eventStr).add(handler);
+      return () => {
+        listeners.get(eventStr)?.delete(handler);
+      };
+    },
+    once(event, handler) {
+      const wrapper = (data) => {
+        handler(data);
+        controller.off(event, wrapper);
+      };
+      return controller.on(event, wrapper);
+    },
+    off(event, handler) {
+      const eventStr = event;
+      if (!handler) {
+        listeners.delete(eventStr);
+      } else {
+        listeners.get(eventStr)?.delete(handler);
+      }
+    },
+    // === Cleanup ===
+    destroy() {
+      _isDestroyed = true;
+      listeners.clear();
+      sentEvents.length = 0;
+    },
+    // === Mock-specific methods ===
+    simulateEvent(event, data) {
+      const eventStr = event;
+      const handlers = listeners.get(eventStr);
+      if (handlers) {
+        handlers.forEach((handler) => {
+          handler(data);
+        });
+      }
+    },
+    getSentEvents() {
+      return [...sentEvents];
+    },
+    clearRecordedEvents() {
+      sentEvents.length = 0;
+    },
+    triggerReady() {
+      _isReady = true;
+    },
+    setLeader(isLeader) {
+      _isLeader = isLeader;
+    }
+  };
+  if (autoReady) {
+    setTimeout(() => controller.triggerReady(), 0);
+  }
+  return controller;
+}
+
+exports.createMockController = createMockController;
+exports.createMockScreen = createMockScreen;
+//# sourceMappingURL=testing.cjs.map

package/dist/cjs/testing.cjs.map

@@ -0,0 +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  ControllerInfo,\n  PlayerIndex,\n  GameResults,\n  ScreenEventHandler,\n  ControllerEventHandler,\n  MockScreen,\n  MockController,\n  MockOptions,\n} from './types';\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  } = options;\n\n  // Internal state\n  let _controllers: ControllerInfo[] = [...initialControllers];\n  let _isReady = false;\n  let _isDestroyed = false;\n  let _leaderIndex: PlayerIndex = initialControllers[0]?.playerIndex ?? -1;\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\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 leaderIndex() {\n      return _leaderIndex;\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      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      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 (!_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 (!_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      screen.broadcastRaw('game-over', results);\n    },\n\n    // === Event Subscription ===\n    on<K extends EventNames<TEvents>>(\n      event: K,\n      handler: ScreenEventHandler<EventData<TEvents, K>>,\n    ): () => void {\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      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      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    isLeader(playerIndex: PlayerIndex): boolean {\n      return playerIndex === _leaderIndex;\n    },\n\n    getControllerCount(): number {\n      return _controllers.length;\n    },\n\n    // === Cleanup ===\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      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 (_leaderIndex === -1) {\n        _leaderIndex = info.playerIndex;\n      }\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 (_leaderIndex === playerIndex) {\n        _leaderIndex = _controllers[0]?.playerIndex ?? -1;\n      }\n      if (onControllerLeaveCallback) {\n        onControllerLeaveCallback(playerIndex);\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  // Auto-trigger ready if enabled\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 *   isLeader: true,\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    isLeader: initialIsLeader = false,\n    autoReady = true,\n  } = options;\n\n  // Internal state\n  let _isReady = false;\n  let _isDestroyed = false;\n  let _isLeader = initialIsLeader;\n\n  // Event listeners\n  const listeners = new Map<string, Set<ControllerEventHandler>>();\n\n  // Lifecycle callbacks\n  let onReadyCallback: (() => void) | undefined;\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 isLeader() {\n      return _isLeader;\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    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      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      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      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      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      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      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    setLeader(isLeader: boolean): void {\n      _isLeader = isLeader;\n    },\n  };\n\n  // Auto-trigger ready if enabled\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":[],"mappings":"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"}

package/dist/cjs/transport/protocol.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.cjs","sources":["../../../src/transport/protocol.ts"],"sourcesContent":["/**\n * postMessage protocol types for iframe ↔ parent communication.\n */\n\nexport const SMORE_MSG_PREFIX = 'smore:' as const;\n\nexport interface SmoreReadyMessage {\n  type: 'smore:ready';\n}\n\nexport interface SmoreInitMessage {\n  type: 'smore:init';\n  payload: {\n    side: 'host' | 'player';\n    roomCode: string;\n    players: any[];\n    leaderId: string | null;\n    myIndex?: number;\n    isLeader?: boolean;\n  };\n}\n\nexport interface SmoreEmitMessage {\n  type: 'smore:emit';\n  payload: {\n    event: string;\n    data?: any;\n    ackId?: string;\n  };\n}\n\nexport interface SmoreEventMessage {\n  type: 'smore:event';\n  payload: {\n    event: string;\n    data?: any;\n  };\n}\n\nexport interface SmoreAckMessage {\n  type: 'smore:ack';\n  payload: {\n    ackId: string;\n    data?: any;\n  };\n}\n\nexport interface SmoreUpdateMessage {\n  type: 'smore:update';\n  payload: {\n    players?: any[];\n    leaderId?: string | null;\n  };\n}\n\nexport interface SmoreLoadedMessage {\n  type: 'smore:loaded';\n}\n\nexport type SmoreMessage =\n  | SmoreReadyMessage\n  | SmoreInitMessage\n  | SmoreEmitMessage\n  | SmoreEventMessage\n  | SmoreAckMessage\n  | SmoreUpdateMessage\n  | SmoreLoadedMessage;\n\nexport function isSmoreMessage(data: any): data is SmoreMessage {\n  return data && typeof data === 'object' && typeof data.type === 'string' && data.type.startsWith(SMORE_MSG_PREFIX);\n}\n"],"names":[],"mappings":";;AAIO,MAAM,gBAAA,GAAmB;AAgEzB,SAAS,eAAe,IAAA,EAAiC;AAC9D,EAAA,OAAO,IAAA,IAAQ,OAAO,IAAA,KAAS,QAAA,IAAY,OAAO,IAAA,CAAK,IAAA,KAAS,QAAA,IAAY,IAAA,CAAK,IAAA,CAAK,UAAA,CAAW,gBAAgB,CAAA;AACnH;;;;;"}
+{"version":3,"file":"protocol.cjs","sources":["../../../src/transport/protocol.ts"],"sourcesContent":["/**\n * postMessage protocol types for iframe ↔ parent communication.\n */\n\nexport const SMORE_MSG_PREFIX = 'smore:' as const;\n\nexport interface SmoreReadyMessage {\n  type: 'smore:ready';\n}\n\nexport interface SmoreInitMessage {\n  type: 'smore:init';\n  payload: {\n    side: 'host' | 'player';\n    roomCode: string;\n    players: any[];\n    leaderId: string | null;\n    myIndex?: number;\n    isLeader?: boolean;\n  };\n}\n\nexport interface SmoreEmitMessage {\n  type: 'smore:emit';\n  payload: {\n    event: string;\n    data?: any;\n    ackId?: string;\n  };\n}\n\nexport interface SmoreEventMessage {\n  type: 'smore:event';\n  payload: {\n    event: string;\n    data?: any;\n  };\n}\n\nexport interface SmoreAckMessage {\n  type: 'smore:ack';\n  payload: {\n    ackId: string;\n    data?: any;\n  };\n}\n\nexport interface SmoreUpdateMessage {\n  type: 'smore:update';\n  payload: {\n    players?: any[];\n    leaderId?: string | null;\n  };\n}\n\n// DEPRECATED: SmoreLoadedMessage removed - no longer used in protocol\n// Previously: interface SmoreLoadedMessage { type: 'smore:loaded' }\n\nexport type SmoreMessage =\n  | SmoreReadyMessage\n  | SmoreInitMessage\n  | SmoreEmitMessage\n  | SmoreEventMessage\n  | SmoreAckMessage\n  | SmoreUpdateMessage;\n\nexport function isSmoreMessage(data: any): data is SmoreMessage {\n  return data && typeof data === 'object' && typeof data.type === 'string' && data.type.startsWith(SMORE_MSG_PREFIX);\n}\n"],"names":[],"mappings":";;AAIO,MAAM,gBAAA,GAAmB;AA8DzB,SAAS,eAAe,IAAA,EAAiC;AAC9D,EAAA,OAAO,IAAA,IAAQ,OAAO,IAAA,KAAS,QAAA,IAAY,OAAO,IAAA,CAAK,IAAA,KAAS,QAAA,IAAY,IAAA,CAAK,IAAA,CAAK,UAAA,CAAW,gBAAgB,CAAA;AACnH;;;;;"}

package/dist/esm/controller.js

@@ -0,0 +1,376 @@
+import { PostMessageTransport } from './transport/PostMessageTransport.js';
+import { isSmoreMessage } from './transport/protocol.js';
+
+const SYSTEM_PREFIX = "smore:";
+const SYSTEM_EVENTS = {
+  PLAYER_JOIN: `${SYSTEM_PREFIX}player-join`,
+  PLAYER_LEAVE: `${SYSTEM_PREFIX}player-leave`
+};
+const DEFAULT_TIMEOUT = 1e4;
+class SmoreSDKError extends Error {
+  code;
+  cause;
+  details;
+  constructor(code, message, options) {
+    super(message);
+    this.name = "SmoreSDKError";
+    this.code = code;
+    this.cause = options?.cause;
+    this.details = options?.details;
+    const ErrorWithCapture = Error;
+    if (typeof ErrorWithCapture.captureStackTrace === "function") {
+      ErrorWithCapture.captureStackTrace(this, SmoreSDKError);
+    }
+  }
+  toSmoreError() {
+    return {
+      code: this.code,
+      message: this.message,
+      cause: this.cause,
+      details: this.details
+    };
+  }
+}
+const EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z0-9_-]*[a-zA-Z0-9])?$/;
+function validateEventName(event) {
+  if (!event || typeof event !== "string") {
+    throw new SmoreSDKError("INVALID_EVENT", "Event name must be a non-empty string");
+  }
+  if (!EVENT_NAME_REGEX.test(event)) {
+    throw new SmoreSDKError(
+      "INVALID_EVENT",
+      `Invalid event name "${event}". Event names must:
+  - Start with a letter (a-z, A-Z)
+  - Only contain letters, numbers, hyphens (-), and underscores (_)
+  - End with a letter or number`,
+      { details: { event } }
+    );
+  }
+}
+function createLogger(options) {
+  const enabled = typeof options === "boolean" ? options : options?.enabled ?? false;
+  const level = (typeof options === "object" ? options.level : void 0) ?? "debug";
+  const prefix = (typeof options === "object" ? options.prefix : void 0) ?? "[SmoreController]";
+  const customLogger = typeof options === "object" ? options.logger : void 0;
+  const levelPriority = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3
+  };
+  const shouldLog = (msgLevel) => {
+    if (!enabled) return false;
+    return levelPriority[msgLevel] >= levelPriority[level];
+  };
+  const log = (msgLevel, message, data) => {
+    if (!shouldLog(msgLevel)) return;
+    if (customLogger) {
+      customLogger(msgLevel, message, data);
+      return;
+    }
+    const fullMessage = `${prefix} ${message}`;
+    const consoleFn = console[msgLevel] ?? console.log;
+    if (data !== void 0) {
+      consoleFn(fullMessage, data);
+    } else {
+      consoleFn(fullMessage);
+    }
+  };
+  return {
+    debug: (msg, data) => log("debug", msg, data),
+    info: (msg, data) => log("info", msg, data),
+    warn: (msg, data) => log("warn", msg, data),
+    error: (msg, data) => log("error", msg, data)
+  };
+}
+class ControllerImpl {
+  transport = null;
+  config;
+  logger;
+  _roomCode = "";
+  _myIndex = -1;
+  _isLeader = false;
+  _isReady = false;
+  _isDestroyed = false;
+  boundMessageHandler = null;
+  registeredHandlers = [];
+  eventListeners = /* @__PURE__ */ new Map();
+  constructor(config = {}) {
+    this.config = config;
+    this.logger = createLogger(config.debug);
+    if (config.listeners) {
+      for (const event of Object.keys(config.listeners)) {
+        validateEventName(event);
+      }
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Properties (readonly)
+  // ---------------------------------------------------------------------------
+  get myIndex() {
+    return this._myIndex;
+  }
+  get isLeader() {
+    return this._isLeader;
+  }
+  get roomCode() {
+    return this._roomCode;
+  }
+  get isReady() {
+    return this._isReady;
+  }
+  get isDestroyed() {
+    return this._isDestroyed;
+  }
+  // ---------------------------------------------------------------------------
+  // Initialization
+  // ---------------------------------------------------------------------------
+  async initialize() {
+    const parentOrigin = this.config.parentOrigin ?? "*";
+    const timeout = this.config.timeout ?? DEFAULT_TIMEOUT;
+    this.logger.debug("Initializing controller...", { parentOrigin, timeout });
+    return new Promise((resolve, reject) => {
+      const timeoutId = setTimeout(() => {
+        this.cleanup();
+        const error = new SmoreSDKError(
+          "TIMEOUT",
+          `Controller initialization timed out after ${timeout}ms. Make sure the parent window sends smore:init message.`,
+          { details: { timeout } }
+        );
+        this.handleError(error);
+        reject(error);
+      }, timeout);
+      this.boundMessageHandler = (e) => {
+        if (parentOrigin !== "*" && e.origin !== parentOrigin) return;
+        const msg = e.data;
+        if (!isSmoreMessage(msg)) return;
+        if (msg.type === "smore:init") {
+          clearTimeout(timeoutId);
+          this.handleInit(msg, parentOrigin, resolve, reject);
+        } else if (msg.type === "smore:update") {
+          this.handleUpdate(msg);
+        }
+      };
+      window.addEventListener("message", this.boundMessageHandler);
+      this.logger.debug("Sending smore:ready to parent");
+      window.parent.postMessage({ type: "smore:ready" }, parentOrigin);
+    });
+  }
+  handleInit(msg, parentOrigin, resolve, reject) {
+    const initData = msg.payload;
+    this.logger.debug("Received smore:init", initData);
+    if (initData.side !== "player") {
+      const error = new SmoreSDKError(
+        "INIT_FAILED",
+        `Controller received init for wrong side: ${initData.side}`,
+        { details: { side: initData.side } }
+      );
+      this.handleError(error);
+      reject(error);
+      return;
+    }
+    if (initData.myIndex === void 0) {
+      const error = new SmoreSDKError(
+        "INIT_FAILED",
+        "Missing myIndex in init payload",
+        { details: initData }
+      );
+      this.handleError(error);
+      reject(error);
+      return;
+    }
+    this.transport = new PostMessageTransport(parentOrigin);
+    this._roomCode = initData.roomCode;
+    this._myIndex = initData.myIndex;
+    this._isLeader = initData.isLeader ?? false;
+    this.setupEventHandlers();
+    this._isReady = true;
+    this.logger.info("Controller ready", {
+      roomCode: this._roomCode,
+      myIndex: this._myIndex,
+      isLeader: this._isLeader
+    });
+    this.config.onReady?.();
+    resolve();
+  }
+  handleUpdate(msg) {
+    const updateData = msg.payload;
+    this.logger.debug("Received smore:update", updateData);
+  }
+  setupEventHandlers() {
+    if (!this.transport) return;
+    this.registerHandler(
+      SYSTEM_EVENTS.PLAYER_JOIN,
+      (data) => {
+        const playerIndex = data.player?.playerIndex ?? data.playerIndex;
+        if (playerIndex !== void 0) {
+          this.logger.debug("Player joined", { playerIndex });
+          this.config.onControllerJoin?.(playerIndex, data.player);
+        }
+      }
+    );
+    this.registerHandler(
+      SYSTEM_EVENTS.PLAYER_LEAVE,
+      (data) => {
+        const playerIndex = data.player?.playerIndex ?? data.playerIndex;
+        if (playerIndex !== void 0) {
+          this.logger.debug("Player left", { playerIndex });
+          this.config.onControllerLeave?.(playerIndex);
+        }
+      }
+    );
+    if (this.config.listeners) {
+      for (const [event, handler] of Object.entries(this.config.listeners)) {
+        if (!handler) continue;
+        this.registerHandler(event, (data) => {
+          this.logReceive(event, data);
+          handler(data);
+        });
+      }
+    }
+  }
+  registerHandler(event, handler) {
+    if (!this.transport) return;
+    this.transport.on(event, handler);
+    this.registeredHandlers.push({ event, handler });
+  }
+  // ---------------------------------------------------------------------------
+  // Communication Methods
+  // ---------------------------------------------------------------------------
+  send(event, data) {
+    this.ensureReady("send");
+    validateEventName(event);
+    this.logSend(event, data);
+    this.transport.emit(event, data);
+  }
+  sendRaw(event, data) {
+    this.ensureReady("sendRaw");
+    validateEventName(event);
+    this.logSend(event, data);
+    this.transport.emit(event, data);
+  }
+  // ---------------------------------------------------------------------------
+  // Event Subscription
+  // ---------------------------------------------------------------------------
+  on(event, handler) {
+    validateEventName(event);
+    let listeners = this.eventListeners.get(event);
+    if (!listeners) {
+      listeners = /* @__PURE__ */ new Set();
+      this.eventListeners.set(event, listeners);
+    }
+    listeners.add(handler);
+    const transportHandler = (data) => {
+      this.logReceive(event, data);
+      handler(data);
+    };
+    if (this.transport) {
+      this.transport.on(event, transportHandler);
+      this.registeredHandlers.push({ event, handler: transportHandler });
+    }
+    return () => {
+      listeners?.delete(handler);
+      if (listeners?.size === 0) {
+        this.eventListeners.delete(event);
+      }
+      this.transport?.off(event, transportHandler);
+      this.registeredHandlers = this.registeredHandlers.filter(
+        (h) => h.handler !== transportHandler
+      );
+    };
+  }
+  once(event, handler) {
+    const unsubscribe = this.on(event, ((data) => {
+      unsubscribe();
+      handler(data);
+    }));
+    return unsubscribe;
+  }
+  off(event, handler) {
+    if (!handler) {
+      this.eventListeners.delete(event);
+      this.transport?.off(event);
+      this.registeredHandlers = this.registeredHandlers.filter((h) => h.event !== event);
+    } else {
+      const listeners = this.eventListeners.get(event);
+      listeners?.delete(handler);
+      if (listeners?.size === 0) {
+        this.eventListeners.delete(event);
+      }
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Cleanup
+  // ---------------------------------------------------------------------------
+  destroy() {
+    if (this._isDestroyed) return;
+    this.logger.info("Destroying controller");
+    this.cleanup();
+    this._isDestroyed = true;
+  }
+  cleanup() {
+    this._isReady = false;
+    for (const { event, handler } of this.registeredHandlers) {
+      this.transport?.off(event, handler);
+    }
+    this.registeredHandlers = [];
+    this.eventListeners.clear();
+    if (this.transport) {
+      this.transport.destroy();
+      this.transport = null;
+    }
+    if (this.boundMessageHandler) {
+      window.removeEventListener("message", this.boundMessageHandler);
+      this.boundMessageHandler = null;
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Private Helpers
+  // ---------------------------------------------------------------------------
+  ensureReady(method) {
+    if (this._isDestroyed) {
+      throw new SmoreSDKError(
+        "DESTROYED",
+        `Cannot call ${method}() after destroy()`,
+        { details: { method } }
+      );
+    }
+    if (!this._isReady || !this.transport) {
+      throw new SmoreSDKError(
+        "NOT_READY",
+        `Cannot call ${method}() before controller is ready. Use await createController() or wait for onReady callback.`,
+        { details: { method, isReady: this._isReady } }
+      );
+    }
+  }
+  handleError(error) {
+    if (this.config.onError) {
+      this.config.onError(error.toSmoreError());
+    } else {
+      this.logger.error(error.message, error.details);
+    }
+  }
+  logSend(event, data) {
+    const options = this.config.debug;
+    const shouldLog = typeof options === "object" ? options.logSend ?? true : Boolean(options);
+    if (shouldLog) {
+      this.logger.debug(`\u2192 SEND [${event}]`, data);
+    }
+  }
+  logReceive(event, data) {
+    const options = this.config.debug;
+    const shouldLog = typeof options === "object" ? options.logReceive ?? true : Boolean(options);
+    if (shouldLog) {
+      this.logger.debug(`\u2190 RECV [${event}]`, data);
+    }
+  }
+}
+function createController(config) {
+  const controller = new ControllerImpl(config ?? {});
+  const promise = controller.initialize().then(() => controller);
+  promise.instance = controller;
+  return promise;
+}
+
+export { SmoreSDKError, createController };
+//# sourceMappingURL=controller.js.map