@apimatic/cli 1.1.0-alpha.2 → 1.1.0-alpha.20

package/README.md

@@ -1,5 +1,6 @@
 @apimatic/cli
 =============
+apimatic is in Alpha.
 
 The official CLI for APIMatic.
 
@@ -8,18 +9,22 @@ The official CLI for APIMatic.
 [![Downloads/week](https://img.shields.io/npm/dw/@apimatic/cli.svg)](https://npmjs.org/package/@apimatic/cli)
 [![License](https://img.shields.io/npm/l/@apimatic/cli.svg)](https://github.com/apimatic/apimatic-cli/blob/master/package.json)
 
-<!-- toc -->
-* [Usage](#usage)
-* [Commands](#commands)
-<!-- tocstop -->
+# Getting Started
+
+To get started with APIMatic's CLI using a step by step wizard, run the following command: 
+
+```sh-session
+$ apimatic portal:quickstart
+```
+
 # Usage
 <!-- usage -->
 ```sh-session
-$ npm install -g @apimatic/cli@1.0.1-alpha.3
+$ npm install -g @apimatic/cli
 $ apimatic COMMAND
 running command...
-$ apimatic (-v|--version|version)
-@apimatic/cli/0.0.0-alpha.3 linux-x64 node-v16.13.0
+$ apimatic (--version)
+@apimatic/cli/1.1.0-alpha.19 win32-x64 node-v20.18.3
 $ apimatic --help [COMMAND]
 USAGE
   $ apimatic COMMAND
@@ -36,7 +41,12 @@ USAGE
 * [`apimatic auth:status`](#apimatic-authstatus)
 * [`apimatic autocomplete [SHELL]`](#apimatic-autocomplete-shell)
 * [`apimatic help [COMMAND]`](#apimatic-help-command)
+* [`apimatic portal:copilot`](#apimatic-portalcopilot)
 * [`apimatic portal:generate`](#apimatic-portalgenerate)
+* [`apimatic portal:quickstart`](#apimatic-portalquickstart)
+* [`apimatic portal:recipe:new`](#apimatic-portalrecipenew)
+* [`apimatic portal:serve`](#apimatic-portalserve)
+* [`apimatic portal:toc:new`](#apimatic-portaltocnew)
 * [`apimatic sdk:generate`](#apimatic-sdkgenerate)
 
 ## `apimatic api:transform`
@@ -45,33 +55,31 @@ Transform API specifications from one format to another. Supports [10+ different
 
 ```
 USAGE
-  $ apimatic api:transform
-
-OPTIONS
-  -f, --force                overwrite if same file exist in the destination
-  --auth-key=auth-key        override current authentication state with an authentication key
-
-  --destination=destination  [default: /home/runner/work/apimatic-cli/apimatic-cli/cli] directory to download
-                             transformed file to
-
-  --file=file                path to the API specification file to transform
-
-  --format=format            (required) specification format to transform API specification into
+  $ apimatic api:transform --format <value> [--file <value>] [--url <value>] [-d <value>] [-f] [-k <value>]
+
+FLAGS
+  -d, --destination=<value>  [default: ./] directory to download transformed file to
+  -f, --force                overwrite changes without asking for user consent.
+  -k, --auth-key=<value>     override current authentication state with an authentication key.
+      --file=<value>         path to the API specification file to transform
+      --format=<value>       (required) specification format to transform API specification into
                              APIMATIC|WADL2009|WSDL|SWAGGER10|SWAGGER20|SWAGGERYAML|OAS3|OPENAPI3YAML|APIBLUEPRINT|RAML|
                              RAML10|POSTMAN10|POSTMAN20|GRAPHQLSCHEMA
-
-  --url=url                  URL to the API specification file to transform. Can be used in place of the --file option
+      --url=<value>          URL to the API specification file to transform. Can be used in place of the --file option
                              if the API specification is publicly available.
 
+DESCRIPTION
+  Transform API specifications from one format to another. Supports [10+ different
+  formats](https://www.apimatic.io/transformer/#supported-formats) including OpenApi/Swagger, RAML, WSDL and Postman
+  Collections.
+
 EXAMPLES
   $ apimatic api:transform --format="OpenApi3Json" --file="./specs/sample.json" --destination="D:/"
-  Success! Your transformed file is located at D:/Transformed_OpenApi3Json.json
 
   $ apimatic api:transform --format=RAML --url="https://petstore.swagger.io/v2/swagger.json"  --destination="D:/"
-  Success! Your transformed file is located at D:/swagger_raml.yaml
 ```
 
-_See code: [src/commands/api/transform.ts](https://github.com/apimatic/apimatic-cli/blob/v0.0.0-alpha.3/src/commands/api/transform.ts)_
+_See code: [src/commands/api/transform.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/api/transform.ts)_
 
 ## `apimatic api:validate`
 
@@ -79,24 +87,24 @@ Validate the syntactic and semantic correctness of an API specification
 
 ```
 USAGE
-  $ apimatic api:validate
+  $ apimatic api:validate [--file <value>] [--url <value>] [-k <value>]
 
-OPTIONS
-  --auth-key=auth-key  override current authentication state with an authentication key
-  --file=file          Path to the API specification file to validate
+FLAGS
+  -k, --auth-key=<value>  override current authentication state with an authentication key.
+      --file=<value>      Path to the API specification file to validate
+      --url=<value>       URL to the specification file to validate. Can be used in place of the --file option if the
+                          API specification is publicly available.
 
-  --url=url            URL to the specification file to validate. Can be used in place of the --file option if the API
-                       specification is publicly available.
+DESCRIPTION
+  Validate the syntactic and semantic correctness of an API specification
 
 EXAMPLES
   $ apimatic api:validate --file="./specs/sample.json"
-  Specification file provided is valid
 
   $ apimatic api:validate --url=https://petstore.swagger.io/v2/swagger.json
-  Specification file provided is valid
 ```
 
-_See code: [src/commands/api/validate.ts](https://github.com/apimatic/apimatic-cli/blob/v0.0.0-alpha.3/src/commands/api/validate.ts)_
+_See code: [src/commands/api/validate.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/api/validate.ts)_
 
 ## `apimatic auth:login`
 
@@ -104,68 +112,73 @@ Login using your APIMatic credentials or an API Key
 
 ```
 USAGE
-  $ apimatic auth:login
+  $ apimatic auth:login [-k <value>]
+
+FLAGS
+  -k, --auth-key=<value>  Sets authentication key for all commands.
 
-OPTIONS
-  --auth-key=auth-key  Set authentication key for all commands
+DESCRIPTION
+  Login using your APIMatic credentials or an API Key
 
 EXAMPLES
   $ apimatic auth:login
-  Please enter your registered email: apimatic-user@gmail.com
-  Please enter your password: *********
-
-  You have successfully logged into APIMatic
 
-  $ apimatic auth:login --auth-key=xxxxxx
-  Authentication key successfully set
+  $ apimatic auth:login --auth-key={api-key}
 ```
 
-_See code: [src/commands/auth/login.ts](https://github.com/apimatic/apimatic-cli/blob/v0.0.0-alpha.3/src/commands/auth/login.ts)_
+_See code: [src/commands/auth/login.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/auth/login.ts)_
 
 ## `apimatic auth:logout`
 
-Clear local login credentials
+Clears the local login credentials.
 
 ```
 USAGE
   $ apimatic auth:logout
 
-EXAMPLE
+DESCRIPTION
+  Clears the local login credentials.
+
+EXAMPLES
   $ apimatic auth:logout
-  Logged out
 ```
 
-_See code: [src/commands/auth/logout.ts](https://github.com/apimatic/apimatic-cli/blob/v0.0.0-alpha.3/src/commands/auth/logout.ts)_
+_See code: [src/commands/auth/logout.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/auth/logout.ts)_
 
 ## `apimatic auth:status`
 
-View current authentication state
+View the currently logged in user.
 
 ```
 USAGE
   $ apimatic auth:status
 
-EXAMPLE
+DESCRIPTION
+  View the currently logged in user.
+
+EXAMPLES
   $ apimatic auth:status
-  Currently logged in as apimatic-client@gmail.com
 ```
 
-_See code: [src/commands/auth/status.ts](https://github.com/apimatic/apimatic-cli/blob/v0.0.0-alpha.3/src/commands/auth/status.ts)_
+_See code: [src/commands/auth/status.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/auth/status.ts)_
 
 ## `apimatic autocomplete [SHELL]`
 
-display autocomplete installation instructions
+Display autocomplete installation instructions.
 
 ```
 USAGE
-  $ apimatic autocomplete [SHELL]
+  $ apimatic autocomplete [SHELL] [-r]
 
 ARGUMENTS
   SHELL  shell type
 
-OPTIONS
+FLAGS
   -r, --refresh-cache  Refresh cache (ignores displaying instructions)
 
+DESCRIPTION
+  Display autocomplete installation instructions.
+
 EXAMPLES
   $ apimatic autocomplete
   $ apimatic autocomplete bash
@@ -173,86 +186,223 @@ EXAMPLES
   $ apimatic autocomplete --refresh-cache
 ```
 
-_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v0.3.0/src/commands/autocomplete/index.ts)_
+_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/main/src/commands/autocomplete/index.ts)_
 
 ## `apimatic help [COMMAND]`
 
-display help for apimatic
+Display help for apimatic.
 
 ```
 USAGE
-  $ apimatic help [COMMAND]
+  $ apimatic help [COMMAND...] [-n]
 
 ARGUMENTS
-  COMMAND  command to show help for
+  COMMAND...  Command to show help for.
+
+FLAGS
+  -n, --nested-commands  Include all nested commands in the output.
 
-OPTIONS
-  --all  see all commands in CLI
+DESCRIPTION
+  Display help for apimatic.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v3.2.14/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/main/src/commands/help.ts)_
+
+## `apimatic portal:copilot`
+
+Configure API Copilot for your API Documentation portal
+
+```
+USAGE
+  $ apimatic portal:copilot [-i <value>] [--disable] [-k <value>]
+
+FLAGS
+  -i, --input=<value>     [default: ./] path to the parent directory containing the 'src' directory, which includes API
+                          specifications and configuration files.
+  -k, --auth-key=<value>  override current authentication state with an authentication key.
+      --disable           marks the API Copilot as disabled in the configuration
+
+DESCRIPTION
+  Configure API Copilot for your API Documentation portal
+
+  Displays available API Copilots associated with your account and allows you to select which one to integrate with your
+  portal. Each APIMatic account includes one Copilot by default. The selected Copilot will be added to your
+  APIMATIC-BUILD.json file
+
+EXAMPLES
+  $ apimatic portal:copilot --input="./"
+
+  $ apimatic portal:copilot --input="./" --disable
+```
+
+_See code: [src/commands/portal/copilot.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/portal/copilot.ts)_
 
 ## `apimatic portal:generate`
 
-Generate and download a static API Documentation portal. Requires an input directory containing API specifications, a config file and optionally, markdown guides. For details, refer to the [documentation](https://portal-api-docs.apimatic.io/#/http/generating-api-portal/build-file)
+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)
 
 ```
 USAGE
+  $ apimatic portal:generate [-i <value>] [-d <value>] [-f] [--zip] [-k <value>]
+
+FLAGS
+  -d, --destination=<value>  [default: <input>/portal] path where the portal will be generated.
+  -f, --force                overwrite changes without asking for user consent.
+  -i, --input=<value>        [default: ./] path to the parent directory containing the 'src' directory, which includes
+                             API specifications and configuration files.
+  -k, --auth-key=<value>     override current authentication state with an authentication key.
+      --zip                  download the generated portal as a .zip archive
+
+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/gu
+  ides/generating-on-prem-api-portal/build-file-reference)
+
+EXAMPLES
   $ apimatic portal:generate
 
-OPTIONS
-  -f, --force                overwrite if a portal exists in the destination
-  --auth-key=auth-key        override current authentication state with an authentication key
-  --destination=destination  [default: /home/runner/work/apimatic-cli/apimatic-cli/cli] path to the downloaded portal
-  --folder=folder            [default: ./] path to the input directory containing API specifications and config files
-  --zip                      download the generated portal as a .zip archive
+  $ apimatic portal:generate --input="./" --destination="./portal"
+```
+
+_See code: [src/commands/portal/generate.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/portal/generate.ts)_
+
+## `apimatic portal:quickstart`
+
+Create your first API Portal using APIMatic's Docs as Code offering.
 
-EXAMPLE
-  $ apimatic portal:generate --folder="./portal/" --destination="D:/"
-  Your portal has been generated at D:/
 ```
+USAGE
+  $ apimatic portal:quickstart
 
-_See code: [src/commands/portal/generate.ts](https://github.com/apimatic/apimatic-cli/blob/v0.0.0-alpha.3/src/commands/portal/generate.ts)_
+DESCRIPTION
+  Create your first API Portal using APIMatic's Docs as Code offering.
 
-## `apimatic sdk:generate`
+EXAMPLES
+  $ apimatic portal:quickstart
+```
+
+_See code: [src/commands/portal/quickstart.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/portal/quickstart.ts)_
 
-Generate SDK for your APIs
+## `apimatic portal:recipe:new`
+
+Add an API Recipe to your API Documentation portal.
 
 ```
 USAGE
-  $ apimatic sdk:generate
+  $ apimatic portal:recipe:new [--name <value>] [-i <value>]
+
+FLAGS
+  -i, --input=<value>  [default: ./] path to the parent directory containing the 'src' directory, which includes API
+                       specifications and configuration files.
+      --name=<value>   name for the recipe
+
+DESCRIPTION
+  Add an API Recipe to your API Documentation portal.
+
+  To learn more about API Recipes, visit:
+  https://docs.apimatic.io/platform-api/#/http/guides/generating-on-prem-api-portal/api-recipes
+
+EXAMPLES
+  $ apimatic portal:recipe:new
+
+  $ apimatic portal:recipe:new --name="My API Recipe" --input="./"
+```
 
-OPTIONS
-  -f, --force                overwrite if an SDK already exists in the destination
-  --auth-key=auth-key        override current authentication state with an authentication key
+_See code: [src/commands/portal/recipe/new.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/portal/recipe/new.ts)_
 
-  --destination=destination  [default: /home/runner/work/apimatic-cli/apimatic-cli/cli] directory to download the
-                             generated SDK to
+## `apimatic portal:serve`
 
-  --file=file                path to the API specification to generate SDKs for
+Generate and deploy a Docs as Code portal with hot reload.
 
-  --platform=platform        (required) language platform for sdk
-                             Simple: CSHARP|JAVA|PYTHON|RUBY|PHP|TYPESCRIPT
-                             Legacy: CS_NET_STANDARD_LIB|CS_PORTABLE_NET_LIB|CS_UNIVERSAL_WINDOWS_PLATFORM_LIB|
-                             JAVA_ECLIPSE_JRE_LIB|PHP_GENERIC_LIB|PYTHON_GENERIC_LIB|RUBY_GENERIC_LIB|
-                             TS_GENERIC_LIB
+```
+USAGE
+  $ apimatic portal:serve [-p <value>] [-i <value>] [-d <value>] [-o] [--no-reload] [-k <value>]
 
-  --url=url                  URL to the API specification to generate SDKs for. Can be used in place of the --file
-                             option if the API specification is publicly available.
+FLAGS
+  -d, --destination=<value>  [default: <input>/portal] path where the portal will be generated.
+  -i, --input=<value>        [default: ./] path to the parent directory containing the 'src' directory, which includes
+                             API specifications and configuration files.
+  -k, --auth-key=<value>     override current authentication state with an authentication key.
+  -o, --open                 Open the portal in the default browser.
+  -p, --port=<value>         [default: 3000] port to serve the portal.
+      --no-reload            Disable hot reload.
 
-  --zip                      download the generated SDK as a .zip archive
+DESCRIPTION
+  Generate and deploy a Docs as Code portal with hot reload.
 
 EXAMPLES
-  $ apimatic sdk:generate --platform="CSHARP" --file="./specs/sample.json"
-  Generating SDK... done
-  Downloading SDK... done
-  Success! Your SDK is located at swagger_sdk_csharp
-
-  $ apimatic sdk:generate --platform="CSHARP" --url=https://petstore.swagger.io/v2/swagger.json
-  Generating SDK... done
-  Downloading SDK... done
-  Success! Your SDK is located at swagger_sdk_csharp
+  $ apimatic portal:serve
+
+  $ apimatic portal:serve --input="./" --destination="./portal" --port=3000 --open --no-reload
+```
+
+_See code: [src/commands/portal/serve.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/portal/serve.ts)_
+
+## `apimatic portal:toc:new`
+
+Generate a Table of Contents (TOC) file for your API documentation portal
+
+```
+USAGE
+  $ apimatic portal:toc:new [-d <value>] [-i <value>] [-f] [--expand-endpoints] [--expand-models]
+
+FLAGS
+  -d, --destination=<value>  [default: <input>/src/content] path where the 'toc.yml' will be generated.
+  -f, --force                overwrite changes without asking for user consent.
+  -i, --input=<value>        [default: ./] path to the parent directory containing the 'src' directory, which includes
+                             API specifications and configuration files.
+      --expand-endpoints     include individual entries for each endpoint in the generated 'toc.yml'. Requires a valid
+                             API specification in the working directory.
+      --expand-models        include individual entries for each model in the generated 'toc.yml'. Requires a valid API
+                             specification in the working directory.
+
+DESCRIPTION
+  Generate a Table of Contents (TOC) file for your API documentation portal
+
+  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
+
+EXAMPLES
+  $ apimatic portal:toc:new --destination="./src/content/"
+
+  $ apimatic portal:toc:new --input="./"
+
+  $ apimatic portal:toc:new --input="./" --destination="./src/content/"
+```
+
+_See code: [src/commands/portal/toc/new.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/portal/toc/new.ts)_
+
+## `apimatic sdk:generate`
+
+Generate an SDK for your API
+
+```
+USAGE
+  $ apimatic sdk:generate --platform csharp|java|php|python|ruby|typescript|go [--spec <value>] [-d <value>] [-f]
+    [--zip] [-k <value>]
+
+FLAGS
+  -d, --destination=<value>  [default: ./sdk/<platform>] path where the sdk will be generated.
+  -f, --force                overwrite changes without asking for user consent.
+  -k, --auth-key=<value>     override current authentication state with an authentication key.
+      --platform=<option>    (required) language platform for sdk
+                             <options: csharp|java|php|python|ruby|typescript|go>
+      --spec=<value>         [default: ./src/spec] path to the folder containing the API specification file.
+      --zip                  download the generated SDK as a .zip archive
+
+DESCRIPTION
+  Generate an SDK for your API
+
+EXAMPLES
+  $ apimatic sdk:generate --platform="java"
+
+  $ apimatic sdk:generate --platform="csharp" --spec="./src/spec"
 ```
 
-_See code: [src/commands/sdk/generate.ts](https://github.com/apimatic/apimatic-cli/blob/v0.0.0-alpha.3/src/commands/sdk/generate.ts)_
+_See code: [src/commands/sdk/generate.ts](https://github.com/apimatic/apimatic-cli/blob/alpha/src/commands/sdk/generate.ts)_
 <!-- commandsstop -->

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/lib/actions/action-result.d.ts

@@ -0,0 +1,8 @@
+export declare class ActionResult {
+    private readonly message;
+    private constructor();
+    static error(message: string): ActionResult;
+    static success(): ActionResult;
+    map(onError: (message: string) => void): void;
+    mapAll<T>(onSuccess: () => T, onError: (message: string) => T): T;
+}

package/lib/actions/action-result.js

@@ -0,0 +1,25 @@
+export class ActionResult {
+    constructor(message) {
+        this.message = message;
+    }
+    static error(message) {
+        return new ActionResult(message);
+    }
+    static success() {
+        return new ActionResult();
+    }
+    map(onError) {
+        if (this.message) {
+            onError(this.message);
+        }
+    }
+    mapAll(onSuccess, onError) {
+        if (this.message) {
+            return onError(this.message);
+        }
+        else {
+            return onSuccess();
+        }
+    }
+}
+//# sourceMappingURL=action-result.js.map

package/lib/actions/action-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-result.js","sourceRoot":"","sources":["../../src/actions/action-result.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAY;IAGvB,YAAoB,OAAgB;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAe;QAC1B,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,OAAO;QACZ,OAAO,IAAI,YAAY,EAAE,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,OAAkC;QACpC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,CAAI,SAAiB,EAAE,OAA+B;QAC1D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;aAAK,CAAC;YACL,OAAO,SAAS,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

package/lib/actions/auth/login.d.ts

@@ -0,0 +1,12 @@
+import { DirectoryPath } from "../../types/file/directoryPath.js";
+import { Result } from "neverthrow";
+export declare class LoginAction {
+    private readonly configDir;
+    private readonly authService;
+    private readonly apiService;
+    private readonly prompts;
+    constructor(configDir: DirectoryPath);
+    execute(apiKey?: string | undefined): Promise<Result<string, string>>;
+    private poolDeviceToken;
+    private verifyKeyAndSave;
+}

package/lib/actions/auth/login.js

@@ -0,0 +1,63 @@
+import { AuthService } from "../../infrastructure/services/auth-service.js";
+import { ApiService } from "../../infrastructure/services/api-service.js";
+import { err, ok } from "neverthrow";
+import { v4 as uuid } from "uuid";
+import open from "open";
+import { setAuthInfo } from "../../client-utils/auth-manager.js";
+import { LoginPrompts } from "../../prompts/auth/login.js";
+import { getErrorMessage } from "../../infrastructure/api-utils.js";
+export class LoginAction {
+    constructor(configDir) {
+        this.configDir = configDir;
+        this.authService = new AuthService();
+        this.apiService = new ApiService();
+        this.prompts = new LoginPrompts();
+    }
+    async execute(apiKey = undefined) {
+        if (!apiKey) {
+            const result = await this.poolDeviceToken();
+            return (await result.asyncMap(async (token) => {
+                return await this.verifyKeyAndSave(token);
+            })).andThen((r) => r);
+        }
+        else {
+            return await this.verifyKeyAndSave(apiKey);
+        }
+    }
+    async poolDeviceToken() {
+        const state = uuid();
+        this.prompts.openBrowser();
+        await open(this.authService.getDeviceLoginUrl(state));
+        const timeoutDuration = 5 * 60 * 1000; // 5 minutes in milliseconds
+        const startTime = Date.now();
+        const delayMs = 3 * 1000;
+        while (true) {
+            if (Date.now() - startTime > timeoutDuration) {
+                return err("Authentication timed out. Please try again.");
+            }
+            const result = await this.authService.getDeviceLoginToken(state);
+            const token = result.match((res) => res.apiKey, () => {
+                /* ignore errors */
+            });
+            if (token)
+                return ok(token);
+            // eslint-disable-next-line no-undef
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+    }
+    async verifyKeyAndSave(apiKey) {
+        const result = await this.apiService.getAccountInfo(this.configDir, apiKey);
+        return result.asyncMap(async (info) => {
+            await setAuthInfo(info.Email, apiKey, false, this.configDir);
+            return info.Email;
+        }).mapErr(e => {
+            switch (e) {
+                case "UNAUTHORIZED" /* ServiceError.UnAuthorized */:
+                    return "The provided auth key is invalid";
+                default:
+                    return getErrorMessage(e);
+            }
+        });
+    }
+}
+//# sourceMappingURL=login.js.map

package/lib/actions/auth/login.js.map

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

package/lib/actions/portal/copilot.d.ts

@@ -0,0 +1,11 @@
+import { DirectoryPath } from "../../types/file/directoryPath.js";
+import { ActionResult } from "../action-result.js";
+export declare class CopilotAction {
+    private readonly apiService;
+    private readonly prompts;
+    private readonly configDir;
+    private readonly authKey;
+    constructor(configDir: DirectoryPath, authKey?: string | null);
+    execute(buildDirectory: DirectoryPath, enable: boolean): Promise<ActionResult>;
+    private selectCopilotKey;
+}