@dreamboard-games/sdk 0.2.0 → 0.2.1-alpha.1

package/dist/{chunk-7YAHLYBR.js → chunk-XV6D3ET4.js}

@@ -1,11 +1,12 @@
 import {
   InteractionUiProvider,
   RuntimeProvider,
+  RuntimeSemanticProjectionMarker,
   usePluginSession
-} from "./chunk-TDSWKVZ4.js";
+} from "./chunk-ZABVH7AO.js";
 import {
   GameSkeleton
-} from "./chunk-WYPQ3GG5.js";
+} from "./chunk-WG4JQL3S.js";
 
 // src/runtime-internal/hooks/usePluginRuntime.ts
 import { useState, useEffect, useRef } from "react";
@@ -472,10 +473,13 @@ function SessionScopedInteractionUiProvider({
   children
 }) {
   const { controllingPlayerId } = usePluginSession();
-  return /* @__PURE__ */ jsx(InteractionUiProvider, { children }, controllingPlayerId ?? "__no_player__");
+  return /* @__PURE__ */ jsxs(InteractionUiProvider, { children: [
+    /* @__PURE__ */ jsx(RuntimeSemanticProjectionMarker, {}),
+    children
+  ] }, controllingPlayerId ?? "__no_player__");
 }
 
 export {
   PluginRuntime
 };
-//# sourceMappingURL=chunk-7YAHLYBR.js.map
+//# sourceMappingURL=chunk-XV6D3ET4.js.map

package/dist/{chunk-7YAHLYBR.js.map → chunk-XV6D3ET4.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/runtime-internal/hooks/usePluginRuntime.ts","../src/runtime-internal/runtime/createPluginRuntimeAPI.ts","../src/runtime-internal/components/PluginRuntime.tsx"],"sourcesContent":["import { useState, useEffect, useRef } from \"react\";\nimport {\n  createPluginRuntimeAPI,\n  type PluginRuntimeAPI,\n} from \"../runtime/createPluginRuntimeAPI.js\";\n\nexport interface UsePluginRuntimeOptions {\n  /**\n   * Timeout in milliseconds to wait for state-sync.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n}\n\nexport interface UsePluginRuntimeResult {\n  /** The RuntimeAPI instance */\n  runtime: PluginRuntimeAPI;\n  /** Whether the initial reducer-native snapshot is available and ready */\n  isReady: boolean;\n  /**\n   * True when the plugin was ready before but the current snapshot has no\n   * projected view — e.g. you've acted and are waiting on the rest of the\n   * table in a simultaneous phase. Lets the loading affordance read as a\n   * mid-game wait rather than a cold \"still loading\" stall.\n   */\n  waiting: boolean;\n  /** Error message if initialization failed */\n  error: string | null;\n}\n\nfunction hasProjectedView(\n  snapshot: ReturnType<PluginRuntimeAPI[\"getSnapshot\"]> | null | undefined,\n): boolean {\n  return (\n    snapshot !== null &&\n    snapshot !== undefined &&\n    snapshot.view !== null &&\n    snapshot.view !== undefined\n  );\n}\n\n/**\n * Hook that creates and manages a PluginRuntimeAPI instance.\n *\n * This hook handles:\n * 1. Creating the RuntimeAPI\n * 2. Waiting for the first state-sync snapshot before setting isReady\n *\n * In the new architecture, the host only renders the plugin when a reducer-native\n * snapshot is available, so isReady should become true quickly after init.\n *\n * @example\n * ```tsx\n * function PluginRuntime({ children }: { children: React.ReactNode }) {\n *   const { runtime, isReady, error } = usePluginRuntime();\n *\n *   if (error) {\n *     return <div>Error: {error}</div>;\n *   }\n *\n *   if (!isReady) {\n *     return <GameSkeleton message=\"Waiting for game state...\" />;\n *   }\n *\n *   return <RuntimeProvider runtime={runtime}>{children}</RuntimeProvider>;\n * }\n * ```\n */\nexport function usePluginRuntime(\n  options: UsePluginRuntimeOptions = {},\n): UsePluginRuntimeResult {\n  const { timeout = 10000 } = options;\n\n  // Create runtime once and keep stable reference\n  const [runtime] = useState<PluginRuntimeAPI>(() => createPluginRuntimeAPI());\n  const [isReady, setIsReady] = useState(() => {\n    const snapshot = runtime.getSnapshot?.();\n    return hasProjectedView(snapshot);\n  });\n  const [error, setError] = useState<string | null>(null);\n  // Latches once we've shown a view, so a later view-less snapshot reads as a\n  // mid-game wait rather than a fresh load. (A ref, so it never re-triggers a\n  // render on its own.)\n  const hasBeenReadyRef = useRef(false);\n  if (isReady) hasBeenReadyRef.current = true;\n\n  // Subscribe to state-sync and set isReady when the first snapshot arrives.\n  useEffect(() => {\n    const markReadyFromSnapshot = () => {\n      const currentSnapshot = runtime.getSnapshot?.();\n      if (!hasProjectedView(currentSnapshot)) {\n        return false;\n      }\n      setError(null);\n      setIsReady(true);\n      return true;\n    };\n\n    if (markReadyFromSnapshot()) {\n      return;\n    }\n\n    // Set up timeout\n    const timeoutId = setTimeout(() => {\n      if (!markReadyFromSnapshot()) {\n        setError(\n          `Timed out waiting for the initial projected view after ${timeout}ms. ` +\n            \"Ensure the host sends a reducer-native state-sync with a seat view.\",\n        );\n      }\n    }, timeout);\n\n    // Fallback poll for dev/HMR flows where the runtime snapshot may already\n    // exist but the first subscribe callback is missed.\n    const pollId = setInterval(() => {\n      if (markReadyFromSnapshot()) {\n        clearInterval(pollId);\n        clearTimeout(timeoutId);\n      }\n    }, 100);\n\n    // Subscribe to state changes\n    const unsubscribe = runtime.subscribeToState?.((state) => {\n      if (!hasProjectedView(state)) {\n        setIsReady(false);\n        return;\n      }\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      setError(null);\n      setIsReady(true);\n    });\n\n    return () => {\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      unsubscribe?.();\n    };\n  }, [runtime, timeout]);\n\n  return {\n    runtime,\n    isReady,\n    waiting: hasBeenReadyRef.current && !isReady,\n    error,\n  };\n}\n","import { z } from \"zod\";\nimport type { PlayerId } from \"@dreamboard/manifest-contract\";\nimport type {\n  RuntimeAPI,\n  PluginSessionState,\n  ValidationResult,\n} from \"../types/runtime-api.js\";\nimport type { PluginStateSnapshot } from \"../types/plugin-state.js\";\n\n/**\n * Message schemas from main app to plugin\n * We define them here to avoid circular dependencies with apps/web\n */\n\n// Main → Plugin: Initialize plugin with session info\nconst InitMessageSchema = z.object({\n  type: z.literal(\"init\"),\n  sessionId: z.string(),\n  controllablePlayerIds: z.array(z.string()),\n  controllingPlayerId: z.string(),\n  userId: z.string().nullable(),\n});\n\n// Main → Plugin: Health check ping\nconst PingMessageSchema = z.object({\n  type: z.literal(\"ping\"),\n});\n\n// Main → Plugin: State sync - sends complete state snapshot\nconst StateSyncMessageSchema = z.object({\n  type: z.literal(\"state-sync\"),\n  syncId: z.number(),\n  state: z.custom<PluginStateSnapshot>((data: unknown) => {\n    return (\n      typeof data === \"object\" &&\n      data !== null &&\n      \"session\" in data &&\n      \"notifications\" in data\n    );\n  }),\n});\n\n// Main → Plugin: Validation result response\nconst ValidateInteractionResultMessageSchema = z.object({\n  type: z.literal(\"validate-interaction-result\"),\n  messageId: z.string(),\n  result: z.object({\n    valid: z.boolean(),\n    errorCode: z.string().nullable().optional(),\n    message: z.string().nullable().optional(),\n  }),\n});\n\nconst SubmitResultMessageSchema = z.object({\n  type: z.literal(\"submit-result\"),\n  messageId: z.string(),\n  accepted: z.boolean(),\n  errorCode: z.string().nullable().optional(),\n  message: z.string().nullable().optional(),\n});\n\n// Union of all messages from main → plugin\nconst MainToPluginMessageSchema = z.discriminatedUnion(\"type\", [\n  InitMessageSchema,\n  PingMessageSchema,\n  StateSyncMessageSchema,\n  ValidateInteractionResultMessageSchema,\n  SubmitResultMessageSchema,\n]);\n\n/**\n * Extended RuntimeAPI with plugin-specific methods for state-sync architecture.\n */\nexport interface PluginRuntimeAPI extends RuntimeAPI {\n  /**\n   * Get the current state snapshot.\n   * Returns null if no state-sync has been received yet.\n   *\n   * @example\n   * ```typescript\n   * const snapshot = runtime.getSnapshot();\n   * if (snapshot?.view) {\n   *   console.log('Current view:', snapshot.view);\n   * }\n   * ```\n   */\n  getSnapshot: () => PluginStateSnapshot | null;\n\n  /**\n   * Subscribe to state changes from state-sync messages.\n   * Called whenever the host sends a new state-sync.\n   *\n   * @param listener - Callback invoked with new state snapshot\n   * @returns Unsubscribe function\n   *\n   * @example\n   * ```typescript\n   * const unsubscribe = runtime.subscribeToState((state) => {\n   *   console.log('New phase:', state.gameplay.currentPhase);\n   * });\n   * ```\n   */\n  subscribeToState: (\n    listener: (state: PluginStateSnapshot) => void,\n  ) => () => void;\n\n  /** Internal API for RuntimeContext to subscribe to session state changes */\n  _subscribeToSessionState: (\n    listener: (state: PluginSessionState) => void,\n  ) => () => void;\n\n  /**\n   * Request to restore game state to a previous history entry.\n   * Only works if the user is the host.\n   *\n   * @param entryId - ID of the history entry to restore to\n   *\n   * @example\n   * ```typescript\n   * // Restore to a previous state\n   * runtime.restoreHistory?.('entry-abc-123');\n   * ```\n   */\n  restoreHistory?: (entryId: string) => void;\n}\n\n/**\n * Mint a client-side correlation id for a single submitted interaction.\n * This id flows plugin -> host gateway -> backend HTTP header\n * (`X-Dreamboard-Client-Action-Id`), and back to the host via the recorded\n * `version -> actionId` map so the full t0..t8 latency trace can be\n * assembled for Tier-0 input-latency observability. Falls back to a\n * timestamp-seeded pseudo-uuid on environments without `crypto.randomUUID`\n * (older sandboxed browsers in tests) so we never crash the plugin.\n */\nconst mintClientActionId = (): string => {\n  const cryptoLike = (\n    globalThis as typeof globalThis & {\n      crypto?: { randomUUID?: () => string };\n    }\n  ).crypto;\n  if (cryptoLike?.randomUUID) {\n    try {\n      return cryptoLike.randomUUID();\n    } catch {\n      // fall through to fallback\n    }\n  }\n  const rand = Math.random().toString(16).slice(2);\n  return `cid-${Date.now().toString(16)}-${rand}`;\n};\n\nconst PLUGIN_RUNTIME_SINGLETON_KEY = \"__dreamboardPluginRuntimeApi\";\n\ntype PluginRuntimeGlobal = typeof globalThis & {\n  [PLUGIN_RUNTIME_SINGLETON_KEY]?: PluginRuntimeAPI;\n};\n\n/**\n * Creates a RuntimeAPI implementation for plugin iframes.\n *\n * Architecture (state-sync):\n * - Host maintains all state in GameSessionStore\n * - Host sends complete state snapshots via state-sync messages\n * - Plugin stores received state and notifies subscribers\n * - No buffering needed - plugin only renders when state exists\n *\n * Security:\n * - Plugin runs in sandboxed iframe (no network access, no same-origin)\n * - All backend communication goes through main app\n *\n * @returns PluginRuntimeAPI instance\n */\nexport function createPluginRuntimeAPI(): PluginRuntimeAPI {\n  const existingRuntime = (globalThis as PluginRuntimeGlobal)[\n    PLUGIN_RUNTIME_SINGLETON_KEY\n  ];\n  if (existingRuntime) {\n    return existingRuntime;\n  }\n\n  // State-sync state\n  let currentStateSnapshot: PluginStateSnapshot | null = null;\n  const stateListeners = new Set<(state: PluginStateSnapshot) => void>();\n\n  // Session state\n  const sessionState: PluginSessionState = {\n    status: \"loading\",\n    sessionId: null,\n    controllablePlayerIds: [],\n    controllingPlayerId: null,\n    userId: null,\n  };\n  const sessionStateListeners = new Set<(state: PluginSessionState) => void>();\n\n  // Pending validation requests\n  const pendingValidations = new Map<\n    string,\n    (result: ValidationResult) => void\n  >();\n  let validationIdCounter = 0;\n  const pendingSubmissions = new Map<\n    string,\n    {\n      resolve: () => void;\n      reject: (error: Error & { errorCode?: string }) => void;\n    }\n  >();\n  let submitIdCounter = 0;\n\n  // Helper functions\n  const notifySessionStateChange = () => {\n    sessionStateListeners.forEach((listener) => {\n      try {\n        listener({ ...sessionState });\n      } catch {\n        // Silently catch listener errors\n      }\n    });\n  };\n\n  const notifyStateListeners = () => {\n    if (!currentStateSnapshot) return;\n    const snapshot = currentStateSnapshot;\n    stateListeners.forEach((listener) => {\n      try {\n        listener(snapshot);\n      } catch {\n        // Silently catch listener errors\n      }\n    });\n  };\n\n  const createSubmissionError = (\n    errorCode?: string,\n    message?: string,\n  ): Error & { errorCode?: string } => {\n    const error = new Error(message ?? \"Submission failed\") as Error & {\n      errorCode?: string;\n      name: string;\n    };\n    error.name = \"SubmissionError\";\n    error.errorCode = errorCode;\n    return error;\n  };\n\n  const submitViaParent = (payload: {\n    type: \"interaction\";\n    playerId: PlayerId;\n    interactionId: string;\n    params: unknown;\n    clientActionId?: string;\n  }): Promise<void> =>\n    new Promise((resolve, reject) => {\n      const messageId = `submit-${++submitIdCounter}`;\n      pendingSubmissions.set(messageId, { resolve, reject });\n\n      // Plugin-iframe `Date.now()` ships alongside the postMessage\n      // as the `t0_click` timestamp for Tier-0 input-latency\n      // observability. Date.now() (not performance.now()) is\n      // intentional: the iframe and the host share a wall-clock\n      // base but not a `performance.now()` origin.\n      const clientSubmittedAtMs = Date.now();\n\n      if (payload.clientActionId && typeof performance !== \"undefined\") {\n        try {\n          performance.mark(`dreamboard.t0_click.${payload.clientActionId}`, {\n            detail: { clientActionId: payload.clientActionId },\n          });\n        } catch {\n          // performance.mark detail arg not supported in older browsers; ignore\n        }\n      }\n\n      window.parent.postMessage(\n        { ...payload, messageId, clientSubmittedAtMs },\n        \"*\",\n      );\n\n      setTimeout(() => {\n        const pending = pendingSubmissions.get(messageId);\n        if (!pending) {\n          return;\n        }\n        pendingSubmissions.delete(messageId);\n        pending.reject(\n          createSubmissionError(\n            \"submission-timeout\",\n            \"Submission request timed out\",\n          ),\n        );\n      }, 10000);\n    });\n\n  // Message handler\n  const handleMessage = (event: MessageEvent) => {\n    const rawMessage = event.data;\n\n    const parseResult = MainToPluginMessageSchema.safeParse(rawMessage);\n    if (!parseResult.success) {\n      // Only warn for messages that look like they're meant for us\n      if (rawMessage?.type && typeof rawMessage.type === \"string\") {\n        // eslint-disable-next-line no-console\n        console.warn(\n          \"[Plugin RuntimeAPI] Invalid message received:\",\n          rawMessage.type,\n        );\n      }\n      return;\n    }\n\n    const message = parseResult.data;\n\n    switch (message.type) {\n      case \"init\": {\n        // eslint-disable-next-line no-console\n        console.log(\"[Plugin RuntimeAPI] Received init message\");\n\n        sessionState.status = \"ready\";\n        sessionState.sessionId = message.sessionId;\n        sessionState.controllablePlayerIds =\n          message.controllablePlayerIds as PlayerId[];\n        sessionState.controllingPlayerId =\n          message.controllingPlayerId as PlayerId;\n        sessionState.userId = message.userId;\n\n        notifySessionStateChange();\n        window.parent.postMessage({ type: \"ready\" }, \"*\");\n        break;\n      }\n\n      case \"ping\": {\n        window.parent.postMessage({ type: \"pong\" }, \"*\");\n        break;\n      }\n\n      case \"state-sync\": {\n        // Handle state-sync from host\n        // eslint-disable-next-line no-console\n        console.log(\n          \"[Plugin RuntimeAPI] Received state-sync, syncId:\",\n          message.syncId,\n        );\n\n        // Tier-0 perf: capture `t7_state_sync_received` wall-clock\n        // timestamp up-front so the host can stitch it onto the\n        // perf HUD via the outgoing state-ack message.\n        const clientReceivedAtMs = Date.now();\n        if (typeof performance !== \"undefined\") {\n          try {\n            performance.mark(\n              `dreamboard.t7_state_sync_received.sync-${message.syncId}`,\n              { detail: { syncId: message.syncId } },\n            );\n          } catch {\n            // performance.mark detail arg not supported; ignore\n          }\n        }\n\n        currentStateSnapshot = message.state;\n\n        // Update session state from snapshot\n        if (message.state.session) {\n          sessionState.sessionId = message.state.session.sessionId;\n          sessionState.controllablePlayerIds =\n            message.state.session.controllablePlayerIds;\n          sessionState.controllingPlayerId =\n            message.state.session.controllingPlayerId;\n          sessionState.userId = message.state.session.userId;\n          sessionState.status = \"ready\";\n          notifySessionStateChange();\n        }\n\n        // Notify state listeners\n        notifyStateListeners();\n\n        // Send acknowledgment (carrying t7 timestamp for the host\n        // perf HUD; host ignores it when perf is disabled).\n        window.parent.postMessage(\n          {\n            type: \"state-ack\",\n            syncId: message.syncId,\n            clientReceivedAtMs,\n          },\n          \"*\",\n        );\n\n        // Tier-0 perf: after notifyStateListeners has kicked React's\n        // render, schedule a post-commit microtask + rAF chain so the\n        // paired `state-rendered` message lands close to when the\n        // plugin's DOM would have been painted. `queueMicrotask` is\n        // used first because most React listeners finish synchronously;\n        // `requestAnimationFrame` then bounces to the next paint tick.\n        const schedulePostRender = () => {\n          const send = () => {\n            const clientRenderedAtMs = Date.now();\n            if (typeof performance !== \"undefined\") {\n              try {\n                performance.mark(\n                  `dreamboard.t8_render_commit.sync-${message.syncId}`,\n                  { detail: { syncId: message.syncId } },\n                );\n              } catch {\n                // ignore\n              }\n            }\n            window.parent.postMessage(\n              {\n                type: \"state-rendered\",\n                syncId: message.syncId,\n                clientReceivedAtMs,\n                clientRenderedAtMs,\n              },\n              \"*\",\n            );\n          };\n          if (typeof requestAnimationFrame === \"function\") {\n            requestAnimationFrame(send);\n          } else {\n            queueMicrotask(send);\n          }\n        };\n        queueMicrotask(schedulePostRender);\n\n        break;\n      }\n\n      case \"validate-interaction-result\": {\n        const resolver = pendingValidations.get(message.messageId);\n        if (resolver) {\n          pendingValidations.delete(message.messageId);\n          resolver({\n            valid: message.result.valid,\n            errorCode: message.result.errorCode ?? undefined,\n            message: message.result.message ?? undefined,\n          });\n        }\n        break;\n      }\n\n      case \"submit-result\": {\n        const pending = pendingSubmissions.get(message.messageId);\n        if (!pending) {\n          break;\n        }\n\n        if (typeof performance !== \"undefined\") {\n          try {\n            performance.mark(`dreamboard.t3b_ack.${message.messageId}`, {\n              detail: { messageId: message.messageId },\n            });\n          } catch {\n            // ignore\n          }\n        }\n\n        pendingSubmissions.delete(message.messageId);\n        if (message.accepted) {\n          pending.resolve();\n        } else {\n          pending.reject(\n            createSubmissionError(\n              message.errorCode ?? undefined,\n              message.message ?? undefined,\n            ),\n          );\n        }\n        break;\n      }\n    }\n  };\n\n  window.addEventListener(\"message\", handleMessage);\n\n  // Error handlers\n  const sendErrorToParent = (message: string, code: string, stack?: string) => {\n    // eslint-disable-next-line no-console\n    console.error(`[Plugin RuntimeAPI] ${code}:`, message, stack || \"\");\n    window.parent.postMessage(\n      {\n        type: \"error\",\n        message: stack ? `${message}\\n${stack}` : message,\n        code,\n      },\n      \"*\",\n    );\n  };\n\n  window.onerror = (message, source, lineno, colno, error) => {\n    const errorMessage =\n      typeof message === \"string\" ? message : error?.message || \"Unknown error\";\n    const location = source ? ` at ${source}:${lineno}:${colno}` : \"\";\n    sendErrorToParent(errorMessage + location, \"UNCAUGHT_ERROR\", error?.stack);\n    return false;\n  };\n\n  window.onunhandledrejection = (event: PromiseRejectionEvent) => {\n    const reason = event.reason;\n    const message =\n      reason instanceof Error\n        ? reason.message\n        : typeof reason === \"string\"\n          ? reason\n          : JSON.stringify(reason);\n    const stack = reason instanceof Error ? reason.stack : undefined;\n    sendErrorToParent(message, \"UNHANDLED_REJECTION\", stack);\n  };\n\n  // eslint-disable-next-line no-console\n  console.log(\"[Plugin RuntimeAPI] ✅ Initialized (state-sync architecture)\");\n\n  const runtime: PluginRuntimeAPI = {\n    // State-sync methods\n    getSnapshot: () => currentStateSnapshot,\n\n    subscribeToState: (listener) => {\n      stateListeners.add(listener);\n      // Immediately notify with current state if available\n      if (currentStateSnapshot) {\n        try {\n          listener(currentStateSnapshot);\n        } catch {\n          // Silently catch listener errors\n        }\n      }\n      return () => {\n        stateListeners.delete(listener);\n      };\n    },\n\n    validateInteraction: async (playerId, interactionId, params) => {\n      return new Promise((resolve) => {\n        const messageId = `validate-${++validationIdCounter}`;\n        pendingValidations.set(messageId, resolve);\n\n        window.parent.postMessage(\n          {\n            type: \"validate-interaction\",\n            playerId,\n            interactionId,\n            params,\n            messageId,\n          },\n          \"*\",\n        );\n\n        // Timeout after 10 seconds to avoid hanging forever\n        setTimeout(() => {\n          if (pendingValidations.has(messageId)) {\n            pendingValidations.delete(messageId);\n            resolve({\n              valid: false,\n              errorCode: \"validation-timeout\",\n              message: \"Validation request timed out\",\n            });\n          }\n        }, 10000);\n      });\n    },\n\n    submitInteraction: async (playerId, interactionId, params) =>\n      submitViaParent({\n        type: \"interaction\",\n        playerId,\n        interactionId,\n        params,\n        clientActionId: mintClientActionId(),\n      }),\n\n    getSessionState: () => ({ ...sessionState }),\n\n    disconnect: () => {\n      window.removeEventListener(\"message\", handleMessage);\n      window.onerror = null;\n      window.onunhandledrejection = null;\n      sessionStateListeners.clear();\n      stateListeners.clear();\n      pendingValidations.clear();\n      pendingSubmissions.clear();\n      currentStateSnapshot = null;\n    },\n\n    switchPlayer: (playerId: PlayerId) => {\n      window.parent.postMessage({ type: \"switch-player\", playerId }, \"*\");\n    },\n\n    restoreHistory: (entryId: string) => {\n      window.parent.postMessage({ type: \"restore-history\", entryId }, \"*\");\n    },\n\n    _subscribeToSessionState: (\n      listener: (state: PluginSessionState) => void,\n    ) => {\n      sessionStateListeners.add(listener);\n      listener({ ...sessionState });\n      return () => {\n        sessionStateListeners.delete(listener);\n      };\n    },\n  };\n\n  (globalThis as PluginRuntimeGlobal)[PLUGIN_RUNTIME_SINGLETON_KEY] = runtime;\n\n  return runtime;\n}\n","import React from \"react\";\nimport { InteractionUiProvider } from \"../context/InteractionDraftContext.js\";\nimport { RuntimeProvider } from \"../context/RuntimeContext.js\";\nimport { usePluginSession } from \"../context/PluginSessionContext.js\";\nimport { usePluginRuntime } from \"../hooks/usePluginRuntime.js\";\nimport { GameSkeleton } from \"../../ui.js\";\n\nexport interface PluginRuntimeProps {\n  /** Child components to render after state sync has started */\n  children: React.ReactNode;\n  /**\n   * Timeout in milliseconds to wait for the first state-sync snapshot.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  /** Custom loading component to show while waiting for state sync */\n  loadingComponent?: React.ReactNode;\n  /** Custom error component to show when initialization fails */\n  errorComponent?: (error: string) => React.ReactNode;\n}\n\n/**\n * PluginRuntime provides the RuntimeContext for plugin components.\n *\n * This component:\n * - Creates a RuntimeAPI instance using the SDK-provided implementation\n * - Waits for the first reducer-native state-sync snapshot before rendering children\n * - Provides RuntimeAPI and session state to all child components\n *\n * @example\n * ```tsx\n * // In your plugin's index.tsx\n * import { PluginRuntime } from \"./components/dreamboard\";\n * import App from './App';\n *\n * ReactDOM.createRoot(document.getElementById('root')!).render(\n *   <PluginRuntime>\n *     <App />\n *   </PluginRuntime>\n * );\n * ```\n */\nexport function PluginRuntime({\n  children,\n  timeout = 10000,\n  loadingComponent,\n  errorComponent,\n}: PluginRuntimeProps) {\n  const { runtime, isReady, waiting, error } = usePluginRuntime({ timeout });\n\n  if (error) {\n    if (errorComponent) {\n      return <>{errorComponent(error)}</>;\n    }\n    return (\n      <div className=\"flex h-full w-full items-center justify-center bg-gray-50\">\n        <div className=\"text-center p-6\">\n          <p className=\"text-red-600 font-medium mb-2\">Failed to load game</p>\n          <p className=\"text-gray-600 text-sm\">{error}</p>\n        </div>\n      </div>\n    );\n  }\n\n  if (!isReady) {\n    if (loadingComponent) {\n      return <>{loadingComponent}</>;\n    }\n    // Once the game has rendered, a view-less snapshot is a mid-game wait (you\n    // acted and are waiting on the table), not a cold load — say so rather than\n    // reading as a stalled \"Waiting for game state\".\n    return (\n      <GameSkeleton\n        message={\n          waiting\n            ? \"Waiting for the other players…\"\n            : \"Waiting for game state...\"\n        }\n      />\n    );\n  }\n\n  return (\n    <RuntimeProvider runtime={runtime}>\n      <SessionScopedInteractionUiProvider>\n        {children}\n      </SessionScopedInteractionUiProvider>\n    </RuntimeProvider>\n  );\n}\n\nfunction SessionScopedInteractionUiProvider({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  const { controllingPlayerId } = usePluginSession();\n  return (\n    <InteractionUiProvider key={controllingPlayerId ?? \"__no_player__\"}>\n      {children}\n    </InteractionUiProvider>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/runtime-internal/hooks/usePluginRuntime.ts","../src/runtime-internal/runtime/createPluginRuntimeAPI.ts","../src/runtime-internal/components/PluginRuntime.tsx"],"sourcesContent":["import { useState, useEffect, useRef } from \"react\";\nimport {\n  createPluginRuntimeAPI,\n  type PluginRuntimeAPI,\n} from \"../runtime/createPluginRuntimeAPI.js\";\n\nexport interface UsePluginRuntimeOptions {\n  /**\n   * Timeout in milliseconds to wait for state-sync.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n}\n\nexport interface UsePluginRuntimeResult {\n  /** The RuntimeAPI instance */\n  runtime: PluginRuntimeAPI;\n  /** Whether the initial reducer-native snapshot is available and ready */\n  isReady: boolean;\n  /**\n   * True when the plugin was ready before but the current snapshot has no\n   * projected view — e.g. you've acted and are waiting on the rest of the\n   * table in a simultaneous phase. Lets the loading affordance read as a\n   * mid-game wait rather than a cold \"still loading\" stall.\n   */\n  waiting: boolean;\n  /** Error message if initialization failed */\n  error: string | null;\n}\n\nfunction hasProjectedView(\n  snapshot: ReturnType<PluginRuntimeAPI[\"getSnapshot\"]> | null | undefined,\n): boolean {\n  return (\n    snapshot !== null &&\n    snapshot !== undefined &&\n    snapshot.view !== null &&\n    snapshot.view !== undefined\n  );\n}\n\n/**\n * Hook that creates and manages a PluginRuntimeAPI instance.\n *\n * This hook handles:\n * 1. Creating the RuntimeAPI\n * 2. Waiting for the first state-sync snapshot before setting isReady\n *\n * In the new architecture, the host only renders the plugin when a reducer-native\n * snapshot is available, so isReady should become true quickly after init.\n *\n * @example\n * ```tsx\n * function PluginRuntime({ children }: { children: React.ReactNode }) {\n *   const { runtime, isReady, error } = usePluginRuntime();\n *\n *   if (error) {\n *     return <div>Error: {error}</div>;\n *   }\n *\n *   if (!isReady) {\n *     return <GameSkeleton message=\"Waiting for game state...\" />;\n *   }\n *\n *   return <RuntimeProvider runtime={runtime}>{children}</RuntimeProvider>;\n * }\n * ```\n */\nexport function usePluginRuntime(\n  options: UsePluginRuntimeOptions = {},\n): UsePluginRuntimeResult {\n  const { timeout = 10000 } = options;\n\n  // Create runtime once and keep stable reference\n  const [runtime] = useState<PluginRuntimeAPI>(() => createPluginRuntimeAPI());\n  const [isReady, setIsReady] = useState(() => {\n    const snapshot = runtime.getSnapshot?.();\n    return hasProjectedView(snapshot);\n  });\n  const [error, setError] = useState<string | null>(null);\n  // Latches once we've shown a view, so a later view-less snapshot reads as a\n  // mid-game wait rather than a fresh load. (A ref, so it never re-triggers a\n  // render on its own.)\n  const hasBeenReadyRef = useRef(false);\n  if (isReady) hasBeenReadyRef.current = true;\n\n  // Subscribe to state-sync and set isReady when the first snapshot arrives.\n  useEffect(() => {\n    const markReadyFromSnapshot = () => {\n      const currentSnapshot = runtime.getSnapshot?.();\n      if (!hasProjectedView(currentSnapshot)) {\n        return false;\n      }\n      setError(null);\n      setIsReady(true);\n      return true;\n    };\n\n    if (markReadyFromSnapshot()) {\n      return;\n    }\n\n    // Set up timeout\n    const timeoutId = setTimeout(() => {\n      if (!markReadyFromSnapshot()) {\n        setError(\n          `Timed out waiting for the initial projected view after ${timeout}ms. ` +\n            \"Ensure the host sends a reducer-native state-sync with a seat view.\",\n        );\n      }\n    }, timeout);\n\n    // Fallback poll for dev/HMR flows where the runtime snapshot may already\n    // exist but the first subscribe callback is missed.\n    const pollId = setInterval(() => {\n      if (markReadyFromSnapshot()) {\n        clearInterval(pollId);\n        clearTimeout(timeoutId);\n      }\n    }, 100);\n\n    // Subscribe to state changes\n    const unsubscribe = runtime.subscribeToState?.((state) => {\n      if (!hasProjectedView(state)) {\n        setIsReady(false);\n        return;\n      }\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      setError(null);\n      setIsReady(true);\n    });\n\n    return () => {\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      unsubscribe?.();\n    };\n  }, [runtime, timeout]);\n\n  return {\n    runtime,\n    isReady,\n    waiting: hasBeenReadyRef.current && !isReady,\n    error,\n  };\n}\n","import { z } from \"zod\";\nimport type { PlayerId } from \"@dreamboard/manifest-contract\";\nimport type {\n  RuntimeAPI,\n  PluginSessionState,\n  ValidationResult,\n} from \"../types/runtime-api.js\";\nimport type { PluginStateSnapshot } from \"../types/plugin-state.js\";\n\n/**\n * Message schemas from main app to plugin\n * We define them here to avoid circular dependencies with apps/web\n */\n\n// Main → Plugin: Initialize plugin with session info\nconst InitMessageSchema = z.object({\n  type: z.literal(\"init\"),\n  sessionId: z.string(),\n  controllablePlayerIds: z.array(z.string()),\n  controllingPlayerId: z.string(),\n  userId: z.string().nullable(),\n});\n\n// Main → Plugin: Health check ping\nconst PingMessageSchema = z.object({\n  type: z.literal(\"ping\"),\n});\n\n// Main → Plugin: State sync - sends complete state snapshot\nconst StateSyncMessageSchema = z.object({\n  type: z.literal(\"state-sync\"),\n  syncId: z.number(),\n  state: z.custom<PluginStateSnapshot>((data: unknown) => {\n    return (\n      typeof data === \"object\" &&\n      data !== null &&\n      \"session\" in data &&\n      \"notifications\" in data\n    );\n  }),\n});\n\n// Main → Plugin: Validation result response\nconst ValidateInteractionResultMessageSchema = z.object({\n  type: z.literal(\"validate-interaction-result\"),\n  messageId: z.string(),\n  result: z.object({\n    valid: z.boolean(),\n    errorCode: z.string().nullable().optional(),\n    message: z.string().nullable().optional(),\n  }),\n});\n\nconst SubmitResultMessageSchema = z.object({\n  type: z.literal(\"submit-result\"),\n  messageId: z.string(),\n  accepted: z.boolean(),\n  errorCode: z.string().nullable().optional(),\n  message: z.string().nullable().optional(),\n});\n\n// Union of all messages from main → plugin\nconst MainToPluginMessageSchema = z.discriminatedUnion(\"type\", [\n  InitMessageSchema,\n  PingMessageSchema,\n  StateSyncMessageSchema,\n  ValidateInteractionResultMessageSchema,\n  SubmitResultMessageSchema,\n]);\n\n/**\n * Extended RuntimeAPI with plugin-specific methods for state-sync architecture.\n */\nexport interface PluginRuntimeAPI extends RuntimeAPI {\n  /**\n   * Get the current state snapshot.\n   * Returns null if no state-sync has been received yet.\n   *\n   * @example\n   * ```typescript\n   * const snapshot = runtime.getSnapshot();\n   * if (snapshot?.view) {\n   *   console.log('Current view:', snapshot.view);\n   * }\n   * ```\n   */\n  getSnapshot: () => PluginStateSnapshot | null;\n\n  /**\n   * Subscribe to state changes from state-sync messages.\n   * Called whenever the host sends a new state-sync.\n   *\n   * @param listener - Callback invoked with new state snapshot\n   * @returns Unsubscribe function\n   *\n   * @example\n   * ```typescript\n   * const unsubscribe = runtime.subscribeToState((state) => {\n   *   console.log('New phase:', state.gameplay.currentPhase);\n   * });\n   * ```\n   */\n  subscribeToState: (\n    listener: (state: PluginStateSnapshot) => void,\n  ) => () => void;\n\n  /** Internal API for RuntimeContext to subscribe to session state changes */\n  _subscribeToSessionState: (\n    listener: (state: PluginSessionState) => void,\n  ) => () => void;\n\n  /**\n   * Request to restore game state to a previous history entry.\n   * Only works if the user is the host.\n   *\n   * @param entryId - ID of the history entry to restore to\n   *\n   * @example\n   * ```typescript\n   * // Restore to a previous state\n   * runtime.restoreHistory?.('entry-abc-123');\n   * ```\n   */\n  restoreHistory?: (entryId: string) => void;\n}\n\n/**\n * Mint a client-side correlation id for a single submitted interaction.\n * This id flows plugin -> host gateway -> backend HTTP header\n * (`X-Dreamboard-Client-Action-Id`), and back to the host via the recorded\n * `version -> actionId` map so the full t0..t8 latency trace can be\n * assembled for Tier-0 input-latency observability. Falls back to a\n * timestamp-seeded pseudo-uuid on environments without `crypto.randomUUID`\n * (older sandboxed browsers in tests) so we never crash the plugin.\n */\nconst mintClientActionId = (): string => {\n  const cryptoLike = (\n    globalThis as typeof globalThis & {\n      crypto?: { randomUUID?: () => string };\n    }\n  ).crypto;\n  if (cryptoLike?.randomUUID) {\n    try {\n      return cryptoLike.randomUUID();\n    } catch {\n      // fall through to fallback\n    }\n  }\n  const rand = Math.random().toString(16).slice(2);\n  return `cid-${Date.now().toString(16)}-${rand}`;\n};\n\nconst PLUGIN_RUNTIME_SINGLETON_KEY = \"__dreamboardPluginRuntimeApi\";\n\ntype PluginRuntimeGlobal = typeof globalThis & {\n  [PLUGIN_RUNTIME_SINGLETON_KEY]?: PluginRuntimeAPI;\n};\n\n/**\n * Creates a RuntimeAPI implementation for plugin iframes.\n *\n * Architecture (state-sync):\n * - Host maintains all state in GameSessionStore\n * - Host sends complete state snapshots via state-sync messages\n * - Plugin stores received state and notifies subscribers\n * - No buffering needed - plugin only renders when state exists\n *\n * Security:\n * - Plugin runs in sandboxed iframe (no network access, no same-origin)\n * - All backend communication goes through main app\n *\n * @returns PluginRuntimeAPI instance\n */\nexport function createPluginRuntimeAPI(): PluginRuntimeAPI {\n  const existingRuntime = (globalThis as PluginRuntimeGlobal)[\n    PLUGIN_RUNTIME_SINGLETON_KEY\n  ];\n  if (existingRuntime) {\n    return existingRuntime;\n  }\n\n  // State-sync state\n  let currentStateSnapshot: PluginStateSnapshot | null = null;\n  const stateListeners = new Set<(state: PluginStateSnapshot) => void>();\n\n  // Session state\n  const sessionState: PluginSessionState = {\n    status: \"loading\",\n    sessionId: null,\n    controllablePlayerIds: [],\n    controllingPlayerId: null,\n    userId: null,\n  };\n  const sessionStateListeners = new Set<(state: PluginSessionState) => void>();\n\n  // Pending validation requests\n  const pendingValidations = new Map<\n    string,\n    (result: ValidationResult) => void\n  >();\n  let validationIdCounter = 0;\n  const pendingSubmissions = new Map<\n    string,\n    {\n      resolve: () => void;\n      reject: (error: Error & { errorCode?: string }) => void;\n    }\n  >();\n  let submitIdCounter = 0;\n\n  // Helper functions\n  const notifySessionStateChange = () => {\n    sessionStateListeners.forEach((listener) => {\n      try {\n        listener({ ...sessionState });\n      } catch {\n        // Silently catch listener errors\n      }\n    });\n  };\n\n  const notifyStateListeners = () => {\n    if (!currentStateSnapshot) return;\n    const snapshot = currentStateSnapshot;\n    stateListeners.forEach((listener) => {\n      try {\n        listener(snapshot);\n      } catch {\n        // Silently catch listener errors\n      }\n    });\n  };\n\n  const createSubmissionError = (\n    errorCode?: string,\n    message?: string,\n  ): Error & { errorCode?: string } => {\n    const error = new Error(message ?? \"Submission failed\") as Error & {\n      errorCode?: string;\n      name: string;\n    };\n    error.name = \"SubmissionError\";\n    error.errorCode = errorCode;\n    return error;\n  };\n\n  const submitViaParent = (payload: {\n    type: \"interaction\";\n    playerId: PlayerId;\n    interactionId: string;\n    params: unknown;\n    clientActionId?: string;\n  }): Promise<void> =>\n    new Promise((resolve, reject) => {\n      const messageId = `submit-${++submitIdCounter}`;\n      pendingSubmissions.set(messageId, { resolve, reject });\n\n      // Plugin-iframe `Date.now()` ships alongside the postMessage\n      // as the `t0_click` timestamp for Tier-0 input-latency\n      // observability. Date.now() (not performance.now()) is\n      // intentional: the iframe and the host share a wall-clock\n      // base but not a `performance.now()` origin.\n      const clientSubmittedAtMs = Date.now();\n\n      if (payload.clientActionId && typeof performance !== \"undefined\") {\n        try {\n          performance.mark(`dreamboard.t0_click.${payload.clientActionId}`, {\n            detail: { clientActionId: payload.clientActionId },\n          });\n        } catch {\n          // performance.mark detail arg not supported in older browsers; ignore\n        }\n      }\n\n      window.parent.postMessage(\n        { ...payload, messageId, clientSubmittedAtMs },\n        \"*\",\n      );\n\n      setTimeout(() => {\n        const pending = pendingSubmissions.get(messageId);\n        if (!pending) {\n          return;\n        }\n        pendingSubmissions.delete(messageId);\n        pending.reject(\n          createSubmissionError(\n            \"submission-timeout\",\n            \"Submission request timed out\",\n          ),\n        );\n      }, 10000);\n    });\n\n  // Message handler\n  const handleMessage = (event: MessageEvent) => {\n    const rawMessage = event.data;\n\n    const parseResult = MainToPluginMessageSchema.safeParse(rawMessage);\n    if (!parseResult.success) {\n      // Only warn for messages that look like they're meant for us\n      if (rawMessage?.type && typeof rawMessage.type === \"string\") {\n        // eslint-disable-next-line no-console\n        console.warn(\n          \"[Plugin RuntimeAPI] Invalid message received:\",\n          rawMessage.type,\n        );\n      }\n      return;\n    }\n\n    const message = parseResult.data;\n\n    switch (message.type) {\n      case \"init\": {\n        // eslint-disable-next-line no-console\n        console.log(\"[Plugin RuntimeAPI] Received init message\");\n\n        sessionState.status = \"ready\";\n        sessionState.sessionId = message.sessionId;\n        sessionState.controllablePlayerIds =\n          message.controllablePlayerIds as PlayerId[];\n        sessionState.controllingPlayerId =\n          message.controllingPlayerId as PlayerId;\n        sessionState.userId = message.userId;\n\n        notifySessionStateChange();\n        window.parent.postMessage({ type: \"ready\" }, \"*\");\n        break;\n      }\n\n      case \"ping\": {\n        window.parent.postMessage({ type: \"pong\" }, \"*\");\n        break;\n      }\n\n      case \"state-sync\": {\n        // Handle state-sync from host\n        // eslint-disable-next-line no-console\n        console.log(\n          \"[Plugin RuntimeAPI] Received state-sync, syncId:\",\n          message.syncId,\n        );\n\n        // Tier-0 perf: capture `t7_state_sync_received` wall-clock\n        // timestamp up-front so the host can stitch it onto the\n        // perf HUD via the outgoing state-ack message.\n        const clientReceivedAtMs = Date.now();\n        if (typeof performance !== \"undefined\") {\n          try {\n            performance.mark(\n              `dreamboard.t7_state_sync_received.sync-${message.syncId}`,\n              { detail: { syncId: message.syncId } },\n            );\n          } catch {\n            // performance.mark detail arg not supported; ignore\n          }\n        }\n\n        currentStateSnapshot = message.state;\n\n        // Update session state from snapshot\n        if (message.state.session) {\n          sessionState.sessionId = message.state.session.sessionId;\n          sessionState.controllablePlayerIds =\n            message.state.session.controllablePlayerIds;\n          sessionState.controllingPlayerId =\n            message.state.session.controllingPlayerId;\n          sessionState.userId = message.state.session.userId;\n          sessionState.status = \"ready\";\n          notifySessionStateChange();\n        }\n\n        // Notify state listeners\n        notifyStateListeners();\n\n        // Send acknowledgment (carrying t7 timestamp for the host\n        // perf HUD; host ignores it when perf is disabled).\n        window.parent.postMessage(\n          {\n            type: \"state-ack\",\n            syncId: message.syncId,\n            clientReceivedAtMs,\n          },\n          \"*\",\n        );\n\n        // Tier-0 perf: after notifyStateListeners has kicked React's\n        // render, schedule a post-commit microtask + rAF chain so the\n        // paired `state-rendered` message lands close to when the\n        // plugin's DOM would have been painted. `queueMicrotask` is\n        // used first because most React listeners finish synchronously;\n        // `requestAnimationFrame` then bounces to the next paint tick.\n        const schedulePostRender = () => {\n          const send = () => {\n            const clientRenderedAtMs = Date.now();\n            if (typeof performance !== \"undefined\") {\n              try {\n                performance.mark(\n                  `dreamboard.t8_render_commit.sync-${message.syncId}`,\n                  { detail: { syncId: message.syncId } },\n                );\n              } catch {\n                // ignore\n              }\n            }\n            window.parent.postMessage(\n              {\n                type: \"state-rendered\",\n                syncId: message.syncId,\n                clientReceivedAtMs,\n                clientRenderedAtMs,\n              },\n              \"*\",\n            );\n          };\n          if (typeof requestAnimationFrame === \"function\") {\n            requestAnimationFrame(send);\n          } else {\n            queueMicrotask(send);\n          }\n        };\n        queueMicrotask(schedulePostRender);\n\n        break;\n      }\n\n      case \"validate-interaction-result\": {\n        const resolver = pendingValidations.get(message.messageId);\n        if (resolver) {\n          pendingValidations.delete(message.messageId);\n          resolver({\n            valid: message.result.valid,\n            errorCode: message.result.errorCode ?? undefined,\n            message: message.result.message ?? undefined,\n          });\n        }\n        break;\n      }\n\n      case \"submit-result\": {\n        const pending = pendingSubmissions.get(message.messageId);\n        if (!pending) {\n          break;\n        }\n\n        if (typeof performance !== \"undefined\") {\n          try {\n            performance.mark(`dreamboard.t3b_ack.${message.messageId}`, {\n              detail: { messageId: message.messageId },\n            });\n          } catch {\n            // ignore\n          }\n        }\n\n        pendingSubmissions.delete(message.messageId);\n        if (message.accepted) {\n          pending.resolve();\n        } else {\n          pending.reject(\n            createSubmissionError(\n              message.errorCode ?? undefined,\n              message.message ?? undefined,\n            ),\n          );\n        }\n        break;\n      }\n    }\n  };\n\n  window.addEventListener(\"message\", handleMessage);\n\n  // Error handlers\n  const sendErrorToParent = (message: string, code: string, stack?: string) => {\n    // eslint-disable-next-line no-console\n    console.error(`[Plugin RuntimeAPI] ${code}:`, message, stack || \"\");\n    window.parent.postMessage(\n      {\n        type: \"error\",\n        message: stack ? `${message}\\n${stack}` : message,\n        code,\n      },\n      \"*\",\n    );\n  };\n\n  window.onerror = (message, source, lineno, colno, error) => {\n    const errorMessage =\n      typeof message === \"string\" ? message : error?.message || \"Unknown error\";\n    const location = source ? ` at ${source}:${lineno}:${colno}` : \"\";\n    sendErrorToParent(errorMessage + location, \"UNCAUGHT_ERROR\", error?.stack);\n    return false;\n  };\n\n  window.onunhandledrejection = (event: PromiseRejectionEvent) => {\n    const reason = event.reason;\n    const message =\n      reason instanceof Error\n        ? reason.message\n        : typeof reason === \"string\"\n          ? reason\n          : JSON.stringify(reason);\n    const stack = reason instanceof Error ? reason.stack : undefined;\n    sendErrorToParent(message, \"UNHANDLED_REJECTION\", stack);\n  };\n\n  // eslint-disable-next-line no-console\n  console.log(\"[Plugin RuntimeAPI] ✅ Initialized (state-sync architecture)\");\n\n  const runtime: PluginRuntimeAPI = {\n    // State-sync methods\n    getSnapshot: () => currentStateSnapshot,\n\n    subscribeToState: (listener) => {\n      stateListeners.add(listener);\n      // Immediately notify with current state if available\n      if (currentStateSnapshot) {\n        try {\n          listener(currentStateSnapshot);\n        } catch {\n          // Silently catch listener errors\n        }\n      }\n      return () => {\n        stateListeners.delete(listener);\n      };\n    },\n\n    validateInteraction: async (playerId, interactionId, params) => {\n      return new Promise((resolve) => {\n        const messageId = `validate-${++validationIdCounter}`;\n        pendingValidations.set(messageId, resolve);\n\n        window.parent.postMessage(\n          {\n            type: \"validate-interaction\",\n            playerId,\n            interactionId,\n            params,\n            messageId,\n          },\n          \"*\",\n        );\n\n        // Timeout after 10 seconds to avoid hanging forever\n        setTimeout(() => {\n          if (pendingValidations.has(messageId)) {\n            pendingValidations.delete(messageId);\n            resolve({\n              valid: false,\n              errorCode: \"validation-timeout\",\n              message: \"Validation request timed out\",\n            });\n          }\n        }, 10000);\n      });\n    },\n\n    submitInteraction: async (playerId, interactionId, params) =>\n      submitViaParent({\n        type: \"interaction\",\n        playerId,\n        interactionId,\n        params,\n        clientActionId: mintClientActionId(),\n      }),\n\n    getSessionState: () => ({ ...sessionState }),\n\n    disconnect: () => {\n      window.removeEventListener(\"message\", handleMessage);\n      window.onerror = null;\n      window.onunhandledrejection = null;\n      sessionStateListeners.clear();\n      stateListeners.clear();\n      pendingValidations.clear();\n      pendingSubmissions.clear();\n      currentStateSnapshot = null;\n    },\n\n    switchPlayer: (playerId: PlayerId) => {\n      window.parent.postMessage({ type: \"switch-player\", playerId }, \"*\");\n    },\n\n    restoreHistory: (entryId: string) => {\n      window.parent.postMessage({ type: \"restore-history\", entryId }, \"*\");\n    },\n\n    _subscribeToSessionState: (\n      listener: (state: PluginSessionState) => void,\n    ) => {\n      sessionStateListeners.add(listener);\n      listener({ ...sessionState });\n      return () => {\n        sessionStateListeners.delete(listener);\n      };\n    },\n  };\n\n  (globalThis as PluginRuntimeGlobal)[PLUGIN_RUNTIME_SINGLETON_KEY] = runtime;\n\n  return runtime;\n}\n","import React from \"react\";\nimport { InteractionUiProvider } from \"../context/InteractionDraftContext.js\";\nimport { RuntimeProvider } from \"../context/RuntimeContext.js\";\nimport { usePluginSession } from \"../context/PluginSessionContext.js\";\nimport { RuntimeSemanticProjectionMarker } from \"../context/PluginStateContext.js\";\nimport { usePluginRuntime } from \"../hooks/usePluginRuntime.js\";\nimport { GameSkeleton } from \"../../ui.js\";\n\nexport interface PluginRuntimeProps {\n  /** Child components to render after state sync has started */\n  children: React.ReactNode;\n  /**\n   * Timeout in milliseconds to wait for the first state-sync snapshot.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  /** Custom loading component to show while waiting for state sync */\n  loadingComponent?: React.ReactNode;\n  /** Custom error component to show when initialization fails */\n  errorComponent?: (error: string) => React.ReactNode;\n}\n\n/**\n * PluginRuntime provides the RuntimeContext for plugin components.\n *\n * This component:\n * - Creates a RuntimeAPI instance using the SDK-provided implementation\n * - Waits for the first reducer-native state-sync snapshot before rendering children\n * - Provides RuntimeAPI and session state to all child components\n *\n * @example\n * ```tsx\n * // In your plugin's index.tsx\n * import { PluginRuntime } from \"./components/dreamboard\";\n * import App from './App';\n *\n * ReactDOM.createRoot(document.getElementById('root')!).render(\n *   <PluginRuntime>\n *     <App />\n *   </PluginRuntime>\n * );\n * ```\n */\nexport function PluginRuntime({\n  children,\n  timeout = 10000,\n  loadingComponent,\n  errorComponent,\n}: PluginRuntimeProps) {\n  const { runtime, isReady, waiting, error } = usePluginRuntime({ timeout });\n\n  if (error) {\n    if (errorComponent) {\n      return <>{errorComponent(error)}</>;\n    }\n    return (\n      <div className=\"flex h-full w-full items-center justify-center bg-gray-50\">\n        <div className=\"text-center p-6\">\n          <p className=\"text-red-600 font-medium mb-2\">Failed to load game</p>\n          <p className=\"text-gray-600 text-sm\">{error}</p>\n        </div>\n      </div>\n    );\n  }\n\n  if (!isReady) {\n    if (loadingComponent) {\n      return <>{loadingComponent}</>;\n    }\n    // Once the game has rendered, a view-less snapshot is a mid-game wait (you\n    // acted and are waiting on the table), not a cold load — say so rather than\n    // reading as a stalled \"Waiting for game state\".\n    return (\n      <GameSkeleton\n        message={\n          waiting\n            ? \"Waiting for the other players…\"\n            : \"Waiting for game state...\"\n        }\n      />\n    );\n  }\n\n  return (\n    <RuntimeProvider runtime={runtime}>\n      <SessionScopedInteractionUiProvider>\n        {children}\n      </SessionScopedInteractionUiProvider>\n    </RuntimeProvider>\n  );\n}\n\nfunction SessionScopedInteractionUiProvider({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  const { controllingPlayerId } = usePluginSession();\n  return (\n    <InteractionUiProvider key={controllingPlayerId ?? \"__no_player__\"}>\n      <RuntimeSemanticProjectionMarker />\n      {children}\n    </InteractionUiProvider>\n  );\n}\n"],"mappings":"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","names":[]}