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

package/dist/cjs/shared/models/record_core.js

@@ -1,36 +1,16 @@
 "use strict";
 
-require("core-js/modules/es.symbol.js");
-require("core-js/modules/es.symbol.description.js");
-require("core-js/modules/es.array.from.js");
-require("core-js/modules/es.array.iterator.js");
-require("core-js/modules/es.array.slice.js");
-require("core-js/modules/es.object.to-string.js");
-require("core-js/modules/es.regexp.exec.js");
-require("core-js/modules/es.regexp.to-string.js");
-require("core-js/modules/web.dom-collections.iterator.js");
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.WatchableRecordKeysCore = exports.RecordCore = void 0;
-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 _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime/helpers/getPrototypeOf"));
-var _inherits2 = _interopRequireDefault(require("@babel/runtime/helpers/inherits"));
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _private_utils = require("../private_utils");
 var _error_utils = require("../error_utils");
 var _field_core = require("../types/field_core");
 var _abstract_model = _interopRequireDefault(require("./abstract_model"));
 var _field_core2 = require("./field_core");
-function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
-function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
-function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
-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; })(); }
-var WatchableRecordKeysCore = exports.WatchableRecordKeysCore = Object.freeze({
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const WatchableRecordKeysCore = exports.WatchableRecordKeysCore = Object.freeze({
   name: 'name',
   // TODO(kasra): these keys don't have matching getters (not that they should
   // it's just inconsistent...)
@@ -38,235 +18,198 @@ var WatchableRecordKeysCore = exports.WatchableRecordKeysCore = Object.freeze({
 });
 
 /** @hidden */
+
 /** @hidden */
-var RecordCore = exports.RecordCore = /*#__PURE__*/function (_AbstractModel) {
+class RecordCore extends _abstract_model.default {
+  /** @internal */
+  static _className = 'RecordCore';
+  /** @internal */
+  static _isWatchableKey(key) {
+    return (0, _private_utils.isEnumValue)(WatchableRecordKeysCore, key);
+  }
+  /** @internal */
+
+  /** @internal */
+
   /**
    * @internal
    */
-  function RecordCore(sdk, parentRecordStore, parentTable, recordId) {
-    var _this;
-    (0, _classCallCheck2.default)(this, RecordCore);
-    _this = _callSuper(this, RecordCore, [sdk, recordId]);
-    /** @internal */
-    (0, _defineProperty2.default)(_this, "_parentRecordStore", void 0);
-    /** @internal */
-    (0, _defineProperty2.default)(_this, "_parentTable", void 0);
-    _this._parentRecordStore = parentRecordStore;
-    _this._parentTable = parentTable;
-    return _this;
+  constructor(sdk, parentRecordStore, parentTable, recordId) {
+    super(sdk, recordId);
+    this._parentRecordStore = parentRecordStore;
+    this._parentTable = parentTable;
   }
 
   /**
    * @internal
    */
-  (0, _inherits2.default)(RecordCore, _AbstractModel);
-  return (0, _createClass2.default)(RecordCore, [{
-    key: "_dataOrNullIfDeleted",
-    get: function get() {
-      var _recordsById$this$_id;
-      var tableData = this._baseData.tablesById[this.parentTable.id];
-      if (!tableData) {
-        return null;
-      }
-      var recordsById = tableData.recordsById;
-      (0, _error_utils.invariant)(recordsById, 'Record data is not loaded');
-      return (_recordsById$this$_id = recordsById[this._id]) !== null && _recordsById$this$_id !== void 0 ? _recordsById$this$_id : null;
+  get _dataOrNullIfDeleted() {
+    const tableData = this._baseData.tablesById[this.parentTable.id];
+    if (!tableData) {
+      return null;
     }
+    const recordsById = tableData.recordsById;
+    (0, _error_utils.invariant)(recordsById, 'Record data is not loaded');
+    return recordsById[this._id] ?? null;
+  }
 
-    /**
-     * The table that this record belongs to. Should never change because records aren't moved between tables.
-     *
-     * @internal (since we may not be able to return parent model instances in the immutable models world)
-     * @example
-     * ```js
-     * import {useRecords} from '@airtable/blocks/base/ui';
-     * const records = useRecords(myTable);
-     * console.log(records[0].parentTable.id === myTable.id);
-     * // => true
-     * ```
-     */
-  }, {
-    key: "parentTable",
-    get: function get() {
-      return this._parentTable;
-    }
-    /**
-     * @internal
-     */
-  }, {
-    key: "_getFieldMatching",
-    value: function _getFieldMatching(fieldOrFieldIdOrFieldName) {
-      if (fieldOrFieldIdOrFieldName instanceof _field_core2.FieldCore) {
-        return this._parentTable.__getFieldMatching(fieldOrFieldIdOrFieldName.id);
-      }
-      return this.parentTable.__getFieldMatching(fieldOrFieldIdOrFieldName);
+  /**
+   * The table that this record belongs to. Should never change because records aren't moved between tables.
+   *
+   * @internal (since we may not be able to return parent model instances in the immutable models world)
+   * @example
+   * ```js
+   * import {useRecords} from '@airtable/blocks/base/ui';
+   * const records = useRecords(myTable);
+   * console.log(records[0].parentTable.id === myTable.id);
+   * // => true
+   * ```
+   */
+  get parentTable() {
+    return this._parentTable;
+  }
+  /**
+   * @internal
+   */
+  _getFieldMatching(fieldOrFieldIdOrFieldName) {
+    if (fieldOrFieldIdOrFieldName instanceof _field_core2.FieldCore) {
+      return this._parentTable.__getFieldMatching(fieldOrFieldIdOrFieldName.id);
     }
+    return this.parentTable.__getFieldMatching(fieldOrFieldIdOrFieldName);
+  }
 
-    /**
-     * @internal
-     *
-     * For use when we need the raw public API cell value. Specifically makes a difference
-     * for lookup fields, where we translate the format to a blocks-specific format in getCellValue.
-     * That format is incompatible with fieldTypeProvider methods, which expect the public API
-     * format - use _getRawCellValue instead.
-     */
-  }, {
-    key: "_getRawCellValue",
-    value: function _getRawCellValue(field) {
-      var cellValuesByFieldId = this._data.cellValuesByFieldId;
-      if (!cellValuesByFieldId) {
-        return null;
-      }
-      var cellValue = cellValuesByFieldId[field.id] !== undefined ? cellValuesByFieldId[field.id] : null;
-      if (typeof cellValue === 'object' && cellValue !== null) {
-        // Copy non-primitives.
-        // TODO(kasra): maybe freezeDeep instead?
-        return (0, _private_utils.cloneDeep)(cellValue);
-      } else {
-        return cellValue;
-      }
+  /**
+   * @internal
+   *
+   * For use when we need the raw public API cell value. Specifically makes a difference
+   * for lookup fields, where we translate the format to a blocks-specific format in getCellValue.
+   * That format is incompatible with fieldTypeProvider methods, which expect the public API
+   * format - use _getRawCellValue instead.
+   */
+  _getRawCellValue(field) {
+    const {
+      cellValuesByFieldId
+    } = this._data;
+    if (!cellValuesByFieldId) {
+      return null;
     }
-    /**
-     * Gets the cell value of the given field for this record.
-     *
-     * @param fieldOrFieldIdOrFieldName The field (or field ID or field name) whose cell value you'd like to get.
-     * @example
-     * ```js
-     * const cellValue = myRecord.getCellValue(mySingleLineTextField);
-     * console.log(cellValue);
-     * // => 'cell value'
-     * ```
-     */
-  }, {
-    key: "getCellValue",
-    value: function getCellValue(fieldOrFieldIdOrFieldName) {
-      var field = this._getFieldMatching(fieldOrFieldIdOrFieldName);
-      var cellValue = this._getRawCellValue(field);
+    const cellValue = cellValuesByFieldId[field.id] !== undefined ? cellValuesByFieldId[field.id] : null;
+    if (typeof cellValue === 'object' && cellValue !== null) {
+      // Copy non-primitives.
+      // TODO(kasra): maybe freezeDeep instead?
+      return (0, _private_utils.cloneDeep)(cellValue);
+    } else {
+      return cellValue;
+    }
+  }
+  /**
+   * Gets the cell value of the given field for this record.
+   *
+   * @param fieldOrFieldIdOrFieldName The field (or field ID or field name) whose cell value you'd like to get.
+   * @example
+   * ```js
+   * const cellValue = myRecord.getCellValue(mySingleLineTextField);
+   * console.log(cellValue);
+   * // => 'cell value'
+   * ```
+   */
+  getCellValue(fieldOrFieldIdOrFieldName) {
+    const field = this._getFieldMatching(fieldOrFieldIdOrFieldName);
+    const cellValue = this._getRawCellValue(field);
 
-      // HACK: migrate to new public lookup cell value format if needed
-      if (typeof cellValue === 'object' && cellValue !== null && field.type === _field_core.FieldType.MULTIPLE_LOOKUP_VALUES && !this._sdk.__airtableInterface.sdkInitData.isUsingNewLookupCellValueFormat) {
-        var cellValueForMigration = [];
-        (0, _error_utils.invariant)(Array.isArray(cellValue.linkedRecordIds), 'linkedRecordIds');
-        var _iterator = _createForOfIteratorHelper(cellValue.linkedRecordIds),
-          _step;
-        try {
-          for (_iterator.s(); !(_step = _iterator.n()).done;) {
-            var linkedRecordId = _step.value;
-            (0, _error_utils.invariant)(typeof linkedRecordId === 'string', 'linkedRecordId');
-            var _ref = cellValue,
-              valuesByLinkedRecordId = _ref.valuesByLinkedRecordId;
-            (0, _error_utils.invariant)(valuesByLinkedRecordId && typeof valuesByLinkedRecordId === 'object', 'valuesByLinkedRecordId');
-            var value = valuesByLinkedRecordId[linkedRecordId];
-            if (Array.isArray(value)) {
-              var _iterator2 = _createForOfIteratorHelper(value),
-                _step2;
-              try {
-                for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-                  var v = _step2.value;
-                  cellValueForMigration.push({
-                    linkedRecordId,
-                    value: v
-                  });
-                }
-              } catch (err) {
-                _iterator2.e(err);
-              } finally {
-                _iterator2.f();
-              }
-            } else {
-              cellValueForMigration.push({
-                linkedRecordId,
-                value
-              });
-            }
+    // HACK: migrate to new public lookup cell value format if needed
+    if (typeof cellValue === 'object' && cellValue !== null && field.type === _field_core.FieldType.MULTIPLE_LOOKUP_VALUES && !this._sdk.__airtableInterface.sdkInitData.isUsingNewLookupCellValueFormat) {
+      const cellValueForMigration = [];
+      (0, _error_utils.invariant)(Array.isArray(cellValue.linkedRecordIds), 'linkedRecordIds');
+      for (const linkedRecordId of cellValue.linkedRecordIds) {
+        (0, _error_utils.invariant)(typeof linkedRecordId === 'string', 'linkedRecordId');
+        const {
+          valuesByLinkedRecordId
+        } = cellValue;
+        (0, _error_utils.invariant)(valuesByLinkedRecordId && typeof valuesByLinkedRecordId === 'object', 'valuesByLinkedRecordId');
+        const value = valuesByLinkedRecordId[linkedRecordId];
+        if (Array.isArray(value)) {
+          for (const v of value) {
+            cellValueForMigration.push({
+              linkedRecordId,
+              value: v
+            });
           }
-        } catch (err) {
-          _iterator.e(err);
-        } finally {
-          _iterator.f();
+        } else {
+          cellValueForMigration.push({
+            linkedRecordId,
+            value
+          });
         }
-        return cellValueForMigration;
-      }
-      return cellValue;
-    }
-    /**
-     * 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);
-      var cellValue = this._getRawCellValue(field);
-      if (cellValue === null || cellValue === undefined) {
-        return '';
-      } else {
-        var airtableInterface = this._sdk.__airtableInterface;
-        var appInterface = this._sdk.__appInterface;
-        return airtableInterface.fieldTypeProvider.convertCellValueToString(appInterface, cellValue, field._data);
       }
+      return cellValueForMigration;
     }
-    /**
-     * The primary cell value in this record, formatted as a `string`.
-     *
-     * @example
-     * ```js
-     * console.log(myRecord.name);
-     * // => '42'
-     * ```
-     */
-  }, {
-    key: "name",
-    get: function get() {
-      return this.getCellValueAsString(this.parentTable.primaryField);
-    }
-    /**
-     * The created time of this record.
-     *
-     * @example
-     * ```js
-     * console.log(`
-     *     This record was created at ${myRecord.createdTime.toISOString()}
-     * `);
-     * ```
-     */
-  }, {
-    key: "createdTime",
-    get: function get() {
-      return new Date(this._data.createdTime);
+    return cellValue;
+  }
+  /**
+   * 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);
+    const cellValue = this._getRawCellValue(field);
+    if (cellValue === null || cellValue === undefined) {
+      return '';
+    } else {
+      const airtableInterface = this._sdk.__airtableInterface;
+      const appInterface = this._sdk.__appInterface;
+      return airtableInterface.fieldTypeProvider.convertCellValueToString(appInterface, cellValue, field._data);
     }
-    /**
-     * @internal
-     */
-  }, {
-    key: "__triggerOnChangeForDirtyPaths",
-    value: function __triggerOnChangeForDirtyPaths(dirtyPaths) {
-      var cellValuesByFieldId = dirtyPaths.cellValuesByFieldId;
-      if (cellValuesByFieldId && !(0, _private_utils.isObjectEmpty)(cellValuesByFieldId)) {
-        // TODO: don't trigger changes for fields that aren't supposed to be loaded
-        // (in some cases, e.g. record created, liveapp will send cell values
-        // that we're not subscribed to).
+  }
+  /**
+   * The primary cell value in this record, formatted as a `string`.
+   *
+   * @example
+   * ```js
+   * console.log(myRecord.name);
+   * // => '42'
+   * ```
+   */
+  get name() {
+    return this.getCellValueAsString(this.parentTable.primaryField);
+  }
+  /**
+   * The created time of this record.
+   *
+   * @example
+   * ```js
+   * console.log(`
+   *     This record was created at ${myRecord.createdTime.toISOString()}
+   * `);
+   * ```
+   */
+  get createdTime() {
+    return new Date(this._data.createdTime);
+  }
+  /**
+   * @internal
+   */
+  __triggerOnChangeForDirtyPaths(dirtyPaths) {
+    const {
+      cellValuesByFieldId
+    } = dirtyPaths;
+    if (cellValuesByFieldId && !(0, _private_utils.isObjectEmpty)(cellValuesByFieldId)) {
+      // TODO: don't trigger changes for fields that aren't supposed to be loaded
+      // (in some cases, e.g. record created, liveapp will send cell values
+      // that we're not subscribed to).
 
-        this._onChange(WatchableRecordKeysCore.cellValues, Object.keys(cellValuesByFieldId));
-        if (cellValuesByFieldId[this.parentTable.primaryField.id]) {
-          this._onChange(WatchableRecordKeysCore.name);
-        }
+      this._onChange(WatchableRecordKeysCore.cellValues, Object.keys(cellValuesByFieldId));
+      if (cellValuesByFieldId[this.parentTable.primaryField.id]) {
+        this._onChange(WatchableRecordKeysCore.name);
       }
     }
-  }], [{
-    key: "_isWatchableKey",
-    value: /** @internal */
-    function _isWatchableKey(key) {
-      return (0, _private_utils.isEnumValue)(WatchableRecordKeysCore, key);
-    }
-  }]);
-}(_abstract_model.default);
-/** @internal */
-(0, _defineProperty2.default)(RecordCore, "_className", 'RecordCore');
+  }
+}
+exports.RecordCore = RecordCore;