@apimatic/cli 1.5.0 → 2.0.0-beta.1

package/lib/commands/portal/generate.js

@@ -1,35 +1,44 @@
-var _a;
-import { Command, Flags } from "@oclif/core";
-import { DirectoryPath } from "../../types/file/directoryPath.js";
-import { GenerateAction } from "../../actions/portal/generate.js";
-import { FlagsProvider } from "../../types/flags-provider.js";
-import { format, intro, outro } from "../../prompts/format.js";
-export class PortalGenerate extends Command {
+import { Command, Flags } from '@oclif/core';
+import { DirectoryPath } from '../../types/file/directoryPath.js';
+import { GenerateAction } from '../../actions/portal/generate.js';
+import { FlagsProvider } from '../../types/flags-provider.js';
+import { format, intro, outro } from '../../prompts/format.js';
+import { ProjectContext } from '../../types/project-context.js';
+export default class PortalGenerate extends Command {
+    static summary = 'Generate a static API Documentation Portal.';
+    static description = `Builds a documentation portal from the OpenAPI documents and Markdown pages in your 'src' directory.
+
+The portal is built on your machine and written as static files you can host anywhere. Configure it with 'src/apimatic.json', whose 'languages' block gives the portal a page for each SDK language, and whose 'plugin' block, or a 'pluginUrl' in its 'portal' block for a plugin hosted elsewhere, a page for the context plugin.`;
+    static cmdTxt = format.cmd('apimatic', 'portal', 'generate');
+    static examples = [
+        PortalGenerate.cmdTxt,
+        `${PortalGenerate.cmdTxt} ${format.flag('input', './')} ${format.flag('destination', './portal')}`,
+        `${PortalGenerate.cmdTxt} ${format.flag('zip')}`
+    ];
+    static flags = {
+        zip: Flags.boolean({
+            default: false,
+            description: 'write the generated portal as a .zip archive.'
+        }),
+        ...FlagsProvider.input,
+        ...FlagsProvider.destination('portal', 'portal'),
+        ...FlagsProvider.force,
+        ...FlagsProvider.authKey
+    };
     async run() {
-        const { flags: { input, destination, force, zip: zipPortal, "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 { flags: { input, destination, force, zip: zipPortal, 'auth-key': authKey } } = await this.parse(PortalGenerate);
+        const project = ProjectContext.at(input);
         const commandMetadata = {
-            commandName: _a.id,
+            commandName: PortalGenerate.id,
             shell: this.config.shell
         };
-        intro("Generate Portal");
-        const action = new GenerateAction(new DirectoryPath(this.config.configDir), commandMetadata, authKey);
-        const result = await action.execute(buildDirectory, portalDirectory, force, zipPortal);
+        intro('Generate Portal');
+        const action = new GenerateAction(this.getConfigDir(), commandMetadata, authKey);
+        const result = await action.execute(project, project.portalDirectory(destination), force, zipPortal);
         outro(result);
     }
+    getConfigDir = () => {
+        return new DirectoryPath(this.config.configDir);
+    };
 }
-_a = PortalGenerate;
-PortalGenerate.summary = "Generate Context Plugins and API Documentation Portal with AI Assist Features.";
-PortalGenerate.description = "Generate an API Documentation portal. Requires an input directory containing API specifications, a config file and optionally, markdown guides. For details, refer to the [documentation](https://docs.apimatic.io/platform-api/#/http/guides/generating-on-prem-api-portal/build-file-reference)";
-PortalGenerate.flags = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, FlagsProvider.input), FlagsProvider.destination("portal", "portal")), FlagsProvider.force), { zip: Flags.boolean({
-        default: false,
-        description: "Download the generated portal as a .zip archive"
-    }) }), FlagsProvider.authKey);
-PortalGenerate.cmdTxt = format.cmd("apimatic", "portal", "generate");
-PortalGenerate.examples = [
-    _a.cmdTxt,
-    `${_a.cmdTxt} ${format.flag("input", '"./"')} ${format.flag("destination", '"./portal"')}`
-];
 //# sourceMappingURL=generate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/commands/portal/generate.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAG/D,MAAM,OAAO,cAAe,SAAQ,OAAO;IAuBzC,KAAK,CAAC,GAAG;QACP,MAAM,EACJ,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,EAC1E,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAc,CAAC,CAAC;QAErC,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;QAC9F,MAAM,eAAe,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvG,MAAM,eAAe,GAAoB;YACvC,WAAW,EAAE,EAAc,CAAC,EAAE;YAC9B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC;QAEF,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QACtG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QACvF,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;;;AAvCM,sBAAO,GAAG,gFAAgF,AAAnF,CAAoF;AAE3F,0BAAW,GAChB,mSAAmS,AADnR,CACoR;AAE/R,oBAAK,6EACP,aAAa,CAAC,KAAK,GACnB,aAAa,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAC7C,aAAa,CAAC,KAAK,KACtB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;QACjB,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,iDAAiD;KAC/D,CAAC,KACC,aAAa,CAAC,OAAO,CARd,CASV;AAEK,qBAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,AAA/C,CAAgD;AACtD,uBAAQ,GAAG;IAChB,EAAI,CAAC,MAAM;IACX,GAAG,EAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,EAAE;CAC7F,AAHc,CAGb"}
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/commands/portal/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,MAAM,CAAU,OAAO,GAAG,6CAA6C,CAAC;IAExE,MAAM,CAAU,WAAW,GAAG;;oUAEoS,CAAC;IAEnU,MAAM,CAAU,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEtE,MAAM,CAAU,QAAQ,GAAG;QACzB,cAAc,CAAC,MAAM;QACrB,GAAG,cAAc,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EAAE;QAClG,GAAG,cAAc,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;KACjD,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;YACjB,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,+CAA+C;SAC7D,CAAC;QACF,GAAG,aAAa,CAAC,KAAK;QACtB,GAAG,aAAa,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAChD,GAAG,aAAa,CAAC,KAAK;QACtB,GAAG,aAAa,CAAC,OAAO;KACzB,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EACJ,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,EAC1E,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAErC,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,eAAe,GAAoB;YACvC,WAAW,EAAE,cAAc,CAAC,EAAE;YAC9B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC;QAEF,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QACrG,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAEgB,YAAY,GAAG,GAAG,EAAE;QACnC,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC,CAAC;CACH"}

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

@@ -1,16 +1,14 @@
-import { Command } from "@oclif/core";
+import { Command } from '@oclif/core';
 export default class PortalServe extends Command {
-    static summary: string;
-    static description: string;
+    static readonly summary = "Preview your API Documentation Portal with live reload.";
+    static readonly description = "Serves the portal described by 'src/apimatic.json' from your machine, reloading the browser as you edit the Markdown pages in 'src/content', reorder them in a 'nav.json', or change the 'portal', 'languages' or 'plugin' block of 'apimatic.json'.\n\nAdding a language or a 'plugin' block, adding or removing a page in 'src/content', creating 'src/static', or changing which documents are in 'src/spec', needs the preview restarted.\n\nNothing is written to disk; run 'apimatic portal generate' to produce the static files.";
+    static readonly cmdTxt: string;
+    static readonly examples: string[];
     static flags: {
         "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>;
+        open: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    static cmdTxt: string;
-    static examples: string[];
     run(): Promise<void>;
-    private getConfigDir;
+    private readonly getConfigDir;
 }

package/lib/commands/portal/serve.js

@@ -1,53 +1,50 @@
-var _a;
-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 {
+import { Command, Flags } from '@oclif/core';
+import { DEFAULT_PORTAL_PORT, PortalServeAction } from '../../actions/portal/serve.js';
+import { DirectoryPath } from '../../types/file/directoryPath.js';
+import { FlagsProvider } from '../../types/flags-provider.js';
+import { ProjectContext } from '../../types/project-context.js';
+import { format, intro, outro } from '../../prompts/format.js';
+const defaultPortText = String(DEFAULT_PORTAL_PORT);
+export default class PortalServe extends Command {
+    static summary = 'Preview your API Documentation Portal with live reload.';
+    static description = `Serves the portal described by 'src/apimatic.json' from your machine, reloading the browser as you edit the Markdown pages in 'src/content', reorder them in a 'nav.json', or change the 'portal', 'languages' or 'plugin' block of 'apimatic.json'.
+
+Adding a language or a 'plugin' block, adding or removing a page in 'src/content', creating 'src/static', or changing which documents are in 'src/spec', needs the preview restarted.
+
+Nothing is written to disk; run 'apimatic portal generate' to produce the static files.`;
+    static cmdTxt = format.cmd('apimatic', 'portal', 'serve');
+    static examples = [
+        PortalServe.cmdTxt,
+        `${PortalServe.cmdTxt} ${format.flag('input', './')} ${format.flag('port', defaultPortText)} ${format.flag('open')}`
+    ];
+    static flags = {
+        port: Flags.integer({
+            char: 'p',
+            description: 'port to serve the portal on.',
+            default: DEFAULT_PORTAL_PORT,
+            helpValue: defaultPortText
+        }),
+        open: Flags.boolean({
+            char: 'o',
+            description: 'open the portal in the default browser.',
+            default: false
+        }),
+        ...FlagsProvider.input,
+        ...FlagsProvider.authKey
+    };
     async run() {
-        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 { flags: { input, port, open, 'auth-key': authKey } } = await this.parse(PortalServe);
         const commandMetadata = {
-            commandName: _a.id,
+            commandName: PortalServe.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);
+        intro('Portal Serve');
+        const action = new PortalServeAction(this.getConfigDir(), commandMetadata, authKey);
+        const result = await action.execute(ProjectContext.at(input), port, open);
         outro(result);
     }
-    getConfigDir() {
+    getConfigDir = () => {
         return new DirectoryPath(this.config.configDir);
-    }
+    };
 }
-_a = PortalServe;
-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: 23513,
-        helpValue: "23513"
-    }) }, FlagsProvider.input), FlagsProvider.destination("portal", "portal")), { open: Flags.boolean({
-        char: "o",
-        description: "open the portal in the default browser.",
-        default: false
-    }), "no-reload": Flags.boolean({
-        description: "disable hot reload.",
-        default: false
-    }) }), FlagsProvider.authKey);
-PortalServe.cmdTxt = format.cmd("apimatic", "portal", "serve");
-PortalServe.examples = [
-    _a.cmdTxt,
-    `${_a.cmdTxt} ` +
-        `${format.flag("input", './')} ` +
-        `${format.flag("destination", './portal')} ` +
-        `${format.flag("port", "23513")} ` +
-        `${format.flag("open")} ` +
-        `${format.flag("no-reload")}`
-];
-export default PortalServe;
 //# sourceMappingURL=serve.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/commands/portal/serve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/commands/portal/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,eAAe,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,MAAM,CAAU,OAAO,GAAG,yDAAyD,CAAC;IAEpF,MAAM,CAAU,WAAW,GAAG;;;;wFAIwD,CAAC;IAEvF,MAAM,CAAU,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEnE,MAAM,CAAU,QAAQ,GAAG;QACzB,WAAW,CAAC,MAAM;QAClB,GAAG,WAAW,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;KACrH,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,8BAA8B;YAC3C,OAAO,EAAE,mBAAmB;YAC5B,SAAS,EAAE,eAAe;SAC3B,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,yCAAyC;YACtD,OAAO,EAAE,KAAK;SACf,CAAC;QACF,GAAG,aAAa,CAAC,KAAK;QACtB,GAAG,aAAa,CAAC,OAAO;KACzB,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EACJ,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAClD,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAElC,MAAM,eAAe,GAAoB;YACvC,WAAW,EAAE,WAAW,CAAC,EAAE;YAC3B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC;QAEF,KAAK,CAAC,cAAc,CAAC,CAAC;QACtB,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QACpF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1E,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAEgB,YAAY,GAAG,GAAG,EAAE;QACnC,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC,CAAC;CACH"}

package/lib/commands/publishing/profile/list.js

@@ -2,13 +2,11 @@ import { Command } from '@oclif/core';
 import { DirectoryPath } from '../../../types/file/directoryPath.js';
 import { format, intro, outro } from '../../../prompts/format.js';
 import { PublishingProfileListAction } from '../../../actions/publishing/profile/list.js';
-class PublishingProfileList extends Command {
-    constructor() {
-        super(...arguments);
-        this.getConfigDir = () => {
-            return new DirectoryPath(this.config.configDir);
-        };
-    }
+export default class PublishingProfileList extends Command {
+    static summary = 'List all publishing profiles';
+    static description = `Display all publishing profiles associated with your account, including each profile's name, ID and enabled languages.`;
+    static cmdTxt = format.cmd('apimatic', 'publishing', 'profile', 'list');
+    static examples = [PublishingProfileList.cmdTxt];
     async run() {
         const commandMetadata = {
             commandName: PublishingProfileList.id,
@@ -19,10 +17,8 @@ class PublishingProfileList extends Command {
         const result = await action.execute();
         outro(result);
     }
+    getConfigDir = () => {
+        return new DirectoryPath(this.config.configDir);
+    };
 }
-PublishingProfileList.summary = 'List all publishing profiles';
-PublishingProfileList.description = `Display all publishing profiles associated with your account, including each profile's name, ID and enabled languages.`;
-PublishingProfileList.cmdTxt = format.cmd('apimatic', 'publishing', 'profile', 'list');
-PublishingProfileList.examples = [PublishingProfileList.cmdTxt];
-export default PublishingProfileList;
 //# sourceMappingURL=list.js.map

package/lib/commands/publishing/profile/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/publishing/profile/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAE1F,MAAqB,qBAAsB,SAAQ,OAAO;IAA1D;;QAqBmB,iBAAY,GAAG,GAAG,EAAE;YACnC,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC,CAAC;IACJ,CAAC;IAfC,KAAK,CAAC,GAAG;QACP,MAAM,eAAe,GAAoB;YACvC,WAAW,EAAE,qBAAqB,CAAC,EAAE;YACrC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC;QAEF,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,2BAA2B,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,eAAe,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACtC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;;AAlBe,6BAAO,GAAG,8BAA8B,AAAjC,CAAkC;AAEzC,iCAAW,GAAG,wHAAwH,AAA3H,CAA4H;AAE/H,4BAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,AAA1D,CAA2D;AAElF,8BAAQ,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAC,AAAjC,CAAkC;eAP9B,qBAAqB"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/publishing/profile/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAE1F,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,OAAO;IACxD,MAAM,CAAU,OAAO,GAAG,8BAA8B,CAAC;IAEzD,MAAM,CAAU,WAAW,GAAG,wHAAwH,CAAC;IAE/I,MAAM,CAAU,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAEzF,MAAM,CAAC,QAAQ,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEjD,KAAK,CAAC,GAAG;QACP,MAAM,eAAe,GAAoB;YACvC,WAAW,EAAE,qBAAqB,CAAC,EAAE;YACrC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC;QAEF,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,2BAA2B,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,eAAe,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACtC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAEgB,YAAY,GAAG,GAAG,EAAE;QACnC,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC,CAAC;CACH"}

package/lib/commands/quickstart.d.ts

@@ -1,9 +1,9 @@
-import { Command } from "@oclif/core";
+import { Command } from '@oclif/core';
 export default class Quickstart extends Command {
-    static description: string;
-    static summary: string;
-    static cmdTxt: string;
-    static examples: string[];
+    static readonly description = "Point the CLI at your API specification and it builds a documentation portal, SDKs, and a context plugin that teaches an AI coding assistant to use them.";
+    static readonly summary = "Create your first API Documentation Portal, SDKs and Context Plugins.";
+    static readonly cmdTxt: string;
+    static readonly examples: string[];
     run(): Promise<void>;
     private readonly getConfigDir;
 }

package/lib/commands/quickstart.js

@@ -1,37 +1,31 @@
-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);
-        };
-    }
+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';
+export default class Quickstart extends Command {
+    static description = 'Point the CLI at your API specification and it builds a documentation portal, SDKs, and a context plugin that teaches an AI coding assistant to use them.';
+    static summary = 'Create your first API Documentation Portal, SDKs and Context Plugins.';
+    static cmdTxt = format.cmd('apimatic', 'quickstart');
+    static examples = [Quickstart.cmdTxt];
     async run() {
         const telemetryService = new TelemetryService(this.getConfigDir());
         const commandMetadata = {
-            commandName: _a.id,
+            commandName: Quickstart.id,
             shell: this.config.shell
         };
         await telemetryService.trackEvent(new QuickstartInitiatedEvent(), commandMetadata.shell);
-        intro("Quickstart");
+        intro('Quickstart');
         const action = new QuickstartAction(this.getConfigDir(), commandMetadata);
-        const result = await action.execute();
+        const result = await action.execute(DirectoryPath.default);
         outro(result);
         // TODO: Remove this, find a solution for tracking.
         await result.mapAll(async () => await telemetryService.trackEvent(new QuickstartCompletedEvent(), commandMetadata.shell), async () => { }, async () => { });
     }
+    getConfigDir = () => {
+        return new DirectoryPath(this.config.configDir);
+    };
 }
-_a = Quickstart;
-Quickstart.description = "Get started with your first SDK or API Portal in four easy steps.";
-Quickstart.summary = "Create your first API Portal, Context Plugins and SDKs, or a standalone SDK, 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

@@ -1 +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,KAAK,IAAI,EAAE,GAAE,CAAC,EACd,KAAK,IAAI,EAAE,GAAE,CAAC,CACf,CAAC;IACJ,CAAC;;;AA5BM,sBAAW,GAAG,mEAAmE,AAAtE,CAAuE;AAElF,kBAAO,GAAG,8FAA8F,AAAjG,CAAkG;AAEzG,iBAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,AAAvC,CAAwC;AAE9C,mBAAQ,GAAG,CAAC,EAAI,CAAC,MAAM,CAAC,AAAhB,CAAiB;eAPb,UAAU"}
+{"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,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,MAAM,CAAU,WAAW,GACzB,2JAA2J,CAAC;IAE9J,MAAM,CAAU,OAAO,GAAG,uEAAuE,CAAC;IAElG,MAAM,CAAU,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE9D,MAAM,CAAU,QAAQ,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAE/C,KAAK,CAAC,GAAG;QACP,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACnE,MAAM,eAAe,GAAoB;YACvC,WAAW,EAAE,UAAU,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,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC3D,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,KAAK,IAAI,EAAE,GAAE,CAAC,EACd,KAAK,IAAI,EAAE,GAAE,CAAC,CACf,CAAC;IACJ,CAAC;IAEgB,YAAY,GAAG,GAAG,EAAE;QACnC,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC,CAAC;CACH"}

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

@@ -1,19 +1,17 @@
-import { Command } from "@oclif/core";
+import { Command } from '@oclif/core';
 export default class SdkGenerate extends Command {
     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 description = "Generate a Software Development Kit (SDK) from an API specification.\nC#, TypeScript and Python are available; Java, Ruby, Go and PHP are on their way.";
     static readonly cmdTxt: string;
     static flags: {
         "auth-key": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         language: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         destination: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        "skip-changes": import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        "api-version": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         zip: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        "track-changes": import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        "codegen-version": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        stability: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'codegen-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        stability: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     static examples: string[];
     run(): Promise<void>;

package/lib/commands/sdk/generate.js

@@ -1,80 +1,68 @@
-import { Command, Flags } from "@oclif/core";
-import { DirectoryPath } from "../../types/file/directoryPath.js";
-import { FlagsProvider } from "../../types/flags-provider.js";
-import { GenerateAction } from "../../actions/sdk/generate.js";
-import { CodeGenerationVersion, CodegenOption, Language, Stability } from "../../types/sdk/generate.js";
-import { format, intro, outro } from "../../prompts/format.js";
-import { SdkChangesTrackedEvent } from "../../types/events/sdk-changes-tracked.js";
-import { TelemetryService } from "../../infrastructure/services/telemetry-service.js";
-import { SdkConflictsResolvedEvent } from "../../types/events/sdk-conflicts-resolved.js";
-class SdkGenerate extends Command {
-    constructor() {
-        super(...arguments);
-        this.getConfigDir = () => {
-            return new DirectoryPath(this.config.configDir);
-        };
-    }
+import { Command, Flags } from '@oclif/core';
+import { DirectoryPath } from '../../types/file/directoryPath.js';
+import { FlagsProvider } from '../../types/flags-provider.js';
+import { GenerateAction } from '../../actions/sdk/generate.js';
+import { CodeGenerationVersion, Language, Stability } from '../../types/sdk/generate.js';
+import { StabilityChoice } from '../../types/sdk/stability-choice.js';
+import { ProjectContext } from '../../types/project-context.js';
+import { format, intro, outro } from '../../prompts/format.js';
+export default class SdkGenerate extends Command {
+    static summary = 'Generate an SDK for your API';
+    static description = `Generate a Software Development Kit (SDK) from an API specification.
+C#, TypeScript and Python are available; Java, Ruby, Go and PHP are on their way.`;
+    static cmdTxt = format.cmd('apimatic', 'sdk', 'generate');
+    static flags = {
+        // Every language stays here so one that is coming back is answered by the command rather than
+        // rejected as an unknown value; the action says which are available.
+        language: Flags.string({
+            char: 'l',
+            required: true,
+            description: 'Programming language for SDK generation',
+            options: Object.values(Language).map((p) => p.valueOf())
+        }),
+        destination: Flags.string({
+            char: 'd',
+            description: '[default: <input>/sdk/<language> | <input>/sdk/<api-version>/<language>] path where the SDK will be generated'
+        }),
+        'api-version': Flags.string({
+            description: 'Version of the API to use for SDK generation (if multiple versions exist)'
+        }),
+        zip: Flags.boolean({
+            default: false,
+            description: 'Download the generated SDK as a .zip archive'
+        }),
+        'codegen-version': Flags.string({
+            description: 'Version of the code generator to use',
+            options: Object.values(CodeGenerationVersion).map((v) => v.valueOf()),
+            default: CodeGenerationVersion.V4
+        }),
+        stability: Flags.string({
+            description: 'Stability level of the generated SDK. Defaults to the level the language offers.',
+            options: Object.values(Stability).map((s) => s.valueOf())
+        }),
+        ...FlagsProvider.input,
+        ...FlagsProvider.force,
+        ...FlagsProvider.authKey
+    };
+    static examples = [
+        `${SdkGenerate.cmdTxt} ${format.flag('language', 'typescript')}`,
+        `${SdkGenerate.cmdTxt} ${format.flag('language', 'csharp')} ${format.flag('input', './')}`,
+        `${SdkGenerate.cmdTxt} ${format.flag('language', 'python')} ${format.flag('destination', './sdk')} ${format.flag('zip')}`
+    ];
     async run() {
-        var _a;
-        const { flags: { language, input, destination, force, zip: zipSdk, "auth-key": authKey, "skip-changes": skipChanges, "track-changes": trackChanges, "api-version": apiVersion, "codegen-version": codegenVersion, stability }, metadata } = await this.parse(SdkGenerate);
-        const workingDirectory = DirectoryPath.createInput(input);
-        const buildDirectory = input ? new DirectoryPath(input, "src") : workingDirectory.join("src");
-        const sdkDirectory = destination ? new DirectoryPath(destination) : workingDirectory.join("sdk");
+        const { flags: { language, input, destination, force, zip: zipSdk, stability, 'auth-key': authKey, 'api-version': apiVersion } } = await this.parse(SdkGenerate);
+        const project = ProjectContext.at(input);
         const commandMetadata = {
             commandName: SdkGenerate.id,
             shell: this.config.shell
         };
-        const telemetryService = new TelemetryService(this.getConfigDir());
-        intro("Generate SDK");
+        intro('Generate SDK');
         const action = new GenerateAction(this.getConfigDir(), commandMetadata, authKey);
-        const result = await action.execute(buildDirectory, sdkDirectory, language, force, zipSdk, skipChanges, trackChanges, CodegenOption.create(codegenVersion, stability), ((_a = metadata.flags.stability) === null || _a === void 0 ? void 0 : _a.setFromDefault) !== true, apiVersion);
+        const result = await action.execute(project, project.sdkDirectory(destination), language, StabilityChoice.for(language, stability).stabilityLevel(), force, zipSdk, apiVersion);
         outro(result);
-        await result.mapAll(async (res) => {
-            if (res === null || res === void 0 ? void 0 : res.sourceTreeTrackingInitiated) {
-                await telemetryService.trackEvent(new SdkChangesTrackedEvent(language), commandMetadata.shell);
-            }
-            if (res === null || res === void 0 ? void 0 : res.conflictsResolved) {
-                await telemetryService.trackEvent(new SdkConflictsResolvedEvent(language), commandMetadata.shell);
-            }
-        }, async () => { }, async () => { });
     }
+    getConfigDir = () => {
+        return new DirectoryPath(this.config.configDir);
+    };
 }
-SdkGenerate.summary = "Generate an SDK for your API";
-SdkGenerate.description = `Generate Software Development Kits (SDKs) from API specifications.
-Supports multiple programming languages including Java, C#, Python, JavaScript, and more.`;
-SdkGenerate.cmdTxt = format.cmd("apimatic", "sdk", "generate");
-SdkGenerate.flags = Object.assign(Object.assign(Object.assign({ language: Flags.string({
-        char: "l",
-        required: true,
-        description: "Programming language for SDK generation",
-        options: Object.values(Language).map((p) => p.valueOf()),
-    }), destination: Flags.string({
-        char: "d",
-        description: "[default: <input>/sdk/<language> | <input>/sdk/<api-version>/<language>] path where the SDK will be generated"
-    }), "skip-changes": Flags.boolean({
-        default: false,
-        description: "Do not apply the saved changes to the generated SDK"
-    }), "api-version": Flags.string({
-        description: "Version of the API to use for SDK generation (if multiple versions exist)"
-    }), zip: Flags.boolean({
-        default: false,
-        description: "Download the generated SDK as a .zip archive"
-    }), "track-changes": Flags.boolean({
-        default: false,
-        description: "Enable change tracking for SDK generation (only required for initial setup)"
-    }), "codegen-version": Flags.string({
-        description: "Version of the code generator to use",
-        options: Object.values(CodeGenerationVersion).map((v) => v.valueOf()),
-        default: CodeGenerationVersion.V3
-    }), "stability": Flags.string({
-        description: "Stability level of the generated SDK",
-        options: Object.values(Stability).map((s) => s.valueOf()),
-        default: Stability.STABLE
-    }) }, FlagsProvider.input), FlagsProvider.force), FlagsProvider.authKey);
-SdkGenerate.examples = [
-    `${SdkGenerate.cmdTxt} ${format.flag("language", "java")}`,
-    `${SdkGenerate.cmdTxt} ${format.flag("language", "csharp")} ${format.flag("input", "./")}`,
-    `${SdkGenerate.cmdTxt} ${format.flag("language", "python")} ${format.flag("destination", "./sdk")} ${format.flag("zip")}`
-];
-export default SdkGenerate;
 //# sourceMappingURL=generate.js.map

package/lib/commands/sdk/generate.js.map

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

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

@@ -4,16 +4,15 @@ export default class SdkPublish extends Command {
     static readonly description = "Generate and publish an SDK using a publishing profile configured in the APIMatic App. Requires an input directory containing the API specification. Run without flags for a step-by-step interactive experience, or pass all required flags for CI/CD automation.";
     static readonly cmdTxt: string;
     static flags: {
-        'publish-type': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'codegen-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        stability: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'update-plugin-config': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        language: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         destination: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'profile-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         version: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        language: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'publish-type': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'codegen-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        stability: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     static examples: string[];
     run(): Promise<void>;