@contractspec/lib.testing 1.56.1 → 1.58.0

package/dist/adapters/jest-adapter.d.ts

@@ -1,13 +1,9 @@
-import { GoldenTestCase } from "../types.js";
-
-//#region src/adapters/jest-adapter.d.ts
-interface JestAdapterOptions {
-  suiteName: string;
-  cases: GoldenTestCase[];
-  runnerImport: string;
-  runnerFunction: string;
+import type { GoldenTestCase } from '../types';
+export interface JestAdapterOptions {
+    suiteName: string;
+    cases: GoldenTestCase[];
+    runnerImport: string;
+    runnerFunction: string;
 }
-declare function generateJestSuite(options: JestAdapterOptions): string;
-//#endregion
-export { JestAdapterOptions, generateJestSuite };
+export declare function generateJestSuite(options: JestAdapterOptions): string;
 //# sourceMappingURL=jest-adapter.d.ts.map

package/dist/adapters/jest-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jest-adapter.d.ts","names":[],"sources":["../../src/adapters/jest-adapter.ts"],"sourcesContent":[],"mappings":";;;UAGiB,kBAAA;;EAAA,KAAA,EAER,cAF0B,EAAA;EAOnB,YAAA,EAAA,MAAiB;;;iBAAjB,iBAAA,UAA2B"}
+{"version":3,"file":"jest-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/jest-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,UA0B5D"}

package/dist/adapters/vitest-adapter.d.ts

@@ -1,13 +1,9 @@
-import { GoldenTestCase } from "../types.js";
-
-//#region src/adapters/vitest-adapter.d.ts
-interface VitestAdapterOptions {
-  suiteName: string;
-  cases: GoldenTestCase[];
-  runnerImport: string;
-  runnerFunction: string;
+import type { GoldenTestCase } from '../types';
+export interface VitestAdapterOptions {
+    suiteName: string;
+    cases: GoldenTestCase[];
+    runnerImport: string;
+    runnerFunction: string;
 }
-declare function generateVitestSuite(options: VitestAdapterOptions): string;
-//#endregion
-export { VitestAdapterOptions, generateVitestSuite };
+export declare function generateVitestSuite(options: VitestAdapterOptions): string;
 //# sourceMappingURL=vitest-adapter.d.ts.map

package/dist/adapters/vitest-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vitest-adapter.d.ts","names":[],"sources":["../../src/adapters/vitest-adapter.ts"],"sourcesContent":[],"mappings":";;;UAGiB,oBAAA;;EAAA,KAAA,EAER,cAFQ,EAAoB;EAOrB,YAAA,EAAA,MAAA;;;iBAAA,mBAAA,UAA6B"}
+{"version":3,"file":"vitest-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/vitest-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,UA8BhE"}

package/dist/generator/assertion-builder.d.ts

@@ -1,12 +1,8 @@
-import { GoldenTestCase } from "../types.js";
-
-//#region src/generator/assertion-builder.d.ts
-interface AssertionContext {
-  runnerCall: string;
-  caseRef: string;
+import type { GoldenTestCase } from '../types';
+export interface AssertionContext {
+    runnerCall: string;
+    caseRef: string;
 }
-declare function buildAssertions(testCase: GoldenTestCase, ctx: AssertionContext): string;
-declare function serialize(value: unknown): string;
-//#endregion
-export { AssertionContext, buildAssertions, serialize };
+export declare function buildAssertions(testCase: GoldenTestCase, ctx: AssertionContext): string;
+export declare function serialize(value: unknown): string;
 //# sourceMappingURL=assertion-builder.d.ts.map

package/dist/generator/assertion-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assertion-builder.d.ts","names":[],"sources":["../../src/generator/assertion-builder.ts"],"sourcesContent":[],"mappings":";;;UAEiB,gBAAA;;EAAA,OAAA,EAAA,MAAA;AAKjB;AAegB,iBAfA,eAAA,CAeS,QAAA,EAdb,cAca,EAAA,GAAA,EAblB,gBAakB,CAAA,EAAA,MAAA;iBAAT,SAAA"}
+{"version":3,"file":"assertion-builder.d.ts","sourceRoot":"","sources":["../../src/generator/assertion-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,gBAAgB,UAWtB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,UAUvC"}

package/dist/generator/golden-test-generator.d.ts

@@ -1,27 +1,23 @@
-import { GoldenTestCase, TrafficSnapshot } from "../types.js";
-
-//#region src/generator/golden-test-generator.d.ts
-interface GoldenTestGeneratorOptions {
-  suiteName: string;
-  runnerImport: string;
-  runnerFunction: string;
-  framework?: 'vitest' | 'jest';
-  serializeMetadata?: (snapshot: TrafficSnapshot) => Record<string, unknown>;
+import type { GoldenTestCase, TrafficSnapshot } from '../types';
+export interface GoldenTestGeneratorOptions {
+    suiteName: string;
+    runnerImport: string;
+    runnerFunction: string;
+    framework?: 'vitest' | 'jest';
+    serializeMetadata?: (snapshot: TrafficSnapshot) => Record<string, unknown>;
 }
-declare class GoldenTestGenerator {
-  private readonly serializeMetadata;
-  constructor(serializeMetadata?: GoldenTestGeneratorOptions['serializeMetadata']);
-  createCases(snapshots: TrafficSnapshot[]): GoldenTestCase[];
-  generate(snapshots: TrafficSnapshot[], options: GoldenTestGeneratorOptions): string;
+export declare class GoldenTestGenerator {
+    private readonly serializeMetadata;
+    constructor(serializeMetadata?: GoldenTestGeneratorOptions['serializeMetadata']);
+    createCases(snapshots: TrafficSnapshot[]): GoldenTestCase[];
+    generate(snapshots: TrafficSnapshot[], options: GoldenTestGeneratorOptions): string;
 }
-type GoldenTestRunner = (input: unknown, metadata?: Record<string, unknown>) => Promise<unknown>;
-interface GoldenTestRunResult {
-  caseId: string;
-  passed: boolean;
-  durationMs: number;
-  error?: unknown;
+export type GoldenTestRunner = (input: unknown, metadata?: Record<string, unknown>) => Promise<unknown>;
+export interface GoldenTestRunResult {
+    caseId: string;
+    passed: boolean;
+    durationMs: number;
+    error?: unknown;
 }
-declare function runGoldenTests(cases: GoldenTestCase[], runner: GoldenTestRunner): Promise<GoldenTestRunResult[]>;
-//#endregion
-export { GoldenTestGenerator, GoldenTestGeneratorOptions, GoldenTestRunResult, GoldenTestRunner, runGoldenTests };
+export declare function runGoldenTests(cases: GoldenTestCase[], runner: GoldenTestRunner): Promise<GoldenTestRunResult[]>;
 //# sourceMappingURL=golden-test-generator.d.ts.map

package/dist/generator/golden-test-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"golden-test-generator.d.ts","names":[],"sources":["../../src/generator/golden-test-generator.ts"],"sourcesContent":[],"mappings":";;;UAMiB,0BAAA;;EAAA,YAAA,EAAA,MAAA;EAQJ,cAAA,EAAA,MAAmB;EAEQ,SAAA,CAAA,EAAA,QAAA,GAAA,MAAA;EAUf,iBAAA,CAAA,EAAA,CAAA,QAAA,EAfQ,eAeR,EAAA,GAf4B,MAe5B,CAAA,MAAA,EAAA,OAAA,CAAA;;AAeV,cA3BF,mBAAA,CA2BE;EACF,iBAAA,iBAAA;EAA0B,WAAA,CAAA,iBAAA,CAAA,EA1BC,0BA0BD,CAAA,mBAAA,CAAA;EAoB3B,WAAA,CAAA,SAAgB,EApCH,eAsCZ,EACR,CAAA,EAvCwC,cAuCjC,EAAA;EAEK,QAAA,CAAA,SAAA,EA1BF,eA0BqB,EAAA,EAAA,OAAA,EAzBvB,0BAyBuB,CAAA,EAAA,MAAA;AAOpC;AACS,KAbG,gBAAA,GAaH,CAAA,KAAA,EAAA,OAAA,EAAA,QAAA,CAAA,EAXI,MAWJ,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAVJ,OAUI,CAAA,OAAA,CAAA;AACC,UATO,mBAAA,CASP;EACC,MAAA,EAAA,MAAA;EAAR,MAAA,EAAA,OAAA;EAAO,UAAA,EAAA,MAAA;;;iBAHY,cAAA,QACb,0BACC,mBACP,QAAQ"}
+{"version":3,"file":"golden-test-generator.d.ts","sourceRoot":"","sources":["../../src/generator/golden-test-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhE,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5E;AAED,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,GAAE,0BAA0B,CAAC,mBAAmB,CAOnD;IAGjC,WAAW,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,cAAc,EAAE;IAc3D,QAAQ,CACN,SAAS,EAAE,eAAe,EAAE,EAC5B,OAAO,EAAE,0BAA0B,GAClC,MAAM;CAiBV;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EAAE,EACvB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAoChC"}

package/dist/generator/golden-test-generator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=golden-test-generator.test.d.ts.map

package/dist/generator/golden-test-generator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-test-generator.test.d.ts","sourceRoot":"","sources":["../../src/generator/golden-test-generator.test.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { GoldenTestCase, RuntimeContract, TrafficSnapshot } from "./types.js";
-import { InMemoryTrafficStore, RecordOperationInput, TrafficRecorder, TrafficRecorderOptions, TrafficStore } from "./recorder/traffic-recorder.js";
-import { GoldenTestGenerator, GoldenTestGeneratorOptions, GoldenTestRunResult, GoldenTestRunner, runGoldenTests } from "./generator/golden-test-generator.js";
-import { AssertionContext, buildAssertions, serialize } from "./generator/assertion-builder.js";
-import { VitestAdapterOptions, generateVitestSuite } from "./adapters/vitest-adapter.js";
-import { JestAdapterOptions, generateJestSuite } from "./adapters/jest-adapter.js";
-export { AssertionContext, GoldenTestCase, GoldenTestGenerator, GoldenTestGeneratorOptions, GoldenTestRunResult, GoldenTestRunner, InMemoryTrafficStore, JestAdapterOptions, RecordOperationInput, RuntimeContract, TrafficRecorder, TrafficRecorderOptions, TrafficSnapshot, TrafficStore, VitestAdapterOptions, buildAssertions, generateJestSuite, generateVitestSuite, runGoldenTests, serialize };
+export * from './types';
+export * from './recorder/traffic-recorder';
+export * from './generator/golden-test-generator';
+export * from './generator/assertion-builder';
+export * from './adapters/vitest-adapter';
+export * from './adapters/jest-adapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,7 +1,224 @@
-import { InMemoryTrafficStore, TrafficRecorder } from "./recorder/traffic-recorder.js";
-import { buildAssertions, serialize } from "./generator/assertion-builder.js";
-import { generateVitestSuite } from "./adapters/vitest-adapter.js";
-import { generateJestSuite } from "./adapters/jest-adapter.js";
-import { GoldenTestGenerator, runGoldenTests } from "./generator/golden-test-generator.js";
+// @bun
+// src/recorder/traffic-recorder.ts
+import { randomUUID } from "crypto";
 
-export { GoldenTestGenerator, InMemoryTrafficStore, TrafficRecorder, buildAssertions, generateJestSuite, generateVitestSuite, runGoldenTests, serialize };
+class InMemoryTrafficStore {
+  items = [];
+  async save(snapshot) {
+    this.items.push(snapshot);
+  }
+  async list(operation) {
+    if (!operation)
+      return [...this.items];
+    return this.items.filter((item) => item.operation.name === operation);
+  }
+}
+
+class TrafficRecorder {
+  store;
+  sampleRate;
+  sanitize;
+  constructor(options) {
+    this.store = options.store;
+    this.sampleRate = options.sampleRate ?? 1;
+    this.sanitize = options.sanitize;
+  }
+  async record(input) {
+    if (!this.shouldSample())
+      return;
+    const snapshot = {
+      id: randomUUID(),
+      operation: input.operation,
+      input: structuredCloneSafe(input.input),
+      output: structuredCloneSafe(input.output),
+      error: input.error ? structuredCloneSafe(input.error) : undefined,
+      success: input.success,
+      timestamp: new Date,
+      durationMs: input.durationMs,
+      tenantId: input.tenantId,
+      userId: input.userId,
+      channel: input.channel,
+      metadata: input.metadata
+    };
+    const sanitized = this.sanitize ? this.sanitize(snapshot) : snapshot;
+    await this.store.save(sanitized);
+  }
+  shouldSample() {
+    if (this.sampleRate >= 1)
+      return true;
+    return Math.random() <= this.sampleRate;
+  }
+}
+function structuredCloneSafe(value) {
+  if (value == null)
+    return value ?? undefined;
+  try {
+    const clone = globalThis.structuredClone;
+    if (typeof clone === "function") {
+      return clone(value);
+    }
+    return JSON.parse(JSON.stringify(value));
+  } catch {
+    return;
+  }
+}
+// src/generator/golden-test-generator.ts
+import { randomUUID as randomUUID2 } from "crypto";
+import { performance } from "perf_hooks";
+
+// src/generator/assertion-builder.ts
+function buildAssertions(testCase, ctx) {
+  if (testCase.success) {
+    return [
+      `const result = await ${ctx.runnerCall};`,
+      `expect(result).toEqual(${serialize(testCase.expectedOutput ?? null)});`
+    ].join(`
+      `);
+  }
+  return `await expect(${ctx.runnerCall}).rejects.toMatchObject(${serialize(testCase.expectedError ?? { message: "expected failure" })});`;
+}
+function serialize(value) {
+  return JSON.stringify(value, (_key, val) => {
+    if (val instanceof Date)
+      return val.toISOString();
+    if (typeof val === "undefined")
+      return null;
+    return val;
+  }, 2);
+}
+
+// src/adapters/vitest-adapter.ts
+function generateVitestSuite(options) {
+  const caseBlocks = options.cases.map((testCase) => {
+    const inputConst = serialize(testCase.input);
+    const metadataConst = serialize(testCase.metadata ?? {});
+    const assertions = testCase.success ? [
+      `const result = await ${options.runnerFunction}(input${testCase.id}, metadata${testCase.id});`,
+      `expect(result).toEqual(${serialize(testCase.expectedOutput ?? null)});`
+    ] : [
+      `await expect(${options.runnerFunction}(input${testCase.id}, metadata${testCase.id})).rejects.toMatchObject(${serialize(testCase.expectedError ?? { message: "expected failure" })});`
+    ];
+    return `
+  it('${testCase.name}', async () => {
+    const input${testCase.id} = ${inputConst};
+    const metadata${testCase.id} = ${metadataConst};
+    ${assertions.join(`
+    `)}
+  });`;
+  }).join(`
+`);
+  return `
+import { describe, it, expect } from 'bun:test';
+import { ${options.runnerFunction} } from '${options.runnerImport}';
+
+describe('${options.suiteName}', () => {${caseBlocks}
+});
+`.trim();
+}
+
+// src/adapters/jest-adapter.ts
+function generateJestSuite(options) {
+  const caseBlocks = options.cases.map((testCase) => {
+    const inputConst = serialize(testCase.input);
+    const metadataConst = serialize(testCase.metadata ?? {});
+    const successBlock = `const result = await ${options.runnerFunction}(input${testCase.id}, metadata${testCase.id});
+    expect(result).toEqual(${serialize(testCase.expectedOutput ?? null)});`;
+    const failureBlock = `await expect(${options.runnerFunction}(input${testCase.id}, metadata${testCase.id})).rejects.toMatchObject(${serialize(testCase.expectedError ?? { message: "expected failure" })});`;
+    return `
+  test('${testCase.name}', async () => {
+    const input${testCase.id} = ${inputConst};
+    const metadata${testCase.id} = ${metadataConst};
+    ${testCase.success ? successBlock : failureBlock}
+  });`;
+  }).join(`
+`);
+  return `
+import { ${options.runnerFunction} } from '${options.runnerImport}';
+
+describe('${options.suiteName}', () => {${caseBlocks}
+});
+`.trim();
+}
+
+// src/generator/golden-test-generator.ts
+class GoldenTestGenerator {
+  serializeMetadata;
+  constructor(serializeMetadata = (snapshot) => ({
+    tenantId: snapshot.tenantId,
+    userId: snapshot.userId,
+    channel: snapshot.channel
+  })) {
+    this.serializeMetadata = serializeMetadata;
+  }
+  createCases(snapshots) {
+    return snapshots.map((snapshot, index) => ({
+      id: snapshot.id ?? randomUUID2(),
+      name: snapshot.success ? `case-${index + 1}-success` : `case-${index + 1}-failure`,
+      input: snapshot.input,
+      expectedOutput: snapshot.output,
+      expectedError: snapshot.error,
+      success: snapshot.success,
+      metadata: this.serializeMetadata?.(snapshot)
+    }));
+  }
+  generate(snapshots, options) {
+    const cases = this.createCases(snapshots);
+    if (options.framework === "jest") {
+      return generateJestSuite({
+        suiteName: options.suiteName,
+        cases,
+        runnerImport: options.runnerImport,
+        runnerFunction: options.runnerFunction
+      });
+    }
+    return generateVitestSuite({
+      suiteName: options.suiteName,
+      cases,
+      runnerImport: options.runnerImport,
+      runnerFunction: options.runnerFunction
+    });
+  }
+}
+async function runGoldenTests(cases, runner) {
+  const results = [];
+  for (const testCase of cases) {
+    const startedAt = performance.now();
+    try {
+      const output = await runner(testCase.input, testCase.metadata);
+      if (!testCase.success) {
+        results.push({
+          caseId: testCase.id,
+          passed: false,
+          durationMs: performance.now() - startedAt,
+          error: new Error("Expected failure but runner resolved")
+        });
+        continue;
+      }
+      const matches = JSON.stringify(output) === JSON.stringify(testCase.expectedOutput ?? null);
+      results.push({
+        caseId: testCase.id,
+        passed: matches,
+        durationMs: performance.now() - startedAt,
+        error: matches ? undefined : { expected: testCase.expectedOutput, received: output }
+      });
+    } catch (error) {
+      const durationMs = performance.now() - startedAt;
+      if (!testCase.success) {
+        results.push({ caseId: testCase.id, passed: true, durationMs });
+      } else {
+        results.push({ caseId: testCase.id, passed: false, durationMs, error });
+      }
+    }
+  }
+  return results;
+}
+export {
+  serialize,
+  runGoldenTests,
+  generateVitestSuite,
+  generateJestSuite,
+  buildAssertions,
+  TrafficRecorder,
+  InMemoryTrafficStore,
+  GoldenTestGenerator
+};

package/dist/node/index.js

@@ -0,0 +1,223 @@
+// src/recorder/traffic-recorder.ts
+import { randomUUID } from "node:crypto";
+
+class InMemoryTrafficStore {
+  items = [];
+  async save(snapshot) {
+    this.items.push(snapshot);
+  }
+  async list(operation) {
+    if (!operation)
+      return [...this.items];
+    return this.items.filter((item) => item.operation.name === operation);
+  }
+}
+
+class TrafficRecorder {
+  store;
+  sampleRate;
+  sanitize;
+  constructor(options) {
+    this.store = options.store;
+    this.sampleRate = options.sampleRate ?? 1;
+    this.sanitize = options.sanitize;
+  }
+  async record(input) {
+    if (!this.shouldSample())
+      return;
+    const snapshot = {
+      id: randomUUID(),
+      operation: input.operation,
+      input: structuredCloneSafe(input.input),
+      output: structuredCloneSafe(input.output),
+      error: input.error ? structuredCloneSafe(input.error) : undefined,
+      success: input.success,
+      timestamp: new Date,
+      durationMs: input.durationMs,
+      tenantId: input.tenantId,
+      userId: input.userId,
+      channel: input.channel,
+      metadata: input.metadata
+    };
+    const sanitized = this.sanitize ? this.sanitize(snapshot) : snapshot;
+    await this.store.save(sanitized);
+  }
+  shouldSample() {
+    if (this.sampleRate >= 1)
+      return true;
+    return Math.random() <= this.sampleRate;
+  }
+}
+function structuredCloneSafe(value) {
+  if (value == null)
+    return value ?? undefined;
+  try {
+    const clone = globalThis.structuredClone;
+    if (typeof clone === "function") {
+      return clone(value);
+    }
+    return JSON.parse(JSON.stringify(value));
+  } catch {
+    return;
+  }
+}
+// src/generator/golden-test-generator.ts
+import { randomUUID as randomUUID2 } from "node:crypto";
+import { performance } from "node:perf_hooks";
+
+// src/generator/assertion-builder.ts
+function buildAssertions(testCase, ctx) {
+  if (testCase.success) {
+    return [
+      `const result = await ${ctx.runnerCall};`,
+      `expect(result).toEqual(${serialize(testCase.expectedOutput ?? null)});`
+    ].join(`
+      `);
+  }
+  return `await expect(${ctx.runnerCall}).rejects.toMatchObject(${serialize(testCase.expectedError ?? { message: "expected failure" })});`;
+}
+function serialize(value) {
+  return JSON.stringify(value, (_key, val) => {
+    if (val instanceof Date)
+      return val.toISOString();
+    if (typeof val === "undefined")
+      return null;
+    return val;
+  }, 2);
+}
+
+// src/adapters/vitest-adapter.ts
+function generateVitestSuite(options) {
+  const caseBlocks = options.cases.map((testCase) => {
+    const inputConst = serialize(testCase.input);
+    const metadataConst = serialize(testCase.metadata ?? {});
+    const assertions = testCase.success ? [
+      `const result = await ${options.runnerFunction}(input${testCase.id}, metadata${testCase.id});`,
+      `expect(result).toEqual(${serialize(testCase.expectedOutput ?? null)});`
+    ] : [
+      `await expect(${options.runnerFunction}(input${testCase.id}, metadata${testCase.id})).rejects.toMatchObject(${serialize(testCase.expectedError ?? { message: "expected failure" })});`
+    ];
+    return `
+  it('${testCase.name}', async () => {
+    const input${testCase.id} = ${inputConst};
+    const metadata${testCase.id} = ${metadataConst};
+    ${assertions.join(`
+    `)}
+  });`;
+  }).join(`
+`);
+  return `
+import { describe, it, expect } from 'bun:test';
+import { ${options.runnerFunction} } from '${options.runnerImport}';
+
+describe('${options.suiteName}', () => {${caseBlocks}
+});
+`.trim();
+}
+
+// src/adapters/jest-adapter.ts
+function generateJestSuite(options) {
+  const caseBlocks = options.cases.map((testCase) => {
+    const inputConst = serialize(testCase.input);
+    const metadataConst = serialize(testCase.metadata ?? {});
+    const successBlock = `const result = await ${options.runnerFunction}(input${testCase.id}, metadata${testCase.id});
+    expect(result).toEqual(${serialize(testCase.expectedOutput ?? null)});`;
+    const failureBlock = `await expect(${options.runnerFunction}(input${testCase.id}, metadata${testCase.id})).rejects.toMatchObject(${serialize(testCase.expectedError ?? { message: "expected failure" })});`;
+    return `
+  test('${testCase.name}', async () => {
+    const input${testCase.id} = ${inputConst};
+    const metadata${testCase.id} = ${metadataConst};
+    ${testCase.success ? successBlock : failureBlock}
+  });`;
+  }).join(`
+`);
+  return `
+import { ${options.runnerFunction} } from '${options.runnerImport}';
+
+describe('${options.suiteName}', () => {${caseBlocks}
+});
+`.trim();
+}
+
+// src/generator/golden-test-generator.ts
+class GoldenTestGenerator {
+  serializeMetadata;
+  constructor(serializeMetadata = (snapshot) => ({
+    tenantId: snapshot.tenantId,
+    userId: snapshot.userId,
+    channel: snapshot.channel
+  })) {
+    this.serializeMetadata = serializeMetadata;
+  }
+  createCases(snapshots) {
+    return snapshots.map((snapshot, index) => ({
+      id: snapshot.id ?? randomUUID2(),
+      name: snapshot.success ? `case-${index + 1}-success` : `case-${index + 1}-failure`,
+      input: snapshot.input,
+      expectedOutput: snapshot.output,
+      expectedError: snapshot.error,
+      success: snapshot.success,
+      metadata: this.serializeMetadata?.(snapshot)
+    }));
+  }
+  generate(snapshots, options) {
+    const cases = this.createCases(snapshots);
+    if (options.framework === "jest") {
+      return generateJestSuite({
+        suiteName: options.suiteName,
+        cases,
+        runnerImport: options.runnerImport,
+        runnerFunction: options.runnerFunction
+      });
+    }
+    return generateVitestSuite({
+      suiteName: options.suiteName,
+      cases,
+      runnerImport: options.runnerImport,
+      runnerFunction: options.runnerFunction
+    });
+  }
+}
+async function runGoldenTests(cases, runner) {
+  const results = [];
+  for (const testCase of cases) {
+    const startedAt = performance.now();
+    try {
+      const output = await runner(testCase.input, testCase.metadata);
+      if (!testCase.success) {
+        results.push({
+          caseId: testCase.id,
+          passed: false,
+          durationMs: performance.now() - startedAt,
+          error: new Error("Expected failure but runner resolved")
+        });
+        continue;
+      }
+      const matches = JSON.stringify(output) === JSON.stringify(testCase.expectedOutput ?? null);
+      results.push({
+        caseId: testCase.id,
+        passed: matches,
+        durationMs: performance.now() - startedAt,
+        error: matches ? undefined : { expected: testCase.expectedOutput, received: output }
+      });
+    } catch (error) {
+      const durationMs = performance.now() - startedAt;
+      if (!testCase.success) {
+        results.push({ caseId: testCase.id, passed: true, durationMs });
+      } else {
+        results.push({ caseId: testCase.id, passed: false, durationMs, error });
+      }
+    }
+  }
+  return results;
+}
+export {
+  serialize,
+  runGoldenTests,
+  generateVitestSuite,
+  generateJestSuite,
+  buildAssertions,
+  TrafficRecorder,
+  InMemoryTrafficStore,
+  GoldenTestGenerator
+};