@lssm/lib.contracts-transformers 0.0.0-canary-20251220030446 → 0.0.0-canary-20251221114240

package/README.md

@@ -18,9 +18,9 @@ bun add @lssm/lib.contracts-transformers
 
 ```typescript
 import { openApiForRegistry } from '@lssm/lib.contracts-transformers/openapi';
-import { SpecRegistry } from '@lssm/lib.contracts';
+import { OperationSpecRegistry } from '@lssm/lib.contracts';
 
-const registry = new SpecRegistry();
+const registry = new OperationSpecRegistry();
 // ... register your specs ...
 
 const openApiDoc = openApiForRegistry(registry, {

package/dist/common/index.d.ts

@@ -1,3 +1,3 @@
-import { DiffChange, DiffChangeType, ImportResult, ImportedSpec, SpecDiff, SpecSource, SyncResult, TransportHints, ValidationResult } from "./types.js";
+import { DiffChange, DiffChangeType, ImportResult, ImportedOperationSpec, SpecDiff, SpecSource, SyncResult, TransportHints, ValidationResult } from "./types.js";
 import { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier } from "./utils.js";
-export { DiffChange, DiffChangeType, ImportResult, ImportedSpec, SpecDiff, SpecSource, SyncResult, TransportHints, ValidationResult, deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier };
+export { DiffChange, DiffChangeType, ImportResult, ImportedOperationSpec, SpecDiff, SpecSource, SyncResult, TransportHints, ValidationResult, deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier };

package/dist/common/types.d.ts

@@ -1,4 +1,4 @@
-import { AnyContractSpec } from "@lssm/lib.contracts";
+import { AnyOperationSpec } from "@lssm/lib.contracts";
 
 //#region src/common/types.d.ts
 
@@ -40,9 +40,13 @@ interface TransportHints {
 /**
  * Result of importing a single spec from an external format.
  */
-interface ImportedSpec {
-  /** The generated ContractSpec */
-  spec: AnyContractSpec;
+interface ImportedOperationSpec {
+  /**
+   * The generated ContractSpec.
+   * Optional because during code generation the actual spec object is not
+   * available until the generated code is executed at runtime.
+   */
+  operationSpec?: AnyOperationSpec;
   /** Generated TypeScript code for the spec */
   code: string;
   /** Suggested file name for the spec */
@@ -57,7 +61,7 @@ interface ImportedSpec {
  */
 interface ImportResult {
   /** Successfully imported specs */
-  specs: ImportedSpec[];
+  operationSpecs: ImportedOperationSpec[];
   /** Specs that were skipped (e.g., unsupported features) */
   skipped: {
     sourceId: string;
@@ -102,9 +106,9 @@ interface SpecDiff {
   /** Identifier for the operation */
   operationId: string;
   /** Existing ContractSpec (if any) */
-  existing?: AnyContractSpec;
+  existing?: AnyOperationSpec;
   /** Incoming imported spec */
-  incoming: ImportedSpec;
+  incoming: ImportedOperationSpec;
   /** List of detected changes */
   changes: DiffChange[];
   /** Whether specs are semantically equivalent */
@@ -117,10 +121,10 @@ interface SpecDiff {
  */
 interface SyncResult {
   /** Specs that were added (new imports) */
-  added: ImportedSpec[];
+  added: ImportedOperationSpec[];
   /** Specs that were updated */
   updated: {
-    spec: ImportedSpec;
+    spec: ImportedOperationSpec;
     changes: DiffChange[];
   }[];
   /** Specs that were kept unchanged */
@@ -149,5 +153,5 @@ interface ValidationResult {
   warnings: string[];
 }
 //#endregion
-export { DiffChange, DiffChangeType, ImportResult, ImportedSpec, SpecDiff, SpecSource, SyncResult, TransportHints, ValidationResult };
+export { DiffChange, DiffChangeType, ImportResult, ImportedOperationSpec, SpecDiff, SpecSource, SyncResult, TransportHints, ValidationResult };
 //# sourceMappingURL=types.d.ts.map

package/dist/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/common/types.ts"],"sourcesContent":[],"mappings":";;;;AA0BA;AAoBA;;AAQU,UA7CO,UAAA,CA6CP;EAEQ;EAAc,IAAA,EAAA,SAAA,GAAA,UAAA,GAAA,SAAA,GAAA,UAAA;EAMf;EAyBL,GAAA,CAAA,EAAA,MAAA;EAUK;EAgBA,IAAA,CAAA,EAAA,MAAQ;EAIZ;EAED,QAAA,EAAA,MAAA;EAED;EAAU,UAAA,EAtGP,IAsGO;AAUrB;;;;;AAWqB,UApHJ,cAAA,CAoHI;EAaJ,IAAA,CAAA,EAAA;;;;;;;;;;;;;;;;;;UA7GA,YAAA;;QAET;;;;;;UAME;;kBAEQ;;;;;UAMD,YAAA;;SAER;;;;;;;;;;;;;;;;;;;;;;KAuBG,cAAA;;;;UAUK,UAAA;;;;QAIT;;;;;;;;;;;UAYS,QAAA;;;;aAIJ;;YAED;;WAED;;;;;;;;;UAUM,UAAA;;SAER;;;UAGC;aACG;;;;;aAKA;;;;;;;;;;;;UAaI,gBAAA;;;;SAIR"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/common/types.ts"],"sourcesContent":[],"mappings":";;;;AA0BA;AAoBA;;AAYU,UAjDO,UAAA,CAiDP;EAEQ;EAAc,IAAA,EAAA,SAAA,GAAA,UAAA,GAAA,SAAA,GAAA,UAAA;EAMf;EAyBL,GAAA,CAAA,EAAA,MAAA;EAUK;EAgBA,IAAA,CAAA,EAAA,MAAQ;EAIZ;EAED,QAAA,EAAA,MAAA;EAED;EAAU,UAAA,EA1GP,IA0GO;AAUrB;;;;;AAWqB,UAxHJ,cAAA,CAwHI;EAaJ,IAAA,CAAA,EAAA;;;;;;;;;;;;;;;;;;UAjHA,qBAAA;;;;;;kBAMC;;;;;;UAMR;;kBAEQ;;;;;UAMD,YAAA;;kBAEC;;;;;;;;;;;;;;;;;;;;;;KAuBN,cAAA;;;;UAUK,UAAA;;;;QAIT;;;;;;;;;;;UAYS,QAAA;;;;aAIJ;;YAED;;WAED;;;;;;;;;UAUM,UAAA;;SAER;;;UAGC;aACG;;;;;aAKA;;;;;;;;;;;;UAaI,gBAAA;;;;SAIR"}

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-import { DiffChange, DiffChangeType, ImportResult, ImportedSpec, SpecDiff, SpecSource, SyncResult, TransportHints, ValidationResult } from "./common/types.js";
+import { DiffChange, DiffChangeType, ImportResult, ImportedOperationSpec, SpecDiff, SpecSource, SyncResult, TransportHints, ValidationResult } from "./common/types.js";
 import { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier } from "./common/utils.js";
-import { ContractSpecOpenApiDocument, HttpMethod, OpenApiDocument, OpenApiExportOptions, OpenApiImportOptions, OpenApiOperation, OpenApiParameter, OpenApiParseOptions, OpenApiSchema, OpenApiServer, OpenApiSource, OpenApiTransportHints, OpenApiVersion, ParameterLocation, ParseResult, ParsedOperation, ParsedParameter } from "./openapi/types.js";
-import { detectFormat, detectVersion, parseOpenApi, parseOpenApiDocument, parseOpenApiString } from "./openapi/parser.js";
+import { ContractSpecOpenApiDocument, HttpMethod, OpenApiDocument, OpenApiExportOptions, OpenApiOperation, OpenApiParameter, OpenApiParseOptions, OpenApiSchema, OpenApiServer, OpenApiSource, OpenApiTransportHints, OpenApiVersion, ParameterLocation, ParseResult, ParsedOperation, ParsedParameter } from "./openapi/types.js";
+import { detectFormat, detectVersion, parseOpenApiString } from "./openapi/parser/utils.js";
+import { parseOpenApi, parseOpenApiDocument } from "./openapi/parser/document.js";
 import { defaultRestPath, openApiForRegistry, openApiToJson, openApiToYaml } from "./openapi/exporter.js";
-import { importFromOpenApi, importOperation } from "./openapi/importer.js";
 import { GeneratedModel, SchemaField, TypescriptType, generateImports, generateSchemaModelCode, getScalarType, jsonSchemaToField, jsonSchemaToType } from "./openapi/schema-converter.js";
+import { importFromOpenApi, importOperation } from "./openapi/importer/index.js";
 import { DiffOptions, createSpecDiff, diffAll, diffSpecVsOperation, diffSpecs, formatDiffChanges } from "./openapi/differ.js";
-export { ContractSpecOpenApiDocument, DiffChange, DiffChangeType, DiffOptions, GeneratedModel, HttpMethod, ImportResult, ImportedSpec, OpenApiDocument, OpenApiExportOptions, OpenApiImportOptions, OpenApiOperation, OpenApiParameter, OpenApiParseOptions, OpenApiSchema, OpenApiServer, OpenApiSource, OpenApiTransportHints, OpenApiVersion, ParameterLocation, ParseResult, ParsedOperation, ParsedParameter, SchemaField, SpecDiff, SpecSource, SyncResult, TransportHints, TypescriptType, ValidationResult, createSpecDiff, deepEqual, defaultRestPath, detectFormat, detectVersion, diffAll, diffSpecVsOperation, diffSpecs, extractPathParams, formatDiffChanges, generateImports, generateSchemaModelCode, getByPath, getScalarType, importFromOpenApi, importOperation, jsonSchemaToField, jsonSchemaToType, normalizePath, openApiForRegistry, openApiToJson, openApiToYaml, parseOpenApi, parseOpenApiDocument, parseOpenApiString, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier };
+export { ContractSpecOpenApiDocument, DiffChange, DiffChangeType, DiffOptions, GeneratedModel, HttpMethod, ImportResult, ImportedOperationSpec, OpenApiDocument, OpenApiExportOptions, OpenApiOperation, OpenApiParameter, OpenApiParseOptions, OpenApiSchema, OpenApiServer, OpenApiSource, OpenApiTransportHints, OpenApiVersion, ParameterLocation, ParseResult, ParsedOperation, ParsedParameter, SchemaField, SpecDiff, SpecSource, SyncResult, TransportHints, TypescriptType, ValidationResult, createSpecDiff, deepEqual, defaultRestPath, detectFormat, detectVersion, diffAll, diffSpecVsOperation, diffSpecs, extractPathParams, formatDiffChanges, generateImports, generateSchemaModelCode, getByPath, getScalarType, importFromOpenApi, importOperation, jsonSchemaToField, jsonSchemaToType, normalizePath, openApiForRegistry, openApiToJson, openApiToYaml, parseOpenApi, parseOpenApiDocument, parseOpenApiString, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier };

package/dist/index.js

@@ -1,8 +1,9 @@
-import { detectFormat, detectVersion, parseOpenApi, parseOpenApiDocument, parseOpenApiString } from "./openapi/parser.js";
+import { detectFormat, detectVersion, parseOpenApiString } from "./openapi/parser/utils.js";
+import { parseOpenApi, parseOpenApiDocument } from "./openapi/parser/document.js";
 import { defaultRestPath, openApiForRegistry, openApiToJson, openApiToYaml } from "./openapi/exporter.js";
 import { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier } from "./common/utils.js";
 import { generateImports, generateSchemaModelCode, getScalarType, jsonSchemaToField, jsonSchemaToType } from "./openapi/schema-converter.js";
-import { importFromOpenApi, importOperation } from "./openapi/importer.js";
+import { importFromOpenApi, importOperation } from "./openapi/importer/index.js";
 import { createSpecDiff, diffAll, diffSpecVsOperation, diffSpecs, formatDiffChanges } from "./openapi/differ.js";
 import "./openapi/index.js";
 

package/dist/openapi/differ.d.ts

@@ -1,6 +1,6 @@
-import { DiffChange, ImportedSpec, SpecDiff } from "../common/types.js";
+import { DiffChange, ImportedOperationSpec, SpecDiff } from "../common/types.js";
 import { ParsedOperation } from "./types.js";
-import { AnyContractSpec } from "@lssm/lib.contracts";
+import { AnyOperationSpec } from "@lssm/lib.contracts";
 
 //#region src/openapi/differ.d.ts
 
@@ -20,19 +20,19 @@ interface DiffOptions {
 /**
  * Diff a ContractSpec against an OpenAPI operation.
  */
-declare function diffSpecVsOperation(spec: AnyContractSpec, operation: ParsedOperation, options?: DiffOptions): DiffChange[];
+declare function diffSpecVsOperation(spec: AnyOperationSpec, operation: ParsedOperation, options?: DiffOptions): DiffChange[];
 /**
  * Diff two ContractSpecs.
  */
-declare function diffSpecs(oldSpec: AnyContractSpec, newSpec: AnyContractSpec, options?: DiffOptions): DiffChange[];
+declare function diffSpecs(oldSpec: AnyOperationSpec, newSpec: AnyOperationSpec, options?: DiffOptions): DiffChange[];
 /**
  * Create a SpecDiff from an existing spec and an imported spec.
  */
-declare function createSpecDiff(operationId: string, existing: AnyContractSpec | undefined, incoming: ImportedSpec, options?: DiffOptions): SpecDiff;
+declare function createSpecDiff(operationId: string, existing: AnyOperationSpec | undefined, incoming: ImportedOperationSpec, options?: DiffOptions): SpecDiff;
 /**
  * Batch diff multiple specs against OpenAPI operations.
  */
-declare function diffAll(existingSpecs: Map<string, AnyContractSpec>, importedSpecs: ImportedSpec[], options?: DiffOptions): SpecDiff[];
+declare function diffAll(existingSpecs: Map<string, AnyOperationSpec>, importedSpecs: ImportedOperationSpec[], options?: DiffOptions): SpecDiff[];
 /**
  * Format diff changes for display.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"differ.d.ts","names":[],"sources":["../../src/openapi/differ.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAwIG,UAtHc,WAAA,CAsHd;EAAU;EA2EG,kBAAS,CAAA,EAAA,OAAA;EACd;EACA,UAAA,CAAA,EAAA,OAAA;EACA;EACR,eAAA,CAAA,EAAA,OAAA;EAAU;EA+CG,WAAA,CAAA,EAAA,MAAc,EAAA;;;;;AAKnB,iBAvIK,mBAAA,CAuIL,IAAA,EAtIH,eAsIG,EAAA,SAAA,EArIE,eAqIF,EAAA,OAAA,CAAA,EApIA,WAoIA,CAAA,EAnIR,UAmIQ,EAAA;AAgCX;;;AAEiB,iBA1FD,SAAA,CA0FC,OAAA,EAzFN,eAyFM,EAAA,OAAA,EAxFN,eAwFM,EAAA,OAAA,CAAA,EAvFN,WAuFM,CAAA,EAtFd,UAsFc,EAAA;;;;AAsDD,iBA7FA,cAAA,CA6F2B,WAAU,EAAA,MAAA,EAAA,QAAA,EA3FzC,eA2FyC,GAAA,SAAA,EAAA,QAAA,EA1FzC,YA0FyC,EAAA,OAAA,CAAA,EAzF1C,WAyF0C,CAAA,EAxFlD,QAwFkD;;;;iBAxDrC,OAAA,gBACC,YAAY,iCACZ,0BACN,cACR;;;;iBAoDa,iBAAA,UAA2B"}
+{"version":3,"file":"differ.d.ts","names":[],"sources":["../../src/openapi/differ.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAwIG,UAtHc,WAAA,CAsHd;EAAU;EA2EG,kBAAS,CAAA,EAAA,OAAA;EACd;EACA,UAAA,CAAA,EAAA,OAAA;EACA;EACR,eAAA,CAAA,EAAA,OAAA;EAAU;EA+CG,WAAA,CAAA,EAAA,MAAc,EAAA;;;;;AAKnB,iBAvIK,mBAAA,CAuIL,IAAA,EAtIH,gBAsIG,EAAA,SAAA,EArIE,eAqIF,EAAA,OAAA,CAAA,EApIA,WAoIA,CAAA,EAnIR,UAmIQ,EAAA;AA4CX;;;AAEiB,iBAtGD,SAAA,CAsGC,OAAA,EArGN,gBAqGM,EAAA,OAAA,EApGN,gBAoGM,EAAA,OAAA,CAAA,EAnGN,WAmGM,CAAA,EAlGd,UAkGc,EAAA;;;;AAsDD,iBAzGA,cAAA,CAyG2B,WAAU,EAAA,MAAA,EAAA,QAAA,EAvGzC,gBAuGyC,GAAA,SAAA,EAAA,QAAA,EAtGzC,qBAsGyC,EAAA,OAAA,CAAA,EArG1C,WAqG0C,CAAA,EApGlD,QAoGkD;;;;iBAxDrC,OAAA,gBACC,YAAY,kCACZ,mCACN,cACR;;;;iBAoDa,iBAAA,UAA2B"}

package/dist/openapi/differ.js

@@ -136,13 +136,20 @@ function diffSpecs(oldSpec, newSpec, options = {}) {
 function createSpecDiff(operationId, existing, incoming, options = {}) {
 	let changes = [];
 	let isEquivalent = false;
-	if (existing) {
-		changes = diffSpecs(existing, incoming.spec, options);
+	if (existing && incoming.operationSpec) {
+		changes = diffSpecs(existing, incoming.operationSpec, options);
 		isEquivalent = changes.length === 0;
-	} else changes = [{
+	} else if (existing && !incoming.operationSpec) changes = [{
+		path: "",
+		type: "modified",
+		oldValue: existing,
+		newValue: incoming.code,
+		description: "Spec code imported from OpenAPI (runtime comparison not available)"
+	}];
+	else changes = [{
 		path: "",
 		type: "added",
-		newValue: incoming.spec,
+		newValue: incoming.operationSpec ?? incoming.code,
 		description: "New spec imported from OpenAPI"
 	}];
 	return {

package/dist/openapi/differ.js.map

@@ -1 +1 @@
-{"version":3,"file":"differ.js","names":["changeType: DiffChangeType","changes: DiffChange[]","diffs: SpecDiff[]","existing: AnyContractSpec | undefined","lines: string[]"],"sources":["../../src/openapi/differ.ts"],"sourcesContent":["/**\n * Diff ContractSpec specs against OpenAPI operations.\n * Used for sync operations to detect changes.\n */\n\nimport type { AnyContractSpec } from '@lssm/lib.contracts';\nimport type { ParsedOperation } from './types';\nimport type {\n  SpecDiff,\n  DiffChange,\n  DiffChangeType,\n  ImportedSpec,\n} from '../common/types';\nimport { deepEqual } from '../common/utils';\n\n/**\n * Options for diffing specs.\n */\nexport interface DiffOptions {\n  /** Ignore description changes */\n  ignoreDescriptions?: boolean;\n  /** Ignore tag changes */\n  ignoreTags?: boolean;\n  /** Ignore transport changes (path, method) */\n  ignoreTransport?: boolean;\n  /** Custom paths to ignore */\n  ignorePaths?: string[];\n}\n\n/**\n * Compare two values and generate a diff change if different.\n */\nfunction compareValues(\n  path: string,\n  oldValue: unknown,\n  newValue: unknown,\n  description: string\n): DiffChange | null {\n  if (deepEqual(oldValue, newValue)) {\n    return null;\n  }\n\n  let changeType: DiffChangeType = 'modified';\n  if (oldValue === undefined || oldValue === null) {\n    changeType = 'added';\n  } else if (newValue === undefined || newValue === null) {\n    changeType = 'removed';\n  } else if (typeof oldValue !== typeof newValue) {\n    changeType = 'type_changed';\n  }\n\n  return {\n    path,\n    type: changeType,\n    oldValue,\n    newValue,\n    description,\n  };\n}\n\n/**\n * Diff two objects recursively.\n */\nfunction diffObjects(\n  path: string,\n  oldObj: Record<string, unknown> | undefined,\n  newObj: Record<string, unknown> | undefined,\n  options: DiffOptions\n): DiffChange[] {\n  const changes: DiffChange[] = [];\n\n  if (!oldObj && !newObj) return changes;\n  if (!oldObj) {\n    changes.push({\n      path,\n      type: 'added',\n      newValue: newObj,\n      description: `Added ${path}`,\n    });\n    return changes;\n  }\n  if (!newObj) {\n    changes.push({\n      path,\n      type: 'removed',\n      oldValue: oldObj,\n      description: `Removed ${path}`,\n    });\n    return changes;\n  }\n\n  const allKeys = new Set([...Object.keys(oldObj), ...Object.keys(newObj)]);\n\n  for (const key of allKeys) {\n    const keyPath = path ? `${path}.${key}` : key;\n\n    // Skip ignored paths\n    if (options.ignorePaths?.some((p) => keyPath.startsWith(p))) {\n      continue;\n    }\n\n    const oldVal = oldObj[key];\n    const newVal = newObj[key];\n\n    if (typeof oldVal === 'object' && typeof newVal === 'object') {\n      changes.push(\n        ...diffObjects(\n          keyPath,\n          oldVal as Record<string, unknown>,\n          newVal as Record<string, unknown>,\n          options\n        )\n      );\n    } else {\n      const change = compareValues(\n        keyPath,\n        oldVal,\n        newVal,\n        `Changed ${keyPath}`\n      );\n      if (change) {\n        changes.push(change);\n      }\n    }\n  }\n\n  return changes;\n}\n\n/**\n * Diff a ContractSpec against an OpenAPI operation.\n */\nexport function diffSpecVsOperation(\n  spec: AnyContractSpec,\n  operation: ParsedOperation,\n  options: DiffOptions = {}\n): DiffChange[] {\n  const changes: DiffChange[] = [];\n\n  // Compare basic metadata\n  if (!options.ignoreDescriptions) {\n    const descChange = compareValues(\n      'meta.description',\n      spec.meta.description,\n      operation.summary ?? operation.description,\n      'Description changed'\n    );\n    if (descChange) changes.push(descChange);\n  }\n\n  if (!options.ignoreTags) {\n    const oldTags = [...(spec.meta.tags ?? [])].sort();\n    const newTags = [...operation.tags].sort();\n    if (!deepEqual(oldTags, newTags)) {\n      changes.push({\n        path: 'meta.tags',\n        type: 'modified',\n        oldValue: oldTags,\n        newValue: newTags,\n        description: 'Tags changed',\n      });\n    }\n  }\n\n  // Compare transport\n  if (!options.ignoreTransport) {\n    const specMethod =\n      spec.transport?.rest?.method ??\n      (spec.meta.kind === 'query' ? 'GET' : 'POST');\n    const opMethod = operation.method.toUpperCase();\n\n    if (specMethod !== opMethod) {\n      changes.push({\n        path: 'transport.rest.method',\n        type: 'modified',\n        oldValue: specMethod,\n        newValue: opMethod,\n        description: 'HTTP method changed',\n      });\n    }\n\n    const specPath = spec.transport?.rest?.path;\n    if (specPath && specPath !== operation.path) {\n      changes.push({\n        path: 'transport.rest.path',\n        type: 'modified',\n        oldValue: specPath,\n        newValue: operation.path,\n        description: 'Path changed',\n      });\n    }\n  }\n\n  // Compare deprecation status\n  const specDeprecated = spec.meta.stability === 'deprecated';\n  if (specDeprecated !== operation.deprecated) {\n    changes.push({\n      path: 'meta.stability',\n      type: 'modified',\n      oldValue: spec.meta.stability,\n      newValue: operation.deprecated ? 'deprecated' : 'stable',\n      description: 'Deprecation status changed',\n    });\n  }\n\n  return changes;\n}\n\n/**\n * Diff two ContractSpecs.\n */\nexport function diffSpecs(\n  oldSpec: AnyContractSpec,\n  newSpec: AnyContractSpec,\n  options: DiffOptions = {}\n): DiffChange[] {\n  const changes: DiffChange[] = [];\n\n  // Compare meta\n  const metaChanges = diffObjects(\n    'meta',\n    oldSpec.meta as unknown as Record<string, unknown>,\n    newSpec.meta as unknown as Record<string, unknown>,\n    {\n      ...options,\n      ignorePaths: [\n        ...(options.ignorePaths ?? []),\n        ...(options.ignoreDescriptions\n          ? ['meta.description', 'meta.goal', 'meta.context']\n          : []),\n        ...(options.ignoreTags ? ['meta.tags'] : []),\n      ],\n    }\n  );\n  changes.push(...metaChanges);\n\n  // Compare transport\n  if (!options.ignoreTransport) {\n    const transportChanges = diffObjects(\n      'transport',\n      oldSpec.transport as unknown as Record<string, unknown>,\n      newSpec.transport as unknown as Record<string, unknown>,\n      options\n    );\n    changes.push(...transportChanges);\n  }\n\n  // Compare policy\n  const policyChanges = diffObjects(\n    'policy',\n    oldSpec.policy as unknown as Record<string, unknown>,\n    newSpec.policy as unknown as Record<string, unknown>,\n    options\n  );\n  changes.push(...policyChanges);\n\n  return changes;\n}\n\n/**\n * Create a SpecDiff from an existing spec and an imported spec.\n */\nexport function createSpecDiff(\n  operationId: string,\n  existing: AnyContractSpec | undefined,\n  incoming: ImportedSpec,\n  options: DiffOptions = {}\n): SpecDiff {\n  let changes: DiffChange[] = [];\n  let isEquivalent = false;\n\n  if (existing) {\n    // Compare existing vs incoming\n    changes = diffSpecs(existing, incoming.spec, options);\n    isEquivalent = changes.length === 0;\n  } else {\n    // New spec - mark as added\n    changes = [\n      {\n        path: '',\n        type: 'added',\n        newValue: incoming.spec,\n        description: 'New spec imported from OpenAPI',\n      },\n    ];\n  }\n\n  return {\n    operationId,\n    existing,\n    incoming,\n    changes,\n    isEquivalent,\n  };\n}\n\n/**\n * Batch diff multiple specs against OpenAPI operations.\n */\nexport function diffAll(\n  existingSpecs: Map<string, AnyContractSpec>,\n  importedSpecs: ImportedSpec[],\n  options: DiffOptions = {}\n): SpecDiff[] {\n  const diffs: SpecDiff[] = [];\n\n  // Track which existing specs have been matched\n  const matchedExisting = new Set<string>();\n\n  for (const imported of importedSpecs) {\n    const operationId = imported.source.sourceId;\n\n    // Try to find matching existing spec\n    // Match by operationId in x-contractspec extension or by name\n    let existing: AnyContractSpec | undefined;\n\n    for (const [key, spec] of existingSpecs) {\n      // Check x-contractspec match or name match\n      const specName = spec.meta.name;\n      if (key === operationId || specName.includes(operationId)) {\n        existing = spec;\n        matchedExisting.add(key);\n        break;\n      }\n    }\n\n    diffs.push(createSpecDiff(operationId, existing, imported, options));\n  }\n\n  // Add diffs for existing specs that weren't matched (removed from OpenAPI)\n  for (const [key, spec] of existingSpecs) {\n    if (!matchedExisting.has(key)) {\n      diffs.push({\n        operationId: key,\n        existing: spec,\n        incoming: undefined as unknown as ImportedSpec,\n        changes: [\n          {\n            path: '',\n            type: 'removed',\n            oldValue: spec,\n            description: 'Spec no longer exists in OpenAPI source',\n          },\n        ],\n        isEquivalent: false,\n      });\n    }\n  }\n\n  return diffs;\n}\n\n/**\n * Format diff changes for display.\n */\nexport function formatDiffChanges(changes: DiffChange[]): string {\n  if (changes.length === 0) {\n    return 'No changes detected';\n  }\n\n  const lines: string[] = [];\n\n  for (const change of changes) {\n    const prefix = {\n      added: '+',\n      removed: '-',\n      modified: '~',\n      type_changed: '!',\n      required_changed: '?',\n    }[change.type];\n\n    lines.push(`${prefix} ${change.path}: ${change.description}`);\n\n    if (change.type === 'modified' || change.type === 'type_changed') {\n      lines.push(`    old: ${JSON.stringify(change.oldValue)}`);\n      lines.push(`    new: ${JSON.stringify(change.newValue)}`);\n    } else if (change.type === 'added') {\n      lines.push(`    value: ${JSON.stringify(change.newValue)}`);\n    } else if (change.type === 'removed') {\n      lines.push(`    was: ${JSON.stringify(change.oldValue)}`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n"],"mappings":"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"}
+{"version":3,"file":"differ.js","names":["changeType: DiffChangeType","changes: DiffChange[]","diffs: SpecDiff[]","existing: AnyOperationSpec | undefined","lines: string[]"],"sources":["../../src/openapi/differ.ts"],"sourcesContent":["/**\n * Diff ContractSpec specs against OpenAPI operations.\n * Used for sync operations to detect changes.\n */\n\nimport type { AnyOperationSpec } from '@lssm/lib.contracts';\nimport type { ParsedOperation } from './types';\nimport type {\n  DiffChange,\n  DiffChangeType,\n  ImportedOperationSpec,\n  SpecDiff,\n} from '../common/types';\nimport { deepEqual } from '../common/utils';\n\n/**\n * Options for diffing specs.\n */\nexport interface DiffOptions {\n  /** Ignore description changes */\n  ignoreDescriptions?: boolean;\n  /** Ignore tag changes */\n  ignoreTags?: boolean;\n  /** Ignore transport changes (path, method) */\n  ignoreTransport?: boolean;\n  /** Custom paths to ignore */\n  ignorePaths?: string[];\n}\n\n/**\n * Compare two values and generate a diff change if different.\n */\nfunction compareValues(\n  path: string,\n  oldValue: unknown,\n  newValue: unknown,\n  description: string\n): DiffChange | null {\n  if (deepEqual(oldValue, newValue)) {\n    return null;\n  }\n\n  let changeType: DiffChangeType = 'modified';\n  if (oldValue === undefined || oldValue === null) {\n    changeType = 'added';\n  } else if (newValue === undefined || newValue === null) {\n    changeType = 'removed';\n  } else if (typeof oldValue !== typeof newValue) {\n    changeType = 'type_changed';\n  }\n\n  return {\n    path,\n    type: changeType,\n    oldValue,\n    newValue,\n    description,\n  };\n}\n\n/**\n * Diff two objects recursively.\n */\nfunction diffObjects(\n  path: string,\n  oldObj: Record<string, unknown> | undefined,\n  newObj: Record<string, unknown> | undefined,\n  options: DiffOptions\n): DiffChange[] {\n  const changes: DiffChange[] = [];\n\n  if (!oldObj && !newObj) return changes;\n  if (!oldObj) {\n    changes.push({\n      path,\n      type: 'added',\n      newValue: newObj,\n      description: `Added ${path}`,\n    });\n    return changes;\n  }\n  if (!newObj) {\n    changes.push({\n      path,\n      type: 'removed',\n      oldValue: oldObj,\n      description: `Removed ${path}`,\n    });\n    return changes;\n  }\n\n  const allKeys = new Set([...Object.keys(oldObj), ...Object.keys(newObj)]);\n\n  for (const key of allKeys) {\n    const keyPath = path ? `${path}.${key}` : key;\n\n    // Skip ignored paths\n    if (options.ignorePaths?.some((p) => keyPath.startsWith(p))) {\n      continue;\n    }\n\n    const oldVal = oldObj[key];\n    const newVal = newObj[key];\n\n    if (typeof oldVal === 'object' && typeof newVal === 'object') {\n      changes.push(\n        ...diffObjects(\n          keyPath,\n          oldVal as Record<string, unknown>,\n          newVal as Record<string, unknown>,\n          options\n        )\n      );\n    } else {\n      const change = compareValues(\n        keyPath,\n        oldVal,\n        newVal,\n        `Changed ${keyPath}`\n      );\n      if (change) {\n        changes.push(change);\n      }\n    }\n  }\n\n  return changes;\n}\n\n/**\n * Diff a ContractSpec against an OpenAPI operation.\n */\nexport function diffSpecVsOperation(\n  spec: AnyOperationSpec,\n  operation: ParsedOperation,\n  options: DiffOptions = {}\n): DiffChange[] {\n  const changes: DiffChange[] = [];\n\n  // Compare basic metadata\n  if (!options.ignoreDescriptions) {\n    const descChange = compareValues(\n      'meta.description',\n      spec.meta.description,\n      operation.summary ?? operation.description,\n      'Description changed'\n    );\n    if (descChange) changes.push(descChange);\n  }\n\n  if (!options.ignoreTags) {\n    const oldTags = [...(spec.meta.tags ?? [])].sort();\n    const newTags = [...operation.tags].sort();\n    if (!deepEqual(oldTags, newTags)) {\n      changes.push({\n        path: 'meta.tags',\n        type: 'modified',\n        oldValue: oldTags,\n        newValue: newTags,\n        description: 'Tags changed',\n      });\n    }\n  }\n\n  // Compare transport\n  if (!options.ignoreTransport) {\n    const specMethod =\n      spec.transport?.rest?.method ??\n      (spec.meta.kind === 'query' ? 'GET' : 'POST');\n    const opMethod = operation.method.toUpperCase();\n\n    if (specMethod !== opMethod) {\n      changes.push({\n        path: 'transport.rest.method',\n        type: 'modified',\n        oldValue: specMethod,\n        newValue: opMethod,\n        description: 'HTTP method changed',\n      });\n    }\n\n    const specPath = spec.transport?.rest?.path;\n    if (specPath && specPath !== operation.path) {\n      changes.push({\n        path: 'transport.rest.path',\n        type: 'modified',\n        oldValue: specPath,\n        newValue: operation.path,\n        description: 'Path changed',\n      });\n    }\n  }\n\n  // Compare deprecation status\n  const specDeprecated = spec.meta.stability === 'deprecated';\n  if (specDeprecated !== operation.deprecated) {\n    changes.push({\n      path: 'meta.stability',\n      type: 'modified',\n      oldValue: spec.meta.stability,\n      newValue: operation.deprecated ? 'deprecated' : 'stable',\n      description: 'Deprecation status changed',\n    });\n  }\n\n  return changes;\n}\n\n/**\n * Diff two ContractSpecs.\n */\nexport function diffSpecs(\n  oldSpec: AnyOperationSpec,\n  newSpec: AnyOperationSpec,\n  options: DiffOptions = {}\n): DiffChange[] {\n  const changes: DiffChange[] = [];\n\n  // Compare meta\n  const metaChanges = diffObjects(\n    'meta',\n    oldSpec.meta as unknown as Record<string, unknown>,\n    newSpec.meta as unknown as Record<string, unknown>,\n    {\n      ...options,\n      ignorePaths: [\n        ...(options.ignorePaths ?? []),\n        ...(options.ignoreDescriptions\n          ? ['meta.description', 'meta.goal', 'meta.context']\n          : []),\n        ...(options.ignoreTags ? ['meta.tags'] : []),\n      ],\n    }\n  );\n  changes.push(...metaChanges);\n\n  // Compare transport\n  if (!options.ignoreTransport) {\n    const transportChanges = diffObjects(\n      'transport',\n      oldSpec.transport as unknown as Record<string, unknown>,\n      newSpec.transport as unknown as Record<string, unknown>,\n      options\n    );\n    changes.push(...transportChanges);\n  }\n\n  // Compare policy\n  const policyChanges = diffObjects(\n    'policy',\n    oldSpec.policy as unknown as Record<string, unknown>,\n    newSpec.policy as unknown as Record<string, unknown>,\n    options\n  );\n  changes.push(...policyChanges);\n\n  return changes;\n}\n\n/**\n * Create a SpecDiff from an existing spec and an imported spec.\n */\nexport function createSpecDiff(\n  operationId: string,\n  existing: AnyOperationSpec | undefined,\n  incoming: ImportedOperationSpec,\n  options: DiffOptions = {}\n): SpecDiff {\n  let changes: DiffChange[] = [];\n  let isEquivalent = false;\n\n  if (existing && incoming.operationSpec) {\n    // Compare existing vs incoming\n    changes = diffSpecs(existing, incoming.operationSpec, options);\n    isEquivalent = changes.length === 0;\n  } else if (existing && !incoming.operationSpec) {\n    // Incoming has code but no runtime spec - can't compare directly\n    changes = [\n      {\n        path: '',\n        type: 'modified',\n        oldValue: existing,\n        newValue: incoming.code,\n        description:\n          'Spec code imported from OpenAPI (runtime comparison not available)',\n      },\n    ];\n  } else {\n    // New spec - mark as added\n    changes = [\n      {\n        path: '',\n        type: 'added',\n        newValue: incoming.operationSpec ?? incoming.code,\n        description: 'New spec imported from OpenAPI',\n      },\n    ];\n  }\n\n  return {\n    operationId,\n    existing,\n    incoming,\n    changes,\n    isEquivalent,\n  };\n}\n\n/**\n * Batch diff multiple specs against OpenAPI operations.\n */\nexport function diffAll(\n  existingSpecs: Map<string, AnyOperationSpec>,\n  importedSpecs: ImportedOperationSpec[],\n  options: DiffOptions = {}\n): SpecDiff[] {\n  const diffs: SpecDiff[] = [];\n\n  // Track which existing specs have been matched\n  const matchedExisting = new Set<string>();\n\n  for (const imported of importedSpecs) {\n    const operationId = imported.source.sourceId;\n\n    // Try to find matching existing spec\n    // Match by operationId in x-contractspec extension or by name\n    let existing: AnyOperationSpec | undefined;\n\n    for (const [key, spec] of existingSpecs) {\n      // Check x-contractspec match or name match\n      const specName = spec.meta.name;\n      if (key === operationId || specName.includes(operationId)) {\n        existing = spec;\n        matchedExisting.add(key);\n        break;\n      }\n    }\n\n    diffs.push(createSpecDiff(operationId, existing, imported, options));\n  }\n\n  // Add diffs for existing specs that weren't matched (removed from OpenAPI)\n  for (const [key, spec] of existingSpecs) {\n    if (!matchedExisting.has(key)) {\n      diffs.push({\n        operationId: key,\n        existing: spec,\n        incoming: undefined as unknown as ImportedOperationSpec,\n        changes: [\n          {\n            path: '',\n            type: 'removed',\n            oldValue: spec,\n            description: 'Spec no longer exists in OpenAPI source',\n          },\n        ],\n        isEquivalent: false,\n      });\n    }\n  }\n\n  return diffs;\n}\n\n/**\n * Format diff changes for display.\n */\nexport function formatDiffChanges(changes: DiffChange[]): string {\n  if (changes.length === 0) {\n    return 'No changes detected';\n  }\n\n  const lines: string[] = [];\n\n  for (const change of changes) {\n    const prefix = {\n      added: '+',\n      removed: '-',\n      modified: '~',\n      type_changed: '!',\n      required_changed: '?',\n    }[change.type];\n\n    lines.push(`${prefix} ${change.path}: ${change.description}`);\n\n    if (change.type === 'modified' || change.type === 'type_changed') {\n      lines.push(`    old: ${JSON.stringify(change.oldValue)}`);\n      lines.push(`    new: ${JSON.stringify(change.newValue)}`);\n    } else if (change.type === 'added') {\n      lines.push(`    value: ${JSON.stringify(change.newValue)}`);\n    } else if (change.type === 'removed') {\n      lines.push(`    was: ${JSON.stringify(change.oldValue)}`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n"],"mappings":";;;;;;AAgCA,SAAS,cACP,MACA,UACA,UACA,aACmB;AACnB,KAAI,UAAU,UAAU,SAAS,CAC/B,QAAO;CAGT,IAAIA,aAA6B;AACjC,KAAI,aAAa,UAAa,aAAa,KACzC,cAAa;UACJ,aAAa,UAAa,aAAa,KAChD,cAAa;UACJ,OAAO,aAAa,OAAO,SACpC,cAAa;AAGf,QAAO;EACL;EACA,MAAM;EACN;EACA;EACA;EACD;;;;;AAMH,SAAS,YACP,MACA,QACA,QACA,SACc;CACd,MAAMC,UAAwB,EAAE;AAEhC,KAAI,CAAC,UAAU,CAAC,OAAQ,QAAO;AAC/B,KAAI,CAAC,QAAQ;AACX,UAAQ,KAAK;GACX;GACA,MAAM;GACN,UAAU;GACV,aAAa,SAAS;GACvB,CAAC;AACF,SAAO;;AAET,KAAI,CAAC,QAAQ;AACX,UAAQ,KAAK;GACX;GACA,MAAM;GACN,UAAU;GACV,aAAa,WAAW;GACzB,CAAC;AACF,SAAO;;CAGT,MAAM,UAAU,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,OAAO,EAAE,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC;AAEzE,MAAK,MAAM,OAAO,SAAS;EACzB,MAAM,UAAU,OAAO,GAAG,KAAK,GAAG,QAAQ;AAG1C,MAAI,QAAQ,aAAa,MAAM,MAAM,QAAQ,WAAW,EAAE,CAAC,CACzD;EAGF,MAAM,SAAS,OAAO;EACtB,MAAM,SAAS,OAAO;AAEtB,MAAI,OAAO,WAAW,YAAY,OAAO,WAAW,SAClD,SAAQ,KACN,GAAG,YACD,SACA,QACA,QACA,QACD,CACF;OACI;GACL,MAAM,SAAS,cACb,SACA,QACA,QACA,WAAW,UACZ;AACD,OAAI,OACF,SAAQ,KAAK,OAAO;;;AAK1B,QAAO;;;;;AAMT,SAAgB,oBACd,MACA,WACA,UAAuB,EAAE,EACX;CACd,MAAMA,UAAwB,EAAE;AAGhC,KAAI,CAAC,QAAQ,oBAAoB;EAC/B,MAAM,aAAa,cACjB,oBACA,KAAK,KAAK,aACV,UAAU,WAAW,UAAU,aAC/B,sBACD;AACD,MAAI,WAAY,SAAQ,KAAK,WAAW;;AAG1C,KAAI,CAAC,QAAQ,YAAY;EACvB,MAAM,UAAU,CAAC,GAAI,KAAK,KAAK,QAAQ,EAAE,CAAE,CAAC,MAAM;EAClD,MAAM,UAAU,CAAC,GAAG,UAAU,KAAK,CAAC,MAAM;AAC1C,MAAI,CAAC,UAAU,SAAS,QAAQ,CAC9B,SAAQ,KAAK;GACX,MAAM;GACN,MAAM;GACN,UAAU;GACV,UAAU;GACV,aAAa;GACd,CAAC;;AAKN,KAAI,CAAC,QAAQ,iBAAiB;EAC5B,MAAM,aACJ,KAAK,WAAW,MAAM,WACrB,KAAK,KAAK,SAAS,UAAU,QAAQ;EACxC,MAAM,WAAW,UAAU,OAAO,aAAa;AAE/C,MAAI,eAAe,SACjB,SAAQ,KAAK;GACX,MAAM;GACN,MAAM;GACN,UAAU;GACV,UAAU;GACV,aAAa;GACd,CAAC;EAGJ,MAAM,WAAW,KAAK,WAAW,MAAM;AACvC,MAAI,YAAY,aAAa,UAAU,KACrC,SAAQ,KAAK;GACX,MAAM;GACN,MAAM;GACN,UAAU;GACV,UAAU,UAAU;GACpB,aAAa;GACd,CAAC;;AAMN,KADuB,KAAK,KAAK,cAAc,iBACxB,UAAU,WAC/B,SAAQ,KAAK;EACX,MAAM;EACN,MAAM;EACN,UAAU,KAAK,KAAK;EACpB,UAAU,UAAU,aAAa,eAAe;EAChD,aAAa;EACd,CAAC;AAGJ,QAAO;;;;;AAMT,SAAgB,UACd,SACA,SACA,UAAuB,EAAE,EACX;CACd,MAAMA,UAAwB,EAAE;CAGhC,MAAM,cAAc,YAClB,QACA,QAAQ,MACR,QAAQ,MACR;EACE,GAAG;EACH,aAAa;GACX,GAAI,QAAQ,eAAe,EAAE;GAC7B,GAAI,QAAQ,qBACR;IAAC;IAAoB;IAAa;IAAe,GACjD,EAAE;GACN,GAAI,QAAQ,aAAa,CAAC,YAAY,GAAG,EAAE;GAC5C;EACF,CACF;AACD,SAAQ,KAAK,GAAG,YAAY;AAG5B,KAAI,CAAC,QAAQ,iBAAiB;EAC5B,MAAM,mBAAmB,YACvB,aACA,QAAQ,WACR,QAAQ,WACR,QACD;AACD,UAAQ,KAAK,GAAG,iBAAiB;;CAInC,MAAM,gBAAgB,YACpB,UACA,QAAQ,QACR,QAAQ,QACR,QACD;AACD,SAAQ,KAAK,GAAG,cAAc;AAE9B,QAAO;;;;;AAMT,SAAgB,eACd,aACA,UACA,UACA,UAAuB,EAAE,EACf;CACV,IAAIA,UAAwB,EAAE;CAC9B,IAAI,eAAe;AAEnB,KAAI,YAAY,SAAS,eAAe;AAEtC,YAAU,UAAU,UAAU,SAAS,eAAe,QAAQ;AAC9D,iBAAe,QAAQ,WAAW;YACzB,YAAY,CAAC,SAAS,cAE/B,WAAU,CACR;EACE,MAAM;EACN,MAAM;EACN,UAAU;EACV,UAAU,SAAS;EACnB,aACE;EACH,CACF;KAGD,WAAU,CACR;EACE,MAAM;EACN,MAAM;EACN,UAAU,SAAS,iBAAiB,SAAS;EAC7C,aAAa;EACd,CACF;AAGH,QAAO;EACL;EACA;EACA;EACA;EACA;EACD;;;;;AAMH,SAAgB,QACd,eACA,eACA,UAAuB,EAAE,EACb;CACZ,MAAMC,QAAoB,EAAE;CAG5B,MAAM,kCAAkB,IAAI,KAAa;AAEzC,MAAK,MAAM,YAAY,eAAe;EACpC,MAAM,cAAc,SAAS,OAAO;EAIpC,IAAIC;AAEJ,OAAK,MAAM,CAAC,KAAK,SAAS,eAAe;GAEvC,MAAM,WAAW,KAAK,KAAK;AAC3B,OAAI,QAAQ,eAAe,SAAS,SAAS,YAAY,EAAE;AACzD,eAAW;AACX,oBAAgB,IAAI,IAAI;AACxB;;;AAIJ,QAAM,KAAK,eAAe,aAAa,UAAU,UAAU,QAAQ,CAAC;;AAItE,MAAK,MAAM,CAAC,KAAK,SAAS,cACxB,KAAI,CAAC,gBAAgB,IAAI,IAAI,CAC3B,OAAM,KAAK;EACT,aAAa;EACb,UAAU;EACV,UAAU;EACV,SAAS,CACP;GACE,MAAM;GACN,MAAM;GACN,UAAU;GACV,aAAa;GACd,CACF;EACD,cAAc;EACf,CAAC;AAIN,QAAO;;;;;AAMT,SAAgB,kBAAkB,SAA+B;AAC/D,KAAI,QAAQ,WAAW,EACrB,QAAO;CAGT,MAAMC,QAAkB,EAAE;AAE1B,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,SAAS;GACb,OAAO;GACP,SAAS;GACT,UAAU;GACV,cAAc;GACd,kBAAkB;GACnB,CAAC,OAAO;AAET,QAAM,KAAK,GAAG,OAAO,GAAG,OAAO,KAAK,IAAI,OAAO,cAAc;AAE7D,MAAI,OAAO,SAAS,cAAc,OAAO,SAAS,gBAAgB;AAChE,SAAM,KAAK,YAAY,KAAK,UAAU,OAAO,SAAS,GAAG;AACzD,SAAM,KAAK,YAAY,KAAK,UAAU,OAAO,SAAS,GAAG;aAChD,OAAO,SAAS,QACzB,OAAM,KAAK,cAAc,KAAK,UAAU,OAAO,SAAS,GAAG;WAClD,OAAO,SAAS,UACzB,OAAM,KAAK,YAAY,KAAK,UAAU,OAAO,SAAS,GAAG;;AAI7D,QAAO,MAAM,KAAK,KAAK"}

package/dist/openapi/exporter.d.ts

@@ -1,5 +1,5 @@
 import { ContractSpecOpenApiDocument, OpenApiExportOptions, OpenApiServer } from "./types.js";
-import { SpecRegistry } from "@lssm/lib.contracts";
+import { OperationSpecRegistry } from "@lssm/lib.contracts";
 
 //#region src/openapi/exporter.d.ts
 
@@ -8,21 +8,21 @@ import { SpecRegistry } from "@lssm/lib.contracts";
  */
 declare function defaultRestPath(name: string, version: number): string;
 /**
- * Export a SpecRegistry to an OpenAPI 3.1 document.
+ * Export a OperationSpecRegistry to an OpenAPI 3.1 document.
  *
- * @param registry - The SpecRegistry containing specs to export
+ * @param registry - The OperationSpecRegistry containing specs to export
  * @param options - Export options (title, version, description, servers)
  * @returns OpenAPI 3.1 document
  */
-declare function openApiForRegistry(registry: SpecRegistry, options?: OpenApiExportOptions): ContractSpecOpenApiDocument;
+declare function openApiForRegistry(registry: OperationSpecRegistry, options?: OpenApiExportOptions): ContractSpecOpenApiDocument;
 /**
- * Export a SpecRegistry to OpenAPI JSON string.
+ * Export a OperationSpecRegistry to OpenAPI JSON string.
  */
-declare function openApiToJson(registry: SpecRegistry, options?: OpenApiExportOptions): string;
+declare function openApiToJson(registry: OperationSpecRegistry, options?: OpenApiExportOptions): string;
 /**
- * Export a SpecRegistry to OpenAPI YAML string.
+ * Export a OperationSpecRegistry to OpenAPI YAML string.
  */
-declare function openApiToYaml(registry: SpecRegistry, options?: OpenApiExportOptions): string;
+declare function openApiToYaml(registry: OperationSpecRegistry, options?: OpenApiExportOptions): string;
 //#endregion
 export { defaultRestPath, 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":";;;;;;;;AAqH8B,iBAjEd,eAAA,CAiEc,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AA+F9B;AAWA;;;;;;iBA7GgB,kBAAA,WACJ,iCACD,uBACR;;;;iBA+Fa,aAAA,WACJ,iCACD;;;;iBASK,aAAA,WACJ,iCACD"}

package/dist/openapi/exporter.js

@@ -57,9 +57,9 @@ function jsonSchemaForSpec(spec) {
 	};
 }
 /**
-* Export a SpecRegistry to an OpenAPI 3.1 document.
+* Export a OperationSpecRegistry to an OpenAPI 3.1 document.
 *
-* @param registry - The SpecRegistry containing specs to export
+* @param registry - The OperationSpecRegistry containing specs to export
 * @param options - Export options (title, version, description, servers)
 * @returns OpenAPI 3.1 document
 */
@@ -120,14 +120,14 @@ function openApiForRegistry(registry, options = {}) {
 	return doc;
 }
 /**
-* 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));

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":["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  AnyOperationSpec,\n  OperationSpec,\n  OperationSpecRegistry,\n} from '@lssm/lib.contracts';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport { z } from 'zod';\nimport type {\n  ContractSpecOpenApiDocument,\n  OpenApiExportOptions,\n  OpenApiServer,\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: AnyOperationSpec): 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: OperationSpec<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 OperationSpecRegistry to an OpenAPI 3.1 document.\n *\n * @param registry - The OperationSpecRegistry 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: OperationSpecRegistry,\n  options: OpenApiExportOptions = {}\n): ContractSpecOpenApiDocument {\n  const specs = registry\n    .listSpecs()\n    .filter(\n      (s): s is AnyOperationSpec =>\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 OperationSpec<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 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 * 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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"}

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/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":";;;;;;;;;AA6NC,cAlMY,iBAkMZ,EAAA,CAAA,WAAA,EAjMc,WAiMd,EAAA,mBAAA,EAhMsB,iBAgMtB,EAAA,aAAA,CAAA,EA/LgB,OA+LhB,CA/LwB,mBA+LxB,CAAA,EAAA,GA9LE,YA8LF;AAKD;;;AAEW,iBAFK,eAAA,CAEL,SAAA,EADE,eACF,EAAA,OAAA,EAAA,OAAA,CAAQ,mBAAR,CAAA,GAAA,SAAA,EAAA,mBAAA,EACY,iBADZ,CAAA,EAAA,MAAA"}