@baselift/blocks-testing 0.0.1

package/dist/types/src/mock_airtable_interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock_airtable_interface.d.ts","sourceRoot":"","sources":["../../../src/mock_airtable_interface.ts"],"names":[],"mappings":"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"}

package/dist/types/src/private_utils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Allows creating an object map type with a dynamic key type.
+ *
+ * TypeScript only allows `string` for `K` in `{[key: K]: V}` so we need a utility to bridge
+ * the gap.
+ *
+ * This is an alias for TypeScript’s `Record` type, but the name “record” is confusing given our
+ * Airtable domain model.
+ *
+ * @hidden
+ */
+export type ObjectMap<K extends keyof any, V> = {
+    [P in K]: V;
+};
+/**
+ * @hidden
+ */
+export declare function cloneDeep<T extends unknown>(obj: T): T;
+/**
+ * @hidden
+ */
+export declare function has<T extends object>(obj: T, key: keyof any): key is keyof T;
+/**
+ * @hidden
+ */
+export declare function keyBy<Item, Key extends string>(array: ReadonlyArray<Item>, getKey: (arg1: Item) => Key): ObjectMap<Key, Item>;
+/**
+ * @hidden
+ */
+export declare function getId({ id }: {
+    id: string;
+}): string;
+//# sourceMappingURL=private_utils.d.ts.map

package/dist/types/src/private_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private_utils.d.ts","sourceRoot":"","sources":["../../../src/private_utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,EAAE,CAAC,IAAI;KAAE,CAAC,IAAI,CAAC,GAAG,CAAC;CAAC,CAAC;AAE9D;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAMtD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC,CAE5E;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,GAAG,SAAS,MAAM,EAC1C,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,EAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,GAAG,GAC5B,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAMtB;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAC,EAAE,EAAC,EAAE;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,UAEvC"}

package/dist/types/src/test_driver.d.ts

@@ -0,0 +1,450 @@
+import React from 'react';
+import { FieldId, RecordId, TableId, ViewId } from '@baselift/blocks/types';
+import { Mutation } from '@baselift/blocks/unstable_testing_utils';
+import { FixtureData, PickRecord, WatchableKeysAndArgs } from './mock_airtable_interface';
+/**
+ * An object describing a {@link Table}, a {@link View}, or both.
+ */
+type TableAndOrView = {
+    table: TableId | string;
+    view?: ViewId | string;
+} | {
+    table?: TableId | string;
+    view: ViewId | string;
+};
+/**
+ * A class designed to facilitate the automated testing of Airtable Extensions
+ * outside of a production Extensions environment. Each instance creates a simulated
+ * {@link Base} which is distinct from any other Base created in this way.
+ * Custom Extensions can be instantiated using an instance of this class; see {@link
+ * Container|the `Container` method}.
+ *
+ * The example code for this class's methods is written in terms of a
+ * non-existent Airtable Extension called `MyCustomExtension`. Each example includes a
+ * description of the presumed behavior for that Extension. Consumers of this library
+ * will work with their own Extensions whose behavior differs from these examples, so
+ * their tests will be distinct in this regard.
+ *
+ * @docsPath testing/TestDriver
+ */
+export default class TestDriver {
+    /**
+     * Create an instance of the test driver, initializing a simulated Airtable
+     * Base to take the state described by the provided fixture data.
+     */
+    constructor(fixtureData: FixtureData);
+    /**
+     * The simulated {@link Base} associated with this instance.
+     */
+    get base(): import("@baselift/blocks/models").Base;
+    /**
+     * The {@link Cursor} instance associated with this instance's Base.
+     */
+    get cursor(): import("@baselift/blocks/models").Cursor;
+    /**
+     * A {@link Session} instance. This will correspond to the first
+     * collaborator in your fixture data.
+     */
+    get session(): import("@baselift/blocks/models").Session;
+    /**
+     * A simulated {@link GlobalConfig} instance. This always starts empty.
+     */
+    get globalConfig(): import("@baselift/blocks/types").GlobalConfig;
+    /**
+     * A React Component which may be used to wrap Extension Components, enabling
+     * them to run outside of a production Extensions environment.
+     *
+     * @example
+     * ```js
+     * import TestDriver from '@baselift/blocks-testing';
+     * // Given MyCustomExtension, an Airtable Extension which defines a React Component...
+     * const MyCustomExtension = require('../src/my_custom_extension');
+     * // And given myFixtureData, a data structure describing the initial
+     * // state of a simulated Airtable Base...
+     * const myFixtureData = require('./my_fixture_data');
+     *
+     * const testDriver = new TestDriver(myFixtureData);
+     *
+     * render(
+     *     <testDriver.Container>
+     *         <MyCustomExtension />
+     *     </testDriver.Container>
+     * );
+     * ```
+     */
+    Container({ children }: {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    /**
+     * Destroy a {@link Field} in the simulated {@link Base}.
+     *
+     * @example
+     * ```js
+     * import TestDriver from '@baselift/blocks-testing';
+     * // Given MyCustomExtension, an Airtable Extension which displays the names of all
+     * // the Fields in the active Table...
+     * import MyCustomExtension from '../src/my_custom_extension';
+     * // And given myFixtureData, a data structure describing an Airtable
+     * // Base which contains a Table named "Table One" with three Fields...
+     * import myFixtureData from './my_fixture_data';
+     * import {render, screen} from '@testing-library/react';
+     *
+     * const testDriver = new TestDriver(myFixtureData);
+     * let items, itemTexts;
+     *
+     * render(
+     *     <testDriver.Container>
+     *         <MyCustomExtension />
+     *     </testDriver.Container>
+     * );
+     *
+     * // Verify that MyExtension initially displays all three Fields
+     * items = screen.getAllByRole('listitem');
+     * itemTexts = items.map((el) => el.textContent);
+     * expect(itemTexts).toEqual(['1st field', '2nd field', '3rd field']);
+     *
+     * // Simulate the destruction of the Field named "2nd field"
+     * await testDriver.deleteFieldAsync('Table One', '2nd field');
+     *
+     * // Verify that MyExtension correctly updates to describe the two remaining
+     * // Fields
+     * items = screen.getAllByRole('listitem');
+     * itemTexts = items.map((el) => el.textContent);
+     * expect(itemTexts).toEqual(['1st field', '3rd field']);
+     * ```
+     */
+    deleteFieldAsync(tableIdOrName: TableId | string, fieldIdOrName: FieldId | string): Promise<void>;
+    /**
+     * Destroy a {@link Table} in the simulated {@link Base}.
+     *
+     * @example
+     * ```js
+     * import TestDriver from '@baselift/blocks-testing';
+     * // Given MyCustomExtension, an Airtable Extension which displays the names of all
+     * // the Tables in the Base...
+     * import MyCustomExtension from '../src/my_custom_extension';
+     * // And given myFixtureData, a data structure describing an Airtable
+     * // Base which contains three Tables...
+     * import myFixtureData from './my_fixture_data';
+     * import {render, screen} from '@testing-library/react';
+     *
+     * const testDriver = new TestDriver(myFixtureData);
+     * let items, itemTexts;
+     *
+     * render(
+     *     <testDriver.Container>
+     *         <MyCustomExtension />
+     *     </testDriver.Container>
+     * );
+     *
+     * // Verify that MyExtension initially displays all three Tables
+     * items = screen.getAllByRole('listitem');
+     * itemTexts = items.map((el) => el.textContent);
+     * expect(itemTexts).toEqual(['1st table', '2nd table', '3rd table']);
+     *
+     * // Simulate the destruction of the Table named "2nd table"
+     * testDriver.deleteTable('2nd table');
+     *
+     * // Verify that MyExtension correctly updates to describe the two remaining
+     * // Table
+     * items = screen.getAllByRole('listitem');
+     * itemTexts = items.map((el) => el.textContent);
+     * expect(itemTexts).toEqual(['1st table', '3rd table']);
+     * ```
+     */
+    deleteTable(tableIdOrName: TableId | string): void;
+    /**
+     * Destroy a {@link View} in the simulated {@link Base}.
+     *
+     * @example
+     * ```js
+     * import TestDriver from '@baselift/blocks-testing';
+     * // Given MyCustomExtension, an Airtable Extension which displays the names of all
+     * // the Views in the active Table...
+     * import MyCustomExtension from '../src/my_custom_extension';
+     * // And given myFixtureData, a data structure describing an Airtable
+     * // Base which contains a Table named "Table One" with three Views...
+     * import myFixtureData from './my_fixture_data';
+     * import {render, screen} from '@testing-library/react';
+     *
+     * const testDriver = new TestDriver(myFixtureData);
+     * let items, itemTexts;
+     *
+     * render(
+     *     <testDriver.Container>
+     *         <MyCustomExtension />
+     *     </testDriver.Container>
+     * );
+     *
+     * // Verify that MyExtension initially displays all three Views
+     * items = screen.getAllByRole('listitem');
+     * itemTexts = items.map((el) => el.textContent);
+     * expect(itemTexts).toEqual(['1st view', '2nd view', '3rd view']);
+     *
+     * // Simulate the destruction of the Field named "2nd view"
+     * await testDriver.deleteViewAsync('Table One', '2nd view');
+     *
+     * // Verify that MyExtension correctly updates to describe the two remaining
+     * // Views
+     * items = screen.getAllByRole('listitem');
+     * itemTexts = items.map((el) => el.textContent);
+     * expect(itemTexts).toEqual(['1st view', '3rd view']);
+     * ```
+     */
+    deleteViewAsync(tableIdOrName: TableId | string, viewIdOrName: ViewId | string): Promise<void>;
+    /**
+     * Update the active {@link Table} and/or the active {@link View} of the
+     * Extension's {@link Cursor}. Either `table` or `view` must be specified.
+     *
+     * @example
+     * ```js
+     * testDriver.setActiveCursorModels({view: 'My grid view'});
+     * ```
+     *
+     * @example
+     * ```js
+     * import TestDriver from '@baselift/blocks-testing';
+     * // Given MyCustomExtension, an Airtable Extension which displays the names of the
+     * // active Table...
+     * import MyCustomExtension from '../src/my_custom_extension';
+     * // And given myFixtureData, a data structure describing an Airtable
+     * // Base which contains two Tables...
+     * import myFixtureData from './my_fixture_data';
+     * import {render, screen} from '@testing-library/react';
+     *
+     * const testDriver = new TestDriver(myFixtureData);
+     * let heading;
+     *
+     * render(
+     *     <testDriver.Container>
+     *         <MyCustomExtension />
+     *     </testDriver.Container>
+     * );
+     *
+     * // Verify that MyExtension initially displays the first Table
+     * heading = screen.getByRole('heading');
+     * expect(heading.textContent).toBe('First table');
+     *
+     * // Simulate the end user selecting the second Table from the Airtable
+     * // user interface
+     * testDriver.setActiveCursorModels(({table: 'Second table'});
+     *
+     * // Verify that MyExtension correctly updates to describe the newly-selected
+     * // Table
+     * heading = screen.getByRole('heading');
+     * expect(heading.textContent).toBe('Second table');
+     * ```
+     */
+    setActiveCursorModels(tableAndOrView: TableAndOrView): void;
+    /**
+     * Specify the outcome of internal permission checks. This influences the
+     * behavior of not only explicit permission checks from Extensions code but also
+     * the outcome of model operations such as {@link createRecordsAsync}.
+     *
+     * @example
+     * ```js
+     * import TestDriver from '@baselift/blocks-testing';
+     * // Given MyCustomExtension, an Airtable Extension which displays a button labeled
+     * // "Add" and which disables that button for users who lack "write"
+     * // permissions to the Base...
+     * import MyCustomExtension from '../src/my_custom_extension';
+     * // And given myFixtureData, a data structure describing the initial
+     * // state of a simulated Airtable Base...
+     * import myFixtureData from './my_fixture_data';
+     * import {render, screen} from '@testing-library/react';
+     *
+     * const testDriver = new TestDriver(myFixtureData);
+     *
+     * // Configure the test driver to reject all "create record" mutations.
+     * testDriver.simulatePermissionCheck((mutation) => {
+     *     return mutation.type !== 'createMultipleRecords';
+     * });
+     *
+     * render(
+     *     <testDriver.Container>
+     *         <MyCustomExtension />
+     *     </testDriver.Container>
+     * );
+     *
+     * // Verify that MyCustomExtension recognizes that the current user may not
+     * // create Records and that disables the corresponding aspect of the user
+     * // interface.
+     * const button = screen.getByRole('button', {name: 'Add'});
+     * expect(button.disabled).toBe(true);
+     * ```
+     */
+    simulatePermissionCheck(check: (mutation: Mutation) => boolean): void;
+    /**
+     * Specify the outcome of a request for the user to select a record in the
+     * UI created by {@link expandRecordPickerAsync}.
+     *
+     * @example
+     * ```js
+     * import TestDriver from '@baselift/blocks-testing';
+     * // Given MyCustomExtension, an Airtable Extension which prompts the end user to
+     * // select a Record and displays the name of the Record they selected...
+     * import MyCustomExtension from '../src/my_custom_extension';
+     * // And given myFixtureData, a data structure describing the initial
+     * // state of a simulated Airtable Base...
+     * import myFixtureData from './my_fixture_data';
+     * import {render, screen} from '@testing-library/react';
+     * import userEvent from '@testing-library/user-event';
+     *
+     * const testDriver = new TestDriver(myFixtureData);
+     *
+     * testDriver.simulateExpandedRecordSelection((tableId, recordIds) => {
+     *     return recordIds[1];
+     * });
+     *
+     * render(
+     *     <testDriver.Container>
+     *         <MyCustomExtension />
+     *     </testDriver.Container>
+     * );
+     *
+     * // Simulate a user clicking on a button in MyCustomExtension labeled with the
+     * // text "Choose record". If MyCustomExtension reacts to this event by invoking
+     * // the SDK's `expandRecordPickerAsync`, then it will receive the second
+     * // available record due to the function that is provided to
+     * // `simulateExpandedRecordSelection` above.
+     * const button = screen.getByRole('button', {name: 'Choose record'});
+     * userEvent.click(button);
+     *
+     * // Verify that MyCustomExtension correctly responds to the simulated user's
+     * // input
+     * const heading = await waitFor(() => screen.getByRole('heading'));
+     * expect(heading.textContent)
+     *   .toBe('You selected the record named "Number Two"');
+     * ```
+     */
+    simulateExpandedRecordSelection(pickRecord: PickRecord): void;
+    /**
+     * Simulate a user visually selecting a set of {@link Record|Records} in
+     * the active {@link Table}. This operation is unrelated to an Extension's
+     * programmatic "selection" of records via, e.g. {@link
+     * Table.selectRecords}. To deselect all records, invoke this method with
+     * an empty array.
+     *
+     * @example
+     * ```js
+     * import TestDriver from '@baselift/blocks-testing';
+     * // Given MyCustomExtension, an Airtable Extension which displays the number of
+     * // Records that an end user has selected in the active Table...
+     * import MyCustomExtension from '../src/my_custom_extension';
+     * // And given myFixtureData, a data structure describing the initial
+     * // state of a simulated Airtable Base...
+     * import myFixtureData from './my_fixture_data';
+     * import {render, screen} from '@testing-library/react';
+     *
+     * const testDriver = new TestDriver(myFixtureData);
+     *
+     * render(
+     *     <testDriver.Container>
+     *         <MyCustomExtension />
+     *     </testDriver.Container>
+     * );
+     *
+     * // Retrieve all the Records present in the first Table in the Base
+     * const records = await testDriver.base.tables[0].selectRecordsAsync();
+     *
+     * // Simulate an end-user selecting the second and fourth Record
+     * testDriver.userSelectRecords([records[1].id, records[3].id]);
+     *
+     * // Verify that MyCustomExtension correctly responds to the simulated user's
+     * // input
+     * const heading = await waitFor(() => screen.getByRole('heading'));
+     * expect(heading.textContent).toBe('2 records selected');
+     * ```
+     */
+    userSelectRecords(recordIds: Array<RecordId>): void;
+    /**
+     * Register a function to be invoked in response to a given internal event.
+     * See {@link WatchableKeysAndArgs} for the available keys and the values
+     * which are included when they are emitted.
+     *
+     * @example
+     * ```js
+     * import TestDriver from '@baselift/blocks-testing';
+     * // Given MyCustomExtension, an Airtable Extension which presents the user with one
+     * // button for each available Record, and which responds to button clicks
+     * // by expanding the Record in the Airtable user interface...
+     * import MyCustomExtension from '../src/my_custom_extension';
+     * // And given myFixtureData, a data structure describing an Airtable
+     * // Base which contains a Table with three records...
+     * import myFixtureData from './my_fixture_data';
+     * import {render, screen} from '@testing-library/react';
+     * import userEvent from '@testing-library/user-event';
+     *
+     * const testDriver = new TestDriver(myFixtureData);
+     *
+     * // Keep track of every time MyCustomExtension attempts to expand a Record in
+     * // the Airtable user interface
+     * let expandedRecordIds = [];
+     * testDriver.watch('expandRecord', ({recordId}) => {
+     *   expendedRecordIds.push(recordId);
+     * });
+     *
+     * render(
+     *     <testDriver.Container>
+     *         <MyCustomExtension />
+     *     </testDriver.Container>
+     * );
+     *
+     * // Verify that MyCustomExtension does not expand any Records prior to user
+     * // interaction
+     * expect(expandedRecords).toEqual([]);
+     *
+     * // Simulate a user clicking on the second button in MyCustomExtension, which
+     * // is expected to correspond to the second Record in the simulated Base
+     * const buttons = screen.getAllByRole('button');
+     * userEvent.click(buttons[1]);
+     *
+     * // Verify that MyCustomExtension correctly expanded the second Record in the
+     * // Airtable user interface
+     * expect(expandedRecords).toEqual(['rec2']);
+     * ```
+     */
+    watch<Key extends keyof WatchableKeysAndArgs>(key: Key, fn: (data: WatchableKeysAndArgs[Key]) => void): void;
+    /**
+     * De-register a function which was previously registered with {@link
+     * watch}. See {@link WatchableKeysAndArgs} for the available keys.
+     *
+     * @example
+     * ```js
+     * import TestDriver from '@baselift/blocks-testing';
+     * // Given MyCustomExtension, an Airtable Extension which enters "full screen" mode
+     * // in response to certain interactions...
+     * const MyCustomExtension = require('../src/my_custom_extension');
+     * // And given myFixtureData, a data structure describing the initial
+     * // state of a simulated Airtable Base...
+     * const myFixtureData = require('./my_fixture_data');
+     *
+     * let testDriver;
+     * let enterCount;
+     * let increment = () => {
+     *   enterCount += 1;
+     * });
+     *
+     * // Configure the test runner to create a TestDriver instance before
+     * // every test and to listen for requests to enter "full screen" mode
+     * beforeEach(() => {
+     *   testDriver = new TestDriver(myFixtureData);
+     *   enterCount = 0;
+     *   testDriver.watch('enterFullscreen', increment);
+     * });
+     *
+     * // Configure the test runner to remove the event listener after every
+     * // test. (The next test will have a new instance of TestDriver with its
+     * // own event handler, so this one is no longer necessary.)
+     * afterEach(() => {
+     *   testDriver.unwatch('enterFullscreen', increment);
+     * });
+     *
+     * // (include tests using the `testDriver` and `enterCount` variables
+     * // here)
+     * ```
+     */
+    unwatch<Key extends keyof WatchableKeysAndArgs>(key: Key, fn: (data: WatchableKeysAndArgs[Key]) => void): void;
+}
+export {};
+//# sourceMappingURL=test_driver.d.ts.map

package/dist/types/src/test_driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_driver.d.ts","sourceRoot":"","sources":["../../../src/test_driver.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAC,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAc,QAAQ,EAAM,MAAM,yCAAyC,CAAC;AAGnF,OAAO,EACH,WAAW,EAEX,UAAU,EACV,oBAAoB,EACvB,MAAM,2BAA2B,CAAC;AAGnC;;GAEG;AACH,KAAK,cAAc,GACb;IAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAC,GACjD;IAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAC,CAAC;AAExD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,CAAC,OAAO,OAAO,UAAU;IAM3B;;;OAGG;gBACS,WAAW,EAAE,WAAW;IAMpC;;OAEG;IACH,IAAI,IAAI,2CAEP;IAED;;OAEG;IACH,IAAI,MAAM,6CAET;IAED;;;OAGG;IACH,IAAI,OAAO,8CAEV;IAED;;OAEG;IACH,IAAI,YAAY,kDAEf;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,EAAC,QAAQ,EAAC,EAAE;QAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAC;IASjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACG,gBAAgB,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,MAAM;IAWvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,WAAW,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM;IAsB3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACG,eAAe,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAWpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACH,qBAAqB,CAAC,cAAc,EAAE,cAAc;IAsCpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,uBAAuB,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO;IAI9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACH,+BAA+B,CAAC,UAAU,EAAE,UAAU;IAItD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC;IA4B5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,KAAK,CAAC,GAAG,SAAS,MAAM,oBAAoB,EACxC,GAAG,EAAE,GAAG,EACR,EAAE,EAAE,CAAC,IAAI,EAAE,oBAAoB,CAAC,GAAG,CAAC,KAAK,IAAI;IAKjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,OAAO,CAAC,GAAG,SAAS,MAAM,oBAAoB,EAC1C,GAAG,EAAE,GAAG,EACR,EAAE,EAAE,CAAC,IAAI,EAAE,oBAAoB,CAAC,GAAG,CAAC,KAAK,IAAI;CAIpD"}

package/dist/types/src/test_mutations.d.ts

@@ -0,0 +1,43 @@
+import { Mutation } from '@baselift/blocks/unstable_testing_utils';
+import { FieldId, TableId, ViewId } from '@baselift/blocks/types';
+/**
+ * Get the type of all the values of an object.
+ *
+ * Same as the legacy Flow `$Values<T>` type.
+ *
+ * @hidden
+ */
+export type ObjectValues<T extends object> = T[keyof T];
+/** @hidden */
+export declare const TestMutationTypes: Readonly<{
+    DELETE_SINGLE_FIELD: "deleteSingleField";
+    DELETE_SINGLE_VIEW: "deleteSingleView";
+    SET_MULTIPLE_RECORDS_CELL_VALUES: "setMultipleRecordsCellValues";
+    DELETE_MULTIPLE_RECORDS: "deleteMultipleRecords";
+    CREATE_MULTIPLE_RECORDS: "createMultipleRecords";
+    SET_MULTIPLE_GLOBAL_CONFIG_PATHS: "setMultipleGlobalConfigPaths";
+    CREATE_SINGLE_FIELD: "createSingleField";
+    UPDATE_SINGLE_FIELD_CONFIG: "updateSingleFieldConfig";
+    UPDATE_SINGLE_FIELD_DESCRIPTION: "updateSingleFieldDescription";
+    UPDATE_SINGLE_FIELD_NAME: "updateSingleFieldName";
+    CREATE_SINGLE_TABLE: "createSingleTable";
+    UPDATE_VIEW_METADATA: "updateViewMetadata";
+}>;
+/** @hidden */
+export type TestMutationType = ObjectValues<typeof TestMutationTypes>;
+/** @hidden */
+interface TestDeleteSingleFieldMutation {
+    readonly type: typeof TestMutationTypes.DELETE_SINGLE_FIELD;
+    readonly tableId: TableId;
+    readonly id: FieldId;
+}
+/** @hidden */
+interface TestDeleteSingleViewMutation {
+    readonly type: typeof TestMutationTypes.DELETE_SINGLE_VIEW;
+    readonly tableId: TableId;
+    readonly id: ViewId;
+}
+/** @hidden */
+export type TestMutation = Mutation | TestDeleteSingleFieldMutation | TestDeleteSingleViewMutation;
+export {};
+//# sourceMappingURL=test_mutations.d.ts.map

package/dist/types/src/test_mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_mutations.d.ts","sourceRoot":"","sources":["../../../src/test_mutations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAgB,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAC,MAAM,wBAAwB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAExD,cAAc;AACd,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;EAI5B,CAAC;AAEH,cAAc;AACd,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEtE,cAAc;AACd,UAAU,6BAA6B;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,iBAAiB,CAAC,mBAAmB,CAAC;IAC5D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACxB;AAED,cAAc;AACd,UAAU,4BAA4B;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,iBAAiB,CAAC,kBAAkB,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACvB;AAED,cAAc;AACd,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,6BAA6B,GAAG,4BAA4B,CAAC"}

package/dist/types/src/vacant_airtable_interface.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vacant_airtable_interface.d.ts.map

package/dist/types/src/vacant_airtable_interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vacant_airtable_interface.d.ts","sourceRoot":"","sources":["../../../src/vacant_airtable_interface.ts"],"names":[],"mappings":""}

package/dist/types/test/index_compatible.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Dynamically-imported modules are evaluated just once, and the result is
+ * shared by all occurrences of the "dynamic import" expression. In order to
+ * verify the module's behavior when loaded under different conditions, each
+ * test must be declared in a dedicated file (this subverts the cache because
+ * the Jest test runner does not share a module cache between files).
+ */
+//# sourceMappingURL=index_compatible.test.d.ts.map

package/dist/types/test/index_compatible.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index_compatible.test.d.ts","sourceRoot":"","sources":["../../../test/index_compatible.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/types/test/index_incompatible.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index_incompatible.test.d.ts.map

package/dist/types/test/index_incompatible.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index_incompatible.test.d.ts","sourceRoot":"","sources":["../../../test/index_incompatible.test.ts"],"names":[],"mappings":""}

package/dist/types/test/mock_airtable_interface.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mock_airtable_interface.test.d.ts.map

package/dist/types/test/mock_airtable_interface.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock_airtable_interface.test.d.ts","sourceRoot":"","sources":["../../../test/mock_airtable_interface.test.ts"],"names":[],"mappings":""}

package/dist/types/test/mutation_types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mutation_types.test.d.ts.map

package/dist/types/test/mutation_types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation_types.test.d.ts","sourceRoot":"","sources":["../../../test/mutation_types.test.ts"],"names":[],"mappings":""}

package/dist/types/test/package_json.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=package_json.test.d.ts.map

package/dist/types/test/package_json.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package_json.test.d.ts","sourceRoot":"","sources":["../../../test/package_json.test.ts"],"names":[],"mappings":""}

package/dist/types/test/test_driver.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test_driver.test.d.ts.map

package/dist/types/test/test_driver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_driver.test.d.ts","sourceRoot":"","sources":["../../../test/test_driver.test.ts"],"names":[],"mappings":""}

package/dist/types/test/untestable_bindings.test.d.ts

@@ -0,0 +1,2 @@
+import '../src';
+//# sourceMappingURL=untestable_bindings.test.d.ts.map

package/dist/types/test/untestable_bindings.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"untestable_bindings.test.d.ts","sourceRoot":"","sources":["../../../test/untestable_bindings.test.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,CAAC"}