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

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.21.2/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.21.2/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.21.2/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.21.2/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.21.2/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.21.2/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.21.2/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.21.2/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.21.2/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.21.2/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.21.2/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.21.2/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.21.2/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>]
 
 FLAGS
   -d, --description=<value>                  New description of the package.
@@ -802,6 +802,7 @@ 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
@@ -838,9 +839,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.21.2/src/commands/package/update.ts)_
 
 ## `sf package version create`
 
@@ -1015,7 +1022,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.21.2/src/commands/package/version/create.ts)_
 
 ## `sf package version create list`
 
@@ -1076,7 +1083,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.21.2/src/commands/package/version/create/list.ts)_
 
 ## `sf package version create report`
 
@@ -1119,7 +1126,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.21.2/src/commands/package/version/create/report.ts)_
 
 ## `sf package version delete`
 
@@ -1160,7 +1167,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.21.2/src/commands/package/version/delete.ts)_
 
 ## `sf package version displayancestry`
 
@@ -1220,7 +1227,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.21.2/src/commands/package/version/displayancestry.ts)_
 
 ## `sf package version displaydependencies`
 
@@ -1282,7 +1289,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.21.2/src/commands/package/version/displaydependencies.ts)_
 
 ## `sf package version list`
 
@@ -1358,7 +1365,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.21.2/src/commands/package/version/list.ts)_
 
 ## `sf package version promote`
 
@@ -1402,7 +1409,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.21.2/src/commands/package/version/promote.ts)_
 
 ## `sf package version report`
 
@@ -1442,7 +1449,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.21.2/src/commands/package/version/report.ts)_
 
 ## `sf package version update`
 
@@ -1495,7 +1502,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.21.2/src/commands/package/version/update.ts)_
 
 ## `sf package1 version create`
 
@@ -1562,7 +1569,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.21.2/src/commands/package1/version/create.ts)_
 
 ## `sf package1 version create get`
 
@@ -1595,7 +1602,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.21.2/src/commands/package1/version/create/get.ts)_
 
 ## `sf package1 version display`
 
@@ -1629,7 +1636,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.21.2/src/commands/package1/version/display.ts)_
 
 ## `sf package1 version list`
 
@@ -1667,6 +1674,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.21.2/src/commands/package1/version/list.ts)_
 
 <!-- commandsstop -->

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

@@ -15,6 +15,7 @@ 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>;
     };
     run(): Promise<PackageSaveResult>;
 }

package/lib/commands/package/update.js

@@ -56,6 +56,11 @@ 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'),
+        }),
     };
     async run() {
         const { flags } = await this.parse(PackageUpdateCommand);
@@ -70,6 +75,7 @@ export class PackageUpdateCommand extends SfCommand {
             Description: flags.description,
             PackageErrorUsername: flags['error-notification-username'],
             AppAnalyticsEnabled: flags['enable-app-analytics'],
+            RecommendedVersionId: flags['recommended-version-id'],
         });
         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,11 @@ 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.

package/oclif.manifest.json

@@ -1022,6 +1022,15 @@
           "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"
         }
       },
       "hasDynamicHelp": true,
@@ -6217,5 +6226,5 @@
       ]
     }
   },
-  "version": "2.20.6-preview.0"
+  "version": "2.21.2"
 }

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.21.2",
     "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.16.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.21.2.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.21.2.sig"
     }
 }

package/schemas/package-version-report.json

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