@buoy-gg/storage 7.0.40 → 7.0.41

package/lib/commonjs/storage/utils/storageLabels.web.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.storageLabels = void 0;
+const storageLabels = exports.storageLabels = {
+  async: 'Local',
+  asyncFull: 'localStorage',
+  mmkv: 'Session',
+  secure: 'Secure',
+  hasSecure: false
+};

package/lib/module/index.js

@@ -109,4 +109,6 @@ export { requestStorageBrowserRefresh } from "./storage/utils/storageBrowserRefr
 // - addMMKVListener, removeAllMMKVListeners, isMMKVInstanceMonitored
 // - getMonitoredMMKVInstances, getMMKVInstanceCount, getMMKVListenerCount, isMMKVListening
 // - mmkvListener instance
-// - mmkvInstanceRegistry instance
+// - mmkvInstanceRegistry instance
+
+export { startBrowserStorageCapture } from './storage/utils/browserStorageLifecycle';

package/lib/module/preset.js

@@ -20,7 +20,8 @@
 import { StorageIcon } from "@buoy-gg/floating-tools-core";
 import { createToolFactory, defineToolPreset } from "@buoy-gg/shared-ui";
 import { StorageModalWithTabs } from "./storage/components/StorageModalWithTabs";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { setToolRequiredStorageKeys } from "./storage/sync/storageSyncAdapter";
+
 /**
  * Pre-configured AsyncStorage browser tool for FloatingDevTools.
  * Includes:
@@ -29,6 +30,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * - Live storage event monitoring
  * - Required key validation
  */
+import { jsx as _jsx } from "react/jsx-runtime";
 export const storageToolPreset = defineToolPreset({
   id: "storage",
   name: "STORAGE",
@@ -70,7 +72,11 @@ export const storageToolPreset = defineToolPreset({
  * });
  * ```
  */
-export const createStorageTool = createToolFactory(storageToolPreset, options => ({
-  requiredStorageKeys: options.requiredStorageKeys || [],
-  enableSharedModalDimensions: options.enableSharedModalDimensions ?? false
-}));
+export const createStorageTool = createToolFactory(storageToolPreset, options => {
+  // Shared with the sync adapter so the desktop panel checks the same keys.
+  setToolRequiredStorageKeys(options.requiredStorageKeys || []);
+  return {
+    requiredStorageKeys: options.requiredStorageKeys || [],
+    enableSharedModalDimensions: options.enableSharedModalDimensions ?? false
+  };
+});

package/lib/module/storage/components/GameUIStorageBrowser.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import { storageLabels } from "../utils/storageLabels";
 import { useMemo, useCallback, useState, useEffect, useRef } from "react";
 import { StyleSheet, Text, View, TouchableOpacity, ScrollView, Alert } from "react-native";
 import { absoluteFill, useLimit, TIER_LIMITS, monoFont } from "@buoy-gg/shared-ui";
@@ -186,7 +187,7 @@ export function GameUIStorageBrowser({
     isLoading: isLoadingSecure,
     error: secureError,
     refresh: refreshSecure
-  } = useSecureStoreKeys();
+  } = useSecureStoreKeys(requiredStorageKeys);
 
   // Merge storage keys from AsyncStorage, MMKV, and SecureStore
   const allStorageKeys = useMemo(() => {
@@ -752,7 +753,7 @@ export function GameUIStorageBrowser({
           onPress: () => setSelectedMMKVInstance(null),
           testID: "buoy-storage-instance-all",
           accessibilityRole: "button",
-          accessibilityLabel: "All MMKV instances",
+          accessibilityLabel: `All ${storageLabels.mmkv} instances`,
           style: [styles.instanceNavbarButton, selectedMMKVInstance === null && styles.instanceNavbarButtonActive],
           children: [/*#__PURE__*/_jsx(HardDrive, {
             size: 12,

package/lib/module/storage/components/MMKVInstanceSelector.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import { storageLabels } from "../utils/storageLabels";
 /**
  * MMKVInstanceSelector Component
  *
@@ -14,7 +15,7 @@ import { View, Text, StyleSheet, TouchableOpacity, ScrollView, Modal } from 'rea
 import { macOSColors, night, monoFont } from '@buoy-gg/shared-ui';
 import { useMMKVInstances } from '../hooks/useMMKVInstances';
 import { isMMKVAvailable, getMMKVUnavailableMessage } from '../utils/mmkvAvailability';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 /**
  * MMKV Instance Selector Component
  *
@@ -61,9 +62,9 @@ export function MMKVInstanceSelector({
       style: styles.container,
       children: /*#__PURE__*/_jsxs(View, {
         style: styles.unavailableState,
-        children: [/*#__PURE__*/_jsx(Text, {
+        children: [/*#__PURE__*/_jsxs(Text, {
           style: styles.unavailableTitle,
-          children: "MMKV Not Available"
+          children: [storageLabels.mmkv, " Not Available"]
         }), /*#__PURE__*/_jsx(Text, {
           style: styles.unavailableDescription,
           children: getMMKVUnavailableMessage()

package/lib/module/storage/components/StorageActionButtons.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import { storageLabels } from "../utils/storageLabels";
 import { useState, useEffect } from "react";
 import { View, Text, StyleSheet, TouchableOpacity, Alert } from "react-native";
 import { Trash2, CopyButton, SquareDashed, X, ProUpgradeModal, monoFont } from "@buoy-gg/shared-ui";
@@ -31,7 +32,7 @@ export function StorageActionButtons({
       setShowUpgradeModal(true);
       return;
     }
-    Alert.alert("Clear AsyncStorage", "Delete all AsyncStorage keys? This cannot be undone.", [{
+    Alert.alert(`Clear ${storageLabels.asyncFull}`, `Delete all ${storageLabels.asyncFull} keys? This cannot be undone.`, [{
       text: "Cancel",
       style: "cancel"
     }, {
@@ -78,7 +79,7 @@ export function StorageActionButtons({
       setShowUpgradeModal(true);
       return;
     }
-    Alert.alert("Clear All MMKV", `Delete all keys from ${mmkvInstances.length} instances? This cannot be undone.`, [{
+    Alert.alert(`Clear All ${storageLabels.mmkv}`, `Delete all keys from ${mmkvInstances.length} instances? This cannot be undone.`, [{
       text: "Cancel",
       style: "cancel"
     }, {
@@ -169,7 +170,7 @@ export function StorageActionButtons({
     }), !isSelectMode && showClearAsync && /*#__PURE__*/_jsx(TouchableOpacity, {
       onPress: handleClearAsyncStorage,
       testID: "buoy-storage-clear-async",
-      accessibilityLabel: "Clear AsyncStorage",
+      accessibilityLabel: `Clear ${storageLabels.asyncFull}`,
       accessibilityRole: "button",
       style: styles.actionButton,
       children: /*#__PURE__*/_jsx(Trash2, {
@@ -179,7 +180,7 @@ export function StorageActionButtons({
     }), !isSelectMode && showClearAllMMKV && /*#__PURE__*/_jsx(TouchableOpacity, {
       onPress: handleClearAllMMKV,
       testID: "buoy-storage-clear-mmkv-all",
-      accessibilityLabel: "Clear all MMKV instances",
+      accessibilityLabel: `Clear all ${storageLabels.mmkv} instances`,
       accessibilityRole: "button",
       style: styles.actionButton,
       children: /*#__PURE__*/_jsx(Trash2, {
@@ -189,7 +190,7 @@ export function StorageActionButtons({
     }), !isSelectMode && showClearMMKVIndividual && mmkvInstances.length === 1 && /*#__PURE__*/_jsx(TouchableOpacity, {
       onPress: () => handleClearMMKV(mmkvInstances[0].id, mmkvInstances[0].id),
       testID: "buoy-storage-clear-mmkv",
-      accessibilityLabel: "Clear MMKV instance",
+      accessibilityLabel: `Clear ${storageLabels.mmkv} instance`,
       accessibilityRole: "button",
       style: styles.actionButton,
       children: /*#__PURE__*/_jsx(Trash2, {

package/lib/module/storage/components/StorageEventCard.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import { storageLabels } from '../utils/storageLabels';
 /**
  * StorageEventCard
  *
@@ -70,7 +71,7 @@ function getActionColor(action) {
  * Get storage type label for sublabel
  */
 function getStorageTypeSublabel(storageTypes, totalOps) {
-  const types = Array.from(storageTypes).map(t => t === "async" ? "Async" : "MMKV").join("/");
+  const types = Array.from(storageTypes).map(t => t === "async" ? storageLabels.async : storageLabels.mmkv).join("/");
   return `${types} · ${totalOps} op${totalOps !== 1 ? "s" : ""}`;
 }
 export const StorageEventCard = /*#__PURE__*/memo(function StorageEventCard({

package/lib/module/storage/components/StorageEventFilterView.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import { storageLabels } from '../utils/storageLabels';
 import { View, Text, StyleSheet, TouchableOpacity } from "react-native";
 import { Filter, DynamicFilterView, Database, HardDrive, Shield, macOSColors, night } from "@buoy-gg/shared-ui";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
@@ -28,7 +29,7 @@ export function StorageEventFilterView({
       enabled: true,
       title: "HOW EVENT FILTERS WORK",
       description: "Patterns hide matching storage keys from the event list. Storage type toggles control which storage backends are monitored.",
-      examples: ["• react_buoy → hides keys containing react_buoy", "• @temp → hides @temp_user, @temp_data", "• redux → hides redux-persist:root", "• AsyncStorage → show/hide AsyncStorage events", "• MMKV → show/hide MMKV events"],
+      examples: ["• react_buoy → hides keys containing react_buoy", "• @temp → hides @temp_user, @temp_data", "• redux → hides redux-persist:root", `• ${storageLabels.asyncFull}: show or hide captured events`, `• ${storageLabels.mmkv}: show or hide captured events`],
       icon: Filter
     },
     onPatternToggle: onTogglePattern,
@@ -51,7 +52,7 @@ export function StorageEventFilterView({
           onPress: () => onToggleStorageType('async'),
           testID: "buoy-storage-backend-async",
           accessibilityRole: "button",
-          accessibilityLabel: "Toggle AsyncStorage capture",
+          accessibilityLabel: `Toggle ${storageLabels.asyncFull} capture`,
           accessibilityState: {
             selected: enabledStorageTypes.has('async')
           },
@@ -62,7 +63,7 @@ export function StorageEventFilterView({
             style: [styles.storageTypeButtonText, enabledStorageTypes.has('async') && {
               color: macOSColors.semantic.warning
             }],
-            children: "AsyncStorage"
+            children: storageLabels.asyncFull
           })]
         }), /*#__PURE__*/_jsxs(TouchableOpacity, {
           style: [styles.storageTypeButton, enabledStorageTypes.has('mmkv') && styles.storageTypeButtonActive, {
@@ -71,7 +72,7 @@ export function StorageEventFilterView({
           onPress: () => onToggleStorageType('mmkv'),
           testID: "buoy-storage-backend-mmkv",
           accessibilityRole: "button",
-          accessibilityLabel: "Toggle MMKV capture",
+          accessibilityLabel: `Toggle ${storageLabels.mmkv} capture`,
           accessibilityState: {
             selected: enabledStorageTypes.has('mmkv')
           },
@@ -82,9 +83,9 @@ export function StorageEventFilterView({
             style: [styles.storageTypeButtonText, enabledStorageTypes.has('mmkv') && {
               color: macOSColors.semantic.info
             }],
-            children: "MMKV"
+            children: storageLabels.mmkv
           })]
-        }), /*#__PURE__*/_jsxs(TouchableOpacity, {
+        }), storageLabels.hasSecure && /*#__PURE__*/_jsxs(TouchableOpacity, {
           style: [styles.storageTypeButton, enabledStorageTypes.has('secure') && styles.storageTypeButtonActive, {
             borderColor: macOSColors.semantic.success + '40'
           }],

package/lib/module/storage/components/StorageKeyStats.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import { storageLabels } from "../utils/storageLabels";
 import { View, Text, StyleSheet } from "react-native";
 import { AlertCircle, CheckCircle2, XCircle, Eye, Database, Shield } from "@buoy-gg/shared-ui";
 import { night } from "@buoy-gg/shared-ui";
@@ -51,13 +52,13 @@ const variableTypeData = [{
 // Storage type breakdown data
 const storageTypeData = [{
   key: "mmkv",
-  label: "MMKV",
-  description: "High-performance key-value storage",
+  label: storageLabels.mmkv,
+  description: storageLabels.hasSecure ? "Synchronous key-value storage" : "Storage for this browser tab",
   icon: Database
 }, {
   key: "async",
-  label: "AsyncStorage",
-  description: "React Native async storage",
+  label: storageLabels.asyncFull,
+  description: storageLabels.hasSecure ? "React Native async storage" : "Persistent storage for this origin",
   icon: Database
 }, {
   key: "secure",

package/lib/module/storage/components/StorageTypeFilterBar.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import { storageLabels } from '../utils/storageLabels';
 /**
  * "Which backend?" — the pill row shared by the Keys and Events tabs.
  *
@@ -30,11 +31,11 @@ const SEGMENTS = [{
   color: null
 }, {
   id: "async",
-  label: "Async",
+  label: storageLabels.async,
   color: macOSColors.semantic.warning
 }, {
   id: "mmkv",
-  label: "MMKV",
+  label: storageLabels.mmkv,
   color: macOSColors.semantic.info
 }, {
   id: "secure",
@@ -48,7 +49,7 @@ export function StorageTypeFilterBar({
 }) {
   return /*#__PURE__*/_jsx(View, {
     style: styles.row,
-    children: SEGMENTS.map(segment => {
+    children: SEGMENTS.filter(segment => storageLabels.hasSecure || segment.id !== 'secure').map(segment => {
       const isActive = active === segment.id;
       const accent = segment.color ?? night.color.accent;
       return /*#__PURE__*/_jsxs(TouchableOpacity, {

package/lib/module/storage/hooks/useSecureStoreKeys.js

@@ -1,6 +1,7 @@
 "use strict";
 
 import { useState, useEffect, useCallback, useRef } from "react";
+import { requiredKeyAppliesTo } from "../utils/requiredStorageKeyScope";
 import { secureStoreRegistry } from "../utils/SecureStoreRegistry";
 
 /**
@@ -37,10 +38,14 @@ function signature(keys) {
  * Values are re-read on a poll and whenever the registry changes, so the
  * browser tracks writes the app makes while the tool is open.
  */
-export function useSecureStoreKeys(options = {}) {
+export function useSecureStoreKeys(requiredStorageKeys = [], options = {}) {
   const {
     pollMs = DEFAULT_POLL_MS
   } = options;
+  // Read through a ref so a fresh array literal each render doesn't restart the poll.
+  const requiredRef = useRef(requiredStorageKeys);
+  requiredRef.current = requiredStorageKeys;
+  const requiredSignature = JSON.stringify(requiredStorageKeys);
   const [storageKeys, setStorageKeys] = useState([]);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState(null);
@@ -63,7 +68,12 @@ export function useSecureStoreKeys(options = {}) {
     try {
       const module = secureStoreRegistry.getModule();
       const entries = secureStoreRegistry.getAll();
-      if (!module || entries.length === 0) {
+      // Required keys scoped to SecureStore. Registration is what lets the tool
+      // read a key; `requiredStorageKeys` is what says the app needs it. A
+      // registered key with no value that nobody requires is simply absent.
+      const required = requiredRef.current.filter(req => requiredKeyAppliesTo(req, "secure"));
+      const requiredFor = key => required.find(req => (typeof req === "string" ? req : req.key) === key);
+      if (!module || entries.length === 0 && required.length === 0) {
         commit([]);
         hasLoadedRef.current = true;
         setIsLoading(false);
@@ -75,16 +85,36 @@ export function useSecureStoreKeys(options = {}) {
       if (!hasLoadedRef.current) setIsLoading(true);
       setError(null);
       const keys = [];
-      for (const entry of entries) {
+
+      // Required keys that were never registered are still readable by name,
+      // with the default keychain options.
+      const toRead = [...entries, ...required.map(req => typeof req === "string" ? req : req.key).filter(key => !entries.some(e => e.key === key)).map(key => ({
+        key,
+        options: {},
+        description: undefined
+      }))];
+      for (const entry of toRead) {
+        const req = requiredFor(entry.key);
+        const reqObj = typeof req === "object" ? req : undefined;
+        const expectations = {
+          ...(reqObj?.expectedValue !== undefined && {
+            expectedValue: reqObj.expectedValue
+          }),
+          ...(reqObj?.expectedType !== undefined && {
+            expectedType: reqObj.expectedType
+          })
+        };
+        const description = reqObj?.description ?? entry.description;
         if (entry.options.requireAuthentication) {
           // Never auto-read: reading would fire a biometric prompt.
           keys.push({
             key: entry.key,
             value: BIOMETRIC_PLACEHOLDER,
             storageType: "secure",
-            status: "optional_present",
-            category: "optional",
-            description: entry.description ?? "Protected by biometric authentication — value not read by DevTools",
+            status: req ? "required_present" : "optional_present",
+            category: req ? "required" : "optional",
+            description: description ?? "Protected by biometric authentication — value not read by DevTools",
+            ...expectations,
             ...(entry.options.keychainService && {
               instanceId: entry.options.keychainService
             })
@@ -95,8 +125,9 @@ export function useSecureStoreKeys(options = {}) {
         try {
           rawValue = await module.getItemAsync(entry.key, entry.options);
         } catch {
-          // Key unreadable (e.g. keychain state changed) — treat as missing.
+          // Key unreadable (e.g. keychain state changed) — treat as absent.
         }
+        if (rawValue === null && !req) continue;
 
         // Parse JSON values for the DataViewer, same as the AsyncStorage hook.
         let parsedValue = rawValue;
@@ -107,15 +138,26 @@ export function useSecureStoreKeys(options = {}) {
             parsedValue = rawValue;
           }
         }
+        let status = "optional_present";
+        if (req) {
+          if (rawValue === null) status = "required_missing";else if (reqObj?.expectedValue !== undefined) status = String(parsedValue) === String(reqObj.expectedValue) ? "required_present" : "required_wrong_value";else if (reqObj?.expectedType !== undefined) {
+            const actualType = parsedValue === null ? "null" : Array.isArray(parsedValue) ? "array" : typeof parsedValue;
+            // A keychain value is always stored as a string, so a string is
+            // acceptable wherever the parsed form would be.
+            const want = reqObj.expectedType.toLowerCase();
+            status = actualType === want || want === "string" && typeof rawValue === "string" ? "required_present" : "required_wrong_type";
+          } else status = "required_present";
+        }
         keys.push({
           key: entry.key,
           value: rawValue === null ? undefined : parsedValue,
           storageType: "secure",
-          status: rawValue === null ? "required_missing" : "optional_present",
-          category: rawValue === null ? "required" : "optional",
-          ...(entry.description && {
-            description: entry.description
+          status,
+          category: req ? "required" : "optional",
+          ...(description && {
+            description
           }),
+          ...expectations,
           ...(entry.options.keychainService && {
             instanceId: entry.options.keychainService
           })
@@ -130,7 +172,8 @@ export function useSecureStoreKeys(options = {}) {
       inFlightRef.current = false;
       setIsLoading(false);
     }
-  }, [commit]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [commit, requiredSignature]);
 
   // Initial fetch + poll. Registration usually happens at app startup, but the
   // registry is also refilled on the dashboard every time a device syncs, so

package/lib/module/storage/sync/storageSyncAdapter.js

@@ -193,6 +193,16 @@ function assertMMKVWritable(instanceId) {
  * v2: oversized / unserializable event values are replaced with
  * VALUE_ON_DEVICE. Dashboards fetch them via `getEventDetail`.
  */
+let toolRequiredStorageKeys = [];
+
+/**
+ * Called by `createStorageTool` so remote dashboards validate against the
+ * same required keys as the on-device tool. The desktop panel used to have no
+ * way to learn them and showed every key as unchecked.
+ */
+export function setToolRequiredStorageKeys(keys) {
+  toolRequiredStorageKeys = keys;
+}
 export const storageSyncAdapter = {
   // v3: a total snapshot budget, so a burst of individually-legal values
   // degrades the oldest events instead of the emit layer dropping the panel.
@@ -210,6 +220,8 @@ export const storageSyncAdapter = {
     clearEvents: () => {
       storageEventStore.clearEvents();
     },
+    /** The app's required storage keys, as given to `createStorageTool`. */
+    getRequiredKeys: () => toolRequiredStorageKeys,
     /**
      * On-demand detail: one event's real value/prevValue/pairs.
      * The per-snapshot stream stays payload-light; this is the explicit,

package/lib/module/storage/utils/AsyncStorageListener.web.js

@@ -0,0 +1,76 @@
+"use strict";
+
+import { subscribeToBrowserStorage } from '@buoy-gg/shared-ui/utils';
+const listeners = new Set();
+let stop;
+let paused = false;
+const ignoredKeys = new Set(['@react_buoy_storage_event_filters', '@react_buoy_storage_key_filters', '@react_buoy_storage_is_monitoring', 'REACT_QUERY_OFFLINE_CACHE']);
+const ignored = key => [...ignoredKeys].some(prefix => key.startsWith(prefix));
+export async function startListening() {
+  if (stop || typeof window === 'undefined') return;
+  stop = subscribeToBrowserStorage(change => {
+    if (paused || change.area !== 'localStorage' || change.key !== undefined && ignored(change.key)) return;
+    const {
+      area: _,
+      action,
+      ...data
+    } = change;
+    if (data.prevPairs) data.prevPairs = data.prevPairs.filter(([key]) => !ignored(key));
+    const event = {
+      action,
+      data,
+      timestamp: new Date()
+    };
+    for (const listener of [...listeners]) {
+      try {
+        listener(event);
+      } catch {/* Keep observing other consumers. */}
+    }
+  });
+}
+export function stopListening() {
+  stop?.();
+  stop = undefined;
+}
+export function addListener(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+export function removeAllListeners() {
+  listeners.clear();
+}
+export function isListening() {
+  return !!stop;
+}
+export function getListenerCount() {
+  return listeners.size;
+}
+export function pauseCapture() {
+  paused = true;
+}
+export function resumeCapture() {
+  paused = false;
+}
+export function isPaused() {
+  return paused;
+}
+const asyncStorageListener = {
+  startListening,
+  stopListening,
+  addListener,
+  removeAllListeners,
+  pause: pauseCapture,
+  resume: resumeCapture,
+  get isActive() {
+    return isListening();
+  },
+  get listenerCount() {
+    return listeners.size;
+  },
+  get paused() {
+    return paused;
+  }
+};
+export default asyncStorageListener;

package/lib/module/storage/utils/browserStorageLifecycle.js

@@ -0,0 +1,6 @@
+"use strict";
+
+/** Native backends are registered by the host application. */
+export function startBrowserStorageCapture() {
+  return () => {};
+}

package/lib/module/storage/utils/browserStorageLifecycle.web.js

@@ -0,0 +1,66 @@
+"use strict";
+
+import { getBrowserStorage, subscribeToBrowserStorage } from '@buoy-gg/shared-ui/utils';
+import { registerMMKVInstance, unregisterMMKVInstance } from './MMKVInstanceRegistry';
+let owners = 0;
+const storage = () => getBrowserStorage('sessionStorage');
+const keys = () => Array.from({
+  length: storage().length
+}, (_, index) => storage().key(index)).filter(key => key !== null);
+// Reuse the synchronous storage editor and snapshot provider with Web Storage strings.
+const sessionBackend = {
+  set(key, value) {
+    storage().setItem(key, String(value));
+  },
+  getString(key) {
+    return storage().getItem(key) ?? undefined;
+  },
+  getNumber() {
+    return undefined;
+  },
+  getBoolean() {
+    return undefined;
+  },
+  getBuffer() {
+    return undefined;
+  },
+  contains(key) {
+    return storage().getItem(key) !== null;
+  },
+  delete(key) {
+    const found = this.contains(key);
+    storage().removeItem(key);
+    return found;
+  },
+  getAllKeys: keys,
+  clearAll() {
+    storage().clear();
+  },
+  get size() {
+    return keys().reduce((bytes, key) => bytes + 2 * (key.length + (storage().getItem(key)?.length ?? 0)), 0);
+  },
+  addOnValueChangedListener(listener) {
+    return {
+      remove: subscribeToBrowserStorage(change => {
+        if (change.area !== 'sessionStorage') return;
+        if (change.key !== undefined) listener(change.key);else change.prevPairs?.forEach(([key]) => listener(key));
+      })
+    };
+  }
+};
+export function startBrowserStorageCapture() {
+  if (typeof window === 'undefined') return () => {};
+  try {
+    storage();
+  } catch {
+    return () => {};
+  }
+  if (++owners === 1) registerMMKVInstance('sessionStorage', sessionBackend);
+  let active = true;
+  return () => {
+    if (active) {
+      active = false;
+      if (--owners === 0) unregisterMMKVInstance('sessionStorage');
+    }
+  };
+}

package/lib/module/storage/utils/mmkvAvailability.web.js

@@ -0,0 +1,15 @@
+"use strict";
+
+export function isMMKVAvailable() {
+  try {
+    return typeof window !== 'undefined' && !!window.sessionStorage;
+  } catch {
+    return false;
+  }
+}
+export function getMMKVClass() {
+  return null;
+}
+export function getMMKVUnavailableMessage() {
+  return 'Session storage is unavailable in this browser context.';
+}

package/lib/module/storage/utils/storageLabels.js

@@ -0,0 +1,9 @@
+"use strict";
+
+export const storageLabels = {
+  async: 'Async',
+  asyncFull: 'AsyncStorage',
+  mmkv: 'MMKV',
+  secure: 'Secure',
+  hasSecure: true
+};

package/lib/module/storage/utils/storageLabels.web.js

@@ -0,0 +1,9 @@
+"use strict";
+
+export const storageLabels = {
+  async: 'Local',
+  asyncFull: 'localStorage',
+  mmkv: 'Session',
+  secure: 'Secure',
+  hasSecure: false
+};

package/lib/typescript/index.d.ts

@@ -51,4 +51,5 @@ export { storageEventStore, isValueOnDevice, batchPairsOf, } from "./storage/sto
  * @internal
  */
 export { requestStorageBrowserRefresh } from "./storage/utils/storageBrowserRefresh";
+export { startBrowserStorageCapture } from './storage/utils/browserStorageLifecycle';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"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"}