@salesforce/plugin-data 3.13.5 → 3.13.6

package/README.md

@@ -145,7 +145,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/3.13.5/src/commands/data/bulk/results.ts)_
+_See code: [src/commands/data/bulk/results.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/bulk/results.ts)_
 
 ## `sf data create file`
 
@@ -194,7 +194,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/3.13.5/src/commands/data/create/file.ts)_
+_See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/create/file.ts)_
 
 ## `sf data create record`
 
@@ -250,7 +250,7 @@ EXAMPLES
       TracedEntityId=01p17000000R6bLAAS"
 ```
 
-_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.5/src/commands/data/create/record.ts)_
+_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/create/record.ts)_
 
 ## `sf data delete bulk`
 
@@ -311,7 +311,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/3.13.5/src/commands/data/delete/bulk.ts)_
+_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/delete/bulk.ts)_
 
 ## `sf data delete record`
 
@@ -372,7 +372,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/3.13.5/src/commands/data/delete/record.ts)_
+_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/delete/record.ts)_
 
 ## `sf data delete resume`
 
@@ -411,7 +411,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/3.13.5/src/commands/data/delete/resume.ts)_
+_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/delete/resume.ts)_
 
 ## `sf data export bulk`
 
@@ -485,7 +485,7 @@ EXAMPLES
       --result-format json --async
 ```
 
-_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.5/src/commands/data/export/bulk.ts)_
+_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/export/bulk.ts)_
 
 ## `sf data export resume`
 
@@ -521,7 +521,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/3.13.5/src/commands/data/export/resume.ts)_
+_See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/export/resume.ts)_
 
 ## `sf data export tree`
 
@@ -582,7 +582,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.5/src/commands/data/export/tree.ts)_
+_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/export/tree.ts)_
 
 ## `sf data get record`
 
@@ -646,7 +646,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/3.13.5/src/commands/data/get/record.ts)_
+_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/get/record.ts)_
 
 ## `sf data import bulk`
 
@@ -704,7 +704,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/3.13.5/src/commands/data/import/bulk.ts)_
+_See code: [src/commands/data/import/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/import/bulk.ts)_
 
 ## `sf data import resume`
 
@@ -740,7 +740,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/3.13.5/src/commands/data/import/resume.ts)_
+_See code: [src/commands/data/import/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/import/resume.ts)_
 
 ## `sf data import tree`
 
@@ -805,7 +805,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/3.13.5/src/commands/data/import/tree.ts)_
+_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/import/tree.ts)_
 
 ## `sf data query`
 
@@ -871,7 +871,7 @@ EXAMPLES
     $ sf data query --query "SELECT Id FROM Contact" --bulk --wait 0
 ```
 
-_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.5/src/commands/data/query.ts)_
+_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/query.ts)_
 
 ## `sf data query resume`
 
@@ -908,7 +908,7 @@ EXAMPLES
     $ sf data query resume --bulk-query-id 7500x000005BdFzXXX
 ```
 
-_See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.5/src/commands/data/query/resume.ts)_
+_See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/query/resume.ts)_
 
 ## `sf data resume`
 
@@ -945,7 +945,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/3.13.5/src/commands/data/resume.ts)_
+_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/resume.ts)_
 
 ## `sf data search`
 
@@ -995,7 +995,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/3.13.5/src/commands/data/search.ts)_
+_See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/search.ts)_
 
 ## `sf data update bulk`
 
@@ -1056,7 +1056,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/3.13.5/src/commands/data/update/bulk.ts)_
+_See code: [src/commands/data/update/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/update/bulk.ts)_
 
 ## `sf data update record`
 
@@ -1118,7 +1118,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/3.13.5/src/commands/data/update/record.ts)_
+_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/update/record.ts)_
 
 ## `sf data update resume`
 
@@ -1154,7 +1154,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/3.13.5/src/commands/data/update/resume.ts)_
+_See code: [src/commands/data/update/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/update/resume.ts)_
 
 ## `sf data upsert bulk`
 
@@ -1213,7 +1213,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.5/src/commands/data/upsert/bulk.ts)_
+_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/upsert/bulk.ts)_
 
 ## `sf data upsert resume`
 
@@ -1252,7 +1252,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/3.13.5/src/commands/data/upsert/resume.ts)_
+_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/data/upsert/resume.ts)_
 
 ## `sf force data bulk delete`
 
@@ -1299,7 +1299,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/3.13.5/src/commands/force/data/bulk/delete.ts)_
+_See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/force/data/bulk/delete.ts)_
 
 ## `sf force data bulk status`
 
@@ -1336,7 +1336,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/3.13.5/src/commands/force/data/bulk/status.ts)_
+_See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/force/data/bulk/status.ts)_
 
 ## `sf force data bulk upsert`
 
@@ -1394,6 +1394,6 @@ EXAMPLES
       --target-org my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.5/src/commands/force/data/bulk/upsert.ts)_
+_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.6/src/commands/force/data/bulk/upsert.ts)_
 
 <!-- commandsstop -->

package/oclif.manifest.json

@@ -3148,18 +3148,13 @@
         "resume:upsert:data"
       ]
     },
-    "data:export:legacy:tree": {
+    "force:data:bulk:delete": {
       "aliases": [],
       "args": {},
-      "deprecationOptions": {
-        "to": "data tree export",
-        "message": "Starting on Nov 10, 2024, this command will no longer be available. Use `data export tree` instead."
-      },
-      "description": "Specify a SOQL query, either directly at the command line or read from a file, to retrieve the data you want to export. The exported data is written to JSON files in sObject tree format, which is a collection of nested, parent-child records with a single root record. Use these JSON files to import data into an org with the \"<%= config.bin %> data import tree\" command.\n\nIf your SOQL query references multiple objects, the command generates a single JSON file by default. You can specify the --plan flag to generate separate JSON files for each object and a plan definition file that aggregates them. You then specify just this plan definition file when you import the data into an org.\n\nThe SOQL query can return a maximum of 2,000 records. For more information, see the REST API Developer Guide. (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm).",
+      "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": [
-        "Export records retrieved with the specified SOQL query into a single JSON file in the current directory; the command uses your default org:\n<%= config.bin %> <%= command.id %> --query \"SELECT Id, Name, (SELECT Name, Address__c FROM Properties__r) FROM Broker__c\"",
-        "Export data using a SOQL query in the \"query.txt\" file and generate JSON files for each object and a plan that aggregates them:\n<%= config.bin %> <%= command.id %> --query query.txt --plan",
-        "Prepend \"export-demo\" before each generated file and generate the files in the \"export-out\" directory; run the command on the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --query query.txt --plan --prefix export-demo --output-dir export-out --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": {
@@ -3213,101 +3208,95 @@
           "multiple": false,
           "type": "option"
         },
-        "query": {
-          "char": "q",
-          "name": "query",
+        "file": {
+          "aliases": [
+            "csvfile"
+          ],
+          "char": "f",
+          "deprecateAliases": true,
+          "name": "file",
           "required": true,
-          "summary": "SOQL query, or filepath of a file that contains the query, to retrieve records.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "plan": {
-          "char": "p",
-          "name": "plan",
-          "summary": "Generate multiple sObject tree files and a plan definition file for aggregated import.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "prefix": {
-          "char": "x",
-          "name": "prefix",
-          "summary": "Prefix of generated files.",
+          "summary": "CSV file that contains the IDs of the records to delete.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output-dir": {
+        "sobject": {
           "aliases": [
-            "outputdir"
+            "sobjecttype"
           ],
-          "char": "d",
+          "char": "s",
           "deprecateAliases": true,
-          "name": "output-dir",
-          "summary": "Directory in which to generate the JSON files; default is current directory.",
+          "name": "sobject",
+          "required": true,
+          "summary": "API name of the Salesforce object, either standard or custom, that you want to delete records from.",
           "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"
         }
       },
       "hasDynamicHelp": true,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "data:export:legacy:tree",
+      "id": "force:data:bulk:delete",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
-      "state": "deprecated",
       "strict": true,
-      "summary": "Export data from an org into one or more JSON files.",
+      "summary": "Bulk delete records from an org using a CSV file. Uses Bulk API 1.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
+        "force",
         "data",
-        "export",
-        "legacy",
-        "tree.js"
+        "bulk",
+        "delete.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:export:legacy:tree",
-        "export:data:legacy:tree",
-        "export:legacy:data:tree",
-        "export:legacy:tree:data",
-        "data:legacy:export:tree",
-        "legacy:data:export:tree",
-        "legacy:export:data:tree",
-        "legacy:export:tree:data",
-        "data:legacy:tree:export",
-        "legacy:data:tree:export",
-        "legacy:tree:data:export",
-        "legacy:tree:export:data",
-        "data:export:tree:legacy",
-        "export:data:tree:legacy",
-        "export:tree:data:legacy",
-        "export:tree:legacy:data",
-        "data:tree:export:legacy",
-        "tree:data:export:legacy",
-        "tree:export:data:legacy",
-        "tree:export:legacy:data",
-        "data:tree:legacy:export",
-        "tree:data:legacy:export",
-        "tree:legacy:data:export",
-        "tree:legacy:export:data"
+        "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:import:legacy:tree": {
+    "force:data:bulk:status": {
       "aliases": [],
       "args": {},
-      "deprecationOptions": {
-        "message": "After Nov 10, 2024, this command will no longer be available. Use `data export tree`."
-      },
-      "description": "The JSON files that contain the data are in sObject tree format, which is a collection of nested, parent-child records with a single root record. Use the \"<%= config.bin %> data export tree\" command to generate these JSON files.\n\nIf you used the --plan flag when exporting the data to generate a plan definition file, use the --plan flag to reference the file when you import. If you're not using a plan, use the --files flag to list the files. If you specify multiple JSON files that depend on each other in a parent-child relationship, be sure you list them in the correct order.\n\nThe sObject Tree API supports requests that contain up to 200 records. For more information, see the REST API Developer Guide. (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.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": [
-        "Import the records contained in two JSON files into the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --files Contact.json,Account.json --target-org my-scratch",
-        "Import records using a plan definition file into your default org:\n<%= config.bin %> <%= command.id %> --plan Account-Contact-plan.json"
+        "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": {
@@ -3361,116 +3350,85 @@
           "multiple": false,
           "type": "option"
         },
-        "files": {
+        "batch-id": {
           "aliases": [
-            "sobjecttreefiles"
+            "batchid"
           ],
-          "char": "f",
+          "char": "b",
           "deprecateAliases": true,
-          "exclusive": [
-            "plan"
-          ],
-          "name": "files",
-          "summary": "Comma-separated and in-order JSON files that contain the records, in sObject tree format, that you want to insert.",
-          "delimiter": ",",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "plan": {
-          "char": "p",
-          "name": "plan",
-          "summary": "Plan definition file to insert multiple data files.",
+          "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"
         },
-        "content-type": {
+        "job-id": {
           "aliases": [
-            "contenttype"
+            "jobid"
           ],
-          "char": "c",
+          "char": "i",
           "deprecateAliases": true,
-          "deprecated": {
-            "message": "The `config-type` flag is deprecated and will be moved to a `legacy` command after July 10, 2024. It will be completely removed after Nov 10, 2024. Use the new `data tree beta import` command."
-          },
-          "hidden": true,
-          "name": "content-type",
-          "summary": "Content type of import files if their extention is not .json.",
+          "name": "job-id",
+          "required": true,
+          "summary": "ID of the job whose status you want to view.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "config-help": {
-          "aliases": [
-            "confighelp"
-          ],
-          "deprecateAliases": true,
-          "deprecated": {
-            "message": "The `config-help` flag is deprecated and will be moved to a `legacy` command after July 10, 2024. It will be completely removed after Nov 10, 2024. Use the new `data tree beta import` command."
-          },
-          "hidden": true,
-          "name": "config-help",
-          "summary": "Display schema information for the --plan configuration file to stdout; if you specify this flag, all other flags except --json are ignored.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "data:import:legacy:tree",
+      "id": "force:data:bulk:status",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
-      "state": "deprecated",
       "strict": true,
-      "summary": "Import data from one or more JSON files into an org.",
+      "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",
-        "import",
-        "legacy",
-        "tree.js"
+        "bulk",
+        "status.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:import:legacy:tree",
-        "import:data:legacy:tree",
-        "import:legacy:data:tree",
-        "import:legacy:tree:data",
-        "data:legacy:import:tree",
-        "legacy:data:import:tree",
-        "legacy:import:data:tree",
-        "legacy:import:tree:data",
-        "data:legacy:tree:import",
-        "legacy:data:tree:import",
-        "legacy:tree:data:import",
-        "legacy:tree:import:data",
-        "data:import:tree:legacy",
-        "import:data:tree:legacy",
-        "import:tree:data:legacy",
-        "import:tree:legacy:data",
-        "data:tree:import:legacy",
-        "tree:data:import:legacy",
-        "tree:import:data:legacy",
-        "tree:import:legacy:data",
-        "data:tree:legacy:import",
-        "tree:data:legacy:import",
-        "tree:legacy:data:import",
-        "tree:legacy:import: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"
       ]
     },
-    "force:data:bulk:delete": {
+    "force:data:bulk:upsert": {
       "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 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": [
-        "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 %> --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": {
@@ -3524,15 +3482,28 @@
           "multiple": false,
           "type": "option"
         },
-        "file": {
+        "external-id": {
           "aliases": [
-            "csvfile"
+            "externalid"
           ],
-          "char": "f",
+          "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 IDs of the records to delete.",
+          "summary": "CSV file that contains the records to upsert.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3545,7 +3516,7 @@
           "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 upsert records to.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3558,16 +3529,23 @@
           "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:delete",
+      "id": "force:data:bulk:upsert",
       "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 1.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -3576,43 +3554,48 @@
         "force",
         "data",
         "bulk",
-        "delete.js"
+        "upsert.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"
+        "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:status": {
+    "data:export:legacy:tree": {
       "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.",
+      "deprecationOptions": {
+        "to": "data tree export",
+        "message": "Starting on Nov 10, 2024, this command will no longer be available. Use `data export tree` instead."
+      },
+      "description": "Specify a SOQL query, either directly at the command line or read from a file, to retrieve the data you want to export. The exported data is written to JSON files in sObject tree format, which is a collection of nested, parent-child records with a single root record. Use these JSON files to import data into an org with the \"<%= config.bin %> data import tree\" command.\n\nIf your SOQL query references multiple objects, the command generates a single JSON file by default. You can specify the --plan flag to generate separate JSON files for each object and a plan definition file that aggregates them. You then specify just this plan definition file when you import the data into an org.\n\nThe SOQL query can return a maximum of 2,000 records. For more information, see the REST API Developer Guide. (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm).",
       "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"
+        "Export records retrieved with the specified SOQL query into a single JSON file in the current directory; the command uses your default org:\n<%= config.bin %> <%= command.id %> --query \"SELECT Id, Name, (SELECT Name, Address__c FROM Properties__r) FROM Broker__c\"",
+        "Export data using a SOQL query in the \"query.txt\" file and generate JSON files for each object and a plan that aggregates them:\n<%= config.bin %> <%= command.id %> --query query.txt --plan",
+        "Prepend \"export-demo\" before each generated file and generate the files in the \"export-out\" directory; run the command on the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --query query.txt --plan --prefix export-demo --output-dir export-out --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -3666,85 +3649,101 @@
           "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.",
+        "query": {
+          "char": "q",
+          "name": "query",
+          "required": true,
+          "summary": "SOQL query, or filepath of a file that contains the query, to retrieve records.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "job-id": {
+        "plan": {
+          "char": "p",
+          "name": "plan",
+          "summary": "Generate multiple sObject tree files and a plan definition file for aggregated import.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "prefix": {
+          "char": "x",
+          "name": "prefix",
+          "summary": "Prefix of generated files.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-dir": {
           "aliases": [
-            "jobid"
+            "outputdir"
           ],
-          "char": "i",
+          "char": "d",
           "deprecateAliases": true,
-          "name": "job-id",
-          "required": true,
-          "summary": "ID of the job whose status you want to view.",
+          "name": "output-dir",
+          "summary": "Directory in which to generate the JSON files; default is current directory.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": true,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "force:data:bulk:status",
+      "id": "data:export:legacy:tree",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
+      "state": "deprecated",
       "strict": true,
-      "summary": "View the status of a bulk data load job or batch. Uses Bulk API 1.0.",
+      "summary": "Export data from an org into one or more JSON files.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "force",
         "data",
-        "bulk",
-        "status.js"
+        "export",
+        "legacy",
+        "tree.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:export:legacy:tree",
+        "export:data:legacy:tree",
+        "export:legacy:data:tree",
+        "export:legacy:tree:data",
+        "data:legacy:export:tree",
+        "legacy:data:export:tree",
+        "legacy:export:data:tree",
+        "legacy:export:tree:data",
+        "data:legacy:tree:export",
+        "legacy:data:tree:export",
+        "legacy:tree:data:export",
+        "legacy:tree:export:data",
+        "data:export:tree:legacy",
+        "export:data:tree:legacy",
+        "export:tree:data:legacy",
+        "export:tree:legacy:data",
+        "data:tree:export:legacy",
+        "tree:data:export:legacy",
+        "tree:export:data:legacy",
+        "tree:export:legacy:data",
+        "data:tree:legacy:export",
+        "tree:data:legacy:export",
+        "tree:legacy:data:export",
+        "tree:legacy:export:data"
       ]
     },
-    "force:data:bulk:upsert": {
+    "data:import:legacy:tree": {
       "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.",
+      "deprecationOptions": {
+        "message": "After Nov 10, 2024, this command will no longer be available. Use `data export tree`."
+      },
+      "description": "The JSON files that contain the data are in sObject tree format, which is a collection of nested, parent-child records with a single root record. Use the \"<%= config.bin %> data export tree\" command to generate these JSON files.\n\nIf you used the --plan flag when exporting the data to generate a plan definition file, use the --plan flag to reference the file when you import. If you're not using a plan, use the --files flag to list the files. If you specify multiple JSON files that depend on each other in a parent-child relationship, be sure you list them in the correct order.\n\nThe sObject Tree API supports requests that contain up to 200 records. For more information, see the REST API Developer Guide. (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm)",
       "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"
+        "Import the records contained in two JSON files into the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --files Contact.json,Account.json --target-org my-scratch",
+        "Import records using a plan definition file into your default org:\n<%= config.bin %> <%= command.id %> --plan Account-Contact-plan.json"
       ],
       "flags": {
         "json": {
@@ -3798,108 +3797,109 @@
           "multiple": false,
           "type": "option"
         },
-        "external-id": {
+        "files": {
           "aliases": [
-            "externalid"
+            "sobjecttreefiles"
           ],
-          "char": "i",
+          "char": "f",
           "deprecateAliases": true,
-          "name": "external-id",
-          "required": true,
-          "summary": "Name of the external ID field, or the Id field.",
+          "exclusive": [
+            "plan"
+          ],
+          "name": "files",
+          "summary": "Comma-separated and in-order JSON files that contain the records, in sObject tree format, that you want to insert.",
+          "delimiter": ",",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "file": {
-          "aliases": [
-            "csvfile"
-          ],
-          "char": "f",
-          "deprecateAliases": true,
-          "name": "file",
-          "required": true,
-          "summary": "CSV file that contains the records to upsert.",
+        "plan": {
+          "char": "p",
+          "name": "plan",
+          "summary": "Plan definition file to insert multiple data files.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "sobject": {
+        "content-type": {
           "aliases": [
-            "sobjecttype"
+            "contenttype"
           ],
-          "char": "s",
+          "char": "c",
           "deprecateAliases": true,
-          "name": "sobject",
-          "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, that you want to upsert records to.",
+          "deprecated": {
+            "message": "The `config-type` flag is deprecated and will be moved to a `legacy` command after July 10, 2024. It will be completely removed after Nov 10, 2024. Use the new `data tree beta import` command."
+          },
+          "hidden": true,
+          "name": "content-type",
+          "summary": "Content type of import files if their extention is not .json.",
           "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.",
+        "config-help": {
+          "aliases": [
+            "confighelp"
+          ],
+          "deprecateAliases": true,
+          "deprecated": {
+            "message": "The `config-help` flag is deprecated and will be moved to a `legacy` command after July 10, 2024. It will be completely removed after Nov 10, 2024. Use the new `data tree beta import` command."
+          },
+          "hidden": true,
+          "name": "config-help",
+          "summary": "Display schema information for the --plan configuration file to stdout; if you specify this flag, all other flags except --json are ignored.",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "force:data:bulk:upsert",
+      "id": "data:import:legacy:tree",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
+      "state": "deprecated",
       "strict": true,
-      "summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 1.0.",
+      "summary": "Import data from one or more JSON files into an org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "force",
         "data",
-        "bulk",
-        "upsert.js"
+        "import",
+        "legacy",
+        "tree.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"
+        "data:import:legacy:tree",
+        "import:data:legacy:tree",
+        "import:legacy:data:tree",
+        "import:legacy:tree:data",
+        "data:legacy:import:tree",
+        "legacy:data:import:tree",
+        "legacy:import:data:tree",
+        "legacy:import:tree:data",
+        "data:legacy:tree:import",
+        "legacy:data:tree:import",
+        "legacy:tree:data:import",
+        "legacy:tree:import:data",
+        "data:import:tree:legacy",
+        "import:data:tree:legacy",
+        "import:tree:data:legacy",
+        "import:tree:legacy:data",
+        "data:tree:import:legacy",
+        "tree:data:import:legacy",
+        "tree:import:data:legacy",
+        "tree:import:legacy:data",
+        "data:tree:legacy:import",
+        "tree:data:legacy:import",
+        "tree:legacy:data:import",
+        "tree:legacy:import:data"
       ]
     }
   },
-  "version": "3.13.5"
+  "version": "3.13.6"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/plugin-data",
-    "version": "3.13.5",
+    "version": "3.13.6",
     "description": "Plugin for salesforce data commands",
     "author": "Salesforce",
     "homepage": "https://github.com/salesforcecli/plugin-data",
@@ -119,7 +119,7 @@
     },
     "dependencies": {
         "@jsforce/jsforce-node": "^3.6.3",
-        "@oclif/multi-stage-output": "^0.7.15",
+        "@oclif/multi-stage-output": "^0.8.0",
         "@salesforce/core": "^8.6.1",
         "@salesforce/kit": "^3.2.2",
         "@salesforce/sf-plugins-core": "^12.1.0",
@@ -132,7 +132,7 @@
         "terminal-link": "^3.0.0"
     },
     "devDependencies": {
-        "@oclif/core": "^4.0.37",
+        "@oclif/core": "^4.2.0",
         "@oclif/plugin-command-snapshot": "^5.2.23",
         "@oclif/test": "^4.1.3",
         "@salesforce/cli-plugins-testkit": "^5.3.39",
@@ -140,7 +140,7 @@
         "@salesforce/plugin-command-reference": "^3.1.37",
         "@salesforce/types": "^1.3.0",
         "eslint-plugin-sf-plugin": "^1.20.13",
-        "oclif": "^4.16.0",
+        "oclif": "^4.17.0",
         "ts-node": "^10.9.2",
         "typescript": "^5.7.2"
     },
@@ -265,7 +265,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.13.5.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.13.5.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.13.6.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.13.6.sig"
     }
 }