contensis-cli 1.0.0-beta.5 → 1.0.0-beta.50

package/src/commands/create.ts

@@ -1,26 +1,55 @@
 import { Command } from 'commander';
+import { Project } from 'contensis-core-api';
 import { cliCommand } from '~/services/ContensisCliService';
 import { shell } from '~/shell';
 
 export const makeCreateCommand = () => {
   const create = new Command()
     .command('create')
+    .description('create command')
+    .addHelpText('after', `\n`)
     .showHelpAfterError(true)
     .exitOverride();
 
   create
     .command('project')
+    .description('create a new project')
     .argument('<projectId>', 'the id of the project to create')
-    .usage('<projectId>')
-    .action(async (projectId: string, opts: any) => {
-      const project = await cliCommand(
-        ['create', 'project', projectId],
-        opts
-      ).SetProject(projectId);
-      if (project) await shell().start();
-    });
+    .argument('<name>', 'the name of the project to create')
+    .argument('[description]', 'optional description of the project')
+    .option(
+      '-l, --language',
+      'the default language of the project to create',
+      'en-GB'
+    )
+    .option(
+      '-langs, --supported-languages <langs...>',
+      'space separated list of other supported languages'
+    )
+    .usage(
+      'projectId "Project name" ["Description of project"] --language en-GB --supported-languages es-ES de-DE nl-NL'
+    )
+    .addHelpText('after', `\n`)
+    .action(
+      async (projectId: string, name: string, description = '', opts: any) => {
+        const createProject: Project = {
+          id: projectId,
+          name,
+          description,
+          primaryLanguage: opts.language,
+          supportedLanguages: opts.supportedLanguages || [],
+        };
+
+        const project = await cliCommand(
+          ['create', 'project', projectId],
+          opts
+        ).CreateProject(createProject);
+        if (project) await shell().restart();
+      }
+    );
   create
     .command('key')
+    .description('create a new api key')
     .argument('<"key name">', 'the name of the key to create')
     .argument('["description"]', 'provide a description for the key (optional)')
     .usage('<"key name"> ["description"] (both args in "double quotes")')

package/src/commands/diff.ts

@@ -0,0 +1,41 @@
+import { Command } from 'commander';
+import { cliCommand } from '~/services/ContensisCliService';
+import { mapContensisOpts } from './globalOptions';
+
+export const makeDiffCommand = () => {
+  const release = new Command()
+    .command('diff')
+    .description('diff command')
+    .addHelpText('after', `\n`)
+    .showHelpAfterError(true)
+    .exitOverride();
+
+  release
+    .command('models')
+    .description('differences with content models')
+    .argument(
+      '[model-ids...]',
+      'ids of any content types or components to diff (optional)'
+    )
+    .usage('[model-ids...]')
+    .addHelpText(
+      'after',
+      `
+Example call:
+  > diff models blogPost\n`
+    )
+    .action(async (modelIds: string[] = [], opts) => {
+      await cliCommand(
+        ['diff', 'models', modelIds.join(' ')],
+        opts,
+        mapContensisOpts({ modelIds, ...opts })
+      ).DiffModels(
+        {
+          ...opts,
+        },
+        modelIds
+      );
+    });
+
+  return release;
+};

package/src/commands/get.ts

@@ -5,11 +5,62 @@ import { mapContensisOpts } from './globalOptions';
 export const makeGetCommand = () => {
   const program = new Command()
     .command('get')
+    .addHelpText('after', `\n`)
     .showHelpAfterError(true)
     .exitOverride();
 
+  program
+    .command('version')
+    .description('get current Contensis version')
+    .addHelpText(
+      'after',
+      `
+Example call:
+  > version
+`
+    )
+    .action(async opts => {
+      await cliCommand(['get', 'version'], opts).PrintContensisVersion();
+    });
+
+  program
+    .command('project')
+    .description('get a project')
+    .argument('[projectId]', 'id of the project to get (default: current)')
+    .addHelpText(
+      'after',
+      `
+Example call:
+  > get project website
+`
+    )
+    .action(async (projectId: string, opts) => {
+      await cliCommand(['get', 'project', projectId], opts).PrintProject(
+        projectId
+      );
+    });
+
+  program
+    .command('model')
+    .description('get a content model')
+    .argument('<contentTypeId...>', 'ids of the content models to get')
+    .addHelpText(
+      'after',
+      `
+Example call:
+  > get model podcast podcastLinks
+`
+    )
+    .action(async (modelIds: string[], opts) => {
+      await cliCommand(
+        ['get', 'model', modelIds.join(' ')],
+        opts
+      ).PrintContentModels(modelIds);
+    });
+
   program
     .command('contenttype')
+    .description('get a content type')
     .argument('<contentTypeId>', 'the API id of the content type to get')
     .addHelpText(
       'after',
@@ -19,12 +70,15 @@ Example call:
 `
     )
     .action(async (contentTypeId: string, opts) => {
-      await cliCommand(['get', 'contenttype'], opts).PrintContentType(
-        contentTypeId
-      );
+      await cliCommand(
+        ['get', 'contenttype', contentTypeId],
+        opts
+      ).PrintContentType(contentTypeId);
     });
+
   program
     .command('component')
+    .description('get a component')
     .argument('<componentId>', 'the API id of the component to get')
     .addHelpText(
       'after',
@@ -34,15 +88,19 @@ Example call:
 `
     )
     .action(async (componentId: string, opts) => {
-      await cliCommand(['get', 'component'], opts).PrintComponent(componentId);
+      await cliCommand(['get', 'component', componentId], opts).PrintComponent(
+        componentId
+      );
     });
+
   program
     .command('entries')
+    .description('get entries')
     .argument(
       '[search phrase]',
       'get entries with the search phrase, use quotes for multiple words'
     )
-    .option('-i --id <id...>', 'the entry id to get')
+    .option('-i --id <id...>', 'the entry id(s) to get')
     .option(
       '-d, --dependents',
       'find and return any dependencies of all found entries'
@@ -76,6 +134,7 @@ Example call:
 
   const block = program
     .command('block')
+    .description('get a block or block version')
     .argument('[blockId]', 'the block to get version details for')
     .argument(
       '[branch]',
@@ -86,6 +145,13 @@ Example call:
       '[version]',
       'get a specific version of the block pushed to the specified branch'
     )
+    .addHelpText(
+      'after',
+      `
+Example call:
+  > get block contensis-website master latest
+`
+    )
     .action(async (blockId: string, branch: string, version: string, opts) => {
       await cliCommand(['get', 'block'], opts).PrintBlockVersions(
         blockId,
@@ -103,6 +169,7 @@ Example call:
 
   block
     .command('logs')
+    .description('get logs for a block')
     .argument('[blockId]', 'the block to get version logs for')
     .argument(
       '[branch]',
@@ -116,6 +183,14 @@ Example call:
     )
     .addArgument(dataCenter)
     .usage('get block logs [blockId] [branch] [version] [dataCenter]')
+    .addHelpText(
+      'after',
+      `
+Example call:
+  > get block logs contensis-website master
+  > get block logs contensis-website master latest london
+`
+    )
     .action(
       async (
         blockId: string,

package/src/commands/globalOptions.ts

@@ -3,19 +3,20 @@ import { url } from '~/util';
 
 export const mapContensisOpts = (opts: any = {}) => ({
   source:
-    opts.sourceCms || opts.sourceProjectId
+    opts.sourceAlias || opts.sourceProjectId
       ? {
-          url: opts.sourceCms
-            ? url(opts.sourceCms, 'website').cms
+          url: opts.sourceAlias
+            ? url(opts.sourceAlias, 'website').cms
             : (undefined as any),
           project: opts.sourceProjectId || (undefined as any),
         }
       : undefined,
+  models: opts.modelIds,
   query:
-    opts.id || opts.phrase || opts.fields
+    opts.id || opts.entryIds || opts.phrase || opts.fields
       ? {
           fields: opts.fields,
-          includeIds: opts.id,
+          includeIds: opts.id || opts.entryIds,
           searchTerm: opts.phrase,
         }
       : undefined,
@@ -36,59 +37,59 @@ const format = new Option(
 
 /* Connect options */
 const alias = new Option(
-  '-a --alias <alias>',
+  '-a, --alias <alias>',
   'the cloud CMS alias to connect your request with'
 );
 
 export const project = new Option(
-  '-p --project-id <projectId>',
+  '-p, --project-id <projectId>',
   'the projectId to make your request with'
 );
 
 /* Authentication options */
 const user = new Option(
-  '-u --user <user>',
+  '-u, --user <user>',
   'the username to authenticate your request with'
 );
 const password = new Option(
-  '-pw --password <password>',
+  '-pw, --password <password>',
   'the password to use to login with (optional/insecure)'
 );
 const clientId = new Option(
-  '-id --client-id <clientId>',
+  '-id, --client-id <clientId>',
   'the clientId to authenticate your request with'
 );
 const sharedSecret = new Option(
-  '-s --shared-secret <sharedSecret>',
+  '-s, --shared-secret <sharedSecret>',
   'the shared secret to use when logging in with a client id'
 );
 
 /* Entry get options */
-const zenql = new Option(
+export const zenql = new Option(
   '-q, --zenql <zenql>',
   'get entries with a supplied ZenQL statement'
 );
 
-const entryId = new Option('-i --id <id...>', 'the entry id to get');
+export const entryId = new Option('-i --id <id...>', 'the entry id(s) to get');
 
 /* Import options */
 export const fromFile = new Option(
-  '-file --from-file <fromFile>',
+  '-file, --from-file <fromFile>',
   'file path to import asset(s) from'
 );
 
 export const fromCms = new Option(
-  '-source --source-alias <fromCms>',
+  '-source, --source-alias <fromCms>',
   'the cloud CMS alias to import asset(s) from'
 );
 export const fromProject = new Option(
-  '-sp --source-project-id <fromProject>',
+  '-sp, --source-project-id <fromProject>',
   'the id of the Contensis project to import asset(s) from (Default: [last connected project])'
 );
 
 export const commit = new Option(
   '--commit',
-  'omit and only add this flag when you are happy with the preview of the import'
+  'add this flag only after you have run a preview of the import and agree with the analysis'
 ).default(false);
 
 export const addConnectOptions = (program: Command) =>

package/src/commands/import.ts

@@ -6,15 +6,43 @@ import { commit, mapContensisOpts } from './globalOptions';
 export const makeImportCommand = () => {
   const program = new Command()
     .command('import')
+    .description('import command')
+    .addHelpText('after', `\n`)
     .showHelpAfterError(true)
     .exitOverride();
 
+  program
+    .command('models')
+    .description('import complete content models')
+    .argument('[modelIds...]', 'ids of the content models to import (optional)')
+    .addOption(commit)
+    .addHelpText(
+      'after',
+      `
+Example call:
+  > import models blogPost --from-file contentmodels-backup.json
+  > import models --source-alias example-dev
+`
+    )
+    .action(async (modelIds: string[], opts) => {
+      await cliCommand(
+        ['import', 'models', modelIds.join(' ')],
+        opts,
+        mapContensisOpts({ modelIds, ...opts })
+      ).ImportContentModels({
+        fromFile: opts.fromFile,
+        commit: opts.commit,
+      });
+    });
+
   program
     .command('contenttypes')
+    .description('import content types')
     .argument(
-      '[contentTypeIds]',
+      '[contentTypeIds...]',
       'Optional list of API id(s) of the content type(s) to import'
     )
+    .addOption(commit)
     .addHelpText(
       'after',
       `
@@ -24,7 +52,11 @@ Example call:
 `
     )
     .action(async (contentTypeIds: string[], opts) => {
-      await cliCommand(['import', 'contenttypes'], opts).ImportContentTypes(
+      await cliCommand(
+        ['import', 'contenttypes'],
+        opts,
+        mapContensisOpts({ contentTypeIds, ...opts })
+      ).ImportContentTypes(
         {
           fromFile: opts.fromFile,
           commit: opts.commit,
@@ -35,10 +67,12 @@ Example call:
 
   program
     .command('components')
+    .description('import components')
     .argument(
-      '[componentIds]',
+      '[componentIds...]',
       'Optional list of API id(s) of the component(s) to import'
     )
+    .addOption(commit)
     .addHelpText(
       'after',
       `
@@ -48,7 +82,11 @@ Example call:
 `
     )
     .action(async (componentIds: string[], opts) => {
-      await cliCommand(['import', 'component'], opts).ImportComponents(
+      await cliCommand(
+        ['import', 'component'],
+        opts,
+        mapContensisOpts({ componentIds, ...opts })
+      ).ImportComponents(
         {
           fromFile: opts.fromFile,
           commit: opts.commit,
@@ -59,6 +97,7 @@ Example call:
 
   program
     .command('entries')
+    .description('import entries')
     .argument(
       '[search phrase]',
       'get entries with the search phrase, use quotes for multiple words'

package/src/commands/index.ts

@@ -3,6 +3,7 @@ import { Logger } from '~/util/logger';
 import { LIB_VERSION } from '~/version';
 import { makeConnectCommand } from './connect';
 import { makeCreateCommand } from './create';
+import { makeDiffCommand } from './diff';
 import { makeGetCommand } from './get';
 import {
   addAuthenticationOptions,
@@ -15,6 +16,7 @@ import { makeImportCommand } from './import';
 import { makeListCommand } from './list';
 import { makeLoginCommand } from './login';
 import { makePushCommand } from './push';
+import { makeReleaseCommand } from './release';
 import { makeRemoveCommand } from './remove';
 import { makeSetCommand } from './set';
 
@@ -37,9 +39,12 @@ const commands = () => {
       program
     )
   );
+  program.addCommand(
+    addGlobalOptions(makeCreateCommand()).copyInheritedSettings(program)
+  );
   program.addCommand(
     addGlobalOptions(
-      addImportOptions(makeCreateCommand())
+      addGetEntryOptions(addImportOptions(makeDiffCommand()))
     ).copyInheritedSettings(program)
   );
   program.addCommand(
@@ -59,6 +64,9 @@ const commands = () => {
   program.addCommand(
     addGlobalOptions(makePushCommand()).copyInheritedSettings(program)
   );
+  program.addCommand(
+    addGlobalOptions(makeReleaseCommand()).copyInheritedSettings(program)
+  );
   program.addCommand(
     addGlobalOptions(makeRemoveCommand()).copyInheritedSettings(program)
   );

package/src/commands/list.ts

@@ -1,20 +1,17 @@
 import { Command } from 'commander';
 import { cliCommand } from '~/services/ContensisCliService';
 
-// projects
-// content types
-// components
-// api keys
-// roles
-// webhooks
 export const makeListCommand = () => {
   const list = new Command()
     .command('list')
+    .description('list command')
+    .addHelpText('after', `\n`)
     .showHelpAfterError(true)
     .exitOverride();
 
   list
     .command('envs')
+    .description('List all previously connected environments')
     .addHelpText(
       'after',
       `
@@ -25,11 +22,31 @@ Example call:
     .action(opts => {
       cliCommand(['list', 'envs'], opts).PrintEnvironments();
     });
-  list.command('projects').action(async opts => {
-    await cliCommand(['list', 'projects'], opts).PrintProjects();
-  });
+
+  list
+    .command('projects')
+    .description('print list of projects')
+    .action(async opts => {
+      await cliCommand(['list', 'projects'], opts).PrintProjects();
+    });
+
+  list
+    .command('models')
+    .description('print list of content models')
+    .addHelpText(
+      'after',
+      `
+Example call:
+  > list models
+`
+    )
+    .action(async opts => {
+      await cliCommand(['list', 'models'], opts).PrintContentModels();
+    });
+
   list
     .command('contenttypes')
+    .description('print list of content types')
     .addHelpText(
       'after',
       `
@@ -40,8 +57,10 @@ Example call:
     .action(async opts => {
       await cliCommand(['list', 'contenttypes'], opts).PrintContentTypes();
     });
+
   list
     .command('components')
+    .description('print list of components')
     .addHelpText(
       'after',
       `
@@ -52,8 +71,10 @@ Example call:
     .action(async opts => {
       await cliCommand(['list', 'components'], opts).PrintComponents();
     });
+
   list
     .command('blocks')
+    .description('print list of content blocks')
     .addHelpText(
       'after',
       `
@@ -64,8 +85,10 @@ Example call:
     .action(async opts => {
       await cliCommand(['list', 'blocks'], opts).PrintBlocks();
     });
+
   list
     .command('keys')
+    .description('print list of API keys')
     .addHelpText(
       'after',
       `
@@ -76,10 +99,13 @@ Example call:
     .action(async opts => {
       await cliCommand(['list', 'keys'], opts).PrintApiKeys();
     });
+
   list
     .command('webhooks')
+    .description('print list of webhooks')
     .argument('[name]', 'find webhooks matching the supplied name')
     .option('-i --id <id...>', 'the subscription id(s) to get')
+    .addHelpText('after', `\n`)
     .action(async (name?: string, { id, ...opts }: any = {}) => {
       await cliCommand(['list', 'webhooks'], opts).PrintWebhookSubscriptions(
         id,

package/src/commands/login.ts

@@ -5,13 +5,14 @@ import { shell } from '~/shell';
 export const makeLoginCommand = () => {
   const login = new Command()
     .command('login')
+    .description('login to a connected Contensis instance')
     .argument('<user/clientId>', 'the username to login with')
     .argument(
       '[password]',
       'the password to use to login with (optional/insecure)'
     )
     .option(
-      '-s --shared-secret <sharedSecret>',
+      '-s, --shared-secret <sharedSecret>',
       'the shared secret to use when logging in with a client id'
     )
     .usage('<user/clientId> [password] [-s <sharedSecret>]')
@@ -27,7 +28,7 @@ Example call:
         password,
         sharedSecret: opts.sharedSecret,
       });
-      if (token) await shell().start();
+      if (token) await shell().restart();
     });
   return login;
 };

package/src/commands/push.ts

@@ -6,11 +6,14 @@ import { cliCommand } from '~/services/ContensisCliService';
 export const makePushCommand = () => {
   const push = new Command()
     .command('push')
+    .description('push command')
+    .addHelpText('after', `\n`)
     .showHelpAfterError(true)
     .exitOverride();
 
   push
     .command('block')
+    .description('push a block')
     .argument('<block-id>', 'the name of the block to push to')
     .argument(
       '<image uri:tag>',
@@ -55,7 +58,7 @@ export const makePushCommand = () => {
       'after',
       `
 Example call:
-  > push block contensis-app ghcr.io/contensis/contensis-app/build-4359 master --release\n`
+  > push block contensis-app ghcr.io/contensis/contensis-app/app:build-4359 master --release\n`
     )
     .action(async (blockId: string, imageUri: string, branch: string, opts) => {
       const cli = cliCommand(['push', 'block', blockId], opts);
@@ -99,7 +102,11 @@ Example call:
           branch: ['branch', 'CI_COMMIT_REF_NAME', 'GITHUB_REF_NAME'],
           commit: {
             id: ['commitId', 'CI_COMMIT_SHORT_SHA', 'GITHUB_SHA'],
-            message: ['commitMessage', 'CI_COMMIT_MESSAGE'], // ${{ github.event.head_commit.message }}
+            message: {
+              $path: ['commitMessage', 'CI_COMMIT_MESSAGE'], // ${{ github.event.head_commit.message }}
+              $formatting: (msg?: string) =>
+                msg?.replace(/\\n/g, ' ').replace(/\\n/g, ' ').trim(),
+            },
             dateTime: ['commitDatetime', 'CI_COMMIT_TIMESTAMP'], // ${{ github.event.head_commit.timestamp }}
             authorEmail: ['authorEmail', 'GITLAB_USER_EMAIL', 'GITHUB_ACTOR'], // ${{ github.event.head_commit.author.email }}
             committerEmail: [

package/src/commands/release.ts

@@ -0,0 +1,32 @@
+import { Command } from 'commander';
+import { cliCommand } from '~/services/ContensisCliService';
+
+export const makeReleaseCommand = () => {
+  const release = new Command()
+    .command('release')
+    .description('release command')
+    .addHelpText('after', `\n`)
+    .showHelpAfterError(true)
+    .exitOverride();
+
+  release
+    .command('block')
+    .description('release a block version')
+    .argument('<block-id>', 'the name of the block to release')
+    .argument('<version>', 'the block version to release')
+    .usage('<block-id> <version>')
+    .addHelpText(
+      'after',
+      `
+Example call:
+  > release block contensis-app 3\n`
+    )
+    .action(async (blockId: string, version: string, opts) => {
+      await cliCommand(['release', 'block', blockId], opts).ReleaseBlock(
+        blockId,
+        version
+      );
+    });
+
+  return release;
+};