docusaurus-theme-openapi-docs 1.0.1 → 1.0.2

package/lib/postman-code-generators.d.ts

@@ -0,0 +1,9 @@
+/* ============================================================================
+ * 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.
+ * ========================================================================== */
+
+// TODO: Remove this when https://github.com/facebook/docusaurus/issues/6087 is resolved.
+declare module "@paloaltonetworks/postman-code-generators";

package/lib/react-magic-dropzone.d.ts

@@ -0,0 +1,9 @@
+/* ============================================================================
+ * 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.
+ * ========================================================================== */
+
+// TODO: Remove this when https://github.com/facebook/docusaurus/issues/6087 is resolved.
+declare module "react-magic-dropzone";

package/lib/theme/ApiDemoPanel/Curl/index.js

@@ -35,7 +35,6 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
-// @ts-ignore
 const languageSet = [{
   tabName: "cURL",
   highlight: "bash",

package/lib/theme/ApiDemoPanel/FormFileUpload/index.js

@@ -25,7 +25,6 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
-// @ts-ignore
 function RenderPreview({
   file
 }) {

package/lib/theme/ApiDemoPanel/SecuritySchemes/index.js

@@ -26,9 +26,13 @@ function SecuritySchemes() {
     marginBottom: "var(--ifm-table-cell-padding)"
   }}>
       {selectedAuth.map(auth => {
-      if (auth.type === "apiKey") {
-        return <_react.default.Fragment key={selected + "-apiKey"}>
-              <b>Authorization: {auth.name}</b>
+      const isApiKey = auth.type === "apiKey";
+      const isBearer = auth.type === "http" && auth.key === "Bearer";
+      const isClientCredentials = auth.type === "oauth2" && auth.key === "ClientCredentials";
+
+      if (isApiKey || isBearer) {
+        return <_react.default.Fragment key={selected}>
+              <b>Authorization: {auth.key}</b>
               <pre style={{
             display: "flex",
             flexDirection: "column",
@@ -42,6 +46,20 @@ function SecuritySchemes() {
             </_react.default.Fragment>;
       }
 
+      if (isClientCredentials) {
+        return <_react.default.Fragment key={selected}>
+              <b>Authorization: {auth.key}</b>
+              <pre style={{
+            display: "flex",
+            flexDirection: "column",
+            background: "var(--openapi-card-background-color)",
+            borderRadius: "var(--openapi-card-border-radius)"
+          }}>
+                <span>type: {auth.type}</span>
+              </pre>
+            </_react.default.Fragment>;
+      }
+
       return null;
     })}
     </div>;

package/lib/theme/ApiDemoPanel/buildPostmanRequest.js

@@ -17,7 +17,6 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
-// @ts-ignore
 function setQueryParams(postman, queryParams) {
   postman.url.query.clear();
   const qp = queryParams.map(param => {
@@ -270,6 +269,10 @@ function buildPostmanRequest(postman, {
       } = auth.data[a.key];
 
       if (token === undefined) {
+        otherHeaders.push({
+          key: "Authorization",
+          value: "Bearer <TOKEN>"
+        });
         continue;
       }
 
@@ -307,7 +310,7 @@ function buildPostmanRequest(postman, {
       if (apikey === undefined) {
         otherHeaders.push({
           key: a.name,
-          value: "API_KEY_VALUE"
+          value: "<API_KEY_VALUE>"
         });
         continue;
       }

package/lib/theme/ApiDemoPanel/index.js

@@ -45,8 +45,6 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
-// @ts-ignore
-// @ts-ignore
 function ApiDemoPanel({
   item
 }) {
@@ -58,8 +56,7 @@ function ApiDemoPanel({
   const themeConfig = siteConfig.themeConfig;
   const options = themeConfig.api;
   const postman = new _postmanCollection.default.Request(item.postman);
-  const acceptArray = Array.from(new Set(Object.values((_item$responses = item.responses) !== null && _item$responses !== void 0 ? _item$responses : {}) // @ts-ignore
-  .map(response => {
+  const acceptArray = Array.from(new Set(Object.values((_item$responses = item.responses) !== null && _item$responses !== void 0 ? _item$responses : {}).map(response => {
     var _response$content;
 
     return Object.keys((_response$content = response.content) !== null && _response$content !== void 0 ? _response$content : {});
@@ -74,8 +71,9 @@ function ApiDemoPanel({
     cookie: []
   };
   (_item$parameters = item.parameters) === null || _item$parameters === void 0 ? void 0 : _item$parameters.forEach(param => {
-    // @ts-ignore
-    params[param.in].push(param);
+    const paramType = param.in;
+    const paramsArray = params[paramType];
+    paramsArray.push(param);
   });
   const auth = (0, _slice.createAuth)({
     security: item.security,

package/lib/theme/ApiItem/index.js

@@ -136,11 +136,11 @@ function DocItemContent(props) {
                 </div>
               </_MDXContent.default>
             </div>
-            <div className={(0, _clsx.default)("col", api ? "col--7" : !canRenderTOC ? "col--9" : "col--12")}>
+            <div className={(0, _clsx.default)("col", api ? "col--7" : "col--12")}>
               <_DocItemFooter.default {...props} />
             </div>
           </article>
-          <div className={(0, _clsx.default)("col", api ? "col--7" : !canRenderTOC ? "col--9" : "col--12")}>
+          <div className={(0, _clsx.default)("col", api ? "col--7" : "col--12")}>
             <_DocPaginator.default previous={metadata.previous} next={metadata.next} />
           </div>
         </div>

package/lib/theme/ApiItem/styles.module.css

@@ -1,5 +1,9 @@
 :root {
   --openapi-required: var(--ifm-color-danger);
+  --openapi-code-blue: var(--ifm-color-info);
+  --openapi-code-red: var(--ifm-color-danger);
+  --openapi-code-orange: var(--ifm-color-warning);
+  --openapi-code-green: var(--ifm-color-success);
 }
 
 .apiItemContainer article > *:first-child,
@@ -75,9 +79,9 @@
   font-size: 14px;
 }
 
-:global(.theme-api-markdown h2) {
+/* :global(.theme-api-markdown h2) {
   font-size: 2rem;
-}
+} */
 
 :global(.schemaItem) {
   list-style: none;

package/lib/theme/{Tabs → ApiTabs}/index.js

@@ -29,7 +29,7 @@ function isTabItem(comp) {
   return typeof comp.props.value !== "undefined";
 }
 
-function ResponseCodeTabs(props) {
+function ApiTabsComponent(props) {
   const {
     lazy,
     block,
@@ -246,10 +246,10 @@ function ResponseCodeTabs(props) {
   );
 }
 
-export default function Tabs(props) {
+export default function ApiTabs(props) {
   const isBrowser = useIsBrowser();
   return (
-    <ResponseCodeTabs // Remount tabs after hydration
+    <ApiTabsComponent // Remount tabs after hydration
       // Temporary fix for https://github.com/facebook/docusaurus/issues/5653
       key={String(isBrowser)}
       {...props}

package/lib-next/postman-code-generators.d.ts

@@ -0,0 +1,9 @@
+/* ============================================================================
+ * 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.
+ * ========================================================================== */
+
+// TODO: Remove this when https://github.com/facebook/docusaurus/issues/6087 is resolved.
+declare module "@paloaltonetworks/postman-code-generators";

package/lib-next/react-magic-dropzone.d.ts

@@ -0,0 +1,9 @@
+/* ============================================================================
+ * 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.
+ * ========================================================================== */
+
+// TODO: Remove this when https://github.com/facebook/docusaurus/issues/6087 is resolved.
+declare module "react-magic-dropzone";

package/lib-next/theme/ApiDemoPanel/Curl/index.js

@@ -5,10 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 import React, { useRef, useState, useEffect } from "react";
-import useDocusaurusContext from "@docusaurus/useDocusaurusContext"; // @ts-ignore
-
-import codegen from "@paloaltonetworks/postman-code-generators"; // @ts-ignore
-
+import useDocusaurusContext from "@docusaurus/useDocusaurusContext";
+import codegen from "@paloaltonetworks/postman-code-generators";
 import clsx from "clsx";
 import Highlight, { defaultProps } from "prism-react-renderer";
 import { useTypedSelector } from "../hooks";

package/lib-next/theme/ApiDemoPanel/FormFileUpload/index.js

@@ -4,8 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
-import React, { useState } from "react"; // @ts-ignore
-
+import React, { useState } from "react";
 import MagicDropzone from "react-magic-dropzone";
 import FloatingButton from "../FloatingButton";
 import styles from "./styles.module.css";

package/lib-next/theme/ApiDemoPanel/SecuritySchemes/index.js

@@ -19,10 +19,15 @@ function SecuritySchemes() {
       }}
     >
       {selectedAuth.map((auth) => {
-        if (auth.type === "apiKey") {
+        const isApiKey = auth.type === "apiKey";
+        const isBearer = auth.type === "http" && auth.key === "Bearer";
+        const isClientCredentials =
+          auth.type === "oauth2" && auth.key === "ClientCredentials";
+
+        if (isApiKey || isBearer) {
           return (
-            <React.Fragment key={selected + "-apiKey"}>
-              <b>Authorization: {auth.name}</b>
+            <React.Fragment key={selected}>
+              <b>Authorization: {auth.key}</b>
               <pre
                 style={{
                   display: "flex",
@@ -39,6 +44,24 @@ function SecuritySchemes() {
           );
         }
 
+        if (isClientCredentials) {
+          return (
+            <React.Fragment key={selected}>
+              <b>Authorization: {auth.key}</b>
+              <pre
+                style={{
+                  display: "flex",
+                  flexDirection: "column",
+                  background: "var(--openapi-card-background-color)",
+                  borderRadius: "var(--openapi-card-border-radius)",
+                }}
+              >
+                <span>type: {auth.type}</span>
+              </pre>
+            </React.Fragment>
+          );
+        }
+
         return null;
       })}
     </div>

package/lib-next/theme/ApiDemoPanel/buildPostmanRequest.js

@@ -5,7 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 import sdk from "@paloaltonetworks/postman-collection";
-// @ts-ignore
 import cloneDeep from "lodash/cloneDeep";
 
 function setQueryParams(postman, queryParams) {
@@ -252,6 +251,10 @@ function buildPostmanRequest(
       const { token } = auth.data[a.key];
 
       if (token === undefined) {
+        otherHeaders.push({
+          key: "Authorization",
+          value: "Bearer <TOKEN>",
+        });
         continue;
       }
 
@@ -282,7 +285,7 @@ function buildPostmanRequest(
       if (apikey === undefined) {
         otherHeaders.push({
           key: a.name,
-          value: "API_KEY_VALUE",
+          value: "<API_KEY_VALUE>",
         });
         continue;
       }

package/lib-next/theme/ApiDemoPanel/index.js

@@ -5,11 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 import React from "react";
-import useDocusaurusContext from "@docusaurus/useDocusaurusContext"; // @ts-ignore
-// @ts-ignore
-
-import sdk from "@paloaltonetworks/postman-collection"; // @ts-ignore
-
+import useDocusaurusContext from "@docusaurus/useDocusaurusContext";
+import sdk from "@paloaltonetworks/postman-collection";
 import { Provider } from "react-redux";
 import Accept from "./Accept";
 import { createAuth } from "./Authorization/slice";
@@ -31,7 +28,7 @@ function ApiDemoPanel({ item }) {
   const postman = new sdk.Request(item.postman);
   const acceptArray = Array.from(
     new Set(
-      Object.values(item.responses ?? {}) // @ts-ignore
+      Object.values(item.responses ?? {})
         .map((response) => Object.keys(response.content ?? {}))
         .flat()
     )
@@ -46,8 +43,9 @@ function ApiDemoPanel({ item }) {
     cookie: [],
   };
   item.parameters?.forEach((param) => {
-    // @ts-ignore
-    params[param.in].push(param);
+    const paramType = param.in;
+    const paramsArray = params[paramType];
+    paramsArray.push(param);
   });
   const auth = createAuth({
     security: item.security,

package/lib-next/theme/ApiItem/index.js

@@ -127,21 +127,11 @@ function DocItemContent(props) {
                 </div>
               </MDXContent>
             </div>
-            <div
-              className={clsx(
-                "col",
-                api ? "col--7" : !canRenderTOC ? "col--9" : "col--12"
-              )}
-            >
+            <div className={clsx("col", api ? "col--7" : "col--12")}>
               <DocItemFooter {...props} />
             </div>
           </article>
-          <div
-            className={clsx(
-              "col",
-              api ? "col--7" : !canRenderTOC ? "col--9" : "col--12"
-            )}
-          >
+          <div className={clsx("col", api ? "col--7" : "col--12")}>
             <DocPaginator previous={metadata.previous} next={metadata.next} />
           </div>
         </div>

package/lib-next/theme/ApiItem/styles.module.css

@@ -1,5 +1,9 @@
 :root {
   --openapi-required: var(--ifm-color-danger);
+  --openapi-code-blue: var(--ifm-color-info);
+  --openapi-code-red: var(--ifm-color-danger);
+  --openapi-code-orange: var(--ifm-color-warning);
+  --openapi-code-green: var(--ifm-color-success);
 }
 
 .apiItemContainer article > *:first-child,
@@ -75,9 +79,9 @@
   font-size: 14px;
 }
 
-:global(.theme-api-markdown h2) {
+/* :global(.theme-api-markdown h2) {
   font-size: 2rem;
-}
+} */
 
 :global(.schemaItem) {
   list-style: none;

package/{src/theme/Tabs → lib-next/theme/ApiTabs}/index.js

@@ -29,7 +29,7 @@ function isTabItem(comp) {
   return typeof comp.props.value !== "undefined";
 }
 
-function ResponseCodeTabs(props) {
+function ApiTabsComponent(props) {
   const {
     lazy,
     block,
@@ -246,10 +246,10 @@ function ResponseCodeTabs(props) {
   );
 }
 
-export default function Tabs(props) {
+export default function ApiTabs(props) {
   const isBrowser = useIsBrowser();
   return (
-    <ResponseCodeTabs // Remount tabs after hydration
+    <ApiTabsComponent // Remount tabs after hydration
       // Temporary fix for https://github.com/facebook/docusaurus/issues/5653
       key={String(isBrowser)}
       {...props}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docusaurus-theme-openapi-docs",
   "description": "OpenAPI theme for Docusaurus.",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "license": "MIT",
   "keywords": [
     "openapi",
@@ -38,7 +38,6 @@
     "@types/fs-extra": "^9.0.13",
     "@types/lodash": "^4.14.176",
     "@types/mdx-js__react": "^1.5.4",
-    "@types/postman-collection": "^3.5.7",
     "@types/rtlcss": "^3.1.1",
     "concurrently": "^5.2.0"
   },
@@ -52,7 +51,7 @@
     "buffer": "^6.0.3",
     "clsx": "^1.1.1",
     "crypto-js": "^4.1.1",
-    "docusaurus-plugin-openapi-docs": "^1.0.1",
+    "docusaurus-plugin-openapi-docs": "^1.0.2",
     "immer": "^9.0.7",
     "lodash": "^4.17.20",
     "monaco-editor": "^0.31.1",
@@ -71,5 +70,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "27f594d26440ffe6f890b35c79847e065a96723e"
+  "gitHead": "526f2d10bc187bc7095ac70d5b1453b9b92c114f"
 }

package/src/postman-code-generators.d.ts

@@ -0,0 +1,9 @@
+/* ============================================================================
+ * 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.
+ * ========================================================================== */
+
+// TODO: Remove this when https://github.com/facebook/docusaurus/issues/6087 is resolved.
+declare module "@paloaltonetworks/postman-code-generators";

package/src/react-magic-dropzone.d.ts

@@ -0,0 +1,9 @@
+/* ============================================================================
+ * 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.
+ * ========================================================================== */
+
+// TODO: Remove this when https://github.com/facebook/docusaurus/issues/6087 is resolved.
+declare module "react-magic-dropzone";

package/src/theme/ApiDemoPanel/Curl/index.tsx

@@ -8,9 +8,7 @@
 import React, { useRef, useState, useEffect } from "react";
 
 import useDocusaurusContext from "@docusaurus/useDocusaurusContext";
-// @ts-ignore
 import codegen from "@paloaltonetworks/postman-code-generators";
-// @ts-ignore
 import sdk from "@paloaltonetworks/postman-collection";
 import clsx from "clsx";
 import Highlight, { defaultProps } from "prism-react-renderer";

package/src/theme/ApiDemoPanel/FormFileUpload/index.tsx

@@ -7,7 +7,6 @@
 
 import React, { useState } from "react";
 
-// @ts-ignore
 import MagicDropzone from "react-magic-dropzone";
 
 import FloatingButton from "../FloatingButton";

package/src/theme/ApiDemoPanel/SecuritySchemes/index.tsx

@@ -20,10 +20,15 @@ function SecuritySchemes() {
   return (
     <div style={{ marginBottom: "var(--ifm-table-cell-padding)" }}>
       {selectedAuth.map((auth) => {
-        if (auth.type === "apiKey") {
+        const isApiKey = auth.type === "apiKey";
+        const isBearer = auth.type === "http" && auth.key === "Bearer";
+        const isClientCredentials =
+          auth.type === "oauth2" && auth.key === "ClientCredentials";
+
+        if (isApiKey || isBearer) {
           return (
-            <React.Fragment key={selected + "-apiKey"}>
-              <b>Authorization: {auth.name}</b>
+            <React.Fragment key={selected}>
+              <b>Authorization: {auth.key}</b>
               <pre
                 style={{
                   display: "flex",
@@ -40,6 +45,24 @@ function SecuritySchemes() {
           );
         }
 
+        if (isClientCredentials) {
+          return (
+            <React.Fragment key={selected}>
+              <b>Authorization: {auth.key}</b>
+              <pre
+                style={{
+                  display: "flex",
+                  flexDirection: "column",
+                  background: "var(--openapi-card-background-color)",
+                  borderRadius: "var(--openapi-card-border-radius)",
+                }}
+              >
+                <span>type: {auth.type}</span>
+              </pre>
+            </React.Fragment>
+          );
+        }
+
         return null;
       })}
     </div>

package/src/theme/ApiDemoPanel/buildPostmanRequest.ts

@@ -9,9 +9,7 @@ import sdk from "@paloaltonetworks/postman-collection";
 import {
   ParameterObject,
   ServerObject,
-  // @ts-ignore
 } from "docusaurus-plugin-openapi-docs/src/openapi/types";
-// @ts-ignore
 import cloneDeep from "lodash/cloneDeep";
 
 import { AuthState, Scheme } from "./Authorization/slice";
@@ -250,6 +248,10 @@ function buildPostmanRequest(
     if (a.type === "http" && a.scheme === "bearer") {
       const { token } = auth.data[a.key];
       if (token === undefined) {
+        otherHeaders.push({
+          key: "Authorization",
+          value: "Bearer <TOKEN>",
+        });
         continue;
       }
       otherHeaders.push({
@@ -278,7 +280,7 @@ function buildPostmanRequest(
       if (apikey === undefined) {
         otherHeaders.push({
           key: a.name,
-          value: "API_KEY_VALUE",
+          value: "<API_KEY_VALUE>",
         });
         continue;
       }

package/src/theme/ApiDemoPanel/index.tsx

@@ -8,12 +8,9 @@
 import React from "react";
 
 import useDocusaurusContext from "@docusaurus/useDocusaurusContext";
-// @ts-ignore
-// @ts-ignore
 import sdk from "@paloaltonetworks/postman-collection";
-// @ts-ignore
-import { Metadata } from "@theme/ApiItem";
 import { ParameterObject } from "docusaurus-plugin-openapi-docs/src/openapi/types";
+import { ApiItem } from "docusaurus-plugin-openapi-docs/src/types";
 import { Provider } from "react-redux";
 
 import { ThemeConfig } from "../../types";
@@ -30,7 +27,7 @@ import Server from "./Server";
 import { createStoreWithState } from "./store";
 import styles from "./styles.module.css";
 
-function ApiDemoPanel({ item }: { item: NonNullable<Metadata["api"]> }) {
+function ApiDemoPanel({ item }: { item: NonNullable<ApiItem> }) {
   const { siteConfig } = useDocusaurusContext();
   const themeConfig = siteConfig.themeConfig as ThemeConfig;
   const options = themeConfig.api;
@@ -39,8 +36,7 @@ function ApiDemoPanel({ item }: { item: NonNullable<Metadata["api"]> }) {
   const acceptArray = Array.from(
     new Set(
       Object.values(item.responses ?? {})
-        // @ts-ignore
-        .map((response) => Object.keys(response.content ?? {}))
+        .map((response: any) => Object.keys(response.content ?? {}))
         .flat()
     )
   );
@@ -58,10 +54,13 @@ function ApiDemoPanel({ item }: { item: NonNullable<Metadata["api"]> }) {
     cookie: [] as ParameterObject[],
   };
 
-  item.parameters?.forEach((param: { in: string | number }) => {
-    // @ts-ignore
-    params[param.in].push(param);
-  });
+  item.parameters?.forEach(
+    (param: { in: "path" | "query" | "header" | "cookie" }) => {
+      const paramType = param.in;
+      const paramsArray: ParameterObject[] = params[paramType];
+      paramsArray.push(param as ParameterObject);
+    }
+  );
 
   const auth = createAuth({
     security: item.security,

package/src/theme/ApiItem/index.tsx

@@ -127,21 +127,11 @@ function DocItemContent(props: Props): JSX.Element {
                 </div>
               </MDXContent>
             </div>
-            <div
-              className={clsx(
-                "col",
-                api ? "col--7" : !canRenderTOC ? "col--9" : "col--12"
-              )}
-            >
+            <div className={clsx("col", api ? "col--7" : "col--12")}>
               <DocItemFooter {...props} />
             </div>
           </article>
-          <div
-            className={clsx(
-              "col",
-              api ? "col--7" : !canRenderTOC ? "col--9" : "col--12"
-            )}
-          >
+          <div className={clsx("col", api ? "col--7" : "col--12")}>
             <DocPaginator previous={metadata.previous} next={metadata.next} />
           </div>
         </div>