reactjrx 1.141.5 → 1.142.0

package/dist/lib/binding/useObserve/store.d.ts

@@ -14,7 +14,7 @@ export declare class ObservableStore<T, DefaultValue, Error = unknown> {
     source$: Observable<T | undefined>;
     sub: Subscription;
     constructor({ source$: miscSource$, defaultValue, compareFn, }: {
-        source$: Observable<T> | (() => Observable<T> | undefined);
+        source$: Observable<T> | undefined | (() => Observable<T> | undefined);
     } & ObservableStoreOptions<T, DefaultValue>);
     subscribe: (next: () => void) => () => void;
     getSnapshot: () => State<T, DefaultValue, Error>;

package/dist/lib/binding/useObserve/useObserve.d.ts

@@ -6,10 +6,21 @@ interface Option<T, R = undefined> {
     defaultValue: R;
     compareFn?: (a: T, b: T) => boolean;
 }
+/**
+ * The source can be `undefined` (directly or returned from a factory). This is
+ * useful when the observable is not available yet (lazily created, coming from
+ * a state, a prop, etc). In that case the hook returns the default value with a
+ * `complete` observable state and will start observing as soon as an actual
+ * source is given.
+ */
+export declare function useObserve(source: undefined): UseObserveResult<never, undefined>;
+export declare function useObserve<DefaultValue>(source: undefined, options: Option<unknown, DefaultValue>): UseObserveResult<never, DefaultValue>;
 export declare function useObserve<T>(source: BehaviorSubject<T>): UseObserveResult<T, T>;
 export declare function useObserve<T>(source: BehaviorSubject<T>, options: Omit<Option<T>, "defaultValue">): UseObserveResult<T, T>;
-export declare function useObserve<T>(source: Observable<T>): UseObserveResult<T, undefined>;
+export declare function useObserve<T>(source: Observable<T> | undefined): UseObserveResult<T, undefined>;
 export declare function useObserve<T>(source: () => Observable<T>, deps: DependencyList): UseObserveResult<T, undefined>;
 export declare function useObserve<T>(source: () => Observable<T> | undefined, deps: DependencyList): UseObserveResult<T, undefined>;
-export declare function useObserve<T, DefaultValue>(source: Observable<T>, options: Option<T, DefaultValue>): UseObserveResult<T, DefaultValue>;
+export declare function useObserve<T, DefaultValue>(source: Observable<T> | undefined, options: Option<T, DefaultValue>): UseObserveResult<T, DefaultValue>;
+export declare function useObserve<T>(source: Observable<T> | undefined, options: Omit<Option<T>, "defaultValue">): UseObserveResult<T, undefined>;
 export declare function useObserve<T, DefaultValue>(source: () => Observable<T>, options: Option<T, DefaultValue>, deps: DependencyList): UseObserveResult<T, DefaultValue>;
+export declare function useObserve<T, DefaultValue>(source: () => Observable<T> | undefined, options: Option<T, DefaultValue>, deps: DependencyList): UseObserveResult<T, DefaultValue>;

package/dist/lib/binding/useObserve/useStore.d.ts

@@ -14,4 +14,4 @@ import { UseObserveOptions } from './types';
  * We are re-creating store during render cycles which is normally not recommended.
  * However this is "okay" since it is to be used inside a useSyncExternalStore and not directly in a render.
  */
-export declare const useStore: <T, DefaultValue>(source$: Observable<T> | (() => Observable<T> | undefined), options: UseObserveOptions<T, DefaultValue>, deps: DependencyList) => ObservableStore<T, DefaultValue | undefined>;
+export declare const useStore: <T, DefaultValue>(source$: Observable<T> | undefined | (() => Observable<T> | undefined), options: UseObserveOptions<T, DefaultValue>, deps: DependencyList) => ObservableStore<T, DefaultValue | undefined>;

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

@@ -0,0 +1,26 @@
+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;
+};
+/**
+ * Hooks built on top of `useMutation$` (`useSwitchMutation$`,
+ * `useConcatMutation$`) run their inner mutation with the user variables
+ * wrapped in an envelope (`{ variables, ... }`). 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/useConcatMutation$.d.ts

@@ -1,7 +1,7 @@
 import { DefaultError, MutationKey, QueryClient } from '@tanstack/react-query';
 import { BehaviorSubject, Subject } from 'rxjs';
 import { UseMutation$Options } from './useMutation$';
-export declare function useConcatMutation$<TData = unknown, TError = DefaultError, TVariables = void, TContext = unknown>({ onMutate, ...options }: UseMutation$Options<TData | null, TError, TVariables, TContext> & {
+export declare function useConcatMutation$<TData = unknown, TError = DefaultError, TVariables = void, TContext = unknown>(options: UseMutation$Options<TData | null, TError, TVariables, TContext> & {
     mutationKey: MutationKey;
 }, queryClient?: QueryClient): {
     mutate: (variables: TVariables) => void;

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

@@ -3,7 +3,7 @@ import { UseMutation$Options } from './useMutation$';
 export declare class SwitchMutationCancelError extends Error {
     constructor(message?: string);
 }
-export declare function useSwitchMutation$<TData = unknown, TError = DefaultError, TVariables = void, TOnMutateResult = unknown>({ mutationFn, onMutate, onError, onSettled, ...options }: UseMutation$Options<TData | null, TError, TVariables, TOnMutateResult>, queryClient?: QueryClient): {
+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, {

package/dist/tests/liveQuery.d.ts

@@ -1,6 +1,5 @@
 import { QueryClient } from '@tanstack/react-query';
 import { default as React } from 'react';
-export declare function isDefined<T>(value: T | undefined | null): value is T;
 export declare function createQueryClient(): QueryClient;
 export declare const liveQueryOptions: {
     networkMode: "always";

package/package.json

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