@buoy-gg/storage 7.0.17 → 7.0.18

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

@@ -34,7 +34,9 @@ function status() {
     canRestore: true
   };
 }
-async function capture() {
+
+/** Shared by capture() and the live side of previewItems(). */
+async function captureStorageData() {
   const warnings = [];
   const appKeys = (await AsyncStorage.getAllKeys()).filter(k => !isDevToolsStorageKey(k));
   const asyncPairs = (await readMany(appKeys)).filter(pair => pair[1] !== null);
@@ -92,8 +94,23 @@ async function capture() {
     warnings
   };
 }
-async function restore(data) {
+async function capture() {
+  const {
+    data,
+    warnings
+  } = await captureStorageData();
+  return {
+    data,
+    warnings
+  };
+}
+async function restore(data, options) {
   const snapshot = data;
+  const excludedSet = new Set(options?.excludeKeys ?? []);
+  const includedSet = options?.includeKeys ? new Set(options.includeKeys) : null;
+  /** True when this item may be touched (scope + exclusions agree). */
+  const touch = key => !excludedSet.has(key) && (!includedSet || includedSet.has(key));
+  let excludedHits = 0;
   const result = {
     ok: true,
     applied: 0,
@@ -111,10 +128,11 @@ async function restore(data) {
 
   // ── AsyncStorage: delete app keys missing from the snapshot, write the rest ──
   try {
-    const snapPairs = (snapshot.async ?? []).filter(([k]) => !isDevToolsStorageKey(k));
+    const snapPairs = (snapshot.async ?? []).filter(([k]) => !isDevToolsStorageKey(k) && touch(`async:${k}`));
     const snapKeys = new Set(snapPairs.map(([k]) => k));
     const liveKeys = (await AsyncStorage.getAllKeys()).filter(k => !isDevToolsStorageKey(k));
-    const toRemove = liveKeys.filter(k => !snapKeys.has(k));
+    const toRemove = liveKeys.filter(k => !snapKeys.has(k) && touch(`async:${k}`));
+    excludedHits += (snapshot.async ?? []).length - snapPairs.length;
     if (toRemove.length > 0) await removeMany(toRemove);
     if (snapPairs.length > 0) await writeMany(snapPairs);
     result.applied += snapPairs.length + toRemove.length;
@@ -147,6 +165,10 @@ async function restore(data) {
       const snapKeys = new Set(entries.map(e => e.key));
       const liveKeys = instance.getAllKeys().filter(key => !isDevToolsStorageKey(key));
       for (const key of liveKeys) {
+        if (!touch(`mmkv:${id}/${key}`)) {
+          excludedHits += 1;
+          continue;
+        }
         if (!snapKeys.has(key)) {
           deleteMMKVKey(instance, key);
           result.applied += 1;
@@ -154,6 +176,7 @@ async function restore(data) {
       }
       for (const entry of entries) {
         if (isDevToolsStorageKey(entry.key)) continue;
+        if (!touch(`mmkv:${id}/${entry.key}`)) continue;
         if (entry.valueType === "buffer") {
           result.skipped.push({
             id: `mmkv:${id}/${entry.key}`,
@@ -176,6 +199,10 @@ async function restore(data) {
     key,
     options
   } of secureStoreRegistry.getAll()) {
+    if (!touch(`secure:${key}`)) {
+      excludedHits += 1;
+      continue;
+    }
     if (options.requireAuthentication) {
       if (key in secureSnap) {
         result.skipped.push({
@@ -200,6 +227,7 @@ async function restore(data) {
     }
   }
   for (const key of Object.keys(secureSnap)) {
+    if (!touch(`secure:${key}`)) continue;
     if (!secureStoreRegistry.getAll().some(e => e.key === key)) {
       result.skipped.push({
         id: `secure:${key}`,
@@ -207,6 +235,9 @@ async function restore(data) {
       });
     }
   }
+  if (excludedHits > 0) {
+    result.warnings.push(`${excludedHits} item(s) excluded by you`);
+  }
   return result;
 }
 
@@ -267,11 +298,148 @@ async function clear() {
   }
   return result;
 }
+const ITEM_RENDER_CHAR_LIMIT = 256 * 1024;
+function classifyValue(key, label, oldValue, newValue, inOld, inNew) {
+  if (!inNew) return {
+    key,
+    label,
+    verdict: "removed",
+    oldValue
+  };
+  if (!inOld) return {
+    key,
+    label,
+    verdict: "added",
+    newValue
+  };
+  if (Object.is(oldValue, newValue)) return {
+    key,
+    label,
+    verdict: "unchanged"
+  };
+  const tooLarge = typeof oldValue === "string" && oldValue.length > ITEM_RENDER_CHAR_LIMIT || typeof newValue === "string" && newValue.length > ITEM_RENDER_CHAR_LIMIT;
+  if (tooLarge) {
+    return {
+      key,
+      label,
+      verdict: "too-large",
+      reason: "value too large to render a diff — restore still applies it"
+    };
+  }
+  return {
+    key,
+    label,
+    verdict: "changed",
+    oldValue,
+    newValue
+  };
+}
+
+/** Per-key restore preview across all three backends. */
+async function previewItems(target, base) {
+  const targetData = target ?? {
+    async: [],
+    mmkv: {},
+    secure: {}
+  };
+  const liveMode = base === undefined;
+  const baseData = liveMode ? (await captureStorageData()).data : base ?? {
+    async: [],
+    mmkv: {},
+    secure: {}
+  };
+  const items = [];
+  const notes = [];
+
+  // ── AsyncStorage ──
+  const oldAsync = new Map(baseData.async ?? []);
+  const newAsync = new Map(targetData.async ?? []);
+  for (const key of new Set([...oldAsync.keys(), ...newAsync.keys()])) {
+    if (isDevToolsStorageKey(key)) continue;
+    items.push(classifyValue(`async:${key}`, key, oldAsync.get(key), newAsync.get(key), oldAsync.has(key), newAsync.has(key)));
+  }
+
+  // ── MMKV ──
+  const instanceIds = new Set([...Object.keys(baseData.mmkv ?? {}), ...Object.keys(targetData.mmkv ?? {})]);
+  for (const id of instanceIds) {
+    const registered = liveMode ? mmkvInstanceRegistry.get(id) : null;
+    const instanceUnavailable = liveMode && !registered;
+    const readOnly = liveMode && registered?.instance.isReadOnly === true;
+    const oldEntries = new Map((baseData.mmkv?.[id] ?? []).map(e => [e.key, e]));
+    const newEntries = new Map((targetData.mmkv?.[id] ?? []).map(e => [e.key, e]));
+    for (const key of new Set([...oldEntries.keys(), ...newEntries.keys()])) {
+      if (isDevToolsStorageKey(key)) continue;
+      const itemKey = `mmkv:${id}/${key}`;
+      const label = `${id} · ${key}`;
+      const oldE = oldEntries.get(key);
+      const newE = newEntries.get(key);
+      let item = classifyValue(itemKey, label, oldE?.value, newE?.value, oldEntries.has(key), newEntries.has(key));
+      if (item.verdict !== "unchanged") {
+        if (instanceUnavailable) {
+          item = {
+            ...item,
+            verdict: "wont-apply",
+            reason: "MMKV instance not registered"
+          };
+        } else if (readOnly) {
+          item = {
+            ...item,
+            verdict: "wont-apply",
+            reason: "MMKV instance registered read-only"
+          };
+        } else if (newE?.valueType === "buffer" || oldE?.valueType === "buffer") {
+          item = {
+            ...item,
+            verdict: "wont-apply",
+            reason: "ArrayBuffer values cannot be restored"
+          };
+        }
+      }
+      items.push(item);
+    }
+  }
+
+  // ── SecureStore ──
+  const oldSecure = baseData.secure ?? {};
+  const newSecure = targetData.secure ?? {};
+  const registeredSecure = liveMode ? new Map(secureStoreRegistry.getAll().map(e => [e.key, e])) : null;
+  for (const key of new Set([...Object.keys(oldSecure), ...Object.keys(newSecure)])) {
+    let item = classifyValue(`secure:${key}`, key, oldSecure[key], newSecure[key], key in oldSecure, key in newSecure);
+    if (liveMode && item.verdict !== "unchanged") {
+      const entry = registeredSecure?.get(key);
+      if (!entry) {
+        item = {
+          ...item,
+          verdict: "wont-apply",
+          reason: "key no longer registered with registerSecureStoreKeys"
+        };
+      } else if (entry.options.requireAuthentication) {
+        item = {
+          ...item,
+          verdict: "wont-apply",
+          reason: "biometric-protected keys are never written"
+        };
+      }
+    }
+    items.push(item);
+  }
+  if (liveMode) {
+    const biometric = secureStoreRegistry.getAll().filter(e => e.options.requireAuthentication).length;
+    if (biometric > 0) {
+      notes.push(`${biometric} biometric-protected secure key(s) are never read or written`);
+    }
+  }
+  return {
+    items,
+    notes
+  };
+}
 registerStateSnapshotProvider({
   id: "storage",
   label: "Storage",
   status,
   capture,
   restore,
-  clear
+  clear,
+  previewItems
 });

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

@@ -9,6 +9,10 @@
 import { isDevToolsStorageKey } from "@buoy-gg/shared-ui";
 import AsyncStorage from "@react-native-async-storage/async-storage";
 import { writeMany, removeMany } from "./asyncStorageCompat";
+function isOmittedStorageValue(value) {
+  return !!value && typeof value === "object" && value.__buoyValueOnDevice === true;
+}
+
 /**
  * Undo a single storage operation
  *
@@ -28,6 +32,9 @@ export async function undoOperation(event) {
     action,
     data
   } = event;
+  if (isOmittedStorageValue(data?.prevValue) || isOmittedStorageValue(data?.prevPairs)) {
+    throw new Error("Cannot undo: previous value is still on the device — fetch getEventDetail first");
+  }
   {
     switch (action) {
       case "setItem":
@@ -106,6 +113,12 @@ export async function jumpToState(events, targetEventIndex) {
   if (targetEventIndex < 0 || targetEventIndex >= events.length) {
     throw new Error(`Invalid event index: ${targetEventIndex}`);
   }
+  for (const event of events) {
+    const data = event.data;
+    if (isOmittedStorageValue(data?.value) || isOmittedStorageValue(data?.prevValue) || isOmittedStorageValue(data?.pairs) || isOmittedStorageValue(data?.prevPairs)) {
+      throw new Error("Cannot jump: some event values are still on the device — fetch getEventDetail first");
+    }
+  }
 
   // Build up the state by applying each event up to and including the target.
   // We use the final values from each event, not the operations themselves.
@@ -253,14 +266,15 @@ export function canUndo(event) {
     case "setItem":
     case "mergeItem":
     case "removeItem":
-      // Can undo if we have the key
-      return !!data?.key;
+      // Can undo if we have the key — but not while prevValue is still a
+      // wire-form on-device marker (restoring that would write garbage).
+      return !!data?.key && !isOmittedStorageValue(data.prevValue);
     case "multiSet":
     case "multiRemove":
     case "multiMerge":
     case "clear":
       // Can undo if we have previous pairs
-      return !!data?.prevPairs && data.prevPairs.length > 0;
+      return !!data?.prevPairs && data.prevPairs.length > 0 && !isOmittedStorageValue(data.prevPairs);
     default:
       return false;
   }

package/lib/typescript/index.d.ts

@@ -29,6 +29,7 @@ export { useMMKVKeys, useMultiMMKVKeys } from "./storage/hooks/useMMKVKeys";
 export { useMMKVInstances, useMMKVInstance, useMMKVInstanceExists, } from "./storage/hooks/useMMKVInstances";
 export { useStorageEvents, type UseStorageEventsOptions, type UseStorageEventsResult, } from "./storage/hooks/useStorageEvents";
 export type { StorageEvent, StorageEventListener, StorageEventCallback, } from "./storage/stores/storageEventStore";
+export type { RequiredStorageKey, StorageKeyInfo } from "./storage/types";
 export { clearAllAppStorage } from "./storage/utils/clearAllStorage";
 export { setStorageValue, storageEditBlockedReason, validateStorageValue, storageValueToEditableText, type EditableMMKVInstance, } from "./storage/utils/setStorageValue";
 export { isMMKVAvailable, getMMKVClass, getMMKVUnavailableMessage, } from "./storage/utils/mmkvAvailability";
@@ -42,7 +43,7 @@ export { registerSecureStoreKeys, unregisterSecureStoreKey, } from "./storage/ut
 export type { SecureStoreLike, SecureStoreKeyDescriptor, SecureStoreOptionsLike, } from "./storage/utils/SecureStoreRegistry";
 export { storageSyncAdapter } from "./storage/sync/storageSyncAdapter";
 /** @internal */
-export { storageEventStore } from "./storage/stores/storageEventStore";
+export { storageEventStore, isValueOnDevice, batchPairsOf, } from "./storage/stores/storageEventStore";
 /**
  * Tell a mounted storage browser to re-read every backend. Used by the desktop
  * dashboard, where local storage listeners are suppressed and device data

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

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

package/lib/typescript/storage/components/DiffViewer/modes/ThemedSplitView.d.ts

@@ -1,19 +1,8 @@
-import { DiffOptions } from "../DiffOptionsPanel";
-import { DiffTheme } from "../themes/diffThemes";
-interface ThemedSplitViewProps {
-    oldValue: unknown;
-    newValue: unknown;
-    differences: unknown[];
-    theme: DiffTheme;
-    options?: DiffOptions;
-    showThemeName?: boolean;
-    /**
-     * Scroll the rows inside their own fixed-height pane (default). Set false to
-     * render every row inline at natural height and let an ancestor ScrollView
-     * move them — one page-level scroll instead of a nested scroll region.
-     */
-    scrollEnabled?: boolean;
-}
-export declare function ThemedSplitView({ oldValue, newValue, theme, options, showThemeName, scrollEnabled, }: ThemedSplitViewProps): import("react").JSX.Element;
-export {};
+/**
+ * Re-export shim — ThemedSplitView now lives in @buoy-gg/shared-ui/dataViewer
+ * (promoted so redux/zustand/jotai/time-machine share one copy; this used to
+ * be the only fork with folding + virtualization, and fixes had to be made
+ * twice). Keep importing from here inside the storage package.
+ */
+export { ThemedSplitView, type DiffOptions, type DiffCompareMethod, } from "@buoy-gg/shared-ui/dataViewer";
 //# sourceMappingURL=ThemedSplitView.d.ts.map

package/lib/typescript/storage/components/DiffViewer/modes/ThemedSplitView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemedSplitView.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/components/DiffViewer/modes/ThemedSplitView.tsx"],"names":[],"mappings":"AAyBA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAaD,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,OAAyB,EACzB,aAAqB,EACrB,aAAoB,GACrB,EAAE,oBAAoB,+BAmMtB"}
+{"version":3,"file":"ThemedSplitView.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/components/DiffViewer/modes/ThemedSplitView.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,+BAA+B,CAAC"}

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

@@ -1,4 +1,5 @@
 import { RequiredStorageKey } from "../types";
+import { type StorageEvent } from "../hooks/useStorageEvents";
 export declare const FREE_TIER_EVENT_LIMIT = 25;
 interface StorageModalWithTabsProps {
     visible: boolean;
@@ -27,8 +28,14 @@ interface StorageModalWithTabsProps {
      * pull is the only way to refresh a backend that has not pushed.
      */
     onRefresh?: () => void;
+    /**
+     * Fired when the user opens an event's detail view (and its neighbor, for
+     * the diff). Remote mirrors (Buoy Desktop) use this to fetch oversized
+     * values on demand — wire-form snapshots omit payloads over 16KB.
+     */
+    onEventSelect?: (event: StorageEvent) => void;
 }
-export declare function StorageModalWithTabs({ visible, onClose, onBack, onMinimize, enableSharedModalDimensions, requiredStorageKeys, inline, onTabChange, onRefresh, }: StorageModalWithTabsProps): import("react").JSX.Element | null;
+export declare function StorageModalWithTabs({ visible, onClose, onBack, onMinimize, enableSharedModalDimensions, requiredStorageKeys, inline, onTabChange, onRefresh, onEventSelect, }: StorageModalWithTabsProps): import("react").JSX.Element | null;
 /**
  * The same storage tool as `StorageModalWithTabs`, rendered INLINE for hosts
  * that place tools in a panel rather than a modal. Exists so there is exactly

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

@@ -1 +1 @@
-{"version":3,"file":"StorageModalWithTabs.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/StorageModalWithTabs.tsx"],"names":[],"mappings":"AA6BA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AA2B9C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,UAAU,yBAAyB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,IAAI,CAAC;IACvC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,KAAK,IAAI,CAAC;IAClD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAqBD,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,2BAAmC,EACnC,mBAAwB,EACxB,MAAc,EACd,WAAW,EACX,SAAS,GACV,EAAE,yBAAyB,sCAu9B3B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,GAAE,IAAI,CAAC,yBAAyB,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAM,+BAG9E"}
+{"version":3,"file":"StorageModalWithTabs.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/StorageModalWithTabs.tsx"],"names":[],"mappings":"AA6BA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAY9C,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAehF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,UAAU,yBAAyB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,IAAI,CAAC;IACvC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,KAAK,IAAI,CAAC;IAClD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CAC/C;AAqBD,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,2BAAmC,EACnC,mBAAwB,EACxB,MAAc,EACd,WAAW,EACX,SAAS,EACT,aAAa,GACd,EAAE,yBAAyB,sCAo/B3B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,GAAE,IAAI,CAAC,yBAAyB,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAM,+BAG9E"}

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":"AAGA,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"}
+{"version":3,"file":"useAsyncStorageKeys.d.ts","sourceRoot":"","sources":["../../../../src/storage/hooks/useAsyncStorageKeys.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG9D,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,CA6J3B"}

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;AAO9D,KAAK,IAAI,GAAG,GAAG,CAAC;AAEhB,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,CA8LnB;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"}
+{"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;AAQ9D,KAAK,IAAI,GAAG,GAAG,CAAC;AAEhB,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,CA4LnB;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,CAoJnB"}

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

@@ -35,6 +35,20 @@ export type StorageEvent = (AsyncStorageEvent & {
     storageType: "mmkv";
     id: string;
 });
+/** True when a field is the wire-form VALUE_ON_DEVICE marker. */
+export declare function isValueOnDevice(value: unknown): boolean;
+/**
+ * `pairs` / `prevPairs` are AsyncStorage-only — they carry the batch
+ * operations (multiSet / multiRemove / multiMerge / clear), and MMKV has no
+ * batch API, so its `data` has no such fields. Reading them off the
+ * `StorageEvent` union needs narrowing, and this is the one place that does
+ * it; writing them unconditionally would also graft meaningless keys onto
+ * every MMKV event on the wire.
+ */
+export declare function batchPairsOf(event: StorageEvent): {
+    pairs?: unknown;
+    prevPairs?: unknown;
+};
 /**
  * Listener callback type for storage events array
  */
@@ -71,6 +85,18 @@ declare class StorageEventStore extends BaseEventStore<StorageEvent> {
      * Get events filtered by storage type
      */
     getEventsByType(storageType: "async" | "mmkv"): StorageEvent[];
+    /**
+     * Replace the event list, keeping values a remote mirror already hydrated.
+     * Wire-form snapshots always carry VALUE_ON_DEVICE markers for oversized
+     * payloads; a later snapshot must not blank the detail pane (or wipe
+     * `prevValue` that time-travel undo needs).
+     */
+    replaceEvents(events: StorageEvent[]): void;
+    /**
+     * Hydrate one mirrored event with real values fetched on demand from the
+     * device via the adapter's `getEventDetail`. Remote-mirror (desktop) only.
+     */
+    hydrateEvent(event: StorageEvent): void;
 }
 export declare const storageEventStore: StorageEventStore;
 export declare const subscribeToStorageEvents: (listener: StorageEventListener) => () => void;

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;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;IA0D/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"}
+{"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;AAEtD,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMvD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAGA;AAmBD;;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;IA0D/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;IAI9D;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI;IAyB3C;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;CAaxC;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

@@ -1,6 +1,29 @@
+import { type StorageEvent } from "../stores/storageEventStore";
+/**
+ * Sentinel used in WIRE-FORM snapshots in place of oversized values.
+ * Storage events, MMKV browse dumps, and SecureStore dumps all reuse this
+ * marker. Dashboards fetch the real payload via `getEventDetail` / `mmkv.get`
+ * / `secure.get`.
+ */
+export declare const VALUE_ON_DEVICE: Readonly<{
+    __buoyValueOnDevice: true;
+    note: "Value stays on the device — fetched on demand via getEventDetail / mmkv.get / secure.get.";
+}>;
+/** Max serialized bytes of one storage value on the list snapshot. */
+export declare const SNAPSHOT_VALUE_INLINE_LIMIT: number;
+/**
+ * Total inline budget for one snapshot's event list, held under the emit
+ * layer's 2MB so a snapshot is never DROPPED (a drop leaves the whole panel
+ * stale). Per-value caps alone don't get there: the store keeps 500 events, so
+ * 500 writes of an individually-legal 9KB value still total ~4.7MB. Newest
+ * events keep their values inline; once the budget is spent, older ones
+ * degrade to metadata + fetch-on-demand.
+ */
+export declare const SNAPSHOT_EVENTS_BUDGET: number;
 /** One MMKV entry in a `mmkv.snapshot` result. */
 export interface MMKVSnapshotEntry {
     key: string;
+    /** Oversized values are replaced with VALUE_ON_DEVICE on the wire. */
     value: unknown;
     valueType: string;
 }
@@ -17,8 +40,11 @@ export interface SecureSnapshotEntry {
     description?: string;
     keychainService?: string;
     requireAuthentication: boolean;
-    /** `null` when unset, or when the key is biometric-protected (never read). */
-    value: string | null;
+    /**
+     * `null` when unset, or when the key is biometric-protected (never read).
+     * Oversized values are replaced with VALUE_ON_DEVICE on the wire.
+     */
+    value: unknown;
 }
 /**
  * Sync adapter for the storage tool, consumed by @buoy-gg/external-sync's
@@ -31,13 +57,33 @@ export interface SecureSnapshotEntry {
  *
  * The `async.*` actions mirror the AsyncStorage API so the desktop dashboard
  * can proxy its browse/edit mode against the device's real storage.
+ *
+ * v2: oversized / unserializable event values are replaced with
+ * VALUE_ON_DEVICE. Dashboards fetch them via `getEventDetail`.
  */
 export declare const storageSyncAdapter: {
     version: number;
-    getSnapshot: () => import("../..").StorageEvent[];
+    getSnapshot: () => StorageEvent[];
     subscribe: (onChange: () => void) => () => void;
     actions: {
         clearEvents: () => void;
+        /**
+         * On-demand detail: one event's real value/prevValue/pairs.
+         * The per-snapshot stream stays payload-light; this is the explicit,
+         * size-guarded channel for the detail pane (and for time-travel undo,
+         * which needs `prevValue`).
+         */
+        getEventDetail: (params: unknown) => {
+            found: false;
+            reason: string;
+            id?: undefined;
+            event?: undefined;
+        } | {
+            found: true;
+            id: string;
+            event: StorageEvent;
+            reason?: undefined;
+        };
         /** Clears all app storage keys, preserving dev tools settings. */
         clearAppStorage: () => Promise<void>;
         /** Undo one event, addressed by the `id` the store assigned it. */
@@ -67,6 +113,26 @@ export declare const storageSyncAdapter: {
         "async.multiSet": (params: unknown) => Promise<void>;
         "async.clear": () => Promise<void>;
         "mmkv.snapshot": () => MMKVSnapshotInstance[];
+        /**
+         * On-demand MMKV value. `mmkv.snapshot` omits oversized strings so a
+         * browse poll cannot blow the action-result budget; this is the
+         * size-guarded channel for one key.
+         */
+        "mmkv.get": (params: unknown) => {
+            found: false;
+            reason: string;
+            instanceId?: undefined;
+            key?: undefined;
+            value?: undefined;
+            valueType?: undefined;
+        } | {
+            found: true;
+            instanceId: string;
+            key: string;
+            value: unknown;
+            valueType: import("../..").MMKVValueType;
+            reason?: undefined;
+        };
         "mmkv.set": (params: unknown) => void;
         "mmkv.remove": (params: unknown) => void;
         "secure.keys": () => {

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

@@ -1 +1 @@
-{"version":3,"file":"storageSyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/storage/sync/storageSyncAdapter.ts"],"names":[],"mappings":"AAsCA,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAsBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB;;;0BAaP,MAAM,IAAI;;;QAM9B,kEAAkE;;QAOlE,mEAAmE;oCACjC,OAAO;;;;;QAkBzC;;;;WAIG;oCAC+B,OAAO;;;;;;;;mCAyCR,OAAO;kCAId,OAAO;kCAMP,OAAO;qCAIJ,OAAO;sCAEN,OAAO;mCAEV,OAAO;;+BAOb,oBAAoB,EAAE;6BAgBtB,OAAO;gCAIJ,OAAO;;;;;;;QAkB/B;;;;;WAKG;iCAC0B,OAAO,CAAC,mBAAmB,EAAE,CAAC;+BAwBpC,OAAO;QAW9B;;;;;WAKG;+BACoB,OAAO;kCAIJ,OAAO;;CAGpC,CAAC"}
+{"version":3,"file":"storageSyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/storage/sync/storageSyncAdapter.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AAYrC;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;EAG1B,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,2BAA2B,QAAY,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,QAAqB,CAAC;AA4JzD,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAsBD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB;;;0BAeP,MAAM,IAAI;;;QAM9B;;;;;WAKG;iCACsB,OAAO;;;;;;;;;;;QAUhC,kEAAkE;;QAOlE,mEAAmE;oCACjC,OAAO;;;;;QAkBzC;;;;WAIG;oCAC+B,OAAO;;;;;;;;mCAyCR,OAAO;kCAId,OAAO;kCAMP,OAAO;qCAIJ,OAAO;sCAEN,OAAO;mCAEV,OAAO;;+BAOb,oBAAoB,EAAE;QAgB3C;;;;WAIG;6BACkB,OAAO;;;;;;;;;;;;;;;6BAkBP,OAAO;gCAIJ,OAAO;;;;;;;QAkB/B;;;;;WAKG;iCAC0B,OAAO,CAAC,mBAAmB,EAAE,CAAC;+BAwBpC,OAAO;QAW9B;;;;;WAKG;+BACoB,OAAO;kCAIJ,OAAO;;CAGpC,CAAC"}

package/lib/typescript/storage/types.d.ts

@@ -12,17 +12,17 @@ export interface StorageKeyInfo {
     category: "required" | "optional";
     lastUpdated?: Date;
 }
+/**
+ * A required key the browser validates. `storageType` scopes the check to one
+ * backend — without it, every backend's hook historically synthesized its own
+ * Missing row for the same key (Async + MMKV both counting it). Prefer always
+ * setting `storageType` when more than one backend is registered.
+ */
 export type RequiredStorageKey = string | {
     key: string;
-    expectedValue: string;
-    description?: string;
-} | {
-    key: string;
-    expectedType: string;
-    description?: string;
-} | {
-    key: string;
-    storageType: StorageType;
+    expectedValue?: string;
+    expectedType?: string;
+    storageType?: StorageType;
     description?: string;
 };
 export interface StorageKeyStats {

package/lib/typescript/storage/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/storage/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EACF,kBAAkB,GAClB,kBAAkB,GAClB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,CAAC;IACvB,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAClC,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IAEtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/storage/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EACF,kBAAkB,GAClB,kBAAkB,GAClB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,CAAC;IACvB,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAClC,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IAEtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC"}

package/lib/typescript/storage/utils/requiredStorageKeyScope.d.ts

@@ -0,0 +1,10 @@
+import type { RequiredStorageKey } from "../types";
+import type { StorageType } from "./storageQueryUtils";
+/**
+ * Whether a required-key declaration should be enforced by a given backend
+ * hook. Explicit `storageType` wins; bare string keys default to AsyncStorage
+ * (the historical zero-config backend). Objects without `storageType` still
+ * apply to every backend — matching prior behavior for apps that never set it.
+ */
+export declare function requiredKeyAppliesTo(req: RequiredStorageKey, backend: StorageType): boolean;
+//# sourceMappingURL=requiredStorageKeyScope.d.ts.map

package/lib/typescript/storage/utils/requiredStorageKeyScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requiredStorageKeyScope.d.ts","sourceRoot":"","sources":["../../../../src/storage/utils/requiredStorageKeyScope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,kBAAkB,EACvB,OAAO,EAAE,WAAW,GACnB,OAAO,CAIT"}

package/lib/typescript/storage/utils/storageTimeTravelUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storageTimeTravelUtils.d.ts","sourceRoot":"","sources":["../../../../src/storage/utils/storageTimeTravelUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkE3E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,EAAE,EAC3B,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAuCf;AAoGD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAoBzD"}
+{"version":3,"file":"storageTimeTravelUtils.d.ts","sourceRoot":"","sources":["../../../../src/storage/utils/storageTimeTravelUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAUhE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0E3E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,EAAE,EAC3B,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAqDf;AAoGD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAyBzD"}