@contentstack/cli-auth 2.0.0-beta.13 → 2.0.0-beta.15

package/README.md

@@ -18,7 +18,7 @@ $ npm install -g @contentstack/cli-auth
 $ csdx COMMAND
 running command...
 $ csdx (--version)
-@contentstack/cli-auth/2.0.0-beta.13 linux-x64 node-v22.22.3
+@contentstack/cli-auth/2.0.0-beta.15 linux-x64 node-v22.23.1
 $ csdx --help [COMMAND]
 USAGE
   $ csdx COMMAND
@@ -33,11 +33,11 @@ USAGE
 * [`csdx auth:logout`](#csdx-authlogout)
 * [`csdx auth:tokens`](#csdx-authtokens)
 * [`csdx auth:tokens:add [-a <value>] [--delivery] [--management] [-e <value>] [-k <value>] [-y] [--token <value>]`](#csdx-authtokensadd--a-value---delivery---management--e-value--k-value--y---token-value)
+* [`csdx auth:tokens:list`](#csdx-authtokenslist)
 * [`csdx auth:tokens:remove`](#csdx-authtokensremove)
 * [`csdx auth:whoami`](#csdx-authwhoami)
 * [`csdx login`](#csdx-login)
 * [`csdx logout`](#csdx-logout)
-* [`csdx tokens`](#csdx-tokens)
 * [`csdx whoami`](#csdx-whoami)
 
 ## `csdx auth:login`
@@ -102,7 +102,7 @@ _See code: [src/commands/auth/logout.ts](https://github.com/contentstack/cli/blo
 
 ## `csdx auth:tokens`
 
-Lists all existing tokens added to the session
+Manage authentication tokens for API access
 
 ```
 USAGE
@@ -120,13 +120,14 @@ TABLE FLAGS
   --sort=<value>     Sort the table by a column. Use "-" for descending.
 
 DESCRIPTION
-  Lists all existing tokens added to the session
-
-ALIASES
-  $ csdx tokens
+  Manage authentication tokens for API access
 
 EXAMPLES
-  $ csdx auth:tokens
+  $ csdx auth:tokens:list
+
+  $ csdx auth:tokens:add --alias mytoken
+
+  $ csdx auth:tokens:remove --alias mytoken
 ```
 
 _See code: [src/commands/auth/tokens/index.ts](https://github.com/contentstack/cli/blob/main/packages/contentstack-auth/src/commands/auth/tokens/index.ts)_
@@ -177,17 +178,44 @@ EXAMPLES
 
 _See code: [src/commands/auth/tokens/add.ts](https://github.com/contentstack/cli/blob/main/packages/contentstack-auth/src/commands/auth/tokens/add.ts)_
 
+## `csdx auth:tokens:list`
+
+Lists all existing tokens added to the session
+
+```
+USAGE
+  $ csdx auth:tokens:list [--columns <value>] [--sort <value>] [--filter <value>] [--csv] [--no-truncate]
+    [--no-header] [--output csv|json|yaml]
+
+TABLE FLAGS
+  --columns=<value>  Specify columns to display, comma-separated.
+  --csv              Output results in CSV format.
+  --filter=<value>   Filter rows by a column value (e.g., name=foo).
+  --no-header        Hide table headers in output.
+  --no-truncate      Prevent truncation of long text in columns.
+  --output=<option>  Specify output format: csv, json, or yaml.
+                     <options: csv|json|yaml>
+  --sort=<value>     Sort the table by a column. Use "-" for descending.
+
+DESCRIPTION
+  Lists all existing tokens added to the session
+
+EXAMPLES
+  $ csdx auth:tokens:list
+```
+
+_See code: [src/commands/auth/tokens/list.ts](https://github.com/contentstack/cli/blob/main/packages/contentstack-auth/src/commands/auth/tokens/list.ts)_
+
 ## `csdx auth:tokens:remove`
 
 Removes selected tokens
 
 ```
 USAGE
-  $ csdx auth:tokens:remove [-a <value>] [-i]
+  $ csdx auth:tokens:remove [-a <value>]
 
 FLAGS
   -a, --alias=<value>  Alias (name) of the token to delete.
-  -i, --ignore         Ignores if the token is not present.
 
 DESCRIPTION
   Removes selected tokens
@@ -276,35 +304,6 @@ EXAMPLES
   $ csdx auth:logout --yes
 ```
 
-## `csdx tokens`
-
-Lists all existing tokens added to the session
-
-```
-USAGE
-  $ csdx tokens [--columns <value>] [--sort <value>] [--filter <value>] [--csv] [--no-truncate]
-    [--no-header] [--output csv|json|yaml]
-
-TABLE FLAGS
-  --columns=<value>  Specify columns to display, comma-separated.
-  --csv              Output results in CSV format.
-  --filter=<value>   Filter rows by a column value (e.g., name=foo).
-  --no-header        Hide table headers in output.
-  --no-truncate      Prevent truncation of long text in columns.
-  --output=<option>  Specify output format: csv, json, or yaml.
-                     <options: csv|json|yaml>
-  --sort=<value>     Sort the table by a column. Use "-" for descending.
-
-DESCRIPTION
-  Lists all existing tokens added to the session
-
-ALIASES
-  $ csdx tokens
-
-EXAMPLES
-  $ csdx auth:tokens
-```
-
 ## `csdx whoami`
 
 Display current users email address

package/lib/commands/auth/tokens/index.d.ts

@@ -1,9 +1,9 @@
-import { FlagInput } from '@contentstack/cli-utilities';
 import { BaseCommand } from '../../../base-command';
-export default class TokensListCommand extends BaseCommand<typeof TokensListCommand> {
-    static aliases: string[];
-    static examples: string[];
+import { FlagInput } from '@contentstack/cli-utilities';
+export default class AuthTokensCommand extends BaseCommand<typeof AuthTokensCommand> {
     static description: string;
+    static strict: boolean;
+    static examples: string[];
     static flags: FlagInput;
     run(): Promise<any>;
 }

package/lib/commands/auth/tokens/index.js

@@ -1,69 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const cli_utilities_1 = require("@contentstack/cli-utilities");
+const core_1 = require("@oclif/core");
 const base_command_1 = require("../../../base-command");
-class TokensListCommand extends base_command_1.BaseCommand {
+const cli_utilities_1 = require("@contentstack/cli-utilities");
+class AuthTokensCommand extends base_command_1.BaseCommand {
     async run() {
-        cli_utilities_1.log.debug('TokensListCommand run method started.', this.contextDetails);
-        this.contextDetails.module = 'tokens-list';
-        try {
-            cli_utilities_1.log.debug('Retrieving tokens from configuration.', this.contextDetails);
-            const managementTokens = cli_utilities_1.configHandler.get('tokens');
-            cli_utilities_1.log.debug('Tokens retrieved from configuration.', Object.assign(Object.assign({}, this.contextDetails), { tokenCount: managementTokens ? Object.keys(managementTokens).length : 0 }));
-            const tokens = [];
-            if (managementTokens && Object.keys(managementTokens).length > 0) {
-                cli_utilities_1.log.debug('Processing tokens for display.', this.contextDetails);
-                Object.keys(managementTokens).forEach(function (item) {
-                    tokens.push({
-                        alias: item,
-                        token: managementTokens[item].token,
-                        apiKey: managementTokens[item].apiKey,
-                        environment: managementTokens[item].environment ? managementTokens[item].environment : '-',
-                        type: managementTokens[item].type,
-                    });
-                    cli_utilities_1.log.debug(`Token processed: ${item}`, { tokenType: managementTokens[item].type });
-                });
-                const { flags } = await this.parse(TokensListCommand);
-                cli_utilities_1.log.debug('Token list flags parsed.', Object.assign(Object.assign({}, this.contextDetails), { flags }));
-                const headers = [
-                    {
-                        value: 'alias',
-                    },
-                    {
-                        value: 'token',
-                    },
-                    {
-                        value: 'apiKey',
-                    },
-                    {
-                        value: 'environment',
-                    },
-                    {
-                        value: 'type',
-                    },
-                ];
-                cli_utilities_1.log.debug('Displaying token table.', Object.assign(Object.assign({}, this.contextDetails), { tokenCount: tokens.length }));
-                cli_utilities_1.cliux.table(headers, tokens, flags);
-                cli_utilities_1.log.debug('Token table displayed successfully.', this.contextDetails);
-            }
-            else {
-                cli_utilities_1.log.debug('No tokens found in configuration.', this.contextDetails);
-                cli_utilities_1.cliux.print('CLI_AUTH_TOKENS_LIST_NO_TOKENS');
-            }
-            cli_utilities_1.log.debug('Token list command completed successfully.', this.contextDetails);
-        }
-        catch (error) {
-            cli_utilities_1.log.debug('Token list command failed.', Object.assign(Object.assign({}, this.contextDetails), { error }));
-            cli_utilities_1.cliux.print('CLI_AUTH_TOKENS_LIST_FAILED', { color: 'yellow' });
-            (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.contextDetails));
-        }
+        await this.parse(AuthTokensCommand, this.argv.filter((a) => a !== '-help' && a !== '-h'));
+        const cmd = this.config.findCommand('auth:tokens');
+        if (cmd)
+            await new core_1.Help(this.config).showCommandHelp(cmd);
     }
 }
-exports.default = TokensListCommand;
-TokensListCommand.aliases = ['tokens'];
-TokensListCommand.examples = ['$ csdx auth:tokens'];
-TokensListCommand.description = 'Lists all existing tokens added to the session';
-TokensListCommand.flags = cli_utilities_1.CLITable.getTableFlags([
+exports.default = AuthTokensCommand;
+AuthTokensCommand.description = 'Manage authentication tokens for API access';
+AuthTokensCommand.strict = false;
+AuthTokensCommand.examples = [
+    '$ csdx auth:tokens:list',
+    '$ csdx auth:tokens:add --alias mytoken',
+    '$ csdx auth:tokens:remove --alias mytoken',
+];
+AuthTokensCommand.flags = cli_utilities_1.CLITable.getTableFlags([
     'columns',
     'sort',
     'filter',
@@ -71,4 +27,4 @@ TokensListCommand.flags = cli_utilities_1.CLITable.getTableFlags([
     'no-truncate',
     'no-header',
     'output',
-]); // use the cli table flags as it displays tokens in table
+]);

package/lib/commands/auth/tokens/list.d.ts

@@ -0,0 +1,8 @@
+import { FlagInput } from '@contentstack/cli-utilities';
+import { BaseCommand } from '../../../base-command';
+export default class AuthTokensListCommand extends BaseCommand<typeof AuthTokensListCommand> {
+    static description: string;
+    static examples: string[];
+    static flags: FlagInput;
+    run(): Promise<any>;
+}

package/lib/commands/auth/tokens/list.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_utilities_1 = require("@contentstack/cli-utilities");
+const base_command_1 = require("../../../base-command");
+class AuthTokensListCommand extends base_command_1.BaseCommand {
+    async run() {
+        cli_utilities_1.log.debug('AuthTokensListCommand run method started.', this.contextDetails);
+        this.contextDetails.module = 'auth-tokens-list';
+        try {
+            cli_utilities_1.log.debug('Retrieving tokens from configuration.', this.contextDetails);
+            const managementTokens = cli_utilities_1.configHandler.get('tokens');
+            cli_utilities_1.log.debug('Tokens retrieved from configuration.', Object.assign(Object.assign({}, this.contextDetails), { tokenCount: managementTokens ? Object.keys(managementTokens).length : 0 }));
+            const tokens = [];
+            if (managementTokens && Object.keys(managementTokens).length > 0) {
+                cli_utilities_1.log.debug('Processing tokens for display.', this.contextDetails);
+                Object.keys(managementTokens).forEach(function (item) {
+                    tokens.push({
+                        alias: item,
+                        token: managementTokens[item].token,
+                        apiKey: managementTokens[item].apiKey,
+                        environment: managementTokens[item].environment ? managementTokens[item].environment : '-',
+                        type: managementTokens[item].type,
+                    });
+                    cli_utilities_1.log.debug(`Token processed: ${item}`, { tokenType: managementTokens[item].type });
+                });
+                const { flags } = await this.parse(AuthTokensListCommand);
+                cli_utilities_1.log.debug('Token list flags parsed.', Object.assign(Object.assign({}, this.contextDetails), { flags }));
+                const headers = [
+                    { value: 'alias' },
+                    { value: 'token' },
+                    { value: 'apiKey' },
+                    { value: 'environment' },
+                    { value: 'type' },
+                ];
+                cli_utilities_1.log.debug('Displaying token table.', Object.assign(Object.assign({}, this.contextDetails), { tokenCount: tokens.length }));
+                cli_utilities_1.cliux.table(headers, tokens, flags);
+                cli_utilities_1.log.debug('Token table displayed successfully.', this.contextDetails);
+            }
+            else {
+                cli_utilities_1.log.debug('No tokens found in configuration.', this.contextDetails);
+                cli_utilities_1.cliux.print('CLI_AUTH_TOKENS_LIST_NO_TOKENS');
+            }
+            cli_utilities_1.log.debug('Token list command completed successfully.', this.contextDetails);
+        }
+        catch (error) {
+            cli_utilities_1.log.debug('Token list command failed.', Object.assign(Object.assign({}, this.contextDetails), { error }));
+            cli_utilities_1.cliux.print('CLI_AUTH_TOKENS_LIST_FAILED', { color: 'yellow' });
+            (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.contextDetails));
+        }
+    }
+}
+exports.default = AuthTokensListCommand;
+AuthTokensListCommand.description = 'Lists all existing tokens added to the session';
+AuthTokensListCommand.examples = ['$ csdx auth:tokens:list'];
+AuthTokensListCommand.flags = cli_utilities_1.CLITable.getTableFlags([
+    'columns',
+    'sort',
+    'filter',
+    'csv',
+    'no-truncate',
+    'no-header',
+    'output',
+]);

package/lib/commands/auth/tokens/remove.js

@@ -9,17 +9,20 @@ class TokensRemoveCommand extends base_command_1.BaseCommand {
         const { flags: removeTokenFlags } = await this.parse(TokensRemoveCommand);
         cli_utilities_1.log.debug('Token removal flags parsed.', Object.assign(Object.assign({}, this.contextDetails), { flags: removeTokenFlags }));
         const alias = removeTokenFlags.alias;
-        const ignore = removeTokenFlags.ignore;
-        cli_utilities_1.log.debug('Token removal parameters set.', Object.assign(Object.assign({}, this.contextDetails), { alias, ignore }));
+        cli_utilities_1.log.debug('Token removal parameters set.', Object.assign(Object.assign({}, this.contextDetails), { alias }));
         try {
             cli_utilities_1.log.debug('Retrieving token from configuration.', Object.assign(Object.assign({}, this.contextDetails), { alias }));
             const token = cli_utilities_1.configHandler.get(`tokens.${alias}`);
             cli_utilities_1.log.debug('Token retrieved from configuration.', Object.assign(Object.assign({}, this.contextDetails), { hasToken: !!token, tokenType: token === null || token === void 0 ? void 0 : token.type }));
+            if (alias && !token) {
+                cli_utilities_1.log.debug('Alias provided but token not found.', Object.assign(Object.assign({}, this.contextDetails), { alias }));
+                return cli_utilities_1.cliux.print(`No token found with alias '${alias}'.`, { color: 'yellow' });
+            }
             const tokens = cli_utilities_1.configHandler.get('tokens');
             cli_utilities_1.log.debug('All tokens retrieved from configuration.', Object.assign(Object.assign({}, this.contextDetails), { tokenCount: tokens ? Object.keys(tokens).length : 0 }));
             const tokenOptions = [];
-            if (token || ignore) {
-                cli_utilities_1.log.debug('Token found, or ignore flag set.', Object.assign(Object.assign({}, this.contextDetails), { hasToken: !!token, ignore }));
+            if (token) {
+                cli_utilities_1.log.debug('Token found.', Object.assign(Object.assign({}, this.contextDetails), { hasToken: !!token }));
                 cli_utilities_1.configHandler.delete(`tokens.${alias}`);
                 cli_utilities_1.log.debug('Token removed from configuration.', Object.assign(Object.assign({}, this.contextDetails), { alias }));
                 return cli_utilities_1.cliux.success(`CLI_AUTH_TOKENS_REMOVE_SUCCESS`);
@@ -74,5 +77,4 @@ TokensRemoveCommand.description = 'Removes selected tokens';
 TokensRemoveCommand.examples = ['$ csdx auth:tokens:remove', '$ csdx auth:tokens:remove -a <alias>'];
 TokensRemoveCommand.flags = {
     alias: cli_utilities_1.flags.string({ char: 'a', description: 'Alias (name) of the token to delete.' }),
-    ignore: cli_utilities_1.flags.boolean({ char: 'i', description: 'Ignores if the token is not present.' }),
 };

package/oclif.manifest.json

@@ -233,13 +233,96 @@
       ]
     },
     "auth:tokens": {
-      "aliases": [
-        "tokens"
+      "aliases": [],
+      "args": {},
+      "description": "Manage authentication tokens for API access",
+      "examples": [
+        "$ csdx auth:tokens:list",
+        "$ csdx auth:tokens:add --alias mytoken",
+        "$ csdx auth:tokens:remove --alias mytoken"
       ],
+      "flags": {
+        "columns": {
+          "description": "Specify columns to display, comma-separated.",
+          "helpGroup": "TABLE",
+          "name": "columns",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort": {
+          "description": "Sort the table by a column. Use \"-\" for descending.",
+          "helpGroup": "TABLE",
+          "name": "sort",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Filter rows by a column value (e.g., name=foo).",
+          "helpGroup": "TABLE",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "csv": {
+          "description": "Output results in CSV format.",
+          "helpGroup": "TABLE",
+          "name": "csv",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-truncate": {
+          "description": "Prevent truncation of long text in columns.",
+          "helpGroup": "TABLE",
+          "name": "no-truncate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-header": {
+          "description": "Hide table headers in output.",
+          "helpGroup": "TABLE",
+          "name": "no-header",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output": {
+          "description": "Specify output format: csv, json, or yaml.",
+          "helpGroup": "TABLE",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "csv",
+            "json",
+            "yaml"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:tokens",
+      "pluginAlias": "@contentstack/cli-auth",
+      "pluginName": "@contentstack/cli-auth",
+      "pluginType": "core",
+      "strict": false,
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "auth",
+        "tokens",
+        "index.js"
+      ]
+    },
+    "auth:tokens:list": {
+      "aliases": [],
       "args": {},
       "description": "Lists all existing tokens added to the session",
       "examples": [
-        "$ csdx auth:tokens"
+        "$ csdx auth:tokens:list"
       ],
       "flags": {
         "columns": {
@@ -303,7 +386,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:tokens",
+      "id": "auth:tokens:list",
       "pluginAlias": "@contentstack/cli-auth",
       "pluginName": "@contentstack/cli-auth",
       "pluginType": "core",
@@ -314,7 +397,7 @@
         "commands",
         "auth",
         "tokens",
-        "index.js"
+        "list.js"
       ]
     },
     "auth:tokens:remove": {
@@ -333,13 +416,6 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "ignore": {
-          "char": "i",
-          "description": "Ignores if the token is not present.",
-          "name": "ignore",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -359,5 +435,5 @@
       ]
     }
   },
-  "version": "2.0.0-beta.13"
+  "version": "2.0.0-beta.15"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contentstack/cli-auth",
   "description": "Contentstack CLI plugin for authentication activities",
-  "version": "2.0.0-beta.13",
+  "version": "2.0.0-beta.15",
   "author": "Contentstack",
   "bugs": "https://github.com/contentstack/cli/issues",
   "scripts": {
@@ -15,8 +15,8 @@
     "lint": "eslint src/**/*.ts"
   },
   "dependencies": {
-    "@contentstack/cli-command": "~2.0.0-beta.8",
-    "@contentstack/cli-utilities": "~2.0.0-beta.9",
+    "@contentstack/cli-command": "~2.0.0-beta.9",
+    "@contentstack/cli-utilities": "~2.0.0-beta.10",
     "@oclif/core": "^4.11.4",
     "otplib": "^12.0.1"
   },
@@ -33,7 +33,7 @@
     "@types/sinon": "^21.0.1",
     "chai": "^4.5.0",
     "dotenv": "^16.6.1",
-    "eslint": "^9.26.0",
+    "eslint": "^10.5.0",
     "eslint-config-oclif": "^5.2.2",
     "eslint-config-oclif-typescript": "^3.1.14",
     "mocha": "10.8.2",
@@ -45,7 +45,7 @@
     "typescript": "^4.9.5"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=22.0.0"
   },
   "files": [
     "/lib",