@airtable/blocks 1.11.1-experimental-68738f2-20220526 → 1.13.0

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
@@ -2024,11 +2024,7 @@ function (_AbstractModel) {
               if (didViewSchemaChange) {
                 didTableSchemaChange = true;
               }
-            } // We must directly trigger deletions on the recordStore.viewDataStore
-            // because the viewModel might not have been created. (See above comment)
-
-
-            this._recordStore.sendViewDataDeletionIfViewIsDeleted(_viewId);
+            }
           }
         } catch (err) {
           _didIteratorError4 = true;
@@ -2113,7 +2109,11 @@ function (_AbstractModel) {
 
 
         this._cachedFieldNamesById = null;
-      }
+      } // NOTE: Record store onChange triggers must be performed AFTER field onChange triggers to
+      // ensure the column type providers are not stale.
+
+
+      this._recordStore.triggerOnChangeForDirtyPaths(dirtyPaths);
 
       return didTableSchemaChange;
     }