sf-raven 1.0.7 → 1.2.0

package/README.md

@@ -43,6 +43,23 @@ Full details, usage, examples etc are further down, or can be accessed via `--he
 - [sf raven event subscribe](#sf-raven-event-subscribe)
   - Subscribe to Platform Events.
 
+#### sf raven deploy
+
+- [sf raven deploy cancel](#sf-raven-deploy-cancel)
+  - Cancel a pending or in-progress Salesforce deploy.
+
+#### sf raven query
+
+- [sf raven query ids](#sf-raven-query-ids)
+  - Run a SOQL query against a large list of Salesforce IDs.
+
+#### sf raven pull
+
+- [sf raven pull](#sf-raven-pull)
+  - Pull local Salesforce metadata paths into the project.
+- [sf raven pull remote](#sf-raven-pull-remote)
+  - Pull Salesforce metadata that exists in the org but not locally.
+
 <!-- #### sfdx:raven:utils
 * [sfdx raven:utils:deploy:branch2org](#sfdx-ravenutilsdeploybranch2org)
   * Deploy a git branch to an org
@@ -55,7 +72,7 @@ Full details, usage, examples etc are further down, or can be accessed via `--he
 
 ### Quick Install
 
-Assuming you already have the [SDFX CLI](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_install_cli.htm) installed, just run:
+Assuming you already have the [sf cli](https://developer.salesforce.com/tools/salesforcecli) installed, the plugin can be installed by running:
 
 `sf plugins install sf-raven`
 
@@ -169,6 +186,112 @@ Person Account      PersonAccount           0124J000000YYYYDEF
 ...
 ```
 
+## sf raven pull
+
+Pull Salesforce metadata into the local project.
+
+```
+USAGE
+  $ sf raven pull [--json] [-o <value>] [-a]
+
+FLAGS
+  -a, --all                 Retrieve all local package directories instead of selecting a path with fzf.
+  -o, --target-org=<value>  Login username or alias for the target org. Uses the default org when omitted.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Refresh local Salesforce metadata from an authenticated org. Without --all, local metadata paths are loaded into fzf so you can choose one or more files or directories to retrieve. Press Tab to select multiple paths, then Enter to retrieve them together. With --all, each package directory from sfdx-project.json is retrieved.
+
+EXAMPLES
+  $ sf raven pull
+
+  $ sf raven pull --target-org dev
+
+  $ sf raven pull --all
+
+  $ sf raven pull --target-org dev --all
+```
+
+## sf raven pull remote
+
+Pull Salesforce metadata that exists in the org but not locally.
+
+```
+USAGE
+  $ sf raven pull remote [--json] [-o <value>]
+
+FLAGS
+  -o, --target-org=<value>  Login username or alias for the target org. Uses the default org when omitted.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List supported metadata components that exist in the target org but are not present in the local project. Org-only components are prefixed with a cloud marker in fzf. Press Tab to select multiple components, then Enter to retrieve them.
+
+EXAMPLES
+  $ sf raven pull remote
+
+  $ sf raven pull remote --target-org dev
+```
+
+## sf raven deploy cancel
+
+Cancel a pending or in-progress Salesforce deploy.
+
+```
+USAGE
+  $ sf raven deploy cancel [--json] [-o <value>]
+
+FLAGS
+  -o, --target-org=<value>  Login username or alias for the target org. Uses the default org when omitted.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Query the target org for pending or in-progress deploy requests, select one from an interactive list, confirm the cancellation, and submit an asynchronous deploy cancel request.
+
+EXAMPLES
+  $ sf raven deploy cancel
+
+  $ sf raven deploy cancel --target-org dev
+```
+
+## sf raven query ids
+
+Run a SOQL query against a large list of Salesforce IDs.
+
+```
+USAGE
+  $ sf raven query ids -f <value> -q <value> [--json] [-o <value>] [-b <value>] [-c <value>] [-l <value>]
+
+FLAGS
+  -b, --batch-size=<value>  Number of IDs to include in each query batch. By default, batches are sized to fit Salesforce URI limits.
+  -c, --csv=<value>         Path to write query results as CSV. When supplied, table output is suppressed.
+  -f, --file=<value>        (required) Path to a file containing one Salesforce ID per row.
+  -l, --limit=<value>       Process only the first N unique valid IDs from the file.
+  -o, --target-org=<value>  Login username or alias for the target org. Uses the default org when omitted.
+  -q, --query=<value>       (required) SOQL query to run. Must include the {ids} placeholder where the ID list should be inserted.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Read Salesforce IDs from a file, deduplicate and validate them, split them into safe query batches, and run a SOQL query with the IDs inserted at the {ids} placeholder.
+
+EXAMPLES
+  $ sf raven query ids --file account-ids.txt --query "SELECT Id, Name FROM Account WHERE Id IN {ids}"
+
+  $ sf raven query ids --file account-ids.txt --query "SELECT Id, Name FROM Opportunity WHERE AccountId IN {ids}"
+
+  $ sf raven query ids --file account-ids.txt --query "SELECT Id, Name FROM Account WHERE Id IN {ids}" --limit 25
+
+  $ sf raven query ids --file account-ids.txt --query "SELECT Id, Name FROM Account WHERE Id IN {ids}" --csv results.csv
+```
+
 ## sf raven audit display
 
 Show recent entries in the Setup Audit Trail.

package/bin/dev.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env -S node --loader ts-node/esm --no-warnings=ExperimentalWarning
+// eslint-disable-next-line node/shebang
+async function main() {
+  const { execute } = await import('@oclif/core');
+  await execute({ development: true, dir: import.meta.url });
+}
+
+await main();

package/lib/commands/raven/audit/display.d.ts

@@ -7,9 +7,9 @@ export default class AuditDisplay extends SfCommand<AuditDisplayResult> {
     static readonly description: string;
     static readonly examples: string[];
     static readonly flags: {
-        'target-org': import("@oclif/core/lib/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        username: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        username: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<AuditDisplayResult>;
 }

package/lib/commands/raven/audit/display.js

@@ -1,78 +1,87 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
-const core_1 = require("@salesforce/core");
-const dayjs = require("dayjs");
-core_1.Messages.importMessagesDirectory(__dirname);
-const messages = core_1.Messages.loadMessages('sf-raven', 'raven.audit.display');
-class AuditDisplay extends sf_plugins_core_1.SfCommand {
-    async run() {
-        this.spinner.start('Loading...');
-        const { flags } = await this.parse(AuditDisplay);
-        const ux = new sf_plugins_core_1.Ux({ jsonEnabled: this.jsonEnabled() });
-        const org = flags['target-org'];
-        const conn = org.getConnection();
-        let query = '';
-        if (flags.username) {
-            query = `SELECT CreatedDate, CreatedBy.Username, 
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { SfCommand, Flags, Ux } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import dayjs from 'dayjs';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('sf-raven', 'raven.audit.display');
+class AuditDisplay extends SfCommand {
+    run() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.spinner.start('Loading...');
+            const { flags } = yield this.parse(AuditDisplay);
+            const ux = new Ux({ jsonEnabled: this.jsonEnabled() });
+            const org = flags['target-org'];
+            const conn = org.getConnection();
+            let query = '';
+            if (flags.username) {
+                query = `SELECT CreatedDate, CreatedBy.Username, 
                       Section, Display, DelegateUser 
                 FROM SetupAuditTrail 
                 WHERE CreatedBy.Username = '${flags.username}'
                 ORDER BY CreatedDate DESC 
                 LIMIT ${flags.limit}`;
-        }
-        else {
-            query = `SELECT CreatedDate, CreatedBy.Username, 
+            }
+            else {
+                query = `SELECT CreatedDate, CreatedBy.Username, 
                       Section, Display, DelegateUser 
                 FROM SetupAuditTrail 
                 ORDER BY CreatedDate DESC 
                 LIMIT ${flags.limit}`;
-        }
-        const result = (await conn.query(query));
-        result.records.forEach((record) => {
-            record.CreatedDate = dayjs(record.CreatedDate).format('YYYY-MM-DD HH:mm:ss');
-        });
-        this.spinner.stop();
-        // Return table of fields
-        ux.table(result.records, {
-            createdDate: {
-                header: 'Date',
-                get: (row) => row.CreatedDate,
-            },
-            createdBy: {
-                header: 'Username',
-                get: (row) => row.CreatedBy?.Username,
-            },
-            section: {
-                header: 'Type',
-                get: (row) => row.Section,
-            },
-            display: {
-                header: 'Action',
-                get: (row) => row.Display,
-            },
-            delegateUser: {
-                header: 'Delegate User',
-                get: (row) => row.DelegateUser,
-            },
+            }
+            const result = (yield conn.query(query));
+            result.records.forEach((record) => {
+                record.CreatedDate = dayjs(record.CreatedDate).format('YYYY-MM-DD HH:mm:ss');
+            });
+            this.spinner.stop();
+            // Return table of fields
+            ux.table(result.records, {
+                createdDate: {
+                    header: 'Date',
+                    get: (row) => row.CreatedDate,
+                },
+                createdBy: {
+                    header: 'Username',
+                    get: (row) => { var _a; return (_a = row.CreatedBy) === null || _a === void 0 ? void 0 : _a.Username; },
+                },
+                section: {
+                    header: 'Type',
+                    get: (row) => row.Section,
+                },
+                display: {
+                    header: 'Action',
+                    get: (row) => row.Display,
+                },
+                delegateUser: {
+                    header: 'Delegate User',
+                    get: (row) => row.DelegateUser,
+                },
+            });
+            return result;
         });
-        return result;
     }
 }
 AuditDisplay.summary = messages.getMessage('summary');
 AuditDisplay.description = messages.getMessage('description');
 AuditDisplay.examples = messages.getMessages('examples');
 AuditDisplay.flags = {
-    'target-org': sf_plugins_core_1.Flags.requiredOrg({
+    'target-org': Flags.requiredOrg({
         summary: messages.getMessage('flags.target-org.summary'),
         char: 'o',
         required: true,
     }),
-    username: sf_plugins_core_1.Flags.string({
+    username: Flags.string({
         summary: messages.getMessage('flags.username.summary'),
         char: 'u',
     }),
-    limit: sf_plugins_core_1.Flags.integer({
+    limit: Flags.integer({
         summary: messages.getMessage('flags.limit.summary'),
         char: 'l',
         min: 1,
@@ -80,5 +89,5 @@ AuditDisplay.flags = {
         default: 20,
     }),
 };
-exports.default = AuditDisplay;
+export default AuditDisplay;
 //# sourceMappingURL=display.js.map

package/lib/commands/raven/audit/display.js.map

@@ -1 +1 @@
-{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../../src/commands/raven/audit/display.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../../src/commands/raven/audit/display.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAM1E,MAAqB,YAAa,SAAQ,SAA6B;IAwBxD,GAAG;;YACd,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAoBjC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACjD,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAEvD,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC;YACjC,IAAI,KAAK,GAAG,EAAE,CAAC;YAEf,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,KAAK,GAAG;;;8CAGgC,KAAK,CAAC,QAAQ;;wBAEpC,KAAK,CAAC,KAAK,EAAE,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG;;;;wBAIU,KAAK,CAAC,KAAK,EAAE,CAAC;YAClC,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAgB,CAAC;YAExD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBAChC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAEpB,yBAAyB;YACzB,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE;gBACvB,WAAW,EAAE;oBACX,MAAM,EAAE,MAAM;oBACd,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW;iBACtC;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,UAAU;oBAClB,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,WAAC,OAAA,MAAA,GAAG,CAAC,SAAS,0CAAE,QAAQ,CAAA,EAAA;iBAC9C;gBACD,OAAO,EAAE;oBACP,MAAM,EAAE,MAAM;oBACd,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO;iBAClC;gBACD,OAAO,EAAE;oBACP,MAAM,EAAE,QAAQ;oBAChB,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO;iBAClC;gBACD,YAAY,EAAE;oBACZ,MAAM,EAAE,eAAe;oBACvB,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY;iBACvC;aACF,CAAC,CAAC;YAEH,OAAO,MAAuC,CAAC;QACjD,CAAC;KAAA;;AAnGsB,oBAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,wBAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,qBAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAE5C,kBAAK,GAAG;IAC7B,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC;QAC9B,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC;QACxD,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,IAAI;KACf,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAAC;QACtD,IAAI,EAAE,GAAG;KACV,CAAC;IACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;QACnB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,qBAAqB,CAAC;QACnD,IAAI,EAAE,GAAG;QACT,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,IAAI;QACT,OAAO,EAAE,EAAE;KACZ,CAAC;CACH,CAAC;eAtBiB,YAAY"}

package/lib/commands/raven/deploy/cancel.d.ts

@@ -0,0 +1,15 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type DeployCancelResult = {
+    cancelled: boolean;
+    jobId?: string;
+    targetOrg?: string;
+};
+export default class DeployCancel extends SfCommand<DeployCancelResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<DeployCancelResult>;
+}

package/lib/commands/raven/deploy/cancel.js

@@ -0,0 +1,185 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { spawn } from 'node:child_process';
+import select, { Separator } from '@inquirer/select';
+import { Messages } from '@salesforce/core';
+import { Flags, SfCommand, Ux } from '@salesforce/sf-plugins-core';
+import dayjs from 'dayjs';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('sf-raven', 'raven.deploy.cancel');
+const cancelSelection = 'cancel';
+class DeployCancel extends SfCommand {
+    run() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { flags } = yield this.parse(DeployCancel);
+            const ux = new Ux({ jsonEnabled: this.jsonEnabled() });
+            const org = flags['target-org'];
+            if (org == null) {
+                throw messages.createError('error.noTargetOrg');
+            }
+            const targetOrg = org.getUsername();
+            if (targetOrg == null) {
+                throw messages.createError('error.noTargetOrg');
+            }
+            ux.spinner.start(messages.getMessage('info.loadingDeploys'));
+            let deployRequests;
+            try {
+                deployRequests = yield getActiveDeployRequests(org.getConnection());
+            }
+            finally {
+                ux.spinner.stop();
+            }
+            if (deployRequests.length === 0) {
+                ux.log(messages.getMessage('info.noDeploys'));
+                return {
+                    cancelled: false,
+                    targetOrg,
+                };
+            }
+            const selectedDeployRequest = yield selectDeployRequest(deployRequests);
+            if (selectedDeployRequest === cancelSelection || selectedDeployRequest == null) {
+                ux.log(messages.getMessage('info.noSelection'));
+                return {
+                    cancelled: false,
+                    targetOrg,
+                };
+            }
+            const confirmed = yield this.confirm({
+                message: messages.getMessage('prompt.confirmCancel', [selectedDeployRequest.Id]),
+                defaultAnswer: false,
+            });
+            if (!confirmed) {
+                ux.log(messages.getMessage('info.cancelAborted'));
+                return {
+                    cancelled: false,
+                    jobId: selectedDeployRequest.Id,
+                    targetOrg,
+                };
+            }
+            const exitCode = yield cancelDeploy(selectedDeployRequest.Id, targetOrg);
+            if (exitCode !== 0) {
+                throw messages.createError('error.cancelFailed', [exitCode.toString()]);
+            }
+            ux.log(messages.getMessage('info.cancelSubmitted', [selectedDeployRequest.Id]));
+            return {
+                cancelled: true,
+                jobId: selectedDeployRequest.Id,
+                targetOrg,
+            };
+        });
+    }
+}
+DeployCancel.summary = messages.getMessage('summary');
+DeployCancel.description = messages.getMessage('description');
+DeployCancel.examples = messages.getMessages('examples');
+DeployCancel.flags = {
+    'target-org': Flags.optionalOrg({
+        summary: messages.getMessage('flags.target-org.summary'),
+        char: 'o',
+    }),
+};
+export default DeployCancel;
+const getActiveDeployRequests = (connection) => __awaiter(void 0, void 0, void 0, function* () {
+    const result = yield connection.tooling.query(`
+    SELECT Id, Status, StartDate,
+           NumberComponentsDeployed, NumberComponentsTotal, NumberComponentErrors,
+           NumberTestsCompleted, NumberTestsTotal, NumberTestErrors
+    FROM DeployRequest
+    WHERE Status IN ('InProgress', 'Pending')
+    ORDER BY StartDate DESC
+  `);
+    return result.records;
+});
+const formatDeployRequest = (deployRequest) => {
+    if (deployRequest.Status === 'Pending') {
+        return [deployRequest.Status, deployRequest.Id].join(' | ');
+    }
+    const startDate = deployRequest.StartDate == null ? messages.getMessage('label.unknownStartDate') : dayjs(deployRequest.StartDate).format('DD/MM/YYYY HH:mm');
+    return [
+        startDate,
+        deployRequest.Status,
+        deployRequest.Id,
+        `Metadata: ${formatProgress(deployRequest.NumberComponentsDeployed, deployRequest.NumberComponentsTotal, deployRequest.NumberComponentErrors)}`,
+        `Apex Tests: ${formatProgress(deployRequest.NumberTestsCompleted, deployRequest.NumberTestsTotal, deployRequest.NumberTestErrors)}`,
+    ].join(' | ');
+};
+const selectDeployRequest = (deployRequests) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        return yield select({
+            message: messages.getMessage('prompt.selectDeploy'),
+            choices: getDeployChoices(deployRequests),
+            pageSize: 10,
+        });
+    }
+    catch (error) {
+        if (isPromptForceCloseError(error)) {
+            return undefined;
+        }
+        throw error;
+    }
+});
+const getDeployChoices = (deployRequests) => {
+    const inProgressDeployRequests = deployRequests.filter((deployRequest) => deployRequest.Status === 'InProgress');
+    const pendingDeployRequests = deployRequests.filter((deployRequest) => deployRequest.Status === 'Pending');
+    return [
+        { name: messages.getMessage('label.cancel'), value: cancelSelection },
+        new Separator(),
+        ...getGroupedDeployChoices(messages.getMessage('label.inProgress'), inProgressDeployRequests),
+        ...getGroupedDeployChoices(messages.getMessage('label.pending'), pendingDeployRequests),
+    ];
+};
+const getGroupedDeployChoices = (label, deployRequests) => deployRequests.length === 0
+    ? []
+    : [
+        new Separator(label),
+        ...deployRequests.map((deployRequest) => ({
+            name: formatDeployRequest(deployRequest),
+            value: deployRequest,
+        })),
+    ];
+const isPromptForceCloseError = (error) => error instanceof Error && error.message.includes('User force closed the prompt');
+const formatProgress = (completed, total, errors) => {
+    const completedValue = completed !== null && completed !== void 0 ? completed : 0;
+    const totalValue = total !== null && total !== void 0 ? total : 0;
+    const errorValue = errors !== null && errors !== void 0 ? errors : 0;
+    const percentage = totalValue > 0 ? Math.floor((completedValue / totalValue) * 100) : 0;
+    return `${completedValue}/${totalValue} (${percentage}% - ${errorValue} errors)`;
+};
+const cancelDeploy = (jobId, targetOrg) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const result = yield runChildProcess((_a = process.env.SF_BINPATH) !== null && _a !== void 0 ? _a : 'sf', [
+        'project',
+        'deploy',
+        'cancel',
+        '--job-id',
+        jobId,
+        '--target-org',
+        targetOrg,
+        '--async',
+    ]);
+    return result.exitCode;
+});
+const runChildProcess = (command, args) => __awaiter(void 0, void 0, void 0, function* () {
+    return new Promise((resolve, reject) => {
+        const childProcess = spawn(command, args, {
+            stdio: 'inherit',
+            env: process.env,
+        });
+        childProcess.on('error', (error) => {
+            reject(error);
+        });
+        childProcess.on('close', (code) => {
+            resolve({
+                exitCode: code !== null && code !== void 0 ? code : 0,
+            });
+        });
+    });
+});
+//# sourceMappingURL=cancel.js.map

package/lib/commands/raven/deploy/cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.js","sourceRoot":"","sources":["../../../../src/commands/raven/deploy/cancel.ts"],"names":[],"mappings":"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"}

package/lib/commands/raven/event/subscribe.d.ts

@@ -7,10 +7,10 @@ export default class EventSubscribe extends SfCommand<EventSubscribeResult> {
     static readonly description: string;
     static readonly examples: string[];
     static readonly flags: {
-        'target-org': import("@oclif/core/lib/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        event: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        replayid: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        event: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        replayid: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<EventSubscribeResult>;
 }