tinybase 4.3.13 → 4.3.14

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

@@ -12,6 +12,41 @@ import {DatabasePersisterConfig, Persister} from '../persisters';
 import {OptionalSchemas, Store} from '../store';
 import {DB} from '@vlcn.io/crsqlite-wasm';
 
+/**
+ * The CrSqliteWasmPersister 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.
+ * @since v4.3.14
+ */
+export interface CrSqliteWasmPersister<Schemas extends OptionalSchemas>
+  extends Persister<Schemas> {
+  /**
+   * The getDb method returns a reference to the database instance the Store is
+   * being persisted to.
+   * @returns A reference to the database instance.
+   * @example
+   * This example creates a Persister object against a newly-created Store and
+   * then gets the database instance back out again.
+   *
+   * ```js
+   * const crSqlite3 = await initWasm();
+   * const db = await crSqlite3.open();
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * const persister = createCrSqliteWasmPersister(store, db, 'my_tinybase');
+   *
+   * console.log(persister.getDb() == db);
+   * // -> true
+   *
+   * persister.destroy();
+   * ```
+   * @category Getter
+   * @since v4.3.14
+   */
+  getDb: () => DB;
+}
+
 /**
  * The createCrSqliteWasmPersister function creates a Persister object that can
  * persist the Store to a local CR-SQLite database (in an appropriate
@@ -26,7 +61,7 @@ import {DB} from '@vlcn.io/crsqlite-wasm';
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
  *   onSqlCommand?: (sql: string, args?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
- * ): Persister;
+ * ): CrSqliteWasmPersister;
  * ```
  *
  * As well as providing a reference to the Store to persist, you must provide a
@@ -54,12 +89,12 @@ import {DB} from '@vlcn.io/crsqlite-wasm';
  * @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.
- * @returns A reference to the new Persister object.
+ * @returns A reference to the new CrSqliteWasmPersister object.
  * @example
- * This example creates a Persister object and persists the Store to a local
- * CR-SQLite database as a JSON serialization into the `my_tinybase` table. It
- * makes a change to the database directly and then reloads it back into the
- * Store.
+ * This example creates a CrSqliteWasmPersister object and persists the Store to
+ * a local CR-SQLite database as a JSON serialization into the `my_tinybase`
+ * table. It makes a change to the database directly and then reloads it back
+ * into the Store.
  *
  * ```js
  * const crSqlite3 = await initWasm();
@@ -84,8 +119,8 @@ import {DB} from '@vlcn.io/crsqlite-wasm';
  * persister.destroy();
  * ```
  * @example
- * This example creates a Persister object and persists the Store to a local
- * SQLite database with tabular mapping.
+ * This example creates a CrSqliteWasmPersister object and persists the Store to
+ * a local SQLite database with tabular mapping.
  *
  * ```js
  * const crSqlite3 = await initWasm();
@@ -116,4 +151,4 @@ export function createCrSqliteWasmPersister<Schemas extends OptionalSchemas>(
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
   onSqlCommand?: (sql: string, args?: any[]) => void,
   onIgnoredError?: (error: any) => void,
-): Persister<Schemas>;
+): CrSqliteWasmPersister<Schemas>;

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

@@ -15,6 +15,40 @@ import {DatabasePersisterConfig, Persister} from '../persisters';
 import {OptionalSchemas, Store} from '../store';
 import {SQLiteDatabase} from 'expo-sqlite';
 
+/**
+ * The ExpoSqlitePersister 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.
+ * @since v4.3.14
+ */
+export interface ExpoSqlitePersister<Schemas extends OptionalSchemas>
+  extends Persister<Schemas> {
+  /**
+   * The getDb method returns a reference to the database instance the Store is
+   * being persisted to.
+   * @returns A reference to the database instance.
+   * @example
+   * This example creates a Persister object against a newly-created Store and
+   * then gets the database instance back out again.
+   *
+   * ```js yolo
+   * const db = SQLite.openDatabase('my.db');
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * const persister = createExpoSqlitePersister(store, db, 'my_tinybase');
+   *
+   * console.log(persister.getDb() == db);
+   * // -> true
+   *
+   * persister.destroy();
+   * ```
+   * @category Getter
+   * @since v4.3.14
+   */
+  getDb: () => SQLiteDatabase;
+}
+
 /**
  * The createExpoSqlitePersister function creates a Persister object that can
  * persist the Store to a local Expo-SQLite database (in an appropriate React
@@ -29,7 +63,7 @@ import {SQLiteDatabase} from 'expo-sqlite';
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
  *   onSqlCommand?: (sql: string, args?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
- * ): Persister;
+ * ): ExpoSqlitePersister;
  * ```
  *
  * Note that this Persister is currently experimental as Expo themselves iterate
@@ -61,11 +95,11 @@ import {SQLiteDatabase} from 'expo-sqlite';
  * @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.
- * @returns A reference to the new Persister object.
+ * @returns A reference to the new ExpoSqlitePersister object.
  * @example
- * This example creates a Persister object and persists the Store to a local
- * SQLite database as a JSON serialization into the `my_tinybase` table. It
- * makes a change to the database directly and then reloads it back into the
+ * This example creates a ExpoSqlitePersister object and persists the Store to a
+ * local SQLite database as a JSON serialization into the `my_tinybase` table.
+ * It makes a change to the database directly and then reloads it back into the
  * Store.
  *
  * ```js yolo
@@ -97,8 +131,8 @@ import {SQLiteDatabase} from 'expo-sqlite';
  * persister.destroy();
  * ```
  * @example
- * This example creates a Persister object and persists the Store to a local
- * SQLite database with tabular mapping.
+ * This example creates a ExpoSqlitePersister object and persists the Store to a
+ * local SQLite database with tabular mapping.
  *
  * ```js yolo
  * const db = SQLite.openDatabase('my.db');
@@ -137,4 +171,4 @@ export function createExpoSqlitePersister<Schemas extends OptionalSchemas>(
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
   onSqlCommand?: (sql: string, args?: any[]) => void,
   onIgnoredError?: (error: any) => void,
-): Persister<Schemas>;
+): ExpoSqlitePersister<Schemas>;

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

@@ -9,6 +9,38 @@
 import {OptionalSchemas, Store} from '../store';
 import {Persister} from '../persisters';
 
+/**
+ * The FilePersister interface is a minor extension to the Persister interface.
+ *
+ * It simply provides an extra getFilePath method for accessing the location of
+ * the local file the Store is being persisted to.
+ * @since v4.3.14
+ */
+export interface FilePersister<Schemas extends OptionalSchemas>
+  extends Persister<Schemas> {
+  /**
+   * The getFilePath method returns the location of the local file the Store is
+   * being persisted to.
+   * @returns The location of the local file.
+   * @example
+   * This example creates a Persister object against a newly-created Store and
+   * then gets the file location back out again.
+   *
+   * ```js
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * const persister = createFilePersister(store, '/app/persisted.json');
+   *
+   * console.log(persister.getFilePath());
+   * // -> '/app/persisted.json'
+   *
+   * persister.destroy();
+   * ```
+   * @category Getter
+   * @since v4.3.14
+   */
+  getFilePath: () => string;
+}
+
 /**
  * The createFilePersister function creates a Persister object that can persist
  * the Store to a local file (in an appropriate environment).
@@ -20,7 +52,7 @@ import {Persister} from '../persisters';
  *   store: Store,
  *   filePath: string,
  *   onIgnoredError?: (error: any) => void,
- * ): Persister;
+ * ): FilePersister;
  * ```
  *
  * As well as providing a reference to the Store to persist, you must provide a
@@ -30,9 +62,9 @@ import {Persister} from '../persisters';
  * @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.
- * @returns A reference to the new Persister object.
+ * @returns A reference to the new FilePersister object.
  * @example
- * This example creates a Persister object and persists the Store to a local
+ * This example creates a FilePersister object and persists the Store to a local
  * file.
  *
  * ```js yolo
@@ -53,4 +85,4 @@ export function createFilePersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,
   filePath: string,
   onIgnoredError?: (error: any) => void,
-): Persister<Schemas>;
+): FilePersister<Schemas>;

package/lib/types/with-schemas/persisters/persister-indexed-db.d.ts

@@ -9,6 +9,39 @@
 import {OptionalSchemas, Store} from '../store';
 import {Persister} from '../persisters';
 
+/**
+ * The IndexedDbPersister interface is a minor extension to the Persister
+ * interface.
+ *
+ * It simply provides an extra getDbName method for accessing the unique key of
+ * the IndexedDB the Store is being persisted to.
+ * @since v4.3.14
+ */
+export interface IndexedDbPersister<Schemas extends OptionalSchemas>
+  extends Persister<Schemas> {
+  /**
+   * The getDbName method returns the unique key of the IndexedDB the Store is
+   * being persisted to.
+   * @returns The unique key of the IndexedDB.
+   * @example
+   * This example creates a Persister object against a newly-created Store and
+   * then gets the unique key of the IndexedDB back out again.
+   *
+   * ```js
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * const persister = createIndexedDbPersister(store, 'petStore');
+   *
+   * console.log(persister.getDbName());
+   * // -> 'petStore'
+   *
+   * persister.destroy();
+   * ```
+   * @category Getter
+   * @since v4.3.14
+   */
+  getDbName: () => string;
+}
+
 /**
  * The createIndexedDbPersister function creates a Persister object that can
  * persist the Store to the browser's IndexedDB storage.
@@ -21,7 +54,7 @@ import {Persister} from '../persisters';
  *   dbName: string,
  *   autoLoadIntervalSeconds?: number,
  *   onIgnoredError?: (error: any) => void,
- * ): Persister;
+ * ): IndexedDbPersister;
  * ```
  *
  * As well as providing a reference to the Store to persist, you must provide a
@@ -45,10 +78,10 @@ import {Persister} from '../persisters';
  * @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.
- * @returns A reference to the new Persister object.
+ * @returns A reference to the new IndexedDbPersister object.
  * @example
- * This example creates a Persister object and persists the Store to the
- * browser's IndexedDB storage.
+ * This example creates a IndexedDbPersister object and persists the Store to
+ * the browser's IndexedDB storage.
  *
  * ```js
  * const store = createStore()
@@ -82,4 +115,4 @@ export function createIndexedDbPersister<Schemas extends OptionalSchemas>(
   dbName: string,
   autoLoadIntervalSeconds?: number,
   onIgnoredError?: (error: any) => void,
-): Persister<Schemas>;
+): IndexedDbPersister<Schemas>;

package/lib/types/with-schemas/persisters/persister-partykit-client.d.ts

@@ -23,6 +23,43 @@ import {OptionalSchemas, Store} from '../store';
 import PartySocket from 'partysocket';
 import {Persister} from '../persisters';
 
+/**
+ * The PartyKitPersister interface is a minor extension to the Persister
+ * interface.
+ *
+ * It simply provides an extra getConnection method for accessing the
+ * PartySocket the Store is being persisted to.
+ * @since v4.3.14
+ */
+export interface PartyKitPersister<Schemas extends OptionalSchemas>
+  extends Persister<Schemas> {
+  /**
+   * The getConnection method returns the PartySocket the Store is being
+   * persisted to.
+   * @returns The PartySocket.
+   * @example
+   * This example creates a Persister object against a newly-created Store and
+   * then gets the PartySocket back out again.
+   *
+   * ```js yolo
+   * const partySocket = new PartySocket({
+   *   host: PARTYKIT_HOST,
+   *   room: 'my_room',
+   * });
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * const persister = createPartyKitPersister(store, partySocket);
+   *
+   * console.log(persister.getConnection() == partySocket);
+   * // -> true
+   *
+   * persister.destroy();
+   * ```
+   * @category Getter
+   * @since v4.3.14
+   */
+  getConnection: () => PartySocket;
+}
+
 /**
  * The PartyKitPersisterConfig type describes the configuration of a PartyKit
  * Persister on the client side.
@@ -84,7 +121,7 @@ export type PartyKitPersisterConfig = {
  *   connection: PartySocket,
  *   configOrStoreProtocol?: PartyKitPersisterConfig | 'http' | 'https',
  *   onIgnoredError?: (error: any) => void,
- * ): Persister;
+ * ): PartyKitPersister;
  * ```
  *
  * As well as providing a reference to the Store to persist, you must provide a
@@ -117,9 +154,9 @@ export type PartyKitPersisterConfig = {
  * @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.
- * @returns A reference to the new Persister object.
+ * @returns A reference to the new PartyKitPersister object.
  * @example
- * This example creates a Persister object and persists the Store to the
+ * This example creates a PartyKitPersister object and persists the Store to the
  * browser's IndexedDB storage.
  *
  * ```js yolo
@@ -146,4 +183,4 @@ export function createPartyKitPersister<Schemas extends OptionalSchemas>(
   connection: PartySocket,
   configOrStoreProtocol?: PartyKitPersisterConfig | 'http' | 'https',
   onIgnoredError?: (error: any) => void,
-): Persister<Schemas>;
+): PartyKitPersister<Schemas>;

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

@@ -9,6 +9,43 @@
 import {OptionalSchemas, Store} from '../store';
 import {Persister} from '../persisters';
 
+/**
+ * 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.
+ * @since v4.3.14
+ */
+export interface RemotePersister<Schemas extends OptionalSchemas>
+  extends Persister<Schemas> {
+  /**
+   * The getUrls method returns the URLs the Store is being persisted to.
+   * @returns The load and save URLs as a two-item array.
+   * @example
+   * This example creates a RemotePersister object against a newly-created Store
+   * and then gets the URLs back out again.
+   *
+   * ```js
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * const persister = createRemotePersister(
+   *   store,
+   *   'https://example.com/load',
+   *   'https://example.com/save',
+   *   5,
+   * );
+   *
+   * console.log(persister.getUrls());
+   * // -> ['https://example.com/load', 'https://example.com/save']
+   *
+   * persister.destroy();
+   * ```
+   * @category Getter
+   * @since v4.3.14
+   */
+  getUrls: () => [string, string];
+}
+
 /**
  * The createRemotePersister function creates a Persister object that can
  * persist the Store to a remote server.
@@ -22,7 +59,7 @@ import {Persister} from '../persisters';
  *   saveUrl: string,
  *   autoLoadIntervalSeconds?: number,
  *   onIgnoredError?: (error: any) => void,
- * ): Persister;
+ * ): RemotePersister;
  * ```
  *
  * As well as providing a reference to the Store to persist, you must provide
@@ -41,10 +78,10 @@ import {Persister} from '../persisters';
  * @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.
- * @returns A reference to the new Persister object.
+ * @returns A reference to the new RemotePersister object.
  * @example
- * This example creates a Persister object and persists the Store to a remote
- * server.
+ * This example creates a RemotePersister object and persists the Store to a
+ * remote server.
  *
  * ```js yolo
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
@@ -71,4 +108,4 @@ export function createRemotePersister<Schemas extends OptionalSchemas>(
   saveUrl: string,
   autoLoadIntervalSeconds?: number,
   onIgnoredError?: (error: any) => void,
-): Persister<Schemas>;
+): RemotePersister<Schemas>;

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

@@ -11,6 +11,46 @@
 import {DatabasePersisterConfig, Persister} from '../persisters';
 import {OptionalSchemas, Store} from '../store';
 
+/**
+ * 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.
+ * @since v4.3.14
+ */
+export interface SqliteWasmPersister<Schemas extends OptionalSchemas>
+  extends Persister<Schemas> {
+  /**
+   * The getDb method returns a reference to the database instance the Store is
+   * being persisted to.
+   * @returns A reference to the database instance.
+   * @example
+   * This example creates a Persister object against a newly-created Store and
+   * then gets the database instance back out again.
+   *
+   * ```js
+   * const sqlite3 = await sqlite3InitModule();
+   * const db = new sqlite3.oo1.DB(':memory:', 'c');
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * const persister = createSqliteWasmPersister(
+   *   store,
+   *   sqlite3,
+   *   db,
+   *   'my_tinybase',
+   * );
+   *
+   * console.log(persister.getDb() == db);
+   * // -> true
+   *
+   * persister.destroy();
+   * ```
+   * @category Getter
+   * @since v4.3.14
+   */
+  getDb: () => any;
+}
+
 /**
  * The createSqliteWasmPersister function creates a Persister object that can
  * persist the Store to a local SQLite database (in an appropriate environment).
@@ -25,7 +65,7 @@ import {OptionalSchemas, Store} from '../store';
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
  *   onSqlCommand?: (sql: string, args?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
- * ): Persister;
+ * ): SqliteWasmPersister;
  * ```
  *
  * As well as providing a reference to the Store to persist, you must provide
@@ -56,11 +96,11 @@ import {OptionalSchemas, Store} from '../store';
  * @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.
- * @returns A reference to the new Persister object.
+ * @returns A reference to the new SqliteWasmPersister object.
  * @example
- * This example creates a Persister object and persists the Store to a local
- * SQLite database as a JSON serialization into the `my_tinybase` table. It
- * makes a change to the database directly and then reloads it back into the
+ * This example creates a SqliteWasmPersister object and persists the Store to a
+ * local SQLite database as a JSON serialization into the `my_tinybase` table.
+ * It makes a change to the database directly and then reloads it back into the
  * Store.
  *
  * ```js
@@ -91,8 +131,8 @@ import {OptionalSchemas, Store} from '../store';
  * persister.destroy();
  * ```
  * @example
- * This example creates a Persister object and persists the Store to a local
- * SQLite database with tabular mapping.
+ * This example creates a SqliteWasmPersister object and persists the Store to a
+ * local SQLite database with tabular mapping.
  *
  * ```js
  * const sqlite3 = await sqlite3InitModule();
@@ -124,4 +164,4 @@ export function createSqliteWasmPersister<Schemas extends OptionalSchemas>(
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
   onSqlCommand?: (sql: string, args?: any[]) => void,
   onIgnoredError?: (error: any) => void,
-): Persister<Schemas>;
+): SqliteWasmPersister<Schemas>;

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

@@ -12,6 +12,40 @@ import {DatabasePersisterConfig, Persister} from '../persisters';
 import {OptionalSchemas, Store} from '../store';
 import {Database} from 'sqlite3';
 
+/**
+ * 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.
+ * @since v4.3.14
+ */
+export interface Sqlite3Persister<Schemas extends OptionalSchemas>
+  extends Persister<Schemas> {
+  /**
+   * The getDb method returns a reference to the database instance the Store is
+   * being persisted to.
+   * @returns A reference to the database instance.
+   * @example
+   * This example creates a Persister object against a newly-created Store and
+   * then gets the database instance back out again.
+   *
+   * ```js
+   * const db = new sqlite3.Database(':memory:');
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * const persister = createSqlite3Persister(store, db, 'my_tinybase');
+   *
+   * console.log(persister.getDb() == db);
+   * // -> true
+   *
+   * persister.destroy();
+   * ```
+   * @category Getter
+   * @since v4.3.14
+   */
+  getDb: () => Database;
+}
+
 /**
  * The createSqlite3Persister function creates a Persister object that can
  * persist the Store to a local SQLite database (in an appropriate environment).
@@ -25,7 +59,7 @@ import {Database} from 'sqlite3';
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
  *   onSqlCommand?: (sql: string, args?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
- * ): Persister;
+ * ): Sqlite3Persister;
  * ```
  *
  * As well as providing a reference to the Store to persist, you must provide a
@@ -54,11 +88,11 @@ import {Database} from 'sqlite3';
  * @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.
- * @returns A reference to the new Persister object.
+ * @returns A reference to the new Sqlite3Persister object.
  * @example
- * This example creates a Persister object and persists the Store to a local
- * SQLite database as a JSON serialization into the `my_tinybase` table. It
- * makes a change to the database directly and then reloads it back into the
+ * This example creates a Sqlite3Persister object and persists the Store to a
+ * local SQLite database as a JSON serialization into the `my_tinybase` table.
+ * It makes a change to the database directly and then reloads it back into the
  * Store.
  *
  * ```js
@@ -90,8 +124,8 @@ import {Database} from 'sqlite3';
  * persister.destroy();
  * ```
  * @example
- * This example creates a Persister object and persists the Store to a local
- * SQLite database with tabular mapping.
+ * This example creates a Sqlite3Persister object and persists the Store to a
+ * local SQLite database with tabular mapping.
  *
  * ```js
  * const db = new sqlite3.Database(':memory:');

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

@@ -15,6 +15,39 @@ import {OptionalSchemas, Store} from '../store.d';
 import {Persister} from '../persisters.d';
 import {Doc as YDoc} from 'yjs';
 
+/**
+ * The YjsPersister interface is a minor extension to the Persister interface.
+ *
+ * It simply provides an extra getYDoc method for accessing the Yjs document the
+ * Store is being persisted to.
+ * @since v4.3.14
+ */
+export interface YjsPersister<Schemas extends OptionalSchemas>
+  extends Persister<Schemas> {
+  /**
+   * The getYDoc method returns the Yjs document the Store is being persisted
+   * to.
+   * @returns The Yjs document.
+   * @example
+   * This example creates a Persister object against a newly-created Store and
+   * then gets the Yjs document back out again.
+   *
+   * ```js
+   * const doc = new Y.Doc();
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * const persister = createYjsPersister(store, doc);
+   *
+   * console.log(persister.getYDoc() == doc);
+   * // -> true
+   *
+   * persister.destroy();
+   * ```
+   * @category Getter
+   * @since v4.3.14
+   */
+  getYDoc: () => YDoc;
+}
+
 /**
  * The createYjsPersister function creates a Persister object that can persist
  * the Store to a Yjs document.
@@ -27,7 +60,7 @@ import {Doc as YDoc} from 'yjs';
  *   yDoc: YDoc,
  *   yMapName?: string,
  *   onIgnoredError?: (error: any) => void,
- * ): Persister;
+ * ): YjsPersister;
  * ```
  *
  * As well as providing a reference to the Store to persist, you must provide
@@ -39,9 +72,9 @@ import {Doc as YDoc} from 'yjs';
  * @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.
- * @returns A reference to the new Persister object.
+ * @returns A reference to the new YjsPersister object.
  * @example
- * This example creates a Persister object and persists the Store to a Yjs
+ * This example creates a YjsPersister object and persists the Store to a Yjs
  * document.
  *
  * ```js
@@ -59,8 +92,8 @@ import {Doc as YDoc} from 'yjs';
  * ```
  * @example
  * This more complex example uses Yjs updates to keep two Store objects (each
- * with their own Persister objects and Yjs documents) in sync with each other.
- * We use the `await` keyword extensively for the purpose of ensuring
+ * with their own YjsPersister objects and Yjs documents) in sync with each
+ * other. We use the `await` keyword extensively for the purpose of ensuring
  * sequentiality in this example.
  *
  * Typically, real-world synchronization would happen between two systems via a
@@ -117,4 +150,4 @@ export function createYjsPersister<Schemas extends OptionalSchemas>(
   yDoc: YDoc,
   yMapName?: string,
   onIgnoredError?: (error: any) => void,
-): Persister<Schemas>;
+): YjsPersister<Schemas>;