@rozenite/tanstack-query-plugin 2.1.0 → 2.3.0

package/dist/sdk/src/shared/agent-tools.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tanstackQueryToolDefinitions = exports.TANSTACK_QUERY_AGENT_PLUGIN_ID = void 0;
+const agent_shared_1 = require("@rozenite/agent-shared");
+exports.TANSTACK_QUERY_AGENT_PLUGIN_ID = '@rozenite/tanstack-query-plugin';
+const queryActionProperties = {
+    queryHash: {
+        type: 'string',
+        description: 'TanStack Query queryHash identifying the query.',
+    },
+};
+const mutationActionProperties = {
+    mutationId: {
+        type: 'number',
+        description: 'TanStack Query mutationId identifying the mutation.',
+    },
+};
+const paginationProperties = {
+    limit: {
+        type: 'number',
+        description: 'Maximum number of items to return. Defaults to 20. Maximum 100.',
+    },
+    cursor: {
+        type: 'string',
+        description: 'Opaque pagination cursor from a previous list call.',
+    },
+};
+const emptyInputSchema = {
+    type: 'object',
+    properties: {},
+};
+exports.tanstackQueryToolDefinitions = {
+    getCacheSummary: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'get-cache-summary',
+        description: 'Return aggregate TanStack Query cache health and count information.',
+        inputSchema: emptyInputSchema,
+    }),
+    getOnlineStatus: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'get-online-status',
+        description: 'Return the current TanStack Query onlineManager status.',
+        inputSchema: emptyInputSchema,
+    }),
+    setOnlineStatus: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'set-online-status',
+        description: 'Set the TanStack Query onlineManager status for testing offline/online behavior.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                online: {
+                    type: 'boolean',
+                    description: 'Whether the TanStack Query onlineManager should be online.',
+                },
+            },
+            required: ['online'],
+        },
+    }),
+    listQueries: (0, agent_shared_1.definePaginatedAgentToolContract)({
+        name: 'list-queries',
+        description: 'List TanStack Query query summaries using cursor pagination.',
+        inputSchema: {
+            type: 'object',
+            properties: paginationProperties,
+        },
+        pagination: {
+            kind: 'cursor',
+            fields: [
+                'queryHash',
+                'queryKey',
+                'status',
+                'fetchStatus',
+                'observersCount',
+                'isInvalidated',
+                'dataUpdatedAt',
+                'errorUpdatedAt',
+                'hasData',
+                'hasError',
+            ],
+            defaultFields: ['queryHash', 'queryKey', 'status', 'fetchStatus', 'hasError'],
+        },
+    }),
+    getQueryDetails: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'get-query-details',
+        description: 'Return a JSON-safe TanStack Query query snapshot and observer summary.',
+        inputSchema: {
+            type: 'object',
+            properties: queryActionProperties,
+            required: ['queryHash'],
+        },
+    }),
+    refetchQuery: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'refetch-query',
+        description: 'Refetch a TanStack Query query by queryHash.',
+        inputSchema: {
+            type: 'object',
+            properties: queryActionProperties,
+            required: ['queryHash'],
+        },
+    }),
+    setQueryLoading: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'set-query-loading',
+        description: 'Enable or disable TanStack Query loading-state simulation for a query by queryHash.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...queryActionProperties,
+                enabled: {
+                    type: 'boolean',
+                    description: 'Whether the loading-state simulation should be enabled.',
+                },
+            },
+            required: ['queryHash', 'enabled'],
+        },
+    }),
+    setQueryError: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'set-query-error',
+        description: 'Enable or disable TanStack Query error-state simulation for a query by queryHash.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...queryActionProperties,
+                enabled: {
+                    type: 'boolean',
+                    description: 'Whether the error-state simulation should be enabled.',
+                },
+            },
+            required: ['queryHash', 'enabled'],
+        },
+    }),
+    invalidateQuery: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'invalidate-query',
+        description: 'Invalidate a TanStack Query query by queryHash.',
+        inputSchema: {
+            type: 'object',
+            properties: queryActionProperties,
+            required: ['queryHash'],
+        },
+    }),
+    resetQuery: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'reset-query',
+        description: 'Reset a TanStack Query query by queryHash.',
+        inputSchema: {
+            type: 'object',
+            properties: queryActionProperties,
+            required: ['queryHash'],
+        },
+    }),
+    removeQuery: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'remove-query',
+        description: 'Remove a TanStack Query query from the cache by queryHash.',
+        inputSchema: {
+            type: 'object',
+            properties: queryActionProperties,
+            required: ['queryHash'],
+        },
+    }),
+    clearQueryCache: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'clear-query-cache',
+        description: 'Clear the full TanStack Query query cache.',
+        inputSchema: emptyInputSchema,
+    }),
+    listMutations: (0, agent_shared_1.definePaginatedAgentToolContract)({
+        name: 'list-mutations',
+        description: 'List TanStack Query mutation summaries using cursor pagination.',
+        inputSchema: {
+            type: 'object',
+            properties: paginationProperties,
+        },
+        pagination: {
+            kind: 'cursor',
+            fields: [
+                'mutationId',
+                'mutationKey',
+                'status',
+                'isPaused',
+                'submittedAt',
+                'failureCount',
+                'hasData',
+                'hasError',
+            ],
+            defaultFields: ['mutationId', 'mutationKey', 'status', 'hasError'],
+        },
+    }),
+    getMutationDetails: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'get-mutation-details',
+        description: 'Return a JSON-safe TanStack Query mutation snapshot for a mutationId.',
+        inputSchema: {
+            type: 'object',
+            properties: mutationActionProperties,
+            required: ['mutationId'],
+        },
+    }),
+    clearMutationCache: (0, agent_shared_1.defineAgentToolContract)({
+        name: 'clear-mutation-cache',
+        description: 'Clear the full TanStack Query mutation cache.',
+        inputSchema: emptyInputSchema,
+    }),
+};

package/dist/sdk/src/shared/types.d.ts

@@ -0,0 +1,25 @@
+import type { QueryKey, MutationState, QueryState, QueryObserverOptions, InfiniteQueryObserverOptions, MutationOptions } from '@tanstack/react-query';
+export type SerializableQuery = {
+    queryHash: string;
+    state: QueryState;
+    queryKey: QueryKey;
+    observers: SerializableObserver[];
+};
+export type PartialQueryState = {
+    queryHash: string;
+    state: Partial<QueryState>;
+};
+export type SerializableMutation = {
+    mutationId: number;
+    options: MutationOptions;
+    state: MutationState;
+};
+export type SerializableObserver = {
+    queryHash: string;
+    options: QueryObserverOptions | InfiniteQueryObserverOptions;
+};
+export type SerializableQueryClient = {
+    queries: SerializableQuery[];
+    mutations: SerializableMutation[];
+};
+export type DevToolsActionType = 'REFETCH' | 'SET_QUERY_DATA' | 'INVALIDATE' | 'RESET' | 'REMOVE' | 'TRIGGER_ERROR' | 'RESTORE_ERROR' | 'TRIGGER_LOADING' | 'RESTORE_LOADING' | 'CLEAR_MUTATION_CACHE' | 'CLEAR_QUERY_CACHE';

package/dist/sdk/src/shared/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rozenite/tanstack-query-plugin",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "TanStack Query for Rozenite.",
   "homepage": "https://github.com/callstackincubator/rozenite#readme",
   "bugs": {
@@ -12,21 +12,20 @@
     "url": "https://github.com/callstackincubator/rozenite.git"
   },
   "type": "module",
-  "main": "./dist/react-native/index.cjs",
-  "module": "./dist/react-native/index.js",
-  "types": "./dist/react-native/index.d.ts",
+  "main": "./dist/react-native/cjs/react-native.js",
+  "module": "./dist/react-native/react-native.js",
+  "types": "./dist/react-native/react-native.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/react-native/index.d.ts",
-      "import": "./dist/react-native/index.js",
-      "require": "./dist/react-native/index.cjs"
+      "types": "./dist/react-native/react-native.d.ts",
+      "import": "./dist/react-native/react-native.js",
+      "require": "./dist/react-native/cjs/react-native.js"
     },
     "./package.json": "./package.json",
     "./sdk": {
       "development": "./sdk.ts",
-      "types": "./dist/sdk/index.d.ts",
-      "import": "./dist/sdk/index.js",
-      "require": "./dist/sdk/index.cjs"
+      "types": "./dist/sdk/sdk.d.ts",
+      "default": "./dist/sdk/sdk.js"
     }
   },
   "publishConfig": {
@@ -34,9 +33,9 @@
   },
   "dependencies": {
     "fast-deep-equal": "^3.1.3",
-    "@rozenite/agent-bridge": "2.1.0",
-    "@rozenite/agent-shared": "2.1.0",
-    "@rozenite/plugin-bridge": "2.1.0"
+    "@rozenite/agent-bridge": "2.3.0",
+    "@rozenite/agent-shared": "2.3.0",
+    "@rozenite/plugin-bridge": "2.3.0"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.0.0",
@@ -48,18 +47,19 @@
     "react-native-web": "^0.21.2",
     "typescript": "~5.9.3",
     "vite": "^7.3.1",
-    "@rozenite/vite-plugin": "2.1.0",
-    "rozenite": "2.1.0"
+    "@rozenite/test-utils": "2.3.0",
+    "@rozenite/vite-plugin": "2.3.0",
+    "rozenite": "2.3.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",
-    "react": "*",
-    "react-native": "*"
+    "react": "*"
   },
   "scripts": {
     "build": "rozenite build",
     "dev": "rozenite dev",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "lint": "eslint ."
+    "lint": "eslint .",
+    "test": "vitest --run --passWithNoTests"
   }
 }

package/react-native.ts

@@ -1,7 +1,14 @@
 export let useTanStackQueryDevTools: typeof import('./src/react-native/useTanStackQueryDevTools').useTanStackQueryDevTools;
 
+// Neither Lynx runtime has a `window`, so `typeof window` alone reported
+// every Lynx app as a server and installed the no-op stub below. `lynx` is
+// a free binding in module scope, not a property of `globalThis`. Kept
+// inline rather than imported so this stays a foldable expression and the
+// `require`s below can still be dropped from production bundles.
+declare const lynx: unknown;
+
 const isDev = process.env.NODE_ENV !== 'production';
-const isServer = typeof window === 'undefined';
+const isServer = typeof window === 'undefined' && typeof lynx === 'undefined';
 
 if (isDev && !isServer) {
   useTanStackQueryDevTools =

package/rozenite.config.ts

@@ -1,4 +1,5 @@
 export default {
+  integrations: ['react-native', 'react-native-web', 'lynx', 'lynx-web'],
   panels: [
     {
       name: 'Tanstack Query',

package/src/__tests__/release-bundle.test.ts

@@ -0,0 +1,32 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { bundleForRelease, RELEASE_BUNDLE_TIMEOUT } from '@rozenite/test-utils';
+import { describe, expect, it } from 'vitest';
+
+// An app importing this plugin ships its React Native code -- that much is
+// the app's own choice. What must never follow it into the bundle is the
+// panel: the DevTools UI, its React DOM tree and `@rozenite/ui`.
+// See docs/agents/release-bundle-testing.md.
+const packageRoot = path.resolve(fileURLToPath(import.meta.url), '../../..');
+const reactNativeEntry = path.join(packageRoot, 'dist/react-native/cjs/react-native.js');
+
+describe('@rozenite/tanstack-query-plugin in a release bundle', () => {
+  it(
+    'ships no panel code when an app imports it',
+    async () => {
+      const result = await bundleForRelease({
+        resolveFrom: packageRoot,
+        files: {
+          'index.js': `require(${JSON.stringify(reactNativeEntry)});\n`,
+        },
+      });
+
+      // Keeps the check below honest: the entry really did get bundled.
+      expect(result.rozeniteModules).toContain(
+        'packages/tanstack-query-plugin/dist/react-native/cjs/react-native.js',
+      );
+      expect(result.panelModules).toEqual([]);
+    },
+    RELEASE_BUNDLE_TIMEOUT,
+  );
+});

package/tsconfig.json

@@ -11,9 +11,7 @@
     "noFallthroughCasesInSwitch": true,
     "module": "ESNext",
     "moduleResolution": "bundler",
-    "paths": {
-      "@rozenite/agent-shared": ["../agent-shared/src/index.ts"]
-    },
+    "customConditions": ["development"],
     "resolveJsonModule": true,
     "isolatedModules": true,
     "noEmit": true,

package/dist/react-native/chunks/useTanStackQueryDevTools.require.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k=require("@rozenite/plugin-bridge"),b=require("react"),A=require("@tanstack/react-query"),C=require("fast-deep-equal"),i=require("@rozenite/agent-bridge"),c=require("@rozenite/agent-shared"),D=e=>e&&e.__esModule?e:{default:e},_=D(C),w=e=>{b.useEffect(()=>{if(!e)return;const a=A.onlineManager.subscribe(r=>{e.send("online-status-changed",{online:r})}),t=e.onMessage("online-status-changed",({online:r})=>{A.onlineManager.setOnline(r)});return()=>{a(),t.remove()}},[e])},g=(e,a)=>{if(!a)throw new Error("queryHash is required for this TanStack Query action.");const t=e.getQueryCache().get(a);if(!t)throw new Error(`No active query found for hash: ${a}`);return t},f=async(e,a)=>{switch(a.type){case"CLEAR_QUERY_CACHE":{const t=e.getQueryCache().getAll().length;return e.getQueryCache().clear(),{applied:!0,action:a.type,cleared:!0,queryCountBefore:t,queryCountAfter:e.getQueryCache().getAll().length}}case"CLEAR_MUTATION_CACHE":{const t=e.getMutationCache().getAll().length;return e.getMutationCache().clear(),{applied:!0,action:a.type,cleared:!0,mutationCountBefore:t,mutationCountAfter:e.getMutationCache().getAll().length}}case"SET_QUERY_DATA":{const t=g(e,a.queryHash);return e.setQueryData(t.queryKey,a.metadata?.data),{applied:!0,action:a.type,queryHash:t.queryHash}}case"TRIGGER_ERROR":{const t=g(e,a.queryHash),r=t.options,s=new Error("Unknown error from devtools");return t.setState({status:"error",error:s,fetchMeta:{...t.state.fetchMeta,__previousQueryOptions:r}}),{applied:!0,action:a.type,queryHash:t.queryHash}}case"RESTORE_ERROR":{const t=g(e,a.queryHash);return await e.resetQueries(t),{applied:!0,action:a.type,queryHash:t.queryHash}}case"TRIGGER_LOADING":{const t=g(e,a.queryHash),r=t.options;return t.fetch({...r,queryFn:()=>new Promise(()=>{}),gcTime:-1}),t.setState({data:void 0,status:"pending",fetchMeta:{...t.state.fetchMeta,__previousQueryOptions:r}}),{applied:!0,action:a.type,queryHash:t.queryHash}}case"RESTORE_LOADING":{const t=g(e,a.queryHash),r=t.state,s=t.state.fetchMeta?t.state.fetchMeta.__previousQueryOptions:null;return t.cancel({silent:!0}),t.setState({...r,fetchStatus:"idle",fetchMeta:null}),s&&t.fetch(s),{applied:!0,action:a.type,queryHash:t.queryHash}}case"RESET":{const t=g(e,a.queryHash);return await e.resetQueries(t),{applied:!0,action:a.type,queryHash:t.queryHash}}case"REMOVE":{const t=g(e,a.queryHash);return e.removeQueries(t),{applied:!0,action:a.type,queryHash:t.queryHash}}case"REFETCH":{const t=g(e,a.queryHash);return await t.fetch().catch(()=>{}),{applied:!0,action:a.type,queryHash:t.queryHash}}case"INVALIDATE":{const t=g(e,a.queryHash);return await e.invalidateQueries(t),{applied:!0,action:a.type,queryHash:t.queryHash}}}},U=(e,a)=>{b.useEffect(()=>{if(!a)return;const t=a.onMessage("devtools-action",({type:r,queryHash:s,metadata:h})=>{f(e,{type:r,queryHash:s,metadata:h}).catch(l=>{const n=l instanceof Error?l.message:String(l);console.warn(`[Rozenite, tanstack-query-plugin] Failed to apply devtools action "${r}": ${n}`)})});return()=>{t.remove()}},[a])},O=e=>e.observers.map(a=>({queryHash:e.queryHash,options:a.options})),q=e=>{const a=O(e);return{state:e.state,queryKey:e.queryKey,queryHash:e.queryHash,observers:a}},I=e=>({mutationId:e.mutationId,state:e.state,options:e.options}),P=e=>({queries:e.getQueryCache().getAll().map(q),mutations:e.getMutationCache().getAll().map(I)}),G=(e,a)=>{const t=b.useRef(new Map),r=b.useMemo(()=>s=>{if(!a||s.type==="observerResultsUpdated")return;if("query"in s){const{query:n,type:p}=s;if(p==="added"||p==="removed"){p==="removed"&&t.current.delete(n.queryHash);const m=q(n);a.send("sync-query-event",{type:p,data:m});return}if(p==="updated"&&"action"in s){const m=s.action;switch(m.type){case"fetch":{const u={queryHash:n.queryHash,state:{status:n.state.status,fetchStatus:n.state.fetchStatus,fetchMeta:n.state.fetchMeta,dataUpdatedAt:n.state.dataUpdatedAt,errorUpdatedAt:n.state.errorUpdatedAt}};a.send("sync-query-event",{type:"updated",action:"fetch",data:u});break}case"success":{const u={queryHash:n.queryHash,state:{status:n.state.status,data:n.state.data,dataUpdatedAt:n.state.dataUpdatedAt,error:n.state.error,errorUpdatedAt:n.state.errorUpdatedAt,fetchStatus:n.state.fetchStatus}};a.send("sync-query-event",{type:"updated",action:"success",data:u});break}case"error":{const u={queryHash:n.queryHash,state:{status:n.state.status,error:n.state.error,errorUpdatedAt:n.state.errorUpdatedAt,fetchStatus:n.state.fetchStatus}};a.send("sync-query-event",{type:"updated",action:"error",data:u});break}case"setState":{const u={queryHash:n.queryHash,state:m.state};a.send("sync-query-event",{type:"updated",action:"setState",data:u});break}case"invalidate":{const u={queryHash:n.queryHash,state:{isInvalidated:n.state.isInvalidated}};a.send("sync-query-event",{type:"updated",action:"invalidate",data:u});break}case"pause":{const u={queryHash:n.queryHash,state:{fetchStatus:n.state.fetchStatus}};a.send("sync-query-event",{type:"updated",action:"pause",data:u});break}case"continue":{const u={queryHash:n.queryHash,state:{fetchStatus:n.state.fetchStatus}};a.send("sync-query-event",{type:"updated",action:"continue",data:u});break}default:{const u=q(n);a.send("sync-query-event",{type:p,data:u})}}return}if(p==="observerAdded"||p==="observerRemoved"||p==="observerOptionsUpdated"){const m=O(n),u=t.current.get(n.queryHash);if(p==="observerOptionsUpdated"&&u&&_.default(u,m))return;t.current.set(n.queryHash,m),a.send("sync-query-event",{type:p,data:{queryHash:n.queryHash,observers:m}});return}}const{mutation:h,type:l}=s;if(h){const n=I(h);a.send("sync-mutation-event",{type:l,data:n})}},[a]);b.useEffect(()=>{if(!a)return;const s=e.getMutationCache().subscribe(r),h=e.getQueryCache().subscribe(r);return()=>{s(),h()}},[a,e,r])},j=(e,a)=>{b.useEffect(()=>{if(!a)return;const t=a.onMessage("request-initial-data",()=>{const r=P(e);a.send("sync-data",{data:r})});return a.send("device-ready",{}),()=>{t.remove()}},[a,e])},d="@rozenite/tanstack-query-plugin",S={queryHash:{type:"string",description:"TanStack Query queryHash identifying the query."}},z={mutationId:{type:"number",description:"TanStack Query mutationId identifying the mutation."}},M={limit:{type:"number",description:"Maximum number of items to return. Defaults to 20. Maximum 100."},cursor:{type:"string",description:"Opaque pagination cursor from a previous list call."}},T={type:"object",properties:{}},y={getCacheSummary:c.defineAgentToolContract({name:"get-cache-summary",description:"Return aggregate TanStack Query cache health and count information.",inputSchema:T}),getOnlineStatus:c.defineAgentToolContract({name:"get-online-status",description:"Return the current TanStack Query onlineManager status.",inputSchema:T}),setOnlineStatus:c.defineAgentToolContract({name:"set-online-status",description:"Set the TanStack Query onlineManager status for testing offline/online behavior.",inputSchema:{type:"object",properties:{online:{type:"boolean",description:"Whether the TanStack Query onlineManager should be online."}},required:["online"]}}),listQueries:c.definePaginatedAgentToolContract({name:"list-queries",description:"List TanStack Query query summaries using cursor pagination.",inputSchema:{type:"object",properties:M},pagination:{kind:"cursor",fields:["queryHash","queryKey","status","fetchStatus","observersCount","isInvalidated","dataUpdatedAt","errorUpdatedAt","hasData","hasError"],defaultFields:["queryHash","queryKey","status","fetchStatus","hasError"]}}),getQueryDetails:c.defineAgentToolContract({name:"get-query-details",description:"Return a JSON-safe TanStack Query query snapshot and observer summary.",inputSchema:{type:"object",properties:S,required:["queryHash"]}}),refetchQuery:c.defineAgentToolContract({name:"refetch-query",description:"Refetch a TanStack Query query by queryHash.",inputSchema:{type:"object",properties:S,required:["queryHash"]}}),setQueryLoading:c.defineAgentToolContract({name:"set-query-loading",description:"Enable or disable TanStack Query loading-state simulation for a query by queryHash.",inputSchema:{type:"object",properties:{...S,enabled:{type:"boolean",description:"Whether the loading-state simulation should be enabled."}},required:["queryHash","enabled"]}}),setQueryError:c.defineAgentToolContract({name:"set-query-error",description:"Enable or disable TanStack Query error-state simulation for a query by queryHash.",inputSchema:{type:"object",properties:{...S,enabled:{type:"boolean",description:"Whether the error-state simulation should be enabled."}},required:["queryHash","enabled"]}}),invalidateQuery:c.defineAgentToolContract({name:"invalidate-query",description:"Invalidate a TanStack Query query by queryHash.",inputSchema:{type:"object",properties:S,required:["queryHash"]}}),resetQuery:c.defineAgentToolContract({name:"reset-query",description:"Reset a TanStack Query query by queryHash.",inputSchema:{type:"object",properties:S,required:["queryHash"]}}),removeQuery:c.defineAgentToolContract({name:"remove-query",description:"Remove a TanStack Query query from the cache by queryHash.",inputSchema:{type:"object",properties:S,required:["queryHash"]}}),clearQueryCache:c.defineAgentToolContract({name:"clear-query-cache",description:"Clear the full TanStack Query query cache.",inputSchema:T}),listMutations:c.definePaginatedAgentToolContract({name:"list-mutations",description:"List TanStack Query mutation summaries using cursor pagination.",inputSchema:{type:"object",properties:M},pagination:{kind:"cursor",fields:["mutationId","mutationKey","status","isPaused","submittedAt","failureCount","hasData","hasError"],defaultFields:["mutationId","mutationKey","status","hasError"]}}),getMutationDetails:c.defineAgentToolContract({name:"get-mutation-details",description:"Return a JSON-safe TanStack Query mutation snapshot for a mutationId.",inputSchema:{type:"object",properties:z,required:["mutationId"]}}),clearMutationCache:c.defineAgentToolContract({name:"clear-mutation-cache",description:"Clear the full TanStack Query mutation cache.",inputSchema:T})},N=20,L=100,F=e=>!!e&&typeof e=="object"&&Object.getPrototypeOf(e)===Object.prototype,o=(e,a=new WeakSet)=>{if(e==null)return null;if(typeof e=="string"||typeof e=="boolean")return e;if(typeof e=="number")return Number.isFinite(e)?e:String(e);if(typeof e=="bigint")return e.toString();if(typeof e=="function"||typeof e=="symbol")return`[non-serializable:${typeof e}]`;if(e instanceof Date)return e.toISOString();if(e instanceof Error)return{name:e.name,message:e.message,stack:e.stack??null,cause:o(e.cause,a)};if(Array.isArray(e))return e.map(t=>o(t,a));if(ArrayBuffer.isView(e))return Array.from(e).map(t=>typeof t=="number"?t:Number(t));if(e instanceof ArrayBuffer)return Array.from(new Uint8Array(e));if(typeof e=="object"){if(a.has(e))return"[circular]";if(a.add(e),!F(e))return`[non-serializable:${e.constructor?.name??"Object"}]`;const t=Object.entries(e).map(([r,s])=>[r,o(s,a)]);return Object.fromEntries(t)}return String(e)},K=e=>typeof e!="number"||!Number.isFinite(e)||!Number.isInteger(e)||e<1?N:Math.min(e,L),$=(e,a,t)=>`${e}:${a}:${t}`,x=(e,a,t)=>{const[r,s,h]=e.split(":",3);if(r!==a||!s||!h)throw new Error("Cursor does not match the requested listing. Run the command again.");const l=Number(s),n=Number(h);if(!Number.isInteger(l)||l!==t)throw new Error("Cursor does not match the requested listing. Run the command again.");if(!Number.isInteger(n)||n<0)throw new Error("Cursor is invalid. Run the command again.");return n},E=(e,a,t,r)=>{const s=K(r.limit),h=r.cursor?x(r.cursor,a,t):0,l=Math.min(h+s,e.length),n=l<e.length;return{items:e.slice(h,l),page:{limit:s,hasMore:n,...n?{nextCursor:$(a,t,l)}:{}}}},B=e=>e?{enabled:o(e.enabled),networkMode:o(e.networkMode),staleTime:o(e.staleTime),gcTime:o(e.gcTime),retry:o(e.retry),retryDelay:o(e.retryDelay),refetchInterval:o(e.refetchInterval),refetchOnMount:o(e.refetchOnMount),refetchOnReconnect:o(e.refetchOnReconnect),refetchOnWindowFocus:o(e.refetchOnWindowFocus),subscribed:o(e.subscribed),meta:o(e.meta),hasQueryFn:typeof e.queryFn=="function",hasSelect:typeof e.select=="function",hasPlaceholderData:"placeholderData"in e,hasInitialData:"initialData"in e}:null,W=e=>({mutationKey:o(e.mutationKey),networkMode:o(e.networkMode),gcTime:o(e.gcTime),retry:o(e.retry),retryDelay:o(e.retryDelay),meta:o(e.meta),scope:o(e.scope),hasMutationFn:typeof e.mutationFn=="function",hasOnMutate:typeof e.onMutate=="function",hasOnSuccess:typeof e.onSuccess=="function",hasOnError:typeof e.onError=="function",hasOnSettled:typeof e.onSettled=="function"}),H=e=>Math.max(e.state.dataUpdatedAt,e.state.errorUpdatedAt),V=(e,a)=>H(a)-H(e)||a.getObserversCount()-e.getObserversCount()||String(a.queryHash).localeCompare(String(e.queryHash)),Y=(e,a)=>a.state.submittedAt-e.state.submittedAt||a.mutationId-e.mutationId,v=e=>({queryHash:e.queryHash,queryKey:o(e.queryKey),status:e.state.status,fetchStatus:e.state.fetchStatus,observersCount:e.getObserversCount(),isInvalidated:e.state.isInvalidated,dataUpdatedAt:e.state.dataUpdatedAt,errorUpdatedAt:e.state.errorUpdatedAt,hasData:e.state.data!==void 0,hasError:e.state.error!=null}),J=e=>e.status,R=e=>({mutationId:e.mutationId,mutationKey:o(e.options.mutationKey),status:J(e.state),isPaused:e.state.isPaused,submittedAt:e.state.submittedAt,failureCount:e.state.failureCount,hasData:e.state.data!==void 0,hasError:e.state.error!=null}),X=(e,a)=>{const t=e.getQueryCache().get(a);if(!t){const r=e.getQueryCache().getAll().map(s=>s.queryHash).join(", ");throw new Error(`Unknown queryHash "${a}". Available: ${r||"(none)"}`)}return t},Z=(e,a)=>{const t=e.getMutationCache().getAll().find(r=>r.mutationId===a);if(!t){const r=e.getMutationCache().getAll().map(s=>s.mutationId).join(", ");throw new Error(`Unknown mutationId "${a}". Available: ${r||"(none)"}`)}return t},Q=e=>{const a=e.getQueryCache().getAll(),t=e.getMutationCache().getAll();return{online:A.onlineManager.isOnline(),queries:{total:a.length,active:a.filter(r=>r.getObserversCount()>0).length,fetching:a.filter(r=>r.state.fetchStatus==="fetching").length,pending:a.filter(r=>r.state.status==="pending").length,success:a.filter(r=>r.state.status==="success").length,error:a.filter(r=>r.state.status==="error").length,invalidated:a.filter(r=>r.state.isInvalidated).length},mutations:{total:t.length,pending:t.filter(r=>r.state.status==="pending").length,success:t.filter(r=>r.state.status==="success").length,error:t.filter(r=>r.state.status==="error").length,paused:t.filter(r=>r.state.isPaused).length}}},ee=e=>{const a={queriesGeneration:0,mutationsGeneration:0};return{handleQueryCacheEvent(t){(t.type==="added"||t.type==="removed")&&(a.queriesGeneration+=1)},handleMutationCacheEvent(t){(t.type==="added"||t.type==="removed")&&(a.mutationsGeneration+=1)},getCacheSummary(){return Q(e)},getOnlineStatus(){return{online:A.onlineManager.isOnline()}},setOnlineStatus({online:t}){return A.onlineManager.setOnline(t),{online:A.onlineManager.isOnline()}},listQueries(t={}){const r=[...e.getQueryCache().getAll()].sort(V);return{...Q(e),total:r.length,...E(r.map(v),"queries",a.queriesGeneration,t)}},getQueryDetails({queryHash:t}){const r=X(e,t);return{summary:Q(e),query:{...v(r),data:o(r.state.data),error:o(r.state.error),observers:r.observers.map(s=>({queryHash:r.queryHash,options:B(s.options)}))}}},async refetchQuery({queryHash:t}){return f(e,{type:"REFETCH",queryHash:t})},async setQueryLoading({queryHash:t,enabled:r}){return f(e,{type:r?"TRIGGER_LOADING":"RESTORE_LOADING",queryHash:t})},async setQueryError({queryHash:t,enabled:r}){return f(e,{type:r?"TRIGGER_ERROR":"RESTORE_ERROR",queryHash:t})},async invalidateQuery({queryHash:t}){return f(e,{type:"INVALIDATE",queryHash:t})},async resetQuery({queryHash:t}){return f(e,{type:"RESET",queryHash:t})},async removeQuery({queryHash:t}){return f(e,{type:"REMOVE",queryHash:t})},async clearQueryCache(){return f(e,{type:"CLEAR_QUERY_CACHE"})},listMutations(t={}){const r=[...e.getMutationCache().getAll()].sort(Y);return{...Q(e),total:r.length,...E(r.map(R),"mutations",a.mutationsGeneration,t)}},getMutationDetails({mutationId:t}){const r=Z(e,t);return{summary:Q(e),mutation:{...R(r),variables:o(r.state.variables),data:o(r.state.data),error:o(r.state.error),context:o(r.state.context),failureReason:o(r.state.failureReason),options:W(r.options)}}},async clearMutationCache(){return f(e,{type:"CLEAR_MUTATION_CACHE"})}}},te=e=>{const a=b.useMemo(()=>ee(e),[e]);b.useEffect(()=>{const t=e.getQueryCache().subscribe(s=>a.handleQueryCacheEvent(s)),r=e.getMutationCache().subscribe(s=>a.handleMutationCacheEvent(s));return()=>{t(),r()}},[a,e]),i.useRozenitePluginAgentTool({pluginId:d,tool:y.getCacheSummary,handler:()=>a.getCacheSummary()}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.getOnlineStatus,handler:()=>a.getOnlineStatus()}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.setOnlineStatus,handler:t=>a.setOnlineStatus(t)}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.listQueries,handler:(t={})=>a.listQueries(t)}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.getQueryDetails,handler:t=>a.getQueryDetails(t)}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.refetchQuery,handler:t=>a.refetchQuery(t)}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.setQueryLoading,handler:t=>a.setQueryLoading(t)}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.setQueryError,handler:t=>a.setQueryError(t)}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.invalidateQuery,handler:t=>a.invalidateQuery(t)}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.resetQuery,handler:t=>a.resetQuery(t)}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.removeQuery,handler:t=>a.removeQuery(t)}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.clearQueryCache,handler:()=>a.clearQueryCache()}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.listMutations,handler:(t={})=>a.listMutations(t)}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.getMutationDetails,handler:t=>a.getMutationDetails(t)}),i.useRozenitePluginAgentTool({pluginId:d,tool:y.clearMutationCache,handler:()=>a.clearMutationCache()})},ae=e=>{const a=k.useRozeniteDevToolsClient({pluginId:"@rozenite/tanstack-query-plugin"});w(a),U(e,a),G(e,a),j(e,a),te(e)};exports.useTanStackQueryDevTools=ae;