@airtable/blocks 1.7.0 → 1.9.0-experimental

package/dist/cjs/models/table.js

@@ -1724,8 +1724,6 @@ function (_AbstractModel) {
       }));
     }
     /**
-     * _Beta feature with unstable API. May have breaking changes before release._
-     *
      * Checks whether the current user has permission to create a field in this table.
      *
      * Accepts partial input, in the same format as {@link createFieldAsync}.
@@ -1737,6 +1735,7 @@ function (_AbstractModel) {
      * @param name name for the field. must be case-insensitive unique for the table
      * @param type type for the field
      * @param options options for the field. omit for fields without writable options
+     * @param description description for the field. omit to leave blank
      *
      * @example
      * ```js
@@ -1750,7 +1749,7 @@ function (_AbstractModel) {
 
   }, {
     key: "checkPermissionsForCreateField",
-    value: function checkPermissionsForCreateField(name, type, options) {
+    value: function checkPermissionsForCreateField(name, type, options, description) {
       return this._sdk.__mutations.checkPermissionsForMutation({
         type: _mutations.MutationTypes.CREATE_SINGLE_FIELD,
         tableId: this.id,
@@ -1761,13 +1760,12 @@ function (_AbstractModel) {
           type: type
         }, options ? {
           options
-        } : null) : undefined
+        } : null) : undefined,
+        description
       });
     }
     /**
-     * _Beta feature with unstable API. May have breaking changes before release._
-     *
-     * An alias for `checkPermissionsForCreateField(name, type, options).hasPermission`.
+     * An alias for `checkPermissionsForCreateField(name, type, options, description).hasPermission`.
      *
      * Checks whether the current user has permission to create a field in this table.
      *
@@ -1776,6 +1774,7 @@ function (_AbstractModel) {
      * @param name name for the field. must be case-insensitive unique for the table
      * @param type type for the field
      * @param options options for the field. omit for fields without writable options
+     * @param description description for the field. omit to leave blank
      *
      * @example
      * ```js
@@ -1789,12 +1788,10 @@ function (_AbstractModel) {
 
   }, {
     key: "hasPermissionToCreateField",
-    value: function hasPermissionToCreateField(name, type, options) {
-      return this.checkPermissionsForCreateField(name, type, options).hasPermission;
+    value: function hasPermissionToCreateField(name, type, options, description) {
+      return this.checkPermissionsForCreateField(name, type, options, description).hasPermission;
     }
     /**
-     * _Beta feature with unstable API. May have breaking changes before release._
-     *
      * Creates a new field.
      *
      * Similar to creating a field from the Airtable UI, the new field will not be visible
@@ -1813,6 +1810,8 @@ function (_AbstractModel) {
      * @param name name for the field. must be case-insensitive unique
      * @param type type for the field
      * @param options options for the field. omit for fields without writable options
+     * @param description description for the field. is optional and will be `''` if not specified
+     * or if specified as `null`.
      *
      * @example
      * ```js
@@ -1847,7 +1846,7 @@ function (_AbstractModel) {
 
   }, {
     key: "createFieldAsync",
-    value: function createFieldAsync(name, type, options) {
+    value: function createFieldAsync(name, type, options, description) {
       var fieldId;
       return _regenerator.default.async(function createFieldAsync$(_context9) {
         while (1) {
@@ -1864,7 +1863,11 @@ function (_AbstractModel) {
                   type: type
                 }, options ? {
                   options
-                } : null)
+                } : null),
+                // Coerce undefined to null so that only old SDKs pass "undefined" for description
+                // '' is permitted, as we already set empty descriptions to '' when editing descriptions
+                // from the UI
+                description: description !== null && description !== void 0 ? description : null
               }));
 
             case 3:
@@ -2021,7 +2024,11 @@ function (_AbstractModel) {
               if (didViewSchemaChange) {
                 didTableSchemaChange = true;
               }
-            }
+            } // We must directly trigger deletions on the recordStore.viewDataStore
+            // because the viewModel might not have been created. (See above comment)
+
+
+            this._recordStore.sendViewDataDeletionIfViewIsDeleted(_viewId);
           }
         } catch (err) {
           _didIteratorError4 = true;
@@ -2106,11 +2113,7 @@ function (_AbstractModel) {
 
 
         this._cachedFieldNamesById = null;
-      } // NOTE: Record store onChange triggers must be performed AFTER field onChange triggers to
-      // ensure the column type providers are not stale.
-
-
-      this._recordStore.triggerOnChangeForDirtyPaths(dirtyPaths);
+      }
 
       return didTableSchemaChange;
     }