@salesforce/plugin-packaging 2.24.8 → 2.24.9

package/README.md

@@ -155,7 +155,7 @@ FLAG DESCRIPTIONS
     --installation-key-bypass flag is required.
 ```
 
-_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.8/src/commands/package/convert.ts)_
+_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/convert.ts)_
 
 ## `sf package create`
 
@@ -234,7 +234,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.24.8/src/commands/package/create.ts)_
+_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/create.ts)_
 
 ## `sf package delete`
 
@@ -276,7 +276,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.24.8/src/commands/package/delete.ts)_
+_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/delete.ts)_
 
 ## `sf package install`
 
@@ -375,7 +375,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.24.8/src/commands/package/install.ts)_
+_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/install.ts)_
 
 ## `sf package install report`
 
@@ -408,7 +408,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.24.8/src/commands/package/install/report.ts)_
+_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/install/report.ts)_
 
 ## `sf package installed list`
 
@@ -440,7 +440,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.24.8/src/commands/package/installed/list.ts)_
+_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/installed/list.ts)_
 
 ## `sf package list`
 
@@ -478,7 +478,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.24.8/src/commands/package/list.ts)_
+_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/list.ts)_
 
 ## `sf package push-upgrade abort`
 
@@ -517,7 +517,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.24.8/src/commands/package/push-upgrade/abort.ts)_
+_See code: [src/commands/package/push-upgrade/abort.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/push-upgrade/abort.ts)_
 
 ## `sf package push-upgrade list`
 
@@ -576,7 +576,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.24.8/src/commands/package/push-upgrade/list.ts)_
+_See code: [src/commands/package/push-upgrade/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/push-upgrade/list.ts)_
 
 ## `sf package push-upgrade report`
 
@@ -618,7 +618,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.24.8/src/commands/package/push-upgrade/report.ts)_
+_See code: [src/commands/package/push-upgrade/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/push-upgrade/report.ts)_
 
 ## `sf package push-upgrade schedule`
 
@@ -705,7 +705,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.24.8/src/commands/package/push-upgrade/schedule.ts)_
+_See code: [src/commands/package/push-upgrade/schedule.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/push-upgrade/schedule.ts)_
 
 ## `sf package uninstall`
 
@@ -753,7 +753,7 @@ EXAMPLES
     $ sf package uninstall --package "Undesirable Package Alias"
 ```
 
-_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.8/src/commands/package/uninstall.ts)_
+_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/uninstall.ts)_
 
 ## `sf package uninstall report`
 
@@ -786,7 +786,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.24.8/src/commands/package/uninstall/report.ts)_
+_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/uninstall/report.ts)_
 
 ## `sf package update`
 
@@ -854,7 +854,7 @@ FLAG DESCRIPTIONS
     the Installed Packages page. Only released package versions can be set as the recommended version.
 ```
 
-_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.8/src/commands/package/update.ts)_
+_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/update.ts)_
 
 ## `sf package version create`
 
@@ -1029,7 +1029,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.24.8/src/commands/package/version/create.ts)_
+_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/version/create.ts)_
 
 ## `sf package version create list`
 
@@ -1090,7 +1090,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.24.8/src/commands/package/version/create/list.ts)_
+_See code: [src/commands/package/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/version/create/list.ts)_
 
 ## `sf package version create report`
 
@@ -1133,7 +1133,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.24.8/src/commands/package/version/create/report.ts)_
+_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/version/create/report.ts)_
 
 ## `sf package version delete`
 
@@ -1174,7 +1174,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.24.8/src/commands/package/version/delete.ts)_
+_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/version/delete.ts)_
 
 ## `sf package version displayancestry`
 
@@ -1234,7 +1234,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.24.8/src/commands/package/version/displayancestry.ts)_
+_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/version/displayancestry.ts)_
 
 ## `sf package version displaydependencies`
 
@@ -1296,7 +1296,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.24.8/src/commands/package/version/displaydependencies.ts)_
+_See code: [src/commands/package/version/displaydependencies.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/version/displaydependencies.ts)_
 
 ## `sf package version list`
 
@@ -1372,7 +1372,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.24.8/src/commands/package/version/list.ts)_
+_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/version/list.ts)_
 
 ## `sf package version promote`
 
@@ -1416,7 +1416,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.24.8/src/commands/package/version/promote.ts)_
+_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/version/promote.ts)_
 
 ## `sf package version report`
 
@@ -1456,7 +1456,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.24.8/src/commands/package/version/report.ts)_
+_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/version/report.ts)_
 
 ## `sf package version retrieve`
 
@@ -1501,7 +1501,7 @@ EXAMPLES
     $ sf package version retrieve --package 04tXXX --output-dir my-directory/ --target-dev-hub devhub@example.com
 ```
 
-_See code: [src/commands/package/version/retrieve.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.8/src/commands/package/version/retrieve.ts)_
+_See code: [src/commands/package/version/retrieve.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/version/retrieve.ts)_
 
 ## `sf package version update`
 
@@ -1554,7 +1554,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.24.8/src/commands/package/version/update.ts)_
+_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package/version/update.ts)_
 
 ## `sf package1 version create`
 
@@ -1621,7 +1621,7 @@ FLAG DESCRIPTIONS
     subscribers.
 ```
 
-_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.8/src/commands/package1/version/create.ts)_
+_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package1/version/create.ts)_
 
 ## `sf package1 version create get`
 
@@ -1654,7 +1654,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.24.8/src/commands/package1/version/create/get.ts)_
+_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package1/version/create/get.ts)_
 
 ## `sf package1 version display`
 
@@ -1688,7 +1688,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.24.8/src/commands/package1/version/display.ts)_
+_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package1/version/display.ts)_
 
 ## `sf package1 version list`
 
@@ -1726,6 +1726,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.24.8/src/commands/package1/version/list.ts)_
+_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.24.9/src/commands/package1/version/list.ts)_
 
 <!-- commandsstop -->

package/oclif.manifest.json

@@ -4353,12 +4353,16 @@
         "list:version:package1"
       ]
     },
-    "package:bundle:version:create": {
+    "package:bundle:install:list": {
       "aliases": [],
       "args": {},
-      "description": "Before you create a new bundle version, create a definition file (similar to a scratch org definition file) that contains the list of package versions to include in the bundle. The definition file must be JSON and you must specify the package versions in the correct order of installation. The package bundle version is based on package versions listed in the definition file.\n\nAfter the first bundle version that you create, make sure to update the version number in the sfdx-project.json file for subsequent bundle versions.\n\nTo retrieve details about a package bundle version create request, including status and package bundle version ID (04t), run \"sf package version create report -i 08c...\".",
+      "description": "Shows the details of each request to install a package bundle version in the target org.\n\nAll filter parameters are applied using the AND logical operator (not OR).\n\nTo get information about a specific request, run \"<%= config.bin %> package bundle install report\" and enter the request ID.",
       "examples": [
-        "Create a package bundle version in the Dev Hub org; uses the Dev Hub org with the username devhub@example.com:\n<%= config.bin %> <%= command.id %> --bundle “Your bundle name” --definition-file resources/definition.json --target-dev-hub devhub@example.com"
+        "List all package bundle installation requests in your default Dev Hub org:\n<%= config.bin %> <%= command.id %>",
+        "List package bundle installation requests from the last 3 days in the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --created-last-days 3 --target-dev-hub devhub@example.com",
+        "List package bundle installation requests with the Error status:\n<%= config.bin %> <%= command.id %> --status Error",
+        "List package bundle installation requests with the Queued status:\n<%= config.bin %> <%= command.id %> --status Queued",
+        "List package bundle install requests from today with the Success status:\n<%= config.bin %> <%= command.id %> --created-last-days 0 --status Success"
       ],
       "flags": {
         "json": {
@@ -4386,43 +4390,17 @@
           "multiple": false,
           "type": "option"
         },
-        "bundle": {
-          "char": "b",
-          "name": "bundle",
-          "required": true,
-          "summary": "Name or ID of the package bundle to create a version for.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "char": "d",
-          "name": "description",
-          "summary": "Description of the package bundle version.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "definition-file": {
-          "char": "p",
-          "name": "definition-file",
-          "required": true,
-          "summary": "Path to a definition file, similar to a scratch org definition file, that contains the list of package versions to include in the bundle.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-dev-hub": {
+        "target-org": {
           "aliases": [
-            "targetdevhubusername",
-            "target-hub-org"
+            "targetusername",
+            "u"
           ],
-          "char": "v",
+          "char": "o",
           "deprecateAliases": true,
-          "name": "target-dev-hub",
+          "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
@@ -4438,84 +4416,89 @@
           "multiple": false,
           "type": "option"
         },
-        "wait": {
-          "char": "w",
-          "name": "wait",
-          "summary": "Number of minutes to wait for the package bundle version to be created.",
-          "default": 0,
+        "created-last-days": {
+          "char": "c",
+          "name": "created-last-days",
+          "summary": "Number of days since the request was created, starting at 0. Use 0 for today.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "char": "s",
+          "name": "status",
+          "summary": "Status of the installation request, used to filter the list.",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "Queued",
+            "InProgress",
+            "Success",
+            "Error"
+          ],
           "type": "option"
         },
         "verbose": {
           "name": "verbose",
-          "summary": "Show verbose output of the command execution.",
+          "summary": "Display additional information, such as the validation text for each package bundle installation request.",
           "allowNo": false,
           "type": "boolean"
-        },
-        "version-number": {
-          "char": "n",
-          "name": "version-number",
-          "summary": "Version number of the package bundle version to be created; overrides the sfdx-project.json value.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hidden": true,
       "hiddenAliases": [],
-      "id": "package:bundle:version:create",
+      "id": "package:bundle:install:list",
       "pluginAlias": "@salesforce/plugin-packaging",
       "pluginName": "@salesforce/plugin-packaging",
       "pluginType": "core",
       "state": "beta",
       "strict": true,
-      "summary": "Create a new package bundle version.",
+      "summary": "List package bundle installation requests.",
       "enableJsonFlag": true,
-      "requiresProject": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "package",
         "bundle",
-        "version",
-        "create.js"
+        "install",
+        "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "package:bundle:version:create",
-        "bundle:package:version:create",
-        "bundle:version:package:create",
-        "bundle:version:create:package",
-        "package:version:bundle:create",
-        "version:package:bundle:create",
-        "version:bundle:package:create",
-        "version:bundle:create:package",
-        "package:version:create:bundle",
-        "version:package:create:bundle",
-        "version:create:package:bundle",
-        "version:create:bundle:package",
-        "package:bundle:create:version",
-        "bundle:package:create:version",
-        "bundle:create:package:version",
-        "bundle:create:version:package",
-        "package:create:bundle:version",
-        "create:package:bundle:version",
-        "create:bundle:package:version",
-        "create:bundle:version:package",
-        "package:create:version:bundle",
-        "create:package:version:bundle",
-        "create:version:package:bundle",
-        "create:version:bundle:package"
+        "package:bundle:install:list",
+        "bundle:package:install:list",
+        "bundle:install:package:list",
+        "bundle:install:list:package",
+        "package:install:bundle:list",
+        "install:package:bundle:list",
+        "install:bundle:package:list",
+        "install:bundle:list:package",
+        "package:install:list:bundle",
+        "install:package:list:bundle",
+        "install:list:package:bundle",
+        "install:list:bundle:package",
+        "package:bundle:list:install",
+        "bundle:package:list:install",
+        "bundle:list:package:install",
+        "bundle:list:install:package",
+        "package:list:bundle:install",
+        "list:package:bundle:install",
+        "list:bundle:package:install",
+        "list:bundle:install:package",
+        "package:list:install:bundle",
+        "list:package:install:bundle",
+        "list:install:package:bundle",
+        "list:install:bundle:package"
       ]
     },
-    "package:bundle:version:list": {
+    "package:bundle:install:report": {
       "aliases": [],
       "args": {},
+      "description": "The command returns information such as the current status of the request and details about the package bundle version being installed.",
       "examples": [
-        "List package bundle versions in the Dev Hub org with the username devhub@example.com:\n<%= config.bin %> <%= command.id %> --target-dev-hub devhub@example.com"
+        "Report on a package bundle installation request:\n<%= config.bin %> <%= command.id %> --package-install-request-id 0Ho0x0000000000000"
       ],
       "flags": {
         "json": {
@@ -4543,17 +4526,17 @@
           "multiple": false,
           "type": "option"
         },
-        "target-dev-hub": {
+        "target-org": {
           "aliases": [
-            "targetdevhubusername",
-            "target-hub-org"
+            "targetusername",
+            "u"
           ],
-          "char": "v",
+          "char": "o",
           "deprecateAliases": true,
-          "name": "target-dev-hub",
+          "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
@@ -4569,9 +4552,19 @@
           "multiple": false,
           "type": "option"
         },
+        "package-install-request-id": {
+          "char": "i",
+          "name": "package-install-request-id",
+          "required": true,
+          "summary": "ID of the package bundle installation request to report on.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "verbose": {
           "name": "verbose",
-          "summary": "Display extended details about the package bundle versions.",
+          "required": false,
+          "summary": "Show verbose output.",
           "allowNo": false,
           "type": "boolean"
         }
@@ -4579,13 +4572,13 @@
       "hasDynamicHelp": true,
       "hidden": true,
       "hiddenAliases": [],
-      "id": "package:bundle:version:list",
+      "id": "package:bundle:install:report",
       "pluginAlias": "@salesforce/plugin-packaging",
       "pluginName": "@salesforce/plugin-packaging",
       "pluginType": "core",
       "state": "beta",
       "strict": true,
-      "summary": "List all package bundle versions in the Dev Hub org.",
+      "summary": "Report on the status of a package bundle installation request.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -4593,42 +4586,43 @@
         "commands",
         "package",
         "bundle",
-        "version",
-        "list.js"
+        "install",
+        "report.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "package:bundle:version:list",
-        "bundle:package:version:list",
-        "bundle:version:package:list",
-        "bundle:version:list:package",
-        "package:version:bundle:list",
-        "version:package:bundle:list",
-        "version:bundle:package:list",
-        "version:bundle:list:package",
-        "package:version:list:bundle",
-        "version:package:list:bundle",
-        "version:list:package:bundle",
-        "version:list:bundle:package",
-        "package:bundle:list:version",
-        "bundle:package:list:version",
-        "bundle:list:package:version",
-        "bundle:list:version:package",
-        "package:list:bundle:version",
-        "list:package:bundle:version",
-        "list:bundle:package:version",
-        "list:bundle:version:package",
-        "package:list:version:bundle",
-        "list:package:version:bundle",
-        "list:version:package:bundle",
-        "list:version:bundle:package"
+        "package:bundle:install:report",
+        "bundle:package:install:report",
+        "bundle:install:package:report",
+        "bundle:install:report:package",
+        "package:install:bundle:report",
+        "install:package:bundle:report",
+        "install:bundle:package:report",
+        "install:bundle:report:package",
+        "package:install:report:bundle",
+        "install:package:report:bundle",
+        "install:report:package:bundle",
+        "install:report:bundle:package",
+        "package:bundle:report:install",
+        "bundle:package:report:install",
+        "bundle:report:package:install",
+        "bundle:report:install:package",
+        "package:report:bundle:install",
+        "report:package:bundle:install",
+        "report:bundle:package:install",
+        "report:bundle:install:package",
+        "package:report:install:bundle",
+        "report:package:install:bundle",
+        "report:install:package:bundle",
+        "report:install:bundle:package"
       ]
     },
-    "package:bundle:version:report": {
+    "package:bundle:version:create": {
       "aliases": [],
       "args": {},
+      "description": "Before you create a new bundle version, create a definition file (similar to a scratch org definition file) that contains the list of package versions to include in the bundle. The definition file must be JSON and you must specify the package versions in the correct order of installation. The package bundle version is based on package versions listed in the definition file.\n\nAfter the first bundle version that you create, make sure to update the version number in the sfdx-project.json file for subsequent bundle versions.\n\nTo retrieve details about a package bundle version create request, including status and package bundle version ID (04t), run \"sf package version create report -i 08c...\".",
       "examples": [
-        "Retrieve details about the package bundle version; uses the Dev Hub org with the username devhub@example.com:\n<%= config.bin %> <%= command.id %> --bundle-version \"Your bundle version name or ID\" --target-dev-hub devhub@example.com"
+        "Create a package bundle version in the Dev Hub org; uses the Dev Hub org with the username devhub@example.com:\n<%= config.bin %> <%= command.id %> --bundle “Your bundle name” --definition-file resources/definition.json --target-dev-hub devhub@example.com"
       ],
       "flags": {
         "json": {
@@ -4656,6 +4650,32 @@
           "multiple": false,
           "type": "option"
         },
+        "bundle": {
+          "char": "b",
+          "name": "bundle",
+          "required": true,
+          "summary": "Name or ID of the package bundle to create a version for.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "name": "description",
+          "summary": "Description of the package bundle version.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "definition-file": {
+          "char": "p",
+          "name": "definition-file",
+          "required": true,
+          "summary": "Path to a definition file, similar to a scratch org definition file, that contains the list of package versions to include in the bundle.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "target-dev-hub": {
           "aliases": [
             "targetdevhubusername",
@@ -4682,8 +4702,252 @@
           "multiple": false,
           "type": "option"
         },
-        "bundle-version": {
-          "char": "b",
+        "wait": {
+          "char": "w",
+          "name": "wait",
+          "summary": "Number of minutes to wait for the package bundle version to be created.",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "name": "verbose",
+          "summary": "Show verbose output of the command execution.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "version-number": {
+          "char": "n",
+          "name": "version-number",
+          "summary": "Version number of the package bundle version to be created; overrides the sfdx-project.json value.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "package:bundle:version:create",
+      "pluginAlias": "@salesforce/plugin-packaging",
+      "pluginName": "@salesforce/plugin-packaging",
+      "pluginType": "core",
+      "state": "beta",
+      "strict": true,
+      "summary": "Create a new package bundle version.",
+      "enableJsonFlag": true,
+      "requiresProject": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "package",
+        "bundle",
+        "version",
+        "create.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "package:bundle:version:create",
+        "bundle:package:version:create",
+        "bundle:version:package:create",
+        "bundle:version:create:package",
+        "package:version:bundle:create",
+        "version:package:bundle:create",
+        "version:bundle:package:create",
+        "version:bundle:create:package",
+        "package:version:create:bundle",
+        "version:package:create:bundle",
+        "version:create:package:bundle",
+        "version:create:bundle:package",
+        "package:bundle:create:version",
+        "bundle:package:create:version",
+        "bundle:create:package:version",
+        "bundle:create:version:package",
+        "package:create:bundle:version",
+        "create:package:bundle:version",
+        "create:bundle:package:version",
+        "create:bundle:version:package",
+        "package:create:version:bundle",
+        "create:package:version:bundle",
+        "create:version:package:bundle",
+        "create:version:bundle:package"
+      ]
+    },
+    "package:bundle:version:list": {
+      "aliases": [],
+      "args": {},
+      "examples": [
+        "List package bundle versions in the Dev Hub org with the username devhub@example.com:\n<%= config.bin %> <%= command.id %> --target-dev-hub devhub@example.com"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "loglevel": {
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
+          },
+          "hidden": true,
+          "name": "loglevel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-dev-hub": {
+          "aliases": [
+            "targetdevhubusername",
+            "target-hub-org"
+          ],
+          "char": "v",
+          "deprecateAliases": true,
+          "name": "target-dev-hub",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "aliases": [
+            "apiversion"
+          ],
+          "deprecateAliases": true,
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "name": "verbose",
+          "summary": "Display extended details about the package bundle versions.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "package:bundle:version:list",
+      "pluginAlias": "@salesforce/plugin-packaging",
+      "pluginName": "@salesforce/plugin-packaging",
+      "pluginType": "core",
+      "state": "beta",
+      "strict": true,
+      "summary": "List all package bundle versions in the Dev Hub org.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "package",
+        "bundle",
+        "version",
+        "list.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "package:bundle:version:list",
+        "bundle:package:version:list",
+        "bundle:version:package:list",
+        "bundle:version:list:package",
+        "package:version:bundle:list",
+        "version:package:bundle:list",
+        "version:bundle:package:list",
+        "version:bundle:list:package",
+        "package:version:list:bundle",
+        "version:package:list:bundle",
+        "version:list:package:bundle",
+        "version:list:bundle:package",
+        "package:bundle:list:version",
+        "bundle:package:list:version",
+        "bundle:list:package:version",
+        "bundle:list:version:package",
+        "package:list:bundle:version",
+        "list:package:bundle:version",
+        "list:bundle:package:version",
+        "list:bundle:version:package",
+        "package:list:version:bundle",
+        "list:package:version:bundle",
+        "list:version:package:bundle",
+        "list:version:bundle:package"
+      ]
+    },
+    "package:bundle:version:report": {
+      "aliases": [],
+      "args": {},
+      "examples": [
+        "Retrieve details about the package bundle version; uses the Dev Hub org with the username devhub@example.com:\n<%= config.bin %> <%= command.id %> --bundle-version \"Your bundle version name or ID\" --target-dev-hub devhub@example.com"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "loglevel": {
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
+          },
+          "hidden": true,
+          "name": "loglevel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-dev-hub": {
+          "aliases": [
+            "targetdevhubusername",
+            "target-hub-org"
+          ],
+          "char": "v",
+          "deprecateAliases": true,
+          "name": "target-dev-hub",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "aliases": [
+            "apiversion"
+          ],
+          "deprecateAliases": true,
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "bundle-version": {
+          "char": "b",
           "name": "bundle-version",
           "required": true,
           "summary": "Name or ID of the package bundle version to retrieve details about.",
@@ -5505,270 +5769,6 @@
         "get:create:version:package1"
       ]
     },
-    "package:bundle:install:list": {
-      "aliases": [],
-      "args": {},
-      "description": "Shows the details of each request to install a package bundle version in the target org.\n\nAll filter parameters are applied using the AND logical operator (not OR).\n\nTo get information about a specific request, run \"<%= config.bin %> package bundle install report\" and enter the request ID.",
-      "examples": [
-        "List all package bundle installation requests in your default Dev Hub org:\n<%= config.bin %> <%= command.id %>",
-        "List package bundle installation requests from the last 3 days in the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --created-last-days 3 --target-dev-hub devhub@example.com",
-        "List package bundle installation requests with the Error status:\n<%= config.bin %> <%= command.id %> --status Error",
-        "List package bundle installation requests with the Queued status:\n<%= config.bin %> <%= command.id %> --status Queued",
-        "List package bundle install requests from today with the Success status:\n<%= config.bin %> <%= command.id %> --created-last-days 0 --status Success"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "loglevel": {
-          "deprecated": {
-            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
-          },
-          "hidden": true,
-          "name": "loglevel",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-org": {
-          "aliases": [
-            "targetusername",
-            "u"
-          ],
-          "char": "o",
-          "deprecateAliases": true,
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "aliases": [
-            "apiversion"
-          ],
-          "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "created-last-days": {
-          "char": "c",
-          "name": "created-last-days",
-          "summary": "Number of days since the request was created, starting at 0. Use 0 for today.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "status": {
-          "char": "s",
-          "name": "status",
-          "summary": "Status of the installation request, used to filter the list.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "Queued",
-            "InProgress",
-            "Success",
-            "Error"
-          ],
-          "type": "option"
-        },
-        "verbose": {
-          "name": "verbose",
-          "summary": "Display additional information, such as the validation text for each package bundle installation request.",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "package:bundle:install:list",
-      "pluginAlias": "@salesforce/plugin-packaging",
-      "pluginName": "@salesforce/plugin-packaging",
-      "pluginType": "core",
-      "state": "beta",
-      "strict": true,
-      "summary": "List package bundle installation requests.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "package",
-        "bundle",
-        "install",
-        "list.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "package:bundle:install:list",
-        "bundle:package:install:list",
-        "bundle:install:package:list",
-        "bundle:install:list:package",
-        "package:install:bundle:list",
-        "install:package:bundle:list",
-        "install:bundle:package:list",
-        "install:bundle:list:package",
-        "package:install:list:bundle",
-        "install:package:list:bundle",
-        "install:list:package:bundle",
-        "install:list:bundle:package",
-        "package:bundle:list:install",
-        "bundle:package:list:install",
-        "bundle:list:package:install",
-        "bundle:list:install:package",
-        "package:list:bundle:install",
-        "list:package:bundle:install",
-        "list:bundle:package:install",
-        "list:bundle:install:package",
-        "package:list:install:bundle",
-        "list:package:install:bundle",
-        "list:install:package:bundle",
-        "list:install:bundle:package"
-      ]
-    },
-    "package:bundle:install:report": {
-      "aliases": [],
-      "args": {},
-      "description": "The command returns information such as the current status of the request and details about the package bundle version being installed.",
-      "examples": [
-        "Report on a package bundle installation request:\n<%= config.bin %> <%= command.id %> --package-install-request-id 0Ho0x0000000000000"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "loglevel": {
-          "deprecated": {
-            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
-          },
-          "hidden": true,
-          "name": "loglevel",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-org": {
-          "aliases": [
-            "targetusername",
-            "u"
-          ],
-          "char": "o",
-          "deprecateAliases": true,
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "aliases": [
-            "apiversion"
-          ],
-          "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "package-install-request-id": {
-          "char": "i",
-          "name": "package-install-request-id",
-          "required": true,
-          "summary": "ID of the package bundle installation request to report on.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "verbose": {
-          "name": "verbose",
-          "required": false,
-          "summary": "Show verbose output.",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "package:bundle:install:report",
-      "pluginAlias": "@salesforce/plugin-packaging",
-      "pluginName": "@salesforce/plugin-packaging",
-      "pluginType": "core",
-      "state": "beta",
-      "strict": true,
-      "summary": "Report on the status of a package bundle installation request.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "package",
-        "bundle",
-        "install",
-        "report.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "package:bundle:install:report",
-        "bundle:package:install:report",
-        "bundle:install:package:report",
-        "bundle:install:report:package",
-        "package:install:bundle:report",
-        "install:package:bundle:report",
-        "install:bundle:package:report",
-        "install:bundle:report:package",
-        "package:install:report:bundle",
-        "install:package:report:bundle",
-        "install:report:package:bundle",
-        "install:report:bundle:package",
-        "package:bundle:report:install",
-        "bundle:package:report:install",
-        "bundle:report:package:install",
-        "bundle:report:install:package",
-        "package:report:bundle:install",
-        "report:package:bundle:install",
-        "report:bundle:package:install",
-        "report:bundle:install:package",
-        "package:report:install:bundle",
-        "report:package:install:bundle",
-        "report:install:package:bundle",
-        "report:install:bundle:package"
-      ]
-    },
     "package:bundle:version:create:list": {
       "aliases": [],
       "args": {},
@@ -6221,5 +6221,5 @@
       ]
     }
   },
-  "version": "2.24.8"
+  "version": "2.24.9"
 }

package/package.json

@@ -1,12 +1,12 @@
 {
     "name": "@salesforce/plugin-packaging",
     "description": "SF plugin that support Salesforce Packaging Platform",
-    "version": "2.24.8",
+    "version": "2.24.9",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "dependencies": {
         "@oclif/core": "^4",
-        "@salesforce/core": "^8.24.3",
+        "@salesforce/core": "^8.25.0",
         "@salesforce/kit": "^3.2.4",
         "@salesforce/packaging": "^4.18.8",
         "@salesforce/sf-plugins-core": "^12.2.6",
@@ -19,7 +19,7 @@
         "@salesforce/plugin-command-reference": "^3.1.79",
         "eslint-plugin-sf-plugin": "^1.20.32",
         "minimatch": "^10.1.1",
-        "oclif": "^4.22.65",
+        "oclif": "^4.22.68",
         "ts-node": "^10.9.2",
         "typescript": "^5.9.3"
     },
@@ -248,7 +248,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.24.8.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.24.8.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.24.9.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.24.9.sig"
     }
 }