react-native-nitro-storage 0.5.7 → 0.5.9

package/lib/commonjs/storage-core.js

@@ -0,0 +1,1505 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createStorageCore = createStorageCore;
+var _shared = require("./shared");
+var _Storage = require("./Storage.types");
+var _internal = require("./internal");
+var _storageEvents = require("./storage-events");
+function asInternal(item) {
+  return item;
+}
+function createStorageCore(buildAdapter) {
+  const registeredMigrations = new Map();
+  const memoryStore = new Map();
+  const memoryListeners = new Map();
+  const scopedListeners = new Map([[_Storage.StorageScope.Disk, new Map()], [_Storage.StorageScope.Secure, new Map()]]);
+  const scopedRawCache = new Map([[_Storage.StorageScope.Disk, new Map()], [_Storage.StorageScope.Secure, new Map()]]);
+  const pendingDiskWrites = new Map();
+  let diskFlushScheduled = false;
+  let diskWritesAsync = false;
+  const pendingSecureWrites = new Map();
+  let secureFlushScheduled = false;
+  let secureDefaultAccessControl = _Storage.AccessControl.WhenUnlocked;
+  let metricsObserver;
+  let eventObserver;
+  let eventObserverRedactSecureValues = true;
+  const metricsCounters = new Map();
+  const storageEvents = new _storageEvents.StorageEventRegistry();
+  function recordMetric(operation, scope, durationMs, keysCount = 1) {
+    const existing = metricsCounters.get(operation);
+    if (!existing) {
+      metricsCounters.set(operation, {
+        count: 1,
+        totalDurationMs: durationMs,
+        maxDurationMs: durationMs
+      });
+    } else {
+      existing.count += 1;
+      existing.totalDurationMs += durationMs;
+      existing.maxDurationMs = Math.max(existing.maxDurationMs, durationMs);
+    }
+    metricsObserver?.({
+      operation,
+      scope,
+      durationMs,
+      keysCount
+    });
+  }
+  function measureOperation(operation, scope, fn, keysCount = 1) {
+    if (!metricsObserver) {
+      return fn();
+    }
+    const start = (0, _shared.now)();
+    try {
+      return fn();
+    } finally {
+      recordMetric(operation, scope, (0, _shared.now)() - start, keysCount);
+    }
+  }
+  function getScopedListeners(scope) {
+    return scopedListeners.get(scope);
+  }
+  function getScopeRawCache(scope) {
+    return scopedRawCache.get(scope);
+  }
+  function cacheRawValue(scope, key, value) {
+    getScopeRawCache(scope).set(key, value);
+  }
+  function readCachedRawValue(scope, key) {
+    return getScopeRawCache(scope).get(key);
+  }
+  function clearScopeRawCache(scope) {
+    getScopeRawCache(scope).clear();
+  }
+  function addKeyListener(registry, key, listener) {
+    let listeners = registry.get(key);
+    if (!listeners) {
+      listeners = new Set();
+      registry.set(key, listeners);
+    }
+    listeners.add(listener);
+    return () => {
+      const keyListeners = registry.get(key);
+      if (!keyListeners) {
+        return;
+      }
+      keyListeners.delete(listener);
+      if (keyListeners.size === 0) {
+        registry.delete(key);
+      }
+    };
+  }
+  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 shouldReadPreviousEventValues(scope) {
+    if (storageEvents.hasListeners(scope)) {
+      return true;
+    }
+    if (!eventObserver) {
+      return false;
+    }
+    return scope !== _Storage.StorageScope.Secure || !eventObserverRedactSecureValues;
+  }
+  function eventForGlobalObserver(event) {
+    if (!eventObserverRedactSecureValues || event.scope !== _Storage.StorageScope.Secure) {
+      return event;
+    }
+    if (event.type === "key") {
+      return (0, _shared.redactSecureKeyChange)(event);
+    }
+    return {
+      ...event,
+      changes: event.changes.map(_shared.redactSecureKeyChange)
+    };
+  }
+  function emitKeyChange(scope, key, oldValue, newValue, operation, source) {
+    adapter.onWillEmitChanges(scope, [key], operation, source);
+    const event = (0, _shared.createKeyChange)(scope, key, oldValue, newValue, operation, source);
+    storageEvents.emitKey(event);
+    eventObserver?.(eventForGlobalObserver(event));
+  }
+  function emitBatchChange(scope, operation, source, changes) {
+    if (changes.length === 0) {
+      return;
+    }
+    adapter.onWillEmitChanges(scope, changes.map(change => change.key), operation, source);
+    const event = {
+      type: "batch",
+      scope,
+      operation,
+      source,
+      changes
+    };
+    storageEvents.emitBatch(event);
+    eventObserver?.(eventForGlobalObserver(event));
+  }
+  function readPendingSecureWrite(key) {
+    return pendingSecureWrites.get(key)?.value;
+  }
+  function readPendingDiskWrite(key) {
+    return pendingDiskWrites.get(key)?.value;
+  }
+  function hasPendingDiskWrite(key) {
+    return pendingDiskWrites.has(key);
+  }
+  function hasPendingSecureWrite(key) {
+    return pendingSecureWrites.has(key);
+  }
+  function clearPendingDiskWrite(key) {
+    pendingDiskWrites.delete(key);
+  }
+  function clearPendingSecureWrite(key) {
+    pendingSecureWrites.delete(key);
+  }
+  function flushDiskWrites() {
+    diskFlushScheduled = false;
+    if (pendingDiskWrites.size === 0) {
+      return;
+    }
+    const writes = Array.from(pendingDiskWrites.values());
+    pendingDiskWrites.clear();
+    const keysToSet = [];
+    const valuesToSet = [];
+    const keysToRemove = [];
+    writes.forEach(({
+      key,
+      value
+    }) => {
+      if (value === undefined) {
+        keysToRemove.push(key);
+        return;
+      }
+      keysToSet.push(key);
+      valuesToSet.push(value);
+    });
+    if (keysToSet.length > 0) {
+      adapter.backend.setBatch(keysToSet, valuesToSet, _Storage.StorageScope.Disk);
+    }
+    if (keysToRemove.length > 0) {
+      adapter.backend.removeBatch(keysToRemove, _Storage.StorageScope.Disk);
+    }
+  }
+  function flushSecureWrites() {
+    secureFlushScheduled = false;
+    if (pendingSecureWrites.size === 0) {
+      return;
+    }
+    const writes = Array.from(pendingSecureWrites.values());
+    pendingSecureWrites.clear();
+    const groupedSetWrites = new Map();
+    const keysToRemove = [];
+    writes.forEach(({
+      key,
+      value,
+      accessControl
+    }) => {
+      if (value === undefined) {
+        keysToRemove.push(key);
+      } else {
+        const resolvedAccessControl = accessControl ?? secureDefaultAccessControl;
+        const existingGroup = groupedSetWrites.get(resolvedAccessControl);
+        const group = existingGroup ?? {
+          keys: [],
+          values: []
+        };
+        group.keys.push(key);
+        group.values.push(value);
+        if (!existingGroup) {
+          groupedSetWrites.set(resolvedAccessControl, group);
+        }
+      }
+    });
+    groupedSetWrites.forEach((group, accessControl) => {
+      adapter.backend.setSecureAccessControl(accessControl);
+      adapter.backend.setBatch(group.keys, group.values, _Storage.StorageScope.Secure);
+    });
+    if (keysToRemove.length > 0) {
+      adapter.backend.removeBatch(keysToRemove, _Storage.StorageScope.Secure);
+    }
+  }
+  function scheduleDiskWrite(key, value) {
+    pendingDiskWrites.set(key, {
+      key,
+      value
+    });
+    if (diskFlushScheduled) {
+      return;
+    }
+    diskFlushScheduled = true;
+    (0, _shared.runMicrotask)(flushDiskWrites);
+  }
+  function scheduleSecureWrite(key, value, accessControl) {
+    const pendingWrite = {
+      key,
+      value
+    };
+    if (accessControl !== undefined) {
+      pendingWrite.accessControl = accessControl;
+    }
+    pendingSecureWrites.set(key, pendingWrite);
+    if (secureFlushScheduled) {
+      return;
+    }
+    secureFlushScheduled = true;
+    (0, _shared.runMicrotask)(flushSecureWrites);
+  }
+  function getRawValue(key, scope) {
+    (0, _internal.assertValidScope)(scope);
+    if (scope === _Storage.StorageScope.Memory) {
+      const value = memoryStore.get(key);
+      return typeof value === "string" ? value : undefined;
+    }
+    if (scope === _Storage.StorageScope.Disk && hasPendingDiskWrite(key)) {
+      return readPendingDiskWrite(key);
+    }
+    if (scope === _Storage.StorageScope.Secure && hasPendingSecureWrite(key)) {
+      return readPendingSecureWrite(key);
+    }
+    return adapter.backend.get(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);
+      (0, _shared.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", adapter.changeSource);
+        return;
+      }
+      flushDiskWrites();
+      clearPendingDiskWrite(key);
+    }
+    if (scope === _Storage.StorageScope.Secure) {
+      flushSecureWrites();
+      clearPendingSecureWrite(key);
+      if (adapter.applyAccessControlOnSecureRawWrite) {
+        adapter.backend.setSecureAccessControl(secureDefaultAccessControl);
+      }
+    }
+    adapter.backend.set(key, value, scope);
+    cacheRawValue(scope, key, value);
+    emitKeyChange(scope, key, oldValue, value, "set", adapter.changeSource);
+  }
+  function removeRawValue(key, scope) {
+    (0, _internal.assertValidScope)(scope);
+    const oldValue = getEventRawValue(scope, key);
+    if (scope === _Storage.StorageScope.Memory) {
+      memoryStore.delete(key);
+      (0, _shared.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", adapter.changeSource);
+        return;
+      }
+      flushDiskWrites();
+      clearPendingDiskWrite(key);
+    }
+    if (scope === _Storage.StorageScope.Secure) {
+      flushSecureWrites();
+      clearPendingSecureWrite(key);
+    }
+    adapter.backend.remove(key, scope);
+    cacheRawValue(scope, key, undefined);
+    emitKeyChange(scope, key, oldValue, undefined, "remove", adapter.changeSource);
+  }
+  function readMigrationVersion(scope) {
+    const raw = getRawValue(_internal.MIGRATION_VERSION_KEY, scope);
+    if (raw === undefined) {
+      return 0;
+    }
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
+  }
+  function writeMigrationVersion(scope, version) {
+    setRawValue(_internal.MIGRATION_VERSION_KEY, String(version), scope);
+  }
+  const internals = {
+    getScopedListeners,
+    cacheRawValue,
+    readCachedRawValue,
+    clearScopeRawCache,
+    clearPendingDiskWrite,
+    clearPendingSecureWrite,
+    clearAllPendingDiskWrites: () => {
+      pendingDiskWrites.clear();
+    },
+    clearAllPendingSecureWrites: () => {
+      pendingSecureWrites.clear();
+    },
+    flushDiskWrites,
+    flushSecureWrites,
+    emitKeyChange,
+    hasEventObserver: () => eventObserver !== undefined,
+    hasScopeEventListeners: scope => storageEvents.hasListeners(scope),
+    measureOperation,
+    recordMetric,
+    getSecureDefaultAccessControl: () => secureDefaultAccessControl,
+    setSecureDefaultAccessControl: level => {
+      secureDefaultAccessControl = level;
+    }
+  };
+  const adapter = buildAdapter(internals);
+  const storage = {
+    subscribe: (scope, listener) => {
+      (0, _internal.assertValidScope)(scope);
+      if (scope !== _Storage.StorageScope.Memory) {
+        adapter.ensureScopeSubscription(scope);
+        const unsubscribe = storageEvents.subscribe(scope, listener);
+        return () => {
+          unsubscribe();
+          adapter.maybeCleanupScopeSubscription(scope);
+        };
+      }
+      return storageEvents.subscribe(scope, listener);
+    },
+    subscribeKey: (scope, key, listener) => {
+      (0, _internal.assertValidScope)(scope);
+      if (scope !== _Storage.StorageScope.Memory) {
+        adapter.ensureScopeSubscription(scope);
+        const unsubscribe = storageEvents.subscribeKey(scope, key, listener);
+        return () => {
+          unsubscribe();
+          adapter.maybeCleanupScopeSubscription(scope);
+        };
+      }
+      return storageEvents.subscribeKey(scope, key, listener);
+    },
+    subscribePrefix: (scope, prefix, listener) => {
+      (0, _internal.assertValidScope)(scope);
+      if (scope !== _Storage.StorageScope.Memory) {
+        adapter.ensureScopeSubscription(scope);
+        const unsubscribe = storageEvents.subscribePrefix(scope, prefix, listener);
+        return () => {
+          unsubscribe();
+          adapter.maybeCleanupScopeSubscription(scope);
+        };
+      }
+      return storageEvents.subscribePrefix(scope, prefix, listener);
+    },
+    subscribeNamespace: (namespace, scope, listener) => {
+      return storage.subscribePrefix(scope, (0, _internal.prefixKey)(namespace, ""), listener);
+    },
+    setEventObserver: (observer, options = {}) => {
+      eventObserver = observer;
+      eventObserverRedactSecureValues = options.redactSecureValues !== false;
+      if (observer) {
+        adapter.ensureScopeSubscription(_Storage.StorageScope.Disk);
+        adapter.ensureScopeSubscription(_Storage.StorageScope.Secure);
+        return;
+      }
+      adapter.maybeCleanupScopeSubscription(_Storage.StorageScope.Disk);
+      adapter.maybeCleanupScopeSubscription(_Storage.StorageScope.Secure);
+    },
+    clear: scope => {
+      measureOperation("storage:clear", scope, () => {
+        const previousValues = shouldReadPreviousEventValues(scope) ? storage.getAll(scope) : {};
+        if (scope === _Storage.StorageScope.Memory) {
+          memoryStore.clear();
+          (0, _shared.notifyAllListeners)(memoryListeners);
+          emitBatchChange(scope, "clear", "memory", Object.keys(previousValues).map(key => (0, _shared.createKeyChange)(scope, key, previousValues[key], undefined, "clear", "memory")));
+          return;
+        }
+        if (scope === _Storage.StorageScope.Disk) {
+          flushDiskWrites();
+          pendingDiskWrites.clear();
+        }
+        if (scope === _Storage.StorageScope.Secure) {
+          flushSecureWrites();
+          pendingSecureWrites.clear();
+        }
+        clearScopeRawCache(scope);
+        adapter.backend.clear(scope);
+        emitBatchChange(scope, "clear", adapter.changeSource, Object.keys(previousValues).map(key => (0, _shared.createKeyChange)(scope, key, previousValues[key], undefined, "clear", adapter.changeSource)));
+      });
+    },
+    clearAll: () => {
+      measureOperation("storage:clearAll", _Storage.StorageScope.Memory, () => {
+        storage.clear(_Storage.StorageScope.Memory);
+        storage.clear(_Storage.StorageScope.Disk);
+        storage.clear(_Storage.StorageScope.Secure);
+      }, 3);
+    },
+    clearNamespace: (namespace, scope) => {
+      measureOperation("storage:clearNamespace", scope, () => {
+        (0, _internal.assertValidScope)(scope);
+        if (scope === _Storage.StorageScope.Memory) {
+          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;
+          }
+          affectedKeys.forEach(key => {
+            memoryStore.delete(key);
+          });
+          affectedKeys.forEach(key => (0, _shared.notifyKeyListeners)(memoryListeners, key));
+          emitBatchChange(scope, "clearNamespace", "memory", previousValues.map(({
+            key,
+            value
+          }) => (0, _shared.createKeyChange)(scope, key, value, undefined, "clearNamespace", "memory")));
+          return;
+        }
+        const keyPrefix = (0, _internal.prefixKey)(namespace, "");
+        const previousValues = shouldReadPreviousEventValues(scope) ? storage.getByPrefix(keyPrefix, scope) : {};
+        if (scope === _Storage.StorageScope.Disk) {
+          flushDiskWrites();
+        }
+        if (scope === _Storage.StorageScope.Secure) {
+          flushSecureWrites();
+        }
+        const scopeCache = getScopeRawCache(scope);
+        for (const key of scopeCache.keys()) {
+          if ((0, _internal.isNamespaced)(key, namespace)) {
+            scopeCache.delete(key);
+          }
+        }
+        adapter.backend.removeByPrefix(keyPrefix, scope);
+        emitBatchChange(scope, "clearNamespace", adapter.changeSource, Object.keys(previousValues).map(key => (0, _shared.createKeyChange)(scope, key, previousValues[key], undefined, "clearNamespace", adapter.changeSource)));
+      });
+    },
+    clearBiometric: () => {
+      measureOperation("storage:clearBiometric", _Storage.StorageScope.Secure, () => {
+        adapter.backend.clearSecureBiometric();
+      });
+    },
+    has: (key, scope) => {
+      return measureOperation("storage:has", scope, () => {
+        (0, _internal.assertValidScope)(scope);
+        if (scope === _Storage.StorageScope.Memory) {
+          return memoryStore.has(key);
+        }
+        if (scope === _Storage.StorageScope.Disk) {
+          flushDiskWrites();
+        }
+        if (scope === _Storage.StorageScope.Secure) {
+          flushSecureWrites();
+        }
+        return adapter.backend.has(key, scope);
+      });
+    },
+    getAllKeys: scope => {
+      return measureOperation("storage:getAllKeys", scope, () => {
+        (0, _internal.assertValidScope)(scope);
+        if (scope === _Storage.StorageScope.Memory) {
+          return Array.from(memoryStore.keys());
+        }
+        if (scope === _Storage.StorageScope.Disk) {
+          flushDiskWrites();
+        }
+        if (scope === _Storage.StorageScope.Secure) {
+          flushSecureWrites();
+        }
+        return adapter.backend.getAllKeys(scope);
+      });
+    },
+    getKeysByPrefix: (prefix, scope) => {
+      return measureOperation("storage:getKeysByPrefix", scope, () => {
+        (0, _internal.assertValidScope)(scope);
+        if (scope === _Storage.StorageScope.Memory) {
+          return Array.from(memoryStore.keys()).filter(key => key.startsWith(prefix));
+        }
+        if (scope === _Storage.StorageScope.Disk) {
+          flushDiskWrites();
+        }
+        if (scope === _Storage.StorageScope.Secure) {
+          flushSecureWrites();
+        }
+        return adapter.backend.getKeysByPrefix(prefix, scope);
+      });
+    },
+    getByPrefix: (prefix, scope) => {
+      return measureOperation("storage:getByPrefix", scope, () => {
+        const result = {};
+        const keys = storage.getKeysByPrefix(prefix, scope);
+        if (keys.length === 0) {
+          return result;
+        }
+        if (scope === _Storage.StorageScope.Memory) {
+          keys.forEach(key => {
+            const value = memoryStore.get(key);
+            if (typeof value === "string") {
+              result[key] = value;
+            }
+          });
+          return result;
+        }
+        if (scope === _Storage.StorageScope.Disk) {
+          flushDiskWrites();
+        }
+        if (scope === _Storage.StorageScope.Secure) {
+          flushSecureWrites();
+        }
+        const values = adapter.backend.getBatch(keys, scope);
+        keys.forEach((key, idx) => {
+          const value = values[idx];
+          if (value !== undefined) {
+            result[key] = value;
+          }
+        });
+        return result;
+      });
+    },
+    getAll: scope => {
+      return measureOperation("storage:getAll", scope, () => {
+        (0, _internal.assertValidScope)(scope);
+        const result = {};
+        if (scope === _Storage.StorageScope.Memory) {
+          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) {
+          flushDiskWrites();
+        }
+        if (scope === _Storage.StorageScope.Secure) {
+          flushSecureWrites();
+        }
+        const keys = adapter.backend.getAllKeys(scope);
+        if (keys.length === 0) return result;
+        const values = adapter.backend.getBatch(keys, scope);
+        keys.forEach((key, idx) => {
+          const val = values[idx];
+          if (val !== undefined) result[key] = val;
+        });
+        return result;
+      });
+    },
+    export: (scope, options = {}) => {
+      if (scope === _Storage.StorageScope.Secure && options.includeSecureValues !== true) {
+        throw new Error("NitroStorage: exporting Secure scope exposes raw secret values. Pass { includeSecureValues: true } or use exportSecureUnsafe().");
+      }
+      return measureOperation("storage:export", scope, () => storage.getAll(scope));
+    },
+    exportSecureUnsafe: () => {
+      return measureOperation("storage:exportSecureUnsafe", _Storage.StorageScope.Secure, () => storage.getAll(_Storage.StorageScope.Secure));
+    },
+    size: scope => {
+      return measureOperation("storage:size", scope, () => {
+        (0, _internal.assertValidScope)(scope);
+        if (scope === _Storage.StorageScope.Memory) {
+          return memoryStore.size;
+        }
+        if (scope === _Storage.StorageScope.Disk) {
+          flushDiskWrites();
+        }
+        if (scope === _Storage.StorageScope.Secure) {
+          flushSecureWrites();
+        }
+        return adapter.backend.size(scope);
+      });
+    },
+    setDiskWritesAsync: enabled => {
+      measureOperation("storage:setDiskWritesAsync", _Storage.StorageScope.Disk, () => {
+        diskWritesAsync = enabled;
+        if (!enabled) {
+          flushDiskWrites();
+        }
+      });
+    },
+    flushDiskWrites: () => {
+      measureOperation("storage:flushDiskWrites", _Storage.StorageScope.Disk, () => {
+        flushDiskWrites();
+      });
+    },
+    flushSecureWrites: () => {
+      measureOperation("storage:flushSecureWrites", _Storage.StorageScope.Secure, () => {
+        flushSecureWrites();
+      });
+    },
+    setMetricsObserver: observer => {
+      metricsObserver = observer;
+    },
+    getMetricsSnapshot: () => {
+      const snapshot = {};
+      metricsCounters.forEach((value, key) => {
+        snapshot[key] = {
+          count: value.count,
+          totalDurationMs: value.totalDurationMs,
+          avgDurationMs: value.count === 0 ? 0 : value.totalDurationMs / value.count,
+          maxDurationMs: value.maxDurationMs
+        };
+      });
+      return snapshot;
+    },
+    resetMetrics: () => {
+      metricsCounters.clear();
+    },
+    getSecureMetadata: key => {
+      return measureOperation("storage:getSecureMetadata", _Storage.StorageScope.Secure, () => {
+        flushSecureWrites();
+        const profile = adapter.getSecureMetadataProfile();
+        const biometricProtected = adapter.backend.hasSecureBiometric(key);
+        const exists = biometricProtected || adapter.backend.has(key, _Storage.StorageScope.Secure);
+        let kind = "missing";
+        if (exists) {
+          kind = biometricProtected ? "biometric" : "secure";
+        }
+        return {
+          key,
+          exists,
+          kind,
+          backend: profile.backend,
+          encrypted: profile.encrypted,
+          hardwareBacked: profile.hardwareBacked,
+          biometricProtected,
+          valueExposed: false
+        };
+      });
+    },
+    getAllSecureMetadata: () => {
+      return measureOperation("storage:getAllSecureMetadata", _Storage.StorageScope.Secure, () => {
+        flushSecureWrites();
+        return adapter.backend.getAllKeys(_Storage.StorageScope.Secure).map(key => storage.getSecureMetadata(key));
+      });
+    },
+    getString: (key, scope) => {
+      return measureOperation("storage:getString", scope, () => {
+        return getRawValue(key, scope);
+      });
+    },
+    setString: (key, value, scope) => {
+      measureOperation("storage:setString", scope, () => {
+        setRawValue(key, value, scope);
+      });
+    },
+    deleteString: (key, scope) => {
+      measureOperation("storage:deleteString", scope, () => {
+        removeRawValue(key, scope);
+      });
+    },
+    import: (data, scope) => {
+      const keys = Object.keys(data);
+      measureOperation("storage:import", scope, () => {
+        (0, _internal.assertValidScope)(scope);
+        if (keys.length === 0) return;
+        const values = keys.map(k => data[k]);
+        const changes = keys.map((key, index) => (0, _shared.createKeyChange)(scope, key, getEventRawValue(scope, key), values[index], "import", scope === _Storage.StorageScope.Memory ? "memory" : adapter.changeSource));
+        if (scope === _Storage.StorageScope.Memory) {
+          keys.forEach((key, index) => {
+            memoryStore.set(key, values[index]);
+          });
+          keys.forEach(key => (0, _shared.notifyKeyListeners)(memoryListeners, key));
+          emitBatchChange(scope, "import", "memory", changes);
+          return;
+        }
+        if (scope === _Storage.StorageScope.Secure) {
+          flushSecureWrites();
+          adapter.backend.setSecureAccessControl(secureDefaultAccessControl);
+        }
+        if (scope === _Storage.StorageScope.Disk && adapter.flushDiskWritesOnImport) {
+          flushDiskWrites();
+        }
+        adapter.backend.setBatch(keys, values, scope);
+        keys.forEach((key, index) => cacheRawValue(scope, key, values[index]));
+        emitBatchChange(scope, "import", adapter.changeSource, changes);
+      }, keys.length);
+    }
+  };
+  function createStorageItem(config) {
+    const storageKey = (0, _internal.prefixKey)(config.namespace, config.key);
+    const serialize = config.serialize ?? _shared.defaultSerialize;
+    const deserialize = config.deserialize ?? _shared.defaultDeserialize;
+    const isMemory = config.scope === _Storage.StorageScope.Memory;
+    const resolvedBiometricLevel = config.scope === _Storage.StorageScope.Secure ? config.biometricLevel ?? (config.biometric === true ? _Storage.BiometricLevel.BiometryOnly : _Storage.BiometricLevel.None) : _Storage.BiometricLevel.None;
+    const isBiometric = resolvedBiometricLevel !== _Storage.BiometricLevel.None;
+    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 coalesceDiskWrites = config.scope === _Storage.StorageScope.Disk && config.coalesceDiskWrites === true;
+    const coalesceSecureWrites = config.scope === _Storage.StorageScope.Secure && config.coalesceSecureWrites === true && !isBiometric;
+    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.");
+    }
+    if (config.scope === _Storage.StorageScope.Secure) {
+      (0, _shared.assertBiometricLevel)(resolvedBiometricLevel);
+      if (secureAccessControl !== undefined) {
+        (0, _shared.assertAccessControlLevel)(secureAccessControl);
+      }
+    }
+    const listeners = new Set();
+    let unsubscribe = null;
+    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) {
+        return;
+      }
+      const listener = () => {
+        invalidateParsedCache();
+        listeners.forEach(callback => callback());
+      };
+      if (isMemory) {
+        unsubscribe = addKeyListener(memoryListeners, storageKey, listener);
+        return;
+      }
+      adapter.ensureScopeSubscription(nonMemoryScope);
+      unsubscribe = addKeyListener(getScopedListeners(nonMemoryScope), storageKey, listener);
+    };
+    const readStoredRaw = () => {
+      if (isMemory) {
+        if (memoryExpiration) {
+          const expiresAt = memoryExpiration.get(storageKey);
+          if (expiresAt !== undefined && expiresAt <= Date.now()) {
+            memoryExpiration.delete(storageKey);
+            memoryStore.delete(storageKey);
+            (0, _shared.notifyKeyListeners)(memoryListeners, storageKey);
+            onExpired?.(storageKey);
+            return undefined;
+          }
+        }
+        return memoryStore.get(storageKey);
+      }
+      if (nonMemoryScope === _Storage.StorageScope.Disk) {
+        const pending = pendingDiskWrites.get(storageKey);
+        if (pending !== undefined) {
+          return pending.value;
+        }
+      }
+      if (nonMemoryScope === _Storage.StorageScope.Secure && !isBiometric) {
+        const pending = pendingSecureWrites.get(storageKey);
+        if (pending !== undefined) {
+          return pending.value;
+        }
+      }
+      if (readCache) {
+        const cache = getScopeRawCache(nonMemoryScope);
+        const cached = cache.get(storageKey);
+        if (cached !== undefined || cache.has(storageKey)) {
+          return cached;
+        }
+      }
+      if (isBiometric) {
+        return adapter.backend.getSecureBiometric(storageKey);
+      }
+      const raw = adapter.backend.get(storageKey, config.scope);
+      cacheRawValue(nonMemoryScope, storageKey, raw);
+      return raw;
+    };
+    const writeStoredRaw = rawValue => {
+      const oldValue = undefined;
+      if (isBiometric) {
+        adapter.backend.setSecureBiometricWithLevel(storageKey, rawValue, resolvedBiometricLevel);
+        emitKeyChange(config.scope, storageKey, oldValue, rawValue, "set", adapter.changeSource);
+        return;
+      }
+      cacheRawValue(nonMemoryScope, storageKey, rawValue);
+      if (nonMemoryScope === _Storage.StorageScope.Disk) {
+        if (coalesceDiskWrites || diskWritesAsync) {
+          scheduleDiskWrite(storageKey, rawValue);
+          emitKeyChange(config.scope, storageKey, oldValue, rawValue, "set", adapter.changeSource);
+          return;
+        }
+        clearPendingDiskWrite(storageKey);
+      }
+      if (coalesceSecureWrites) {
+        scheduleSecureWrite(storageKey, rawValue, secureAccessControl ?? secureDefaultAccessControl);
+        emitKeyChange(config.scope, storageKey, oldValue, rawValue, "set", adapter.changeSource);
+        return;
+      }
+      if (nonMemoryScope === _Storage.StorageScope.Secure) {
+        clearPendingSecureWrite(storageKey);
+        if (adapter.applyAccessControlOnSecureRawWrite) {
+          adapter.backend.setSecureAccessControl(secureAccessControl ?? secureDefaultAccessControl);
+        }
+      }
+      adapter.backend.set(storageKey, rawValue, config.scope);
+      emitKeyChange(config.scope, storageKey, oldValue, rawValue, "set", adapter.changeSource);
+    };
+    const removeStoredRaw = () => {
+      const oldValue = getEventRawValue(config.scope, storageKey);
+      if (isBiometric) {
+        adapter.backend.deleteSecureBiometric(storageKey);
+        emitKeyChange(config.scope, storageKey, oldValue, undefined, "remove", adapter.changeSource);
+        return;
+      }
+      cacheRawValue(nonMemoryScope, storageKey, undefined);
+      if (nonMemoryScope === _Storage.StorageScope.Disk) {
+        if (coalesceDiskWrites || diskWritesAsync) {
+          scheduleDiskWrite(storageKey, undefined);
+          emitKeyChange(config.scope, storageKey, oldValue, undefined, "remove", adapter.changeSource);
+          return;
+        }
+        clearPendingDiskWrite(storageKey);
+      }
+      if (coalesceSecureWrites) {
+        scheduleSecureWrite(storageKey, undefined, secureAccessControl ?? secureDefaultAccessControl);
+        emitKeyChange(config.scope, storageKey, oldValue, undefined, "remove", adapter.changeSource);
+        return;
+      }
+      if (nonMemoryScope === _Storage.StorageScope.Secure) {
+        clearPendingSecureWrite(storageKey);
+      }
+      adapter.backend.remove(storageKey, config.scope);
+      emitKeyChange(config.scope, storageKey, oldValue, undefined, "remove", adapter.changeSource);
+    };
+    const writeValueWithoutValidation = value => {
+      if (isMemory) {
+        const oldValue = getEventRawValue(config.scope, storageKey);
+        if (memoryExpiration) {
+          memoryExpiration.set(storageKey, Date.now() + (expirationTtlMs ?? 0));
+        }
+        memoryStore.set(storageKey, value);
+        (0, _shared.notifyKeyListeners)(memoryListeners, storageKey);
+        emitKeyChange(config.scope, storageKey, oldValue, typeof value === "string" ? value : undefined, "set", "memory");
+        return;
+      }
+      const serialized = serialize(value);
+      if (expiration) {
+        const envelope = {
+          __nitroStorageEnvelope: true,
+          expiresAt: Date.now() + expiration.ttlMs,
+          payload: serialized
+        };
+        writeStoredRaw(JSON.stringify(envelope));
+        return;
+      }
+      writeStoredRaw(serialized);
+    };
+    const resolveInvalidValue = invalidValue => {
+      if (onValidationError) {
+        return onValidationError(invalidValue);
+      }
+      return defaultValue;
+    };
+    const ensureValidatedValue = (candidate, hadStoredValue) => {
+      if (!validate || validate(candidate)) {
+        return candidate;
+      }
+      const resolved = resolveInvalidValue(candidate);
+      if (validate && !validate(resolved)) {
+        return defaultValue;
+      }
+      if (hadStoredValue) {
+        writeValueWithoutValidation(resolved);
+      }
+      return resolved;
+    };
+    const getInternal = () => {
+      const raw = readStoredRaw();
+      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;
+          listeners.forEach(cb => cb());
+          return lastValue;
+        }
+      }
+      lastRaw = raw;
+      if (raw === undefined) {
+        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();
+              onExpired?.(storageKey);
+              lastValue = ensureValidatedValue(defaultValue, false);
+              hasLastValue = true;
+              listeners.forEach(cb => cb());
+              return lastValue;
+            }
+            deserializableRaw = parsed.payload;
+          }
+        } catch {
+          // Keep backward compatibility with legacy raw values.
+        }
+        lastExpiresAt = envelopeExpiresAt;
+      } else {
+        lastExpiresAt = undefined;
+      }
+      lastValue = ensureValidatedValue(deserialize(deserializableRaw), true);
+      hasLastValue = true;
+      return lastValue;
+    };
+    const getCurrentVersion = () => {
+      const raw = readStoredRaw();
+      return (0, _internal.toVersionToken)(raw);
+    };
+    const get = () => measureOperation("item:get", config.scope, () => getInternal());
+    const getWithVersion = () => measureOperation("item:getWithVersion", config.scope, () => ({
+      value: getInternal(),
+      version: getCurrentVersion()
+    }));
+    const set = valueOrFn => {
+      measureOperation("item:set", config.scope, () => {
+        const newValue = (0, _shared.isUpdater)(valueOrFn) ? valueOrFn(getInternal()) : valueOrFn;
+        if (validate && !validate(newValue)) {
+          throw new Error(`Validation failed for key "${storageKey}" in scope "${_Storage.StorageScope[config.scope]}".`);
+        }
+        invalidateParsedCache();
+        writeValueWithoutValidation(newValue);
+      });
+    };
+    const setIfVersion = (version, valueOrFn) => measureOperation("item:setIfVersion", config.scope, () => {
+      const currentVersion = getCurrentVersion();
+      if (currentVersion !== version) {
+        return false;
+      }
+      set(valueOrFn);
+      return true;
+    });
+    const deleteItem = () => {
+      measureOperation("item:delete", config.scope, () => {
+        invalidateParsedCache();
+        if (isMemory) {
+          const oldValue = getEventRawValue(config.scope, storageKey);
+          if (memoryExpiration) {
+            memoryExpiration.delete(storageKey);
+          }
+          memoryStore.delete(storageKey);
+          (0, _shared.notifyKeyListeners)(memoryListeners, storageKey);
+          emitKeyChange(config.scope, storageKey, oldValue, undefined, "remove", "memory");
+          return;
+        }
+        removeStoredRaw();
+      });
+    };
+    const hasItem = () => measureOperation("item:has", config.scope, () => {
+      if (isMemory) return memoryStore.has(storageKey);
+      if (isBiometric) return adapter.backend.hasSecureBiometric(storageKey);
+      if (nonMemoryScope === _Storage.StorageScope.Disk) {
+        const pending = pendingDiskWrites.get(storageKey);
+        if (pending !== undefined) {
+          return pending.value !== undefined;
+        }
+      }
+      if (nonMemoryScope === _Storage.StorageScope.Secure) {
+        const pending = pendingSecureWrites.get(storageKey);
+        if (pending !== undefined) {
+          return pending.value !== undefined;
+        }
+      }
+      return adapter.backend.has(storageKey, config.scope);
+    });
+    const subscribe = callback => {
+      ensureSubscription();
+      listeners.add(callback);
+      return () => {
+        listeners.delete(callback);
+        if (listeners.size === 0 && unsubscribe) {
+          unsubscribe();
+          if (!isMemory) {
+            adapter.maybeCleanupScopeSubscription(nonMemoryScope);
+          }
+          unsubscribe = null;
+        }
+      };
+    };
+    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,
+      set,
+      setIfVersion,
+      delete: deleteItem,
+      has: hasItem,
+      subscribe,
+      subscribeSelector,
+      serialize,
+      deserialize,
+      _triggerListeners: () => {
+        invalidateParsedCache();
+        listeners.forEach(listener => listener());
+      },
+      _invalidateParsedCacheOnly: () => {
+        invalidateParsedCache();
+      },
+      _hasValidation: validate !== undefined,
+      _hasExpiration: expiration !== undefined,
+      _readCacheEnabled: readCache,
+      _isBiometric: isBiometric,
+      _biometricLevel: resolvedBiometricLevel,
+      _defaultValue: defaultValue,
+      ...(secureAccessControl !== undefined ? {
+        _secureAccessControl: secureAccessControl
+      } : {}),
+      scope: config.scope,
+      key: storageKey
+    };
+    return storageItem;
+  }
+  function getBatch(items, scope) {
+    return measureOperation("batch:get", scope, () => {
+      (0, _internal.assertBatchScope)(items, scope);
+      if (scope === _Storage.StorageScope.Memory) {
+        return items.map(item => item.get());
+      }
+      const useRawBatchPath = items.every(item => scope === _Storage.StorageScope.Secure ? (0, _shared.canUseSecureRawBatchPath)(item) : (0, _shared.canUseRawBatchPath)(item));
+      if (!useRawBatchPath) {
+        return items.map(item => item.get());
+      }
+      const rawValues = new Array(items.length);
+      const keysToFetch = [];
+      const keyIndexes = [];
+      items.forEach((item, index) => {
+        if (scope === _Storage.StorageScope.Disk) {
+          const pending = pendingDiskWrites.get(item.key);
+          if (pending !== undefined) {
+            rawValues[index] = pending.value;
+            return;
+          }
+        }
+        if (scope === _Storage.StorageScope.Secure) {
+          const pending = pendingSecureWrites.get(item.key);
+          if (pending !== undefined) {
+            rawValues[index] = pending.value;
+            return;
+          }
+        }
+        if (item._readCacheEnabled === true) {
+          const cache = getScopeRawCache(scope);
+          const cached = cache.get(item.key);
+          if (cached !== undefined || cache.has(item.key)) {
+            rawValues[index] = cached;
+            return;
+          }
+        }
+        keysToFetch.push(item.key);
+        keyIndexes.push(index);
+      });
+      if (keysToFetch.length > 0) {
+        const fetchedValues = adapter.backend.getBatch(keysToFetch, 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);
+        });
+      }
+      return items.map((item, index) => {
+        const raw = rawValues[index];
+        if (raw === undefined) {
+          return asInternal(item)._defaultValue;
+        }
+        return item.deserialize(raw);
+      });
+    }, items.length);
+  }
+  function setBatch(items, scope) {
+    measureOperation("batch:set", scope, () => {
+      (0, _internal.assertBatchScope)(items.map(batchEntry => batchEntry.item), scope);
+      if (scope === _Storage.StorageScope.Memory) {
+        // Determine if any item needs per-item handling (validation or TTL)
+        const needsIndividualSets = items.some(({
+          item
+        }) => {
+          const internal = asInternal(item);
+          return internal._hasValidation || internal._hasExpiration;
+        });
+        if (needsIndividualSets) {
+          // Fall back to individual sets to preserve validation and TTL semantics
+          items.forEach(({
+            item,
+            value
+          }) => item.set(value));
+          return;
+        }
+        const changes = items.map(({
+          item,
+          value
+        }) => (0, _shared.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(({
+          item,
+          value
+        }) => {
+          memoryStore.set(item.key, value);
+          asInternal(item)._invalidateParsedCacheOnly();
+        });
+        items.forEach(({
+          item
+        }) => (0, _shared.notifyKeyListeners)(memoryListeners, item.key));
+        emitBatchChange(scope, "setBatch", "memory", changes);
+        return;
+      }
+      if (scope === _Storage.StorageScope.Secure) {
+        const secureEntries = items.map(({
+          item,
+          value
+        }) => ({
+          item,
+          value,
+          internal: asInternal(item)
+        }));
+        const canUseSecureBatchPath = secureEntries.every(({
+          internal
+        }) => (0, _shared.canUseSecureRawBatchPath)(internal));
+        if (!canUseSecureBatchPath) {
+          items.forEach(({
+            item,
+            value
+          }) => item.set(value));
+          return;
+        }
+        flushSecureWrites();
+        const keys = secureEntries.map(({
+          item
+        }) => item.key);
+        const oldValues = shouldReadPreviousEventValues(scope) ? adapter.backend.getBatch(keys, scope) : [];
+        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) => {
+          adapter.backend.setSecureAccessControl(accessControl);
+          adapter.backend.setBatch(group.keys, group.values, scope);
+          group.keys.forEach((key, index) => cacheRawValue(scope, key, group.values[index]));
+        });
+        emitBatchChange(scope, "setBatch", adapter.changeSource, secureEntries.map(({
+          item,
+          value
+        }, index) => (0, _shared.createKeyChange)(scope, item.key, oldValues[index], item.serialize(value), "setBatch", adapter.changeSource)));
+        return;
+      }
+      flushDiskWrites();
+      const useRawBatchPath = items.every(({
+        item
+      }) => (0, _shared.canUseRawBatchPath)(asInternal(item)));
+      if (!useRawBatchPath) {
+        items.forEach(({
+          item,
+          value
+        }) => item.set(value));
+        return;
+      }
+      const keys = items.map(entry => entry.item.key);
+      const values = items.map(entry => entry.item.serialize(entry.value));
+      const oldValues = shouldReadPreviousEventValues(scope) ? adapter.backend.getBatch(keys, scope) : [];
+      adapter.backend.setBatch(keys, values, scope);
+      keys.forEach((key, index) => cacheRawValue(scope, key, values[index]));
+      emitBatchChange(scope, "setBatch", adapter.changeSource, keys.map((key, index) => (0, _shared.createKeyChange)(scope, key, oldValues[index], values[index], "setBatch", adapter.changeSource)));
+    }, 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 => (0, _shared.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);
+      if (scope === _Storage.StorageScope.Disk) {
+        flushDiskWrites();
+      }
+      if (scope === _Storage.StorageScope.Secure) {
+        flushSecureWrites();
+      }
+      const oldValues = shouldReadPreviousEventValues(scope) ? adapter.backend.getBatch(keys, scope) : [];
+      adapter.backend.removeBatch(keys, scope);
+      keys.forEach(key => cacheRawValue(scope, key, undefined));
+      emitBatchChange(scope, "removeBatch", adapter.changeSource, keys.map((key, index) => (0, _shared.createKeyChange)(scope, key, oldValues[index], undefined, "removeBatch", adapter.changeSource)));
+    }, items.length);
+  }
+  function registerMigration(version, migration) {
+    if (!Number.isInteger(version) || version <= 0) {
+      throw new Error("Migration version must be a positive integer.");
+    }
+    if (registeredMigrations.has(version)) {
+      throw new Error(`Migration version ${version} is already registered.`);
+    }
+    registeredMigrations.set(version, migration);
+  }
+  function migrateToLatest(scope = _Storage.StorageScope.Disk) {
+    return measureOperation("migration:run", scope, () => {
+      (0, _internal.assertValidScope)(scope);
+      const currentVersion = readMigrationVersion(scope);
+      const versions = Array.from(registeredMigrations.keys()).filter(version => version > currentVersion).sort((a, b) => a - b);
+      let appliedVersion = currentVersion;
+      const context = {
+        scope,
+        getRaw: key => getRawValue(key, scope),
+        setRaw: (key, value) => setRawValue(key, value, scope),
+        removeRaw: key => removeRawValue(key, scope)
+      };
+      versions.forEach(version => {
+        const migration = registeredMigrations.get(version);
+        if (!migration) {
+          return;
+        }
+        migration(context);
+        appliedVersion = version;
+      });
+      if (appliedVersion !== currentVersion) {
+        writeMigrationVersion(scope, appliedVersion);
+      }
+      return appliedVersion;
+    });
+  }
+  function runTransaction(scope, transaction) {
+    return measureOperation("transaction:run", scope, () => {
+      (0, _internal.assertValidScope)(scope);
+      if (scope === _Storage.StorageScope.Disk) {
+        flushDiskWrites();
+      }
+      if (scope === _Storage.StorageScope.Secure) {
+        flushSecureWrites();
+      }
+      const NOT_SET = Symbol();
+      const rollback = new Map();
+      const rememberRollback = (key, item) => {
+        if (rollback.has(key)) {
+          return;
+        }
+        if (scope === _Storage.StorageScope.Memory) {
+          rollback.set(key, {
+            kind: "memory",
+            value: memoryStore.has(key) ? memoryStore.get(key) : NOT_SET
+          });
+        } else {
+          const internal = item ? item : undefined;
+          if (scope === _Storage.StorageScope.Secure && internal?._isBiometric === true) {
+            rollback.set(key, {
+              kind: "biometric",
+              value: adapter.backend.getSecureBiometric(key),
+              level: internal._biometricLevel
+            });
+            return;
+          }
+          rollback.set(key, {
+            kind: "raw",
+            value: getRawValue(key, scope),
+            ...(scope === _Storage.StorageScope.Secure && internal?._secureAccessControl !== undefined ? {
+              accessControl: internal._secureAccessControl
+            } : {})
+          });
+        }
+      };
+      const tx = {
+        scope,
+        getRaw: key => getRawValue(key, scope),
+        setRaw: (key, value) => {
+          rememberRollback(key);
+          setRawValue(key, value, scope);
+        },
+        removeRaw: key => {
+          rememberRollback(key);
+          removeRawValue(key, scope);
+        },
+        getItem: item => {
+          (0, _internal.assertBatchScope)([item], scope);
+          return item.get();
+        },
+        setItem: (item, value) => {
+          (0, _internal.assertBatchScope)([item], scope);
+          rememberRollback(item.key, item);
+          item.set(value);
+        },
+        removeItem: item => {
+          (0, _internal.assertBatchScope)([item], scope);
+          rememberRollback(item.key, item);
+          item.delete();
+        }
+      };
+      try {
+        return transaction(tx);
+      } catch (error) {
+        const rollbackEntries = Array.from(rollback.entries()).reverse();
+        if (scope === _Storage.StorageScope.Memory) {
+          rollbackEntries.forEach(([key, record]) => {
+            if (record.value === NOT_SET) {
+              memoryStore.delete(key);
+            } else {
+              memoryStore.set(key, record.value);
+            }
+            (0, _shared.notifyKeyListeners)(memoryListeners, key);
+          });
+        } else {
+          const groupedKeysToSet = new Map();
+          const keysToRemove = [];
+          rollbackEntries.forEach(([key, record]) => {
+            if (record.kind === "biometric") {
+              if (record.value === undefined) {
+                adapter.backend.deleteSecureBiometric(key);
+              } else {
+                adapter.backend.setSecureBiometricWithLevel(key, record.value, record.level);
+              }
+              return;
+            }
+            if (record.kind !== "raw") {
+              return;
+            }
+            if (record.value === undefined) {
+              keysToRemove.push(key);
+            } else {
+              const accessControl = record.accessControl ?? secureDefaultAccessControl;
+              const existingGroup = groupedKeysToSet.get(accessControl);
+              const group = existingGroup ?? {
+                keys: [],
+                values: []
+              };
+              group.keys.push(key);
+              group.values.push(record.value);
+              if (!existingGroup) {
+                groupedKeysToSet.set(accessControl, group);
+              }
+            }
+          });
+          if (scope === _Storage.StorageScope.Disk) {
+            flushDiskWrites();
+          }
+          if (scope === _Storage.StorageScope.Secure) {
+            flushSecureWrites();
+          }
+          groupedKeysToSet.forEach((group, accessControl) => {
+            if (scope === _Storage.StorageScope.Secure) {
+              adapter.backend.setSecureAccessControl(accessControl);
+            }
+            adapter.backend.setBatch(group.keys, group.values, scope);
+            group.keys.forEach((key, index) => cacheRawValue(scope, key, group.values[index]));
+          });
+          if (keysToRemove.length > 0) {
+            adapter.backend.removeBatch(keysToRemove, scope);
+            keysToRemove.forEach(key => cacheRawValue(scope, key, undefined));
+          }
+        }
+        throw error;
+      }
+    });
+  }
+  function createSecureAuthStorage(config, options) {
+    const ns = options?.namespace ?? "auth";
+    const result = {};
+    for (const key of (0, _shared.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.biometricLevel !== undefined ? {
+          biometricLevel: itemConfig.biometricLevel
+        } : {}),
+        ...(itemConfig.accessControl !== undefined ? {
+          accessControl: itemConfig.accessControl
+        } : {}),
+        ...(expirationConfig !== undefined ? {
+          expiration: expirationConfig
+        } : {})
+      });
+    }
+    return result;
+  }
+  return {
+    storage,
+    createStorageItem,
+    getBatch,
+    setBatch,
+    removeBatch,
+    registerMigration,
+    migrateToLatest,
+    runTransaction,
+    createSecureAuthStorage,
+    internals
+  };
+}
+//# sourceMappingURL=storage-core.js.map