@salesforce/plugin-packaging 2.13.6 → 2.15.0

package/README.md

@@ -30,12 +30,17 @@ See [DEVELOPING.md](DEVELOPING.md)
 
 <!-- commands -->
 
+- [`sf package convert`](#sf-package-convert)
 - [`sf package create`](#sf-package-create)
 - [`sf package delete`](#sf-package-delete)
 - [`sf package install`](#sf-package-install)
 - [`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)
@@ -53,6 +58,93 @@ See [DEVELOPING.md](DEVELOPING.md)
 - [`sf package1 version display`](#sf-package1-version-display)
 - [`sf package1 version list`](#sf-package1-version-list)
 
+## `sf package convert`
+
+Create a second-generation package version from a first-generation package.
+
+```
+USAGE
+  $ sf package convert -v <value> -p <value> [--json] [--flags-dir <value>] [--api-version <value>] [-k <value>] [-f
+    <value>] [-x] [-w <value>] [-m <value>] [--verbose] [-a <value>]
+
+FLAGS
+  -a, --patch-version=<value>     Specific released patch version to convert
+  -f, --definition-file=<value>   Path to a definition file that contains features and org preferences that the metadata
+                                  of the package version depends on.
+  -k, --installation-key=<value>  Installation key for key-protected package.
+  -m, --seed-metadata=<value>     Directory containing metadata to be deployed prior to conversion.
+  -p, --package=<value>           (required) ID (starts with 033) of the first-generation package to convert.
+  -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.
+  -w, --wait=<value>              Minutes to wait for the package version to be created.
+  -x, --installation-key-bypass   Bypass the installation key requirement.
+      --api-version=<value>       Override the api version used for api requests made by this command
+      --verbose                   Display verbose command output.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Create a second-generation package version from a first-generation package.
+
+  The package convert creates a new package in the Dev Hub if one does not already exist for the specified
+  first-generation package.
+
+  It then creates a new package version in the Dev Hub with contents based on the specified first-generation package.
+
+  By default, the latest released non-patch version from the specified first-generation package will be converted. Use
+  --patch-version to override the default. Read more about --patch-version option in help
+
+  To retrieve details about a package version create request, including status and package version ID (04t), run "sf
+  package version create report -i 08c...".
+
+  We recommend specifying the --installation-key to protect the contents of your package and to prevent unauthorized
+  installation of your package.
+
+  To list package version creation requests in the org, run "sf package version create list".
+
+ALIASES
+  $ sf force package convert
+
+EXAMPLES
+  Create a second-generation package version from the first-generation package with the specified ID and give it the
+  installation key "password123"; uses your default Dev Hub org:
+
+    $ sf package convert --package 033... --installation-key password123
+
+  Similar to previous example, but uses the specified Dev Hub org:
+
+    $ sf package convert --package 033... --installation-key password123 --target-dev-hub devhuborg@example.com
+
+FLAG DESCRIPTIONS
+  -a, --patch-version=<value>  Specific released patch version to convert
+
+    Specify a released patch version as major.minor.patch.build to convert to second generation package version
+
+  -f, --definition-file=<value>
+
+    Path to a definition file that contains features and org preferences that the metadata of the package version
+    depends on.
+
+    This definition file is similar to the scratch org definition file.
+
+  -k, --installation-key=<value>  Installation key for key-protected package.
+
+    Either an --installation-key value or the --installation-key-bypass flag is required.
+
+  -m, --seed-metadata=<value>  Directory containing metadata to be deployed prior to conversion.
+
+    The directory containing metadata that will be deployed on the build org prior to attempting conversion.
+
+  -x, --installation-key-bypass  Bypass the installation key requirement.
+
+    If you bypass this requirement, anyone can install your package. Either an --installation-key value or the
+    --installation-key-bypass flag is required.
+```
+
+_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/convert.ts)_
+
 ## `sf package create`
 
 Create a package.
@@ -130,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.13.6/src/commands/package/create.ts)_
+_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/create.ts)_
 
 ## `sf package delete`
 
@@ -172,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.13.6/src/commands/package/delete.ts)_
+_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/delete.ts)_
 
 ## `sf package install`
 
@@ -271,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.13.6/src/commands/package/install.ts)_
+_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/install.ts)_
 
 ## `sf package install report`
 
@@ -304,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.13.6/src/commands/package/install/report.ts)_
+_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/install/report.ts)_
 
 ## `sf package installed list`
 
@@ -336,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.13.6/src/commands/package/installed/list.ts)_
+_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/installed/list.ts)_
 
 ## `sf package list`
 
@@ -374,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.13.6/src/commands/package/list.ts)_
+_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/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.0/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.0/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.0/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.0/src/commands/package/push-upgrade/schedule.ts)_
 
 ## `sf package uninstall`
 
@@ -422,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.13.6/src/commands/package/uninstall.ts)_
+_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/uninstall.ts)_
 
 ## `sf package uninstall report`
 
@@ -455,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.13.6/src/commands/package/uninstall/report.ts)_
+_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/uninstall/report.ts)_
 
 ## `sf package update`
 
@@ -510,7 +825,7 @@ FLAG DESCRIPTIONS
     associated with your package.
 ```
 
-_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.13.6/src/commands/package/update.ts)_
+_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/update.ts)_
 
 ## `sf package version create`
 
@@ -685,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.13.6/src/commands/package/version/create.ts)_
+_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/version/create.ts)_
 
 ## `sf package version create list`
 
@@ -746,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.13.6/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.0/src/commands/package/version/create/list.ts)_
 
 ## `sf package version create report`
 
@@ -789,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.13.6/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.0/src/commands/package/version/create/report.ts)_
 
 ## `sf package version delete`
 
@@ -830,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.13.6/src/commands/package/version/delete.ts)_
+_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/version/delete.ts)_
 
 ## `sf package version displayancestry`
 
@@ -890,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.13.6/src/commands/package/version/displayancestry.ts)_
+_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/version/displayancestry.ts)_
 
 ## `sf package version list`
 
@@ -966,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.13.6/src/commands/package/version/list.ts)_
+_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/version/list.ts)_
 
 ## `sf package version promote`
 
@@ -1010,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.13.6/src/commands/package/version/promote.ts)_
+_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/version/promote.ts)_
 
 ## `sf package version report`
 
@@ -1050,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.13.6/src/commands/package/version/report.ts)_
+_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/version/report.ts)_
 
 ## `sf package version update`
 
@@ -1103,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.13.6/src/commands/package/version/update.ts)_
+_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package/version/update.ts)_
 
 ## `sf package1 version create`
 
@@ -1170,7 +1485,7 @@ FLAG DESCRIPTIONS
     subscribers.
 ```
 
-_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.13.6/src/commands/package1/version/create.ts)_
+_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package1/version/create.ts)_
 
 ## `sf package1 version create get`
 
@@ -1203,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.13.6/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.0/src/commands/package1/version/create/get.ts)_
 
 ## `sf package1 version display`
 
@@ -1237,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.13.6/src/commands/package1/version/display.ts)_
+_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package1/version/display.ts)_
 
 ## `sf package1 version list`
 
@@ -1275,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.13.6/src/commands/package1/version/list.ts)_
+_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.0/src/commands/package1/version/list.ts)_
 
 <!-- commandsstop -->

package/lib/commands/package/convert.d.ts

@@ -7,7 +7,6 @@ export declare class PackageConvert extends SfCommand<PackageVersionCreateReques
     static readonly examples: string[];
     static readonly deprecateAliases = true;
     static readonly aliases: string[];
-    static readonly hidden = true;
     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>;

package/lib/commands/package/convert.js

@@ -18,7 +18,6 @@ export class PackageConvert extends SfCommand {
     static examples = messages.getMessages('examples');
     static deprecateAliases = true;
     static aliases = ['force:package:convert'];
-    static hidden = true;
     static flags = {
         loglevel,
         'target-dev-hub': requiredHubFlag,
@@ -80,7 +79,6 @@ export class PackageConvert extends SfCommand {
             char: 'a',
             deprecateAliases: true,
             aliases: ['patchversion'],
-            hidden: true,
         }),
     };
     async run() {

package/lib/commands/package/convert.js.map

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

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"}