contensis-cli 1.4.1-beta.1 → 1.4.2-beta.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [1.4.1](https://github.com/contensis/cli/compare/contensis-cli-v1.4.0...contensis-cli-v1.4.1) (2025-03-04)
+
+
+### Bug Fixes
+
+* issue downloading assets from some environments in `import` commands and progress/error logging fixes when loading assets ([4c8852a](https://github.com/contensis/cli/commit/4c8852a2c0baec4859cb0f9939a5195d1a4130a6))
+* missing environments.json error for new users ([1716094](https://github.com/contensis/cli/commit/171609437b1b483490578f53a499a6dae25855ea))
+
 ## [1.4.0](https://github.com/contensis/cli/compare/contensis-cli-v1.3.0...contensis-cli-v1.4.0) (2024-12-05)
 
 

package/README.md

@@ -246,6 +246,15 @@ contensis >
   - [Get entries using the Delivery API](#get-entries-using-the-delivery-api)
   - [Output results to a file](#output-results-to-a-file)
 - [Format output](#format-output)
+- [Manage tags and tag groups](#manage-tags-and-tag-groups)
+  - [List tag groups](#list-tag-groups)
+  - [List tags](#list-tags)
+  - [List tags in group](#list-tags-in-group)
+  - [Create tag group](#create-tag-group)
+  - [Create tags](#create-tags)
+  - [Create tags in group](#create-tags-in-group)
+  - [Remove tags](#remove-tags)
+  - [Remove tags in group](#remove-tags-in-group)
 - [Manage API keys](#manage-api-keys)
   - [List keys](#list-keys)
   - [Create key](#create-key)
@@ -274,6 +283,7 @@ contensis >
 - [Import content models](#import-content-models)
   - [Import from another Contensis environment](#import-from-another-contensis-environment)
   - [From a file](#from-a-file)
+- [Import tags and groups](#import-tags-and-groups)
 - [Import entries](#import-entries)
   - [Import from another Contensis environment](#import-from-another-contensis-environment-1)
   - [Import from a file](#import-from-a-file-1)
@@ -856,6 +866,283 @@ The `--format` and `--output` options are available with most commands (check co
 
 Output will normally default to JSON when saved with the `--output` flag.
 
+## Manage tags and tag groups
+
+You can use the cli or shell to manage tags and groups that can be used to attach tags to content entries
+
+### List tag groups
+
+Separate collections of tags are organised and stored in tag groups. Each tag belongs to one tag group.
+
+```shell
+website t.durden@example-dev> list taggroups
+[cli] ✅ [example-dev] Retrieved 2 tag groups
+
+  id: keywords
+  name: Keywords
+  description: Contains keyword tags to categorise, filter, and enhance asset discoverability in the CMS
+  tagCount: 0
+
+  id: resourcesTagGroup
+  name: Resources Tag Group
+  description: A tag group that holds tags to show available resources
+  tagCount: 2
+
+website t.durden@example-dev>
+```
+
+### List tags
+
+List tags across all groups or provide further options to filter the output
+
+```shell
+website t.durden@example-dev> list tags
+[24/06 15:52:18] [INFO] Fetching tags in all groups from example-dev website
+[cli] ✅ [example-dev] Retrieved 2 tags
+
+  groupId: resourcesTagGroup
+  id: 01346722-cafc-4c01-9688-a28ea6291fa5
+  value: tag1
+  label:
+  - en-GB: Tag 1
+  usageCount: 1
+
+  groupId: resourcesTagGroup
+  id: bd32ebdb-ab99-40c7-a45b-cd221e00f4d2
+  value: tag2
+  label:
+  - en-GB: Tag 2
+  usageCount: 1
+
+website t.durden@example-dev>
+```
+
+### List tags in group
+
+List a collection of tags in a particular group, providing options to further filter the output
+
+```shell
+[24/06 15:53:21] [INFO] Fetching tags in group resourcesTagGroup from example-dev website
+[cli] ✅ [example-dev] Retrieved 2 tags
+
+  groupId: resourcesTagGroup
+  id: 01346722-cafc-4c01-9688-a28ea6291fa5
+  value: tag1
+  label:
+  - en-GB: Tag 1
+  usageCount: 1
+
+  groupId: resourcesTagGroup
+id: bd32ebdb-ab99-40c7-a45b-cd221e00f4d2
+  value: tag2
+  label:
+  - en-GB: Tag 2
+  usageCount: 1
+
+website t.durden@example-dev>
+```
+
+### Create tag group
+
+Create a new collection of tags by first creating a new tag group, also create some tags in this group by supplying tag name(s) with the `--tags` option
+
+```shell
+website t.durden@example-dev> create taggroup topics "Topics" --tags Books Faces History Places Spelling
+  -------------------------------------
+[cli] ✅ 🔍 IMPORT PREVIEW 🔭
+[25/06 14:03:46] [INFO] Fetching tags in all groups from target environment example-dev website
+
+1/1 tag group to migrate into website
+
+ status     total
+-----------------------
+ create     1
+-----------------------
+
+ id      status    name    description
+--------------------------------------------
+ topics  create    Topics
+--------------------------------------------
+
+5/5 tags to migrate into website
+
+ status     total
+-----------------------
+ create     5
+-----------------------
+
+ id                                    value     status    groupId  label
+------------------------------------------------------------------------------------------
+ 109eb3e9-98c9-5ab2-b9df-f1c80af3ac5c  books     create    topics   {"en-GB":"Books"}
+ d59eddbe-cb9f-51ab-9d22-532f63cd7893  faces     create    topics   {"en-GB":"Faces"}
+ c4cc205f-d543-55c7-8f1a-7490275be437  history   create    topics   {"en-GB":"History"}
+ a7702648-df77-5fbb-b5ec-26a148a39b52  places    create    topics   {"en-GB":"Places"}
+ d8fe7193-6fe7-5c03-bf2e-590e151c47e7  spelling  create    topics   {"en-GB":"Spelling"}
+------------------------------------------------------------------------------------------
+
+[25/06 14:03:46] [OK] Tags migration preview ready
+
+[cli] ✅ Will import 1 tag group and 5 tags into example-dev environment
+
+[cli] ⏩ Add --commit flag to commit the previewed changes
+
+website t.durden@example-dev>
+```
+
+### Create tags
+
+Create one or more tags providing the tag name(s), each name is separated by a space and any tag that contains a space should be wrapped in "double quotes". Specify the tag group to create the tags in with the required `--group` option.
+
+### Create tags in group
+
+Create one or more tags in a tag group providing the `groupId` first and then the tag name(s). Seperate each tag to create by a space and any tag that contains a space should be wrapped in "double quotes"
+
+```shell
+website t.durden@example-dev> create tags in topics Books Faces History Places Spelling
+  -------------------------------------
+[cli] ✅ 🔍 IMPORT PREVIEW 🔭
+[25/06 16:41:41] [INFO] Fetching tags in all groups from target environment example-dev website
+            
+No tag group to migrate into website            
+
+ status     total  
+-----------------------
+ no change  1
+-----------------------
+
+No tags to migrate into website            
+
+ status     total  
+-----------------------
+ no change  5
+-----------------------
+
+[25/06 16:41:42] [OK] Tags migration preview ready
+
+[cli] ❌ [example-dev] Unable to create tags
+
+website t.durden@example-dev>
+```
+
+### Remove tags
+
+Delete one or more tags, provide specific tag ids or delete all tags with the `--all` option
+
+```shell
+website t.durden@example-dev> remove tags 109eb3e9-98c9-5ab2-b9df-f1c80af3ac5c d59eddbe-cb9f-51ab-9d22-532f63cd7893
+  -------------------------------------
+[cli] ✅ 🔍 DELETE PREVIEW 🔭
+[25/06 15:08:53] [INFO] Fetching 2 tags from target environment example-dev website
+[25/06 15:08:53] [INFO] Delete tags preview ready
+
+  groupId: topics
+  id: 109eb3e9-98c9-5ab2-b9df-f1c80af3ac5c
+  value: books
+  label:
+  - en-GB: Books
+  usageCount: 0
+  status: delete
+
+  groupId: topics
+  id: d59eddbe-cb9f-51ab-9d22-532f63cd7893
+  value: faces
+  label:
+  - en-GB: Faces
+  usageCount: 0
+  status: delete
+
+[cli] ✅ [example-dev] Will delete 2 tags
+
+[cli] ⏩ Add --commit flag to commit the previewed changes
+
+website t.durden@example-dev> 
+```
+
+### Remove tags in group
+
+Delete one or more tags in a specific tag group, provide options to filter the returned tags or delete all tags with the `--all` option
+
+```shell
+website t.durden@example-dev> remove tags in topics --all
+  -------------------------------------
+[cli] ✅ 🔍 DELETE PREVIEW 🔭
+[25/06 14:15:20] [INFO] Fetching tags in group topics from target environment example-dev website
+[25/06 14:15:21] [INFO] Delete tags preview ready
+
+  groupId: topics
+  id: 109eb3e9-98c9-5ab2-b9df-f1c80af3ac5c
+  value: books
+  label:
+  - en-GB: Books
+  usageCount: 0
+  status: delete
+
+  groupId: topics
+  id: d59eddbe-cb9f-51ab-9d22-532f63cd7893
+  value: faces
+  label:
+  - en-GB: Faces
+  usageCount: 0
+  status: delete
+
+  groupId: topics
+  id: c4cc205f-d543-55c7-8f1a-7490275be437
+  value: history
+  label:
+  - en-GB: History
+  usageCount: 0
+  status: delete
+
+  groupId: topics
+  id: a7702648-df77-5fbb-b5ec-26a148a39b52
+  value: places
+  label:
+  - en-GB: Places
+  usageCount: 0
+  status: delete
+
+  groupId: topics
+  id: d8fe7193-6fe7-5c03-bf2e-590e151c47e7
+  value: spelling
+  label:
+  - en-GB: Spelling
+  usageCount: 0
+  status: delete
+
+[cli] ✅ [example-dev] Will delete 5 tags
+
+[cli] ⏩ Add --commit flag to commit the previewed changes
+
+website t.durden@example-dev>
+```
+
+### Remove tag group
+
+When all tags have been removed from the tag group we are able to delete the tag group
+
+```shell
+website t.durden@example-dev> remove taggroup topics
+  -------------------------------------
+[cli] ✅ 🔍 DELETE PREVIEW 🔭
+[25/06 14:50:42] [INFO] Delete tag groups preview ready
+
+  id: topics
+  name: Topics
+  version:
+  - versionNo: 1.0
+    created: 2025-06-25T13:06:46.273Z
+    createdBy: testzengenti
+    modified: 2025-06-25T13:06:46.273Z
+    modifiedBy: testzengenti
+  tagCount: 0
+
+[cli] ✅ [example-dev] Will delete tag group topics
+
+[cli] ⏩ Add --commit flag to commit the previewed changes
+
+website t.durden@example-dev>
+```
+
 ## Manage API keys
 
 You can use the cli or shell to manage API keys that are used to provide access to external application integrations
@@ -1090,7 +1377,7 @@ website t.durden@example-dev> set role enabled "Test role"
 [cli] ✅ Succesfully updated role
 
   id: 1329b3cc-0267-480e-a115-b0beaae8fe5b
-  projectId: migratortron
+  projectId: website
   name: Test role
   description: Role to demonstrate cli
   enabled: true
@@ -1549,6 +1836,78 @@ The output will be the same as the `import models` examples above
 
 <sup><sub>Add the `--commit` option to make the changes, be very careful using this! There is no going back</sub></sup>
 
+## Import tags and groups
+### Import from another Contensis environment
+
+Connect to your "source" environment, ensure you can fetch the tags from this environment first and that these are the right tags you plan on importing to your "target" environment.
+
+Choose your required options to check that the right tags will eventually be imported with the `list tags` or `list tags in <groupId>` command
+
+When you are happy the expected tags are being returned for your import, you should then `connect` to your "target" environment (and `set project`) and when we are successfully connected to our target project, call the `import tags` command, ensuring you add any arguments you used with your `list tags` check earlier.
+
+#### Import all tags (and groups) from the source project
+
+```shell
+website t.durden@example-dev> import tags --source-alias example-dev --source-project-id leif
+  -------------------------------------
+[cli] ✅ 🔍 IMPORT PREVIEW 🔭
+[25/06 15:26:37] [INFO] Fetching tags in all groups from example-dev leif
+[25/06 15:26:37] [INFO] Fetching tags in all groups from target environment example-dev website
+            
+1/2 tag groups to migrate into website            
+
+ status     total  
+-----------------------
+ create     1
+ no change  1
+-----------------------
+
+ id                       status    name                        description                         
+------------------------------------------------------------------------------------------------
+ newGroup                 create    New group
+------------------------------------------------------------------------------------------------
+
+            
+5/7 tags to migrate into website            
+
+ status     total  
+-----------------------
+ create     5
+ no change  2
+-----------------------
+
+ id                                    value  status    groupId              label              
+------------------------------------------------------------------------------------------------
+ 02bcb977-1196-4c3f-a921-d2dfce3ca32b  new1   create    newGroup             {"en-GB":"New 1"}  
+ f48eb862-7b73-4a77-a2af-09492a88a8f0  new2   create    newGroup             {"en-GB":"New 2"}  
+ 8673e419-55c9-4ba0-bcd7-28c7c6fa46cc  new3   create    newGroup             {"en-GB":"New 3"}  
+ 90a11d09-3727-45c2-a0df-86f1865828ab  tag3   create    newGroup             {"en-GB":"Tag 3"}  
+ d4267b35-0d25-41ae-bce9-eeb490c793f4  tag3   create    resourcesTagGroup    {"en-GB":"Tag 3"}  
+------------------------------------------------------------------------------------------------
+
+[25/06 15:26:38] [OK] Tags migration preview ready
+
+[cli] ✅ Will import 5 tags into example-dev environment
+
+[cli] ⏩ Add --commit flag to commit the previewed changes
+
+website t.durden@example-dev>
+```
+
+### Import from a file
+
+Import resources directly from a JSON file. The path can be relative or absolute. The file will be processed as an array of Tags (and Tag Groups). Generate a JSON file by exporting some existing tags using the command `list tags --output tags.json`.
+
+```shell
+website t.durden@example-dev> import tags --from-file ./tags.json
+```
+```shell
+website t.durden@example-dev> import taggroups --from-file ./taggroups.json
+```
+```shell
+website t.durden@example-dev> import tags --from-file ./tags-and-groups.json
+```
+
 ## Import entries
 
 ### Import from another Contensis environment

package/dist/commands/create.js

@@ -22,11 +22,13 @@ __export(create_exports, {
 });
 module.exports = __toCommonJS(create_exports);
 var import_commander = require("commander");
+var import_globalOptions = require("./globalOptions");
 var import_ContensisCliService = require("../services/ContensisCliService");
 var import_shell = require("../shell");
+var import_api_ids = require("../util/api-ids");
 const makeCreateCommand = () => {
   const create = new import_commander.Command().command("create").description("create command").addHelpText("after", `
-`).showHelpAfterError(true).exitOverride();
+`).showHelpAfterError(true).enablePositionalOptions().exitOverride();
   create.command("project").description("create a new project").argument("<projectId>", "the id of the project to create").argument("<name>", "the name of the project to create").argument("[description]", "optional description of the project").option(
     "-l --language <language>",
     "the default language of the project to create",
@@ -44,7 +46,8 @@ const makeCreateCommand = () => {
         name,
         description,
         primaryLanguage: opts.language,
-        supportedLanguages: opts.supportedLanguages || []
+        supportedLanguages: opts.supportedLanguages || [],
+        deliverySysExclusions: []
       };
       const project = await (0, import_ContensisCliService.cliCommand)(
         ["create", "project", projectId],
@@ -80,6 +83,84 @@ Example call:
       permissions: { contentTypes: [], entries: [] }
     });
   });
+  create.command("taggroup").description("create a new tag group").argument("<groupId>", "the API id of the tag group to create").argument('<"Name">', "the name of the tag group to create").argument('["Description"]', "a description for the tag group").option(
+    "--tags <tagNames...>",
+    "a list of tag names to create under the new tag group"
+  ).addOption(import_globalOptions.commit).addHelpText(
+    "after",
+    `
+  Example call:
+    > create taggroup example "Example tags" "This group is a test" 
+    > create taggroup topics "Topics" --tags Books Faces History Places Spelling 
+`
+  ).action(
+    async (groupId, name, description, opts) => {
+      var _a;
+      const tagGroup = {
+        id: groupId,
+        name,
+        description
+      };
+      await (0, import_ContensisCliService.cliCommand)(
+        ["create", "taggroup", groupId, name],
+        opts
+      ).ImportTagGroups({
+        commit: opts.commit,
+        data: [tagGroup],
+        tags: (_a = opts.tags) == null ? void 0 : _a.map((label) => ({
+          groupId,
+          label: { "en-GB": label },
+          value: (0, import_api_ids.toApiId)(label, "camelCase", true)
+        }))
+      });
+    }
+  );
+  const tags = create.command("tags").description("create new tags in a tag group").argument('<"Label"...>', "create tag(s) with label(s)").passThroughOptions().option("-in --group <groupId>", "create tags in this tag group").addOption(import_globalOptions.commit).addHelpText(
+    "after",
+    `
+    Example call:
+      > create tags "Test tag" --group example
+      > create tags Books Faces History Places Spelling -in topics 
+`
+  ).action(async (tagLabels, opts) => {
+    var _a;
+    const groupId = opts.group;
+    const cli = (0, import_ContensisCliService.cliCommand)(["create", "tags", ...tagLabels], opts);
+    const language = ((_a = cli.env.projects.find((p) => p.id === cli.env.currentProject)) == null ? void 0 : _a.primaryLanguage) || "en-GB";
+    await cli.ImportTags({
+      commit: opts.commit,
+      data: tagLabels.map((label) => ({
+        groupId,
+        label: { [language]: label },
+        value: (0, import_api_ids.toApiId)(label, "camelCase", true)
+      }))
+    });
+  });
+  tags.command("in").description("create new tags in a tag group").argument("<groupId>", "create tag(s) in this tag group").argument('<"Label"...>', "create tag(s) with label(s)").addOption(import_globalOptions.commit).addHelpText(
+    "after",
+    `
+    Example call:
+      > create tags in example "Tag 1" "Second Tag" Third
+      > create tags ih topics Books Faces History Places Spelling 
+`
+  ).action(async (groupId, tagLabels, opts, cmd) => {
+    var _a;
+    const parentOptions = cmd.optsWithGlobals();
+    const cli = (0, import_ContensisCliService.cliCommand)(["create", "tags", "in", groupId, ...tagLabels], {
+      ...opts,
+      ...parentOptions
+    });
+    const language = ((_a = cli.env.projects.find((p) => p.id === cli.env.currentProject)) == null ? void 0 : _a.primaryLanguage) || "en-GB";
+    await cli.ImportTags({
+      commit: parentOptions.commit,
+      data: tagLabels.map((label) => ({
+        groupId,
+        label: { [language]: label },
+        value: (0, import_api_ids.toApiId)(label, "camelCase", true)
+      }))
+    });
+  });
+  (0, import_globalOptions.addGlobalOptions)(tags);
   return create;
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/commands/create.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/create.ts"],
-  "sourcesContent": ["import { Command } from 'commander';\nimport { Project } from 'contensis-core-api';\nimport { cliCommand } from '~/services/ContensisCliService';\nimport { shell } from '~/shell';\n\nexport const makeCreateCommand = () => {\n  const create = new Command()\n    .command('create')\n    .description('create command')\n    .addHelpText('after', `\\n`)\n    .showHelpAfterError(true)\n    .exitOverride();\n\n  create\n    .command('project')\n    .description('create a new project')\n    .argument('<projectId>', 'the id of the project to create')\n    .argument('<name>', 'the name of the project to create')\n    .argument('[description]', 'optional description of the project')\n    .option(\n      '-l --language <language>',\n      'the default language of the project to create',\n      'en-GB'\n    )\n    .option(\n      '-langs --supported-languages <langs...>',\n      'space separated list of other supported languages'\n    )\n    .usage(\n      'projectId \"Project name\" [\"Description of project\"] --language en-GB --supported-languages es-ES de-DE nl-NL'\n    )\n    .addHelpText('after', `\\n`)\n    .action(\n      async (projectId: string, name: string, description = '', opts: any) => {\n        const createProject: Project = {\n          id: projectId,\n          name,\n          description,\n          primaryLanguage: opts.language,\n          supportedLanguages: opts.supportedLanguages || [],\n        };\n\n        const project = await cliCommand(\n          ['create', 'project', projectId],\n          opts\n        ).CreateProject(createProject);\n        if (project) await shell().restart();\n      }\n    );\n\n  create\n    .command('key')\n    .description('create a new api key')\n    .argument('<\"key name\">', 'the name of the key to create')\n    .argument('[\"description\"]', 'provide a description for the key (optional)')\n    .usage('<\"key name\"> [\"description\"] (both args in \"double quotes\")')\n    .addHelpText(\n      'after',\n      `\nExample call:\n  > create key \"my new key\" \"Created key for demonstration\"\\n`\n    )\n    .action(async (name: string, description: string, opts: any) => {\n      await cliCommand(['create', 'key', name], opts).CreateApiKey(\n        name,\n        description\n      );\n    });\n\n  create\n    .command('role')\n    .description('create a new role')\n    .argument('<\"Role name\">', 'the name of the role to create')\n    .argument('[\"Role description\">', 'the description of the role')\n    .option('--disabled', 'do not enable the created role', false)\n    .addHelpText(\n      'after',\n      `\nExample call:\n  > create role \"My role\" \"This role is for testing\" --disabled \\n`\n    )\n    .action(async (roleName: string, description: string, opts) => {\n      await cliCommand(['create', 'role', roleName], opts).CreateRole({\n        name: roleName,\n        description,\n        enabled: !opts.disabled,\n        assignments: { apiKeys: [], groups: [], users: [] },\n        permissions: { contentTypes: [], entries: [] },\n      });\n    });\n\n  return create;\n};\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAAwB;AAExB,iCAA2B;AAC3B,mBAAsB;AAEf,MAAM,oBAAoB,MAAM;AACrC,QAAM,SAAS,IAAI,yBAAQ,EACxB,QAAQ,QAAQ,EAChB,YAAY,gBAAgB,EAC5B,YAAY,SAAS;AAAA,CAAI,EACzB,mBAAmB,IAAI,EACvB,aAAa;AAEhB,SACG,QAAQ,SAAS,EACjB,YAAY,sBAAsB,EAClC,SAAS,eAAe,iCAAiC,EACzD,SAAS,UAAU,mCAAmC,EACtD,SAAS,iBAAiB,qCAAqC,EAC/D;AAAA,IACC;AAAA,IACA;AAAA,IACA;AAAA,EACF,EACC;AAAA,IACC;AAAA,IACA;AAAA,EACF,EACC;AAAA,IACC;AAAA,EACF,EACC,YAAY,SAAS;AAAA,CAAI,EACzB;AAAA,IACC,OAAO,WAAmB,MAAc,cAAc,IAAI,SAAc;AACtE,YAAM,gBAAyB;AAAA,QAC7B,IAAI;AAAA,QACJ;AAAA,QACA;AAAA,QACA,iBAAiB,KAAK;AAAA,QACtB,oBAAoB,KAAK,sBAAsB,CAAC;AAAA,MAClD;AAEA,YAAM,UAAU,UAAM;AAAA,QACpB,CAAC,UAAU,WAAW,SAAS;AAAA,QAC/B;AAAA,MACF,EAAE,cAAc,aAAa;AAC7B,UAAI,QAAS,WAAM,oBAAM,EAAE,QAAQ;AAAA,IACrC;AAAA,EACF;AAEF,SACG,QAAQ,KAAK,EACb,YAAY,sBAAsB,EAClC,SAAS,gBAAgB,+BAA+B,EACxD,SAAS,mBAAmB,8CAA8C,EAC1E,MAAM,6DAA6D,EACnE;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA,EAGF,EACC,OAAO,OAAO,MAAc,aAAqB,SAAc;AAC9D,cAAM,uCAAW,CAAC,UAAU,OAAO,IAAI,GAAG,IAAI,EAAE;AAAA,MAC9C;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AAEH,SACG,QAAQ,MAAM,EACd,YAAY,mBAAmB,EAC/B,SAAS,iBAAiB,gCAAgC,EAC1D,SAAS,wBAAwB,6BAA6B,EAC9D,OAAO,cAAc,kCAAkC,KAAK,EAC5D;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA,EAGF,EACC,OAAO,OAAO,UAAkB,aAAqB,SAAS;AAC7D,cAAM,uCAAW,CAAC,UAAU,QAAQ,QAAQ,GAAG,IAAI,EAAE,WAAW;AAAA,MAC9D,MAAM;AAAA,MACN;AAAA,MACA,SAAS,CAAC,KAAK;AAAA,MACf,aAAa,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,EAAE;AAAA,MAClD,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,EAAE;AAAA,IAC/C,CAAC;AAAA,EACH,CAAC;AAEH,SAAO;AACT;",
+  "sourcesContent": ["import { Command } from 'commander';\nimport { Project } from 'contensis-core-api';\nimport { addGlobalOptions, commit } from './globalOptions';\nimport { cliCommand } from '~/services/ContensisCliService';\nimport { shell } from '~/shell';\nimport { toApiId } from '~/util/api-ids';\n\nexport const makeCreateCommand = () => {\n  const create = new Command()\n    .command('create')\n    .description('create command')\n    .addHelpText('after', `\\n`)\n    .showHelpAfterError(true)\n    .enablePositionalOptions()\n    .exitOverride();\n\n  create\n    .command('project')\n    .description('create a new project')\n    .argument('<projectId>', 'the id of the project to create')\n    .argument('<name>', 'the name of the project to create')\n    .argument('[description]', 'optional description of the project')\n    .option(\n      '-l --language <language>',\n      'the default language of the project to create',\n      'en-GB'\n    )\n    .option(\n      '-langs --supported-languages <langs...>',\n      'space separated list of other supported languages'\n    )\n    .usage(\n      'projectId \"Project name\" [\"Description of project\"] --language en-GB --supported-languages es-ES de-DE nl-NL'\n    )\n    .addHelpText('after', `\\n`)\n    .action(\n      async (projectId: string, name: string, description = '', opts: any) => {\n        const createProject: Project = {\n          id: projectId,\n          name,\n          description,\n          primaryLanguage: opts.language,\n          supportedLanguages: opts.supportedLanguages || [],\n          deliverySysExclusions: [],\n        };\n\n        const project = await cliCommand(\n          ['create', 'project', projectId],\n          opts\n        ).CreateProject(createProject);\n        if (project) await shell().restart();\n      }\n    );\n\n  create\n    .command('key')\n    .description('create a new api key')\n    .argument('<\"key name\">', 'the name of the key to create')\n    .argument('[\"description\"]', 'provide a description for the key (optional)')\n    .usage('<\"key name\"> [\"description\"] (both args in \"double quotes\")')\n    .addHelpText(\n      'after',\n      `\nExample call:\n  > create key \"my new key\" \"Created key for demonstration\"\\n`\n    )\n    .action(async (name: string, description: string, opts: any) => {\n      await cliCommand(['create', 'key', name], opts).CreateApiKey(\n        name,\n        description\n      );\n    });\n\n  create\n    .command('role')\n    .description('create a new role')\n    .argument('<\"Role name\">', 'the name of the role to create')\n    .argument('[\"Role description\">', 'the description of the role')\n    .option('--disabled', 'do not enable the created role', false)\n    .addHelpText(\n      'after',\n      `\nExample call:\n  > create role \"My role\" \"This role is for testing\" --disabled \\n`\n    )\n    .action(async (roleName: string, description: string, opts) => {\n      await cliCommand(['create', 'role', roleName], opts).CreateRole({\n        name: roleName,\n        description,\n        enabled: !opts.disabled,\n        assignments: { apiKeys: [], groups: [], users: [] },\n        permissions: { contentTypes: [], entries: [] },\n      });\n    });\n\n  create\n    .command('taggroup')\n    .description('create a new tag group')\n    .argument('<groupId>', 'the API id of the tag group to create')\n    .argument('<\"Name\">', 'the name of the tag group to create')\n    .argument('[\"Description\"]', 'a description for the tag group')\n    .option(\n      '--tags <tagNames...>',\n      'a list of tag names to create under the new tag group'\n    )\n    .addOption(commit)\n    .addHelpText(\n      'after',\n      `\n  Example call:\n    > create taggroup example \"Example tags\" \"This group is a test\" \n    > create taggroup topics \"Topics\" --tags Books Faces History Places Spelling \\n`\n    )\n    .action(\n      async (groupId: string, name: string, description: string, opts) => {\n        const tagGroup = {\n          id: groupId,\n          name,\n          description,\n        };\n\n        await cliCommand(\n          ['create', 'taggroup', groupId, name],\n          opts\n        ).ImportTagGroups({\n          commit: opts.commit,\n          data: [tagGroup],\n          tags: opts.tags?.map((label: string) => ({\n            groupId,\n            label: { 'en-GB': label },\n            value: toApiId(label, 'camelCase', true),\n          })),\n        });\n      }\n    );\n\n  const tags = create\n    .command('tags')\n    .description('create new tags in a tag group')\n    .argument('<\"Label\"...>', 'create tag(s) with label(s)')\n    .passThroughOptions()\n    .option('-in --group <groupId>', 'create tags in this tag group')\n    .addOption(commit)\n    .addHelpText(\n      'after',\n      `\n    Example call:\n      > create tags \"Test tag\" --group example\n      > create tags Books Faces History Places Spelling -in topics \\n`\n    )\n    .action(async (tagLabels: string[], opts) => {\n      const groupId = opts.group;\n      const cli = cliCommand(['create', 'tags', ...tagLabels], opts);\n\n      const language =\n        cli.env.projects.find(p => p.id === cli.env.currentProject)\n          ?.primaryLanguage || 'en-GB';\n\n      await cli.ImportTags({\n        commit: opts.commit,\n        data: tagLabels.map(label => ({\n          groupId,\n          label: { [language]: label },\n          value: toApiId(label, 'camelCase', true),\n        })),\n      });\n    });\n\n  tags\n    .command('in')\n    .description('create new tags in a tag group')\n    .argument('<groupId>', 'create tag(s) in this tag group')\n    .argument('<\"Label\"...>', 'create tag(s) with label(s)')\n    .addOption(commit)\n    .addHelpText(\n      'after',\n      `\n    Example call:\n      > create tags in example \"Tag 1\" \"Second Tag\" Third\n      > create tags ih topics Books Faces History Places Spelling \\n`\n    )\n    .action(async (groupId: string, tagLabels: string[], opts, cmd) => {\n      // workaround for opts.commit being always false\n      // read the (shared) options that were parsed by the parent cmd\n      // https://github.com/tj/commander.js/issues/476#issuecomment-1675757628\n      const parentOptions = cmd.optsWithGlobals();\n\n      const cli = cliCommand(['create', 'tags', 'in', groupId, ...tagLabels], {\n        ...opts,\n        ...parentOptions,\n      });\n\n      const language =\n        cli.env.projects.find(p => p.id === cli.env.currentProject)\n          ?.primaryLanguage || 'en-GB';\n\n      await cli.ImportTags({\n        commit: parentOptions.commit,\n        data: tagLabels.map(label => ({\n          groupId,\n          label: { [language]: label },\n          value: toApiId(label, 'camelCase', true),\n        })),\n      });\n    });\n\n  // Add global opts for inner sub-commands\n  addGlobalOptions(tags);\n\n  return create;\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/commands/get.js

@@ -24,8 +24,9 @@ __export(get_exports, {
 module.exports = __toCommonJS(get_exports);
 var import_commander = require("commander");
 var import_lodash = require("lodash");
-var import_ContensisCliService = require("../services/ContensisCliService");
 var import_globalOptions = require("./globalOptions");
+var import_ContensisCliService = require("../services/ContensisCliService");
+var import_assert = require("../util/assert");
 const makeGetCommand = () => {
   const program = new import_commander.Command().command("get").description("get command").addHelpText("after", `
 `).showHelpAfterError(true).exitOverride();
@@ -89,6 +90,37 @@ Example call:
       roleNameOrId
     );
   });
+  program.command("tag").description("get a tag").argument("[idOrLabel]", "find a tag with this id or label").option("-in --group <groupId>", "id of the tag group containing tags").option("-l --language <language>", "find tags in the supplied language").option("-d --dependents", "find and return tag groups for all found tags").addHelpText(
+    "after",
+    `
+    Example call:
+      > get tag "Places" --group topics
+      > get tag "Places" -in topics
+      > get tag "Lieux" --language fr-FR -in topics
+      > get tag d4267b35-0d25-41ae-bce9-eeb490c793f4
+    `
+  ).action(async (idOrlabel, opts) => {
+    await (0, import_ContensisCliService.cliCommand)(["get", "tag", idOrlabel], opts).PrintTag(
+      {
+        id: (0, import_assert.isUuid)(idOrlabel) ? idOrlabel : void 0,
+        groupId: opts.group,
+        label: (0, import_assert.isUuid)(idOrlabel) ? void 0 : idOrlabel,
+        language: opts.language
+      },
+      opts.dependents
+    );
+  });
+  program.command("taggroup").description("get a tag group").argument("<groupId>", "id of the tag group to get").addHelpText(
+    "after",
+    `
+  Example call:
+    > get taggroup topics
+  `
+  ).action(async (groupId, opts) => {
+    await (0, import_ContensisCliService.cliCommand)(["get", "taggroup", groupId], opts).PrintTagGroup(
+      groupId
+    );
+  });
   program.command("webhook").description("get a webhook").argument("<webhookNameOrId...>", "id or name of the webhook(s) to get").addHelpText(
     "after",
     `