tinybase 5.0.0-beta.25 → 5.0.0-beta.27

package/umd/with-schemas/index.js

@@ -1175,10 +1175,15 @@
     return objFreeze(metrics);
   });
 
+  const Persists = {
+    StoreOnly: 1,
+    MergeableStoreOnly: 2,
+    StoreOrMergeableStore: 3,
+  };
   const scheduleRunning = mapNew();
   const scheduleActions = mapNew();
-  const getStoreFunctions = (supportedStoreType = 1, store) =>
-    supportedStoreType > 1 && store.isMergeable()
+  const getStoreFunctions = (persist = Persists.StoreOnly, store) =>
+    persist != Persists.StoreOnly && store.isMergeable()
       ? [
           1,
           store.getMergeableContent,
@@ -1187,7 +1192,7 @@
             !objIsEmpty(changedTables) || !objIsEmpty(changedValues),
           store.setDefaultContent,
         ]
-      : supportedStoreType != 2
+      : persist != Persists.MergeableStoreOnly
         ? [
             0,
             store.getContent,
@@ -1204,7 +1209,7 @@
     addPersisterListener,
     delPersisterListener,
     onIgnoredError,
-    supportedStoreType,
+    persist,
     extra = {},
     scheduleId = [],
   ) => {
@@ -1222,7 +1227,7 @@
       getChanges,
       hasChanges,
       setDefaultContent,
-    ] = getStoreFunctions(supportedStoreType, store);
+    ] = getStoreFunctions(persist, store);
     const run = async () => {
       /* istanbul ignore else */
       if (!mapGet(scheduleRunning, scheduleId)) {
@@ -1398,14 +1403,16 @@
     isFiniteNumber(stamp[2]) &&
     validateThing(stamp[0]);
 
-  const RESPONSE = 0;
-  const GET_CONTENT_HASHES = 1;
-  const CONTENT_HASHES = 2;
-  const CONTENT_DIFF = 3;
-  const GET_TABLE_DIFF = 4;
-  const GET_ROW_DIFF = 5;
-  const GET_CELL_DIFF = 6;
-  const GET_VALUE_DIFF = 7;
+  const Message = {
+    Response: 0,
+    GetContentHashes: 1,
+    ContentHashes: 2,
+    ContentDiff: 3,
+    GetTableDiff: 4,
+    GetRowDiff: 5,
+    GetCellDiff: 6,
+    GetValueDiff: 7,
+  };
   const createCustomSynchronizer = (
     store,
     send,
@@ -1419,55 +1426,52 @@
     let sends = 0;
     let receives = 0;
     const pendingRequests = mapNew();
-    onReceive((fromClientId, requestId, messageType, messageBody) => {
+    onReceive((fromClientId, requestId, message, body) => {
       receives++;
-      if (messageType == RESPONSE) {
+      if (message == Message.Response) {
         ifNotUndefined(
           mapGet(pendingRequests, requestId),
           ([toClientId, handleResponse]) =>
             isUndefined(toClientId) || toClientId == fromClientId
-              ? handleResponse(messageBody, fromClientId)
+              ? handleResponse(body, fromClientId)
               : /* istanbul ignore next */
                 0,
         );
-      } else if (messageType == CONTENT_HASHES && persister.isAutoLoading()) {
-        getChangesFromOtherStore(fromClientId, messageBody).then((changes) => {
+      } else if (
+        message == Message.ContentHashes &&
+        persister.isAutoLoading()
+      ) {
+        getChangesFromOtherStore(fromClientId, body).then((changes) => {
           persisterListener?.(void 0, changes);
         });
-      } else if (messageType == CONTENT_DIFF && persister.isAutoLoading()) {
-        persisterListener?.(void 0, messageBody);
+      } else if (message == Message.ContentDiff && persister.isAutoLoading()) {
+        persisterListener?.(void 0, body);
       } else {
         ifNotUndefined(
-          messageType == GET_CONTENT_HASHES && persister.isAutoSaving()
+          message == Message.GetContentHashes && persister.isAutoSaving()
             ? store.getMergeableContentHashes()
-            : messageType == GET_TABLE_DIFF
-              ? store.getMergeableTableDiff(messageBody)
-              : messageType == GET_ROW_DIFF
-                ? store.getMergeableRowDiff(messageBody)
-                : messageType == GET_CELL_DIFF
-                  ? store.getMergeableCellDiff(messageBody)
-                  : messageType == GET_VALUE_DIFF
-                    ? store.getMergeableValueDiff(messageBody)
+            : message == Message.GetTableDiff
+              ? store.getMergeableTableDiff(body)
+              : message == Message.GetRowDiff
+                ? store.getMergeableRowDiff(body)
+                : message == Message.GetCellDiff
+                  ? store.getMergeableCellDiff(body)
+                  : message == Message.GetValueDiff
+                    ? store.getMergeableValueDiff(body)
                     : void 0,
           (response) => {
             sends++;
-            send(fromClientId, requestId, RESPONSE, response);
+            send(fromClientId, requestId, Message.Response, response);
           },
         );
       }
     });
-    const request = async (
-      toClientId,
-      messageType,
-      messageBody = EMPTY_STRING,
-    ) =>
+    const request = async (toClientId, message, body = EMPTY_STRING) =>
       promiseNew((resolve, reject) => {
         const requestId = getUniqueId();
         const timeout = setTimeout(() => {
           collDel(pendingRequests, requestId);
-          reject(
-            `No response from ${toClientId ?? 'anyone'} to '${messageType}'`,
-          );
+          reject(`No response from ${toClientId ?? 'anyone'} to '${message}'`);
         }, requestTimeoutSeconds * 1e3);
         mapSet(pendingRequests, requestId, [
           toClientId,
@@ -1478,7 +1482,7 @@
           },
         ]);
         sends++;
-        send(toClientId, requestId, messageType, messageBody);
+        send(toClientId, requestId, message, body);
       });
     const mergeTablesStamps = (tablesStamp, [tableStamps2, tablesTime2]) => {
       objForEach(tableStamps2, ([rowStamps2, tableTime2], tableId) => {
@@ -1503,7 +1507,7 @@
       if (isUndefined(otherContentHashes)) {
         [otherContentHashes, otherClientId] = await request(
           otherClientId,
-          GET_CONTENT_HASHES,
+          Message.GetContentHashes,
         );
       }
       const [otherTablesHash, otherValuesHash] = otherContentHashes;
@@ -1513,7 +1517,7 @@
         const [newTables, differentTableHashes] = (
           await request(
             otherClientId,
-            GET_TABLE_DIFF,
+            Message.GetTableDiff,
             store.getMergeableTableHashes(),
           )
         )[0];
@@ -1522,7 +1526,7 @@
           const [newRows, differentRowHashes] = (
             await request(
               otherClientId,
-              GET_ROW_DIFF,
+              Message.GetRowDiff,
               store.getMergeableRowHashes(differentTableHashes),
             )
           )[0];
@@ -1531,7 +1535,7 @@
             const newCells = (
               await request(
                 otherClientId,
-                GET_CELL_DIFF,
+                Message.GetCellDiff,
                 store.getMergeableCellHashes(differentRowHashes),
               )
             )[0];
@@ -1546,7 +1550,7 @@
           : (
               await request(
                 otherClientId,
-                GET_VALUE_DIFF,
+                Message.GetValueDiff,
                 store.getMergeableValueHashes(),
               )
             )[0],
@@ -1562,9 +1566,14 @@
     const setPersisted = async (_getContent, changes) => {
       sends++;
       if (changes) {
-        send(null, null, CONTENT_DIFF, changes);
+        send(null, null, Message.ContentDiff, changes);
       } else {
-        send(null, null, CONTENT_HASHES, store.getMergeableContentHashes());
+        send(
+          null,
+          null,
+          Message.ContentHashes,
+          store.getMergeableContentHashes(),
+        );
       }
     };
     const addPersisterListener = (listener) => (persisterListener = listener);
@@ -1584,7 +1593,7 @@
       addPersisterListener,
       delPersisterListener,
       onIgnoredError,
-      2,
+      Persists.MergeableStoreOnly,
       {startSync, stopSync, destroy, getSynchronizerStats, ...extra},
     );
     return persister;
@@ -3937,20 +3946,20 @@
       mapToObj(contentStampMap[0][0], getStampHash);
     const getMergeableTableDiff = (otherTableHashes) => {
       const newTables = stampNewObj(contentStampMap[0][1]);
-      const differentTableHashes = {};
+      const differingTableHashes = {};
       mapForEach(
         contentStampMap[0][0],
         (tableId, [tableStampMap, tableTime, hash]) =>
           objHas(otherTableHashes, tableId)
             ? hash != otherTableHashes[tableId]
-              ? (differentTableHashes[tableId] = hash)
+              ? (differingTableHashes[tableId] = hash)
               : 0
             : (newTables[0][tableId] = stampMapToObjWithoutHash(
                 [tableStampMap, tableTime],
                 (rowStampMap) => stampMapToObjWithoutHash(rowStampMap),
               )),
       );
-      return [newTables, differentTableHashes];
+      return [newTables, differingTableHashes];
     };
     const getMergeableRowHashes = (otherTableHashes) => {
       const rowHashes = {};
@@ -3971,20 +3980,20 @@
     };
     const getMergeableRowDiff = (otherTableRowHashes) => {
       const newRows = stampNewObj(contentStampMap[0][1]);
-      const differentRowHashes = {};
+      const differingRowHashes = {};
       objForEach(otherTableRowHashes, (otherRowHashes, tableId) =>
         mapForEach(
           mapGet(contentStampMap[0][0], tableId)?.[0],
           (rowId, [rowStampMap, rowTime, hash]) =>
             objHas(otherRowHashes, rowId)
               ? hash !== otherRowHashes[rowId]
-                ? (objEnsure(differentRowHashes, tableId, objNew)[rowId] = hash)
+                ? (objEnsure(differingRowHashes, tableId, objNew)[rowId] = hash)
                 : 0
               : (objEnsure(newRows[0], tableId, stampNewObj)[0][rowId] =
                   stampMapToObjWithoutHash([rowStampMap, rowTime])),
         ),
       );
-      return [newRows, differentRowHashes];
+      return [newRows, differingRowHashes];
     };
     const getMergeableCellHashes = (otherTableRowHashes) => {
       const cellHashes = {};
@@ -4043,12 +4052,12 @@
     };
     const getMergeableValueHashes = () =>
       mapToObj(contentStampMap[1][0], getStampHash);
-    const getMergeableValueDiff = (relativeTo) => {
+    const getMergeableValueDiff = (otherValueHashes) => {
       const [, [valueStampMaps, valuesTime]] = contentStampMap;
       const values = mapToObj(
         valueStampMaps,
         stampCloneWithoutHash,
-        ([, , hash], valueId) => hash == relativeTo?.[valueId],
+        ([, , hash], valueId) => hash == otherValueHashes?.[valueId],
       );
       return newStamp(values, valuesTime);
     };
@@ -4173,6 +4182,8 @@
     return objFreeze(mergeableStore);
   };
 
+  exports.Message = Message;
+  exports.Persists = Persists;
   exports.createCheckpoints = createCheckpoints;
   exports.createCustomPersister = createCustomPersister;
   exports.createCustomSynchronizer = createCustomSynchronizer;

package/with-schemas/index.js

@@ -1143,10 +1143,15 @@ const createMetrics = getCreateFunction((store) => {
   return objFreeze(metrics);
 });
 
+const Persists = {
+  StoreOnly: 1,
+  MergeableStoreOnly: 2,
+  StoreOrMergeableStore: 3,
+};
 const scheduleRunning = mapNew();
 const scheduleActions = mapNew();
-const getStoreFunctions = (supportedStoreType = 1, store) =>
-  supportedStoreType > 1 && store.isMergeable()
+const getStoreFunctions = (persist = Persists.StoreOnly, store) =>
+  persist != Persists.StoreOnly && store.isMergeable()
     ? [
         1,
         store.getMergeableContent,
@@ -1155,7 +1160,7 @@ const getStoreFunctions = (supportedStoreType = 1, store) =>
           !objIsEmpty(changedTables) || !objIsEmpty(changedValues),
         store.setDefaultContent,
       ]
-    : supportedStoreType != 2
+    : persist != Persists.MergeableStoreOnly
       ? [
           0,
           store.getContent,
@@ -1172,7 +1177,7 @@ const createCustomPersister = (
   addPersisterListener,
   delPersisterListener,
   onIgnoredError,
-  supportedStoreType,
+  persist,
   extra = {},
   scheduleId = [],
 ) => {
@@ -1190,7 +1195,7 @@ const createCustomPersister = (
     getChanges,
     hasChanges,
     setDefaultContent,
-  ] = getStoreFunctions(supportedStoreType, store);
+  ] = getStoreFunctions(persist, store);
   const run = async () => {
     /* istanbul ignore else */
     if (!mapGet(scheduleRunning, scheduleId)) {
@@ -1364,14 +1369,16 @@ const stampValidate = (stamp, validateThing) =>
   isFiniteNumber(stamp[2]) &&
   validateThing(stamp[0]);
 
-const RESPONSE = 0;
-const GET_CONTENT_HASHES = 1;
-const CONTENT_HASHES = 2;
-const CONTENT_DIFF = 3;
-const GET_TABLE_DIFF = 4;
-const GET_ROW_DIFF = 5;
-const GET_CELL_DIFF = 6;
-const GET_VALUE_DIFF = 7;
+const Message = {
+  Response: 0,
+  GetContentHashes: 1,
+  ContentHashes: 2,
+  ContentDiff: 3,
+  GetTableDiff: 4,
+  GetRowDiff: 5,
+  GetCellDiff: 6,
+  GetValueDiff: 7,
+};
 const createCustomSynchronizer = (
   store,
   send,
@@ -1385,51 +1392,49 @@ const createCustomSynchronizer = (
   let sends = 0;
   let receives = 0;
   const pendingRequests = mapNew();
-  onReceive((fromClientId, requestId, messageType, messageBody) => {
+  onReceive((fromClientId, requestId, message, body) => {
     receives++;
-    if (messageType == RESPONSE) {
+    if (message == Message.Response) {
       ifNotUndefined(
         mapGet(pendingRequests, requestId),
         ([toClientId, handleResponse]) =>
           isUndefined(toClientId) || toClientId == fromClientId
-            ? handleResponse(messageBody, fromClientId)
+            ? handleResponse(body, fromClientId)
             : /* istanbul ignore next */
               0,
       );
-    } else if (messageType == CONTENT_HASHES && persister.isAutoLoading()) {
-      getChangesFromOtherStore(fromClientId, messageBody).then((changes) => {
+    } else if (message == Message.ContentHashes && persister.isAutoLoading()) {
+      getChangesFromOtherStore(fromClientId, body).then((changes) => {
         persisterListener?.(void 0, changes);
       });
-    } else if (messageType == CONTENT_DIFF && persister.isAutoLoading()) {
-      persisterListener?.(void 0, messageBody);
+    } else if (message == Message.ContentDiff && persister.isAutoLoading()) {
+      persisterListener?.(void 0, body);
     } else {
       ifNotUndefined(
-        messageType == GET_CONTENT_HASHES && persister.isAutoSaving()
+        message == Message.GetContentHashes && persister.isAutoSaving()
           ? store.getMergeableContentHashes()
-          : messageType == GET_TABLE_DIFF
-            ? store.getMergeableTableDiff(messageBody)
-            : messageType == GET_ROW_DIFF
-              ? store.getMergeableRowDiff(messageBody)
-              : messageType == GET_CELL_DIFF
-                ? store.getMergeableCellDiff(messageBody)
-                : messageType == GET_VALUE_DIFF
-                  ? store.getMergeableValueDiff(messageBody)
+          : message == Message.GetTableDiff
+            ? store.getMergeableTableDiff(body)
+            : message == Message.GetRowDiff
+              ? store.getMergeableRowDiff(body)
+              : message == Message.GetCellDiff
+                ? store.getMergeableCellDiff(body)
+                : message == Message.GetValueDiff
+                  ? store.getMergeableValueDiff(body)
                   : void 0,
         (response) => {
           sends++;
-          send(fromClientId, requestId, RESPONSE, response);
+          send(fromClientId, requestId, Message.Response, response);
         },
       );
     }
   });
-  const request = async (toClientId, messageType, messageBody = EMPTY_STRING) =>
+  const request = async (toClientId, message, body = EMPTY_STRING) =>
     promiseNew((resolve, reject) => {
       const requestId = getUniqueId();
       const timeout = setTimeout(() => {
         collDel(pendingRequests, requestId);
-        reject(
-          `No response from ${toClientId ?? 'anyone'} to '${messageType}'`,
-        );
+        reject(`No response from ${toClientId ?? 'anyone'} to '${message}'`);
       }, requestTimeoutSeconds * 1e3);
       mapSet(pendingRequests, requestId, [
         toClientId,
@@ -1440,7 +1445,7 @@ const createCustomSynchronizer = (
         },
       ]);
       sends++;
-      send(toClientId, requestId, messageType, messageBody);
+      send(toClientId, requestId, message, body);
     });
   const mergeTablesStamps = (tablesStamp, [tableStamps2, tablesTime2]) => {
     objForEach(tableStamps2, ([rowStamps2, tableTime2], tableId) => {
@@ -1465,7 +1470,7 @@ const createCustomSynchronizer = (
     if (isUndefined(otherContentHashes)) {
       [otherContentHashes, otherClientId] = await request(
         otherClientId,
-        GET_CONTENT_HASHES,
+        Message.GetContentHashes,
       );
     }
     const [otherTablesHash, otherValuesHash] = otherContentHashes;
@@ -1475,7 +1480,7 @@ const createCustomSynchronizer = (
       const [newTables, differentTableHashes] = (
         await request(
           otherClientId,
-          GET_TABLE_DIFF,
+          Message.GetTableDiff,
           store.getMergeableTableHashes(),
         )
       )[0];
@@ -1484,7 +1489,7 @@ const createCustomSynchronizer = (
         const [newRows, differentRowHashes] = (
           await request(
             otherClientId,
-            GET_ROW_DIFF,
+            Message.GetRowDiff,
             store.getMergeableRowHashes(differentTableHashes),
           )
         )[0];
@@ -1493,7 +1498,7 @@ const createCustomSynchronizer = (
           const newCells = (
             await request(
               otherClientId,
-              GET_CELL_DIFF,
+              Message.GetCellDiff,
               store.getMergeableCellHashes(differentRowHashes),
             )
           )[0];
@@ -1508,7 +1513,7 @@ const createCustomSynchronizer = (
         : (
             await request(
               otherClientId,
-              GET_VALUE_DIFF,
+              Message.GetValueDiff,
               store.getMergeableValueHashes(),
             )
           )[0],
@@ -1524,9 +1529,14 @@ const createCustomSynchronizer = (
   const setPersisted = async (_getContent, changes) => {
     sends++;
     if (changes) {
-      send(null, null, CONTENT_DIFF, changes);
+      send(null, null, Message.ContentDiff, changes);
     } else {
-      send(null, null, CONTENT_HASHES, store.getMergeableContentHashes());
+      send(
+        null,
+        null,
+        Message.ContentHashes,
+        store.getMergeableContentHashes(),
+      );
     }
   };
   const addPersisterListener = (listener) => (persisterListener = listener);
@@ -1546,7 +1556,7 @@ const createCustomSynchronizer = (
     addPersisterListener,
     delPersisterListener,
     onIgnoredError,
-    2,
+    Persists.MergeableStoreOnly,
     {startSync, stopSync, destroy, getSynchronizerStats, ...extra},
   );
   return persister;
@@ -3848,20 +3858,20 @@ const createMergeableStore = (uniqueId) => {
     mapToObj(contentStampMap[0][0], getStampHash);
   const getMergeableTableDiff = (otherTableHashes) => {
     const newTables = stampNewObj(contentStampMap[0][1]);
-    const differentTableHashes = {};
+    const differingTableHashes = {};
     mapForEach(
       contentStampMap[0][0],
       (tableId, [tableStampMap, tableTime, hash]) =>
         objHas(otherTableHashes, tableId)
           ? hash != otherTableHashes[tableId]
-            ? (differentTableHashes[tableId] = hash)
+            ? (differingTableHashes[tableId] = hash)
             : 0
           : (newTables[0][tableId] = stampMapToObjWithoutHash(
               [tableStampMap, tableTime],
               (rowStampMap) => stampMapToObjWithoutHash(rowStampMap),
             )),
     );
-    return [newTables, differentTableHashes];
+    return [newTables, differingTableHashes];
   };
   const getMergeableRowHashes = (otherTableHashes) => {
     const rowHashes = {};
@@ -3882,20 +3892,20 @@ const createMergeableStore = (uniqueId) => {
   };
   const getMergeableRowDiff = (otherTableRowHashes) => {
     const newRows = stampNewObj(contentStampMap[0][1]);
-    const differentRowHashes = {};
+    const differingRowHashes = {};
     objForEach(otherTableRowHashes, (otherRowHashes, tableId) =>
       mapForEach(
         mapGet(contentStampMap[0][0], tableId)?.[0],
         (rowId, [rowStampMap, rowTime, hash]) =>
           objHas(otherRowHashes, rowId)
             ? hash !== otherRowHashes[rowId]
-              ? (objEnsure(differentRowHashes, tableId, objNew)[rowId] = hash)
+              ? (objEnsure(differingRowHashes, tableId, objNew)[rowId] = hash)
               : 0
             : (objEnsure(newRows[0], tableId, stampNewObj)[0][rowId] =
                 stampMapToObjWithoutHash([rowStampMap, rowTime])),
       ),
     );
-    return [newRows, differentRowHashes];
+    return [newRows, differingRowHashes];
   };
   const getMergeableCellHashes = (otherTableRowHashes) => {
     const cellHashes = {};
@@ -3952,12 +3962,12 @@ const createMergeableStore = (uniqueId) => {
   };
   const getMergeableValueHashes = () =>
     mapToObj(contentStampMap[1][0], getStampHash);
-  const getMergeableValueDiff = (relativeTo) => {
+  const getMergeableValueDiff = (otherValueHashes) => {
     const [, [valueStampMaps, valuesTime]] = contentStampMap;
     const values = mapToObj(
       valueStampMaps,
       stampCloneWithoutHash,
-      ([, , hash], valueId) => hash == relativeTo?.[valueId],
+      ([, , hash], valueId) => hash == otherValueHashes?.[valueId],
     );
     return newStamp(values, valuesTime);
   };
@@ -4083,6 +4093,8 @@ const createMergeableStore = (uniqueId) => {
 };
 
 export {
+  Message,
+  Persists,
   createCheckpoints,
   createCustomPersister,
   createCustomSynchronizer,