@lssm/lib.contracts-transformers 0.0.0-canary-20251220041653 → 0.0.0-canary-20251221132705

package/dist/openapi/exporter.d.ts

@@ -1,28 +1,48 @@
-import { ContractSpecOpenApiDocument, OpenApiExportOptions, OpenApiServer } from "./types.js";
-import { SpecRegistry } from "@lssm/lib.contracts";
+import { ContractSpecExportOptions, ContractSpecExportResult, ContractSpecOpenApiDocument, OpenApiExportOptions, OpenApiServer } from "./types.js";
+import { defaultRestPath } from "./exporter/operations.js";
+import { DataViewRegistry, EventSpec, FeatureRegistry, FormRegistry, OperationSpecRegistry, PresentationDescriptorV2, PresentationRegistry, WorkflowRegistry } from "@lssm/lib.contracts";
+import { AnySchemaModel } from "@lssm/lib.schema";
 
 //#region src/openapi/exporter.d.ts
 
 /**
- * Generate default REST path from spec name and version.
+ * Input registries for unified export.
  */
-declare function defaultRestPath(name: string, version: number): string;
+interface ContractSpecRegistries {
+  operations?: OperationSpecRegistry;
+  events?: EventSpec<AnySchemaModel>[];
+  features?: FeatureRegistry;
+  presentations?: PresentationRegistry;
+  presentationsV2?: PresentationDescriptorV2[];
+  forms?: FormRegistry;
+  dataViews?: DataViewRegistry;
+  workflows?: WorkflowRegistry;
+}
 /**
- * Export a SpecRegistry to an OpenAPI 3.1 document.
- *
- * @param registry - The SpecRegistry containing specs to export
- * @param options - Export options (title, version, description, servers)
- * @returns OpenAPI 3.1 document
+ * Export a OperationSpecRegistry to an OpenAPI 3.1 document.
+ * @deprecated Use exportContractSpec for full surface support.
  */
-declare function openApiForRegistry(registry: SpecRegistry, options?: OpenApiExportOptions): ContractSpecOpenApiDocument;
+declare function openApiForRegistry(registry: OperationSpecRegistry, options?: OpenApiExportOptions): ContractSpecOpenApiDocument;
 /**
- * Export a SpecRegistry to OpenAPI JSON string.
+ * Export all ContractSpec surfaces to OpenAPI document with extensions.
  */
-declare function openApiToJson(registry: SpecRegistry, options?: OpenApiExportOptions): string;
+declare function exportContractSpec(registries: ContractSpecRegistries, options?: ContractSpecExportOptions): ContractSpecExportResult;
 /**
- * Export a SpecRegistry to OpenAPI YAML string.
+ * Export a OperationSpecRegistry to OpenAPI JSON string.
  */
-declare function openApiToYaml(registry: SpecRegistry, options?: OpenApiExportOptions): string;
+declare function openApiToJson(registry: OperationSpecRegistry, options?: OpenApiExportOptions): string;
+/**
+ * Export a OperationSpecRegistry to OpenAPI YAML string.
+ */
+declare function openApiToYaml(registry: OperationSpecRegistry, options?: OpenApiExportOptions): string;
+/**
+ * Export ContractSpec to JSON string (all surfaces).
+ */
+declare function contractSpecToJson(registries: ContractSpecRegistries, options?: ContractSpecExportOptions): string;
+/**
+ * Export ContractSpec to YAML string (all surfaces).
+ */
+declare function contractSpecToYaml(registries: ContractSpecRegistries, options?: ContractSpecExportOptions): string;
 //#endregion
-export { defaultRestPath, openApiForRegistry, openApiToJson, openApiToYaml };
+export { ContractSpecRegistries, contractSpecToJson, contractSpecToYaml, exportContractSpec, openApiForRegistry, openApiToJson, openApiToYaml };
 //# sourceMappingURL=exporter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"exporter.d.ts","names":[],"sources":["../../src/openapi/exporter.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAqH8B,iBAjEd,eAAA,CAiEc,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AA+F9B;AAWA;;;;;;iBA7GgB,kBAAA,WACJ,wBACD,uBACR;;;;iBA+Fa,aAAA,WACJ,wBACD;;;;iBASK,aAAA,WACJ,wBACD"}
+{"version":3,"file":"exporter.d.ts","names":[],"sources":["../../src/openapi/exporter.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAmDkB,UAJD,sBAAA,CAIC;EACE,UAAA,CAAA,EAJL,qBAIK;EACV,MAAA,CAAA,EAJC,SAID,CAJW,cAIX,CAAA,EAAA;EACI,QAAA,CAAA,EAJD,eAIC;EACA,aAAA,CAAA,EAJI,oBAIJ;EAAgB,eAAA,CAAA,EAHV,wBAGU,EAAA;EAUd,KAAA,CAAA,EAZN,YAYM;EACJ,SAAA,CAAA,EAZE,gBAYF;EACD,SAAA,CAAA,EAZG,gBAYH;;AAoBX;;;;AAG2B,iBAzBX,kBAAA,CAyBW,QAAA,EAxBf,qBAwBe,EAAA,OAAA,CAAA,EAvBhB,oBAuBgB,CAAA,EAtBxB,2BAsBwB;AAiI3B;AAWA;AAWA;AAWgB,iBArKA,kBAAA,CAsKF,UAAA,EArKA,sBAsKH,EAAA,OAA8B,CAAA,EArK9B,yBAqK8B,CAAA,EApKtC,wBAoKsC;;;;iBAnCzB,aAAA,WACJ,iCACD;;;;iBASK,aAAA,WACJ,iCACD;;;;iBASK,kBAAA,aACF,kCACH;;;;iBASK,kBAAA,aACF,kCACH"}

package/dist/openapi/exporter.js

@@ -1,73 +1,43 @@
-import { z } from "zod";
+import { defaultRestPath, exportOperations, generateOperationsRegistry } from "./exporter/operations.js";
+import { exportEvents, generateEventsExports } from "./exporter/events.js";
+import { exportFeatures, generateFeaturesRegistry } from "./exporter/features.js";
+import { exportPresentations, generatePresentationsRegistry } from "./exporter/presentations.js";
+import { exportForms, generateFormsRegistry } from "./exporter/forms.js";
+import { exportDataViews, generateDataViewsRegistry } from "./exporter/data-views.js";
+import { exportWorkflows, generateWorkflowsRegistry } from "./exporter/workflows.js";
+import { generateRegistryIndex } from "./exporter/registries.js";
 
 //#region src/openapi/exporter.ts
 /**
-* Convert a spec name and version to an operationId.
+* Export a OperationSpecRegistry to an OpenAPI 3.1 document.
+* @deprecated Use exportContractSpec for full surface support.
 */
-function toOperationId(name, version) {
-	return `${name.replace(/\./g, "_")}_v${version}`;
-}
-/**
-* Convert a spec name and version to a schema name.
-*/
-function toSchemaName(prefix, name, version) {
-	return `${prefix}_${toOperationId(name, version)}`;
-}
-/**
-* Determine HTTP method from spec kind and override.
-*/
-function toHttpMethod(kind, override) {
-	return (override ?? (kind === "query" ? "GET" : "POST")).toLowerCase();
-}
-/**
-* Generate default REST path from spec name and version.
-*/
-function defaultRestPath(name, version) {
-	return `/${name.replace(/\./g, "/")}/v${version}`;
-}
-/**
-* Get REST path from spec, using transport override or default.
-*/
-function toRestPath(spec) {
-	const path = spec.transport?.rest?.path ?? defaultRestPath(spec.meta.name, spec.meta.version);
-	return path.startsWith("/") ? path : `/${path}`;
-}
-/**
-* Convert a SchemaModel to JSON Schema using Zod.
-*/
-function schemaModelToJsonSchema(schema) {
-	if (!schema) return null;
-	return z.toJSONSchema(schema.getZod());
-}
-/**
-* Extract JSON Schema for a spec's input and output.
-*/
-function jsonSchemaForSpec(spec) {
+function openApiForRegistry(registry, options = {}) {
+	const { paths, schemas } = exportOperations(registry);
 	return {
-		input: schemaModelToJsonSchema(spec.io.input),
-		output: schemaModelToJsonSchema(spec.io.output),
-		meta: {
-			name: spec.meta.name,
-			version: spec.meta.version,
-			kind: spec.meta.kind,
-			description: spec.meta.description,
-			tags: spec.meta.tags ?? [],
-			stability: spec.meta.stability ?? "stable"
-		}
+		openapi: "3.1.0",
+		info: {
+			title: options.title ?? "ContractSpec API",
+			version: options.version ?? "0.0.0",
+			...options.description ? { description: options.description } : {}
+		},
+		...options.servers ? { servers: options.servers } : {},
+		paths,
+		components: { schemas }
 	};
 }
 /**
-* Export a SpecRegistry to an OpenAPI 3.1 document.
-*
-* @param registry - The SpecRegistry containing specs to export
-* @param options - Export options (title, version, description, servers)
-* @returns OpenAPI 3.1 document
+* Export all ContractSpec surfaces to OpenAPI document with extensions.
 */
-function openApiForRegistry(registry, options = {}) {
-	const specs = registry.listSpecs().filter((s) => s.meta.kind === "command" || s.meta.kind === "query").slice().sort((a, b) => {
-		const byName = a.meta.name.localeCompare(b.meta.name);
-		return byName !== 0 ? byName : a.meta.version - b.meta.version;
-	});
+function exportContractSpec(registries, options = {}) {
+	const { operations: includeOps = true, events: includeEvents = true, features: includeFeatures = true, presentations: includePresentations = true, forms: includeForms = true, dataViews: includeDataViews = true, workflows: includeWorkflows = true, generateRegistries = true } = options;
+	let paths = {};
+	let schemas = {};
+	if (includeOps && registries.operations) {
+		const opResult = exportOperations(registries.operations);
+		paths = opResult.paths;
+		schemas = opResult.schemas;
+	}
 	const doc = {
 		openapi: "3.1.0",
 		info: {
@@ -76,63 +46,67 @@ function openApiForRegistry(registry, options = {}) {
 			...options.description ? { description: options.description } : {}
 		},
 		...options.servers ? { servers: options.servers } : {},
-		paths: {},
-		components: { schemas: {} }
+		paths,
+		components: { schemas }
 	};
-	for (const spec of specs) {
-		const schema = jsonSchemaForSpec(spec);
-		const method = toHttpMethod(spec.meta.kind, spec.transport?.rest?.method);
-		const path = toRestPath(spec);
-		const operationId = toOperationId(spec.meta.name, spec.meta.version);
-		const pathItem = doc.paths[path] ??= {};
-		const op = {
-			operationId,
-			summary: spec.meta.description ?? spec.meta.name,
-			description: spec.meta.description,
-			tags: spec.meta.tags ?? [],
-			"x-contractspec": {
-				name: spec.meta.name,
-				version: spec.meta.version,
-				kind: spec.meta.kind
-			},
-			responses: {}
-		};
-		if (schema.input) {
-			const inputName = toSchemaName("Input", spec.meta.name, spec.meta.version);
-			doc.components.schemas[inputName] = schema.input;
-			op["requestBody"] = {
-				required: true,
-				content: { "application/json": { schema: { $ref: `#/components/schemas/${inputName}` } } }
-			};
-		}
-		const responses = {};
-		if (schema.output) {
-			const outputName = toSchemaName("Output", spec.meta.name, spec.meta.version);
-			doc.components.schemas[outputName] = schema.output;
-			responses["200"] = {
-				description: "OK",
-				content: { "application/json": { schema: { $ref: `#/components/schemas/${outputName}` } } }
-			};
-		} else responses["200"] = { description: "OK" };
-		op["responses"] = responses;
-		pathItem[method] = op;
+	if (includeEvents && registries.events?.length) doc["x-contractspec-events"] = exportEvents(registries.events);
+	if (includeFeatures && registries.features) doc["x-contractspec-features"] = exportFeatures(registries.features);
+	if (includePresentations && registries.presentations) {
+		const presExport = exportPresentations(registries.presentations, registries.presentationsV2);
+		doc["x-contractspec-presentations"] = [...presExport.v1, ...presExport.v2];
+	}
+	if (includeForms && registries.forms) doc["x-contractspec-forms"] = exportForms(registries.forms);
+	if (includeDataViews && registries.dataViews) doc["x-contractspec-dataviews"] = exportDataViews(registries.dataViews);
+	if (includeWorkflows && registries.workflows) doc["x-contractspec-workflows"] = exportWorkflows(registries.workflows);
+	const result = { openApi: doc };
+	if (generateRegistries) {
+		result.registries = {};
+		if (includeOps && registries.operations) result.registries.operations = generateOperationsRegistry(registries.operations);
+		if (includeEvents && registries.events?.length) result.registries.events = generateEventsExports(registries.events);
+		if (includeFeatures && registries.features) result.registries.features = generateFeaturesRegistry(registries.features);
+		if (includePresentations && registries.presentations) result.registries.presentations = generatePresentationsRegistry(registries.presentations);
+		if (includeForms && registries.forms) result.registries.forms = generateFormsRegistry(registries.forms);
+		if (includeDataViews && registries.dataViews) result.registries.dataViews = generateDataViewsRegistry(registries.dataViews);
+		if (includeWorkflows && registries.workflows) result.registries.workflows = generateWorkflowsRegistry(registries.workflows);
+		result.registries.index = generateRegistryIndex({
+			operations: includeOps && !!registries.operations,
+			events: includeEvents && !!registries.events?.length,
+			features: includeFeatures && !!registries.features,
+			presentations: includePresentations && !!registries.presentations,
+			forms: includeForms && !!registries.forms,
+			dataViews: includeDataViews && !!registries.dataViews,
+			workflows: includeWorkflows && !!registries.workflows
+		});
 	}
-	return doc;
+	return result;
 }
 /**
-* Export a SpecRegistry to OpenAPI JSON string.
+* Export a OperationSpecRegistry to OpenAPI JSON string.
 */
 function openApiToJson(registry, options = {}) {
 	const doc = openApiForRegistry(registry, options);
 	return JSON.stringify(doc, null, 2);
 }
 /**
-* Export a SpecRegistry to OpenAPI YAML string.
+* Export a OperationSpecRegistry to OpenAPI YAML string.
 */
 function openApiToYaml(registry, options = {}) {
 	return jsonToYaml(openApiForRegistry(registry, options));
 }
 /**
+* Export ContractSpec to JSON string (all surfaces).
+*/
+function contractSpecToJson(registries, options = {}) {
+	const result = exportContractSpec(registries, options);
+	return JSON.stringify(result.openApi, null, 2);
+}
+/**
+* Export ContractSpec to YAML string (all surfaces).
+*/
+function contractSpecToYaml(registries, options = {}) {
+	return jsonToYaml(exportContractSpec(registries, options).openApi);
+}
+/**
 * Simple JSON to YAML conversion.
 */
 function jsonToYaml(obj, indent = 0) {
@@ -147,5 +121,5 @@ function jsonToYaml(obj, indent = 0) {
 }
 
 //#endregion
-export { defaultRestPath, openApiForRegistry, openApiToJson, openApiToYaml };
+export { contractSpecToJson, contractSpecToYaml, exportContractSpec, openApiForRegistry, openApiToJson, openApiToYaml };
 //# sourceMappingURL=exporter.js.map

package/dist/openapi/exporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"exporter.js","names":["doc: ContractSpecOpenApiDocument","op: Record<string, unknown>","responses: Record<string, unknown>"],"sources":["../../src/openapi/exporter.ts"],"sourcesContent":["/**\n * Export ContractSpec specs to OpenAPI 3.1 format.\n * Moved from @lssm/lib.contracts/openapi.ts with enhancements.\n */\n\nimport type {\n  SpecRegistry,\n  AnyContractSpec,\n  ContractSpec,\n} from '@lssm/lib.contracts';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport { z } from 'zod';\nimport type {\n  OpenApiExportOptions,\n  OpenApiServer,\n  ContractSpecOpenApiDocument,\n} from './types';\n\ntype OpenApiSchemaObject = Record<string, unknown>;\n\n/**\n * Convert a spec name and version to an operationId.\n */\nfunction toOperationId(name: string, version: number): string {\n  return `${name.replace(/\\./g, '_')}_v${version}`;\n}\n\n/**\n * Convert a spec name and version to a schema name.\n */\nfunction toSchemaName(\n  prefix: 'Input' | 'Output',\n  name: string,\n  version: number\n): string {\n  return `${prefix}_${toOperationId(name, version)}`;\n}\n\n/**\n * Determine HTTP method from spec kind and override.\n */\nfunction toHttpMethod(\n  kind: 'command' | 'query',\n  override?: 'GET' | 'POST'\n): string {\n  const method = override ?? (kind === 'query' ? 'GET' : 'POST');\n  return method.toLowerCase();\n}\n\n/**\n * Generate default REST path from spec name and version.\n */\nexport function defaultRestPath(name: string, version: number): string {\n  return `/${name.replace(/\\./g, '/')}/v${version}`;\n}\n\n/**\n * Get REST path from spec, using transport override or default.\n */\nfunction toRestPath(spec: AnyContractSpec): string {\n  const path =\n    spec.transport?.rest?.path ??\n    defaultRestPath(spec.meta.name, spec.meta.version);\n  return path.startsWith('/') ? path : `/${path}`;\n}\n\n/**\n * Convert a SchemaModel to JSON Schema using Zod.\n */\nfunction schemaModelToJsonSchema(\n  schema: AnySchemaModel | null\n): OpenApiSchemaObject | null {\n  if (!schema) return null;\n  return z.toJSONSchema(schema.getZod()) as OpenApiSchemaObject;\n}\n\n/**\n * Extract JSON Schema for a spec's input and output.\n */\nfunction jsonSchemaForSpec(\n  spec: ContractSpec<AnySchemaModel, AnySchemaModel>\n): {\n  input: OpenApiSchemaObject | null;\n  output: OpenApiSchemaObject | null;\n  meta: {\n    name: string;\n    version: number;\n    kind: 'command' | 'query';\n    description: string;\n    tags: string[];\n    stability: string;\n  };\n} {\n  return {\n    input: schemaModelToJsonSchema(spec.io.input),\n    output: schemaModelToJsonSchema(spec.io.output as AnySchemaModel | null),\n    meta: {\n      name: spec.meta.name,\n      version: spec.meta.version,\n      kind: spec.meta.kind,\n      description: spec.meta.description,\n      tags: spec.meta.tags ?? [],\n      stability: spec.meta.stability ?? 'stable',\n    },\n  };\n}\n\n/**\n * Export a SpecRegistry to an OpenAPI 3.1 document.\n *\n * @param registry - The SpecRegistry containing specs to export\n * @param options - Export options (title, version, description, servers)\n * @returns OpenAPI 3.1 document\n */\nexport function openApiForRegistry(\n  registry: SpecRegistry,\n  options: OpenApiExportOptions = {}\n): ContractSpecOpenApiDocument {\n  const specs = registry\n    .listSpecs()\n    .filter(\n      (s): s is AnyContractSpec =>\n        s.meta.kind === 'command' || s.meta.kind === 'query'\n    )\n    .slice()\n    .sort((a, b) => {\n      const byName = a.meta.name.localeCompare(b.meta.name);\n      return byName !== 0 ? byName : a.meta.version - b.meta.version;\n    });\n\n  const doc: ContractSpecOpenApiDocument = {\n    openapi: '3.1.0',\n    info: {\n      title: options.title ?? 'ContractSpec API',\n      version: options.version ?? '0.0.0',\n      ...(options.description ? { description: options.description } : {}),\n    },\n    ...(options.servers ? { servers: options.servers } : {}),\n    paths: {},\n    components: { schemas: {} },\n  };\n\n  for (const spec of specs) {\n    const schema = jsonSchemaForSpec(\n      spec as unknown as ContractSpec<AnySchemaModel, AnySchemaModel>\n    );\n    const method = toHttpMethod(spec.meta.kind, spec.transport?.rest?.method);\n    const path = toRestPath(spec);\n\n    const operationId = toOperationId(spec.meta.name, spec.meta.version);\n\n    const pathItem = (doc.paths[path] ??= {});\n    const op: Record<string, unknown> = {\n      operationId,\n      summary: spec.meta.description ?? spec.meta.name,\n      description: spec.meta.description,\n      tags: spec.meta.tags ?? [],\n      'x-contractspec': {\n        name: spec.meta.name,\n        version: spec.meta.version,\n        kind: spec.meta.kind,\n      },\n      responses: {},\n    };\n\n    if (schema.input) {\n      const inputName = toSchemaName(\n        'Input',\n        spec.meta.name,\n        spec.meta.version\n      );\n      doc.components.schemas[inputName] = schema.input;\n      op['requestBody'] = {\n        required: true,\n        content: {\n          'application/json': {\n            schema: { $ref: `#/components/schemas/${inputName}` },\n          },\n        },\n      };\n    }\n\n    const responses: Record<string, unknown> = {};\n    if (schema.output) {\n      const outputName = toSchemaName(\n        'Output',\n        spec.meta.name,\n        spec.meta.version\n      );\n      doc.components.schemas[outputName] = schema.output;\n      responses['200'] = {\n        description: 'OK',\n        content: {\n          'application/json': {\n            schema: { $ref: `#/components/schemas/${outputName}` },\n          },\n        },\n      };\n    } else {\n      responses['200'] = { description: 'OK' };\n    }\n    op['responses'] = responses;\n\n    pathItem[method] = op;\n  }\n\n  return doc;\n}\n\n/**\n * Export a SpecRegistry to OpenAPI JSON string.\n */\nexport function openApiToJson(\n  registry: SpecRegistry,\n  options: OpenApiExportOptions = {}\n): string {\n  const doc = openApiForRegistry(registry, options);\n  return JSON.stringify(doc, null, 2);\n}\n\n/**\n * Export a SpecRegistry to OpenAPI YAML string.\n */\nexport function openApiToYaml(\n  registry: SpecRegistry,\n  options: OpenApiExportOptions = {}\n): string {\n  const doc = openApiForRegistry(registry, options);\n  return jsonToYaml(doc);\n}\n\n/**\n * Simple JSON to YAML conversion.\n */\nfunction jsonToYaml(obj: unknown, indent = 0): string {\n  const spaces = '  '.repeat(indent);\n  let yaml = '';\n\n  if (Array.isArray(obj)) {\n    for (const item of obj) {\n      if (typeof item === 'object' && item !== null) {\n        yaml += `${spaces}-\\n${jsonToYaml(item, indent + 1)}`;\n      } else {\n        yaml += `${spaces}- ${JSON.stringify(item)}\\n`;\n      }\n    }\n  } else if (typeof obj === 'object' && obj !== null) {\n    for (const [key, value] of Object.entries(obj)) {\n      if (Array.isArray(value)) {\n        yaml += `${spaces}${key}:\\n${jsonToYaml(value, indent + 1)}`;\n      } else if (typeof value === 'object' && value !== null) {\n        yaml += `${spaces}${key}:\\n${jsonToYaml(value, indent + 1)}`;\n      } else {\n        yaml += `${spaces}${key}: ${JSON.stringify(value)}\\n`;\n      }\n    }\n  }\n\n  return yaml;\n}\n\n// Re-export types for convenience\nexport type {\n  OpenApiExportOptions,\n  OpenApiServer,\n  ContractSpecOpenApiDocument,\n};\n"],"mappings":"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"}
+{"version":3,"file":"exporter.js","names":["paths: Record<string, Record<string, unknown>>","schemas: Record<string, Record<string, unknown>>","doc: ContractSpecOpenApiDocument","result: ContractSpecExportResult"],"sources":["../../src/openapi/exporter.ts"],"sourcesContent":["/**\n * Export ContractSpec specs to OpenAPI 3.1 format.\n * Refactored to use modular exporters for all surfaces.\n */\nimport type {\n  OperationSpecRegistry,\n  FeatureRegistry,\n  PresentationRegistry,\n  FormRegistry,\n  DataViewRegistry,\n  WorkflowRegistry,\n  EventSpec,\n  PresentationDescriptorV2,\n} from '@lssm/lib.contracts';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport type {\n  ContractSpecOpenApiDocument,\n  OpenApiExportOptions,\n  OpenApiServer,\n  ContractSpecExportOptions,\n  ContractSpecExportResult,\n} from './types';\nimport {\n  exportOperations,\n  generateOperationsRegistry,\n  defaultRestPath as defaultRestPathFn,\n} from './exporter/operations';\nimport { exportEvents, generateEventsExports } from './exporter/events';\nimport { exportFeatures, generateFeaturesRegistry } from './exporter/features';\nimport {\n  exportPresentations,\n  generatePresentationsRegistry,\n} from './exporter/presentations';\nimport { exportForms, generateFormsRegistry } from './exporter/forms';\nimport {\n  exportDataViews,\n  generateDataViewsRegistry,\n} from './exporter/data-views';\nimport {\n  exportWorkflows,\n  generateWorkflowsRegistry,\n} from './exporter/workflows';\nimport { generateRegistryIndex } from './exporter/registries';\n\n/**\n * Input registries for unified export.\n */\nexport interface ContractSpecRegistries {\n  operations?: OperationSpecRegistry;\n  events?: EventSpec<AnySchemaModel>[];\n  features?: FeatureRegistry;\n  presentations?: PresentationRegistry;\n  presentationsV2?: PresentationDescriptorV2[];\n  forms?: FormRegistry;\n  dataViews?: DataViewRegistry;\n  workflows?: WorkflowRegistry;\n}\n\n// Re-export for backwards compatibility\nexport { defaultRestPathFn as defaultRestPath };\n\n/**\n * Export a OperationSpecRegistry to an OpenAPI 3.1 document.\n * @deprecated Use exportContractSpec for full surface support.\n */\nexport function openApiForRegistry(\n  registry: OperationSpecRegistry,\n  options: OpenApiExportOptions = {}\n): ContractSpecOpenApiDocument {\n  const { paths, schemas } = exportOperations(registry);\n\n  return {\n    openapi: '3.1.0',\n    info: {\n      title: options.title ?? 'ContractSpec API',\n      version: options.version ?? '0.0.0',\n      ...(options.description ? { description: options.description } : {}),\n    },\n    ...(options.servers ? { servers: options.servers } : {}),\n    paths,\n    components: { schemas },\n  };\n}\n\n/**\n * Export all ContractSpec surfaces to OpenAPI document with extensions.\n */\nexport function exportContractSpec(\n  registries: ContractSpecRegistries,\n  options: ContractSpecExportOptions = {}\n): ContractSpecExportResult {\n  const {\n    operations: includeOps = true,\n    events: includeEvents = true,\n    features: includeFeatures = true,\n    presentations: includePresentations = true,\n    forms: includeForms = true,\n    dataViews: includeDataViews = true,\n    workflows: includeWorkflows = true,\n    generateRegistries = true,\n  } = options;\n\n  // Build OpenAPI document\n  let paths: Record<string, Record<string, unknown>> = {};\n  let schemas: Record<string, Record<string, unknown>> = {};\n\n  // Export operations\n  if (includeOps && registries.operations) {\n    const opResult = exportOperations(registries.operations);\n    paths = opResult.paths;\n    schemas = opResult.schemas;\n  }\n\n  const doc: ContractSpecOpenApiDocument = {\n    openapi: '3.1.0',\n    info: {\n      title: options.title ?? 'ContractSpec API',\n      version: options.version ?? '0.0.0',\n      ...(options.description ? { description: options.description } : {}),\n    },\n    ...(options.servers ? { servers: options.servers } : {}),\n    paths,\n    components: { schemas },\n  };\n\n  // Add extensions for other surfaces\n  if (includeEvents && registries.events?.length) {\n    doc['x-contractspec-events'] = exportEvents(registries.events);\n  }\n\n  if (includeFeatures && registries.features) {\n    doc['x-contractspec-features'] = exportFeatures(registries.features);\n  }\n\n  if (includePresentations && registries.presentations) {\n    const presExport = exportPresentations(\n      registries.presentations,\n      registries.presentationsV2\n    );\n    doc['x-contractspec-presentations'] = [\n      ...presExport.v1,\n      ...presExport.v2,\n    ];\n  }\n\n  if (includeForms && registries.forms) {\n    doc['x-contractspec-forms'] = exportForms(registries.forms);\n  }\n\n  if (includeDataViews && registries.dataViews) {\n    doc['x-contractspec-dataviews'] = exportDataViews(registries.dataViews);\n  }\n\n  if (includeWorkflows && registries.workflows) {\n    doc['x-contractspec-workflows'] = exportWorkflows(registries.workflows);\n  }\n\n  const result: ContractSpecExportResult = {\n    openApi: doc,\n  };\n\n  // Generate registry code if requested\n  if (generateRegistries) {\n    result.registries = {};\n\n    if (includeOps && registries.operations) {\n      result.registries.operations = generateOperationsRegistry(\n        registries.operations\n      );\n    }\n\n    if (includeEvents && registries.events?.length) {\n      result.registries.events = generateEventsExports(registries.events);\n    }\n\n    if (includeFeatures && registries.features) {\n      result.registries.features = generateFeaturesRegistry(registries.features);\n    }\n\n    if (includePresentations && registries.presentations) {\n      result.registries.presentations = generatePresentationsRegistry(\n        registries.presentations\n      );\n    }\n\n    if (includeForms && registries.forms) {\n      result.registries.forms = generateFormsRegistry(registries.forms);\n    }\n\n    if (includeDataViews && registries.dataViews) {\n      result.registries.dataViews = generateDataViewsRegistry(\n        registries.dataViews\n      );\n    }\n\n    if (includeWorkflows && registries.workflows) {\n      result.registries.workflows = generateWorkflowsRegistry(\n        registries.workflows\n      );\n    }\n\n    // Generate index file\n    result.registries.index = generateRegistryIndex({\n      operations: includeOps && !!registries.operations,\n      events: includeEvents && !!registries.events?.length,\n      features: includeFeatures && !!registries.features,\n      presentations: includePresentations && !!registries.presentations,\n      forms: includeForms && !!registries.forms,\n      dataViews: includeDataViews && !!registries.dataViews,\n      workflows: includeWorkflows && !!registries.workflows,\n    });\n  }\n\n  return result;\n}\n\n/**\n * Export a OperationSpecRegistry to OpenAPI JSON string.\n */\nexport function openApiToJson(\n  registry: OperationSpecRegistry,\n  options: OpenApiExportOptions = {}\n): string {\n  const doc = openApiForRegistry(registry, options);\n  return JSON.stringify(doc, null, 2);\n}\n\n/**\n * Export a OperationSpecRegistry to OpenAPI YAML string.\n */\nexport function openApiToYaml(\n  registry: OperationSpecRegistry,\n  options: OpenApiExportOptions = {}\n): string {\n  const doc = openApiForRegistry(registry, options);\n  return jsonToYaml(doc);\n}\n\n/**\n * Export ContractSpec to JSON string (all surfaces).\n */\nexport function contractSpecToJson(\n  registries: ContractSpecRegistries,\n  options: ContractSpecExportOptions = {}\n): string {\n  const result = exportContractSpec(registries, options);\n  return JSON.stringify(result.openApi, null, 2);\n}\n\n/**\n * Export ContractSpec to YAML string (all surfaces).\n */\nexport function contractSpecToYaml(\n  registries: ContractSpecRegistries,\n  options: ContractSpecExportOptions = {}\n): string {\n  const result = exportContractSpec(registries, options);\n  return jsonToYaml(result.openApi);\n}\n\n/**\n * Simple JSON to YAML conversion.\n */\nfunction jsonToYaml(obj: unknown, indent = 0): string {\n  const spaces = '  '.repeat(indent);\n  let yaml = '';\n\n  if (Array.isArray(obj)) {\n    for (const item of obj) {\n      if (typeof item === 'object' && item !== null) {\n        yaml += `${spaces}-\\n${jsonToYaml(item, indent + 1)}`;\n      } else {\n        yaml += `${spaces}- ${JSON.stringify(item)}\\n`;\n      }\n    }\n  } else if (typeof obj === 'object' && obj !== null) {\n    for (const [key, value] of Object.entries(obj)) {\n      if (Array.isArray(value)) {\n        yaml += `${spaces}${key}:\\n${jsonToYaml(value, indent + 1)}`;\n      } else if (typeof value === 'object' && value !== null) {\n        yaml += `${spaces}${key}:\\n${jsonToYaml(value, indent + 1)}`;\n      } else {\n        yaml += `${spaces}${key}: ${JSON.stringify(value)}\\n`;\n      }\n    }\n  }\n\n  return yaml;\n}\n\n// Re-export types for convenience\nexport type {\n  OpenApiExportOptions,\n  OpenApiServer,\n  ContractSpecOpenApiDocument,\n  ContractSpecExportOptions,\n  ContractSpecExportResult,\n};\n"],"mappings":"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"}

package/dist/openapi/importer/analyzer.js

@@ -0,0 +1,28 @@
+//#region src/openapi/importer/analyzer.ts
+/**
+* HTTP methods that typically indicate a command (state-changing).
+*/
+const COMMAND_METHODS = [
+	"post",
+	"put",
+	"delete",
+	"patch"
+];
+/**
+* Determine if an operation is a command or query based on HTTP method.
+*/
+function inferOpKind(method) {
+	return COMMAND_METHODS.includes(method.toLowerCase()) ? "command" : "query";
+}
+/**
+* Determine auth level based on security requirements.
+*/
+function inferAuthLevel(operation, defaultAuth) {
+	if (!operation.security || operation.security.length === 0) return defaultAuth;
+	for (const sec of operation.security) if (Object.keys(sec).length === 0) return "anonymous";
+	return "user";
+}
+
+//#endregion
+export { COMMAND_METHODS, inferAuthLevel, inferOpKind };
+//# sourceMappingURL=analyzer.js.map

package/dist/openapi/importer/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","names":[],"sources":["../../../src/openapi/importer/analyzer.ts"],"sourcesContent":["import type { ParsedOperation } from '../types';\n\n/**\n * HTTP methods that typically indicate a command (state-changing).\n */\nexport const COMMAND_METHODS = ['post', 'put', 'delete', 'patch'];\n\n/**\n * Determine if an operation is a command or query based on HTTP method.\n */\nexport function inferOpKind(method: string): 'command' | 'query' {\n  return COMMAND_METHODS.includes(method.toLowerCase()) ? 'command' : 'query';\n}\n\n/**\n * Determine auth level based on security requirements.\n */\nexport function inferAuthLevel(\n  operation: ParsedOperation,\n  defaultAuth: 'anonymous' | 'user' | 'admin'\n): 'anonymous' | 'user' | 'admin' {\n  if (!operation.security || operation.security.length === 0) {\n    // Check if any security scheme is present\n    return defaultAuth;\n  }\n\n  // If there's an empty security requirement, it's anonymous\n  for (const sec of operation.security) {\n    if (Object.keys(sec).length === 0) {\n      return 'anonymous';\n    }\n  }\n\n  return 'user';\n}\n"],"mappings":";;;;AAKA,MAAa,kBAAkB;CAAC;CAAQ;CAAO;CAAU;CAAQ;;;;AAKjE,SAAgB,YAAY,QAAqC;AAC/D,QAAO,gBAAgB,SAAS,OAAO,aAAa,CAAC,GAAG,YAAY;;;;;AAMtE,SAAgB,eACd,WACA,aACgC;AAChC,KAAI,CAAC,UAAU,YAAY,UAAU,SAAS,WAAW,EAEvD,QAAO;AAIT,MAAK,MAAM,OAAO,UAAU,SAC1B,KAAI,OAAO,KAAK,IAAI,CAAC,WAAW,EAC9B,QAAO;AAIX,QAAO"}

package/dist/openapi/importer/events.js

@@ -0,0 +1,36 @@
+import { toPascalCase, toValidIdentifier } from "../../common/utils.js";
+import { generateImports, generateSchemaModelCode } from "../schema-converter.js";
+
+//#region src/openapi/importer/events.ts
+/**
+* Generate code for an event.
+*/
+function generateEventCode(event, options) {
+	const eventName = toValidIdentifier(event.name);
+	const modelName = toPascalCase(eventName) + "Payload";
+	const payloadModel = generateSchemaModelCode(event.payload, modelName);
+	const imports = /* @__PURE__ */ new Set();
+	imports.add("import { defineEvent, type EventSpec } from '@lssm/lib.contracts';");
+	generateImports(payloadModel.fields, options).split("\n").filter(Boolean).forEach((i) => imports.add(i));
+	if (payloadModel.name !== modelName) {
+		const modelsDir = `../${options.conventions.models}`;
+		const kebabName = payloadModel.name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+		imports.add(`import { ${payloadModel.name} } from '${modelsDir}/${kebabName}';`);
+	}
+	return `
+${Array.from(imports).join("\n")}
+
+${payloadModel.code}
+
+export const ${eventName} = defineEvent({
+  name: '${event.name}',
+  version: 1,
+  description: ${JSON.stringify(event.description ?? "")},
+  payload: ${payloadModel.name},
+});
+`.trim();
+}
+
+//#endregion
+export { generateEventCode };
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../../../src/openapi/importer/events.ts"],"sourcesContent":["import type { ParsedEvent } from '../types';\nimport { generateImports, generateSchemaModelCode } from '../schema-converter';\nimport { toPascalCase, toValidIdentifier } from '../../common/utils';\nimport type { ContractsrcConfig } from '@lssm/lib.contracts';\n\n/**\n * Generate code for an event.\n */\nexport function generateEventCode(\n  event: ParsedEvent,\n  options: ContractsrcConfig\n): string {\n  const eventName = toValidIdentifier(event.name);\n  const modelName = toPascalCase(eventName) + 'Payload';\n\n  // Generate payload model inline or referenced?\n  // Let's generate the payload schema definition first\n  const payloadModel = generateSchemaModelCode(event.payload, modelName);\n\n  const imports = new Set<string>();\n  imports.add(\n    \"import { defineEvent, type EventSpec } from '@lssm/lib.contracts';\"\n  );\n\n  const modelImports = generateImports(payloadModel.fields, options);\n  // Merge imports - this is a bit hacky string manipulation but works for now\n  modelImports\n    .split('\\n')\n    .filter(Boolean)\n    .forEach((i) => imports.add(i));\n\n  // If payloadModel is a reference (empty fields and different name), import it\n  if (payloadModel.name !== modelName) {\n    const modelsDir = `../${options.conventions.models}`;\n    const kebabName = payloadModel.name\n      .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n      .toLowerCase();\n    imports.add(\n      `import { ${payloadModel.name} } from '${modelsDir}/${kebabName}';`\n    );\n  }\n\n  const allImports = Array.from(imports).join('\\n');\n\n  return `\n${allImports}\n\n${payloadModel.code}\n\nexport const ${eventName} = defineEvent({\n  name: '${event.name}',\n  version: 1,\n  description: ${JSON.stringify(event.description ?? '')},\n  payload: ${payloadModel.name},\n});\n`.trim();\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,kBACd,OACA,SACQ;CACR,MAAM,YAAY,kBAAkB,MAAM,KAAK;CAC/C,MAAM,YAAY,aAAa,UAAU,GAAG;CAI5C,MAAM,eAAe,wBAAwB,MAAM,SAAS,UAAU;CAEtE,MAAM,0BAAU,IAAI,KAAa;AACjC,SAAQ,IACN,qEACD;AAID,CAFqB,gBAAgB,aAAa,QAAQ,QAAQ,CAG/D,MAAM,KAAK,CACX,OAAO,QAAQ,CACf,SAAS,MAAM,QAAQ,IAAI,EAAE,CAAC;AAGjC,KAAI,aAAa,SAAS,WAAW;EACnC,MAAM,YAAY,MAAM,QAAQ,YAAY;EAC5C,MAAM,YAAY,aAAa,KAC5B,QAAQ,sBAAsB,QAAQ,CACtC,aAAa;AAChB,UAAQ,IACN,YAAY,aAAa,KAAK,WAAW,UAAU,GAAG,UAAU,IACjE;;AAKH,QAAO;EAFY,MAAM,KAAK,QAAQ,CAAC,KAAK,KAAK,CAGtC;;EAEX,aAAa,KAAK;;eAEL,UAAU;WACd,MAAM,KAAK;;iBAEL,KAAK,UAAU,MAAM,eAAe,GAAG,CAAC;aAC5C,aAAa,KAAK;;EAE7B,MAAM"}

package/dist/openapi/importer/generator.js

@@ -0,0 +1,71 @@
+import { toPascalCase, toSpecName, toValidIdentifier } from "../../common/utils.js";
+import { generateImports } from "../schema-converter.js";
+import { inferAuthLevel, inferOpKind } from "./analyzer.js";
+
+//#region src/openapi/importer/generator.ts
+/**
+* Generate ContractSpec TypeScript code for an operation.
+*/
+function generateSpecCode(operation, contractspecConfig, options = {}, inputModel, outputModel) {
+	const specName = toSpecName(operation.operationId, options.prefix);
+	const kind = inferOpKind(operation.method);
+	const auth = inferAuthLevel(operation, options.defaultAuth ?? "user");
+	const lines = [];
+	lines.push("import { defineCommand, defineQuery } from '@lssm/lib.contracts';");
+	if (inputModel || outputModel) lines.push(generateImports([...inputModel?.fields ?? [], ...outputModel?.fields ?? []], contractspecConfig, false));
+	lines.push("");
+	if (inputModel && inputModel.code) {
+		lines.push("// Input schema");
+		lines.push(inputModel.code);
+		lines.push("");
+	}
+	if (outputModel && outputModel.code) {
+		lines.push("// Output schema");
+		lines.push(outputModel.code);
+		lines.push("");
+	}
+	const defineFunc = kind === "command" ? "defineCommand" : "defineQuery";
+	const safeName = toValidIdentifier(toPascalCase(operation.operationId));
+	lines.push(`/**`);
+	lines.push(` * ${operation.summary ?? operation.operationId}`);
+	if (operation.description) {
+		lines.push(` *`);
+		lines.push(` * ${operation.description}`);
+	}
+	lines.push(` *`);
+	lines.push(` * @source OpenAPI: ${operation.method.toUpperCase()} ${operation.path}`);
+	lines.push(` */`);
+	lines.push(`export const ${safeName}Spec = ${defineFunc}({`);
+	lines.push("  meta: {");
+	lines.push(`    name: '${specName}',`);
+	lines.push("    version: 1,");
+	lines.push(`    stability: '${options.defaultStability ?? "stable"}',`);
+	lines.push(`    owners: [${(options.defaultOwners ?? []).map((o) => `'${o}'`).join(", ")}],`);
+	lines.push(`    tags: [${operation.tags.map((t) => `'${t}'`).join(", ")}],`);
+	lines.push(`    description: ${JSON.stringify(operation.summary ?? operation.operationId)},`);
+	lines.push(`    goal: ${JSON.stringify(operation.description ?? "Imported from OpenAPI")},`);
+	lines.push(`    context: 'Imported from OpenAPI: ${operation.method.toUpperCase()} ${operation.path}',`);
+	lines.push("  },");
+	lines.push("  io: {");
+	if (inputModel) lines.push(`    input: ${inputModel.name},`);
+	else lines.push("    input: null,");
+	if (outputModel) lines.push(`    output: ${outputModel.name},`);
+	else lines.push("    output: null, // TODO: Define output schema");
+	lines.push("  },");
+	lines.push("  policy: {");
+	lines.push(`    auth: '${auth}',`);
+	lines.push("  },");
+	const restMethod = operation.method.toUpperCase() === "GET" ? "GET" : "POST";
+	lines.push("  transport: {");
+	lines.push("    rest: {");
+	lines.push(`      method: '${restMethod}',`);
+	lines.push(`      path: '${operation.path}',`);
+	lines.push("    },");
+	lines.push("  },");
+	lines.push("});");
+	return lines.join("\n");
+}
+
+//#endregion
+export { generateSpecCode };
+//# sourceMappingURL=generator.js.map

package/dist/openapi/importer/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","names":["lines: string[]"],"sources":["../../../src/openapi/importer/generator.ts"],"sourcesContent":["import type { ParsedOperation } from '../types';\nimport {\n  toPascalCase,\n  toSpecName,\n  toValidIdentifier,\n} from '../../common/utils';\nimport { type GeneratedModel, generateImports } from '../schema-converter';\nimport { inferAuthLevel, inferOpKind } from './analyzer';\nimport type {\n  ContractsrcConfig,\n  OpenApiSourceConfig,\n} from '@lssm/lib.contracts';\n\n/**\n * Generate ContractSpec TypeScript code for an operation.\n */\nexport function generateSpecCode(\n  operation: ParsedOperation,\n  contractspecConfig: ContractsrcConfig,\n  options: Partial<OpenApiSourceConfig> = {},\n  inputModel: GeneratedModel | null,\n  outputModel: GeneratedModel | null\n): string {\n  const specName = toSpecName(operation.operationId, options.prefix);\n  const kind = inferOpKind(operation.method);\n  const auth = inferAuthLevel(operation, options.defaultAuth ?? 'user');\n\n  const lines: string[] = [];\n\n  // Imports\n  lines.push(\n    \"import { defineCommand, defineQuery } from '@lssm/lib.contracts';\"\n  );\n  if (inputModel || outputModel) {\n    lines.push(\n      generateImports(\n        [...(inputModel?.fields ?? []), ...(outputModel?.fields ?? [])],\n        contractspecConfig,\n        false // operations import from ../models, not same directory\n      )\n    );\n  }\n  lines.push('');\n\n  // Generate input model if present\n  if (inputModel && inputModel.code) {\n    lines.push('// Input schema');\n    lines.push(inputModel.code);\n    lines.push('');\n  }\n\n  // Generate output model if present\n  if (outputModel && outputModel.code) {\n    lines.push('// Output schema');\n    lines.push(outputModel.code);\n    lines.push('');\n  }\n\n  // Generate spec\n  const defineFunc = kind === 'command' ? 'defineCommand' : 'defineQuery';\n  const safeName = toValidIdentifier(toPascalCase(operation.operationId));\n\n  lines.push(`/**`);\n  lines.push(` * ${operation.summary ?? operation.operationId}`);\n  if (operation.description) {\n    lines.push(` *`);\n    lines.push(` * ${operation.description}`);\n  }\n  lines.push(` *`);\n  lines.push(\n    ` * @source OpenAPI: ${operation.method.toUpperCase()} ${operation.path}`\n  );\n  lines.push(` */`);\n  lines.push(`export const ${safeName}Spec = ${defineFunc}({`);\n\n  // Meta\n  lines.push('  meta: {');\n  lines.push(`    name: '${specName}',`);\n  lines.push('    version: 1,');\n  lines.push(`    stability: '${options.defaultStability ?? 'stable'}',`);\n  lines.push(\n    `    owners: [${(options.defaultOwners ?? []).map((o) => `'${o}'`).join(', ')}],`\n  );\n  lines.push(`    tags: [${operation.tags.map((t) => `'${t}'`).join(', ')}],`);\n  lines.push(\n    `    description: ${JSON.stringify(operation.summary ?? operation.operationId)},`\n  );\n  lines.push(\n    `    goal: ${JSON.stringify(operation.description ?? 'Imported from OpenAPI')},`\n  );\n  lines.push(\n    `    context: 'Imported from OpenAPI: ${operation.method.toUpperCase()} ${operation.path}',`\n  );\n  lines.push('  },');\n\n  // IO\n  lines.push('  io: {');\n  if (inputModel) {\n    lines.push(`    input: ${inputModel.name},`);\n  } else {\n    lines.push('    input: null,');\n  }\n  if (outputModel) {\n    lines.push(`    output: ${outputModel.name},`);\n  } else {\n    lines.push('    output: null, // TODO: Define output schema');\n  }\n  lines.push('  },');\n\n  // Policy\n  lines.push('  policy: {');\n  lines.push(`    auth: '${auth}',`);\n  lines.push('  },');\n\n  // Transport hints\n  // ContractSpec only supports GET and POST - map other methods appropriately\n  const httpMethod = operation.method.toUpperCase();\n  const restMethod = httpMethod === 'GET' ? 'GET' : 'POST'; // GET stays GET, everything else becomes POST\n  lines.push('  transport: {');\n  lines.push('    rest: {');\n  lines.push(`      method: '${restMethod}',`);\n  lines.push(`      path: '${operation.path}',`);\n  lines.push('    },');\n  lines.push('  },');\n\n  lines.push('});');\n\n  return lines.join('\\n');\n}\n"],"mappings":";;;;;;;;AAgBA,SAAgB,iBACd,WACA,oBACA,UAAwC,EAAE,EAC1C,YACA,aACQ;CACR,MAAM,WAAW,WAAW,UAAU,aAAa,QAAQ,OAAO;CAClE,MAAM,OAAO,YAAY,UAAU,OAAO;CAC1C,MAAM,OAAO,eAAe,WAAW,QAAQ,eAAe,OAAO;CAErE,MAAMA,QAAkB,EAAE;AAG1B,OAAM,KACJ,oEACD;AACD,KAAI,cAAc,YAChB,OAAM,KACJ,gBACE,CAAC,GAAI,YAAY,UAAU,EAAE,EAAG,GAAI,aAAa,UAAU,EAAE,CAAE,EAC/D,oBACA,MACD,CACF;AAEH,OAAM,KAAK,GAAG;AAGd,KAAI,cAAc,WAAW,MAAM;AACjC,QAAM,KAAK,kBAAkB;AAC7B,QAAM,KAAK,WAAW,KAAK;AAC3B,QAAM,KAAK,GAAG;;AAIhB,KAAI,eAAe,YAAY,MAAM;AACnC,QAAM,KAAK,mBAAmB;AAC9B,QAAM,KAAK,YAAY,KAAK;AAC5B,QAAM,KAAK,GAAG;;CAIhB,MAAM,aAAa,SAAS,YAAY,kBAAkB;CAC1D,MAAM,WAAW,kBAAkB,aAAa,UAAU,YAAY,CAAC;AAEvE,OAAM,KAAK,MAAM;AACjB,OAAM,KAAK,MAAM,UAAU,WAAW,UAAU,cAAc;AAC9D,KAAI,UAAU,aAAa;AACzB,QAAM,KAAK,KAAK;AAChB,QAAM,KAAK,MAAM,UAAU,cAAc;;AAE3C,OAAM,KAAK,KAAK;AAChB,OAAM,KACJ,uBAAuB,UAAU,OAAO,aAAa,CAAC,GAAG,UAAU,OACpE;AACD,OAAM,KAAK,MAAM;AACjB,OAAM,KAAK,gBAAgB,SAAS,SAAS,WAAW,IAAI;AAG5D,OAAM,KAAK,YAAY;AACvB,OAAM,KAAK,cAAc,SAAS,IAAI;AACtC,OAAM,KAAK,kBAAkB;AAC7B,OAAM,KAAK,mBAAmB,QAAQ,oBAAoB,SAAS,IAAI;AACvE,OAAM,KACJ,iBAAiB,QAAQ,iBAAiB,EAAE,EAAE,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,IAC/E;AACD,OAAM,KAAK,cAAc,UAAU,KAAK,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI;AAC5E,OAAM,KACJ,oBAAoB,KAAK,UAAU,UAAU,WAAW,UAAU,YAAY,CAAC,GAChF;AACD,OAAM,KACJ,aAAa,KAAK,UAAU,UAAU,eAAe,wBAAwB,CAAC,GAC/E;AACD,OAAM,KACJ,wCAAwC,UAAU,OAAO,aAAa,CAAC,GAAG,UAAU,KAAK,IAC1F;AACD,OAAM,KAAK,OAAO;AAGlB,OAAM,KAAK,UAAU;AACrB,KAAI,WACF,OAAM,KAAK,cAAc,WAAW,KAAK,GAAG;KAE5C,OAAM,KAAK,mBAAmB;AAEhC,KAAI,YACF,OAAM,KAAK,eAAe,YAAY,KAAK,GAAG;KAE9C,OAAM,KAAK,kDAAkD;AAE/D,OAAM,KAAK,OAAO;AAGlB,OAAM,KAAK,cAAc;AACzB,OAAM,KAAK,cAAc,KAAK,IAAI;AAClC,OAAM,KAAK,OAAO;CAKlB,MAAM,aADa,UAAU,OAAO,aAAa,KACf,QAAQ,QAAQ;AAClD,OAAM,KAAK,iBAAiB;AAC5B,OAAM,KAAK,cAAc;AACzB,OAAM,KAAK,kBAAkB,WAAW,IAAI;AAC5C,OAAM,KAAK,gBAAgB,UAAU,KAAK,IAAI;AAC9C,OAAM,KAAK,SAAS;AACpB,OAAM,KAAK,OAAO;AAElB,OAAM,KAAK,MAAM;AAEjB,QAAO,MAAM,KAAK,KAAK"}

package/dist/openapi/importer/grouping.js

@@ -0,0 +1,73 @@
+//#region src/openapi/importer/grouping.ts
+/**
+* Resolve the group folder for an operation based on grouping config.
+*/
+function resolveOperationGroupFolder(operation, conventions) {
+	const groupingRule = conventions.operationsGrouping;
+	if (!groupingRule || groupingRule.strategy === "none") return "";
+	return applyGroupingStrategy(groupingRule, {
+		name: operation.operationId,
+		tags: operation.tags,
+		path: operation.path
+	});
+}
+/**
+* Resolve the group folder for a model based on grouping config.
+*/
+function resolveModelGroupFolder(modelName, conventions, relatedPath, relatedTags) {
+	const groupingRule = conventions.modelsGrouping;
+	if (!groupingRule || groupingRule.strategy === "none") return "";
+	return applyGroupingStrategy(groupingRule, {
+		name: modelName,
+		tags: relatedTags ?? [],
+		path: relatedPath
+	});
+}
+/**
+* Resolve the group folder for an event based on grouping config.
+*/
+function resolveEventGroupFolder(eventName, conventions, relatedTags) {
+	const groupingRule = conventions.eventsGrouping;
+	if (!groupingRule || groupingRule.strategy === "none") return "";
+	return applyGroupingStrategy(groupingRule, {
+		name: eventName,
+		tags: relatedTags ?? []
+	});
+}
+/**
+* Apply grouping strategy to extract folder name.
+*/
+function applyGroupingStrategy(rule, context) {
+	switch (rule.strategy) {
+		case "by-tag": return context.tags?.[0] ?? "untagged";
+		case "by-owner": return context.owners?.[0] ?? "unowned";
+		case "by-domain": return extractDomain(context.name);
+		case "by-url-path-single": return extractUrlPathLevel(context.path, 1);
+		case "by-url-path-multi": return extractUrlPathLevel(context.path, rule.urlPathLevel ?? 2);
+		case "by-feature": return extractDomain(context.name);
+		case "none":
+		default: return "";
+	}
+}
+/**
+* Extract domain from operation/model name.
+* e.g., "users.create" -> "users"
+*/
+function extractDomain(name) {
+	if (name.includes(".")) return name.split(".")[0] ?? "default";
+	if (name.includes("_")) return name.split("_")[0] ?? "default";
+	return name.match(/^([a-z]+)/i)?.[1]?.toLowerCase() ?? "default";
+}
+/**
+* Extract URL path segments for grouping.
+*/
+function extractUrlPathLevel(path, level) {
+	if (!path) return "root";
+	const nonParamSegments = path.split("/").filter(Boolean).filter((s) => !s.startsWith("{"));
+	if (nonParamSegments.length === 0) return "root";
+	return nonParamSegments.slice(0, level).join("/");
+}
+
+//#endregion
+export { resolveEventGroupFolder, resolveModelGroupFolder, resolveOperationGroupFolder };
+//# sourceMappingURL=grouping.js.map

package/dist/openapi/importer/grouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouping.js","names":[],"sources":["../../../src/openapi/importer/grouping.ts"],"sourcesContent":["/**\n * Grouping utilities for OpenAPI import/export.\n * Determines output folder structure based on configuration.\n */\nimport type {\n  FolderConventions,\n} from '@lssm/lib.contracts';\nimport type { ParsedOperation } from '../types';\n\n/**\n * Grouping strategy type (matches ContractSpec config).\n */\ntype GroupingStrategy =\n  | 'by-tag'\n  | 'by-owner'\n  | 'by-domain'\n  | 'by-url-path-single'\n  | 'by-url-path-multi'\n  | 'by-feature'\n  | 'none';\n\n/**\n * Grouping rule configuration.\n */\ninterface GroupingRule {\n  strategy: GroupingStrategy;\n  urlPathLevel?: number;\n  pattern?: string;\n}\n\n/**\n * Resolve the group folder for an operation based on grouping config.\n */\nexport function resolveOperationGroupFolder(\n  operation: ParsedOperation,\n  conventions: FolderConventions\n): string {\n  const groupingRule = conventions.operationsGrouping as GroupingRule | undefined;\n  \n  if (!groupingRule || groupingRule.strategy === 'none') {\n    return '';\n  }\n\n  return applyGroupingStrategy(groupingRule, {\n    name: operation.operationId,\n    tags: operation.tags,\n    path: operation.path,\n  });\n}\n\n/**\n * Resolve the group folder for a model based on grouping config.\n */\nexport function resolveModelGroupFolder(\n  modelName: string,\n  conventions: FolderConventions,\n  relatedPath?: string,\n  relatedTags?: string[]\n): string {\n  const groupingRule = conventions.modelsGrouping as GroupingRule | undefined;\n  \n  if (!groupingRule || groupingRule.strategy === 'none') {\n    return '';\n  }\n\n  return applyGroupingStrategy(groupingRule, {\n    name: modelName,\n    tags: relatedTags ?? [],\n    path: relatedPath,\n  });\n}\n\n/**\n * Resolve the group folder for an event based on grouping config.\n */\nexport function resolveEventGroupFolder(\n  eventName: string,\n  conventions: FolderConventions,\n  relatedTags?: string[]\n): string {\n  const groupingRule = conventions.eventsGrouping as GroupingRule | undefined;\n  \n  if (!groupingRule || groupingRule.strategy === 'none') {\n    return '';\n  }\n\n  return applyGroupingStrategy(groupingRule, {\n    name: eventName,\n    tags: relatedTags ?? [],\n  });\n}\n\n/**\n * Apply grouping strategy to extract folder name.\n */\nfunction applyGroupingStrategy(\n  rule: GroupingRule,\n  context: {\n    name: string;\n    tags?: string[];\n    path?: string;\n    owners?: string[];\n  }\n): string {\n  switch (rule.strategy) {\n    case 'by-tag':\n      return context.tags?.[0] ?? 'untagged';\n\n    case 'by-owner':\n      return context.owners?.[0] ?? 'unowned';\n\n    case 'by-domain':\n      return extractDomain(context.name);\n\n    case 'by-url-path-single':\n      return extractUrlPathLevel(context.path, 1);\n\n    case 'by-url-path-multi':\n      return extractUrlPathLevel(context.path, rule.urlPathLevel ?? 2);\n\n    case 'by-feature':\n      // Use domain extraction for feature grouping\n      return extractDomain(context.name);\n\n    case 'none':\n    default:\n      return '';\n  }\n}\n\n/**\n * Extract domain from operation/model name.\n * e.g., \"users.create\" -> \"users\"\n */\nfunction extractDomain(name: string): string {\n  // Handle camelCase/PascalCase names\n  if (name.includes('.')) {\n    return name.split('.')[0] ?? 'default';\n  }\n  if (name.includes('_')) {\n    return name.split('_')[0] ?? 'default';\n  }\n  // Extract from camelCase like \"createUser\" -> \"create\"\n  const match = name.match(/^([a-z]+)/i);\n  return match?.[1]?.toLowerCase() ?? 'default';\n}\n\n/**\n * Extract URL path segments for grouping.\n */\nfunction extractUrlPathLevel(path: string | undefined, level: number): string {\n  if (!path) return 'root';\n  const segments = path.split('/').filter(Boolean);\n  \n  // Filter out path parameters like {id}\n  const nonParamSegments = segments.filter((s) => !s.startsWith('{'));\n  \n  if (nonParamSegments.length === 0) return 'root';\n  \n  return nonParamSegments.slice(0, level).join('/');\n}\n\n/**\n * Build full output path including group folder.\n */\nexport function buildOutputPath(\n  baseDir: string,\n  surfaceDir: string,\n  groupFolder: string,\n  fileName: string\n): string {\n  const parts = [baseDir, surfaceDir];\n  \n  if (groupFolder) {\n    parts.push(groupFolder);\n  }\n  \n  parts.push(fileName);\n  \n  return parts.filter(Boolean).join('/');\n}\n\n/**\n * Determine if feature-based grouping should be applied.\n */\nexport function shouldGroupByFeature(conventions: FolderConventions): boolean {\n  return conventions.groupByFeature;\n}\n"],"mappings":";;;;AAiCA,SAAgB,4BACd,WACA,aACQ;CACR,MAAM,eAAe,YAAY;AAEjC,KAAI,CAAC,gBAAgB,aAAa,aAAa,OAC7C,QAAO;AAGT,QAAO,sBAAsB,cAAc;EACzC,MAAM,UAAU;EAChB,MAAM,UAAU;EAChB,MAAM,UAAU;EACjB,CAAC;;;;;AAMJ,SAAgB,wBACd,WACA,aACA,aACA,aACQ;CACR,MAAM,eAAe,YAAY;AAEjC,KAAI,CAAC,gBAAgB,aAAa,aAAa,OAC7C,QAAO;AAGT,QAAO,sBAAsB,cAAc;EACzC,MAAM;EACN,MAAM,eAAe,EAAE;EACvB,MAAM;EACP,CAAC;;;;;AAMJ,SAAgB,wBACd,WACA,aACA,aACQ;CACR,MAAM,eAAe,YAAY;AAEjC,KAAI,CAAC,gBAAgB,aAAa,aAAa,OAC7C,QAAO;AAGT,QAAO,sBAAsB,cAAc;EACzC,MAAM;EACN,MAAM,eAAe,EAAE;EACxB,CAAC;;;;;AAMJ,SAAS,sBACP,MACA,SAMQ;AACR,SAAQ,KAAK,UAAb;EACE,KAAK,SACH,QAAO,QAAQ,OAAO,MAAM;EAE9B,KAAK,WACH,QAAO,QAAQ,SAAS,MAAM;EAEhC,KAAK,YACH,QAAO,cAAc,QAAQ,KAAK;EAEpC,KAAK,qBACH,QAAO,oBAAoB,QAAQ,MAAM,EAAE;EAE7C,KAAK,oBACH,QAAO,oBAAoB,QAAQ,MAAM,KAAK,gBAAgB,EAAE;EAElE,KAAK,aAEH,QAAO,cAAc,QAAQ,KAAK;EAEpC,KAAK;EACL,QACE,QAAO;;;;;;;AAQb,SAAS,cAAc,MAAsB;AAE3C,KAAI,KAAK,SAAS,IAAI,CACpB,QAAO,KAAK,MAAM,IAAI,CAAC,MAAM;AAE/B,KAAI,KAAK,SAAS,IAAI,CACpB,QAAO,KAAK,MAAM,IAAI,CAAC,MAAM;AAI/B,QADc,KAAK,MAAM,aAAa,GACvB,IAAI,aAAa,IAAI;;;;;AAMtC,SAAS,oBAAoB,MAA0B,OAAuB;AAC5E,KAAI,CAAC,KAAM,QAAO;CAIlB,MAAM,mBAHW,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ,CAGd,QAAQ,MAAM,CAAC,EAAE,WAAW,IAAI,CAAC;AAEnE,KAAI,iBAAiB,WAAW,EAAG,QAAO;AAE1C,QAAO,iBAAiB,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI"}

package/dist/openapi/importer/index.d.ts

@@ -0,0 +1,17 @@
+import { ImportResult } from "../../common/types.js";
+import { ParseResult, ParsedOperation } from "../types.js";
+import { ContractsrcConfig, OpenApiSourceConfig } from "@lssm/lib.contracts";
+
+//#region src/openapi/importer/index.d.ts
+
+/**
+ * Import operations from a parsed OpenAPI document.
+ */
+declare const importFromOpenApi: (parseResult: ParseResult, contractspecOptions: ContractsrcConfig, importOptions?: Partial<OpenApiSourceConfig>) => ImportResult;
+/**
+ * Import a single operation to ContractSpec code.
+ */
+declare function importOperation(operation: ParsedOperation, options: Partial<OpenApiSourceConfig> | undefined, contractspecOptions: ContractsrcConfig): string;
+//#endregion
+export { importFromOpenApi, importOperation };
+//# sourceMappingURL=index.d.ts.map

package/dist/openapi/importer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/openapi/importer/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAyPgB,cAxNH,iBAwNkB,EAAA,CAAA,WAAA,EAvNhB,WAuNgB,EAAA,mBAAA,EAtNR,iBAsNQ,EAAA,aAAA,CAAA,EArNd,OAqNc,CArNN,mBAqNM,CAAA,EAAA,GApN5B,YAoN4B;;;;AAGR,iBAHP,eAAA,CAGO,SAAA,EAFV,eAEU,EAAA,OAAA,EADZ,OACY,CADJ,mBACI,CAAA,GAAA,SAAA,EAAA,mBAAA,EAAA,iBAAA,CAAA,EAAA,MAAA"}