@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.
- package/LICENSE +21 -0
- package/README.md +51 -0
- package/dist/adapters/jest-adapter.d.ts +13 -0
- package/dist/adapters/jest-adapter.d.ts.map +1 -0
- package/dist/adapters/jest-adapter.js +28 -0
- package/dist/adapters/jest-adapter.js.map +1 -0
- package/dist/adapters/vitest-adapter.d.ts +13 -0
- package/dist/adapters/vitest-adapter.d.ts.map +1 -0
- package/dist/adapters/vitest-adapter.js +27 -0
- package/dist/adapters/vitest-adapter.js.map +1 -0
- package/dist/contracts/src/app-config/lifecycle.d.ts +1 -0
- package/dist/contracts/src/app-config/runtime.d.ts +13 -0
- package/dist/contracts/src/app-config/spec.d.ts +9 -0
- package/dist/contracts/src/app-config/validation.d.ts +8 -0
- package/dist/contracts/src/capabilities/capabilities.d.ts +1 -0
- package/dist/contracts/src/capabilities/index.d.ts +2 -0
- package/dist/contracts/src/capabilities/openbanking.d.ts +1 -0
- package/dist/contracts/src/client/index.d.ts +1 -0
- package/dist/contracts/src/client/react/drivers/rn-reusables.d.ts +1 -0
- package/dist/contracts/src/client/react/drivers/shadcn.d.ts +1 -0
- package/dist/contracts/src/client/react/feature-render.d.ts +3 -0
- package/dist/contracts/src/client/react/form-render.d.ts +4 -0
- package/dist/contracts/src/client/react/index.d.ts +4 -0
- package/dist/contracts/src/contract-registry/index.d.ts +2 -0
- package/dist/contracts/src/contract-registry/schemas.d.ts +2 -0
- package/dist/contracts/src/contract-registry/types.d.ts +1 -0
- package/dist/contracts/src/data-views/index.d.ts +3 -0
- package/dist/contracts/src/data-views/registry.d.ts +2 -0
- package/dist/contracts/src/data-views/spec.d.ts +2 -0
- package/dist/contracts/src/data-views/types.d.ts +2 -0
- package/dist/contracts/src/docs/accessibility_wcag_compliance_specs.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/index.d.ts +25 -0
- package/dist/contracts/src/docs/presentations.d.ts +2 -0
- package/dist/contracts/src/docs/registry.d.ts +10 -0
- package/dist/contracts/src/docs/registry.d.ts.map +1 -0
- package/dist/contracts/src/docs/tech/auth/better-auth-nextjs.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/contracts/README.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/contracts/openapi-export.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/contracts/openapi-import.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/lifecycle-stage-system.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/llm/llm-integration.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/mcp-endpoints.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/presentation-runtime.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/schema/README.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/studio/learning-events.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/studio/learning-journeys.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/studio/platform-admin-panel.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/studio/project-access-teams.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/studio/project-routing.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/studio/sandbox-unlogged.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/studio/team-invitations.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/studio/workspace-ops.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/studio/workspaces.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/telemetry-ingest.docblock.d.ts +1 -0
- package/dist/contracts/src/docs/tech/vscode-extension.docblock.d.ts +1 -0
- package/dist/contracts/src/events.d.ts +25 -0
- package/dist/contracts/src/events.d.ts.map +1 -0
- package/dist/contracts/src/examples/index.d.ts +4 -0
- package/dist/contracts/src/examples/registry.d.ts +2 -0
- package/dist/contracts/src/examples/schema.d.ts +2 -0
- package/dist/contracts/src/examples/types.d.ts +3 -0
- package/dist/contracts/src/examples/validation.d.ts +1 -0
- package/dist/contracts/src/experiments/evaluator.d.ts +2 -0
- package/dist/contracts/src/experiments/spec-resolver.d.ts +4 -0
- package/dist/contracts/src/experiments/spec.d.ts +4 -0
- package/dist/contracts/src/features/index.d.ts +4 -0
- package/dist/contracts/src/features/install.d.ts +6 -0
- package/dist/contracts/src/features/registry.d.ts +2 -0
- package/dist/contracts/src/features/types.d.ts +5 -0
- package/dist/contracts/src/features/validation.d.ts +2 -0
- package/dist/contracts/src/forms/forms.d.ts +3 -0
- package/dist/contracts/src/forms/index.d.ts +1 -0
- package/dist/contracts/src/index.d.ts +48 -0
- package/dist/contracts/src/install.d.ts +7 -0
- package/dist/contracts/src/integrations/connection.d.ts +1 -0
- package/dist/contracts/src/integrations/index.d.ts +6 -0
- package/dist/contracts/src/integrations/openbanking/contracts/accounts.d.ts +4 -0
- package/dist/contracts/src/integrations/openbanking/contracts/balances.d.ts +4 -0
- package/dist/contracts/src/integrations/openbanking/contracts/index.d.ts +5 -0
- package/dist/contracts/src/integrations/openbanking/contracts/transactions.d.ts +4 -0
- package/dist/contracts/src/integrations/openbanking/guards.d.ts +1 -0
- package/dist/contracts/src/integrations/openbanking/models.d.ts +1 -0
- package/dist/contracts/src/integrations/openbanking/openbanking.feature.d.ts +1 -0
- package/dist/contracts/src/integrations/operations.d.ts +4 -0
- package/dist/contracts/src/integrations/providers/elevenlabs.d.ts +2 -0
- package/dist/contracts/src/integrations/providers/gcs-storage.d.ts +2 -0
- package/dist/contracts/src/integrations/providers/gmail.d.ts +2 -0
- package/dist/contracts/src/integrations/providers/google-calendar.d.ts +2 -0
- package/dist/contracts/src/integrations/providers/index.d.ts +11 -0
- package/dist/contracts/src/integrations/providers/mistral.d.ts +2 -0
- package/dist/contracts/src/integrations/providers/postmark.d.ts +2 -0
- package/dist/contracts/src/integrations/providers/powens.d.ts +2 -0
- package/dist/contracts/src/integrations/providers/qdrant.d.ts +2 -0
- package/dist/contracts/src/integrations/providers/registry.d.ts +1 -0
- package/dist/contracts/src/integrations/providers/stripe.d.ts +2 -0
- package/dist/contracts/src/integrations/providers/twilio-sms.d.ts +2 -0
- package/dist/contracts/src/integrations/spec.d.ts +3 -0
- package/dist/contracts/src/jsonschema.d.ts +4 -0
- package/dist/contracts/src/knowledge/index.d.ts +2 -0
- package/dist/contracts/src/knowledge/operations.d.ts +4 -0
- package/dist/contracts/src/knowledge/spaces/email-threads.d.ts +1 -0
- package/dist/contracts/src/knowledge/spaces/financial-docs.d.ts +1 -0
- package/dist/contracts/src/knowledge/spaces/financial-overview.d.ts +1 -0
- package/dist/contracts/src/knowledge/spaces/index.d.ts +6 -0
- package/dist/contracts/src/knowledge/spaces/product-canon.d.ts +1 -0
- package/dist/contracts/src/knowledge/spaces/support-faq.d.ts +1 -0
- package/dist/contracts/src/knowledge/spaces/uploaded-docs.d.ts +1 -0
- package/dist/contracts/src/knowledge/spec.d.ts +3 -0
- package/dist/contracts/src/llm/exporters.d.ts +7 -0
- package/dist/contracts/src/llm/index.d.ts +3 -0
- package/dist/contracts/src/llm/prompts.d.ts +2 -0
- package/dist/contracts/src/llm/types.d.ts +5 -0
- package/dist/contracts/src/migrations.d.ts +1 -0
- package/dist/contracts/src/model-registry.d.ts +1 -0
- package/dist/contracts/src/onboarding-base.d.ts +2 -0
- package/dist/contracts/src/openapi.d.ts +1 -0
- package/dist/contracts/src/operations/index.d.ts +2 -0
- package/dist/contracts/src/operations/operation.d.ts +170 -0
- package/dist/contracts/src/operations/operation.d.ts.map +1 -0
- package/dist/contracts/src/operations/registry.d.ts +6 -0
- package/dist/contracts/src/ownership.d.ts +61 -0
- package/dist/contracts/src/ownership.d.ts.map +1 -0
- package/dist/contracts/src/policy/engine.d.ts +3 -0
- package/dist/contracts/src/policy/index.d.ts +4 -0
- package/dist/contracts/src/policy/opa-adapter.d.ts +3 -0
- package/dist/contracts/src/policy/registry.d.ts +2 -0
- package/dist/contracts/src/policy/spec.d.ts +11 -0
- package/dist/contracts/src/policy/spec.d.ts.map +1 -0
- package/dist/contracts/src/presentations/index.d.ts +3 -0
- package/dist/contracts/src/presentations/presentations.d.ts +2 -0
- package/dist/contracts/src/presentations/registry.d.ts +2 -0
- package/dist/contracts/src/presentations/transform-engine.d.ts +2 -0
- package/dist/contracts/src/prompt.d.ts +2 -0
- package/dist/contracts/src/promptRegistry.d.ts +2 -0
- package/dist/contracts/src/regenerator/adapters.d.ts +1 -0
- package/dist/contracts/src/regenerator/executor.d.ts +1 -0
- package/dist/contracts/src/regenerator/index.d.ts +6 -0
- package/dist/contracts/src/regenerator/service.d.ts +2 -0
- package/dist/contracts/src/regenerator/sinks.d.ts +2 -0
- package/dist/contracts/src/regenerator/types.d.ts +3 -0
- package/dist/contracts/src/regenerator/utils.d.ts +1 -0
- package/dist/contracts/src/registry-utils.d.ts +1 -0
- package/dist/contracts/src/registry.d.ts +3 -0
- package/dist/contracts/src/resources.d.ts +19 -0
- package/dist/contracts/src/resources.d.ts.map +1 -0
- package/dist/contracts/src/schema-to-markdown.d.ts +1 -0
- package/dist/contracts/src/server/graphql-pothos.d.ts +7 -0
- package/dist/contracts/src/server/index.d.ts +7 -0
- package/dist/contracts/src/server/mcp/createMcpServer.d.ts +5 -0
- package/dist/contracts/src/server/mcp/mcpTypes.d.ts +2 -0
- package/dist/contracts/src/server/provider-mcp.d.ts +1 -0
- package/dist/contracts/src/server/rest-elysia.d.ts +3 -0
- package/dist/contracts/src/server/rest-express.d.ts +3 -0
- package/dist/contracts/src/server/rest-generic.d.ts +2 -0
- package/dist/contracts/src/server/rest-next-app.d.ts +3 -0
- package/dist/contracts/src/server/rest-next-pages.d.ts +3 -0
- package/dist/contracts/src/telemetry/anomaly.d.ts +2 -0
- package/dist/contracts/src/telemetry/index.d.ts +3 -0
- package/dist/contracts/src/telemetry/spec.d.ts +2 -0
- package/dist/contracts/src/telemetry/tracker.d.ts +2 -0
- package/dist/contracts/src/tests/index.d.ts +2 -0
- package/dist/contracts/src/tests/runner.d.ts +3 -0
- package/dist/contracts/src/tests/spec.d.ts +11 -0
- package/dist/contracts/src/tests/spec.d.ts.map +1 -0
- package/dist/contracts/src/themes.d.ts +2 -0
- package/dist/contracts/src/types.d.ts +5 -0
- package/dist/contracts/src/workflow/adapters/db-adapter.d.ts +1 -0
- package/dist/contracts/src/workflow/adapters/file-adapter.d.ts +1 -0
- package/dist/contracts/src/workflow/adapters/index.d.ts +3 -0
- package/dist/contracts/src/workflow/adapters/memory-store.d.ts +1 -0
- package/dist/contracts/src/workflow/index.d.ts +5 -0
- package/dist/contracts/src/workflow/overview.docblock.d.ts +1 -0
- package/dist/contracts/src/workflow/runner.d.ts +5 -0
- package/dist/contracts/src/workflow/spec.d.ts +5 -0
- package/dist/contracts/src/workflow/state.d.ts +1 -0
- package/dist/contracts/src/workflow/validation.d.ts +3 -0
- package/dist/contracts/src/workspace-config/contractsrc-schema.d.ts +1 -0
- package/dist/contracts/src/workspace-config/index.d.ts +1 -0
- package/dist/contracts/src/workspace-config/workspace-config.docblock.d.ts +1 -0
- package/dist/generator/assertion-builder.d.ts +12 -0
- package/dist/generator/assertion-builder.d.ts.map +1 -0
- package/dist/generator/assertion-builder.js +16 -0
- package/dist/generator/assertion-builder.js.map +1 -0
- package/dist/generator/golden-test-generator.d.ts +27 -0
- package/dist/generator/golden-test-generator.d.ts.map +1 -0
- package/dist/generator/golden-test-generator.js +87 -0
- package/dist/generator/golden-test-generator.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.js +7 -0
- package/dist/recorder/traffic-recorder.d.ts +40 -0
- package/dist/recorder/traffic-recorder.d.ts.map +1 -0
- package/dist/recorder/traffic-recorder.js +60 -0
- package/dist/recorder/traffic-recorder.js.map +1 -0
- package/dist/schema/src/EnumType.d.ts +36 -0
- package/dist/schema/src/EnumType.d.ts.map +1 -0
- package/dist/schema/src/FieldType.d.ts +30 -0
- package/dist/schema/src/FieldType.d.ts.map +1 -0
- package/dist/schema/src/GraphQLSchemaType.d.ts +2 -0
- package/dist/schema/src/JsonSchemaType.d.ts +2 -0
- package/dist/schema/src/ScalarTypeEnum.d.ts +1 -0
- package/dist/schema/src/SchemaModel.d.ts +70 -0
- package/dist/schema/src/SchemaModel.d.ts.map +1 -0
- package/dist/schema/src/SchemaModelType.d.ts +38 -0
- package/dist/schema/src/SchemaModelType.d.ts.map +1 -0
- package/dist/schema/src/ZodSchemaType.d.ts +2 -0
- package/dist/schema/src/entity/defineEntity.d.ts +1 -0
- package/dist/schema/src/entity/generator.d.ts +1 -0
- package/dist/schema/src/entity/index.d.ts +3 -0
- package/dist/schema/src/entity/types.d.ts +1 -0
- package/dist/schema/src/index.d.ts +9 -0
- package/dist/types.d.ts +46 -0
- package/dist/types.d.ts.map +1 -0
- package/package.json +59 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../contracts/src/tests/spec.ts"],"sourcesContent":[],"mappings":";;;;UAiFiB,WAAA"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import "../state.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import "../state.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import "../state.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import "../docs/index.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import "./spec.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import "zod";
|
|
@@ -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"}
|
package/dist/index.d.ts
ADDED
|
@@ -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 @@
|
|
|
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 @@
|
|
|
1
|
+
import "./types.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import "./types.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import "zod";
|