@kubb/adapter-oas 5.14.5 → 5.15.0

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -20,7 +20,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
-//#endregion
 let _kubb_core = require("@kubb/core");
 let _kubb_kit = require("@kubb/kit");
 let node_path = require("node:path");
@@ -30,16 +29,14 @@ let api_ref_bundler = require("api-ref-bundler");
 let js_yaml = require("js-yaml");
 let yaml = require("yaml");
 yaml = __toESM(yaml, 1);
-//#region kubb-extension.json
+// kubb-extension.json
 var compatibility = {
 	"kubb": ">=5.8.3",
 	"node": ">=22.22"
 };
-//#endregion
-//#region package.json
-var version = "5.14.5";
-//#endregion
-//#region src/constants.ts
+// package.json
+var version = "5.15.0";
+// src/constants.ts
 /**
 * Default parser options applied when no explicit options are provided.
 */
@@ -163,8 +160,7 @@ const enumExtensionKeys = ["x-enumNames", "x-enum-varnames"];
 * Vendor extension keys that attach human-readable descriptions to enum values, checked in priority order.
 */
 const enumDescriptionKeys = ["x-enumDescriptions", "x-enum-descriptions"];
-//#endregion
-//#region src/emit/discriminator/propagate.ts
+// src/emit/discriminator/propagate.ts
 /**
 * Maps each child schema name to its discriminator patch data by scanning the given
 * top-level AST schema nodes for union schemas that carry a `discriminatorPropertyName`.
@@ -247,8 +243,7 @@ function patchDiscriminatorNode(node, entry) {
 		members: newMembers
 	};
 }
-//#endregion
-//#region ../../internals/utils/src/casing.ts
+// ../../internals/utils/src/casing.ts
 /**
 * Shared implementation for camelCase and PascalCase conversion.
 * Splits on common word boundaries (spaces, hyphens, underscores, dots, slashes, colons)
@@ -263,7 +258,7 @@ function convert(text, pascal) {
 	}).join("").replace(/[^a-zA-Z0-9]/g, "");
 }
 const cache = /* @__PURE__ */ new Map();
-const cacheLimit = 1e4;
+const cacheLimit = 1e5;
 function toCamelOrPascal(text, pascal) {
 	const key = `${pascal ? "P" : "c"}${text}`;
 	const cached = cache.get(key);
@@ -285,8 +280,7 @@ function toCamelOrPascal(text, pascal) {
 function pascalCase(text, { prefix = "", suffix = "" } = {}) {
 	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, true);
 }
-//#endregion
-//#region ../../internals/utils/src/errors.ts
+// ../../internals/utils/src/errors.ts
 /**
 * Coerces an unknown thrown value to an `Error` instance.
 * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.
@@ -313,8 +307,7 @@ function toError(value) {
 function getErrorMessage(value) {
 	return value instanceof Error ? value.message : String(value);
 }
-//#endregion
-//#region ../../internals/utils/src/jsonPointer.ts
+// ../../internals/utils/src/jsonPointer.ts
 /**
 * Escapes a single JSON pointer reference token per RFC 6901 (`~` → `~0`, `/` → `~1`), so a
 * name holding those characters maps to a distinct pointer.
@@ -327,8 +320,7 @@ function getErrorMessage(value) {
 function escapePointerToken(token) {
 	return token.replaceAll("~", "~0").replaceAll("/", "~1");
 }
-//#endregion
-//#region ../../internals/utils/src/runtime.ts
+// ../../internals/utils/src/runtime.ts
 const isBun = typeof Bun !== "undefined";
 const isDeno = "Deno" in globalThis;
 /**
@@ -357,8 +349,7 @@ function detect() {
 		version: process.versions?.node ?? ""
 	};
 }
-//#endregion
-//#region ../../internals/utils/src/fs.ts
+// ../../internals/utils/src/fs.ts
 /**
 * Resolves to `true` when the file or directory at `path` exists.
 * Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.
@@ -387,8 +378,7 @@ async function read(path) {
 	if (runtime.isBun) return Bun.file(path).text();
 	return (0, node_fs_promises.readFile)(path, { encoding: "utf8" });
 }
-//#endregion
-//#region src/oas.ts
+// src/oas.ts
 /**
 * Returns `true` when a schema should be treated as nullable.
 *
@@ -471,8 +461,7 @@ const jsonMimeFragments = [
 function isJsonMimeType(mimeType) {
 	return jsonMimeFragments.some((fragment) => mimeType.includes(fragment));
 }
-//#endregion
-//#region src/refs.ts
+// src/refs.ts
 /**
 * Creates the `$ref` resolution service for one document. One pointer walk backs every method.
 *
@@ -579,8 +568,7 @@ function createRefs(document) {
 		derefKeepingRef
 	};
 }
-//#endregion
-//#region src/load/source.ts
+// src/load/source.ts
 const urlRegExp = /^https?:\/+/i;
 /**
 * Node reports every connection failure as `TypeError: fetch failed` and keeps the useful part
@@ -684,8 +672,7 @@ async function assertInputExists(input) {
 		location: { kind: "config" }
 	});
 }
-//#endregion
-//#region src/load/normalize.ts
+// src/load/normalize.ts
 /**
 * True when `node` contains a `$ref` pointing outside the current document (a relative path,
 * absolute path, or URL). An internal `#/...` fragment does not count.
@@ -715,6 +702,30 @@ function inlinePathRefs(node, resolve, visiting = []) {
 	for (const [key, value] of Object.entries(node)) node[key] = inlinePathRefs(value, resolve, visiting);
 	return node;
 }
+const namedEntryKeys = /* @__PURE__ */ new Set([
+	"properties",
+	"patternProperties",
+	"headers",
+	"schemas",
+	"responses",
+	"parameters",
+	"requestBodies",
+	"examples",
+	"links",
+	"callbacks",
+	"securitySchemes",
+	"securityDefinitions",
+	"pathItems",
+	"definitions",
+	"$defs"
+]);
+/**
+* True when `path` runs through an `x-` vendor extension. Kubb never reads an extension, so a `$ref`
+* Kubb cannot read inside one cannot change the output.
+*/
+function isExtensionPath(path) {
+	return path.some((token, index) => String(token).startsWith("x-") && !namedEntryKeys.has(String(path[index - 1])));
+}
 /**
 * Bundles a multi-file OpenAPI document into a single document via `api-ref-bundler`.
 *
@@ -730,7 +741,7 @@ function inlinePathRefs(node, resolve, visiting = []) {
 *
 * `document` stands in for the file at `pathOrUrl`, such as inline input. Every other file or URL
 * read, including one that fails, lands in `sources`. A `$ref` that cannot be read reports
-* `KUBB_REF_NOT_FOUND` at the key that holds it.
+* `KUBB_REF_NOT_FOUND` at the key that holds it, as a warning when it sits inside an `x-` extension.
 *
 * @example Local file
 * `const document = await bundleDocument('./openapi.yaml')`
@@ -757,7 +768,7 @@ async function bundleDocument(pathOrUrl, { document, sources = [] } = {}) {
 		const pointer = toKey(state.baseFile) === toKey(pathOrUrl) ? `#/${path.map((token) => escapePointerToken(String(token))).join("/")}` : void 0;
 		const diagnostic = {
 			code: _kubb_kit.Diagnostics.code.refNotFound,
-			severity: "error",
+			severity: isExtensionPath(path) ? "warning" : "error",
 			message: `Could not bundle an external \`$ref\`. ${message}.`,
 			help: "Check that the file or URL the `$ref` points at exists and is readable, or fix the `$ref`.",
 			...pointer && { location: {
@@ -765,7 +776,7 @@ async function bundleDocument(pathOrUrl, { document, sources = [] } = {}) {
 				pointer
 			} }
 		};
-		if (!_kubb_kit.Diagnostics.report(diagnostic)) throw new _kubb_kit.Diagnostics.Error(diagnostic);
+		if (!_kubb_kit.Diagnostics.report(diagnostic) && diagnostic.severity === "error") throw new _kubb_kit.Diagnostics.Error(diagnostic);
 	} } });
 }
 const inlineInputName = "<inline input>";
@@ -907,8 +918,7 @@ async function validateDocumentInWorker(document) {
 	if ("thrown" in message) return reportInvalidSpec(message.thrown);
 	if (!message.valid) reportValidationErrors(message);
 }
-//#endregion
-//#region src/model/components.ts
+// src/model/components.ts
 /**
 * Extracts the inline schema from a media-type `content` map, with the media type it sits under.
 *
@@ -1110,8 +1120,7 @@ function getSchemas(document, { contentType }, refs) {
 		pointers
 	};
 }
-//#endregion
-//#region src/model/server.ts
+// src/model/server.ts
 /**
 * Reads the server URL from the document's `servers` array at `server.index`,
 * interpolating any `server.variables` into the URL template.
@@ -1163,8 +1172,7 @@ function resolveServerUrl(server, overrides) {
 	}
 	return url;
 }
-//#endregion
-//#region src/emit/schemaShape.ts
+// src/emit/schemaShape.ts
 /**
 * Whether `format` maps to a dedicated type; `false` is what `KUBB_UNSUPPORTED_FORMAT` flags.
 */
@@ -1217,8 +1225,7 @@ function flattenSchema(schema) {
 	for (const fragment of allOfFragments) for (const [key, value] of Object.entries(fragment)) merged[key] ??= value;
 	return merged;
 }
-//#endregion
-//#region src/schemaDiagnostics.ts
+// src/schemaDiagnostics.ts
 /**
 * Links one freshly converted schema and its nested schemas to their RFC 6901 pointers
 * (`#/components/schemas/Pet/properties/owner/properties/name`), and reports the advisory
@@ -1272,8 +1279,7 @@ function visit(node, pointer) {
 		for (const [index, member] of (node.members ?? []).entries()) visit(member, `${pointer}/${keyword}/${index}`);
 	}
 }
-//#endregion
-//#region src/operation.ts
+// src/operation.ts
 function slugify(value) {
 	return value.replace(/[^a-zA-Z0-9]/g, "-").replace(/-{2,}/g, "-").replace(/^-|-$/g, "");
 }
@@ -1542,8 +1548,7 @@ function parseOperation({ operation, ...ctx }) {
 		extensions: pickExtensions(operation.schema)
 	});
 }
-//#endregion
-//#region src/emit/createNode.ts
+// src/emit/createNode.ts
 /**
 * Builds a schema node from a converter's base context plus its type-specific fields. Every
 * converter needs the same metadata fields (`title`, `description`, `examples`, ...) alongside
@@ -1564,8 +1569,7 @@ function createNode({ schema, name, nullable, defaultValue }, extras) {
 		...extras
 	});
 }
-//#endregion
-//#region src/emit/discriminator/preserve.ts
+// src/emit/discriminator/preserve.ts
 /**
 * Turns string mapping keys into the discriminator property's type when they parse cleanly.
 */
@@ -1801,8 +1805,7 @@ function extractDiscriminatedAllOfMembers({ allOfMembers, name, refs }) {
 		discriminantValues
 	};
 }
-//#endregion
-//#region src/emit/converters/annotatedEnum.ts
+// src/emit/converters/annotatedEnum.ts
 const ANNOTATIONS = /* @__PURE__ */ new Set([
 	"title",
 	"description",
@@ -1868,8 +1871,7 @@ function convertAnnotatedEnum(context) {
 		namedEnumValues
 	});
 }
-//#endregion
-//#region src/emit/converters/composition.ts
+// src/emit/converters/composition.ts
 /**
 * Collects property schemas from all `allOf` members and outer schema properties,
 * recursively resolving `$ref` pointers.
@@ -2205,8 +2207,7 @@ function convertMultiType({ schema, name, nullable, defaultValue, parse }) {
 		})
 	});
 }
-//#endregion
-//#region src/emit/converters/scalar.ts
+// src/emit/converters/scalar.ts
 /**
 * Normalizes malformed `{ type: 'array', enum: [...] }` schemas by moving enum values into items.
 *
@@ -2382,8 +2383,7 @@ function convertNumeric(context, type) {
 		...getNumericConstraints(context.schema)
 	});
 }
-//#endregion
-//#region src/emit/converters/structural.ts
+// src/emit/converters/structural.ts
 /**
 * Resolves a `true` or empty-object map schema (`additionalProperties`/`patternProperties`) to
 * `options.unknownType`, otherwise parses it as a regular schema.
@@ -2414,8 +2414,9 @@ function nameEnums(node, options) {
 * Converts an object-like schema into an `ObjectSchemaNode`.
 */
 function convertObject({ schema, name, nullable, defaultValue, options, parse, refs }) {
+	const requiredNames = Array.isArray(schema.required) ? new Set(schema.required) : void 0;
 	const properties = schema.properties ? Object.entries(schema.properties).map(([propName, propSchema]) => {
-		const required = Array.isArray(schema.required) ? schema.required.includes(propName) : !!schema.required;
+		const required = requiredNames ? requiredNames.has(propName) : !!schema.required;
 		const resolvedPropSchema = propSchema;
 		const propNullable = isNullable(resolvedPropSchema);
 		const schemaNode = nameEnums(parse({
@@ -2534,8 +2535,7 @@ function convertArray({ schema, name, nullable, defaultValue, options, parse })
 		unique: schema.uniqueItems ?? void 0
 	});
 }
-//#endregion
-//#region src/emit/parseSchema.ts
+// src/emit/parseSchema.ts
 /**
 * Ordered schema rule table. Order is significant: composition keywords (`not`, `$ref`, `allOf`,
 * `oneOf`/`anyOf`) take precedence over `const` (except a `$ref` with a sibling `const`, where the
@@ -2636,8 +2636,7 @@ const schemaRules = [
 		convert: ({ schema, name, nullable }) => createNullNode(schema, name, nullable)
 	}
 ];
-//#endregion
-//#region src/parser.ts
+// src/parser.ts
 /**
 * Creates the schema converter bound to one OpenAPI document: `parseSchema` dispatches each
 * schema through the ordered `schemaRules` table, with the parser options merged once.
@@ -2674,8 +2673,7 @@ function createSchemaParser(ctx) {
 	}
 	return parseSchema;
 }
-//#endregion
-//#region src/promoteEnums.ts
+// src/promoteEnums.ts
 /**
 * Collects inline enums to lift to the top level, keyed by the name the parser derived for them
 * (e.g. `PetStatusEnum`). An enum already defined as a top-level component is left as-is, and a
@@ -2721,8 +2719,7 @@ function refPromotedEnums(node, promoted) {
 		});
 	} });
 }
-//#endregion
-//#region src/sourceLocator.ts
+// src/sourceLocator.ts
 let cached;
 const toRange = ([start, end]) => ({
 	start,
@@ -2879,8 +2876,7 @@ const locate = (source, location) => {
 	const { document } = cached;
 	return findPointer(document, location.pointer) ?? (ref ? findRefUsage(document, ref) : void 0);
 };
-//#endregion
-//#region src/adapter.ts
+// src/adapter.ts
 /**
 * The `name` of `@kubb/adapter-oas`, used to identify this adapter in a Kubb config.
 */
@@ -3125,7 +3121,6 @@ const adapterOas = (0, _kubb_core.defineExtension)({
 		};
 	}
 });
-//#endregion
 exports.adapterOas = adapterOas;
 exports.adapterOasName = adapterOasName;