@salesforce/plugin-packaging 2.20.6-preview.0 → 2.22.0

package/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.6-preview.0/src/commands/package/convert.ts)_
+_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/create.ts)_
+_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/delete.ts)_
+_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/install.ts)_
+_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/install/report.ts)_
+_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/installed/list.ts)_
+_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/list.ts)_
+_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/push-upgrade/abort.ts)_
+_See code: [src/commands/package/push-upgrade/abort.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/push-upgrade/list.ts)_
+_See code: [src/commands/package/push-upgrade/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/push-upgrade/report.ts)_
+_See code: [src/commands/package/push-upgrade/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/push-upgrade/schedule.ts)_
+_See code: [src/commands/package/push-upgrade/schedule.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/uninstall.ts)_
+_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/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.6-preview.0/src/commands/package/uninstall/report.ts)_
+_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/uninstall/report.ts)_
 
 ## `sf package update`
 
@@ -794,7 +794,7 @@ Update package details.
 ```
 USAGE
   $ sf package update -v <value> -p <value> [--json] [--flags-dir <value>] [--api-version <value>] [-n <value>] [-d
-    <value>] [-o <value>] [--enable-app-analytics]
+    <value>] [-o <value>] [--enable-app-analytics] [-r <value>] [--skip-ancestor-check]
 
 FLAGS
   -d, --description=<value>                  New description of the package.
@@ -802,11 +802,13 @@ FLAGS
   -o, --error-notification-username=<value>  Active Dev Hub user designated to receive email notifications for package
                                              errors.
   -p, --package=<value>                      (required) ID (starts with 0Ho) or alias of the package to update.
+  -r, --recommended-version-id=<value>       Package version ID that subscribers are notified to install or upgrade to.
   -v, --target-dev-hub=<value>               (required) Username or alias of the Dev Hub org. Not required if the
                                              `target-dev-hub` configuration variable is already set.
       --api-version=<value>                  Override the api version used for api requests made by this command
       --[no-]enable-app-analytics            Enable AppExchange App Analytics usage data collection on this managed
                                              package and its components.
+      --skip-ancestor-check                  Bypass the ancestry check for setting a recommended version.
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
@@ -838,9 +840,15 @@ FLAG DESCRIPTIONS
 
     Email notifications include information about unhandled Apex exceptions, and install, upgrade, or uninstall failures
     associated with your package.
+
+  -r, --recommended-version-id=<value>  Package version ID that subscribers are notified to install or upgrade to.
+
+    Specify the recommended package version for subscribers to install. Subscribers are notified to install the package
+    version ID that you specify. If the subscribers have a different version of the same package installed, they're
+    notified to upgrade to the recommended version.
 ```
 
-_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6-preview.0/src/commands/package/update.ts)_
+_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/update.ts)_
 
 ## `sf package version create`
 
@@ -1015,7 +1023,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.6-preview.0/src/commands/package/version/create.ts)_
+_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/version/create.ts)_
 
 ## `sf package version create list`
 
@@ -1076,7 +1084,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.6-preview.0/src/commands/package/version/create/list.ts)_
+_See code: [src/commands/package/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/version/create/list.ts)_
 
 ## `sf package version create report`
 
@@ -1119,7 +1127,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.6-preview.0/src/commands/package/version/create/report.ts)_
+_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/version/create/report.ts)_
 
 ## `sf package version delete`
 
@@ -1160,7 +1168,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.6-preview.0/src/commands/package/version/delete.ts)_
+_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/version/delete.ts)_
 
 ## `sf package version displayancestry`
 
@@ -1220,7 +1228,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.6-preview.0/src/commands/package/version/displayancestry.ts)_
+_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/version/displayancestry.ts)_
 
 ## `sf package version displaydependencies`
 
@@ -1282,7 +1290,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.6-preview.0/src/commands/package/version/displaydependencies.ts)_
+_See code: [src/commands/package/version/displaydependencies.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/version/displaydependencies.ts)_
 
 ## `sf package version list`
 
@@ -1358,7 +1366,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.6-preview.0/src/commands/package/version/list.ts)_
+_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/version/list.ts)_
 
 ## `sf package version promote`
 
@@ -1402,7 +1410,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.6-preview.0/src/commands/package/version/promote.ts)_
+_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/version/promote.ts)_
 
 ## `sf package version report`
 
@@ -1442,7 +1450,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.6-preview.0/src/commands/package/version/report.ts)_
+_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/version/report.ts)_
 
 ## `sf package version update`
 
@@ -1495,7 +1503,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.6-preview.0/src/commands/package/version/update.ts)_
+_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package/version/update.ts)_
 
 ## `sf package1 version create`
 
@@ -1562,7 +1570,7 @@ FLAG DESCRIPTIONS
     subscribers.
 ```
 
-_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.20.6-preview.0/src/commands/package1/version/create.ts)_
+_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package1/version/create.ts)_
 
 ## `sf package1 version create get`
 
@@ -1595,7 +1603,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.6-preview.0/src/commands/package1/version/create/get.ts)_
+_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package1/version/create/get.ts)_
 
 ## `sf package1 version display`
 
@@ -1629,7 +1637,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.6-preview.0/src/commands/package1/version/display.ts)_
+_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package1/version/display.ts)_
 
 ## `sf package1 version list`
 
@@ -1667,6 +1675,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.6-preview.0/src/commands/package1/version/list.ts)_
+_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.0/src/commands/package1/version/list.ts)_
 
 <!-- commandsstop -->

package/lib/commands/package/update.d.ts

@@ -15,6 +15,8 @@ export declare class PackageUpdateCommand extends SfCommand<PackageSaveResult> {
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'error-notification-username': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'enable-app-analytics': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'recommended-version-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'skip-ancestor-check': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<PackageSaveResult>;
 }

package/lib/commands/package/update.js

@@ -56,6 +56,14 @@ export class PackageUpdateCommand extends SfCommand {
             summary: messages.getMessage('flags.enable-app-analytics.summary'),
             allowNo: true,
         }),
+        'recommended-version-id': Flags.string({
+            char: 'r',
+            summary: messages.getMessage('flags.recommended-version-id.summary'),
+            description: messages.getMessage('flags.recommended-version-id.description'),
+        }),
+        'skip-ancestor-check': Flags.boolean({
+            summary: messages.getMessage('flags.skip-ancestor-check.summary'),
+        }),
     };
     async run() {
         const { flags } = await this.parse(PackageUpdateCommand);
@@ -70,7 +78,8 @@ export class PackageUpdateCommand extends SfCommand {
             Description: flags.description,
             PackageErrorUsername: flags['error-notification-username'],
             AppAnalyticsEnabled: flags['enable-app-analytics'],
-        });
+            RecommendedVersionId: flags['recommended-version-id'],
+        }, flags['skip-ancestor-check']);
         this.logSuccess(messages.getMessage('success', [pkg.getId()]));
         return result;
     }

package/lib/commands/package/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/package/update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/package/update.ts"],"names":[],"mappings":"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"}

package/messages/package_update.md

@@ -37,3 +37,15 @@ Enable AppExchange App Analytics usage data collection on this managed package a
 # success
 
 Successfully updated the package. %s
+
+# flags.recommended-version-id.summary
+
+Package version ID that subscribers are notified to install or upgrade to.
+
+# flags.recommended-version-id.description
+
+Specify the recommended package version for subscribers to install. Subscribers are notified to install the package version ID that you specify. If the subscribers have a different version of the same package installed, they're notified to upgrade to the recommended version.
+
+# flags.skip-ancestor-check.summary
+
+Bypass the ancestry check for setting a recommended version.

package/oclif.manifest.json

@@ -1022,6 +1022,21 @@
           "summary": "Enable AppExchange App Analytics usage data collection on this managed package and its components.",
           "allowNo": true,
           "type": "boolean"
+        },
+        "recommended-version-id": {
+          "char": "r",
+          "description": "Specify the recommended package version for subscribers to install. Subscribers are notified to install the package version ID that you specify. If the subscribers have a different version of the same package installed, they're notified to upgrade to the recommended version.",
+          "name": "recommended-version-id",
+          "summary": "Package version ID that subscribers are notified to install or upgrade to.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skip-ancestor-check": {
+          "name": "skip-ancestor-check",
+          "summary": "Bypass the ancestry check for setting a recommended version.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
@@ -1729,6 +1744,134 @@
         "list:installed:package"
       ]
     },
+    "package:uninstall:report": {
+      "aliases": [
+        "force:package:uninstall:report"
+      ],
+      "args": {},
+      "deprecateAliases": true,
+      "examples": [
+        "Retrieve the status of a package uninstall in your default org using the specified request ID:\n<%= config.bin %> <%= command.id %> --request-id 06y...",
+        "Similar to previous example, but use the org with username me@example.com:\n<%= config.bin %> <%= command.id %> --request-id 06y... --target-org me@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-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"
+        },
+        "request-id": {
+          "aliases": [
+            "requestid"
+          ],
+          "char": "i",
+          "deprecateAliases": true,
+          "name": "request-id",
+          "required": true,
+          "summary": "ID of the package uninstall request you want to check; starts with 06y.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "package:uninstall:report",
+      "pluginAlias": "@salesforce/plugin-packaging",
+      "pluginName": "@salesforce/plugin-packaging",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Retrieve the status of a package uninstall request.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "package",
+        "uninstall",
+        "report.js"
+      ],
+      "aliasPermutations": [
+        "force:package:uninstall:report",
+        "package:force:uninstall:report",
+        "package:uninstall:force:report",
+        "package:uninstall:report:force",
+        "force:uninstall:package:report",
+        "uninstall:force:package:report",
+        "uninstall:package:force:report",
+        "uninstall:package:report:force",
+        "force:uninstall:report:package",
+        "uninstall:force:report:package",
+        "uninstall:report:force:package",
+        "uninstall:report:package:force",
+        "force:package:report:uninstall",
+        "package:force:report:uninstall",
+        "package:report:force:uninstall",
+        "package:report:uninstall:force",
+        "force:report:package:uninstall",
+        "report:force:package:uninstall",
+        "report:package:force:uninstall",
+        "report:package:uninstall:force",
+        "force:report:uninstall:package",
+        "report:force:uninstall:package",
+        "report:uninstall:force:package",
+        "report:uninstall:package:force"
+      ],
+      "permutations": [
+        "package:uninstall:report",
+        "uninstall:package:report",
+        "uninstall:report:package",
+        "package:report:uninstall",
+        "report:package:uninstall",
+        "report:uninstall:package"
+      ]
+    },
     "package:push-upgrade:abort": {
       "aliases": [],
       "args": {},
@@ -2208,134 +2351,6 @@
         "schedule:push-upgrade:package"
       ]
     },
-    "package:uninstall:report": {
-      "aliases": [
-        "force:package:uninstall:report"
-      ],
-      "args": {},
-      "deprecateAliases": true,
-      "examples": [
-        "Retrieve the status of a package uninstall in your default org using the specified request ID:\n<%= config.bin %> <%= command.id %> --request-id 06y...",
-        "Similar to previous example, but use the org with username me@example.com:\n<%= config.bin %> <%= command.id %> --request-id 06y... --target-org me@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-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"
-        },
-        "request-id": {
-          "aliases": [
-            "requestid"
-          ],
-          "char": "i",
-          "deprecateAliases": true,
-          "name": "request-id",
-          "required": true,
-          "summary": "ID of the package uninstall request you want to check; starts with 06y.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "package:uninstall:report",
-      "pluginAlias": "@salesforce/plugin-packaging",
-      "pluginName": "@salesforce/plugin-packaging",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Retrieve the status of a package uninstall request.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "package",
-        "uninstall",
-        "report.js"
-      ],
-      "aliasPermutations": [
-        "force:package:uninstall:report",
-        "package:force:uninstall:report",
-        "package:uninstall:force:report",
-        "package:uninstall:report:force",
-        "force:uninstall:package:report",
-        "uninstall:force:package:report",
-        "uninstall:package:force:report",
-        "uninstall:package:report:force",
-        "force:uninstall:report:package",
-        "uninstall:force:report:package",
-        "uninstall:report:force:package",
-        "uninstall:report:package:force",
-        "force:package:report:uninstall",
-        "package:force:report:uninstall",
-        "package:report:force:uninstall",
-        "package:report:uninstall:force",
-        "force:report:package:uninstall",
-        "report:force:package:uninstall",
-        "report:package:force:uninstall",
-        "report:package:uninstall:force",
-        "force:report:uninstall:package",
-        "report:force:uninstall:package",
-        "report:uninstall:force:package",
-        "report:uninstall:package:force"
-      ],
-      "permutations": [
-        "package:uninstall:report",
-        "uninstall:package:report",
-        "uninstall:report:package",
-        "package:report:uninstall",
-        "report:package:uninstall",
-        "report:uninstall:package"
-      ]
-    },
     "package:version:create": {
       "aliases": [
         "force:package:version:create"
@@ -6217,5 +6232,5 @@
       ]
     }
   },
-  "version": "2.20.6-preview.0"
+  "version": "2.22.0"
 }

package/package.json

@@ -1,25 +1,25 @@
 {
     "name": "@salesforce/plugin-packaging",
     "description": "SF plugin that support Salesforce Packaging Platform",
-    "version": "2.20.6-preview.0",
+    "version": "2.22.0",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "dependencies": {
         "@oclif/core": "^4",
-        "@salesforce/core": "^8.23.1",
+        "@salesforce/core": "^8.23.2",
         "@salesforce/kit": "^3.2.4",
-        "@salesforce/packaging": "^4.15.1",
+        "@salesforce/packaging": "^4.17.0",
         "@salesforce/sf-plugins-core": "^12.2.4",
         "chalk": "^5.6.2"
     },
     "devDependencies": {
-        "@oclif/plugin-command-snapshot": "^5.3.5",
+        "@oclif/plugin-command-snapshot": "^5.3.7",
         "@salesforce/cli-plugins-testkit": "^5.3.41",
         "@salesforce/dev-scripts": "^11.0.4",
-        "@salesforce/plugin-command-reference": "^3.1.68",
+        "@salesforce/plugin-command-reference": "^3.1.74",
         "eslint-plugin-sf-plugin": "^1.20.32",
         "minimatch": "^10.0.3",
-        "oclif": "^4.22.27",
+        "oclif": "^4.22.32",
         "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.20.6-preview.0.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.20.6-preview.0.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.22.0.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.22.0.sig"
     }
 }

package/schemas/package-version-report.json

@@ -78,6 +78,9 @@
             },
             "IsOrgDependent": {
               "type": "string"
+            },
+            "RecommendedVersionId": {
+              "type": "string"
             }
           },
           "additionalProperties": false