@ic-reactor/react 3.12.5 → 3.13.0

package/dist/hooks/useActorMethod.js

@@ -1,6 +1,28 @@
-import { useCallback, useEffect, useMemo, useRef } from "react";
-import { useQuery, useMutation, } from "@tanstack/react-query";
-import { normalizeQueryData } from "../utils.js";
+import { useCallback, useEffect, useInsertionEffect, useMemo, useRef, } from "react";
+import { useQuery, useMutation, hashKey, } from "@tanstack/react-query";
+import { invalidateTargets, normalizeQueryData, pickFetchOptions, useMountQueryClient, } from "../utils.js";
+/**
+ * A ref to `value` as of the last committed render, for code that runs outside
+ * render: event handlers, timers, effects and TanStack callbacks.
+ *
+ * Assigning the ref during render would also publish renders that React throws
+ * away, such as a transition that suspends or one that a more urgent update
+ * interrupts. The tree still on screen would then act on props it never showed,
+ * like calling a method it does not render. An insertion effect runs only when
+ * its render commits, and before every layout and passive effect of that
+ * commit, so no effect anywhere in the tree reads the previous commit's value.
+ * React's own `useEffectEvent` also swaps in its new function during the
+ * commit, ahead of layout effects. Unlike `useLayoutEffect`, an insertion
+ * effect does not warn in a React 18 server render. The initial value serves
+ * anything that runs before the first commit.
+ */
+function useCommittedRef(value) {
+    const ref = useRef(value);
+    useInsertionEffect(() => {
+        ref.current = value;
+    });
+    return ref;
+}
 /**
  * A unified hook for calling canister methods that automatically handles
  * both query and mutation methods based on the Candid interface.
@@ -13,12 +35,12 @@ export function useActorMethod({ reactor, functionName, args, callConfig, queryK
         return reactor.isQueryMethod(functionName);
     }, [reactor, functionName]);
     const functionType = isQuery ? "query" : "update";
-    // Latest callbacks, read at dispatch time: this keeps a rerendered closure
-    // from being ignored, and keeps callback identity out of the effect deps.
-    const onSuccessRef = useRef(onSuccess);
-    const onErrorRef = useRef(onError);
-    onSuccessRef.current = onSuccess;
-    onErrorRef.current = onError;
+    useMountQueryClient(reactor.queryClient);
+    // The committed render's callbacks, read at dispatch time: this keeps a
+    // rerendered closure from being ignored, and keeps callback identity out of
+    // the effect deps.
+    const onSuccessRef = useCommittedRef(onSuccess);
+    const onErrorRef = useCommittedRef(onError);
     // Build the key for a given set of call arguments.
     //
     // A custom `queryKey` is appended to the canister/function prefix rather than
@@ -68,15 +90,25 @@ export function useActorMethod({ reactor, functionName, args, callConfig, queryK
     // case that previously never notified at all.
     const notifiedSuccessAt = useRef(undefined);
     const notifiedErrorAt = useRef(undefined);
-    const { status, data, error, dataUpdatedAt, errorUpdatedAt } = queryResult;
+    const { status, data, error, dataUpdatedAt, errorUpdatedAt, isPlaceholderData, isFetched, } = queryResult;
     useEffect(() => {
         if (!isQuery)
             return;
+        // Placeholder data also has `status: "success"`, but no call has returned
+        // it: it is the `placeholderData` option, or with `keepPreviousData` the
+        // previous args' result standing in while this call is in flight.
+        if (isPlaceholderData)
+            return;
+        // So does `initialData`: an entry starts with it, and `reset()` puts it
+        // back, before any fetch of the entry has settled. The first fetch that
+        // settles makes the entry fetched, and its result is reported below.
+        if (!isFetched)
+            return;
         if (status === "success" && dataUpdatedAt !== notifiedSuccessAt.current) {
             notifiedSuccessAt.current = dataUpdatedAt;
             onSuccessRef.current?.(data);
         }
-    }, [isQuery, status, data, dataUpdatedAt]);
+    }, [isQuery, status, data, dataUpdatedAt, isPlaceholderData, isFetched]);
     useEffect(() => {
         if (!isQuery)
             return;
@@ -85,11 +117,67 @@ export function useActorMethod({ reactor, functionName, args, callConfig, queryK
             onErrorRef.current?.(error);
         }
     }, [isQuery, status, error, errorUpdatedAt]);
+    // `call(args)` reports its own outcome, once per call, because the args it
+    // fetched usually key an entry this observer does not watch. When they key
+    // the entry it does watch, the effects above see the same settle, and each
+    // callback used to fire twice for one call. So the settle that ends a call's
+    // fetch is marked as notified when it lands in the observed entry, and the
+    // effects skip it.
+    //
+    // A query cache listener sets that mark while TanStack dispatches the
+    // settle, before any render can show it. Matching a settle up by its
+    // timestamp afterwards could not tell settles apart: two in one millisecond
+    // share a timestamp. And a call that an identity switch cancels settles
+    // nothing: TanStack reverts the entry to its previous result, timestamp
+    // included, so the call's outcome looked reported already, and neither the
+    // call nor the effects reported it.
+    const observedKeyRef = useCommittedRef(queryKey);
+    const markCallSettle = (calledKey) => {
+        const { queryClient } = reactor;
+        // The hash TanStack files the called entry under, worked out the way
+        // `fetchQuery` does. The listener compares it with hashes TanStack has
+        // already computed rather than hashing keys itself: the QueryClient may be
+        // shared with the app, whose keys a custom `queryKeyHashFn` can let hold
+        // values that `hashKey` throws on, inside TanStack's dispatch.
+        const calledHash = queryClient.defaultQueryOptions({
+            queryKey: calledKey,
+        }).queryHash;
+        let settled = false;
+        return queryClient.getQueryCache().subscribe((event) => {
+            if (settled || event.type !== "updated")
+                return;
+            const { action, query } = event;
+            // A fetch settles with one of these. `setQueryData` dispatches a
+            // success too, flagged manual, and it does not end this call's fetch.
+            const isSettle = action.type === "error" || (action.type === "success" && !action.manual);
+            if (!isSettle || query.queryHash !== calledHash)
+                return;
+            settled = true;
+            if (hashKey(calledKey) !== hashKey(observedKeyRef.current))
+                return;
+            if (action.type === "success") {
+                notifiedSuccessAt.current = query.state.dataUpdatedAt;
+            }
+            else {
+                notifiedErrorAt.current = query.state.errorUpdatedAt;
+            }
+        });
+    };
     // ============================================================================
     // Mutation Implementation
     // ============================================================================
     const mutationResult = useMutation({
         mutationKey: queryKey,
+        // The hook's `retry`, `retryDelay`, `networkMode` and `meta`, the options
+        // that decide how a call runs, as the query branch's `call()` applies
+        // them. They reached only the query branch, so an update's call ignored
+        // them: it stayed paused offline under `networkMode: "always"` and
+        // reached the MutationCache callbacks without the hook's `meta`. Unset
+        // ones are left to the QueryClient's mutation defaults, which retry
+        // nothing unless the app set `mutations.retry`: each attempt of an
+        // update is a new call the canister runs, so only a `retry` given here
+        // or in those defaults sends one again.
+        ...pickFetchOptions(queryOptions),
         // Normalized like the query branch, so `data`, `call()` and `onSuccess`
         // mean the same thing for both kinds of method. The hook cannot type the
         // two branches apart: a Candid service type does not say which methods
@@ -99,23 +187,62 @@ export function useActorMethod({ reactor, functionName, args, callConfig, queryK
             args: mutationArgs ?? args,
             callConfig,
         }))),
-        onSuccess: (data) => {
+        // Invalidation first, then `onSuccess`, as `useActorMutation` and
+        // `createMutation` do. TanStack Query waits for the promise returned
+        // here before it settles the mutation, so `call()` resolves, and
+        // `isPending` turns false, once the invalidated queries that are in use
+        // have refetched, and `onSuccess` reads the refetched data. A refetch
+        // that fails does not reject `invalidateQueries`, so it cannot turn the
+        // update, which has already run on the canister, into a failure.
+        onSuccess: async (data) => {
+            await invalidateTargets(reactor, invalidateQueries, callConfig);
             onSuccessRef.current?.(data);
-            // Invalidate specified queries after successful mutation
-            if (invalidateQueries && invalidateQueries.length > 0) {
-                invalidateQueries.forEach((key) => {
-                    void reactor.queryClient.invalidateQueries({ queryKey: key });
-                });
-            }
         },
         onError: (error) => {
             onErrorRef.current?.(error);
         },
     }, reactor.queryClient);
     // ============================================================================
-    // Unified Call Function
+    // Refetch and Call Functions
     // ============================================================================
-    const call = useCallback(async (callArgs) => {
+    // A query's `call()` and `refetch()` resolve with the answer for the
+    // principal signed in when they settle. `ClientManager.updateAgent` cancels
+    // a fetch in flight when a sign-in or sign-out switches the principal, so
+    // that the previous principal's answer is never cached. TanStack then
+    // resolves the fetch with the data it puts the entry back to, which is the
+    // previous principal's, or rejects it with a `CancelledError` when the entry
+    // had none, and a call used to resolve with, and report, whichever it got.
+    // Through `fetchAcrossIdentitySwitch` it runs again for the principal signed
+    // in, as `reactor.fetchQuery()` and the factories' `fetch()` do. When the
+    // principal switches during that run too, and during each of two more, that
+    // rejects with a `CallError`, which is reported to `onError` like any other
+    // failure.
+    const refetchLatest = async () => {
+        if (!isQuery)
+            return undefined;
+        let runs = 0;
+        try {
+            const result = await reactor.clientManager.fetchAcrossIdentitySwitch(() => 
+            // A run after a switch joins the refetch the switch started for
+            // this entry, rather than cancel it and start another.
+            queryResult.refetch(runs++ === 0 ? undefined : { cancelRefetch: false }));
+            // TanStack's `refetch()` resolves even when the fetch fails, with the
+            // entry's last answer still in the result. After a sign-in or sign-out
+            // that is the previous principal's: the entry is put back to it when
+            // the switch cancels a fetch, and keeps it when the new principal's
+            // refetch fails. So a failed refetch resolves `undefined`, as a failed
+            // `call(args)` does, and the effects report the failure to `onError`.
+            // The hook's `data` keeps the last answer, as TanStack's does.
+            return result.isError ? undefined : result.data;
+        }
+        catch (error) {
+            // Only that CallError: `refetch()` itself never rejects. The effects
+            // report what the entry settles with, and it settles nothing for this.
+            onErrorRef.current?.(error);
+            return undefined;
+        }
+    };
+    const callLatest = async (callArgs) => {
         if (isQuery) {
             // For queries, refetch with new args if provided
             if (callArgs !== undefined) {
@@ -124,22 +251,41 @@ export function useActorMethod({ reactor, functionName, args, callConfig, queryK
                 // entry — poisoning it for every other reader — and let fetchQuery
                 // dedupe onto an in-flight request for the old args, returning that
                 // response as though it answered this one.
+                const calledKey = buildQueryKey(callArgs);
+                // Reported here rather than by the observer effects: this result
+                // usually lands under a key the mounted observer (bound to the hook's
+                // own args) does not watch. When it is that key, `markCallSettle` has
+                // already kept the effects from reporting it as well. Either way the
+                // callbacks get what the call settles with.
                 try {
-                    const result = await reactor.queryClient.fetchQuery({
-                        queryKey: buildQueryKey(callArgs),
-                        // Normalize for the same reason as the observer's queryFn.
-                        queryFn: async () => normalizeQueryData((await reactor.callMethod({
-                            functionName,
-                            args: callArgs,
-                            callConfig,
-                        }))),
-                        staleTime: 0,
+                    const result = await reactor.clientManager.fetchAcrossIdentitySwitch(async () => {
+                        // Each run marks the settle of its own fetch. A run a switch
+                        // overtook may have settled with the previous principal's answer,
+                        // which the effects must not report either.
+                        const stopMarking = markCallSettle(calledKey);
+                        try {
+                            return await reactor.queryClient.fetchQuery({
+                                // The options the hook's own fetches run with: `retry`,
+                                // `retryDelay`, `networkMode` and `meta`. With only a key and
+                                // a function, a call ran on the QueryClient's defaults. It
+                                // failed on the first error the hook retried through, stayed
+                                // paused offline under `networkMode: "always"`, and reached
+                                // the QueryCache callbacks without the hook's `meta`.
+                                ...pickFetchOptions(queryOptions),
+                                queryKey: calledKey,
+                                // Normalize for the same reason as the observer's queryFn.
+                                queryFn: async () => normalizeQueryData((await reactor.callMethod({
+                                    functionName,
+                                    args: callArgs,
+                                    callConfig,
+                                }))),
+                                staleTime: 0,
+                            });
+                        }
+                        finally {
+                            stopMarking();
+                        }
                     });
-                    // Dispatched here rather than by the observer effect: this result
-                    // lands under the called args' key, which the mounted observer (bound
-                    // to the hook's own args) does not watch. That separation is also why
-                    // this can no longer double-fire the way it did when both wrote to
-                    // the same key.
                     onSuccessRef.current?.(result);
                     return result;
                 }
@@ -149,8 +295,7 @@ export function useActorMethod({ reactor, functionName, args, callConfig, queryK
                 }
             }
             // Otherwise just refetch
-            const { data } = await queryResult.refetch();
-            return data;
+            return refetchLatest();
         }
         else {
             // For mutations, execute with provided args
@@ -158,19 +303,11 @@ export function useActorMethod({ reactor, functionName, args, callConfig, queryK
                 .mutateAsync(callArgs)
                 .catch(() => undefined);
         }
-    }, [
-        isQuery,
-        reactor,
-        functionName,
-        callConfig,
-        buildQueryKey,
-        queryResult,
-        mutationResult,
-    ]);
+    };
     // ============================================================================
     // Reset Function
     // ============================================================================
-    const reset = useCallback(() => {
+    const resetLatest = () => {
         if (isQuery) {
             // Reset, not remove. `removeQueries` drops the entry without notifying
             // its observers, so this hook kept rendering the old data while bound to
@@ -184,17 +321,24 @@ export function useActorMethod({ reactor, functionName, args, callConfig, queryK
         else {
             mutationResult.reset();
         }
-    }, [isQuery, reactor, queryKey, mutationResult]);
-    // ============================================================================
-    // Refetch Function
-    // ============================================================================
-    const refetch = useCallback(async () => {
-        if (isQuery) {
-            const result = await queryResult.refetch();
-            return result.data;
-        }
-        return undefined;
-    }, [isQuery, queryResult]);
+    };
+    // `call`, `reset` and `refetch` keep one identity for the life of the
+    // component, as TanStack's own `refetch`, `mutate` and `reset` do, and run
+    // the latest committed render's implementation above when invoked. They used
+    // to be `useCallback`s listing the query and mutation results, which TanStack
+    // Query returns fresh every render, so they changed every render too. An
+    // effect that lists one — `react-hooks/exhaustive-deps` requires it as soon
+    // as the effect calls it — then re-ran after every render its own call
+    // caused: an unbounded loop of canister calls, state-changing ones for an
+    // update method.
+    const latest = useCommittedRef({
+        call: callLatest,
+        reset: resetLatest,
+        refetch: refetchLatest,
+    });
+    const call = useCallback((callArgs) => latest.current.call(callArgs), []);
+    const reset = useCallback(() => latest.current.reset(), []);
+    const refetch = useCallback(() => latest.current.refetch(), []);
     // ============================================================================
     // Return Unified Result
     // ============================================================================

package/dist/hooks/useActorMethod.js.map

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

package/dist/hooks/useActorMutation.d.ts

@@ -1,18 +1,21 @@
-import { UseMutationOptions, UseMutationResult, QueryKey } from "@tanstack/react-query";
+import { UseMutationOptions, UseMutationResult } from "@tanstack/react-query";
 import { Reactor, ReactorArgs, ReactorReturnOk, FunctionName, TransformKey, ReactorReturnErr, CanisterError, ErrResult, ActorMethodReturnType, TransformReturnRegistry } from "@ic-reactor/core";
 import { CallConfig } from "@icp-sdk/core/agent";
+import type { InvalidationTarget } from "../types.js";
 export interface UseActorMutationParameters<Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", TOnMutateResult = unknown> extends Omit<UseMutationOptions<ReactorReturnOk<Service, Method, Transform>, ReactorReturnErr<Service, Method, Transform>, ReactorArgs<Service, Method, Transform>, TOnMutateResult>, "mutationFn"> {
     reactor: Reactor<Service, Transform>;
     functionName: Method;
     callConfig?: CallConfig;
     /**
-     * Queries to invalidate upon successful mutation.
+     * Queries to invalidate upon successful mutation, awaited before
+     * `onSuccess` runs.
      *
-     * `undefined` entries are skipped, so the common
-     * `[maybeQuery?.getQueryKey()]` idiom is safe when the optional query object
-     * is absent.
+     * Each entry is a query key, a query object or query factory, or a
+     * `{ functionName, args? }` method of `reactor`; see
+     * {@link InvalidationTarget}. `undefined` entries are skipped, so
+     * `[maybeQuery]` is safe when the optional query object is absent.
      */
-    invalidateQueries?: (QueryKey | undefined)[];
+    invalidateQueries?: InvalidationTarget<Service, Transform>[];
     /**
      * Callback for canister-level business logic errors.
      * Called when the canister returns a Result { Err: E } variant.
@@ -28,7 +31,7 @@ export type UseActorMutationResult<Service, Method extends FunctionName<Service>
  * For non-React usage, prefer `createMutation(...).execute(args)`.
  *
  * @example
- * const { mutate, isPending } = useActorMutation({
+ * const { mutate, isPending } = useReactorMutation({
  *   reactor,
  *   functionName: "transfer",
  *   onSuccess: () => console.log("Success!"),

package/dist/hooks/useActorMutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useActorMutation.d.ts","sourceRoot":"","sources":["../../src/hooks/useActorMutation.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACT,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,OAAO,EACP,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAEhB,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,MAAM,WAAW,0BAA0B,CACzC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,eAAe,GAAG,OAAO,CACzB,SAAQ,IAAI,CACZ,kBAAkB,CAChB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC3C,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC5C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EACvC,eAAe,CAChB,EACD,YAAY,CACb;IACC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAA;IAC5C;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,aAAa,CAClB,uBAAuB,CACrB,SAAS,CAAC,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EACjD,OAAO,CACR,CAAC,SAAS,CAAC,CACb,EACD,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,KAC/C,IAAI,CAAA;CACV;AAED,MAAM,MAAM,sBAAsB,CAChC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,eAAe,GAAG,OAAO,IACvB,IAAI,CACN,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,EACvE,SAAS,CACV,CAAA;AAED,MAAM,MAAM,sBAAsB,CAChC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,eAAe,GAAG,OAAO,IACvB,iBAAiB,CACnB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC3C,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC5C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EACvC,eAAe,CAChB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,eAAe,GAAG,OAAO,EACzB,2GASC,0BAA0B,CAC3B,OAAO,EACP,MAAM,EACN,SAAS,EACT,eAAe,CAChB,KAAG,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,CA8ErE,CAAA"}
+{"version":3,"file":"useActorMutation.d.ts","sourceRoot":"","sources":["../../src/hooks/useActorMutation.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,OAAO,EACP,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAEhB,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,WAAW,0BAA0B,CACzC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,eAAe,GAAG,OAAO,CACzB,SAAQ,IAAI,CACZ,kBAAkB,CAChB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC3C,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC5C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EACvC,eAAe,CAChB,EACD,YAAY,CACb;IACC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAA;IAC5D;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,aAAa,CAClB,uBAAuB,CACrB,SAAS,CAAC,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EACjD,OAAO,CACR,CAAC,SAAS,CAAC,CACb,EACD,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,KAC/C,IAAI,CAAA;CACV;AAED,MAAM,MAAM,sBAAsB,CAChC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,eAAe,GAAG,OAAO,IACvB,IAAI,CACN,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,EACvE,SAAS,CACV,CAAA;AAED,MAAM,MAAM,sBAAsB,CAChC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,eAAe,GAAG,OAAO,IACvB,iBAAiB,CACnB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC3C,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC5C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EACvC,eAAe,CAChB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,eAAe,GAAG,OAAO,EACzB,2GASC,0BAA0B,CAC3B,OAAO,EACP,MAAM,EACN,SAAS,EACT,eAAe,CAChB,KAAG,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,CA2ErE,CAAA"}

package/dist/hooks/useActorMutation.js

@@ -1,13 +1,14 @@
 import { useCallback } from "react";
 import { useMutation, } from "@tanstack/react-query";
 import { isCanisterError, } from "@ic-reactor/core";
+import { invalidateTargets, useMountQueryClient } from "../utils.js";
 /**
  * Hook for executing mutation calls on a canister.
  * Use this for component-level mutation flows.
  * For non-React usage, prefer `createMutation(...).execute(args)`.
  *
  * @example
- * const { mutate, isPending } = useActorMutation({
+ * const { mutate, isPending } = useReactorMutation({
  *   reactor,
  *   functionName: "transfer",
  *   onSuccess: () => console.log("Success!"),
@@ -24,21 +25,15 @@ import { isCanisterError, } from "@ic-reactor/core";
  * await transferMutation.execute([{ to: "aaaaa-aa", amount: "100" }])
  */
 export const useActorMutation = ({ reactor, functionName, invalidateQueries, onSuccess, onError, onCanisterError, callConfig, ...options }) => {
+    useMountQueryClient(reactor.queryClient);
     const mutationFn = useCallback(async (args) => reactor.callMethod({ functionName, callConfig, args }), [reactor, functionName, callConfig]);
     const handleSuccess = useCallback(async (...params) => {
-        if (invalidateQueries) {
-            // Skip undefined entries. React Query reads `{ queryKey: undefined }`
-            // as "match everything", so a single undefined — which the natural
-            // `invalidateQueries: [maybeQuery?.getQueryKey()]` idiom produces
-            // whenever the optional query object is absent — would invalidate every
-            // query in the client, including an app's unrelated non-canister ones.
-            // `createMutation.invalidateAll` already filters the same way.
-            await Promise.all(invalidateQueries
-                .filter((queryKey) => queryKey !== undefined)
-                .map((queryKey) => reactor.queryClient.invalidateQueries({ queryKey })));
-        }
+        // Undefined entries are skipped: React Query reads
+        // `{ queryKey: undefined }` as "match everything", and the natural
+        // `[maybeQuery]` idiom produces one whenever the query is absent.
+        await invalidateTargets(reactor, invalidateQueries, callConfig);
         await onSuccess?.(...params);
-    }, [reactor, invalidateQueries, onSuccess]);
+    }, [reactor, invalidateQueries, onSuccess, callConfig]);
     const handleError = useCallback(async (error, variables, context, mutation) => {
         if (isCanisterError(error)) {
             onCanisterError?.(error, variables);
@@ -60,6 +55,12 @@ export const useActorMutation = ({ reactor, functionName, invalidateQueries, onS
     // A fresh object per render costs nothing here: `setOptions` diffs the values
     // rather than the reference.
     return useMutation({
+        // Keyed like `createMutation`'s hook and `useActorMethod`'s mutations,
+        // so `useIsMutating({ mutationKey })`, `useMutationState` and defaults
+        // registered with `setMutationDefaults` can find this one too. An
+        // explicit `mutationKey` in the options still wins.
+        mutationKey: reactor.getQueryOptions({ functionName, callConfig })
+            .queryKey,
         ...options,
         mutationFn,
         onSuccess: handleSuccess,

package/dist/hooks/useActorMutation.js.map

@@ -1 +1 @@
-{"version":3,"file":"useActorMutation.js","sourceRoot":"","sources":["../../src/hooks/useActorMutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACnC,OAAO,EACL,WAAW,GAIZ,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAOL,eAAe,GAKhB,MAAM,kBAAkB,CAAA;AAkEzB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAK9B,EACA,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,eAAe,EACf,UAAU,EACV,GAAG,OAAO,EAMX,EAAuE,EAAE;IACxE,MAAM,UAAU,GAAG,WAAW,CAC5B,KAAK,EAAE,IAA6C,EAAE,EAAE,CACtD,OAAO,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EACxD,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,CACpC,CAAA;IAED,MAAM,aAAa,GAAG,WAAW,CAC/B,KAAK,EACH,GAAG,MASF,EACD,EAAE;QACF,IAAI,iBAAiB,EAAE,CAAC;YACtB,sEAAsE;YACtE,mEAAmE;YACnE,kEAAkE;YAClE,wEAAwE;YACxE,uEAAuE;YACvE,+DAA+D;YAC/D,MAAM,OAAO,CAAC,GAAG,CACf,iBAAiB;iBACd,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,CAAC;iBAC5C,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAChB,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,CACpD,CACJ,CAAA;QACH,CAAC;QACD,MAAM,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,CAAA;IAC9B,CAAC,EACD,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,CAAC,CACxC,CAAA;IAED,MAAM,WAAW,GAAG,WAAW,CAC7B,KAAK,EACH,KAAmD,EACnD,SAAkD,EAClD,OAAgB,EAChB,QAAiB,EACjB,EAAE;QACF,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,eAAe,EAAE,CAAC,KAAY,EAAE,SAAS,CAAC,CAAA;QAC5C,CAAC;QACD,uEAAuE;QACvE,yEAAyE;QACzE,+DAA+D;QAC/D,MAAM,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAc,EAAE,QAAe,CAAC,CAAA;IACpE,CAAC,EACD,CAAC,eAAe,EAAE,OAAO,CAAC,CAC3B,CAAA;IAED,6EAA6E;IAC7E,2EAA2E;IAC3E,+EAA+E;IAC/E,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,+BAA+B;IAC/B,EAAE;IACF,6EAA6E;IAC7E,8EAA8E;IAC9E,6BAA6B;IAC7B,OAAO,WAAW,CAChB;QACE,GAAG,OAAO;QACV,UAAU;QACV,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,WAAW;KACrB,EACD,OAAO,CAAC,WAAW,CACpB,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"useActorMutation.js","sourceRoot":"","sources":["../../src/hooks/useActorMutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACnC,OAAO,EACL,WAAW,GAGZ,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAOL,eAAe,GAKhB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAoEpE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAK9B,EACA,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,eAAe,EACf,UAAU,EACV,GAAG,OAAO,EAMX,EAAuE,EAAE;IACxE,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IAExC,MAAM,UAAU,GAAG,WAAW,CAC5B,KAAK,EAAE,IAA6C,EAAE,EAAE,CACtD,OAAO,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EACxD,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,CACpC,CAAA;IAED,MAAM,aAAa,GAAG,WAAW,CAC/B,KAAK,EACH,GAAG,MASF,EACD,EAAE;QACF,mDAAmD;QACnD,mEAAmE;QACnE,kEAAkE;QAClE,MAAM,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAA;QAC/D,MAAM,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,CAAA;IAC9B,CAAC,EACD,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,UAAU,CAAC,CACpD,CAAA;IAED,MAAM,WAAW,GAAG,WAAW,CAC7B,KAAK,EACH,KAAmD,EACnD,SAAkD,EAClD,OAAgB,EAChB,QAAiB,EACjB,EAAE;QACF,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,eAAe,EAAE,CAAC,KAAY,EAAE,SAAS,CAAC,CAAA;QAC5C,CAAC;QACD,uEAAuE;QACvE,yEAAyE;QACzE,+DAA+D;QAC/D,MAAM,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAc,EAAE,QAAe,CAAC,CAAA;IACpE,CAAC,EACD,CAAC,eAAe,EAAE,OAAO,CAAC,CAC3B,CAAA;IAED,6EAA6E;IAC7E,2EAA2E;IAC3E,+EAA+E;IAC/E,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,+BAA+B;IAC/B,EAAE;IACF,6EAA6E;IAC7E,8EAA8E;IAC9E,6BAA6B;IAC7B,OAAO,WAAW,CAChB;QACE,uEAAuE;QACvE,uEAAuE;QACvE,kEAAkE;QAClE,oDAAoD;QACpD,WAAW,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;aAC/D,QAAQ;QACX,GAAG,OAAO;QACV,UAAU;QACV,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,WAAW;KACrB,EACD,OAAO,CAAC,WAAW,CACpB,CAAA;AACH,CAAC,CAAA"}

package/dist/hooks/useActorQuery.d.ts

@@ -1,10 +1,16 @@
-import { QueryKey, QueryObserverOptions, UseQueryResult } from "@tanstack/react-query";
+import { QueryKey, QueryObserverOptions, UseQueryResult, type SkipToken } from "@tanstack/react-query";
 import { FunctionName, Reactor, TransformKey, ReactorArgs, ReactorReturnOk, ReactorQueryData, ReactorReturnErr } from "@ic-reactor/core";
 import { CallConfig } from "@icp-sdk/core/agent";
 export interface UseActorQueryParameters<Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", Selected = ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>> extends Omit<QueryObserverOptions<ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, ReactorReturnErr<Service, Method, Transform>, Selected, ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, QueryKey>, "queryKey" | "queryFn"> {
     reactor: Reactor<Service, Transform>;
     functionName: Method;
-    args?: ReactorArgs<Service, Method, Transform>;
+    /**
+     * The method's arguments, or TanStack Query's `skipToken` while they are
+     * not known: the query then waits without fetching, in an entry of its own
+     * under its method's key, which no call's key shares, so it shows no data
+     * until the arguments arrive.
+     */
+    args?: ReactorArgs<Service, Method, Transform> | SkipToken;
     callConfig?: CallConfig;
     queryKey?: QueryKey;
 }
@@ -14,19 +20,26 @@ export type UseActorQueryResult<Service, Method extends FunctionName<Service>, T
  * Hook for executing query calls on a canister.
  *
  * @example
- * const { data, isLoading } = useActorQuery({
+ * const { data, isLoading } = useReactorQuery({
  *   reactor,
  *   functionName: "getUser",
  *   args: ["user-123"],
  * })
  *
  * // With select transformation
- * const { data } = useActorQuery({
+ * const { data } = useReactorQuery({
  *   reactor,
  *   functionName: "getUser",
  *   args: ["user-123"],
  *   select: (user) => user.name,
  * })
+ *
+ * // Wait for the args: no fetch until userId is known
+ * const { data } = useReactorQuery({
+ *   reactor,
+ *   functionName: "getUser",
+ *   args: userId ? [userId] : skipToken,
+ * })
  */
 export declare const useActorQuery: <Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", Selected = ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>>({ reactor, functionName, args, callConfig, queryKey: defaultQueryKey, ...options }: UseActorQueryParameters<Service, Method, Transform, Selected>) => UseActorQueryResult<Service, Method, Transform, Selected>;
 //# sourceMappingURL=useActorQuery.d.ts.map

package/dist/hooks/useActorQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useActorQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/useActorQuery.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EAER,oBAAoB,EACpB,cAAc,EACf,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,MAAM,WAAW,uBAAuB,CACtC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CACxE,SAAQ,IAAI,CACZ,oBAAoB,CAClB,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAC7D,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC5C,QAAQ,EACR,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAC7D,QAAQ,CACT,EACD,UAAU,GAAG,SAAS,CACvB;IACC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;IAC9C,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,MAAM,mBAAmB,CAC7B,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,IACtE,IAAI,CACN,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EAC7D,SAAS,CACV,CAAA;AAED,MAAM,MAAM,mBAAmB,CAC7B,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,IACtE,cAAc,CAAC,QAAQ,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;AAE1E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EACxE,oFAOC,uBAAuB,CACxB,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,CACT,KAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CA+B3D,CAAA"}
+{"version":3,"file":"useActorQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/useActorQuery.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EAGR,oBAAoB,EACpB,cAAc,EACd,KAAK,SAAS,EACf,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAGhD,MAAM,WAAW,uBAAuB,CACtC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CACxE,SAAQ,IAAI,CACZ,oBAAoB,CAClB,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAC7D,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC5C,QAAQ,EACR,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAC7D,QAAQ,CACT,EACD,UAAU,GAAG,SAAS,CACvB;IACC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAAA;IAC1D,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,MAAM,mBAAmB,CAC7B,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,IACtE,IAAI,CACN,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EAC7D,SAAS,CACV,CAAA;AAED,MAAM,MAAM,mBAAmB,CAC7B,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,IACtE,cAAc,CAAC,QAAQ,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EACxE,oFAOC,uBAAuB,CACxB,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,CACT,KAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAgD3D,CAAA"}

package/dist/hooks/useActorQuery.js

@@ -1,31 +1,51 @@
 import { useMemo } from "react";
-import { useQuery, } from "@tanstack/react-query";
+import { useQuery, skipToken, } from "@tanstack/react-query";
+import { retryOption, skippedQueryKey, useMountQueryClient } from "../utils.js";
 /**
  * Hook for executing query calls on a canister.
  *
  * @example
- * const { data, isLoading } = useActorQuery({
+ * const { data, isLoading } = useReactorQuery({
  *   reactor,
  *   functionName: "getUser",
  *   args: ["user-123"],
  * })
  *
  * // With select transformation
- * const { data } = useActorQuery({
+ * const { data } = useReactorQuery({
  *   reactor,
  *   functionName: "getUser",
  *   args: ["user-123"],
  *   select: (user) => user.name,
  * })
+ *
+ * // Wait for the args: no fetch until userId is known
+ * const { data } = useReactorQuery({
+ *   reactor,
+ *   functionName: "getUser",
+ *   args: userId ? [userId] : skipToken,
+ * })
  */
 export const useActorQuery = ({ reactor, functionName, args, callConfig, queryKey: defaultQueryKey, ...options }) => {
+    useMountQueryClient(reactor.queryClient);
     // Memoize query options to prevent unnecessary re-computations
-    const { queryKey, queryFn } = useMemo(() => reactor.getQueryOptions({
-        callConfig,
-        functionName,
-        args,
-        queryKey: defaultQueryKey,
-    }), 
+    // For an update method, the options also carry its default `retry`; see
+    // `Reactor.getQueryRetry`.
+    const { queryKey, queryFn, retry } = useMemo(() => args === skipToken
+        ? // Waiting for its args: an entry of its own under the method's key,
+            // with nothing to run until then; see skippedQueryKey.
+            {
+                queryKey: skippedQueryKey(reactor.generateQueryKey({ functionName }, callConfig), "query"),
+                // Kept as the unique symbol, which an object literal widens.
+                queryFn: skipToken,
+                retry: undefined,
+            }
+        : reactor.getQueryOptions({
+            callConfig,
+            functionName,
+            args,
+            queryKey: defaultQueryKey,
+        }), 
     // `canisterId` is mutable reactor state that `setCanisterId` can change,
     // while `reactor` itself stays the same object — so it has to be a
     // dependency in its own right or the key stays pinned to the old canister.
@@ -41,6 +61,7 @@ export const useActorQuery = ({ reactor, functionName, args, callConfig, queryKe
         queryFn,
         ...options,
         queryKey,
+        ...retryOption(options.retry, retry),
     }, reactor.queryClient);
 };
 //# sourceMappingURL=useActorQuery.js.map