OpenAPI: Improve error message

.changeset/common-webs-share.md

@@ -0,0 +1,5 @@
+---
+'fumadocs-openapi': patch
+---
+
+Improve error message

packages/openapi/src/playground/index.tsx

@@ -135,7 +135,7 @@ function getAuthorizationField(
 
   if (!item) {
     console.warn(
-      `Cannot find suitable security schema for API Playground from ${JSON.stringify(security, null, 2)}. Only one requirement is allowed`,
+      `Cannot find suitable security scheme for API Playground from ${JSON.stringify(security, null, 2)}. Only schemes with one requirement are allowed.`,
     );
     return;
   }

packages/openapi/src/utils/get-security.ts

@@ -17,7 +17,10 @@ export function getSecurities(
   const schemas = document.components?.securitySchemes ?? {};
 
   for (const [key, scopes] of Object.entries(requirement)) {
-    if (!(key in schemas)) return [];
+    if (!(key in schemas))
+      throw new Error(
+        `Security scheme with name ${key} is not found, make sure to define referenced schemes.`,
+      );
     const schema = schemas[key];
 
     results.push({