@contractspec/lib.contracts-transformers 0.0.0-canary-20260113162409

package/dist/openapi/differ.js

@@ -0,0 +1,222 @@
+import { deepEqual } from "../common/utils.js";
+
+//#region src/openapi/differ.ts
+/**
+* Compare two values and generate a diff change if different.
+*/
+function compareValues(path, oldValue, newValue, description) {
+	if (deepEqual(oldValue, newValue)) return null;
+	let changeType = "modified";
+	if (oldValue === void 0 || oldValue === null) changeType = "added";
+	else if (newValue === void 0 || newValue === null) changeType = "removed";
+	else if (typeof oldValue !== typeof newValue) changeType = "type_changed";
+	return {
+		path,
+		type: changeType,
+		oldValue,
+		newValue,
+		description
+	};
+}
+/**
+* Diff two objects recursively.
+*/
+function diffObjects(path, oldObj, newObj, options) {
+	const changes = [];
+	if (!oldObj && !newObj) return changes;
+	if (!oldObj) {
+		changes.push({
+			path,
+			type: "added",
+			newValue: newObj,
+			description: `Added ${path}`
+		});
+		return changes;
+	}
+	if (!newObj) {
+		changes.push({
+			path,
+			type: "removed",
+			oldValue: oldObj,
+			description: `Removed ${path}`
+		});
+		return changes;
+	}
+	const allKeys = new Set([...Object.keys(oldObj), ...Object.keys(newObj)]);
+	for (const key of allKeys) {
+		const keyPath = path ? `${path}.${key}` : key;
+		if (options.ignorePaths?.some((p) => keyPath.startsWith(p))) continue;
+		const oldVal = oldObj[key];
+		const newVal = newObj[key];
+		if (typeof oldVal === "object" && typeof newVal === "object") changes.push(...diffObjects(keyPath, oldVal, newVal, options));
+		else {
+			const change = compareValues(keyPath, oldVal, newVal, `Changed ${keyPath}`);
+			if (change) changes.push(change);
+		}
+	}
+	return changes;
+}
+/**
+* Diff a ContractSpec against an OpenAPI operation.
+*/
+function diffSpecVsOperation(spec, operation, options = {}) {
+	const changes = [];
+	if (!options.ignoreDescriptions) {
+		const descChange = compareValues("meta.description", spec.meta.description, operation.summary ?? operation.description, "Description changed");
+		if (descChange) changes.push(descChange);
+	}
+	if (!options.ignoreTags) {
+		const oldTags = [...spec.meta.tags ?? []].sort();
+		const newTags = [...operation.tags].sort();
+		if (!deepEqual(oldTags, newTags)) changes.push({
+			path: "meta.tags",
+			type: "modified",
+			oldValue: oldTags,
+			newValue: newTags,
+			description: "Tags changed"
+		});
+	}
+	if (!options.ignoreTransport) {
+		const specMethod = spec.transport?.rest?.method ?? (spec.meta.kind === "query" ? "GET" : "POST");
+		const opMethod = operation.method.toUpperCase();
+		if (specMethod !== opMethod) changes.push({
+			path: "transport.rest.method",
+			type: "modified",
+			oldValue: specMethod,
+			newValue: opMethod,
+			description: "HTTP method changed"
+		});
+		const specPath = spec.transport?.rest?.path;
+		if (specPath && specPath !== operation.path) changes.push({
+			path: "transport.rest.path",
+			type: "modified",
+			oldValue: specPath,
+			newValue: operation.path,
+			description: "Path changed"
+		});
+	}
+	if (spec.meta.stability === "deprecated" !== operation.deprecated) changes.push({
+		path: "meta.stability",
+		type: "modified",
+		oldValue: spec.meta.stability,
+		newValue: operation.deprecated ? "deprecated" : "stable",
+		description: "Deprecation status changed"
+	});
+	return changes;
+}
+/**
+* Diff two ContractSpecs.
+*/
+function diffSpecs(oldSpec, newSpec, options = {}) {
+	const changes = [];
+	const metaChanges = diffObjects("meta", oldSpec.meta, newSpec.meta, {
+		...options,
+		ignorePaths: [
+			...options.ignorePaths ?? [],
+			...options.ignoreDescriptions ? [
+				"meta.description",
+				"meta.goal",
+				"meta.context"
+			] : [],
+			...options.ignoreTags ? ["meta.tags"] : []
+		]
+	});
+	changes.push(...metaChanges);
+	if (!options.ignoreTransport) {
+		const transportChanges = diffObjects("transport", oldSpec.transport, newSpec.transport, options);
+		changes.push(...transportChanges);
+	}
+	const policyChanges = diffObjects("policy", oldSpec.policy, newSpec.policy, options);
+	changes.push(...policyChanges);
+	return changes;
+}
+/**
+* Create a SpecDiff from an existing spec and an imported spec.
+*/
+function createSpecDiff(operationId, existing, incoming, options = {}) {
+	let changes = [];
+	let isEquivalent = false;
+	if (existing && incoming.operationSpec) {
+		changes = diffSpecs(existing, incoming.operationSpec, options);
+		isEquivalent = changes.length === 0;
+	} else if (existing && !incoming.operationSpec) changes = [{
+		path: "",
+		type: "modified",
+		oldValue: existing,
+		newValue: incoming.code,
+		description: "Spec code imported from OpenAPI (runtime comparison not available)"
+	}];
+	else changes = [{
+		path: "",
+		type: "added",
+		newValue: incoming.operationSpec ?? incoming.code,
+		description: "New spec imported from OpenAPI"
+	}];
+	return {
+		operationId,
+		existing,
+		incoming,
+		changes,
+		isEquivalent
+	};
+}
+/**
+* Batch diff multiple specs against OpenAPI operations.
+*/
+function diffAll(existingSpecs, importedSpecs, options = {}) {
+	const diffs = [];
+	const matchedExisting = /* @__PURE__ */ new Set();
+	for (const imported of importedSpecs) {
+		const operationId = imported.source.sourceId;
+		let existing;
+		for (const [key, spec] of existingSpecs) {
+			const specName = spec.meta.key;
+			if (key === operationId || specName.includes(operationId)) {
+				existing = spec;
+				matchedExisting.add(key);
+				break;
+			}
+		}
+		diffs.push(createSpecDiff(operationId, existing, imported, options));
+	}
+	for (const [key, spec] of existingSpecs) if (!matchedExisting.has(key)) diffs.push({
+		operationId: key,
+		existing: spec,
+		incoming: void 0,
+		changes: [{
+			path: "",
+			type: "removed",
+			oldValue: spec,
+			description: "Spec no longer exists in OpenAPI source"
+		}],
+		isEquivalent: false
+	});
+	return diffs;
+}
+/**
+* Format diff changes for display.
+*/
+function formatDiffChanges(changes) {
+	if (changes.length === 0) return "No changes detected";
+	const lines = [];
+	for (const change of changes) {
+		const prefix = {
+			added: "+",
+			removed: "-",
+			modified: "~",
+			type_changed: "!",
+			required_changed: "?"
+		}[change.type];
+		lines.push(`${prefix} ${change.path}: ${change.description}`);
+		if (change.type === "modified" || change.type === "type_changed") {
+			lines.push(`    old: ${JSON.stringify(change.oldValue)}`);
+			lines.push(`    new: ${JSON.stringify(change.newValue)}`);
+		} else if (change.type === "added") lines.push(`    value: ${JSON.stringify(change.newValue)}`);
+		else if (change.type === "removed") lines.push(`    was: ${JSON.stringify(change.oldValue)}`);
+	}
+	return lines.join("\n");
+}
+
+//#endregion
+export { createSpecDiff, diffAll, diffSpecVsOperation, diffSpecs, formatDiffChanges };
+//# sourceMappingURL=differ.js.map

package/dist/openapi/differ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.js","names":[],"sources":["../../src/openapi/differ.ts"],"sourcesContent":["/**\n * Diff ContractSpec specs against OpenAPI operations.\n * Used for sync operations to detect changes.\n */\n\nimport type { AnyOperationSpec } from '@contractspec/lib.contracts';\nimport type { ParsedOperation } from './types';\nimport type {\n  DiffChange,\n  DiffChangeType,\n  ImportedOperationSpec,\n  SpecDiff,\n} from '../common/types';\nimport { deepEqual } from '../common/utils';\n\n/**\n * Options for diffing specs.\n */\nexport interface DiffOptions {\n  /** Ignore description changes */\n  ignoreDescriptions?: boolean;\n  /** Ignore tag changes */\n  ignoreTags?: boolean;\n  /** Ignore transport changes (path, method) */\n  ignoreTransport?: boolean;\n  /** Custom paths to ignore */\n  ignorePaths?: string[];\n}\n\n/**\n * Compare two values and generate a diff change if different.\n */\nfunction compareValues(\n  path: string,\n  oldValue: unknown,\n  newValue: unknown,\n  description: string\n): DiffChange | null {\n  if (deepEqual(oldValue, newValue)) {\n    return null;\n  }\n\n  let changeType: DiffChangeType = 'modified';\n  if (oldValue === undefined || oldValue === null) {\n    changeType = 'added';\n  } else if (newValue === undefined || newValue === null) {\n    changeType = 'removed';\n  } else if (typeof oldValue !== typeof newValue) {\n    changeType = 'type_changed';\n  }\n\n  return {\n    path,\n    type: changeType,\n    oldValue,\n    newValue,\n    description,\n  };\n}\n\n/**\n * Diff two objects recursively.\n */\nfunction diffObjects(\n  path: string,\n  oldObj: Record<string, unknown> | undefined,\n  newObj: Record<string, unknown> | undefined,\n  options: DiffOptions\n): DiffChange[] {\n  const changes: DiffChange[] = [];\n\n  if (!oldObj && !newObj) return changes;\n  if (!oldObj) {\n    changes.push({\n      path,\n      type: 'added',\n      newValue: newObj,\n      description: `Added ${path}`,\n    });\n    return changes;\n  }\n  if (!newObj) {\n    changes.push({\n      path,\n      type: 'removed',\n      oldValue: oldObj,\n      description: `Removed ${path}`,\n    });\n    return changes;\n  }\n\n  const allKeys = new Set([...Object.keys(oldObj), ...Object.keys(newObj)]);\n\n  for (const key of allKeys) {\n    const keyPath = path ? `${path}.${key}` : key;\n\n    // Skip ignored paths\n    if (options.ignorePaths?.some((p) => keyPath.startsWith(p))) {\n      continue;\n    }\n\n    const oldVal = oldObj[key];\n    const newVal = newObj[key];\n\n    if (typeof oldVal === 'object' && typeof newVal === 'object') {\n      changes.push(\n        ...diffObjects(\n          keyPath,\n          oldVal as Record<string, unknown>,\n          newVal as Record<string, unknown>,\n          options\n        )\n      );\n    } else {\n      const change = compareValues(\n        keyPath,\n        oldVal,\n        newVal,\n        `Changed ${keyPath}`\n      );\n      if (change) {\n        changes.push(change);\n      }\n    }\n  }\n\n  return changes;\n}\n\n/**\n * Diff a ContractSpec against an OpenAPI operation.\n */\nexport function diffSpecVsOperation(\n  spec: AnyOperationSpec,\n  operation: ParsedOperation,\n  options: DiffOptions = {}\n): DiffChange[] {\n  const changes: DiffChange[] = [];\n\n  // Compare basic metadata\n  if (!options.ignoreDescriptions) {\n    const descChange = compareValues(\n      'meta.description',\n      spec.meta.description,\n      operation.summary ?? operation.description,\n      'Description changed'\n    );\n    if (descChange) changes.push(descChange);\n  }\n\n  if (!options.ignoreTags) {\n    const oldTags = [...(spec.meta.tags ?? [])].sort();\n    const newTags = [...operation.tags].sort();\n    if (!deepEqual(oldTags, newTags)) {\n      changes.push({\n        path: 'meta.tags',\n        type: 'modified',\n        oldValue: oldTags,\n        newValue: newTags,\n        description: 'Tags changed',\n      });\n    }\n  }\n\n  // Compare transport\n  if (!options.ignoreTransport) {\n    const specMethod =\n      spec.transport?.rest?.method ??\n      (spec.meta.kind === 'query' ? 'GET' : 'POST');\n    const opMethod = operation.method.toUpperCase();\n\n    if (specMethod !== opMethod) {\n      changes.push({\n        path: 'transport.rest.method',\n        type: 'modified',\n        oldValue: specMethod,\n        newValue: opMethod,\n        description: 'HTTP method changed',\n      });\n    }\n\n    const specPath = spec.transport?.rest?.path;\n    if (specPath && specPath !== operation.path) {\n      changes.push({\n        path: 'transport.rest.path',\n        type: 'modified',\n        oldValue: specPath,\n        newValue: operation.path,\n        description: 'Path changed',\n      });\n    }\n  }\n\n  // Compare deprecation status\n  const specDeprecated = spec.meta.stability === 'deprecated';\n  if (specDeprecated !== operation.deprecated) {\n    changes.push({\n      path: 'meta.stability',\n      type: 'modified',\n      oldValue: spec.meta.stability,\n      newValue: operation.deprecated ? 'deprecated' : 'stable',\n      description: 'Deprecation status changed',\n    });\n  }\n\n  return changes;\n}\n\n/**\n * Diff two ContractSpecs.\n */\nexport function diffSpecs(\n  oldSpec: AnyOperationSpec,\n  newSpec: AnyOperationSpec,\n  options: DiffOptions = {}\n): DiffChange[] {\n  const changes: DiffChange[] = [];\n\n  // Compare meta\n  const metaChanges = diffObjects(\n    'meta',\n    oldSpec.meta as unknown as Record<string, unknown>,\n    newSpec.meta as unknown as Record<string, unknown>,\n    {\n      ...options,\n      ignorePaths: [\n        ...(options.ignorePaths ?? []),\n        ...(options.ignoreDescriptions\n          ? ['meta.description', 'meta.goal', 'meta.context']\n          : []),\n        ...(options.ignoreTags ? ['meta.tags'] : []),\n      ],\n    }\n  );\n  changes.push(...metaChanges);\n\n  // Compare transport\n  if (!options.ignoreTransport) {\n    const transportChanges = diffObjects(\n      'transport',\n      oldSpec.transport as unknown as Record<string, unknown>,\n      newSpec.transport as unknown as Record<string, unknown>,\n      options\n    );\n    changes.push(...transportChanges);\n  }\n\n  // Compare policy\n  const policyChanges = diffObjects(\n    'policy',\n    oldSpec.policy as unknown as Record<string, unknown>,\n    newSpec.policy as unknown as Record<string, unknown>,\n    options\n  );\n  changes.push(...policyChanges);\n\n  return changes;\n}\n\n/**\n * Create a SpecDiff from an existing spec and an imported spec.\n */\nexport function createSpecDiff(\n  operationId: string,\n  existing: AnyOperationSpec | undefined,\n  incoming: ImportedOperationSpec,\n  options: DiffOptions = {}\n): SpecDiff {\n  let changes: DiffChange[] = [];\n  let isEquivalent = false;\n\n  if (existing && incoming.operationSpec) {\n    // Compare existing vs incoming\n    changes = diffSpecs(existing, incoming.operationSpec, options);\n    isEquivalent = changes.length === 0;\n  } else if (existing && !incoming.operationSpec) {\n    // Incoming has code but no runtime spec - can't compare directly\n    changes = [\n      {\n        path: '',\n        type: 'modified',\n        oldValue: existing,\n        newValue: incoming.code,\n        description:\n          'Spec code imported from OpenAPI (runtime comparison not available)',\n      },\n    ];\n  } else {\n    // New spec - mark as added\n    changes = [\n      {\n        path: '',\n        type: 'added',\n        newValue: incoming.operationSpec ?? incoming.code,\n        description: 'New spec imported from OpenAPI',\n      },\n    ];\n  }\n\n  return {\n    operationId,\n    existing,\n    incoming,\n    changes,\n    isEquivalent,\n  };\n}\n\n/**\n * Batch diff multiple specs against OpenAPI operations.\n */\nexport function diffAll(\n  existingSpecs: Map<string, AnyOperationSpec>,\n  importedSpecs: ImportedOperationSpec[],\n  options: DiffOptions = {}\n): SpecDiff[] {\n  const diffs: SpecDiff[] = [];\n\n  // Track which existing specs have been matched\n  const matchedExisting = new Set<string>();\n\n  for (const imported of importedSpecs) {\n    const operationId = imported.source.sourceId;\n\n    // Try to find matching existing spec\n    // Match by operationId in x-contractspec extension or by name\n    let existing: AnyOperationSpec | undefined;\n\n    for (const [key, spec] of existingSpecs) {\n      // Check x-contractspec match or name match\n      const specName = spec.meta.key;\n      if (key === operationId || specName.includes(operationId)) {\n        existing = spec;\n        matchedExisting.add(key);\n        break;\n      }\n    }\n\n    diffs.push(createSpecDiff(operationId, existing, imported, options));\n  }\n\n  // Add diffs for existing specs that weren't matched (removed from OpenAPI)\n  for (const [key, spec] of existingSpecs) {\n    if (!matchedExisting.has(key)) {\n      diffs.push({\n        operationId: key,\n        existing: spec,\n        incoming: undefined as unknown as ImportedOperationSpec,\n        changes: [\n          {\n            path: '',\n            type: 'removed',\n            oldValue: spec,\n            description: 'Spec no longer exists in OpenAPI source',\n          },\n        ],\n        isEquivalent: false,\n      });\n    }\n  }\n\n  return diffs;\n}\n\n/**\n * Format diff changes for display.\n */\nexport function formatDiffChanges(changes: DiffChange[]): string {\n  if (changes.length === 0) {\n    return 'No changes detected';\n  }\n\n  const lines: string[] = [];\n\n  for (const change of changes) {\n    const prefix = {\n      added: '+',\n      removed: '-',\n      modified: '~',\n      type_changed: '!',\n      required_changed: '?',\n    }[change.type];\n\n    lines.push(`${prefix} ${change.path}: ${change.description}`);\n\n    if (change.type === 'modified' || change.type === 'type_changed') {\n      lines.push(`    old: ${JSON.stringify(change.oldValue)}`);\n      lines.push(`    new: ${JSON.stringify(change.newValue)}`);\n    } else if (change.type === 'added') {\n      lines.push(`    value: ${JSON.stringify(change.newValue)}`);\n    } else if (change.type === 'removed') {\n      lines.push(`    was: ${JSON.stringify(change.oldValue)}`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n"],"mappings":"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"}

package/dist/openapi/exporter/data-views.d.ts

@@ -0,0 +1,38 @@
+import { GeneratedRegistryCode } from "../types.js";
+import { DataViewRegistry } from "@contractspec/lib.contracts";
+
+//#region src/openapi/exporter/data-views.d.ts
+
+/**
+ * Exported data view structure for OpenAPI extensions.
+ */
+interface ExportedDataView {
+  name: string;
+  version: string;
+  description?: string;
+  stability?: string;
+  entity: string;
+  kind: 'list' | 'detail' | 'table' | 'grid';
+  source: {
+    primary: {
+      key: string;
+      version: string;
+    };
+    item?: {
+      key: string;
+      version: string;
+    };
+  };
+  fields: unknown[];
+}
+/**
+ * Export data views to OpenAPI extension format.
+ */
+declare function exportDataViews(registry: DataViewRegistry): ExportedDataView[];
+/**
+ * Generate TypeScript code for data views registry.
+ */
+declare function generateDataViewsRegistry(registry: DataViewRegistry): GeneratedRegistryCode;
+//#endregion
+export { ExportedDataView, exportDataViews, generateDataViewsRegistry };
+//# sourceMappingURL=data-views.d.ts.map

package/dist/openapi/exporter/data-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views.d.ts","names":[],"sources":["../../../src/openapi/exporter/data-views.ts"],"sourcesContent":[],"mappings":";;;;;AA0BA;AAkBA;;UAnCiB,gBAAA;;;;;;;;;;;;;;;;;;;;;;iBAiBD,eAAA,WACJ,mBACT;;;;iBAgBa,yBAAA,WACJ,mBACT"}

package/dist/openapi/exporter/data-views.js

@@ -0,0 +1,47 @@
+//#region src/openapi/exporter/data-views.ts
+/**
+* Export data views to OpenAPI extension format.
+*/
+function exportDataViews(registry) {
+	return registry.list().map((dv) => ({
+		name: dv.meta.key,
+		version: dv.meta.version,
+		description: dv.meta.description,
+		stability: dv.meta.stability,
+		entity: dv.meta.entity,
+		kind: dv.view.kind,
+		source: dv.source,
+		fields: dv.view.fields
+	}));
+}
+/**
+* Generate TypeScript code for data views registry.
+*/
+function generateDataViewsRegistry(registry) {
+	const dataViews = registry.list();
+	const imports = /* @__PURE__ */ new Set();
+	const registrations = [];
+	for (const dv of dataViews) {
+		const dvVarName = dv.meta.key.replace(/\./g, "_") + `_v${dv.meta.version}`;
+		imports.add(`import { ${dvVarName} } from './${dv.meta.key.split(".")[0]}';`);
+		registrations.push(`  .register(${dvVarName})`);
+	}
+	return {
+		code: `/**
+ * Auto-generated data views registry.
+ * DO NOT EDIT - This file is generated by ContractSpec exporter.
+ */
+import { DataViewRegistry } from '@contractspec/lib.contracts';
+
+${Array.from(imports).join("\n")}
+
+export const dataViewsRegistry = new DataViewRegistry()
+${registrations.join("\n")};
+`,
+		fileName: "dataviews-registry.ts"
+	};
+}
+
+//#endregion
+export { exportDataViews, generateDataViewsRegistry };
+//# sourceMappingURL=data-views.js.map

package/dist/openapi/exporter/data-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views.js","names":[],"sources":["../../../src/openapi/exporter/data-views.ts"],"sourcesContent":["/**\n * Data views exporter - exports DataViewSpec to OpenAPI extensions.\n */\nimport type { DataViewRegistry } from '@contractspec/lib.contracts';\nimport type { GeneratedRegistryCode } from '../types';\n\n/**\n * Exported data view structure for OpenAPI extensions.\n */\nexport interface ExportedDataView {\n  name: string;\n  version: string;\n  description?: string;\n  stability?: string;\n  entity: string;\n  kind: 'list' | 'detail' | 'table' | 'grid';\n  source: {\n    primary: { key: string; version: string };\n    item?: { key: string; version: string };\n  };\n  fields: unknown[];\n}\n\n/**\n * Export data views to OpenAPI extension format.\n */\nexport function exportDataViews(\n  registry: DataViewRegistry\n): ExportedDataView[] {\n  return registry.list().map((dv) => ({\n    name: dv.meta.key,\n    version: dv.meta.version,\n    description: dv.meta.description,\n    stability: dv.meta.stability,\n    entity: dv.meta.entity,\n    kind: dv.view.kind,\n    source: dv.source,\n    fields: dv.view.fields,\n  }));\n}\n\n/**\n * Generate TypeScript code for data views registry.\n */\nexport function generateDataViewsRegistry(\n  registry: DataViewRegistry\n): GeneratedRegistryCode {\n  const dataViews = registry.list();\n  const imports = new Set<string>();\n  const registrations: string[] = [];\n\n  for (const dv of dataViews) {\n    const dvVarName = dv.meta.key.replace(/\\./g, '_') + `_v${dv.meta.version}`;\n    imports.add(\n      `import { ${dvVarName} } from './${dv.meta.key.split('.')[0]}';`\n    );\n    registrations.push(`  .register(${dvVarName})`);\n  }\n\n  const code = `/**\n * Auto-generated data views registry.\n * DO NOT EDIT - This file is generated by ContractSpec exporter.\n */\nimport { DataViewRegistry } from '@contractspec/lib.contracts';\n\n${Array.from(imports).join('\\n')}\n\nexport const dataViewsRegistry = new DataViewRegistry()\n${registrations.join('\\n')};\n`;\n\n  return {\n    code,\n    fileName: 'dataviews-registry.ts',\n  };\n}\n"],"mappings":";;;;AA0BA,SAAgB,gBACd,UACoB;AACpB,QAAO,SAAS,MAAM,CAAC,KAAK,QAAQ;EAClC,MAAM,GAAG,KAAK;EACd,SAAS,GAAG,KAAK;EACjB,aAAa,GAAG,KAAK;EACrB,WAAW,GAAG,KAAK;EACnB,QAAQ,GAAG,KAAK;EAChB,MAAM,GAAG,KAAK;EACd,QAAQ,GAAG;EACX,QAAQ,GAAG,KAAK;EACjB,EAAE;;;;;AAML,SAAgB,0BACd,UACuB;CACvB,MAAM,YAAY,SAAS,MAAM;CACjC,MAAM,0BAAU,IAAI,KAAa;CACjC,MAAM,gBAA0B,EAAE;AAElC,MAAK,MAAM,MAAM,WAAW;EAC1B,MAAM,YAAY,GAAG,KAAK,IAAI,QAAQ,OAAO,IAAI,GAAG,KAAK,GAAG,KAAK;AACjE,UAAQ,IACN,YAAY,UAAU,aAAa,GAAG,KAAK,IAAI,MAAM,IAAI,CAAC,GAAG,IAC9D;AACD,gBAAc,KAAK,eAAe,UAAU,GAAG;;AAejD,QAAO;EACL,MAbW;;;;;;EAMb,MAAM,KAAK,QAAQ,CAAC,KAAK,KAAK,CAAC;;;EAG/B,cAAc,KAAK,KAAK,CAAC;;EAKvB,UAAU;EACX"}

package/dist/openapi/exporter/events.d.ts

@@ -0,0 +1,28 @@
+import { GeneratedRegistryCode } from "../types.js";
+import { EventSpec } from "@contractspec/lib.contracts";
+import { AnySchemaModel } from "@contractspec/lib.schema";
+
+//#region src/openapi/exporter/events.d.ts
+
+type OpenApiSchemaObject = Record<string, unknown>;
+/**
+ * Exported event structure for OpenAPI extensions.
+ */
+interface ExportedEvent {
+  name: string;
+  version: string;
+  description: string;
+  payload: OpenApiSchemaObject | null;
+  pii?: string[];
+}
+/**
+ * Export events to OpenAPI extension format.
+ */
+declare function exportEvents(events: EventSpec<AnySchemaModel>[]): ExportedEvent[];
+/**
+ * Generate TypeScript code for events exports.
+ */
+declare function generateEventsExports(events: EventSpec<AnySchemaModel>[]): GeneratedRegistryCode;
+//#endregion
+export { ExportedEvent, exportEvents, generateEventsExports };
+//# sourceMappingURL=events.d.ts.map

package/dist/openapi/exporter/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","names":[],"sources":["../../../src/openapi/exporter/events.ts"],"sourcesContent":[],"mappings":";;;;;;AAaA,KALK,mBAAA,GAAsB,MAShB,CAAA,MAAA,EAAA,OAAA,CAAA;AAOX;;;AAEG,UAbc,aAAA,CAad;EAAa,IAAA,EAAA,MAAA;EAeA,OAAA,EAAA,MAAA;EACI,WAAA,EAAA,MAAA;EAAV,OAAA,EAzBC,mBAyBD,GAAA,IAAA;EACP,GAAA,CAAA,EAAA,MAAA,EAAA;;;;;iBAnBa,YAAA,SACN,UAAU,oBACjB;;;;iBAea,qBAAA,SACN,UAAU,oBACjB"}

package/dist/openapi/exporter/events.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+
+//#region src/openapi/exporter/events.ts
+/**
+* Export events to OpenAPI extension format.
+*/
+function exportEvents(events) {
+	return events.map((event) => ({
+		name: event.meta.key,
+		version: event.meta.version,
+		description: event.meta.description,
+		payload: event.payload ? z.toJSONSchema(event.payload.getZod()) : null,
+		pii: event.pii
+	}));
+}
+/**
+* Generate TypeScript code for events exports.
+*/
+function generateEventsExports(events) {
+	const eventExports = [];
+	for (const event of events) {
+		const eventVarName = event.meta.key.replace(/\./g, "_") + `_v${event.meta.version}`;
+		eventExports.push(`export { ${eventVarName} } from './${event.meta.key.split(".")[0]}';`);
+	}
+	return {
+		code: `/**
+ * Auto-generated events exports.
+ * DO NOT EDIT - This file is generated by ContractSpec exporter.
+ */
+
+${eventExports.join("\n")}
+`,
+		fileName: "events-exports.ts"
+	};
+}
+
+//#endregion
+export { exportEvents, generateEventsExports };
+//# sourceMappingURL=events.js.map

package/dist/openapi/exporter/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../../../src/openapi/exporter/events.ts"],"sourcesContent":["/**\n * Events exporter - exports EventSpec to OpenAPI extensions.\n */\nimport type { EventSpec } from '@contractspec/lib.contracts';\nimport type { AnySchemaModel } from '@contractspec/lib.schema';\nimport { z } from 'zod';\nimport type { GeneratedRegistryCode } from '../types';\n\ntype OpenApiSchemaObject = Record<string, unknown>;\n\n/**\n * Exported event structure for OpenAPI extensions.\n */\nexport interface ExportedEvent {\n  name: string;\n  version: string;\n  description: string;\n  payload: OpenApiSchemaObject | null;\n  pii?: string[];\n}\n\n/**\n * Export events to OpenAPI extension format.\n */\nexport function exportEvents(\n  events: EventSpec<AnySchemaModel>[]\n): ExportedEvent[] {\n  return events.map((event) => ({\n    name: event.meta.key,\n    version: event.meta.version,\n    description: event.meta.description,\n    payload: event.payload\n      ? (z.toJSONSchema(event.payload.getZod()) as OpenApiSchemaObject)\n      : null,\n    pii: event.pii,\n  }));\n}\n\n/**\n * Generate TypeScript code for events exports.\n */\nexport function generateEventsExports(\n  events: EventSpec<AnySchemaModel>[]\n): GeneratedRegistryCode {\n  const eventExports: string[] = [];\n\n  for (const event of events) {\n    const eventVarName =\n      event.meta.key.replace(/\\./g, '_') + `_v${event.meta.version}`;\n    eventExports.push(\n      `export { ${eventVarName} } from './${event.meta.key.split('.')[0]}';`\n    );\n  }\n\n  const code = `/**\n * Auto-generated events exports.\n * DO NOT EDIT - This file is generated by ContractSpec exporter.\n */\n\n${eventExports.join('\\n')}\n`;\n\n  return {\n    code,\n    fileName: 'events-exports.ts',\n  };\n}\n"],"mappings":";;;;;;AAwBA,SAAgB,aACd,QACiB;AACjB,QAAO,OAAO,KAAK,WAAW;EAC5B,MAAM,MAAM,KAAK;EACjB,SAAS,MAAM,KAAK;EACpB,aAAa,MAAM,KAAK;EACxB,SAAS,MAAM,UACV,EAAE,aAAa,MAAM,QAAQ,QAAQ,CAAC,GACvC;EACJ,KAAK,MAAM;EACZ,EAAE;;;;;AAML,SAAgB,sBACd,QACuB;CACvB,MAAM,eAAyB,EAAE;AAEjC,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,eACJ,MAAM,KAAK,IAAI,QAAQ,OAAO,IAAI,GAAG,KAAK,MAAM,KAAK;AACvD,eAAa,KACX,YAAY,aAAa,aAAa,MAAM,KAAK,IAAI,MAAM,IAAI,CAAC,GAAG,IACpE;;AAWH,QAAO;EACL,MATW;;;;;EAKb,aAAa,KAAK,KAAK,CAAC;;EAKtB,UAAU;EACX"}

package/dist/openapi/exporter/features.d.ts

@@ -0,0 +1,37 @@
+import { GeneratedRegistryCode } from "../types.js";
+import { FeatureRegistry } from "@contractspec/lib.contracts";
+
+//#region src/openapi/exporter/features.d.ts
+
+/**
+ * Exported feature structure for OpenAPI extensions.
+ */
+interface ExportedFeature {
+  key: string;
+  description?: string;
+  owners?: string[];
+  stability?: string;
+  operations?: {
+    key: string;
+    version: string;
+  }[];
+  events?: {
+    key: string;
+    version: string;
+  }[];
+  presentations?: {
+    key: string;
+    version: string;
+  }[];
+}
+/**
+ * Export features to OpenAPI extension format.
+ */
+declare function exportFeatures(registry: FeatureRegistry): ExportedFeature[];
+/**
+ * Generate TypeScript code for features registry.
+ */
+declare function generateFeaturesRegistry(registry: FeatureRegistry): GeneratedRegistryCode;
+//#endregion
+export { ExportedFeature, exportFeatures, generateFeaturesRegistry };
+//# sourceMappingURL=features.d.ts.map

package/dist/openapi/exporter/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","names":[],"sources":["../../../src/openapi/exporter/features.ts"],"sourcesContent":[],"mappings":";;;;;AAsBA;AAeA;;UA5BiB,eAAA;;;;;;;;;;;;;;;;;;;;;iBAaD,cAAA,WAAyB,kBAAkB;;;;iBAe3C,wBAAA,WACJ,kBACT"}

package/dist/openapi/exporter/features.js

@@ -0,0 +1,46 @@
+//#region src/openapi/exporter/features.ts
+/**
+* Export features to OpenAPI extension format.
+*/
+function exportFeatures(registry) {
+	return registry.list().map((feature) => ({
+		key: feature.meta.key,
+		description: feature.meta.description,
+		owners: feature.meta.owners,
+		stability: feature.meta.stability,
+		operations: feature.operations,
+		events: feature.events,
+		presentations: feature.presentations
+	}));
+}
+/**
+* Generate TypeScript code for features registry.
+*/
+function generateFeaturesRegistry(registry) {
+	const features = registry.list();
+	const imports = /* @__PURE__ */ new Set();
+	const registrations = [];
+	for (const feature of features) {
+		const featureVarName = feature.meta.key.replace(/-/g, "_");
+		imports.add(`import { ${featureVarName} } from './${feature.meta.key}';`);
+		registrations.push(`  .register(${featureVarName})`);
+	}
+	return {
+		code: `/**
+ * Auto-generated features registry.
+ * DO NOT EDIT - This file is generated by ContractSpec exporter.
+ */
+import { FeatureRegistry } from '@contractspec/lib.contracts';
+
+${Array.from(imports).join("\n")}
+
+export const featuresRegistry = new FeatureRegistry()
+${registrations.join("\n")};
+`,
+		fileName: "features-registry.ts"
+	};
+}
+
+//#endregion
+export { exportFeatures, generateFeaturesRegistry };
+//# sourceMappingURL=features.js.map

package/dist/openapi/exporter/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","names":[],"sources":["../../../src/openapi/exporter/features.ts"],"sourcesContent":["/**\n * Features exporter - exports FeatureModuleSpec to OpenAPI extensions.\n */\nimport type { FeatureRegistry } from '@contractspec/lib.contracts';\nimport type { GeneratedRegistryCode } from '../types';\n\n/**\n * Exported feature structure for OpenAPI extensions.\n */\nexport interface ExportedFeature {\n  key: string;\n  description?: string;\n  owners?: string[];\n  stability?: string;\n  operations?: { key: string; version: string }[];\n  events?: { key: string; version: string }[];\n  presentations?: { key: string; version: string }[];\n}\n\n/**\n * Export features to OpenAPI extension format.\n */\nexport function exportFeatures(registry: FeatureRegistry): ExportedFeature[] {\n  return registry.list().map((feature) => ({\n    key: feature.meta.key,\n    description: feature.meta.description,\n    owners: feature.meta.owners,\n    stability: feature.meta.stability,\n    operations: feature.operations,\n    events: feature.events,\n    presentations: feature.presentations,\n  }));\n}\n\n/**\n * Generate TypeScript code for features registry.\n */\nexport function generateFeaturesRegistry(\n  registry: FeatureRegistry\n): GeneratedRegistryCode {\n  const features = registry.list();\n  const imports = new Set<string>();\n  const registrations: string[] = [];\n\n  for (const feature of features) {\n    const featureVarName = feature.meta.key.replace(/-/g, '_');\n    imports.add(`import { ${featureVarName} } from './${feature.meta.key}';`);\n    registrations.push(`  .register(${featureVarName})`);\n  }\n\n  const code = `/**\n * Auto-generated features registry.\n * DO NOT EDIT - This file is generated by ContractSpec exporter.\n */\nimport { FeatureRegistry } from '@contractspec/lib.contracts';\n\n${Array.from(imports).join('\\n')}\n\nexport const featuresRegistry = new FeatureRegistry()\n${registrations.join('\\n')};\n`;\n\n  return {\n    code,\n    fileName: 'features-registry.ts',\n  };\n}\n"],"mappings":";;;;AAsBA,SAAgB,eAAe,UAA8C;AAC3E,QAAO,SAAS,MAAM,CAAC,KAAK,aAAa;EACvC,KAAK,QAAQ,KAAK;EAClB,aAAa,QAAQ,KAAK;EAC1B,QAAQ,QAAQ,KAAK;EACrB,WAAW,QAAQ,KAAK;EACxB,YAAY,QAAQ;EACpB,QAAQ,QAAQ;EAChB,eAAe,QAAQ;EACxB,EAAE;;;;;AAML,SAAgB,yBACd,UACuB;CACvB,MAAM,WAAW,SAAS,MAAM;CAChC,MAAM,0BAAU,IAAI,KAAa;CACjC,MAAM,gBAA0B,EAAE;AAElC,MAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,iBAAiB,QAAQ,KAAK,IAAI,QAAQ,MAAM,IAAI;AAC1D,UAAQ,IAAI,YAAY,eAAe,aAAa,QAAQ,KAAK,IAAI,IAAI;AACzE,gBAAc,KAAK,eAAe,eAAe,GAAG;;AAetD,QAAO;EACL,MAbW;;;;;;EAMb,MAAM,KAAK,QAAQ,CAAC,KAAK,KAAK,CAAC;;;EAG/B,cAAc,KAAK,KAAK,CAAC;;EAKvB,UAAU;EACX"}

package/dist/openapi/exporter/forms.d.ts

@@ -0,0 +1,30 @@
+import { GeneratedRegistryCode } from "../types.js";
+import { FormRegistry, Stability } from "@contractspec/lib.contracts";
+
+//#region src/openapi/exporter/forms.d.ts
+
+type OpenApiSchemaObject = Record<string, unknown>;
+/**
+ * Exported form structure for OpenAPI extensions.
+ */
+interface ExportedForm {
+  key: string;
+  version: string;
+  description: string;
+  stability: Stability;
+  owners?: string[];
+  fields: unknown[];
+  model: OpenApiSchemaObject | null;
+  actions?: unknown[];
+}
+/**
+ * Export forms to OpenAPI extension format.
+ */
+declare function exportForms(registry: FormRegistry): ExportedForm[];
+/**
+ * Generate TypeScript code for forms registry.
+ */
+declare function generateFormsRegistry(registry: FormRegistry): GeneratedRegistryCode;
+//#endregion
+export { ExportedForm, exportForms, generateFormsRegistry };
+//# sourceMappingURL=forms.d.ts.map

package/dist/openapi/exporter/forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.d.ts","names":[],"sources":["../../../src/openapi/exporter/forms.ts"],"sourcesContent":[],"mappings":";;;;;AAaA,KALK,mBAAA,GAAsB,MASd,CAAA,MAAA,EAGJ,OAAA,CAAA;AAOT;AAoBA;;UAlCiB,YAAA;;;;aAIJ;;;SAGJ;;;;;;iBAOO,WAAA,WAAsB,eAAe;;;;iBAoBrC,qBAAA,WACJ,eACT"}

package/dist/openapi/exporter/forms.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+
+//#region src/openapi/exporter/forms.ts
+/**
+* Export forms to OpenAPI extension format.
+*/
+function exportForms(registry) {
+	return registry.list().map((form) => ({
+		key: form.meta.key,
+		version: form.meta.version,
+		description: form.meta.description,
+		stability: form.meta.stability,
+		owners: form.meta.owners,
+		fields: form.fields,
+		model: form.model ? z.toJSONSchema(form.model.getZod()) : null,
+		actions: form.actions
+	}));
+}
+/**
+* Generate TypeScript code for forms registry.
+*/
+function generateFormsRegistry(registry) {
+	const forms = registry.list();
+	const imports = /* @__PURE__ */ new Set();
+	const registrations = [];
+	for (const form of forms) {
+		const formVarName = form.meta.key.replace(/-/g, "_") + `_v${form.meta.version}`;
+		imports.add(`import { ${formVarName} } from './${form.meta.key}';`);
+		registrations.push(`  .register(${formVarName})`);
+	}
+	return {
+		code: `/**
+ * Auto-generated forms registry.
+ * DO NOT EDIT - This file is generated by ContractSpec exporter.
+ */
+import { FormRegistry } from '@contractspec/lib.contracts';
+
+${Array.from(imports).join("\n")}
+
+export const formsRegistry = new FormRegistry()
+${registrations.join("\n")};
+`,
+		fileName: "forms-registry.ts"
+	};
+}
+
+//#endregion
+export { exportForms, generateFormsRegistry };
+//# sourceMappingURL=forms.js.map

package/dist/openapi/exporter/forms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.js","names":[],"sources":["../../../src/openapi/exporter/forms.ts"],"sourcesContent":["/**\n * Forms exporter - exports FormSpec to OpenAPI extensions.\n */\nimport type { FormRegistry, Stability } from '@contractspec/lib.contracts';\nimport type { AnySchemaModel } from '@contractspec/lib.schema';\nimport { z } from 'zod';\nimport type { GeneratedRegistryCode } from '../types';\n\ntype OpenApiSchemaObject = Record<string, unknown>;\n\n/**\n * Exported form structure for OpenAPI extensions.\n */\nexport interface ExportedForm {\n  key: string;\n  version: string;\n  description: string;\n  stability: Stability;\n  owners?: string[];\n  fields: unknown[];\n  model: OpenApiSchemaObject | null;\n  actions?: unknown[];\n}\n\n/**\n * Export forms to OpenAPI extension format.\n */\nexport function exportForms(registry: FormRegistry): ExportedForm[] {\n  return registry.list().map((form) => ({\n    key: form.meta.key,\n    version: form.meta.version,\n    description: form.meta.description,\n    stability: form.meta.stability,\n    owners: form.meta.owners,\n    fields: form.fields,\n    model: form.model\n      ? (z.toJSONSchema(\n          (form.model as AnySchemaModel).getZod()\n        ) as OpenApiSchemaObject)\n      : null,\n    actions: form.actions,\n  }));\n}\n\n/**\n * Generate TypeScript code for forms registry.\n */\nexport function generateFormsRegistry(\n  registry: FormRegistry\n): GeneratedRegistryCode {\n  const forms = registry.list();\n  const imports = new Set<string>();\n  const registrations: string[] = [];\n\n  for (const form of forms) {\n    const formVarName =\n      form.meta.key.replace(/-/g, '_') + `_v${form.meta.version}`;\n    imports.add(`import { ${formVarName} } from './${form.meta.key}';`);\n    registrations.push(`  .register(${formVarName})`);\n  }\n\n  const code = `/**\n * Auto-generated forms registry.\n * DO NOT EDIT - This file is generated by ContractSpec exporter.\n */\nimport { FormRegistry } from '@contractspec/lib.contracts';\n\n${Array.from(imports).join('\\n')}\n\nexport const formsRegistry = new FormRegistry()\n${registrations.join('\\n')};\n`;\n\n  return {\n    code,\n    fileName: 'forms-registry.ts',\n  };\n}\n"],"mappings":";;;;;;AA2BA,SAAgB,YAAY,UAAwC;AAClE,QAAO,SAAS,MAAM,CAAC,KAAK,UAAU;EACpC,KAAK,KAAK,KAAK;EACf,SAAS,KAAK,KAAK;EACnB,aAAa,KAAK,KAAK;EACvB,WAAW,KAAK,KAAK;EACrB,QAAQ,KAAK,KAAK;EAClB,QAAQ,KAAK;EACb,OAAO,KAAK,QACP,EAAE,aACA,KAAK,MAAyB,QAAQ,CACxC,GACD;EACJ,SAAS,KAAK;EACf,EAAE;;;;;AAML,SAAgB,sBACd,UACuB;CACvB,MAAM,QAAQ,SAAS,MAAM;CAC7B,MAAM,0BAAU,IAAI,KAAa;CACjC,MAAM,gBAA0B,EAAE;AAElC,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,cACJ,KAAK,KAAK,IAAI,QAAQ,MAAM,IAAI,GAAG,KAAK,KAAK,KAAK;AACpD,UAAQ,IAAI,YAAY,YAAY,aAAa,KAAK,KAAK,IAAI,IAAI;AACnE,gBAAc,KAAK,eAAe,YAAY,GAAG;;AAenD,QAAO;EACL,MAbW;;;;;;EAMb,MAAM,KAAK,QAAQ,CAAC,KAAK,KAAK,CAAC;;;EAG/B,cAAc,KAAK,KAAK,CAAC;;EAKvB,UAAU;EACX"}

package/dist/openapi/exporter/index.js

@@ -0,0 +1,8 @@
+import { defaultRestPath, exportOperations, generateOperationsRegistry, jsonSchemaForSpec, schemaModelToJsonSchema, toHttpMethod, toOperationId, toRestPath, toSchemaName } from "./operations.js";
+import { exportEvents, generateEventsExports } from "./events.js";
+import { exportFeatures, generateFeaturesRegistry } from "./features.js";
+import { exportPresentations, exportPresentationsFromArray, generatePresentationsRegistry } from "./presentations.js";
+import { exportForms, generateFormsRegistry } from "./forms.js";
+import { exportDataViews, generateDataViewsRegistry } from "./data-views.js";
+import { exportWorkflows, generateWorkflowsRegistry } from "./workflows.js";
+import { generateRegistryIndex } from "./registries.js";