@pipedream/salesforce_rest_api 1.14.0 → 2.0.0

package/actions/upsert-record/upsert-record.mjs

@@ -1,9 +1,5 @@
 // x-pd-ai: optimized
-import {
-  convertFieldsToProps, getAdditionalFields,
-} from "../../common/props-utils.mjs";
 import salesforce from "../../salesforce_rest_api.app.mjs";
-import { additionalFields } from "../common/base-create-update.mjs";
 
 export default {
   key: "salesforce_rest_api-upsert-record",
@@ -13,9 +9,9 @@ export default {
     + " Use **Create CRM Record** or **Update CRM Record** when you already know whether the record exists."
     + " "
     + "[See the documentation](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/dome_upsert.htm)",
-  version: "0.0.8",
+  version: "1.0.0",
   annotations: {
-    destructiveHint: true,
+    destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: false,
   },
@@ -23,17 +19,37 @@ export default {
   props: {
     salesforce,
     objectType: {
-      propDefinition: [
-        salesforce,
-        "objectType",
-      ],
-      description: "The type of object to create a record of",
-      reloadProps: true,
+      type: "string",
+      label: "Object Type",
+      description:
+        "The Salesforce object API name (e.g. `Account`, `Contact`). Use **List Objects** to discover custom object types (ending in `__c`).",
+    },
+    externalIdFieldName: {
+      type: "string",
+      label: "External ID Field",
+      description:
+        "API name of the field marked as External ID used to identify the record (e.g. `External_ID__c`). The field must be flagged as an External ID in Salesforce Object Manager. Run **List Object Fields** to find valid external-ID field API names.",
+    },
+    externalIdValue: {
+      type: "string",
+      label: "External ID Value",
+      description:
+        "The value of the external ID field. If a record with this value exists it is updated, otherwise a new one is created.",
+    },
+    updateOnly: {
+      type: "boolean",
+      label: "Update Only",
+      description: "If enabled, only update an existing record; do not create a new one (adds `?updateOnly=true`).",
+      optional: true,
+    },
+    fields: {
+      type: "object",
+      label: "Fields",
+      description:
+        "Field name -> value pairs for the record. Example: `{\"LastName\": \"Doe\", \"Email\": \"doe@example.com\"}`. Use **Describe Object** to discover valid field names.",
     },
   },
   methods: {
-    getAdditionalFields,
-    convertFieldsToProps,
     async upsertRecord(sobjectName, {
       externalIdFieldName, externalIdValue, ...args
     }) {
@@ -45,71 +61,14 @@ export default {
       });
     },
   },
-  async additionalProps() {
-    const { objectType } = this;
-    const fields = await this.salesforce.getFieldsForObjectType(objectType);
-
-    const requiredFields = fields.filter((field) => {
-      return field.createable && field.updateable && !field.nillable && !field.defaultedOnCreate;
-    });
-
-    const externalIdFieldOptions = fields.filter((field) => field.externalId).map(({
-      label, name,
-    }) => ({
-      label,
-      value: name,
-    }));
-
-    const requiredFieldProps = this.convertFieldsToProps(requiredFields);
-
-    return {
-      docsInfo: {
-        type: "alert",
-        alertType: "info",
-        content: `[See the documentation](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_${objectType.toLowerCase()}.htm) for information on all available fields.`,
-      },
-      externalIdFieldName: {
-        type: "string",
-        label: "External ID Field",
-        description: "The field to use as the external ID to identify the record.",
-        options: externalIdFieldOptions,
-      },
-      docsInfoExtId: {
-        type: "alert",
-        alertType: "info",
-        content: "If you don't see any fields in the above list, you probably need to create one in Salesforce's Object Manager. Only a field marked as an external id field can be used to identify a record.",
-      },
-      externalIdValue: {
-        type: "string",
-        label: "External ID Value",
-        description: "The value of the external ID field selected above. If a record with this value exists, it will be updated, otherwise a new one will be created.",
-      },
-      updateOnly: {
-        type: "boolean",
-        label: "Update Only",
-        description: "If enabled, the action will only update an existing record, but not create one.",
-        optional: true,
-      },
-      ...requiredFieldProps,
-      additionalFields,
-    };
-  },
   async run({ $ }) {
-    /* eslint-disable no-unused-vars */
     const {
-      salesforce,
       objectType,
-      getAdditionalFields: getData,
-      convertFieldsToProps,
-      docsInfo,
-      docsInfoExtId,
-      additionalFields,
       externalIdFieldName,
       externalIdValue,
       updateOnly,
-      ...data
+      fields,
     } = this;
-    /* eslint-enable no-unused-vars */
     const response = await this.upsertRecord(objectType, {
       $,
       externalIdFieldName,
@@ -117,10 +76,7 @@ export default {
       params: {
         updateOnly,
       },
-      data: {
-        ...data,
-        ...getData(),
-      },
+      data: fields,
     });
     $.export("$summary", `Successfully ${response.created
       ? "created"

package/common/sobjects/attachment.mjs

@@ -1,5 +1,3 @@
-import salesforce from "../../salesforce_rest_api.app.mjs";
-
 export default {
   createProps: {
     Name: {
@@ -52,16 +50,9 @@ export default {
       optional: true,
     },
     OwnerId: {
-      propDefinition: [
-        salesforce,
-        "recordId",
-        () => ({
-          objType: "User",
-          nameField: "Name",
-        }),
-      ],
+      type: "string",
       label: "Owner ID",
-      description: "ID of the user who owns the attachment.",
+      description: "ID of the user who owns the attachment (Salesforce's 15- or 18-character record ID, e.g. `005XX000001SvR2`). Use **SOQL Query** to find the User ID.",
       optional: true,
     },
   },

package/common/sobjects/caseComment.mjs

@@ -1,5 +1,3 @@
-import salesforce from "../../salesforce_rest_api.app.mjs";
-
 export default {
   initialProps: {
     CommentBody: {
@@ -9,16 +7,9 @@ export default {
       optional: true,
     },
     ParentId: {
-      propDefinition: [
-        salesforce,
-        "recordId",
-        () => ({
-          objType: "Case",
-          nameField: "CaseNumber",
-        }),
-      ],
+      type: "string",
       label: "Parent Case ID",
-      description: "ID of the parent Case.",
+      description: "ID of the parent Case (Salesforce's 15- or 18-character record ID, e.g. `500XX000001SvR2`). Use **SOQL Query** to find the Case ID.",
     },
     IsPublished: {
       type: "boolean",

package/common/sobjects/content-note.mjs

@@ -1,18 +1,10 @@
-import salesforce from "../../salesforce_rest_api.app.mjs";
-
 export default {
   initialProps: {
     OwnerId: {
-      propDefinition: [
-        salesforce,
-        "recordId",
-        () => ({
-          objType: "User",
-          nameField: "Name",
-        }),
-      ],
+      type: "string",
       label: "Owner ID",
-      description: "ID of the user who owns the note.",
+      description: "ID of the user who owns the note (Salesforce's 15- or 18-character record ID, e.g. `005XX000001SvR2`). Use **SOQL Query** to find the User ID.",
+      optional: true,
     },
     Title: {
       type: "string",

package/common/sobjects/event.mjs

@@ -6,24 +6,10 @@ import commonProps from "../props-async-options.mjs";
 export default {
   initialProps: {
     AcceptedEventInviteeIds: {
-      ...commonProps.ContactOrLeadIds,
+      type: "string[]",
       label: "Accepted Event Invitee IDs",
-      description: "One or more Contact or Lead IDs who accepted this event.",
-      optional: true,
-      async options() {
-        const contacts = await this.salesforce.listRecordOptions({
-          objType: "Contact",
-          nameField: "Name",
-        });
-        const leads = await this.salesforce.listRecordOptions({
-          objType: "Lead",
-          nameField: "Name",
-        });
-        return [
-          ...(contacts ?? []),
-          ...(leads ?? []),
-        ];
-      },
+      description: "One or more Contact or Lead IDs who accepted this event (Salesforce's 15- or 18-character record ID, e.g. `003XX000004TmiQ` for a Contact). Use **SOQL Query** to find Contact or Lead IDs.",
+      optional: true,
     },
     ActivityDate: {
       type: "string",

package/common/sobjects/note.mjs

@@ -1,5 +1,3 @@
-import salesforce from "../../salesforce_rest_api.app.mjs";
-
 export default {
   initialProps: {
     Body: {
@@ -10,20 +8,13 @@ export default {
     IsPrivate: {
       type: "boolean",
       label: "Private",
-      description: "If true, only the note owner or a user with the “Modify All Data” permission can view the note or query it via the API.",
+      description: "If true, only the note owner or a user with the \"Modify All Data\" permission can view the note or query it via the API.",
       optional: true,
     },
     OwnerId: {
-      propDefinition: [
-        salesforce,
-        "recordId",
-        () => ({
-          objType: "User",
-          nameField: "Name",
-        }),
-      ],
+      type: "string",
       label: "Owner ID",
-      description: "ID of the user who owns the note.",
+      description: "ID of the user who owns the note (Salesforce's 15- or 18-character record ID, e.g. `005XX000001SvR2`). Use **SOQL Query** to find the User ID.",
       optional: true,
     },
     ParentId: {

package/common/sobjects/opportunity.mjs

@@ -1,21 +1,13 @@
 import { RECORD_SOURCE_OPTIONS } from "../constants-props.mjs";
 import commonProps from "../props-async-options.mjs";
-import salesforce from "../../salesforce_rest_api.app.mjs";
 
 export default {
   createProps: {
     ContactId: {
-      propDefinition: [
-        salesforce,
-        "recordId",
-        () => ({
-          objType: "Contact",
-          nameField: "Name",
-        }),
-      ],
+      type: "string",
       label: "Contact ID",
       description:
-        "ID of the contact associated with this opportunity, set as the primary contact.",
+        "ID of the contact associated with this opportunity, set as the primary contact (Salesforce's 15- or 18-character record ID, e.g. `003XX000004TmiQ`). Use **SOQL Query** to find the Contact ID.",
       optional: true,
     },
   },

package/common/sobjects/user.mjs

@@ -1,4 +1,3 @@
-import salesforce from "../../salesforce_rest_api.app.mjs";
 import {
   EMAIL_ENCODING_OPTIONS,
   GEOCODE_ACCURACY_OPTIONS,
@@ -80,17 +79,10 @@ export default {
       options: LOCALE_OPTIONS,
     },
     ProfileId: {
-      propDefinition: [
-        salesforce,
-        "recordId",
-        () => ({
-          objType: "Profile",
-          nameField: "Name",
-        }),
-      ],
+      type: "string",
       label: "Profile ID",
       description:
-        "ID of the user's Profile. Use this value to cache metadata based on profile.",
+        "ID of the user's Profile (Salesforce's 15- or 18-character record ID, e.g. `00eXX000001SvR2`). Use **SOQL Query** to find the Profile ID.",
     },
     TimeZoneSidKey: {
       type: "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/salesforce_rest_api",
-  "version": "1.14.0",
+  "version": "2.0.0",
   "description": "Pipedream Salesforce (REST API) Components",
   "main": "salesforce_rest_api.app.mjs",
   "keywords": [

package/salesforce_rest_api.app.mjs

@@ -55,15 +55,6 @@ export default {
         return fields.filter(filter).map(({ name }) => name);
       },
     },
-    fieldsToUpdate: {
-      type: "string[]",
-      label: "Fields to Update",
-      description: "Select the field(s) you want to update for this record.",
-      async options({ objType }) {
-        const fields = await this.getFieldsForObjectType(objType);
-        return fields.filter((field) => field.updateable).map(({ name }) => name);
-      },
-    },
     fieldsToObtain: {
       type: "string[]",
       label: "Fields to Obtain",
@@ -73,13 +64,6 @@ export default {
         return fields.map(({ name }) => name);
       },
     },
-    useAdvancedProps: {
-      type: "boolean",
-      label: "See All Props",
-      description: "Set to true to see all available props for this object.",
-      optional: true,
-      reloadProps: true,
-    },
   },
   methods: {
     _authToken() {

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

@@ -7,7 +7,7 @@ export default {
   name: "Case Updated (Instant, of Selectable Type)",
   key: "salesforce_rest_api-case-updated-instant",
   description: "Emit new event when a case is updated. [See the documentation](https://sforce.co/3yPSJZy)",
-  version: "0.0.10",
+  version: "0.0.12",
   props: {
     salesforce: common.props.salesforce,
     db: "$.service.db",

package/sources/common/common-feed.mjs

@@ -43,24 +43,29 @@ export default {
       const nameField = await this.salesforce.getNameFieldForObjectType(objectType);
       this.setNameField(nameField);
 
-      const extraConditions = await this._buildExtraConditions();
-      const { records } = await this.query({
-        query: `SELECT Id FROM ${objectType} WHERE Id != null ${extraConditions} ORDER BY CreatedDate DESC LIMIT ${DEPLOY_HISTORICAL_LIMIT}`,
-      });
+      try {
+        const extraConditions = await this._buildExtraConditions();
+        const { records } = await this.query({
+          query: `SELECT Id FROM ${objectType} WHERE Id != null ${extraConditions} ORDER BY CreatedDate DESC LIMIT ${DEPLOY_HISTORICAL_LIMIT}`,
+        });
 
-      // Emit oldest-first so historical events are delivered chronologically,
-      // matching the timer polling path.
-      for (const record of [
-        ...records,
-      ].reverse()) {
-        const object = await this.salesforce.getSObject(objectType, record.Id);
-        const event = {
-          body: {
-            "New": object,
-            "UserId": record.Id,
-          },
-        };
-        await this.processWebhookEvent(event);
+        // Emit oldest-first so historical events are delivered chronologically,
+        // matching the timer polling path.
+        for (const record of [
+          ...records,
+        ].reverse()) {
+          const object = await this.salesforce.getSObject(objectType, record.Id);
+          const event = {
+            body: {
+              "New": object,
+              "UserId": record.Id,
+            },
+          };
+          await this.processWebhookEvent(event);
+        }
+      } catch (err) {
+        console.log("Error seeding historical records during deploy:", err);
+        console.log("The source will still be created and will emit new records going forward.");
       }
     },
   },

package/sources/common/common-new-record.mjs

@@ -1,6 +1,7 @@
 import startCase from "lodash/startCase.js";
 import { v4 as uuidv4 } from "uuid";
 import common from "../common/common.mjs";
+import constants from "../../common/constants.mjs";
 
 export default {
   ...common,
@@ -12,17 +13,24 @@ export default {
       this.setNameField(nameField);
 
       // emit historical events
-      const { recentItems } = await this.salesforce.listSObjectTypeIds(objectType);
-      const ids = recentItems.map((item) => item.Id);
-      for (const id of ids.slice(-25)) {
-        const object = await this.salesforce.getSObject(objectType, id);
-        const event = {
-          body: {
-            "New": object,
-            "UserId": id,
-          },
-        };
-        this.processWebhookEvent(event);
+      try {
+        const { records } = await this.query({
+          query: `SELECT Id FROM ${objectType} ORDER BY ${constants.FIELD_NAME.CREATED_DATE} DESC LIMIT ${constants.DEPLOY_HISTORICAL_LIMIT}`,
+        });
+        const ids = records.map((r) => r.Id);
+        for (const id of ids.slice(-constants.DEPLOY_HISTORICAL_LIMIT).reverse()) {
+          const object = await this.salesforce.getSObject(objectType, id);
+          const event = {
+            body: {
+              "New": object,
+              "UserId": id,
+            },
+          };
+          this.processWebhookEvent(event);
+        }
+      } catch (err) {
+        console.log("Error seeding historical records during deploy:", err);
+        console.log("The source will still be created and will emit new records going forward.");
       }
     },
     async activate() {

package/sources/common/common-updated-record.mjs

@@ -13,20 +13,27 @@ export default {
       this.setNameField(nameField);
 
       if (!this.skipFirstRun) {
-        const { recentItems } = await this.salesforce.listSObjectTypeIds(objectType);
-        const ids = recentItems.map((item) => item.Id);
-
-        for (const id of ids.slice(-25)) {
-          const object = await this.salesforce.getSObject(objectType, id);
-
-          const event = {
-            body: {
-              "New": object,
-              "UserId": id,
-            },
-          };
-          const meta = this.generateWebhookMeta(event);
-          this.$emit(event.body, meta);
+        try {
+          const { records } = await this.query({
+            query: `SELECT Id FROM ${objectType} ORDER BY ${constants.FIELD_NAME.LAST_MODIFIED_DATE} DESC LIMIT ${constants.DEPLOY_HISTORICAL_LIMIT}`,
+          });
+          const ids = records.map((r) => r.Id);
+
+          for (const id of ids.slice(-constants.DEPLOY_HISTORICAL_LIMIT).reverse()) {
+            const object = await this.salesforce.getSObject(objectType, id);
+
+            const event = {
+              body: {
+                "New": object,
+                "UserId": id,
+              },
+            };
+            const meta = this.generateWebhookMeta(event);
+            this.$emit(event.body, meta);
+          }
+        } catch (err) {
+          console.log("Error seeding historical records during deploy:", err);
+          console.log("The source will still be created and will emit updated records going forward.");
         }
       }
     },

package/sources/common/common.mjs

@@ -89,9 +89,18 @@ export default {
       this.db.set("latestDateCovered", latestDateCovered);
     },
     getNameField() {
-      return this.db.get("nameField");
+      // Cache in memory for the lifetime of this execution. The deploy hook emits
+      // up to DEPLOY_HISTORICAL_LIMIT historical events, each building meta via
+      // getNameField(); without this the db is read once per event (e.g. 25x).
+      if (this._nameField === undefined) {
+        this._nameField = this.db.get("nameField");
+      }
+      return this._nameField;
     },
     setNameField(nameField) {
+      // Keep the in-memory cache coherent with the persisted value so a read after
+      // a write doesn't fall back to db.get.
+      this._nameField = nameField;
       this.db.set("nameField", nameField);
     },
     processTimerEvent() {

package/sources/email-template-updated-instant/email-template-updated-instant.mjs

@@ -7,7 +7,7 @@ export default {
   name: "Email Template Updated (Instant, of Selectable Type)",
   key: "salesforce_rest_api-email-template-updated-instant",
   description: "Emit new event when an email template is updated. [See the documentation](https://sforce.co/3yPSJZy)",
-  version: "0.0.10",
+  version: "0.0.12",
   props: {
     salesforce: common.props.salesforce,
     db: "$.service.db",

package/sources/knowledge-article-updated-instant/knowledge-article-updated-instant.mjs

@@ -7,7 +7,7 @@ export default {
   name: "Knowledge Article Updated (Instant, of Selectable Type)",
   key: "salesforce_rest_api-knowledge-article-updated-instant",
   description: "Emit new event when a knowledge article is updated. [See the documentation](https://sforce.co/3yPSJZy)",
-  version: "0.0.10",
+  version: "0.0.12",
   props: {
     salesforce: common.props.salesforce,
     db: "$.service.db",

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

@@ -7,7 +7,7 @@ export default {
   name: "New Case (Instant, of Selectable Type)",
   key: "salesforce_rest_api-new-case-instant",
   description: "Emit new event when a case is created. [See the documentation](https://sforce.co/3yPSJZy)",
-  version: "0.0.10",
+  version: "0.0.12",
   props: {
     salesforce: common.props.salesforce,
     db: "$.service.db",

package/sources/new-email-template-instant/new-email-template-instant.mjs

@@ -7,7 +7,7 @@ export default {
   name: "New Email Template (Instant, of Selectable Type)",
   key: "salesforce_rest_api-new-email-template-instant",
   description: "Emit new event when an email template is created. [See the documentation](https://sforce.co/3yPSJZy)",
-  version: "0.0.10",
+  version: "0.0.12",
   props: {
     salesforce: common.props.salesforce,
     db: "$.service.db",

package/sources/new-feed-comment/new-feed-comment.mjs

@@ -12,7 +12,7 @@ export default {
   name: "New Chatter Feed Comment (Instant or Polling)",
   key: "salesforce_rest_api-new-feed-comment",
   description: "Emit new events for each Chatter FeedComment (reply) created in Salesforce, polling `FeedComment` via SOQL on `CreatedDate`. Use this to react to comments on Chatter posts, since Chatter activity does not update the parent record's `LastModifiedDate`. The payload includes both `ParentId` (a polymorphic reference to the feed's parent - either a record feed, e.g. a Case ID starting with `500`, or a User feed) and `FeedItemId` (the ID of the FeedItem the comment belongs to) - these are distinct fields; do not confuse them. Set `parentObjectType` to a parent object API name (e.g. `Case`) to append `AND Parent.Type = '<value>'` to the SOQL WHERE clause. Set `excludeSelf` to `true` to drop comments authored by the connected integration user. Note: querying FeedComment without a parent filter requires the `View All Data` permission on the connected user. Attempts instant delivery via webhook and falls back to timer polling automatically. [See the documentation](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_feedcomment.htm)",
-  version: "0.0.2",
+  version: "0.0.4",
   props: {
     ...common.props,
     parentObjectType: {

package/sources/new-feed-item/new-feed-item.mjs

@@ -12,7 +12,7 @@ export default {
   name: "New Chatter Feed Item (Instant or Polling)",
   key: "salesforce_rest_api-new-feed-item",
   description: "Emit new events for each Chatter FeedItem (post) created in Salesforce, polling `FeedItem` via SOQL on `CreatedDate`. Use this to react to Chatter posts on Cases and other records, since Chatter activity does not update the parent record's `LastModifiedDate` (so **New Record (Instant, of Selectable Type)** and **New Case (Instant, of Selectable Type)** never emit for it). Set `parentObjectType` to the parent object's API name (e.g. `Case`, `Opportunity`) to only emit posts whose parent record is of that type. Set `excludeSelf` to `true` to drop posts authored by the connected integration user. Note: `Body` is null for system-generated post types (e.g. `TrackedChange`). Attempts instant delivery via webhook and falls back to timer polling automatically when the Streaming API does not support this object. [See the documentation](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_feeditem.htm)",
-  version: "0.0.2",
+  version: "0.0.4",
   props: {
     ...common.props,
     parentObjectType: {

package/sources/new-knowledge-article-instant/new-knowledge-article-instant.mjs

@@ -7,7 +7,7 @@ export default {
   name: "New Knowledge Article (Instant, of Selectable Type)",
   key: "salesforce_rest_api-new-knowledge-article-instant",
   description: "Emit new event when a knowledge article is created. [See the documentation](https://sforce.co/3yPSJZy)",
-  version: "0.0.10",
+  version: "0.0.12",
   props: {
     salesforce: common.props.salesforce,
     db: "$.service.db",

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.",
-  version: "0.1.13",
+  version: "0.1.14",
   dedupe: "unique",
   props: {
     db: "$.service.db",

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

@@ -6,7 +6,7 @@ export default {
   name: "New Record (Instant, of Selectable Type)",
   key: "salesforce_rest_api-new-record-instant",
   description: "Emit new event when a record of the selected object type is created. [See the documentation](https://sforce.co/3yPSJZy)",
-  version: "0.2.10",
+  version: "0.2.12",
   props: {
     ...common.props,
     fieldsToObtain: {

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

@@ -7,7 +7,7 @@ export default {
   name: "New Deleted Record (Instant, of Selectable Type)",
   key: "salesforce_rest_api-record-deleted-instant",
   description: "Emit new event when a record of the selected object type is deleted. [See the documentation](https://sforce.co/3msDDEE)",
-  version: "0.1.9",
+  version: "0.1.11",
   methods: {
     ...common.methods,
     generateWebhookMeta(data) {

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

@@ -7,7 +7,7 @@ export default {
   name: "New Updated Record (Instant, of Selectable Type)",
   key: "salesforce_rest_api-record-updated-instant",
   description: "Emit new event when a record of the selected type is updated. [See the documentation](https://sforce.co/3yPSJZy)",
-  version: "0.2.10",
+  version: "0.2.12",
   props: {
     ...common.props,
     fields: {