Merge branch 'main' into hc/support-recommendedversionid-field

Author: hcooreman-salesforce

CHANGELOG.md

@@ -1,3 +1,23 @@
+## [2.20.6](https://github.com/salesforcecli/plugin-packaging/compare/2.20.5...2.20.6) (2025-10-10)
+
+### Bug Fixes
+
+- add spanner to install ([cc9fb55](https://github.com/salesforcecli/plugin-packaging/commit/cc9fb5584a4d8182298b3572c16682a2b05236e6))
+- finish create and display error correctly for install ([f10528b](https://github.com/salesforcecli/plugin-packaging/commit/f10528be746a437616e4645b9ff7a49986a41978))
+- fix all tests error regarding create error ([e65614b](https://github.com/salesforcecli/plugin-packaging/commit/e65614b414f4231a67c6f20d980e5e09a08f526f))
+- fix all tests error regarding create error ([2b3c7ee](https://github.com/salesforcecli/plugin-packaging/commit/2b3c7ee57e5053469459fda3e70f0150b763d101))
+- fix bundle cli issues dev preview ([a064fb4](https://github.com/salesforcecli/plugin-packaging/commit/a064fb45e7d849591dc8ecdd91060f017440d592))
+- fix polling issue ([6651065](https://github.com/salesforcecli/plugin-packaging/commit/6651065fbbf53abf3fb3779c853ec9f8fb2220de))
+- fix polling issue ([afef736](https://github.com/salesforcecli/plugin-packaging/commit/afef7368c8a694865234e7fef88dc6f9c446b8ee))
+- fix polling issue ([0cd595f](https://github.com/salesforcecli/plugin-packaging/commit/0cd595f7533384c71212f3ebf1505dca4c76a577))
+- fix test ([73eba87](https://github.com/salesforcecli/plugin-packaging/commit/73eba873da52ab7c2d6e7048f8fd85c0e5470166))
+- revert create ([e346f77](https://github.com/salesforcecli/plugin-packaging/commit/e346f77089e0a9d43004883fb4ffad39f55c4ccd))
+- revert create ([50c64e1](https://github.com/salesforcecli/plugin-packaging/commit/50c64e1d5ee64986f6a6907990e1d5f0920d1806))
+- surface bundle install error ([8ef2251](https://github.com/salesforcecli/plugin-packaging/commit/8ef2251dbb234108c7ca3601f9e57c62c4387f48))
+- surface bundle install error ([3aca14e](https://github.com/salesforcecli/plugin-packaging/commit/3aca14efbd1193d3a950a9628ad14a1cac27d842))
+- surface validation error in create correctly ([65dd822](https://github.com/salesforcecli/plugin-packaging/commit/65dd82227e06e3dd6e8bceae2be0831d0143a3a6))
+- use separate bundle version lifecycle event ([0136cec](https://github.com/salesforcecli/plugin-packaging/commit/0136cec4dc170721d796c4d8b9bfec1b318eccea))
+
 ## [2.20.5](https://github.com/salesforcecli/plugin-packaging/compare/2.20.4...2.20.5) (2025-09-23)
 
 ### Bug Fixes

README.md

@@ -154,7 +154,7 @@ FLAG DESCRIPTIONS
     --installation-key-bypass flag is required.
 ```
 
-_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.5/src/commands/package/convert.ts)_
+_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/convert.ts)_
 
 ## `sf package create`
 
@@ -233,7 +233,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.20.5/src/commands/package/create.ts)_
+_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/create.ts)_
 
 ## `sf package delete`
 
@@ -275,7 +275,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.20.5/src/commands/package/delete.ts)_
+_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/delete.ts)_
 
 ## `sf package install`
 
@@ -374,7 +374,7 @@ FLAG DESCRIPTIONS
     - Delete: Delete removed components, except for custom objects and custom fields, that don't have dependencies.
 ```
 
-_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.5/src/commands/package/install.ts)_
+_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/install.ts)_
 
 ## `sf package install report`
 
@@ -407,7 +407,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.20.5/src/commands/package/install/report.ts)_
+_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/install/report.ts)_
 
 ## `sf package installed list`
 
@@ -439,7 +439,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.20.5/src/commands/package/installed/list.ts)_
+_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/installed/list.ts)_
 
 ## `sf package list`
 
@@ -477,7 +477,7 @@ 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.20.5/src/commands/package/list.ts)_
+_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/list.ts)_
 
 ## `sf package push-upgrade abort`
 
@@ -516,7 +516,7 @@ EXAMPLES
     $ 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.20.5/src/commands/package/push-upgrade/abort.ts)_
+_See code: [src/commands/package/push-upgrade/abort.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/push-upgrade/abort.ts)_
 
 ## `sf package push-upgrade list`
 
@@ -575,7 +575,7 @@ EXAMPLES
     $ 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.20.5/src/commands/package/push-upgrade/list.ts)_
+_See code: [src/commands/package/push-upgrade/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/push-upgrade/list.ts)_
 
 ## `sf package push-upgrade report`
 
@@ -617,7 +617,7 @@ EXAMPLES
     $ 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.20.5/src/commands/package/push-upgrade/report.ts)_
+_See code: [src/commands/package/push-upgrade/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/push-upgrade/report.ts)_
 
 ## `sf package push-upgrade schedule`
 
@@ -704,7 +704,7 @@ FLAG DESCRIPTIONS
     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.20.5/src/commands/package/push-upgrade/schedule.ts)_
+_See code: [src/commands/package/push-upgrade/schedule.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/push-upgrade/schedule.ts)_
 
 ## `sf package uninstall`
 
@@ -752,7 +752,7 @@ EXAMPLES
     $ sf package uninstall --package "Undesirable Package Alias"
 ```
 
-_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.5/src/commands/package/uninstall.ts)_
+_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/uninstall.ts)_
 
 ## `sf package uninstall report`
 
@@ -785,7 +785,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.20.5/src/commands/package/uninstall/report.ts)_
+_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/uninstall/report.ts)_
 
 ## `sf package update`
 
@@ -841,7 +841,7 @@ FLAG DESCRIPTIONS
     associated with your package.
 ```
 
-_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.5/src/commands/package/update.ts)_
+_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/update.ts)_
 
 ## `sf package version create`
 
@@ -1016,7 +1016,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.20.5/src/commands/package/version/create.ts)_
+_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/version/create.ts)_
 
 ## `sf package version create list`
 
@@ -1077,7 +1077,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.20.5/src/commands/package/version/create/list.ts)_
+_See code: [src/commands/package/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/version/create/list.ts)_
 
 ## `sf package version create report`
 
@@ -1120,7 +1120,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.20.5/src/commands/package/version/create/report.ts)_
+_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/version/create/report.ts)_
 
 ## `sf package version delete`
 
@@ -1161,7 +1161,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.20.5/src/commands/package/version/delete.ts)_
+_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/version/delete.ts)_
 
 ## `sf package version displayancestry`
 
@@ -1221,7 +1221,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.20.5/src/commands/package/version/displayancestry.ts)_
+_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/version/displayancestry.ts)_
 
 ## `sf package version displaydependencies`
 
@@ -1283,7 +1283,7 @@ FLAG DESCRIPTIONS
     package, which must be installed last.
 ```
 
-_See code: [src/commands/package/version/displaydependencies.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.5/src/commands/package/version/displaydependencies.ts)_
+_See code: [src/commands/package/version/displaydependencies.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/version/displaydependencies.ts)_
 
 ## `sf package version list`
 
@@ -1359,7 +1359,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.20.5/src/commands/package/version/list.ts)_
+_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/version/list.ts)_
 
 ## `sf package version promote`
 
@@ -1403,7 +1403,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.20.5/src/commands/package/version/promote.ts)_
+_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/version/promote.ts)_
 
 ## `sf package version report`
 
@@ -1443,7 +1443,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.20.5/src/commands/package/version/report.ts)_
+_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/version/report.ts)_
 
 ## `sf package version update`
 
@@ -1496,7 +1496,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.20.5/src/commands/package/version/update.ts)_
+_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package/version/update.ts)_
 
 ## `sf package1 version create`
 
@@ -1563,7 +1563,7 @@ FLAG DESCRIPTIONS
     subscribers.
 ```
 
-_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.5/src/commands/package1/version/create.ts)_
+_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package1/version/create.ts)_
 
 ## `sf package1 version create get`
 
@@ -1596,7 +1596,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.20.5/src/commands/package1/version/create/get.ts)_
+_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package1/version/create/get.ts)_
 
 ## `sf package1 version display`
 
@@ -1630,7 +1630,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.20.5/src/commands/package1/version/display.ts)_
+_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package1/version/display.ts)_
 
 ## `sf package1 version list`
 
@@ -1668,6 +1668,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.20.5/src/commands/package1/version/list.ts)_
+_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6/src/commands/package1/version/list.ts)_
 
 <!-- commandsstop -->

command-snapshot.json

@@ -74,19 +74,9 @@
   {
     "alias": [],
     "command": "package:bundle:install",
-    "flagAliases": ["apiversion", "targetdevhubusername", "targetusername", "u"],
-    "flagChars": ["b", "o", "v", "w"],
-    "flags": [
-      "api-version",
-      "bundle",
-      "flags-dir",
-      "json",
-      "loglevel",
-      "target-dev-hub",
-      "target-org",
-      "verbose",
-      "wait"
-    ],
+    "flagAliases": ["apiversion", "targetusername", "u"],
+    "flagChars": ["b", "d", "o", "w"],
+    "flags": ["api-version", "bundle", "dev-hub-org", "flags-dir", "json", "loglevel", "target-org", "verbose", "wait"],
     "plugin": "@salesforce/plugin-packaging"
   },
   {

messages/bundle_create.md

@@ -5,7 +5,7 @@ Create a package bundle in the Dev Hub org.
 # description
 
 A package bundle is an artifact that contains one or more 2GP managed packages.
-A bundle can be listed on AppExchange, installed, or upgraded as a single artifact.
+A bundle can be installed or upgraded as a single artifact.
 
 # examples
 

messages/bundle_install.md

@@ -8,21 +8,29 @@ Install a specific version of a package bundle in the target org. During develop
 
 # examples
 
-Install a package bundle version in a scratch org:
+- Install a package bundle version in a scratch org:
 
-sf package bundle install --bundle MyPkgBundle1@0.1 --target-org my-scratch-org --wait 10
+  <%= config.bin %> <%= command.id %> --bundle MyPkgBundle1@0.1 --target-org my-scratch-org --dev-hub-org 00Dxx0000000000 --wait 10
+
+- Install using a bundle version ID:
+
+  <%= config.bin %> <%= command.id %> --bundle 1Q8Wt0000000q1pKAA --target-org my-scratch-org --dev-hub-org 00Dxx0000000000 --wait 10
 
 # flags.bundle.summary
 
-Package bundle version to install (format: BundleName@Version).
+Package bundle version to install (format: BundleName@Version or bundle version ID).
 
 # flags.target-org.summary
 
 Target org for the bundle installation.
 
-# flags.target-dev-hub.summary
+# flags.dev-hub-org.summary
+
+Org ID of the Dev Hub org where the bundle was created.
+
+# flags.dev-hub-org.description
 
-Username, alias, or org ID of the target dev hub org.
+Specify the Dev Hub org ID directly (such as 00Dxx0000000000). 
 
 # flags.wait.summary
 
@@ -55,4 +63,4 @@ Encountered errors installing the bundle! %s
 # bundleInstallInProgress
 
 Bundle installation is currently %s. You can continue to query the status using
-sf package bundle install:report -i %s -o %s
+sf package bundle install report -i %s -o %s

messages/bundle_version_create_list.md

@@ -1,6 +1,6 @@
 # summary
 
-List package version creation requests.
+List package bundle version creation requests.
 
 # description
 

messages/bundle_version_create_report.md

@@ -47,3 +47,7 @@ Created Date
 # created-by
 
 Created By
+
+# validation-error
+
+Validation Error

package.json

@@ -1,14 +1,14 @@
 {
   "name": "@salesforce/plugin-packaging",
   "description": "SF plugin that support Salesforce Packaging Platform",
-  "version": "2.20.5",
+  "version": "2.20.6",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {
     "@oclif/core": "^4",
     "@salesforce/core": "^8.23.1",
     "@salesforce/kit": "^3.2.4",
-    "@salesforce/packaging": "^4.15.0",
+    "@salesforce/packaging": "^4.15.1",
     "@salesforce/sf-plugins-core": "^12.2.4",
     "chalk": "^5.6.2"
   },

schemas/package-bundle-install-list.json

@@ -52,7 +52,12 @@
     },
     "BundleSObjects.PkgBundleVersionInstallReqStatus": {
       "type": "string",
-      "enum": ["Queued", "Success", "Error"]
+      "enum": [
+        "Queued",
+        "InProgress",
+        "Success",
+        "Error"
+      ]
     }
   }
-}
+}