@salesforce/plugin-data 4.0.41 → 4.0.42

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.41/src/commands/data/bulk/results.ts)_
+_See code: [src/commands/data/bulk/results.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/create/file.ts)_
+_See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/create/record.ts)_
+_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/delete/bulk.ts)_
+_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/delete/record.ts)_
+_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/delete/resume.ts)_
+_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/export/bulk.ts)_
+_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/export/resume.ts)_
+_See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/export/tree.ts)_
+_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/get/record.ts)_
+_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/import/bulk.ts)_
+_See code: [src/commands/data/import/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/import/resume.ts)_
+_See code: [src/commands/data/import/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/import/tree.ts)_
+_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/query.ts)_
+_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/resume.ts)_
+_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/search.ts)_
+_See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/update/bulk.ts)_
+_See code: [src/commands/data/update/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/update/record.ts)_
+_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/update/resume.ts)_
+_See code: [src/commands/data/update/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/upsert/bulk.ts)_
+_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/src/commands/data/upsert/resume.ts)_
+_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/4.0.42/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.41/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.42/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.41/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.42/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.41/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.42/src/commands/force/data/bulk/upsert.ts)_
 
 <!-- commandsstop -->

package/oclif.manifest.json

@@ -2504,13 +2504,13 @@
         "resume:update:data"
       ]
     },
-    "force:data:bulk:delete": {
+    "data:upsert:bulk": {
       "aliases": [],
       "args": {},
-      "description": "The CSV file must have only one column (\"Id\") and then the list of record IDs you want to delete, one ID per line.\n\nWhen you execute this command, it starts a job and one or more batches, displays their IDs, 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 %> force data bulk status\" command. A single job can contain many batches, depending on the length of the CSV file.",
+      "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": [
-        "Bulk delete Account records from your default org using the list of IDs in the \"files/delete.csv\" file:\n<%= config.bin %> <%= command.id %> --sobject Account --file files/delete.csv",
-        "Bulk delete records from 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/delete.csv --wait 5 --target-org my-scratch"
+        "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": {
@@ -2572,7 +2572,7 @@
           "deprecateAliases": true,
           "name": "file",
           "required": true,
-          "summary": "CSV file that contains the IDs of the records to delete.",
+          "summary": "CSV file that contains the IDs of the records to update or delete.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2585,74 +2585,111 @@
           "deprecateAliases": true,
           "name": "sobject",
           "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, that you want to delete records from.",
+          "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"
         },
         "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,
           "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"
+        },
+        "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"
+        },
+        "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": "force:data:bulk:delete",
+      "id": "data:upsert:bulk",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Bulk delete records from an org using a CSV file. Uses Bulk API 1.0.",
+      "summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "force",
         "data",
-        "bulk",
-        "delete.js"
+        "upsert",
+        "bulk.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "force:data:bulk:delete",
-        "data:force:bulk:delete",
-        "data:bulk:force:delete",
-        "data:bulk:delete:force",
-        "force:bulk:data:delete",
-        "bulk:force:data:delete",
-        "bulk:data:force:delete",
-        "bulk:data:delete:force",
-        "force:bulk:delete:data",
-        "bulk:force:delete:data",
-        "bulk:delete:force:data",
-        "bulk:delete:data:force",
-        "force:data:delete:bulk",
-        "data:force:delete:bulk",
-        "data:delete:force:bulk",
-        "data:delete:bulk:force",
-        "force:delete:data:bulk",
-        "delete:force:data:bulk",
-        "delete:data:force:bulk",
-        "delete:data:bulk:force",
-        "force:delete:bulk:data",
-        "delete:force:bulk:data",
-        "delete:bulk:force:data",
-        "delete:bulk:data:force"
+        "data:upsert:bulk",
+        "upsert:data:bulk",
+        "upsert:bulk:data",
+        "data:bulk:upsert",
+        "bulk:data:upsert",
+        "bulk:upsert:data"
       ]
     },
-    "force:data:bulk:status": {
+    "data:upsert:resume": {
       "aliases": [],
       "args": {},
-      "description": "Run this command using the job ID or batch ID returned from the \"<%= config.bin %> force data bulk delete\" or \"<%= config.bin %> force data bulk upsert\" commands.",
+      "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": [
-        "View the status of a bulk load job in your default org:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
-        "View the status of a bulk load job and a specific batches in an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA --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": {
@@ -2679,17 +2716,41 @@
           "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.",
+          "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": {
+        "job-id": {
           "aliases": [
-            "apiversion"
+            "jobid"
           ],
+          "char": "i",
           "deprecateAliases": true,
+          "name": "job-id",
+          "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": {
+          "name": "wait",
+          "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,
@@ -2705,86 +2766,42 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "batch-id": {
-          "aliases": [
-            "batchid"
-          ],
-          "char": "b",
-          "deprecateAliases": true,
-          "name": "batch-id",
-          "summary": "ID of the batch whose status you want to view; you must also specify the job ID.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "job-id": {
-          "aliases": [
-            "jobid"
-          ],
-          "char": "i",
-          "deprecateAliases": true,
-          "name": "job-id",
-          "required": true,
-          "summary": "ID of the job whose status you want to view.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "force:data:bulk:status",
+      "id": "data:upsert:resume",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "View the status of a bulk data load job or batch. Uses Bulk API 1.0.",
+      "summary": "Resume a bulk upsert job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "force",
         "data",
-        "bulk",
-        "status.js"
+        "upsert",
+        "resume.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "force:data:bulk:status",
-        "data:force:bulk:status",
-        "data:bulk:force:status",
-        "data:bulk:status:force",
-        "force:bulk:data:status",
-        "bulk:force:data:status",
-        "bulk:data:force:status",
-        "bulk:data:status:force",
-        "force:bulk:status:data",
-        "bulk:force:status:data",
-        "bulk:status:force:data",
-        "bulk:status:data:force",
-        "force:data:status:bulk",
-        "data:force:status:bulk",
-        "data:status:force:bulk",
-        "data:status:bulk:force",
-        "force:status:data:bulk",
-        "status:force:data:bulk",
-        "status:data:force:bulk",
-        "status:data:bulk:force",
-        "force:status:bulk:data",
-        "status:force:bulk:data",
-        "status:bulk:force:data",
-        "status:bulk:data:force"
+        "data:upsert:resume",
+        "upsert:data:resume",
+        "upsert:resume:data",
+        "data:resume:upsert",
+        "resume:data:upsert",
+        "resume:upsert:data"
       ]
     },
-    "force:data:bulk:upsert": {
+    "force:data:bulk:delete": {
       "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 and one or more batches, displays their IDs, 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 %> force data bulk status\" command. A single job can contain many batches, depending on the length of the CSV file.\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_csv_preparing.htm)\n\nBy default, the job runs the batches in parallel, which we recommend. You can run jobs serially by specifying the --serial flag. But don't process data in serial mode unless you know this would otherwise result in lock timeouts and you can't reorganize your batches to avoid the locks.",
+      "description": "The CSV file must have only one column (\"Id\") and then the list of record IDs you want to delete, one ID per line.\n\nWhen you execute this command, it starts a job and one or more batches, displays their IDs, 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 %> force data bulk status\" command. A single job can contain many batches, depending on the length of the CSV file.",
       "examples": [
-        "Bulk upsert records to the Contact object in your default org:\n<%= config.bin %> --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"
+        "Bulk delete Account records from your default org using the list of IDs in the \"files/delete.csv\" file:\n<%= config.bin %> <%= command.id %> --sobject Account --file files/delete.csv",
+        "Bulk delete records from 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/delete.csv --wait 5 --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -2838,19 +2855,6 @@
           "multiple": false,
           "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"
-        },
         "file": {
           "aliases": [
             "csvfile"
@@ -2859,7 +2863,7 @@
           "deprecateAliases": true,
           "name": "file",
           "required": true,
-          "summary": "CSV file that contains the records to upsert.",
+          "summary": "CSV file that contains the IDs of the records to delete.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2872,7 +2876,7 @@
           "deprecateAliases": true,
           "name": "sobject",
           "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, that you want to upsert records to.",
+          "summary": "API name of the Salesforce object, either standard or custom, that you want to delete records from.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2885,23 +2889,16 @@
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
-        },
-        "serial": {
-          "char": "r",
-          "name": "serial",
-          "summary": "Run batches in serial mode.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "force:data:bulk:upsert",
+      "id": "force:data:bulk:delete",
       "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 1.0.",
+      "summary": "Bulk delete records from an org using a CSV file. Uses Bulk API 1.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -2910,43 +2907,43 @@
         "force",
         "data",
         "bulk",
-        "upsert.js"
+        "delete.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "force:data:bulk:upsert",
-        "data:force:bulk:upsert",
-        "data:bulk:force:upsert",
-        "data:bulk:upsert:force",
-        "force:bulk:data:upsert",
-        "bulk:force:data:upsert",
-        "bulk:data:force:upsert",
-        "bulk:data:upsert:force",
-        "force:bulk:upsert:data",
-        "bulk:force:upsert:data",
-        "bulk:upsert:force:data",
-        "bulk:upsert:data:force",
-        "force:data:upsert:bulk",
-        "data:force:upsert:bulk",
-        "data:upsert:force:bulk",
-        "data:upsert:bulk:force",
-        "force:upsert:data:bulk",
-        "upsert:force:data:bulk",
-        "upsert:data:force:bulk",
-        "upsert:data:bulk:force",
-        "force:upsert:bulk:data",
-        "upsert:force:bulk:data",
-        "upsert:bulk:force:data",
-        "upsert:bulk:data:force"
+        "force:data:bulk:delete",
+        "data:force:bulk:delete",
+        "data:bulk:force:delete",
+        "data:bulk:delete:force",
+        "force:bulk:data:delete",
+        "bulk:force:data:delete",
+        "bulk:data:force:delete",
+        "bulk:data:delete:force",
+        "force:bulk:delete:data",
+        "bulk:force:delete:data",
+        "bulk:delete:force:data",
+        "bulk:delete:data:force",
+        "force:data:delete:bulk",
+        "data:force:delete:bulk",
+        "data:delete:force:bulk",
+        "data:delete:bulk:force",
+        "force:delete:data:bulk",
+        "delete:force:data:bulk",
+        "delete:data:force:bulk",
+        "delete:data:bulk:force",
+        "force:delete:bulk:data",
+        "delete:force:bulk:data",
+        "delete:bulk:force:data",
+        "delete:bulk:data:force"
       ]
     },
-    "data:upsert:bulk": {
+    "force:data:bulk:status": {
       "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": "Run this command using the job ID or batch ID returned from the \"<%= config.bin %> force data bulk delete\" or \"<%= config.bin %> force data bulk upsert\" commands.",
       "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"
+        "View the status of a bulk load job in your default org:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
+        "View the status of a bulk load job and a specific batches in an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -3000,93 +2997,27 @@
           "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.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sobject": {
+        "batch-id": {
           "aliases": [
-            "sobjecttype"
+            "batchid"
           ],
-          "char": "s",
+          "char": "b",
           "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.",
-          "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,
-          "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"
-        },
-        "column-delimiter": {
-          "name": "column-delimiter",
-          "summary": "Column delimiter used in the CSV file.",
+          "name": "batch-id",
+          "summary": "ID of the batch whose status you want to view; you must also specify the job ID.",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "BACKQUOTE",
-            "CARET",
-            "COMMA",
-            "PIPE",
-            "SEMICOLON",
-            "TAB"
-          ],
           "type": "option"
         },
-        "external-id": {
+        "job-id": {
           "aliases": [
-            "externalid"
+            "jobid"
           ],
           "char": "i",
           "deprecateAliases": true,
-          "name": "external-id",
+          "name": "job-id",
           "required": true,
-          "summary": "Name of the external ID field, or the Id field.",
+          "summary": "ID of the job whose status you want to view.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3094,38 +3025,57 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:upsert:bulk",
+      "id": "force:data:bulk:status",
       "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": "View the status of a bulk data load job or batch. Uses Bulk API 1.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
+        "force",
         "data",
-        "upsert",
-        "bulk.js"
+        "bulk",
+        "status.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:upsert:bulk",
-        "upsert:data:bulk",
-        "upsert:bulk:data",
-        "data:bulk:upsert",
-        "bulk:data:upsert",
-        "bulk:upsert:data"
+        "force:data:bulk:status",
+        "data:force:bulk:status",
+        "data:bulk:force:status",
+        "data:bulk:status:force",
+        "force:bulk:data:status",
+        "bulk:force:data:status",
+        "bulk:data:force:status",
+        "bulk:data:status:force",
+        "force:bulk:status:data",
+        "bulk:force:status:data",
+        "bulk:status:force:data",
+        "bulk:status:data:force",
+        "force:data:status:bulk",
+        "data:force:status:bulk",
+        "data:status:force:bulk",
+        "data:status:bulk:force",
+        "force:status:data:bulk",
+        "status:force:data:bulk",
+        "status:data:force:bulk",
+        "status:data:bulk:force",
+        "force:status:bulk:data",
+        "status:force:bulk:data",
+        "status:bulk:force:data",
+        "status:bulk:data:force"
       ]
     },
-    "data:upsert:resume": {
+    "force:data:bulk:upsert": {
       "aliases": [],
       "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.",
+      "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 and one or more batches, displays their IDs, 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 %> force data bulk status\" command. A single job can contain many batches, depending on the length of the CSV file.\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_csv_preparing.htm)\n\nBy default, the job runs the batches in parallel, which we recommend. You can run jobs serially by specifying the --serial flag. But don't process data in serial mode unless you know this would otherwise result in lock timeouts and you can't reorganize your batches to avoid the locks.",
       "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"
+        "Bulk upsert records to the Contact object in your default org:\n<%= config.bin %> --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": {
@@ -3152,41 +3102,17 @@
           "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.",
-          "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": {
-          "name": "wait",
-          "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,
@@ -3202,35 +3128,109 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "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"
+        },
+        "file": {
+          "aliases": [
+            "csvfile"
+          ],
+          "char": "f",
+          "deprecateAliases": true,
+          "name": "file",
+          "required": true,
+          "summary": "CSV file that contains the records to upsert.",
+          "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 upsert records to.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "char": "w",
+          "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"
+        },
+        "serial": {
+          "char": "r",
+          "name": "serial",
+          "summary": "Run batches in serial mode.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:upsert:resume",
+      "id": "force:data:bulk:upsert",
       "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": "Bulk upsert records to an org from a CSV file. Uses Bulk API 1.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
+        "force",
         "data",
-        "upsert",
-        "resume.js"
+        "bulk",
+        "upsert.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:upsert:resume",
-        "upsert:data:resume",
-        "upsert:resume:data",
-        "data:resume:upsert",
-        "resume:data:upsert",
-        "resume:upsert:data"
+        "force:data:bulk:upsert",
+        "data:force:bulk:upsert",
+        "data:bulk:force:upsert",
+        "data:bulk:upsert:force",
+        "force:bulk:data:upsert",
+        "bulk:force:data:upsert",
+        "bulk:data:force:upsert",
+        "bulk:data:upsert:force",
+        "force:bulk:upsert:data",
+        "bulk:force:upsert:data",
+        "bulk:upsert:force:data",
+        "bulk:upsert:data:force",
+        "force:data:upsert:bulk",
+        "data:force:upsert:bulk",
+        "data:upsert:force:bulk",
+        "data:upsert:bulk:force",
+        "force:upsert:data:bulk",
+        "upsert:force:data:bulk",
+        "upsert:data:force:bulk",
+        "upsert:data:bulk:force",
+        "force:upsert:bulk:data",
+        "upsert:force:bulk:data",
+        "upsert:bulk:force:data",
+        "upsert:bulk:data:force"
       ]
     }
   },
-  "version": "4.0.41"
+  "version": "4.0.42"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/plugin-data",
-    "version": "4.0.41",
+    "version": "4.0.42",
     "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.15",
+        "@oclif/multi-stage-output": "^0.8.16",
         "@salesforce/core": "^8.12.0",
         "@salesforce/kit": "^3.2.2",
         "@salesforce/sf-plugins-core": "^12.2.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.41.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.41.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.42.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/4.0.42.sig"
     }
 }