@ic-reactor/react 3.13.0 → 4.0.0-beta.2

package/dist/hooks/useActorMethod.d.ts

@@ -1,148 +0,0 @@
-import { type UseQueryResult, type UseMutationResult, type QueryKey, type QueryObserverOptions } from "@tanstack/react-query";
-import { Reactor, BaseActor, FunctionName, TransformKey, ReactorArgs, ReactorReturnOk, ReactorQueryData, ReactorReturnErr, FunctionType } from "@ic-reactor/core";
-import { CallConfig } from "@icp-sdk/core/agent";
-import type { InvalidationTarget } from "../types.js";
-/**
- * Configuration for useActorMethod hook.
- * Extends react-query's QueryObserverOptions with custom reactor params.
- *
- * This is a unified hook that handles both query and mutation methods.
- * Query-specific options (like refetchInterval) only apply to query methods.
- * Mutation-specific options (like invalidateQueries) only apply to mutation methods.
- *
- * `retry`, `retryDelay`, `networkMode` and `meta` decide how a call runs, so
- * they apply to both. An update method's call is a mutation: without a `retry`
- * here it follows the QueryClient's mutation defaults, which retry nothing
- * unless the app set `mutations.retry`, because each attempt runs the update
- * on the canister again. Its query defaults, such as `reactorRetry`, do not
- * apply to it.
- */
-export interface UseActorMethodParameters<Service = BaseActor, Method extends FunctionName<Service> = FunctionName<Service>, Transform extends TransformKey = "candid"> extends Omit<QueryObserverOptions<ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, ReactorReturnErr<Service, Method, Transform>, ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, QueryKey>, "queryKey" | "queryFn"> {
-    /** The reactor instance to use for method calls */
-    reactor: Reactor<Service, Transform>;
-    /** The method name to call on the canister */
-    functionName: Method;
-    /** Arguments to pass to the method (optional for parameterless methods) */
-    args?: ReactorArgs<Service, Method, Transform>;
-    /** Agent call configuration (effectiveCanisterId, etc.) */
-    callConfig?: CallConfig;
-    /** Custom query key (auto-generated if not provided) */
-    queryKey?: QueryKey;
-    /**
-     * Callback when the method call succeeds.
-     * Works for both query and mutation methods.
-     *
-     * A method's `undefined` result arrives as `null`, as in `useActorQuery`,
-     * for query and update methods alike.
-     */
-    onSuccess?: (data: ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>) => void;
-    /**
-     * Callback when the method call fails.
-     * Works for both query and mutation methods.
-     */
-    onError?: (error: ReactorReturnErr<Service, Method, Transform>) => void;
-    /**
-     * Queries to invalidate after a successful mutation.
-     * Only applies to mutation methods (updates).
-     *
-     * 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.
-     *
-     * The invalidation is awaited before `onSuccess` runs, as in
-     * `useActorMutation` and `createMutation`, so `onSuccess` sees the
-     * refetched data, and `call()` resolves once the invalidated queries in use
-     * have refetched.
-     */
-    invalidateQueries?: InvalidationTarget<Service, Transform>[];
-}
-/**
- * Configuration type for bound useActorMethod hook (reactor omitted).
- * For use with createActorHooks.
- */
-export type UseActorMethodConfig<Service = BaseActor, Method extends FunctionName<Service> = FunctionName<Service>, Transform extends TransformKey = "candid"> = Omit<UseActorMethodParameters<Service, Method, Transform>, "reactor">;
-/**
- * Result type for useActorMethod hook.
- * Provides a unified interface for both query and mutation methods.
- */
-export interface UseActorMethodResult<Service = BaseActor, Method extends FunctionName<Service> = FunctionName<Service>, Transform extends TransformKey = "candid"> {
-    /**
-     * The returned data from the method call. A method's `undefined` result is
-     * `null` here, as in `useActorQuery`, so `undefined` means that no call has
-     * settled yet, that the last call failed, or that an update call is
-     * running. A query keeps its earlier data when a refetch fails.
-     */
-    data: ReactorQueryData<ReactorReturnOk<Service, Method, Transform>> | undefined;
-    /** Whether the method is currently executing */
-    isLoading: boolean;
-    /** Alias for isLoading - whether a mutation is pending */
-    isPending: boolean;
-    /** Whether there was an error */
-    isError: boolean;
-    /** Whether the method has successfully completed at least once */
-    isSuccess: boolean;
-    /** The error if one occurred */
-    error: ReactorReturnErr<Service, Method, Transform> | null;
-    /** Whether this is a query method (true) or mutation method (false) */
-    isQuery: boolean;
-    /** The function type (query, update, composite_query) */
-    functionType: FunctionType;
-    /**
-     * Call the method with optional arguments.
-     * For queries: triggers a refetch
-     * For mutations: executes the mutation with the provided args
-     *
-     * For a query method, `call(args)` fetches those args from the canister
-     * even when they are cached, and reports the result to `onSuccess` or
-     * `onError` itself. `call()` refetches the hook's own args, as `refetch()`
-     * does. Either resolves `undefined` when its fetch fails. A sign-in or
-     * sign-out while either is in flight cancels the fetch, which then runs
-     * again for the principal signed in, so the call resolves with that
-     * principal's answer rather than the previous one's; see
-     * `ClientManager.fetchAcrossIdentitySwitch`.
-     */
-    call: (args?: ReactorArgs<Service, Method, Transform>) => Promise<ReactorQueryData<ReactorReturnOk<Service, Method, Transform>> | undefined>;
-    /**
-     * Reset the state (data and error).
-     * For queries: resets this hook's own cache entry to its initial state, so
-     * `data` goes back to `initialData` when one was given and is cleared
-     * otherwise. An enabled hook then refetches. Other args of the same method
-     * are left alone.
-     * For mutations: resets the mutation state
-     */
-    reset: () => void;
-    /**
-     * For queries only: Refetch the query
-     *
-     * Resolves with the answer, or `undefined` when the refetch fails, whose
-     * error the hook reports to `onError`; `data` keeps the last answer. A
-     * sign-in or sign-out while it is in flight makes it refetch for the
-     * principal signed in, and it resolves with that principal's answer, as
-     * `call()` does.
-     */
-    refetch: () => Promise<ReactorQueryData<ReactorReturnOk<Service, Method, Transform>> | undefined>;
-    /** The raw query result (only available for query methods) */
-    queryResult?: UseQueryResult<ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, ReactorReturnErr<Service, Method, Transform>>;
-    /** The raw mutation result (only available for mutation methods) */
-    mutationResult?: UseMutationResult<ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, ReactorReturnErr<Service, Method, Transform>, ReactorArgs<Service, Method, Transform>>;
-}
-/**
- * A unified hook for calling canister methods that automatically handles
- * both query and mutation methods based on the Candid interface.
- */
-export declare function useActorMethod<Service = BaseActor, Method extends FunctionName<Service> = FunctionName<Service>, Transform extends TransformKey = "candid">({ reactor, functionName, args, callConfig, queryKey: customQueryKey, enabled, onSuccess, onError, invalidateQueries, ...queryOptions }: UseActorMethodParameters<Service, Method, Transform>): UseActorMethodResult<Service, Method, Transform>;
-/**
- * Creates a bound useMethod hook for a specific reactor instance.
- *
- * @example
- * ```tsx
- * const { useMethod } = createActorMethodHooks(reactor)
- * ```
- */
-export declare function createActorMethodHooks<Service = BaseActor, Transform extends TransformKey = "candid">(reactor: Reactor<Service, Transform>): {
-    /**
-     * Hook for calling methods on the bound reactor.
-     */
-    useMethod: <Method extends FunctionName<Service>>(config: Omit<UseActorMethodParameters<Service, Method, Transform>, "reactor">) => UseActorMethodResult<Service, Method, Transform>;
-};
-//# sourceMappingURL=useActorMethod.d.ts.map

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

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

package/dist/hooks/useActorMethod.js

@@ -1,394 +0,0 @@
-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.
- */
-export function useActorMethod({ reactor, functionName, args, callConfig, queryKey: customQueryKey, enabled = true, onSuccess, onError, invalidateQueries, ...queryOptions }) {
-    // Determine if this is a query method by checking the IDL
-    const isQuery = useMemo(() => {
-        if (!reactor)
-            throw new Error("Reactor instance is required");
-        return reactor.isQueryMethod(functionName);
-    }, [reactor, functionName]);
-    const functionType = isQuery ? "query" : "update";
-    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
-    // replacing it, matching `useActorQuery`. Used verbatim it would carry no
-    // canister id, so the entry would be invisible to the canister-scoped
-    // invalidation `ClientManager.updateAgent` runs on identity change and would
-    // keep serving the previous principal's data after sign-in or sign-out.
-    const buildQueryKey = useCallback((keyArgs) => reactor.generateQueryKey({ functionName, args: keyArgs, queryKey: customQueryKey }, callConfig), 
-    // `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.
-    [
-        reactor,
-        reactor.canisterId?.toString(),
-        functionName,
-        callConfig,
-        customQueryKey,
-    ]);
-    const queryKey = useMemo(() => buildQueryKey(args), [buildQueryKey, args]);
-    // ============================================================================
-    // Query Implementation
-    // ============================================================================
-    const queryResult = useQuery({
-        queryKey,
-        // Callbacks deliberately do NOT live here: a queryFn runs once per fetch
-        // attempt, so `onError` fired on every retry (four times with the default
-        // QueryClient) and `onSuccess` never fired when data came from the cache
-        // or a deduped sibling. They are dispatched from the settled observer
-        // result below instead.
-        //
-        // TanStack Query fails a query whose queryFn resolves `undefined`, with
-        // "data is undefined", and a successful call can resolve it. A
-        // DisplayReactor decodes an `opt` None to `undefined`, and a `()` query
-        // returns nothing. Every other query path normalizes the value to `null`.
-        queryFn: async () => normalizeQueryData((await reactor.callMethod({
-            functionName,
-            args,
-            callConfig,
-        }))),
-        enabled: isQuery && enabled,
-        ...queryOptions,
-    }, reactor.queryClient);
-    // Dispatch the query callbacks from the settled observer result, once per
-    // distinct outcome. TanStack v5 removed `onSuccess`/`onError` from useQuery
-    // for exactly this reason, so the settle timestamps are what identify a new
-    // result: they also advance for a cache hit on a fresh mount, which is the
-    // case that previously never notified at all.
-    const notifiedSuccessAt = useRef(undefined);
-    const notifiedErrorAt = useRef(undefined);
-    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, isPlaceholderData, isFetched]);
-    useEffect(() => {
-        if (!isQuery)
-            return;
-        if (status === "error" && errorUpdatedAt !== notifiedErrorAt.current) {
-            notifiedErrorAt.current = errorUpdatedAt;
-            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
-        // are queries.
-        mutationFn: async (mutationArgs) => normalizeQueryData((await reactor.callMethod({
-            functionName,
-            args: mutationArgs ?? args,
-            callConfig,
-        }))),
-        // 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);
-        },
-        onError: (error) => {
-            onErrorRef.current?.(error);
-        },
-    }, reactor.queryClient);
-    // ============================================================================
-    // Refetch and Call Functions
-    // ============================================================================
-    // 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) {
-                // Key on the args actually being called. Reusing the hook's
-                // mount-time key would store this result under the previous args'
-                // 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.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();
-                        }
-                    });
-                    onSuccessRef.current?.(result);
-                    return result;
-                }
-                catch (error) {
-                    onErrorRef.current?.(error);
-                    return undefined;
-                }
-            }
-            // Otherwise just refetch
-            return refetchLatest();
-        }
-        else {
-            // For mutations, execute with provided args
-            return mutationResult
-                .mutateAsync(callArgs)
-                .catch(() => undefined);
-        }
-    };
-    // ============================================================================
-    // Reset Function
-    // ============================================================================
-    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
-            // a query that was no longer in the cache. No later invalidation reached
-            // it, including the one an identity switch runs. `resetQueries` notifies
-            // the observer and refetches the entry when the hook is enabled. It is
-            // `exact` because only this hook's entry should reset. A prefix match on
-            // a no-args key would also reset every args variant other hooks render.
-            void reactor.queryClient.resetQueries({ queryKey, exact: true });
-        }
-        else {
-            mutationResult.reset();
-        }
-    };
-    // `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
-    // ============================================================================
-    if (isQuery) {
-        return {
-            data: queryResult.data,
-            isLoading: queryResult.isLoading,
-            isPending: queryResult.isLoading,
-            isError: queryResult.isError,
-            isSuccess: queryResult.isSuccess,
-            error: queryResult.error,
-            isQuery: true,
-            functionType,
-            call,
-            reset,
-            refetch,
-            queryResult,
-        };
-    }
-    else {
-        return {
-            data: mutationResult.data,
-            isLoading: mutationResult.isPending,
-            isPending: mutationResult.isPending,
-            isError: mutationResult.isError,
-            isSuccess: mutationResult.isSuccess,
-            error: mutationResult.error,
-            isQuery: false,
-            functionType,
-            call,
-            reset,
-            refetch,
-            mutationResult,
-        };
-    }
-}
-/**
- * Creates a bound useMethod hook for a specific reactor instance.
- *
- * @example
- * ```tsx
- * const { useMethod } = createActorMethodHooks(reactor)
- * ```
- */
-export function createActorMethodHooks(reactor) {
-    return {
-        /**
-         * Hook for calling methods on the bound reactor.
-         */
-        useMethod: (config) => useActorMethod({ ...config, reactor }),
-    };
-}
-//# sourceMappingURL=useActorMethod.js.map

package/dist/hooks/useActorMethod.js.map

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

package/dist/hooks/useActorMutation.d.ts

@@ -1,51 +0,0 @@
-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, awaited before
-     * `onSuccess` runs.
-     *
-     * 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?: InvalidationTarget<Service, Transform>[];
-    /**
-     * Callback for canister-level business logic errors.
-     * Called when the canister returns a Result { Err: E } variant.
-     * Separate from `onError`, which fires for all errors including network failures.
-     */
-    onCanisterError?: (error: CanisterError<TransformReturnRegistry<ErrResult<ActorMethodReturnType<Service[Method]>>, Service>[Transform]>, variables: ReactorArgs<Service, Method, Transform>) => void;
-}
-export type UseActorMutationConfig<Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", TOnMutateResult = unknown> = Omit<UseActorMutationParameters<Service, Method, Transform, TOnMutateResult>, "reactor">;
-export type UseActorMutationResult<Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", TOnMutateResult = unknown> = UseMutationResult<ReactorReturnOk<Service, Method, Transform>, ReactorReturnErr<Service, Method, Transform>, ReactorArgs<Service, Method, Transform>, TOnMutateResult>;
-/**
- * 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 } = useReactorMutation({
- *   reactor,
- *   functionName: "transfer",
- *   onSuccess: () => console.log("Success!"),
- *   onCanisterError: (err) => console.error("Canister Err:", err.code),
- * })
- *
- * @example
- * const transferMutation = createMutation(reactor, {
- *   functionName: "transfer",
- *   onCanisterError: (err) => console.error(err.code),
- * })
- *
- * // Non-React execution path
- * await transferMutation.execute([{ to: "aaaaa-aa", amount: "100" }])
- */
-export declare const useActorMutation: <Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", TOnMutateResult = unknown>({ reactor, functionName, invalidateQueries, onSuccess, onError, onCanisterError, callConfig, ...options }: UseActorMutationParameters<Service, Method, Transform, TOnMutateResult>) => UseActorMutationResult<Service, Method, Transform, TOnMutateResult>;
-//# sourceMappingURL=useActorMutation.d.ts.map

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

@@ -1 +0,0 @@
-{"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"}