tinybase 6.4.2 → 6.5.0

package/omni/with-schemas/index.js

@@ -4514,7 +4514,7 @@ const createAutomergePersister = (
   );
 };
 
-const STORAGE = 'storage';
+const STORAGE$1 = 'storage';
 const createStoragePersister = (
   store,
   storageName,
@@ -4534,11 +4534,11 @@ const createStoragePersister = (
         );
       }
     };
-    WINDOW.addEventListener(STORAGE, storageListener);
+    WINDOW.addEventListener(STORAGE$1, storageListener);
     return storageListener;
   };
   const delPersisterListener = (storageListener) =>
-    WINDOW.removeEventListener(STORAGE, storageListener);
+    WINDOW.removeEventListener(STORAGE$1, storageListener);
   return createCustomPersister(
     store,
     getPersisted,
@@ -5360,6 +5360,49 @@ const viewUpsert = async (
   );
 };
 
+const STORAGE = 'storage';
+const createReactNativeMmkvPersister = (
+  store,
+  storage,
+  storageName = STORAGE,
+  onIgnoredError,
+) => {
+  const getPersisted = async () => {
+    const data = storage.getString(storageName);
+    const value = data === void 0 ? void 0 : JSON.parse(data);
+    return Promise.resolve(value);
+  };
+  const setPersisted = async (getContent) => {
+    const content = getContent();
+    if (content !== void 0) {
+      storage.set(storageName, JSON.stringify(content));
+    }
+  };
+  const addPersisterListener = (listener) =>
+    storage.addOnValueChangedListener((key) => {
+      if (key === storageName) {
+        const value = storage.getString(storageName);
+        if (value) {
+          listener(JSON.parse(value));
+        }
+      }
+    });
+  const delPersisterListener = (storageListener) => {
+    storageListener.remove();
+  };
+  return createCustomPersister(
+    store,
+    getPersisted,
+    setPersisted,
+    addPersisterListener,
+    delPersisterListener,
+    onIgnoredError,
+    3,
+    // StoreOrMergeableStore
+    {getStorageName: () => storageName},
+  );
+};
+
 const createReactNativeSqlitePersister = (
   store,
   db,
@@ -10454,6 +10497,7 @@ export {
   createPostgresPersister,
   createPowerSyncPersister,
   createQueries,
+  createReactNativeMmkvPersister,
   createReactNativeSqlitePersister,
   createRelationships,
   createRemotePersister,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tinybase",
-  "version": "6.4.2",
+  "version": "6.5.0",
   "author": "jamesgpearce",
   "repository": "github:tinyplex/tinybase",
   "license": "MIT",
@@ -37,6 +37,7 @@
     "postgres": "^3.4.7",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
+    "react-native-mmkv": "3.3.0",
     "react-native-sqlite-storage": "^6.0.1",
     "sqlite3": "^5.1.7",
     "ws": "^8.18.3",
@@ -94,6 +95,9 @@
     "react-native-sqlite-storage": {
       "optional": true
     },
+    "react-native-mmkv": {
+      "optional": true
+    },
     "sqlite3": {
       "optional": true
     },
@@ -246,6 +250,12 @@
       "persisters/persister-powersync/with-schemas": [
         "./@types/persisters/persister-powersync/with-schemas/index.d.ts"
       ],
+      "persisters/persister-react-native-mmkv": [
+        "./@types/persisters/persister-react-native-mmkv/index.d.ts"
+      ],
+      "persisters/persister-react-native-mmkv/with-schemas": [
+        "./@types/persisters/persister-react-native-mmkv/with-schemas/index.d.ts"
+      ],
       "persisters/persister-react-native-sqlite": [
         "./@types/persisters/persister-react-native-sqlite/index.d.ts"
       ],
@@ -498,6 +508,12 @@
       "min/persisters/persister-powersync/with-schemas": [
         "./@types/persisters/persister-powersync/with-schemas/index.d.ts"
       ],
+      "min/persisters/persister-react-native-mmkv": [
+        "./@types/persisters/persister-react-native-mmkv/index.d.ts"
+      ],
+      "min/persisters/persister-react-native-mmkv/with-schemas": [
+        "./@types/persisters/persister-react-native-mmkv/with-schemas/index.d.ts"
+      ],
       "min/persisters/persister-react-native-sqlite": [
         "./@types/persisters/persister-react-native-sqlite/index.d.ts"
       ],
@@ -891,6 +907,18 @@
         "default": "./persisters/persister-powersync/index.js"
       }
     },
+    "./persisters/persister-react-native-mmkv": {
+      "default": {
+        "types": "./@types/persisters/persister-react-native-mmkv/index.d.ts",
+        "default": "./persisters/persister-react-native-mmkv/index.js"
+      }
+    },
+    "./persisters/persister-react-native-mmkv/with-schemas": {
+      "default": {
+        "types": "./@types/persisters/persister-react-native-mmkv/with-schemas/index.d.ts",
+        "default": "./persisters/persister-react-native-mmkv/index.js"
+      }
+    },
     "./persisters/persister-react-native-sqlite": {
       "default": {
         "types": "./@types/persisters/persister-react-native-sqlite/index.d.ts",
@@ -1395,6 +1423,18 @@
         "default": "./min/persisters/persister-powersync/index.js"
       }
     },
+    "./min/persisters/persister-react-native-mmkv": {
+      "default": {
+        "types": "./@types/persisters/persister-react-native-mmkv/index.d.ts",
+        "default": "./min/persisters/persister-react-native-mmkv/index.js"
+      }
+    },
+    "./min/persisters/persister-react-native-mmkv/with-schemas": {
+      "default": {
+        "types": "./@types/persisters/persister-react-native-mmkv/with-schemas/index.d.ts",
+        "default": "./min/persisters/persister-react-native-mmkv/index.js"
+      }
+    },
     "./min/persisters/persister-react-native-sqlite": {
       "default": {
         "types": "./@types/persisters/persister-react-native-sqlite/index.d.ts",

package/persisters/persister-react-native-mmkv/index.js

@@ -0,0 +1,459 @@
+const EMPTY_STRING = '';
+
+const isUndefined = (thing) => thing == void 0;
+const ifNotUndefined = (value, then, otherwise) =>
+  isUndefined(value) ? otherwise?.() : then(value);
+const isArray = (thing) => Array.isArray(thing);
+const size = (arrayOrString) => arrayOrString.length;
+const test = (regex, subject) => regex.test(subject);
+const errorNew = (message) => {
+  throw new Error(message);
+};
+const tryCatch = async (action, then1, then2) => {
+  try {
+    return await action();
+  } catch (error) {
+    /* istanbul ignore next */
+    then1?.(error);
+  }
+};
+
+const arrayForEach = (array, cb) => array.forEach(cb);
+const arrayClear = (array, to) => array.splice(0, to);
+const arrayPush = (array, ...values) => array.push(...values);
+const arrayShift = (array) => array.shift();
+
+const collSize = (coll) => coll?.size ?? 0;
+const collHas = (coll, keyOrValue) => coll?.has(keyOrValue) ?? false;
+const collIsEmpty = (coll) => isUndefined(coll) || collSize(coll) == 0;
+const collForEach = (coll, cb) => coll?.forEach(cb);
+const collDel = (coll, keyOrValue) => coll?.delete(keyOrValue);
+
+const object = Object;
+const getPrototypeOf = (obj) => object.getPrototypeOf(obj);
+const isObject = (obj) =>
+  !isUndefined(obj) &&
+  ifNotUndefined(
+    getPrototypeOf(obj),
+    (objPrototype) =>
+      objPrototype == object.prototype ||
+      isUndefined(getPrototypeOf(objPrototype)),
+
+    /* istanbul ignore next */
+    () => true,
+  );
+const objIds = object.keys;
+const objFreeze = object.freeze;
+const objSize = (obj) => size(objIds(obj));
+const objIsEmpty = (obj) => isObject(obj) && objSize(obj) == 0;
+
+const mapNew = (entries) => new Map(entries);
+const mapGet = (map, key) => map?.get(key);
+const mapSet = (map, key, value) =>
+  isUndefined(value) ? (collDel(map, key), map) : map?.set(key, value);
+const mapEnsure = (map, key, getDefaultValue, hadExistingValue) => {
+  if (!collHas(map, key)) {
+    mapSet(map, key, getDefaultValue());
+  } else {
+    hadExistingValue?.(mapGet(map, key));
+  }
+  return mapGet(map, key);
+};
+const visitTree = (node, path, ensureLeaf, pruneLeaf, p = 0) =>
+  ifNotUndefined(
+    (ensureLeaf ? mapEnsure : mapGet)(
+      node,
+      path[p],
+      p > size(path) - 2 ? ensureLeaf : mapNew,
+    ),
+    (nodeOrLeaf) => {
+      if (p > size(path) - 2) {
+        if (pruneLeaf?.(nodeOrLeaf)) {
+          mapSet(node, path[p]);
+        }
+        return nodeOrLeaf;
+      }
+      const leaf = visitTree(nodeOrLeaf, path, ensureLeaf, pruneLeaf, p + 1);
+      if (collIsEmpty(nodeOrLeaf)) {
+        mapSet(node, path[p]);
+      }
+      return leaf;
+    },
+  );
+
+const INTEGER = /^\d+$/;
+const getPoolFunctions = () => {
+  const pool = [];
+  let nextId = 0;
+  return [
+    (reuse) => (reuse ? arrayShift(pool) : null) ?? EMPTY_STRING + nextId++,
+    (id) => {
+      if (test(INTEGER, id) && size(pool) < 1e3) {
+        arrayPush(pool, id);
+      }
+    },
+  ];
+};
+
+const setNew = (entryOrEntries) =>
+  new Set(
+    isArray(entryOrEntries) || isUndefined(entryOrEntries)
+      ? entryOrEntries
+      : [entryOrEntries],
+  );
+const setAdd = (set, value) => set?.add(value);
+
+const getWildcardedLeaves = (deepIdSet, path = [EMPTY_STRING]) => {
+  const leaves = [];
+  const deep = (node, p) =>
+    p == size(path)
+      ? arrayPush(leaves, node)
+      : path[p] === null
+        ? collForEach(node, (node2) => deep(node2, p + 1))
+        : arrayForEach([path[p], null], (id) => deep(mapGet(node, id), p + 1));
+  deep(deepIdSet, 0);
+  return leaves;
+};
+const getListenerFunctions = (getThing) => {
+  let thing;
+  const [getId, releaseId] = getPoolFunctions();
+  const allListeners = mapNew();
+  const addListener = (
+    listener,
+    idSetNode,
+    path,
+    pathGetters = [],
+    extraArgsGetter = () => [],
+  ) => {
+    thing ??= getThing();
+    const id = getId(1);
+    mapSet(allListeners, id, [
+      listener,
+      idSetNode,
+      path,
+      pathGetters,
+      extraArgsGetter,
+    ]);
+    setAdd(visitTree(idSetNode, path ?? [EMPTY_STRING], setNew), id);
+    return id;
+  };
+  const callListeners = (idSetNode, ids, ...extraArgs) =>
+    arrayForEach(getWildcardedLeaves(idSetNode, ids), (set) =>
+      collForEach(set, (id) =>
+        mapGet(allListeners, id)[0](thing, ...(ids ?? []), ...extraArgs),
+      ),
+    );
+  const delListener = (id) =>
+    ifNotUndefined(mapGet(allListeners, id), ([, idSetNode, idOrNulls]) => {
+      visitTree(idSetNode, idOrNulls ?? [EMPTY_STRING], void 0, (idSet) => {
+        collDel(idSet, id);
+        return collIsEmpty(idSet) ? 1 : 0;
+      });
+      mapSet(allListeners, id);
+      releaseId(id);
+      return idOrNulls;
+    });
+  const callListener = (id) =>
+    ifNotUndefined(
+      mapGet(allListeners, id),
+      ([listener, , path = [], pathGetters, extraArgsGetter]) => {
+        const callWithIds = (...ids) => {
+          const index = size(ids);
+          if (index == size(path)) {
+            listener(thing, ...ids, ...extraArgsGetter(ids));
+          } else if (isUndefined(path[index])) {
+            arrayForEach(pathGetters[index]?.(...ids) ?? [], (id2) =>
+              callWithIds(...ids, id2),
+            );
+          } else {
+            callWithIds(...ids, path[index]);
+          }
+        };
+        callWithIds();
+      },
+    );
+  return [addListener, callListeners, delListener, callListener];
+};
+
+const scheduleRunning = mapNew();
+const scheduleActions = mapNew();
+const getStoreFunctions = (
+  persist = 1 /* StoreOnly */,
+  store,
+  isSynchronizer,
+) =>
+  persist != 1 /* StoreOnly */ && store.isMergeable()
+    ? [
+        1,
+        store.getMergeableContent,
+        () => store.getTransactionMergeableChanges(!isSynchronizer),
+        ([[changedTables], [changedValues]]) =>
+          !objIsEmpty(changedTables) || !objIsEmpty(changedValues),
+        store.setDefaultContent,
+      ]
+    : persist != 2 /* MergeableStoreOnly */
+      ? [
+          0,
+          store.getContent,
+          store.getTransactionChanges,
+          ([changedTables, changedValues]) =>
+            !objIsEmpty(changedTables) || !objIsEmpty(changedValues),
+          store.setContent,
+        ]
+      : errorNew('Store type not supported by this Persister');
+const createCustomPersister = (
+  store,
+  getPersisted,
+  setPersisted,
+  addPersisterListener,
+  delPersisterListener,
+  onIgnoredError,
+  persist,
+  extra = {},
+  isSynchronizer = 0,
+  scheduleId = [],
+) => {
+  let status = 0; /* Idle */
+  let loads = 0;
+  let saves = 0;
+  let action;
+  let autoLoadHandle;
+  let autoSaveListenerId;
+  mapEnsure(scheduleRunning, scheduleId, () => 0);
+  mapEnsure(scheduleActions, scheduleId, () => []);
+  const statusListeners = mapNew();
+  const [
+    isMergeableStore,
+    getContent,
+    getChanges,
+    hasChanges,
+    setDefaultContent,
+  ] = getStoreFunctions(persist, store, isSynchronizer);
+  const [addListener, callListeners, delListenerImpl] = getListenerFunctions(
+    () => persister,
+  );
+  const setStatus = (newStatus) => {
+    if (newStatus != status) {
+      status = newStatus;
+      callListeners(statusListeners, void 0, status);
+    }
+  };
+  const run = async () => {
+    /* istanbul ignore else */
+    if (!mapGet(scheduleRunning, scheduleId)) {
+      mapSet(scheduleRunning, scheduleId, 1);
+      while (
+        !isUndefined((action = arrayShift(mapGet(scheduleActions, scheduleId))))
+      ) {
+        await tryCatch(action, onIgnoredError);
+      }
+      mapSet(scheduleRunning, scheduleId, 0);
+    }
+  };
+  const setContentOrChanges = (contentOrChanges) => {
+    (isMergeableStore && isArray(contentOrChanges?.[0])
+      ? contentOrChanges?.[2] === 1
+        ? store.applyMergeableChanges
+        : store.setMergeableContent
+      : contentOrChanges?.[2] === 1
+        ? store.applyChanges
+        : store.setContent)(contentOrChanges);
+  };
+  const load = async (initialContent) => {
+    /* istanbul ignore else */
+    if (status != 2 /* Saving */) {
+      setStatus(1 /* Loading */);
+      loads++;
+      await schedule(async () => {
+        await tryCatch(
+          async () => {
+            const content = await getPersisted();
+            if (isArray(content)) {
+              setContentOrChanges(content);
+            } else if (initialContent) {
+              setDefaultContent(initialContent);
+            } else {
+              errorNew(`Content is not an array: ${content}`);
+            }
+          },
+          () => {
+            if (initialContent) {
+              setDefaultContent(initialContent);
+            }
+          },
+        );
+        setStatus(0 /* Idle */);
+      });
+    }
+    return persister;
+  };
+  const startAutoLoad = async (initialContent) => {
+    stopAutoLoad();
+    await load(initialContent);
+    await tryCatch(
+      async () =>
+        (autoLoadHandle = await addPersisterListener(
+          async (content, changes) => {
+            if (changes || content) {
+              /* istanbul ignore else */
+              if (status != 2 /* Saving */) {
+                setStatus(1 /* Loading */);
+                loads++;
+                setContentOrChanges(changes ?? content);
+                setStatus(0 /* Idle */);
+              }
+            } else {
+              await load();
+            }
+          },
+        )),
+      onIgnoredError,
+    );
+    return persister;
+  };
+  const stopAutoLoad = async () => {
+    if (autoLoadHandle) {
+      await tryCatch(
+        () => delPersisterListener(autoLoadHandle),
+        onIgnoredError,
+      );
+      autoLoadHandle = void 0;
+    }
+    return persister;
+  };
+  const isAutoLoading = () => !isUndefined(autoLoadHandle);
+  const save = async (changes) => {
+    /* istanbul ignore else */
+    if (status != 1 /* Loading */) {
+      setStatus(2 /* Saving */);
+      saves++;
+      await schedule(async () => {
+        await tryCatch(() => setPersisted(getContent, changes), onIgnoredError);
+        setStatus(0 /* Idle */);
+      });
+    }
+    return persister;
+  };
+  const startAutoSave = async () => {
+    stopAutoSave();
+    await save();
+    autoSaveListenerId = store.addDidFinishTransactionListener(() => {
+      const changes = getChanges();
+      if (hasChanges(changes)) {
+        save(changes);
+      }
+    });
+    return persister;
+  };
+  const stopAutoSave = async () => {
+    if (autoSaveListenerId) {
+      store.delListener(autoSaveListenerId);
+      autoSaveListenerId = void 0;
+    }
+    return persister;
+  };
+  const isAutoSaving = () => !isUndefined(autoSaveListenerId);
+  const startAutoPersisting = async (
+    initialContent,
+    startSaveFirst = false,
+  ) => {
+    const [call1, call2] = startSaveFirst
+      ? [startAutoSave, startAutoLoad]
+      : [startAutoLoad, startAutoSave];
+    await call1(initialContent);
+    await call2(initialContent);
+    return persister;
+  };
+  const stopAutoPersisting = async (stopSaveFirst = false) => {
+    const [call1, call2] = stopSaveFirst
+      ? [stopAutoSave, stopAutoLoad]
+      : [stopAutoLoad, stopAutoSave];
+    await call1();
+    await call2();
+    return persister;
+  };
+  const getStatus = () => status;
+  const addStatusListener = (listener) =>
+    addListener(listener, statusListeners);
+  const delListener = (listenerId) => {
+    delListenerImpl(listenerId);
+    return store;
+  };
+  const schedule = async (...actions) => {
+    arrayPush(mapGet(scheduleActions, scheduleId), ...actions);
+    await run();
+    return persister;
+  };
+  const getStore = () => store;
+  const destroy = () => {
+    arrayClear(mapGet(scheduleActions, scheduleId));
+    return stopAutoPersisting();
+  };
+  const getStats = () => ({loads, saves});
+  const persister = {
+    load,
+    startAutoLoad,
+    stopAutoLoad,
+    isAutoLoading,
+    save,
+    startAutoSave,
+    stopAutoSave,
+    isAutoSaving,
+    startAutoPersisting,
+    stopAutoPersisting,
+    getStatus,
+    addStatusListener,
+    delListener,
+    schedule,
+    getStore,
+    destroy,
+    getStats,
+    ...extra,
+  };
+  return objFreeze(persister);
+};
+
+const STORAGE = 'storage';
+const createReactNativeMmkvPersister = (
+  store,
+  storage,
+  storageName = STORAGE,
+  onIgnoredError,
+) => {
+  const getPersisted = async () => {
+    const data = storage.getString(storageName);
+    const value = data === void 0 ? void 0 : JSON.parse(data);
+    return Promise.resolve(value);
+  };
+  const setPersisted = async (getContent) => {
+    const content = getContent();
+    if (content !== void 0) {
+      storage.set(storageName, JSON.stringify(content));
+    }
+  };
+  const addPersisterListener = (listener) =>
+    storage.addOnValueChangedListener((key) => {
+      if (key === storageName) {
+        const value = storage.getString(storageName);
+        if (value) {
+          listener(JSON.parse(value));
+        }
+      }
+    });
+  const delPersisterListener = (storageListener) => {
+    storageListener.remove();
+  };
+  return createCustomPersister(
+    store,
+    getPersisted,
+    setPersisted,
+    addPersisterListener,
+    delPersisterListener,
+    onIgnoredError,
+    3,
+    // StoreOrMergeableStore
+    {getStorageName: () => storageName},
+  );
+};
+
+export {createReactNativeMmkvPersister};