@buoy-gg/storage 7.0.41 → 7.0.43

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

@@ -1,281 +1 @@
-"use strict";
-
-/**
- * Storage Time-Travel Utilities
- *
- * Provides jump and undo functionality for AsyncStorage operations.
- */
-
-import { isDevToolsStorageKey } from "@buoy-gg/shared-ui";
-import AsyncStorage from "@react-native-async-storage/async-storage";
-import { writeMany, removeMany } from "./asyncStorageCompat";
-function isOmittedStorageValue(value) {
-  return !!value && typeof value === "object" && value.__buoyValueOnDevice === true;
-}
-
-/**
- * Undo a single storage operation
- *
- * Restores the previous value(s) before the operation occurred.
- *
- * The restore is deliberately NOT capture-paused. Pausing it meant the write
- * landed but emitted no event, so the modal's event list and current-value
- * panel never changed — UNDO looked like a dead button even though it had
- * worked. Letting the restore emit normally makes it visible and keeps the
- * history honest about what the storage actually did. There is no feedback
- * loop: a write emits an event, and an event never triggers a write.
- *
- * @param event - The storage event to undo
- */
-export async function undoOperation(event) {
-  const {
-    action,
-    data
-  } = event;
-  if (isOmittedStorageValue(data?.prevValue) || isOmittedStorageValue(data?.prevPairs)) {
-    throw new Error("Cannot undo: previous value is still on the device — fetch getEventDetail first");
-  }
-  {
-    switch (action) {
-      case "setItem":
-      case "mergeItem":
-        if (data?.key) {
-          if (data.prevValue === null || data.prevValue === undefined) {
-            // Key didn't exist before, remove it
-            await AsyncStorage.removeItem(data.key);
-          } else {
-            // Restore previous value
-            await AsyncStorage.setItem(data.key, data.prevValue);
-          }
-        }
-        break;
-      case "removeItem":
-        if (data?.key && data.prevValue !== null && data.prevValue !== undefined) {
-          // Restore the removed value
-          await AsyncStorage.setItem(data.key, data.prevValue);
-        }
-        break;
-      case "multiSet":
-      case "multiMerge":
-        if (data?.prevPairs && data.prevPairs.length > 0) {
-          // Restore all previous values
-          for (const [key, value] of data.prevPairs) {
-            if (value === null) {
-              await AsyncStorage.removeItem(key);
-            } else {
-              await AsyncStorage.setItem(key, value);
-            }
-          }
-        }
-        break;
-      case "multiRemove":
-        if (data?.prevPairs && data.prevPairs.length > 0) {
-          // Restore all removed values
-          for (const [key, value] of data.prevPairs) {
-            if (value !== null) {
-              await AsyncStorage.setItem(key, value);
-            }
-          }
-        }
-        break;
-      case "clear":
-        if (data?.prevPairs && data.prevPairs.length > 0) {
-          // Restore all cleared key-value pairs
-          const pairsToRestore = data.prevPairs.filter(([, value]) => value !== null);
-          if (pairsToRestore.length > 0) {
-            await writeMany(pairsToRestore);
-          }
-        }
-        break;
-      default:
-        throw new Error(`Cannot undo unknown action type: ${action}`);
-    }
-  }
-}
-
-/**
- * Jump to a specific point in storage history
- *
- * Reconstructs the state as of `targetEventIndex` by replaying `events` up to
- * that point, then reconciling ONLY the keys that timeline governs.
- *
- * This used to begin with `AsyncStorage.clear()`, which was badly out of
- * proportion: the modal's JUMP button passes one key's history, so clearing
- * wiped every unrelated app key — and Buoy's own `@react_buoy*` settings with
- * them — to restore a single value. Now a jump touches exactly the keys that
- * appear in the events it was given, and never Buoy's own keys. Like
- * [undoOperation], the writes emit normally so the change is visible.
- *
- * @param events - All events in chronological order (oldest first)
- * @param targetEventIndex - The index of the event to jump to (0-based)
- */
-export async function jumpToState(events, targetEventIndex) {
-  if (targetEventIndex < 0 || targetEventIndex >= events.length) {
-    throw new Error(`Invalid event index: ${targetEventIndex}`);
-  }
-  for (const event of events) {
-    const data = event.data;
-    if (isOmittedStorageValue(data?.value) || isOmittedStorageValue(data?.prevValue) || isOmittedStorageValue(data?.pairs) || isOmittedStorageValue(data?.prevPairs)) {
-      throw new Error("Cannot jump: some event values are still on the device — fetch getEventDetail first");
-    }
-  }
-
-  // Build up the state by applying each event up to and including the target.
-  // We use the final values from each event, not the operations themselves.
-  const stateMap = new Map();
-  for (let i = 0; i <= targetEventIndex; i++) {
-    applyEventToStateMap(events[i], stateMap);
-  }
-
-  // Every key the WHOLE timeline touches — including events after the target,
-  // so a key created later is removed rather than left behind.
-  const governedKeys = new Set();
-  for (const event of events) {
-    collectEventKeys(event, governedKeys);
-  }
-  const pairsToSet = [];
-  const keysToRemove = [];
-  for (const key of governedKeys) {
-    // Buoy's own settings are never app state to travel through.
-    if (isDevToolsStorageKey(key)) continue;
-    const value = stateMap.get(key);
-    if (value === undefined || value === null) {
-      keysToRemove.push(key);
-    } else {
-      pairsToSet.push([key, value]);
-    }
-  }
-  if (keysToRemove.length > 0) {
-    await removeMany(keysToRemove);
-  }
-  if (pairsToSet.length > 0) {
-    await writeMany(pairsToSet);
-  }
-}
-
-/**
- * Collect every key an event refers to, across all action shapes — including
- * `prevPairs`, so keys a `clear` removed are still governed by the timeline.
- */
-function collectEventKeys(event, into) {
-  const {
-    data
-  } = event;
-  if (!data) return;
-  if (data.key) into.add(data.key);
-  if (data.keys) for (const key of data.keys) into.add(key);
-  if (data.pairs) for (const [key] of data.pairs) into.add(key);
-  if (data.prevPairs) for (const [key] of data.prevPairs) into.add(key);
-}
-
-/**
- * Helper to apply an event's effects to a state map
- */
-function applyEventToStateMap(event, stateMap) {
-  const {
-    action,
-    data
-  } = event;
-  switch (action) {
-    case "setItem":
-      if (data?.key && data?.value !== undefined) {
-        stateMap.set(data.key, data.value);
-      }
-      break;
-    case "removeItem":
-      if (data?.key) {
-        stateMap.set(data.key, null);
-      }
-      break;
-    case "mergeItem":
-      if (data?.key && data?.value !== undefined) {
-        const existing = stateMap.get(data.key);
-        if (existing) {
-          try {
-            // Merge JSON objects
-            const existingObj = JSON.parse(existing);
-            const newObj = JSON.parse(data.value);
-            const merged = {
-              ...existingObj,
-              ...newObj
-            };
-            stateMap.set(data.key, JSON.stringify(merged));
-          } catch {
-            // If not valid JSON, just overwrite
-            stateMap.set(data.key, data.value);
-          }
-        } else {
-          stateMap.set(data.key, data.value);
-        }
-      }
-      break;
-    case "multiSet":
-      if (data?.pairs) {
-        for (const [key, value] of data.pairs) {
-          stateMap.set(key, value);
-        }
-      }
-      break;
-    case "multiRemove":
-      if (data?.keys) {
-        for (const key of data.keys) {
-          stateMap.set(key, null);
-        }
-      }
-      break;
-    case "multiMerge":
-      if (data?.pairs) {
-        for (const [key, value] of data.pairs) {
-          const existing = stateMap.get(key);
-          if (existing) {
-            try {
-              const existingObj = JSON.parse(existing);
-              const newObj = JSON.parse(value);
-              const merged = {
-                ...existingObj,
-                ...newObj
-              };
-              stateMap.set(key, JSON.stringify(merged));
-            } catch {
-              stateMap.set(key, value);
-            }
-          } else {
-            stateMap.set(key, value);
-          }
-        }
-      }
-      break;
-    case "clear":
-      // Clear the entire state map
-      stateMap.clear();
-      break;
-  }
-}
-
-/**
- * Check if an operation can be undone
- *
- * Some operations may not have the previous value captured.
- */
-export function canUndo(event) {
-  const {
-    action,
-    data
-  } = event;
-  switch (action) {
-    case "setItem":
-    case "mergeItem":
-    case "removeItem":
-      // Can undo if we have the key — but not while prevValue is still a
-      // wire-form on-device marker (restoring that would write garbage).
-      return !!data?.key && !isOmittedStorageValue(data.prevValue);
-    case "multiSet":
-    case "multiRemove":
-    case "multiMerge":
-    case "clear":
-      // Can undo if we have previous pairs
-      return !!data?.prevPairs && data.prevPairs.length > 0 && !isOmittedStorageValue(data.prevPairs);
-    default:
-      return false;
-  }
-}
+"use strict";import{isDevToolsStorageKey as m}from"@buoy-gg/shared-ui";import l from"@react-native-async-storage/async-storage";import{writeMany as f,removeMany as y}from"./asyncStorageCompat";function c(s){return!!s&&typeof s==="object"&&s.__buoyValueOnDevice===true}export async function undoOperation(s){const{action:r,data:e}=s;if(c(e?.prevValue)||c(e?.prevPairs)){throw new Error("Cannot undo: previous value is still on the device \u2014 fetch getEventDetail first")}{switch(r){case"setItem":case"mergeItem":if(e?.key){if(e.prevValue===null||e.prevValue===void 0){await l.removeItem(e.key)}else{await l.setItem(e.key,e.prevValue)}}break;case"removeItem":if(e?.key&&e.prevValue!==null&&e.prevValue!==void 0){await l.setItem(e.key,e.prevValue)}break;case"multiSet":case"multiMerge":if(e?.prevPairs&&e.prevPairs.length>0){for(const[t,a]of e.prevPairs){if(a===null){await l.removeItem(t)}else{await l.setItem(t,a)}}}break;case"multiRemove":if(e?.prevPairs&&e.prevPairs.length>0){for(const[t,a]of e.prevPairs){if(a!==null){await l.setItem(t,a)}}}break;case"clear":if(e?.prevPairs&&e.prevPairs.length>0){const t=e.prevPairs.filter(([,a])=>a!==null);if(t.length>0){await f(t)}}break;default:throw new Error(`Cannot undo unknown action type: ${r}`)}}}export async function jumpToState(s,r){if(r<0||r>=s.length){throw new Error(`Invalid event index: ${r}`)}for(const i of s){const o=i.data;if(c(o?.value)||c(o?.prevValue)||c(o?.pairs)||c(o?.prevPairs)){throw new Error("Cannot jump: some event values are still on the device \u2014 fetch getEventDetail first")}}const e=new Map;for(let i=0;i<=r;i++){k(s[i],e)}const t=new Set;for(const i of s){p(i,t)}const a=[];const n=[];for(const i of t){if(m(i))continue;const o=e.get(i);if(o===void 0||o===null){n.push(i)}else{a.push([i,o])}}if(n.length>0){await y(n)}if(a.length>0){await f(a)}}function p(s,r){const{data:e}=s;if(!e)return;if(e.key)r.add(e.key);if(e.keys)for(const t of e.keys)r.add(t);if(e.pairs)for(const[t]of e.pairs)r.add(t);if(e.prevPairs)for(const[t]of e.prevPairs)r.add(t)}function k(s,r){const{action:e,data:t}=s;switch(e){case"setItem":if(t?.key&&t?.value!==void 0){r.set(t.key,t.value)}break;case"removeItem":if(t?.key){r.set(t.key,null)}break;case"mergeItem":if(t?.key&&t?.value!==void 0){const a=r.get(t.key);if(a){try{const n=JSON.parse(a);const i=JSON.parse(t.value);const o={...n,...i};r.set(t.key,JSON.stringify(o))}catch{r.set(t.key,t.value)}}else{r.set(t.key,t.value)}}break;case"multiSet":if(t?.pairs){for(const[a,n]of t.pairs){r.set(a,n)}}break;case"multiRemove":if(t?.keys){for(const a of t.keys){r.set(a,null)}}break;case"multiMerge":if(t?.pairs){for(const[a,n]of t.pairs){const i=r.get(a);if(i){try{const o=JSON.parse(i);const u=JSON.parse(n);const v={...o,...u};r.set(a,JSON.stringify(v))}catch{r.set(a,n)}}else{r.set(a,n)}}}break;case"clear":r.clear();break}}export function canUndo(s){const{action:r,data:e}=s;switch(r){case"setItem":case"mergeItem":case"removeItem":return!!e?.key&&!c(e.prevValue);case"multiSet":case"multiRemove":case"multiMerge":case"clear":return!!e?.prevPairs&&e.prevPairs.length>0&&!c(e.prevPairs);default:return false}}

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

@@ -1,76 +1 @@
-"use strict";
-
-/** Return a concise string describing the JavaScript type of the provided value. */
-export function getValueTypeLabel(value) {
-  if (value === null) return "null";
-  if (value === undefined) return "undefined";
-  if (Array.isArray(value)) return "array";
-  const type = typeof value;
-  if (type === "object") return "object";
-  if (type === "boolean") return "boolean";
-  if (type === "number") return "number";
-  if (type === "string") return "string";
-  return "unknown";
-}
-
-/**
- * A stored value as a tree can show it.
- *
- * AsyncStorage and SecureStore hold strings, so an object arrives as the text
- * `{"a":1}` — displaying that as a string is technically true and useless. Any
- * surface that renders or edits a value structurally has to do this same
- * un-stringify first, so it lives here rather than being re-derived (slightly
- * differently) in each one.
- *
- * A string that doesn't parse comes back untouched: it was just a string that
- * happened to start with a brace.
- */
-export function parseStorageValue(value) {
-  if (typeof value !== "string") return value;
-  const trimmed = value.trim();
-  if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return value;
-  try {
-    return JSON.parse(value);
-  } catch {
-    return value;
-  }
-}
-
-/** Longest value preview rendered inline next to the type label. */
-const MAX_INLINE_PREVIEW = 40;
-
-/**
- * Short, human-readable preview of a value for inline display next to the type
- * label, or `null` when the value is too large/complex to preview (long
- * strings, objects, arrays). Lets the user read simple values without opening
- * the card.
- */
-export function getValuePreview(value) {
-  switch (typeof value) {
-    case "boolean":
-      return value ? "true" : "false";
-    case "number":
-      return Number.isFinite(value) ? String(value) : null;
-    case "string":
-      {
-        if (value.length === 0) return '""';
-        if (value.length > MAX_INLINE_PREVIEW) return null;
-        // Collapse whitespace so multi-line/tabbed values stay on one line.
-        return `"${value.replace(/\s+/g, " ")}"`;
-      }
-    default:
-      return null;
-    // objects, arrays, null, undefined
-  }
-}
-
-/**
- * Type label optionally followed by a short value preview — e.g. `boolean · true`,
- * `number · 42`, `string · "hello"`. Falls back to just the type label when the
- * value is too large to preview.
- */
-export function getValueTypeWithPreview(value) {
-  const label = getValueTypeLabel(value);
-  const preview = getValuePreview(value);
-  return preview ? `${label} · ${preview}` : label;
-}
+"use strict";export function getValueTypeLabel(r){if(r===null)return"null";if(r===void 0)return"undefined";if(Array.isArray(r))return"array";const t=typeof r;if(t==="object")return"object";if(t==="boolean")return"boolean";if(t==="number")return"number";if(t==="string")return"string";return"unknown"}export function parseStorageValue(r){if(typeof r!=="string")return r;const t=r.trim();if(!t.startsWith("{")&&!t.startsWith("["))return r;try{return JSON.parse(r)}catch{return r}}const n=40;export function getValuePreview(r){switch(typeof r){case"boolean":return r?"true":"false";case"number":return Number.isFinite(r)?String(r):null;case"string":{if(r.length===0)return'""';if(r.length>n)return null;return`"${r.replace(/\s+/g," ")}"`}default:return null}}export function getValueTypeWithPreview(r){const t=getValueTypeLabel(r);const e=getValuePreview(r);return e?`${t} \xB7 ${e}`:t}