@salesforce/plugin-packaging 2.14.0 → 2.15.1

package/README.md

@@ -37,6 +37,10 @@ See [DEVELOPING.md](DEVELOPING.md)
 - [`sf package install report`](#sf-package-install-report)
 - [`sf package installed list`](#sf-package-installed-list)
 - [`sf package list`](#sf-package-list)
+- [`sf package push-upgrade abort`](#sf-package-push-upgrade-abort)
+- [`sf package push-upgrade list`](#sf-package-push-upgrade-list)
+- [`sf package push-upgrade report`](#sf-package-push-upgrade-report)
+- [`sf package push-upgrade schedule`](#sf-package-push-upgrade-schedule)
 - [`sf package uninstall`](#sf-package-uninstall)
 - [`sf package uninstall report`](#sf-package-uninstall-report)
 - [`sf package update`](#sf-package-update)
@@ -139,7 +143,7 @@ FLAG DESCRIPTIONS
     --installation-key-bypass flag is required.
 ```
 
-_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/convert.ts)_
+_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/convert.ts)_
 
 ## `sf package create`
 
@@ -218,7 +222,7 @@ FLAG DESCRIPTIONS
     Org-Dependent Unlocked Packages" in the Salesforce DX Developer Guide.
 ```
 
-_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/create.ts)_
+_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/create.ts)_
 
 ## `sf package delete`
 
@@ -260,7 +264,7 @@ EXAMPLES
     $ sf package delete --package 0Ho... --target-dev-hub devhub@example.com
 ```
 
-_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/delete.ts)_
+_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/delete.ts)_
 
 ## `sf package install`
 
@@ -359,7 +363,7 @@ FLAG DESCRIPTIONS
     - Delete: Delete all removed components that can be safely deleted, and deprecate the other components.
 ```
 
-_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/install.ts)_
+_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/install.ts)_
 
 ## `sf package install report`
 
@@ -392,7 +396,7 @@ EXAMPLES
     $ sf package install report --request-id 0Hf... --target-org me@example.com
 ```
 
-_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/install/report.ts)_
+_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/install/report.ts)_
 
 ## `sf package installed list`
 
@@ -424,7 +428,7 @@ EXAMPLES
     $ sf package installed list --target-org me@example.com
 ```
 
-_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/installed/list.ts)_
+_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/installed/list.ts)_
 
 ## `sf package list`
 
@@ -462,7 +466,230 @@ EXAMPLES
     $ sf package list --target-dev-hub devhub@example.com --verbose
 ```
 
-_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/list.ts)_
+_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/list.ts)_
+
+## `sf package push-upgrade abort`
+
+Abort a package push upgrade that has been scheduled. Only push upgrade requests with a status of Created or Pending can be aborted.
+
+```
+USAGE
+  $ sf package push-upgrade abort -v <value> -i <value> [--json] [--flags-dir <value>] [--api-version <value>]
+
+FLAGS
+  -i, --push-request-id=<value>  (required) ID of the package push request (starts with 0DV). This ID is returned after
+                                 the package push-upgrade schedule command completes successfully.
+  -v, --target-dev-hub=<value>   (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub`
+                                 configuration variable is already set.
+      --api-version=<value>      Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Abort a package push upgrade that has been scheduled. Only push upgrade requests with a status of Created or Pending
+  can be aborted.
+
+  Specify the request ID for which you want abort the request. If applicable, the command displays errors related to the
+  request.
+
+  To show all requests in the org, run "sf package pushupgrade list --package 033...".
+
+EXAMPLES
+  Cancel the specified package push upgrade request with the specified ID; uses your default Dev Hub org:
+
+    $ sf package push-upgrade abort --push-request-id 0DV...
+
+  Cancel the specified package push upgrade request in the Dev Hub org with username devhub@example.com:
+
+    $ sf package push-upgrade abort --push-request-id 0DV... --target-dev-hub devhub@example.com
+```
+
+_See code: [src/commands/package/push-upgrade/abort.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/push-upgrade/abort.ts)_
+
+## `sf package push-upgrade list`
+
+Lists the status of push upgrade requests for a given package.
+
+```
+USAGE
+  $ sf package push-upgrade list -v <value> -p <value> [--json] [--flags-dir <value>] [--api-version <value>] [-l <value>] [-s
+    Created|Cancelled|Pending|In Progress|Failed|Succeeded] [--show-push-migrations-only]
+
+FLAGS
+  -l, --scheduled-last-days=<value>  Number of days in the past for which to display the list of push upgrade requests
+                                     that were scheduled. Used to filter the list output to only recently scheduled push
+                                     upgrades.
+  -p, --package=<value>              (required) Package ID (starts with 033) of the package that you want push upgrade
+                                     information for.
+  -s, --status=<option>              Status used to filter the list output Valid values are: Created, Canceled, Pending,
+                                     In Progress, Failed, or Succeeded
+                                     <options: Created|Cancelled|Pending|In Progress|Failed|Succeeded>
+  -v, --target-dev-hub=<value>       (required) Username or alias of the Dev Hub org. Not required if the
+                                     `target-dev-hub` configuration variable is already set.
+      --api-version=<value>          Override the api version used for api requests made by this command
+      --show-push-migrations-only    Display only push upgrade requests for package migrations.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Lists the status of push upgrade requests for a given package.
+
+  Shows the details of each request to create a push upgrade in the Dev Hub org.
+
+  All filter parameters are applied using the AND logical operator (not OR).
+
+  To get information about a specific request, run "sf package pushupgrade report" and supply the request ID.
+
+ALIASES
+  $ sf force package push-upgrade list
+
+EXAMPLES
+  List all package push upgrade requests in the specified Dev Hub org:
+
+    $ sf package push-upgrade list --package 033xyz --target-dev-hub myHub
+
+  List all package push upgrade requests in the specified Dev Hub org scheduled in the last 30 days:
+
+    $ sf package push-upgrade list --package 033xyz --scheduled-last-days 30 --target-dev-hub myHub
+
+  List all package push upgrade with a status Succeeded:
+
+    $ sf package push-upgrade list --package 033xyz –-status Succeeded
+
+  List all package push upgrade with a status Failed:
+
+    $ sf package push-upgrade list --package 033xyz –-status Failed
+```
+
+_See code: [src/commands/package/push-upgrade/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/push-upgrade/list.ts)_
+
+## `sf package push-upgrade report`
+
+Retrieve the status of a package push upgrade.
+
+```
+USAGE
+  $ sf package push-upgrade report -v <value> -i <value> [--json] [--flags-dir <value>] [--api-version <value>]
+
+FLAGS
+  -i, --push-request-id=<value>  (required) ID of the package push request (starts with 0DV). This ID is returned after
+                                 the package push-upgrade schedule command completes successfully.
+  -v, --target-dev-hub=<value>   (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub`
+                                 configuration variable is already set.
+      --api-version=<value>      Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Retrieve the status of a package push upgrade.
+
+  Specify the request ID for which you want to view details. If applicable, the command displays errors related to the
+  request.
+
+  To show all requests in the org, run "sf package pushupgrade list".
+
+ALIASES
+  $ sf force package push-upgrade report
+
+EXAMPLES
+  Retrieve details about the package push upgrade with the specified ID; uses your default Dev Hub org:
+
+    $ sf package push-upgrade report --push-request-id 0DV...
+
+  Retrieve details about the specified package push request in the Dev Hub org with username devhub@example.com:
+
+    $ sf package push-upgrade report --push-request-id 0DV... --target-dev-hub devhub@example.com
+```
+
+_See code: [src/commands/package/push-upgrade/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/push-upgrade/report.ts)_
+
+## `sf package push-upgrade schedule`
+
+Schedule a package push upgrade.
+
+```
+USAGE
+  $ sf package push-upgrade schedule -v <value> -p <value> [--json] [--flags-dir <value>] [--api-version <value>] [-t <value>] [-l
+    <value> | -f <value>] [--migrate-to-2gp]
+
+FLAGS
+  -f, --org-file=<value>        Filename of the CSV file that contains the list of orgs that need the package upgrade.
+  -l, --org-list=<value>        Comma-separated list of subscriber org IDs that need the package upgrade.
+  -p, --package=<value>         (required) ID (starts with 04t) of the package version that the package is being
+                                upgraded to. The package version must be an active, non-beta package version.
+  -t, --start-time=<value>      Date and time (UTC) when the push upgrade is processed. Set to the earliest time that
+                                you want Salesforce to attempt to start the upgrade.
+  -v, --target-dev-hub=<value>  (required) Username or alias of the Dev Hub org.
+      --api-version=<value>     Override the api version used for api requests made by this command
+      --migrate-to-2gp          Upgrade from a first-generation managed package (1GP) to a second-generation managed
+                                package (2GP). Required when you’re pushing a 2GP package to orgs with the 1GP version
+                                installed.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Schedule a package push upgrade.
+
+  Represents a push upgrade request for upgrading a package in one or many orgs from one version to another version.
+  To initiate a push upgrade for an unlocked or second-generation managed package, the Create and Update
+  Second-Generation Packages user permission is required.
+  For second-generation managed packages, the push upgrade feature is available only for packages that have passed
+  AppExchange security review. To enable push upgrades for your managed package, log a support case in the Salesforce
+  Partner Community.
+  For unlocked packages, push upgrades are enabled by default.
+
+  Use the -–migrate-to-2GP flag to indicate you’re installing a converted second-generation managed package into an org
+  that has the first-generation managed package version of that package installed.
+
+EXAMPLES
+  Schedule a push upgrade that initiates at a specified time:
+
+    $ sf package push-upgrade schedule --package 04txyz --start-time "2024-12-06T21:00:00" --org-file \
+      upgrade-orgs.csv
+
+  Schedule a push upgrade that initiates as soon as possible:
+
+    $ sf package push-upgrade schedule --package 04txyz --org-file upgrade-orgs.csv
+
+  Schedule a push migration from a 1GP package to a 2GP package:
+
+    $ sf package push-upgrade schedule --migrate-to-2gp --package 04txyz --start-time "2024-12-06T21:00:00" \
+      --org-file upgrade-orgs.csv --target-dev-hub myHub
+
+FLAG DESCRIPTIONS
+  -f, --org-file=<value>  Filename of the CSV file that contains the list of orgs that need the package upgrade.
+
+    The file must contain one org per line. The org ID must be the only value in each row.
+    All listed orgs must have a package version installed in their org that is lower than the package version you
+    specified for the --package-version flag.
+
+  -t, --start-time=<value>
+
+    Date and time (UTC) when the push upgrade is processed. Set to the earliest time that you want Salesforce to attempt
+    to start the upgrade.
+
+    Scheduled push upgrades begin as soon as resources are available on the Salesforce instance, which is either at or
+    after the start time you specify. In certain scenarios, the push upgrade starts a few hours after the scheduled
+    start time.
+
+    As a best practice, schedule push upgrades at off-peak hours like 1:00 AM Saturday.
+    If you don't specify this flag, the push upgrade is scheduled to run as soon as resources are available on the
+    Salesforce instance.
+
+  -v, --target-dev-hub=<value>  Username or alias of the Dev Hub org.
+
+    Overrides the value of the target-dev-hub configuration variable, if set.
+```
+
+_See code: [src/commands/package/push-upgrade/schedule.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/push-upgrade/schedule.ts)_
 
 ## `sf package uninstall`
 
@@ -510,7 +737,7 @@ EXAMPLES
     $ sf package uninstall --package "Undesirable Package Alias"
 ```
 
-_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/uninstall.ts)_
+_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/uninstall.ts)_
 
 ## `sf package uninstall report`
 
@@ -543,7 +770,7 @@ EXAMPLES
     $ sf package uninstall report --request-id 06y... --target-org me@example.com
 ```
 
-_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/uninstall/report.ts)_
+_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/uninstall/report.ts)_
 
 ## `sf package update`
 
@@ -598,7 +825,7 @@ FLAG DESCRIPTIONS
     associated with your package.
 ```
 
-_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/update.ts)_
+_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/update.ts)_
 
 ## `sf package version create`
 
@@ -773,7 +1000,7 @@ FLAG DESCRIPTIONS
     periods of no output from commands.
 ```
 
-_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/version/create.ts)_
+_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/version/create.ts)_
 
 ## `sf package version create list`
 
@@ -834,7 +1061,7 @@ EXAMPLES
     $ sf package version create list --created-last-days 0 --status Success
 ```
 
-_See code: [src/commands/package/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/version/create/list.ts)_
+_See code: [src/commands/package/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/version/create/list.ts)_
 
 ## `sf package version create report`
 
@@ -877,7 +1104,7 @@ EXAMPLES
     $ sf package version create report --package-create-request-id 08c... --target-dev-hub devhub@example.com
 ```
 
-_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/version/create/report.ts)_
+_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/version/create/report.ts)_
 
 ## `sf package version delete`
 
@@ -918,7 +1145,7 @@ EXAMPLES
     $ sf package version delete --package 04t... --target-org devhub@example.com
 ```
 
-_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/version/delete.ts)_
+_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/version/delete.ts)_
 
 ## `sf package version displayancestry`
 
@@ -978,7 +1205,7 @@ FLAG DESCRIPTIONS
     You can use the DOT code output in graph visualization software to create tree visualizations.
 ```
 
-_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/version/displayancestry.ts)_
+_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/version/displayancestry.ts)_
 
 ## `sf package version list`
 
@@ -1054,7 +1281,7 @@ EXAMPLES
     $ sf package version list --packages exp-mgr,exp-mgr-util --released --modified-last-days 0
 ```
 
-_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/version/list.ts)_
+_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/version/list.ts)_
 
 ## `sf package version promote`
 
@@ -1098,7 +1325,7 @@ EXAMPLES
     $ sf package version promote --package "Awesome Package Alias"
 ```
 
-_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/version/promote.ts)_
+_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/version/promote.ts)_
 
 ## `sf package version report`
 
@@ -1138,7 +1365,7 @@ EXAMPLES
     $ sf package version report --package "Your Package Alias" --target-dev-hub devhub@example.com
 ```
 
-_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/version/report.ts)_
+_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/version/report.ts)_
 
 ## `sf package version update`
 
@@ -1191,7 +1418,7 @@ EXAMPLES
     $ sf package version update --package 04t... --version-description "New Package Version Description"
 ```
 
-_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package/version/update.ts)_
+_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package/version/update.ts)_
 
 ## `sf package1 version create`
 
@@ -1258,7 +1485,7 @@ FLAG DESCRIPTIONS
     subscribers.
 ```
 
-_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package1/version/create.ts)_
+_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package1/version/create.ts)_
 
 ## `sf package1 version create get`
 
@@ -1291,7 +1518,7 @@ EXAMPLES
     $ sf package1 version create get --request-id 0HD... --target-org myorg@example.com
 ```
 
-_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package1/version/create/get.ts)_
+_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package1/version/create/get.ts)_
 
 ## `sf package1 version display`
 
@@ -1325,7 +1552,7 @@ EXAMPLES
     $ sf package1 version display --package-version-id 04t... --target-org myorg@example.com
 ```
 
-_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package1/version/display.ts)_
+_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package1/version/display.ts)_
 
 ## `sf package1 version list`
 
@@ -1363,6 +1590,6 @@ FLAG DESCRIPTIONS
     If not specified, shows all versions for all packages (managed and unmanaged) in the org.
 ```
 
-_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.14.0/src/commands/package1/version/list.ts)_
+_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.1/src/commands/package1/version/list.ts)_
 
 <!-- commandsstop -->

package/lib/commands/package/push-upgrade/abort.d.ts

@@ -0,0 +1,15 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type PackagePushUpgradeAbortResult = {
+    success: boolean;
+};
+export declare class PackagePushUpgradeAbortCommand extends SfCommand<PackagePushUpgradeAbortResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-dev-hub': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'push-request-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<PackagePushUpgradeAbortResult>;
+}

package/lib/commands/package/push-upgrade/abort.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { PackagePushUpgrade } from '@salesforce/packaging';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_pushupgrade_abort');
+export class PackagePushUpgradeAbortCommand extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'target-dev-hub': Flags.requiredHub(),
+        'api-version': Flags.orgApiVersion(),
+        'push-request-id': Flags.salesforceId({
+            length: 'both',
+            char: 'i',
+            summary: messages.getMessage('flags.push-request-id.summary'),
+            required: true,
+            startsWith: '0DV',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(PackagePushUpgradeAbortCommand);
+        const connection = flags['target-dev-hub'].getConnection(flags['api-version']);
+        const packagePushRequestOptions = { packagePushRequestId: flags['push-request-id'] };
+        const result = await PackagePushUpgrade.abort(connection, packagePushRequestOptions);
+        if (result) {
+            this.log(messages.getMessage('output', [flags['push-request-id']]));
+        }
+        return { success: result };
+    }
+}
+//# sourceMappingURL=abort.js.map

package/lib/commands/package/push-upgrade/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../../../src/commands/package/push-upgrade/abort.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,8BAA8B,EAAE,2BAA2B,CAAC,CAAC;AAMpG,MAAM,OAAO,8BAA+B,SAAQ,SAAwC;IACnF,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,CAAU,KAAK,GAAG;QAC7B,gBAAgB,EAAE,KAAK,CAAC,WAAW,EAAE;QACrC,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE;QACpC,iBAAiB,EAAE,KAAK,CAAC,YAAY,CAAC;YACpC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,+BAA+B,CAAC;YAC7D,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;SAClB,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QAE/E,MAAM,yBAAyB,GAAG,EAAE,oBAAoB,EAAE,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAErF,MAAM,MAAM,GAAY,MAAM,kBAAkB,CAAC,KAAK,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;QAE9F,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC"}

package/lib/commands/package/push-upgrade/list.d.ts

@@ -0,0 +1,18 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { PackagePushRequestListResult } from '@salesforce/packaging';
+export type PackagePushRequestListResultArr = PackagePushRequestListResult[];
+export declare class PackagePushRequestListCommand extends SfCommand<PackagePushRequestListResultArr> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly aliases: string[];
+    static readonly flags: {
+        'target-dev-hub': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        package: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'scheduled-last-days': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'show-push-migrations-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<PackagePushRequestListResultArr>;
+}

package/lib/commands/package/push-upgrade/list.js

@@ -0,0 +1,91 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { Flags, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages, Logger } from '@salesforce/core';
+import { PackagePushUpgrade } from '@salesforce/packaging';
+import { requiredHubFlag } from '../../../utils/hubFlag.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_pushupgrade_list');
+export class PackagePushRequestListCommand extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static aliases = ['force:package:push-upgrade:list'];
+    static flags = {
+        'target-dev-hub': requiredHubFlag,
+        'api-version': orgApiVersionFlagWithDeprecations,
+        package: Flags.string({
+            char: 'p',
+            summary: messages.getMessage('flags.package.summary'),
+            required: true,
+        }),
+        'scheduled-last-days': Flags.integer({
+            char: 'l',
+            deprecateAliases: true,
+            aliases: ['scheduledlastdays'],
+            summary: messages.getMessage('flags.scheduled-last-days.summary'),
+        }),
+        status: Flags.custom({
+            options: ['Created', 'Cancelled', 'Pending', 'In Progress', 'Failed', 'Succeeded'],
+        })({
+            char: 's',
+            summary: messages.getMessage('flags.status.summary'),
+        }),
+        'show-push-migrations-only': Flags.boolean({
+            summary: messages.getMessage('flags.show-push-migrations-only.summary'),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(PackagePushRequestListCommand);
+        const logger = await Logger.child(this.constructor.name);
+        const hubOrg = flags['target-dev-hub'];
+        const connection = hubOrg.getConnection(flags['api-version']);
+        const scheduledLastDays = flags['scheduled-last-days'];
+        if (scheduledLastDays !== undefined) {
+            if (isNaN(scheduledLastDays) || scheduledLastDays <= 0) {
+                throw new Error('Invalid value for --scheduled-last-days. It must be a positive integer.');
+            }
+        }
+        logger.debug(`Querying PackagePushRequest records from org ${hubOrg.getOrgId()}`);
+        const results = await PackagePushUpgrade.list(connection, {
+            packageId: flags.package,
+            status: flags.status,
+            scheduledLastDays,
+            isMigration: flags['show-push-migrations-only'],
+        });
+        if (results.length === 0) {
+            this.warn('No results found');
+        }
+        else {
+            const data = await Promise.all(results.map(async (record) => {
+                const packagePushRequestId = record?.Id;
+                const packagePushRequestOptions = { packagePushRequestId };
+                const totalNumOrgs = await PackagePushUpgrade.getTotalJobs(connection, packagePushRequestOptions);
+                const numOrgsUpgradedFail = await PackagePushUpgrade.getFailedJobs(connection, packagePushRequestOptions);
+                const numOrgsUpgradedSuccess = await PackagePushUpgrade.getSucceededJobs(connection, packagePushRequestOptions);
+                const pv = record?.PackageVersion;
+                const packageVersionNumber = pv?.MajorVersion != null && pv?.MinorVersion != null ? `${pv.MajorVersion}.${pv.MinorVersion}` : undefined;
+                return {
+                    Id: record?.Id,
+                    PackageVersionId: record?.PackageVersionId,
+                    PackageVersionName: pv?.Name,
+                    PackageVersionNumber: packageVersionNumber,
+                    Status: record?.Status,
+                    ScheduledStartTime: record?.ScheduledStartTime,
+                    StartTime: record?.StartTime,
+                    EndTime: record?.EndTime,
+                    NumOrgsScheduled: totalNumOrgs,
+                    NumOrgsUpgradedFail: numOrgsUpgradedFail,
+                    NumOrgsUpgradedSuccess: numOrgsUpgradedSuccess,
+                };
+            }));
+            this.table({ data });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=list.js.map

package/lib/commands/package/push-upgrade/list.js.map

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

package/lib/commands/package/push-upgrade/report.d.ts

@@ -0,0 +1,18 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { PackagePushRequestReportResult } from '@salesforce/packaging';
+export type ReportCommandResult = PackagePushRequestReportResult | null;
+export declare class PackagePushUpgradeReportCommand extends SfCommand<ReportCommandResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly deprecateAliases = true;
+    static readonly aliases: string[];
+    static readonly flags: {
+        loglevel: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'target-dev-hub': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'push-request-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ReportCommandResult>;
+    private display;
+}