@airtable/blocks 1.11.1 → 1.12.0

package/dist/cjs/global_config.js

@@ -59,7 +59,7 @@ var _private_utils = require("./private_utils");
 //    as a name seems a bit too vague in terms of intended usage).
 
 /**
- * A key-value store for persisting configuration options for an app installation.
+ * A key-value store for persisting configuration options for an extension installation.
  *
  * The contents will be synced in real-time to all logged-in users of the installation.
  * Contents will not be updated in real-time when the installation is running in
@@ -287,7 +287,7 @@ function (_Watchable) {
      *     if (globalConfig.hasPermissionToSetPaths('favoriteColor', color)) {
      *         globalConfig.setAsync('favoriteColor', color);
      *     }
-     *     // The update is now applied within your app (eg will be
+     *     // The update is now applied within your extension (eg will be
      *     // reflected in globalConfig) but are still being saved to
      *     // Airtable servers (e.g. may not be updated for other users yet)
      * }
@@ -423,7 +423,7 @@ function (_Watchable) {
      *     if (globalConfig.hasPermissionToSetPaths(updates)) {
      *         globalConfig.setPathsAsync(updates);
      *     }
-     *     // The updates are now applied within your app (eg will be reflected in
+     *     // The updates are now applied within your extension (eg will be reflected in
      *     // globalConfig) but are still being saved to Airtable servers (e.g. they
      *     // may not be updated for other users yet)
      * }

package/dist/cjs/models/base.js

@@ -186,8 +186,8 @@ function (_AbstractModel) {
      * The user matching the given ID, name, or email address. Returns null if that user does not
      * exist or does not have access to this base.
      *
-     * This method is convenient when building an app for a specific base, but for more generic
-     * apps the best practice is to use the {@link getCollaboratorByIdIfExists} method instead.
+     * This method is convenient when building an extension for a specific base, but for more generic
+     * extensions the best practice is to use the {@link getCollaboratorByIdIfExists} method instead.
      *
      * @param collaboratorIdOrNameOrEmail The ID of the user.
      */
@@ -254,8 +254,8 @@ function (_AbstractModel) {
      * or does not have access to this base. Use {@link getCollaboratorIfExists} instead if you are
      * unsure whether a collaborator with the given ID exists and has access to this base.
      *
-     * This method is convenient when building an app for a specific base, but for more generic
-     * apps the best practice is to use the {@link getCollaboratorById} method instead.
+     * This method is convenient when building an extension for a specific base, but for more generic
+     * extensions the best practice is to use the {@link getCollaboratorById} method instead.
      *
      * @param collaboratorIdOrNameOrEmail The ID of the user.
      */
@@ -397,8 +397,8 @@ function (_AbstractModel) {
      * The table matching the given ID or name. Returns `null` if no matching table exists within
      * this base.
      *
-     * This method is convenient when building an app for a specific base, but for more generic
-     * apps the best practice is to use the {@link getTableByIdIfExists} or
+     * This method is convenient when building an extension for a specific base, but for more generic
+     * extensions the best practice is to use the {@link getTableByIdIfExists} or
      * {@link getTableByNameIfExists} methods instead.
      *
      * @param tableIdOrName The ID or name of the table you're looking for.
@@ -416,8 +416,8 @@ function (_AbstractModel) {
      * Use {@link getTableIfExists} instead if you are unsure whether a table exists with the given
      * name/ID.
      *
-     * This method is convenient when building an app for a specific base, but for more generic
-     * apps the best practice is to use the {@link getTableById} or {@link getTableByName} methods
+     * This method is convenient when building an extension for a specific base, but for more generic
+     * extensions the best practice is to use the {@link getTableById} or {@link getTableByName} methods
      * instead.
      *
      * @param tableIdOrName The ID or name of the table you're looking for.
@@ -521,7 +521,7 @@ function (_AbstractModel) {
      *
      * This action is asynchronous. Unlike new records, new tables are **not** created
      * optimistically locally. You must `await` the returned promise before using the new
-     * table in your app.
+     * table in your extension.
      *
      * @param name name for the table. must be case-insensitive unique
      * @param fields array of fields to create in the table: see below for an example. `name` and
@@ -607,7 +607,7 @@ function (_AbstractModel) {
     value: function getMaxRecordsPerTable() {
       var _this$_data$maxRowsPe;
 
-      return (_this$_data$maxRowsPe = this._data.maxRowsPerTable) !== null && _this$_data$maxRowsPe !== void 0 ? _this$_data$maxRowsPe : 50000;
+      return (_this$_data$maxRowsPe = this._data.maxRowsPerTable) !== null && _this$_data$maxRowsPe !== void 0 ? _this$_data$maxRowsPe : 100000;
     }
     /**
      * @internal

package/dist/cjs/models/cursor.js

@@ -268,9 +268,8 @@ function (_AbstractModelWithAsy) {
     key: "setActiveTable",
 
     /**
-     * Sets the specified table to active in the Airtable UI. If the apps pane is fullscreen, the
-     * table will still be set as active, but the apps pane will continue to be displayed
-     * fullscreen.
+     * Sets the specified table to active in the Airtable UI. If the extension installation or extensions pane
+     * is fullscreen, fullscreen mode will be exited.
      *
      * @param tableOrTableId The target table or table ID to set as active in the Airtable main page.
      */
@@ -280,9 +279,8 @@ function (_AbstractModelWithAsy) {
       this._sdk.__airtableInterface.setActiveViewOrTable(tableId);
     }
     /**
-     * Sets the specified view (and corresponding table) to active in the Airtable UI. If the apps
-     * pane is fullscreen, the view will still be set as active, but the apps pane will continue
-     * to be displayed fullscreen.
+     * Sets the specified view (and corresponding table) to active in the Airtable UI. If the extension
+     * installation or extensions pane is fullscreen, fullscreen mode will be exited.
      *
      * @param tableOrTableId The table or table ID that the target view belongs to.
      * @param viewOrViewId The target view or view ID to set as active in the Airtable main page.

package/dist/cjs/models/field.js

@@ -225,7 +225,7 @@ function (_AbstractModel) {
      *
      * This action is asynchronous. Unlike updates to cell values, updates to field options are
      * **not** applied optimistically locally. You must `await` the returned promise before
-     * relying on the change in your app.
+     * relying on the change in your extension.
      *
      * Optionally, you can pass an `opts` object as the second argument. See {@link UpdateFieldOptionsOpts}
      * for available options.
@@ -342,7 +342,7 @@ function (_AbstractModel) {
      *
      * This action is asynchronous. Unlike updates to cell values, updates to field name are
      * **not** applied optimistically locally. You must `await` the returned promise before
-     * relying on the change in your app.
+     * relying on the change in your extension.
      *
      * @param name new name for the field
      *
@@ -440,7 +440,7 @@ function (_AbstractModel) {
      *
      * This action is asynchronous. Unlike updates to cell values, updates to field descriptions are
      * **not** applied optimistically locally. You must `await` the returned promise before
-     * relying on the change in your app.
+     * relying on the change in your extension.
      *
      * @param description new description for the field
      *

package/dist/cjs/models/record_query_result.js

@@ -127,7 +127,7 @@ function normalizeSortsOrGroups(table, sortsOrGroups) {
  *   You can get one of these with `record.selectLinkedRecordsFromCell(someField)`.
  *
  * Once you've got a query result, you need to load it before you can start working with it -
- * apps don't load record data by default. We recommend using {@link useRecords},
+ * extensions don't load record data by default. We recommend using {@link useRecords},
  * {@link useRecordIds}, {@link useRecordById} or {@link useLoadable} to handle this.
  *
  * If you're not using a query result in a React component, you can manually load the data and

package/dist/cjs/models/record_store.js

@@ -12,6 +12,8 @@ require("core-js/modules/es.array.iterator");
 
 require("core-js/modules/es.array.map");
 
+require("core-js/modules/es.object.entries");
+
 require("core-js/modules/es.object.to-string");
 
 require("core-js/modules/es.promise");
@@ -110,6 +112,7 @@ function (_AbstractModelWithAsy) {
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "_areCellValuesLoadedByFieldId", {});
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "_pendingCellValuesLoadPromiseByFieldId", {});
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "_cellValuesRetainCountByFieldId", {});
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "_timeoutForRemovingFieldIds", null);
     _this._airtableInterface = sdk.__airtableInterface;
     _this.tableId = tableId; // A bit of a hack, but we use the primary field ID to load record
     // metadata (see _getFieldIdForCausingRecordMetadataToLoad). We copy the
@@ -502,10 +505,15 @@ function (_AbstractModelWithAsy) {
               });
 
             case 45:
-              _context2.next = 47;
+              // Since we are incrementing fieldIds, it's necessary to restart any pending timeouts
+              // to unload data. This is because it's possible for a timeout to fire while a queryResult
+              // is actively unloading, and erroneously unload data. Data must be unloaded _after_ the queryResult.
+              this._restartTimeoutToUnloadFieldIdsIfTimeoutIsActive();
+
+              _context2.next = 48;
               return _regenerator.default.awrap(Promise.all(pendingLoadPromises));
 
-            case 47:
+            case 48:
             case "end":
               return _context2.stop();
           }
@@ -638,7 +646,6 @@ function (_AbstractModelWithAsy) {
         return;
       }
 
-      var fieldIdsWithZeroRetainCount = [];
       var _iteratorNormalCompletion8 = true;
       var _didIteratorError8 = false;
       var _iteratorError8 = undefined;
@@ -656,11 +663,10 @@ function (_AbstractModelWithAsy) {
           }
 
           this._cellValuesRetainCountByFieldId[fieldId] = fieldRetainCount;
+        } // Don't unload immediately. Wait a while in case something else
+        // requests the data, so we can avoid going back to liveapp or
+        // the network.
 
-          if (fieldRetainCount === 0) {
-            fieldIdsWithZeroRetainCount.push(fieldId);
-          }
-        }
       } catch (err) {
         _didIteratorError8 = true;
         _iteratorError8 = err;
@@ -676,16 +682,45 @@ function (_AbstractModelWithAsy) {
         }
       }
 
+      this._startTimeoutToUnloadForFieldIdsIfNeeded();
+    } // This unloads all fields where the retain count is at zero, and if any other
+    // request to unload fields is pending - cancels it and restarts it.
+    // This is important because fields must always be unloaded at least __DATA_UNLOAD_DELAY_MS
+    // after the unload is requested so that any QueryResults relying on them properly
+    // unload either first, or at the same time
+
+  }, {
+    key: "_startTimeoutToUnloadForFieldIdsIfNeeded",
+    value: function _startTimeoutToUnloadForFieldIdsIfNeeded() {
+      var fieldIdsWithZeroRetainCount = [];
+
+      for (var _i2 = 0, _Object$entries = Object.entries(this._cellValuesRetainCountByFieldId); _i2 < _Object$entries.length; _i2++) {
+        var _Object$entries$_i = (0, _slicedToArray2.default)(_Object$entries[_i2], 2),
+            fieldId = _Object$entries$_i[0],
+            retainCount = _Object$entries$_i[1];
+
+        if (retainCount === 0) {
+          fieldIdsWithZeroRetainCount.push(fieldId);
+        }
+      } // Cancel any pending timeouts before proceeding
+      // This should be canceled even if there aren't any fields to unload as that means
+      // that there has been loading that's occured that makes the pending request invalid
+
+
+      if (this._timeoutForRemovingFieldIds) {
+        clearTimeout(this._timeoutForRemovingFieldIds);
+        this._timeoutForRemovingFieldIds = null;
+      }
+
       if (fieldIdsWithZeroRetainCount.length > 0) {
-        // Don't unload immediately. Wait a while in case something else
-        // requests the data, so we can avoid going back to liveapp or
-        // the network.
-        setTimeout(() => {
+        this._timeoutForRemovingFieldIds = setTimeout(() => {
           // Make sure the retain count is still zero, since it may
           // have been incremented before the timeout fired.
           var fieldIdsToUnload = fieldIdsWithZeroRetainCount.filter(fieldId => {
-            return this._cellValuesRetainCountByFieldId[fieldId] === 0;
-          });
+            // It's necessary to also check that the field is loaded, as it's possible
+            // for an unload to trigger with fields that have already been removed.
+            return this._cellValuesRetainCountByFieldId[fieldId] === 0 && this._areCellValuesLoadedByFieldId[fieldId];
+          }); // istanbul ignore else
 
           if (fieldIdsToUnload.length > 0) {
             // Set _areCellValuesLoadedByFieldId to false before calling _unloadCellValuesInFieldIds
@@ -715,10 +750,23 @@ function (_AbstractModelWithAsy) {
             }
 
             this._unloadCellValuesInFieldIds(fieldIdsToUnload);
+          } else {
+            // This shouldn't be possible because we always cancel the timer if fieldIds loadedness
+            // status ever changes
+            (0, _error_utils.logErrorToSentry)('fieldIdsToUnload is empty, this likely means the unload timer is not properly reset.');
           }
+
+          this._timeoutForRemovingFieldIds = null;
         }, _abstract_model_with_async_data.default.__DATA_UNLOAD_DELAY_MS);
       }
     }
+  }, {
+    key: "_restartTimeoutToUnloadFieldIdsIfTimeoutIsActive",
+    value: function _restartTimeoutToUnloadFieldIdsIfTimeoutIsActive() {
+      if (this._timeoutForRemovingFieldIds) {
+        this._startTimeoutToUnloadForFieldIdsIfNeeded();
+      }
+    }
   }, {
     key: "_unloadCellValuesInFieldIds",
     value: function _unloadCellValuesInFieldIds(fieldIds) {
@@ -811,11 +859,15 @@ function (_AbstractModelWithAsy) {
         if (!areAnyFieldsLoaded) {
           this._data.recordsById = undefined;
         } else if (!this.isDataLoaded) {
-          var fieldIdsToClear;
+          var fieldIdsToClear; // This should be impossible - for fields should always be loaded
+          // when attempting to unload specific fields. This codepath was previously possible
+          // due to a bug. It could be converted to an invariant, but that is higher risk.
+          // istanbul ignore if
 
           if (unloadedFieldIds) {
             // Specific fields were unloaded, so clear out the cell values for those fields.
             fieldIdsToClear = unloadedFieldIds;
+            (0, _error_utils.logErrorToSentry)('Field Ids are being unloaded when record_store is unloaded');
           } else {
             // The entire table was unloaded, but some individual fields are still loaded.
             // We need to clear out the cell values of every field that was unloaded.
@@ -907,8 +959,8 @@ function (_AbstractModelWithAsy) {
             var cellValuesByFieldId = dirtyRecordPaths.cellValuesByFieldId;
 
             if (cellValuesByFieldId) {
-              for (var _i2 = 0, _Object$keys2 = Object.keys(cellValuesByFieldId); _i2 < _Object$keys2.length; _i2++) {
-                var fieldId = _Object$keys2[_i2];
+              for (var _i3 = 0, _Object$keys2 = Object.keys(cellValuesByFieldId); _i3 < _Object$keys2.length; _i3++) {
+                var fieldId = _Object$keys2[_i3];
                 dirtyFieldIdsSet[fieldId] = true;
               }
             }

package/dist/cjs/models/session.js

@@ -72,7 +72,7 @@ var WatchableSessionKeys = Object.freeze({
  *     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>;
+ *         return <span>This extension is being viewed in a public share</span>;
  *     }
  * }
  * ```
@@ -384,7 +384,7 @@ function (_AbstractModel) {
       return this._sessionData;
     }
     /**
-     * The current user, or `null` if the app is running in a publicly shared base.
+     * The current user, or `null` if the extension is running in a publicly shared base.
      *
      * @example
      * ```js
@@ -394,7 +394,7 @@ function (_AbstractModel) {
      *     const session = useSession();
      *
      *     if (!session.currentUser) {
-     *         return <div>This app is being used in a public share.</div>;
+     *         return <div>This extension is being used in a public share.</div>;
      *     }
      *
      *     return <ul>

package/dist/cjs/models/table.js

@@ -279,8 +279,8 @@ function (_AbstractModel) {
      * The field matching the given ID or name. Returns `null` if no matching field exists within
      * this table.
      *
-     * This method is convenient when building an app for a specific base, but for more generic
-     * apps the best practice is to use the {@link getFieldByIdIfExists} or
+     * This method is convenient when building an extension for a specific base, but for more generic
+     * extensions the best practice is to use the {@link getFieldByIdIfExists} or
      * {@link getFieldByNameIfExists} methods instead.
      *
      * @param fieldIdOrName The ID or name of the field you're looking for.
@@ -298,8 +298,8 @@ function (_AbstractModel) {
      * Use {@link getFieldIfExists} instead if you are unsure whether a field exists with the given
      * name/ID.
      *
-     * This method is convenient when building an app for a specific base, but for more generic
-     * apps the best practice is to use the {@link getFieldById} or {@link getFieldByName} methods
+     * This method is convenient when building an extension for a specific base, but for more generic
+     * extensions the best practice is to use the {@link getFieldById} or {@link getFieldByName} methods
      * instead.
      *
      * @param fieldIdOrName The ID or name of the field you're looking for.
@@ -460,8 +460,8 @@ function (_AbstractModel) {
      * The view matching the given ID or name. Returns `null` if no matching view exists within
      * this table.
      *
-     * This method is convenient when building an app for a specific base, but for more generic
-     * apps the best practice is to use the {@link getViewByIdIfExists} or
+     * This method is convenient when building an extension for a specific base, but for more generic
+     * extensions the best practice is to use the {@link getViewByIdIfExists} or
      * {@link getViewByNameIfExists} methods instead.
      *
      * @param viewIdOrName The ID or name of the view you're looking for.
@@ -479,8 +479,8 @@ function (_AbstractModel) {
      * Use {@link getViewIfExists} instead if you are unsure whether a view exists with the given
      * name/ID.
      *
-     * This method is convenient when building an app for a specific base, but for more generic
-     * apps the best practice is to use the {@link getViewById} or {@link getViewByName} methods
+     * This method is convenient when building an extension for a specific base, but for more generic
+     * extensions the best practice is to use the {@link getViewById} or {@link getViewByName} methods
      * instead.
      *
      * @param viewIdOrName The ID or name of the view you're looking for.
@@ -662,7 +662,7 @@ function (_AbstractModel) {
      *
      * This action is asynchronous: `await` the returned promise if you wish to wait for the updated
      * cell values to be persisted to Airtable servers.
-     * Updates are applied optimistically locally, so your changes will be reflected in your app
+     * Updates are applied optimistically locally, so your changes will be reflected in your extension
      * before the promise resolves.
      *
      * @param recordOrRecordId the record to update
@@ -673,7 +673,7 @@ function (_AbstractModel) {
      *     if (table.hasPermissionToUpdateRecord(record, recordFields)) {
      *         table.updateRecordAsync(record, recordFields);
      *     }
-     *     // The updated values will now show in your app (eg in
+     *     // The updated values will now show in your extension (eg in
      *     // `table.selectRecords()` result) but are still being saved to Airtable
      *     // servers (e.g. other users may not be able to see them yet).
      * }
@@ -768,7 +768,7 @@ function (_AbstractModel) {
      *
      * // Check if user could update specific fields, when you don't know the
      * // specific record that will be updated yet. (for example, if the field is
-     * // selected by the user and you want to check if your app can write to it).
+     * // selected by the user and you want to check if your extension can write to it).
      * const updateUnknownRecordCheckResult =
      *     table.checkPermissionsForUpdateRecord(undefined, {
      *         'My field name': 'updated value',
@@ -779,7 +779,7 @@ function (_AbstractModel) {
      *
      * // Check if user could perform updates within the table, without knowing the
      * // specific record or fields that will be updated yet (e.g., to render your
-     * // app in "read only" mode).
+     * // extension in "read only" mode).
      * const updateUnknownRecordAndFieldsCheckResult =
      *     table.checkPermissionsForUpdateRecord();
      * ```
@@ -829,7 +829,7 @@ function (_AbstractModel) {
      *
      * // Check if user could update specific fields, when you don't know the
      * // specific record that will be updated yet (e.g. if the field is selected
-     * // by the user and you want to check if your app can write to it).
+     * // by the user and you want to check if your extension can write to it).
      * const canUpdateUnknownRecord =
      *     table.hasPermissionToUpdateRecord(undefined, {
      *         'My field name': 'updated value',
@@ -840,7 +840,7 @@ function (_AbstractModel) {
      *
      * // Check if user could perform updates within the table, without knowing the
      * // specific record or fields that will be updated yet. (for example, to
-     * // render your app in "read only" mode)
+     * // render your extension in "read only" mode)
      * const canUpdateUnknownRecordAndFields = table.hasPermissionToUpdateRecord();
      * ```
      */
@@ -864,7 +864,7 @@ function (_AbstractModel) {
      *
      * This action is asynchronous: `await` the returned promise if you wish to wait for the
      * updates to be persisted to Airtable servers.
-     * Updates are applied optimistically locally, so your changes will be reflected in your app
+     * Updates are applied optimistically locally, so your changes will be reflected in your extension
      * before the promise resolves.
      *
      * @param records Array of objects containing recordId and fields/cellValues to update for that record (specified as an object mapping `FieldId` or field name to cell value)
@@ -911,7 +911,7 @@ function (_AbstractModel) {
      *     if (table.hasPermissionToUpdateRecords(recordsToUpdate)) {
      *         table.updateRecordsAsync(recordsToUpdate);
      *     }
-     *     // The records are now updated within your app (eg will be reflected in
+     *     // The records are now updated within your extension (eg will be reflected in
      *     // `table.selectRecords()`) but are still being saved to Airtable servers
      *     // (e.g. they may not be updated for other users yet).
      * }
@@ -1093,7 +1093,7 @@ function (_AbstractModel) {
      *
      * This action is asynchronous: `await` the returned promise if you wish to wait for the
      * delete to be persisted to Airtable servers.
-     * Updates are applied optimistically locally, so your changes will be reflected in your app
+     * Updates are applied optimistically locally, so your changes will be reflected in your extension
      * before the promise resolves.
      *
      * @param recordOrRecordId the record to be deleted
@@ -1103,7 +1103,7 @@ function (_AbstractModel) {
      *     if (table.hasPermissionToDeleteRecord(record)) {
      *         table.deleteRecordAsync(record);
      *     }
-     *     // The record is now deleted within your app (eg will not be returned
+     *     // The record is now deleted within your extension (eg will not be returned
      *     // in `table.selectRecords`) but it is still being saved to Airtable
      *     // servers (e.g. it may not look deleted to other users yet).
      * }
@@ -1208,7 +1208,7 @@ function (_AbstractModel) {
      *
      * This action is asynchronous: `await` the returned promise if you wish to wait for the
      * delete to be persisted to Airtable servers.
-     * Updates are applied optimistically locally, so your changes will be reflected in your app
+     * Updates are applied optimistically locally, so your changes will be reflected in your extension
      * before the promise resolves.
      *
      * @param recordsOrRecordIds Array of Records and RecordIds
@@ -1219,7 +1219,7 @@ function (_AbstractModel) {
      *     if (table.hasPermissionToDeleteRecords(records)) {
      *         table.deleteRecordsAsync(records);
      *     }
-     *     // The records are now deleted within your app (eg will not be
+     *     // The records are now deleted within your extension (eg will not be
      *     // returned in `table.selectRecords()`) but are still being saved to
      *     // Airtable servers (e.g. they may not look deleted to other users yet).
      * }
@@ -1336,7 +1336,7 @@ function (_AbstractModel) {
      *
      * This action is asynchronous: `await` the returned promise if you wish to wait for the new
      * record to be persisted to Airtable servers.
-     * Updates are applied optimistically locally, so your changes will be reflected in your app
+     * Updates are applied optimistically locally, so your changes will be reflected in your extension
      * before the promise resolves.
      *
      * The returned promise will resolve to the RecordId of the new record once it is persisted.
@@ -1348,7 +1348,7 @@ function (_AbstractModel) {
      *     if (table.hasPermissionToCreateRecord(recordFields)) {
      *         table.createRecordAsync(recordFields);
      *     }
-     *     // You can now access the new record in your app (eg
+     *     // You can now access the new record in your extension (eg
      *     // `table.selectRecords()`) but it is still being saved to Airtable
      *     // servers (e.g. other users may not be able to see it yet).
      * }
@@ -1507,7 +1507,7 @@ function (_AbstractModel) {
      *
      * This action is asynchronous: `await` the returned promise if you wish to wait for the new
      * record to be persisted to Airtable servers.
-     * Updates are applied optimistically locally, so your changes will be reflected in your app
+     * Updates are applied optimistically locally, so your changes will be reflected in your extension
      * before the promise resolves.
      *
      * The returned promise will resolve to an array of RecordIds of the new records once the new
@@ -1551,7 +1551,7 @@ function (_AbstractModel) {
      *     if (table.hasPermissionToCreateRecords(recordDefs)) {
      *         table.createRecordsAsync(recordDefs);
      *     }
-     *     // You can now access the new records in your app (e.g.
+     *     // You can now access the new records in your extension (e.g.
      *     // `table.selectRecords()`) but they are still being saved to Airtable
      *     // servers (e.g. other users may not be able to see them yet.)
      * }
@@ -1805,7 +1805,7 @@ function (_AbstractModel) {
      *
      * This action is asynchronous. Unlike new records, new fields are **not** created
      * optimistically locally. You must `await` the returned promise before using the new
-     * field in your app.
+     * field in your extension.
      *
      * @param name name for the field. must be case-insensitive unique
      * @param type type for the field

package/dist/cjs/sdk.js

@@ -330,4 +330,4 @@ function () {
 }();
 
 exports.default = BlockSdk;
-(0, _defineProperty2.default)(BlockSdk, "VERSION", "1.11.1");
+(0, _defineProperty2.default)(BlockSdk, "VERSION", "1.12.0");

package/dist/cjs/settings_button.js

@@ -39,7 +39,7 @@ var WatchableSettingsButtonKeys = Object.freeze({
  */
 
 /**
- * Interface to the settings button that lives outside the app's viewport.
+ * Interface to the settings button that lives outside the extension's viewport.
  *
  * The {@link useSettingsButton} hook is the recommended way to use the settings button, but you can
  * also use it with {@link useWatchable} if you want more granular control (for example, to only

package/dist/cjs/ui/expand_record_picker_async.js

@@ -25,7 +25,7 @@ var _error_utils = require("../error_utils");
 
 /**
  * Expands a list of records in the Airtable UI, and prompts the user to pick
- * one. The selected record is returned to the app, and the modal is
+ * one. The selected record is returned to the extension, and the modal is
  * automatically closed.
  *
  * If the user dismisses the modal, or another one is opened before this one