@kubb/adapter-oas 5.0.0-beta.51 → 5.0.0-beta.53

package/dist/index.cjs

@@ -29,6 +29,9 @@ node_path = __toESM(node_path, 1);
 let node_fs_promises = require("node:fs/promises");
 let oas_normalize = require("oas-normalize");
 oas_normalize = __toESM(oas_normalize, 1);
+let api_ref_bundler = require("api-ref-bundler");
+let js_yaml = require("js-yaml");
+js_yaml = __toESM(js_yaml, 1);
 let _kubb_ast_utils = require("@kubb/ast/utils");
 let oas_types = require("oas/types");
 let oas_utils = require("oas/utils");
@@ -263,6 +266,19 @@ async function exists(path) {
 	if (isBun()) return Bun.file(path).exists();
 	return (0, node_fs_promises.access)(path).then(() => true, () => false);
 }
+/**
+* Reads the file at `path` as a UTF-8 string.
+* Uses `Bun.file().text()` when running under Bun, `fs.readFile` otherwise.
+*
+* @example
+* ```ts
+* const source = await read('./src/Pet.ts')
+* ```
+*/
+async function read(path) {
+	if (isBun()) return Bun.file(path).text();
+	return (0, node_fs_promises.readFile)(path, { encoding: "utf8" });
+}
 //#endregion
 //#region ../../internals/utils/src/object.ts
 /**
@@ -564,6 +580,50 @@ var URLPath = class {
 	}
 };
 //#endregion
+//#region src/bundler.ts
+const urlRegExp = /^https?:\/+/i;
+async function readSource(sourcePath) {
+	if (urlRegExp.test(sourcePath)) {
+		const url = new URL(sourcePath);
+		const response = await fetch(url);
+		if (!response.ok) throw new Error(`Cannot fetch the OAS document at ${url.href} (HTTP ${response.status})`);
+		return response.text();
+	}
+	return read(sourcePath);
+}
+async function resolveSource(sourcePath) {
+	const data = await readSource(sourcePath);
+	if (sourcePath.toLowerCase().endsWith(".md")) return data;
+	return js_yaml.default.load(data);
+}
+/**
+* Bundles a multi-file OpenAPI document into a single document via `api-ref-bundler`.
+*
+* External file schemas are hoisted into named `components.schemas` entries, so a property
+* pointing at `./schemas/User.yaml` ends up referencing `#/components/schemas/User`. Generators
+* can then emit a named type with an import instead of inlining the shape. Sources are read with
+* the Bun-aware `read` util for local YAML and JSON files, and with `fetch` for HTTP(S) URLs.
+*
+* @example Local file
+* `const document = await bundleDocument('./openapi.yaml')`
+*
+* @example Remote URL
+* `const document = await bundleDocument('https://example.com/openapi.yaml')`
+*/
+async function bundleDocument(pathOrUrl) {
+	const cache = /* @__PURE__ */ new Map();
+	const resolver = (sourcePath) => {
+		const key = urlRegExp.test(sourcePath) ? new URL(sourcePath).href : sourcePath;
+		const cached = cache.get(key);
+		if (cached) return cached;
+		const result = resolveSource(sourcePath);
+		cache.set(key, result);
+		return result;
+	};
+	await resolver(pathOrUrl);
+	return await (0, api_ref_bundler.bundle)(pathOrUrl, resolver);
+}
+//#endregion
 //#region src/guards.ts
 /**
 * Returns `true` when `doc` is a Swagger 2.0 document (no `openapi` key).
@@ -628,8 +688,9 @@ function isDiscriminator(obj) {
 /**
 * Loads and dereferences an OpenAPI document, returning the raw `Document`.
 *
-* Accepts a file path string or an already-parsed document object. File paths are bundled via
-* `@apidevtools/json-schema-ref-parser` to resolve external `$ref`s. Swagger 2.0 documents are
+* Accepts a file path string or an already-parsed document object. File paths and URLs are
+* bundled via `api-ref-bundler`, hoisting external file schemas into named `components.schemas`
+* entries so generators can emit named types and imports. Swagger 2.0 documents are
 * automatically up-converted to OpenAPI 3.0 via `swagger2openapi`.
 *
 * @example
@@ -639,13 +700,10 @@ function isDiscriminator(obj) {
 * ```
 */
 async function parseDocument(pathOrApi, { canBundle = true, enablePaths = true } = {}) {
-	if (typeof pathOrApi === "string" && canBundle) {
-		const { $RefParser } = await import("@apidevtools/json-schema-ref-parser");
-		return parseDocument(await $RefParser.bundle(pathOrApi), {
-			canBundle: false,
-			enablePaths
-		});
-	}
+	if (typeof pathOrApi === "string" && canBundle) return parseDocument(await bundleDocument(pathOrApi), {
+		canBundle: false,
+		enablePaths
+	});
 	const document = await new oas_normalize.default(pathOrApi, {
 		enablePaths,
 		colorizeErrors: true