@salesforce/plugin-packaging 2.25.17 → 2.26.0

package/oclif.manifest.json

@@ -1500,6 +1500,121 @@
         "list:bundle:package"
       ]
     },
+    "package:bundle:uninstall": {
+      "aliases": [],
+      "args": {},
+      "description": "Provide the package bundle version ID or alias and the target org to start an uninstall request. Optionally wait for the uninstall to complete.",
+      "examples": [
+        "Uninstall a bundle version by ID from a specified org:\n<%= config.bin %> <%= command.id %> --bundle 1Q8... --target-org me@example.com",
+        "Uninstall a bundle version by alias from your default org and wait up to 10 minutes for completion:\n<%= config.bin %> <%= command.id %> --bundle MyBundle@1.2 -w 10"
+      ],
+      "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"
+        },
+        "bundle": {
+          "char": "b",
+          "name": "bundle",
+          "required": true,
+          "summary": "ID (starts with 1Q8) or alias of the package bundle version to uninstall.",
+          "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"
+        },
+        "wait": {
+          "char": "w",
+          "name": "wait",
+          "summary": "Number of minutes to wait for the uninstall request to complete.",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "name": "verbose",
+          "summary": "Show additional progress while waiting for uninstall to finish.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "package:bundle:uninstall",
+      "pluginAlias": "@salesforce/plugin-packaging",
+      "pluginName": "@salesforce/plugin-packaging",
+      "pluginType": "core",
+      "state": "beta",
+      "strict": true,
+      "summary": "Uninstall a package bundle version from a target org.",
+      "enableJsonFlag": true,
+      "requiresProject": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "package",
+        "bundle",
+        "uninstall.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "package:bundle:uninstall",
+        "bundle:package:uninstall",
+        "bundle:uninstall:package",
+        "package:uninstall:bundle",
+        "uninstall:package:bundle",
+        "uninstall:bundle:package"
+      ]
+    },
     "package:install:report": {
       "aliases": [
         "force:package:install:report"
@@ -4359,16 +4474,12 @@
         "list:version:package1"
       ]
     },
-    "package:bundle:install:list": {
+    "package:bundle:install:report": {
       "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.",
+      "description": "The command returns information such as the current status of the request and details about the package bundle version being installed.",
       "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"
+        "Report on a package bundle installation request:\n<%= config.bin %> <%= command.id %> --package-install-request-id 0Ho0x0000000000000"
       ],
       "flags": {
         "json": {
@@ -4422,31 +4533,19 @@
           "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.",
+        "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,
-          "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.",
+          "required": false,
+          "summary": "Show verbose output.",
           "allowNo": false,
           "type": "boolean"
         }
@@ -4454,13 +4553,13 @@
       "hasDynamicHelp": true,
       "hidden": true,
       "hiddenAliases": [],
-      "id": "package:bundle:install:list",
+      "id": "package:bundle:install:report",
       "pluginAlias": "@salesforce/plugin-packaging",
       "pluginName": "@salesforce/plugin-packaging",
       "pluginType": "core",
       "state": "beta",
       "strict": true,
-      "summary": "List package bundle installation requests.",
+      "summary": "Report on the status of a package bundle installation request.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -4469,42 +4568,43 @@
         "package",
         "bundle",
         "install",
-        "list.js"
+        "report.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",
+        "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:install:report": {
+    "package:bundle:installed:list": {
       "aliases": [],
       "args": {},
-      "description": "The command returns information such as the current status of the request and details about the package bundle version being installed.",
+      "description": "Displays information about all package bundles currently installed in the target org, including the bundle details and the associated packages with their expected and actual versions.",
       "examples": [
-        "Report on a package bundle installation request:\n<%= config.bin %> <%= command.id %> --package-install-request-id 0Ho0x0000000000000"
+        "List all installed package bundles in your default org:\n<%= config.bin %> <%= command.id %>",
+        "List all installed package bundles in a specific org:\n<%= config.bin %> <%= command.id %> --target-org myorg@example.com"
       ],
       "flags": {
         "json": {
@@ -4557,34 +4657,18 @@
           "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",
+      "id": "package:bundle:installed:list",
       "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.",
+      "summary": "List all installed package bundles in the target org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -4592,35 +4676,35 @@
         "commands",
         "package",
         "bundle",
-        "install",
-        "report.js"
+        "installed",
+        "list.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:installed:list",
+        "bundle:package:installed:list",
+        "bundle:installed:package:list",
+        "bundle:installed:list:package",
+        "package:installed:bundle:list",
+        "installed:package:bundle:list",
+        "installed:bundle:package:list",
+        "installed:bundle:list:package",
+        "package:installed:list:bundle",
+        "installed:package:list:bundle",
+        "installed:list:package:bundle",
+        "installed:list:bundle:package",
+        "package:bundle:list:installed",
+        "bundle:package:list:installed",
+        "bundle:list:package:installed",
+        "bundle:list:installed:package",
+        "package:list:bundle:installed",
+        "list:package:bundle:installed",
+        "list:bundle:package:installed",
+        "list:bundle:installed:package",
+        "package:list:installed:bundle",
+        "list:package:installed:bundle",
+        "list:installed:package:bundle",
+        "list:installed:bundle:package"
       ]
     },
     "package:bundle:version:create": {
@@ -6227,5 +6311,5 @@
       ]
     }
   },
-  "version": "2.25.17"
+  "version": "2.26.0"
 }

package/package.json

@@ -1,27 +1,27 @@
 {
     "name": "@salesforce/plugin-packaging",
     "description": "SF plugin that support Salesforce Packaging Platform",
-    "version": "2.25.17",
+    "version": "2.26.0",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "enableO11y": true,
     "o11yUploadEndpoint": "https://794testsite.my.site.com/byolwr/webruntime/log/metrics",
     "dependencies": {
         "@oclif/core": "^4",
-        "@salesforce/core": "^8.27.0",
+        "@salesforce/core": "^8.27.1",
         "@salesforce/kit": "^3.2.6",
-        "@salesforce/packaging": "^4.21.10",
+        "@salesforce/packaging": "^4.22.0",
         "@salesforce/sf-plugins-core": "^12.2.6",
         "chalk": "^5.6.2"
     },
     "devDependencies": {
         "@oclif/plugin-command-snapshot": "^5.3.13",
-        "@salesforce/cli-plugins-testkit": "^5.3.41",
+        "@salesforce/cli-plugins-testkit": "^5.3.50",
         "@salesforce/dev-scripts": "^11.0.4",
         "@salesforce/plugin-command-reference": "^3.1.82",
         "eslint-plugin-sf-plugin": "^1.20.32",
         "minimatch": "^10.2.4",
-        "oclif": "^4.22.93",
+        "oclif": "^4.22.96",
         "ts-node": "^10.9.2",
         "typescript": "^5.9.3"
     },
@@ -250,7 +250,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.25.17.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.25.17.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.26.0.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.26.0.sig"
     }
 }

package/schemas/package-bundle-installed-list.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/PackageBundleInstalledListResults",
+  "definitions": {
+    "PackageBundleInstalledListResults": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/BundleSObjects.InstalledPackageBundleVersion"
+      }
+    },
+    "BundleSObjects.InstalledPackageBundleVersion": {
+      "type": "object",
+      "properties": {
+        "Id": {
+          "type": "string"
+        },
+        "BundleName": {
+          "type": "string"
+        },
+        "BundleId": {
+          "type": "string"
+        },
+        "BundleVersionId": {
+          "type": "string"
+        },
+        "BundleVersionName": {
+          "type": "string"
+        },
+        "MajorVersion": {
+          "type": "number"
+        },
+        "MinorVersion": {
+          "type": "number"
+        },
+        "Description": {
+          "type": "string"
+        },
+        "InstalledDate": {
+          "type": "string"
+        },
+        "LastUpgradedDate": {
+          "type": "string"
+        },
+        "Components": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/BundleSObjects.InstalledPackageBundleVersionComponent"
+          }
+        }
+      },
+      "required": [
+        "Id",
+        "BundleName",
+        "BundleId",
+        "BundleVersionId",
+        "BundleVersionName",
+        "MajorVersion",
+        "MinorVersion",
+        "Description",
+        "InstalledDate",
+        "LastUpgradedDate",
+        "Components"
+      ],
+      "additionalProperties": false
+    },
+    "BundleSObjects.InstalledPackageBundleVersionComponent": {
+      "type": "object",
+      "properties": {
+        "ExpectedPackageName": {
+          "type": "string"
+        },
+        "ExpectedPackageVersionNumber": {
+          "type": "string"
+        },
+        "ActualPackageName": {
+          "type": "string"
+        },
+        "ActualPackageVersionNumber": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "ExpectedPackageName",
+        "ExpectedPackageVersionNumber",
+        "ActualPackageName",
+        "ActualPackageVersionNumber"
+      ],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/{package-bundle-install-list.json → package-bundle-uninstall.json}

@@ -1,25 +1,19 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$ref": "#/definitions/PackageBundleInstallRequestResults",
+  "$ref": "#/definitions/BundleUninstallResult",
   "definitions": {
-    "PackageBundleInstallRequestResults": {
-      "type": "array",
-      "items": {
-        "$ref": "#/definitions/BundleSObjects.PkgBundleVersionInstallReqResult"
-      }
+    "BundleUninstallResult": {
+      "$ref": "#/definitions/BundleSObjects.PkgBundleVerUninstallReqResult"
     },
-    "BundleSObjects.PkgBundleVersionInstallReqResult": {
+    "BundleSObjects.PkgBundleVerUninstallReqResult": {
       "type": "object",
       "additionalProperties": false,
       "properties": {
         "Id": {
           "type": "string"
         },
-        "InstallStatus": {
-          "$ref": "#/definitions/BundleSObjects.PkgBundleVersionInstallReqStatus"
-        },
-        "ValidationError": {
-          "type": "string"
+        "UninstallStatus": {
+          "$ref": "#/definitions/BundleSObjects.PkgBundleVersionUninstallReqStatus"
         },
         "CreatedDate": {
           "type": "string"
@@ -36,28 +30,18 @@
         "PackageBundleVersionId": {
           "type": "string"
         },
-        "DevelopmentOrganization": {
+        "InstalledPkgBundleVersionId": {
+          "type": "string"
+        },
+        "ValidationError": {
           "type": "string"
         }
       },
-      "required": [
-        "CreatedById",
-        "CreatedDate",
-        "DevelopmentOrganization",
-        "Id",
-        "InstallStatus",
-        "PackageBundleVersionId",
-        "ValidationError"
-      ]
+      "required": ["CreatedById", "CreatedDate", "Id", "PackageBundleVersionId", "UninstallStatus"]
     },
-    "BundleSObjects.PkgBundleVersionInstallReqStatus": {
+    "BundleSObjects.PkgBundleVersionUninstallReqStatus": {
       "type": "string",
-      "enum": [
-        "Queued",
-        "InProgress",
-        "Success",
-        "Error"
-      ]
+      "enum": ["Queued", "InProgress", "Success", "Error"]
     }
   }
-}
+}

package/lib/commands/package/bundle/install/list.js

@@ -1,82 +0,0 @@
-/*
- * Copyright 2026, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { Flags, loglevel, orgApiVersionFlagWithDeprecations, requiredOrgFlagWithDeprecations, SfCommand, } from '@salesforce/sf-plugins-core';
-import { Messages } from '@salesforce/core';
-import { BundleSObjects, PackageBundleInstall } from '@salesforce/packaging';
-import chalk from 'chalk';
-Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
-const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'bundle_install_list');
-export class PackageBundleInstallListCommand extends SfCommand {
-    static hidden = true;
-    static state = 'beta';
-    static summary = messages.getMessage('summary');
-    static description = messages.getMessage('description');
-    static examples = messages.getMessages('examples');
-    static flags = {
-        loglevel,
-        'target-org': requiredOrgFlagWithDeprecations,
-        'api-version': orgApiVersionFlagWithDeprecations,
-        'created-last-days': Flags.integer({
-            char: 'c',
-            summary: messages.getMessage('flags.created-last-days.summary'),
-        }),
-        status: Flags.custom({
-            options: [
-                BundleSObjects.PkgBundleVersionInstallReqStatus.queued,
-                BundleSObjects.PkgBundleVersionInstallReqStatus.inProgress,
-                BundleSObjects.PkgBundleVersionInstallReqStatus.success,
-                BundleSObjects.PkgBundleVersionInstallReqStatus.error,
-            ],
-        })({
-            char: 's',
-            summary: messages.getMessage('flags.status.summary'),
-        }),
-        verbose: Flags.boolean({
-            summary: messages.getMessage('flags.verbose.summary'),
-        }),
-    };
-    connection;
-    async run() {
-        const { flags } = await this.parse(PackageBundleInstallListCommand);
-        this.connection = flags['target-org'].getConnection(flags['api-version']);
-        const results = await PackageBundleInstall.getInstallStatuses(this.connection, flags.status, flags['created-last-days']);
-        if (results.length === 0) {
-            this.warn('No results found');
-        }
-        else {
-            const data = results.map((r) => ({
-                Id: r.Id ?? 'N/A',
-                Status: r.InstallStatus ?? 'Unknown',
-                'Package Bundle Version Id': r.PackageBundleVersionId ?? 'N/A',
-                'Development Organization': r.DevelopmentOrganization ?? 'N/A',
-                'Created Date': r.CreatedDate ?? 'N/A',
-                'Created By': r.CreatedById ?? 'N/A',
-                ...(flags.verbose
-                    ? {
-                        'Validation Error': r.ValidationError ?? 'N/A',
-                    }
-                    : {}),
-            }));
-            this.table({
-                data,
-                overflow: 'wrap',
-                title: chalk.blue(`Package Bundle Install Requests  [${results.length}]`),
-            });
-        }
-        return results;
-    }
-}
-//# sourceMappingURL=list.js.map