@kubb/adapter-oas 5.10.0 → 5.10.2

package/dist/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#endregion
+let _kubb_core = require("@kubb/core");
 let _kubb_kit = require("@kubb/kit");
 let node_fs_promises = require("node:fs/promises");
 let _scalar_openapi_upgrader = require("@scalar/openapi-upgrader");
@@ -12,7 +13,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.10.0";
+var version = "5.10.2";
 //#endregion
 //#region src/constants.ts
 /**
@@ -241,6 +242,20 @@ function pascalCase(text, { prefix = "", suffix = "" } = {}) {
 //#endregion
 //#region ../../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)`.
+*
+* @example
+* ```ts
+* try { ... } catch(err) {
+*   throw new Error('Build failed', { cause: toError(err) })
+* }
+* ```
+*/
+function toError(value) {
+	return value instanceof Error ? value : new Error(String(value));
+}
+/**
 * Extracts a human-readable message from any thrown value.
 *
 * @example
@@ -253,6 +268,20 @@ function getErrorMessage(value) {
 	return value instanceof Error ? value.message : String(value);
 }
 //#endregion
+//#region ../../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.
+*
+* @example
+* ```ts
+* escapePointerToken('/pets/{id}') // '~1pets~1{id}'
+* ```
+*/
+function escapePointerToken(token) {
+	return token.replaceAll("~", "~0").replaceAll("/", "~1");
+}
+//#endregion
 //#region ../../internals/utils/src/runtime.ts
 const isBun = typeof Bun !== "undefined";
 const isDeno = "Deno" in globalThis;
@@ -378,7 +407,28 @@ async function resolveSource(sourcePath) {
 	try {
 		return JSON.parse(data);
 	} catch {
+		return parseYaml(data, {
+			origin: sourcePath,
+			help: "Fix the syntax at the reported line, or check that `input` points at the spec and not an HTML page."
+		});
+	}
+}
+/**
+* Parses a YAML (or JSON) spec. A syntax error throws `KUBB_INVALID_DOCUMENT` naming `origin`,
+* with the parser message, which keeps the line and column.
+*/
+function parseYaml(data, { origin, help }) {
+	try {
 		return (0, yaml.parse)(data);
+	} catch (error) {
+		throw new _kubb_kit.Diagnostics.Error({
+			code: _kubb_kit.Diagnostics.code.invalidDocument,
+			severity: "error",
+			message: `Cannot parse ${origin} as JSON or YAML: ${getErrorMessage(error)}`,
+			help,
+			location: { kind: "config" },
+			cause: toError(error)
+		});
 	}
 }
 /**
@@ -463,11 +513,26 @@ async function bundleDocument(pathOrUrl) {
 */
 async function parseFromConfig(source) {
 	const raw = await (async () => {
-		if (source.type === "data") return typeof source.data === "string" ? (0, yaml.parse)(source.data) : structuredClone(source.data);
+		if (source.type === "data") return typeof source.data === "string" ? parseYaml(source.data, {
+			origin: "the inline `input` string",
+			help: "Fix the syntax at the reported line. Kubb reads `input` as an inline spec, not a file path, because it starts with `{`, `[`, `openapi:`, or `swagger:`, or spans several lines."
+		}) : structuredClone(source.data);
 		await assertInputExists(source.path);
 		return bundleDocument(source.path);
 	})();
-	return (0, _scalar_openapi_upgrader.upgrade)(raw, "3.1");
+	try {
+		return (0, _scalar_openapi_upgrader.upgrade)(raw, "3.1");
+	} catch (error) {
+		const declared = raw && typeof raw === "object" ? raw.openapi ?? raw.swagger : void 0;
+		throw new _kubb_kit.Diagnostics.Error({
+			code: _kubb_kit.Diagnostics.code.invalidDocument,
+			severity: "error",
+			message: `Cannot upgrade the document${declared ? ` (version ${String(declared)})` : ""} to OpenAPI 3.1: ${getErrorMessage(error)}`,
+			help: "Kubb reads Swagger 2.0, OpenAPI 3.0, and OpenAPI 3.1. Set `swagger` or `openapi` to one of those versions, and fix the reported problem in the document.",
+			location: { kind: "config" },
+			cause: toError(error)
+		});
+	}
 }
 /**
 * Asserts the parsed input is an OpenAPI or Swagger document.
@@ -478,7 +543,7 @@ async function parseFromConfig(source) {
 * be a usable document, so it is fatal regardless of the `validate` option.
 */
 function assertDocument(document) {
-	if (document && ("openapi" in document || "swagger" in document)) return;
+	if (document && typeof document === "object" && ("openapi" in document || "swagger" in document)) return;
 	throw new _kubb_kit.Diagnostics.Error({
 		code: _kubb_kit.Diagnostics.code.invalidDocument,
 		severity: "error",
@@ -515,7 +580,12 @@ async function validateDocument(document, { throwOnError = false } = {}) {
 		return;
 	}
 	if (result.valid) return;
-	if (throwOnError) throw new Error(compileErrors(result));
+	if (throwOnError) throw new _kubb_kit.Diagnostics.Error({
+		code: _kubb_kit.Diagnostics.code.invalidSpec,
+		severity: "error",
+		message: compileErrors(result),
+		help: "Fix each problem listed in the spec, then validate again."
+	});
 	for (const { message } of result.errors) reportInvalidSpec(message.replace(/\n.*/s, ""));
 	if (result.additionalErrors > 0) reportInvalidSpec(`${result.additionalErrors} more validation errors are not listed.`);
 }
@@ -2189,13 +2259,6 @@ function createRefs(document) {
 function scanSchema({ node, name }) {
 	visit(node, `#/components/schemas/${escapePointerToken(name)}`);
 }
-/**
-* Escapes a single JSON pointer reference token per RFC 6901 (`~` → `~0`, `/` → `~1`), so a
-* property name with those characters maps to a distinct pointer instead of colliding in the dedupe.
-*/
-function escapePointerToken(token) {
-	return token.replace(/~/g, "~0").replace(/\//g, "~1");
-}
 function visit(node, pointer) {
 	if (node.deprecated) _kubb_kit.Diagnostics.report({
 		code: _kubb_kit.Diagnostics.code.deprecated,
@@ -2264,7 +2327,7 @@ const adapterOasName = "oas";
 * })
 * ```
 */
-const adapterOas = (0, _kubb_kit.defineExtension)({
+const adapterOas = (0, _kubb_core.defineExtension)({
 	kind: "adapter",
 	meta: {
 		name: "oas",