@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

package/dist/libs/contracts/dist/schema/dist/FieldType.js

@@ -0,0 +1,49 @@
+import "zod";
+import { GraphQLScalarType } from "graphql";
+
+//#region ../../libs/contracts/dist/schema/dist/FieldType.js
+/**
+* GraphQL scalar wrapper that carries zod and JSON Schema metadata.
+*
+* TInternal is the runtime representation; TExternal is the GraphQL output.
+*/
+var FieldType = class extends GraphQLScalarType {
+	zodSchema;
+	jsonSchemaDef;
+	constructor(config) {
+		super(config);
+		this.zodSchema = config.zod;
+		this.jsonSchemaDef = config.jsonSchema;
+	}
+	/** Return the attached zod schema for validation. */
+	getZod() {
+		return this.zodSchema;
+	}
+	/** GraphQL scalar instance usable by Pothos or vanilla GraphQL. */
+	getPothos() {
+		return this;
+	}
+	/** Return the JSON Schema (evaluates factory if provided). */
+	getJson() {
+		return typeof this.jsonSchemaDef === "function" ? this.jsonSchemaDef() : this.jsonSchemaDef;
+	}
+	getJsonSchemaDef() {
+		return this.jsonSchemaDef;
+	}
+	getJsonSchema() {
+		const deepResolve = (v) => {
+			const value = typeof v === "function" ? v() : v;
+			if (Array.isArray(value)) return value.map((item) => deepResolve(item));
+			if (value && typeof value === "object") {
+				const obj = {};
+				for (const [k, val] of Object.entries(value)) obj[k] = deepResolve(val);
+				return obj;
+			}
+			return value;
+		};
+		return deepResolve(this.getJson());
+	}
+};
+
+//#endregion
+export { FieldType };

package/dist/libs/contracts/dist/schema/dist/ScalarTypeEnum.js

@@ -0,0 +1,236 @@
+import { FieldType } from "./FieldType.js";
+import * as z$1 from "zod";
+import { Kind } from "graphql";
+
+//#region ../../libs/contracts/dist/schema/dist/ScalarTypeEnum.js
+const localeRegex = /^[A-Za-z]{2}(?:-[A-Za-z0-9]{2,8})*$/;
+const timezoneRegex = /^(?:UTC|[A-Za-z_]+\/[A-Za-z_]+)$/;
+const phoneRegex = /^[+]?\d[\d\s().-]{3,}$/;
+const currencyRegex = /^[A-Z]{3}$/;
+const countryRegex = /^[A-Z]{2}$/;
+const latMin = -90;
+const latMax = 90;
+const lonMin = -180;
+const lonMax = 180;
+/**
+* Factory functions for common scalar FieldTypes with zod/GraphQL/JSON Schema.
+*/
+const ScalarTypeEnum = {
+	String_unsecure: () => new FieldType({
+		name: "String_unsecure",
+		description: "Unvalidated string scalar",
+		zod: z$1.string(),
+		parseValue: (v) => z$1.string().parse(v),
+		serialize: (v) => String(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.STRING) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "string" }
+	}),
+	Int_unsecure: () => new FieldType({
+		name: "Int_unsecure",
+		description: "Unvalidated integer scalar",
+		zod: z$1.number().int(),
+		parseValue: (v) => {
+			const num = typeof v === "number" ? v : Number(v);
+			return z$1.number().int().parse(num);
+		},
+		serialize: (v) => Math.trunc(typeof v === "number" ? v : Number(v)),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.INT) throw new TypeError("Invalid literal");
+			return Number(ast.value);
+		},
+		jsonSchema: { type: "integer" }
+	}),
+	Float_unsecure: () => new FieldType({
+		name: "Float_unsecure",
+		description: "Unvalidated float scalar",
+		zod: z$1.number(),
+		parseValue: (v) => {
+			const num = typeof v === "number" ? v : Number(v);
+			return z$1.number().parse(num);
+		},
+		serialize: (v) => Number(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.FLOAT && ast.kind !== Kind.INT) throw new TypeError("Invalid literal");
+			return Number(ast.value);
+		},
+		jsonSchema: { type: "number" }
+	}),
+	Boolean: () => new FieldType({
+		name: "Boolean",
+		description: "Unvalidated boolean scalar",
+		zod: z$1.boolean(),
+		parseValue: (v) => z$1.coerce.boolean().parse(v),
+		serialize: (v) => Boolean(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.BOOLEAN) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "boolean" }
+	}),
+	ID: () => new FieldType({
+		name: "ID",
+		description: "Unvalidated id scalar",
+		zod: z$1.string(),
+		parseValue: (v) => z$1.string().parse(v),
+		serialize: (v) => String(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.STRING) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "string" }
+	}),
+	JSON: () => new FieldType({
+		name: "JSON",
+		zod: z$1.any(),
+		parseValue: (v) => v,
+		serialize: (v) => v,
+		jsonSchema: {}
+	}),
+	JSONObject: () => new FieldType({
+		name: "JSONObject",
+		zod: z$1.record(z$1.string(), z$1.any()),
+		parseValue: (v) => z$1.record(z$1.string(), z$1.any()).parse(v),
+		serialize: (v) => v ?? {},
+		jsonSchema: { type: "object" }
+	}),
+	Date: () => new FieldType({
+		name: "Date",
+		zod: z$1.date(),
+		parseValue: (v) => v instanceof Date ? v : new Date(String(v)),
+		serialize: (v) => v instanceof Date ? v.toISOString().split("T")[0] : String(v),
+		jsonSchema: {
+			type: "string",
+			format: "date"
+		}
+	}),
+	DateTime: () => new FieldType({
+		name: "DateTime",
+		zod: z$1.date(),
+		parseValue: (v) => v instanceof Date ? v : new Date(String(v)),
+		serialize: (v) => {
+			return v instanceof Date ? v.toISOString() : String(v);
+		},
+		jsonSchema: {
+			type: "string",
+			format: "date-time"
+		}
+	}),
+	Time: () => new FieldType({
+		name: "Time",
+		zod: z$1.string().regex(/^\d{2}:\d{2}(:\d{2})?$/),
+		parseValue: (v) => z$1.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: "^\\d{2}:\\d{2}(:\\d{2})?$"
+		}
+	}),
+	EmailAddress: () => new FieldType({
+		name: "EmailAddress",
+		zod: z$1.string().email(),
+		parseValue: (v) => z$1.string().email().parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			format: "email"
+		}
+	}),
+	URL: () => new FieldType({
+		name: "URL",
+		zod: z$1.string().url(),
+		parseValue: (v) => z$1.string().url().parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			format: "uri"
+		}
+	}),
+	PhoneNumber: () => new FieldType({
+		name: "PhoneNumber",
+		zod: z$1.string().regex(phoneRegex),
+		parseValue: (v) => z$1.string().regex(phoneRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: phoneRegex.source
+		}
+	}),
+	NonEmptyString: () => new FieldType({
+		name: "NonEmptyString",
+		zod: z$1.string().min(1),
+		parseValue: (v) => z$1.string().min(1).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			minLength: 1
+		}
+	}),
+	Locale: () => new FieldType({
+		name: "Locale",
+		zod: z$1.string().regex(localeRegex),
+		parseValue: (v) => z$1.string().regex(localeRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: localeRegex.source
+		}
+	}),
+	TimeZone: () => new FieldType({
+		name: "TimeZone",
+		zod: z$1.string().regex(timezoneRegex),
+		parseValue: (v) => z$1.string().regex(timezoneRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: timezoneRegex.source
+		}
+	}),
+	Latitude: () => new FieldType({
+		name: "Latitude",
+		zod: z$1.number().min(latMin).max(latMax),
+		parseValue: (v) => z$1.coerce.number().min(latMin).max(latMax).parse(v),
+		serialize: (v) => Number(v),
+		jsonSchema: {
+			type: "number",
+			minimum: latMin,
+			maximum: latMax
+		}
+	}),
+	Longitude: () => new FieldType({
+		name: "Longitude",
+		zod: z$1.number().min(lonMin).max(lonMax),
+		parseValue: (v) => z$1.coerce.number().min(lonMin).max(lonMax).parse(v),
+		serialize: (v) => Number(v),
+		jsonSchema: {
+			type: "number",
+			minimum: lonMin,
+			maximum: lonMax
+		}
+	}),
+	Currency: () => new FieldType({
+		name: "Currency",
+		zod: z$1.string().regex(currencyRegex),
+		parseValue: (v) => z$1.string().regex(currencyRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: currencyRegex.source
+		}
+	}),
+	CountryCode: () => new FieldType({
+		name: "CountryCode",
+		zod: z$1.string().regex(countryRegex),
+		parseValue: (v) => z$1.string().regex(countryRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: countryRegex.source
+		}
+	})
+};
+
+//#endregion
+export { ScalarTypeEnum };

package/dist/libs/contracts/dist/schema/dist/SchemaModel.js

@@ -0,0 +1,34 @@
+import "./EnumType.js";
+import "./FieldType.js";
+import * as z$1 from "zod";
+
+//#region ../../libs/contracts/dist/schema/dist/SchemaModel.js
+/**
+* Named object model built from FieldType/EnumType/SchemaModel fields.
+* Provides zod and GraphQL input helpers, and supports arrays/optional fields.
+*/
+var SchemaModel = class {
+	constructor(config) {
+		this.config = config;
+	}
+	/**
+	* Build a typed ZodObject from the model fields, preserving each field's
+	* Zod schema and optionality at the type level when possible.
+	*/
+	getZod() {
+		const shape = Object.entries(this.config.fields).reduce((acc, [key, def]) => {
+			const base = def.type.getZod();
+			const withArray = def.isArray ? z$1.array(base) : base;
+			acc[key] = def.isOptional ? withArray.optional() : withArray;
+			return acc;
+		}, {});
+		return z$1.object(shape);
+	}
+	/** Input object name for GraphQL builder adapters. */
+	getPothosInput() {
+		return this.config.name;
+	}
+};
+
+//#endregion
+export { SchemaModel };

package/dist/libs/contracts/dist/schema/dist/entity/defineEntity.js

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/contracts/dist/schema/dist/entity/index.js

@@ -0,0 +1,2 @@
+import "./defineEntity.js";
+import "./types.js";

package/dist/libs/contracts/dist/schema/dist/entity/types.js

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/contracts/dist/schema/dist/index.js

@@ -0,0 +1,6 @@
+import "./EnumType.js";
+import "./FieldType.js";
+import "./SchemaModel.js";
+import "./ScalarTypeEnum.js";
+import "./entity/defineEntity.js";
+import "./entity/index.js";

package/dist/libs/contracts/dist/server/graphql-pothos.js

@@ -0,0 +1,6 @@
+import "../jsonschema.js";
+import "@pothos/plugin-prisma";
+import "@pothos/plugin-complexity";
+import "@pothos/plugin-relay";
+import "@pothos/plugin-dataloader";
+import "@pothos/plugin-tracing";

package/dist/libs/contracts/dist/server/index.js

@@ -0,0 +1,8 @@
+import "./graphql-pothos.js";
+import "./mcp/createMcpServer.js";
+import "./rest-generic.js";
+import "./rest-elysia.js";
+import "./rest-express.js";
+import "./rest-next-app.js";
+import "./rest-next-pages.js";
+import "./provider-mcp.js";

package/dist/libs/contracts/dist/server/mcp/createMcpServer.js

@@ -0,0 +1,4 @@
+import "./registerTools.js";
+import "./registerResources.js";
+import "./registerPrompts.js";
+import "./registerPresentations.js";

package/dist/libs/contracts/dist/server/mcp/registerPresentations.js

@@ -0,0 +1,2 @@
+import "../../presentations.v2.js";
+import "../../presentations.js";

package/dist/libs/contracts/dist/server/mcp/registerPrompts.js

@@ -0,0 +1 @@
+import z from "zod";

package/dist/libs/contracts/dist/server/mcp/registerResources.js

@@ -0,0 +1,2 @@
+import "@modelcontextprotocol/sdk/server/mcp.js";
+import "node:buffer";

package/dist/libs/contracts/dist/server/mcp/registerTools.js

@@ -0,0 +1 @@
+import "../../jsonschema.js";

package/dist/libs/contracts/dist/server/provider-mcp.js

@@ -0,0 +1 @@
+import "./mcp/createMcpServer.js";

package/dist/libs/contracts/dist/server/rest-elysia.js

@@ -0,0 +1 @@
+import "./rest-generic.js";

package/dist/libs/contracts/dist/server/rest-express.js

@@ -0,0 +1 @@
+import "./rest-generic.js";

package/dist/libs/contracts/dist/server/rest-generic.js

@@ -0,0 +1 @@
+import "../jsonschema.js";

package/dist/libs/contracts/dist/server/rest-next-app.js

@@ -0,0 +1 @@
+import "./rest-generic.js";

package/dist/libs/contracts/dist/server/rest-next-pages.js

@@ -0,0 +1 @@
+import "./rest-generic.js";

package/dist/libs/contracts/dist/spec.js

@@ -0,0 +1,35 @@
+//#region ../../libs/contracts/dist/spec.js
+const isEmitDeclRef = (e) => "ref" in e;
+/**
+* Helper to define a Command (write operation).
+* Sets `kind: 'command'` and defaults `idempotent: false`.
+*/
+const defineCommand = (spec) => ({
+	...spec,
+	meta: {
+		...spec.meta,
+		kind: "command"
+	},
+	policy: {
+		...spec.policy,
+		idempotent: spec.policy?.["policy"]?.idempotent ?? false
+	}
+});
+/**
+* Helper to define a Query (read-only operation).
+* Sets `kind: 'query'` and forces `idempotent: true`.
+*/
+const defineQuery = (spec) => ({
+	...spec,
+	meta: {
+		...spec.meta,
+		kind: "query"
+	},
+	policy: {
+		...spec.policy,
+		idempotent: true
+	}
+});
+
+//#endregion
+export { defineCommand, defineQuery, isEmitDeclRef };

package/dist/libs/contracts/dist/telemetry/index.js

@@ -0,0 +1 @@
+import "./tracker.js";

package/dist/libs/contracts/dist/telemetry/tracker.js

@@ -0,0 +1 @@
+import "crypto";

package/dist/libs/contracts/dist/tests/index.js

@@ -0,0 +1 @@
+import { TestRunner } from "./runner.js";

package/dist/libs/contracts/dist/tests/runner.js

@@ -0,0 +1,150 @@
+import "../index.js";
+import { deepStrictEqual } from "node:assert";
+
+//#region ../../libs/contracts/dist/tests/runner.js
+var TestRunner = class {
+	constructor(config) {
+		this.config = config;
+	}
+	async run(spec) {
+		const scenarios = [];
+		let passed = 0;
+		let failed = 0;
+		for (const scenario of spec.scenarios) {
+			await this.config.beforeEach?.(scenario);
+			const result = await this.runScenario(spec, scenario);
+			scenarios.push(result);
+			if (result.status === "passed") passed += 1;
+			else failed += 1;
+			await this.config.afterEach?.(scenario, result);
+		}
+		return {
+			spec,
+			scenarios,
+			passed,
+			failed
+		};
+	}
+	async runScenario(spec, scenario) {
+		const assertionResults = [];
+		try {
+			const context = await this.createContext();
+			const fixtures = [...spec.fixtures ?? [], ...scenario.given ?? []];
+			const events = [];
+			for (const fixture of fixtures) await this.executeOperation(fixture, context, events);
+			const actionResult = await this.executeOperation(scenario.when, context, events);
+			const assertions = scenario.then ?? [];
+			for (const assertion of assertions) {
+				const assertionResult = this.evaluateAssertion(assertion, actionResult, events);
+				assertionResults.push(assertionResult);
+			}
+			return {
+				scenario,
+				status: assertionResults.some((assertion) => assertion.status === "failed") ? "failed" : "passed",
+				assertionResults
+			};
+		} catch (error) {
+			return {
+				scenario,
+				status: "failed",
+				error,
+				assertionResults
+			};
+		}
+	}
+	async createContext() {
+		return { ...await this.config.createContext?.() ?? {} };
+	}
+	async executeOperation(action, baseCtx, recordedEvents) {
+		const ctx = {
+			...baseCtx,
+			eventPublisher: async (event) => {
+				recordedEvents.push({
+					name: event.name,
+					version: event.version,
+					payload: event.payload
+				});
+				await baseCtx.eventPublisher?.(event);
+			}
+		};
+		try {
+			return {
+				output: await this.config.registry.execute(action.operation.name, action.operation.version, action.input ?? null, ctx),
+				events: recordedEvents
+			};
+		} catch (error) {
+			return {
+				error,
+				events: recordedEvents
+			};
+		}
+	}
+	evaluateAssertion(assertion, result, events) {
+		switch (assertion.type) {
+			case "expectOutput": return this.evaluateOutputAssertion(assertion, result);
+			case "expectError": return this.evaluateErrorAssertion(assertion, result);
+			case "expectEvents": return this.evaluateEventsAssertion(assertion, events);
+			default: return {
+				assertion,
+				status: "failed",
+				message: `Unknown assertion type ${assertion.type}`
+			};
+		}
+	}
+	evaluateOutputAssertion(assertion, result) {
+		if (result.error) return {
+			assertion,
+			status: "failed",
+			message: `Expected output but operation threw error: ${result.error.message}`
+		};
+		try {
+			deepStrictEqual(result.output, assertion.match);
+			return {
+				assertion,
+				status: "passed"
+			};
+		} catch (error) {
+			return {
+				assertion,
+				status: "failed",
+				message: error instanceof Error ? error.message : "Output assertion failed"
+			};
+		}
+	}
+	evaluateErrorAssertion(assertion, result) {
+		if (!result.error) return {
+			assertion,
+			status: "failed",
+			message: "Expected an error but operation completed successfully"
+		};
+		if (assertion.messageIncludes && !result.error.message.includes(assertion.messageIncludes)) return {
+			assertion,
+			status: "failed",
+			message: `Error message "${result.error.message}" did not include expected substring "${assertion.messageIncludes}"`
+		};
+		return {
+			assertion,
+			status: "passed"
+		};
+	}
+	evaluateEventsAssertion(assertion, events) {
+		const failures = [];
+		for (const expected of assertion.events) {
+			const count = events.filter((event) => event.name === expected.name && event.version === expected.version).length;
+			if (typeof expected.min === "number" && count < expected.min || typeof expected.max === "number" && count > expected.max) failures.push(`Event ${expected.name}.v${expected.version} occurred ${count} times (expected ${expected.min ?? 0} - ${expected.max ?? "∞"})`);
+			else if (typeof expected.min === "undefined" && typeof expected.max === "undefined" && count === 0) failures.push(`Event ${expected.name}.v${expected.version} did not occur`);
+		}
+		if (failures.length > 0) return {
+			assertion,
+			status: "failed",
+			message: failures.join("; ")
+		};
+		return {
+			assertion,
+			status: "passed"
+		};
+	}
+};
+
+//#endregion
+export { TestRunner };

package/dist/libs/contracts/dist/workflow/index.js

@@ -0,0 +1 @@
+import "./runner.js";

package/dist/libs/contracts/dist/workflow/runner.js

@@ -0,0 +1 @@
+import "node:crypto";

package/dist/libs/contracts-transformers/dist/common/utils.js

@@ -0,0 +1,47 @@
+//#region ../../libs/contracts-transformers/dist/common/utils.js
+/**
+* Common utilities for contract transformations.
+*/
+/**
+* Convert a string to PascalCase.
+*/
+function toPascalCase(str) {
+	return str.replace(/[-_./\s]+(.)?/g, (_, c) => c ? c.toUpperCase() : "").replace(/^./, (c) => c.toUpperCase());
+}
+/**
+* Convert a string to camelCase.
+*/
+function toCamelCase(str) {
+	const pascal = toPascalCase(str);
+	return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/**
+* Convert a string to kebab-case.
+*/
+function toKebabCase(str) {
+	return str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_./]+/g, "-").toLowerCase();
+}
+/**
+* Sanitize a string to be a valid TypeScript identifier.
+*/
+function toValidIdentifier(str) {
+	let result = str.replace(/[^a-zA-Z0-9_$]/g, "_");
+	if (/^[0-9]/.test(result)) result = "_" + result;
+	return result;
+}
+/**
+* Generate a ContractSpec name from an operation identifier.
+*/
+function toSpecName(operationId, prefix) {
+	const name = toCamelCase(operationId);
+	return prefix ? `${prefix}.${name}` : name;
+}
+/**
+* Generate a file name from a spec name.
+*/
+function toFileName(specName) {
+	return toKebabCase(specName.replace(/\./g, "-")) + ".ts";
+}
+
+//#endregion
+export { toCamelCase, toFileName, toPascalCase, toSpecName, toValidIdentifier };

package/dist/libs/contracts-transformers/dist/openapi/exporter.js

@@ -0,0 +1 @@
+import "zod";