@buoy-gg/storage 7.0.40 → 7.0.41

package/README.md

@@ -100,3 +100,7 @@ Use a Free or Pro Buoy account. History limits and paid features vary by tool; s
 📚 [Full docs](https://buoy.gg/buoy/latest/docs/tools/storage) · [All Buoy tools](https://github.com/Buoy-gg/buoy)
 
 Proprietary software. © Buoy LLC. [Terms](https://buoy.gg/terms)
+
+## Web support (unreleased)
+
+The browser uses localStorage and sessionStorage with the shared editor, event history, undo, and snapshots. Native secure storage is unavailable on web. The browser build is available in this checkout and has not been published yet. See the [web setup guide](https://buoy.gg/buoy/latest/docs/web-preview) for registration, dependencies, and browser boundaries.

package/lib/commonjs/index.js

@@ -207,6 +207,12 @@ Object.defineProperty(exports, "setStorageValue", {
     return _setStorageValue.setStorageValue;
   }
 });
+Object.defineProperty(exports, "startBrowserStorageCapture", {
+  enumerable: true,
+  get: function () {
+    return _browserStorageLifecycle.startBrowserStorageCapture;
+  }
+});
 Object.defineProperty(exports, "storageEditBlockedReason", {
   enumerable: true,
   get: function () {
@@ -343,4 +349,5 @@ var _MMKVInstanceRegistry = require("./storage/utils/MMKVInstanceRegistry");
 var _SecureStoreRegistry = require("./storage/utils/SecureStoreRegistry");
 var _storageSyncAdapter = require("./storage/sync/storageSyncAdapter");
 var _storageEventStore = require("./storage/stores/storageEventStore");
-var _storageBrowserRefresh = require("./storage/utils/storageBrowserRefresh");
+var _storageBrowserRefresh = require("./storage/utils/storageBrowserRefresh");
+var _browserStorageLifecycle = require("./storage/utils/browserStorageLifecycle");

package/lib/commonjs/preset.js

@@ -7,6 +7,7 @@ exports.storageToolPreset = exports.createStorageTool = void 0;
 var _floatingToolsCore = require("@buoy-gg/floating-tools-core");
 var _sharedUi = require("@buoy-gg/shared-ui");
 var _StorageModalWithTabs = require("./storage/components/StorageModalWithTabs");
+var _storageSyncAdapter = require("./storage/sync/storageSyncAdapter");
 var _jsxRuntime = require("react/jsx-runtime");
 /**
  * Pre-configured AsyncStorage browser tool for FloatingDevTools
@@ -74,7 +75,11 @@ const storageToolPreset = exports.storageToolPreset = (0, _sharedUi.defineToolPr
  * });
  * ```
  */
-const createStorageTool = exports.createStorageTool = (0, _sharedUi.createToolFactory)(storageToolPreset, options => ({
-  requiredStorageKeys: options.requiredStorageKeys || [],
-  enableSharedModalDimensions: options.enableSharedModalDimensions ?? false
-}));
+const createStorageTool = exports.createStorageTool = (0, _sharedUi.createToolFactory)(storageToolPreset, options => {
+  // Shared with the sync adapter so the desktop panel checks the same keys.
+  (0, _storageSyncAdapter.setToolRequiredStorageKeys)(options.requiredStorageKeys || []);
+  return {
+    requiredStorageKeys: options.requiredStorageKeys || [],
+    enableSharedModalDimensions: options.enableSharedModalDimensions ?? false
+  };
+});

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

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.FREE_TIER_KEY_LIMIT = void 0;
 exports.GameUIStorageBrowser = GameUIStorageBrowser;
+var _storageLabels = require("../utils/storageLabels");
 var _react = require("react");
 var _reactNative = require("react-native");
 var _sharedUi = require("@buoy-gg/shared-ui");
@@ -188,7 +189,7 @@ function GameUIStorageBrowser({
     isLoading: isLoadingSecure,
     error: secureError,
     refresh: refreshSecure
-  } = (0, _useSecureStoreKeys.useSecureStoreKeys)();
+  } = (0, _useSecureStoreKeys.useSecureStoreKeys)(requiredStorageKeys);
 
   // Merge storage keys from AsyncStorage, MMKV, and SecureStore
   const allStorageKeys = (0, _react.useMemo)(() => {
@@ -754,7 +755,7 @@ function GameUIStorageBrowser({
           onPress: () => setSelectedMMKVInstance(null),
           testID: "buoy-storage-instance-all",
           accessibilityRole: "button",
-          accessibilityLabel: "All MMKV instances",
+          accessibilityLabel: `All ${_storageLabels.storageLabels.mmkv} instances`,
           style: [styles.instanceNavbarButton, selectedMMKVInstance === null && styles.instanceNavbarButtonActive],
           children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.HardDrive, {
             size: 12,

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

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.MMKVInstanceSelector = MMKVInstanceSelector;
+var _storageLabels = require("../utils/storageLabels");
 var _react = require("react");
 var _reactNative = require("react-native");
 var _sharedUi = require("@buoy-gg/shared-ui");
@@ -65,9 +66,9 @@ function MMKVInstanceSelector({
       style: styles.container,
       children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
         style: styles.unavailableState,
-        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.Text, {
           style: styles.unavailableTitle,
-          children: "MMKV Not Available"
+          children: [_storageLabels.storageLabels.mmkv, " Not Available"]
         }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
           style: styles.unavailableDescription,
           children: (0, _mmkvAvailability.getMMKVUnavailableMessage)()

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

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.StorageActionButtons = StorageActionButtons;
+var _storageLabels = require("../utils/storageLabels");
 var _react = require("react");
 var _reactNative = require("react-native");
 var _sharedUi = require("@buoy-gg/shared-ui");
@@ -35,7 +36,7 @@ function StorageActionButtons({
       setShowUpgradeModal(true);
       return;
     }
-    _reactNative.Alert.alert("Clear AsyncStorage", "Delete all AsyncStorage keys? This cannot be undone.", [{
+    _reactNative.Alert.alert(`Clear ${_storageLabels.storageLabels.asyncFull}`, `Delete all ${_storageLabels.storageLabels.asyncFull} keys? This cannot be undone.`, [{
       text: "Cancel",
       style: "cancel"
     }, {
@@ -82,7 +83,7 @@ function StorageActionButtons({
       setShowUpgradeModal(true);
       return;
     }
-    _reactNative.Alert.alert("Clear All MMKV", `Delete all keys from ${mmkvInstances.length} instances? This cannot be undone.`, [{
+    _reactNative.Alert.alert(`Clear All ${_storageLabels.storageLabels.mmkv}`, `Delete all keys from ${mmkvInstances.length} instances? This cannot be undone.`, [{
       text: "Cancel",
       style: "cancel"
     }, {
@@ -173,7 +174,7 @@ function StorageActionButtons({
     }), !isSelectMode && showClearAsync && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
       onPress: handleClearAsyncStorage,
       testID: "buoy-storage-clear-async",
-      accessibilityLabel: "Clear AsyncStorage",
+      accessibilityLabel: `Clear ${_storageLabels.storageLabels.asyncFull}`,
       accessibilityRole: "button",
       style: styles.actionButton,
       children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Trash2, {
@@ -183,7 +184,7 @@ function StorageActionButtons({
     }), !isSelectMode && showClearAllMMKV && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
       onPress: handleClearAllMMKV,
       testID: "buoy-storage-clear-mmkv-all",
-      accessibilityLabel: "Clear all MMKV instances",
+      accessibilityLabel: `Clear all ${_storageLabels.storageLabels.mmkv} instances`,
       accessibilityRole: "button",
       style: styles.actionButton,
       children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Trash2, {
@@ -193,7 +194,7 @@ function StorageActionButtons({
     }), !isSelectMode && showClearMMKVIndividual && mmkvInstances.length === 1 && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
       onPress: () => handleClearMMKV(mmkvInstances[0].id, mmkvInstances[0].id),
       testID: "buoy-storage-clear-mmkv",
-      accessibilityLabel: "Clear MMKV instance",
+      accessibilityLabel: `Clear ${_storageLabels.storageLabels.mmkv} instance`,
       accessibilityRole: "button",
       style: styles.actionButton,
       children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Trash2, {

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

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.StorageEventCard = void 0;
 exports.getValueType = getValueType;
+var _storageLabels = require("../utils/storageLabels");
 var _react = require("react");
 var _sharedUi = require("@buoy-gg/shared-ui");
 var _storageActionHelpers = require("../utils/storageActionHelpers");
@@ -75,7 +76,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.storageLabels.async : _storageLabels.storageLabels.mmkv).join("/");
   return `${types} · ${totalOps} op${totalOps !== 1 ? "s" : ""}`;
 }
 const StorageEventCard = exports.StorageEventCard = /*#__PURE__*/(0, _react.memo)(function StorageEventCard({

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

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.StorageEventFilterView = StorageEventFilterView;
+var _storageLabels = require("../utils/storageLabels");
 var _reactNative = require("react-native");
 var _sharedUi = require("@buoy-gg/shared-ui");
 var _jsxRuntime = require("react/jsx-runtime");
@@ -32,7 +33,7 @@ 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.storageLabels.asyncFull}: show or hide captured events`, `• ${_storageLabels.storageLabels.mmkv}: show or hide captured events`],
       icon: _sharedUi.Filter
     },
     onPatternToggle: onTogglePattern,
@@ -55,7 +56,7 @@ function StorageEventFilterView({
           onPress: () => onToggleStorageType('async'),
           testID: "buoy-storage-backend-async",
           accessibilityRole: "button",
-          accessibilityLabel: "Toggle AsyncStorage capture",
+          accessibilityLabel: `Toggle ${_storageLabels.storageLabels.asyncFull} capture`,
           accessibilityState: {
             selected: enabledStorageTypes.has('async')
           },
@@ -66,7 +67,7 @@ function StorageEventFilterView({
             style: [styles.storageTypeButtonText, enabledStorageTypes.has('async') && {
               color: _sharedUi.macOSColors.semantic.warning
             }],
-            children: "AsyncStorage"
+            children: _storageLabels.storageLabels.asyncFull
           })]
         }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.TouchableOpacity, {
           style: [styles.storageTypeButton, enabledStorageTypes.has('mmkv') && styles.storageTypeButtonActive, {
@@ -75,7 +76,7 @@ function StorageEventFilterView({
           onPress: () => onToggleStorageType('mmkv'),
           testID: "buoy-storage-backend-mmkv",
           accessibilityRole: "button",
-          accessibilityLabel: "Toggle MMKV capture",
+          accessibilityLabel: `Toggle ${_storageLabels.storageLabels.mmkv} capture`,
           accessibilityState: {
             selected: enabledStorageTypes.has('mmkv')
           },
@@ -86,9 +87,9 @@ function StorageEventFilterView({
             style: [styles.storageTypeButtonText, enabledStorageTypes.has('mmkv') && {
               color: _sharedUi.macOSColors.semantic.info
             }],
-            children: "MMKV"
+            children: _storageLabels.storageLabels.mmkv
           })]
-        }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.TouchableOpacity, {
+        }), _storageLabels.storageLabels.hasSecure && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.TouchableOpacity, {
           style: [styles.storageTypeButton, enabledStorageTypes.has('secure') && styles.storageTypeButtonActive, {
             borderColor: _sharedUi.macOSColors.semantic.success + '40'
           }],

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

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.StorageKeyStatsSection = StorageKeyStatsSection;
+var _storageLabels = require("../utils/storageLabels");
 var _reactNative = require("react-native");
 var _sharedUi = require("@buoy-gg/shared-ui");
 var _storageQueryUtils = require("../utils/storageQueryUtils");
@@ -54,13 +55,13 @@ const variableTypeData = [{
 // Storage type breakdown data
 const storageTypeData = [{
   key: "mmkv",
-  label: "MMKV",
-  description: "High-performance key-value storage",
+  label: _storageLabels.storageLabels.mmkv,
+  description: _storageLabels.storageLabels.hasSecure ? "Synchronous key-value storage" : "Storage for this browser tab",
   icon: _sharedUi.Database
 }, {
   key: "async",
-  label: "AsyncStorage",
-  description: "React Native async storage",
+  label: _storageLabels.storageLabels.asyncFull,
+  description: _storageLabels.storageLabels.hasSecure ? "React Native async storage" : "Persistent storage for this origin",
   icon: _sharedUi.Database
 }, {
   key: "secure",

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

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.StorageTypeFilterBar = StorageTypeFilterBar;
 exports.countByStorageType = countByStorageType;
+var _storageLabels = require("../utils/storageLabels");
 var _reactNative = require("react-native");
 var _sharedUi = require("@buoy-gg/shared-ui");
 var _jsxRuntime = require("react/jsx-runtime");
@@ -35,11 +36,11 @@ const SEGMENTS = [{
   color: null
 }, {
   id: "async",
-  label: "Async",
+  label: _storageLabels.storageLabels.async,
   color: _sharedUi.macOSColors.semantic.warning
 }, {
   id: "mmkv",
-  label: "MMKV",
+  label: _storageLabels.storageLabels.mmkv,
   color: _sharedUi.macOSColors.semantic.info
 }, {
   id: "secure",
@@ -53,7 +54,7 @@ function StorageTypeFilterBar({
 }) {
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
     style: styles.row,
-    children: SEGMENTS.map(segment => {
+    children: SEGMENTS.filter(segment => _storageLabels.storageLabels.hasSecure || segment.id !== 'secure').map(segment => {
       const isActive = active === segment.id;
       const accent = segment.color ?? _sharedUi.night.color.accent;
       return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.TouchableOpacity, {

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

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.useSecureStoreKeys = useSecureStoreKeys;
 var _react = require("react");
+var _requiredStorageKeyScope = require("../utils/requiredStorageKeyScope");
 var _SecureStoreRegistry = require("../utils/SecureStoreRegistry");
 /**
  * Placeholder value shown for `requireAuthentication` keys. Reading those
@@ -40,10 +41,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.
  */
-function useSecureStoreKeys(options = {}) {
+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 = (0, _react.useRef)(requiredStorageKeys);
+  requiredRef.current = requiredStorageKeys;
+  const requiredSignature = JSON.stringify(requiredStorageKeys);
   const [storageKeys, setStorageKeys] = (0, _react.useState)([]);
   const [isLoading, setIsLoading] = (0, _react.useState)(true);
   const [error, setError] = (0, _react.useState)(null);
@@ -66,7 +71,12 @@ function useSecureStoreKeys(options = {}) {
     try {
       const module = _SecureStoreRegistry.secureStoreRegistry.getModule();
       const entries = _SecureStoreRegistry.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 => (0, _requiredStorageKeyScope.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);
@@ -78,16 +88,36 @@ 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
             })
@@ -98,8 +128,9 @@ 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;
@@ -110,15 +141,26 @@ 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
           })
@@ -133,7 +175,8 @@ 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/commonjs/storage/sync/storageSyncAdapter.js

@@ -3,7 +3,9 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.storageSyncAdapter = exports.VALUE_ON_DEVICE = exports.SNAPSHOT_VALUE_INLINE_LIMIT = exports.SNAPSHOT_EVENTS_BUDGET = void 0;
+exports.VALUE_ON_DEVICE = exports.SNAPSHOT_VALUE_INLINE_LIMIT = exports.SNAPSHOT_EVENTS_BUDGET = void 0;
+exports.setToolRequiredStorageKeys = setToolRequiredStorageKeys;
+exports.storageSyncAdapter = void 0;
 var _asyncStorage = _interopRequireDefault(require("@react-native-async-storage/async-storage"));
 var _sharedUi = require("@buoy-gg/shared-ui");
 var _asyncStorageCompat = require("../utils/asyncStorageCompat");
@@ -197,6 +199,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.
+ */
+function setToolRequiredStorageKeys(keys) {
+  toolRequiredStorageKeys = keys;
+}
 const storageSyncAdapter = exports.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.
@@ -214,6 +226,8 @@ const storageSyncAdapter = exports.storageSyncAdapter = {
     clearEvents: () => {
       _storageEventStore.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/commonjs/storage/utils/AsyncStorageListener.web.js

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.addListener = addListener;
+exports.default = void 0;
+exports.getListenerCount = getListenerCount;
+exports.isListening = isListening;
+exports.isPaused = isPaused;
+exports.pauseCapture = pauseCapture;
+exports.removeAllListeners = removeAllListeners;
+exports.resumeCapture = resumeCapture;
+exports.startListening = startListening;
+exports.stopListening = stopListening;
+var _utils = require("@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));
+async function startListening() {
+  if (stop || typeof window === 'undefined') return;
+  stop = (0, _utils.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. */}
+    }
+  });
+}
+function stopListening() {
+  stop?.();
+  stop = undefined;
+}
+function addListener(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+function removeAllListeners() {
+  listeners.clear();
+}
+function isListening() {
+  return !!stop;
+}
+function getListenerCount() {
+  return listeners.size;
+}
+function pauseCapture() {
+  paused = true;
+}
+function resumeCapture() {
+  paused = false;
+}
+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;
+  }
+};
+var _default = exports.default = asyncStorageListener;

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

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.startBrowserStorageCapture = startBrowserStorageCapture;
+/** Native backends are registered by the host application. */
+function startBrowserStorageCapture() {
+  return () => {};
+}

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

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.startBrowserStorageCapture = startBrowserStorageCapture;
+var _utils = require("@buoy-gg/shared-ui/utils");
+var _MMKVInstanceRegistry = require("./MMKVInstanceRegistry");
+let owners = 0;
+const storage = () => (0, _utils.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: (0, _utils.subscribeToBrowserStorage)(change => {
+        if (change.area !== 'sessionStorage') return;
+        if (change.key !== undefined) listener(change.key);else change.prevPairs?.forEach(([key]) => listener(key));
+      })
+    };
+  }
+};
+function startBrowserStorageCapture() {
+  if (typeof window === 'undefined') return () => {};
+  try {
+    storage();
+  } catch {
+    return () => {};
+  }
+  if (++owners === 1) (0, _MMKVInstanceRegistry.registerMMKVInstance)('sessionStorage', sessionBackend);
+  let active = true;
+  return () => {
+    if (active) {
+      active = false;
+      if (--owners === 0) (0, _MMKVInstanceRegistry.unregisterMMKVInstance)('sessionStorage');
+    }
+  };
+}

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

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

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

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