@salesforce/plugin-data 4.0.38 → 4.0.40

package/README.md

@@ -144,7 +144,7 @@ EXAMPLES
     $ sf data bulk results --job-id 7507i000fake341G --target-org my-scratch
 ```
 
-_See code: [src/commands/data/bulk/results.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/bulk/results.ts)_
+_See code: [src/commands/data/bulk/results.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/bulk/results.ts)_
 
 ## `sf data create file`
 
@@ -193,7 +193,7 @@ EXAMPLES
     $ sf data create file --file path/to/astro.png --parent-id a03fakeLoJWPIA3
 ```
 
-_See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/create/file.ts)_
+_See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/create/file.ts)_
 
 ## `sf data create record`
 
@@ -249,7 +249,7 @@ EXAMPLES
       TracedEntityId=01p17000000R6bLAAS"
 ```
 
-_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/create/record.ts)_
+_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/create/record.ts)_
 
 ## `sf data delete bulk`
 
@@ -309,7 +309,7 @@ FLAG DESCRIPTIONS
     and can be enabled only by a system administrator.
 ```
 
-_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/delete/bulk.ts)_
+_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/delete/bulk.ts)_
 
 ## `sf data delete record`
 
@@ -370,7 +370,7 @@ EXAMPLES
     $ sf data delete record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
 ```
 
-_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/delete/record.ts)_
+_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/delete/record.ts)_
 
 ## `sf data delete resume`
 
@@ -409,7 +409,7 @@ EXAMPLES
     $ sf data delete resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/delete/resume.ts)_
+_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/delete/resume.ts)_
 
 ## `sf data export bulk`
 
@@ -483,7 +483,7 @@ EXAMPLES
       --result-format json --async
 ```
 
-_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/export/bulk.ts)_
+_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/export/bulk.ts)_
 
 ## `sf data export resume`
 
@@ -519,7 +519,7 @@ EXAMPLES
     $ sf data export resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/export/resume.ts)_
+_See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/export/resume.ts)_
 
 ## `sf data export tree`
 
@@ -579,7 +579,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/export/tree.ts)_
+_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/export/tree.ts)_
 
 ## `sf data get record`
 
@@ -643,7 +643,7 @@ EXAMPLES
     $ sf data get record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
 ```
 
-_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/get/record.ts)_
+_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/get/record.ts)_
 
 ## `sf data import bulk`
 
@@ -701,7 +701,7 @@ EXAMPLES
     $ sf data import bulk --file accounts.csv --sobject Account --async
 ```
 
-_See code: [src/commands/data/import/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/import/bulk.ts)_
+_See code: [src/commands/data/import/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/import/bulk.ts)_
 
 ## `sf data import resume`
 
@@ -737,7 +737,7 @@ EXAMPLES
     $ sf data import resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [src/commands/data/import/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/import/resume.ts)_
+_See code: [src/commands/data/import/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/import/resume.ts)_
 
 ## `sf data import tree`
 
@@ -801,7 +801,7 @@ FLAG DESCRIPTIONS
     - files(array) - Files: An array of files paths to load
 ```
 
-_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/import/tree.ts)_
+_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/import/tree.ts)_
 
 ## `sf data query`
 
@@ -854,7 +854,7 @@ EXAMPLES
     $ sf data query --query "SELECT Name FROM ApexTrigger" --use-tooling-api
 ```
 
-_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/query.ts)_
+_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/query.ts)_
 
 ## `sf data resume`
 
@@ -891,7 +891,7 @@ EXAMPLES
     $ sf data resume --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA
 ```
 
-_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/resume.ts)_
+_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/resume.ts)_
 
 ## `sf data search`
 
@@ -941,7 +941,7 @@ EXAMPLES
     $ sf data search --file query.txt --target-org my-scratch --result-format csv
 ```
 
-_See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/search.ts)_
+_See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/search.ts)_
 
 ## `sf data update bulk`
 
@@ -1002,7 +1002,7 @@ EXAMPLES
     $ sf data update bulk --file accounts.csv --sobject Account --async
 ```
 
-_See code: [src/commands/data/update/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/update/bulk.ts)_
+_See code: [src/commands/data/update/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/update/bulk.ts)_
 
 ## `sf data update record`
 
@@ -1064,7 +1064,7 @@ EXAMPLES
       "ExpirationDate=2017-12-01T00:58:04.000+0000"
 ```
 
-_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/update/record.ts)_
+_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/update/record.ts)_
 
 ## `sf data update resume`
 
@@ -1100,7 +1100,7 @@ EXAMPLES
     $ sf data update resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [src/commands/data/update/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/update/resume.ts)_
+_See code: [src/commands/data/update/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/update/resume.ts)_
 
 ## `sf data upsert bulk`
 
@@ -1157,7 +1157,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/upsert/bulk.ts)_
+_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/upsert/bulk.ts)_
 
 ## `sf data upsert resume`
 
@@ -1196,7 +1196,7 @@ EXAMPLES
     $ sf data upsert resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/data/upsert/resume.ts)_
+_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/data/upsert/resume.ts)_
 
 ## `sf force data bulk delete`
 
@@ -1243,7 +1243,7 @@ EXAMPLES
     $ sf force data bulk delete --sobject MyObject__c --file files/delete.csv --wait 5 --target-org my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/force/data/bulk/delete.ts)_
+_See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/force/data/bulk/delete.ts)_
 
 ## `sf force data bulk status`
 
@@ -1280,7 +1280,7 @@ EXAMPLES
     $ sf force data bulk status --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA --target-org my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/force/data/bulk/status.ts)_
+_See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/force/data/bulk/status.ts)_
 
 ## `sf force data bulk upsert`
 
@@ -1338,6 +1338,6 @@ EXAMPLES
       --target-org my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.38/src/commands/force/data/bulk/upsert.ts)_
+_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.40/src/commands/force/data/bulk/upsert.ts)_
 
 <!-- commandsstop -->

package/oclif.manifest.json

@@ -2116,13 +2116,13 @@
         "tree:import:data"
       ]
     },
-    "data:upsert:bulk": {
+    "data:update:bulk": {
       "aliases": [],
       "args": {},
-      "description": "An upsert refers to inserting a record into a Salesforce object if the record doesn't already exist, or updating it if it does exist.\n\nWhen you execute this command, it starts a job, displays the ID, and then immediately returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with the \"<%= config.bin %> data upsert resume\" command.\n\nSee \"Prepare CSV Files\" in the Bulk API Developer Guide for details on formatting your CSV file. (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_csv.htm)",
+      "description": "You can use this command to update millions of Salesforce object records based on a file in comma-separated values (CSV) format.\n\nAll the records in the CSV file must be for the same Salesforce object. Specify the object with the `--sobject` flag. The first column of every line in the CSV file must be an ID of the record you want to update. The CSV file can contain only existing records; if a record in the file doesn't currently exist in the Salesforce object, the command fails. Consider using \"sf data upsert bulk\" if you also want to insert new records.\n\nBulk updates can take a while, depending on how many records are in the CSV file. If the command times out, or you specified the --async flag, the command displays the job ID. To see the status and get the results of the job, run \"sf data update resume\" and pass the job ID to the --job-id flag.\n\nFor information and examples about how to prepare your CSV files, see \"Prepare Data to Ingest\" in the \"Bulk API 2.0 and Bulk API Developer Guide\" (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_data.htm).",
       "examples": [
-        "Bulk upsert records to the Contact object in your default org:\n<%= config.bin %> <%= command.id %> --sobject Contact --file files/contacts.csv --external-id Id",
-        "Bulk upsert records to a custom object in an org with alias my-scratch and wait 5 minutes for the command to complete:\n<%= config.bin %> <%= command.id %> --sobject MyObject__c --file files/file.csv --external-id MyField__c --wait 5 --target-org my-scratch"
+        "Update Account records from a CSV-formatted file into an org with alias \"my-scratch\"; if the update doesn't complete in 10 minutes, the command ends and displays a job ID:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --wait 10 --target-org my-scratch",
+        "Update asynchronously and use the default org; the command immediately returns a job ID that you then pass to the \"sf data update resume\" command:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --async"
       ],
       "flags": {
         "json": {
@@ -2140,90 +2140,56 @@
           "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"
+        "async": {
+          "char": "a",
+          "deprecated": true,
+          "name": "async",
+          "summary": "Don't wait for the command to complete.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "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,
+        "wait": {
+          "char": "w",
+          "name": "wait",
+          "summary": "Time to wait for the command to finish, in minutes.",
+          "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
         },
         "file": {
-          "aliases": [
-            "csvfile"
-          ],
           "char": "f",
-          "deprecateAliases": true,
           "name": "file",
           "required": true,
-          "summary": "CSV file that contains the IDs of the records to update or delete.",
+          "summary": "CSV file that contains the Salesforce object records you want to update.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "sobject": {
-          "aliases": [
-            "sobjecttype"
-          ],
           "char": "s",
-          "deprecateAliases": true,
           "name": "sobject",
           "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
+          "summary": "API name of the Salesforce object, either standard or custom, which you are updating.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "wait": {
-          "char": "w",
-          "exclusive": [
-            "async"
-          ],
-          "name": "wait",
-          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
-          "default": "0 minutes",
-          "hasDynamicHelp": true,
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "async": {
-          "char": "a",
-          "deprecated": true,
-          "exclusive": [
-            "wait"
-          ],
-          "name": "async",
-          "summary": "Run the command asynchronously.",
-          "allowNo": false,
-          "type": "boolean"
+        "target-org": {
+          "char": "o",
+          "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"
         },
         "line-ending": {
           "dependsOn": [
@@ -2253,55 +2219,47 @@
             "TAB"
           ],
           "type": "option"
-        },
-        "external-id": {
-          "aliases": [
-            "externalid"
-          ],
-          "char": "i",
-          "deprecateAliases": true,
-          "name": "external-id",
-          "required": true,
-          "summary": "Name of the external ID field, or the Id field.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:upsert:bulk",
+      "id": "data:update:bulk",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 2.0.",
+      "summary": "Bulk update records to an org from a CSV file. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "upsert",
+        "update",
         "bulk.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:upsert:bulk",
-        "upsert:data:bulk",
-        "upsert:bulk:data",
-        "data:bulk:upsert",
-        "bulk:data:upsert",
-        "bulk:upsert:data"
+        "data:update:bulk",
+        "update:data:bulk",
+        "update:bulk:data",
+        "data:bulk:update",
+        "bulk:data:update",
+        "bulk:update:data"
       ]
     },
-    "data:upsert:resume": {
-      "aliases": [],
+    "data:update:record": {
+      "aliases": [
+        "force:data:record:update"
+      ],
       "args": {},
-      "description": "The command uses the job ID returned from the \"<%= config.bin %> data upsert bulk\" command or the most recently-run bulk upsert job.",
+      "deprecateAliases": true,
+      "description": "Specify the record you want to update with either its ID or with a list of field-value pairs that identify the record. If your list of fields identifies more than one record, the update fails; the error displays how many records were found.\n\nWhen using field-value pairs for both identifying the record and specifiyng the new field values, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command updates a record in Salesforce objects by default. Use the --use-tooling-api flag to update a Tooling API object.",
       "examples": [
-        "Resume a bulk upsert job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
-        "Resume the most recently run bulk upsert job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
+        "Update the Name field of an Account record with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 001D0 --values \"Name=NewAcme\"",
+        "Update the Name field of an Account record whose current name is 'Old Acme':\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name='Old Acme'\" --values \"Name='New Acme'\"",
+        "Update the Name and Website fields of an Account record with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 001D0 --values \"Name='Acme III' Website=www.example.com\"",
+        "Update the ExpirationDate field of a record of the Tooling API object TraceFlag using the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> -t --sobject TraceFlag --record-id 7tf170000009cUBAAY --values \"ExpirationDate=2017-12-01T00:58:04.000+0000\""
       ],
       "flags": {
         "json": {
@@ -2328,92 +2286,156 @@
           "deprecateAliases": true,
           "name": "target-org",
           "noCacheDefault": true,
-          "summary": "Username or alias of the target org. Not required if the \"target-org\" configuration variable is already set.",
+          "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"
         },
-        "job-id": {
+        "api-version": {
           "aliases": [
-            "jobid"
+            "apiversion"
           ],
-          "char": "i",
           "deprecateAliases": true,
-          "name": "job-id",
-          "summary": "ID of the job you want to resume.",
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "use-most-recent": {
-          "exclusive": [
-            "job-id"
+        "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"
+        },
+        "sobject": {
+          "aliases": [
+            "sobjecttype"
           ],
-          "name": "use-most-recent",
-          "summary": "Use the ID of the most recently-run bulk job.",
-          "allowNo": false,
-          "type": "boolean"
+          "char": "s",
+          "deprecateAliases": true,
+          "name": "sobject",
+          "required": true,
+          "summary": "API name of the Salesforce or Tooling API object that contains the record you're updating.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "wait": {
-          "name": "wait",
-          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
-          "default": "5 minutes",
-          "hasDynamicHelp": true,
+        "record-id": {
+          "aliases": [
+            "sobjectid"
+          ],
+          "char": "i",
+          "deprecateAliases": true,
+          "name": "record-id",
+          "summary": "ID of the record you’re updating.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
+        "where": {
+          "char": "w",
+          "name": "where",
+          "summary": "List of <fieldName>=<value> pairs that identify the record you want to update.",
           "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",
+        "values": {
+          "char": "v",
+          "name": "values",
+          "required": true,
+          "summary": "Fields that you're updating, in the format of <fieldName>=<value> pairs.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "use-tooling-api": {
+          "aliases": [
+            "usetoolingapi"
+          ],
+          "char": "t",
+          "deprecateAliases": true,
+          "name": "use-tooling-api",
+          "summary": "Use Tooling API so you can update a record in a Tooling API object.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "perflog": {
+          "deprecated": {
+            "version": "57"
+          },
+          "hidden": true,
+          "name": "perflog",
+          "summary": "Get API performance data.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:upsert:resume",
+      "id": "data:update:record",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume a bulk upsert job that you previously started. Uses Bulk API 2.0.",
+      "summary": "Updates a single record of a Salesforce or Tooling API object.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "upsert",
-        "resume.js"
+        "update",
+        "record.js"
+      ],
+      "aliasPermutations": [
+        "force:data:record:update",
+        "data:force:record:update",
+        "data:record:force:update",
+        "data:record:update:force",
+        "force:record:data:update",
+        "record:force:data:update",
+        "record:data:force:update",
+        "record:data:update:force",
+        "force:record:update:data",
+        "record:force:update:data",
+        "record:update:force:data",
+        "record:update:data:force",
+        "force:data:update:record",
+        "data:force:update:record",
+        "data:update:force:record",
+        "data:update:record:force",
+        "force:update:data:record",
+        "update:force:data:record",
+        "update:data:force:record",
+        "update:data:record:force",
+        "force:update:record:data",
+        "update:force:record:data",
+        "update:record:force:data",
+        "update:record:data:force"
       ],
-      "aliasPermutations": [],
       "permutations": [
-        "data:upsert:resume",
-        "upsert:data:resume",
-        "upsert:resume:data",
-        "data:resume:upsert",
-        "resume:data:upsert",
-        "resume:upsert:data"
+        "data:update:record",
+        "update:data:record",
+        "update:record:data",
+        "data:record:update",
+        "record:data:update",
+        "record:update:data"
       ]
     },
-    "data:update:bulk": {
+    "data:update:resume": {
       "aliases": [],
       "args": {},
-      "description": "You can use this command to update millions of Salesforce object records based on a file in comma-separated values (CSV) format.\n\nAll the records in the CSV file must be for the same Salesforce object. Specify the object with the `--sobject` flag. The first column of every line in the CSV file must be an ID of the record you want to update. The CSV file can contain only existing records; if a record in the file doesn't currently exist in the Salesforce object, the command fails. Consider using \"sf data upsert bulk\" if you also want to insert new records.\n\nBulk updates can take a while, depending on how many records are in the CSV file. If the command times out, or you specified the --async flag, the command displays the job ID. To see the status and get the results of the job, run \"sf data update resume\" and pass the job ID to the --job-id flag.\n\nFor information and examples about how to prepare your CSV files, see \"Prepare Data to Ingest\" in the \"Bulk API 2.0 and Bulk API Developer Guide\" (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_data.htm).",
+      "description": "When the original \"sf data update bulk\" command either times out or is run with the --async flag, it displays a job ID. To see the status and get the results of the bulk update, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk update job.",
       "examples": [
-        "Update Account records from a CSV-formatted file into an org with alias \"my-scratch\"; if the update doesn't complete in 10 minutes, the command ends and displays a job ID:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --wait 10 --target-org my-scratch",
-        "Update asynchronously and use the default org; the command immediately returns a job ID that you then pass to the \"sf data update resume\" command:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --async"
+        "Resume a bulk update job of your default org using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
+        "Resume the most recently run bulk update job for an org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -2431,95 +2453,38 @@
           "multiple": false,
           "type": "option"
         },
-        "async": {
-          "char": "a",
-          "deprecated": true,
-          "name": "async",
-          "summary": "Don't wait for the command to complete.",
+        "use-most-recent": {
+          "name": "use-most-recent",
+          "summary": "Use the job ID of the bulk update job that was most recently run.",
           "allowNo": false,
           "type": "boolean"
         },
-        "wait": {
-          "char": "w",
-          "name": "wait",
-          "summary": "Time to wait for the command to finish, in minutes.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "char": "f",
-          "name": "file",
-          "required": true,
-          "summary": "CSV file that contains the Salesforce object records you want to update.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sobject": {
-          "char": "s",
-          "name": "sobject",
-          "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, which you are updating.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
+        "job-id": {
+          "char": "i",
+          "name": "job-id",
+          "summary": "Job ID of the bulk update.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
-          "char": "o",
-          "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.",
+        "wait": {
+          "char": "w",
+          "name": "wait",
+          "summary": "Time to wait for the command to finish, in minutes.",
+          "default": "5 minutes",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
-        },
-        "line-ending": {
-          "dependsOn": [
-            "file"
-          ],
-          "name": "line-ending",
-          "summary": "Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux it's `LF`.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "CRLF",
-            "LF"
-          ],
-          "type": "option"
-        },
-        "column-delimiter": {
-          "name": "column-delimiter",
-          "summary": "Column delimiter used in the CSV file.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "BACKQUOTE",
-            "CARET",
-            "COMMA",
-            "PIPE",
-            "SEMICOLON",
-            "TAB"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:update:bulk",
+      "id": "data:update:resume",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Bulk update records to an org from a CSV file. Uses Bulk API 2.0.",
+      "summary": "Resume a bulk update job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -2527,30 +2492,25 @@
         "commands",
         "data",
         "update",
-        "bulk.js"
+        "resume.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:update:bulk",
-        "update:data:bulk",
-        "update:bulk:data",
-        "data:bulk:update",
-        "bulk:data:update",
-        "bulk:update:data"
+        "data:update:resume",
+        "update:data:resume",
+        "update:resume:data",
+        "data:resume:update",
+        "resume:data:update",
+        "resume:update:data"
       ]
     },
-    "data:update:record": {
-      "aliases": [
-        "force:data:record:update"
-      ],
+    "data:upsert:bulk": {
+      "aliases": [],
       "args": {},
-      "deprecateAliases": true,
-      "description": "Specify the record you want to update with either its ID or with a list of field-value pairs that identify the record. If your list of fields identifies more than one record, the update fails; the error displays how many records were found.\n\nWhen using field-value pairs for both identifying the record and specifiyng the new field values, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command updates a record in Salesforce objects by default. Use the --use-tooling-api flag to update a Tooling API object.",
+      "description": "An upsert refers to inserting a record into a Salesforce object if the record doesn't already exist, or updating it if it does exist.\n\nWhen you execute this command, it starts a job, displays the ID, and then immediately returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with the \"<%= config.bin %> data upsert resume\" command.\n\nSee \"Prepare CSV Files\" in the Bulk API Developer Guide for details on formatting your CSV file. (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_csv.htm)",
       "examples": [
-        "Update the Name field of an Account record with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 001D0 --values \"Name=NewAcme\"",
-        "Update the Name field of an Account record whose current name is 'Old Acme':\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name='Old Acme'\" --values \"Name='New Acme'\"",
-        "Update the Name and Website fields of an Account record with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 001D0 --values \"Name='Acme III' Website=www.example.com\"",
-        "Update the ExpirationDate field of a record of the Tooling API object TraceFlag using the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> -t --sobject TraceFlag --record-id 7tf170000009cUBAAY --values \"ExpirationDate=2017-12-01T00:58:04.000+0000\""
+        "Bulk upsert records to the Contact object in your default org:\n<%= config.bin %> <%= command.id %> --sobject Contact --file files/contacts.csv --external-id Id",
+        "Bulk upsert records to a custom object in an org with alias my-scratch and wait 5 minutes for the command to complete:\n<%= config.bin %> <%= command.id %> --sobject MyObject__c --file files/file.csv --external-id MyField__c --wait 5 --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -2604,129 +2564,132 @@
           "multiple": false,
           "type": "option"
         },
-        "sobject": {
+        "file": {
           "aliases": [
-            "sobjecttype"
+            "csvfile"
           ],
-          "char": "s",
+          "char": "f",
           "deprecateAliases": true,
-          "name": "sobject",
+          "name": "file",
           "required": true,
-          "summary": "API name of the Salesforce or Tooling API object that contains the record you're updating.",
+          "summary": "CSV file that contains the IDs of the records to update or delete.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "record-id": {
+        "sobject": {
           "aliases": [
-            "sobjectid"
+            "sobjecttype"
           ],
-          "char": "i",
+          "char": "s",
           "deprecateAliases": true,
-          "name": "record-id",
-          "summary": "ID of the record you’re updating.",
+          "name": "sobject",
+          "required": true,
+          "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "where": {
+        "wait": {
           "char": "w",
-          "name": "where",
-          "summary": "List of <fieldName>=<value> pairs that identify the record you want to update.",
+          "exclusive": [
+            "async"
+          ],
+          "name": "wait",
+          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
+          "default": "0 minutes",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "async": {
+          "char": "a",
+          "deprecated": true,
+          "exclusive": [
+            "wait"
+          ],
+          "name": "async",
+          "summary": "Run the command asynchronously.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "line-ending": {
+          "dependsOn": [
+            "file"
+          ],
+          "name": "line-ending",
+          "summary": "Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux it's `LF`.",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "CRLF",
+            "LF"
+          ],
           "type": "option"
         },
-        "values": {
-          "char": "v",
-          "name": "values",
-          "required": true,
-          "summary": "Fields that you're updating, in the format of <fieldName>=<value> pairs.",
+        "column-delimiter": {
+          "name": "column-delimiter",
+          "summary": "Column delimiter used in the CSV file.",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "BACKQUOTE",
+            "CARET",
+            "COMMA",
+            "PIPE",
+            "SEMICOLON",
+            "TAB"
+          ],
           "type": "option"
         },
-        "use-tooling-api": {
+        "external-id": {
           "aliases": [
-            "usetoolingapi"
+            "externalid"
           ],
-          "char": "t",
+          "char": "i",
           "deprecateAliases": true,
-          "name": "use-tooling-api",
-          "summary": "Use Tooling API so you can update a record in a Tooling API object.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "perflog": {
-          "deprecated": {
-            "version": "57"
-          },
-          "hidden": true,
-          "name": "perflog",
-          "summary": "Get API performance data.",
-          "allowNo": false,
-          "type": "boolean"
+          "name": "external-id",
+          "required": true,
+          "summary": "Name of the external ID field, or the Id field.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:update:record",
+      "id": "data:upsert:bulk",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Updates a single record of a Salesforce or Tooling API object.",
+      "summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "update",
-        "record.js"
-      ],
-      "aliasPermutations": [
-        "force:data:record:update",
-        "data:force:record:update",
-        "data:record:force:update",
-        "data:record:update:force",
-        "force:record:data:update",
-        "record:force:data:update",
-        "record:data:force:update",
-        "record:data:update:force",
-        "force:record:update:data",
-        "record:force:update:data",
-        "record:update:force:data",
-        "record:update:data:force",
-        "force:data:update:record",
-        "data:force:update:record",
-        "data:update:force:record",
-        "data:update:record:force",
-        "force:update:data:record",
-        "update:force:data:record",
-        "update:data:force:record",
-        "update:data:record:force",
-        "force:update:record:data",
-        "update:force:record:data",
-        "update:record:force:data",
-        "update:record:data:force"
+        "upsert",
+        "bulk.js"
       ],
+      "aliasPermutations": [],
       "permutations": [
-        "data:update:record",
-        "update:data:record",
-        "update:record:data",
-        "data:record:update",
-        "record:data:update",
-        "record:update:data"
+        "data:upsert:bulk",
+        "upsert:data:bulk",
+        "upsert:bulk:data",
+        "data:bulk:upsert",
+        "bulk:data:upsert",
+        "bulk:upsert:data"
       ]
     },
-    "data:update:resume": {
+    "data:upsert:resume": {
       "aliases": [],
       "args": {},
-      "description": "When the original \"sf data update bulk\" command either times out or is run with the --async flag, it displays a job ID. To see the status and get the results of the bulk update, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk update job.",
+      "description": "The command uses the job ID returned from the \"<%= config.bin %> data upsert bulk\" command or the most recently-run bulk upsert job.",
       "examples": [
-        "Resume a bulk update job of your default org using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
-        "Resume the most recently run bulk update job for an org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
+        "Resume a bulk upsert job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
+        "Resume the most recently run bulk upsert job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -2744,55 +2707,92 @@
           "multiple": false,
           "type": "option"
         },
-        "use-most-recent": {
-          "name": "use-most-recent",
-          "summary": "Use the job ID of the bulk update job that was most recently run.",
-          "allowNo": false,
-          "type": "boolean"
+        "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
+          "char": "o",
+          "deprecateAliases": true,
+          "name": "target-org",
+          "noCacheDefault": 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"
         },
         "job-id": {
+          "aliases": [
+            "jobid"
+          ],
           "char": "i",
+          "deprecateAliases": true,
           "name": "job-id",
-          "summary": "Job ID of the bulk update.",
+          "summary": "ID of the job you want to resume.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "use-most-recent": {
+          "exclusive": [
+            "job-id"
+          ],
+          "name": "use-most-recent",
+          "summary": "Use the ID of the most recently-run bulk job.",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "wait": {
-          "char": "w",
           "name": "wait",
-          "summary": "Time to wait for the command to finish, in minutes.",
+          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
           "default": "5 minutes",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "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"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:update:resume",
+      "id": "data:upsert:resume",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume a bulk update job that you previously started. Uses Bulk API 2.0.",
+      "summary": "Resume a bulk upsert job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "update",
+        "upsert",
         "resume.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:update:resume",
-        "update:data:resume",
-        "update:resume:data",
-        "data:resume:update",
-        "resume:data:update",
-        "resume:update:data"
+        "data:upsert:resume",
+        "upsert:data:resume",
+        "upsert:resume:data",
+        "data:resume:upsert",
+        "resume:data:upsert",
+        "resume:upsert:data"
       ]
     },
     "force:data:bulk:delete": {
@@ -3232,5 +3232,5 @@
       ]
     }
   },
-  "version": "4.0.38"
+  "version": "4.0.40"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/plugin-data",
-    "version": "4.0.38",
+    "version": "4.0.40",
     "description": "Plugin for salesforce data commands",
     "author": "Salesforce",
     "homepage": "https://github.com/salesforcecli/plugin-data",
@@ -121,7 +121,7 @@
     },
     "dependencies": {
         "@jsforce/jsforce-node": "^3.8.2",
-        "@oclif/multi-stage-output": "^0.8.13",
+        "@oclif/multi-stage-output": "^0.8.15",
         "@salesforce/core": "^8.12.0",
         "@salesforce/kit": "^3.2.2",
         "@salesforce/sf-plugins-core": "^12.2.2",
@@ -130,19 +130,19 @@
         "change-case": "^5.4.4",
         "csv-parse": "^5.6.0",
         "csv-stringify": "^6.5.2",
-        "form-data": "^4.0.2",
+        "form-data": "^4.0.3",
         "terminal-link": "^3.0.0"
     },
     "devDependencies": {
         "@oclif/core": "^4.3.0",
-        "@oclif/plugin-command-snapshot": "^5.2.40",
+        "@oclif/plugin-command-snapshot": "^5.3.1",
         "@oclif/test": "^4.1.13",
         "@salesforce/cli-plugins-testkit": "^5.3.39",
         "@salesforce/dev-scripts": "^11.0.2",
         "@salesforce/plugin-command-reference": "^3.1.54",
         "@salesforce/types": "^1.3.0",
         "eslint-plugin-sf-plugin": "^1.20.24",
-        "oclif": "^4.17.46",
+        "oclif": "^4.18.1",
         "ts-node": "^10.9.2",
         "typescript": "^5.8.3"
     },
@@ -267,7 +267,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.38.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.38.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.40.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.40.sig"
     }
 }