@unito/integration-cli 0.57.2 → 0.58.1

package/dist/test/commands/oauth2.test.js

@@ -6,7 +6,7 @@ const core_1 = require("@oclif/core");
 const sinon = tslib_1.__importStar(require("sinon"));
 const inquirer_1 = tslib_1.__importDefault(require("inquirer"));
 const Configuration = tslib_1.__importStar(require("../../src/resources/configuration"));
-const oauth2Service = tslib_1.__importStar(require("../../src/services/oauth2Helper"));
+const oauth2Service = tslib_1.__importStar(require("../../src/resources/oauth2"));
 const IntegrationsPlatform = tslib_1.__importStar(require("../../src/services/integrationsPlatform"));
 const decryptionResource = tslib_1.__importStar(require("../../src/resources/decryption"));
 const configurationTypes_1 = require("../../src/configurationTypes");
@@ -59,6 +59,7 @@ describe('oauth2', () => {
     });
     test_1.test
         .stdout()
+        .stderr()
         .do(() => getConfigurationsStub.returns({
         ...baseConfiguration,
         authorizations: [],
@@ -86,6 +87,7 @@ describe('oauth2', () => {
         (0, test_1.expect)(performOAuth2FlowStub.getCall(0).args).to.deep.equal([
             { ...oauth2Information, clientId: 'devClientID' },
             'production',
+            undefined,
         ]);
         (0, test_1.expect)(updateTokenStub.getCalls().length).to.equal(0);
         (0, test_1.expect)(writeTestAccountStub.getCall(0).args).to.deep.equal([
@@ -101,6 +103,8 @@ describe('oauth2', () => {
                     },
                 ],
             },
+            'production',
+            undefined,
             credentials,
             'development',
         ]);
@@ -111,7 +115,13 @@ describe('oauth2', () => {
         .it('performs the oauth flow when there is no test accounts and the auth information are setup', () => {
         (0, test_1.expect)(performOAuth2FlowStub.getCalls().length).to.equal(1);
         (0, test_1.expect)(updateTokenStub.getCalls().length).to.equal(0);
-        (0, test_1.expect)(writeTestAccountStub.getCall(0).args).to.deep.equal([baseConfiguration, credentials, 'development']);
+        (0, test_1.expect)(writeTestAccountStub.getCall(0).args).to.deep.equal([
+            baseConfiguration,
+            'production',
+            undefined,
+            credentials,
+            'development',
+        ]);
     });
     test_1.test
         .stdout()
@@ -132,6 +142,8 @@ describe('oauth2', () => {
                     development: credentials,
                 },
             },
+            'production',
+            undefined,
             credentials,
             'development',
         ]);
@@ -155,6 +167,8 @@ describe('oauth2', () => {
                     development: { something: 'something' },
                 },
             },
+            'production',
+            undefined,
             credentials,
             'compliance',
         ]);
@@ -178,6 +192,8 @@ describe('oauth2', () => {
                     development: credentials,
                 },
             },
+            'production',
+            undefined,
             credentials,
             'development',
         ]);
@@ -241,6 +257,8 @@ describe('oauth2', () => {
                     },
                 },
             },
+            'production',
+            undefined,
             {
                 accessToken: `${Configuration.ENCRYPTION_PREFIX}encryptedAccessToken`,
                 refreshToken: `${Configuration.ENCRYPTION_PREFIX}encryptedRefreshToken`,

package/dist/test/commands/publish.test.js

@@ -258,6 +258,7 @@ describe('Publish', () => {
     });
     test_1.test
         .stdout()
+        .stderr()
         .stub(GlobalConfiguration, 'read', stub => stub.throws(new errors_1.NoConfigurationFileError()))
         .stub(FileSystem, 'getFileBuffer', stub => stub.resolves(Buffer.from('')))
         .command(['publish'])

package/dist/test/commands/test.test.js

@@ -8,6 +8,7 @@ const IntegrationsPlatform = tslib_1.__importStar(require("../../src/services/in
 const IntegrationsPlatformResource = tslib_1.__importStar(require("../../src/resources/integrationsPlatform"));
 const ConfigurationResource = tslib_1.__importStar(require("../../src/resources/configuration"));
 const IntegrationResource = tslib_1.__importStar(require("../../src/resources/integrations"));
+const CredentialResource = tslib_1.__importStar(require("../../src/resources/credentials"));
 const errors_1 = require("../../src/errors");
 describe('Test', () => {
     const cliConfiguration = {
@@ -50,6 +51,7 @@ describe('Test', () => {
     });
     test_1.test
         .stdout()
+        .stderr()
         .stub(ConfigurationResource, 'getConfiguration', stub => stub.resolves(cliConfiguration))
         .stub(IntegrationResource, 'validateIsIntegrationDirectory', stub => stub.throws(new Error('boom!')))
         .command(['test'])
@@ -187,4 +189,24 @@ describe('Test', () => {
         .it('overrides --webhook-acknowledge-relative-url', () => {
         (0, test_1.expect)(spawnStub.getCall(0).args.at(1)).to.include('--webhook-acknowledge-relative-url=bar');
     });
+    test_1.test
+        .stdout()
+        .stub(ConfigurationResource, 'getConfiguration', stub => stub.resolves(cliConfiguration))
+        .stub(IntegrationResource, 'validateIsIntegrationDirectory', stub => stub.returns(true))
+        .stub(CredentialResource, 'fetchCredential', stub => stub.resolves({ payload: { from: 'credential' } }))
+        .command(['test', '--credential-id=123'])
+        .it('credential-id', () => {
+        (0, test_1.expect)(spawnStub.getCall(0).args.at(1)).to.include('--credential-payload={"from":"credential"}');
+        (0, test_1.expect)(spawnStub.getCall(0).args.at(1)).to.include('--read-only');
+    });
+    test_1.test
+        .stdout()
+        .stub(ConfigurationResource, 'getConfiguration', stub => stub.resolves(cliConfiguration))
+        .stub(IntegrationResource, 'validateIsIntegrationDirectory', stub => stub.returns(true))
+        .stub(CredentialResource, 'fetchCredential', stub => stub.resolves({ payload: { from: 'credential' } }))
+        .command(['test', '--credential-id=123', '--no-read-only'])
+        .it('credential-id && read-only', () => {
+        (0, test_1.expect)(spawnStub.getCall(0).args.at(1)).to.include('--credential-payload={"from":"credential"}');
+        (0, test_1.expect)(spawnStub.getCall(0).args.at(1)).to.not.include('--read-only');
+    });
 });

package/dist/test/commands/upgrade.test.js

@@ -37,6 +37,7 @@ describe('Upgrade', () => {
     });
     test_1.test
         .stdout()
+        .stderr()
         .stub(child_process_1.default, 'execSync', stub => stub.throws(new errors_1.ConfigurationMalformed()))
         .command(['upgrade'])
         .exit(-1)

package/dist/test/resources/integrations.test.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const strict_1 = tslib_1.__importDefault(require("node:assert/strict"));
+const path = tslib_1.__importStar(require("path"));
+const tmp_1 = tslib_1.__importDefault(require("tmp"));
+const fs_1 = tslib_1.__importDefault(require("fs"));
+const Integration = tslib_1.__importStar(require("../../src/resources/integrations"));
+const errors_1 = require("../../src/errors");
+describe('integrations', () => {
+    let tempDir;
+    const boilerplatePath = path.join(__dirname, '../../boilerplate');
+    describe('copyBoilerplate', () => {
+        beforeEach(() => {
+            tempDir = tmp_1.default.dirSync().name;
+        });
+        it('copy files', async () => {
+            const result = await Integration.copyBoilerplate('foo', tempDir);
+            strict_1.default.equal(result, path.join(tempDir, 'foo'));
+            (0, strict_1.default)(fs_1.default.existsSync(result));
+            const expectedFiles = await fs_1.default.promises.readdir(boilerplatePath);
+            expectedFiles.push('.npmrc');
+            const createdFiles = await fs_1.default.promises.readdir(result);
+            strict_1.default.deepEqual(createdFiles, expectedFiles.sort());
+            createdFiles.forEach(createdField => (0, strict_1.default)(expectedFiles.includes(createdField)));
+        });
+        it('already exists', async () => {
+            strict_1.default.doesNotThrow(async () => await Integration.copyBoilerplate('foo', tempDir));
+            strict_1.default.rejects(Integration.copyBoilerplate('foo', tempDir), errors_1.IntegrationAlreadyExistsError);
+        });
+        it('generates an .npmrc file', async () => {
+            const result = await Integration.copyBoilerplate('foo', tempDir);
+            const npmrc = await fs_1.default.promises.readFile(`${result}/.npmrc`, 'utf-8');
+            (0, strict_1.default)(npmrc.includes('engine-strict=true'));
+        });
+    });
+});

package/dist/test/resources/oauth2.test.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const strict_1 = tslib_1.__importDefault(require("node:assert/strict"));
+const sinon_1 = tslib_1.__importDefault(require("sinon"));
+const oauth2_1 = tslib_1.__importDefault(require("../../src/services/oauth2"));
+const configurationTypes_1 = require("../../src/configurationTypes");
+const oauth2HelperResource = tslib_1.__importStar(require("../../src/resources/oauth2"));
+const errors_1 = require("../../src/errors");
+const inquirer_1 = tslib_1.__importDefault(require("inquirer"));
+describe('OAuth2Helper', () => {
+    let fetchStub;
+    const authorizationInfo = {
+        clientId: 'your-client-id',
+        clientSecret: 'your-client-secret',
+        authorizationUrl: 'https://provider.com/oauth/authorize',
+        scopes: [{ name: 'scope1' }, { name: 'scope2' }],
+        tokenUrl: 'https://provider.com/oauth/token',
+        grantType: configurationTypes_1.GrantType.AUTHORIZATION_CODE,
+        requestContentType: configurationTypes_1.RequestContentType.URL_ENCODED,
+        responseContentType: configurationTypes_1.RequestContentType.JSON,
+    };
+    beforeEach(() => {
+        sinon_1.default.stub(oauth2_1.default.prototype, 'startServer').resolves('http://localhost:5050');
+        sinon_1.default.stub(oauth2_1.default.prototype, 'stopServer');
+        sinon_1.default.stub(oauth2_1.default.prototype, 'authorize');
+        sinon_1.default.stub(inquirer_1.default, 'prompt');
+    });
+    afterEach(() => {
+        sinon_1.default.restore();
+    });
+    describe('performOAuth2Flow', () => {
+        it('should perform the oauth flow', async () => {
+            fetchStub = sinon_1.default.stub().onFirstCall().resolves({ status: 200 }).onSecondCall().resolves({ status: 200 });
+            sinon_1.default.replace(global, 'fetch', fetchStub);
+            sinon_1.default.stub(oauth2_1.default.prototype, 'callbackIsDone').resolves({ accessToken: 'token' });
+            await oauth2HelperResource.performOAuth2Flow(authorizationInfo);
+            strict_1.default.equal(fetchStub.getCall(0).args.at(0), 'http://localhost:5050/health');
+        });
+        it('raises a FailedToRetrieveAccessTokenError', async () => {
+            fetchStub = sinon_1.default.stub().onFirstCall().resolves({ status: 200 }).onSecondCall().resolves({ status: 200 });
+            sinon_1.default.replace(global, 'fetch', fetchStub);
+            sinon_1.default.stub(oauth2_1.default.prototype, 'callbackIsDone').resolves({});
+            const response = oauth2HelperResource.performOAuth2Flow(authorizationInfo);
+            await strict_1.default.rejects(response, errors_1.FailedToRetrieveAccessTokenError);
+        });
+        it('raises a FailedToRetrieveAccessTokenError when the accessToken is not returned', async () => {
+            fetchStub = sinon_1.default.stub().onFirstCall().resolves({ status: 200 }).onSecondCall().resolves({ status: 200 });
+            sinon_1.default.replace(global, 'fetch', fetchStub);
+            sinon_1.default.stub(oauth2_1.default.prototype, 'callbackIsDone').resolves({});
+            const response = oauth2HelperResource.performOAuth2Flow(authorizationInfo);
+            await strict_1.default.rejects(response, errors_1.FailedToRetrieveAccessTokenError);
+        });
+    });
+});

package/dist/test/resources/template.test.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const strict_1 = tslib_1.__importDefault(require("node:assert/strict"));
+const node_test_1 = require("node:test");
+const template_1 = require("../../src/resources/template");
+(0, node_test_1.describe)('template', function () {
+    const context = {
+        var: 'value',
+        'some.value': 'some',
+        some_value: 'value',
+        'Some%20Thing': 'Some%20Thing',
+        foo: 'bar',
+        hello: 'Hello World!',
+        bool: 'false',
+        toString: 'string',
+        chars: 'šö䟜ñꀣ¥‡ÑÒÓÔÕÖ×ØÙÚàáâãäåæçÿü',
+        path: '/foo/bar',
+        surrogatepairs: '\uD834\uDF06',
+    };
+    (0, node_test_1.it)('empty string', function () {
+        strict_1.default.equal((0, template_1.parseTemplate)('').expand(context), '');
+    });
+    (0, node_test_1.it)('does not encode non expressions', function () {
+        strict_1.default.equal((0, template_1.parseTemplate)('hello/world').expand(context), 'hello/world');
+        strict_1.default.equal((0, template_1.parseTemplate)('Hello World!/{foo}').expand(context), 'Hello%20World!/{foo}');
+    });
+    (0, node_test_1.it)('expand non-ASCII strings', function () {
+        strict_1.default.equal((0, template_1.parseTemplate)('{+chars}').expand(context), '%C5%A1%C3%B6%C3%A4%C5%B8%C5%93%C3%B1%C3%AA%E2%82%AC%C2%A3%C2%A5%E2%80%A1%C3%91%C3%92%C3%93%C3%94%C3%95%C3%96%C3%97%C3%98%C3%99%C3%9A%C3%A0%C3%A1%C3%A2%C3%A3%C3%A4%C3%A5%C3%A6%C3%A7%C3%BF%C3%BC');
+    });
+    (0, node_test_1.it)('reserved expansion of basic strings', function () {
+        strict_1.default.equal((0, template_1.parseTemplate)('{+var}').expand(context), 'value');
+        strict_1.default.equal((0, template_1.parseTemplate)('{+hello}').expand(context), 'Hello%20World!');
+        strict_1.default.equal((0, template_1.parseTemplate)('{+Some%20Thing}').expand(context), 'Some%20Thing');
+    });
+    (0, node_test_1.it)('preserves paths', function () {
+        strict_1.default.equal((0, template_1.parseTemplate)('{+path}/here').expand(context), '/foo/bar/here');
+        strict_1.default.equal((0, template_1.parseTemplate)('here?ref={+path}').expand(context), 'here?ref=/foo/bar');
+    });
+});

package/dist/test/services/oauth2.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/services/oauth2.test.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/* eslint-disable  @typescript-eslint/no-explicit-any */
+const strict_1 = tslib_1.__importDefault(require("node:assert/strict"));
+const sinon_1 = tslib_1.__importDefault(require("sinon"));
+const oauth2_1 = tslib_1.__importStar(require("../../src/services/oauth2")), oauth2Namespace = oauth2_1;
+const configurationTypes_1 = require("../../src/configurationTypes");
+const errors_1 = require("../../src/errors");
+const globalConfiguration_1 = require("../../src/resources/globalConfiguration");
+describe('OAuth2Helper', () => {
+    let oauth2Helper;
+    let openSpy;
+    let fetchStub;
+    describe('constructor', () => {
+        it('should throw an error if the request content type is not supported', async () => {
+            try {
+                new oauth2_1.default({ scopes: [], requestContentType: 'random' });
+            }
+            catch (err) {
+                (0, strict_1.default)(err instanceof errors_1.UnsupportedContentTypeError);
+            }
+        });
+    });
+    describe('method', () => {
+        beforeEach(() => {
+            const authorizationInfo = {
+                clientId: 'your-client-id',
+                clientSecret: 'your-client-secret',
+                authorizationUrl: 'https://provider.com/oauth/authorize',
+                scopes: [{ name: 'scope1' }, { name: 'scope2' }],
+                tokenUrl: 'https://provider.com/oauth/token',
+                grantType: configurationTypes_1.GrantType.AUTHORIZATION_CODE,
+                requestContentType: configurationTypes_1.RequestContentType.URL_ENCODED,
+                responseContentType: configurationTypes_1.RequestContentType.JSON,
+                tokenRequestParameters: {
+                    header: {
+                        Authorization: 'custom',
+                    },
+                },
+            };
+            oauth2Helper = new oauth2_1.default(authorizationInfo, globalConfiguration_1.Environment.Production, { foo: 'fooValue', bar: 'barValue' });
+            fetchStub = sinon_1.default.stub().resolves({ json: sinon_1.default.stub().resolves({}), status: 200 });
+            sinon_1.default.stub(oauth2Helper, 'startServer').resolves('http://localhost:5050');
+            sinon_1.default.stub(oauth2Helper, 'stopServer');
+            sinon_1.default.replace(global, 'fetch', fetchStub);
+            sinon_1.default.replace(oauth2Namespace, 'open', { open: (_url) => undefined });
+            openSpy = sinon_1.default.stub(oauth2Namespace.open, 'open');
+        });
+        afterEach(() => {
+            sinon_1.default.restore();
+        });
+        describe('authorize', () => {
+            it('should open the authorization URL', async () => {
+                await oauth2Helper.authorize();
+                sinon_1.default.assert.calledOnce(openSpy);
+                sinon_1.default.assert.calledWith(openSpy, 'https://provider.com/oauth/authorize?client_id=your-client-id&scope=scope1+scope2&state=eyJjbGlDYWxsYmFja1VybCI6Ii9vYXV0aDIvY2FsbGJhY2sifQ%3D%3D&response_type=code&redirect_uri=https%3A%2F%2Fintegrations-platform.unito.io%2Fcredentials%2Fnew%2Foauth2%2Fcallback-cli');
+            });
+            it('should maintain the pre-existing query parameters in authorization URL', async () => {
+                oauth2Helper['providerAuthorizationUrl'] = 'https://provider.com/oauth/authorize?query1=value1&query2=value2';
+                await oauth2Helper.authorize();
+                sinon_1.default.assert.calledOnce(openSpy);
+                sinon_1.default.assert.calledWith(openSpy, 'https://provider.com/oauth/authorize?query1=value1&query2=value2&client_id=your-client-id&scope=scope1+scope2&state=eyJjbGlDYWxsYmFja1VybCI6Ii9vYXV0aDIvY2FsbGJhY2sifQ%3D%3D&response_type=code&redirect_uri=https%3A%2F%2Fintegrations-platform.unito.io%2Fcredentials%2Fnew%2Foauth2%2Fcallback-cli');
+            });
+            it('should support dynamic params', async () => {
+                oauth2Helper['providerAuthorizationUrl'] = 'https://pro-{+foo}-der.com/oauth/authorize?query1={+bar}';
+                await oauth2Helper.authorize();
+                sinon_1.default.assert.calledOnce(openSpy);
+                sinon_1.default.assert.calledWith(openSpy, 'https://pro-fooValue-der.com/oauth/authorize?query1=barValue&client_id=your-client-id&scope=scope1+scope2&state=eyJjbGlDYWxsYmFja1VybCI6Ii9vYXV0aDIvY2FsbGJhY2sifQ%3D%3D&response_type=code&redirect_uri=https%3A%2F%2Fintegrations-platform.unito.io%2Fcredentials%2Fnew%2Foauth2%2Fcallback-cli');
+            });
+        });
+        describe('handleCallback', () => {
+            it('should retrieve the access token and return it in the response', async () => {
+                const code = 'test-code';
+                const req = { query: { code } };
+                const res = { send: sinon_1.default.stub(), setHeader: sinon_1.default.stub() };
+                await oauth2Helper['handleCallback'](req, res);
+                sinon_1.default.assert.calledOnce(fetchStub);
+                sinon_1.default.assert.calledWith(fetchStub, 'https://provider.com/oauth/token', {
+                    headers: {
+                        'Content-Type': 'application/x-www-form-urlencoded',
+                        Authorization: 'custom',
+                    },
+                    body: sinon_1.default.match.string,
+                    method: 'POST',
+                });
+                sinon_1.default.assert.calledOnce(res.send);
+                sinon_1.default.assert.calledWith(res.send, oauth2Namespace.HTML_SUCCESS_MSG);
+            });
+            it('should handle dynamic variables with values from provider response and credential payload', async () => {
+                oauth2Helper['tokenUrl'] = 'https://{+foo}.com/oauth/token?specialParam={+authorizationResponse.responseValue}';
+                const code = 'test-code';
+                const req = { query: { code, responseValue: 'DynamicValue' } };
+                const res = { send: sinon_1.default.stub(), setHeader: sinon_1.default.stub() };
+                await oauth2Helper['handleCallback'](req, res);
+                sinon_1.default.assert.calledOnce(fetchStub);
+                sinon_1.default.assert.calledWith(fetchStub, 'https://fooValue.com/oauth/token?specialParam=DynamicValue', {
+                    headers: {
+                        'Content-Type': 'application/x-www-form-urlencoded',
+                        Authorization: 'custom',
+                    },
+                    body: sinon_1.default.match.string,
+                    method: 'POST',
+                });
+                sinon_1.default.assert.calledOnce(res.send);
+                sinon_1.default.assert.calledWith(res.send, oauth2Namespace.HTML_SUCCESS_MSG);
+            });
+            it('should handle errors and return 500 status', async () => {
+                const code = 'test-code';
+                const req = { query: { code } };
+                const res = { send: sinon_1.default.stub(), setHeader: sinon_1.default.stub() };
+                fetchStub.rejects(new Error('Failed to retrieve access token'));
+                await oauth2Helper['handleCallback'](req, res);
+                sinon_1.default.assert.calledOnce(res.send);
+                sinon_1.default.assert.calledWith(res.send, oauth2Namespace.HTML_ERROR_MSG);
+            });
+        });
+        describe('updateToken', () => {
+            it('should retrieve the access token when a refresh token is available', async () => {
+                const refreshToken = 'test-refresh-token';
+                const accessToken = 'test-access-token';
+                const fetchResponse = { access_token: accessToken, refresh_token: refreshToken };
+                fetchStub.resolves({ status: 200, json: sinon_1.default.stub().resolves(fetchResponse) });
+                const result = await oauth2Helper.updateToken(refreshToken);
+                strict_1.default.deepEqual(result, { accessToken, refreshToken });
+                sinon_1.default.assert.calledOnce(fetchStub);
+            });
+            it('should throw an error when failing to refresh the access token', async () => {
+                const refreshToken = 'test-refresh-token';
+                fetchStub.rejects(new Error('Failed to retrieve access token'));
+                const response = oauth2Helper.updateToken(refreshToken);
+                await strict_1.default.rejects(response, errors_1.FailedToRetrieveAccessTokenError);
+                sinon_1.default.assert.calledOnce(fetchStub);
+            });
+            it("should throw an error if we don't support the request content type", async () => {
+                const refreshToken = 'test-refresh-token';
+                oauth2Helper['requestContentType'] = 'random';
+                const response = oauth2Helper.updateToken(refreshToken);
+                await strict_1.default.rejects(response, errors_1.InvalidRequestContentTypeError);
+            });
+        });
+        describe('encodeBody', () => {
+            it('should encode body data as URL-encoded when content type is URL_ENCODED', () => {
+                const bodyData = { key1: 'value1', key2: 'value2' };
+                const contentType = configurationTypes_1.RequestContentType.URL_ENCODED;
+                const expectedEncodedBody = 'key1=value1&key2=value2';
+                const encodedBody = oauth2Helper['encodeBody'](bodyData, contentType);
+                strict_1.default.equal(encodedBody, expectedEncodedBody);
+            });
+            it('should encode body data as JSON when content type is JSON', () => {
+                const bodyData = { key1: 'value1', key2: 'value2' };
+                const contentType = configurationTypes_1.RequestContentType.JSON;
+                const expectedEncodedBody = JSON.stringify(bodyData);
+                const encodedBody = oauth2Helper['encodeBody'](bodyData, contentType);
+                strict_1.default.equal(encodedBody, expectedEncodedBody);
+            });
+        });
+    });
+});

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.57.2",
+  "version": "0.58.1",
   "commands": {
     "activity": {
       "id": "activity",
@@ -74,6 +74,41 @@
           "description": "output more (debug) information",
           "allowNo": false
         },
+        "credential-payload": {
+          "name": "credential-payload",
+          "type": "option",
+          "description": "(advanced) credential payload to use.",
+          "multiple": false,
+          "exclusive": [
+            "credential-id"
+          ]
+        },
+        "credential-id": {
+          "name": "credential-id",
+          "type": "option",
+          "description": "(advanced) credential to use.",
+          "multiple": false,
+          "exclusive": [
+            "credential-payload"
+          ]
+        },
+        "test-account": {
+          "name": "test-account",
+          "type": "option",
+          "description": "test account to use.",
+          "multiple": false,
+          "options": [
+            "development",
+            "compliance"
+          ],
+          "default": "development"
+        },
+        "read-only": {
+          "name": "read-only",
+          "type": "boolean",
+          "description": "whether or not to only perform read operations",
+          "allowNo": true
+        },
         "crawlMode": {
           "name": "crawlMode",
           "type": "option",
@@ -209,15 +244,16 @@
     },
     "oauth2": {
       "id": "oauth2",
-      "summary": "Perform an OAuth2 workflow locally",
-      "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.",
+      "summary": "Perform an OAuth2 workflow to either populate or refresh a test account's credentials.",
+      "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.\n\n    If the test-account is already populated, the command will refresh the credentials if the refresh token is available.\n    If you want to force a new OAuth2 flow to change the connected account or something else, use the --reauth flag.",
       "strict": true,
       "pluginName": "@unito/integration-cli",
       "pluginAlias": "@unito/integration-cli",
       "pluginType": "core",
       "aliases": [],
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --reauth --test-account=compliance"
       ],
       "flags": {
         "test-account": {
@@ -235,6 +271,7 @@
           "name": "environment",
           "type": "option",
           "description": "the environment of the platform",
+          "hidden": true,
           "multiple": false,
           "options": [
             "local",
@@ -246,7 +283,7 @@
         "reauth": {
           "name": "reauth",
           "type": "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",
           "allowNo": false
         },
         "config-path": {
@@ -394,13 +431,25 @@
         "credential-payload": {
           "name": "credential-payload",
           "type": "option",
+          "description": "(advanced) credential payload to use.",
+          "multiple": false,
+          "exclusive": [
+            "credential-id"
+          ]
+        },
+        "credential-id": {
+          "name": "credential-id",
+          "type": "option",
           "description": "(advanced) credential to use.",
-          "multiple": false
+          "multiple": false,
+          "exclusive": [
+            "credential-payload"
+          ]
         },
         "test-account": {
           "name": "test-account",
           "type": "option",
-          "description": "Test account to use.",
+          "description": "test account to use.",
           "multiple": false,
           "options": [
             "development",
@@ -408,6 +457,12 @@
           ],
           "default": "development"
         },
+        "read-only": {
+          "name": "read-only",
+          "type": "boolean",
+          "description": "whether or not to only perform read operations",
+          "allowNo": true
+        },
         "crawlMode": {
           "name": "crawlMode",
           "type": "option",
@@ -430,7 +485,7 @@
         "debug": {
           "name": "debug",
           "type": "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,
           "allowNo": false
         },
@@ -438,7 +493,7 @@
           "name": "config-path",
           "type": "option",
           "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\n      ones.\n\n      If you want to force the CLI to use a specific configuration file, you can use this flag to specify the relative\n      path from your integration's root folder (with a leading '/').\n\n      Usage: <%= config.bin %> <%= command.id %> --config-path=/myCustomConfig.json",
+          "description": "use a custom configuration file instead of the default '.unito.json' or other environment specific\n      ones.\n\n      If you want to force the CLI to use a specific configuration file, you can use this flag to specify the relative\n      path from your integration's root folder (with a leading '/').\n\n      Usage: <%= config.bin %> <%= command.id %> --config-path=/myCustomConfig.json",
           "multiple": false
         }
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unito/integration-cli",
-  "version": "0.57.2",
+  "version": "0.58.1",
   "description": "Integration CLI",
   "bin": {
     "integration-cli": "./bin/run"
@@ -13,18 +13,18 @@
     "email": "hello@unito.io"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "scripts": {
     "prepublishOnly": "npm run lint && npm run test",
     "prepack": "oclif manifest",
     "postpack": "shx rm -f oclif.manifest.json",
     "prepare": "npm run compile",
-    "lint": "eslint --fix src test scripts integrationGenerator/src integrationGenerator/test --ext .ts && prettier --write src test scripts integrationGenerator/src integrationGenerator/test",
-    "compile": "ts-node scripts/generateTypes.ts > src/configurationTypes.ts && tsc -b && mkdir -p dist/schemas && cp schemas/*.json dist/schemas/ && cp -r integrationGenerator/integrationBoilerplate ./dist/integrationGenerator/integrationBoilerplate",
+    "lint": "eslint --fix src test scripts --ext .ts && prettier --write src test scripts",
+    "compile": "rm -rf dist && ts-node scripts/generateTypes.ts > src/configurationTypes.ts && tsc -b && mkdir -p dist/schemas && cp schemas/*.json dist/schemas/ && cp -r boilerplate ./dist/boilerplate",
     "compile:watch": "tsc --build -w",
-    "test": "mocha $(find test -name '*.test.ts') $(find integrationGenerator/test -name '*.test.ts')",
-    "test:debug": "mocha test/**/*.test.ts integrationGenerator/test/**/*.test.ts --inspect-brk",
+    "test": "mocha \"test/**/*.test.ts\"",
+    "test:debug": "mocha --inspect-brk \"test/**/*.test.ts\"",
     "ci:test": "c8 npm run test"
   },
   "files": [
@@ -38,7 +38,7 @@
     "@oclif/core": "3.x",
     "@typescript-eslint/eslint-plugin": "6.x",
     "@typescript-eslint/parser": "6.13.x",
-    "@unito/integration-debugger": "0.23.0",
+    "@unito/integration-debugger": "0.24.0",
     "@unito/integrations-platform-client": "0.46.1",
     "ajv": "8.x",
     "ajv-formats": "2.x",
@@ -62,7 +62,7 @@
     "@types/gradient-string": "1.x",
     "@types/inquirer": "9.x",
     "@types/mocha": "10.x",
-    "@types/node": "18.x",
+    "@types/node": "20.x",
     "@types/openurl": "1.x",
     "@types/tmp": "0.x",
     "c8": "9.x",

package/dist/integrationGenerator/errors.d.ts

@@ -1,2 +0,0 @@
-export declare class AlreadyExistingIntegrationError extends Error {
-}

package/dist/integrationGenerator/errors.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AlreadyExistingIntegrationError = void 0;
-class AlreadyExistingIntegrationError extends Error {
-}
-exports.AlreadyExistingIntegrationError = AlreadyExistingIntegrationError;

package/dist/integrationGenerator/index.d.ts

@@ -1,2 +0,0 @@
-export * from './src';
-export * from './errors';