@buoy-gg/storage 7.0.41 → 7.0.43

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

@@ -1,492 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.VALUE_ON_DEVICE = exports.SNAPSHOT_VALUE_INLINE_LIMIT = exports.SNAPSHOT_EVENTS_BUDGET = void 0;
-exports.setToolRequiredStorageKeys = setToolRequiredStorageKeys;
-exports.storageSyncAdapter = void 0;
-var _asyncStorage = _interopRequireDefault(require("@react-native-async-storage/async-storage"));
-var _sharedUi = require("@buoy-gg/shared-ui");
-var _asyncStorageCompat = require("../utils/asyncStorageCompat");
-var _storageEventStore = require("../stores/storageEventStore");
-var _clearAllStorage = require("../utils/clearAllStorage");
-var _storageTimeTravelUtils = require("../utils/storageTimeTravelUtils");
-var _MMKVInstanceRegistry = require("../utils/MMKVInstanceRegistry");
-var _mmkvTypeDetection = require("../utils/mmkvTypeDetection");
-var _SecureStoreRegistry = require("../utils/SecureStoreRegistry");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * 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`.
- */
-const VALUE_ON_DEVICE = exports.VALUE_ON_DEVICE = Object.freeze({
-  __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. */
-const SNAPSHOT_VALUE_INLINE_LIMIT = exports.SNAPSHOT_VALUE_INLINE_LIMIT = 16 * 1024;
-
-/**
- * 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.
- */
-const SNAPSHOT_EVENTS_BUDGET = exports.SNAPSHOT_EVENTS_BUDGET = 1.25 * 1024 * 1024;
-const MAX_EVENT_DETAIL_BYTES = 8 * 1024 * 1024;
-function toWireValue(value) {
-  if (value === undefined) return value;
-  return (0, _sharedUi.isOverWireBudget)(value, SNAPSHOT_VALUE_INLINE_LIMIT) ? VALUE_ON_DEVICE : value;
-}
-
-/**
- * Apply `map` to every payload field an event carries, preserving object
- * identity when nothing changed (the desktop mirror feeds these into effect
- * dependencies, so a fresh object per snapshot would re-run them).
- *
- * The cast is deliberate and load-bearing: the wire form intentionally puts a
- * marker OBJECT where the domain type declares a string, because the real
- * value stayed on the device. `StorageEvent` describes on-device truth; this
- * is its wire projection.
- */
-function mapEventValues(event, map) {
-  const data = event.data;
-  if (!data) return event;
-  const value = map(data.value);
-  const prevValue = map(data.prevValue);
-  const batch = (0, _storageEventStore.batchPairsOf)(event);
-  const pairs = map(batch.pairs);
-  const prevPairs = map(batch.prevPairs);
-  if (value === data.value && prevValue === data.prevValue && pairs === batch.pairs && prevPairs === batch.prevPairs) {
-    return event;
-  }
-  return {
-    ...event,
-    data: {
-      ...data,
-      value,
-      prevValue,
-      // Only AsyncStorage events have these; see batchPairsOf.
-      ...(event.storageType === "async" ? {
-        pairs,
-        prevPairs
-      } : {})
-    }
-  };
-}
-function capDetailValue(value) {
-  if (value === undefined) return value;
-  if (!(0, _sharedUi.isOverWireBudget)(value, MAX_EVENT_DETAIL_BYTES)) return value;
-  return (0, _sharedUi.isJsonSerializable)(value) ? {
-    __buoyTruncated: true,
-    note: `Exceeds the ${MAX_EVENT_DETAIL_BYTES / (1024 * 1024)}MB detail limit — inspect it on-device.`
-  } : VALUE_ON_DEVICE;
-}
-
-/** One event's wire form plus its measured cost, so the budget pass is free. */
-
-/**
- * Per-event wire cache. The store never mutates an event in place — `addEvent`
- * prepends and `hydrateEvent` replaces — so keying on identity is correct and
- * self-invalidating. Without it every value is re-measured on all ~5 snapshots
- * per second for as long as it stays in the list, which for storage means
- * re-walking megabytes of strings per tick.
- */
-const wireCache = new WeakMap();
-const strippedCache = new WeakMap();
-function wireFor(event) {
-  const cached = wireCache.get(event);
-  if (cached) return cached;
-  let entry;
-  try {
-    const wire = mapEventValues(event, toWireValue);
-    entry = {
-      event: wire,
-      bytes: (0, _sharedUi.approxJsonSize)(wire, SNAPSHOT_EVENTS_BUDGET).bytes
-    };
-  } catch {
-    // A hostile getter can blow up the walk itself. Degrading this ONE event
-    // beats letting getSnapshot throw and taking the whole panel with it.
-    const wire = mapEventValues(event, () => VALUE_ON_DEVICE);
-    entry = {
-      event: wire,
-      bytes: 1024
-    };
-  }
-  wireCache.set(event, entry);
-  return entry;
-}
-
-/** Metadata-only form for the tail of the list once the budget is spent. */
-function strippedFor(event) {
-  const cached = strippedCache.get(event);
-  if (cached) return cached;
-  const wire = mapEventValues(event, v => v === undefined ? undefined : VALUE_ON_DEVICE);
-  const entry = {
-    event: wire,
-    bytes: (0, _sharedUi.approxJsonSize)(wire, SNAPSHOT_EVENTS_BUDGET).bytes
-  };
-  strippedCache.set(event, entry);
-  return entry;
-}
-
-/**
- * Spend the snapshot budget newest-first. The store keeps events newest-first,
- * so the developer keeps full detail on what they are actually looking at and
- * the tail degrades rather than the whole panel being dropped.
- */
-function fitEventsToBudget(events) {
-  const out = new Array(events.length);
-  let spent = 0;
-  for (let i = 0; i < events.length; i++) {
-    const full = wireFor(events[i]);
-    if (spent + full.bytes <= SNAPSHOT_EVENTS_BUDGET) {
-      out[i] = full.event;
-      spent += full.bytes;
-    } else {
-      const lean = strippedFor(events[i]);
-      out[i] = lean.event;
-      spent += lean.bytes;
-    }
-  }
-  return out;
-}
-
-/** One MMKV entry in a `mmkv.snapshot` result. */
-
-/** One MMKV instance in a `mmkv.snapshot` result. */
-
-/** One registered key in a `secure.snapshot` result. */
-
-/**
- * Resolve an MMKV instance for WRITING, refusing the ones the app registered
- * read-only.
- *
- * The registry has always tracked `readOnly`, but nothing enforced it: any sync
- * client — dashboard or MCP — could write to an instance the app explicitly
- * declared immutable. That was harmless while the tool could only read; it
- * stops being harmless the moment there's an edit UI pointed at it.
- */
-function assertMMKVWritable(instanceId) {
-  const registered = _MMKVInstanceRegistry.mmkvInstanceRegistry.get(instanceId);
-  if (!registered) {
-    throw new Error(`No MMKV instance registered as "${instanceId}"`);
-  }
-  if (registered.instance?.isReadOnly) {
-    throw new Error(`MMKV instance "${instanceId}" is registered read-only`);
-  }
-  return registered.instance;
-}
-
-/**
- * Sync adapter for the storage tool, consumed by @buoy-gg/external-sync's
- * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
- * this package doesn't need a dependency on it).
- *
- * Subscribing starts the underlying capture lifecycle (including the initial
- * key scan), so storage events are only recorded while a dashboard is
- * watching.
- *
- * The `async.*` actions mirror the AsyncStorage API so the desktop dashboard
- * can proxy its browse/edit mode against the device's real storage.
- *
- * v2: oversized / unserializable event values are replaced with
- * VALUE_ON_DEVICE. Dashboards fetch them via `getEventDetail`.
- */
-let toolRequiredStorageKeys = [];
-
-/**
- * Called by `createStorageTool` so remote dashboards validate against the
- * same required keys as the on-device tool. The desktop panel used to have no
- * way to learn them and showed every key as unchecked.
- */
-function setToolRequiredStorageKeys(keys) {
-  toolRequiredStorageKeys = keys;
-}
-const storageSyncAdapter = exports.storageSyncAdapter = {
-  // v3: a total snapshot budget, so a burst of individually-legal values
-  // degrades the oldest events instead of the emit layer dropping the panel.
-  version: 3,
-  // Strip Buoy's OWN devtool keys (@react_buoy*, @buoy*, buoy-*, legacy) at the
-  // source so no sync client (desktop, MCP, raw socket) ever sees them as if
-  // they were app data — matching the tools' default key filters, but
-  // authoritative instead of UI-only.
-  getSnapshot: () => fitEventsToBudget(_storageEventStore.storageEventStore.getEvents().filter(e => {
-    const key = e.data?.key;
-    return !(typeof key === "string" && (0, _sharedUi.isDevToolsStorageKey)(key));
-  })),
-  subscribe: onChange => _storageEventStore.storageEventStore.subscribeToEvents(onChange),
-  actions: {
-    clearEvents: () => {
-      _storageEventStore.storageEventStore.clearEvents();
-    },
-    /** The app's required storage keys, as given to `createStorageTool`. */
-    getRequiredKeys: () => toolRequiredStorageKeys,
-    /**
-     * 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 => {
-      const {
-        id
-      } = params ?? {};
-      if (!id) return {
-        found: false,
-        reason: "missing id"
-      };
-      const event = _storageEventStore.storageEventStore.getEvents().find(e => e.id === id);
-      if (!event) return {
-        found: false,
-        reason: "unknown id"
-      };
-      const detailed = mapEventValues(event, capDetailValue);
-      return {
-        found: true,
-        id,
-        event: detailed
-      };
-    },
-    /** Clears all app storage keys, preserving dev tools settings. */
-    clearAppStorage: () => (0, _clearAllStorage.clearAllAppStorage)(),
-    // ── Time travel (same code path as the modal's UNDO / JUMP buttons) ──
-    // The UI swallows failures silently; these THROW so a caller (desktop, MCP)
-    // gets the actual reason back instead of a no-op.
-
-    /** Undo one event, addressed by the `id` the store assigned it. */
-    "timeTravel.undo": async params => {
-      const id = params?.id;
-      if (!id) throw new Error("timeTravel.undo requires an event `id`");
-      const event = _storageEventStore.storageEventStore.getEvents().find(e => e.id === id);
-      if (!event) throw new Error(`No storage event with id "${id}"`);
-      if (event.storageType === "mmkv") {
-        throw new Error("Time travel supports AsyncStorage events only");
-      }
-      const asyncEvent = event;
-      if (!(0, _storageTimeTravelUtils.canUndo)(asyncEvent)) {
-        throw new Error(`Event "${id}" (${asyncEvent.action}) has no previous value captured, so it cannot be undone`);
-      }
-      await (0, _storageTimeTravelUtils.undoOperation)(asyncEvent);
-      return {
-        undone: true,
-        action: asyncEvent.action,
-        key: asyncEvent.data?.key
-      };
-    },
-    /**
-     * Jump storage back to the state as of one event. `scope: "key"` (default)
-     * replays only that key's history, matching the modal's JUMP button;
-     * `scope: "all"` replays every captured AsyncStorage event.
-     */
-    "timeTravel.jump": async params => {
-      const {
-        id,
-        scope = "key"
-      } = params ?? {};
-      if (!id) throw new Error("timeTravel.jump requires an event `id`");
-
-      // Oldest-first, which is the order jumpToState replays in.
-      const all = _storageEventStore.storageEventStore.getEvents().filter(e => e.storageType !== "mmkv").slice().reverse();
-      const target = all.find(e => e.id === id);
-      if (!target) throw new Error(`No AsyncStorage event with id "${id}"`);
-      const timeline = scope === "all" ? all : all.filter(e => e.data?.key === target.data?.key);
-      const index = timeline.findIndex(e => e.id === id);
-      if (index === -1) throw new Error(`Event "${id}" is not in the timeline`);
-      await (0, _storageTimeTravelUtils.jumpToState)(timeline, index);
-      return {
-        jumped: true,
-        scope,
-        replayed: index + 1,
-        of: timeline.length,
-        key: target.data?.key
-      };
-    },
-    // ── Remote AsyncStorage proxy (desktop browse/edit mode) ──
-    // Single-item methods share the same signature across async-storage v2/v3;
-    // batch methods go through the compat helpers (which translate to v3's
-    // getMany/setMany/removeMany) and keep the v2 tuple/pairs shape on the wire.
-    // Read paths filter out Buoy's own devtool keys so they're never exposed.
-    "async.getAllKeys": async () => (await _asyncStorage.default.getAllKeys()).filter(k => !(0, _sharedUi.isDevToolsStorageKey)(k)),
-    "async.multiGet": async params => (await (0, _asyncStorageCompat.readMany)(params.keys)).filter(([k]) => !(0, _sharedUi.isDevToolsStorageKey)(k)),
-    "async.getItem": params => {
-      const {
-        key
-      } = params;
-      return (0, _sharedUi.isDevToolsStorageKey)(key) ? Promise.resolve(null) : _asyncStorage.default.getItem(key);
-    },
-    "async.setItem": params => {
-      const {
-        key,
-        value
-      } = params;
-      return _asyncStorage.default.setItem(key, value);
-    },
-    "async.removeItem": params => _asyncStorage.default.removeItem(params.key),
-    "async.multiRemove": params => (0, _asyncStorageCompat.removeMany)(params.keys),
-    "async.multiSet": params => (0, _asyncStorageCompat.writeMany)(params.pairs),
-    "async.clear": () => _asyncStorage.default.clear(),
-    // ── Remote MMKV proxy (desktop browse mode + MCP) ──
-    // MMKV has no remote presence off-device; these read/write the registered
-    // instances so sync clients can browse them like AsyncStorage.
-    "mmkv.snapshot": () => _MMKVInstanceRegistry.mmkvInstanceRegistry.getAll().map(({
-      id,
-      instance,
-      encrypted,
-      readOnly
-    }) => {
-      let entries = [];
-      try {
-        entries = instance.getAllKeys().filter(key => !(0, _sharedUi.isDevToolsStorageKey)(key)).map(key => {
-          const {
-            value,
-            type: valueType
-          } = (0, _mmkvTypeDetection.detectMMKVType)(instance, key);
-          return {
-            key,
-            value: toWireValue(value),
-            valueType
-          };
-        });
-      } catch {
-        // Instance unreadable — return it with no entries rather than failing
-      }
-      return {
-        id,
-        encrypted,
-        readOnly,
-        entries
-      };
-    }),
-    /**
-     * 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 => {
-      const {
-        instanceId,
-        key
-      } = params ?? {};
-      if (!instanceId || !key) {
-        return {
-          found: false,
-          reason: "missing instanceId/key"
-        };
-      }
-      const registered = _MMKVInstanceRegistry.mmkvInstanceRegistry.get(instanceId);
-      if (!registered) {
-        return {
-          found: false,
-          reason: "unknown instance"
-        };
-      }
-      const {
-        value,
-        type: valueType
-      } = (0, _mmkvTypeDetection.detectMMKVType)(registered.instance, key);
-      return {
-        found: true,
-        instanceId,
-        key,
-        value: capDetailValue(value),
-        valueType
-      };
-    },
-    "mmkv.set": params => {
-      const {
-        instanceId,
-        key,
-        value
-      } = params;
-      assertMMKVWritable(instanceId).set(key, value);
-    },
-    "mmkv.remove": params => {
-      const {
-        instanceId,
-        key
-      } = params;
-      const instance = assertMMKVWritable(instanceId);
-      // v4 renamed delete() to remove() — support both
-      if (instance.remove) instance.remove(key);else instance.delete?.(key);
-    },
-    // ── Remote SecureStore proxy ──
-    // Only registered keys are known (SecureStore has no enumeration API).
-    // Biometric-protected keys are never read — reads would fire an auth prompt.
-    "secure.keys": () => _SecureStoreRegistry.secureStoreRegistry.getAll().map(({
-      key,
-      options,
-      description
-    }) => ({
-      key,
-      description,
-      keychainService: options.keychainService,
-      requireAuthentication: options.requireAuthentication ?? false
-    })),
-    /**
-     * Every registered key WITH its value, in one round trip — the SecureStore
-     * counterpart to `mmkv.snapshot`. The dashboard polls this (the keychain
-     * has no change feed) and serves the browser from the result, instead of
-     * firing one `secure.get` per key per refresh.
-     */
-    "secure.snapshot": async () => {
-      const module = _SecureStoreRegistry.secureStoreRegistry.getModule();
-      const entries = _SecureStoreRegistry.secureStoreRegistry.getAll();
-      const result = [];
-      for (const {
-        key,
-        options,
-        description
-      } of entries) {
-        let value = null;
-        // Biometric-protected keys are never read — that would fire an auth prompt.
-        if (module && !options.requireAuthentication) {
-          try {
-            value = await module.getItemAsync(key, options);
-          } catch {
-            // Unreadable (e.g. keychain state changed) — report as unset
-          }
-        }
-        result.push({
-          key,
-          description,
-          keychainService: options.keychainService,
-          requireAuthentication: options.requireAuthentication ?? false,
-          value: value == null ? value : toWireValue(value)
-        });
-      }
-      return result;
-    },
-    "secure.get": params => {
-      const {
-        key
-      } = params;
-      const entry = _SecureStoreRegistry.secureStoreRegistry.getAll().find(e => e.key === key);
-      const module = _SecureStoreRegistry.secureStoreRegistry.getModule();
-      if (!entry || !module || entry.options.requireAuthentication) {
-        return Promise.resolve(null);
-      }
-      return module.getItemAsync(key, entry.options);
-    },
-    /**
-     * Write a registered SecureStore key. Goes through the registry so the
-     * value is written with the SAME options it was registered with — writing
-     * with different `keychainService` options creates a second entry the app
-     * can't read. Biometric-protected keys throw rather than prompting.
-     */
-    "secure.set": params => {
-      const {
-        key,
-        value
-      } = params;
-      return _SecureStoreRegistry.secureStoreRegistry.setValue(key, value);
-    },
-    "secure.delete": params => _SecureStoreRegistry.secureStoreRegistry.deleteValue(params.key)
-  }
-};
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.VALUE_ON_DEVICE=exports.SNAPSHOT_VALUE_INLINE_LIMIT=exports.SNAPSHOT_EVENTS_BUDGET=void 0;exports.setToolRequiredStorageKeys=setToolRequiredStorageKeys;exports.storageSyncAdapter=void 0;var _asyncStorage=_interopRequireDefault(require("@react-native-async-storage/async-storage"));var _sharedUi=require("@buoy-gg/shared-ui");var _asyncStorageCompat=require("../utils/asyncStorageCompat");var _storageEventStore=require("../stores/storageEventStore");var _clearAllStorage=require("../utils/clearAllStorage");var _storageTimeTravelUtils=require("../utils/storageTimeTravelUtils");var _MMKVInstanceRegistry=require("../utils/MMKVInstanceRegistry");var _mmkvTypeDetection=require("../utils/mmkvTypeDetection");var _SecureStoreRegistry=require("../utils/SecureStoreRegistry");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const VALUE_ON_DEVICE=exports.VALUE_ON_DEVICE=Object.freeze({__buoyValueOnDevice:true,note:"Value stays on the device \u2014 fetched on demand via getEventDetail / mmkv.get / secure.get."});const SNAPSHOT_VALUE_INLINE_LIMIT=exports.SNAPSHOT_VALUE_INLINE_LIMIT=16*1024;const SNAPSHOT_EVENTS_BUDGET=exports.SNAPSHOT_EVENTS_BUDGET=1.25*1024*1024;const MAX_EVENT_DETAIL_BYTES=8*1024*1024;function toWireValue(e){if(e===void 0)return e;return(0,_sharedUi.isOverWireBudget)(e,SNAPSHOT_VALUE_INLINE_LIMIT)?VALUE_ON_DEVICE:e}function mapEventValues(e,t){const r=e.data;if(!r)return e;const n=t(r.value);const s=t(r.prevValue);const o=(0,_storageEventStore.batchPairsOf)(e);const i=t(o.pairs);const a=t(o.prevPairs);if(n===r.value&&s===r.prevValue&&i===o.pairs&&a===o.prevPairs){return e}return{...e,data:{...r,value:n,prevValue:s,...e.storageType==="async"?{pairs:i,prevPairs:a}:{}}}}function capDetailValue(e){if(e===void 0)return e;if(!(0,_sharedUi.isOverWireBudget)(e,MAX_EVENT_DETAIL_BYTES))return e;return(0,_sharedUi.isJsonSerializable)(e)?{__buoyTruncated:true,note:`Exceeds the ${MAX_EVENT_DETAIL_BYTES/(1024*1024)}MB detail limit \u2014 inspect it on-device.`}:VALUE_ON_DEVICE}const wireCache=new WeakMap;const strippedCache=new WeakMap;function wireFor(e){const t=wireCache.get(e);if(t)return t;let r;try{const n=mapEventValues(e,toWireValue);r={event:n,bytes:(0,_sharedUi.approxJsonSize)(n,SNAPSHOT_EVENTS_BUDGET).bytes}}catch{const n=mapEventValues(e,()=>VALUE_ON_DEVICE);r={event:n,bytes:1024}}wireCache.set(e,r);return r}function strippedFor(e){const t=strippedCache.get(e);if(t)return t;const r=mapEventValues(e,s=>s===void 0?void 0:VALUE_ON_DEVICE);const n={event:r,bytes:(0,_sharedUi.approxJsonSize)(r,SNAPSHOT_EVENTS_BUDGET).bytes};strippedCache.set(e,n);return n}function fitEventsToBudget(e){const t=new Array(e.length);let r=0;for(let n=0;n<e.length;n++){const s=wireFor(e[n]);if(r+s.bytes<=SNAPSHOT_EVENTS_BUDGET){t[n]=s.event;r+=s.bytes}else{const o=strippedFor(e[n]);t[n]=o.event;r+=o.bytes}}return t}function assertMMKVWritable(e){const t=_MMKVInstanceRegistry.mmkvInstanceRegistry.get(e);if(!t){throw new Error(`No MMKV instance registered as "${e}"`)}if(t.instance?.isReadOnly){throw new Error(`MMKV instance "${e}" is registered read-only`)}return t.instance}let toolRequiredStorageKeys=[];function setToolRequiredStorageKeys(e){toolRequiredStorageKeys=e}const storageSyncAdapter=exports.storageSyncAdapter={version:3,getSnapshot:()=>fitEventsToBudget(_storageEventStore.storageEventStore.getEvents().filter(e=>{const t=e.data?.key;return!(typeof t==="string"&&(0,_sharedUi.isDevToolsStorageKey)(t))})),subscribe:e=>_storageEventStore.storageEventStore.subscribeToEvents(e),actions:{clearEvents:()=>{_storageEventStore.storageEventStore.clearEvents()},getRequiredKeys:()=>toolRequiredStorageKeys,getEventDetail:e=>{const{id:t}=e??{};if(!t)return{found:false,reason:"missing id"};const r=_storageEventStore.storageEventStore.getEvents().find(s=>s.id===t);if(!r)return{found:false,reason:"unknown id"};const n=mapEventValues(r,capDetailValue);return{found:true,id:t,event:n}},clearAppStorage:()=>(0,_clearAllStorage.clearAllAppStorage)(),"timeTravel.undo":async e=>{const t=e?.id;if(!t)throw new Error("timeTravel.undo requires an event `id`");const r=_storageEventStore.storageEventStore.getEvents().find(s=>s.id===t);if(!r)throw new Error(`No storage event with id "${t}"`);if(r.storageType==="mmkv"){throw new Error("Time travel supports AsyncStorage events only")}const n=r;if(!(0,_storageTimeTravelUtils.canUndo)(n)){throw new Error(`Event "${t}" (${n.action}) has no previous value captured, so it cannot be undone`)}await(0,_storageTimeTravelUtils.undoOperation)(n);return{undone:true,action:n.action,key:n.data?.key}},"timeTravel.jump":async e=>{const{id:t,scope:r="key"}=e??{};if(!t)throw new Error("timeTravel.jump requires an event `id`");const n=_storageEventStore.storageEventStore.getEvents().filter(a=>a.storageType!=="mmkv").slice().reverse();const s=n.find(a=>a.id===t);if(!s)throw new Error(`No AsyncStorage event with id "${t}"`);const o=r==="all"?n:n.filter(a=>a.data?.key===s.data?.key);const i=o.findIndex(a=>a.id===t);if(i===-1)throw new Error(`Event "${t}" is not in the timeline`);await(0,_storageTimeTravelUtils.jumpToState)(o,i);return{jumped:true,scope:r,replayed:i+1,of:o.length,key:s.data?.key}},"async.getAllKeys":async()=>(await _asyncStorage.default.getAllKeys()).filter(e=>!(0,_sharedUi.isDevToolsStorageKey)(e)),"async.multiGet":async e=>(await(0,_asyncStorageCompat.readMany)(e.keys)).filter(([t])=>!(0,_sharedUi.isDevToolsStorageKey)(t)),"async.getItem":e=>{const{key:t}=e;return(0,_sharedUi.isDevToolsStorageKey)(t)?Promise.resolve(null):_asyncStorage.default.getItem(t)},"async.setItem":e=>{const{key:t,value:r}=e;return _asyncStorage.default.setItem(t,r)},"async.removeItem":e=>_asyncStorage.default.removeItem(e.key),"async.multiRemove":e=>(0,_asyncStorageCompat.removeMany)(e.keys),"async.multiSet":e=>(0,_asyncStorageCompat.writeMany)(e.pairs),"async.clear":()=>_asyncStorage.default.clear(),"mmkv.snapshot":()=>_MMKVInstanceRegistry.mmkvInstanceRegistry.getAll().map(({id:e,instance:t,encrypted:r,readOnly:n})=>{let s=[];try{s=t.getAllKeys().filter(o=>!(0,_sharedUi.isDevToolsStorageKey)(o)).map(o=>{const{value:i,type:a}=(0,_mmkvTypeDetection.detectMMKVType)(t,o);return{key:o,value:toWireValue(i),valueType:a}})}catch{}return{id:e,encrypted:r,readOnly:n,entries:s}}),"mmkv.get":e=>{const{instanceId:t,key:r}=e??{};if(!t||!r){return{found:false,reason:"missing instanceId/key"}}const n=_MMKVInstanceRegistry.mmkvInstanceRegistry.get(t);if(!n){return{found:false,reason:"unknown instance"}}const{value:s,type:o}=(0,_mmkvTypeDetection.detectMMKVType)(n.instance,r);return{found:true,instanceId:t,key:r,value:capDetailValue(s),valueType:o}},"mmkv.set":e=>{const{instanceId:t,key:r,value:n}=e;assertMMKVWritable(t).set(r,n)},"mmkv.remove":e=>{const{instanceId:t,key:r}=e;const n=assertMMKVWritable(t);if(n.remove)n.remove(r);else n.delete?.(r)},"secure.keys":()=>_SecureStoreRegistry.secureStoreRegistry.getAll().map(({key:e,options:t,description:r})=>({key:e,description:r,keychainService:t.keychainService,requireAuthentication:t.requireAuthentication??false})),"secure.snapshot":async()=>{const e=_SecureStoreRegistry.secureStoreRegistry.getModule();const t=_SecureStoreRegistry.secureStoreRegistry.getAll();const r=[];for(const{key:n,options:s,description:o}of t){let i=null;if(e&&!s.requireAuthentication){try{i=await e.getItemAsync(n,s)}catch{}}r.push({key:n,description:o,keychainService:s.keychainService,requireAuthentication:s.requireAuthentication??false,value:i==null?i:toWireValue(i)})}return r},"secure.get":e=>{const{key:t}=e;const r=_SecureStoreRegistry.secureStoreRegistry.getAll().find(s=>s.key===t);const n=_SecureStoreRegistry.secureStoreRegistry.getModule();if(!r||!n||r.options.requireAuthentication){return Promise.resolve(null)}return n.getItemAsync(t,r.options)},"secure.set":e=>{const{key:t,value:r}=e;return _SecureStoreRegistry.secureStoreRegistry.setValue(t,r)},"secure.delete":e=>_SecureStoreRegistry.secureStoreRegistry.deleteValue(e.key)}};

package/lib/commonjs/storage/types.js

@@ -1,5 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});