@acmekit/acmekit-oas-cli 2.13.1

package/README.md

@@ -0,0 +1,155 @@
+# acmekit-oas-cli - 0.1.0 - experimental
+
+A command-line tool for all OpenAPI Specifications (OAS) related tooling.
+
+## Install
+
+`yarn add --dev @acmekit/acmekit-oas-cli`
+
+Install in the global namespace is not yet supported.
+~~`npm install -g @acmekit/acmekit-oas-cli`~~
+
+## Configuration / First time setup
+
+N/A
+
+## How to use
+
+```bash
+yarn acmekit-oas <command>
+```
+
+---
+
+### Command - `oas`
+
+This command will scan the `@acmekit/acmekit` package in order to extract JSDoc OAS into a json file.
+
+The command will output one of three the files `admin.oas.json`, `store.oas.json` or `combined.oas.json` in the same
+directory that the command was run.
+
+Invalid OAS with throw an error and will prevent the files from being outputted.
+
+#### `--type <string>`
+
+Specify which API OAS to create. Accepts `admin`, `store`, `combined`.
+
+The `combined` option will merge both the admin and the store APIs into a single OAS file.
+
+```bash
+yarn acmekit-oas oas --type admin
+```
+
+#### `--out-dir <path>`
+
+Specify in which directory should the files be outputted. It accepts a relative or absolute path.
+If the directory doesn't exist, it will be created. Defaults to `./`.
+
+```bash
+yarm acmekit-oas oas --out-dir
+```
+
+#### `--paths <paths...>`
+
+Allows passing additional directory paths to crawl for JSDoc OAS and include in the generated OAS.
+It accepts multiple entries.
+
+```bash
+yarn acmekit-oas oas --paths ~/acmekit-server/src
+```
+
+#### `--base <path>`
+
+Allows overwriting the content the API's base.yaml OAS that is fed to swagger-inline.
+Paths, tags, and components will be merged together. Other OAS properties will be overwritten.
+
+```bash
+yarn acmekit-oas oas --base ~/acmekit-server/oas/custom.oas.base.yaml
+```
+
+#### `--dry-run`
+
+Will package the OAS but will not output file. Useful for validating OAS.
+
+```bash
+yarn acmekit-oas oas --dry-run
+```
+
+#### `--force`
+
+Ignore OAS errors and attempt to output generated OAS files.
+
+```bash
+yarn acmekit-oas oas --force
+```
+
+---
+
+### Command - `docs`
+
+Will sanitize OAS for use with Redocly's API documentation viewer.
+
+#### `--src-file <path>`
+
+Specify the path to the OAS JSON file.
+
+```bash
+yarm acmekit-oas docs --src-file ./store.oas.json
+```
+
+#### `--out-dir <path>`
+
+Specify in which directory should the files be outputted. Accepts relative and absolute path.
+If the directory doesn't exist, it will be created. Defaults to `./`.
+
+```bash
+yarn acmekit-oas docs --src-file ./store.oas.json --out-dir ./docs`
+```
+
+#### `--config <path>`
+
+Specify the path to a Redocly config file.
+
+```bash
+yarn acmekit-oas --src-file ./store.oas.json --config ./redocly-config.yaml
+```
+
+#### `--dry-run`
+
+Will sanitize the OAS but will not output file. Useful for troubleshooting circular reference issues.
+
+```bash
+yarn acmekit-oas docs --src-file ./store.oas.json --dry-run
+```
+
+#### `--clean`
+
+Delete destination directory content before generating the docs.
+
+```bash
+yarn acmekit-oas docs --src-file ./store.oas.json --clean
+```
+
+#### `--split`
+
+Creates a multi-file structure output. Uses `redocly split` internally.
+
+```bash
+yarn acmekit-oas docs --src-file ./store.oas.json --split
+```
+
+#### `--preview`
+
+Generate a preview of the API documentation in a browser. Does not output files. Uses `redocly preview-docs` internally.
+
+```bash
+yarn acmekit-oas docs --src-file ../../../www/apps/api-reference/specs/store.oas.json --preview
+```
+
+#### `--html`
+
+Generate a zero-dependency static HTML file. Uses `redocly build-docs` internally.
+
+```bash
+yarn acmekit-oas docs --src-file ./store.oas.json --html
+```

package/dist/command-docs.d.ts

@@ -0,0 +1,13 @@
+import { Command, Option, OptionValues } from "commander";
+/**
+ * CLI Command declaration
+ */
+export declare const commandName = "docs";
+export declare const commandDescription = "Sanitize OAS for use with Redocly's API documentation viewer.";
+export declare const commandOptions: Option[];
+export declare function getCommand(): Command;
+/**
+ * Main
+ */
+export declare function execute(cliParams: OptionValues): Promise<void>;
+//# sourceMappingURL=command-docs.d.ts.map

package/dist/command-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-docs.d.ts","sourceRoot":"","sources":["../src/command-docs.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAiCzD;;GAEG;AACH,eAAO,MAAM,WAAW,SAAS,CAAA;AACjC,eAAO,MAAM,kBAAkB,kEACkC,CAAA;AAEjE,eAAO,MAAM,cAAc,EAAE,MAAM,EA+BlC,CAAA;AAED,wBAAgB,UAAU,IAAI,OAAO,CASpC;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkFpE"}

package/dist/command-docs.js

@@ -0,0 +1,233 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandOptions = exports.commandDescription = exports.commandName = void 0;
+exports.getCommand = getCommand;
+exports.execute = execute;
+const preview_docs_1 = require("@redocly/cli/lib/commands/preview-docs");
+const wrapper_1 = require("@redocly/cli/lib/wrapper");
+const commander_1 = require("commander");
+const execa_1 = __importDefault(require("execa"));
+const promises_1 = __importStar(require("fs/promises"));
+const lodash_mergewith_1 = __importDefault(require("lodash.mergewith"));
+const path = __importStar(require("path"));
+const circular_patch_utils_1 = require("./utils/circular-patch-utils");
+const fs_utils_1 = require("./utils/fs-utils");
+const json_utils_1 = require("./utils/json-utils");
+const yaml_utils_1 = require("./utils/yaml-utils");
+/**
+ * Constants
+ */
+const basePath = path.resolve(__dirname, "../");
+const acmekitPluginRelativePath = "./plugins/acmekit/index.js";
+const acmekitPluginAbsolutePath = path.resolve(basePath, "redocly/plugins/acmekit/index.js");
+const configFileDefault = path.resolve(basePath, "redocly/redocly-config.yaml");
+/**
+ * CLI Command declaration
+ */
+exports.commandName = "docs";
+exports.commandDescription = "Sanitize OAS for use with Redocly's API documentation viewer.";
+exports.commandOptions = [
+    new commander_1.Option("-s, --src-file <srcFile>", "Path to source OAS JSON file.").makeOptionMandatory(),
+    new commander_1.Option("-o, --out-dir <outDir>", "Destination directory to output the sanitized OAS files.").default(process.cwd()),
+    new commander_1.Option("--config <config>", "Configuration file to merge with default configuration before passing to Redocly's CLI."),
+    new commander_1.Option("-D, --dry-run", "Do not output files."),
+    new commander_1.Option("--clean", "Delete destination directory content before generating documentation."),
+    new commander_1.Option("--split", "Creates a multi-file structure output."),
+    new commander_1.Option("--preview", "Open a preview of the documentation. Does not output files."),
+    new commander_1.Option("--html", "Generate a static HTML using Redocly's build-docs command."),
+    new commander_1.Option("--main-file-name <mainFileName>", "The name of the main YAML file.").default("openapi.yaml"),
+];
+function getCommand() {
+    const command = new commander_1.Command(exports.commandName);
+    command.description(exports.commandDescription);
+    for (const opt of exports.commandOptions) {
+        command.addOption(opt);
+    }
+    command.action(async (options) => await execute(options));
+    command.showHelpAfterError(true);
+    return command;
+}
+/**
+ * Main
+ */
+async function execute(cliParams) {
+    /**
+     * Process CLI options
+     */
+    const shouldClean = !!cliParams.clean;
+    const shouldSplit = !!cliParams.split;
+    const shouldPreview = !!cliParams.preview;
+    const shouldBuildHTML = !!cliParams.html;
+    const dryRun = !!cliParams.dryRun;
+    const srcFile = path.resolve(cliParams.srcFile);
+    const outDir = path.resolve(cliParams.outDir);
+    const configFileCustom = cliParams.config
+        ? path.resolve(cliParams.config)
+        : undefined;
+    if (configFileCustom) {
+        if (!(await (0, fs_utils_1.isFile)(configFileCustom))) {
+            throw new Error(`--config must be a file - ${configFileCustom}`);
+        }
+        if (![".json", ".yaml"].includes(path.extname(configFileCustom))) {
+            throw new Error(`--config file must be of type .json or .yaml - ${configFileCustom}`);
+        }
+    }
+    /**
+     * Command execution
+     */
+    console.log(`🟣 Generating API documentation`);
+    const tmpDir = await (0, fs_utils_1.getTmpDirectory)();
+    const configTmpFile = path.resolve(tmpDir, "redocly-config.yaml");
+    /** matches naming convention from `redocly split` */
+    const finalOASFile = cliParams.mainFileName;
+    await createTmpConfig(configFileDefault, configTmpFile);
+    if (configFileCustom) {
+        console.log(`🔵 Merging configuration file - ${configFileCustom} > ${configTmpFile}`);
+        await mergeConfig(configTmpFile, configFileCustom, configTmpFile);
+    }
+    if (!dryRun) {
+        if (shouldClean) {
+            console.log(`🟠 Cleaning output directory`);
+            await promises_1.default.rm(outDir, { recursive: true, force: true });
+        }
+        await (0, promises_1.mkdir)(outDir, { recursive: true });
+    }
+    const srcFileSanitized = path.resolve(tmpDir, "tmp.oas.yaml");
+    await sanitizeOAS(srcFile, srcFileSanitized, configTmpFile);
+    await fixCirclularReferences(srcFileSanitized);
+    if (dryRun) {
+        console.log(`⚫️ Dry run - no files generated`);
+        // check out possible changes in redocly config
+        await (0, execa_1.default)("git", [
+            "checkout",
+            path.join(basePath, "redocly", "redocly-config.yaml"),
+        ]);
+        return;
+    }
+    if (shouldPreview) {
+        await preview(srcFileSanitized, configTmpFile);
+        return;
+    }
+    if (shouldSplit) {
+        await generateReference(srcFileSanitized, outDir);
+    }
+    else {
+        await (0, yaml_utils_1.writeYaml)(path.join(outDir, finalOASFile), await promises_1.default.readFile(srcFileSanitized, "utf8"));
+    }
+    if (shouldBuildHTML) {
+        const outHTMLFile = path.resolve(outDir, "index.html");
+        await buildHTML(finalOASFile, outHTMLFile, configTmpFile);
+    }
+    console.log(`⚫️ API documentation generated - ${outDir}`);
+}
+const mergeConfig = async (configFileDefault, configFileCustom, configFileOut) => {
+    const configDefault = await (0, yaml_utils_1.readYaml)(configFileDefault);
+    const configCustom = path.extname(configFileCustom) === ".yaml"
+        ? await (0, yaml_utils_1.readYaml)(configFileCustom)
+        : await (0, json_utils_1.readJson)(configFileCustom);
+    const config = (0, lodash_mergewith_1.default)(configDefault, configCustom, (objValue, srcValue) => Array.isArray(objValue) ? objValue.concat(srcValue) : undefined);
+    await (0, yaml_utils_1.writeYamlFromJson)(configFileOut, config);
+};
+const createTmpConfig = async (configFileDefault, configFileOut) => {
+    var _a;
+    const config = (await (0, yaml_utils_1.readYaml)(configFileDefault));
+    config.plugins = ((_a = config.plugins) !== null && _a !== void 0 ? _a : []).filter((plugin) => plugin !== acmekitPluginRelativePath);
+    config.plugins.push(acmekitPluginAbsolutePath);
+    await (0, yaml_utils_1.writeYamlFromJson)(configFileOut, config);
+};
+const sanitizeOAS = async (srcFile, outFile, configFile) => {
+    const { all: logs } = await (0, execa_1.default)("yarn", [
+        "redocly",
+        "bundle",
+        srcFile,
+        `--output=${outFile}`,
+        `--config=${configFile}`,
+    ], { cwd: basePath, all: true });
+    console.log(logs);
+};
+const fixCirclularReferences = async (srcFile) => {
+    const { circularRefs, oas } = await (0, circular_patch_utils_1.getCircularReferences)(srcFile);
+    if (circularRefs.length) {
+        const recommendation = (0, circular_patch_utils_1.getCircularPatchRecommendation)(circularRefs, oas);
+        if (Object.keys(recommendation).length) {
+            const hint = (0, circular_patch_utils_1.formatHintRecommendation)(recommendation);
+            const hintMessage = `
+###
+${hint}
+###
+`;
+            const redoclyConfigPath = path.join(basePath, "redocly", "redocly-config.yaml");
+            const originalContent = (await (0, yaml_utils_1.readYaml)(redoclyConfigPath));
+            Object.keys(recommendation).forEach((recKey) => {
+                originalContent.decorators["acmekit/circular-patch"].schemas[recKey] = [
+                    ...(originalContent.decorators["acmekit/circular-patch"].schemas[recKey] || []),
+                    ...recommendation[recKey],
+                ];
+            });
+            await (0, yaml_utils_1.writeYaml)(redoclyConfigPath, (0, yaml_utils_1.jsonObjectToYamlString)(originalContent));
+            console.log(`🟡 Added the following unhandled circular references to redocly-config.ts:` +
+                hintMessage);
+        }
+    }
+    console.log(`🟢 All circular references are handled`);
+};
+const generateReference = async (srcFile, outDir) => {
+    const { all: logs } = await (0, execa_1.default)("yarn", ["redocly", "split", srcFile, `--outDir=${outDir}`], { cwd: basePath, all: true });
+    console.log(logs);
+};
+const preview = async (oasFile, configFile) => {
+    await (0, wrapper_1.commandWrapper)(preview_docs_1.previewDocs)({
+        port: 8080,
+        host: "127.0.0.1",
+        api: oasFile,
+        config: configFile,
+    });
+};
+const buildHTML = async (srcFile, outFile, configFile) => {
+    const { all: logs } = await (0, execa_1.default)("yarn", [
+        "redocly",
+        "build-docs",
+        srcFile,
+        `--output=${outFile}`,
+        `--config=${configFile}`,
+        `--cdn=true`,
+    ], { cwd: basePath, all: true });
+    console.log(logs);
+};
+//# sourceMappingURL=command-docs.js.map

package/dist/command-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-docs.js","sourceRoot":"","sources":["../src/command-docs.ts"],"names":[],"mappings":"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"}

package/dist/command-oas.d.ts

@@ -0,0 +1,13 @@
+import { Command, Option, OptionValues } from "commander";
+/**
+ * CLI Command declaration
+ */
+export declare const commandName = "oas";
+export declare const commandDescription = "Compile full OAS from swagger-inline compliant JSDoc.";
+export declare const commandOptions: Option[];
+export declare function getCommand(): Command;
+/**
+ * Main
+ */
+export declare function execute(cliParams: OptionValues): Promise<void>;
+//# sourceMappingURL=command-oas.d.ts.map

package/dist/command-oas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-oas.d.ts","sourceRoot":"","sources":["../src/command-oas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAmBzD;;GAEG;AACH,eAAO,MAAM,WAAW,QAAQ,CAAA;AAChC,eAAO,MAAM,kBAAkB,0DAC0B,CAAA;AAEzD,eAAO,MAAM,cAAc,EAAE,MAAM,EAsBlC,CAAA;AAED,wBAAgB,UAAU,YASzB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,SAAS,EAAE,YAAY,iBAqEpD"}

package/dist/command-oas.js

@@ -0,0 +1,210 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandOptions = exports.commandDescription = exports.commandName = void 0;
+exports.getCommand = getCommand;
+exports.execute = execute;
+const openapi_parser_1 = __importDefault(require("@readme/openapi-parser"));
+const commander_1 = require("commander");
+const promises_1 = require("fs/promises");
+const path = __importStar(require("path"));
+const swagger_inline_1 = __importDefault(require("swagger-inline"));
+const combine_oas_1 = require("./utils/combine-oas");
+const merge_oas_1 = require("./utils/merge-oas");
+const fs_utils_1 = require("./utils/fs-utils");
+/**
+ * Constants
+ */
+// AcmeKit core package directory
+const acmekitPackagePath = path.dirname(require.resolve("@acmekit/acmekit"));
+const basePath = path.resolve(__dirname, "../");
+/**
+ * CLI Command declaration
+ */
+exports.commandName = "oas";
+exports.commandDescription = "Compile full OAS from swagger-inline compliant JSDoc.";
+exports.commandOptions = [
+    new commander_1.Option("-t, --type <type>", "API type to compile.")
+        .choices(["admin", "store", "combined"])
+        .makeOptionMandatory(),
+    new commander_1.Option("-o, --out-dir <outDir>", "Destination directory to output generated OAS files.").default(process.cwd()),
+    new commander_1.Option("-D, --dry-run", "Do not output files."),
+    new commander_1.Option("-p, --paths <paths...>", "Additional paths to crawl for OAS JSDoc."),
+    new commander_1.Option("-b, --base <base>", "Custom base OAS file to use for swagger-inline."),
+    new commander_1.Option("-F, --force", "Ignore OAS validation and output OAS files."),
+    new commander_1.Option("--local", "Generate OAS from local files rather than public OAS. This is useful for generating references in the AcmeKit monorepo."),
+];
+function getCommand() {
+    const command = new commander_1.Command(exports.commandName);
+    command.description(exports.commandDescription);
+    for (const opt of exports.commandOptions) {
+        command.addOption(opt);
+    }
+    command.action(async (options) => await execute(options));
+    command.showHelpAfterError(true);
+    return command;
+}
+/**
+ * Main
+ */
+async function execute(cliParams) {
+    var _a;
+    /**
+     * Process CLI options
+     */
+    const dryRun = !!cliParams.dryRun;
+    const force = !!cliParams.force;
+    const v2 = !!cliParams.v2;
+    const local = !!cliParams.local;
+    const apiType = cliParams.type;
+    const outDir = path.resolve(cliParams.outDir);
+    const additionalPaths = ((_a = cliParams.paths) !== null && _a !== void 0 ? _a : []).map((additionalPath) => path.resolve(additionalPath));
+    for (const additionalPath of additionalPaths) {
+        if (!(await isDirectory(additionalPath))) {
+            throw new Error(`--paths must be a directory - ${additionalPath}`);
+        }
+    }
+    const baseFile = cliParams.base ? path.resolve(cliParams.base) : undefined;
+    if (baseFile) {
+        if (!(await (0, fs_utils_1.isFile)(cliParams.base))) {
+            throw new Error(`--base must be a file - ${baseFile}`);
+        }
+    }
+    /**
+     * Command execution
+     */
+    if (!dryRun) {
+        await (0, promises_1.mkdir)(outDir, { recursive: true });
+    }
+    let oas;
+    console.log(`🟣 Generating OAS - ${apiType}`);
+    if (apiType === "combined") {
+        const adminOAS = !local
+            ? await getPublicOas("admin")
+            : await getOASFromCodebase("admin");
+        const storeOAS = !local
+            ? await getPublicOas("store")
+            : await getOASFromCodebase("store");
+        oas = await (0, combine_oas_1.combineOAS)(adminOAS, storeOAS);
+    }
+    else {
+        oas = !local
+            ? await getPublicOas(apiType)
+            : await getOASFromCodebase(apiType);
+    }
+    if (additionalPaths.length || baseFile) {
+        const customOAS = await getOASFromPaths(additionalPaths, baseFile);
+        if (baseFile) {
+            (0, merge_oas_1.mergeBaseIntoOAS)(oas, customOAS);
+        }
+        if (additionalPaths.length) {
+            (0, merge_oas_1.mergePathsAndSchemasIntoOAS)(oas, customOAS);
+        }
+    }
+    await validateOAS(oas, apiType, force);
+    if (dryRun) {
+        console.log(`⚫️ Dry run - no files generated`);
+        return;
+    }
+    await exportOASToJSON(oas, apiType, outDir);
+}
+/**
+ * Methods
+ */
+async function getOASFromCodebase(apiType) {
+    /**
+     * OAS output directory
+     */
+    const oasOutputPath = path.resolve(__dirname, "..", "..", "..", "..", "..", "www", "utils", "generated", "oas-output");
+    const gen = await (0, swagger_inline_1.default)([
+        path.resolve(oasOutputPath, "operations", apiType),
+        path.resolve(oasOutputPath, "schemas"),
+        // We currently load error schemas from here. If we change
+        // that in the future, we should change the path.
+        path.resolve(acmekitPackagePath, "dist", "utils/middlewares"),
+    ], {
+        base: path.resolve(oasOutputPath, "base", `${apiType}.oas.base.yaml`),
+        format: ".json",
+    });
+    return (await openapi_parser_1.default.parse(JSON.parse(gen)));
+}
+async function getPublicOas(apiType) {
+    const url = `https://docs.acmekit.com/api/download/${apiType}`;
+    return (await openapi_parser_1.default.parse(url));
+}
+async function getOASFromPaths(additionalPaths = [], customBaseFile) {
+    console.log(`🔵 Gathering custom OAS`);
+    const gen = await (0, swagger_inline_1.default)(additionalPaths.map((additionalPath) => {
+        return additionalPath.replace(/\\/g, "/");
+    }), {
+        base: customBaseFile !== null && customBaseFile !== void 0 ? customBaseFile : path.resolve(basePath, "oas", "default.oas.base.yaml"),
+        format: ".json",
+        logger: (log) => {
+            console.log(log);
+        },
+    });
+    return (await openapi_parser_1.default.parse(JSON.parse(gen)));
+}
+async function validateOAS(oas, apiType, force = false) {
+    try {
+        await openapi_parser_1.default.validate(JSON.parse(JSON.stringify(oas)));
+        console.log(`🟢 Valid OAS - ${apiType}`);
+    }
+    catch (err) {
+        console.error(`🔴 Invalid OAS - ${apiType}`, err);
+        if (!force) {
+            process.exit(1);
+        }
+    }
+}
+async function exportOASToJSON(oas, apiType, targetDir) {
+    const json = JSON.stringify(oas, null, 2);
+    const filePath = path.resolve(targetDir, `${apiType}.oas.json`);
+    await (0, promises_1.writeFile)(filePath, json);
+    console.log(`⚫️ Exported OAS - ${apiType} - ${filePath}`);
+}
+async function isDirectory(dirPath) {
+    try {
+        return (await (0, promises_1.lstat)(path.resolve(dirPath))).isDirectory();
+    }
+    catch (err) {
+        console.log(err);
+        return false;
+    }
+}
+//# sourceMappingURL=command-oas.js.map

package/dist/command-oas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-oas.js","sourceRoot":"","sources":["../src/command-oas.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#! /usr/bin/env node
+import { Command } from "commander";
+export declare function getBaseCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAuBnC,wBAAgB,cAAc,YAU7B"}