Description/prop updates

Author: GTFalcao

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/list-records/list-records.mjs

@@ -4,9 +4,9 @@ import commonList from "../common/common-list.mjs";
 export default {
   key: "airtable_oauth-list-records",
   name: "List Records",
-  description: "Retrieve records from a table with automatic pagination. Optionally sort and filter results.",
+  description: "Retrieve records from a table, optionally sorting and filtering results. [See the documentation](https://airtable.com/developers/web/api/list-records)",
   type: "action",
-  version: "0.0.6",
+  version: "0.1.0",
   ...commonList,
   props: {
     ...common.props,

components/airtable_oauth/airtable_oauth.app.mjs

@@ -18,7 +18,7 @@ export default {
     baseId: {
       type: "string",
       label: "Base",
-      description: "The base ID",
+      description: "The Base ID.",
       async options({ prevContext }) {
         const params = {};
         if (prevContext?.newOffset) {
@@ -44,7 +44,7 @@ export default {
     tableId: {
       type: "string",
       label: "Table",
-      description: "The table ID. If referencing a **Base** dynamically using data from another step (e.g., `{{steps.trigger.event.metadata.baseId}}`), you will not be able to select from the list of Tables, and automatic table options will not work when configuring this step. Please enter a custom expression to specify the **Table**.",
+      description: "The Table ID.",
       async options({ baseId }) {
         let tables;
         try {
@@ -63,7 +63,7 @@ export default {
     viewId: {
       type: "string",
       label: "View",
-      description: "The view ID. If referencing a **Table** dynamically using data from another step (e.g., `{{steps.trigger.event.metadata.tableId}}`), you will not be able to select from the list of Views for this step. Please enter a custom expression to specify the **View**.",
+      description: "The View ID.",
       async options({
         baseId, tableId,
       }) {
@@ -85,8 +85,8 @@ export default {
     },
     sortFieldId: {
       type: "string",
-      label: "Sort: Field",
-      description: "Optionally select a field to sort results. To sort by multiple fields, use the **Filter by Forumla** field. If referencing a **Table** dynamically using data from another step (e.g., `{{steps.mydata.$return_value}}`), automatic field options won't work when configuring this step. Please enter a custom expression to specify the **Sort: Field**.",
+      label: "Sort by Field",
+      description: "Optionally select a field to sort results by. To sort by multiple fields, use the **Filter by Formula** field.",
       optional: true,
       async options({
         baseId, tableId,
@@ -181,27 +181,27 @@ export default {
     returnFieldsByFieldId: {
       type: "boolean",
       label: "Return Fields By Field ID",
-      description: "An optional boolean value that lets you return field objects where the key is the field id. This defaults to `false`, which returns field objects where the key is the field name.",
+      description: "If set to `true`, the returned field objects will have the field ID as the key, instead of the field name (default behavior).",
       optional: true,
     },
     sortDirection: {
       type: "string",
       label: "Sort: Direction",
-      description: "This field will be ignored if you don't select a field to sort by.",
+      description: "If sorting by a field, which direction to sort by.",
       options: SORT_DIRECTION_OPTIONS,
       default: "desc",
       optional: true,
     },
     maxRecords: {
       type: "integer",
       label: "Max Records",
-      description: "Optionally limit the maximum number of records to return. Leave blank to retrieve all records.",
+      description: "The maximum number of records to return. Leave blank to retrieve all records.",
       optional: true,
     },
     filterByFormula: {
       type: "string",
       label: "Filter by Formula",
-      description: "Optionally provide a [formula](https://support.airtable.com/hc/en-us/articles/203255215-Formula-Field-Reference) used to filter records. The formula will be evaluated for each record, and if the result is not `0`, `false`, `\"\"`, `NaN`, `[]`, or `#Error!` the record will be included in the response. For example, to only include records where `Name` isn't empty, pass `NOT({Name} = '')`.",
+      description: "Optionally provide a [formula (see the documentation)](https://support.airtable.com/hc/en-us/articles/203255215-Formula-Field-Reference) used to filter records. The formula will be evaluated for each record, and if the result is not `0`, `false`, `\"\"`, `NaN`, `[]`, or `#Error!` the record will be included in the response. For example, to only include records where `Name` isn't empty, use `NOT({Name} = '')`.",
       optional: true,
     },
     records: {