@airtable/blocks 0.0.0-experimental-f1c9010b3-20250609 → 0.0.0-experimental-15dc8a3ea-20250616

package/dist/cjs/base/types/field.js

@@ -0,0 +1 @@
+"use strict";

package/dist/cjs/base/types/mutations.js

@@ -16,9 +16,6 @@ function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbol
 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: mutations */ /** */
 /** @hidden */
 var MutationTypes = exports.MutationTypes = Object.freeze(_objectSpread(_objectSpread({}, _mutations_core.MutationTypesCore), {}, {
-  SET_MULTIPLE_RECORDS_CELL_VALUES: 'setMultipleRecordsCellValues',
-  DELETE_MULTIPLE_RECORDS: 'deleteMultipleRecords',
-  CREATE_MULTIPLE_RECORDS: 'createMultipleRecords',
   CREATE_SINGLE_FIELD: 'createSingleField',
   UPDATE_SINGLE_FIELD_CONFIG: 'updateSingleFieldConfig',
   UPDATE_SINGLE_FIELD_DESCRIPTION: 'updateSingleFieldDescription',
@@ -29,30 +26,6 @@ var MutationTypes = exports.MutationTypes = Object.freeze(_objectSpread(_objectS
 
 /** @hidden */
 
-/**
- * The Mutation emitted when the App modifies one or more {@link Record|Records}.
- *
- * @docsPath testing/mutations/SetMultipleRecordsCellValuesMutation
- */
-
-/** @hidden */
-
-/**
- * The Mutation emitted when the App deletes one or more {@link Record|Records}.
- *
- * @docsPath testing/mutations/DeleteMultipleRecordsMutation
- */
-
-/** @hidden */
-
-/**
- * The Mutation emitted when the App creates one or more {@link Record|Records}.
- *
- * @docsPath testing/mutations/CreateMultipleRecordsMutation
- */
-
-/** @hidden */
-
 /**
  * The Mutation emitted when the App creates a {@link Field}.
  *

package/dist/cjs/base/ui/cell_renderer.js

@@ -33,7 +33,7 @@ var _core = require("@styled-system/core");
 var _error_utils = require("../../shared/error_utils");
 var _record = _interopRequireDefault(require("../models/record"));
 var _field = _interopRequireDefault(require("../models/field"));
-var _field2 = require("../../shared/types/field");
+var _field_core = require("../../shared/types/field_core");
 var _with_hooks = _interopRequireDefault(require("../../shared/ui/with_hooks"));
 var _use_watchable = _interopRequireDefault(require("../../shared/ui/use_watchable"));
 var _sdk_context = require("../../shared/ui/sdk_context");
@@ -172,7 +172,7 @@ var CellRenderer = exports.CellRenderer = /*#__PURE__*/function (_React$Componen
       // make it work with the cell renderer, we need to format it back the other way.
       // Note: we can't use _getRawCellValue here since we also need to handle formatting
       // these in the case where the user passed cellValue instead of a record.
-      if (cellValueToRender && field.type === _field2.FieldType.MULTIPLE_LOOKUP_VALUES && !airtableInterface.sdkInitData.isUsingNewLookupCellValueFormat) {
+      if (cellValueToRender && field.type === _field_core.FieldType.MULTIPLE_LOOKUP_VALUES && !airtableInterface.sdkInitData.isUsingNewLookupCellValueFormat) {
         var originalCellValue = cellValueToRender;
         var linkedRecordIdsSet = new Set();
         var valuesByLinkedRecordId = {};

package/dist/cjs/base/ui/field_picker.js

@@ -27,7 +27,7 @@ var React = _interopRequireWildcard(require("react"));
 var _private_utils = require("../../shared/private_utils");
 var _field = _interopRequireDefault(require("../models/field"));
 var _table = _interopRequireDefault(require("../models/table"));
-var _field2 = require("../../shared/types/field");
+var _field_core = require("../../shared/types/field_core");
 var _use_watchable = _interopRequireDefault(require("../../shared/ui/use_watchable"));
 var _sdk_context = require("../../shared/ui/sdk_context");
 var _select = require("./select");
@@ -47,7 +47,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 // Shared with `FieldPicker` and `FieldPickerSynced`.
 var sharedFieldPickerPropTypes = exports.sharedFieldPickerPropTypes = _objectSpread({
   table: _propTypes.default.instanceOf(_table.default),
-  allowedTypes: _propTypes.default.arrayOf(_propTypes.default.oneOf((0, _private_utils.values)(_field2.FieldType)).isRequired),
+  allowedTypes: _propTypes.default.arrayOf(_propTypes.default.oneOf((0, _private_utils.values)(_field_core.FieldType)).isRequired),
   shouldAllowPickingNone: _propTypes.default.bool,
   placeholder: _propTypes.default.string,
   onChange: _propTypes.default.func

package/dist/cjs/base/ui/record_card.js

@@ -33,8 +33,8 @@ var React = _interopRequireWildcard(require("react"));
 var _core = require("@styled-system/core");
 var _private_utils = require("../../shared/private_utils");
 var _error_utils = require("../../shared/error_utils");
-var _field = require("../../shared/types/field");
-var _field2 = _interopRequireDefault(require("../models/field"));
+var _field_core = require("../../shared/types/field_core");
+var _field = _interopRequireDefault(require("../models/field"));
 var _record = _interopRequireDefault(require("../models/record"));
 var _view = _interopRequireDefault(require("../models/view"));
 var _use_watchable = _interopRequireDefault(require("../../shared/ui/use_watchable"));
@@ -119,7 +119,7 @@ CellValueAndFieldLabel.propTypes = {
   // TODO(jb): make the constraints for rendering cell values less strict than the
   // constraints we put on updating cell values.
   cellValue: _propTypes.default.any,
-  field: _propTypes.default.instanceOf(_field2.default).isRequired,
+  field: _propTypes.default.instanceOf(_field.default).isRequired,
   width: _propTypes.default.number.isRequired,
   renderInvalidCellValue: _propTypes.default.func
 };
@@ -134,16 +134,16 @@ CellValueAndFieldLabel.propTypes = {
 
 // TODO(jb): move this stuff into the field model when we decide on an api for it.
 var FormulaicFieldTypes = {
-  [_field.FieldType.FORMULA]: true,
-  [_field.FieldType.ROLLUP]: true,
-  [_field.FieldType.MULTIPLE_LOOKUP_VALUES]: true
+  [_field_core.FieldType.FORMULA]: true,
+  [_field_core.FieldType.ROLLUP]: true,
+  [_field_core.FieldType.MULTIPLE_LOOKUP_VALUES]: true
 };
 var isFieldFormulaic = field => {
   return (0, _private_utils.has)(FormulaicFieldTypes, field.type);
 };
 var getFieldResultType = field => {
-  if (field.type === _field.FieldType.COUNT) {
-    return _field.FieldType.NUMBER;
+  if (field.type === _field_core.FieldType.COUNT) {
+    return _field_core.FieldType.NUMBER;
   }
   if (isFieldFormulaic(field)) {
     (0, _error_utils.invariant)(field.options, 'options');
@@ -154,7 +154,7 @@ var getFieldResultType = field => {
       return resultType;
     } else {
       // Formula is misconfigured.
-      return _field.FieldType.SINGLE_LINE_TEXT;
+      return _field_core.FieldType.SINGLE_LINE_TEXT;
     }
   } else {
     return field.type;
@@ -315,7 +315,7 @@ var RecordCard = exports.RecordCard = /*#__PURE__*/function (_React$Component) {
   }, {
     key: "_isAttachment",
     value: function _isAttachment(field) {
-      return getFieldResultType(field) === _field.FieldType.MULTIPLE_ATTACHMENTS;
+      return getFieldResultType(field) === _field_core.FieldType.MULTIPLE_ATTACHMENTS;
     }
     /** @internal */
   }, {
@@ -347,7 +347,7 @@ var RecordCard = exports.RecordCard = /*#__PURE__*/function (_React$Component) {
     key: "_getFirstAttachmentInField",
     value: function _getFirstAttachmentInField(attachmentField) {
       var attachmentsInField;
-      if (attachmentField.type === _field.FieldType.MULTIPLE_LOOKUP_VALUES) {
+      if (attachmentField.type === _field_core.FieldType.MULTIPLE_LOOKUP_VALUES) {
         var cellValue = this._getCellValue(attachmentField);
         attachmentsInField = cellValue ? cellValue.map(cv => cv.value) : [];
       } else {
@@ -598,13 +598,13 @@ var RecordCard = exports.RecordCard = /*#__PURE__*/function (_React$Component) {
   // Record can either be a record model or a record def (cellValuesByFieldId)
   record: _propTypes.default.oneOfType([_propTypes.default.instanceOf(_record.default), _propTypes.default.object]),
   // Should provide one of fields and view
-  fields: _propTypes.default.arrayOf(_propTypes.default.instanceOf(_field2.default).isRequired),
+  fields: _propTypes.default.arrayOf(_propTypes.default.instanceOf(_field.default).isRequired),
   view: _propTypes.default.instanceOf(_view.default),
   // This component will always respect attachmentCoverField if one is passed in.
   // Pass a null value to explicitly indicate that an attachment should not be
   // shown. If attachmentCoverField is undefined, it will fall back to using the
   // first attachment in the view provided (if a view is provided).
-  attachmentCoverField: _propTypes.default.instanceOf(_field2.default),
+  attachmentCoverField: _propTypes.default.instanceOf(_field.default),
   width: _propTypes.default.number,
   height: _propTypes.default.number,
   // TODO: add all other mouse events: https://facebook.github.io/react/docs/events.html#mouse-events

package/dist/cjs/base/unstable_testing_utils.js

@@ -43,7 +43,7 @@ Object.defineProperty(exports, "FieldData", {
 Object.defineProperty(exports, "FieldType", {
   enumerable: true,
   get: function get() {
-    return _field.FieldType;
+    return _field_core.FieldType;
   }
 });
 Object.defineProperty(exports, "FieldTypeProvider", {
@@ -161,7 +161,8 @@ var _airtable_interface_core = require("../shared/types/airtable_interface_core"
 var _airtable_interface = require("./types/airtable_interface");
 var _record = require("./types/record");
 var _cursor = require("./types/cursor");
-var _field = require("../shared/types/field");
+var _field = require("./types/field");
+var _field_core = require("../shared/types/field_core");
 var _view = require("./types/view");
 var _viewport = require("./types/viewport");
 var _global_config = require("../shared/types/global_config");

package/dist/cjs/interface/models/models.js

@@ -12,19 +12,19 @@ Object.defineProperty(exports, "Base", {
 Object.defineProperty(exports, "Field", {
   enumerable: true,
   get: function get() {
-    return _field2.Field;
+    return _field.Field;
   }
 });
 Object.defineProperty(exports, "FieldConfig", {
   enumerable: true,
   get: function get() {
-    return _field.FieldConfig;
+    return _field_core.FieldConfig;
   }
 });
 Object.defineProperty(exports, "FieldType", {
   enumerable: true,
   get: function get() {
-    return _field.FieldType;
+    return _field_core.FieldType;
   }
 });
 Object.defineProperty(exports, "Record", {
@@ -45,9 +45,9 @@ Object.defineProperty(exports, "Table", {
     return _table.Table;
   }
 });
-var _field = require("../../shared/types/field");
+var _field_core = require("../../shared/types/field_core");
 var _base = require("./base");
 var _table = require("./table");
-var _field2 = require("./field");
+var _field = require("./field");
 var _record = require("./record");
 var _session = require("./session");

package/dist/cjs/interface/models/mutations.js

@@ -5,13 +5,18 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.Mutations = void 0;
+require("core-js/modules/es.array.filter.js");
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.object.to-string.js");
+require("core-js/modules/es.set.js");
+require("core-js/modules/web.dom-collections.iterator.js");
 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 _mutations_core = require("../../shared/models/mutations_core");
-var _error_utils = require("../../shared/error_utils");
 var _mutations = require("../types/mutations");
 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; })(); }
@@ -23,42 +28,51 @@ var Mutations = exports.Mutations = /*#__PURE__*/function (_MutationsCore) {
   }
   (0, _inherits2.default)(Mutations, _MutationsCore);
   return (0, _createClass2.default)(Mutations, [{
-    key: "_doesMutationExceedBatchSizeLimit",
+    key: "_isRecordStoreReadyForMutations",
     value: /** @internal */
-    function _doesMutationExceedBatchSizeLimit(mutation) {
-      switch (mutation.type) {
-        case _mutations.MutationTypes.SET_MULTIPLE_GLOBAL_CONFIG_PATHS:
-          return mutation.updates.length > _mutations_core.MUTATIONS_MAX_BATCH_SIZE;
-        default:
-          throw (0, _error_utils.spawnUnknownSwitchCaseError)('mutation type', mutation.type, 'type');
-      }
+    function _isRecordStoreReadyForMutations() {
+      return true;
     }
+
     /** @internal */
   }, {
-    key: "_assertMutationIsValid",
-    value: function _assertMutationIsValid(mutation) {
-      switch (mutation.type) {
-        case _mutations.MutationTypes.SET_MULTIPLE_GLOBAL_CONFIG_PATHS:
-          // globalConfig update is a special case: globalConfig handles validation before
-          // invoking this mutation, since it relies on internal state to validate the
-          // paths being set.
-          return;
-        default:
-          throw (0, _error_utils.spawnUnknownSwitchCaseError)('mutation type', mutation.type, 'type');
-      }
+    key: "_isFieldAvailableForMutation",
+    value: function _isFieldAvailableForMutation() {
+      return true;
     }
+
     /** @internal */
   }, {
     key: "_getOptimisticModelChangesForMutation",
     value: function _getOptimisticModelChangesForMutation(mutation) {
       switch (mutation.type) {
-        // The following branch is unreachable because this method's only
-        // call site is preceded by an explicit guard for this condition.
-        // istanbul ignore next
-        case _mutations.MutationTypes.SET_MULTIPLE_GLOBAL_CONFIG_PATHS:
-          throw (0, _error_utils.spawnError)('attempting to generate model updates for SET_MULTIPLE_GLOBAL_CONFIG_PATH');
+        case _mutations.MutationTypes.CREATE_MULTIPLE_RECORDS:
+          {
+            // Ideally, we'd add the recordIds to the `recordOrder` of the Table (see
+            // how we optimistically remove from this in the DELETE_MULTIPLE_RECORDS
+            // case below). But we can't really do that because we don't know how to
+            // sort the records. As a result, we'll just optimistically add the records
+            // to the store, so if the developer calls `getRecordById` for a recordId
+            // that was just created, it will exist. But if they are iterating over
+            // all records, they will only get the new records once the mutation is
+            // applied and liveapp sends an update to the recordOrder.
+            return (0, _get2.default)((0, _getPrototypeOf2.default)(Mutations.prototype), "_getOptimisticModelChangesForMutation", this).call(this, mutation);
+          }
+        case _mutations.MutationTypes.DELETE_MULTIPLE_RECORDS:
+          {
+            var tableId = mutation.tableId,
+              deletedRecordIds = mutation.recordIds;
+            var recordStore = this._base.__getRecordStore(tableId);
+            var deletedRecordIdsSet = new Set(deletedRecordIds);
+            return [{
+              path: ['tablesById', tableId, 'recordOrder'],
+              value: recordStore.recordIds.filter(recordId => !deletedRecordIdsSet.has(recordId))
+            }, ...(0, _get2.default)((0, _getPrototypeOf2.default)(Mutations.prototype), "_getOptimisticModelChangesForMutation", this).call(this, mutation)];
+          }
         default:
-          throw (0, _error_utils.spawnUnknownSwitchCaseError)('mutation type', mutation.type, 'type');
+          {
+            return (0, _get2.default)((0, _getPrototypeOf2.default)(Mutations.prototype), "_getOptimisticModelChangesForMutation", this).call(this, mutation);
+          }
       }
     }
   }]);

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

@@ -10,13 +10,15 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.Record = void 0;
-var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 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 _error_utils = require("../../shared/error_utils");
 var _record_core = require("../../shared/models/record_core");
+var _field_core = require("../../shared/types/field_core");
 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; }
@@ -40,7 +42,30 @@ var Record = exports.Record = /*#__PURE__*/function (_RecordCore) {
     return _callSuper(this, Record, arguments);
   }
   (0, _inherits2.default)(Record, _RecordCore);
-  return (0, _createClass2.default)(Record);
+  return (0, _createClass2.default)(Record, [{
+    key: "fetchForeignRecordsAsync",
+    value:
+    /**
+     * Fetch foreign records for a field. Subsequent calls to this method will
+     * override previous calls that are still pending. The previous call(s)
+     * will immediately resolve with an empty `records` array.
+     *
+     * @param fieldId - The ID of the field to fetch foreign records for.
+     * @param filterString - The filter string to use to filter the records.
+     * @returns A promise that resolves to the foreign records.
+     */
+    function fetchForeignRecordsAsync(field, filterString) {
+      var parentTable = this.parentTable;
+      if (field.parentTable !== parentTable) {
+        throw (0, _error_utils.spawnError)('Field %s is not in the same table as the record', field.name);
+      }
+      if (field.type !== _field_core.FieldType.MULTIPLE_RECORD_LINKS) {
+        throw (0, _error_utils.spawnError)('Field %s is not a multiple record links field', field.name);
+      }
+      var airtableInterface = this.parentTable.parentBase.__sdk.__airtableInterface;
+      return airtableInterface.fetchForeignRecordsAsync(parentTable.id, this.id, field.id, filterString);
+    }
+  }]);
 }(_record_core.RecordCore);
 /** @internal */
 (0, _defineProperty2.default)(Record, "_className", 'Record');

package/dist/cjs/interface/types/airtable_interface.js

@@ -14,6 +14,7 @@ var BlockRunContextType = exports.BlockRunContextType = /*#__PURE__*/function (B
 /** @hidden */
 /** @hidden */
 /** @hidden */
+/** @hidden */
 // Keep in sync with enum in hyperbase repo:
 // https://github.com/Hyperbase/hyperbase/blob/2c0e2ef2cbc6bce7ab33fd913ef3572a83c3892d/client_server_shared/pages/types/block_installation_page_elements/block_installation_page_element_custom_properties_types.tsx
 /** @hidden */

package/dist/cjs/interface/types/field.js

@@ -0,0 +1 @@
+"use strict";

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

@@ -13,7 +13,7 @@ var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime
 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 _field = require("../types/field");
+var _field_core = require("../types/field_core");
 var _private_utils = require("../private_utils");
 var _abstract_model = _interopRequireDefault(require("./abstract_model"));
 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)); }
@@ -114,7 +114,7 @@ var FieldCore = exports.FieldCore = /*#__PURE__*/function (_AbstractModel) {
       // until the transition is complete. See <https://airtable.quip.com/VxaMAmAfUscs> for more.
       // @ts-ignore
       if (type === 'lookup') {
-        return _field.FieldType.MULTIPLE_LOOKUP_VALUES;
+        return _field_core.FieldType.MULTIPLE_LOOKUP_VALUES;
       } else {
         return type;
       }
@@ -270,7 +270,7 @@ var FieldCore = exports.FieldCore = /*#__PURE__*/function (_AbstractModel) {
       // The opt parseDateCellValueInColumnTimeZone is used here to ensure date string
       // inputs are interpreted correctly according to the `timeZone` of the dateTime field.
       {
-        parseDateCellValueInColumnTimeZone: this.type === _field.FieldType.DATE_TIME
+        parseDateCellValueInColumnTimeZone: this.type === _field_core.FieldType.DATE_TIME
       });
 
       // Temporarily bail out of validating computed values (since validation will crash)