Merge branch 'master' into issue-14969

Author: luancazarine

components/airtable_oauth/actions/common/common.mjs

@@ -10,6 +10,11 @@ export default {
       ],
       withLabel: true,
     },
+    warningAlert: {
+      type: "alert",
+      alertType: "warning",
+      content: "**Note:** if using a custom expression to specify the `Base` (e.g. `{{steps.mydata.$return_value}}`) you should also use a custom expression for the `Table`, and any other props that depend on it.",
+    },
     tableId: {
       propDefinition: [
         airtable,

components/airtable_oauth/actions/create-comment/create-comment.mjs

@@ -3,8 +3,8 @@ import common from "../common/common.mjs";
 export default {
   key: "airtable_oauth-create-comment",
   name: "Create Comment",
-  description: "Create a new comment on a record. [See the documentation](https://airtable.com/developers/web/api/create-comment)",
-  version: "0.0.7",
+  description: "Create a comment on a selected record. [See the documentation](https://airtable.com/developers/web/api/create-comment)",
+  version: "0.0.8",
   type: "action",
   props: {
     ...common.props,
@@ -23,7 +23,7 @@ export default {
     comment: {
       type: "string",
       label: "Comment",
-      description: "The text comment",
+      description: "The text comment to create",
     },
   },
   async run({ $ }) {

components/airtable_oauth/actions/create-field/create-field.mjs

@@ -1,30 +1,53 @@
+import constants from "../../sources/common/constants.mjs";
 import common from "../common/common.mjs";
 
 export default {
   key: "airtable_oauth-create-field",
   name: "Create Field",
   description: "Create a new field in a table. [See the documentation](https://airtable.com/developers/web/api/create-field)",
-  version: "0.0.7",
+  version: "0.1.0",
   type: "action",
   props: {
     ...common.props,
-    field: {
+    name: {
       type: "string",
-      label: "Field",
-      description: "A JSON object representing the field. Refer to [field types](https://airtable.com/developers/web/api/model/field-type) for supported field types, the write format for field options, and other specifics for certain field types.",
+      label: "Field Name",
+      description: "The name of the field",
+    },
+    type: {
+      type: "string",
+      label: "Field Type",
+      description: "The field type. [See the documentation](https://airtable.com/developers/web/api/model/field-type) for more information.",
+      options: constants.FIELD_TYPES,
+    },
+    description: {
+      type: "string",
+      label: "Field Description",
+      description: "The description of the field",
+      optional: true,
+    },
+    options: {
+      type: "object",
+      label: "Field Options",
+      description: "The options for the field as a JSON object, e.g. `{ \"color\": \"greenBright\" }`. Each type has a specific set of options - [see the documentation](https://airtable.com/developers/web/api/field-model) for more information.",
+      optional: true,
     },
   },
   async run({ $ }) {
-    const field = typeof this.field === "object"
-      ? this.field
-      : JSON.parse(this.field);
-    const data = {
-      ...field,
-    };
+    const {
+      description, name, options, type,
+    } = this;
     const response = await this.airtable.createField({
       baseId: this.baseId.value,
       tableId: this.tableId.value,
-      data,
+      data: {
+        name,
+        type,
+        description,
+        options: typeof options === "string"
+          ? JSON.parse(options)
+          : options,
+      },
       $,
     });
 

components/airtable_oauth/actions/create-multiple-records/create-multiple-records.mjs

@@ -1,14 +1,15 @@
 import chunk from "lodash.chunk";
 import airtable from "../../airtable_oauth.app.mjs";
 import common from "../common/common.mjs";
+import { ConfigurationError } from "@pipedream/platform";
 
 const BATCH_SIZE = 10; // The Airtable API allows us to update up to 10 rows per request.
 
 export default {
   key: "airtable_oauth-create-multiple-records",
   name: "Create Multiple Records",
-  description: "Create one or more records in a table by passing an array of objects containing field names and values as key/value pairs. [See the documentation](https://airtable.com/developers/web/api/create-records)",
-  version: "0.0.7",
+  description: "Create one or more records in a table in a single operation with an array. [See the documentation](https://airtable.com/developers/web/api/create-records)",
+  version: "0.0.8",
   type: "action",
   props: {
     ...common.props,
@@ -18,6 +19,15 @@ export default {
         "records",
       ],
     },
+    customExpressionInfo: {
+      type: "alert",
+      alertType: "info",
+      content: `You can use a custom expression that evaluates to an object for each entry in the array, e.g. \`{{ { "foo": "bar", "id": 123 } }}\`.
+\\
+You can also reference an object exported by a previous step, e.g. \`{{steps.foo.$return_value}}\`.
+\\
+If desired, you can use a custom expression in the same fashion for the entire array instead of providing individual values.`,
+    },
     typecast: {
       propDefinition: [
         airtable,
@@ -39,9 +49,18 @@ export default {
     if (!Array.isArray(data)) {
       data = JSON.parse(data);
     }
-    data = data.map((fields) => ({
-      fields,
-    }));
+    data = data.map((fields, index) => {
+      if (typeof fields === "string") {
+        try {
+          fields = JSON.parse(fields);
+        } catch (err) {
+          throw new ConfigurationError(`Error parsing record (index ${index}) as JSON: ${err.message}`);
+        }
+      }
+      return {
+        fields,
+      };
+    });
     if (!data.length) {
       throw new Error("No Airtable record data passed to step. Please pass at least one record");
     }

components/airtable_oauth/actions/create-or-update-record/create-or-update-record.mjs

@@ -4,13 +4,12 @@ import commonActions from "../../common/actions.mjs";
 
 export default {
   key: "airtable_oauth-create-or-update-record",
-  name: "Create Single Record Or Update",
-  description: "Updates a record if `recordId` is provided or adds a record to a table.",
-  version: "0.0.8",
+  name: "Create or Update Record",
+  description: "Create a new record or update an existing one. [See the documentation](https://airtable.com/developers/web/api/create-records)",
+  version: "0.1.0",
   type: "action",
   props: {
     ...common.props,
-    // eslint-disable-next-line pipedream/props-label,pipedream/props-description
     tableId: {
       ...common.props.tableId,
       reloadProps: true,
@@ -27,7 +26,7 @@ export default {
         }),
       ],
       optional: true,
-      description: "Enter a [record ID](https://support.airtable.com/hc/en-us/articles/360051564873-Record-ID) if you want to update an existing record. Leave blank to create a new record.",
+      description: "To update an existing record, select it from the list or provide its [Record ID](https://support.airtable.com/hc/en-us/articles/360051564873-Record-ID). If left blank, a new record will be created.",
     },
     typecast: {
       propDefinition: [

components/airtable_oauth/actions/create-single-record/create-single-record.mjs

@@ -6,7 +6,7 @@ export default {
   key: "airtable_oauth-create-single-record",
   name: "Create Single Record",
   description: "Adds a record to a table.",
-  version: "0.0.8",
+  version: "0.0.9",
   type: "action",
   props: {
     ...common.props,

components/airtable_oauth/actions/create-table/create-table.mjs

@@ -4,7 +4,7 @@ export default {
   key: "airtable_oauth-create-table",
   name: "Create Table",
   description: "Create a new table. [See the documentation](https://airtable.com/developers/web/api/create-table)",
-  version: "0.0.7",
+  version: "0.0.8",
   type: "action",
   props: {
     airtable,
@@ -17,18 +17,18 @@ export default {
     name: {
       type: "string",
       label: "Name",
-      description: "The name for the table",
+      description: "The name of the table",
     },
     description: {
       type: "string",
       label: "Description",
-      description: "The description for the table",
+      description: "The description of the table",
       optional: true,
     },
     fields: {
       type: "string[]",
       label: "Fields",
-      description: "A list of JSON objects representing the fields in the table. Refer to [field types](https://airtable.com/developers/web/api/model/field-type) for supported field types, the write format for field options, and other specifics for certain field types.",
+      description: "A list of JSON objects representing the fields in the table. [See the documentation](https://airtable.com/developers/web/api/model/field-type) for supported field types, the write format for field options, and other specifics for certain field types.",
     },
   },
   async run({ $ }) {

components/airtable_oauth/actions/delete-record/delete-record.mjs

@@ -4,8 +4,8 @@ import common from "../common/common.mjs";
 export default {
   key: "airtable_oauth-delete-record",
   name: "Delete Record",
-  description: "Delete a record from a table by record ID. [See the documentation](https://airtable.com/developers/web/api/delete-record)",
-  version: "0.0.7",
+  description: "Delete a selected record from a table. [See the documentation](https://airtable.com/developers/web/api/delete-record)",
+  version: "0.0.8",
   type: "action",
   props: {
     ...common.props,

components/airtable_oauth/actions/get-record-or-create/get-record-or-create.mjs

@@ -5,12 +5,11 @@ import commonActions from "../../common/actions.mjs";
 export default {
   key: "airtable_oauth-get-record-or-create",
   name: "Get Record Or Create",
-  description: "Get a record from a table by record ID or create a new register.",
-  version: "0.0.8",
+  description: "Get a specific record, or create one if it doesn't exist. [See the documentation](https://airtable.com/developers/web/api/create-records)",
+  version: "0.0.9",
   type: "action",
   props: {
     ...common.props,
-    // eslint-disable-next-line pipedream/props-label,pipedream/props-description
     tableId: {
       ...common.props.tableId,
       reloadProps: true,

components/airtable_oauth/actions/get-record/get-record.mjs

@@ -5,8 +5,8 @@ import commonActions from "../../common/actions.mjs";
 export default {
   key: "airtable_oauth-get-record",
   name: "Get Record",
-  description: "Get a record from a table by record ID. [See the documentation](https://airtable.com/developers/web/api/get-record)",
-  version: "0.0.8",
+  description: "Get data of a selected record from a table. [See the documentation](https://airtable.com/developers/web/api/get-record)",
+  version: "0.0.9",
   type: "action",
   props: {
     ...common.props,