@unito/integration-cli 0.57.1 → 0.58.0

package/dist/.eslintrc.d.ts

@@ -8,3 +8,9 @@ export declare let rules: {
     'no-console': string;
 };
 export declare let ignorePatterns: string[];
+export declare let overrides: {
+    files: string[];
+    rules: {
+        '@typescript-eslint/no-floating-promises': string;
+    };
+}[];

package/dist/.eslintrc.js

@@ -14,7 +14,14 @@ module.exports = {
         'no-console': 'off',
     },
     ignorePatterns: [
-        'integrationGenerator/integrationBoilerplate',
-        'integrationGenerator/templates',
+        'boilerplate',
+    ],
+    overrides: [
+        {
+            'files': ['test/**/*.test.ts'],
+            'rules': {
+                '@typescript-eslint/no-floating-promises': 'off'
+            }
+        }
     ],
 };

package/dist/{integrationGenerator/integrationBoilerplate → boilerplate}/src/index.ts

@@ -70,9 +70,7 @@ app.use((req: express.Request, res: express.Response, _next: express.NextFunctio
 });
 
 // eslint-disable-next-line
-const instance = app.listen(process.env.PORT || 9200, () =>
-  console.log(`Server started on port ${process.env.PORT || 9200}.`),
-);
+const instance = app.listen(process.env.PORT || 9200, () => console.log(`Server started on port ${process.env.PORT || 9200}.`));
 
 // Trap exit signals.
 ['SIGTERM', 'SIGINT', 'SIGUSR2'].forEach(signalType => {

package/dist/src/commands/activity.d.ts

@@ -4,8 +4,8 @@ export default class Activity extends BaseCommand<typeof Activity> {
     static description: string;
     static examples: string[];
     static flags: {
-        number: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        number: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment, import("@oclif/core/lib/interfaces").CustomOptions>;
         follow: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     catch(error: Error): Promise<void>;

package/dist/src/commands/activity.js

@@ -61,7 +61,7 @@ class Activity extends baseCommand_1.BaseCommand {
         // Setup the platform client.
         IntegrationsPlatform.setApiKey(apiKey);
         IntegrationsPlatform.setEnvironment(environment);
-        core_1.ux.action.start('Finding the integration');
+        core_1.ux.action.start('Finding the integration', undefined, { stdout: true });
         let integration;
         try {
             integration = await IntegrationsPlatform.getIntegrationByName(integrationConfiguration.name);
@@ -77,7 +77,7 @@ class Activity extends baseCommand_1.BaseCommand {
             }
         }
         core_1.ux.action.stop();
-        core_1.ux.action.start('Retrieving activity');
+        core_1.ux.action.start('Retrieving activity', undefined, { stdout: true });
         let lastEventDate;
         // eslint-disable-next-line no-constant-condition
         while (true) {

package/dist/src/commands/dev.d.ts

@@ -5,11 +5,15 @@ export default class Dev extends BaseCommand<typeof Dev> {
     static examples: string[];
     catch(error: Error): Promise<void>;
     static flags: {
-        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment, import("@oclif/core/lib/interfaces").CustomOptions>;
         verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        crawlMode: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        checks: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        'config-path': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'credential-payload': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'credential-id': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'test-account': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'read-only': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        crawlMode: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        checks: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
+        'config-path': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/src/commands/dev.js

@@ -9,6 +9,7 @@ const GlobalConfiguration = tslib_1.__importStar(require("../resources/globalCon
 const integrations_1 = require("../resources/integrations");
 const configuration_1 = require("../resources/configuration");
 const decryption_1 = require("../resources/decryption");
+const credentials_1 = require("../resources/credentials");
 class Dev extends baseCommand_1.BaseCommand {
     static description = 'Develop your integration';
     static examples = ['<%= config.bin %> <%= command.id %>'];
@@ -29,6 +30,23 @@ class Dev extends baseCommand_1.BaseCommand {
             description: 'output more (debug) information',
             default: false,
         }),
+        'credential-payload': core_1.Flags.string({
+            description: '(advanced) credential payload to use.',
+            exclusive: ['credential-id'],
+        }),
+        'credential-id': core_1.Flags.integer({
+            description: '(advanced) credential to use.',
+            exclusive: ['credential-payload'],
+        }),
+        'test-account': core_1.Flags.string({
+            description: 'test account to use.',
+            options: Object.values(configuration_1.CredentialScope),
+            default: configuration_1.CredentialScope.DEVELOPMENT,
+        }),
+        'read-only': core_1.Flags.boolean({
+            description: 'whether or not to only perform read operations',
+            allowNo: true,
+        }),
         crawlMode: core_1.Flags.string({
             description: 'mode to use while crawling the integration graph',
             options: Object.values(configuration_1.CrawlMode),
@@ -63,23 +81,42 @@ class Dev extends baseCommand_1.BaseCommand {
         // Resolve the configuration.
         const environment = flags.environment ?? GlobalConfiguration.Environment.Production;
         const configuration = await (0, configuration_1.getConfiguration)(environment, flags['config-path']);
-        let credentials = configuration.testAccounts?.[configuration_1.CredentialScope.DEVELOPMENT];
-        if (credentials) {
-            ({ entries: credentials } = await (0, decryption_1.decryptEntries)(configuration.name, environment, this.config.configDir, credentials));
+        let credentialPayload;
+        let readOnly = flags['read-only'] ?? false;
+        if (flags['credential-id']) {
+            const credential = await (0, credentials_1.fetchCredential)(environment, this.config.configDir, flags['credential-id']);
+            credentialPayload = JSON.stringify(credential.payload);
+            // When "credential-id" is provided, the default value of "read-only" is false.
+            readOnly = flags['read-only'] ?? true;
+        }
+        else if (flags['credential-payload']) {
+            credentialPayload = flags['credential-payload'];
+        }
+        else {
+            let credentials = configuration.testAccounts?.[flags['test-account']];
+            if (credentials) {
+                credentials = (await (0, decryption_1.decryptEntries)(configuration.name, environment, this.config.configDir, credentials))
+                    .entries;
+            }
+            credentialPayload = JSON.stringify(credentials);
         }
         let secrets = {};
         // Decrypt secrets, if necessary.
         if (configuration.secrets) {
-            secrets = await (0, decryption_1.decryptEntries)(configuration.name, environment, this.config.configDir, configuration.secrets);
+            secrets = (await (0, decryption_1.decryptEntries)(configuration.name, environment, this.config.configDir, configuration.secrets))
+                .entries;
         }
         // Launch the debugger.
         const commandArguments = [
             `${process.env.NODE_MODULES_FOLDER}/@unito/integration-debugger/dist/src/index.js`,
             '--integration-url=http://localhost:9200',
             `--spawn-process=npm run dev`,
-            `--credential-payload=${JSON.stringify(credentials)}`,
+            `--credential-payload=${credentialPayload}`,
             `--secrets-payload=${JSON.stringify(secrets)}`,
         ];
+        if (readOnly) {
+            commandArguments.push('--read-only');
+        }
         if (configuration.graphRelativeUrl) {
             commandArguments.push(`--graph-relative-url=${configuration.graphRelativeUrl}`);
         }

package/dist/src/commands/encrypt.d.ts

@@ -4,7 +4,7 @@ export default class Encrypt extends BaseCommand<typeof Encrypt> {
     static description: string;
     static examples: string[];
     static flags: {
-        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     catch(error: Error): Promise<void>;
     run(): Promise<void>;

package/dist/src/commands/encrypt.js

@@ -41,7 +41,7 @@ class Encrypt extends baseCommand_1.BaseCommand {
             message: 'Enter text to encrypt',
             type: 'input',
         });
-        core_1.ux.action.start('Encrypting data');
+        core_1.ux.action.start('Encrypting data', undefined, { stdout: true });
         const { encryptedData } = await IntegrationsPlatform.encryptData(integrationConfiguration.name, data);
         core_1.ux.action.stop();
         core_1.ux.log(`Encrypted Data: ${chalk_1.default.greenBright(encryptedData)}`);

package/dist/src/commands/init.d.ts

@@ -3,7 +3,7 @@ export default class Init extends BaseCommand<typeof Init> {
     static description: string;
     static examples: string[];
     static flags: {
-        name: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     catch(error: Error): Promise<void>;
     run(): Promise<void>;

package/dist/src/commands/init.js

@@ -5,7 +5,7 @@ const core_1 = require("@oclif/core");
 const chalk_1 = tslib_1.__importDefault(require("chalk"));
 const inquirer_1 = tslib_1.__importDefault(require("inquirer"));
 const Configuration = tslib_1.__importStar(require("../resources/configuration"));
-const integrationGenerator_1 = require("../../integrationGenerator");
+const integrations_1 = require("../resources/integrations");
 const baseCommand_1 = require("../baseCommand");
 const errors_1 = require("../errors");
 class Init extends baseCommand_1.BaseCommand {
@@ -40,8 +40,8 @@ class Init extends baseCommand_1.BaseCommand {
                         .replace(/[^a-z0-9_-]*/g, ''),
                 },
             ])).name;
-        core_1.ux.action.start('\nInitializing integration');
-        const generatedPath = await integrationGenerator_1.Resources.Integration.generateIntegrationSkeleton(name, process.cwd());
+        core_1.ux.action.start('\nInitializing integration', undefined, { stdout: true });
+        const generatedPath = await (0, integrations_1.copyBoilerplate)(name, process.cwd());
         process.chdir(generatedPath);
         await Configuration.writeConfiguration({ name });
         core_1.ux.action.stop();

package/dist/src/commands/invite.d.ts

@@ -4,7 +4,7 @@ export default class Invite extends BaseCommand<typeof Invite> {
     static description: string;
     static examples: string[];
     static flags: {
-        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     catch(error: Error): Promise<void>;
     run(): Promise<void>;

package/dist/src/commands/invite.js

@@ -55,7 +55,7 @@ class Invite extends baseCommand_1.BaseCommand {
                 type: 'input',
             },
         ]);
-        core_1.ux.action.start('Finding the integration');
+        core_1.ux.action.start('Finding the integration', undefined, { stdout: true });
         let integration;
         try {
             integration = await IntegrationsPlatform.getIntegrationByName(integrationConfiguration.name);
@@ -71,7 +71,7 @@ class Invite extends baseCommand_1.BaseCommand {
             }
         }
         core_1.ux.action.stop();
-        core_1.ux.action.start('Inviting user');
+        core_1.ux.action.start('Inviting user', undefined, { stdout: true });
         await IntegrationsPlatform.inviteUserToIntegration(integration.id, email);
         core_1.ux.action.stop();
         core_1.ux.log(`User successfully added! They should now be able to update and publish this integration.`);

package/dist/src/commands/login.d.ts

@@ -4,7 +4,7 @@ export default class Login extends BaseCommand<typeof Login> {
     static description: string;
     static examples: string[];
     static flags: {
-        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     catch(error: Error): Promise<void>;
     run(): Promise<void>;

package/dist/src/commands/login.js

@@ -46,7 +46,7 @@ class Login extends baseCommand_1.BaseCommand {
             this.exit(-1);
         }
         // Retrieve the user's profile.
-        core_1.ux.action.start('Log in...');
+        core_1.ux.action.start('Log in', undefined, { stdout: true });
         let profile = undefined;
         IntegrationsPlatform.setEnvironment(environment);
         IntegrationsPlatform.setApiKey(apiKey);

package/dist/src/commands/oauth2.d.ts

@@ -5,10 +5,10 @@ export default class Oauth2 extends Command {
     static description: string;
     static examples: string[];
     static flags: {
-        'test-account': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        environment: import("@oclif/core/lib/interfaces").OptionFlag<Environment | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'test-account': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        environment: import("@oclif/core/lib/interfaces").OptionFlag<Environment, import("@oclif/core/lib/interfaces").CustomOptions>;
         reauth: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'config-path': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'config-path': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     catch(error: Error): Promise<void>;
     run(): Promise<void>;

package/dist/src/commands/oauth2.js

@@ -4,16 +4,22 @@ const tslib_1 = require("tslib");
 const core_1 = require("@oclif/core");
 const chalk_1 = tslib_1.__importDefault(require("chalk"));
 const configuration_1 = require("../resources/configuration");
-const Oauth2Helper = tslib_1.__importStar(require("../services/oauth2Helper"));
+const Oauth2Helper = tslib_1.__importStar(require("../resources/oauth2Helper"));
 const IntegrationsPlatform = tslib_1.__importStar(require("../services/integrationsPlatform"));
 const configurationTypes_1 = require("../configurationTypes");
 const errors_1 = require("../errors");
 const globalConfiguration_1 = require("../resources/globalConfiguration");
 const decryption_1 = require("../resources/decryption");
 class Oauth2 extends core_1.Command {
-    static summary = 'Perform an OAuth2 workflow locally';
-    static description = 'The Oauth2 command allows you to perform an OAuth2 workflow locally, either to create a new test account or to refresh an existing one.';
-    static examples = ['<%= config.bin %> <%= command.id %>'];
+    static summary = `Perform an OAuth2 workflow to either populate or refresh a test account's credentials.`;
+    static description = `The Oauth2 command allows you to perform an OAuth2 workflow to populate the specified test account's accessToken and refreshToken to be used by the 'test' and 'dev' commands.
+
+    If the test-account is already populated, the command will refresh the credentials if the refresh token is available.
+    If you want to force a new OAuth2 flow to change the connected account or something else, use the --reauth flag.`;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --reauth --test-account=compliance',
+    ];
     static flags = {
         'test-account': core_1.Flags.string({
             description: 'Test account to use.',
@@ -24,9 +30,10 @@ class Oauth2 extends core_1.Command {
             description: 'the environment of the platform',
             options: Object.values(globalConfiguration_1.Environment),
             default: globalConfiguration_1.Environment.Production,
+            hidden: true,
         })(),
         reauth: core_1.Flags.boolean({
-            description: 'triggers a new oauth2 flow to collect credentials and overwrite the current one',
+            description: `triggers a new oauth2 flow to overwrite the test account's current credentials`,
             default: false,
         }),
         'config-path': core_1.Flags.string({
@@ -66,8 +73,8 @@ class Oauth2 extends core_1.Command {
         const account = testAccount === 'development' ? configuration.testAccounts?.development : configuration.testAccounts?.compliance;
         let credentials;
         if (!account || Object.entries(account).length === 0 || flags.reauth) {
-            core_1.ux.action.start(`Starting Oauth2 flow for account: ${testAccount}`);
-            credentials = await Oauth2Helper.performOAuth2Flow(oauth2);
+            core_1.ux.action.start(`Starting Oauth2 flow for account: ${testAccount}`, undefined, { stdout: true });
+            credentials = await Oauth2Helper.performOAuth2Flow(oauth2, environment);
             core_1.ux.action.stop();
         }
         else {
@@ -76,14 +83,12 @@ class Oauth2 extends core_1.Command {
                 return;
             }
             const decryptionResult = await (0, decryption_1.decryptEntries)(configuration.name, environment, this.config.configDir, account);
-            core_1.ux.action.start(`Refreshing test account ${testAccount}`);
-            credentials = await Oauth2Helper.updateToken({
-                ...oauth2,
-                refreshToken: decryptionResult.entries?.refreshToken,
-            });
+            const refreshToken = decryptionResult.entries?.refreshToken;
+            core_1.ux.action.start(`Refreshing test account ${testAccount}`, undefined, { stdout: true });
+            credentials = await Oauth2Helper.updateToken(oauth2, refreshToken);
             // If provider response doesn't contain a new refresh token, use the one we already have
             if (!credentials.refreshToken) {
-                credentials.refreshToken = account?.refreshToken;
+                credentials.refreshToken = refreshToken;
             }
             if (decryptionResult.decryptedKeys.includes('accessToken')) {
                 credentials.accessToken = (await IntegrationsPlatform.encryptData(configuration.name, credentials.accessToken)).encryptedData;
@@ -93,7 +98,7 @@ class Oauth2 extends core_1.Command {
             }
             core_1.ux.action.stop();
         }
-        core_1.ux.action.start(`Saving credentials for account: ${testAccount}`);
+        core_1.ux.action.start(`Saving credentials for account: ${testAccount}`, undefined, { stdout: true });
         await (0, configuration_1.writeTestAccount)(configuration, credentials, testAccount);
         core_1.ux.action.stop();
         return;

package/dist/src/commands/publish.d.ts

@@ -4,11 +4,11 @@ export default class Publish extends BaseCommand<typeof Publish> {
     static description: string;
     static examples: string[];
     static flags: {
-        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        environment: import("@oclif/core/lib/interfaces").OptionFlag<GlobalConfiguration.Environment, import("@oclif/core/lib/interfaces").CustomOptions>;
         'registry-only': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         preview: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'live-preview': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'config-path': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'config-path': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     catch(error: Error): Promise<void>;

package/dist/src/commands/publish.js

@@ -113,7 +113,7 @@ class Publish extends baseCommand_1.BaseCommand {
     }
     async livePreviewIntegration(integrationConfiguration) {
         // Get the profile.
-        core_1.ux.action.start('Get profile');
+        core_1.ux.action.start('Get profile', undefined, { stdout: true });
         const profile = await IntegrationsPlatform.getProfile();
         core_1.ux.action.stop();
         // Generate a new name.
@@ -131,7 +131,7 @@ class Publish extends baseCommand_1.BaseCommand {
             ].join(' - ');
         }
         // Start ngrok & update the base url.
-        core_1.ux.action.start('Starting ngrok');
+        core_1.ux.action.start('Starting ngrok', undefined, { stdout: true });
         updatedConfiguration.baseUrl = await ngrok_1.default.connect(9200);
         core_1.ux.action.stop();
         // Update the registry.
@@ -164,11 +164,11 @@ class Publish extends baseCommand_1.BaseCommand {
             authorization.instructionsMarkdown = await this.getInstructionsMarkdown(authorization.name);
         }
         if (existing) {
-            core_1.ux.action.start('Integration found. Updating');
+            core_1.ux.action.start('Integration found. Updating', undefined, { stdout: true });
             updated = await IntegrationsPlatform.updateIntegration(existing.id, integrationConfiguration);
         }
         else {
-            core_1.ux.action.start('Integration not found. Creating');
+            core_1.ux.action.start('Integration not found. Creating', undefined, { stdout: true });
             updated = await IntegrationsPlatform.createIntegration(integrationConfiguration);
         }
         core_1.ux.action.stop();
@@ -189,7 +189,7 @@ class Publish extends baseCommand_1.BaseCommand {
     }
     copyAndMoveToTmpDir() {
         // Copy integration in tmp folder.
-        core_1.ux.action.start('Packaging');
+        core_1.ux.action.start('Packaging', undefined, { stdout: true });
         const archivePath = this.archiveIntegration();
         const tmpDir = tmp_1.default.dirSync();
         child_process_1.default.execSync(`unzip ${archivePath} -d ${tmpDir.name}`);
@@ -199,14 +199,14 @@ class Publish extends baseCommand_1.BaseCommand {
     }
     async previewIntegration(integrationConfiguration) {
         // Get the profile.
-        core_1.ux.action.start('Get profile');
+        core_1.ux.action.start('Get profile', undefined, { stdout: true });
         const profile = await IntegrationsPlatform.getProfile();
         core_1.ux.action.stop();
         // Generate a new name.
         const newName = `${integrationConfiguration.name}-preview-${this.hashEmail(profile.email)}`;
         // Update the secrets.
         const updatedConfiguration = await this.generateNewSecrets(integrationConfiguration, newName);
-        core_1.ux.action.start('Creating preview');
+        core_1.ux.action.start('Creating preview', undefined, { stdout: true });
         // Update the name.
         updatedConfiguration.name = newName;
         // Update the display name.
@@ -225,20 +225,20 @@ class Publish extends baseCommand_1.BaseCommand {
     }
     async publishIntegration(integrationConfiguration) {
         // Packaging the integration.
-        core_1.ux.action.start('Packaging');
+        core_1.ux.action.start('Packaging', undefined, { stdout: true });
         // Write the final configuration on disk.
         await IntegrationConfiguration.writeConfiguration(integrationConfiguration);
         const archivePath = this.archiveIntegration();
         core_1.ux.action.stop();
         // Publish the integration.
-        core_1.ux.action.start('Publishing');
+        core_1.ux.action.start('Publishing', undefined, { stdout: true });
         await IntegrationsPlatform.publishIntegration(archivePath);
         core_1.ux.action.stop();
         // Summary of the operation.
         core_1.ux.log('');
         core_1.ux.log(['Your integration', gradient.fruit(integrationConfiguration.name), 'is being published.'].join(' '));
-        core_1.ux.log(chalk_1.default.yellowBright("Note that if the code of your integration did not change, it won't be republished."));
-        core_1.ux.log(chalk_1.default.blueBright(`You can follow the publishing of ${gradient.fruit(integrationConfiguration.name)} by running the command ${chalk_1.default.yellowBright('integration-cli activity --follow')}.`));
+        core_1.ux.log("Note that if the code of your integration did not change, it won't be republished.");
+        core_1.ux.log(chalk_1.default.blueBright(`To follow the publication, execute ${chalk_1.default.yellowBright('integration-cli activity --follow')}.`));
     }
     indent(paragraph, tabs = 1) {
         return paragraph
@@ -258,7 +258,7 @@ class Publish extends baseCommand_1.BaseCommand {
         return crypto_1.default.createHash('shake256', { outputLength: 2 }).update(email).digest('hex');
     }
     async generateNewSecrets(integrationConfiguration, newIntegrationName) {
-        core_1.ux.action.start(`Reencrypting with name ${newIntegrationName}`);
+        core_1.ux.action.start(`Reencrypting with name ${newIntegrationName}`, undefined, { stdout: true });
         const updatedConfiguration = JSON.parse(JSON.stringify(integrationConfiguration)); // deep copy.
         for (const authorization of updatedConfiguration.authorizations ?? []) {
             /* istanbul ignore if */

package/dist/src/commands/test.js

@@ -10,6 +10,7 @@ const GlobalConfiguration = tslib_1.__importStar(require("../resources/globalCon
 const integrations_1 = require("../resources/integrations");
 const configuration_1 = require("../resources/configuration");
 const decryption_1 = require("../resources/decryption");
+const credentials_1 = require("../resources/credentials");
 class Test extends baseCommand_1.BaseCommand {
     static description = 'Test your integration';
     static examples = ['<%= config.bin %> <%= command.id %>'];
@@ -36,13 +37,22 @@ class Test extends baseCommand_1.BaseCommand {
             description: 'output report in JSON format at the specified path',
         }),
         'credential-payload': core_1.Flags.string({
+            description: '(advanced) credential payload to use.',
+            exclusive: ['credential-id'],
+        }),
+        'credential-id': core_1.Flags.integer({
             description: '(advanced) credential to use.',
+            exclusive: ['credential-payload'],
         }),
         'test-account': core_1.Flags.string({
-            description: 'Test account to use.',
+            description: 'test account to use.',
             options: Object.values(configuration_1.CredentialScope),
             default: configuration_1.CredentialScope.DEVELOPMENT,
         }),
+        'read-only': core_1.Flags.boolean({
+            description: 'whether or not to only perform read operations',
+            allowNo: true,
+        }),
         crawlMode: core_1.Flags.string({
             description: 'mode to use while crawling the integration graph',
             options: Object.values(configuration_1.CrawlMode),
@@ -54,13 +64,13 @@ class Test extends baseCommand_1.BaseCommand {
             default: [],
         }),
         debug: core_1.Flags.boolean({
-            description: 'Log launch command to console before running it - including decrypted values - for debugging only',
+            description: 'log launch command to console before running it - including decrypted values - for debugging only',
             hidden: true,
             default: false,
         }),
         'config-path': core_1.Flags.string({
             summary: 'relative path to a custom ".unito.json" file',
-            description: `Use a custom configuration file instead of the default '.unito.json' or other environment specific
+            description: `use a custom configuration file instead of the default '.unito.json' or other environment specific
       ones.
 
       If you want to force the CLI to use a specific configuration file, you can use this flag to specify the relative
@@ -89,19 +99,30 @@ class Test extends baseCommand_1.BaseCommand {
         // Resolve the configuration.
         const environment = flags.environment ?? GlobalConfiguration.Environment.Production;
         const configuration = await (0, configuration_1.getConfiguration)(environment, flags['config-path']);
-        let credentialPayload = flags['credential-payload'];
-        // Default to test account's credentials if none are specifically provided
-        if (credentialPayload === null || credentialPayload === undefined) {
+        let credentialPayload;
+        let readOnly = flags['read-only'] ?? false;
+        if (flags['credential-id']) {
+            const credential = await (0, credentials_1.fetchCredential)(environment, this.config.configDir, flags['credential-id']);
+            credentialPayload = JSON.stringify(credential.payload);
+            // When "credential-id" is provided, the default value of "read-only" is false.
+            readOnly = flags['read-only'] ?? true;
+        }
+        else if (flags['credential-payload']) {
+            credentialPayload = flags['credential-payload'];
+        }
+        else {
             let credentials = configuration.testAccounts?.[flags['test-account']];
             if (credentials) {
-                ({ entries: credentials } = await (0, decryption_1.decryptEntries)(configuration.name, environment, this.config.configDir, credentials));
+                credentials = (await (0, decryption_1.decryptEntries)(configuration.name, environment, this.config.configDir, credentials))
+                    .entries;
             }
             credentialPayload = JSON.stringify(credentials);
         }
         let secrets = {};
         // Decrypt secrets, if necessary.
         if (configuration.secrets) {
-            secrets = await (0, decryption_1.decryptEntries)(configuration.name, environment, this.config.configDir, configuration.secrets);
+            secrets = (await (0, decryption_1.decryptEntries)(configuration.name, environment, this.config.configDir, configuration.secrets))
+                .entries;
         }
         // Launch the tests.
         const commandArguments = [
@@ -114,6 +135,9 @@ class Test extends baseCommand_1.BaseCommand {
             `--starting-path=${flags['starting-path']}`,
             `--starting-operation=${flags['starting-operation']}`,
         ];
+        if (readOnly) {
+            commandArguments.push('--read-only');
+        }
         if (configuration.graphRelativeUrl) {
             commandArguments.push(`--graph-relative-url=${configuration.graphRelativeUrl}`);
         }

package/dist/src/commands/upgrade.js

@@ -26,7 +26,7 @@ class Upgrade extends baseCommand_1.BaseCommand {
         //
         // Current version
         //
-        core_1.ux.action.start('Checking the current version');
+        core_1.ux.action.start('Checking the current version', undefined, { stdout: true });
         const currentVersion = child_process_1.default
             .execSync(`npm list ${npmOptions} --depth 0 | grep ${packageName} | sed "s/.*@\\([^@]*\\)$/\\1/"`, execOptions)
             .toString()
@@ -35,7 +35,7 @@ class Upgrade extends baseCommand_1.BaseCommand {
         //
         // Next version
         //
-        core_1.ux.action.start('Checking the available version');
+        core_1.ux.action.start('Checking the available version', undefined, { stdout: true });
         const newVersion = child_process_1.default
             .execSync(`npm show ${npmOptions} ${packageName} version`, execOptions)
             .toString()
@@ -51,7 +51,7 @@ class Upgrade extends baseCommand_1.BaseCommand {
         //
         // Validate / Upgrade the package globally.
         //
-        core_1.ux.action.start(`${latestVersion ? 'Validating' : 'Upgrading'} the package`);
+        core_1.ux.action.start(`${latestVersion ? 'Validating' : 'Upgrading'} the package`, undefined, { stdout: true });
         // To make sure we have a clean version of the CLI, with updated packages, we force the re-installation.
         child_process_1.default.execSync(`npm install --force ${npmOptions} ${packageName}`, {
             ...execOptions,

package/dist/src/errors.d.ts

@@ -21,6 +21,14 @@ export declare class AuthenticationFailed extends Error {
 }
 export declare class DecryptionAuthenticationError extends Error {
 }
+export declare class UnsupportedContentTypeError extends Error {
+}
+export declare class CredentialAuthenticationError extends Error {
+}
+export declare class CredentialAccessDenied extends Error {
+}
+export declare class IntegrationAlreadyExistsError extends Error {
+}
 export declare class EntryDecryptionError extends Error {
     key: string;
     value: string;