@buoy-gg/storage 3.0.1 → 3.0.2

package/lib/commonjs/index.js

@@ -153,6 +153,12 @@ Object.defineProperty(exports, "storageEventStore", {
     return _storageEventStore.storageEventStore;
   }
 });
+Object.defineProperty(exports, "storageSyncAdapter", {
+  enumerable: true,
+  get: function () {
+    return _storageSyncAdapter.storageSyncAdapter;
+  }
+});
 Object.defineProperty(exports, "storageToolPreset", {
   enumerable: true,
   get: function () {
@@ -234,4 +240,5 @@ var _mmkvAvailability = require("./storage/utils/mmkvAvailability");
 var _mmkvTypeDetection = require("./storage/utils/mmkvTypeDetection");
 var _storageTimeTravelUtils = require("./storage/utils/storageTimeTravelUtils");
 var _MMKVInstanceRegistry = require("./storage/utils/MMKVInstanceRegistry");
+var _storageSyncAdapter = require("./storage/sync/storageSyncAdapter");
 var _storageEventStore = require("./storage/stores/storageEventStore");

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

@@ -684,7 +684,7 @@ const styles = _reactNative.StyleSheet.create({
     paddingBottom: 32
   },
   backgroundGrid: {
-    ..._reactNative.StyleSheet.absoluteFillObject,
+    ..._sharedUi.absoluteFill,
     opacity: 0.006,
     backgroundColor: _sharedUi.gameUIColors.info
   },

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

@@ -517,7 +517,7 @@ const styles = _reactNative.StyleSheet.create({
     shadowRadius: 8
   },
   healthGridOverlay: {
-    ..._reactNative.StyleSheet.absoluteFillObject,
+    ..._sharedUi.absoluteFill,
     opacity: 0.1,
     borderWidth: 1,
     borderColor: "rgba(255, 255, 255, 0.1)",
@@ -540,7 +540,7 @@ const styles = _reactNative.StyleSheet.create({
     backgroundColor: "rgba(255, 0, 0, 0.02)"
   },
   cardGlow: {
-    ..._reactNative.StyleSheet.absoluteFillObject,
+    ..._sharedUi.absoluteFill,
     opacity: 0.3
   },
   cardHeader: {

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

@@ -241,7 +241,7 @@ function StorageEventDetailContent({
           children: "CURRENT VALUE"
         }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
           style: styles.valueHeaderBadges,
-          children: [action && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+          children: [action ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
             style: [styles.actionBadge, {
               backgroundColor: `${actionColor}20`
             }],
@@ -251,7 +251,7 @@ function StorageEventDetailContent({
               }],
               children: (0, _storageActionHelpers.translateStorageAction)(action)
             })
-          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+          }) : null, /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
             style: styles.typeBadge,
             children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
               style: styles.typeText,

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

@@ -150,10 +150,10 @@ function StorageKeyCard({
           children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
             style: styles.storageKeyText,
             children: storageKey.key
-          }), storageKey.description && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          }), storageKey.description ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
             style: styles.descriptionText,
             children: storageKey.description
-          }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+          }) : null, /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
             style: styles.cardHeaderMeta,
             children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
               style: [styles.statusBadge, {
@@ -282,13 +282,13 @@ function StorageKeyCard({
           style: styles.typeHelperText,
           children: ["Current type: ", (0, _valueType.getValueTypeLabel)(storageKey.value)]
         })]
-      }), storageKey.lastUpdated && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      }), storageKey.lastUpdated ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
         style: styles.metaInfo,
         children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.Text, {
           style: styles.metaLabel,
-          children: ["Last updated123: ", storageKey.lastUpdated.toLocaleString()]
+          children: ["Last updated: ", storageKey.lastUpdated.toLocaleString()]
         })
-      })]
+      }) : null]
     }), isExpanded && !hasValue && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
       style: styles.cardBody,
       children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {

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

@@ -189,7 +189,7 @@ function StorageKeyRow({
         style: styles.expandedExpected,
         children: String(storageKey.expectedValue)
       })]
-    }), storageKey.description && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    }), storageKey.description ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
       style: styles.expandedRow,
       children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
         style: styles.expandedLabel,
@@ -198,7 +198,7 @@ function StorageKeyRow({
         style: styles.expandedDescription,
         children: storageKey.description
       })]
-    })]
+    }) : null]
   });
 
   // Handle checkbox press in select mode

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

@@ -60,14 +60,14 @@ function StorageKeySection({
   if (keys.length === 0) return null;
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
     style: styles.sectionContainer,
-    children: [title && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_sharedUi.SectionHeader, {
+    children: [title ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_sharedUi.SectionHeader, {
       children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.SectionHeader.Title, {
         children: title
       }), count >= 0 && /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.SectionHeader.Badge, {
         count: count,
         color: headerColor
       })]
-    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+    }) : null, /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
       style: styles.sectionContent,
       children: keys.map(storageKey => {
         // Create unique key by combining storage type, instance ID (if present), and key name

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

@@ -13,8 +13,18 @@ function useAsyncStorageKeys(requiredStorageKeys = []) {
   const [isLoading, setIsLoading] = (0, _react.useState)(true);
   const [error, setError] = (0, _react.useState)(null);
 
+  // Callers routinely pass a fresh array literal (or rely on the `= []`
+  // default, which is a new array every render). Depending on its identity
+  // would recreate `fetchStorageData` each render, re-fire the effect, and
+  // loop AsyncStorage.getAllKeys/multiGet forever. Depend on a stable content
+  // signature instead, and read the latest array via a ref inside the fetch.
+  const requiredSignature = JSON.stringify(requiredStorageKeys);
+  const requiredRef = (0, _react.useRef)(requiredStorageKeys);
+  requiredRef.current = requiredStorageKeys;
+
   // Fetch all keys and values from AsyncStorage
   const fetchStorageData = (0, _react.useCallback)(async () => {
+    const requiredStorageKeys = requiredRef.current;
     setIsLoading(true);
     setError(null);
     try {
@@ -111,7 +121,8 @@ function useAsyncStorageKeys(requiredStorageKeys = []) {
     } finally {
       setIsLoading(false);
     }
-  }, [requiredStorageKeys]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [requiredSignature]);
 
   // Initial fetch
   (0, _react.useEffect)(() => {

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

@@ -76,8 +76,16 @@ function useMMKVKeys(instance, instanceId, requiredStorageKeys = []) {
   const [isLoading, setIsLoading] = (0, _react.useState)(true);
   const [error, setError] = (0, _react.useState)(null);
 
+  // Depend on a stable content signature rather than the array identity — a
+  // fresh `requiredStorageKeys` literal each render would otherwise loop the
+  // fetch effect. Read the latest array via ref inside the fetch.
+  const requiredSignature = JSON.stringify(requiredStorageKeys);
+  const requiredRef = (0, _react.useRef)(requiredStorageKeys);
+  requiredRef.current = requiredStorageKeys;
+
   // Fetch all keys and values from MMKV instance
   const fetchStorageData = (0, _react.useCallback)(() => {
+    const requiredStorageKeys = requiredRef.current;
     setIsLoading(true);
     setError(null);
     try {
@@ -209,7 +217,8 @@ function useMMKVKeys(instance, instanceId, requiredStorageKeys = []) {
     } finally {
       setIsLoading(false);
     }
-  }, [instance, instanceId, requiredStorageKeys]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [instance, instanceId, requiredSignature]);
 
   // Initial fetch
   (0, _react.useEffect)(() => {
@@ -255,7 +264,15 @@ function useMultiMMKVKeys(instances, requiredStorageKeys = []) {
   const [storageKeys, setStorageKeys] = (0, _react.useState)([]);
   const [isLoading, setIsLoading] = (0, _react.useState)(true);
   const [error, setError] = (0, _react.useState)(null);
+
+  // Depend on a stable content signature rather than the array identity — a
+  // fresh `requiredStorageKeys` literal each render would otherwise loop the
+  // fetch effect. Read the latest array via ref inside the fetch.
+  const requiredSignature = JSON.stringify(requiredStorageKeys);
+  const requiredRef = (0, _react.useRef)(requiredStorageKeys);
+  requiredRef.current = requiredStorageKeys;
   const fetchStorageData = (0, _react.useCallback)(() => {
+    const requiredStorageKeys = requiredRef.current;
     setIsLoading(true);
     setError(null);
     try {
@@ -349,7 +366,8 @@ function useMultiMMKVKeys(instances, requiredStorageKeys = []) {
     } finally {
       setIsLoading(false);
     }
-  }, [instances, requiredStorageKeys]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [instances, requiredSignature]);
   (0, _react.useEffect)(() => {
     fetchStorageData();
   }, [fetchStorageData]);

package/lib/commonjs/storage/stores/storageEventStore.js

@@ -7,6 +7,8 @@ exports.subscribeToStorageEvents = exports.storageEventStore = exports.onStorage
 var _sharedUi = require("@buoy-gg/shared-ui");
 var _AsyncStorageListener = require("../utils/AsyncStorageListener");
 var _MMKVListener = require("../utils/MMKVListener");
+var _MMKVInstanceRegistry = require("../utils/MMKVInstanceRegistry");
+var _mmkvTypeDetection = require("../utils/mmkvTypeDetection");
 /**
  * Storage Event Store
  *
@@ -53,6 +55,7 @@ class StorageEventStore extends _sharedUi.BaseEventStore {
   // Unsubscribe functions for raw listeners
   asyncStorageUnsubscribe = null;
   mmkvUnsubscribe = null;
+  hasScannedInitialState = false;
   constructor() {
     super({
       storeName: "storage",
@@ -60,6 +63,81 @@ class StorageEventStore extends _sharedUi.BaseEventStore {
     });
   }
 
+  /**
+   * Scan all registered MMKV instances and AsyncStorage for existing keys,
+   * creating synthetic events so that getEvents() includes the current state
+   * (not just changes made after capture started). Only runs once per store
+   * lifetime to avoid duplicates.
+   */
+  async scanExistingState() {
+    if (this.hasScannedInitialState) return;
+    this.hasScannedInitialState = true;
+    const now = new Date();
+
+    // ── MMKV: synchronous scan ──
+    const instances = _MMKVInstanceRegistry.mmkvInstanceRegistry.getAll();
+    for (const {
+      id: instanceId,
+      instance
+    } of instances) {
+      try {
+        const keys = instance.getAllKeys();
+        for (const key of keys) {
+          const {
+            value,
+            type: valueType
+          } = (0, _mmkvTypeDetection.detectMMKVType)(instance, key);
+          const actionMap = {
+            string: "set.string",
+            number: "set.number",
+            boolean: "set.boolean",
+            buffer: "set.buffer"
+          };
+          const action = actionMap[valueType] ?? "set.string";
+          this.addEvent({
+            action,
+            timestamp: now,
+            instanceId,
+            data: {
+              key,
+              value,
+              valueType
+            },
+            storageType: "mmkv",
+            id: nextStorageEventId()
+          });
+        }
+      } catch {
+        // Instance may not be accessible — skip silently
+      }
+    }
+
+    // ── AsyncStorage: async scan ──
+    try {
+      const AsyncStorage = require("@react-native-async-storage/async-storage").default;
+      if (AsyncStorage) {
+        const allKeys = await AsyncStorage.getAllKeys();
+        if (allKeys.length > 0) {
+          const pairs = await AsyncStorage.multiGet(allKeys);
+          for (const [key, rawValue] of pairs) {
+            this.addEvent({
+              action: "setItem",
+              timestamp: now,
+              data: {
+                key,
+                value: rawValue ?? undefined
+              },
+              storageType: "async",
+              id: nextStorageEventId()
+            });
+          }
+        }
+      }
+    } catch {
+      // AsyncStorage not available — skip silently
+    }
+  }
+
   /**
    * Start capturing storage events from both AsyncStorage and MMKV
    */
@@ -92,6 +170,9 @@ class StorageEventStore extends _sharedUi.BaseEventStore {
         this.addEvent(storageEvent);
       });
     }
+
+    // Scan existing keys so getEvents() includes pre-existing state
+    await this.scanExistingState();
   }
 
   /**

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

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.storageSyncAdapter = void 0;
+var _asyncStorage = _interopRequireDefault(require("@react-native-async-storage/async-storage"));
+var _storageEventStore = require("../stores/storageEventStore");
+var _clearAllStorage = require("../utils/clearAllStorage");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * Sync adapter for the storage tool, consumed by @buoy-gg/external-sync's
+ * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
+ * this package doesn't need a dependency on it).
+ *
+ * Subscribing starts the underlying capture lifecycle (including the initial
+ * key scan), so storage events are only recorded while a dashboard is
+ * watching.
+ *
+ * The `async.*` actions mirror the AsyncStorage API so the desktop dashboard
+ * can proxy its browse/edit mode against the device's real storage.
+ */
+const storageSyncAdapter = exports.storageSyncAdapter = {
+  version: 1,
+  getSnapshot: () => _storageEventStore.storageEventStore.getEvents(),
+  subscribe: onChange => _storageEventStore.storageEventStore.subscribeToEvents(onChange),
+  actions: {
+    clearEvents: () => {
+      _storageEventStore.storageEventStore.clearEvents();
+    },
+    /** Clears all app storage keys, preserving dev tools settings. */
+    clearAppStorage: () => (0, _clearAllStorage.clearAllAppStorage)(),
+    // ── Remote AsyncStorage proxy (desktop browse/edit mode) ──
+    "async.getAllKeys": () => _asyncStorage.default.getAllKeys(),
+    "async.multiGet": params => _asyncStorage.default.multiGet(params.keys),
+    "async.getItem": params => _asyncStorage.default.getItem(params.key),
+    "async.setItem": params => {
+      const {
+        key,
+        value
+      } = params;
+      return _asyncStorage.default.setItem(key, value);
+    },
+    "async.removeItem": params => _asyncStorage.default.removeItem(params.key),
+    "async.multiRemove": params => _asyncStorage.default.multiRemove(params.keys),
+    "async.multiSet": params => _asyncStorage.default.multiSet(params.pairs),
+    "async.clear": () => _asyncStorage.default.clear()
+  }
+};

package/lib/module/index.js

@@ -55,6 +55,11 @@ export { undoOperation, jumpToState, canUndo } from "./storage/utils/storageTime
 // =============================================================================
 export { registerMMKVInstance, unregisterMMKVInstance } from "./storage/utils/MMKVInstanceRegistry";
 
+// =============================================================================
+// EXTERNAL SYNC (Adapter for @buoy-gg/external-sync's useExternalSync)
+// =============================================================================
+export { storageSyncAdapter } from "./storage/sync/storageSyncAdapter";
+
 // =============================================================================
 // INTERNAL EXPORTS (For @buoy-gg/* packages only - not part of public API)
 // =============================================================================

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

@@ -2,6 +2,7 @@
 
 import { useMemo, useCallback, useState, useEffect } from "react";
 import { StyleSheet, Text, View, TouchableOpacity, ScrollView } from "react-native";
+import { absoluteFill } from "@buoy-gg/shared-ui";
 import { Database, Zap, ProBadge, ProUpgradeModal } from "@buoy-gg/shared-ui";
 import { isDevToolsStorageKey } from "@buoy-gg/shared-ui";
 import { StorageKeySection } from "./StorageKeySection";
@@ -682,7 +683,7 @@ const styles = StyleSheet.create({
     paddingBottom: 32
   },
   backgroundGrid: {
-    ...StyleSheet.absoluteFillObject,
+    ...absoluteFill,
     opacity: 0.006,
     backgroundColor: gameUIColors.info
   },

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

@@ -2,6 +2,7 @@
 
 import { useEffect, useRef } from "react";
 import { StyleSheet, View, Text, Animated } from "react-native";
+import { absoluteFill } from "@buoy-gg/shared-ui";
 import { Database, Shield, AlertCircle, CheckCircle2, XCircle, Eye, Zap, gameUIColors, macOSColors } from "@buoy-gg/shared-ui";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // Use macOS colors
@@ -513,7 +514,7 @@ const styles = StyleSheet.create({
     shadowRadius: 8
   },
   healthGridOverlay: {
-    ...StyleSheet.absoluteFillObject,
+    ...absoluteFill,
     opacity: 0.1,
     borderWidth: 1,
     borderColor: "rgba(255, 255, 255, 0.1)",
@@ -536,7 +537,7 @@ const styles = StyleSheet.create({
     backgroundColor: "rgba(255, 0, 0, 0.02)"
   },
   cardGlow: {
-    ...StyleSheet.absoluteFillObject,
+    ...absoluteFill,
     opacity: 0.3
   },
   cardHeader: {

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

@@ -235,7 +235,7 @@ export function StorageEventDetailContent({
           children: "CURRENT VALUE"
         }), /*#__PURE__*/_jsxs(View, {
           style: styles.valueHeaderBadges,
-          children: [action && /*#__PURE__*/_jsx(View, {
+          children: [action ? /*#__PURE__*/_jsx(View, {
             style: [styles.actionBadge, {
               backgroundColor: `${actionColor}20`
             }],
@@ -245,7 +245,7 @@ export function StorageEventDetailContent({
               }],
               children: translateStorageAction(action)
             })
-          }), /*#__PURE__*/_jsx(View, {
+          }) : null, /*#__PURE__*/_jsx(View, {
             style: styles.typeBadge,
             children: /*#__PURE__*/_jsx(Text, {
               style: styles.typeText,

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

@@ -147,10 +147,10 @@ export function StorageKeyCard({
           children: [/*#__PURE__*/_jsx(Text, {
             style: styles.storageKeyText,
             children: storageKey.key
-          }), storageKey.description && /*#__PURE__*/_jsx(Text, {
+          }), storageKey.description ? /*#__PURE__*/_jsx(Text, {
             style: styles.descriptionText,
             children: storageKey.description
-          }), /*#__PURE__*/_jsxs(View, {
+          }) : null, /*#__PURE__*/_jsxs(View, {
             style: styles.cardHeaderMeta,
             children: [/*#__PURE__*/_jsx(View, {
               style: [styles.statusBadge, {
@@ -279,13 +279,13 @@ export function StorageKeyCard({
           style: styles.typeHelperText,
           children: ["Current type: ", getValueTypeLabel(storageKey.value)]
         })]
-      }), storageKey.lastUpdated && /*#__PURE__*/_jsx(View, {
+      }), storageKey.lastUpdated ? /*#__PURE__*/_jsx(View, {
         style: styles.metaInfo,
         children: /*#__PURE__*/_jsxs(Text, {
           style: styles.metaLabel,
-          children: ["Last updated123: ", storageKey.lastUpdated.toLocaleString()]
+          children: ["Last updated: ", storageKey.lastUpdated.toLocaleString()]
         })
-      })]
+      }) : null]
     }), isExpanded && !hasValue && /*#__PURE__*/_jsxs(View, {
       style: styles.cardBody,
       children: [/*#__PURE__*/_jsxs(View, {

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

@@ -186,7 +186,7 @@ export function StorageKeyRow({
         style: styles.expandedExpected,
         children: String(storageKey.expectedValue)
       })]
-    }), storageKey.description && /*#__PURE__*/_jsxs(View, {
+    }), storageKey.description ? /*#__PURE__*/_jsxs(View, {
       style: styles.expandedRow,
       children: [/*#__PURE__*/_jsx(Text, {
         style: styles.expandedLabel,
@@ -195,7 +195,7 @@ export function StorageKeyRow({
         style: styles.expandedDescription,
         children: storageKey.description
       })]
-    })]
+    }) : null]
   });
 
   // Handle checkbox press in select mode

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

@@ -56,14 +56,14 @@ export function StorageKeySection({
   if (keys.length === 0) return null;
   return /*#__PURE__*/_jsxs(View, {
     style: styles.sectionContainer,
-    children: [title && /*#__PURE__*/_jsxs(SectionHeader, {
+    children: [title ? /*#__PURE__*/_jsxs(SectionHeader, {
       children: [/*#__PURE__*/_jsx(SectionHeader.Title, {
         children: title
       }), count >= 0 && /*#__PURE__*/_jsx(SectionHeader.Badge, {
         count: count,
         color: headerColor
       })]
-    }), /*#__PURE__*/_jsx(View, {
+    }) : null, /*#__PURE__*/_jsx(View, {
       style: styles.sectionContent,
       children: keys.map(storageKey => {
         // Create unique key by combining storage type, instance ID (if present), and key name

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

@@ -1,6 +1,6 @@
 "use strict";
 
-import { useState, useEffect, useCallback } from 'react';
+import { useState, useEffect, useCallback, useRef } from 'react';
 import AsyncStorage from '@react-native-async-storage/async-storage';
 export function useAsyncStorageKeys(requiredStorageKeys = []) {
   // State management
@@ -8,8 +8,18 @@ export function useAsyncStorageKeys(requiredStorageKeys = []) {
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState(null);
 
+  // Callers routinely pass a fresh array literal (or rely on the `= []`
+  // default, which is a new array every render). Depending on its identity
+  // would recreate `fetchStorageData` each render, re-fire the effect, and
+  // loop AsyncStorage.getAllKeys/multiGet forever. Depend on a stable content
+  // signature instead, and read the latest array via a ref inside the fetch.
+  const requiredSignature = JSON.stringify(requiredStorageKeys);
+  const requiredRef = useRef(requiredStorageKeys);
+  requiredRef.current = requiredStorageKeys;
+
   // Fetch all keys and values from AsyncStorage
   const fetchStorageData = useCallback(async () => {
+    const requiredStorageKeys = requiredRef.current;
     setIsLoading(true);
     setError(null);
     try {
@@ -106,7 +116,8 @@ export function useAsyncStorageKeys(requiredStorageKeys = []) {
     } finally {
       setIsLoading(false);
     }
-  }, [requiredStorageKeys]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [requiredSignature]);
 
   // Initial fetch
   useEffect(() => {

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

@@ -13,7 +13,7 @@
  * - No multiGet - must fetch keys individually
  */
 
-import { useState, useEffect, useCallback } from 'react';
+import { useState, useEffect, useCallback, useRef } from 'react';
 import { isMMKVAvailable } from '../utils/mmkvAvailability';
 
 // Conditionally import MMKV types
@@ -73,8 +73,16 @@ export function useMMKVKeys(instance, instanceId, requiredStorageKeys = []) {
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState(null);
 
+  // Depend on a stable content signature rather than the array identity — a
+  // fresh `requiredStorageKeys` literal each render would otherwise loop the
+  // fetch effect. Read the latest array via ref inside the fetch.
+  const requiredSignature = JSON.stringify(requiredStorageKeys);
+  const requiredRef = useRef(requiredStorageKeys);
+  requiredRef.current = requiredStorageKeys;
+
   // Fetch all keys and values from MMKV instance
   const fetchStorageData = useCallback(() => {
+    const requiredStorageKeys = requiredRef.current;
     setIsLoading(true);
     setError(null);
     try {
@@ -206,7 +214,8 @@ export function useMMKVKeys(instance, instanceId, requiredStorageKeys = []) {
     } finally {
       setIsLoading(false);
     }
-  }, [instance, instanceId, requiredStorageKeys]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [instance, instanceId, requiredSignature]);
 
   // Initial fetch
   useEffect(() => {
@@ -252,7 +261,15 @@ export function useMultiMMKVKeys(instances, requiredStorageKeys = []) {
   const [storageKeys, setStorageKeys] = useState([]);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState(null);
+
+  // Depend on a stable content signature rather than the array identity — a
+  // fresh `requiredStorageKeys` literal each render would otherwise loop the
+  // fetch effect. Read the latest array via ref inside the fetch.
+  const requiredSignature = JSON.stringify(requiredStorageKeys);
+  const requiredRef = useRef(requiredStorageKeys);
+  requiredRef.current = requiredStorageKeys;
   const fetchStorageData = useCallback(() => {
+    const requiredStorageKeys = requiredRef.current;
     setIsLoading(true);
     setError(null);
     try {
@@ -346,7 +363,8 @@ export function useMultiMMKVKeys(instances, requiredStorageKeys = []) {
     } finally {
       setIsLoading(false);
     }
-  }, [instances, requiredStorageKeys]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [instances, requiredSignature]);
   useEffect(() => {
     fetchStorageData();
   }, [fetchStorageData]);

package/lib/module/storage/stores/storageEventStore.js

@@ -25,6 +25,8 @@
 import { BaseEventStore } from "@buoy-gg/shared-ui";
 import { startListening as startAsyncStorageListening, addListener as addAsyncStorageListener, isListening as isAsyncStorageListening } from "../utils/AsyncStorageListener";
 import { addMMKVListener } from "../utils/MMKVListener";
+import { mmkvInstanceRegistry } from "../utils/MMKVInstanceRegistry";
+import { detectMMKVType } from "../utils/mmkvTypeDetection";
 
 /**
  * Unified storage event type combining AsyncStorage and MMKV events.
@@ -50,6 +52,7 @@ class StorageEventStore extends BaseEventStore {
   // Unsubscribe functions for raw listeners
   asyncStorageUnsubscribe = null;
   mmkvUnsubscribe = null;
+  hasScannedInitialState = false;
   constructor() {
     super({
       storeName: "storage",
@@ -57,6 +60,81 @@ class StorageEventStore extends BaseEventStore {
     });
   }
 
+  /**
+   * Scan all registered MMKV instances and AsyncStorage for existing keys,
+   * creating synthetic events so that getEvents() includes the current state
+   * (not just changes made after capture started). Only runs once per store
+   * lifetime to avoid duplicates.
+   */
+  async scanExistingState() {
+    if (this.hasScannedInitialState) return;
+    this.hasScannedInitialState = true;
+    const now = new Date();
+
+    // ── MMKV: synchronous scan ──
+    const instances = mmkvInstanceRegistry.getAll();
+    for (const {
+      id: instanceId,
+      instance
+    } of instances) {
+      try {
+        const keys = instance.getAllKeys();
+        for (const key of keys) {
+          const {
+            value,
+            type: valueType
+          } = detectMMKVType(instance, key);
+          const actionMap = {
+            string: "set.string",
+            number: "set.number",
+            boolean: "set.boolean",
+            buffer: "set.buffer"
+          };
+          const action = actionMap[valueType] ?? "set.string";
+          this.addEvent({
+            action,
+            timestamp: now,
+            instanceId,
+            data: {
+              key,
+              value,
+              valueType
+            },
+            storageType: "mmkv",
+            id: nextStorageEventId()
+          });
+        }
+      } catch {
+        // Instance may not be accessible — skip silently
+      }
+    }
+
+    // ── AsyncStorage: async scan ──
+    try {
+      const AsyncStorage = require("@react-native-async-storage/async-storage").default;
+      if (AsyncStorage) {
+        const allKeys = await AsyncStorage.getAllKeys();
+        if (allKeys.length > 0) {
+          const pairs = await AsyncStorage.multiGet(allKeys);
+          for (const [key, rawValue] of pairs) {
+            this.addEvent({
+              action: "setItem",
+              timestamp: now,
+              data: {
+                key,
+                value: rawValue ?? undefined
+              },
+              storageType: "async",
+              id: nextStorageEventId()
+            });
+          }
+        }
+      }
+    } catch {
+      // AsyncStorage not available — skip silently
+    }
+  }
+
   /**
    * Start capturing storage events from both AsyncStorage and MMKV
    */
@@ -89,6 +167,9 @@ class StorageEventStore extends BaseEventStore {
         this.addEvent(storageEvent);
       });
     }
+
+    // Scan existing keys so getEvents() includes pre-existing state
+    await this.scanExistingState();
   }
 
   /**

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

@@ -0,0 +1,44 @@
+"use strict";
+
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import { storageEventStore } from "../stores/storageEventStore";
+import { clearAllAppStorage } from "../utils/clearAllStorage";
+/**
+ * Sync adapter for the storage tool, consumed by @buoy-gg/external-sync's
+ * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
+ * this package doesn't need a dependency on it).
+ *
+ * Subscribing starts the underlying capture lifecycle (including the initial
+ * key scan), so storage events are only recorded while a dashboard is
+ * watching.
+ *
+ * The `async.*` actions mirror the AsyncStorage API so the desktop dashboard
+ * can proxy its browse/edit mode against the device's real storage.
+ */
+export const storageSyncAdapter = {
+  version: 1,
+  getSnapshot: () => storageEventStore.getEvents(),
+  subscribe: onChange => storageEventStore.subscribeToEvents(onChange),
+  actions: {
+    clearEvents: () => {
+      storageEventStore.clearEvents();
+    },
+    /** Clears all app storage keys, preserving dev tools settings. */
+    clearAppStorage: () => clearAllAppStorage(),
+    // ── Remote AsyncStorage proxy (desktop browse/edit mode) ──
+    "async.getAllKeys": () => AsyncStorage.getAllKeys(),
+    "async.multiGet": params => AsyncStorage.multiGet(params.keys),
+    "async.getItem": params => AsyncStorage.getItem(params.key),
+    "async.setItem": params => {
+      const {
+        key,
+        value
+      } = params;
+      return AsyncStorage.setItem(key, value);
+    },
+    "async.removeItem": params => AsyncStorage.removeItem(params.key),
+    "async.multiRemove": params => AsyncStorage.multiRemove(params.keys),
+    "async.multiSet": params => AsyncStorage.multiSet(params.pairs),
+    "async.clear": () => AsyncStorage.clear()
+  }
+};

package/lib/typescript/index.d.ts

@@ -33,6 +33,7 @@ export type { AsyncStorageEvent, AsyncStorageEventListener, } from "./storage/ut
 export type { MMKVEvent, MMKVEventListener, } from "./storage/utils/MMKVListener";
 export type { MMKVInstanceInfo } from "./storage/utils/MMKVInstanceRegistry";
 export { registerMMKVInstance, unregisterMMKVInstance, } from "./storage/utils/MMKVInstanceRegistry";
+export { storageSyncAdapter } from "./storage/sync/storageSyncAdapter";
 /** @internal */
 export { storageEventStore } from "./storage/stores/storageEventStore";
 //# 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":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKhE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAKnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,kCAAkC,CAAC;AAK1C,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAK5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EACL,eAAe,EACf,YAAY,EACZ,yBAAyB,GAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,aAAa,EACb,WAAW,EACX,OAAO,GACR,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,SAAS,EACT,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAK7E,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sCAAsC,CAAC;AAK9C,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKhE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAKnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,kCAAkC,CAAC;AAK1C,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAK5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EACL,eAAe,EACf,YAAY,EACZ,yBAAyB,GAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,aAAa,EACb,WAAW,EACX,OAAO,GACR,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,SAAS,EACT,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAK7E,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sCAAsC,CAAC;AAK9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAKvE,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC"}

package/lib/typescript/storage/components/GameUIStorageBrowser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GameUIStorageBrowser.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/GameUIStorageBrowser.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,gBAAgB,EACjB,MAAM,OAAO,CAAC;AASf,OAAO,EAAkB,kBAAkB,EAAmB,MAAM,UAAU,CAAC;AAgD/E,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,UAAU,yBAAyB;IACjC,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,mBAAmB,CAAC,EAAE,GAAG,CAAC,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;CACxD;AAED,wBAAgB,oBAAoB,CAAC,EACnC,mBAAwB,EACxB,WAAmB,EACnB,eAA0C,EAC1C,eAAe,EACf,YAAY,EACZ,WAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,EACb,mBAAmB,GACpB,EAAE,yBAAyB,+BAqxB3B"}
+{"version":3,"file":"GameUIStorageBrowser.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/GameUIStorageBrowser.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,gBAAgB,EACjB,MAAM,OAAO,CAAC;AAUf,OAAO,EAAkB,kBAAkB,EAAmB,MAAM,UAAU,CAAC;AAgD/E,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,UAAU,yBAAyB;IACjC,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,mBAAmB,CAAC,EAAE,GAAG,CAAC,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;CACxD;AAED,wBAAgB,oBAAoB,CAAC,EACnC,mBAAwB,EACxB,WAAmB,EACnB,eAA0C,EAC1C,eAAe,EACf,YAAY,EACZ,WAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,EACb,mBAAmB,GACpB,EAAE,yBAAyB,+BAqxB3B"}

package/lib/typescript/storage/components/GameUIStorageStats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GameUIStorageStats.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/GameUIStorageStats.tsx"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,UAAU,uBAAuB;IAC/B,KAAK,EAAE,eAAe,CAAC;CACxB;AAgFD,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,EAAE,uBAAuB,+BAwVpE"}
+{"version":3,"file":"GameUIStorageStats.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/GameUIStorageStats.tsx"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,UAAU,uBAAuB;IAC/B,KAAK,EAAE,eAAe,CAAC;CACxB;AAgFD,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,EAAE,uBAAuB,+BAwVpE"}

package/lib/typescript/storage/hooks/useAsyncStorageKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncStorageKeys.d.ts","sourceRoot":"","sources":["../../../../src/storage/hooks/useAsyncStorageKeys.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9D,UAAU,yBAAyB;IACjC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,wBAAgB,mBAAmB,CACjC,mBAAmB,GAAE,kBAAkB,EAAO,GAC7C,yBAAyB,CAgJ3B"}
+{"version":3,"file":"useAsyncStorageKeys.d.ts","sourceRoot":"","sources":["../../../../src/storage/hooks/useAsyncStorageKeys.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9D,UAAU,yBAAyB;IACjC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,wBAAgB,mBAAmB,CACjC,mBAAmB,GAAE,kBAAkB,EAAO,GAC7C,yBAAyB,CA2J3B"}

package/lib/typescript/storage/hooks/useMMKVKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMMKVKeys.d.ts","sourceRoot":"","sources":["../../../../src/storage/hooks/useMMKVKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAI9D,KAAK,IAAI,GAAG,GAAG,CAAC;AAYhB,UAAU,iBAAiB;IACzB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EACjC,UAAU,EAAE,MAAM,EAClB,mBAAmB,GAAE,kBAAkB,EAAO,GAC7C,iBAAiB,CA0LnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EAChD,mBAAmB,GAAE,kBAAkB,EAAO,GAC7C,iBAAiB,CAyInB"}
+{"version":3,"file":"useMMKVKeys.d.ts","sourceRoot":"","sources":["../../../../src/storage/hooks/useMMKVKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAI9D,KAAK,IAAI,GAAG,GAAG,CAAC;AAYhB,UAAU,iBAAiB;IACzB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EACjC,UAAU,EAAE,MAAM,EAClB,mBAAmB,GAAE,kBAAkB,EAAO,GAC7C,iBAAiB,CAmMnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EAChD,mBAAmB,GAAE,kBAAkB,EAAO,GAC7C,iBAAiB,CAkJnB"}

package/lib/typescript/storage/stores/storageEventStore.d.ts

@@ -46,7 +46,15 @@ export type StorageEventCallback = (event: StorageEvent) => void;
 declare class StorageEventStore extends BaseEventStore<StorageEvent> {
     private asyncStorageUnsubscribe;
     private mmkvUnsubscribe;
+    private hasScannedInitialState;
     constructor();
+    /**
+     * Scan all registered MMKV instances and AsyncStorage for existing keys,
+     * creating synthetic events so that getEvents() includes the current state
+     * (not just changes made after capture started). Only runs once per store
+     * lifetime to avoid duplicates.
+     */
+    private scanExistingState;
     /**
      * Start capturing storage events from both AsyncStorage and MMKV
      */

package/lib/typescript/storage/stores/storageEventStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storageEventStore.d.ts","sourceRoot":"","sources":["../../../../src/storage/stores/storageEventStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB,CAAC,iBAAiB,GAAG;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D,CAAC,SAAS,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAOtD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAEjE,cAAM,iBAAkB,SAAQ,cAAc,CAAC,YAAY,CAAC;IAE1D,OAAO,CAAC,uBAAuB,CAA6B;IAC5D,OAAO,CAAC,eAAe,CAA6B;;IASpD;;OAEG;cACa,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC/C;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,IAAI;IAc/B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,EAAE;CAG/D;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC;AAGzD,eAAO,MAAM,wBAAwB,GAAI,UAAU,oBAAoB,eACxB,CAAC;AAChD,eAAO,MAAM,cAAc,GAAI,UAAU,oBAAoB,eACxB,CAAC;AACtC,eAAO,MAAM,gBAAgB,sBAAsC,CAAC;AACpE,eAAO,MAAM,kBAAkB,YAAwC,CAAC;AACxE,eAAO,MAAM,kBAAkB,eAAwC,CAAC"}
+{"version":3,"file":"storageEventStore.d.ts","sourceRoot":"","sources":["../../../../src/storage/stores/storageEventStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,uBAAuB,CAAC;AAI/B;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB,CAAC,iBAAiB,GAAG;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D,CAAC,SAAS,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAOtD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAEjE,cAAM,iBAAkB,SAAQ,cAAc,CAAC,YAAY,CAAC;IAE1D,OAAO,CAAC,uBAAuB,CAA6B;IAC5D,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,sBAAsB,CAAS;;IASvC;;;;;OAKG;YACW,iBAAiB;IA4D/B;;OAEG;cACa,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC/C;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,IAAI;IAc/B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,EAAE;CAG/D;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC;AAGzD,eAAO,MAAM,wBAAwB,GAAI,UAAU,oBAAoB,eACxB,CAAC;AAChD,eAAO,MAAM,cAAc,GAAI,UAAU,oBAAoB,eACxB,CAAC;AACtC,eAAO,MAAM,gBAAgB,sBAAsC,CAAC;AACpE,eAAO,MAAM,kBAAkB,YAAwC,CAAC;AACxE,eAAO,MAAM,kBAAkB,eAAwC,CAAC"}

package/lib/typescript/storage/sync/storageSyncAdapter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Sync adapter for the storage tool, consumed by @buoy-gg/external-sync's
+ * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
+ * this package doesn't need a dependency on it).
+ *
+ * Subscribing starts the underlying capture lifecycle (including the initial
+ * key scan), so storage events are only recorded while a dashboard is
+ * watching.
+ *
+ * The `async.*` actions mirror the AsyncStorage API so the desktop dashboard
+ * can proxy its browse/edit mode against the device's real storage.
+ */
+export declare const storageSyncAdapter: {
+    version: number;
+    getSnapshot: () => import("..").StorageEvent[];
+    subscribe: (onChange: () => void) => () => void;
+    actions: {
+        clearEvents: () => void;
+        /** Clears all app storage keys, preserving dev tools settings. */
+        clearAppStorage: () => Promise<void>;
+        "async.getAllKeys": () => Promise<readonly string[]>;
+        "async.multiGet": (params: unknown) => Promise<readonly import("@react-native-async-storage/async-storage/lib/typescript/types").KeyValuePair[]>;
+        "async.getItem": (params: unknown) => Promise<string | null>;
+        "async.setItem": (params: unknown) => Promise<void>;
+        "async.removeItem": (params: unknown) => Promise<void>;
+        "async.multiRemove": (params: unknown) => Promise<void>;
+        "async.multiSet": (params: unknown) => Promise<void>;
+        "async.clear": () => Promise<void>;
+    };
+};
+//# sourceMappingURL=storageSyncAdapter.d.ts.map

package/lib/typescript/storage/sync/storageSyncAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageSyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/storage/sync/storageSyncAdapter.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB;;;0BAGP,MAAM,IAAI;;;QAM9B,kEAAkE;;;mCAKvC,OAAO;kCAER,OAAO;kCAEP,OAAO;qCAIJ,OAAO;sCAEN,OAAO;mCAEV,OAAO;;;CAIrC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/storage",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "storage package",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -26,11 +26,11 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/floating-tools-core": "3.0.1",
-    "@buoy-gg/shared-ui": "3.0.1"
+    "@buoy-gg/shared-ui": "3.0.2",
+    "@buoy-gg/floating-tools-core": "3.0.2"
   },
   "peerDependencies": {
-    "@buoy-gg/license": "3.0.1",
+    "@buoy-gg/license": "3.0.2",
     "@react-native-async-storage/async-storage": ">=1.0.0",
     "react": "*",
     "react-native": "*"
@@ -40,7 +40,7 @@
     "@types/react": "^19.1.0",
     "@types/react-native": "^0.73.0",
     "typescript": "~5.8.3",
-    "@buoy-gg/license": "3.0.1"
+    "@buoy-gg/license": "3.0.2"
   },
   "react-native-builder-bob": {
     "source": "src",