@lssm/lib.contracts-transformers 1.42.2 → 1.42.4

package/dist/common/index.d.ts

@@ -1,3 +1,3 @@
 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, ImportedOperationSpec, SpecDiff, SpecSource, SyncResult, TransportHints, ValidationResult, deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier };
+import { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecKey, toValidIdentifier } from "./utils.js";
+export { DiffChange, DiffChangeType, ImportResult, ImportedOperationSpec, SpecDiff, SpecSource, SyncResult, TransportHints, ValidationResult, deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecKey, toValidIdentifier };

package/dist/common/index.js

@@ -1,3 +1,3 @@
-import { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier } from "./utils.js";
+import { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecKey, toValidIdentifier } from "./utils.js";
 
-export { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier };
+export { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecKey, toValidIdentifier };

package/dist/common/utils.d.ts

@@ -23,9 +23,9 @@ declare function toSnakeCase(str: string): string;
  */
 declare function toValidIdentifier(str: string): string;
 /**
- * Generate a ContractSpec name from an operation identifier.
+ * Generate a ContractSpec key from an operation identifier.
  */
-declare function toSpecName(operationId: string, prefix?: string): string;
+declare function toSpecKey(operationId: string, prefix?: string): string;
 /**
  * Generate a file name from a spec name.
  */
@@ -48,5 +48,5 @@ declare function extractPathParams(path: string): string[];
  */
 declare function normalizePath(path: string): string;
 //#endregion
-export { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier };
+export { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecKey, toValidIdentifier };
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","names":[],"sources":["../../src/common/utils.ts"],"sourcesContent":[],"mappings":";;AAOA;AASA;AAQA;AAUA;AAUA;AAagB,iBAlDA,YAAA,CAkDU,GAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAQ1B;AAOA;AA4BA;AAiBgB,iBArGA,WAAA,CAqGiB,GAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAQjC;;;iBArGgB,WAAA;;;;iBAUA,WAAA;;;;iBAUA,iBAAA;;;;iBAaA,UAAA;;;;iBAQA,UAAA;;;;iBAOA,SAAA;;;;iBA4BA,SAAA;;;;;iBAiBA,iBAAA;;;;iBAQA,aAAA"}
+{"version":3,"file":"utils.d.ts","names":[],"sources":["../../src/common/utils.ts"],"sourcesContent":[],"mappings":";;AAOA;AASA;AAQA;AAUA;AAUA;AAagB,iBAlDA,YAAA,CAkDS,GAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAQzB;AAOA;AA4BA;AAiBgB,iBArGA,WAAA,CAqGiB,GAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAQjC;;;iBArGgB,WAAA;;;;iBAUA,WAAA;;;;iBAUA,iBAAA;;;;iBAaA,SAAA;;;;iBAQA,UAAA;;;;iBAOA,SAAA;;;;iBA4BA,SAAA;;;;;iBAiBA,iBAAA;;;;iBAQA,aAAA"}

package/dist/common/utils.js

@@ -36,11 +36,11 @@ function toValidIdentifier(str) {
 	return result;
 }
 /**
-* Generate a ContractSpec name from an operation identifier.
+* Generate a ContractSpec key from an operation identifier.
 */
-function toSpecName(operationId, prefix) {
-	const name = toCamelCase(operationId);
-	return prefix ? `${prefix}.${name}` : name;
+function toSpecKey(operationId, prefix) {
+	const key = toCamelCase(operationId);
+	return prefix ? `${prefix}.${key}` : key;
 }
 /**
 * Generate a file name from a spec name.
@@ -99,5 +99,5 @@ function normalizePath(path) {
 }
 
 //#endregion
-export { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier };
+export { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecKey, toValidIdentifier };
 //# sourceMappingURL=utils.js.map

package/dist/common/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":["current: unknown"],"sources":["../../src/common/utils.ts"],"sourcesContent":["/**\n * Common utilities for contract transformations.\n */\n\n/**\n * Convert a string to PascalCase.\n */\nexport function toPascalCase(str: string): string {\n  return str\n    .replace(/[-_./\\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ''))\n    .replace(/^./, (c) => c.toUpperCase());\n}\n\n/**\n * Convert a string to camelCase.\n */\nexport function toCamelCase(str: string): string {\n  const pascal = toPascalCase(str);\n  return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\n/**\n * Convert a string to kebab-case.\n */\nexport function toKebabCase(str: string): string {\n  return str\n    .replace(/([a-z])([A-Z])/g, '$1-$2')\n    .replace(/[\\s_./]+/g, '-')\n    .toLowerCase();\n}\n\n/**\n * Convert a string to snake_case.\n */\nexport function toSnakeCase(str: string): string {\n  return str\n    .replace(/([a-z])([A-Z])/g, '$1_$2')\n    .replace(/[\\s\\-./]+/g, '_')\n    .toLowerCase();\n}\n\n/**\n * Sanitize a string to be a valid TypeScript identifier.\n */\nexport function toValidIdentifier(str: string): string {\n  // Remove invalid characters\n  let result = str.replace(/[^a-zA-Z0-9_$]/g, '_');\n  // Ensure it doesn't start with a number\n  if (/^[0-9]/.test(result)) {\n    result = '_' + result;\n  }\n  return result;\n}\n\n/**\n * Generate a ContractSpec name from an operation identifier.\n */\nexport function toSpecName(operationId: string, prefix?: string): string {\n  const name = toCamelCase(operationId);\n  return prefix ? `${prefix}.${name}` : name;\n}\n\n/**\n * Generate a file name from a spec name.\n */\nexport function toFileName(specName: string): string {\n  return toKebabCase(specName.replace(/\\./g, '-')) + '.ts';\n}\n\n/**\n * Deep equality check for objects.\n */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (a === null || b === null) return false;\n  if (typeof a !== typeof b) return false;\n\n  if (typeof a === 'object') {\n    const aObj = a as Record<string, unknown>;\n    const bObj = b as Record<string, unknown>;\n\n    const aKeys = Object.keys(aObj);\n    const bKeys = Object.keys(bObj);\n\n    if (aKeys.length !== bKeys.length) return false;\n\n    for (const key of aKeys) {\n      if (!bKeys.includes(key)) return false;\n      if (!deepEqual(aObj[key], bObj[key])) return false;\n    }\n\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Get a value from an object by JSON path.\n */\nexport function getByPath(obj: unknown, path: string): unknown {\n  const parts = path.split('.').filter(Boolean);\n  let current: unknown = obj;\n\n  for (const part of parts) {\n    if (current === null || current === undefined) return undefined;\n    if (typeof current !== 'object') return undefined;\n    current = (current as Record<string, unknown>)[part];\n  }\n\n  return current;\n}\n\n/**\n * Extract path parameters from a URL path template.\n * e.g., \"/users/{userId}/orders/{orderId}\" -> [\"userId\", \"orderId\"]\n */\nexport function extractPathParams(path: string): string[] {\n  const matches = path.match(/\\{([^}]+)\\}/g) || [];\n  return matches.map((m) => m.slice(1, -1));\n}\n\n/**\n * Normalize a URL path for comparison.\n */\nexport function normalizePath(path: string): string {\n  // Remove leading/trailing slashes\n  let normalized = path.replace(/^\\/+|\\/+$/g, '');\n  // Replace multiple slashes with single\n  normalized = normalized.replace(/\\/+/g, '/');\n  // Add leading slash\n  return '/' + normalized;\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,aAAa,KAAqB;AAChD,QAAO,IACJ,QAAQ,mBAAmB,GAAG,MAAO,IAAI,EAAE,aAAa,GAAG,GAAI,CAC/D,QAAQ,OAAO,MAAM,EAAE,aAAa,CAAC;;;;;AAM1C,SAAgB,YAAY,KAAqB;CAC/C,MAAM,SAAS,aAAa,IAAI;AAChC,QAAO,OAAO,OAAO,EAAE,CAAC,aAAa,GAAG,OAAO,MAAM,EAAE;;;;;AAMzD,SAAgB,YAAY,KAAqB;AAC/C,QAAO,IACJ,QAAQ,mBAAmB,QAAQ,CACnC,QAAQ,aAAa,IAAI,CACzB,aAAa;;;;;AAMlB,SAAgB,YAAY,KAAqB;AAC/C,QAAO,IACJ,QAAQ,mBAAmB,QAAQ,CACnC,QAAQ,cAAc,IAAI,CAC1B,aAAa;;;;;AAMlB,SAAgB,kBAAkB,KAAqB;CAErD,IAAI,SAAS,IAAI,QAAQ,mBAAmB,IAAI;AAEhD,KAAI,SAAS,KAAK,OAAO,CACvB,UAAS,MAAM;AAEjB,QAAO;;;;;AAMT,SAAgB,WAAW,aAAqB,QAAyB;CACvE,MAAM,OAAO,YAAY,YAAY;AACrC,QAAO,SAAS,GAAG,OAAO,GAAG,SAAS;;;;;AAMxC,SAAgB,WAAW,UAA0B;AACnD,QAAO,YAAY,SAAS,QAAQ,OAAO,IAAI,CAAC,GAAG;;;;;AAMrD,SAAgB,UAAU,GAAY,GAAqB;AACzD,KAAI,MAAM,EAAG,QAAO;AACpB,KAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AACrC,KAAI,OAAO,MAAM,OAAO,EAAG,QAAO;AAElC,KAAI,OAAO,MAAM,UAAU;EACzB,MAAM,OAAO;EACb,MAAM,OAAO;EAEb,MAAM,QAAQ,OAAO,KAAK,KAAK;EAC/B,MAAM,QAAQ,OAAO,KAAK,KAAK;AAE/B,MAAI,MAAM,WAAW,MAAM,OAAQ,QAAO;AAE1C,OAAK,MAAM,OAAO,OAAO;AACvB,OAAI,CAAC,MAAM,SAAS,IAAI,CAAE,QAAO;AACjC,OAAI,CAAC,UAAU,KAAK,MAAM,KAAK,KAAK,CAAE,QAAO;;AAG/C,SAAO;;AAGT,QAAO;;;;;AAMT,SAAgB,UAAU,KAAc,MAAuB;CAC7D,MAAM,QAAQ,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ;CAC7C,IAAIA,UAAmB;AAEvB,MAAK,MAAM,QAAQ,OAAO;AACxB,MAAI,YAAY,QAAQ,YAAY,OAAW,QAAO;AACtD,MAAI,OAAO,YAAY,SAAU,QAAO;AACxC,YAAW,QAAoC;;AAGjD,QAAO;;;;;;AAOT,SAAgB,kBAAkB,MAAwB;AAExD,SADgB,KAAK,MAAM,eAAe,IAAI,EAAE,EACjC,KAAK,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC;;;;;AAM3C,SAAgB,cAAc,MAAsB;CAElD,IAAI,aAAa,KAAK,QAAQ,cAAc,GAAG;AAE/C,cAAa,WAAW,QAAQ,QAAQ,IAAI;AAE5C,QAAO,MAAM"}
+{"version":3,"file":"utils.js","names":["current: unknown"],"sources":["../../src/common/utils.ts"],"sourcesContent":["/**\n * Common utilities for contract transformations.\n */\n\n/**\n * Convert a string to PascalCase.\n */\nexport function toPascalCase(str: string): string {\n  return str\n    .replace(/[-_./\\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ''))\n    .replace(/^./, (c) => c.toUpperCase());\n}\n\n/**\n * Convert a string to camelCase.\n */\nexport function toCamelCase(str: string): string {\n  const pascal = toPascalCase(str);\n  return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\n/**\n * Convert a string to kebab-case.\n */\nexport function toKebabCase(str: string): string {\n  return str\n    .replace(/([a-z])([A-Z])/g, '$1-$2')\n    .replace(/[\\s_./]+/g, '-')\n    .toLowerCase();\n}\n\n/**\n * Convert a string to snake_case.\n */\nexport function toSnakeCase(str: string): string {\n  return str\n    .replace(/([a-z])([A-Z])/g, '$1_$2')\n    .replace(/[\\s\\-./]+/g, '_')\n    .toLowerCase();\n}\n\n/**\n * Sanitize a string to be a valid TypeScript identifier.\n */\nexport function toValidIdentifier(str: string): string {\n  // Remove invalid characters\n  let result = str.replace(/[^a-zA-Z0-9_$]/g, '_');\n  // Ensure it doesn't start with a number\n  if (/^[0-9]/.test(result)) {\n    result = '_' + result;\n  }\n  return result;\n}\n\n/**\n * Generate a ContractSpec key from an operation identifier.\n */\nexport function toSpecKey(operationId: string, prefix?: string): string {\n  const key = toCamelCase(operationId);\n  return prefix ? `${prefix}.${key}` : key;\n}\n\n/**\n * Generate a file name from a spec name.\n */\nexport function toFileName(specName: string): string {\n  return toKebabCase(specName.replace(/\\./g, '-')) + '.ts';\n}\n\n/**\n * Deep equality check for objects.\n */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (a === null || b === null) return false;\n  if (typeof a !== typeof b) return false;\n\n  if (typeof a === 'object') {\n    const aObj = a as Record<string, unknown>;\n    const bObj = b as Record<string, unknown>;\n\n    const aKeys = Object.keys(aObj);\n    const bKeys = Object.keys(bObj);\n\n    if (aKeys.length !== bKeys.length) return false;\n\n    for (const key of aKeys) {\n      if (!bKeys.includes(key)) return false;\n      if (!deepEqual(aObj[key], bObj[key])) return false;\n    }\n\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Get a value from an object by JSON path.\n */\nexport function getByPath(obj: unknown, path: string): unknown {\n  const parts = path.split('.').filter(Boolean);\n  let current: unknown = obj;\n\n  for (const part of parts) {\n    if (current === null || current === undefined) return undefined;\n    if (typeof current !== 'object') return undefined;\n    current = (current as Record<string, unknown>)[part];\n  }\n\n  return current;\n}\n\n/**\n * Extract path parameters from a URL path template.\n * e.g., \"/users/{userId}/orders/{orderId}\" -> [\"userId\", \"orderId\"]\n */\nexport function extractPathParams(path: string): string[] {\n  const matches = path.match(/\\{([^}]+)\\}/g) || [];\n  return matches.map((m) => m.slice(1, -1));\n}\n\n/**\n * Normalize a URL path for comparison.\n */\nexport function normalizePath(path: string): string {\n  // Remove leading/trailing slashes\n  let normalized = path.replace(/^\\/+|\\/+$/g, '');\n  // Replace multiple slashes with single\n  normalized = normalized.replace(/\\/+/g, '/');\n  // Add leading slash\n  return '/' + normalized;\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,aAAa,KAAqB;AAChD,QAAO,IACJ,QAAQ,mBAAmB,GAAG,MAAO,IAAI,EAAE,aAAa,GAAG,GAAI,CAC/D,QAAQ,OAAO,MAAM,EAAE,aAAa,CAAC;;;;;AAM1C,SAAgB,YAAY,KAAqB;CAC/C,MAAM,SAAS,aAAa,IAAI;AAChC,QAAO,OAAO,OAAO,EAAE,CAAC,aAAa,GAAG,OAAO,MAAM,EAAE;;;;;AAMzD,SAAgB,YAAY,KAAqB;AAC/C,QAAO,IACJ,QAAQ,mBAAmB,QAAQ,CACnC,QAAQ,aAAa,IAAI,CACzB,aAAa;;;;;AAMlB,SAAgB,YAAY,KAAqB;AAC/C,QAAO,IACJ,QAAQ,mBAAmB,QAAQ,CACnC,QAAQ,cAAc,IAAI,CAC1B,aAAa;;;;;AAMlB,SAAgB,kBAAkB,KAAqB;CAErD,IAAI,SAAS,IAAI,QAAQ,mBAAmB,IAAI;AAEhD,KAAI,SAAS,KAAK,OAAO,CACvB,UAAS,MAAM;AAEjB,QAAO;;;;;AAMT,SAAgB,UAAU,aAAqB,QAAyB;CACtE,MAAM,MAAM,YAAY,YAAY;AACpC,QAAO,SAAS,GAAG,OAAO,GAAG,QAAQ;;;;;AAMvC,SAAgB,WAAW,UAA0B;AACnD,QAAO,YAAY,SAAS,QAAQ,OAAO,IAAI,CAAC,GAAG;;;;;AAMrD,SAAgB,UAAU,GAAY,GAAqB;AACzD,KAAI,MAAM,EAAG,QAAO;AACpB,KAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AACrC,KAAI,OAAO,MAAM,OAAO,EAAG,QAAO;AAElC,KAAI,OAAO,MAAM,UAAU;EACzB,MAAM,OAAO;EACb,MAAM,OAAO;EAEb,MAAM,QAAQ,OAAO,KAAK,KAAK;EAC/B,MAAM,QAAQ,OAAO,KAAK,KAAK;AAE/B,MAAI,MAAM,WAAW,MAAM,OAAQ,QAAO;AAE1C,OAAK,MAAM,OAAO,OAAO;AACvB,OAAI,CAAC,MAAM,SAAS,IAAI,CAAE,QAAO;AACjC,OAAI,CAAC,UAAU,KAAK,MAAM,KAAK,KAAK,CAAE,QAAO;;AAG/C,SAAO;;AAGT,QAAO;;;;;AAMT,SAAgB,UAAU,KAAc,MAAuB;CAC7D,MAAM,QAAQ,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ;CAC7C,IAAIA,UAAmB;AAEvB,MAAK,MAAM,QAAQ,OAAO;AACxB,MAAI,YAAY,QAAQ,YAAY,OAAW,QAAO;AACtD,MAAI,OAAO,YAAY,SAAU,QAAO;AACxC,YAAW,QAAoC;;AAGjD,QAAO;;;;;;AAOT,SAAgB,kBAAkB,MAAwB;AAExD,SADgB,KAAK,MAAM,eAAe,IAAI,EAAE,EACjC,KAAK,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC;;;;;AAM3C,SAAgB,cAAc,MAAsB;CAElD,IAAI,aAAa,KAAK,QAAQ,cAAc,GAAG;AAE/C,cAAa,WAAW,QAAQ,QAAQ,IAAI;AAE5C,QAAO,MAAM"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 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 { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecKey, toValidIdentifier } from "./common/utils.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";
@@ -15,4 +15,4 @@ import { RegistryGenerationOptions, generateRegistryIndex } from "./openapi/expo
 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, ContractSpecRegistries, DiffChange, DiffChangeType, DiffOptions, ExportedDataView, ExportedEvent, ExportedFeature, ExportedForm, ExportedPresentation, ExportedWorkflow, GeneratedModel, HttpMethod, ImportResult, ImportedOperationSpec, OpenApiDocument, OpenApiExportOptions, OpenApiOperation, OpenApiParameter, OpenApiParseOptions, OpenApiSchema, OpenApiServer, OpenApiSource, OpenApiTransportHints, OpenApiVersion, OperationsExportResult, ParameterLocation, ParseResult, ParsedOperation, ParsedParameter, RegistryGenerationOptions, SchemaField, SpecDiff, SpecSource, SyncResult, TransportHints, TypescriptType, ValidationResult, contractSpecToJson, contractSpecToYaml, createSpecDiff, deepEqual, defaultRestPath, detectFormat, detectVersion, diffAll, diffSpecVsOperation, diffSpecs, exportContractSpec, exportDataViews, exportEvents, exportFeatures, exportForms, exportOperations, exportPresentations, exportPresentationsFromArray, exportWorkflows, extractPathParams, formatDiffChanges, generateDataViewsRegistry, generateEventsExports, generateFeaturesRegistry, generateFormsRegistry, generateImports, generateOperationsRegistry, generatePresentationsRegistry, generateRegistryIndex, generateSchemaModelCode, generateWorkflowsRegistry, getByPath, getScalarType, importFromOpenApi, importOperation, jsonSchemaForSpec, jsonSchemaToField, jsonSchemaToType, normalizePath, openApiForRegistry, openApiToJson, openApiToYaml, parseOpenApi, parseOpenApiDocument, parseOpenApiString, schemaModelToJsonSchema, toCamelCase, toFileName, toHttpMethod, toKebabCase, toOperationId, toPascalCase, toRestPath, toSchemaName, toSnakeCase, toSpecName, toValidIdentifier };
+export { ContractSpecOpenApiDocument, ContractSpecRegistries, DiffChange, DiffChangeType, DiffOptions, ExportedDataView, ExportedEvent, ExportedFeature, ExportedForm, ExportedPresentation, ExportedWorkflow, GeneratedModel, HttpMethod, ImportResult, ImportedOperationSpec, OpenApiDocument, OpenApiExportOptions, OpenApiOperation, OpenApiParameter, OpenApiParseOptions, OpenApiSchema, OpenApiServer, OpenApiSource, OpenApiTransportHints, OpenApiVersion, OperationsExportResult, ParameterLocation, ParseResult, ParsedOperation, ParsedParameter, RegistryGenerationOptions, SchemaField, SpecDiff, SpecSource, SyncResult, TransportHints, TypescriptType, ValidationResult, contractSpecToJson, contractSpecToYaml, createSpecDiff, deepEqual, defaultRestPath, detectFormat, detectVersion, diffAll, diffSpecVsOperation, diffSpecs, exportContractSpec, exportDataViews, exportEvents, exportFeatures, exportForms, exportOperations, exportPresentations, exportPresentationsFromArray, exportWorkflows, extractPathParams, formatDiffChanges, generateDataViewsRegistry, generateEventsExports, generateFeaturesRegistry, generateFormsRegistry, generateImports, generateOperationsRegistry, generatePresentationsRegistry, generateRegistryIndex, generateSchemaModelCode, generateWorkflowsRegistry, getByPath, getScalarType, importFromOpenApi, importOperation, jsonSchemaForSpec, jsonSchemaToField, jsonSchemaToType, normalizePath, openApiForRegistry, openApiToJson, openApiToYaml, parseOpenApi, parseOpenApiDocument, parseOpenApiString, schemaModelToJsonSchema, toCamelCase, toFileName, toHttpMethod, toKebabCase, toOperationId, toPascalCase, toRestPath, toSchemaName, toSnakeCase, toSpecKey, toValidIdentifier };

package/dist/index.js

@@ -9,10 +9,10 @@ import { exportDataViews, generateDataViewsRegistry } from "./openapi/exporter/d
 import { exportWorkflows, generateWorkflowsRegistry } from "./openapi/exporter/workflows.js";
 import { generateRegistryIndex } from "./openapi/exporter/registries.js";
 import { contractSpecToJson, contractSpecToYaml, exportContractSpec, openApiForRegistry, openApiToJson, openApiToYaml } from "./openapi/exporter.js";
-import { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecName, toValidIdentifier } from "./common/utils.js";
+import { deepEqual, extractPathParams, getByPath, normalizePath, toCamelCase, toFileName, toKebabCase, toPascalCase, toSnakeCase, toSpecKey, toValidIdentifier } from "./common/utils.js";
 import { generateImports, generateSchemaModelCode, getScalarType, jsonSchemaToField, jsonSchemaToType } from "./openapi/schema-converter.js";
 import { importFromOpenApi, importOperation } from "./openapi/importer/index.js";
 import { createSpecDiff, diffAll, diffSpecVsOperation, diffSpecs, formatDiffChanges } from "./openapi/differ.js";
 import "./openapi/index.js";
 
-export { contractSpecToJson, contractSpecToYaml, createSpecDiff, deepEqual, defaultRestPath, detectFormat, detectVersion, diffAll, diffSpecVsOperation, diffSpecs, exportContractSpec, exportDataViews, exportEvents, exportFeatures, exportForms, exportOperations, exportPresentations, exportPresentationsFromArray, exportWorkflows, extractPathParams, formatDiffChanges, generateDataViewsRegistry, generateEventsExports, generateFeaturesRegistry, generateFormsRegistry, generateImports, generateOperationsRegistry, generatePresentationsRegistry, generateRegistryIndex, generateSchemaModelCode, generateWorkflowsRegistry, getByPath, getScalarType, importFromOpenApi, importOperation, jsonSchemaForSpec, jsonSchemaToField, jsonSchemaToType, normalizePath, openApiForRegistry, openApiToJson, openApiToYaml, parseOpenApi, parseOpenApiDocument, parseOpenApiString, schemaModelToJsonSchema, toCamelCase, toFileName, toHttpMethod, toKebabCase, toOperationId, toPascalCase, toRestPath, toSchemaName, toSnakeCase, toSpecName, toValidIdentifier };
+export { contractSpecToJson, contractSpecToYaml, createSpecDiff, deepEqual, defaultRestPath, detectFormat, detectVersion, diffAll, diffSpecVsOperation, diffSpecs, exportContractSpec, exportDataViews, exportEvents, exportFeatures, exportForms, exportOperations, exportPresentations, exportPresentationsFromArray, exportWorkflows, extractPathParams, formatDiffChanges, generateDataViewsRegistry, generateEventsExports, generateFeaturesRegistry, generateFormsRegistry, generateImports, generateOperationsRegistry, generatePresentationsRegistry, generateRegistryIndex, generateSchemaModelCode, generateWorkflowsRegistry, getByPath, getScalarType, importFromOpenApi, importOperation, jsonSchemaForSpec, jsonSchemaToField, jsonSchemaToType, normalizePath, openApiForRegistry, openApiToJson, openApiToYaml, parseOpenApi, parseOpenApiDocument, parseOpenApiString, schemaModelToJsonSchema, toCamelCase, toFileName, toHttpMethod, toKebabCase, toOperationId, toPascalCase, toRestPath, toSchemaName, toSnakeCase, toSpecKey, toValidIdentifier };

package/dist/openapi/importer/events.js

@@ -23,9 +23,11 @@ ${Array.from(imports).join("\n")}
 ${payloadModel.code}
 
 export const ${eventName} = defineEvent({
-  name: '${event.name}',
-  version: 1,
-  description: ${JSON.stringify(event.description ?? "")},
+  meta: {
+    key: '${event.name}',
+    version: 1,
+    description: ${JSON.stringify(event.description ?? "")},
+  },
   payload: ${payloadModel.name},
 });
 `.trim();

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

@@ -1 +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"}
+{"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  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;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;;YAEb,MAAM,KAAK;;mBAEJ,KAAK,UAAU,MAAM,eAAe,GAAG,CAAC;;aAE9C,aAAa,KAAK;;EAE7B,MAAM"}

package/dist/openapi/importer/generator.js

@@ -1,4 +1,4 @@
-import { toPascalCase, toSpecName, toValidIdentifier } from "../../common/utils.js";
+import { toPascalCase, toSpecKey, toValidIdentifier } from "../../common/utils.js";
 import { generateImports } from "../schema-converter.js";
 import { inferAuthLevel, inferOpKind } from "./analyzer.js";
 
@@ -7,7 +7,7 @@ import { inferAuthLevel, inferOpKind } from "./analyzer.js";
 * Generate ContractSpec TypeScript code for an operation.
 */
 function generateSpecCode(operation, contractspecConfig, options = {}, inputModel, outputModel) {
-	const specName = toSpecName(operation.operationId, options.prefix);
+	const specKey = toSpecKey(operation.operationId, options.prefix);
 	const kind = inferOpKind(operation.method);
 	const auth = inferAuthLevel(operation, options.defaultAuth ?? "user");
 	const lines = [];
@@ -37,7 +37,7 @@ function generateSpecCode(operation, contractspecConfig, options = {}, inputMode
 	lines.push(` */`);
 	lines.push(`export const ${safeName}Spec = ${defineFunc}({`);
 	lines.push("  meta: {");
-	lines.push(`    name: '${specName}',`);
+	lines.push(`    key: '${specKey}',`);
 	lines.push("    version: 1,");
 	lines.push(`    stability: '${options.defaultStability ?? "stable"}',`);
 	lines.push(`    owners: [${(options.defaultOwners ?? []).map((o) => `'${o}'`).join(", ")}],`);

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

@@ -1 +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"}
+{"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 '@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 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 '@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(`    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  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":";;;;;;;;AAYA,SAAgB,iBACd,WACA,oBACA,UAAwC,EAAE,EAC1C,YACA,aACQ;CACR,MAAM,UAAU,UAAU,UAAU,aAAa,QAAQ,OAAO;CAChE,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,aAAa,QAAQ,IAAI;AACpC,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.js

@@ -1,4 +1,4 @@
-import { toFileName, toSpecName } from "../../common/utils.js";
+import { toFileName, toSpecKey } from "../../common/utils.js";
 import { generateSchemaModelCode } from "../schema-converter.js";
 import { buildInputSchema, getOutputSchema } from "./schemas.js";
 import { COMMAND_METHODS, inferAuthLevel, inferOpKind } from "./analyzer.js";
@@ -55,7 +55,7 @@ const importFromOpenApi = (parseResult, contractspecOptions, importOptions = {})
 			let outputModel = outputSchema ? generateSchemaModelCode(outputSchema, `${operation.operationId}Output`) : null;
 			if (outputModel && !outputModel.code.includes("defineSchemaModel")) outputModel = null;
 			const code = generateSpecCode(operation, contractspecOptions, importOptions, inputModel, outputModel);
-			const fileName = toFileName(toSpecName(operation.operationId, importOptions.prefix));
+			const fileName = toFileName(toSpecKey(operation.operationId, importOptions.prefix));
 			const transportHints = { rest: {
 				method: operation.method.toUpperCase(),
 				path: operation.path,
@@ -90,7 +90,7 @@ const importFromOpenApi = (parseResult, contractspecOptions, importOptions = {})
 	}
 	for (const [name, schema] of Object.entries(parseResult.schemas)) try {
 		const code = generateModelCode(name, schema, contractspecOptions);
-		const fileName = toFileName(toSpecName(name, importOptions.prefix));
+		const fileName = toFileName(toSpecKey(name, importOptions.prefix));
 		const groupFolder = resolveModelGroupFolder(name, contractspecOptions.conventions);
 		specs.push({
 			code,
@@ -113,7 +113,7 @@ const importFromOpenApi = (parseResult, contractspecOptions, importOptions = {})
 	}
 	for (const event of parseResult.events) try {
 		const code = generateEventCode(event, contractspecOptions);
-		const fileName = toFileName(toSpecName(event.name, importOptions.prefix));
+		const fileName = toFileName(toSpecKey(event.name, importOptions.prefix));
 		const groupFolder = resolveEventGroupFolder(event.name, contractspecOptions.conventions);
 		specs.push({
 			code,

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["specs: ImportedOperationSpec[]","skipped: ImportResult['skipped']","errors: ImportResult['errors']","transportHints: OpenApiTransportHints","source: OpenApiSource"],"sources":["../../../src/openapi/importer/index.ts"],"sourcesContent":["import type {\n  OpenApiSource,\n  OpenApiTransportHints,\n  ParsedOperation,\n  ParseResult,\n} from '../types';\nimport type { ImportedOperationSpec, ImportResult } from '../../common/types';\nimport { toFileName, toSpecName } from '../../common/utils';\nimport { generateSchemaModelCode } from '../schema-converter';\nimport { buildInputSchema, getOutputSchema } from './schemas';\nimport { generateSpecCode } from './generator';\nimport { generateModelCode } from './models';\nimport { generateEventCode } from './events';\nimport {\n  resolveOperationGroupFolder,\n  resolveModelGroupFolder,\n  resolveEventGroupFolder,\n} from './grouping';\nimport type {\n  ContractsrcConfig,\n  OpenApiSourceConfig,\n} from '@lssm/lib.contracts';\n\nexport * from './analyzer';\nexport * from './schemas';\nexport * from './generator';\nexport * from './models';\nexport * from './events';\nexport * from './grouping';\n\n/**\n * Import operations from a parsed OpenAPI document.\n */\nexport const importFromOpenApi = (\n  parseResult: ParseResult,\n  contractspecOptions: ContractsrcConfig,\n  importOptions: Partial<OpenApiSourceConfig> = {}\n): ImportResult => {\n  const { tags, exclude = [], include } = importOptions;\n  const specs: ImportedOperationSpec[] = [];\n  const skipped: ImportResult['skipped'] = [];\n  const errors: ImportResult['errors'] = [];\n\n  for (const operation of parseResult.operations) {\n    // Filter by tags if specified\n    if (tags && tags.length > 0) {\n      const hasMatchingTag = operation.tags.some((t) => tags.includes(t));\n      if (!hasMatchingTag) {\n        skipped.push({\n          sourceId: operation.operationId,\n          reason: `No matching tags (has: ${operation.tags.join(', ')})`,\n        });\n        continue;\n      }\n    }\n\n    // Filter by include/exclude\n    if (include && include.length > 0) {\n      if (!include.includes(operation.operationId)) {\n        skipped.push({\n          sourceId: operation.operationId,\n          reason: 'Not in include list',\n        });\n        continue;\n      }\n    } else if (exclude.includes(operation.operationId)) {\n      skipped.push({\n        sourceId: operation.operationId,\n        reason: 'In exclude list',\n      });\n      continue;\n    }\n\n    // Skip deprecated operations by default\n    if (\n      operation.deprecated &&\n      importOptions.defaultStability !== 'deprecated'\n    ) {\n      skipped.push({\n        sourceId: operation.operationId,\n        reason: 'Deprecated operation',\n      });\n      continue;\n    }\n\n    try {\n      // Build input schema\n      const { schema: inputSchema } = buildInputSchema(operation);\n      const inputModel = inputSchema\n        ? generateSchemaModelCode(inputSchema, `${operation.operationId}Input`)\n        : null;\n\n      // Get output schema\n      const outputSchema = getOutputSchema(operation);\n      let outputModel = outputSchema\n        ? generateSchemaModelCode(\n            outputSchema,\n            `${operation.operationId}Output`\n          )\n        : null;\n\n      // Filter out empty/comment-only output models\n      if (outputModel && !outputModel.code.includes('defineSchemaModel')) {\n        outputModel = null;\n      }\n\n      // Generate spec code\n      const code = generateSpecCode(\n        operation,\n        contractspecOptions,\n        importOptions,\n        inputModel,\n        outputModel\n      );\n      const specName = toSpecName(operation.operationId, importOptions.prefix);\n      const fileName = toFileName(specName);\n\n      // Build transport hints\n      const transportHints: OpenApiTransportHints = {\n        rest: {\n          method:\n            operation.method.toUpperCase() as OpenApiTransportHints['rest']['method'],\n          path: operation.path,\n          params: {\n            path: operation.pathParams.map((p) => p.name),\n            query: operation.queryParams.map((p) => p.name),\n            header: operation.headerParams.map((p) => p.name),\n            cookie: operation.cookieParams.map((p) => p.name),\n          },\n        },\n      };\n\n      // Build source info\n      const source: OpenApiSource = {\n        type: 'openapi',\n        sourceId: operation.operationId,\n        operationId: operation.operationId,\n        openApiVersion: parseResult.version,\n        importedAt: new Date(),\n      };\n\n      // Resolve group folder based on config\n      const groupFolder = resolveOperationGroupFolder(\n        operation,\n        contractspecOptions.conventions\n      );\n\n      specs.push({\n        code,\n        fileName,\n        groupFolder: groupFolder || undefined,\n        source,\n        transportHints,\n      });\n    } catch (error) {\n      errors.push({\n        sourceId: operation.operationId,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  // Import standalone models\n  for (const [name, schema] of Object.entries(parseResult.schemas)) {\n    try {\n      const code = generateModelCode(name, schema, contractspecOptions);\n      const fileName = toFileName(toSpecName(name, importOptions.prefix));\n      const groupFolder = resolveModelGroupFolder(\n        name,\n        contractspecOptions.conventions\n      );\n\n      specs.push({\n        code,\n        fileName,\n        groupFolder: groupFolder || undefined,\n        source: {\n          type: 'openapi',\n          sourceId: name,\n          operationId: name,\n          openApiVersion: parseResult.version,\n          importedAt: new Date(),\n        } as OpenApiSource,\n        transportHints: {},\n      });\n    } catch (error) {\n      errors.push({\n        sourceId: name,\n        error:\n          error instanceof Error\n            ? 'Model conversion failed: ' + error.message\n            : String(error),\n      });\n    }\n  }\n\n  // Import events\n  for (const event of parseResult.events) {\n    try {\n      const code = generateEventCode(event, contractspecOptions);\n      const fileName = toFileName(toSpecName(event.name, importOptions.prefix));\n      const groupFolder = resolveEventGroupFolder(\n        event.name,\n        contractspecOptions.conventions\n      );\n\n      specs.push({\n        code,\n        fileName,\n        groupFolder: groupFolder || undefined,\n        source: {\n          type: 'openapi',\n          sourceId: event.name,\n          operationId: event.name,\n          openApiVersion: parseResult.version,\n          importedAt: new Date(),\n        } as OpenApiSource,\n        transportHints: {},\n      });\n    } catch (error) {\n      errors.push({\n        sourceId: event.name,\n        error:\n          error instanceof Error\n            ? 'Event conversion failed: ' + error.message\n            : String(error),\n      });\n    }\n  }\n\n  return {\n    operationSpecs: specs,\n    skipped,\n    errors,\n    summary: {\n      total:\n        parseResult.operations.length +\n        Object.keys(parseResult.schemas).length +\n        parseResult.events.length,\n      imported: specs.length,\n      skipped: skipped.length,\n      errors: errors.length,\n    },\n  };\n};\n\n/**\n * Import a single operation to ContractSpec code.\n */\nexport function importOperation(\n  operation: ParsedOperation,\n  options: Partial<OpenApiSourceConfig> = {},\n  contractspecOptions: ContractsrcConfig\n): string {\n  const { schema: inputSchema } = buildInputSchema(operation);\n  const inputModel = inputSchema\n    ? generateSchemaModelCode(inputSchema, `${operation.operationId}Input`)\n    : null;\n\n  const outputSchema = getOutputSchema(operation);\n  const outputModel = outputSchema\n    ? generateSchemaModelCode(outputSchema, `${operation.operationId}Output`)\n    : null;\n\n  return generateSpecCode(\n    operation,\n    contractspecOptions,\n    options,\n    inputModel,\n    outputModel\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAiCA,MAAa,qBACX,aACA,qBACA,gBAA8C,EAAE,KAC/B;CACjB,MAAM,EAAE,MAAM,UAAU,EAAE,EAAE,YAAY;CACxC,MAAMA,QAAiC,EAAE;CACzC,MAAMC,UAAmC,EAAE;CAC3C,MAAMC,SAAiC,EAAE;AAEzC,MAAK,MAAM,aAAa,YAAY,YAAY;AAE9C,MAAI,QAAQ,KAAK,SAAS,GAExB;OAAI,CADmB,UAAU,KAAK,MAAM,MAAM,KAAK,SAAS,EAAE,CAAC,EAC9C;AACnB,YAAQ,KAAK;KACX,UAAU,UAAU;KACpB,QAAQ,0BAA0B,UAAU,KAAK,KAAK,KAAK,CAAC;KAC7D,CAAC;AACF;;;AAKJ,MAAI,WAAW,QAAQ,SAAS,GAC9B;OAAI,CAAC,QAAQ,SAAS,UAAU,YAAY,EAAE;AAC5C,YAAQ,KAAK;KACX,UAAU,UAAU;KACpB,QAAQ;KACT,CAAC;AACF;;aAEO,QAAQ,SAAS,UAAU,YAAY,EAAE;AAClD,WAAQ,KAAK;IACX,UAAU,UAAU;IACpB,QAAQ;IACT,CAAC;AACF;;AAIF,MACE,UAAU,cACV,cAAc,qBAAqB,cACnC;AACA,WAAQ,KAAK;IACX,UAAU,UAAU;IACpB,QAAQ;IACT,CAAC;AACF;;AAGF,MAAI;GAEF,MAAM,EAAE,QAAQ,gBAAgB,iBAAiB,UAAU;GAC3D,MAAM,aAAa,cACf,wBAAwB,aAAa,GAAG,UAAU,YAAY,OAAO,GACrE;GAGJ,MAAM,eAAe,gBAAgB,UAAU;GAC/C,IAAI,cAAc,eACd,wBACE,cACA,GAAG,UAAU,YAAY,QAC1B,GACD;AAGJ,OAAI,eAAe,CAAC,YAAY,KAAK,SAAS,oBAAoB,CAChE,eAAc;GAIhB,MAAM,OAAO,iBACX,WACA,qBACA,eACA,YACA,YACD;GAED,MAAM,WAAW,WADA,WAAW,UAAU,aAAa,cAAc,OAAO,CACnC;GAGrC,MAAMC,iBAAwC,EAC5C,MAAM;IACJ,QACE,UAAU,OAAO,aAAa;IAChC,MAAM,UAAU;IAChB,QAAQ;KACN,MAAM,UAAU,WAAW,KAAK,MAAM,EAAE,KAAK;KAC7C,OAAO,UAAU,YAAY,KAAK,MAAM,EAAE,KAAK;KAC/C,QAAQ,UAAU,aAAa,KAAK,MAAM,EAAE,KAAK;KACjD,QAAQ,UAAU,aAAa,KAAK,MAAM,EAAE,KAAK;KAClD;IACF,EACF;GAGD,MAAMC,SAAwB;IAC5B,MAAM;IACN,UAAU,UAAU;IACpB,aAAa,UAAU;IACvB,gBAAgB,YAAY;IAC5B,4BAAY,IAAI,MAAM;IACvB;GAGD,MAAM,cAAc,4BAClB,WACA,oBAAoB,YACrB;AAED,SAAM,KAAK;IACT;IACA;IACA,aAAa,eAAe;IAC5B;IACA;IACD,CAAC;WACK,OAAO;AACd,UAAO,KAAK;IACV,UAAU,UAAU;IACpB,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAC9D,CAAC;;;AAKN,MAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,YAAY,QAAQ,CAC9D,KAAI;EACF,MAAM,OAAO,kBAAkB,MAAM,QAAQ,oBAAoB;EACjE,MAAM,WAAW,WAAW,WAAW,MAAM,cAAc,OAAO,CAAC;EACnE,MAAM,cAAc,wBAClB,MACA,oBAAoB,YACrB;AAED,QAAM,KAAK;GACT;GACA;GACA,aAAa,eAAe;GAC5B,QAAQ;IACN,MAAM;IACN,UAAU;IACV,aAAa;IACb,gBAAgB,YAAY;IAC5B,4BAAY,IAAI,MAAM;IACvB;GACD,gBAAgB,EAAE;GACnB,CAAC;UACK,OAAO;AACd,SAAO,KAAK;GACV,UAAU;GACV,OACE,iBAAiB,QACb,8BAA8B,MAAM,UACpC,OAAO,MAAM;GACpB,CAAC;;AAKN,MAAK,MAAM,SAAS,YAAY,OAC9B,KAAI;EACF,MAAM,OAAO,kBAAkB,OAAO,oBAAoB;EAC1D,MAAM,WAAW,WAAW,WAAW,MAAM,MAAM,cAAc,OAAO,CAAC;EACzE,MAAM,cAAc,wBAClB,MAAM,MACN,oBAAoB,YACrB;AAED,QAAM,KAAK;GACT;GACA;GACA,aAAa,eAAe;GAC5B,QAAQ;IACN,MAAM;IACN,UAAU,MAAM;IAChB,aAAa,MAAM;IACnB,gBAAgB,YAAY;IAC5B,4BAAY,IAAI,MAAM;IACvB;GACD,gBAAgB,EAAE;GACnB,CAAC;UACK,OAAO;AACd,SAAO,KAAK;GACV,UAAU,MAAM;GAChB,OACE,iBAAiB,QACb,8BAA8B,MAAM,UACpC,OAAO,MAAM;GACpB,CAAC;;AAIN,QAAO;EACL,gBAAgB;EAChB;EACA;EACA,SAAS;GACP,OACE,YAAY,WAAW,SACvB,OAAO,KAAK,YAAY,QAAQ,CAAC,SACjC,YAAY,OAAO;GACrB,UAAU,MAAM;GAChB,SAAS,QAAQ;GACjB,QAAQ,OAAO;GAChB;EACF;;;;;AAMH,SAAgB,gBACd,WACA,UAAwC,EAAE,EAC1C,qBACQ;CACR,MAAM,EAAE,QAAQ,gBAAgB,iBAAiB,UAAU;CAC3D,MAAM,aAAa,cACf,wBAAwB,aAAa,GAAG,UAAU,YAAY,OAAO,GACrE;CAEJ,MAAM,eAAe,gBAAgB,UAAU;AAK/C,QAAO,iBACL,WACA,qBACA,SACA,YARkB,eAChB,wBAAwB,cAAc,GAAG,UAAU,YAAY,QAAQ,GACvE,KAQH"}
+{"version":3,"file":"index.js","names":["specs: ImportedOperationSpec[]","skipped: ImportResult['skipped']","errors: ImportResult['errors']","transportHints: OpenApiTransportHints","source: OpenApiSource"],"sources":["../../../src/openapi/importer/index.ts"],"sourcesContent":["import type {\n  OpenApiSource,\n  OpenApiTransportHints,\n  ParsedOperation,\n  ParseResult,\n} from '../types';\nimport type { ImportedOperationSpec, ImportResult } from '../../common/types';\nimport { toFileName, toSpecKey } from '../../common/utils';\nimport { generateSchemaModelCode } from '../schema-converter';\nimport { buildInputSchema, getOutputSchema } from './schemas';\nimport { generateSpecCode } from './generator';\nimport { generateModelCode } from './models';\nimport { generateEventCode } from './events';\nimport {\n  resolveOperationGroupFolder,\n  resolveModelGroupFolder,\n  resolveEventGroupFolder,\n} from './grouping';\nimport type {\n  ContractsrcConfig,\n  OpenApiSourceConfig,\n} from '@lssm/lib.contracts';\n\nexport * from './analyzer';\nexport * from './schemas';\nexport * from './generator';\nexport * from './models';\nexport * from './events';\nexport * from './grouping';\n\n/**\n * Import operations from a parsed OpenAPI document.\n */\nexport const importFromOpenApi = (\n  parseResult: ParseResult,\n  contractspecOptions: ContractsrcConfig,\n  importOptions: Partial<OpenApiSourceConfig> = {}\n): ImportResult => {\n  const { tags, exclude = [], include } = importOptions;\n  const specs: ImportedOperationSpec[] = [];\n  const skipped: ImportResult['skipped'] = [];\n  const errors: ImportResult['errors'] = [];\n\n  for (const operation of parseResult.operations) {\n    // Filter by tags if specified\n    if (tags && tags.length > 0) {\n      const hasMatchingTag = operation.tags.some((t) => tags.includes(t));\n      if (!hasMatchingTag) {\n        skipped.push({\n          sourceId: operation.operationId,\n          reason: `No matching tags (has: ${operation.tags.join(', ')})`,\n        });\n        continue;\n      }\n    }\n\n    // Filter by include/exclude\n    if (include && include.length > 0) {\n      if (!include.includes(operation.operationId)) {\n        skipped.push({\n          sourceId: operation.operationId,\n          reason: 'Not in include list',\n        });\n        continue;\n      }\n    } else if (exclude.includes(operation.operationId)) {\n      skipped.push({\n        sourceId: operation.operationId,\n        reason: 'In exclude list',\n      });\n      continue;\n    }\n\n    // Skip deprecated operations by default\n    if (\n      operation.deprecated &&\n      importOptions.defaultStability !== 'deprecated'\n    ) {\n      skipped.push({\n        sourceId: operation.operationId,\n        reason: 'Deprecated operation',\n      });\n      continue;\n    }\n\n    try {\n      // Build input schema\n      const { schema: inputSchema } = buildInputSchema(operation);\n      const inputModel = inputSchema\n        ? generateSchemaModelCode(inputSchema, `${operation.operationId}Input`)\n        : null;\n\n      // Get output schema\n      const outputSchema = getOutputSchema(operation);\n      let outputModel = outputSchema\n        ? generateSchemaModelCode(\n            outputSchema,\n            `${operation.operationId}Output`\n          )\n        : null;\n\n      // Filter out empty/comment-only output models\n      if (outputModel && !outputModel.code.includes('defineSchemaModel')) {\n        outputModel = null;\n      }\n\n      // Generate spec code\n      const code = generateSpecCode(\n        operation,\n        contractspecOptions,\n        importOptions,\n        inputModel,\n        outputModel\n      );\n      const specName = toSpecKey(operation.operationId, importOptions.prefix);\n      const fileName = toFileName(specName);\n\n      // Build transport hints\n      const transportHints: OpenApiTransportHints = {\n        rest: {\n          method:\n            operation.method.toUpperCase() as OpenApiTransportHints['rest']['method'],\n          path: operation.path,\n          params: {\n            path: operation.pathParams.map((p) => p.name),\n            query: operation.queryParams.map((p) => p.name),\n            header: operation.headerParams.map((p) => p.name),\n            cookie: operation.cookieParams.map((p) => p.name),\n          },\n        },\n      };\n\n      // Build source info\n      const source: OpenApiSource = {\n        type: 'openapi',\n        sourceId: operation.operationId,\n        operationId: operation.operationId,\n        openApiVersion: parseResult.version,\n        importedAt: new Date(),\n      };\n\n      // Resolve group folder based on config\n      const groupFolder = resolveOperationGroupFolder(\n        operation,\n        contractspecOptions.conventions\n      );\n\n      specs.push({\n        code,\n        fileName,\n        groupFolder: groupFolder || undefined,\n        source,\n        transportHints,\n      });\n    } catch (error) {\n      errors.push({\n        sourceId: operation.operationId,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  // Import standalone models\n  for (const [name, schema] of Object.entries(parseResult.schemas)) {\n    try {\n      const code = generateModelCode(name, schema, contractspecOptions);\n      const fileName = toFileName(toSpecKey(name, importOptions.prefix));\n      const groupFolder = resolveModelGroupFolder(\n        name,\n        contractspecOptions.conventions\n      );\n\n      specs.push({\n        code,\n        fileName,\n        groupFolder: groupFolder || undefined,\n        source: {\n          type: 'openapi',\n          sourceId: name,\n          operationId: name,\n          openApiVersion: parseResult.version,\n          importedAt: new Date(),\n        } as OpenApiSource,\n        transportHints: {},\n      });\n    } catch (error) {\n      errors.push({\n        sourceId: name,\n        error:\n          error instanceof Error\n            ? 'Model conversion failed: ' + error.message\n            : String(error),\n      });\n    }\n  }\n\n  // Import events\n  for (const event of parseResult.events) {\n    try {\n      const code = generateEventCode(event, contractspecOptions);\n      const fileName = toFileName(toSpecKey(event.name, importOptions.prefix));\n      const groupFolder = resolveEventGroupFolder(\n        event.name,\n        contractspecOptions.conventions\n      );\n\n      specs.push({\n        code,\n        fileName,\n        groupFolder: groupFolder || undefined,\n        source: {\n          type: 'openapi',\n          sourceId: event.name,\n          operationId: event.name,\n          openApiVersion: parseResult.version,\n          importedAt: new Date(),\n        } as OpenApiSource,\n        transportHints: {},\n      });\n    } catch (error) {\n      errors.push({\n        sourceId: event.name,\n        error:\n          error instanceof Error\n            ? 'Event conversion failed: ' + error.message\n            : String(error),\n      });\n    }\n  }\n\n  return {\n    operationSpecs: specs,\n    skipped,\n    errors,\n    summary: {\n      total:\n        parseResult.operations.length +\n        Object.keys(parseResult.schemas).length +\n        parseResult.events.length,\n      imported: specs.length,\n      skipped: skipped.length,\n      errors: errors.length,\n    },\n  };\n};\n\n/**\n * Import a single operation to ContractSpec code.\n */\nexport function importOperation(\n  operation: ParsedOperation,\n  options: Partial<OpenApiSourceConfig> = {},\n  contractspecOptions: ContractsrcConfig\n): string {\n  const { schema: inputSchema } = buildInputSchema(operation);\n  const inputModel = inputSchema\n    ? generateSchemaModelCode(inputSchema, `${operation.operationId}Input`)\n    : null;\n\n  const outputSchema = getOutputSchema(operation);\n  const outputModel = outputSchema\n    ? generateSchemaModelCode(outputSchema, `${operation.operationId}Output`)\n    : null;\n\n  return generateSpecCode(\n    operation,\n    contractspecOptions,\n    options,\n    inputModel,\n    outputModel\n  );\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.contracts-transformers",
-  "version": "1.42.2",
+  "version": "1.42.4",
   "description": "Contract format transformations: import/export between ContractSpec and external formats (OpenAPI, AsyncAPI, etc.)",
   "type": "module",
   "scripts": {
@@ -17,15 +17,15 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/lib.contracts": "1.42.2",
-    "@lssm/lib.schema": "1.42.2",
+    "@lssm/lib.contracts": "1.42.4",
+    "@lssm/lib.schema": "1.42.4",
     "openapi-types": "^12.1.3",
     "yaml": "^2.7.1",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "1.42.2",
-    "@lssm/tool.typescript": "1.42.2",
+    "@lssm/tool.tsdown": "1.42.4",
+    "@lssm/tool.typescript": "1.42.4",
     "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },