@buoy-gg/storage 1.7.7 → 2.1.1

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

@@ -0,0 +1,251 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.canUndo = canUndo;
+exports.jumpToState = jumpToState;
+exports.undoOperation = undoOperation;
+var _asyncStorage = _interopRequireDefault(require("@react-native-async-storage/async-storage"));
+var _AsyncStorageListener = require("./AsyncStorageListener");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * Storage Time-Travel Utilities
+ *
+ * Provides jump and undo functionality for AsyncStorage operations.
+ */
+
+/**
+ * Undo a single storage operation
+ *
+ * Restores the previous value(s) before the operation occurred.
+ * This pauses event capture to avoid creating new events during restoration.
+ *
+ * @param event - The storage event to undo
+ */
+async function undoOperation(event) {
+  const {
+    action,
+    data
+  } = event;
+
+  // Pause capture to avoid creating events during restoration
+  (0, _AsyncStorageListener.pauseCapture)();
+  try {
+    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.default.removeItem(data.key);
+          } else {
+            // Restore previous value
+            await _asyncStorage.default.setItem(data.key, data.prevValue);
+          }
+        }
+        break;
+      case "removeItem":
+        if (data?.key && data.prevValue !== null && data.prevValue !== undefined) {
+          // Restore the removed value
+          await _asyncStorage.default.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.default.removeItem(key);
+            } else {
+              await _asyncStorage.default.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.default.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 _asyncStorage.default.multiSet(pairsToRestore);
+          }
+        }
+        break;
+      default:
+        throw new Error(`Cannot undo unknown action type: ${action}`);
+    }
+  } finally {
+    // Always resume capture, even if an error occurred
+    (0, _AsyncStorageListener.resumeCapture)();
+  }
+}
+
+/**
+ * Jump to a specific point in storage history
+ *
+ * This reconstructs the storage state as it was after a specific event
+ * by clearing storage and replaying all events up to that point.
+ *
+ * Note: This is a destructive operation - it will clear current storage
+ * and replay events to reach the target state.
+ *
+ * @param events - All events in chronological order (oldest first)
+ * @param targetEventIndex - The index of the event to jump to (0-based)
+ */
+async function jumpToState(events, targetEventIndex) {
+  if (targetEventIndex < 0 || targetEventIndex >= events.length) {
+    throw new Error(`Invalid event index: ${targetEventIndex}`);
+  }
+
+  // Pause capture to avoid creating events during replay
+  (0, _AsyncStorageListener.pauseCapture)();
+  try {
+    // Clear all storage first
+    await _asyncStorage.default.clear();
+
+    // 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++) {
+      const event = events[i];
+      applyEventToStateMap(event, stateMap);
+    }
+
+    // Apply the final state
+    const pairsToSet = [];
+    for (const [key, value] of stateMap) {
+      if (value !== null) {
+        pairsToSet.push([key, value]);
+      }
+    }
+    if (pairsToSet.length > 0) {
+      await _asyncStorage.default.multiSet(pairsToSet);
+    }
+  } finally {
+    // Always resume capture
+    (0, _AsyncStorageListener.resumeCapture)();
+  }
+}
+
+/**
+ * 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.
+ */
+function canUndo(event) {
+  const {
+    action,
+    data
+  } = event;
+  switch (action) {
+    case "setItem":
+    case "mergeItem":
+    case "removeItem":
+      // Can undo if we have the key
+      return !!data?.key;
+    case "multiSet":
+    case "multiRemove":
+    case "multiMerge":
+    case "clear":
+      // Can undo if we have previous pairs
+      return !!data?.prevPairs && data.prevPairs.length > 0;
+    default:
+      return false;
+  }
+}

package/lib/module/index.js

@@ -1,7 +1,78 @@
 "use strict";
 
-// Export preset configuration (easiest way to add to FloatingDevTools!)
+/**
+ * @buoy-gg/storage
+ *
+ * Storage monitoring tool for React Native DevTools.
+ * Supports AsyncStorage and MMKV.
+ *
+ * PUBLIC API - Only these exports are supported for external use.
+ * Internal listeners and capture controls are not exported to prevent
+ * bypassing the tool's intended usage patterns.
+ */
+
+// =============================================================================
+// PRESET (Primary entry point for users)
+// =============================================================================
 export { storageToolPreset, createStorageTool } from "./preset";
 
-// Export all storage utilities and components
-export * from "./storage";
+// =============================================================================
+// COMPONENTS (For custom UI implementations)
+// =============================================================================
+export { StorageSection } from "./storage/components/StorageSection";
+export { StorageModalWithTabs } from "./storage/components/StorageModalWithTabs";
+export { StorageKeyCard } from "./storage/components/StorageKeyCard";
+export { StorageKeyStatsSection } from "./storage/components/StorageKeyStats";
+export { StorageKeySection } from "./storage/components/StorageKeySection";
+export { StorageBrowserMode } from "./storage/components/StorageBrowserMode";
+export { StorageEventsSection } from "./storage/components/StorageEventsSection";
+export { StorageEventCard, getValueType } from "./storage/components/StorageEventCard";
+export { StorageEventDetailContent, StorageEventDetailFooter } from "./storage/components/StorageEventDetailContent";
+export { MMKVInstanceSelector } from "./storage/components/MMKVInstanceSelector";
+export { MMKVInstanceInfoPanel } from "./storage/components/MMKVInstanceInfoPanel";
+
+// =============================================================================
+// HOOKS (For consuming storage data in custom components)
+// =============================================================================
+export { useAsyncStorageKeys } from "./storage/hooks/useAsyncStorageKeys";
+export { useMMKVKeys, useMultiMMKVKeys } from "./storage/hooks/useMMKVKeys";
+export { useMMKVInstances, useMMKVInstance, useMMKVInstanceExists } from "./storage/hooks/useMMKVInstances";
+export { useStorageEvents } from "./storage/hooks/useStorageEvents";
+
+// =============================================================================
+// TYPES
+// =============================================================================
+
+// =============================================================================
+// UTILITIES (Public helpers only)
+// =============================================================================
+export { clearAllAppStorage } from "./storage/utils/clearAllStorage";
+export { isMMKVAvailable, getMMKVClass, getMMKVUnavailableMessage } from "./storage/utils/mmkvAvailability";
+export { detectMMKVType, formatMMKVValue, isTypeMatch } from "./storage/utils/mmkvTypeDetection";
+export { undoOperation, jumpToState, canUndo } from "./storage/utils/storageTimeTravelUtils";
+// =============================================================================
+// MMKV INSTANCE REGISTRATION (For users to register their MMKV instances)
+// =============================================================================
+export { registerMMKVInstance, unregisterMMKVInstance } from "./storage/utils/MMKVInstanceRegistry";
+
+// =============================================================================
+// INTERNAL EXPORTS (For @buoy-gg/* packages only - not part of public API)
+// =============================================================================
+/** @internal */
+export { storageEventStore } from "./storage/stores/storageEventStore";
+
+// =============================================================================
+// NOT EXPORTED (Internal capture controls)
+// =============================================================================
+// The following are intentionally NOT exported to prevent bypassing:
+// - startStorageCapture, stopStorageCapture, pauseStorageCapture, resumeStorageCapture
+// - subscribeToStorageEvents, onStorageEvent, getStorageEvents, clearStorageEvents
+// - isStorageCapturing
+// - startListening, stopListening, addListener, removeAllListeners (AsyncStorage)
+// - pauseCapture, resumeCapture, isPaused, isListening, getListenerCount
+// - asyncStorageListener instance
+// - addMMKVInstance, removeMMKVInstance, removeAllMMKVInstances (MMKV listener controls)
+// - addMMKVListener, removeAllMMKVListeners, isMMKVInstanceMonitored
+// - getMonitoredMMKVInstances, getMMKVInstanceCount, getMMKVListenerCount, isMMKVListening
+// - mmkvListener instance
+// - mmkvInstanceRegistry instance

package/lib/module/storage/components/DiffViewer/themes/diffThemes.js

@@ -50,63 +50,54 @@ export const gitClassicTheme = {
 
 /**
  * Dev Tools Default Theme
- * Clean dark theme using our gameUIColors
+ * Clean dark theme matching Buoy website brand colors
  */
 export const devToolsDefaultTheme = {
   name: "Dev Tools Default",
-  description: "Clean dark theme with our game UI colors",
-  // Use our gameUIColors-inspired dark theme
-  background: "#0A0E1A",
-  // Dark background
-  panelBackground: "#0F1420",
-  // Slightly lighter panel
-  headerBackground: "#141925",
-  // Header background
-
-  // Diff colors with our cyan/yellow/red scheme
-  addedBackground: "rgba(74, 255, 159, 0.1)",
-  // Green-cyan for additions
-  removedBackground: "rgba(255, 82, 82, 0.1)",
-  // Red for removals
-  modifiedBackground: "rgba(0, 184, 230, 0.1)",
-  // Cyan for modifications
+  description: "Clean dark theme with Buoy brand colors",
+  // Surface colors (matching website dark theme)
+  background: "#121212",
+  panelBackground: "#1A1A1A",
+  headerBackground: "#1A1A1A",
+  // Diff colors using website's semantic colors
+  // Added: Primary teal (#20C997)
+  // Removed: Error red (#EF4444)
+  // Modified: Secondary purple (#9B70E0)
+  addedBackground: "rgba(32, 201, 151, 0.12)",
+  removedBackground: "rgba(239, 68, 68, 0.12)",
+  modifiedBackground: "rgba(155, 112, 224, 0.12)",
   unchangedBackground: "transparent",
   contextBackground: "rgba(255, 255, 255, 0.02)",
   // Text colors
-  addedText: "#4AFF9F",
-  // Bright green-cyan
-  removedText: "#FF5252",
-  // Bright red
-  modifiedText: "#00B8E6",
-  // Bright cyan
-  unchangedText: "#B8BFC9",
-  // Muted text
-
+  addedText: "#20C997",
+  removedText: "#EF4444",
+  modifiedText: "#9B70E0",
+  unchangedText: "#E0E0E0",
   // Word-level highlights
-  addedWordHighlight: "rgba(74, 255, 159, 0.3)",
-  removedWordHighlight: "rgba(255, 82, 82, 0.3)",
+  addedWordHighlight: "rgba(32, 201, 151, 0.3)",
+  removedWordHighlight: "rgba(239, 68, 68, 0.3)",
   // UI elements
-  lineNumberBackground: "#0A0E1A",
-  lineNumberText: "#7A8599",
-  lineNumberBorder: "#1F2937",
+  lineNumberBackground: "#121212",
+  lineNumberText: "#A0A0A0",
+  lineNumberBorder: "#333333",
   // Markers
-  markerAddedBackground: "rgba(74, 255, 159, 0.2)",
-  markerRemovedBackground: "rgba(255, 82, 82, 0.2)",
-  markerModifiedBackground: "rgba(0, 184, 230, 0.2)",
-  markerText: "#7A8599",
+  markerAddedBackground: "rgba(32, 201, 151, 0.2)",
+  markerRemovedBackground: "rgba(239, 68, 68, 0.2)",
+  markerModifiedBackground: "rgba(155, 112, 224, 0.2)",
+  markerText: "#A0A0A0",
   // Borders and dividers
-  borderColor: "#1F2937",
-  dividerColor: "#1F2937",
+  borderColor: "#333333",
+  dividerColor: "#333333",
   // Summary bar
-  summaryBackground: "#0F1420",
-  summaryAddedText: "#4AFF9F",
-  summaryRemovedText: "#FF5252",
-  summaryModifiedText: "#00B8E6",
+  summaryBackground: "#1A1A1A",
+  summaryAddedText: "#20C997",
+  summaryRemovedText: "#EF4444",
+  summaryModifiedText: "#9B70E0",
   // Empty state
-  emptyStateText: "#7A8599",
+  emptyStateText: "#888888",
   // Separator
-  separatorBackground: "#141925",
-  separatorText: "#7A8599"
+  separatorBackground: "#1A1A1A",
+  separatorText: "#A0A0A0"
 };
 
 /**

package/lib/module/storage/components/GameUIStorageBrowser.js

@@ -23,29 +23,10 @@ if (isMMKVAvailable()) {
 
 // Import shared Game UI components
 import { gameUIColors, macOSColors, HardDrive } from "@buoy-gg/shared-ui";
-
-// Lazy load the license hooks to avoid circular dependencies
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-let _useIsPro = null;
-let _licenseLoadAttempted = false;
-function loadLicenseModule() {
-  if (_licenseLoadAttempted) return;
-  _licenseLoadAttempted = true;
-  try {
-    const mod = require("@buoy-gg/license");
-    if (mod) {
-      _useIsPro = mod.useIsPro ?? null;
-    }
-  } catch {
-    // License package not available
-  }
-}
-function getUseIsPro() {
-  loadLicenseModule();
-  return _useIsPro ?? (() => false);
-}
+import { useIsPro } from "@buoy-gg/license";
 
 // MMKV Instance color palette - consistent colors per instance
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const INSTANCE_COLORS = [macOSColors.semantic.info,
 // Blue
 macOSColors.semantic.success,
@@ -79,10 +60,15 @@ export function GameUIStorageBrowser({
   searchQuery = "",
   storageDataRef
 }) {
-  // Check Pro status internally
-  const useIsPro = getUseIsPro();
   const isPro = useIsPro();
   const [showUpgradeModal, setShowUpgradeModal] = useState(false);
+
+  // Auto-close upgrade modal when user becomes Pro
+  useEffect(() => {
+    if (showUpgradeModal && isPro) {
+      setShowUpgradeModal(false);
+    }
+  }, [showUpgradeModal, isPro]);
   const [activeFilter, setActiveFilter] = useState("all");
   const [activeStorageType, setActiveStorageType] = useState("all");
   const [selectedMMKVInstance, setSelectedMMKVInstance] = useState(null);

package/lib/module/storage/components/SelectionActionBar.js

@@ -1,31 +1,12 @@
 "use strict";
 
-import { useState } from "react";
+import { useState, useEffect } from "react";
 import { View, Text, StyleSheet, TouchableOpacity, Alert } from "react-native";
 import { Trash2, CopyButton, CheckSquare, ProUpgradeModal } from "@buoy-gg/shared-ui";
 import { macOSColors } from "@buoy-gg/shared-ui";
+import { useIsPro } from "@buoy-gg/license";
 import AsyncStorage from "@react-native-async-storage/async-storage";
-
-// Lazy load the license hooks to avoid circular dependencies
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-let _useIsPro = null;
-let _licenseLoadAttempted = false;
-function loadLicenseModule() {
-  if (_licenseLoadAttempted) return;
-  _licenseLoadAttempted = true;
-  try {
-    const mod = require("@buoy-gg/license");
-    if (mod) {
-      _useIsPro = mod.useIsPro ?? null;
-    }
-  } catch {
-    // License package not available
-  }
-}
-function getUseIsPro() {
-  loadLicenseModule();
-  return _useIsPro ?? (() => false);
-}
 export function SelectionActionBar({
   selectedKeys,
   mmkvInstances,
@@ -35,10 +16,14 @@ export function SelectionActionBar({
   totalVisibleKeys
 }) {
   const [showUpgradeModal, setShowUpgradeModal] = useState(false);
-
-  // Check Pro status internally
-  const useIsPro = getUseIsPro();
   const isPro = useIsPro();
+
+  // Auto-close upgrade modal when user becomes Pro
+  useEffect(() => {
+    if (showUpgradeModal && isPro) {
+      setShowUpgradeModal(false);
+    }
+  }, [showUpgradeModal, isPro]);
   const selectedCount = selectedKeys.length;
   const allSelected = selectedCount === totalVisibleKeys && totalVisibleKeys > 0;
 

package/lib/module/storage/components/StorageActionButtons.js

@@ -1,31 +1,12 @@
 "use strict";
 
-import { useState } from "react";
+import { useState, useEffect } from "react";
 import { View, Text, StyleSheet, TouchableOpacity, Alert } from "react-native";
 import { Trash2, CopyButton, SquareDashed, X, ProUpgradeModal } from "@buoy-gg/shared-ui";
 import { macOSColors } from "@buoy-gg/shared-ui";
+import { useIsPro } from "@buoy-gg/license";
 import AsyncStorage from "@react-native-async-storage/async-storage";
-
-// Lazy load the license hooks to avoid circular dependencies
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-let _useIsPro = null;
-let _licenseLoadAttempted = false;
-function loadLicenseModule() {
-  if (_licenseLoadAttempted) return;
-  _licenseLoadAttempted = true;
-  try {
-    const mod = require("@buoy-gg/license");
-    if (mod) {
-      _useIsPro = mod.useIsPro ?? null;
-    }
-  } catch {
-    // License package not available
-  }
-}
-function getUseIsPro() {
-  loadLicenseModule();
-  return _useIsPro ?? (() => false);
-}
 export function StorageActionButtons({
   copyValue,
   mmkvInstances = [],
@@ -36,10 +17,14 @@ export function StorageActionButtons({
   selectedCount = 0
 }) {
   const [showUpgradeModal, setShowUpgradeModal] = useState(false);
-
-  // Check Pro status internally
-  const useIsPro = getUseIsPro();
   const isPro = useIsPro();
+
+  // Auto-close upgrade modal when user becomes Pro
+  useEffect(() => {
+    if (showUpgradeModal && isPro) {
+      setShowUpgradeModal(false);
+    }
+  }, [showUpgradeModal, isPro]);
   const handleClearAsyncStorage = () => {
     // Gate clear behind Pro
     if (!isPro) {

package/lib/module/storage/components/StorageActions.js

@@ -1,30 +1,11 @@
 "use strict";
 
 import { View, Text, TouchableOpacity, StyleSheet, Alert } from "react-native";
-import { useState, useCallback } from "react";
+import { useState, useCallback, useEffect } from "react";
 import { clearAllStorageIncludingDevTools } from "../utils/clearAllStorage";
 import { RefreshCw, Trash2, CopyButton, ProUpgradeModal } from "@buoy-gg/shared-ui";
-
-// Lazy load the license hooks to avoid circular dependencies
+import { useIsPro } from "@buoy-gg/license";
 import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-let _useIsPro = null;
-let _licenseLoadAttempted = false;
-function loadLicenseModule() {
-  if (_licenseLoadAttempted) return;
-  _licenseLoadAttempted = true;
-  try {
-    const mod = require("@buoy-gg/license");
-    if (mod) {
-      _useIsPro = mod.useIsPro ?? null;
-    }
-  } catch {
-    // License package not available
-  }
-}
-function getUseIsPro() {
-  loadLicenseModule();
-  return _useIsPro ?? (() => false);
-}
 export function StorageActions({
   storageKeys,
   onClearAll,
@@ -33,10 +14,14 @@ export function StorageActions({
 }) {
   const [isRefreshing, setIsRefreshing] = useState(false);
   const [showUpgradeModal, setShowUpgradeModal] = useState(false);
-
-  // Check Pro status internally
-  const useIsPro = getUseIsPro();
   const isPro = useIsPro();
+
+  // Auto-close upgrade modal when user becomes Pro
+  useEffect(() => {
+    if (showUpgradeModal && isPro) {
+      setShowUpgradeModal(false);
+    }
+  }, [showUpgradeModal, isPro]);
   const handleRefresh = useCallback(async () => {
     setIsRefreshing(true);
     try {