@veams/status-quo-query 0.11.0 → 0.13.0

package/.turbo/turbo-build.log

@@ -1,14 +1,14 @@
 
 
-> @veams/status-quo-query@0.3.0 build
+> @veams/status-quo-query@0.12.0 build
 > npm-run-all compile
 
 
-> @veams/status-quo-query@0.3.0 compile
+> @veams/status-quo-query@0.12.0 compile
 > npm-run-all bundle:ts
 
 
-> @veams/status-quo-query@0.3.0 bundle:ts
+> @veams/status-quo-query@0.12.0 bundle:ts
 > tsc --project tsconfig.json
 
 ⠙⠙⠙

package/README.md

@@ -18,14 +18,14 @@ npm install react
 
 Status Quo Query deliberately keeps the public surface small:
 
-- `QueryService<TData, TError>` is the read handle for one query.
-- `MutationService<TData, TError, TVariables>` is the write handle for one mutation.
+- `QueryHandle<TData, TError>` is the read handle for one query.
+- `MutationHandle<TData, TError, TVariables>` is the write handle for one mutation.
 - snapshots are passive state objects returned from `getSnapshot()` and `subscribe(...)`.
 - commands stay on the handle: `refetch()`, `invalidate()`, `mutate()`, `reset()`.
 - `QueryManager` is the broader coordination layer for cross-query work.
-- `@veams/status-quo-query/react` is optional and adds one React subscription hook over the same handle shape.
+- `@veams/status-quo-query/react` is optional and adds React subscription hooks (`useQueryHandle`, `useMutationHandle`) over the same handle shape.
 
-That keeps the package usable in service code, state handlers, and React components without changing the core query or mutation API.
+That keeps the package usable in service code, query handlers, state handlers, and React components without changing the core query or mutation API.
 
 ## Package Exports
 
@@ -35,6 +35,7 @@ Root exports:
 - `setupQuery`
 - `setupMutation`
 - `isQueryLoading`
+- `toQueryHandleData`
 - `toQueryMetaState`
 - `QueryFetchStatus`
 - `QueryStatus`
@@ -46,14 +47,15 @@ Root exports:
 - `CreateMutationWithDefaults`
 - `CreateUntrackedQuery`
 - `CreateUntrackedMutation`
-- `QueryService`
-- `MutationService`
-- `QueryServiceSnapshot`
-- `MutationServiceSnapshot`
+- `QueryHandle`
+- `QueryHandleData`
+- `MutationHandle`
+- `QueryHandleSnapshot`
+- `MutationHandleSnapshot`
 - `QueryDependencyTuple`
-- `QueryServiceOptions`
-- `MutationServiceOptions`
-- `TrackedMutationServiceOptions`
+- `QueryHandleOptions`
+- `MutationHandleOptions`
+- `TrackedMutationHandleOptions`
 - `QueryInvalidateOptions`
 - `QueryMetaState`
 - `TrackedDependencyRecord`
@@ -68,7 +70,7 @@ Subpath exports:
 - `@veams/status-quo-query/provider`
 - `@veams/status-quo-query/query`
 - `@veams/status-quo-query/mutation`
-- `@veams/status-quo-query/react`
+- `@veams/status-quo-query/react` (`useQueryHandle`, `useMutationHandle`)
 
 ## Quickstart
 
@@ -131,26 +133,56 @@ await userQuery.invalidate({ refetchType: 'none' });
 
 ## React Bindings
 
-The React entrypoint exposes `useQuerySubscription(...)` and keeps `react` optional unless you
-import `@veams/status-quo-query/react`.
+The React entrypoint exposes `useQueryHandle(...)` and `useMutationHandle(...)` and keeps `react` optional unless you import `@veams/status-quo-query/react`.
+
+### `useQueryHandle`
 
 ```tsx
-import { useQuerySubscription } from '@veams/status-quo-query/react';
-import type { QueryService } from '@veams/status-quo-query';
+import { useQueryHandle } from '@veams/status-quo-query/react';
+import type { QueryHandle } from '@veams/status-quo-query';
 
-function ProductName({ query }: { query: QueryService<{ name: string }, Error> }) {
-  const snapshot = useQuerySubscription(query);
+function ProductName({ query }: { query: QueryHandle<{ name: string }, Error> }) {
+  const snapshot = useQueryHandle(query);
 
   return <span>{snapshot.data?.name ?? 'loading'}</span>;
 }
 ```
 
-Use the hook when a component should subscribe directly to a query service and render from its latest snapshot. Keep mapping at the component level:
+Use the hook when a component should subscribe directly to a query handle and render from its latest snapshot. Keep mapping at the component level:
 
 - read `data`, `status`, `fetchStatus`, and flags like `isPending` from the snapshot
 - call `query.refetch()` or `query.invalidate()` on the handle itself
 - derive view-specific values in the component instead of adding selector logic to the hook
 
+### `useMutationHandle`
+
+```tsx
+import { useMutationHandle } from '@veams/status-quo-query/react';
+import type { MutationHandle } from '@veams/status-quo-query';
+
+function SaveButton({
+  mutation,
+  payload,
+}: {
+  mutation: MutationHandle<{ ok: boolean }, Error, { name: string }>;
+  payload: { name: string };
+}) {
+  const snapshot = useMutationHandle(mutation);
+
+  return (
+    <button onClick={() => mutation.mutate(payload)} disabled={snapshot.isPending}>
+      {snapshot.isPending ? 'Saving…' : 'Save'}
+    </button>
+  );
+}
+```
+
+Use `useMutationHandle` when a component should react to mutation state (pending, success, error). Keep imperative calls on the handle itself:
+
+- read `status`, `isPending`, `isError`, `isSuccess`, `data`, `error`, `variables` from the snapshot
+- call `mutation.mutate(variables)` or `mutation.reset()` on the handle itself
+- the hook does not trigger the mutation — it only subscribes to its state
+
 ## Status Quo Integration
 
 The same query handle can also feed a `status-quo` handler through `bindSubscribable(...)`.
@@ -160,7 +192,7 @@ import { NativeStateHandler } from '@veams/status-quo';
 import {
   toQueryMetaState,
   type QueryMetaState,
-  type QueryService,
+  type QueryHandle,
 } from '@veams/status-quo-query';
 
 type Product = {
@@ -178,7 +210,7 @@ type ProductCardActions = {
 };
 
 export class ProductCardHandler extends NativeStateHandler<ProductCardState, ProductCardActions> {
-  constructor(private readonly productQuery: QueryService<Product, Error>) {
+  constructor(private readonly productQuery: QueryHandle<Product, Error>) {
     super({
       initialState: {
         product: productQuery.getSnapshot().data,
@@ -500,7 +532,7 @@ Use `dependsOn` when a query needs data from other queries before it can run.
 
 `dependsOn` accepts a `QueryDependencyTuple`:
 
-- an ordered list of source query services
+- an ordered list of source query handles
 - a `deriveOptions(...)` callback that returns only `queryKey` and/or `enabled`
 
 The watcher starts on the first `subscribe(...)` or `refetch()`, reads the current source snapshots immediately, and stops after the last unsubscribe. A downstream `refetch()` refetches all source services first, then refetches the derived query.
@@ -650,6 +682,7 @@ Returns `QueryManager` with:
 - `cancelQueries(...)`
 - `fetchQuery(...)`
 - `getQueryData(...)`
+- `getQueryState(...)`
 - `invalidateQueries(...)`
 - `refetchQueries(...)`
 - `removeQueries(...)`
@@ -659,6 +692,95 @@ Returns `QueryManager` with:
 
 All manager methods forward directly to the corresponding `QueryClient` methods. `fetchQuery(...)` covers the common one-off read path without dropping to the raw client, while `unsafe_getClient()` remains the explicit escape hatch for unsupported TanStack APIs.
 
+### How to write a service
+
+Do not memoize `QueryHandle` instances in a package-level registry.
+
+TanStack already deduplicates cached queries by `queryKey`. A `QueryHandle` is a handle over that cached state, closer to a TanStack `QueryObserver` than to the cached query entry itself. Creating a fresh handle per service method call is fine when the caller wants a live query handle.
+
+Use this split in a query handler:
+
+- return fresh query handles from methods that expose `refetch()`, `subscribe(...)`, or `invalidate()`
+- read cache state directly from `QueryManager` in state-only methods
+- add smaller data-only methods when callers do not need fetch metadata
+
+Example:
+
+```ts
+import type {
+  QueryHandle,
+  QueryHandleData,
+  QueryHandleSnapshot,
+} from '@veams/status-quo-query';
+
+type Company = {
+  id: string;
+  name: string;
+};
+
+// Shared key factories keep the live handle path and snapshot path aligned.
+const companiesQueryKey = ['companies'] as const;
+const companyByIdQueryKey = (companyId: string) => ['company', companyId] as const;
+
+export interface CompanyQueryHandler {
+  getCompaniesQuery: () => QueryHandle<Company[], Error>;
+  getCompanyQueryById: (companyId: string) => QueryHandle<Company, Error>;
+  getCompanyStateById: (companyId: string) => QueryHandleSnapshot<Company, Error>;
+  getCompanyDataById: (companyId: string) => QueryHandleData<Company, Error>;
+}
+
+export function createCompanyQueryHandler(): CompanyQueryHandler {
+  const manager = getQueryManager();
+
+  return {
+    // Return a fresh query handle when callers need commands or subscriptions.
+    getCompaniesQuery() {
+      return manager.createUntrackedQuery(companiesQueryKey, fetchCompanies, {
+        staleTime: companyStaleTime,
+      });
+    },
+    // Parameterized query handles are cheap and map directly to the final query key.
+    getCompanyQueryById(companyId) {
+      const queryKey = companyByIdQueryKey(companyId);
+
+      return manager.createUntrackedQuery(queryKey, () => fetchCompanyById(companyId), {
+        staleTime: companyStaleTime,
+      });
+    },
+    // Snapshot-only reads should use the manager cache APIs instead of building another handle.
+    getCompanyStateById(companyId) {
+      const queryKey = companyByIdQueryKey(companyId);
+      const state = manager.getQueryState(queryKey);
+
+      return {
+        data: manager.getQueryData(queryKey),
+        error: (state?.error as Error | null | undefined) ?? null,
+        fetchStatus: state?.fetchStatus ?? 'idle',
+        status: state?.status ?? 'pending',
+        isError: state?.status === 'error',
+        isFetching: state?.fetchStatus === 'fetching',
+        isPending: state?.status === 'pending',
+        isSuccess: state?.status === 'success',
+      };
+    },
+    // Data-only reads can stay even smaller when the caller does not need fetch meta state.
+    getCompanyDataById(companyId) {
+      const queryKey = companyByIdQueryKey(companyId);
+      const state = manager.getQueryState(queryKey);
+
+      return {
+        data: manager.getQueryData(queryKey),
+        error: (state?.error as Error | null | undefined) ?? null,
+      };
+    },
+  };
+}
+```
+
+In this example, `getQueryManager()` is your application-level accessor for the shared `QueryManager`.
+
+This keeps the query handler focused on one feature area, supports parameterized query methods naturally, and offers both full state reads and smaller data-only reads without creating extra handle instances.
+
 ### Tracked Queries and Mutations
 
 Tracked queries embed dependency metadata into the final query-key segment:
@@ -669,9 +791,9 @@ Tracked queries embed dependency metadata into the final query-key segment:
 
 Only `deps` participates in automatic invalidation tracking. `view` is optional and is treated as normal query-key data.
 
-`createQuery(queryKey, queryFn, options?)` returns the same `QueryService<TData, TError>` shape as `createUntrackedQuery(...)`, but it registers the query hash under every `deps` entry, re-registers on `refetch()` or the first `subscribe(...)` if TanStack has removed the cache entry in the meantime, and keeps the registry in sync when `dependsOn` derives a new tracked key at runtime.
+`createQuery(queryKey, queryFn, options?)` returns the same `QueryHandle<TData, TError>` shape as `createUntrackedQuery(...)`, but it registers the query hash under every `deps` entry, re-registers on `refetch()` or the first `subscribe(...)` if TanStack has removed the cache entry in the meantime, and keeps the registry in sync when `dependsOn` derives a new tracked key at runtime.
 
-`createMutation(mutationFn, options?)` returns the same `MutationService<TData, TError, TVariables, TOnMutateResult>` shape as `createUntrackedMutation(...)`, but adds:
+`createMutation(mutationFn, options?)` returns the same `MutationHandle<TData, TError, TVariables, TOnMutateResult>` shape as `createUntrackedMutation(...)`, but adds:
 
 - `dependencyKeys?`
 - `resolveDependencies?`
@@ -694,7 +816,7 @@ Captures dependency names once and returns:
 - the tracked query factory
 - a tracked mutation factory whose default resolver reads `variables[dependencyKey]`
 
-The tracked query factory still expects a query key with a final `{ deps, view? }` segment. The tracked mutation factory keeps the same `MutationService` shape as `createMutation(...)`, but no longer needs `dependencyKeys` repeated in each call.
+The tracked query factory still expects a query key with a final `{ deps, view? }` segment. The tracked mutation factory keeps the same `MutationHandle` shape as `createMutation(...)`, but no longer needs `dependencyKeys` repeated in each call.
 
 Reach for standalone `createMutation(...)` when:
 
@@ -706,17 +828,17 @@ Reach for standalone `createMutation(...)` when:
 
 Creates a `createUntrackedQuery` factory bound to a `QueryClient`.
 
-`createUntrackedQuery(queryKey, queryFn, options?)` returns `QueryService<TData, TError>`.
+`createUntrackedQuery(queryKey, queryFn, options?)` returns `QueryHandle<TData, TError>`.
 
-`QueryServiceOptions` is based on TanStack `QueryObserverOptions`, without `queryKey` and `queryFn` because those are provided directly to `createUntrackedQuery`.
+`QueryHandleOptions` is based on TanStack `QueryObserverOptions`, without `queryKey` and `queryFn` because those are provided directly to `createUntrackedQuery`.
 
 It also adds:
 
 - `dependsOn?: QueryDependencyTuple<[...sources]>`
 
-`dependsOn` observes the listed source query services and lets the downstream query derive only `queryKey` and `enabled`. Source services are activated while the downstream query is active, and downstream `refetch()` refetches the sources first. The public `QueryService` API does not change when this option is used.
+`dependsOn` observes the listed source query handles and lets the downstream query derive only `queryKey` and `enabled`. Source handles are activated while the downstream query is active, and downstream `refetch()` refetches the sources first. The public `QueryHandle` API does not change when this option is used.
 
-`QueryService` methods:
+`QueryHandle` methods:
 
 - `getSnapshot()`
 - `subscribe(listener)`
@@ -724,7 +846,7 @@ It also adds:
 - `invalidate(options?)`
 - `unsafe_getResult()`
 
-`QueryServiceSnapshot<TData, TError>` fields:
+`QueryHandleSnapshot<TData, TError>` fields:
 
 - `data`
 - `error`
@@ -735,6 +857,11 @@ It also adds:
 - `isPending`
 - `isSuccess`
 
+`QueryHandleData<TData, TError>` fields:
+
+- `data`
+- `error`
+
 `invalidate(options?)` invalidates the query by its exact key. `QueryInvalidateOptions` supports:
 
 - `refetchType`
@@ -747,11 +874,11 @@ It also adds:
 
 Creates a `createUntrackedMutation` factory bound to a `QueryClient`.
 
-`createUntrackedMutation(mutationFn, options?)` returns `MutationService<TData, TError, TVariables, TOnMutateResult>`.
+`createUntrackedMutation(mutationFn, options?)` returns `MutationHandle<TData, TError, TVariables, TOnMutateResult>`.
 
-`MutationServiceOptions` is based on TanStack `MutationObserverOptions`, without `mutationFn` because it is provided directly to `createUntrackedMutation`.
+`MutationHandleOptions` is based on TanStack `MutationObserverOptions`, without `mutationFn` because it is provided directly to `createUntrackedMutation`.
 
-`MutationService` methods:
+`MutationHandle` methods:
 
 - `getSnapshot()`
 - `subscribe(listener)`
@@ -759,7 +886,7 @@ Creates a `createUntrackedMutation` factory bound to a `QueryClient`.
 - `reset()`
 - `unsafe_getResult()`
 
-`MutationServiceSnapshot<TData, TError, TVariables>` fields:
+`MutationHandleSnapshot<TData, TError, TVariables>` fields:
 
 - `data`
 - `error`
@@ -774,6 +901,11 @@ Creates a `createUntrackedMutation` factory bound to a `QueryClient`.
 
 ### Query Helpers
 
+`toQueryHandleData(snapshot)` reduces a query snapshot to:
+
+- `data`
+- `error`
+
 `toQueryMetaState(snapshot)` reduces a query snapshot to:
 
 - `status`

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 export * from './mutation.js';
 export * from './query.js';
 export * from './provider.js';
-export * from './query-registry.js';
 export type { TrackedDependencyRecord, TrackedDependencyValue, TrackedInvalidateOn, TrackedMatchMode, TrackedQueryKey, TrackedQueryKeySegment, } from './tracking.js';

package/dist/index.js

@@ -4,6 +4,4 @@ export * from './mutation.js';
 export * from './query.js';
 // Re-export all provider-related types and functions for cache management.
 export * from './provider.js';
-// Re-export query registry helpers for memoizing query services by key.
-export * from './query-registry.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,cAAc,eAAe,CAAC;AAC9B,mDAAmD;AACnD,cAAc,YAAY,CAAC;AAC3B,2EAA2E;AAC3E,cAAc,eAAe,CAAC;AAC9B,wEAAwE;AACxE,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,cAAc,eAAe,CAAC;AAC9B,mDAAmD;AACnD,cAAc,YAAY,CAAC;AAC3B,2EAA2E;AAC3E,cAAc,eAAe,CAAC"}

package/dist/mutation.d.ts

@@ -4,7 +4,7 @@ export type MutationStatus = TanstackMutationStatus;
 /**
  * Represents a stable snapshot of the mutation service's state.
  */
-export interface MutationServiceSnapshot<TData = unknown, TError = Error, TVariables = void> {
+export interface MutationHandleSnapshot<TData = unknown, TError = Error, TVariables = void> {
     data: TData | undefined;
     error: TError | null;
     status: MutationStatus;
@@ -17,9 +17,9 @@ export interface MutationServiceSnapshot<TData = unknown, TError = Error, TVaria
 /**
  * Defines the public API for a mutation service.
  */
-export interface MutationService<TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown> {
-    getSnapshot: () => MutationServiceSnapshot<TData, TError, TVariables>;
-    subscribe: (listener: (snapshot: MutationServiceSnapshot<TData, TError, TVariables>) => void) => () => void;
+export interface MutationHandle<TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown> {
+    getSnapshot: () => MutationHandleSnapshot<TData, TError, TVariables>;
+    subscribe: (listener: (snapshot: MutationHandleSnapshot<TData, TError, TVariables>) => void) => () => void;
     mutate: (variables: TVariables, options?: MutateOptions<TData, TError, TVariables, TOnMutateResult>) => Promise<TData>;
     reset: () => void;
     unsafe_getResult: () => MutationObserverResult<TData, TError, TVariables, TOnMutateResult>;
@@ -27,12 +27,12 @@ export interface MutationService<TData = unknown, TError = Error, TVariables = v
 /**
  * Configuration options for creating a mutation service, excluding the mutation function itself.
  */
-export type MutationServiceOptions<TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown> = Omit<MutationObserverOptions<TData, TError, TVariables, TOnMutateResult>, 'mutationFn'>;
+export type MutationHandleOptions<TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown> = Omit<MutationObserverOptions<TData, TError, TVariables, TOnMutateResult>, 'mutationFn'>;
 /**
  * Function signature for the untracked mutation factory.
  */
 export interface CreateUntrackedMutation {
-    <TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown>(mutationFn: MutationFunction<TData, TVariables>, options?: MutationServiceOptions<TData, TError, TVariables, TOnMutateResult>): MutationService<TData, TError, TVariables, TOnMutateResult>;
+    <TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown>(mutationFn: MutationFunction<TData, TVariables>, options?: MutationHandleOptions<TData, TError, TVariables, TOnMutateResult>): MutationHandle<TData, TError, TVariables, TOnMutateResult>;
 }
 /**
  * Additional options for tracked mutations that invalidate queries automatically.
@@ -41,7 +41,7 @@ export interface CreateUntrackedMutation {
  * options only describe how the facade should derive dependency values and when it should
  * invalidate matching tracked queries after the mutation lifecycle settles.
  */
-export interface TrackedMutationServiceOptions<TDeps extends TrackedDependencyRecord = TrackedDependencyRecord, TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown> extends MutationServiceOptions<TData, TError, TVariables, TOnMutateResult> {
+export interface TrackedMutationHandleOptions<TDeps extends TrackedDependencyRecord = TrackedDependencyRecord, TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown> extends MutationHandleOptions<TData, TError, TVariables, TOnMutateResult> {
     dependencyKeys?: readonly (keyof TDeps & string)[];
     resolveDependencies?: (variables: TVariables) => Partial<TDeps>;
     invalidateOn?: TrackedInvalidateOn;
@@ -51,7 +51,7 @@ export interface TrackedMutationServiceOptions<TDeps extends TrackedDependencyRe
  * Function signature for the default mutation factory with automatic invalidation.
  */
 export interface CreateMutation {
-    <TDeps extends TrackedDependencyRecord = TrackedDependencyRecord, TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown>(mutationFn: MutationFunction<TData, TVariables>, options?: TrackedMutationServiceOptions<TDeps, TData, TError, TVariables, TOnMutateResult>): MutationService<TData, TError, TVariables, TOnMutateResult>;
+    <TDeps extends TrackedDependencyRecord = TrackedDependencyRecord, TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown>(mutationFn: MutationFunction<TData, TVariables>, options?: TrackedMutationHandleOptions<TDeps, TData, TError, TVariables, TOnMutateResult>): MutationHandle<TData, TError, TVariables, TOnMutateResult>;
 }
 /**
  * Prepares the mutation factory by binding it to a specific QueryClient instance.

package/dist/mutation.js

@@ -8,7 +8,7 @@ import { pickTrackedDependencies, resolveTrackedQueries, toTrackedDependencyEntr
 export function setupMutation(queryClient) {
     // Returns the actual factory function for creating individual mutation services.
     return function createMutation(mutationFn, options) {
-        return createMutationService(queryClient, mutationFn, options);
+        return createMutationHandle(queryClient, mutationFn, options);
     };
 }
 /**
@@ -22,8 +22,8 @@ export function setupTrackedMutation(queryClient, trackingRegistry, defaultDepen
     return function createMutation(mutationFn, options) {
         // Split tracked-only options from the underlying TanStack mutation observer options.
         const { dependencyKeys, invalidateOn = 'success', matchMode = 'intersection', resolveDependencies, ...mutationOptions } = options ?? {};
-        // Reuse the normal mutation service so snapshots and subscription behavior stay identical.
-        const service = createMutationService(queryClient, mutationFn, mutationOptions);
+        // Reuse the normal mutation handle so snapshots and subscription behavior stay identical.
+        const handle = createMutationHandle(queryClient, mutationFn, mutationOptions);
         // The paired helper injects dependency keys here, while standalone tracked mutations can
         // still provide them directly or bypass them with a custom resolver.
         const resolvedDependencyKeys = (dependencyKeys ?? defaultDependencyKeys);
@@ -41,12 +41,12 @@ export function setupTrackedMutation(queryClient, trackingRegistry, defaultDepen
             })));
         };
         return {
-            ...service,
+            ...handle,
             mutate: async (variables, mutateOptions) => {
                 try {
                     // Let TanStack finish the mutation first so its own callbacks and state machine remain
                     // authoritative. The facade only coordinates the follow-up invalidation.
-                    const result = await service.mutate(variables, mutateOptions);
+                    const result = await handle.mutate(variables, mutateOptions);
                     if (invalidateOn === 'success' || invalidateOn === 'settled') {
                         await invalidateTrackedQueries(variables);
                     }
@@ -71,7 +71,7 @@ export function setupTrackedMutation(queryClient, trackingRegistry, defaultDepen
 /**
  * Internal helper to transform a raw Tanstack mutation result into our public snapshot format.
  */
-function toMutationServiceSnapshot(result) {
+function toMutationHandleSnapshot(result) {
     // Extract and return the relevant fields for the UI or other services.
     return {
         data: result.data,
@@ -84,7 +84,7 @@ function toMutationServiceSnapshot(result) {
         isSuccess: result.isSuccess,
     };
 }
-function createMutationService(queryClient, mutationFn, options) {
+function createMutationHandle(queryClient, mutationFn, options) {
     // Keep the original mutation implementation in one place so tracked and untracked mutations
     // always expose the same observer-backed runtime behavior.
     const observer = new MutationObserver(queryClient, {
@@ -92,9 +92,9 @@ function createMutationService(queryClient, mutationFn, options) {
         mutationFn,
     });
     return {
-        getSnapshot: () => toMutationServiceSnapshot(observer.getCurrentResult()),
+        getSnapshot: () => toMutationHandleSnapshot(observer.getCurrentResult()),
         subscribe: (listener) => observer.subscribe((result) => {
-            listener(toMutationServiceSnapshot(result));
+            listener(toMutationHandleSnapshot(result));
         }),
         mutate: (variables, mutateOptions) => observer.mutate(variables, mutateOptions),
         reset: () => observer.reset(),

package/dist/mutation.js.map

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

package/dist/provider.d.ts

@@ -1,5 +1,5 @@
 import { type QueryClient, type MutationFunction } from '@tanstack/query-core';
-import { type CreateMutation, type CreateUntrackedMutation, type MutationService, type TrackedMutationServiceOptions } from './mutation.js';
+import { type CreateMutation, type CreateUntrackedMutation, type MutationHandle, type TrackedMutationHandleOptions } from './mutation.js';
 import { type CreateQuery, type CreateUntrackedQuery } from './query.js';
 import { type TrackedDependencyValue } from './tracking.js';
 /**
@@ -9,7 +9,7 @@ import { type TrackedDependencyValue } from './tracking.js';
  * once at setup time and injects them automatically for each tracked mutation it creates.
  */
 export interface CreateMutationWithDefaults<TDependencyKey extends string> {
-    <TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown>(mutationFn: MutationFunction<TData, TVariables>, options?: Omit<TrackedMutationServiceOptions<Record<TDependencyKey, TrackedDependencyValue>, TData, TError, TVariables, TOnMutateResult>, 'dependencyKeys'>): MutationService<TData, TError, TVariables, TOnMutateResult>;
+    <TData = unknown, TError = Error, TVariables = void, TOnMutateResult = unknown>(mutationFn: MutationFunction<TData, TVariables>, options?: Omit<TrackedMutationHandleOptions<Record<TDependencyKey, TrackedDependencyValue>, TData, TError, TVariables, TOnMutateResult>, 'dependencyKeys'>): MutationHandle<TData, TError, TVariables, TOnMutateResult>;
 }
 /**
  * Paired tracked helper that captures dependency keys once for default mutation resolution.
@@ -29,6 +29,7 @@ export interface QueryManager {
     cancelQueries: QueryClient['cancelQueries'];
     fetchQuery: QueryClient['fetchQuery'];
     getQueryData: QueryClient['getQueryData'];
+    getQueryState: QueryClient['getQueryState'];
     invalidateQueries: QueryClient['invalidateQueries'];
     refetchQueries: QueryClient['refetchQueries'];
     removeQueries: QueryClient['removeQueries'];

package/dist/provider.js

@@ -48,6 +48,8 @@ export function setupQueryManager(queryClient) {
         fetchQuery: queryClient.fetchQuery.bind(queryClient),
         // Proxy for retrieving query data with this client context.
         getQueryData: queryClient.getQueryData.bind(queryClient),
+        // Proxy for retrieving raw query state with this client context.
+        getQueryState: queryClient.getQueryState.bind(queryClient),
         // Proxy for invalidating queries with this client context.
         invalidateQueries: queryClient.invalidateQueries.bind(queryClient),
         // Proxy for refetching queries with this client context.

package/dist/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAMA,qEAAqE;AACrE,OAAO,EAKL,aAAa,EACb,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAA+C,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACxG,OAAO,EACL,sBAAsB,GAEvB,MAAM,eAAe,CAAC;AAmEvB;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAwB;IACxD,sFAAsF;IACtF,sFAAsF;IACtF,MAAM,gBAAgB,GAAG,sBAAsB,EAAE,CAAC;IAClD,MAAM,YAAY,GAAG,iBAAiB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,oBAAoB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAC5E,MAAM,qBAAqB,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,wBAAwB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAE5D,WAAW,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,6FAA6F;YAC7F,4FAA4F;YAC5F,gFAAgF;YAChF,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,2DAA2D;IAC3D,OAAO;QACL,6CAA6C;QAC7C,cAAc,EAAE,eAAe;QAC/B,0CAA0C;QAC1C,WAAW,EAAE,YAAY;QACzB,oDAAoD;QACpD,oBAAoB,EAAE,qBAAqB;QAC3C,uDAAuD;QACvD,uBAAuB,EAAE,wBAAwB;QACjD,8DAA8D;QAC9D,sBAAsB,EAAE,CACtB,cAA+B,EAC/B,EAAE;YACF,MAAM,0BAA0B,GAE5B,CACF,UAA+C,EAC/C,OASC,EACD,EAAE;YACF,uFAAuF;YACvF,mFAAmF;YACnF,eAAe,CAMb,UAAU,EAAE;gBACZ,GAAG,OAAO;gBACV,cAAc;aACf,CAAC,CAAC;YAEL,OAAO,CAAC,YAAY,EAAE,0BAA0B,CAAU,CAAC;QAC7D,CAAC;QACD,wDAAwD;QACxD,aAAa,EAAE,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC;QAC1D,yDAAyD;QACzD,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC;QACpD,4DAA4D;QAC5D,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;QACxD,2DAA2D;QAC3D,iBAAiB,EAAE,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC;QAClE,yDAAyD;QACzD,cAAc,EAAE,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC;QAC5D,uDAAuD;QACvD,aAAa,EAAE,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC;QAC1D,wDAAwD;QACxD,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;QACxD,yDAAyD;QACzD,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;QACxD,mDAAmD;QACnD,gBAAgB,EAAE,GAAG,EAAE,CAAC,WAAW;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAMA,qEAAqE;AACrE,OAAO,EAKL,aAAa,EACb,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAA+C,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACxG,OAAO,EACL,sBAAsB,GAEvB,MAAM,eAAe,CAAC;AAqEvB;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAwB;IACxD,sFAAsF;IACtF,sFAAsF;IACtF,MAAM,gBAAgB,GAAG,sBAAsB,EAAE,CAAC;IAClD,MAAM,YAAY,GAAG,iBAAiB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,oBAAoB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAC5E,MAAM,qBAAqB,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,wBAAwB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAE5D,WAAW,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,6FAA6F;YAC7F,4FAA4F;YAC5F,gFAAgF;YAChF,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,2DAA2D;IAC3D,OAAO;QACL,6CAA6C;QAC7C,cAAc,EAAE,eAAe;QAC/B,0CAA0C;QAC1C,WAAW,EAAE,YAAY;QACzB,oDAAoD;QACpD,oBAAoB,EAAE,qBAAqB;QAC3C,uDAAuD;QACvD,uBAAuB,EAAE,wBAAwB;QACjD,8DAA8D;QAC9D,sBAAsB,EAAE,CACtB,cAA+B,EAC/B,EAAE;YACF,MAAM,0BAA0B,GAE5B,CACF,UAA+C,EAC/C,OASC,EACD,EAAE;YACF,uFAAuF;YACvF,mFAAmF;YACnF,eAAe,CAMb,UAAU,EAAE;gBACZ,GAAG,OAAO;gBACV,cAAc;aACf,CAAC,CAAC;YAEL,OAAO,CAAC,YAAY,EAAE,0BAA0B,CAAU,CAAC;QAC7D,CAAC;QACD,wDAAwD;QACxD,aAAa,EAAE,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC;QAC1D,yDAAyD;QACzD,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC;QACpD,4DAA4D;QAC5D,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;QACxD,iEAAiE;QACjE,aAAa,EAAE,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC;QAC1D,2DAA2D;QAC3D,iBAAiB,EAAE,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC;QAClE,yDAAyD;QACzD,cAAc,EAAE,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC;QAC5D,uDAAuD;QACvD,aAAa,EAAE,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC;QAC1D,wDAAwD;QACxD,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;QACxD,yDAAyD;QACzD,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;QACxD,mDAAmD;QACnD,gBAAgB,EAAE,GAAG,EAAE,CAAC,WAAW;KACpC,CAAC;AACJ,CAAC"}