@buoy-gg/storage 3.0.1 → 4.0.1

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

@@ -1,9 +1,11 @@
 "use strict";
 
-import AsyncStorage from "@react-native-async-storage/async-storage";
+import { asyncStorage as AsyncStorage, asyncStorageCaps, readMany } from "./asyncStorageCompat";
 
 // AsyncStorage method signatures - matching the actual AsyncStorage API
 
+// v3-only batch methods (replace multiSet/multiRemove)
+
 // Event types for AsyncStorage operations
 
 /**
@@ -14,6 +16,12 @@ import AsyncStorage from "@react-native-async-storage/async-storage";
  * and emits events to registered listeners. It maintains the original functionality
  * while providing observability for debugging and development tools.
  *
+ * Supports both async-storage v2 (multiGet/multiSet/multiRemove/mergeItem) and
+ * v3 (getMany/setMany/removeMany, no merge). On v3 the renamed batch methods are
+ * swizzled and normalized back to the same v2-shaped events, so the rest of the
+ * tool — event store, time-travel, desktop sync — is version-agnostic. v3 dropped
+ * the merge API entirely, so no merge events can occur there.
+ *
  * @example
  * ```typescript
  * // Start listening to all AsyncStorage operations
@@ -54,9 +62,13 @@ class AsyncStorageListener {
   originalRemoveItem = null;
   originalMergeItem = null;
   originalClear = null;
+  // v2 batch originals
   originalMultiSet = null;
   originalMultiRemove = null;
   originalMultiMerge = null;
+  // v3 batch originals
+  originalSetMany = null;
+  originalRemoveMany = null;
 
   /**
    * Determines if a storage key should be ignored to prevent infinite loops
@@ -100,14 +112,22 @@ class AsyncStorageListener {
       return false;
     }
 
-    // Store original methods (these should be the real AsyncStorage methods)
+    // Store original methods (these should be the real AsyncStorage methods).
+    // Single-item + clear are identical across v2/v3.
     this.originalSetItem = AsyncStorage.setItem.bind(AsyncStorage);
     this.originalRemoveItem = AsyncStorage.removeItem.bind(AsyncStorage);
-    this.originalMergeItem = AsyncStorage.mergeItem.bind(AsyncStorage);
     this.originalClear = AsyncStorage.clear.bind(AsyncStorage);
-    this.originalMultiSet = AsyncStorage.multiSet.bind(AsyncStorage);
-    this.originalMultiRemove = AsyncStorage.multiRemove.bind(AsyncStorage);
-    this.originalMultiMerge = AsyncStorage.multiMerge ? AsyncStorage.multiMerge.bind(AsyncStorage) : null;
+    if (asyncStorageCaps.hasLegacyMultiApi) {
+      // v2: multiSet/multiRemove + merge API
+      this.originalMultiSet = AsyncStorage.multiSet.bind(AsyncStorage);
+      this.originalMultiRemove = AsyncStorage.multiRemove.bind(AsyncStorage);
+      this.originalMergeItem = AsyncStorage.mergeItem.bind(AsyncStorage);
+      this.originalMultiMerge = AsyncStorage.multiMerge ? AsyncStorage.multiMerge.bind(AsyncStorage) : null;
+    } else {
+      // v3: setMany/removeMany; merge API was removed (nothing to capture)
+      this.originalSetMany = AsyncStorage.setMany.bind(AsyncStorage);
+      this.originalRemoveMany = AsyncStorage.removeMany.bind(AsyncStorage);
+    }
 
     // Original methods stored successfully
     this.isInitialized = true;
@@ -128,12 +148,13 @@ class AsyncStorageListener {
     if (this.originalRemoveItem) {
       AsyncStorage.removeItem = this.originalRemoveItem;
     }
-    if (this.originalMergeItem) {
-      AsyncStorage.mergeItem = this.originalMergeItem;
-    }
     if (this.originalClear) {
       AsyncStorage.clear = this.originalClear;
     }
+    // v2 batch + merge
+    if (this.originalMergeItem) {
+      AsyncStorage.mergeItem = this.originalMergeItem;
+    }
     if (this.originalMultiSet) {
       AsyncStorage.multiSet = this.originalMultiSet;
     }
@@ -143,6 +164,13 @@ class AsyncStorageListener {
     if (this.originalMultiMerge) {
       AsyncStorage.multiMerge = this.originalMultiMerge;
     }
+    // v3 batch
+    if (this.originalSetMany) {
+      AsyncStorage.setMany = this.originalSetMany;
+    }
+    if (this.originalRemoveMany) {
+      AsyncStorage.removeMany = this.originalRemoveMany;
+    }
   }
 
   /**
@@ -171,6 +199,77 @@ class AsyncStorageListener {
     });
   }
 
+  /**
+   * Shared core for batch writes (v2 multiSet/multiMerge, v3 setMany).
+   *
+   * Captures previous values for the affected keys, runs the original native
+   * operation, and emits a normalized event. `action` distinguishes a plain set
+   * from a merge so time-travel can replay them differently.
+   */
+  async handleBatchSet(pairs, runOriginal, action = "multiSet") {
+    // Filter out ignored keys
+    const filteredPairs = pairs.filter(([key]) => !this.shouldIgnoreKey(key));
+    if (filteredPairs.length === 0) {
+      return runOriginal();
+    }
+
+    // Capture previous values for all keys being written
+    const keysToSet = filteredPairs.map(([key]) => key);
+    let prevPairs = [];
+    try {
+      prevPairs = await readMany(keysToSet);
+    } catch {
+      // Failed to capture previous values
+    }
+
+    // Execute the operation
+    const result = await runOriginal();
+
+    // Emit event with previous values
+    this.emit({
+      action,
+      timestamp: new Date(),
+      data: {
+        pairs: filteredPairs,
+        prevPairs
+      }
+    });
+    return result;
+  }
+
+  /**
+   * Shared core for batch removals (v2 multiRemove, v3 removeMany).
+   */
+  async handleBatchRemove(keys, runOriginal) {
+    // Filter out ignored keys
+    const filteredKeys = keys.filter(key => !this.shouldIgnoreKey(key));
+    if (filteredKeys.length === 0) {
+      return runOriginal();
+    }
+
+    // Capture previous values for all keys being removed
+    let prevPairs = [];
+    try {
+      prevPairs = await readMany(filteredKeys);
+    } catch {
+      // Failed to capture previous values
+    }
+
+    // Execute the operation
+    const result = await runOriginal();
+
+    // Emit event with previous values
+    this.emit({
+      action: "multiRemove",
+      timestamp: new Date(),
+      data: {
+        keys: filteredKeys,
+        prevPairs
+      }
+    });
+    return result;
+  }
+
   /**
    * Start intercepting AsyncStorage operations by swizzling methods
    *
@@ -255,8 +354,8 @@ class AsyncStorageListener {
       };
     }
 
-    // Swizzle mergeItem
-    if (AsyncStorage) {
+    // Swizzle mergeItem (v2 only — v3 removed the merge API)
+    if (asyncStorageCaps.hasMergeApi && AsyncStorage) {
       AsyncStorage.mergeItem = async (key, value) => {
         // Only capture and emit if key is not ignored
         if (!this.shouldIgnoreKey(key)) {
@@ -292,8 +391,7 @@ class AsyncStorageListener {
           // Filter out ignored keys
           const keysToCapture = allKeys.filter(key => !this.shouldIgnoreKey(key));
           if (keysToCapture.length > 0) {
-            const keyValuePairs = await AsyncStorage.multiGet(keysToCapture);
-            prevPairs = keyValuePairs;
+            prevPairs = await readMany(keysToCapture);
           }
         } catch {
           // Failed to capture previous state
@@ -314,105 +412,18 @@ class AsyncStorageListener {
       };
     }
 
-    // Swizzle multiSet
-    if (AsyncStorage) {
-      AsyncStorage.multiSet = async keyValuePairs => {
-        // Filter out ignored keys
-        const filteredPairs = keyValuePairs.filter(([key]) => !this.shouldIgnoreKey(key));
-        if (filteredPairs.length > 0) {
-          // Capture previous values for all keys being set
-          const keysToSet = filteredPairs.map(([key]) => key);
-          let prevPairs = [];
-          try {
-            const existingValues = await AsyncStorage.multiGet(keysToSet);
-            prevPairs = existingValues;
-          } catch {
-            // Failed to capture previous values
-          }
-
-          // Execute the operation
-          const result = this.originalMultiSet ? await this.originalMultiSet(keyValuePairs) : undefined;
-
-          // Emit event with previous values
-          this.emit({
-            action: "multiSet",
-            timestamp: new Date(),
-            data: {
-              pairs: filteredPairs,
-              prevPairs
-            }
-          });
-          return result;
-        }
-        return this.originalMultiSet ? this.originalMultiSet(keyValuePairs) : Promise.resolve();
-      };
-    }
-
-    // Swizzle multiRemove
-    if (AsyncStorage) {
-      AsyncStorage.multiRemove = async keys => {
-        // Filter out ignored keys
-        const filteredKeys = keys.filter(key => !this.shouldIgnoreKey(key));
-        if (filteredKeys.length > 0) {
-          // Capture previous values for all keys being removed
-          let prevPairs = [];
-          try {
-            const existingValues = await AsyncStorage.multiGet(filteredKeys);
-            prevPairs = existingValues;
-          } catch {
-            // Failed to capture previous values
-          }
-
-          // Execute the operation
-          const result = this.originalMultiRemove ? await this.originalMultiRemove(keys) : undefined;
-
-          // Emit event with previous values
-          this.emit({
-            action: "multiRemove",
-            timestamp: new Date(),
-            data: {
-              keys: filteredKeys,
-              prevPairs
-            }
-          });
-          return result;
-        }
-        return this.originalMultiRemove ? this.originalMultiRemove(keys) : Promise.resolve();
-      };
-    }
-
-    // Swizzle multiMerge if available
-    if (this.originalMultiMerge && AsyncStorage) {
-      AsyncStorage.multiMerge = async keyValuePairs => {
-        // Filter out ignored keys
-        const filteredPairs = keyValuePairs.filter(([key]) => !this.shouldIgnoreKey(key));
-        if (filteredPairs.length > 0) {
-          // Capture previous values for all keys being merged
-          const keysToMerge = filteredPairs.map(([key]) => key);
-          let prevPairs = [];
-          try {
-            const existingValues = await AsyncStorage.multiGet(keysToMerge);
-            prevPairs = existingValues;
-          } catch {
-            // Failed to capture previous values
-          }
-
-          // Execute the operation
-          const result = this.originalMultiMerge ? await this.originalMultiMerge(keyValuePairs) : undefined;
-
-          // Emit event with previous values
-          this.emit({
-            action: "multiMerge",
-            timestamp: new Date(),
-            data: {
-              pairs: filteredPairs,
-              prevPairs
-            }
-          });
-          return result;
-        }
-        return this.originalMultiMerge ? this.originalMultiMerge(keyValuePairs) : Promise.resolve();
-      };
+    // Swizzle the batch methods for whichever API the installed version exposes.
+    if (asyncStorageCaps.hasLegacyMultiApi && AsyncStorage) {
+      // ── v2: multiSet / multiRemove / multiMerge ──
+      AsyncStorage.multiSet = keyValuePairs => this.handleBatchSet(keyValuePairs, () => this.originalMultiSet ? this.originalMultiSet(keyValuePairs) : Promise.resolve());
+      AsyncStorage.multiRemove = keys => this.handleBatchRemove(keys, () => this.originalMultiRemove ? this.originalMultiRemove(keys) : Promise.resolve());
+      if (this.originalMultiMerge) {
+        AsyncStorage.multiMerge = keyValuePairs => this.handleBatchSet(keyValuePairs, () => this.originalMultiMerge ? this.originalMultiMerge(keyValuePairs) : Promise.resolve(), "multiMerge");
+      }
+    } else if (AsyncStorage) {
+      // ── v3: setMany / removeMany (normalized back to multiSet/multiRemove events) ──
+      AsyncStorage.setMany = entries => this.handleBatchSet(Object.entries(entries), () => this.originalSetMany ? this.originalSetMany(entries) : Promise.resolve());
+      AsyncStorage.removeMany = keys => this.handleBatchRemove(keys, () => this.originalRemoveMany ? this.originalRemoveMany(keys) : Promise.resolve());
     }
     this.isListening = true;
     // Started listening successfully
@@ -433,29 +444,7 @@ class AsyncStorageListener {
     }
 
     // Stopping listener and restoring original methods
-
-    // Restore original methods
-    if (this.originalSetItem) {
-      AsyncStorage.setItem = this.originalSetItem;
-    }
-    if (this.originalRemoveItem) {
-      AsyncStorage.removeItem = this.originalRemoveItem;
-    }
-    if (this.originalMergeItem) {
-      AsyncStorage.mergeItem = this.originalMergeItem;
-    }
-    if (this.originalClear) {
-      AsyncStorage.clear = this.originalClear;
-    }
-    if (this.originalMultiSet) {
-      AsyncStorage.multiSet = this.originalMultiSet;
-    }
-    if (this.originalMultiRemove) {
-      AsyncStorage.multiRemove = this.originalMultiRemove;
-    }
-    if (this.originalMultiMerge) {
-      AsyncStorage.multiMerge = this.originalMultiMerge;
-    }
+    this.restoreOriginalMethods();
     this.isListening = false;
     // Stopped listening successfully
   }

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

@@ -0,0 +1,81 @@
+"use strict";
+
+/**
+ * AsyncStorage compatibility adapter (v2 + v3)
+ *
+ * `@react-native-async-storage/async-storage` 3.x reshaped the default-export
+ * API. The single-item methods kept their v2 signatures, but the batch + merge
+ * methods changed:
+ *
+ *   v2 (what this package was written against)   v3
+ *   ------------------------------------------   --------------------------------
+ *   multiGet(keys): [key, value|null][]          getMany(keys): Record<key, value|null>
+ *   multiSet([[k, v]]): void                     setMany({ k: v }): void
+ *   multiRemove(keys): void                      removeMany(keys): void
+ *   mergeItem / multiMerge                       removed entirely
+ *
+ * This module is the single seam between the storage tool and whichever
+ * async-storage version the host app installed. The rest of the package always
+ * speaks the v2 tuple-shaped API; we translate to v3 here when needed.
+ *
+ * Reads (`readMany`) are routed through the *unswizzled* native methods, so the
+ * event listener can safely call them while capturing previous values without
+ * re-triggering itself.
+ */
+import RawAsyncStorage from "@react-native-async-storage/async-storage";
+
+// Loosely typed because the surface differs across major versions; callers go
+// through the helpers below rather than touching this directly.
+
+/** The live default-export object (methods may be swizzled by the listener). */
+export const asyncStorage = RawAsyncStorage;
+
+/**
+ * Capability flags describing which API surface the installed version exposes.
+ * `multiGet` only exists on v2; `mergeItem` was removed in v3.
+ */
+export const asyncStorageCaps = {
+  /** v2 exposes multiGet/multiSet/multiRemove; v3 renamed these to *Many. */
+  hasLegacyMultiApi: typeof asyncStorage?.multiGet === "function",
+  /** v3 removed mergeItem/multiMerge with no replacement. */
+  hasMergeApi: typeof asyncStorage?.mergeItem === "function"
+};
+
+/**
+ * Batch-read keys, normalized to the v2 `[key, value|null][]` tuple shape and
+ * preserving the requested key order regardless of installed version.
+ */
+export async function readMany(keys) {
+  if (typeof asyncStorage.multiGet === "function") {
+    return await asyncStorage.multiGet(keys);
+  }
+  // v3: getMany returns a Record; rebuild ordered tuples ("what you request is
+  // what you get" — missing keys come back as null).
+  const record = await asyncStorage.getMany(keys);
+  return keys.map(key => [key, record[key] ?? null]);
+}
+
+/**
+ * Batch-write key/value pairs. Calls the live method (which may be swizzled by
+ * the listener on v2's `multiSet` / v3's `setMany`) so writes still emit events.
+ */
+export async function writeMany(pairs) {
+  if (typeof asyncStorage.multiSet === "function") {
+    return asyncStorage.multiSet(pairs);
+  }
+  const record = {};
+  for (const [key, value] of pairs) record[key] = value;
+  return asyncStorage.setMany(record);
+}
+
+/**
+ * Batch-remove keys via the live method (swizzled on v2's `multiRemove` /
+ * v3's `removeMany`).
+ */
+export async function removeMany(keys) {
+  if (typeof asyncStorage.multiRemove === "function") {
+    return asyncStorage.multiRemove(keys);
+  }
+  return asyncStorage.removeMany(keys);
+}
+export default asyncStorage;

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

@@ -1,6 +1,7 @@
 "use strict";
 
 import AsyncStorage from "@react-native-async-storage/async-storage";
+import { removeMany } from "./asyncStorageCompat";
 import { isDevToolsStorageKey } from "@buoy-gg/shared-ui";
 
 /**
@@ -25,7 +26,7 @@ export async function clearAllAppStorage() {
   // Clearing ${keysToRemove.length} app storage keys
 
   // Remove all non-dev-tool keys
-  await AsyncStorage.multiRemove(keysToRemove);
+  await removeMany(keysToRemove);
 
   // Successfully cleared app storage
 }

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

@@ -36,16 +36,25 @@
  * ```
  */
 export function detectMMKVType(instance, key) {
-  // Try string (most common)
+  // MMKV stores no type metadata, so the native getters can cross-read: in
+  // particular `getString` returns "" (an empty string, NOT undefined) for many
+  // non-string values like numbers and `false`. Trying getString first and
+  // trusting its result therefore mis-detects those as empty strings — e.g.
+  // a key set to 42 or false would render as "". Probe the getters and only let
+  // getString win when it returns a NON-empty string; treat an empty result as
+  // ambiguous and prefer the number/boolean getters.
   const stringValue = instance.getString(key);
-  if (stringValue !== undefined) {
+
+  // A non-empty string is unambiguously a string.
+  if (stringValue !== undefined && stringValue !== '') {
     return {
       value: stringValue,
       type: 'string'
     };
   }
 
-  // Try number
+  // Empty getString result is ambiguous (genuine "" vs a number/boolean the
+  // native layer decoded to ""). Prefer typed getters when they have a value.
   const numberValue = instance.getNumber(key);
   if (numberValue !== undefined) {
     return {
@@ -53,8 +62,6 @@ export function detectMMKVType(instance, key) {
       type: 'number'
     };
   }
-
-  // Try boolean
   const booleanValue = instance.getBoolean(key);
   if (booleanValue !== undefined) {
     return {
@@ -63,6 +70,14 @@ export function detectMMKVType(instance, key) {
     };
   }
 
+  // getString returned "" and nothing else matched -> a genuine empty string.
+  if (stringValue === '') {
+    return {
+      value: '',
+      type: 'string'
+    };
+  }
+
   // Try buffer (least common)
   const bufferValue = instance.getBuffer(key);
   if (bufferValue !== undefined) {

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

@@ -7,6 +7,7 @@
  */
 
 import AsyncStorage from "@react-native-async-storage/async-storage";
+import { writeMany } from "./asyncStorageCompat";
 import { pauseCapture, resumeCapture } from "./AsyncStorageListener";
 
 /**
@@ -73,7 +74,7 @@ export async function undoOperation(event) {
           // Restore all cleared key-value pairs
           const pairsToRestore = data.prevPairs.filter(([, value]) => value !== null);
           if (pairsToRestore.length > 0) {
-            await AsyncStorage.multiSet(pairsToRestore);
+            await writeMany(pairsToRestore);
           }
         }
         break;
@@ -125,7 +126,7 @@ export async function jumpToState(events, targetEventIndex) {
       }
     }
     if (pairsToSet.length > 0) {
-      await AsyncStorage.multiSet(pairsToSet);
+      await writeMany(pairsToSet);
     }
   } finally {
     // Always resume capture

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

@@ -11,4 +11,43 @@ export function getValueTypeLabel(value) {
   if (type === "number") return "number";
   if (type === "string") return "string";
   return "unknown";
+}
+
+/** Longest value preview rendered inline next to the type label. */
+const MAX_INLINE_PREVIEW = 40;
+
+/**
+ * Short, human-readable preview of a value for inline display next to the type
+ * label, or `null` when the value is too large/complex to preview (long
+ * strings, objects, arrays). Lets the user read simple values without opening
+ * the card.
+ */
+export function getValuePreview(value) {
+  switch (typeof value) {
+    case "boolean":
+      return value ? "true" : "false";
+    case "number":
+      return Number.isFinite(value) ? String(value) : null;
+    case "string":
+      {
+        if (value.length === 0) return '""';
+        if (value.length > MAX_INLINE_PREVIEW) return null;
+        // Collapse whitespace so multi-line/tabbed values stay on one line.
+        return `"${value.replace(/\s+/g, " ")}"`;
+      }
+    default:
+      return null;
+    // objects, arrays, null, undefined
+  }
+}
+
+/**
+ * Type label optionally followed by a short value preview — e.g. `boolean · true`,
+ * `number · 42`, `string · "hello"`. Falls back to just the type label when the
+ * value is too large to preview.
+ */
+export function getValueTypeWithPreview(value) {
+  const label = getValueTypeLabel(value);
+  const preview = getValuePreview(value);
+  return preview ? `${label} · ${preview}` : label;
 }

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

@@ -13,7 +13,11 @@ interface GameUIStorageBrowserProps {
     eventCountByKey?: Record<string, number>;
     onViewHistory?: (key: string) => void;
     enabledStorageTypes?: Set<'async' | 'mmkv' | 'secure'>;
+    /** Keys pinned to the top of the list */
+    pinnedKeys?: Set<string>;
+    /** Toggle a key's pinned state */
+    onTogglePin?: (key: string) => void;
 }
-export declare function GameUIStorageBrowser({ requiredStorageKeys, showFilters, ignoredPatterns, onTogglePattern, onAddPattern, searchQuery, storageDataRef, eventCountByKey, onViewHistory, enabledStorageTypes, }: GameUIStorageBrowserProps): import("react").JSX.Element;
+export declare function GameUIStorageBrowser({ requiredStorageKeys, showFilters, ignoredPatterns, onTogglePattern, onAddPattern, searchQuery, storageDataRef, eventCountByKey, onViewHistory, enabledStorageTypes, pinnedKeys, onTogglePin, }: GameUIStorageBrowserProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=GameUIStorageBrowser.d.ts.map

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;IACvD,yCAAyC;IACzC,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,kCAAkC;IAClC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,wBAAgB,oBAAoB,CAAC,EACnC,mBAAwB,EACxB,WAAmB,EACnB,eAA0C,EAC1C,eAAe,EACf,YAAY,EACZ,WAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,WAAW,GACZ,EAAE,yBAAyB,+BA6yB3B"}

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/components/SelectionActionBar.d.ts

@@ -9,6 +9,8 @@ interface SelectionActionBarProps {
     }>;
     /** Callback when deletion is complete */
     onDeleteComplete?: () => void;
+    /** Hide the selected keys by adding them to the filter store */
+    onHideKeys?: (keys: StorageKeyInfo[]) => void;
     /** Callback to select all visible keys */
     onSelectAll?: () => void;
     /** Callback to clear selection */
@@ -16,6 +18,6 @@ interface SelectionActionBarProps {
     /** Total number of visible keys */
     totalVisibleKeys: number;
 }
-export declare function SelectionActionBar({ selectedKeys, mmkvInstances, onDeleteComplete, onSelectAll, onClearSelection, totalVisibleKeys, }: SelectionActionBarProps): import("react").JSX.Element | null;
+export declare function SelectionActionBar({ selectedKeys, mmkvInstances, onDeleteComplete, onHideKeys, onSelectAll, onClearSelection, totalVisibleKeys, }: SelectionActionBarProps): import("react").JSX.Element | null;
 export {};
 //# sourceMappingURL=SelectionActionBar.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SelectionActionBar.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/SelectionActionBar.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,UAAU,uBAAuB;IAC/B,4BAA4B;IAC5B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,kCAAkC;IAClC,aAAa,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACpD,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,EACjC,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,EAAE,uBAAuB,sCA2IzB"}
+{"version":3,"file":"SelectionActionBar.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/SelectionActionBar.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,UAAU,uBAAuB;IAC/B,4BAA4B;IAC5B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,kCAAkC;IAClC,aAAa,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACpD,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,gEAAgE;IAChE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IAC9C,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,EACjC,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,EAAE,uBAAuB,sCAwJzB"}

package/lib/typescript/storage/components/StorageBrowserMode.d.ts

@@ -11,11 +11,13 @@ interface StorageBrowserModeProps {
     eventCountByKey?: Record<string, number>;
     onViewHistory?: (key: string) => void;
     enabledStorageTypes?: Set<'async' | 'mmkv' | 'secure'>;
+    pinnedKeys?: Set<string>;
+    onTogglePin?: (key: string) => void;
 }
 /**
  * Storage browser mode component
  * Displays storage keys with game UI styled interface
  */
-export declare function StorageBrowserMode({ requiredStorageKeys, showFilters, ignoredPatterns, onTogglePattern, onAddPattern, searchQuery, storageDataRef, eventCountByKey, onViewHistory, enabledStorageTypes, }: StorageBrowserModeProps): import("react").JSX.Element;
+export declare function StorageBrowserMode({ requiredStorageKeys, showFilters, ignoredPatterns, onTogglePattern, onAddPattern, searchQuery, storageDataRef, eventCountByKey, onViewHistory, enabledStorageTypes, pinnedKeys, onTogglePin, }: StorageBrowserModeProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=StorageBrowserMode.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StorageBrowserMode.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/StorageBrowserMode.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAEzC,UAAU,uBAAuB;IAC/B,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;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,mBAAwB,EACxB,WAAmB,EACnB,eAA2B,EAC3B,eAAe,EACf,YAAY,EACZ,WAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,EACb,mBAAmB,GACpB,EAAE,uBAAuB,+BAezB"}
+{"version":3,"file":"StorageBrowserMode.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/StorageBrowserMode.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAEzC,UAAU,uBAAuB;IAC/B,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;IACvD,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,mBAAwB,EACxB,WAAmB,EACnB,eAA2B,EAC3B,eAAe,EACf,YAAY,EACZ,WAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,WAAW,GACZ,EAAE,uBAAuB,+BAiBzB"}