react-native-nitro-storage 0.5.0 → 0.5.1

package/lib/commonjs/index.js

@@ -76,6 +76,7 @@ var _reactNativeNitroModules = require("react-native-nitro-modules");
 var _Storage = require("./Storage.types");
 var _internal = require("./internal");
 var _storageRuntime = require("./storage-runtime");
+var _storageEvents = require("./storage-events");
 var _migration = require("./migration");
 var _storageHooks = require("./storage-hooks");
 var _indexeddbBackend = require("./indexeddb-backend");
@@ -111,8 +112,11 @@ let diskWritesAsync = false;
 const pendingSecureWrites = new Map();
 let secureFlushScheduled = false;
 let secureDefaultAccessControl = _Storage.AccessControl.WhenUnlocked;
+const suppressedNativeEvents = new Map([[_Storage.StorageScope.Disk, new Map()], [_Storage.StorageScope.Secure, new Map()]]);
 let metricsObserver;
+let eventObserver;
 const metricsCounters = new Map();
+const storageEvents = new _storageEvents.StorageEventRegistry();
 const nativeSecureBackend = "platform-secure-storage";
 function recordMetric(operation, scope, durationMs, keysCount = 1) {
   const existing = metricsCounters.get(operation);
@@ -163,6 +167,23 @@ function hasCachedRawValue(scope, key) {
 function clearScopeRawCache(scope) {
   getScopeRawCache(scope).clear();
 }
+function suppressNativeEvent(scope, key) {
+  const suppressedEvents = suppressedNativeEvents.get(scope);
+  suppressedEvents.set(key, (suppressedEvents.get(key) ?? 0) + 1);
+}
+function consumeSuppressedNativeEvent(scope, key) {
+  const suppressedEvents = suppressedNativeEvents.get(scope);
+  const count = suppressedEvents.get(key);
+  if (count === undefined) {
+    return false;
+  }
+  if (count <= 1) {
+    suppressedEvents.delete(key);
+  } else {
+    suppressedEvents.set(key, count - 1);
+  }
+  return true;
+}
 function notifyKeyListeners(registry, key) {
   const listeners = registry.get(key);
   if (listeners) {
@@ -196,6 +217,52 @@ function addKeyListener(registry, key, listener) {
     }
   };
 }
+function getEventRawValue(scope, key) {
+  if (scope === _Storage.StorageScope.Memory) {
+    const value = memoryStore.get(key);
+    return typeof value === "string" ? value : undefined;
+  }
+  return getRawValue(key, scope);
+}
+function createKeyChange(scope, key, oldValue, newValue, operation, source) {
+  return {
+    type: "key",
+    scope,
+    key,
+    oldValue,
+    newValue,
+    operation,
+    source
+  };
+}
+function hasStorageChangeObservers(scope) {
+  return storageEvents.hasListeners(scope) || eventObserver !== undefined;
+}
+function emitKeyChange(scope, key, oldValue, newValue, operation, source) {
+  if (source === "native" && operation !== "external" && scope !== _Storage.StorageScope.Memory && scopedUnsubscribers.has(scope)) {
+    suppressNativeEvent(scope, key);
+  }
+  const event = createKeyChange(scope, key, oldValue, newValue, operation, source);
+  storageEvents.emitKey(event);
+  eventObserver?.(event);
+}
+function emitBatchChange(scope, operation, source, changes) {
+  if (changes.length === 0) {
+    return;
+  }
+  if (source === "native" && operation !== "external" && scope !== _Storage.StorageScope.Memory && scopedUnsubscribers.has(scope)) {
+    changes.forEach(change => suppressNativeEvent(scope, change.key));
+  }
+  const event = {
+    type: "batch",
+    scope,
+    operation,
+    source,
+    changes
+  };
+  storageEvents.emitBatch(event);
+  eventObserver?.(event);
+}
 function readPendingSecureWrite(key) {
   return pendingSecureWrites.get(key)?.value;
 }
@@ -332,14 +399,19 @@ function ensureNativeScopeSubscription(scope) {
       notifyAllListeners(getScopedListeners(scope));
       return;
     }
+    const oldValue = readCachedRawValue(scope, key);
     cacheRawValue(scope, key, value);
     notifyKeyListeners(getScopedListeners(scope), key);
+    if (consumeSuppressedNativeEvent(scope, key)) {
+      return;
+    }
+    emitKeyChange(scope, key, oldValue, value, "external", "native");
   });
-  scopedUnsubscribers.set(scope, unsubscribe);
+  scopedUnsubscribers.set(scope, typeof unsubscribe === "function" ? unsubscribe : () => {});
 }
 function maybeCleanupNativeScopeSubscription(scope) {
   const listeners = getScopedListeners(scope);
-  if (listeners.size > 0) {
+  if (listeners.size > 0 || storageEvents.hasListeners(scope) || eventObserver !== undefined) {
     return;
   }
   const unsubscribe = scopedUnsubscribers.get(scope);
@@ -365,15 +437,18 @@ function getRawValue(key, scope) {
 }
 function setRawValue(key, value, scope) {
   (0, _internal.assertValidScope)(scope);
+  const oldValue = scope === _Storage.StorageScope.Memory ? getEventRawValue(scope, key) : undefined;
   if (scope === _Storage.StorageScope.Memory) {
     memoryStore.set(key, value);
     notifyKeyListeners(memoryListeners, key);
+    emitKeyChange(scope, key, oldValue, value, "set", "memory");
     return;
   }
   if (scope === _Storage.StorageScope.Disk) {
     cacheRawValue(scope, key, value);
     if (diskWritesAsync) {
       scheduleDiskWrite(key, value);
+      emitKeyChange(scope, key, oldValue, value, "set", "native");
       return;
     }
     flushDiskWrites();
@@ -386,18 +461,22 @@ function setRawValue(key, value, scope) {
   }
   getStorageModule().set(key, value, scope);
   cacheRawValue(scope, key, value);
+  emitKeyChange(scope, key, oldValue, value, "set", "native");
 }
 function removeRawValue(key, scope) {
   (0, _internal.assertValidScope)(scope);
+  const oldValue = getEventRawValue(scope, key);
   if (scope === _Storage.StorageScope.Memory) {
     memoryStore.delete(key);
     notifyKeyListeners(memoryListeners, key);
+    emitKeyChange(scope, key, oldValue, undefined, "remove", "memory");
     return;
   }
   if (scope === _Storage.StorageScope.Disk) {
     cacheRawValue(scope, key, undefined);
     if (diskWritesAsync) {
       scheduleDiskWrite(key, undefined);
+      emitKeyChange(scope, key, oldValue, undefined, "remove", "native");
       return;
     }
     flushDiskWrites();
@@ -409,6 +488,7 @@ function removeRawValue(key, scope) {
   }
   getStorageModule().remove(key, scope);
   cacheRawValue(scope, key, undefined);
+  emitKeyChange(scope, key, oldValue, undefined, "remove", "native");
 }
 function readMigrationVersion(scope) {
   const raw = getRawValue(_internal.MIGRATION_VERSION_KEY, scope);
@@ -422,11 +502,62 @@ function writeMigrationVersion(scope, version) {
   setRawValue(_internal.MIGRATION_VERSION_KEY, String(version), scope);
 }
 const storage = exports.storage = {
+  subscribe: (scope, listener) => {
+    (0, _internal.assertValidScope)(scope);
+    if (scope !== _Storage.StorageScope.Memory) {
+      ensureNativeScopeSubscription(scope);
+      const unsubscribe = storageEvents.subscribe(scope, listener);
+      return () => {
+        unsubscribe();
+        maybeCleanupNativeScopeSubscription(scope);
+      };
+    }
+    return storageEvents.subscribe(scope, listener);
+  },
+  subscribeKey: (scope, key, listener) => {
+    (0, _internal.assertValidScope)(scope);
+    if (scope !== _Storage.StorageScope.Memory) {
+      ensureNativeScopeSubscription(scope);
+      const unsubscribe = storageEvents.subscribeKey(scope, key, listener);
+      return () => {
+        unsubscribe();
+        maybeCleanupNativeScopeSubscription(scope);
+      };
+    }
+    return storageEvents.subscribeKey(scope, key, listener);
+  },
+  subscribePrefix: (scope, prefix, listener) => {
+    (0, _internal.assertValidScope)(scope);
+    if (scope !== _Storage.StorageScope.Memory) {
+      ensureNativeScopeSubscription(scope);
+      const unsubscribe = storageEvents.subscribePrefix(scope, prefix, listener);
+      return () => {
+        unsubscribe();
+        maybeCleanupNativeScopeSubscription(scope);
+      };
+    }
+    return storageEvents.subscribePrefix(scope, prefix, listener);
+  },
+  subscribeNamespace: (namespace, scope, listener) => {
+    return storage.subscribePrefix(scope, (0, _internal.prefixKey)(namespace, ""), listener);
+  },
+  setEventObserver: observer => {
+    eventObserver = observer;
+    if (observer) {
+      ensureNativeScopeSubscription(_Storage.StorageScope.Disk);
+      ensureNativeScopeSubscription(_Storage.StorageScope.Secure);
+      return;
+    }
+    maybeCleanupNativeScopeSubscription(_Storage.StorageScope.Disk);
+    maybeCleanupNativeScopeSubscription(_Storage.StorageScope.Secure);
+  },
   clear: scope => {
     measureOperation("storage:clear", scope, () => {
+      const previousValues = hasStorageChangeObservers(scope) ? storage.getAll(scope) : {};
       if (scope === _Storage.StorageScope.Memory) {
         memoryStore.clear();
         notifyAllListeners(memoryListeners);
+        emitBatchChange(scope, "clear", "memory", Object.keys(previousValues).map(key => createKeyChange(scope, key, previousValues[key], undefined, "clear", "memory")));
         return;
       }
       if (scope === _Storage.StorageScope.Disk) {
@@ -439,6 +570,7 @@ const storage = exports.storage = {
       }
       clearScopeRawCache(scope);
       getStorageModule().clear(scope);
+      emitBatchChange(scope, "clear", "native", Object.keys(previousValues).map(key => createKeyChange(scope, key, previousValues[key], undefined, "clear", "native")));
     });
   },
   clearAll: () => {
@@ -452,15 +584,26 @@ const storage = exports.storage = {
     measureOperation("storage:clearNamespace", scope, () => {
       (0, _internal.assertValidScope)(scope);
       if (scope === _Storage.StorageScope.Memory) {
-        for (const key of memoryStore.keys()) {
-          if ((0, _internal.isNamespaced)(key, namespace)) {
-            memoryStore.delete(key);
-          }
+        const affectedKeys = Array.from(memoryStore.keys()).filter(key => (0, _internal.isNamespaced)(key, namespace));
+        const previousValues = affectedKeys.map(key => ({
+          key,
+          value: getEventRawValue(scope, key)
+        }));
+        if (affectedKeys.length === 0) {
+          return;
         }
-        notifyAllListeners(memoryListeners);
+        affectedKeys.forEach(key => {
+          memoryStore.delete(key);
+        });
+        affectedKeys.forEach(key => notifyKeyListeners(memoryListeners, key));
+        emitBatchChange(scope, "clearNamespace", "memory", previousValues.map(({
+          key,
+          value
+        }) => createKeyChange(scope, key, value, undefined, "clearNamespace", "memory")));
         return;
       }
       const keyPrefix = (0, _internal.prefixKey)(namespace, "");
+      const previousValues = hasStorageChangeObservers(scope) ? storage.getByPrefix(keyPrefix, scope) : {};
       if (scope === _Storage.StorageScope.Disk) {
         flushDiskWrites();
       }
@@ -474,6 +617,7 @@ const storage = exports.storage = {
         }
       }
       getStorageModule().removeByPrefix(keyPrefix, scope);
+      emitBatchChange(scope, "clearNamespace", "native", Object.keys(previousValues).map(key => createKeyChange(scope, key, previousValues[key], undefined, "clearNamespace", "native")));
     });
   },
   clearBiometric: () => {
@@ -523,7 +667,7 @@ const storage = exports.storage = {
       if (scope === _Storage.StorageScope.Secure) {
         flushSecureWrites();
       }
-      return getStorageModule().getKeysByPrefix(prefix, scope);
+      return getStorageModule().getKeysByPrefix(prefix, scope) ?? [];
     });
   },
   getByPrefix: (prefix, scope) => {
@@ -548,7 +692,7 @@ const storage = exports.storage = {
       if (scope === _Storage.StorageScope.Secure) {
         flushSecureWrites();
       }
-      const values = getStorageModule().getBatch(keys, scope);
+      const values = getStorageModule().getBatch(keys, scope) ?? [];
       keys.forEach((key, idx) => {
         const value = (0, _internal.decodeNativeBatchValue)(values[idx]);
         if (value !== undefined) {
@@ -563,9 +707,10 @@ const storage = exports.storage = {
       (0, _internal.assertValidScope)(scope);
       const result = {};
       if (scope === _Storage.StorageScope.Memory) {
-        memoryStore.forEach((value, key) => {
+        for (const key of memoryStore.keys()) {
+          const value = memoryStore.get(key);
           if (typeof value === "string") result[key] = value;
-        });
+        }
         return result;
       }
       if (scope === _Storage.StorageScope.Disk) {
@@ -574,9 +719,9 @@ const storage = exports.storage = {
       if (scope === _Storage.StorageScope.Secure) {
         flushSecureWrites();
       }
-      const keys = getStorageModule().getAllKeys(scope);
+      const keys = getStorageModule().getAllKeys(scope) ?? [];
       if (keys.length === 0) return result;
-      const values = getStorageModule().getBatch(keys, scope);
+      const values = getStorageModule().getBatch(keys, scope) ?? [];
       keys.forEach((key, idx) => {
         const val = (0, _internal.decodeNativeBatchValue)(values[idx]);
         if (val !== undefined) result[key] = val;
@@ -584,6 +729,9 @@ const storage = exports.storage = {
       return result;
     });
   },
+  export: scope => {
+    return measureOperation("storage:export", scope, () => storage.getAll(scope));
+  },
   size: scope => {
     return measureOperation("storage:size", scope, () => {
       (0, _internal.assertValidScope)(scope);
@@ -733,11 +881,13 @@ const storage = exports.storage = {
       (0, _internal.assertValidScope)(scope);
       if (keys.length === 0) return;
       const values = keys.map(k => data[k]);
+      const changes = keys.map((key, index) => createKeyChange(scope, key, getEventRawValue(scope, key), values[index], "import", scope === _Storage.StorageScope.Memory ? "memory" : "native"));
       if (scope === _Storage.StorageScope.Memory) {
         keys.forEach((key, index) => {
           memoryStore.set(key, values[index]);
         });
         keys.forEach(key => notifyKeyListeners(memoryListeners, key));
+        emitBatchChange(scope, "import", "memory", changes);
         return;
       }
       if (scope === _Storage.StorageScope.Secure) {
@@ -746,6 +896,7 @@ const storage = exports.storage = {
       }
       getStorageModule().setBatch(keys, values, scope);
       keys.forEach((key, index) => cacheRawValue(scope, key, values[index]));
+      emitBatchChange(scope, "import", "native", changes);
     }, keys.length);
   }
 };
@@ -866,20 +1017,24 @@ function createStorageItem(config) {
     return raw;
   };
   const writeStoredRaw = rawValue => {
+    const oldValue = undefined;
     if (isBiometric) {
       getStorageModule().setSecureBiometricWithLevel(storageKey, rawValue, resolvedBiometricLevel);
+      emitKeyChange(config.scope, storageKey, oldValue, rawValue, "set", "native");
       return;
     }
     cacheRawValue(nonMemoryScope, storageKey, rawValue);
     if (nonMemoryScope === _Storage.StorageScope.Disk) {
       if (coalesceDiskWrites || diskWritesAsync) {
         scheduleDiskWrite(storageKey, rawValue);
+        emitKeyChange(config.scope, storageKey, oldValue, rawValue, "set", "native");
         return;
       }
       clearPendingDiskWrite(storageKey);
     }
     if (coalesceSecureWrites) {
       scheduleSecureWrite(storageKey, rawValue, secureAccessControl ?? secureDefaultAccessControl);
+      emitKeyChange(config.scope, storageKey, oldValue, rawValue, "set", "native");
       return;
     }
     if (nonMemoryScope === _Storage.StorageScope.Secure) {
@@ -887,36 +1042,44 @@ function createStorageItem(config) {
       getStorageModule().setSecureAccessControl(secureAccessControl ?? secureDefaultAccessControl);
     }
     getStorageModule().set(storageKey, rawValue, config.scope);
+    emitKeyChange(config.scope, storageKey, oldValue, rawValue, "set", "native");
   };
   const removeStoredRaw = () => {
+    const oldValue = getEventRawValue(config.scope, storageKey);
     if (isBiometric) {
       getStorageModule().deleteSecureBiometric(storageKey);
+      emitKeyChange(config.scope, storageKey, oldValue, undefined, "remove", "native");
       return;
     }
     cacheRawValue(nonMemoryScope, storageKey, undefined);
     if (nonMemoryScope === _Storage.StorageScope.Disk) {
       if (coalesceDiskWrites || diskWritesAsync) {
         scheduleDiskWrite(storageKey, undefined);
+        emitKeyChange(config.scope, storageKey, oldValue, undefined, "remove", "native");
         return;
       }
       clearPendingDiskWrite(storageKey);
     }
     if (coalesceSecureWrites) {
       scheduleSecureWrite(storageKey, undefined, secureAccessControl ?? secureDefaultAccessControl);
+      emitKeyChange(config.scope, storageKey, oldValue, undefined, "remove", "native");
       return;
     }
     if (nonMemoryScope === _Storage.StorageScope.Secure) {
       clearPendingSecureWrite(storageKey);
     }
     getStorageModule().remove(storageKey, config.scope);
+    emitKeyChange(config.scope, storageKey, oldValue, undefined, "remove", "native");
   };
   const writeValueWithoutValidation = value => {
     if (isMemory) {
+      const oldValue = getEventRawValue(config.scope, storageKey);
       if (memoryExpiration) {
         memoryExpiration.set(storageKey, Date.now() + (expirationTtlMs ?? 0));
       }
       memoryStore.set(storageKey, value);
       notifyKeyListeners(memoryListeners, storageKey);
+      emitKeyChange(config.scope, storageKey, oldValue, typeof value === "string" ? value : undefined, "set", "memory");
       return;
     }
     const serialized = serialize(value);
@@ -1048,11 +1211,13 @@ function createStorageItem(config) {
     measureOperation("item:delete", config.scope, () => {
       invalidateParsedCache();
       if (isMemory) {
+        const oldValue = getEventRawValue(config.scope, storageKey);
         if (memoryExpiration) {
           memoryExpiration.delete(storageKey);
         }
         memoryStore.delete(storageKey);
         notifyKeyListeners(memoryListeners, storageKey);
+        emitKeyChange(config.scope, storageKey, oldValue, undefined, "remove", "memory");
         return;
       }
       removeStoredRaw();
@@ -1089,6 +1254,22 @@ function createStorageItem(config) {
       }
     };
   };
+  const subscribeSelector = (selector, listener, options = {}) => {
+    const isEqual = options.isEqual ?? Object.is;
+    let currentValue = selector(getInternal());
+    if (options.fireImmediately === true) {
+      listener(currentValue, currentValue);
+    }
+    return subscribe(() => {
+      const nextValue = selector(getInternal());
+      if (isEqual(currentValue, nextValue)) {
+        return;
+      }
+      const previousValue = currentValue;
+      currentValue = nextValue;
+      listener(nextValue, previousValue);
+    });
+  };
   const storageItem = {
     get,
     getWithVersion,
@@ -1097,6 +1278,7 @@ function createStorageItem(config) {
     delete: deleteItem,
     has: hasItem,
     subscribe,
+    subscribeSelector,
     serialize,
     deserialize,
     _triggerListeners: () => {
@@ -1198,6 +1380,10 @@ function setBatch(items, scope) {
         }) => item.set(value));
         return;
       }
+      const changes = items.map(({
+        item,
+        value
+      }) => createKeyChange(scope, item.key, getEventRawValue(scope, item.key), typeof value === "string" ? value : undefined, "setBatch", "memory"));
 
       // Atomic write: update all values in memoryStore, invalidate caches, then batch-notify
       items.forEach(({
@@ -1210,6 +1396,7 @@ function setBatch(items, scope) {
       items.forEach(({
         item
       }) => notifyKeyListeners(memoryListeners, item.key));
+      emitBatchChange(scope, "setBatch", "memory", changes);
       return;
     }
     if (scope === _Storage.StorageScope.Secure) {
@@ -1233,6 +1420,10 @@ function setBatch(items, scope) {
       }
       flushSecureWrites();
       const storageModule = getStorageModule();
+      const keys = secureEntries.map(({
+        item
+      }) => item.key);
+      const oldValues = hasStorageChangeObservers(scope) ? storageModule.getBatch(keys, scope) ?? [] : [];
       const groupedByAccessControl = new Map();
       secureEntries.forEach(({
         item,
@@ -1256,6 +1447,10 @@ function setBatch(items, scope) {
         storageModule.setBatch(group.keys, group.values, scope);
         group.keys.forEach((key, index) => cacheRawValue(scope, key, group.values[index]));
       });
+      emitBatchChange(scope, "setBatch", "native", secureEntries.map(({
+        item,
+        value
+      }, index) => createKeyChange(scope, item.key, oldValues[index], item.serialize(value), "setBatch", "native")));
       return;
     }
     flushDiskWrites();
@@ -1271,15 +1466,19 @@ function setBatch(items, scope) {
     }
     const keys = items.map(entry => entry.item.key);
     const values = items.map(entry => entry.item.serialize(entry.value));
+    const oldValues = hasStorageChangeObservers(scope) ? getStorageModule().getBatch(keys, scope) ?? [] : [];
     getStorageModule().setBatch(keys, values, scope);
     keys.forEach((key, index) => cacheRawValue(scope, key, values[index]));
+    emitBatchChange(scope, "setBatch", "native", keys.map((key, index) => createKeyChange(scope, key, oldValues[index], values[index], "setBatch", "native")));
   }, items.length);
 }
 function removeBatch(items, scope) {
   measureOperation("batch:remove", scope, () => {
     (0, _internal.assertBatchScope)(items, scope);
     if (scope === _Storage.StorageScope.Memory) {
+      const changes = items.map(item => createKeyChange(scope, item.key, getEventRawValue(scope, item.key), undefined, "removeBatch", "memory"));
       items.forEach(item => item.delete());
+      emitBatchChange(scope, "removeBatch", "memory", changes);
       return;
     }
     const keys = items.map(item => item.key);
@@ -1289,8 +1488,10 @@ function removeBatch(items, scope) {
     if (scope === _Storage.StorageScope.Secure) {
       flushSecureWrites();
     }
+    const oldValues = hasStorageChangeObservers(scope) ? getStorageModule().getBatch(keys, scope) ?? [] : [];
     getStorageModule().removeBatch(keys, scope);
     keys.forEach(key => cacheRawValue(scope, key, undefined));
+    emitBatchChange(scope, "removeBatch", "native", keys.map((key, index) => createKeyChange(scope, key, oldValues[index], undefined, "removeBatch", "native")));
   }, items.length);
 }
 function registerMigration(version, migration) {