@airtable/blocks 0.0.0-experimental-f52bc4e5e-20250709 → 0.0.0-experimental-3649c7162-20250904

package/dist/esm/shared/models/table_core.js

@@ -0,0 +1,1318 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.WatchableTableKeysCore = exports.TableCore = void 0;
+var _private_utils = require("../private_utils");
+var _error_utils = require("../error_utils");
+var _mutations_core = require("../types/mutations_core");
+var _abstract_model = _interopRequireDefault(require("./abstract_model"));
+var _field_core = require("./field_core");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// This doesn't follow our enum naming conventions because we want the keys
+// to mirror the method/getter names on the model class.
+const WatchableTableKeysCore = exports.WatchableTableKeysCore = Object.freeze({
+  name: 'name',
+  description: 'description',
+  fields: 'fields'
+});
+
+/** @hidden */
+
+/** @hidden */
+class TableCore extends _abstract_model.default {
+  /** @internal */
+  static _className = 'TableCore';
+  /** @internal */
+  static _isWatchableKey(key) {
+    return (0, _private_utils.isEnumValue)(WatchableTableKeysCore, key);
+  }
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /**
+   * @internal
+   */
+  constructor(parentBase, recordStore, tableId, sdk) {
+    super(sdk, tableId);
+    this._parentBase = parentBase;
+    this._recordStore = recordStore;
+    this._fieldModelsById = {}; // Field instances are lazily created by getFieldById.
+    this._cachedFieldNamesById = null;
+  }
+
+  /**
+   * @internal
+   */
+  get _dataOrNullIfDeleted() {
+    return this._baseData.tablesById[this._id] ?? null;
+  }
+  /**
+   * The base that this table belongs to.
+   *
+   * @internal (since we may not be able to return parent model instances in the immutable models world)
+   * @example
+   * ```js
+   * import {base} from '@airtable/blocks/base';
+   * const table = base.getTableByName('Table 1');
+   * console.log(table.parentBase.id === base.id);
+   * // => true
+   * ```
+   */
+  get parentBase() {
+    return this._parentBase;
+  }
+  /**
+   * The name of the table. Can be watched.
+   *
+   * @example
+   * ```js
+   * console.log(myTable.name);
+   * // => 'Table 1'
+   * ```
+   */
+  get name() {
+    return this._data.name;
+  }
+  /**
+   * The description of the table, if it has one. Can be watched.
+   *
+   * @example
+   * ```js
+   * console.log(myTable.description);
+   * // => 'This is my table'
+   * ```
+   */
+  get description() {
+    return this._data.description;
+  }
+  /**
+   * The table's primary field. Every table has exactly one primary
+   * field. The primary field of a table will not change.
+   *
+   * @example
+   * ```js
+   * console.log(myTable.primaryField.name);
+   * // => 'Name'
+   * ```
+   */
+  get primaryField() {
+    const primaryField = this.getFieldById(this._data.primaryFieldId);
+    return primaryField;
+  }
+  /**
+   * The fields in this table. The order is arbitrary, since fields are
+   * only ordered in the context of a specific view.
+   *
+   * Can be watched to know when fields are created or deleted.
+   *
+   * @example
+   * ```js
+   * console.log(`This table has ${myTable.fields.length} fields`);
+   * ```
+   */
+  get fields() {
+    // TODO(kasra): is it confusing that this returns an array, since the order
+    // is arbitrary?
+    // TODO(kasra): cache and freeze this so it isn't O(n)
+    const fields = [];
+    for (const fieldId of Object.keys(this._data.fieldsById)) {
+      const field = this.getFieldById(fieldId);
+      fields.push(field);
+    }
+    return fields;
+  }
+  /**
+   * Gets the field matching the given ID, or `null` if that field does not exist in this table.
+    * @param fieldId The ID of the field.
+   * @example
+   * ```js
+   * const fieldId = 'fldxxxxxxxxxxxxxx';
+   * const field = myTable.getFieldByIdIfExists(fieldId);
+   * if (field !== null) {
+   *     console.log(field.name);
+   * } else {
+   *     console.log('No field exists with that ID');
+   * }
+   * ```
+   */
+  getFieldByIdIfExists(fieldId) {
+    if (!this._data.fieldsById[fieldId]) {
+      return null;
+    } else {
+      if (!this._fieldModelsById[fieldId]) {
+        this._fieldModelsById[fieldId] = this._constructField(fieldId);
+      }
+      return this._fieldModelsById[fieldId];
+    }
+  }
+  /** @internal */
+
+  /**
+   * Gets the field matching the given ID. Throws if that field does not exist in this table. Use
+   * {@link getFieldByIdIfExists} instead if you are unsure whether a field exists with the given
+   * ID.
+   *
+   * @param fieldId The ID of the field.
+   * @example
+   * ```js
+   * const fieldId = 'fldxxxxxxxxxxxxxx';
+   * const field = myTable.getFieldById(fieldId);
+   * console.log(field.name);
+   * // => 'Name'
+   * ```
+   */
+  getFieldById(fieldId) {
+    const field = this.getFieldByIdIfExists(fieldId);
+    if (!field) {
+      throw (0, _error_utils.spawnError)("No field with ID %s in table '%s'", fieldId, this.name);
+    }
+    return field;
+  }
+  /**
+   * Gets the field matching the given name, or `null` if no field exists with that name in this
+   * table.
+   *
+   * @param fieldName The name of the field you're looking for.
+   * @example
+   * ```js
+   * const field = myTable.getFieldByNameIfExists('Name');
+   * if (field !== null) {
+   *     console.log(field.id);
+   * } else {
+   *     console.log('No field exists with that name');
+   * }
+   * ```
+   */
+  getFieldByNameIfExists(fieldName) {
+    for (const [fieldId, fieldData] of (0, _private_utils.entries)(this._data.fieldsById)) {
+      if (fieldData.name === fieldName) {
+        return this.getFieldByIdIfExists(fieldId);
+      }
+    }
+    return null;
+  }
+  /**
+   * Gets the field matching the given name. Throws if no field exists with that name in this
+   * table. Use {@link getFieldByNameIfExists} instead if you are unsure whether a field exists
+   * with the given name.
+   *
+   * @param fieldName The name of the field you're looking for.
+   * @example
+   * ```js
+   * const field = myTable.getFieldByName('Name');
+   * console.log(field.id);
+   * // => 'fldxxxxxxxxxxxxxx'
+   * ```
+   */
+  getFieldByName(fieldName) {
+    const field = this.getFieldByNameIfExists(fieldName);
+    if (!field) {
+      throw (0, _error_utils.spawnError)("No field named '%s' in table '%s'", fieldName, this.name);
+    }
+    return field;
+  }
+  /**
+   * 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 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.
+   */
+  getFieldIfExists(fieldIdOrName) {
+    return this.getFieldByIdIfExists(fieldIdOrName) ?? this.getFieldByNameIfExists(fieldIdOrName);
+  }
+  /**
+   * The field matching the given ID or name. Throws if no matching field exists within this table.
+   * Use {@link getFieldIfExists} instead if you are unsure whether a field exists with the given
+   * name/ID.
+   *
+   * 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.
+   */
+  getField(fieldIdOrName) {
+    const field = this.getFieldIfExists(fieldIdOrName);
+    if (!field) {
+      throw (0, _error_utils.spawnError)("No field with ID or name '%s' in table '%s'", fieldIdOrName, this.name);
+    }
+    return field;
+  }
+  /** @internal */
+  _cellValuesByFieldIdOrNameToCellValuesByFieldId(cellValuesByFieldIdOrName, onGenerateIdForNewForeignRecord) {
+    return Object.fromEntries((0, _private_utils.entries)(cellValuesByFieldIdOrName).map(_ref => {
+      let [fieldIdOrName, cellValue] = _ref;
+      const field = this.__getFieldMatching(fieldIdOrName);
+      return [field.id, this._adjustCellValueForFieldIfNecessary(field, cellValue, onGenerateIdForNewForeignRecord)];
+    }));
+  }
+  // This can be overridden by subclasses. See sdk/src/interface/models/table.ts.
+  /** @internal */
+  _adjustCellValueForFieldIfNecessary(field, cellValue, onGenerateIdForNewForeignRecord) {
+    return cellValue;
+  }
+  /**
+   * @internal
+   */
+  __getFieldMatching(fieldOrFieldIdOrFieldName) {
+    let field;
+    if (fieldOrFieldIdOrFieldName instanceof _field_core.FieldCore) {
+      if (fieldOrFieldIdOrFieldName.parentTable.id !== this.id) {
+        throw (0, _error_utils.spawnError)("Field '%s' is from a different table than table '%s'", fieldOrFieldIdOrFieldName.name, this.name);
+      }
+      field = fieldOrFieldIdOrFieldName;
+    } else {
+      field = this.getFieldByIdIfExists(fieldOrFieldIdOrFieldName) || this.getFieldByNameIfExists(fieldOrFieldIdOrFieldName);
+      if (field === null) {
+        throw (0, _error_utils.spawnError)("Field '%s' does not exist in table '%s'", fieldOrFieldIdOrFieldName, this.name);
+      }
+    }
+    if (field.isDeleted) {
+      throw (0, _error_utils.spawnError)("Field '%s' was deleted from table '%s'", field.name, this.name);
+    }
+    return field;
+  }
+
+  /**
+   * Updates cell values for a record.
+   *
+   * Throws an error if the user does not have permission to update the given cell values in
+   * the record, or if invalid input is provided (eg. invalid cell values).
+   *
+   * Refer to {@link FieldType} for cell value write formats.
+   *
+   * 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 extension
+   * before the promise resolves.
+   *
+   * @param recordOrRecordId the record to update
+   * @param fields cell values to update in that record, specified as object mapping `FieldId` or field name to value for that field.
+   * @example
+   * ```js
+   * function updateRecord(record, recordFields) {
+   *     if (table.hasPermissionToUpdateRecord(record, recordFields)) {
+   *         table.updateRecordAsync(record, recordFields);
+   *     }
+   *     // 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).
+   * }
+   *
+   * async function updateRecordAsync(record, recordFields) {
+   *     if (table.hasPermissionToUpdateRecord(record, recordFields)) {
+   *         await table.updateRecordAsync(record, recordFields);
+   *     }
+   *     // New record has been saved to Airtable servers.
+   *     alert(`record with ID ${record.id} has been updated`);
+   * }
+   *
+   * // Fields can be specified by name or ID
+   * updateRecord(record1, {
+   *     'Post Title': 'How to make: orange-mango pound cake',
+   *     'Publication Date': '2020-01-01',
+   * });
+   * updateRecord(record2, {
+   *     [postTitleField.id]: 'Cake decorating tips & tricks',
+   *     [publicationDateField.id]: '2020-02-02',
+   * });
+   *
+   * // Cell values should generally have format matching the output of
+   * // record.getCellValue() for the field being updated
+   * updateRecord(record1, {
+   *     'Category (single select)': {name: 'Recipe'},
+   *     'Tags (multiple select)': [{name: 'Desserts'}, {id: 'someChoiceId'}],
+   *     'Images (attachment)': [{url: 'http://mywebsite.com/cake.png'}],
+   *     'Related posts (linked records)': [{id: 'someRecordId'}],
+   * });
+   * ```
+   */
+  async updateRecordAsync(recordOrRecordId, fields) {
+    const recordId = typeof recordOrRecordId === 'string' ? recordOrRecordId : recordOrRecordId.id;
+    await this.updateRecordsAsync([{
+      id: recordId,
+      fields
+    }]);
+  }
+  /**
+   * Checks whether the current user has permission to perform the given record update.
+   *
+   * Accepts partial input, in the same format as {@link updateRecordAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * Returns `{hasPermission: true}` if the current user can update the specified record,
+   * `{hasPermission: false, reasonDisplayString: string}` otherwise. `reasonDisplayString` may be
+   * used to display an error message to the user.
+   *
+   * @param recordOrRecordId the record to update
+   * @param fields cell values to update in that record, specified as object mapping `FieldId` or field name to value for that field.
+   * @example
+   * ```js
+   * // Check if user can update specific fields for a specific record.
+   * const updateRecordCheckResult =
+   *     table.checkPermissionsForUpdateRecord(record, {
+   *         'Post Title': 'How to make: orange-mango pound cake',
+   *         'Publication Date': '2020-01-01',
+   *     });
+   * if (!updateRecordCheckResult.hasPermission) {
+   *     alert(updateRecordCheckResult.reasonDisplayString);
+   * }
+   *
+   * // Like updateRecordAsync, you can use either field names or field IDs.
+   * const updateRecordCheckResultWithFieldIds =
+   *     table.checkPermissionsForUpdateRecord(record, {
+   *         [postTitleField.id]: 'Cake decorating tips & tricks',
+   *         [publicationDateField.id]: '2020-02-02',
+   *     });
+   *
+   * // Check if user could update a given record, when you don't know the
+   * // specific fields that will be updated yet (e.g. to check whether you should
+   * // allow a user to select a certain record to update).
+   * const updateUnknownFieldsCheckResult =
+   *     table.checkPermissionsForUpdateRecord(record);
+   *
+   * // 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 extension can write to it).
+   * const updateUnknownRecordCheckResult =
+   *     table.checkPermissionsForUpdateRecord(undefined, {
+   *         'My field name': 'updated value',
+   *         // You can use undefined if you know you're going to update a field,
+   *         // but don't know the new cell value yet.
+   *         'Another field name': undefined,
+   *     });
+   *
+   * // 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
+   * // extension in "read only" mode).
+   * const updateUnknownRecordAndFieldsCheckResult =
+   *     table.checkPermissionsForUpdateRecord();
+   * ```
+   */
+  checkPermissionsForUpdateRecord(recordOrRecordId, fields) {
+    const recordId = typeof recordOrRecordId === 'object' && recordOrRecordId !== null ? recordOrRecordId.id : recordOrRecordId;
+    return this.checkPermissionsForUpdateRecords([{
+      id: recordId,
+      fields
+    }]);
+  }
+  /**
+   * An alias for `checkPermissionsForUpdateRecord(recordOrRecordId, fields).hasPermission`.
+   *
+   * Checks whether the current user has permission to perform the given record update.
+   *
+   * Accepts partial input, in the same format as {@link updateRecordAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * @param recordOrRecordId the record to update
+   * @param fields cell values to update in that record, specified as object mapping `FieldId` or field name to value for that field.
+   * @example
+   * ```js
+   * // Check if user can update specific fields for a specific record.
+   * const canUpdateRecord = table.hasPermissionToUpdateRecord(record, {
+   *     'Post Title': 'How to make: orange-mango pound cake',
+   *     'Publication Date': '2020-01-01',
+   * });
+   * if (!canUpdateRecord) {
+   *     alert('not allowed!');
+   * }
+   *
+   * // Like updateRecordAsync, you can use either field names or field IDs.
+   * const canUpdateRecordWithFieldIds =
+   *     table.hasPermissionToUpdateRecord(record, {
+   *         [postTitleField.id]: 'Cake decorating tips & tricks',
+   *         [publicationDateField.id]: '2020-02-02',
+   *     });
+   *
+   * // Check if user could update a given record, when you don't know the
+   * // specific fields that will be updated yet (e.g. to check whether you should
+   * // allow a user to select a certain record to update).
+   * const canUpdateUnknownFields = table.hasPermissionToUpdateRecord(record);
+   *
+   * // 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 extension can write to it).
+   * const canUpdateUnknownRecord =
+   *     table.hasPermissionToUpdateRecord(undefined, {
+   *         'My field name': 'updated value',
+   *         // You can use undefined if you know you're going to update a field,
+   *         // but don't know the new cell value yet.
+   *         'Another field name': undefined,
+   *     });
+   *
+   * // 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 extension in "read only" mode)
+   * const canUpdateUnknownRecordAndFields = table.hasPermissionToUpdateRecord();
+   * ```
+   */
+  hasPermissionToUpdateRecord(recordOrRecordId, fields) {
+    return this.checkPermissionsForUpdateRecord(recordOrRecordId, fields).hasPermission;
+  }
+  /**
+   * Updates cell values for records.
+   *
+   * Throws an error if the user does not have permission to update the given cell values in
+   * the records, or if invalid input is provided (eg. invalid cell values).
+   *
+   * Refer to {@link FieldType} for cell value write formats.
+   *
+   * You may only update up to 50 records in one call to `updateRecordsAsync`.
+   * See [Write back to Airtable](/guides/write-back-to-airtable) for more information
+   * about write limits.
+   *
+   * 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 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)
+   * @example
+   * ```js
+   * const recordsToUpdate = [
+   *     // Fields can be specified by name or ID
+   *     {
+   *         id: record1.id,
+   *         fields: {
+   *             'Post Title': 'How to make: orange-mango pound cake',
+   *             'Publication Date': '2020-01-01',
+   *         },
+   *     },
+   *     {
+   *         id: record2.id,
+   *         fields: {
+   *             // Sets the cell values to be empty.
+   *             'Post Title': '',
+   *             'Publication Date': '',
+   *         },
+   *     },
+   *     {
+   *         id: record3.id,
+   *         fields: {
+   *             [postTitleField.id]: 'Cake decorating tips & tricks',
+   *             [publicationDateField.id]: '2020-02-02',
+   *         },
+   *     },
+   *     // Cell values should generally have format matching the output of
+   *     // record.getCellValue() for the field being updated
+   *     {
+   *         id: record4.id,
+   *         fields: {
+   *             'Category (single select)': {name: 'Recipe'},
+   *             'Tags (multiple select)': [{name: 'Desserts'}, {id: 'choiceId'}],
+   *             'Images (attachment)': [{url: 'http://mywebsite.com/cake.png'}],
+   *             'Related posts (linked records)': [{id: 'someRecordId'}],
+   *         },
+   *     },
+   * ];
+   *
+   * function updateRecords() {
+   *     if (table.hasPermissionToUpdateRecords(recordsToUpdate)) {
+   *         table.updateRecordsAsync(recordsToUpdate);
+   *     }
+   *     // 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).
+   * }
+   *
+   * async function updateRecordsAsync() {
+   *     if (table.hasPermissionToUpdateRecords(recordsToUpdate)) {
+   *         await table.updateRecordsAsync(recordsToUpdate);
+   *     }
+   *     // Record updates have been saved to Airtable servers.
+   *     alert('records have been updated');
+   * }
+   * ```
+   */
+  async updateRecordsAsync(records) {
+    let includesForeignRowsThatShouldBeCreated = false;
+    const recordsWithCellValuesByFieldId = records.map(record => ({
+      id: record.id,
+      cellValuesByFieldId: this._cellValuesByFieldIdOrNameToCellValuesByFieldId(record.fields, () => {
+        includesForeignRowsThatShouldBeCreated = true;
+      })
+    }));
+    await this._sdk.__mutations.applyMutationAsync({
+      type: _mutations_core.MutationTypesCore.SET_MULTIPLE_RECORDS_CELL_VALUES,
+      tableId: this.id,
+      records: recordsWithCellValuesByFieldId,
+      opts: {
+        parseDateCellValueInColumnTimeZone: true,
+        includesForeignRowsThatShouldBeCreated
+      }
+    });
+  }
+  /**
+   * Checks whether the current user has permission to perform the given record updates.
+   *
+   * Accepts partial input, in the same format as {@link updateRecordsAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * Returns `{hasPermission: true}` if the current user can update the specified records,
+   * `{hasPermission: false, reasonDisplayString: string}` otherwise. `reasonDisplayString` may be
+   * used to display an error message to the user.
+   *
+   * @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)
+   * @example
+   * ```js
+   * const recordsToUpdate = [
+   *     {
+   *         // Validating a complete record update
+   *         id: record1.id,
+   *         fields: {
+   *             'Post Title': 'How to make: orange-mango pound cake',
+   *             'Publication Date': '2020-01-01',
+   *         },
+   *     },
+   *     {
+   *         // Like updateRecordsAsync, fields can be specified by name or ID
+   *         id: record2.id,
+   *         fields: {
+   *             [postTitleField.id]: 'Cake decorating tips & tricks',
+   *             [publicationDateField.id]: '2020-02-02',
+   *         },
+   *     },
+   *     {
+   *         // Validating an update to a specific record, not knowing what
+   *         // fields will be updated
+   *         id: record3.id,
+   *     },
+   *     {
+   *         // Validating an update to specific cell values, not knowing what
+   *         // record will be updated
+   *         fields: {
+   *             'My field name': 'updated value for unknown record',
+   *             // You can use undefined if you know you're going to update a
+   *             // field, but don't know the new cell value yet.
+   *             'Another field name': undefined,
+   *         },
+   *     },
+   * ];
+   *
+   * const updateRecordsCheckResult =
+   *     table.checkPermissionsForUpdateRecords(recordsToUpdate);
+   * if (!updateRecordsCheckResult.hasPermission) {
+   *     alert(updateRecordsCheckResult.reasonDisplayString);
+   * }
+   *
+   * // Check if user could potentially update records.
+   * // Equivalent to table.checkPermissionsForUpdateRecord()
+   * const updateUnknownRecordAndFieldsCheckResult =
+   *     table.checkPermissionsForUpdateRecords();
+   * ```
+   */
+  checkPermissionsForUpdateRecords(records) {
+    let includesForeignRowsThatShouldBeCreated = false;
+    const recordsWithCellValuesByFieldId = records ? records.map(record => ({
+      id: record.id || undefined,
+      cellValuesByFieldId: record.fields ? this._cellValuesByFieldIdOrNameToCellValuesByFieldId(record.fields, () => {
+        includesForeignRowsThatShouldBeCreated = true;
+      }) : undefined
+    })) : undefined;
+    return this._sdk.__mutations.checkPermissionsForMutation({
+      type: _mutations_core.MutationTypesCore.SET_MULTIPLE_RECORDS_CELL_VALUES,
+      tableId: this.id,
+      records: recordsWithCellValuesByFieldId,
+      opts: {
+        parseDateCellValueInColumnTimeZone: true,
+        includesForeignRowsThatShouldBeCreated
+      }
+    });
+  }
+  /**
+   * An alias for `checkPermissionsForUpdateRecords(records).hasPermission`.
+   *
+   * Checks whether the current user has permission to perform the given record updates.
+   *
+   * Accepts partial input, in the same format as {@link updateRecordsAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * @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)
+   * @example
+   * ```js
+   * const recordsToUpdate = [
+   *     {
+   *         // Validating a complete record update
+   *         id: record1.id,
+   *         fields: {
+   *             'Post Title': 'How to make: orange-mango pound cake',
+   *             'Publication Date': '2020-01-01',
+   *         },
+   *     },
+   *     {
+   *         // Like updateRecordsAsync, fields can be specified by name or ID
+   *         id: record2.id,
+   *         fields: {
+   *             [postTitleField.id]: 'Cake decorating tips & tricks',
+   *             [publicationDateField.id]: '2020-02-02',
+   *         },
+   *     },
+   *     {
+   *         // Validating an update to a specific record, not knowing what
+   *         // fields will be updated
+   *         id: record3.id,
+   *     },
+   *     {
+   *         // Validating an update to specific cell values, not knowing what
+   *         // record will be updated
+   *         fields: {
+   *             'My field name': 'updated value for unknown record',
+   *             // You can use undefined if you know you're going to update a
+   *             // field, but don't know the new cell value yet.
+   *             'Another field name': undefined,
+   *         },
+   *     },
+   * ];
+   *
+   * const canUpdateRecords = table.hasPermissionToUpdateRecords(recordsToUpdate);
+   * if (!canUpdateRecords) {
+   *     alert('not allowed');
+   * }
+   *
+   * // Check if user could potentially update records.
+   * // Equivalent to table.hasPermissionToUpdateRecord()
+   * const canUpdateUnknownRecordsAndFields =
+   *     table.hasPermissionToUpdateRecords();
+   * ```
+   */
+  hasPermissionToUpdateRecords(records) {
+    return this.checkPermissionsForUpdateRecords(records).hasPermission;
+  }
+  /**
+   * Delete the given record.
+   *
+   * Throws an error if the user does not have permission to delete the given record.
+   *
+   * 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 extension
+   * before the promise resolves.
+   *
+   * @param recordOrRecordId the record to be deleted
+   * @example
+   * ```js
+   * function deleteRecord(record) {
+   *     if (table.hasPermissionToDeleteRecord(record)) {
+   *         table.deleteRecordAsync(record);
+   *     }
+   *     // 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).
+   * }
+   *
+   * async function deleteRecordAsync(record) {
+   *     if (table.hasPermissionToDeleteRecord(record)) {
+   *         await table.deleteRecordAsync(record);
+   *     }
+   *     // Record deletion has been saved to Airtable servers.
+   *     alert('record has been deleted');
+   * }
+   * ```
+   */
+  async deleteRecordAsync(recordOrRecordId) {
+    await this.deleteRecordsAsync([recordOrRecordId]);
+  }
+  /**
+   * Checks whether the current user has permission to delete the specified record.
+   *
+   * Accepts optional input, in the same format as {@link deleteRecordAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * Returns `{hasPermission: true}` if the current user can delete the specified record,
+   * `{hasPermission: false, reasonDisplayString: string}` otherwise. `reasonDisplayString` may be
+   * used to display an error message to the user.
+   *
+   * @param recordOrRecordId the record to be deleted
+   * @example
+   * ```js
+   * // Check if user can delete a specific record
+   * const deleteRecordCheckResult =
+   *     table.checkPermissionsForDeleteRecord(record);
+   * if (!deleteRecordCheckResult.hasPermission) {
+   *     alert(deleteRecordCheckResult.reasonDisplayString);
+   * }
+   *
+   * // Check if user could potentially delete a record.
+   * // Use when you don't know the specific record you want to delete yet (for
+   * // example, to show/hide UI controls that let you select a record to delete).
+   * const deleteUnknownRecordCheckResult =
+   *     table.checkPermissionsForDeleteRecord();
+   * ```
+   */
+  checkPermissionsForDeleteRecord(recordOrRecordId) {
+    return this.checkPermissionsForDeleteRecords(recordOrRecordId ? [recordOrRecordId] : undefined);
+  }
+  /**
+   * An alias for `checkPermissionsForDeleteRecord(recordOrRecordId).hasPermission`.
+   *
+   * Checks whether the current user has permission to delete the specified record.
+   *
+   * Accepts optional input, in the same format as {@link deleteRecordAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * @param recordOrRecordId the record to be deleted
+   * @example
+   * ```js
+   * // Check if user can delete a specific record
+   * const canDeleteRecord = table.hasPermissionToDeleteRecord(record);
+   * if (!canDeleteRecord) {
+   *     alert('not allowed');
+   * }
+   *
+   * // Check if user could potentially delete a record.
+   * // Use when you don't know the specific record you want to delete yet (for
+   * // example, to show/hide UI controls that let you select a record to delete).
+   * const canDeleteUnknownRecord = table.hasPermissionToDeleteRecord();
+   * ```
+   */
+  hasPermissionToDeleteRecord(recordOrRecordId) {
+    return this.checkPermissionsForDeleteRecord(recordOrRecordId).hasPermission;
+  }
+  /**
+   * Delete the given records.
+   *
+   * Throws an error if the user does not have permission to delete the given records.
+   *
+   * You may only delete up to 50 records in one call to `deleteRecordsAsync`.
+   * See [Write back to Airtable](/guides/write-back-to-airtable#size-limits-rate-limits) for
+   * more information about write limits.
+   *
+   * 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 extension
+   * before the promise resolves.
+   *
+   * @param recordsOrRecordIds Array of Records and RecordIds
+   * @example
+   * ```js
+   *
+   * function deleteRecords(records) {
+   *     if (table.hasPermissionToDeleteRecords(records)) {
+   *         table.deleteRecordsAsync(records);
+   *     }
+   *     // 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).
+   * }
+   *
+   * async function deleteRecordsAsync(records) {
+   *     if (table.hasPermissionToDeleteRecords(records)) {
+   *         await table.deleteRecordsAsync(records);
+   *     }
+   *     // Record deletions have been saved to Airtable servers.
+   *     alert('records have been deleted');
+   * }
+   * ```
+   */
+  async deleteRecordsAsync(recordsOrRecordIds) {
+    const recordIds = recordsOrRecordIds.map(recordOrRecordId => typeof recordOrRecordId === 'string' ? recordOrRecordId : recordOrRecordId.id);
+    await this._sdk.__mutations.applyMutationAsync({
+      type: _mutations_core.MutationTypesCore.DELETE_MULTIPLE_RECORDS,
+      tableId: this.id,
+      recordIds
+    });
+  }
+  /**
+   * Checks whether the current user has permission to delete the specified records.
+   *
+   * Accepts optional input, in the same format as {@link deleteRecordsAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * Returns `{hasPermission: true}` if the current user can delete the specified records,
+   * `{hasPermission: false, reasonDisplayString: string}` otherwise. `reasonDisplayString` may be
+   * used to display an error message to the user.
+   *
+   * @param recordsOrRecordIds the records to be deleted
+   * @example
+   * ```js
+   * // Check if user can delete specific records
+   * const deleteRecordsCheckResult =
+   *     table.checkPermissionsForDeleteRecords([record1, record2]);
+   * if (!deleteRecordsCheckResult.hasPermission) {
+   *     alert(deleteRecordsCheckResult.reasonDisplayString);
+   * }
+   *
+   * // Check if user could potentially delete records.
+   * // Use when you don't know the specific records you want to delete yet (for
+   * // example, to show/hide UI controls that let you select records to delete).
+   * // Equivalent to table.hasPermissionToDeleteRecord()
+   * const deleteUnknownRecordsCheckResult =
+   *     table.checkPermissionsForDeleteRecords();
+   * ```
+   */
+  checkPermissionsForDeleteRecords(recordsOrRecordIds) {
+    return this._sdk.__mutations.checkPermissionsForMutation({
+      type: _mutations_core.MutationTypesCore.DELETE_MULTIPLE_RECORDS,
+      tableId: this.id,
+      recordIds: recordsOrRecordIds ? recordsOrRecordIds.map(recordOrRecordId => typeof recordOrRecordId === 'string' ? recordOrRecordId : recordOrRecordId.id) : undefined
+    });
+  }
+  /**
+   * An alias for `checkPermissionsForDeleteRecords(recordsOrRecordIds).hasPermission`.
+   *
+   * Checks whether the current user has permission to delete the specified records.
+   *
+   * Accepts optional input, in the same format as {@link deleteRecordsAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * @param recordsOrRecordIds the records to be deleted
+   * @example
+   * ```js
+   * // Check if user can delete specific records
+   * const canDeleteRecords =
+   *     table.hasPermissionToDeleteRecords([record1, record2]);
+   * if (!canDeleteRecords) {
+   *     alert('not allowed!');
+   * }
+   *
+   * // Check if user could potentially delete records.
+   * // Use when you don't know the specific records you want to delete yet (for
+   * // example, to show/hide UI controls that let you select records to delete).
+   * // Equivalent to table.hasPermissionToDeleteRecord()
+   * const canDeleteUnknownRecords = table.hasPermissionToDeleteRecords();
+   * ```
+   */
+  hasPermissionToDeleteRecords(recordsOrRecordIds) {
+    return this.checkPermissionsForDeleteRecords(recordsOrRecordIds).hasPermission;
+  }
+
+  /**
+   * Creates a new record with the specified cell values.
+   *
+   * Throws an error if the user does not have permission to create the given records, or
+   * if invalid input is provided (eg. invalid cell values).
+   *
+   * Refer to {@link FieldType} for cell value write formats.
+   *
+   * 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 extension
+   * before the promise resolves.
+   *
+   * The returned promise will resolve to the RecordId of the new record once it is persisted.
+   *
+   * @param fields object mapping `FieldId` or field name to value for that field.
+   * @example
+   * ```js
+   * function createNewRecord(recordFields) {
+   *     if (table.hasPermissionToCreateRecord(recordFields)) {
+   *         table.createRecordAsync(recordFields);
+   *     }
+   *     // 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).
+   * }
+   *
+   * async function createNewRecordAsync(recordFields) {
+   *     if (table.hasPermissionToCreateRecord(recordFields)) {
+   *         const newRecordId = await table.createRecordAsync(recordFields);
+   *     }
+   *     // New record has been saved to Airtable servers.
+   *     alert(`new record with ID ${newRecordId} has been created`);
+   * }
+   *
+   * // Fields can be specified by name or ID
+   * createNewRecord({
+   *     'Project Name': 'Advertising campaign',
+   *     'Budget': 100,
+   * });
+   * createNewRecord({
+   *     [projectNameField.id]: 'Cat video',
+   *     [budgetField.id]: 200,
+   * });
+   *
+   * // Cell values should generally have format matching the output of
+   * // record.getCellValue() for the field being updated
+   * createNewRecord({
+   *     'Project Name': 'Cat video 2'
+   *     'Category (single select)': {name: 'Video'},
+   *     'Tags (multiple select)': [{name: 'Cats'}, {id: 'someChoiceId'}],
+   *     'Assets (attachment)': [{url: 'http://mywebsite.com/cats.mp4'}],
+   *     'Related projects (linked records)': [{id: 'someRecordId'}],
+   * });
+   * ```
+   */
+  async createRecordAsync() {
+    let fields = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+    const recordIds = await this.createRecordsAsync([{
+      fields
+    }]);
+    return recordIds[0];
+  }
+
+  /**
+   * Checks whether the current user has permission to create the specified record.
+   *
+   * Accepts partial input, in the same format as {@link createRecordAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * Returns `{hasPermission: true}` if the current user can create the specified record,
+   * `{hasPermission: false, reasonDisplayString: string}` otherwise. `reasonDisplayString` may be
+   * used to display an error message to the user.
+   *
+   * @param fields object mapping `FieldId` or field name to value for that field.
+   * @example
+   * ```js
+   * // Check if user can create a specific record, when you already know what
+   * // fields/cell values will be set for the record.
+   * const createRecordCheckResult = table.checkPermissionsForCreateRecord({
+   *     'Project Name': 'Advertising campaign',
+   *     'Budget': 100,
+   * });
+   * if (!createRecordCheckResult.hasPermission) {
+   *     alert(createRecordCheckResult.reasonDisplayString);
+   * }
+   *
+   * // Like createRecordAsync, you can use either field names or field IDs.
+   * const checkResultWithFieldIds = table.checkPermissionsForCreateRecord({
+   *     [projectNameField.id]: 'Cat video',
+   *     [budgetField.id]: 200,
+   * });
+   *
+   * // Check if user could potentially create a record.
+   * // Use when you don't know the specific fields/cell values yet (for example,
+   * // to show or hide UI controls that let you start creating a record.)
+   * const createUnknownRecordCheckResult =
+   *     table.checkPermissionsForCreateRecord();
+   * ```
+   */
+  checkPermissionsForCreateRecord(fields) {
+    return this.checkPermissionsForCreateRecords([{
+      fields: fields || undefined
+    }]);
+  }
+  /**
+   * An alias for `checkPermissionsForCreateRecord(fields).hasPermission`.
+   *
+   * Checks whether the current user has permission to create the specified record.
+   *
+   * Accepts partial input, in the same format as {@link createRecordAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * @param fields object mapping `FieldId` or field name to value for that field.
+   * @example
+   * ```js
+   * // Check if user can create a specific record, when you already know what
+   * // fields/cell values will be set for the record.
+   * const canCreateRecord = table.hasPermissionToCreateRecord({
+   *     'Project Name': 'Advertising campaign',
+   *     'Budget': 100,
+   * });
+   * if (!canCreateRecord) {
+   *     alert('not allowed!');
+   * }
+   *
+   * // Like createRecordAsync, you can use either field names or field IDs.
+   * const canCreateRecordWithFieldIds = table.hasPermissionToCreateRecord({
+   *     [projectNameField.id]: 'Cat video',
+   *     [budgetField.id]: 200,
+   * });
+   *
+   * // Check if user could potentially create a record.
+   * // Use when you don't know the specific fields/cell values yet (for example,
+   * // to show or hide UI controls that let you start creating a record.)
+   * const canCreateUnknownRecord = table.hasPermissionToCreateRecord();
+   * ```
+   */
+  hasPermissionToCreateRecord(fields) {
+    return this.checkPermissionsForCreateRecord(fields).hasPermission;
+  }
+  /**
+   * Creates new records with the specified cell values.
+   *
+   * Throws an error if the user does not have permission to create the given records, or
+   * if invalid input is provided (eg. invalid cell values).
+   *
+   * Refer to {@link FieldType} for cell value write formats.
+   *
+   * You may only create up to 50 records in one call to `createRecordsAsync`.
+   * See [Write back to Airtable](/guides/write-back-to-airtable#size-limits-rate-limits) for
+   * more information about write limits.
+   *
+   * 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 extension
+   * before the promise resolves.
+   *
+   * The returned promise will resolve to an array of RecordIds of the new records once the new
+   * records are persisted.
+   *
+   * @param records Array of objects with a `fields` key mapping `FieldId` or field name to value for that field.
+   * @example
+   * ```js
+   * const recordDefs = [
+   *     // Fields can be specified by name or ID
+   *     {
+   *          fields: {
+   *              'Project Name': 'Advertising campaign',
+   *              'Budget': 100,
+   *          },
+   *     },
+   *     {
+   *          fields: {
+   *              [projectNameField.id]: 'Cat video',
+   *              [budgetField.id]: 200,
+   *          },
+   *     },
+   *     // Specifying no fields will create a new record with no cell values set
+   *     {
+   *          fields: {},
+   *     },
+   *     // Cell values should generally have format matching the output of
+   *     // record.getCellValue() for the field being updated
+   *     {
+   *          fields: {
+   *              'Project Name': 'Cat video 2'
+   *              'Category (single select)': {name: 'Video'},
+   *              'Tags (multiple select)': [{name: 'Cats'}, {id: 'choiceId'}],
+   *              'Assets (attachment)': [{url: 'http://mywebsite.com/cats.mp4'}],
+   *              'Related projects (linked records)': [{id: 'someRecordId'}],
+   *          },
+   *     },
+   * ];
+   *
+   * function createNewRecords() {
+   *     if (table.hasPermissionToCreateRecords(recordDefs)) {
+   *         table.createRecordsAsync(recordDefs);
+   *     }
+   *     // 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.)
+   * }
+   *
+   * async function createNewRecordsAsync() {
+   *     if (table.hasPermissionToCreateRecords(recordDefs)) {
+   *         const newRecordIds = await table.createRecordsAsync(recordDefs);
+   *     }
+   *     // New records have been saved to Airtable servers.
+   *     alert(`new records with IDs ${newRecordIds} have been created`);
+   * }
+   * ```
+   */
+  async createRecordsAsync(records) {
+    let includesForeignRowsThatShouldBeCreated = false;
+    const recordsToCreate = records.map(recordDef => {
+      const recordDefKeys = (0, _private_utils.keys)(recordDef);
+      let fields;
+      if (recordDefKeys.length === 1 && recordDefKeys[0] === 'fields') {
+        fields = recordDef.fields;
+      } else {
+        throw (0, _error_utils.spawnError)('Invalid record format. Please define field mappings using a `fields` key for each record definition object');
+      }
+      return {
+        id: this._sdk.__airtableInterface.idGenerator.generateRecordId(),
+        cellValuesByFieldId: this._cellValuesByFieldIdOrNameToCellValuesByFieldId(fields, () => {
+          includesForeignRowsThatShouldBeCreated = true;
+        })
+      };
+    });
+    await this._sdk.__mutations.applyMutationAsync({
+      type: _mutations_core.MutationTypesCore.CREATE_MULTIPLE_RECORDS,
+      tableId: this.id,
+      records: recordsToCreate,
+      opts: {
+        parseDateCellValueInColumnTimeZone: true,
+        includesForeignRowsThatShouldBeCreated
+      }
+    });
+    return recordsToCreate.map(record => record.id);
+  }
+  /**
+   * Checks whether the current user has permission to create the specified records.
+   *
+   * Accepts partial input, in the same format as {@link createRecordsAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * Returns `{hasPermission: true}` if the current user can create the specified records,
+   * `{hasPermission: false, reasonDisplayString: string}` otherwise. `reasonDisplayString` may be
+   * used to display an error message to the user.
+   *
+   * @param records Array of objects mapping `FieldId` or field name to value for that field.
+   * @example
+   * ```js
+   * // Check if user can create specific records, when you already know what
+   * // fields/cell values will be set for the records.
+   * const createRecordsCheckResult = table.checkPermissionsForCreateRecords([
+   *     // Like createRecordsAsync, fields can be specified by name or ID
+   *     {
+   *          fields: {
+   *              'Project Name': 'Advertising campaign',
+   *              'Budget': 100,
+   *          },
+   *     },
+   *     {
+   *          fields: {
+   *              [projectNameField.id]: 'Cat video',
+   *              [budgetField.id]: 200,
+   *          },
+   *     },
+   *     {},
+   * ]);
+   * if (!createRecordsCheckResult.hasPermission) {
+   *     alert(createRecordsCheckResult.reasonDisplayString);
+   * }
+   *
+   * // Check if user could potentially create records.
+   * // Use when you don't know the specific fields/cell values yet (for example,
+   * // to show or hide UI controls that let you start creating records.)
+   * // Equivalent to table.checkPermissionsForCreateRecord()
+   * const createUnknownRecordCheckResult =
+   *     table.checkPermissionsForCreateRecords();
+   * ```
+   */
+  checkPermissionsForCreateRecords(records) {
+    let includesForeignRowsThatShouldBeCreated = false;
+    const recordsWithCellValuesByFieldId = records ? records.map(record => ({
+      id: undefined,
+      cellValuesByFieldId: record.fields ? this._cellValuesByFieldIdOrNameToCellValuesByFieldId(record.fields, () => {
+        includesForeignRowsThatShouldBeCreated = true;
+      }) : undefined
+    })) : undefined;
+    return this._sdk.__mutations.checkPermissionsForMutation({
+      type: _mutations_core.MutationTypesCore.CREATE_MULTIPLE_RECORDS,
+      tableId: this.id,
+      records: recordsWithCellValuesByFieldId,
+      opts: {
+        parseDateCellValueInColumnTimeZone: true,
+        includesForeignRowsThatShouldBeCreated
+      }
+    });
+  }
+  /**
+   * An alias for `checkPermissionsForCreateRecords(records).hasPermission`.
+   *
+   * Checks whether the current user has permission to create the specified records.
+   *
+   * Accepts partial input, in the same format as {@link createRecordsAsync}.
+   * The more information provided, the more accurate the permissions check will be.
+   *
+   * @param records Array of objects mapping `FieldId` or field name to value for that field.
+   * @example
+   * ```js
+   * // Check if user can create specific records, when you already know what fields/cell values
+   * // will be set for the records.
+   * const canCreateRecords = table.hasPermissionToCreateRecords([
+   *     // Like createRecordsAsync, fields can be specified by name or ID
+   *     {
+   *          fields: {
+   *              'Project Name': 'Advertising campaign',
+   *              'Budget': 100,
+   *          }
+   *     },
+   *     {
+   *          fields: {
+   *              [projectNameField.id]: 'Cat video',
+   *              [budgetField.id]: 200,
+   *          }
+   *     },
+   *     {},
+   * ]);
+   * if (!canCreateRecords) {
+   *     alert('not allowed');
+   * }
+   *
+   * // Check if user could potentially create records.
+   * // Use when you don't know the specific fields/cell values yet (for example,
+   * // to show or hide UI controls that let you start creating records).
+   * // Equivalent to table.hasPermissionToCreateRecord()
+   * const canCreateUnknownRecords = table.hasPermissionToCreateRecords();
+   * ```
+   */
+  hasPermissionToCreateRecords(records) {
+    return this.checkPermissionsForCreateRecords(records).hasPermission;
+  }
+
+  /**
+   * @internal
+   */
+  __triggerOnChangeForDirtyPaths(dirtyPaths) {
+    let didTableSchemaChange = false;
+    if (dirtyPaths.name) {
+      this._onChange(WatchableTableKeysCore.name);
+      didTableSchemaChange = true;
+    }
+    if (dirtyPaths.lock) {
+      didTableSchemaChange = true;
+    }
+    if (dirtyPaths.externalSyncById) {
+      didTableSchemaChange = true;
+    }
+    if (dirtyPaths.description) {
+      this._onChange(WatchableTableKeysCore.description);
+      didTableSchemaChange = true;
+    }
+    if (dirtyPaths.fieldsById) {
+      // TODO: don't trigger schema change when autonumber typeOptions change.
+      // That currently happens every time you create a row in a table with an
+      // autonumber field.
+      didTableSchemaChange = true;
+
+      // Since tables don't have a field order, need to detect if a field
+      // was created or deleted and trigger onChange for fields.
+      const addedFieldIds = [];
+      const removedFieldIds = [];
+      for (const [fieldId, dirtyFieldPaths] of (0, _private_utils.entries)(dirtyPaths.fieldsById)) {
+        if (dirtyFieldPaths && dirtyFieldPaths._isDirty) {
+          // If the entire field is dirty, it was either created or deleted.
+          if ((0, _private_utils.has)(this._data.fieldsById, fieldId)) {
+            addedFieldIds.push(fieldId);
+          } else {
+            removedFieldIds.push(fieldId);
+            const fieldModel = this._fieldModelsById[fieldId];
+            if (fieldModel) {
+              // Remove the Field model if it was deleted.
+              delete this._fieldModelsById[fieldId];
+            }
+          }
+        } else {
+          // Directly access from _fieldModelsById to avoid creating
+          // a field model if it doesn't already exist. If it doesn't exist,
+          // nothing can be subscribed to any events on it.
+          const field = this._fieldModelsById[fieldId];
+          if (field) {
+            field.__triggerOnChangeForDirtyPaths(dirtyFieldPaths);
+          }
+        }
+      }
+      if (addedFieldIds.length > 0 || removedFieldIds.length > 0) {
+        this._onChange(WatchableTableKeysCore.fields, {
+          addedFieldIds,
+          removedFieldIds
+        });
+      }
+
+      // Clear out cached field names in case a field was added/removed/renamed.
+      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;
+  }
+  /**
+   * @internal
+   */
+  __getFieldNamesById() {
+    if (!this._cachedFieldNamesById) {
+      const fieldNamesById = {};
+      for (const [fieldId, fieldData] of (0, _private_utils.entries)(this._data.fieldsById)) {
+        fieldNamesById[fieldId] = fieldData.name;
+      }
+      this._cachedFieldNamesById = fieldNamesById;
+    }
+    return this._cachedFieldNamesById;
+  }
+}
+exports.TableCore = TableCore;