@camunda8/docusaurus-theme-openapi-docs 4.5.1

package/lib/theme/ApiExplorer/Authorization/index.js

@@ -0,0 +1,201 @@
+"use strict";
+/* ============================================================================
+ * 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.
+ * ========================================================================== */
+var __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importDefault(require("react"));
+const Translate_1 = require("@docusaurus/Translate");
+const FormItem_1 = __importDefault(require("@theme/ApiExplorer/FormItem"));
+const FormSelect_1 = __importDefault(require("@theme/ApiExplorer/FormSelect"));
+const FormTextInput_1 = __importDefault(
+  require("@theme/ApiExplorer/FormTextInput")
+);
+const hooks_1 = require("@theme/ApiItem/hooks");
+const translationIds_1 = require("@theme/translationIds");
+const slice_1 = require("./slice");
+function Authorization() {
+  const data = (0, hooks_1.useTypedSelector)((state) => state.auth.data);
+  const options = (0, hooks_1.useTypedSelector)((state) => state.auth.options);
+  const selected = (0, hooks_1.useTypedSelector)(
+    (state) => state.auth.selected
+  );
+  const dispatch = (0, hooks_1.useTypedDispatch)();
+  if (selected === undefined) {
+    return null;
+  }
+  const selectedAuth = options[selected];
+  const optionKeys = Object.keys(options);
+  return react_1.default.createElement(
+    "div",
+    null,
+    optionKeys.length > 1 &&
+      react_1.default.createElement(
+        FormItem_1.default,
+        {
+          label: (0, Translate_1.translate)({
+            id: translationIds_1.OPENAPI_AUTH.SECURITY_SCHEME,
+            message: "Security Scheme",
+          }),
+        },
+        react_1.default.createElement(FormSelect_1.default, {
+          options: optionKeys,
+          value: selected,
+          onChange: (e) => {
+            dispatch((0, slice_1.setSelectedAuth)(e.target.value));
+          },
+        })
+      ),
+    selectedAuth.map((a) => {
+      if (a.type === "http" && a.scheme === "bearer") {
+        return react_1.default.createElement(
+          FormItem_1.default,
+          {
+            label: (0, Translate_1.translate)({
+              id: translationIds_1.OPENAPI_AUTH.BEARER_TOKEN,
+              message: "Bearer Token",
+            }),
+            key: a.key + "-bearer",
+          },
+          react_1.default.createElement(FormTextInput_1.default, {
+            placeholder: (0, Translate_1.translate)({
+              id: translationIds_1.OPENAPI_AUTH.BEARER_TOKEN,
+              message: "Bearer Token",
+            }),
+            password: true,
+            value: data[a.key].token ?? "",
+            onChange: (e) => {
+              const value = e.target.value;
+              dispatch(
+                (0, slice_1.setAuthData)({
+                  scheme: a.key,
+                  key: "token",
+                  value: value ? value : undefined,
+                })
+              );
+            },
+          })
+        );
+      }
+      if (a.type === "oauth2") {
+        return react_1.default.createElement(
+          FormItem_1.default,
+          {
+            label: (0, Translate_1.translate)({
+              id: translationIds_1.OPENAPI_AUTH.BEARER_TOKEN,
+              message: "Bearer Token",
+            }),
+            key: a.key + "-oauth2",
+          },
+          react_1.default.createElement(FormTextInput_1.default, {
+            placeholder: (0, Translate_1.translate)({
+              id: translationIds_1.OPENAPI_AUTH.BEARER_TOKEN,
+              message: "Bearer Token",
+            }),
+            password: true,
+            value: data[a.key].token ?? "",
+            onChange: (e) => {
+              const value = e.target.value;
+              dispatch(
+                (0, slice_1.setAuthData)({
+                  scheme: a.key,
+                  key: "token",
+                  value: value ? value : undefined,
+                })
+              );
+            },
+          })
+        );
+      }
+      if (a.type === "http" && a.scheme === "basic") {
+        return react_1.default.createElement(
+          react_1.default.Fragment,
+          { key: a.key + "-basic" },
+          react_1.default.createElement(
+            FormItem_1.default,
+            {
+              label: (0, Translate_1.translate)({
+                id: translationIds_1.OPENAPI_AUTH.USERNAME,
+                message: "Username",
+              }),
+            },
+            react_1.default.createElement(FormTextInput_1.default, {
+              placeholder: (0, Translate_1.translate)({
+                id: translationIds_1.OPENAPI_AUTH.USERNAME,
+                message: "Username",
+              }),
+              value: data[a.key].username ?? "",
+              onChange: (e) => {
+                const value = e.target.value;
+                dispatch(
+                  (0, slice_1.setAuthData)({
+                    scheme: a.key,
+                    key: "username",
+                    value: value ? value : undefined,
+                  })
+                );
+              },
+            })
+          ),
+          react_1.default.createElement(
+            FormItem_1.default,
+            {
+              label: (0, Translate_1.translate)({
+                id: translationIds_1.OPENAPI_AUTH.PASSWORD,
+                message: "Password",
+              }),
+            },
+            react_1.default.createElement(FormTextInput_1.default, {
+              placeholder: (0, Translate_1.translate)({
+                id: translationIds_1.OPENAPI_AUTH.PASSWORD,
+                message: "Password",
+              }),
+              password: true,
+              value: data[a.key].password ?? "",
+              onChange: (e) => {
+                const value = e.target.value;
+                dispatch(
+                  (0, slice_1.setAuthData)({
+                    scheme: a.key,
+                    key: "password",
+                    value: value ? value : undefined,
+                  })
+                );
+              },
+            })
+          )
+        );
+      }
+      if (a.type === "apiKey") {
+        return react_1.default.createElement(
+          FormItem_1.default,
+          { label: `${a.key}`, key: a.key + "-apikey" },
+          react_1.default.createElement(FormTextInput_1.default, {
+            placeholder: `${a.key}`,
+            password: true,
+            value: data[a.key].apiKey ?? "",
+            onChange: (e) => {
+              const value = e.target.value;
+              dispatch(
+                (0, slice_1.setAuthData)({
+                  scheme: a.key,
+                  key: "apiKey",
+                  value: value ? value : undefined,
+                })
+              );
+            },
+          })
+        );
+      }
+      return null;
+    })
+  );
+}
+exports.default = Authorization;

package/lib/theme/ApiExplorer/Authorization/slice.d.ts

@@ -0,0 +1,40 @@
+import { PayloadAction } from "@reduxjs/toolkit";
+import { SecurityRequirementObject, SecuritySchemeObject } from "@camunda8/docusaurus-plugin-openapi-docs/src/openapi/types";
+import { ThemeConfig } from "@camunda8/docusaurus-theme-openapi-docs/src/types";
+export declare function createAuth({ security, securitySchemes, options: opts, }: {
+    security?: SecurityRequirementObject[];
+    securitySchemes?: {
+        [key: string]: SecuritySchemeObject;
+    };
+    options?: ThemeConfig["api"];
+}): AuthState;
+export type Scheme = {
+    key: string;
+    scopes: string[];
+} & SecuritySchemeObject;
+export interface AuthState {
+    data: {
+        [scheme: string]: {
+            [key: string]: string | undefined;
+        };
+    };
+    options: {
+        [key: string]: Scheme[];
+    };
+    selected?: string;
+}
+export declare const slice: import("@reduxjs/toolkit").Slice<AuthState, {
+    setAuthData: (state: import("immer").WritableDraft<AuthState>, action: PayloadAction<{
+        scheme: string;
+        key: string;
+        value?: string;
+    }>) => void;
+    setSelectedAuth: (state: import("immer").WritableDraft<AuthState>, action: PayloadAction<string>) => void;
+}, "auth", "auth", import("@reduxjs/toolkit").SliceSelectors<AuthState>>;
+export declare const setAuthData: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    scheme: string;
+    key: string;
+    value?: string;
+}, "auth/setAuthData">, setSelectedAuth: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "auth/setSelectedAuth">;
+declare const _default: import("redux").Reducer<AuthState>;
+export default _default;

package/lib/theme/ApiExplorer/Authorization/slice.js

@@ -0,0 +1,102 @@
+"use strict";
+/* ============================================================================
+ * 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.
+ * ========================================================================== */
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setSelectedAuth = exports.setAuthData = exports.slice = void 0;
+exports.createAuth = createAuth;
+const toolkit_1 = require("@reduxjs/toolkit");
+const storage_utils_1 = require("@theme/ApiExplorer/storage-utils");
+const auth_types_1 = require("./auth-types");
+// The global definitions
+// "securitySchemes": {
+//   "BearerAuth": { "type": "http", "scheme": "BeAreR" },
+//   "BasicAuth": { "type": "http", "scheme": "basic" }
+// },
+// The operation level requirements
+// "security": [
+//   { "BearerAuth": [] },
+//   { "BearerAuth": [], "BasicAuth": [] }
+// ],
+// SLICE_STATE
+// data:
+//   BearerAuth:
+//     token=xxx
+//   BasicAuth:
+//     username=xxx
+//     password=xxx
+//
+// options:
+//    "BearerAuth": [{ key: "BearerAuth", scopes: [], ...rest }]
+//    "BearerAuth and BasicAuth": [{ key: "BearerAuth", scopes: [], ...rest }, { key: "BasicAuth", scopes: [], ...rest }]
+//
+// selected: "BearerAuth and BasicAuth"
+// LOCAL_STORAGE
+// hash(SLICE_STATE.options) -> "BearerAuth and BasicAuth"
+// BearerAuth                -> { token: xxx }
+// BasicAuth                 -> { username: xxx, password: xxx }
+function createAuth({ security, securitySchemes, options: opts }) {
+  const storage = (0, storage_utils_1.createStorage)("sessionStorage");
+  let data = {};
+  let options = {};
+  for (const option of security ?? []) {
+    const id = Object.keys(option).join(" and ");
+    for (const [schemeID, scopes] of Object.entries(option)) {
+      const scheme = securitySchemes?.[schemeID];
+      if (scheme) {
+        if (options[id] === undefined) {
+          options[id] = [];
+        }
+        const dataKeys = (0, auth_types_1.getAuthDataKeys)(scheme);
+        for (const key of dataKeys) {
+          if (data[schemeID] === undefined) {
+            data[schemeID] = {};
+          }
+          let persisted = undefined;
+          try {
+            persisted = JSON.parse(storage.getItem(schemeID) ?? "")[key];
+          } catch {}
+          data[schemeID][key] = persisted;
+        }
+        options[id].push({
+          ...scheme,
+          key: schemeID,
+          scopes,
+        });
+      }
+    }
+  }
+  let persisted = undefined;
+  try {
+    persisted =
+      storage.getItem((0, storage_utils_1.hashArray)(Object.keys(options))) ??
+      undefined;
+  } catch {}
+  return {
+    data,
+    options,
+    selected: persisted ?? Object.keys(options)[0],
+  };
+}
+const initialState = {};
+exports.slice = (0, toolkit_1.createSlice)({
+  name: "auth",
+  initialState,
+  reducers: {
+    setAuthData: (state, action) => {
+      const { scheme, key, value } = action.payload;
+      state.data[scheme][key] = value;
+    },
+    setSelectedAuth: (state, action) => {
+      state.selected = action.payload;
+    },
+  },
+});
+((_a = exports.slice.actions),
+  (exports.setAuthData = _a.setAuthData),
+  (exports.setSelectedAuth = _a.setSelectedAuth));
+exports.default = exports.slice.reducer;

package/lib/theme/ApiExplorer/Body/index.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+import { RequestBodyObject } from "@camunda8/docusaurus-plugin-openapi-docs/src/openapi/types";
+export interface Props {
+    jsonRequestBodyExample: string;
+    requestBodyMetadata?: RequestBodyObject;
+    methods?: any;
+    required?: boolean;
+}
+declare function BodyWrap({ requestBodyMetadata, jsonRequestBodyExample, methods, required, }: Props): React.JSX.Element | null;
+export default BodyWrap;