@salesforce/cli 1.68.1 → 1.69.0

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.68.1",
+  "version": "1.69.0",
   "commands": {
     "cmdt:generate:field": {
       "id": "cmdt:generate:field",
@@ -574,13 +574,15 @@
         "Create a site using 'Partner Central' template:\n<%= config.bin %> <%= command.id %> --name partnercentral --template-name 'Partner Central' --url-path-prefix partners",
         "Create a site using the 'Build Your Own (LWR)' template with authentication type of UNAUTHENTICATED:\n<%= config.bin %> <%= command.id %> --name lwrsite --template-name 'Build Your Own (LWR)' --url-path-prefix lwrsite templateParams.AuthenticationType=UNAUTHENTICATED"
       ],
+      "deprecateAliases": true,
       "flags": {
         "json": {
           "name": "json",
           "type": "boolean",
           "description": "Format output as json.",
           "helpGroup": "GLOBAL",
-          "allowNo": false
+          "allowNo": false,
+          "deprecateAliases": true
         },
         "name": {
           "name": "name",
@@ -588,7 +590,8 @@
           "char": "n",
           "summary": "Name of the site to create.",
           "required": true,
-          "multiple": false
+          "multiple": false,
+          "deprecateAliases": true
         },
         "template-name": {
           "name": "template-name",
@@ -598,6 +601,7 @@
           "description": "An example of a template is Customer Service. Run the \"community template list\" command to see which templates are available in your org.",
           "required": true,
           "multiple": false,
+          "deprecateAliases": true,
           "aliases": [
             "templatename"
           ]
@@ -610,6 +614,7 @@
           "description": "For example, if your domain name is https://MyDomainName.my.site.com and you create a customer site, enter 'customers' to create the unique URL https://MyDomainName.my.site.com/customers.",
           "required": true,
           "multiple": false,
+          "deprecateAliases": true,
           "aliases": [
             "urlpathprefix"
           ]
@@ -620,7 +625,8 @@
           "char": "d",
           "summary": "Description of the site.",
           "description": "The description displays in Digital Experiences - All Sites in Setup and helps with site identification.",
-          "multiple": false
+          "multiple": false,
+          "deprecateAliases": true
         },
         "target-org": {
           "name": "target-org",
@@ -629,6 +635,7 @@
           "summary": "Username or alias of the target org.",
           "required": true,
           "multiple": false,
+          "deprecateAliases": true,
           "aliases": [
             "targetusername",
             "u"
@@ -641,13 +648,15 @@
           "multiple": false,
           "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."
-          }
+          },
+          "deprecateAliases": true
         },
         "api-version": {
           "name": "api-version",
           "type": "option",
           "description": "Override the api version used for api requests made by this command",
           "multiple": false,
+          "deprecateAliases": true,
           "aliases": [
             "apiversion"
           ]
@@ -677,13 +686,15 @@
       "examples": [
         "Publish the Experience Builder site with name \"My Customer Site':\n<%= config.bin %> <%= command.id %> --name 'My Customer Site'"
       ],
+      "deprecateAliases": true,
       "flags": {
         "json": {
           "name": "json",
           "type": "boolean",
           "description": "Format output as json.",
           "helpGroup": "GLOBAL",
-          "allowNo": false
+          "allowNo": false,
+          "deprecateAliases": true
         },
         "name": {
           "name": "name",
@@ -691,7 +702,8 @@
           "char": "n",
           "summary": "Name of the Experience Builder site to publish.",
           "required": true,
-          "multiple": false
+          "multiple": false,
+          "deprecateAliases": true
         },
         "target-org": {
           "name": "target-org",
@@ -700,6 +712,7 @@
           "summary": "Username or alias of the target org.",
           "required": true,
           "multiple": false,
+          "deprecateAliases": true,
           "aliases": [
             "targetusername",
             "u"
@@ -710,6 +723,7 @@
           "type": "option",
           "description": "Override the api version used for api requests made by this command",
           "multiple": false,
+          "deprecateAliases": true,
           "aliases": [
             "apiversion"
           ]
@@ -721,7 +735,8 @@
           "multiple": false,
           "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."
-          }
+          },
+          "deprecateAliases": true
         }
       },
       "args": {},
@@ -741,13 +756,15 @@
       "examples": [
         "Retrieve the template list from an org with alias my-scratch-org:\n<%= config.bin %> <%= command.id %> --target-org my-scratch-org"
       ],
+      "deprecateAliases": true,
       "flags": {
         "json": {
           "name": "json",
           "type": "boolean",
           "description": "Format output as json.",
           "helpGroup": "GLOBAL",
-          "allowNo": false
+          "allowNo": false,
+          "deprecateAliases": true
         },
         "target-org": {
           "name": "target-org",
@@ -756,6 +773,7 @@
           "summary": "Username or alias of the target org.",
           "required": true,
           "multiple": false,
+          "deprecateAliases": true,
           "aliases": [
             "targetusername",
             "u"
@@ -766,6 +784,7 @@
           "type": "option",
           "description": "Override the api version used for api requests made by this command",
           "multiple": false,
+          "deprecateAliases": true,
           "aliases": [
             "apiversion"
           ]
@@ -777,12 +796,387 @@
           "multiple": false,
           "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."
-          }
+          },
+          "deprecateAliases": true
         }
       },
       "args": {},
       "hasDynamicHelp": true
     },
+    "dev:hook": {
+      "id": "dev:hook",
+      "summary": "Run a hook. For testing purposes only.",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-dev",
+      "pluginAlias": "@salesforce/plugin-dev",
+      "pluginType": "jit",
+      "aliases": [],
+      "examples": [
+        {
+          "description": "Execute a hook by name:",
+          "command": "<%= config.bin %> <%= command.id %> sf:env:list"
+        },
+        {
+          "description": "Execute a hook by name in a specific plugin:",
+          "command": "<%= config.bin %> <%= command.id %> sf:env:list --plugin env"
+        }
+      ],
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        },
+        "plugin": {
+          "name": "plugin",
+          "type": "option",
+          "char": "p",
+          "summary": "Specific plugin from which to execute hook",
+          "multiple": false
+        }
+      },
+      "args": {
+        "hook": {
+          "name": "hook",
+          "description": "Name of hook to execute.",
+          "required": true
+        }
+      }
+    },
+    "dev:audit:messages": {
+      "id": "dev:audit:messages",
+      "summary": "Audit messages in a plugin's messages directory to locate unused messages and missing messages that have references in source code.",
+      "description": "Audit messages in a plugin's messages directory to locate unused messages and missing messages that have references in source code.",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-dev",
+      "pluginAlias": "@salesforce/plugin-dev",
+      "pluginType": "jit",
+      "aliases": [],
+      "examples": [
+        "sf dev audit messages\nsf dev audit messages --json\nsf dev audit messages --messages-dir ./messages --source-dir ./src"
+      ],
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        },
+        "project-dir": {
+          "name": "project-dir",
+          "type": "option",
+          "char": "p",
+          "summary": "Location project where messages are to be audited.",
+          "description": "The project directory.",
+          "multiple": false,
+          "default": ".",
+          "aliases": [
+            "projectdir"
+          ]
+        },
+        "messages-dir": {
+          "name": "messages-dir",
+          "type": "option",
+          "char": "m",
+          "summary": "Location of the message bundle directory.",
+          "description": "The directory that holds the message bundle files. The default is the messages directory in the current working directory.",
+          "multiple": false,
+          "default": "messages",
+          "aliases": [
+            "messagesdir"
+          ]
+        },
+        "source-dir": {
+          "name": "source-dir",
+          "type": "option",
+          "char": "s",
+          "summary": "Location of the plugin's source code.",
+          "description": "The directory that holds the plugin's source code. The default is the src directory in the current working directory.",
+          "multiple": false,
+          "default": "src",
+          "aliases": [
+            "sourcedir"
+          ]
+        }
+      },
+      "args": {}
+    },
+    "dev:configure:repo": {
+      "id": "dev:configure:repo",
+      "summary": "Configure github repo for Actions pipeline.",
+      "description": "Sets up labels and exempts the CLI bot for branch protection and PR rules",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-dev",
+      "pluginAlias": "@salesforce/plugin-dev",
+      "pluginType": "jit",
+      "aliases": [],
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -r salesforcecli/testPackageRelease"
+      ],
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        },
+        "repository": {
+          "name": "repository",
+          "type": "option",
+          "char": "r",
+          "summary": "The github owner/repo",
+          "required": true,
+          "multiple": false
+        },
+        "dry-run": {
+          "name": "dry-run",
+          "type": "boolean",
+          "char": "d",
+          "summary": "Make no changes",
+          "allowNo": false,
+          "aliases": [
+            "dryrun"
+          ]
+        },
+        "bot": {
+          "name": "bot",
+          "type": "option",
+          "char": "b",
+          "summary": "The github login/username for the bot.",
+          "multiple": false,
+          "default": "SF-CLI-BOT"
+        }
+      },
+      "args": {}
+    },
+    "dev:configure:secrets": {
+      "id": "dev:configure:secrets",
+      "summary": "Ensures a repo has correct access to secrets based on its workflows",
+      "description": "Inspects a repo's yaml files and verifies that secrets required are available for the repo (either set at the repo level or shared via organization-level secrets).\n\nThis command requires scope:admin permissions to inspect the org secrets and admin access to the repo to inspect the repo secrets",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-dev",
+      "pluginAlias": "@salesforce/plugin-dev",
+      "pluginType": "jit",
+      "aliases": [],
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -r salesforcecli/testPackageRelease"
+      ],
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        },
+        "repository": {
+          "name": "repository",
+          "type": "option",
+          "char": "r",
+          "summary": "The github owner/repo",
+          "required": true,
+          "multiple": false
+        },
+        "dry-run": {
+          "name": "dry-run",
+          "type": "boolean",
+          "char": "d",
+          "summary": "Make no changes",
+          "allowNo": false,
+          "aliases": [
+            "dryrun"
+          ]
+        }
+      },
+      "args": {}
+    },
+    "dev:convert:messages": {
+      "id": "dev:convert:messages",
+      "summary": "Convert a .json messages file",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-dev",
+      "pluginAlias": "@salesforce/plugin-dev",
+      "pluginType": "jit",
+      "aliases": [],
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --filename something.json",
+        "<%= config.bin %> <%= command.id %> --project-dir ./path/to/plugin --filename something.json"
+      ],
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "allowNo": false
+        },
+        "project-dir": {
+          "name": "project-dir",
+          "type": "option",
+          "char": "p",
+          "summary": "Location of the project whose messages are to be audited.",
+          "description": "Location of the project whose messages are to be audited.",
+          "multiple": false,
+          "default": ".",
+          "aliases": [
+            "projectdir"
+          ]
+        },
+        "file-name": {
+          "name": "file-name",
+          "type": "option",
+          "char": "f",
+          "summary": "Filename to convert",
+          "required": true,
+          "multiple": true,
+          "aliases": [
+            "filename"
+          ]
+        }
+      },
+      "args": {}
+    },
+    "dev:generate:command": {
+      "id": "dev:generate:command",
+      "summary": "Generate a new sf command.",
+      "description": "You must run this command from within a plugin directory, such as the directory created with the \"sf dev generate plugin\" command.\n\nThe command generates basic source files, messages (\\*.md), and test files for your new command.  The Typescript files contain import statements for the minimum required Salesforce libraries, and scaffold some basic code. The new type names come from the value you passed to the --name flag.\n\nThe command updates the package.json file, so if it detects conflicts with the existing file, you're prompted whether you want to overwrite the file. There are a number of package.json updates required for a new command, so we recommend you answer \"y\" so the command takes care of them all. If you answer \"n\", you must update the package.json file manually.",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-dev",
+      "pluginAlias": "@salesforce/plugin-dev",
+      "pluginType": "jit",
+      "aliases": [],
+      "examples": [
+        "Generate the files for a new \"sf my exciting command\":\n<%= config.bin %> <%= command.id %> --name my:exciting:command"
+      ],
+      "flags": {
+        "name": {
+          "name": "name",
+          "type": "option",
+          "char": "n",
+          "summary": "Name of the new command. Use colons to separate the topic and command names.",
+          "required": true,
+          "multiple": false
+        },
+        "force": {
+          "name": "force",
+          "type": "boolean",
+          "summary": "Overwrite existing files.",
+          "allowNo": false
+        },
+        "nuts": {
+          "name": "nuts",
+          "type": "boolean",
+          "summary": "Generate a NUT test file for the command.",
+          "allowNo": true
+        },
+        "unit": {
+          "name": "unit",
+          "type": "boolean",
+          "summary": "Generate a unit test file for the command.",
+          "allowNo": true
+        }
+      },
+      "args": {}
+    },
+    "dev:generate:flag": {
+      "id": "dev:generate:flag",
+      "summary": "Generate a flag for an existing command.",
+      "description": "You must run this command from within a plugin directory, such as the directory created with the \"sf dev generate plugin\" command.\n\nThis command is interactive. It first discovers all the commands currently implemented in the plugin, and asks you which you want to create a new flag for. It then prompts for other flag properties, such as its long name, optional short name, type, whether it's required, and so on. Long flag names must be kebab-case and not camelCase. The command doesn't let you use an existing long or short flag name. When the command completes, the Typescript file for the command is updated with the code for the new flag.\n\nUse the --dry-run flag to review new code for the command file without actually udpating it.",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-dev",
+      "pluginAlias": "@salesforce/plugin-dev",
+      "pluginType": "jit",
+      "aliases": [],
+      "examples": [
+        "Generate a new flag and update the command file:\n<%= config.bin %> <%= command.id %>",
+        "Don't actually update the command file, just view the generated code:\n<%= config.bin %> <%= command.id %> --dry-run"
+      ],
+      "flags": {
+        "dry-run": {
+          "name": "dry-run",
+          "type": "boolean",
+          "char": "d",
+          "summary": "Print new flag code instead of adding it to the command file.",
+          "allowNo": false,
+          "aliases": [
+            "dryrun"
+          ]
+        }
+      },
+      "args": {}
+    },
+    "dev:generate:hook": {
+      "id": "dev:generate:hook",
+      "summary": "Generate a new sf hook.",
+      "description": "You must run this command from within a plugin directory, such as the directory created with the \"sf dev generate plugin\" command.\n\nThe command generates a basic Typescript source file in the \"src/hooks\" directory to get you started. The source file's name is based on the event you're hooking into, such as envList.ts for the \"sf env list\" command.\n\nThe command updates the package.json file, so if it detects conflicts with the existing file, you're prompted whether you want to overwrite the file. There are a number of package.json updates required for a new hook, so we recommend you answer \"y\" so the command takes care of them all. If you answer \"n\", you must update the package.json file manually.",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-dev",
+      "pluginAlias": "@salesforce/plugin-dev",
+      "pluginType": "jit",
+      "aliases": [],
+      "examples": [
+        "Generate source file for a hook into the \"sf env display\" command:\n<%= config.bin %> <%= command.id %> --event sf:env:display"
+      ],
+      "flags": {
+        "force": {
+          "name": "force",
+          "type": "boolean",
+          "summary": "Overwrite existing files.",
+          "allowNo": false
+        },
+        "event": {
+          "name": "event",
+          "type": "option",
+          "summary": "Event to run hook on. Use colons to separate topic and command names of the event.",
+          "required": true,
+          "multiple": false,
+          "options": [
+            "sf:env:list",
+            "sf:env:display",
+            "sf:deploy",
+            "sf:logout"
+          ]
+        }
+      },
+      "args": {}
+    },
+    "dev:generate:library": {
+      "id": "dev:generate:library",
+      "summary": "Generate a new library.",
+      "description": "This command is interactive. You're prompted for information to populate the new library, such as the npm scope (which must start with \"@\"), the name and description of the library, and its GitHub organization. The command clones the 'forcedotcom/library-template' GitHub repository, installs the library's npm package dependencies using yarn install, and updates the package properties.\n\nWhen the command completes, your new library contains a few sample source and test files to get you started.",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-dev",
+      "pluginAlias": "@salesforce/plugin-dev",
+      "pluginType": "jit",
+      "aliases": [],
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "args": {}
+    },
+    "dev:generate:plugin": {
+      "id": "dev:generate:plugin",
+      "summary": "Generate a new sf plugin.",
+      "description": "This command is interactive. You're prompted for information to populate your new plugin, such as its name, description, author, and percentage of code coverage you want. The command clones the 'salesforcecli/plugin-template-sf' GitHub repository, installs the plug-in's npm package dependencies using yarn install, and updates the package properties.\n\nWhen the command completes, your new plugin contains the source, message, and test files for a sample \"sf hello world\" command.",
+      "strict": true,
+      "pluginName": "@salesforce/plugin-dev",
+      "pluginAlias": "@salesforce/plugin-dev",
+      "pluginType": "jit",
+      "aliases": [
+        "plugins:generate"
+      ],
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "deprecateAliases": true,
+      "flags": {},
+      "args": {}
+    },
     "package:convert": {
       "id": "package:convert",
       "summary": "Create a second-generation package version from a first-generation package.",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/cli",
   "description": "The Salesforce CLI",
-  "version": "1.68.1",
+  "version": "1.69.0",
   "author": "Salesforce",
   "bin": {
     "sf": "./bin/run"
@@ -63,10 +63,11 @@
       "@salesforce/plugin-user"
     ],
     "jitPlugins": {
-      "@salesforce/plugin-custom-metadata": "2.1.5",
-      "@salesforce/plugin-community": "2.2.3",
-      "@salesforce/plugin-packaging": "1.15.0",
-      "@salesforce/plugin-signups": "1.4.5",
+      "@salesforce/plugin-custom-metadata": "2.1.6",
+      "@salesforce/plugin-community": "2.2.4",
+      "@salesforce/plugin-dev": "0.7.0",
+      "@salesforce/plugin-packaging": "1.15.2",
+      "@salesforce/plugin-signups": "1.4.6",
       "@salesforce/sfdx-scanner": "3.10.0"
     },
     "devPlugins": [
@@ -109,35 +110,35 @@
     ]
   },
   "dependencies": {
-    "@oclif/core": "2.4.0",
-    "@oclif/plugin-autocomplete": "2.1.3",
+    "@oclif/core": "2.5.1",
+    "@oclif/plugin-autocomplete": "2.1.4",
     "@oclif/plugin-commands": "2.2.10",
-    "@oclif/plugin-help": "5.2.6",
+    "@oclif/plugin-help": "5.2.7",
     "@oclif/plugin-not-found": "2.3.21",
     "@oclif/plugin-plugins": "2.3.2",
-    "@oclif/plugin-search": "0.0.13",
+    "@oclif/plugin-search": "0.0.14",
     "@oclif/plugin-update": "3.1.6",
     "@oclif/plugin-version": "1.2.1",
-    "@oclif/plugin-warn-if-update-available": "2.0.29",
+    "@oclif/plugin-warn-if-update-available": "2.0.30",
     "@oclif/plugin-which": "2.2.16",
-    "@salesforce/core": "3.33.5",
-    "@salesforce/plugin-apex": "2.2.1",
-    "@salesforce/plugin-auth": "2.7.3",
-    "@salesforce/plugin-data": "2.3.4",
+    "@salesforce/core": "3.33.6",
+    "@salesforce/plugin-apex": "2.2.2",
+    "@salesforce/plugin-auth": "2.7.7",
+    "@salesforce/plugin-data": "2.3.6",
     "@salesforce/plugin-deploy-retrieve": "1.8.2",
-    "@salesforce/plugin-env": "2.1.1",
+    "@salesforce/plugin-env": "2.1.2",
     "@salesforce/plugin-functions": "1.21.2",
-    "@salesforce/plugin-info": "2.4.7",
-    "@salesforce/plugin-limits": "2.3.5",
-    "@salesforce/plugin-login": "1.2.1",
-    "@salesforce/plugin-org": "2.4.4",
-    "@salesforce/plugin-schema": "2.3.1",
-    "@salesforce/plugin-settings": "1.4.0",
-    "@salesforce/plugin-sobject": "0.1.7",
-    "@salesforce/plugin-telemetry": "2.1.1",
+    "@salesforce/plugin-info": "2.5.1",
+    "@salesforce/plugin-limits": "2.3.8",
+    "@salesforce/plugin-login": "1.2.2",
+    "@salesforce/plugin-org": "2.4.6",
+    "@salesforce/plugin-schema": "2.3.3",
+    "@salesforce/plugin-settings": "1.4.2",
+    "@salesforce/plugin-sobject": "0.1.8",
+    "@salesforce/plugin-telemetry": "2.1.3",
     "@salesforce/plugin-templates": "55.4.4",
     "@salesforce/plugin-trust": "2.4.4",
-    "@salesforce/plugin-user": "2.3.2",
+    "@salesforce/plugin-user": "2.3.3",
     "@salesforce/sf-plugins-core": "2.2.4",
     "semver": "^7.3.8",
     "tslib": "^2.4.1"
@@ -222,12 +223,12 @@
     "@salesforce/ts-sinon": "^1.4.6",
     "@typescript-eslint/eslint-plugin": "^5.54.0",
     "@typescript-eslint/parser": "^5.54.0",
-    "aws-sdk": "2.1325.0",
+    "aws-sdk": "2.1329.0",
     "chai": "^4.3.7",
     "eslint": "^8.35.0",
     "eslint-config-oclif": "^3.1",
     "eslint-config-oclif-typescript": "^0.2.0",
-    "eslint-config-prettier": "^8.6.0",
+    "eslint-config-prettier": "^8.7.0",
     "eslint-config-salesforce": "^1.1.1",
     "eslint-config-salesforce-license": "^0.2.0",
     "eslint-config-salesforce-typescript": "^1.1.1",
@@ -238,7 +239,7 @@
     "husky": "^7.0.4",
     "mocha": "^9.2.2",
     "nyc": "^15.1.0",
-    "oclif": "^3.6.5",
+    "oclif": "^3.7.0",
     "prettier": "^2.8.4",
     "pretty-quick": "^3.1.3",
     "sinon": "^11.1.2",