@salesforce/plugin-data 3.4.5 → 3.4.6

package/README.md

@@ -143,7 +143,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.4.5/src/commands/data/create/file.ts)_
+_See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/create/file.ts)_
 
 ## `sf data create record`
 
@@ -199,7 +199,7 @@ EXAMPLES
       TracedEntityId=01p17000000R6bLAAS"
 ```
 
-_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.5/src/commands/data/create/record.ts)_
+_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/create/record.ts)_
 
 ## `sf data delete bulk`
 
@@ -246,7 +246,7 @@ EXAMPLES
     $ sf data delete bulk --sobject MyObject__c --file files/delete.csv --wait 5 --target-org my-scratch
 ```
 
-_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.5/src/commands/data/delete/bulk.ts)_
+_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/delete/bulk.ts)_
 
 ## `sf data delete record`
 
@@ -307,7 +307,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.4.5/src/commands/data/delete/record.ts)_
+_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/delete/record.ts)_
 
 ## `sf data delete resume`
 
@@ -346,7 +346,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.4.5/src/commands/data/delete/resume.ts)_
+_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/delete/resume.ts)_
 
 ## `sf data export beta tree`
 
@@ -404,7 +404,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/export/beta/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.5/src/commands/data/export/beta/tree.ts)_
+_See code: [src/commands/data/export/beta/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/export/beta/tree.ts)_
 
 ## `sf data export tree`
 
@@ -464,7 +464,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.5/src/commands/data/export/tree.ts)_
+_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/export/tree.ts)_
 
 ## `sf data get record`
 
@@ -528,7 +528,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.4.5/src/commands/data/get/record.ts)_
+_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/get/record.ts)_
 
 ## `sf data import beta tree`
 
@@ -572,7 +572,7 @@ EXAMPLES
     $ sf data import beta tree --plan Account-Contact-plan.json
 ```
 
-_See code: [src/commands/data/import/beta/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.5/src/commands/data/import/beta/tree.ts)_
+_See code: [src/commands/data/import/beta/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/import/beta/tree.ts)_
 
 ## `sf data import tree`
 
@@ -622,7 +622,7 @@ EXAMPLES
     $ sf data import tree --plan Account-Contact-plan.json
 ```
 
-_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.5/src/commands/data/import/tree.ts)_
+_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/import/tree.ts)_
 
 ## `sf data query`
 
@@ -686,7 +686,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.4.5/src/commands/data/query.ts)_
+_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/query.ts)_
 
 ## `sf data query resume`
 
@@ -724,7 +724,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.4.5/src/commands/data/query/resume.ts)_
+_See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/query/resume.ts)_
 
 ## `sf data resume`
 
@@ -761,7 +761,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.4.5/src/commands/data/resume.ts)_
+_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/resume.ts)_
 
 ## `sf data update record`
 
@@ -823,7 +823,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.4.5/src/commands/data/update/record.ts)_
+_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/update/record.ts)_
 
 ## `sf data upsert bulk`
 
@@ -876,7 +876,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.5/src/commands/data/upsert/bulk.ts)_
+_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/upsert/bulk.ts)_
 
 ## `sf data upsert resume`
 
@@ -915,7 +915,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.4.5/src/commands/data/upsert/resume.ts)_
+_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.6/src/commands/data/upsert/resume.ts)_
 
 ## `sf force data bulk delete`
 
@@ -962,7 +962,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.4.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.4.6/src/commands/force/data/bulk/delete.ts)_
 
 ## `sf force data bulk status`
 
@@ -999,7 +999,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.4.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.4.6/src/commands/force/data/bulk/status.ts)_
 
 ## `sf force data bulk upsert`
 
@@ -1057,6 +1057,6 @@ EXAMPLES
       --target-org my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.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.4.6/src/commands/force/data/bulk/upsert.ts)_
 
 <!-- commandsstop -->

package/oclif.manifest.json

@@ -331,14 +331,13 @@
         "resume:data"
       ]
     },
-    "data:create:file": {
+    "data:delete:bulk": {
       "aliases": [],
       "args": {},
-      "description": "This command always creates a new file in the org; you can't update an existing file. After a successful upload, the command displays the ID of the new ContentDocument record which represents the uploaded file.\n\nBy default, the uploaded file isn't attached to a record; in the Salesforce UI the file shows up in the Files tab. You can optionally attach the file to an existing record, such as an account, as long as you know its record ID.\n\nYou can also give the file a new name after it's been uploaded; by default its name in the org is the same as the local file name.",
+      "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, 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 ID to check the status of the job with the \"<%= config.bin %> data delete resume\" command.",
       "examples": [
-        "Upload the local file \"resources/astro.png\" to your default org:\n<%= config.bin %> <%= command.id %> --file resources/astro.png",
-        "Give the file a different filename after it's uploaded to the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --file resources/astro.png --title AstroOnABoat.png --target-org my-scratch",
-        "Attach the file to a record in the org:\n<%= config.bin %> <%= command.id %> --file path/to/astro.png --parent-id a03fakeLoJWPIA3"
+        "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": {
@@ -357,7 +356,12 @@
           "type": "option"
         },
         "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
           "char": "o",
+          "deprecateAliases": true,
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
@@ -367,77 +371,120 @@
           "type": "option"
         },
         "api-version": {
+          "aliases": [
+            "apiversion"
+          ],
+          "deprecateAliases": true,
           "description": "Override the api version used for api requests made by this command",
           "name": "api-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "title": {
-          "char": "t",
-          "name": "title",
-          "required": false,
-          "summary": "New title given to the file (ContentDocument) after it's uploaded.",
+        "loglevel": {
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
+          },
+          "hidden": true,
+          "name": "loglevel",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "file": {
+          "aliases": [
+            "csvfile"
+          ],
           "char": "f",
+          "deprecateAliases": true,
           "name": "file",
           "required": true,
-          "summary": "Path of file to upload.",
+          "summary": "CSV file that contains the IDs of the records to update or delete.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "parent-id": {
-          "char": "i",
-          "name": "parent-id",
-          "summary": "ID of the record to attach the file to.",
+        "sobject": {
+          "aliases": [
+            "sobjecttype"
+          ],
+          "char": "s",
+          "deprecateAliases": true,
+          "name": "sobject",
+          "required": true,
+          "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
           "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",
+          "exclusive": [
+            "wait"
+          ],
+          "name": "async",
+          "summary": "Run the command asynchronously.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "name": "verbose",
+          "summary": "Print verbose output of failed records if result is available.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:create:file",
+      "id": "data:delete:bulk",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Upload a local file to an org.",
+      "summary": "Bulk delete records from an org using a CSV file. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "create",
-        "file.js"
+        "delete",
+        "bulk.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:create:file",
-        "create:data:file",
-        "create:file:data",
-        "data:file:create",
-        "file:data:create",
-        "file:create:data"
+        "data:delete:bulk",
+        "delete:data:bulk",
+        "delete:bulk:data",
+        "data:bulk:delete",
+        "bulk:data:delete",
+        "bulk:delete:data"
       ]
     },
-    "data:create:record": {
+    "data:delete:record": {
       "aliases": [
-        "force:data:record:create"
+        "force:data:record:delete"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "You must specify a value for all required fields of the object.\n\nWhen specifying fields, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command inserts a record into Salesforce objects by default. Use the --use-tooling-api flag to insert into a Tooling API object.",
+      "description": "Specify the record you want to delete with either its ID or with a list of field-value pairs that identify the record. If your list of fields identifies more than one record, the delete fails; the error displays how many records were found.\n\nWhen specifying field-value pairs, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command deletes a record from Salesforce objects by default. Use the --use-tooling-api flag to delete from a Tooling API object.",
       "examples": [
-        "Insert a record into the Account object of your default org; only the required Name field has a value:\n<%= config.bin %> <%= command.id %> --sobject Account --values \"Name=Acme\"",
-        "Insert an Account record with values for two fields, one value contains a space; the command uses the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --sobject Account --values \"Name='Universal Containers' Website=www.example.com\" --target-org my-scratch",
-        "Insert a record into the Tooling API object TraceFlag:\n<%= config.bin %> <%= command.id %> --use-tooling-api --sobject TraceFlag --values \"DebugLevelId=7dl170000008U36AAE StartDate=2022-12-15T00:26:04.000+0000 ExpirationDate=2022-12-15T00:56:04.000+0000 LogType=CLASS_TRACING TracedEntityId=01p17000000R6bLAAS\""
+        "Delete a record from Account with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 00180XX",
+        "Delete a record from Account whose name equals \"Acme\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name=Acme\"",
+        "Delete a record from Account identified with two field values, one that contains a space; the command uses the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name='Universal Containers' Phone='(123) 456-7890'\" --target-org myscratch",
+        "Delete a record from the Tooling API object TraceFlag with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --use-tooling-api --sobject TraceFlag --record-id 7tf8c"
       ],
       "flags": {
         "json": {
@@ -499,16 +546,27 @@
           "deprecateAliases": true,
           "name": "sobject",
           "required": true,
-          "summary": "API name of the Salesforce or Tooling API object that you're inserting a record into.",
+          "summary": "API name of the Salesforce or Tooling API object that you're deleting a record from.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "values": {
-          "char": "v",
-          "name": "values",
-          "required": true,
-          "summary": "Values for the flags in the form <fieldName>=<value>, separate multiple pairs with spaces.",
+        "record-id": {
+          "aliases": [
+            "sobjectid"
+          ],
+          "char": "i",
+          "deprecateAliases": true,
+          "name": "record-id",
+          "summary": "ID of the record you’re deleting.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "where": {
+          "char": "w",
+          "name": "where",
+          "summary": "List of <fieldName>=<value> pairs that identify the record you want to delete.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -520,7 +578,7 @@
           "char": "t",
           "deprecateAliases": true,
           "name": "use-tooling-api",
-          "summary": "Use Tooling API so you can insert a record in a Tooling API object.",
+          "summary": "Use Tooling API so you can delete a record from a Tooling API object.",
           "allowNo": false,
           "type": "boolean"
         },
@@ -538,63 +596,64 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:create:record",
+      "id": "data:delete:record",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create and insert a record into a Salesforce or Tooling API object.",
+      "summary": "Deletes a single record from a Salesforce or Tooling API object.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "create",
+        "delete",
         "record.js"
       ],
       "aliasPermutations": [
-        "force:data:record:create",
-        "data:force:record:create",
-        "data:record:force:create",
-        "data:record:create:force",
-        "force:record:data:create",
-        "record:force:data:create",
-        "record:data:force:create",
-        "record:data:create:force",
-        "force:record:create:data",
-        "record:force:create:data",
-        "record:create:force:data",
-        "record:create:data:force",
-        "force:data:create:record",
-        "data:force:create:record",
-        "data:create:force:record",
-        "data:create:record:force",
-        "force:create:data:record",
-        "create:force:data:record",
-        "create:data:force:record",
-        "create:data:record:force",
-        "force:create:record:data",
-        "create:force:record:data",
-        "create:record:force:data",
-        "create:record:data:force"
+        "force:data:record:delete",
+        "data:force:record:delete",
+        "data:record:force:delete",
+        "data:record:delete:force",
+        "force:record:data:delete",
+        "record:force:data:delete",
+        "record:data:force:delete",
+        "record:data:delete:force",
+        "force:record:delete:data",
+        "record:force:delete:data",
+        "record:delete:force:data",
+        "record:delete:data:force",
+        "force:data:delete:record",
+        "data:force:delete:record",
+        "data:delete:force:record",
+        "data:delete:record:force",
+        "force:delete:data:record",
+        "delete:force:data:record",
+        "delete:data:force:record",
+        "delete:data:record:force",
+        "force:delete:record:data",
+        "delete:force:record:data",
+        "delete:record:force:data",
+        "delete:record:data:force"
       ],
       "permutations": [
-        "data:create:record",
-        "create:data:record",
-        "create:record:data",
-        "data:record:create",
-        "record:data:create",
-        "record:create:data"
+        "data:delete:record",
+        "delete:data:record",
+        "delete:record:data",
+        "data:record:delete",
+        "record:data:delete",
+        "record:delete:data"
       ]
     },
-    "data:delete:bulk": {
+    "data:delete:resume": {
       "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, 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 ID to check the status of the job with the \"<%= config.bin %> data delete resume\" command.",
+      "deprecateAliases": true,
+      "description": "The command uses the job ID returned by the \"<%= config.bin %> data delete bulk\" command or the most recently-run bulk delete job.",
       "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"
+        "Resume a bulk delete job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
+        "Resume the most recently run bulk delete job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -621,17 +680,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": "0 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,
@@ -647,70 +730,16 @@
           "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 update or delete.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sobject": {
-          "aliases": [
-            "sobjecttype"
-          ],
-          "char": "s",
-          "deprecateAliases": true,
-          "name": "sobject",
-          "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
-          "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",
-          "exclusive": [
-            "wait"
-          ],
-          "name": "async",
-          "summary": "Run the command asynchronously.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verbose": {
-          "name": "verbose",
-          "summary": "Print verbose output of failed records if result is available.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:delete:bulk",
+      "id": "data:delete:resume",
       "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 2.0.",
+      "summary": "Resume a bulk delete job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -718,30 +747,26 @@
         "commands",
         "data",
         "delete",
-        "bulk.js"
+        "resume.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:delete:bulk",
-        "delete:data:bulk",
-        "delete:bulk:data",
-        "data:bulk:delete",
-        "bulk:data:delete",
-        "bulk:delete:data"
+        "data:delete:resume",
+        "delete:data:resume",
+        "delete:resume:data",
+        "data:resume:delete",
+        "resume:data:delete",
+        "resume:delete:data"
       ]
     },
-    "data:delete:record": {
-      "aliases": [
-        "force:data:record:delete"
-      ],
+    "data:create:file": {
+      "aliases": [],
       "args": {},
-      "deprecateAliases": true,
-      "description": "Specify the record you want to delete with either its ID or with a list of field-value pairs that identify the record. If your list of fields identifies more than one record, the delete fails; the error displays how many records were found.\n\nWhen specifying field-value pairs, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command deletes a record from Salesforce objects by default. Use the --use-tooling-api flag to delete from a Tooling API object.",
+      "description": "This command always creates a new file in the org; you can't update an existing file. After a successful upload, the command displays the ID of the new ContentDocument record which represents the uploaded file.\n\nBy default, the uploaded file isn't attached to a record; in the Salesforce UI the file shows up in the Files tab. You can optionally attach the file to an existing record, such as an account, as long as you know its record ID.\n\nYou can also give the file a new name after it's been uploaded; by default its name in the org is the same as the local file name.",
       "examples": [
-        "Delete a record from Account with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 00180XX",
-        "Delete a record from Account whose name equals \"Acme\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name=Acme\"",
-        "Delete a record from Account identified with two field values, one that contains a space; the command uses the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name='Universal Containers' Phone='(123) 456-7890'\" --target-org myscratch",
-        "Delete a record from the Tooling API object TraceFlag with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --use-tooling-api --sobject TraceFlag --record-id 7tf8c"
+        "Upload the local file \"resources/astro.png\" to your default org:\n<%= config.bin %> <%= command.id %> --file resources/astro.png",
+        "Give the file a different filename after it's uploaded to the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --file resources/astro.png --title AstroOnABoat.png --target-org my-scratch",
+        "Attach the file to a record in the org:\n<%= config.bin %> <%= command.id %> --file path/to/astro.png --parent-id a03fakeLoJWPIA3"
       ],
       "flags": {
         "json": {
@@ -760,12 +785,7 @@
           "type": "option"
         },
         "target-org": {
-          "aliases": [
-            "targetusername",
-            "u"
-          ],
           "char": "o",
-          "deprecateAliases": true,
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
@@ -775,142 +795,77 @@
           "type": "option"
         },
         "api-version": {
-          "aliases": [
-            "apiversion"
-          ],
-          "deprecateAliases": true,
           "description": "Override the api version used for api requests made by this command",
           "name": "api-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "loglevel": {
-          "deprecated": {
-            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
-          },
-          "hidden": true,
-          "name": "loglevel",
+        "title": {
+          "char": "t",
+          "name": "title",
+          "required": false,
+          "summary": "New title given to the file (ContentDocument) after it's uploaded.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "sobject": {
-          "aliases": [
-            "sobjecttype"
-          ],
-          "char": "s",
-          "deprecateAliases": true,
-          "name": "sobject",
+        "file": {
+          "char": "f",
+          "name": "file",
           "required": true,
-          "summary": "API name of the Salesforce or Tooling API object that you're deleting a record from.",
+          "summary": "Path of file to upload.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "record-id": {
-          "aliases": [
-            "sobjectid"
-          ],
+        "parent-id": {
           "char": "i",
-          "deprecateAliases": true,
-          "name": "record-id",
-          "summary": "ID of the record you’re deleting.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "where": {
-          "char": "w",
-          "name": "where",
-          "summary": "List of <fieldName>=<value> pairs that identify the record you want to delete.",
+          "name": "parent-id",
+          "summary": "ID of the record to attach the file to.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "use-tooling-api": {
-          "aliases": [
-            "usetoolingapi"
-          ],
-          "char": "t",
-          "deprecateAliases": true,
-          "name": "use-tooling-api",
-          "summary": "Use Tooling API so you can delete a record from a Tooling API object.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "perflog": {
-          "deprecated": {
-            "version": "57"
-          },
-          "description": "Gets data on API performance metrics from the server. The data is stored in $HOME/.sfdx/apiPerformanceLog.json.",
-          "hidden": true,
-          "name": "perflog",
-          "summary": "Get API performance data.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:delete:record",
+      "id": "data:create:file",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Deletes a single record from a Salesforce or Tooling API object.",
+      "summary": "Upload a local file to an org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "delete",
-        "record.js"
-      ],
-      "aliasPermutations": [
-        "force:data:record:delete",
-        "data:force:record:delete",
-        "data:record:force:delete",
-        "data:record:delete:force",
-        "force:record:data:delete",
-        "record:force:data:delete",
-        "record:data:force:delete",
-        "record:data:delete:force",
-        "force:record:delete:data",
-        "record:force:delete:data",
-        "record:delete:force:data",
-        "record:delete:data:force",
-        "force:data:delete:record",
-        "data:force:delete:record",
-        "data:delete:force:record",
-        "data:delete:record:force",
-        "force:delete:data:record",
-        "delete:force:data:record",
-        "delete:data:force:record",
-        "delete:data:record:force",
-        "force:delete:record:data",
-        "delete:force:record:data",
-        "delete:record:force:data",
-        "delete:record:data:force"
+        "create",
+        "file.js"
       ],
+      "aliasPermutations": [],
       "permutations": [
-        "data:delete:record",
-        "delete:data:record",
-        "delete:record:data",
-        "data:record:delete",
-        "record:data:delete",
-        "record:delete:data"
+        "data:create:file",
+        "create:data:file",
+        "create:file:data",
+        "data:file:create",
+        "file:data:create",
+        "file:create:data"
       ]
     },
-    "data:delete:resume": {
-      "aliases": [],
+    "data:create:record": {
+      "aliases": [
+        "force:data:record:create"
+      ],
       "args": {},
       "deprecateAliases": true,
-      "description": "The command uses the job ID returned by the \"<%= config.bin %> data delete bulk\" command or the most recently-run bulk delete job.",
+      "description": "You must specify a value for all required fields of the object.\n\nWhen specifying fields, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command inserts a record into Salesforce objects by default. Use the --use-tooling-api flag to insert into a Tooling API object.",
       "examples": [
-        "Resume a bulk delete job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
-        "Resume the most recently run bulk delete job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
+        "Insert a record into the Account object of your default org; only the required Name field has a value:\n<%= config.bin %> <%= command.id %> --sobject Account --values \"Name=Acme\"",
+        "Insert an Account record with values for two fields, one value contains a space; the command uses the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --sobject Account --values \"Name='Universal Containers' Website=www.example.com\" --target-org my-scratch",
+        "Insert a record into the Tooling API object TraceFlag:\n<%= config.bin %> <%= command.id %> --use-tooling-api --sobject TraceFlag --values \"DebugLevelId=7dl170000008U36AAE StartDate=2022-12-15T00:26:04.000+0000 ExpirationDate=2022-12-15T00:56:04.000+0000 LogType=CLASS_TRACING TracedEntityId=01p17000000R6bLAAS\""
       ],
       "flags": {
         "json": {
@@ -937,41 +892,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": "0 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,
@@ -987,33 +918,102 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "sobject": {
+          "aliases": [
+            "sobjecttype"
+          ],
+          "char": "s",
+          "deprecateAliases": true,
+          "name": "sobject",
+          "required": true,
+          "summary": "API name of the Salesforce or Tooling API object that you're inserting a record into.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "values": {
+          "char": "v",
+          "name": "values",
+          "required": true,
+          "summary": "Values for the flags in the form <fieldName>=<value>, separate multiple pairs with spaces.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "use-tooling-api": {
+          "aliases": [
+            "usetoolingapi"
+          ],
+          "char": "t",
+          "deprecateAliases": true,
+          "name": "use-tooling-api",
+          "summary": "Use Tooling API so you can insert a record in a Tooling API object.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "perflog": {
+          "deprecated": {
+            "version": "57"
+          },
+          "description": "Gets data on API performance metrics from the server. The data is stored in $HOME/.sfdx/apiPerformanceLog.json.",
+          "hidden": true,
+          "name": "perflog",
+          "summary": "Get API performance data.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:delete:resume",
+      "id": "data:create:record",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume a bulk delete job that you previously started. Uses Bulk API 2.0.",
+      "summary": "Create and insert a record into a Salesforce or Tooling API object.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "delete",
-        "resume.js"
+        "create",
+        "record.js"
+      ],
+      "aliasPermutations": [
+        "force:data:record:create",
+        "data:force:record:create",
+        "data:record:force:create",
+        "data:record:create:force",
+        "force:record:data:create",
+        "record:force:data:create",
+        "record:data:force:create",
+        "record:data:create:force",
+        "force:record:create:data",
+        "record:force:create:data",
+        "record:create:force:data",
+        "record:create:data:force",
+        "force:data:create:record",
+        "data:force:create:record",
+        "data:create:force:record",
+        "data:create:record:force",
+        "force:create:data:record",
+        "create:force:data:record",
+        "create:data:force:record",
+        "create:data:record:force",
+        "force:create:record:data",
+        "create:force:record:data",
+        "create:record:force:data",
+        "create:record:data:force"
       ],
-      "aliasPermutations": [],
       "permutations": [
-        "data:delete:resume",
-        "delete:data:resume",
-        "delete:resume:data",
-        "data:resume:delete",
-        "resume:data:delete",
-        "resume:delete:data"
+        "data:create:record",
+        "create:data:record",
+        "create:record:data",
+        "data:record:create",
+        "record:data:create",
+        "record:create:data"
       ]
     },
     "data:export:tree": {
@@ -2917,5 +2917,5 @@
       ]
     }
   },
-  "version": "3.4.5"
+  "version": "3.4.6"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/plugin-data",
-    "version": "3.4.5",
+    "version": "3.4.6",
     "description": "Plugin for salesforce data commands",
     "author": "Salesforce",
     "homepage": "https://github.com/salesforcecli/plugin-data",
@@ -120,13 +120,13 @@
         "form-data": "^4.0.0"
     },
     "devDependencies": {
-        "@oclif/plugin-command-snapshot": "^5.2.0",
-        "@salesforce/cli-plugins-testkit": "^5.3.9",
+        "@oclif/plugin-command-snapshot": "^5.2.2",
+        "@salesforce/cli-plugins-testkit": "^5.3.10",
         "@salesforce/dev-scripts": "^10.1.0",
         "@salesforce/plugin-command-reference": "^3.0.89",
         "@salesforce/types": "^1.1.0",
         "eslint-plugin-sf-plugin": "^1.18.5",
-        "oclif": "^4.12.1",
+        "oclif": "^4.13.2",
         "ts-node": "^10.9.2",
         "typescript": "^5.4.5"
     },
@@ -248,7 +248,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.4.5.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.4.5.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.4.6.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-data/3.4.6.sig"
     }
 }