@smoregg/sdk 0.5.0 → 0.6.1

package/dist/esm/controller.js.map

@@ -0,0 +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  DebugOptions,\n  EventData,\n  EventMap,\n  EventNames,\n  LogLevel,\n  PlayerIndex,\n  RoomCode,\n  SmoreError,\n  SmoreErrorCode,\n} from './types';\nimport { PostMessageTransport } from './transport/PostMessageTransport';\nimport type { TransportEventHandler } from './transport/types';\nimport {\n  isSmoreMessage,\n  type SmoreInitMessage,\n  type SmoreUpdateMessage,\n} from './transport/protocol';\n\n// =============================================================================\n// CONSTANTS\n// =============================================================================\n\nconst SYSTEM_PREFIX = 'smore:';\n\nconst SYSTEM_EVENTS = {\n  READY: `${SYSTEM_PREFIX}ready`,\n  PLAYER_JOIN: `${SYSTEM_PREFIX}player-join`,\n  PLAYER_LEAVE: `${SYSTEM_PREFIX}player-leave`,\n} as const;\n\nconst DEFAULT_TIMEOUT = 10000;\n\n// =============================================================================\n// ERROR CLASS\n// =============================================================================\n\n/**\n * Custom error class for SDK errors.\n */\nexport class SmoreSDKError extends Error {\n  readonly code: SmoreErrorCode;\n  readonly cause?: Error;\n  readonly details?: Record<string, unknown>;\n\n  constructor(\n    code: SmoreErrorCode,\n    message: string,\n    options?: {\n      cause?: Error;\n      details?: Record<string, unknown>;\n    },\n  ) {\n    super(message);\n    this.name = 'SmoreSDKError';\n    this.code = code;\n    this.cause = options?.cause;\n    this.details = options?.details;\n\n    // Maintain proper stack trace in V8 engines\n    const ErrorWithCapture = Error as typeof Error & {\n      captureStackTrace?: (target: object, constructor?: Function) => void;\n    };\n    if (typeof ErrorWithCapture.captureStackTrace === 'function') {\n      ErrorWithCapture.captureStackTrace(this, SmoreSDKError);\n    }\n  }\n\n  toSmoreError(): SmoreError {\n    return {\n      code: this.code,\n      message: this.message,\n      cause: this.cause,\n      details: this.details,\n    };\n  }\n}\n\n// =============================================================================\n// VALIDATION\n// =============================================================================\n\nconst EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z0-9_-]*[a-zA-Z0-9])?$/;\n\nfunction 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_NAME_REGEX.test(event)) {\n    throw new SmoreSDKError(\n      'INVALID_EVENT',\n      `Invalid event name \"${event}\". Event names must:\\n` +\n        `  - Start with a letter (a-z, A-Z)\\n` +\n        `  - Only contain letters, numbers, hyphens (-), and underscores (_)\\n` +\n        `  - End with a letter or number`,\n      { details: { event } },\n    );\n  }\n}\n\n// =============================================================================\n// DEBUG LOGGER\n// =============================================================================\n\ninterface Logger {\n  debug(message: string, data?: unknown): void;\n  info(message: string, data?: unknown): void;\n  warn(message: string, data?: unknown): void;\n  error(message: string, data?: unknown): void;\n}\n\nfunction createLogger(options: boolean | DebugOptions | undefined): Logger {\n  const enabled = typeof options === 'boolean' ? options : options?.enabled ?? false;\n  const level = (typeof options === 'object' ? options.level : undefined) ?? 'debug';\n  const prefix = (typeof options === 'object' ? options.prefix : undefined) ?? '[SmoreController]';\n  const customLogger = typeof options === 'object' ? options.logger : undefined;\n\n  const levelPriority: Record<LogLevel, number> = {\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n  };\n\n  const shouldLog = (msgLevel: LogLevel): boolean => {\n    if (!enabled) return false;\n    return levelPriority[msgLevel] >= levelPriority[level];\n  };\n\n  const log = (msgLevel: LogLevel, message: string, data?: unknown): void => {\n    if (!shouldLog(msgLevel)) return;\n\n    if (customLogger) {\n      customLogger(msgLevel, message, data);\n      return;\n    }\n\n    const fullMessage = `${prefix} ${message}`;\n    const consoleFn = console[msgLevel] ?? console.log;\n\n    if (data !== undefined) {\n      consoleFn(fullMessage, data);\n    } else {\n      consoleFn(fullMessage);\n    }\n  };\n\n  return {\n    debug: (msg, data) => log('debug', msg, data),\n    info: (msg, data) => log('info', msg, data),\n    warn: (msg, data) => log('warn', msg, data),\n    error: (msg, data) => log('error', msg, data),\n  };\n}\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: Logger;\n  private _roomCode: RoomCode = '';\n  private _myIndex: PlayerIndex = -1;\n  private _isLeader: boolean = false;\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\n  constructor(config: ControllerConfig<TEvents> = {}) {\n    this.config = config;\n    this.logger = createLogger(config.debug);\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 isLeader(): boolean {\n    return this._isLeader;\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  // 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.debug('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 smore:init message.`,\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 (!isSmoreMessage(msg)) return;\n\n        if (msg.type === 'smore:init') {\n          clearTimeout(timeoutId);\n          this.handleInit(msg as SmoreInitMessage, parentOrigin, resolve, reject);\n        } else if (msg.type === 'smore:update') {\n          this.handleUpdate(msg as SmoreUpdateMessage);\n        }\n      };\n\n      window.addEventListener('message', this.boundMessageHandler);\n\n      // Signal ready to parent\n      this.logger.debug('Sending smore:ready to parent');\n      window.parent.postMessage({ type: 'smore:ready' }, parentOrigin);\n    });\n  }\n\n  private handleInit(\n    msg: SmoreInitMessage,\n    parentOrigin: string,\n    resolve: () => void,\n    reject: (err: Error) => void,\n  ): void {\n    const initData = msg.payload;\n\n    this.logger.debug('Received smore:init', initData);\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    this._isLeader = initData.isLeader ?? false;\n\n    this.setupEventHandlers();\n\n    this._isReady = true;\n    this.logger.info('Controller ready', {\n      roomCode: this._roomCode,\n      myIndex: this._myIndex,\n      isLeader: this._isLeader,\n    });\n\n    this.config.onReady?.();\n    resolve();\n  }\n\n  private handleUpdate(msg: SmoreUpdateMessage): void {\n    const updateData = msg.payload;\n    this.logger.debug('Received smore:update', updateData);\n\n    // Future: handle leader changes, player list updates, etc.\n  }\n\n  private setupEventHandlers(): void {\n    if (!this.transport) return;\n\n    // System events: player join/leave\n    this.registerHandler(\n      SYSTEM_EVENTS.PLAYER_JOIN,\n      (data: { player?: ControllerInfo; playerIndex?: number }) => {\n        const playerIndex = data.player?.playerIndex ?? data.playerIndex;\n        if (playerIndex !== undefined) {\n          this.logger.debug('Player joined', { playerIndex });\n          this.config.onControllerJoin?.(playerIndex, data.player as ControllerInfo);\n        }\n      },\n    );\n\n    this.registerHandler(\n      SYSTEM_EVENTS.PLAYER_LEAVE,\n      (data: { player?: { playerIndex?: number }; playerIndex?: number }) => {\n        const playerIndex = data.player?.playerIndex ?? data.playerIndex;\n        if (playerIndex !== undefined) {\n          this.logger.debug('Player left', { playerIndex });\n          this.config.onControllerLeave?.(playerIndex);\n        }\n      },\n    );\n\n    // User event listeners from config\n    if (this.config.listeners) {\n      for (const [event, handler] of Object.entries(this.config.listeners)) {\n        if (!handler) continue;\n\n        this.registerHandler(event, (data: unknown) => {\n          this.logReceive(event, data);\n          (handler as ControllerEventHandler<unknown>)(data);\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  send<K extends EventNames<TEvents>>(event: K, data: EventData<TEvents, K>): void {\n    this.ensureReady('send');\n    validateEventName(event);\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  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      (handler as ControllerEventHandler<unknown>)(data);\n    };\n\n    if (this.transport) {\n      this.transport.on(event, transportHandler);\n      this.registeredHandlers.push({ event, handler: 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    };\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 listeners for this event\n      this.eventListeners.delete(event);\n      this.transport?.off(event);\n      this.registeredHandlers = this.registeredHandlers.filter((h) => h.event !== event);\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      // Note: Can't easily remove specific handler from transport without tracking\n      // This is a limitation of the current transport interface\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Cleanup\n  // ---------------------------------------------------------------------------\n\n  destroy(): void {\n    if (this._isDestroyed) return;\n\n    this.logger.info('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\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    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    const options = this.config.debug;\n    const shouldLog =\n      typeof options === 'object' ? (options.logSend ?? true) : Boolean(options);\n    if (shouldLog) {\n      this.logger.debug(`→ SEND [${event}]`, data);\n    }\n  }\n\n  private logReceive(event: string, data?: unknown): void {\n    const options = this.config.debug;\n    const shouldLog =\n      typeof options === 'object' ? (options.logReceive ?? true) : Boolean(options);\n    if (shouldLog) {\n      this.logger.debug(`← RECV [${event}]`, data);\n    }\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/index.js

@@ -1,6 +1,7 @@
-export { SmoreHost } from './SmoreHost.js';
-export { SmorePlayer } from './SmorePlayer.js';
+export { SmoreSDKError, createScreen } from './screen.js';
+export { createController } from './controller.js';
 export { DirectTransport } from './transport/DirectTransport.js';
 export { PostMessageTransport } from './transport/PostMessageTransport.js';
 export { SMORE_EVENTS, isSystemEvent, validateUserEvent } from './events.js';
+export { createMockController, createMockScreen } from './testing.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/dist/esm/screen.js

@@ -0,0 +1,523 @@
+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`,
+  PLAYER_RECONNECT: `${SYSTEM_PREFIX}player-reconnect`,
+  GAME_OVER: `${SYSTEM_PREFIX}game-over`
+};
+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, contain only letters, numbers, hyphens, or underscores, and end with a letter or number.`,
+      { details: { event } }
+    );
+  }
+}
+function validatePlayerIndex(playerIndex, controllersCount) {
+  if (typeof playerIndex !== "number" || !Number.isInteger(playerIndex)) {
+    throw new SmoreSDKError("INVALID_PLAYER", "Player index must be an integer");
+  }
+  if (playerIndex < 0 || playerIndex >= controllersCount) {
+    throw new SmoreSDKError(
+      "INVALID_PLAYER",
+      `Invalid player index ${playerIndex}. Valid range: 0-${controllersCount - 1}`,
+      { details: { playerIndex, controllersCount } }
+    );
+  }
+}
+class DebugLogger {
+  enabled;
+  level;
+  prefix;
+  logSend;
+  logReceive;
+  logLifecycle;
+  customLogger;
+  static levelOrder = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3
+  };
+  constructor(options) {
+    if (typeof options === "boolean") {
+      this.enabled = options;
+      this.level = "debug";
+      this.prefix = "[SmoreScreen]";
+      this.logSend = true;
+      this.logReceive = true;
+      this.logLifecycle = true;
+    } else if (options) {
+      this.enabled = options.enabled ?? false;
+      this.level = options.level ?? "debug";
+      this.prefix = options.prefix ?? "[SmoreScreen]";
+      this.logSend = options.logSend ?? true;
+      this.logReceive = options.logReceive ?? true;
+      this.logLifecycle = options.logLifecycle ?? true;
+      this.customLogger = options.logger;
+    } else {
+      this.enabled = false;
+      this.level = "debug";
+      this.prefix = "[SmoreScreen]";
+      this.logSend = true;
+      this.logReceive = true;
+      this.logLifecycle = true;
+    }
+  }
+  shouldLog(level) {
+    return this.enabled && DebugLogger.levelOrder[level] >= DebugLogger.levelOrder[this.level];
+  }
+  log(level, message, data) {
+    if (!this.shouldLog(level)) return;
+    if (this.customLogger) {
+      this.customLogger(level, `${this.prefix} ${message}`, data);
+      return;
+    }
+    const consoleMethod = level === "error" ? "error" : level === "warn" ? "warn" : "log";
+    if (data !== void 0) {
+      console[consoleMethod](`${this.prefix} ${message}`, data);
+    } else {
+      console[consoleMethod](`${this.prefix} ${message}`);
+    }
+  }
+  debug(message, data) {
+    this.log("debug", message, data);
+  }
+  info(message, data) {
+    this.log("info", message, data);
+  }
+  warn(message, data) {
+    this.log("warn", message, data);
+  }
+  error(message, data) {
+    this.log("error", message, data);
+  }
+  send(event, data) {
+    if (this.logSend) {
+      this.debug(`-> SEND: ${event}`, data);
+    }
+  }
+  receive(event, data) {
+    if (this.logReceive) {
+      this.debug(`<- RECV: ${event}`, data);
+    }
+  }
+  lifecycle(message, data) {
+    if (this.logLifecycle) {
+      this.info(`[Lifecycle] ${message}`, data);
+    }
+  }
+}
+class ScreenImpl {
+  transport = null;
+  config;
+  logger;
+  _controllers = [];
+  _roomCode = "";
+  _leaderIndex = -1;
+  _isReady = false;
+  _isDestroyed = false;
+  eventHandlers = /* @__PURE__ */ new Map();
+  registeredTransportHandlers = [];
+  boundMessageHandler = null;
+  constructor(config = {}) {
+    this.config = config;
+    this.logger = new DebugLogger(config.debug);
+    if (config.listeners) {
+      for (const event of Object.keys(config.listeners)) {
+        validateEventName(event);
+      }
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Initialization (called by factory)
+  // ---------------------------------------------------------------------------
+  async initialize() {
+    this.logger.lifecycle("Initializing screen...");
+    const parentOrigin = this.config.parentOrigin ?? "*";
+    const timeout = this.config.timeout ?? DEFAULT_TIMEOUT;
+    return new Promise((resolve, reject) => {
+      const timeoutId = setTimeout(() => {
+        this.cleanup();
+        const error = new SmoreSDKError(
+          "TIMEOUT",
+          `Screen initialization timed out after ${timeout}ms. Make sure the parent frame sends smore:init.`,
+          { 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);
+          const initData = msg.payload;
+          if (initData.side !== "host") {
+            const error = new SmoreSDKError(
+              "INIT_FAILED",
+              `Received init for wrong side: ${initData.side}. Expected "host".`,
+              { details: { side: initData.side } }
+            );
+            this.handleError(error);
+            reject(error);
+            return;
+          }
+          this.transport = new PostMessageTransport(parentOrigin);
+          this._roomCode = initData.roomCode;
+          this._controllers = this.mapControllersFromInit(initData.players);
+          this._leaderIndex = this.findLeaderIndex(initData.players, initData.leaderId);
+          this.setupEventHandlers();
+          this._isReady = true;
+          this.logger.lifecycle("Screen ready", {
+            roomCode: this._roomCode,
+            controllers: this._controllers.length,
+            leaderIndex: this._leaderIndex
+          });
+          this.config.onReady?.();
+          resolve();
+        } else if (msg.type === "smore:update") {
+          const updateData = msg.payload;
+          if (updateData.players) {
+            this._controllers = this.mapControllersFromInit(updateData.players);
+          }
+          if (updateData.leaderId !== void 0) {
+            this._leaderIndex = this.findLeaderIndex(
+              updateData.players ?? [],
+              updateData.leaderId
+            );
+          }
+          this.logger.lifecycle("Room updated", {
+            controllers: this._controllers.length,
+            leaderIndex: this._leaderIndex
+          });
+        }
+      };
+      window.addEventListener("message", this.boundMessageHandler);
+      window.parent.postMessage({ type: "smore:ready" }, parentOrigin);
+      this.logger.lifecycle("Sent smore:ready to parent");
+    });
+  }
+  mapControllersFromInit(players) {
+    return players.map((p, index) => ({
+      playerIndex: p.playerIndex ?? index,
+      nickname: p.nickname || `Player ${index + 1}`,
+      connected: p.connected !== false,
+      appearance: p.appearance
+    }));
+  }
+  findLeaderIndex(players, leaderId) {
+    if (!leaderId) return -1;
+    const idx = players.findIndex(
+      (p) => p.sessionId === leaderId
+    );
+    return idx >= 0 ? idx : -1;
+  }
+  setupEventHandlers() {
+    if (!this.transport) return;
+    this.registerTransportHandler(SYSTEM_EVENTS.PLAYER_JOIN, (data) => {
+      const payload = data;
+      const player = payload?.player;
+      if (player && typeof player.playerIndex === "number") {
+        this.logger.lifecycle("Controller joined", { playerIndex: player.playerIndex });
+        this.config.onControllerJoin?.(player.playerIndex, player);
+      }
+    });
+    this.registerTransportHandler(SYSTEM_EVENTS.PLAYER_LEAVE, (data) => {
+      const payload = data;
+      if (typeof payload?.playerIndex === "number") {
+        this.logger.lifecycle("Controller left", { playerIndex: payload.playerIndex });
+        this.config.onControllerLeave?.(payload.playerIndex);
+      }
+    });
+    this.registerTransportHandler(SYSTEM_EVENTS.PLAYER_RECONNECT, (data) => {
+      const payload = data;
+      const player = payload?.player;
+      if (player && typeof player.playerIndex === "number") {
+        this.logger.lifecycle("Controller reconnected", { playerIndex: player.playerIndex });
+        this.config.onControllerReconnect?.(player.playerIndex, player);
+      }
+    });
+    this.registerTransportHandler("room:player-joined", (data) => {
+      const payload = data;
+      const playerIndex = payload?.player?.playerIndex ?? payload?.playerIndex;
+      if (typeof playerIndex === "number") {
+        this.config.onControllerJoin?.(playerIndex, {
+          playerIndex,
+          nickname: `Player ${playerIndex + 1}`,
+          connected: true
+        });
+      }
+    });
+    this.registerTransportHandler("room:player-left", (data) => {
+      const payload = data;
+      const playerIndex = payload?.playerIndex ?? payload?.player?.playerIndex;
+      if (typeof playerIndex === "number") {
+        this.config.onControllerLeave?.(playerIndex);
+      }
+    });
+    if (this.config.listeners) {
+      for (const [event, handler] of Object.entries(this.config.listeners)) {
+        if (!handler) continue;
+        this.setupUserEventHandler(event, handler);
+      }
+    }
+  }
+  setupUserEventHandler(event, handler) {
+    const wrappedHandler = (data) => {
+      this.logger.receive(event, data);
+      const payload = data;
+      const { playerIndex, ...rest } = payload;
+      if (typeof playerIndex === "number") {
+        try {
+          handler(playerIndex, rest);
+        } catch (err) {
+          this.handleError(
+            new SmoreSDKError("UNKNOWN", `Error in handler for event "${event}"`, {
+              cause: err instanceof Error ? err : void 0,
+              details: { event, playerIndex }
+            })
+          );
+        }
+      }
+    };
+    this.registerTransportHandler(event, wrappedHandler);
+    let handlers = this.eventHandlers.get(event);
+    if (!handlers) {
+      handlers = /* @__PURE__ */ new Set();
+      this.eventHandlers.set(event, handlers);
+    }
+    handlers.add(handler);
+  }
+  registerTransportHandler(event, handler) {
+    if (!this.transport) return;
+    this.transport.on(event, handler);
+    this.registeredTransportHandlers.push({ event, handler });
+  }
+  // ---------------------------------------------------------------------------
+  // Properties (readonly)
+  // ---------------------------------------------------------------------------
+  get controllers() {
+    return [...this._controllers];
+  }
+  get roomCode() {
+    return this._roomCode;
+  }
+  get leaderIndex() {
+    return this._leaderIndex;
+  }
+  get isReady() {
+    return this._isReady;
+  }
+  get isDestroyed() {
+    return this._isDestroyed;
+  }
+  // ---------------------------------------------------------------------------
+  // Communication Methods
+  // ---------------------------------------------------------------------------
+  broadcast(event, data) {
+    this.ensureReady("broadcast");
+    validateEventName(event);
+    this.logger.send(event, data);
+    this.transport.emit(event, data);
+  }
+  broadcastRaw(event, data) {
+    this.ensureReady("broadcastRaw");
+    validateEventName(event);
+    this.logger.send(event, data);
+    this.transport.emit(event, data);
+  }
+  sendToController(playerIndex, event, data) {
+    this.ensureReady("sendToController");
+    validateEventName(event);
+    validatePlayerIndex(playerIndex, this._controllers.length);
+    this.logger.send(`${event} -> Player ${playerIndex}`, data);
+    this.transport.emit(event, {
+      targetPlayerIndex: playerIndex,
+      ...data && typeof data === "object" ? data : { data }
+    });
+  }
+  sendToControllerRaw(playerIndex, event, data) {
+    this.ensureReady("sendToControllerRaw");
+    validateEventName(event);
+    validatePlayerIndex(playerIndex, this._controllers.length);
+    this.logger.send(`${event} -> Player ${playerIndex}`, data);
+    this.transport.emit(event, {
+      targetPlayerIndex: playerIndex,
+      ...data && typeof data === "object" ? data : { data }
+    });
+  }
+  // ---------------------------------------------------------------------------
+  // Game Lifecycle
+  // ---------------------------------------------------------------------------
+  gameOver(results) {
+    this.ensureReady("gameOver");
+    this.logger.lifecycle("Game over", results);
+    this.transport.emit(SYSTEM_EVENTS.GAME_OVER, { results });
+  }
+  // ---------------------------------------------------------------------------
+  // Event Subscription
+  // ---------------------------------------------------------------------------
+  on(event, handler) {
+    validateEventName(event);
+    let handlers = this.eventHandlers.get(event);
+    if (!handlers) {
+      handlers = /* @__PURE__ */ new Set();
+      this.eventHandlers.set(event, handlers);
+    }
+    handlers.add(handler);
+    if (this.transport) {
+      const wrappedHandler = (data) => {
+        this.logger.receive(event, data);
+        const payload = data;
+        const { playerIndex, ...rest } = payload;
+        if (typeof playerIndex === "number") {
+          try {
+            handler(playerIndex, rest);
+          } catch (err) {
+            this.handleError(
+              new SmoreSDKError("UNKNOWN", `Error in handler for event "${event}"`, {
+                cause: err instanceof Error ? err : void 0
+              })
+            );
+          }
+        }
+      };
+      this.registerTransportHandler(event, wrappedHandler);
+    }
+    return () => {
+      handlers?.delete(handler);
+      if (handlers?.size === 0) {
+        this.eventHandlers.delete(event);
+      }
+    };
+  }
+  once(event, handler) {
+    const wrappedHandler = (playerIndex, data) => {
+      unsubscribe();
+      handler(playerIndex, data);
+    };
+    const unsubscribe = this.on(event, wrappedHandler);
+    return unsubscribe;
+  }
+  off(event, handler) {
+    if (!handler) {
+      this.eventHandlers.delete(event);
+      this.transport?.off(event);
+    } else {
+      const handlers = this.eventHandlers.get(event);
+      handlers?.delete(handler);
+      if (handlers?.size === 0) {
+        this.eventHandlers.delete(event);
+      }
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Utilities
+  // ---------------------------------------------------------------------------
+  getController(playerIndex) {
+    return this._controllers.find((c) => c.playerIndex === playerIndex);
+  }
+  isLeader(playerIndex) {
+    return playerIndex === this._leaderIndex;
+  }
+  getControllerCount() {
+    return this._controllers.filter((c) => c.connected).length;
+  }
+  // ---------------------------------------------------------------------------
+  // Cleanup
+  // ---------------------------------------------------------------------------
+  destroy() {
+    if (this._isDestroyed) return;
+    this.logger.lifecycle("Destroying screen...");
+    this._isDestroyed = true;
+    this._isReady = false;
+    this.cleanup();
+    this.logger.lifecycle("Screen destroyed");
+  }
+  cleanup() {
+    for (const { event, handler } of this.registeredTransportHandlers) {
+      this.transport?.off(event, handler);
+    }
+    this.registeredTransportHandlers = [];
+    this.eventHandlers.clear();
+    if (this.transport instanceof PostMessageTransport) {
+      this.transport.destroy();
+    }
+    this.transport = null;
+    if (this.boundMessageHandler) {
+      window.removeEventListener("message", this.boundMessageHandler);
+      this.boundMessageHandler = null;
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Error Handling
+  // ---------------------------------------------------------------------------
+  handleError(error) {
+    const smoreError = error.toSmoreError();
+    if (this.config.onError) {
+      this.config.onError(smoreError);
+    } else {
+      this.logger.error(error.message, error.details);
+    }
+  }
+  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 screen is ready. Use await createScreen() or onReady callback.`,
+        { details: { method } }
+      );
+    }
+  }
+}
+function createScreen(config) {
+  const screen = new ScreenImpl(config);
+  const promise = screen.initialize().then(() => screen);
+  promise.instance = screen;
+  return promise;
+}
+
+export { SmoreSDKError, createScreen };
+//# sourceMappingURL=screen.js.map