@buoy-gg/react-query 4.0.1 → 4.0.2

package/lib/commonjs/react-query/sync/reactQuerySyncAdapter.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.createReactQuerySyncAdapter = createReactQuerySyncAdapter;
 var _reactQuery = require("@tanstack/react-query");
 var _dehydrate = require("./dehydrate");
+var _getQueryStatusLabel = require("../utils/getQueryStatusLabel");
 /**
  * Sync adapter for the React Query tool, consumed by @buoy-gg/external-sync's
  * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
@@ -45,6 +46,46 @@ function createReactQuerySyncAdapter(queryClient) {
       };
     },
     actions: {
+      /**
+       * Compact, token-bounded cache reader for a remote driver (MCP/LLM):
+       * projects each live query to light fields (hash, key, status label,
+       * staleness, observers, error message) — the heavy cached `data` stays on
+       * the device unless `includeData` is set. Unlike getSnapshot (full
+       * dehydrated cache), this is safe to read repeatedly.
+       */
+      listQueries: params => {
+        const {
+          includeData = false,
+          staleOnly = false,
+          limit
+        } = params ?? {};
+        const all = queryClient.getQueryCache().getAll();
+        const filtered = staleOnly ? all.filter(q => q.isStale()) : all;
+        const sorted = [...filtered].sort((a, b) => (b.state.dataUpdatedAt ?? 0) - (a.state.dataUpdatedAt ?? 0));
+        const capped = typeof limit === "number" && limit > 0 ? sorted.slice(0, limit) : sorted;
+        const queries = capped.map(q => {
+          const err = q.state.error;
+          return {
+            queryHash: q.queryHash,
+            queryKey: q.queryKey,
+            status: (0, _getQueryStatusLabel.getQueryStatusLabel)(q),
+            fetchStatus: q.state.fetchStatus,
+            isStale: q.isStale(),
+            observers: q.getObserversCount(),
+            updatedAt: q.state.dataUpdatedAt,
+            error: err ? err.message ?? String(err) : undefined,
+            ...(includeData ? {
+              data: q.state.data
+            } : {})
+          };
+        });
+        return {
+          queries,
+          total: all.length,
+          returned: queries.length,
+          includedData: includeData
+        };
+      },
       refetch: params => {
         const query = getQuery(params);
         // Swallow fetch rejections — the resulting error state syncs anyway

package/lib/module/react-query/sync/reactQuerySyncAdapter.js

@@ -12,6 +12,7 @@
  */
 import { onlineManager } from "@tanstack/react-query";
 import { dehydrateQueryClient } from "./dehydrate";
+import { getQueryStatusLabel } from "../utils/getQueryStatusLabel";
 export function createReactQuerySyncAdapter(queryClient) {
   const getQuery = params => {
     const {
@@ -40,6 +41,46 @@ export function createReactQuerySyncAdapter(queryClient) {
       };
     },
     actions: {
+      /**
+       * Compact, token-bounded cache reader for a remote driver (MCP/LLM):
+       * projects each live query to light fields (hash, key, status label,
+       * staleness, observers, error message) — the heavy cached `data` stays on
+       * the device unless `includeData` is set. Unlike getSnapshot (full
+       * dehydrated cache), this is safe to read repeatedly.
+       */
+      listQueries: params => {
+        const {
+          includeData = false,
+          staleOnly = false,
+          limit
+        } = params ?? {};
+        const all = queryClient.getQueryCache().getAll();
+        const filtered = staleOnly ? all.filter(q => q.isStale()) : all;
+        const sorted = [...filtered].sort((a, b) => (b.state.dataUpdatedAt ?? 0) - (a.state.dataUpdatedAt ?? 0));
+        const capped = typeof limit === "number" && limit > 0 ? sorted.slice(0, limit) : sorted;
+        const queries = capped.map(q => {
+          const err = q.state.error;
+          return {
+            queryHash: q.queryHash,
+            queryKey: q.queryKey,
+            status: getQueryStatusLabel(q),
+            fetchStatus: q.state.fetchStatus,
+            isStale: q.isStale(),
+            observers: q.getObserversCount(),
+            updatedAt: q.state.dataUpdatedAt,
+            error: err ? err.message ?? String(err) : undefined,
+            ...(includeData ? {
+              data: q.state.data
+            } : {})
+          };
+        });
+        return {
+          queries,
+          total: all.length,
+          returned: queries.length,
+          includedData: includeData
+        };
+      },
       refetch: params => {
         const query = getQuery(params);
         // Swallow fetch rejections — the resulting error state syncs anyway

package/lib/typescript/react-query/sync/reactQuerySyncAdapter.d.ts

@@ -17,6 +17,29 @@ export declare function createReactQuerySyncAdapter(queryClient: QueryClient): {
     };
     subscribe: (onChange: () => void) => () => void;
     actions: {
+        /**
+         * Compact, token-bounded cache reader for a remote driver (MCP/LLM):
+         * projects each live query to light fields (hash, key, status label,
+         * staleness, observers, error message) — the heavy cached `data` stays on
+         * the device unless `includeData` is set. Unlike getSnapshot (full
+         * dehydrated cache), this is safe to read repeatedly.
+         */
+        listQueries: (params: unknown) => {
+            queries: {
+                data?: unknown;
+                queryHash: string;
+                queryKey: readonly unknown[];
+                status: "error" | "fetching" | "paused" | "disabled" | "inactive" | "stale" | "fresh";
+                fetchStatus: import("@tanstack/query-core").FetchStatus;
+                isStale: boolean;
+                observers: number;
+                updatedAt: number;
+                error: string | undefined;
+            }[];
+            total: number;
+            returned: number;
+            includedData: boolean;
+        };
         refetch: (params: unknown) => Promise<unknown>;
         invalidate: (params: unknown) => Promise<void>;
         reset: (params: unknown) => Promise<void>;

package/lib/typescript/react-query/sync/reactQuerySyncAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactQuerySyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/react-query/sync/reactQuerySyncAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAiB,KAAK,WAAW,EAAiB,MAAM,uBAAuB,CAAC;AAgBvF,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,WAAW;;;;;;0BAgB1C,MAAM,IAAI;;0BAaZ,OAAO;6BAKJ,OAAO;wBAEZ,OAAO;yBACN,OAAO;+BAGD,OAAO;+BAIP,OAAO;+BAaP,OAAO;iCAEL,OAAO;iCAwBP,OAAO;;;4BA4BZ,OAAO;;EAMhC"}
+{"version":3,"file":"reactQuerySyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/react-query/sync/reactQuerySyncAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAiB,KAAK,WAAW,EAAiB,MAAM,uBAAuB,CAAC;AA0BvF,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,WAAW;;;;;;0BAgB1C,MAAM,IAAI;;QAa9B;;;;;;WAMG;8BACmB,OAAO;;;;;;;;;;;;;;;;0BAkCX,OAAO;6BAKJ,OAAO;wBAEZ,OAAO;yBACN,OAAO;+BAGD,OAAO;+BAIP,OAAO;+BAaP,OAAO;iCAEL,OAAO;iCAwBP,OAAO;;;4BA4BZ,OAAO;;EAMhC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/react-query",
-  "version": "4.0.1",
+  "version": "4.0.2",
   "description": "react-query package",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -26,8 +26,8 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/floating-tools-core": "4.0.1",
-    "@buoy-gg/shared-ui": "4.0.1"
+    "@buoy-gg/floating-tools-core": "4.0.2",
+    "@buoy-gg/shared-ui": "4.0.2"
   },
   "peerDependencies": {
     "@tanstack/react-query": ">=5.0.0",