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

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,13 +40,19 @@ 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 */
   fileName: string;
+  /** Group folder for organizing the file (based on grouping config) */
+  groupFolder?: string;
   /** Source information for provenance tracking */
   source: SpecSource;
   /** Transport hints for accurate round-trips */
@@ -57,7 +63,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 +108,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 +123,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 +155,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;;AAcU,UAnDO,UAAA,CAmDP;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,EA5GP,IA4GO;AAUrB;;;;;AAWqB,UA1HJ,cAAA,CA0HI;EAaJ,IAAA,CAAA,EAAA;;;;;;;;;;;;;;;;;;UAnHA,qBAAA;;;;;;kBAMC;;;;;;;;UAQR;;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,18 @@
-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 { defaultRestPath, openApiForRegistry, openApiToJson, openApiToYaml } from "./openapi/exporter.js";
-import { importFromOpenApi, importOperation } from "./openapi/importer.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 { OperationsExportResult, defaultRestPath, exportOperations, generateOperationsRegistry, jsonSchemaForSpec, schemaModelToJsonSchema, toHttpMethod, toOperationId, toRestPath, toSchemaName } from "./openapi/exporter/operations.js";
+import { ContractSpecRegistries, contractSpecToJson, contractSpecToYaml, exportContractSpec, openApiForRegistry, openApiToJson, openApiToYaml } from "./openapi/exporter.js";
+import { ExportedEvent, exportEvents, generateEventsExports } from "./openapi/exporter/events.js";
+import { ExportedFeature, exportFeatures, generateFeaturesRegistry } from "./openapi/exporter/features.js";
+import { ExportedPresentation, ExportedPresentationV2, exportPresentations, exportPresentationsV1, exportPresentationsV2, generatePresentationsRegistry } from "./openapi/exporter/presentations.js";
+import { ExportedForm, exportForms, generateFormsRegistry } from "./openapi/exporter/forms.js";
+import { ExportedDataView, exportDataViews, generateDataViewsRegistry } from "./openapi/exporter/data-views.js";
+import { ExportedWorkflow, exportWorkflows, generateWorkflowsRegistry } from "./openapi/exporter/workflows.js";
+import { RegistryGenerationOptions, generateRegistryIndex } from "./openapi/exporter/registries.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, ContractSpecRegistries, DiffChange, DiffChangeType, DiffOptions, ExportedDataView, ExportedEvent, ExportedFeature, ExportedForm, ExportedPresentation, ExportedPresentationV2, 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, exportPresentationsV1, exportPresentationsV2, 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 };

package/dist/index.js

@@ -1,9 +1,18 @@
-import { detectFormat, detectVersion, parseOpenApi, parseOpenApiDocument, parseOpenApiString } from "./openapi/parser.js";
-import { defaultRestPath, openApiForRegistry, openApiToJson, openApiToYaml } from "./openapi/exporter.js";
+import { detectFormat, detectVersion, parseOpenApiString } from "./openapi/parser/utils.js";
+import { parseOpenApi, parseOpenApiDocument } from "./openapi/parser/document.js";
+import { defaultRestPath, exportOperations, generateOperationsRegistry, jsonSchemaForSpec, schemaModelToJsonSchema, toHttpMethod, toOperationId, toRestPath, toSchemaName } from "./openapi/exporter/operations.js";
+import { exportEvents, generateEventsExports } from "./openapi/exporter/events.js";
+import { exportFeatures, generateFeaturesRegistry } from "./openapi/exporter/features.js";
+import { exportPresentations, exportPresentationsV1, exportPresentationsV2, generatePresentationsRegistry } from "./openapi/exporter/presentations.js";
+import { exportForms, generateFormsRegistry } from "./openapi/exporter/forms.js";
+import { exportDataViews, generateDataViewsRegistry } from "./openapi/exporter/data-views.js";
+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 { 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";
 
-export { 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 { contractSpecToJson, contractSpecToYaml, createSpecDiff, deepEqual, defaultRestPath, detectFormat, detectVersion, diffAll, diffSpecVsOperation, diffSpecs, exportContractSpec, exportDataViews, exportEvents, exportFeatures, exportForms, exportOperations, exportPresentations, exportPresentationsV1, exportPresentationsV2, 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 };

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":"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"}

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/openapi/exporter/events.js

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

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

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

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

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

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

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

package/dist/openapi/exporter/features.js

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

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

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

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

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

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

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