diff --git a/CHANGELOG.md b/CHANGELOG.md index a6377ccc..c24dc65c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,133 @@ +## [2.15.1](https://github.com/salesforcecli/plugin-packaging/compare/2.15.0...2.15.1) (2025-06-06) + +### Bug Fixes + +- **deps:** bump @salesforce/core from 8.11.1 to 8.11.4 ([22d1bf3](https://github.com/salesforcecli/plugin-packaging/commit/22d1bf36165e937ea19e76348042e5d9f2d12c63)) + +# [2.15.0](https://github.com/salesforcecli/plugin-packaging/compare/2.14.0...2.15.0) (2025-06-05) + +### Bug Fixes + +- add eslint exception ([7b114c4](https://github.com/salesforcecli/plugin-packaging/commit/7b114c41508c87f4b7623bebd80ad43bf653b09f)) +- add lint exceptions ([ba0ddf6](https://github.com/salesforcecli/plugin-packaging/commit/ba0ddf674a1919a89802ffc44ff9214fe22f7163)) +- add lint exceptions ([f6d7613](https://github.com/salesforcecli/plugin-packaging/commit/f6d76132e452af254abc19a087171c0fd1e809bd)) +- add migration flag test ([f2783d9](https://github.com/salesforcecli/plugin-packaging/commit/f2783d987082cf5cc8dda80146570c9290f1e3e0)) +- add missing type ([cc5b530](https://github.com/salesforcecli/plugin-packaging/commit/cc5b5304569a91f6e154b630112773e7e22fa097)) +- add orgInput check cannot be empty ([990d0f0](https://github.com/salesforcecli/plugin-packaging/commit/990d0f0d972d4271bd2e5072bfe3230ceb5c9ba8)) +- add package version number to display ([48d3a2d](https://github.com/salesforcecli/plugin-packaging/commit/48d3a2db206d73f24a4dbc796a713f274c6bfc9d)) +- add push upgrade schedule schema ([e2c924e](https://github.com/salesforcecli/plugin-packaging/commit/e2c924e3ef280f97cf809bfaeb876f0f4542966f)) +- add push upgrade schedule schema ([3398869](https://github.com/salesforcecli/plugin-packaging/commit/33988695699424c75ad5886254c69506b145f09d)) +- add try catch for get org list function ([2f49b94](https://github.com/salesforcecli/plugin-packaging/commit/2f49b94096b7c74862dbb32840747e6816e2decf)) +- based on packaging PR changes ([6db3a4e](https://github.com/salesforcecli/plugin-packaging/commit/6db3a4e8431a6bc63253ec14d510261c4e2b514c)) +- better error handling ([97f84c4](https://github.com/salesforcecli/plugin-packaging/commit/97f84c43c99ab4a6a496eb6e7f5b24daa8bef0dc)) +- change command to push-upgrade ([bd19e59](https://github.com/salesforcecli/plugin-packaging/commit/bd19e599d6488bb0db30e66272c3185e02271bf9)) +- change flag char ([3383f38](https://github.com/salesforcecli/plugin-packaging/commit/3383f38aa194e4653bbb94d16903d4f086004f1f)) +- change flag char ([91aef4c](https://github.com/salesforcecli/plugin-packaging/commit/91aef4c8a297047e1bdde09d524593a424aa67d8)) +- change name ([2d89ac4](https://github.com/salesforcecli/plugin-packaging/commit/2d89ac4bf4222df2989058f5c0a0f249cf525ea8)) +- change summary text ([0fc713a](https://github.com/salesforcecli/plugin-packaging/commit/0fc713ae69e056832c4a25821f9021cd4278bc0b)) +- change to schedule start time ([61a5a89](https://github.com/salesforcecli/plugin-packaging/commit/61a5a893e8e4bab2459365fde6d9977837c198ca)) +- edit pushupgrade list md file ([3947f9a](https://github.com/salesforcecli/plugin-packaging/commit/3947f9afae2c0d239c1bad29222b95860afe7e5c)) +- edit pushupgrade list schema file ([38dcf0c](https://github.com/salesforcecli/plugin-packaging/commit/38dcf0c15e07e08e1ebb19ae89d4a20ac198370d)) +- export required type ([1175b46](https://github.com/salesforcecli/plugin-packaging/commit/1175b464f08b0ed7f8ddcf6d19f2c9f07e3ce88e)) +- fix all any errors ([351e229](https://github.com/salesforcecli/plugin-packaging/commit/351e22923d16d9655138612a0ae8ef6c786fb3de)) +- fix error message ([346899a](https://github.com/salesforcecli/plugin-packaging/commit/346899a1f47a677a428dbe98994d0beb840797c8)) +- fix help texts messages ([29bb834](https://github.com/salesforcecli/plugin-packaging/commit/29bb8349dac9745c005c1120fb097799b72cf250)) +- fix help texts messages ([b8569f2](https://github.com/salesforcecli/plugin-packaging/commit/b8569f246504a7f7c038184d653e03e59f241c9b)) +- fix help texts messages ([09a14bd](https://github.com/salesforcecli/plugin-packaging/commit/09a14bd81ad762ffd212e858b2fcded85fd65325)) +- fix help texts messages ([7e719f6](https://github.com/salesforcecli/plugin-packaging/commit/7e719f6ca4ea22574e6f88f9bd74d513d641a141)) +- fix help texts messages ([8a4eb10](https://github.com/salesforcecli/plugin-packaging/commit/8a4eb107f0708447d07f74b1a7682580d285f35b)) +- fix hub org deprecate call schedule ([348b2ba](https://github.com/salesforcecli/plugin-packaging/commit/348b2ba52b162e2e2c384259a8d363ee4f900b99)) +- fix linting issues ([5d86f29](https://github.com/salesforcecli/plugin-packaging/commit/5d86f298616ae1da7a1919d020635622fb16e2cd)) +- fix linting issues ([f4ea739](https://github.com/salesforcecli/plugin-packaging/commit/f4ea73952040aee5fd12252ac5a99f7b683418da)) +- fix linting issues ([67a77ff](https://github.com/salesforcecli/plugin-packaging/commit/67a77ff0d50f4bf03138fb101c239e00222963bd)) +- fix migration text ([8883c53](https://github.com/salesforcecli/plugin-packaging/commit/8883c53dc1271b3777c2d48b8cb23024ad2dac01)) +- fix no-unsafe errors and other issues ([d46ab94](https://github.com/salesforcecli/plugin-packaging/commit/d46ab947c9ee08d938566dab63f6e46334d46ffe)) +- fix nut test error ([b4b16b6](https://github.com/salesforcecli/plugin-packaging/commit/b4b16b6adcee2f27f864777c1252795d8be8222b)) +- fix nut test error ([b34aaae](https://github.com/salesforcecli/plugin-packaging/commit/b34aaae1edd948ecb578e2c1efe4f94ebf2dde42)) +- fix schedule based on comments ([e8db083](https://github.com/salesforcecli/plugin-packaging/commit/e8db08399c751496191d2e3830326e24a0c7a95e)) +- fix schedule command texts ([94571a9](https://github.com/salesforcecli/plugin-packaging/commit/94571a9ccfd81ade6c0600f5b4bc013f4fe692a1)) +- fix schedule tests ([9d2f961](https://github.com/salesforcecli/plugin-packaging/commit/9d2f9616471e91ba06fbdf57550a518e01a67e74)) +- fix SfError type ([a49a11d](https://github.com/salesforcecli/plugin-packaging/commit/a49a11dd577835b47b887b5644deb23160c8421a)) +- fix snapshot ([7da85f0](https://github.com/salesforcecli/plugin-packaging/commit/7da85f086d71f534038a827c1eb5a9723314078d)) +- fix test ([6f0d167](https://github.com/salesforcecli/plugin-packaging/commit/6f0d16728530e922b9701710ce64b9b67a769fe8)) +- fix tests ([cf2425f](https://github.com/salesforcecli/plugin-packaging/commit/cf2425fd22fbc51b7934758535eab8c16668b17e)) +- fix yarn issue ([52f9ab5](https://github.com/salesforcecli/plugin-packaging/commit/52f9ab5584211f03ed80a376a3eece27df47699e)) +- fix yarn lock ([1820382](https://github.com/salesforcecli/plugin-packaging/commit/18203829fe5fab030eae785a155d483452f53146)) +- handle case when both org file and org input not supplied ([03ceace](https://github.com/salesforcecli/plugin-packaging/commit/03ceace3bebc9da627cebddcecb67de20212a8fc)) +- help text for schedule command ([8e3aae2](https://github.com/salesforcecli/plugin-packaging/commit/8e3aae2cb13732b0b4c0ea9f51ca23fbb6d80d3f)) +- modify field names ([e6ac978](https://github.com/salesforcecli/plugin-packaging/commit/e6ac978b2482cdf5ebfb3938529c129b20c2f952)) +- modify readOrgList function ([2089364](https://github.com/salesforcecli/plugin-packaging/commit/2089364e47278db4ebab1eb89500f054ac832338)) +- pr comments ([3384074](https://github.com/salesforcecli/plugin-packaging/commit/33840749d1caab5369950cfa4f660d1e518ba05e)) +- readd test ([29fb2ff](https://github.com/salesforcecli/plugin-packaging/commit/29fb2ff56eb62921b6c205c92427d5b962e5fa8b)) +- remove beta flag ([6968c80](https://github.com/salesforcecli/plugin-packaging/commit/6968c8095230832c5454b9276d7305428ede131a)) +- remove deprecated aliases ([cddc9d3](https://github.com/salesforcecli/plugin-packaging/commit/cddc9d331b0bf716c28979f23726358bd8fb1284)) +- remove error from message ([7386cad](https://github.com/salesforcecli/plugin-packaging/commit/7386cadb585a3e3d5b030537538982ac66b6eae9)) +- remove old schemas ([65b060a](https://github.com/salesforcecli/plugin-packaging/commit/65b060a01f97afec074b940be1aab802aa6bd700)) +- remove redundant check ([0cb9635](https://github.com/salesforcecli/plugin-packaging/commit/0cb9635443ace1a2c6f46fe3fb3c255614a40cb8)) +- remove verbose flag for list ([3285377](https://github.com/salesforcecli/plugin-packaging/commit/3285377b12c52ce2e2f0bccd5ab2a036743703e9)) +- remove verbose flag for list (update test) ([d5024a5](https://github.com/salesforcecli/plugin-packaging/commit/d5024a558a2d8e822703c2a92de2cadaaff7c76f)) +- remove verbose flag schedule ([08b758d](https://github.com/salesforcecli/plugin-packaging/commit/08b758d2a4519b26634e0aa82b959ddc441aef24)) +- revert gitignore ([e1315a2](https://github.com/salesforcecli/plugin-packaging/commit/e1315a27d98004fee7e54988cff3b0d0ee7bc615)) +- split orgid according to new line ([59c498f](https://github.com/salesforcecli/plugin-packaging/commit/59c498fe688cd73a036ba7bd0956215db3b4b300)) +- start time is required error ([aa173b8](https://github.com/salesforcecli/plugin-packaging/commit/aa173b88168a7ec2fc818010261bebd0e9615ae1)) +- temp test remove ([e55f05a](https://github.com/salesforcecli/plugin-packaging/commit/e55f05a923fe893f05097e354ff2243901938f8c)) +- tests added ([b6a1c5c](https://github.com/salesforcecli/plugin-packaging/commit/b6a1c5c9d10689acf4f9ed484fe3adf45d9789d0)) +- uncomment code ([25f19d8](https://github.com/salesforcecli/plugin-packaging/commit/25f19d8b5a6a589f35f732e7402fc9ea8121ce65)) +- update command snapshot ([53b8934](https://github.com/salesforcecli/plugin-packaging/commit/53b89348f535d6374148f10369c4098934eb2541)) +- update command snapshot ([b85e45f](https://github.com/salesforcecli/plugin-packaging/commit/b85e45fe7a39b30e588e8dc04780b7a3926d420f)) +- update file path for test files ([0bf6dba](https://github.com/salesforcecli/plugin-packaging/commit/0bf6dba8a0243073ce62776c06c6dffb31effe98)) +- update file path for test files ([0c026e3](https://github.com/salesforcecli/plugin-packaging/commit/0c026e309cb4e732e1b2b6597c5d09108fb4a5b6)) +- update help text for all push upgrade commands ([ce58855](https://github.com/salesforcecli/plugin-packaging/commit/ce58855383c4e473a3c299108b53bf935898919c)) +- update list schema ([a0c2374](https://github.com/salesforcecli/plugin-packaging/commit/a0c2374645906ba835e5c3579cccee7d8881c803)) +- update list schema ([9eda6ab](https://github.com/salesforcecli/plugin-packaging/commit/9eda6ab9fe26e6b73848c8b05c9b3d37166917eb)) +- update list test ([e05b38d](https://github.com/salesforcecli/plugin-packaging/commit/e05b38d89f651b1551825bab49c768c89b7b34c8)) +- update org list summary text ([590d944](https://github.com/salesforcecli/plugin-packaging/commit/590d944ac8a275aed4ff17386d7ae9a49530f33c)) +- update package.json ([bc02c9a](https://github.com/salesforcecli/plugin-packaging/commit/bc02c9add9d2d39ce8e756bb5f398ebe0d1a7304)) +- update push upgrade list md file ([84f8954](https://github.com/salesforcecli/plugin-packaging/commit/84f8954ab35ce646a571701159876328c61f7860)) +- update push upgrade list md file ([5ee2cc3](https://github.com/salesforcecli/plugin-packaging/commit/5ee2cc3f5baa5770195cde7de724b2b0cd3c709f)) +- update schedule md file ([651b755](https://github.com/salesforcecli/plugin-packaging/commit/651b7559e801e765dcf263db76efc560bf2d23ed)) +- update schema ([5439e24](https://github.com/salesforcecli/plugin-packaging/commit/5439e24f6cf4fa0845045a9892247576c523cb0f)) +- update schema and snapshot ([a51573b](https://github.com/salesforcecli/plugin-packaging/commit/a51573ba3e325be8b596ee17fdf84a54d5836a76)) +- update snapshot ([7c9dace](https://github.com/salesforcecli/plugin-packaging/commit/7c9daceab7e061a0436b1b6d311ec2e9e5502424)) +- update snapshot ([c67dd8e](https://github.com/salesforcecli/plugin-packaging/commit/c67dd8e4aa2c38b11ef4f5cbb50c244fc81615c9)) +- update snapshot ([0bb0f5a](https://github.com/salesforcecli/plugin-packaging/commit/0bb0f5a25065332d22110098d52f6adf76a3f657)) +- update snapshot ([524f59d](https://github.com/salesforcecli/plugin-packaging/commit/524f59d7f2e57130f88a238349c02b7a82de6275)) +- update snapshot ([91d38fc](https://github.com/salesforcecli/plugin-packaging/commit/91d38fca7cd943b1adac241e9673a761802f8c30)) +- update yarn lock ([4033ff7](https://github.com/salesforcecli/plugin-packaging/commit/4033ff761abb1f231b25b3fb09a463c70f27171c)) +- update yarn lock ([36e8f01](https://github.com/salesforcecli/plugin-packaging/commit/36e8f010d6832c1d18f3c8862e599f9ecb8c4eb1)) +- update yarn lock ([54055d4](https://github.com/salesforcecli/plugin-packaging/commit/54055d4ae4465a9598b129b4c9971ed44156e18d)) +- update yarn lock ([db17295](https://github.com/salesforcecli/plugin-packaging/commit/db172950c7added4e537cedf0e6e76c70bb1a2d2)) + +### Features + +- add beta state to pu list command ([1616eaf](https://github.com/salesforcecli/plugin-packaging/commit/1616eaf7e38a796f8887a16391b9dd39ff0ea293)) +- add migration filter for list command ([3450cc2](https://github.com/salesforcecli/plugin-packaging/commit/3450cc2cf29d516dd5456d1a72fdf701e9eb01e7)) +- add migration filter to list command ([f754d13](https://github.com/salesforcecli/plugin-packaging/commit/f754d13f77a1618f16baf24b168493b3f0e9a96e)) +- add num orgs scheduled, succedded and failed + add test for list success case ([8b85e14](https://github.com/salesforcecli/plugin-packaging/commit/8b85e14981916719b5e77f30707993c6a28ce1e0)) +- add org list flag ([331b533](https://github.com/salesforcecli/plugin-packaging/commit/331b53311aecbeae5b4db919a03b757bdad9a8e8)) +- add package as required flag ([76bcd4b](https://github.com/salesforcecli/plugin-packaging/commit/76bcd4b6bde4d9d1ccab0ff8eb40b9a0cb646806)) +- add package push list feature ([c765915](https://github.com/salesforcecli/plugin-packaging/commit/c76591565b90b048261fd0e922c537304018af12)) +- add push migration flag ([f589d77](https://github.com/salesforcecli/plugin-packaging/commit/f589d772d5a694fb4a1c2fbaaebb5ff9dac09854)) +- add pushupgrade list schema file ([137bfdd](https://github.com/salesforcecli/plugin-packaging/commit/137bfdd7f70e82e6f3d47a6f01aaa4e9df7a909e)) +- add request scheduled time ([8752847](https://github.com/salesforcecli/plugin-packaging/commit/87528471d636bcca16ace2c0feeff5ba88e24f02)) +- add return message schedule command ([8aba4e2](https://github.com/salesforcecli/plugin-packaging/commit/8aba4e208db3e7e1a92ce0bb25dcbcd88480b9e5)) +- add schedule command test ([50c996c](https://github.com/salesforcecli/plugin-packaging/commit/50c996c3a28cbfccd2776e976fe5be7b5ed75491)) +- add schedule last days check ([fb6b050](https://github.com/salesforcecli/plugin-packaging/commit/fb6b05068025734e1cee8efd97c071e4188b77ab)) +- add schedule last days option ([f0098c2](https://github.com/salesforcecli/plugin-packaging/commit/f0098c28c6570864b95c2e9c848e9ff177a409b9)) +- add test for pu request list command ([a90421a](https://github.com/salesforcecli/plugin-packaging/commit/a90421adf7763f7b8b14c325bacd8ba28e1646da)) +- adds pushupgrade abort command support ([81d3da1](https://github.com/salesforcecli/plugin-packaging/commit/81d3da12f11c965474ff9b9f4f3c581ad21c6cc9)) +- adds pushupgrade report command ([0f51039](https://github.com/salesforcecli/plugin-packaging/commit/0f5103900146573c4ec20573951cf9e504746831)) +- adds support for package version ([c95c302](https://github.com/salesforcecli/plugin-packaging/commit/c95c30264a2d33be3a4a07561e05b8b86a885cc8)) +- display list command correctly ([0ae3183](https://github.com/salesforcecli/plugin-packaging/commit/0ae3183f9571d06e61052e59aa310b357bd7b74c)) +- hide pu command ([f46cf25](https://github.com/salesforcecli/plugin-packaging/commit/f46cf25dcc21fc8743da28e25b48ae1f96b2dd28)) +- implement schedule command ([9c40d9b](https://github.com/salesforcecli/plugin-packaging/commit/9c40d9b5924a18960246867019e7b79724d8c029)) + +# [2.14.0](https://github.com/salesforcecli/plugin-packaging/compare/2.13.6...2.14.0) (2025-06-03) + +### Features + +- expose package convert command for ga ([188a700](https://github.com/salesforcecli/plugin-packaging/commit/188a7001c3a3dcf1a1f11e724b0b94586a009e5b)) + ## [2.13.6](https://github.com/salesforcecli/plugin-packaging/compare/2.13.5...2.13.6) (2025-05-24) ### Bug Fixes diff --git a/README.md b/README.md index dfb348b4..3ffdbba7 100644 --- a/README.md +++ b/README.md @@ -30,12 +30,17 @@ See [DEVELOPING.md](DEVELOPING.md) +- [`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 -p [--json] [--flags-dir ] [--api-version ] [-k ] [-f + ] [-x] [-w ] [-m ] [--verbose] [-a ] + +FLAGS + -a, --patch-version= Specific released patch version to convert + -f, --definition-file= Path to a definition file that contains features and org preferences that the metadata + of the package version depends on. + -k, --installation-key= Installation key for key-protected package. + -m, --seed-metadata= Directory containing metadata to be deployed prior to conversion. + -p, --package= (required) ID (starts with 033) of the first-generation package to convert. + -v, --target-dev-hub= (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub` + configuration variable is already set. + -w, --wait= Minutes to wait for the package version to be created. + -x, --installation-key-bypass Bypass the installation key requirement. + --api-version= Override the api version used for api requests made by this command + --verbose Display verbose command output. + +GLOBAL FLAGS + --flags-dir= 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= 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= + + 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= Installation key for key-protected package. + + Either an --installation-key value or the --installation-key-bypass flag is required. + + -m, --seed-metadata= 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.1/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.1/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.1/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.1/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.1/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.1/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.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 -i [--json] [--flags-dir ] [--api-version ] + +FLAGS + -i, --push-request-id= (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= (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub` + configuration variable is already set. + --api-version= Override the api version used for api requests made by this command + +GLOBAL FLAGS + --flags-dir= 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 -p [--json] [--flags-dir ] [--api-version ] [-l ] [-s + Created|Cancelled|Pending|In Progress|Failed|Succeeded] [--show-push-migrations-only] + +FLAGS + -l, --scheduled-last-days= 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= (required) Package ID (starts with 033) of the package that you want push upgrade + information for. + -s, --status=