@eigeninteractive/testkit 0.4.1 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -79,6 +79,18 @@ function parseRatingPoolCase(where, raw) {
79
79
  expected: raw.expected === null ? null : asString(`${where}.expected`, raw.expected)
80
80
  };
81
81
  }
82
+ function parsePlayerLimitsCase(where, raw) {
83
+ const expected = asObject(`${where}.expected`, raw.expected);
84
+ return {
85
+ kind: "playerLimits",
86
+ name: asString(`${where}.name`, raw.name),
87
+ config: asObject(`${where}.config`, raw.config),
88
+ expected: {
89
+ minPlayers: asNumber(`${where}.expected.minPlayers`, expected.minPlayers),
90
+ maxPlayers: asNumber(`${where}.expected.maxPlayers`, expected.maxPlayers)
91
+ }
92
+ };
93
+ }
82
94
  function parseBotSeatableCase(where, raw) {
83
95
  return {
84
96
  kind: "botSeatable",
@@ -99,12 +111,14 @@ function parseTwinFixtureFile(path, json) {
99
111
  switch (obj.kind) {
100
112
  case "action":
101
113
  return parseActionCase(where, obj);
114
+ case "playerLimits":
115
+ return parsePlayerLimitsCase(where, obj);
102
116
  case "ratingPool":
103
117
  return parseRatingPoolCase(where, obj);
104
118
  case "botSeatable":
105
119
  return parseBotSeatableCase(where, obj);
106
120
  default:
107
- throw new Error(`${where}.kind: expected one of action | ratingPool | botSeatable, got ${JSON.stringify(obj.kind)}`);
121
+ throw new Error(`${where}.kind: expected one of action | playerLimits | ratingPool | botSeatable, got ${JSON.stringify(obj.kind)}`);
108
122
  }
109
123
  });
110
124
  return { schemaVersion, cases };
@@ -113,12 +127,14 @@ function evaluateTwinCase(rules, kase) {
113
127
  switch (kase.kind) {
114
128
  case "action":
115
129
  return evaluateAction(rules, kase);
130
+ case "playerLimits":
131
+ return evaluatePlayerLimits(rules, kase);
116
132
  case "ratingPool":
117
133
  return evaluateRatingPool(rules, kase);
118
134
  case "botSeatable":
119
135
  return evaluateBotSeatable(rules, kase);
120
136
  default:
121
- return [`unknown case kind "${kase.kind}", expected action | ratingPool | botSeatable`];
137
+ return [`unknown case kind "${kase.kind}", expected action | playerLimits | ratingPool | botSeatable`];
122
138
  }
123
139
  }
124
140
  function twinFixtureTests(gameModule, fixturesRoot) {
@@ -240,6 +256,16 @@ function evaluateRatingPool(rules, kase) {
240
256
  }
241
257
  return failures;
242
258
  }
259
+ function evaluatePlayerLimits(rules, kase) {
260
+ const failures = [];
261
+ const config = parseWith(rules, "config", kase.config, failures);
262
+ if (config === void 0) return failures;
263
+ const limits = rules.playerLimits({ config });
264
+ if (limits.minPlayers !== kase.expected.minPlayers || limits.maxPlayers !== kase.expected.maxPlayers) {
265
+ failures.push(`playerLimits returned ${limits.minPlayers}-${limits.maxPlayers}, fixture expects ${kase.expected.minPlayers}-${kase.expected.maxPlayers}`);
266
+ }
267
+ return failures;
268
+ }
243
269
  function evaluateBotSeatable(rules, kase) {
244
270
  const failures = [];
245
271
  const gameConfig = parseWith(rules, "config", kase.gameConfig, failures);
@@ -298,23 +324,27 @@ function deepEquals(a, b) {
298
324
  // src/game-contract.ts
299
325
  import { existsSync, readdirSync as readdirSync2, readFileSync as readFileSync2, writeFileSync } from "node:fs";
300
326
  import { basename, relative, resolve } from "node:path";
327
+ import { assertPortableSchema } from "@eigeninteractive/rules";
301
328
  var GAME_CONTRACT_FORMAT_VERSION = 1;
302
329
  function canonical(value) {
303
330
  if (Array.isArray(value)) return value.map(canonical);
304
331
  if (value !== null && typeof value === "object") {
305
332
  return Object.fromEntries(
306
- Object.entries(value).sort(([a], [b]) => a.localeCompare(b)).map(([key, item]) => [key, canonical(item)])
333
+ Object.entries(value).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, item]) => [key, canonical(item)])
307
334
  );
308
335
  }
309
336
  return value;
310
337
  }
311
- function jsonSchema(schema, label, direction) {
338
+ function jsonSchema(schema, label) {
312
339
  const options = { target: "draft-2020-12" };
340
+ let emitted;
313
341
  try {
314
- return canonical(schema["~standard"].jsonSchema[direction](options));
342
+ emitted = canonical(schema["~standard"].jsonSchema.output(options));
315
343
  } catch (error) {
316
- throw new Error(`${label} cannot emit its ${direction} type as draft-2020-12 JSON Schema`, { cause: error });
344
+ throw new Error(`${label} cannot emit its type as draft-2020-12 JSON Schema`, { cause: error });
317
345
  }
346
+ assertPortableSchema(emitted, label);
347
+ return emitted;
318
348
  }
319
349
  function fixtureFiles2(root) {
320
350
  const found = [];
@@ -361,10 +391,10 @@ function buildGameContract(options) {
361
391
  version,
362
392
  {
363
393
  schemas: {
364
- state: jsonSchema(rules.schemas.state, `v${version} state`, "output"),
365
- observation: jsonSchema(rules.schemas.observation, `v${version} observation`, "output"),
366
- action: jsonSchema(rules.schemas.action, `v${version} action`, "input"),
367
- config: jsonSchema(rules.schemas.config, `v${version} config`, "output")
394
+ state: jsonSchema(rules.schemas.state, `v${version} state`),
395
+ observation: jsonSchema(rules.schemas.observation, `v${version} observation`),
396
+ action: jsonSchema(rules.schemas.action, `v${version} action`),
397
+ config: jsonSchema(rules.schemas.config, `v${version} config`)
368
398
  }
369
399
  }
370
400
  ])
@@ -450,4 +480,4 @@ export {
450
480
  emitConfiguredGameContract,
451
481
  checkConfiguredGameContract
452
482
  };
453
- //# sourceMappingURL=chunk-JJW4WLTM.js.map
483
+ //# sourceMappingURL=chunk-BQIY636F.js.map
@@ -0,0 +1 @@
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\": \"playerLimits\", \"name\": \"...\", \"config\": {},\n * \"expected\": { \"minPlayers\": 2, \"maxPlayers\": 2 } },\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 `playerLimits` case: the seats one config may be played with. */\nexport interface PlayerLimitsCase {\n kind: \"playerLimits\";\n name: string;\n config: JsonObject;\n expected: { minPlayers: number; maxPlayers: number };\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 | PlayerLimitsCase | 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 parsePlayerLimitsCase(where: string, raw: JsonObject): PlayerLimitsCase {\n const expected = asObject(`${where}.expected`, raw.expected);\n return {\n kind: \"playerLimits\",\n name: asString(`${where}.name`, raw.name),\n config: asObject(`${where}.config`, raw.config),\n expected: {\n minPlayers: asNumber(`${where}.expected.minPlayers`, expected.minPlayers),\n maxPlayers: asNumber(`${where}.expected.maxPlayers`, expected.maxPlayers),\n },\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 \"playerLimits\":\n return parsePlayerLimitsCase(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 | playerLimits | 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 \"playerLimits\":\n return evaluatePlayerLimits(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 | playerLimits | 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 evaluatePlayerLimits(rules: GameRules, kase: PlayerLimitsCase): string[] {\n const failures: string[] = [];\n const config = parseWith(rules, \"config\", kase.config, failures);\n if (config === undefined) return failures;\n const limits = rules.playerLimits({ config });\n if (limits.minPlayers !== kase.expected.minPlayers || limits.maxPlayers !== kase.expected.maxPlayers) {\n failures.push(`playerLimits returned ${limits.minPlayers}-${limits.maxPlayers}, fixture expects ${kase.expected.minPlayers}-${kase.expected.maxPlayers}`);\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 { assertPortableSchema, type GameModule, type 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\n/**\n * Sort object keys so the same schemas always emit the same bytes.\n *\n * Ordering is by UTF-16 code unit — plain `Array#sort` — which is what RFC 8785\n * specifies and what `tool/check-contracts.mjs` uses to digest a manifest. It is\n * *not* `localeCompare`: that collates case-insensitively, so a `$defs` entry\n * named `Move` sorts before `additionalProperties` under one rule and after it\n * under the other. Generated JSON Schema is full of capitalized `$defs` names, so\n * the two orders genuinely disagree, and a digest computed over one would never\n * match a document written by the other.\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 < b ? -1 : a > b ? 1 : 0))\n .map(([key, item]) => [key, canonical(item)]),\n );\n }\n return value;\n}\n\n/**\n * Emit one payload schema as portable draft-2020-12 JSON Schema.\n *\n * Always the **output** direction. Zod's input schema omits\n * `additionalProperties: false` on objects, because on input a permissive object\n * still strips unknown keys rather than rejecting them — but the contract is what\n * the Dart side generates a validator from, and an open object there means the two\n * halves disagree about an unknown key. Schemas are required to be transform-free\n * (see `GameSchemas`), so the two directions describe the same values and the\n * output one is simply the honest document.\n *\n * The result is then checked against the portable profile, because emission is\n * where an unportable schema can still be fixed cheaply. Skipping this check is\n * how the profile came to be violated in the first place.\n */\nfunction jsonSchema(schema: StandardJSONSchemaV1, label: string): Record<string, unknown> {\n const options = { target: \"draft-2020-12\" as const };\n let emitted: unknown;\n try {\n emitted = canonical(schema[\"~standard\"].jsonSchema.output(options));\n } catch (error) {\n throw new Error(`${label} cannot emit its type as draft-2020-12 JSON Schema`, { cause: error });\n }\n assertPortableSchema(emitted, label);\n return emitted as Record<string, unknown>;\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`),\n observation: jsonSchema(rules.schemas.observation, `v${version} observation`),\n action: jsonSchema(rules.schemas.action, `v${version} action`),\n config: jsonSchema(rules.schemas.config, `v${version} config`),\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":"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","names":["readdirSync","readFileSync","fixtureFiles","readdirSync","readFileSync","readFileSync","resolve","readFileSync","resolve"]}
@@ -1 +1,2 @@
1
1
  #!/usr/bin/env node
2
+ export {};
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  checkConfiguredGameContract,
4
4
  emitConfiguredGameContract
5
- } from "./chunk-JJW4WLTM.js";
5
+ } from "./chunk-BQIY636F.js";
6
6
 
7
7
  // src/contract-cli.ts
8
8
  import { parseArgs } from "node:util";
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Emits `game-contract.json` from an EigenInteractive package's conventional layout.
3
+ *
4
+ * This is the programmatic form of the `eigen-contract` executable. Most
5
+ * games should invoke the executable through their package script.
6
+ */
7
+ export declare function emitConfiguredGameContract(root?: string): Promise<void>;
8
+ /**
9
+ * Fails when the conventionally configured contract is absent or stale.
10
+ *
11
+ * Use this in CI through `eigen-contract --check`.
12
+ */
13
+ export declare function checkConfiguredGameContract(root?: string): Promise<void>;
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Emit the language-neutral contract a game's Flutter repository consumes.
3
+ *
4
+ * The authoritative inputs live with the TypeScript rules: the four payload
5
+ * schemas and the shared behavioral fixtures. The output is one deterministic
6
+ * JSON file so it can be copied, attached to a release, or fetched by checksum
7
+ * without assuming any repository layout.
8
+ */
9
+ import { type GameModule } from "@eigeninteractive/rules";
10
+ /** Current format of the language-neutral contract consumed by EigenInteractive's Dart generator. */
11
+ export declare const GAME_CONTRACT_FORMAT_VERSION = 1;
12
+ /** One validated twin-fixture document embedded in a {@link GameContract}. */
13
+ export interface GameContractFixture {
14
+ /** POSIX-style path relative to the supplied fixtures root. */
15
+ path: string;
16
+ /** Validated fixture document, retained in its original JSON shape. */
17
+ document: unknown;
18
+ }
19
+ /** The four JSON Schemas emitted for one game `schemaVersion`. */
20
+ export interface GameContractVersion {
21
+ schemas: {
22
+ state: Record<string, unknown>;
23
+ observation: Record<string, unknown>;
24
+ action: Record<string, unknown>;
25
+ config: Record<string, unknown>;
26
+ };
27
+ }
28
+ /** Language-neutral schemas and fixtures shared by a game's Worker and app. */
29
+ export interface GameContract {
30
+ formatVersion: typeof GAME_CONTRACT_FORMAT_VERSION;
31
+ game: string;
32
+ versions: Record<string, GameContractVersion>;
33
+ fixtures: GameContractFixture[];
34
+ }
35
+ /** Inputs for building a {@link GameContract} without writing it. */
36
+ export interface BuildGameContractOptions {
37
+ /** Stable display name used as the generated Dart type prefix. */
38
+ game: string;
39
+ /** Authoritative TypeScript rules registry. */
40
+ gameModule: GameModule;
41
+ /** Root containing `v<N>/*.json` twin fixtures. */
42
+ fixturesRoot?: string | URL;
43
+ }
44
+ /** Inputs for emitting or checking a {@link GameContract} file. */
45
+ export interface EmitGameContractOptions extends BuildGameContractOptions {
46
+ /** Destination `game-contract.json` path. */
47
+ output: string | URL;
48
+ }
49
+ /** Build a deterministic in-memory contract without touching the filesystem. */
50
+ export declare function buildGameContract(options: BuildGameContractOptions): GameContract;
51
+ /** Render one deterministic, newline-terminated contract document. */
52
+ export declare function gameContractJson(options: BuildGameContractOptions): string;
53
+ /** Emit one deterministic, newline-terminated `game-contract.json`. */
54
+ export declare function emitGameContract(options: EmitGameContractOptions): void;
55
+ /** Fail when an emitted contract is missing or differs from its inputs. */
56
+ export declare function checkGameContract(options: EmitGameContractOptions): void;
57
+ /** A useful default filename for scripts that accept an output directory. */
58
+ export declare const gameContractFilename: (game: string) => string;
package/dist/index.d.ts CHANGED
@@ -1,237 +1,11 @@
1
- import { GameModule, GameRules, JsonObject, TransitionCause, OutcomeEntry, GameAccess, Json } from '@eigeninteractive/rules';
2
- import { SeatView } from '@eigeninteractive/kernel';
3
- export { CommitInput, CommitPlan, DEADLINE_GRACE_MS, Effect, GameRow, Intent, ObservationFrame, RejectCode, Rejected, Seat, SeatView, StateRow, commit, deriveRng, isRejected, randomSeed } from '@eigeninteractive/kernel';
4
-
5
1
  /**
6
- * Emits `game-contract.json` from an EigenInteractive package's conventional layout.
2
+ * `@eigeninteractive/testkit`: drive a game's rules through the real kernel without a
3
+ * Worker, a database or a network. Build a table, submit actions as seats,
4
+ * assert on the resulting transitions and per-seat observations.
7
5
  *
8
- * This is the programmatic form of the `eigen-contract` executable. Most
9
- * games should invoke the executable through their package script.
6
+ * @module @eigeninteractive/testkit
10
7
  */
11
- declare function emitConfiguredGameContract(root?: string): Promise<void>;
12
- /**
13
- * Fails when the conventionally configured contract is absent or stale.
14
- *
15
- * Use this in CI through `eigen-contract --check`.
16
- */
17
- declare function checkConfiguredGameContract(root?: string): Promise<void>;
18
-
19
- /**
20
- * Emit the language-neutral contract a game's Flutter repository consumes.
21
- *
22
- * The authoritative inputs live with the TypeScript rules: the four payload
23
- * schemas and the shared behavioral fixtures. The output is one deterministic
24
- * JSON file so it can be copied, attached to a release, or fetched by checksum
25
- * without assuming any repository layout.
26
- */
27
-
28
- /** Current format of the language-neutral contract consumed by EigenInteractive's Dart generator. */
29
- declare const GAME_CONTRACT_FORMAT_VERSION = 1;
30
- /** One validated twin-fixture document embedded in a {@link GameContract}. */
31
- interface GameContractFixture {
32
- /** POSIX-style path relative to the supplied fixtures root. */
33
- path: string;
34
- /** Validated fixture document, retained in its original JSON shape. */
35
- document: unknown;
36
- }
37
- /** The four JSON Schemas emitted for one game `schemaVersion`. */
38
- interface GameContractVersion {
39
- schemas: {
40
- state: Record<string, unknown>;
41
- observation: Record<string, unknown>;
42
- action: Record<string, unknown>;
43
- config: Record<string, unknown>;
44
- };
45
- }
46
- /** Language-neutral schemas and fixtures shared by a game's Worker and app. */
47
- interface GameContract {
48
- formatVersion: typeof GAME_CONTRACT_FORMAT_VERSION;
49
- game: string;
50
- versions: Record<string, GameContractVersion>;
51
- fixtures: GameContractFixture[];
52
- }
53
- /** Inputs for building a {@link GameContract} without writing it. */
54
- interface BuildGameContractOptions {
55
- /** Stable display name used as the generated Dart type prefix. */
56
- game: string;
57
- /** Authoritative TypeScript rules registry. */
58
- gameModule: GameModule;
59
- /** Root containing `v<N>/*.json` twin fixtures. */
60
- fixturesRoot?: string | URL;
61
- }
62
- /** Inputs for emitting or checking a {@link GameContract} file. */
63
- interface EmitGameContractOptions extends BuildGameContractOptions {
64
- /** Destination `game-contract.json` path. */
65
- output: string | URL;
66
- }
67
- /** Build a deterministic in-memory contract without touching the filesystem. */
68
- declare function buildGameContract(options: BuildGameContractOptions): GameContract;
69
- /** Render one deterministic, newline-terminated contract document. */
70
- declare function gameContractJson(options: BuildGameContractOptions): string;
71
- /** Emit one deterministic, newline-terminated `game-contract.json`. */
72
- declare function emitGameContract(options: EmitGameContractOptions): void;
73
- /** Fail when an emitted contract is missing or differs from its inputs. */
74
- declare function checkGameContract(options: EmitGameContractOptions): void;
75
- /** A useful default filename for scripts that accept an output directory. */
76
- declare const gameContractFilename: (game: string) => string;
77
-
78
- /**
79
- * The kernel-scenario surface for game tests: how an implementor drives real
80
- * engine transitions over their rules unit (same-view pairs, timing/grace
81
- * behavior, lifecycle outcomes) without depending on the engine's internals.
82
- *
83
- * `@eigeninteractive/kernel` is an internal package: implementors ship `@eigeninteractive/rules` +
84
- * `@eigeninteractive/server` and dev-depend on `@eigeninteractive/testkit` alone. Everything a
85
- * game's test suite legitimately needs from the kernel is re-exported here,
86
- * so the kernel's own surface stays free to churn.
87
- */
88
-
89
- /** Project one seat's view of a state: the stored-frame shape the same-view
90
- * rule compares (`commit()`'s `staleViews` input). Convenience for scenario
91
- * tests that replay a simultaneous-move race. */
92
- declare function projectView(rules: GameRules, args: {
93
- state: JsonObject;
94
- pending: number[];
95
- /** The seat to project for, or null for a viewer. */
96
- seat: number | null;
97
- config: JsonObject;
98
- cause?: TransitionCause;
99
- participantCount?: number;
100
- isReplay?: boolean;
101
- }): SeatView;
102
-
103
- /**
104
- * Twin-drift fixture runner: the TS half of the shared JSON fixtures that
105
- * keep a version unit's TS and Dart `GameRules` twins in sync. The JSON
106
- * fixture format is shared verbatim with the Dart runner
107
- * (`lib/testing/twin_fixtures.dart`): one file, two consumers.
108
- *
109
- * One fixture file per concern lives beside the version units at
110
- * `<fixturesRoot>/v<N>/*.json` and is consumed by BOTH sides: this module
111
- * runs each case against the TS unit (schemas + `applyAction` +
112
- * `computeObservation` + the two predicates), while the Dart runner runs the
113
- * same file against the Dart twin (generated payload parsing,
114
- * `isValidAction`, `previewAction`, predicate twins). A behavioral divergence
115
- * then fails one side's CI instead of degrading UX in production.
116
- *
117
- * ## Fixture file format
118
- *
119
- * ```jsonc
120
- * {
121
- * "schemaVersion": 1,
122
- * "cases": [
123
- * {
124
- * "kind": "action",
125
- * "name": "seat 0 marks an empty cell",
126
- * "config": {},
127
- * "state": { ... }, // TS: applyAction input
128
- * "obs": { ... }, // Dart-only; defaults to `state`
129
- * "pending": [0],
130
- * "playerIndex": 0,
131
- * "participantCount": 2, // optional, default 2
132
- * "rngSeed": "any string", // optional, default "twin-fixtures"
133
- * "action": { ... },
134
- * "expected": {
135
- * "valid": true, // false ⇒ TS IllegalMoveError,
136
- * // Dart isValidAction false
137
- * "state": { ... }, // optional, TS envelope.state
138
- * "pending": [1], // optional, TS envelope.pendingPlayers
139
- * "outcome": [ ... ], // optional, TS envelope.outcome
140
- * // (null asserts the game is ongoing)
141
- * "observation": { ... } // optional, the actor's post-action
142
- * // view: TS computeObservation slice
143
- * // data; Dart previewAction (when the
144
- * // game implements optimism)
145
- * }
146
- * },
147
- * { "kind": "ratingPool", "name": "...", "access": "public",
148
- * "minPlayers": 2, "maxPlayers": 2, "config": {}, "expected": "blitz" },
149
- * { "kind": "botSeatable", "name": "...", "gameConfig": {},
150
- * "botConfig": {}, "expected": false }
151
- * ]
152
- * }
153
- * ```
154
- *
155
- * The `state`/`obs` split exists for hidden-info games (a seat's observation
156
- * is not the state); perfect-info games omit `obs`. `expected.observation` is
157
- * the shared behavioral anchor: the TS side must project the post-action
158
- * state to it, and a Dart `previewAction` that returns non-null must predict
159
- * it, so the two sides are compared through one recorded value.
160
- *
161
- * Wire it up in a game-owned test file running under plain-Node vitest:
162
- *
163
- * ```ts
164
- * import { twinFixtureTests } from "@eigeninteractive/testkit";
165
- * import gameModule from "../src/module/index.js";
166
- *
167
- * twinFixtureTests(gameModule, new URL("../src/module/fixtures/", import.meta.url));
168
- * ```
169
- */
170
-
171
- /** One fixture file: cases targeting one `schemaVersion` unit. */
172
- interface TwinFixtureFile {
173
- schemaVersion: number;
174
- cases: TwinFixtureCase[];
175
- }
176
- /** A game-action case: exercises schemas, `applyAction`, and (through
177
- * `expected.observation`) `computeObservation` for the acting seat. */
178
- interface ActionCase {
179
- kind: "action";
180
- name: string;
181
- config: JsonObject;
182
- state: JsonObject;
183
- /** Dart-side observation payload; unused here (defaults to `state`). */
184
- obs?: JsonObject;
185
- pending: number[];
186
- playerIndex: number;
187
- participantCount?: number;
188
- rngSeed?: string;
189
- action: JsonObject;
190
- expected: {
191
- valid: boolean;
192
- state?: JsonObject;
193
- pending?: number[];
194
- outcome?: OutcomeEntry[] | null;
195
- observation?: JsonObject;
196
- };
197
- }
198
- /** A `ratingPool` predicate case. Omitted timing fields mean null. */
199
- interface RatingPoolCase {
200
- kind: "ratingPool";
201
- name: string;
202
- access: GameAccess;
203
- turnSeconds?: number | null;
204
- budgetSeconds?: number | null;
205
- incrementSeconds?: number | null;
206
- minPlayers: number;
207
- maxPlayers: number;
208
- config: JsonObject;
209
- expected: string | null;
210
- }
211
- /** A `botSeatable` predicate case. */
212
- interface BotSeatableCase {
213
- kind: "botSeatable";
214
- name: string;
215
- gameConfig: JsonObject;
216
- botConfig: JsonObject;
217
- expected: boolean;
218
- }
219
- type TwinFixtureCase = ActionCase | RatingPoolCase | BotSeatableCase;
220
- /** Validate one fixture file's parsed JSON, or throw naming the offending
221
- * file, case, and field. Exported so a repo can lint its fixtures without
222
- * running them. */
223
- declare function parseTwinFixtureFile(path: string, json: unknown): TwinFixtureFile;
224
- /** Run one fixture case against a rules unit, returning failure descriptions
225
- * (empty ⇒ the case passes). Pure; the file-reading test registrar is
226
- * {@link twinFixtureTests}. */
227
- declare function evaluateTwinCase(rules: GameRules, kase: TwinFixtureCase): string[];
228
- /** Register one vitest test per fixture case found under `fixturesRoot`
229
- * (layout: `<root>/v<N>/*.json`). Call at the top level of a test module
230
- * running in a Node environment. */
231
- declare function twinFixtureTests(gameModule: GameModule, fixturesRoot: string | URL): void;
232
- /** Structural JSON equality. Object keys with `undefined` values count as
233
- * absent (matching how schema libraries model optional fields); array order
234
- * matters. */
235
- declare function deepEquals(a: Json | undefined, b: Json | undefined): boolean;
236
-
237
- export { type ActionCase, type BotSeatableCase, type BuildGameContractOptions, type EmitGameContractOptions, GAME_CONTRACT_FORMAT_VERSION, type GameContract, type GameContractFixture, type GameContractVersion, type RatingPoolCase, type TwinFixtureCase, type TwinFixtureFile, buildGameContract, checkConfiguredGameContract, checkGameContract, deepEquals, emitConfiguredGameContract, emitGameContract, evaluateTwinCase, gameContractFilename, gameContractJson, parseTwinFixtureFile, projectView, twinFixtureTests };
8
+ export { checkConfiguredGameContract, emitConfiguredGameContract } from "./contract-command.js";
9
+ export { type BuildGameContractOptions, buildGameContract, checkGameContract, type EmitGameContractOptions, emitGameContract, GAME_CONTRACT_FORMAT_VERSION, type GameContract, type GameContractFixture, type GameContractVersion, gameContractFilename, gameContractJson, } from "./game-contract.js";
10
+ export { type CommitInput, type CommitPlan, commit, DEADLINE_GRACE_MS, deriveRng, type Effect, type GameRow, type Intent, isRejected, type ObservationFrame, projectView, type RejectCode, type Rejected, randomSeed, type Seat, type SeatView, type StateRow, } from "./kernel-scenarios.js";
11
+ export { type ActionCase, type BotSeatableCase, deepEquals, evaluateTwinCase, type PlayerLimitsCase, parseTwinFixtureFile, type RatingPoolCase, type TwinFixtureCase, type TwinFixtureFile, twinFixtureTests, } from "./twin-fixtures.js";
package/dist/index.js CHANGED
@@ -11,7 +11,7 @@ import {
11
11
  gameContractJson,
12
12
  parseTwinFixtureFile,
13
13
  twinFixtureTests
14
- } from "./chunk-JJW4WLTM.js";
14
+ } from "./chunk-BQIY636F.js";
15
15
 
16
16
  // src/kernel-scenarios.ts
17
17
  import { assertHookPayload } from "@eigeninteractive/kernel";
@@ -1 +1,16 @@
1
1
  #!/usr/bin/env node
2
+ /**
3
+ * `eigen-inspect`: read a Worker's local `.wrangler` state from the terminal.
4
+ *
5
+ * Deliberately narrow. Wrangler already ships a first-party browser for local
6
+ * resources (press `e` in `wrangler dev`, or open `/cdn-cgi/explorer`), and
7
+ * generic table browsing is its job, not this tool's. What that view cannot do
8
+ * is answer a question in the engine's own terms, because a game's truth is
9
+ * split across two stores on purpose: the D1 index and the game's own Durable
10
+ * Object. This reads both, decodes the JSON columns, prints the transition log
11
+ * as a timeline, and says what the game is waiting for.
12
+ *
13
+ * It also runs with no dev server, no browser and no account, and emits
14
+ * `--json` for a script or an agent.
15
+ */
16
+ export {};
@@ -0,0 +1,27 @@
1
+ /**
2
+ * The kernel-scenario surface for game tests: how an implementor drives real
3
+ * engine transitions over their rules unit (same-view pairs, timing/grace
4
+ * behavior, lifecycle outcomes) without depending on the engine's internals.
5
+ *
6
+ * `@eigeninteractive/kernel` is an internal package: implementors ship `@eigeninteractive/rules` +
7
+ * `@eigeninteractive/server` and dev-depend on `@eigeninteractive/testkit` alone. Everything a
8
+ * game's test suite legitimately needs from the kernel is re-exported here,
9
+ * so the kernel's own surface stays free to churn.
10
+ */
11
+ import { type SeatView } from "@eigeninteractive/kernel";
12
+ import type { GameRules, JsonObject, TransitionCause } from "@eigeninteractive/rules";
13
+ export type { CommitInput, CommitPlan, Effect, GameRow, Intent, ObservationFrame, RejectCode, Rejected, Seat, SeatView, StateRow, } from "@eigeninteractive/kernel";
14
+ export { commit, DEADLINE_GRACE_MS, deriveRng, isRejected, randomSeed, } from "@eigeninteractive/kernel";
15
+ /** Project one seat's view of a state: the stored-frame shape the same-view
16
+ * rule compares (`commit()`'s `staleViews` input). Convenience for scenario
17
+ * tests that replay a simultaneous-move race. */
18
+ export declare function projectView(rules: GameRules, args: {
19
+ state: JsonObject;
20
+ pending: number[];
21
+ /** The seat to project for, or null for a viewer. */
22
+ seat: number | null;
23
+ config: JsonObject;
24
+ cause?: TransitionCause;
25
+ participantCount?: number;
26
+ isReplay?: boolean;
27
+ }): SeatView;
@@ -1,5 +1,3 @@
1
- import { DatabaseSync } from 'node:sqlite';
2
-
3
1
  /**
4
2
  * Read a Worker's LOCAL `.wrangler` state directly: the D1 index and the
5
3
  * per-game Durable Object databases, opened as plain SQLite files.
@@ -34,9 +32,9 @@ import { DatabaseSync } from 'node:sqlite';
34
32
  *
35
33
  * @module @eigeninteractive/testkit/local-state
36
34
  */
37
-
35
+ import { DatabaseSync } from "node:sqlite";
38
36
  /** A local Durable Object database: one game's whole session. */
39
- interface LocalDurableObject {
37
+ export interface LocalDurableObject {
40
38
  /** The Durable Object class, parsed from the directory Miniflare names
41
39
  * `<worker>-<ClassName>`. */
42
40
  className: string;
@@ -53,17 +51,17 @@ interface LocalDurableObject {
53
51
  /** What a bound parameter may be: SQLite's own value domain, spelled out here
54
52
  * rather than re-exported from `node:sqlite` so the public signature does not
55
53
  * depend on a built-in module's type names. */
56
- type LocalQueryParam = string | number | bigint | null | Uint8Array;
54
+ export type LocalQueryParam = string | number | bigint | null | Uint8Array;
57
55
  /** A row of Miniflare's alarm table: the DO's armed alarm, which for a game is
58
56
  * its turn deadline plus grace. An absent row means no timer is armed, which is
59
57
  * correct for an untimed game and a bug for a timed one mid-turn. */
60
- interface LocalAlarm {
58
+ export interface LocalAlarm {
61
59
  actorId: string;
62
60
  actorName: string | null;
63
61
  scheduledTime: number | null;
64
62
  }
65
63
  /** The engine's `games` row: the D1 index entry, a display mirror of the DO. */
66
- interface LocalGameRow {
64
+ export interface LocalGameRow {
67
65
  id: string;
68
66
  createdBy: string | null;
69
67
  status: string;
@@ -89,7 +87,7 @@ interface LocalGameRow {
89
87
  }
90
88
  /** One seat, from either store. `username` is filled in from D1's `users` and
91
89
  * `bots` tables when the reader has an index to join against. */
92
- interface LocalSeat {
90
+ export interface LocalSeat {
93
91
  playerIndex: number;
94
92
  userId: string | null;
95
93
  botId: string | null;
@@ -98,7 +96,7 @@ interface LocalSeat {
98
96
  displayName: string | null;
99
97
  }
100
98
  /** The DO's single `meta` row: the authoritative session header. */
101
- interface LocalGameMeta {
99
+ export interface LocalGameMeta {
102
100
  gameId: string;
103
101
  status: string;
104
102
  access: string;
@@ -115,7 +113,7 @@ interface LocalGameMeta {
115
113
  rngSeed: string | null;
116
114
  }
117
115
  /** One committed transition, decoded. `action` is null at v0 (the start). */
118
- interface LocalTransition {
116
+ export interface LocalTransition {
119
117
  version: number;
120
118
  state: unknown;
121
119
  action: {
@@ -137,7 +135,7 @@ interface LocalTransition {
137
135
  /** Why the game is where it is, and what would move it. Derived rather than
138
136
  * stored: this is the sentence a developer actually wants, and every input to
139
137
  * it is already on screen above it. */
140
- interface LocalGameDiagnosis {
138
+ export interface LocalGameDiagnosis {
141
139
  /** One line naming the next expected event, or the reason there is none. */
142
140
  summary: string;
143
141
  /** Disagreements between the D1 mirror and the DO's own truth. A non-empty
@@ -145,7 +143,7 @@ interface LocalGameDiagnosis {
145
143
  mirrorDrift: string[];
146
144
  }
147
145
  /** Everything both stores know about one game. */
148
- interface LocalGameView {
146
+ export interface LocalGameView {
149
147
  gameId: string;
150
148
  /** The D1 index row, or null when D1 has no such game: either the id came
151
149
  * from a DO name and the index was wiped, or the create write never landed. */
@@ -182,7 +180,7 @@ interface LocalGameView {
182
180
  * inside a game repository, including the app half of a two-package layout,
183
181
  * where the state lives a directory or two above the shell's cwd.
184
182
  */
185
- declare function findWranglerState(from?: string): string | null;
183
+ export declare function findWranglerState(from?: string): string | null;
186
184
  /**
187
185
  * Open a SQLite file for reading only.
188
186
  *
@@ -196,7 +194,7 @@ declare function findWranglerState(from?: string): string | null;
196
194
  * because that fallback would otherwise CREATE a database rather than report a
197
195
  * missing one.
198
196
  */
199
- declare function openSqlite(file: string): DatabaseSync;
197
+ export declare function openSqlite(file: string): DatabaseSync;
200
198
  /**
201
199
  * A Worker's local state, with its databases opened lazily and held open.
202
200
  *
@@ -204,7 +202,7 @@ declare function openSqlite(file: string): DatabaseSync;
204
202
  * {@link close} it. A single instance is the unit both the CLI and a test use,
205
203
  * so neither has to know which file backs which resource.
206
204
  */
207
- declare class LocalStore {
205
+ export declare class LocalStore {
208
206
  #private;
209
207
  /** Absolute path to `.wrangler/state/v3`. */
210
208
  readonly root: string;
@@ -277,5 +275,3 @@ declare class LocalStore {
277
275
  /** Release every open handle. */
278
276
  close(): void;
279
277
  }
280
-
281
- export { type LocalAlarm, type LocalDurableObject, type LocalGameDiagnosis, type LocalGameMeta, type LocalGameRow, type LocalGameView, type LocalQueryParam, type LocalSeat, LocalStore, type LocalTransition, findWranglerState, openSqlite };
@@ -0,0 +1,145 @@
1
+ /**
2
+ * Twin-drift fixture runner: the TS half of the shared JSON fixtures that
3
+ * keep a version unit's TS and Dart `GameRules` twins in sync. The JSON
4
+ * fixture format is shared verbatim with the Dart runner
5
+ * (`lib/testing/twin_fixtures.dart`): one file, two consumers.
6
+ *
7
+ * One fixture file per concern lives beside the version units at
8
+ * `<fixturesRoot>/v<N>/*.json` and is consumed by BOTH sides: this module
9
+ * runs each case against the TS unit (schemas + `applyAction` +
10
+ * `computeObservation` + the two predicates), while the Dart runner runs the
11
+ * same file against the Dart twin (generated payload parsing,
12
+ * `isValidAction`, `previewAction`, predicate twins). A behavioral divergence
13
+ * then fails one side's CI instead of degrading UX in production.
14
+ *
15
+ * ## Fixture file format
16
+ *
17
+ * ```jsonc
18
+ * {
19
+ * "schemaVersion": 1,
20
+ * "cases": [
21
+ * {
22
+ * "kind": "action",
23
+ * "name": "seat 0 marks an empty cell",
24
+ * "config": {},
25
+ * "state": { ... }, // TS: applyAction input
26
+ * "obs": { ... }, // Dart-only; defaults to `state`
27
+ * "pending": [0],
28
+ * "playerIndex": 0,
29
+ * "participantCount": 2, // optional, default 2
30
+ * "rngSeed": "any string", // optional, default "twin-fixtures"
31
+ * "action": { ... },
32
+ * "expected": {
33
+ * "valid": true, // false ⇒ TS IllegalMoveError,
34
+ * // Dart isValidAction false
35
+ * "state": { ... }, // optional, TS envelope.state
36
+ * "pending": [1], // optional, TS envelope.pendingPlayers
37
+ * "outcome": [ ... ], // optional, TS envelope.outcome
38
+ * // (null asserts the game is ongoing)
39
+ * "observation": { ... } // optional, the actor's post-action
40
+ * // view: TS computeObservation slice
41
+ * // data; Dart previewAction (when the
42
+ * // game implements optimism)
43
+ * }
44
+ * },
45
+ * { "kind": "playerLimits", "name": "...", "config": {},
46
+ * "expected": { "minPlayers": 2, "maxPlayers": 2 } },
47
+ * { "kind": "ratingPool", "name": "...", "access": "public",
48
+ * "minPlayers": 2, "maxPlayers": 2, "config": {}, "expected": "blitz" },
49
+ * { "kind": "botSeatable", "name": "...", "gameConfig": {},
50
+ * "botConfig": {}, "expected": false }
51
+ * ]
52
+ * }
53
+ * ```
54
+ *
55
+ * The `state`/`obs` split exists for hidden-info games (a seat's observation
56
+ * is not the state); perfect-info games omit `obs`. `expected.observation` is
57
+ * the shared behavioral anchor: the TS side must project the post-action
58
+ * state to it, and a Dart `previewAction` that returns non-null must predict
59
+ * it, so the two sides are compared through one recorded value.
60
+ *
61
+ * Wire it up in a game-owned test file running under plain-Node vitest:
62
+ *
63
+ * ```ts
64
+ * import { twinFixtureTests } from "@eigeninteractive/testkit";
65
+ * import gameModule from "../src/module/index.js";
66
+ *
67
+ * twinFixtureTests(gameModule, new URL("../src/module/fixtures/", import.meta.url));
68
+ * ```
69
+ */
70
+ import { type GameAccess, type GameModule, type GameRules, type Json, type JsonObject, type OutcomeEntry } from "@eigeninteractive/rules";
71
+ /** One fixture file: cases targeting one `schemaVersion` unit. */
72
+ export interface TwinFixtureFile {
73
+ schemaVersion: number;
74
+ cases: TwinFixtureCase[];
75
+ }
76
+ /** A game-action case: exercises schemas, `applyAction`, and (through
77
+ * `expected.observation`) `computeObservation` for the acting seat. */
78
+ export interface ActionCase {
79
+ kind: "action";
80
+ name: string;
81
+ config: JsonObject;
82
+ state: JsonObject;
83
+ /** Dart-side observation payload; unused here (defaults to `state`). */
84
+ obs?: JsonObject;
85
+ pending: number[];
86
+ playerIndex: number;
87
+ participantCount?: number;
88
+ rngSeed?: string;
89
+ action: JsonObject;
90
+ expected: {
91
+ valid: boolean;
92
+ state?: JsonObject;
93
+ pending?: number[];
94
+ outcome?: OutcomeEntry[] | null;
95
+ observation?: JsonObject;
96
+ };
97
+ }
98
+ /** A `ratingPool` predicate case. Omitted timing fields mean null. */
99
+ export interface RatingPoolCase {
100
+ kind: "ratingPool";
101
+ name: string;
102
+ access: GameAccess;
103
+ turnSeconds?: number | null;
104
+ budgetSeconds?: number | null;
105
+ incrementSeconds?: number | null;
106
+ minPlayers: number;
107
+ maxPlayers: number;
108
+ config: JsonObject;
109
+ expected: string | null;
110
+ }
111
+ /** A `playerLimits` case: the seats one config may be played with. */
112
+ export interface PlayerLimitsCase {
113
+ kind: "playerLimits";
114
+ name: string;
115
+ config: JsonObject;
116
+ expected: {
117
+ minPlayers: number;
118
+ maxPlayers: number;
119
+ };
120
+ }
121
+ /** A `botSeatable` predicate case. */
122
+ export interface BotSeatableCase {
123
+ kind: "botSeatable";
124
+ name: string;
125
+ gameConfig: JsonObject;
126
+ botConfig: JsonObject;
127
+ expected: boolean;
128
+ }
129
+ export type TwinFixtureCase = ActionCase | PlayerLimitsCase | RatingPoolCase | BotSeatableCase;
130
+ /** Validate one fixture file's parsed JSON, or throw naming the offending
131
+ * file, case, and field. Exported so a repo can lint its fixtures without
132
+ * running them. */
133
+ export declare function parseTwinFixtureFile(path: string, json: unknown): TwinFixtureFile;
134
+ /** Run one fixture case against a rules unit, returning failure descriptions
135
+ * (empty ⇒ the case passes). Pure; the file-reading test registrar is
136
+ * {@link twinFixtureTests}. */
137
+ export declare function evaluateTwinCase(rules: GameRules, kase: TwinFixtureCase): string[];
138
+ /** Register one vitest test per fixture case found under `fixturesRoot`
139
+ * (layout: `<root>/v<N>/*.json`). Call at the top level of a test module
140
+ * running in a Node environment. */
141
+ export declare function twinFixtureTests(gameModule: GameModule, fixturesRoot: string | URL): void;
142
+ /** Structural JSON equality. Object keys with `undefined` values count as
143
+ * absent (matching how schema libraries model optional fields); array order
144
+ * matters. */
145
+ export declare function deepEquals(a: Json | undefined, b: Json | undefined): boolean;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@eigeninteractive/testkit",
3
- "version": "0.4.1",
3
+ "version": "0.5.1",
4
4
  "license": "MIT",
5
5
  "description": "Test helpers for games built on the EigenInteractive engine: drive rules through the real kernel and run shared twin fixtures, with no Worker, database or network.",
6
6
  "main": "./dist/index.js",
@@ -36,16 +36,16 @@
36
36
  "dependencies": {
37
37
  "rand-seed": "^3.0.0",
38
38
  "tsx": "^4.23.1",
39
- "@eigeninteractive/kernel": "0.4.1"
39
+ "@eigeninteractive/kernel": "0.5.1"
40
40
  },
41
41
  "devDependencies": {
42
42
  "@types/node": "^26.1.1",
43
43
  "vitest": "^4.1.10",
44
- "@eigeninteractive/rules": "0.4.1"
44
+ "@eigeninteractive/rules": "0.5.1"
45
45
  },
46
46
  "peerDependencies": {
47
47
  "vitest": "^4.1.0",
48
- "@eigeninteractive/rules": "^0.4.1"
48
+ "@eigeninteractive/rules": "^0.5.1"
49
49
  },
50
50
  "homepage": "https://eigeninteractive.com",
51
51
  "repository": {
@@ -60,7 +60,7 @@
60
60
  "access": "public"
61
61
  },
62
62
  "scripts": {
63
- "build": "tsup",
63
+ "build": "tsup && tsc -p tsconfig.build.json",
64
64
  "dev": "tsup --watch",
65
65
  "test": "vitest run --passWithNoTests",
66
66
  "typecheck": "tsc --noEmit -p tsconfig.json"
@@ -1 +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":"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","names":["readdirSync","readFileSync","fixtureFiles","readdirSync","readFileSync","readFileSync","resolve","readFileSync","resolve"]}