@dreamboard-games/sdk 0.4.0-alpha.6 → 0.4.0-alpha.7

package/dist/runtime.js

@@ -1,224 +1,34 @@
+import {
+  PluginRuntimeBoundary,
+  createPluginRuntimeClient
+} from "./chunk-3QIZKXJ2.js";
 import {
   createWorkspaceUIContract
-} from "./chunk-SOBNI363.js";
-import "./chunk-OV6JC2BM.js";
-import "./chunk-UC2UXAC6.js";
+} from "./chunk-Q322XCY2.js";
+import "./chunk-RKGJ64UN.js";
 import "./chunk-T3ZKNUZ7.js";
+import "./chunk-VLG4YST5.js";
+import "./chunk-UC2UXAC6.js";
 import {
   GameSkeleton
 } from "./chunk-2TRZSZGD.js";
 import "./chunk-VDXOF4FW.js";
+import "./chunk-WHR5UW3F.js";
 import {
-  PluginRuntimeBoundary,
-  createPluginRuntimeClient
-} from "./chunk-PAPIAMYX.js";
+  DREAMBOARD_SDK_VERSION
+} from "./chunk-NO537WSS.js";
+import "./chunk-KYEWGZ2Y.js";
+import "./chunk-PF7L4BMG.js";
 import {
   DREAMBOARD_PLUGIN_PROTOCOL,
   DREAMBOARD_PLUGIN_PROTOCOL_VERSION,
   HostToPluginEnvelopeSchema
-} from "./chunk-UUQNOGZV.js";
-import "./chunk-WHR5UW3F.js";
-import "./chunk-PF7L4BMG.js";
+} from "./chunk-5IHU5CUK.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/runtime/hooks/usePluginRuntime.ts
 import { useState, useEffect, useRef } from "react";
 
-// package.json
-var package_default = {
-  name: "@dreamboard-games/sdk",
-  version: "0.4.0-alpha.6",
-  description: "Dreamboard SDK package set metadata and public facade",
-  type: "module",
-  main: "./dist/index.js",
-  types: "./dist/index.d.ts",
-  exports: {
-    ".": {
-      types: "./dist/index.d.ts",
-      import: "./dist/index.js",
-      default: "./dist/index.js"
-    },
-    "./package-set": {
-      types: "./dist/package-set.d.ts",
-      import: "./dist/package-set.js",
-      default: "./dist/package-set.js"
-    },
-    "./types": {
-      types: "./dist/types.d.ts",
-      import: "./dist/types.js",
-      default: "./dist/types.js"
-    },
-    "./reducer": {
-      types: "./dist/reducer.d.ts",
-      import: "./dist/reducer.js",
-      default: "./dist/reducer.js"
-    },
-    "./reducer/advanced": {
-      types: "./dist/reducer/advanced.d.ts",
-      import: "./dist/reducer/advanced.js",
-      default: "./dist/reducer/advanced.js"
-    },
-    "./ui": {
-      types: "./dist/ui.d.ts",
-      import: "./dist/ui.js",
-      default: "./dist/ui.js"
-    },
-    "./ui/components": {
-      types: "./dist/ui/components.d.ts",
-      import: "./dist/ui/components.js",
-      default: "./dist/ui/components.js"
-    },
-    "./ui/defaults": {
-      types: "./dist/ui/defaults.d.ts",
-      import: "./dist/ui/defaults.js",
-      default: "./dist/ui/defaults.js"
-    },
-    "./ui/player-state": {
-      types: "./dist/ui/player-state.d.ts",
-      import: "./dist/ui/player-state.js",
-      default: "./dist/ui/player-state.js"
-    },
-    "./ui/plugin-styles.css": {
-      default: "./dist/ui/plugin-styles.css"
-    },
-    "./runtime": {
-      types: "./dist/runtime.d.ts",
-      import: "./dist/runtime.js",
-      default: "./dist/runtime.js"
-    },
-    "./runtime/primitives": {
-      types: "./dist/runtime/primitives.d.ts",
-      import: "./dist/runtime/primitives.js",
-      default: "./dist/runtime/primitives.js"
-    },
-    "./runtime/workspace-contract": {
-      types: "./dist/runtime/workspace-contract.d.ts",
-      import: "./dist/runtime/workspace-contract.js",
-      default: "./dist/runtime/workspace-contract.js"
-    },
-    "./runtime/runtime-api": {
-      types: "./dist/runtime/runtime-api.d.ts",
-      import: "./dist/runtime/runtime-api.js",
-      default: "./dist/runtime/runtime-api.js"
-    },
-    "./codegen": {
-      types: "./dist/codegen.d.ts",
-      import: "./dist/codegen.js",
-      default: "./dist/codegen.js"
-    },
-    "./authoring": {
-      types: "./dist/authoring/index.d.ts",
-      import: "./dist/authoring/index.js",
-      default: "./dist/authoring/index.js"
-    },
-    "./reducer-contract": {
-      types: "./dist/reducer-contract.d.ts",
-      import: "./dist/reducer-contract.js",
-      default: "./dist/reducer-contract.js"
-    },
-    "./testing": {
-      types: "./dist/testing.d.ts",
-      import: "./dist/testing.js",
-      default: "./dist/testing.js"
-    },
-    "./browser-interaction": {
-      bun: "./src/browser-interaction.ts",
-      types: "./dist/browser-interaction.d.ts",
-      import: "./dist/browser-interaction.js",
-      default: "./dist/browser-interaction.js"
-    },
-    "./package.json": "./package.json"
-  },
-  files: [
-    "LICENSE.md",
-    "dist",
-    "README.md",
-    "REFERENCE.md",
-    "!.turbo/**",
-    "!tsconfig.tsbuildinfo"
-  ],
-  scripts: {
-    build: "pnpm --dir ../.. --filter @dreamboard-games/plugin-runtime-contract build && pnpm --dir ../.. authoring-metadata:generate && tsup && node ../../scripts/copy-sdk-private-dts.mjs && mkdir -p dist/ui && tailwindcss -i src/ui/plugin-styles.css -o dist/ui/plugin-styles.css --minify",
-    typecheck: "tsc --noEmit",
-    lint: "eslint 'src/**/*.{ts,tsx}'",
-    storybook: "storybook dev -p 6006 --host 127.0.0.1 --no-open",
-    "storybook:build": "storybook build -o storybook-static",
-    "storybook:test": 'concurrently -k -s first -n storybook,test "http-server storybook-static -p 6006 -s --silent" "wait-on tcp:6006 && test-storybook --url http://127.0.0.1:6006"',
-    "storybook:test:visual": "playwright test --config .storybook/visual-runner.config.ts",
-    "storybook:test:visual:update": "playwright test --config .storybook/visual-runner.config.ts --update-snapshots",
-    test: "bun test src"
-  },
-  dependencies: {
-    "@radix-ui/react-accordion": "^1.2.14",
-    "@radix-ui/react-dialog": "^1.1.17",
-    "@radix-ui/react-label": "^2.1.10",
-    "@radix-ui/react-select": "^2.3.1",
-    "@radix-ui/react-slot": "^1.3.0",
-    "@radix-ui/react-tooltip": "^1.2.10",
-    "@use-gesture/react": "^10.3.1",
-    clsx: "^2.1.1",
-    "lucide-react": "^1.20.0",
-    vaul: "^1.1.2",
-    zustand: "^5.0.14"
-  },
-  devDependencies: {
-    "@dreamboard-games/plugin-runtime-contract": "workspace:*",
-    "@dreamboard-games/reducer-contract": "workspace:*",
-    "@dreamboard-games/sdk-types": "workspace:*",
-    "@dreamboard-games/workspace-codegen": "workspace:*",
-    "@happy-dom/global-registrator": "^20.9.0",
-    "@playwright/test": "1.60.0",
-    "@storybook/addon-a11y": "^10.4.6",
-    "@storybook/addon-themes": "^10.4.6",
-    "@storybook/react-vite": "^10.4.6",
-    "@storybook/test-runner": "^0.24.4",
-    "@tailwindcss/cli": "^4.3.1",
-    "@tailwindcss/vite": "^4.3.1",
-    "@types/node": "^24.5.2",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "axe-playwright": "2.2.2",
-    concurrently: "^9.1.0",
-    eslint: "^9.39.0",
-    "framer-motion": "^12.40.0",
-    "http-server": "^14.1.1",
-    playwright: "1.60.0",
-    react: "^19.2.0",
-    "react-dom": "^19.2.0",
-    storybook: "^10.4.6",
-    tailwindcss: "^4.3.1",
-    tsup: "^8.5.0",
-    typescript: "^5.9.2",
-    vite: "8.0.16",
-    "wait-on": "^8.0.1",
-    zod: "4.4.3"
-  },
-  peerDependencies: {
-    "framer-motion": "^11.0.0 || ^12.0.0",
-    react: "^19.0.0",
-    "react-dom": "^19.0.0",
-    zod: "^4.4.3"
-  },
-  publishConfig: {
-    access: "public"
-  },
-  repository: {
-    type: "git",
-    url: "git+https://github.com/dreamboard-games/dreamboard-sdk.git",
-    directory: "packages/sdk"
-  },
-  bugs: {
-    url: "https://github.com/dreamboard-games/dreamboard-sdk/issues"
-  },
-  homepage: "https://github.com/dreamboard-games/dreamboard-sdk#readme",
-  keywords: [
-    "dreamboard",
-    "sdk",
-    "package-set"
-  ],
-  license: "SEE LICENSE IN LICENSE.md"
-};
-
 // src/runtime/browser/post-message-transport.ts
 function createPostMessagePluginTransport(options = {}) {
   const targetWindow = options.targetWindow ?? window;
@@ -301,7 +111,7 @@ function createPostMessagePluginTransport(options = {}) {
 }
 
 // src/runtime/hooks/usePluginRuntime.ts
-var BUNDLED_SDK_VERSION = typeof package_default.version === "string" ? package_default.version : "unknown";
+var BUNDLED_SDK_VERSION = DREAMBOARD_SDK_VERSION;
 function hasProjectedView(runtime) {
   const frame = runtime.getFrame();
   return frame !== null && frame.view !== null && typeof frame.view !== "undefined";

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/runtime/hooks/usePluginRuntime.ts","../package.json","../src/runtime/browser/post-message-transport.ts","../src/runtime/components/PluginRuntime.tsx"],"sourcesContent":["import { useState, useEffect, useRef } from \"react\";\nimport packageJson from \"../../../package.json\";\nimport { createPostMessagePluginTransport } from \"../browser/post-message-transport.js\";\nimport { createPluginRuntimeClient } from \"../core/create-plugin-runtime-client.js\";\nimport type { PluginRuntimeClient } from \"../core/types.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\n\nconst BUNDLED_SDK_VERSION =\n  typeof packageJson.version === \"string\" ? packageJson.version : \"unknown\";\n\nexport interface UsePluginRuntimeOptions {\n  /**\n   * Timeout in milliseconds to wait for the first gameplay frame.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\nexport interface UsePluginRuntimeResult {\n  /** The transport-agnostic plugin runtime client. */\n  runtime: PluginRuntimeClient;\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(runtime: PluginRuntimeClient): boolean {\n  const frame = runtime.getFrame();\n  return (\n    frame !== null && frame.view !== null && typeof frame.view !== \"undefined\"\n  );\n}\n\n/**\n * Hook that creates and manages a PluginRuntimeClient instance.\n *\n * This hook handles:\n * 1. Creating the runtime client\n * 2. Waiting for the first gameplay frame 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, onDiagnostic } = options;\n  const [error, setError] = useState<string | null>(null);\n\n  // Create runtime once and keep stable reference\n  const [runtime] = useState<PluginRuntimeClient>(() =>\n    createPluginRuntimeClient({\n      transport: createPostMessagePluginTransport({\n        bundledSdkVersion: BUNDLED_SDK_VERSION,\n        onInvalidMessage: (reason, value) => {\n          const message =\n            `Plugin runtime rejected a host message (${reason}). ` +\n            `Bundled @dreamboard-games/sdk version: ${BUNDLED_SDK_VERSION}. ` +\n            \"The host and plugin bundle may have incompatible SDK/runtime contract versions.\";\n          setError(message);\n          onDiagnostic?.({\n            type: \"runtimeLog\",\n            level: \"warn\",\n            message,\n            details: [value],\n          });\n        },\n      }),\n    }),\n  );\n  const [isReady, setIsReady] = useState(() => hasProjectedView(runtime));\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  useEffect(() => {\n    void onDiagnostic;\n  }, [onDiagnostic]);\n\n  // Subscribe to gameplay frames and set isReady when the first projected view arrives.\n  useEffect(() => {\n    const markReadyFromFrame = () => {\n      if (!hasProjectedView(runtime)) {\n        return false;\n      }\n      setError(null);\n      setIsReady(true);\n      return true;\n    };\n\n    if (markReadyFromFrame()) {\n      return;\n    }\n\n    // Set up timeout\n    const timeoutId = setTimeout(() => {\n      if (!markReadyFromFrame()) {\n        setError(\n          `Timed out waiting for the initial projected view after ${timeout}ms. ` +\n            \"Ensure the host sends a gameplay frame with a seat view.\",\n        );\n      }\n    }, timeout);\n\n    // Fallback poll for dev/HMR flows where the runtime frame may already\n    // exist but the first subscribe callback is missed.\n    const pollId = setInterval(() => {\n      if (markReadyFromFrame()) {\n        clearInterval(pollId);\n        clearTimeout(timeoutId);\n      }\n    }, 100);\n\n    const unsubscribe = runtime.subscribeFrame(() => {\n      if (!hasProjectedView(runtime)) {\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","{\n  \"name\": \"@dreamboard-games/sdk\",\n  \"version\": \"0.4.0-alpha.6\",\n  \"description\": \"Dreamboard SDK package set metadata and public facade\",\n  \"type\": \"module\",\n  \"main\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./package-set\": {\n      \"types\": \"./dist/package-set.d.ts\",\n      \"import\": \"./dist/package-set.js\",\n      \"default\": \"./dist/package-set.js\"\n    },\n    \"./types\": {\n      \"types\": \"./dist/types.d.ts\",\n      \"import\": \"./dist/types.js\",\n      \"default\": \"./dist/types.js\"\n    },\n    \"./reducer\": {\n      \"types\": \"./dist/reducer.d.ts\",\n      \"import\": \"./dist/reducer.js\",\n      \"default\": \"./dist/reducer.js\"\n    },\n    \"./reducer/advanced\": {\n      \"types\": \"./dist/reducer/advanced.d.ts\",\n      \"import\": \"./dist/reducer/advanced.js\",\n      \"default\": \"./dist/reducer/advanced.js\"\n    },\n    \"./ui\": {\n      \"types\": \"./dist/ui.d.ts\",\n      \"import\": \"./dist/ui.js\",\n      \"default\": \"./dist/ui.js\"\n    },\n    \"./ui/components\": {\n      \"types\": \"./dist/ui/components.d.ts\",\n      \"import\": \"./dist/ui/components.js\",\n      \"default\": \"./dist/ui/components.js\"\n    },\n    \"./ui/defaults\": {\n      \"types\": \"./dist/ui/defaults.d.ts\",\n      \"import\": \"./dist/ui/defaults.js\",\n      \"default\": \"./dist/ui/defaults.js\"\n    },\n    \"./ui/player-state\": {\n      \"types\": \"./dist/ui/player-state.d.ts\",\n      \"import\": \"./dist/ui/player-state.js\",\n      \"default\": \"./dist/ui/player-state.js\"\n    },\n    \"./ui/plugin-styles.css\": {\n      \"default\": \"./dist/ui/plugin-styles.css\"\n    },\n    \"./runtime\": {\n      \"types\": \"./dist/runtime.d.ts\",\n      \"import\": \"./dist/runtime.js\",\n      \"default\": \"./dist/runtime.js\"\n    },\n    \"./runtime/primitives\": {\n      \"types\": \"./dist/runtime/primitives.d.ts\",\n      \"import\": \"./dist/runtime/primitives.js\",\n      \"default\": \"./dist/runtime/primitives.js\"\n    },\n    \"./runtime/workspace-contract\": {\n      \"types\": \"./dist/runtime/workspace-contract.d.ts\",\n      \"import\": \"./dist/runtime/workspace-contract.js\",\n      \"default\": \"./dist/runtime/workspace-contract.js\"\n    },\n    \"./runtime/runtime-api\": {\n      \"types\": \"./dist/runtime/runtime-api.d.ts\",\n      \"import\": \"./dist/runtime/runtime-api.js\",\n      \"default\": \"./dist/runtime/runtime-api.js\"\n    },\n    \"./codegen\": {\n      \"types\": \"./dist/codegen.d.ts\",\n      \"import\": \"./dist/codegen.js\",\n      \"default\": \"./dist/codegen.js\"\n    },\n    \"./authoring\": {\n      \"types\": \"./dist/authoring/index.d.ts\",\n      \"import\": \"./dist/authoring/index.js\",\n      \"default\": \"./dist/authoring/index.js\"\n    },\n    \"./reducer-contract\": {\n      \"types\": \"./dist/reducer-contract.d.ts\",\n      \"import\": \"./dist/reducer-contract.js\",\n      \"default\": \"./dist/reducer-contract.js\"\n    },\n    \"./testing\": {\n      \"types\": \"./dist/testing.d.ts\",\n      \"import\": \"./dist/testing.js\",\n      \"default\": \"./dist/testing.js\"\n    },\n    \"./browser-interaction\": {\n      \"bun\": \"./src/browser-interaction.ts\",\n      \"types\": \"./dist/browser-interaction.d.ts\",\n      \"import\": \"./dist/browser-interaction.js\",\n      \"default\": \"./dist/browser-interaction.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"LICENSE.md\",\n    \"dist\",\n    \"README.md\",\n    \"REFERENCE.md\",\n    \"!.turbo/**\",\n    \"!tsconfig.tsbuildinfo\"\n  ],\n  \"scripts\": {\n    \"build\": \"pnpm --dir ../.. --filter @dreamboard-games/plugin-runtime-contract build && pnpm --dir ../.. authoring-metadata:generate && tsup && node ../../scripts/copy-sdk-private-dts.mjs && mkdir -p dist/ui && tailwindcss -i src/ui/plugin-styles.css -o dist/ui/plugin-styles.css --minify\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"lint\": \"eslint 'src/**/*.{ts,tsx}'\",\n    \"storybook\": \"storybook dev -p 6006 --host 127.0.0.1 --no-open\",\n    \"storybook:build\": \"storybook build -o storybook-static\",\n    \"storybook:test\": \"concurrently -k -s first -n storybook,test \\\"http-server storybook-static -p 6006 -s --silent\\\" \\\"wait-on tcp:6006 && test-storybook --url http://127.0.0.1:6006\\\"\",\n    \"storybook:test:visual\": \"playwright test --config .storybook/visual-runner.config.ts\",\n    \"storybook:test:visual:update\": \"playwright test --config .storybook/visual-runner.config.ts --update-snapshots\",\n    \"test\": \"bun test src\"\n  },\n  \"dependencies\": {\n    \"@radix-ui/react-accordion\": \"^1.2.14\",\n    \"@radix-ui/react-dialog\": \"^1.1.17\",\n    \"@radix-ui/react-label\": \"^2.1.10\",\n    \"@radix-ui/react-select\": \"^2.3.1\",\n    \"@radix-ui/react-slot\": \"^1.3.0\",\n    \"@radix-ui/react-tooltip\": \"^1.2.10\",\n    \"@use-gesture/react\": \"^10.3.1\",\n    \"clsx\": \"^2.1.1\",\n    \"lucide-react\": \"^1.20.0\",\n    \"vaul\": \"^1.1.2\",\n    \"zustand\": \"^5.0.14\"\n  },\n  \"devDependencies\": {\n    \"@dreamboard-games/plugin-runtime-contract\": \"workspace:*\",\n    \"@dreamboard-games/reducer-contract\": \"workspace:*\",\n    \"@dreamboard-games/sdk-types\": \"workspace:*\",\n    \"@dreamboard-games/workspace-codegen\": \"workspace:*\",\n    \"@happy-dom/global-registrator\": \"^20.9.0\",\n    \"@playwright/test\": \"1.60.0\",\n    \"@storybook/addon-a11y\": \"^10.4.6\",\n    \"@storybook/addon-themes\": \"^10.4.6\",\n    \"@storybook/react-vite\": \"^10.4.6\",\n    \"@storybook/test-runner\": \"^0.24.4\",\n    \"@tailwindcss/cli\": \"^4.3.1\",\n    \"@tailwindcss/vite\": \"^4.3.1\",\n    \"@types/node\": \"^24.5.2\",\n    \"@types/react\": \"^19.0.0\",\n    \"@types/react-dom\": \"^19.0.0\",\n    \"axe-playwright\": \"2.2.2\",\n    \"concurrently\": \"^9.1.0\",\n    \"eslint\": \"^9.39.0\",\n    \"framer-motion\": \"^12.40.0\",\n    \"http-server\": \"^14.1.1\",\n    \"playwright\": \"1.60.0\",\n    \"react\": \"^19.2.0\",\n    \"react-dom\": \"^19.2.0\",\n    \"storybook\": \"^10.4.6\",\n    \"tailwindcss\": \"^4.3.1\",\n    \"tsup\": \"^8.5.0\",\n    \"typescript\": \"^5.9.2\",\n    \"vite\": \"8.0.16\",\n    \"wait-on\": \"^8.0.1\",\n    \"zod\": \"4.4.3\"\n  },\n  \"peerDependencies\": {\n    \"framer-motion\": \"^11.0.0 || ^12.0.0\",\n    \"react\": \"^19.0.0\",\n    \"react-dom\": \"^19.0.0\",\n    \"zod\": \"^4.4.3\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/dreamboard-games/dreamboard-sdk.git\",\n    \"directory\": \"packages/sdk\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/dreamboard-games/dreamboard-sdk/issues\"\n  },\n  \"homepage\": \"https://github.com/dreamboard-games/dreamboard-sdk#readme\",\n  \"keywords\": [\n    \"dreamboard\",\n    \"sdk\",\n    \"package-set\"\n  ],\n  \"license\": \"SEE LICENSE IN LICENSE.md\"\n}\n","import {\n  DREAMBOARD_PLUGIN_PROTOCOL,\n  DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n  HostToPluginEnvelopeSchema,\n  type HostToPluginEnvelope,\n  type PluginToHostPayload,\n} from \"@dreamboard-games/plugin-runtime-contract\";\nimport type { PluginTransport } from \"../core/types.js\";\n\nexport interface PostMessagePluginTransportOptions {\n  readonly targetWindow?: Window;\n  readonly parentWindow?: Window;\n  readonly bundledSdkVersion?: string;\n  readonly onInvalidMessage?: (reason: string, value: unknown) => void;\n}\n\nexport function createPostMessagePluginTransport(\n  options: PostMessagePluginTransportOptions = {},\n): PluginTransport {\n  const targetWindow = options.targetWindow ?? window;\n  const parentWindow = options.parentWindow ?? targetWindow.parent;\n  const bundledSdkVersion = options.bundledSdkVersion?.trim() || \"unknown\";\n  let channel: {\n    readonly channelId: string;\n    readonly hostOrigin: string;\n    readonly hostWindow: Window;\n  } | null = null;\n  let outboundSequence = 0;\n  let invalidEnvelopeReported = false;\n\n  const reportInvalidEnvelope = (reason: string, value: unknown) => {\n    options.onInvalidMessage?.(reason, value);\n\n    if (!channel || invalidEnvelopeReported) {\n      return;\n    }\n\n    invalidEnvelopeReported = true;\n    channel.hostWindow.postMessage(\n      {\n        protocol: DREAMBOARD_PLUGIN_PROTOCOL,\n        version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n        channelId: channel.channelId,\n        sequence: ++outboundSequence,\n        payload: {\n          type: \"runtime.error\",\n          code: \"host-runtime-protocol-mismatch\",\n          message:\n            `Plugin runtime rejected a host message (${reason}). ` +\n            `Bundled @dreamboard-games/sdk version: ${bundledSdkVersion}. ` +\n            \"The host and plugin bundle may have incompatible SDK/runtime contract versions.\",\n        },\n      },\n      channel.hostOrigin,\n    );\n  };\n\n  return {\n    start(onMessage) {\n      const handleMessage = (event: MessageEvent) => {\n        if (event.source !== parentWindow) {\n          return;\n        }\n        const parseResult = HostToPluginEnvelopeSchema.safeParse(event.data);\n        if (!parseResult.success) {\n          reportInvalidEnvelope(\"invalid-envelope\", event.data);\n          return;\n        }\n        const envelope = parseResult.data;\n        if (!channel) {\n          if (envelope.payload.type !== \"runtime.init\") {\n            return;\n          }\n          channel = {\n            channelId: envelope.channelId,\n            hostOrigin: event.origin,\n            hostWindow: event.source as Window,\n          };\n        }\n        if (\n          envelope.channelId !== channel.channelId ||\n          event.origin !== channel.hostOrigin ||\n          event.source !== channel.hostWindow\n        ) {\n          reportInvalidEnvelope(\"channel-mismatch\", event.data);\n          return;\n        }\n        onMessage(envelope as HostToPluginEnvelope);\n      };\n\n      targetWindow.addEventListener(\"message\", handleMessage);\n      return () => {\n        targetWindow.removeEventListener(\"message\", handleMessage);\n        channel = null;\n      };\n    },\n    send(payload: PluginToHostPayload) {\n      if (!channel) {\n        throw new Error(\"Plugin transport is not initialized.\");\n      }\n      channel.hostWindow.postMessage(\n        {\n          protocol: DREAMBOARD_PLUGIN_PROTOCOL,\n          version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n          channelId: channel.channelId,\n          sequence: ++outboundSequence,\n          payload,\n        },\n        channel.hostOrigin,\n      );\n    },\n  };\n}\n","import React from \"react\";\nimport { usePluginRuntime } from \"../hooks/usePluginRuntime.js\";\nimport { GameSkeleton } from \"../../ui.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\nimport { PluginRuntimeBoundary } from \"./PluginRuntimeBoundary.js\";\n\nexport interface PluginRuntimeProps {\n  /** Child components to render after gameplay frame has started */\n  children: React.ReactNode;\n  /**\n   * Timeout in milliseconds to wait for the first gameplay-frame snapshot.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  /** Custom loading component to show while waiting for gameplay frame */\n  loadingComponent?: React.ReactNode;\n  /** Custom error component to show when initialization fails */\n  errorComponent?: (error: string) => React.ReactNode;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\n/**\n * PluginRuntime provides the RuntimeContext for plugin components.\n *\n * This component:\n * - Creates a transport-backed runtime client\n * - Waits for the first projected gameplay frame before rendering children\n * - Provides runtime commands plus session/frame 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  onDiagnostic,\n}: PluginRuntimeProps) {\n  const { runtime, isReady, waiting, error } = usePluginRuntime({\n    timeout,\n    onDiagnostic,\n  });\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    <PluginRuntimeBoundary runtime={runtime}>{children}</PluginRuntimeBoundary>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/runtime/hooks/usePluginRuntime.ts","../src/runtime/browser/post-message-transport.ts","../src/runtime/components/PluginRuntime.tsx"],"sourcesContent":["import { useState, useEffect, useRef } from \"react\";\nimport { DREAMBOARD_SDK_VERSION } from \"../../package-set.js\";\nimport { createPostMessagePluginTransport } from \"../browser/post-message-transport.js\";\nimport { createPluginRuntimeClient } from \"../core/create-plugin-runtime-client.js\";\nimport type { PluginRuntimeClient } from \"../core/types.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\n\nconst BUNDLED_SDK_VERSION = DREAMBOARD_SDK_VERSION;\n\nexport interface UsePluginRuntimeOptions {\n  /**\n   * Timeout in milliseconds to wait for the first gameplay frame.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\nexport interface UsePluginRuntimeResult {\n  /** The transport-agnostic plugin runtime client. */\n  runtime: PluginRuntimeClient;\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(runtime: PluginRuntimeClient): boolean {\n  const frame = runtime.getFrame();\n  return (\n    frame !== null && frame.view !== null && typeof frame.view !== \"undefined\"\n  );\n}\n\n/**\n * Hook that creates and manages a PluginRuntimeClient instance.\n *\n * This hook handles:\n * 1. Creating the runtime client\n * 2. Waiting for the first gameplay frame 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, onDiagnostic } = options;\n  const [error, setError] = useState<string | null>(null);\n\n  // Create runtime once and keep stable reference\n  const [runtime] = useState<PluginRuntimeClient>(() =>\n    createPluginRuntimeClient({\n      transport: createPostMessagePluginTransport({\n        bundledSdkVersion: BUNDLED_SDK_VERSION,\n        onInvalidMessage: (reason, value) => {\n          const message =\n            `Plugin runtime rejected a host message (${reason}). ` +\n            `Bundled @dreamboard-games/sdk version: ${BUNDLED_SDK_VERSION}. ` +\n            \"The host and plugin bundle may have incompatible SDK/runtime contract versions.\";\n          setError(message);\n          onDiagnostic?.({\n            type: \"runtimeLog\",\n            level: \"warn\",\n            message,\n            details: [value],\n          });\n        },\n      }),\n    }),\n  );\n  const [isReady, setIsReady] = useState(() => hasProjectedView(runtime));\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  useEffect(() => {\n    void onDiagnostic;\n  }, [onDiagnostic]);\n\n  // Subscribe to gameplay frames and set isReady when the first projected view arrives.\n  useEffect(() => {\n    const markReadyFromFrame = () => {\n      if (!hasProjectedView(runtime)) {\n        return false;\n      }\n      setError(null);\n      setIsReady(true);\n      return true;\n    };\n\n    if (markReadyFromFrame()) {\n      return;\n    }\n\n    // Set up timeout\n    const timeoutId = setTimeout(() => {\n      if (!markReadyFromFrame()) {\n        setError(\n          `Timed out waiting for the initial projected view after ${timeout}ms. ` +\n            \"Ensure the host sends a gameplay frame with a seat view.\",\n        );\n      }\n    }, timeout);\n\n    // Fallback poll for dev/HMR flows where the runtime frame may already\n    // exist but the first subscribe callback is missed.\n    const pollId = setInterval(() => {\n      if (markReadyFromFrame()) {\n        clearInterval(pollId);\n        clearTimeout(timeoutId);\n      }\n    }, 100);\n\n    const unsubscribe = runtime.subscribeFrame(() => {\n      if (!hasProjectedView(runtime)) {\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 {\n  DREAMBOARD_PLUGIN_PROTOCOL,\n  DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n  HostToPluginEnvelopeSchema,\n  type HostToPluginEnvelope,\n  type PluginToHostPayload,\n} from \"@dreamboard-games/plugin-runtime-contract\";\nimport type { PluginTransport } from \"../core/types.js\";\n\nexport interface PostMessagePluginTransportOptions {\n  readonly targetWindow?: Window;\n  readonly parentWindow?: Window;\n  readonly bundledSdkVersion?: string;\n  readonly onInvalidMessage?: (reason: string, value: unknown) => void;\n}\n\nexport function createPostMessagePluginTransport(\n  options: PostMessagePluginTransportOptions = {},\n): PluginTransport {\n  const targetWindow = options.targetWindow ?? window;\n  const parentWindow = options.parentWindow ?? targetWindow.parent;\n  const bundledSdkVersion = options.bundledSdkVersion?.trim() || \"unknown\";\n  let channel: {\n    readonly channelId: string;\n    readonly hostOrigin: string;\n    readonly hostWindow: Window;\n  } | null = null;\n  let outboundSequence = 0;\n  let invalidEnvelopeReported = false;\n\n  const reportInvalidEnvelope = (reason: string, value: unknown) => {\n    options.onInvalidMessage?.(reason, value);\n\n    if (!channel || invalidEnvelopeReported) {\n      return;\n    }\n\n    invalidEnvelopeReported = true;\n    channel.hostWindow.postMessage(\n      {\n        protocol: DREAMBOARD_PLUGIN_PROTOCOL,\n        version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n        channelId: channel.channelId,\n        sequence: ++outboundSequence,\n        payload: {\n          type: \"runtime.error\",\n          code: \"host-runtime-protocol-mismatch\",\n          message:\n            `Plugin runtime rejected a host message (${reason}). ` +\n            `Bundled @dreamboard-games/sdk version: ${bundledSdkVersion}. ` +\n            \"The host and plugin bundle may have incompatible SDK/runtime contract versions.\",\n        },\n      },\n      channel.hostOrigin,\n    );\n  };\n\n  return {\n    start(onMessage) {\n      const handleMessage = (event: MessageEvent) => {\n        if (event.source !== parentWindow) {\n          return;\n        }\n        const parseResult = HostToPluginEnvelopeSchema.safeParse(event.data);\n        if (!parseResult.success) {\n          reportInvalidEnvelope(\"invalid-envelope\", event.data);\n          return;\n        }\n        const envelope = parseResult.data;\n        if (!channel) {\n          if (envelope.payload.type !== \"runtime.init\") {\n            return;\n          }\n          channel = {\n            channelId: envelope.channelId,\n            hostOrigin: event.origin,\n            hostWindow: event.source as Window,\n          };\n        }\n        if (\n          envelope.channelId !== channel.channelId ||\n          event.origin !== channel.hostOrigin ||\n          event.source !== channel.hostWindow\n        ) {\n          reportInvalidEnvelope(\"channel-mismatch\", event.data);\n          return;\n        }\n        onMessage(envelope as HostToPluginEnvelope);\n      };\n\n      targetWindow.addEventListener(\"message\", handleMessage);\n      return () => {\n        targetWindow.removeEventListener(\"message\", handleMessage);\n        channel = null;\n      };\n    },\n    send(payload: PluginToHostPayload) {\n      if (!channel) {\n        throw new Error(\"Plugin transport is not initialized.\");\n      }\n      channel.hostWindow.postMessage(\n        {\n          protocol: DREAMBOARD_PLUGIN_PROTOCOL,\n          version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n          channelId: channel.channelId,\n          sequence: ++outboundSequence,\n          payload,\n        },\n        channel.hostOrigin,\n      );\n    },\n  };\n}\n","import React from \"react\";\nimport { usePluginRuntime } from \"../hooks/usePluginRuntime.js\";\nimport { GameSkeleton } from \"../../ui.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\nimport { PluginRuntimeBoundary } from \"./PluginRuntimeBoundary.js\";\n\nexport interface PluginRuntimeProps {\n  /** Child components to render after gameplay frame has started */\n  children: React.ReactNode;\n  /**\n   * Timeout in milliseconds to wait for the first gameplay-frame snapshot.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  /** Custom loading component to show while waiting for gameplay frame */\n  loadingComponent?: React.ReactNode;\n  /** Custom error component to show when initialization fails */\n  errorComponent?: (error: string) => React.ReactNode;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\n/**\n * PluginRuntime provides the RuntimeContext for plugin components.\n *\n * This component:\n * - Creates a transport-backed runtime client\n * - Waits for the first projected gameplay frame before rendering children\n * - Provides runtime commands plus session/frame 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  onDiagnostic,\n}: PluginRuntimeProps) {\n  const { runtime, isReady, waiting, error } = usePluginRuntime({\n    timeout,\n    onDiagnostic,\n  });\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    <PluginRuntimeBoundary runtime={runtime}>{children}</PluginRuntimeBoundary>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/stale-contract-artifact-error-C5AaZPJ8.d.ts

@@ -0,0 +1,18 @@
+type StaleContractArtifactKind = "base-states" | "session-state";
+type StaleContractArtifactErrorOptions = {
+    artifact: StaleContractArtifactKind;
+    expected: string;
+    found: string;
+    remedy?: string;
+};
+declare class StaleContractArtifactError extends Error {
+    readonly code = "STALE_CONTRACT_ARTIFACT";
+    readonly artifact: StaleContractArtifactKind;
+    readonly expected: string;
+    readonly found: string;
+    readonly remedy: string;
+    constructor(options: StaleContractArtifactErrorOptions);
+}
+declare function isStaleContractArtifactError(error: unknown): error is StaleContractArtifactError;
+
+export { StaleContractArtifactError as S, type StaleContractArtifactErrorOptions as a, type StaleContractArtifactKind as b, isStaleContractArtifactError as i };

package/dist/testing-runtime.d.ts

@@ -0,0 +1,42 @@
+import { w as wire } from './index.d-DMASeF6M.js';
+import { a as BaseDefinition, S as ScenarioDefinition, R as ReducerScenarioBundle } from './types-DcADVHe9.js';
+import 'zod';
+import './diagnostics-1BWjRo6-.js';
+
+type BaseStateArtifact = {
+    readonly snapshot: wire.ReducerSessionState;
+    readonly fingerprint: {
+        readonly players: number;
+        readonly contractFingerprint?: string;
+    };
+};
+type CandidateVerificationBase = BaseStateArtifact | (BaseDefinition & Partial<BaseStateArtifact>);
+type CandidateVerificationScenario = ScenarioDefinition;
+type CandidateVerificationInput = {
+    readonly manifest?: unknown;
+    readonly bases: Readonly<Record<string, CandidateVerificationBase>> | readonly CandidateVerificationBase[];
+    readonly scenarios: Readonly<Record<string, CandidateVerificationScenario>> | readonly CandidateVerificationScenario[];
+    readonly reducer: ReducerScenarioBundle;
+    readonly maxScenarios?: number;
+    readonly maxStepsPerScenario?: number;
+};
+type CandidateVerificationScenarioResult = {
+    readonly id: string;
+    readonly status: "passed" | "failed";
+    readonly diagnostic?: {
+        readonly kind: "assertion";
+        readonly message: string;
+    };
+};
+type CandidateVerificationResult = {
+    readonly status: "passed" | "failed";
+    readonly scenarioSummary: {
+        readonly total: number;
+        readonly passed: number;
+        readonly failed: number;
+        readonly scenarios: readonly CandidateVerificationScenarioResult[];
+    };
+};
+declare function runCandidateVerification(input: CandidateVerificationInput): Promise<CandidateVerificationResult>;
+
+export { type CandidateVerificationBase, type CandidateVerificationInput, type CandidateVerificationResult, type CandidateVerificationScenario, type CandidateVerificationScenarioResult, runCandidateVerification };

package/dist/testing-runtime.js

@@ -0,0 +1,153 @@
+import {
+  createExpectApi,
+  createTestRuntime
+} from "./chunk-IU6KGPY7.js";
+import "./chunk-3OZMHZK3.js";
+import "./chunk-5IHU5CUK.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/testing-runtime.ts
+async function runCandidateVerification(input) {
+  const bases = normalizeBases(input.bases);
+  const scenarios = normalizeScenarios(input.scenarios);
+  const maxScenarios = input.maxScenarios ?? scenarios.length;
+  if (!Number.isInteger(maxScenarios) || maxScenarios < 1) {
+    throw new Error("maxScenarios must be a positive integer.");
+  }
+  if (scenarios.length > maxScenarios) {
+    throw new Error(
+      `Candidate verification contains ${scenarios.length} scenarios, exceeding limit ${maxScenarios}.`
+    );
+  }
+  const maxStepsPerScenario = input.maxStepsPerScenario ?? 1e3;
+  if (!Number.isInteger(maxStepsPerScenario) || maxStepsPerScenario < 1) {
+    throw new Error("maxStepsPerScenario must be a positive integer.");
+  }
+  const results = [];
+  for (const scenario of scenarios) {
+    results.push(
+      await runScenario({
+        bases,
+        reducer: input.reducer,
+        scenario,
+        maxStepsPerScenario
+      })
+    );
+  }
+  const failed = results.filter((result) => result.status === "failed").length;
+  return {
+    status: failed === 0 ? "passed" : "failed",
+    scenarioSummary: {
+      total: results.length,
+      passed: results.length - failed,
+      failed,
+      scenarios: results
+    }
+  };
+}
+async function runScenario(input) {
+  const runtime = createTestRuntime({
+    baseId: input.scenario.from,
+    baseStates: input.bases,
+    bundle: input.reducer,
+    phase: input.scenario.phase,
+    playerIds: input.bases[input.scenario.from]?.snapshot.domain?.flow?.activePlayers
+  });
+  const ctx = createScenarioContext(runtime, input.maxStepsPerScenario);
+  try {
+    await input.scenario.when(ctx);
+    await input.scenario.then(ctx);
+    return { id: input.scenario.id, status: "passed" };
+  } catch (error) {
+    return {
+      id: input.scenario.id,
+      status: "failed",
+      diagnostic: {
+        kind: "assertion",
+        message: boundedMessage(error)
+      }
+    };
+  }
+}
+function createScenarioContext(runtime, maxStepsPerScenario) {
+  let submittedSteps = 0;
+  const baseContext = {
+    game: {
+      start: async () => void 0,
+      submit: async (...args) => {
+        submittedSteps += 1;
+        if (submittedSteps > maxStepsPerScenario) {
+          throw new Error(
+            `Scenario exceeded maxStepsPerScenario limit ${maxStepsPerScenario}.`
+          );
+        }
+        return runtime.submit(...args);
+      }
+    },
+    players: runtime.players,
+    seat: runtime.seat
+  };
+  return {
+    ...baseContext,
+    state: () => runtime.getFrame().flow.currentPhase ?? "",
+    view: (playerId) => {
+      const frame = runtime.getFrame();
+      if (frame.perspectivePlayerId === playerId) return frame.view;
+      return runtime.getFrame().view;
+    },
+    interactions: (playerId) => {
+      const frame = runtime.getFrame();
+      if (frame.perspectivePlayerId !== playerId) return [];
+      return frame.availableInteractions;
+    },
+    explain: runtime.explain,
+    diagnostics: runtime.diagnostics,
+    expect: createExpectApi({
+      lastDiagnosticRejection: () => {
+        for (let index = runtime.diagnostics.events.length - 1; index >= 0; index -= 1) {
+          const event = runtime.diagnostics.events[index];
+          if (event?.type === "submitRejected") return event;
+        }
+        return null;
+      }
+    })
+  };
+}
+function normalizeBases(input) {
+  const entries = Array.isArray(input) ? input.map((base) => [base.id, base]) : Object.entries(input);
+  return Object.fromEntries(
+    entries.map(([id, base]) => {
+      if (!id) throw new Error("Candidate verification base id is required.");
+      if (!("snapshot" in base) || !base.snapshot) {
+        throw new Error(`Candidate verification base '${id}' has no snapshot.`);
+      }
+      const players = base.fingerprint?.players ?? base.players ?? base.snapshot.domain?.flow?.activePlayers?.length ?? 1;
+      return [
+        id,
+        {
+          snapshot: base.snapshot,
+          fingerprint: {
+            players,
+            contractFingerprint: base.fingerprint?.contractFingerprint
+          }
+        }
+      ];
+    })
+  );
+}
+function normalizeScenarios(input) {
+  const scenarios = Array.isArray(input) ? input : Object.values(input);
+  return scenarios.map((scenario) => {
+    if (!scenario.id)
+      throw new Error("Candidate verification scenario id is required.");
+    return scenario;
+  });
+}
+function boundedMessage(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return message.slice(0, 2e3);
+}
+export {
+  runCandidateVerification
+};
+//# sourceMappingURL=testing-runtime.js.map

package/dist/testing-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing-runtime.ts"],"sourcesContent":["import type { Wire } from \"@dreamboard-games/reducer-contract\";\nimport { createExpectApi } from \"./testing/create-expect-api.js\";\nimport { createTestRuntime } from \"./testing/create-test-runtime.js\";\nimport type {\n  BaseContext,\n  BaseDefinition,\n  InteractionDescriptorLike,\n  ScenarioDefinition,\n  SharedScenarioContext,\n} from \"./testing/definitions.js\";\nimport type { ReducerScenarioBundle } from \"./testing/reducer-scenario/types.js\";\n\ntype BaseStateArtifact = {\n  readonly snapshot: Wire.ReducerSessionState;\n  readonly fingerprint: {\n    readonly players: number;\n    readonly contractFingerprint?: string;\n  };\n};\n\nexport type CandidateVerificationBase =\n  | BaseStateArtifact\n  | (BaseDefinition & Partial<BaseStateArtifact>);\n\nexport type CandidateVerificationScenario = ScenarioDefinition;\n\nexport type CandidateVerificationInput = {\n  readonly manifest?: unknown;\n  readonly bases:\n    | Readonly<Record<string, CandidateVerificationBase>>\n    | readonly CandidateVerificationBase[];\n  readonly scenarios:\n    | Readonly<Record<string, CandidateVerificationScenario>>\n    | readonly CandidateVerificationScenario[];\n  readonly reducer: ReducerScenarioBundle;\n  readonly maxScenarios?: number;\n  readonly maxStepsPerScenario?: number;\n};\n\nexport type CandidateVerificationScenarioResult = {\n  readonly id: string;\n  readonly status: \"passed\" | \"failed\";\n  readonly diagnostic?: {\n    readonly kind: \"assertion\";\n    readonly message: string;\n  };\n};\n\nexport type CandidateVerificationResult = {\n  readonly status: \"passed\" | \"failed\";\n  readonly scenarioSummary: {\n    readonly total: number;\n    readonly passed: number;\n    readonly failed: number;\n    readonly scenarios: readonly CandidateVerificationScenarioResult[];\n  };\n};\n\nexport async function runCandidateVerification(\n  input: CandidateVerificationInput,\n): Promise<CandidateVerificationResult> {\n  const bases = normalizeBases(input.bases);\n  const scenarios = normalizeScenarios(input.scenarios);\n  const maxScenarios = input.maxScenarios ?? scenarios.length;\n  if (!Number.isInteger(maxScenarios) || maxScenarios < 1) {\n    throw new Error(\"maxScenarios must be a positive integer.\");\n  }\n  if (scenarios.length > maxScenarios) {\n    throw new Error(\n      `Candidate verification contains ${scenarios.length} scenarios, exceeding limit ${maxScenarios}.`,\n    );\n  }\n  const maxStepsPerScenario = input.maxStepsPerScenario ?? 1000;\n  if (!Number.isInteger(maxStepsPerScenario) || maxStepsPerScenario < 1) {\n    throw new Error(\"maxStepsPerScenario must be a positive integer.\");\n  }\n\n  const results: CandidateVerificationScenarioResult[] = [];\n  for (const scenario of scenarios) {\n    results.push(\n      await runScenario({\n        bases,\n        reducer: input.reducer,\n        scenario,\n        maxStepsPerScenario,\n      }),\n    );\n  }\n  const failed = results.filter((result) => result.status === \"failed\").length;\n  return {\n    status: failed === 0 ? \"passed\" : \"failed\",\n    scenarioSummary: {\n      total: results.length,\n      passed: results.length - failed,\n      failed,\n      scenarios: results,\n    },\n  };\n}\n\nasync function runScenario(input: {\n  bases: Readonly<Record<string, BaseStateArtifact>>;\n  reducer: ReducerScenarioBundle;\n  scenario: CandidateVerificationScenario;\n  maxStepsPerScenario: number;\n}): Promise<CandidateVerificationScenarioResult> {\n  const runtime = createTestRuntime({\n    baseId: input.scenario.from,\n    baseStates: input.bases,\n    bundle: input.reducer,\n    phase: input.scenario.phase,\n    playerIds:\n      input.bases[input.scenario.from]?.snapshot.domain?.flow?.activePlayers,\n  });\n  const ctx = createScenarioContext(runtime, input.maxStepsPerScenario);\n  try {\n    await input.scenario.when(ctx);\n    await input.scenario.then(ctx);\n    return { id: input.scenario.id, status: \"passed\" };\n  } catch (error) {\n    return {\n      id: input.scenario.id,\n      status: \"failed\",\n      diagnostic: {\n        kind: \"assertion\",\n        message: boundedMessage(error),\n      },\n    };\n  }\n}\n\nfunction createScenarioContext(\n  runtime: ReturnType<typeof createTestRuntime>,\n  maxStepsPerScenario: number,\n): SharedScenarioContext {\n  let submittedSteps = 0;\n  const baseContext: BaseContext = {\n    game: {\n      start: async () => undefined,\n      submit: async (...args) => {\n        submittedSteps += 1;\n        if (submittedSteps > maxStepsPerScenario) {\n          throw new Error(\n            `Scenario exceeded maxStepsPerScenario limit ${maxStepsPerScenario}.`,\n          );\n        }\n        return runtime.submit(...args);\n      },\n    },\n    players: runtime.players,\n    seat: runtime.seat,\n  };\n  return {\n    ...baseContext,\n    state: () => runtime.getFrame().flow.currentPhase ?? \"\",\n    view: (playerId) => {\n      const frame = runtime.getFrame();\n      if (frame.perspectivePlayerId === playerId) return frame.view;\n      return runtime.getFrame().view;\n    },\n    interactions: (playerId) => {\n      const frame = runtime.getFrame();\n      if (frame.perspectivePlayerId !== playerId) return [];\n      return frame.availableInteractions as unknown as readonly InteractionDescriptorLike[];\n    },\n    explain: runtime.explain,\n    diagnostics: runtime.diagnostics,\n    expect: createExpectApi({\n      lastDiagnosticRejection: () => {\n        for (\n          let index = runtime.diagnostics.events.length - 1;\n          index >= 0;\n          index -= 1\n        ) {\n          const event = runtime.diagnostics.events[index];\n          if (event?.type === \"submitRejected\") return event;\n        }\n        return null;\n      },\n    }),\n  };\n}\n\nfunction normalizeBases(\n  input:\n    | Readonly<Record<string, CandidateVerificationBase>>\n    | readonly CandidateVerificationBase[],\n): Record<string, BaseStateArtifact> {\n  const entries = Array.isArray(input)\n    ? input.map((base) => [base.id, base] as const)\n    : Object.entries(input);\n  return Object.fromEntries(\n    entries.map(([id, base]) => {\n      if (!id) throw new Error(\"Candidate verification base id is required.\");\n      if (!(\"snapshot\" in base) || !base.snapshot) {\n        throw new Error(`Candidate verification base '${id}' has no snapshot.`);\n      }\n      const players =\n        base.fingerprint?.players ??\n        base.players ??\n        base.snapshot.domain?.flow?.activePlayers?.length ??\n        1;\n      return [\n        id,\n        {\n          snapshot: base.snapshot,\n          fingerprint: {\n            players,\n            contractFingerprint: base.fingerprint?.contractFingerprint,\n          },\n        },\n      ];\n    }),\n  );\n}\n\nfunction normalizeScenarios(\n  input:\n    | Readonly<Record<string, CandidateVerificationScenario>>\n    | readonly CandidateVerificationScenario[],\n): CandidateVerificationScenario[] {\n  const scenarios = Array.isArray(input) ? input : Object.values(input);\n  return scenarios.map((scenario) => {\n    if (!scenario.id)\n      throw new Error(\"Candidate verification scenario id is required.\");\n    return scenario;\n  });\n}\n\nfunction boundedMessage(error: unknown): string {\n  const message = error instanceof Error ? error.message : String(error);\n  return message.slice(0, 2000);\n}\n"],"mappings":"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","names":[]}