@eigeninteractive/testkit 0.2.4 → 0.3.0

package/README.md

@@ -4,7 +4,7 @@ Test helpers for games built on the
 [EigenInteractive engine](https://eigeninteractive.com).
 
 Drive a game's rules through the real kernel with no Worker, no database and no
-network — and run the shared JSON fixtures that keep the TypeScript and Dart
+network, and run the shared JSON fixtures that keep the TypeScript and Dart
 halves of a game from drifting apart.
 
 ```ts

package/bin/eigen-inspect.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/inspect-cli.js";

package/dist/{chunk-3TFZTVPB.js → chunk-JJW4WLTM.js}

@@ -1,5 +1,5 @@
 // src/twin-fixtures.ts
-import { readdirSync, readFileSync } from "fs";
+import { readdirSync, readFileSync } from "node:fs";
 import { IllegalMoveError } from "@eigeninteractive/rules";
 import Rand from "rand-seed";
 import { it } from "vitest";
@@ -118,7 +118,7 @@ function evaluateTwinCase(rules, kase) {
     case "botSeatable":
       return evaluateBotSeatable(rules, kase);
     default:
-      return [`unknown case kind "${kase.kind}" \u2014 expected action | ratingPool | botSeatable`];
+      return [`unknown case kind "${kase.kind}", expected action | ratingPool | botSeatable`];
   }
 }
 function twinFixtureTests(gameModule, fixturesRoot) {
@@ -155,7 +155,7 @@ function evaluateAction(rules, kase) {
     return failures;
   }
   if (!deepEquals(action, kase.action)) {
-    failures.push(`action schema does not preserve the fixture action \u2014 parsed to ${JSON.stringify(action)}`);
+    failures.push(`action schema does not preserve the fixture action, parsed to ${JSON.stringify(action)}`);
   }
   const envelope = applyFixtureAction(rules, kase, config, state, action);
   if (typeof envelope === "string") {
@@ -193,13 +193,13 @@ function checkEnvelope(rules, kase, envelope, failures) {
   }
   const expected = kase.expected;
   if (expected.state !== void 0 && !deepEquals(envelope.state, expected.state)) {
-    failures.push(`envelope.state mismatch \u2014 got ${JSON.stringify(envelope.state)}`);
+    failures.push(`envelope.state mismatch, got ${JSON.stringify(envelope.state)}`);
   }
   if (expected.pending !== void 0 && !deepEquals(envelope.pendingPlayers, expected.pending)) {
-    failures.push(`envelope.pendingPlayers mismatch \u2014 got ${JSON.stringify(envelope.pendingPlayers)}`);
+    failures.push(`envelope.pendingPlayers mismatch, got ${JSON.stringify(envelope.pendingPlayers)}`);
   }
   if ("outcome" in expected && !deepEquals(envelope.outcome ?? null, expected.outcome ?? null)) {
-    failures.push(`envelope.outcome mismatch \u2014 got ${JSON.stringify(envelope.outcome ?? null)}`);
+    failures.push(`envelope.outcome mismatch, got ${JSON.stringify(envelope.outcome ?? null)}`);
   }
 }
 function checkObservation(rules, kase, envelope, config, action, failures) {
@@ -219,7 +219,7 @@ function checkObservation(rules, kase, envelope, config, action, failures) {
     return;
   }
   if (!deepEquals(slice.data, kase.expected.observation)) {
-    failures.push(`actor's observation mismatch \u2014 got ${JSON.stringify(slice.data)}`);
+    failures.push(`actor's observation mismatch, got ${JSON.stringify(slice.data)}`);
   }
 }
 function evaluateRatingPool(rules, kase) {
@@ -256,7 +256,7 @@ function evaluateBotSeatable(rules, kase) {
 function validate(rules, which, value, issues) {
   const result = rules.schemas[which]["~standard"].validate(value);
   if (result instanceof Promise) {
-    issues?.push(`${which} schema validated asynchronously \u2014 must be sync`);
+    issues?.push(`${which} schema validated asynchronously; must be sync`);
     return void 0;
   }
   if (result.issues) {
@@ -296,8 +296,8 @@ function deepEquals(a, b) {
 }
 
 // src/game-contract.ts
-import { existsSync, readdirSync as readdirSync2, readFileSync as readFileSync2, writeFileSync } from "fs";
-import { basename, relative, resolve } from "path";
+import { existsSync, readdirSync as readdirSync2, readFileSync as readFileSync2, writeFileSync } from "node:fs";
+import { basename, relative, resolve } from "node:path";
 var GAME_CONTRACT_FORMAT_VERSION = 1;
 function canonical(value) {
   if (Array.isArray(value)) return value.map(canonical);
@@ -396,9 +396,9 @@ function checkGameContract(options) {
 var gameContractFilename = (game) => `${basename(game).toLowerCase().replaceAll(/[^a-z0-9]+/g, "-")}-game-contract.json`;
 
 // src/contract-command.ts
-import { readFileSync as readFileSync3 } from "fs";
-import { resolve as resolve2 } from "path";
-import { pathToFileURL } from "url";
+import { readFileSync as readFileSync3 } from "node:fs";
+import { resolve as resolve2 } from "node:path";
+import { pathToFileURL } from "node:url";
 import { tsImport } from "tsx/esm/api";
 function configuredString(value, fallback, field) {
   if (value === void 0) return fallback;
@@ -450,4 +450,4 @@ export {
   emitConfiguredGameContract,
   checkConfiguredGameContract
 };
-//# sourceMappingURL=chunk-3TFZTVPB.js.map
+//# sourceMappingURL=chunk-JJW4WLTM.js.map

package/dist/chunk-JJW4WLTM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/twin-fixtures.ts","../src/game-contract.ts","../src/contract-command.ts"],"sourcesContent":["/**\n * Twin-drift fixture runner: the TS half of the shared JSON fixtures that\n * keep a version unit's TS and Dart `GameRules` twins in sync. The JSON\n * fixture format is shared verbatim with the Dart runner\n * (`lib/testing/twin_fixtures.dart`): one file, two consumers.\n *\n * One fixture file per concern lives beside the version units at\n * `<fixturesRoot>/v<N>/*.json` and is consumed by BOTH sides: this module\n * runs each case against the TS unit (schemas + `applyAction` +\n * `computeObservation` + the two predicates), while the Dart runner runs the\n * same file against the Dart twin (generated payload parsing,\n * `isValidAction`, `previewAction`, predicate twins). A behavioral divergence\n * then fails one side's CI instead of degrading UX in production.\n *\n * ## Fixture file format\n *\n * ```jsonc\n * {\n *   \"schemaVersion\": 1,\n *   \"cases\": [\n *     {\n *       \"kind\": \"action\",\n *       \"name\": \"seat 0 marks an empty cell\",\n *       \"config\": {},\n *       \"state\": { ... },            // TS: applyAction input\n *       \"obs\": { ... },              // Dart-only; defaults to `state`\n *       \"pending\": [0],\n *       \"playerIndex\": 0,\n *       \"participantCount\": 2,       // optional, default 2\n *       \"rngSeed\": \"any string\",     // optional, default \"twin-fixtures\"\n *       \"action\": { ... },\n *       \"expected\": {\n *         \"valid\": true,             // false ⇒ TS IllegalMoveError,\n *                                    //         Dart isValidAction false\n *         \"state\": { ... },          // optional, TS envelope.state\n *         \"pending\": [1],            // optional, TS envelope.pendingPlayers\n *         \"outcome\": [ ... ],        // optional, TS envelope.outcome\n *                                    //   (null asserts the game is ongoing)\n *         \"observation\": { ... }     // optional, the actor's post-action\n *                                    //   view: TS computeObservation slice\n *                                    //   data; Dart previewAction (when the\n *                                    //   game implements optimism)\n *       }\n *     },\n *     { \"kind\": \"ratingPool\",  \"name\": \"...\", \"access\": \"public\",\n *       \"minPlayers\": 2, \"maxPlayers\": 2, \"config\": {}, \"expected\": \"blitz\" },\n *     { \"kind\": \"botSeatable\", \"name\": \"...\", \"gameConfig\": {},\n *       \"botConfig\": {}, \"expected\": false }\n *   ]\n * }\n * ```\n *\n * The `state`/`obs` split exists for hidden-info games (a seat's observation\n * is not the state); perfect-info games omit `obs`. `expected.observation` is\n * the shared behavioral anchor: the TS side must project the post-action\n * state to it, and a Dart `previewAction` that returns non-null must predict\n * it, so the two sides are compared through one recorded value.\n *\n * Wire it up in a game-owned test file running under plain-Node vitest:\n *\n * ```ts\n * import { twinFixtureTests } from \"@eigeninteractive/testkit\";\n * import gameModule from \"../src/module/index.js\";\n *\n * twinFixtureTests(gameModule, new URL(\"../src/module/fixtures/\", import.meta.url));\n * ```\n */\n\nimport { readdirSync, readFileSync } from \"node:fs\";\nimport { type Envelope, type GameAccess, type GameModule, type GameRules, IllegalMoveError, type Json, type JsonObject, type ObservationSlice, type OutcomeEntry } from \"@eigeninteractive/rules\";\nimport Rand from \"rand-seed\";\nimport { it } from \"vitest\";\n\n/** One fixture file: cases targeting one `schemaVersion` unit. */\nexport interface TwinFixtureFile {\n  schemaVersion: number;\n  cases: TwinFixtureCase[];\n}\n\n/** A game-action case: exercises schemas, `applyAction`, and (through\n * `expected.observation`) `computeObservation` for the acting seat. */\nexport interface ActionCase {\n  kind: \"action\";\n  name: string;\n  config: JsonObject;\n  state: JsonObject;\n  /** Dart-side observation payload; unused here (defaults to `state`). */\n  obs?: JsonObject;\n  pending: number[];\n  playerIndex: number;\n  participantCount?: number;\n  rngSeed?: string;\n  action: JsonObject;\n  expected: {\n    valid: boolean;\n    state?: JsonObject;\n    pending?: number[];\n    outcome?: OutcomeEntry[] | null;\n    observation?: JsonObject;\n  };\n}\n\n/** A `ratingPool` predicate case. Omitted timing fields mean null. */\nexport interface RatingPoolCase {\n  kind: \"ratingPool\";\n  name: string;\n  access: GameAccess;\n  turnSeconds?: number | null;\n  budgetSeconds?: number | null;\n  incrementSeconds?: number | null;\n  minPlayers: number;\n  maxPlayers: number;\n  config: JsonObject;\n  expected: string | null;\n}\n\n/** A `botSeatable` predicate case. */\nexport interface BotSeatableCase {\n  kind: \"botSeatable\";\n  name: string;\n  gameConfig: JsonObject;\n  botConfig: JsonObject;\n  expected: boolean;\n}\n\nexport type TwinFixtureCase = ActionCase | RatingPoolCase | BotSeatableCase;\n\n// ── Fixture validation ────────────────────────────────────────────────────────\n//\n// The case types above are compile-time only; the JSON they describe arrives\n// at runtime from a hand-written file. Asserting `JSON.parse(...) as\n// TwinFixtureFile` would make every field a lie the moment a fixture is\n// mistyped, and because most fields flow straight into a comparison, the\n// symptom would be a confusing `undefined` diff attributed to the game's\n// rules rather than to the fixture. These parsers close that gap: a\n// malformed fixture fails at LOAD, naming the file, the case, and the field.\n//\n// Hand-written rather than schema-library-backed on purpose: `@eigeninteractive/rules`\n// describes an implementor's schemas with `StandardSchemaV1` precisely so the\n// engine never mandates a validation library, and the Dart twin runner is\n// deliberately framework-free. This is ~80 lines and keeps both true.\n\nfunction describe(value: unknown): string {\n  if (value === null) return \"null\";\n  if (Array.isArray(value)) return \"an array\";\n  return typeof value;\n}\n\nfunction fail(where: string, expected: string, got: unknown): never {\n  throw new Error(`${where}: expected ${expected}, got ${describe(got)}`);\n}\n\nfunction asObject(where: string, v: unknown): JsonObject {\n  if (typeof v !== \"object\" || v === null || Array.isArray(v)) fail(where, \"an object\", v);\n  return v as JsonObject;\n}\n\nfunction asString(where: string, v: unknown): string {\n  if (typeof v !== \"string\") fail(where, \"a string\", v);\n  return v;\n}\n\nfunction asNumber(where: string, v: unknown): number {\n  if (typeof v !== \"number\" || !Number.isFinite(v)) fail(where, \"a finite number\", v);\n  return v;\n}\n\nfunction asBoolean(where: string, v: unknown): boolean {\n  if (typeof v !== \"boolean\") fail(where, \"a boolean\", v);\n  return v;\n}\n\nfunction asNumberArray(where: string, v: unknown): number[] {\n  if (!Array.isArray(v)) fail(where, \"an array of numbers\", v);\n  return v.map((n, i) => asNumber(`${where}[${i}]`, n));\n}\n\n/** Applies `read` only when the key is present and non-null; absent and\n * explicit null both mean \"not specified\" for every optional fixture field. */\nfunction optional<T>(where: string, v: unknown, read: (where: string, v: unknown) => T): T | undefined {\n  return v === undefined || v === null ? undefined : read(where, v);\n}\n\nfunction parseActionCase(where: string, raw: JsonObject): ActionCase {\n  const expectedRaw = asObject(`${where}.expected`, raw.expected);\n  const expected: ActionCase[\"expected\"] = {\n    valid: asBoolean(`${where}.expected.valid`, expectedRaw.valid),\n    state: optional(`${where}.expected.state`, expectedRaw.state, asObject),\n    pending: optional(`${where}.expected.pending`, expectedRaw.pending, asNumberArray),\n    observation: optional(`${where}.expected.observation`, expectedRaw.observation, asObject),\n  };\n  // `outcome` is three-valued: absent (unchecked), null (asserts the game is\n  // ongoing), or a list. `checkEnvelope` distinguishes absent from null with\n  // an `in` test, so the key must only be set when the fixture set it.\n  if (\"outcome\" in expectedRaw) {\n    const outcome = expectedRaw.outcome;\n    if (outcome !== null && !Array.isArray(outcome)) fail(`${where}.expected.outcome`, \"an array or null\", outcome);\n    expected.outcome = outcome as OutcomeEntry[] | null;\n  }\n  return {\n    kind: \"action\",\n    name: asString(`${where}.name`, raw.name),\n    config: asObject(`${where}.config`, raw.config),\n    state: asObject(`${where}.state`, raw.state),\n    obs: optional(`${where}.obs`, raw.obs, asObject),\n    pending: asNumberArray(`${where}.pending`, raw.pending),\n    playerIndex: asNumber(`${where}.playerIndex`, raw.playerIndex),\n    participantCount: optional(`${where}.participantCount`, raw.participantCount, asNumber),\n    rngSeed: optional(`${where}.rngSeed`, raw.rngSeed, asString),\n    action: asObject(`${where}.action`, raw.action),\n    expected,\n  };\n}\n\nfunction parseRatingPoolCase(where: string, raw: JsonObject): RatingPoolCase {\n  const access = asString(`${where}.access`, raw.access);\n  if (access !== \"public\" && access !== \"private\" && access !== \"friends\") {\n    throw new Error(`${where}.access: expected one of public | private | friends, got ${JSON.stringify(access)}`);\n  }\n  return {\n    kind: \"ratingPool\",\n    name: asString(`${where}.name`, raw.name),\n    access,\n    turnSeconds: optional(`${where}.turnSeconds`, raw.turnSeconds, asNumber) ?? null,\n    budgetSeconds: optional(`${where}.budgetSeconds`, raw.budgetSeconds, asNumber) ?? null,\n    incrementSeconds: optional(`${where}.incrementSeconds`, raw.incrementSeconds, asNumber) ?? null,\n    minPlayers: asNumber(`${where}.minPlayers`, raw.minPlayers),\n    maxPlayers: asNumber(`${where}.maxPlayers`, raw.maxPlayers),\n    config: asObject(`${where}.config`, raw.config),\n    expected: raw.expected === null ? null : asString(`${where}.expected`, raw.expected),\n  };\n}\n\nfunction parseBotSeatableCase(where: string, raw: JsonObject): BotSeatableCase {\n  return {\n    kind: \"botSeatable\",\n    name: asString(`${where}.name`, raw.name),\n    gameConfig: asObject(`${where}.gameConfig`, raw.gameConfig),\n    botConfig: asObject(`${where}.botConfig`, raw.botConfig),\n    expected: asBoolean(`${where}.expected`, raw.expected),\n  };\n}\n\n/** Validate one fixture file's parsed JSON, or throw naming the offending\n * file, case, and field. Exported so a repo can lint its fixtures without\n * running them. */\nexport function parseTwinFixtureFile(path: string, json: unknown): TwinFixtureFile {\n  const root = asObject(path, json);\n  const schemaVersion = asNumber(`${path}.schemaVersion`, root.schemaVersion);\n  if (!Array.isArray(root.cases)) fail(`${path}.cases`, \"an array\", root.cases);\n  const cases = root.cases.map((raw, i) => {\n    // Prefer the case's own name in the location once we can read it: a\n    // fixture author finds \"cases[3] (seat 0 wins)\" faster than an index.\n    const indexed = `${path}.cases[${i}]`;\n    const obj = asObject(indexed, raw);\n    const where = typeof obj.name === \"string\" ? `${indexed} (${obj.name})` : indexed;\n    switch (obj.kind) {\n      case \"action\":\n        return parseActionCase(where, obj);\n      case \"ratingPool\":\n        return parseRatingPoolCase(where, obj);\n      case \"botSeatable\":\n        return parseBotSeatableCase(where, obj);\n      default:\n        throw new Error(`${where}.kind: expected one of action | ratingPool | botSeatable, got ${JSON.stringify(obj.kind)}`);\n    }\n  });\n  return { schemaVersion, cases };\n}\n\n/** Run one fixture case against a rules unit, returning failure descriptions\n * (empty ⇒ the case passes). Pure; the file-reading test registrar is\n * {@link twinFixtureTests}. */\nexport function evaluateTwinCase(rules: GameRules, kase: TwinFixtureCase): string[] {\n  switch (kase.kind) {\n    case \"action\":\n      return evaluateAction(rules, kase);\n    case \"ratingPool\":\n      return evaluateRatingPool(rules, kase);\n    case \"botSeatable\":\n      return evaluateBotSeatable(rules, kase);\n    default:\n      return [`unknown case kind \"${(kase as { kind: string }).kind}\", expected action | ratingPool | botSeatable`];\n  }\n}\n\n/** Register one vitest test per fixture case found under `fixturesRoot`\n * (layout: `<root>/v<N>/*.json`). Call at the top level of a test module\n * running in a Node environment. */\nexport function twinFixtureTests(gameModule: GameModule, fixturesRoot: string | URL): void {\n  for (const filePath of fixtureFiles(fixturesRoot)) {\n    const fixture = parseTwinFixtureFile(filePath, JSON.parse(readFileSync(filePath, \"utf8\")));\n    const rules = gameModule.versions[fixture.schemaVersion];\n    for (const kase of fixture.cases) {\n      it(`twin v${fixture.schemaVersion}: ${kase.name}`, () => {\n        if (!rules) {\n          throw new Error(`gameModule ships no rules unit for schemaVersion ${fixture.schemaVersion} (fixture: ${filePath})`);\n        }\n        const failures = evaluateTwinCase(rules, kase);\n        if (failures.length) throw new Error(`\\n${failures.join(\"\\n\")}`);\n      });\n    }\n  }\n}\n\nfunction* fixtureFiles(root: string | URL): Generator<string> {\n  const dirs = readdirSync(root, { withFileTypes: true })\n    .filter((e) => e.isDirectory())\n    .sort((a, b) => a.name.localeCompare(b.name));\n  for (const dir of dirs) {\n    const files = readdirSync(`${dir.parentPath}/${dir.name}`, {\n      withFileTypes: true,\n    })\n      .filter((e) => e.isFile() && e.name.endsWith(\".json\"))\n      .sort((a, b) => a.name.localeCompare(b.name));\n    for (const file of files) yield `${file.parentPath}/${file.name}`;\n  }\n}\n\n// ── Case evaluators ───────────────────────────────────────────────────────────\n\nfunction evaluateAction(rules: GameRules, kase: ActionCase): string[] {\n  const failures: string[] = [];\n  const config = parseWith(rules, \"config\", kase.config, failures);\n  const state = parseWith(rules, \"state\", kase.state, failures);\n  const action = parseWith(rules, \"action\", kase.action, failures);\n  if (config === undefined || state === undefined || action === undefined) {\n    return failures;\n  }\n\n  // The parsed action must be the fixture action: a schema that strips or\n  // defaults fields the twin relies on is itself drift.\n  if (!deepEquals(action, kase.action)) {\n    failures.push(`action schema does not preserve the fixture action, parsed to ${JSON.stringify(action)}`);\n  }\n\n  const envelope = applyFixtureAction(rules, kase, config, state, action);\n  if (typeof envelope === \"string\") {\n    if (envelope) failures.push(envelope);\n    return failures;\n  }\n  checkEnvelope(rules, kase, envelope, failures);\n  if (kase.expected.observation !== undefined) {\n    checkObservation(rules, kase, envelope, config, action, failures);\n  }\n  return failures;\n}\n\n/** Invoke `applyAction` and reconcile with `expected.valid`. Returns the\n * envelope on a valid accepted move, an error string on failure, or \"\" when\n * an expected-illegal move was correctly rejected (nothing left to check). */\nfunction applyFixtureAction(rules: GameRules, kase: ActionCase, config: JsonObject, state: JsonObject, action: JsonObject): Envelope | string {\n  let envelope: Envelope;\n  try {\n    envelope = rules.applyAction({\n      state,\n      pending: kase.pending,\n      data: action,\n      playerIndex: kase.playerIndex,\n      rng: new Rand(kase.rngSeed ?? \"twin-fixtures\"),\n      config,\n    });\n  } catch (error) {\n    if (!(error instanceof IllegalMoveError)) {\n      return `applyAction threw a non-IllegalMoveError: ${error}`;\n    }\n    return kase.expected.valid ? `applyAction rejected a move the fixture expects to be valid: ${error.message}` : \"\";\n  }\n  return kase.expected.valid ? envelope : \"applyAction accepted a move the fixture expects to be illegal\";\n}\n\nfunction checkEnvelope(rules: GameRules, kase: ActionCase, envelope: Envelope, failures: string[]): void {\n  if (validate(rules, \"state\", envelope.state) === undefined) {\n    failures.push(\"applyAction returned state that violates its own schema\");\n  }\n  const expected = kase.expected;\n  if (expected.state !== undefined && !deepEquals(envelope.state, expected.state)) {\n    failures.push(`envelope.state mismatch, got ${JSON.stringify(envelope.state)}`);\n  }\n  if (expected.pending !== undefined && !deepEquals(envelope.pendingPlayers, expected.pending)) {\n    failures.push(`envelope.pendingPlayers mismatch, got ${JSON.stringify(envelope.pendingPlayers)}`);\n  }\n  if (\"outcome\" in expected && !deepEquals(envelope.outcome ?? null, expected.outcome ?? null)) {\n    failures.push(`envelope.outcome mismatch, got ${JSON.stringify(envelope.outcome ?? null)}`);\n  }\n}\n\nfunction checkObservation(rules: GameRules, kase: ActionCase, envelope: Envelope, config: JsonObject, action: JsonObject, failures: string[]): void {\n  let slice: ObservationSlice;\n  try {\n    slice = rules.computeObservation({\n      state: envelope.state,\n      pending: envelope.pendingPlayers,\n      playerIndex: kase.playerIndex,\n      participantCount: kase.participantCount ?? 2,\n      config,\n      cause: { kind: \"game\", data: action, playerIndex: kase.playerIndex },\n      isReplay: false,\n    });\n  } catch (error) {\n    failures.push(`computeObservation threw: ${error}`);\n    return;\n  }\n  if (!deepEquals(slice.data, kase.expected.observation as Json)) {\n    failures.push(`actor's observation mismatch, got ${JSON.stringify(slice.data)}`);\n  }\n}\n\nfunction evaluateRatingPool(rules: GameRules, kase: RatingPoolCase): string[] {\n  const failures: string[] = [];\n  const config = parseWith(rules, \"config\", kase.config, failures);\n  if (config === undefined) return failures;\n  const pool = rules.ratingPool({\n    access: kase.access,\n    turnSeconds: kase.turnSeconds ?? null,\n    budgetSeconds: kase.budgetSeconds ?? null,\n    incrementSeconds: kase.incrementSeconds ?? null,\n    minPlayers: kase.minPlayers,\n    maxPlayers: kase.maxPlayers,\n    config,\n  });\n  if (pool !== kase.expected) {\n    failures.push(`ratingPool returned ${JSON.stringify(pool)}, fixture expects ${JSON.stringify(kase.expected)}`);\n  }\n  return failures;\n}\n\nfunction evaluateBotSeatable(rules: GameRules, kase: BotSeatableCase): string[] {\n  const failures: string[] = [];\n  const gameConfig = parseWith(rules, \"config\", kase.gameConfig, failures);\n  if (gameConfig === undefined) return failures;\n  const seatable = rules.botSeatable({\n    gameConfig,\n    botConfig: kase.botConfig,\n  });\n  if (seatable !== kase.expected) {\n    failures.push(`botSeatable returned ${seatable}, fixture expects ${kase.expected}`);\n  }\n  return failures;\n}\n\n// ── Helpers ───────────────────────────────────────────────────────────────────\n\n/** Run one of the unit's Standard Schemas synchronously, returning the parsed\n * value or undefined on failure (issues written to the second return slot). */\nfunction validate(rules: GameRules, which: \"config\" | \"state\" | \"action\", value: unknown, issues?: string[]): JsonObject | undefined {\n  const result = rules.schemas[which][\"~standard\"].validate(value);\n  if (result instanceof Promise) {\n    issues?.push(`${which} schema validated asynchronously; must be sync`);\n    return undefined;\n  }\n  if (result.issues) {\n    issues?.push(\n      result.issues\n        .map((i) => {\n          const path = i.path?.map((p) => (typeof p === \"object\" ? String(p.key) : String(p))).join(\".\");\n          return path ? `${path}: ${i.message}` : i.message;\n        })\n        .join(\"; \"),\n    );\n    return undefined;\n  }\n  return result.value as JsonObject;\n}\n\n/** Parse a fixture payload through one of the unit's schemas, recording a\n * failure (and returning undefined) when it does not conform. */\nfunction parseWith(rules: GameRules, which: \"config\" | \"state\" | \"action\", value: JsonObject, failures: string[]): JsonObject | undefined {\n  const issues: string[] = [];\n  const parsed = validate(rules, which, value, issues);\n  if (parsed === undefined) {\n    failures.push(`fixture ${which} fails the TS ${which} schema: ${issues.join(\"; \")}`);\n  }\n  return parsed;\n}\n\n/** Structural JSON equality. Object keys with `undefined` values count as\n * absent (matching how schema libraries model optional fields); array order\n * matters. */\nexport function deepEquals(a: Json | undefined, b: Json | undefined): boolean {\n  if (a === undefined || a === null) return b === undefined || b === null;\n  if (b === undefined || b === null) return false;\n  if (Array.isArray(a) || Array.isArray(b)) {\n    if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) {\n      return false;\n    }\n    return a.every((item, i) => deepEquals(item, b[i]));\n  }\n  if (typeof a === \"object\" || typeof b === \"object\") {\n    if (typeof a !== \"object\" || typeof b !== \"object\") return false;\n    const keys = new Set([...Object.keys(a), ...Object.keys(b)]);\n    return [...keys].every((k) => deepEquals((a as JsonObject)[k], (b as JsonObject)[k]));\n  }\n  return a === b;\n}\n","/**\n * Emit the language-neutral contract a game's Flutter repository consumes.\n *\n * The authoritative inputs live with the TypeScript rules: the four payload\n * schemas and the shared behavioral fixtures. The output is one deterministic\n * JSON file so it can be copied, attached to a release, or fetched by checksum\n * without assuming any repository layout.\n */\n\nimport { existsSync, readdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { basename, relative, resolve } from \"node:path\";\nimport type { GameModule, StandardJSONSchemaV1 } from \"@eigeninteractive/rules\";\nimport { parseTwinFixtureFile } from \"./twin-fixtures.js\";\n\n/** Current format of the language-neutral contract consumed by EigenInteractive's Dart generator. */\nexport const GAME_CONTRACT_FORMAT_VERSION = 1;\n\n/** One validated twin-fixture document embedded in a {@link GameContract}. */\nexport interface GameContractFixture {\n  /** POSIX-style path relative to the supplied fixtures root. */\n  path: string;\n  /** Validated fixture document, retained in its original JSON shape. */\n  document: unknown;\n}\n\n/** The four JSON Schemas emitted for one game `schemaVersion`. */\nexport interface GameContractVersion {\n  schemas: {\n    state: Record<string, unknown>;\n    observation: Record<string, unknown>;\n    action: Record<string, unknown>;\n    config: Record<string, unknown>;\n  };\n}\n\n/** Language-neutral schemas and fixtures shared by a game's Worker and app. */\nexport interface GameContract {\n  formatVersion: typeof GAME_CONTRACT_FORMAT_VERSION;\n  game: string;\n  versions: Record<string, GameContractVersion>;\n  fixtures: GameContractFixture[];\n}\n\n/** Inputs for building a {@link GameContract} without writing it. */\nexport interface BuildGameContractOptions {\n  /** Stable display name used as the generated Dart type prefix. */\n  game: string;\n  /** Authoritative TypeScript rules registry. */\n  gameModule: GameModule;\n  /** Root containing `v<N>/*.json` twin fixtures. */\n  fixturesRoot?: string | URL;\n}\n\n/** Inputs for emitting or checking a {@link GameContract} file. */\nexport interface EmitGameContractOptions extends BuildGameContractOptions {\n  /** Destination `game-contract.json` path. */\n  output: string | URL;\n}\n\nfunction canonical(value: unknown): unknown {\n  if (Array.isArray(value)) return value.map(canonical);\n  if (value !== null && typeof value === \"object\") {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>)\n        .sort(([a], [b]) => a.localeCompare(b))\n        .map(([key, item]) => [key, canonical(item)]),\n    );\n  }\n  return value;\n}\n\nfunction jsonSchema(schema: StandardJSONSchemaV1, label: string, direction: \"input\" | \"output\"): Record<string, unknown> {\n  const options = { target: \"draft-2020-12\" as const };\n  try {\n    return canonical(schema[\"~standard\"].jsonSchema[direction](options)) as Record<string, unknown>;\n  } catch (error) {\n    throw new Error(`${label} cannot emit its ${direction} type as draft-2020-12 JSON Schema`, { cause: error });\n  }\n}\n\nfunction fixtureFiles(root: string): string[] {\n  const found: string[] = [];\n  const visit = (directory: string): void => {\n    for (const entry of readdirSync(directory, { withFileTypes: true })) {\n      const path = resolve(directory, entry.name);\n      if (entry.isDirectory()) visit(path);\n      else if (entry.isFile() && entry.name.endsWith(\".json\")) found.push(path);\n    }\n  };\n  visit(root);\n  return found.sort();\n}\n\nfunction fixtures(fixturesRoot: string | URL | undefined, versions: ReadonlySet<string>): GameContractFixture[] {\n  if (fixturesRoot === undefined) return [];\n  const root = fixturesRoot instanceof URL ? fixturesRoot.pathname : resolve(fixturesRoot);\n  return fixtureFiles(root).map((path) => {\n    const document = JSON.parse(readFileSync(path, \"utf8\")) as unknown;\n    const fixture = parseTwinFixtureFile(path, document);\n    const fixturePath = relative(root, path).split(\"\\\\\").join(\"/\");\n    const directory = fixturePath.split(\"/\")[0];\n    const match = /^v([1-9]\\d*)$/.exec(directory ?? \"\");\n    if (match === null) {\n      throw new Error(`${fixturePath}: fixtures must live under a v<N>/ directory`);\n    }\n    const pathVersion = Number(match[1]);\n    if (pathVersion !== fixture.schemaVersion) {\n      throw new Error(`${fixturePath}: directory v${pathVersion} disagrees with schemaVersion ${fixture.schemaVersion}`);\n    }\n    if (!versions.has(String(fixture.schemaVersion))) {\n      throw new Error(`${fixturePath}: gameModule ships no rules unit for schemaVersion ${fixture.schemaVersion}`);\n    }\n    return {\n      path: fixturePath,\n      document: canonical(document),\n    };\n  });\n}\n\n/** Build a deterministic in-memory contract without touching the filesystem. */\nexport function buildGameContract(options: BuildGameContractOptions): GameContract {\n  const game = options.game.trim();\n  if (game.length === 0) throw new Error(\"game contract name must not be empty\");\n\n  const versions = Object.fromEntries(\n    Object.entries(options.gameModule.versions)\n      .sort(([a], [b]) => Number(a) - Number(b))\n      .map(([version, rules]) => [\n        version,\n        {\n          schemas: {\n            state: jsonSchema(rules.schemas.state, `v${version} state`, \"output\"),\n            observation: jsonSchema(rules.schemas.observation, `v${version} observation`, \"output\"),\n            action: jsonSchema(rules.schemas.action, `v${version} action`, \"input\"),\n            config: jsonSchema(rules.schemas.config, `v${version} config`, \"output\"),\n          },\n        },\n      ]),\n  );\n\n  if (Object.keys(versions).length === 0) {\n    throw new Error(\"game contract must contain at least one schema version\");\n  }\n\n  return {\n    formatVersion: GAME_CONTRACT_FORMAT_VERSION,\n    game,\n    versions,\n    fixtures: fixtures(options.fixturesRoot, new Set(Object.keys(versions))),\n  };\n}\n\n/** Render one deterministic, newline-terminated contract document. */\nexport function gameContractJson(options: BuildGameContractOptions): string {\n  return `${JSON.stringify(buildGameContract(options), null, 2)}\\n`;\n}\n\n/** Emit one deterministic, newline-terminated `game-contract.json`. */\nexport function emitGameContract(options: EmitGameContractOptions): void {\n  const output = options.output instanceof URL ? options.output : resolve(options.output);\n  writeFileSync(output, gameContractJson(options));\n}\n\n/** Fail when an emitted contract is missing or differs from its inputs. */\nexport function checkGameContract(options: EmitGameContractOptions): void {\n  const output = options.output instanceof URL ? options.output : resolve(options.output);\n  if (!existsSync(output) || readFileSync(output, \"utf8\") !== gameContractJson(options)) {\n    throw new Error(`${output.toString()} is stale; run eigen-contract`);\n  }\n}\n\n/** A useful default filename for scripts that accept an output directory. */\nexport const gameContractFilename = (game: string): string =>\n  `${basename(game)\n    .toLowerCase()\n    .replaceAll(/[^a-z0-9]+/g, \"-\")}-game-contract.json`;\n","import { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport type { GameModule } from \"@eigeninteractive/rules\";\nimport { tsImport } from \"tsx/esm/api\";\nimport { checkGameContract, emitGameContract } from \"./game-contract.js\";\n\ninterface EigenPackageConfig {\n  game?: unknown;\n  module?: unknown;\n  fixtures?: unknown;\n  contract?: unknown;\n}\n\ninterface PackageManifest {\n  eigen?: EigenPackageConfig;\n}\n\nfunction configuredString(value: unknown, fallback: string, field: string): string {\n  if (value === undefined) return fallback;\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new Error(`package.json eigen.${field} must be a non-empty string`);\n  }\n  return value;\n}\n\nconst isGameModule = (value: unknown): value is GameModule => value !== null && typeof value === \"object\" && \"versions\" in value && value.versions !== null && typeof value.versions === \"object\";\n\n/**\n * Emit a contract from the conventional game package layout.\n *\n * The package default-exports its GameModule from `src/module/index.ts` and\n * declares `{ \"eigen\": { \"game\": \"…\" } }` in package.json. Paths can be\n * overridden under the same `eigen` object.\n */\nasync function configuredGameContractOptions(root: string) {\n  const manifest = JSON.parse(readFileSync(resolve(root, \"package.json\"), \"utf8\")) as PackageManifest;\n  const config = manifest.eigen ?? {};\n  const game = configuredString(config.game, \"\", \"game\");\n  if (game.length === 0) {\n    throw new Error('package.json must declare an EigenInteractive game name, e.g. \"eigen\": { \"game\": \"Chess\" }');\n  }\n\n  const modulePath = configuredString(config.module, \"src/module/index.ts\", \"module\");\n  const fixturesPath = configuredString(config.fixtures, \"src/module/fixtures\", \"fixtures\");\n  const contractPath = configuredString(config.contract, \"game-contract.json\", \"contract\");\n  const imported = (await tsImport(pathToFileURL(resolve(root, modulePath)).href, import.meta.url)) as { default?: unknown };\n\n  if (!isGameModule(imported.default)) {\n    throw new Error(`${modulePath} must default-export an EigenInteractive GameModule`);\n  }\n\n  return {\n    game,\n    gameModule: imported.default,\n    fixturesRoot: resolve(root, fixturesPath),\n    output: resolve(root, contractPath),\n  };\n}\n\n/**\n * Emits `game-contract.json` from an EigenInteractive package's conventional layout.\n *\n * This is the programmatic form of the `eigen-contract` executable. Most\n * games should invoke the executable through their package script.\n */\nexport async function emitConfiguredGameContract(root = process.cwd()): Promise<void> {\n  emitGameContract(await configuredGameContractOptions(root));\n}\n\n/**\n * Fails when the conventionally configured contract is absent or stale.\n *\n * Use this in CI through `eigen-contract --check`.\n */\nexport async function checkConfiguredGameContract(root = process.cwd()): Promise<void> {\n  checkGameContract(await configuredGameContractOptions(root));\n}\n"],"mappings":";AAoEA,SAAS,aAAa,oBAAoB;AAC1C,SAA0E,wBAA8F;AACxK,OAAO,UAAU;AACjB,SAAS,UAAU;AAuEnB,SAAS,SAAS,OAAwB;AACxC,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AACjC,SAAO,OAAO;AAChB;AAEA,SAAS,KAAK,OAAe,UAAkB,KAAqB;AAClE,QAAM,IAAI,MAAM,GAAG,KAAK,cAAc,QAAQ,SAAS,SAAS,GAAG,CAAC,EAAE;AACxE;AAEA,SAAS,SAAS,OAAe,GAAwB;AACvD,MAAI,OAAO,MAAM,YAAY,MAAM,QAAQ,MAAM,QAAQ,CAAC,EAAG,MAAK,OAAO,aAAa,CAAC;AACvF,SAAO;AACT;AAEA,SAAS,SAAS,OAAe,GAAoB;AACnD,MAAI,OAAO,MAAM,SAAU,MAAK,OAAO,YAAY,CAAC;AACpD,SAAO;AACT;AAEA,SAAS,SAAS,OAAe,GAAoB;AACnD,MAAI,OAAO,MAAM,YAAY,CAAC,OAAO,SAAS,CAAC,EAAG,MAAK,OAAO,mBAAmB,CAAC;AAClF,SAAO;AACT;AAEA,SAAS,UAAU,OAAe,GAAqB;AACrD,MAAI,OAAO,MAAM,UAAW,MAAK,OAAO,aAAa,CAAC;AACtD,SAAO;AACT;AAEA,SAAS,cAAc,OAAe,GAAsB;AAC1D,MAAI,CAAC,MAAM,QAAQ,CAAC,EAAG,MAAK,OAAO,uBAAuB,CAAC;AAC3D,SAAO,EAAE,IAAI,CAAC,GAAG,MAAM,SAAS,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC;AACtD;AAIA,SAAS,SAAY,OAAe,GAAY,MAAuD;AACrG,SAAO,MAAM,UAAa,MAAM,OAAO,SAAY,KAAK,OAAO,CAAC;AAClE;AAEA,SAAS,gBAAgB,OAAe,KAA6B;AACnE,QAAM,cAAc,SAAS,GAAG,KAAK,aAAa,IAAI,QAAQ;AAC9D,QAAM,WAAmC;AAAA,IACvC,OAAO,UAAU,GAAG,KAAK,mBAAmB,YAAY,KAAK;AAAA,IAC7D,OAAO,SAAS,GAAG,KAAK,mBAAmB,YAAY,OAAO,QAAQ;AAAA,IACtE,SAAS,SAAS,GAAG,KAAK,qBAAqB,YAAY,SAAS,aAAa;AAAA,IACjF,aAAa,SAAS,GAAG,KAAK,yBAAyB,YAAY,aAAa,QAAQ;AAAA,EAC1F;AAIA,MAAI,aAAa,aAAa;AAC5B,UAAM,UAAU,YAAY;AAC5B,QAAI,YAAY,QAAQ,CAAC,MAAM,QAAQ,OAAO,EAAG,MAAK,GAAG,KAAK,qBAAqB,oBAAoB,OAAO;AAC9G,aAAS,UAAU;AAAA,EACrB;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,SAAS,GAAG,KAAK,SAAS,IAAI,IAAI;AAAA,IACxC,QAAQ,SAAS,GAAG,KAAK,WAAW,IAAI,MAAM;AAAA,IAC9C,OAAO,SAAS,GAAG,KAAK,UAAU,IAAI,KAAK;AAAA,IAC3C,KAAK,SAAS,GAAG,KAAK,QAAQ,IAAI,KAAK,QAAQ;AAAA,IAC/C,SAAS,cAAc,GAAG,KAAK,YAAY,IAAI,OAAO;AAAA,IACtD,aAAa,SAAS,GAAG,KAAK,gBAAgB,IAAI,WAAW;AAAA,IAC7D,kBAAkB,SAAS,GAAG,KAAK,qBAAqB,IAAI,kBAAkB,QAAQ;AAAA,IACtF,SAAS,SAAS,GAAG,KAAK,YAAY,IAAI,SAAS,QAAQ;AAAA,IAC3D,QAAQ,SAAS,GAAG,KAAK,WAAW,IAAI,MAAM;AAAA,IAC9C;AAAA,EACF;AACF;AAEA,SAAS,oBAAoB,OAAe,KAAiC;AAC3E,QAAM,SAAS,SAAS,GAAG,KAAK,WAAW,IAAI,MAAM;AACrD,MAAI,WAAW,YAAY,WAAW,aAAa,WAAW,WAAW;AACvE,UAAM,IAAI,MAAM,GAAG,KAAK,4DAA4D,KAAK,UAAU,MAAM,CAAC,EAAE;AAAA,EAC9G;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,SAAS,GAAG,KAAK,SAAS,IAAI,IAAI;AAAA,IACxC;AAAA,IACA,aAAa,SAAS,GAAG,KAAK,gBAAgB,IAAI,aAAa,QAAQ,KAAK;AAAA,IAC5E,eAAe,SAAS,GAAG,KAAK,kBAAkB,IAAI,eAAe,QAAQ,KAAK;AAAA,IAClF,kBAAkB,SAAS,GAAG,KAAK,qBAAqB,IAAI,kBAAkB,QAAQ,KAAK;AAAA,IAC3F,YAAY,SAAS,GAAG,KAAK,eAAe,IAAI,UAAU;AAAA,IAC1D,YAAY,SAAS,GAAG,KAAK,eAAe,IAAI,UAAU;AAAA,IAC1D,QAAQ,SAAS,GAAG,KAAK,WAAW,IAAI,MAAM;AAAA,IAC9C,UAAU,IAAI,aAAa,OAAO,OAAO,SAAS,GAAG,KAAK,aAAa,IAAI,QAAQ;AAAA,EACrF;AACF;AAEA,SAAS,qBAAqB,OAAe,KAAkC;AAC7E,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,SAAS,GAAG,KAAK,SAAS,IAAI,IAAI;AAAA,IACxC,YAAY,SAAS,GAAG,KAAK,eAAe,IAAI,UAAU;AAAA,IAC1D,WAAW,SAAS,GAAG,KAAK,cAAc,IAAI,SAAS;AAAA,IACvD,UAAU,UAAU,GAAG,KAAK,aAAa,IAAI,QAAQ;AAAA,EACvD;AACF;AAKO,SAAS,qBAAqB,MAAc,MAAgC;AACjF,QAAM,OAAO,SAAS,MAAM,IAAI;AAChC,QAAM,gBAAgB,SAAS,GAAG,IAAI,kBAAkB,KAAK,aAAa;AAC1E,MAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,EAAG,MAAK,GAAG,IAAI,UAAU,YAAY,KAAK,KAAK;AAC5E,QAAM,QAAQ,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM;AAGvC,UAAM,UAAU,GAAG,IAAI,UAAU,CAAC;AAClC,UAAM,MAAM,SAAS,SAAS,GAAG;AACjC,UAAM,QAAQ,OAAO,IAAI,SAAS,WAAW,GAAG,OAAO,KAAK,IAAI,IAAI,MAAM;AAC1E,YAAQ,IAAI,MAAM;AAAA,MAChB,KAAK;AACH,eAAO,gBAAgB,OAAO,GAAG;AAAA,MACnC,KAAK;AACH,eAAO,oBAAoB,OAAO,GAAG;AAAA,MACvC,KAAK;AACH,eAAO,qBAAqB,OAAO,GAAG;AAAA,MACxC;AACE,cAAM,IAAI,MAAM,GAAG,KAAK,iEAAiE,KAAK,UAAU,IAAI,IAAI,CAAC,EAAE;AAAA,IACvH;AAAA,EACF,CAAC;AACD,SAAO,EAAE,eAAe,MAAM;AAChC;AAKO,SAAS,iBAAiB,OAAkB,MAAiC;AAClF,UAAQ,KAAK,MAAM;AAAA,IACjB,KAAK;AACH,aAAO,eAAe,OAAO,IAAI;AAAA,IACnC,KAAK;AACH,aAAO,mBAAmB,OAAO,IAAI;AAAA,IACvC,KAAK;AACH,aAAO,oBAAoB,OAAO,IAAI;AAAA,IACxC;AACE,aAAO,CAAC,sBAAuB,KAA0B,IAAI,+CAA+C;AAAA,EAChH;AACF;AAKO,SAAS,iBAAiB,YAAwB,cAAkC;AACzF,aAAW,YAAY,aAAa,YAAY,GAAG;AACjD,UAAM,UAAU,qBAAqB,UAAU,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC,CAAC;AACzF,UAAM,QAAQ,WAAW,SAAS,QAAQ,aAAa;AACvD,eAAW,QAAQ,QAAQ,OAAO;AAChC,SAAG,SAAS,QAAQ,aAAa,KAAK,KAAK,IAAI,IAAI,MAAM;AACvD,YAAI,CAAC,OAAO;AACV,gBAAM,IAAI,MAAM,oDAAoD,QAAQ,aAAa,cAAc,QAAQ,GAAG;AAAA,QACpH;AACA,cAAM,WAAW,iBAAiB,OAAO,IAAI;AAC7C,YAAI,SAAS,OAAQ,OAAM,IAAI,MAAM;AAAA,EAAK,SAAS,KAAK,IAAI,CAAC,EAAE;AAAA,MACjE,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEA,UAAU,aAAa,MAAuC;AAC5D,QAAM,OAAO,YAAY,MAAM,EAAE,eAAe,KAAK,CAAC,EACnD,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,EAC7B,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAC9C,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,YAAY,GAAG,IAAI,UAAU,IAAI,IAAI,IAAI,IAAI;AAAA,MACzD,eAAe;AAAA,IACjB,CAAC,EACE,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,EAAE,KAAK,SAAS,OAAO,CAAC,EACpD,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAC9C,eAAW,QAAQ,MAAO,OAAM,GAAG,KAAK,UAAU,IAAI,KAAK,IAAI;AAAA,EACjE;AACF;AAIA,SAAS,eAAe,OAAkB,MAA4B;AACpE,QAAM,WAAqB,CAAC;AAC5B,QAAM,SAAS,UAAU,OAAO,UAAU,KAAK,QAAQ,QAAQ;AAC/D,QAAM,QAAQ,UAAU,OAAO,SAAS,KAAK,OAAO,QAAQ;AAC5D,QAAM,SAAS,UAAU,OAAO,UAAU,KAAK,QAAQ,QAAQ;AAC/D,MAAI,WAAW,UAAa,UAAU,UAAa,WAAW,QAAW;AACvE,WAAO;AAAA,EACT;AAIA,MAAI,CAAC,WAAW,QAAQ,KAAK,MAAM,GAAG;AACpC,aAAS,KAAK,iEAAiE,KAAK,UAAU,MAAM,CAAC,EAAE;AAAA,EACzG;AAEA,QAAM,WAAW,mBAAmB,OAAO,MAAM,QAAQ,OAAO,MAAM;AACtE,MAAI,OAAO,aAAa,UAAU;AAChC,QAAI,SAAU,UAAS,KAAK,QAAQ;AACpC,WAAO;AAAA,EACT;AACA,gBAAc,OAAO,MAAM,UAAU,QAAQ;AAC7C,MAAI,KAAK,SAAS,gBAAgB,QAAW;AAC3C,qBAAiB,OAAO,MAAM,UAAU,QAAQ,QAAQ,QAAQ;AAAA,EAClE;AACA,SAAO;AACT;AAKA,SAAS,mBAAmB,OAAkB,MAAkB,QAAoB,OAAmB,QAAuC;AAC5I,MAAI;AACJ,MAAI;AACF,eAAW,MAAM,YAAY;AAAA,MAC3B;AAAA,MACA,SAAS,KAAK;AAAA,MACd,MAAM;AAAA,MACN,aAAa,KAAK;AAAA,MAClB,KAAK,IAAI,KAAK,KAAK,WAAW,eAAe;AAAA,MAC7C;AAAA,IACF,CAAC;AAAA,EACH,SAAS,OAAO;AACd,QAAI,EAAE,iBAAiB,mBAAmB;AACxC,aAAO,6CAA6C,KAAK;AAAA,IAC3D;AACA,WAAO,KAAK,SAAS,QAAQ,gEAAgE,MAAM,OAAO,KAAK;AAAA,EACjH;AACA,SAAO,KAAK,SAAS,QAAQ,WAAW;AAC1C;AAEA,SAAS,cAAc,OAAkB,MAAkB,UAAoB,UAA0B;AACvG,MAAI,SAAS,OAAO,SAAS,SAAS,KAAK,MAAM,QAAW;AAC1D,aAAS,KAAK,yDAAyD;AAAA,EACzE;AACA,QAAM,WAAW,KAAK;AACtB,MAAI,SAAS,UAAU,UAAa,CAAC,WAAW,SAAS,OAAO,SAAS,KAAK,GAAG;AAC/E,aAAS,KAAK,gCAAgC,KAAK,UAAU,SAAS,KAAK,CAAC,EAAE;AAAA,EAChF;AACA,MAAI,SAAS,YAAY,UAAa,CAAC,WAAW,SAAS,gBAAgB,SAAS,OAAO,GAAG;AAC5F,aAAS,KAAK,yCAAyC,KAAK,UAAU,SAAS,cAAc,CAAC,EAAE;AAAA,EAClG;AACA,MAAI,aAAa,YAAY,CAAC,WAAW,SAAS,WAAW,MAAM,SAAS,WAAW,IAAI,GAAG;AAC5F,aAAS,KAAK,kCAAkC,KAAK,UAAU,SAAS,WAAW,IAAI,CAAC,EAAE;AAAA,EAC5F;AACF;AAEA,SAAS,iBAAiB,OAAkB,MAAkB,UAAoB,QAAoB,QAAoB,UAA0B;AAClJ,MAAI;AACJ,MAAI;AACF,YAAQ,MAAM,mBAAmB;AAAA,MAC/B,OAAO,SAAS;AAAA,MAChB,SAAS,SAAS;AAAA,MAClB,aAAa,KAAK;AAAA,MAClB,kBAAkB,KAAK,oBAAoB;AAAA,MAC3C;AAAA,MACA,OAAO,EAAE,MAAM,QAAQ,MAAM,QAAQ,aAAa,KAAK,YAAY;AAAA,MACnE,UAAU;AAAA,IACZ,CAAC;AAAA,EACH,SAAS,OAAO;AACd,aAAS,KAAK,6BAA6B,KAAK,EAAE;AAClD;AAAA,EACF;AACA,MAAI,CAAC,WAAW,MAAM,MAAM,KAAK,SAAS,WAAmB,GAAG;AAC9D,aAAS,KAAK,qCAAqC,KAAK,UAAU,MAAM,IAAI,CAAC,EAAE;AAAA,EACjF;AACF;AAEA,SAAS,mBAAmB,OAAkB,MAAgC;AAC5E,QAAM,WAAqB,CAAC;AAC5B,QAAM,SAAS,UAAU,OAAO,UAAU,KAAK,QAAQ,QAAQ;AAC/D,MAAI,WAAW,OAAW,QAAO;AACjC,QAAM,OAAO,MAAM,WAAW;AAAA,IAC5B,QAAQ,KAAK;AAAA,IACb,aAAa,KAAK,eAAe;AAAA,IACjC,eAAe,KAAK,iBAAiB;AAAA,IACrC,kBAAkB,KAAK,oBAAoB;AAAA,IAC3C,YAAY,KAAK;AAAA,IACjB,YAAY,KAAK;AAAA,IACjB;AAAA,EACF,CAAC;AACD,MAAI,SAAS,KAAK,UAAU;AAC1B,aAAS,KAAK,uBAAuB,KAAK,UAAU,IAAI,CAAC,qBAAqB,KAAK,UAAU,KAAK,QAAQ,CAAC,EAAE;AAAA,EAC/G;AACA,SAAO;AACT;AAEA,SAAS,oBAAoB,OAAkB,MAAiC;AAC9E,QAAM,WAAqB,CAAC;AAC5B,QAAM,aAAa,UAAU,OAAO,UAAU,KAAK,YAAY,QAAQ;AACvE,MAAI,eAAe,OAAW,QAAO;AACrC,QAAM,WAAW,MAAM,YAAY;AAAA,IACjC;AAAA,IACA,WAAW,KAAK;AAAA,EAClB,CAAC;AACD,MAAI,aAAa,KAAK,UAAU;AAC9B,aAAS,KAAK,wBAAwB,QAAQ,qBAAqB,KAAK,QAAQ,EAAE;AAAA,EACpF;AACA,SAAO;AACT;AAMA,SAAS,SAAS,OAAkB,OAAsC,OAAgB,QAA2C;AACnI,QAAM,SAAS,MAAM,QAAQ,KAAK,EAAE,WAAW,EAAE,SAAS,KAAK;AAC/D,MAAI,kBAAkB,SAAS;AAC7B,YAAQ,KAAK,GAAG,KAAK,gDAAgD;AACrE,WAAO;AAAA,EACT;AACA,MAAI,OAAO,QAAQ;AACjB,YAAQ;AAAA,MACN,OAAO,OACJ,IAAI,CAAC,MAAM;AACV,cAAM,OAAO,EAAE,MAAM,IAAI,CAAC,MAAO,OAAO,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,CAAE,EAAE,KAAK,GAAG;AAC7F,eAAO,OAAO,GAAG,IAAI,KAAK,EAAE,OAAO,KAAK,EAAE;AAAA,MAC5C,CAAC,EACA,KAAK,IAAI;AAAA,IACd;AACA,WAAO;AAAA,EACT;AACA,SAAO,OAAO;AAChB;AAIA,SAAS,UAAU,OAAkB,OAAsC,OAAmB,UAA4C;AACxI,QAAM,SAAmB,CAAC;AAC1B,QAAM,SAAS,SAAS,OAAO,OAAO,OAAO,MAAM;AACnD,MAAI,WAAW,QAAW;AACxB,aAAS,KAAK,WAAW,KAAK,iBAAiB,KAAK,YAAY,OAAO,KAAK,IAAI,CAAC,EAAE;AAAA,EACrF;AACA,SAAO;AACT;AAKO,SAAS,WAAW,GAAqB,GAA8B;AAC5E,MAAI,MAAM,UAAa,MAAM,KAAM,QAAO,MAAM,UAAa,MAAM;AACnE,MAAI,MAAM,UAAa,MAAM,KAAM,QAAO;AAC1C,MAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,GAAG;AACxC,QAAI,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ;AACnE,aAAO;AAAA,IACT;AACA,WAAO,EAAE,MAAM,CAAC,MAAM,MAAM,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC;AAAA,EACpD;AACA,MAAI,OAAO,MAAM,YAAY,OAAO,MAAM,UAAU;AAClD,QAAI,OAAO,MAAM,YAAY,OAAO,MAAM,SAAU,QAAO;AAC3D,UAAM,OAAO,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC;AAC3D,WAAO,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,MAAM,WAAY,EAAiB,CAAC,GAAI,EAAiB,CAAC,CAAC,CAAC;AAAA,EACtF;AACA,SAAO,MAAM;AACf;;;ACreA,SAAS,YAAY,eAAAA,cAAa,gBAAAC,eAAc,qBAAqB;AACrE,SAAS,UAAU,UAAU,eAAe;AAKrC,IAAM,+BAA+B;AA4C5C,SAAS,UAAU,OAAyB;AAC1C,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,SAAS;AACpD,MAAI,UAAU,QAAQ,OAAO,UAAU,UAAU;AAC/C,WAAO,OAAO;AAAA,MACZ,OAAO,QAAQ,KAAgC,EAC5C,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EACrC,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,CAAC;AAAA,IAChD;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,WAAW,QAA8B,OAAe,WAAwD;AACvH,QAAM,UAAU,EAAE,QAAQ,gBAAyB;AACnD,MAAI;AACF,WAAO,UAAU,OAAO,WAAW,EAAE,WAAW,SAAS,EAAE,OAAO,CAAC;AAAA,EACrE,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,GAAG,KAAK,oBAAoB,SAAS,sCAAsC,EAAE,OAAO,MAAM,CAAC;AAAA,EAC7G;AACF;AAEA,SAASC,cAAa,MAAwB;AAC5C,QAAM,QAAkB,CAAC;AACzB,QAAM,QAAQ,CAAC,cAA4B;AACzC,eAAW,SAASC,aAAY,WAAW,EAAE,eAAe,KAAK,CAAC,GAAG;AACnE,YAAM,OAAO,QAAQ,WAAW,MAAM,IAAI;AAC1C,UAAI,MAAM,YAAY,EAAG,OAAM,IAAI;AAAA,eAC1B,MAAM,OAAO,KAAK,MAAM,KAAK,SAAS,OAAO,EAAG,OAAM,KAAK,IAAI;AAAA,IAC1E;AAAA,EACF;AACA,QAAM,IAAI;AACV,SAAO,MAAM,KAAK;AACpB;AAEA,SAAS,SAAS,cAAwC,UAAsD;AAC9G,MAAI,iBAAiB,OAAW,QAAO,CAAC;AACxC,QAAM,OAAO,wBAAwB,MAAM,aAAa,WAAW,QAAQ,YAAY;AACvF,SAAOD,cAAa,IAAI,EAAE,IAAI,CAAC,SAAS;AACtC,UAAM,WAAW,KAAK,MAAME,cAAa,MAAM,MAAM,CAAC;AACtD,UAAM,UAAU,qBAAqB,MAAM,QAAQ;AACnD,UAAM,cAAc,SAAS,MAAM,IAAI,EAAE,MAAM,IAAI,EAAE,KAAK,GAAG;AAC7D,UAAM,YAAY,YAAY,MAAM,GAAG,EAAE,CAAC;AAC1C,UAAM,QAAQ,gBAAgB,KAAK,aAAa,EAAE;AAClD,QAAI,UAAU,MAAM;AAClB,YAAM,IAAI,MAAM,GAAG,WAAW,8CAA8C;AAAA,IAC9E;AACA,UAAM,cAAc,OAAO,MAAM,CAAC,CAAC;AACnC,QAAI,gBAAgB,QAAQ,eAAe;AACzC,YAAM,IAAI,MAAM,GAAG,WAAW,gBAAgB,WAAW,iCAAiC,QAAQ,aAAa,EAAE;AAAA,IACnH;AACA,QAAI,CAAC,SAAS,IAAI,OAAO,QAAQ,aAAa,CAAC,GAAG;AAChD,YAAM,IAAI,MAAM,GAAG,WAAW,sDAAsD,QAAQ,aAAa,EAAE;AAAA,IAC7G;AACA,WAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU,UAAU,QAAQ;AAAA,IAC9B;AAAA,EACF,CAAC;AACH;AAGO,SAAS,kBAAkB,SAAiD;AACjF,QAAM,OAAO,QAAQ,KAAK,KAAK;AAC/B,MAAI,KAAK,WAAW,EAAG,OAAM,IAAI,MAAM,sCAAsC;AAE7E,QAAM,WAAW,OAAO;AAAA,IACtB,OAAO,QAAQ,QAAQ,WAAW,QAAQ,EACvC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,EACxC,IAAI,CAAC,CAAC,SAAS,KAAK,MAAM;AAAA,MACzB;AAAA,MACA;AAAA,QACE,SAAS;AAAA,UACP,OAAO,WAAW,MAAM,QAAQ,OAAO,IAAI,OAAO,UAAU,QAAQ;AAAA,UACpE,aAAa,WAAW,MAAM,QAAQ,aAAa,IAAI,OAAO,gBAAgB,QAAQ;AAAA,UACtF,QAAQ,WAAW,MAAM,QAAQ,QAAQ,IAAI,OAAO,WAAW,OAAO;AAAA,UACtE,QAAQ,WAAW,MAAM,QAAQ,QAAQ,IAAI,OAAO,WAAW,QAAQ;AAAA,QACzE;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACL;AAEA,MAAI,OAAO,KAAK,QAAQ,EAAE,WAAW,GAAG;AACtC,UAAM,IAAI,MAAM,wDAAwD;AAAA,EAC1E;AAEA,SAAO;AAAA,IACL,eAAe;AAAA,IACf;AAAA,IACA;AAAA,IACA,UAAU,SAAS,QAAQ,cAAc,IAAI,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC;AAAA,EACzE;AACF;AAGO,SAAS,iBAAiB,SAA2C;AAC1E,SAAO,GAAG,KAAK,UAAU,kBAAkB,OAAO,GAAG,MAAM,CAAC,CAAC;AAAA;AAC/D;AAGO,SAAS,iBAAiB,SAAwC;AACvE,QAAM,SAAS,QAAQ,kBAAkB,MAAM,QAAQ,SAAS,QAAQ,QAAQ,MAAM;AACtF,gBAAc,QAAQ,iBAAiB,OAAO,CAAC;AACjD;AAGO,SAAS,kBAAkB,SAAwC;AACxE,QAAM,SAAS,QAAQ,kBAAkB,MAAM,QAAQ,SAAS,QAAQ,QAAQ,MAAM;AACtF,MAAI,CAAC,WAAW,MAAM,KAAKA,cAAa,QAAQ,MAAM,MAAM,iBAAiB,OAAO,GAAG;AACrF,UAAM,IAAI,MAAM,GAAG,OAAO,SAAS,CAAC,+BAA+B;AAAA,EACrE;AACF;AAGO,IAAM,uBAAuB,CAAC,SACnC,GAAG,SAAS,IAAI,EACb,YAAY,EACZ,WAAW,eAAe,GAAG,CAAC;;;AC/KnC,SAAS,gBAAAC,qBAAoB;AAC7B,SAAS,WAAAC,gBAAe;AACxB,SAAS,qBAAqB;AAE9B,SAAS,gBAAgB;AAczB,SAAS,iBAAiB,OAAgB,UAAkB,OAAuB;AACjF,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,WAAW,GAAG;AAC1D,UAAM,IAAI,MAAM,sBAAsB,KAAK,6BAA6B;AAAA,EAC1E;AACA,SAAO;AACT;AAEA,IAAM,eAAe,CAAC,UAAwC,UAAU,QAAQ,OAAO,UAAU,YAAY,cAAc,SAAS,MAAM,aAAa,QAAQ,OAAO,MAAM,aAAa;AASzL,eAAe,8BAA8B,MAAc;AACzD,QAAM,WAAW,KAAK,MAAMC,cAAaC,SAAQ,MAAM,cAAc,GAAG,MAAM,CAAC;AAC/E,QAAM,SAAS,SAAS,SAAS,CAAC;AAClC,QAAM,OAAO,iBAAiB,OAAO,MAAM,IAAI,MAAM;AACrD,MAAI,KAAK,WAAW,GAAG;AACrB,UAAM,IAAI,MAAM,4FAA4F;AAAA,EAC9G;AAEA,QAAM,aAAa,iBAAiB,OAAO,QAAQ,uBAAuB,QAAQ;AAClF,QAAM,eAAe,iBAAiB,OAAO,UAAU,uBAAuB,UAAU;AACxF,QAAM,eAAe,iBAAiB,OAAO,UAAU,sBAAsB,UAAU;AACvF,QAAM,WAAY,MAAM,SAAS,cAAcA,SAAQ,MAAM,UAAU,CAAC,EAAE,MAAM,YAAY,GAAG;AAE/F,MAAI,CAAC,aAAa,SAAS,OAAO,GAAG;AACnC,UAAM,IAAI,MAAM,GAAG,UAAU,qDAAqD;AAAA,EACpF;AAEA,SAAO;AAAA,IACL;AAAA,IACA,YAAY,SAAS;AAAA,IACrB,cAAcA,SAAQ,MAAM,YAAY;AAAA,IACxC,QAAQA,SAAQ,MAAM,YAAY;AAAA,EACpC;AACF;AAQA,eAAsB,2BAA2B,OAAO,QAAQ,IAAI,GAAkB;AACpF,mBAAiB,MAAM,8BAA8B,IAAI,CAAC;AAC5D;AAOA,eAAsB,4BAA4B,OAAO,QAAQ,IAAI,GAAkB;AACrF,oBAAkB,MAAM,8BAA8B,IAAI,CAAC;AAC7D;","names":["readdirSync","readFileSync","fixtureFiles","readdirSync","readFileSync","readFileSync","resolve","readFileSync","resolve"]}

package/dist/chunk-VXWO4LVS.js

@@ -0,0 +1,391 @@
+// src/local-state.ts
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+var STATE_SUFFIX = join(".wrangler", "state", "v3");
+var METADATA_FILE = "metadata.sqlite";
+var DO_NAME_TABLE = "__miniflare_do_name";
+function findWranglerState(from = process.cwd()) {
+  let dir = resolve(from);
+  for (; ; ) {
+    const candidate = join(dir, STATE_SUFFIX);
+    if (existsSync(candidate)) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function openSqlite(file) {
+  if (!existsSync(file)) throw new Error(`no SQLite database at ${file}`);
+  try {
+    return new DatabaseSync(file, { readOnly: true });
+  } catch {
+    return new DatabaseSync(file);
+  }
+}
+function sqliteFilesIn(dir) {
+  if (!existsSync(dir)) return [];
+  return readdirSync(dir).filter((entry) => entry.endsWith(".sqlite") && entry !== METADATA_FILE).map((entry) => join(dir, entry));
+}
+function tableExists(db, table) {
+  const row = db.prepare("select 1 from sqlite_master where type = 'table' and name = ?").get(table);
+  return row !== void 0;
+}
+function json(value) {
+  if (typeof value !== "string") return value ?? null;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+}
+function numbers(value) {
+  const parsed = json(value);
+  return Array.isArray(parsed) ? parsed.filter((n) => typeof n === "number") : [];
+}
+function bool(value) {
+  return value === 1 || value === true;
+}
+var LocalStore = class _LocalStore {
+  /** Absolute path to `.wrangler/state/v3`. */
+  root;
+  #d1;
+  #open = /* @__PURE__ */ new Map();
+  constructor(root) {
+    this.root = root;
+  }
+  /**
+   * Locate and open the state under `from`, or throw with the one thing the
+   * caller can act on: that no Worker has been run here yet.
+   */
+  static open(from) {
+    const root = findWranglerState(from);
+    if (root === null) {
+      throw new Error(`no .wrangler/state/v3 found at or above ${resolve(from ?? process.cwd())}. Run the Worker once (\`pnpm dev\`) so it has local state to read.`);
+    }
+    return new _LocalStore(root);
+  }
+  #handle(file) {
+    const existing = this.#open.get(file);
+    if (existing !== void 0) return existing;
+    const db = openSqlite(file);
+    this.#open.set(file, db);
+    return db;
+  }
+  /**
+   * The engine's D1 database, identified by its schema rather than its name.
+   *
+   * Miniflare names the file after a hash of the database, so there is no
+   * mapping back to the binding. Recognising the engine's own `games` table
+   * instead is both simpler and more honest about what the caller wants: the
+   * database that has games in it, whatever the binding was called.
+   */
+  d1() {
+    if (this.#d1 !== void 0) return this.#d1;
+    for (const file of sqliteFilesIn(join(this.root, "d1", "miniflare-D1DatabaseObject"))) {
+      const db = this.#handle(file);
+      if (tableExists(db, "games")) {
+        this.#d1 = { file, db };
+        return this.#d1;
+      }
+    }
+    this.#d1 = null;
+    return null;
+  }
+  /**
+   * Every local Durable Object database, newest-modified first.
+   *
+   * The directory is `<worker>-<ClassName>`, and a worker name may itself
+   * contain a dash, so the class is everything after the LAST one. Ordering by
+   * mtime puts the game you just touched at the top, which is nearly always the
+   * one being debugged.
+   */
+  durableObjects() {
+    const base = join(this.root, "do");
+    if (!existsSync(base)) return [];
+    const found = [];
+    for (const namespace of readdirSync(base)) {
+      const dir = join(base, namespace);
+      if (!statSync(dir).isDirectory()) continue;
+      const className = namespace.slice(namespace.lastIndexOf("-") + 1);
+      for (const file of sqliteFilesIn(dir)) {
+        const db = this.#handle(file);
+        const name = tableExists(db, DO_NAME_TABLE) ? db.prepare(`select name from ${DO_NAME_TABLE} limit 1`).get()?.name ?? null : null;
+        found.push({ className, id: file.slice(file.lastIndexOf("/") + 1, -".sqlite".length), name, file });
+      }
+    }
+    return found.sort((a, b) => statSync(b.file).mtimeMs - statSync(a.file).mtimeMs);
+  }
+  /** The armed alarm for a Durable Object, from its namespace's metadata
+   * database. Matched on either column because the id is what Miniflare keys
+   * by and the name is what a human recognises. */
+  alarm(target) {
+    const file = join(dirname(target.file), METADATA_FILE);
+    if (!existsSync(file)) return null;
+    const db = this.#handle(file);
+    if (!tableExists(db, "_cf_ALARM")) return null;
+    const row = db.prepare("select actor_id, actor_name, scheduled_time from _cf_ALARM where actor_id = ? or actor_name = ?").get(target.id, target.name ?? target.id);
+    return row === void 0 ? null : { actorId: row.actor_id, actorName: row.actor_name, scheduledTime: row.scheduled_time };
+  }
+  /** The D1 index rows, newest-updated first. */
+  games(options = {}) {
+    const d1 = this.d1();
+    if (d1 === null) return [];
+    const where = options.status === void 0 ? "" : "where status = ?";
+    const params = options.status === void 0 ? [] : [options.status];
+    const rows = d1.db.prepare(`select * from games ${where} order by updated_at desc limit ?`).all(...params, options.limit ?? 50);
+    return rows.map(toGameRow);
+  }
+  /**
+   * Resolve a game reference the way a developer will type it: a full id, a
+   * six-character short code, or an id prefix long enough to be unique.
+   *
+   * D1 is tried first because it can match a short code, then the DO names, so
+   * a game whose index row was wiped is still reachable by id.
+   */
+  resolveGameId(ref) {
+    const d1 = this.d1();
+    if (d1 !== null) {
+      const exact = d1.db.prepare("select id from games where id = ? or short_code = ?").get(ref, ref.toUpperCase());
+      if (exact !== void 0) return exact.id;
+      const prefixed = d1.db.prepare("select id from games where id like ? limit 2").all(`${ref}%`);
+      if (prefixed.length === 1) return prefixed[0].id;
+      if (prefixed.length > 1) throw new Error(`"${ref}" matches more than one game; use a longer prefix`);
+    }
+    const named = this.durableObjects().filter((o) => o.name !== null && (o.name === ref || o.name.startsWith(ref)));
+    if (named.length === 1) return named[0].name;
+    if (named.length > 1) throw new Error(`"${ref}" matches more than one game; use a longer prefix`);
+    return null;
+  }
+  /** The Durable Object holding a game's session, or null if none exists yet. */
+  gameDurableObject(gameId) {
+    return this.durableObjects().find((o) => o.name === gameId) ?? null;
+  }
+  /** Identity for a set of user and bot ids, for rendering seats as names. */
+  #identities(userIds, botIds) {
+    const out = /* @__PURE__ */ new Map();
+    const d1 = this.d1();
+    if (d1 === null) return out;
+    for (const [table, ids] of [
+      ["users", userIds],
+      ["bots", botIds]
+    ]) {
+      if (ids.length === 0) continue;
+      const placeholders = ids.map(() => "?").join(",");
+      const rows = d1.db.prepare(`select id, username, display_name from ${table} where id in (${placeholders})`).all(...ids);
+      for (const row of rows) out.set(row.id, { username: row.username, displayName: row.display_name });
+    }
+    return out;
+  }
+  #seats(rows) {
+    const identities = this.#identities(
+      rows.map((r) => r.user_id).filter((id) => id !== null),
+      rows.map((r) => r.bot_id).filter((id) => id !== null)
+    );
+    return rows.map((row) => {
+      const identity = identities.get(row.user_id ?? row.bot_id ?? "");
+      return { playerIndex: row.player_index, userId: row.user_id, botId: row.bot_id, type: row.type, username: identity?.username ?? null, displayName: identity?.displayName ?? null };
+    });
+  }
+  /**
+   * Join both stores for one game: the index row, the session, the transition
+   * log, and the derived diagnosis.
+   *
+   * Returns null only when neither store has heard of the game.
+   */
+  game(ref) {
+    const gameId = this.resolveGameId(ref);
+    if (gameId === null) return null;
+    const d1 = this.d1();
+    const indexRow = d1 === null ? void 0 : d1.db.prepare("select * from games where id = ?").get(gameId);
+    const index = indexRow === void 0 ? null : toGameRow(indexRow);
+    const indexSeats = d1 === null ? [] : this.#seats(
+      d1.db.prepare("select player_index, user_id, bot_id, type from participants where game_id = ? order by player_index").all(gameId)
+    );
+    const durableObject = this.gameDurableObject(gameId);
+    let meta = null;
+    let roster = [];
+    let transitions = [];
+    let commands = [];
+    let outbox = [];
+    if (durableObject !== null) {
+      const db = this.#handle(durableObject.file);
+      if (tableExists(db, "meta")) {
+        const row = db.prepare("select * from meta where id = 1").get();
+        if (row !== void 0) meta = toMeta(row);
+      }
+      if (tableExists(db, "roster")) {
+        roster = this.#seats(db.prepare("select player_index, user_id, bot_id, type from roster order by player_index").all());
+      }
+      if (tableExists(db, "transitions")) {
+        const frameSeats = /* @__PURE__ */ new Map();
+        if (tableExists(db, "frames")) {
+          for (const row of db.prepare("select version, player_index from frames order by version, player_index").all()) {
+            frameSeats.set(row.version, [...frameSeats.get(row.version) ?? [], row.player_index]);
+          }
+        }
+        transitions = db.prepare("select * from transitions order by version").all().map((row) => toTransition(row, frameSeats));
+      }
+      if (tableExists(db, "commands")) {
+        commands = db.prepare("select command_id, response, created_at from commands order by created_at desc").all().map((row) => ({
+          commandId: row.command_id,
+          createdAt: row.created_at,
+          result: json(row.response)
+        }));
+      }
+      if (tableExists(db, "outbox")) {
+        outbox = db.prepare("select finish_id, outcomes, created_at from outbox order by created_at").all().map((row) => ({
+          finishId: row.finish_id,
+          createdAt: row.created_at,
+          outcomes: json(row.outcomes)
+        }));
+      }
+    }
+    const alarm = durableObject === null ? null : this.alarm(durableObject);
+    const view = { gameId, index, indexSeats, durableObject, meta, roster, transitions, commands, outbox, alarm };
+    return { ...view, diagnosis: diagnose(view) };
+  }
+  /** Run a read-only statement against D1 or one game's Durable Object: the
+   * escape hatch for a question this reader does not model. */
+  query(sql, options = {}) {
+    const db = options.game === void 0 ? this.d1()?.db : this.#gameDb(options.game);
+    if (db === void 0 || db === null) {
+      throw new Error(options.game === void 0 ? "no local D1 database found in this Worker's state" : `no local Durable Object found for game ${options.game}`);
+    }
+    return db.prepare(sql).all(...options.params ?? []);
+  }
+  /** Table names and row counts, for D1 or one game's Durable Object. */
+  tables(options = {}) {
+    const db = options.game === void 0 ? this.d1()?.db : this.#gameDb(options.game);
+    if (db === void 0 || db === null) return [];
+    const names = db.prepare("select name from sqlite_master where type = 'table' order by name").all().map((r) => r.name);
+    return names.map((name) => ({ name, rows: db.prepare(`select count(*) as n from "${name}"`).get().n }));
+  }
+  #gameDb(ref) {
+    const gameId = this.resolveGameId(ref);
+    const target = gameId === null ? null : this.gameDurableObject(gameId);
+    return target === null ? null : this.#handle(target.file);
+  }
+  /** Release every open handle. */
+  close() {
+    for (const db of this.#open.values()) db.close();
+    this.#open.clear();
+    this.#d1 = void 0;
+  }
+};
+function toGameRow(row) {
+  return {
+    id: row.id,
+    createdBy: row.created_by ?? null,
+    status: row.status,
+    access: row.access,
+    schemaVersion: row.schema_version,
+    config: json(row.config),
+    turnSeconds: row.turn_seconds ?? null,
+    budgetSeconds: row.budget_seconds ?? null,
+    incrementSeconds: row.increment_seconds ?? null,
+    rated: bool(row.rated),
+    ratingPool: row.rating_pool ?? null,
+    minPlayers: row.min_players,
+    maxPlayers: row.max_players,
+    shortCode: row.short_code,
+    pendingPlayers: row.pending_players === null || row.pending_players === void 0 ? null : numbers(row.pending_players),
+    turnDeadline: row.turn_deadline ?? null,
+    outcomes: json(row.outcomes),
+    finishId: row.finish_id ?? null,
+    finishedAt: row.finished_at ?? null,
+    archivedAt: row.archived_at ?? null,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at
+  };
+}
+function toMeta(row) {
+  return {
+    gameId: row.game_id,
+    status: row.status,
+    access: row.access,
+    schemaVersion: row.schema_version,
+    config: json(row.config),
+    turnSeconds: row.turn_seconds ?? null,
+    budgetSeconds: row.budget_seconds ?? null,
+    incrementSeconds: row.increment_seconds ?? null,
+    rated: bool(row.rated),
+    ratingPool: row.rating_pool ?? null,
+    minPlayers: row.min_players,
+    maxPlayers: row.max_players,
+    createdBy: row.created_by ?? null,
+    rngSeed: row.rng_seed ?? null
+  };
+}
+function toTransition(row, frameSeats) {
+  const version = row.version;
+  const action = json(row.action);
+  return {
+    version,
+    state: json(row.state),
+    action: action ?? null,
+    pending: numbers(row.pending),
+    deadline: row.deadline ?? null,
+    playerTimes: row.player_times === null || row.player_times === void 0 ? null : numbers(row.player_times),
+    turnStartedAt: row.turn_started_at ?? null,
+    frameSeats: frameSeats.get(version) ?? []
+  };
+}
+function diagnose(view) {
+  const status = view.meta?.status ?? view.index?.status ?? "unknown";
+  const seated = (view.meta === null ? view.indexSeats : view.roster).length;
+  const min = view.meta?.minPlayers ?? view.index?.minPlayers ?? 0;
+  const max = view.meta?.maxPlayers ?? view.index?.maxPlayers ?? 0;
+  const latest = view.transitions.at(-1) ?? null;
+  const mirrorDrift = [];
+  if (view.index !== null && view.meta !== null) {
+    if (view.index.status !== view.meta.status) {
+      mirrorDrift.push(`D1 says status=${view.index.status}, the Durable Object says ${view.meta.status}. The DO is authoritative; a mirror write was lost.`);
+    }
+    if (view.indexSeats.length !== view.roster.length) {
+      mirrorDrift.push(`D1 mirrors ${view.indexSeats.length} seat(s), the Durable Object holds ${view.roster.length}.`);
+    }
+    const mirroredPending = view.index.pendingPlayers ?? null;
+    const actualPending = latest?.pending ?? null;
+    if (status === "active" && JSON.stringify(mirroredPending) !== JSON.stringify(actualPending)) {
+      mirrorDrift.push(`D1 mirrors pendingPlayers=${JSON.stringify(mirroredPending)}, the newest transition has ${JSON.stringify(actualPending)}.`);
+    }
+  }
+  if (view.index === null && view.meta !== null) {
+    mirrorDrift.push("no D1 index row for a game whose Durable Object exists; discovery and history lists cannot show it.");
+  }
+  let summary;
+  switch (status) {
+    case "waiting":
+      summary = `waiting for players: ${seated}/${min} needed to become ready (${max} max). The next event is a join, or add-bot from the creator.`;
+      break;
+    case "ready":
+      summary = `ready and not started: ${seated}/${max} seats filled. Nothing happens until the CREATOR calls POST /api/engine/games/${view.gameId}/start. A start is explicit and creator-only; filling the lobby does not start a game.`;
+      break;
+    case "active":
+      if (latest === null) {
+        summary = "status is active but no transition is committed, which should be impossible: a start commits v0 in the same transaction that sets the status.";
+      } else {
+        const waitingOn = latest.pending.length === 0 ? "nobody, which means the game should have finished at this version" : `seat(s) ${latest.pending.join(", ")}`;
+        const timer = latest.deadline === null ? "untimed, so no alarm is armed and only a move or a forfeit moves it" : `deadline ${new Date(latest.deadline).toISOString()}`;
+        summary = `at v${latest.version}, waiting on ${waitingOn}. ${timer}.`;
+      }
+      break;
+    case "finished":
+      summary = view.outbox.length > 0 ? `finished, but ${view.outbox.length} outbox row(s) survive: the D1 finish apply has not succeeded, so ratings and history are not published yet.` : `finished at v${latest?.version ?? "?"}; the outbox is clear, so D1 has the outcomes.`;
+      break;
+    case "aborted":
+      summary = "aborted: cancelled by its creator, reaped as abandoned, or torn down by an account purge. Nothing moves an aborted game.";
+      break;
+    default:
+      summary = view.durableObject === null ? "created in D1 but its Durable Object does not exist yet. That is normal for a lobby nobody has touched: the DO is created lazily by the first command or socket." : `unrecognised status ${status}.`;
+  }
+  return { summary, mirrorDrift };
+}
+
+export {
+  findWranglerState,
+  openSqlite,
+  LocalStore
+};
+//# sourceMappingURL=chunk-VXWO4LVS.js.map