@buoy-gg/storage 7.0.40 → 7.0.42

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

@@ -1,382 +1 @@
-"use strict";
-
-var _asyncStorage = _interopRequireDefault(require("@react-native-async-storage/async-storage"));
-var _sharedUi = require("@buoy-gg/shared-ui");
-var _asyncStorageCompat = require("./asyncStorageCompat");
-var _clearAllStorage = require("./clearAllStorage");
-var _MMKVInstanceRegistry = require("./MMKVInstanceRegistry");
-var _mmkvTypeDetection = require("./mmkvTypeDetection");
-var _SecureStoreRegistry = require("./SecureStoreRegistry");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * Time Machine snapshot provider for device storage (AsyncStorage + MMKV +
- * SecureStore).
- *
- * Registered into @buoy-gg/shared-ui's stateSnapshotRegistry at module init;
- * consumed by @buoy-gg/time-machine.
- *
- * Buoy's own keys (isDevToolsStorageKey — @react_buoy*, @buoy*, buoy-*,
- * legacy patterns) are excluded on BOTH capture and restore, so a snapshot
- * can never clobber dev-tool settings. Restore is a diff: app keys missing
- * from the snapshot are deleted, snapshot entries are written back.
- *
- * Known-lossy by design (each surfaces a warning/skip):
- * - MMKV ArrayBuffer values are never transported.
- * - SecureStore biometric keys are never read or written (auth prompt).
- * - SecureStore keys outside the registered descriptor list are invisible.
- */
-
-function deleteMMKVKey(instance, key) {
-  // v4 renamed delete() to remove() — support both
-  if (instance.remove) instance.remove(key);else instance.delete?.(key);
-}
-function status() {
-  return {
-    canCapture: true,
-    canRestore: true
-  };
-}
-
-/** Shared by capture() and the live side of previewItems(). */
-async function captureStorageData() {
-  const warnings = [];
-  const appKeys = (await _asyncStorage.default.getAllKeys()).filter(k => !(0, _sharedUi.isDevToolsStorageKey)(k));
-  const asyncPairs = (await (0, _asyncStorageCompat.readMany)(appKeys)).filter(pair => pair[1] !== null);
-  const mmkv = {};
-  for (const {
-    id,
-    instance
-  } of _MMKVInstanceRegistry.mmkvInstanceRegistry.getAll()) {
-    try {
-      mmkv[id] = instance.getAllKeys().filter(key => !(0, _sharedUi.isDevToolsStorageKey)(key)).map(key => {
-        const {
-          value,
-          type: valueType
-        } = (0, _mmkvTypeDetection.detectMMKVType)(instance, key);
-        if (valueType === "buffer") {
-          warnings.push(`mmkv "${id}"/"${key}": ArrayBuffer value not capturable`);
-        }
-        return {
-          key,
-          value,
-          valueType
-        };
-      });
-    } catch {
-      warnings.push(`mmkv "${id}": unreadable, captured without entries`);
-      mmkv[id] = [];
-    }
-  }
-  const secure = {};
-  const secureModule = _SecureStoreRegistry.secureStoreRegistry.getModule();
-  for (const {
-    key,
-    options
-  } of _SecureStoreRegistry.secureStoreRegistry.getAll()) {
-    if (options.requireAuthentication) {
-      warnings.push(`secure "${key}": biometric-protected, not capturable`);
-      continue;
-    }
-    let value = null;
-    if (secureModule) {
-      try {
-        value = await secureModule.getItemAsync(key, options);
-      } catch {
-        warnings.push(`secure "${key}": unreadable, captured as unset`);
-      }
-    }
-    secure[key] = value;
-  }
-  return {
-    data: {
-      async: asyncPairs,
-      mmkv,
-      secure
-    },
-    warnings
-  };
-}
-async function capture() {
-  const {
-    data,
-    warnings
-  } = await captureStorageData();
-  return {
-    data,
-    warnings
-  };
-}
-async function restore(data, options) {
-  const snapshot = data;
-  const scope = (0, _sharedUi.createRestoreScope)(options);
-  /** True when this item may be touched (scope + exclusions agree). */
-  const touch = scope.touch;
-  const result = (0, _sharedUi.emptyRestoreResult)();
-  if (!snapshot) {
-    return (0, _sharedUi.failedRestore)("empty storage snapshot");
-  }
-
-  // ── AsyncStorage: delete app keys missing from the snapshot, write the rest ──
-  try {
-    const snapPairs = (snapshot.async ?? []).filter(([k]) => !(0, _sharedUi.isDevToolsStorageKey)(k) && touch(`async:${k}`));
-    const snapKeys = new Set(snapPairs.map(([k]) => k));
-    const liveKeys = (await _asyncStorage.default.getAllKeys()).filter(k => !(0, _sharedUi.isDevToolsStorageKey)(k));
-    const toRemove = liveKeys.filter(k => !snapKeys.has(k) && touch(`async:${k}`));
-    scope.countExcluded((snapshot.async ?? []).length - snapPairs.length);
-    if (toRemove.length > 0) await (0, _asyncStorageCompat.removeMany)(toRemove);
-    if (snapPairs.length > 0) await (0, _asyncStorageCompat.writeMany)(snapPairs);
-    result.applied += snapPairs.length + toRemove.length;
-  } catch (e) {
-    result.ok = false;
-    result.warnings.push(`asyncstorage restore failed: ${String(e)}`);
-  }
-
-  // ── MMKV: per registered writable instance, diff against the snapshot ──
-  for (const [id, entries] of Object.entries(snapshot.mmkv ?? {})) {
-    const registered = _MMKVInstanceRegistry.mmkvInstanceRegistry.get(id);
-    if (!registered) {
-      result.skipped.push({
-        id: `mmkv:${id}`,
-        reason: "instance not registered"
-      });
-      continue;
-    }
-    if (registered.instance.isReadOnly) {
-      result.skipped.push({
-        id: `mmkv:${id}`,
-        reason: "instance registered read-only"
-      });
-      continue;
-    }
-    const {
-      instance
-    } = registered;
-    try {
-      const snapKeys = new Set(entries.map(e => e.key));
-      const liveKeys = instance.getAllKeys().filter(key => !(0, _sharedUi.isDevToolsStorageKey)(key));
-      for (const key of liveKeys) {
-        if (!scope.allows(`mmkv:${id}/${key}`)) continue;
-        if (!snapKeys.has(key)) {
-          deleteMMKVKey(instance, key);
-          result.applied += 1;
-        }
-      }
-      for (const entry of entries) {
-        if ((0, _sharedUi.isDevToolsStorageKey)(entry.key)) continue;
-        if (!touch(`mmkv:${id}/${entry.key}`)) continue;
-        if (entry.valueType === "buffer") {
-          result.skipped.push({
-            id: `mmkv:${id}/${entry.key}`,
-            reason: "ArrayBuffer values cannot be restored"
-          });
-          continue;
-        }
-        instance.set(entry.key, entry.value);
-        result.applied += 1;
-      }
-    } catch (e) {
-      result.ok = false;
-      result.warnings.push(`mmkv "${id}" restore failed: ${String(e)}`);
-    }
-  }
-
-  // ── SecureStore: diff over the registered, non-biometric descriptor list ──
-  const secureSnap = snapshot.secure ?? {};
-  for (const {
-    key,
-    options
-  } of _SecureStoreRegistry.secureStoreRegistry.getAll()) {
-    if (!scope.allows(`secure:${key}`)) continue;
-    if (options.requireAuthentication) {
-      if (key in secureSnap) {
-        result.skipped.push({
-          id: `secure:${key}`,
-          reason: "biometric-protected keys are never written"
-        });
-      }
-      continue;
-    }
-    try {
-      if (key in secureSnap) {
-        const value = secureSnap[key];
-        if (value === null) await _SecureStoreRegistry.secureStoreRegistry.deleteValue(key);else await _SecureStoreRegistry.secureStoreRegistry.setValue(key, value);
-      } else {
-        // Registered key with no snapshot entry — snapshot predates it; unset.
-        await _SecureStoreRegistry.secureStoreRegistry.deleteValue(key);
-      }
-      result.applied += 1;
-    } catch (e) {
-      result.ok = false;
-      result.warnings.push(`secure "${key}" restore failed: ${String(e)}`);
-    }
-  }
-  for (const key of Object.keys(secureSnap)) {
-    if (!touch(`secure:${key}`)) continue;
-    if (!_SecureStoreRegistry.secureStoreRegistry.getAll().some(e => e.key === key)) {
-      result.skipped.push({
-        id: `secure:${key}`,
-        reason: "key no longer registered with registerSecureStoreKeys"
-      });
-    }
-  }
-  const excludedWarning = scope.excludedWarning("item(s)");
-  if (excludedWarning) result.warnings.push(excludedWarning);
-  return result;
-}
-
-/** Wipe to fresh-install state (Buoy keys preserved). Used by baseline restore. */
-async function clear() {
-  const result = (0, _sharedUi.emptyRestoreResult)();
-  try {
-    await (0, _clearAllStorage.clearAllAppStorage)();
-    result.applied += 1;
-  } catch (e) {
-    result.ok = false;
-    result.warnings.push(`asyncstorage clear failed: ${String(e)}`);
-  }
-  for (const {
-    id,
-    instance
-  } of _MMKVInstanceRegistry.mmkvInstanceRegistry.getAll()) {
-    if (instance.isReadOnly) {
-      result.skipped.push({
-        id: `mmkv:${id}`,
-        reason: "instance registered read-only"
-      });
-      continue;
-    }
-    try {
-      for (const key of instance.getAllKeys().filter(k => !(0, _sharedUi.isDevToolsStorageKey)(k))) {
-        deleteMMKVKey(instance, key);
-        result.applied += 1;
-      }
-    } catch (e) {
-      result.ok = false;
-      result.warnings.push(`mmkv "${id}" clear failed: ${String(e)}`);
-    }
-  }
-  for (const {
-    key,
-    options
-  } of _SecureStoreRegistry.secureStoreRegistry.getAll()) {
-    if (options.requireAuthentication) {
-      result.skipped.push({
-        id: `secure:${key}`,
-        reason: "biometric-protected keys are never written"
-      });
-      continue;
-    }
-    try {
-      await _SecureStoreRegistry.secureStoreRegistry.deleteValue(key);
-      result.applied += 1;
-    } catch (e) {
-      result.ok = false;
-      result.warnings.push(`secure "${key}" clear failed: ${String(e)}`);
-    }
-  }
-  return result;
-}
-const ITEM_RENDER_CHAR_LIMIT = 256 * 1024;
-
-/**
- * Storage values are strings (or MMKV primitives): identity equality and a
- * character-length size gate are the right tests, not a deep walk.
- */
-function classifyValue(key, label, oldValue, newValue, inOld, inNew) {
-  return (0, _sharedUi.classifyPreviewItem)({
-    key,
-    label,
-    oldValue,
-    newValue,
-    inOld,
-    inNew
-  }, {
-    equal: Object.is,
-    tooLarge: value => typeof value === "string" && value.length > ITEM_RENDER_CHAR_LIMIT,
-    tooLargeReason: "value too large to render a diff — restore still applies it"
-  });
-}
-
-/** 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 (0, _sharedUi.unionKeys)(oldAsync, newAsync)) {
-    if ((0, _sharedUi.isDevToolsStorageKey)(key)) continue;
-    items.push(classifyValue(`async:${key}`, key, oldAsync.get(key), newAsync.get(key), oldAsync.has(key), newAsync.has(key)));
-  }
-
-  // ── MMKV ──
-  for (const id of (0, _sharedUi.unionKeys)(baseData.mmkv, targetData.mmkv)) {
-    const registered = liveMode ? _MMKVInstanceRegistry.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 (0, _sharedUi.unionKeys)(oldEntries, newEntries)) {
-      if ((0, _sharedUi.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 (instanceUnavailable) {
-        item = (0, _sharedUi.wontApply)(item, "MMKV instance not registered");
-      } else if (readOnly) {
-        item = (0, _sharedUi.wontApply)(item, "MMKV instance registered read-only");
-      } else if (newE?.valueType === "buffer" || oldE?.valueType === "buffer") {
-        item = (0, _sharedUi.wontApply)(item, "ArrayBuffer values cannot be restored");
-      }
-      items.push(item);
-    }
-  }
-
-  // ── SecureStore ──
-  const oldSecure = baseData.secure ?? {};
-  const newSecure = targetData.secure ?? {};
-  const registeredSecure = liveMode ? new Map(_SecureStoreRegistry.secureStoreRegistry.getAll().map(e => [e.key, e])) : null;
-  for (const key of (0, _sharedUi.unionKeys)(oldSecure, newSecure)) {
-    let item = classifyValue(`secure:${key}`, key, oldSecure[key], newSecure[key], key in oldSecure, key in newSecure);
-    if (liveMode) {
-      const entry = registeredSecure?.get(key);
-      if (!entry) {
-        item = (0, _sharedUi.wontApply)(item, "key no longer registered with registerSecureStoreKeys");
-      } else if (entry.options.requireAuthentication) {
-        item = (0, _sharedUi.wontApply)(item, "biometric-protected keys are never written");
-      }
-    }
-    items.push(item);
-  }
-  // No blanket "N biometric-protected keys" note: a biometric key a restore
-  // would actually touch already gets its own won't-apply row carrying that
-  // exact reason, so the note only ever restated it for keys nothing was
-  // going to do anything with.
-  return {
-    items,
-    notes
-  };
-}
-(0, _sharedUi.registerStateSnapshotProvider)({
-  id: "storage",
-  label: "Storage",
-  status,
-  capture,
-  restore,
-  clear,
-  previewItems
-});
+"use strict";var _asyncStorage=_interopRequireDefault(require("@react-native-async-storage/async-storage"));var _sharedUi=require("@buoy-gg/shared-ui");var _asyncStorageCompat=require("./asyncStorageCompat");var _clearAllStorage=require("./clearAllStorage");var _MMKVInstanceRegistry=require("./MMKVInstanceRegistry");var _mmkvTypeDetection=require("./mmkvTypeDetection");var _SecureStoreRegistry=require("./SecureStoreRegistry");function _interopRequireDefault(s){return s&&s.__esModule?s:{default:s}}function deleteMMKVKey(s,a){if(s.remove)s.remove(a);else s.delete?.(a)}function status(){return{canCapture:true,canRestore:true}}async function captureStorageData(){const s=[];const a=(await _asyncStorage.default.getAllKeys()).filter(o=>!(0,_sharedUi.isDevToolsStorageKey)(o));const i=(await(0,_asyncStorageCompat.readMany)(a)).filter(o=>o[1]!==null);const n={};for(const{id:o,instance:f}of _MMKVInstanceRegistry.mmkvInstanceRegistry.getAll()){try{n[o]=f.getAllKeys().filter(e=>!(0,_sharedUi.isDevToolsStorageKey)(e)).map(e=>{const{value:y,type:l}=(0,_mmkvTypeDetection.detectMMKVType)(f,e);if(l==="buffer"){s.push(`mmkv "${o}"/"${e}": ArrayBuffer value not capturable`)}return{key:e,value:y,valueType:l}})}catch{s.push(`mmkv "${o}": unreadable, captured without entries`);n[o]=[]}}const u={};const r=_SecureStoreRegistry.secureStoreRegistry.getModule();for(const{key:o,options:f}of _SecureStoreRegistry.secureStoreRegistry.getAll()){if(f.requireAuthentication){s.push(`secure "${o}": biometric-protected, not capturable`);continue}let e=null;if(r){try{e=await r.getItemAsync(o,f)}catch{s.push(`secure "${o}": unreadable, captured as unset`)}}u[o]=e}return{data:{async:i,mmkv:n,secure:u},warnings:s}}async function capture(){const{data:s,warnings:a}=await captureStorageData();return{data:s,warnings:a}}async function restore(s,a){const i=s;const n=(0,_sharedUi.createRestoreScope)(a);const u=n.touch;const r=(0,_sharedUi.emptyRestoreResult)();if(!i){return(0,_sharedUi.failedRestore)("empty storage snapshot")}try{const e=(i.async??[]).filter(([t])=>!(0,_sharedUi.isDevToolsStorageKey)(t)&&u(`async:${t}`));const y=new Set(e.map(([t])=>t));const l=(await _asyncStorage.default.getAllKeys()).filter(t=>!(0,_sharedUi.isDevToolsStorageKey)(t));const d=l.filter(t=>!y.has(t)&&u(`async:${t}`));n.countExcluded((i.async??[]).length-e.length);if(d.length>0)await(0,_asyncStorageCompat.removeMany)(d);if(e.length>0)await(0,_asyncStorageCompat.writeMany)(e);r.applied+=e.length+d.length}catch(e){r.ok=false;r.warnings.push(`asyncstorage restore failed: ${String(e)}`)}for(const[e,y]of Object.entries(i.mmkv??{})){const l=_MMKVInstanceRegistry.mmkvInstanceRegistry.get(e);if(!l){r.skipped.push({id:`mmkv:${e}`,reason:"instance not registered"});continue}if(l.instance.isReadOnly){r.skipped.push({id:`mmkv:${e}`,reason:"instance registered read-only"});continue}const{instance:d}=l;try{const t=new Set(y.map(c=>c.key));const g=d.getAllKeys().filter(c=>!(0,_sharedUi.isDevToolsStorageKey)(c));for(const c of g){if(!n.allows(`mmkv:${e}/${c}`))continue;if(!t.has(c)){deleteMMKVKey(d,c);r.applied+=1}}for(const c of y){if((0,_sharedUi.isDevToolsStorageKey)(c.key))continue;if(!u(`mmkv:${e}/${c.key}`))continue;if(c.valueType==="buffer"){r.skipped.push({id:`mmkv:${e}/${c.key}`,reason:"ArrayBuffer values cannot be restored"});continue}d.set(c.key,c.value);r.applied+=1}}catch(t){r.ok=false;r.warnings.push(`mmkv "${e}" restore failed: ${String(t)}`)}}const o=i.secure??{};for(const{key:e,options:y}of _SecureStoreRegistry.secureStoreRegistry.getAll()){if(!n.allows(`secure:${e}`))continue;if(y.requireAuthentication){if(e in o){r.skipped.push({id:`secure:${e}`,reason:"biometric-protected keys are never written"})}continue}try{if(e in o){const l=o[e];if(l===null)await _SecureStoreRegistry.secureStoreRegistry.deleteValue(e);else await _SecureStoreRegistry.secureStoreRegistry.setValue(e,l)}else{await _SecureStoreRegistry.secureStoreRegistry.deleteValue(e)}r.applied+=1}catch(l){r.ok=false;r.warnings.push(`secure "${e}" restore failed: ${String(l)}`)}}for(const e of Object.keys(o)){if(!u(`secure:${e}`))continue;if(!_SecureStoreRegistry.secureStoreRegistry.getAll().some(y=>y.key===e)){r.skipped.push({id:`secure:${e}`,reason:"key no longer registered with registerSecureStoreKeys"})}}const f=n.excludedWarning("item(s)");if(f)r.warnings.push(f);return r}async function clear(){const s=(0,_sharedUi.emptyRestoreResult)();try{await(0,_clearAllStorage.clearAllAppStorage)();s.applied+=1}catch(a){s.ok=false;s.warnings.push(`asyncstorage clear failed: ${String(a)}`)}for(const{id:a,instance:i}of _MMKVInstanceRegistry.mmkvInstanceRegistry.getAll()){if(i.isReadOnly){s.skipped.push({id:`mmkv:${a}`,reason:"instance registered read-only"});continue}try{for(const n of i.getAllKeys().filter(u=>!(0,_sharedUi.isDevToolsStorageKey)(u))){deleteMMKVKey(i,n);s.applied+=1}}catch(n){s.ok=false;s.warnings.push(`mmkv "${a}" clear failed: ${String(n)}`)}}for(const{key:a,options:i}of _SecureStoreRegistry.secureStoreRegistry.getAll()){if(i.requireAuthentication){s.skipped.push({id:`secure:${a}`,reason:"biometric-protected keys are never written"});continue}try{await _SecureStoreRegistry.secureStoreRegistry.deleteValue(a);s.applied+=1}catch(n){s.ok=false;s.warnings.push(`secure "${a}" clear failed: ${String(n)}`)}}return s}const ITEM_RENDER_CHAR_LIMIT=256*1024;function classifyValue(s,a,i,n,u,r){return(0,_sharedUi.classifyPreviewItem)({key:s,label:a,oldValue:i,newValue:n,inOld:u,inNew:r},{equal:Object.is,tooLarge:o=>typeof o==="string"&&o.length>ITEM_RENDER_CHAR_LIMIT,tooLargeReason:"value too large to render a diff \u2014 restore still applies it"})}async function previewItems(s,a){const i=s??{async:[],mmkv:{},secure:{}};const n=a===void 0;const u=n?(await captureStorageData()).data:a??{async:[],mmkv:{},secure:{}};const r=[];const o=[];const f=new Map(u.async??[]);const e=new Map(i.async??[]);for(const t of(0,_sharedUi.unionKeys)(f,e)){if((0,_sharedUi.isDevToolsStorageKey)(t))continue;r.push(classifyValue(`async:${t}`,t,f.get(t),e.get(t),f.has(t),e.has(t)))}for(const t of(0,_sharedUi.unionKeys)(u.mmkv,i.mmkv)){const g=n?_MMKVInstanceRegistry.mmkvInstanceRegistry.get(t):null;const c=n&&!g;const w=n&&g?.instance.isReadOnly===true;const v=new Map((u.mmkv?.[t]??[]).map(p=>[p.key,p]));const k=new Map((i.mmkv?.[t]??[]).map(p=>[p.key,p]));for(const p of(0,_sharedUi.unionKeys)(v,k)){if((0,_sharedUi.isDevToolsStorageKey)(p))continue;const $=`mmkv:${t}/${p}`;const R=`${t} \xB7 ${p}`;const h=v.get(p);const S=k.get(p);let m=classifyValue($,R,h?.value,S?.value,v.has(p),k.has(p));if(c){m=(0,_sharedUi.wontApply)(m,"MMKV instance not registered")}else if(w){m=(0,_sharedUi.wontApply)(m,"MMKV instance registered read-only")}else if(S?.valueType==="buffer"||h?.valueType==="buffer"){m=(0,_sharedUi.wontApply)(m,"ArrayBuffer values cannot be restored")}r.push(m)}}const y=u.secure??{};const l=i.secure??{};const d=n?new Map(_SecureStoreRegistry.secureStoreRegistry.getAll().map(t=>[t.key,t])):null;for(const t of(0,_sharedUi.unionKeys)(y,l)){let g=classifyValue(`secure:${t}`,t,y[t],l[t],t in y,t in l);if(n){const c=d?.get(t);if(!c){g=(0,_sharedUi.wontApply)(g,"key no longer registered with registerSecureStoreKeys")}else if(c.options.requireAuthentication){g=(0,_sharedUi.wontApply)(g,"biometric-protected keys are never written")}}r.push(g)}return{items:r,notes:o}}(0,_sharedUi.registerStateSnapshotProvider)({id:"storage",label:"Storage",status,capture,restore,clear,previewItems});

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

@@ -1,46 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.translateStorageAction = translateStorageAction;
-/**
- * Translates storage action types to human-readable labels
- */
-function translateStorageAction(action) {
-  switch (action) {
-    // AsyncStorage actions
-    case "setItem":
-      return "SET";
-    case "removeItem":
-      return "REMOVE";
-    case "mergeItem":
-      return "MERGE";
-    case "clear":
-      return "CLEAR";
-    case "multiSet":
-      return "MULTI SET";
-    case "multiRemove":
-      return "MULTI REMOVE";
-    case "multiMerge":
-      return "MULTI MERGE";
-
-    // MMKV actions - simplified to match AsyncStorage
-    case "set.string":
-    case "set.number":
-    case "set.boolean":
-    case "set.buffer":
-      return "SET";
-    case "delete":
-      return "REMOVE";
-    case "clearAll":
-      return "CLEAR";
-    case "get.string":
-    case "get.number":
-    case "get.boolean":
-    case "get.buffer":
-      return "GET";
-    default:
-      return "UNKNOWN ACTION";
-  }
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.translateStorageAction=translateStorageAction;function translateStorageAction(e){switch(e){case"setItem":return"SET";case"removeItem":return"REMOVE";case"mergeItem":return"MERGE";case"clear":return"CLEAR";case"multiSet":return"MULTI SET";case"multiRemove":return"MULTI REMOVE";case"multiMerge":return"MULTI MERGE";case"set.string":case"set.number":case"set.boolean":case"set.buffer":return"SET";case"delete":return"REMOVE";case"clearAll":return"CLEAR";case"get.string":case"get.number":case"get.boolean":case"get.buffer":return"GET";default:return"UNKNOWN ACTION"}}

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

@@ -1,49 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.onStorageBrowserRefresh = onStorageBrowserRefresh;
-exports.requestStorageBrowserRefresh = requestStorageBrowserRefresh;
-/**
- * A "the underlying storage changed, re-read it" signal for the storage
- * browser.
- *
- * On device the browser refreshes itself from the AsyncStorage/MMKV listeners,
- * but those never fire in remote-mirror mode (the desktop dashboard suppresses
- * local capture and receives the device's events as snapshots instead). Without
- * this seam the browse tab is a one-shot read at mount — values stay frozen
- * until the panel remounts, which is exactly the "shows old data until I switch
- * tools and come back" behaviour.
- *
- * The dashboard calls {@link requestStorageBrowserRefresh} whenever a fresh
- * device snapshot lands; the browser re-reads all three backends (debounced).
- * It is a no-op when nothing is listening.
- */
-
-const listeners = new Set();
-
-/**
- * Subscribe to external refresh requests. Returns an unsubscribe function.
- * @internal — used by the storage browser.
- */
-function onStorageBrowserRefresh(listener) {
-  listeners.add(listener);
-  return () => {
-    listeners.delete(listener);
-  };
-}
-
-/**
- * Ask any mounted storage browser to re-read AsyncStorage, MMKV and
- * SecureStore. Safe to call at any rate — the browser debounces.
- */
-function requestStorageBrowserRefresh() {
-  listeners.forEach(listener => {
-    try {
-      listener();
-    } catch {
-      // Listener errors are not ours
-    }
-  });
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.onStorageBrowserRefresh=onStorageBrowserRefresh;exports.requestStorageBrowserRefresh=requestStorageBrowserRefresh;const listeners=new Set;function onStorageBrowserRefresh(e){listeners.add(e);return()=>{listeners.delete(e)}}function requestStorageBrowserRefresh(){listeners.forEach(e=>{try{e()}catch{}})}

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

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

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.storageLabels=void 0;const storageLabels=exports.storageLabels={async:"Local",asyncFull:"localStorage",mmkv:"Session",secure:"Secure",hasSecure:false};

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

@@ -1,53 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.STORAGE_OPS = void 0;
-exports.isInitialScan = isInitialScan;
-exports.storageOpDot = storageOpDot;
-exports.storageOpOf = storageOpOf;
-var _sharedUi = require("@buoy-gg/shared-ui");
-/**
- * The five operations a storage event can be, and how to recognise one.
- *
- * AsyncStorage and MMKV each have their own action union, and neither maps
- * cleanly onto what a reader wants to see — `multiRemove`, `removeItem` and
- * `delete` are one idea wearing three names. These collapse both onto a single
- * vocabulary so every surface labels, filters and colours events the same way.
- *
- * This is semantics, not presentation: it lives in `utils` rather than beside
- * any one view, so a view can be deleted without taking the vocabulary with it.
- */
-
-const STORAGE_OPS = exports.STORAGE_OPS = ["SET", "GET", "MERGE", "DELETE", "CLEAR"];
-const OP_DOT = {
-  SET: _sharedUi.macOSColors.semantic.info,
-  GET: _sharedUi.macOSColors.text.muted,
-  MERGE: _sharedUi.macOSColors.semantic.debug,
-  DELETE: _sharedUi.macOSColors.semantic.error,
-  CLEAR: _sharedUi.macOSColors.semantic.warning
-};
-function storageOpDot(op) {
-  return OP_DOT[op];
-}
-
-/** Both backends' action unions, collapsed onto the five display operations. */
-function storageOpOf(event) {
-  const action = event.action;
-  if (action === "clear" || action === "clearAll") return "CLEAR";
-  if (action.startsWith("get.")) return "GET";
-  if (action === "removeItem" || action === "multiRemove" || action === "delete") return "DELETE";
-  if (action === "mergeItem" || action === "multiMerge") return "MERGE";
-  return "SET";
-}
-
-/**
- * The store synthesises one event per existing key when it first subscribes, so
- * the list isn't empty on open. Those are a SNAPSHOT, not a write: the key
- * already held that value, so there is no "before" to diff against and showing
- * one would invent a change that never happened.
- */
-function isInitialScan(event) {
-  return Boolean(event.data?.initialScan);
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.STORAGE_OPS=void 0;exports.isInitialScan=isInitialScan;exports.storageOpDot=storageOpDot;exports.storageOpOf=storageOpOf;var _sharedUi=require("@buoy-gg/shared-ui");const STORAGE_OPS=exports.STORAGE_OPS=["SET","GET","MERGE","DELETE","CLEAR"];const OP_DOT={SET:_sharedUi.macOSColors.semantic.info,GET:_sharedUi.macOSColors.text.muted,MERGE:_sharedUi.macOSColors.semantic.debug,DELETE:_sharedUi.macOSColors.semantic.error,CLEAR:_sharedUi.macOSColors.semantic.warning};function storageOpDot(t){return OP_DOT[t]}function storageOpOf(t){const e=t.action;if(e==="clear"||e==="clearAll")return"CLEAR";if(e.startsWith("get."))return"GET";if(e==="removeItem"||e==="multiRemove"||e==="delete")return"DELETE";if(e==="mergeItem"||e==="multiMerge")return"MERGE";return"SET"}function isInitialScan(t){return Boolean(t.data?.initialScan)}

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

@@ -1,35 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getStorageTypeHexColor = getStorageTypeHexColor;
-exports.getStorageTypeLabel = getStorageTypeLabel;
-var _sharedUi = require("@buoy-gg/shared-ui");
-/** Human readable label for a storage type id. */
-function getStorageTypeLabel(storageType) {
-  switch (storageType) {
-    case "mmkv":
-      return "MMKV";
-    case "async":
-      return "Async";
-    case "secure":
-      return "Secure";
-    default:
-      return storageType;
-  }
-}
-
-/** Preferred color token for rendering a given storage type. */
-function getStorageTypeHexColor(storageType) {
-  switch (storageType) {
-    case "mmkv":
-      return _sharedUi.gameUIColors.info;
-    case "async":
-      return _sharedUi.gameUIColors.warning;
-    case "secure":
-      return _sharedUi.gameUIColors.success;
-    default:
-      return _sharedUi.gameUIColors.muted;
-  }
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.getStorageTypeHexColor=getStorageTypeHexColor;exports.getStorageTypeLabel=getStorageTypeLabel;var _sharedUi=require("@buoy-gg/shared-ui");function getStorageTypeLabel(e){switch(e){case"mmkv":return"MMKV";case"async":return"Async";case"secure":return"Secure";default:return e}}function getStorageTypeHexColor(e){switch(e){case"mmkv":return _sharedUi.gameUIColors.info;case"async":return _sharedUi.gameUIColors.warning;case"secure":return _sharedUi.gameUIColors.success;default:return _sharedUi.gameUIColors.muted}}