@unito/integration-cli 0.65.0 → 0.67.0

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

@@ -16,6 +16,9 @@ export default class Graph extends BaseCommand<typeof Graph> {
         'credential-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'config-path': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        body: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'body-file': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/src/commands/graph.js

@@ -4,6 +4,7 @@ const tslib_1 = require("tslib");
 const crypto_1 = tslib_1.__importDefault(require("crypto"));
 const fs_1 = tslib_1.__importDefault(require("fs"));
 const core_1 = require("@oclif/core");
+const inquirer_1 = tslib_1.__importDefault(require("inquirer"));
 const baseCommand_1 = require("../baseCommand");
 const errors_1 = require("../errors");
 const GlobalConfiguration = tslib_1.__importStar(require("../resources/globalConfiguration"));
@@ -11,11 +12,22 @@ const integrations_1 = require("../resources/integrations");
 const configuration_1 = require("../resources/configuration");
 const decryption_1 = require("../resources/decryption");
 const credentials_1 = require("../resources/credentials");
+const METHOD_MAP = {
+    get: 'GET',
+    getItem: 'GET',
+    getCollection: 'GET',
+    createItem: 'POST',
+    updateItem: 'PATCH',
+    deleteItem: 'DELETE',
+};
 class Graph extends baseCommand_1.BaseCommand {
     static description = 'Query a running integration graph and print the response';
     static examples = [
         '<%= config.bin %> <%= command.id %> --path=/sobjects/Opportunity/records/abc123',
         '<%= config.bin %> <%= command.id %> get --path=/sobjects/Opportunity --port=9201',
+        `<%= config.bin %> <%= command.id %> createItem --path=/sobjects/Task/records --body='{"Name":"New Task"}'`,
+        '<%= config.bin %> <%= command.id %> updateItem --path=/sobjects/Task/records/abc123 --body=\'{"Name":"Updated"}\'',
+        '<%= config.bin %> <%= command.id %> deleteItem --path=/sobjects/Task/records/abc123',
     ];
     static args = {
         operation: core_1.Args.string({
@@ -72,13 +84,32 @@ class Graph extends baseCommand_1.BaseCommand {
             char: 'o',
             description: 'Write response body to file instead of stdout',
         }),
+        body: core_1.Flags.string({
+            char: 'b',
+            description: 'JSON request body for createItem/updateItem operations',
+            exclusive: ['body-file'],
+        }),
+        'body-file': core_1.Flags.string({
+            description: 'Path to a JSON file to use as request body',
+            exclusive: ['body'],
+        }),
+        yes: core_1.Flags.boolean({
+            char: 'y',
+            description: 'Skip confirmation prompt for destructive operations (deleteItem)',
+            default: false,
+        }),
     };
     async run() {
         (0, integrations_1.validateIsIntegrationDirectory)();
         const { args, flags } = await this.parse(Graph);
-        const operation = args.operation ?? 'get';
-        if (operation === 'createItem' || operation === 'updateItem' || operation === 'deleteItem') {
-            this.error(`Operation "${operation}" is not yet implemented`, { exit: 1 });
+        const operation = args.operation;
+        const method = METHOD_MAP[operation];
+        const needsBody = method === 'POST' || method === 'PATCH';
+        if (needsBody && !flags.body && !flags['body-file']) {
+            this.error('--body or --body-file is required for ' + operation, { exit: 1 });
+        }
+        if (operation === 'deleteItem' && (flags.body || flags['body-file'])) {
+            this.error('--body and --body-file are not supported for deleteItem', { exit: 1 });
         }
         const environment = flags.environment ?? GlobalConfiguration.Environment.Production;
         const configuration = await (0, configuration_1.getConfiguration)(environment, flags['config-path']);
@@ -122,22 +153,65 @@ class Graph extends baseCommand_1.BaseCommand {
             'X-Unito-Correlation-Id': crypto_1.default.randomUUID(),
             'Content-Type': 'application/json',
         };
+        let body;
+        if (needsBody) {
+            if (flags.body) {
+                try {
+                    JSON.parse(flags.body);
+                    body = flags.body;
+                }
+                catch {
+                    this.error('Invalid JSON in --body: ' + flags.body, { exit: 1 });
+                }
+            }
+            else if (flags['body-file']) {
+                const raw = await fs_1.default.promises.readFile(flags['body-file'], 'utf8').catch(() => {
+                    this.error('Could not read --body-file: ' + flags['body-file'], { exit: 1 });
+                });
+                try {
+                    JSON.parse(raw);
+                    body = raw;
+                }
+                catch {
+                    this.error('Invalid JSON in --body-file: ' + flags['body-file'], { exit: 1 });
+                }
+            }
+        }
         const url = `http://localhost:${flags.port}${flags.path}`;
-        const response = await fetch(url, { headers });
+        if (operation === 'deleteItem' && !flags.yes) {
+            const { proceed } = await inquirer_1.default.prompt({
+                name: 'proceed',
+                message: `About to DELETE ${flags.path}. Continue?`,
+                type: 'confirm',
+                default: false,
+            });
+            if (!proceed) {
+                this.log('Aborted.');
+                return;
+            }
+        }
+        const fetchOptions = { method, headers };
+        if (body) {
+            fetchOptions.body = body;
+        }
+        const response = await fetch(url, fetchOptions);
         if (!response.ok) {
-            const body = await response.json().catch(() => undefined);
-            if (body !== undefined) {
-                this.logToStderr(JSON.stringify(body, null, 2));
+            const errorBody = await response.json().catch(() => undefined);
+            if (errorBody !== undefined) {
+                this.logToStderr(JSON.stringify(errorBody, null, 2));
             }
             this.error(`HTTP ${response.status} from ${url}`, { exit: response.status });
         }
-        const body = (await response.json());
-        const json = JSON.stringify(body, null, 2);
-        if (flags.output) {
-            await fs_1.default.promises.writeFile(flags.output, json, 'utf8');
-        }
-        else {
-            this.log(json);
+        const hasContent = response.status !== 204;
+        if (hasContent) {
+            const responseBody = (await response.json());
+            const json = JSON.stringify(responseBody, null, 2);
+            if (flags.output) {
+                await fs_1.default.promises.writeFile(flags.output, json, 'utf8');
+            }
+            else {
+                this.log(json);
+            }
         }
     }
 }

package/dist/src/commands/schema-snapshot.js

@@ -50,6 +50,10 @@ class SchemaSnapshot extends baseCommand_1.BaseCommand {
             description: 'fail if any fields are unmapped and not in the allowlist',
             default: false,
         }),
+        port: core_1.Flags.integer({
+            description: 'port to start the integration on (default: 9200)',
+            default: 9200,
+        }),
     };
     async catch(error) {
         if ((0, errors_1.handleError)(this, error)) {
@@ -88,7 +92,7 @@ class SchemaSnapshot extends baseCommand_1.BaseCommand {
             throw new errors_1.EntryDecryptionError(failedSecrets.at(0), environment);
         }
         core_1.ux.action.start('Starting integration', undefined, { stdout: true });
-        const integrationPort = '9200';
+        const integrationPort = String(flags.port);
         let modernProcess;
         const recordingPath = path_1.default.join(os_1.default.tmpdir(), `schema-snapshot-recording-${Date.now()}.jsonl`);
         // Pre-create recording file with restrictive permissions (owner-only read/write).
@@ -123,9 +127,12 @@ class SchemaSnapshot extends baseCommand_1.BaseCommand {
                 readOnly: true,
                 timeout: 20,
                 [Operation.GetCollection]: {
-                    itemsPerPage: 1,
+                    itemsPerPage: 5,
                     followNextPage: false,
                 },
+                retryOnEmptyRelation: {
+                    maxSiblings: 3,
+                },
             });
             // Only crawl graph structure, skip all step checks.
             crawlerDriver.stepCheckKeys = [];

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

@@ -3,10 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const fs_1 = tslib_1.__importDefault(require("fs"));
 const test_1 = require("@oclif/test");
+const inquirer_1 = tslib_1.__importDefault(require("inquirer"));
 const sinon_1 = tslib_1.__importDefault(require("sinon"));
 const Configuration = tslib_1.__importStar(require("../../src/resources/configuration"));
 const Decryption = tslib_1.__importStar(require("../../src/resources/decryption"));
 const Integrations = tslib_1.__importStar(require("../../src/resources/integrations"));
+const originalReadFile = fs_1.default.promises.readFile.bind(fs_1.default.promises);
 const MOCK_CONFIG = {
     name: 'salesforce-v2',
     testAccounts: {
@@ -169,15 +171,203 @@ describe('graph', () => {
         .it('treats "getCollection" as a get operation', ctx => {
         (0, test_1.expect)(ctx.stdout).to.contain('"label": "Opportunity"');
     });
-    for (const op of ['createItem', 'updateItem', 'deleteItem']) {
-        test_1.test
-            .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
-            .command(['graph', op, '--path=/sobjects/Opportunity'])
-            .catch(err => {
-            (0, test_1.expect)(err.message).to.contain(`Operation "${op}" is not yet implemented`);
-        })
-            .it(`rejects "${op}" as not yet implemented`);
-    }
+    // --- createItem ---
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .stub(global, 'fetch', stub => stub.resolves({
+        ok: true,
+        status: 201,
+        json: () => Promise.resolve({ path: '/sobjects/Task/records/new123' }),
+    }))
+        .stdout()
+        .command(['graph', 'createItem', '--path=/sobjects/Task/records', '--body={"Name":"Test Task"}'])
+        .it('createItem sends POST with parsed JSON body', ctx => {
+        const fetchStub = global.fetch;
+        (0, test_1.expect)(fetchStub.calledOnce).to.be.true;
+        const [url, options] = fetchStub.firstCall.args;
+        (0, test_1.expect)(url).to.equal('http://localhost:9200/sobjects/Task/records');
+        (0, test_1.expect)(options.method).to.equal('POST');
+        (0, test_1.expect)(JSON.parse(options.body)).to.deep.equal({ Name: 'Test Task' });
+        (0, test_1.expect)(ctx.stdout).to.contain('/sobjects/Task/records/new123');
+    });
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .command(['graph', 'createItem', '--path=/sobjects/Task/records'])
+        .catch(err => {
+        (0, test_1.expect)(err.message).to.contain('--body or --body-file is required');
+    })
+        .it('createItem without --body or --body-file errors');
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .command(['graph', 'createItem', '--path=/sobjects/Task/records', '--body=not-json'])
+        .catch(err => {
+        (0, test_1.expect)(err.message).to.contain('Invalid JSON in --body');
+    })
+        .it('createItem with invalid JSON in --body errors');
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .stub(global, 'fetch', stub => stub.resolves({
+        ok: true,
+        status: 201,
+        json: () => Promise.resolve({ path: '/sobjects/Task/records/new456' }),
+    }))
+        .stub(fs_1.default.promises, 'readFile', stub => stub.callsFake((...args) => {
+        if (args[0] === '/tmp/body.json')
+            return Promise.resolve('{"Name":"From File"}');
+        return originalReadFile(...args);
+    }))
+        .stdout()
+        .command(['graph', 'createItem', '--path=/sobjects/Task/records', '--body-file=/tmp/body.json'])
+        .it('--body-file reads and parses file as request body', () => {
+        const fetchStub = global.fetch;
+        const [, options] = fetchStub.firstCall.args;
+        (0, test_1.expect)(options.method).to.equal('POST');
+        (0, test_1.expect)(JSON.parse(options.body)).to.deep.equal({ Name: 'From File' });
+    });
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .stub(fs_1.default.promises, 'readFile', stub => stub.callsFake((...args) => {
+        if (args[0] === '/tmp/bad.json')
+            return Promise.resolve('not valid json');
+        return originalReadFile(...args);
+    }))
+        .command(['graph', 'createItem', '--path=/sobjects/Task/records', '--body-file=/tmp/bad.json'])
+        .catch(err => {
+        (0, test_1.expect)(err.message).to.contain('Invalid JSON in --body-file');
+    })
+        .it('--body-file with invalid JSON errors');
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .stub(fs_1.default.promises, 'readFile', stub => stub.callsFake((...args) => {
+        if (args[0] === '/tmp/missing.json')
+            return Promise.reject(new Error('ENOENT: no such file'));
+        return originalReadFile(...args);
+    }))
+        .command(['graph', 'createItem', '--path=/sobjects/Task/records', '--body-file=/tmp/missing.json'])
+        .catch(err => {
+        (0, test_1.expect)(err.message).to.contain('Could not read --body-file');
+    })
+        .it('--body-file with non-existent file errors');
+    // --- updateItem ---
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .stub(global, 'fetch', stub => stub.resolves({
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve({ path: '/sobjects/Task/records/abc123' }),
+    }))
+        .stdout()
+        .command(['graph', 'updateItem', '--path=/sobjects/Task/records/abc123', '--body={"Name":"Updated"}'])
+        .it('updateItem sends PATCH with parsed JSON body', () => {
+        const fetchStub = global.fetch;
+        const [url, options] = fetchStub.firstCall.args;
+        (0, test_1.expect)(url).to.equal('http://localhost:9200/sobjects/Task/records/abc123');
+        (0, test_1.expect)(options.method).to.equal('PATCH');
+        (0, test_1.expect)(JSON.parse(options.body)).to.deep.equal({ Name: 'Updated' });
+    });
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .command(['graph', 'updateItem', '--path=/sobjects/Task/records/abc123'])
+        .catch(err => {
+        (0, test_1.expect)(err.message).to.contain('--body or --body-file is required');
+    })
+        .it('updateItem without --body or --body-file errors');
+    // --- deleteItem ---
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .stub(global, 'fetch', stub => stub.resolves({
+        ok: true,
+        status: 204,
+        json: () => Promise.reject(new Error('No body')),
+    }))
+        .stdout()
+        .command(['graph', 'deleteItem', '--path=/sobjects/Task/records/abc123', '--yes'])
+        .it('deleteItem sends DELETE with no body and handles 204', ctx => {
+        const fetchStub = global.fetch;
+        const [url, options] = fetchStub.firstCall.args;
+        (0, test_1.expect)(url).to.equal('http://localhost:9200/sobjects/Task/records/abc123');
+        (0, test_1.expect)(options.method).to.equal('DELETE');
+        (0, test_1.expect)(options.body).to.be.undefined;
+        (0, test_1.expect)(ctx.stdout).to.equal('');
+    });
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .command(['graph', 'deleteItem', '--path=/sobjects/Task/records/abc123', '--body={"x":1}'])
+        .catch(err => {
+        (0, test_1.expect)(err.message).to.contain('--body and --body-file are not supported for deleteItem');
+    })
+        .it('deleteItem rejects --body flag');
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .command(['graph', 'deleteItem', '--path=/sobjects/Task/records/abc123', '--body-file=/tmp/body.json'])
+        .catch(err => {
+        (0, test_1.expect)(err.message).to.contain('--body and --body-file are not supported for deleteItem');
+    })
+        .it('deleteItem rejects --body-file flag');
+    // --- deleteItem confirmation prompt ---
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .stub(global, 'fetch', stub => stub.resolves({
+        ok: true,
+        status: 204,
+        json: () => Promise.reject(new Error('No body')),
+    }))
+        .stub(inquirer_1.default, 'prompt', stub => stub.resolves({ proceed: true }))
+        .stdout()
+        .command(['graph', 'deleteItem', '--path=/sobjects/Task/records/abc123'])
+        .it('deleteItem prompts for confirmation and proceeds when accepted', () => {
+        const promptStub = inquirer_1.default.prompt;
+        (0, test_1.expect)(promptStub.calledOnce).to.be.true;
+        const [question] = promptStub.firstCall.args;
+        (0, test_1.expect)(question.message).to.contain('About to DELETE /sobjects/Task/records/abc123');
+        const fetchStub = global.fetch;
+        (0, test_1.expect)(fetchStub.calledOnce).to.be.true;
+    });
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .stub(global, 'fetch', stub => stub.resolves({
+        ok: true,
+        status: 204,
+        json: () => Promise.reject(new Error('No body')),
+    }))
+        .stub(inquirer_1.default, 'prompt', stub => stub.resolves({ proceed: false }))
+        .stdout()
+        .command(['graph', 'deleteItem', '--path=/sobjects/Task/records/abc123'])
+        .it('deleteItem aborts when confirmation is declined', ctx => {
+        (0, test_1.expect)(ctx.stdout).to.contain('Aborted.');
+        const fetchStub = global.fetch;
+        (0, test_1.expect)(fetchStub.called).to.be.false;
+    });
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .stub(global, 'fetch', stub => stub.resolves({
+        ok: true,
+        status: 204,
+        json: () => Promise.reject(new Error('No body')),
+    }))
+        .stdout()
+        .command(['graph', 'deleteItem', '--path=/sobjects/Task/records/abc123', '--yes'])
+        .it('deleteItem --yes bypasses confirmation prompt', () => {
+        const fetchStub = global.fetch;
+        (0, test_1.expect)(fetchStub.calledOnce).to.be.true;
+    });
+    // --- GET ignores body ---
+    test_1.test
+        .stub(Configuration, 'getConfiguration', stub => stub.resolves(MOCK_CONFIG))
+        .stub(global, 'fetch', stub => stub.resolves({
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve(MOCK_RESPONSE),
+    }))
+        .stdout()
+        .command(['graph', 'get', '--path=/sobjects/Opportunity', '--body={"ignored":true}'])
+        .it('GET operations ignore --body flag', () => {
+        const fetchStub = global.fetch;
+        const [, options] = fetchStub.firstCall.args;
+        (0, test_1.expect)(options.method).to.equal('GET');
+        (0, test_1.expect)(options.body).to.be.undefined;
+    });
+    // --- invalid operation ---
     test_1.test
         .stderr()
         .command(['graph', 'put', '--path=/sobjects/Opportunity'])

package/oclif.manifest.json

@@ -274,7 +274,10 @@
       "description": "Query a running integration graph and print the response",
       "examples": [
         "<%= config.bin %> <%= command.id %> --path=/sobjects/Opportunity/records/abc123",
-        "<%= config.bin %> <%= command.id %> get --path=/sobjects/Opportunity --port=9201"
+        "<%= config.bin %> <%= command.id %> get --path=/sobjects/Opportunity --port=9201",
+        "<%= config.bin %> <%= command.id %> createItem --path=/sobjects/Task/records --body='{\"Name\":\"New Task\"}'",
+        "<%= config.bin %> <%= command.id %> updateItem --path=/sobjects/Task/records/abc123 --body='{\"Name\":\"Updated\"}'",
+        "<%= config.bin %> <%= command.id %> deleteItem --path=/sobjects/Task/records/abc123"
       ],
       "flags": {
         "json": {
@@ -360,6 +363,34 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "body": {
+          "char": "b",
+          "description": "JSON request body for createItem/updateItem operations",
+          "exclusive": [
+            "body-file"
+          ],
+          "name": "body",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "body-file": {
+          "description": "Path to a JSON file to use as request body",
+          "exclusive": [
+            "body"
+          ],
+          "name": "body-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompt for destructive operations (deleteItem)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -737,6 +768,14 @@
           "name": "strict",
           "allowNo": false,
           "type": "boolean"
+        },
+        "port": {
+          "description": "port to start the integration on (default: 9200)",
+          "name": "port",
+          "default": 9200,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -961,5 +1000,5 @@
       ]
     }
   },
-  "version": "0.65.0"
+  "version": "0.67.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unito/integration-cli",
-  "version": "0.65.0",
+  "version": "0.67.0",
   "description": "Integration CLI",
   "bin": {
     "integration-cli": "./bin/run"
@@ -39,7 +39,7 @@
     "@ngrok/ngrok": "^1.4.1",
     "@oazapfts/runtime": "1.x",
     "@oclif/core": "3.x",
-    "@unito/integration-debugger": "0.28.10",
+    "@unito/integration-debugger": "0.29.0",
     "ajv": "8.x",
     "ajv-formats": "3.x",
     "better-ajv-errors": "1.x",