@airtable/blocks 1.7.0 → 1.9.0-experimental

package/dist/cjs/watchable.js

@@ -84,22 +84,28 @@ function () {
     key: "__getWatchableKey",
     value: function __getWatchableKey() {
       return "".concat(this._watchableId, " ").concat(this._changeCount);
+    } // See above comment as to why changeCount needs to change when a mutation occurs (useSubscription)
+    // So this should be called whenever the model mutably changes
+
+    /**
+     * @internal
+     */
+
+  }, {
+    key: "__incrementOnChangeCount",
+    value: function __incrementOnChangeCount() {
+      this._changeCount += 1;
     }
     /**
-     * Get notified of changes to the model.
-     *
-     * Every call to `.watch` should have a matching call to `.unwatch`.
+     * Helper method to get only the valid watchable keys - or throw if a key is invalid
      *
-     * Returns the array of keys that were watched.
-     *
-     * @param keys the keys to watch
-     * @param callback a function to call when those keys change
-     * @param context an optional context for `this` in `callback`.
+     * @param keys
+     * @internal
      */
 
   }, {
-    key: "watch",
-    value: function watch(keys, callback, context) {
+    key: "_getWatchableValidKeysOrThrow",
+    value: function _getWatchableValidKeysOrThrow(keys, errorMethodName, shouldWarnInsteadOfThrow) {
       var arrayKeys = Array.isArray(keys) ? keys : [keys];
       var validKeys = [];
       var _iteratorNormalCompletion = true;
@@ -112,24 +118,16 @@ function () {
 
           if (this.constructor._isWatchableKey(_key2)) {
             validKeys.push(_key2);
-
-            if (!this._changeWatchersByKey[_key2]) {
-              this._changeWatchersByKey[_key2] = [];
-            } // Rather than pushing onto this array, we initialize a new array.
-            // This is necessary since watches can change as a result of an
-            // event getting triggered. It would be bad if as we iterate over
-            // our watchers, new watchers get pushed onto the array that we
-            // are iterating over.
-            // TODO(jb): as a perf optimization, we *could* push onto this array
-            // as long as we are not in the middle of iterating over it.
-
-
-            this._changeWatchersByKey[_key2] = [...this._changeWatchersByKey[_key2], {
-              callback,
-              context
-            }];
           } else {
-            throw (0, _error_utils.spawnError)('Invalid key to watch for %s: %s', this.constructor._className, _key2);
+            var className = this.constructor._className;
+            var errorString = "Invalid key to ".concat(errorMethodName, " for ").concat(className, ": ").concat(_key2);
+
+            if (shouldWarnInsteadOfThrow) {
+              // eslint-disable-next-line no-console
+              console.warn(errorString);
+            } else {
+              throw (0, _error_utils.spawnError)(errorString);
+            }
           }
         }
       } catch (err) {
@@ -150,49 +148,45 @@ function () {
       return validKeys;
     }
     /**
-     * Unwatch keys watched with `.watch`.
+     * Get notified of changes to the model.
      *
-     * Should be called with the same arguments given to `.watch`.
+     * Every call to `.watch` should have a matching call to `.unwatch`.
      *
-     * Returns the array of keys that were unwatched.
+     * Returns the array of keys that were watched.
      *
-     * @param keys the keys to unwatch
-     * @param callback the function passed to `.watch` for these keys
-     * @param context the context that was passed to `.watch` for this `callback`
+     * @param keys the keys to watch
+     * @param callback a function to call when those keys change
+     * @param context an optional context for `this` in `callback`.
      */
 
   }, {
-    key: "unwatch",
-    value: function unwatch(keys, callback, context) {
-      var arrayKeys = Array.isArray(keys) ? keys : [keys];
-      var validKeys = [];
+    key: "watch",
+    value: function watch(keys, callback, context) {
+      var validKeys = this._getWatchableValidKeysOrThrow(keys, 'watch');
+
       var _iteratorNormalCompletion2 = true;
       var _didIteratorError2 = false;
       var _iteratorError2 = undefined;
 
       try {
-        for (var _iterator2 = arrayKeys[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true) {
+        for (var _iterator2 = validKeys[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true) {
           var _key3 = _step2.value;
 
-          if (this.constructor._isWatchableKey(_key3)) {
-            validKeys.push(_key3);
-            var watchers = this._changeWatchersByKey[_key3];
-
-            if (watchers) {
-              var filteredWatchers = watchers.filter(watcher => {
-                return watcher.callback !== callback || watcher.context !== context;
-              });
-
-              if (filteredWatchers.length > 0) {
-                this._changeWatchersByKey[_key3] = filteredWatchers;
-              } else {
-                delete this._changeWatchersByKey[_key3];
-              }
-            }
-          } else {
-            // eslint-disable-next-line no-console
-            console.warn("Invalid key to unwatch for ".concat(this.constructor._className, ": ").concat(_key3));
-          }
+          if (!this._changeWatchersByKey[_key3]) {
+            this._changeWatchersByKey[_key3] = [];
+          } // Rather than pushing onto this array, we initialize a new array.
+          // This is necessary since watches can change as a result of an
+          // event getting triggered. It would be bad if as we iterate over
+          // our watchers, new watchers get pushed onto the array that we
+          // are iterating over.
+          // TODO(jb): as a perf optimization, we *could* push onto this array
+          // as long as we are not in the middle of iterating over it.
+
+
+          this._changeWatchersByKey[_key3] = [...this._changeWatchersByKey[_key3], {
+            callback,
+            context
+          }];
         }
       } catch (err) {
         _didIteratorError2 = true;
@@ -211,6 +205,63 @@ function () {
 
       return validKeys;
     }
+    /**
+     * Unwatch keys watched with `.watch`.
+     *
+     * Should be called with the same arguments given to `.watch`.
+     *
+     * Returns the array of keys that were unwatched.
+     *
+     * @param keys the keys to unwatch
+     * @param callback the function passed to `.watch` for these keys
+     * @param context the context that was passed to `.watch` for this `callback`
+     */
+
+  }, {
+    key: "unwatch",
+    value: function unwatch(keys, callback, context) {
+      // We warn instead of throw here because we used to warn instead of throw and don't
+      // want to make a breaking change.
+      var validKeys = this._getWatchableValidKeysOrThrow(keys, 'unwatch', true);
+
+      var _iteratorNormalCompletion3 = true;
+      var _didIteratorError3 = false;
+      var _iteratorError3 = undefined;
+
+      try {
+        for (var _iterator3 = validKeys[Symbol.iterator](), _step3; !(_iteratorNormalCompletion3 = (_step3 = _iterator3.next()).done); _iteratorNormalCompletion3 = true) {
+          var _key4 = _step3.value;
+          var watchers = this._changeWatchersByKey[_key4];
+
+          if (watchers) {
+            var filteredWatchers = watchers.filter(watcher => {
+              return watcher.callback !== callback || watcher.context !== context;
+            });
+
+            if (filteredWatchers.length > 0) {
+              this._changeWatchersByKey[_key4] = filteredWatchers;
+            } else {
+              delete this._changeWatchersByKey[_key4];
+            }
+          }
+        }
+      } catch (err) {
+        _didIteratorError3 = true;
+        _iteratorError3 = err;
+      } finally {
+        try {
+          if (!_iteratorNormalCompletion3 && _iterator3.return != null) {
+            _iterator3.return();
+          }
+        } finally {
+          if (_didIteratorError3) {
+            throw _iteratorError3;
+          }
+        }
+      }
+
+      return validKeys;
+    }
     /**
      * @internal
      */
@@ -218,34 +269,35 @@ function () {
   }, {
     key: "_onChange",
     value: function _onChange(key) {
-      this._changeCount += 1;
+      this.__incrementOnChangeCount();
+
       var watchers = this._changeWatchersByKey[key];
 
       if (watchers) {
-        for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key4 = 1; _key4 < _len; _key4++) {
-          args[_key4 - 1] = arguments[_key4];
+        for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key5 = 1; _key5 < _len; _key5++) {
+          args[_key5 - 1] = arguments[_key5];
         }
 
-        var _iteratorNormalCompletion3 = true;
-        var _didIteratorError3 = false;
-        var _iteratorError3 = undefined;
+        var _iteratorNormalCompletion4 = true;
+        var _didIteratorError4 = false;
+        var _iteratorError4 = undefined;
 
         try {
-          for (var _iterator3 = watchers[Symbol.iterator](), _step3; !(_iteratorNormalCompletion3 = (_step3 = _iterator3.next()).done); _iteratorNormalCompletion3 = true) {
-            var watcher = _step3.value;
+          for (var _iterator4 = watchers[Symbol.iterator](), _step4; !(_iteratorNormalCompletion4 = (_step4 = _iterator4.next()).done); _iteratorNormalCompletion4 = true) {
+            var watcher = _step4.value;
             watcher.callback.call(watcher.context, this, key, ...args);
           }
         } catch (err) {
-          _didIteratorError3 = true;
-          _iteratorError3 = err;
+          _didIteratorError4 = true;
+          _iteratorError4 = err;
         } finally {
           try {
-            if (!_iteratorNormalCompletion3 && _iterator3.return != null) {
-              _iterator3.return();
+            if (!_iteratorNormalCompletion4 && _iterator4.return != null) {
+              _iterator4.return();
             }
           } finally {
-            if (_didIteratorError3) {
-              throw _iteratorError3;
+            if (_didIteratorError4) {
+              throw _iteratorError4;
             }
           }
         }

package/dist/types/src/models/base.d.ts

@@ -168,8 +168,6 @@ declare class Base extends AbstractModel<BaseData, WatchableBaseKey> {
      */
     getTable(tableIdOrName: TableId | string): Table;
     /**
-     * _Beta feature with unstable API. May have breaking changes before release._
-     *
      * Checks whether the current user has permission to create a table.
      *
      * Accepts partial input, in the same format as {@link createTableAsync}.
@@ -196,10 +194,9 @@ declare class Base extends AbstractModel<BaseData, WatchableBaseKey> {
         options?: {
             [key: string]: unknown;
         } | null;
+        description?: string | null;
     }>): PermissionCheckResult;
     /**
-     * _Beta feature with unstable API. May have breaking changes before release._
-     *
      * An alias for `checkPermissionsForCreateTable(name, fields).hasPermission`.
      *
      * Checks whether the current user has permission to create a table.
@@ -224,14 +221,14 @@ declare class Base extends AbstractModel<BaseData, WatchableBaseKey> {
         options?: {
             [key: string]: unknown;
         } | null;
+        description?: string | null;
     }>): boolean;
     /**
-     * _Beta feature with unstable API. May have breaking changes before release._
-     *
      * Creates a new table.
      *
      * Throws an error if the user does not have permission to create a table, if an invalid
-     * table name is provided, or if invalid fields are provided (invalid name, type or options).
+     * table name is provided, or if invalid fields are provided (invalid name, type, options or
+     * description).
      *
      * Refer to {@link FieldType} for supported field types, the write format for field options, and
      * other specifics for certain field types.
@@ -248,7 +245,10 @@ declare class Base extends AbstractModel<BaseData, WatchableBaseKey> {
      * table in your app.
      *
      * @param name name for the table. must be case-insensitive unique
-     * @param fields array of fields to create in the table: see below for details.
+     * @param fields array of fields to create in the table: see below for an example. `name` and
+     * `type` must be specified for all fields, while `options` is only required for fields that
+     * have field options. `description` is optional and will be `''` if not specified or if
+     * specified as `null`.
      *
      * @example
      * ```js
@@ -256,7 +256,7 @@ declare class Base extends AbstractModel<BaseData, WatchableBaseKey> {
      *     const name = 'My new table';
      *     const fields = [
      *         // Name will be the primary field of the table.
-     *         {name: 'Name', type: FieldType.SINGLE_LINE_TEXT},
+     *         {name: 'Name', type: FieldType.SINGLE_LINE_TEXT, description: 'This is the primary field'},
      *         {name: 'Notes', type: FieldType.RICH_TEXT},
      *         {name: 'Attachments', type: FieldType.MULTIPLE_ATTACHMENTS},
      *         {name: 'Number', type: FieldType.NUMBER, options: {
@@ -282,6 +282,7 @@ declare class Base extends AbstractModel<BaseData, WatchableBaseKey> {
         options?: {
             [key: string]: unknown;
         } | null;
+        description?: string | null;
     }>): Promise<Table>;
     /**
      * Returns the maximum number of records allowed in each table of this base.

package/dist/types/src/models/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/models/base.ts"],"names":[],"mappings":"AAAA,4CAA4C,CAAC,MAAM;AACnD,OAAO,EAAC,QAAQ,EAAc,MAAM,eAAe,CAAC;AACpD,OAAO,EAAC,gBAAgB,EAAE,MAAM,EAAC,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAgB,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAoC,YAAY,EAAiB,MAAM,kBAAkB,CAAC;AAGjG,OAAO,KAAK,MAAM,SAAS,CAAC;AAE5B,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAgB7C,QAAA,MAAM,iBAAiB;;;;;;EAMrB,CAAC;AAEH;;;;;;GAMG;AACH,aAAK,gBAAgB,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAS/D;;;;;;;;;;;;;;GAcG;AACH,cAAM,IAAK,SAAQ,aAAa,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAwCxD;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;;OASG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;;;;;OAQG;IACH,IAAI,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAczB;IACD;;;;;;;;OAQG;IACH,IAAI,mBAAmB,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAIjD;IACD;;;;;OAKG;IACH,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAI5E;;;;;;;OAOG;IACH,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB;IAW7D;;;;;;;;OAQG;IACH,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,GAAG,IAAI;IA2BlF;;;;;;;;;OASG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,GAAG,IAAI;IA6B1E;;;;OAIG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAenD;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAOpC;;;;OAIG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAQvD;;;;;;OAMG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAOxC;;;;;;;;;OASG;IACH,gBAAgB,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;IAK/D;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK;IAYhD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,8BAA8B,CAC1B,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,KAAK,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,OAAO,CAAC,EAAE;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAC,GAAG,IAAI,CAAC;KAC7C,CAAC,GACH,qBAAqB;IAsBxB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,0BAA0B,CACtB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,KAAK,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,OAAO,CAAC,EAAE;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAC,GAAG,IAAI,CAAC;KAC7C,CAAC,GACH,OAAO;IAIV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;IACG,gBAAgB,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,CAAC;QACV,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,CAAC,EAAE;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAC,GAAG,IAAI,CAAC;KAC7C,CAAC,GACH,OAAO,CAAC,KAAK,CAAC;IAwBjB;;OAEG;IACH,qBAAqB,IAAI,MAAM;CAsHlC;AAED,eAAe,IAAI,CAAC"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/models/base.ts"],"names":[],"mappings":"AAAA,4CAA4C,CAAC,MAAM;AACnD,OAAO,EAAC,QAAQ,EAAc,MAAM,eAAe,CAAC;AACpD,OAAO,EAAC,gBAAgB,EAAE,MAAM,EAAC,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAgB,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAoC,YAAY,EAAiB,MAAM,kBAAkB,CAAC;AAGjG,OAAO,KAAK,MAAM,SAAS,CAAC;AAE5B,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAgB7C,QAAA,MAAM,iBAAiB;;;;;;EAMrB,CAAC;AAEH;;;;;;GAMG;AACH,aAAK,gBAAgB,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAS/D;;;;;;;;;;;;;;GAcG;AACH,cAAM,IAAK,SAAQ,aAAa,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAwCxD;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;;OASG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;;;;;OAQG;IACH,IAAI,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAczB;IACD;;;;;;;;OAQG;IACH,IAAI,mBAAmB,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAIjD;IACD;;;;;OAKG;IACH,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAI5E;;;;;;;OAOG;IACH,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB;IAW7D;;;;;;;;OAQG;IACH,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,GAAG,IAAI;IA2BlF;;;;;;;;;OASG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,GAAG,IAAI;IA6B1E;;;;OAIG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAenD;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAOpC;;;;OAIG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAQvD;;;;;;OAMG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAOxC;;;;;;;;;OASG;IACH,gBAAgB,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;IAK/D;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK;IAYhD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,8BAA8B,CAC1B,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,KAAK,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,OAAO,CAAC,EAAE;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAC,GAAG,IAAI,CAAC;QAC1C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC,GACH,qBAAqB;IAuBxB;;;;;;;;;;;;;;;;;;OAkBG;IACH,0BAA0B,CACtB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,KAAK,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,OAAO,CAAC,EAAE;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAC,GAAG,IAAI,CAAC;QAC1C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC,GACH,OAAO;IAIV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;IACG,gBAAgB,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,CAAC;QACV,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,CAAC,EAAE;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAC,GAAG,IAAI,CAAC;QAC1C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC,GACH,OAAO,CAAC,KAAK,CAAC;IA4BjB;;OAEG;IACH,qBAAqB,IAAI,MAAM;CAsHlC;AAED,eAAe,IAAI,CAAC"}

package/dist/types/src/models/cursor.d.ts

@@ -47,6 +47,7 @@ interface CursorData {
  *      return (
  *          <div>
  *              Active table: {cursor.activeTableId}
+ *              <br />
  *              Active view: {cursor.activeViewId}
  *          </div>
  *      );
@@ -67,6 +68,7 @@ interface CursorData {
  *      return (
  *          <div>
  *              Selected records: {cursor.selectedRecordIds.join(', ')}
+ *              <br />
  *              Selected fields: {cursor.selectedFieldIds.join(', ')}
  *          </div>
  *      );

package/dist/types/src/models/cursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../../src/models/cursor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,QAAQ,EAAC,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AACrC,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAuB,YAAY,EAAE,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAE/E,OAAO,0BAA0B,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,MAAM,SAAS,CAAC;AAC5B,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC1B,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,QAAA,MAAM,mBAAmB;;;;;;EAMvB,CAAC;AAEH;;;;;;;GAOG;AACH,aAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEnE,cAAc;AACd,UAAU,UAAU;IAChB,mBAAmB,EAAE,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,kBAAkB,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvD,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,cAAM,MAAO,SAAQ,0BAA0B,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAiE3E;;;;;;;OAOG;IACH,IAAI,iBAAiB,IAAI,KAAK,CAAC,QAAQ,CAAC,CAKvC;IACD;;;;;;;OAOG;IACH,IAAI,gBAAgB,IAAI,KAAK,CAAC,QAAQ,CAAC,CAKtC;IACD;;;;;;;OAOG;IACH,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAW5D;;;;;;;;OAQG;IACH,IAAI,aAAa,IAAI,OAAO,GAAG,IAAI,CAElC;IACD;;;;;;;;;OASG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IACD;;;;;;OAMG;IACH,cAAc,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI;IAIrD;;;;;;;OAOG;IACH,aAAa,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,EAAE,YAAY,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI;CA+EpF;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../../src/models/cursor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,QAAQ,EAAC,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AACrC,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAuB,YAAY,EAAE,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAE/E,OAAO,0BAA0B,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,MAAM,SAAS,CAAC;AAC5B,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC1B,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,QAAA,MAAM,mBAAmB;;;;;;EAMvB,CAAC;AAEH;;;;;;;GAOG;AACH,aAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEnE,cAAc;AACd,UAAU,UAAU;IAChB,mBAAmB,EAAE,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,kBAAkB,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvD,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,cAAM,MAAO,SAAQ,0BAA0B,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAiE3E;;;;;;;OAOG;IACH,IAAI,iBAAiB,IAAI,KAAK,CAAC,QAAQ,CAAC,CAKvC;IACD;;;;;;;OAOG;IACH,IAAI,gBAAgB,IAAI,KAAK,CAAC,QAAQ,CAAC,CAKtC;IACD;;;;;;;OAOG;IACH,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAW5D;;;;;;;;OAQG;IACH,IAAI,aAAa,IAAI,OAAO,GAAG,IAAI,CAElC;IACD;;;;;;;;;OASG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IACD;;;;;;OAMG;IACH,cAAc,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI;IAIrD;;;;;;;OAOG;IACH,aAAa,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,EAAE,YAAY,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI;CA+EpF;AAED,eAAe,MAAM,CAAC"}

package/dist/types/src/models/field.d.ts

@@ -1,8 +1,9 @@
 /** @module @airtable/blocks/models: Field */ /** */
 import { AggregatorKey } from '../types/aggregators';
-import { PermissionCheckResult } from '../types/mutations';
+import { PermissionCheckResult, UpdateFieldOptionsOpts } from '../types/mutations';
 import { FieldData, FieldType, FieldOptions, FieldConfig } from '../types/field';
 import { ObjectValues } from '../private_utils';
+import { FieldTypeConfig } from '../types/airtable_interface';
 import AbstractModel from './abstract_model';
 import { Aggregator } from './create_aggregators';
 declare const WatchableFieldKeys: Readonly<{
@@ -72,6 +73,8 @@ declare class Field extends AbstractModel<FieldData, WatchableFieldKey> {
      * ```
      */
     get options(): FieldOptions | null;
+    _getCachedConfigFromFieldTypeProvider(): FieldTypeConfig;
+    _clearCachedConfig(): void;
     /**
      * The type and options of the field to make type narrowing `FieldOptions` easier.
      *
@@ -89,13 +92,11 @@ declare class Field extends AbstractModel<FieldData, WatchableFieldKey> {
      */
     get config(): FieldConfig;
     /**
-     * _Beta feature with unstable API. May have breaking changes before release._
-     *
      * Checks whether the current user has permission to perform the given options update.
      *
      * Accepts partial input, in the same format as {@link updateOptionsAsync}.
      *
-     * Returns `{hasPermission: true}` if the current user can update the specified record,
+     * Returns `{hasPermission: true}` if the current user can update the specified field,
      * `{hasPermission: false, reasonDisplayString: string}` otherwise. `reasonDisplayString` may be
      * used to display an error message to the user.
      *
@@ -112,8 +113,6 @@ declare class Field extends AbstractModel<FieldData, WatchableFieldKey> {
      */
     checkPermissionsForUpdateOptions(options?: FieldOptions): PermissionCheckResult;
     /**
-     * _Beta feature with unstable API. May have breaking changes before release._
-     *
      * An alias for `checkPermissionsForUpdateOptions(options).hasPermission`.
      *
      * Checks whether the current user has permission to perform the options update.
@@ -133,8 +132,6 @@ declare class Field extends AbstractModel<FieldData, WatchableFieldKey> {
      */
     hasPermissionToUpdateOptions(options?: FieldOptions): boolean;
     /**
-     * _Beta feature with unstable API. May have breaking changes before release._
-     *
      * Updates the options for this field.
      *
      * Throws an error if the user does not have permission to update the field, if invalid
@@ -148,7 +145,11 @@ declare class Field extends AbstractModel<FieldData, WatchableFieldKey> {
      * **not** applied optimistically locally. You must `await` the returned promise before
      * relying on the change in your app.
      *
+     * Optionally, you can pass an `opts` object as the second argument. See {@link UpdateFieldOptionsOpts}
+     * for available options.
+     *
      * @param options new options for the field
+     * @param opts optional options to affect the behavior of the update
      *
      * @example
      * ```js
@@ -166,7 +167,68 @@ declare class Field extends AbstractModel<FieldData, WatchableFieldKey> {
      * }
      * ```
      */
-    updateOptionsAsync(options: FieldOptions): Promise<void>;
+    updateOptionsAsync(options: FieldOptions, opts?: UpdateFieldOptionsOpts): Promise<void>;
+    /**
+     * Checks whether the current user has permission to perform the given description update.
+     *
+     * Accepts partial input, in the same format as {@link updateDescriptionAsync}.
+     *
+     * Returns `{hasPermission: true}` if the current user can update the specified field,
+     * `{hasPermission: false, reasonDisplayString: string}` otherwise. `reasonDisplayString` may be
+     * used to display an error message to the user.
+     *
+     * @param description new description for the field
+     *
+     * @example
+     * ```js
+     * const updateFieldCheckResult = field.checkPermissionsForUpdateDescription();
+     *
+     * if (!updateFieldCheckResult.hasPermission) {
+     *     alert(updateFieldCheckResult.reasonDisplayString);
+     * }
+     * ```
+     */
+    checkPermissionsForUpdateDescription(description?: string | null): PermissionCheckResult;
+    /**
+     * An alias for `checkPermissionsForUpdateDescription(options).hasPermission`.
+     *
+     * Checks whether the current user has permission to perform the description update.
+     *
+     * Accepts partial input, in the same format as {@link updateDescriptionAsync}.
+     *
+     * @param description new description for the field
+     *
+     * @example
+     * ```js
+     * const canUpdateField = field.hasPermissionToUpdateDescription();
+     *
+     * if (!canUpdateField) {
+     *     alert('not allowed!');
+     * }
+     * ```
+     */
+    hasPermissionToUpdateDescription(description?: string | null): boolean;
+    /**
+     * Updates the description for this field.
+     *
+     * To remove an existing description, pass `''` as the new description.
+     * `null` is also accepted and will be coerced to `''` for consistency with field creation.
+     *
+     * Throws an error if the user does not have permission to update the field, or if an invalid
+     * description is provided.
+     *
+     * This action is asynchronous. Unlike updates to cell values, updates to field descriptions are
+     * **not** applied optimistically locally. You must `await` the returned promise before
+     * relying on the change in your app.
+     *
+     * @param description new description for the field
+     *
+     * @example
+     * ```js
+     * await myTextField.updateDescriptionAsync('This is a text field');
+     * ```
+     */
+    updateDescriptionAsync(description: string | null): Promise<void>;
     /**
      * `true` if this field is computed, `false` otherwise. A field is
      * "computed" if it's value is not set by user input (e.g. autoNumber, formula,

package/dist/types/src/models/field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../src/models/field.ts"],"names":[],"mappings":"AAAA,6CAA6C,CAAC,MAAM;AACpD,OAAO,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAgB,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAiC,YAAY,EAAgB,MAAM,kBAAkB,CAAC;AAC7F,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAKhD,QAAA,MAAM,kBAAkB;;;;;;EAMtB,CAAC;AAEH;;;;;;;GAOG;AACH,oBAAY,iBAAiB,GAAG,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,cAAM,KAAM,SAAQ,aAAa,CAAC,SAAS,EAAE,iBAAiB,CAAC;IAuC3D;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,SAAS,CAiBpB;IACD;;;;;;;;;;;;;;;OAeG;IACH,IAAI,OAAO,IAAI,YAAY,GAAG,IAAI,CAYjC;IAED;;;;;;;;;;;;;;OAcG;IACH,IAAI,MAAM,IAAI,WAAW,CAKxB;IACD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,gCAAgC,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,qBAAqB;IAY/E;;;;;;;;;;;;;;;;;;;OAmBG;IACH,4BAA4B,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO;IAI7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9D;;;;;;;;;;;;OAYG;IACH,IAAI,UAAU,IAAI,OAAO,CAGxB;IACD;;;OAGG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;;;;;;;OAQG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAID;;;;;;;OAOG;IACH,IAAI,oBAAoB,IAAI,KAAK,CAAC,UAAU,CAAC,CAU5C;IAID;;;;;;;;;;;;;;;;;OAiBG;IACH,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,OAAO;IAUtE;;;;;;;;;;;;OAYG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAqDpD;AAED,eAAe,KAAK,CAAC"}
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../src/models/field.ts"],"names":[],"mappings":"AAAA,6CAA6C,CAAC,MAAM;AACpD,OAAO,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAgB,qBAAqB,EAAE,sBAAsB,EAAC,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAiC,YAAY,EAAgB,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAC;AAC5D,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAKhD,QAAA,MAAM,kBAAkB;;;;;;EAMtB,CAAC;AAEH;;;;;;;GAOG;AACH,oBAAY,iBAAiB,GAAG,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,cAAM,KAAM,SAAQ,aAAa,CAAC,SAAS,EAAE,iBAAiB,CAAC;IA0C3D;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,SAAS,CAUpB;IACD;;;;;;;;;;;;;;;OAeG;IACH,IAAI,OAAO,IAAI,YAAY,GAAG,IAAI,CAOjC;IAKD,qCAAqC,IAAI,eAAe;IAexD,kBAAkB,IAAI,IAAI;IAI1B;;;;;;;;;;;;;;OAcG;IACH,IAAI,MAAM,IAAI,WAAW,CAKxB;IACD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,gCAAgC,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,qBAAqB;IAY/E;;;;;;;;;;;;;;;;;OAiBG;IACH,4BAA4B,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO;IAI7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,kBAAkB,CACpB,OAAO,EAAE,YAAY,EACrB,IAAI,GAAE,sBAA2B,GAClC,OAAO,CAAC,IAAI,CAAC;IAahB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,oCAAoC,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB;IASxF;;;;;;;;;;;;;;;;;OAiBG;IACH,gCAAgC,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAItE;;;;;;;;;;;;;;;;;;;OAmBG;IACG,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IASvE;;;;;;;;;;;;OAYG;IACH,IAAI,UAAU,IAAI,OAAO,CAGxB;IACD;;;OAGG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;;;;;;;OAQG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAID;;;;;;;OAOG;IACH,IAAI,oBAAoB,IAAI,KAAK,CAAC,UAAU,CAAC,CAU5C;IAID;;;;;;;;;;;;;;;;;OAiBG;IACH,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,OAAO;IAUtE;;;;;;;;;;;;OAYG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAwDpD;AAED,eAAe,KAAK,CAAC"}

package/dist/types/src/models/grouped_record_query_result.d.ts

@@ -9,7 +9,7 @@ import Field from './field';
 /** @hidden */
 interface GroupedRecordQueryResultData {
     groupData: GroupData;
-    groupLevels: Array<NormalizedGroupLevel>;
+    groupLevels: ReadonlyArray<NormalizedGroupLevel>;
 }
 /**
  * Represents a group of records returned from a group query. See {@link RecordQueryResult} for main
@@ -22,7 +22,7 @@ interface GroupedRecordQueryResultData {
  * @hidden
  */
 declare class GroupedRecordQueryResult extends RecordQueryResult<GroupedRecordQueryResultData> {
-    _orderedRecordIds: Array<RecordId> | null;
+    _orderedRecordIds: ReadonlyArray<RecordId> | null;
     /**
      * Gets children groups of this group (if any exist)
      */
@@ -40,7 +40,7 @@ declare class GroupedRecordQueryResult extends RecordQueryResult<GroupedRecordQu
      * This returns all recordIds of all children groups (in grouped order).
      * Watchable.
      */
-    get recordIds(): Array<RecordId>;
+    get recordIds(): ReadonlyArray<RecordId>;
     /**
      * The fields that were used to create the parent RecordQueryResult that created this GroupedRecordQueryResult.
      * This is separate from the field/fieldId property - which is the field this grouping is based upon.

package/dist/types/src/models/grouped_record_query_result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grouped_record_query_result.d.ts","sourceRoot":"","sources":["../../../../src/models/grouped_record_query_result.ts"],"names":[],"mappings":"AAAA,yDAAyD,CAAC,MAAM;AAChE,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAC,eAAe,EAAE,aAAa,EAAY,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAC,QAAQ,EAAC,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AACjE,OAAO,iBAAiB,EAAE,EACtB,6BAA6B,EAEhC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,MAAM,SAAS,CAAC;AAI5B,cAAc;AAGd,UAAU,4BAA4B;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC;CAC5C;AAED;;;;;;;;;GASG;AACH,cAAM,wBAAyB,SAAQ,iBAAiB,CAAC,4BAA4B,CAAC;IA2BlF,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAQ;IAwCjD;;OAEG;IACH,IAAI,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAEnD;IAOD;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,KAAK,CAEjB;IAmDD;;;;OAIG;IACH,IAAI,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,CAQ/B;IAED;;;;;OAKG;IACH,IAAI,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAGhC;IAED,kBAAkB;IAClB,KAAK,CACD,IAAI,EAAE,6BAA6B,GAAG,aAAa,CAAC,6BAA6B,CAAC,EAClF,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAC/B,KAAK,CAAC,6BAA6B,CAAC;IAQvC,kBAAkB;IAClB,OAAO,CACH,IAAI,EAAE,6BAA6B,GAAG,aAAa,CAAC,6BAA6B,CAAC,EAClF,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAC/B,KAAK,CAAC,6BAA6B,CAAC;IAIvC,kBAAkB;IACZ,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAsEpC,kBAAkB;IAClB,IAAI,YAAY,IAAI,OAAO,CAE1B;CA6BJ;AAED,eAAe,wBAAwB,CAAC"}
+{"version":3,"file":"grouped_record_query_result.d.ts","sourceRoot":"","sources":["../../../../src/models/grouped_record_query_result.ts"],"names":[],"mappings":"AAAA,yDAAyD,CAAC,MAAM;AAChE,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAC,eAAe,EAAE,aAAa,EAAY,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAC,QAAQ,EAAC,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AACjE,OAAO,iBAAiB,EAAE,EACtB,6BAA6B,EAEhC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,MAAM,SAAS,CAAC;AAI5B,cAAc;AAGd,UAAU,4BAA4B;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;CACpD;AAED;;;;;;;;;GASG;AACH,cAAM,wBAAyB,SAAQ,iBAAiB,CAAC,4BAA4B,CAAC;IA2BlF,iBAAiB,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAQ;IAwCzD;;OAEG;IACH,IAAI,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAEnD;IAOD;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,KAAK,CAEjB;IAmDD;;;;OAIG;IACH,IAAI,SAAS,IAAI,aAAa,CAAC,QAAQ,CAAC,CAQvC;IAED;;;;;OAKG;IACH,IAAI,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAGhC;IAED,kBAAkB;IAClB,KAAK,CACD,IAAI,EAAE,6BAA6B,GAAG,aAAa,CAAC,6BAA6B,CAAC,EAClF,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAC/B,KAAK,CAAC,6BAA6B,CAAC;IAOvC,kBAAkB;IAClB,OAAO,CACH,IAAI,EAAE,6BAA6B,GAAG,aAAa,CAAC,6BAA6B,CAAC,EAClF,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAC/B,KAAK,CAAC,6BAA6B,CAAC;IAIvC,kBAAkB;IACZ,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAsDpC,kBAAkB;IAClB,IAAI,YAAY,IAAI,OAAO,CAE1B;CA6BJ;AAED,eAAe,wBAAwB,CAAC"}

package/dist/types/src/models/linked_records_query_result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linked_records_query_result.d.ts","sourceRoot":"","sources":["../../../../src/models/linked_records_query_result.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,eAAe,EAAE,aAAa,EAAY,MAAM,kBAAkB,CAAC;AAG3E,OAAO,iBAAiB,EAAE,EACtB,6BAA6B,EAEhC,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,MAAM,SAAS,CAAC;AAC5B,OAAO,MAAM,MAAM,UAAU,CAAC;AAG9B,eAAO,MAAM,gBAAgB,0BAM5B,CAAC;AAEF,eAAe;AACf,UAAU,4BAA4B;CAAG;AAEzC;;;;;;;;GAQG;AACH,cAAM,wBAAyB,SAAQ,iBAAiB,CAAC,4BAA4B,CAAC;IA2ElF;;;;;;;;OAQG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAYD;;OAEG;IACH,IAAI,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,CAS7B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,CAQ3B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAIhC;IAED,kBAAkB;IAClB,KAAK,CACD,IAAI,EAAE,6BAA6B,GAAG,aAAa,CAAC,6BAA6B,CAAC,EAClF,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAC/B,KAAK,CAAC,6BAA6B,CAAC;IAmBvC,kBAAkB;IAClB,OAAO,CACH,IAAI,EAAE,6BAA6B,GAAG,aAAa,CAAC,6BAA6B,CAAC,EAClF,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAC/B,KAAK,CAAC,6BAA6B,CAAC;IAqBvC,kBAAkB;IACZ,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA0EpC;;;;OAIG;IACH,IAAI,SAAS,WAEZ;CAsWJ;AAED,eAAe,wBAAwB,CAAC"}
+{"version":3,"file":"linked_records_query_result.d.ts","sourceRoot":"","sources":["../../../../src/models/linked_records_query_result.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,eAAe,EAAE,aAAa,EAAY,MAAM,kBAAkB,CAAC;AAS3E,OAAO,iBAAiB,EAAE,EACtB,6BAA6B,EAEhC,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,MAAM,SAAS,CAAC;AAC5B,OAAO,MAAM,MAAM,UAAU,CAAC;AAG9B,eAAO,MAAM,gBAAgB,0BAM5B,CAAC;AAEF,eAAe;AACf,UAAU,4BAA4B;CAAG;AAEzC;;;;;;;;GAQG;AACH,cAAM,wBAAyB,SAAQ,iBAAiB,CAAC,4BAA4B,CAAC;IA6ElF;;;;;;;;OAQG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAYD;;OAEG;IACH,IAAI,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,CAS7B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,CAQ3B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAIhC;IAED,kBAAkB;IAClB,KAAK,CACD,IAAI,EAAE,6BAA6B,GAAG,aAAa,CAAC,6BAA6B,CAAC,EAClF,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAC/B,KAAK,CAAC,6BAA6B,CAAC;IAmBvC,kBAAkB;IAClB,OAAO,CACH,IAAI,EAAE,6BAA6B,GAAG,aAAa,CAAC,6BAA6B,CAAC,EAClF,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAC/B,KAAK,CAAC,6BAA6B,CAAC;IAqBvC,kBAAkB;IACZ,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAoFpC;;;;OAIG;IACH,IAAI,SAAS,WAEZ;CAqYJ;AAED,eAAe,wBAAwB,CAAC"}

package/dist/types/src/models/mutation_constants.d.ts

@@ -1,4 +1,5 @@
 export declare const MAX_FIELD_NAME_LENGTH = 255;
+export declare const MAX_FIELD_DESCRIPTION_LENGTH = 20000;
 export declare const MAX_TABLE_NAME_LENGTH = 255;
 export declare const MAX_NUM_FIELDS_PER_TABLE = 500;
 //# sourceMappingURL=mutation_constants.d.ts.map

package/dist/types/src/models/mutation_constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutation_constants.d.ts","sourceRoot":"","sources":["../../../../src/models/mutation_constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,wBAAwB,MAAM,CAAC"}
+{"version":3,"file":"mutation_constants.d.ts","sourceRoot":"","sources":["../../../../src/models/mutation_constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAClD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,wBAAwB,MAAM,CAAC"}

package/dist/types/src/models/mutations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../../src/models/mutations.ts"],"names":[],"mappings":"AAopBA,eAAe,SAAS,CAAC"}
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../../src/models/mutations.ts"],"names":[],"mappings":"AAilBA,eAAe,SAAS,CAAC"}

package/dist/types/src/models/query_manager.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query_manager.d.ts.map

package/dist/types/src/models/query_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_manager.d.ts","sourceRoot":"","sources":["../../../../src/models/query_manager.ts"],"names":[],"mappings":""}

package/dist/types/src/models/record.d.ts

@@ -1,9 +1,8 @@
 /** @module @airtable/blocks/models: Record */ /** */
 import { Color } from '../colors';
-import { RecordData } from '../types/record';
 import { FieldId } from '../types/field';
 import { ViewId } from '../types/view';
-import { ObjectValues } from '../private_utils';
+import { ObjectValues, FlowAnyObject, FlowAnyFunction } from '../private_utils';
 import AbstractModel from './abstract_model';
 import Field from './field';
 import View from './view';
@@ -23,6 +22,12 @@ declare const WatchableRecordKeys: Readonly<{
  * - `'colorInView:' + someViewId`
  */
 declare type WatchableRecordKey = ObjectValues<typeof WatchableRecordKeys> | string;
+/**
+ * TODO: (#proj-blocks-sdk-record-limits) Record should probably not be an AbstractModel,
+ * in the meantime it will return true if it's loaded, throwing/returning null
+ * if it's not loaded (returning null / throwing is how AbstractModel works).
+ */
+declare type RecordStoreIsLoaded = true;
 /**
  * Model class representing a record in a table.
  *
@@ -31,7 +36,7 @@ declare type WatchableRecordKey = ObjectValues<typeof WatchableRecordKeys> | str
  *
  * @docsPath models/Record
  */
-declare class Record extends AbstractModel<RecordData, WatchableRecordKey> {
+declare class Record extends AbstractModel<RecordStoreIsLoaded, WatchableRecordKey> {
     /**
      * Gets the cell value of the given field for this record.
      *
@@ -172,6 +177,10 @@ declare class Record extends AbstractModel<RecordData, WatchableRecordKey> {
      * ```
      */
     get createdTime(): Date;
+    /** @inheritdoc */
+    watch(keys: WatchableRecordKey | ReadonlyArray<WatchableRecordKey>, callbackForRegistration: FlowAnyFunction, context?: FlowAnyObject | null): Array<WatchableRecordKey>;
+    /** @inheritdoc */
+    unwatch(keys: WatchableRecordKey | ReadonlyArray<WatchableRecordKey>, callbackForRegistration: FlowAnyFunction, context?: FlowAnyObject | null): Array<WatchableRecordKey>;
 }
 export default Record;
 //# sourceMappingURL=record.d.ts.map

package/dist/types/src/models/record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../src/models/record.ts"],"names":[],"mappings":"AAAA,8CAA8C,CAAC,MAAM;AACrD,OAAO,EAAC,KAAK,EAAC,MAAM,WAAW,CAAC;AAEhC,OAAO,EAAC,UAAU,EAAW,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAY,OAAO,EAAC,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AACrC,OAAO,EAAwC,YAAY,EAAgB,MAAM,kBAAkB,CAAC;AAGpG,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,MAAM,SAAS,CAAC;AAG5B,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC1B,OAA0B,EAAC,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAC/E,OAAO,wBAAwB,MAAM,+BAA+B,CAAC;AAGrE,QAAA,MAAM,mBAAmB;;;;EAMvB,CAAC;AAOH;;;;;;;GAOG;AACH,aAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,GAAG,MAAM,CAAC;AAE5E;;;;;;;GAOG;AACH,cAAM,MAAO,SAAQ,aAAa,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAsG9D;;;;;;;;;;OAUG;IACH,YAAY,CAAC,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO;IAoC1E;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM;IAuBjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,sCAAsC,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAS3F;;;;;;;OAOG;IACH,cAAc,CAAC,sBAAsB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;IAK5E;;;;;;;OAOG;IACH,iBAAiB,CAAC,sBAAsB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvE;;;;;;;OAOG;IACH,2BAA2B,CACvB,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,EACnD,IAAI,GAAE,qBAA0B,GACjC,wBAAwB;IAoB3B;;;;;;;;;OASG;IACG,gCAAgC,CAClC,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,EACnD,IAAI,GAAE,qBAA0B,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAKpC;;;;;;;;OAQG;IACH,IAAI,GAAG,IAAI,MAAM,CAKhB;IACD;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD;;;;;;;;;;;OAWG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IACD;;;;;;;;;OASG;IACH,IAAI,WAAW,IAAI,IAAI,CAEtB;CAiCJ;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../src/models/record.ts"],"names":[],"mappings":"AAAA,8CAA8C,CAAC,MAAM;AACrD,OAAO,EAAC,KAAK,EAAC,MAAM,WAAW,CAAC;AAGhC,OAAO,EAAY,OAAO,EAAC,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AACrC,OAAO,EAGH,YAAY,EACZ,aAAa,EACb,eAAe,EAElB,MAAM,kBAAkB,CAAC;AAY1B,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,MAAM,SAAS,CAAC;AAG5B,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC1B,OAA0B,EAAC,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAC/E,OAAO,wBAAwB,MAAM,+BAA+B,CAAC;AAKrE,QAAA,MAAM,mBAAmB;;;;EAMvB,CAAC;AAOH;;;;;;;GAOG;AACH,aAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,GAAG,MAAM,CAAC;AAE5E;;;;GAIG;AACH,aAAK,mBAAmB,GAAG,IAAI,CAAC;AAiBhC;;;;;;;GAOG;AACH,cAAM,MAAO,SAAQ,aAAa,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;IA2HvE;;;;;;;;;;OAUG;IACH,YAAY,CAAC,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO;IAoC1E;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM;IAkBjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,sCAAsC,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAS3F;;;;;;;OAOG;IACH,cAAc,CAAC,sBAAsB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;IAK5E;;;;;;;OAOG;IACH,iBAAiB,CAAC,sBAAsB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvE;;;;;;;OAOG;IACH,2BAA2B,CACvB,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,EACnD,IAAI,GAAE,qBAA0B,GACjC,wBAAwB;IAoB3B;;;;;;;;;OASG;IACG,gCAAgC,CAClC,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,EACnD,IAAI,GAAE,qBAA0B,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAKpC;;;;;;;;OAQG;IACH,IAAI,GAAG,IAAI,MAAM,CAKhB;IACD;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD;;;;;;;;;;;OAWG;IACH,IAAI,YAAY,IAAI,MAAM,CAIzB;IACD;;;;;;;;;OASG;IACH,IAAI,WAAW,IAAI,IAAI,CAItB;IAyID,kBAAkB;IAClB,KAAK,CACD,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAAC,kBAAkB,CAAC,EAC5D,uBAAuB,EAAE,eAAe,EACxC,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAC/B,KAAK,CAAC,kBAAkB,CAAC;IA0C5B,kBAAkB;IAClB,OAAO,CACH,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAAC,kBAAkB,CAAC,EAC5D,uBAAuB,EAAE,eAAe,EACxC,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAC/B,KAAK,CAAC,kBAAkB,CAAC;CAsC/B;AAED,eAAe,MAAM,CAAC"}