@rockcarver/frodo-cli 0.17.0 → 0.17.1

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.17.1] - 2022-10-17
+
+### Changed
+
+-   Updated frodo-lib to 0.15.2
+-   Added options to `frodo journey describe` command:
+    -   Added `--verbose` option
+    -   Added `--debug` option
+
 ## [0.17.0] - 2022-10-16
 
 ### Changed
@@ -683,7 +692,9 @@ 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.17.0...HEAD
+[Unreleased]: https://github.com/rockcarver/frodo-cli/compare/v0.17.1...HEAD
+
+[0.17.1]: https://github.com/rockcarver/frodo-cli/compare/v0.17.0...v0.17.1
 
 [0.17.0]: https://github.com/rockcarver/frodo-cli/compare/v0.16.2-1...v0.17.0
 

package/esm/cli/journey/journey-describe.js

@@ -16,7 +16,7 @@ const {
   saveTextToFile
 } = ExportImportUtils;
 const program = new Command('frodo journey describe');
-program.description('If -h is supplied, describe the journey/tree indicated by -i, or all journeys/trees in the realm if no -i is supplied, otherwise describe the journey/tree export file indicated by -f.').helpOption('-h, --help', 'Help').showHelpAfterError().addArgument(common.hostArgument).addArgument(common.realmArgument).addArgument(common.userArgument).addArgument(common.passwordArgument).addOption(common.deploymentOption).addOption(common.insecureOption).addOption(new Option('-i, --journey-id <journey>', 'Name of a journey/tree. If specified, -a and -A are ignored.')).addOption(new Option('-f, --file <file>', 'Name of the journey export file to describe. Ignored with -A.')).addOption(new Option('-F, --output-file <file>', 'Name of the file to write the output to.')).addOption(new Option('--markdown', 'Output in markdown.')).addOption(new Option('-o, --override-version <version>', "Override version. Notation: '<major>.<minor>.<patch>' e.g. '7.2.0'. Override detected version with any version. This is helpful in order to check if journeys in one environment would be compatible running in another environment (e.g. in preparation of migrating from on-prem to ForgeRock Identity Cloud.")).action( // implement command logic inside action handler
+program.description('If -h is supplied, describe the journey/tree indicated by -i, or all journeys/trees in the realm if no -i is supplied, otherwise describe the journey/tree export file indicated by -f.').helpOption('-h, --help', 'Help').showHelpAfterError().addArgument(common.hostArgument).addArgument(common.realmArgument).addArgument(common.userArgument).addArgument(common.passwordArgument).addOption(common.deploymentOption).addOption(common.insecureOption).addOption(common.verboseOption).addOption(common.debugOption).addOption(new Option('-i, --journey-id <journey>', 'Name of a journey/tree. If specified, -a and -A are ignored.')).addOption(new Option('-f, --file <file>', 'Name of the journey export file to describe. Ignored with -A.')).addOption(new Option('-F, --output-file <file>', 'Name of the file to write the output to.')).addOption(new Option('--markdown', 'Output in markdown.')).addOption(new Option('-o, --override-version <version>', "Override version. Notation: '<major>.<minor>.<patch>' e.g. '7.2.0'. Override detected version with any version. This is helpful in order to check if journeys in one environment would be compatible running in another environment (e.g. in preparation of migrating from on-prem to ForgeRock Identity Cloud.")).action( // implement command logic inside action handler
 async (host, realm, user, password, options) => {
   state.default.session.setTenant(host);
   state.default.session.setRealm(realm);
@@ -24,6 +24,8 @@ async (host, realm, user, password, options) => {
   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);
   if (options.outputFile) state.default.session.setOutputFile(options.outputFile); // TODO: review checks for arguments
 
   if (typeof host === 'undefined' || typeof options.file !== 'undefined') {

package/esm/cli/journey/journey-describe.js.map

@@ -1 +1 @@
-{"version":3,"file":"journey-describe.js","names":["fs","Command","Option","Authenticate","ExportImportUtils","Journey","state","describeJourney","describeJourneyMd","common","printMessage","getTokens","getJourneys","exportJourney","createFileParamTreeExportResolver","saveTextToFile","program","description","helpOption","showHelpAfterError","addArgument","hostArgument","realmArgument","userArgument","passwordArgument","addOption","deploymentOption","insecureOption","action","host","realm","user","password","options","default","session","setTenant","setRealm","setUsername","setPassword","setDeploymentType","type","setAllowInsecureConnection","insecure","outputFile","setOutputFile","file","process","exitCode","overrideVersion","setAmVersion","fileData","JSON","parse","readFileSync","journeyData","journeyId","trees","Object","values","tree","_id","Error","markdown","error","message","getRealm","journeys","journey","treeData"],"sources":["cli/journey/journey-describe.ts"],"sourcesContent":["import fs from 'fs';\nimport { Command, Option } from 'commander';\nimport {\n  Authenticate,\n  ExportImportUtils,\n  Journey,\n  state,\n} from '@rockcarver/frodo-lib';\nimport { describeJourney, describeJourneyMd } from '../../ops/JourneyOps';\nimport * as common from '../cmd_common.js';\nimport { printMessage } from '../../utils/Console';\n\nconst { getTokens } = Authenticate;\nconst { getJourneys, exportJourney, createFileParamTreeExportResolver } =\n  Journey;\nconst { saveTextToFile } = ExportImportUtils;\n\nconst program = new Command('frodo journey describe');\n\nprogram\n  .description(\n    'If -h is supplied, describe the journey/tree indicated by -i, or all journeys/trees in the realm if no -i is supplied, otherwise describe the journey/tree export file indicated by -f.'\n  )\n  .helpOption('-h, --help', 'Help')\n  .showHelpAfterError()\n  .addArgument(common.hostArgument)\n  .addArgument(common.realmArgument)\n  .addArgument(common.userArgument)\n  .addArgument(common.passwordArgument)\n  .addOption(common.deploymentOption)\n  .addOption(common.insecureOption)\n  .addOption(\n    new Option(\n      '-i, --journey-id <journey>',\n      'Name of a journey/tree. If specified, -a and -A are ignored.'\n    )\n  )\n  .addOption(\n    new Option(\n      '-f, --file <file>',\n      'Name of the journey export file to describe. Ignored with -A.'\n    )\n  )\n  .addOption(\n    new Option(\n      '-F, --output-file <file>',\n      'Name of the file to write the output to.'\n    )\n  )\n  .addOption(new Option('--markdown', 'Output in markdown.'))\n  .addOption(\n    new Option(\n      '-o, --override-version <version>',\n      \"Override version. Notation: '<major>.<minor>.<patch>' e.g. '7.2.0'. Override detected version with any version. This is helpful in order to check if journeys in one environment would be compatible running in another environment (e.g. in preparation of migrating from on-prem to ForgeRock Identity Cloud.\"\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      if (options.outputFile)\n        state.default.session.setOutputFile(options.outputFile);\n      // TODO: review checks for arguments\n      if (typeof host === 'undefined' || typeof options.file !== 'undefined') {\n        if (\n          typeof host === 'undefined' &&\n          typeof options.file === 'undefined'\n        ) {\n          printMessage('Need either [host] or -f.', 'error');\n          process.exitCode = 1;\n          return;\n        }\n        printMessage(`Describing local journey file ${options.file}...`);\n        try {\n          // override version\n          if (typeof options.overrideVersion !== 'undefined') {\n            state.default.session.setAmVersion(options.overrideVersion);\n          }\n          const fileData = JSON.parse(fs.readFileSync(options.file, 'utf8'));\n          let journeyData;\n          // single or multi tree export?\n          // multi - by id\n          if (\n            typeof options.journeyId !== 'undefined' &&\n            fileData.trees &&\n            fileData.trees[options.journeyId]\n          ) {\n            journeyData = fileData.trees[options.journeyId];\n          }\n          // multi - first\n          else if (typeof options.journeyId === 'undefined' && fileData.trees) {\n            [journeyData] = Object.values(fileData.trees);\n          }\n          // single - by id\n          else if (\n            typeof options.journeyId !== 'undefined' &&\n            options.journeyId === fileData.tree?._id\n          ) {\n            journeyData = fileData;\n          }\n          // single\n          else if (\n            typeof options.journeyId === 'undefined' &&\n            fileData.tree?._id\n          ) {\n            journeyData = fileData;\n          }\n          // no journey/tree found\n          else {\n            throw new Error(\n              typeof options.journeyId === 'undefined'\n                ? `No journey found in ${options.file}`\n                : `Journey '${options.journeyId}' not found in ${options.file}`\n            );\n          }\n          // ANSI text output\n          if (!options.markdown) {\n            await describeJourney(\n              journeyData,\n              createFileParamTreeExportResolver(options.file)\n            );\n          }\n          // Markdown output\n          else {\n            // reset output file\n            if (options.outputFile) saveTextToFile('', options.outputFile);\n            await describeJourneyMd(\n              journeyData,\n              createFileParamTreeExportResolver(options.file)\n            );\n          }\n        } catch (error) {\n          printMessage(error.message, 'error');\n          process.exitCode = 1;\n        }\n      } else if (await getTokens()) {\n        printMessage(\n          `Describing journey(s) in realm \"${state.default.session.getRealm()}\"...`\n        );\n        // override version\n        if (typeof options.overrideVersion !== 'undefined') {\n          state.default.session.setAmVersion(options.overrideVersion);\n        }\n        if (typeof options.journeyId === 'undefined') {\n          let journeys: any[] = [];\n          journeys = await getJourneys();\n          for (const journey of journeys) {\n            try {\n              // eslint-disable-next-line no-await-in-loop, dot-notation\n              const treeData = await exportJourney(journey['_id']);\n              // ANSI text output\n              if (!options.markdown) {\n                await describeJourney(treeData);\n              }\n              // Markdown output\n              else {\n                // reset output file\n                if (options.outputFile) saveTextToFile('', options.outputFile);\n                await describeJourneyMd(treeData);\n              }\n            } catch (error) {\n              printMessage(error.message, 'error');\n              process.exitCode = 1;\n            }\n          }\n        } else {\n          try {\n            const treeData = await exportJourney(options.journeyId);\n            // ANSI text output\n            if (!options.markdown) {\n              await describeJourney(treeData);\n            }\n            // Markdown output\n            else {\n              // reset output file\n              if (options.outputFile) saveTextToFile('', options.outputFile);\n              await describeJourneyMd(treeData);\n            }\n          } catch (error) {\n            printMessage(error.message, 'error');\n            process.exitCode = 1;\n          }\n        }\n      }\n    }\n    // end command logic inside action handler\n  );\n\nprogram.parse();\n"],"mappings":"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"}
+{"version":3,"file":"journey-describe.js","names":["fs","Command","Option","Authenticate","ExportImportUtils","Journey","state","describeJourney","describeJourneyMd","common","printMessage","getTokens","getJourneys","exportJourney","createFileParamTreeExportResolver","saveTextToFile","program","description","helpOption","showHelpAfterError","addArgument","hostArgument","realmArgument","userArgument","passwordArgument","addOption","deploymentOption","insecureOption","verboseOption","debugOption","action","host","realm","user","password","options","default","session","setTenant","setRealm","setUsername","setPassword","setDeploymentType","type","setAllowInsecureConnection","insecure","setVerbose","verbose","setDebug","debug","outputFile","setOutputFile","file","process","exitCode","overrideVersion","setAmVersion","fileData","JSON","parse","readFileSync","journeyData","journeyId","trees","Object","values","tree","_id","Error","markdown","error","message","getRealm","journeys","journey","treeData"],"sources":["cli/journey/journey-describe.ts"],"sourcesContent":["import fs from 'fs';\nimport { Command, Option } from 'commander';\nimport {\n  Authenticate,\n  ExportImportUtils,\n  Journey,\n  state,\n} from '@rockcarver/frodo-lib';\nimport { describeJourney, describeJourneyMd } from '../../ops/JourneyOps';\nimport * as common from '../cmd_common.js';\nimport { printMessage } from '../../utils/Console';\n\nconst { getTokens } = Authenticate;\nconst { getJourneys, exportJourney, createFileParamTreeExportResolver } =\n  Journey;\nconst { saveTextToFile } = ExportImportUtils;\n\nconst program = new Command('frodo journey describe');\n\nprogram\n  .description(\n    'If -h is supplied, describe the journey/tree indicated by -i, or all journeys/trees in the realm if no -i is supplied, otherwise describe the journey/tree export file indicated by -f.'\n  )\n  .helpOption('-h, --help', 'Help')\n  .showHelpAfterError()\n  .addArgument(common.hostArgument)\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(\n    new Option(\n      '-i, --journey-id <journey>',\n      'Name of a journey/tree. If specified, -a and -A are ignored.'\n    )\n  )\n  .addOption(\n    new Option(\n      '-f, --file <file>',\n      'Name of the journey export file to describe. Ignored with -A.'\n    )\n  )\n  .addOption(\n    new Option(\n      '-F, --output-file <file>',\n      'Name of the file to write the output to.'\n    )\n  )\n  .addOption(new Option('--markdown', 'Output in markdown.'))\n  .addOption(\n    new Option(\n      '-o, --override-version <version>',\n      \"Override version. Notation: '<major>.<minor>.<patch>' e.g. '7.2.0'. Override detected version with any version. This is helpful in order to check if journeys in one environment would be compatible running in another environment (e.g. in preparation of migrating from on-prem to ForgeRock Identity Cloud.\"\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      if (options.outputFile)\n        state.default.session.setOutputFile(options.outputFile);\n      // TODO: review checks for arguments\n      if (typeof host === 'undefined' || typeof options.file !== 'undefined') {\n        if (\n          typeof host === 'undefined' &&\n          typeof options.file === 'undefined'\n        ) {\n          printMessage('Need either [host] or -f.', 'error');\n          process.exitCode = 1;\n          return;\n        }\n        printMessage(`Describing local journey file ${options.file}...`);\n        try {\n          // override version\n          if (typeof options.overrideVersion !== 'undefined') {\n            state.default.session.setAmVersion(options.overrideVersion);\n          }\n          const fileData = JSON.parse(fs.readFileSync(options.file, 'utf8'));\n          let journeyData;\n          // single or multi tree export?\n          // multi - by id\n          if (\n            typeof options.journeyId !== 'undefined' &&\n            fileData.trees &&\n            fileData.trees[options.journeyId]\n          ) {\n            journeyData = fileData.trees[options.journeyId];\n          }\n          // multi - first\n          else if (typeof options.journeyId === 'undefined' && fileData.trees) {\n            [journeyData] = Object.values(fileData.trees);\n          }\n          // single - by id\n          else if (\n            typeof options.journeyId !== 'undefined' &&\n            options.journeyId === fileData.tree?._id\n          ) {\n            journeyData = fileData;\n          }\n          // single\n          else if (\n            typeof options.journeyId === 'undefined' &&\n            fileData.tree?._id\n          ) {\n            journeyData = fileData;\n          }\n          // no journey/tree found\n          else {\n            throw new Error(\n              typeof options.journeyId === 'undefined'\n                ? `No journey found in ${options.file}`\n                : `Journey '${options.journeyId}' not found in ${options.file}`\n            );\n          }\n          // ANSI text output\n          if (!options.markdown) {\n            await describeJourney(\n              journeyData,\n              createFileParamTreeExportResolver(options.file)\n            );\n          }\n          // Markdown output\n          else {\n            // reset output file\n            if (options.outputFile) saveTextToFile('', options.outputFile);\n            await describeJourneyMd(\n              journeyData,\n              createFileParamTreeExportResolver(options.file)\n            );\n          }\n        } catch (error) {\n          printMessage(error.message, 'error');\n          process.exitCode = 1;\n        }\n      } else if (await getTokens()) {\n        printMessage(\n          `Describing journey(s) in realm \"${state.default.session.getRealm()}\"...`\n        );\n        // override version\n        if (typeof options.overrideVersion !== 'undefined') {\n          state.default.session.setAmVersion(options.overrideVersion);\n        }\n        if (typeof options.journeyId === 'undefined') {\n          let journeys: any[] = [];\n          journeys = await getJourneys();\n          for (const journey of journeys) {\n            try {\n              // eslint-disable-next-line no-await-in-loop, dot-notation\n              const treeData = await exportJourney(journey['_id']);\n              // ANSI text output\n              if (!options.markdown) {\n                await describeJourney(treeData);\n              }\n              // Markdown output\n              else {\n                // reset output file\n                if (options.outputFile) saveTextToFile('', options.outputFile);\n                await describeJourneyMd(treeData);\n              }\n            } catch (error) {\n              printMessage(error.message, 'error');\n              process.exitCode = 1;\n            }\n          }\n        } else {\n          try {\n            const treeData = await exportJourney(options.journeyId);\n            // ANSI text output\n            if (!options.markdown) {\n              await describeJourney(treeData);\n            }\n            // Markdown output\n            else {\n              // reset output file\n              if (options.outputFile) saveTextToFile('', options.outputFile);\n              await describeJourneyMd(treeData);\n            }\n          } catch (error) {\n            printMessage(error.message, 'error');\n            process.exitCode = 1;\n          }\n        }\n      }\n    }\n    // end command logic inside action handler\n  );\n\nprogram.parse();\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rockcarver/frodo-cli",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "type": "module",
   "description": "A command line interface to manage ForgeRock Identity Cloud tenants, ForgeOps deployments, and classic deployments.",
   "keywords": [
@@ -88,7 +88,7 @@
     ]
   },
   "dependencies": {
-    "@rockcarver/frodo-lib": "0.15.1",
+    "@rockcarver/frodo-lib": "0.15.2",
     "cli-progress": "^3.11.2",
     "cli-table3": "^0.6.2",
     "colors": "^1.4.0",