tinybase 4.0.0-beta.0 → 4.0.0-beta.1

package/lib/types/with-schemas/persister-remote.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The persister-remote module of the TinyBase project lets you save and load
+ * Store data to and from a remote server.
+ *
+ * @see Persisting Data guide
+ * @packageDocumentation
+ * @module persister-remote
+ */
+
+import {OptionalSchemas, Store} from './store';
+import {Persister} from './persisters';
+
+/**
+ * The createRemotePersister function creates a Persister object that can
+ * persist the Store to a remote server.
+ *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * createRemotePersister(
+ *   store: Store,
+ *   loadUrl: string,
+ *   saveUrl: string,
+ *   autoLoadIntervalSeconds: number,
+ * ): Persister;
+ * ```
+ *
+ * As well as providing a reference to the Store to persist, you must provide
+ * `loadUrl` and `saveUrl` parameters. These identify the endpoints of the
+ * server that support the `GET` method (to fetch the Store JSON to load) and
+ * the `POST` method (to send the Store JSON to save) respectively.
+ *
+ * For when you choose to enable automatic loading for the Persister (with the
+ * startAutoLoad method), it will poll the loadUrl for changes. The
+ * `autoLoadIntervalSeconds` method is used to indicate how often to do this.
+ *
+ * @param store The Store to persist.
+ * @param loadUrl The endpoint that supports a `GET` method to load JSON.
+ * @param saveUrl The endpoint that supports a `POST` method to save JSON.
+ * @param autoLoadIntervalSeconds How often to poll the `loadUrl` when
+ * automatically loading changes from the server.
+ * @returns A reference to the new Persister object.
+ * @example
+ * This example creates a Persister object and persists the Store to a remote
+ * server.
+ *
+ * ```js yolo
+ * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+ * const persister = createRemotePersister(
+ *   store,
+ *   'https://example.com/load',
+ *   'https://example.com/save',
+ *   5,
+ * );
+ *
+ * await persister.save();
+ * // Store JSON will be sent to server in a POST request.
+ *
+ * await persister.load();
+ * // Store JSON will be fetched from server with a GET request.
+ *
+ * persister.destroy();
+ * ```
+ * @category Creation
+ */
+export function createRemotePersister<Schemas extends OptionalSchemas>(
+  store: Store<Schemas>,
+  loadUrl: string,
+  saveUrl: string,
+  autoLoadIntervalSeconds: number,
+): Persister<Schemas>;

package/lib/types/with-schemas/persisters.d.ts

@@ -3,21 +3,21 @@
  * saving and loading Store data, to and from different destinations, or
  * underlying storage types.
  *
- * Several entry points are provided, each of which returns a new Persister
- * object that can load and save a Store:
- *
- * - The createSessionPersister function returns a Persister that uses the
- *   browser's session storage.
- * - The createLocalPersister function returns a Persister that uses the
- *   browser's local storage.
- * - The createRemotePersister function returns a Persister that uses a remote
- *   server.
- * - The createFilePersister function returns a Persister that uses a local file
- *   (in an appropriate environment).
+ * Several entry points are provided (in separately installed modules), each of
+ * which returns a new Persister object that can load and save a Store:
+ *
+ * - The createSessionPersister function (in the persister-browser module)
+ *   returns a Persister that uses the browser's session storage.
+ * - The createLocalPersister function (in the persister-browser module) returns
+ *   a Persister that uses the browser's local storage.
+ * - The createRemotePersister function (in the persister-remote module) returns
+ *   a Persister that uses a remote server.
+ * - The createFilePersister function (in the persister-file module) returns a
+ *   Persister that uses a local file (in an appropriate environment).
  *
  * Since persistence requirements can be different for every app, the
- * createCustomPersister function can also be used to easily create a fully
- * customized way to save and load Store data.
+ * createCustomPersister function in this module can also be used to easily
+ * create a fully customized way to save and load Store data.
  *
  * @see Persisting Data guide
  * @see Countries demo
@@ -28,7 +28,6 @@
  */
 
 import {OptionalSchemas, Store, Tables, Values} from './store.d';
-import {Callback} from './common.d';
 
 /**
  * The PersisterStats type describes the number of times a Persister object has
@@ -50,6 +49,14 @@ export type PersisterStats = {
   saves?: number;
 };
 
+/**
+ * A PersisterListener is a callback that lets a Persister inform the Store that
+ * a change has happened to the underlying data.
+ */
+export type PersisterListener<Schemas extends OptionalSchemas> = (
+  content?: [Tables<Schemas[0], true>, Values<Schemas[1], true>],
+) => void;
+
 /**
  * A Persister object lets you save and load Store data to and from different
  * locations, or underlying storage types.
@@ -514,12 +521,12 @@ export interface Persister<in out Schemas extends OptionalSchemas> {
    * const persister = createSessionPersister(store, 'pets');
    * await persister.startAutoSave();
    *
-   * console.log(store.getListenerStats().tables);
+   * console.log(store.getListenerStats().transaction);
    * // -> 1
    *
    * persister.destroy();
    *
-   * console.log(store.getListenerStats().tables);
+   * console.log(store.getListenerStats().transaction);
    * // -> 0
    * ```
    * @category Lifecycle
@@ -572,189 +579,6 @@ export interface Persister<in out Schemas extends OptionalSchemas> {
   getStats(): PersisterStats;
 }
 
-/**
- * The createSessionPersister function creates a Persister object that can
- * persist the Store to the browser's session storage.
- *
- * This has schema-based typing. The following is a simplified representation:
- *
- * ```ts override
- * createSessionPersister(
- *   store: Store,
- *   storageName: string,
- * ): Persister;
- * ```
- *
- * As well as providing a reference to the Store to persist, you must provide a
- * `storageName` parameter which is unique to your application. This is the key
- * that the browser uses to identify the storage location.
- *
- * @param store The Store to persist.
- * @param storageName The unique key to identify the storage location.
- * @returns A reference to the new Persister object.
- * @example
- * This example creates a Persister object and persists the Store to the
- * browser's session storage.
- *
- * ```js
- * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
- * const persister = createSessionPersister(store, 'pets');
- *
- * await persister.save();
- * console.log(sessionStorage.getItem('pets'));
- * // -> '[{"pets":{"fido":{"species":"dog"}}},{}]'
- *
- * persister.destroy();
- * sessionStorage.clear();
- * ```
- * @category Creation
- */
-export function createSessionPersister<Schemas extends OptionalSchemas>(
-  store: Store<Schemas>,
-  storageName: string,
-): Persister<Schemas>;
-
-/**
- * The createLocalPersister function creates a Persister object that can
- * persist the Store to the browser's local storage.
- *
- * This has schema-based typing. The following is a simplified representation:
- *
- * ```ts override
- * createLocalPersister(
- *   store: Store,
- *   storageName: string,
- * ): Persister;
- * ```
- *
- * As well as providing a reference to the Store to persist, you must provide a
- * `storageName` parameter which is unique to your application. This is the key
- * that the browser uses to identify the storage location.
- *
- * @param store The Store to persist.
- * @param storageName The unique key to identify the storage location.
- * @returns A reference to the new Persister object.
- * @example
- * This example creates a Persister object and persists the Store to the
- * browser's local storage.
- *
- * ```js
- * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
- * const persister = createLocalPersister(store, 'pets');
- *
- * await persister.save();
- * console.log(localStorage.getItem('pets'));
- * // -> '[{"pets":{"fido":{"species":"dog"}}},{}]'
- *
- * persister.destroy();
- * localStorage.clear();
- * ```
- * @category Creation
- */
-export function createLocalPersister<Schemas extends OptionalSchemas>(
-  store: Store<Schemas>,
-  storageName: string,
-): Persister<Schemas>;
-
-/**
- * The createRemotePersister function creates a Persister object that can
- * persist the Store to a remote server.
- *
- * This has schema-based typing. The following is a simplified representation:
- *
- * ```ts override
- * createRemotePersister(
- *   store: Store,
- *   loadUrl: string,
- *   saveUrl: string,
- *   autoLoadIntervalSeconds: number,
- * ): Persister;
- * ```
- *
- * As well as providing a reference to the Store to persist, you must provide
- * `loadUrl` and `saveUrl` parameters. These identify the endpoints of the
- * server that support the `GET` method (to fetch the Store JSON to load) and
- * the `POST` method (to send the Store JSON to save) respectively.
- *
- * For when you choose to enable automatic loading for the Persister (with the
- * startAutoLoad method), it will poll the loadUrl for changes. The
- * `autoLoadIntervalSeconds` method is used to indicate how often to do this.
- *
- * @param store The Store to persist.
- * @param loadUrl The endpoint that supports a `GET` method to load JSON.
- * @param saveUrl The endpoint that supports a `POST` method to save JSON.
- * @param autoLoadIntervalSeconds How often to poll the `loadUrl` when
- * automatically loading changes from the server.
- * @returns A reference to the new Persister object.
- * @example
- * This example creates a Persister object and persists the Store to a remote
- * server.
- *
- * ```js yolo
- * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
- * const persister = createRemotePersister(
- *   store,
- *   'https://example.com/load',
- *   'https://example.com/save',
- *   5,
- * );
- *
- * await persister.save();
- * // Store JSON will be sent to server in a POST request.
- *
- * await persister.load();
- * // Store JSON will be fetched from server with a GET request.
- *
- * persister.destroy();
- * ```
- * @category Creation
- */
-export function createRemotePersister<Schemas extends OptionalSchemas>(
-  store: Store<Schemas>,
-  loadUrl: string,
-  saveUrl: string,
-  autoLoadIntervalSeconds: number,
-): Persister<Schemas>;
-
-/**
- * The createFilePersister function creates a Persister object that can persist
- * the Store to a local file (in an appropriate environment).
- *
- * This has schema-based typing. The following is a simplified representation:
- *
- * ```ts override
- * createFilePersister(store: Store, filePath: string): Persister;
- * ```
- *
- * As well as providing a reference to the Store to persist, you must provide
- * `filePath` parameter which identifies the file to persist it to.
- *
- * @param store The Store to persist.
- * @param filePath The location of the local file to persist the Store to.
- * @returns A reference to the new Persister object.
- * @example
- * This example creates a Persister object and persists the Store to a local
- * file.
- *
- * ```js yolo
- * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
- * const persister = createFilePersister(store, '/app/persisted.json');
- *
- * await persister.save();
- * // Store JSON will be saved to the file.
- *
- * await persister.load();
- * // Store JSON will be loaded from the file.
- *
- * persister.destroy();
- * ```
- * @category Creation
- */
-export function createFilePersister<Schemas extends OptionalSchemas>(
-  store: Store<Schemas>,
-  filePath: string,
-): Persister<Schemas>;
-
 /**
  * The createCustomPersister function creates a Persister object that you can
  * configure to persist the Store in any way you wish.
@@ -765,9 +589,9 @@ export function createFilePersister<Schemas extends OptionalSchemas>(
  * createCustomPersister<ListeningHandle>(
  *   store: Store,
  *   getPersisted: () => Promise<string | null | undefined>,
- *   setPersisted: (json: string) => Promise<void>,
- *   startListeningToPersisted: (didChange: Callback) => ListeningHandle,
- *   stopListeningToPersisted: (listeningHandle: ListeningHandle) => void,
+ *   setPersisted: (getContent: () => [Tables, Values]) => Promise<void>,
+ *   addPersisterListener: (listener: PersisterListener) => ListeningHandle,
+ *   delPersisterListener: (listeningHandle: ListeningHandle) => void,
  * ): Persister;
  * ```
  *
@@ -780,18 +604,25 @@ export function createFilePersister<Schemas extends OptionalSchemas>(
  * covers. See those implementations for ideas on how to implement your own
  * Persister types.
  *
+ * This API changed in v4.0.0. Any custom persisters created on previous
+ * versions should be upgraded. Most notably, the `setPersisted` function
+ * parameter is provided with a `getContent` function to get the content from
+ * the Store itself, rather than being passed pre-serialized JSON.
+ * `addPersisterListener` has been renamed `addPersisterListener`, and
+ * `addPersisterListener` has been renamed `delPersisterListener`.
+ *
  * @param store The Store to persist.
- * @param getPersisted An asynchronous function which will fetch JSON from the
- * persistence layer (or `null` or `undefined` if not present).
- * @param setPersisted An asynchronous function which will send JSON to the
+ * @param getPersisted An asynchronous function which will fetch content from
+ * the persistence layer (or `null` or `undefined` if not present).
+ * @param setPersisted An asynchronous function which will send content to the
  * persistence layer.
- * @param startListeningToPersisted A function that will register a `didChange`
+ * @param addPersisterListener A function that will register a `listener`
  * listener on underlying changes to the persistence layer. You can return a
- * listening handle that will be provided again when `stopListeningToPersisted`
+ * listening handle that will be provided again when `delPersisterListener`
  * is called.
- * @param stopListeningToPersisted A function that will unregister the listener
+ * @param delPersisterListener A function that will unregister the listener
  * from the underlying changes to the persistence layer. It receives whatever
- * was returned from your `startListeningToPersisted` implementation.
+ * was returned from your `addPersisterListener` implementation.
  * @returns A reference to the new Persister object.
  * @example
  * This example creates a custom Persister object and persists the Store to a
@@ -805,8 +636,8 @@ export function createFilePersister<Schemas extends OptionalSchemas>(
  * const persister = createCustomPersister(
  *   store,
  *   async () => storeJson,
- *   async (json) => (storeJson = json),
- *   (didChange) => setInterval(didChange, 1000),
+ *   async (getContent) => (storeJson = JSON.stringify(getContent())),
+ *   (listener) => setInterval(listener, 1000),
  *   (interval) => clearInterval(interval),
  * );
  *
@@ -830,7 +661,11 @@ export function createCustomPersister<
 >(
   store: Store<Schemas>,
   getPersisted: () => Promise<string | null | undefined>,
-  setPersisted: (json: string) => Promise<void>,
-  startListeningToPersisted: (didChange: Callback) => ListeningHandle,
-  stopListeningToPersisted: (listeningHandle: ListeningHandle) => void,
+  setPersisted: (
+    getContent: () => [Tables<Schemas[0]>, Values<Schemas[1]>],
+  ) => Promise<void>,
+  addPersisterListener: (
+    listener: PersisterListener<Schemas>,
+  ) => ListeningHandle,
+  delPersisterListener: (listeningHandle: ListeningHandle) => void,
 ): Persister<Schemas>;

package/lib/types/with-schemas/store.d.ts

@@ -707,6 +707,10 @@ export type DoRollback<Schemas extends OptionalSchemas> = (
  *   store: Store,
  *   cellsTouched: boolean,
  *   valuesTouched: boolean,
+ *   changedCells: ChangedCells,
+ *   invalidCells: InvalidCells,
+ *   changedValues: ChangedValues,
+ *   invalidValues: InvalidValues,
  * ) => void;
  * ```
  *
@@ -725,17 +729,30 @@ export type DoRollback<Schemas extends OptionalSchemas> = (
  * of `cellsTouched` and `valuesTouched` in the listener will be `false` because
  * all changes have been reverted.
  *
+ * Since v4.0, the listener also receives the list of (valid and invalid) Cell
+ * and Value changes made during the transaction.
+ *
  * @param store A reference to the Store that is completing a transaction.
  * @param cellsTouched Whether Cell values have been touched during the
  * transaction.
  * @param valuesTouched Whether Values have been touched during the transaction,
  * since v3.0.0.
+ * @param changedCells Any Cells that were changed during the transaction, since
+ * v4.0.0.
+ * @param invalidCells Any invalid attempts to change Cells, since v4.0.0.
+ * @param changedValues Any Values that were changed during the transaction,
+ * since v4.0.0.
+ * @param invalidValues Any invalid attempts to change Values, since v4.0.0.
  * @category Listener
  */
 export type TransactionListener<Schemas extends OptionalSchemas> = (
   store: Store<Schemas>,
   cellsTouched: boolean,
   valuesTouched: boolean,
+  changedCells: ChangedCells<Schemas[0]>,
+  invalidCells: InvalidCells,
+  changedValues: ChangedValues<Schemas[1]>,
+  invalidValues: InvalidValues,
 ) => void;
 
 /**
@@ -1811,8 +1828,47 @@ export type StoreListenerStats = {
  */
 export interface Store<in out Schemas extends OptionalSchemas> {
   /**
-   * The getTables method returns a Tables object containing the entire data of
-   * the Store.
+   * The getContent method returns a Tables object and a Values object in an
+   * array, representing the entire content of the Store.
+   *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getContent(): [Tables, Values];
+   * ```
+   *
+   * Note that this returns a copy of, rather than a reference to the underlying
+   * data, so changes made to the returned objects are not made to the Store
+   * itself.
+   *
+   * @returns An array of a Tables object and a Values object.
+   * @example
+   * This example retrieves the content of a Store.
+   *
+   * ```js
+   * const store = createStore()
+   *   .setTables({pets: {fido: {species: 'dog'}}})
+   *   .setValues({open: true, employees: 3});
+   * console.log(store.getContent());
+   * // -> [{pets: {fido: {species: 'dog'}}}, {open: true, employees: 3}]
+   * ```
+   * @example
+   * This example retrieves the Tables and Values of an empty Store, returning
+   * empty objects.
+   *
+   * ```js
+   * const store = createStore();
+   * console.log(store.getContent());
+   * // -> [{}, {}]
+   * ```
+   * @category Getter
+   * @since v4.0.0
+   */
+  getContent(): [Tables<Schemas[0]>, Values<Schemas[1]>];
+
+  /**
+   * The getTables method returns a Tables object containing the entire tabular
+   * data of the Store.
    *
    * This has schema-based typing. The following is a simplified representation:
    *
@@ -1824,9 +1880,9 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * data, so changes made to the returned object are not made to the Store
    * itself.
    *
-   * @returns A Tables object containing the entire data of the Store.
+   * @returns A Tables object containing the tabular data of the Store.
    * @example
-   * This example retrieves the data in a Store.
+   * This example retrieves the tabular data in a Store.
    *
    * ```js
    * const store = createStore().setTables({
@@ -2234,9 +2290,9 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * data, so changes made to the returned object are not made to the Store
    * itself.
    *
-   * @returns An object containing the entire data of the Values.
+   * @returns An object containing the set of keyed Values in the Store.
    * @example
-   * This example retrieves the keyed Values data in a Store.
+   * This example retrieves the set of keyed Values in the Store.
    *
    * ```js
    * const store = createStore().setValues({open: true, employees: 3});
@@ -2244,7 +2300,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {open: true, employees: 3}
    * ```
    * @example
-   * This example retrieves a Values from a Store that has none, returning an
+   * This example retrieves Values from a Store that has none, returning an
    * empty object.
    *
    * ```js
@@ -2671,7 +2727,76 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   getSchemaJson(): Json;
 
   /**
-   * The setTables method takes an object and sets the entire data of the Store.
+   * The setContent method takes an object and sets the entire data of the
+   * Store.
+   *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setContent([tables, values]: [Tables, Values]): Store;
+   * ```
+   *
+   * This method will cause listeners to be called for any Table, Row, Cell,
+   * Value, or Id changes resulting from it.
+   *
+   * Any part of the provided objects that are invalid (either according to the
+   * Tables or Values type, or because it does not match a TablesSchema or
+   * ValuesSchema associated with the Store), will be ignored silently.
+   *
+   * Assuming that at least some of the provided Tables object or Values object
+   * is valid, any data that was already present in that part of the Store will
+   * be completely overwritten. If either object is completely invalid, no
+   * change will be made to the corresponding part of the Store.
+   *
+   * The method returns a reference to the Store so that subsequent operations
+   * can be chained in a fluent style.
+   *
+   * @param content An array containing the tabular and keyed-value data of the
+   * Store to be set.
+   * @example
+   * This example sets the data of a Store.
+   *
+   * ```js
+   * const store = createStore().setContent([
+   *   {pets: {fido: {species: 'dog'}}},
+   *   {open: true, employees: 3},
+   * ]);
+   * console.log(store.getTables());
+   * // -> {pets: {fido: {species: 'dog'}}}
+   * console.log(store.getValues());
+   * // -> {open: true, employees: 3}
+   * ```
+   * @example
+   * This example attempts to set the data of an existing Store with partly
+   * invalid, and then completely invalid objects.
+   *
+   * ```js
+   * const store = createStore().setContent([
+   *   {pets: {fido: {species: 'dog'}}},
+   *   {open: true, employees: 3},
+   * ]);
+   *
+   * store.setContent([{pets: {felix: {species: 'cat', bug: []}}}, '']);
+   * console.log(store.getTables());
+   * // -> {pets: {felix: {species: 'cat'}}}
+   * console.log(store.getValues());
+   * // -> {open: true, employees: 3}
+   *
+   * store.setContent([{meaning: 42}]);
+   * console.log(store.getTables());
+   * // -> {pets: {felix: {species: 'cat'}}}
+   * ```
+   * @category Setter
+   * @since 4.0.0
+   */
+  setContent([tables, values]: [
+    Tables<Schemas[0], true>,
+    Values<Schemas[1], true>,
+  ]): Store<Schemas>;
+
+  /**
+   * The setTables method takes an object and sets the entire tabular data of
+   * the Store.
    *
    * This has schema-based typing. The following is a simplified representation:
    *
@@ -2695,7 +2820,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * @param tables The data of the Store to be set.
    * @example
-   * This example sets the data of a Store.
+   * This example sets the tabular data of a Store.
    *
    * ```js
    * const store = createStore().setTables({
@@ -2706,8 +2831,8 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {pets: {fido: {species: 'dog'}}, species: {dog: {price: 5}}}
    * ```
    * @example
-   * This example attempts to set the data of an existing Store with partly
-   * invalid, and then completely invalid, Tables objects.
+   * This example attempts to set the tabular data of an existing Store with
+   * partly invalid, and then completely invalid, Tables objects.
    *
    * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});

package/lib/umd/persister-browser.js

@@ -0,0 +1 @@
+var e,t;e=this,t=function(e){"use strict";const t=e=>null==e,s=Object.freeze,a="storage",o=globalThis.window,n=(e,n,r)=>((e,i,d,c,u)=>{let l,f,v=0,y=!1;const p={load:async(s,a)=>{if(2!=v){v=1;const o=await(async()=>r.getItem(n))();t(o)||""==o?e.setContent([s,a]):e.setJson(o),v=0}return p},startAutoLoad:async(s,i)=>(p.stopAutoLoad(),await p.load(s,i),y=!0,f=(e=>{const t=t=>{if(t.storageArea===r&&t.key===n){let s;try{s=JSON.parse(t.newValue)}catch{}e(s)}};return o.addEventListener(a,t),t})((async s=>{t(s)?await p.load():2!=v&&(v=1,e.setContent(s),v=0)})),p),stopAutoLoad:()=>{return y&&(e=f,o.removeEventListener(a,e),f=void 0,y=!1),p;var e},save:async()=>(1!=v&&(v=2,await(async e=>{return r.setItem(n,(t=e(),JSON.stringify(t,((e,t)=>{return t instanceof Map?(s=(e,[t,s])=>(e[t]=s,e),a={},[...t].reduce(s,a)):t;var s,a}))));var t})(e.getContent),v=0),p),startAutoSave:async()=>(await p.stopAutoSave().save(),l=e.addDidFinishTransactionListener(p.save),p),stopAutoSave:()=>{var s,a;return s=l,a=e.delListener,t(s)||a(s),p},getStore:()=>e,destroy:()=>p.stopAutoLoad().stopAutoSave(),getStats:()=>({})};return s(p)})(e);e.createLocalPersister=(e,t)=>n(e,t,localStorage),e.createSessionPersister=(e,t)=>n(e,t,sessionStorage)},"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).TinyBasePersisterBrowser={});

package/lib/umd/persister-file.js

@@ -0,0 +1 @@
+var t,e;t=this,e=function(t,e,s){"use strict";const a="utf8",o=t=>null==t,r=Object.freeze;t.createFilePersister=(t,n)=>((t,i,c,u,d)=>{let f,l,p=0,y=!1;const v={load:async(s,r)=>{if(2!=p){p=1;const i=await(async()=>{try{return await e.readFile(n,a)}catch{}})();o(i)||""==i?t.setContent([s,r]):t.setJson(i),p=0}return v},startAutoLoad:async(e,a)=>{return v.stopAutoLoad(),await v.load(e,a),y=!0,r=async e=>{o(e)?await v.load():2!=p&&(p=1,t.setContent(e),p=0)},l=s.watch(n,(()=>r())),v;var r},stopAutoLoad:()=>(y&&(l?.close(),l=void 0,y=!1),v),save:async()=>(1!=p&&(p=2,await(async t=>{try{await e.writeFile(n,(s=t(),JSON.stringify(s,((t,e)=>{return e instanceof Map?(s=(t,[e,s])=>(t[e]=s,t),a={},[...e].reduce(s,a)):e;var s,a}))),a)}catch{}var s})(t.getContent),p=0),v),startAutoSave:async()=>(await v.stopAutoSave().save(),f=t.addDidFinishTransactionListener(v.save),v),stopAutoSave:()=>{var e,s;return e=f,s=t.delListener,o(e)||s(e),v},getStore:()=>t,destroy:()=>v.stopAutoLoad().stopAutoSave(),getStats:()=>({})};return r(v)})(t)},"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("fs/promises"),require("fs")):"function"==typeof define&&define.amd?define(["exports","fs/promises","fs"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).TinyBasePersisterFile={},t["fs/promises"],t.fs);

package/lib/umd/persister-remote.js

@@ -0,0 +1 @@
+var t,e;t=this,e=function(t){"use strict";const e=t=>null==t,a=Object.freeze,o=t=>t.headers.get("ETag");t.createRemotePersister=(t,n,s,r)=>{let i;return((t,d,c,u,f)=>{let l,p,y=0,v=!1;const h={load:async(a,s)=>{if(2!=y){y=1;const r=await(async()=>{const t=await fetch(n);return i=o(t),t.text()})();e(r)||""==r?t.setContent([a,s]):t.setJson(r),y=0}return h},startAutoLoad:async(a,s)=>{return h.stopAutoLoad(),await h.load(a,s),v=!0,d=async a=>{e(a)?await h.load():2!=y&&(y=1,t.setContent(a),y=0)},p=setInterval((async()=>{const t=await fetch(n,{method:"HEAD"}),a=o(t);e(i)||e(a)||a==i||(i=a,d())}),1e3*r),h;var d},stopAutoLoad:()=>(v&&(clearInterval(p),p=void 0,v=!1),h),save:async()=>(1!=y&&(y=2,await(async t=>{return await fetch(s,{method:"POST",headers:{"Content-Type":"application/json"},body:(e=t(),JSON.stringify(e,((t,e)=>{return e instanceof Map?(a=(t,[e,a])=>(t[e]=a,t),o={},[...e].reduce(a,o)):e;var a,o})))});var e})(t.getContent),y=0),h),startAutoSave:async()=>(await h.stopAutoSave().save(),l=t.addDidFinishTransactionListener(h.save),h),stopAutoSave:()=>{var a,o;return a=l,o=t.delListener,e(a)||o(a),h},getStore:()=>t,destroy:()=>h.stopAutoLoad().stopAutoSave(),getStats:()=>({})};return a(h)})(t)}},"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).TinyBasePersisterRemote={});

package/lib/umd/persister-yjs.js

@@ -1 +1 @@
-var e,t;e=this,t=function(e){"use strict";const t=e=>null==e,s=(e,s,o)=>t(e)?o?.():s(e),o=Object.freeze;e.createYjsPersister=(e,a)=>{const n=a.getMap("tinybase/store");return((e,a,r,i,d)=>{let u,c,l,f=0,p=!1;const v={load:async(s,o)=>{if(2!=f){f=1;const a=await(async()=>n.get("json"))();t(a)||""==a?e.transaction((()=>e.setTables(s).setValues(o))):e.setJson(a),f=0}return v},startAutoLoad:async(e,t)=>(v.stopAutoLoad(),await v.load(e,t),p=!0,l=(e=>{const t=()=>e();return n.observe(t),t})(v.load),v),stopAutoLoad:()=>{return p&&(e=l,n.unobserve(e),l=void 0,p=!1),v;var e},save:async()=>(1!=f&&(f=2,await(async e=>{n.set("json",e)})(e.getJson()),f=0),v),startAutoSave:async()=>(await v.stopAutoSave().save(),u=e.addTablesListener(v.save),c=e.addValuesListener(v.save),v),stopAutoSave:()=>(s(u,e.delListener),s(c,e.delListener),v),getStore:()=>e,destroy:()=>v.stopAutoLoad().stopAutoSave(),getStats:()=>({})};return o(v)})(e)}},"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).TinyBasePersisterYjs={});
+var t,e;t=this,e=function(t){"use strict";const e=t=>null==t,s=Object.freeze;t.createYjsPersister=(t,o)=>{const n=o.getMap("tinybase/store");return((t,o,a,r,i)=>{let d,u,c=0,f=!1;const y={load:async(s,o)=>{if(2!=c){c=1;const a=await(async()=>n.get("json"))();e(a)||""==a?t.setContent([s,o]):t.setJson(a),c=0}return y},startAutoLoad:async(s,o)=>(y.stopAutoLoad(),await y.load(s,o),f=!0,u=(t=>{const e=()=>t();return n.observe(e),e})((async s=>{e(s)?await y.load():2!=c&&(c=1,t.setContent(s),c=0)})),y),stopAutoLoad:()=>{return f&&(t=u,n.unobserve(t),u=void 0,f=!1),y;var t},save:async()=>(1!=c&&(c=2,await(async t=>{n.set("json",JSON.stringify(t()))})(t.getContent),c=0),y),startAutoSave:async()=>(await y.stopAutoSave().save(),d=t.addDidFinishTransactionListener(y.save),y),stopAutoSave:()=>{var s,o;return s=d,o=t.delListener,e(s)||o(s),y},getStore:()=>t,destroy:()=>y.stopAutoLoad().stopAutoSave(),getStats:()=>({})};return s(y)})(t)}},"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).TinyBasePersisterYjs={});

package/lib/umd/persisters.js

@@ -1 +1 @@
-var e,t;e=this,t=function(e,t){"use strict";const s="utf8",a=e=>null==e,o=(e,t,s)=>a(e)?s?.():t(e),r=Object.freeze,n=(e,t,s,n,i)=>{let c,d,l,u=0,y=!1;const f={load:async(s,o)=>{if(2!=u){u=1;const r=await t();a(r)||""==r?e.transaction((()=>e.setTables(s).setValues(o))):e.setJson(r),u=0}return f},startAutoLoad:async(e,t)=>(f.stopAutoLoad(),await f.load(e,t),y=!0,l=n(f.load),f),stopAutoLoad:()=>(y&&(i(l),l=void 0,y=!1),f),save:async()=>(1!=u&&(u=2,await s(e.getJson()),u=0),f),startAutoSave:async()=>(await f.stopAutoSave().save(),c=e.addTablesListener(f.save),d=e.addValuesListener(f.save),f),stopAutoSave:()=>(o(c,e.delListener),o(d,e.delListener),f),getStore:()=>e,destroy:()=>f.stopAutoLoad().stopAutoSave(),getStats:()=>({})};return r(f)},i="storage",c=globalThis.window,d=(e,t,s)=>n(e,(async()=>s.getItem(t)),(async e=>s.setItem(t,e)),(e=>{const a=a=>{a.storageArea===s&&a.key===t&&e()};return c.addEventListener(i,a),a}),(e=>c.removeEventListener(i,e))),l=e=>e.headers.get("ETag");e.createCustomPersister=n,e.createFilePersister=(e,a)=>n(e,(async()=>{try{return await t.promises.readFile(a,s)}catch{}}),(async e=>{try{await t.promises.writeFile(a,e,s)}catch{}}),(e=>t.watch(a,e)),(e=>e?.close())),e.createLocalPersister=(e,t)=>d(e,t,localStorage),e.createRemotePersister=(e,t,s,o)=>{let r;return n(e,(async()=>{const e=await fetch(t);return r=l(e),e.text()}),(async e=>await fetch(s,{method:"POST",headers:{"Content-Type":"application/json"},body:e})),(e=>setInterval((async()=>{const s=await fetch(t,{method:"HEAD"}),o=l(s);a(r)||a(o)||o==r||(r=o,e())}),1e3*o)),(e=>clearInterval(e)))},e.createSessionPersister=(e,t)=>d(e,t,sessionStorage)},"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("fs")):"function"==typeof define&&define.amd?define(["exports","fs"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).TinyBasePersisters={},e.fs);
+var t,e;t=this,e=function(t){"use strict";const e=t=>null==t,o=Object.freeze;t.createCustomPersister=(t,s,a,n,i)=>{let r,d,u=0,c=!1;const f={load:async(o,a)=>{if(2!=u){u=1;const n=await s();e(n)||""==n?t.setContent([o,a]):t.setJson(n),u=0}return f},startAutoLoad:async(o,s)=>(f.stopAutoLoad(),await f.load(o,s),c=!0,d=n((async o=>{e(o)?await f.load():2!=u&&(u=1,t.setContent(o),u=0)})),f),stopAutoLoad:()=>(c&&(i(d),d=void 0,c=!1),f),save:async()=>(1!=u&&(u=2,await a(t.getContent),u=0),f),startAutoSave:async()=>(await f.stopAutoSave().save(),r=t.addDidFinishTransactionListener(f.save),f),stopAutoSave:()=>{var o,s;return o=r,s=t.delListener,e(o)||s(o),f},getStore:()=>t,destroy:()=>f.stopAutoLoad().stopAutoSave(),getStats:()=>({})};return o(f)}},"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).TinyBasePersisters={});