tinybase 5.0.0-beta.26 → 5.0.0-beta.28

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

@@ -2,7 +2,7 @@
  * The persister-powersync module of the TinyBase project lets you save and load
  * Store data to and from a local SQLite database that is automatically synced
  * using the PowerSync service.
- * @see Persisting Data guide
+ * @see Database Persistence guide
  * @packageDocumentation
  * @module persister-powersync
  * @since v4.8.0
@@ -19,14 +19,17 @@ import type {
 import type {AbstractPowerSyncDatabase} from '@journeyapps/powersync-sdk-common';
 
 /**
- * The PowerSyncPersister interface is a minor extension to the Persister
- * interface.
- *
- * It simply provides an extra getPowerSync method for accessing a reference to
- * the PowerSync instance the Store is being persisted to.
+ * The PowerSyncPersister interface represents a Persister that lets you save
+ * and load Store data to and from a local SQLite database that is automatically
+ * synced using the PowerSync service.
  *
  * You should use the createPowerSyncPersister function to create a
  * PowerSyncPersister object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getPowerSync method for accessing a reference to the PowerSync instance
+ * the Store is being persisted to.
+ * @category Persister
  * @since v4.8.0
  */
 export interface PowerSyncPersister<Schemas extends OptionalSchemas>
@@ -60,9 +63,9 @@ export interface PowerSyncPersister<Schemas extends OptionalSchemas>
 }
 
 /**
- * The createPowerSyncPersister function creates a Persister object that can
- * persist the Store to a local SQLite database that is automatically synced
- * using the PowerSync service.
+ * The createPowerSyncPersister function creates a PowerSyncPersister object
+ * that can persist the Store to a local SQLite database that is automatically
+ * synced using the PowerSync service.
  *
  * This has schema-based typing. The following is a simplified representation:
  *
@@ -76,6 +79,9 @@ export interface PowerSyncPersister<Schemas extends OptionalSchemas>
  * ): PowerSyncPersister;
  * ```
  *
+ * A PowerSyncPersister only supports regular Store objects, and cannot be used
+ * to persist the metadata of a MergeableStore.
+ *
  * As well as providing a reference to the Store to persist, you must provide a
  * `powerSync` parameter which identifies the PowerSync instance.
  *

package/@types/persisters/persister-remote/index.d.cts

@@ -1,23 +1,24 @@
 /**
  * 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
+ * @see Persistence guides
  * @packageDocumentation
  * @module persister-remote
+ * @since v1.0.0
  */
 
 import type {Persister} from '../index.d.cts';
 import type {Store} from '../../store/index.d.cts';
 
 /**
- * The RemotePersister interface is a minor extension to the Persister
- * interface.
- *
- * It simply provides an extra getUrls method for accessing the URLs the Store
- * is being persisted to.
+ * The RemotePersister interface represents a Persister that lets you save and
+ * load Store data to and from a remote server.
  *
  * You should use the createRemotePersister function to create a RemotePersister
  * object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getUrls method for accessing the URLs the Store is being persisted to.
  * @category Persister
  * @since v4.3.14
  */
@@ -53,18 +54,21 @@ export interface RemotePersister extends Persister {
 }
 
 /**
- * The createRemotePersister function creates a Persister object that can
+ * The createRemotePersister function creates a RemotePersister object that can
  * persist the Store to a remote server.
  *
+ * A RemotePersister only supports regular Store objects, and cannot be used to
+ * persist the metadata of a MergeableStore.
+ *
  * 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, using the
- * `ETag` HTTP header to identify if things have changed. The
- * `autoLoadIntervalSeconds` method is used to indicate how often to do this.
+ * startAutoLoad method), it will poll the loadUrl for changes, using the `ETag`
+ * HTTP header to identify if things have changed. The `autoLoadIntervalSeconds`
+ * method is used to indicate how often to do this.
  *
  * If you are implementing the server portion of this functionality yourself,
  * remember to ensure that the `ETag` header changes every time the server's
@@ -103,6 +107,7 @@ export interface RemotePersister extends Persister {
  * persister.destroy();
  * ```
  * @category Creation
+ * @since v1.0.0
  */
 export function createRemotePersister(
   store: Store,

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

@@ -1,23 +1,24 @@
 /**
  * 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
+ * @see Persistence guides
  * @packageDocumentation
  * @module persister-remote
+ * @since v1.0.0
  */
 
 import type {Persister} from '../index.d.ts';
 import type {Store} from '../../store/index.d.ts';
 
 /**
- * The RemotePersister interface is a minor extension to the Persister
- * interface.
- *
- * It simply provides an extra getUrls method for accessing the URLs the Store
- * is being persisted to.
+ * The RemotePersister interface represents a Persister that lets you save and
+ * load Store data to and from a remote server.
  *
  * You should use the createRemotePersister function to create a RemotePersister
  * object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getUrls method for accessing the URLs the Store is being persisted to.
  * @category Persister
  * @since v4.3.14
  */
@@ -53,18 +54,21 @@ export interface RemotePersister extends Persister {
 }
 
 /**
- * The createRemotePersister function creates a Persister object that can
+ * The createRemotePersister function creates a RemotePersister object that can
  * persist the Store to a remote server.
  *
+ * A RemotePersister only supports regular Store objects, and cannot be used to
+ * persist the metadata of a MergeableStore.
+ *
  * 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, using the
- * `ETag` HTTP header to identify if things have changed. The
- * `autoLoadIntervalSeconds` method is used to indicate how often to do this.
+ * startAutoLoad method), it will poll the loadUrl for changes, using the `ETag`
+ * HTTP header to identify if things have changed. The `autoLoadIntervalSeconds`
+ * method is used to indicate how often to do this.
  *
  * If you are implementing the server portion of this functionality yourself,
  * remember to ensure that the `ETag` header changes every time the server's
@@ -103,6 +107,7 @@ export interface RemotePersister extends Persister {
  * persister.destroy();
  * ```
  * @category Creation
+ * @since v1.0.0
  */
 export function createRemotePersister(
   store: Store,

package/@types/persisters/persister-remote/with-schemas/index.d.cts

@@ -1,9 +1,10 @@
 /**
  * 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
+ * @see Persistence guides
  * @packageDocumentation
  * @module persister-remote
+ * @since v1.0.0
  */
 
 import type {
@@ -13,14 +14,14 @@ import type {
 import type {Persister} from '../../with-schemas/index.d.cts';
 
 /**
- * The RemotePersister interface is a minor extension to the Persister
- * interface.
- *
- * It simply provides an extra getUrls method for accessing the URLs the Store
- * is being persisted to.
+ * The RemotePersister interface represents a Persister that lets you save and
+ * load Store data to and from a remote server.
  *
  * You should use the createRemotePersister function to create a RemotePersister
  * object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getUrls method for accessing the URLs the Store is being persisted to.
  * @category Persister
  * @since v4.3.14
  */
@@ -57,7 +58,7 @@ export interface RemotePersister<Schemas extends OptionalSchemas>
 }
 
 /**
- * The createRemotePersister function creates a Persister object that can
+ * The createRemotePersister function creates a RemotePersister object that can
  * persist the Store to a remote server.
  *
  * This has schema-based typing. The following is a simplified representation:
@@ -72,15 +73,18 @@ export interface RemotePersister<Schemas extends OptionalSchemas>
  * ): RemotePersister;
  * ```
  *
+ * A RemotePersister only supports regular Store objects, and cannot be used to
+ * persist the metadata of a MergeableStore.
+ *
  * 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, using the
- * `ETag` HTTP header to identify if things have changed. The
- * `autoLoadIntervalSeconds` method is used to indicate how often to do this.
+ * startAutoLoad method), it will poll the loadUrl for changes, using the `ETag`
+ * HTTP header to identify if things have changed. The `autoLoadIntervalSeconds`
+ * method is used to indicate how often to do this.
  *
  * If you are implementing the server portion of this functionality yourself,
  * remember to ensure that the `ETag` header changes every time the server's
@@ -119,6 +123,7 @@ export interface RemotePersister<Schemas extends OptionalSchemas>
  * persister.destroy();
  * ```
  * @category Creation
+ * @since v1.0.0
  */
 export function createRemotePersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,

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

@@ -1,9 +1,10 @@
 /**
  * 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
+ * @see Persistence guides
  * @packageDocumentation
  * @module persister-remote
+ * @since v1.0.0
  */
 
 import type {
@@ -13,14 +14,14 @@ import type {
 import type {Persister} from '../../with-schemas/index.d.ts';
 
 /**
- * The RemotePersister interface is a minor extension to the Persister
- * interface.
- *
- * It simply provides an extra getUrls method for accessing the URLs the Store
- * is being persisted to.
+ * The RemotePersister interface represents a Persister that lets you save and
+ * load Store data to and from a remote server.
  *
  * You should use the createRemotePersister function to create a RemotePersister
  * object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getUrls method for accessing the URLs the Store is being persisted to.
  * @category Persister
  * @since v4.3.14
  */
@@ -57,7 +58,7 @@ export interface RemotePersister<Schemas extends OptionalSchemas>
 }
 
 /**
- * The createRemotePersister function creates a Persister object that can
+ * The createRemotePersister function creates a RemotePersister object that can
  * persist the Store to a remote server.
  *
  * This has schema-based typing. The following is a simplified representation:
@@ -72,15 +73,18 @@ export interface RemotePersister<Schemas extends OptionalSchemas>
  * ): RemotePersister;
  * ```
  *
+ * A RemotePersister only supports regular Store objects, and cannot be used to
+ * persist the metadata of a MergeableStore.
+ *
  * 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, using the
- * `ETag` HTTP header to identify if things have changed. The
- * `autoLoadIntervalSeconds` method is used to indicate how often to do this.
+ * startAutoLoad method), it will poll the loadUrl for changes, using the `ETag`
+ * HTTP header to identify if things have changed. The `autoLoadIntervalSeconds`
+ * method is used to indicate how often to do this.
  *
  * If you are implementing the server portion of this functionality yourself,
  * remember to ensure that the `ETag` header changes every time the server's
@@ -119,6 +123,7 @@ export interface RemotePersister<Schemas extends OptionalSchemas>
  * persister.destroy();
  * ```
  * @category Creation
+ * @since v1.0.0
  */
 export function createRemotePersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,

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

@@ -2,7 +2,7 @@
  * The persister-sqlite-wasm module of the TinyBase project lets you save and
  * load Store data to and from a local SQLite database (in an appropriate
  * environment).
- * @see Persisting Data guide
+ * @see Database Persistence guide
  * @packageDocumentation
  * @module persister-sqlite-wasm
  * @since v4.0.0
@@ -13,14 +13,15 @@ import type {MergeableStore} from '../../mergeable-store/index.d.cts';
 import type {Store} from '../../store/index.d.cts';
 
 /**
- * The SqliteWasmPersister interface is a minor extension to the Persister
- * interface.
- *
- * It simply provides an extra getDb method for accessing a reference to the
- * database instance the Store is being persisted to.
+ * The SqliteWasmPersister interface represents a Persister that lets you save
+ * and load Store data to and from a local SQLite database.
  *
  * You should use the createSqliteWasmPersister function to create a
  * SqliteWasmPersister object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getDb method for accessing a reference to the database instance the
+ * Store is being persisted to.
  * @category Persister
  * @since v4.3.14
  */
@@ -61,8 +62,12 @@ export interface SqliteWasmPersister
 }
 
 /**
- * The createSqliteWasmPersister function creates a Persister object that can
- * persist the Store to a local SQLite database (in an appropriate environment).
+ * The createSqliteWasmPersister function creates a SqliteWasmPersister object
+ * that can persist the Store to a local SQLite database.
+ *
+ * A SqliteWasmPersister supports regular Store objects, and can also be used to
+ * persist the metadata of a MergeableStore when using the JSON serialization
+ * mode, as described below.
  *
  * As well as providing a reference to the Store to persist, you must provide
  * `sqlite3` and `db` parameters which identify the WASM module and database
@@ -79,7 +84,7 @@ export interface SqliteWasmPersister
  *
  * See the documentation for the DpcJson and DpcTabular types for more
  * information on how both of those modes can be configured.
- * @param store The Store to persist.
+ * @param store The Store or MergeableStore to persist.
  * @param sqlite3 The WASM module that was returned from `sqlite3InitModule`.
  * @param db The database instance that was returned from `new
  * sqlite3.oo1.DB(...)`.

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

@@ -2,7 +2,7 @@
  * The persister-sqlite-wasm module of the TinyBase project lets you save and
  * load Store data to and from a local SQLite database (in an appropriate
  * environment).
- * @see Persisting Data guide
+ * @see Database Persistence guide
  * @packageDocumentation
  * @module persister-sqlite-wasm
  * @since v4.0.0
@@ -13,14 +13,15 @@ import type {MergeableStore} from '../../mergeable-store/index.d.ts';
 import type {Store} from '../../store/index.d.ts';
 
 /**
- * The SqliteWasmPersister interface is a minor extension to the Persister
- * interface.
- *
- * It simply provides an extra getDb method for accessing a reference to the
- * database instance the Store is being persisted to.
+ * The SqliteWasmPersister interface represents a Persister that lets you save
+ * and load Store data to and from a local SQLite database.
  *
  * You should use the createSqliteWasmPersister function to create a
  * SqliteWasmPersister object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getDb method for accessing a reference to the database instance the
+ * Store is being persisted to.
  * @category Persister
  * @since v4.3.14
  */
@@ -61,8 +62,12 @@ export interface SqliteWasmPersister
 }
 
 /**
- * The createSqliteWasmPersister function creates a Persister object that can
- * persist the Store to a local SQLite database (in an appropriate environment).
+ * The createSqliteWasmPersister function creates a SqliteWasmPersister object
+ * that can persist the Store to a local SQLite database.
+ *
+ * A SqliteWasmPersister supports regular Store objects, and can also be used to
+ * persist the metadata of a MergeableStore when using the JSON serialization
+ * mode, as described below.
  *
  * As well as providing a reference to the Store to persist, you must provide
  * `sqlite3` and `db` parameters which identify the WASM module and database
@@ -79,7 +84,7 @@ export interface SqliteWasmPersister
  *
  * See the documentation for the DpcJson and DpcTabular types for more
  * information on how both of those modes can be configured.
- * @param store The Store to persist.
+ * @param store The Store or MergeableStore to persist.
  * @param sqlite3 The WASM module that was returned from `sqlite3InitModule`.
  * @param db The database instance that was returned from `new
  * sqlite3.oo1.DB(...)`.

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

@@ -2,7 +2,7 @@
  * The persister-sqlite-wasm module of the TinyBase project lets you save and
  * load Store data to and from a local SQLite database (in an appropriate
  * environment).
- * @see Persisting Data guide
+ * @see Database Persistence guide
  * @packageDocumentation
  * @module persister-sqlite-wasm
  * @since v4.0.0
@@ -20,14 +20,15 @@ import type {
 import type {MergeableStore} from '../../../mergeable-store/with-schemas/index.d.cts';
 
 /**
- * The SqliteWasmPersister interface is a minor extension to the Persister
- * interface.
- *
- * It simply provides an extra getDb method for accessing a reference to the
- * database instance the Store is being persisted to.
+ * The SqliteWasmPersister interface represents a Persister that lets you save
+ * and load Store data to and from a local SQLite database.
  *
  * You should use the createSqliteWasmPersister function to create a
  * SqliteWasmPersister object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getDb method for accessing a reference to the database instance the
+ * Store is being persisted to.
  * @category Persister
  * @since v4.3.14
  */
@@ -68,8 +69,8 @@ export interface SqliteWasmPersister<Schemas extends OptionalSchemas>
 }
 
 /**
- * The createSqliteWasmPersister function creates a Persister object that can
- * persist the Store to a local SQLite database (in an appropriate environment).
+ * The createSqliteWasmPersister function creates a SqliteWasmPersister object
+ * that can persist the Store to a local SQLite database.
  *
  * This has schema-based typing. The following is a simplified representation:
  *
@@ -84,6 +85,10 @@ export interface SqliteWasmPersister<Schemas extends OptionalSchemas>
  * ): SqliteWasmPersister;
  * ```
  *
+ * A SqliteWasmPersister supports regular Store objects, and can also be used to
+ * persist the metadata of a MergeableStore when using the JSON serialization
+ * mode, as described below.
+ *
  * As well as providing a reference to the Store to persist, you must provide
  * `sqlite3` and `db` parameters which identify the WASM module and database
  * instance respectively.
@@ -99,7 +104,7 @@ export interface SqliteWasmPersister<Schemas extends OptionalSchemas>
  *
  * See the documentation for the DpcJson and DpcTabular types for more
  * information on how both of those modes can be configured.
- * @param store The Store to persist.
+ * @param store The Store or MergeableStore to persist.
  * @param sqlite3 The WASM module that was returned from `sqlite3InitModule`.
  * @param db The database instance that was returned from `new
  * sqlite3.oo1.DB(...)`.

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

@@ -2,7 +2,7 @@
  * The persister-sqlite-wasm module of the TinyBase project lets you save and
  * load Store data to and from a local SQLite database (in an appropriate
  * environment).
- * @see Persisting Data guide
+ * @see Database Persistence guide
  * @packageDocumentation
  * @module persister-sqlite-wasm
  * @since v4.0.0
@@ -20,14 +20,15 @@ import type {
 import type {MergeableStore} from '../../../mergeable-store/with-schemas/index.d.ts';
 
 /**
- * The SqliteWasmPersister interface is a minor extension to the Persister
- * interface.
- *
- * It simply provides an extra getDb method for accessing a reference to the
- * database instance the Store is being persisted to.
+ * The SqliteWasmPersister interface represents a Persister that lets you save
+ * and load Store data to and from a local SQLite database.
  *
  * You should use the createSqliteWasmPersister function to create a
  * SqliteWasmPersister object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getDb method for accessing a reference to the database instance the
+ * Store is being persisted to.
  * @category Persister
  * @since v4.3.14
  */
@@ -68,8 +69,8 @@ export interface SqliteWasmPersister<Schemas extends OptionalSchemas>
 }
 
 /**
- * The createSqliteWasmPersister function creates a Persister object that can
- * persist the Store to a local SQLite database (in an appropriate environment).
+ * The createSqliteWasmPersister function creates a SqliteWasmPersister object
+ * that can persist the Store to a local SQLite database.
  *
  * This has schema-based typing. The following is a simplified representation:
  *
@@ -84,6 +85,10 @@ export interface SqliteWasmPersister<Schemas extends OptionalSchemas>
  * ): SqliteWasmPersister;
  * ```
  *
+ * A SqliteWasmPersister supports regular Store objects, and can also be used to
+ * persist the metadata of a MergeableStore when using the JSON serialization
+ * mode, as described below.
+ *
  * As well as providing a reference to the Store to persist, you must provide
  * `sqlite3` and `db` parameters which identify the WASM module and database
  * instance respectively.
@@ -99,7 +104,7 @@ export interface SqliteWasmPersister<Schemas extends OptionalSchemas>
  *
  * See the documentation for the DpcJson and DpcTabular types for more
  * information on how both of those modes can be configured.
- * @param store The Store to persist.
+ * @param store The Store or MergeableStore to persist.
  * @param sqlite3 The WASM module that was returned from `sqlite3InitModule`.
  * @param db The database instance that was returned from `new
  * sqlite3.oo1.DB(...)`.

package/@types/persisters/persister-sqlite3/index.d.cts

@@ -2,7 +2,7 @@
  * The persister-sqlite3 module of the TinyBase project lets you save and load
  * Store data to and from a local SQLite database (in an appropriate
  * environment).
- * @see Persisting Data guide
+ * @see Database Persistence guide
  * @packageDocumentation
  * @module persister-sqlite3
  * @since v4.0.0
@@ -14,14 +14,15 @@ import type {MergeableStore} from '../../mergeable-store/index.d.cts';
 import type {Store} from '../../store/index.d.cts';
 
 /**
- * The Sqlite3Persister interface is a minor extension to the Persister
- * interface.
- *
- * It simply provides an extra getDb method for accessing a reference to the
- * database instance the Store is being persisted to.
+ * The Sqlite3Persister interface represents a Persister that lets you save and
+ * load Store data to and from a local SQLite database.
  *
  * You should use the createSqlite3Persister function to create a
  * Sqlite3Persister object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getDb method for accessing a reference to the database instance the
+ * Store is being persisted to.
  * @category Persister
  * @since v4.3.14
  */
@@ -56,8 +57,12 @@ export interface Sqlite3Persister
 }
 
 /**
- * The createSqlite3Persister function creates a Persister object that can
- * persist the Store to a local SQLite database (in an appropriate environment).
+ * The createSqlite3Persister function creates a Sqlite3Persister object that
+ * can persist the Store to a local SQLite database.
+ *
+ * A Sqlite3Persister supports regular Store objects, and can also be used to
+ * persist the metadata of a MergeableStore when using the JSON serialization
+ * mode, as described below.
  *
  * As well as providing a reference to the Store to persist, you must provide a
  * `db` parameter which identifies the database instance.
@@ -73,7 +78,7 @@ export interface Sqlite3Persister
  *
  * See the documentation for the DpcJson and DpcTabular types for more
  * information on how both of those modes can be configured.
- * @param store The Store to persist.
+ * @param store The Store or MergeableStore to persist.
  * @param db The database instance that was returned from `new
  * sqlite3.Database(...)`.
  * @param configOrStoreTableName A DatabasePersisterConfig to configure the

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

@@ -2,7 +2,7 @@
  * The persister-sqlite3 module of the TinyBase project lets you save and load
  * Store data to and from a local SQLite database (in an appropriate
  * environment).
- * @see Persisting Data guide
+ * @see Database Persistence guide
  * @packageDocumentation
  * @module persister-sqlite3
  * @since v4.0.0
@@ -14,14 +14,15 @@ import type {MergeableStore} from '../../mergeable-store/index.d.ts';
 import type {Store} from '../../store/index.d.ts';
 
 /**
- * The Sqlite3Persister interface is a minor extension to the Persister
- * interface.
- *
- * It simply provides an extra getDb method for accessing a reference to the
- * database instance the Store is being persisted to.
+ * The Sqlite3Persister interface represents a Persister that lets you save and
+ * load Store data to and from a local SQLite database.
  *
  * You should use the createSqlite3Persister function to create a
  * Sqlite3Persister object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getDb method for accessing a reference to the database instance the
+ * Store is being persisted to.
  * @category Persister
  * @since v4.3.14
  */
@@ -56,8 +57,12 @@ export interface Sqlite3Persister
 }
 
 /**
- * The createSqlite3Persister function creates a Persister object that can
- * persist the Store to a local SQLite database (in an appropriate environment).
+ * The createSqlite3Persister function creates a Sqlite3Persister object that
+ * can persist the Store to a local SQLite database.
+ *
+ * A Sqlite3Persister supports regular Store objects, and can also be used to
+ * persist the metadata of a MergeableStore when using the JSON serialization
+ * mode, as described below.
  *
  * As well as providing a reference to the Store to persist, you must provide a
  * `db` parameter which identifies the database instance.
@@ -73,7 +78,7 @@ export interface Sqlite3Persister
  *
  * See the documentation for the DpcJson and DpcTabular types for more
  * information on how both of those modes can be configured.
- * @param store The Store to persist.
+ * @param store The Store or MergeableStore to persist.
  * @param db The database instance that was returned from `new
  * sqlite3.Database(...)`.
  * @param configOrStoreTableName A DatabasePersisterConfig to configure the