@ic-reactor/react 2.0.1 → 3.0.0-beta.2

package/dist/hooks/useActorMutation.js

@@ -0,0 +1,39 @@
+import { useMemo, useCallback } from "react";
+import { useMutation, } from "@tanstack/react-query";
+/**
+ * Hook for executing mutation calls on a canister.
+ *
+ * @example
+ * const { mutate, isPending } = useActorMutation({
+ *   reactor,
+ *   functionName: "transfer",
+ *   onSuccess: () => console.log("Success!"),
+ * })
+ */
+export const useActorMutation = ({ reactor, functionName, refetchQueries, onSuccess, callConfig, ...options }) => {
+    // Memoize mutationFn to avoid creating new function on every render
+    const mutationFn = useCallback(async (args) => {
+        return reactor.callMethod({
+            functionName,
+            callConfig,
+            args,
+        });
+    }, [reactor, functionName, callConfig]);
+    // Memoize onSuccess handler
+    const handleSuccess = useCallback(async (...params) => {
+        if (refetchQueries) {
+            await Promise.all(refetchQueries.map((queryKey) => reactor.queryClient.refetchQueries({ queryKey })));
+        }
+        if (onSuccess) {
+            await onSuccess(...params);
+        }
+    }, [reactor, refetchQueries, onSuccess]);
+    // Memoize mutation options
+    const mutationOptions = useMemo(() => ({
+        ...options,
+        mutationFn,
+        onSuccess: handleSuccess,
+    }), [options, mutationFn, handleSuccess]);
+    return useMutation(mutationOptions, reactor.queryClient);
+};
+//# sourceMappingURL=useActorMutation.js.map

package/dist/hooks/useActorMutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActorMutation.js","sourceRoot":"","sources":["../../src/hooks/useActorMutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAC5C,OAAO,EACL,WAAW,GAIZ,MAAM,uBAAuB,CAAA;AA6C9B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAI9B,EACA,OAAO,EACP,YAAY,EACZ,cAAc,EACd,SAAS,EACT,UAAU,EACV,GAAG,OAAO,EAC0B,EAAmC,EAAE;IACzE,oEAAoE;IACpE,MAAM,UAAU,GAAG,WAAW,CAC5B,KAAK,EAAE,IAA0B,EAAE,EAAE;QACnC,OAAO,OAAO,CAAC,UAAU,CAAC;YACxB,YAAY;YACZ,UAAU;YACV,IAAI;SACL,CAAC,CAAA;IACJ,CAAC,EACD,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,CACpC,CAAA;IAED,4BAA4B;IAC5B,MAAM,aAAa,GAAG,WAAW,CAC/B,KAAK,EACH,GAAG,MAQF,EACD,EAAE;QACF,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,OAAO,CAAC,GAAG,CACf,cAAc,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC9B,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC,CACjD,CACF,CAAA;QACH,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,SAAS,CAAC,GAAG,MAAM,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC,EACD,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,CACrC,CAAA;IAED,2BAA2B;IAC3B,MAAM,eAAe,GAAG,OAAO,CAC7B,GAAG,EAAE,CAAC,CAAC;QACL,GAAG,OAAO;QACV,UAAU;QACV,SAAS,EAAE,aAAa;KACzB,CAAC,EACF,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,CACrC,CAAA;IAED,OAAO,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;AAC1D,CAAC,CAAA"}

package/dist/hooks/useActorQuery.d.ts

@@ -0,0 +1,32 @@
+import { QueryKey, QueryObserverOptions, UseQueryResult } from "@tanstack/react-query";
+import { FunctionName, Reactor, TransformKey, ReactorArgs, ReactorReturnOk, ReactorReturnErr } from "@ic-reactor/core";
+import { CallConfig } from "@icp-sdk/core/agent";
+export interface UseActorQueryParameters<A, M extends FunctionName<A>, T extends TransformKey = "candid", TSelected = ReactorReturnOk<A, M, T>> extends Omit<QueryObserverOptions<ReactorReturnOk<A, M, T>, ReactorReturnErr<A, M, T>, TSelected, ReactorReturnOk<A, M, T>, QueryKey>, "queryKey" | "queryFn"> {
+    reactor: Reactor<A, T>;
+    functionName: M;
+    args?: ReactorArgs<A, M, T>;
+    callConfig?: CallConfig;
+    queryKey?: QueryKey;
+}
+export type UseActorQueryConfig<A, M extends FunctionName<A>, T extends TransformKey = "candid", TSelected = ReactorReturnOk<A, M, T>> = Omit<UseActorQueryParameters<A, M, T, TSelected>, "reactor">;
+export type UseActorQueryResult<A, M extends FunctionName<A>, T extends TransformKey = "candid", TSelected = ReactorReturnOk<A, M, T>> = UseQueryResult<TSelected, ReactorReturnErr<A, M, T>>;
+/**
+ * Hook for executing query calls on a canister.
+ *
+ * @example
+ * const { data, isLoading } = useActorQuery({
+ *   reactor,
+ *   functionName: "getUser",
+ *   args: ["user-123"],
+ * })
+ *
+ * // With select transformation
+ * const { data } = useActorQuery({
+ *   reactor,
+ *   functionName: "getUser",
+ *   args: ["user-123"],
+ *   select: (user) => user.name,
+ * })
+ */
+export declare const useActorQuery: <A, M extends FunctionName<A>, T extends TransformKey = "candid", TSelected = ReactorReturnOk<A, M, T>>({ reactor, functionName, args, callConfig, queryKey: defaultQueryKey, ...options }: UseActorQueryParameters<A, M, T, TSelected>) => UseActorQueryResult<A, M, T, TSelected>;
+//# sourceMappingURL=useActorQuery.d.ts.map

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

@@ -0,0 +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,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,MAAM,WAAW,uBAAuB,CACtC,CAAC,EACD,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACzB,CAAC,SAAS,YAAY,GAAG,QAAQ,EACjC,SAAS,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CACpC,SAAQ,IAAI,CACZ,oBAAoB,CAClB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACxB,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACzB,SAAS,EACT,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACxB,QAAQ,CACT,EACD,UAAU,GAAG,SAAS,CACvB;IACC,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACtB,YAAY,EAAE,CAAC,CAAA;IACf,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,MAAM,mBAAmB,CAC7B,CAAC,EACD,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACzB,CAAC,SAAS,YAAY,GAAG,QAAQ,EACjC,SAAS,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAClC,IAAI,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAA;AAEhE,MAAM,MAAM,mBAAmB,CAC7B,CAAC,EACD,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACzB,CAAC,SAAS,YAAY,GAAG,QAAQ,EACjC,SAAS,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAClC,cAAc,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAExD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,GACxB,CAAC,EACD,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACzB,CAAC,SAAS,YAAY,GAAG,QAAQ,EACjC,SAAS,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACpC,oFAOC,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,KAAG,mBAAmB,CAClE,CAAC,EACD,CAAC,EACD,CAAC,EACD,SAAS,CAsBV,CAAA"}

package/dist/hooks/useActorQuery.js

@@ -0,0 +1,35 @@
+import { useMemo } from "react";
+import { useQuery, } from "@tanstack/react-query";
+/**
+ * Hook for executing query calls on a canister.
+ *
+ * @example
+ * const { data, isLoading } = useActorQuery({
+ *   reactor,
+ *   functionName: "getUser",
+ *   args: ["user-123"],
+ * })
+ *
+ * // With select transformation
+ * const { data } = useActorQuery({
+ *   reactor,
+ *   functionName: "getUser",
+ *   args: ["user-123"],
+ *   select: (user) => user.name,
+ * })
+ */
+export const useActorQuery = ({ reactor, functionName, args, callConfig, queryKey: defaultQueryKey, ...options }) => {
+    // Memoize query options to prevent unnecessary re-computations
+    const { queryKey, queryFn } = useMemo(() => reactor.getQueryOptions({
+        callConfig,
+        functionName,
+        args,
+        queryKey: defaultQueryKey,
+    }), [reactor, callConfig, functionName, args, defaultQueryKey]);
+    return useQuery({
+        queryFn,
+        ...options,
+        queryKey,
+    }, reactor.queryClient);
+};
+//# sourceMappingURL=useActorQuery.js.map

package/dist/hooks/useActorQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActorQuery.js","sourceRoot":"","sources":["../../src/hooks/useActorQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAEL,QAAQ,GAGT,MAAM,uBAAuB,CAAA;AA+C9B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAK3B,EACA,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,QAAQ,EAAE,eAAe,EACzB,GAAG,OAAO,EACkC,EAK5C,EAAE;IACF,+DAA+D;IAC/D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CACnC,GAAG,EAAE,CACH,OAAO,CAAC,eAAe,CAAI;QACzB,UAAU;QACV,YAAY;QACZ,IAAI;QACJ,QAAQ,EAAE,eAAe;KAC1B,CAAC,EACJ,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,CAAC,CAC3D,CAAA;IAED,OAAO,QAAQ,CACb;QACE,OAAO;QACP,GAAG,OAAO;QACV,QAAQ;KACT,EACD,OAAO,CAAC,WAAW,CACpB,CAAA;AACH,CAAC,CAAA"}

package/dist/hooks/useActorSuspenseInfiniteQuery.d.ts

@@ -0,0 +1,36 @@
+import { QueryKey, UseSuspenseInfiniteQueryResult, InfiniteData } from "@tanstack/react-query";
+import { FunctionName, Reactor, TransformKey, ReactorArgs, ReactorReturnOk, ReactorReturnErr } from "@ic-reactor/core";
+import { CallConfig } from "@icp-sdk/core/agent";
+export interface UseActorSuspenseInfiniteQueryParameters<A, M extends FunctionName<A>, T extends TransformKey = "candid", TPageParam = unknown> {
+    reactor: Reactor<A, T>;
+    functionName: M;
+    getArgs: (pageParam: TPageParam) => ReactorArgs<A, M, T>;
+    callConfig?: CallConfig;
+    queryKey?: QueryKey;
+    initialPageParam: TPageParam;
+    getNextPageParam: (lastPage: ReactorReturnOk<A, M, T>, allPages: ReactorReturnOk<A, M, T>[], lastPageParam: TPageParam, allPageParams: TPageParam[]) => TPageParam | undefined | null;
+    getPreviousPageParam?: (firstPage: ReactorReturnOk<A, M, T>, allPages: ReactorReturnOk<A, M, T>[], firstPageParam: TPageParam, allPageParams: TPageParam[]) => TPageParam | undefined | null;
+    maxPages?: number;
+    staleTime?: number;
+    gcTime?: number;
+    refetchOnWindowFocus?: boolean;
+    refetchOnMount?: boolean;
+    refetchOnReconnect?: boolean;
+    select?: (data: InfiniteData<ReactorReturnOk<A, M, T>, TPageParam>) => InfiniteData<ReactorReturnOk<A, M, T>, TPageParam>;
+}
+export type UseActorSuspenseInfiniteQueryConfig<A, M extends FunctionName<A>, T extends TransformKey = "candid", TPageParam = unknown> = Omit<UseActorSuspenseInfiniteQueryParameters<A, M, T, TPageParam>, "reactor">;
+export type UseActorSuspenseInfiniteQueryResult<A, M extends FunctionName<A>, T extends TransformKey = "candid", TPageParam = unknown> = UseSuspenseInfiniteQueryResult<InfiniteData<ReactorReturnOk<A, M, T>, TPageParam>, ReactorReturnErr<A, M, T>>;
+/**
+ * Hook for executing suspense-enabled infinite/paginated query calls on a canister.
+ *
+ * @example
+ * const { data, fetchNextPage, hasNextPage } = useActorSuspenseInfiniteQuery({
+ *   reactor,
+ *   functionName: "getItems",
+ *   getArgs: (pageParam) => [{ offset: pageParam, limit: 10 }],
+ *   initialPageParam: 0,
+ *   getNextPageParam: (lastPage) => lastPage.nextOffset,
+ * })
+ */
+export declare const useActorSuspenseInfiniteQuery: <A, M extends FunctionName<A>, T extends TransformKey = "candid", TPageParam = unknown>({ reactor, functionName, getArgs, callConfig, queryKey, ...options }: UseActorSuspenseInfiniteQueryParameters<A, M, T, TPageParam>) => UseActorSuspenseInfiniteQueryResult<A, M, T, TPageParam>;
+//# sourceMappingURL=useActorSuspenseInfiniteQuery.d.ts.map

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

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

package/dist/hooks/useActorSuspenseInfiniteQuery.js

@@ -0,0 +1,33 @@
+import { useMemo, useCallback } from "react";
+import { useSuspenseInfiniteQuery, } from "@tanstack/react-query";
+/**
+ * Hook for executing suspense-enabled infinite/paginated query calls on a canister.
+ *
+ * @example
+ * const { data, fetchNextPage, hasNextPage } = useActorSuspenseInfiniteQuery({
+ *   reactor,
+ *   functionName: "getItems",
+ *   getArgs: (pageParam) => [{ offset: pageParam, limit: 10 }],
+ *   initialPageParam: 0,
+ *   getNextPageParam: (lastPage) => lastPage.nextOffset,
+ * })
+ */
+export const useActorSuspenseInfiniteQuery = ({ reactor, functionName, getArgs, callConfig, queryKey, ...options }) => {
+    // Memoize queryKey to prevent unnecessary re-calculations
+    const baseQueryKey = useMemo(() => queryKey ?? reactor.generateQueryKey({ functionName }), [queryKey, reactor, functionName]);
+    // Memoize queryFn to prevent recreation on every render
+    const queryFn = useCallback(async ({ pageParam }) => {
+        const args = getArgs(pageParam);
+        return reactor.callMethod({
+            functionName,
+            args,
+            callConfig,
+        });
+    }, [reactor, functionName, getArgs, callConfig]);
+    return useSuspenseInfiniteQuery({
+        queryKey: baseQueryKey,
+        queryFn,
+        ...options,
+    }, reactor.queryClient);
+};
+//# sourceMappingURL=useActorSuspenseInfiniteQuery.js.map

package/dist/hooks/useActorSuspenseInfiniteQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActorSuspenseInfiniteQuery.js","sourceRoot":"","sources":["../../src/hooks/useActorSuspenseInfiniteQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAC5C,OAAO,EAEL,wBAAwB,GAGzB,MAAM,uBAAuB,CAAA;AAkE9B;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAK3C,EACA,OAAO,EACP,YAAY,EACZ,OAAO,EACP,UAAU,EACV,QAAQ,EACR,GAAG,OAAO,EAMX,EAA4D,EAAE;IAC7D,0DAA0D;IAC1D,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC,EAC5D,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,CAClC,CAAA;IAED,wDAAwD;IACxD,MAAM,OAAO,GAAG,WAAW,CACzB,KAAK,EAAE,EAAE,SAAS,EAA6B,EAAE,EAAE;QACjD,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;QAC/B,OAAO,OAAO,CAAC,UAAU,CAAC;YACxB,YAAY;YACZ,IAAI;YACJ,UAAU;SACX,CAAC,CAAA;IACJ,CAAC,EACD,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC,CAC7C,CAAA;IAED,OAAO,wBAAwB,CAC7B;QACE,QAAQ,EAAE,YAAY;QACtB,OAAO;QACP,GAAG,OAAO;KACJ,EACR,OAAO,CAAC,WAAW,CACwC,CAAA;AAC/D,CAAC,CAAA"}

package/dist/hooks/useActorSuspenseQuery.d.ts

@@ -0,0 +1,32 @@
+import { QueryKey, QueryObserverOptions, UseSuspenseQueryResult } from "@tanstack/react-query";
+import { FunctionName, Reactor, TransformKey, ReactorArgs, ReactorReturnOk, ReactorReturnErr } from "@ic-reactor/core";
+import { CallConfig } from "@icp-sdk/core/agent";
+export interface UseActorSuspenseQueryParameters<A, M extends FunctionName<A>, T extends TransformKey = "candid", TSelected = ReactorReturnOk<A, M, T>> extends Omit<QueryObserverOptions<ReactorReturnOk<A, M, T>, ReactorReturnErr<A, M, T>, TSelected, ReactorReturnOk<A, M, T>, QueryKey>, "queryKey" | "queryFn"> {
+    reactor: Reactor<A, T>;
+    functionName: M;
+    args?: ReactorArgs<A, M, T>;
+    callConfig?: CallConfig;
+    queryKey?: QueryKey;
+}
+export type UseActorSuspenseQueryConfig<A, M extends FunctionName<A>, T extends TransformKey = "candid", TSelected = ReactorReturnOk<A, M, T>> = Omit<UseActorSuspenseQueryParameters<A, M, T, TSelected>, "reactor">;
+export type UseActorSuspenseQueryResult<A, M extends FunctionName<A>, T extends TransformKey = "candid", TSelected = ReactorReturnOk<A, M, T>> = UseSuspenseQueryResult<TSelected, ReactorReturnErr<A, M, T>>;
+/**
+ * Hook for executing suspense-enabled query calls on a canister.
+ *
+ * @example
+ * const { data } = useActorSuspenseQuery({
+ *   reactor,
+ *   functionName: "getUser",
+ *   args: ["user-123"],
+ * })
+ *
+ * // With select transformation
+ * const { data } = useActorSuspenseQuery({
+ *   reactor,
+ *   functionName: "getUser",
+ *   args: ["user-123"],
+ *   select: (user) => user.name,
+ * })
+ */
+export declare const useActorSuspenseQuery: <A, M extends FunctionName<A>, T extends TransformKey = "candid", TSelected = ReactorReturnOk<A, M, T>>({ reactor, functionName, args, callConfig, queryKey: defaultQueryKey, ...options }: UseActorSuspenseQueryParameters<A, M, T, TSelected>) => UseActorSuspenseQueryResult<A, M, T, TSelected>;
+//# sourceMappingURL=useActorSuspenseQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useActorSuspenseQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/useActorSuspenseQuery.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EAER,oBAAoB,EACpB,sBAAsB,EAEvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,MAAM,WAAW,+BAA+B,CAC9C,CAAC,EACD,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACzB,CAAC,SAAS,YAAY,GAAG,QAAQ,EACjC,SAAS,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CACpC,SAAQ,IAAI,CACZ,oBAAoB,CAClB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACxB,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACzB,SAAS,EACT,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACxB,QAAQ,CACT,EACD,UAAU,GAAG,SAAS,CACvB;IACC,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACtB,YAAY,EAAE,CAAC,CAAA;IACf,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,MAAM,2BAA2B,CACrC,CAAC,EACD,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACzB,CAAC,SAAS,YAAY,GAAG,QAAQ,EACjC,SAAS,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAClC,IAAI,CAAC,+BAA+B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAA;AAExE,MAAM,MAAM,2BAA2B,CACrC,CAAC,EACD,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACzB,CAAC,SAAS,YAAY,GAAG,QAAQ,EACjC,SAAS,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAClC,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAEhE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,GAChC,CAAC,EACD,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACzB,CAAC,SAAS,YAAY,GAAG,QAAQ,EACjC,SAAS,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACpC,oFAOC,+BAA+B,CAChC,CAAC,EACD,CAAC,EACD,CAAC,EACD,SAAS,CACV,KAAG,2BAA2B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,CAsBjD,CAAA"}

package/dist/hooks/useActorSuspenseQuery.js

@@ -0,0 +1,36 @@
+import { useMemo } from "react";
+import { useSuspenseQuery, } from "@tanstack/react-query";
+/**
+ * Hook for executing suspense-enabled query calls on a canister.
+ *
+ * @example
+ * const { data } = useActorSuspenseQuery({
+ *   reactor,
+ *   functionName: "getUser",
+ *   args: ["user-123"],
+ * })
+ *
+ * // With select transformation
+ * const { data } = useActorSuspenseQuery({
+ *   reactor,
+ *   functionName: "getUser",
+ *   args: ["user-123"],
+ *   select: (user) => user.name,
+ * })
+ */
+export const useActorSuspenseQuery = ({ reactor, functionName, args, callConfig, queryKey: defaultQueryKey, ...options }) => {
+    // Memoize query options to prevent unnecessary re-computations
+    const { queryKey, queryFn } = useMemo(() => reactor.getQueryOptions({
+        callConfig,
+        functionName,
+        args,
+        queryKey: defaultQueryKey,
+    }), [reactor, callConfig, functionName, args, defaultQueryKey]);
+    return useSuspenseQuery({
+        // Suspense queries don't support skipToken, so cast the queryFn
+        queryFn: queryFn,
+        ...options,
+        queryKey,
+    }, reactor.queryClient);
+};
+//# sourceMappingURL=useActorSuspenseQuery.js.map

package/dist/hooks/useActorSuspenseQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActorSuspenseQuery.js","sourceRoot":"","sources":["../../src/hooks/useActorSuspenseQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAEL,gBAAgB,GAIjB,MAAM,uBAAuB,CAAA;AA+C9B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAKnC,EACA,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,QAAQ,EAAE,eAAe,EACzB,GAAG,OAAO,EAMX,EAAmD,EAAE;IACpD,+DAA+D;IAC/D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CACnC,GAAG,EAAE,CACH,OAAO,CAAC,eAAe,CAAI;QACzB,UAAU;QACV,YAAY;QACZ,IAAI;QACJ,QAAQ,EAAE,eAAe;KAC1B,CAAC,EACJ,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,CAAC,CAC3D,CAAA;IAED,OAAO,gBAAgB,CACrB;QACE,gEAAgE;QAChE,OAAO,EAAE,OAA4D;QACrE,GAAG,OAAO;QACV,QAAQ;KACT,EACD,OAAO,CAAC,WAAW,CACpB,CAAA;AACH,CAAC,CAAA"}

package/dist/index.d.ts

@@ -1,9 +1,12 @@
-export * from "./createReactor";
-export * from "./context/actor";
-export * from "./context/adapter";
-export * from "./context/agent";
+export * from "@ic-reactor/core";
 export * from "./hooks";
-export * as helpers from "./helpers";
-export * as types from "./types";
-export * as core from "./core";
-export * as utils from "./utils";
+export * from "./validation";
+export * from "./createAuthHooks";
+export * from "./createActorHooks";
+export * from "./createQuery";
+export * from "./createSuspenseQuery";
+export * from "./createInfiniteQuery";
+export * from "./createSuspenseInfiniteQuery";
+export * from "./createMutation";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,kBAAkB,CAAA;AAGhC,cAAc,SAAS,CAAA;AAGvB,cAAc,cAAc,CAAA;AAG5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAElC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,kBAAkB,CAAA;AAEhC,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -1,49 +1,17 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.utils = exports.core = exports.types = exports.helpers = void 0;
-// Note: Order of exports is important
-__exportStar(require("./createReactor"), exports);
-__exportStar(require("./context/actor"), exports);
-__exportStar(require("./context/adapter"), exports);
-__exportStar(require("./context/agent"), exports);
-__exportStar(require("./hooks"), exports);
-exports.helpers = __importStar(require("./helpers"));
-exports.types = __importStar(require("./types"));
-exports.core = __importStar(require("./core"));
-exports.utils = __importStar(require("./utils"));
+// Re-export core (following TanStack Query's pattern)
+// Users can import everything from @ic-reactor/react without needing @ic-reactor/core
+export * from "@ic-reactor/core";
+// Re-export hooks
+export * from "./hooks";
+// Validation utilities for React
+export * from "./validation";
+// React-specific exports
+export * from "./createAuthHooks";
+export * from "./createActorHooks";
+export * from "./createQuery";
+export * from "./createSuspenseQuery";
+export * from "./createInfiniteQuery";
+export * from "./createSuspenseInfiniteQuery";
+export * from "./createMutation";
+export * from "./types";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,sFAAsF;AACtF,cAAc,kBAAkB,CAAA;AAEhC,kBAAkB;AAClB,cAAc,SAAS,CAAA;AAEvB,iCAAiC;AACjC,cAAc,cAAc,CAAA;AAE5B,yBAAyB;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAElC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,kBAAkB,CAAA;AAEhC,cAAc,SAAS,CAAA"}

package/dist/types.d.ts

@@ -1,13 +1,232 @@
-import type { HttpAgent, CreateReactorCoreParameters, VisitService } from "@ic-reactor/core/dist/types";
-import type { ActorHooksReturnType, AgentHooksReturnType, AuthHooksReturnType } from "./helpers/types";
-export type CreateReactorParameters = CreateReactorCoreParameters;
-export interface CreateReactorReturnType<A> extends ActorHooksReturnType<A>, AuthHooksReturnType, AgentHooksReturnType {
-    getAgent: () => HttpAgent;
-    getVisitFunction: () => VisitService<A>;
-}
-export * from "./context/actor/types";
-export * from "./context/agent/types";
-export * from "./context/adapter/types";
-export * from "./helpers/types";
-export * from "./hooks/types";
-export * from "@ic-reactor/core/dist/types";
+/**
+ * Shared type definitions for query factories (createActorQuery, createActorSuspenseQuery, etc.)
+ */
+import type { FunctionName, ReactorReturnOk, ReactorReturnErr, ReactorArgs, BaseActor, TransformKey, TransformReturnRegistry, ErrResult, ActorMethodReturnType } from "@ic-reactor/core";
+import { CanisterError } from "@ic-reactor/core";
+import { CallConfig } from "@icp-sdk/core/agent";
+import { QueryKey, QueryObserverOptions, UseQueryOptions, UseQueryResult, UseSuspenseQueryOptions, UseSuspenseQueryResult, UseMutationOptions, UseMutationResult } from "@tanstack/react-query";
+export type NoInfer<T> = [T][T extends any ? 0 : never];
+/** The raw data type returned by the query function (before select) */
+export type QueryFnData<A = BaseActor, M extends FunctionName<A> = FunctionName<A>, T extends TransformKey = "candid"> = ReactorReturnOk<A, M, T>;
+/** The error type for queries */
+export type QueryError<A = BaseActor, M extends FunctionName<A> = FunctionName<A>, T extends TransformKey = "candid"> = ReactorReturnErr<A, M, T>;
+/**
+ * Base configuration for query wrappers (shared between regular and suspense).
+ *
+ * @template A - The actor interface type
+ * @template M - The method name on the actor
+ * @template T - The transformation key (identity, display, etc.)
+ * @template TSelected - The type returned after select transformation
+ */
+export interface BaseQueryConfig<A = BaseActor, M extends FunctionName<A> = FunctionName<A>, T extends TransformKey = "candid", TSelected = QueryFnData<A, M, T>> extends Omit<QueryObserverOptions<ReactorReturnOk<A, M, T>, ReactorReturnErr<A, M, T>, TSelected, ReactorReturnOk<A, M, T>, QueryKey>, "queryFn" | "queryKey"> {
+    /** The method to call on the canister */
+    functionName: M;
+    /** Arguments to pass to the method (if any) */
+    args?: ReactorArgs<A, M, T>;
+    /** The query key to use for this query */
+    queryKey?: QueryKey;
+    /** How long data stays fresh before refetching (default: 5 min) */
+    staleTime?: number;
+    /** Transform the raw result before returning */
+    select?: (data: QueryFnData<A, M, T>) => TSelected;
+}
+/**
+ * Configuration for createQuery (regular useQuery).
+ * Alias for BaseQueryConfig for clarity.
+ */
+export type QueryConfig<A = BaseActor, M extends FunctionName<A> = FunctionName<A>, T extends TransformKey = "candid", TSelected = QueryFnData<A, M, T>> = BaseQueryConfig<A, M, T, TSelected>;
+/**
+ * Configuration for createSuspenseQuery (useSuspenseQuery).
+ * Alias for BaseQueryConfig for clarity.
+ */
+export type SuspenseQueryConfig<A = BaseActor, M extends FunctionName<A> = FunctionName<A>, T extends TransformKey = "candid", TSelected = QueryFnData<A, M, T>> = BaseQueryConfig<A, M, T, TSelected>;
+/**
+ * Configuration for createQueryFactory (args are provided at call time).
+ */
+export type QueryFactoryConfig<A = BaseActor, M extends FunctionName<A> = FunctionName<A>, T extends TransformKey = "candid", TSelected = QueryFnData<A, M, T>> = Omit<QueryConfig<A, M, T, TSelected>, "args">;
+/**
+ * Configuration for createSuspenseQueryFactory (args are provided at call time).
+ */
+export type SuspenseQueryFactoryConfig<A = BaseActor, M extends FunctionName<A> = FunctionName<A>, T extends TransformKey = "candid", TSelected = QueryFnData<A, M, T>> = Omit<SuspenseQueryConfig<A, M, T, TSelected>, "args">;
+/**
+ * useQuery hook with chained select support.
+ * - Without select: returns TSelected (from config.select)
+ * - With select: chains on top and returns TFinal
+ *
+ * Accepts all useQuery options from React Query documentation.
+ * Select is special: it chains on top of config.select.
+ */
+export interface UseQueryWithSelect<TQueryFnData, TSelected = TQueryFnData, TError = Error> {
+    (options?: Omit<UseQueryOptions<TQueryFnData, TError, TSelected>, "queryKey" | "queryFn"> & {
+        select?: undefined;
+    }): UseQueryResult<TSelected, TError>;
+    <TFinal = TSelected>(options: Omit<UseQueryOptions<TQueryFnData, TError, TFinal>, "queryKey" | "queryFn" | "select"> & {
+        select: (data: TSelected) => TFinal;
+    }): UseQueryResult<TFinal, TError>;
+}
+/**
+ * useSuspenseQuery hook with chained select support.
+ * - Without select: returns TSelected (from config.select)
+ * - With select: chains on top and returns TFinal
+ *
+ * Accepts all useSuspenseQuery options from React Query documentation.
+ * Select is special: it chains on top of config.select.
+ * Data is always defined (never undefined).
+ * Does NOT support `enabled` option.
+ */
+export interface UseSuspenseQueryWithSelect<TQueryFnData, TSelected = TQueryFnData, TError = Error> {
+    (options?: Omit<UseSuspenseQueryOptions<TQueryFnData, TError, TSelected>, "queryKey" | "queryFn"> & {
+        select?: undefined;
+    }): UseSuspenseQueryResult<TSelected, TError>;
+    <TFinal = TSelected>(options: Omit<UseSuspenseQueryOptions<TQueryFnData, TError, TFinal>, "queryKey" | "queryFn" | "select"> & {
+        select: (data: TSelected) => TFinal;
+    }): UseSuspenseQueryResult<TFinal, TError>;
+}
+/**
+ * Base result interface shared between createQuery and createSuspenseQuery.
+ *
+ * @template TQueryFnData - The raw data type
+ * @template TSelected - The type after select transformation
+ * @template TError - The error type
+ */
+export interface BaseQueryResult<TQueryFnData, TSelected = TQueryFnData, _TError = Error> {
+    /** Fetch data in loader (uses ensureQueryData for cache-first) */
+    fetch: () => Promise<TSelected>;
+    /** Invalidate and refetch cache */
+    refetch: () => Promise<void>;
+    /** Get query key (for advanced React Query usage) */
+    getQueryKey: () => QueryKey;
+    /**
+     * Read data directly from cache without fetching.
+     * Returns undefined if data is not in cache.
+     *
+     * @template TFinal - Type returned after optional select transformation
+     * @param select - Optional select function to transform cached data further
+     * @returns Cached data with select applied, or undefined if not in cache
+     *
+     * @example
+     * // Just get the cached data
+     * const user = userQuery.getCacheData()
+     *
+     * // With additional select transformation
+     * const name = userQuery.getCacheData((user) => user.name)
+     */
+    getCacheData: {
+        (): TSelected | undefined;
+        <TFinal>(select: (data: TSelected) => TFinal): TFinal | undefined;
+    };
+}
+/**
+ * Result from createQuery
+ *
+ * Includes useQuery hook that:
+ * - Supports `enabled` option for conditional fetching
+ * - Data may be `undefined` during loading
+ * - Uses regular `useQuery` with manual loading state handling
+ *
+ * @template TQueryFnData - The raw data type
+ * @template TSelected - The type after select transformation
+ * @template TError - The error type
+ */
+export interface QueryResult<TQueryFnData, TSelected = TQueryFnData, TError = Error> extends BaseQueryResult<TQueryFnData, TSelected, TError> {
+    /** React hook for components - supports chained select and enabled option */
+    useQuery: UseQueryWithSelect<TQueryFnData, TSelected, TError>;
+}
+/**
+ * Result from createSuspenseQuery
+ *
+ * Includes useSuspenseQuery hook that:
+ * - Requires wrapping in <Suspense> boundary
+ * - Data is always defined (no undefined checks)
+ * - Does NOT support `enabled` option
+ *
+ * @template TQueryFnData - The raw data type
+ * @template TSelected - The type after select transformation
+ * @template TError - The error type
+ */
+export interface SuspenseQueryResult<TQueryFnData, TSelected = TQueryFnData, TError = Error> extends BaseQueryResult<TQueryFnData, TSelected, TError> {
+    /** React hook for components - data is always defined (wrap in Suspense) */
+    useSuspenseQuery: UseSuspenseQueryWithSelect<TQueryFnData, TSelected, TError>;
+}
+/**
+ * Configuration for createMutation and useActorMutation.
+ */
+export interface MutationConfig<A = BaseActor, M extends FunctionName<A> = FunctionName<A>, T extends TransformKey = "candid"> extends Omit<UseMutationOptions<ReactorReturnOk<A, M, T>, ReactorReturnErr<A, M, T>, ReactorArgs<A, M, T>>, "mutationFn"> {
+    /** The method to call on the canister */
+    functionName: M;
+    /** Call configuration for the actor method */
+    callConfig?: CallConfig;
+    /** Queries to refetch upon successful mutation */
+    refetchQueries?: QueryKey[];
+    /**
+     * Callback for canister-level business logic errors.
+     * Called when the canister returns a Result { Err: E } variant.
+     *
+     * This is separate from `onError` which handles all errors including
+     * network failures, agent errors, etc.
+     *
+     * @param error - The CanisterError containing the typed error value
+     * @param variables - The arguments passed to the mutation
+     *
+     * @example
+     * ```typescript
+     * createMutation(reactor, {
+     *   functionName: "transfer",
+     *   onCanisterError: (error, variables) => {
+     *     // error.err contains the typed Err value
+     *     // error.code contains the variant key (e.g., "InsufficientFunds")
+     *     console.error(`Transfer failed: ${error.code}`, error.err)
+     *   },
+     * })
+     * ```
+     */
+    onCanisterError?: (error: CanisterError<unknown>, variables: ReactorArgs<A, M, T>) => void;
+}
+/**
+ * Configuration for createMutationFactory.
+ */
+export type MutationFactoryConfig<A = BaseActor, M extends FunctionName<A> = FunctionName<A>, T extends TransformKey = "candid"> = Omit<MutationConfig<A, M, T>, "onSuccess">;
+/**
+ * Options for useMutation hook.
+ * Extends React Query's UseMutationOptions with refetchQueries support.
+ */
+export interface MutationHookOptions<A = BaseActor, M extends FunctionName<A> = FunctionName<A>, T extends TransformKey = "candid"> extends Omit<UseMutationOptions<ReactorReturnOk<A, M, T>, ReactorReturnErr<A, M, T>, ReactorArgs<A, M, T>>, "mutationFn"> {
+    /**
+     * Query keys to refetch upon successful mutation.
+     * Use query.getQueryKey() to get the key from a query result.
+     *
+     * @example
+     * const balanceQuery = getIcpBalance(account)
+     * useMutation({
+     *   refetchQueries: [balanceQuery.getQueryKey()],
+     * })
+     */
+    refetchQueries?: (QueryKey | undefined)[];
+    /**
+     * Callback for canister-level business logic errors.
+     * Called when the canister returns a Result { Err: E } variant.
+     *
+     * @param error - The CanisterError containing the typed error value
+     * @param variables - The arguments passed to the mutation
+     */
+    onCanisterError?: (error: CanisterError<TransformReturnRegistry<ErrResult<ActorMethodReturnType<A[M]>>>[T]>, variables: ReactorArgs<A, M, T>) => void;
+}
+/**
+ * Result from createMutation.
+ */
+export interface MutationResult<A = BaseActor, M extends FunctionName<A> = FunctionName<A>, T extends TransformKey = "candid"> {
+    /**
+     * React hook for the mutation.
+     * Accepts options to override/extend the factory config.
+     *
+     * @example
+     * // With refetchQueries to auto-update balance after transfer
+     * const { mutate } = icpTransferMutation.useMutation({
+     *   refetchQueries: [userBalanceQuery], // Auto-refetch after success!
+     * })
+     */
+    useMutation: (options?: MutationHookOptions<A, M, T>) => UseMutationResult<ReactorReturnOk<A, M, T>, ReactorReturnErr<A, M, T>, ReactorArgs<A, M, T>>;
+    /** Execute the update call directly (outside of React) */
+    execute: (args: ReactorArgs<A, M, T>) => Promise<ReactorReturnOk<A, M, T>>;
+}
+//# sourceMappingURL=types.d.ts.map