@pipedream/salesforce_rest_api 0.3.3 → 0.4.0

package/salesforce_rest_api.app.mjs

@@ -6,29 +6,35 @@ export default {
   type: "app",
   app: "salesforce_rest_api",
   propDefinitions: {
+    sobjectId: {
+      type: "string",
+      label: "SObject ID",
+      description: "ID of the Standard object to get field values from",
+      async options(context) {
+        const { objectType } = context;
+        const { recentItems } = await this.listSObjectTypeIds(objectType);
+        return recentItems.map((item) => ({
+          label: item.Name,
+          value: item.Id,
+        }));
+      },
+    },
     objectType: {
       type: "string",
-      label: "Object Type",
-      description: "The type of object for which to monitor events",
+      label: "SObject Type",
+      description: "Standard object type of the record to get field values from",
       async options(context) {
-        const {
-          page,
-          eventType,
-        } = context;
+        const { page } = context;
         if (page !== 0) {
-          // The list of allowed SObject types is static and exhaustively
-          // provided through a single method call
           return [];
         }
-
-        const supportedObjectTypes = this.listAllowedSObjectTypes(eventType);
-        const options = supportedObjectTypes.map((i) => ({
-          label: i.label,
-          value: i.name,
-        }));
-        return {
-          options,
-        };
+        const { sobjects } = await this.listSObjectTypes();
+        return sobjects
+          .filter((sobject) => sobject.replicateable)
+          .map((sobject) => ({
+            label: sobject.label,
+            value: sobject.name,
+          }));
       },
     },
     field: {
@@ -41,9 +47,7 @@ export default {
           objectType,
         } = context;
         if (page !== 0) {
-          return {
-            options: [],
-          };
+          return [];
         }
 
         const fields = await this.getFieldsForObjectType(objectType);
@@ -53,9 +57,35 @@ export default {
     fieldUpdatedTo: {
       type: "string",
       label: "Field Updated to",
-      description: "If provided, the trigger will only fire when the updated field is an EXACT MATCH (including spacing and casing) to the value you provide in this field",
+      description:
+        "If provided, the trigger will only fire when the updated field is an EXACT MATCH (including spacing and casing) to the value you provide in this field",
       optional: true,
     },
+    fieldSelector: {
+      type: "string[]",
+      label: "Field Selector",
+      description: "Select fields for the Standard Object",
+      options: () => [], // override options for each object, e.g., () => Object.keys(account)
+    },
+    AcceptedEventInviteeIds: {
+      type: "string[]",
+      label: "Accepted Event Invitee IDs",
+      async options() {
+        const { recentItems: contacts } = await this.listSObjectTypeIds("Contact");
+        const { recentItems: leads } = await this.listSObjectTypeIds("Lead");
+        const allContacts = [
+          ...contacts,
+          ...leads,
+        ];
+        return allContacts.map(({
+          Name, Id,
+        }) => ({
+          label: Name,
+          value: Id,
+        }));
+      },
+      description: "A string array of contact or lead IDs who accepted this event. This JunctionIdList is linked to the AcceptedEventRelation child relationship. Warning Adding a JunctionIdList field name to the fieldsToNull property deletes all related junction records. This action can't be undone.",
+    },
   },
   methods: {
     _authToken() {
@@ -80,34 +110,46 @@ export default {
     },
     _baseApiUrl() {
       return (
-        this._instanceUrl() ||
-        `https://${this._subdomain()}.salesforce.com`
+        this._instanceUrl() || `https://${this._subdomain()}.salesforce.com`
       );
     },
     _userApiUrl() {
       const baseUrl = this._baseApiUrl();
       return `${baseUrl}/services/oauth2/userinfo`;
     },
+    _baseApiVersionUrl() {
+      const baseUrl = this._baseApiUrl();
+      const apiVersion = this._apiVersion();
+      return `${baseUrl}/services/data/v${apiVersion}`;
+    },
     _sObjectsApiUrl() {
+      const baseUrl = this._baseApiVersionUrl();
+      return `${baseUrl}/sobjects`;
+    },
+    _sCompositeApiUrl() {
       const baseUrl = this._baseApiUrl();
       const apiVersion = this._apiVersion();
-      return `${baseUrl}/services/data/v${apiVersion}/sobjects`;
+      return `${baseUrl}/services/data/v${apiVersion}/composite/sobjects`;
     },
-    _sObjectTypeDescriptionApiUrl(sObjectType) {
+    _sObjectTypeApiUrl(sObjectType) {
       const baseUrl = this._sObjectsApiUrl();
-      return `${baseUrl}/${sObjectType}/describe`;
+      return `${baseUrl}/${sObjectType}`;
+    },
+    _sObjectTypeDescriptionApiUrl(sObjectType) {
+      const baseUrl = this._sObjectTypeApiUrl(sObjectType);
+      return `${baseUrl}/describe`;
     },
     _sObjectTypeUpdatedApiUrl(sObjectType) {
-      const baseUrl = this._sObjectsApiUrl();
-      return `${baseUrl}/${sObjectType}/updated`;
+      const baseUrl = this._sObjectTypeApiUrl(sObjectType);
+      return `${baseUrl}/updated`;
     },
     _sObjectTypeDeletedApiUrl(sObjectType) {
-      const baseUrl = this._sObjectsApiUrl();
-      return `${baseUrl}/${sObjectType}/deleted`;
+      const baseUrl = this._sObjectTypeApiUrl(sObjectType);
+      return `${baseUrl}/deleted`;
     },
     _sObjectDetailsApiUrl(sObjectType, id) {
-      const baseUrl = this._sObjectsApiUrl();
-      return `${baseUrl}/${sObjectType}/${id}`;
+      const baseUrl = this._sObjectTypeApiUrl(sObjectType);
+      return `${baseUrl}/${id}`;
     },
     _makeRequestHeaders() {
       const authToken = this._authToken();
@@ -147,8 +189,17 @@ export default {
       };
       return new SalesforceClient(clientOpts);
     },
+    async additionalProps(selector, sobject) {
+      return selector.reduce((props, prop) => ({
+        ...props,
+        [prop]: sobject[prop],
+      }), {});
+    },
     isHistorySObject(sobject) {
-      return sobject.associateEntityType === "History" && sobject.name.includes("History");
+      return (
+        sobject.associateEntityType === "History" &&
+        sobject.name.includes("History")
+      );
     },
     listAllowedSObjectTypes(eventType) {
       const verbose = true;
@@ -180,6 +231,12 @@ export default {
         url,
       });
     },
+    async listSObjectTypeIds(objectType) {
+      const url = this._sObjectTypeApiUrl(objectType);
+      return this._makeRequest({
+        url,
+      });
+    },
     async getNameFieldForObjectType(objectType) {
       const url = this._sObjectTypeDescriptionApiUrl(objectType);
       const data = await this._makeRequest({
@@ -200,15 +257,39 @@ export default {
     async getHistorySObjectForObjectType(objectType) {
       const { sobjects } = await this.listSObjectTypes();
       const historyObject = sobjects.find(
-        (sobject) => sobject.associateParentEntity === objectType
-            && this.isHistorySObject(sobject),
+        (sobject) =>
+          sobject.associateParentEntity === objectType &&
+          this.isHistorySObject(sobject),
       );
       return historyObject;
     },
-    async getSObject(objectType, id) {
+    async createObject(objectType, data) {
+      const url = `${this._sObjectsApiUrl()}/${objectType}`;
+      return this._makeRequest({
+        url,
+        data,
+        method: "POST",
+      });
+    },
+    async deleteObject(objectType, sobjectId) {
+      const url = `${this._sObjectsApiUrl()}/${objectType}/${sobjectId}`;
+      return this._makeRequest({
+        url,
+        method: "DELETE",
+      });
+    },
+    async getRecords(objectType, params) {
+      const url = `${this._sCompositeApiUrl()}/${objectType}`;
+      return this._makeRequest({
+        url,
+        params,
+      });
+    },
+    async getSObject(objectType, id, params = null) {
       const url = this._sObjectDetailsApiUrl(objectType, id);
       return this._makeRequest({
         url,
+        params,
       });
     },
     async getUpdatedForObjectType(objectType, start, end) {
@@ -239,9 +320,240 @@ export default {
         url,
         headers: {
           ...this._makeRequestHeaders(),
-          "Authorization": `Bearer ${authToken}`,
+          Authorization: `Bearer ${authToken}`,
         },
       });
     },
+    async createAccount({
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl("Account");
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async updateAccount({
+      $, id, data,
+    }) {
+      const url = this._sObjectDetailsApiUrl("Account", id);
+      return this._makeRequest({
+        $,
+        url,
+        method: "PATCH",
+        data,
+      });
+    },
+    async createAttachment({
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl("Attachment");
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async createCampaign({
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl("Campaign");
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async createCase({
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl("Case");
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async createCaseComment({
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl("CaseComment");
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async createContact({
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl("Contact");
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async updateContact({
+      $, id, data,
+    }) {
+      const url = this._sObjectDetailsApiUrl("Contact", id);
+      return this._makeRequest({
+        $,
+        url,
+        method: "PATCH",
+        data,
+      });
+    },
+    async createEvent({
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl("Event");
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async createLead({
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl("Lead");
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async createNote({
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl("Note");
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async createOpportunity({
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl("Opportunity");
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async updateOpportunity({
+      $, id, data,
+    }) {
+      const url = this._sObjectDetailsApiUrl("Opportunity", id);
+      return this._makeRequest({
+        $,
+        url,
+        method: "PATCH",
+        data,
+      });
+    },
+    async getRecordFieldValues(sobjectName, {
+      $, id, params,
+    }) {
+      const url = this._sObjectDetailsApiUrl(sobjectName, id);
+      return this._makeRequest({
+        $,
+        url,
+        params,
+      });
+    },
+    async createRecord(sobjectName, {
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl(sobjectName);
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async updateRecord(sobjectName, {
+      $, id, data,
+    }) {
+      const url = this._sObjectDetailsApiUrl(sobjectName, id);
+      return this._makeRequest({
+        $,
+        url,
+        method: "PATCH",
+        data,
+      });
+    },
+    async createTask({
+      $, data,
+    }) {
+      const url = this._sObjectTypeApiUrl("Task");
+      return this._makeRequest({
+        $,
+        url,
+        method: "POST",
+        data,
+      });
+    },
+    async deleteOpportunity({
+      $, id,
+    }) {
+      const url = this._sObjectDetailsApiUrl("Opportunity", id);
+      return this._makeRequest({
+        $,
+        url,
+        method: "DELETE",
+      });
+    },
+    async query({
+      $, query,
+    }) {
+      const baseUrl = this._baseApiVersionUrl();
+      const url = `${baseUrl}/query/?q=${encodeURI(query)}`;
+      return this._makeRequest({
+        $,
+        url,
+      });
+    },
+    async search({
+      $, search,
+    }) {
+      const baseUrl = this._baseApiVersionUrl();
+      const url = `${baseUrl}/search/?q=${encodeURI(search)}`;
+      return this._makeRequest({
+        $,
+        url,
+      });
+    },
+    async insertBlobData(sobjectName, {
+      $, headers, data,
+    }) {
+      const url = this._sObjectTypeApiUrl(sobjectName);
+      const requestConfig = {
+        url,
+        method: "POST",
+        data,
+        headers: {
+          ...this._makeRequestHeaders(),
+          ...headers,
+        },
+      };
+      return axios($ ?? this, requestConfig);
+    },
   },
 };

package/sources/common-instant.mjs

@@ -12,17 +12,23 @@ export default {
       customResponse: true,
     },
     salesforce,
-    // Not inheriting `objectType` propDefinition from salesforce so `this` in async options has
-    // component instance's methods
     objectType: {
-      ...salesforce.propDefinitions.objectType,
-      label: salesforce.propDefinitions.objectType.label,
-      description: salesforce.propDefinitions.objectType.description,
+      type: "string",
+      label: "Object Type",
+      description: "The type of object for which to monitor events",
       async options(context) {
-        return salesforce.propDefinitions.objectType.options.call(this.salesforce, {
-          ...context,
-          eventType: this.getEventType(),
-        });
+        const { page } = context;
+        if (page !== 0) {
+          // The list of allowed SObject types is static and exhaustively
+          // provided through a single method call
+          return [];
+        }
+
+        const supportedObjectTypes = this.salesforce.listAllowedSObjectTypes(this.getEventType());
+        return supportedObjectTypes.map((i) => ({
+          label: i.label,
+          value: i.name,
+        }));
       },
     },
   },

package/sources/common.mjs

@@ -12,12 +12,10 @@ export default {
         intervalSeconds: 60 * 15, // 15 minutes
       },
     },
-    // Not inheriting `objectType` propDefinition from salesforce so `this` in async options has
-    // component instance's methods
     objectType: {
-      ...salesforce.propDefinitions.objectType,
-      label: salesforce.propDefinitions.objectType.label,
-      description: salesforce.propDefinitions.objectType.description,
+      type: "string",
+      label: "Object Type",
+      description: "The type of object for which to monitor events",
       async options(context) {
         const { page } = context;
         if (page !== 0) {

package/sources/new-object/new-object.mjs

@@ -8,7 +8,7 @@ export default {
   name: "New Object (of Selectable Type)",
   key: "salesforce_rest_api-new-object",
   description: "Emit new event (at regular intervals) when an object of arbitrary type (selected as an input parameter by the user) is created. See [the docs](https://sforce.co/3yPSJZy) for more information.",
-  version: "0.0.5",
+  version: "0.1.0",
   methods: {
     ...common.methods,
     isItemRelevant(item, startTimestamp, endTimestamp) {

package/sources/new-object-instant/new-object-instant.mjs

@@ -8,7 +8,7 @@ export default {
   name: "New Object (Instant, of Selectable Type)",
   key: "salesforce_rest_api-new-object-instant",
   description: "Emit new event immediately after an object of arbitrary type (selected as an input parameter by the user) is created",
-  version: "0.0.5",
+  version: "0.1.0",
   methods: {
     ...common.methods,
     generateMeta(data) {

package/sources/new-outbound-message/new-outbound-message.mjs

@@ -6,7 +6,7 @@ export default {
   name: "New Outbound Message (Instant)",
   key: "salesforce_rest_api-new-outbound-message",
   description: "Emit new event when a new outbound message is received in Salesforce. See Salesforce's guide on setting up [Outbound Messaging](https://sforce.co/3JbZJom). Set the Outbound Message's Endpoint URL to the endpoint of the created source. The \"Send Session ID\" option must be enabled for validating outbound messages from Salesforce.",
-  version: "0.0.2",
+  version: "0.1.0",
   dedupe: "unique",
   props: {
     db: "$.service.db",

package/sources/object-deleted/object-deleted.mjs

@@ -5,10 +5,10 @@ import common from "../common.mjs";
 export default {
   ...common,
   type: "source",
-  name: "Object Deleted (of Selectable Type)",
+  name: "New Deleted Object (of Selectable Type)",
   key: "salesforce_rest_api-object-deleted",
   description: "Emit new event (at regular intervals) when an object of arbitrary type (selected as an input parameter by the user) is deleted. [See the docs](https://sforce.co/3msDDEE) for more information.",
-  version: "0.0.5",
+  version: "0.1.0",
   methods: {
     ...common.methods,
     generateMeta(item) {

package/sources/object-deleted-instant/object-deleted-instant.mjs

@@ -5,10 +5,10 @@ import common from "../common-instant.mjs";
 export default {
   ...common,
   type: "source",
-  name: "Object Deleted (Instant, of Selectable Type)",
+  name: "New Deleted Object (Instant, of Selectable Type)",
   key: "salesforce_rest_api-object-deleted-instant",
   description: "Emit new event immediately after an object of arbitrary type (selected as an input parameter by the user) is deleted",
-  version: "0.0.5",
+  version: "0.1.0",
   methods: {
     ...common.methods,
     generateMeta(data) {

package/sources/object-updated/object-updated.mjs

@@ -5,10 +5,10 @@ import common from "../common.mjs";
 export default {
   ...common,
   type: "source",
-  name: "Object Updated (of Selectable Type)",
+  name: "New Updated Object (of Selectable Type)",
   key: "salesforce_rest_api-object-updated",
   description: "Emit new event (at regular intervals) when an object of arbitrary type (selected as an input parameter by the user) is updated. [See the docs](https://sforce.co/3yPSJZy) for more information.",
-  version: "0.0.5",
+  version: "0.1.0",
   methods: {
     ...common.methods,
     generateMeta(item) {

package/sources/object-updated-instant/object-updated-instant.mjs

@@ -5,10 +5,10 @@ import common from "../common-instant.mjs";
 export default {
   ...common,
   type: "source",
-  name: "Object Updated (Instant, of Selectable Type)",
+  name: "New Updated Object (Instant, of Selectable Type)",
   key: "salesforce_rest_api-object-updated-instant",
   description: "Emit new event immediately after an object of arbitrary type (selected as an input parameter by the user) is updated",
-  version: "0.0.5",
+  version: "0.1.0",
   methods: {
     ...common.methods,
     generateMeta(data) {

package/sources/updated-field-on-record/updated-field-on-record.mjs

@@ -12,10 +12,10 @@ const { salesforce } = common.props;
 export default {
   ...common,
   type: "source",
-  name: "Updated Field on Record (of Selectable Type)",
+  name: "New Updated Field on Record (of Selectable Type)",
   key: "salesforce_rest_api-updated-field-on-record",
   description: "Emit new event (at regular intervals) when a field of your choosing is updated on any record of a specified Salesforce object. Field history tracking must be enabled for the chosen field. See the docs on [field history tracking](https://sforce.co/3mtj0rF) and [history objects](https://sforce.co/3Fn4lWB) for more information.",
-  version: "0.0.1",
+  version: "0.1.0",
   props: {
     ...common.props,
     objectType: {

package/sources/updated-field-on-record-instant/updated-field-on-record-instant.mjs

@@ -6,10 +6,10 @@ const { salesforce } = common.props;
 export default {
   ...common,
   type: "source",
-  name: "Updated Field on Record (Instant, of Selectable Type)",
+  name: "New Updated Field on Record (Instant, of Selectable Type)",
   key: "salesforce_rest_api-updated-field-on-record-instant",
   description: "Emit new event immediately after a field of your choosing is updated on any record of a specified Salesforce object",
-  version: "0.0.1",
+  version: "0.1.0",
   props: {
     ...common.props,
     field: {