contensis-cli 1.0.0-beta.5

package/src/services/ContensisCliService.ts

@@ -0,0 +1,1390 @@
+import fs from 'fs';
+import path from 'path';
+import fetch from 'node-fetch';
+import inquirer from 'inquirer';
+import to from 'await-to-js';
+import { Component, ContentType } from 'contensis-core-api';
+import { isPassword, isSharedSecret, isUuid, url } from '~/util';
+import SessionCacheProvider from '../providers/SessionCacheProvider';
+import ContensisAuthService from './ContensisAuthService';
+import CredentialProvider from '~/providers/CredentialProvider';
+import { logError, Logger } from '~/util/logger';
+import { LogMessages } from '~/localisation/en-GB';
+import {
+  ContensisMigrationService,
+  MigrateRequest,
+  PushBlockParams,
+  SourceCms,
+  logEntriesTable,
+} from 'migratortron';
+import { Entry } from 'contensis-management-api/lib/models';
+
+import { csvFormatter } from '~/util/csv.formatter';
+import { xmlFormatter } from '~/util/xml.formatter';
+import { jsonFormatter } from '~/util/json.formatter';
+import { printBlockVersion, printMigrateResult } from '~/util/console.printer';
+import { readJsonFile } from '~/providers/file-provider';
+
+type OutputFormat = 'json' | 'csv' | 'xml';
+
+type OutputOptions = {
+  format?: OutputFormat;
+  output?: string;
+};
+
+interface IConnectOptions extends IAuthOptions {
+  alias?: string;
+  projectId?: string;
+}
+
+interface IAuthOptions {
+  user?: string;
+  password?: string;
+  clientId?: string;
+  sharedSecret?: string;
+}
+
+interface IImportOptions {
+  sourceEnv?: string;
+  sourceProjectId?: string;
+}
+
+class ContensisCli {
+  static quit = (error?: Error) => {
+    process.removeAllListeners('exit');
+    const exitCode = error ? 1 : 0;
+
+    console.info(`\nExiting contensis-cli with exit code: ${exitCode}\n`);
+    process.exit(exitCode);
+  };
+
+  cache: SessionCache;
+  contensis?: ContensisMigrationService;
+  contensisOpts: Partial<MigrateRequest>;
+  contentTypes?: ContentType[];
+  components?: Component[];
+  currentEnv: string;
+  currentProject: string;
+  env: EnvironmentCache;
+  sourceEnv?: string;
+  targetEnv?: string;
+  urls:
+    | {
+        api: string;
+        cms: string;
+        liveWeb: string;
+        previewWeb: string;
+        iisWeb: string;
+        iisPreviewWeb: string;
+      }
+    | undefined;
+  private command: CliCommand;
+  private format?: OutputFormat;
+  private output?: string;
+  log = Logger;
+  messages = LogMessages;
+  private session: SessionCacheProvider;
+
+  verb: string;
+  noun: string;
+  thirdArg: string;
+
+  constructor(
+    args: string[],
+    outputOpts?: OutputOptions & IConnectOptions & IImportOptions,
+    contensisOpts: Partial<MigrateRequest> = {}
+  ) {
+    // console.log('args: ', JSON.stringify(args, null, 2));
+
+    const [exe, script, verb = '', noun = '', ...restArgs] = args;
+    this.verb = verb?.toLowerCase();
+    this.noun = noun?.toLowerCase();
+    this.thirdArg = restArgs?.[0];
+
+    const commandText = `${this.verb} ${this.noun} ${
+      restArgs ? restArgs.join(' ') : ''
+    }`.trim();
+
+    this.session = new SessionCacheProvider();
+    this.cache = this.session.Get();
+    this.contensisOpts = contensisOpts;
+    this.format = outputOpts?.format;
+    this.output =
+      outputOpts?.output && path.join(process.cwd(), outputOpts.output);
+
+    const currentEnvironment =
+      outputOpts?.alias || this.cache.currentEnvironment || '';
+    const environments = this.cache.environments || {};
+
+    if (!currentEnvironment) this.env = {} as EnvironmentCache;
+    else if (!!environments[currentEnvironment])
+      this.env = environments[currentEnvironment];
+    else {
+      this.env = {
+        history: [],
+        lastUserId: '',
+        projects: [],
+        versionStatus: 'latest',
+      };
+    }
+
+    const env = this.env;
+
+    if (outputOpts?.projectId) env.currentProject = outputOpts.projectId;
+    if (outputOpts?.user) env.lastUserId = outputOpts.user;
+    if (outputOpts?.password) env.passwordFallback = outputOpts.password;
+    if (outputOpts?.clientId) env.lastUserId = outputOpts.clientId;
+    if (outputOpts?.sharedSecret)
+      env.passwordFallback = outputOpts.sharedSecret;
+
+    this.currentEnv = currentEnvironment;
+    this.currentProject = env?.currentProject || 'null';
+    this.sourceEnv = outputOpts?.sourceEnv || currentEnvironment;
+
+    if (currentEnvironment) {
+      this.urls = url(currentEnvironment, env?.currentProject || 'website');
+    }
+
+    this.command = {
+      commandText,
+      createdDate: new Date().toISOString(),
+      createdUserId: env?.lastUserId,
+    };
+
+    if (currentEnvironment) {
+      env.history = [this.command];
+      if (commandText) {
+        environments[currentEnvironment] = this.env;
+        this.session.Update({
+          currentEnvironment,
+          environments,
+          history: [commandText],
+        });
+      }
+    }
+  }
+
+  PrintEnvironments = () => {
+    const { log, messages } = this;
+    const { currentEnvironment, environments = {} } = this.cache;
+    const envKeys = Object.keys(environments);
+    log.success(messages.envs.found(envKeys.length));
+    this.HandleFormattingAndOutput(envKeys, () => {
+      // print the envKeys to console
+      for (const env of envKeys) {
+        console.log(`  - ${currentEnvironment === env ? '* ' : ''}${env}`);
+      }
+    });
+    if (envKeys.length === 0 || !currentEnvironment) {
+      log.help(messages.envs.tip());
+    }
+  };
+
+  Connect = async (environment: string) => {
+    const { cache, log, messages, session } = this;
+
+    if (environment) {
+      const envCache = cache.environments[environment];
+      if (!envCache)
+        cache.environments[environment] = {
+          versionStatus: 'published',
+          history: [],
+          lastUserId: '',
+          projects: [],
+          ...(!this.currentEnv ? this.env : {}),
+        };
+
+      this.env = cache.environments[environment];
+      this.currentEnv = environment;
+      this.urls = url(environment, 'website');
+
+      const [fetchErr, response] = await to(fetch(this.urls.cms));
+      if (response && response?.status < 400) {
+        log.success(messages.connect.connected(environment));
+
+        if (this.env?.lastUserId) {
+          await this.ConnectContensis();
+          await this.PrintProjects();
+        } else {
+          log.warning(messages.projects.noList());
+          log.help(messages.connect.tip());
+          // cache.environments[environment] = {
+          //   versionStatus: 'published',
+          //   history: [],
+          //   lastUserId: '',
+          //   projects: [],
+          // };
+        }
+
+        session.Update({
+          currentEnvironment: environment,
+          environments: cache.environments,
+        });
+      } else {
+        // Cannot reach environment - status X
+        log.error(
+          messages.connect.unreachable(this.urls.cms, response?.status || 0)
+        );
+      }
+    } else {
+      // No environment alias specified
+      log.error(messages.connect.noEnv());
+    }
+  };
+
+  ConnectContensis = async ({ commit = false } = {}) => {
+    const { contensisOpts, currentEnv, env, log, messages } = this;
+    const userId = env?.lastUserId;
+    const isGuidId = userId && isUuid(userId);
+
+    if (currentEnv && userId) {
+      const [credentialError, credentials] = await new CredentialProvider(
+        {
+          userId,
+          alias: currentEnv,
+        },
+        env.passwordFallback
+      ).Init();
+
+      if (credentialError && !credentials.current) {
+        // Log problem with Credential Provider
+        log.error(credentialError as any);
+        return;
+      }
+      const cachedPassword = credentials?.current?.password;
+
+      if (cachedPassword) {
+        this.contensis = new ContensisMigrationService(
+          {
+            ...contensisOpts,
+            source: {
+              url: this.urls?.cms || '',
+              username: !isGuidId ? userId : undefined,
+              password: !isGuidId ? cachedPassword : undefined,
+              clientId: isGuidId ? userId : undefined,
+              sharedSecret: isGuidId ? cachedPassword : undefined,
+              project: env?.currentProject || '',
+              assetHostname: this.urls?.previewWeb,
+            },
+            concurrency:
+              typeof contensisOpts.concurrency !== 'undefined'
+                ? contensisOpts.concurrency
+                : 3,
+            outputProgress: true,
+          },
+          !commit
+        );
+      }
+    } else {
+      if (!currentEnv) log.help(messages.connect.help());
+      if (!userId) log.help(messages.connect.tip());
+    }
+  };
+
+  ConnectContensisImport = async ({
+    commit,
+    source,
+    fileData,
+    fileDataType,
+  }: {
+    commit: boolean;
+    source: 'contensis' | 'file' | 'input';
+    fileData?: any[] | string;
+    fileDataType?: 'entries' | 'contentTypes' | 'components';
+  }) => {
+    const { contensisOpts, currentEnv, env, log, messages, sourceEnv } = this;
+    const environments = this.cache.environments || {};
+    const sourceEnvironment = environments[sourceEnv || ''] || {};
+    const sourceCms =
+      ('source' in contensisOpts && contensisOpts.source) ||
+      ({} as Partial<SourceCms>);
+    const sourceUserId =
+      sourceCms.clientId || sourceCms.username || sourceEnvironment.lastUserId;
+    const sourceProjectId =
+      sourceCms.project || sourceEnvironment.currentProject || 'website';
+    const isSourceGuidId = sourceUserId && isUuid(sourceUserId);
+    const sourceUrls = url(sourceEnv || '', sourceProjectId);
+
+    const sourcePassword =
+      sourceCms.sharedSecret ||
+      sourceCms.password ||
+      sourceEnvironment.passwordFallback;
+
+    const targetUserId = env?.lastUserId;
+    const isTargetGuidId = targetUserId && isUuid(targetUserId);
+
+    if (sourceUserId && currentEnv && targetUserId) {
+      const [sourceCredentialError, sourceCredentials] =
+        await new CredentialProvider(
+          {
+            userId: sourceUserId,
+            alias: currentEnv,
+          },
+          sourcePassword
+        ).Init();
+
+      if (sourceCredentialError && !sourceCredentials.current) {
+        // Log problem with Credential Provider
+        logError(sourceCredentialError);
+        return;
+      }
+      const cachedSourcePassword = sourceCredentials?.current?.password;
+
+      const [targetCredentialError, targetCredentials] =
+        await new CredentialProvider(
+          {
+            userId: targetUserId,
+            alias: currentEnv,
+          },
+          env.passwordFallback
+        ).Init();
+
+      if (targetCredentialError && !targetCredentials.current) {
+        // Log problem with Credential Provider
+        log.error(targetCredentialError as any);
+        return;
+      }
+      const cachedTargetPassword = targetCredentials?.current?.password;
+
+      if (cachedSourcePassword && cachedTargetPassword) {
+        if (source === 'file' || source === 'input') {
+          this.contensis = new ContensisMigrationService(
+            {
+              concurrency: 3,
+              outputProgress: true,
+              ...contensisOpts,
+              target: {
+                url: this.urls?.cms || '',
+                username: !isTargetGuidId ? targetUserId : undefined,
+                password: !isTargetGuidId ? cachedTargetPassword : undefined,
+                clientId: isTargetGuidId ? targetUserId : undefined,
+                sharedSecret: isTargetGuidId ? cachedTargetPassword : undefined,
+                targetProjects: [env.currentProject || ''],
+                assetHostname: this.urls?.previewWeb,
+              },
+              ...(fileDataType ? { [fileDataType]: fileData } : {}),
+            },
+            !commit
+          );
+        }
+        if (source === 'contensis') {
+          this.contensis = new ContensisMigrationService(
+            {
+              concurrency: 3,
+              outputProgress: true,
+              ...contensisOpts,
+              source: {
+                url: sourceUrls.cms || '',
+                username: !isSourceGuidId ? sourceUserId : undefined,
+                password: !isSourceGuidId ? cachedSourcePassword : undefined,
+                clientId: isSourceGuidId ? sourceUserId : undefined,
+                sharedSecret: isSourceGuidId ? cachedSourcePassword : undefined,
+                project: sourceProjectId,
+                assetHostname: sourceUrls.previewWeb,
+              },
+              target: {
+                url: this.urls?.cms || '',
+                username: !isTargetGuidId ? targetUserId : undefined,
+                password: !isTargetGuidId ? cachedTargetPassword : undefined,
+                clientId: isTargetGuidId ? targetUserId : undefined,
+                sharedSecret: isTargetGuidId ? cachedTargetPassword : undefined,
+                targetProjects: [env.currentProject || ''],
+                assetHostname: this.urls?.previewWeb,
+              },
+            },
+            !commit
+          );
+        }
+      }
+    } else {
+      if (!currentEnv) log.help(messages.connect.help());
+      if (!targetUserId) log.help(messages.connect.tip());
+    }
+  };
+
+  Login = async (
+    userId: string,
+    {
+      password = isPassword(this.env.passwordFallback),
+      promptPassword = true,
+      sharedSecret = isSharedSecret(this.env.passwordFallback),
+      silent = false,
+    }: {
+      password?: string;
+      promptPassword?: boolean;
+      sharedSecret?: string;
+      silent?: boolean;
+    }
+  ): Promise<string | undefined> => {
+    let inputPassword = password;
+    const { log, messages } = this;
+
+    if (userId) {
+      const { cache, currentEnv, env } = this;
+
+      if (currentEnv) {
+        const [credentialError, credentials] = await new CredentialProvider(
+          { userId, alias: currentEnv },
+          inputPassword || sharedSecret
+        ).Init();
+
+        if (credentialError && !credentials.current) {
+          // Log problem with Credential Provider
+          log.error(credentialError as any);
+          return;
+        }
+
+        if (credentials.remarks.secure !== true)
+          log.warning(messages.login.insecurePassword());
+
+        const cachedPassword = isPassword(credentials?.current?.password);
+        const cachedSecret = isSharedSecret(credentials?.current?.password);
+
+        if (
+          !sharedSecret &&
+          !inputPassword &&
+          !cachedPassword &&
+          !cachedSecret &&
+          promptPassword
+        ) {
+          // Password prompt
+          ({ inputPassword } = await inquirer.prompt([
+            {
+              type: 'password',
+              message: messages.login.passwordPrompt(currentEnv, userId),
+              name: 'inputPassword',
+              mask: '*',
+              prefix: undefined,
+            },
+          ]));
+        }
+
+        if (sharedSecret || cachedSecret || inputPassword || cachedPassword) {
+          const authService = new ContensisAuthService({
+            username: userId,
+            password: inputPassword || cachedPassword,
+            projectId: env?.currentProject || 'website',
+            rootUrl: this.urls?.cms || '',
+            clientId: userId,
+            clientSecret: sharedSecret || cachedSecret,
+          });
+
+          const [authError, bearerToken] = await to(authService.BearerToken());
+
+          // Login successful
+          if (bearerToken) {
+            // Set env vars
+            env.authToken = bearerToken;
+            env.lastUserId = userId;
+            env.passwordFallback =
+              credentials.remarks.secure !== true
+                ? credentials.current?.password
+                : undefined;
+
+            if (!silent) {
+              Logger.success(messages.login.success(currentEnv, userId));
+              await this.PrintProjects();
+            }
+            if (inputPassword) await credentials.Save(inputPassword);
+            if (sharedSecret) await credentials.Save(sharedSecret);
+          } else if (authError) {
+            Logger.error(authError.toString());
+            // Clear env vars
+            env.authToken = '';
+            env.lastUserId = '';
+            env.passwordFallback = undefined;
+
+            // If the auth error was raised using a cached password
+            if (
+              (cachedPassword || cachedSecret) &&
+              credentials.remarks.secure
+            ) {
+              // Remove any bad stored credential and trigger login prompt again
+              await credentials.Delete();
+              return await this.Login(userId, { password, sharedSecret });
+            } else {
+              throw new Error(messages.login.failed(currentEnv, userId));
+            }
+          }
+
+          // Persist env
+          this.session.Update({
+            environments: cache.environments,
+          });
+          return env.authToken;
+        } else {
+          Logger.error(messages.login.passwordPrompt(currentEnv, userId));
+        }
+      } else {
+        // No environment set, use `contensis connect {alias}` first
+        Logger.error(messages.login.noEnv());
+      }
+    } else {
+      // No user id specified
+      Logger.error(messages.login.noUserId());
+    }
+  };
+
+  PrintProjects = async () => {
+    const { cache, currentEnv, currentProject, log, messages, session } = this;
+    if (!this.contensis) await this.ConnectContensis();
+
+    if (this.contensis) {
+      // Retrieve projects list for env
+      const [projectsErr, projects] = await to(
+        this.contensis.projects.GetSourceProjects()
+      );
+
+      if (Array.isArray(projects)) {
+        // save these projects in cache
+        const currentVals = cache.environments[currentEnv] || {};
+        const nextCurrentProject =
+          currentProject && currentProject !== 'null'
+            ? currentProject
+            : projects.some(p => p.id === 'website')
+            ? 'website'
+            : undefined;
+
+        cache.environments[currentEnv] = {
+          ...currentVals,
+          projects: projects.map(p => p.id),
+          currentProject: nextCurrentProject,
+        };
+
+        log.success(messages.projects.list());
+        this.HandleFormattingAndOutput(projects, () => {
+          // print the projects to console
+          for (const project of projects) {
+            console.log(
+              `  - ${nextCurrentProject === project.id ? '* ' : ''}[${
+                project.primaryLanguage
+              }] ${project.id}`
+            );
+          }
+        });
+
+        session.Update({
+          environments: cache.environments,
+        });
+
+        if (nextCurrentProject) {
+          this.env = cache.environments[currentEnv];
+          this.SetProject(nextCurrentProject);
+        }
+      }
+
+      if (projectsErr) {
+        log.error(messages.projects.noList());
+        log.error(projectsErr.message);
+      }
+      // } else {
+      //   log.warning(messages.projects.noList());
+      //   log.help(messages.connect.tip());
+    }
+  };
+
+  SetProject = async (projectId = '') => {
+    const { cache, env, log, messages, session } = this;
+    let nextProjectId: string | undefined;
+    if (env?.projects.length > 0 && env?.lastUserId) {
+      nextProjectId = env.projects.find(
+        p => p.toLowerCase() === projectId.toLowerCase()
+      );
+      if (nextProjectId) {
+        env.currentProject = nextProjectId;
+        session.Update({
+          environments: cache.environments,
+        });
+        log.success(messages.projects.set(projectId));
+      } else {
+        log.error(messages.projects.failedSet(projectId));
+      }
+    } else {
+      // No projects for currentEnv, try logging in
+      log.warning(messages.projects.noList());
+      log.help(messages.connect.tip());
+    }
+    return nextProjectId;
+  };
+
+  SetVersion = async (versionStatus: 'latest' | 'published') => {
+    const { cache, env, log, messages, session } = this;
+    if (!['latest', 'published'].includes(versionStatus)) {
+      log.error(messages.version.invalid(versionStatus));
+      return false;
+    }
+    if (!env) {
+      log.help(messages.version.noEnv());
+      return false;
+    }
+    if (env?.projects.length > 0 && env?.lastUserId) {
+      env.versionStatus = versionStatus;
+      session.Update({
+        environments: cache.environments,
+      });
+      log.success(messages.version.set(this.currentEnv, versionStatus));
+      return true;
+    } else {
+      // No projects for currentEnv, try logging in
+      log.warning(messages.projects.noList());
+      log.help(messages.connect.tip());
+      return false;
+    }
+  };
+
+  HydrateContensis = async () => {
+    const { log } = this;
+    if (!this.contensis) await this.ConnectContensis();
+
+    if (this.contensis) {
+      // Retrieve content types list for env
+      const [contensisErr, models] = await to(
+        this.contensis.models.HydrateContensisRepositories()
+      );
+
+      if (contensisErr) {
+        log.error(contensisErr.message);
+        return contensisErr;
+      }
+    }
+  };
+
+  PrintApiKeys = async () => {
+    const { currentEnv, log, messages } = this;
+    if (!this.contensis) await this.ConnectContensis();
+
+    if (this.contensis) {
+      // Retrieve keys list for env
+      const [keysErr, apiKeys] = await this.contensis.apiKeys.GetKeys();
+
+      if (Array.isArray(apiKeys)) {
+        log.success(messages.keys.list(currentEnv));
+        this.HandleFormattingAndOutput(apiKeys, () => {
+          // print the keys to console
+          for (const {
+            id,
+            sharedSecret,
+            name,
+            description,
+            dateModified,
+            modifiedBy,
+          } of apiKeys) {
+            console.log(
+              `  - ${name}${
+                description ? ` (${description})` : ''
+              } [${dateModified.toString().substring(0, 10)} ${modifiedBy}]`
+            );
+            console.log(`      ${id}`);
+            console.log(`      ${sharedSecret}`);
+          }
+        });
+      }
+
+      if (keysErr) {
+        log.error(messages.keys.noList(currentEnv));
+        log.error(jsonFormatter(keysErr));
+      }
+    }
+  };
+
+  CreateApiKey = async (name: string, description?: string) => {
+    const { currentEnv, log, messages } = this;
+    if (!this.contensis) await this.ConnectContensis();
+
+    if (this.contensis) {
+      const [err, key] = await this.contensis.apiKeys.CreateKey(
+        name,
+        description
+      );
+
+      if (key) {
+        log.success(messages.keys.created(currentEnv, name));
+
+        // print the key details to console
+        console.log(
+          `  - ${key.name}${
+            key.description ? ` (${key.description})` : ''
+          } [${key.dateModified.toString().substring(0, 10)} ${key.modifiedBy}]`
+        );
+        console.log(`  - id: ${key.id}`);
+        console.log(`  - sharedSecret: ${key.sharedSecret}`);
+      }
+      console.log('');
+
+      if (err) {
+        log.error(messages.keys.failedCreate(currentEnv, name), err);
+      }
+    }
+  };
+
+  RemoveApiKey = async (id: string) => {
+    const { currentEnv, log, messages } = this;
+    if (!this.contensis) await this.ConnectContensis({ commit: true });
+
+    if (this.contensis) {
+      const [err, key] = await this.contensis.apiKeys.RemoveKey(id);
+
+      if (!err) {
+        log.success(messages.keys.removed(currentEnv, id));
+        console.log('');
+      } else {
+        log.error(messages.keys.failedRemove(currentEnv, id), err);
+      }
+    }
+  };
+
+  GetContentTypes = async () => {
+    const { currentProject, log, messages } = this;
+    let err;
+    if (!this.contensis) err = await this.HydrateContensis();
+
+    if (err) log.error(messages.contenttypes.noList(currentProject));
+    if (this.contensis) {
+      this.contentTypes = this.contensis.models.contentTypes();
+      this.components = this.contensis.models.components();
+    } else {
+      log.warning(messages.contenttypes.noList(currentProject));
+    }
+  };
+
+  PrintContentTypes = async () => {
+    const { currentProject, log, messages } = this;
+    await this.GetContentTypes();
+    if (this.contensis) {
+      // Retrieve content types list for env
+      const { contentTypes } = this;
+
+      if (Array.isArray(contentTypes)) {
+        log.success(messages.contenttypes.list(currentProject));
+        this.HandleFormattingAndOutput(contentTypes, () => {
+          // print the content types to console
+          for (const contentType of contentTypes) {
+            const fieldsLength = contentType.fields?.length || 0;
+            console.log(
+              `  - ${contentType.id} [${fieldsLength} field${
+                fieldsLength !== 1 ? 's' : ''
+              }]`
+            );
+          }
+        });
+      }
+    }
+  };
+
+  PrintContentType = async (contentTypeId: string) => {
+    const { currentProject, log, messages } = this;
+    await this.GetContentTypes();
+    if (this.contensis) {
+      // Retrieve content types list for env
+      const { contentTypes } = this;
+
+      if (Array.isArray(contentTypes)) {
+        const contentType = contentTypes.find(
+          c => c.id.toLowerCase() === contentTypeId.toLowerCase()
+        );
+        if (contentType) {
+          log.success(
+            messages.contenttypes.get(currentProject, contentType.id)
+          );
+          // print the content type to console
+          this.HandleFormattingAndOutput(contentType, log.object);
+        } else {
+          log.error(
+            messages.contenttypes.failedGet(currentProject, contentTypeId)
+          );
+        }
+      }
+    }
+  };
+
+  RemoveContentTypes = async (contentTypeIds: string[], commit = false) => {
+    const { currentProject, log, messages } = this;
+    if (!this.contensis)
+      await this.ConnectContensisImport({
+        source: 'input',
+        commit,
+      });
+    if (this.contensis) {
+      const [err, result] = await this.contensis.DeleteContentTypes(
+        contentTypeIds
+      );
+
+      if (err) {
+        log.error(
+          messages.contenttypes.failedRemove(
+            currentProject,
+            contentTypeIds.join('", "')
+          ),
+          err
+        );
+      } else {
+        log.success(
+          messages.contenttypes.removed(
+            currentProject,
+            contentTypeIds.join('", "'),
+            !this.contensis.isPreview
+          )
+        );
+        // print the results to console
+        this.HandleFormattingAndOutput(result, () =>
+          log.object(jsonFormatter(result))
+        );
+      }
+    }
+  };
+
+  ImportContentTypes = async (
+    {
+      commit,
+      fromFile,
+    }: {
+      commit: boolean;
+      fromFile: string;
+    },
+    contentTypeIds: string[] = []
+  ) => {
+    const { currentProject, log, messages } = this;
+
+    let fileData = fromFile ? readJsonFile<ContentType[]>(fromFile) || [] : [];
+    if (typeof fileData === 'string')
+      throw new Error(`Import file format must be of type JSON`);
+
+    if (!Array.isArray(fileData)) fileData = [fileData];
+
+    await this.ConnectContensisImport({
+      commit,
+      source: fromFile ? 'file' : 'contensis',
+    });
+
+    if (this.contensis) {
+      // Pass each content type to the target repo
+      for (const contentType of fileData) {
+        // Fix invalid data
+        contentType.projectId = currentProject;
+        delete contentType.uuid;
+
+        const [err, created, createStatus] =
+          await this.contensis.models.targetRepos[
+            currentProject
+          ].repo.UpsertContentType(false, contentType);
+
+        if (err) log.error(err.message, err);
+        if (createStatus) {
+          log.success(
+            messages.contenttypes.created(
+              currentProject,
+              contentType.id,
+              createStatus
+            )
+          );
+          // print the content type to console
+          this.HandleFormattingAndOutput(contentType, () => {});
+        }
+      }
+    }
+  };
+
+  PrintComponents = async () => {
+    const { currentProject, log, messages } = this;
+    await this.GetContentTypes();
+    if (this.contensis) {
+      // Retrieve components list for env
+      const { components } = this;
+
+      if (Array.isArray(components)) {
+        log.success(messages.components.list(currentProject));
+
+        this.HandleFormattingAndOutput(components, () => {
+          // print the components to console
+          for (const component of components) {
+            const fieldsLength = component.fields?.length || 0;
+            console.log(
+              `  - ${component.id} [${fieldsLength} field${
+                fieldsLength !== 1 ? 's' : ''
+              }]`
+            );
+          }
+        });
+      }
+    }
+  };
+
+  PrintComponent = async (componentId: string) => {
+    const { currentProject, log, messages } = this;
+    await this.GetContentTypes();
+    if (this.contensis) {
+      // Retrieve content types list for env
+      const { components } = this;
+
+      if (Array.isArray(components)) {
+        const component = components.find(
+          c => c.id.toLowerCase() === componentId.toLowerCase()
+        );
+        if (component) {
+          log.success(messages.components.get(currentProject, component.id));
+          // print the component to console
+          this.HandleFormattingAndOutput(component, log.object);
+        } else {
+          log.error(messages.components.failedGet(currentProject, componentId));
+        }
+      }
+    }
+  };
+
+  RemoveComponents = async (componentIds: string[], commit = false) => {
+    const { currentProject, log, messages } = this;
+    if (!this.contensis)
+      await this.ConnectContensisImport({
+        source: 'input',
+        commit,
+      });
+    if (this.contensis) {
+      const [err, result] = await this.contensis.DeleteContentTypes(
+        undefined,
+        componentIds
+      );
+
+      if (err) {
+        log.error(
+          messages.components.failedRemove(
+            currentProject,
+            componentIds.join('", "')
+          ),
+          err
+        );
+      } else {
+        log.success(
+          messages.components.removed(
+            currentProject,
+            componentIds.join('", "'),
+            !this.contensis.isPreview
+          )
+        );
+        // print the results to console
+        this.HandleFormattingAndOutput(result, () =>
+          log.info(jsonFormatter(result))
+        );
+      }
+    }
+  };
+
+  ImportComponents = async (
+    {
+      commit,
+      fromFile,
+    }: {
+      commit: boolean;
+      fromFile: string;
+    },
+    componentIds: string[] = []
+  ) => {
+    const { currentProject, log, messages } = this;
+
+    let fileData = fromFile ? readJsonFile<Component[]>(fromFile) || [] : [];
+    if (typeof fileData === 'string')
+      throw new Error(`Import file format must be of type JSON`);
+
+    if (!Array.isArray(fileData)) fileData = [fileData];
+
+    await this.ConnectContensisImport({
+      commit,
+      source: fromFile ? 'file' : 'contensis',
+    });
+
+    if (this.contensis) {
+      // Pass each component to the target repo
+      for (const component of fileData) {
+        // Fix invalid data
+        component.projectId = currentProject;
+        delete component.uuid;
+
+        const [err, created, createStatus] =
+          await this.contensis.models.targetRepos[
+            currentProject
+          ].repo.UpsertComponent(false, component);
+
+        if (err) log.error(err.message, err);
+        if (createStatus) {
+          log.success(
+            messages.components.created(
+              currentProject,
+              component.id,
+              createStatus
+            )
+          );
+          // print the component to console
+          this.HandleFormattingAndOutput(component, () => {});
+        }
+      }
+    }
+  };
+
+  RemoveEntry = async (id: string, commit = false) => {
+    const { currentEnv, log, messages } = this;
+    if (!this.contensis)
+      await this.ConnectContensisImport({
+        source: 'input',
+        commit,
+      });
+
+    if (this.contensis) {
+      if (this.contensis.isPreview) {
+        console.log(log.successText(` -- PREVIEW -- `));
+      } else {
+        console.log(log.warningText(` *** COMMITTING DELETE *** `));
+      }
+      const [err, result] = await this.contensis.DeleteEntries();
+      if (result)
+        this.HandleFormattingAndOutput(result, () => {
+          // print the migrateResult to console
+          printMigrateResult(this, result, { action: 'delete' });
+        });
+      if (
+        !err &&
+        ((!commit &&
+          Object.values(result.entriesToMigrate)?.[0].totalCount > 0) ||
+          (commit && result.migrateResult?.deleted))
+      ) {
+        log.success(messages.entries.removed(currentEnv, id, commit));
+        if (!commit) log.help(messages.entries.commitTip());
+      } else {
+        log.error(messages.entries.failedRemove(currentEnv, id), err);
+        if (!Object.values(result.entriesToMigrate)?.[0].totalCount)
+          log.help(messages.entries.notFound(id));
+      }
+    }
+  };
+
+  GetEntries = async ({
+    withDependents = false,
+  }: {
+    withDependents?: boolean;
+  }) => {
+    const { currentProject, log, messages } = this;
+    await this.ConnectContensis();
+
+    if (this.contensis) {
+      log.line();
+      const entries = await this.contensis.GetEntries({ withDependents });
+      this.HandleFormattingAndOutput(entries, () =>
+        // print the entries to console
+        logEntriesTable(
+          entries,
+          currentProject,
+          this.contensis?.payload.query?.fields
+        )
+      );
+    } else {
+      log.warning(messages.contenttypes.noList(currentProject));
+      log.help(messages.connect.tip());
+    }
+  };
+
+  ImportEntries = async ({
+    commit,
+    fromFile,
+  }: {
+    commit: boolean;
+    fromFile: string;
+  }) => {
+    const { currentProject, log, messages } = this;
+
+    const fileData = fromFile ? readJsonFile<Entry[]>(fromFile) || [] : [];
+    if (typeof fileData === 'string')
+      throw new Error(`Import file format must be of type JSON`);
+
+    await this.ConnectContensisImport({
+      commit,
+      source: fromFile ? 'file' : 'contensis',
+      fileData,
+      fileDataType: 'entries',
+    });
+
+    if (this.contensis) {
+      log.line();
+      if (this.contensis.isPreview) {
+        console.log(log.successText(` -- IMPORT PREVIEW -- `));
+      } else {
+        console.log(log.warningText(` *** COMMITTING IMPORT *** `));
+      }
+
+      const [migrateErr, migrateResult] = await this.contensis.MigrateEntries();
+
+      if (migrateErr) logError(migrateErr);
+      else
+        this.HandleFormattingAndOutput(migrateResult, () => {
+          // print the migrateResult to console
+          printMigrateResult(this, migrateResult);
+        });
+    } else {
+      log.warning(messages.contenttypes.noList(currentProject));
+      log.help(messages.connect.tip());
+    }
+  };
+
+  PrintWebhookSubscriptions = async (
+    subscriptionIds?: string[],
+    name?: string
+  ) => {
+    const { currentEnv, log, messages } = this;
+    if (!this.contensis) await this.ConnectContensis();
+    if (this.contensis) {
+      // Retrieve webhooks list for env
+      const [webhooksErr, webhooks] =
+        await this.contensis.subscriptions.webhooks.GetSubscriptions();
+
+      const filteredResults =
+        typeof name === 'string'
+          ? webhooks.filter(w =>
+              w.name?.toLowerCase().includes(name.toLowerCase())
+            )
+          : Array.isArray(subscriptionIds)
+          ? webhooks.filter(w => subscriptionIds?.some(id => id === w.id))
+          : webhooks;
+
+      if (Array.isArray(filteredResults)) {
+        this.HandleFormattingAndOutput(filteredResults, () => {
+          // print the keys to console
+          log.success(messages.webhooks.list(currentEnv));
+          for (const {
+            id,
+            description,
+            method,
+            name,
+            version,
+            url,
+          } of filteredResults) {
+            console.log(
+              `  - ${name}${
+                description ? ` (${description})` : ''
+              } [${version.modified.toString().substring(0, 10)} ${
+                version.modifiedBy
+              }]`
+            );
+            console.log(`      ${id}`);
+            console.log(`      [${method}] ${url}`);
+          }
+          console.log('');
+        });
+      }
+
+      if (webhooksErr) {
+        log.error(messages.webhooks.noList(currentEnv));
+        log.error(jsonFormatter(webhooksErr));
+      }
+    }
+  };
+
+  PrintBlocks = async () => {
+    const { currentEnv, log, messages } = this;
+    if (!this.contensis) await this.ConnectContensis();
+    if (this.contensis) {
+      // Retrieve blocks list for env
+      const [err, blocks] = await this.contensis.blocks.GetBlocks();
+
+      if (Array.isArray(blocks)) {
+        this.HandleFormattingAndOutput(blocks, () => {
+          // print the blocks to console
+          log.success(messages.blocks.list(currentEnv));
+          for (const {
+            id,
+            description,
+            branches,
+            liveVersion,
+            madeLive,
+            versionsSinceLive,
+          } of blocks) {
+            console.log(
+              `  - ${id}${description ? ` (${description})` : ''}${
+                madeLive
+                  ? ` [${madeLive.toString().substring(0, 10)} v${liveVersion}]`
+                  : ''
+              }${
+                versionsSinceLive
+                  ? log.warningText(` +${versionsSinceLive}`)
+                  : ''
+              }`
+            );
+            for (const branch of branches)
+              console.log(
+                log.infoText(`      [${branch.id}]: ${branch.status}`)
+              );
+          }
+        });
+      }
+
+      if (err) {
+        log.error(messages.blocks.noList(currentEnv));
+        log.error(jsonFormatter(err));
+      }
+    }
+  };
+
+  PrintBlockVersions = async (
+    blockId: string,
+    branch: string,
+    version: string
+  ) => {
+    const { currentEnv, env, log, messages } = this;
+    if (!this.contensis) await this.ConnectContensis();
+    if (this.contensis) {
+      // Retrieve block version
+      const [err, blocks] = await this.contensis.blocks.GetBlockVersions(
+        blockId,
+        branch,
+        version
+      );
+
+      if (blocks) {
+        this.HandleFormattingAndOutput(blocks, () => {
+          // print the version detail to console
+          log.success(
+            messages.blocks.get(`${currentEnv}:${env.currentProject}`)
+          );
+          for (const block of blocks)
+            printBlockVersion(
+              this,
+              block,
+              !version
+                ? {
+                    showImage: false,
+                    showSource: true,
+                    showStaticPaths: false,
+                    showStatus: false,
+                  }
+                : undefined
+            );
+        });
+      }
+
+      if (err) {
+        log.error(messages.blocks.noList(currentEnv, env.currentProject));
+        log.error(jsonFormatter(err));
+      }
+    }
+  };
+
+  PushBlock = async (block: PushBlockParams) => {
+    const { currentEnv, env, log, messages } = this;
+
+    // Output request to console
+    messages.blocks.tryPush(
+      block.id,
+      block.source.branch,
+      currentEnv,
+      env.currentProject
+    );
+    console.log(jsonFormatter(block));
+
+    if (!this.contensis) await this.ConnectContensis();
+    if (this.contensis) {
+      // Push new block version
+      const [err, blockVersion] = await this.contensis.blocks.PushBlockVersion(
+        block
+      );
+      if (!err) {
+        log.success(
+          messages.blocks.pushed(
+            block.id,
+            block.source.branch,
+            currentEnv,
+            env.currentProject
+          )
+        );
+        console.log(jsonFormatter(blockVersion));
+      }
+      if (blockVersion) {
+        this.HandleFormattingAndOutput(blockVersion, () => {
+          // print the version detail to console
+          printBlockVersion(this, blockVersion);
+        });
+      }
+      if (err)
+        throw new Error(
+          messages.blocks.failedPush(block.id, currentEnv, env.currentProject)
+        );
+    }
+  };
+
+  PrintBlockLogs = async (
+    blockId: string,
+    branch: string,
+    version: string,
+    dataCenter: 'hq' | 'manchester' | 'london'
+  ) => {
+    const { currentEnv, log, messages } = this;
+    if (!this.contensis) await this.ConnectContensis();
+    if (this.contensis) {
+      // Retrieve block logs
+      const [err, blockLogs] = await this.contensis.blocks.GetBlockLogs({
+        blockId,
+        branchId: branch,
+        version,
+        dataCenter,
+      });
+
+      if (blockLogs) {
+        this.HandleFormattingAndOutput(blockLogs, () => {
+          // print the  logs to console
+          log.success(messages.blocks.list(currentEnv));
+          console.log(
+            `  - ${blockId} ${branch} ${
+              Number(version) ? `v${version}` : version
+            } [${dataCenter}]`
+          );
+          log.line();
+          console.log(log.infoText(blockLogs));
+          log.line();
+        });
+      }
+
+      if (err) {
+        log.error(messages.blocks.noList(currentEnv));
+        log.error(jsonFormatter(err));
+      }
+    }
+  };
+
+  HandleFormattingAndOutput = <T>(obj: T, logFn: (obj: T) => void) => {
+    const { format, log, messages, output } = this;
+    if (output) {
+      let writeString = '';
+      if (format === 'csv') {
+        writeString = csvFormatter(obj as any);
+      } else if (format === 'xml') {
+        writeString = xmlFormatter(obj as any);
+      } else writeString = jsonFormatter(obj);
+      // write output to file
+      if (writeString) {
+        fs.writeFileSync(output, writeString);
+        log.success(messages.app.fileOutput(format, output));
+      } else {
+        log.info(messages.app.noFileOutput());
+      }
+    } else {
+      if (!format) {
+        // print the object to console
+        logFn(obj);
+      } else if (format === 'csv') {
+        log.raw('');
+        log.raw(log.infoText(csvFormatter(obj)));
+      } else if (format === 'xml') {
+        log.raw('');
+        log.raw(log.infoText(xmlFormatter(obj)));
+      } else if (format === 'json') {
+        log.raw('');
+        log.raw(log.infoText(jsonFormatter(obj)));
+      }
+      log.raw('');
+    }
+  };
+}
+
+export const cliCommand = (
+  commandArgs: string[],
+  outputOpts: OutputOptions & IConnectOptions = {},
+  contensisOpts: Partial<MigrateRequest> = {}
+) => {
+  return new ContensisCli(['', '', ...commandArgs], outputOpts, contensisOpts);
+};
+export default ContensisCli;