@buoy-gg/react-query 7.0.40 → 7.0.42

package/README.md

@@ -1,85 +1,27 @@
-# @buoy-gg/react-query
+<div align="center">
 
-[![npm version](https://img.shields.io/npm/v/@buoy-gg/react-query?style=flat-square&labelColor=1c1c1c&color=10B981)](https://www.npmjs.com/package/@buoy-gg/react-query) [![npm downloads](https://img.shields.io/npm/dm/@buoy-gg/react-query?style=flat-square&labelColor=1c1c1c&color=10B981)](https://www.npmjs.com/package/@buoy-gg/react-query)
+# @buoy-gg/react-query
 
 Inspect the TanStack Query cache used by your app. Refetch or invalidate a query and simulate states while checking the screen that consumes it.
 
-Part of [Buoy](https://github.com/Buoy-gg/buoy). Install the package, complete account setup, and follow the integration steps below.
-
-![React Query DevTools demo](https://github.com/user-attachments/assets/258e892d-3eaf-41f8-9fae-d7d2dcd6c39d)
-
-## Install
+<a href="https://buoy.gg/buoy/latest/docs/tools/react-query"><b>React Query guide</b></a> &nbsp;·&nbsp; <a href="https://buoy.gg">buoy.gg</a> &nbsp;·&nbsp; <a href="https://github.com/Buoy-gg/buoy">All tools</a>
 
-```bash
-npm install @buoy-gg/core @buoy-gg/react-query
-```
+[![npm version](https://img.shields.io/npm/v/@buoy-gg/react-query?style=flat-square&labelColor=10302a&color=2a9d78)](https://www.npmjs.com/package/@buoy-gg/react-query) [![npm downloads](https://img.shields.io/npm/dm/@buoy-gg/react-query?style=flat-square&labelColor=10302a&color=2a9d78&label=downloads%2Fmonth)](https://www.npmjs.com/package/@buoy-gg/react-query)
 
-Requires `@tanstack/react-query` as a peer — you already have it if you use React Query.
+<a href="https://buoy.gg/buoy/latest/docs/tools/react-query"><img src="https://raw.githubusercontent.com/Buoy-gg/buoy/main/.github/readme/tools/react-query.png" alt="Watch the React Query film on buoy.gg" width="640" /></a>
 
-## Before you start
+</div>
 
-Use a development build with `@buoy-gg/core` and a Free or Pro Buoy account key. From your app’s directory, sign in:
+## Install
 
 ```bash
-npx --package=@buoy-gg/core buoy login
-```
-
-For Expo, initialize Buoy before rendering the menu:
-
-```tsx
-import { Buoy } from "@buoy-gg/core";
-
-Buoy.init({ licenseKey: process.env.EXPO_PUBLIC_BUOY_KEY });
-```
-
-The login command writes the Expo key to `.env.local`. For React Native CLI, pass the key from your app’s environment configuration; React Native does not load `.env.local` automatically. Mount `FloatingDevTools` inside the same providers as your screens and restart the development server after installation. The [Quick Start](https://buoy.gg/buoy/latest/docs/quick-start) shows the complete root component setup.
-
-## Quick start
-
-Render `FloatingDevTools` inside your `QueryClientProvider`. The tool picks up your `QueryClient` from context and connects automatically — no extra call needed.
-
-```tsx
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { FloatingDevTools } from '@buoy-gg/core';
-
-const queryClient = new QueryClient();
-
-export default function App() {
-  return (
-    <QueryClientProvider client={queryClient}>
-      <YourApp />
-      <FloatingDevTools />
-    </QueryClientProvider>
-  );
-}
+npm install @buoy-gg/core @buoy-gg/react-query
 ```
 
-That's it. The React Query tool (and a WiFi toggle) appear in the floating menu.
-
-## Check the integration
+Render `<FloatingDevTools />` inside your `QueryClientProvider` and the tool picks up your `QueryClient` from context.
 
-Open a known query, refetch it, and check the screen that uses it. Restore any simulated state after testing. The offline toggle changes TanStack Query’s online state; query behavior still depends on its `networkMode` and configuration.
-
-## What you get
-
-- **Cache inspection** — browse every query, drill into cached data with an interactive JSON tree, and edit values in place
-- **Refetch & invalidate** — trigger refetches or invalidate queries straight from the UI
-- **Simulate loading & error states** — test spinners and error boundaries without waiting on real network conditions
-- **One-tap offline toggle** — the WiFi switch drives React Query's `onlineManager` to pause all queries, perfect for offline-first testing
-- **Live mutation tracking** — status, variables, response or error, and timing for every mutation as it runs
-- **Query states at a glance** — fresh, stale, fetching, paused, and inactive across your whole cache
-- **Filter & search** — narrow by status or search by query key
-
-## Desktop & AI
-
-To connect a React Native app to [Buoy Desktop](https://github.com/Buoy-gg/Buoy-Desktop) or MCP, install `@buoy-gg/external-sync` and follow the [Desktop connection guide](https://buoy.gg/buoy/latest/docs/desktop). Sign in to Desktop separately. [MCP setup](https://buoy.gg/buoy/latest/docs/mcp) also requires a process account and Pro access. Available remote actions depend on the tool and app integration.
-
-## Account and plan requirements
-
-Use a Free or Pro Buoy account. History limits and paid features vary by tool; see [pricing](https://buoy.gg/pricing). Production access requires Pro where supported. Development-only hooks and actions remain unavailable in release builds.
+The [React Query guide](https://buoy.gg/buoy/latest/docs/tools/react-query) covers setup, what it captures and its limits. New to Buoy? Start with the [Quick start](https://buoy.gg/buoy/latest/docs/quick-start).
 
 ---
 
-📚 [Full docs](https://buoy.gg/buoy/latest/docs/tools/react-query) · [All Buoy tools](https://github.com/Buoy-gg/buoy)
-
-Proprietary software. © Buoy LLC. [Terms](https://buoy.gg/terms)
+<sub>Part of <a href="https://buoy.gg">Buoy</a>, developer tools that live inside your app. Proprietary software. © Buoy LLC. <a href="https://buoy.gg/terms">Terms</a></sub>

package/lib/commonjs/checkPeer.js

@@ -0,0 +1 @@
+"use strict";try{require("@tanstack/react-query")}catch(r){throw new Error("\n\n[@buoy-gg/react-query] ERROR: Missing required peer dependency\n\nThis package requires @tanstack/react-query to be installed.\n\nInstall 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\nFor more information, visit: https://tanstack.com/query/latest\n")}

package/lib/commonjs/checkPeer.web.js

@@ -0,0 +1 @@
+"use strict";require("@tanstack/react-query");