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

package/dist/createSuspenseInfiniteQuery.d.ts

@@ -1,154 +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 }] as const,
- *   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 type { NoInfer, QueryCacheControls, QueryFactoryMethods } from "./types.js";
-type SuspenseInfiniteFactoryCallOptions = {
-    queryKey?: QueryKey;
-};
-type SuspenseInfiniteQueryFactoryFn<Service, Method extends FunctionName<Service>, Transform extends TransformKey, TPageParam, Selected> = QueryFactoryMethods & {
-    (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 createSuspenseInfiniteQuery.
- * 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 createSuspenseInfiniteQueryFactory (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 createSuspenseInfiniteQuery
- *
- * `cancel()`, `reset()` and `optimisticUpdate()` act on the whole page set:
- * `optimisticUpdate` gets and returns the raw `InfiniteData`, `{ pages,
- * pageParams }`.
- *
- * @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> extends QueryCacheControls<InfiniteData<TPageData, TPageParam>> {
-    /** 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 a SuspenseInfiniteQueryResult
- *
- * @example
- * const getPostsQuery = createSuspenseInfiniteQueryFactory(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"] }
- * )
- *
- * // Every list this factory made, whatever its args and pages
- * await getPostsQuery.invalidate()
- */
-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,209 +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 }] as const,
- *   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, callConfigForKey, mergeFactoryQueryKey, mountWhileSuspended, normalizeQueryData, pickFetchOptions, queryCacheControls, retryOption, useMountQueryClient, withQueryFactoryMethods, } 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: callConfigForKey(context.queryKey, callConfig),
-        });
-        return normalizeQueryData(result);
-    };
-    // Get infinite query options for fetchInfiniteQuery
-    const getInfiniteQueryOptions = () => {
-        const queryKey = getQueryKey();
-        return {
-            // How the query function runs, shared with the hook; see
-            // pickFetchOptions. An update method's `retry` defaults as
-            // `Reactor.getQueryRetry` says.
-            ...pickFetchOptions(rest),
-            ...retryOption(rest.retry, reactor.getQueryRetry(functionName, queryKey)),
-            queryKey,
-            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. A
-        // sign-in or sign-out while it is in flight cancels it; it then runs again
-        // for the new identity rather than rejecting with TanStack's
-        // CancelledError, as `reactor.fetchQuery` does.
-        const result = await reactor.clientManager.fetchAcrossIdentitySwitch(() => reactor.queryClient.ensureInfiniteQueryData(getInfiniteQueryOptions()));
-        // Result is already InfiniteData format
-        return select ? select(result) : result;
-    };
-    // Implementation
-    const useSuspenseInfiniteQueryHook = (options) => {
-        useMountQueryClient(reactor.queryClient);
-        // 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]);
-        const queryKey = getQueryKey();
-        try {
-            return useSuspenseInfiniteQuery({
-                queryKey,
-                queryFn,
-                initialPageParam,
-                getNextPageParam,
-                getPreviousPageParam,
-                maxPages,
-                staleTime,
-                ...rest,
-                ...options,
-                select: chainedSelect,
-                // The hook's `retry`, else the config's, else an update method's
-                // default; see `Reactor.getQueryRetry`.
-                ...retryOption(options?.retry ?? rest.retry, reactor.getQueryRetry(functionName, queryKey)),
-            }, reactor.queryClient);
-        }
-        catch (thrown) {
-            mountWhileSuspended(reactor.queryClient, thrown);
-            throw thrown;
-        }
-    };
-    // 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,
-        ...queryCacheControls(reactor, getQueryKey),
-    };
-};
-// ============================================================================
-// 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 a SuspenseInfiniteQueryResult
- *
- * @example
- * const getPostsQuery = createSuspenseInfiniteQueryFactory(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"] }
- * )
- *
- * // Every list this factory made, whatever its args and pages
- * await getPostsQuery.invalidate()
- */
-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,
-        });
-    };
-    // What every instance's key starts with: the method, the `callConfig`
-    // segments and the config `queryKey`. A per-call `queryKey` and the args
-    // segment come after them.
-    return withQueryFactoryMethods(factory, reactor, () => reactor.generateQueryKey({
-        functionName: config.functionName,
-        queryKey: config.queryKey,
-    }, config.callConfig));
-}
-//# 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,46 +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, QueryFactoryFn, 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>>;
-/**
- * Create a suspense query factory: a function that takes the method's args
- * and returns the suspense query object for them, the same object for the
- * same args.
- *
- * The function also has `getQueryKey()`, the key prefix every query it
- * returns shares, and `invalidate()`, which invalidates all of them whatever
- * their args. Pass the function itself to a mutation's `invalidateQueries` to
- * refresh every instance after the mutation.
- *
- * @example
- * const getBalance = createSuspenseQueryFactory(ledger, {
- *   functionName: "icrc1_balance_of",
- * })
- *
- * // In a component under <Suspense>
- * const { data } = getBalance([{ owner, subaccount: [] }]).useSuspenseQuery()
- *
- * // Refetch every account's balance
- * await getBalance.invalidate()
- */
-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>): QueryFactoryFn<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,cAAc,EACd,OAAO,EACR,MAAM,YAAY,CAAA;AA0JnB,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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,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,cAAc,CACf,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EACvC,mBAAmB,CACjB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EACvC,QAAQ,EACR,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CACvC,CACF,CA+CA"}

package/dist/createSuspenseQuery.js

@@ -1,158 +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, mountWhileSuspended, pickFetchOptions, queryCacheControls, retryOption, useMountQueryClient, withQueryFactoryMethods, } from "./utils.js";
-// ============================================================================
-// Internal Implementation
-// ============================================================================
-const createSuspenseQueryImpl = (reactor, config) => {
-    const { functionName, args, callConfig, staleTime = 5 * 60 * 1000, select, queryKey: customQueryKey, ...rest } = config;
-    // `callConfig` goes wherever the hooks send it: to the call and into the
-    // key, so a query of another canister or agent has an entry of its own.
-    const params = { functionName, args, queryKey: customQueryKey, callConfig };
-    const getQueryKey = () => reactor.generateQueryKey(params, callConfig);
-    const applySelect = (raw) => select ? select(raw) : raw;
-    // How the query function runs, shared with the hook; see pickFetchOptions.
-    const fetchOptions = pickFetchOptions(rest);
-    /** Cache-first fetch for use in loaders / route preloading. */
-    const fetch = async () => {
-        // Through the reactor rather than straight to the QueryClient: overriding
-        // `fetchQuery` in a Reactor subclass is a documented way to add logic to
-        // every factory fetch.
-        const result = await reactor.fetchQuery(params, fetchOptions);
-        return applySelect(result);
-    };
-    /** Fire-and-forget prefetch — warms the cache without blocking. */
-    const prefetch = () => {
-        const baseOptions = reactor.getQueryOptions(params);
-        // Runs again when a sign-in or sign-out cancels it, and never rejects;
-        // see `prefetch` in createQuery.
-        return reactor.clientManager
-            .fetchAcrossIdentitySwitch(() => reactor.queryClient.prefetchQuery({
-            ...fetchOptions,
-            // An update method's default `retry`; see `Reactor.getQueryRetry`.
-            ...retryOption(fetchOptions.retry, baseOptions.retry),
-            queryKey: baseOptions.queryKey,
-            queryFn: baseOptions.queryFn,
-            staleTime,
-        }))
-            .catch(() => undefined);
-    };
-    const useSuspenseQueryHook = (options) => {
-        useMountQueryClient(reactor.queryClient);
-        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]);
-        try {
-            return useSuspenseQuery({
-                queryKey: baseOptions.queryKey,
-                staleTime,
-                ...rest,
-                ...options,
-                queryFn: baseOptions.queryFn,
-                select: chainedSelect,
-                // The hook's `retry`, else the config's, else an update method's
-                // default; see `Reactor.getQueryRetry`.
-                ...retryOption(options?.retry ?? rest.retry, baseOptions.retry),
-            }, reactor.queryClient);
-        }
-        catch (thrown) {
-            mountWhileSuspended(reactor.queryClient, thrown);
-            throw thrown;
-        }
-    };
-    const invalidate = async () => {
-        await reactor.queryClient.invalidateQueries({ queryKey: getQueryKey() });
-    };
-    const getCacheData = (selectFn) => {
-        const raw = reactor.getQueryData(params, callConfig);
-        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,
-        ...queryCacheControls(reactor, getQueryKey),
-    };
-};
-// ============================================================================
-// Public Factory Function
-// ============================================================================
-export function createSuspenseQuery(reactor, config) {
-    return createSuspenseQueryImpl(reactor, config);
-}
-// ============================================================================
-// Convenience: Create suspense query with dynamic args
-// ============================================================================
-/**
- * Create a suspense query factory: a function that takes the method's args
- * and returns the suspense query object for them, the same object for the
- * same args.
- *
- * The function also has `getQueryKey()`, the key prefix every query it
- * returns shares, and `invalidate()`, which invalidates all of them whatever
- * their args. Pass the function itself to a mutation's `invalidateQueries` to
- * refresh every instance after the mutation.
- *
- * @example
- * const getBalance = createSuspenseQueryFactory(ledger, {
- *   functionName: "icrc1_balance_of",
- * })
- *
- * // In a component under <Suspense>
- * const { data } = getBalance([{ owner, subaccount: [] }]).useSuspenseQuery()
- *
- * // Refetch every account's balance
- * await getBalance.invalidate()
- */
-export function createSuspenseQueryFactory(reactor, config) {
-    const cache = createBoundedCache();
-    const factory = (args) => {
-        const key = reactor.generateQueryKey({ functionName: config.functionName, args }, config.callConfig);
-        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;
-    };
-    // The method's own prefix, at the canister and agent the config's
-    // `callConfig` names. A config `queryKey` follows the args segment in every
-    // instance's key, so it cannot narrow the prefix.
-    return withQueryFactoryMethods(factory, reactor, () => reactor.generateQueryKey({ functionName: config.functionName }, config.callConfig));
-}
-//# 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/defineDisplayReactor.d.ts

@@ -1,43 +0,0 @@
-import { DisplayReactor } from "@ic-reactor/core";
-import type { BaseActor, DisplayReactorParameters } from "@ic-reactor/core";
-import type { DefineReactorSharedParameters, DefineReactorResult } from "./defineReactorShared.js";
-/** Options for {@link defineDisplayReactor}: `defineReactor`'s, plus validators. */
-export interface DefineDisplayReactorOptions<Service> extends DefineReactorSharedParameters {
-    /** Optional initial argument validators (receive display types). */
-    validators?: DisplayReactorParameters<Service>["validators"];
-}
-/**
- * One-call bootstrap for a {@link DisplayReactor} and its React hooks: the
- * display counterpart of `defineReactor`, taking the same options.
- *
- * A DisplayReactor takes and returns UI-friendly values — text for
- * `Principal`, `nat`, `int` and 64-bit integers, hex for blobs — which suits
- * forms and components. Its codecs are built on zod, so this adds zod to the
- * bundle. `defineReactor`, which builds a plain `Reactor` with raw Candid
- * values, does not need zod, but until its deprecated `display` flag is removed
- * at the next major it bundles zod anyway; `createActorHooks(new Reactor(...))`
- * is the setup without it.
- *
- * Replaces `defineReactor({ display: true })`, which is deprecated.
- *
- * @example
- * ```typescript
- * import { defineDisplayReactor } from "@ic-reactor/react"
- * import { idlFactory, type _SERVICE } from "./declarations/backend"
- *
- * export const { reactor, useActorQuery, useActorMutation, useAuth } =
- *   defineDisplayReactor<_SERVICE>({
- *     name: "backend",
- *     idlFactory,
- *     canisterId: "rrkah-fqaaa-aaaaa-aaaaq-cai",
- *   })
- *
- * function Balance() {
- *   // `nat` arrives as text, ready to render.
- *   const { data } = useActorQuery({ functionName: "get_balance" })
- *   return <span>{data}</span>
- * }
- * ```
- */
-export declare function defineDisplayReactor<Service = BaseActor>(params: DefineDisplayReactorOptions<Service>): DefineReactorResult<Service, "display", DisplayReactor<Service>>;
-//# sourceMappingURL=defineDisplayReactor.d.ts.map

package/dist/defineDisplayReactor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"defineDisplayReactor.d.ts","sourceRoot":"","sources":["../src/defineDisplayReactor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAE3E,OAAO,KAAK,EACV,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,0BAA0B,CAAA;AAEjC,oFAAoF;AACpF,MAAM,WAAW,2BAA2B,CAC1C,OAAO,CACP,SAAQ,6BAA6B;IACrC,oEAAoE;IACpE,UAAU,CAAC,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAA;CAC7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAG,SAAS,EACtD,MAAM,EAAE,2BAA2B,CAAC,OAAO,CAAC,GAC3C,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAUlE"}