chore(release): 3.8.0 [skip ci]

CHANGELOG.md

@@ -1,3 +1,9 @@
+# [3.8.0](https://github.com/salesforcecli/plugin-data/compare/3.7.1...3.8.0) (2024-10-18)
+
+### Features
+
+- add `import bulk/resume` commands ([#1091](https://github.com/salesforcecli/plugin-data/issues/1091)) ([b379335](https://github.com/salesforcecli/plugin-data/commit/b379335eb6e832de2abd8a144bc3b09c16bb70cd)), closes [#1093](https://github.com/salesforcecli/plugin-data/issues/1093)
+
 ## [3.7.1](https://github.com/salesforcecli/plugin-data/compare/3.7.0...3.7.1) (2024-10-09)
 
 ### Bug Fixes

README.md

@@ -85,6 +85,8 @@ sf plugins
 - [`sf data export resume`](#sf-data-export-resume)
 - [`sf data export tree`](#sf-data-export-tree)
 - [`sf data get record`](#sf-data-get-record)
+- [`sf data import bulk`](#sf-data-import-bulk)
+- [`sf data import resume`](#sf-data-import-resume)
 - [`sf data import tree`](#sf-data-import-tree)
 - [`sf data query`](#sf-data-query)
 - [`sf data query resume`](#sf-data-query-resume)
@@ -144,7 +146,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.7.1/src/commands/data/create/file.ts)_
+_See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/create/file.ts)_
 
 ## `sf data create record`
 
@@ -200,7 +202,7 @@ EXAMPLES
       TracedEntityId=01p17000000R6bLAAS"
 ```
 
-_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.7.1/src/commands/data/create/record.ts)_
+_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/create/record.ts)_
 
 ## `sf data delete bulk`
 
@@ -258,7 +260,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.7.1/src/commands/data/delete/bulk.ts)_
+_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/delete/bulk.ts)_
 
 ## `sf data delete record`
 
@@ -319,7 +321,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.7.1/src/commands/data/delete/record.ts)_
+_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/delete/record.ts)_
 
 ## `sf data delete resume`
 
@@ -358,7 +360,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.7.1/src/commands/data/delete/resume.ts)_
+_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/delete/resume.ts)_
 
 ## `sf data export bulk`
 
@@ -432,7 +434,7 @@ EXAMPLES
       --result-format json --async
 ```
 
-_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.7.1/src/commands/data/export/bulk.ts)_
+_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/export/bulk.ts)_
 
 ## `sf data export resume`
 
@@ -468,7 +470,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.7.1/src/commands/data/export/resume.ts)_
+_See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/export/resume.ts)_
 
 ## `sf data export tree`
 
@@ -529,7 +531,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.7.1/src/commands/data/export/tree.ts)_
+_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/export/tree.ts)_
 
 ## `sf data get record`
 
@@ -593,7 +595,99 @@ 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.7.1/src/commands/data/get/record.ts)_
+_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/get/record.ts)_
+
+## `sf data import bulk`
+
+Bulk import records into a Salesforce object from a CSV file. Uses Bulk API 2.0.
+
+```
+USAGE
+  $ sf data import bulk -s <value> -o <value> [--json] [--flags-dir <value>] [-a | -w <value>] [--api-version <value>]
+    (--line-ending CRLF|LF -f <value>)
+
+FLAGS
+  -a, --async                 Don't wait for the command to complete.
+  -f, --file=<value>          (required) CSV file that contains the Salesforce object records you want to import.
+  -o, --target-org=<value>    (required) Username or alias of the target org. Not required if the `target-org`
+                              configuration variable is already set.
+  -s, --sobject=<value>       (required) API name of the Salesforce object, either standard or custom, into which you're
+                              importing records.
+  -w, --wait=<value>          Time to wait for the command to finish, in minutes.
+      --api-version=<value>   Override the api version used for api requests made by this command
+      --line-ending=<option>  Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux
+                              it's `LR`.
+                              <options: CRLF|LF>
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Bulk import records into a Salesforce object from a CSV file. Uses Bulk API 2.0.
+
+  You can use this command to import millions of records into the object from a file in comma-separated values (CSV)
+  format.
+
+  All the records in the CSV file must be for the same Salesforce object. Specify the object with the `--sobject` flag.
+
+  Bulk imports can take a while, depending on how many records are in the CSV file. If the command times out, or you
+  specified the --async flag, the command displays the job ID. To see the status and get the results of the job, run "sf
+  data import resume" and pass the job ID to the --job-id flag.
+
+  For information and examples about how to prepare your CSV files, see "Prepare Data to Ingest" in the "Bulk API 2.0
+  and Bulk API Developer Guide"
+  (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_data.htm).
+
+EXAMPLES
+  Import Account records from a CSV-formatted file into an org with alias "my-scratch"; if the import doesn't complete
+  in 10 minutes, the command ends and displays a job ID:
+
+    $ sf data import bulk --file accounts.csv --sobject Account --wait 10 --target-org my-scratch
+
+  Import asynchronously and use the default org; the command immediately returns a job ID that you then pass to the
+  "sf data import resume" command:
+
+    $ 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.8.0/src/commands/data/import/bulk.ts)_
+
+## `sf data import resume`
+
+Resume a bulk import job that you previously started. Uses Bulk API 2.0.
+
+```
+USAGE
+  $ sf data import resume [--json] [--flags-dir <value>] [--use-most-recent] [-i <value>] [-w <value>]
+
+FLAGS
+  -i, --job-id=<value>   Job ID of the bulk import.
+  -w, --wait=<value>     [default: 5 minutes] Time to wait for the command to finish, in minutes.
+      --use-most-recent  Use the job ID of the bulk import job that was most recently run.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Resume a bulk import job that you previously started. Uses Bulk API 2.0.
+
+  When the original "sf data import bulk" command either times out or is run with the --async flag, it displays a job
+  ID. To see the status and get the results of the bulk import, run this command by either passing it the job ID or
+  using the --use-most-recent flag to specify the most recent bulk import job.
+
+EXAMPLES
+  Resume a bulk import job to your default org using an ID:
+
+    $ sf data import resume --job-id 750xx000000005sAAA
+
+  Resume the most recently run bulk import job for an org with alias my-scratch:
+
+    $ 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.8.0/src/commands/data/import/resume.ts)_
 
 ## `sf data import tree`
 
@@ -658,7 +752,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.7.1/src/commands/data/import/tree.ts)_
+_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/import/tree.ts)_
 
 ## `sf data query`
 
@@ -722,7 +816,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.7.1/src/commands/data/query.ts)_
+_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/query.ts)_
 
 ## `sf data query resume`
 
@@ -760,7 +854,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.7.1/src/commands/data/query/resume.ts)_
+_See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/query/resume.ts)_
 
 ## `sf data resume`
 
@@ -797,7 +891,7 @@ EXAMPLES
     $ sf data resume --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA
 ```
 
-_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.7.1/src/commands/data/resume.ts)_
+_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/resume.ts)_
 
 ## `sf data search`
 
@@ -847,7 +941,7 @@ EXAMPLES
     $ sf data search --file query.txt --target-org my-scratch --result-format csv
 ```
 
-_See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/3.7.1/src/commands/data/search.ts)_
+_See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/search.ts)_
 
 ## `sf data update record`
 
@@ -909,7 +1003,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.7.1/src/commands/data/update/record.ts)_
+_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/update/record.ts)_
 
 ## `sf data upsert bulk`
 
@@ -962,7 +1056,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.7.1/src/commands/data/upsert/bulk.ts)_
+_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/upsert/bulk.ts)_
 
 ## `sf data upsert resume`
 
@@ -1001,7 +1095,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.7.1/src/commands/data/upsert/resume.ts)_
+_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/data/upsert/resume.ts)_
 
 ## `sf force data bulk delete`
 
@@ -1048,7 +1142,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.7.1/src/commands/force/data/bulk/delete.ts)_
+_See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/force/data/bulk/delete.ts)_
 
 ## `sf force data bulk status`
 
@@ -1085,7 +1179,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.7.1/src/commands/force/data/bulk/status.ts)_
+_See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/force/data/bulk/status.ts)_
 
 ## `sf force data bulk upsert`
 
@@ -1143,6 +1237,6 @@ EXAMPLES
       --target-org my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.7.1/src/commands/force/data/bulk/upsert.ts)_
+_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.8.0/src/commands/force/data/bulk/upsert.ts)_
 
 <!-- commandsstop -->

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/plugin-data",
-  "version": "3.7.1",
+  "version": "3.8.0",
   "description": "Plugin for salesforce data commands",
   "author": "Salesforce",
   "homepage": "https://github.com/salesforcecli/plugin-data",