@lssm/lib.contracts-transformers 0.0.0-canary-20251217083314 → 1.41.0

package/dist/openapi/importer.js

@@ -1,264 +1,2 @@
-import { toFileName, toPascalCase, toSpecName, toValidIdentifier } from "../common/utils.js";
-import { generateImports, generateSchemaModelCode } from "./schema-converter.js";
-
-//#region src/openapi/importer.ts
-/**
-* HTTP methods that typically indicate a command (state-changing).
-*/
-const COMMAND_METHODS = [
-	"post",
-	"put",
-	"delete",
-	"patch"
-];
-/**
-* Determine if an operation is a command or query based on HTTP method.
-*/
-function inferOpKind(method) {
-	return COMMAND_METHODS.includes(method.toLowerCase()) ? "command" : "query";
-}
-/**
-* Determine auth level based on security requirements.
-*/
-function inferAuthLevel(operation, defaultAuth) {
-	if (!operation.security || operation.security.length === 0) return defaultAuth;
-	for (const sec of operation.security) if (Object.keys(sec).length === 0) return "anonymous";
-	return "user";
-}
-/**
-* 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;
-}
-/**
-* Generate ContractSpec TypeScript code for an operation.
-*/
-function generateSpecCode(operation, options, inputModel, outputModel) {
-	const specName = toSpecName(operation.operationId, options.prefix);
-	const kind = inferOpKind(operation.method);
-	const auth = inferAuthLevel(operation, options.defaultAuth ?? "user");
-	const lines = [];
-	lines.push("import { defineCommand, defineQuery } from '@lssm/lib.contracts';");
-	if (inputModel || outputModel) lines.push(generateImports([...inputModel?.fields ?? [], ...outputModel?.fields ?? []]));
-	lines.push("");
-	if (inputModel && inputModel.code) {
-		lines.push("// Input schema");
-		lines.push(inputModel.code);
-		lines.push("");
-	}
-	if (outputModel && outputModel.code) {
-		lines.push("// Output schema");
-		lines.push(outputModel.code);
-		lines.push("");
-	}
-	const defineFunc = kind === "command" ? "defineCommand" : "defineQuery";
-	const safeName = toValidIdentifier(toPascalCase(operation.operationId));
-	lines.push(`/**`);
-	lines.push(` * ${operation.summary ?? operation.operationId}`);
-	if (operation.description) {
-		lines.push(` *`);
-		lines.push(` * ${operation.description}`);
-	}
-	lines.push(` *`);
-	lines.push(` * @source OpenAPI: ${operation.method.toUpperCase()} ${operation.path}`);
-	lines.push(` */`);
-	lines.push(`export const ${safeName}Spec = ${defineFunc}({`);
-	lines.push("  meta: {");
-	lines.push(`    name: '${specName}',`);
-	lines.push("    version: 1,");
-	lines.push(`    stability: '${options.defaultStability ?? "stable"}',`);
-	lines.push(`    owners: [${(options.defaultOwners ?? []).map((o) => `'${o}'`).join(", ")}],`);
-	lines.push(`    tags: [${operation.tags.map((t) => `'${t}'`).join(", ")}],`);
-	lines.push(`    description: ${JSON.stringify(operation.summary ?? operation.operationId)},`);
-	lines.push(`    goal: ${JSON.stringify(operation.description ?? "Imported from OpenAPI")},`);
-	lines.push(`    context: 'Imported from OpenAPI: ${operation.method.toUpperCase()} ${operation.path}',`);
-	lines.push("  },");
-	lines.push("  io: {");
-	if (inputModel) lines.push(`    input: ${inputModel.name},`);
-	else lines.push("    input: null,");
-	if (outputModel) lines.push(`    output: ${outputModel.name},`);
-	else lines.push("    output: null, // TODO: Define output schema");
-	lines.push("  },");
-	lines.push("  policy: {");
-	lines.push(`    auth: '${auth}',`);
-	lines.push("  },");
-	lines.push("  transport: {");
-	lines.push("    rest: {");
-	lines.push(`      method: '${operation.method.toUpperCase()}',`);
-	lines.push(`      path: '${operation.path}',`);
-	lines.push("    },");
-	lines.push("  },");
-	lines.push("});");
-	return lines.join("\n");
-}
-/**
-* Import operations from a parsed OpenAPI document.
-*/
-function importFromOpenApi(parseResult, options = {}) {
-	const { tags, exclude = [], include } = options;
-	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 && options.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);
-			const code = generateSpecCode(operation, options, inputModel, outputSchema ? generateSchemaModelCode(outputSchema, `${operation.operationId}Output`) : null);
-			const fileName = toFileName(toSpecName(operation.operationId, options.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()
-			};
-			specs.push({
-				spec: {},
-				code,
-				fileName,
-				source,
-				transportHints
-			});
-		} catch (error) {
-			errors.push({
-				sourceId: operation.operationId,
-				error: error instanceof Error ? error.message : String(error)
-			});
-		}
-	}
-	return {
-		specs,
-		skipped,
-		errors,
-		summary: {
-			total: parseResult.operations.length,
-			imported: specs.length,
-			skipped: skipped.length,
-			errors: errors.length
-		}
-	};
-}
-/**
-* Import a single operation to ContractSpec code.
-*/
-function importOperation(operation, options = {}) {
-	const { schema: inputSchema } = buildInputSchema(operation);
-	const inputModel = inputSchema ? generateSchemaModelCode(inputSchema, `${operation.operationId}Input`) : null;
-	const outputSchema = getOutputSchema(operation);
-	return generateSpecCode(operation, options, inputModel, outputSchema ? generateSchemaModelCode(outputSchema, `${operation.operationId}Output`) : null);
-}
-
-//#endregion
-export { importFromOpenApi, importOperation };
+import{toFileName as e,toPascalCase as t,toSpecName as n,toValidIdentifier as r}from"../common/utils.js";import{generateImports as i,generateSchemaModelCode as a}from"./schema-converter.js";const o=[`post`,`put`,`delete`,`patch`];function s(e){return o.includes(e.toLowerCase())?`command`:`query`}function c(e,t){if(!e.security||e.security.length===0)return t;for(let t of e.security)if(Object.keys(t).length===0)return`anonymous`;return`user`}function l(e){let t=[];for(let n of e.pathParams)t.push({name:n.name,schema:n.schema,required:!0});for(let n of e.queryParams)t.push({name:n.name,schema:n.schema,required:n.required});let n=[`authorization`,`content-type`,`accept`,`user-agent`];for(let r of e.headerParams)n.includes(r.name.toLowerCase())||t.push({name:r.name,schema:r.schema,required:r.required});if(e.requestBody?.schema){let n=e.requestBody.schema;if(`$ref`in n)t.push({name:`body`,schema:n,required:e.requestBody.required});else{let e=n,r=e.properties,i=e.required??[];if(r)for(let[e,n]of Object.entries(r))t.push({name:e,schema:n,required:i.includes(e)})}}return t.length===0?{schema:null,fields:[]}:{schema:{type:`object`,properties:t.reduce((e,t)=>(e[t.name]=t.schema,e),{}),required:t.filter(e=>e.required).map(e=>e.name)},fields:t}}function u(e){for(let t of[`200`,`201`,`202`,`204`]){let n=e.responses[t];if(n?.schema)return n.schema}for(let[t,n]of Object.entries(e.responses))if(t.startsWith(`2`)&&n.schema)return n.schema;return null}function d(e,a,o,l){let u=n(e.operationId,a.prefix),d=s(e.method),f=c(e,a.defaultAuth??`user`),p=[];p.push(`import { defineCommand, defineQuery } from '@lssm/lib.contracts';`),(o||l)&&p.push(i([...o?.fields??[],...l?.fields??[]])),p.push(``),o&&o.code&&(p.push(`// Input schema`),p.push(o.code),p.push(``)),l&&l.code&&(p.push(`// Output schema`),p.push(l.code),p.push(``));let m=d===`command`?`defineCommand`:`defineQuery`,h=r(t(e.operationId));return p.push(`/**`),p.push(` * ${e.summary??e.operationId}`),e.description&&(p.push(` *`),p.push(` * ${e.description}`)),p.push(` *`),p.push(` * @source OpenAPI: ${e.method.toUpperCase()} ${e.path}`),p.push(` */`),p.push(`export const ${h}Spec = ${m}({`),p.push(`  meta: {`),p.push(`    name: '${u}',`),p.push(`    version: 1,`),p.push(`    stability: '${a.defaultStability??`stable`}',`),p.push(`    owners: [${(a.defaultOwners??[]).map(e=>`'${e}'`).join(`, `)}],`),p.push(`    tags: [${e.tags.map(e=>`'${e}'`).join(`, `)}],`),p.push(`    description: ${JSON.stringify(e.summary??e.operationId)},`),p.push(`    goal: ${JSON.stringify(e.description??`Imported from OpenAPI`)},`),p.push(`    context: 'Imported from OpenAPI: ${e.method.toUpperCase()} ${e.path}',`),p.push(`  },`),p.push(`  io: {`),o?p.push(`    input: ${o.name},`):p.push(`    input: null,`),l?p.push(`    output: ${l.name},`):p.push(`    output: null, // TODO: Define output schema`),p.push(`  },`),p.push(`  policy: {`),p.push(`    auth: '${f}',`),p.push(`  },`),p.push(`  transport: {`),p.push(`    rest: {`),p.push(`      method: '${e.method.toUpperCase()}',`),p.push(`      path: '${e.path}',`),p.push(`    },`),p.push(`  },`),p.push(`});`),p.join(`
+`)}function f(t,r={}){let{tags:i,exclude:o=[],include:s}=r,c=[],f=[],p=[];for(let m of t.operations){if(i&&i.length>0&&!m.tags.some(e=>i.includes(e))){f.push({sourceId:m.operationId,reason:`No matching tags (has: ${m.tags.join(`, `)})`});continue}if(s&&s.length>0){if(!s.includes(m.operationId)){f.push({sourceId:m.operationId,reason:`Not in include list`});continue}}else if(o.includes(m.operationId)){f.push({sourceId:m.operationId,reason:`In exclude list`});continue}if(m.deprecated&&r.defaultStability!==`deprecated`){f.push({sourceId:m.operationId,reason:`Deprecated operation`});continue}try{let{schema:i}=l(m),o=i?a(i,`${m.operationId}Input`):null,s=u(m),f=d(m,r,o,s?a(s,`${m.operationId}Output`):null),p=e(n(m.operationId,r.prefix)),h={rest:{method:m.method.toUpperCase(),path:m.path,params:{path:m.pathParams.map(e=>e.name),query:m.queryParams.map(e=>e.name),header:m.headerParams.map(e=>e.name),cookie:m.cookieParams.map(e=>e.name)}}},g={type:`openapi`,sourceId:m.operationId,operationId:m.operationId,openApiVersion:t.version,importedAt:new Date};c.push({spec:{},code:f,fileName:p,source:g,transportHints:h})}catch(e){p.push({sourceId:m.operationId,error:e instanceof Error?e.message:String(e)})}}return{specs:c,skipped:f,errors:p,summary:{total:t.operations.length,imported:c.length,skipped:f.length,errors:p.length}}}function p(e,t={}){let{schema:n}=l(e),r=n?a(n,`${e.operationId}Input`):null,i=u(e);return d(e,t,r,i?a(i,`${e.operationId}Output`):null)}export{f as importFromOpenApi,p as importOperation};

package/dist/openapi/index.js

@@ -1,7 +1 @@
-import { detectFormat, detectVersion, parseOpenApi, parseOpenApiDocument, parseOpenApiString } from "./parser.js";
-import { defaultRestPath, openApiForRegistry, openApiToJson, openApiToYaml } from "./exporter.js";
-import { generateImports, generateSchemaModelCode, getScalarType, jsonSchemaToField, jsonSchemaToType } from "./schema-converter.js";
-import { importFromOpenApi, importOperation } from "./importer.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 };
+import{detectFormat as e,detectVersion as t,parseOpenApi as n,parseOpenApiDocument as r,parseOpenApiString as i}from"./parser.js";import{defaultRestPath as a,openApiForRegistry as o,openApiToJson as s,openApiToYaml as c}from"./exporter.js";import{generateImports as l,generateSchemaModelCode as u,getScalarType as d,jsonSchemaToField as f,jsonSchemaToType as p}from"./schema-converter.js";import{importFromOpenApi as m,importOperation as h}from"./importer.js";import{createSpecDiff as g,diffAll as _,diffSpecVsOperation as v,diffSpecs as y,formatDiffChanges as b}from"./differ.js";export{g as createSpecDiff,a as defaultRestPath,e as detectFormat,t as detectVersion,_ as diffAll,v as diffSpecVsOperation,y as diffSpecs,b as formatDiffChanges,l as generateImports,u as generateSchemaModelCode,d as getScalarType,m as importFromOpenApi,h as importOperation,f as jsonSchemaToField,p as jsonSchemaToType,o as openApiForRegistry,s as openApiToJson,c as openApiToYaml,n as parseOpenApi,r as parseOpenApiDocument,i as parseOpenApiString};

package/dist/openapi/parser.js

@@ -1,231 +1 @@
-import { parse } from "yaml";
-
-//#region src/openapi/parser.ts
-/**
-* OpenAPI document parser.
-* Parses OpenAPI 3.x documents from JSON/YAML files or URLs.
-*/
-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";
-}
-/**
-* 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;
-}
-/**
-* Resolve a schema, following $ref if needed.
-*/
-function resolveSchema(doc, schema) {
-	if (!schema) return void 0;
-	if (isReference(schema)) return resolveRef(doc, schema.$ref) ?? schema;
-	return schema;
-}
-/**
-* 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: resolved.schema,
-			deprecated: resolved.deprecated ?? false
-		};
-		result[resolved.in]?.push(parsed);
-	}
-	return result;
-}
-/**
-* 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("");
-}
-/**
-* 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: resolveSchema(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 ? resolveSchema(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
-	};
-}
-/**
-* 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
-	}));
-	return {
-		document: doc,
-		version,
-		info: {
-			title: doc.info.title,
-			version: doc.info.version,
-			description: doc.info.description
-		},
-		operations,
-		schemas,
-		servers,
-		warnings
-	};
-}
-/**
-* 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 { detectFormat, detectVersion, parseOpenApi, parseOpenApiDocument, parseOpenApiString };
+import{parse as e}from"yaml";const t=[`get`,`post`,`put`,`delete`,`patch`,`head`,`options`,`trace`];function n(t,n=`json`){return n===`yaml`?e(t):JSON.parse(t)}function r(e){let t=e.trim();return t.startsWith(`{`)||t.startsWith(`[`)?`json`:`yaml`}function i(e){return e.openapi.startsWith(`3.1`)?`3.1`:`3.0`}function a(e){return typeof e==`object`&&!!e&&`$ref`in e}function o(e,t){if(!t.startsWith(`#/`))return;let n=t.slice(2).split(`/`),r=e;for(let e of n){if(typeof r!=`object`||!r)return;r=r[e]}return r}function s(e,t){if(t)return a(t)?o(e,t.$ref)??t:t}function c(e,t){let n={path:[],query:[],header:[],cookie:[]};if(!t)return n;for(let r of t){let t;if(a(r)){let n=o(e,r.$ref);if(!n)continue;t=n}else t=r;let i={name:t.name,in:t.in,required:t.required??t.in===`path`,description:t.description,schema:t.schema,deprecated:t.deprecated??!1};n[t.in]?.push(i)}return n}function l(e,t){return e+t.split(`/`).filter(Boolean).map(e=>e.startsWith(`{`)&&e.endsWith(`}`)?`By`+e.slice(1,-1).charAt(0).toUpperCase()+e.slice(2,-1):e.charAt(0).toUpperCase()+e.slice(1)).join(``)}function u(e,t,n,r,i){let u=c(e,[...i??[],...r.parameters??[]]),d;if(r.requestBody){let t=a(r.requestBody)?o(e,r.requestBody.$ref):r.requestBody;if(t){let n=Object.keys(t.content??{})[0]??`application/json`,r=t.content?.[n];r?.schema&&(d={required:t.required??!1,schema:s(e,r.schema),contentType:n})}}let f={};for(let[t,n]of Object.entries(r.responses??{})){let r=a(n)?o(e,n.$ref):n;if(r){let n=Object.keys(r.content??{})[0],i=n?r.content?.[n]:void 0;f[t]={description:r.description,schema:i?.schema?s(e,i.schema):void 0,contentType:n}}}let p=r?.[`x-contractspec`];return{operationId:r.operationId??l(t,n),method:t,path:n,summary:r.summary,description:r.description,tags:r.tags??[],pathParams:u.path,queryParams:u.query,headerParams:u.header,cookieParams:u.cookie,requestBody:d,responses:f,deprecated:r.deprecated??!1,security:r.security,contractSpecMeta:p}}function d(e,n={}){let r=i(e),a=[],o=[];for(let[n,r]of Object.entries(e.paths??{})){if(!r)continue;let i=r.parameters;for(let s of t){let t=r[s];if(t)try{o.push(u(e,s,n,t,i))}catch(e){a.push(`Failed to parse ${s.toUpperCase()} ${n}: ${e}`)}}}let s={},c=e.components;if(c?.schemas)for(let[e,t]of Object.entries(c.schemas))s[e]=t;let l=(e.servers??[]).map(e=>({url:e.url,description:e.description,variables:e.variables}));return{document:e,version:r,info:{title:e.info.title,version:e.info.version,description:e.info.description},operations:o,schemas:s,servers:l,warnings:a}}async function f(e,t={}){let{fetch:i=globalThis.fetch,readFile:a,timeout:o=3e4}=t,s,c;if(e.startsWith(`http://`)||e.startsWith(`https://`)){let t=new AbortController,n=setTimeout(()=>t.abort(),o);try{let n=await i(e,{signal:t.signal});if(!n.ok)throw Error(`HTTP ${n.status}: ${n.statusText}`);s=await n.text()}finally{clearTimeout(n)}c=e.endsWith(`.yaml`)||e.endsWith(`.yml`)?`yaml`:e.endsWith(`.json`)?`json`:r(s)}else{if(!a)throw Error(`readFile adapter required for file paths`);s=await a(e),c=e.endsWith(`.yaml`)||e.endsWith(`.yml`)?`yaml`:e.endsWith(`.json`)?`json`:r(s)}return d(n(s,c),t)}export{r as detectFormat,i as detectVersion,f as parseOpenApi,d as parseOpenApiDocument,n as parseOpenApiString};