tinybase 6.1.0-beta.3 → 6.1.0-beta.5

package/@types/persisters/index.d.ts

@@ -17,6 +17,7 @@
  * |IndexedDbPersister|Browser IndexedDB|Yes|No
  * |RemotePersister|Remote server|Yes|No
  * |Sqlite3Persister|SQLite in Node, via [sqlite3](https://github.com/TryGhost/node-sqlite3)|Yes|Yes*
+ * |SqliteBunPersister| SQLite in Bun, via [bun:sqlite](https://bun.sh/docs/api/sqlite)|Yes|Yes*
  * |SqliteWasmPersister|SQLite in a browser, via [sqlite-wasm](https://github.com/tomayac/sqlite-wasm)|Yes|Yes*
  * |ExpoSqlitePersister|SQLite in React Native, via [expo-sqlite](https://github.com/expo/expo/tree/main/packages/expo-sqlite)|Yes|Yes*
  * |PostgresPersister|PostgreSQL, via [postgres](https://github.com/porsager/postgres)|Yes|Yes*
@@ -38,9 +39,9 @@
  * create a fully customized way to save and load Store data.
  *
  * Similarly, the createCustomSqlitePersister function and
- * createCustomPostgreSqlPersister function can be used to build Persister objects
- * against SQLite and PostgreSQL SDKs (or forks) that are not already included
- * with TinyBase.
+ * createCustomPostgreSqlPersister function can be used to build Persister
+ * objects against SQLite and PostgreSQL SDKs (or forks) that are not already
+ * included with TinyBase.
  * @see Persistence guides
  * @see Countries demo
  * @see Todo App demos
@@ -58,8 +59,8 @@ import type {
 import type {Changes, Content, Store} from '../store/index.d.ts';
 
 /**
- * The Status enum is used to indicate whether a Persister is idle, or loading or
- * saving data.
+ * The Status enum is used to indicate whether a Persister is idle, or loading
+ * or saving data.
  *
  * The enum is intended to be used to understand the status of the Persister in
  * conjunction with the getStatus and addStatusListener methods.
@@ -516,6 +517,23 @@ export type DpcTabular = {
   autoLoadIntervalSeconds?: number;
 };
 
+/**
+ * The DpcTabularCondition type describes the SQL WHERE clause that will be used
+ * to filter the rows that are loaded and saved to in the Store Table.
+ *
+ * This provides a way to enact pagination or selective loading of data from the
+ * database into TinyBase so that only a fraction of the full data in the
+ * database is loaded into memory.
+ *
+ * This clause must include at least one `$tableName` placeholder for the table
+ * name. For example, if you only wanted to load and save records that have an
+ * 'active' flag set, this string would be something like `$tableName.active =
+ * 1`.
+ * @category Configuration
+ * @since v6.1.0
+ */
+export type DpcTabularCondition = `${string}$tableName${string}` | 'true';
+
 /**
  * The DpcTabularLoad type describes the configuration for loading Tables in a
  * database-oriented Persister that is operating in tabular mode.
@@ -528,6 +546,7 @@ export type DpcTabular = {
  * |-|-|-|
  * |`tableId`|Id|The Id of the Store Table into which data from this database table should be loaded.|
  * |`rowIdColumnName?`|string|The optional name of the column in the database table that will be used as the Row Ids in the Store Table, defaulting to '_id'.|
+ * |`condition?`|string|The optional SQL WHERE clause that will be used to filter the rows that are loaded into the Store Table. When set it must include the `$tableName` placeholder for the table name, since v6.1.0.|
  *
  * As a shortcut, if you do not need to specify a custom `rowIdColumnName`, you
  * can simply provide the Id of the Store Table instead of the whole object.
@@ -614,6 +633,16 @@ export type DpcTabularLoad = {
          * @since v4.0.0
          */
         rowIdColumnName?: string;
+        /**
+         * The optional SQL WHERE clause that will be used to filter the rows
+         * that are loaded into the Store Table. When set it must include the
+         * `$tableName` placeholder for the table name. See the 'Syncing with
+         * subsets of database tables' section of the Database Persistence guide
+         * for more details.
+         * @category Configuration
+         * @since v6.1.0
+         */
+        condition?: DpcTabularCondition;
       }
     | Id;
 };
@@ -632,6 +661,7 @@ export type DpcTabularLoad = {
  * |`rowIdColumnName?`|string|The optional name of the column in the database table that will be used to save the Row Ids from the Store Table, defaulting to '_id'.|
  * |`deleteEmptyColumns?`|boolean|Whether columns in the database table will be removed if they are empty in the Store Table, defaulting to false.|
  * |`deleteEmptyTable?`|boolean|Whether tables in the database will be removed if the Store Table is empty, defaulting to false.|
+ * |`condition?`|string|The optional SQL WHERE clause that will be used to scope cleanup operations to the Store Table. When set it must include the `$tableName` placeholder for the table name, since v6.1.0. Defaults to `DpcTabularLoad.condition`.|
  *
  * As a shortcut, if you do not need to specify a custom `rowIdColumnName`, or
  * enable the `deleteEmptyColumns` or `deleteEmptyTable` settings, you can
@@ -745,6 +775,16 @@ export type DpcTabularSave = {
          * @since v4.0.0
          */
         deleteEmptyTable?: boolean;
+        /**
+         * The optional SQL WHERE clause that will be used to scope cleanup
+         * operations to the Store Table. When set it must include the
+         * `$tableName` placeholder for the table name. Defaults to
+         * `DpcTabularLoad.condition`.See the 'Syncing with subsets of database
+         * tables' section of the Database Persistence guide for more details.
+         * @category Configuration
+         * @since v6.1.0
+         */
+        condition?: DpcTabularCondition;
       }
     | string;
 };
@@ -879,7 +919,7 @@ export type DpcTabularValues = {
  * console.log(store.getTables());
  * // -> {pets: {toto: {species: 'dog'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * sessionStorage.clear();
  * ```
  * @example
@@ -910,7 +950,7 @@ export type DpcTabularValues = {
  * console.log(store.getTables());
  * // -> {pets: {toto: {species: 'dog'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * sessionStorage.clear();
  * ```
  * @category Persister
@@ -1037,7 +1077,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * console.log(store.getTables());
    * // -> {pets: {toto: {species: 'dog'}}}
    *
-   * persister.destroy();
+   * await persister.destroy();
    * sessionStorage.clear();
    * ```
    * @category Load
@@ -1050,8 +1090,8 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * previously started with the startAutoLoad method.
    *
    * If the Persister is not currently set to automatically load, this method
-   * has no effect.
-   * @returns A reference to the Persister object.
+   * has no effect. This method is asynchronous.
+   * @returns A Promise containing a reference to the Persister object.
    * @example
    * This example creates an empty Store, and starts automatically loading data
    * into it from the browser's session storage. Once the automatic loading is
@@ -1072,7 +1112,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * console.log(store.getTables());
    * // -> {pets: {toto: {species: 'dog'}}}
    *
-   * persister.stopAutoLoad();
+   * await persister.stopAutoLoad();
    *
    * // In another browser tab:
    * sessionStorage.setItem(
@@ -1085,13 +1125,13 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * // -> {pets: {toto: {species: 'dog'}}}
    * // Storage change has not been automatically loaded.
    *
-   * persister.destroy();
+   * await persister.destroy();
    * sessionStorage.clear();
    * ```
    * @category Load
    * @since v1.0.0
    */
-  stopAutoLoad(): this;
+  stopAutoLoad(): Promise<this>;
 
   /**
    * The isAutoLoading method lets you find out if the Persister is currently
@@ -1147,7 +1187,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * console.log(sessionStorage.getItem('pets'));
    * // -> '[{"pets":{"fido":{"species":"dog"}}},{}]'
    *
-   * persister.destroy();
+   * await persister.destroy();
    * sessionStorage.clear();
    * ```
    * @category Save
@@ -1201,8 +1241,8 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * previously started with the startAutoSave method.
    *
    * If the Persister is not currently set to automatically save, this method
-   * has no effect.
-   * @returns A reference to the Persister object.
+   * has no effect. This method is asynchronous.
+   * @returns A Promise containing a reference to the Persister object.
    * @example
    * This example creates a Store with some data, and saves into the browser's
    * session storage. Subsequent changes to the Store are then automatically
@@ -1222,7 +1262,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * console.log(sessionStorage.getItem('pets'));
    * // -> '[{"pets":{"toto":{"species":"dog"}}},{}]'
    *
-   * persister.stopAutoSave();
+   * await persister.stopAutoSave();
    *
    * store.setTables({pets: {felix: {species: 'cat'}}});
    * // ...
@@ -1235,7 +1275,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * @category Save
    * @since v1.0.0
    */
-  stopAutoSave(): this;
+  stopAutoSave(): Promise<this>;
 
   /**
    * The isAutoSaving method lets you find out if the Persister is currently
@@ -1415,8 +1455,8 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    *   async (getContent) => {
    *     // setPersisted
    *     await persister.schedule(
-   *       async () => await checkRemoteSystemIsReady(),
-   *       async () => await sendDataToRemoteSystem(getContent()),
+   *       () => checkRemoteSystemIsReady(),
+   *       () => sendDataToRemoteSystem(getContent()),
    *     );
    *   },
    *   (listener) => setInterval(listener, 1000),
@@ -1462,8 +1502,8 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * This guarantees that all of the listeners that the object registered with
    * the underlying Store and storage are removed and it can be correctly
    * garbage collected. It is equivalent to running the stopAutoLoad method and
-   * the stopAutoSave method in succession.
-   * @returns A reference to the Persister object.
+   * the stopAutoSave method in succession. This method is asynchronous.
+   * @returns A Promise containing a reference to the Persister object.
    * @example
    * This example creates a Store, associates a Persister object with it (that
    * registers a TablesListener with the underlying Store), and then destroys it
@@ -1480,7 +1520,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * console.log(store.getListenerStats().transaction);
    * // -> 1
    *
-   * persister.destroy();
+   * await persister.destroy();
    *
    * console.log(store.getListenerStats().transaction);
    * // -> 0
@@ -1488,7 +1528,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * @category Lifecycle
    * @since v1.0.0
    */
-  destroy(): this;
+  destroy(): Promise<this>;
 
   /**
    * The getStats method provides a set of statistics about the Persister, and
@@ -1528,7 +1568,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * console.log(persister.getStats());
    * // -> {loads: 2, saves: 2}
    *
-   * persister.destroy();
+   * await persister.destroy();
    * sessionStorage.clear();
    * ```
    * @category Development
@@ -1624,7 +1664,8 @@ export type DatabaseChangeListener = (tableName: string) => void;
  * called. This function can be asynchronous.
  * @param delPersisterListener A function that will unregister the listener from
  * the underlying changes to the persistence layer. It receives whatever was
- * returned from your `addPersisterListener` implementation.
+ * returned from your `addPersisterListener` implementation. This function can
+ * be asynchronous.
  * @param onIgnoredError An optional handler for the errors that the Persister
  * would otherwise ignore when trying to save or load data. This is suitable for
  * debugging persistence issues in a development environment, since v4.0.4.
@@ -1671,7 +1712,7 @@ export type DatabaseChangeListener = (tableName: string) => void;
  * console.log(store.getTables());
  * // -> {pets: {fido: {species: 'dog', color: 'brown'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @example
  * This example demonstrates a Persister creation function which returns a
@@ -1708,7 +1749,7 @@ export type DatabaseChangeListener = (tableName: string) => void;
  * await storePersister.save();
  * console.log(persistedJson);
  * // -> '[{"pets":{"fido":{"species":"dog"}}},{}]'
- * storePersister.destroy();
+ * await storePersister.destroy();
  *
  * const mergeableStore = createMergeableStore('mergeableStore1'); // !reset
  * mergeableStore.setTables({pets: {fido: {species: 'dog'}}});
@@ -1736,7 +1777,7 @@ export type DatabaseChangeListener = (tableName: string) => void;
  *   ],
  *   [{}, '', 0],
  * ];
- * mergeableStorePersister.destroy();
+ * await mergeableStorePersister.destroy();
  * ```
  * @category Creation
  * @since v1.0.0
@@ -1754,7 +1795,9 @@ export function createCustomPersister<
   addPersisterListener: (
     listener: PersisterListener<Persist>,
   ) => ListenerHandle | Promise<ListenerHandle>,
-  delPersisterListener: (listenerHandle: ListenerHandle) => void,
+  delPersisterListener: (
+    listenerHandle: ListenerHandle,
+  ) => void | Promise<void>,
   onIgnoredError?: (error: any) => void,
   persist?: Persist,
 ): Persister<Persist>;
@@ -1817,26 +1860,26 @@ export function createCustomSqlitePersister<
 ): Persister<Persist>;
 
 /**
- * The createCustomSqlitePersister function creates a Persister object that you
- * can configure to persist the Store to a PostgreSQL database.
+ * The createCustomPostgreSqlPersister function creates a Persister object that
+ * you can configure to persist the Store to a PostgreSQL database.
  *
  * This is only used when developing custom database-oriented Persisters, and
  * most TinyBase users will not need to be particularly aware of it.
  *
  * All of the TinyBase PostgreSQL-oriented Persister functions use this function
  * under the covers, and so you may wish to look at those implementations for
- * ideas on how to build your own Persister type, and as functional
- * examples. Examine the implementation of the createPostgresPersister function
- * as a good starting point, for example.
+ * ideas on how to build your own Persister type, and as functional examples.
+ * Examine the implementation of the createPostgresPersister function as a good
+ * starting point, for example.
  * @param store The Store to persist.
  * @param configOrStoreTableName A DatabasePersisterConfig object, or a string
  * that will be used as the name of the Store's table in the database.
  * @param executeCommand A function that will execute a command against the
  * database.
- * @param addChangeListener A function that will register a listener for changes
- * to the database.
- * @param delChangeListener A function that will unregister the listener for
- * changes to the database.
+ * @param addChangeListener An asynchronous function that will register a
+ * listener for changes to the database.
+ * @param delChangeListener An asynchronous function that will unregister the
+ * listener for changes to the database.
  * @param onSqlCommand A function that will be called for each SQL command
  * executed against the database.
  * @param onIgnoredError An optional handler for the errors that the Persister
@@ -1867,7 +1910,7 @@ export function createCustomPostgreSqlPersister<
     channel: string,
     listener: DatabaseChangeListener,
   ) => Promise<ListenerHandle>,
-  delChangeListener: (listenerHandle: ListenerHandle) => void,
+  delChangeListener: (listenerHandle: ListenerHandle) => void | Promise<void>,
   onSqlCommand: ((sql: string, params?: any[]) => void) | undefined,
   onIgnoredError: ((error: any) => void) | undefined,
   destroy: () => void,

package/@types/persisters/persister-automerge/index.d.ts

@@ -48,7 +48,7 @@ export interface AutomergePersister extends Persister {
    * console.log(persister.getDocHandle() == docHandler);
    * // -> true
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.3.14
@@ -92,7 +92,7 @@ export interface AutomergePersister extends Persister {
  * console.log(await docHandler.doc());
  * // -> {tinybase: {t: {pets: {fido: {species: 'dog'}}}, v: {}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @example
  * This more complex example uses Automerge networking to keep two Store objects
@@ -151,8 +151,8 @@ export interface AutomergePersister extends Persister {
  * console.log(store2.getContent());
  * // -> [{pets: {fido: {species: 'dog'}}}, {open: true}]
  *
- * persister1.destroy();
- * persister2.destroy();
+ * await persister1.destroy();
+ * await persister2.destroy();
  * ```
  * @category Creation
  * @since v4.0.0

package/@types/persisters/persister-automerge/with-schemas/index.d.ts

@@ -52,7 +52,7 @@ export interface AutomergePersister<Schemas extends OptionalSchemas>
    * console.log(persister.getDocHandle() == docHandler);
    * // -> true
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.3.14
@@ -107,7 +107,7 @@ export interface AutomergePersister<Schemas extends OptionalSchemas>
  * console.log(await docHandler.doc());
  * // -> {tinybase: {t: {pets: {fido: {species: 'dog'}}}, v: {}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @example
  * This more complex example uses Automerge networking to keep two Store objects
@@ -166,8 +166,8 @@ export interface AutomergePersister<Schemas extends OptionalSchemas>
  * console.log(store2.getContent());
  * // -> [{pets: {fido: {species: 'dog'}}}, {open: true}]
  *
- * persister1.destroy();
- * persister2.destroy();
+ * await persister1.destroy();
+ * await persister2.destroy();
  * ```
  * @category Creation
  * @since v4.0.0

package/@types/persisters/persister-browser/index.d.ts

@@ -51,7 +51,7 @@ export interface SessionPersister
    * console.log(persister.getStorageName());
    * // -> 'pets'
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.3.14
@@ -92,7 +92,7 @@ export interface LocalPersister
    * console.log(persister.getStorageName());
    * // -> 'pets'
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.3.14
@@ -130,7 +130,7 @@ export interface LocalPersister
  * console.log(sessionStorage.getItem('pets'));
  * // -> '[{"pets":{"fido":{"species":"dog"}}},{}]'
  *
- * persister.destroy();
+ * await persister.destroy();
  * sessionStorage.clear();
  * ```
  * @category Creation
@@ -172,7 +172,7 @@ export function createSessionPersister(
  * console.log(localStorage.getItem('pets'));
  * // -> '[{"pets":{"fido":{"species":"dog"}}},{}]'
  *
- * persister.destroy();
+ * await persister.destroy();
  * localStorage.clear();
  * ```
  * @category Creation

package/@types/persisters/persister-browser/with-schemas/index.d.ts

@@ -54,7 +54,7 @@ export interface SessionPersister<Schemas extends OptionalSchemas>
    * console.log(persister.getStorageName());
    * // -> 'pets'
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.3.14
@@ -95,7 +95,7 @@ export interface LocalPersister<Schemas extends OptionalSchemas>
    * console.log(persister.getStorageName());
    * // -> 'pets'
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.3.14
@@ -143,7 +143,7 @@ export interface LocalPersister<Schemas extends OptionalSchemas>
  * console.log(sessionStorage.getItem('pets'));
  * // -> '[{"pets":{"fido":{"species":"dog"}}},{}]'
  *
- * persister.destroy();
+ * await persister.destroy();
  * sessionStorage.clear();
  * ```
  * @category Creation
@@ -195,7 +195,7 @@ export function createSessionPersister<Schemas extends OptionalSchemas>(
  * console.log(localStorage.getItem('pets'));
  * // -> '[{"pets":{"fido":{"species":"dog"}}},{}]'
  *
- * persister.destroy();
+ * await persister.destroy();
  * localStorage.clear();
  * ```
  * @category Creation

package/@types/persisters/persister-cr-sqlite-wasm/index.d.ts

@@ -46,7 +46,7 @@ export interface CrSqliteWasmPersister extends Persister {
    * console.log(persister.getDb() == db);
    * // -> true
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.3.14
@@ -117,7 +117,7 @@ export interface CrSqliteWasmPersister extends Persister {
  * console.log(store.getTables());
  * // -> {pets: {felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @example
  * This example creates a CrSqliteWasmPersister object and persists the Store to
@@ -145,7 +145,7 @@ export interface CrSqliteWasmPersister extends Persister {
  * console.log(store.getTables());
  * // -> {pets: {fido: {species: 'dog'}, felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @category Creation
  * @since v4.0.0

package/@types/persisters/persister-cr-sqlite-wasm/with-schemas/index.d.ts

@@ -53,7 +53,7 @@ export interface CrSqliteWasmPersister<Schemas extends OptionalSchemas>
    * console.log(persister.getDb() == db);
    * // -> true
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.3.14
@@ -136,7 +136,7 @@ export interface CrSqliteWasmPersister<Schemas extends OptionalSchemas>
  * console.log(store.getTables());
  * // -> {pets: {felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @example
  * This example creates a CrSqliteWasmPersister object and persists the Store to
@@ -164,7 +164,7 @@ export interface CrSqliteWasmPersister<Schemas extends OptionalSchemas>
  * console.log(store.getTables());
  * // -> {pets: {fido: {species: 'dog'}, felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @category Creation
  * @since v4.0.0

package/@types/persisters/persister-electric-sql/index.d.ts

@@ -54,7 +54,7 @@ export interface ElectricSqlPersister extends Persister {
    * console.log(persister.getElectricClient() == electricClient);
    * // -> true
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.6.0
@@ -137,7 +137,7 @@ export interface ElectricSqlPersister extends Persister {
  * console.log(store.getTables());
  * // -> {pets: {felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @example
  * This example creates a ElectricSqlPersister object and persists the Store to
@@ -171,7 +171,7 @@ export interface ElectricSqlPersister extends Persister {
  * console.log(store.getTables());
  * // -> {pets: {fido: {species: 'dog'}, felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @category Creation
  * @since v4.6.0

package/@types/persisters/persister-electric-sql/with-schemas/index.d.ts

@@ -61,7 +61,7 @@ export interface ElectricSqlPersister<Schemas extends OptionalSchemas>
    * console.log(persister.getElectricClient() == electricClient);
    * // -> true
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.6.0
@@ -156,7 +156,7 @@ export interface ElectricSqlPersister<Schemas extends OptionalSchemas>
  * console.log(store.getTables());
  * // -> {pets: {felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @example
  * This example creates a ElectricSqlPersister object and persists the Store to
@@ -190,7 +190,7 @@ export interface ElectricSqlPersister<Schemas extends OptionalSchemas>
  * console.log(store.getTables());
  * // -> {pets: {fido: {species: 'dog'}, felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @category Creation
  * @since v4.6.0

package/@types/persisters/persister-expo-sqlite/index.d.ts

@@ -54,7 +54,7 @@ export interface ExpoSqlitePersister
    * console.log(persister.getDb() == db);
    * // -> true
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.5.0
@@ -137,7 +137,7 @@ export interface ExpoSqlitePersister
  * console.log(store.getTables());
  * // -> {pets: {felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @example
  * This example creates a ExpoSqlitePersister object and persists the Store
@@ -172,7 +172,7 @@ export interface ExpoSqlitePersister
  * console.log(store.getTables());
  * // -> {pets: {fido: {species: 'dog'}, felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @category Creation
  * @since v4.5.0

package/@types/persisters/persister-expo-sqlite/with-schemas/index.d.ts

@@ -61,7 +61,7 @@ export interface ExpoSqlitePersister<Schemas extends OptionalSchemas>
    * console.log(persister.getDb() == db);
    * // -> true
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.5.0
@@ -156,7 +156,7 @@ export interface ExpoSqlitePersister<Schemas extends OptionalSchemas>
  * console.log(store.getTables());
  * // -> {pets: {felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @example
  * This example creates a ExpoSqlitePersister object and persists the Store
@@ -191,7 +191,7 @@ export interface ExpoSqlitePersister<Schemas extends OptionalSchemas>
  * console.log(store.getTables());
  * // -> {pets: {fido: {species: 'dog'}, felix: {species: 'cat'}}}
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @category Creation
  * @since v4.5.0

package/@types/persisters/persister-file/index.d.ts

@@ -43,7 +43,7 @@ export interface FilePersister
    * console.log(persister.getFilePath());
    * // -> '/app/persisted.json'
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.3.14
@@ -82,7 +82,7 @@ export interface FilePersister
  * await persister.load();
  * // Store JSON will be loaded from the file.
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @category Creation
  * @since v1.0.0

package/@types/persisters/persister-file/with-schemas/index.d.ts

@@ -46,7 +46,7 @@ export interface FilePersister<Schemas extends OptionalSchemas>
    * console.log(persister.getFilePath());
    * // -> '/app/persisted.json'
    *
-   * persister.destroy();
+   * await persister.destroy();
    * ```
    * @category Getter
    * @since v4.3.14
@@ -95,7 +95,7 @@ export interface FilePersister<Schemas extends OptionalSchemas>
  * await persister.load();
  * // Store JSON will be loaded from the file.
  *
- * persister.destroy();
+ * await persister.destroy();
  * ```
  * @category Creation
  * @since v1.0.0