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

package/dist/openapi/importer/index.js

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

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

@@ -0,0 +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":"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"}

package/dist/openapi/importer/models.js

@@ -0,0 +1,19 @@
+import { toPascalCase, toValidIdentifier } from "../../common/utils.js";
+import { generateImports, generateSchemaModelCode } from "../schema-converter.js";
+
+//#region src/openapi/importer/models.ts
+/**
+* Generate code for a standalone model.
+*/
+function generateModelCode(name, schema, options) {
+	const model = generateSchemaModelCode(schema, toPascalCase(toValidIdentifier(name)));
+	return `
+${generateImports(model.fields, options)}
+
+${model.code}
+`.trim();
+}
+
+//#endregion
+export { generateModelCode };
+//# sourceMappingURL=models.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","names":[],"sources":["../../../src/openapi/importer/models.ts"],"sourcesContent":["import type { OpenApiSchema } 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 a standalone model.\n */\nexport function generateModelCode(\n  name: string,\n  schema: OpenApiSchema,\n  options: ContractsrcConfig\n): string {\n  const modelName = toPascalCase(toValidIdentifier(name));\n  const model = generateSchemaModelCode(schema, modelName);\n\n  const imports = generateImports(model.fields, options);\n\n  return `\n${imports}\n\n${model.code}\n`.trim();\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,kBACd,MACA,QACA,SACQ;CAER,MAAM,QAAQ,wBAAwB,QADpB,aAAa,kBAAkB,KAAK,CAAC,CACC;AAIxD,QAAO;EAFS,gBAAgB,MAAM,QAAQ,QAAQ,CAG9C;;EAER,MAAM,KAAK;EACX,MAAM"}

package/dist/openapi/importer/schemas.js

@@ -0,0 +1,80 @@
+//#region src/openapi/importer/schemas.ts
+/**
+* Build a merged input schema from all parameter sources.
+*/
+function buildInputSchema(operation) {
+	const fields = [];
+	for (const param of operation.pathParams) fields.push({
+		name: param.name,
+		schema: param.schema,
+		required: true
+	});
+	for (const param of operation.queryParams) fields.push({
+		name: param.name,
+		schema: param.schema,
+		required: param.required
+	});
+	const excludedHeaders = [
+		"authorization",
+		"content-type",
+		"accept",
+		"user-agent"
+	];
+	for (const param of operation.headerParams) if (!excludedHeaders.includes(param.name.toLowerCase())) fields.push({
+		name: param.name,
+		schema: param.schema,
+		required: param.required
+	});
+	if (operation.requestBody?.schema) {
+		const bodySchema = operation.requestBody.schema;
+		if (!("$ref" in bodySchema)) {
+			const schemaObj = bodySchema;
+			const properties = schemaObj["properties"];
+			const required = schemaObj["required"] ?? [];
+			if (properties) for (const [propName, propSchema] of Object.entries(properties)) fields.push({
+				name: propName,
+				schema: propSchema,
+				required: required.includes(propName)
+			});
+		} else fields.push({
+			name: "body",
+			schema: bodySchema,
+			required: operation.requestBody.required
+		});
+	}
+	if (fields.length === 0) return {
+		schema: null,
+		fields: []
+	};
+	return {
+		schema: {
+			type: "object",
+			properties: fields.reduce((acc, f) => {
+				acc[f.name] = f.schema;
+				return acc;
+			}, {}),
+			required: fields.filter((f) => f.required).map((f) => f.name)
+		},
+		fields
+	};
+}
+/**
+* Get the output schema from the operation responses.
+*/
+function getOutputSchema(operation) {
+	for (const code of [
+		"200",
+		"201",
+		"202",
+		"204"
+	]) {
+		const response = operation.responses[code];
+		if (response?.schema) return response.schema;
+	}
+	for (const [code, response] of Object.entries(operation.responses)) if (code.startsWith("2") && response.schema) return response.schema;
+	return null;
+}
+
+//#endregion
+export { buildInputSchema, getOutputSchema };
+//# sourceMappingURL=schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","names":["fields: {\n    name: string;\n    schema: OpenApiSchema;\n    required: boolean;\n  }[]"],"sources":["../../../src/openapi/importer/schemas.ts"],"sourcesContent":["import type { ParsedOperation, OpenApiSchema } from '../types';\n\n/**\n * Build a merged input schema from all parameter sources.\n */\nexport function buildInputSchema(operation: ParsedOperation): {\n  schema: OpenApiSchema | null;\n  fields: { name: string; schema: OpenApiSchema; required: boolean }[];\n} {\n  const fields: {\n    name: string;\n    schema: OpenApiSchema;\n    required: boolean;\n  }[] = [];\n\n  // Add path parameters\n  for (const param of operation.pathParams) {\n    fields.push({\n      name: param.name,\n      schema: param.schema,\n      required: true, // Path params are always required\n    });\n  }\n\n  // Add query parameters\n  for (const param of operation.queryParams) {\n    fields.push({\n      name: param.name,\n      schema: param.schema,\n      required: param.required,\n    });\n  }\n\n  // Add header parameters (excluding common headers)\n  const excludedHeaders = [\n    'authorization',\n    'content-type',\n    'accept',\n    'user-agent',\n  ];\n  for (const param of operation.headerParams) {\n    if (!excludedHeaders.includes(param.name.toLowerCase())) {\n      fields.push({\n        name: param.name,\n        schema: param.schema,\n        required: param.required,\n      });\n    }\n  }\n\n  // Add request body fields\n  if (operation.requestBody?.schema) {\n    const bodySchema = operation.requestBody.schema;\n    if (!('$ref' in bodySchema)) {\n      const schemaObj = bodySchema as Record<string, unknown>;\n      const properties = schemaObj['properties'] as\n        | Record<string, OpenApiSchema>\n        | undefined;\n      const required = (schemaObj['required'] as string[]) ?? [];\n\n      if (properties) {\n        for (const [propName, propSchema] of Object.entries(properties)) {\n          fields.push({\n            name: propName,\n            schema: propSchema,\n            required: required.includes(propName),\n          });\n        }\n      }\n    } else {\n      // Reference to a schema - add as a single field\n      fields.push({\n        name: 'body',\n        schema: bodySchema,\n        required: operation.requestBody.required,\n      });\n    }\n  }\n\n  if (fields.length === 0) {\n    return { schema: null, fields: [] };\n  }\n\n  // Build a merged schema\n  const mergedSchema: OpenApiSchema = {\n    type: 'object',\n    properties: fields.reduce(\n      (acc, f) => {\n        acc[f.name] = f.schema;\n        return acc;\n      },\n      {} as Record<string, OpenApiSchema>\n    ),\n    required: fields.filter((f) => f.required).map((f) => f.name),\n  } as unknown as OpenApiSchema;\n\n  return { schema: mergedSchema, fields };\n}\n\n/**\n * Get the output schema from the operation responses.\n */\nexport function getOutputSchema(\n  operation: ParsedOperation\n): OpenApiSchema | null {\n  // Prefer 200, then 201, then 2xx responses\n  const successCodes = ['200', '201', '202', '204'];\n\n  for (const code of successCodes) {\n    const response = operation.responses[code];\n    if (response?.schema) {\n      return response.schema;\n    }\n  }\n\n  // Check for any 2xx response\n  for (const [code, response] of Object.entries(operation.responses)) {\n    if (code.startsWith('2') && response.schema) {\n      return response.schema;\n    }\n  }\n\n  return null;\n}\n"],"mappings":";;;;AAKA,SAAgB,iBAAiB,WAG/B;CACA,MAAMA,SAIA,EAAE;AAGR,MAAK,MAAM,SAAS,UAAU,WAC5B,QAAO,KAAK;EACV,MAAM,MAAM;EACZ,QAAQ,MAAM;EACd,UAAU;EACX,CAAC;AAIJ,MAAK,MAAM,SAAS,UAAU,YAC5B,QAAO,KAAK;EACV,MAAM,MAAM;EACZ,QAAQ,MAAM;EACd,UAAU,MAAM;EACjB,CAAC;CAIJ,MAAM,kBAAkB;EACtB;EACA;EACA;EACA;EACD;AACD,MAAK,MAAM,SAAS,UAAU,aAC5B,KAAI,CAAC,gBAAgB,SAAS,MAAM,KAAK,aAAa,CAAC,CACrD,QAAO,KAAK;EACV,MAAM,MAAM;EACZ,QAAQ,MAAM;EACd,UAAU,MAAM;EACjB,CAAC;AAKN,KAAI,UAAU,aAAa,QAAQ;EACjC,MAAM,aAAa,UAAU,YAAY;AACzC,MAAI,EAAE,UAAU,aAAa;GAC3B,MAAM,YAAY;GAClB,MAAM,aAAa,UAAU;GAG7B,MAAM,WAAY,UAAU,eAA4B,EAAE;AAE1D,OAAI,WACF,MAAK,MAAM,CAAC,UAAU,eAAe,OAAO,QAAQ,WAAW,CAC7D,QAAO,KAAK;IACV,MAAM;IACN,QAAQ;IACR,UAAU,SAAS,SAAS,SAAS;IACtC,CAAC;QAKN,QAAO,KAAK;GACV,MAAM;GACN,QAAQ;GACR,UAAU,UAAU,YAAY;GACjC,CAAC;;AAIN,KAAI,OAAO,WAAW,EACpB,QAAO;EAAE,QAAQ;EAAM,QAAQ,EAAE;EAAE;AAgBrC,QAAO;EAAE,QAZ2B;GAClC,MAAM;GACN,YAAY,OAAO,QAChB,KAAK,MAAM;AACV,QAAI,EAAE,QAAQ,EAAE;AAChB,WAAO;MAET,EAAE,CACH;GACD,UAAU,OAAO,QAAQ,MAAM,EAAE,SAAS,CAAC,KAAK,MAAM,EAAE,KAAK;GAC9D;EAE8B;EAAQ;;;;;AAMzC,SAAgB,gBACd,WACsB;AAItB,MAAK,MAAM,QAFU;EAAC;EAAO;EAAO;EAAO;EAAM,EAEhB;EAC/B,MAAM,WAAW,UAAU,UAAU;AACrC,MAAI,UAAU,OACZ,QAAO,SAAS;;AAKpB,MAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,UAAU,UAAU,CAChE,KAAI,KAAK,WAAW,IAAI,IAAI,SAAS,OACnC,QAAO,SAAS;AAIpB,QAAO"}

package/dist/openapi/index.d.ts

@@ -1,7 +1,16 @@
-import { ContractSpecOpenApiDocument, HttpMethod, OpenApiDocument, OpenApiExportOptions, OpenApiImportOptions, OpenApiOperation, OpenApiParameter, OpenApiParseOptions, OpenApiSchema, OpenApiServer, OpenApiSource, OpenApiTransportHints, OpenApiVersion, ParameterLocation, ParseResult, ParsedOperation, ParsedParameter } from "./types.js";
-import { detectFormat, detectVersion, parseOpenApi, parseOpenApiDocument, parseOpenApiString } from "./parser.js";
-import { defaultRestPath, openApiForRegistry, openApiToJson, openApiToYaml } from "./exporter.js";
-import { importFromOpenApi, importOperation } from "./importer.js";
+import { ContractSpecOpenApiDocument, HttpMethod, OpenApiDocument, OpenApiExportOptions, OpenApiOperation, OpenApiParameter, OpenApiParseOptions, OpenApiSchema, OpenApiServer, OpenApiSource, OpenApiTransportHints, OpenApiVersion, ParameterLocation, ParseResult, ParsedOperation, ParsedParameter } from "./types.js";
+import { detectFormat, detectVersion, parseOpenApiString } from "./parser/utils.js";
+import { parseOpenApi, parseOpenApiDocument } from "./parser/document.js";
+import { OperationsExportResult, defaultRestPath, exportOperations, generateOperationsRegistry, jsonSchemaForSpec, schemaModelToJsonSchema, toHttpMethod, toOperationId, toRestPath, toSchemaName } from "./exporter/operations.js";
+import { ContractSpecRegistries, contractSpecToJson, contractSpecToYaml, exportContractSpec, openApiForRegistry, openApiToJson, openApiToYaml } from "./exporter.js";
+import { ExportedEvent, exportEvents, generateEventsExports } from "./exporter/events.js";
+import { ExportedFeature, exportFeatures, generateFeaturesRegistry } from "./exporter/features.js";
+import { ExportedPresentation, ExportedPresentationV2, exportPresentations, exportPresentationsV1, exportPresentationsV2, generatePresentationsRegistry } from "./exporter/presentations.js";
+import { ExportedForm, exportForms, generateFormsRegistry } from "./exporter/forms.js";
+import { ExportedDataView, exportDataViews, generateDataViewsRegistry } from "./exporter/data-views.js";
+import { ExportedWorkflow, exportWorkflows, generateWorkflowsRegistry } from "./exporter/workflows.js";
+import { RegistryGenerationOptions, generateRegistryIndex } from "./exporter/registries.js";
 import { GeneratedModel, SchemaField, TypescriptType, generateImports, generateSchemaModelCode, getScalarType, jsonSchemaToField, jsonSchemaToType } from "./schema-converter.js";
+import { importFromOpenApi, importOperation } from "./importer/index.js";
 import { DiffOptions, createSpecDiff, diffAll, diffSpecVsOperation, diffSpecs, formatDiffChanges } from "./differ.js";
-export { type ContractSpecOpenApiDocument, type DiffOptions, type GeneratedModel, type HttpMethod, type OpenApiDocument, type OpenApiExportOptions, type OpenApiImportOptions, type OpenApiOperation, type OpenApiParameter, type OpenApiParseOptions, type OpenApiSchema, type OpenApiServer, type OpenApiSource, type OpenApiTransportHints, type OpenApiVersion, type ParameterLocation, type ParseResult, type ParsedOperation, type ParsedParameter, type SchemaField, type TypescriptType, createSpecDiff, defaultRestPath, detectFormat, detectVersion, diffAll, diffSpecVsOperation, diffSpecs, formatDiffChanges, generateImports, generateSchemaModelCode, getScalarType, importFromOpenApi, importOperation, jsonSchemaToField, jsonSchemaToType, openApiForRegistry, openApiToJson, openApiToYaml, parseOpenApi, parseOpenApiDocument, parseOpenApiString };
+export { type ContractSpecOpenApiDocument, type ContractSpecRegistries, type DiffOptions, ExportedDataView, ExportedEvent, ExportedFeature, ExportedForm, ExportedPresentation, ExportedPresentationV2, ExportedWorkflow, type GeneratedModel, type HttpMethod, type OpenApiDocument, type OpenApiExportOptions, type OpenApiOperation, type OpenApiParameter, type OpenApiParseOptions, type OpenApiSchema, type OpenApiServer, type OpenApiSource, type OpenApiTransportHints, type OpenApiVersion, OperationsExportResult, type ParameterLocation, type ParseResult, type ParsedOperation, type ParsedParameter, RegistryGenerationOptions, type SchemaField, type TypescriptType, contractSpecToJson, contractSpecToYaml, createSpecDiff, defaultRestPath, detectFormat, detectVersion, diffAll, diffSpecVsOperation, diffSpecs, exportContractSpec, exportDataViews, exportEvents, exportFeatures, exportForms, exportOperations, exportPresentations, exportPresentationsV1, exportPresentationsV2, exportWorkflows, formatDiffChanges, generateDataViewsRegistry, generateEventsExports, generateFeaturesRegistry, generateFormsRegistry, generateImports, generateOperationsRegistry, generatePresentationsRegistry, generateRegistryIndex, generateSchemaModelCode, generateWorkflowsRegistry, getScalarType, importFromOpenApi, importOperation, jsonSchemaForSpec, jsonSchemaToField, jsonSchemaToType, openApiForRegistry, openApiToJson, openApiToYaml, parseOpenApi, parseOpenApiDocument, parseOpenApiString, schemaModelToJsonSchema, toHttpMethod, toOperationId, toRestPath, toSchemaName };

package/dist/openapi/index.js

@@ -1,7 +1,18 @@
-import { detectFormat, detectVersion, parseOpenApi, parseOpenApiDocument, parseOpenApiString } from "./parser.js";
-import { defaultRestPath, openApiForRegistry, openApiToJson, openApiToYaml } from "./exporter.js";
+import { detectFormat, detectVersion, parseOpenApiString } from "./parser/utils.js";
+import { parseOpenApi, parseOpenApiDocument } from "./parser/document.js";
+import "./parser.js";
+import { defaultRestPath, exportOperations, generateOperationsRegistry, jsonSchemaForSpec, schemaModelToJsonSchema, toHttpMethod, toOperationId, toRestPath, toSchemaName } from "./exporter/operations.js";
+import { exportEvents, generateEventsExports } from "./exporter/events.js";
+import { exportFeatures, generateFeaturesRegistry } from "./exporter/features.js";
+import { exportPresentations, exportPresentationsV1, exportPresentationsV2, generatePresentationsRegistry } from "./exporter/presentations.js";
+import { exportForms, generateFormsRegistry } from "./exporter/forms.js";
+import { exportDataViews, generateDataViewsRegistry } from "./exporter/data-views.js";
+import { exportWorkflows, generateWorkflowsRegistry } from "./exporter/workflows.js";
+import { generateRegistryIndex } from "./exporter/registries.js";
+import { contractSpecToJson, contractSpecToYaml, exportContractSpec, openApiForRegistry, openApiToJson, openApiToYaml } from "./exporter.js";
+import "./exporter/index.js";
 import { generateImports, generateSchemaModelCode, getScalarType, jsonSchemaToField, jsonSchemaToType } from "./schema-converter.js";
-import { importFromOpenApi, importOperation } from "./importer.js";
+import { importFromOpenApi, importOperation } from "./importer/index.js";
 import { createSpecDiff, diffAll, diffSpecVsOperation, diffSpecs, formatDiffChanges } from "./differ.js";
 
-export { createSpecDiff, defaultRestPath, detectFormat, detectVersion, diffAll, diffSpecVsOperation, diffSpecs, formatDiffChanges, generateImports, generateSchemaModelCode, getScalarType, importFromOpenApi, importOperation, jsonSchemaToField, jsonSchemaToType, openApiForRegistry, openApiToJson, openApiToYaml, parseOpenApi, parseOpenApiDocument, parseOpenApiString };
+export { contractSpecToJson, contractSpecToYaml, createSpecDiff, defaultRestPath, detectFormat, detectVersion, diffAll, diffSpecVsOperation, diffSpecs, exportContractSpec, exportDataViews, exportEvents, exportFeatures, exportForms, exportOperations, exportPresentations, exportPresentationsV1, exportPresentationsV2, exportWorkflows, formatDiffChanges, generateDataViewsRegistry, generateEventsExports, generateFeaturesRegistry, generateFormsRegistry, generateImports, generateOperationsRegistry, generatePresentationsRegistry, generateRegistryIndex, generateSchemaModelCode, generateWorkflowsRegistry, getScalarType, importFromOpenApi, importOperation, jsonSchemaForSpec, jsonSchemaToField, jsonSchemaToType, openApiForRegistry, openApiToJson, openApiToYaml, parseOpenApi, parseOpenApiDocument, parseOpenApiString, schemaModelToJsonSchema, toHttpMethod, toOperationId, toRestPath, toSchemaName };

package/dist/openapi/parser/document.d.ts

@@ -0,0 +1,20 @@
+import { OpenApiDocument, OpenApiParseOptions, ParseResult } from "../types.js";
+
+//#region src/openapi/parser/document.d.ts
+
+/**
+ * Parse an OpenAPI document into a structured result.
+ */
+declare function parseOpenApiDocument(doc: OpenApiDocument, _options?: OpenApiParseOptions): ParseResult;
+/**
+ * Parse OpenAPI from a file path or URL.
+ * Note: This is an async function that requires I/O adapters.
+ * For pure parsing, use parseOpenApiString or parseOpenApiDocument.
+ */
+declare function parseOpenApi(source: string, options?: OpenApiParseOptions & {
+  fetch?: typeof globalThis.fetch;
+  readFile?: (path: string) => Promise<string>;
+}): Promise<ParseResult>;
+//#endregion
+export { parseOpenApi, parseOpenApiDocument };
+//# sourceMappingURL=document.d.ts.map

package/dist/openapi/parser/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","names":[],"sources":["../../../src/openapi/parser/document.ts"],"sourcesContent":[],"mappings":";;;;;;AAsBA;AACO,iBADS,oBAAA,CACT,GAAA,EAAA,eAAA,EAAA,QAAA,CAAA,EACK,mBADL,CAAA,EAEJ,WAFI;;;;AA0GP;;AAGmB,iBAHG,YAAA,CAGQ,MAAA,EAAA,MAAA,EAAA,OAG3B,CAH2B,EADnB,mBACmB,GAAA;EACG,KAAA,CAAA,EAAA,OADd,UAAA,CAAW,KACG;EAEtB,QAAA,CAAA,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAFsB,OAEtB,CAAA,MAAA,CAAA;CAAR,CAAA,EAAA,OAAA,CAAQ,WAAR,CAAA"}

package/dist/openapi/parser/document.js

@@ -0,0 +1,95 @@
+import { HTTP_METHODS, detectFormat, detectVersion, parseOpenApiString } from "./utils.js";
+import { parseOperation } from "./operation.js";
+
+//#region src/openapi/parser/document.ts
+/**
+* Parse an OpenAPI document into a structured result.
+*/
+function parseOpenApiDocument(doc, _options = {}) {
+	const version = detectVersion(doc);
+	const warnings = [];
+	const operations = [];
+	for (const [path, pathItem] of Object.entries(doc.paths ?? {})) {
+		if (!pathItem) continue;
+		const pathParams = pathItem.parameters;
+		for (const method of HTTP_METHODS) {
+			const operation = pathItem[method];
+			if (operation) try {
+				operations.push(parseOperation(doc, method, path, operation, pathParams));
+			} catch (error) {
+				warnings.push(`Failed to parse ${method.toUpperCase()} ${path}: ${error}`);
+			}
+		}
+	}
+	const schemas = {};
+	const components = doc.components;
+	if (components?.schemas) for (const [name, schema] of Object.entries(components.schemas)) schemas[name] = schema;
+	const servers = (doc.servers ?? []).map((s) => ({
+		url: s.url,
+		description: s.description,
+		variables: s.variables
+	}));
+	const events = [];
+	if ("webhooks" in doc && doc.webhooks) for (const [name, pathItem] of Object.entries(doc.webhooks)) {
+		if (typeof pathItem !== "object" || !pathItem) continue;
+		const operation = pathItem["post"];
+		if (operation && operation.requestBody) {
+			if ("$ref" in operation.requestBody) throw new Error(`'$ref' isn't supported`);
+			const content = operation.requestBody.content?.["application/json"];
+			if (content?.schema) events.push({
+				name,
+				description: operation.summary || operation.description,
+				payload: content.schema
+			});
+		}
+	}
+	return {
+		document: doc,
+		version,
+		info: {
+			title: doc.info.title,
+			version: doc.info.version,
+			description: doc.info.description
+		},
+		operations,
+		schemas,
+		servers,
+		warnings,
+		events
+	};
+}
+/**
+* Parse OpenAPI from a file path or URL.
+* Note: This is an async function that requires I/O adapters.
+* For pure parsing, use parseOpenApiString or parseOpenApiDocument.
+*/
+async function parseOpenApi(source, options = {}) {
+	const { fetch: fetchFn = globalThis.fetch, readFile, timeout = 3e4 } = options;
+	let content;
+	let format;
+	if (source.startsWith("http://") || source.startsWith("https://")) {
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), timeout);
+		try {
+			const response = await fetchFn(source, { signal: controller.signal });
+			if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+			content = await response.text();
+		} finally {
+			clearTimeout(timeoutId);
+		}
+		if (source.endsWith(".yaml") || source.endsWith(".yml")) format = "yaml";
+		else if (source.endsWith(".json")) format = "json";
+		else format = detectFormat(content);
+	} else {
+		if (!readFile) throw new Error("readFile adapter required for file paths");
+		content = await readFile(source);
+		if (source.endsWith(".yaml") || source.endsWith(".yml")) format = "yaml";
+		else if (source.endsWith(".json")) format = "json";
+		else format = detectFormat(content);
+	}
+	return parseOpenApiDocument(parseOpenApiString(content, format), options);
+}
+
+//#endregion
+export { parseOpenApi, parseOpenApiDocument };
+//# sourceMappingURL=document.js.map

package/dist/openapi/parser/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","names":["warnings: string[]","operations: ParsedOperation[]","schemas: Record<string, OpenApiSchema>","servers: OpenApiServer[]","events: ParsedEvent[]","content: string","format: 'json' | 'yaml'"],"sources":["../../../src/openapi/parser/document.ts"],"sourcesContent":["import type {\n  OpenApiDocument,\n  OpenApiParameter,\n  OpenApiParseOptions,\n  OpenApiSchema,\n  OpenApiServer,\n  ParsedEvent,\n  ParsedOperation,\n  ParseResult,\n} from '../types';\nimport type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';\nimport {\n  detectFormat,\n  detectVersion,\n  HTTP_METHODS,\n  parseOpenApiString,\n} from './utils';\nimport { parseOperation } from './operation';\n\n/**\n * Parse an OpenAPI document into a structured result.\n */\nexport function parseOpenApiDocument(\n  doc: OpenApiDocument,\n  _options: OpenApiParseOptions = {}\n): ParseResult {\n  const version = detectVersion(doc);\n  const warnings: string[] = [];\n  const operations: ParsedOperation[] = [];\n\n  // Parse operations from paths\n  for (const [path, pathItem] of Object.entries(doc.paths ?? {})) {\n    if (!pathItem) continue;\n\n    // Get path-level parameters\n    const pathParams = (pathItem as OpenAPIV3.PathItemObject).parameters;\n\n    for (const method of HTTP_METHODS) {\n      const operation = (pathItem as Record<string, unknown>)[method] as\n        | OpenAPIV3.OperationObject\n        | OpenAPIV3_1.OperationObject\n        | undefined;\n\n      if (operation) {\n        try {\n          operations.push(\n            parseOperation(\n              doc,\n              method,\n              path,\n              operation,\n              pathParams as OpenApiParameter[]\n            )\n          );\n        } catch (error) {\n          warnings.push(\n            `Failed to parse ${method.toUpperCase()} ${path}: ${error}`\n          );\n        }\n      }\n    }\n  }\n\n  // Extract component schemas\n  const schemas: Record<string, OpenApiSchema> = {};\n  const components = doc.components;\n  if (components?.schemas) {\n    for (const [name, schema] of Object.entries(components.schemas)) {\n      schemas[name] = schema as OpenApiSchema;\n    }\n  }\n\n  // Parse servers\n  // Parse servers\n  const servers: OpenApiServer[] = (doc.servers ?? []).map((s) => ({\n    url: s.url,\n    description: s.description,\n    variables: s.variables as OpenApiServer['variables'],\n  }));\n\n  // Parse webhooks (as events)\n  const events: ParsedEvent[] = [];\n  if ('webhooks' in doc && doc.webhooks) {\n    for (const [name, pathItem] of Object.entries(doc.webhooks)) {\n      if (typeof pathItem !== 'object' || !pathItem) continue;\n      // Webhooks usually have a POST method defining the payload\n      const operation = (pathItem as Record<string, unknown>)['post'] as\n        | OpenAPIV3.OperationObject\n        | OpenAPIV3_1.OperationObject\n        | undefined;\n\n      if (operation && operation.requestBody) {\n        if ('$ref' in operation.requestBody) {\n          throw new Error(`'$ref' isn't supported`);\n        }\n        // Extract payload schema\n        const content = operation.requestBody.content?.['application/json'];\n        if (content?.schema) {\n          events.push({\n            name,\n            description: operation.summary || operation.description,\n            payload: content.schema,\n          });\n        }\n      }\n    }\n  }\n\n  return {\n    document: doc,\n    version,\n    info: {\n      title: doc.info.title,\n      version: doc.info.version,\n      description: doc.info.description,\n    },\n    operations,\n    schemas,\n    servers,\n    warnings,\n    events,\n  };\n}\n\n/**\n * Parse OpenAPI from a file path or URL.\n * Note: This is an async function that requires I/O adapters.\n * For pure parsing, use parseOpenApiString or parseOpenApiDocument.\n */\nexport async function parseOpenApi(\n  source: string,\n  options: OpenApiParseOptions & {\n    fetch?: typeof globalThis.fetch;\n    readFile?: (path: string) => Promise<string>;\n  } = {}\n): Promise<ParseResult> {\n  const {\n    fetch: fetchFn = globalThis.fetch,\n    readFile,\n    timeout = 30000,\n  } = options;\n\n  let content: string;\n  let format: 'json' | 'yaml';\n\n  if (source.startsWith('http://') || source.startsWith('https://')) {\n    // Fetch from URL\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n    try {\n      const response = await fetchFn(source, { signal: controller.signal });\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n      content = await response.text();\n    } finally {\n      clearTimeout(timeoutId);\n    }\n\n    // Detect format from URL or content\n    if (source.endsWith('.yaml') || source.endsWith('.yml')) {\n      format = 'yaml';\n    } else if (source.endsWith('.json')) {\n      format = 'json';\n    } else {\n      format = detectFormat(content);\n    }\n  } else {\n    // Read from file\n    if (!readFile) {\n      throw new Error('readFile adapter required for file paths');\n    }\n    content = await readFile(source);\n\n    // Detect format from extension or content\n    if (source.endsWith('.yaml') || source.endsWith('.yml')) {\n      format = 'yaml';\n    } else if (source.endsWith('.json')) {\n      format = 'json';\n    } else {\n      format = detectFormat(content);\n    }\n  }\n\n  const doc = parseOpenApiString(content, format);\n  return parseOpenApiDocument(doc, options);\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,qBACd,KACA,WAAgC,EAAE,EACrB;CACb,MAAM,UAAU,cAAc,IAAI;CAClC,MAAMA,WAAqB,EAAE;CAC7B,MAAMC,aAAgC,EAAE;AAGxC,MAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,IAAI,SAAS,EAAE,CAAC,EAAE;AAC9D,MAAI,CAAC,SAAU;EAGf,MAAM,aAAc,SAAsC;AAE1D,OAAK,MAAM,UAAU,cAAc;GACjC,MAAM,YAAa,SAAqC;AAKxD,OAAI,UACF,KAAI;AACF,eAAW,KACT,eACE,KACA,QACA,MACA,WACA,WACD,CACF;YACM,OAAO;AACd,aAAS,KACP,mBAAmB,OAAO,aAAa,CAAC,GAAG,KAAK,IAAI,QACrD;;;;CAOT,MAAMC,UAAyC,EAAE;CACjD,MAAM,aAAa,IAAI;AACvB,KAAI,YAAY,QACd,MAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,WAAW,QAAQ,CAC7D,SAAQ,QAAQ;CAMpB,MAAMC,WAA4B,IAAI,WAAW,EAAE,EAAE,KAAK,OAAO;EAC/D,KAAK,EAAE;EACP,aAAa,EAAE;EACf,WAAW,EAAE;EACd,EAAE;CAGH,MAAMC,SAAwB,EAAE;AAChC,KAAI,cAAc,OAAO,IAAI,SAC3B,MAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,IAAI,SAAS,EAAE;AAC3D,MAAI,OAAO,aAAa,YAAY,CAAC,SAAU;EAE/C,MAAM,YAAa,SAAqC;AAKxD,MAAI,aAAa,UAAU,aAAa;AACtC,OAAI,UAAU,UAAU,YACtB,OAAM,IAAI,MAAM,yBAAyB;GAG3C,MAAM,UAAU,UAAU,YAAY,UAAU;AAChD,OAAI,SAAS,OACX,QAAO,KAAK;IACV;IACA,aAAa,UAAU,WAAW,UAAU;IAC5C,SAAS,QAAQ;IAClB,CAAC;;;AAMV,QAAO;EACL,UAAU;EACV;EACA,MAAM;GACJ,OAAO,IAAI,KAAK;GAChB,SAAS,IAAI,KAAK;GAClB,aAAa,IAAI,KAAK;GACvB;EACD;EACA;EACA;EACA;EACA;EACD;;;;;;;AAQH,eAAsB,aACpB,QACA,UAGI,EAAE,EACgB;CACtB,MAAM,EACJ,OAAO,UAAU,WAAW,OAC5B,UACA,UAAU,QACR;CAEJ,IAAIC;CACJ,IAAIC;AAEJ,KAAI,OAAO,WAAW,UAAU,IAAI,OAAO,WAAW,WAAW,EAAE;EAEjE,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,QAAQ;AAE/D,MAAI;GACF,MAAM,WAAW,MAAM,QAAQ,QAAQ,EAAE,QAAQ,WAAW,QAAQ,CAAC;AACrE,OAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,QAAQ,SAAS,OAAO,IAAI,SAAS,aAAa;AAEpE,aAAU,MAAM,SAAS,MAAM;YACvB;AACR,gBAAa,UAAU;;AAIzB,MAAI,OAAO,SAAS,QAAQ,IAAI,OAAO,SAAS,OAAO,CACrD,UAAS;WACA,OAAO,SAAS,QAAQ,CACjC,UAAS;MAET,UAAS,aAAa,QAAQ;QAE3B;AAEL,MAAI,CAAC,SACH,OAAM,IAAI,MAAM,2CAA2C;AAE7D,YAAU,MAAM,SAAS,OAAO;AAGhC,MAAI,OAAO,SAAS,QAAQ,IAAI,OAAO,SAAS,OAAO,CACrD,UAAS;WACA,OAAO,SAAS,QAAQ,CACjC,UAAS;MAET,UAAS,aAAa,QAAQ;;AAKlC,QAAO,qBADK,mBAAmB,SAAS,OAAO,EACd,QAAQ"}

package/dist/openapi/parser/index.js

@@ -0,0 +1,5 @@
+import { HTTP_METHODS, detectFormat, detectVersion, generateOperationId, parseOpenApiString } from "./utils.js";
+import { dereferenceSchema, isReference, resolveRef } from "./resolvers.js";
+import { parseParameters } from "./parameters.js";
+import { parseOperation } from "./operation.js";
+import { parseOpenApi, parseOpenApiDocument } from "./document.js";

package/dist/openapi/parser/operation.js

@@ -0,0 +1,59 @@
+import { generateOperationId } from "./utils.js";
+import { dereferenceSchema, isReference, resolveRef } from "./resolvers.js";
+import { parseParameters } from "./parameters.js";
+
+//#region src/openapi/parser/operation.ts
+/**
+* Parse a single operation.
+*/
+function parseOperation(doc, method, path, operation, pathParams) {
+	const params = parseParameters(doc, [...pathParams ?? [], ...operation.parameters ?? []]);
+	let requestBody;
+	if (operation.requestBody) {
+		const body = isReference(operation.requestBody) ? resolveRef(doc, operation.requestBody.$ref) : operation.requestBody;
+		if (body) {
+			const contentType = Object.keys(body.content ?? {})[0] ?? "application/json";
+			const content = body.content?.[contentType];
+			if (content?.schema) requestBody = {
+				required: body.required ?? false,
+				schema: dereferenceSchema(doc, content.schema) ?? {},
+				contentType
+			};
+		}
+	}
+	const responses = {};
+	for (const [status, response] of Object.entries(operation.responses ?? {})) {
+		const resolved = isReference(response) ? resolveRef(doc, response.$ref) : response;
+		if (resolved) {
+			const contentType = Object.keys(resolved.content ?? {})[0];
+			const content = contentType ? resolved.content?.[contentType] : void 0;
+			responses[status] = {
+				description: resolved.description,
+				schema: content?.schema ? dereferenceSchema(doc, content.schema) : void 0,
+				contentType
+			};
+		}
+	}
+	const contractSpecMeta = operation?.["x-contractspec"];
+	return {
+		operationId: operation.operationId ?? generateOperationId(method, path),
+		method,
+		path,
+		summary: operation.summary,
+		description: operation.description,
+		tags: operation.tags ?? [],
+		pathParams: params.path,
+		queryParams: params.query,
+		headerParams: params.header,
+		cookieParams: params.cookie,
+		requestBody,
+		responses,
+		deprecated: operation.deprecated ?? false,
+		security: operation.security,
+		contractSpecMeta
+	};
+}
+
+//#endregion
+export { parseOperation };
+//# sourceMappingURL=operation.js.map

package/dist/openapi/parser/operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.js","names":["requestBody: ParsedOperation['requestBody']","responses: ParsedOperation['responses']"],"sources":["../../../src/openapi/parser/operation.ts"],"sourcesContent":["import type {\n  HttpMethod,\n  OpenApiDocument,\n  OpenApiParameter,\n  OpenApiSchema,\n  ParsedOperation,\n} from '../types';\nimport type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';\nimport { dereferenceSchema, isReference, resolveRef } from './resolvers';\nimport { parseParameters } from './parameters';\nimport { generateOperationId } from './utils';\n\n/**\n * Parse a single operation.\n */\nexport function parseOperation(\n  doc: OpenApiDocument,\n  method: HttpMethod,\n  path: string,\n  operation: OpenAPIV3.OperationObject | OpenAPIV3_1.OperationObject,\n  pathParams: OpenApiParameter[] | undefined\n): ParsedOperation {\n  // Merge path-level and operation-level parameters\n  const allParams = [...(pathParams ?? []), ...(operation.parameters ?? [])];\n  const params = parseParameters(doc, allParams as OpenApiParameter[]);\n\n  // Parse request body\n  let requestBody: ParsedOperation['requestBody'];\n  if (operation.requestBody) {\n    const body = isReference(operation.requestBody)\n      ? resolveRef<OpenAPIV3.RequestBodyObject | OpenAPIV3_1.RequestBodyObject>(\n          doc,\n          operation.requestBody.$ref\n        )\n      : operation.requestBody;\n\n    if (body) {\n      const contentType =\n        Object.keys(body.content ?? {})[0] ?? 'application/json';\n      const content = body.content?.[contentType];\n      if (content?.schema) {\n        requestBody = {\n          required: body.required ?? false,\n          schema:\n            dereferenceSchema(doc, content.schema as OpenApiSchema) ??\n            ({} as OpenApiSchema),\n          contentType,\n        };\n      }\n    }\n  }\n\n  // Parse responses\n  const responses: ParsedOperation['responses'] = {};\n  for (const [status, response] of Object.entries(operation.responses ?? {})) {\n    const resolved = isReference(response)\n      ? resolveRef<OpenAPIV3.ResponseObject | OpenAPIV3_1.ResponseObject>(\n          doc,\n          response.$ref\n        )\n      : response;\n\n    if (resolved) {\n      const contentType = Object.keys(resolved.content ?? {})[0];\n      const content = contentType ? resolved.content?.[contentType] : undefined;\n\n      responses[status] = {\n        description: resolved.description,\n        schema: content?.schema\n          ? dereferenceSchema(doc, content.schema as OpenApiSchema)\n          : undefined,\n        contentType,\n      };\n    }\n  }\n\n  // Check for x-contractspec extension\n  const contractSpecMeta = (operation as Record<string, unknown>)?.[\n    'x-contractspec'\n  ] as ParsedOperation['contractSpecMeta'];\n\n  return {\n    operationId: operation.operationId ?? generateOperationId(method, path),\n    method,\n    path,\n    summary: operation.summary,\n    description: operation.description,\n    tags: operation.tags ?? [],\n    pathParams: params.path,\n    queryParams: params.query,\n    headerParams: params.header,\n    cookieParams: params.cookie,\n    requestBody,\n    responses,\n    deprecated: operation.deprecated ?? false,\n    security: operation.security as ParsedOperation['security'],\n    contractSpecMeta,\n  };\n}\n"],"mappings":";;;;;;;;AAeA,SAAgB,eACd,KACA,QACA,MACA,WACA,YACiB;CAGjB,MAAM,SAAS,gBAAgB,KADb,CAAC,GAAI,cAAc,EAAE,EAAG,GAAI,UAAU,cAAc,EAAE,CAAE,CACN;CAGpE,IAAIA;AACJ,KAAI,UAAU,aAAa;EACzB,MAAM,OAAO,YAAY,UAAU,YAAY,GAC3C,WACE,KACA,UAAU,YAAY,KACvB,GACD,UAAU;AAEd,MAAI,MAAM;GACR,MAAM,cACJ,OAAO,KAAK,KAAK,WAAW,EAAE,CAAC,CAAC,MAAM;GACxC,MAAM,UAAU,KAAK,UAAU;AAC/B,OAAI,SAAS,OACX,eAAc;IACZ,UAAU,KAAK,YAAY;IAC3B,QACE,kBAAkB,KAAK,QAAQ,OAAwB,IACtD,EAAE;IACL;IACD;;;CAMP,MAAMC,YAA0C,EAAE;AAClD,MAAK,MAAM,CAAC,QAAQ,aAAa,OAAO,QAAQ,UAAU,aAAa,EAAE,CAAC,EAAE;EAC1E,MAAM,WAAW,YAAY,SAAS,GAClC,WACE,KACA,SAAS,KACV,GACD;AAEJ,MAAI,UAAU;GACZ,MAAM,cAAc,OAAO,KAAK,SAAS,WAAW,EAAE,CAAC,CAAC;GACxD,MAAM,UAAU,cAAc,SAAS,UAAU,eAAe;AAEhE,aAAU,UAAU;IAClB,aAAa,SAAS;IACtB,QAAQ,SAAS,SACb,kBAAkB,KAAK,QAAQ,OAAwB,GACvD;IACJ;IACD;;;CAKL,MAAM,mBAAoB,YACxB;AAGF,QAAO;EACL,aAAa,UAAU,eAAe,oBAAoB,QAAQ,KAAK;EACvE;EACA;EACA,SAAS,UAAU;EACnB,aAAa,UAAU;EACvB,MAAM,UAAU,QAAQ,EAAE;EAC1B,YAAY,OAAO;EACnB,aAAa,OAAO;EACpB,cAAc,OAAO;EACrB,cAAc,OAAO;EACrB;EACA;EACA,YAAY,UAAU,cAAc;EACpC,UAAU,UAAU;EACpB;EACD"}

package/dist/openapi/parser/parameters.js

@@ -0,0 +1,37 @@
+import { dereferenceSchema, isReference, resolveRef } from "./resolvers.js";
+
+//#region src/openapi/parser/parameters.ts
+/**
+* Parse parameters from an operation.
+*/
+function parseParameters(doc, params) {
+	const result = {
+		path: [],
+		query: [],
+		header: [],
+		cookie: []
+	};
+	if (!params) return result;
+	for (const param of params) {
+		let resolved;
+		if (isReference(param)) {
+			const ref = resolveRef(doc, param.$ref);
+			if (!ref) continue;
+			resolved = ref;
+		} else resolved = param;
+		const parsed = {
+			name: resolved.name,
+			in: resolved.in,
+			required: resolved.required ?? resolved.in === "path",
+			description: resolved.description,
+			schema: dereferenceSchema(doc, resolved.schema),
+			deprecated: resolved.deprecated ?? false
+		};
+		result[resolved.in]?.push(parsed);
+	}
+	return result;
+}
+
+//#endregion
+export { parseParameters };
+//# sourceMappingURL=parameters.js.map

package/dist/openapi/parser/parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.js","names":["resolved: OpenAPIV3.ParameterObject | OpenAPIV3_1.ParameterObject","parsed: ParsedParameter"],"sources":["../../../src/openapi/parser/parameters.ts"],"sourcesContent":["import type {\n  OpenApiDocument,\n  OpenApiParameter,\n  ParsedParameter,\n  OpenApiSchema,\n} from '../types';\nimport type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';\nimport { isReference, resolveRef, dereferenceSchema } from './resolvers';\n\n/**\n * Parse parameters from an operation.\n */\nexport function parseParameters(\n  doc: OpenApiDocument,\n  params: OpenApiParameter[] | undefined\n): {\n  path: ParsedParameter[];\n  query: ParsedParameter[];\n  header: ParsedParameter[];\n  cookie: ParsedParameter[];\n} {\n  const result = {\n    path: [] as ParsedParameter[],\n    query: [] as ParsedParameter[],\n    header: [] as ParsedParameter[],\n    cookie: [] as ParsedParameter[],\n  };\n\n  if (!params) return result;\n\n  for (const param of params) {\n    let resolved: OpenAPIV3.ParameterObject | OpenAPIV3_1.ParameterObject;\n\n    if (isReference(param)) {\n      const ref = resolveRef<\n        OpenAPIV3.ParameterObject | OpenAPIV3_1.ParameterObject\n      >(doc, param.$ref);\n      if (!ref) continue;\n      resolved = ref;\n    } else {\n      resolved = param;\n    }\n\n    const parsed: ParsedParameter = {\n      name: resolved.name,\n      in: resolved.in as ParsedParameter['in'],\n      required: resolved.required ?? resolved.in === 'path',\n      description: resolved.description,\n      schema: dereferenceSchema(\n        doc,\n        resolved.schema as OpenApiSchema\n      ) as OpenApiSchema,\n      deprecated: resolved.deprecated ?? false,\n    };\n\n    result[resolved.in as keyof typeof result]?.push(parsed);\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;AAYA,SAAgB,gBACd,KACA,QAMA;CACA,MAAM,SAAS;EACb,MAAM,EAAE;EACR,OAAO,EAAE;EACT,QAAQ,EAAE;EACV,QAAQ,EAAE;EACX;AAED,KAAI,CAAC,OAAQ,QAAO;AAEpB,MAAK,MAAM,SAAS,QAAQ;EAC1B,IAAIA;AAEJ,MAAI,YAAY,MAAM,EAAE;GACtB,MAAM,MAAM,WAEV,KAAK,MAAM,KAAK;AAClB,OAAI,CAAC,IAAK;AACV,cAAW;QAEX,YAAW;EAGb,MAAMC,SAA0B;GAC9B,MAAM,SAAS;GACf,IAAI,SAAS;GACb,UAAU,SAAS,YAAY,SAAS,OAAO;GAC/C,aAAa,SAAS;GACtB,QAAQ,kBACN,KACA,SAAS,OACV;GACD,YAAY,SAAS,cAAc;GACpC;AAED,SAAO,SAAS,KAA4B,KAAK,OAAO;;AAG1D,QAAO"}