docusaurus-plugin-openapi-docs 0.0.0-beta.691 → 0.0.0-beta.719

package/lib/sidebars/index.d.ts

@@ -1,4 +1,4 @@
 import { ProcessedSidebar } from "@docusaurus/plugin-content-docs/src/sidebars/types";
-import { TagObject } from "../openapi/types";
+import { TagGroupObject, TagObject } from "../openapi/types";
 import type { SidebarOptions, APIOptions, ApiMetadata } from "../types";
-export default function generateSidebarSlice(sidebarOptions: SidebarOptions, options: APIOptions, api: ApiMetadata[], tags: TagObject[][], docPath: string): ProcessedSidebar;
+export default function generateSidebarSlice(sidebarOptions: SidebarOptions, options: APIOptions, api: ApiMetadata[], tags: TagObject[][], docPath: string, tagGroups?: TagGroupObject[]): ProcessedSidebar;

package/lib/sidebars/index.js

@@ -20,6 +20,9 @@ function isApiItem(item) {
 function isInfoItem(item) {
     return item.type === "info";
 }
+function isSchemaItem(item) {
+    return item.type === "schema";
+}
 function groupByTags(items, sidebarOptions, options, tags, docPath) {
     let { outputDir, label } = options;
     // Remove trailing slash before proceeding
@@ -27,6 +30,7 @@ function groupByTags(items, sidebarOptions, options, tags, docPath) {
     const { sidebarCollapsed, sidebarCollapsible, customProps, categoryLinkSource, } = sidebarOptions;
     const apiItems = items.filter(isApiItem);
     const infoItems = items.filter(isInfoItem);
+    const schemaItems = items.filter(isSchemaItem);
     const intros = infoItems.map((item) => {
         return {
             id: item.id,
@@ -56,16 +60,21 @@ function groupByTags(items, sidebarOptions, options, tags, docPath) {
         var _a, _b;
         const sidebar_label = item.frontMatter.sidebar_label;
         const title = item.title;
-        const id = item.id;
+        const id = item.type === "schema" ? `schemas/${item.id}` : item.id;
+        const className = item.type === "api"
+            ? (0, clsx_1.default)({
+                "menu__list-item--deprecated": item.api.deprecated,
+                "api-method": !!item.api.method,
+            }, item.api.method)
+            : (0, clsx_1.default)({
+                "menu__list-item--deprecated": item.schema.deprecated,
+            });
         return {
             type: "doc",
-            id: basePath === "" || undefined ? `${item.id}` : `${basePath}/${item.id}`,
+            id: basePath === "" || undefined ? `${id}` : `${basePath}/${id}`,
             label: (_b = (_a = sidebar_label) !== null && _a !== void 0 ? _a : title) !== null && _b !== void 0 ? _b : id,
             customProps: customProps,
-            className: (0, clsx_1.default)({
-                "menu__list-item--deprecated": item.api.deprecated,
-                "api-method": !!item.api.method,
-            }, item.api.method),
+            className: className ? className : undefined,
         };
     }
     let rootIntroDoc = undefined;
@@ -147,16 +156,47 @@ function groupByTags(items, sidebarOptions, options, tags, docPath) {
             },
         ];
     }
+    let schemas = [];
+    if (schemaItems.length > 0) {
+        schemas = [
+            {
+                type: "category",
+                label: "Schemas",
+                collapsible: sidebarCollapsible,
+                collapsed: sidebarCollapsed,
+                items: schemaItems.map(createDocItem),
+            },
+        ];
+    }
     // Shift root intro doc to top of sidebar
     // TODO: Add input validation for categoryLinkSource options
     if (rootIntroDoc && categoryLinkSource !== "info") {
         tagged.unshift(rootIntroDoc);
     }
-    return [...tagged, ...untagged];
+    return [...tagged, ...untagged, ...schemas];
 }
-function generateSidebarSlice(sidebarOptions, options, api, tags, docPath) {
+function generateSidebarSlice(sidebarOptions, options, api, tags, docPath, tagGroups) {
     let sidebarSlice = [];
-    if (sidebarOptions.groupPathsBy === "tag") {
+    if (sidebarOptions.groupPathsBy === "tagGroup") {
+        tagGroups === null || tagGroups === void 0 ? void 0 : tagGroups.forEach((tagGroup) => {
+            //filter tags only included in group
+            const filteredTags = [];
+            tags[0].forEach((tag) => {
+                if (tagGroup.tags.includes(tag.name)) {
+                    filteredTags.push(tag);
+                }
+            });
+            const groupCategory = {
+                type: "category",
+                label: tagGroup.name,
+                collapsible: true,
+                collapsed: true,
+                items: groupByTags(api, sidebarOptions, options, [filteredTags], docPath),
+            };
+            sidebarSlice.push(groupCategory);
+        });
+    }
+    else if (sidebarOptions.groupPathsBy === "tag") {
         sidebarSlice = groupByTags(api, sidebarOptions, options, tags, docPath);
     }
     return sidebarSlice;

package/lib/types.d.ts

@@ -1,5 +1,5 @@
 import type Request from "@paloaltonetworks/postman-collection";
-import { InfoObject, OperationObject, SecuritySchemeObject, TagObject } from "./openapi/types";
+import { InfoObject, OperationObject, SchemaObject, SecuritySchemeObject, TagObject } from "./openapi/types";
 export type { PropSidebarItemCategory, SidebarItemLink, PropSidebar, PropSidebarItem, } from "@docusaurus/plugin-content-docs-types";
 export interface PluginOptions {
     id?: string;
@@ -24,11 +24,13 @@ export interface APIOptions {
     };
     proxy?: string;
     markdownGenerators?: MarkdownGenerator;
+    showSchemas?: boolean;
 }
 export interface MarkdownGenerator {
     createApiPageMD?: (pageData: ApiPageMetadata) => string;
     createInfoPageMD?: (pageData: InfoPageMetadata) => string;
     createTagPageMD?: (pageData: TagPageMetadata) => string;
+    createSchemaPageMD?: (pageData: SchemaPageMetadata) => string;
 }
 export interface SidebarOptions {
     groupPathsBy?: string;
@@ -48,7 +50,7 @@ export interface APIVersionOptions {
 export interface LoadedContent {
     loadedApi: ApiMetadata[];
 }
-export declare type ApiMetadata = ApiPageMetadata | InfoPageMetadata | TagPageMetadata;
+export type ApiMetadata = ApiPageMetadata | InfoPageMetadata | TagPageMetadata | SchemaPageMetadata;
 export interface ApiMetadataBase {
     sidebar?: string;
     previous?: ApiNavLink;
@@ -100,7 +102,18 @@ export interface TagPageMetadata extends ApiMetadataBase {
     tag: TagObject;
     markdown?: string;
 }
-export declare type ApiInfo = InfoObject;
+export interface SchemaPageMetadata extends ApiMetadataBase {
+    type: "schema";
+    schema: SchemaObject;
+    markdown?: string;
+}
+export interface TagGroupPageMetadata extends ApiMetadataBase {
+    type: "tagGroup";
+    name: string;
+    tags: TagObject[];
+    markdown?: string;
+}
+export type ApiInfo = InfoObject;
 export interface ApiNavLink {
     title: string;
     permalink: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docusaurus-plugin-openapi-docs",
   "description": "OpenAPI plugin for Docusaurus.",
-  "version": "0.0.0-beta.691",
+  "version": "0.0.0-beta.719",
   "license": "MIT",
   "keywords": [
     "openapi",
@@ -28,26 +28,28 @@
     "watch": "tsc --watch"
   },
   "devDependencies": {
-    "@docusaurus/types": "^3.0.0",
+    "@docusaurus/types": "^3.0.1",
     "@types/fs-extra": "^9.0.13",
     "@types/json-pointer": "^1.0.31",
     "@types/json-schema": "^7.0.9",
     "@types/lodash": "^4.14.176",
-    "@types/mustache": "^4.1.2"
+    "@types/mustache": "^4.1.2",
+    "eslint-plugin-prettier": "^5.0.1"
   },
   "dependencies": {
-    "@apidevtools/json-schema-ref-parser": "^10.1.0",
-    "@docusaurus/plugin-content-docs": "^3.0.0",
-    "@docusaurus/utils": "^3.0.0",
-    "@docusaurus/utils-validation": "^3.0.0",
+    "@apidevtools/json-schema-ref-parser": "^11.5.4",
+    "@docusaurus/plugin-content-docs": "^3.0.1",
+    "@docusaurus/utils": "^3.0.1",
+    "@docusaurus/utils-validation": "^3.0.1",
     "@paloaltonetworks/openapi-to-postmanv2": "3.1.0-hotfix.1",
     "@paloaltonetworks/postman-collection": "^4.1.0",
-    "@redocly/openapi-core": "^1.0.0-beta.125",
+    "@redocly/openapi-core": "^1.10.5",
     "chalk": "^4.1.2",
     "clsx": "^1.1.1",
     "fs-extra": "^9.0.1",
     "json-pointer": "^0.6.2",
     "json-schema-merge-allof": "^0.8.1",
+    "json5": "^2.2.3",
     "lodash": "^4.17.20",
     "mustache": "^4.2.0",
     "slugify": "^1.6.5",
@@ -60,5 +62,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "2fad9fba3d1b313024f506eabd2c4fa312c51134"
+  "gitHead": "a39c6c416b43621bc5f7f16e739d75fa54c425a8"
 }

package/src/index.ts

@@ -12,13 +12,28 @@ import zlib from "zlib";
 import type { LoadContext, Plugin } from "@docusaurus/types";
 import { Globby, posixPath } from "@docusaurus/utils";
 import chalk from "chalk";
+import JSON5 from "json5";
 import { render } from "mustache";
 
-import { createApiPageMD, createInfoPageMD, createTagPageMD } from "./markdown";
+import {
+  createApiPageMD,
+  createInfoPageMD,
+  createSchemaPageMD,
+  createTagPageMD,
+} from "./markdown";
 import { readOpenapiFiles, processOpenapiFiles } from "./openapi";
 import { OptionsSchema } from "./options";
 import generateSidebarSlice from "./sidebars";
-import type { PluginOptions, LoadedContent, APIOptions } from "./types";
+import type {
+  PluginOptions,
+  LoadedContent,
+  APIOptions,
+  ApiMetadata,
+  ApiPageMetadata,
+  InfoPageMetadata,
+  TagPageMetadata,
+  SchemaPageMetadata,
+} from "./types";
 
 export function isURL(str: string): boolean {
   return /^(https?:)\/\//m.test(str);
@@ -117,7 +132,7 @@ export default function pluginOpenAPIDocs(
 
     try {
       const openapiFiles = await readOpenapiFiles(contentPath);
-      const [loadedApi, tags] = await processOpenapiFiles(
+      const [loadedApi, tags, tagGroups] = await processOpenapiFiles(
         openapiFiles,
         options,
         sidebarOptions!
@@ -141,24 +156,30 @@ export default function pluginOpenAPIDocs(
           options,
           loadedApi,
           tags,
-          docPath
+          docPath,
+          tagGroups
         );
 
-        const sidebarSliceTemplate = `module.exports = {{{slice}}};`;
+        let sidebarSliceTemplate = `import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";\n\n`;
+        sidebarSliceTemplate += `const sidebar: SidebarsConfig = {{{slice}}};\n\n`;
+        sidebarSliceTemplate += `export default sidebar.apisidebar;\n`;
 
         const view = render(sidebarSliceTemplate, {
-          slice: JSON.stringify(sidebarSlice),
+          slice: JSON5.stringify(
+            { apisidebar: sidebarSlice },
+            { space: 2, quote: '"' }
+          ),
         });
 
-        if (!fs.existsSync(`${outputDir}/sidebar.js`)) {
+        if (!fs.existsSync(`${outputDir}/sidebar.ts`)) {
           try {
-            fs.writeFileSync(`${outputDir}/sidebar.js`, view, "utf8");
+            fs.writeFileSync(`${outputDir}/sidebar.ts`, view, "utf8");
             console.log(
-              chalk.green(`Successfully created "${outputDir}/sidebar.js"`)
+              chalk.green(`Successfully created "${outputDir}/sidebar.ts"`)
             );
           } catch (err) {
             console.error(
-              chalk.red(`Failed to write "${outputDir}/sidebar.js"`),
+              chalk.red(`Failed to write "${outputDir}/sidebar.ts"`),
               chalk.yellow(err)
             );
           }
@@ -244,12 +265,43 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
 \`\`\`
       `;
 
+      const schemaMdTemplate = `---
+id: {{{id}}}
+title: "{{{title}}}"
+description: "{{{frontMatter.description}}}"
+sidebar_label: "{{{title}}}"
+hide_title: true
+schema: true
+custom_edit_url: null
+---
+
+{{{markdown}}}
+            `;
+
       const apiPageGenerator =
         markdownGenerators?.createApiPageMD ?? createApiPageMD;
       const infoPageGenerator =
         markdownGenerators?.createInfoPageMD ?? createInfoPageMD;
       const tagPageGenerator =
         markdownGenerators?.createTagPageMD ?? createTagPageMD;
+      const schemaPageGenerator =
+        markdownGenerators?.createSchemaPageMD ?? createSchemaPageMD;
+
+      const pageGeneratorByType: {
+        [key in ApiMetadata["type"]]: (
+          pageData: {
+            api: ApiPageMetadata;
+            info: InfoPageMetadata;
+            tag: TagPageMetadata;
+            schema: SchemaPageMetadata;
+          }[key]
+        ) => string;
+      } = {
+        api: apiPageGenerator,
+        info: infoPageGenerator,
+        tag: tagPageGenerator,
+        schema: schemaPageGenerator,
+      };
 
       loadedApi.map(async (item) => {
         if (item.type === "info") {
@@ -257,12 +309,7 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
             item.downloadUrl = downloadUrl;
           }
         }
-        const markdown =
-          item.type === "api"
-            ? apiPageGenerator(item)
-            : item.type === "info"
-            ? infoPageGenerator(item)
-            : tagPageGenerator(item);
+        const markdown = pageGeneratorByType[item.type](item as any);
         item.markdown = markdown;
         if (item.type === "api") {
           // opportunity to compress JSON
@@ -363,6 +410,49 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
             }
           }
         }
+
+        if (item.type === "schema") {
+          if (!fs.existsSync(`${outputDir}/schemas/${item.id}.schema.mdx`)) {
+            if (!fs.existsSync(`${outputDir}/schemas`)) {
+              try {
+                fs.mkdirSync(`${outputDir}/schemas`, { recursive: true });
+                console.log(
+                  chalk.green(`Successfully created "${outputDir}/schemas"`)
+                );
+              } catch (err) {
+                console.error(
+                  chalk.red(`Failed to create "${outputDir}/schemas"`),
+                  chalk.yellow(err)
+                );
+              }
+            }
+            try {
+              // kebabCase(arg) returns 0-length string when arg is undefined
+              if (item.id.length === 0) {
+                throw Error("Schema must have title defined");
+              }
+              // eslint-disable-next-line testing-library/render-result-naming-convention
+              const schemaView = render(schemaMdTemplate, item);
+              fs.writeFileSync(
+                `${outputDir}/schemas/${item.id}.schema.mdx`,
+                schemaView,
+                "utf8"
+              );
+              console.log(
+                chalk.green(
+                  `Successfully created "${outputDir}/${item.id}.schema.mdx"`
+                )
+              );
+            } catch (err) {
+              console.error(
+                chalk.red(
+                  `Failed to write "${outputDir}/${item.id}.schema.mdx"`
+                ),
+                chalk.yellow(err)
+              );
+            }
+          }
+        }
         return;
       });
 
@@ -380,6 +470,10 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
       cwd: path.resolve(apiDir),
       deep: 1,
     });
+    const schemaMdxFiles = await Globby(["*.schema.mdx"], {
+      cwd: path.resolve(apiDir, "schemas"),
+      deep: 1,
+    });
     const sidebarFile = await Globby(["sidebar.js"], {
       cwd: path.resolve(apiDir),
       deep: 1,
@@ -397,6 +491,21 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
       })
     );
 
+    schemaMdxFiles.map((mdx) =>
+      fs.unlink(`${apiDir}/schemas/${mdx}`, (err) => {
+        if (err) {
+          console.error(
+            chalk.red(`Cleanup failed for "${apiDir}/schemas/${mdx}"`),
+            chalk.yellow(err)
+          );
+        } else {
+          console.log(
+            chalk.green(`Cleanup succeeded for "${apiDir}/schemas/${mdx}"`)
+          );
+        }
+      })
+    );
+
     sidebarFile.map((sidebar) =>
       fs.unlink(`${apiDir}/${sidebar}`, (err) => {
         if (err) {
@@ -425,7 +534,11 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
 
     const versionsJson = JSON.stringify(versionsArray, null, 2);
     try {
-      fs.writeFileSync(`${outputDir}/versions.json`, versionsJson, "utf8");
+      fs.writeFileSync(
+        `${outputDir}/versions.json`,
+        versionsJson + "\n",
+        "utf8"
+      );
       console.log(
         chalk.green(`Successfully created "${outputDir}/versions.json"`)
       );
@@ -461,7 +574,7 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
       cli
         .command(`gen-api-docs`)
         .description(
-          `Generates OpenAPI docs in MDX file format and sidebar.js (if enabled).`
+          `Generates OpenAPI docs in MDX file format and sidebar.ts (if enabled).`
         )
         .usage("<id>")
         .arguments("<id>")
@@ -519,7 +632,7 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
       cli
         .command(`gen-api-docs:version`)
         .description(
-          `Generates versioned OpenAPI docs in MDX file format, versions.js and sidebar.js (if enabled).`
+          `Generates versioned OpenAPI docs in MDX file format, versions.js and sidebar.ts (if enabled).`
         )
         .usage("<id:version>")
         .arguments("<id:version>")
@@ -610,7 +723,7 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
       cli
         .command(`clean-api-docs`)
         .description(
-          `Clears the generated OpenAPI docs MDX files and sidebar.js (if enabled).`
+          `Clears the generated OpenAPI docs MDX files and sidebar.ts (if enabled).`
         )
         .usage("<id>")
         .arguments("<id>")
@@ -661,7 +774,7 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
       cli
         .command(`clean-api-docs:version`)
         .description(
-          `Clears the versioned, generated OpenAPI docs MDX files, versions.json and sidebar.js (if enabled).`
+          `Clears the versioned, generated OpenAPI docs MDX files, versions.json and sidebar.ts (if enabled).`
         )
         .usage("<id:version>")
         .arguments("<id:version>")

package/src/markdown/__snapshots__/createSchema.test.ts.snap

@@ -35,13 +35,7 @@ Array [
               Array [
             </div>
           </li>
-          <div
-            style={{
-              marginTop: \\".5rem\\",
-              marginBottom: \\".5rem\\",
-              marginLeft: \\"1rem\\",
-            }}
-          >
+          <div style={{ marginTop: \\".5rem\\", marginBottom: \\".5rem\\" }}>
             string
           </div>
           <li>
@@ -57,35 +51,17 @@ Array [
           </li>
         </TabItem>
         <TabItem label={\\"MOD3\\"} value={\\"2-item-properties\\"}>
-          <div
-            style={{
-              marginTop: \\".5rem\\",
-              marginBottom: \\".5rem\\",
-              marginLeft: \\"1rem\\",
-            }}
-          >
+          <div style={{ marginTop: \\".5rem\\", marginBottom: \\".5rem\\" }}>
             boolean
           </div>
         </TabItem>
         <TabItem label={\\"MOD4\\"} value={\\"3-item-properties\\"}>
-          <div
-            style={{
-              marginTop: \\".5rem\\",
-              marginBottom: \\".5rem\\",
-              marginLeft: \\"1rem\\",
-            }}
-          >
+          <div style={{ marginTop: \\".5rem\\", marginBottom: \\".5rem\\" }}>
             number
           </div>
         </TabItem>
         <TabItem label={\\"MOD5\\"} value={\\"4-item-properties\\"}>
-          <div
-            style={{
-              marginTop: \\".5rem\\",
-              marginBottom: \\".5rem\\",
-              marginLeft: \\"1rem\\",
-            }}
-          >
+          <div style={{ marginTop: \\".5rem\\", marginBottom: \\".5rem\\" }}>
             string
           </div>
         </TabItem>

package/src/markdown/createAuthentication.ts

@@ -5,9 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 
-import { OAuthFlowObject, SecuritySchemeObject } from "../openapi/types";
 import { createDescription } from "./createDescription";
 import { create, guard } from "./utils";
+import { OAuthFlowObject, SecuritySchemeObject } from "../openapi/types";
 
 export function createAuthentication(securitySchemes: SecuritySchemeObject) {
   if (!securitySchemes || !Object.keys(securitySchemes).length) return "";
@@ -167,11 +167,16 @@ export function createAuthentication(securitySchemes: SecuritySchemeObject) {
 
   return create("div", {
     children: [
-      create("h2", {
-        children: "Authentication",
-        id: "authentication",
-        style: { marginBottom: "1rem" },
-      }),
+      create(
+        "Heading",
+        {
+          children: "Authentication",
+          id: "authentication",
+          as: "h2",
+          className: "openapi-tabs__heading",
+        },
+        { inline: true }
+      ),
       create("SchemaTabs", {
         className: "openapi-tabs__security-schemes",
         children: Object.entries(securitySchemes).map(

package/src/markdown/createCallbacks.ts

@@ -0,0 +1,101 @@
+/* ============================================================================
+ * Copyright (c) Palo Alto Networks
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ * ========================================================================== */
+
+import { createDescription } from "./createDescription";
+import { createMethodEndpoint } from "./createMethodEndpoint";
+import { createRequestBodyDetails } from "./createRequestBodyDetails";
+import { createStatusCodes } from "./createStatusCodes";
+import { create } from "./utils";
+import { MediaTypeObject } from "../openapi/types";
+import { ApiItem } from "../types";
+
+interface Props {
+  callbacks: ApiItem["callbacks"];
+}
+
+interface RequestBodyProps {
+  title: string;
+  body: {
+    content?: {
+      [key: string]: MediaTypeObject;
+    };
+    description?: string;
+    required?: boolean;
+  };
+}
+
+export function createCallbacks({ callbacks }: Props) {
+  if (callbacks === undefined) {
+    return undefined;
+  }
+
+  const callbacksNames = Object.keys(callbacks);
+  if (callbacksNames.length === 0) {
+    return undefined;
+  }
+
+  return create("div", {
+    children: [
+      create("div", {
+        className: "openapi__divider",
+      }),
+      create(
+        "Heading",
+        {
+          children: "Callbacks",
+          id: "callbacks",
+          as: "h2",
+          className: "openapi-tabs__heading",
+        },
+        { inline: true }
+      ),
+      create("OperationTabs", {
+        className: "openapi-tabs__operation",
+        children: callbacksNames.flatMap((name) => {
+          const path = Object.keys(callbacks[name])[0];
+          const methods = new Map([
+            ["delete", callbacks[name][path].delete],
+            ["get", callbacks[name][path].get],
+            ["head", callbacks[name][path].head],
+            ["options", callbacks[name][path].options],
+            ["patch", callbacks[name][path].patch],
+            ["post", callbacks[name][path].post],
+            ["put", callbacks[name][path].put],
+            ["trace", callbacks[name][path].trace],
+          ]);
+
+          return Array.from(methods).flatMap(([method, operationObject]) => {
+            if (!operationObject) return [];
+
+            const { description, requestBody, responses } = operationObject;
+
+            return [
+              create("TabItem", {
+                label: `${method.toUpperCase()} ${name}`,
+                value: `${method}-${name}`,
+                children: [
+                  createMethodEndpoint(method, path),
+                  // TODO: add `deprecation notice` when markdown support is added
+                  createDescription(description),
+                  createRequestBodyDetails({
+                    title: "Body",
+                    body: requestBody,
+                  } as RequestBodyProps),
+                  createStatusCodes({
+                    id: "callbacks-responses",
+                    label: "Callbacks Responses",
+                    responses,
+                  }),
+                ],
+              }),
+            ];
+          });
+        }),
+      }),
+    ],
+  });
+}

package/src/markdown/createContactInfo.ts

@@ -5,8 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 
-import { ContactObject } from "../openapi/types";
 import { create, guard } from "./utils";
+import { ContactObject } from "../openapi/types";
 
 export function createContactInfo(contact: ContactObject) {
   if (!contact || !Object.keys(contact).length) return "";