@contractspec/lib.contracts-transformers 1.57.0 → 1.58.0

package/dist/openapi/parser/operation.js

@@ -1,59 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"operation.js","names":[],"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,IAAI;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,MAAM,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

@@ -1,37 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"parameters.js","names":[],"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,IAAI;AAEJ,MAAI,YAAY,MAAM,EAAE;GACtB,MAAM,MAAM,WAEV,KAAK,MAAM,KAAK;AAClB,OAAI,CAAC,IAAK;AACV,cAAW;QAEX,YAAW;EAGb,MAAM,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"}

package/dist/openapi/parser/resolvers.js

@@ -1,63 +0,0 @@
-//#region src/openapi/parser/resolvers.ts
-/**
-* Check if a value is a reference object.
-*/
-function isReference(obj) {
-	return typeof obj === "object" && obj !== null && "$ref" in obj;
-}
-/**
-* Resolve a $ref reference in the document.
-*/
-function resolveRef(doc, ref) {
-	if (!ref.startsWith("#/")) return;
-	const path = ref.slice(2).split("/");
-	let current = doc;
-	for (const part of path) {
-		if (current === null || current === void 0) return void 0;
-		if (typeof current !== "object") return void 0;
-		current = current[part];
-	}
-	return current;
-}
-/**
-* Recursively dereference a schema.
-* Replaces all $ref with their resolved values.
-* Preserves `_originalRef` to track where the schema came from.
-*/
-function dereferenceSchema(doc, schema, seen = /* @__PURE__ */ new Set()) {
-	if (!schema) return void 0;
-	if (isReference(schema)) {
-		if (seen.has(schema.$ref)) return schema;
-		const newSeen = new Set(seen);
-		newSeen.add(schema.$ref);
-		const resolved = resolveRef(doc, schema.$ref);
-		if (!resolved) return schema;
-		const dereferenced = dereferenceSchema(doc, resolved, newSeen);
-		if (!dereferenced) return schema;
-		const refParts = schema.$ref.split("/");
-		const typeName = refParts[refParts.length - 1];
-		return {
-			...dereferenced,
-			_originalRef: schema.$ref,
-			_originalTypeName: typeName
-		};
-	}
-	const schemaObj = { ...schema };
-	if (schemaObj.properties) {
-		const props = schemaObj.properties;
-		const newProps = {};
-		for (const [key, prop] of Object.entries(props)) newProps[key] = dereferenceSchema(doc, prop, seen) ?? prop;
-		schemaObj.properties = newProps;
-	}
-	if (schemaObj.items) schemaObj.items = dereferenceSchema(doc, schemaObj.items, seen);
-	for (const comb of [
-		"allOf",
-		"anyOf",
-		"oneOf"
-	]) if (Array.isArray(schemaObj[comb])) schemaObj[comb] = schemaObj[comb].map((s) => dereferenceSchema(doc, s, seen) ?? s);
-	return schemaObj;
-}
-
-//#endregion
-export { dereferenceSchema, isReference, resolveRef };
-//# sourceMappingURL=resolvers.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"resolvers.js","names":[],"sources":["../../../src/openapi/parser/resolvers.ts"],"sourcesContent":["import type { OpenApiDocument, OpenApiSchema } from '../types';\nimport type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';\n\n/**\n * Check if a value is a reference object.\n */\nexport function isReference(\n  obj: unknown\n): obj is OpenAPIV3.ReferenceObject | OpenAPIV3_1.ReferenceObject {\n  return typeof obj === 'object' && obj !== null && '$ref' in obj;\n}\n\n/**\n * Resolve a $ref reference in the document.\n */\nexport function resolveRef<T>(\n  doc: OpenApiDocument,\n  ref: string\n): T | undefined {\n  // Only support local refs for now\n  if (!ref.startsWith('#/')) {\n    return undefined;\n  }\n\n  const path = ref.slice(2).split('/');\n  let current: unknown = doc;\n\n  for (const part of path) {\n    if (current === null || current === undefined) return undefined;\n    if (typeof current !== 'object') return undefined;\n    current = (current as Record<string, unknown>)[part];\n  }\n\n  return current as T;\n}\n\n/**\n * Resolve a schema, following $ref if needed.\n */\nexport function resolveSchema(\n  doc: OpenApiDocument,\n  schema: OpenApiSchema | undefined\n): OpenApiSchema | undefined {\n  if (!schema) return undefined;\n  if (isReference(schema)) {\n    return resolveRef<OpenApiSchema>(doc, schema.$ref) ?? schema;\n  }\n  return schema;\n}\n\n/**\n * Recursively dereference a schema.\n * Replaces all $ref with their resolved values.\n * Preserves `_originalRef` to track where the schema came from.\n */\nexport function dereferenceSchema(\n  doc: OpenApiDocument,\n  schema: OpenApiSchema | undefined,\n  seen = new Set<string>()\n): OpenApiSchema | undefined {\n  if (!schema) return undefined;\n\n  // Handle references\n  if (isReference(schema)) {\n    // Avoid infinite recursion for cycles\n    if (seen.has(schema.$ref)) {\n      return schema; // Keep reference for cycles\n    }\n\n    // Create new seen set for this branch\n    const newSeen = new Set(seen);\n    newSeen.add(schema.$ref);\n\n    const resolved = resolveRef<OpenApiSchema>(doc, schema.$ref);\n    if (!resolved) return schema;\n\n    // Recursively dereference the resolved schema\n    const dereferenced = dereferenceSchema(doc, resolved, newSeen);\n    if (!dereferenced) return schema;\n\n    // IMPORTANT: Preserve the original $ref so we can generate correct imports\n    // Extract the type name from the $ref (e.g., '#/components/schemas/PaginationMeta' -> 'PaginationMeta')\n    const refParts = schema.$ref.split('/');\n    const typeName = refParts[refParts.length - 1];\n    return {\n      ...dereferenced,\n      _originalRef: schema.$ref,\n      _originalTypeName: typeName,\n    } as unknown as OpenApiSchema;\n  }\n\n  // Deep clone to avoid mutating original doc (if we were modifying in place, but here we return new objects mostly)\n  // For simplicity, we just walk properties\n  const schemaObj = { ...schema } as Record<string, unknown>;\n\n  // Handle nested schemas in properties\n  if (schemaObj.properties) {\n    const props = schemaObj.properties as Record<string, OpenApiSchema>;\n    const newProps: Record<string, OpenApiSchema> = {};\n    for (const [key, prop] of Object.entries(props)) {\n      newProps[key] = dereferenceSchema(doc, prop, seen) ?? prop;\n    }\n    schemaObj.properties = newProps;\n  }\n\n  // Handle nested schema in items (array)\n  if (schemaObj.items) {\n    schemaObj.items = dereferenceSchema(\n      doc,\n      schemaObj.items as OpenApiSchema,\n      seen\n    );\n  }\n\n  // Handle allOf, anyOf, oneOf\n  const combinators = ['allOf', 'anyOf', 'oneOf'];\n  for (const comb of combinators) {\n    if (Array.isArray(schemaObj[comb])) {\n      schemaObj[comb] = (schemaObj[comb] as OpenApiSchema[]).map(\n        (s) => dereferenceSchema(doc, s, seen) ?? s\n      );\n    }\n  }\n\n  return schemaObj as OpenApiSchema;\n}\n"],"mappings":";;;;AAMA,SAAgB,YACd,KACgE;AAChE,QAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,UAAU;;;;;AAM9D,SAAgB,WACd,KACA,KACe;AAEf,KAAI,CAAC,IAAI,WAAW,KAAK,CACvB;CAGF,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC,MAAM,IAAI;CACpC,IAAI,UAAmB;AAEvB,MAAK,MAAM,QAAQ,MAAM;AACvB,MAAI,YAAY,QAAQ,YAAY,OAAW,QAAO;AACtD,MAAI,OAAO,YAAY,SAAU,QAAO;AACxC,YAAW,QAAoC;;AAGjD,QAAO;;;;;;;AAsBT,SAAgB,kBACd,KACA,QACA,uBAAO,IAAI,KAAa,EACG;AAC3B,KAAI,CAAC,OAAQ,QAAO;AAGpB,KAAI,YAAY,OAAO,EAAE;AAEvB,MAAI,KAAK,IAAI,OAAO,KAAK,CACvB,QAAO;EAIT,MAAM,UAAU,IAAI,IAAI,KAAK;AAC7B,UAAQ,IAAI,OAAO,KAAK;EAExB,MAAM,WAAW,WAA0B,KAAK,OAAO,KAAK;AAC5D,MAAI,CAAC,SAAU,QAAO;EAGtB,MAAM,eAAe,kBAAkB,KAAK,UAAU,QAAQ;AAC9D,MAAI,CAAC,aAAc,QAAO;EAI1B,MAAM,WAAW,OAAO,KAAK,MAAM,IAAI;EACvC,MAAM,WAAW,SAAS,SAAS,SAAS;AAC5C,SAAO;GACL,GAAG;GACH,cAAc,OAAO;GACrB,mBAAmB;GACpB;;CAKH,MAAM,YAAY,EAAE,GAAG,QAAQ;AAG/B,KAAI,UAAU,YAAY;EACxB,MAAM,QAAQ,UAAU;EACxB,MAAM,WAA0C,EAAE;AAClD,OAAK,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,MAAM,CAC7C,UAAS,OAAO,kBAAkB,KAAK,MAAM,KAAK,IAAI;AAExD,YAAU,aAAa;;AAIzB,KAAI,UAAU,MACZ,WAAU,QAAQ,kBAChB,KACA,UAAU,OACV,KACD;AAKH,MAAK,MAAM,QADS;EAAC;EAAS;EAAS;EAAQ,CAE7C,KAAI,MAAM,QAAQ,UAAU,MAAM,CAChC,WAAU,QAAS,UAAU,MAA0B,KACpD,MAAM,kBAAkB,KAAK,GAAG,KAAK,IAAI,EAC3C;AAIL,QAAO"}

package/dist/openapi/parser/utils.js

@@ -1,48 +0,0 @@
-import { parse } from "yaml";
-
-//#region src/openapi/parser/utils.ts
-const HTTP_METHODS = [
-	"get",
-	"post",
-	"put",
-	"delete",
-	"patch",
-	"head",
-	"options",
-	"trace"
-];
-/**
-* Parse an OpenAPI document from a string (JSON or YAML).
-*/
-function parseOpenApiString(content, format = "json") {
-	if (format === "yaml") return parse(content);
-	return JSON.parse(content);
-}
-/**
-* Detect the format of content (JSON or YAML).
-*/
-function detectFormat(content) {
-	const trimmed = content.trim();
-	if (trimmed.startsWith("{") || trimmed.startsWith("[")) return "json";
-	return "yaml";
-}
-/**
-* Detect OpenAPI version from document.
-*/
-function detectVersion(doc) {
-	if (doc.openapi.startsWith("3.1")) return "3.1";
-	return "3.0";
-}
-/**
-* Generate an operationId if not present.
-*/
-function generateOperationId(method, path) {
-	return method + path.split("/").filter(Boolean).map((part) => {
-		if (part.startsWith("{") && part.endsWith("}")) return "By" + part.slice(1, -1).charAt(0).toUpperCase() + part.slice(2, -1);
-		return part.charAt(0).toUpperCase() + part.slice(1);
-	}).join("");
-}
-
-//#endregion
-export { HTTP_METHODS, detectFormat, detectVersion, generateOperationId, parseOpenApiString };
-//# sourceMappingURL=utils.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","names":["parseYaml"],"sources":["../../../src/openapi/parser/utils.ts"],"sourcesContent":["import { parse as parseYaml } from 'yaml';\nimport type { OpenApiDocument, HttpMethod, OpenApiVersion } from '../types';\n\nexport const HTTP_METHODS: HttpMethod[] = [\n  'get',\n  'post',\n  'put',\n  'delete',\n  'patch',\n  'head',\n  'options',\n  'trace',\n];\n\n/**\n * Parse an OpenAPI document from a string (JSON or YAML).\n */\nexport function parseOpenApiString(\n  content: string,\n  format: 'json' | 'yaml' = 'json'\n): OpenApiDocument {\n  if (format === 'yaml') {\n    return parseYaml(content) as OpenApiDocument;\n  }\n  return JSON.parse(content) as OpenApiDocument;\n}\n\n/**\n * Detect the format of content (JSON or YAML).\n */\nexport function detectFormat(content: string): 'json' | 'yaml' {\n  const trimmed = content.trim();\n  if (trimmed.startsWith('{') || trimmed.startsWith('[')) {\n    return 'json';\n  }\n  return 'yaml';\n}\n\n/**\n * Detect OpenAPI version from document.\n */\nexport function detectVersion(doc: OpenApiDocument): OpenApiVersion {\n  const version = doc.openapi;\n  if (version.startsWith('3.1')) {\n    return '3.1';\n  }\n  return '3.0';\n}\n\n/**\n * Generate an operationId if not present.\n */\nexport function generateOperationId(method: HttpMethod, path: string): string {\n  // Convert path to camelCase operationId\n  const pathParts = path\n    .split('/')\n    .filter(Boolean)\n    .map((part) => {\n      // Remove path parameters\n      if (part.startsWith('{') && part.endsWith('}')) {\n        return (\n          'By' + part.slice(1, -1).charAt(0).toUpperCase() + part.slice(2, -1)\n        );\n      }\n      return part.charAt(0).toUpperCase() + part.slice(1);\n    });\n\n  return method + pathParts.join('');\n}\n"],"mappings":";;;AAGA,MAAa,eAA6B;CACxC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;AAKD,SAAgB,mBACd,SACA,SAA0B,QACT;AACjB,KAAI,WAAW,OACb,QAAOA,MAAU,QAAQ;AAE3B,QAAO,KAAK,MAAM,QAAQ;;;;;AAM5B,SAAgB,aAAa,SAAkC;CAC7D,MAAM,UAAU,QAAQ,MAAM;AAC9B,KAAI,QAAQ,WAAW,IAAI,IAAI,QAAQ,WAAW,IAAI,CACpD,QAAO;AAET,QAAO;;;;;AAMT,SAAgB,cAAc,KAAsC;AAElE,KADgB,IAAI,QACR,WAAW,MAAM,CAC3B,QAAO;AAET,QAAO;;;;;AAMT,SAAgB,oBAAoB,QAAoB,MAAsB;AAe5E,QAAO,SAbW,KACf,MAAM,IAAI,CACV,OAAO,QAAQ,CACf,KAAK,SAAS;AAEb,MAAI,KAAK,WAAW,IAAI,IAAI,KAAK,SAAS,IAAI,CAC5C,QACE,OAAO,KAAK,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,GAAG,GAAG;AAGxE,SAAO,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE;GACnD,CAEsB,KAAK,GAAG"}

package/dist/openapi/parser.js

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

package/dist/openapi/schema-converter.js

@@ -1,161 +0,0 @@
-import { toPascalCase } from "../common/utils.js";
-import { createSchemaGenerator } from "./schema-generators/index.js";
-
-//#region src/openapi/schema-converter.ts
-/**
-* JSON Schema to SchemaModel conversion utilities.
-* Converts OpenAPI JSON Schema to ContractSpec SchemaModel definitions.
-*/
-/**
-* Map JSON Schema types to ContractSpec ScalarTypeEnum values.
-*/
-const JSON_SCHEMA_TO_SCALAR = {
-	string: "ScalarTypeEnum.String_unsecure",
-	integer: "ScalarTypeEnum.Int_unsecure",
-	number: "ScalarTypeEnum.Float_unsecure",
-	boolean: "ScalarTypeEnum.Boolean",
-	"string:date": "ScalarTypeEnum.Date",
-	"string:date-time": "ScalarTypeEnum.DateTime",
-	"string:email": "ScalarTypeEnum.EmailAddress",
-	"string:uri": "ScalarTypeEnum.URL",
-	"string:uuid": "ScalarTypeEnum.ID"
-};
-/**
-* Check if a schema is a reference object.
-*/
-function isReference(schema) {
-	return typeof schema === "object" && schema !== null && "$ref" in schema;
-}
-/**
-* Extract type name from a $ref.
-*/
-function typeNameFromRef(ref) {
-	const parts = ref.split("/");
-	return parts[parts.length - 1] ?? "Unknown";
-}
-/**
-* Convert a JSON Schema to a TypeScript type representation.
-*/
-function jsonSchemaToType(schema, name) {
-	if (isReference(schema)) return {
-		type: toPascalCase(typeNameFromRef(schema.$ref)),
-		optional: false,
-		array: false,
-		primitive: false,
-		isReference: true
-	};
-	const schemaObj = schema;
-	const type = schemaObj["type"];
-	const format = schemaObj["format"];
-	const nullable = schemaObj["nullable"];
-	const originalTypeName = schemaObj["_originalTypeName"];
-	if (originalTypeName) return {
-		type: toPascalCase(originalTypeName),
-		optional: nullable ?? false,
-		array: false,
-		primitive: false,
-		isReference: true
-	};
-	if (type === "array") {
-		const items = schemaObj["items"];
-		if (items) return {
-			...jsonSchemaToType(items, name),
-			array: true,
-			optional: nullable ?? false
-		};
-		return {
-			type: "unknown",
-			optional: nullable ?? false,
-			array: true,
-			primitive: false,
-			isReference: true
-		};
-	}
-	if (type === "object" || schemaObj["properties"]) return {
-		type: name ? toPascalCase(name) : "Record<string, unknown>",
-		optional: nullable ?? false,
-		array: false,
-		primitive: false,
-		isReference: true
-	};
-	if (schemaObj["enum"]) return {
-		type: name ? toPascalCase(name) : "string",
-		optional: nullable ?? false,
-		array: false,
-		primitive: false,
-		isReference: true
-	};
-	const scalarKey = format ? `${type}:${format}` : type;
-	if (scalarKey === "string") return {
-		type: "string",
-		optional: nullable ?? false,
-		array: false,
-		primitive: true
-	};
-	if (scalarKey === "integer" || type === "number") return {
-		type: "number",
-		optional: nullable ?? false,
-		array: false,
-		primitive: true
-	};
-	if (scalarKey === "boolean") return {
-		type: "boolean",
-		optional: nullable ?? false,
-		array: false,
-		primitive: true
-	};
-	return {
-		type: "unknown",
-		optional: nullable ?? false,
-		array: false,
-		primitive: false,
-		isReference: true
-	};
-}
-/**
-* Get the ScalarTypeEnum value for a JSON Schema type.
-*/
-function getScalarType(schema) {
-	if (isReference(schema)) return;
-	const schemaObj = schema;
-	const type = schemaObj["type"];
-	const format = schemaObj["format"];
-	if (!type) return void 0;
-	if (type === "array") {
-		const items = schemaObj["items"];
-		if (items) return getScalarType(items);
-		return;
-	}
-	return JSON_SCHEMA_TO_SCALAR[format ? `${type}:${format}` : type] ?? JSON_SCHEMA_TO_SCALAR[type] ?? void 0;
-}
-/**
-* Generate code for a schema model using the specified format.
-*/
-function generateSchemaModelCode(schema, modelName, schemaFormat = "contractspec", config) {
-	const result = createSchemaGenerator(schemaFormat, config).generateModel(schema, modelName, { description: schema["description"] });
-	return {
-		name: result.name,
-		description: schema["description"],
-		fields: [],
-		code: result.code,
-		imports: result.imports
-	};
-}
-/**
-* Generate import statements for a SchemaModel.
-*/
-function generateImports(fields, options, sameDirectory = true) {
-	const imports = /* @__PURE__ */ new Set();
-	const modelsDir = sameDirectory ? "." : `../${options.conventions.models}`;
-	imports.add("import { defineSchemaModel, ScalarTypeEnum, EnumType } from '@contractspec/lib.schema';");
-	for (const field of fields) if (field.type.isReference && !field.type.primitive && !field.enumValues && !field.scalarType && !field.nestedModel) {
-		const modelName = field.type.type;
-		const kebabName = modelName.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
-		imports.add(`import { ${modelName} } from '${modelsDir}/${kebabName}';`);
-	}
-	return Array.from(imports).join("\n");
-}
-
-//#endregion
-export { generateImports, generateSchemaModelCode, getScalarType, jsonSchemaToType };
-//# sourceMappingURL=schema-converter.js.map

package/dist/openapi/schema-converter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-converter.js","names":[],"sources":["../../src/openapi/schema-converter.ts"],"sourcesContent":["/**\n * JSON Schema to SchemaModel conversion utilities.\n * Converts OpenAPI JSON Schema to ContractSpec SchemaModel definitions.\n */\n\nimport { createSchemaGenerator } from './schema-generators';\nimport type {\n  SchemaFormat,\n  ResolvedContractsrcConfig,\n} from '@contractspec/lib.contracts';\nimport type { OpenApiSchema } from './types';\nimport { toPascalCase } from '../common/utils';\n\n/**\n * Map JSON Schema types to ContractSpec ScalarTypeEnum values.\n */\nconst JSON_SCHEMA_TO_SCALAR: Record<string, string> = {\n  string: 'ScalarTypeEnum.String_unsecure',\n  integer: 'ScalarTypeEnum.Int_unsecure',\n  number: 'ScalarTypeEnum.Float_unsecure',\n  boolean: 'ScalarTypeEnum.Boolean',\n  // Special formats\n  'string:date': 'ScalarTypeEnum.Date',\n  'string:date-time': 'ScalarTypeEnum.DateTime',\n  'string:email': 'ScalarTypeEnum.EmailAddress',\n  'string:uri': 'ScalarTypeEnum.URL',\n  'string:uuid': 'ScalarTypeEnum.ID',\n};\n\n/**\n * TypeScript type representation for code generation.\n */\nexport interface TypescriptType {\n  /** The type expression (e.g., \"string\", \"number\", \"MyModel\") */\n  type: string;\n  /** Whether the type is optional */\n  optional: boolean;\n  /** Whether the type is an array */\n  array: boolean;\n  /** Whether this is a primitive type */\n  primitive: boolean;\n  /** Description for documentation */\n  description?: string;\n  /** Whether this type is a reference to another schema (needs import) vs inline */\n  isReference?: boolean;\n}\n\n/**\n * SchemaModel field representation for code generation.\n */\nexport interface SchemaField {\n  /** Field name */\n  name: string;\n  /** Field type */\n  type: TypescriptType;\n  /** Scalar type enum value (for FieldType) */\n  scalarType?: string;\n  /** Enum values if this is an enum type */\n  enumValues?: string[];\n  /** Nested model if this is an object type */\n  nestedModel?: GeneratedModel;\n}\n\n/**\n * Generated model representation.\n */\nexport interface GeneratedModel {\n  /** Model name (PascalCase) */\n  name: string;\n  /** Model description */\n  description?: string;\n  /** Fields */\n  fields: SchemaField[];\n  /** Generated TypeScript code */\n  code: string;\n  /** Required imports */\n  imports?: string[];\n}\n\n/**\n * Check if a schema is a reference object.\n */\nfunction isReference(schema: OpenApiSchema): schema is { $ref: string } {\n  return typeof schema === 'object' && schema !== null && '$ref' in schema;\n}\n\n/**\n * Extract type name from a $ref.\n */\nfunction typeNameFromRef(ref: string): string {\n  const parts = ref.split('/');\n  return parts[parts.length - 1] ?? 'Unknown';\n}\n\n/**\n * Convert a JSON Schema to a TypeScript type representation.\n */\nexport function jsonSchemaToType(\n  schema: OpenApiSchema,\n  name?: string\n): TypescriptType {\n  if (isReference(schema)) {\n    return {\n      type: toPascalCase(typeNameFromRef(schema.$ref)),\n      optional: false,\n      array: false,\n      primitive: false,\n      isReference: true,\n    };\n  }\n\n  const schemaObj = schema as Record<string, unknown>;\n  const type = schemaObj['type'] as string | undefined;\n  const format = schemaObj['format'] as string | undefined;\n  const nullable = schemaObj['nullable'] as boolean | undefined;\n\n  // Check if this schema was dereferenced from a $ref - use the original type name\n  const originalTypeName = schemaObj['_originalTypeName'] as string | undefined;\n  if (originalTypeName) {\n    return {\n      type: toPascalCase(originalTypeName),\n      optional: nullable ?? false,\n      array: false,\n      primitive: false,\n      isReference: true,\n    };\n  }\n\n  // Handle arrays\n  if (type === 'array') {\n    const items = schemaObj['items'] as OpenApiSchema | undefined;\n    if (items) {\n      const itemType = jsonSchemaToType(items, name);\n      return {\n        ...itemType,\n        array: true,\n        optional: nullable ?? false,\n      };\n    }\n    return {\n      type: 'unknown',\n      optional: nullable ?? false,\n      array: true,\n      primitive: false,\n      isReference: true,\n    };\n  }\n\n  // Handle objects\n  if (type === 'object' || schemaObj['properties']) {\n    return {\n      type: name ? toPascalCase(name) : 'Record<string, unknown>',\n      optional: nullable ?? false,\n      array: false,\n      primitive: false,\n      isReference: true,\n    };\n  }\n\n  // Handle enums\n  if (schemaObj['enum']) {\n    return {\n      type: name ? toPascalCase(name) : 'string',\n      optional: nullable ?? false,\n      array: false,\n      primitive: false,\n      isReference: true,\n    };\n  }\n\n  // Handle primitives\n  const scalarKey = format ? `${type}:${format}` : type;\n  if (scalarKey === 'string') {\n    return {\n      type: 'string',\n      optional: nullable ?? false,\n      array: false,\n      primitive: true,\n    };\n  }\n  if (scalarKey === 'integer' || type === 'number') {\n    return {\n      type: 'number',\n      optional: nullable ?? false,\n      array: false,\n      primitive: true,\n    };\n  }\n  if (scalarKey === 'boolean') {\n    return {\n      type: 'boolean',\n      optional: nullable ?? false,\n      array: false,\n      primitive: true,\n    };\n  }\n\n  // Default to unknown\n  return {\n    type: 'unknown',\n    optional: nullable ?? false,\n    array: false,\n    primitive: false,\n    isReference: true,\n  };\n}\n\n/**\n * Get the ScalarTypeEnum value for a JSON Schema type.\n */\nexport function getScalarType(schema: OpenApiSchema): string | undefined {\n  if (isReference(schema)) {\n    return undefined;\n  }\n\n  const schemaObj = schema as Record<string, unknown>;\n  const type = schemaObj['type'] as string | undefined;\n  const format = schemaObj['format'] as string | undefined;\n\n  if (!type) return undefined;\n\n  // For arrays, get the scalar type of the items\n  if (type === 'array') {\n    const items = schemaObj['items'] as OpenApiSchema | undefined;\n    if (items) {\n      return getScalarType(items);\n    }\n    return undefined;\n  }\n\n  const key = format ? `${type}:${format}` : type;\n  return JSON_SCHEMA_TO_SCALAR[key] ?? JSON_SCHEMA_TO_SCALAR[type] ?? undefined;\n}\n\n/**\n * Generate code for a schema model using the specified format.\n */\nexport function generateSchemaModelCode(\n  schema: OpenApiSchema,\n  modelName: string,\n  schemaFormat: SchemaFormat = 'contractspec',\n  config?: ResolvedContractsrcConfig\n): GeneratedModel {\n  const generator = createSchemaGenerator(schemaFormat, config);\n  const result = generator.generateModel(schema, modelName, {\n    description: (schema as Record<string, unknown>)['description'] as string,\n  });\n\n  return {\n    name: result.name,\n    description: (schema as Record<string, unknown>)['description'] as string,\n    fields: [], // fields are processed internally by generators now\n    code: result.code,\n    imports: result.imports,\n  };\n}\n\n/**\n * Generate import statements for a SchemaModel.\n */\nexport function generateImports(\n  fields: SchemaField[],\n  options: ResolvedContractsrcConfig,\n  sameDirectory = true\n): string {\n  const imports = new Set<string>();\n  const modelsDir = sameDirectory ? '.' : `../${options.conventions.models}`;\n\n  imports.add(\n    \"import { defineSchemaModel, ScalarTypeEnum, EnumType } from '@contractspec/lib.schema';\"\n  );\n\n  for (const field of fields) {\n    // Only import fields that are actual references to other schemas (not inline types)\n    if (\n      field.type.isReference &&\n      !field.type.primitive &&\n      !field.enumValues &&\n      !field.scalarType &&\n      !field.nestedModel\n    ) {\n      // This is a reference to another schema model\n      const modelName = field.type.type;\n      const kebabName = modelName\n        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n        .toLowerCase();\n      imports.add(`import { ${modelName} } from '${modelsDir}/${kebabName}';`);\n    }\n  }\n\n  return Array.from(imports).join('\\n');\n}\n"],"mappings":";;;;;;;;;;;AAgBA,MAAM,wBAAgD;CACpD,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,SAAS;CAET,eAAe;CACf,oBAAoB;CACpB,gBAAgB;CAChB,cAAc;CACd,eAAe;CAChB;;;;AAuDD,SAAS,YAAY,QAAmD;AACtE,QAAO,OAAO,WAAW,YAAY,WAAW,QAAQ,UAAU;;;;;AAMpE,SAAS,gBAAgB,KAAqB;CAC5C,MAAM,QAAQ,IAAI,MAAM,IAAI;AAC5B,QAAO,MAAM,MAAM,SAAS,MAAM;;;;;AAMpC,SAAgB,iBACd,QACA,MACgB;AAChB,KAAI,YAAY,OAAO,CACrB,QAAO;EACL,MAAM,aAAa,gBAAgB,OAAO,KAAK,CAAC;EAChD,UAAU;EACV,OAAO;EACP,WAAW;EACX,aAAa;EACd;CAGH,MAAM,YAAY;CAClB,MAAM,OAAO,UAAU;CACvB,MAAM,SAAS,UAAU;CACzB,MAAM,WAAW,UAAU;CAG3B,MAAM,mBAAmB,UAAU;AACnC,KAAI,iBACF,QAAO;EACL,MAAM,aAAa,iBAAiB;EACpC,UAAU,YAAY;EACtB,OAAO;EACP,WAAW;EACX,aAAa;EACd;AAIH,KAAI,SAAS,SAAS;EACpB,MAAM,QAAQ,UAAU;AACxB,MAAI,MAEF,QAAO;GACL,GAFe,iBAAiB,OAAO,KAAK;GAG5C,OAAO;GACP,UAAU,YAAY;GACvB;AAEH,SAAO;GACL,MAAM;GACN,UAAU,YAAY;GACtB,OAAO;GACP,WAAW;GACX,aAAa;GACd;;AAIH,KAAI,SAAS,YAAY,UAAU,cACjC,QAAO;EACL,MAAM,OAAO,aAAa,KAAK,GAAG;EAClC,UAAU,YAAY;EACtB,OAAO;EACP,WAAW;EACX,aAAa;EACd;AAIH,KAAI,UAAU,QACZ,QAAO;EACL,MAAM,OAAO,aAAa,KAAK,GAAG;EAClC,UAAU,YAAY;EACtB,OAAO;EACP,WAAW;EACX,aAAa;EACd;CAIH,MAAM,YAAY,SAAS,GAAG,KAAK,GAAG,WAAW;AACjD,KAAI,cAAc,SAChB,QAAO;EACL,MAAM;EACN,UAAU,YAAY;EACtB,OAAO;EACP,WAAW;EACZ;AAEH,KAAI,cAAc,aAAa,SAAS,SACtC,QAAO;EACL,MAAM;EACN,UAAU,YAAY;EACtB,OAAO;EACP,WAAW;EACZ;AAEH,KAAI,cAAc,UAChB,QAAO;EACL,MAAM;EACN,UAAU,YAAY;EACtB,OAAO;EACP,WAAW;EACZ;AAIH,QAAO;EACL,MAAM;EACN,UAAU,YAAY;EACtB,OAAO;EACP,WAAW;EACX,aAAa;EACd;;;;;AAMH,SAAgB,cAAc,QAA2C;AACvE,KAAI,YAAY,OAAO,CACrB;CAGF,MAAM,YAAY;CAClB,MAAM,OAAO,UAAU;CACvB,MAAM,SAAS,UAAU;AAEzB,KAAI,CAAC,KAAM,QAAO;AAGlB,KAAI,SAAS,SAAS;EACpB,MAAM,QAAQ,UAAU;AACxB,MAAI,MACF,QAAO,cAAc,MAAM;AAE7B;;AAIF,QAAO,sBADK,SAAS,GAAG,KAAK,GAAG,WAAW,SACN,sBAAsB,SAAS;;;;;AAMtE,SAAgB,wBACd,QACA,WACA,eAA6B,gBAC7B,QACgB;CAEhB,MAAM,SADY,sBAAsB,cAAc,OAAO,CACpC,cAAc,QAAQ,WAAW,EACxD,aAAc,OAAmC,gBAClD,CAAC;AAEF,QAAO;EACL,MAAM,OAAO;EACb,aAAc,OAAmC;EACjD,QAAQ,EAAE;EACV,MAAM,OAAO;EACb,SAAS,OAAO;EACjB;;;;;AAMH,SAAgB,gBACd,QACA,SACA,gBAAgB,MACR;CACR,MAAM,0BAAU,IAAI,KAAa;CACjC,MAAM,YAAY,gBAAgB,MAAM,MAAM,QAAQ,YAAY;AAElE,SAAQ,IACN,0FACD;AAED,MAAK,MAAM,SAAS,OAElB,KACE,MAAM,KAAK,eACX,CAAC,MAAM,KAAK,aACZ,CAAC,MAAM,cACP,CAAC,MAAM,cACP,CAAC,MAAM,aACP;EAEA,MAAM,YAAY,MAAM,KAAK;EAC7B,MAAM,YAAY,UACf,QAAQ,sBAAsB,QAAQ,CACtC,aAAa;AAChB,UAAQ,IAAI,YAAY,UAAU,WAAW,UAAU,GAAG,UAAU,IAAI;;AAI5E,QAAO,MAAM,KAAK,QAAQ,CAAC,KAAK,KAAK"}