tinybase 5.2.0-beta.4 → 5.2.0

package/umd/persisters/persister-expo-sqlite/index.js

@@ -59,13 +59,13 @@
   const SCHEMA_VERSION = 'schema_version';
   const FROM = 'FROM ';
   const PRAGMA_TABLE = 'pragma_table_';
-  const getWrappedCommand = (rawCmd, onSqlCommand) =>
+  const getWrappedCommand = (executeCommand, onSqlCommand) =>
     onSqlCommand
-      ? async (sql, args) => {
-          onSqlCommand(sql, args);
-          return await rawCmd(sql, args);
+      ? async (sql, params) => {
+          onSqlCommand(sql, params);
+          return await executeCommand(sql, params);
         }
-      : rawCmd;
+      : executeCommand;
   const escapeId = (str) => `"${str.replace(/"/g, '""')}"`;
   const getPlaceholders = (array) =>
     arrayJoin(
@@ -332,7 +332,7 @@
   const setAdd = (set, value) => set?.add(value);
 
   const getCommandFunctions = (
-    cmd,
+    databaseExecuteCommand,
     managedTableNames,
     querySchema,
     onIgnoredError,
@@ -346,8 +346,9 @@
       collHas(mapGet(schemaMap, tableName), rowIdColumnName);
     const refreshSchema = async () => {
       collClear(schemaMap);
-      arrayMap(await querySchema(cmd, managedTableNames), ({tn, cn}) =>
-        setAdd(mapEnsure(schemaMap, tn, setNew), cn),
+      arrayMap(
+        await querySchema(databaseExecuteCommand, managedTableNames),
+        ({tn, cn}) => setAdd(mapEnsure(schemaMap, tn, setNew), cn),
       );
     };
     const loadTable = async (tableName, rowIdColumnName) =>
@@ -355,7 +356,9 @@
         ? objNew(
             arrayFilter(
               arrayMap(
-                await cmd(SELECT_STAR_FROM + escapeId(tableName)),
+                await databaseExecuteCommand(
+                  SELECT_STAR_FROM + escapeId(tableName),
+                ),
                 (row) => [
                   row[rowIdColumnName],
                   decode
@@ -388,7 +391,7 @@
         arrayIsEmpty(tableColumnNames) &&
         collHas(schemaMap, tableName)
       ) {
-        await cmd('DROP ' + TABLE + escapeId(tableName));
+        await databaseExecuteCommand('DROP ' + TABLE + escapeId(tableName));
         mapSet(schemaMap, tableName);
         return;
       }
@@ -396,7 +399,7 @@
       const currentColumnNames = setNew(collValues(tableSchemaColumns));
       if (!arrayIsEmpty(tableColumnNames)) {
         if (!collHas(schemaMap, tableName)) {
-          await cmd(
+          await databaseExecuteCommand(
             'CREATE ' +
               TABLE +
               escapeId(tableName) +
@@ -418,7 +421,7 @@
               [rowIdColumnName, ...tableColumnNames],
               async (columnName, index) => {
                 if (!collDel(currentColumnNames, columnName)) {
-                  await cmd(
+                  await databaseExecuteCommand(
                     ALTER_TABLE +
                       escapeId(tableName) +
                       'ADD' +
@@ -426,7 +429,7 @@
                       columnType,
                   );
                   if (index == 0) {
-                    await cmd(
+                    await databaseExecuteCommand(
                       'CREATE UNIQUE INDEX pk ON ' +
                         escapeId(tableName) +
                         `(${escapeId(rowIdColumnName)})`,
@@ -443,7 +446,7 @@
         ...(!partial && deleteEmptyColumns
           ? arrayMap(collValues(currentColumnNames), async (columnName) => {
               if (columnName != rowIdColumnName) {
-                await cmd(
+                await databaseExecuteCommand(
                   ALTER_TABLE +
                     escapeId(tableName) +
                     'DROP' +
@@ -456,12 +459,14 @@
       ]);
       if (partial) {
         if (isUndefined(content)) {
-          await cmd(DELETE_FROM + escapeId(tableName) + WHERE + ' true');
+          await databaseExecuteCommand(
+            DELETE_FROM + escapeId(tableName) + WHERE + ' true',
+          );
         } else {
           await promiseAll(
             objToArray(content, async (row, rowId) => {
               if (isUndefined(row)) {
-                await cmd(
+                await databaseExecuteCommand(
                   DELETE_FROM +
                     escapeId(tableName) +
                     WHERE +
@@ -471,7 +476,7 @@
                 );
               } else if (!arrayIsEmpty(tableColumnNames)) {
                 await upsert(
-                  cmd,
+                  databaseExecuteCommand,
                   tableName,
                   rowIdColumnName,
                   objIds(row),
@@ -493,11 +498,11 @@
             collValues(mapGet(schemaMap, tableName)),
             (columnName) => columnName != rowIdColumnName,
           );
-          const args = [];
+          const params = [];
           const deleteRowIds = [];
           objToArray(content ?? {}, (row, rowId) => {
             arrayPush(
-              args,
+              params,
               rowId,
               ...arrayMap(changingColumnNames, (cellId) =>
                 encode ? encode(row?.[cellId]) : row?.[cellId],
@@ -506,14 +511,14 @@
             arrayPush(deleteRowIds, rowId);
           });
           await upsert(
-            cmd,
+            databaseExecuteCommand,
             tableName,
             rowIdColumnName,
             changingColumnNames,
-            args,
+            params,
             orReplace,
           );
-          await cmd(
+          await databaseExecuteCommand(
             DELETE_FROM +
               escapeId(tableName) +
               WHERE +
@@ -522,32 +527,34 @@
             deleteRowIds,
           );
         } else if (collHas(schemaMap, tableName)) {
-          await cmd(DELETE_FROM + escapeId(tableName) + WHERE + ' true');
+          await databaseExecuteCommand(
+            DELETE_FROM + escapeId(tableName) + WHERE + ' true',
+          );
         }
       }
     };
     const transaction = async (actions) => {
       let result;
-      await cmd('BEGIN');
+      await databaseExecuteCommand('BEGIN');
       try {
         result = await actions();
       } catch (error) {
         onIgnoredError?.(error);
       }
-      await cmd('END');
+      await databaseExecuteCommand('END');
       return result;
     };
     return [refreshSchema, loadTable, saveTable, transaction];
   };
   const upsert = async (
-    cmd,
+    executeCommand,
     tableName,
     rowIdColumnName,
     changingColumnNames,
-    args,
+    params,
     orReplace = 0,
   ) =>
-    await cmd(
+    await executeCommand(
       'INSERT ' +
         (orReplace ? 'OR REPLACE ' : EMPTY_STRING) +
         'INTO' +
@@ -561,7 +568,7 @@
           ),
         ) +
         ')VALUES' +
-        getUpsertPlaceholders(args, size(changingColumnNames) + 1) +
+        getUpsertPlaceholders(params, size(changingColumnNames) + 1) +
         (orReplace
           ? EMPTY_STRING
           : 'ON CONFLICT(' +
@@ -575,7 +582,7 @@
               ),
               COMMA,
             )),
-      arrayMap(args, (arg) => arg ?? null),
+      arrayMap(params, (param) => param ?? null),
     );
   const getUpsertPlaceholders = (array, columnCount) =>
     arrayJoin(
@@ -597,7 +604,7 @@
 
   const createJsonPersister = (
     store,
-    cmd,
+    executeCommand,
     addPersisterListener,
     delPersisterListener,
     onIgnoredError,
@@ -613,7 +620,7 @@
   ) => {
     const [refreshSchema, loadTable, saveTable, transaction] =
       getCommandFunctions(
-        cmd,
+        executeCommand,
         managedTableNames,
         querySchema,
         onIgnoredError,
@@ -665,7 +672,7 @@
 
   const createTabularPersister = (
     store,
-    cmd,
+    executeCommand,
     addPersisterListener,
     delPersisterListener,
     onIgnoredError,
@@ -687,7 +694,7 @@
   ) => {
     const [refreshSchema, loadTable, saveTable, transaction] =
       getCommandFunctions(
-        cmd,
+        executeCommand,
         managedTableNames,
         querySchema,
         onIgnoredError,
@@ -896,14 +903,15 @@
     return [0, autoLoadIntervalSeconds, tabularConfig, managedTableNames];
   };
 
-  const createSqlitePersister = (
+  const createCustomSqlitePersister = (
     store,
     configOrStoreTableName,
-    rawCmd,
-    addUpdateListener,
-    delUpdateListener,
+    rawExecuteCommand,
+    addChangeListener,
+    delChangeListener,
     onSqlCommand,
     onIgnoredError,
+    destroy,
     persist,
     thing,
     getThing = 'getDb',
@@ -912,7 +920,7 @@
     let dataVersion;
     let schemaVersion;
     let totalChanges;
-    const cmd = getWrappedCommand(rawCmd, onSqlCommand);
+    const executeCommand = getWrappedCommand(rawExecuteCommand, onSqlCommand);
     const [
       isJson,
       autoLoadIntervalSeconds,
@@ -924,7 +932,7 @@
       const startPolling = () =>
         (interval = startInterval(async () => {
           try {
-            const [{d, s, c}] = await cmd(
+            const [{d, s, c}] = await executeCommand(
               // eslint-disable-next-line max-len
               `${SELECT} ${DATA_VERSION} d,${SCHEMA_VERSION} s,TOTAL_CHANGES() c FROM ${PRAGMA}${DATA_VERSION} JOIN ${PRAGMA}${SCHEMA_VERSION}`,
             );
@@ -942,7 +950,7 @@
         dataVersion = schemaVersion = totalChanges = null;
         stopInterval(interval);
       };
-      const listeningHandle = addUpdateListener((tableName) => {
+      const listeningHandle = addChangeListener((tableName) => {
         if (managedTableNamesSet.has(tableName)) {
           stopPolling();
           listener();
@@ -952,23 +960,23 @@
       startPolling();
       return () => {
         stopPolling();
-        delUpdateListener(listeningHandle);
+        delChangeListener(listeningHandle);
       };
     };
     const delPersisterListener = (stopPollingAndDelUpdateListener) =>
       stopPollingAndDelUpdateListener();
     return (isJson ? createJsonPersister : createTabularPersister)(
       store,
-      cmd,
+      executeCommand,
       addPersisterListener,
       delPersisterListener,
       onIgnoredError,
-      () => 0,
+      destroy,
       persist,
       defaultedConfig,
       collValues(managedTableNamesSet),
-      async (cmd2, managedTableNames) =>
-        await cmd2(
+      async (executeCommand2, managedTableNames) =>
+        await executeCommand2(
           // eslint-disable-next-line max-len
           `${SELECT} t.name tn,c.name cn ${FROM}${PRAGMA_TABLE}list()t,${PRAGMA_TABLE}info(t.name)c ${WHERE} t.schema='main'AND t.type IN('table','view')AND t.name IN(${getPlaceholders(managedTableNames)})ORDER BY t.name,c.name`,
           managedTableNames,
@@ -990,10 +998,10 @@
     onSqlCommand,
     onIgnoredError,
   ) =>
-    createSqlitePersister(
+    createCustomSqlitePersister(
       store,
       configOrStoreTableName,
-      async (sql, args = []) => await db.getAllAsync(sql, args),
+      async (sql, params = []) => await db.getAllAsync(sql, params),
       (listener) =>
         expoSqlite.addDatabaseChangeListener(({tableName}) =>
           listener(tableName),
@@ -1001,6 +1009,7 @@
       (subscription) => subscription.remove(),
       onSqlCommand,
       onIgnoredError,
+      () => 0,
       3,
       // StoreOrMergeableStore,
       db,

package/umd/persisters/persister-expo-sqlite/with-schemas/index.js

@@ -59,13 +59,13 @@
   const SCHEMA_VERSION = 'schema_version';
   const FROM = 'FROM ';
   const PRAGMA_TABLE = 'pragma_table_';
-  const getWrappedCommand = (rawCmd, onSqlCommand) =>
+  const getWrappedCommand = (executeCommand, onSqlCommand) =>
     onSqlCommand
-      ? async (sql, args) => {
-          onSqlCommand(sql, args);
-          return await rawCmd(sql, args);
+      ? async (sql, params) => {
+          onSqlCommand(sql, params);
+          return await executeCommand(sql, params);
         }
-      : rawCmd;
+      : executeCommand;
   const escapeId = (str) => `"${str.replace(/"/g, '""')}"`;
   const getPlaceholders = (array) =>
     arrayJoin(
@@ -332,7 +332,7 @@
   const setAdd = (set, value) => set?.add(value);
 
   const getCommandFunctions = (
-    cmd,
+    databaseExecuteCommand,
     managedTableNames,
     querySchema,
     onIgnoredError,
@@ -346,8 +346,9 @@
       collHas(mapGet(schemaMap, tableName), rowIdColumnName);
     const refreshSchema = async () => {
       collClear(schemaMap);
-      arrayMap(await querySchema(cmd, managedTableNames), ({tn, cn}) =>
-        setAdd(mapEnsure(schemaMap, tn, setNew), cn),
+      arrayMap(
+        await querySchema(databaseExecuteCommand, managedTableNames),
+        ({tn, cn}) => setAdd(mapEnsure(schemaMap, tn, setNew), cn),
       );
     };
     const loadTable = async (tableName, rowIdColumnName) =>
@@ -355,7 +356,9 @@
         ? objNew(
             arrayFilter(
               arrayMap(
-                await cmd(SELECT_STAR_FROM + escapeId(tableName)),
+                await databaseExecuteCommand(
+                  SELECT_STAR_FROM + escapeId(tableName),
+                ),
                 (row) => [
                   row[rowIdColumnName],
                   decode
@@ -388,7 +391,7 @@
         arrayIsEmpty(tableColumnNames) &&
         collHas(schemaMap, tableName)
       ) {
-        await cmd('DROP ' + TABLE + escapeId(tableName));
+        await databaseExecuteCommand('DROP ' + TABLE + escapeId(tableName));
         mapSet(schemaMap, tableName);
         return;
       }
@@ -396,7 +399,7 @@
       const currentColumnNames = setNew(collValues(tableSchemaColumns));
       if (!arrayIsEmpty(tableColumnNames)) {
         if (!collHas(schemaMap, tableName)) {
-          await cmd(
+          await databaseExecuteCommand(
             'CREATE ' +
               TABLE +
               escapeId(tableName) +
@@ -418,7 +421,7 @@
               [rowIdColumnName, ...tableColumnNames],
               async (columnName, index) => {
                 if (!collDel(currentColumnNames, columnName)) {
-                  await cmd(
+                  await databaseExecuteCommand(
                     ALTER_TABLE +
                       escapeId(tableName) +
                       'ADD' +
@@ -426,7 +429,7 @@
                       columnType,
                   );
                   if (index == 0) {
-                    await cmd(
+                    await databaseExecuteCommand(
                       'CREATE UNIQUE INDEX pk ON ' +
                         escapeId(tableName) +
                         `(${escapeId(rowIdColumnName)})`,
@@ -443,7 +446,7 @@
         ...(!partial && deleteEmptyColumns
           ? arrayMap(collValues(currentColumnNames), async (columnName) => {
               if (columnName != rowIdColumnName) {
-                await cmd(
+                await databaseExecuteCommand(
                   ALTER_TABLE +
                     escapeId(tableName) +
                     'DROP' +
@@ -456,12 +459,14 @@
       ]);
       if (partial) {
         if (isUndefined(content)) {
-          await cmd(DELETE_FROM + escapeId(tableName) + WHERE + ' true');
+          await databaseExecuteCommand(
+            DELETE_FROM + escapeId(tableName) + WHERE + ' true',
+          );
         } else {
           await promiseAll(
             objToArray(content, async (row, rowId) => {
               if (isUndefined(row)) {
-                await cmd(
+                await databaseExecuteCommand(
                   DELETE_FROM +
                     escapeId(tableName) +
                     WHERE +
@@ -471,7 +476,7 @@
                 );
               } else if (!arrayIsEmpty(tableColumnNames)) {
                 await upsert(
-                  cmd,
+                  databaseExecuteCommand,
                   tableName,
                   rowIdColumnName,
                   objIds(row),
@@ -493,11 +498,11 @@
             collValues(mapGet(schemaMap, tableName)),
             (columnName) => columnName != rowIdColumnName,
           );
-          const args = [];
+          const params = [];
           const deleteRowIds = [];
           objToArray(content ?? {}, (row, rowId) => {
             arrayPush(
-              args,
+              params,
               rowId,
               ...arrayMap(changingColumnNames, (cellId) =>
                 encode ? encode(row?.[cellId]) : row?.[cellId],
@@ -506,14 +511,14 @@
             arrayPush(deleteRowIds, rowId);
           });
           await upsert(
-            cmd,
+            databaseExecuteCommand,
             tableName,
             rowIdColumnName,
             changingColumnNames,
-            args,
+            params,
             orReplace,
           );
-          await cmd(
+          await databaseExecuteCommand(
             DELETE_FROM +
               escapeId(tableName) +
               WHERE +
@@ -522,32 +527,34 @@
             deleteRowIds,
           );
         } else if (collHas(schemaMap, tableName)) {
-          await cmd(DELETE_FROM + escapeId(tableName) + WHERE + ' true');
+          await databaseExecuteCommand(
+            DELETE_FROM + escapeId(tableName) + WHERE + ' true',
+          );
         }
       }
     };
     const transaction = async (actions) => {
       let result;
-      await cmd('BEGIN');
+      await databaseExecuteCommand('BEGIN');
       try {
         result = await actions();
       } catch (error) {
         onIgnoredError?.(error);
       }
-      await cmd('END');
+      await databaseExecuteCommand('END');
       return result;
     };
     return [refreshSchema, loadTable, saveTable, transaction];
   };
   const upsert = async (
-    cmd,
+    executeCommand,
     tableName,
     rowIdColumnName,
     changingColumnNames,
-    args,
+    params,
     orReplace = 0,
   ) =>
-    await cmd(
+    await executeCommand(
       'INSERT ' +
         (orReplace ? 'OR REPLACE ' : EMPTY_STRING) +
         'INTO' +
@@ -561,7 +568,7 @@
           ),
         ) +
         ')VALUES' +
-        getUpsertPlaceholders(args, size(changingColumnNames) + 1) +
+        getUpsertPlaceholders(params, size(changingColumnNames) + 1) +
         (orReplace
           ? EMPTY_STRING
           : 'ON CONFLICT(' +
@@ -575,7 +582,7 @@
               ),
               COMMA,
             )),
-      arrayMap(args, (arg) => arg ?? null),
+      arrayMap(params, (param) => param ?? null),
     );
   const getUpsertPlaceholders = (array, columnCount) =>
     arrayJoin(
@@ -597,7 +604,7 @@
 
   const createJsonPersister = (
     store,
-    cmd,
+    executeCommand,
     addPersisterListener,
     delPersisterListener,
     onIgnoredError,
@@ -613,7 +620,7 @@
   ) => {
     const [refreshSchema, loadTable, saveTable, transaction] =
       getCommandFunctions(
-        cmd,
+        executeCommand,
         managedTableNames,
         querySchema,
         onIgnoredError,
@@ -665,7 +672,7 @@
 
   const createTabularPersister = (
     store,
-    cmd,
+    executeCommand,
     addPersisterListener,
     delPersisterListener,
     onIgnoredError,
@@ -687,7 +694,7 @@
   ) => {
     const [refreshSchema, loadTable, saveTable, transaction] =
       getCommandFunctions(
-        cmd,
+        executeCommand,
         managedTableNames,
         querySchema,
         onIgnoredError,
@@ -896,14 +903,15 @@
     return [0, autoLoadIntervalSeconds, tabularConfig, managedTableNames];
   };
 
-  const createSqlitePersister = (
+  const createCustomSqlitePersister = (
     store,
     configOrStoreTableName,
-    rawCmd,
-    addUpdateListener,
-    delUpdateListener,
+    rawExecuteCommand,
+    addChangeListener,
+    delChangeListener,
     onSqlCommand,
     onIgnoredError,
+    destroy,
     persist,
     thing,
     getThing = 'getDb',
@@ -912,7 +920,7 @@
     let dataVersion;
     let schemaVersion;
     let totalChanges;
-    const cmd = getWrappedCommand(rawCmd, onSqlCommand);
+    const executeCommand = getWrappedCommand(rawExecuteCommand, onSqlCommand);
     const [
       isJson,
       autoLoadIntervalSeconds,
@@ -924,7 +932,7 @@
       const startPolling = () =>
         (interval = startInterval(async () => {
           try {
-            const [{d, s, c}] = await cmd(
+            const [{d, s, c}] = await executeCommand(
               // eslint-disable-next-line max-len
               `${SELECT} ${DATA_VERSION} d,${SCHEMA_VERSION} s,TOTAL_CHANGES() c FROM ${PRAGMA}${DATA_VERSION} JOIN ${PRAGMA}${SCHEMA_VERSION}`,
             );
@@ -942,7 +950,7 @@
         dataVersion = schemaVersion = totalChanges = null;
         stopInterval(interval);
       };
-      const listeningHandle = addUpdateListener((tableName) => {
+      const listeningHandle = addChangeListener((tableName) => {
         if (managedTableNamesSet.has(tableName)) {
           stopPolling();
           listener();
@@ -952,23 +960,23 @@
       startPolling();
       return () => {
         stopPolling();
-        delUpdateListener(listeningHandle);
+        delChangeListener(listeningHandle);
       };
     };
     const delPersisterListener = (stopPollingAndDelUpdateListener) =>
       stopPollingAndDelUpdateListener();
     return (isJson ? createJsonPersister : createTabularPersister)(
       store,
-      cmd,
+      executeCommand,
       addPersisterListener,
       delPersisterListener,
       onIgnoredError,
-      () => 0,
+      destroy,
       persist,
       defaultedConfig,
       collValues(managedTableNamesSet),
-      async (cmd2, managedTableNames) =>
-        await cmd2(
+      async (executeCommand2, managedTableNames) =>
+        await executeCommand2(
           // eslint-disable-next-line max-len
           `${SELECT} t.name tn,c.name cn ${FROM}${PRAGMA_TABLE}list()t,${PRAGMA_TABLE}info(t.name)c ${WHERE} t.schema='main'AND t.type IN('table','view')AND t.name IN(${getPlaceholders(managedTableNames)})ORDER BY t.name,c.name`,
           managedTableNames,
@@ -990,10 +998,10 @@
     onSqlCommand,
     onIgnoredError,
   ) =>
-    createSqlitePersister(
+    createCustomSqlitePersister(
       store,
       configOrStoreTableName,
-      async (sql, args = []) => await db.getAllAsync(sql, args),
+      async (sql, params = []) => await db.getAllAsync(sql, params),
       (listener) =>
         expoSqlite.addDatabaseChangeListener(({tableName}) =>
           listener(tableName),
@@ -1001,6 +1009,7 @@
       (subscription) => subscription.remove(),
       onSqlCommand,
       onIgnoredError,
+      () => 0,
       3,
       // StoreOrMergeableStore,
       db,

package/umd/persisters/persister-indexed-db/index.js

@@ -291,7 +291,7 @@
     autoLoadIntervalSeconds = 1,
     onIgnoredError,
   ) => {
-    const forObjectStores = async (forObjectStore, args = [], create = 0) =>
+    const forObjectStores = async (forObjectStore, params = [], create = 0) =>
       promiseNew((resolve, reject) => {
         const request = (WINDOW ? WINDOW.indexedDB : indexedDB).open(
           dbName,
@@ -316,7 +316,7 @@
                 async (objectStoreName, index) =>
                   await forObjectStore(
                     transaction.objectStore(objectStoreName),
-                    args[index],
+                    params[index],
                   ),
               ),
             );