@salesforce/cli 2.117.6 → 2.118.0

package/README.md

@@ -25,7 +25,7 @@ $ npm install -g @salesforce/cli
 $ sf COMMAND
 running command...
 $ sf (--version|-v)
-@salesforce/cli/2.117.6 linux-x64 node-v22.21.1
+@salesforce/cli/2.118.0 linux-x64 node-v22.21.1
 $ sf --help [COMMAND]
 USAGE
   $ sf COMMAND
@@ -5998,7 +5998,7 @@ FLAG DESCRIPTIONS
     --installation-key-bypass flag is required.
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/convert.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/convert.ts)_
 
 ## `sf package create`
 
@@ -6077,7 +6077,7 @@ FLAG DESCRIPTIONS
     Org-Dependent Unlocked Packages" in the Salesforce DX Developer Guide.
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/create.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/create.ts)_
 
 ## `sf package delete`
 
@@ -6119,7 +6119,7 @@ EXAMPLES
     $ sf package delete --package 0Ho... --target-dev-hub devhub@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/delete.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/delete.ts)_
 
 ## `sf package install`
 
@@ -6218,7 +6218,7 @@ FLAG DESCRIPTIONS
     - Delete: Delete removed components, except for custom objects and custom fields, that don't have dependencies.
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/install.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/install.ts)_
 
 ## `sf package install report`
 
@@ -6251,7 +6251,7 @@ EXAMPLES
     $ sf package install report --request-id 0Hf... --target-org me@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/install/report.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/install/report.ts)_
 
 ## `sf package installed list`
 
@@ -6283,7 +6283,7 @@ EXAMPLES
     $ sf package installed list --target-org me@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/installed/list.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/installed/list.ts)_
 
 ## `sf package list`
 
@@ -6321,7 +6321,7 @@ EXAMPLES
     $ sf package list --target-dev-hub devhub@example.com --verbose
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/list.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/list.ts)_
 
 ## `sf package push-upgrade abort`
 
@@ -6360,7 +6360,7 @@ EXAMPLES
     $ sf package push-upgrade abort --push-request-id 0DV... --target-dev-hub devhub@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/push-upgrade/abort.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/push-upgrade/abort.ts)_
 
 ## `sf package push-upgrade list`
 
@@ -6419,7 +6419,7 @@ EXAMPLES
     $ sf package push-upgrade list --package 033xyz –-status Failed
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/push-upgrade/list.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/push-upgrade/list.ts)_
 
 ## `sf package push-upgrade report`
 
@@ -6461,7 +6461,7 @@ EXAMPLES
     $ sf package push-upgrade report --push-request-id 0DV... --target-dev-hub devhub@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/push-upgrade/report.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/push-upgrade/report.ts)_
 
 ## `sf package push-upgrade schedule`
 
@@ -6548,7 +6548,7 @@ FLAG DESCRIPTIONS
     Overrides the value of the target-dev-hub configuration variable, if set.
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/push-upgrade/schedule.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/push-upgrade/schedule.ts)_
 
 ## `sf package uninstall`
 
@@ -6596,7 +6596,7 @@ EXAMPLES
     $ sf package uninstall --package "Undesirable Package Alias"
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/uninstall.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/uninstall.ts)_
 
 ## `sf package uninstall report`
 
@@ -6629,7 +6629,7 @@ EXAMPLES
     $ sf package uninstall report --request-id 06y... --target-org me@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/uninstall/report.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/uninstall/report.ts)_
 
 ## `sf package update`
 
@@ -6646,7 +6646,9 @@ 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.
+  -r, --recommended-version-id=<value>       ID of the package version that's installed when subscribers click the
+                                             Upgrade to Recommended Version option on the Installed Packages page of
+                                             their org.
   -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
@@ -6685,14 +6687,17 @@ 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.
+  -r, --recommended-version-id=<value>
 
-    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.
+    ID of the package version that's installed when subscribers click the Upgrade to Recommended Version option on the
+    Installed Packages page of their org.
+
+    Specify the recommended package version for subscribers to install. If a subscriber has a package version installed
+    in their org that's lower than the version you set, the subscriber sees the Upgrade to Recommended Version option on
+    the Installed Packages page. Only released package versions can be set as the recommended version.
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/update.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/update.ts)_
 
 ## `sf package version create`
 
@@ -6867,7 +6872,7 @@ FLAG DESCRIPTIONS
     periods of no output from commands.
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/version/create.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/version/create.ts)_
 
 ## `sf package version create list`
 
@@ -6928,7 +6933,7 @@ EXAMPLES
     $ sf package version create list --created-last-days 0 --status Success
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/version/create/list.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/version/create/list.ts)_
 
 ## `sf package version create report`
 
@@ -6971,7 +6976,7 @@ EXAMPLES
     $ sf package version create report --package-create-request-id 08c... --target-dev-hub devhub@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/version/create/report.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/version/create/report.ts)_
 
 ## `sf package version delete`
 
@@ -7012,7 +7017,7 @@ EXAMPLES
     $ sf package version delete --package 04t... --target-org devhub@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/version/delete.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/version/delete.ts)_
 
 ## `sf package version displayancestry`
 
@@ -7072,7 +7077,7 @@ FLAG DESCRIPTIONS
     You can use the DOT code output in graph visualization software to create tree visualizations.
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/version/displayancestry.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/version/displayancestry.ts)_
 
 ## `sf package version displaydependencies`
 
@@ -7134,7 +7139,7 @@ FLAG DESCRIPTIONS
     package, which must be installed last.
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/version/displaydependencies.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/version/displaydependencies.ts)_
 
 ## `sf package version list`
 
@@ -7210,7 +7215,7 @@ EXAMPLES
     $ sf package version list --packages exp-mgr,exp-mgr-util --released --modified-last-days 0
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/version/list.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/version/list.ts)_
 
 ## `sf package version promote`
 
@@ -7254,7 +7259,7 @@ EXAMPLES
     $ sf package version promote --package "Awesome Package Alias"
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/version/promote.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/version/promote.ts)_
 
 ## `sf package version report`
 
@@ -7294,7 +7299,7 @@ EXAMPLES
     $ sf package version report --package "Your Package Alias" --target-dev-hub devhub@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/version/report.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/version/report.ts)_
 
 ## `sf package version retrieve`
 
@@ -7339,7 +7344,7 @@ EXAMPLES
     $ sf package version retrieve --package 04tXXX --output-dir my-directory/ --target-dev-hub devhub@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/version/retrieve.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/version/retrieve.ts)_
 
 ## `sf package version update`
 
@@ -7392,7 +7397,7 @@ EXAMPLES
     $ sf package version update --package 04t... --version-description "New Package Version Description"
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package/version/update.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package/version/update.ts)_
 
 ## `sf package1 version create`
 
@@ -7459,7 +7464,7 @@ FLAG DESCRIPTIONS
     subscribers.
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package1/version/create.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package1/version/create.ts)_
 
 ## `sf package1 version create get`
 
@@ -7492,7 +7497,7 @@ EXAMPLES
     $ sf package1 version create get --request-id 0HD... --target-org myorg@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package1/version/create/get.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package1/version/create/get.ts)_
 
 ## `sf package1 version display`
 
@@ -7526,7 +7531,7 @@ EXAMPLES
     $ sf package1 version display --package-version-id 04t... --target-org myorg@example.com
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package1/version/display.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package1/version/display.ts)_
 
 ## `sf package1 version list`
 
@@ -7564,7 +7569,7 @@ FLAG DESCRIPTIONS
     If not specified, shows all versions for all packages (managed and unmanaged) in the org.
 ```
 
-_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.2/src/commands/package1/version/list.ts)_
+_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.24.4/src/commands/package1/version/list.ts)_
 
 ## `sf plugins`
 

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@salesforce/cli",
-  "version": "2.117.6",
+  "version": "2.118.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/cli",
-      "version": "2.117.6",
+      "version": "2.118.0",
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "dependencies": {
@@ -34,7 +34,7 @@
         "@salesforce/plugin-limits": "3.3.74",
         "@salesforce/plugin-marketplace": "1.3.8",
         "@salesforce/plugin-org": "5.9.53",
-        "@salesforce/plugin-packaging": "2.24.2",
+        "@salesforce/plugin-packaging": "2.24.4",
         "@salesforce/plugin-schema": "3.3.90",
         "@salesforce/plugin-settings": "2.4.54",
         "@salesforce/plugin-sobject": "1.4.81",
@@ -5462,9 +5462,9 @@
       }
     },
     "node_modules/@salesforce/plugin-packaging": {
-      "version": "2.24.2",
-      "resolved": "https://registry.npmjs.org/@salesforce/plugin-packaging/-/plugin-packaging-2.24.2.tgz",
-      "integrity": "sha512-tbLmyMc5dBHYsqD/yI+mOckf4/4alfbqlqrIpXxM0lJLdsjum/11JMA+nZo8djskpGrcQvLI6tXEL0pZxIBUXQ==",
+      "version": "2.24.4",
+      "resolved": "https://registry.npmjs.org/@salesforce/plugin-packaging/-/plugin-packaging-2.24.4.tgz",
+      "integrity": "sha512-Ke+0graqopIEcJRT46K3RdtDet11QZaHb+rzERC0OAVnQvhk8oSZKs5jdnhGgA+gxg5B4EIIvNQ/+tSQYJ6hug==",
       "license": "Apache-2.0",
       "dependencies": {
         "@oclif/core": "^4",

package/oclif.lock

@@ -2377,10 +2377,10 @@
     open "^10.2.0"
     terminal-link "^3.0.0"
 
-"@salesforce/plugin-packaging@2.24.2":
-  version "2.24.2"
-  resolved "https://registry.npmjs.org/@salesforce/plugin-packaging/-/plugin-packaging-2.24.2.tgz"
-  integrity sha512-tbLmyMc5dBHYsqD/yI+mOckf4/4alfbqlqrIpXxM0lJLdsjum/11JMA+nZo8djskpGrcQvLI6tXEL0pZxIBUXQ==
+"@salesforce/plugin-packaging@2.24.4":
+  version "2.24.4"
+  resolved "https://registry.npmjs.org/@salesforce/plugin-packaging/-/plugin-packaging-2.24.4.tgz"
+  integrity sha512-Ke+0graqopIEcJRT46K3RdtDet11QZaHb+rzERC0OAVnQvhk8oSZKs5jdnhGgA+gxg5B4EIIvNQ/+tSQYJ6hug==
   dependencies:
     "@oclif/core" "^4"
     "@salesforce/core" "^8.24.0"

package/oclif.manifest.json

@@ -4180,5 +4180,5 @@
       "requiresProject": true
     }
   },
-  "version": "2.117.6"
+  "version": "2.118.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/cli",
   "description": "The Salesforce CLI",
-  "version": "2.117.6",
+  "version": "2.118.0",
   "author": "Salesforce",
   "bin": {
     "sf": "./bin/run.js",
@@ -167,7 +167,7 @@
     "@salesforce/plugin-limits": "3.3.74",
     "@salesforce/plugin-marketplace": "1.3.8",
     "@salesforce/plugin-org": "5.9.53",
-    "@salesforce/plugin-packaging": "2.24.2",
+    "@salesforce/plugin-packaging": "2.24.4",
     "@salesforce/plugin-schema": "3.3.90",
     "@salesforce/plugin-settings": "2.4.54",
     "@salesforce/plugin-sobject": "1.4.81",