@buoy-gg/react-query 1.7.8 → 2.1.1

package/lib/module/index.js

@@ -1,5 +1,15 @@
 "use strict";
 
+/**
+ * @buoy-gg/react-query
+ *
+ * React Query DevTools for React Native.
+ *
+ * PUBLIC API - Only these exports are supported for external use.
+ * Internal stores and event subscription mechanisms are not exported
+ * to prevent bypassing the tool's intended usage patterns.
+ */
+
 // Check if @tanstack/react-query is installed
 try {
   require("@tanstack/react-query");
@@ -7,13 +17,108 @@ try {
   throw new Error("\n\n[@buoy-gg/react-query] ERROR: Missing required peer dependency\n\n" + "This package requires @tanstack/react-query to be installed.\n\n" + "Install it with:\n" + "  npm install @tanstack/react-query\n" + "  or\n" + "  pnpm add @tanstack/react-query\n" + "  or\n" + "  yarn add @tanstack/react-query\n\n" + "For more information, visit: https://tanstack.com/query/latest\n");
 }
 
-// Export preset configuration (easiest way to add to FloatingDevTools!)
+// =============================================================================
+// PRESET (Primary entry point for users)
+// =============================================================================
 export { reactQueryToolPreset, createReactQueryTool, wifiTogglePreset, createWifiToggleTool } from "./preset";
 
-// React Query dev tools entry point
-// Re-export the full dev tools surface so consumers can tree-shake as needed
-export * from "./react-query";
-export * from "./react-query/components";
-export * from "./react-query/hooks";
-export * from "./react-query/utils";
-export * from "./react-query/types";
+// =============================================================================
+// QUERY CLIENT CONNECTION (Required for users to connect their QueryClient)
+// =============================================================================
+export { setQueryClient, disconnectQueryClient } from "./react-query/stores/reactQueryEventStore";
+
+// =============================================================================
+// COMPONENTS (For custom UI implementations)
+// =============================================================================
+
+// Main modals
+export { ReactQueryModal } from "./react-query/components/modals/ReactQueryModal";
+export { ReactQueryModalHeader } from "./react-query/components/modals/ReactQueryModalHeader";
+export { QueryBrowserModal } from "./react-query/components/modals/QueryBrowserModal";
+export { MutationBrowserModal } from "./react-query/components/modals/MutationBrowserModal";
+export { MutationEditorModal } from "./react-query/components/modals/MutationEditorModal";
+export { DataEditorModal } from "./react-query/components/modals/DataEditorModal";
+export { QueryBrowserFooter } from "./react-query/components/modals/QueryBrowserFooter";
+export { MutationBrowserFooter } from "./react-query/components/modals/MutationBrowserFooter";
+export { SwipeIndicator } from "./react-query/components/modals/SwipeIndicator";
+
+// Query browser components
+export { Explorer, QueryBrowser, QueryDetails, QueryInformation, QueryActions, QueryRow, QueryStatus, QueryStatusCount, QueryDetailsChip, MutationsList, MutationDetails, MutationInformation, MutationButton, MutationStatusCount, MutationDetailsChips, ActionButton, ClearCacheButton, NetworkToggleButton, StorageStatusCount } from "./react-query/components/query-browser";
+
+// Mode components
+export { QueryBrowserMode } from "./react-query/components/QueryBrowserMode";
+export { MutationBrowserMode } from "./react-query/components/MutationBrowserMode";
+export { MutationEditorMode } from "./react-query/components/MutationEditorMode";
+export { DataEditorMode } from "./react-query/components/DataEditorMode";
+export { QuerySelector } from "./react-query/components/QuerySelector";
+export { QueryDebugInfo } from "./react-query/components/QueryDebugInfo";
+export { WifiToggle } from "./react-query/components/WifiToggle";
+export { ReactQuerySection } from "./react-query/components/ReactQuerySection";
+export { ReactQueryDevToolsModal } from "./react-query/components/ReactQueryDevToolsModal";
+
+// Shared data viewer components
+export { VirtualizedDataExplorer, DataViewer, TypeLegend } from "@buoy-gg/shared-ui/dataViewer";
+
+// =============================================================================
+// HOOKS (For consuming React Query data)
+// =============================================================================
+export { default as useAllQueries } from "./react-query/hooks/useAllQueries";
+export { default as useAllMutations } from "./react-query/hooks/useAllMutations";
+export { useGetQueryByQueryKey, useGetQueryByQueryKeyWithVersion } from "./react-query/hooks/useSelectedQuery";
+export { useGetMutationById } from "./react-query/hooks/useSelectedMutation";
+export { default as useQueryStatusCounts } from "./react-query/hooks/useQueryStatusCounts";
+export { useStorageQueryCounts } from "./react-query/hooks/useStorageQueryCounts";
+export { useReactQueryState } from "./react-query/hooks/useReactQueryState";
+export { useActionButtons } from "./react-query/hooks/useActionButtons";
+export { useMutationActionButtons } from "./react-query/hooks/useMutationActionButtons";
+export { useModalManager } from "./react-query/hooks/useModalManager";
+export { useModalPersistence } from "./react-query/hooks/useModalPersistence";
+export { useWifiState } from "./react-query/hooks/useWifiState";
+
+// =============================================================================
+// UTILITIES (Public helpers only)
+// =============================================================================
+
+// Action utilities
+export { default as invalidate } from "./react-query/utils/actions/invalidate";
+export { default as refetch } from "./react-query/utils/actions/refetch";
+export { default as reset } from "./react-query/utils/actions/reset";
+export { default as remove } from "./react-query/utils/actions/remove";
+export { default as deleteItem } from "./react-query/utils/actions/deleteItem";
+export { default as triggerError } from "./react-query/utils/actions/triggerError";
+export { default as triggerLoading } from "./react-query/utils/actions/triggerLoading";
+
+// Query status utilities
+export * from "./react-query/utils/getQueryStatusLabel";
+export * from "./react-query/utils/getQueryStatusColor";
+
+// Storage utilities
+export * from "./react-query/utils/getStorageQueryCounts";
+export * from "./react-query/utils/storageQueryUtils";
+export * from "./react-query/utils/modalStorageOperations";
+
+// Data manipulation utilities
+export * from "./react-query/utils/updateNestedDataByPath";
+export * from "./react-query/utils/deleteNestedDataByPath";
+export { safeStringify, displayValue, parseDisplayValue } from "@buoy-gg/shared-ui";
+
+// =============================================================================
+// TYPES
+// =============================================================================
+
+export { isPlainObject } from "./react-query/types/types";
+
+// =============================================================================
+// INTERNAL EXPORTS (For @buoy-gg/* packages only - not part of public API)
+// =============================================================================
+/** @internal */
+export { reactQueryEventStore } from "./react-query/stores/reactQueryEventStore";
+
+// =============================================================================
+// NOT EXPORTED (Internal controls)
+// =============================================================================
+// The following are intentionally NOT exported to prevent bypassing:
+// - getReactQueryEvents (internal store access)
+// - subscribeToReactQueryEvents (internal subscription)
+// - clearReactQueryEvents (internal store control)
+// - isReactQueryConnected (internal state query)

package/lib/module/preset.js

@@ -21,7 +21,7 @@ import { QueryIcon } from "@buoy-gg/floating-tools-core";
 import { Wifi } from "@buoy-gg/shared-ui";
 import { ReactQueryDevToolsModal } from "./react-query/components/ReactQueryDevToolsModal";
 import { onlineManager } from "@tanstack/react-query";
-import { devToolsStorageKeys, safeSetItem } from "@buoy-gg/shared-ui";
+import { devToolsStorageKeys, persistentStorage } from "@buoy-gg/shared-ui";
 
 // Empty component for toggle-only mode
 const EmptyComponent = () => null;
@@ -29,7 +29,7 @@ const EmptyComponent = () => null;
 // Save WiFi state to storage
 const saveWifiState = async enabled => {
   try {
-    await safeSetItem(devToolsStorageKeys.settings.wifiEnabled(), enabled.toString());
+    await persistentStorage.setItem(devToolsStorageKeys.settings.wifiEnabled(), enabled.toString());
   } catch (error) {
     // Failed to save WiFi state
   }

package/lib/module/react-query/components/ReactQueryDevToolsModal.js

@@ -1,7 +1,9 @@
 "use strict";
 
-import { useCallback, useState } from "react";
+import { useCallback, useState, useEffect } from "react";
+import { useQueryClient } from "@tanstack/react-query";
 import { ReactQueryModal } from "./modals/ReactQueryModal";
+import { reactQueryEventStore } from "../stores/reactQueryEventStore";
 
 /** Configuration options for the high-level React Query dev tools modal wrapper. */
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -15,6 +17,16 @@ export function ReactQueryDevToolsModal({
   onMinimize,
   enableSharedModalDimensions = true
 }) {
+  // Get QueryClient and connect to event store for unified Events DevTools
+  const queryClient = useQueryClient();
+  useEffect(() => {
+    // Connect the QueryClient to the event store so events flow to unified Events DevTools
+    // Only connect if not already connected (to preserve connection across modal open/close)
+    if (!reactQueryEventStore.isConnected()) {
+      reactQueryEventStore.setQueryClient(queryClient);
+    }
+    // Don't disconnect on unmount - keep the connection for unified Events DevTools
+  }, [queryClient]);
   const [selectedQueryKey, setSelectedQueryKey] = useState(undefined);
   const [selectedMutationId, setSelectedMutationId] = useState(undefined);
   const [activeFilter, setActiveFilter] = useState(null);

package/lib/module/react-query/components/modals/MutationBrowserModal.js

@@ -37,7 +37,8 @@ export function MutationBrowserModal({
   // Clear mutation cache handler
   const handleClearCache = useCallback(() => {
     queryClient.getMutationCache().clear();
-  }, [queryClient]);
+    onMutationSelect(undefined);
+  }, [queryClient, onMutationSelect]);
 
   // Track modal mode for conditional styling
   // Initialize with bottomSheet but it will be updated from persisted state if available

package/lib/module/react-query/components/modals/QueryBrowserModal.js

@@ -9,7 +9,7 @@ import { QueryBrowserFooter } from "./QueryBrowserFooter";
 import { QueryFilterViewV3 } from "../QueryFilterViewV3";
 import { useState, useCallback, useEffect } from "react";
 import { View, StyleSheet } from "react-native";
-import { devToolsStorageKeys, useSafeAsyncStorage, buoyColors } from "@buoy-gg/shared-ui";
+import { devToolsStorageKeys, persistentStorage, buoyColors } from "@buoy-gg/shared-ui";
 import useAllQueries from "../../hooks/useAllQueries";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
@@ -48,17 +48,11 @@ export function QueryBrowserModal({
   const [ignoredPatterns, setIgnoredPatterns] = useState(new Set());
   const [includedPatterns, setIncludedPatterns] = useState(new Set());
 
-  // AsyncStorage for persisting ignored patterns
-  const {
-    getItem: safeGetItem,
-    setItem: safeSetItem
-  } = useSafeAsyncStorage();
-
   // Load ignored patterns from storage on mount
   useEffect(() => {
     const loadFilters = async () => {
       try {
-        const stored = await safeGetItem(devToolsStorageKeys.reactQuery.ignoredPatterns());
+        const stored = await persistentStorage.getItem(devToolsStorageKeys.reactQuery.ignoredPatterns());
         if (stored) {
           const patterns = JSON.parse(stored);
           if (Array.isArray(patterns)) {
@@ -70,13 +64,13 @@ export function QueryBrowserModal({
       }
     };
     loadFilters();
-  }, [safeGetItem]);
+  }, []);
 
   // Load included patterns from storage on mount
   useEffect(() => {
     const loadFilters = async () => {
       try {
-        const stored = await safeGetItem(devToolsStorageKeys.reactQuery.includedPatterns());
+        const stored = await persistentStorage.getItem(devToolsStorageKeys.reactQuery.includedPatterns());
         if (stored) {
           const patterns = JSON.parse(stored);
           if (Array.isArray(patterns)) {
@@ -88,33 +82,33 @@ export function QueryBrowserModal({
       }
     };
     loadFilters();
-  }, [safeGetItem]);
+  }, []);
 
   // Save ignored patterns to storage when they change
   useEffect(() => {
     const saveFilters = async () => {
       try {
         const patterns = Array.from(ignoredPatterns);
-        await safeSetItem(devToolsStorageKeys.reactQuery.ignoredPatterns(), JSON.stringify(patterns));
+        await persistentStorage.setItem(devToolsStorageKeys.reactQuery.ignoredPatterns(), JSON.stringify(patterns));
       } catch (error) {
         console.error("Failed to save ignored patterns:", error);
       }
     };
     saveFilters();
-  }, [ignoredPatterns, safeSetItem]);
+  }, [ignoredPatterns]);
 
   // Save included patterns to storage when they change
   useEffect(() => {
     const saveFilters = async () => {
       try {
         const patterns = Array.from(includedPatterns);
-        await safeSetItem(devToolsStorageKeys.reactQuery.includedPatterns(), JSON.stringify(patterns));
+        await persistentStorage.setItem(devToolsStorageKeys.reactQuery.includedPatterns(), JSON.stringify(patterns));
       } catch (error) {
         console.error("Failed to save included patterns:", error);
       }
     };
     saveFilters();
-  }, [includedPatterns, safeSetItem]);
+  }, [includedPatterns]);
 
   // Toggle pattern in ignored set
   const handlePatternToggle = useCallback(pattern => {

package/lib/module/react-query/hooks/useAllMutations.js

@@ -1,30 +1,80 @@
 "use strict";
 
-import { useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import { useQueryClient } from "@tanstack/react-query";
 
 /**
- * Tracks all active React Query mutations with lightweight change detection. Debounces cache
- * updates so large mutation batches do not thrash the UI thread on mobile.
+ * Tracks all active React Query mutations with lightweight change detection.
+ * Mirrors the pattern used in useAllQueries for consistency.
  */
 function useAllMutations() {
   const queryClient = useQueryClient();
-  const [mutations, setMutations] = useState([]);
-  const mutationsSnapshotRef = useRef(null);
+  const [mutations, setMutations] = useState(() => {
+    // Initialize with current mutations to avoid flash
+    return queryClient.getMutationCache().getAll();
+  });
+
+  // Track mutation states using a Map for O(1) lookups
+  const mutationStatesRef = useRef(new Map());
+  const updateTimerRef = useRef(undefined);
+
+  // Check if mutations have changed
+  const hasMutationsChanged = useCallback(newMutations => {
+    const statesMap = mutationStatesRef.current;
+
+    // Quick length check first
+    if (newMutations.length !== statesMap.size) {
+      return true;
+    }
+
+    // Check if any mutation state has changed
+    for (const mutation of newMutations) {
+      const prevState = statesMap.get(mutation.mutationId);
+      if (!prevState) return true;
+      if (prevState.status !== mutation.state.status || prevState.submittedAt !== mutation.state.submittedAt || prevState.isPaused !== mutation.state.isPaused) {
+        return true;
+      }
+    }
+    return false;
+  }, []);
+
+  // Update function
+  const updateMutations = useCallback(() => {
+    const allMutations = queryClient.getMutationCache().getAll();
+    if (hasMutationsChanged(allMutations)) {
+      // Update states map
+      const newStatesMap = new Map();
+      allMutations.forEach(m => {
+        newStatesMap.set(m.mutationId, m.state);
+      });
+      mutationStatesRef.current = newStatesMap;
+      setMutations(allMutations);
+    }
+  }, [queryClient, hasMutationsChanged]);
   useEffect(() => {
-    const updateMutations = () => {
-      const newMutations = queryClient.getMutationCache().getAll();
-      const newStates = newMutations.map(m => m.state);
-      const snapshot = JSON.stringify(newStates);
-      if (mutationsSnapshotRef.current !== snapshot) {
-        mutationsSnapshotRef.current = snapshot;
-        setTimeout(() => setMutations(newMutations), 0);
+    // Initial update
+    updateMutations();
+
+    // Subscribe with event filtering (matching useAllQueries pattern)
+    const unsubscribe = queryClient.getMutationCache().subscribe(event => {
+      // Process events that affect mutation list
+      if (event.type === "added" || event.type === "removed" || event.type === "updated") {
+        // Debounce updates to batch rapid changes
+        if (updateTimerRef.current) {
+          clearTimeout(updateTimerRef.current);
+        }
+        updateTimerRef.current = setTimeout(() => {
+          updateMutations();
+        }, 10);
+      }
+    });
+    return () => {
+      unsubscribe();
+      if (updateTimerRef.current) {
+        clearTimeout(updateTimerRef.current);
       }
     };
-    setTimeout(updateMutations, 0);
-    const unsubscribe = queryClient.getMutationCache().subscribe(updateMutations);
-    return () => unsubscribe();
-  }, [queryClient]);
+  }, [queryClient, updateMutations]);
   return {
     mutations
   };

package/lib/module/react-query/hooks/useWifiState.js

@@ -2,10 +2,10 @@
 
 import { useEffect, useState, useRef } from "react";
 import { onlineManager } from "@tanstack/react-query";
-import { devToolsStorageKeys, safeGetItem, safeSetItem } from "@buoy-gg/shared-ui";
+import { devToolsStorageKeys, persistentStorage } from "@buoy-gg/shared-ui";
 
 /**
- * Synchronizes a local Wi-Fi toggle with React Query’s `onlineManager`, persisting the selection
+ * Synchronizes a local Wi-Fi toggle with React Query's `onlineManager`, persisting the selection
  * so developers can simulate offline mode across reloads.
  */
 export function useWifiState() {
@@ -17,7 +17,7 @@ export function useWifiState() {
     if (hasLoadedPersistedState.current) return;
     const loadPersistedState = async () => {
       try {
-        const savedState = await safeGetItem(devToolsStorageKeys.settings.wifiEnabled());
+        const savedState = await persistentStorage.getItem(devToolsStorageKeys.settings.wifiEnabled());
         if (savedState !== null) {
           const isEnabled = savedState === "true";
           setIsOnline(isEnabled);
@@ -34,7 +34,7 @@ export function useWifiState() {
   // Save WiFi state when it changes
   const saveWifiState = async enabled => {
     try {
-      await safeSetItem(devToolsStorageKeys.settings.wifiEnabled(), enabled.toString());
+      await persistentStorage.setItem(devToolsStorageKeys.settings.wifiEnabled(), enabled.toString());
     } catch (error) {
       // Failed to save WiFi state
     }

package/lib/module/react-query/index.js

@@ -1,3 +1,4 @@
 "use strict";
 
-export * from "./ReactQueryDevTools";
+export * from "./ReactQueryDevTools";
+export * from "./stores";

package/lib/module/react-query/stores/index.js

@@ -0,0 +1,3 @@
+"use strict";
+
+export { reactQueryEventStore, setQueryClient, disconnectQueryClient, getReactQueryEvents, subscribeToReactQueryEvents, clearReactQueryEvents, isReactQueryConnected } from "./reactQueryEventStore";