@buoy-gg/storage 7.0.41 → 7.0.43

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

@@ -1,218 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.setStorageValue = setStorageValue;
-exports.storageEditBlockedReason = storageEditBlockedReason;
-exports.storageValueToEditableText = storageValueToEditableText;
-exports.structuredStorageValue = structuredStorageValue;
-exports.validateStorageValue = validateStorageValue;
-var _asyncStorage = _interopRequireDefault(require("@react-native-async-storage/async-storage"));
-var _SecureStoreRegistry = require("./SecureStoreRegistry");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * Writing a storage value back, in one place.
- *
- * The counterpart to `deleteStorageKeys` — and the same reasoning applies: each
- * backend writes differently, and a second copy of that fan-out is how one
- * backend quietly starts corrupting values.
- *
- * The hard part is NOT the write, it's the types:
- *
- * - **AsyncStorage** stores strings only. A value that was stored as JSON must
- *   stay valid JSON, or an object silently becomes a quoted string and the app
- *   that reads it breaks in a way that looks nothing like a devtools edit.
- * - **MMKV** is natively typed (string / number / boolean / buffer). Writing
- *   `"42"` over a number turns it into a string, so the original type is
- *   restored from `valueType`. Buffers can't round-trip at all — the snapshot
- *   only ever carried a `<ArrayBuffer n bytes>` placeholder.
- * - **SecureStore** stores strings, and biometric-protected keys are never
- *   touched (writing needs the same auth prompt reading does).
- *
- * Pro gating and confirmation are deliberately NOT here; they belong to the UI
- * that has the user's attention. This assumes the caller already asked.
- */
-
-/**
- * Why a key can't be edited, or null when it can. UI uses this both to hide the
- * edit affordance and to explain itself, rather than failing at save time.
- */
-function storageEditBlockedReason(storageKey, mmkvInstances = []) {
-  if (storageKey.storageType === "mmkv") {
-    if (storageKey.valueType === "buffer") {
-      return "Buffer values can't be edited — the tool only ever sees their byte length, not their contents.";
-    }
-    const instance = mmkvInstances.find(i => i.id === (storageKey.instanceId || "default"));
-    if (instance?.readOnly) {
-      return `MMKV instance "${instance.id}" is registered read-only.`;
-    }
-  }
-  if (storageKey.storageType === "secure") {
-    const entry = _SecureStoreRegistry.secureStoreRegistry.getAll().find(e => e.key === storageKey.key);
-    if (entry?.options.requireAuthentication) {
-      return "Biometric-protected keys can't be edited — writing one would fire an auth prompt.";
-    }
-    if (!_SecureStoreRegistry.secureStoreRegistry.getModule()) {
-      return "No SecureStore module is registered.";
-    }
-  }
-  return null;
-}
-
-/**
- * Validate `raw` for this key WITHOUT writing. Returns an error message, or
- * null when the text is acceptable. The editor calls this as you type.
- */
-function validateStorageValue(storageKey, raw) {
-  if (storageKey.storageType === "mmkv") {
-    const type = mmkvTargetType(storageKey);
-    if (type === "number") {
-      if (raw.trim() === "" || Number.isNaN(Number(raw))) {
-        return "Must be a number — this MMKV key is stored as a number.";
-      }
-    }
-    if (type === "boolean") {
-      const t = raw.trim().toLowerCase();
-      if (t !== "true" && t !== "false") {
-        return 'Must be "true" or "false" — this MMKV key is stored as a boolean.';
-      }
-    }
-    return null;
-  }
-
-  // AsyncStorage + SecureStore are string-valued. Only guard the case where
-  // the CURRENT value is structured: silently flattening an object into a
-  // string is the corruption worth preventing. A plain string stays free-form.
-  if (isStructured(storageKey.value)) {
-    try {
-      JSON.parse(raw);
-    } catch (e) {
-      return `This key holds JSON — ${e instanceof Error ? e.message : "invalid JSON"}`;
-    }
-  }
-  return null;
-}
-
-/**
- * The text an editor should open with: JSON pretty-printed so it's actually
- * editable, everything else verbatim.
- */
-function storageValueToEditableText(value) {
-  if (value === undefined || value === null) return "";
-  if (typeof value === "string") {
-    // Values arrive already parsed when they were JSON, so a string here is a
-    // real string — except AsyncStorage hands back raw JSON text sometimes.
-    const trimmed = value.trim();
-    if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
-      try {
-        return JSON.stringify(JSON.parse(value), null, 2);
-      } catch {
-        return value;
-      }
-    }
-    return value;
-  }
-  if (typeof value === "object") return JSON.stringify(value, null, 2);
-  return String(value);
-}
-
-/**
- * The value as a STRUCTURE, for the tree editor to apply ops against.
- *
- * Backends disagree on how far they've already parsed: `useAsyncStorageKeys`
- * hands back a parsed object, while MMKV reports its native type so a JSON blob
- * arrives as the raw string. Both have to end up as the same thing before an op
- * can address a path inside them.
- *
- * Returns `undefined` when the value isn't a container — scalars are edited
- * through the plain value editor, not the tree.
- */
-function structuredStorageValue(storageKey) {
-  const {
-    value
-  } = storageKey;
-  if (value !== null && typeof value === "object") return value;
-  if (typeof value === "string") {
-    const trimmed = value.trim();
-    if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return undefined;
-    try {
-      const parsed = JSON.parse(value);
-      return parsed !== null && typeof parsed === "object" ? parsed : undefined;
-    } catch {
-      return undefined;
-    }
-  }
-  return undefined;
-}
-
-/**
- * Write `raw` to whichever backend holds this key, restoring the value's
- * original type. Rejects (rather than writing something lossy) when the key
- * isn't editable or the text doesn't fit the type — callers surface that.
- */
-async function setStorageValue(storageKey, raw, mmkvInstances = []) {
-  const blocked = storageEditBlockedReason(storageKey, mmkvInstances);
-  if (blocked) throw new Error(blocked);
-  const invalid = validateStorageValue(storageKey, raw);
-  if (invalid) throw new Error(invalid);
-  switch (storageKey.storageType) {
-    case "async":
-      {
-        await _asyncStorage.default.setItem(storageKey.key, normalizeJsonText(storageKey, raw));
-        return;
-      }
-    case "secure":
-      {
-        await _SecureStoreRegistry.secureStoreRegistry.setValue(storageKey.key, normalizeJsonText(storageKey, raw));
-        return;
-      }
-    case "mmkv":
-      {
-        const instanceId = storageKey.instanceId || "default";
-        const target = mmkvInstances.find(i => i.id === instanceId);
-        if (!target) {
-          throw new Error(`MMKV instance "${instanceId}" is not registered.`);
-        }
-        target.instance.set(storageKey.key, coerceMMKV(storageKey, raw));
-        return;
-      }
-    default:
-      {
-        throw new Error(`Unsupported storage type "${String(storageKey.storageType)}"`);
-      }
-  }
-}
-
-/** True when the value is an object/array (so its text must stay valid JSON). */
-function isStructured(value) {
-  return value !== null && typeof value === "object";
-}
-
-/**
- * Re-serialize JSON so the stored string is compact and canonical, matching
- * what the app itself would have written with `JSON.stringify`. Free-form
- * strings pass through untouched.
- */
-function normalizeJsonText(storageKey, raw) {
-  if (!isStructured(storageKey.value)) return raw;
-  return JSON.stringify(JSON.parse(raw));
-}
-
-/** The MMKV native type to write back, defaulting to the current JS type. */
-function mmkvTargetType(storageKey) {
-  if (storageKey.valueType) return storageKey.valueType;
-  if (typeof storageKey.value === "number") return "number";
-  if (typeof storageKey.value === "boolean") return "boolean";
-  return "string";
-}
-function coerceMMKV(storageKey, raw) {
-  switch (mmkvTargetType(storageKey)) {
-    case "number":
-      return Number(raw);
-    case "boolean":
-      return raw.trim().toLowerCase() === "true";
-    default:
-      return raw;
-  }
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.setStorageValue=setStorageValue;exports.storageEditBlockedReason=storageEditBlockedReason;exports.storageValueToEditableText=storageValueToEditableText;exports.structuredStorageValue=structuredStorageValue;exports.validateStorageValue=validateStorageValue;var _asyncStorage=_interopRequireDefault(require("@react-native-async-storage/async-storage"));var _SecureStoreRegistry=require("./SecureStoreRegistry");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}function storageEditBlockedReason(e,t=[]){if(e.storageType==="mmkv"){if(e.valueType==="buffer"){return"Buffer values can't be edited \u2014 the tool only ever sees their byte length, not their contents."}const r=t.find(n=>n.id===(e.instanceId||"default"));if(r?.readOnly){return`MMKV instance "${r.id}" is registered read-only.`}}if(e.storageType==="secure"){const r=_SecureStoreRegistry.secureStoreRegistry.getAll().find(n=>n.key===e.key);if(r?.options.requireAuthentication){return"Biometric-protected keys can't be edited \u2014 writing one would fire an auth prompt."}if(!_SecureStoreRegistry.secureStoreRegistry.getModule()){return"No SecureStore module is registered."}}return null}function validateStorageValue(e,t){if(e.storageType==="mmkv"){const r=mmkvTargetType(e);if(r==="number"){if(t.trim()===""||Number.isNaN(Number(t))){return"Must be a number \u2014 this MMKV key is stored as a number."}}if(r==="boolean"){const n=t.trim().toLowerCase();if(n!=="true"&&n!=="false"){return'Must be "true" or "false" \u2014 this MMKV key is stored as a boolean.'}}return null}if(isStructured(e.value)){try{JSON.parse(t)}catch(r){return`This key holds JSON \u2014 ${r instanceof Error?r.message:"invalid JSON"}`}}return null}function storageValueToEditableText(e){if(e===void 0||e===null)return"";if(typeof e==="string"){const t=e.trim();if(t.startsWith("{")||t.startsWith("[")){try{return JSON.stringify(JSON.parse(e),null,2)}catch{return e}}return e}if(typeof e==="object")return JSON.stringify(e,null,2);return String(e)}function structuredStorageValue(e){const{value:t}=e;if(t!==null&&typeof t==="object")return t;if(typeof t==="string"){const r=t.trim();if(!r.startsWith("{")&&!r.startsWith("["))return void 0;try{const n=JSON.parse(t);return n!==null&&typeof n==="object"?n:void 0}catch{return void 0}}return void 0}async function setStorageValue(e,t,r=[]){const n=storageEditBlockedReason(e,r);if(n)throw new Error(n);const i=validateStorageValue(e,t);if(i)throw new Error(i);switch(e.storageType){case"async":{await _asyncStorage.default.setItem(e.key,normalizeJsonText(e,t));return}case"secure":{await _SecureStoreRegistry.secureStoreRegistry.setValue(e.key,normalizeJsonText(e,t));return}case"mmkv":{const u=e.instanceId||"default";const o=r.find(s=>s.id===u);if(!o){throw new Error(`MMKV instance "${u}" is not registered.`)}o.instance.set(e.key,coerceMMKV(e,t));return}default:{throw new Error(`Unsupported storage type "${String(e.storageType)}"`)}}}function isStructured(e){return e!==null&&typeof e==="object"}function normalizeJsonText(e,t){if(!isStructured(e.value))return t;return JSON.stringify(JSON.parse(t))}function mmkvTargetType(e){if(e.valueType)return e.valueType;if(typeof e.value==="number")return"number";if(typeof e.value==="boolean")return"boolean";return"string"}function coerceMMKV(e,t){switch(mmkvTargetType(e)){case"number":return Number(t);case"boolean":return t.trim().toLowerCase()==="true";default:return t}}

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"}}