@buoy-gg/storage 2.1.15 → 3.0.0

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/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/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/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": "2.1.15",
+  "version": "3.0.0",
   "description": "storage package",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -26,11 +26,11 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/shared-ui": "2.1.15",
-    "@buoy-gg/floating-tools-core": "2.1.15"
+    "@buoy-gg/floating-tools-core": "3.0.0",
+    "@buoy-gg/shared-ui": "3.0.0"
   },
   "peerDependencies": {
-    "@buoy-gg/license": "2.1.15",
+    "@buoy-gg/license": "3.0.0",
     "@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": "2.1.15"
+    "@buoy-gg/license": "3.0.0"
   },
   "react-native-builder-bob": {
     "source": "src",