@kubb/oas 4.31.1 → 4.31.2

package/dist/index.cjs

@@ -51,6 +51,8 @@ jsonpointer = __toESM(jsonpointer);
 let oas = require("oas");
 oas = __toESM(oas);
 let oas_utils = require("oas/utils");
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs);
 let node_path = require("node:path");
 node_path = __toESM(node_path);
 let _kubb_core_transformers = require("@kubb/core/transformers");
@@ -4443,9 +4445,90 @@ function getDefaultValue(schema) {
 	}
 	if (schema.type === "object" || schema.properties) return "{}";
 }
+/**
+* Recursively collect all external local-file $ref prefixes (e.g. "api-definitions.yml")
+* from an object tree. URL refs (http/https) are ignored.
+*/
+function collectExternalFilePaths(obj, files) {
+	if (!obj || typeof obj !== "object") return;
+	if (Array.isArray(obj)) {
+		for (const item of obj) collectExternalFilePaths(item, files);
+		return;
+	}
+	for (const [key, value] of Object.entries(obj)) if (key === "$ref" && typeof value === "string") {
+		const hashIdx = value.indexOf("#");
+		const filePart = hashIdx > 0 ? value.slice(0, hashIdx) : hashIdx === -1 ? value : "";
+		if (filePart && !filePart.startsWith("http://") && !filePart.startsWith("https://")) files.add(filePart);
+	} else collectExternalFilePaths(value, files);
+}
+/**
+* Replace all $refs that start with `externalFile#` with the corresponding
+* internal ref (i.e. just the fragment part, `#/...`).
+*/
+function replaceExternalRefsInPlace(obj, externalFile) {
+	if (!obj || typeof obj !== "object") return;
+	if (Array.isArray(obj)) {
+		for (const item of obj) replaceExternalRefsInPlace(item, externalFile);
+		return;
+	}
+	const record = obj;
+	for (const key of Object.keys(record)) {
+		const value = record[key];
+		if (key === "$ref" && typeof value === "string" && value.startsWith(`${externalFile}#`)) record[key] = value.slice(externalFile.length);
+		else if (value && typeof value === "object") replaceExternalRefsInPlace(value, externalFile);
+	}
+}
+/**
+* Before bundling, scan the main spec file for external local-file references and merge
+* their `components` sections into the main document. This ensures that schemas defined
+* in external files (e.g. `api-definitions.yml#/components/schemas/Parcel`) end up in
+* `#/components/schemas/Parcel` of the bundled output, rather than being inlined as
+* anonymous path-based refs.
+*
+* Returns the merged document, or `null` if no external file components were found.
+*/
+function mergeExternalFileComponents(mainFilePath) {
+	let mainContent;
+	try {
+		mainContent = node_fs.default.readFileSync(mainFilePath, "utf-8");
+	} catch {
+		return null;
+	}
+	const mainDoc = import_yaml.parse(mainContent);
+	if (!mainDoc || typeof mainDoc !== "object") return null;
+	const mainDir = node_path.default.dirname(mainFilePath);
+	const externalFiles = /* @__PURE__ */ new Set();
+	collectExternalFilePaths(mainDoc, externalFiles);
+	if (externalFiles.size === 0) return null;
+	let hasMergedComponents = false;
+	for (const externalFile of externalFiles) {
+		const externalFilePath = node_path.default.resolve(mainDir, externalFile);
+		let externalContent;
+		try {
+			externalContent = node_fs.default.readFileSync(externalFilePath, "utf-8");
+		} catch {
+			continue;
+		}
+		const externalDoc = import_yaml.parse(externalContent);
+		if (!externalDoc?.components || typeof externalDoc.components !== "object") continue;
+		const mainComponents = mainDoc.components ?? {};
+		mainDoc.components = mainComponents;
+		for (const [componentType, components] of Object.entries(externalDoc.components)) {
+			if (!components || typeof components !== "object") continue;
+			mainComponents[componentType] = {
+				...components,
+				...mainComponents[componentType] ?? {}
+			};
+			hasMergedComponents = true;
+		}
+	}
+	if (!hasMergedComponents) return null;
+	for (const externalFile of externalFiles) replaceExternalRefsInPlace(mainDoc, externalFile);
+	return mainDoc;
+}
 async function parse(pathOrApi, { oasClass = Oas, enablePaths = true } = {}) {
 	if (typeof pathOrApi === "string" && !pathOrApi.match(/\n/) && !pathOrApi.match(/^\s*\{/) && enablePaths) try {
-		return parse(await (0, _readme_openapi_parser.bundle)(pathOrApi), {
+		return parse(await (0, _readme_openapi_parser.bundle)(mergeExternalFileComponents(pathOrApi) ?? pathOrApi), {
 			oasClass,
 			enablePaths
 		});