@kubb/oas 4.31.1 → 4.31.2

package/dist/index.js

@@ -2,6 +2,7 @@ import { a as __require, i as __name, n as __esmMin, o as __toCommonJS, r as __e
 import jsonpointer from "jsonpointer";
 import BaseOas from "oas";
 import { matchesMimeType } from "oas/utils";
+import fs from "node:fs";
 import path from "node:path";
 import { pascalCase } from "@kubb/core/transformers";
 import { URLPath } from "@kubb/core/utils";
@@ -4391,9 +4392,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 = fs.readFileSync(mainFilePath, "utf-8");
+	} catch {
+		return null;
+	}
+	const mainDoc = import_yaml.parse(mainContent);
+	if (!mainDoc || typeof mainDoc !== "object") return null;
+	const mainDir = path.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 = path.resolve(mainDir, externalFile);
+		let externalContent;
+		try {
+			externalContent = fs.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 bundle(pathOrApi), {
+		return parse(await bundle(mergeExternalFileComponents(pathOrApi) ?? pathOrApi), {
 			oasClass,
 			enablePaths
 		});