@contractspec/lib.testing 0.0.0-canary-20260113162409

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.
Files changed (213) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +51 -0
  3. package/dist/adapters/jest-adapter.d.ts +13 -0
  4. package/dist/adapters/jest-adapter.d.ts.map +1 -0
  5. package/dist/adapters/jest-adapter.js +28 -0
  6. package/dist/adapters/jest-adapter.js.map +1 -0
  7. package/dist/adapters/vitest-adapter.d.ts +13 -0
  8. package/dist/adapters/vitest-adapter.d.ts.map +1 -0
  9. package/dist/adapters/vitest-adapter.js +27 -0
  10. package/dist/adapters/vitest-adapter.js.map +1 -0
  11. package/dist/contracts/src/app-config/lifecycle.d.ts +1 -0
  12. package/dist/contracts/src/app-config/runtime.d.ts +13 -0
  13. package/dist/contracts/src/app-config/spec.d.ts +9 -0
  14. package/dist/contracts/src/app-config/validation.d.ts +8 -0
  15. package/dist/contracts/src/capabilities/capabilities.d.ts +1 -0
  16. package/dist/contracts/src/capabilities/index.d.ts +2 -0
  17. package/dist/contracts/src/capabilities/openbanking.d.ts +1 -0
  18. package/dist/contracts/src/client/index.d.ts +1 -0
  19. package/dist/contracts/src/client/react/drivers/rn-reusables.d.ts +1 -0
  20. package/dist/contracts/src/client/react/drivers/shadcn.d.ts +1 -0
  21. package/dist/contracts/src/client/react/feature-render.d.ts +3 -0
  22. package/dist/contracts/src/client/react/form-render.d.ts +4 -0
  23. package/dist/contracts/src/client/react/index.d.ts +4 -0
  24. package/dist/contracts/src/contract-registry/index.d.ts +2 -0
  25. package/dist/contracts/src/contract-registry/schemas.d.ts +2 -0
  26. package/dist/contracts/src/contract-registry/types.d.ts +1 -0
  27. package/dist/contracts/src/data-views/index.d.ts +3 -0
  28. package/dist/contracts/src/data-views/registry.d.ts +2 -0
  29. package/dist/contracts/src/data-views/spec.d.ts +2 -0
  30. package/dist/contracts/src/data-views/types.d.ts +2 -0
  31. package/dist/contracts/src/docs/accessibility_wcag_compliance_specs.docblock.d.ts +1 -0
  32. package/dist/contracts/src/docs/index.d.ts +25 -0
  33. package/dist/contracts/src/docs/presentations.d.ts +2 -0
  34. package/dist/contracts/src/docs/registry.d.ts +10 -0
  35. package/dist/contracts/src/docs/registry.d.ts.map +1 -0
  36. package/dist/contracts/src/docs/tech/auth/better-auth-nextjs.docblock.d.ts +1 -0
  37. package/dist/contracts/src/docs/tech/contracts/README.docblock.d.ts +1 -0
  38. package/dist/contracts/src/docs/tech/contracts/openapi-export.docblock.d.ts +1 -0
  39. package/dist/contracts/src/docs/tech/contracts/openapi-import.docblock.d.ts +1 -0
  40. package/dist/contracts/src/docs/tech/lifecycle-stage-system.docblock.d.ts +1 -0
  41. package/dist/contracts/src/docs/tech/llm/llm-integration.docblock.d.ts +1 -0
  42. package/dist/contracts/src/docs/tech/mcp-endpoints.docblock.d.ts +1 -0
  43. package/dist/contracts/src/docs/tech/presentation-runtime.docblock.d.ts +1 -0
  44. package/dist/contracts/src/docs/tech/schema/README.docblock.d.ts +1 -0
  45. package/dist/contracts/src/docs/tech/studio/learning-events.docblock.d.ts +1 -0
  46. package/dist/contracts/src/docs/tech/studio/learning-journeys.docblock.d.ts +1 -0
  47. package/dist/contracts/src/docs/tech/studio/platform-admin-panel.docblock.d.ts +1 -0
  48. package/dist/contracts/src/docs/tech/studio/project-access-teams.docblock.d.ts +1 -0
  49. package/dist/contracts/src/docs/tech/studio/project-routing.docblock.d.ts +1 -0
  50. package/dist/contracts/src/docs/tech/studio/sandbox-unlogged.docblock.d.ts +1 -0
  51. package/dist/contracts/src/docs/tech/studio/team-invitations.docblock.d.ts +1 -0
  52. package/dist/contracts/src/docs/tech/studio/workspace-ops.docblock.d.ts +1 -0
  53. package/dist/contracts/src/docs/tech/studio/workspaces.docblock.d.ts +1 -0
  54. package/dist/contracts/src/docs/tech/telemetry-ingest.docblock.d.ts +1 -0
  55. package/dist/contracts/src/docs/tech/vscode-extension.docblock.d.ts +1 -0
  56. package/dist/contracts/src/events.d.ts +25 -0
  57. package/dist/contracts/src/events.d.ts.map +1 -0
  58. package/dist/contracts/src/examples/index.d.ts +4 -0
  59. package/dist/contracts/src/examples/registry.d.ts +2 -0
  60. package/dist/contracts/src/examples/schema.d.ts +2 -0
  61. package/dist/contracts/src/examples/types.d.ts +3 -0
  62. package/dist/contracts/src/examples/validation.d.ts +1 -0
  63. package/dist/contracts/src/experiments/evaluator.d.ts +2 -0
  64. package/dist/contracts/src/experiments/spec-resolver.d.ts +4 -0
  65. package/dist/contracts/src/experiments/spec.d.ts +4 -0
  66. package/dist/contracts/src/features/index.d.ts +4 -0
  67. package/dist/contracts/src/features/install.d.ts +6 -0
  68. package/dist/contracts/src/features/registry.d.ts +2 -0
  69. package/dist/contracts/src/features/types.d.ts +5 -0
  70. package/dist/contracts/src/features/validation.d.ts +2 -0
  71. package/dist/contracts/src/forms/forms.d.ts +3 -0
  72. package/dist/contracts/src/forms/index.d.ts +1 -0
  73. package/dist/contracts/src/index.d.ts +48 -0
  74. package/dist/contracts/src/install.d.ts +7 -0
  75. package/dist/contracts/src/integrations/connection.d.ts +1 -0
  76. package/dist/contracts/src/integrations/index.d.ts +6 -0
  77. package/dist/contracts/src/integrations/openbanking/contracts/accounts.d.ts +4 -0
  78. package/dist/contracts/src/integrations/openbanking/contracts/balances.d.ts +4 -0
  79. package/dist/contracts/src/integrations/openbanking/contracts/index.d.ts +5 -0
  80. package/dist/contracts/src/integrations/openbanking/contracts/transactions.d.ts +4 -0
  81. package/dist/contracts/src/integrations/openbanking/guards.d.ts +1 -0
  82. package/dist/contracts/src/integrations/openbanking/models.d.ts +1 -0
  83. package/dist/contracts/src/integrations/openbanking/openbanking.feature.d.ts +1 -0
  84. package/dist/contracts/src/integrations/operations.d.ts +4 -0
  85. package/dist/contracts/src/integrations/providers/elevenlabs.d.ts +2 -0
  86. package/dist/contracts/src/integrations/providers/gcs-storage.d.ts +2 -0
  87. package/dist/contracts/src/integrations/providers/gmail.d.ts +2 -0
  88. package/dist/contracts/src/integrations/providers/google-calendar.d.ts +2 -0
  89. package/dist/contracts/src/integrations/providers/index.d.ts +11 -0
  90. package/dist/contracts/src/integrations/providers/mistral.d.ts +2 -0
  91. package/dist/contracts/src/integrations/providers/postmark.d.ts +2 -0
  92. package/dist/contracts/src/integrations/providers/powens.d.ts +2 -0
  93. package/dist/contracts/src/integrations/providers/qdrant.d.ts +2 -0
  94. package/dist/contracts/src/integrations/providers/registry.d.ts +1 -0
  95. package/dist/contracts/src/integrations/providers/stripe.d.ts +2 -0
  96. package/dist/contracts/src/integrations/providers/twilio-sms.d.ts +2 -0
  97. package/dist/contracts/src/integrations/spec.d.ts +3 -0
  98. package/dist/contracts/src/jsonschema.d.ts +4 -0
  99. package/dist/contracts/src/knowledge/index.d.ts +2 -0
  100. package/dist/contracts/src/knowledge/operations.d.ts +4 -0
  101. package/dist/contracts/src/knowledge/spaces/email-threads.d.ts +1 -0
  102. package/dist/contracts/src/knowledge/spaces/financial-docs.d.ts +1 -0
  103. package/dist/contracts/src/knowledge/spaces/financial-overview.d.ts +1 -0
  104. package/dist/contracts/src/knowledge/spaces/index.d.ts +6 -0
  105. package/dist/contracts/src/knowledge/spaces/product-canon.d.ts +1 -0
  106. package/dist/contracts/src/knowledge/spaces/support-faq.d.ts +1 -0
  107. package/dist/contracts/src/knowledge/spaces/uploaded-docs.d.ts +1 -0
  108. package/dist/contracts/src/knowledge/spec.d.ts +3 -0
  109. package/dist/contracts/src/llm/exporters.d.ts +7 -0
  110. package/dist/contracts/src/llm/index.d.ts +3 -0
  111. package/dist/contracts/src/llm/prompts.d.ts +2 -0
  112. package/dist/contracts/src/llm/types.d.ts +5 -0
  113. package/dist/contracts/src/migrations.d.ts +1 -0
  114. package/dist/contracts/src/model-registry.d.ts +1 -0
  115. package/dist/contracts/src/onboarding-base.d.ts +2 -0
  116. package/dist/contracts/src/openapi.d.ts +1 -0
  117. package/dist/contracts/src/operations/index.d.ts +2 -0
  118. package/dist/contracts/src/operations/operation.d.ts +170 -0
  119. package/dist/contracts/src/operations/operation.d.ts.map +1 -0
  120. package/dist/contracts/src/operations/registry.d.ts +6 -0
  121. package/dist/contracts/src/ownership.d.ts +61 -0
  122. package/dist/contracts/src/ownership.d.ts.map +1 -0
  123. package/dist/contracts/src/policy/engine.d.ts +3 -0
  124. package/dist/contracts/src/policy/index.d.ts +4 -0
  125. package/dist/contracts/src/policy/opa-adapter.d.ts +3 -0
  126. package/dist/contracts/src/policy/registry.d.ts +2 -0
  127. package/dist/contracts/src/policy/spec.d.ts +11 -0
  128. package/dist/contracts/src/policy/spec.d.ts.map +1 -0
  129. package/dist/contracts/src/presentations/index.d.ts +3 -0
  130. package/dist/contracts/src/presentations/presentations.d.ts +2 -0
  131. package/dist/contracts/src/presentations/registry.d.ts +2 -0
  132. package/dist/contracts/src/presentations/transform-engine.d.ts +2 -0
  133. package/dist/contracts/src/prompt.d.ts +2 -0
  134. package/dist/contracts/src/promptRegistry.d.ts +2 -0
  135. package/dist/contracts/src/regenerator/adapters.d.ts +1 -0
  136. package/dist/contracts/src/regenerator/executor.d.ts +1 -0
  137. package/dist/contracts/src/regenerator/index.d.ts +6 -0
  138. package/dist/contracts/src/regenerator/service.d.ts +2 -0
  139. package/dist/contracts/src/regenerator/sinks.d.ts +2 -0
  140. package/dist/contracts/src/regenerator/types.d.ts +3 -0
  141. package/dist/contracts/src/regenerator/utils.d.ts +1 -0
  142. package/dist/contracts/src/registry-utils.d.ts +1 -0
  143. package/dist/contracts/src/registry.d.ts +3 -0
  144. package/dist/contracts/src/resources.d.ts +19 -0
  145. package/dist/contracts/src/resources.d.ts.map +1 -0
  146. package/dist/contracts/src/schema-to-markdown.d.ts +1 -0
  147. package/dist/contracts/src/server/graphql-pothos.d.ts +7 -0
  148. package/dist/contracts/src/server/index.d.ts +7 -0
  149. package/dist/contracts/src/server/mcp/createMcpServer.d.ts +5 -0
  150. package/dist/contracts/src/server/mcp/mcpTypes.d.ts +2 -0
  151. package/dist/contracts/src/server/provider-mcp.d.ts +1 -0
  152. package/dist/contracts/src/server/rest-elysia.d.ts +3 -0
  153. package/dist/contracts/src/server/rest-express.d.ts +3 -0
  154. package/dist/contracts/src/server/rest-generic.d.ts +2 -0
  155. package/dist/contracts/src/server/rest-next-app.d.ts +3 -0
  156. package/dist/contracts/src/server/rest-next-pages.d.ts +3 -0
  157. package/dist/contracts/src/telemetry/anomaly.d.ts +2 -0
  158. package/dist/contracts/src/telemetry/index.d.ts +3 -0
  159. package/dist/contracts/src/telemetry/spec.d.ts +2 -0
  160. package/dist/contracts/src/telemetry/tracker.d.ts +2 -0
  161. package/dist/contracts/src/tests/index.d.ts +2 -0
  162. package/dist/contracts/src/tests/runner.d.ts +3 -0
  163. package/dist/contracts/src/tests/spec.d.ts +11 -0
  164. package/dist/contracts/src/tests/spec.d.ts.map +1 -0
  165. package/dist/contracts/src/themes.d.ts +2 -0
  166. package/dist/contracts/src/types.d.ts +5 -0
  167. package/dist/contracts/src/workflow/adapters/db-adapter.d.ts +1 -0
  168. package/dist/contracts/src/workflow/adapters/file-adapter.d.ts +1 -0
  169. package/dist/contracts/src/workflow/adapters/index.d.ts +3 -0
  170. package/dist/contracts/src/workflow/adapters/memory-store.d.ts +1 -0
  171. package/dist/contracts/src/workflow/index.d.ts +5 -0
  172. package/dist/contracts/src/workflow/overview.docblock.d.ts +1 -0
  173. package/dist/contracts/src/workflow/runner.d.ts +5 -0
  174. package/dist/contracts/src/workflow/spec.d.ts +5 -0
  175. package/dist/contracts/src/workflow/state.d.ts +1 -0
  176. package/dist/contracts/src/workflow/validation.d.ts +3 -0
  177. package/dist/contracts/src/workspace-config/contractsrc-schema.d.ts +1 -0
  178. package/dist/contracts/src/workspace-config/index.d.ts +1 -0
  179. package/dist/contracts/src/workspace-config/workspace-config.docblock.d.ts +1 -0
  180. package/dist/generator/assertion-builder.d.ts +12 -0
  181. package/dist/generator/assertion-builder.d.ts.map +1 -0
  182. package/dist/generator/assertion-builder.js +16 -0
  183. package/dist/generator/assertion-builder.js.map +1 -0
  184. package/dist/generator/golden-test-generator.d.ts +27 -0
  185. package/dist/generator/golden-test-generator.d.ts.map +1 -0
  186. package/dist/generator/golden-test-generator.js +87 -0
  187. package/dist/generator/golden-test-generator.js.map +1 -0
  188. package/dist/index.d.ts +7 -0
  189. package/dist/index.js +7 -0
  190. package/dist/recorder/traffic-recorder.d.ts +40 -0
  191. package/dist/recorder/traffic-recorder.d.ts.map +1 -0
  192. package/dist/recorder/traffic-recorder.js +60 -0
  193. package/dist/recorder/traffic-recorder.js.map +1 -0
  194. package/dist/schema/src/EnumType.d.ts +36 -0
  195. package/dist/schema/src/EnumType.d.ts.map +1 -0
  196. package/dist/schema/src/FieldType.d.ts +30 -0
  197. package/dist/schema/src/FieldType.d.ts.map +1 -0
  198. package/dist/schema/src/GraphQLSchemaType.d.ts +2 -0
  199. package/dist/schema/src/JsonSchemaType.d.ts +2 -0
  200. package/dist/schema/src/ScalarTypeEnum.d.ts +1 -0
  201. package/dist/schema/src/SchemaModel.d.ts +70 -0
  202. package/dist/schema/src/SchemaModel.d.ts.map +1 -0
  203. package/dist/schema/src/SchemaModelType.d.ts +38 -0
  204. package/dist/schema/src/SchemaModelType.d.ts.map +1 -0
  205. package/dist/schema/src/ZodSchemaType.d.ts +2 -0
  206. package/dist/schema/src/entity/defineEntity.d.ts +1 -0
  207. package/dist/schema/src/entity/generator.d.ts +1 -0
  208. package/dist/schema/src/entity/index.d.ts +3 -0
  209. package/dist/schema/src/entity/types.d.ts +1 -0
  210. package/dist/schema/src/index.d.ts +9 -0
  211. package/dist/types.d.ts +46 -0
  212. package/dist/types.d.ts.map +1 -0
  213. package/package.json +59 -0
@@ -0,0 +1,3 @@
1
+ import "./spec.js";
2
+ import "../types.js";
3
+ import "../index.js";
@@ -0,0 +1,11 @@
1
+ import "../ownership.js";
2
+
3
+ //#region ../contracts/src/tests/spec.d.ts
4
+
5
+ interface TestSpecRef {
6
+ key: string;
7
+ version?: string;
8
+ }
9
+ //#endregion
10
+ export { TestSpecRef };
11
+ //# sourceMappingURL=spec.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../contracts/src/tests/spec.ts"],"sourcesContent":[],"mappings":";;;;UAiFiB,WAAA"}
@@ -0,0 +1,2 @@
1
+ import "./ownership.js";
2
+ import "./registry.js";
@@ -0,0 +1,5 @@
1
+ import "./policy/spec.js";
2
+ import "./telemetry/index.js";
3
+ import "./app-config/runtime.js";
4
+ import "./experiments/spec-resolver.js";
5
+ import "./events.js";
@@ -0,0 +1 @@
1
+ import "../state.js";
@@ -0,0 +1 @@
1
+ import "../state.js";
@@ -0,0 +1,3 @@
1
+ import "./memory-store.js";
2
+ import "./db-adapter.js";
3
+ import "./file-adapter.js";
@@ -0,0 +1 @@
1
+ import "../state.js";
@@ -0,0 +1,5 @@
1
+ import "./spec.js";
2
+ import "./validation.js";
3
+ import "./state.js";
4
+ import "./runner.js";
5
+ import "./adapters/index.js";
@@ -0,0 +1 @@
1
+ import "../docs/index.js";
@@ -0,0 +1,5 @@
1
+ import "../features/index.js";
2
+ import "./spec.js";
3
+ import "../app-config/runtime.js";
4
+ import "../types.js";
5
+ import "./state.js";
@@ -0,0 +1,5 @@
1
+ import "../ownership.js";
2
+ import "../capabilities/index.js";
3
+ import "../experiments/spec.js";
4
+ import "../features/index.js";
5
+ import "../registry.js";
@@ -0,0 +1 @@
1
+ import "./spec.js";
@@ -0,0 +1,3 @@
1
+ import "../operations/registry.js";
2
+ import "./spec.js";
3
+ import "../forms/index.js";
@@ -0,0 +1 @@
1
+ import "./contractsrc-schema.js";
@@ -0,0 +1 @@
1
+ import "../docs/index.js";
@@ -0,0 +1,12 @@
1
+ import { GoldenTestCase } from "../types.js";
2
+
3
+ //#region src/generator/assertion-builder.d.ts
4
+ interface AssertionContext {
5
+ runnerCall: string;
6
+ caseRef: string;
7
+ }
8
+ declare function buildAssertions(testCase: GoldenTestCase, ctx: AssertionContext): string;
9
+ declare function serialize(value: unknown): string;
10
+ //#endregion
11
+ export { AssertionContext, buildAssertions, serialize };
12
+ //# sourceMappingURL=assertion-builder.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,16 @@
1
+ //#region src/generator/assertion-builder.ts
2
+ function buildAssertions(testCase, ctx) {
3
+ if (testCase.success) return [`const result = await ${ctx.runnerCall};`, `expect(result).toEqual(${serialize(testCase.expectedOutput ?? null)});`].join("\n ");
4
+ return `await expect(${ctx.runnerCall}).rejects.toMatchObject(${serialize(testCase.expectedError ?? { message: "expected failure" })});`;
5
+ }
6
+ function serialize(value) {
7
+ return JSON.stringify(value, (_key, val) => {
8
+ if (val instanceof Date) return val.toISOString();
9
+ if (typeof val === "undefined") return null;
10
+ return val;
11
+ }, 2);
12
+ }
13
+
14
+ //#endregion
15
+ export { buildAssertions, serialize };
16
+ //# sourceMappingURL=assertion-builder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"assertion-builder.js","names":[],"sources":["../../src/generator/assertion-builder.ts"],"sourcesContent":["import type { GoldenTestCase } from '../types';\n\nexport interface AssertionContext {\n runnerCall: string;\n caseRef: string;\n}\n\nexport function buildAssertions(\n testCase: GoldenTestCase,\n ctx: AssertionContext\n) {\n if (testCase.success) {\n return [\n `const result = await ${ctx.runnerCall};`,\n `expect(result).toEqual(${serialize(testCase.expectedOutput ?? null)});`,\n ].join('\\n ');\n }\n return `await expect(${ctx.runnerCall}).rejects.toMatchObject(${serialize(\n testCase.expectedError ?? { message: 'expected failure' }\n )});`;\n}\n\nexport function serialize(value: unknown) {\n return JSON.stringify(\n value,\n (_key, val) => {\n if (val instanceof Date) return val.toISOString();\n if (typeof val === 'undefined') return null;\n return val;\n },\n 2\n );\n}\n"],"mappings":";AAOA,SAAgB,gBACd,UACA,KACA;AACA,KAAI,SAAS,QACX,QAAO,CACL,wBAAwB,IAAI,WAAW,IACvC,0BAA0B,UAAU,SAAS,kBAAkB,KAAK,CAAC,IACtE,CAAC,KAAK,WAAW;AAEpB,QAAO,gBAAgB,IAAI,WAAW,0BAA0B,UAC9D,SAAS,iBAAiB,EAAE,SAAS,oBAAoB,CAC1D,CAAC;;AAGJ,SAAgB,UAAU,OAAgB;AACxC,QAAO,KAAK,UACV,QACC,MAAM,QAAQ;AACb,MAAI,eAAe,KAAM,QAAO,IAAI,aAAa;AACjD,MAAI,OAAO,QAAQ,YAAa,QAAO;AACvC,SAAO;IAET,EACD"}
@@ -0,0 +1,27 @@
1
+ import { GoldenTestCase, TrafficSnapshot } from "../types.js";
2
+
3
+ //#region src/generator/golden-test-generator.d.ts
4
+ interface GoldenTestGeneratorOptions {
5
+ suiteName: string;
6
+ runnerImport: string;
7
+ runnerFunction: string;
8
+ framework?: 'vitest' | 'jest';
9
+ serializeMetadata?: (snapshot: TrafficSnapshot) => Record<string, unknown>;
10
+ }
11
+ declare class GoldenTestGenerator {
12
+ private readonly serializeMetadata;
13
+ constructor(serializeMetadata?: GoldenTestGeneratorOptions['serializeMetadata']);
14
+ createCases(snapshots: TrafficSnapshot[]): GoldenTestCase[];
15
+ generate(snapshots: TrafficSnapshot[], options: GoldenTestGeneratorOptions): string;
16
+ }
17
+ type GoldenTestRunner = (input: unknown, metadata?: Record<string, unknown>) => Promise<unknown>;
18
+ interface GoldenTestRunResult {
19
+ caseId: string;
20
+ passed: boolean;
21
+ durationMs: number;
22
+ error?: unknown;
23
+ }
24
+ declare function runGoldenTests(cases: GoldenTestCase[], runner: GoldenTestRunner): Promise<GoldenTestRunResult[]>;
25
+ //#endregion
26
+ export { GoldenTestGenerator, GoldenTestGeneratorOptions, GoldenTestRunResult, GoldenTestRunner, runGoldenTests };
27
+ //# sourceMappingURL=golden-test-generator.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,87 @@
1
+ import { generateVitestSuite } from "../adapters/vitest-adapter.js";
2
+ import { generateJestSuite } from "../adapters/jest-adapter.js";
3
+ import { randomUUID } from "node:crypto";
4
+ import { performance } from "node:perf_hooks";
5
+
6
+ //#region src/generator/golden-test-generator.ts
7
+ var GoldenTestGenerator = class {
8
+ constructor(serializeMetadata = (snapshot) => ({
9
+ tenantId: snapshot.tenantId,
10
+ userId: snapshot.userId,
11
+ channel: snapshot.channel
12
+ })) {
13
+ this.serializeMetadata = serializeMetadata;
14
+ }
15
+ createCases(snapshots) {
16
+ return snapshots.map((snapshot, index) => ({
17
+ id: snapshot.id ?? randomUUID(),
18
+ name: snapshot.success ? `case-${index + 1}-success` : `case-${index + 1}-failure`,
19
+ input: snapshot.input,
20
+ expectedOutput: snapshot.output,
21
+ expectedError: snapshot.error,
22
+ success: snapshot.success,
23
+ metadata: this.serializeMetadata?.(snapshot)
24
+ }));
25
+ }
26
+ generate(snapshots, options) {
27
+ const cases = this.createCases(snapshots);
28
+ if (options.framework === "jest") return generateJestSuite({
29
+ suiteName: options.suiteName,
30
+ cases,
31
+ runnerImport: options.runnerImport,
32
+ runnerFunction: options.runnerFunction
33
+ });
34
+ return generateVitestSuite({
35
+ suiteName: options.suiteName,
36
+ cases,
37
+ runnerImport: options.runnerImport,
38
+ runnerFunction: options.runnerFunction
39
+ });
40
+ }
41
+ };
42
+ async function runGoldenTests(cases, runner) {
43
+ const results = [];
44
+ for (const testCase of cases) {
45
+ const startedAt = performance.now();
46
+ try {
47
+ const output = await runner(testCase.input, testCase.metadata);
48
+ if (!testCase.success) {
49
+ results.push({
50
+ caseId: testCase.id,
51
+ passed: false,
52
+ durationMs: performance.now() - startedAt,
53
+ error: /* @__PURE__ */ new Error("Expected failure but runner resolved")
54
+ });
55
+ continue;
56
+ }
57
+ const matches = JSON.stringify(output) === JSON.stringify(testCase.expectedOutput ?? null);
58
+ results.push({
59
+ caseId: testCase.id,
60
+ passed: matches,
61
+ durationMs: performance.now() - startedAt,
62
+ error: matches ? void 0 : {
63
+ expected: testCase.expectedOutput,
64
+ received: output
65
+ }
66
+ });
67
+ } catch (error) {
68
+ const durationMs = performance.now() - startedAt;
69
+ if (!testCase.success) results.push({
70
+ caseId: testCase.id,
71
+ passed: true,
72
+ durationMs
73
+ });
74
+ else results.push({
75
+ caseId: testCase.id,
76
+ passed: false,
77
+ durationMs,
78
+ error
79
+ });
80
+ }
81
+ }
82
+ return results;
83
+ }
84
+
85
+ //#endregion
86
+ export { GoldenTestGenerator, runGoldenTests };
87
+ //# sourceMappingURL=golden-test-generator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"golden-test-generator.js","names":[],"sources":["../../src/generator/golden-test-generator.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { performance } from 'node:perf_hooks';\nimport type { GoldenTestCase, TrafficSnapshot } from '../types';\nimport { generateVitestSuite } from '../adapters/vitest-adapter';\nimport { generateJestSuite } from '../adapters/jest-adapter';\n\nexport interface GoldenTestGeneratorOptions {\n suiteName: string;\n runnerImport: string;\n runnerFunction: string;\n framework?: 'vitest' | 'jest';\n serializeMetadata?: (snapshot: TrafficSnapshot) => Record<string, unknown>;\n}\n\nexport class GoldenTestGenerator {\n constructor(\n private readonly serializeMetadata: GoldenTestGeneratorOptions['serializeMetadata'] = (\n snapshot\n ) =>\n ({\n tenantId: snapshot.tenantId,\n userId: snapshot.userId,\n channel: snapshot.channel,\n }) as Record<string, unknown>\n ) {}\n\n createCases(snapshots: TrafficSnapshot[]): GoldenTestCase[] {\n return snapshots.map((snapshot, index) => ({\n id: snapshot.id ?? randomUUID(),\n name: snapshot.success\n ? `case-${index + 1}-success`\n : `case-${index + 1}-failure`,\n input: snapshot.input,\n expectedOutput: snapshot.output,\n expectedError: snapshot.error,\n success: snapshot.success,\n metadata: this.serializeMetadata?.(snapshot),\n }));\n }\n\n generate(\n snapshots: TrafficSnapshot[],\n options: GoldenTestGeneratorOptions\n ): string {\n const cases = this.createCases(snapshots);\n if (options.framework === 'jest') {\n return generateJestSuite({\n suiteName: options.suiteName,\n cases,\n runnerImport: options.runnerImport,\n runnerFunction: options.runnerFunction,\n });\n }\n return generateVitestSuite({\n suiteName: options.suiteName,\n cases,\n runnerImport: options.runnerImport,\n runnerFunction: options.runnerFunction,\n });\n }\n}\n\nexport type GoldenTestRunner = (\n input: unknown,\n metadata?: Record<string, unknown>\n) => Promise<unknown>;\n\nexport interface GoldenTestRunResult {\n caseId: string;\n passed: boolean;\n durationMs: number;\n error?: unknown;\n}\n\nexport async function runGoldenTests(\n cases: GoldenTestCase[],\n runner: GoldenTestRunner\n): Promise<GoldenTestRunResult[]> {\n const results: GoldenTestRunResult[] = [];\n for (const testCase of cases) {\n const startedAt = performance.now();\n try {\n const output = await runner(testCase.input, testCase.metadata);\n if (!testCase.success) {\n results.push({\n caseId: testCase.id,\n passed: false,\n durationMs: performance.now() - startedAt,\n error: new Error('Expected failure but runner resolved'),\n });\n continue;\n }\n const matches =\n JSON.stringify(output) ===\n JSON.stringify(testCase.expectedOutput ?? null);\n results.push({\n caseId: testCase.id,\n passed: matches,\n durationMs: performance.now() - startedAt,\n error: matches\n ? undefined\n : { expected: testCase.expectedOutput, received: output },\n });\n } catch (error) {\n const durationMs = performance.now() - startedAt;\n if (!testCase.success) {\n results.push({ caseId: testCase.id, passed: true, durationMs });\n } else {\n results.push({ caseId: testCase.id, passed: false, durationMs, error });\n }\n }\n }\n return results;\n}\n"],"mappings":";;;;;;AAcA,IAAa,sBAAb,MAAiC;CAC/B,YACE,AAAiB,qBACf,cAEC;EACC,UAAU,SAAS;EACnB,QAAQ,SAAS;EACjB,SAAS,SAAS;EACnB,GACH;EARiB;;CAUnB,YAAY,WAAgD;AAC1D,SAAO,UAAU,KAAK,UAAU,WAAW;GACzC,IAAI,SAAS,MAAM,YAAY;GAC/B,MAAM,SAAS,UACX,QAAQ,QAAQ,EAAE,YAClB,QAAQ,QAAQ,EAAE;GACtB,OAAO,SAAS;GAChB,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,SAAS,SAAS;GAClB,UAAU,KAAK,oBAAoB,SAAS;GAC7C,EAAE;;CAGL,SACE,WACA,SACQ;EACR,MAAM,QAAQ,KAAK,YAAY,UAAU;AACzC,MAAI,QAAQ,cAAc,OACxB,QAAO,kBAAkB;GACvB,WAAW,QAAQ;GACnB;GACA,cAAc,QAAQ;GACtB,gBAAgB,QAAQ;GACzB,CAAC;AAEJ,SAAO,oBAAoB;GACzB,WAAW,QAAQ;GACnB;GACA,cAAc,QAAQ;GACtB,gBAAgB,QAAQ;GACzB,CAAC;;;AAgBN,eAAsB,eACpB,OACA,QACgC;CAChC,MAAM,UAAiC,EAAE;AACzC,MAAK,MAAM,YAAY,OAAO;EAC5B,MAAM,YAAY,YAAY,KAAK;AACnC,MAAI;GACF,MAAM,SAAS,MAAM,OAAO,SAAS,OAAO,SAAS,SAAS;AAC9D,OAAI,CAAC,SAAS,SAAS;AACrB,YAAQ,KAAK;KACX,QAAQ,SAAS;KACjB,QAAQ;KACR,YAAY,YAAY,KAAK,GAAG;KAChC,uBAAO,IAAI,MAAM,uCAAuC;KACzD,CAAC;AACF;;GAEF,MAAM,UACJ,KAAK,UAAU,OAAO,KACtB,KAAK,UAAU,SAAS,kBAAkB,KAAK;AACjD,WAAQ,KAAK;IACX,QAAQ,SAAS;IACjB,QAAQ;IACR,YAAY,YAAY,KAAK,GAAG;IAChC,OAAO,UACH,SACA;KAAE,UAAU,SAAS;KAAgB,UAAU;KAAQ;IAC5D,CAAC;WACK,OAAO;GACd,MAAM,aAAa,YAAY,KAAK,GAAG;AACvC,OAAI,CAAC,SAAS,QACZ,SAAQ,KAAK;IAAE,QAAQ,SAAS;IAAI,QAAQ;IAAM;IAAY,CAAC;OAE/D,SAAQ,KAAK;IAAE,QAAQ,SAAS;IAAI,QAAQ;IAAO;IAAY;IAAO,CAAC;;;AAI7E,QAAO"}
@@ -0,0 +1,7 @@
1
+ import { GoldenTestCase, RuntimeContract, TrafficSnapshot } from "./types.js";
2
+ import { InMemoryTrafficStore, RecordOperationInput, TrafficRecorder, TrafficRecorderOptions, TrafficStore } from "./recorder/traffic-recorder.js";
3
+ import { GoldenTestGenerator, GoldenTestGeneratorOptions, GoldenTestRunResult, GoldenTestRunner, runGoldenTests } from "./generator/golden-test-generator.js";
4
+ import { AssertionContext, buildAssertions, serialize } from "./generator/assertion-builder.js";
5
+ import { VitestAdapterOptions, generateVitestSuite } from "./adapters/vitest-adapter.js";
6
+ import { JestAdapterOptions, generateJestSuite } from "./adapters/jest-adapter.js";
7
+ export { AssertionContext, GoldenTestCase, GoldenTestGenerator, GoldenTestGeneratorOptions, GoldenTestRunResult, GoldenTestRunner, InMemoryTrafficStore, JestAdapterOptions, RecordOperationInput, RuntimeContract, TrafficRecorder, TrafficRecorderOptions, TrafficSnapshot, TrafficStore, VitestAdapterOptions, buildAssertions, generateJestSuite, generateVitestSuite, runGoldenTests, serialize };
package/dist/index.js ADDED
@@ -0,0 +1,7 @@
1
+ import { InMemoryTrafficStore, TrafficRecorder } from "./recorder/traffic-recorder.js";
2
+ import { buildAssertions, serialize } from "./generator/assertion-builder.js";
3
+ import { generateVitestSuite } from "./adapters/vitest-adapter.js";
4
+ import { generateJestSuite } from "./adapters/jest-adapter.js";
5
+ import { GoldenTestGenerator, runGoldenTests } from "./generator/golden-test-generator.js";
6
+
7
+ export { GoldenTestGenerator, InMemoryTrafficStore, TrafficRecorder, buildAssertions, generateJestSuite, generateVitestSuite, runGoldenTests, serialize };
@@ -0,0 +1,40 @@
1
+ import { TrafficSnapshot } from "../types.js";
2
+
3
+ //#region src/recorder/traffic-recorder.d.ts
4
+ interface TrafficStore {
5
+ save(snapshot: TrafficSnapshot): Promise<void>;
6
+ list(operation?: TrafficSnapshot['operation']['name']): Promise<TrafficSnapshot[]>;
7
+ }
8
+ declare class InMemoryTrafficStore implements TrafficStore {
9
+ private readonly items;
10
+ save(snapshot: TrafficSnapshot): Promise<void>;
11
+ list(operation?: string): Promise<TrafficSnapshot[]>;
12
+ }
13
+ interface TrafficRecorderOptions {
14
+ store: TrafficStore;
15
+ sampleRate?: number;
16
+ sanitize?: (snapshot: TrafficSnapshot) => TrafficSnapshot;
17
+ }
18
+ interface RecordOperationInput {
19
+ operation: TrafficSnapshot['operation'];
20
+ input: unknown;
21
+ output?: unknown;
22
+ error?: TrafficSnapshot['error'];
23
+ success: boolean;
24
+ durationMs?: number;
25
+ tenantId?: string;
26
+ userId?: string;
27
+ channel?: string;
28
+ metadata?: Record<string, unknown>;
29
+ }
30
+ declare class TrafficRecorder {
31
+ private readonly store;
32
+ private readonly sampleRate;
33
+ private readonly sanitize?;
34
+ constructor(options: TrafficRecorderOptions);
35
+ record(input: RecordOperationInput): Promise<void>;
36
+ private shouldSample;
37
+ }
38
+ //#endregion
39
+ export { InMemoryTrafficStore, RecordOperationInput, TrafficRecorder, TrafficRecorderOptions, TrafficStore };
40
+ //# sourceMappingURL=traffic-recorder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"traffic-recorder.d.ts","names":[],"sources":["../../src/recorder/traffic-recorder.ts"],"sourcesContent":[],"mappings":";;;UAGiB,YAAA;iBACA,kBAAkB;EADlB,IAAA,CAAA,SAAY,CAAA,EAGb,eAHa,CAAA,WAAA,CAAA,CAAA,MAAA,CAAA,CAAA,EAIxB,OAJwB,CAIhB,eAJgB,EAAA,CAAA;;AACM,cAMtB,oBAAA,YAAgC,YANV,CAAA;EAEnB,iBAAA,KAAA;EACH,IAAA,CAAA,QAAA,EAMU,eANV,CAAA,EAM4B,OAN5B,CAAA,IAAA,CAAA;EAAR,IAAA,CAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EAU6B,OAV7B,CAUqC,eAVrC,EAAA,CAAA;;AAGQ,UAaI,sBAAA,CAbiB;EAGX,KAAA,EAWd,YAXc;EAAkB,UAAA,CAAA,EAAA,MAAA;EAIC,QAAA,CAAA,EAAA,CAAA,QAAA,EASlB,eATkB,EAAA,GASE,eATF;;AAPG,UAmB5B,oBAAA,CAnB4B;EAAY,SAAA,EAoB5C,eApB4C,CAAA,WAAA,CAAA;EAaxC,KAAA,EAAA,OAAA;EACR,MAAA,CAAA,EAAA,OAAA;EAEe,KAAA,CAAA,EAOd,eAPc,CAAA,OAAA,CAAA;EAAoB,OAAA,EAAA,OAAA;EAAe,UAAA,CAAA,EAAA,MAAA;EAG1C,QAAA,CAAA,EAAA,MAAA;EACJ,MAAA,CAAA,EAAA,MAAA;EAGH,OAAA,CAAA,EAAA,MAAA;EAMG,QAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAA,OAAA,CAAA;;AAGA,cAAA,eAAA,CAAe;EAKL,iBAAA,KAAA;EAMD,iBAAA,UAAA;EAAoB,iBAAA,QAAA;EAAA,WAAA,CAAA,OAAA,EANnB,sBAMmB;gBAApB,uBAAoB"}
@@ -0,0 +1,60 @@
1
+ import { randomUUID } from "node:crypto";
2
+
3
+ //#region src/recorder/traffic-recorder.ts
4
+ var InMemoryTrafficStore = class {
5
+ items = [];
6
+ async save(snapshot) {
7
+ this.items.push(snapshot);
8
+ }
9
+ async list(operation) {
10
+ if (!operation) return [...this.items];
11
+ return this.items.filter((item) => item.operation.name === operation);
12
+ }
13
+ };
14
+ var TrafficRecorder = class {
15
+ store;
16
+ sampleRate;
17
+ sanitize;
18
+ constructor(options) {
19
+ this.store = options.store;
20
+ this.sampleRate = options.sampleRate ?? 1;
21
+ this.sanitize = options.sanitize;
22
+ }
23
+ async record(input) {
24
+ if (!this.shouldSample()) return;
25
+ const snapshot = {
26
+ id: randomUUID(),
27
+ operation: input.operation,
28
+ input: structuredCloneSafe(input.input),
29
+ output: structuredCloneSafe(input.output),
30
+ error: input.error ? structuredCloneSafe(input.error) : void 0,
31
+ success: input.success,
32
+ timestamp: /* @__PURE__ */ new Date(),
33
+ durationMs: input.durationMs,
34
+ tenantId: input.tenantId,
35
+ userId: input.userId,
36
+ channel: input.channel,
37
+ metadata: input.metadata
38
+ };
39
+ const sanitized = this.sanitize ? this.sanitize(snapshot) : snapshot;
40
+ await this.store.save(sanitized);
41
+ }
42
+ shouldSample() {
43
+ if (this.sampleRate >= 1) return true;
44
+ return Math.random() <= this.sampleRate;
45
+ }
46
+ };
47
+ function structuredCloneSafe(value) {
48
+ if (value == null) return value ?? void 0;
49
+ try {
50
+ const clone = globalThis.structuredClone;
51
+ if (typeof clone === "function") return clone(value);
52
+ return JSON.parse(JSON.stringify(value));
53
+ } catch {
54
+ return;
55
+ }
56
+ }
57
+
58
+ //#endregion
59
+ export { InMemoryTrafficStore, TrafficRecorder };
60
+ //# sourceMappingURL=traffic-recorder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"traffic-recorder.js","names":[],"sources":["../../src/recorder/traffic-recorder.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { TrafficSnapshot } from '../types';\n\nexport interface TrafficStore {\n save(snapshot: TrafficSnapshot): Promise<void>;\n list(\n operation?: TrafficSnapshot['operation']['name']\n ): Promise<TrafficSnapshot[]>;\n}\n\nexport class InMemoryTrafficStore implements TrafficStore {\n private readonly items: TrafficSnapshot[] = [];\n\n async save(snapshot: TrafficSnapshot): Promise<void> {\n this.items.push(snapshot);\n }\n\n async list(operation?: string): Promise<TrafficSnapshot[]> {\n if (!operation) return [...this.items];\n return this.items.filter((item) => item.operation.name === operation);\n }\n}\n\nexport interface TrafficRecorderOptions {\n store: TrafficStore;\n sampleRate?: number;\n sanitize?: (snapshot: TrafficSnapshot) => TrafficSnapshot;\n}\n\nexport interface RecordOperationInput {\n operation: TrafficSnapshot['operation'];\n input: unknown;\n output?: unknown;\n error?: TrafficSnapshot['error'];\n success: boolean;\n durationMs?: number;\n tenantId?: string;\n userId?: string;\n channel?: string;\n metadata?: Record<string, unknown>;\n}\n\nexport class TrafficRecorder {\n private readonly store: TrafficStore;\n private readonly sampleRate: number;\n private readonly sanitize?: (snapshot: TrafficSnapshot) => TrafficSnapshot;\n\n constructor(options: TrafficRecorderOptions) {\n this.store = options.store;\n this.sampleRate = options.sampleRate ?? 1;\n this.sanitize = options.sanitize;\n }\n\n async record(input: RecordOperationInput) {\n if (!this.shouldSample()) return;\n const snapshot: TrafficSnapshot = {\n id: randomUUID(),\n operation: input.operation,\n input: structuredCloneSafe(input.input),\n output: structuredCloneSafe(input.output),\n error: input.error ? structuredCloneSafe(input.error) : undefined,\n success: input.success,\n timestamp: new Date(),\n durationMs: input.durationMs,\n tenantId: input.tenantId,\n userId: input.userId,\n channel: input.channel,\n metadata: input.metadata,\n };\n const sanitized = this.sanitize ? this.sanitize(snapshot) : snapshot;\n await this.store.save(sanitized);\n }\n\n private shouldSample() {\n if (this.sampleRate >= 1) return true;\n return Math.random() <= this.sampleRate;\n }\n}\n\nfunction structuredCloneSafe<T>(value: T): T | undefined {\n if (value == null) return value ?? undefined;\n try {\n const clone = (globalThis as { structuredClone?: <R>(input: R) => R })\n .structuredClone;\n if (typeof clone === 'function') {\n return clone(value);\n }\n return JSON.parse(JSON.stringify(value));\n } catch {\n return undefined;\n }\n}\n"],"mappings":";;;AAUA,IAAa,uBAAb,MAA0D;CACxD,AAAiB,QAA2B,EAAE;CAE9C,MAAM,KAAK,UAA0C;AACnD,OAAK,MAAM,KAAK,SAAS;;CAG3B,MAAM,KAAK,WAAgD;AACzD,MAAI,CAAC,UAAW,QAAO,CAAC,GAAG,KAAK,MAAM;AACtC,SAAO,KAAK,MAAM,QAAQ,SAAS,KAAK,UAAU,SAAS,UAAU;;;AAuBzE,IAAa,kBAAb,MAA6B;CAC3B,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAiC;AAC3C,OAAK,QAAQ,QAAQ;AACrB,OAAK,aAAa,QAAQ,cAAc;AACxC,OAAK,WAAW,QAAQ;;CAG1B,MAAM,OAAO,OAA6B;AACxC,MAAI,CAAC,KAAK,cAAc,CAAE;EAC1B,MAAM,WAA4B;GAChC,IAAI,YAAY;GAChB,WAAW,MAAM;GACjB,OAAO,oBAAoB,MAAM,MAAM;GACvC,QAAQ,oBAAoB,MAAM,OAAO;GACzC,OAAO,MAAM,QAAQ,oBAAoB,MAAM,MAAM,GAAG;GACxD,SAAS,MAAM;GACf,2BAAW,IAAI,MAAM;GACrB,YAAY,MAAM;GAClB,UAAU,MAAM;GAChB,QAAQ,MAAM;GACd,SAAS,MAAM;GACf,UAAU,MAAM;GACjB;EACD,MAAM,YAAY,KAAK,WAAW,KAAK,SAAS,SAAS,GAAG;AAC5D,QAAM,KAAK,MAAM,KAAK,UAAU;;CAGlC,AAAQ,eAAe;AACrB,MAAI,KAAK,cAAc,EAAG,QAAO;AACjC,SAAO,KAAK,QAAQ,IAAI,KAAK;;;AAIjC,SAAS,oBAAuB,OAAyB;AACvD,KAAI,SAAS,KAAM,QAAO,SAAS;AACnC,KAAI;EACF,MAAM,QAAS,WACZ;AACH,MAAI,OAAO,UAAU,WACnB,QAAO,MAAM,MAAM;AAErB,SAAO,KAAK,MAAM,KAAK,UAAU,MAAM,CAAC;SAClC;AACN"}
@@ -0,0 +1,36 @@
1
+ import * as z from "zod";
2
+ import { GraphQLEnumType } from "graphql";
3
+
4
+ //#region ../schema/src/EnumType.d.ts
5
+
6
+ /**
7
+ * Strongly-typed string enum wrapper with one source of truth for zod, GraphQL, and JSON Schema.
8
+ */
9
+ declare class EnumType<T extends [string, ...string[]]> {
10
+ private readonly name;
11
+ private readonly values;
12
+ private readonly gqlEnum;
13
+ constructor(name: string, values: T);
14
+ /** Enum type name (used by GraphQL and JSON Schema). */
15
+ getName(): string;
16
+ /** Returns the literal tuple of allowed values. */
17
+ getEnumValues(): T;
18
+ /** GraphQL enum instance suitable for Pothos or vanilla GraphQL schemas. */
19
+ getPothos(): GraphQLEnumType;
20
+ /** zod schema representing this enum. */
21
+ getZod(): z.ZodEnum<{ [K in T[number]]: K }>;
22
+ /** Minimal JSON representation (alias of getJsonSchema). */
23
+ getJson(): {
24
+ type: 'string';
25
+ enum: T;
26
+ };
27
+ /** JSON Schema for this enum. */
28
+ getJsonSchema(): {
29
+ type: 'string';
30
+ enum: T;
31
+ };
32
+ }
33
+ type AnyEnumType = EnumType<[string, ...string[]]>;
34
+ //#endregion
35
+ export { AnyEnumType, EnumType };
36
+ //# sourceMappingURL=EnumType.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EnumType.d.ts","names":[],"sources":["../../../../schema/src/EnumType.ts"],"sourcesContent":[],"mappings":";;;;;;;AAMA;AAKoC,cALvB,QAKuB,CAAA,UAAA,CAAA,MAAA,EAAA,GAAA,MAAA,EAAA,CAAA,CAAA,CAAA;EAejB,iBAAA,IAAA;EAMJ,iBAAA,MAAA;EAKe,iBAAA,OAAA;EAAY,WAAA,CAAA,IAAA,EAAA,MAAA,EAAA,MAAA,EA1BN,CA0BM;EAA5B;EAKuB,OAAA,CAAA,CAAA,EAAA,MAAA;EAKM;EAAC,aAAA,CAAA,CAAA,EArBzB,CAqByB;EAKhC;eApBG;;YAKH,CAAA,CAAE,gBAAgB,YAAY;;;;UAKL;;;;;UAKM;;;KAK/B,WAAA,GAAc"}
@@ -0,0 +1,30 @@
1
+ import * as z from "zod";
2
+ import { GraphQLScalarType, GraphQLScalarTypeConfig } from "graphql";
3
+
4
+ //#region ../schema/src/FieldType.d.ts
5
+ interface FieldTypeConfig<TInternal, TExternal = TInternal> extends GraphQLScalarTypeConfig<TInternal, TExternal> {
6
+ zod: z.ZodType<TInternal>;
7
+ jsonSchema: unknown | (() => unknown);
8
+ }
9
+ type AnyFieldType = FieldType<any, any>;
10
+ /**
11
+ * GraphQL scalar wrapper that carries zod and JSON Schema metadata.
12
+ *
13
+ * TInternal is the runtime representation; TExternal is the GraphQL output.
14
+ */
15
+ declare class FieldType<TInternal, TExternal = TInternal> extends GraphQLScalarType<TInternal, TExternal> {
16
+ private zodSchema;
17
+ private readonly jsonSchemaDef?;
18
+ constructor(config: FieldTypeConfig<TInternal, TExternal>);
19
+ /** Return the attached zod schema for validation. */
20
+ getZod(): z.ZodType<TInternal>;
21
+ /** GraphQL scalar instance usable by Pothos or vanilla GraphQL. */
22
+ getPothos(): GraphQLScalarType<TInternal, TExternal>;
23
+ /** Return the JSON Schema (evaluates factory if provided). */
24
+ getJson(): unknown;
25
+ getJsonSchemaDef(): unknown | (() => unknown);
26
+ getJsonSchema(): unknown;
27
+ }
28
+ //#endregion
29
+ export { AnyFieldType, FieldType, FieldTypeConfig };
30
+ //# sourceMappingURL=FieldType.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FieldType.d.ts","names":[],"sources":["../../../../schema/src/FieldType.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,uCAEH,mBACJ,wBAAwB,WAAW;OACtC,CAAA,CAAE,QAAQ;EAJA,UAAA,EAAA,OAAe,GAAA,CAAA,GAAA,GAAA,OAAA,CAAA;;AAGE,KAMtB,YAAA,GAAe,SANO,CAAA,GAAA,EAAA,GAAA,CAAA;;;;;;AAMtB,cAOC,SAPW,CAAA,SAAG,EAAS,YAStB,SATsB,CAAA,SAU1B,iBAV0B,CAUR,SAVQ,EAUG,SAVH,CAAA,CAAA;EAOvB,QAAA,SAAS;EAER,iBAAA,aAAA;EACc,WAAA,CAAA,MAAA,EAIN,eAJM,CAIU,SAJV,EAIqB,SAJrB,CAAA;EAAW;EAID,MAAA,CAAA,CAAA,EAO1B,CAAA,CAAE,OAPwB,CAOhB,SAPgB,CAAA;EAAW;EAA3B,SAAA,CAAA,CAAA,EAYP,iBAZO,CAYW,SAZX,EAYsB,SAZtB,CAAA;EAOA;EAAR,OAAA,CAAA,CAAA,EAAA,OAAA;EAKmB,gBAAA,CAAA,CAAA,EAAA,OAAA,GAAA,CAAA,GAAA,GAAA,OAAA,CAAA;EAAW,aAAA,CAAA,CAAA,EAAA,OAAA"}
@@ -0,0 +1,2 @@
1
+ import "./SchemaModelType.js";
2
+ import "zod";
@@ -0,0 +1,2 @@
1
+ import "./SchemaModelType.js";
2
+ import "zod";
@@ -0,0 +1 @@
1
+ import "./FieldType.js";
@@ -0,0 +1,70 @@
1
+ import { AnyFieldType } from "./FieldType.js";
2
+ import { AnyEnumType } from "./EnumType.js";
3
+ import { SchemaModelType } from "./SchemaModelType.js";
4
+ import * as z from "zod";
5
+ import { Maybe } from "graphql/jsutils/Maybe";
6
+
7
+ //#region ../schema/src/SchemaModel.d.ts
8
+
9
+ /**
10
+ * All types that can be used as field types in a SchemaModel.
11
+ * Supports FieldType, EnumType, nested SchemaModel, or any SchemaType implementation.
12
+ */
13
+ type FieldLike = AnyFieldType | AnyEnumType | AnySchemaModel | SchemaModelType;
14
+ /** Field configuration for a SchemaModel property. */
15
+ interface SchemaFieldConfig<Type extends FieldLike = FieldLike> {
16
+ type: Type;
17
+ isOptional: boolean;
18
+ /** When present and true, the field is an array */
19
+ isArray?: true;
20
+ }
21
+ type SchemaModelFieldsAnyConfig<Type extends FieldLike = FieldLike> = Record<string, SchemaFieldConfig<Type>>;
22
+ /** Model definition: name and fields. */
23
+ interface SchemaModelConfig<Fields extends SchemaModelFieldsAnyConfig> {
24
+ name: string;
25
+ description?: Maybe<string>;
26
+ fields: Fields;
27
+ }
28
+ /**
29
+ * Named object model built from FieldType/EnumType/SchemaModel fields.
30
+ * Provides zod and GraphQL input helpers, and supports arrays/optional fields.
31
+ */
32
+ declare class SchemaModel<Fields extends SchemaModelFieldsAnyConfig> implements SchemaModelType {
33
+ readonly config: SchemaModelConfig<Fields>;
34
+ constructor(config: SchemaModelConfig<Fields>);
35
+ /**
36
+ * Build a typed ZodObject from the model fields, preserving each field's
37
+ * Zod schema and optionality at the type level when possible.
38
+ */
39
+ getZod(): TopLevelZodFromModel<Fields>;
40
+ /** Input object name for GraphQL builder adapters. */
41
+ getPothosInput(): string;
42
+ }
43
+ /**
44
+ * Union of all types that can serve as a schema model.
45
+ * This is the main type expected by OperationSpec, EventSpec, FormSpec, etc.
46
+ *
47
+ * Supports:
48
+ * - SchemaModel instances (native ContractSpec types)
49
+ * - Any SchemaType implementation (ZodSchemaType, JsonSchemaType, etc.)
50
+ */
51
+ type AnySchemaModel = SchemaModel<SchemaModelFieldsAnyConfig> | SchemaModelType;
52
+ type InferZodFromType<T> = T extends SchemaModel<SchemaModelFieldsAnyConfig> ? z.ZodObject<z.ZodRawShape> : T extends AnyFieldType ? ReturnType<T['getZod']> : T extends AnyEnumType ? ReturnType<T['getZod']> : T extends SchemaModelType ? ReturnType<T['getZod']> : z.ZodUnknown;
53
+ type MaybeArray<Z extends z.ZodType, A> = A extends true ? z.ZodArray<Z> : Z;
54
+ type MaybeOptional<Z extends z.ZodType, O> = O extends true ? z.ZodOptional<Z> : Z;
55
+ /**
56
+ * Helper type: derive the Zod shape from the field config.
57
+ * Supports nested SchemaModel and arrays, preserving optionality and list-ness.
58
+ */
59
+ type FieldIsArray<FC> = FC extends {
60
+ isArray: true;
61
+ } ? true : false;
62
+ type ZodShapeFromFields<F extends SchemaModelFieldsAnyConfig> = { [K in keyof F]: MaybeOptional<MaybeArray<InferZodFromType<F[K]['type']>, FieldIsArray<F[K]>>, F[K]['isOptional']> };
63
+ /**
64
+ * The top-level Zod schema returned by getZod():
65
+ * either ZodObject<...> or ZodArray<ZodObject<...>> when config.isArray.
66
+ */
67
+ type TopLevelZodFromModel<F extends SchemaModelFieldsAnyConfig> = z.ZodObject<ZodShapeFromFields<F>>;
68
+ //#endregion
69
+ export { AnySchemaModel, SchemaFieldConfig, SchemaModel, SchemaModelConfig, SchemaModelFieldsAnyConfig, TopLevelZodFromModel, ZodShapeFromFields };
70
+ //# sourceMappingURL=SchemaModel.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SchemaModel.d.ts","names":[],"sources":["../../../../schema/src/SchemaModel.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAImD;;KAM9C,SAAA,GAAY,YAAe,GAAA,WAAA,GAAc,cAAd,GAA+B,eAA/B;;AAA+B,UAG9C,iBAH8C,CAAA,aAGf,SAHe,GAGH,SAHG,CAAA,CAAA;EAAe,IAAA,EAItE,IAJsE;EAG7D,UAAA,EAAA,OAAA;EAA+B;EAAY,OAAA,CAAA,EAAA,IAAA;;AAChD,KAMA,0BANA,CAAA,aAMwC,SANxC,GAMoD,SANpD,CAAA,GAOV,MAPU,CAAA,MAAA,EAOK,iBAPL,CAOuB,IAPvB,CAAA,CAAA;AAMZ;AAAoD,UAInC,iBAJmC,CAAA,eAIF,0BAJE,CAAA,CAAA;EAAY,IAAA,EAAA,MAAA;EAC7B,WAAA,CAAA,EAKnB,KALmB,CAAA,MAAA,CAAA;EAAlB,MAAA,EAMP,MANO;;;AAGjB;;;AAGU,cAOG,WAPH,CAAA,eAQO,0BARP,CAAA,YASG,eATH,CAAA;EAAM,SAAA,MAAA,EAUsB,iBAVtB,CAUwC,MAVxC,CAAA;EAOH,WAAA,CAAA,MAAW,EAGc,iBAHd,CAGgC,MAHhC,CAAA;EACP;;;;EAEqB,MAAA,CAAA,CAAA,EAM1B,oBAN0B,CAML,MANK,CAAA;EAML;EAArB,cAAA,CAAA,CAAA,EAAA,MAAA;;;AAgCZ;;;;;AAkCE;;AAGsB,KArCZ,cAAA,GACR,WAoCoB,CApCR,0BAoCQ,CAAA,GAnCpB,eAmCoB;AAQA,KATnB,gBAWU,CAAA,CAAA,CAAA,GAVb,CAUa,SAVH,WAUG,CAVS,0BAUT,CAAA,GATT,CAAA,CAAE,SASO,CATG,CAAA,CAAE,WASL,CAAA,GART,CAQS,SARC,YAQD,GAPP,UAOO,CAPI,CAOJ,CAAA,QAAA,CAAA,CAAA,GANP,CAMO,SANG,WAMH,GALL,UAKK,CALM,CAKN,CAAA,QAAA,CAAA,CAAA,GAJL,CAIK,SAJK,eAIL,GAHH,UAGG,CAHQ,CAGR,CAAA,QAAA,CAAA,CAAA,GAFH,CAAA,CAAE,UAEC;KAAV,UAAuB,CAAA,UAAF,CAAA,CAAE,OAAA,EAAA,CAAA,CAAA,GAAc,CAAd,SAAA,IAAA,GAA+B,CAAA,CAAE,QAAjC,CAA0C,CAA1C,CAAA,GAA+C,CAA/C;KACvB,aADqC,CAAA,UACb,CAAA,CAAE,OADW,EAAA,CAAA,CAAA,GACG,CADH,SAAA,IAAA,GAEtC,CAAA,CAAE,WAFoC,CAExB,CAFwB,CAAA,GAGtC,CAHsC;;;;;AAAkC,KASvE,YARA,CAAA,EAAa,CAAA,GAQM,EARN,SAAA;EAAa,OAAA,EAAA,IAAA;CAAc,GAAA,IAAA,GAAA,KAAA;AAC3B,KASN,kBATM,CAAA,UASuB,0BATvB,CAAA,GAAA,QAAZ,MAUQ,CAVR,GAUY,aAVZ,CAWF,UAXE,CAWS,gBAXT,CAW0B,CAX1B,CAW4B,CAX5B,CAAA,CAAA,MAAA,CAAA,CAAA,EAWyC,YAXzC,CAWsD,CAXtD,CAWwD,CAXxD,CAAA,CAAA,CAAA,EAYF,CAZE,CAYA,CAZA,CAAA,CAAA,YAAA,CAAA,CAAA,EACF;;AAAC;AAQL;;AACc,KAUF,oBAVE,CAAA,UAU6B,0BAV7B,CAAA,GAWZ,CAAA,CAAE,SAXU,CAWA,kBAXA,CAWmB,CAXnB,CAAA,CAAA"}
@@ -0,0 +1,38 @@
1
+ import * as z from "zod";
2
+
3
+ //#region ../schema/src/SchemaModelType.d.ts
4
+
5
+ /**
6
+ * Unified interface for all schema-compatible types.
7
+ * Any type used in ContractSpec schemas must implement this interface.
8
+ *
9
+ * @template T - The TypeScript type this schema represents
10
+ *
11
+ * @example
12
+ * ```typescript
13
+ * // All of these implement SchemaType:
14
+ * const fieldType = ScalarTypeEnum.String_unsecure();
15
+ * const schemaModel = new SchemaModel({ name: 'User', fields: {...} });
16
+ * const zodWrapper = fromZod(z.object({ name: z.string() }));
17
+ * ```
18
+ */
19
+ interface SchemaModelType<T = unknown> {
20
+ /**
21
+ * Return the Zod schema for runtime validation.
22
+ * This is the primary method - all schema types must provide Zod conversion.
23
+ */
24
+ getZod(): z.ZodType<T>;
25
+ /**
26
+ * Return GraphQL type info for Pothos/GraphQL integration.
27
+ * Optional - types without GraphQL representation return undefined.
28
+ */
29
+ getPothos?(): unknown;
30
+ /**
31
+ * Return JSON Schema representation.
32
+ * Optional - types without JSON Schema representation return undefined.
33
+ */
34
+ getJsonSchema?(): unknown;
35
+ }
36
+ //#endregion
37
+ export { SchemaModelType };
38
+ //# sourceMappingURL=SchemaModelType.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SchemaModelType.d.ts","names":[],"sources":["../../../../schema/src/SchemaModelType.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;UA8BiB;;;;;YAKL,CAAA,CAAE,QAAQ"}
@@ -0,0 +1,2 @@
1
+ import "./SchemaModelType.js";
2
+ import "zod";
@@ -0,0 +1 @@
1
+ import "./types.js";
@@ -0,0 +1 @@
1
+ import "./types.js";
@@ -0,0 +1,3 @@
1
+ import "./types.js";
2
+ import "./defineEntity.js";
3
+ import "./generator.js";
@@ -0,0 +1 @@
1
+ import "zod";