rapidoc 9.1.0 → 9.1.4

package/src/templates/security-scheme-template.js

@@ -1,25 +1,29 @@
+/* eslint-disable arrow-body-style */
 import { html } from 'lit-element';
 import { unsafeHTML } from 'lit-html/directives/unsafe-html';
-import marked from 'marked';
+import { marked } from 'marked';
 
 const codeVerifier = '731DB1C3F7EA533B85E29492D26AA-1234567890-1234567890';
 const codeChallenge = '4FatVDBJKPAo4JgLLaaQFMUcQPn5CrPRvLlaob9PTYc'; // Base64 encoded SHA-256
 
-export function applyApiKey(securitySchemeId, username = '', password = '', apikeyVal = '') {
+const localStorageKey = 'rapidoc';
+
+export function applyApiKey(securitySchemeId, username = '', password = '', providedApikeyVal = '') {
   const securityObj = this.resolvedSpec.securitySchemes?.find((v) => (v.securitySchemeId === securitySchemeId));
   if (!securityObj) {
     return false;
   }
-  let apiKeyValue = '';
-  if (securityObj.type && securityObj.scheme && securityObj.type === 'http' && securityObj.scheme.toLowerCase() === 'basic') {
+  let finalApiKeyValue = '';
+  if (securityObj.scheme?.toLowerCase() === 'basic') {
     if (username) {
-      apiKeyValue = `Basic ${btoa(`${username}:${password}`)}`;
+      finalApiKeyValue = `Basic ${btoa(`${username}:${password}`)}`;
     }
-  } else if (apikeyVal) {
-    apiKeyValue = `${securityObj.scheme?.toLowerCase() === 'bearer' ? 'Bearer' : ''} ${apiKeyValue}`;
+  } else if (providedApikeyVal) {
+    securityObj.value = providedApikeyVal;
+    finalApiKeyValue = `${securityObj.scheme?.toLowerCase() === 'bearer' ? 'Bearer ' : ''}${providedApikeyVal}`;
   }
-  if (apiKeyValue) {
-    securityObj.finalKeyValue = apiKeyValue;
+  if (finalApiKeyValue) {
+    securityObj.finalKeyValue = finalApiKeyValue;
     this.requestUpdate();
     return true;
   }
@@ -36,6 +40,21 @@ export function onClearAllApiKeys() {
   this.requestUpdate();
 }
 
+function getPersistedApiKeys() {
+  return JSON.parse(localStorage.getItem(localStorageKey)) || {};
+}
+
+function setPersistedApiKeys(obj) {
+  localStorage.setItem(localStorageKey, JSON.stringify(obj));
+}
+
+export function recoverPersistedApiKeys() {
+  const rapidocLs = getPersistedApiKeys.call(this);
+  Object.values(rapidocLs).forEach((p) => {
+    applyApiKey.call(this, p.securitySchemeId, p.username, p.password, p.value);
+  });
+}
+
 function onApiKeyChange(securitySchemeId) {
   let apiKeyValue = '';
   const securityObj = this.resolvedSpec.securitySchemes.find((v) => (v.securitySchemeId === securitySchemeId));
@@ -50,12 +69,17 @@ function onApiKeyChange(securitySchemeId) {
         apiKeyValue = trEl.querySelector('.api-key-input').value.trim();
         applyApiKey.call(this, securitySchemeId, '', '', apiKeyValue);
       }
+      if (this.persistAuth === 'true') {
+        const rapidocLs = getPersistedApiKeys.call(this);
+        rapidocLs[securitySchemeId] = securityObj;
+        setPersistedApiKeys.call(this, rapidocLs);
+      }
     }
   }
 }
 
 // Updates the OAuth Access Token (API key), so it reflects in UI and gets used in TRY calls
-function updateOAuthKey(securitySchemeId, tokenType = 'Bearer', accessToken) {
+function updateOAuthKey(securitySchemeId, accessToken, tokenType = 'Bearer') {
   const securityObj = this.resolvedSpec.securitySchemes.find((v) => (v.securitySchemeId === securitySchemeId));
   securityObj.finalKeyValue = `${(tokenType.toLowerCase() === 'bearer' ? 'Bearer' : (tokenType.toLowerCase() === 'mac' ? 'MAC' : tokenType))} ${accessToken}`;
   this.requestUpdate();
@@ -63,7 +87,7 @@ function updateOAuthKey(securitySchemeId, tokenType = 'Bearer', accessToken) {
 
 /* eslint-disable no-console */
 // Gets Access-Token in exchange of Authorization Code
-async function fetchAccessToken(tokenUrl, clientId, clientSecret, redirectUrl, grantType, authCode, sendClientSecretIn = 'header', securitySchemeId, authFlowDivEl, scopes = null, username = null, password = null) {
+async function fetchAccessToken(tokenUrl, clientId, clientSecret, redirectUrl, grantType, authCode, securitySchemeId, authFlowDivEl, sendClientSecretIn = 'header', scopes = null, username = null, password = null) {
   const respDisplayEl = authFlowDivEl ? authFlowDivEl.querySelector('.oauth-resp-display') : undefined;
   const urlFormParams = new URLSearchParams();
   const headers = new Headers();
@@ -94,7 +118,7 @@ async function fetchAccessToken(tokenUrl, clientId, clientSecret, redirectUrl, g
     const tokenResp = await resp.json();
     if (resp.ok) {
       if (tokenResp.token_type && tokenResp.access_token) {
-        updateOAuthKey.call(this, securitySchemeId, tokenResp.token_type, tokenResp.access_token);
+        updateOAuthKey.call(this, securitySchemeId, tokenResp.access_token, tokenResp.token_type);
         if (respDisplayEl) {
           respDisplayEl.innerHTML = '<span style="color:var(--green)">Access Token Received</span>';
         }
@@ -130,10 +154,10 @@ async function onWindowMessageEvent(msgEvent, winObj, tokenUrl, clientId, client
   if (msgEvent.data) {
     if (msgEvent.data.responseType === 'code') {
       // Authorization Code flow
-      fetchAccessToken.call(this, tokenUrl, clientId, clientSecret, redirectUrl, grantType, msgEvent.data.code, sendClientSecretIn, securitySchemeId, authFlowDivEl);
+      fetchAccessToken.call(this, tokenUrl, clientId, clientSecret, redirectUrl, grantType, msgEvent.data.code, securitySchemeId, authFlowDivEl, sendClientSecretIn);
     } else if (msgEvent.data.responseType === 'token') {
       // Implicit flow
-      updateOAuthKey.call(this, securitySchemeId, msgEvent.data.token_type, msgEvent.data.access_token);
+      updateOAuthKey.call(this, securitySchemeId, msgEvent.data.access_token, msgEvent.data.token_type);
     }
   }
 }
@@ -217,11 +241,11 @@ async function onInvokeOAuthFlow(securitySchemeId, flowType, authUrl, tokenUrl,
   } else if (flowType === 'clientCredentials') {
     grantType = 'client_credentials';
     const selectedScopes = checkedScopeEls.map((v) => v.value).join(' ');
-    fetchAccessToken.call(this, tokenUrl, clientId, clientSecret, redirectUrlObj.toString(), grantType, '', sendClientSecretIn, securitySchemeId, authFlowDivEl, selectedScopes);
+    fetchAccessToken.call(this, tokenUrl, clientId, clientSecret, redirectUrlObj.toString(), grantType, '', securitySchemeId, authFlowDivEl, sendClientSecretIn, selectedScopes);
   } else if (flowType === 'password') {
     grantType = 'password';
     const selectedScopes = checkedScopeEls.map((v) => v.value).join(' ');
-    fetchAccessToken.call(this, tokenUrl, clientId, clientSecret, redirectUrlObj.toString(), grantType, '', sendClientSecretIn, securitySchemeId, authFlowDivEl, selectedScopes, username, password);
+    fetchAccessToken.call(this, tokenUrl, clientId, clientSecret, redirectUrlObj.toString(), grantType, '', securitySchemeId, authFlowDivEl, sendClientSecretIn, selectedScopes, username, password);
   }
 }
 /* eslint-enable no-console */
@@ -338,6 +362,20 @@ function oAuthFlowTemplate(flowName, clientId, clientSecret, securitySchemeId, a
   `;
 }
 
+function removeApiKey(securitySchemeId) {
+  const securityObj = this.resolvedSpec.securitySchemes?.find((v) => (v.securitySchemeId === securitySchemeId));
+  securityObj.user = '';
+  securityObj.password = '';
+  securityObj.value = '';
+  securityObj.finalKeyValue = '';
+  if (this.persistAuth === 'true') {
+    const rapidocLs = getPersistedApiKeys.call(this);
+    delete rapidocLs[securityObj.securitySchemeId];
+    setPersistedApiKeys.call(this, rapidocLs);
+  }
+  this.requestUpdate();
+}
+
 export default function securitySchemeTemplate() {
   if (!this.resolvedSpec) { return ''; }
   const providedApiKeys = this.resolvedSpec.securitySchemes?.filter((v) => (v.finalKeyValue));
@@ -368,7 +406,7 @@ export default function securitySchemeTemplate() {
                   ${v.finalKeyValue
                     ? html`
                       <span class='blue-text'>  ${v.finalKeyValue ? 'Key Applied' : ''} </span>
-                      <button class="m-btn thin-border small" part="btn btn-outline" @click=${() => { v.finalKeyValue = ''; this.requestUpdate(); }}>REMOVE</button>
+                      <button class="m-btn thin-border small" part="btn btn-outline" @click=${() => { removeApiKey.call(this, v.securitySchemeId); }}>REMOVE</button>
                       `
                     : ''
                   }
@@ -426,9 +464,7 @@ export default function securitySchemeTemplate() {
               ? html`
                 <tr>
                   <td style="border:none; padding-left:48px">
-                    ${Object.keys(v.flows).map((f) => oAuthFlowTemplate.call(
-                      this, f, v['x-client-id'], v['x-client-secret'], v.securitySchemeId, v.flows[f],
-                    ))} 
+                    ${Object.keys(v.flows).map((f) => oAuthFlowTemplate.call(this, f, v['x-client-id'], v['x-client-secret'], v.securitySchemeId, v.flows[f]))} 
                   </td>
                 </tr>    
                 `
@@ -449,19 +485,18 @@ export function pathSecurityTemplate(pathSecurity) {
     pathSecurity.forEach((pSecurity) => {
       const andSecurityKeys1 = [];
       const andKeyTypes = [];
-      let pathScopes = '';
       Object.keys(pSecurity).forEach((pathSecurityKey) => {
+        let pathScopes = '';
         const s = this.resolvedSpec.securitySchemes.find((ss) => ss.securitySchemeId === pathSecurityKey);
-        if (!pathScopes && Array.isArray(pSecurity[pathSecurityKey])) {
+        if (pSecurity[pathSecurityKey] && Array.isArray(pSecurity[pathSecurityKey])) {
           pathScopes = pSecurity[pathSecurityKey].join(', ');
         }
         if (s) {
           andKeyTypes.push(s.typeDisplay);
-          andSecurityKeys1.push(s);
+          andSecurityKeys1.push({ ...s, ...({ scopes: pathScopes }) });
         }
       });
       orSecurityKeys1.push({
-        pathScopes,
         securityTypes: andKeyTypes.length > 1 ? `${andKeyTypes[0]} + ${andKeyTypes.length - 1} more` : andKeyTypes[0],
         securityDefs: andSecurityKeys1,
       });
@@ -485,7 +520,20 @@ export function pathSecurityTemplate(pathSecurity) {
                 <div class="tooltip-text" style="position:absolute; color: var(--fg); top:26px; right:0; border:1px solid var(--border-color);padding:2px 4px; display:block;">
                   ${orSecurityItem1.securityDefs.length > 1 ? html`<div>Requires <b>all</b> of the following </div>` : ''}
                   <div style="padding-left: 8px">
-                    ${orSecurityItem1.securityDefs.map((andSecurityItem, j) => html`
+                    ${orSecurityItem1.securityDefs.map((andSecurityItem, j) => {
+                      const scopeHtml = html`${andSecurityItem.scopes !== ''
+                        ? html`
+                          <div>
+                            <b>Required scopes:</b> 
+                            <br/> 
+                            <div style="margin-left:8px">  
+                              ${andSecurityItem.scopes.split(',').map((scope, cnt) => html`${cnt === 0 ? '' : '┃'}<span>${scope}</span>`)}
+                            </div>  
+                          </div>`
+                        : ''
+                      }`;
+
+                      return html`
                       ${andSecurityItem.type === 'oauth2'
                         ? html`
                           <div>
@@ -494,31 +542,23 @@ export function pathSecurityTemplate(pathSecurity) {
                               : 'Needs'
                             }
                             OAuth Token <span style="font-family:var(--font-mono); color:var(--primary-color);">${andSecurityItem.securitySchemeId}</span> in <b>Authorization header</b>
-                            ${orSecurityItem1.pathScopes !== ''
-                              ? html`
-                                <div>
-                                  <b>Required scopes:</b> 
-                                  <br/> 
-                                  <div style="margin-left:8px">  
-                                    ${orSecurityItem1.pathScopes.split(',').map((scope, cnt) => html`${cnt === 0 ? '' : '┃'}<span>${scope}</span>`)}
-                                  </div>  
-                                </div>`
-                              : ''
-                            }
+                            ${scopeHtml}
                           </div>`
                         : andSecurityItem.type === 'http'
                           ? html`
                             <div>
                               ${orSecurityItem1.securityDefs.length > 1 ? html`<b>${j + 1}.</b> &nbsp;` : html`Requires`} 
                               ${andSecurityItem.scheme === 'basic' ? 'Base 64 encoded username:password' : 'Bearer Token'} in <b>Authorization header</b>
+                              ${scopeHtml}
                             </div>`
                           : html`
                             <div>
                               ${orSecurityItem1.securityDefs.length > 1 ? html`<b>${j + 1}.</b> &nbsp;` : html`Requires`} 
                               Token in <b>${andSecurityItem.name} ${andSecurityItem.in}</b>
+                              ${scopeHtml}
                             </div>`
-                      }
-                    `)}
+                      }`;
+                    })}
                   </div>  
                 </div>
               </div>

package/src/templates/server-template.js

@@ -1,5 +1,5 @@
 import { html } from 'lit-element';
-import marked from 'marked';
+import { marked } from 'marked';
 import { unsafeHTML } from 'lit-html/directives/unsafe-html';
 
 export function setApiServer(serverUrl) {

package/src/utils/common-utils.js

@@ -10,10 +10,11 @@ export function debounce(fn, delay) {
   };
 }
 
-export const invalidCharsRegEx = new RegExp(/[\s#:?&={}]/, 'g'); // used for generating valid html element ids by replacing the invalid chars with hyphen (-)
+export const invalidCharsRegEx = /[\s#:?&={}]/g; // used for generating valid html element ids by replacing the invalid chars with hyphen (-)
 export const rapidocApiKey = '_rapidoc_api_key';
 
 export function sleep(ms) {
+  // eslint-disable-next-line no-promise-executor-return
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 

package/src/utils/schema-utils.js

@@ -389,10 +389,12 @@ export function schemaToSampleObj(schema, config = { }) {
         const oneOfSamples = schemaToSampleObj(schema.oneOf[key], config);
         for (const sampleKey in oneOfSamples) {
           // 2. In the final example include a one-of item along with properties
-          const finalExample = Object.assign(oneOfSamples[sampleKey], objWithSchemaProps);
-          obj[`example-${i}`] = finalExample;
-          addSchemaInfoToExample(schema.oneOf[key], obj[`example-${i}`]);
-          i++;
+          if (oneOfSamples[sampleKey] === null) {
+            const finalExample = Object.assign(oneOfSamples[sampleKey], objWithSchemaProps);
+            obj[`example-${i}`] = finalExample;
+            addSchemaInfoToExample(schema.oneOf[key], obj[`example-${i}`]);
+            i++;
+          }
         }
       }
     }
@@ -436,10 +438,10 @@ export function schemaToSampleObj(schema, config = { }) {
       obj['example-0'] = schema.example;
     } else {
       for (const propertyName in schema.properties) {
-        if (schema.properties[propertyName].deprecated && !config.includeDeprecated) { continue; }
-        if (schema.properties[propertyName].readOnly && !config.includeReadOnly) { continue; }
-        if (schema.properties[propertyName].writeOnly && !config.includeWriteOnly) { continue; }
-        if (schema.properties[propertyName].type === 'array' || schema.properties[propertyName].items) {
+        if (schema.properties[propertyName]?.deprecated && !config.includeDeprecated) { continue; }
+        if (schema.properties[propertyName]?.readOnly && !config.includeReadOnly) { continue; }
+        if (schema.properties[propertyName]?.writeOnly && !config.includeWriteOnly) { continue; }
+        if (schema.properties[propertyName]?.type === 'array' || schema.properties[propertyName]?.items) {
           if (schema.properties[propertyName].example) {
             addPropertyExampleToObjectExamples(schema.properties[propertyName].example, obj, propertyName);
           } else if (schema.properties[propertyName]?.items?.example) { // schemas and properties support single example but not multiple examples.
@@ -622,6 +624,7 @@ export function schemaInObjectNotation(schema, obj, level = 0, suffix = '') {
     obj['::description'] = schema.description || '';
     obj['::type'] = 'object';
     obj['::deprecated'] = schema.deprecated || false;
+    obj['::readwrite'] = schema.readOnly ? 'readonly' : schema.writeOnly ? 'writeonly' : '';
     for (const key in schema.properties) {
       if (schema.required && schema.required.includes(key)) {
         obj[`${key}*`] = schemaInObjectNotation(schema.properties[key], {}, (level + 1));
@@ -639,6 +642,8 @@ export function schemaInObjectNotation(schema, obj, level = 0, suffix = '') {
         ? `array<${schema.items.description}>`
         : '';
     obj['::type'] = 'array';
+    obj['::deprecated'] = schema.deprecated || false;
+    obj['::readwrite'] = schema.readOnly ? 'readonly' : schema.writeOnly ? 'writeonly' : '';
     if (schema.items.items) {
       obj['::array-type'] = schema.items.items.type;
     }
@@ -654,14 +659,14 @@ export function schemaInObjectNotation(schema, obj, level = 0, suffix = '') {
 }
 
 /* Create Example object */
-export function generateExample(examples = '', example = '', schema, mimeType, includeReadOnly = true, includeWriteOnly = true, outputType) {
+export function generateExample(schema, mimeType, examples = '', example = '', includeReadOnly = true, includeWriteOnly = true, outputType = 'json', includeGeneratedExample = false) {
   const finalExamples = [];
   // First check if examples is provided
   if (examples) {
     for (const eg in examples) {
       let egContent = '';
       let egFormat = 'json';
-      if (mimeType.toLowerCase().includes('json')) {
+      if (mimeType?.toLowerCase().includes('json')) {
         if (outputType === 'text') {
           egContent = typeof examples[eg].value === 'string' ? examples[eg].value : JSON.stringify(examples[eg].value, undefined, 2);
           egFormat = 'text';
@@ -695,7 +700,7 @@ export function generateExample(examples = '', example = '', schema, mimeType, i
   } else if (example) {
     let egContent = '';
     let egFormat = 'json';
-    if (mimeType.toLowerCase().includes('json')) {
+    if (mimeType?.toLowerCase().includes('json')) {
       if (outputType === 'text') {
         egContent = typeof example === 'string' ? example : JSON.stringify(example, undefined, 2);
         egFormat = 'text';
@@ -724,8 +729,8 @@ export function generateExample(examples = '', example = '', schema, mimeType, i
       exampleFormat: egFormat,
     });
   }
-  // If schema-level examples are not provided then generate one based on the schema field types
-  if (finalExamples.length === 0) {
+  // If schema-level examples are not provided or includeGeneratedExample === true then generate one based on the schema field types
+  if (finalExamples.length === 0 || includeGeneratedExample === true) {
     if (schema) {
       if (schema.example) { // Note: schema.examples (plurals) is not allowed as per spec
         finalExamples.push({
@@ -734,14 +739,14 @@ export function generateExample(examples = '', example = '', schema, mimeType, i
           exampleDescription: '',
           exampleType: mimeType,
           exampleValue: schema.example,
-          exampleFormat: ((mimeType.toLowerCase().includes('json') && typeof schema.example === 'object') ? 'json' : 'text'),
+          exampleFormat: ((mimeType?.toLowerCase().includes('json') && typeof schema.example === 'object') ? 'json' : 'text'),
         });
-      } else if (mimeType.toLowerCase().includes('json') || mimeType.toLowerCase().includes('text') || mimeType.toLowerCase().includes('*/*') || mimeType.toLowerCase().includes('xml')) {
+      } else if (mimeType?.toLowerCase().includes('json') || mimeType?.toLowerCase().includes('text') || mimeType?.toLowerCase().includes('*/*') || mimeType?.toLowerCase().includes('xml')) {
         let xmlRootStart = '';
         let xmlRootEnd = '';
         let exampleFormat = '';
         let exampleValue = '';
-        if (mimeType.toLowerCase().includes('xml')) {
+        if (mimeType?.toLowerCase().includes('xml')) {
           xmlRootStart = (schema.xml && schema.xml.name) ? `<${schema.xml.name}>` : '<root>';
           xmlRootEnd = (schema.xml && schema.xml.name) ? `</${schema.xml.name}>` : '</root>';
           exampleFormat = 'text';
@@ -767,7 +772,7 @@ export function generateExample(examples = '', example = '', schema, mimeType, i
           const description = samples[samplesKey]['::DESCRIPTION'] || '';
           removeTitlesAndDescriptions(samples[samplesKey]);
 
-          if (mimeType.toLowerCase().includes('xml')) {
+          if (mimeType?.toLowerCase().includes('xml')) {
             exampleValue = `${xmlRootStart}${json2xml(samples[samplesKey])}\n${xmlRootEnd}`;
           } else {
             exampleValue = outputType === 'text' ? JSON.stringify(samples[samplesKey], null, 2) : samples[samplesKey];
@@ -819,7 +824,7 @@ function getSerializeStyleForContentType(contentType) {
 
 export function getSchemaFromParam(param) {
   if (param.schema) {
-    return [param.schema, null];
+    return [param.schema, null, null];
   }
   if (param.content) {
     // we gonna use the first content-encoding
@@ -829,5 +834,5 @@ export function getSchemaFromParam(param) {
       }
     }
   }
-  return [null, null];
+  return [null, null, null];
 }

package/src/utils/spec-parser.js

@@ -1,6 +1,6 @@
 /* eslint-disable no-use-before-define */
 import OpenApiParser from '@apitools/openapi-parser';
-import marked from 'marked';
+import { marked } from 'marked';
 import { invalidCharsRegEx, rapidocApiKey, sleep } from '~/utils/common-utils';
 
 export default async function ProcessSpec(specUrl, generateMissingTags = false, sortTags = false, sortEndpointsBy = '', attrApiKey = '', attrApiKeyLocation = '', attrApiKeyValue = '', serverUrl = '') {
@@ -14,6 +14,19 @@ export default async function ProcessSpec(specUrl, generateMissingTags = false,
       specMeta = await OpenApiParser.resolve({ spec: specUrl }); // Swagger({ spec: specUrl });
     }
     await sleep(0); // important to show the initial loader (allows for rendering updates)
+
+    // If  JSON Schema Viewer
+    if (specMeta.resolvedSpec?.jsonSchemaViewer && specMeta.resolvedSpec?.schemaAndExamples) {
+      this.dispatchEvent(new CustomEvent('before-render', { detail: { spec: specMeta.resolvedSpec } }));
+      const schemaAndExamples = Object.entries(specMeta.resolvedSpec.schemaAndExamples).map((v) => ({ show: true, expanded: true, selectedExample: null, name: v[0], elementId: v[0].replace(invalidCharsRegEx, '-'), ...v[1] }));
+      const parsedSpec = {
+        specLoadError: false,
+        isSpecLoading: false,
+        info: specMeta.resolvedSpec.info,
+        schemaAndExamples,
+      };
+      return parsedSpec;
+    }
     if (specMeta.spec && (specMeta.spec.components || specMeta.spec.info || specMeta.spec.servers || specMeta.spec.tags || specMeta.spec.paths)) {
       jsonParsedSpec = specMeta.spec;
       this.dispatchEvent(new CustomEvent('before-render', { detail: { spec: jsonParsedSpec } }));
@@ -37,7 +50,7 @@ export default async function ProcessSpec(specUrl, generateMissingTags = false,
   // const pathGroups = groupByPaths(jsonParsedSpec);
 
   // Tags with Paths and WebHooks
-  const tags = groupByTags(jsonParsedSpec, generateMissingTags, sortTags, sortEndpointsBy);
+  const tags = groupByTags(jsonParsedSpec, sortEndpointsBy, generateMissingTags, sortTags);
 
   // Components
   const components = getComponents(jsonParsedSpec);
@@ -226,7 +239,7 @@ function getComponents(openApiSpec) {
   return components || [];
 }
 
-function groupByTags(openApiSpec, generateMissingTags = false, sortTags = false, sortEndpointsBy) {
+function groupByTags(openApiSpec, sortEndpointsBy, generateMissingTags = false, sortTags = false) {
   const supportedMethods = ['get', 'put', 'post', 'delete', 'patch', 'head', 'options']; // this is also used for ordering endpoints by methods
   const tags = openApiSpec.tags && Array.isArray(openApiSpec.tags)
     ? openApiSpec.tags.map((v) => ({
@@ -318,6 +331,14 @@ function groupByTags(openApiSpec, generateMissingTags = false, sortTags = false,
             finalParameters = pathOrHookObj.parameters ? pathOrHookObj.parameters.slice(0) : [];
           }
 
+          // Filter callbacks to contain only objects.
+          if (pathOrHookObj.callbacks) {
+            for (const [callbackName, callbackConfig] of Object.entries(pathOrHookObj.callbacks)) {
+              const filteredCallbacks = Object.entries(callbackConfig).filter((entry) => typeof entry[1] === 'object') || [];
+              pathOrHookObj.callbacks[callbackName] = Object.fromEntries(filteredCallbacks);
+            }
+          }
+
           // Update Responses
           tagObj.paths.push({
             show: true,

package/webpack.config.js

@@ -49,18 +49,6 @@ const commonPlugins = [
       },
     },
   }),
-  /*
-  new ESLintPlugin({
-    emitError: true,
-    emitWarning: true,
-    formatter: 'stylish',
-    overrideConfigFile: path.resolve(__dirname, '.eslintrc'),
-    outputReport: {
-      filePath: './eslint_report.html',
-      formatter: 'html',
-    },
-  }),
-  */
 ];
 
 if (process.env.NODE_ENV === 'production') {
@@ -156,6 +144,7 @@ module.exports = {
   resolve: {
     fallback: {
       fs: false,
+      buffer: require.resolve('buffer'),
     },
     alias: {
       '~': path.resolve(__dirname, 'src'),