fetchium 0.2.1 → 0.2.3

package/plugin/docs/guides/error-handling.md

@@ -202,7 +202,7 @@ function UserProfile({ userId }: { userId: number }) {
 
 Sometimes you need to intercept errors _before_ they reach individual queries --- for instance, redirecting to a login page on a 401, refreshing an auth token, or logging all failures to a telemetry service.
 
-The `QueryClient` accepts a `fetch` function, which is the standard place to add global error handling. You can wrap the native `fetch` with your own logic:
+The `RESTQueryAdapter` accepts a `fetch` function, which is the standard place to add global error handling. You can wrap the native `fetch` with your own logic:
 
 ```ts
 function createFetchWithErrorHandling(baseFetch: typeof fetch) {
@@ -227,15 +227,19 @@ Then pass it when constructing the client:
 ```tsx
 import { QueryClient, QueryClientContext } from 'fetchium';
 import { SyncQueryStore, MemoryPersistentStore } from 'fetchium/stores/sync';
+import { RESTQueryAdapter } from 'fetchium/rest';
 import { ContextProvider } from 'signalium/react';
 
 const store = new SyncQueryStore(new MemoryPersistentStore());
 const customFetch = createFetchWithErrorHandling(fetch);
-const client = new QueryClient(store, { fetch: customFetch });
+const client = new QueryClient({
+  store,
+  adapters: [new RESTQueryAdapter({ fetch: customFetch })],
+});
 
 function App() {
   return (
-    <ContextProvider value={client} context={QueryClientContext}>
+    <ContextProvider contexts={[[QueryClientContext, client]]}>
       <YourApp />
     </ContextProvider>
   );
@@ -253,8 +257,8 @@ Non-fatal parse failures (optional fields falling back to `undefined`, array ite
 Fetchium routes these warnings through `QueryContext.log.warn`. You can plug in a custom logger when creating the `QueryClient`:
 
 ```ts
-const client = new QueryClient(store, {
-  fetch,
+const client = new QueryClient({
+  store,
   log: {
     warn: (message: string, ...args: unknown[]) => {
       console.warn(message, ...args);

package/plugin/docs/guides/offline.md

@@ -29,7 +29,7 @@ import { SyncQueryStore, MemoryPersistentStore } from 'fetchium/stores/sync';
 const store = new SyncQueryStore(new MemoryPersistentStore());
 const networkManager = new NetworkManager();
 
-const client = new QueryClient(store, { fetch }, networkManager);
+const client = new QueryClient({ store, networkManager });
 ```
 
 If you do not provide a `NetworkManager`, the `QueryClient` creates one automatically.
@@ -124,7 +124,7 @@ The `SyncQueryStore` wraps a synchronous key-value store. It is the simplest opt
 import { SyncQueryStore, MemoryPersistentStore } from 'fetchium/stores/sync';
 
 const store = new SyncQueryStore(new MemoryPersistentStore());
-const client = new QueryClient(store, { fetch });
+const client = new QueryClient({ store });
 ```
 
 The `MemoryPersistentStore` keeps everything in memory --- data is lost when the page is refreshed. For persistence across sessions, implement the `SyncPersistentStore` interface with a durable backend like `localStorage`.
@@ -220,18 +220,21 @@ Here is a complete example that sets up a `QueryClient` with persistence and net
 ```tsx
 import { QueryClient, NetworkManager } from 'fetchium';
 import { SyncQueryStore } from 'fetchium/stores/sync';
+import { RESTQueryAdapter } from 'fetchium/rest';
 
 const store = new SyncQueryStore(new LocalStoragePersistentStore());
 const networkManager = new NetworkManager();
 
-const client = new QueryClient(
+const client = new QueryClient({
   store,
-  {
-    fetch: globalThis.fetch,
-    baseUrl: 'https://api.example.com',
-  },
   networkManager,
-);
+  adapters: [
+    new RESTQueryAdapter({
+      fetch: globalThis.fetch,
+      baseUrl: 'https://api.example.com',
+    }),
+  ],
+});
 ```
 
 With this setup:

package/plugin/docs/guides/testing.md

@@ -41,7 +41,7 @@ export function renderApp(
   { client }: { client: QueryClient },
 ) {
   return render(
-    <ContextProvider value={client} context={QueryClientContext}>
+    <ContextProvider contexts={[[QueryClientContext, client]]}>
       {ui}
     </ContextProvider>,
   );

package/plugin/docs/quickstart.md

@@ -72,7 +72,7 @@ const client = new QueryClient();
 
 function App() {
   return (
-    <ContextProvider value={client} context={QueryClientContext}>
+    <ContextProvider contexts={[[QueryClientContext, client]]}>
       <YourApp />
     </ContextProvider>
   );

package/plugin/docs/reference/rest-queries.md

@@ -32,15 +32,15 @@ class GetUserPosts extends RESTQuery {
 
 ### Method reference
 
-| Method                | Returns                       | Description                        |
-| --------------------- | ----------------------------- | ---------------------------------- |
-| `getPath()`           | `string \| undefined`         | Dynamic path override              |
-| `getMethod()`         | `string`                      | Dynamic HTTP method                |
-| `getSearchParams()`   | `Record \| undefined`         | Dynamic search params              |
-| `getBody()`           | `Record \| undefined`         | Dynamic request body               |
-| `getHeaders()`        | `HeadersInit \| undefined`    | Dynamic request headers            |
-| `getRequestOptions()` | `RequestOptions \| undefined` | Dynamic fetch options              |
-| `getConfig()`         | `ConfigOptions \| undefined`  | Dynamic cache/retry/network config |
+| Method                | Returns                            | Description                        |
+| --------------------- | ---------------------------------- | ---------------------------------- |
+| `getPath()`           | `string \| undefined`              | Dynamic path override              |
+| `getMethod()`         | `string`                           | Dynamic HTTP method                |
+| `getSearchParams()`   | `Record \| undefined`              | Dynamic search params              |
+| `getBody()`           | `Record \| undefined`              | Dynamic request body               |
+| `getRequestOptions()` | `QueryRequestOptions \| undefined` | Dynamic fetch options              |
+| `getFetchNext()`      | `FetchNextConfig \| undefined`     | Dynamic pagination config          |
+| `getConfig()`         | `QueryConfigOptions \| undefined`  | Dynamic cache/retry/network config |
 
 ---
 

package/plugin/docs/setup/project-setup.md

@@ -67,10 +67,10 @@ Once you need a `baseUrl`, auth headers, persistent storage, or a custom fetch w
 
 `RESTQueryAdapter` is the transport layer for all REST queries and mutations. It accepts:
 
-| Option    | Type       | Default            | Description                                                                                                                                                     |
-| --------- | ---------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `fetch`   | `Function` | `globalThis.fetch` | The fetch function used for all network requests. Pass a custom wrapper for auth headers, logging, or testing.                                                  |
-| `baseUrl` | `string`   | `''`               | Prepended to every query path. Set this to your API root (`https://api.example.com`) so your query paths can be relative (`/users/42` instead of the full URL). |
+| Option    | Type           | Default            | Description                                                                                                                                                                                                                                   |
+| --------- | -------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `fetch`   | `Function`     | `globalThis.fetch` | The fetch function used for all network requests. Pass a custom wrapper for auth headers, logging, or testing.                                                                                                                                |
+| `baseUrl` | `BaseUrlValue` | `undefined`        | Prepended to every query path. Set this to your API root (`https://api.example.com`) so your query paths can be relative (`/users/42` instead of the full URL). Accepts a string, a Signalium `Signal<string>`, or a `() => string` function. |
 
 `fetch` is the _single point of control_ for how Fetchium makes network requests. Every REST query and mutation flows through this function, which means you can add authentication, logging, retry logic, or any other cross-cutting concern in one place. We cover this in depth in the [Auth & Headers](/guides/auth) guide.
 
@@ -100,7 +100,7 @@ const client = new QueryClient({
 
 function App() {
   return (
-    <ContextProvider value={client} context={QueryClientContext}>
+    <ContextProvider contexts={[[QueryClientContext, client]]}>
       <YourApp />
     </ContextProvider>
   );