@beignet/react-query 0.0.52 → 0.0.54

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @beignet/react-query
 
+## 0.0.54
+
+### Patch Changes
+
+- b71b34f: Add typed, authorized browser broadcasting with bounded SSE connections, memory
+  and Redis providers, reconnect reconciliation, React Query invalidation,
+  initiating-client exclusion, notification delivery, and transactional inbox
+  scaffolding. Raw routes now preserve context added by route hooks.
+
+## 0.0.53
+
+### Patch Changes
+
+- faf58ad: Clarify form adapter installation and migration, document TanStack Form UI
+  generator restrictions, and correct React Form reference examples.
+- 4df0522: Add typed `cacheEntries` and `updateCachedQueries` helpers with partial parameter matching, and declarative, awaited mutation invalidation. Preserve native query metadata and snapshot success defaults for each executing mutation. Prevent recursive execution of composed mutation defaults. Append an `infinite` segment to generated infinite-query keys so manually seeded and hydrated infinite data stays separate from standard responses; discard persisted infinite caches from the old key format when upgrading. Reserve the `beignet` key prefix for contract data. Require TanStack React Query 5.102 or newer and align generated dependency ranges.
+
 ## 0.0.52
 
 ### Patch Changes

package/README.md

@@ -323,6 +323,129 @@ const todosInfiniteQuery = rq(listTodos).infiniteQueryOptions({
 });
 ```
 
+## Typed cache access
+
+Use `cacheEntries(queryClient, match?)` to inspect cached standard queries with
+contract-derived response and parameter types:
+
+```typescript
+const todos = rq(listTodos);
+const entries = todos.cacheEntries(queryClient);
+
+for (const { queryKey, params, data } of entries) {
+  // data is the raw listTodos response, or undefined before data is available.
+  console.log(queryKey, params, data?.items);
+}
+```
+
+`match` uses the same parameter-prefix matching as `filter(...)`. Path, query,
+body, and header objects accept a subset of their top-level fields. For a
+contract with both `workspaceId` and `id` path parameters, pass
+`{ path: { workspaceId } }` to match every ID in that workspace. Actual query
+and mutation requests still require complete parameters.
+
+Returned parameters describe normalized cache identity, not complete request
+arguments: nullish path/query fields are omitted, bodies
+use their JSON representation, and headers contain only lowercased names
+explicitly included through `keyHeaders`. Parameter objects are copied so
+editing them cannot change a query key.
+
+Update matching existing entries with `updateCachedQueries`:
+
+```typescript
+todos.updateCachedQueries(queryClient, {
+  update: ({ data }) => {
+    if (!data) return undefined;
+    return {
+      ...data,
+      items: data.items.map((todo) =>
+        todo.id === updatedTodo.id ? { ...todo, ...updatedTodo } : todo,
+      ),
+    };
+  },
+});
+```
+
+The updater receives `{ queryKey, params, data }` for each entry. It runs
+synchronously against current data, must update immutably, and leaves an entry
+alone when it returns `undefined`. The helper does not create missing entries.
+Applications own list membership, sorting, pagination, optimistic rollback,
+and coordination with in-flight requests.
+
+Both helpers recognize standard queries using the contract's generated keys,
+including entries seeded with `setQueryData(helper.key(...), data)`. Store only
+the contract's raw response under these keys. Data is read before an observer's
+`select` transformation. Infinite queries and custom keys are excluded.
+
+Standard query keys keep their existing format. Generated infinite-query keys
+append an `"infinite"` segment, so they remain distinct when manually seeded or
+dehydrated and hydrated. Use the `queryKey` returned by `infiniteQueryOptions`
+for direct reads, writes, and exact matching of infinite data. Namespace,
+contract, and parameter-prefix filters still match both query types.
+
+When upgrading, discard persisted infinite-query caches created with the old
+key format. The `"beignet"` prefix is reserved: passing a custom `key` with that
+prefix throws. Omit `key` to use a generated key, and use ordinary TanStack
+cache APIs for custom keys and infinite-query data.
+
+Beignet does not add query metadata. Global defaults, query-key defaults, and
+explicit `meta` options retain TanStack's normal precedence.
+
+## Declarative mutation invalidation
+
+Pass `invalidates` to `mutationOptions` to select affected queries from the
+successful response and mutation variables:
+
+```typescript
+const mutation = useMutation(
+  rq(updateTodo).mutationOptions({
+    invalidates: (_todo, variables) => [
+      rq(getTodo).filter({ path: variables.path }),
+      rq(listTodos).contractFilter(),
+    ],
+    onSuccess: (todo) => {
+      // Optional application work runs before invalidation.
+      console.log("Saved", todo.id);
+    },
+  }),
+);
+```
+
+The callback returns an array of ordinary TanStack invalidation filters and may
+be asynchronous. An empty array requests no invalidation. Put shared filter
+selection in a feature client function when mutations and realtime events
+should refresh the same queries.
+
+Beignet uses the executing mutation's `QueryClient`, waits for its configured
+`onSuccess`, then attempts and awaits every requested invalidation before
+`onSettled`. Client-wide and mutation-key success defaults are honored unless
+overridden in `mutationOptions`. Success defaults are captured when the
+generated mutation function first starts, and retained across retries; changes
+to defaults while that request is pending apply to subsequent invocations.
+
+Generated options can be composed and registered with `setMutationDefaults`.
+When composition retains an earlier success wrapper, each wrapper runs its
+invalidation once per mutation invocation, including when defaults refer back
+to the composed options.
+
+Default TanStack behavior marks matching queries stale and refetches active
+eligible queries. Failed requests do not run `invalidates`.
+
+Invalidation still runs when the configured `onSuccess` throws after a
+successful request. Callback or invalidation failures follow TanStack's
+post-success error handling and do not retry the successful HTTP write;
+multiple failures are reported as an `AggregateError`. Normal TanStack refetch
+error behavior remains in effect.
+
+Pass lifecycle callbacks **inside** `mutationOptions({ ... })`. Spreading the
+returned options and replacing `onSuccess` replaces the invalidation wrapper.
+Callbacks passed to `mutate(variables, { onSuccess })` keep TanStack's normal
+per-call behavior and run after the configured success handling.
+
+These helpers require TanStack React Query **5.102.0 or newer in the v5 line**.
+The executing client comes from TanStack's mutation callback context. They do
+not add write locks or defer polling and realtime refreshes during mutations.
+
 ## API reference
 
 ### `createReactQuery(client, options?)`
@@ -704,7 +827,30 @@ Hook wrappers have been removed—use the options-first API for all queries and
 - [`@beignet/core/contracts`](https://beignetjs.com/contracts) - Core contract definitions
 - [`@beignet/core/client`](https://beignetjs.com/client) - HTTP client
 - [`@beignet/nuqs`](https://beignetjs.com/nuqs) - URL query state integration
-- [`@beignet/react-hook-form`](https://beignetjs.com/react-hook-form) - Form integration
+- [`@beignet/react-hook-form`](https://beignetjs.com/react-hook-form) - React Hook Form integration
+- [`@beignet/react-form`](https://beignetjs.com/react-form) - TanStack Form integration
+
+## Broadcast query subscriptions
+
+`createBroadcastQuerySubscription({ client, channel, params, queryClient,
+invalidates, reconciles, onError?, onStatusChange? })` maps typed broadcasts to
+TanStack Query filters. `invalidates(event)` returns the filters affected by one
+hint; `reconciles` lists every query covered by the channel and runs after initial
+readiness and every reconnect. Use contract-derived `contractFilter()`,
+`filter(params)`, or `namespaceFilter()` rather than hand-built query keys.
+
+The helper marks matching queries stale, coalesces hints, and performs a later
+refetch if a hint arrives during an existing fetch. Active queries refetch;
+inactive queries remain stale even when an earlier fetch completes after the
+hint. Disabled and static queries retain TanStack's normal behavior. It
+returns `unsubscribe()` and `getStatus()`. Unsubscribe removes its cache listener
+and queued work without cancelling queries owned by other observers.
+
+Share one `createBroadcastClient` from `@beignet/core/broadcasting/client` across
+features, then close and recreate it on user/workspace changes. Reconcile
+optimistic mutation state separately so a remote refetch does not overwrite an
+in-flight edit. See the [broadcasting guide](https://beignetjs.com/broadcasting)
+for complete channel and React Query examples.
 
 ## License
 

package/dist/broadcasting.d.ts

@@ -0,0 +1,17 @@
+import type { ChannelDefinition, InferChannelEvent, InferChannelParams } from "@beignet/core/broadcasting";
+import type { BroadcastClient, BroadcastClientStatus, BroadcastClientSubscription } from "@beignet/core/broadcasting/client";
+import type { QueryClient, QueryFilters } from "@tanstack/react-query";
+export interface BroadcastQuerySubscriptionOptions<C extends ChannelDefinition> {
+    client: BroadcastClient;
+    channel: C;
+    params: InferChannelParams<C>;
+    queryClient: QueryClient;
+    invalidates: (event: InferChannelEvent<C>) => readonly QueryFilters[];
+    /** All state covered by the channel, including unread counters and filtered lists. */
+    reconciles: readonly QueryFilters[];
+    onError?: (error: unknown) => void;
+    onStatusChange?: (status: BroadcastClientStatus) => void;
+}
+/** Invalidate hints and refetch after readiness. An event during a fetch schedules one later fetch. */
+export declare function createBroadcastQuerySubscription<C extends ChannelDefinition>(options: BroadcastQuerySubscriptionOptions<C>): BroadcastClientSubscription;
+//# sourceMappingURL=broadcasting.d.ts.map

package/dist/broadcasting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcasting.d.ts","sourceRoot":"","sources":["../src/broadcasting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAS,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE9E,MAAM,WAAW,iCAAiC,CAChD,CAAC,SAAS,iBAAiB;IAE3B,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,SAAS,YAAY,EAAE,CAAC;IACtE,sFAAsF;IACtF,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC1D;AAED,uGAAuG;AACvG,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,iBAAiB,EAC1E,OAAO,EAAE,iCAAiC,CAAC,CAAC,CAAC,GAC5C,2BAA2B,CA6E7B"}

package/dist/broadcasting.js

@@ -0,0 +1,83 @@
+/** Invalidate hints and refetch after readiness. An event during a fetch schedules one later fetch. */
+export function createBroadcastQuerySubscription(options) {
+    const cache = options.queryClient.getQueryCache();
+    const pending = new Set();
+    let closed = false;
+    let queued = false;
+    function flush() {
+        if (queued || closed)
+            return;
+        queued = true;
+        queueMicrotask(() => {
+            queued = false;
+            if (closed)
+                return;
+            for (const query of pending) {
+                if (query.state.fetchStatus !== "idle")
+                    continue;
+                pending.delete(query);
+                // A completed fetch clears invalidation, even when it began before the hint.
+                query.invalidate();
+                // Inactive queries remain stale. TanStack owns enabled/static and observer behavior.
+                void options.queryClient
+                    .refetchQueries({ queryKey: query.queryKey, exact: true, type: "active" }, { cancelRefetch: false, throwOnError: true })
+                    .catch((error) => {
+                    if (!closed) {
+                        try {
+                            options.onError?.(error);
+                        }
+                        catch {
+                            /* Reporting cannot disrupt query observers. */
+                        }
+                    }
+                });
+            }
+        });
+    }
+    const unsubscribeCache = cache.subscribe((event) => {
+        if (event.type === "removed")
+            pending.delete(event.query);
+        if (event.type === "updated" &&
+            event.query.state.fetchStatus === "idle" &&
+            pending.has(event.query))
+            flush();
+    });
+    function invalidate(filters) {
+        if (closed)
+            return;
+        for (const filter of filters)
+            for (const query of cache.findAll(filter)) {
+                pending.add(query);
+                query.invalidate();
+            }
+        flush();
+    }
+    let subscription;
+    try {
+        subscription = options.client.subscribe(options.channel, {
+            params: options.params,
+            onEvent: (event) => invalidate(options.invalidates(event)),
+            onSync: () => invalidate(options.reconciles),
+            onError: options.onError,
+            onStatusChange: options.onStatusChange,
+        });
+    }
+    catch (error) {
+        closed = true;
+        unsubscribeCache();
+        pending.clear();
+        throw error;
+    }
+    return {
+        getStatus: subscription.getStatus,
+        unsubscribe() {
+            if (closed)
+                return;
+            closed = true;
+            subscription.unsubscribe();
+            unsubscribeCache();
+            pending.clear();
+        },
+    };
+}
+//# sourceMappingURL=broadcasting.js.map

package/dist/broadcasting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcasting.js","sourceRoot":"","sources":["../src/broadcasting.ts"],"names":[],"mappings":"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"}

package/dist/cache.d.ts

@@ -0,0 +1,34 @@
+import type { InferBody, InferPathParams, InferQuery, InferSuccessResponse } from "@beignet/core/client";
+import type { HttpContractConfig } from "@beignet/core/contracts";
+import { type Query, type QueryKey } from "@tanstack/react-query";
+import type { ContractQueryKeyParams } from "./index.js";
+type JsonCacheValue<T> = T extends {
+    toJSON: (...args: never[]) => infer Value;
+} ? JsonCacheValue<Value> : T extends ((...args: never[]) => unknown) | symbol | bigint ? unknown : T extends readonly unknown[] ? {
+    [K in keyof T]: JsonCacheValue<T[K]> | (undefined extends T[K] ? null : never);
+} : T extends object ? {
+    [K in keyof T as K extends string ? K : never]: JsonCacheValue<T[K]>;
+} : T;
+/** Normalized cache identity, not a complete set of arguments for a request. */
+export type ContractCacheParams<TContract extends HttpContractConfig> = {
+    readonly path?: JsonCacheValue<Partial<NonNullable<InferPathParams<TContract>>>>;
+    readonly query?: JsonCacheValue<Partial<NonNullable<InferQuery<TContract>>>>;
+    readonly body?: JsonCacheValue<InferBody<TContract>>;
+    /** Only explicitly keyed headers, with lowercase names. */
+    readonly headers?: Readonly<Record<string, unknown>>;
+};
+/** One standard query using Beignet's generated contract key. */
+export type ContractCacheEntry<TContract extends HttpContractConfig> = {
+    readonly queryKey: QueryKey;
+    readonly params: ContractCacheParams<TContract>;
+    /** The raw contract response, before any observer-level select. */
+    readonly data: InferSuccessResponse<TContract> | undefined;
+};
+/** Update existing entries immutably. Returning undefined leaves an entry alone. */
+export type UpdateCachedQueriesOptions<TContract extends HttpContractConfig, TProvidedHeaders extends string = never> = {
+    match?: ContractQueryKeyParams<TContract, TProvidedHeaders>;
+    update(entry: ContractCacheEntry<TContract>): InferSuccessResponse<TContract> | undefined;
+};
+export declare function readCacheParams<TContract extends HttpContractConfig>(query: Query, contractKey: QueryKey): ContractCacheParams<TContract> | undefined;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,UAAU,EACV,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAW,KAAK,KAAK,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,MAAM,KAAK,CAAA;CAAE,GAC5E,cAAc,CAAC,KAAK,CAAC,GACrB,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GACzD,OAAO,GACP,CAAC,SAAS,SAAS,OAAO,EAAE,GAC1B;KACG,CAAC,IAAI,MAAM,CAAC,GACT,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpB,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;CAC5C,GACD,CAAC,SAAS,MAAM,GACd;KACG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,KAAK,GAAG,cAAc,CAC5D,CAAC,CAAC,CAAC,CAAC,CACL;CACF,GACD,CAAC,CAAC;AAEZ,gFAAgF;AAChF,MAAM,MAAM,mBAAmB,CAAC,SAAS,SAAS,kBAAkB,IAAI;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAC5B,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CACjD,CAAC;IACF,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,kBAAkB,CAAC,SAAS,SAAS,kBAAkB,IAAI;IACrE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAChD,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;CAC5D,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,0BAA0B,CACpC,SAAS,SAAS,kBAAkB,EACpC,gBAAgB,SAAS,MAAM,GAAG,KAAK,IACrC;IACF,KAAK,CAAC,EAAE,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAC5D,MAAM,CACJ,KAAK,EAAE,kBAAkB,CAAC,SAAS,CAAC,GACnC,oBAAoB,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;CAChD,CAAC;AAMF,wBAAgB,eAAe,CAAC,SAAS,SAAS,kBAAkB,EAClE,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,QAAQ,GACpB,mBAAmB,CAAC,SAAS,CAAC,GAAG,SAAS,CA4B5C"}

package/dist/cache.js

@@ -0,0 +1,27 @@
+import { hashKey } from "@tanstack/react-query";
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function readCacheParams(query, contractKey) {
+    const { queryKey } = query;
+    // Generated infinite keys have an extra suffix, even before TanStack has
+    // registered their options (for example, when seeded with setQueryData).
+    if (query.queryType === "infinite" ||
+        "initialPageParam" in query.options ||
+        (queryKey.length !== 4 && queryKey.length !== 5) ||
+        hashKey(queryKey.slice(0, 4)) !== hashKey(contractKey))
+        return undefined;
+    const params = queryKey[4] ?? {};
+    if (!isRecord(params) ||
+        Object.keys(params).some((key) => !["path", "query", "body", "headers"].includes(key)))
+        return undefined;
+    // Return the same JSON representation before and after hydration, and do
+    // not hand callers a mutable reference to parameters inside the cache key.
+    try {
+        return JSON.parse(JSON.stringify(params));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAA6B,MAAM,uBAAuB,CAAC;AAmD3E,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAY,EACZ,WAAqB;IAErB,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC3B,yEAAyE;IACzE,yEAAyE;IACzE,IACE,KAAK,CAAC,SAAS,KAAK,UAAU;QAC9B,kBAAkB,IAAI,KAAK,CAAC,OAAO;QACnC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC;QAEtD,OAAO,SAAS,CAAC;IAEnB,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,IACE,CAAC,QAAQ,CAAC,MAAM,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CACtB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAC7D;QAED,OAAO,SAAS,CAAC;IAEnB,yEAAyE;IACzE,2EAA2E;IAC3E,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAmC,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 import type { Client, Endpoint, EndpointCallArgs, InferBody, InferEndpointContractError, InferPathParams, InferQuery, InferSuccessResponse } from "@beignet/core/client";
+export { type BroadcastQuerySubscriptionOptions, createBroadcastQuerySubscription, } from "./broadcasting.js";
 import { type ContractLike, type HttpContractConfig, type ResolveContract } from "@beignet/core/contracts";
 import type { InfiniteData, InvalidateQueryFilters, QueryClient, QueryFunction, QueryKey, UseInfiniteQueryOptions, UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";
+import { type ContractCacheEntry, type UpdateCachedQueriesOptions } from "./cache.js";
+export type { ContractCacheEntry, ContractCacheParams, UpdateCachedQueriesOptions, } from "./cache.js";
 type EndpointQueryArgs<TContract extends HttpContractConfig, TProvidedHeaders extends string> = Omit<EndpointCallArgs<TContract, TProvidedHeaders>, "rawBody" | "signal" | "idempotencyKey">;
 type EndpointArgValue<TArgs, TKey extends "path" | "query" | "body" | "headers"> = TKey extends keyof TArgs ? TArgs[TKey] : undefined;
 type IsRequiredValue<T> = undefined extends T ? false : true;
@@ -28,11 +31,14 @@ export type ContractUseQueryOptions<TContract extends HttpContractConfig, TProvi
     key?: readonly unknown[];
 } & ContractQueryOptionsBase<TContract, TData>;
 type ContractQueryOptionsCallArgs<TContract extends HttpContractConfig, TProvidedHeaders extends string, TData = InferSuccessResponse<TContract>> = RequiresQueryOptionsArgs<TContract, TProvidedHeaders> extends true ? [args: ContractUseQueryOptions<TContract, TProvidedHeaders, TData>] : [args?: ContractUseQueryOptions<TContract, TProvidedHeaders, TData>];
+type PartialKeyValue<T> = T extends readonly unknown[] | {
+    toJSON: (...args: never[]) => unknown;
+} ? T : T extends object ? Partial<T> : T;
 export type ContractQueryKeyParams<TContract extends HttpContractConfig, TProvidedHeaders extends string = never> = {
-    path?: EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "path">;
-    query?: EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "query">;
-    body?: EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "body">;
-    headers?: EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "headers">;
+    path?: PartialKeyValue<EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "path">>;
+    query?: PartialKeyValue<EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "query">>;
+    body?: PartialKeyValue<EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "body">>;
+    headers?: PartialKeyValue<EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "headers">>;
 };
 /**
  * Options accepted by `ReactQueryContractHelper.mutationOptions(...)`.
@@ -40,7 +46,13 @@ export type ContractQueryKeyParams<TContract extends HttpContractConfig, TProvid
  * TanStack `mutationFn` is generated from the contract endpoint, so callers pass
  * the normal TanStack mutation lifecycle options.
  */
-export type ContractUseMutationOptions<TContract extends HttpContractConfig, TProvidedHeaders extends string = never> = Omit<UseMutationOptions<InferSuccessResponse<TContract>, InferEndpointContractError<TContract>, EndpointCallArgs<TContract, TProvidedHeaders>, unknown>, "mutationFn">;
+export type ContractUseMutationOptions<TContract extends HttpContractConfig, TProvidedHeaders extends string = never> = Omit<UseMutationOptions<InferSuccessResponse<TContract>, InferEndpointContractError<TContract>, EndpointCallArgs<TContract, TProvidedHeaders>, unknown>, "mutationFn"> & {
+    /**
+     * Queries to invalidate after a successful mutation and its onSuccess callback.
+     * Uses the executing mutation's QueryClient and awaits all invalidations.
+     */
+    invalidates?: (data: InferSuccessResponse<TContract>, variables: EndpointCallArgs<TContract, TProvidedHeaders>) => readonly InvalidateQueryFilters<QueryKey>[] | Promise<readonly InvalidateQueryFilters<QueryKey>[]>;
+};
 /**
  * Body input for infinite queries.
  *
@@ -224,6 +236,16 @@ export declare class ReactQueryContractHelper<TContract extends HttpContractConf
      * path/query/body params to target a single call or parameter prefix.
      */
     invalidate(queryClient: QueryClient, params?: ContractQueryKeyParams<TContract, TProvidedHeaders>, options?: ContractQueryFilterOptions): Promise<void>;
+    /**
+     * Inspect matching standard queries using this contract's generated keys.
+     * Skips infinite queries and custom keys.
+     */
+    cacheEntries(queryClient: QueryClient, match?: ContractQueryKeyParams<TContract, TProvidedHeaders>): ContractCacheEntry<TContract>[];
+    /**
+     * Update matching existing standard queries. Does not create entries or
+     * coordinate optimistic writes; updaters must return immutable data.
+     */
+    updateCachedQueries(queryClient: QueryClient, options: UpdateCachedQueriesOptions<TContract, TProvidedHeaders>): void;
     /**
      * Create query options for TanStack Query.
      *
@@ -261,6 +283,9 @@ export declare class ReactQueryContractHelper<TContract extends HttpContractConf
      * The observed data defaults to `InfiniteData` of the contract response, so
      * `useInfiniteQuery(...).data.pages` is typed per page. Pass `select` to
      * narrow the observed data type.
+     *
+     * Generated keys append "infinite" to the standard key. Use the returned
+     * queryKey for direct cache access; parameter-prefix filters match both.
      */
     infiniteQueryOptions<TPageParam = unknown, TData = InfiniteData<InferSuccessResponse<TContract>, TPageParam>>(args: ContractInfiniteQueryOptions<TContract, TPageParam, TProvidedHeaders, TData>): ContractInfiniteQueryOptionsResult<TContract, TPageParam, TData>;
     /**
@@ -319,5 +344,4 @@ export declare function cursorPagination(): {
  * persisted caches never store credentials.
  */
 export declare function createReactQuery<TProvidedHeaders extends string = never>(client: Client<TProvidedHeaders>, options?: CreateReactQueryOptions): <TContractLike extends ContractLike>(contract: TContractLike) => ReactQueryContractHelper<ResolveContract<TContractLike>, TProvidedHeaders>;
-export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,4 +1,6 @@
+export { createBroadcastQuerySubscription, } from "./broadcasting.js";
 import { resolveContract, } from "@beignet/core/contracts";
+import { readCacheParams, } from "./cache.js";
 function mergeParamObjects(base, patch) {
     if (base == null)
         return patch;
@@ -37,6 +39,11 @@ function normalizeBodyKeyValue(value) {
 }
 const BEIGNET_QUERY_KEY_SCOPE = "beignet";
 const UNNAMESPACED_QUERY_KEY_NAMESPACE = null;
+function assertCustomQueryKey(key) {
+    if (key?.[0] === BEIGNET_QUERY_KEY_SCOPE) {
+        throw new Error('Custom query keys must not use the reserved "beignet" prefix. Omit key to use the contract-generated key.');
+    }
+}
 /**
  * Generated idempotency keys keyed by mutation variables object identity.
  *
@@ -46,6 +53,9 @@ const UNNAMESPACED_QUERY_KEY_NAMESPACE = null;
  * object or an explicit `idempotencyKey` for a distinct logical command.
  */
 const idempotencyKeyForVariables = new WeakMap();
+// The invocation context survives retries and option updates during React
+// renders, and stays distinct even when concurrent mutations reuse variables.
+const successDefaults = new WeakMap();
 /**
  * Generate an idempotency key that works in non-secure browser contexts.
  * `crypto.randomUUID` is undefined on plain `http://` hosts other than
@@ -228,6 +238,49 @@ export class ReactQueryContractHelper {
     invalidate(queryClient, params, options) {
         return queryClient.invalidateQueries(this.filter(params, options));
     }
+    /**
+     * Inspect matching standard queries using this contract's generated keys.
+     * Skips infinite queries and custom keys.
+     */
+    cacheEntries(queryClient, match) {
+        return queryClient
+            .getQueryCache()
+            .findAll(this.filter(match))
+            .flatMap((query) => {
+            const params = readCacheParams(query, this.contractKey());
+            return params === undefined
+                ? []
+                : [
+                    {
+                        queryKey: query.queryKey,
+                        params,
+                        data: query.state.data,
+                    },
+                ];
+        });
+    }
+    /**
+     * Update matching existing standard queries. Does not create entries or
+     * coordinate optimistic writes; updaters must return immutable data.
+     */
+    updateCachedQueries(queryClient, options) {
+        const cache = queryClient.getQueryCache();
+        for (const query of cache.findAll(this.filter(options.match))) {
+            if (cache.get(query.queryHash) !== query)
+                continue;
+            const params = readCacheParams(query, this.contractKey());
+            if (params === undefined)
+                continue;
+            const data = options.update({
+                queryKey: query.queryKey,
+                params,
+                data: query.state.data,
+            });
+            if (data !== undefined && cache.get(query.queryHash) === query) {
+                query.setData(data, { manual: true });
+            }
+        }
+    }
     /**
      * Create query options for TanStack Query.
      *
@@ -240,6 +293,7 @@ export class ReactQueryContractHelper {
     queryOptions(...callArgs) {
         const args = (callArgs[0] ?? {});
         const { path, query, body, headers, key: customKey, ...rest } = args;
+        assertCustomQueryKey(customKey);
         const queryKey = (customKey ||
             this.key({ path, query, body, headers }));
         const queryFn = async (context) => {
@@ -273,7 +327,11 @@ export class ReactQueryContractHelper {
      */
     mutationOptions(args = {}) {
         const hasIdempotencyMetadata = Boolean(this.contract.metadata?.idempotency);
-        const mutationFn = async (vars) => {
+        const mutationFn = async (vars, context) => {
+            if (context && !successDefaults.has(context)) {
+                const { onSuccess } = context.client.defaultMutationOptions({ mutationKey: context.mutationKey });
+                successDefaults.set(context, onSuccess);
+            }
             let idempotencyKey = vars?.idempotencyKey;
             if (!idempotencyKey &&
                 hasIdempotencyMetadata &&
@@ -291,10 +349,43 @@ export class ReactQueryContractHelper {
                 idempotencyKey,
             });
         };
-        return {
-            ...args,
-            mutationFn,
+        const { invalidates, ...rest } = args;
+        if (!invalidates)
+            return { ...rest, mutationFn };
+        // Composed defaults can point back to an earlier wrapper. Each wrapper
+        // handles an invocation once, even when reached through that cycle.
+        const handledInvocations = new WeakSet();
+        const onSuccess = async (data, variables, onMutateResult, context) => {
+            if (handledInvocations.has(context))
+                return;
+            handledInvocations.add(context);
+            const errors = [];
+            try {
+                const callback = Object.hasOwn(rest, "onSuccess")
+                    ? rest.onSuccess
+                    : successDefaults.get(context);
+                await callback?.(data, variables, onMutateResult, context);
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            try {
+                const filters = await invalidates(data, variables);
+                const results = await Promise.allSettled(filters.map((filter) => Promise.resolve().then(() => context.client.invalidateQueries(filter))));
+                for (const result of results) {
+                    if (result.status === "rejected")
+                        errors.push(result.reason);
+                }
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            if (errors.length === 1)
+                throw errors[0];
+            if (errors.length > 1)
+                throw new AggregateError(errors, `Post-success handling failed for ${this.name}.`);
         };
+        return { ...rest, mutationFn, onSuccess };
     }
     /**
      * Create infinite query options for TanStack Query.
@@ -308,8 +399,12 @@ export class ReactQueryContractHelper {
      * The observed data defaults to `InfiniteData` of the contract response, so
      * `useInfiniteQuery(...).data.pages` is typed per page. Pass `select` to
      * narrow the observed data type.
+     *
+     * Generated keys append "infinite" to the standard key. Use the returned
+     * queryKey for direct cache access; parameter-prefix filters match both.
      */
     infiniteQueryOptions(args) {
+        assertCustomQueryKey(args.key);
         let queryKey;
         let rest;
         let resolveParams;
@@ -324,7 +419,10 @@ export class ReactQueryContractHelper {
         }
         else {
             const { path, query, body, headers, page, key, ...other } = args;
-            queryKey = (key || this.key({ path, query, body, headers }));
+            queryKey = key || [
+                ...this.key({ path, query, body, headers }),
+                "infinite",
+            ];
             rest = other;
             resolveParams = (context) => {
                 const pageParams = page?.(context);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/react-query",
-  "version": "0.0.52",
+  "version": "0.0.54",
   "type": "module",
   "description": "TanStack Query integration for Beignet",
   "main": "./dist/index.js",
@@ -57,12 +57,12 @@
   },
   "peerDependencies": {
     "@beignet/core": ">=0.0.3 <1.0.0",
-    "@tanstack/react-query": "^5.0.0",
+    "@tanstack/react-query": "^5.102.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
     "@beignet/core": "*",
-    "@tanstack/react-query": "^5.0.0",
+    "@tanstack/react-query": "^5.102.0",
     "@testing-library/dom": "^9.3.4",
     "@testing-library/react": "^14.3.1",
     "@types/bun": "^1.4.0",

package/skills/client/SKILL.md

@@ -118,9 +118,34 @@ Call server behavior through Beignet contracts and typed clients.
   filters.
 - Generated keys omit nullish path, query, and opted-in header entries, but
   preserve JSON body `null` values and empty objects. Reuse generated keys so
-  distinct request bodies do not share cache entries.
+  distinct request bodies do not share cache entries. Infinite-query keys
+  append an `"infinite"` segment; use `infiniteQueryOptions(...).queryKey` for
+  direct infinite-cache reads, writes, and exact matching. Prefix filters
+  still match both query types. Discard persisted infinite caches from the old
+  key format when upgrading.
 - Use `rq(contract).invalidate(queryClient, params?, options?)` or the app's
   existing key helper after successful mutations.
+- Use `rq(contract).cacheEntries(queryClient, match?)` for typed standard-query
+  data and normalized key parameters, and `updateCachedQueries(queryClient,
+  { match, update })` for immutable updates of existing entries. Returning
+  `undefined` skips an update. Match objects accept partial path, query, body,
+  and header fields. These helpers recognize generated keys, including entries
+  seeded with `setQueryData(helper.key(...), data)`; keep the data in the raw
+  contract response shape. Infinite queries and custom keys are excluded.
+  Custom keys must not use the reserved `"beignet"` prefix. Native query metadata
+  defaults remain intact. Keep sorting, list membership, optimistic rollback,
+  and request coordination app-owned.
+- Use `mutationOptions({ invalidates: (data, variables) => filters })` for
+  declarative success invalidation. Filters may be selected asynchronously.
+  Beignet runs and awaits configured `onSuccess`, then all invalidations on
+  the executing QueryClient, including when `onSuccess` throws. Success defaults
+  are captured when the generated mutation function first starts and remain
+  stable across retries and changes to defaults during the request. It does not
+  retry a successful write when post-success handling fails. Pass callbacks
+  inside `mutationOptions`; replacing the returned `onSuccess` bypasses this
+  handling. Composed options can be registered with `setMutationDefaults`;
+  each retained success wrapper invalidates once per mutation invocation.
+  The integration requires TanStack React Query 5.102+ in v5.
 - If the app configures `createReactQuery(apiClient, { keyHeaders })`, preserve
   that when adding helpers so tenant or header-scoped caches stay distinct.
 - Contracts with idempotency metadata get one generated idempotency key per
@@ -146,3 +171,24 @@ beignet lint
 beignet doctor --strict
 bun run typecheck
 ```
+
+## Broadcast invalidation
+
+Create one `createBroadcastClient` from `@beignet/core/broadcasting/client` in
+browser lifecycle code and share it across features. Close and recreate it when
+authenticated user/workspace changes. Import channel definitions from feature
+`channels.ts`; never import `broadcasts.ts` or the broadcasting server subpath.
+
+Use `createBroadcastQuerySubscription` with `client`, `channel`, `params`,
+`queryClient`, `invalidates(event)`, and `reconciles`. Build filters through
+`rq(contract).filter(...)`, `.contractFilter()`, or `.namespaceFilter()`.
+`reconciles` covers all state in the channel because initial connection and
+reconnection can miss events. Hints coalesce and schedule a follow-up refetch if
+a fetch was already running. Inactive queries stay stale even when an earlier
+fetch completes after a hint; disabled/static query behavior remains
+TanStack-owned. Unsubscribe in effect cleanup.
+
+Preserve optimistic mutation state while a mutation is pending and reconcile
+versions after settlement. Broadcasting does not patch caches or resolve edit
+conflicts. Merge `getRequestHeaders()` into the typed client's dynamic headers
+only when the app opts into authenticated initiating-client exclusion.

package/src/broadcasting.ts

@@ -0,0 +1,107 @@
+import type {
+  ChannelDefinition,
+  InferChannelEvent,
+  InferChannelParams,
+} from "@beignet/core/broadcasting";
+import type {
+  BroadcastClient,
+  BroadcastClientStatus,
+  BroadcastClientSubscription,
+} from "@beignet/core/broadcasting/client";
+import type { Query, QueryClient, QueryFilters } from "@tanstack/react-query";
+
+export interface BroadcastQuerySubscriptionOptions<
+  C extends ChannelDefinition,
+> {
+  client: BroadcastClient;
+  channel: C;
+  params: InferChannelParams<C>;
+  queryClient: QueryClient;
+  invalidates: (event: InferChannelEvent<C>) => readonly QueryFilters[];
+  /** All state covered by the channel, including unread counters and filtered lists. */
+  reconciles: readonly QueryFilters[];
+  onError?: (error: unknown) => void;
+  onStatusChange?: (status: BroadcastClientStatus) => void;
+}
+
+/** Invalidate hints and refetch after readiness. An event during a fetch schedules one later fetch. */
+export function createBroadcastQuerySubscription<C extends ChannelDefinition>(
+  options: BroadcastQuerySubscriptionOptions<C>,
+): BroadcastClientSubscription {
+  const cache = options.queryClient.getQueryCache();
+  const pending = new Set<Query>();
+  let closed = false;
+  let queued = false;
+  function flush() {
+    if (queued || closed) return;
+    queued = true;
+    queueMicrotask(() => {
+      queued = false;
+      if (closed) return;
+      for (const query of pending) {
+        if (query.state.fetchStatus !== "idle") continue;
+        pending.delete(query);
+        // A completed fetch clears invalidation, even when it began before the hint.
+        query.invalidate();
+        // Inactive queries remain stale. TanStack owns enabled/static and observer behavior.
+        void options.queryClient
+          .refetchQueries(
+            { queryKey: query.queryKey, exact: true, type: "active" },
+            { cancelRefetch: false, throwOnError: true },
+          )
+          .catch((error) => {
+            if (!closed) {
+              try {
+                options.onError?.(error);
+              } catch {
+                /* Reporting cannot disrupt query observers. */
+              }
+            }
+          });
+      }
+    });
+  }
+  const unsubscribeCache = cache.subscribe((event) => {
+    if (event.type === "removed") pending.delete(event.query);
+    if (
+      event.type === "updated" &&
+      event.query.state.fetchStatus === "idle" &&
+      pending.has(event.query)
+    )
+      flush();
+  });
+  function invalidate(filters: readonly QueryFilters[]) {
+    if (closed) return;
+    for (const filter of filters)
+      for (const query of cache.findAll(filter)) {
+        pending.add(query);
+        query.invalidate();
+      }
+    flush();
+  }
+  let subscription: BroadcastClientSubscription;
+  try {
+    subscription = options.client.subscribe(options.channel, {
+      params: options.params,
+      onEvent: (event) => invalidate(options.invalidates(event)),
+      onSync: () => invalidate(options.reconciles),
+      onError: options.onError,
+      onStatusChange: options.onStatusChange,
+    });
+  } catch (error) {
+    closed = true;
+    unsubscribeCache();
+    pending.clear();
+    throw error;
+  }
+  return {
+    getStatus: subscription.getStatus,
+    unsubscribe() {
+      if (closed) return;
+      closed = true;
+      subscription.unsubscribe();
+      unsubscribeCache();
+      pending.clear();
+    },
+  };
+}

package/src/cache.ts

@@ -0,0 +1,94 @@
+import type {
+  InferBody,
+  InferPathParams,
+  InferQuery,
+  InferSuccessResponse,
+} from "@beignet/core/client";
+import type { HttpContractConfig } from "@beignet/core/contracts";
+import { hashKey, type Query, type QueryKey } from "@tanstack/react-query";
+import type { ContractQueryKeyParams } from "./index.js";
+
+type JsonCacheValue<T> = T extends { toJSON: (...args: never[]) => infer Value }
+  ? JsonCacheValue<Value>
+  : T extends ((...args: never[]) => unknown) | symbol | bigint
+    ? unknown
+    : T extends readonly unknown[]
+      ? {
+          [K in keyof T]:
+            | JsonCacheValue<T[K]>
+            | (undefined extends T[K] ? null : never);
+        }
+      : T extends object
+        ? {
+            [K in keyof T as K extends string ? K : never]: JsonCacheValue<
+              T[K]
+            >;
+          }
+        : T;
+
+/** Normalized cache identity, not a complete set of arguments for a request. */
+export type ContractCacheParams<TContract extends HttpContractConfig> = {
+  readonly path?: JsonCacheValue<
+    Partial<NonNullable<InferPathParams<TContract>>>
+  >;
+  readonly query?: JsonCacheValue<Partial<NonNullable<InferQuery<TContract>>>>;
+  readonly body?: JsonCacheValue<InferBody<TContract>>;
+  /** Only explicitly keyed headers, with lowercase names. */
+  readonly headers?: Readonly<Record<string, unknown>>;
+};
+
+/** One standard query using Beignet's generated contract key. */
+export type ContractCacheEntry<TContract extends HttpContractConfig> = {
+  readonly queryKey: QueryKey;
+  readonly params: ContractCacheParams<TContract>;
+  /** The raw contract response, before any observer-level select. */
+  readonly data: InferSuccessResponse<TContract> | undefined;
+};
+
+/** Update existing entries immutably. Returning undefined leaves an entry alone. */
+export type UpdateCachedQueriesOptions<
+  TContract extends HttpContractConfig,
+  TProvidedHeaders extends string = never,
+> = {
+  match?: ContractQueryKeyParams<TContract, TProvidedHeaders>;
+  update(
+    entry: ContractCacheEntry<TContract>,
+  ): InferSuccessResponse<TContract> | undefined;
+};
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
+export function readCacheParams<TContract extends HttpContractConfig>(
+  query: Query,
+  contractKey: QueryKey,
+): ContractCacheParams<TContract> | undefined {
+  const { queryKey } = query;
+  // Generated infinite keys have an extra suffix, even before TanStack has
+  // registered their options (for example, when seeded with setQueryData).
+  if (
+    query.queryType === "infinite" ||
+    "initialPageParam" in query.options ||
+    (queryKey.length !== 4 && queryKey.length !== 5) ||
+    hashKey(queryKey.slice(0, 4)) !== hashKey(contractKey)
+  )
+    return undefined;
+
+  const params = queryKey[4] ?? {};
+  if (
+    !isRecord(params) ||
+    Object.keys(params).some(
+      (key) => !["path", "query", "body", "headers"].includes(key),
+    )
+  )
+    return undefined;
+
+  // Return the same JSON representation before and after hydration, and do
+  // not hand callers a mutable reference to parameters inside the cache key.
+  try {
+    return JSON.parse(JSON.stringify(params)) as ContractCacheParams<TContract>;
+  } catch {
+    return undefined;
+  }
+}

package/src/index.ts

@@ -8,6 +8,12 @@ import type {
   InferQuery,
   InferSuccessResponse,
 } from "@beignet/core/client";
+
+export {
+  type BroadcastQuerySubscriptionOptions,
+  createBroadcastQuerySubscription,
+} from "./broadcasting.js";
+
 import {
   type ContractLike,
   type HttpContractConfig,
@@ -18,6 +24,7 @@ import {
 import type {
   InfiniteData,
   InvalidateQueryFilters,
+  MutationFunctionContext,
   QueryClient,
   QueryFunction,
   QueryKey,
@@ -25,6 +32,17 @@ import type {
   UseMutationOptions,
   UseQueryOptions,
 } from "@tanstack/react-query";
+import {
+  type ContractCacheEntry,
+  readCacheParams,
+  type UpdateCachedQueriesOptions,
+} from "./cache.js";
+
+export type {
+  ContractCacheEntry,
+  ContractCacheParams,
+  UpdateCachedQueriesOptions,
+} from "./cache.js";
 
 type EndpointQueryArgs<
   TContract extends HttpContractConfig,
@@ -112,25 +130,29 @@ type ContractQueryOptionsCallArgs<
     ? [args: ContractUseQueryOptions<TContract, TProvidedHeaders, TData>]
     : [args?: ContractUseQueryOptions<TContract, TProvidedHeaders, TData>];
 
+type PartialKeyValue<T> = T extends
+  | readonly unknown[]
+  | { toJSON: (...args: never[]) => unknown }
+  ? T
+  : T extends object
+    ? Partial<T>
+    : T;
+
 export type ContractQueryKeyParams<
   TContract extends HttpContractConfig,
   TProvidedHeaders extends string = never,
 > = {
-  path?: EndpointArgValue<
-    EndpointQueryArgs<TContract, TProvidedHeaders>,
-    "path"
+  path?: PartialKeyValue<
+    EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "path">
   >;
-  query?: EndpointArgValue<
-    EndpointQueryArgs<TContract, TProvidedHeaders>,
-    "query"
+  query?: PartialKeyValue<
+    EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "query">
   >;
-  body?: EndpointArgValue<
-    EndpointQueryArgs<TContract, TProvidedHeaders>,
-    "body"
+  body?: PartialKeyValue<
+    EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "body">
   >;
-  headers?: EndpointArgValue<
-    EndpointQueryArgs<TContract, TProvidedHeaders>,
-    "headers"
+  headers?: PartialKeyValue<
+    EndpointArgValue<EndpointQueryArgs<TContract, TProvidedHeaders>, "headers">
   >;
 };
 
@@ -151,7 +173,18 @@ export type ContractUseMutationOptions<
     unknown
   >,
   "mutationFn"
->;
+> & {
+  /**
+   * Queries to invalidate after a successful mutation and its onSuccess callback.
+   * Uses the executing mutation's QueryClient and awaits all invalidations.
+   */
+  invalidates?: (
+    data: InferSuccessResponse<TContract>,
+    variables: EndpointCallArgs<TContract, TProvidedHeaders>,
+  ) =>
+    | readonly InvalidateQueryFilters<QueryKey>[]
+    | Promise<readonly InvalidateQueryFilters<QueryKey>[]>;
+};
 
 /**
  * Body input for infinite queries.
@@ -296,6 +329,14 @@ function normalizeBodyKeyValue(value: unknown): unknown | undefined {
 const BEIGNET_QUERY_KEY_SCOPE = "beignet";
 const UNNAMESPACED_QUERY_KEY_NAMESPACE = null;
 
+function assertCustomQueryKey(key: QueryKey | undefined): void {
+  if (key?.[0] === BEIGNET_QUERY_KEY_SCOPE) {
+    throw new Error(
+      'Custom query keys must not use the reserved "beignet" prefix. Omit key to use the contract-generated key.',
+    );
+  }
+}
+
 /**
  * Generated idempotency keys keyed by mutation variables object identity.
  *
@@ -306,6 +347,13 @@ const UNNAMESPACED_QUERY_KEY_NAMESPACE = null;
  */
 const idempotencyKeyForVariables = new WeakMap<object, string>();
 
+// The invocation context survives retries and option updates during React
+// renders, and stays distinct even when concurrent mutations reuse variables.
+const successDefaults = new WeakMap<
+  MutationFunctionContext,
+  UseMutationOptions<unknown, unknown, unknown, unknown>["onSuccess"]
+>();
+
 /**
  * Generate an idempotency key that works in non-secure browser contexts.
  * `crypto.randomUUID` is undefined on plain `http://` hosts other than
@@ -586,6 +634,57 @@ export class ReactQueryContractHelper<
     return queryClient.invalidateQueries(this.filter(params, options));
   }
 
+  /**
+   * Inspect matching standard queries using this contract's generated keys.
+   * Skips infinite queries and custom keys.
+   */
+  cacheEntries(
+    queryClient: QueryClient,
+    match?: ContractQueryKeyParams<TContract, TProvidedHeaders>,
+  ): ContractCacheEntry<TContract>[] {
+    return queryClient
+      .getQueryCache()
+      .findAll(this.filter(match))
+      .flatMap((query) => {
+        const params = readCacheParams<TContract>(query, this.contractKey());
+        return params === undefined
+          ? []
+          : [
+              {
+                queryKey: query.queryKey,
+                params,
+                data: query.state.data as
+                  | InferSuccessResponse<TContract>
+                  | undefined,
+              },
+            ];
+      });
+  }
+
+  /**
+   * Update matching existing standard queries. Does not create entries or
+   * coordinate optimistic writes; updaters must return immutable data.
+   */
+  updateCachedQueries(
+    queryClient: QueryClient,
+    options: UpdateCachedQueriesOptions<TContract, TProvidedHeaders>,
+  ): void {
+    const cache = queryClient.getQueryCache();
+    for (const query of cache.findAll(this.filter(options.match))) {
+      if (cache.get(query.queryHash) !== query) continue;
+      const params = readCacheParams<TContract>(query, this.contractKey());
+      if (params === undefined) continue;
+      const data = options.update({
+        queryKey: query.queryKey,
+        params,
+        data: query.state.data as InferSuccessResponse<TContract> | undefined,
+      });
+      if (data !== undefined && cache.get(query.queryHash) === query) {
+        query.setData(data, { manual: true });
+      }
+    }
+  }
+
   /**
    * Create query options for TanStack Query.
    *
@@ -608,6 +707,7 @@ export class ReactQueryContractHelper<
       TData
     >;
     const { path, query, body, headers, key: customKey, ...rest } = args;
+    assertCustomQueryKey(customKey);
 
     const queryKey = (customKey ||
       this.key({ path, query, body, headers })) as QueryKey;
@@ -654,7 +754,14 @@ export class ReactQueryContractHelper<
     const hasIdempotencyMetadata = Boolean(this.contract.metadata?.idempotency);
     const mutationFn = async (
       vars: EndpointCallArgs<TContract, TProvidedHeaders>,
+      context?: MutationFunctionContext,
     ) => {
+      if (context && !successDefaults.has(context)) {
+        const { onSuccess } = context.client.defaultMutationOptions<
+          UseMutationOptions<unknown, unknown, unknown, unknown>
+        >({ mutationKey: context.mutationKey });
+        successDefaults.set(context, onSuccess);
+      }
       let idempotencyKey = vars?.idempotencyKey;
       if (
         !idempotencyKey &&
@@ -675,15 +782,54 @@ export class ReactQueryContractHelper<
       } as EndpointCallArgs<TContract, TProvidedHeaders>);
     };
 
-    return {
-      ...args,
-      mutationFn,
-    } as UseMutationOptions<
-      InferSuccessResponse<TContract>,
-      InferEndpointContractError<TContract>,
-      EndpointCallArgs<TContract, TProvidedHeaders>,
-      unknown
+    const { invalidates, ...rest } = args;
+    if (!invalidates) return { ...rest, mutationFn };
+    type SuccessCallback = NonNullable<
+      ContractUseMutationOptions<TContract, TProvidedHeaders>["onSuccess"]
     >;
+    // Composed defaults can point back to an earlier wrapper. Each wrapper
+    // handles an invocation once, even when reached through that cycle.
+    const handledInvocations = new WeakSet<MutationFunctionContext>();
+    const onSuccess: SuccessCallback = async (
+      data,
+      variables,
+      onMutateResult,
+      context,
+    ) => {
+      if (handledInvocations.has(context)) return;
+      handledInvocations.add(context);
+      const errors: unknown[] = [];
+      try {
+        const callback = Object.hasOwn(rest, "onSuccess")
+          ? rest.onSuccess
+          : successDefaults.get(context);
+        await callback?.(data, variables, onMutateResult, context);
+      } catch (error) {
+        errors.push(error);
+      }
+      try {
+        const filters = await invalidates(data, variables);
+        const results = await Promise.allSettled(
+          filters.map((filter) =>
+            Promise.resolve().then(() =>
+              context.client.invalidateQueries(filter),
+            ),
+          ),
+        );
+        for (const result of results) {
+          if (result.status === "rejected") errors.push(result.reason);
+        }
+      } catch (error) {
+        errors.push(error);
+      }
+      if (errors.length === 1) throw errors[0];
+      if (errors.length > 1)
+        throw new AggregateError(
+          errors,
+          `Post-success handling failed for ${this.name}.`,
+        );
+    };
+    return { ...rest, mutationFn, onSuccess };
   }
 
   /**
@@ -698,6 +844,9 @@ export class ReactQueryContractHelper<
    * The observed data defaults to `InfiniteData` of the contract response, so
    * `useInfiniteQuery(...).data.pages` is typed per page. Pass `select` to
    * narrow the observed data type.
+   *
+   * Generated keys append "infinite" to the standard key. Use the returned
+   * queryKey for direct cache access; parameter-prefix filters match both.
    */
   infiniteQueryOptions<
     TPageParam = unknown,
@@ -710,6 +859,7 @@ export class ReactQueryContractHelper<
       TData
     >,
   ): ContractInfiniteQueryOptionsResult<TContract, TPageParam, TData> {
+    assertCustomQueryKey(args.key);
     let queryKey: QueryKey;
     let rest: Omit<
       ContractInfiniteQueryOptions<
@@ -736,7 +886,10 @@ export class ReactQueryContractHelper<
       resolveParams = params;
     } else {
       const { path, query, body, headers, page, key, ...other } = args;
-      queryKey = (key || this.key({ path, query, body, headers })) as QueryKey;
+      queryKey = key || [
+        ...this.key({ path, query, body, headers }),
+        "infinite",
+      ];
       rest = other;
       resolveParams = (context) => {
         const pageParams = page?.(context);