@W-19441295 Merge bundles CLI - plugin side

command-snapshot.json

@@ -55,6 +55,126 @@
     "flags": ["api-version", "flags-dir", "json", "loglevel", "package-id", "target-org"],
     "plugin": "@salesforce/plugin-packaging"
   },
+  {
+    "alias": [],
+    "command": "package:bundle:create",
+    "flagAliases": ["apiversion", "target-hub-org", "targetdevhubusername"],
+    "flagChars": ["d", "n", "v"],
+    "flags": ["api-version", "description", "flags-dir", "json", "loglevel", "name", "target-dev-hub"],
+    "plugin": "@salesforce/plugin-packaging"
+  },
+  {
+    "alias": [],
+    "command": "package:bundle:delete",
+    "flagAliases": ["apiversion", "target-hub-org", "targetdevhubusername"],
+    "flagChars": ["b", "n", "v"],
+    "flags": ["api-version", "bundle", "flags-dir", "json", "loglevel", "no-prompt", "target-dev-hub"],
+    "plugin": "@salesforce/plugin-packaging"
+  },
+  {
+    "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"
+    ],
+    "plugin": "@salesforce/plugin-packaging"
+  },
+  {
+    "alias": [],
+    "command": "package:bundle:install:list",
+    "flagAliases": ["apiversion", "targetusername", "u"],
+    "flagChars": ["c", "o", "s"],
+    "flags": ["api-version", "created-last-days", "flags-dir", "json", "loglevel", "status", "target-org", "verbose"],
+    "plugin": "@salesforce/plugin-packaging"
+  },
+  {
+    "alias": [],
+    "command": "package:bundle:install:report",
+    "flagAliases": ["apiversion", "targetusername", "u"],
+    "flagChars": ["i", "o"],
+    "flags": ["api-version", "flags-dir", "json", "loglevel", "package-install-request-id", "target-org", "verbose"],
+    "plugin": "@salesforce/plugin-packaging"
+  },
+  {
+    "alias": [],
+    "command": "package:bundle:list",
+    "flagAliases": ["apiversion", "target-hub-org", "targetdevhubusername"],
+    "flagChars": ["v"],
+    "flags": ["api-version", "flags-dir", "json", "loglevel", "target-dev-hub", "verbose"],
+    "plugin": "@salesforce/plugin-packaging"
+  },
+  {
+    "alias": [],
+    "command": "package:bundle:version:create",
+    "flagAliases": ["apiversion", "target-hub-org", "targetdevhubusername"],
+    "flagChars": ["b", "d", "n", "p", "v", "w"],
+    "flags": [
+      "api-version",
+      "bundle",
+      "definition-file",
+      "description",
+      "flags-dir",
+      "json",
+      "loglevel",
+      "target-dev-hub",
+      "verbose",
+      "version-number",
+      "wait"
+    ],
+    "plugin": "@salesforce/plugin-packaging"
+  },
+  {
+    "alias": [],
+    "command": "package:bundle:version:create:list",
+    "flagAliases": ["apiversion", "target-hub-org", "targetdevhubusername"],
+    "flagChars": ["c", "s", "v"],
+    "flags": [
+      "api-version",
+      "created-last-days",
+      "flags-dir",
+      "json",
+      "loglevel",
+      "show-conversions-only",
+      "status",
+      "target-dev-hub",
+      "verbose"
+    ],
+    "plugin": "@salesforce/plugin-packaging"
+  },
+  {
+    "alias": [],
+    "command": "package:bundle:version:create:report",
+    "flagAliases": ["apiversion", "target-hub-org", "targetdevhubusername"],
+    "flagChars": ["i", "v"],
+    "flags": ["api-version", "bundle-version-create-request-id", "flags-dir", "json", "loglevel", "target-dev-hub"],
+    "plugin": "@salesforce/plugin-packaging"
+  },
+  {
+    "alias": [],
+    "command": "package:bundle:version:list",
+    "flagAliases": ["apiversion", "target-hub-org", "targetdevhubusername"],
+    "flagChars": ["v"],
+    "flags": ["api-version", "flags-dir", "json", "loglevel", "target-dev-hub", "verbose"],
+    "plugin": "@salesforce/plugin-packaging"
+  },
+  {
+    "alias": [],
+    "command": "package:bundle:version:report",
+    "flagAliases": ["apiversion", "target-hub-org", "targetdevhubusername"],
+    "flagChars": ["b", "v"],
+    "flags": ["api-version", "bundle-version", "flags-dir", "json", "loglevel", "target-dev-hub", "verbose"],
+    "plugin": "@salesforce/plugin-packaging"
+  },
   {
     "alias": ["force:package:convert"],
     "command": "package:convert",
@@ -66,13 +186,13 @@
       "installationkeybypass",
       "patchversion",
       "target-hub-org",
-      "targetdevhubusername",
-      "codecoverage"
+      "targetdevhubusername"
     ],
-    "flagChars": ["a", "f", "k", "m", "p", "s", "v", "w", "x", "c"],
+    "flagChars": ["a", "c", "f", "k", "m", "p", "s", "v", "w", "x"],
     "flags": [
       "api-version",
       "build-instance",
+      "code-coverage",
       "definition-file",
       "flags-dir",
       "installation-key",
@@ -84,8 +204,7 @@
       "seed-metadata",
       "target-dev-hub",
       "verbose",
-      "wait",
-      "code-coverage"
+      "wait"
     ],
     "plugin": "@salesforce/plugin-packaging"
   },

messages/bundle_create.md

@@ -0,0 +1,42 @@
+# summary
+
+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.
+
+# examples
+
+Create a package bundle in the Dev Hub org; uses the Dev Hub org with the username devhub@example.com:
+
+sf package bundle create --name "Your bundle name" --description "Your bundle description" --target-dev-hub devhub@example.com
+
+# flags.name.summary
+
+Name of the package bundle.
+
+# flags.description.summary
+
+Description of the package bundle.
+
+# flags.wait.summary
+
+Number of minutes to wait for the bundle creation to complete.
+
+# flags.verbose.summary
+
+Display extended bundle creation detail.
+
+# requestInProgress
+
+Creating bundle.
+
+# bundleCreateWaitingStatus
+
+%d minutes remaining until timeout. Create bundle status: %s
+
+# bundleCreateFinalStatus
+
+Create bundle status: %s

messages/bundle_install.md

@@ -0,0 +1,58 @@
+# summary
+
+Install a package bundle version in the target org.
+
+# description
+
+Install a specific version of a package bundle in the target org. During developer preview, bundles can be installed only in scratch orgs.
+
+# examples
+
+Install a package bundle version in a scratch org:
+
+sf package bundle install --bundle MyPkgBundle1@0.1 --target-org my-scratch-org --wait 10
+
+# flags.bundle.summary
+
+Package bundle version to install (format: BundleName@Version).
+
+# flags.target-org.summary
+
+Target org for the bundle installation.
+
+# flags.target-dev-hub.summary
+
+Username, alias, or org ID of the target dev hub org.
+
+# flags.wait.summary
+
+Number of minutes to wait for the installation to complete.
+
+# flags.verbose.summary
+
+Display extended installation detail.
+
+# requestInProgress
+
+Installing bundle.
+
+# bundleInstallWaitingStatus
+
+%d minutes remaining until timeout. Install status: %s
+
+# bundleInstallFinalStatus
+
+Install status: %s
+
+# bundleInstallSuccess
+
+Successfully installed bundle [%s]
+
+# bundleInstallError
+
+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

messages/bundle_install_list.md

@@ -0,0 +1,69 @@
+# summary
+
+List package bundle installation requests.
+
+# description
+
+Shows the details of each request to install a package bundle version in the target org.
+
+All filter parameters are applied using the AND logical operator (not OR).
+
+To get information about a specific request, run "<%= config.bin %> package bundle install report" and supply the request ID.
+
+# flags.status.summary
+
+Status of the installation request, used to filter the list.
+
+# flags.verbose.summary
+
+Displays additional information at a slight performance cost, such as validation text for each package bundle install request.
+
+# flags.created-last-days.summary
+
+Number of days since the request was created, starting at 00:00:00 of first day to now. Use 0 for today.
+
+# examples
+
+- List all package bundle installation requests in your default Dev Hub org:
+
+  <%= config.bin %> <%= command.id %>
+
+- List package bundle installation requests from the last 3 days in the Dev Hub org with username devhub@example.com:
+
+  <%= config.bin %> <%= command.id %> --created-last-days 3 --target-dev-hub
+
+- List package bundle installation requests with status Error:
+
+  <%= config.bin %> <%= command.id %> --status Error
+
+- List package bundle installation requests with status Queued:
+
+  <%= config.bin %> <%= command.id %> --status Queued
+
+- List package bundle installation requests with status Success that were created today:
+
+  <%= config.bin %> <%= command.id %> --created-last-days 0 --status Success
+
+# id
+
+ID
+
+# status
+
+Status
+
+# package-bundle-version-id
+
+Package Bundle Version ID
+
+# development-organization
+
+Development Organization
+
+# created-by
+
+Created By
+
+# validation-error
+
+Validation Error

messages/bundle_install_report.md

@@ -0,0 +1,53 @@
+# summary
+
+Report on the status of a package bundle installation request.
+
+# description
+
+Use this command to check the status of a package bundle installation request. The command returns information about the request, including its current status and details about the package bundle version being installed.
+
+# examples
+
+- Report on a package bundle installation request:
+
+  <%= config.bin %> <%= command.id %> --package-install-request-id 0Ho0x0000000000000
+
+- Report on a package bundle installation request using an alias:
+
+  <%= config.bin %> force:package:bundle:install:report -i 0Ho0x0000000000000
+
+# flags.package-install-request-id.summary
+
+The ID of the package bundle installation request to report on.
+
+# id
+
+ID
+
+# status
+
+Status
+
+# package-bundle-version-id
+
+Package Bundle Version ID
+
+# development-organization
+
+Development Organization
+
+# validation-error
+
+Validation Error
+
+# created-date
+
+Created Date
+
+# created-by
+
+Created By
+
+# flags.verbose.summary
+
+Show verbose output.