@kubb/adapter-oas 5.5.3 → 5.5.5

package/dist/index.d.ts

@@ -1203,9 +1203,9 @@ type ServerOptions = {
  */
 type AdapterOasOptions = {
   /**
-   * Validate the OpenAPI spec with `@readme/openapi-parser` before parsing.
-   * Set to `false` only when you have a known-invalid spec you still want to
-   * generate from.
+   * Validate the OpenAPI spec with `@readme/openapi-parser` before parsing. Each problem is
+   * reported as a `KUBB_INVALID_SPEC` warning and generation continues. Set to `false` to skip the
+   * check, which also makes generation faster on a large spec.
    *
    * @default true
    */

package/dist/index.js

@@ -429,7 +429,7 @@ async function resolveSource(sourcePath) {
 * its parse error instead.
 */
 async function assertInputExists(input) {
-	if (URL.canParse(input)) return;
+	if (urlRegExp.test(input)) return;
 	if (!await exists(input)) throw new Diagnostics.Error({
 		code: Diagnostics.code.inputNotFound,
 		severity: "error",
@@ -518,7 +518,7 @@ async function parseDocument(pathOrApi) {
 */
 async function parseFromConfig(source) {
 	if (source.type === "data") return parseDocument(typeof source.data === "string" ? parse(source.data) : structuredClone(source.data));
-	if (URL.canParse(source.path)) return parseDocument(source.path);
+	if (urlRegExp.test(source.path)) return parseDocument(source.path);
 	const resolved = path.resolve(path.dirname(source.path), source.path);
 	await assertInputExists(resolved);
 	return parseDocument(resolved);
@@ -541,8 +541,17 @@ function assertDocument(document) {
 		location: { kind: "config" }
 	});
 }
+/** Reports a validation problem as a `KUBB_INVALID_SPEC` warning, a no-op outside a build. */
+function reportInvalidSpec(message) {
+	Diagnostics.report({
+		code: Diagnostics.code.invalidSpec,
+		severity: "warning",
+		message,
+		help: "Fix the spec, or run `kubb validate` to list every error. Set `validate: false` on the adapter to skip this check."
+	});
+}
 /**
-* Validates an OpenAPI document using `@readme/openapi-parser` with colorized error output.
+* Validates an OpenAPI document using `@readme/openapi-parser`. Throws with `throwOnError`, otherwise warns.
 *
 * @example
 * ```ts
@@ -551,12 +560,18 @@ function assertDocument(document) {
 */
 async function validateDocument(document, { throwOnError = false } = {}) {
 	const { compileErrors, validate } = await import("@readme/openapi-parser");
+	let result;
 	try {
-		const result = await validate(structuredClone(document), { validate: { errors: { colorize: true } } });
-		if (!result.valid) throw new Error(compileErrors(result));
+		result = await validate(structuredClone(document), { validate: { errors: { colorize: throwOnError } } });
 	} catch (error) {
 		if (throwOnError) throw error;
+		reportInvalidSpec(getErrorMessage(error));
+		return;
 	}
+	if (result.valid) return;
+	if (throwOnError) throw new Error(compileErrors(result));
+	for (const { message } of result.errors) reportInvalidSpec(message.replace(/\n.*/s, ""));
+	if (result.additionalErrors > 0) reportInvalidSpec(`${result.additionalErrors} more validation errors are not listed.`);
 }
 //#endregion
 //#region src/oas.ts
@@ -1978,7 +1993,7 @@ function walkPointer(document, $ref) {
 		applicable: false,
 		value: null
 	};
-	const pointer = globalThis.decodeURIComponent(trimmed.substring(1));
+	const pointer = trimmed.substring(1);
 	let docCache = _refCache.get(document);
 	if (!docCache) {
 		docCache = /* @__PURE__ */ new Map();
@@ -1988,7 +2003,7 @@ function walkPointer(document, $ref) {
 		applicable: true,
 		value: docCache.get(pointer)
 	};
-	const current = pointer.split("/").filter(Boolean).reduce((obj, key) => obj?.[key], document);
+	const current = pointer.split("/").filter(Boolean).map((token) => globalThis.decodeURIComponent(token).replaceAll("~1", "/").replaceAll("~0", "~")).reduce((obj, key) => obj?.[key], document);
 	if (current) docCache.set(pointer, current);
 	return {
 		applicable: true,