@kubb/adapter-oas 5.0.0-beta.52 → 5.0.0-beta.54

package/dist/index.js

@@ -2,8 +2,10 @@ import "./chunk-C0LytTxp.js";
 import { Diagnostics, ast, createAdapter } from "@kubb/core";
 import BaseOas from "oas";
 import path from "node:path";
-import { access } from "node:fs/promises";
+import { access, readFile } from "node:fs/promises";
 import OASNormalize from "oas-normalize";
+import { bundle } from "api-ref-bundler";
+import yaml from "js-yaml";
 import { childName, enumPropName, extractRefName, findDiscriminator } from "@kubb/ast/utils";
 import { isRef } from "oas/types";
 import { matchesMimeType } from "oas/utils";
@@ -238,6 +240,19 @@ async function exists(path) {
 	if (isBun()) return Bun.file(path).exists();
 	return 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 readFile(path, { encoding: "utf8" });
+}
 //#endregion
 //#region ../../internals/utils/src/object.ts
 /**
@@ -539,6 +554,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 yaml.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 bundle(pathOrUrl, resolver);
+}
+//#endregion
 //#region src/guards.ts
 /**
 * Returns `true` when `doc` is a Swagger 2.0 document (no `openapi` key).
@@ -603,8 +662,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
@@ -614,13 +674,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 OASNormalize(pathOrApi, {
 		enablePaths,
 		colorizeErrors: true
@@ -2326,9 +2383,10 @@ function preScan({ schemas, parseSchema, parseOperation, baseOas, parserOptions,
 		});
 		for (const definition of dedupePlan.hoisted) if (definition.type === "enum" && definition.name) enumNames.push(definition.name);
 	}
+	const aliasNames = dedupePlan?.aliasNames;
 	return {
 		refAliasMap,
-		enumNames,
+		enumNames: aliasNames && aliasNames.size > 0 ? enumNames.filter((name) => !aliasNames.has(name)) : enumNames,
 		circularNames,
 		discriminatorChildMap,
 		dedupePlan
@@ -2363,12 +2421,13 @@ function createInputStream({ schemas, parseSchema, parseOperation, baseOas, pars
 			description: node.description,
 			deprecated: node.deprecated
 		});
-		return ast.applyDedupe(node, dedupePlan.canonicalBySignature, true);
+		return ast.applyDedupe(node, dedupePlan, true);
 	};
 	const schemasIterable = { [Symbol.asyncIterator]() {
 		return (async function* () {
 			if (dedupePlan) for (const definition of dedupePlan.hoisted) yield definition;
 			for (const [name, schema] of Object.entries(schemas)) {
+				if (dedupePlan?.aliasNames.has(name)) continue;
 				const alias = refAliasMap.get(name);
 				if (alias?.name && schemas[alias.name]) {
 					yield rewriteTopLevelSchema({
@@ -2393,7 +2452,7 @@ function createInputStream({ schemas, parseSchema, parseOperation, baseOas, pars
 			for (const methods of Object.values(baseOas.getPaths())) for (const operation of Object.values(methods)) {
 				if (!operation) continue;
 				const node = parseOperation(parserOptions, operation);
-				if (node) yield dedupePlan ? ast.applyDedupe(node, dedupePlan.canonicalBySignature) : node;
+				if (node) yield dedupePlan ? ast.applyDedupe(node, dedupePlan) : node;
 			}
 		})();
 	} };