@ic-reactor/react 3.12.5 → 4.0.0-beta.1

package/dist/createSuspenseInfiniteQuery.d.ts

@@ -1,147 +0,0 @@
-/**
- * Suspense Infinite Query Factory - Generic wrapper for React Query suspense-based paginated canister data
- *
- * Creates unified fetch/hook/invalidate functions for any paginated canister method.
- * Works with any Reactor instance.
- *
- * Uses `useSuspenseInfiniteQuery` which:
- * - Requires wrapping in <Suspense> boundary
- * - Data is always defined (no undefined checks)
- * - Does NOT support `enabled` or `placeholderData` options
- *
- * @example
- * const postsQuery = createSuspenseInfiniteQuery(reactor, {
- *   functionName: "get_posts",
- *   initialPageParam: 0,
- *   getArgs: (cursor) => [{ cursor, limit: 10 }],
- *   getNextPageParam: (lastPage) => lastPage.nextCursor,
- * })
- *
- * // In component (wrap in Suspense)
- * const { data, fetchNextPage, hasNextPage } = postsQuery.useSuspenseInfiniteQuery()
- *
- * // Flatten all pages
- * const allPosts = data.pages.flatMap(page => page.posts)
- */
-import type { Reactor, FunctionName, ReactorArgs, BaseActor, TransformKey, ReactorReturnOk, ReactorQueryData, ReactorReturnErr } from "@ic-reactor/core";
-import { QueryKey, InfiniteData, UseSuspenseInfiniteQueryResult, UseSuspenseInfiniteQueryOptions, InfiniteQueryObserverOptions } from "@tanstack/react-query";
-import { CallConfig } from "@icp-sdk/core/agent";
-import { NoInfer } from "./types.js";
-type SuspenseInfiniteFactoryCallOptions = {
-    queryKey?: QueryKey;
-};
-type SuspenseInfiniteQueryFactoryFn<Service, Method extends FunctionName<Service>, Transform extends TransformKey, TPageParam, Selected> = {
-    (getArgs: (pageParam: TPageParam) => ReactorArgs<Service, Method, Transform>): SuspenseInfiniteQueryResult<SuspenseInfiniteQueryPageData<Service, Method, Transform>, TPageParam, Selected, SuspenseInfiniteQueryError<Service, Method, Transform>>;
-    (getArgs: (pageParam: TPageParam) => ReactorArgs<Service, Method, Transform>, options?: SuspenseInfiniteFactoryCallOptions): SuspenseInfiniteQueryResult<SuspenseInfiniteQueryPageData<Service, Method, Transform>, TPageParam, Selected, SuspenseInfiniteQueryError<Service, Method, Transform>>;
-};
-/** The raw page data type returned by the query function */
-export type SuspenseInfiniteQueryPageData<Service = BaseActor, Method extends FunctionName<Service> = FunctionName<Service>, Transform extends TransformKey = "candid"> = ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>;
-/** The error type for infinite queries */
-export type SuspenseInfiniteQueryError<Service = BaseActor, Method extends FunctionName<Service> = FunctionName<Service>, Transform extends TransformKey = "candid"> = ReactorReturnErr<Service, Method, Transform>;
-/**
- * Configuration for createActorSuspenseInfiniteQuery.
- * Extends InfiniteQueryObserverOptions to accept all React Query options at the create level.
- *
- * @template Service - The actor interface type
- * @template Method - The method name on the actor
- * @template Transform - The transformation key (identity, display, etc.)
- * @template TPageParam - The type of the page parameter
- * @template Selected - The type returned after select transformation
- */
-export interface SuspenseInfiniteQueryConfig<Service = BaseActor, Method extends FunctionName<Service> = FunctionName<Service>, Transform extends TransformKey = "candid", TPageParam = unknown, Selected = InfiniteData<SuspenseInfiniteQueryPageData<Service, Method, Transform>, TPageParam>> extends Omit<InfiniteQueryObserverOptions<SuspenseInfiniteQueryPageData<Service, Method, Transform>, SuspenseInfiniteQueryError<Service, Method, Transform>, Selected, QueryKey, TPageParam>, "queryKey" | "queryFn"> {
-    /** The method to call on the canister */
-    functionName: Method;
-    /** Call configuration for the actor method */
-    callConfig?: CallConfig;
-    /** Custom query key (optional, auto-generated if not provided) */
-    queryKey?: QueryKey;
-    /** Function to get args from page parameter */
-    getArgs: (pageParam: TPageParam) => ReactorArgs<Service, Method, Transform>;
-    /**
-     * Narrows what the cache key derives from the call arguments.
-     *
-     * By default the key is scoped by `getArgs(initialPageParam)`, so two
-     * infinite queries on the same method with different arguments stay in
-     * separate cache entries. Supply this when those args embed the cursor and
-     * only part of them identifies the query.
-     */
-    getKeyArgs?: (args: ReactorArgs<Service, Method, Transform>) => unknown;
-}
-/**
- * Configuration for createActorSuspenseInfiniteQueryFactory (without getArgs; provided at call time).
- */
-export type SuspenseInfiniteQueryFactoryConfig<Service = BaseActor, Method extends FunctionName<Service> = FunctionName<Service>, Transform extends TransformKey = "candid", TPageParam = unknown, Selected = InfiniteData<SuspenseInfiniteQueryPageData<Service, Method, Transform>, TPageParam>> = Omit<SuspenseInfiniteQueryConfig<Service, Method, Transform, TPageParam, Selected>, "getArgs">;
-/**
- * useSuspenseInfiniteQuery hook with chained select support.
- */
-export interface UseSuspenseInfiniteQueryWithSelect<TPageData, TPageParam, Selected = InfiniteData<TPageData, TPageParam>, TError = Error> {
-    (options?: Omit<UseSuspenseInfiniteQueryOptions<TPageData, TError, Selected, QueryKey, TPageParam>, "select" | "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam" | "getPreviousPageParam">): UseSuspenseInfiniteQueryResult<Selected, TError>;
-    <TFinal = Selected>(options: Omit<UseSuspenseInfiniteQueryOptions<TPageData, TError, TFinal, QueryKey, TPageParam>, "queryKey" | "queryFn" | "select" | "initialPageParam" | "getNextPageParam" | "getPreviousPageParam"> & {
-        select: (data: Selected) => TFinal;
-    }): UseSuspenseInfiniteQueryResult<TFinal, TError>;
-}
-/**
- * Result from createActorSuspenseInfiniteQuery
- *
- * @template TPageData - The raw page data type
- * @template TPageParam - The page parameter type
- * @template Selected - The type after select transformation
- * @template TError - The error type
- */
-export interface SuspenseInfiniteQueryResult<TPageData, TPageParam, Selected = InfiniteData<TPageData, TPageParam>, TError = Error> {
-    /** Fetch first page in loader (uses ensureInfiniteQueryData for cache-first) */
-    fetch: () => Promise<Selected>;
-    /** React hook for components - supports pagination */
-    useSuspenseInfiniteQuery: UseSuspenseInfiniteQueryWithSelect<TPageData, TPageParam, Selected, TError>;
-    /** Invalidate the cache (refetches if query is active) */
-    invalidate: () => 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.
-     */
-    getCacheData: {
-        (): Selected | undefined;
-        <TFinal>(select: (data: Selected) => TFinal): TFinal | undefined;
-    };
-}
-export declare function createSuspenseInfiniteQuery<Service, Transform extends TransformKey, Method extends FunctionName<Service> = FunctionName<Service>, TPageParam = unknown, Selected = InfiniteData<SuspenseInfiniteQueryPageData<Service, Method, Transform>, TPageParam>>(reactor: Reactor<Service, Transform>, config: SuspenseInfiniteQueryConfig<NoInfer<Service>, Method, Transform, TPageParam, Selected>): SuspenseInfiniteQueryResult<SuspenseInfiniteQueryPageData<Service, Method, Transform>, TPageParam, Selected, SuspenseInfiniteQueryError<Service, Method, Transform>>;
-/**
- * Create a suspense infinite query factory that accepts getArgs at call time.
- * Useful when pagination logic varies by context.
- *
- * @template Service - The actor interface type
- * @template Method - The method name on the actor
- * @template Transform - The transformation key (identity, display, etc.)
- * @template TPageParam - The page parameter type
- * @template Selected - The type returned after select transformation
- *
- * @param reactor - The Reactor instance
- * @param config - Suspense infinite query configuration (without getArgs)
- * @returns A function that accepts getArgs and returns an SuspenseActorInfiniteQueryResult
- *
- * @example
- * const getPostsQuery = createActorSuspenseInfiniteQueryFactory(reactor, {
- *   functionName: "get_posts",
- *   initialPageParam: 0,
- *   getKeyArgs: (args) => {
- *     const [{ userId }] = args
- *     return [{ userId }]
- *   },
- *   getNextPageParam: (lastPage) => lastPage.nextCursor,
- * })
- *
- * // Create query with specific args builder
- * const userPostsQuery = getPostsQuery((cursor) => [{ userId, cursor, limit: 10 }])
- * const { data, fetchNextPage } = userPostsQuery.useSuspenseInfiniteQuery()
- *
- * // Optional: append a manual query-key suffix in addition to auto key args
- * const scopedPostsQuery = getPostsQuery(
- *   (cursor) => [{ userId, cursor, limit: 10 }],
- *   { queryKey: ["v2"] }
- * )
- */
-export declare function createSuspenseInfiniteQueryFactory<Service, Transform extends TransformKey, Method extends FunctionName<Service> = FunctionName<Service>, TPageParam = unknown, Selected = InfiniteData<SuspenseInfiniteQueryPageData<Service, Method, Transform>, TPageParam>>(reactor: Reactor<Service, Transform>, config: SuspenseInfiniteQueryFactoryConfig<NoInfer<Service>, Method, Transform, TPageParam, Selected>): SuspenseInfiniteQueryFactoryFn<Service, Method, Transform, TPageParam, Selected>;
-export {};
-//# sourceMappingURL=createSuspenseInfiniteQuery.d.ts.map

package/dist/createSuspenseInfiniteQuery.d.ts.map

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

package/dist/createSuspenseInfiniteQuery.js

@@ -1,177 +0,0 @@
-/**
- * Suspense Infinite Query Factory - Generic wrapper for React Query suspense-based paginated canister data
- *
- * Creates unified fetch/hook/invalidate functions for any paginated canister method.
- * Works with any Reactor instance.
- *
- * Uses `useSuspenseInfiniteQuery` which:
- * - Requires wrapping in <Suspense> boundary
- * - Data is always defined (no undefined checks)
- * - Does NOT support `enabled` or `placeholderData` options
- *
- * @example
- * const postsQuery = createSuspenseInfiniteQuery(reactor, {
- *   functionName: "get_posts",
- *   initialPageParam: 0,
- *   getArgs: (cursor) => [{ cursor, limit: 10 }],
- *   getNextPageParam: (lastPage) => lastPage.nextCursor,
- * })
- *
- * // In component (wrap in Suspense)
- * const { data, fetchNextPage, hasNextPage } = postsQuery.useSuspenseInfiniteQuery()
- *
- * // Flatten all pages
- * const allPosts = data.pages.flatMap(page => page.posts)
- */
-import { useMemo } from "react";
-import { useSuspenseInfiniteQuery, } from "@tanstack/react-query";
-import { buildChainedSelect, mergeFactoryQueryKey, normalizeQueryData, } from "./utils.js";
-// ============================================================================
-// Internal Implementation
-// ============================================================================
-const createSuspenseInfiniteQueryImpl = (reactor, config) => {
-    const { functionName, callConfig, queryKey: customQueryKey, initialPageParam, getArgs, getKeyArgs, getNextPageParam, getPreviousPageParam, maxPages, staleTime = 5 * 60 * 1000, select, ...rest } = config;
-    // Fold the call arguments into the key — see the matching comment in
-    // createInfiniteQuery. Without them every infinite query on a method shares
-    // one cache entry, because the arguments live in a `getArgs` closure rather
-    // than in the config.
-    const getQueryKey = () => {
-        const initialArgs = getArgs(initialPageParam);
-        const keyArgs = getKeyArgs?.(initialArgs) ?? initialArgs;
-        return reactor.generateQueryKey({
-            functionName,
-            queryKey: mergeFactoryQueryKey(customQueryKey, undefined, keyArgs),
-        }, callConfig);
-    };
-    // Query function - accepts QueryFunctionContext
-    const queryFn = async (context) => {
-        // pageParam is typed as unknown in QueryFunctionContext, but we know its type
-        const pageParam = context.pageParam;
-        const args = getArgs(pageParam);
-        const result = await reactor.callMethod({
-            functionName,
-            args,
-            callConfig,
-        });
-        return normalizeQueryData(result);
-    };
-    // Get infinite query options for fetchInfiniteQuery
-    const getInfiniteQueryOptions = () => ({
-        queryKey: getQueryKey(),
-        queryFn,
-        initialPageParam,
-        getNextPageParam,
-        staleTime,
-    });
-    // Fetch function for loaders (cache-first, fetches first page)
-    const fetch = async () => {
-        // Use ensureInfiniteQueryData to get cached data or fetch if stale
-        const result = await reactor.queryClient.ensureInfiniteQueryData(getInfiniteQueryOptions());
-        // Result is already InfiniteData format
-        return select ? select(result) : result;
-    };
-    // Implementation
-    const useSuspenseInfiniteQueryHook = (options) => {
-        // Memoized and identity-preserving; see buildChainedSelect for why the
-        // function identity matters to the observer's select-result cache.
-        const chainedSelect = useMemo(() => buildChainedSelect(select, options?.select), [options?.select]);
-        return useSuspenseInfiniteQuery({
-            queryKey: getQueryKey(),
-            queryFn,
-            initialPageParam,
-            getNextPageParam,
-            getPreviousPageParam,
-            maxPages,
-            staleTime,
-            ...rest,
-            ...options,
-            select: chainedSelect,
-        }, reactor.queryClient);
-    };
-    // Invalidate function
-    const invalidate = async () => {
-        const queryKey = getQueryKey();
-        await reactor.queryClient.invalidateQueries({ queryKey });
-    };
-    // Get data from cache without fetching
-    const getCacheData = (selectFn) => {
-        const queryKey = getQueryKey();
-        const cachedRawData = reactor.queryClient.getQueryData(queryKey);
-        if (cachedRawData === undefined) {
-            return undefined;
-        }
-        // Apply config.select to raw cache data
-        const selectedData = (select ? select(cachedRawData) : cachedRawData);
-        // Apply optional select parameter
-        if (selectFn) {
-            return selectFn(selectedData);
-        }
-        return selectedData;
-    };
-    return {
-        fetch,
-        useSuspenseInfiniteQuery: useSuspenseInfiniteQueryHook,
-        invalidate,
-        getQueryKey,
-        getCacheData,
-    };
-};
-// ============================================================================
-// Factory Function
-// ============================================================================
-export function createSuspenseInfiniteQuery(reactor, config) {
-    return createSuspenseInfiniteQueryImpl(reactor, config);
-}
-// ============================================================================
-// Factory with Dynamic Args
-// ============================================================================
-/**
- * Create a suspense infinite query factory that accepts getArgs at call time.
- * Useful when pagination logic varies by context.
- *
- * @template Service - The actor interface type
- * @template Method - The method name on the actor
- * @template Transform - The transformation key (identity, display, etc.)
- * @template TPageParam - The page parameter type
- * @template Selected - The type returned after select transformation
- *
- * @param reactor - The Reactor instance
- * @param config - Suspense infinite query configuration (without getArgs)
- * @returns A function that accepts getArgs and returns an SuspenseActorInfiniteQueryResult
- *
- * @example
- * const getPostsQuery = createActorSuspenseInfiniteQueryFactory(reactor, {
- *   functionName: "get_posts",
- *   initialPageParam: 0,
- *   getKeyArgs: (args) => {
- *     const [{ userId }] = args
- *     return [{ userId }]
- *   },
- *   getNextPageParam: (lastPage) => lastPage.nextCursor,
- * })
- *
- * // Create query with specific args builder
- * const userPostsQuery = getPostsQuery((cursor) => [{ userId, cursor, limit: 10 }])
- * const { data, fetchNextPage } = userPostsQuery.useSuspenseInfiniteQuery()
- *
- * // Optional: append a manual query-key suffix in addition to auto key args
- * const scopedPostsQuery = getPostsQuery(
- *   (cursor) => [{ userId, cursor, limit: 10 }],
- *   { queryKey: ["v2"] }
- * )
- */
-export function createSuspenseInfiniteQueryFactory(reactor, config) {
-    const factory = (getArgs, options) => {
-        // Only the caller-supplied segments are merged here; the args-derived
-        // segment is added by the impl, which does it for every infinite query.
-        // Applying it in both places would append the args twice.
-        const queryKey = mergeFactoryQueryKey(config.queryKey, options?.queryKey, undefined);
-        return createSuspenseInfiniteQueryImpl(reactor, {
-            ...config,
-            queryKey,
-            getArgs,
-        });
-    };
-    return factory;
-}
-//# sourceMappingURL=createSuspenseInfiniteQuery.js.map

package/dist/createSuspenseInfiniteQuery.js.map

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

package/dist/createSuspenseQuery.d.ts

@@ -1,25 +0,0 @@
-/**
- * Suspense Query Factory - Generic wrapper for React Suspense-based canister data
- *
- * Creates unified fetch/hook/invalidate functions for any canister method.
- * Works with any Reactor instance.
- *
- * Uses `useSuspenseQuery` which:
- * - Requires wrapping in <Suspense> boundary
- * - Data is always defined (no undefined checks)
- * - Does NOT support `enabled` option
- *
- * @example
- * const userQuery = createSuspenseQuery(todoManager, {
- *   functionName: "get_user",
- *   select: (result) => result.user,
- * })
- *
- * // In component (wrap in Suspense)
- * const { data: user } = userQuery.useSuspenseQuery() // data is never undefined!
- */
-import type { Reactor, FunctionName, ReactorArgs, TransformKey } from "@ic-reactor/core";
-import type { QueryFnData, QueryError, SuspenseQueryConfig, SuspenseQueryResult, SuspenseQueryFactoryConfig, NoInfer } from "./types.js";
-export declare function createSuspenseQuery<Service, Transform extends TransformKey, Method extends FunctionName<Service> = FunctionName<Service>, Selected = QueryFnData<Service, Method, Transform>>(reactor: Reactor<Service, Transform>, config: SuspenseQueryConfig<NoInfer<Service>, Method, Transform, Selected>): SuspenseQueryResult<QueryFnData<Service, Method, Transform>, Selected, QueryError<Service, Method, Transform>>;
-export declare function createSuspenseQueryFactory<Service, Transform extends TransformKey, Method extends FunctionName<Service> = FunctionName<Service>, Selected = QueryFnData<Service, Method, Transform>>(reactor: Reactor<Service, Transform>, config: SuspenseQueryFactoryConfig<NoInfer<Service>, Method, Transform, Selected>): (args: ReactorArgs<Service, Method, Transform>) => SuspenseQueryResult<QueryFnData<Service, Method, Transform>, Selected, QueryError<Service, Method, Transform>>;
-//# sourceMappingURL=createSuspenseQuery.d.ts.map

package/dist/createSuspenseQuery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createSuspenseQuery.d.ts","sourceRoot":"","sources":["../src/createSuspenseQuery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,kBAAkB,CAAA;AAGzB,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,mBAAmB,EAEnB,mBAAmB,EACnB,0BAA0B,EAC1B,OAAO,EACR,MAAM,YAAY,CAAA;AAqHnB,wBAAgB,mBAAmB,CACjC,OAAO,EACP,SAAS,SAAS,YAAY,EAC9B,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,EAC5D,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAElD,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,EACpC,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,GACzE,mBAAmB,CACpB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EACvC,QAAQ,EACR,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CACvC,CAKA;AAMD,wBAAgB,0BAA0B,CACxC,OAAO,EACP,SAAS,SAAS,YAAY,EAC9B,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,EAC5D,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAElD,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,EACpC,MAAM,EAAE,0BAA0B,CAChC,OAAO,CAAC,OAAO,CAAC,EAChB,MAAM,EACN,SAAS,EACT,QAAQ,CACT,GACA,CACD,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,KAC1C,mBAAmB,CACtB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EACvC,QAAQ,EACR,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CACvC,CAqCA"}

package/dist/createSuspenseQuery.js

@@ -1,111 +0,0 @@
-/**
- * Suspense Query Factory - Generic wrapper for React Suspense-based canister data
- *
- * Creates unified fetch/hook/invalidate functions for any canister method.
- * Works with any Reactor instance.
- *
- * Uses `useSuspenseQuery` which:
- * - Requires wrapping in <Suspense> boundary
- * - Data is always defined (no undefined checks)
- * - Does NOT support `enabled` option
- *
- * @example
- * const userQuery = createSuspenseQuery(todoManager, {
- *   functionName: "get_user",
- *   select: (result) => result.user,
- * })
- *
- * // In component (wrap in Suspense)
- * const { data: user } = userQuery.useSuspenseQuery() // data is never undefined!
- */
-import { useMemo } from "react";
-import { useSuspenseQuery } from "@tanstack/react-query";
-import { buildChainedSelect, createBoundedCache } from "./utils.js";
-// ============================================================================
-// Internal Implementation
-// ============================================================================
-const createSuspenseQueryImpl = (reactor, config) => {
-    const { functionName, args, staleTime = 5 * 60 * 1000, select, queryKey: customQueryKey, ...rest } = config;
-    const params = { functionName, args, queryKey: customQueryKey };
-    const getQueryKey = () => reactor.generateQueryKey(params);
-    const applySelect = (raw) => select ? select(raw) : raw;
-    /** Cache-first fetch for use in loaders / route preloading. */
-    const fetch = async () => {
-        const result = await reactor.fetchQuery(params);
-        return applySelect(result);
-    };
-    /** Fire-and-forget prefetch — warms the cache without blocking. */
-    const prefetch = () => {
-        const baseOptions = reactor.getQueryOptions(params);
-        return reactor.queryClient.prefetchQuery({
-            queryKey: baseOptions.queryKey,
-            queryFn: baseOptions.queryFn,
-            staleTime,
-        });
-    };
-    const useSuspenseQueryHook = (options) => {
-        const baseOptions = reactor.getQueryOptions(params);
-        // Memoized so the observer's select-result cache can hit; see
-        // buildChainedSelect. `select` comes from the factory config and is stable.
-        const chainedSelect = useMemo(() => buildChainedSelect(select, options?.select), [options?.select]);
-        return useSuspenseQuery({
-            queryKey: baseOptions.queryKey,
-            staleTime,
-            ...rest,
-            ...options,
-            queryFn: baseOptions.queryFn,
-            select: chainedSelect,
-        }, reactor.queryClient);
-    };
-    const invalidate = async () => {
-        await reactor.queryClient.invalidateQueries({ queryKey: getQueryKey() });
-    };
-    const getCacheData = (selectFn) => {
-        const raw = reactor.getQueryData(params);
-        if (raw === undefined)
-            return undefined;
-        const selected = applySelect(raw);
-        return selectFn ? selectFn(selected) : selected;
-    };
-    const setData = (updater) => {
-        return reactor.queryClient.setQueryData(getQueryKey(), updater);
-    };
-    return {
-        fetch,
-        prefetch,
-        useSuspenseQuery: useSuspenseQueryHook,
-        invalidate,
-        getQueryKey,
-        getCacheData,
-        setData,
-    };
-};
-// ============================================================================
-// Public Factory Function
-// ============================================================================
-export function createSuspenseQuery(reactor, config) {
-    return createSuspenseQueryImpl(reactor, config);
-}
-// ============================================================================
-// Convenience: Create suspense query with dynamic args
-// ============================================================================
-export function createSuspenseQueryFactory(reactor, config) {
-    const cache = createBoundedCache();
-    return (args) => {
-        const key = reactor.generateQueryKey({
-            functionName: config.functionName,
-            args,
-        });
-        const cacheKey = JSON.stringify(key);
-        const existing = cache.get(cacheKey);
-        if (existing)
-            return existing;
-        const result = createSuspenseQueryImpl(reactor, {
-            ...config,
-            args,
-        });
-        cache.set(cacheKey, result);
-        return result;
-    };
-}
-//# sourceMappingURL=createSuspenseQuery.js.map

package/dist/createSuspenseQuery.js.map

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

package/dist/defineReactor.d.ts

@@ -1,125 +0,0 @@
-/**
- * defineReactor - One-call bootstrap for a canister reactor + its React hooks.
- *
- * Collapses the four manual steps (QueryClient → ClientManager → Reactor →
- * createActorHooks) into a single call, and turns the Reactor / DisplayReactor
- * choice into a `display` flag.
- * Use this when one-call bootstrap is enough. If you need reusable
- * method-specific operations outside React, compose with query/mutation
- * factories after setup.
- *
- * @example
- * ```typescript
- * import { defineReactor } from "@ic-reactor/react"
- * import { idlFactory, type _SERVICE } from "./declarations/backend"
- *
- * const { reactor, useActorQuery, useActorMutation } = defineReactor<_SERVICE>({
- *   name: "backend",
- *   idlFactory,
- *   canisterId: "rrkah-fqaaa-aaaaa-aaaaq-cai",
- *   display: true, // ⇒ DisplayReactor (string principals/bigints)
- * })
- *
- * function Profile() {
- *   const { data } = useActorQuery({ functionName: "get_profile" })
- *   return <div>{data?.name}</div>
- * }
- * ```
- *
- * @example Reuse an existing ClientManager (multiple canisters share one agent)
- * ```typescript
- * const ledger = defineReactor<_LEDGER>({ name: "ledger", idlFactory: ledgerIdl })
- * const index = defineReactor<_INDEX>({
- *   name: "index",
- *   idlFactory: indexIdl,
- *   clientManager: ledger.clientManager,
- *   authentication: ledger.authentication, // one Internet Identity session
- * })
- * ```
- *
- * @example Internet Identity is wired up out of the box
- * ```typescript
- * const { useAuth, useIdentityAttributes } = defineReactor<_SERVICE>({
- *   name: "backend",
- *   idlFactory,
- *   // Needed when the app is served from more than one origin.
- *   auth: { derivationOrigin: "https://app.example.com" },
- * })
- *
- * function LoginButton() {
- *   const { login, logout, isAuthenticated, principal } = useAuth()
- *   return isAuthenticated
- *     ? <button onClick={() => logout()}>{principal?.toText()}</button>
- *     : <button onClick={() => login()}>Sign in</button>
- * }
- * ```
- */
-import { ClientManager, Reactor, DisplayReactor } from "@ic-reactor/core";
-import type { BaseActor, TransformKey, ReactorParameters, ClientManagerParameters, DisplayReactorParameters } from "@ic-reactor/core";
-import { QueryClient } from "@tanstack/react-query";
-import { ActorHooks } from "./createActorHooks.js";
-import { AuthenticationManager } from "./auth/authentication-manager.js";
-import { IdentityAttributesManager } from "./auth/identity-attributes-manager.js";
-import type { UseIdentityAttributesReturn } from "./auth/createIdentityAttributeHooks.js";
-import type { CreateAuthHooksReturn } from "./hooks/createAuthHooks.js";
-import type { AuthenticationManagerParameters } from "./auth/authentication-manager.js";
-/** Options shared by both the standard and display variants of defineReactor. */
-export interface DefineReactorSharedParameters extends Omit<ReactorParameters, "clientManager">, Omit<ClientManagerParameters, "queryClient"> {
-    /**
-     * Reuse an existing ClientManager (e.g. to share one agent across canisters).
-     * When omitted, a ClientManager is created from the agent options below.
-     *
-     * A supplied or adopted manager brings its own agent and QueryClient, so
-     * `agentOptions`, `queryClient` and `allowEnvConfig` apply only when this
-     * call creates one.
-     */
-    clientManager?: ClientManager;
-    /**
-     * QueryClient for a ClientManager created by this call.
-     *
-     * Ignored when `clientManager` or `authentication` is supplied — queries run
-     * against that manager's own QueryClient, which is what is returned.
-     */
-    queryClient?: QueryClient;
-    /**
-     * Reuse an existing AuthenticationManager, so several reactors share one
-     * Internet Identity session. When omitted, one is created for this reactor.
-     *
-     * Its `clientManager` is adopted for this reactor, so sign-in updates the
-     * same agent the reactor calls through. Supplying a different `clientManager`
-     * alongside it is rejected.
-     */
-    authentication?: AuthenticationManager;
-    /**
-     * Internet Identity options forwarded to the AuthenticationManager
-     * (`identityProvider`, `derivationOrigin`, `idleOptions`, `storage`, …).
-     *
-     * Mutually exclusive with `authentication`: a manager built elsewhere is
-     * already configured, so these could not be applied to it.
-     */
-    auth?: Omit<AuthenticationManagerParameters, "clientManager">;
-}
-/** Parameters for a standard (raw Candid types) reactor. */
-export interface DefineReactorParameters extends DefineReactorSharedParameters {
-    display?: false;
-}
-/** Parameters for a DisplayReactor (UI-friendly string principals/bigints). */
-export interface DefineDisplayReactorParameters<Service> extends DefineReactorSharedParameters {
-    display: true;
-    /** Optional initial argument validators (receive display types). */
-    validators?: DisplayReactorParameters<Service>["validators"];
-}
-/** The reactor instance plus its bound hooks and shared infrastructure. */
-export type DefineReactorResult<Service, Transform extends TransformKey, R extends Reactor<Service, Transform>> = ActorHooks<Service, Transform> & CreateAuthHooksReturn & {
-    reactor: R;
-    clientManager: ClientManager;
-    queryClient: QueryClient;
-    /** Internet Identity session manager backing `useAuth`. */
-    authentication: AuthenticationManager;
-    /** Signed identity attribute requests backing `useIdentityAttributes`. */
-    identityAttributes: IdentityAttributesManager;
-    useIdentityAttributes: () => UseIdentityAttributesReturn;
-};
-export declare function defineReactor<Service = BaseActor>(params: DefineDisplayReactorParameters<Service>): DefineReactorResult<Service, "display", DisplayReactor<Service>>;
-export declare function defineReactor<Service = BaseActor>(params: DefineReactorParameters): DefineReactorResult<Service, "candid", Reactor<Service, "candid">>;
-//# sourceMappingURL=defineReactor.d.ts.map

package/dist/defineReactor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"defineReactor.d.ts","sourceRoot":"","sources":["../src/defineReactor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,OAAO,EACL,aAAa,EACb,OAAO,EACP,cAAc,EAEf,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAoB,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAA;AAEjF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAA;AAEzF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAA;AAEvF,iFAAiF;AACjF,MAAM,WAAW,6BACf,SACE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,EACxC,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC;IAC9C;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAA;IACtC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC,+BAA+B,EAAE,eAAe,CAAC,CAAA;CAC9D;AAED,4DAA4D;AAC5D,MAAM,WAAW,uBAAwB,SAAQ,6BAA6B;IAC5E,OAAO,CAAC,EAAE,KAAK,CAAA;CAChB;AAED,+EAA+E;AAC/E,MAAM,WAAW,8BAA8B,CAC7C,OAAO,CACP,SAAQ,6BAA6B;IACrC,OAAO,EAAE,IAAI,CAAA;IACb,oEAAoE;IACpE,UAAU,CAAC,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAA;CAC7D;AAED,2EAA2E;AAC3E,MAAM,MAAM,mBAAmB,CAC7B,OAAO,EACP,SAAS,SAAS,YAAY,EAC9B,CAAC,SAAS,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,IACnC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,GAChC,qBAAqB,GAAG;IACtB,OAAO,EAAE,CAAC,CAAA;IACV,aAAa,EAAE,aAAa,CAAA;IAC5B,WAAW,EAAE,WAAW,CAAA;IACxB,2DAA2D;IAC3D,cAAc,EAAE,qBAAqB,CAAA;IACrC,0EAA0E;IAC1E,kBAAkB,EAAE,yBAAyB,CAAA;IAC7C,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;CACzD,CAAA;AAmBH,wBAAgB,aAAa,CAAC,OAAO,GAAG,SAAS,EAC/C,MAAM,EAAE,8BAA8B,CAAC,OAAO,CAAC,GAC9C,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;AAEnE,wBAAgB,aAAa,CAAC,OAAO,GAAG,SAAS,EAC/C,MAAM,EAAE,uBAAuB,GAC9B,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA"}