docusaurus-plugin-openapi-docs 0.0.0-350 → 0.0.0-351

package/lib/markdown/createContactInfo.d.ts

@@ -0,0 +1,2 @@
+import { ContactObject } from "../openapi/types";
+export declare function createContactInfo(contact: ContactObject): string;

package/lib/markdown/createContactInfo.js

@@ -0,0 +1,49 @@
+"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.
+ * ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContactInfo = void 0;
+const utils_1 = require("./utils");
+function createContactInfo(contact) {
+    if (!contact)
+        return "";
+    const { name, url, email } = contact;
+    return (0, utils_1.create)("div", {
+        style: {
+            display: "flex",
+            flexDirection: "column",
+            marginBottom: "var(--ifm-paragraph-margin-bottom)",
+        },
+        children: [
+            (0, utils_1.create)("h3", {
+                style: {
+                    marginBottom: "0.25rem",
+                },
+                children: "Contact",
+            }),
+            (0, utils_1.create)("span", {
+                children: [
+                    `${name}: `,
+                    (0, utils_1.create)("a", {
+                        href: `mailto:${email}`,
+                        children: `${email}`,
+                    }),
+                ],
+            }),
+            (0, utils_1.create)("span", {
+                children: [
+                    "URL: ",
+                    (0, utils_1.create)("a", {
+                        href: `${url}`,
+                        children: `${url}`,
+                    }),
+                ],
+            }),
+        ],
+    });
+}
+exports.createContactInfo = createContactInfo;

package/lib/markdown/createLicense.d.ts

@@ -0,0 +1,2 @@
+import { LicenseObject } from "../openapi/types";
+export declare function createLicense(license: LicenseObject): string;

package/lib/markdown/createLicense.js

@@ -0,0 +1,33 @@
+"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.
+ * ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLicense = void 0;
+const utils_1 = require("./utils");
+function createLicense(license) {
+    if (!license)
+        return "";
+    const { name, url } = license;
+    return (0, utils_1.create)("div", {
+        style: {
+            marginBottom: "var(--ifm-paragraph-margin-bottom)",
+        },
+        children: [
+            (0, utils_1.create)("h3", {
+                style: {
+                    marginBottom: "0.25rem",
+                },
+                children: "License",
+            }),
+            (0, utils_1.create)("a", {
+                href: url,
+                children: name,
+            }),
+        ],
+    });
+}
+exports.createLicense = createLicense;

package/lib/markdown/createTermsOfService.d.ts

@@ -0,0 +1 @@
+export declare function createTermsOfService(termsOfService: string | undefined): string;

package/lib/markdown/createTermsOfService.js

@@ -0,0 +1,32 @@
+"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.
+ * ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTermsOfService = void 0;
+const utils_1 = require("./utils");
+function createTermsOfService(termsOfService) {
+    if (!createTermsOfService)
+        return "";
+    return (0, utils_1.create)("div", {
+        style: {
+            marginBottom: "var(--ifm-paragraph-margin-bottom)",
+        },
+        children: [
+            (0, utils_1.create)("h3", {
+                style: {
+                    marginBottom: "0.25rem",
+                },
+                children: "Terms of Service",
+            }),
+            (0, utils_1.create)("a", {
+                href: `${termsOfService}`,
+                children: termsOfService,
+            }),
+        ],
+    });
+}
+exports.createTermsOfService = createTermsOfService;

package/lib/markdown/index.d.ts

@@ -1,3 +1,3 @@
 import { ApiPageMetadata, InfoPageMetadata } from "../types";
 export declare function createApiPageMD({ title, api: { deprecated, "x-deprecated-description": deprecatedDescription, description, parameters, requestBody, responses, }, }: ApiPageMetadata): string;
-export declare function createInfoPageMD({ info: { title, version, description }, }: InfoPageMetadata): string;
+export declare function createInfoPageMD({ info: { title, version, description, contact, license, termsOfService }, }: InfoPageMetadata): string;

package/lib/markdown/index.js

@@ -8,11 +8,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createInfoPageMD = exports.createApiPageMD = void 0;
 const lodash_1 = require("lodash");
+const createContactInfo_1 = require("./createContactInfo");
 const createDeprecationNotice_1 = require("./createDeprecationNotice");
 const createDescription_1 = require("./createDescription");
+const createLicense_1 = require("./createLicense");
 const createParamsDetails_1 = require("./createParamsDetails");
 const createRequestBodyDetails_1 = require("./createRequestBodyDetails");
 const createStatusCodes_1 = require("./createStatusCodes");
+const createTermsOfService_1 = require("./createTermsOfService");
 const createVersionBadge_1 = require("./createVersionBadge");
 const utils_1 = require("./utils");
 function createApiPageMD({ title, api: { deprecated, "x-deprecated-description": deprecatedDescription, description, parameters, requestBody, responses, }, }) {
@@ -33,11 +36,14 @@ function createApiPageMD({ title, api: { deprecated, "x-deprecated-description":
     ]);
 }
 exports.createApiPageMD = createApiPageMD;
-function createInfoPageMD({ info: { title, version, description }, }) {
+function createInfoPageMD({ info: { title, version, description, contact, license, termsOfService }, }) {
     return (0, utils_1.render)([
         (0, createVersionBadge_1.createVersionBadge)(version),
         `# ${(0, lodash_1.escape)(title)}\n\n`,
         (0, createDescription_1.createDescription)(description),
+        (0, createContactInfo_1.createContactInfo)(contact),
+        (0, createTermsOfService_1.createTermsOfService)(termsOfService),
+        (0, createLicense_1.createLicense)(license),
     ]);
 }
 exports.createInfoPageMD = createInfoPageMD;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docusaurus-plugin-openapi-docs",
   "description": "OpenAPI plugin for Docusaurus.",
-  "version": "0.0.0-350",
+  "version": "0.0.0-351",
   "license": "MIT",
   "keywords": [
     "openapi",
@@ -60,5 +60,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "c66039acf120aeef0024c18d5ca0d842f38b32a6"
+  "gitHead": "475483bcb20b232da5c12ee23c48855dd32ba0d8"
 }

package/src/markdown/createContactInfo.ts

@@ -0,0 +1,48 @@
+/* ============================================================================
+ * 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 { ContactObject } from "../openapi/types";
+import { create } from "./utils";
+
+export function createContactInfo(contact: ContactObject) {
+  if (!contact) return "";
+  const { name, url, email } = contact;
+
+  return create("div", {
+    style: {
+      display: "flex",
+      flexDirection: "column",
+      marginBottom: "var(--ifm-paragraph-margin-bottom)",
+    },
+    children: [
+      create("h3", {
+        style: {
+          marginBottom: "0.25rem",
+        },
+        children: "Contact",
+      }),
+      create("span", {
+        children: [
+          `${name}: `,
+          create("a", {
+            href: `mailto:${email}`,
+            children: `${email}`,
+          }),
+        ],
+      }),
+      create("span", {
+        children: [
+          "URL: ",
+          create("a", {
+            href: `${url}`,
+            children: `${url}`,
+          }),
+        ],
+      }),
+    ],
+  });
+}

package/src/markdown/createLicense.ts

@@ -0,0 +1,32 @@
+/* ============================================================================
+ * 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 { LicenseObject } from "../openapi/types";
+import { create } from "./utils";
+
+export function createLicense(license: LicenseObject) {
+  if (!license) return "";
+  const { name, url } = license;
+
+  return create("div", {
+    style: {
+      marginBottom: "var(--ifm-paragraph-margin-bottom)",
+    },
+    children: [
+      create("h3", {
+        style: {
+          marginBottom: "0.25rem",
+        },
+        children: "License",
+      }),
+      create("a", {
+        href: url,
+        children: name,
+      }),
+    ],
+  });
+}

package/src/markdown/createTermsOfService.ts

@@ -0,0 +1,30 @@
+/* ============================================================================
+ * 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 { create } from "./utils";
+
+export function createTermsOfService(termsOfService: string | undefined) {
+  if (!createTermsOfService) return "";
+
+  return create("div", {
+    style: {
+      marginBottom: "var(--ifm-paragraph-margin-bottom)",
+    },
+    children: [
+      create("h3", {
+        style: {
+          marginBottom: "0.25rem",
+        },
+        children: "Terms of Service",
+      }),
+      create("a", {
+        href: `${termsOfService}`,
+        children: termsOfService,
+      }),
+    ],
+  });
+}

package/src/markdown/index.ts

@@ -7,12 +7,16 @@
 
 import { escape } from "lodash";
 
+import { ContactObject, LicenseObject } from "../openapi/types";
 import { ApiPageMetadata, InfoPageMetadata } from "../types";
+import { createContactInfo } from "./createContactInfo";
 import { createDeprecationNotice } from "./createDeprecationNotice";
 import { createDescription } from "./createDescription";
+import { createLicense } from "./createLicense";
 import { createParamsDetails } from "./createParamsDetails";
 import { createRequestBodyDetails } from "./createRequestBodyDetails";
 import { createStatusCodes } from "./createStatusCodes";
+import { createTermsOfService } from "./createTermsOfService";
 import { createVersionBadge } from "./createVersionBadge";
 import { render } from "./utils";
 
@@ -45,11 +49,14 @@ export function createApiPageMD({
 }
 
 export function createInfoPageMD({
-  info: { title, version, description },
+  info: { title, version, description, contact, license, termsOfService },
 }: InfoPageMetadata) {
   return render([
     createVersionBadge(version),
     `# ${escape(title)}\n\n`,
     createDescription(description),
+    createContactInfo(contact as ContactObject),
+    createTermsOfService(termsOfService),
+    createLicense(license as LicenseObject),
   ]);
 }

package/lib/markdown/createFullWidthTable.d.ts

@@ -1,2 +0,0 @@
-import { Props } from "./utils";
-export declare function createFullWidthTable({ children, style, ...rest }: Props): string;

package/lib/markdown/createFullWidthTable.js

@@ -1,18 +0,0 @@
-"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.
- * ========================================================================== */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createFullWidthTable = void 0;
-const utils_1 = require("./utils");
-function createFullWidthTable({ children, style, ...rest }) {
-    return (0, utils_1.create)("table", {
-        style: { display: "table", width: "100%", ...style },
-        ...rest,
-        children,
-    });
-}
-exports.createFullWidthTable = createFullWidthTable;

package/lib/markdown/createParamsTable.d.ts

@@ -1,7 +0,0 @@
-import { ApiItem } from "../types";
-interface Props {
-    parameters: ApiItem["parameters"];
-    type: "path" | "query" | "header" | "cookie";
-}
-export declare function createParamsTable({ parameters, type }: Props): string | undefined;
-export {};

package/lib/markdown/createParamsTable.js

@@ -1,80 +0,0 @@
-"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.
- * ========================================================================== */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createParamsTable = void 0;
-const lodash_1 = require("lodash");
-const createDescription_1 = require("./createDescription");
-const createFullWidthTable_1 = require("./createFullWidthTable");
-const schema_1 = require("./schema");
-const utils_1 = require("./utils");
-function createParamsTable({ parameters, type }) {
-    if (parameters === undefined) {
-        return undefined;
-    }
-    const params = parameters.filter((param) => (param === null || param === void 0 ? void 0 : param.in) === type);
-    if (params.length === 0) {
-        return undefined;
-    }
-    return (0, createFullWidthTable_1.createFullWidthTable)({
-        children: [
-            (0, utils_1.create)("thead", {
-                children: (0, utils_1.create)("tr", {
-                    children: (0, utils_1.create)("th", {
-                        style: { textAlign: "left" },
-                        children: `${type.charAt(0).toUpperCase() + type.slice(1)} Parameters`,
-                    }),
-                }),
-            }),
-            (0, utils_1.create)("tbody", {
-                children: params.map((param) => (0, utils_1.create)("tr", {
-                    children: (0, utils_1.create)("td", {
-                        children: [
-                            (0, utils_1.create)("code", { children: param.name }),
-                            (0, utils_1.guard)(param.schema, (schema) => (0, utils_1.create)("span", {
-                                style: { opacity: "0.6" },
-                                children: ` ${(0, schema_1.getSchemaName)(schema)}`,
-                            })),
-                            (0, utils_1.guard)(param.required, () => [
-                                (0, utils_1.create)("span", {
-                                    style: { opacity: "0.6" },
-                                    children: " — ",
-                                }),
-                                (0, utils_1.create)("strong", {
-                                    style: {
-                                        fontSize: "var(--ifm-code-font-size)",
-                                        color: "var(--openapi-required)",
-                                    },
-                                    children: " REQUIRED",
-                                }),
-                            ]),
-                            (0, utils_1.guard)((0, schema_1.getQualifierMessage)(param.schema), (message) => (0, utils_1.create)("div", {
-                                style: { marginTop: "var(--ifm-table-cell-padding)" },
-                                children: (0, createDescription_1.createDescription)(message),
-                            })),
-                            (0, utils_1.guard)(param.description, (description) => (0, utils_1.create)("div", {
-                                style: { marginTop: "var(--ifm-table-cell-padding)" },
-                                children: (0, createDescription_1.createDescription)(description),
-                            })),
-                            (0, utils_1.guard)(param.example, (example) => (0, utils_1.create)("div", {
-                                style: { marginTop: "var(--ifm-table-cell-padding)" },
-                                children: (0, lodash_1.escape)(`Example: ${example}`),
-                            })),
-                            (0, utils_1.guard)(param.examples, (examples) => (0, utils_1.create)("div", {
-                                style: { marginTop: "var(--ifm-table-cell-padding)" },
-                                children: Object.entries(examples).map(([k, v]) => (0, utils_1.create)("div", {
-                                    children: (0, lodash_1.escape)(`Example (${k}): ${v.value}`),
-                                })),
-                            })),
-                        ],
-                    }),
-                })),
-            }),
-        ],
-    });
-}
-exports.createParamsTable = createParamsTable;

package/lib/markdown/createRequestBodyTable.d.ts

@@ -1,6 +0,0 @@
-interface Props {
-    title: string;
-    body: any;
-}
-export declare function createRequestBodyTable({ title, body }: Props): string | undefined;
-export {};

package/lib/markdown/createRequestBodyTable.js

@@ -1,14 +0,0 @@
-"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.
- * ========================================================================== */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createRequestBodyTable = void 0;
-const createSchemaTable_1 = require("./createSchemaTable");
-function createRequestBodyTable({ title, body }) {
-    return (0, createSchemaTable_1.createSchemaTable)({ title, body });
-}
-exports.createRequestBodyTable = createRequestBodyTable;

package/lib/markdown/createSchemaTable.d.ts

@@ -1,14 +0,0 @@
-import { MediaTypeObject } from "../openapi/types";
-interface Props {
-    style?: any;
-    title: string;
-    body: {
-        content?: {
-            [key: string]: MediaTypeObject;
-        };
-        description?: string;
-        required?: boolean;
-    };
-}
-export declare function createSchemaTable({ title, body, ...rest }: Props): string | undefined;
-export {};

package/lib/markdown/createSchemaTable.js

@@ -1,217 +0,0 @@
-"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.
- * ========================================================================== */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSchemaTable = void 0;
-const createDescription_1 = require("./createDescription");
-const createFullWidthTable_1 = require("./createFullWidthTable");
-const schema_1 = require("./schema");
-const utils_1 = require("./utils");
-function resolveAllOf(allOf) {
-    // TODO: naive implementation (only supports objects, no directly nested allOf)
-    const properties = allOf.reduce((acc, cur) => {
-        if (cur.properties !== undefined) {
-            const next = { ...acc, ...cur.properties };
-            return next;
-        }
-        return acc;
-    }, {});
-    const required = allOf.reduce((acc, cur) => {
-        if (Array.isArray(cur.required)) {
-            const next = [...acc, ...cur.required];
-            return next;
-        }
-        return acc;
-    }, []);
-    return { properties, required };
-}
-function createRow({ name, schema, required }) {
-    return (0, utils_1.create)("tr", {
-        children: (0, utils_1.create)("td", {
-            children: [
-                (0, utils_1.create)("code", { children: name }),
-                (0, utils_1.create)("span", {
-                    style: { opacity: "0.6" },
-                    children: ` ${(0, schema_1.getSchemaName)(schema, true)}`,
-                }),
-                (0, utils_1.guard)(required, () => [
-                    (0, utils_1.create)("span", {
-                        style: { opacity: "0.6" },
-                        children: " — ",
-                    }),
-                    (0, utils_1.create)("strong", {
-                        style: {
-                            fontSize: "var(--ifm-code-font-size)",
-                            color: "var(--openapi-required)",
-                        },
-                        children: " REQUIRED",
-                    }),
-                ]),
-                (0, utils_1.guard)((0, schema_1.getQualifierMessage)(schema), (message) => (0, utils_1.create)("div", {
-                    style: { marginTop: "var(--ifm-table-cell-padding)" },
-                    children: (0, createDescription_1.createDescription)(message),
-                })),
-                (0, utils_1.guard)(schema.description, (description) => (0, utils_1.create)("div", {
-                    style: { marginTop: "var(--ifm-table-cell-padding)" },
-                    children: (0, createDescription_1.createDescription)(description),
-                })),
-                createRows({ schema: schema }),
-            ],
-        }),
-    });
-}
-function createRows({ schema }) {
-    // object
-    if (schema.properties !== undefined) {
-        return (0, createFullWidthTable_1.createFullWidthTable)({
-            style: {
-                marginTop: "var(--ifm-table-cell-padding)",
-                marginBottom: "0px",
-            },
-            children: (0, utils_1.create)("tbody", {
-                children: Object.entries(schema.properties).map(([key, val]) => createRow({
-                    name: key,
-                    schema: val,
-                    required: Array.isArray(schema.required)
-                        ? schema.required.includes(key)
-                        : false,
-                })),
-            }),
-        });
-    }
-    // TODO: This can be a bit complicated types can be missmatched and there can be nested allOfs which need to be resolved before merging properties
-    if (schema.allOf !== undefined) {
-        const { properties, required } = resolveAllOf(schema.allOf);
-        return (0, createFullWidthTable_1.createFullWidthTable)({
-            style: {
-                marginTop: "var(--ifm-table-cell-padding)",
-                marginBottom: "0px",
-            },
-            children: (0, utils_1.create)("tbody", {
-                children: Object.entries(properties).map(([key, val]) => createRow({
-                    name: key,
-                    schema: val,
-                    required: Array.isArray(required) ? required.includes(key) : false,
-                })),
-            }),
-        });
-    }
-    // array
-    if (schema.items !== undefined) {
-        return createRows({ schema: schema.items });
-    }
-    // primitive
-    return undefined;
-}
-function createRowsRoot({ schema }) {
-    // object
-    if (schema.properties !== undefined) {
-        return Object.entries(schema.properties).map(([key, val]) => createRow({
-            name: key,
-            schema: val,
-            required: Array.isArray(schema.required)
-                ? schema.required.includes(key)
-                : false,
-        }));
-    }
-    // TODO: This can be a bit complicated types can be missmatched and there can be nested allOfs which need to be resolved before merging properties
-    if (schema.allOf !== undefined) {
-        const { properties, required } = resolveAllOf(schema.allOf);
-        return Object.entries(properties).map(([key, val]) => createRow({
-            name: key,
-            schema: val,
-            required: Array.isArray(required) ? required.includes(key) : false,
-        }));
-    }
-    // array
-    if (schema.items !== undefined) {
-        return (0, utils_1.create)("tr", {
-            children: (0, utils_1.create)("td", {
-                children: [
-                    (0, utils_1.create)("span", {
-                        style: { opacity: "0.6" },
-                        children: ` ${(0, schema_1.getSchemaName)(schema, true)}`,
-                    }),
-                    createRows({ schema: schema.items }),
-                ],
-            }),
-        });
-    }
-    // primitive
-    return (0, utils_1.create)("tr", {
-        children: (0, utils_1.create)("td", {
-            children: [
-                (0, utils_1.create)("span", {
-                    style: { opacity: "0.6" },
-                    children: ` ${schema.type}`,
-                }),
-                (0, utils_1.guard)((0, schema_1.getQualifierMessage)(schema), (message) => (0, utils_1.create)("div", {
-                    style: { marginTop: "var(--ifm-table-cell-padding)" },
-                    children: (0, createDescription_1.createDescription)(message),
-                })),
-                (0, utils_1.guard)(schema.description, (description) => (0, utils_1.create)("div", {
-                    style: { marginTop: "var(--ifm-table-cell-padding)" },
-                    children: (0, createDescription_1.createDescription)(description),
-                })),
-            ],
-        }),
-    });
-}
-function createSchemaTable({ title, body, ...rest }) {
-    if (body === undefined || body.content === undefined) {
-        return undefined;
-    }
-    // TODO:
-    // NOTE: We just pick a random content-type.
-    // How common is it to have multiple?
-    const randomFirstKey = Object.keys(body.content)[0];
-    const firstBody = body.content[randomFirstKey].schema;
-    if (firstBody === undefined) {
-        return undefined;
-    }
-    // we don't show the table if there is no properties to show
-    if (firstBody.properties !== undefined) {
-        if (Object.keys(firstBody.properties).length === 0) {
-            return undefined;
-        }
-    }
-    return (0, createFullWidthTable_1.createFullWidthTable)({
-        ...rest,
-        children: [
-            (0, utils_1.create)("thead", {
-                children: (0, utils_1.create)("tr", {
-                    children: (0, utils_1.create)("th", {
-                        style: { textAlign: "left" },
-                        children: [
-                            `${title} `,
-                            (0, utils_1.guard)(body.required, () => [
-                                (0, utils_1.create)("span", {
-                                    style: { opacity: "0.6" },
-                                    children: " — ",
-                                }),
-                                (0, utils_1.create)("strong", {
-                                    style: {
-                                        fontSize: "var(--ifm-code-font-size)",
-                                        color: "var(--openapi-required)",
-                                    },
-                                    children: " REQUIRED",
-                                }),
-                            ]),
-                            (0, utils_1.create)("div", {
-                                children: (0, createDescription_1.createDescription)(body.description),
-                            }),
-                        ],
-                    }),
-                }),
-            }),
-            (0, utils_1.create)("tbody", {
-                children: createRowsRoot({ schema: firstBody }),
-            }),
-        ],
-    });
-}
-exports.createSchemaTable = createSchemaTable;

package/src/markdown/createFullWidthTable.ts

@@ -1,16 +0,0 @@
-/* ============================================================================
- * 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 { create, Props } from "./utils";
-
-export function createFullWidthTable({ children, style, ...rest }: Props) {
-  return create("table", {
-    style: { display: "table", width: "100%", ...style },
-    ...rest,
-    children,
-  });
-}

package/src/markdown/createParamsTable.ts

@@ -1,102 +0,0 @@
-/* ============================================================================
- * 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 { escape } from "lodash";
-
-import { ApiItem } from "../types";
-import { createDescription } from "./createDescription";
-import { createFullWidthTable } from "./createFullWidthTable";
-import { getQualifierMessage, getSchemaName } from "./schema";
-import { create, guard } from "./utils";
-
-interface Props {
-  parameters: ApiItem["parameters"];
-  type: "path" | "query" | "header" | "cookie";
-}
-
-export function createParamsTable({ parameters, type }: Props) {
-  if (parameters === undefined) {
-    return undefined;
-  }
-  const params = parameters.filter((param) => param?.in === type);
-  if (params.length === 0) {
-    return undefined;
-  }
-
-  return createFullWidthTable({
-    children: [
-      create("thead", {
-        children: create("tr", {
-          children: create("th", {
-            style: { textAlign: "left" },
-            children: `${
-              type.charAt(0).toUpperCase() + type.slice(1)
-            } Parameters`,
-          }),
-        }),
-      }),
-      create("tbody", {
-        children: params.map((param) =>
-          create("tr", {
-            children: create("td", {
-              children: [
-                create("code", { children: param.name }),
-                guard(param.schema, (schema) =>
-                  create("span", {
-                    style: { opacity: "0.6" },
-                    children: ` ${getSchemaName(schema)}`,
-                  })
-                ),
-                guard(param.required, () => [
-                  create("span", {
-                    style: { opacity: "0.6" },
-                    children: " — ",
-                  }),
-                  create("strong", {
-                    style: {
-                      fontSize: "var(--ifm-code-font-size)",
-                      color: "var(--openapi-required)",
-                    },
-                    children: " REQUIRED",
-                  }),
-                ]),
-                guard(getQualifierMessage(param.schema), (message) =>
-                  create("div", {
-                    style: { marginTop: "var(--ifm-table-cell-padding)" },
-                    children: createDescription(message),
-                  })
-                ),
-                guard(param.description, (description) =>
-                  create("div", {
-                    style: { marginTop: "var(--ifm-table-cell-padding)" },
-                    children: createDescription(description),
-                  })
-                ),
-                guard(param.example, (example) =>
-                  create("div", {
-                    style: { marginTop: "var(--ifm-table-cell-padding)" },
-                    children: escape(`Example: ${example}`),
-                  })
-                ),
-                guard(param.examples, (examples) =>
-                  create("div", {
-                    style: { marginTop: "var(--ifm-table-cell-padding)" },
-                    children: Object.entries(examples).map(([k, v]) =>
-                      create("div", {
-                        children: escape(`Example (${k}): ${v.value}`),
-                      })
-                    ),
-                  })
-                ),
-              ],
-            }),
-          })
-        ),
-      }),
-    ],
-  });
-}

package/src/markdown/createRequestBodyTable.ts

@@ -1,17 +0,0 @@
-/* ============================================================================
- * 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 { createSchemaTable } from "./createSchemaTable";
-
-interface Props {
-  title: string;
-  body: any;
-}
-
-export function createRequestBodyTable({ title, body }: Props) {
-  return createSchemaTable({ title, body });
-}

package/src/markdown/createSchemaTable.ts

@@ -1,275 +0,0 @@
-/* ============================================================================
- * 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 { MediaTypeObject, SchemaObject } from "../openapi/types";
-import { createDescription } from "./createDescription";
-import { createFullWidthTable } from "./createFullWidthTable";
-import { getQualifierMessage, getSchemaName } from "./schema";
-import { create, guard } from "./utils";
-
-function resolveAllOf(allOf: SchemaObject[]) {
-  // TODO: naive implementation (only supports objects, no directly nested allOf)
-  const properties = allOf.reduce((acc, cur) => {
-    if (cur.properties !== undefined) {
-      const next = { ...acc, ...cur.properties };
-      return next;
-    }
-    return acc;
-  }, {});
-
-  const required = allOf.reduce((acc, cur) => {
-    if (Array.isArray(cur.required)) {
-      const next = [...acc, ...cur.required];
-      return next;
-    }
-    return acc;
-  }, [] as string[]);
-
-  return { properties, required };
-}
-
-interface RowProps {
-  name: string;
-  schema: SchemaObject;
-  required: boolean;
-}
-
-function createRow({ name, schema, required }: RowProps) {
-  return create("tr", {
-    children: create("td", {
-      children: [
-        create("code", { children: name }),
-        create("span", {
-          style: { opacity: "0.6" },
-          children: ` ${getSchemaName(schema, true)}`,
-        }),
-        guard(required, () => [
-          create("span", {
-            style: { opacity: "0.6" },
-            children: " — ",
-          }),
-          create("strong", {
-            style: {
-              fontSize: "var(--ifm-code-font-size)",
-              color: "var(--openapi-required)",
-            },
-            children: " REQUIRED",
-          }),
-        ]),
-        guard(getQualifierMessage(schema), (message) =>
-          create("div", {
-            style: { marginTop: "var(--ifm-table-cell-padding)" },
-            children: createDescription(message),
-          })
-        ),
-        guard(schema.description, (description) =>
-          create("div", {
-            style: { marginTop: "var(--ifm-table-cell-padding)" },
-            children: createDescription(description),
-          })
-        ),
-        createRows({ schema: schema }),
-      ],
-    }),
-  });
-}
-
-interface RowsProps {
-  schema: SchemaObject;
-}
-
-function createRows({ schema }: RowsProps): string | undefined {
-  // object
-  if (schema.properties !== undefined) {
-    return createFullWidthTable({
-      style: {
-        marginTop: "var(--ifm-table-cell-padding)",
-        marginBottom: "0px",
-      },
-      children: create("tbody", {
-        children: Object.entries(schema.properties).map(([key, val]) =>
-          createRow({
-            name: key,
-            schema: val,
-            required: Array.isArray(schema.required)
-              ? schema.required.includes(key)
-              : false,
-          })
-        ),
-      }),
-    });
-  }
-
-  // TODO: This can be a bit complicated types can be missmatched and there can be nested allOfs which need to be resolved before merging properties
-  if (schema.allOf !== undefined) {
-    const { properties, required } = resolveAllOf(schema.allOf);
-    return createFullWidthTable({
-      style: {
-        marginTop: "var(--ifm-table-cell-padding)",
-        marginBottom: "0px",
-      },
-      children: create("tbody", {
-        children: Object.entries(properties).map(([key, val]) =>
-          createRow({
-            name: key,
-            schema: val,
-            required: Array.isArray(required) ? required.includes(key) : false,
-          })
-        ),
-      }),
-    });
-  }
-
-  // array
-  if (schema.items !== undefined) {
-    return createRows({ schema: schema.items });
-  }
-
-  // primitive
-  return undefined;
-}
-
-interface RowsRootProps {
-  schema: SchemaObject;
-}
-
-function createRowsRoot({ schema }: RowsRootProps) {
-  // object
-  if (schema.properties !== undefined) {
-    return Object.entries(schema.properties).map(([key, val]) =>
-      createRow({
-        name: key,
-        schema: val,
-        required: Array.isArray(schema.required)
-          ? schema.required.includes(key)
-          : false,
-      })
-    );
-  }
-
-  // TODO: This can be a bit complicated types can be missmatched and there can be nested allOfs which need to be resolved before merging properties
-  if (schema.allOf !== undefined) {
-    const { properties, required } = resolveAllOf(schema.allOf);
-    return Object.entries(properties).map(([key, val]) =>
-      createRow({
-        name: key,
-        schema: val,
-        required: Array.isArray(required) ? required.includes(key) : false,
-      })
-    );
-  }
-
-  // array
-  if (schema.items !== undefined) {
-    return create("tr", {
-      children: create("td", {
-        children: [
-          create("span", {
-            style: { opacity: "0.6" },
-            children: ` ${getSchemaName(schema, true)}`,
-          }),
-          createRows({ schema: schema.items }),
-        ],
-      }),
-    });
-  }
-
-  // primitive
-  return create("tr", {
-    children: create("td", {
-      children: [
-        create("span", {
-          style: { opacity: "0.6" },
-          children: ` ${schema.type}`,
-        }),
-        guard(getQualifierMessage(schema), (message) =>
-          create("div", {
-            style: { marginTop: "var(--ifm-table-cell-padding)" },
-            children: createDescription(message),
-          })
-        ),
-        guard(schema.description, (description) =>
-          create("div", {
-            style: { marginTop: "var(--ifm-table-cell-padding)" },
-            children: createDescription(description),
-          })
-        ),
-      ],
-    }),
-  });
-}
-
-interface Props {
-  style?: any;
-  title: string;
-  body: {
-    content?: {
-      [key: string]: MediaTypeObject;
-    };
-    description?: string;
-    required?: boolean;
-  };
-}
-
-export function createSchemaTable({ title, body, ...rest }: Props) {
-  if (body === undefined || body.content === undefined) {
-    return undefined;
-  }
-
-  // TODO:
-  // NOTE: We just pick a random content-type.
-  // How common is it to have multiple?
-  const randomFirstKey = Object.keys(body.content)[0];
-
-  const firstBody = body.content[randomFirstKey].schema;
-
-  if (firstBody === undefined) {
-    return undefined;
-  }
-
-  // we don't show the table if there is no properties to show
-  if (firstBody.properties !== undefined) {
-    if (Object.keys(firstBody.properties).length === 0) {
-      return undefined;
-    }
-  }
-
-  return createFullWidthTable({
-    ...rest,
-    children: [
-      create("thead", {
-        children: create("tr", {
-          children: create("th", {
-            style: { textAlign: "left" },
-            children: [
-              `${title} `,
-              guard(body.required, () => [
-                create("span", {
-                  style: { opacity: "0.6" },
-                  children: " — ",
-                }),
-                create("strong", {
-                  style: {
-                    fontSize: "var(--ifm-code-font-size)",
-                    color: "var(--openapi-required)",
-                  },
-                  children: " REQUIRED",
-                }),
-              ]),
-              create("div", {
-                children: createDescription(body.description),
-              }),
-            ],
-          }),
-        }),
-      }),
-      create("tbody", {
-        children: createRowsRoot({ schema: firstBody }),
-      }),
-    ],
-  });
-}