@salesforce/plugin-data 3.3.5 → 3.4.1

package/README.md

@@ -76,6 +76,7 @@ sf plugins
 
 <!-- commands -->
 
+- [`sf data create file`](#sf-data-create-file)
 - [`sf data create record`](#sf-data-create-record)
 - [`sf data delete bulk`](#sf-data-delete-bulk)
 - [`sf data delete record`](#sf-data-delete-record)
@@ -95,6 +96,55 @@ sf plugins
 - [`sf force data bulk status`](#sf-force-data-bulk-status)
 - [`sf force data bulk upsert`](#sf-force-data-bulk-upsert)
 
+## `sf data create file`
+
+Upload a local file to an org.
+
+```
+USAGE
+  $ sf data create file -o <value> -f <value> [--json] [--flags-dir <value>] [--api-version <value>] [-t <value>] [-i
+    <value>]
+
+FLAGS
+  -f, --file=<value>         (required) Path of file to upload.
+  -i, --parent-id=<value>    ID of the record to attach the file to.
+  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
+                             configuration variable is already set.
+  -t, --title=<value>        New title given to the file (ContentDocument) after it's uploaded.
+      --api-version=<value>  Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Upload a local file to an org.
+
+  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.
+
+  By 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.
+
+  You 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
+  Upload the local file "resources/astro.png" to your default org:
+
+    $ sf data create file --file resources/astro.png
+
+  Give the file a different filename after it's uploaded to the org with alias "my-scratch":
+
+    $ sf data create file --file resources/astro.png --title AstroOnABoat.png --target-org my-scratch
+
+  Attach the file to a record in the org:
+
+    $ 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.1/src/commands/data/create/file.ts)_
+
 ## `sf data create record`
 
 Create and insert a record into a Salesforce or Tooling API object.
@@ -149,7 +199,7 @@ EXAMPLES
       TracedEntityId=01p17000000R6bLAAS"
 ```
 
-_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.3.5/src/commands/data/create/record.ts)_
+_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/create/record.ts)_
 
 ## `sf data delete bulk`
 
@@ -196,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.3.5/src/commands/data/delete/bulk.ts)_
+_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/delete/bulk.ts)_
 
 ## `sf data delete record`
 
@@ -257,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.3.5/src/commands/data/delete/record.ts)_
+_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/delete/record.ts)_
 
 ## `sf data delete resume`
 
@@ -296,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.3.5/src/commands/data/delete/resume.ts)_
+_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/delete/resume.ts)_
 
 ## `sf data export beta tree`
 
@@ -354,7 +404,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/export/beta/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.3.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.1/src/commands/data/export/beta/tree.ts)_
 
 ## `sf data export tree`
 
@@ -414,7 +464,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.3.5/src/commands/data/export/tree.ts)_
+_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/export/tree.ts)_
 
 ## `sf data get record`
 
@@ -478,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.3.5/src/commands/data/get/record.ts)_
+_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/get/record.ts)_
 
 ## `sf data import beta tree`
 
@@ -521,7 +571,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.3.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.1/src/commands/data/import/beta/tree.ts)_
 
 ## `sf data import tree`
 
@@ -571,7 +621,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.3.5/src/commands/data/import/tree.ts)_
+_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/import/tree.ts)_
 
 ## `sf data query`
 
@@ -635,7 +685,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.3.5/src/commands/data/query.ts)_
+_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/query.ts)_
 
 ## `sf data query resume`
 
@@ -673,7 +723,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.3.5/src/commands/data/query/resume.ts)_
+_See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/query/resume.ts)_
 
 ## `sf data resume`
 
@@ -710,7 +760,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.3.5/src/commands/data/resume.ts)_
+_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/resume.ts)_
 
 ## `sf data update record`
 
@@ -772,7 +822,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.3.5/src/commands/data/update/record.ts)_
+_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/update/record.ts)_
 
 ## `sf data upsert bulk`
 
@@ -825,7 +875,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.3.5/src/commands/data/upsert/bulk.ts)_
+_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/upsert/bulk.ts)_
 
 ## `sf data upsert resume`
 
@@ -864,7 +914,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.3.5/src/commands/data/upsert/resume.ts)_
+_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.4.1/src/commands/data/upsert/resume.ts)_
 
 ## `sf force data bulk delete`
 
@@ -911,7 +961,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.3.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.1/src/commands/force/data/bulk/delete.ts)_
 
 ## `sf force data bulk status`
 
@@ -948,7 +998,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.3.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.1/src/commands/force/data/bulk/status.ts)_
 
 ## `sf force data bulk upsert`
 
@@ -1006,6 +1056,6 @@ EXAMPLES
       --target-org my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.3.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.1/src/commands/force/data/bulk/upsert.ts)_
 
 <!-- commandsstop -->

package/lib/api/file/fileToContentVersion.js

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2023, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+import FormData from 'form-data';
+export async function file2CV(conn, filepath, title) {
+    const req = {
+        PathOnClient: filepath,
+        Title: title,
+    };
+    const form = new FormData();
+    form.append('VersionData', await readFile(filepath), { filename: title ?? basename(filepath) });
+    form.append('entity_content', JSON.stringify(req), { contentType: 'application/json' });
+    // POST the multipart form to Salesforce's API, can't use the normal "create" action because it doesn't support multipart
+    const CV = await conn.request({
+        url: '/sobjects/ContentVersion',
+        headers: { ...form.getHeaders() },
+        body: form.getBuffer(),
+        method: 'POST',
+    });
+    return conn.singleRecordQuery(`Select Id, ContentDocumentId, Title, FileExtension from ContentVersion where Id='${CV.id}'`);
+}
+//# sourceMappingURL=fileToContentVersion.js.map

package/lib/api/file/fileToContentVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileToContentVersion.js","sourceRoot":"","sources":["../../../src/api/file/fileToContentVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,OAAO,QAAQ,MAAM,WAAW,CAAC;AAejC,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAgB,EAAE,QAAgB,EAAE,KAAc;IAC9E,MAAM,GAAG,GAAgC;QACvC,YAAY,EAAE,QAAQ;QACtB,KAAK,EAAE,KAAK;KACb,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAExF,yHAAyH;IACzH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAa;QACxC,GAAG,EAAE,0BAA0B;QAC/B,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE;QACjC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE;QACtB,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,iBAAiB,CAC3B,oFAAoF,EAAE,CAAC,EAAE,GAAG,CAC7F,CAAC;AACJ,CAAC"}

package/lib/commands/data/create/file.js

@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) 2023, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages, SfError } from '@salesforce/core';
+import { file2CV } from '../../../api/file/fileToContentVersion.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-data', 'data.create.file');
+export default class DataCreateFile extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'target-org': Flags.requiredOrg(),
+        'api-version': Flags.orgApiVersion(),
+        title: Flags.string({
+            summary: messages.getMessage('flags.title.summary'),
+            char: 't',
+            required: false,
+        }),
+        file: Flags.file({
+            summary: messages.getMessage('flags.file.summary'),
+            char: 'f',
+            required: true,
+            exists: true,
+        }),
+        // it really could be most any valid ID
+        // eslint-disable-next-line sf-plugin/id-flag-suggestions
+        'parent-id': Flags.salesforceId({
+            summary: messages.getMessage('flags.parent-id.summary'),
+            char: 'i',
+            length: 'both',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DataCreateFile);
+        const conn = flags['target-org'].getConnection(flags['api-version']);
+        const cv = await file2CV(conn, flags.file, flags.title);
+        this.logSuccess(messages.getMessage('createSuccess', [cv.ContentDocumentId]));
+        if (!flags['parent-id']) {
+            return cv;
+        }
+        const CDLReq = {
+            ContentDocumentId: cv.ContentDocumentId,
+            LinkedEntityId: flags['parent-id'],
+            ShareType: 'V',
+        };
+        try {
+            const CDLCreateResult = await conn.sobject('ContentDocumentLink').create(CDLReq);
+            if (CDLCreateResult.success) {
+                this.logSuccess(messages.getMessage('attachSuccess', [flags['parent-id']]));
+                return cv;
+            }
+            else {
+                throw SfError.create({
+                    message: messages.getMessage('attachFailure'),
+                    data: CDLCreateResult.errors,
+                });
+            }
+        }
+        catch (e) {
+            const error = SfError.wrap(e);
+            if (error.name === 'INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY') {
+                error.actions = messages.getMessages('insufficientAccessActions');
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=file.js.map

package/lib/commands/data/create/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../../src/commands/data/create/file.ts"],"names":[],"mappings":"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"}

package/messages/data.create.file.md

@@ -0,0 +1,53 @@
+# summary
+
+Upload a local file to an org.
+
+# 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.
+
+By 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.
+
+You 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.
+
+# flags.title.summary
+
+New title given to the file (ContentDocument) after it's uploaded.
+
+# examples
+
+- Upload the local file "resources/astro.png" to your default org:
+
+  <%= 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":
+
+  <%= config.bin %> <%= command.id %> --file resources/astro.png --title AstroOnABoat.png --target-org my-scratch
+
+- Attach the file to a record in the org:
+
+  <%= config.bin %> <%= command.id %> --file path/to/astro.png --parent-id a03fakeLoJWPIA3
+
+# flags.file.summary
+
+Path of file to upload.
+
+# flags.parent-id.summary
+
+ID of the record to attach the file to.
+
+# createSuccess
+
+Created file with ContentDocumentId %s.
+
+# attachSuccess
+
+File attached to record with ID %s.
+
+# attachFailure
+
+The file was successfully uploaded, but we weren't able to attach it to the record.
+
+# insufficientAccessActions
+
+- Check that the record ID is correct and that you have access to it.