tinybase 9.6.0 → 9.7.0-beta.1

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

@@ -43,6 +43,7 @@ export * from '../persisters/persister-react-native-mmkv/index.d.ts';
 export * from '../persisters/persister-react-native-sqlite/index.d.ts';
 export * from '../persisters/persister-remote/index.d.ts';
 export * from '../persisters/persister-sqlite-bun/index.d.ts';
+export * from '../persisters/persister-sqlite-node/index.d.ts';
 export * from '../persisters/persister-sqlite-wasm/index.d.ts';
 export * from '../persisters/persister-sqlite3/index.d.ts';
 export * from '../persisters/persister-supabase/index.d.ts';

package/@types/omni/with-schemas/index.d.ts

@@ -42,6 +42,7 @@ export * from '../../persisters/persister-react-native-mmkv/with-schemas/index.d
 export * from '../../persisters/persister-react-native-sqlite/with-schemas/index.d.ts';
 export * from '../../persisters/persister-remote/with-schemas/index.d.ts';
 export * from '../../persisters/persister-sqlite-bun/with-schemas/index.d.ts';
+export * from '../../persisters/persister-sqlite-node/with-schemas/index.d.ts';
 export * from '../../persisters/persister-sqlite-wasm/with-schemas/index.d.ts';
 export * from '../../persisters/persister-sqlite3/with-schemas/index.d.ts';
 export * from '../../persisters/persister-supabase/with-schemas/index.d.ts';

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

@@ -0,0 +1,184 @@
+/**
+ * The persister-sqlite-node module of the TinyBase project lets you save and
+ * load Store data to and from a local SQLite database, via the synchronous
+ * [`node:sqlite`](https://nodejs.org/api/sqlite.html) module built into
+ * Node.js.
+ * @see Database Persistence guide
+ * @packageDocumentation
+ * @module persister-sqlite-node
+ * @since 9.7.0
+ */
+import type {DatabaseSync} from 'node:sqlite';
+import type {MergeableStore} from '../../mergeable-store/index.d.ts';
+import type {Store} from '../../store/index.d.ts';
+import type {
+  DatabasePersisterConfig,
+  DpcJson,
+  Persister,
+  Persists,
+} from '../index.d.ts';
+
+/**
+ * The SqliteNodePersister interface represents a Persister that lets you save
+ * and load Store data to and from a local SQLite database.
+ *
+ * You should use the createSqliteNodePersister function to create a
+ * SqliteNodePersister object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getDb method for accessing a reference to the database the Store is
+ * being persisted to.
+ * @category Persister
+ * @since 9.7.0
+ */
+export interface SqliteNodePersister extends Persister<Persists.StoreOrMergeableStore> {
+  /**
+   * The getDb method returns a reference to the database the Store is being
+   * persisted to.
+   * @returns A reference to the database.
+   * @example
+   * This example creates a Persister object against a newly-created Store and
+   * then gets the database back out again.
+   *
+   * ```js
+   * import {DatabaseSync} from 'node:sqlite';
+   * import {createStore} from 'tinybase';
+   * import {createSqliteNodePersister} from 'tinybase/persisters/persister-sqlite-node';
+   *
+   * const db = new DatabaseSync(':memory:');
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * const persister = createSqliteNodePersister(store, db, 'my_tinybase');
+   *
+   * console.log(persister.getDb() == db);
+   * // -> true
+   *
+   * await persister.destroy();
+   * db.close();
+   * ```
+   * @category Getter
+   * @since 9.7.0
+   */
+  getDb(): DatabaseSync;
+}
+
+/**
+ * The createSqliteNodePersister function creates a SqliteNodePersister object
+ * that can persist a Store to a local SQLite database.
+ *
+ * A SqliteNodePersister 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 is the database returned from `new DatabaseSync(...)`.
+ *
+ * Since the `node:sqlite` module is built into Node.js, this is the only
+ * SQLite-based Persister that requires no additional dependency at all. Note
+ * that the module is only available in newer versions of Node.js, and that it
+ * is still marked as experimental, so its API may change.
+ *
+ * A database Persister uses one of two modes: either a JSON serialization of
+ * the whole Store stored in a single row of a table (the default), or a tabular
+ * mapping of Table Ids to database table names and vice-versa).
+ *
+ * The third argument is a DatabasePersisterConfig object that configures which
+ * of those modes to use, and settings for each. If the third argument is simply
+ * a string, it is used as the `storeTableName` property of the JSON
+ * serialization.
+ *
+ * See the documentation for the DpcJson and DpcTabular types for more
+ * information on how both of those modes can be configured.
+ *
+ * Note that `node:sqlite` does not signal when the database changes, so if you
+ * enable automatic loading with the startAutoLoad method, it polls the database
+ * for changes. The Sqlite3Persister, which uses the asynchronous `sqlite3`
+ * module, is notified of changes as they happen, and may suit you better if
+ * that matters.
+ * @param store The Store or MergeableStore to persist.
+ * @param db The database that was returned from `new DatabaseSync(...)`.
+ * @param configOrStoreTableName A DatabasePersisterConfig to configure the
+ * persistence mode (or a string to set the `storeTableName` property of the
+ * JSON serialization).
+ * @param onSqlCommand An optional handler called every time the Persister
+ * executes a SQL command or query. This is suitable for logging persistence
+ * behavior in a development environment.
+ * @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 SqliteNodePersister object.
+ * @example
+ * This example creates a SqliteNodePersister 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
+ * import {DatabaseSync} from 'node:sqlite';
+ * import {createStore} from 'tinybase';
+ * import {createSqliteNodePersister} from 'tinybase/persisters/persister-sqlite-node';
+ *
+ * const db = new DatabaseSync(':memory:');
+ * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+ * const persister = createSqliteNodePersister(store, db, 'my_tinybase');
+ *
+ * await persister.save();
+ * // Store will be saved to the database.
+ *
+ * console.log(db.prepare('SELECT * FROM my_tinybase;').all());
+ * // -> [{_id: '_', store: '[{"pets":{"fido":{"species":"dog"}}},{}]'}]
+ *
+ * db.prepare('UPDATE my_tinybase SET store = ? WHERE _id = ?;').run(
+ *   '[{"pets":{"felix":{"species":"cat"}}},{}]',
+ *   '_',
+ * );
+ * await persister.load();
+ * console.log(store.getTables());
+ * // -> {pets: {felix: {species: 'cat'}}}
+ *
+ * await persister.destroy();
+ * db.close();
+ * ```
+ * @example
+ * This example creates a SqliteNodePersister object and persists the Store to a
+ * local SQLite database with tabular mapping.
+ *
+ * ```js
+ * import {DatabaseSync} from 'node:sqlite';
+ * import {createStore} from 'tinybase';
+ * import {createSqliteNodePersister} from 'tinybase/persisters/persister-sqlite-node';
+ *
+ * const db = new DatabaseSync(':memory:');
+ * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+ * const persister = createSqliteNodePersister(store, db, {
+ *   mode: 'tabular',
+ *   tables: {load: {pets: 'pets'}, save: {pets: 'pets'}},
+ * });
+ *
+ * await persister.save();
+ * console.log(db.prepare('SELECT * FROM pets;').all());
+ * // -> [{_id: 'fido', species: 'dog'}]
+ *
+ * db.prepare(
+ *   `INSERT INTO pets (_id, species) VALUES ('felix', 'cat')`,
+ * ).run();
+ * await persister.load();
+ * console.log(store.getTables());
+ * // -> {pets: {fido: {species: 'dog'}, felix: {species: 'cat'}}}
+ *
+ * await persister.destroy();
+ * db.close();
+ * ```
+ * @category Creation
+ * @since 9.7.0
+ */
+export function createSqliteNodePersister<StoreType extends Store>(
+  store: StoreType,
+  db: DatabaseSync,
+  configOrStoreTableName?:
+    | (NoInfer<StoreType> extends MergeableStore
+        ? DpcJson
+        : DatabasePersisterConfig)
+    | string,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
+  onIgnoredError?: (error: any) => void,
+): SqliteNodePersister;

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

@@ -0,0 +1,208 @@
+/**
+ * The persister-sqlite-node module of the TinyBase project lets you save and
+ * load Store data to and from a local SQLite database, via the synchronous
+ * [`node:sqlite`](https://nodejs.org/api/sqlite.html) module built into
+ * Node.js.
+ * @see Database Persistence guide
+ * @packageDocumentation
+ * @module persister-sqlite-node
+ * @since 9.7.0
+ */
+import type {DatabaseSync} from 'node:sqlite';
+import type {MergeableStore} from '../../../mergeable-store/with-schemas/index.d.ts';
+import type {
+  OptionalSchemas,
+  Store,
+} from '../../../store/with-schemas/index.d.ts';
+import type {
+  DatabasePersisterConfig,
+  DpcJson,
+  Persister,
+  Persists,
+} from '../../with-schemas/index.d.ts';
+
+/**
+ * The SqliteNodePersister interface represents a Persister that lets you save
+ * and load Store data to and from a local SQLite database.
+ *
+ * You should use the createSqliteNodePersister function to create a
+ * SqliteNodePersister object.
+ *
+ * It is a minor extension to the Persister interface and simply provides an
+ * extra getDb method for accessing a reference to the database the Store is
+ * being persisted to.
+ * @category Persister
+ * @since 9.7.0
+ */
+export interface SqliteNodePersister<
+  Schemas extends OptionalSchemas,
+> extends Persister<Schemas, Persists.StoreOrMergeableStore> {
+  /**
+   * The getDb method returns a reference to the database the Store is being
+   * persisted to.
+   * @returns A reference to the database.
+   * @example
+   * This example creates a Persister object against a newly-created Store and
+   * then gets the database back out again.
+   *
+   * ```js
+   * import {DatabaseSync} from 'node:sqlite';
+   * import {createStore} from 'tinybase';
+   * import {createSqliteNodePersister} from 'tinybase/persisters/persister-sqlite-node';
+   *
+   * const db = new DatabaseSync(':memory:');
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * const persister = createSqliteNodePersister(store, db, 'my_tinybase');
+   *
+   * console.log(persister.getDb() == db);
+   * // -> true
+   *
+   * await persister.destroy();
+   * db.close();
+   * ```
+   * @category Getter
+   * @since 9.7.0
+   */
+  getDb(): DatabaseSync;
+}
+
+/**
+ * The createSqliteNodePersister function creates a SqliteNodePersister object
+ * that can persist a Store to a local SQLite database.
+ *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * createSqliteNodePersister<StoreType extends Store>(
+ *   store: StoreType,
+ *   db: DatabaseSync,
+ *   configOrStoreTableName?:
+ *     | (NoInfer<StoreType> extends MergeableStore
+ *         ? DpcJson
+ *         : DatabasePersisterConfig)
+ *     | string,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
+ *   onIgnoredError?: (error: any) => void,
+ * ): SqliteNodePersister;
+ * ```
+ *
+ * A SqliteNodePersister 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 is the database returned from `new DatabaseSync(...)`.
+ *
+ * Since the `node:sqlite` module is built into Node.js, this is the only
+ * SQLite-based Persister that requires no additional dependency at all. Note
+ * that the module is only available in newer versions of Node.js, and that it
+ * is still marked as experimental, so its API may change.
+ *
+ * A database Persister uses one of two modes: either a JSON serialization of
+ * the whole Store stored in a single row of a table (the default), or a tabular
+ * mapping of Table Ids to database table names and vice-versa).
+ *
+ * The third argument is a DatabasePersisterConfig object that configures which
+ * of those modes to use, and settings for each. If the third argument is simply
+ * a string, it is used as the `storeTableName` property of the JSON
+ * serialization.
+ *
+ * See the documentation for the DpcJson and DpcTabular types for more
+ * information on how both of those modes can be configured.
+ *
+ * Note that `node:sqlite` does not signal when the database changes, so if you
+ * enable automatic loading with the startAutoLoad method, it polls the database
+ * for changes. The Sqlite3Persister, which uses the asynchronous `sqlite3`
+ * module, is notified of changes as they happen, and may suit you better if
+ * that matters.
+ * @param store The Store or MergeableStore to persist.
+ * @param db The database that was returned from `new DatabaseSync(...)`.
+ * @param configOrStoreTableName A DatabasePersisterConfig to configure the
+ * persistence mode (or a string to set the `storeTableName` property of the
+ * JSON serialization).
+ * @param onSqlCommand An optional handler called every time the Persister
+ * executes a SQL command or query. This is suitable for logging persistence
+ * behavior in a development environment.
+ * @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 SqliteNodePersister object.
+ * @example
+ * This example creates a SqliteNodePersister 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
+ * import {DatabaseSync} from 'node:sqlite';
+ * import {createStore} from 'tinybase';
+ * import {createSqliteNodePersister} from 'tinybase/persisters/persister-sqlite-node';
+ *
+ * const db = new DatabaseSync(':memory:');
+ * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+ * const persister = createSqliteNodePersister(store, db, 'my_tinybase');
+ *
+ * await persister.save();
+ * // Store will be saved to the database.
+ *
+ * console.log(db.prepare('SELECT * FROM my_tinybase;').all());
+ * // -> [{_id: '_', store: '[{"pets":{"fido":{"species":"dog"}}},{}]'}]
+ *
+ * db.prepare('UPDATE my_tinybase SET store = ? WHERE _id = ?;').run(
+ *   '[{"pets":{"felix":{"species":"cat"}}},{}]',
+ *   '_',
+ * );
+ * await persister.load();
+ * console.log(store.getTables());
+ * // -> {pets: {felix: {species: 'cat'}}}
+ *
+ * await persister.destroy();
+ * db.close();
+ * ```
+ * @example
+ * This example creates a SqliteNodePersister object and persists the Store to a
+ * local SQLite database with tabular mapping.
+ *
+ * ```js
+ * import {DatabaseSync} from 'node:sqlite';
+ * import {createStore} from 'tinybase';
+ * import {createSqliteNodePersister} from 'tinybase/persisters/persister-sqlite-node';
+ *
+ * const db = new DatabaseSync(':memory:');
+ * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+ * const persister = createSqliteNodePersister(store, db, {
+ *   mode: 'tabular',
+ *   tables: {load: {pets: 'pets'}, save: {pets: 'pets'}},
+ * });
+ *
+ * await persister.save();
+ * console.log(db.prepare('SELECT * FROM pets;').all());
+ * // -> [{_id: 'fido', species: 'dog'}]
+ *
+ * db.prepare(
+ *   `INSERT INTO pets (_id, species) VALUES ('felix', 'cat')`,
+ * ).run();
+ * await persister.load();
+ * console.log(store.getTables());
+ * // -> {pets: {fido: {species: 'dog'}, felix: {species: 'cat'}}}
+ *
+ * await persister.destroy();
+ * db.close();
+ * ```
+ * @category Creation
+ * @since 9.7.0
+ */
+export function createSqliteNodePersister<Schemas extends OptionalSchemas>(
+  store: MergeableStore<Schemas>,
+  db: DatabaseSync,
+  configOrStoreTableName?: DpcJson | string,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
+  onIgnoredError?: (error: any) => void,
+): SqliteNodePersister<Schemas>;
+export function createSqliteNodePersister<Schemas extends OptionalSchemas>(
+  store: Store<Schemas> & {getMergeableContent?: never},
+  db: DatabaseSync,
+  configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
+  onIgnoredError?: (error: any) => void,
+): SqliteNodePersister<Schemas>;

package/@types/ui-react-dom/index.d.ts

@@ -692,7 +692,7 @@ export type SortedTablePaginatorProps = {
  *
  * See the <TableInHtmlTable /> (React) demo for this component in action:
  *
- * ![TableInHtmlTable example](https://tinybase.org/shots/tableinhtmltable-react-demo.png
+ * ![TableInHtmlTable example](https://beta.tinybase.org/shots/tableinhtmltable-react-demo.png
  * "TableInHtmlTable example")
  *
  * The component's props identify which Table to render based on Table Id, and
@@ -838,7 +838,7 @@ export function TableInHtmlTable(
  * See the <SortedTableInHtmlTable /> (React) demo for this component in
  * action:
  *
- * ![SortedTableInHtmlTable example](https://tinybase.org/shots/sortedtableinhtmltable-react-demo.png
+ * ![SortedTableInHtmlTable example](https://beta.tinybase.org/shots/sortedtableinhtmltable-react-demo.png
  * "SortedTableInHtmlTable example")
  *
  * The component's props identify which Table to render based on Table Id, and
@@ -1011,7 +1011,7 @@ export function SortedTableInHtmlTable(
  *
  * See the <ValuesInHtmlTable /> (React) demo for this component in action:
  *
- * ![ValuesInHtmlTable example](https://tinybase.org/shots/valuesinhtmltable-react-demo.png
+ * ![ValuesInHtmlTable example](https://beta.tinybase.org/shots/valuesinhtmltable-react-demo.png
  * "ValuesInHtmlTable example")
  *
  * The component's props identify which Row to render based on Table Id, Row Id,
@@ -1142,7 +1142,7 @@ export function ValuesInHtmlTable(
  *
  * See the <SliceInHtmlTable /> (React) demo for this component in action:
  *
- * ![SliceInHtmlTable example](https://tinybase.org/shots/sliceinhtmltable-react-demo.png
+ * ![SliceInHtmlTable example](https://beta.tinybase.org/shots/sliceinhtmltable-react-demo.png
  * "SliceInHtmlTable example")
  *
  * The component's props identify which Slice to render based on Index Id, Slice
@@ -1300,7 +1300,7 @@ export function SliceInHtmlTable(
  * See the <RelationshipInHtmlTable /> (React) demo for this component in
  * action:
  *
- * ![RelationshipInHtmlTable example](https://tinybase.org/shots/relationshipinhtmltable-react-demo.png
+ * ![RelationshipInHtmlTable example](https://beta.tinybase.org/shots/relationshipinhtmltable-react-demo.png
  * "RelationshipInHtmlTable example")
  *
  * The component's props identify which Relationship to render based on
@@ -1478,7 +1478,7 @@ export function RelationshipInHtmlTable(
  * See the <ResultTableInHtmlTable /> (React) demo for this component in
  * action:
  *
- * ![ResultTableInHtmlTable example](https://tinybase.org/shots/resulttableinhtmltable-react-demo.png
+ * ![ResultTableInHtmlTable example](https://beta.tinybase.org/shots/resulttableinhtmltable-react-demo.png
  * "ResultTableInHtmlTable example")
  *
  * The component's props identify which ResultTable to render based on query Id,
@@ -1631,7 +1631,7 @@ export function ResultTableInHtmlTable(
  * See the <ResultSortedTableInHtmlTable /> (React) demo for this component in
  * action:
  *
- * ![ResultSortedTableInHtmlTable example](https://tinybase.org/shots/resultsortedtableinhtmltable-react-demo.png
+ * ![ResultSortedTableInHtmlTable example](https://beta.tinybase.org/shots/resultsortedtableinhtmltable-react-demo.png
  * "ResultSortedTableInHtmlTable example")
  *
  * The component's props identify which ResultTable to render based on query Id,
@@ -1805,7 +1805,7 @@ export function ResultSortedTableInHtmlTable(
  *
  * See the <EditableCellView /> (React) demo for this component in action:
  *
- * ![EditableCellView example](https://tinybase.org/shots/editablecellview-react-demo.png
+ * ![EditableCellView example](https://beta.tinybase.org/shots/editablecellview-react-demo.png
  * "EditableCellView example")
  *
  * The component's props identify which Cell to render based on Table Id, Row
@@ -1876,7 +1876,7 @@ export function EditableCellView(
  *
  * See the <EditableValueView /> (React) demo for this component in action:
  *
- * ![EditableValueView example](https://tinybase.org/shots/editablevalueview-react-demo.png
+ * ![EditableValueView example](https://beta.tinybase.org/shots/editablevalueview-react-demo.png
  * "EditableValueView example")
  *
  * The component's props identify which Value to render based on Table Id, Row
@@ -1947,7 +1947,7 @@ export function EditableValueView(
  * See the <SortedTableInHtmlTable /> (React) demo for this component in
  * action:
  *
- * ![SortedTablePaginator example](https://tinybase.org/shots/sortedtablepaginator-react-demo.png
+ * ![SortedTablePaginator example](https://beta.tinybase.org/shots/sortedtablepaginator-react-demo.png
  * "SortedTablePaginator example")
  *
  * The component displays 'previous' and 'next' buttons for paging through the

package/@types/ui-react-dom/with-schemas/index.d.ts

@@ -752,7 +752,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <TableInHtmlTable /> (React) demo for this component in action:
  *
- * ![TableInHtmlTable example](https://tinybase.org/shots/tableinhtmltable-react-demo.png
+ * ![TableInHtmlTable example](https://beta.tinybase.org/shots/tableinhtmltable-react-demo.png
  * "TableInHtmlTable example")
  *
  * The component's props identify which Table to render based on Table Id, and
@@ -906,7 +906,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <SortedTableInHtmlTable /> (React) demo for this component in
  * action:
  *
- * ![SortedTableInHtmlTable example](https://tinybase.org/shots/sortedtableinhtmltable-react-demo.png
+ * ![SortedTableInHtmlTable example](https://beta.tinybase.org/shots/sortedtableinhtmltable-react-demo.png
  * "SortedTableInHtmlTable example")
  *
  * The component's props identify which Table to render based on Table Id, and
@@ -1087,7 +1087,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <ValuesInHtmlTable /> (React) demo for this component in action:
  *
- * ![ValuesInHtmlTable example](https://tinybase.org/shots/valuesinhtmltable-react-demo.png
+ * ![ValuesInHtmlTable example](https://beta.tinybase.org/shots/valuesinhtmltable-react-demo.png
  * "ValuesInHtmlTable example")
  *
  * The component's props identify which Row to render based on Table Id, Row Id,
@@ -1226,7 +1226,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <SliceInHtmlTable /> (React) demo for this component in action:
  *
- * ![SliceInHtmlTable example](https://tinybase.org/shots/sliceinhtmltable-react-demo.png
+ * ![SliceInHtmlTable example](https://beta.tinybase.org/shots/sliceinhtmltable-react-demo.png
  * "SliceInHtmlTable example")
  *
  * The component's props identify which Slice to render based on Index Id, Slice
@@ -1392,7 +1392,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <RelationshipInHtmlTable /> (React) demo for this component in
  * action:
  *
- * ![RelationshipInHtmlTable example](https://tinybase.org/shots/relationshipinhtmltable-react-demo.png
+ * ![RelationshipInHtmlTable example](https://beta.tinybase.org/shots/relationshipinhtmltable-react-demo.png
  * "RelationshipInHtmlTable example")
  *
  * The component's props identify which Relationship to render based on
@@ -1578,7 +1578,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <ResultTableInHtmlTable /> (React) demo for this component in
  * action:
  *
- * ![ResultTableInHtmlTable example](https://tinybase.org/shots/resulttableinhtmltable-react-demo.png
+ * ![ResultTableInHtmlTable example](https://beta.tinybase.org/shots/resulttableinhtmltable-react-demo.png
  * "ResultTableInHtmlTable example")
  *
  * The component's props identify which ResultTable to render based on query Id,
@@ -1739,7 +1739,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <ResultSortedTableInHtmlTable /> (React) demo for this component in
  * action:
  *
- * ![ResultSortedTableInHtmlTable example](https://tinybase.org/shots/resultsortedtableinhtmltable-react-demo.png
+ * ![ResultSortedTableInHtmlTable example](https://beta.tinybase.org/shots/resultsortedtableinhtmltable-react-demo.png
  * "ResultSortedTableInHtmlTable example")
  *
  * The component's props identify which ResultTable to render based on query Id,
@@ -1921,7 +1921,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <EditableCellView /> (React) demo for this component in action:
  *
- * ![EditableCellView example](https://tinybase.org/shots/editablecellview-react-demo.png
+ * ![EditableCellView example](https://beta.tinybase.org/shots/editablecellview-react-demo.png
  * "EditableCellView example")
  *
  * The component's props identify which Cell to render based on Table Id, Row
@@ -2006,7 +2006,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <EditableValueView /> (React) demo for this component in action:
  *
- * ![EditableValueView example](https://tinybase.org/shots/editablevalueview-react-demo.png
+ * ![EditableValueView example](https://beta.tinybase.org/shots/editablevalueview-react-demo.png
  * "EditableValueView example")
  *
  * The component's props identify which Value to render based on Table Id, Row
@@ -2077,7 +2077,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <SortedTableInHtmlTable /> (React) demo for this component in
  * action:
  *
- * ![SortedTablePaginator example](https://tinybase.org/shots/sortedtablepaginator-react-demo.png
+ * ![SortedTablePaginator example](https://beta.tinybase.org/shots/sortedtablepaginator-react-demo.png
  * "SortedTablePaginator example")
  *
  * The component displays 'previous' and 'next' buttons for paging through the

package/@types/ui-react-dom-charts/index.d.ts

@@ -483,7 +483,7 @@ export type YAxisProps = {
  *
  * See the Composing Charts (React) demo for this component in action:
  *
- * ![CartesianChart component example](https://tinybase.org/shots/composing-charts-react-demo.png
+ * ![CartesianChart component example](https://beta.tinybase.org/shots/composing-charts-react-demo.png
  * "CartesianChart component example")
  *
  * The series children declare their own xCellId and yCellId bindings. The
@@ -542,7 +542,7 @@ export function CartesianChart(
  *
  * See the Axis Overrides (React) demo for this component in action:
  *
- * ![XAxis component example](https://tinybase.org/shots/axis-overrides-react-demo.png
+ * ![XAxis component example](https://beta.tinybase.org/shots/axis-overrides-react-demo.png
  * "XAxis component example")
  * @category Store components
  * @since v8.5.0
@@ -558,7 +558,7 @@ export function XAxis(props: XAxisProps): ComponentReturnType;
  *
  * See the Axis Overrides (React) demo for this component in action:
  *
- * ![YAxis component example](https://tinybase.org/shots/axis-overrides-react-demo.png
+ * ![YAxis component example](https://beta.tinybase.org/shots/axis-overrides-react-demo.png
  * "YAxis component example")
  * @category Store components
  * @since v8.5.0
@@ -574,7 +574,7 @@ export function YAxis(props: YAxisProps): ComponentReturnType;
  *
  * See the Composing Charts (React) demo for this component in action:
  *
- * ![LineSeries component example](https://tinybase.org/shots/composing-charts-react-demo.png
+ * ![LineSeries component example](https://beta.tinybase.org/shots/composing-charts-react-demo.png
  * "LineSeries component example")
  * @category Store components
  * @since v8.5.0
@@ -590,7 +590,7 @@ export function LineSeries(props: SeriesProps): ComponentReturnType;
  *
  * See the Composing Charts (React) demo for this component in action:
  *
- * ![BarSeries component example](https://tinybase.org/shots/composing-charts-react-demo.png
+ * ![BarSeries component example](https://beta.tinybase.org/shots/composing-charts-react-demo.png
  * "BarSeries component example")
  * @category Store components
  * @since v8.5.0
@@ -607,7 +607,7 @@ export function BarSeries(props: SeriesProps): ComponentReturnType;
  *
  * See the <LineChart /> (React) demo for this component in action:
  *
- * ![LineChart component example](https://tinybase.org/shots/basic-chart-react-demo.png "LineChart
+ * ![LineChart component example](https://beta.tinybase.org/shots/basic-chart-react-demo.png "LineChart
  * component example")
  * @category Store components
  * @since v8.5.0
@@ -660,7 +660,7 @@ export function LineChart(
  *
  * See the Sorting And Types (React) demo for this component in action:
  *
- * ![BarChart component example](https://tinybase.org/shots/sorting-and-types-react-demo.png
+ * ![BarChart component example](https://beta.tinybase.org/shots/sorting-and-types-react-demo.png
  * "BarChart component example")
  * @category Store components
  * @since v8.5.0