@airtable/blocks 0.0.0-experimental-f52bc4e5e-20250709 → 0.0.0-experimental-75d011284-20250904

package/dist/cjs/base/models/record.js

@@ -1,25 +1,9 @@
 "use strict";
 
-require("core-js/modules/es.symbol.js");
-require("core-js/modules/es.array.filter.js");
-require("core-js/modules/es.object.get-own-property-descriptors.js");
-require("core-js/modules/es.object.to-string.js");
-require("core-js/modules/web.dom-collections.for-each.js");
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-require("core-js/modules/es.string.starts-with.js");
-var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
-var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
-var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
-var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
-var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime/helpers/possibleConstructorReturn"));
-var _get2 = _interopRequireDefault(require("@babel/runtime/helpers/get"));
-var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime/helpers/getPrototypeOf"));
-var _inherits2 = _interopRequireDefault(require("@babel/runtime/helpers/inherits"));
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _record_core = require("../../shared/models/record_core");
 var _private_utils = require("../../shared/private_utils");
 var _error_utils = require("../../shared/error_utils");
@@ -27,19 +11,19 @@ var _color_utils = _interopRequireDefault(require("../../shared/color_utils"));
 var _linked_records_query_result = _interopRequireDefault(require("./linked_records_query_result"));
 var _object_pool = _interopRequireDefault(require("./object_pool"));
 var _record_query_result = _interopRequireDefault(require("./record_query_result"));
-function _callSuper(t, o, e) { return o = (0, _getPrototypeOf2.default)(o), (0, _possibleConstructorReturn2.default)(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], (0, _getPrototypeOf2.default)(t).constructor) : o.apply(t, e)); }
-function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
-function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; } /** @module @airtable/blocks/models: Record */ /** */
-var WatchableRecordKeys = Object.freeze(_objectSpread(_objectSpread({}, _record_core.WatchableRecordKeysCore), {}, {
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/** @module @airtable/blocks/models: Record */ /** */
+
+const WatchableRecordKeys = Object.freeze({
+  ..._record_core.WatchableRecordKeysCore,
   commentCount: 'commentCount'
-}));
+});
 // TODO: load cell values in field when this is watched? This will
 // cause the CellRenderer component to load cell values, which seems okay,
 // but needs a little more thought.
-var WatchableCellValueInFieldKeyPrefix = 'cellValueInField:';
+const WatchableCellValueInFieldKeyPrefix = 'cellValueInField:';
 // TODO: load view data when this is watched. see previous comment.
-var WatchableColorInViewKeyPrefix = 'colorInView:';
+const WatchableColorInViewKeyPrefix = 'colorInView:';
 /**
  * Any key within record that can be watched:
  * - `'name'`
@@ -48,6 +32,7 @@ var WatchableColorInViewKeyPrefix = 'colorInView:';
  * - `'cellValueInField:' + someFieldId`
  * - `'colorInView:' + someViewId`
  */
+
 /**
  * Model class representing a record in a table.
  *
@@ -56,249 +41,199 @@ var WatchableColorInViewKeyPrefix = 'colorInView:';
  *
  * @docsPath models/Record
  */
-var Record = /*#__PURE__*/function (_RecordCore) {
+class Record extends _record_core.RecordCore {
+  /** @internal */
+  static _className = 'Record';
+  /** @internal */
+  static _isWatchableKey(key) {
+    return (0, _private_utils.isEnumValue)(WatchableRecordKeys, key) || key.startsWith(WatchableCellValueInFieldKeyPrefix) || key.startsWith(WatchableColorInViewKeyPrefix);
+  }
+  /** @internal */
+
   /**
    * @internal
    */
-  function Record(sdk, parentRecordStore, parentTable, recordId) {
-    var _this;
-    (0, _classCallCheck2.default)(this, Record);
-    _this = _callSuper(this, Record, [sdk, parentRecordStore, parentTable, recordId]);
-    /** @internal */
-    (0, _defineProperty2.default)(_this, "__linkedRecordsQueryResultPool", void 0);
-    _this.__linkedRecordsQueryResultPool = new _object_pool.default(_linked_records_query_result.default);
-    return _this;
+  constructor(sdk, parentRecordStore, parentTable, recordId) {
+    super(sdk, parentRecordStore, parentTable, recordId);
+    this.__linkedRecordsQueryResultPool = new _object_pool.default(_linked_records_query_result.default);
   }
   /**
    * @internal
    */
-  (0, _inherits2.default)(Record, _RecordCore);
-  return (0, _createClass2.default)(Record, [{
-    key: "_getViewMatching",
-    value: function _getViewMatching(viewOrViewIdOrViewName) {
-      return this.parentTable.__getViewMatching(viewOrViewIdOrViewName);
-    }
+  _getViewMatching(viewOrViewIdOrViewName) {
+    return this.parentTable.__getViewMatching(viewOrViewIdOrViewName);
+  }
 
-    /**
-     * Gets the cell value of the given field for this record, formatted as a `string`.
-     *
-     * @param fieldOrFieldIdOrFieldName The field (or field ID or field name) whose cell value you'd like to get.
-     * @example
-     * ```js
-     * const stringValue = myRecord.getCellValueAsString(myNumberField);
-     * console.log(stringValue);
-     * // => '42'
-     * ```
-     */
-  }, {
-    key: "getCellValueAsString",
-    value: function getCellValueAsString(fieldOrFieldIdOrFieldName) {
-      var field = this._getFieldMatching(fieldOrFieldIdOrFieldName);
-      (0, _error_utils.invariant)(this._parentRecordStore.areCellValuesLoadedForFieldId(field.id), 'Cell values for field %s are not loaded', field.id);
-      return (0, _get2.default)((0, _getPrototypeOf2.default)(Record.prototype), "getCellValueAsString", this).call(this, field.id);
-    }
-  }, {
-    key: "_getRawCellValue",
-    value: function _getRawCellValue(field) {
-      (0, _error_utils.invariant)(this._parentRecordStore.areCellValuesLoadedForFieldId(field.id), 'Cell values for field %s are not loaded', field.id);
-      return (0, _get2.default)((0, _getPrototypeOf2.default)(Record.prototype), "_getRawCellValue", this).call(this, field);
-    }
+  /**
+   * Gets the cell value of the given field for this record, formatted as a `string`.
+   *
+   * @param fieldOrFieldIdOrFieldName The field (or field ID or field name) whose cell value you'd like to get.
+   * @example
+   * ```js
+   * const stringValue = myRecord.getCellValueAsString(myNumberField);
+   * console.log(stringValue);
+   * // => '42'
+   * ```
+   */
+  getCellValueAsString(fieldOrFieldIdOrFieldName) {
+    const field = this._getFieldMatching(fieldOrFieldIdOrFieldName);
+    (0, _error_utils.invariant)(this._parentRecordStore.areCellValuesLoadedForFieldId(field.id), 'Cell values for field %s are not loaded', field.id);
+    return super.getCellValueAsString(field.id);
+  }
+  _getRawCellValue(field) {
+    (0, _error_utils.invariant)(this._parentRecordStore.areCellValuesLoadedForFieldId(field.id), 'Cell values for field %s are not loaded', field.id);
+    return super._getRawCellValue(field);
+  }
 
-    /**
-     * Returns a URL that is suitable for rendering an attachment on the current client.
-     * The URL that is returned will only work for the current user.
-     *
-     * @param attachmentId The ID of the attachment.
-     * @param attachmentUrl The attachment's URL (which is not suitable for rendering on the client).
-     * @example
-     * ```js
-     * import React from 'react';
-     *
-     * function RecordAttachments(props) {
-     *     const {record, attachmentField} = props;
-     *     const attachmentCellValue = record.getCellValue(attachmentField);
-     *     if (attachmentCellValue === null) {
-     *         return null;
-     *     }
-     *     return (
-     *         <div>
-     *             {attachmentCellValue.map(attachmentObj => {
-     *                 const clientUrl =
-     *                     record.getAttachmentClientUrlFromCellValueUrl(
-     *                         attachmentObj.id,
-     *                         attachmentObj.url
-     *                     );
-     *                 return (
-     *                     <img key={attachmentObj.id} src={clientUrl} width={200} />
-     *                 );
-     *             })}
-     *         </div>
-     *     );
-     * }
-     * ```
-     */
-  }, {
-    key: "getAttachmentClientUrlFromCellValueUrl",
-    value: function getAttachmentClientUrlFromCellValueUrl(attachmentId, attachmentUrl) {
-      var airtableInterface = this._sdk.__airtableInterface;
-      var appInterface = this._sdk.__appInterface;
-      return airtableInterface.urlConstructor.getAttachmentClientUrl(appInterface, attachmentId, attachmentUrl);
-    }
-    /**
-     * Gets the color of this record in a given view, or null if the record has no color in that
-     * view.
-     *
-     * Can be watched with the 'colorInView:${ViewId}' key.
-     *
-     * @param viewOrViewIdOrViewName The view (or view ID or view name) to use for record coloring.
-     */
-  }, {
-    key: "getColorInView",
-    value: function getColorInView(viewOrViewIdOrViewName) {
-      var view = this._getViewMatching(viewOrViewIdOrViewName);
-      return this._parentRecordStore.getViewDataStore(view.id).getRecordColor(this);
-    }
-    /**
-     * Gets the CSS hex string for this record in a given view, or null if the record has no color
-     * in that view.
-     *
-     * Can be watched with the 'colorInView:${ViewId}' key.
-     *
-     * @param viewOrViewIdOrViewName The view (or view ID or view name) to use for record coloring.
-     */
-  }, {
-    key: "getColorHexInView",
-    value: function getColorHexInView(viewOrViewIdOrViewName) {
-      var color = this.getColorInView(viewOrViewIdOrViewName);
-      if (!color) {
-        return null;
-      }
-      return _color_utils.default.getHexForColor(color);
-    }
-    /**
-     * Select records referenced in a `multipleRecordLinks` cell value. Returns a query result
-     * containing the records in the given `multipleRecordLinks` field.
-     * See {@link RecordQueryResult} for more.
-     *
-     * @param fieldOrFieldIdOrFieldName The `multipleRecordLinks` field (or field ID or field name) to use.
-     * @param opts Options for the query, such as sorts and fields.
-     */
-  }, {
-    key: "selectLinkedRecordsFromCell",
-    value: function selectLinkedRecordsFromCell(fieldOrFieldIdOrFieldName) {
-      var opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-      var field = this._getFieldMatching(fieldOrFieldIdOrFieldName);
-      var linkedTableId = field.options && field.options.linkedTableId;
-      (0, _error_utils.invariant)(typeof linkedTableId === 'string', 'linkedTableId must be set');
-      var linkedTable = this._sdk.base.getTableById(linkedTableId);
-      var linkedRecordStore = this._sdk.base.__getRecordStore(linkedTableId);
-      var normalizedOpts = _record_query_result.default._normalizeOpts(linkedTable, linkedRecordStore, opts);
-      return this.__linkedRecordsQueryResultPool.getObjectForReuse(this, field, normalizedOpts, this._sdk);
-    }
-    /**
-     * Select and load records referenced in a `multipleRecordLinks` cell value. Returns a query result
-     * promise containing the records in the given `multipleRecordLinks` field.
-     * See {@link RecordQueryResult} for more.
-     *
-     * Remember to call `queryResult.unloadData` once you're finished with the query.
-     *
-     * @param fieldOrFieldIdOrFieldName The `multipleRecordLinks` field (or field ID or field name) to use.
-     * @param opts Options for the query, such as sorts and fields.
-     */
-  }, {
-    key: "selectLinkedRecordsFromCellAsync",
-    value: (function () {
-      var _selectLinkedRecordsFromCellAsync = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(fieldOrFieldIdOrFieldName) {
-        var opts,
-          queryResult,
-          _args = arguments;
-        return _regenerator.default.wrap(function _callee$(_context) {
-          while (1) switch (_context.prev = _context.next) {
-            case 0:
-              opts = _args.length > 1 && _args[1] !== undefined ? _args[1] : {};
-              queryResult = this.selectLinkedRecordsFromCell(fieldOrFieldIdOrFieldName, opts);
-              _context.next = 4;
-              return queryResult.loadDataAsync();
-            case 4:
-              return _context.abrupt("return", queryResult);
-            case 5:
-            case "end":
-              return _context.stop();
-          }
-        }, _callee, this);
-      }));
-      function selectLinkedRecordsFromCellAsync(_x) {
-        return _selectLinkedRecordsFromCellAsync.apply(this, arguments);
-      }
-      return selectLinkedRecordsFromCellAsync;
-    }()
-    /**
-     * The URL for the record. You can visit this URL in the browser to be taken to the record in the Airtable UI.
-     *
-     * @example
-     * ```js
-     * console.log(myRecord.url);
-     * // => 'https://airtable.com/appxxxxxxxxxxxxxx/tblxxxxxxxxxxxxxx/recxxxxxxxxxxxxxx'
-     * ```
-     */
-    )
-  }, {
-    key: "url",
-    get: function get() {
-      return this._sdk.__airtableInterface.urlConstructor.getRecordUrl(this.id, this.parentTable.id);
-    }
-    /**
-     * The number of comments on this record.
-     *
-     * @example
-     * ```js
-     * const commentCount = myRecord.commentCount;
-     * const isSingular = commentCount === 1;
-     * console.log(
-     *     `This record has ${commentCount} comment${isSingular ? '' : 's'}`
-     * );
-     * ```
-     */
-  }, {
-    key: "commentCount",
-    get: function get() {
-      return this._data.commentCount;
+  /**
+   * Returns a URL that is suitable for rendering an attachment on the current client.
+   * The URL that is returned will only work for the current user.
+   *
+   * @param attachmentId The ID of the attachment.
+   * @param attachmentUrl The attachment's URL (which is not suitable for rendering on the client).
+   * @example
+   * ```js
+   * import React from 'react';
+   *
+   * function RecordAttachments(props) {
+   *     const {record, attachmentField} = props;
+   *     const attachmentCellValue = record.getCellValue(attachmentField);
+   *     if (attachmentCellValue === null) {
+   *         return null;
+   *     }
+   *     return (
+   *         <div>
+   *             {attachmentCellValue.map(attachmentObj => {
+   *                 const clientUrl =
+   *                     record.getAttachmentClientUrlFromCellValueUrl(
+   *                         attachmentObj.id,
+   *                         attachmentObj.url
+   *                     );
+   *                 return (
+   *                     <img key={attachmentObj.id} src={clientUrl} width={200} />
+   *                 );
+   *             })}
+   *         </div>
+   *     );
+   * }
+   * ```
+   */
+  getAttachmentClientUrlFromCellValueUrl(attachmentId, attachmentUrl) {
+    const airtableInterface = this._sdk.__airtableInterface;
+    const appInterface = this._sdk.__appInterface;
+    return airtableInterface.urlConstructor.getAttachmentClientUrl(appInterface, attachmentId, attachmentUrl);
+  }
+  /**
+   * Gets the color of this record in a given view, or null if the record has no color in that
+   * view.
+   *
+   * Can be watched with the 'colorInView:${ViewId}' key.
+   *
+   * @param viewOrViewIdOrViewName The view (or view ID or view name) to use for record coloring.
+   */
+  getColorInView(viewOrViewIdOrViewName) {
+    const view = this._getViewMatching(viewOrViewIdOrViewName);
+    return this._parentRecordStore.getViewDataStore(view.id).getRecordColor(this);
+  }
+  /**
+   * Gets the CSS hex string for this record in a given view, or null if the record has no color
+   * in that view.
+   *
+   * Can be watched with the 'colorInView:${ViewId}' key.
+   *
+   * @param viewOrViewIdOrViewName The view (or view ID or view name) to use for record coloring.
+   */
+  getColorHexInView(viewOrViewIdOrViewName) {
+    const color = this.getColorInView(viewOrViewIdOrViewName);
+    if (!color) {
+      return null;
     }
-    /**
-     * @internal
-     */
-  }, {
-    key: "__triggerOnChangeForDirtyPaths",
-    value: function __triggerOnChangeForDirtyPaths(dirtyPaths) {
-      (0, _get2.default)((0, _getPrototypeOf2.default)(Record.prototype), "__triggerOnChangeForDirtyPaths", this).call(this, dirtyPaths);
-      var cellValuesByFieldId = dirtyPaths.cellValuesByFieldId,
-        commentCount = dirtyPaths.commentCount;
-      if (cellValuesByFieldId && !(0, _private_utils.isObjectEmpty)(cellValuesByFieldId)) {
-        for (var _i = 0, _Object$keys = Object.keys(cellValuesByFieldId); _i < _Object$keys.length; _i++) {
-          var fieldId = _Object$keys[_i];
-          this._onChange(WatchableCellValueInFieldKeyPrefix + fieldId, fieldId);
-        }
-      }
-      if (commentCount) {
-        this._onChange(WatchableRecordKeys.commentCount);
+    return _color_utils.default.getHexForColor(color);
+  }
+  /**
+   * Select records referenced in a `multipleRecordLinks` cell value. Returns a query result
+   * containing the records in the given `multipleRecordLinks` field.
+   * See {@link RecordQueryResult} for more.
+   *
+   * @param fieldOrFieldIdOrFieldName The `multipleRecordLinks` field (or field ID or field name) to use.
+   * @param opts Options for the query, such as sorts and fields.
+   */
+  selectLinkedRecordsFromCell(fieldOrFieldIdOrFieldName) {
+    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    const field = this._getFieldMatching(fieldOrFieldIdOrFieldName);
+    const linkedTableId = field.options && field.options.linkedTableId;
+    (0, _error_utils.invariant)(typeof linkedTableId === 'string', 'linkedTableId must be set');
+    const linkedTable = this._sdk.base.getTableById(linkedTableId);
+    const linkedRecordStore = this._sdk.base.__getRecordStore(linkedTableId);
+    const normalizedOpts = _record_query_result.default._normalizeOpts(linkedTable, linkedRecordStore, opts);
+    return this.__linkedRecordsQueryResultPool.getObjectForReuse(this, field, normalizedOpts, this._sdk);
+  }
+  /**
+   * Select and load records referenced in a `multipleRecordLinks` cell value. Returns a query result
+   * promise containing the records in the given `multipleRecordLinks` field.
+   * See {@link RecordQueryResult} for more.
+   *
+   * Remember to call `queryResult.unloadData` once you're finished with the query.
+   *
+   * @param fieldOrFieldIdOrFieldName The `multipleRecordLinks` field (or field ID or field name) to use.
+   * @param opts Options for the query, such as sorts and fields.
+   */
+  async selectLinkedRecordsFromCellAsync(fieldOrFieldIdOrFieldName) {
+    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    const queryResult = this.selectLinkedRecordsFromCell(fieldOrFieldIdOrFieldName, opts);
+    await queryResult.loadDataAsync();
+    return queryResult;
+  }
+  /**
+   * The URL for the record. You can visit this URL in the browser to be taken to the record in the Airtable UI.
+   *
+   * @example
+   * ```js
+   * console.log(myRecord.url);
+   * // => 'https://airtable.com/appxxxxxxxxxxxxxx/tblxxxxxxxxxxxxxx/recxxxxxxxxxxxxxx'
+   * ```
+   */
+  get url() {
+    return this._sdk.__airtableInterface.urlConstructor.getRecordUrl(this.id, this.parentTable.id);
+  }
+  /**
+   * The number of comments on this record.
+   *
+   * @example
+   * ```js
+   * const commentCount = myRecord.commentCount;
+   * const isSingular = commentCount === 1;
+   * console.log(
+   *     `This record has ${commentCount} comment${isSingular ? '' : 's'}`
+   * );
+   * ```
+   */
+  get commentCount() {
+    return this._data.commentCount;
+  }
+  /**
+   * @internal
+   */
+  __triggerOnChangeForDirtyPaths(dirtyPaths) {
+    super.__triggerOnChangeForDirtyPaths(dirtyPaths);
+    const {
+      cellValuesByFieldId,
+      commentCount
+    } = dirtyPaths;
+    if (cellValuesByFieldId && !(0, _private_utils.isObjectEmpty)(cellValuesByFieldId)) {
+      for (const fieldId of Object.keys(cellValuesByFieldId)) {
+        this._onChange(WatchableCellValueInFieldKeyPrefix + fieldId, fieldId);
       }
     }
-    /**
-     * @internal
-     */
-  }, {
-    key: "__triggerOnChangeForRecordColorInViewId",
-    value: function __triggerOnChangeForRecordColorInViewId(viewId) {
-      this._onChange(WatchableColorInViewKeyPrefix + viewId);
+    if (commentCount) {
+      this._onChange(WatchableRecordKeys.commentCount);
     }
-  }], [{
-    key: "_isWatchableKey",
-    value: /** @internal */
-    function _isWatchableKey(key) {
-      return (0, _private_utils.isEnumValue)(WatchableRecordKeys, key) || key.startsWith(WatchableCellValueInFieldKeyPrefix) || key.startsWith(WatchableColorInViewKeyPrefix);
-    }
-  }]);
-}(_record_core.RecordCore);
-/** @internal */
-(0, _defineProperty2.default)(Record, "_className", 'Record');
+  }
+  /**
+   * @internal
+   */
+  __triggerOnChangeForRecordColorInViewId(viewId) {
+    this._onChange(WatchableColorInViewKeyPrefix + viewId);
+  }
+}
 var _default = exports.default = Record;

package/dist/cjs/base/models/record_coloring.js

@@ -13,7 +13,7 @@ exports.serialize = exports.modes = exports.ModeTypes = void 0;
  * @hidden
  * @alias recordColoring.ModeTypes
  */
-var ModeTypes = exports.ModeTypes = {
+const ModeTypes = exports.ModeTypes = {
   /**
    * @alias recordColoring.ModeTypes.NONE
    */
@@ -40,12 +40,12 @@ var ModeTypes = exports.ModeTypes = {
 
 /** */
 
-var serialize = mode => {
-  var result = mode.type;
+const serialize = mode => {
+  let result = mode.type;
   if (mode.type === ModeTypes.BY_SELECT_FIELD) {
-    result += "-".concat(mode.selectField.id);
+    result += `-${mode.selectField.id}`;
   } else if (mode.type === ModeTypes.BY_VIEW) {
-    result += "-".concat(mode.view.id);
+    result += `-${mode.view.id}`;
   }
   return result;
 };
@@ -74,7 +74,7 @@ var serialize = mode => {
  * ```
  */
 exports.serialize = serialize;
-var modes = exports.modes = {
+const modes = exports.modes = {
   /**
    * Returns a {@link RecordColorMode} that represents no record coloring.
    *