reactjrx 4.0.5 → 4.0.7

package/dist/lib/queries/mutationOptions.d.ts

@@ -1,25 +1,6 @@
-import { UseMutationOptions } from '@tanstack/react-query';
 import { Observable } from 'rxjs';
 /**
  * Resolves the public `mutationFn` option — an Observable or a function
  * returning one — to its source Observable for the given variables.
  */
 export declare function resolveMutationFnSource<TData, TVariables>(mutationFn: ((variables: TVariables) => Observable<TData>) | Observable<TData>, variables: TVariables): Observable<TData>;
-type MutationCallbacks<TData, TError, TVariables, TOnMutateResult> = Pick<UseMutationOptions<TData, TError, TVariables, TOnMutateResult>, "onMutate" | "onSuccess" | "onError" | "onSettled">;
-/**
- * Same callbacks, but keyed as required so that spreading the adapted
- * callbacks after `...options` overrides (rather than unions with) the
- * raw-variables callbacks still present in `options`.
- */
-type AdaptedMutationCallbacks<TData, TError, TVariables, TOnMutateResult> = {
-    [K in "onMutate" | "onSuccess" | "onError" | "onSettled"]: MutationCallbacks<TData, TError, {
-        variables: TVariables;
-    }, TOnMutateResult>[K] | undefined;
-};
-/**
- * `useSwitchMutation$` runs its inner mutation with the user variables
- * wrapped in an envelope (`{ variables, abort }`). This adapts the
- * user-facing callbacks, which expect the raw variables, to that envelope.
- */
-export declare function adaptCallbacksToWrappedVariables<TData, TError, TVariables, TOnMutateResult>({ onMutate, onSuccess, onError, onSettled, }: MutationCallbacks<TData, TError, TVariables, TOnMutateResult>): AdaptedMutationCallbacks<TData, TError, TVariables, TOnMutateResult>;
-export {};

package/dist/lib/queries/useSwitchMutation$.d.ts

@@ -3,13 +3,24 @@ import { UseMutation$Options } from './useMutation$';
 export declare class SwitchMutationCancelError extends Error {
     constructor(message?: string);
 }
+type SwitchVariables<TVariables> = {
+    variables: TVariables;
+    abort: AbortSignal;
+};
+/**
+ * Runs a mutation, and cancels the call still running when a new one starts.
+ * A cancelled call fails with `SwitchMutationCancelError` and is not retried.
+ * A call cancelled while TanStack waits to retry it settles once that wait
+ * ends.
+ *
+ * The callbacks, the client's defaults included, receive the variables given
+ * to `mutate`. A `MutationCache`, `result.variables` and `useMutationState`
+ * see the `{ variables, abort }` the hook runs the mutation with.
+ */
 export declare function useSwitchMutation$<TData = unknown, TError = DefaultError, TVariables = void, TOnMutateResult = unknown>({ mutationFn, ...options }: UseMutation$Options<TData | null, TError, TVariables, TOnMutateResult>, queryClient?: QueryClient): {
     mutate: (variables: TVariables) => void;
     mutateAsync: (variables: TVariables) => Promise<TData | null>;
-    state$: import('rxjs').BehaviorSubject<Pick<import('@tanstack/react-query').UseMutationResult<TData | null, TError, {
-        variables: TVariables;
-        abort: AbortSignal;
-    }, TOnMutateResult>, "status" | "isPending" | "isError" | "isSuccess" | "isIdle">>;
+    state$: import('rxjs').BehaviorSubject<Pick<import('@tanstack/react-query').UseMutationResult<TData | null, TError, SwitchVariables<TVariables>, TOnMutateResult>, "status" | "isPending" | "isError" | "isSuccess" | "isIdle">>;
     data: undefined;
     variables: undefined;
     error: null;
@@ -27,15 +38,9 @@ export declare function useSwitchMutation$<TData = unknown, TError = DefaultErro
 } | {
     mutate: (variables: TVariables) => void;
     mutateAsync: (variables: TVariables) => Promise<TData | null>;
-    state$: import('rxjs').BehaviorSubject<Pick<import('@tanstack/react-query').UseMutationResult<TData | null, TError, {
-        variables: TVariables;
-        abort: AbortSignal;
-    }, TOnMutateResult>, "status" | "isPending" | "isError" | "isSuccess" | "isIdle">>;
+    state$: import('rxjs').BehaviorSubject<Pick<import('@tanstack/react-query').UseMutationResult<TData | null, TError, SwitchVariables<TVariables>, TOnMutateResult>, "status" | "isPending" | "isError" | "isSuccess" | "isIdle">>;
     data: undefined;
-    variables: {
-        variables: TVariables;
-        abort: AbortSignal;
-    };
+    variables: SwitchVariables<TVariables>;
     error: null;
     isError: false;
     isIdle: false;
@@ -51,16 +56,10 @@ export declare function useSwitchMutation$<TData = unknown, TError = DefaultErro
 } | {
     mutate: (variables: TVariables) => void;
     mutateAsync: (variables: TVariables) => Promise<TData | null>;
-    state$: import('rxjs').BehaviorSubject<Pick<import('@tanstack/react-query').UseMutationResult<TData | null, TError, {
-        variables: TVariables;
-        abort: AbortSignal;
-    }, TOnMutateResult>, "status" | "isPending" | "isError" | "isSuccess" | "isIdle">>;
+    state$: import('rxjs').BehaviorSubject<Pick<import('@tanstack/react-query').UseMutationResult<TData | null, TError, SwitchVariables<TVariables>, TOnMutateResult>, "status" | "isPending" | "isError" | "isSuccess" | "isIdle">>;
     data: undefined;
     error: TError;
-    variables: {
-        variables: TVariables;
-        abort: AbortSignal;
-    };
+    variables: SwitchVariables<TVariables>;
     isError: true;
     isIdle: false;
     isPending: false;
@@ -75,16 +74,10 @@ export declare function useSwitchMutation$<TData = unknown, TError = DefaultErro
 } | {
     mutate: (variables: TVariables) => void;
     mutateAsync: (variables: TVariables) => Promise<TData | null>;
-    state$: import('rxjs').BehaviorSubject<Pick<import('@tanstack/react-query').UseMutationResult<TData | null, TError, {
-        variables: TVariables;
-        abort: AbortSignal;
-    }, TOnMutateResult>, "status" | "isPending" | "isError" | "isSuccess" | "isIdle">>;
+    state$: import('rxjs').BehaviorSubject<Pick<import('@tanstack/react-query').UseMutationResult<TData | null, TError, SwitchVariables<TVariables>, TOnMutateResult>, "status" | "isPending" | "isError" | "isSuccess" | "isIdle">>;
     data: TData | null;
     error: null;
-    variables: {
-        variables: TVariables;
-        abort: AbortSignal;
-    };
+    variables: SwitchVariables<TVariables>;
     isError: false;
     isIdle: false;
     isPending: false;
@@ -97,3 +90,4 @@ export declare function useSwitchMutation$<TData = unknown, TError = DefaultErro
     isPaused: boolean;
     submittedAt: number;
 };
+export {};

package/dist/lib/state/Signal.d.ts

@@ -21,7 +21,7 @@ export declare class Signal<T, K extends string | undefined = undefined> extends
         default: T;
         key: K;
     });
-    update: <U>(valueOrUpdater: ((prev: T) => U & ValidateShape<T, U>) | (T extends Function ? never : T) | typeof SIGNAL_RESET) => void;
+    update: <U extends T>(valueOrUpdater: ((prev: T) => U & ValidateShape<T, U>) | (T extends Function ? never : T) | typeof SIGNAL_RESET) => void;
     get key(): K;
 }
 export declare class VirtualSignal<T> {

package/dist/lib/utils/shouldRetry.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Whether to retry after `attempt` retries (0 before the first one): a
+ * function decides, a number caps the retries, `true` never stops, and no
+ * value never retries. TanStack Query reads a mutation's `retry` the same
+ * way, in a check it does not export.
+ */
+export declare const shouldRetry: <TError>(retry: boolean | number | ((attempt: number, error: TError) => boolean) | undefined, attempt: number, error: TError) => boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "reactjrx",
   "private": false,
-  "version": "4.0.5",
+  "version": "4.0.7",
   "type": "module",
   "files": [
     "dist"