@contractspec/lib.contracts-transformers 1.44.0

package/dist/openapi/exporter.js

@@ -0,0 +1,122 @@
+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
+/**
+* Export a OperationSpecRegistry to an OpenAPI 3.1 document.
+* @deprecated Use exportContractSpec for full surface support.
+*/
+function openApiForRegistry(registry, options = {}) {
+	const { paths, schemas } = exportOperations(registry);
+	return {
+		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 all ContractSpec surfaces to OpenAPI document with extensions.
+*/
+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: {
+			title: options.title ?? "ContractSpec API",
+			version: options.version ?? "0.0.0",
+			...options.description ? { description: options.description } : {}
+		},
+		...options.servers ? { servers: options.servers } : {},
+		paths,
+		components: { schemas }
+	};
+	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) doc["x-contractspec-presentations"] = exportPresentations(registries.presentations);
+	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 result;
+}
+/**
+* Export a OperationSpecRegistry to OpenAPI JSON string.
+*/
+function openApiToJson(registry, options = {}) {
+	const doc = openApiForRegistry(registry, options);
+	return JSON.stringify(doc, null, 2);
+}
+/**
+* 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) {
+	const spaces = "  ".repeat(indent);
+	let yaml = "";
+	if (Array.isArray(obj)) for (const item of obj) if (typeof item === "object" && item !== null) yaml += `${spaces}-\n${jsonToYaml(item, indent + 1)}`;
+	else yaml += `${spaces}- ${JSON.stringify(item)}\n`;
+	else if (typeof obj === "object" && obj !== null) for (const [key, value] of Object.entries(obj)) if (Array.isArray(value)) yaml += `${spaces}${key}:\n${jsonToYaml(value, indent + 1)}`;
+	else if (typeof value === "object" && value !== null) yaml += `${spaces}${key}:\n${jsonToYaml(value, indent + 1)}`;
+	else yaml += `${spaces}${key}: ${JSON.stringify(value)}\n`;
+	return yaml;
+}
+
+//#endregion
+export { contractSpecToJson, contractSpecToYaml, exportContractSpec, openApiForRegistry, openApiToJson, openApiToYaml };
+//# sourceMappingURL=exporter.js.map

package/dist/openapi/exporter.js.map

@@ -0,0 +1 @@
+{"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  PresentationSpec,\n} from '@contractspec/lib.contracts';\nimport type { AnySchemaModel } from '@contractspec/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  presentationsArray?: PresentationSpec[];\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    doc['x-contractspec-presentations'] = exportPresentations(\n      registries.presentations\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(\n        registries.features\n      );\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,40 @@
+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 schemaFormat = options.schemaFormat || "contractspec";
+	const payloadModel = generateSchemaModelCode(event.payload, modelName, schemaFormat, options);
+	const imports = /* @__PURE__ */ new Set();
+	imports.add("import { defineEvent, type EventSpec } from '@contractspec/lib.contracts';");
+	if (payloadModel.imports && payloadModel.imports.length > 0) payloadModel.imports.forEach((i) => imports.add(i));
+	else if (payloadModel.fields && payloadModel.fields.length > 0) 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({
+  meta: {
+    key: '${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 '@contractspec/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  const schemaFormat = options.schemaFormat || 'contractspec';\n  // Generate payload model inline or referenced?\n  // Let's generate the payload schema definition first\n  const payloadModel = generateSchemaModelCode(\n    event.payload,\n    modelName,\n    schemaFormat,\n    options\n  );\n\n  const imports = new Set<string>();\n  imports.add(\n    \"import { defineEvent, type EventSpec } from '@contractspec/lib.contracts';\"\n  );\n\n  if (payloadModel.imports && payloadModel.imports.length > 0) {\n    payloadModel.imports.forEach((i) => imports.add(i));\n  } else if (payloadModel.fields && payloadModel.fields.length > 0) {\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\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  meta: {\n    key: '${event.name}',\n    version: 1,\n    description: ${JSON.stringify(event.description ?? '')},\n  },\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;CAE5C,MAAM,eAAe,QAAQ,gBAAgB;CAG7C,MAAM,eAAe,wBACnB,MAAM,SACN,WACA,cACA,QACD;CAED,MAAM,0BAAU,IAAI,KAAa;AACjC,SAAQ,IACN,6EACD;AAED,KAAI,aAAa,WAAW,aAAa,QAAQ,SAAS,EACxD,cAAa,QAAQ,SAAS,MAAM,QAAQ,IAAI,EAAE,CAAC;UAC1C,aAAa,UAAU,aAAa,OAAO,SAAS,EAG7D,CAFqB,gBAAgB,aAAa,QAAQ,QAAQ,CAG/D,MAAM,KAAK,CACX,OAAO,QAAQ,CACf,SAAS,MAAM,QAAQ,IAAI,EAAE,CAAC;AAInC,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;;YAEb,MAAM,KAAK;;mBAEJ,KAAK,UAAU,MAAM,eAAe,GAAG,CAAC;;aAE9C,aAAa,KAAK;;EAE7B,MAAM"}

package/dist/openapi/importer/generator.js

@@ -0,0 +1,105 @@
+import { toPascalCase, toSpecKey, 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, queryModel = null, paramsModel = null, headersModel = null) {
+	const specKey = toSpecKey(operation.operationId, options.prefix);
+	const kind = inferOpKind(operation.method);
+	const auth = inferAuthLevel(operation, options.defaultAuth ?? "user");
+	const lines = [];
+	lines.push("import { defineCommand, defineQuery } from '@contractspec/lib.contracts';");
+	if (inputModel || outputModel || queryModel || paramsModel || headersModel) {
+		const collectedImports = /* @__PURE__ */ new Set();
+		const models = [
+			inputModel,
+			outputModel,
+			queryModel,
+			paramsModel,
+			headersModel
+		].filter((m) => !!m);
+		models.forEach((m) => {
+			if (m.imports && m.imports.length > 0) m.imports.forEach((i) => collectedImports.add(i));
+		});
+		const legacyFields = models.filter((m) => !m.imports || m.imports.length === 0).flatMap((m) => m.fields);
+		if (legacyFields.length > 0) generateImports(legacyFields, contractspecConfig, false).split("\n").filter(Boolean).forEach((i) => collectedImports.add(i));
+		if (collectedImports.size > 0) lines.push(Array.from(collectedImports).sort().join("\n"));
+	}
+	lines.push("");
+	const schemaSections = [
+		{
+			label: "Input schema",
+			model: inputModel
+		},
+		{
+			label: "Query schema",
+			model: queryModel
+		},
+		{
+			label: "Path schema",
+			model: paramsModel
+		},
+		{
+			label: "Header schema",
+			model: headersModel
+		},
+		{
+			label: "Output schema",
+			model: outputModel
+		}
+	];
+	for (const section of schemaSections) if (section.model && section.model.code) {
+		lines.push(`// ${section.label}`);
+		lines.push(section.model.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(`    key: '${specKey}',`);
+	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: {");
+	lines.push(`    input: ${inputModel?.name ?? "null"},`);
+	if (queryModel) lines.push(`    query: ${queryModel.name},`);
+	if (paramsModel) lines.push(`    params: ${paramsModel.name},`);
+	if (headersModel) lines.push(`    headers: ${headersModel.name},`);
+	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 { toPascalCase, toSpecKey, toValidIdentifier } from '../../common/utils';\nimport { type GeneratedModel, generateImports } from '../schema-converter';\nimport { inferAuthLevel, inferOpKind } from './analyzer';\nimport type {\n  ContractsrcConfig,\n  OpenApiSourceConfig,\n} from '@contractspec/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  queryModel: GeneratedModel | null = null,\n  paramsModel: GeneratedModel | null = null,\n  headersModel: GeneratedModel | null = null\n): string {\n  const specKey = toSpecKey(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 '@contractspec/lib.contracts';\"\n  );\n  if (inputModel || outputModel || queryModel || paramsModel || headersModel) {\n    const collectedImports = new Set<string>();\n    const models = [\n      inputModel,\n      outputModel,\n      queryModel,\n      paramsModel,\n      headersModel,\n    ].filter((m): m is GeneratedModel => !!m);\n\n    // Add explicit imports from generators (e.g. Zod, JsonSchema)\n    models.forEach((m) => {\n      if (m.imports && m.imports.length > 0) {\n        m.imports.forEach((i) => collectedImports.add(i));\n      }\n    });\n\n    // Add legacy fields-based imports (ContractSpec format)\n    const legacyModels = models.filter(\n      (m) => !m.imports || m.imports.length === 0\n    );\n    const legacyFields = legacyModels.flatMap((m) => m.fields);\n\n    if (legacyFields.length > 0) {\n      const legacyImportStr = generateImports(\n        legacyFields,\n        contractspecConfig,\n        false\n      );\n      legacyImportStr\n        .split('\\n')\n        .filter(Boolean)\n        .forEach((i) => collectedImports.add(i));\n    }\n\n    if (collectedImports.size > 0) {\n      lines.push(Array.from(collectedImports).sort().join('\\n'));\n    }\n  }\n  lines.push('');\n\n  // Generate schemas\n  const schemaSections = [\n    { label: 'Input schema', model: inputModel },\n    { label: 'Query schema', model: queryModel },\n    { label: 'Path schema', model: paramsModel },\n    { label: 'Header schema', model: headersModel },\n    { label: 'Output schema', model: outputModel },\n  ];\n\n  for (const section of schemaSections) {\n    if (section.model && section.model.code) {\n      lines.push(`// ${section.label}`);\n      lines.push(section.model.code);\n      lines.push('');\n    }\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(`    key: '${specKey}',`);\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  lines.push(`    input: ${inputModel?.name ?? 'null'},`);\n  if (queryModel) lines.push(`    query: ${queryModel.name},`);\n  if (paramsModel) lines.push(`    params: ${paramsModel.name},`);\n  if (headersModel) lines.push(`    headers: ${headersModel.name},`);\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  const httpMethod = operation.method.toUpperCase();\n  const restMethod = httpMethod === 'GET' ? 'GET' : '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":"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"}

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 { FolderConventions } from '@contractspec/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\n    | GroupingRule\n    | 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":";;;;AA+BA,SAAgB,4BACd,WACA,aACQ;CACR,MAAM,eAAe,YAAY;AAIjC,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 "@contractspec/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":";;;;;;;;;AAgTgB,cA/QH,iBA+QkB,EAAA,CAAA,WAAA,EA9QhB,WA8QgB,EAAA,mBAAA,EA7QR,iBA6QQ,EAAA,aAAA,CAAA,EA5Qd,OA4Qc,CA5QN,mBA4QM,CAAA,EAAA,GA3Q5B,YA2Q4B;;;;AAGR,iBAHP,eAAA,CAGO,SAAA,EAFV,eAEU,EAAA,OAAA,EADZ,OACY,CADJ,mBACI,CAAA,GAAA,SAAA,EAAA,mBAAA,EAAA,iBAAA,CAAA,EAAA,MAAA"}

package/dist/openapi/importer/index.js

@@ -0,0 +1,175 @@
+import { toFileName, toSpecKey } from "../../common/utils.js";
+import { generateSchemaModelCode } from "../schema-converter.js";
+import { buildInputSchemas, getOutputSchema } from "./schemas.js";
+import { COMMAND_METHODS, inferAuthLevel, inferOpKind } from "./analyzer.js";
+import { generateSpecCode } from "./generator.js";
+import { generateModelCode } from "./models.js";
+import { generateEventCode } from "./events.js";
+import { resolveEventGroupFolder, resolveModelGroupFolder, resolveOperationGroupFolder } from "./grouping.js";
+
+//#region src/openapi/importer/index.ts
+/**
+* Import operations from a parsed OpenAPI document.
+*/
+const importFromOpenApi = (parseResult, contractspecOptions, importOptions = {}) => {
+	const { tags, exclude = [], include } = importOptions;
+	const specs = [];
+	const skipped = [];
+	const errors = [];
+	for (const operation of parseResult.operations) {
+		if (tags && tags.length > 0) {
+			if (!operation.tags.some((t) => tags.includes(t))) {
+				skipped.push({
+					sourceId: operation.operationId,
+					reason: `No matching tags (has: ${operation.tags.join(", ")})`
+				});
+				continue;
+			}
+		}
+		if (include && include.length > 0) {
+			if (!include.includes(operation.operationId)) {
+				skipped.push({
+					sourceId: operation.operationId,
+					reason: "Not in include list"
+				});
+				continue;
+			}
+		} else if (exclude.includes(operation.operationId)) {
+			skipped.push({
+				sourceId: operation.operationId,
+				reason: "In exclude list"
+			});
+			continue;
+		}
+		if (operation.deprecated && importOptions.defaultStability !== "deprecated") {
+			skipped.push({
+				sourceId: operation.operationId,
+				reason: "Deprecated operation"
+			});
+			continue;
+		}
+		try {
+			const inputSchemas = buildInputSchemas(operation);
+			const schemaFormat = importOptions.schemaFormat || contractspecOptions.schemaFormat || "contractspec";
+			const inputModel = inputSchemas.body ? generateSchemaModelCode(inputSchemas.body, `${operation.operationId}Input`, schemaFormat, contractspecOptions) : null;
+			const queryModel = inputSchemas.query ? generateSchemaModelCode(inputSchemas.query, `${operation.operationId}Query`, schemaFormat, contractspecOptions) : null;
+			const paramsModel = inputSchemas.params ? generateSchemaModelCode(inputSchemas.params, `${operation.operationId}Params`, schemaFormat, contractspecOptions) : null;
+			const headersModel = inputSchemas.headers ? generateSchemaModelCode(inputSchemas.headers, `${operation.operationId}Headers`, schemaFormat, contractspecOptions) : null;
+			const outputSchema = getOutputSchema(operation);
+			let outputModel = outputSchema ? generateSchemaModelCode(outputSchema, `${operation.operationId}Output`, schemaFormat, contractspecOptions) : null;
+			if (outputModel && schemaFormat === "contractspec" && !outputModel.code.includes("defineSchemaModel")) outputModel = null;
+			const code = generateSpecCode(operation, contractspecOptions, importOptions, inputModel, outputModel, queryModel, paramsModel, headersModel);
+			const fileName = toFileName(toSpecKey(operation.operationId, importOptions.prefix));
+			const transportHints = { rest: {
+				method: operation.method.toUpperCase(),
+				path: operation.path,
+				params: {
+					path: operation.pathParams.map((p) => p.name),
+					query: operation.queryParams.map((p) => p.name),
+					header: operation.headerParams.map((p) => p.name),
+					cookie: operation.cookieParams.map((p) => p.name)
+				}
+			} };
+			const source = {
+				type: "openapi",
+				sourceId: operation.operationId,
+				operationId: operation.operationId,
+				openApiVersion: parseResult.version,
+				importedAt: /* @__PURE__ */ new Date()
+			};
+			const groupFolder = resolveOperationGroupFolder(operation, contractspecOptions.conventions);
+			specs.push({
+				code,
+				fileName,
+				groupFolder: groupFolder || void 0,
+				source,
+				transportHints
+			});
+		} catch (error) {
+			errors.push({
+				sourceId: operation.operationId,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+	}
+	for (const [name, schema] of Object.entries(parseResult.schemas)) try {
+		const code = generateModelCode(name, schema, {
+			...contractspecOptions,
+			schemaFormat: importOptions.schemaFormat || contractspecOptions.schemaFormat
+		});
+		const fileName = toFileName(toSpecKey(name, importOptions.prefix));
+		const groupFolder = resolveModelGroupFolder(name, contractspecOptions.conventions);
+		specs.push({
+			code,
+			fileName,
+			groupFolder: groupFolder || void 0,
+			source: {
+				type: "openapi",
+				sourceId: name,
+				operationId: name,
+				openApiVersion: parseResult.version,
+				importedAt: /* @__PURE__ */ new Date()
+			},
+			transportHints: {}
+		});
+	} catch (error) {
+		errors.push({
+			sourceId: name,
+			error: error instanceof Error ? "Model conversion failed: " + error.message : String(error)
+		});
+	}
+	for (const event of parseResult.events) try {
+		const code = generateEventCode(event, {
+			...contractspecOptions,
+			schemaFormat: importOptions.schemaFormat || contractspecOptions.schemaFormat
+		});
+		const fileName = toFileName(toSpecKey(event.name, importOptions.prefix));
+		const groupFolder = resolveEventGroupFolder(event.name, contractspecOptions.conventions);
+		specs.push({
+			code,
+			fileName,
+			groupFolder: groupFolder || void 0,
+			source: {
+				type: "openapi",
+				sourceId: event.name,
+				operationId: event.name,
+				openApiVersion: parseResult.version,
+				importedAt: /* @__PURE__ */ new Date()
+			},
+			transportHints: {}
+		});
+	} catch (error) {
+		errors.push({
+			sourceId: event.name,
+			error: error instanceof Error ? "Event conversion failed: " + error.message : String(error)
+		});
+	}
+	return {
+		operationSpecs: specs,
+		skipped,
+		errors,
+		summary: {
+			total: parseResult.operations.length + Object.keys(parseResult.schemas).length + parseResult.events.length,
+			imported: specs.length,
+			skipped: skipped.length,
+			errors: errors.length
+		}
+	};
+};
+/**
+* Import a single operation to ContractSpec code.
+*/
+function importOperation(operation, options = {}, contractspecOptions) {
+	const inputSchemas = buildInputSchemas(operation);
+	const schemaFormat = options.schemaFormat || contractspecOptions.schemaFormat || "contractspec";
+	const inputModel = inputSchemas.body ? generateSchemaModelCode(inputSchemas.body, `${operation.operationId}Input`, schemaFormat, contractspecOptions) : null;
+	const queryModel = inputSchemas.query ? generateSchemaModelCode(inputSchemas.query, `${operation.operationId}Query`, schemaFormat, contractspecOptions) : null;
+	const paramsModel = inputSchemas.params ? generateSchemaModelCode(inputSchemas.params, `${operation.operationId}Params`, schemaFormat, contractspecOptions) : null;
+	const headersModel = inputSchemas.headers ? generateSchemaModelCode(inputSchemas.headers, `${operation.operationId}Headers`, schemaFormat, contractspecOptions) : null;
+	const outputSchema = getOutputSchema(operation);
+	return generateSpecCode(operation, contractspecOptions, options, inputModel, outputSchema ? generateSchemaModelCode(outputSchema, `${operation.operationId}Output`, schemaFormat, contractspecOptions) : null, queryModel, paramsModel, headersModel);
+}
+
+//#endregion
+export { importFromOpenApi, importOperation };
+//# sourceMappingURL=index.js.map