@kubb/adapter-oas 5.5.3 → 5.5.4

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

@@ -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