react-native-nitro-storage 0.3.0 → 0.3.2

package/lib/commonjs/index.js

@@ -3,12 +3,25 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "AccessControl", {
+  enumerable: true,
+  get: function () {
+    return _Storage.AccessControl;
+  }
+});
+Object.defineProperty(exports, "BiometricLevel", {
+  enumerable: true,
+  get: function () {
+    return _Storage.BiometricLevel;
+  }
+});
 Object.defineProperty(exports, "StorageScope", {
   enumerable: true,
   get: function () {
     return _Storage.StorageScope;
   }
 });
+exports.createSecureAuthStorage = createSecureAuthStorage;
 exports.createStorageItem = createStorageItem;
 exports.getBatch = getBatch;
 Object.defineProperty(exports, "migrateFromMMKV", {
@@ -23,14 +36,38 @@ exports.removeBatch = removeBatch;
 exports.runTransaction = runTransaction;
 exports.setBatch = setBatch;
 exports.storage = void 0;
-exports.useSetStorage = useSetStorage;
-exports.useStorage = useStorage;
-exports.useStorageSelector = useStorageSelector;
-var _react = require("react");
+Object.defineProperty(exports, "useSetStorage", {
+  enumerable: true,
+  get: function () {
+    return _storageHooks.useSetStorage;
+  }
+});
+Object.defineProperty(exports, "useStorage", {
+  enumerable: true,
+  get: function () {
+    return _storageHooks.useStorage;
+  }
+});
+Object.defineProperty(exports, "useStorageSelector", {
+  enumerable: true,
+  get: function () {
+    return _storageHooks.useStorageSelector;
+  }
+});
 var _reactNativeNitroModules = require("react-native-nitro-modules");
 var _Storage = require("./Storage.types");
 var _internal = require("./internal");
 var _migration = require("./migration");
+var _storageHooks = require("./storage-hooks");
+function asInternal(item) {
+  return item;
+}
+function isUpdater(valueOrFn) {
+  return typeof valueOrFn === "function";
+}
+function typedKeys(record) {
+  return Object.keys(record);
+}
 const registeredMigrations = new Map();
 const runMicrotask = typeof queueMicrotask === "function" ? queueMicrotask : task => {
   Promise.resolve().then(task);
@@ -49,6 +86,7 @@ const scopedUnsubscribers = new Map();
 const scopedRawCache = new Map([[_Storage.StorageScope.Disk, new Map()], [_Storage.StorageScope.Secure, new Map()]]);
 const pendingSecureWrites = new Map();
 let secureFlushScheduled = false;
+let secureDefaultAccessControl = _Storage.AccessControl.WhenUnlocked;
 function getScopedListeners(scope) {
   return scopedListeners.get(scope);
 }
@@ -124,6 +162,7 @@ function flushSecureWrites() {
     }
   });
   const storageModule = getStorageModule();
+  storageModule.setSecureAccessControl(secureDefaultAccessControl);
   if (keysToSet.length > 0) {
     storageModule.setBatch(keysToSet, valuesToSet, _Storage.StorageScope.Secure);
   }
@@ -197,6 +236,7 @@ function setRawValue(key, value, scope) {
   if (scope === _Storage.StorageScope.Secure) {
     flushSecureWrites();
     clearPendingSecureWrite(key);
+    getStorageModule().setSecureAccessControl(secureDefaultAccessControl);
   }
   getStorageModule().set(key, value, scope);
   cacheRawValue(scope, key, value);
@@ -244,10 +284,86 @@ const storage = exports.storage = {
     storage.clear(_Storage.StorageScope.Memory);
     storage.clear(_Storage.StorageScope.Disk);
     storage.clear(_Storage.StorageScope.Secure);
+  },
+  clearNamespace: (namespace, 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);
+        }
+      }
+      notifyAllListeners(memoryListeners);
+      return;
+    }
+    const keyPrefix = (0, _internal.prefixKey)(namespace, "");
+    if (scope === _Storage.StorageScope.Secure) {
+      flushSecureWrites();
+    }
+    clearScopeRawCache(scope);
+    getStorageModule().removeByPrefix(keyPrefix, scope);
+  },
+  clearBiometric: () => {
+    getStorageModule().clearSecureBiometric();
+  },
+  has: (key, scope) => {
+    (0, _internal.assertValidScope)(scope);
+    if (scope === _Storage.StorageScope.Memory) {
+      return memoryStore.has(key);
+    }
+    return getStorageModule().has(key, scope);
+  },
+  getAllKeys: scope => {
+    (0, _internal.assertValidScope)(scope);
+    if (scope === _Storage.StorageScope.Memory) {
+      return Array.from(memoryStore.keys());
+    }
+    return getStorageModule().getAllKeys(scope);
+  },
+  getAll: scope => {
+    (0, _internal.assertValidScope)(scope);
+    const result = {};
+    if (scope === _Storage.StorageScope.Memory) {
+      memoryStore.forEach((value, key) => {
+        if (typeof value === "string") result[key] = value;
+      });
+      return result;
+    }
+    const keys = getStorageModule().getAllKeys(scope);
+    if (keys.length === 0) return result;
+    const values = getStorageModule().getBatch(keys, scope);
+    keys.forEach((key, idx) => {
+      const val = (0, _internal.decodeNativeBatchValue)(values[idx]);
+      if (val !== undefined) result[key] = val;
+    });
+    return result;
+  },
+  size: scope => {
+    (0, _internal.assertValidScope)(scope);
+    if (scope === _Storage.StorageScope.Memory) {
+      return memoryStore.size;
+    }
+    return getStorageModule().size(scope);
+  },
+  setAccessControl: level => {
+    secureDefaultAccessControl = level;
+    getStorageModule().setSecureAccessControl(level);
+  },
+  setSecureWritesAsync: enabled => {
+    getStorageModule().setSecureWritesAsync(enabled);
+  },
+  flushSecureWrites: () => {
+    flushSecureWrites();
+  },
+  setKeychainAccessGroup: group => {
+    getStorageModule().setKeychainAccessGroup(group);
   }
 };
 function canUseRawBatchPath(item) {
-  return item._hasExpiration === false && item._hasValidation === false;
+  return item._hasExpiration === false && item._hasValidation === false && item._isBiometric !== true && item._secureAccessControl === undefined;
+}
+function canUseSecureRawBatchPath(item) {
+  return item._hasExpiration === false && item._hasValidation === false && item._isBiometric !== true;
 }
 function defaultSerialize(value) {
   return (0, _internal.serializeWithPrimitiveFastPath)(value);
@@ -256,16 +372,21 @@ function defaultDeserialize(value) {
   return (0, _internal.deserializeWithPrimitiveFastPath)(value);
 }
 function createStorageItem(config) {
+  const storageKey = (0, _internal.prefixKey)(config.namespace, config.key);
   const serialize = config.serialize ?? defaultSerialize;
   const deserialize = config.deserialize ?? defaultDeserialize;
   const isMemory = config.scope === _Storage.StorageScope.Memory;
+  const isBiometric = config.biometric === true && config.scope === _Storage.StorageScope.Secure;
+  const secureAccessControl = config.accessControl;
   const validate = config.validate;
   const onValidationError = config.onValidationError;
   const expiration = config.expiration;
+  const onExpired = config.onExpired;
   const expirationTtlMs = expiration?.ttlMs;
   const memoryExpiration = expiration && isMemory ? new Map() : null;
   const readCache = !isMemory && config.readCache === true;
-  const coalesceSecureWrites = config.scope === _Storage.StorageScope.Secure && config.coalesceSecureWrites === true;
+  const coalesceSecureWrites = config.scope === _Storage.StorageScope.Secure && config.coalesceSecureWrites === true && !isBiometric && secureAccessControl === undefined;
+  const defaultValue = config.defaultValue;
   const nonMemoryScope = config.scope === _Storage.StorageScope.Disk ? _Storage.StorageScope.Disk : config.scope === _Storage.StorageScope.Secure ? _Storage.StorageScope.Secure : null;
   if (expiration && expiration.ttlMs <= 0) {
     throw new Error("expiration.ttlMs must be greater than 0.");
@@ -275,10 +396,12 @@ function createStorageItem(config) {
   let lastRaw = undefined;
   let lastValue;
   let hasLastValue = false;
+  let lastExpiresAt = undefined;
   const invalidateParsedCache = () => {
     lastRaw = undefined;
     lastValue = undefined;
     hasLastValue = false;
+    lastExpiresAt = undefined;
   };
   const ensureSubscription = () => {
     if (unsubscribe) {
@@ -289,66 +412,79 @@ function createStorageItem(config) {
       listeners.forEach(callback => callback());
     };
     if (isMemory) {
-      unsubscribe = addKeyListener(memoryListeners, config.key, listener);
+      unsubscribe = addKeyListener(memoryListeners, storageKey, listener);
       return;
     }
     ensureNativeScopeSubscription(nonMemoryScope);
-    unsubscribe = addKeyListener(getScopedListeners(nonMemoryScope), config.key, listener);
+    unsubscribe = addKeyListener(getScopedListeners(nonMemoryScope), storageKey, listener);
   };
   const readStoredRaw = () => {
     if (isMemory) {
       if (memoryExpiration) {
-        const expiresAt = memoryExpiration.get(config.key);
+        const expiresAt = memoryExpiration.get(storageKey);
         if (expiresAt !== undefined && expiresAt <= Date.now()) {
-          memoryExpiration.delete(config.key);
-          memoryStore.delete(config.key);
-          notifyKeyListeners(memoryListeners, config.key);
+          memoryExpiration.delete(storageKey);
+          memoryStore.delete(storageKey);
+          notifyKeyListeners(memoryListeners, storageKey);
+          onExpired?.(storageKey);
           return undefined;
         }
       }
-      return memoryStore.get(config.key);
+      return memoryStore.get(storageKey);
     }
-    if (nonMemoryScope === _Storage.StorageScope.Secure && hasPendingSecureWrite(config.key)) {
-      return readPendingSecureWrite(config.key);
+    if (nonMemoryScope === _Storage.StorageScope.Secure && !isBiometric && hasPendingSecureWrite(storageKey)) {
+      return readPendingSecureWrite(storageKey);
     }
     if (readCache) {
-      if (hasCachedRawValue(nonMemoryScope, config.key)) {
-        return readCachedRawValue(nonMemoryScope, config.key);
+      if (hasCachedRawValue(nonMemoryScope, storageKey)) {
+        return readCachedRawValue(nonMemoryScope, storageKey);
       }
     }
-    const raw = getStorageModule().get(config.key, config.scope);
-    cacheRawValue(nonMemoryScope, config.key, raw);
+    if (isBiometric) {
+      return getStorageModule().getSecureBiometric(storageKey);
+    }
+    const raw = getStorageModule().get(storageKey, config.scope);
+    cacheRawValue(nonMemoryScope, storageKey, raw);
     return raw;
   };
   const writeStoredRaw = rawValue => {
-    cacheRawValue(nonMemoryScope, config.key, rawValue);
+    if (isBiometric) {
+      getStorageModule().setSecureBiometric(storageKey, rawValue);
+      return;
+    }
+    cacheRawValue(nonMemoryScope, storageKey, rawValue);
     if (coalesceSecureWrites) {
-      scheduleSecureWrite(config.key, rawValue);
+      scheduleSecureWrite(storageKey, rawValue);
       return;
     }
     if (nonMemoryScope === _Storage.StorageScope.Secure) {
-      clearPendingSecureWrite(config.key);
+      clearPendingSecureWrite(storageKey);
+      getStorageModule().setSecureAccessControl(secureAccessControl ?? secureDefaultAccessControl);
     }
-    getStorageModule().set(config.key, rawValue, config.scope);
+    getStorageModule().set(storageKey, rawValue, config.scope);
   };
   const removeStoredRaw = () => {
-    cacheRawValue(nonMemoryScope, config.key, undefined);
+    if (isBiometric) {
+      getStorageModule().deleteSecureBiometric(storageKey);
+      return;
+    }
+    cacheRawValue(nonMemoryScope, storageKey, undefined);
     if (coalesceSecureWrites) {
-      scheduleSecureWrite(config.key, undefined);
+      scheduleSecureWrite(storageKey, undefined);
       return;
     }
     if (nonMemoryScope === _Storage.StorageScope.Secure) {
-      clearPendingSecureWrite(config.key);
+      clearPendingSecureWrite(storageKey);
     }
-    getStorageModule().remove(config.key, config.scope);
+    getStorageModule().remove(storageKey, config.scope);
   };
   const writeValueWithoutValidation = value => {
     if (isMemory) {
       if (memoryExpiration) {
-        memoryExpiration.set(config.key, Date.now() + (expirationTtlMs ?? 0));
+        memoryExpiration.set(storageKey, Date.now() + (expirationTtlMs ?? 0));
       }
-      memoryStore.set(config.key, value);
-      notifyKeyListeners(memoryListeners, config.key);
+      memoryStore.set(storageKey, value);
+      notifyKeyListeners(memoryListeners, storageKey);
       return;
     }
     const serialized = serialize(value);
@@ -367,7 +503,7 @@ function createStorageItem(config) {
     if (onValidationError) {
       return onValidationError(invalidValue);
     }
-    return config.defaultValue;
+    return defaultValue;
   };
   const ensureValidatedValue = (candidate, hadStoredValue) => {
     if (!validate || validate(candidate)) {
@@ -375,7 +511,7 @@ function createStorageItem(config) {
     }
     const resolved = resolveInvalidValue(candidate);
     if (validate && !validate(resolved)) {
-      return config.defaultValue;
+      return defaultValue;
     }
     if (hadStoredValue) {
       writeValueWithoutValidation(resolved);
@@ -384,30 +520,53 @@ function createStorageItem(config) {
   };
   const get = () => {
     const raw = readStoredRaw();
-    const canUseCachedValue = !expiration && !memoryExpiration;
-    if (canUseCachedValue && raw === lastRaw && hasLastValue) {
-      return lastValue;
+    if (!memoryExpiration && raw === lastRaw && hasLastValue) {
+      if (!expiration || lastExpiresAt === null) {
+        return lastValue;
+      }
+      if (typeof lastExpiresAt === "number") {
+        if (lastExpiresAt > Date.now()) {
+          return lastValue;
+        }
+        removeStoredRaw();
+        invalidateParsedCache();
+        onExpired?.(storageKey);
+        lastValue = ensureValidatedValue(defaultValue, false);
+        hasLastValue = true;
+        return lastValue;
+      }
     }
     lastRaw = raw;
     if (raw === undefined) {
-      lastValue = ensureValidatedValue(config.defaultValue, false);
+      lastExpiresAt = undefined;
+      lastValue = ensureValidatedValue(defaultValue, false);
       hasLastValue = true;
       return lastValue;
     }
     if (isMemory) {
+      lastExpiresAt = undefined;
       lastValue = ensureValidatedValue(raw, true);
       hasLastValue = true;
       return lastValue;
     }
+    if (typeof raw !== "string") {
+      lastExpiresAt = undefined;
+      lastValue = ensureValidatedValue(defaultValue, false);
+      hasLastValue = true;
+      return lastValue;
+    }
     let deserializableRaw = raw;
     if (expiration) {
+      let envelopeExpiresAt = null;
       try {
         const parsed = JSON.parse(raw);
         if ((0, _internal.isStoredEnvelope)(parsed)) {
+          envelopeExpiresAt = parsed.expiresAt;
           if (parsed.expiresAt <= Date.now()) {
             removeStoredRaw();
             invalidateParsedCache();
-            lastValue = ensureValidatedValue(config.defaultValue, false);
+            onExpired?.(storageKey);
+            lastValue = ensureValidatedValue(defaultValue, false);
             hasLastValue = true;
             return lastValue;
           }
@@ -416,17 +575,19 @@ function createStorageItem(config) {
       } catch {
         // Keep backward compatibility with legacy raw values.
       }
+      lastExpiresAt = envelopeExpiresAt;
+    } else {
+      lastExpiresAt = undefined;
     }
     lastValue = ensureValidatedValue(deserialize(deserializableRaw), true);
     hasLastValue = true;
     return lastValue;
   };
   const set = valueOrFn => {
-    const currentValue = get();
-    const newValue = typeof valueOrFn === "function" ? valueOrFn(currentValue) : valueOrFn;
+    const newValue = isUpdater(valueOrFn) ? valueOrFn(get()) : valueOrFn;
     invalidateParsedCache();
     if (validate && !validate(newValue)) {
-      throw new Error(`Validation failed for key "${config.key}" in scope "${_Storage.StorageScope[config.scope]}".`);
+      throw new Error(`Validation failed for key "${storageKey}" in scope "${_Storage.StorageScope[config.scope]}".`);
     }
     writeValueWithoutValidation(newValue);
   };
@@ -434,14 +595,19 @@ function createStorageItem(config) {
     invalidateParsedCache();
     if (isMemory) {
       if (memoryExpiration) {
-        memoryExpiration.delete(config.key);
+        memoryExpiration.delete(storageKey);
       }
-      memoryStore.delete(config.key);
-      notifyKeyListeners(memoryListeners, config.key);
+      memoryStore.delete(storageKey);
+      notifyKeyListeners(memoryListeners, storageKey);
       return;
     }
     removeStoredRaw();
   };
+  const hasItem = () => {
+    if (isMemory) return memoryStore.has(storageKey);
+    if (isBiometric) return getStorageModule().hasSecureBiometric(storageKey);
+    return getStorageModule().has(storageKey, config.scope);
+  };
   const subscribe = callback => {
     ensureSubscription();
     listeners.add(callback);
@@ -460,6 +626,7 @@ function createStorageItem(config) {
     get,
     set,
     delete: deleteItem,
+    has: hasItem,
     subscribe,
     serialize,
     deserialize,
@@ -470,43 +637,21 @@ function createStorageItem(config) {
     _hasValidation: validate !== undefined,
     _hasExpiration: expiration !== undefined,
     _readCacheEnabled: readCache,
+    _isBiometric: isBiometric,
+    ...(secureAccessControl !== undefined ? {
+      _secureAccessControl: secureAccessControl
+    } : {}),
     scope: config.scope,
-    key: config.key
+    key: storageKey
   };
   return storageItem;
 }
-function useStorage(item) {
-  const value = (0, _react.useSyncExternalStore)(item.subscribe, item.get, item.get);
-  return [value, item.set];
-}
-function useStorageSelector(item, selector, isEqual = Object.is) {
-  const selectedRef = (0, _react.useRef)({
-    hasValue: false
-  });
-  const getSelectedSnapshot = () => {
-    const nextSelected = selector(item.get());
-    const current = selectedRef.current;
-    if (current.hasValue && isEqual(current.value, nextSelected)) {
-      return current.value;
-    }
-    selectedRef.current = {
-      hasValue: true,
-      value: nextSelected
-    };
-    return nextSelected;
-  };
-  const selectedValue = (0, _react.useSyncExternalStore)(item.subscribe, getSelectedSnapshot, getSelectedSnapshot);
-  return [selectedValue, item.set];
-}
-function useSetStorage(item) {
-  return item.set;
-}
 function getBatch(items, scope) {
   (0, _internal.assertBatchScope)(items, scope);
   if (scope === _Storage.StorageScope.Memory) {
     return items.map(item => item.get());
   }
-  const useRawBatchPath = items.every(item => canUseRawBatchPath(item));
+  const useRawBatchPath = items.every(item => scope === _Storage.StorageScope.Secure ? canUseSecureRawBatchPath(item) : canUseRawBatchPath(item));
   if (!useRawBatchPath) {
     return items.map(item => item.get());
   }
@@ -535,6 +680,9 @@ function getBatch(items, scope) {
     fetchedValues.forEach((value, index) => {
       const key = keysToFetch[index];
       const targetIndex = keyIndexes[index];
+      if (key === undefined || targetIndex === undefined) {
+        return;
+      }
       rawValues[targetIndex] = value;
       cacheRawValue(scope, key, value);
     });
@@ -556,9 +704,55 @@ function setBatch(items, scope) {
     }) => item.set(value));
     return;
   }
+  if (scope === _Storage.StorageScope.Secure) {
+    const secureEntries = items.map(({
+      item,
+      value
+    }) => ({
+      item,
+      value,
+      internal: asInternal(item)
+    }));
+    const canUseSecureBatchPath = secureEntries.every(({
+      internal
+    }) => canUseSecureRawBatchPath(internal));
+    if (!canUseSecureBatchPath) {
+      items.forEach(({
+        item,
+        value
+      }) => item.set(value));
+      return;
+    }
+    flushSecureWrites();
+    const storageModule = getStorageModule();
+    const groupedByAccessControl = new Map();
+    secureEntries.forEach(({
+      item,
+      value,
+      internal
+    }) => {
+      const accessControl = internal._secureAccessControl ?? secureDefaultAccessControl;
+      const existingGroup = groupedByAccessControl.get(accessControl);
+      const group = existingGroup ?? {
+        keys: [],
+        values: []
+      };
+      group.keys.push(item.key);
+      group.values.push(item.serialize(value));
+      if (!existingGroup) {
+        groupedByAccessControl.set(accessControl, group);
+      }
+    });
+    groupedByAccessControl.forEach((group, accessControl) => {
+      storageModule.setSecureAccessControl(accessControl);
+      storageModule.setBatch(group.keys, group.values, scope);
+      group.keys.forEach((key, index) => cacheRawValue(scope, key, group.values[index]));
+    });
+    return;
+  }
   const useRawBatchPath = items.every(({
     item
-  }) => canUseRawBatchPath(item));
+  }) => canUseRawBatchPath(asInternal(item)));
   if (!useRawBatchPath) {
     items.forEach(({
       item,
@@ -568,9 +762,6 @@ function setBatch(items, scope) {
   }
   const keys = items.map(entry => entry.item.key);
   const values = items.map(entry => entry.item.serialize(entry.value));
-  if (scope === _Storage.StorageScope.Secure) {
-    flushSecureWrites();
-  }
   getStorageModule().setBatch(keys, values, scope);
   keys.forEach((key, index) => cacheRawValue(scope, key, values[index]));
 }
@@ -669,4 +860,30 @@ function runTransaction(scope, transaction) {
     throw error;
   }
 }
+function createSecureAuthStorage(config, options) {
+  const ns = options?.namespace ?? "auth";
+  const result = {};
+  for (const key of typedKeys(config)) {
+    const itemConfig = config[key];
+    const expirationConfig = itemConfig.ttlMs !== undefined ? {
+      ttlMs: itemConfig.ttlMs
+    } : undefined;
+    result[key] = createStorageItem({
+      key,
+      scope: _Storage.StorageScope.Secure,
+      defaultValue: "",
+      namespace: ns,
+      ...(itemConfig.biometric !== undefined ? {
+        biometric: itemConfig.biometric
+      } : {}),
+      ...(itemConfig.accessControl !== undefined ? {
+        accessControl: itemConfig.accessControl
+      } : {}),
+      ...(expirationConfig !== undefined ? {
+        expiration: expirationConfig
+      } : {})
+    });
+  }
+  return result;
+}
 //# sourceMappingURL=index.js.map