clever-tools 3.11.0 → 3.13.0

package/src/commands/deploy.js

@@ -1,4 +1,5 @@
 import colors from 'colors/safe.js';
+import dedent from 'dedent';
 
 import * as AppConfig from '../models/app_configuration.js';
 import * as Application from '../models/application.js';
@@ -27,14 +28,10 @@ export async function deploy (params) {
 
   await git.addRemote(appData.alias, appData.deployUrl);
 
-  Logger.println(colors.bold.blue(`Remote application is app_id=${appId}, alias=${appData.alias}, name=${appData.name}`));
-
-  Logger.println(colors.bold.blue(`Remote application belongs to ${ownerId}`));
-
   if (commitIdToPush === remoteHeadCommitId) {
     switch (sameCommitPolicy) {
       case 'ignore':
-        Logger.println(`The clever-cloud application is up-to-date (${colors.green(remoteHeadCommitId)})`);
+        Logger.printSuccess(`The application is up-to-date (${colors.grey(remoteHeadCommitId)})`);
         return;
       case 'restart':
         return restartOnSameCommit(ownerId, appId, commitIdToPush, quiet, false, exitStrategy);
@@ -42,31 +39,44 @@ export async function deploy (params) {
         return restartOnSameCommit(ownerId, appId, commitIdToPush, quiet, true, exitStrategy);
       case 'error':
       default: {
-        const upToDateMessage = `The clever-cloud application is up-to-date (${colors.green(remoteHeadCommitId)}).\nYou can set a policy with 'same-commit-policy' to handle differently when remote HEAD has the same commit as the one to push.\nOr try this command to restart the application:`;
-        if (commitIdToPush !== deployedCommitId) {
-          const restartWithId = `clever restart --commit ${commitIdToPush}`;
-          throw new Error(`${upToDateMessage}\n${colors.yellow(restartWithId)}`);
-        }
-        throw new Error(`${upToDateMessage}\n${colors.yellow('clever restart')}`);
+        const restartCommand = commitIdToPush !== deployedCommitId ? `clever restart --commit ${commitIdToPush}` : 'clever restart';
+        throw new Error(dedent`
+          Remote HEAD has the same commit as the one to push ${colors.grey(`(${remoteHeadCommitId})`)}, your application is up-to-date.
+          Create a new commit, use ${colors.blue(restartCommand)} or the ${colors.blue('--same-commit-policy')} option.
+        `);
       }
     }
   }
 
+  // It's sometimes tricky to figure out the deployment ID for the current git push.
+  // We on have the commit ID but there in a situation where the last deployment was cancelled, it may have the same commit ID.
+  // So before pushing, we get the last deployments so we can after the push figure out which deployment is new…
+  const knownDeployments = await getAllDeployments({ id: ownerId, appId, limit: 5 }).then(sendToApi);
+
+  Logger.println(dedent`
+    ${colors.bold(`🚀 Deploying ${colors.green(appData.name)}`)}
+       Application ID  ${colors.grey(`${appId}`)}
+       Org ID          ${colors.grey(`${ownerId}`)}
+  `);
+
+  Logger.println();
+
+  Logger.println(colors.bold('🔀 Git information'));
   if (remoteHeadCommitId == null || deployedCommitId == null) {
-    Logger.println('App is brand new, no commits on remote yet');
+    Logger.println(`   ${colors.yellow('!')} App is brand new, no commits on remote yet`);
   }
   else {
-    Logger.println(`Remote git head commit   is ${colors.green(remoteHeadCommitId)}`);
-    Logger.println(`Current deployed commit  is ${colors.green(deployedCommitId)}`);
+    Logger.println(`   Remote head     ${colors.yellow(remoteHeadCommitId)} (${branchRefspec})`);
+    Logger.println(`   Deployed commit ${colors.yellow(deployedCommitId)}`);
   }
-  Logger.println(`New local commit to push is ${colors.green(commitIdToPush)} (from ${colors.green(branchRefspec)})`);
+  Logger.println(`   Local commit    ${colors.yellow(commitIdToPush)} ${colors.blue('[will be deployed]')}`);
 
-  // It's sometimes tricky to figure out the deployment ID for the current git push.
-  // We on have the commit ID but there in a situation where the last deployment was cancelled, it may have the same commit ID.
-  // So before pushing, we get the last deployments so we can after the push figure out which deployment is new…
-  const knownDeployments = await getAllDeployments({ id: ownerId, appId, limit: 5 }).then(sendToApi);
+  Logger.println();
 
-  Logger.println('Pushing source code to Clever Cloud…');
+  Logger.println(dedent`
+    ${colors.bold('🔄 Deployment progress')}
+       ${colors.blue('→ Pushing source code to Clever Cloud…')}
+  `);
 
   await git.push(appData.deployUrl, commitIdToPush, force)
     .catch(async (e) => {
@@ -78,12 +88,16 @@ export async function deploy (params) {
         throw e;
       }
     });
-  Logger.println(colors.bold.green('Your source code has been pushed to Clever Cloud.'));
+
+  await Logger.println(`   ${colors.green('✓ Code pushed to Clever Cloud')}`);
 
   return Log.watchDeploymentAndDisplayLogs({ ownerId, appId, commitId: commitIdToPush, knownDeployments, quiet, exitStrategy });
 }
 
 async function restartOnSameCommit (ownerId, appId, commitIdToPush, quiet, withoutCache, exitStrategy) {
+  const cacheSuffix = withoutCache ? ' without using cache' : '';
+  Logger.println(`🔄 Restarting ${colors.bold(appId)}${cacheSuffix} ${colors.grey(`(${commitIdToPush})`)}`);
+
   const restart = await Application.redeploy(ownerId, appId, commitIdToPush, withoutCache);
   return Log.watchDeploymentAndDisplayLogs({ ownerId, appId, deploymentId: restart.deploymentId, quiet, exitStrategy });
 }

package/src/commands/domain.js

@@ -9,7 +9,7 @@ import {
   removeDomain,
   unmarkFavouriteDomain,
 } from '@clevercloud/client/esm/api/v2/application.js';
-import { getSummary } from '@clevercloud/client/cjs/api/v2/user.js';
+import { getSummary } from '@clevercloud/client/esm/api/v2/user.js';
 import { sendToApi } from '../models/send-to-api.js';
 import colors from 'colors/safe.js';
 import { parse as parseDomain } from 'tldts';
@@ -17,6 +17,7 @@ import { diagDomainConfig } from '@clevercloud/client/esm/utils/diag-domain-conf
 import { sortDomains } from '@clevercloud/client/esm/utils/domains.js';
 import { DnsResolver } from '../models/node-dns-resolver.js';
 import _ from 'lodash';
+import { getDefaultLoadBalancersDnsInfo } from '@clevercloud/client/esm/api/v4/load-balancers.js';
 
 /**
  * @typedef {import('@clevercloud/client/esm/utils/diag-domain-config.types.js').DomainInfo} DomainInfo
@@ -110,7 +111,7 @@ export async function diagApplication (params) {
   let hasError = false;
 
   const app = await getApp({ id: ownerId, appId }).then(sendToApi);
-  const expectedDnsForPublicLoadBalancer = await getDefaultLoadBalancersDnsInfo({ id: ownerId, appId }).then(sendToApi);
+  const expectedDnsForPublicLoadBalancer = await getDefaultLoadBalancersDnsInfo({ ownerId, appId }).then(sendToApi);
 
   const loadBalancerDnsConfig = {
     aRecords: expectedDnsForPublicLoadBalancer[0].dns.a,
@@ -181,7 +182,16 @@ export async function overview (params) {
 
   const applicationsWithDomains = await Promise.all(
     applications.map(async (app) => {
-      const domains = await getAllDomains({ id: app.ownerId, appId: app.id }).then(sendToApi);
+      const domains = await getAllDomains({ id: app.ownerId, appId: app.id })
+        .then(sendToApi)
+        .catch((error) => {
+          // if the user cannot access application domains, we simply act as if there were no domains
+          if (error?.response?.status === 403) {
+            Logger.printErrorLine(`You cannot list domains for application ${app.name} (${app.id})`);
+            return [];
+          }
+          throw error;
+        });
       return { app, domains };
     }),
   );
@@ -351,19 +361,6 @@ function reportDomainDiagnostics ({ hostname, pathPrefix, resolvedDnsConfig, dia
   }
 }
 
-// TODO: put in clever client
-function getDefaultLoadBalancersDnsInfo (params) {
-  return Promise.resolve({
-    method: 'get',
-    url: `/v4/load-balancers/organisations/${params.id}/applications/${params.appId}/load-balancers/default`,
-    headers: {
-      Accept: 'application/json',
-    },
-    // no query params
-    // no body
-  });
-}
-
 /**
  * Parses domain information from vhosts array
  *

package/src/commands/emails.js

@@ -0,0 +1,174 @@
+import colors from 'colors/safe.js';
+import * as User from '../models/user.js';
+import { Logger } from '../logger.js';
+import { openBrowser } from '../models/utils.js';
+import { sendToApi } from '../models/send-to-api.js';
+import { confirm } from '../lib/prompts.js';
+import {
+  todo_addEmailAddress as addEmailAddress,
+  todo_getEmailAddresses as getEmailAddresses,
+  todo_removeEmailAddress as removeEmailAddress,
+} from '@clevercloud/client/esm/api/v2/user.js';
+
+/**
+ * Show primary and secondary email addresses of the current user
+ * @param {object} params The command parameters
+ * @param {string} params.options.format The output format
+ */
+export async function list (params) {
+  const { format } = params.options;
+  const addresses = await getUserEmailAddresses();
+
+  switch (format) {
+    case 'json': {
+      Logger.printJson(addresses);
+      break;
+    }
+    case 'human':
+    default: {
+      Logger.println('✉️  Primary email address:');
+      Logger.println(` • ${colors.green(addresses.primary)}`);
+      if (addresses.secondary.length > 0) {
+        Logger.println();
+        Logger.println(`✉️  ${addresses.secondary.length} secondary email address(es):`);
+        addresses.secondary.forEach((address) =>
+          Logger.println(` • ${colors.blue(address)}`),
+        );
+      }
+    }
+  }
+}
+
+/**
+ * Add a secondary email address to the current user
+ * @param {object} params The command parameters
+ * @param {Array<string>} params.args
+ */
+export async function addSecondary (params) {
+  const [secondaryAddress] = params.args;
+
+  const secondaryAddressEncoded = encodeURIComponent(secondaryAddress);
+  try {
+    await addEmailAddress({ email: secondaryAddressEncoded }).then(sendToApi);
+    Logger.printSuccess(`The server sent a confirmation email to ${secondaryAddress} to validate your secondary address`);
+  }
+  catch (e) {
+    switch (e?.responseBody?.id) {
+      case 101:
+        throw new Error('This address already belongs to your account');
+      case 550:
+        throw new Error('The format of this address is invalid');
+      case 1004:
+        throw new Error('This address belongs to another account');
+      default:
+        throw e;
+    }
+  }
+}
+
+/**
+ * Set the primary email address of the current user
+ * @param {object} params The command parameters
+ * @param {Array<string>} params.args
+ */
+export async function setPrimary (params) {
+  const [newPrimaryAddress] = params.args;
+
+  const addresses = await getUserEmailAddresses();
+
+  if (addresses.primary === newPrimaryAddress) {
+    throw new Error('This address is already the primary one');
+  }
+
+  if (!addresses.secondary.includes(newPrimaryAddress)) {
+    throw new Error('This address must be added as a secondary address before marking it as primary');
+  }
+
+  const newPrimaryEmailEncoded = encodeURIComponent(newPrimaryAddress);
+  await addEmailAddress({ email: newPrimaryEmailEncoded }, { make_primary: true }).then(sendToApi);
+
+  Logger.printSuccess(`Primary address updated to ${newPrimaryAddress} successfully`);
+}
+
+/**
+ * Remove a secondary email address from the current user
+ * @param {object} params The command parameters
+ * @param {Array<string>} params.args
+ */
+export async function removeSecondary (params) {
+  const [addressToRemove] = params.args;
+
+  const addresses = await getUserEmailAddresses();
+
+  if (!addresses.secondary.includes(addressToRemove)) {
+    throw new Error('This address is not part of the secondary addresses of the current user, it can\'t be removed');
+  }
+
+  const addressToRemoveEncoded = encodeURIComponent(addressToRemove);
+  await removeEmailAddress({ email: addressToRemoveEncoded }).then(sendToApi);
+
+  Logger.printSuccess(`Secondary address ${addressToRemove} removed successfully`);
+}
+
+/**
+ * Remove all secondary email addresses from the current user
+ * @param {object} params The command parameters
+ * @param {object} params.options The command options
+ * @param {boolean} params.options.yes The user confirmation
+ */
+export async function removeAllSecondary (params) {
+  if (!params.options.yes) {
+    await confirm(
+      'Are you sure you want to remove all your secondary addresses?',
+      'No secondary addresses removed',
+    );
+  }
+
+  const addresses = await getUserEmailAddresses();
+
+  if (addresses.secondary.length === 0) {
+    Logger.println('No secondary address to remove');
+    return;
+  }
+
+  const results = await Promise.all(
+    addresses.secondary.map((addressToRemove) => {
+      const addressToRemoveEncoded = encodeURIComponent(addressToRemove);
+      return removeEmailAddress({ email: addressToRemoveEncoded }).then(sendToApi)
+        .then(() => [true, addressToRemove])
+        .catch(() => [false, addressToRemove]);
+    }),
+  );
+
+  if (results.every(([isRemoved]) => isRemoved)) {
+    Logger.printSuccess('All secondary addresses were removed successfully');
+  }
+  else {
+    const addressesWithErrors = results
+      .filter(([isRemoved]) => !isRemoved)
+      .map(([_, address]) => address)
+      .join(', ');
+    throw new Error(`Some errors occured while removing these addresses: ${addressesWithErrors}`);
+  }
+}
+
+/**
+ * Open the email addresses management page of the Console in your browser
+ * @returns {Promise<void>} A promise that resolves when the page is opened
+ */
+export function openConsole () {
+  return openBrowser('/users/me/emails', 'Opening the email addresses management page of the Console in your browser');
+}
+
+/**
+ * Get the primary and secondary email addresses of the current user
+ * @returns {Promise<{ primary: string, secondary: string[] }>} The primary and secondary email addresses of the current user
+ */
+async function getUserEmailAddresses () {
+  const currentUser = await User.getCurrent();
+  const secondaryAddresses = await getEmailAddresses().then(sendToApi);
+  return {
+    primary: currentUser.email,
+    secondary: secondaryAddresses.sort(),
+  };
+}

package/src/commands/env.js

@@ -4,16 +4,23 @@ import colors from 'colors/safe.js';
 import * as variables from '../models/variables.js';
 import { sendToApi } from '../models/send-to-api.js';
 import { toNameEqualsValueString, validateName } from '@clevercloud/client/esm/utils/env-vars.js';
-import * as application from '@clevercloud/client/esm/api/v2/application.js';
+import {
+  getAllEnvVars,
+  getAllEnvVarsForAddons,
+  getAllEnvVarsForDependencies,
+  updateEnvVar,
+  updateAllEnvVars,
+  removeEnvVar,
+} from '@clevercloud/client/esm/api/v2/application.js';
 
 export async function list (params) {
   const { alias, app: appIdOrName, 'add-export': addExportsOption, format } = params.options;
   const { ownerId, appId } = await Application.resolveId(appIdOrName, alias);
 
   const [envFromApp, envFromAddons, envFromDeps] = await Promise.all([
-    application.getAllEnvVars({ id: ownerId, appId }).then(sendToApi),
-    application.getAllEnvVarsForAddons({ id: ownerId, appId }).then(sendToApi),
-    application.getAllEnvVarsForDependencies({ id: ownerId, appId }).then(sendToApi),
+    getAllEnvVars({ id: ownerId, appId }).then(sendToApi),
+    getAllEnvVarsForAddons({ id: ownerId, appId }).then(sendToApi),
+    getAllEnvVarsForDependencies({ id: ownerId, appId }).then(sendToApi),
   ]);
 
   switch (format) {
@@ -69,7 +76,7 @@ export async function set (params) {
 
   const { ownerId, appId } = await Application.resolveId(appIdOrName, alias);
 
-  await application.updateEnvVar({ id: ownerId, appId, envName }, { value }).then(sendToApi);
+  await updateEnvVar({ id: ownerId, appId, envName }, { value }).then(sendToApi);
 
   Logger.println('Your environment variable has been successfully saved');
 };
@@ -79,7 +86,7 @@ export async function rm (params) {
   const { alias, app: appIdOrName } = params.options;
   const { ownerId, appId } = await Application.resolveId(appIdOrName, alias);
 
-  await application.removeEnvVar({ id: ownerId, appId, envName }).then(sendToApi);
+  await removeEnvVar({ id: ownerId, appId, envName }).then(sendToApi);
 
   Logger.println('Your environment variable has been successfully removed');
 };
@@ -90,7 +97,7 @@ export async function importEnv (params) {
   const { ownerId, appId } = await Application.resolveId(appIdOrName, alias);
 
   const envVars = await variables.readVariablesFromStdin(format);
-  await application.updateAllEnvVars({ id: ownerId, appId }, envVars).then(sendToApi);
+  await updateAllEnvVars({ id: ownerId, appId }, envVars).then(sendToApi);
 
   Logger.println('Environment variables have been set');
 };
@@ -110,7 +117,7 @@ export async function importVarsFromLocalEnv (params) {
 
   for (const envName of envNames) {
     const value = process.env[envName] || '';
-    await application.updateEnvVar({ id: ownerId, appId, envName }, { value }).then(sendToApi);
+    await updateEnvVar({ id: ownerId, appId, envName }, { value }).then(sendToApi);
   }
 
   Logger.println('Your environment variables have been successfully saved');

package/src/commands/keycloak.js

@@ -0,0 +1,138 @@
+import {
+  operatorCheckVersion,
+  operatorList,
+  operatorNgDisable,
+  operatorNgEnable,
+  operatorOpen,
+  operatorOpenLogs,
+  operatorOpenWebUi,
+  operatorPrint,
+  operatorReboot,
+  operatorRebuild,
+  operatorUpdateVersion,
+} from '../lib/operator-commands.js';
+
+/**
+ * Check the version of a Keycloak operator
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @param {string} params.options.format The output format
+ * @returns {Promise<void>}
+ */
+export async function checkVersion (params) {
+  const [addonIdOrName] = params.args;
+  const { format } = params.options;
+  await operatorCheckVersion('keycloak', addonIdOrName, format);
+}
+
+/**
+ * Update the version of a Keycloak operator
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ */
+export async function updateVersion (params) {
+  const [addonIdOrName] = params.args;
+  const { target } = params.options;
+  await operatorUpdateVersion('keycloak', target, addonIdOrName);
+}
+
+/**
+ * Get the details of a Keycloak operator
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @param {string} params.options.format The output format
+ * @returns {Promise<void>}
+ */
+export async function get (params) {
+  const [addonIdOrName] = params.args;
+  const { format } = params.options;
+  await operatorPrint('keycloak', addonIdOrName, format);
+}
+
+/**
+ * List all Keycloak operators
+ * @returns {Promise<void>}
+ */
+export async function list (params) {
+  await operatorList('keycloak', params.options.format);
+}
+
+/**
+ * Unlink a Keycloak operator from a Network Group
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ * @throws {Error} If the Network Group feature is already disabled
+ */
+export async function ngDisable (params) {
+  const [addonIdOrName] = params.args;
+  await operatorNgDisable('keycloak', addonIdOrName);
+}
+
+/**
+ * Link a Keycloak operator to a Network Group
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ * @throws {Error} If the Network Group feature is already enabled
+ */
+export async function ngEnable (params) {
+  const [addonIdOrName] = params.args;
+  await operatorNgEnable('keycloak', addonIdOrName);
+}
+
+/**
+ * Open a Keycloak operator dashboard in the Clever Cloud Console
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ */
+export async function open (params) {
+  const [addonIdOrName] = params.args;
+  await operatorOpen('keycloak', addonIdOrName);
+}
+
+/**
+ * Open the Logs section of a Keycloak Operator application in the Clever Cloud Console
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ */
+export async function openLogs (params) {
+  const [addonIdOrName] = params.args;
+  await operatorOpenLogs('keycloak', addonIdOrName);
+}
+
+/**
+ * Open the Web UI of a Keycloak Operator application in the Clever Cloud Console
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ */
+export async function openWebUi (params) {
+  const [addonIdOrName] = params.args;
+  await operatorOpenWebUi('keycloak', addonIdOrName);
+}
+
+/**
+ * Restart a Keycloak operator
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ */
+export async function reboot (params) {
+  const [addonIdOrName] = params.args;
+  await operatorReboot('keycloak', addonIdOrName);
+}
+
+/**
+ * Rebuild a Keycloak operator
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ */
+export async function rebuild (params) {
+  const [addonIdOrName] = params.args;
+  await operatorRebuild('keycloak', addonIdOrName);
+}

package/src/commands/kv.js

@@ -2,7 +2,7 @@ import Redis from 'ioredis';
 import colors from 'colors/safe.js';
 import { Logger } from '../logger.js';
 import { sendToApi } from '../models/send-to-api.js';
-import { getAllEnvVars } from '@clevercloud/client/cjs/api/v2/addon.js';
+import { getAllEnvVars } from '@clevercloud/client/esm/api/v2/addon.js';
 import { findAddonsByNameOrId } from '../models/ids-resolver.js';
 
 const URL_ENV_KEY = 'REDIS_URL';

package/src/commands/link.js

@@ -1,5 +1,6 @@
 import * as Application from '../models/application.js';
 import { Logger } from '../logger.js';
+import colors from 'colors/safe.js';
 
 export async function link (params) {
   const [app] = params.args;
@@ -7,9 +8,12 @@ export async function link (params) {
 
   if (app.app_id != null && orgaIdOrName != null) {
     Logger.warn('You\'ve specified a unique application ID, organisation option will be ignored');
+    await Application.linkRepo(app, null, alias);
+  }
+  else {
+    await Application.linkRepo(app, orgaIdOrName, alias);
   }
 
-  await Application.linkRepo(app, orgaIdOrName, alias);
-
-  Logger.println('Your application has been successfully linked!');
+  const linkedMessage = alias ? ` to local alias ${colors.green(alias)}` : '';
+  Logger.printSuccess(`Application ${colors.green(app.app_name || app.app_id)} has been successfully linked${linkedMessage}!`);
 }

package/src/commands/makeDefault.js

@@ -1,10 +1,11 @@
 import * as AppConfig from '../models/app_configuration.js';
 import { Logger } from '../logger.js';
+import colors from 'colors/safe.js';
 
 export async function makeDefault (params) {
   const [alias] = params.args;
 
   await AppConfig.setDefault(alias);
 
-  Logger.println(`The application ${alias} has been set as default`);
+  Logger.printSuccess(`The application ${colors.green(alias)} has been set as default`);
 };

package/src/commands/matomo.js

@@ -0,0 +1,85 @@
+import {
+  operatorList,
+  operatorOpen,
+  operatorOpenLogs,
+  operatorOpenWebUi,
+  operatorPrint,
+  operatorReboot,
+  operatorRebuild,
+} from '../lib/operator-commands.js';
+
+/**
+ * Get the details of a Matomo operator
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @param {string} params.options.format The output format
+ * @returns {Promise<void>}
+ */
+export async function get (params) {
+  const [addonIdOrName] = params.args;
+  const { format } = params.options;
+  await operatorPrint('matomo', addonIdOrName, format);
+}
+
+/**
+ * List all Matomo operators
+ * @returns {Promise<void>}
+ */
+export async function list (params) {
+  await operatorList('addon-matomo', params.options.format);
+}
+
+/**
+ * Open a Matomo operator dashboard in the Clever Cloud Console
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ */
+export async function open (params) {
+  const [addonIdOrName] = params.args;
+  await operatorOpen('matomo', addonIdOrName);
+}
+
+/**
+ * Open the Logs section of a Matomo Operator application in the Clever Cloud Console
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ */
+export async function openLogs (params) {
+  const [addonIdOrName] = params.args;
+  await operatorOpenLogs('matomo', addonIdOrName);
+}
+
+/**
+ * Open the Web UI of a Matomo Operator application in the Clever Cloud Console
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ */
+export async function openWebUi (params) {
+  const [addonIdOrName] = params.args;
+  await operatorOpenWebUi('matomo', addonIdOrName);
+}
+
+/**
+ * Reboot a Matomo operator
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ */
+export async function reboot (params) {
+  const [addonIdOrName] = params.args;
+  await operatorReboot('matomo', addonIdOrName);
+}
+
+/**
+ * Rebuild a Matomo operator
+ * @param {object} params The command's parameters
+ * @param {string} params.args[0] The operator's name or ID
+ * @returns {Promise<void>}
+ */
+export async function rebuild (params) {
+  const [addonIdOrName] = params.args;
+  await operatorRebuild('matomo', addonIdOrName);
+}