@ttt-productions/query-core 0.14.31 → 0.14.33

package/dist/react/callables/create-callables.d.ts

@@ -7,6 +7,10 @@ export interface CallableErrorRouting {
     isAnswerSurfacedByCaller?: (error: unknown) => boolean;
 }
 export type CallableCaptureContext = Record<string, unknown>;
+export interface SlowCallNotice {
+    afterMs: number;
+    show: (context: CallableCaptureContext) => () => void;
+}
 export interface CallablePolicy {
     getFunctions: FunctionsProvider;
     timeoutMs: number;
@@ -14,6 +18,7 @@ export interface CallablePolicy {
     captureFault: (error: unknown, context: CallableCaptureContext) => void;
     captureRecoveredFallback: (error: unknown, context: CallableCaptureContext) => void;
     onActionError: (error: unknown, routing: CallableErrorRouting) => void;
+    onSlowCall: SlowCallNotice;
 }
 export interface CallableDeclaration {
     limitedUseAppCheck?: true;

package/dist/react/callables/create-callables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-callables.d.ts","sourceRoot":"","sources":["../../../src/react/callables/create-callables.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACxD,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACxD;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,iBAAiB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC;IAC3D,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACxE,wBAAwB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACpF,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,CAAC,EAAE,IAAI,CAAC;CAC3B;AAED,UAAU,wBAAyB,SAAQ,OAAO,CAAC,oBAAoB,CAAC;IACtE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,IAAI,IAAI,CACpF,sBAAsB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,EAC/D,YAAY,GAAG,OAAO,CACvB,GACC,IAAI,CACF,wBAAwB,EACxB,gBAAgB,GAAG,kBAAkB,GAAG,0BAA0B,GAAG,eAAe,CACrF,CAAC;AAEJ,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,MAAM,MAAM,gBAAgB,CAAC,OAAO,IAAI,OAAO,GAAG;IAAE,YAAY,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE,CAAC;AAEjF,MAAM,WAAW,SAAS;IACxB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAChC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,mBAAmB,GAChC,CAAC,eAAe,GAAG,OAAO,EAC3B,OAAO,CAAC,EAAE,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,KAChE,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IACpE,2BAA2B,CAAC,MAAM,EAAE,OAAO,SAAS;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,EACvE,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,EACpD,WAAW,CAAC,EAAE,mBAAmB,GAChC,CAAC,eAAe,GAAG,OAAO,EAC3B,OAAO,CAAC,EAAE,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,KAClF,qBAAqB,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IACtF,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAClC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,mBAAmB,GAChC,MAAM,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,qBAAqB,CAAC,MAAM,EAAE,OAAO,EACnC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,mBAAmB,GAChC,MAAM,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C;AAOD,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAuJjE"}
+{"version":3,"file":"create-callables.d.ts","sourceRoot":"","sources":["../../../src/react/callables/create-callables.ts"],"names":[],"mappings":"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"}

package/dist/react/callables/create-callables.js

@@ -4,11 +4,24 @@ import { callCallable, isRecoveredFallbackReport, } from '@ttt-productions/fireb
 import { useMutationSessionCapture, useSessionMutation, } from '../session-mutation.js';
 export const MAX_RESUMABLE_CALLS = 12;
 export function createCallables(policy) {
+    function withSlowCallNotice(pending, functionName, session) {
+        let dismiss;
+        const timer = setTimeout(() => {
+            if (session.isCurrent())
+                dismiss = policy.onSlowCall.show({ functionName });
+        }, policy.onSlowCall.afterMs);
+        const settle = () => {
+            clearTimeout(timer);
+            dismiss?.();
+        };
+        pending.then(settle, settle);
+        return pending;
+    }
     function useCallableTransport(functionName, declaration, options) {
         const optionsRef = useRef(options);
         optionsRef.current = options;
         const limitedUseAppCheck = policy.resolveLimitedUseAppCheck(declaration.limitedUseAppCheck === true);
-        return useCallback((input, session) => callCallable(policy.getFunctions, functionName, input, {
+        return useCallback((input, session) => withSlowCallNotice(callCallable(policy.getFunctions, functionName, input, {
             captureException: (error, context) => {
                 if (optionsRef.current.captureFaults !== false)
                     policy.captureFault(error, context);
@@ -25,7 +38,7 @@ export function createCallables(policy) {
                     isAnswerSurfacedByCaller,
                 });
             },
-        }, { timeoutMs: policy.timeoutMs, limitedUseAppCheck }), [functionName, limitedUseAppCheck]);
+        }, { timeoutMs: policy.timeoutMs, limitedUseAppCheck }), functionName, session), [functionName, limitedUseAppCheck]);
     }
     function useSessionBoundCall(call) {
         const captureSession = useMutationSessionCapture();

package/dist/react/callables/create-callables.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-callables.js","sourceRoot":"","sources":["../../../src/react/callables/create-callables.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useCallback, useMemo, useRef } from 'react';\nimport type { ExpectedCallableAnswerCode } from '@ttt-productions/firebase-helpers';\nimport {\n  callCallable,\n  isRecoveredFallbackReport,\n  type FunctionsProvider,\n} from '@ttt-productions/firebase-helpers/client';\nimport {\n  useMutationSessionCapture,\n  useSessionMutation,\n  type MutationSession,\n  type SessionMutationOptions,\n  type SessionMutationResult,\n} from '../session-mutation.js';\n\nexport interface CallableErrorRouting {\n  showErrorToast: boolean;\n  answeredRefusals: readonly ExpectedCallableAnswerCode[];\n  isAnswerSurfacedByCaller?: (error: unknown) => boolean;\n}\n\nexport type CallableCaptureContext = Record<string, unknown>;\n\nexport interface CallablePolicy {\n  getFunctions: FunctionsProvider;\n  timeoutMs: number;\n  resolveLimitedUseAppCheck: (requested: boolean) => boolean;\n  captureFault: (error: unknown, context: CallableCaptureContext) => void;\n  captureRecoveredFallback: (error: unknown, context: CallableCaptureContext) => void;\n  onActionError: (error: unknown, routing: CallableErrorRouting) => void;\n}\n\nexport interface CallableDeclaration {\n  limitedUseAppCheck?: true;\n}\n\ninterface CallableTransportOptions extends Partial<CallableErrorRouting> {\n  captureFaults?: boolean;\n}\n\nexport type CallableMutationOptions<TInput, TResult, TOnMutateResult = unknown> = Omit<\n  SessionMutationOptions<TResult, Error, TInput, TOnMutateResult>,\n  'mutationFn' | 'retry'\n> &\n  Pick<\n    CallableTransportOptions,\n    'showErrorToast' | 'answeredRefusals' | 'isAnswerSurfacedByCaller' | 'captureFaults'\n  >;\n\nexport const MAX_RESUMABLE_CALLS = 12;\n\nexport type ResumableOutcome<TResult> = TResult & { interruption: Error | null };\n\nexport interface Callables {\n  createCallableHook<TInput, TResult>(\n    functionName: string,\n    declaration?: CallableDeclaration,\n  ): <TOnMutateResult = unknown>(\n    options?: CallableMutationOptions<TInput, TResult, TOnMutateResult>,\n  ) => SessionMutationResult<TResult, Error, TInput, TOnMutateResult>;\n  createResumableCallableHook<TInput, TResult extends { complete: boolean }>(\n    functionName: string,\n    merge: (earlier: TResult, later: TResult) => TResult,\n    declaration?: CallableDeclaration,\n  ): <TOnMutateResult = unknown>(\n    options?: CallableMutationOptions<TInput, ResumableOutcome<TResult>, TOnMutateResult>,\n  ) => SessionMutationResult<ResumableOutcome<TResult>, Error, TInput, TOnMutateResult>;\n  createCallableReader<TInput, TResult>(\n    functionName: string,\n    declaration?: CallableDeclaration,\n  ): () => (input: TInput) => Promise<TResult>;\n  createCallableInvoker<TInput, TResult>(\n    functionName: string,\n    declaration?: CallableDeclaration,\n  ): () => (input: TInput) => Promise<TResult>;\n}\n\ntype CallableTransport = <TInput, TResult>(\n  input: TInput,\n  session: MutationSession,\n) => Promise<TResult>;\n\nexport function createCallables(policy: CallablePolicy): Callables {\n  function useCallableTransport(\n    functionName: string,\n    declaration: CallableDeclaration,\n    options: CallableTransportOptions,\n  ): CallableTransport {\n    const optionsRef = useRef(options);\n    optionsRef.current = options;\n    const limitedUseAppCheck = policy.resolveLimitedUseAppCheck(\n      declaration.limitedUseAppCheck === true,\n    );\n\n    return useCallback(\n      <TInput, TResult>(input: TInput, session: MutationSession) =>\n        callCallable<TInput, TResult>(\n          policy.getFunctions,\n          functionName,\n          input,\n          {\n            captureException: (error, context) => {\n              if (optionsRef.current.captureFaults !== false) policy.captureFault(error, context);\n              else if (isRecoveredFallbackReport(context))\n                policy.captureRecoveredFallback(error, context);\n            },\n            onError: (error) => {\n              if (!session.isCurrent()) return;\n              const {\n                showErrorToast = true,\n                answeredRefusals = [],\n                isAnswerSurfacedByCaller,\n              } = optionsRef.current;\n              policy.onActionError(error, {\n                showErrorToast,\n                answeredRefusals,\n                isAnswerSurfacedByCaller,\n              });\n            },\n          },\n          { timeoutMs: policy.timeoutMs, limitedUseAppCheck },\n        ),\n      [functionName, limitedUseAppCheck],\n    );\n  }\n\n  function useSessionBoundCall<TInput, TResult>(\n    call: CallableTransport,\n  ): (input: TInput) => Promise<TResult> {\n    const captureSession = useMutationSessionCapture();\n    return useMemo(\n      () => (input: TInput) => call<TInput, TResult>(input, captureSession()),\n      [call, captureSession],\n    );\n  }\n\n  return {\n    createCallableHook<TInput, TResult>(\n      functionName: string,\n      declaration: CallableDeclaration = {},\n    ) {\n      return function useNamedCallable<TOnMutateResult = unknown>(\n        options: CallableMutationOptions<TInput, TResult, TOnMutateResult> = {},\n      ): SessionMutationResult<TResult, Error, TInput, TOnMutateResult> {\n        const {\n          showErrorToast,\n          answeredRefusals,\n          isAnswerSurfacedByCaller,\n          captureFaults,\n          ...mutationOptions\n        } = options;\n        const call = useCallableTransport(functionName, declaration, {\n          showErrorToast,\n          answeredRefusals,\n          isAnswerSurfacedByCaller,\n          captureFaults,\n        });\n        // `retry: false` comes last so nothing overrides it: a deadline expiry is an unknown outcome,\n        // and a retry after a committed first attempt writes twice.\n        return useSessionMutation<TResult, Error, TInput, TOnMutateResult>({\n          ...mutationOptions,\n          retry: false,\n          mutationFn: (input, { session }) => call<TInput, TResult>(input, session),\n        });\n      };\n    },\n\n    createResumableCallableHook<TInput, TResult extends { complete: boolean }>(\n      functionName: string,\n      merge: (earlier: TResult, later: TResult) => TResult,\n      declaration: CallableDeclaration = {},\n    ) {\n      return function useNamedResumableCallable<TOnMutateResult = unknown>(\n        options: CallableMutationOptions<TInput, ResumableOutcome<TResult>, TOnMutateResult> = {},\n      ): SessionMutationResult<ResumableOutcome<TResult>, Error, TInput, TOnMutateResult> {\n        const {\n          showErrorToast,\n          answeredRefusals,\n          isAnswerSurfacedByCaller,\n          captureFaults,\n          ...mutationOptions\n        } = options;\n        const call = useCallableTransport(functionName, declaration, {\n          showErrorToast,\n          answeredRefusals,\n          isAnswerSurfacedByCaller,\n          captureFaults,\n        });\n        return useSessionMutation<ResumableOutcome<TResult>, Error, TInput, TOnMutateResult>({\n          ...mutationOptions,\n          retry: false,\n          mutationFn: async (input, { session }): Promise<ResumableOutcome<TResult>> => {\n            let progress = await call<TInput, TResult>(input, session);\n            for (let calls = 1; !progress.complete && calls < MAX_RESUMABLE_CALLS; calls += 1) {\n              session.assertCurrent();\n              let later: TResult;\n              try {\n                later = await call<TInput, TResult>(input, session);\n              } catch (error) {\n                const interruption = error instanceof Error ? error : new Error(String(error));\n                return { ...progress, complete: false, interruption };\n              }\n              progress = merge(progress, later);\n            }\n            return { ...progress, interruption: null };\n          },\n        });\n      };\n    },\n\n    createCallableReader<TInput, TResult>(\n      functionName: string,\n      declaration: CallableDeclaration = {},\n    ) {\n      return function useNamedCallableReader(): (input: TInput) => Promise<TResult> {\n        const call = useCallableTransport(functionName, declaration, {\n          showErrorToast: false,\n          captureFaults: false,\n        });\n        return useSessionBoundCall<TInput, TResult>(call);\n      };\n    },\n\n    createCallableInvoker<TInput, TResult>(\n      functionName: string,\n      declaration: CallableDeclaration = {},\n    ) {\n      return function useNamedCallableInvoker(): (input: TInput) => Promise<TResult> {\n        const call = useCallableTransport(functionName, declaration, {});\n        return useSessionBoundCall<TInput, TResult>(call);\n      };\n    },\n  };\n}\n"]}
+{"version":3,"file":"create-callables.js","sourceRoot":"","sources":["../../../src/react/callables/create-callables.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useCallback, useMemo, useRef } from 'react';\nimport type { ExpectedCallableAnswerCode } from '@ttt-productions/firebase-helpers';\nimport {\n  callCallable,\n  isRecoveredFallbackReport,\n  type FunctionsProvider,\n} from '@ttt-productions/firebase-helpers/client';\nimport {\n  useMutationSessionCapture,\n  useSessionMutation,\n  type MutationSession,\n  type SessionMutationOptions,\n  type SessionMutationResult,\n} from '../session-mutation.js';\n\nexport interface CallableErrorRouting {\n  showErrorToast: boolean;\n  answeredRefusals: readonly ExpectedCallableAnswerCode[];\n  isAnswerSurfacedByCaller?: (error: unknown) => boolean;\n}\n\nexport type CallableCaptureContext = Record<string, unknown>;\n\nexport interface SlowCallNotice {\n  afterMs: number;\n  show: (context: CallableCaptureContext) => () => void;\n}\n\nexport interface CallablePolicy {\n  getFunctions: FunctionsProvider;\n  timeoutMs: number;\n  resolveLimitedUseAppCheck: (requested: boolean) => boolean;\n  captureFault: (error: unknown, context: CallableCaptureContext) => void;\n  captureRecoveredFallback: (error: unknown, context: CallableCaptureContext) => void;\n  onActionError: (error: unknown, routing: CallableErrorRouting) => void;\n  onSlowCall: SlowCallNotice;\n}\n\nexport interface CallableDeclaration {\n  limitedUseAppCheck?: true;\n}\n\ninterface CallableTransportOptions extends Partial<CallableErrorRouting> {\n  captureFaults?: boolean;\n}\n\nexport type CallableMutationOptions<TInput, TResult, TOnMutateResult = unknown> = Omit<\n  SessionMutationOptions<TResult, Error, TInput, TOnMutateResult>,\n  'mutationFn' | 'retry'\n> &\n  Pick<\n    CallableTransportOptions,\n    'showErrorToast' | 'answeredRefusals' | 'isAnswerSurfacedByCaller' | 'captureFaults'\n  >;\n\nexport const MAX_RESUMABLE_CALLS = 12;\n\nexport type ResumableOutcome<TResult> = TResult & { interruption: Error | null };\n\nexport interface Callables {\n  createCallableHook<TInput, TResult>(\n    functionName: string,\n    declaration?: CallableDeclaration,\n  ): <TOnMutateResult = unknown>(\n    options?: CallableMutationOptions<TInput, TResult, TOnMutateResult>,\n  ) => SessionMutationResult<TResult, Error, TInput, TOnMutateResult>;\n  createResumableCallableHook<TInput, TResult extends { complete: boolean }>(\n    functionName: string,\n    merge: (earlier: TResult, later: TResult) => TResult,\n    declaration?: CallableDeclaration,\n  ): <TOnMutateResult = unknown>(\n    options?: CallableMutationOptions<TInput, ResumableOutcome<TResult>, TOnMutateResult>,\n  ) => SessionMutationResult<ResumableOutcome<TResult>, Error, TInput, TOnMutateResult>;\n  createCallableReader<TInput, TResult>(\n    functionName: string,\n    declaration?: CallableDeclaration,\n  ): () => (input: TInput) => Promise<TResult>;\n  createCallableInvoker<TInput, TResult>(\n    functionName: string,\n    declaration?: CallableDeclaration,\n  ): () => (input: TInput) => Promise<TResult>;\n}\n\ntype CallableTransport = <TInput, TResult>(\n  input: TInput,\n  session: MutationSession,\n) => Promise<TResult>;\n\nexport function createCallables(policy: CallablePolicy): Callables {\n  function withSlowCallNotice<TResult>(\n    pending: Promise<TResult>,\n    functionName: string,\n    session: MutationSession,\n  ): Promise<TResult> {\n    let dismiss: (() => void) | undefined;\n    const timer = setTimeout(() => {\n      if (session.isCurrent()) dismiss = policy.onSlowCall.show({ functionName });\n    }, policy.onSlowCall.afterMs);\n    const settle = () => {\n      clearTimeout(timer);\n      dismiss?.();\n    };\n    pending.then(settle, settle);\n    return pending;\n  }\n\n  function useCallableTransport(\n    functionName: string,\n    declaration: CallableDeclaration,\n    options: CallableTransportOptions,\n  ): CallableTransport {\n    const optionsRef = useRef(options);\n    optionsRef.current = options;\n    const limitedUseAppCheck = policy.resolveLimitedUseAppCheck(\n      declaration.limitedUseAppCheck === true,\n    );\n\n    return useCallback(\n      <TInput, TResult>(input: TInput, session: MutationSession) =>\n        withSlowCallNotice(\n          callCallable<TInput, TResult>(\n            policy.getFunctions,\n            functionName,\n            input,\n            {\n              captureException: (error, context) => {\n                if (optionsRef.current.captureFaults !== false) policy.captureFault(error, context);\n                else if (isRecoveredFallbackReport(context))\n                  policy.captureRecoveredFallback(error, context);\n              },\n              onError: (error) => {\n                if (!session.isCurrent()) return;\n                const {\n                  showErrorToast = true,\n                  answeredRefusals = [],\n                  isAnswerSurfacedByCaller,\n                } = optionsRef.current;\n                policy.onActionError(error, {\n                  showErrorToast,\n                  answeredRefusals,\n                  isAnswerSurfacedByCaller,\n                });\n              },\n            },\n            { timeoutMs: policy.timeoutMs, limitedUseAppCheck },\n          ),\n          functionName,\n          session,\n        ),\n      [functionName, limitedUseAppCheck],\n    );\n  }\n\n  function useSessionBoundCall<TInput, TResult>(\n    call: CallableTransport,\n  ): (input: TInput) => Promise<TResult> {\n    const captureSession = useMutationSessionCapture();\n    return useMemo(\n      () => (input: TInput) => call<TInput, TResult>(input, captureSession()),\n      [call, captureSession],\n    );\n  }\n\n  return {\n    createCallableHook<TInput, TResult>(\n      functionName: string,\n      declaration: CallableDeclaration = {},\n    ) {\n      return function useNamedCallable<TOnMutateResult = unknown>(\n        options: CallableMutationOptions<TInput, TResult, TOnMutateResult> = {},\n      ): SessionMutationResult<TResult, Error, TInput, TOnMutateResult> {\n        const {\n          showErrorToast,\n          answeredRefusals,\n          isAnswerSurfacedByCaller,\n          captureFaults,\n          ...mutationOptions\n        } = options;\n        const call = useCallableTransport(functionName, declaration, {\n          showErrorToast,\n          answeredRefusals,\n          isAnswerSurfacedByCaller,\n          captureFaults,\n        });\n        // `retry: false` comes last so nothing overrides it: a deadline expiry is an unknown outcome,\n        // and a retry after a committed first attempt writes twice.\n        return useSessionMutation<TResult, Error, TInput, TOnMutateResult>({\n          ...mutationOptions,\n          retry: false,\n          mutationFn: (input, { session }) => call<TInput, TResult>(input, session),\n        });\n      };\n    },\n\n    createResumableCallableHook<TInput, TResult extends { complete: boolean }>(\n      functionName: string,\n      merge: (earlier: TResult, later: TResult) => TResult,\n      declaration: CallableDeclaration = {},\n    ) {\n      return function useNamedResumableCallable<TOnMutateResult = unknown>(\n        options: CallableMutationOptions<TInput, ResumableOutcome<TResult>, TOnMutateResult> = {},\n      ): SessionMutationResult<ResumableOutcome<TResult>, Error, TInput, TOnMutateResult> {\n        const {\n          showErrorToast,\n          answeredRefusals,\n          isAnswerSurfacedByCaller,\n          captureFaults,\n          ...mutationOptions\n        } = options;\n        const call = useCallableTransport(functionName, declaration, {\n          showErrorToast,\n          answeredRefusals,\n          isAnswerSurfacedByCaller,\n          captureFaults,\n        });\n        return useSessionMutation<ResumableOutcome<TResult>, Error, TInput, TOnMutateResult>({\n          ...mutationOptions,\n          retry: false,\n          mutationFn: async (input, { session }): Promise<ResumableOutcome<TResult>> => {\n            let progress = await call<TInput, TResult>(input, session);\n            for (let calls = 1; !progress.complete && calls < MAX_RESUMABLE_CALLS; calls += 1) {\n              session.assertCurrent();\n              let later: TResult;\n              try {\n                later = await call<TInput, TResult>(input, session);\n              } catch (error) {\n                const interruption = error instanceof Error ? error : new Error(String(error));\n                return { ...progress, complete: false, interruption };\n              }\n              progress = merge(progress, later);\n            }\n            return { ...progress, interruption: null };\n          },\n        });\n      };\n    },\n\n    createCallableReader<TInput, TResult>(\n      functionName: string,\n      declaration: CallableDeclaration = {},\n    ) {\n      return function useNamedCallableReader(): (input: TInput) => Promise<TResult> {\n        const call = useCallableTransport(functionName, declaration, {\n          showErrorToast: false,\n          captureFaults: false,\n        });\n        return useSessionBoundCall<TInput, TResult>(call);\n      };\n    },\n\n    createCallableInvoker<TInput, TResult>(\n      functionName: string,\n      declaration: CallableDeclaration = {},\n    ) {\n      return function useNamedCallableInvoker(): (input: TInput) => Promise<TResult> {\n        const call = useCallableTransport(functionName, declaration, {});\n        return useSessionBoundCall<TInput, TResult>(call);\n      };\n    },\n  };\n}\n"]}

package/dist/react/index.d.ts

@@ -31,9 +31,9 @@ export { useReadRetryState, useReadRetryStates } from './use-read-retry-state.js
 export type { ReadRetryEntry } from './use-read-retry-state.js';
 export type { ReadRetrySource, ReadRetryState } from './read-retry-derivation.js';
 export { MutationSessionProvider, MutationSessionEndedError, useSessionMutation, } from './session-mutation.js';
-export type { MutationSession, MutationSessionProviderProps, SessionMutateOptions, SessionMutationFunctionContext, SessionMutationOptions, SessionMutationResult, UnknownOutcomePolicy, } from './session-mutation.js';
+export type { LiveSessionSource, MutationSession, MutationSessionProviderProps, SessionMutateOptions, SessionMutationFunctionContext, SessionMutationOptions, SessionMutationResult, UnknownOutcomePolicy, } from './session-mutation.js';
 export { createCallables, MAX_RESUMABLE_CALLS } from './callables/create-callables.js';
-export type { CallableCaptureContext, CallableDeclaration, CallableErrorRouting, CallableMutationOptions, CallablePolicy, Callables, ResumableOutcome, } from './callables/create-callables.js';
+export type { CallableCaptureContext, CallableDeclaration, CallableErrorRouting, CallableMutationOptions, CallablePolicy, Callables, ResumableOutcome, SlowCallNotice, } from './callables/create-callables.js';
 export { usePendingMutationVariables, pendingMutationVariables, usePendingMutationTargets, hasPendingMutation, duplicateSubmissionError, useDuplicateGuardedMutation, } from './pending-mutations.js';
 export { APP_CONFIG_BACKGROUND_RETRY_MS, APP_CONFIG_MAX_QUICK_ATTEMPTS, createAppConfig, } from './app-config/create-app-config.js';
 export type { AppConfig, AppConfigDefinition, AppConfigLeverOf, AppConfigSnapshotState, AppConfigState, AppConfigStatus, StoredAppConfig, } from './app-config/create-app-config.js';

package/dist/react/index.d.ts.map

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

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAGtF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAM7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAClG,OAAO,EACL,KAAK,EACL,MAAM,EACN,SAAS,EACT,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,uCAAuC,CAAC;AAW/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAYjD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG5F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAIlF,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAW/B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAWvF,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,eAAe,GAChB,MAAM,mCAAmC,CAAC","sourcesContent":["'use client';\n\nexport { createQueryClient } from './query-client.js';\nexport type { CreateQueryClientOptions } from './query-client.js';\n\nexport { QueryProvider } from './provider.js';\nexport type { QueryProviderProps } from './provider.js';\n\nexport { FirestoreProvider, useFirestoreDb } from './firestore/context.js';\nexport type { FirestoreProviderProps } from './firestore/context.js';\n\nexport { useFirestoreDoc } from './firestore/use-firestore-doc.js';\nexport { useFirestoreCollection } from './firestore/use-firestore-collection.js';\nexport { useFirestoreInfinite } from './firestore/use-firestore-infinite.js';\nexport { useFirestorePaginated } from './firestore/use-firestore-paginated.js';\nexport type { UseFirestorePaginatedResult } from './firestore/use-firestore-paginated.js';\nexport { useFirestoreCount } from './firestore/use-firestore-count.js';\nexport { useFirestoreLiveInfinite } from './firestore/use-firestore-live-infinite.js';\nexport type { FirestoreLiveInfiniteResult } from './firestore/use-firestore-live-infinite.js';\n\nexport {\n  useFirestoreSet,\n  useFirestoreUpdate,\n  useFirestoreDelete,\n  useFirestoreBatch,\n} from './firestore/use-firestore-mutations.js';\n\nexport { useBatchFirestoreDocs } from './firestore/useBatchFirestoreDocs.js';\nexport type {\n  BatchFirestoreDocsOptions,\n  BatchFirestoreDocsResult,\n  BatchFirestoreDocsTransport,\n} from './firestore/useBatchFirestoreDocs.js';\nexport { ABSENT_RETRY_DELAYS_MS } from './firestore/absence-scheduler.js';\n\nexport { useFirestoreSearch } from './search/use-firestore-search.js';\n\nexport {\n  invalidateByPrefix,\n  removeByPrefix,\n  updateQueryData,\n  paginatedPageKey,\n  mapPaginatedItems,\n  prependToFirstPaginatedPage,\n  placeRowInPages,\n} from './cache-helpers.js';\nexport type { PagedRows } from './cache-helpers.js';\n\nexport { createDomainEventInvalidator } from './domain-events/create-domain-event-invalidator.js';\nexport {\n  exact,\n  prefix,\n  predicate,\n  serializeInvalidation,\n  applyInvalidations,\n} from './domain-events/cache-invalidation.js';\nexport type {\n  DomainEventInvalidator,\n  DomainEventInvalidationRegistry,\n} from './domain-events/create-domain-event-invalidator.js';\nexport type {\n  CacheAction,\n  CacheInvalidation,\n  RefetchType,\n} from './domain-events/cache-invalidation.js';\n\nexport { docWithId } from './firestore/types.js';\nexport type {\n  FirestoreDocOptions,\n  FirestoreCollectionOptions,\n  FirestoreInfiniteOptions,\n  FirestorePaginatedOptions,\n  FirestoreCountOptions,\n  FirestoreLiveInfiniteOptions,\n  InfinitePage,\n  PaginatedPage,\n  MutationOperation,\n} from './firestore/types.js';\nexport { flattenInfiniteData, getInfiniteDataCount } from './firestore/infinite-helpers.js';\nexport type { FirestoreSearchOptions } from './search/types.js';\n\nexport { useReadRetryState, useReadRetryStates } from './use-read-retry-state.js';\nexport type { ReadRetryEntry } from './use-read-retry-state.js';\nexport type { ReadRetrySource, ReadRetryState } from './read-retry-derivation.js';\n\nexport {\n  MutationSessionProvider,\n  MutationSessionEndedError,\n  useSessionMutation,\n} from './session-mutation.js';\nexport type {\n  MutationSession,\n  MutationSessionProviderProps,\n  SessionMutateOptions,\n  SessionMutationFunctionContext,\n  SessionMutationOptions,\n  SessionMutationResult,\n  UnknownOutcomePolicy,\n} from './session-mutation.js';\n\nexport { createCallables, MAX_RESUMABLE_CALLS } from './callables/create-callables.js';\nexport type {\n  CallableCaptureContext,\n  CallableDeclaration,\n  CallableErrorRouting,\n  CallableMutationOptions,\n  CallablePolicy,\n  Callables,\n  ResumableOutcome,\n} from './callables/create-callables.js';\n\nexport {\n  usePendingMutationVariables,\n  pendingMutationVariables,\n  usePendingMutationTargets,\n  hasPendingMutation,\n  duplicateSubmissionError,\n  useDuplicateGuardedMutation,\n} from './pending-mutations.js';\n\nexport {\n  APP_CONFIG_BACKGROUND_RETRY_MS,\n  APP_CONFIG_MAX_QUICK_ATTEMPTS,\n  createAppConfig,\n} from './app-config/create-app-config.js';\nexport type {\n  AppConfig,\n  AppConfigDefinition,\n  AppConfigLeverOf,\n  AppConfigSnapshotState,\n  AppConfigState,\n  AppConfigStatus,\n  StoredAppConfig,\n} from './app-config/create-app-config.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAGtF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAM7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAClG,OAAO,EACL,KAAK,EACL,MAAM,EACN,SAAS,EACT,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,uCAAuC,CAAC;AAW/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAYjD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG5F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAIlF,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAY/B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAYvF,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,eAAe,GAChB,MAAM,mCAAmC,CAAC","sourcesContent":["'use client';\n\nexport { createQueryClient } from './query-client.js';\nexport type { CreateQueryClientOptions } from './query-client.js';\n\nexport { QueryProvider } from './provider.js';\nexport type { QueryProviderProps } from './provider.js';\n\nexport { FirestoreProvider, useFirestoreDb } from './firestore/context.js';\nexport type { FirestoreProviderProps } from './firestore/context.js';\n\nexport { useFirestoreDoc } from './firestore/use-firestore-doc.js';\nexport { useFirestoreCollection } from './firestore/use-firestore-collection.js';\nexport { useFirestoreInfinite } from './firestore/use-firestore-infinite.js';\nexport { useFirestorePaginated } from './firestore/use-firestore-paginated.js';\nexport type { UseFirestorePaginatedResult } from './firestore/use-firestore-paginated.js';\nexport { useFirestoreCount } from './firestore/use-firestore-count.js';\nexport { useFirestoreLiveInfinite } from './firestore/use-firestore-live-infinite.js';\nexport type { FirestoreLiveInfiniteResult } from './firestore/use-firestore-live-infinite.js';\n\nexport {\n  useFirestoreSet,\n  useFirestoreUpdate,\n  useFirestoreDelete,\n  useFirestoreBatch,\n} from './firestore/use-firestore-mutations.js';\n\nexport { useBatchFirestoreDocs } from './firestore/useBatchFirestoreDocs.js';\nexport type {\n  BatchFirestoreDocsOptions,\n  BatchFirestoreDocsResult,\n  BatchFirestoreDocsTransport,\n} from './firestore/useBatchFirestoreDocs.js';\nexport { ABSENT_RETRY_DELAYS_MS } from './firestore/absence-scheduler.js';\n\nexport { useFirestoreSearch } from './search/use-firestore-search.js';\n\nexport {\n  invalidateByPrefix,\n  removeByPrefix,\n  updateQueryData,\n  paginatedPageKey,\n  mapPaginatedItems,\n  prependToFirstPaginatedPage,\n  placeRowInPages,\n} from './cache-helpers.js';\nexport type { PagedRows } from './cache-helpers.js';\n\nexport { createDomainEventInvalidator } from './domain-events/create-domain-event-invalidator.js';\nexport {\n  exact,\n  prefix,\n  predicate,\n  serializeInvalidation,\n  applyInvalidations,\n} from './domain-events/cache-invalidation.js';\nexport type {\n  DomainEventInvalidator,\n  DomainEventInvalidationRegistry,\n} from './domain-events/create-domain-event-invalidator.js';\nexport type {\n  CacheAction,\n  CacheInvalidation,\n  RefetchType,\n} from './domain-events/cache-invalidation.js';\n\nexport { docWithId } from './firestore/types.js';\nexport type {\n  FirestoreDocOptions,\n  FirestoreCollectionOptions,\n  FirestoreInfiniteOptions,\n  FirestorePaginatedOptions,\n  FirestoreCountOptions,\n  FirestoreLiveInfiniteOptions,\n  InfinitePage,\n  PaginatedPage,\n  MutationOperation,\n} from './firestore/types.js';\nexport { flattenInfiniteData, getInfiniteDataCount } from './firestore/infinite-helpers.js';\nexport type { FirestoreSearchOptions } from './search/types.js';\n\nexport { useReadRetryState, useReadRetryStates } from './use-read-retry-state.js';\nexport type { ReadRetryEntry } from './use-read-retry-state.js';\nexport type { ReadRetrySource, ReadRetryState } from './read-retry-derivation.js';\n\nexport {\n  MutationSessionProvider,\n  MutationSessionEndedError,\n  useSessionMutation,\n} from './session-mutation.js';\nexport type {\n  LiveSessionSource,\n  MutationSession,\n  MutationSessionProviderProps,\n  SessionMutateOptions,\n  SessionMutationFunctionContext,\n  SessionMutationOptions,\n  SessionMutationResult,\n  UnknownOutcomePolicy,\n} from './session-mutation.js';\n\nexport { createCallables, MAX_RESUMABLE_CALLS } from './callables/create-callables.js';\nexport type {\n  CallableCaptureContext,\n  CallableDeclaration,\n  CallableErrorRouting,\n  CallableMutationOptions,\n  CallablePolicy,\n  Callables,\n  ResumableOutcome,\n  SlowCallNotice,\n} from './callables/create-callables.js';\n\nexport {\n  usePendingMutationVariables,\n  pendingMutationVariables,\n  usePendingMutationTargets,\n  hasPendingMutation,\n  duplicateSubmissionError,\n  useDuplicateGuardedMutation,\n} from './pending-mutations.js';\n\nexport {\n  APP_CONFIG_BACKGROUND_RETRY_MS,\n  APP_CONFIG_MAX_QUICK_ATTEMPTS,\n  createAppConfig,\n} from './app-config/create-app-config.js';\nexport type {\n  AppConfig,\n  AppConfigDefinition,\n  AppConfigLeverOf,\n  AppConfigSnapshotState,\n  AppConfigState,\n  AppConfigStatus,\n  StoredAppConfig,\n} from './app-config/create-app-config.js';\n"]}

package/dist/react/session-mutation.d.ts

@@ -37,12 +37,23 @@ export declare class MutationSessionEndedError extends Error {
         cause?: unknown;
     });
 }
-export interface MutationSessionProviderProps {
-    currentUid: string | null;
+/** The signed-in uid as the auth layer holds it right now, and a subscription to its changes —
+ *  the pair `useSyncExternalStore` takes. */
+export interface LiveSessionSource {
+    read: () => string | null;
+    subscribe: (onChange: () => void) => () => void;
+}
+export type MutationSessionProviderProps = {
     unknownOutcome?: UnknownOutcomePolicy;
     children?: ReactNode;
-}
-export declare function MutationSessionProvider({ currentUid, unknownOutcome, children, }: MutationSessionProviderProps): import("react").JSX.Element;
+} & ({
+    currentUid: string | null;
+    liveSession?: never;
+} | {
+    liveSession: LiveSessionSource;
+    currentUid?: never;
+});
+export declare function MutationSessionProvider(props: MutationSessionProviderProps): import("react").JSX.Element;
 export declare function useMutationSessionCapture(): () => MutationSession;
 export declare function useSessionMutation<TData = unknown, TError = DefaultError, TVariables = void, TOnMutateResult = unknown>(options: SessionMutationOptions<TData, TError, TVariables, TOnMutateResult>): SessionMutationResult<TData, TError, TVariables, TOnMutateResult>;
 export {};

package/dist/react/session-mutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-mutation.d.ts","sourceRoot":"","sources":["../../src/react/session-mutation.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-mutation.d.ts","sourceRoot":"","sources":["../../src/react/session-mutation.tsx"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAGL,KAAK,YAAY,EAEjB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,IAAI,OAAO,CAAC;IACrB,aAAa,IAAI,IAAI,CAAC;CACvB;AAED,MAAM,MAAM,8BAA8B,GAAG,uBAAuB,GAAG;IACrE,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAChC,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,YAAY,EACrB,UAAU,GAAG,IAAI,EACjB,eAAe,GAAG,OAAO,IACvB,IAAI,CACN,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,EAC9D,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,CAClE,GAAG;IACF,UAAU,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,8BAA8B,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/F,QAAQ,CAAC,EAAE,CACT,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,8BAA8B,KACpC,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;IAChD,SAAS,CAAC,EAAE,CACV,IAAI,EAAE,KAAK,EACX,SAAS,EAAE,UAAU,EACrB,cAAc,EAAE,eAAe,EAC/B,OAAO,EAAE,8BAA8B,KACpC,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAChC,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,UAAU,EACrB,cAAc,EAAE,eAAe,GAAG,SAAS,EAC3C,OAAO,EAAE,8BAA8B,KACpC,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAChC,SAAS,CAAC,EAAE,CACV,IAAI,EAAE,KAAK,GAAG,SAAS,EACvB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,SAAS,EAAE,UAAU,EACrB,cAAc,EAAE,eAAe,GAAG,SAAS,EAC3C,OAAO,EAAE,8BAA8B,KACpC,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAChC,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,SAAS,QAAQ,EAAE,CAAC;CACtE,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC9C,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,MAAM,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,QAAQ,EAAE,KAAK,OAAO,CAAC;CAC1E;AAED,MAAM,WAAW,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe;IAC9E,SAAS,CAAC,EAAE,CACV,IAAI,EAAE,KAAK,EACX,SAAS,EAAE,UAAU,EACrB,cAAc,EAAE,eAAe,GAAG,SAAS,EAC3C,OAAO,EAAE,8BAA8B,KACpC,IAAI,CAAC;IACV,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,UAAU,EACrB,cAAc,EAAE,eAAe,GAAG,SAAS,EAC3C,OAAO,EAAE,8BAA8B,KACpC,IAAI,CAAC;IACV,SAAS,CAAC,EAAE,CACV,IAAI,EAAE,KAAK,GAAG,SAAS,EACvB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,SAAS,EAAE,UAAU,EACrB,cAAc,EAAE,eAAe,GAAG,SAAS,EAC3C,OAAO,EAAE,8BAA8B,KACpC,IAAI,CAAC;CACX;AAED,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;AAEzF,MAAM,MAAM,qBAAqB,CAC/B,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,YAAY,EACrB,UAAU,GAAG,IAAI,EACjB,eAAe,GAAG,OAAO,IACvB,gBAAgB,CAClB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,EAC7D,QAAQ,GAAG,aAAa,CACzB,GAAG;IACF,MAAM,EAAE,CACN,SAAS,EAAE,UAAU,EACrB,OAAO,CAAC,EAAE,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,KACvE,IAAI,CAAC;IACV,WAAW,EAAE,CACX,SAAS,EAAE,UAAU,EACrB,OAAO,CAAC,EAAE,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,KACvE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB,CAAC;AAEF,qBAAa,yBAA0B,SAAQ,KAAK;IACzC,IAAI,SAAgB;gBAEjB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG1C;AAED;6CAC6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAUD,MAAM,MAAM,4BAA4B,GAAG;IACzC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GAAG,CACA;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,CAAC,EAAE,KAAK,CAAA;CAAE,GAClD;IAAE,WAAW,EAAE,iBAAiB,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,CACzD,CAAC;AAcF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,+BA0B1E;AAyBD,wBAAgB,yBAAyB,IAAI,MAAM,eAAe,CAGjE;AAmGD,wBAAgB,kBAAkB,CAChC,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,YAAY,EACrB,UAAU,GAAG,IAAI,EACjB,eAAe,GAAG,OAAO,EAEzB,OAAO,EAAE,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,GAC1E,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,CAqGnE"}

package/dist/react/session-mutation.js

@@ -9,19 +9,43 @@ export class MutationSessionEndedError extends Error {
     }
 }
 const MutationSessionContext = createContext(null);
-export function MutationSessionProvider({ currentUid, unknownOutcome, children, }) {
+function observeUid(store, uid) {
+    if (store.current.uid !== uid) {
+        store.current = { uid, generation: store.current.generation + 1 };
+    }
+}
+// A live source is read at every capture and every check, so an action started in the same task
+// as a sign-in belongs to the new uid even before any render has seen it.
+function syncLive(store) {
+    if (store.live)
+        observeUid(store, store.live.read());
+}
+export function MutationSessionProvider(props) {
+    const { unknownOutcome, children } = props;
+    const live = props.liveSession ?? null;
+    const currentUid = props.liveSession ? null : (props.currentUid ?? null);
     const [store] = useState(() => ({
-        current: { uid: currentUid, generation: 0 },
+        current: { uid: live ? live.read() : currentUid, generation: 0 },
+        live,
         unknownOutcome: unknownOutcome ?? null,
     }));
     // Insertion effects run before any layout effect of the commit, so a child's layout effect
     // never starts a mutation under the uid this commit ends.
     useInsertionEffect(() => {
-        if (store.current.uid !== currentUid) {
-            store.current = { uid: currentUid, generation: store.current.generation + 1 };
-        }
+        store.live = live;
+        if (live)
+            syncLive(store);
+        else
+            observeUid(store, currentUid);
         store.unknownOutcome = unknownOutcome ?? null;
-    }, [store, currentUid, unknownOutcome]);
+    }, [store, live, currentUid, unknownOutcome]);
+    // Every change the source reports is observed as it happens, so a sign-out followed by the same
+    // uid signing back in ends the session even when no check ran in between.
+    useInsertionEffect(() => {
+        if (!live)
+            return;
+        return live.subscribe(() => syncLive(store));
+    }, [store, live]);
     return (_jsx(MutationSessionContext.Provider, { value: store, children: children }));
 }
 const ALWAYS_CURRENT = {
@@ -32,8 +56,12 @@ const ALWAYS_CURRENT = {
 function captureSession(store) {
     if (!store)
         return ALWAYS_CURRENT;
+    syncLive(store);
     const { uid, generation } = store.current;
-    const isCurrent = () => store.current.generation === generation;
+    const isCurrent = () => {
+        syncLive(store);
+        return store.current.generation === generation;
+    };
     return {
         uid,
         isCurrent,

package/dist/react/session-mutation.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-mutation.js","sourceRoot":"","sources":["../../src/react/session-mutation.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useInsertionEffect,\n  useState,\n  type ReactNode,\n} from 'react';\nimport {\n  useMutation,\n  useQueryClient,\n  type DefaultError,\n  type MutateOptions,\n  type MutationFunctionContext,\n  type QueryClient,\n  type QueryKey,\n  type UseMutationOptions,\n  type UseMutationResult,\n} from '@tanstack/react-query';\n\nexport interface MutationSession {\n  uid: string | null;\n  isCurrent(): boolean;\n  assertCurrent(): void;\n}\n\nexport type SessionMutationFunctionContext = MutationFunctionContext & {\n  session: MutationSession;\n};\n\nexport type SessionMutationOptions<\n  TData = unknown,\n  TError = DefaultError,\n  TVariables = void,\n  TOnMutateResult = unknown,\n> = Omit<\n  UseMutationOptions<TData, TError, TVariables, TOnMutateResult>,\n  'mutationFn' | 'onMutate' | 'onSuccess' | 'onError' | 'onSettled'\n> & {\n  mutationFn: (variables: TVariables, context: SessionMutationFunctionContext) => Promise<TData>;\n  onMutate?: (\n    variables: TVariables,\n    context: SessionMutationFunctionContext,\n  ) => Promise<TOnMutateResult> | TOnMutateResult;\n  onSuccess?: (\n    data: TData,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult,\n    context: SessionMutationFunctionContext,\n  ) => Promise<unknown> | unknown;\n  onError?: (\n    error: TError,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult | undefined,\n    context: SessionMutationFunctionContext,\n  ) => Promise<unknown> | unknown;\n  onSettled?: (\n    data: TData | undefined,\n    error: TError | null,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult | undefined,\n    context: SessionMutationFunctionContext,\n  ) => Promise<unknown> | unknown;\n  unknownOutcomeReads?: (variables: TVariables) => readonly QueryKey[];\n};\n\nexport interface UnknownOutcomePolicy {\n  isUnknownOutcome: (error: unknown) => boolean;\n  rereadAfterMs: readonly number[];\n  reread: (queryClient: QueryClient, keys: readonly QueryKey[]) => unknown;\n}\n\nexport interface SessionMutateOptions<TData, TError, TVariables, TOnMutateResult> {\n  onSuccess?: (\n    data: TData,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult | undefined,\n    context: SessionMutationFunctionContext,\n  ) => void;\n  onError?: (\n    error: TError,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult | undefined,\n    context: SessionMutationFunctionContext,\n  ) => void;\n  onSettled?: (\n    data: TData | undefined,\n    error: TError | null,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult | undefined,\n    context: SessionMutationFunctionContext,\n  ) => void;\n}\n\ntype DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;\n\nexport type SessionMutationResult<\n  TData = unknown,\n  TError = DefaultError,\n  TVariables = void,\n  TOnMutateResult = unknown,\n> = DistributiveOmit<\n  UseMutationResult<TData, TError, TVariables, TOnMutateResult>,\n  'mutate' | 'mutateAsync'\n> & {\n  mutate: (\n    variables: TVariables,\n    options?: SessionMutateOptions<TData, TError, TVariables, TOnMutateResult>,\n  ) => void;\n  mutateAsync: (\n    variables: TVariables,\n    options?: SessionMutateOptions<TData, TError, TVariables, TOnMutateResult>,\n  ) => Promise<TData>;\n};\n\nexport class MutationSessionEndedError extends Error {\n  override name = 'AbortError';\n\n  constructor(options?: { cause?: unknown }) {\n    super('The session that started this mutation has ended.', options);\n  }\n}\n\ninterface SessionStore {\n  current: { uid: string | null; generation: number };\n  unknownOutcome: UnknownOutcomePolicy | null;\n}\n\nconst MutationSessionContext = createContext<SessionStore | null>(null);\n\nexport interface MutationSessionProviderProps {\n  currentUid: string | null;\n  unknownOutcome?: UnknownOutcomePolicy;\n  children?: ReactNode;\n}\n\nexport function MutationSessionProvider({\n  currentUid,\n  unknownOutcome,\n  children,\n}: MutationSessionProviderProps) {\n  const [store] = useState<SessionStore>(() => ({\n    current: { uid: currentUid, generation: 0 },\n    unknownOutcome: unknownOutcome ?? null,\n  }));\n  // Insertion effects run before any layout effect of the commit, so a child's layout effect\n  // never starts a mutation under the uid this commit ends.\n  useInsertionEffect(() => {\n    if (store.current.uid !== currentUid) {\n      store.current = { uid: currentUid, generation: store.current.generation + 1 };\n    }\n    store.unknownOutcome = unknownOutcome ?? null;\n  }, [store, currentUid, unknownOutcome]);\n  return (\n    <MutationSessionContext.Provider value={store}>{children}</MutationSessionContext.Provider>\n  );\n}\n\nconst ALWAYS_CURRENT: MutationSession = {\n  uid: null,\n  isCurrent: () => true,\n  assertCurrent: () => {},\n};\n\nfunction captureSession(store: SessionStore | null): MutationSession {\n  if (!store) return ALWAYS_CURRENT;\n  const { uid, generation } = store.current;\n  const isCurrent = () => store.current.generation === generation;\n  return {\n    uid,\n    isCurrent,\n    assertCurrent: () => {\n      if (!isCurrent()) throw new MutationSessionEndedError();\n    },\n  };\n}\n\nexport function useMutationSessionCapture(): () => MutationSession {\n  const store = useContext(MutationSessionContext);\n  return useCallback(() => captureSession(store), [store]);\n}\n\nconst runSessions = new WeakMap<MutationFunctionContext, MutationSession>();\n\nfunction runHasEnded(store: SessionStore | null, context: MutationFunctionContext): boolean {\n  if (!store) return false;\n  return !(runSessions.get(context)?.isCurrent() ?? false);\n}\n\ntype Retry<TError> = UseMutationOptions<unknown, TError, unknown, unknown>['retry'];\ntype ThrowOnError<TError> = UseMutationOptions<unknown, TError, unknown, unknown>['throwOnError'];\n\nfunction retriesAfter<TError>(retry: Retry<TError>, failureCount: number, error: TError): boolean {\n  if (error instanceof MutationSessionEndedError) return false;\n  if (typeof retry === 'function') return retry(failureCount, error);\n  if (typeof retry === 'number') return failureCount < retry;\n  return retry === true;\n}\n\nfunction throwsToBoundary<TError>(throwOnError: ThrowOnError<TError>, error: TError): boolean {\n  if (error instanceof MutationSessionEndedError) return false;\n  if (typeof throwOnError === 'function') return throwOnError(error);\n  return throwOnError === true;\n}\n\nfunction withSession(\n  context: MutationFunctionContext,\n  session: MutationSession,\n): SessionMutationFunctionContext {\n  return { ...context, session };\n}\n\nfunction fenceCallOptions<TData, TError, TVariables, TOnMutateResult>(\n  session: MutationSession,\n  options: SessionMutateOptions<TData, TError, TVariables, TOnMutateResult> | undefined,\n): MutateOptions<TData, TError, TVariables, TOnMutateResult> | undefined {\n  if (!options) return undefined;\n  const { onSuccess, onError, onSettled } = options;\n  return {\n    onSuccess: onSuccess\n      ? (data, variables, onMutateResult, context) => {\n          if (session.isCurrent()) {\n            onSuccess(data, variables, onMutateResult, withSession(context, session));\n          }\n        }\n      : undefined,\n    onError: onError\n      ? (error, variables, onMutateResult, context) => {\n          if (!(error instanceof MutationSessionEndedError) && session.isCurrent()) {\n            onError(error, variables, onMutateResult, withSession(context, session));\n          }\n        }\n      : undefined,\n    onSettled: onSettled\n      ? (data, error, variables, onMutateResult, context) => {\n          if (!(error instanceof MutationSessionEndedError) && session.isCurrent()) {\n            onSettled(data, error, variables, onMutateResult, withSession(context, session));\n          }\n        }\n      : undefined,\n  };\n}\n\nfunction rereadOnUnknownOutcome<TVariables>(\n  store: SessionStore | null,\n  queryClient: QueryClient,\n  reads: ((variables: TVariables) => readonly QueryKey[]) | undefined,\n  error: unknown,\n  variables: TVariables,\n  session: MutationSession,\n): void {\n  const policy = store?.unknownOutcome;\n  if (!policy || !reads || !policy.isUnknownOutcome(error)) return;\n  const keys = reads(variables);\n  if (keys.length === 0) return;\n  for (const delayMs of policy.rereadAfterMs) {\n    setTimeout(() => {\n      if (session.isCurrent()) void policy.reread(queryClient, keys);\n    }, delayMs);\n  }\n}\n\nasync function settleInSession<TData>(\n  session: MutationSession,\n  settled: Promise<TData>,\n): Promise<TData> {\n  let data: TData;\n  try {\n    data = await settled;\n  } catch (error) {\n    if (!(error instanceof MutationSessionEndedError) && !session.isCurrent()) {\n      throw new MutationSessionEndedError({ cause: error });\n    }\n    throw error;\n  }\n  session.assertCurrent();\n  return data;\n}\n\nexport function useSessionMutation<\n  TData = unknown,\n  TError = DefaultError,\n  TVariables = void,\n  TOnMutateResult = unknown,\n>(\n  options: SessionMutationOptions<TData, TError, TVariables, TOnMutateResult>,\n): SessionMutationResult<TData, TError, TVariables, TOnMutateResult> {\n  const store = useContext(MutationSessionContext);\n  const queryClient = useQueryClient();\n  const {\n    mutationFn,\n    onMutate,\n    onSuccess,\n    onError,\n    onSettled,\n    retry,\n    throwOnError,\n    unknownOutcomeReads,\n    ...rest\n  } = options;\n  const defaults = queryClient.defaultMutationOptions<\n    UseMutationOptions<unknown, TError, unknown, unknown>\n  >({ mutationKey: options.mutationKey });\n  const baseRetry = (retry ?? defaults.retry) as Retry<TError>;\n  const baseThrowOnError = (throwOnError ?? defaults.throwOnError) as ThrowOnError<TError>;\n\n  const mutation = useMutation<TData, TError, TVariables, TOnMutateResult>({\n    ...rest,\n    retry: (failureCount, error) => retriesAfter(baseRetry, failureCount, error),\n    throwOnError: (error) => throwsToBoundary(baseThrowOnError, error),\n    onMutate: (variables, context) => {\n      const session = store ? captureSession(store) : ALWAYS_CURRENT;\n      if (store) runSessions.set(context, session);\n      return onMutate?.(variables, withSession(context, session)) as\n        TOnMutateResult | Promise<TOnMutateResult>;\n    },\n    mutationFn: async (variables, context) => {\n      const session = store ? runSessions.get(context) : ALWAYS_CURRENT;\n      if (!session || !session.isCurrent()) throw new MutationSessionEndedError();\n      let data: TData;\n      try {\n        data = await mutationFn(variables, { ...context, session });\n      } catch (error) {\n        if (!session.isCurrent()) throw new MutationSessionEndedError({ cause: error });\n        throw error;\n      }\n      session.assertCurrent();\n      return data;\n    },\n    onSuccess: (data, variables, onMutateResult, context) => {\n      if (runHasEnded(store, context)) return;\n      return onSuccess?.(\n        data,\n        variables,\n        onMutateResult,\n        withSession(context, runSession(context)),\n      );\n    },\n    onError: (error, variables, onMutateResult, context) => {\n      if (error instanceof MutationSessionEndedError || runHasEnded(store, context)) return;\n      const session = runSession(context);\n      rereadOnUnknownOutcome(store, queryClient, unknownOutcomeReads, error, variables, session);\n      return onError?.(error, variables, onMutateResult, withSession(context, session));\n    },\n    onSettled: (data, error, variables, onMutateResult, context) => {\n      if (error instanceof MutationSessionEndedError || runHasEnded(store, context)) return;\n      return onSettled?.(\n        data,\n        error,\n        variables,\n        onMutateResult,\n        withSession(context, runSession(context)),\n      );\n    },\n  });\n\n  function runSession(context: MutationFunctionContext): MutationSession {\n    return (store && runSessions.get(context)) || ALWAYS_CURRENT;\n  }\n\n  const { mutate: rawMutate, mutateAsync: rawMutateAsync } = mutation;\n  const mutate = useCallback(\n    (\n      variables: TVariables,\n      callOptions?: SessionMutateOptions<TData, TError, TVariables, TOnMutateResult>,\n    ) => rawMutate(variables, fenceCallOptions(captureSession(store), callOptions)),\n    [rawMutate, store],\n  );\n  const mutateAsync = useCallback(\n    (\n      variables: TVariables,\n      callOptions?: SessionMutateOptions<TData, TError, TVariables, TOnMutateResult>,\n    ) => {\n      const session = captureSession(store);\n      return settleInSession(\n        session,\n        rawMutateAsync(variables, fenceCallOptions(session, callOptions)),\n      );\n    },\n    [rawMutateAsync, store],\n  );\n  return { ...mutation, mutate, mutateAsync } as SessionMutationResult<\n    TData,\n    TError,\n    TVariables,\n    TOnMutateResult\n  >;\n}\n"]}
+{"version":3,"file":"session-mutation.js","sourceRoot":"","sources":["../../src/react/session-mutation.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useInsertionEffect,\n  useState,\n  type ReactNode,\n} from 'react';\nimport {\n  useMutation,\n  useQueryClient,\n  type DefaultError,\n  type MutateOptions,\n  type MutationFunctionContext,\n  type QueryClient,\n  type QueryKey,\n  type UseMutationOptions,\n  type UseMutationResult,\n} from '@tanstack/react-query';\n\nexport interface MutationSession {\n  uid: string | null;\n  isCurrent(): boolean;\n  assertCurrent(): void;\n}\n\nexport type SessionMutationFunctionContext = MutationFunctionContext & {\n  session: MutationSession;\n};\n\nexport type SessionMutationOptions<\n  TData = unknown,\n  TError = DefaultError,\n  TVariables = void,\n  TOnMutateResult = unknown,\n> = Omit<\n  UseMutationOptions<TData, TError, TVariables, TOnMutateResult>,\n  'mutationFn' | 'onMutate' | 'onSuccess' | 'onError' | 'onSettled'\n> & {\n  mutationFn: (variables: TVariables, context: SessionMutationFunctionContext) => Promise<TData>;\n  onMutate?: (\n    variables: TVariables,\n    context: SessionMutationFunctionContext,\n  ) => Promise<TOnMutateResult> | TOnMutateResult;\n  onSuccess?: (\n    data: TData,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult,\n    context: SessionMutationFunctionContext,\n  ) => Promise<unknown> | unknown;\n  onError?: (\n    error: TError,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult | undefined,\n    context: SessionMutationFunctionContext,\n  ) => Promise<unknown> | unknown;\n  onSettled?: (\n    data: TData | undefined,\n    error: TError | null,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult | undefined,\n    context: SessionMutationFunctionContext,\n  ) => Promise<unknown> | unknown;\n  unknownOutcomeReads?: (variables: TVariables) => readonly QueryKey[];\n};\n\nexport interface UnknownOutcomePolicy {\n  isUnknownOutcome: (error: unknown) => boolean;\n  rereadAfterMs: readonly number[];\n  reread: (queryClient: QueryClient, keys: readonly QueryKey[]) => unknown;\n}\n\nexport interface SessionMutateOptions<TData, TError, TVariables, TOnMutateResult> {\n  onSuccess?: (\n    data: TData,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult | undefined,\n    context: SessionMutationFunctionContext,\n  ) => void;\n  onError?: (\n    error: TError,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult | undefined,\n    context: SessionMutationFunctionContext,\n  ) => void;\n  onSettled?: (\n    data: TData | undefined,\n    error: TError | null,\n    variables: TVariables,\n    onMutateResult: TOnMutateResult | undefined,\n    context: SessionMutationFunctionContext,\n  ) => void;\n}\n\ntype DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;\n\nexport type SessionMutationResult<\n  TData = unknown,\n  TError = DefaultError,\n  TVariables = void,\n  TOnMutateResult = unknown,\n> = DistributiveOmit<\n  UseMutationResult<TData, TError, TVariables, TOnMutateResult>,\n  'mutate' | 'mutateAsync'\n> & {\n  mutate: (\n    variables: TVariables,\n    options?: SessionMutateOptions<TData, TError, TVariables, TOnMutateResult>,\n  ) => void;\n  mutateAsync: (\n    variables: TVariables,\n    options?: SessionMutateOptions<TData, TError, TVariables, TOnMutateResult>,\n  ) => Promise<TData>;\n};\n\nexport class MutationSessionEndedError extends Error {\n  override name = 'AbortError';\n\n  constructor(options?: { cause?: unknown }) {\n    super('The session that started this mutation has ended.', options);\n  }\n}\n\n/** The signed-in uid as the auth layer holds it right now, and a subscription to its changes —\n *  the pair `useSyncExternalStore` takes. */\nexport interface LiveSessionSource {\n  read: () => string | null;\n  subscribe: (onChange: () => void) => () => void;\n}\n\ninterface SessionStore {\n  current: { uid: string | null; generation: number };\n  live: LiveSessionSource | null;\n  unknownOutcome: UnknownOutcomePolicy | null;\n}\n\nconst MutationSessionContext = createContext<SessionStore | null>(null);\n\nexport type MutationSessionProviderProps = {\n  unknownOutcome?: UnknownOutcomePolicy;\n  children?: ReactNode;\n} & (\n  | { currentUid: string | null; liveSession?: never }\n  | { liveSession: LiveSessionSource; currentUid?: never }\n);\n\nfunction observeUid(store: SessionStore, uid: string | null): void {\n  if (store.current.uid !== uid) {\n    store.current = { uid, generation: store.current.generation + 1 };\n  }\n}\n\n// A live source is read at every capture and every check, so an action started in the same task\n// as a sign-in belongs to the new uid even before any render has seen it.\nfunction syncLive(store: SessionStore): void {\n  if (store.live) observeUid(store, store.live.read());\n}\n\nexport function MutationSessionProvider(props: MutationSessionProviderProps) {\n  const { unknownOutcome, children } = props;\n  const live = props.liveSession ?? null;\n  const currentUid = props.liveSession ? null : (props.currentUid ?? null);\n  const [store] = useState<SessionStore>(() => ({\n    current: { uid: live ? live.read() : currentUid, generation: 0 },\n    live,\n    unknownOutcome: unknownOutcome ?? null,\n  }));\n  // Insertion effects run before any layout effect of the commit, so a child's layout effect\n  // never starts a mutation under the uid this commit ends.\n  useInsertionEffect(() => {\n    store.live = live;\n    if (live) syncLive(store);\n    else observeUid(store, currentUid);\n    store.unknownOutcome = unknownOutcome ?? null;\n  }, [store, live, currentUid, unknownOutcome]);\n  // Every change the source reports is observed as it happens, so a sign-out followed by the same\n  // uid signing back in ends the session even when no check ran in between.\n  useInsertionEffect(() => {\n    if (!live) return;\n    return live.subscribe(() => syncLive(store));\n  }, [store, live]);\n  return (\n    <MutationSessionContext.Provider value={store}>{children}</MutationSessionContext.Provider>\n  );\n}\n\nconst ALWAYS_CURRENT: MutationSession = {\n  uid: null,\n  isCurrent: () => true,\n  assertCurrent: () => {},\n};\n\nfunction captureSession(store: SessionStore | null): MutationSession {\n  if (!store) return ALWAYS_CURRENT;\n  syncLive(store);\n  const { uid, generation } = store.current;\n  const isCurrent = () => {\n    syncLive(store);\n    return store.current.generation === generation;\n  };\n  return {\n    uid,\n    isCurrent,\n    assertCurrent: () => {\n      if (!isCurrent()) throw new MutationSessionEndedError();\n    },\n  };\n}\n\nexport function useMutationSessionCapture(): () => MutationSession {\n  const store = useContext(MutationSessionContext);\n  return useCallback(() => captureSession(store), [store]);\n}\n\nconst runSessions = new WeakMap<MutationFunctionContext, MutationSession>();\n\nfunction runHasEnded(store: SessionStore | null, context: MutationFunctionContext): boolean {\n  if (!store) return false;\n  return !(runSessions.get(context)?.isCurrent() ?? false);\n}\n\ntype Retry<TError> = UseMutationOptions<unknown, TError, unknown, unknown>['retry'];\ntype ThrowOnError<TError> = UseMutationOptions<unknown, TError, unknown, unknown>['throwOnError'];\n\nfunction retriesAfter<TError>(retry: Retry<TError>, failureCount: number, error: TError): boolean {\n  if (error instanceof MutationSessionEndedError) return false;\n  if (typeof retry === 'function') return retry(failureCount, error);\n  if (typeof retry === 'number') return failureCount < retry;\n  return retry === true;\n}\n\nfunction throwsToBoundary<TError>(throwOnError: ThrowOnError<TError>, error: TError): boolean {\n  if (error instanceof MutationSessionEndedError) return false;\n  if (typeof throwOnError === 'function') return throwOnError(error);\n  return throwOnError === true;\n}\n\nfunction withSession(\n  context: MutationFunctionContext,\n  session: MutationSession,\n): SessionMutationFunctionContext {\n  return { ...context, session };\n}\n\nfunction fenceCallOptions<TData, TError, TVariables, TOnMutateResult>(\n  session: MutationSession,\n  options: SessionMutateOptions<TData, TError, TVariables, TOnMutateResult> | undefined,\n): MutateOptions<TData, TError, TVariables, TOnMutateResult> | undefined {\n  if (!options) return undefined;\n  const { onSuccess, onError, onSettled } = options;\n  return {\n    onSuccess: onSuccess\n      ? (data, variables, onMutateResult, context) => {\n          if (session.isCurrent()) {\n            onSuccess(data, variables, onMutateResult, withSession(context, session));\n          }\n        }\n      : undefined,\n    onError: onError\n      ? (error, variables, onMutateResult, context) => {\n          if (!(error instanceof MutationSessionEndedError) && session.isCurrent()) {\n            onError(error, variables, onMutateResult, withSession(context, session));\n          }\n        }\n      : undefined,\n    onSettled: onSettled\n      ? (data, error, variables, onMutateResult, context) => {\n          if (!(error instanceof MutationSessionEndedError) && session.isCurrent()) {\n            onSettled(data, error, variables, onMutateResult, withSession(context, session));\n          }\n        }\n      : undefined,\n  };\n}\n\nfunction rereadOnUnknownOutcome<TVariables>(\n  store: SessionStore | null,\n  queryClient: QueryClient,\n  reads: ((variables: TVariables) => readonly QueryKey[]) | undefined,\n  error: unknown,\n  variables: TVariables,\n  session: MutationSession,\n): void {\n  const policy = store?.unknownOutcome;\n  if (!policy || !reads || !policy.isUnknownOutcome(error)) return;\n  const keys = reads(variables);\n  if (keys.length === 0) return;\n  for (const delayMs of policy.rereadAfterMs) {\n    setTimeout(() => {\n      if (session.isCurrent()) void policy.reread(queryClient, keys);\n    }, delayMs);\n  }\n}\n\nasync function settleInSession<TData>(\n  session: MutationSession,\n  settled: Promise<TData>,\n): Promise<TData> {\n  let data: TData;\n  try {\n    data = await settled;\n  } catch (error) {\n    if (!(error instanceof MutationSessionEndedError) && !session.isCurrent()) {\n      throw new MutationSessionEndedError({ cause: error });\n    }\n    throw error;\n  }\n  session.assertCurrent();\n  return data;\n}\n\nexport function useSessionMutation<\n  TData = unknown,\n  TError = DefaultError,\n  TVariables = void,\n  TOnMutateResult = unknown,\n>(\n  options: SessionMutationOptions<TData, TError, TVariables, TOnMutateResult>,\n): SessionMutationResult<TData, TError, TVariables, TOnMutateResult> {\n  const store = useContext(MutationSessionContext);\n  const queryClient = useQueryClient();\n  const {\n    mutationFn,\n    onMutate,\n    onSuccess,\n    onError,\n    onSettled,\n    retry,\n    throwOnError,\n    unknownOutcomeReads,\n    ...rest\n  } = options;\n  const defaults = queryClient.defaultMutationOptions<\n    UseMutationOptions<unknown, TError, unknown, unknown>\n  >({ mutationKey: options.mutationKey });\n  const baseRetry = (retry ?? defaults.retry) as Retry<TError>;\n  const baseThrowOnError = (throwOnError ?? defaults.throwOnError) as ThrowOnError<TError>;\n\n  const mutation = useMutation<TData, TError, TVariables, TOnMutateResult>({\n    ...rest,\n    retry: (failureCount, error) => retriesAfter(baseRetry, failureCount, error),\n    throwOnError: (error) => throwsToBoundary(baseThrowOnError, error),\n    onMutate: (variables, context) => {\n      const session = store ? captureSession(store) : ALWAYS_CURRENT;\n      if (store) runSessions.set(context, session);\n      return onMutate?.(variables, withSession(context, session)) as\n        TOnMutateResult | Promise<TOnMutateResult>;\n    },\n    mutationFn: async (variables, context) => {\n      const session = store ? runSessions.get(context) : ALWAYS_CURRENT;\n      if (!session || !session.isCurrent()) throw new MutationSessionEndedError();\n      let data: TData;\n      try {\n        data = await mutationFn(variables, { ...context, session });\n      } catch (error) {\n        if (!session.isCurrent()) throw new MutationSessionEndedError({ cause: error });\n        throw error;\n      }\n      session.assertCurrent();\n      return data;\n    },\n    onSuccess: (data, variables, onMutateResult, context) => {\n      if (runHasEnded(store, context)) return;\n      return onSuccess?.(\n        data,\n        variables,\n        onMutateResult,\n        withSession(context, runSession(context)),\n      );\n    },\n    onError: (error, variables, onMutateResult, context) => {\n      if (error instanceof MutationSessionEndedError || runHasEnded(store, context)) return;\n      const session = runSession(context);\n      rereadOnUnknownOutcome(store, queryClient, unknownOutcomeReads, error, variables, session);\n      return onError?.(error, variables, onMutateResult, withSession(context, session));\n    },\n    onSettled: (data, error, variables, onMutateResult, context) => {\n      if (error instanceof MutationSessionEndedError || runHasEnded(store, context)) return;\n      return onSettled?.(\n        data,\n        error,\n        variables,\n        onMutateResult,\n        withSession(context, runSession(context)),\n      );\n    },\n  });\n\n  function runSession(context: MutationFunctionContext): MutationSession {\n    return (store && runSessions.get(context)) || ALWAYS_CURRENT;\n  }\n\n  const { mutate: rawMutate, mutateAsync: rawMutateAsync } = mutation;\n  const mutate = useCallback(\n    (\n      variables: TVariables,\n      callOptions?: SessionMutateOptions<TData, TError, TVariables, TOnMutateResult>,\n    ) => rawMutate(variables, fenceCallOptions(captureSession(store), callOptions)),\n    [rawMutate, store],\n  );\n  const mutateAsync = useCallback(\n    (\n      variables: TVariables,\n      callOptions?: SessionMutateOptions<TData, TError, TVariables, TOnMutateResult>,\n    ) => {\n      const session = captureSession(store);\n      return settleInSession(\n        session,\n        rawMutateAsync(variables, fenceCallOptions(session, callOptions)),\n      );\n    },\n    [rawMutateAsync, store],\n  );\n  return { ...mutation, mutate, mutateAsync } as SessionMutationResult<\n    TData,\n    TError,\n    TVariables,\n    TOnMutateResult\n  >;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/query-core",
-  "version": "0.14.31",
+  "version": "0.14.33",
   "description": "Shared TanStack Query (React Query) client defaults, query key helpers, and Firestore integration hooks for TTT Productions apps",
   "repository": {
     "type": "git",
@@ -64,7 +64,7 @@
     }
   },
   "dependencies": {
-    "@ttt-productions/firebase-helpers": "^0.12.23"
+    "@ttt-productions/firebase-helpers": "^0.12.24"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.90.0",