@ic-reactor/react 3.12.4 → 3.13.0

package/dist/hooks/useActorQuery.js

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

package/dist/hooks/useActorQuery.js.map

@@ -1 +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;AAmD9B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAK3B,EACA,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,QAAQ,EAAE,eAAe,EACzB,GAAG,OAAO,EAMX,EAA6D,EAAE;IAC9D,+DAA+D;IAC/D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CACnC,GAAG,EAAE,CACH,OAAO,CAAC,eAAe,CAAS;QAC9B,UAAU;QACV,YAAY;QACZ,IAAI;QACJ,QAAQ,EAAE,eAAe;KAC1B,CAAC;IACJ,yEAAyE;IACzE,mEAAmE;IACnE,2EAA2E;IAC3E;QACE,OAAO;QACP,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;QAC9B,UAAU;QACV,YAAY;QACZ,IAAI;QACJ,eAAe;KAChB,CACF,CAAA;IAED,OAAO,QAAQ,CACb;QACE,OAAO;QACP,GAAG,OAAO;QACV,QAAQ;KACT,EACD,OAAO,CAAC,WAAW,CACpB,CAAA;AACH,CAAC,CAAA"}
+{"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,EACR,SAAS,GAIV,MAAM,uBAAuB,CAAA;AAW9B,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AA+C/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAK3B,EACA,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,QAAQ,EAAE,eAAe,EACzB,GAAG,OAAO,EAMX,EAA6D,EAAE;IAC9D,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IAExC,+DAA+D;IAC/D,wEAAwE;IACxE,2BAA2B;IAC3B,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAC1C,GAAG,EAAE,CACH,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,oEAAoE;YACpE,uDAAuD;YACvD;gBACE,QAAQ,EAAE,eAAe,CACvB,OAAO,CAAC,gBAAgB,CAAC,EAAE,YAAY,EAAE,EAAE,UAAU,CAAC,EACtD,OAAO,CACR;gBACD,6DAA6D;gBAC7D,OAAO,EAAE,SAAsB;gBAC/B,KAAK,EAAE,SAAS;aACjB;QACH,CAAC,CAAC,OAAO,CAAC,eAAe,CAAS;YAC9B,UAAU;YACV,YAAY;YACZ,IAAI;YACJ,QAAQ,EAAE,eAAe;SAC1B,CAAC;IACR,yEAAyE;IACzE,mEAAmE;IACnE,2EAA2E;IAC3E;QACE,OAAO;QACP,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;QAC9B,UAAU;QACV,YAAY;QACZ,IAAI;QACJ,eAAe;KAChB,CACF,CAAA;IAED,OAAO,QAAQ,CACb;QACE,OAAO;QACP,GAAG,OAAO;QACV,QAAQ;QACR,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;KACrC,EACD,OAAO,CAAC,WAAW,CACpB,CAAA;AACH,CAAC,CAAA"}

package/dist/hooks/useActorSuspenseInfiniteQuery.d.ts

@@ -12,6 +12,18 @@ export interface UseActorSuspenseInfiniteQueryParameters<Service, Method extends
     functionName: Method;
     /** 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 — return the stable, serializable
+     * portion (typically everything except the pagination field). It is required
+     * when `initialPageParam` changes between renders, as `Date.now()` does:
+     * without it every render keys a new query.
+     */
+    getKeyArgs?: (args: ReactorArgs<Service, Method, Transform>) => unknown;
     /** Agent call configuration (effectiveCanisterId, etc.) */
     callConfig?: CallConfig;
     /** Custom query key (auto-generated if not provided) */
@@ -21,19 +33,19 @@ export interface UseActorSuspenseInfiniteQueryParameters<Service, Method extends
     /** Function to determine next page parameter */
     getNextPageParam: (lastPage: ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, allPages: ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>[], lastPageParam: TPageParam, allPageParams: TPageParam[]) => TPageParam | undefined | null;
 }
-export type UseActorSuspenseInfiniteQueryConfig<Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", TPageParam = unknown> = Omit<UseActorSuspenseInfiniteQueryParameters<Service, Method, Transform, TPageParam>, "reactor">;
-export type UseActorSuspenseInfiniteQueryResult<Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", TPageParam = unknown> = UseSuspenseInfiniteQueryResult<InfiniteData<ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, TPageParam>, ReactorReturnErr<Service, Method, Transform>>;
+export type UseActorSuspenseInfiniteQueryConfig<Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", TPageParam = unknown, Selected = InfiniteData<ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, TPageParam>> = Omit<UseActorSuspenseInfiniteQueryParameters<Service, Method, Transform, TPageParam, Selected>, "reactor">;
+export type UseActorSuspenseInfiniteQueryResult<Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", TPageParam = unknown, Selected = InfiniteData<ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, TPageParam>> = UseSuspenseInfiniteQueryResult<Selected, ReactorReturnErr<Service, Method, Transform>>;
 /**
  * Hook for executing suspense-enabled infinite/paginated query calls on a canister.
  *
  * @example
- * const { data, fetchNextPage, hasNextPage } = useActorSuspenseInfiniteQuery({
+ * const { data, fetchNextPage, hasNextPage } = useReactorSuspenseInfiniteQuery({
  *   reactor,
  *   functionName: "getItems",
- *   getArgs: (pageParam) => [{ offset: pageParam, limit: 10 }],
+ *   getArgs: (pageParam) => [{ offset: pageParam, limit: 10 }] as const,
  *   initialPageParam: 0,
  *   getNextPageParam: (lastPage) => lastPage.nextOffset,
  * })
  */
-export declare const useActorSuspenseInfiniteQuery: <Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", TPageParam = unknown>({ reactor, functionName, getArgs, callConfig, queryKey, ...options }: UseActorSuspenseInfiniteQueryParameters<Service, Method, Transform, TPageParam>) => UseActorSuspenseInfiniteQueryResult<Service, Method, Transform, TPageParam>;
+export declare const useActorSuspenseInfiniteQuery: <Service, Method extends FunctionName<Service>, Transform extends TransformKey = "candid", TPageParam = unknown, Selected = InfiniteData<ReactorQueryData<ReactorReturnOk<Service, Method, Transform>>, TPageParam>>({ reactor, functionName, getArgs, getKeyArgs, callConfig, queryKey, ...options }: UseActorSuspenseInfiniteQueryParameters<Service, Method, Transform, TPageParam, Selected>) => UseActorSuspenseInfiniteQueryResult<Service, Method, Transform, TPageParam, Selected>;
 //# sourceMappingURL=useActorSuspenseInfiniteQuery.d.ts.map

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

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

package/dist/hooks/useActorSuspenseInfiniteQuery.js

@@ -1,30 +1,39 @@
 import { useMemo, useCallback } from "react";
 import { useSuspenseInfiniteQuery, } from "@tanstack/react-query";
-import { mergeFactoryQueryKey, normalizeQueryData } from "../utils.js";
+import { callConfigForKey, mergeFactoryQueryKey, mountWhileSuspended, normalizeQueryData, retryOption, useMountQueryClient, } from "../utils.js";
 /**
  * Hook for executing suspense-enabled infinite/paginated query calls on a canister.
  *
  * @example
- * const { data, fetchNextPage, hasNextPage } = useActorSuspenseInfiniteQuery({
+ * const { data, fetchNextPage, hasNextPage } = useReactorSuspenseInfiniteQuery({
  *   reactor,
  *   functionName: "getItems",
- *   getArgs: (pageParam) => [{ offset: pageParam, limit: 10 }],
+ *   getArgs: (pageParam) => [{ offset: pageParam, limit: 10 }] as const,
  *   initialPageParam: 0,
  *   getNextPageParam: (lastPage) => lastPage.nextOffset,
  * })
  */
-export const useActorSuspenseInfiniteQuery = ({ reactor, functionName, getArgs, callConfig, queryKey, ...options }) => {
+export const useActorSuspenseInfiniteQuery = ({ reactor, functionName, getArgs, getKeyArgs, callConfig, queryKey, ...options }) => {
+    useMountQueryClient(reactor.queryClient);
     // Always pass queryKey through generateQueryKey so it is merged with the
     // reactor/function identity. Using the custom key verbatim would cause cache
     // collisions if two different actors or methods share the same key string.
-    const baseQueryKey = useMemo(() => reactor.generateQueryKey({
-        functionName,
+    const baseQueryKey = useMemo(() => {
         // Fold the call arguments into the key. They live in the `getArgs`
         // closure rather than in the config, so without this two hooks on the
-        // same method with different arguments share one cache entry and
-        // serve each other's pages.
-        queryKey: mergeFactoryQueryKey(queryKey, undefined, getArgs(options.initialPageParam)),
-    }, callConfig), [
+        // same method with different arguments share one cache entry and serve
+        // each other's pages. `getKeyArgs` narrows them exactly as it does for the
+        // factories, which the bound hook's config type always accepted: it used
+        // to be ignored here, so the cursor stayed in the key, and an
+        // `initialPageParam` that changes every render (`Date.now()`) keyed a new
+        // query on every render — an endless loop of first-page fetches.
+        const initialArgs = getArgs(options.initialPageParam);
+        const keyArgs = getKeyArgs?.(initialArgs) ?? initialArgs;
+        return reactor.generateQueryKey({
+            functionName,
+            queryKey: mergeFactoryQueryKey(queryKey, undefined, keyArgs),
+        }, callConfig);
+    }, [
         queryKey,
         reactor,
         // `canisterId` is mutable reactor state that `setCanisterId` can change,
@@ -35,22 +44,33 @@ export const useActorSuspenseInfiniteQuery = ({ reactor, functionName, getArgs,
         functionName,
         callConfig,
         getArgs,
+        getKeyArgs,
         options.initialPageParam,
     ]);
     // Memoize queryFn to prevent recreation on every render
-    const queryFn = useCallback(async ({ pageParam }) => {
+    const queryFn = useCallback(async ({ pageParam, queryKey: fetchedKey, }) => {
         const args = getArgs(pageParam);
         const result = await reactor.callMethod({
             functionName,
             args,
-            callConfig,
+            callConfig: callConfigForKey(fetchedKey, callConfig),
         });
         return normalizeQueryData(result);
     }, [reactor, functionName, getArgs, callConfig]);
-    return useSuspenseInfiniteQuery({
-        queryKey: baseQueryKey,
-        queryFn,
-        ...options,
-    }, reactor.queryClient);
+    // The method's default `retry`: for an update method, only failures that
+    // prove the canister never ran the call; see `Reactor.getQueryRetry`.
+    const defaultRetry = useMemo(() => reactor.getQueryRetry(functionName, baseQueryKey), [reactor, functionName, baseQueryKey]);
+    try {
+        return useSuspenseInfiniteQuery({
+            queryKey: baseQueryKey,
+            queryFn,
+            ...options,
+            ...retryOption(options.retry, defaultRetry),
+        }, reactor.queryClient);
+    }
+    catch (thrown) {
+        mountWhileSuspended(reactor.queryClient, thrown);
+        throw thrown;
+    }
 };
 //# sourceMappingURL=useActorSuspenseInfiniteQuery.js.map

package/dist/hooks/useActorSuspenseInfiniteQuery.js.map

@@ -1 +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,GAIzB,MAAM,uBAAuB,CAAA;AAW9B,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AA0EtE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAK3C,EACA,OAAO,EACP,YAAY,EACZ,OAAO,EACP,UAAU,EACV,QAAQ,EACR,GAAG,OAAO,EAMX,EAKC,EAAE;IACF,yEAAyE;IACzE,6EAA6E;IAC7E,2EAA2E;IAC3E,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CACH,OAAO,CAAC,gBAAgB,CACtB;QACE,YAAY;QACZ,mEAAmE;QACnE,sEAAsE;QACtE,iEAAiE;QACjE,4BAA4B;QAC5B,QAAQ,EAAE,oBAAoB,CAC5B,QAAQ,EACR,SAAS,EACT,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAClC;KACF,EACD,UAAU,CACX,EACH;QACE,QAAQ;QACR,OAAO;QACP,yEAAyE;QACzE,mEAAmE;QACnE,0EAA0E;QAC1E,+CAA+C;QAC/C,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;QAC9B,YAAY;QACZ,UAAU;QACV,OAAO;QACP,OAAO,CAAC,gBAAgB;KACzB,CACF,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,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;YACtC,YAAY;YACZ,IAAI;YACJ,UAAU;SACX,CAAC,CAAA;QACF,OAAO,kBAAkB,CACvB,MAAqD,CACtD,CAAA;IACH,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,CAMpB,CAAA;AACH,CAAC,CAAA"}
+{"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,GAIzB,MAAM,uBAAuB,CAAA;AAW9B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,aAAa,CAAA;AA4FpB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAS3C,EACA,OAAO,EACP,YAAY,EACZ,OAAO,EACP,UAAU,EACV,UAAU,EACV,QAAQ,EACR,GAAG,OAAO,EAOX,EAMC,EAAE;IACF,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IAExC,yEAAyE;IACzE,6EAA6E;IAC7E,2EAA2E;IAC3E,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE;QAChC,mEAAmE;QACnE,sEAAsE;QACtE,uEAAuE;QACvE,2EAA2E;QAC3E,yEAAyE;QACzE,8DAA8D;QAC9D,0EAA0E;QAC1E,iEAAiE;QACjE,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;QACrD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC,WAAW,CAAC,IAAI,WAAW,CAAA;QAExD,OAAO,OAAO,CAAC,gBAAgB,CAC7B;YACE,YAAY;YACZ,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;SAC7D,EACD,UAAU,CACX,CAAA;IACH,CAAC,EAAE;QACD,QAAQ;QACR,OAAO;QACP,yEAAyE;QACzE,mEAAmE;QACnE,0EAA0E;QAC1E,+CAA+C;QAC/C,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;QAC9B,YAAY;QACZ,UAAU;QACV,OAAO;QACP,UAAU;QACV,OAAO,CAAC,gBAAgB;KACzB,CAAC,CAAA;IAEF,wDAAwD;IACxD,MAAM,OAAO,GAAG,WAAW,CACzB,KAAK,EAAE,EACL,SAAS,EACT,QAAQ,EAAE,UAAU,GAIrB,EAAE,EAAE;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;QAC/B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;YACtC,YAAY;YACZ,IAAI;YACJ,UAAU,EAAE,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC;SACrD,CAAC,CAAA;QACF,OAAO,kBAAkB,CACvB,MAAqD,CACtD,CAAA;IACH,CAAC,EACD,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC,CAC7C,CAAA;IAED,yEAAyE;IACzE,sEAAsE;IACtE,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,EAAE,YAAY,CAAC,EACvD,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,CACtC,CAAA;IAED,IAAI,CAAC;QACH,OAAO,wBAAwB,CAC7B;YACE,QAAQ,EAAE,YAAY;YACtB,OAAO;YACP,GAAG,OAAO;YACV,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC;SACrC,EACR,OAAO,CAAC,WAAW,CAOpB,CAAA;IACH,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,mBAAmB,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;QAChD,MAAM,MAAM,CAAA;IACd,CAAC;AACH,CAAC,CAAA"}

package/dist/hooks/useActorSuspenseQuery.d.ts

@@ -14,14 +14,14 @@ export type UseActorSuspenseQueryResult<Service, Method extends FunctionName<Ser
  * Hook for executing suspense-enabled query calls on a canister.
  *
  * @example
- * const { data } = useActorSuspenseQuery({
+ * const { data } = useReactorSuspenseQuery({
  *   reactor,
  *   functionName: "getUser",
  *   args: ["user-123"],
  * })
  *
  * // With select transformation
- * const { data } = useActorSuspenseQuery({
+ * const { data } = useReactorSuspenseQuery({
  *   reactor,
  *   functionName: "getUser",
  *   args: ["user-123"],

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

@@ -1 +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,EAChB,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,MAAM,WAAW,+BAA+B,CAC9C,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CACxE,SAAQ,IAAI,CACZ,oBAAoB,CAClB,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAC7D,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC5C,QAAQ,EACR,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAC7D,QAAQ,CACT,EACD,UAAU,GAAG,SAAS,CACvB;IACC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;IAC9C,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,MAAM,2BAA2B,CACrC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,IACtE,IAAI,CACN,+BAA+B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EACrE,SAAS,CACV,CAAA;AAED,MAAM,MAAM,2BAA2B,CACrC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,IACtE,sBAAsB,CACxB,QAAQ,EACR,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAC7C,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EACxE,oFAOC,+BAA+B,CAChC,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,CACT,KAAG,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAmCnE,CAAA"}
+{"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,EAChB,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAOhD,MAAM,WAAW,+BAA+B,CAC9C,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CACxE,SAAQ,IAAI,CACZ,oBAAoB,CAClB,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAC7D,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAC5C,QAAQ,EACR,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAC7D,QAAQ,CACT,EACD,UAAU,GAAG,SAAS,CACvB;IACC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;IAC9C,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,MAAM,2BAA2B,CACrC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,IACtE,IAAI,CACN,+BAA+B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EACrE,SAAS,CACV,CAAA;AAED,MAAM,MAAM,2BAA2B,CACrC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,IACtE,sBAAsB,CACxB,QAAQ,EACR,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAC7C,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,EACP,MAAM,SAAS,YAAY,CAAC,OAAO,CAAC,EACpC,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EACxE,oFAOC,+BAA+B,CAChC,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,CACT,KAAG,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CA6CnE,CAAA"}

package/dist/hooks/useActorSuspenseQuery.js

@@ -1,17 +1,18 @@
 import { useMemo } from "react";
 import { useSuspenseQuery, } from "@tanstack/react-query";
+import { mountWhileSuspended, retryOption, useMountQueryClient, } from "../utils.js";
 /**
  * Hook for executing suspense-enabled query calls on a canister.
  *
  * @example
- * const { data } = useActorSuspenseQuery({
+ * const { data } = useReactorSuspenseQuery({
  *   reactor,
  *   functionName: "getUser",
  *   args: ["user-123"],
  * })
  *
  * // With select transformation
- * const { data } = useActorSuspenseQuery({
+ * const { data } = useReactorSuspenseQuery({
  *   reactor,
  *   functionName: "getUser",
  *   args: ["user-123"],
@@ -19,8 +20,11 @@ import { useSuspenseQuery, } from "@tanstack/react-query";
  * })
  */
 export const useActorSuspenseQuery = ({ reactor, functionName, args, callConfig, queryKey: defaultQueryKey, ...options }) => {
+    useMountQueryClient(reactor.queryClient);
     // Memoize query options to prevent unnecessary re-computations
-    const { queryKey, queryFn } = useMemo(() => reactor.getQueryOptions({
+    // For an update method, the options also carry its default `retry`; see
+    // `Reactor.getQueryRetry`.
+    const { queryKey, queryFn, retry } = useMemo(() => reactor.getQueryOptions({
         callConfig,
         functionName,
         args,
@@ -37,11 +41,18 @@ export const useActorSuspenseQuery = ({ reactor, functionName, args, callConfig,
         args,
         defaultQueryKey,
     ]);
-    return useSuspenseQuery({
-        // Suspense queries don't support skipToken, so cast the queryFn
-        queryFn: queryFn,
-        ...options,
-        queryKey,
-    }, reactor.queryClient);
+    try {
+        return useSuspenseQuery({
+            // Suspense queries don't support skipToken, so cast the queryFn
+            queryFn: queryFn,
+            ...options,
+            queryKey,
+            ...retryOption(options.retry, retry),
+        }, reactor.queryClient);
+    }
+    catch (thrown) {
+        mountWhileSuspended(reactor.queryClient, thrown);
+        throw thrown;
+    }
 };
 //# sourceMappingURL=useActorSuspenseQuery.js.map

package/dist/hooks/useActorSuspenseQuery.js.map

@@ -1 +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;AAsD9B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAKnC,EACA,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,QAAQ,EAAE,eAAe,EACzB,GAAG,OAAO,EAMX,EAAqE,EAAE;IACtE,+DAA+D;IAC/D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CACnC,GAAG,EAAE,CACH,OAAO,CAAC,eAAe,CAAS;QAC9B,UAAU;QACV,YAAY;QACZ,IAAI;QACJ,QAAQ,EAAE,eAAe;KAC1B,CAAC;IACJ,yEAAyE;IACzE,mEAAmE;IACnE,2EAA2E;IAC3E;QACE,OAAO;QACP,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;QAC9B,UAAU;QACV,YAAY;QACZ,IAAI;QACJ,eAAe;KAChB,CACF,CAAA;IAED,OAAO,gBAAgB,CACrB;QACE,gEAAgE;QAChE,OAAO,EAAE,OAGR;QACD,GAAG,OAAO;QACV,QAAQ;KACT,EACD,OAAO,CAAC,WAAW,CACpB,CAAA;AACH,CAAC,CAAA"}
+{"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;AAW9B,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,mBAAmB,GACpB,MAAM,aAAa,CAAA;AA4CpB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAKnC,EACA,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,QAAQ,EAAE,eAAe,EACzB,GAAG,OAAO,EAMX,EAAqE,EAAE;IACtE,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IAExC,+DAA+D;IAC/D,wEAAwE;IACxE,2BAA2B;IAC3B,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAC1C,GAAG,EAAE,CACH,OAAO,CAAC,eAAe,CAAS;QAC9B,UAAU;QACV,YAAY;QACZ,IAAI;QACJ,QAAQ,EAAE,eAAe;KAC1B,CAAC;IACJ,yEAAyE;IACzE,mEAAmE;IACnE,2EAA2E;IAC3E;QACE,OAAO;QACP,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;QAC9B,UAAU;QACV,YAAY;QACZ,IAAI;QACJ,eAAe;KAChB,CACF,CAAA;IAED,IAAI,CAAC;QACH,OAAO,gBAAgB,CACrB;YACE,gEAAgE;YAChE,OAAO,EAAE,OAGR;YACD,GAAG,OAAO;YACV,QAAQ;YACR,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrC,EACD,OAAO,CAAC,WAAW,CACpB,CAAA;IACH,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,mBAAmB,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;QAChD,MAAM,MAAM,CAAA;IACd,CAAC;AACH,CAAC,CAAA"}

package/dist/index.d.ts

@@ -3,6 +3,8 @@ export * from "./hooks/index.js";
 export * from "./validation.js";
 export * from "./createActorHooks.js";
 export * from "./defineReactor.js";
+export * from "./defineDisplayReactor.js";
+export * from "./createReactorProvider.js";
 export * from "./createQuery.js";
 export * from "./createSuspenseQuery.js";
 export * from "./createInfiniteQuery.js";
@@ -10,4 +12,6 @@ export * from "./createSuspenseInfiniteQuery.js";
 export * from "./createMutation.js";
 export * from "./auth/index.js";
 export * from "./types.js";
+export { skipToken } from "@tanstack/react-query";
+export type { SkipToken } from "@tanstack/react-query";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,kBAAkB,CAAA;AAGhC,cAAc,kBAAkB,CAAA;AAGhC,cAAc,iBAAiB,CAAA;AAG/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAElC,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kCAAkC,CAAA;AAChD,cAAc,qBAAqB,CAAA;AAEnC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,kBAAkB,CAAA;AAGhC,cAAc,kBAAkB,CAAA;AAGhC,cAAc,iBAAiB,CAAA;AAG/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAE1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kCAAkC,CAAA;AAChD,cAAc,qBAAqB,CAAA;AAEnC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,YAAY,CAAA;AAK1B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/index.js

@@ -8,6 +8,8 @@ export * from "./validation.js";
 // React-specific exports
 export * from "./createActorHooks.js";
 export * from "./defineReactor.js";
+export * from "./defineDisplayReactor.js";
+export * from "./createReactorProvider.js";
 export * from "./createQuery.js";
 export * from "./createSuspenseQuery.js";
 export * from "./createInfiniteQuery.js";
@@ -15,4 +17,8 @@ export * from "./createSuspenseInfiniteQuery.js";
 export * from "./createMutation.js";
 export * from "./auth/index.js";
 export * from "./types.js";
+// TanStack Query's marker for a query whose args are not known yet, which the
+// non-suspense query hooks and createQueryFactory take in place of args. It is
+// the same symbol as @tanstack/react-query's, so either import works.
+export { skipToken } from "@tanstack/react-query";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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,kBAAkB,CAAA;AAEhC,iCAAiC;AACjC,cAAc,iBAAiB,CAAA;AAE/B,yBAAyB;AACzB,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAElC,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kCAAkC,CAAA;AAChD,cAAc,qBAAqB,CAAA;AAEnC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,sFAAsF;AACtF,cAAc,kBAAkB,CAAA;AAEhC,kBAAkB;AAClB,cAAc,kBAAkB,CAAA;AAEhC,iCAAiC;AACjC,cAAc,iBAAiB,CAAA;AAE/B,yBAAyB;AACzB,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAE1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kCAAkC,CAAA;AAChD,cAAc,qBAAqB,CAAA;AAEnC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,YAAY,CAAA;AAE1B,8EAA8E;AAC9E,+EAA+E;AAC/E,sEAAsE;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/ownedAuthentication.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Which `AuthenticationManager`s a `createReactorProvider` value owns, for the
+ * provider to dispose when its tree unmounts. Not part of the public API.
+ *
+ * A value owns the managers built for it: those constructed while its factory
+ * ran, and those a `defineReactor` or `defineDisplayReactor` result in it
+ * builds later, on first use. A manager built elsewhere and handed in, such as
+ * an app-wide one every provider shares, belongs to whoever built it, and
+ * disposing it on each remount would stop its client following the session.
+ *
+ * A result's `authentication` is a getter that builds the manager on first
+ * read, and building one loads the optional `@icp-sdk/auth` peer in a browser.
+ * A provider that read it to release the manager would build one only to
+ * dispose it, for every reactor whose tree never signed in. Each result
+ * registers a reader here instead, which answers without building anything.
+ *
+ * Kept apart from `defineReactorShared.ts` so that the provider does not pull
+ * that module's reactor setup into an app that builds its reactors by hand.
+ */
+import type { AuthenticationManager } from "./auth/authentication-manager.js";
+/**
+ * Records how to read the manager `owner` built, once it has built one.
+ *
+ * @internal
+ */
+export declare function registerAuthentication(owner: object, read: () => AuthenticationManager | undefined): void;
+/**
+ * The manager a registered result built, or `undefined` for one that has not
+ * built one yet, for one that was handed a manager, and for anything that was
+ * never registered.
+ *
+ * @internal
+ */
+export declare function authenticationOf(owner: object): AuthenticationManager | undefined;
+/**
+ * Called by each `AuthenticationManager` as it is constructed.
+ *
+ * @internal
+ */
+export declare function recordAuthentication(manager: AuthenticationManager): void;
+/**
+ * Runs `build` and returns what it returned, with every manager constructed
+ * while it ran. `build` runs synchronously, so a server rendering several
+ * requests at once cannot interleave another request's managers.
+ *
+ * @internal
+ */
+export declare function collectAuthentication<T>(build: () => T): {
+    value: T;
+    built: AuthenticationManager[];
+};
+//# sourceMappingURL=ownedAuthentication.d.ts.map

package/dist/ownedAuthentication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownedAuthentication.d.ts","sourceRoot":"","sources":["../src/ownedAuthentication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAO7E;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,qBAAqB,GAAG,SAAS,GAC5C,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GACZ,qBAAqB,GAAG,SAAS,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG;IACxD,KAAK,EAAE,CAAC,CAAA;IACR,KAAK,EAAE,qBAAqB,EAAE,CAAA;CAC/B,CAUA"}

package/dist/ownedAuthentication.js

@@ -0,0 +1,49 @@
+const readers = new WeakMap();
+/** The managers constructed during a running {@link collectAuthentication}. */
+let collecting;
+/**
+ * Records how to read the manager `owner` built, once it has built one.
+ *
+ * @internal
+ */
+export function registerAuthentication(owner, read) {
+    readers.set(owner, read);
+}
+/**
+ * The manager a registered result built, or `undefined` for one that has not
+ * built one yet, for one that was handed a manager, and for anything that was
+ * never registered.
+ *
+ * @internal
+ */
+export function authenticationOf(owner) {
+    return readers.get(owner)?.();
+}
+/**
+ * Called by each `AuthenticationManager` as it is constructed.
+ *
+ * @internal
+ */
+export function recordAuthentication(manager) {
+    collecting?.add(manager);
+}
+/**
+ * Runs `build` and returns what it returned, with every manager constructed
+ * while it ran. `build` runs synchronously, so a server rendering several
+ * requests at once cannot interleave another request's managers.
+ *
+ * @internal
+ */
+export function collectAuthentication(build) {
+    const outer = collecting;
+    const built = new Set();
+    collecting = built;
+    try {
+        const value = build();
+        return { value, built: [...built] };
+    }
+    finally {
+        collecting = outer;
+    }
+}
+//# sourceMappingURL=ownedAuthentication.js.map

package/dist/ownedAuthentication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownedAuthentication.js","sourceRoot":"","sources":["../src/ownedAuthentication.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,GAAG,IAAI,OAAO,EAAmD,CAAA;AAE9E,+EAA+E;AAC/E,IAAI,UAAkD,CAAA;AAEtD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAa,EACb,IAA6C;IAE7C,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa;IAEb,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAA;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAI,KAAc;IAIrD,MAAM,KAAK,GAAG,UAAU,CAAA;IACxB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAA;IAC9C,UAAU,GAAG,KAAK,CAAA;IAClB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,EAAE,CAAA;QACrB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,CAAA;IACrC,CAAC;YAAS,CAAC;QACT,UAAU,GAAG,KAAK,CAAA;IACpB,CAAC;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The `react-server` entry of `@ic-reactor/react`.
+ *
+ * React Server Components are bundled with the `react-server` export
+ * condition, and `package.json` routes that condition here instead of to
+ * `index.ts`. The main entry also loads every hook, and a bundler rejects a
+ * hook import anywhere in the server graph, so a server component that
+ * imported only `Reactor` from it failed to build.
+ *
+ * This entry carries the core runtime (`Reactor`, `DisplayReactor`,
+ * `ClientManager`, the error classes and utilities) and the framework-free
+ * validation helpers, and nothing that imports React. A hook or a hook factory
+ * imported in a server component is therefore a missing export at build time,
+ * which is the error to get: those only run in a `"use client"` module.
+ *
+ * TypeScript does not read the `react-server` condition, so types still come
+ * from the main entry.
+ */
+export * from "@ic-reactor/core";
+export * from "./validation.js";
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAc,kBAAkB,CAAA;AAIhC,cAAc,iBAAiB,CAAA"}

package/dist/server.js

@@ -0,0 +1,23 @@
+/**
+ * The `react-server` entry of `@ic-reactor/react`.
+ *
+ * React Server Components are bundled with the `react-server` export
+ * condition, and `package.json` routes that condition here instead of to
+ * `index.ts`. The main entry also loads every hook, and a bundler rejects a
+ * hook import anywhere in the server graph, so a server component that
+ * imported only `Reactor` from it failed to build.
+ *
+ * This entry carries the core runtime (`Reactor`, `DisplayReactor`,
+ * `ClientManager`, the error classes and utilities) and the framework-free
+ * validation helpers, and nothing that imports React. A hook or a hook factory
+ * imported in a server component is therefore a missing export at build time,
+ * which is the error to get: those only run in a `"use client"` module.
+ *
+ * TypeScript does not read the `react-server` condition, so types still come
+ * from the main entry.
+ */
+export * from "@ic-reactor/core";
+// Plain functions over `ValidationError`, useful in a server action that maps
+// a rejected call onto form field errors.
+export * from "./validation.js";
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAc,kBAAkB,CAAA;AAEhC,8EAA8E;AAC9E,0CAA0C;AAC1C,cAAc,iBAAiB,CAAA"}

package/dist/testing.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@ic-reactor/react/testing`: the testing utilities of
+ * `@ic-reactor/core/testing`, re-exported for an app that depends on
+ * `@ic-reactor/react` alone. The main entry re-exports `@ic-reactor/core` the
+ * same way, but a package manager that installs strictly does not let such an
+ * app import `@ic-reactor/core/testing` itself.
+ *
+ * Nothing here imports React, and neither the main entry nor the
+ * `react-server` entry imports this one, so none of it reaches an app bundle.
+ *
+ * @example
+ * ```typescript
+ * import { createTestCanister, installFakeReplica } from "@ic-reactor/react/testing"
+ * ```
+ *
+ * @packageDocumentation
+ */
+export * from "@ic-reactor/core/testing";
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,cAAc,0BAA0B,CAAA"}

package/dist/testing.js

@@ -0,0 +1,19 @@
+/**
+ * `@ic-reactor/react/testing`: the testing utilities of
+ * `@ic-reactor/core/testing`, re-exported for an app that depends on
+ * `@ic-reactor/react` alone. The main entry re-exports `@ic-reactor/core` the
+ * same way, but a package manager that installs strictly does not let such an
+ * app import `@ic-reactor/core/testing` itself.
+ *
+ * Nothing here imports React, and neither the main entry nor the
+ * `react-server` entry imports this one, so none of it reaches an app bundle.
+ *
+ * @example
+ * ```typescript
+ * import { createTestCanister, installFakeReplica } from "@ic-reactor/react/testing"
+ * ```
+ *
+ * @packageDocumentation
+ */
+export * from "@ic-reactor/core/testing";
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,cAAc,0BAA0B,CAAA"}