@rockcarver/frodo-cli 0.18.2-9 → 0.19.1

package/CHANGELOG.md

@@ -7,6 +7,103 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.19.1] - 2022-12-20
+
+### Fixed
+
+-   \#161: Frodo now properly allows adding connection profiles with log credentials
+
+## [0.19.0] - 2022-12-18
+
+### Added
+
+-   \#154: Allow all connection parameters to be supplied using environment variables for secure CI/CD:
+    -   `FRODO_HOST`
+    -   `FRODO_REALM`
+    -   `FRODO_USERNAME`
+    -   `FRODO_PASSWORD`
+    -   `FRODO_SA_ID`
+    -   `FRODO_SA_JWK`
+    -   `FRODO_LOG_KEY`
+    -   `FRODO_LOG_SECRET`
+    -   `FRODO_DEBUG` - set to any value to enable debug logging, e.g. `FRODO_DEBUG=1 frodo info tenant-name`
+-   \#143: Support Identity Cloud Service Accounts in `frodo conn save|add` command
+    1.  The `frodo conn add` command is renamed to `frodo conn save` and `add` is added as an alias for backwards compatibility.
+    2.  The `frodo conn save` command supports the following new options to manage service accounts:
+        1.  `--sa-id <uuid>` Service account's uuid. If specified, must also include `--sa-jwk-file`. Ignored with `--no-sa`.
+        2.  `--sa-jwk-file <file>` File containing the service account's java web key (jwk). Jwk must contain private key! If specified, must also include `--sa-id`. Ignored with `--no-sa`.
+        3.  `--no-sa` Do not add service account.
+    3.  The existing `--no-validate` option also applies to service account operations, allowing to add service account configuration to a connection profile without validating it, typical use case is an offline situation.
+    4.  The `frodo conn save` command automatically creates a new service account and adds it to an existing ID Cloud profile without service account or to a new ID Cloud profile. It does not do that if the `--no-sa` option is supplied.
+        1.  If `--sa-id` and `--sa-jwk-file` are supplied, `frodo conn save` adds the existing service account specified by those two parameters to the profile instead of creating a new service account.
+        2.  The `frodo conn save` command checks if the ID Cloud tenant supports service accounts before performing any service account operations.
+    5.  The `frodo conn save` command validates service account configuration unless the `--no-validate` options is supplied.
+-   \#101: Added new `frodo service` set of commands to manage AM realm services (`baseurl`, `DataStoreService`, `oauth-oidc`, `policyconfiguration`, `selfServiceTrees`, `SocialIdentityProviders`, `validation`, etc.) and global services (e.g. `CorsService`, `dashboard`, etc.).
+        frodo service
+                      delete        Delete AM services.
+                      export        Export AM services.
+                      import        Import AM services.
+                      list          List AM services.
+-   Added new `frodo idm import` command.
+-   \#98: Add support for Agents / Gateways
+        frodo agent                  Manage agents.
+                    delete           Delete agents of any type.
+                    describe         Describe agents of any type.
+                    export           Export agents of any type.
+                    import           Import agents of any type.
+                    list             List agents of any type.
+                    gateway          Manage gateway agents.
+                            delete   Delete gateway agents.
+                            describe Describe gateway agents.
+                            export   Export gateway agents.
+                            import   Import gateway agents.
+                            list     List gateway agents.
+                    java             Manage java agents.
+                            delete   Delete java agents.
+                            describe Describe java agents.
+                            export   Export java agents.
+                            import   Import java agents.
+                            list     List java agents.
+                    web              Manage web agents.
+                            delete   Delete web agents.
+                            describe Describe web agents.
+                            export   Export web agents.
+                            import   Import web agents.
+                            list     List web agents.
+-   Added `--raw` option to `frodo saml import` and `frodo saml export` commands. The new option uses the classic (pre 7.0.0) SAML REST APIs. This allows Frodo to export and import SAML entity providers from pre 7 platform instances.
+-   New default options `--verbose`, `--debug`, and `--curlirize` for all commands
+
+### Changed
+
+-   Updated to frodo-lib 0.17.0
+-   \#110: Migrate from .frodorc to Connections.json
+-   Ongoing refactoring of code base:
+    -   Refactored Email Template and Theme functionality in lib to remove fs operations
+    -   \#93: Move cli functions from frodo-lib to frodo-cli
+-   More automated testing
+
+### Fixed
+
+-
+
+## [0.18.2-18] - 2022-12-17
+
+## [0.18.2-17] - 2022-12-14
+
+## [0.18.2-16] - 2022-12-14
+
+## [0.18.2-15] - 2022-12-12
+
+## [0.18.2-14] - 2022-12-10
+
+## [0.18.2-13] - 2022-12-01
+
+## [0.18.2-12] - 2022-11-29
+
+## [0.18.2-11] - 2022-11-26
+
+## [0.18.2-10] - 2022-11-23
+
 ## [0.18.2-9] - 2022-11-22
 
 -   \#110: Migrate from .frodorc to Connections.json
@@ -732,7 +829,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 -   Fixed problem with adding connection profiles
 -   Miscellaneous bug fixes
 
-[Unreleased]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-9...HEAD
+[Unreleased]: https://github.com/rockcarver/frodo-cli/compare/v0.19.1...HEAD
+
+[0.19.1]: https://github.com/rockcarver/frodo-cli/compare/v0.19.0...v0.19.1
+
+[0.19.0]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-18...v0.19.0
+
+[0.18.2-18]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-17...v0.18.2-18
+
+[0.18.2-17]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-16...v0.18.2-17
+
+[0.18.2-16]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-15...v0.18.2-16
+
+[0.18.2-15]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-14...v0.18.2-15
+
+[0.18.2-14]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-13...v0.18.2-14
+
+[0.18.2-13]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-12...v0.18.2-13
+
+[0.18.2-12]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-11...v0.18.2-12
+
+[0.18.2-11]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-10...v0.18.2-11
+
+[0.18.2-10]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-9...v0.18.2-10
 
 [0.18.2-9]: https://github.com/rockcarver/frodo-cli/compare/v0.18.2-8...v0.18.2-9
 

package/esm/app.js

@@ -28,7 +28,7 @@ const {
   try {
     const program = new Command('frodo').version(await getVersions(false), '-v, --version');
     printMessage(await getVersions(true), 'text', false);
-    initConnectionProfiles();
+    await initConnectionProfiles();
     program.addCommand(admin());
     program.addCommand(agent());
     program.addCommand(app());
@@ -45,6 +45,9 @@ const {
     program.addCommand(script());
     program.addCommand(service());
     program.addCommand(theme());
+    // enable sample command template.
+    // program.addCommand(something());
+
     program.showHelpAfterError();
     program.enablePositionalOptions();
     program.parse();

package/esm/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","names":["ConnectionProfile","Command","admin","agent","app","conn","email","esv","idm","idp","info","journey","logging","realm","saml","script","service","theme","printMessage","getVersions","initConnectionProfiles","program","version","addCommand","showHelpAfterError","enablePositionalOptions","parse","e"],"sources":["app.ts"],"sourcesContent":["#!/usr/bin/env -S node --no-warnings --enable-source-maps --experimental-specifier-resolution=node\n\nimport { ConnectionProfile } from '@rockcarver/frodo-lib';\nimport { Command } from 'commander';\n\n// commands\nimport admin from './cli/admin/admin';\nimport agent from './cli/agent/agent';\nimport app from './cli/app/app';\nimport conn from './cli/conn/conn';\nimport email from './cli/email/email';\nimport esv from './cli/esv/esv';\nimport idm from './cli/idm/idm';\nimport idp from './cli/idp/idp';\nimport info from './cli/info/info';\nimport journey from './cli/journey/journey';\nimport logging from './cli/logging/logs';\nimport realm from './cli/realm/realm';\nimport saml from './cli/saml/saml';\nimport script from './cli/script/script';\nimport service from './cli/service/service';\nimport theme from './cli/theme/theme';\nimport { printMessage } from './utils/Console';\nimport { getVersions } from './utils/Version';\n\nconst { initConnectionProfiles } = ConnectionProfile;\n\n(async () => {\n  try {\n    const program = new Command('frodo').version(\n      await getVersions(false),\n      '-v, --version'\n    );\n\n    printMessage(await getVersions(true), 'text', false);\n\n    initConnectionProfiles();\n\n    program.addCommand(admin());\n    program.addCommand(agent());\n    program.addCommand(app());\n    program.addCommand(conn());\n    program.addCommand(email());\n    program.addCommand(esv());\n    program.addCommand(idm());\n    program.addCommand(idp());\n    program.addCommand(info());\n    program.addCommand(journey());\n    program.addCommand(logging());\n    program.addCommand(realm());\n    program.addCommand(saml());\n    program.addCommand(script());\n    program.addCommand(service());\n    program.addCommand(theme());\n\n    program.showHelpAfterError();\n    program.enablePositionalOptions();\n    program.parse();\n  } catch (e) {\n    printMessage(`ERROR: exception running frodo - ${e}`, 'error');\n  }\n})();\n"],"mappings":"AAAA;AAEA,SAASA,iBAAiB,QAAQ,uBAAuB;AACzD,SAASC,OAAO,QAAQ,WAAW;;AAEnC;AACA,OAAOC,KAAK,MAAM,mBAAmB;AACrC,OAAOC,KAAK,MAAM,mBAAmB;AACrC,OAAOC,GAAG,MAAM,eAAe;AAC/B,OAAOC,IAAI,MAAM,iBAAiB;AAClC,OAAOC,KAAK,MAAM,mBAAmB;AACrC,OAAOC,GAAG,MAAM,eAAe;AAC/B,OAAOC,GAAG,MAAM,eAAe;AAC/B,OAAOC,GAAG,MAAM,eAAe;AAC/B,OAAOC,IAAI,MAAM,iBAAiB;AAClC,OAAOC,OAAO,MAAM,uBAAuB;AAC3C,OAAOC,OAAO,MAAM,oBAAoB;AACxC,OAAOC,KAAK,MAAM,mBAAmB;AACrC,OAAOC,IAAI,MAAM,iBAAiB;AAClC,OAAOC,MAAM,MAAM,qBAAqB;AACxC,OAAOC,OAAO,MAAM,uBAAuB;AAC3C,OAAOC,KAAK,MAAM,mBAAmB;AACrC,SAASC,YAAY,QAAQ,iBAAiB;AAC9C,SAASC,WAAW,QAAQ,iBAAiB;AAE7C,MAAM;EAAEC;AAAuB,CAAC,GAAGpB,iBAAiB;AAEpD,CAAC,YAAY;EACX,IAAI;IACF,MAAMqB,OAAO,GAAG,IAAIpB,OAAO,CAAC,OAAO,CAAC,CAACqB,OAAO,CAC1C,MAAMH,WAAW,CAAC,KAAK,CAAC,EACxB,eAAe,CAChB;IAEDD,YAAY,CAAC,MAAMC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC;IAEpDC,sBAAsB,EAAE;IAExBC,OAAO,CAACE,UAAU,CAACrB,KAAK,EAAE,CAAC;IAC3BmB,OAAO,CAACE,UAAU,CAACpB,KAAK,EAAE,CAAC;IAC3BkB,OAAO,CAACE,UAAU,CAACnB,GAAG,EAAE,CAAC;IACzBiB,OAAO,CAACE,UAAU,CAAClB,IAAI,EAAE,CAAC;IAC1BgB,OAAO,CAACE,UAAU,CAACjB,KAAK,EAAE,CAAC;IAC3Be,OAAO,CAACE,UAAU,CAAChB,GAAG,EAAE,CAAC;IACzBc,OAAO,CAACE,UAAU,CAACf,GAAG,EAAE,CAAC;IACzBa,OAAO,CAACE,UAAU,CAACd,GAAG,EAAE,CAAC;IACzBY,OAAO,CAACE,UAAU,CAACb,IAAI,EAAE,CAAC;IAC1BW,OAAO,CAACE,UAAU,CAACZ,OAAO,EAAE,CAAC;IAC7BU,OAAO,CAACE,UAAU,CAACX,OAAO,EAAE,CAAC;IAC7BS,OAAO,CAACE,UAAU,CAACV,KAAK,EAAE,CAAC;IAC3BQ,OAAO,CAACE,UAAU,CAACT,IAAI,EAAE,CAAC;IAC1BO,OAAO,CAACE,UAAU,CAACR,MAAM,EAAE,CAAC;IAC5BM,OAAO,CAACE,UAAU,CAACP,OAAO,EAAE,CAAC;IAC7BK,OAAO,CAACE,UAAU,CAACN,KAAK,EAAE,CAAC;IAE3BI,OAAO,CAACG,kBAAkB,EAAE;IAC5BH,OAAO,CAACI,uBAAuB,EAAE;IACjCJ,OAAO,CAACK,KAAK,EAAE;EACjB,CAAC,CAAC,OAAOC,CAAC,EAAE;IACVT,YAAY,CAAE,oCAAmCS,CAAE,EAAC,EAAE,OAAO,CAAC;EAChE;AACF,CAAC,GAAG"}
+{"version":3,"file":"app.js","names":["ConnectionProfile","Command","admin","agent","app","conn","email","esv","idm","idp","info","journey","logging","realm","saml","script","service","theme","printMessage","getVersions","initConnectionProfiles","program","version","addCommand","showHelpAfterError","enablePositionalOptions","parse","e"],"sources":["app.ts"],"sourcesContent":["#!/usr/bin/env -S node --no-warnings --enable-source-maps --experimental-specifier-resolution=node\n\nimport { ConnectionProfile } from '@rockcarver/frodo-lib';\nimport { Command } from 'commander';\n\n// commands\nimport admin from './cli/admin/admin';\nimport agent from './cli/agent/agent';\nimport app from './cli/app/app';\nimport conn from './cli/conn/conn';\nimport email from './cli/email/email';\nimport esv from './cli/esv/esv';\nimport idm from './cli/idm/idm';\nimport idp from './cli/idp/idp';\nimport info from './cli/info/info';\nimport journey from './cli/journey/journey';\nimport logging from './cli/logging/logs';\nimport realm from './cli/realm/realm';\nimport saml from './cli/saml/saml';\nimport script from './cli/script/script';\nimport service from './cli/service/service';\nimport something from './cli/_template/something';\nimport theme from './cli/theme/theme';\nimport { printMessage } from './utils/Console';\nimport { getVersions } from './utils/Version';\n\nconst { initConnectionProfiles } = ConnectionProfile;\n\n(async () => {\n  try {\n    const program = new Command('frodo').version(\n      await getVersions(false),\n      '-v, --version'\n    );\n\n    printMessage(await getVersions(true), 'text', false);\n\n    await initConnectionProfiles();\n\n    program.addCommand(admin());\n    program.addCommand(agent());\n    program.addCommand(app());\n    program.addCommand(conn());\n    program.addCommand(email());\n    program.addCommand(esv());\n    program.addCommand(idm());\n    program.addCommand(idp());\n    program.addCommand(info());\n    program.addCommand(journey());\n    program.addCommand(logging());\n    program.addCommand(realm());\n    program.addCommand(saml());\n    program.addCommand(script());\n    program.addCommand(service());\n    program.addCommand(theme());\n    // enable sample command template.\n    // program.addCommand(something());\n\n    program.showHelpAfterError();\n    program.enablePositionalOptions();\n    program.parse();\n  } catch (e) {\n    printMessage(`ERROR: exception running frodo - ${e}`, 'error');\n  }\n})();\n"],"mappings":"AAAA;AAEA,SAASA,iBAAiB,QAAQ,uBAAuB;AACzD,SAASC,OAAO,QAAQ,WAAW;;AAEnC;AACA,OAAOC,KAAK,MAAM,mBAAmB;AACrC,OAAOC,KAAK,MAAM,mBAAmB;AACrC,OAAOC,GAAG,MAAM,eAAe;AAC/B,OAAOC,IAAI,MAAM,iBAAiB;AAClC,OAAOC,KAAK,MAAM,mBAAmB;AACrC,OAAOC,GAAG,MAAM,eAAe;AAC/B,OAAOC,GAAG,MAAM,eAAe;AAC/B,OAAOC,GAAG,MAAM,eAAe;AAC/B,OAAOC,IAAI,MAAM,iBAAiB;AAClC,OAAOC,OAAO,MAAM,uBAAuB;AAC3C,OAAOC,OAAO,MAAM,oBAAoB;AACxC,OAAOC,KAAK,MAAM,mBAAmB;AACrC,OAAOC,IAAI,MAAM,iBAAiB;AAClC,OAAOC,MAAM,MAAM,qBAAqB;AACxC,OAAOC,OAAO,MAAM,uBAAuB;AAE3C,OAAOC,KAAK,MAAM,mBAAmB;AACrC,SAASC,YAAY,QAAQ,iBAAiB;AAC9C,SAASC,WAAW,QAAQ,iBAAiB;AAE7C,MAAM;EAAEC;AAAuB,CAAC,GAAGpB,iBAAiB;AAEpD,CAAC,YAAY;EACX,IAAI;IACF,MAAMqB,OAAO,GAAG,IAAIpB,OAAO,CAAC,OAAO,CAAC,CAACqB,OAAO,CAC1C,MAAMH,WAAW,CAAC,KAAK,CAAC,EACxB,eAAe,CAChB;IAEDD,YAAY,CAAC,MAAMC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC;IAEpD,MAAMC,sBAAsB,EAAE;IAE9BC,OAAO,CAACE,UAAU,CAACrB,KAAK,EAAE,CAAC;IAC3BmB,OAAO,CAACE,UAAU,CAACpB,KAAK,EAAE,CAAC;IAC3BkB,OAAO,CAACE,UAAU,CAACnB,GAAG,EAAE,CAAC;IACzBiB,OAAO,CAACE,UAAU,CAAClB,IAAI,EAAE,CAAC;IAC1BgB,OAAO,CAACE,UAAU,CAACjB,KAAK,EAAE,CAAC;IAC3Be,OAAO,CAACE,UAAU,CAAChB,GAAG,EAAE,CAAC;IACzBc,OAAO,CAACE,UAAU,CAACf,GAAG,EAAE,CAAC;IACzBa,OAAO,CAACE,UAAU,CAACd,GAAG,EAAE,CAAC;IACzBY,OAAO,CAACE,UAAU,CAACb,IAAI,EAAE,CAAC;IAC1BW,OAAO,CAACE,UAAU,CAACZ,OAAO,EAAE,CAAC;IAC7BU,OAAO,CAACE,UAAU,CAACX,OAAO,EAAE,CAAC;IAC7BS,OAAO,CAACE,UAAU,CAACV,KAAK,EAAE,CAAC;IAC3BQ,OAAO,CAACE,UAAU,CAACT,IAAI,EAAE,CAAC;IAC1BO,OAAO,CAACE,UAAU,CAACR,MAAM,EAAE,CAAC;IAC5BM,OAAO,CAACE,UAAU,CAACP,OAAO,EAAE,CAAC;IAC7BK,OAAO,CAACE,UAAU,CAACN,KAAK,EAAE,CAAC;IAC3B;IACA;;IAEAI,OAAO,CAACG,kBAAkB,EAAE;IAC5BH,OAAO,CAACI,uBAAuB,EAAE;IACjCJ,OAAO,CAACK,KAAK,EAAE;EACjB,CAAC,CAAC,OAAOC,CAAC,EAAE;IACVT,YAAY,CAAE,oCAAmCS,CAAE,EAAC,EAAE,OAAO,CAAC;EAChE;AACF,CAAC,GAAG"}

package/esm/cli/FrodoCommand.js

@@ -0,0 +1,140 @@
+import { Argument, Command, Option } from 'commander';
+import * as globalConfig from '../storage/StaticStorage';
+import { state } from '@rockcarver/frodo-lib';
+import fs from 'fs';
+import { printMessage, createProgressIndicator, updateProgressIndicator, stopProgressIndicator, verboseMessage, debugMessage, curlirizeMessage } from '../utils/Console.js';
+const hostArgument = new Argument('[host]', 'Access Management base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring.');
+const realmArgument = new Argument('[realm]', "Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise.").default(
+// must check for FRODO_REALM env variable here because otherwise cli will overwrite realm with default value
+process.env.FRODO_REALM || globalConfig.DEFAULT_REALM_KEY, '"alpha" for Identity Cloud tenants, "/" otherwise.');
+const usernameArgument = new Argument('[username]', 'Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees.');
+const passwordArgument = new Argument('[password]', 'Password.');
+const serviceAccountIdOption = new Option('--sa-id <sa-id>', 'Service account id.');
+const serviceAccountJwkFileOption = new Option('--sa-jwk-file <file>', 'File containing the java web key (jwk) associated with the the service account.');
+const deploymentOption = new Option('-m, --type <type>', 'Override auto-detected deployment type. Valid values for type: \n\
+classic:  A classic Access Management-only deployment with custom layout and configuration. \n\
+cloud:    A ForgeRock Identity Cloud environment. \n\
+forgeops: A ForgeOps CDK or CDM deployment. \n\
+The detected or provided deployment type controls certain behavior like obtaining an Identity \
+Management admin token or not and whether to export/import referenced email templates or how \
+to walk through the tenant admin login flow of Identity Cloud and handle MFA').choices(globalConfig.DEPLOYMENT_TYPES);
+const insecureOption = new Option('-k, --insecure', 'Allow insecure connections when using SSL/TLS. Has no effect when using a network proxy for https (HTTPS_PROXY=http://<host>:<port>), in that case the proxy must provide this capability.').default(false, "Don't allow insecure connections");
+const verboseOption = new Option('--verbose', 'Verbose output during command execution. If specified, may or may not produce additional output.');
+const debugOption = new Option('--debug', 'Debug output during command execution. If specified, may or may not produce additional output helpful for troubleshooting.');
+const curlirizeOption = new Option('--curlirize', 'Output all network calls in curl format.');
+const defaultArgs = [hostArgument, realmArgument, usernameArgument, passwordArgument];
+const defaultOpts = [serviceAccountIdOption, serviceAccountJwkFileOption, deploymentOption, insecureOption, verboseOption, debugOption, curlirizeOption];
+const stateMap = {
+  [hostArgument.name()]: state.setHost,
+  [realmArgument.name()]: state.setRealm,
+  [usernameArgument.name()]: state.setUsername,
+  [passwordArgument.name()]: state.setPassword,
+  [serviceAccountIdOption.attributeName()]: state.setServiceAccountId,
+  [serviceAccountJwkFileOption.attributeName()]: file => {
+    try {
+      const data = fs.readFileSync(file);
+      const jwk = JSON.parse(data.toString());
+      state.setServiceAccountJwk(jwk);
+    } catch (error) {
+      printMessage(`Error parsing JWK from file ${file}: ${error.message}`, 'error');
+    }
+  },
+  [deploymentOption.attributeName()]: state.setDeploymentType,
+  [insecureOption.attributeName()]: state.setAllowInsecureConnection,
+  [verboseOption.attributeName()]: state.setVerbose,
+  [debugOption.attributeName()]: state.setDebug,
+  [curlirizeOption.attributeName()]: state.setCurlirize
+};
+
+/**
+ * Command with default options
+ */
+export class FrodoStubCommand extends Command {
+  /**
+   * Creates a new FrodoCommand instance
+   * @param name Name of the command
+   * @param omits Array of default argument names and default option names that should not be added to this command
+   */
+  constructor(name) {
+    super(name);
+
+    // other default settings
+    this.helpOption('-h, --help', 'Help');
+    this.showHelpAfterError();
+    this.configureHelp({
+      sortSubcommands: true,
+      sortOptions: true
+    });
+
+    // register default handlers
+    state.setPrintHandler(printMessage);
+    state.setVerboseHandler(verboseMessage);
+    state.setDebugHandler(debugMessage);
+    state.setCurlirizeHandler(curlirizeMessage);
+    state.setCreateProgressHandler(createProgressIndicator);
+    state.setUpdateProgressHandler(updateProgressIndicator);
+    state.setStopProgressHandler(stopProgressIndicator);
+  }
+}
+
+/**
+ * Command with default options
+ */
+export class FrodoCommand extends FrodoStubCommand {
+  /**
+   * Creates a new FrodoCommand instance
+   * @param name Name of the command
+   * @param omits Array of default argument names and default option names that should not be added to this command
+   */
+  constructor(name, omits = []) {
+    super(name);
+
+    // register default arguments
+    for (const arg of defaultArgs) {
+      if (!omits.includes(arg.name())) this.addArgument(arg);
+    }
+
+    // register default options
+    for (const opt of defaultOpts) {
+      if (!omits.includes(opt.name())) this.addOption(opt);
+    }
+  }
+
+  /**
+   *
+   * @param args
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  handleDefaultArgsAndOpts(...args) {
+    const command = args.pop();
+    const options = args.pop();
+
+    // handle arguments first
+    for (const [i, v] of command.args.entries()) {
+      const arg = command._args[i].name();
+      // handle only default arguments
+      if (Object.keys(stateMap).includes(arg)) {
+        debugMessage(`FrodoCommand.handleDefaultArgsAndOpts: Handling default argument '${arg}'.`);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const handler = stateMap[arg];
+        handler(v);
+      } else {
+        debugMessage(`FrodoCommand.handleDefaultArgsAndOpts: Ignoring non-default argument '${arg}'.`);
+      }
+    }
+
+    // handle options
+    for (const [k, v] of Object.entries(options)) {
+      // handle only default options
+      if (Object.keys(stateMap).includes(k)) {
+        debugMessage(`FrodoCommand.handleDefaultArgsAndOpts: Handling default option '${k}'.`);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const handler = stateMap[k];
+        handler(v);
+      } else {
+        debugMessage(`FrodoCommand.handleDefaultArgsAndOpts: Ignoring non-default option '${k}'.`);
+      }
+    }
+  }
+}
+//# sourceMappingURL=FrodoCommand.js.map

package/esm/cli/FrodoCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrodoCommand.js","names":["Argument","Command","Option","globalConfig","state","fs","printMessage","createProgressIndicator","updateProgressIndicator","stopProgressIndicator","verboseMessage","debugMessage","curlirizeMessage","hostArgument","realmArgument","default","process","env","FRODO_REALM","DEFAULT_REALM_KEY","usernameArgument","passwordArgument","serviceAccountIdOption","serviceAccountJwkFileOption","deploymentOption","choices","DEPLOYMENT_TYPES","insecureOption","verboseOption","debugOption","curlirizeOption","defaultArgs","defaultOpts","stateMap","name","setHost","setRealm","setUsername","setPassword","attributeName","setServiceAccountId","file","data","readFileSync","jwk","JSON","parse","toString","setServiceAccountJwk","error","message","setDeploymentType","setAllowInsecureConnection","setVerbose","setDebug","setCurlirize","FrodoStubCommand","constructor","helpOption","showHelpAfterError","configureHelp","sortSubcommands","sortOptions","setPrintHandler","setVerboseHandler","setDebugHandler","setCurlirizeHandler","setCreateProgressHandler","setUpdateProgressHandler","setStopProgressHandler","FrodoCommand","omits","arg","includes","addArgument","opt","addOption","handleDefaultArgsAndOpts","args","command","pop","options","i","v","entries","_args","Object","keys","handler","k"],"sources":["cli/FrodoCommand.ts"],"sourcesContent":["import { Argument, Command, Option } from 'commander';\nimport * as globalConfig from '../storage/StaticStorage';\nimport { state } from '@rockcarver/frodo-lib';\nimport fs from 'fs';\nimport {\n  printMessage,\n  createProgressIndicator,\n  updateProgressIndicator,\n  stopProgressIndicator,\n  verboseMessage,\n  debugMessage,\n  curlirizeMessage,\n} from '../utils/Console.js';\n\nconst hostArgument = new Argument(\n  '[host]',\n  'Access Management base URL, e.g.: https://cdk.iam.example.com/am. To use a connection profile, just specify a unique substring.'\n);\n\nconst realmArgument = new Argument(\n  '[realm]',\n  \"Realm. Specify realm as '/' for the root realm or 'realm' or '/parent/child' otherwise.\"\n).default(\n  // must check for FRODO_REALM env variable here because otherwise cli will overwrite realm with default value\n  process.env.FRODO_REALM || globalConfig.DEFAULT_REALM_KEY,\n  '\"alpha\" for Identity Cloud tenants, \"/\" otherwise.'\n);\n\nconst usernameArgument = new Argument(\n  '[username]',\n  'Username to login with. Must be an admin user with appropriate rights to manage authentication journeys/trees.'\n);\n\nconst passwordArgument = new Argument('[password]', 'Password.');\n\nconst serviceAccountIdOption = new Option(\n  '--sa-id <sa-id>',\n  'Service account id.'\n);\n\nconst serviceAccountJwkFileOption = new Option(\n  '--sa-jwk-file <file>',\n  'File containing the java web key (jwk) associated with the the service account.'\n);\n\nconst deploymentOption = new Option(\n  '-m, --type <type>',\n  'Override auto-detected deployment type. Valid values for type: \\n\\\nclassic:  A classic Access Management-only deployment with custom layout and configuration. \\n\\\ncloud:    A ForgeRock Identity Cloud environment. \\n\\\nforgeops: A ForgeOps CDK or CDM deployment. \\n\\\nThe detected or provided deployment type controls certain behavior like obtaining an Identity \\\nManagement admin token or not and whether to export/import referenced email templates or how \\\nto walk through the tenant admin login flow of Identity Cloud and handle MFA'\n).choices(globalConfig.DEPLOYMENT_TYPES);\n\nconst insecureOption = new Option(\n  '-k, --insecure',\n  'Allow insecure connections when using SSL/TLS. Has no effect when using a network proxy for https (HTTPS_PROXY=http://<host>:<port>), in that case the proxy must provide this capability.'\n).default(false, \"Don't allow insecure connections\");\n\nconst verboseOption = new Option(\n  '--verbose',\n  'Verbose output during command execution. If specified, may or may not produce additional output.'\n);\n\nconst debugOption = new Option(\n  '--debug',\n  'Debug output during command execution. If specified, may or may not produce additional output helpful for troubleshooting.'\n);\n\nconst curlirizeOption = new Option(\n  '--curlirize',\n  'Output all network calls in curl format.'\n);\n\nconst defaultArgs = [\n  hostArgument,\n  realmArgument,\n  usernameArgument,\n  passwordArgument,\n];\n\nconst defaultOpts = [\n  serviceAccountIdOption,\n  serviceAccountJwkFileOption,\n  deploymentOption,\n  insecureOption,\n  verboseOption,\n  debugOption,\n  curlirizeOption,\n];\n\nconst stateMap = {\n  [hostArgument.name()]: state.setHost,\n  [realmArgument.name()]: state.setRealm,\n  [usernameArgument.name()]: state.setUsername,\n  [passwordArgument.name()]: state.setPassword,\n  [serviceAccountIdOption.attributeName()]: state.setServiceAccountId,\n  [serviceAccountJwkFileOption.attributeName()]: (file) => {\n    try {\n      const data = fs.readFileSync(file);\n      const jwk = JSON.parse(data.toString());\n      state.setServiceAccountJwk(jwk);\n    } catch (error) {\n      printMessage(\n        `Error parsing JWK from file ${file}: ${error.message}`,\n        'error'\n      );\n    }\n  },\n  [deploymentOption.attributeName()]: state.setDeploymentType,\n  [insecureOption.attributeName()]: state.setAllowInsecureConnection,\n  [verboseOption.attributeName()]: state.setVerbose,\n  [debugOption.attributeName()]: state.setDebug,\n  [curlirizeOption.attributeName()]: state.setCurlirize,\n};\n\n/**\n * Command with default options\n */\nexport class FrodoStubCommand extends Command {\n  /**\n   * Creates a new FrodoCommand instance\n   * @param name Name of the command\n   * @param omits Array of default argument names and default option names that should not be added to this command\n   */\n  constructor(name: string) {\n    super(name);\n\n    // other default settings\n    this.helpOption('-h, --help', 'Help');\n    this.showHelpAfterError();\n    this.configureHelp({\n      sortSubcommands: true,\n      sortOptions: true,\n    });\n\n    // register default handlers\n    state.setPrintHandler(printMessage);\n    state.setVerboseHandler(verboseMessage);\n    state.setDebugHandler(debugMessage);\n    state.setCurlirizeHandler(curlirizeMessage);\n    state.setCreateProgressHandler(createProgressIndicator);\n    state.setUpdateProgressHandler(updateProgressIndicator);\n    state.setStopProgressHandler(stopProgressIndicator);\n  }\n}\n\n/**\n * Command with default options\n */\nexport class FrodoCommand extends FrodoStubCommand {\n  /**\n   * Creates a new FrodoCommand instance\n   * @param name Name of the command\n   * @param omits Array of default argument names and default option names that should not be added to this command\n   */\n  constructor(name: string, omits: string[] = []) {\n    super(name);\n\n    // register default arguments\n    for (const arg of defaultArgs) {\n      if (!omits.includes(arg.name())) this.addArgument(arg);\n    }\n\n    // register default options\n    for (const opt of defaultOpts) {\n      if (!omits.includes(opt.name())) this.addOption(opt);\n    }\n  }\n\n  /**\n   *\n   * @param args\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  handleDefaultArgsAndOpts(...args: any) {\n    const command = args.pop();\n    const options = args.pop();\n\n    // handle arguments first\n    for (const [i, v] of command.args.entries()) {\n      const arg = command._args[i].name();\n      // handle only default arguments\n      if (Object.keys(stateMap).includes(arg)) {\n        debugMessage(\n          `FrodoCommand.handleDefaultArgsAndOpts: Handling default argument '${arg}'.`\n        );\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const handler: any = stateMap[arg];\n        handler(v);\n      } else {\n        debugMessage(\n          `FrodoCommand.handleDefaultArgsAndOpts: Ignoring non-default argument '${arg}'.`\n        );\n      }\n    }\n\n    // handle options\n    for (const [k, v] of Object.entries(options)) {\n      // handle only default options\n      if (Object.keys(stateMap).includes(k)) {\n        debugMessage(\n          `FrodoCommand.handleDefaultArgsAndOpts: Handling default option '${k}'.`\n        );\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const handler: any = stateMap[k];\n        handler(v);\n      } else {\n        debugMessage(\n          `FrodoCommand.handleDefaultArgsAndOpts: Ignoring non-default option '${k}'.`\n        );\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/esm/cli/_template/something-delete.js

@@ -1,24 +1,18 @@
-import { Command, Option } from 'commander';
-import { Authenticate, state } from '@rockcarver/frodo-lib';
-import * as common from '../cmd_common.js';
+import { FrodoCommand } from '../FrodoCommand';
+import { Option } from 'commander';
+import { Authenticate } from '@rockcarver/frodo-lib';
 const {
   getTokens
 } = Authenticate;
-const program = new Command('frodo something delete');
-program.description('Delete something.').helpOption('-h, --help', 'Help').showHelpAfterError().addArgument(common.hostArgumentM).addArgument(common.realmArgument).addArgument(common.userArgument).addArgument(common.passwordArgument).addOption(common.deploymentOption).addOption(common.insecureOption).addOption(common.verboseOption).addOption(common.debugOption).addOption(common.curlirizeOption).addOption(new Option('-i, --something-id <something-id>', '[Something] id. If specified, -a and -A are ignored.')).addOption(new Option('-a, --all', 'Delete all [somethings]. Ignored with -i.')).addOption(new Option('--no-deep', 'No deep delete. This leaves orphaned configuration artifacts behind.')).action(
+const program = new FrodoCommand('frodo something delete');
+program.description('Delete something.').addOption(new Option('-i, --something-id <something-id>', '[Something] id. If specified, -a and -A are ignored.')).addOption(new Option('-a, --all', 'Delete all [somethings]. Ignored with -i.')).addOption(new Option('--no-deep', 'No deep delete. This leaves orphaned configuration artifacts behind.')).action(
 // implement command logic inside action handler
-async (host, realm, user, password, options) => {
-  state.default.session.setTenant(host);
-  state.default.session.setRealm(realm);
-  state.default.session.setUsername(user);
-  state.default.session.setPassword(password);
-  state.default.session.setDeploymentType(options.type);
-  state.default.session.setAllowInsecureConnection(options.insecure);
-  state.default.session.setVerbose(options.verbose);
-  state.default.session.setDebug(options.debug);
-  state.default.session.setCurlirize(options.curlirize);
+async (host, realm, user, password, options, command) => {
+  command.handleDefaultArgsAndOpts(host, realm, user, password, options, command);
   if (await getTokens()) {
     // code goes here
+  } else {
+    process.exitCode = 1;
   }
 }
 // end command logic inside action handler

package/esm/cli/_template/something-delete.js.map

@@ -1 +1 @@
-{"version":3,"file":"something-delete.js","names":["Command","Option","Authenticate","state","common","getTokens","program","description","helpOption","showHelpAfterError","addArgument","hostArgumentM","realmArgument","userArgument","passwordArgument","addOption","deploymentOption","insecureOption","verboseOption","debugOption","curlirizeOption","action","host","realm","user","password","options","default","session","setTenant","setRealm","setUsername","setPassword","setDeploymentType","type","setAllowInsecureConnection","insecure","setVerbose","verbose","setDebug","debug","setCurlirize","curlirize","parse"],"sources":["cli/_template/something-delete.ts"],"sourcesContent":["import { Command, Option } from 'commander';\nimport { Authenticate, state } from '@rockcarver/frodo-lib';\nimport * as common from '../cmd_common.js';\n\nconst { getTokens } = Authenticate;\n\nconst program = new Command('frodo something delete');\n\nprogram\n  .description('Delete something.')\n  .helpOption('-h, --help', 'Help')\n  .showHelpAfterError()\n  .addArgument(common.hostArgumentM)\n  .addArgument(common.realmArgument)\n  .addArgument(common.userArgument)\n  .addArgument(common.passwordArgument)\n  .addOption(common.deploymentOption)\n  .addOption(common.insecureOption)\n  .addOption(common.verboseOption)\n  .addOption(common.debugOption)\n  .addOption(common.curlirizeOption)\n  .addOption(\n    new Option(\n      '-i, --something-id <something-id>',\n      '[Something] id. If specified, -a and -A are ignored.'\n    )\n  )\n  .addOption(\n    new Option('-a, --all', 'Delete all [somethings]. Ignored with -i.')\n  )\n  .addOption(\n    new Option(\n      '--no-deep',\n      'No deep delete. This leaves orphaned configuration artifacts behind.'\n    )\n  )\n  .action(\n    // implement command logic inside action handler\n    async (host, realm, user, password, options) => {\n      state.default.session.setTenant(host);\n      state.default.session.setRealm(realm);\n      state.default.session.setUsername(user);\n      state.default.session.setPassword(password);\n      state.default.session.setDeploymentType(options.type);\n      state.default.session.setAllowInsecureConnection(options.insecure);\n      state.default.session.setVerbose(options.verbose);\n      state.default.session.setDebug(options.debug);\n      state.default.session.setCurlirize(options.curlirize);\n      if (await getTokens()) {\n        // code goes here\n      }\n    }\n    // end command logic inside action handler\n  );\n\nprogram.parse();\n"],"mappings":"AAAA,SAASA,OAAO,EAAEC,MAAM,QAAQ,WAAW;AAC3C,SAASC,YAAY,EAAEC,KAAK,QAAQ,uBAAuB;AAC3D,OAAO,KAAKC,MAAM,MAAM,kBAAkB;AAE1C,MAAM;EAAEC;AAAU,CAAC,GAAGH,YAAY;AAElC,MAAMI,OAAO,GAAG,IAAIN,OAAO,CAAC,wBAAwB,CAAC;AAErDM,OAAO,CACJC,WAAW,CAAC,mBAAmB,CAAC,CAChCC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,CAChCC,kBAAkB,EAAE,CACpBC,WAAW,CAACN,MAAM,CAACO,aAAa,CAAC,CACjCD,WAAW,CAACN,MAAM,CAACQ,aAAa,CAAC,CACjCF,WAAW,CAACN,MAAM,CAACS,YAAY,CAAC,CAChCH,WAAW,CAACN,MAAM,CAACU,gBAAgB,CAAC,CACpCC,SAAS,CAACX,MAAM,CAACY,gBAAgB,CAAC,CAClCD,SAAS,CAACX,MAAM,CAACa,cAAc,CAAC,CAChCF,SAAS,CAACX,MAAM,CAACc,aAAa,CAAC,CAC/BH,SAAS,CAACX,MAAM,CAACe,WAAW,CAAC,CAC7BJ,SAAS,CAACX,MAAM,CAACgB,eAAe,CAAC,CACjCL,SAAS,CACR,IAAId,MAAM,CACR,mCAAmC,EACnC,sDAAsD,CACvD,CACF,CACAc,SAAS,CACR,IAAId,MAAM,CAAC,WAAW,EAAE,2CAA2C,CAAC,CACrE,CACAc,SAAS,CACR,IAAId,MAAM,CACR,WAAW,EACX,sEAAsE,CACvE,CACF,CACAoB,MAAM;AACL;AACA,OAAOC,IAAI,EAAEC,KAAK,EAAEC,IAAI,EAAEC,QAAQ,EAAEC,OAAO,KAAK;EAC9CvB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACC,SAAS,CAACP,IAAI,CAAC;EACrCnB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACE,QAAQ,CAACP,KAAK,CAAC;EACrCpB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACG,WAAW,CAACP,IAAI,CAAC;EACvCrB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACI,WAAW,CAACP,QAAQ,CAAC;EAC3CtB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACK,iBAAiB,CAACP,OAAO,CAACQ,IAAI,CAAC;EACrD/B,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACO,0BAA0B,CAACT,OAAO,CAACU,QAAQ,CAAC;EAClEjC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACS,UAAU,CAACX,OAAO,CAACY,OAAO,CAAC;EACjDnC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACW,QAAQ,CAACb,OAAO,CAACc,KAAK,CAAC;EAC7CrC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACa,YAAY,CAACf,OAAO,CAACgB,SAAS,CAAC;EACrD,IAAI,MAAMrC,SAAS,EAAE,EAAE;IACrB;EAAA;AAEJ;AACA;AAAA,CACD;;AAEHC,OAAO,CAACqC,KAAK,EAAE"}
+{"version":3,"file":"something-delete.js","names":["FrodoCommand","Option","Authenticate","getTokens","program","description","addOption","action","host","realm","user","password","options","command","handleDefaultArgsAndOpts","process","exitCode","parse"],"sources":["cli/_template/something-delete.ts"],"sourcesContent":["import { FrodoCommand } from '../FrodoCommand';\nimport { Option } from 'commander';\nimport { Authenticate } from '@rockcarver/frodo-lib';\n\nconst { getTokens } = Authenticate;\n\nconst program = new FrodoCommand('frodo something delete');\n\nprogram\n  .description('Delete something.')\n  .addOption(\n    new Option(\n      '-i, --something-id <something-id>',\n      '[Something] id. If specified, -a and -A are ignored.'\n    )\n  )\n  .addOption(\n    new Option('-a, --all', 'Delete all [somethings]. Ignored with -i.')\n  )\n  .addOption(\n    new Option(\n      '--no-deep',\n      'No deep delete. This leaves orphaned configuration artifacts behind.'\n    )\n  )\n  .action(\n    // implement command logic inside action handler\n    async (host, realm, user, password, options, command) => {\n      command.handleDefaultArgsAndOpts(\n        host,\n        realm,\n        user,\n        password,\n        options,\n        command\n      );\n      if (await getTokens()) {\n        // code goes here\n      } else {\n        process.exitCode = 1;\n      }\n    }\n    // end command logic inside action handler\n  );\n\nprogram.parse();\n"],"mappings":"AAAA,SAASA,YAAY,QAAQ,iBAAiB;AAC9C,SAASC,MAAM,QAAQ,WAAW;AAClC,SAASC,YAAY,QAAQ,uBAAuB;AAEpD,MAAM;EAAEC;AAAU,CAAC,GAAGD,YAAY;AAElC,MAAME,OAAO,GAAG,IAAIJ,YAAY,CAAC,wBAAwB,CAAC;AAE1DI,OAAO,CACJC,WAAW,CAAC,mBAAmB,CAAC,CAChCC,SAAS,CACR,IAAIL,MAAM,CACR,mCAAmC,EACnC,sDAAsD,CACvD,CACF,CACAK,SAAS,CACR,IAAIL,MAAM,CAAC,WAAW,EAAE,2CAA2C,CAAC,CACrE,CACAK,SAAS,CACR,IAAIL,MAAM,CACR,WAAW,EACX,sEAAsE,CACvE,CACF,CACAM,MAAM;AACL;AACA,OAAOC,IAAI,EAAEC,KAAK,EAAEC,IAAI,EAAEC,QAAQ,EAAEC,OAAO,EAAEC,OAAO,KAAK;EACvDA,OAAO,CAACC,wBAAwB,CAC9BN,IAAI,EACJC,KAAK,EACLC,IAAI,EACJC,QAAQ,EACRC,OAAO,EACPC,OAAO,CACR;EACD,IAAI,MAAMV,SAAS,EAAE,EAAE;IACrB;EAAA,CACD,MAAM;IACLY,OAAO,CAACC,QAAQ,GAAG,CAAC;EACtB;AACF;AACA;AAAA,CACD;;AAEHZ,OAAO,CAACa,KAAK,EAAE"}

package/esm/cli/_template/something-describe.js

@@ -1,24 +1,18 @@
-import { Command, Option } from 'commander';
-import { Authenticate, state } from '@rockcarver/frodo-lib';
-import * as common from '../cmd_common.js';
+import { FrodoCommand } from '../FrodoCommand';
+import { Option } from 'commander';
+import { Authenticate } from '@rockcarver/frodo-lib';
 const {
   getTokens
 } = Authenticate;
-const program = new Command('frodo something describe');
-program.description('Describe something.').helpOption('-h, --help', 'Help').showHelpAfterError().addArgument(common.hostArgumentM).addArgument(common.realmArgument).addArgument(common.userArgument).addArgument(common.passwordArgument).addOption(common.deploymentOption).addOption(common.insecureOption).addOption(common.verboseOption).addOption(common.debugOption).addOption(common.curlirizeOption).addOption(new Option('-i, --something-id <something-id>', '[Something] id.')).action(
+const program = new FrodoCommand('frodo something describe');
+program.description('Describe something.').addOption(new Option('-i, --something-id <something-id>', '[Something] id.')).action(
 // implement command logic inside action handler
-async (host, realm, user, password, options) => {
-  state.default.session.setTenant(host);
-  state.default.session.setRealm(realm);
-  state.default.session.setUsername(user);
-  state.default.session.setPassword(password);
-  state.default.session.setDeploymentType(options.type);
-  state.default.session.setAllowInsecureConnection(options.insecure);
-  state.default.session.setVerbose(options.verbose);
-  state.default.session.setDebug(options.debug);
-  state.default.session.setCurlirize(options.curlirize);
+async (host, realm, user, password, options, command) => {
+  command.handleDefaultArgsAndOpts(host, realm, user, password, options, command);
   if (await getTokens()) {
     // code goes here
+  } else {
+    process.exitCode = 1;
   }
 }
 // end command logic inside action handler

package/esm/cli/_template/something-describe.js.map

@@ -1 +1 @@
-{"version":3,"file":"something-describe.js","names":["Command","Option","Authenticate","state","common","getTokens","program","description","helpOption","showHelpAfterError","addArgument","hostArgumentM","realmArgument","userArgument","passwordArgument","addOption","deploymentOption","insecureOption","verboseOption","debugOption","curlirizeOption","action","host","realm","user","password","options","default","session","setTenant","setRealm","setUsername","setPassword","setDeploymentType","type","setAllowInsecureConnection","insecure","setVerbose","verbose","setDebug","debug","setCurlirize","curlirize","parse"],"sources":["cli/_template/something-describe.ts"],"sourcesContent":["import { Command, Option } from 'commander';\nimport { Authenticate, state } from '@rockcarver/frodo-lib';\nimport * as common from '../cmd_common.js';\n\nconst { getTokens } = Authenticate;\n\nconst program = new Command('frodo something describe');\n\nprogram\n  .description('Describe something.')\n  .helpOption('-h, --help', 'Help')\n  .showHelpAfterError()\n  .addArgument(common.hostArgumentM)\n  .addArgument(common.realmArgument)\n  .addArgument(common.userArgument)\n  .addArgument(common.passwordArgument)\n  .addOption(common.deploymentOption)\n  .addOption(common.insecureOption)\n  .addOption(common.verboseOption)\n  .addOption(common.debugOption)\n  .addOption(common.curlirizeOption)\n  .addOption(new Option('-i, --something-id <something-id>', '[Something] id.'))\n  .action(\n    // implement command logic inside action handler\n    async (host, realm, user, password, options) => {\n      state.default.session.setTenant(host);\n      state.default.session.setRealm(realm);\n      state.default.session.setUsername(user);\n      state.default.session.setPassword(password);\n      state.default.session.setDeploymentType(options.type);\n      state.default.session.setAllowInsecureConnection(options.insecure);\n      state.default.session.setVerbose(options.verbose);\n      state.default.session.setDebug(options.debug);\n      state.default.session.setCurlirize(options.curlirize);\n      if (await getTokens()) {\n        // code goes here\n      }\n    }\n    // end command logic inside action handler\n  );\n\nprogram.parse();\n"],"mappings":"AAAA,SAASA,OAAO,EAAEC,MAAM,QAAQ,WAAW;AAC3C,SAASC,YAAY,EAAEC,KAAK,QAAQ,uBAAuB;AAC3D,OAAO,KAAKC,MAAM,MAAM,kBAAkB;AAE1C,MAAM;EAAEC;AAAU,CAAC,GAAGH,YAAY;AAElC,MAAMI,OAAO,GAAG,IAAIN,OAAO,CAAC,0BAA0B,CAAC;AAEvDM,OAAO,CACJC,WAAW,CAAC,qBAAqB,CAAC,CAClCC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,CAChCC,kBAAkB,EAAE,CACpBC,WAAW,CAACN,MAAM,CAACO,aAAa,CAAC,CACjCD,WAAW,CAACN,MAAM,CAACQ,aAAa,CAAC,CACjCF,WAAW,CAACN,MAAM,CAACS,YAAY,CAAC,CAChCH,WAAW,CAACN,MAAM,CAACU,gBAAgB,CAAC,CACpCC,SAAS,CAACX,MAAM,CAACY,gBAAgB,CAAC,CAClCD,SAAS,CAACX,MAAM,CAACa,cAAc,CAAC,CAChCF,SAAS,CAACX,MAAM,CAACc,aAAa,CAAC,CAC/BH,SAAS,CAACX,MAAM,CAACe,WAAW,CAAC,CAC7BJ,SAAS,CAACX,MAAM,CAACgB,eAAe,CAAC,CACjCL,SAAS,CAAC,IAAId,MAAM,CAAC,mCAAmC,EAAE,iBAAiB,CAAC,CAAC,CAC7EoB,MAAM;AACL;AACA,OAAOC,IAAI,EAAEC,KAAK,EAAEC,IAAI,EAAEC,QAAQ,EAAEC,OAAO,KAAK;EAC9CvB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACC,SAAS,CAACP,IAAI,CAAC;EACrCnB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACE,QAAQ,CAACP,KAAK,CAAC;EACrCpB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACG,WAAW,CAACP,IAAI,CAAC;EACvCrB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACI,WAAW,CAACP,QAAQ,CAAC;EAC3CtB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACK,iBAAiB,CAACP,OAAO,CAACQ,IAAI,CAAC;EACrD/B,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACO,0BAA0B,CAACT,OAAO,CAACU,QAAQ,CAAC;EAClEjC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACS,UAAU,CAACX,OAAO,CAACY,OAAO,CAAC;EACjDnC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACW,QAAQ,CAACb,OAAO,CAACc,KAAK,CAAC;EAC7CrC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACa,YAAY,CAACf,OAAO,CAACgB,SAAS,CAAC;EACrD,IAAI,MAAMrC,SAAS,EAAE,EAAE;IACrB;EAAA;AAEJ;AACA;AAAA,CACD;;AAEHC,OAAO,CAACqC,KAAK,EAAE"}
+{"version":3,"file":"something-describe.js","names":["FrodoCommand","Option","Authenticate","getTokens","program","description","addOption","action","host","realm","user","password","options","command","handleDefaultArgsAndOpts","process","exitCode","parse"],"sources":["cli/_template/something-describe.ts"],"sourcesContent":["import { FrodoCommand } from '../FrodoCommand';\nimport { Option } from 'commander';\nimport { Authenticate } from '@rockcarver/frodo-lib';\n\nconst { getTokens } = Authenticate;\n\nconst program = new FrodoCommand('frodo something describe');\n\nprogram\n  .description('Describe something.')\n  .addOption(new Option('-i, --something-id <something-id>', '[Something] id.'))\n  .action(\n    // implement command logic inside action handler\n    async (host, realm, user, password, options, command) => {\n      command.handleDefaultArgsAndOpts(\n        host,\n        realm,\n        user,\n        password,\n        options,\n        command\n      );\n      if (await getTokens()) {\n        // code goes here\n      } else {\n        process.exitCode = 1;\n      }\n    }\n    // end command logic inside action handler\n  );\n\nprogram.parse();\n"],"mappings":"AAAA,SAASA,YAAY,QAAQ,iBAAiB;AAC9C,SAASC,MAAM,QAAQ,WAAW;AAClC,SAASC,YAAY,QAAQ,uBAAuB;AAEpD,MAAM;EAAEC;AAAU,CAAC,GAAGD,YAAY;AAElC,MAAME,OAAO,GAAG,IAAIJ,YAAY,CAAC,0BAA0B,CAAC;AAE5DI,OAAO,CACJC,WAAW,CAAC,qBAAqB,CAAC,CAClCC,SAAS,CAAC,IAAIL,MAAM,CAAC,mCAAmC,EAAE,iBAAiB,CAAC,CAAC,CAC7EM,MAAM;AACL;AACA,OAAOC,IAAI,EAAEC,KAAK,EAAEC,IAAI,EAAEC,QAAQ,EAAEC,OAAO,EAAEC,OAAO,KAAK;EACvDA,OAAO,CAACC,wBAAwB,CAC9BN,IAAI,EACJC,KAAK,EACLC,IAAI,EACJC,QAAQ,EACRC,OAAO,EACPC,OAAO,CACR;EACD,IAAI,MAAMV,SAAS,EAAE,EAAE;IACrB;EAAA,CACD,MAAM;IACLY,OAAO,CAACC,QAAQ,GAAG,CAAC;EACtB;AACF;AACA;AAAA,CACD;;AAEHZ,OAAO,CAACa,KAAK,EAAE"}

package/esm/cli/_template/something-else-delete.js

@@ -1,24 +1,18 @@
-import { Command, Option } from 'commander';
-import { Authenticate, state } from '@rockcarver/frodo-lib';
-import * as common from '../cmd_common.js';
+import { FrodoCommand } from '../FrodoCommand';
+import { Option } from 'commander';
+import { Authenticate } from '@rockcarver/frodo-lib';
 const {
   getTokens
 } = Authenticate;
-const program = new Command('frodo something else delete');
-program.description('Delete something else.').helpOption('-h, --help', 'Help').showHelpAfterError().addArgument(common.hostArgumentM).addArgument(common.realmArgument).addArgument(common.userArgument).addArgument(common.passwordArgument).addOption(common.deploymentOption).addOption(common.insecureOption).addOption(common.verboseOption).addOption(common.debugOption).addOption(common.curlirizeOption).addOption(new Option('-i, --else-id <else-id>', '[Else] id. If specified, -a and -A are ignored.')).addOption(new Option('-a, --all', 'Delete all [elses]. Ignored with -i.')).addOption(new Option('--no-deep', 'No deep delete. This leaves orphaned configuration artifacts behind.')).action(
+const program = new FrodoCommand('frodo something else delete');
+program.description('Delete something else.').addOption(new Option('-i, --else-id <else-id>', '[Else] id. If specified, -a and -A are ignored.')).addOption(new Option('-a, --all', 'Delete all [elses]. Ignored with -i.')).addOption(new Option('--no-deep', 'No deep delete. This leaves orphaned configuration artifacts behind.')).action(
 // implement command logic inside action handler
-async (host, realm, user, password, options) => {
-  state.default.session.setTenant(host);
-  state.default.session.setRealm(realm);
-  state.default.session.setUsername(user);
-  state.default.session.setPassword(password);
-  state.default.session.setDeploymentType(options.type);
-  state.default.session.setAllowInsecureConnection(options.insecure);
-  state.default.session.setVerbose(options.verbose);
-  state.default.session.setDebug(options.debug);
-  state.default.session.setCurlirize(options.curlirize);
+async (host, realm, user, password, options, command) => {
+  command.handleDefaultArgsAndOpts(host, realm, user, password, options, command);
   if (await getTokens()) {
     // code goes here
+  } else {
+    process.exitCode = 1;
   }
 }
 // end command logic inside action handler

package/esm/cli/_template/something-else-delete.js.map

@@ -1 +1 @@
-{"version":3,"file":"something-else-delete.js","names":["Command","Option","Authenticate","state","common","getTokens","program","description","helpOption","showHelpAfterError","addArgument","hostArgumentM","realmArgument","userArgument","passwordArgument","addOption","deploymentOption","insecureOption","verboseOption","debugOption","curlirizeOption","action","host","realm","user","password","options","default","session","setTenant","setRealm","setUsername","setPassword","setDeploymentType","type","setAllowInsecureConnection","insecure","setVerbose","verbose","setDebug","debug","setCurlirize","curlirize","parse"],"sources":["cli/_template/something-else-delete.ts"],"sourcesContent":["import { Command, Option } from 'commander';\nimport { Authenticate, state } from '@rockcarver/frodo-lib';\nimport * as common from '../cmd_common.js';\n\nconst { getTokens } = Authenticate;\n\nconst program = new Command('frodo something else delete');\n\nprogram\n  .description('Delete something else.')\n  .helpOption('-h, --help', 'Help')\n  .showHelpAfterError()\n  .addArgument(common.hostArgumentM)\n  .addArgument(common.realmArgument)\n  .addArgument(common.userArgument)\n  .addArgument(common.passwordArgument)\n  .addOption(common.deploymentOption)\n  .addOption(common.insecureOption)\n  .addOption(common.verboseOption)\n  .addOption(common.debugOption)\n  .addOption(common.curlirizeOption)\n  .addOption(\n    new Option(\n      '-i, --else-id <else-id>',\n      '[Else] id. If specified, -a and -A are ignored.'\n    )\n  )\n  .addOption(new Option('-a, --all', 'Delete all [elses]. Ignored with -i.'))\n  .addOption(\n    new Option(\n      '--no-deep',\n      'No deep delete. This leaves orphaned configuration artifacts behind.'\n    )\n  )\n  .action(\n    // implement command logic inside action handler\n    async (host, realm, user, password, options) => {\n      state.default.session.setTenant(host);\n      state.default.session.setRealm(realm);\n      state.default.session.setUsername(user);\n      state.default.session.setPassword(password);\n      state.default.session.setDeploymentType(options.type);\n      state.default.session.setAllowInsecureConnection(options.insecure);\n      state.default.session.setVerbose(options.verbose);\n      state.default.session.setDebug(options.debug);\n      state.default.session.setCurlirize(options.curlirize);\n      if (await getTokens()) {\n        // code goes here\n      }\n    }\n    // end command logic inside action handler\n  );\n\nprogram.parse();\n"],"mappings":"AAAA,SAASA,OAAO,EAAEC,MAAM,QAAQ,WAAW;AAC3C,SAASC,YAAY,EAAEC,KAAK,QAAQ,uBAAuB;AAC3D,OAAO,KAAKC,MAAM,MAAM,kBAAkB;AAE1C,MAAM;EAAEC;AAAU,CAAC,GAAGH,YAAY;AAElC,MAAMI,OAAO,GAAG,IAAIN,OAAO,CAAC,6BAA6B,CAAC;AAE1DM,OAAO,CACJC,WAAW,CAAC,wBAAwB,CAAC,CACrCC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,CAChCC,kBAAkB,EAAE,CACpBC,WAAW,CAACN,MAAM,CAACO,aAAa,CAAC,CACjCD,WAAW,CAACN,MAAM,CAACQ,aAAa,CAAC,CACjCF,WAAW,CAACN,MAAM,CAACS,YAAY,CAAC,CAChCH,WAAW,CAACN,MAAM,CAACU,gBAAgB,CAAC,CACpCC,SAAS,CAACX,MAAM,CAACY,gBAAgB,CAAC,CAClCD,SAAS,CAACX,MAAM,CAACa,cAAc,CAAC,CAChCF,SAAS,CAACX,MAAM,CAACc,aAAa,CAAC,CAC/BH,SAAS,CAACX,MAAM,CAACe,WAAW,CAAC,CAC7BJ,SAAS,CAACX,MAAM,CAACgB,eAAe,CAAC,CACjCL,SAAS,CACR,IAAId,MAAM,CACR,yBAAyB,EACzB,iDAAiD,CAClD,CACF,CACAc,SAAS,CAAC,IAAId,MAAM,CAAC,WAAW,EAAE,sCAAsC,CAAC,CAAC,CAC1Ec,SAAS,CACR,IAAId,MAAM,CACR,WAAW,EACX,sEAAsE,CACvE,CACF,CACAoB,MAAM;AACL;AACA,OAAOC,IAAI,EAAEC,KAAK,EAAEC,IAAI,EAAEC,QAAQ,EAAEC,OAAO,KAAK;EAC9CvB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACC,SAAS,CAACP,IAAI,CAAC;EACrCnB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACE,QAAQ,CAACP,KAAK,CAAC;EACrCpB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACG,WAAW,CAACP,IAAI,CAAC;EACvCrB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACI,WAAW,CAACP,QAAQ,CAAC;EAC3CtB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACK,iBAAiB,CAACP,OAAO,CAACQ,IAAI,CAAC;EACrD/B,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACO,0BAA0B,CAACT,OAAO,CAACU,QAAQ,CAAC;EAClEjC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACS,UAAU,CAACX,OAAO,CAACY,OAAO,CAAC;EACjDnC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACW,QAAQ,CAACb,OAAO,CAACc,KAAK,CAAC;EAC7CrC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACa,YAAY,CAACf,OAAO,CAACgB,SAAS,CAAC;EACrD,IAAI,MAAMrC,SAAS,EAAE,EAAE;IACrB;EAAA;AAEJ;AACA;AAAA,CACD;;AAEHC,OAAO,CAACqC,KAAK,EAAE"}
+{"version":3,"file":"something-else-delete.js","names":["FrodoCommand","Option","Authenticate","getTokens","program","description","addOption","action","host","realm","user","password","options","command","handleDefaultArgsAndOpts","process","exitCode","parse"],"sources":["cli/_template/something-else-delete.ts"],"sourcesContent":["import { FrodoCommand } from '../FrodoCommand';\nimport { Option } from 'commander';\nimport { Authenticate } from '@rockcarver/frodo-lib';\n\nconst { getTokens } = Authenticate;\n\nconst program = new FrodoCommand('frodo something else delete');\n\nprogram\n  .description('Delete something else.')\n  .addOption(\n    new Option(\n      '-i, --else-id <else-id>',\n      '[Else] id. If specified, -a and -A are ignored.'\n    )\n  )\n  .addOption(new Option('-a, --all', 'Delete all [elses]. Ignored with -i.'))\n  .addOption(\n    new Option(\n      '--no-deep',\n      'No deep delete. This leaves orphaned configuration artifacts behind.'\n    )\n  )\n  .action(\n    // implement command logic inside action handler\n    async (host, realm, user, password, options, command) => {\n      command.handleDefaultArgsAndOpts(\n        host,\n        realm,\n        user,\n        password,\n        options,\n        command\n      );\n      if (await getTokens()) {\n        // code goes here\n      } else {\n        process.exitCode = 1;\n      }\n    }\n    // end command logic inside action handler\n  );\n\nprogram.parse();\n"],"mappings":"AAAA,SAASA,YAAY,QAAQ,iBAAiB;AAC9C,SAASC,MAAM,QAAQ,WAAW;AAClC,SAASC,YAAY,QAAQ,uBAAuB;AAEpD,MAAM;EAAEC;AAAU,CAAC,GAAGD,YAAY;AAElC,MAAME,OAAO,GAAG,IAAIJ,YAAY,CAAC,6BAA6B,CAAC;AAE/DI,OAAO,CACJC,WAAW,CAAC,wBAAwB,CAAC,CACrCC,SAAS,CACR,IAAIL,MAAM,CACR,yBAAyB,EACzB,iDAAiD,CAClD,CACF,CACAK,SAAS,CAAC,IAAIL,MAAM,CAAC,WAAW,EAAE,sCAAsC,CAAC,CAAC,CAC1EK,SAAS,CACR,IAAIL,MAAM,CACR,WAAW,EACX,sEAAsE,CACvE,CACF,CACAM,MAAM;AACL;AACA,OAAOC,IAAI,EAAEC,KAAK,EAAEC,IAAI,EAAEC,QAAQ,EAAEC,OAAO,EAAEC,OAAO,KAAK;EACvDA,OAAO,CAACC,wBAAwB,CAC9BN,IAAI,EACJC,KAAK,EACLC,IAAI,EACJC,QAAQ,EACRC,OAAO,EACPC,OAAO,CACR;EACD,IAAI,MAAMV,SAAS,EAAE,EAAE;IACrB;EAAA,CACD,MAAM;IACLY,OAAO,CAACC,QAAQ,GAAG,CAAC;EACtB;AACF;AACA;AAAA,CACD;;AAEHZ,OAAO,CAACa,KAAK,EAAE"}

package/esm/cli/_template/something-else-describe.js

@@ -1,24 +1,18 @@
-import { Command, Option } from 'commander';
-import { Authenticate, state } from '@rockcarver/frodo-lib';
-import * as common from '../cmd_common.js';
+import { FrodoCommand } from '../FrodoCommand';
+import { Option } from 'commander';
+import { Authenticate } from '@rockcarver/frodo-lib';
 const {
   getTokens
 } = Authenticate;
-const program = new Command('frodo something else describe');
-program.description('Describe something else.').helpOption('-h, --help', 'Help').showHelpAfterError().addArgument(common.hostArgumentM).addArgument(common.realmArgument).addArgument(common.userArgument).addArgument(common.passwordArgument).addOption(common.deploymentOption).addOption(common.insecureOption).addOption(common.verboseOption).addOption(common.debugOption).addOption(common.curlirizeOption).addOption(new Option('-i, --else-id <else-id>', '[Else] id.')).action(
+const program = new FrodoCommand('frodo something else describe');
+program.description('Describe something else.').addOption(new Option('-i, --else-id <else-id>', '[Else] id.')).action(
 // implement command logic inside action handler
-async (host, realm, user, password, options) => {
-  state.default.session.setTenant(host);
-  state.default.session.setRealm(realm);
-  state.default.session.setUsername(user);
-  state.default.session.setPassword(password);
-  state.default.session.setDeploymentType(options.type);
-  state.default.session.setAllowInsecureConnection(options.insecure);
-  state.default.session.setVerbose(options.verbose);
-  state.default.session.setDebug(options.debug);
-  state.default.session.setCurlirize(options.curlirize);
+async (host, realm, user, password, options, command) => {
+  command.handleDefaultArgsAndOpts(host, realm, user, password, options, command);
   if (await getTokens()) {
     // code goes here
+  } else {
+    process.exitCode = 1;
   }
 }
 // end command logic inside action handler

package/esm/cli/_template/something-else-describe.js.map

@@ -1 +1 @@
-{"version":3,"file":"something-else-describe.js","names":["Command","Option","Authenticate","state","common","getTokens","program","description","helpOption","showHelpAfterError","addArgument","hostArgumentM","realmArgument","userArgument","passwordArgument","addOption","deploymentOption","insecureOption","verboseOption","debugOption","curlirizeOption","action","host","realm","user","password","options","default","session","setTenant","setRealm","setUsername","setPassword","setDeploymentType","type","setAllowInsecureConnection","insecure","setVerbose","verbose","setDebug","debug","setCurlirize","curlirize","parse"],"sources":["cli/_template/something-else-describe.ts"],"sourcesContent":["import { Command, Option } from 'commander';\nimport { Authenticate, state } from '@rockcarver/frodo-lib';\nimport * as common from '../cmd_common.js';\n\nconst { getTokens } = Authenticate;\n\nconst program = new Command('frodo something else describe');\n\nprogram\n  .description('Describe something else.')\n  .helpOption('-h, --help', 'Help')\n  .showHelpAfterError()\n  .addArgument(common.hostArgumentM)\n  .addArgument(common.realmArgument)\n  .addArgument(common.userArgument)\n  .addArgument(common.passwordArgument)\n  .addOption(common.deploymentOption)\n  .addOption(common.insecureOption)\n  .addOption(common.verboseOption)\n  .addOption(common.debugOption)\n  .addOption(common.curlirizeOption)\n  .addOption(new Option('-i, --else-id <else-id>', '[Else] id.'))\n  .action(\n    // implement command logic inside action handler\n    async (host, realm, user, password, options) => {\n      state.default.session.setTenant(host);\n      state.default.session.setRealm(realm);\n      state.default.session.setUsername(user);\n      state.default.session.setPassword(password);\n      state.default.session.setDeploymentType(options.type);\n      state.default.session.setAllowInsecureConnection(options.insecure);\n      state.default.session.setVerbose(options.verbose);\n      state.default.session.setDebug(options.debug);\n      state.default.session.setCurlirize(options.curlirize);\n      if (await getTokens()) {\n        // code goes here\n      }\n    }\n    // end command logic inside action handler\n  );\n\nprogram.parse();\n"],"mappings":"AAAA,SAASA,OAAO,EAAEC,MAAM,QAAQ,WAAW;AAC3C,SAASC,YAAY,EAAEC,KAAK,QAAQ,uBAAuB;AAC3D,OAAO,KAAKC,MAAM,MAAM,kBAAkB;AAE1C,MAAM;EAAEC;AAAU,CAAC,GAAGH,YAAY;AAElC,MAAMI,OAAO,GAAG,IAAIN,OAAO,CAAC,+BAA+B,CAAC;AAE5DM,OAAO,CACJC,WAAW,CAAC,0BAA0B,CAAC,CACvCC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,CAChCC,kBAAkB,EAAE,CACpBC,WAAW,CAACN,MAAM,CAACO,aAAa,CAAC,CACjCD,WAAW,CAACN,MAAM,CAACQ,aAAa,CAAC,CACjCF,WAAW,CAACN,MAAM,CAACS,YAAY,CAAC,CAChCH,WAAW,CAACN,MAAM,CAACU,gBAAgB,CAAC,CACpCC,SAAS,CAACX,MAAM,CAACY,gBAAgB,CAAC,CAClCD,SAAS,CAACX,MAAM,CAACa,cAAc,CAAC,CAChCF,SAAS,CAACX,MAAM,CAACc,aAAa,CAAC,CAC/BH,SAAS,CAACX,MAAM,CAACe,WAAW,CAAC,CAC7BJ,SAAS,CAACX,MAAM,CAACgB,eAAe,CAAC,CACjCL,SAAS,CAAC,IAAId,MAAM,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC,CAC9DoB,MAAM;AACL;AACA,OAAOC,IAAI,EAAEC,KAAK,EAAEC,IAAI,EAAEC,QAAQ,EAAEC,OAAO,KAAK;EAC9CvB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACC,SAAS,CAACP,IAAI,CAAC;EACrCnB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACE,QAAQ,CAACP,KAAK,CAAC;EACrCpB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACG,WAAW,CAACP,IAAI,CAAC;EACvCrB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACI,WAAW,CAACP,QAAQ,CAAC;EAC3CtB,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACK,iBAAiB,CAACP,OAAO,CAACQ,IAAI,CAAC;EACrD/B,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACO,0BAA0B,CAACT,OAAO,CAACU,QAAQ,CAAC;EAClEjC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACS,UAAU,CAACX,OAAO,CAACY,OAAO,CAAC;EACjDnC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACW,QAAQ,CAACb,OAAO,CAACc,KAAK,CAAC;EAC7CrC,KAAK,CAACwB,OAAO,CAACC,OAAO,CAACa,YAAY,CAACf,OAAO,CAACgB,SAAS,CAAC;EACrD,IAAI,MAAMrC,SAAS,EAAE,EAAE;IACrB;EAAA;AAEJ;AACA;AAAA,CACD;;AAEHC,OAAO,CAACqC,KAAK,EAAE"}
+{"version":3,"file":"something-else-describe.js","names":["FrodoCommand","Option","Authenticate","getTokens","program","description","addOption","action","host","realm","user","password","options","command","handleDefaultArgsAndOpts","process","exitCode","parse"],"sources":["cli/_template/something-else-describe.ts"],"sourcesContent":["import { FrodoCommand } from '../FrodoCommand';\nimport { Option } from 'commander';\nimport { Authenticate } from '@rockcarver/frodo-lib';\n\nconst { getTokens } = Authenticate;\n\nconst program = new FrodoCommand('frodo something else describe');\n\nprogram\n  .description('Describe something else.')\n  .addOption(new Option('-i, --else-id <else-id>', '[Else] id.'))\n  .action(\n    // implement command logic inside action handler\n    async (host, realm, user, password, options, command) => {\n      command.handleDefaultArgsAndOpts(\n        host,\n        realm,\n        user,\n        password,\n        options,\n        command\n      );\n      if (await getTokens()) {\n        // code goes here\n      } else {\n        process.exitCode = 1;\n      }\n    }\n    // end command logic inside action handler\n  );\n\nprogram.parse();\n"],"mappings":"AAAA,SAASA,YAAY,QAAQ,iBAAiB;AAC9C,SAASC,MAAM,QAAQ,WAAW;AAClC,SAASC,YAAY,QAAQ,uBAAuB;AAEpD,MAAM;EAAEC;AAAU,CAAC,GAAGD,YAAY;AAElC,MAAME,OAAO,GAAG,IAAIJ,YAAY,CAAC,+BAA+B,CAAC;AAEjEI,OAAO,CACJC,WAAW,CAAC,0BAA0B,CAAC,CACvCC,SAAS,CAAC,IAAIL,MAAM,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC,CAC9DM,MAAM;AACL;AACA,OAAOC,IAAI,EAAEC,KAAK,EAAEC,IAAI,EAAEC,QAAQ,EAAEC,OAAO,EAAEC,OAAO,KAAK;EACvDA,OAAO,CAACC,wBAAwB,CAC9BN,IAAI,EACJC,KAAK,EACLC,IAAI,EACJC,QAAQ,EACRC,OAAO,EACPC,OAAO,CACR;EACD,IAAI,MAAMV,SAAS,EAAE,EAAE;IACrB;EAAA,CACD,MAAM;IACLY,OAAO,CAACC,QAAQ,GAAG,CAAC;EACtB;AACF;AACA;AAAA,CACD;;AAEHZ,OAAO,CAACa,KAAK,EAAE"}

package/esm/cli/_template/something-else-export.js

@@ -1,24 +1,18 @@
-import { Command, Option } from 'commander';
-import { Authenticate, state } from '@rockcarver/frodo-lib';
-import * as common from '../cmd_common.js';
+import { FrodoCommand } from '../FrodoCommand';
+import { Option } from 'commander';
+import { Authenticate } from '@rockcarver/frodo-lib';
 const {
   getTokens
 } = Authenticate;
-const program = new Command('frodo something else export');
-program.description('Export something else.').helpOption('-h, --help', 'Help').showHelpAfterError().addArgument(common.hostArgumentM).addArgument(common.realmArgument).addArgument(common.userArgument).addArgument(common.passwordArgument).addOption(common.deploymentOption).addOption(common.insecureOption).addOption(common.verboseOption).addOption(common.debugOption).addOption(common.curlirizeOption).addOption(new Option('-i, --else-id <else-id>', '[Else] id. If specified, -a and -A are ignored.')).addOption(new Option('-f, --file <file>', 'Name of the export file.')).addOption(new Option('-a, --all', 'Export all [else] to a single file. Ignored with -i.')).addOption(new Option('-A, --all-separate', 'Export all [else] to separate files (*.[else].json) in the current directory. Ignored with -i or -a.')).action(
+const program = new FrodoCommand('frodo something else export');
+program.description('Export something else.').addOption(new Option('-i, --else-id <else-id>', '[Else] id. If specified, -a and -A are ignored.')).addOption(new Option('-f, --file <file>', 'Name of the export file.')).addOption(new Option('-a, --all', 'Export all [else] to a single file. Ignored with -i.')).addOption(new Option('-A, --all-separate', 'Export all [else] to separate files (*.[else].json) in the current directory. Ignored with -i or -a.')).action(
 // implement command logic inside action handler
-async (host, realm, user, password, options) => {
-  state.default.session.setTenant(host);
-  state.default.session.setRealm(realm);
-  state.default.session.setUsername(user);
-  state.default.session.setPassword(password);
-  state.default.session.setDeploymentType(options.type);
-  state.default.session.setAllowInsecureConnection(options.insecure);
-  state.default.session.setVerbose(options.verbose);
-  state.default.session.setDebug(options.debug);
-  state.default.session.setCurlirize(options.curlirize);
+async (host, realm, user, password, options, command) => {
+  command.handleDefaultArgsAndOpts(host, realm, user, password, options, command);
   if (await getTokens()) {
     // code goes here
+  } else {
+    process.exitCode = 1;
   }
 }
 // end command logic inside action handler