tinybase 5.0.0-beta.17 → 5.0.0-beta.18

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

@@ -236,6 +236,8 @@ export type MetricsListenerStats = {
  * removing a listener for it.
  *
  * ```js
+ * import {createMetrics, createStore} from 'tinybase';
+ *
  * const store = createStore().setTable('species', {
  *   dog: {price: 5},
  *   cat: {price: 4},
@@ -336,6 +338,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * simple Metric to count the Row objects in the Table.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -354,6 +358,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * objects in the Table.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -371,6 +377,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * custom Metric to get the lowest value of each `price` Cell, greater than 2.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -395,6 +403,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * functions.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -428,6 +438,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * custom Metric to get the average value of a discounted price.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5, discount: 0.3},
    *   cat: {price: 4, discount: 0.2},
@@ -474,6 +486,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * ```
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -508,6 +522,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * ```
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const metrics = createMetrics(createStore());
    * metrics.setMetricDefinition('speciesCount', 'species');
    * metrics.getStore().setCell('species', 'dog', 'price', 5);
@@ -527,6 +543,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * the Ids of the definitions.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const metrics = createMetrics(createStore())
    *   .setMetricDefinition('speciesCount', 'species')
    *   .setMetricDefinition('petsCount', 'pets');
@@ -550,6 +568,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * This example iterates over each Metric in a Metrics object.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -578,6 +598,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * This example shows two simple Metric existence checks.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore();
    * const metrics = createMetrics(store);
    * metrics.setMetricDefinition('highestPrice', 'species', 'max', 'price');
@@ -612,6 +634,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * queries it (and a non-existent definition) to get the underlying Table Id.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const metrics = createMetrics(createStore());
    * metrics.setMetricDefinition('speciesCount', 'species');
    *
@@ -640,6 +664,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * been defined).
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -679,6 +705,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * definition.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -729,6 +757,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * listener that responds to any changes to a specific Metric.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -740,7 +770,7 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    *
    * const listenerId = metrics.addMetricListener(
    *   'highestPrice',
-   *   (metrics, metricId, newMetric, oldMetric) => {
+   *   (metrics, _metricId, newMetric, oldMetric) => {
    *     console.log('highestPrice metric changed');
    *     console.log([oldMetric, newMetric]);
    *   },
@@ -757,6 +787,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * listener that responds to any changes to any Metric.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -806,6 +838,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * then removes it.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -815,12 +849,9 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * const metrics = createMetrics(store);
    * metrics.setMetricDefinition('highestPrice', 'species', 'max', 'price');
    *
-   * const listenerId = metrics.addMetricListener(
-   *   'highestPrice',
-   *   (metrics, metricId, newMetric, oldMetric) => {
-   *     console.log('highestPrice metric changed');
-   *   },
-   * );
+   * const listenerId = metrics.addMetricListener('highestPrice', () => {
+   *   console.log('highestPrice metric changed');
+   * });
    *
    * store.setCell('species', 'horse', 'price', 20);
    * // -> 'highestPrice metric changed'
@@ -847,6 +878,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * again, removing the listener.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('species', {
    *   dog: {price: 5},
    *   cat: {price: 4},
@@ -882,6 +915,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
    * This example gets the listener statistics of a Metrics object.
    *
    * ```js
+   * import {createMetrics, createStore} from 'tinybase';
+   *
    * const store = createStore();
    * const metrics = createMetrics(store);
    * metrics.addMetricListener(null, () => console.log('Metric changed'));
@@ -913,6 +948,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
  * This example creates a Metrics object.
  *
  * ```js
+ * import {createMetrics, createStore} from 'tinybase';
+ *
  * const store = createStore();
  * const metrics = createMetrics(store);
  * console.log(metrics.getMetricIds());
@@ -923,6 +960,8 @@ export interface Metrics<in out Schemas extends OptionalSchemas> {
  * for the same Store to return the same object.
  *
  * ```js
+ * import {createMetrics, createStore} from 'tinybase';
+ *
  * const store = createStore();
  * const metrics1 = createMetrics(store);
  * const metrics2 = createMetrics(store);

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

@@ -38,7 +38,11 @@ export interface AutomergePersister<Schemas extends OptionalSchemas>
    * then gets the Automerge document handler back out again.
    *
    * ```js
-   * const docHandler = new AutomergeRepo.Repo({network: []}).create();
+   * import {Repo} from '@automerge/automerge-repo';
+   * import {createAutomergePersister} from 'tinybase/persisters/persister-automerge';
+   * import {createStore} from 'tinybase';
+   *
+   * const docHandler = new Repo({network: []}).create();
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const persister = createAutomergePersister(store, docHandler);
    *
@@ -83,7 +87,11 @@ export interface AutomergePersister<Schemas extends OptionalSchemas>
  * Automerge document.
  *
  * ```js
- * const docHandler = new AutomergeRepo.Repo({network: []}).create();
+ * import {Repo} from '@automerge/automerge-repo';
+ * import {createAutomergePersister} from 'tinybase/persisters/persister-automerge';
+ * import {createStore} from 'tinybase';
+ *
+ * const docHandler = new Repo({network: []}).create();
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createAutomergePersister(store, docHandler);
  *
@@ -101,8 +109,13 @@ export interface AutomergePersister<Schemas extends OptionalSchemas>
  * each other using a network.
  *
  * ```js
+ * import {BroadcastChannelNetworkAdapter} from '@automerge/automerge-repo-network-broadcastchannel';
+ * import {Repo} from '@automerge/automerge-repo';
+ * import {createAutomergePersister} from 'tinybase/persisters/persister-automerge';
+ * import {createStore} from 'tinybase';
+ *
  * // Bind the first Store to a network-enabled automerge-repo
- * const repo1 = new AutomergeRepo.Repo({
+ * const repo1 = new Repo({
  *   network: [new BroadcastChannelNetworkAdapter()],
  * });
  * const docHandler1 = repo1.create();
@@ -113,7 +126,7 @@ export interface AutomergePersister<Schemas extends OptionalSchemas>
  * await persister1.startAutoSave();
  *
  * // Bind the second Store to a different network-enabled automerge-repo
- * const repo2 = new AutomergeRepo.Repo({
+ * const repo2 = new Repo({
  *   network: [new BroadcastChannelNetworkAdapter()],
  * });
  * const docHandler2 = repo2.find(docHandler1.documentId);

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

@@ -41,6 +41,9 @@ export interface SessionPersister<Schemas extends OptionalSchemas>
    * then gets the unique key of the storage location back out again.
    *
    * ```js
+   * import {createSessionPersister} from 'tinybase/persisters/persister-browser';
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const persister = createSessionPersister(store, 'pets');
    *
@@ -77,6 +80,9 @@ export interface LocalPersister<Schemas extends OptionalSchemas>
    * then gets the unique key of the storage location back out again.
    *
    * ```js
+   * import {createLocalPersister} from 'tinybase/persisters/persister-browser';
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const persister = createLocalPersister(store, 'pets');
    *
@@ -119,6 +125,9 @@ export interface LocalPersister<Schemas extends OptionalSchemas>
  * browser's session storage.
  *
  * ```js
+ * import {createSessionPersister} from 'tinybase/persisters/persister-browser';
+ * import {createStore} from 'tinybase';
+ *
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createSessionPersister(store, 'pets');
  *
@@ -165,6 +174,9 @@ export function createSessionPersister<Schemas extends OptionalSchemas>(
  * browser's local storage.
  *
  * ```js
+ * import {createLocalPersister} from 'tinybase/persisters/persister-browser';
+ * import {createStore} from 'tinybase';
+ *
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createLocalPersister(store, 'pets');
  *

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

@@ -35,6 +35,10 @@ export interface CrSqliteWasmPersister<Schemas extends OptionalSchemas>
    * then gets the database instance back out again.
    *
    * ```js
+   * import {createCrSqliteWasmPersister} from 'tinybase/persisters/persister-cr-sqlite-wasm';
+   * import {createStore} from 'tinybase';
+   * import initWasm from '@vlcn.io/crsqlite-wasm';
+   *
    * const crSqlite3 = await initWasm();
    * const db = await crSqlite3.open();
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
@@ -101,6 +105,10 @@ export interface CrSqliteWasmPersister<Schemas extends OptionalSchemas>
  * into the Store.
  *
  * ```js
+ * import {createCrSqliteWasmPersister} from 'tinybase/persisters/persister-cr-sqlite-wasm';
+ * import {createStore} from 'tinybase';
+ * import initWasm from '@vlcn.io/crsqlite-wasm';
+ *
  * const crSqlite3 = await initWasm();
  * const db = await crSqlite3.open();
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
@@ -127,6 +135,10 @@ export interface CrSqliteWasmPersister<Schemas extends OptionalSchemas>
  * a local SQLite database with tabular mapping.
  *
  * ```js
+ * import {createCrSqliteWasmPersister} from 'tinybase/persisters/persister-cr-sqlite-wasm';
+ * import {createStore} from 'tinybase';
+ * import initWasm from '@vlcn.io/crsqlite-wasm';
+ *
  * const crSqlite3 = await initWasm();
  * const db = await crSqlite3.open();
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});

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

@@ -35,10 +35,15 @@ export interface ElectricSqlPersister<Schemas extends OptionalSchemas>
    * then gets the Electric client back out again.
    *
    * ```js yolo
+   * import {ElectricDatabase, electrify} from 'electric-sql/wa-sqlite';
+   * import {createElectricSqlPersister} from 'tinybase/persisters/persister-electric-sql';
+   * import {createStore} from 'tinybase';
+   * import {schema} from './generated/client';
+   *
    * const electricClient = await electrify(
    *   await ElectricDatabase.init('electric.db', ''),
    *   schema,
-   *   {url: ELECTRIC_URL},
+   *   {url: import.meta.env.ELECTRIC_SERVICE},
    * );
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const persister = createElectricSqlPersister(
@@ -109,10 +114,15 @@ export interface ElectricSqlPersister<Schemas extends OptionalSchemas>
  * into the Store.
  *
  * ```js yolo
+ * import {ElectricDatabase, electrify} from 'electric-sql/wa-sqlite';
+ * import {createElectricSqlPersister} from 'tinybase/persisters/persister-electric-sql';
+ * import {createStore} from 'tinybase';
+ * import {schema} from './generated/client';
+ *
  * const electricClient = await electrify(
  *   await ElectricDatabase.init('electric.db', ''),
  *   schema,
- *   {url: ELECTRIC_URL},
+ *   {url: import.meta.env.ELECTRIC_SERVICE},
  * );
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createElectricSqlPersister(
@@ -145,10 +155,15 @@ export interface ElectricSqlPersister<Schemas extends OptionalSchemas>
  * a local ElectricSql database with tabular mapping.
  *
  * ```js yolo
+ * import {ElectricDatabase, electrify} from 'electric-sql/wa-sqlite';
+ * import {createElectricSqlPersister} from 'tinybase/persisters/persister-electric-sql';
+ * import {createStore} from 'tinybase';
+ * import {schema} from './generated/client';
+ *
  * const electricClient = await electrify(
  *   await ElectricDatabase.init('electric.db', ''),
  *   schema,
- *   {url: ELECTRIC_URL},
+ *   {url: import.meta.env.ELECTRIC_SERVICE},
  * );
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createElectricSqlPersister(store, electricClient, {

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

@@ -22,6 +22,7 @@
 
 import {DatabasePersisterConfig, Persister} from '../persisters.d.ts';
 import {OptionalSchemas, Store} from '../store.d.ts';
+import {MergeableStore} from '../mergeable-store.d.ts';
 import {SQLiteDatabase} from 'expo-sqlite/next';
 
 /**
@@ -47,7 +48,11 @@ export interface ExpoSqliteNextPersister<Schemas extends OptionalSchemas>
    * then gets the database instance back out again.
    *
    * ```js yolo
-   * const db = SQLite.openDatabaseSync('my.db');
+   * import {createExpoSqliteNextPersister} from 'tinybase/persisters/persister-expo-sqlite-next';
+   * import {createStore} from 'tinybase';
+   * import {openDatabaseSync} from 'expo-sqlite';
+   *
+   * const db = openDatabaseSync('my.db');
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const persister = createExpoSqliteNextPersister(store, db, 'my_tinybase');
    *
@@ -71,7 +76,7 @@ export interface ExpoSqliteNextPersister<Schemas extends OptionalSchemas>
  *
  * ```ts override
  * createExpoSqliteNextPersister(
- *   store: Store,
+ *   store: Store | MergeableStore,
  *   db: SQLiteDatabase,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
  *   onSqlCommand?: (sql: string, args?: any[]) => void,
@@ -116,7 +121,11 @@ export interface ExpoSqliteNextPersister<Schemas extends OptionalSchemas>
  * into the Store.
  *
  * ```js yolo
- * const db = SQLite.openDatabaseSync('my.db');
+ * import {createExpoSqliteNextPersister} from 'tinybase/persisters/persister-expo-sqlite-next';
+ * import {createStore} from 'tinybase';
+ * import {openDatabaseSync} from 'expo-sqlite';
+ *
+ * const db = openDatabaseSync('my.db');
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createExpoSqliteNextPersister(store, db, 'my_tinybase');
  *
@@ -131,10 +140,12 @@ export interface ExpoSqliteNextPersister<Schemas extends OptionalSchemas>
  * // -> [{_id: '_', store: '[{"pets":{"fido":{"species":"dog"}}},{}]'}]
  *
  * await new Promise((resolve) =>
- *   db.allAsync(
- *     'UPDATE my_tinybase SET store = ' +
- *       `'[{"pets":{"felix":{"species":"cat"}}},{}]' WHERE _id = '_';`,
- *   ),
+ *   db
+ *     .allAsync(
+ *       'UPDATE my_tinybase SET store = ' +
+ *         `'[{"pets":{"felix":{"species":"cat"}}},{}]' WHERE _id = '_';`,
+ *     )
+ *     .then(resolve),
  * );
  * await persister.load();
  * console.log(store.getTables());
@@ -147,7 +158,11 @@ export interface ExpoSqliteNextPersister<Schemas extends OptionalSchemas>
  * to a local SQLite database with tabular mapping.
  *
  * ```js yolo
- * const db = SQLite.openDatabaseSync('my.db');
+ * import {createExpoSqliteNextPersister} from 'tinybase/persisters/persister-expo-sqlite-next';
+ * import {createStore} from 'tinybase';
+ * import {openDatabaseSync} from 'expo-sqlite';
+ *
+ * const db = openDatabaseSync('my.db');
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createExpoSqliteNextPersister(store, db, {
  *   mode: 'tabular',
@@ -177,7 +192,7 @@ export interface ExpoSqliteNextPersister<Schemas extends OptionalSchemas>
  * @since v4.5.0
  */
 export function createExpoSqliteNextPersister<Schemas extends OptionalSchemas>(
-  store: Store<Schemas>,
+  store: Store<Schemas> | MergeableStore<Schemas>,
   db: SQLiteDatabase,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
   onSqlCommand?: (sql: string, args?: any[]) => void,

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

@@ -21,6 +21,7 @@
 
 import {DatabasePersisterConfig, Persister} from '../persisters.d.ts';
 import {OptionalSchemas, Store} from '../store.d.ts';
+import {MergeableStore} from '../mergeable-store.d.ts';
 import {SQLiteDatabase} from 'expo-sqlite';
 
 /**
@@ -46,7 +47,11 @@ export interface ExpoSqlitePersister<Schemas extends OptionalSchemas>
    * then gets the database instance back out again.
    *
    * ```js yolo
-   * const db = SQLite.openDatabase('my.db');
+   * import {createExpoSqlitePersister} from 'tinybase/persisters/persister-expo-sqlite-next';
+   * import {createStore} from 'tinybase';
+   * import {openDatabase} from 'expo-sqlite';
+   *
+   * const db = openDatabase('my.db');
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const persister = createExpoSqlitePersister(store, db, 'my_tinybase');
    *
@@ -70,7 +75,7 @@ export interface ExpoSqlitePersister<Schemas extends OptionalSchemas>
  *
  * ```ts override
  * createExpoSqlitePersister(
- *   store: Store,
+ *   store: Store | MergeableStore,
  *   db: SQLiteDatabase,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
  *   onSqlCommand?: (sql: string, args?: any[]) => void,
@@ -115,7 +120,11 @@ export interface ExpoSqlitePersister<Schemas extends OptionalSchemas>
  * Store.
  *
  * ```js yolo
- * const db = SQLite.openDatabase('my.db');
+ * import {createExpoSqlitePersister} from 'tinybase/persisters/persister-expo-sqlite-next';
+ * import {createStore} from 'tinybase';
+ * import {openDatabase} from 'expo-sqlite';
+ *
+ * const db = openDatabase('my.db');
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createExpoSqlitePersister(store, db, 'my_tinybase');
  *
@@ -147,7 +156,11 @@ export interface ExpoSqlitePersister<Schemas extends OptionalSchemas>
  * local SQLite database with tabular mapping.
  *
  * ```js yolo
- * const db = SQLite.openDatabase('my.db');
+ * import {createExpoSqlitePersister} from 'tinybase/persisters/persister-expo-sqlite-next';
+ * import {createStore} from 'tinybase';
+ * import {openDatabase} from 'expo-sqlite';
+ *
+ * const db = openDatabase('my.db');
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createExpoSqlitePersister(store, db, {
  *   mode: 'tabular',
@@ -178,7 +191,7 @@ export interface ExpoSqlitePersister<Schemas extends OptionalSchemas>
  * @since v4.0.3
  */
 export function createExpoSqlitePersister<Schemas extends OptionalSchemas>(
-  store: Store<Schemas>,
+  store: Store<Schemas> | MergeableStore<Schemas>,
   db: SQLiteDatabase,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
   onSqlCommand?: (sql: string, args?: any[]) => void,

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

@@ -32,6 +32,9 @@ export interface FilePersister<Schemas extends OptionalSchemas>
    * then gets the file location back out again.
    *
    * ```js
+   * import {createFilePersister} from 'tinybase/persisters/persister-file';
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const persister = createFilePersister(store, '/app/persisted.json');
    *
@@ -73,6 +76,9 @@ export interface FilePersister<Schemas extends OptionalSchemas>
  * file.
  *
  * ```js yolo
+ * import {createFilePersister} from 'tinybase/persisters/persister-file';
+ * import {createStore} from 'tinybase';
+ *
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createFilePersister(store, '/app/persisted.json');
  *

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

@@ -32,6 +32,9 @@ export interface IndexedDbPersister<Schemas extends OptionalSchemas>
    * then gets the unique key of the IndexedDB back out again.
    *
    * ```js
+   * import {createIndexedDbPersister} from 'tinybase/persisters/persister-indexed-db';
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const persister = createIndexedDbPersister(store, 'petStore');
    *
@@ -88,6 +91,9 @@ export interface IndexedDbPersister<Schemas extends OptionalSchemas>
  * the browser's IndexedDB storage.
  *
  * ```js
+ * import {createIndexedDbPersister} from 'tinybase/persisters/persister-indexed-db';
+ * import {createStore} from 'tinybase';
+ *
  * const store = createStore()
  *   .setTable('pets', {fido: {species: 'dog'}})
  *   .setTable('species', {dog: {price: 5}})

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

@@ -34,6 +34,10 @@ export interface LibSqlPersister<Schemas extends OptionalSchemas>
    * then gets the database client back out again.
    *
    * ```js yolo
+   * import {createClient} from '@libsql/client';
+   * import {createLibSqlPersister} from 'tinybase/persisters/persister-libsql';
+   * import {createStore} from 'tinybase';
+   *
    * const client = createClient({url: 'file:my.db'});
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const persister = createLibSqlPersister(store, client, 'my_tinybase');
@@ -98,6 +102,10 @@ export interface LibSqlPersister<Schemas extends OptionalSchemas>
  * Store.
  *
  * ```js yolo
+ * import {createClient} from '@libsql/client';
+ * import {createLibSqlPersister} from 'tinybase/persisters/persister-libsql';
+ * import {createStore} from 'tinybase';
+ *
  * const client = createClient({url: 'file:my.db'});
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createLibSqlPersister(store, client, 'my_tinybase');
@@ -123,6 +131,10 @@ export interface LibSqlPersister<Schemas extends OptionalSchemas>
  * local SQLite database with tabular mapping.
  *
  * ```js yolo
+ * import {createClient} from '@libsql/client';
+ * import {createLibSqlPersister} from 'tinybase/persisters/persister-libsql';
+ * import {createStore} from 'tinybase';
+ *
  * const client = createClient({url: 'file:my.db'});
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * const persister = createLibSqlPersister(store, client, {

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

@@ -45,8 +45,12 @@ export interface PartyKitPersister<Schemas extends OptionalSchemas>
    * then gets the PartySocket back out again.
    *
    * ```js yolo
+   * import PartySocket from 'partysocket';
+   * import {createPartyKitPersister} from 'tinybase/persisters/persister-partykit-client';
+   * import {createStore} from 'tinybase';
+   *
    * const partySocket = new PartySocket({
-   *   host: PARTYKIT_HOST,
+   *   host: '127.0.0.1:1999',
    *   room: 'my_room',
    * });
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
@@ -79,7 +83,7 @@ export interface PartyKitPersister<Schemas extends OptionalSchemas>
  * to the TinyBasePartyKitServerConfig on the server side.
  *
  * ```js
- * const partyKitPersisterConfig = {
+ * export const partyKitPersisterConfig = {
  *   storeProtocol: 'http',
  *   storePath: '/my_tinybase',
  * };
@@ -163,12 +167,16 @@ export type PartyKitPersisterConfig = {
  * browser's IndexedDB storage.
  *
  * ```js yolo
+ * import PartySocket from 'partysocket';
+ * import {createPartyKitPersister} from 'tinybase/persisters/persister-partykit-client';
+ * import {createStore} from 'tinybase';
+ *
  * const store = createStore()
  *   .setTable('pets', {fido: {species: 'dog'}})
  *   .setTable('species', {dog: {price: 5}})
  *   .setValues({open: true});
  * const partySocket = new PartySocket({
- *   host: PARTYKIT_HOST,
+ *   host: '127.0.0.1:1999',
  *   room: 'my_room',
  * });
  * const persister = createPartyKitPersister(store, partySocket);