@airtable/blocks 1.3.0 → 1.5.1

package/dist/cjs/unstable_testing_utils.js

@@ -0,0 +1,163 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "BaseData", {
+  enumerable: true,
+  get: function get() {
+    return _base.BaseData;
+  }
+});
+Object.defineProperty(exports, "ModelChange", {
+  enumerable: true,
+  get: function get() {
+    return _base.ModelChange;
+  }
+});
+Object.defineProperty(exports, "Mutation", {
+  enumerable: true,
+  get: function get() {
+    return _mutations.Mutation;
+  }
+});
+Object.defineProperty(exports, "MutationTypes", {
+  enumerable: true,
+  get: function get() {
+    return _mutations.MutationTypes;
+  }
+});
+Object.defineProperty(exports, "AppInterface", {
+  enumerable: true,
+  get: function get() {
+    return _airtable_interface.AppInterface;
+  }
+});
+Object.defineProperty(exports, "BlockRunContextType", {
+  enumerable: true,
+  get: function get() {
+    return _airtable_interface.BlockRunContextType;
+  }
+});
+Object.defineProperty(exports, "SdkInitData", {
+  enumerable: true,
+  get: function get() {
+    return _airtable_interface.SdkInitData;
+  }
+});
+Object.defineProperty(exports, "PartialViewData", {
+  enumerable: true,
+  get: function get() {
+    return _airtable_interface.PartialViewData;
+  }
+});
+Object.defineProperty(exports, "RecordData", {
+  enumerable: true,
+  get: function get() {
+    return _record.RecordData;
+  }
+});
+Object.defineProperty(exports, "CursorData", {
+  enumerable: true,
+  get: function get() {
+    return _cursor.CursorData;
+  }
+});
+Object.defineProperty(exports, "FieldData", {
+  enumerable: true,
+  get: function get() {
+    return _field.FieldData;
+  }
+});
+Object.defineProperty(exports, "FieldType", {
+  enumerable: true,
+  get: function get() {
+    return _field.FieldType;
+  }
+});
+Object.defineProperty(exports, "ViewType", {
+  enumerable: true,
+  get: function get() {
+    return _view.ViewType;
+  }
+});
+Object.defineProperty(exports, "ViewportSizeConstraint", {
+  enumerable: true,
+  get: function get() {
+    return _viewport.ViewportSizeConstraint;
+  }
+});
+Object.defineProperty(exports, "GlobalConfigUpdate", {
+  enumerable: true,
+  get: function get() {
+    return _global_config.GlobalConfigUpdate;
+  }
+});
+Object.defineProperty(exports, "GlobalConfigData", {
+  enumerable: true,
+  get: function get() {
+    return _global_config.GlobalConfigData;
+  }
+});
+Object.defineProperty(exports, "GlobalConfigArray", {
+  enumerable: true,
+  get: function get() {
+    return _global_config.GlobalConfigArray;
+  }
+});
+Object.defineProperty(exports, "GlobalConfigObject", {
+  enumerable: true,
+  get: function get() {
+    return _global_config.GlobalConfigObject;
+  }
+});
+Object.defineProperty(exports, "RequestJson", {
+  enumerable: true,
+  get: function get() {
+    return _backend_fetch_types.RequestJson;
+  }
+});
+Object.defineProperty(exports, "ResponseJson", {
+  enumerable: true,
+  get: function get() {
+    return _backend_fetch_types.ResponseJson;
+  }
+});
+Object.defineProperty(exports, "Sdk", {
+  enumerable: true,
+  get: function get() {
+    return _sdk.default;
+  }
+});
+Object.defineProperty(exports, "AbstractMockAirtableInterface", {
+  enumerable: true,
+  get: function get() {
+    return _mock_airtable_interface.default;
+  }
+});
+
+var _base = require("./types/base");
+
+var _mutations = require("./types/mutations");
+
+var _airtable_interface = require("./types/airtable_interface");
+
+var _record = require("./types/record");
+
+var _cursor = require("./types/cursor");
+
+var _field = require("./types/field");
+
+var _view = require("./types/view");
+
+var _viewport = require("./types/viewport");
+
+var _global_config = require("./types/global_config");
+
+var _backend_fetch_types = require("./types/backend_fetch_types");
+
+var _sdk = _interopRequireDefault(require("./sdk"));
+
+var _mock_airtable_interface = _interopRequireDefault(require("./testing/mock_airtable_interface"));

package/dist/types/src/color_utils.d.ts

@@ -29,9 +29,9 @@ interface ColorUtils {
      * // => null
      * ```
      */
-    getHexForColor(colorString: string): null | string;
-    /** */
     getHexForColor(colorString: Color): string;
+    /** */
+    getHexForColor(colorString: string): null | string;
     /**
      * Given a {@link Color}, return an {@link RGB} object representing it, or null if the value isn't a {@link Color}
      *
@@ -47,9 +47,9 @@ interface ColorUtils {
      * // => null
      * ```
      */
-    getRgbForColor(colorString: string): RGB | null;
-    /** */
     getRgbForColor(colorString: Color): RGB;
+    /** */
+    getRgbForColor(colorString: string): RGB | null;
     /**
      * Given a {@link Color}, returns true or false to indicate whether that color should have light text on top of it when used as a background color.
      *

package/dist/types/src/color_utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color_utils.d.ts","sourceRoot":"","sources":["../../../src/color_utils.ts"],"names":[],"mappings":"AAEA,OAAe,EAAC,KAAK,EAAmB,MAAM,UAAU,CAAC;AAEzD,8EAA8E;AAC9E,UAAU,GAAG;IACT,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,2BAA2B;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,UAAU,UAAU;IAChB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IACnD,MAAM;IACN,cAAc,CAAC,WAAW,EAAE,KAAK,GAAG,MAAM,CAAC;IAE3C;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC;IAChD,MAAM;IACN,cAAc,CAAC,WAAW,EAAE,KAAK,GAAG,GAAG,CAAC;IAExC;;;;;;;;;;;;;;OAcG;IACH,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3D;AAED,QAAA,MAAM,UAAU,EAAE,UAmCjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"color_utils.d.ts","sourceRoot":"","sources":["../../../src/color_utils.ts"],"names":[],"mappings":"AAEA,OAAe,EAAC,KAAK,EAAmB,MAAM,UAAU,CAAC;AAEzD,8EAA8E;AAC9E,UAAU,GAAG;IACT,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,2BAA2B;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,UAAU,UAAU;IAChB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,WAAW,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3C,MAAM;IACN,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAEnD;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,WAAW,EAAE,KAAK,GAAG,GAAG,CAAC;IACxC,MAAM;IACN,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC;IAEhD;;;;;;;;;;;;;;OAcG;IACH,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3D;AAED,QAAA,MAAM,UAAU,EAAE,UAmCjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/types/src/index.d.ts

@@ -1,13 +1,13 @@
 import Sdk from './sdk';
 export declare let base: Sdk['base'];
-export declare let cursor: Sdk['cursor'];
 export declare let globalConfig: Sdk['globalConfig'];
 export declare let installationId: Sdk['installationId'];
 export declare let reload: Sdk['reload'];
 export declare let runInfo: Sdk['runInfo'];
-export declare let session: Sdk['session'];
 export declare let settingsButton: Sdk['settingsButton'];
 export declare let undoRedo: Sdk['undoRedo'];
 export declare let viewport: Sdk['viewport'];
 export declare let unstable_fetchAsync: Sdk['unstable_fetchAsync'];
+export declare let cursor: Sdk['cursor'];
+export declare let session: Sdk['session'];
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,GAAG,MAAM,OAAO,CAAC;AAOxB,eAAO,IAAI,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AAC7B,eAAO,IAAI,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;AACjC,eAAO,IAAI,YAAY,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;AAC7C,eAAO,IAAI,cAAc,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACjD,eAAO,IAAI,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;AACjC,eAAO,IAAI,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;AACnC,eAAO,IAAI,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;AACnC,eAAO,IAAI,cAAc,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACjD,eAAO,IAAI,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;AACrC,eAAO,IAAI,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;AACrC,eAAO,IAAI,mBAAmB,EAAE,GAAG,CAAC,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,GAAG,MAAM,OAAO,CAAC;AAMxB,eAAO,IAAI,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AAC7B,eAAO,IAAI,YAAY,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;AAC7C,eAAO,IAAI,cAAc,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACjD,eAAO,IAAI,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;AACjC,eAAO,IAAI,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;AACnC,eAAO,IAAI,cAAc,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACjD,eAAO,IAAI,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;AACrC,eAAO,IAAI,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;AACrC,eAAO,IAAI,mBAAmB,EAAE,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAK3D,eAAO,IAAI,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;AAejC,eAAO,IAAI,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC"}

package/dist/types/src/injected/airtable_interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"airtable_interface.d.ts","sourceRoot":"","sources":["../../../../src/injected/airtable_interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AAM9D,cAAc;AACd,MAAM,CAAC,OAAO,UAAU,oBAAoB,IAAI,iBAAiB,CAchE"}
+{"version":3,"file":"airtable_interface.d.ts","sourceRoot":"","sources":["../../../../src/injected/airtable_interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AAmB9D,cAAc;AACd,MAAM,CAAC,OAAO,UAAU,oBAAoB,IAAI,iBAAiB,CAchE"}

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

@@ -39,12 +39,10 @@ interface CursorData {
  * {@link useLoadable} to access them.
  *
  * ```js
- * import {cursor} from '@airtable/blocks';
- * import {useWatchable} from '@airtable/blocks/ui';
+ * import {useCursor, useWatchable} from '@airtable/blocks/ui';
  *
  *  function ActiveTableAndView() {
- *      // re-render whenever the active table or view changes
- *      useWatchable(cursor, ['activeTableId', 'activeViewId']);
+ *      const cursor = useCursor();
  *
  *      return (
  *          <div>
@@ -56,10 +54,10 @@ interface CursorData {
  * ```
  *
  * ```js
- * import {cursor} from '@airtable/blocks';
- * import {useLoadable, useWatchable} from '@airtable/blocks/ui';
+ * import {useCursor, useLoadable, useWatchable} from '@airtable/blocks/ui';
  *
  *  function SelectedRecordAndFieldIds() {
+ *      const cursor = useCursor();
  *      // load selected records and fields
  *      useLoadable(cursor);
  *

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"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"}

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

@@ -1,7 +1,7 @@
 /** @module @airtable/blocks/models: Field */ /** */
 import { AggregatorKey } from '../types/aggregators';
 import { PermissionCheckResult } from '../types/mutations';
-import { FieldData, FieldType, FieldOptions } from '../types/field';
+import { FieldData, FieldType, FieldOptions, FieldConfig } from '../types/field';
 import { ObjectValues } from '../private_utils';
 import AbstractModel from './abstract_model';
 import { Aggregator } from './create_aggregators';
@@ -72,6 +72,22 @@ declare class Field extends AbstractModel<FieldData, WatchableFieldKey> {
      * ```
      */
     get options(): FieldOptions | null;
+    /**
+     * The type and options of the field to make type narrowing `FieldOptions` easier.
+     *
+     * @see {@link FieldConfig}
+     * @example
+     * const fieldConfig = field.config;
+     * if (fieldConfig.type === FieldType.SINGLE_SELECT) {
+     *     return fieldConfig.options.choices;
+     * } else if (fieldConfig.type === FieldType.MULTIPLE_LOOKUP_VALUES && fieldConfig.options.isValid) {
+     *     if (fieldConfig.options.result.type === FieldType.SINGLE_SELECT) {
+     *         return fieldConfig.options.result.options.choices;
+     *     }
+     * }
+     * return DEFAULT_CHOICES;
+     */
+    get config(): FieldConfig;
     /**
      * _Beta feature with unstable API. May have breaking changes before release._
      *

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,EAAC,MAAM,gBAAgB,CAAC;AAClE,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;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,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"}

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

@@ -0,0 +1,61 @@
+/** @module @airtable/blocks/models: RecordQueryResult */ /** */
+import { FieldId } from '../types/field';
+import { FlowAnyFunction, FlowAnyObject } from '../private_utils';
+import { RecordId } from '../types/record';
+import { GroupData } from '../types/view';
+import { NormalizedGroupLevel } from '../types/airtable_interface';
+import RecordQueryResult, { WatchableRecordQueryResultKey } from './record_query_result';
+import Field from './field';
+/** @hidden */
+interface GroupedRecordQueryResultData {
+    groupData: GroupData;
+    groupLevels: Array<NormalizedGroupLevel>;
+}
+/**
+ * Represents a group of records returned from a group query. See {@link RecordQueryResult} for main
+ * documentation.
+ *
+ * Do not instantiate. You can get instances of this class by calling
+ * `recordQueryResult.groups`.
+ *
+ * @docsPath models/query results/GroupedRecordQueryResult
+ * @hidden
+ */
+declare class GroupedRecordQueryResult extends RecordQueryResult<GroupedRecordQueryResultData> {
+    _orderedRecordIds: Array<RecordId> | null;
+    /**
+     * Gets children groups of this group (if any exist)
+     */
+    get groups(): Array<GroupedRecordQueryResult> | null;
+    /**
+     * Gets the fieldId that this group is grouped by
+     */
+    get fieldId(): FieldId;
+    /**
+     * Gets the field that this group is grouped by
+     */
+    get field(): Field;
+    /**
+     * Ordered array of all the record ids inside this group, in group order.
+     * This returns all recordIds of all children groups (in grouped order).
+     * Watchable.
+     */
+    get recordIds(): Array<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.
+     * Null if fields were not specified, which means the RecordQueryResult
+     * will load all fields in the table.
+     */
+    get fields(): Array<Field> | null;
+    /** @inheritdoc */
+    watch(keys: WatchableRecordQueryResultKey | ReadonlyArray<WatchableRecordQueryResultKey>, callback: FlowAnyFunction, context?: FlowAnyObject | null): Array<WatchableRecordQueryResultKey>;
+    /** @inheritdoc */
+    unwatch(keys: WatchableRecordQueryResultKey | ReadonlyArray<WatchableRecordQueryResultKey>, callback: FlowAnyFunction, context?: FlowAnyObject | null): Array<WatchableRecordQueryResultKey>;
+    /** @inheritdoc */
+    loadDataAsync(): Promise<void>;
+    /** @inheritdoc */
+    get isDataLoaded(): boolean;
+}
+export default GroupedRecordQueryResult;
+//# sourceMappingURL=grouped_record_query_result.d.ts.map

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

@@ -0,0 +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"}

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

@@ -1,7 +1,7 @@
 /** @ignore */ /** */
 import * as recordColoring from './record_coloring';
 import createAggregators from './create_aggregators';
-export { FieldType } from '../types/field';
+export { FieldType, FieldConfig } from '../types/field';
 export { ViewType } from '../types/view';
 export { default as Base } from './base';
 export { default as Table } from './table';
@@ -10,8 +10,11 @@ export { default as View } from './view';
 export { default as Record } from './record';
 export { default as RecordQueryResult } from './record_query_result';
 export { default as TableOrViewQueryResult } from './table_or_view_query_result';
+export { default as GroupedRecordQueryResult } from './grouped_record_query_result';
 export { default as LinkedRecordsQueryResult } from './linked_records_query_result';
 export { default as ViewMetadataQueryResult } from './view_metadata_query_result';
+export { default as Session } from './session';
+export { default as Cursor } from './cursor';
 export { recordColoring };
 export declare var aggregators: ReturnType<typeof createAggregators>;
 //# sourceMappingURL=models.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../../src/models/models.ts"],"names":[],"mappings":"AACA,cAAc,CAAC,MAAM;AACrB,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAC;AACpD,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AACvC,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,SAAS,CAAC;AACzC,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,SAAS,CAAC;AACzC,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAC,OAAO,IAAI,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAC,OAAO,IAAI,wBAAwB,EAAC,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAC,OAAO,IAAI,uBAAuB,EAAC,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAC,cAAc,EAAC,CAAC;AAIxB,MAAM,CAAC,OAAO,CAAC,IAAI,WAAW,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../../src/models/models.ts"],"names":[],"mappings":"AACA,cAAc,CAAC,MAAM;AACrB,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAC;AACpD,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAC,SAAS,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AACvC,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,SAAS,CAAC;AACzC,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,SAAS,CAAC;AACzC,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAC,OAAO,IAAI,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAC,OAAO,IAAI,wBAAwB,EAAC,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAC,OAAO,IAAI,wBAAwB,EAAC,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAC,OAAO,IAAI,uBAAuB,EAAC,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAC,OAAO,IAAI,OAAO,EAAC,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAC,cAAc,EAAC,CAAC;AAIxB,MAAM,CAAC,OAAO,CAAC,IAAI,WAAW,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,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":"AA4nBA,eAAe,SAAS,CAAC"}
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../../src/models/mutations.ts"],"names":[],"mappings":"AAopBA,eAAe,SAAS,CAAC"}

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

@@ -6,7 +6,6 @@ import { ViewId } from '../types/view';
 import { ObjectValues } from '../private_utils';
 import AbstractModel from './abstract_model';
 import Field from './field';
-import ObjectPool from './object_pool';
 import View from './view';
 import { RecordQueryResultOpts } from './record_query_result';
 import LinkedRecordsQueryResult from './linked_records_query_result';
@@ -33,7 +32,6 @@ declare type WatchableRecordKey = ObjectValues<typeof WatchableRecordKeys> | str
  * @docsPath models/Record
  */
 declare class Record extends AbstractModel<RecordData, WatchableRecordKey> {
-    __linkedRecordsQueryResultPool: ObjectPool<LinkedRecordsQueryResult, typeof LinkedRecordsQueryResult>;
     /**
      * Gets the cell value of the given field for this record.
      *

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;AAC5B,OAAO,UAAU,MAAM,eAAe,CAAC;AAEvC,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;IAe9D,8BAA8B,EAAE,UAAU,CACtC,wBAAwB,EACxB,OAAO,wBAAwB,CAClC,CAAC;IAmFF;;;;;;;;;;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;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"}

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

@@ -12,6 +12,8 @@ declare const WatchableRecordQueryResultKeys: Readonly<{
     recordIds: "recordIds";
     cellValues: "cellValues";
     recordColors: "recordColors";
+    groups: "groups";
+    groupLevels: "groupLevels";
     isDataLoaded: "isDataLoaded";
 }>;
 /**
@@ -36,6 +38,26 @@ export interface NormalizedSortConfig {
     fieldId: string;
     direction: 'asc' | 'desc';
 }
+/**
+ * NormalizedGroupLevel is in airtable_interface
+ *
+ * @hidden
+ */
+export interface GroupLevelForUpdate {
+    /** A field, field id, or field name. */
+    field: Field | FieldId | string;
+    /** The order to sort this group in. Defaults to asc. */
+    direction?: 'asc' | 'desc' | undefined;
+}
+/**
+ * View Config that can be set by developer
+ *
+ * @hidden
+ */
+export interface ViewMetadataForUpdate {
+    /** Groups config that can be set by developer; null will clear it, undefined will skip it*/
+    groupLevels?: Array<GroupLevelForUpdate> | null | undefined;
+}
 /**
  * Used to control what data is loaded in a {@link RecordQueryResult}. Used when creating a
  * query result using `table/view.selectRecords()` and in convenience hooks {@link useRecords}.

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

@@ -1 +1 @@
-{"version":3,"file":"record_query_result.d.ts","sourceRoot":"","sources":["../../../../src/models/record_query_result.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"record_query_result.d.ts","sourceRoot":"","sources":["../../../../src/models/record_query_result.ts"],"names":[],"mappings":"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"}

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

@@ -24,12 +24,16 @@ declare type WatchableSessionKey = ObjectValues<typeof WatchableSessionKeys>;
  *
  * @example
  * ```js
- * import {session} from '@airtable/blocks';
+ * import {useSession} from '@airtable/blocks/ui';
  *
- * if (session.currentUser !== null) {
- *     console.log("The current user's name is", session.currentUser.name);
- * } else {
- *     console.log('This app is being viewed in a public share');
+ * function Username() {
+ *     const session = useSession();
+ *
+ *     if (session.currentUser !== null) {
+ *         return <span>The current user's name is {session.currentUser.name}</span>;
+ *     } else {
+ *         return <span>This app is being viewed in a public share</span>;
+ *     }
  * }
  * ```
  * @docsPath models/Session
@@ -40,11 +44,20 @@ declare class Session extends AbstractModel<SessionData, WatchableSessionKey> {
      *
      * @example
      * ```js
-     * import {session} from '@airtable/blocks';
-     * if (session.currentUser) {
-     *     console.log(session.currentUser.id);
-     *     console.log(session.currentUser.email);
-     *     console.log(session.currentUser.name);
+     * import {useSession} from '@airtable/blocks/ui';
+     *
+     * function CurrentUser() {
+     *     const session = useSession();
+     *
+     *     if (!session.currentUser) {
+     *         return <div>This app is being used in a public share.</div>;
+     *     }
+     *
+     *     return <ul>
+     *         <li>ID: {session.currentUser.id}</li>
+     *         <li>E-mail: {session.currentUser.email}</li>
+     *         <li>Name: {session.currentUser.name}</li>
+     *     </ul>;
      * }
      * ```
      */
@@ -59,11 +72,21 @@ declare class Session extends AbstractModel<SessionData, WatchableSessionKey> {
      *
      * @example
      * ```js
-     * import {session} from '@airtable/blocks';
+     * import {useSession} from '@airtable/blocks/ui';
      *
-     * const updateRecordsCheckResult = session.checkPermissionsForUpdateRecords();
-     * if (!updateRecordsCheckResult.hasPermission) {
-     *     alert(updateRecordsCheckResult.reasonDisplayString);
+     * function UpdateButton({onClick}) {
+     *     const session = useSession();
+     *     const updateRecordsCheckResult = session.checkPermissionsForUpdateRecords();
+     *     const deniedReason = updateRecordsCheckResult.hasPermission
+     *         ? <span>{updateRecordsCheckResult.reasonDisplayString}</span>
+     *         : null;
+     *
+     *     return <div>
+     *         {deniedReason}
+     *         <button onClick={onClick} disabled={!!deniedReason}>
+     *             Update
+     *         </button>
+     *     </div>;
      * }
      */
     checkPermissionsForUpdateRecords(): PermissionCheckResult;
@@ -82,11 +105,21 @@ declare class Session extends AbstractModel<SessionData, WatchableSessionKey> {
      *
      * @example
      * ```js
-     * import {session} from '@airtable/blocks';
+     * import {useSession} from '@airtable/blocks/ui';
+     *
+     * function CreateButton({onClick}) {
+     *     const session = useSession();
+     *     const updateRecordsCheckResult = session.checkPermissionsForCreateRecords();
+     *     const deniedReason = updateRecordsCheckResult.hasPermission
+     *         ? <span>{updateRecordsCheckResult.reasonDisplayString}</span>
+     *         : null;
      *
-     * const createRecordsCheckResult = session.checkPermissionsForCreateRecords();
-     * if (!createRecordsCheckResult.hasPermission) {
-     *     alert(createRecordsCheckResult.reasonDisplayString);
+     *     return <div>
+     *         {deniedReason}
+     *         <button onClick={onClick} disabled={!!deniedReason}>
+     *             Create
+     *         </button>
+     *     </div>;
      * }
      */
     checkPermissionsForCreateRecords(): PermissionCheckResult;
@@ -105,12 +138,21 @@ declare class Session extends AbstractModel<SessionData, WatchableSessionKey> {
      *
      * @example
      * ```js
-     * import {session} from '@airtable/blocks';
+     * import {useSession} from '@airtable/blocks/ui';
      *
-     * const deleteRecordsCheckResult = session.checkPermissionsForDeleteRecords();
-     * if (!deleteRecordsCheckResult.hasPermission) {
-     *     alert(deleteRecordsCheckResult.reasonDisplayString);
-     * }
+     * function DeleteButton({onClick}) {
+     *     const session = useSession();
+     *     const updateRecordsCheckResult = session.checkPermissionsForDeleteRecords();
+     *     const deniedReason = updateRecordsCheckResult.hasPermission
+     *         ? <span>{updateRecordsCheckResult.reasonDisplayString}</span>
+     *         : null;
+     *
+     *     return <div>
+     *         {deniedReason}
+     *         <button onClick={onClick} disabled={!!deniedReason}>
+     *             Delete
+     *         </button>
+     *     </div>;
      */
     checkPermissionsForDeleteRecords(): PermissionCheckResult;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/models/session.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,gBAAgB,EAAE,MAAM,EAAC,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAuB,YAAY,EAAY,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAC,qBAAqB,EAAgB,MAAM,oBAAoB,CAAC;AACxE,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAE7C,cAAc;AACd,UAAU,WAAW;IAEjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC;IACjC,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,QAAA,MAAM,oBAAoB;;;EAKxB,CAAC;AAEH;;;;GAIG;AACH,aAAK,mBAAmB,GAAG,YAAY,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAErE;;;;;;;;;;;;;;GAcG;AACH,cAAM,OAAQ,SAAQ,aAAa,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAwCjE;;;;;;;;;;;;OAYG;IACH,IAAI,WAAW,IAAI,gBAAgB,GAAG,IAAI,CAQzC;IACD;;;;;;;;;;;;;;;;OAgBG;IACH,gCAAgC,IAAI,qBAAqB;IAOzD;;;OAGG;IACH,4BAA4B,IAAI,OAAO;IAGvC;;;;;;;;;;;;;;;;OAgBG;IACH,gCAAgC,IAAI,qBAAqB;IAOzD;;;OAGG;IACH,4BAA4B,IAAI,OAAO;IAGvC;;;;;;;;;;;;;;;;OAgBG;IACH,gCAAgC,IAAI,qBAAqB;IAOzD;;;OAGG;IACH,4BAA4B,IAAI,OAAO;CAiE1C;AAED,eAAe,OAAO,CAAC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/models/session.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,gBAAgB,EAAE,MAAM,EAAC,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAuB,YAAY,EAAY,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAC,qBAAqB,EAAgB,MAAM,oBAAoB,CAAC;AACxE,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAE7C,cAAc;AACd,UAAU,WAAW;IAEjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC;IACjC,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,QAAA,MAAM,oBAAoB;;;EAKxB,CAAC;AAEH;;;;GAIG;AACH,aAAK,mBAAmB,GAAG,YAAY,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAErE;;;;;;;;;;;;;;;;;;GAkBG;AACH,cAAM,OAAQ,SAAQ,aAAa,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAwCjE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,WAAW,IAAI,gBAAgB,GAAG,IAAI,CAQzC;IACD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,gCAAgC,IAAI,qBAAqB;IAOzD;;;OAGG;IACH,4BAA4B,IAAI,OAAO;IAGvC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,gCAAgC,IAAI,qBAAqB;IAOzD;;;OAGG;IACH,4BAA4B,IAAI,OAAO;IAGvC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,gCAAgC,IAAI,qBAAqB;IAOzD;;;OAGG;IACH,4BAA4B,IAAI,OAAO;CAiE1C;AAED,eAAe,OAAO,CAAC"}