@apimatic/cli 1.1.0-alpha.9 → 1.1.0-beta.2

package/lib/commands/portal/recipe/new.js

@@ -0,0 +1,45 @@
+var _a;
+import { Command, Flags } from "@oclif/core";
+import { PortalRecipeAction } from "../../../actions/portal/recipe/new-recipe.js";
+import { TelemetryService } from "../../../infrastructure/services/telemetry-service.js";
+import { RecipeCreationFailedEvent } from "../../../types/events/recipe-creation-failed.js";
+import { DirectoryPath } from "../../../types/file/directoryPath.js";
+import { FlagsProvider } from "../../../types/flags-provider.js";
+import { format, intro, outro } from "../../../prompts/format.js";
+class PortalRecipeNew extends Command {
+    async run() {
+        const { flags: { name, input, force } } = await this.parse(_a);
+        const workingDirectory = DirectoryPath.createInput(input);
+        const buildDirectory = input ? new DirectoryPath(input, "src") : workingDirectory.join("src");
+        const commandMetadata = {
+            commandName: _a.id,
+            shell: this.config.shell
+        };
+        intro("New Recipe");
+        const action = new PortalRecipeAction(new DirectoryPath(this.config.configDir), commandMetadata);
+        const result = await action.execute(buildDirectory, name);
+        outro(result);
+        result.mapAll(() => { }, async () => {
+            const telemetryService = new TelemetryService(new DirectoryPath(this.config.configDir));
+            await telemetryService.trackEvent(new RecipeCreationFailedEvent("error", _a.id, {
+                name,
+                input,
+                force
+            }), commandMetadata.shell);
+        }, () => { });
+    }
+}
+_a = PortalRecipeNew;
+PortalRecipeNew.summary = "Add an API Recipe to your API documentation portal.";
+PortalRecipeNew.description = `This command adds a new API Recipe file to your documentation portal.
+
+To learn more about API Recipes, visit:
+${format.link("https://docs.apimatic.io/platform-api/#/http/guides/generating-on-prem-api-portal/api-recipes")}`;
+PortalRecipeNew.flags = Object.assign(Object.assign({ name: Flags.string({ description: "name for the recipe" }) }, FlagsProvider.input), FlagsProvider.force);
+PortalRecipeNew.cmdTxt = format.cmd("apimatic", "portal", "recipe", "new");
+PortalRecipeNew.examples = [
+    `${_a.cmdTxt}`,
+    `${_a.cmdTxt} ${format.flag("name", '"My API Recipe"')} ${format.flag("input", '"./"')}`
+];
+export default PortalRecipeNew;
+//# sourceMappingURL=new.js.map

package/lib/commands/portal/recipe/new.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.js","sourceRoot":"","sources":["../../../../src/commands/portal/recipe/new.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uDAAuD,CAAC;AACzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAqB,eAAgB,SAAQ,OAAO;IAsBlD,KAAK,CAAC,GAAG;QACP,MAAM,EACJ,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAC9B,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAe,CAAC,CAAC;QAEtC,MAAM,gBAAgB,GAAG,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE9F,MAAM,eAAe,GAAoB;YACvC,WAAW,EAAE,EAAe,CAAC,EAAE;YAC/B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC;QAEF,KAAK,CAAC,YAAY,CAAC,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC;QACjG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC1D,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,GAAE,CAAC,EACR,KAAK,IAAI,EAAE;YACT,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YACxF,MAAM,gBAAgB,CAAC,UAAU,CAC/B,IAAI,yBAAyB,CAAC,OAAO,EAAE,EAAe,CAAC,EAAE,EAAE;gBACzD,IAAI;gBACJ,KAAK;gBACL,KAAK;aACN,CAAC,EACF,eAAe,CAAC,KAAK,CACtB,CAAC;QACJ,CAAC,EACD,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;IACJ,CAAC;;;AAtDM,uBAAO,GAAG,qDAAqD,AAAxD,CAAyD;AAEhE,2BAAW,GAAG;;;EAGrB,MAAM,CAAC,IAAI,CACX,+FAA+F,CAChG,EAAE,AALiB,CAKhB;AAEK,qBAAK,iCACV,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC,IACvD,aAAa,CAAC,KAAK,GACnB,aAAa,CAAC,KAAK,CAHZ,CAIV;AAEc,sBAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,AAApD,CAAqD;AAC3D,wBAAQ,GAAG;IACzB,GAAG,EAAI,CAAC,MAAM,EAAE;IAChB,GAAG,EAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE;CAC3F,AAHuB,CAGtB;eApBiB,eAAe"}

package/lib/commands/portal/serve.d.ts

@@ -1,16 +1,16 @@
 import { Command } from "@oclif/core";
 export default class PortalServe extends Command {
+    static summary: string;
     static description: string;
     static flags: {
-        port: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
-        destination: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        source: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        open: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        "no-reload": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        ignore: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        "auth-key": import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        "auth-key": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        open: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "no-reload": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        destination: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        port: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
     };
+    static cmdTxt: string;
     static examples: string[];
     run(): Promise<void>;
-    private handleError;
+    private getConfigDir;
 }

package/lib/commands/portal/serve.js

@@ -1,137 +1,53 @@
-"use strict";
 var _a;
-Object.defineProperty(exports, "__esModule", { value: true });
-const path = require("path");
-const axios_1 = require("axios");
-const core_1 = require("@oclif/core");
-const serve_1 = require("../../controllers/portal/serve");
-const server_1 = require("../../services/portal/server");
-const serve_2 = require("../../prompts/portal/serve");
-const utils_1 = require("../../utils/utils");
-const serveValidator_1 = require("../../validators/portal/serveValidator");
-class PortalServe extends core_1.Command {
+import { Command, Flags } from "@oclif/core";
+import { PortalServeAction } from "../../actions/portal/serve.js";
+import { DirectoryPath } from "../../types/file/directoryPath.js";
+import { FlagsProvider } from "../../types/flags-provider.js";
+import { format, intro, outro } from "../../prompts/format.js";
+class PortalServe extends Command {
     async run() {
-        var _b;
-        const { flags } = await this.parse(_a);
-        const ignoredPaths = flags.ignore.split(",").map((path) => path.trim());
-        const portalDir = path.resolve(flags.destination);
-        const sourceDir = path.resolve(flags.source);
-        const port = flags.port;
-        const overrideAuthKey = (_b = flags["auth-key"]) !== null && _b !== void 0 ? _b : null;
-        const serverService = new server_1.PortalServerService();
-        const prompts = new serve_2.PortalServePrompts();
-        const validator = new serveValidator_1.PortalServeValidator(this.error);
-        const allIgnoredPaths = [...ignoredPaths, ...(0, utils_1.getGeneratedFilesPaths)(sourceDir, portalDir)];
-        await validator.validate(port, flags.destination, sourceDir, portalDir);
-        try {
-            prompts.displayGeneratingPortalMessage();
-            await (0, serve_1.generatePortal)(sourceDir, portalDir, this.config.configDir, allIgnoredPaths, overrideAuthKey);
-            prompts.displayGeneratedPortalMessage(portalDir);
-            await (0, utils_1.cleanUpGeneratedPortalFiles)(sourceDir);
-        }
-        catch (error) {
-            prompts.displayGeneratingPortalErrorMessage();
-            await (0, utils_1.cleanUpGeneratedPortalFiles)(sourceDir);
-            this.handleError(error);
-        }
-        serverService.setupServer(portalDir);
-        serverService.startServer({
-            generatedPortalPath: portalDir,
-            targetFolder: sourceDir,
-            configDir: this.config.configDir,
-            authKey: overrideAuthKey,
-            ignoredPaths: allIgnoredPaths,
-            port,
-            openInBrowser: flags.open
-        }, flags["no-reload"]);
-        prompts.displayOutroMessage(port);
+        const { flags: { input, destination, port, open, "no-reload": noReload, "auth-key": authKey } } = await this.parse(_a);
+        const workingDirectory = DirectoryPath.createInput(input);
+        const buildDirectory = input ? new DirectoryPath(input, "src") : workingDirectory.join("src");
+        const portalDirectory = destination ? new DirectoryPath(destination) : workingDirectory.join("portal");
+        const commandMetadata = {
+            commandName: _a.id,
+            shell: this.config.shell
+        };
+        intro("Portal Serve");
+        const portalServeAction = new PortalServeAction(this.getConfigDir(), commandMetadata, authKey);
+        const result = await portalServeAction.execute(buildDirectory, portalDirectory, port, open, !noReload);
+        outro(result);
     }
-    handleError(error) {
-        if (axios_1.default.isAxiosError(error)) {
-            const axiosError = error;
-            if (axiosError.response) {
-                if (axiosError.response.status === 400) {
-                    this.error((0, utils_1.getMessageInRedColor)(`Failed to generate the portal. Please ensure that the provided build directory follows the correct structure and contains valid API definition and build files.`));
-                }
-                else if (axiosError.response.status === 401) {
-                    this.error((0, utils_1.getMessageInRedColor)(`Failed to generate the portal. Please ensure that you are logged in or have provided a valid Auth key.`));
-                }
-                else if (axiosError.response.status === 403) {
-                    this.error((0, utils_1.getMessageInRedColor)(`Access denied. It looks like you don’t have access to APIMatic’s Docs as Code offering. Check your subscription details and contact our team at support@apimatic.io if you believe this is a mistake.`));
-                }
-                else if (axiosError.response.status === 422) {
-                    this.error((0, utils_1.getMessageInRedColor)(`Failed to generate the portal. Please ensure that the provided build directory follows the correct structure and contains valid API definition and build files.`));
-                }
-                else if (axiosError.response.status === 500) {
-                    this.error((0, utils_1.getMessageInRedColor)(`Failed to generate the portal. Please ensure that the provided build directory follows the correct structure and contains valid API definition and build files. If the issue persists, reach out to our team at support@apimatic.io`));
-                }
-                else {
-                    this.error((0, utils_1.getMessageInRedColor)(`Failed to generate the portal. Please ensure that the provided build directory follows the correct structure and contains valid API definition and build files. If the issue persists, reach out to our team at support@apimatic.io`));
-                }
-            }
-            else if (axiosError.request) {
-                if (axiosError.code === "ECONNABORTED") {
-                    this.error((0, utils_1.getMessageInRedColor)(`Your request timed out. Please try again or reach out to our team at support@apimatic.io for help if your problem persists.`));
-                }
-                else if (error.code === "ENOTFOUND" || error.code === "ERR_NETWORK") {
-                    this.error((0, utils_1.getMessageInRedColor)(`Network error. Please check your internet connection and try again.`));
-                }
-                else {
-                    this.error((0, utils_1.getMessageInRedColor)(`No response received from the server. Please try again later.`));
-                }
-            }
-            else {
-                this.error((0, utils_1.getMessageInRedColor)(`Failed to generate the portal: ${axiosError.message}`));
-            }
-        }
-        else if (error instanceof Error) {
-            this.error((0, utils_1.getMessageInRedColor)(`Failed to generate the portal: ${error.message}`));
-        }
-        else {
-            this.error((0, utils_1.getMessageInRedColor)(`Something went wrong while generating the portal, please try again later. If the issue persists, contact our team at support@apimatic.io`));
-        }
+    getConfigDir() {
+        return new DirectoryPath(this.config.configDir);
     }
 }
 _a = PortalServe;
-PortalServe.description = "Generate and deploy a Docs as Code portal with hot reload.";
-PortalServe.flags = {
-    port: core_1.Flags.integer({
+PortalServe.summary = "Generate and serve an API Documentation Portal with hot reload.";
+PortalServe.description = "Requires an input directory with API specifications, a config file, and optionally markdown guides. Supports disabling hot reload and opening the portal in the default browser.";
+PortalServe.flags = Object.assign(Object.assign(Object.assign(Object.assign({ port: Flags.integer({
         char: "p",
-        description: "Port to serve the portal.",
-        default: 3000
-    }),
-    destination: core_1.Flags.string({
-        char: "d",
-        description: "Directory to store and serve the generated portal.",
-        default: "./generated_portal",
-        parse: async (input) => path.resolve(input)
-    }),
-    source: core_1.Flags.string({
-        char: "s",
-        description: "Source directory containing specs, content, and build file. By default, the current directory is used.",
-        default: "./",
-        parse: async (input) => path.resolve(input)
-    }),
-    open: core_1.Flags.boolean({
+        description: "port to serve the portal.",
+        default: 3000,
+        helpValue: "3000"
+    }) }, FlagsProvider.input), FlagsProvider.destination("portal", "portal")), { open: Flags.boolean({
         char: "o",
-        description: "Open the portal in the default browser.",
+        description: "open the portal in the default browser.",
         default: false
-    }),
-    "no-reload": core_1.Flags.boolean({
-        description: "Disable hot reload.",
+    }), "no-reload": Flags.boolean({
+        description: "disable hot reload.",
         default: false
-    }),
-    ignore: core_1.Flags.string({
-        char: "i",
-        description: "Comma-separated list of files/directories to ignore.",
-        default: ""
-    }),
-    "auth-key": core_1.Flags.string({
-        description: "Override current authentication state with an authentication key."
-    })
-};
+    }) }), FlagsProvider.authKey);
+PortalServe.cmdTxt = format.cmd("apimatic", "portal", "serve");
 PortalServe.examples = [
-    '$ apimatic portal:serve --source="./" --destination="./generated_portal" --port=3000 --open --no-reload'
+    _a.cmdTxt,
+    `${_a.cmdTxt} ` +
+        `${format.flag("input", './')} ` +
+        `${format.flag("destination", './portal')} ` +
+        `${format.flag("port", "3000")} ` +
+        `${format.flag("open")} ` +
+        `${format.flag("no-reload")}`
 ];
-exports.default = PortalServe;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY29tbWFuZHMvcG9ydGFsL3NlcnZlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDZCQUE2QjtBQUM3QixpQ0FBMEI7QUFDMUIsc0NBQTZDO0FBQzdDLDBEQUFnRTtBQUNoRSx5REFBbUU7QUFDbkUsc0RBQWdFO0FBQ2hFLDZDQUE4RztBQUM5RywyRUFBOEU7QUFFOUUsTUFBcUIsV0FBWSxTQUFRLGNBQU87SUE2QzlDLEtBQUssQ0FBQyxHQUFHOztRQUNQLE1BQU0sRUFBRSxLQUFLLEVBQUUsR0FBRyxNQUFNLElBQUksQ0FBQyxLQUFLLENBQUMsRUFBVyxDQUFDLENBQUM7UUFDaEQsTUFBTSxZQUFZLEdBQUcsS0FBSyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsSUFBSSxFQUFFLEVBQUUsQ0FBQyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQztRQUN4RSxNQUFNLFNBQVMsR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxXQUFXLENBQUMsQ0FBQztRQUNsRCxNQUFNLFNBQVMsR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUM3QyxNQUFNLElBQUksR0FBRyxLQUFLLENBQUMsSUFBSSxDQUFDO1FBQ3hCLE1BQU0sZUFBZSxHQUFHLE1BQUEsS0FBSyxDQUFDLFVBQVUsQ0FBQyxtQ0FBSSxJQUFJLENBQUM7UUFDbEQsTUFBTSxhQUFhLEdBQUcsSUFBSSw0QkFBbUIsRUFBRSxDQUFDO1FBQ2hELE1BQU0sT0FBTyxHQUFHLElBQUksMEJBQWtCLEVBQUUsQ0FBQztRQUN6QyxNQUFNLFNBQVMsR0FBRyxJQUFJLHFDQUFvQixDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUN2RCxNQUFNLGVBQWUsR0FBRyxDQUFDLEdBQUcsWUFBWSxF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
+export default PortalServe;
+//# sourceMappingURL=serve.js.map

package/lib/commands/portal/serve.js.map

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

package/lib/commands/portal/toc/new.d.ts

@@ -3,13 +3,12 @@ export default class PortalTocNew extends Command {
     static summary: string;
     static description: string;
     static flags: {
-        destination: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        folder: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        "expand-endpoints": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        "expand-models": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        "expand-endpoints": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "expand-models": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        destination: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    static cmdTxt: string;
     static examples: string[];
-    constructor(argv: string[], config: any);
     run(): Promise<void>;
 }

package/lib/commands/portal/toc/new.js

@@ -1,65 +1,60 @@
-"use strict";
 var _a;
-Object.defineProperty(exports, "__esModule", { value: true });
-const path = require("path");
-const core_1 = require("@oclif/core");
-const new_toc_1 = require("../../../actions/portal/toc/new-toc");
-const DEFAULT_FOLDER = process.cwd();
-class PortalTocNew extends core_1.Command {
-    constructor(argv, config) {
-        super(argv, config);
-    }
+import { Command, Flags } from "@oclif/core";
+import { PortalNewTocAction } from "../../../actions/portal/toc/new-toc.js";
+import { TelemetryService } from "../../../infrastructure/services/telemetry-service.js";
+import { TocCreationFailedEvent } from "../../../types/events/toc-creation-failed.js";
+import { DirectoryPath } from "../../../types/file/directoryPath.js";
+import { FlagsProvider } from "../../../types/flags-provider.js";
+import { format, intro, outro } from "../../../prompts/format.js";
+class PortalTocNew extends Command {
     async run() {
-        const { flags } = await this.parse(_a);
-        const portalNewTocAction = new new_toc_1.PortalNewTocAction();
-        const result = await portalNewTocAction.createToc(flags.folder, this.config.configDir, flags.destination, flags.force, flags["expand-endpoints"], flags["expand-models"]);
-        if (result.isFailed()) {
-            this.error(result.error);
-        }
+        const { flags: { input, destination, force, "expand-endpoints": expandEndpoints, "expand-models": expandModels } } = await this.parse(_a);
+        const workingDirectory = DirectoryPath.createInput(input);
+        const buildDirectory = input ? new DirectoryPath(input, "src") : workingDirectory.join("src");
+        const tocDirectory = destination ? new DirectoryPath(destination) : undefined;
+        const commandMetadata = {
+            commandName: _a.id,
+            shell: this.config.shell
+        };
+        intro("New TOC");
+        const action = new PortalNewTocAction(new DirectoryPath(this.config.configDir), commandMetadata);
+        const result = await action.execute(buildDirectory, tocDirectory, force, expandEndpoints, expandModels);
+        outro(result);
+        result.mapAll(() => { }, async () => {
+            const telemetryService = new TelemetryService(new DirectoryPath(this.config.configDir));
+            await telemetryService.trackEvent(
+            // TODO: fix Toc error message
+            new TocCreationFailedEvent("error", _a.id, {
+                input,
+                destination,
+                force,
+                "expand-endpoints": expandEndpoints,
+                "expand-models": expandModels
+            }), commandMetadata.shell);
+        }, () => { });
     }
 }
 _a = PortalTocNew;
-PortalTocNew.summary = 'Generates a TOC file based on the content directory and spec folder provided in your working directory';
+PortalTocNew.summary = "Generate a Table of Contents (TOC) file for your API documentation portal";
 PortalTocNew.description = `This command generates a new Table of Contents (TOC) file used in the
 generation of your API documentation portal.
 
 The output is a YAML file with the .yml extension.
 
 To learn more about the TOC file and APIMatic build directory structure, visit:
-https://docs.apimatic.io/platform-api/#/http/guides/generating-on-prem-api-portal/overview-generating-api-portal`;
-PortalTocNew.flags = {
-    destination: core_1.Flags.string({
-        parse: async (input) => path.resolve(input),
-        description: "optional path where the generated TOC file will be saved. Defaults to the current working directory if not provided.",
-    }),
-    folder: core_1.Flags.string({
-        parse: async (input) => path.resolve(input),
-        description: "path to the working directory containing the API project files. Defaults to the current working directory if not specified.",
-        default: DEFAULT_FOLDER
-    }),
-    force: core_1.Flags.boolean({
-        default: false,
-        description: "overwrite the TOC file if one already exists at the destination.",
-    }),
-    "expand-endpoints": core_1.Flags.boolean({
+${format.link("https://docs.apimatic.io/platform-api/#/http/guides/generating-on-prem-api-portal/overview-generating-api-portal")}`;
+PortalTocNew.flags = Object.assign(Object.assign(Object.assign(Object.assign({}, FlagsProvider.destination("src/content", `toc.yml`)), FlagsProvider.input), FlagsProvider.force), { "expand-endpoints": Flags.boolean({
         default: false,
-        description: "include individual entries for each endpoint in the generated TOC. Requires a valid API specification in the working directory."
-    }),
-    "expand-models": core_1.Flags.boolean({
+        description: `include individual entries for each endpoint in the generated ${format.var("toc.yml")}. Requires a valid API specification in the working directory.`
+    }), "expand-models": Flags.boolean({
         default: false,
-        description: "include individual entries for each model in the generated TOC. Requires a valid API specification in the working directory."
-    })
-};
+        description: `include individual entries for each model in the generated ${format.var("toc.yml")}. Requires a valid API specification in the working directory.`
+    }) });
+PortalTocNew.cmdTxt = format.cmd("apimatic", "portal", "toc", "new");
 PortalTocNew.examples = [
-    `$ apimatic portal:toc:new --destination="./portal/content/"
-A new toc file has been created at ./portal/content/toc.yml
-`,
-    `$ apimatic portal:toc:new --folder="./my-project" 
-A new toc file has been created at ./my-project/content/toc.yml
-`,
-    `$ apimatic portal:toc:new --folder="./my-project" --destination="./portal/content/"
-A new toc file has been created at ./portal/content/toc.yml
-`
+    `${_a.cmdTxt} ${format.flag("destination", './src/content/')}`,
+    `${_a.cmdTxt} ${format.flag("input", './')}`,
+    `${_a.cmdTxt} ${format.flag("input", './')} ${format.flag("destination", './src/content/')}`
 ];
-exports.default = PortalTocNew;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibmV3LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2NvbW1hbmRzL3BvcnRhbC90b2MvbmV3LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDZCQUE2QjtBQUM3QixzQ0FBNkM7QUFDN0MsaUVBQXlFO0FBRXpFLE1BQU0sY0FBYyxHQUFHLE9BQU8sQ0FBQyxHQUFHLEVBQUUsQ0FBQztBQUVyQyxNQUFxQixZQUFhLFNBQVEsY0FBTztJQStDL0MsWUFBWSxJQUFjLEVBQUUsTUFBVztRQUNyQyxLQUFLLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ3RCLENBQUM7SUFFRCxLQUFLLENBQUMsR0FBRztRQUNQLE1BQU0sRUFBRSxLQUFLLEVBQUUsR0FBRyxNQUFNLElBQUksQ0FBQyxLQUFLLENBQUMsRUFBWSxDQUFDLENBQUM7UUFDakQsTUFBTSxrQkFBa0IsR0FBRyxJQUFJLDRCQUFrQixFQUFFLENBQUM7UUFDcEQsTUFBTSxNQUFNLEdBQUcsTUFBTSxrQkFBa0IsQ0FBQyxTQUFTLENBQy9DLEtBQUssQ0FBQyxNQUFNLEVBQ1osSUFBSSxDQUFDLE1BQU0sQ0FBQyxTQUFTLEVBQ3JCLEtBQUssQ0FBQyxXQUFXLEVBQ2pCLEtBQUssQ0FBQyxLQUFLLEVBQ1gsS0FBSyxDQUFDLGtCQUFrQixDQUFDLEVBQ3pCLEtBQUssQ0FBQyxlQUFlLENBQUMsQ0FDdkIsQ0FBQztRQUVGLElBQUksTUFBTSxDQUFDLFFBQVEsRUFBRSxFQUFFLENBQUM7WUFDdEIsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsS0FBTSxDQUFDLENBQUM7UUFDNUIsQ0FBQztJQUNILENBQUM7OztBQWpFTSxvQkFBTyxHQUFHLHdHQUF3RyxBQUEzRyxDQUE0RztBQUVuSCx3QkFBVyxHQUFHOzs7Ozs7aUhBTTBGLEFBTjdGLENBTThGO0FBRXpHLGtCQUFLLEdBQUc7SUFDYixXQUFXLEVBQUUsWUFBSyxDQUFDLE1BQU0sQ0FBQztRQUN4QixLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQWEsRUFBRSxFQUFFLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUM7UUFDbkQsV0FBVyxFQUFFLHNIQUFzSDtLQUNwSSxDQUFDO0lBQ0YsTUFBTSxFQUFFLFlBQUssQ0FBQyxNQUFNLENBQUM7UUFDbkIsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFhLEVBQUUsRUFBRSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDO1FBQ25ELFdBQVcsRUFBRSw2SEFBNkg7UUFDMUksT0FBTyxFQUFFLGNBQWM7S0FDeEIsQ0FBQztJQUNGLEtBQUssRUFBRSxZQUFLLENBQUMsT0FBTyxDQUFDO1FBQ25CLE9BQU8sRUFBRSxLQUFLO1FBQ2QsV0FBVyxFQUFFLGtFQUFrRTtLQUNoRixDQUFDO0lBQ0Ysa0JBQWtCLEVBQUUsWUFBSyxDQUFDLE9BQU8sQ0FBQztRQUNoQyxPQUFPLEVBQUUsS0FBSztRQUNkLFdBQVcsRUFBRSxpSUFBaUk7S0FDL0ksQ0FBQztJQUNGLGVBQWUsRUFBRSxZQUFLLENBQUMsT0FBTyxDQUFDO1FBQzdCLE9BQU8sRUFBRSxLQUFLO1FBQ2QsV0FBVyxFQUFFLDhIQUE4SDtLQUM1SSxDQUFDO0NBQ0gsQUF0QlcsQ0FzQlY7QUFFSyxxQkFBUSxHQUFHO0lBQ2hCOztDQUVIO0lBQ0c7O0NBRUg7SUFDRzs7Q0FFSDtDQUNFLEFBVmMsQ0FVYjtrQkE3Q2lCLFlBQVkifQ==
+export default PortalTocNew;
+//# sourceMappingURL=new.js.map

package/lib/commands/portal/toc/new.js.map

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

package/lib/commands/quickstart.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "@oclif/core";
+export default class Quickstart extends Command {
+    static description: string;
+    static summary: string;
+    static cmdTxt: string;
+    static examples: string[];
+    run(): Promise<void>;
+    private readonly getConfigDir;
+}

package/lib/commands/quickstart.js

@@ -0,0 +1,37 @@
+var _a;
+import { Command } from "@oclif/core";
+import { format, intro, outro } from "../prompts/format.js";
+import { TelemetryService } from "../infrastructure/services/telemetry-service.js";
+import { DirectoryPath } from "../types/file/directoryPath.js";
+import { QuickstartInitiatedEvent } from "../types/events/quickstart-initiated.js";
+import { QuickstartAction } from "../actions/quickstart.js";
+import { QuickstartCompletedEvent } from "../types/events/quickstart-completed.js";
+class Quickstart extends Command {
+    constructor() {
+        super(...arguments);
+        this.getConfigDir = () => {
+            return new DirectoryPath(this.config.configDir);
+        };
+    }
+    async run() {
+        const telemetryService = new TelemetryService(this.getConfigDir());
+        const commandMetadata = {
+            commandName: _a.id,
+            shell: this.config.shell
+        };
+        await telemetryService.trackEvent(new QuickstartInitiatedEvent(), commandMetadata.shell);
+        intro("Quickstart");
+        const action = new QuickstartAction(this.getConfigDir(), commandMetadata);
+        const result = await action.execute();
+        outro(result);
+        // TODO: Remove this, find a solution for tracking.
+        await result.mapAll(async () => await telemetryService.trackEvent(new QuickstartCompletedEvent(), commandMetadata.shell), () => new Promise(() => { }), () => new Promise(() => { }));
+    }
+}
+_a = Quickstart;
+Quickstart.description = "Get started with your first SDK or API Portal in four easy steps.";
+Quickstart.summary = "Create your first SDK or API Portal using APIMatic.";
+Quickstart.cmdTxt = format.cmd("apimatic", "quickstart");
+Quickstart.examples = [_a.cmdTxt];
+export default Quickstart;
+//# sourceMappingURL=quickstart.js.map

package/lib/commands/quickstart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.js","sourceRoot":"","sources":["../../src/commands/quickstart.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAEnF,MAAqB,UAAW,SAAQ,OAAO;IAA/C;;QA+BmB,iBAAY,GAAG,GAAG,EAAE;YACnC,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC,CAAC;IACJ,CAAC;IAzBC,KAAK,CAAC,GAAG;QACP,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACnE,MAAM,eAAe,GAAoB;YACvC,WAAW,EAAE,EAAU,CAAC,EAAE;YAC1B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC;QAEF,MAAM,gBAAgB,CAAC,UAAU,CAAC,IAAI,wBAAwB,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;QAEzF,KAAK,CAAC,YAAY,CAAC,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,eAAe,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACtC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,mDAAmD;QACnD,MAAM,MAAM,CAAC,MAAM,CACjB,KAAK,IAAI,EAAE,CAAC,MAAM,gBAAgB,CAAC,UAAU,CAAC,IAAI,wBAAwB,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,EACpG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,EAC3B,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAC5B,CAAC;IACJ,CAAC;;;AA5BM,sBAAW,GAAG,mEAAmE,AAAtE,CAAuE;AAElF,kBAAO,GAAG,qDAAqD,AAAxD,CAAyD;AAEhE,iBAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,AAAvC,CAAwC;AAE9C,mBAAQ,GAAG,CAAC,EAAI,CAAC,MAAM,CAAC,AAAhB,CAAiB;eAPb,UAAU"}

package/lib/commands/sdk/generate.d.ts

@@ -1,15 +1,17 @@
 import { Command } from "@oclif/core";
 export default class SdkGenerate extends Command {
-    static description: string;
+    static readonly summary = "Generate an SDK for your API";
+    static readonly description = "Generate Software Development Kits (SDKs) from API specifications.\nSupports multiple programming languages including Java, C#, Python, JavaScript, and more.";
+    static readonly cmdTxt: string;
     static flags: {
-        platform: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        file: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        url: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        destination: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        zip: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        "auth-key": import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        "auth-key": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        zip: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        language: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        spec: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        destination: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     static examples: string[];
     run(): Promise<void>;
+    private readonly getConfigDir;
 }