tinybase 5.2.0-beta.4 → 5.2.0-beta.5

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

@@ -1233,7 +1233,8 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    *   getDataFromRemoteSystem,
    *   sendDataToRemoteSystem,
    * } from 'custom-remote-handlers';
-   * import {createCustomPersister, createStore} from 'tinybase';
+   * import {createCustomPersister} from 'tinybase/persisters';
+   * import {createStore} from 'tinybase';
    *
    * const store = createStore();
    * const persister = createCustomPersister(
@@ -1367,10 +1368,53 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
   //
 }
 
+/**
+ * The DatabaseExecuteCommand type describes a function that is used to execute
+ * commands against a database.
+ *
+ * This is only used when developing custom database-oriented Persisters, and
+ * most TinyBase users will not need to be particularly aware of it.
+ *
+ * It is modelled around the common pattern of database SDKs being able to
+ * execute commands with parameters, and have those (probably asynchronous)
+ * command executions return an array of objects, where each object represents a
+ * row.
+ * @param sql The SQL string to execute, which may include positional parameter
+ * placeholders.
+ * @param params An array of parameters to pass to the SQL command.
+ * @returns An promise of an array of objects, where each object represents a
+ * database result row (if the command was a query).
+ * @category Creation
+ * @since v5.2.0
+ */
+export type DatabaseExecuteCommand = (
+  sql: string,
+  params?: any[],
+) => Promise<{[field: string]: any}[]>;
+
+/**
+ * The DatabaseChangeListener type describes a function that is used to listen
+ * for changes to the data in a database.
+ *
+ * This is only used when developing custom database-oriented Persisters, and
+ * most TinyBase users will not need to be particularly aware of it.
+ *
+ * This function should be called with the name of a relevant table that has
+ * changed, possible through the use of events, triggers, or notifications,
+ * dependent on the specific database implementation.
+ * @param tableName The name of the table that has changed.
+ * @category Creation
+ * @since v5.2.0
+ */
+export type DatabaseChangeListener = (tableName: string) => void;
+
 /**
  * The createCustomPersister function creates a Persister object that you can
  * configure to persist the Store in any way you wish.
  *
+ * This is only used when developing custom Persisters, and most TinyBase users
+ * will not need to be particularly aware of it.
+ *
  * As well as providing a reference to the Store to persist, you must provide
  * functions that handle how to fetch, write, and listen to, the persistence
  * layer.
@@ -1419,7 +1463,8 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
  * Store.
  *
  * ```js
- * import {createCustomPersister, createStore} from 'tinybase';
+ * import {createCustomPersister} from 'tinybase/persisters';
+ * import {createStore} from 'tinybase';
  *
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * let persistedJson;
@@ -1458,12 +1503,8 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
  * MergeableStore.
  *
  * ```js
- * import {
- *   Persists,
- *   createCustomPersister,
- *   createMergeableStore,
- *   createStore,
- * } from 'tinybase';
+ * import {Persists, createCustomPersister} from 'tinybase/persisters';
+ * import {createMergeableStore, createStore} from 'tinybase';
  *
  * let persistedJson;
  * const createJsonPersister = (storeOrMergeableStore) =>
@@ -1523,7 +1564,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
  * @since v1.0.0
  */
 export function createCustomPersister<
-  ListeningHandle,
+  ListenerHandle,
   Persist extends Persists = Persists.StoreOnly,
 >(
   store: PersistedStore<Persist>,
@@ -1534,8 +1575,123 @@ export function createCustomPersister<
   ) => Promise<void>,
   addPersisterListener: (
     listener: PersisterListener<Persist>,
-  ) => ListeningHandle | Promise<ListeningHandle>,
-  delPersisterListener: (listeningHandle: ListeningHandle) => void,
+  ) => ListenerHandle | Promise<ListenerHandle>,
+  delPersisterListener: (listenerHandle: ListenerHandle) => void,
   onIgnoredError?: (error: any) => void,
   persist?: Persist,
 ): Persister<Persist>;
+
+/**
+ * The createCustomSqlitePersister function creates a Persister object that you
+ * can configure to persist the Store to a SQLite database.
+ *
+ * This is only used when developing custom database-oriented Persisters, and
+ * most TinyBase users will not need to be particularly aware of it.
+ *
+ * All of the TinyBase SQLite-oriented Persister functions use this function
+ * under the covers, and so you may wish to look at those implementations for
+ * ideas on how to build your own Persister type, and as functional examples.
+ * Examine the implementation of the createSqlite3Persister function as a good
+ * starting point, for example.
+ * @param store The Store to persist.
+ * @param configOrStoreTableName A DatabasePersisterConfig object, or a string
+ * that will be used as the name of the Store's table in the database.
+ * @param executeCommand A function that will execute a command against the
+ * database.
+ * @param addChangeListener A function that will register a listener for changes
+ * to the database.
+ * @param delChangeListener A function that will unregister the listener for
+ * changes to the database.
+ * @param onSqlCommand A function that will be called for each SQL command
+ * executed against the database.
+ * @param onIgnoredError A function that will be called for errors that are
+ * ignored by the Persister.
+ * @param destroy A function that will be called to perform any extra clean up
+ * on the Persister.
+ * @param persist An integer from the Persists enum to indicate which types of
+ * Store are supported by this Persister: `1` indicates only a regular Store is
+ * supported, `2` indicates only a MergeableStore is supported, and `3`
+ * indicates that both Store and MergeableStore are supported.
+ * @param thing A reference to the database or connection that can be returned
+ * with a method, by default called `getDb`.
+ * @param getThing An optional string that will be used to get the reference to
+ * the database or connection from the Persister, defaulting to `getDb`.
+ * @returns A reference to the new SQLite-oriented Persister object.
+ * @category Creation
+ * @since v5.2.0
+ */
+export function createCustomSqlitePersister<
+  ListenerHandle,
+  Persist extends Persists = Persists.StoreOnly,
+>(
+  store: PersistedStore<Persist>,
+  configOrStoreTableName: DatabasePersisterConfig | string | undefined,
+  executeCommand: DatabaseExecuteCommand,
+  addChangeListener: (listener: DatabaseChangeListener) => ListenerHandle,
+  delChangeListener: (listenerHandle: ListenerHandle) => void,
+  onSqlCommand: ((sql: string, params?: any[]) => void) | undefined,
+  onIgnoredError: ((error: any) => void) | undefined,
+  destroy: () => void,
+  persist: Persist,
+  thing: any,
+  getThing?: string,
+): Persister<Persist>;
+
+/**
+ * The createCustomSqlitePersister function creates a Persister object that you
+ * can configure to persist the Store to a PostgreSQL database.
+ *
+ * This is only used when developing custom database-oriented Persisters, and
+ * most TinyBase users will not need to be particularly aware of it.
+ *
+ * All of the TinyBase PostgreSQL-oriented Persister functions use this function
+ * under the covers, and so you may wish to look at those implementations for
+ * ideas on how to build your own Persister type, and as functional
+ * examples. Examine the implementation of the createPostgresPersister function
+ * as a good starting point, for example.
+ * @param store The Store to persist.
+ * @param configOrStoreTableName A DatabasePersisterConfig object, or a string
+ * that will be used as the name of the Store's table in the database.
+ * @param executeCommand A function that will execute a command against the
+ * database.
+ * @param addChangeListener A function that will register a listener for changes
+ * to the database.
+ * @param delChangeListener A function that will unregister the listener for
+ * changes to the database.
+ * @param onSqlCommand A function that will be called for each SQL command
+ * executed against the database.
+ * @param onIgnoredError A function that will be called for errors that are
+ * ignored by the Persister.
+ * @param destroy A function that will be called to perform any extra clean up
+ * on the Persister.
+ * @param persist An integer from the Persists enum to indicate which types of
+ * Store are supported by this Persister: `1` indicates only a regular Store is
+ * supported, `2` indicates only a MergeableStore is supported, and `3`
+ * indicates that both Store and MergeableStore are supported.
+ * @param thing A reference to the database or connection that can be returned
+ * with a method, by default called `getDb`.
+ * @param getThing An optional string that will be used to get the reference to
+ * the database or connection from the Persister, defaulting to `getDb`.
+ * @returns A reference to the new Persister object.
+ * @category Creation
+ * @since v5.2.0
+ */
+export function createCustomPostgreSqlPersister<
+  ListenerHandle,
+  Persist extends Persists = Persists.StoreOnly,
+>(
+  store: PersistedStore<Persist>,
+  configOrStoreTableName: DatabasePersisterConfig | string | undefined,
+  executeCommand: DatabaseExecuteCommand,
+  addChangeListener: (
+    channel: string,
+    listener: DatabaseChangeListener,
+  ) => Promise<ListenerHandle>,
+  delChangeListener: (listenerHandle: ListenerHandle) => void,
+  onSqlCommand: ((sql: string, params?: any[]) => void) | undefined,
+  onIgnoredError: ((error: any) => void) | undefined,
+  destroy: () => void,
+  persist: Persist,
+  thing: any,
+  getThing?: string,
+): Persister<Persist>;

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

@@ -155,6 +155,6 @@ export function createCrSqliteWasmPersister(
   store: Store,
   db: DB,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): CrSqliteWasmPersister;

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

@@ -155,6 +155,6 @@ export function createCrSqliteWasmPersister(
   store: Store,
   db: DB,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): CrSqliteWasmPersister;

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

@@ -73,7 +73,7 @@ export interface CrSqliteWasmPersister<Schemas extends OptionalSchemas>
  *   store: Store,
  *   db: DB,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): CrSqliteWasmPersister;
  * ```
@@ -174,6 +174,6 @@ export function createCrSqliteWasmPersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,
   db: DB,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): CrSqliteWasmPersister<Schemas>;

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

@@ -73,7 +73,7 @@ export interface CrSqliteWasmPersister<Schemas extends OptionalSchemas>
  *   store: Store,
  *   db: DB,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): CrSqliteWasmPersister;
  * ```
@@ -174,6 +174,6 @@ export function createCrSqliteWasmPersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,
   db: DB,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): CrSqliteWasmPersister<Schemas>;

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

@@ -181,6 +181,6 @@ export function createElectricSqlPersister(
   store: Store,
   electricClient: ElectricClient<any>,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): ElectricSqlPersister;

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

@@ -181,6 +181,6 @@ export function createElectricSqlPersister(
   store: Store,
   electricClient: ElectricClient<any>,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): ElectricSqlPersister;

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

@@ -81,7 +81,7 @@ export interface ElectricSqlPersister<Schemas extends OptionalSchemas>
  *   store: Store,
  *   electricClient: ElectricClient<any>,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): ElectricSqlPersister;
  * ```
@@ -200,6 +200,6 @@ export function createElectricSqlPersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,
   electricClient: ElectricClient<any>,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): ElectricSqlPersister<Schemas>;

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

@@ -81,7 +81,7 @@ export interface ElectricSqlPersister<Schemas extends OptionalSchemas>
  *   store: Store,
  *   electricClient: ElectricClient<any>,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): ElectricSqlPersister;
  * ```
@@ -200,6 +200,6 @@ export function createElectricSqlPersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,
   electricClient: ElectricClient<any>,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): ElectricSqlPersister<Schemas>;

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

@@ -182,6 +182,6 @@ export function createExpoSqlitePersister(
   store: Store | MergeableStore,
   db: SQLiteDatabase,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): ExpoSqlitePersister;

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

@@ -182,6 +182,6 @@ export function createExpoSqlitePersister(
   store: Store | MergeableStore,
   db: SQLiteDatabase,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): ExpoSqlitePersister;

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

@@ -81,7 +81,7 @@ export interface ExpoSqlitePersister<Schemas extends OptionalSchemas>
  *   store: Store | MergeableStore,
  *   db: SQLiteDatabase,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): ExpoSqlitePersister;
  * ```
@@ -201,6 +201,6 @@ export function createExpoSqlitePersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas> | MergeableStore<Schemas>,
   db: SQLiteDatabase,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): ExpoSqlitePersister<Schemas>;

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

@@ -81,7 +81,7 @@ export interface ExpoSqlitePersister<Schemas extends OptionalSchemas>
  *   store: Store | MergeableStore,
  *   db: SQLiteDatabase,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): ExpoSqlitePersister;
  * ```
@@ -201,6 +201,6 @@ export function createExpoSqlitePersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas> | MergeableStore<Schemas>,
   db: SQLiteDatabase,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): ExpoSqlitePersister<Schemas>;

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

@@ -154,6 +154,6 @@ export function createLibSqlPersister(
   store: Store,
   client: Client,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): LibSqlPersister;

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

@@ -154,6 +154,6 @@ export function createLibSqlPersister(
   store: Store,
   client: Client,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): LibSqlPersister;

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

@@ -72,7 +72,7 @@ export interface LibSqlPersister<Schemas extends OptionalSchemas>
  *   store: Store,
  *   client: Client,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): LibSqlPersister;
  * ```
@@ -173,6 +173,6 @@ export function createLibSqlPersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,
   client: Client,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): LibSqlPersister<Schemas>;

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

@@ -72,7 +72,7 @@ export interface LibSqlPersister<Schemas extends OptionalSchemas>
  *   store: Store,
  *   client: Client,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): LibSqlPersister;
  * ```
@@ -173,6 +173,6 @@ export function createLibSqlPersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,
   client: Client,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): LibSqlPersister<Schemas>;

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

@@ -173,6 +173,6 @@ export function createPglitePersister(
   store: Store | MergeableStore,
   pglite: PGlite,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): Promise<PglitePersister>;

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

@@ -173,6 +173,6 @@ export function createPglitePersister(
   store: Store | MergeableStore,
   pglite: PGlite,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): Promise<PglitePersister>;

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

@@ -78,7 +78,7 @@ export interface PglitePersister<Schemas extends OptionalSchemas>
  *   store: Store | MergeableStore,
  *   pglite: PGlite,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): Promise<PglitePersister>;
  * ```
@@ -192,6 +192,6 @@ export function createPglitePersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas> | MergeableStore<Schemas>,
   pglite: PGlite,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): Promise<PglitePersister<Schemas>>;

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

@@ -78,7 +78,7 @@ export interface PglitePersister<Schemas extends OptionalSchemas>
  *   store: Store | MergeableStore,
  *   pglite: PGlite,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): Promise<PglitePersister>;
  * ```
@@ -192,6 +192,6 @@ export function createPglitePersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas> | MergeableStore<Schemas>,
   pglite: PGlite,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): Promise<PglitePersister<Schemas>>;

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

@@ -162,6 +162,6 @@ export function createPostgresPersister(
   store: Store | MergeableStore,
   sql: Sql,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): Promise<PostgresPersister>;

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

@@ -162,6 +162,6 @@ export function createPostgresPersister(
   store: Store | MergeableStore,
   sql: Sql,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): Promise<PostgresPersister>;

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

@@ -74,7 +74,7 @@ export interface PostgresPersister<Schemas extends OptionalSchemas>
  *   store: Store | MergeableStore,
  *   sql: Sql,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): Promise<PostgresPersister>;
  * ```
@@ -181,6 +181,6 @@ export function createPostgresPersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas> | MergeableStore<Schemas>,
   sql: Sql,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): Promise<PostgresPersister<Schemas>>;

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

@@ -74,7 +74,7 @@ export interface PostgresPersister<Schemas extends OptionalSchemas>
  *   store: Store | MergeableStore,
  *   sql: Sql,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): Promise<PostgresPersister>;
  * ```
@@ -181,6 +181,6 @@ export function createPostgresPersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas> | MergeableStore<Schemas>,
   sql: Sql,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): Promise<PostgresPersister<Schemas>>;

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

@@ -170,6 +170,6 @@ export function createPowerSyncPersister(
   store: Store,
   powerSync: AbstractPowerSyncDatabase,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): PowerSyncPersister;

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

@@ -170,6 +170,6 @@ export function createPowerSyncPersister(
   store: Store,
   powerSync: AbstractPowerSyncDatabase,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): PowerSyncPersister;

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

@@ -74,7 +74,7 @@ export interface PowerSyncPersister<Schemas extends OptionalSchemas>
  *   store: Store,
  *   powerSync: AbstractPowerSyncDatabase,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): PowerSyncPersister;
  * ```
@@ -189,6 +189,6 @@ export function createPowerSyncPersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,
   powerSync: AbstractPowerSyncDatabase,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): PowerSyncPersister<Schemas>;

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

@@ -74,7 +74,7 @@ export interface PowerSyncPersister<Schemas extends OptionalSchemas>
  *   store: Store,
  *   powerSync: AbstractPowerSyncDatabase,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): PowerSyncPersister;
  * ```
@@ -189,6 +189,6 @@ export function createPowerSyncPersister<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,
   powerSync: AbstractPowerSyncDatabase,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): PowerSyncPersister<Schemas>;

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

@@ -171,6 +171,6 @@ export function createSqliteWasmPersister(
   sqlite3: any,
   db: any,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): SqliteWasmPersister;

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

@@ -171,6 +171,6 @@ export function createSqliteWasmPersister(
   sqlite3: any,
   db: any,
   configOrStoreTableName?: DatabasePersisterConfig | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): SqliteWasmPersister;

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

@@ -80,7 +80,7 @@ export interface SqliteWasmPersister<Schemas extends OptionalSchemas>
  *   sqlite3: any,
  *   db: any,
  *   configOrStoreTableName?: DatabasePersisterConfig | string,
- *   onSqlCommand?: (sql: string, args?: any[]) => void,
+ *   onSqlCommand?: (sql: string, params?: any[]) => void,
  *   onIgnoredError?: (error: any) => void,
  * ): SqliteWasmPersister;
  * ```
@@ -191,6 +191,6 @@ export function createSqliteWasmPersister<Schemas extends OptionalSchemas>(
   sqlite3: any,
   db: any,
   configOrStoreTableName?: DatabasePersisterConfig<Schemas> | string,
-  onSqlCommand?: (sql: string, args?: any[]) => void,
+  onSqlCommand?: (sql: string, params?: any[]) => void,
   onIgnoredError?: (error: any) => void,
 ): SqliteWasmPersister<Schemas>;