@tanstack/query-core 5.38.0 → 5.44.0

package/build/legacy/{types-BtrVwz9w.d.ts → hydration-DJZYTIMr.d.ts}

@@ -71,9 +71,10 @@ interface FetchMeta {
         direction: FetchDirection;
     };
 }
-interface FetchOptions {
+interface FetchOptions<TData = unknown> {
     cancelRefetch?: boolean;
     meta?: FetchMeta;
+    initialPromise?: Promise<TData>;
 }
 interface FailedAction$1<TError> {
     type: 'failed';
@@ -122,6 +123,7 @@ declare class Query<TQueryFnData = unknown, TError = DefaultError, TData = TQuer
     observers: Array<QueryObserver<any, any, any, any, any>>;
     constructor(config: QueryConfig<TQueryFnData, TError, TData, TQueryKey>);
     get meta(): QueryMeta | undefined;
+    get promise(): Promise<TData> | undefined;
     setOptions(options?: QueryOptions<TQueryFnData, TError, TData, TQueryKey>): void;
     protected optionalRemove(): void;
     setData(newData: TData, options?: SetDataOptions & {
@@ -141,7 +143,7 @@ declare class Query<TQueryFnData = unknown, TError = DefaultError, TData = TQuer
     removeObserver(observer: QueryObserver<any, any, any, any, any>): void;
     getObserversCount(): number;
     invalidate(): void;
-    fetch(options?: QueryOptions<TQueryFnData, TError, TData, TQueryKey>, fetchOptions?: FetchOptions): Promise<TData>;
+    fetch(options?: QueryOptions<TQueryFnData, TError, TData, TQueryKey>, fetchOptions?: FetchOptions<TQueryFnData>): Promise<TData>;
 }
 declare function fetchState<TQueryFnData, TError, TData, TQueryKey extends QueryKey>(data: TData | undefined, options: QueryOptions<TQueryFnData, TError, TData, TQueryKey>): {
     readonly error?: null | undefined;
@@ -202,6 +204,7 @@ declare function noop(): undefined;
 declare function functionalUpdate<TInput, TOutput>(updater: Updater<TInput, TOutput>, input: TInput): TOutput;
 declare function isValidTimeout(value: unknown): value is number;
 declare function timeUntilStale(updatedAt: number, staleTime?: number): number;
+declare function resolveStaleTime<TQueryFnData = unknown, TError = DefaultError, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey>(staleTime: undefined | StaleTime<TQueryFnData, TError, TData, TQueryKey>, query: Query<TQueryFnData, TError, TData, TQueryKey>): number | undefined;
 declare function matchQuery(filters: QueryFilters, query: Query<any, any, any, any>): boolean;
 declare function matchMutation(filters: MutationFilters, mutation: Mutation<any, any>): boolean;
 declare function hashQueryKeyByOptions<TQueryKey extends QueryKey = QueryKey>(queryKey: TQueryKey, options?: Pick<QueryOptions<any, any, any, any>, 'queryKeyHashFn'>): string;
@@ -233,6 +236,10 @@ declare function addToEnd<T>(items: Array<T>, item: T, max?: number): Array<T>;
 declare function addToStart<T>(items: Array<T>, item: T, max?: number): Array<T>;
 declare const skipToken: unique symbol;
 type SkipToken = typeof skipToken;
+declare const ensureQueryFn: <TQueryFnData = unknown, TQueryKey extends QueryKey = QueryKey>(options: {
+    queryFn?: typeof skipToken | QueryFunction<TQueryFnData, TQueryKey> | undefined;
+    queryHash?: string | undefined;
+}, fetchOptions?: FetchOptions<TQueryFnData> | undefined) => QueryFunction<TQueryFnData, TQueryKey>;
 
 interface QueryCacheConfig {
     onError?: (error: DefaultError, query: Query<unknown, unknown, unknown>) => void;
@@ -284,7 +291,7 @@ declare class QueryCache extends Subscribable<QueryCacheListener> {
     #private;
     config: QueryCacheConfig;
     constructor(config?: QueryCacheConfig);
-    build<TQueryFnData, TError, TData, TQueryKey extends QueryKey>(client: QueryClient, options: WithRequired<QueryOptions<TQueryFnData, TError, TData, TQueryKey>, 'queryKey'>, state?: QueryState<TData, TError>): Query<TQueryFnData, TError, TData, TQueryKey>;
+    build<TQueryFnData = unknown, TError = DefaultError, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey>(client: QueryClient, options: WithRequired<QueryOptions<TQueryFnData, TError, TData, TQueryKey>, 'queryKey'>, state?: QueryState<TData, TError>): Query<TQueryFnData, TError, TData, TQueryKey>;
     add(query: Query<any, any, any, any>): void;
     remove(query: Query<any, any, any, any>): void;
     clear(): void;
@@ -461,6 +468,7 @@ declare function getDefaultState<TData, TError, TVariables, TContext>(): Mutatio
 
 interface RetryerConfig<TData = unknown, TError = DefaultError> {
     fn: () => TData | Promise<TData>;
+    initialPromise?: Promise<TData>;
     abort?: () => void;
     onError?: (error: TError) => void;
     onSuccess?: (data: TData) => void;
@@ -507,6 +515,7 @@ type DataTag<TType, TValue> = TType & {
     [dataTagSymbol]: TValue;
 };
 type QueryFunction<T = unknown, TQueryKey extends QueryKey = QueryKey, TPageParam = never> = (context: QueryFunctionContext<TQueryKey, TPageParam>) => T | Promise<T>;
+type StaleTime<TQueryFnData = unknown, TError = DefaultError, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey> = number | ((query: Query<TQueryFnData, TError, TData, TQueryKey>) => number);
 type QueryPersister<T = unknown, TQueryKey extends QueryKey = QueryKey, TPageParam = never> = [TPageParam] extends [never] ? (queryFn: QueryFunction<T, TQueryKey, never>, context: QueryFunctionContext<TQueryKey>, query: Query) => T | Promise<T> : (queryFn: QueryFunction<T, TQueryKey, TPageParam>, context: QueryFunctionContext<TQueryKey>, query: Query) => T | Promise<T>;
 type QueryFunctionContext<TQueryKey extends QueryKey = QueryKey, TPageParam = never> = [TPageParam] extends [never] ? {
     queryKey: TQueryKey;
@@ -613,8 +622,9 @@ interface QueryObserverOptions<TQueryFnData = unknown, TError = DefaultError, TD
     /**
      * The time in milliseconds after data is considered stale.
      * If set to `Infinity`, the data will never be considered stale.
+     * If set to a function, the function will be executed with the query to compute a `staleTime`.
      */
-    staleTime?: number;
+    staleTime?: StaleTime<TQueryFnData, TError, TQueryData, TQueryKey>;
     /**
      * If set to a number, the query will continuously refetch at this frequency in milliseconds.
      * If set to a function, the function will be executed with the latest data and query to compute a frequency
@@ -700,7 +710,7 @@ interface FetchQueryOptions<TQueryFnData = unknown, TError = DefaultError, TData
      * The time in milliseconds after data is considered stale.
      * If the data is fresh it will be returned from the cache.
      */
-    staleTime?: number;
+    staleTime?: StaleTime<TQueryFnData, TError, TData, TQueryKey>;
 }
 interface EnsureQueryDataOptions<TQueryFnData = unknown, TError = DefaultError, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey, TPageParam = never> extends FetchQueryOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam> {
     revalidateIfStale?: boolean;
@@ -1173,6 +1183,8 @@ interface QueryClientConfig {
 interface DefaultOptions<TError = DefaultError> {
     queries?: OmitKeyof<QueryObserverOptions<unknown, TError>, 'suspense' | 'queryKey'>;
     mutations?: MutationObserverOptions<unknown, TError, unknown, unknown>;
+    hydrate?: HydrateOptions['defaultOptions'];
+    dehydrate?: DehydrateOptions;
 }
 interface CancelOptions {
     revert?: boolean;
@@ -1186,4 +1198,36 @@ interface NotifyEvent {
     type: NotifyEventType;
 }
 
-export { type DefaultedInfiniteQueryObserverOptions as $, type QueryKeyHashFunction as A, type GetNextPageParamFunction as B, CancelledError as C, type DefaultError as D, type InfiniteData as E, type QueryMeta as F, type GetPreviousPageParamFunction as G, type NetworkMode as H, type InitialDataFunction as I, type NotifyOnChangeProps as J, type QueryOptions as K, type InitialPageParam as L, MutationCache as M, type NoInfer as N, type OmitKeyof as O, type PlaceholderDataFunction as P, QueryCache as Q, type Register as R, type SkipToken as S, type InfiniteQueryPageParamsOptions as T, type Updater as U, type ThrowOnError as V, type QueryObserverOptions as W, type WithRequired as X, type Optional as Y, type DefaultedQueryObserverOptions as Z, type InfiniteQueryObserverOptions as _, type QueryCacheNotifyEvent as a, isValidTimeout as a$, type FetchQueryOptions as a0, type EnsureQueryDataOptions as a1, type FetchInfiniteQueryOptions as a2, type ResultOptions as a3, type RefetchOptions as a4, type InvalidateQueryFilters as a5, type RefetchQueryFilters as a6, type InvalidateOptions as a7, type ResetOptions as a8, type FetchNextPageOptions as a9, type MutateOptions as aA, type MutateFunction as aB, type MutationObserverBaseResult as aC, type MutationObserverIdleResult as aD, type MutationObserverLoadingResult as aE, type MutationObserverErrorResult as aF, type MutationObserverSuccessResult as aG, type MutationObserverResult as aH, type QueryClientConfig as aI, type DefaultOptions as aJ, type CancelOptions as aK, type SetDataOptions as aL, type NotifyEventType as aM, type NotifyEvent as aN, type QueryBehavior as aO, type ObserverFetchOptions as aP, type NotifyOptions as aQ, type FetchContext as aR, type FetchDirection as aS, type FetchMeta as aT, type FetchOptions as aU, type Action$1 as aV, type SetStateOptions as aW, fetchState as aX, type QueryTypeFilter as aY, noop as aZ, functionalUpdate as a_, type FetchPreviousPageOptions as aa, type QueryStatus as ab, type FetchStatus as ac, type QueryObserverBaseResult as ad, type QueryObserverPendingResult as ae, type QueryObserverLoadingResult as af, type QueryObserverLoadingErrorResult as ag, type QueryObserverRefetchErrorResult as ah, type QueryObserverSuccessResult as ai, type DefinedQueryObserverResult as aj, type QueryObserverResult as ak, type InfiniteQueryObserverBaseResult as al, type InfiniteQueryObserverPendingResult as am, type InfiniteQueryObserverLoadingResult as an, type InfiniteQueryObserverLoadingErrorResult as ao, type InfiniteQueryObserverRefetchErrorResult as ap, type InfiniteQueryObserverSuccessResult as aq, type DefinedInfiniteQueryObserverResult as ar, type InfiniteQueryObserverResult as as, type MutationKey as at, type MutationStatus as au, type MutationScope as av, type MutationMeta as aw, type MutationFunction as ax, type MutationOptions as ay, type MutationObserverOptions as az, QueryClient as b, timeUntilStale as b0, hashQueryKeyByOptions as b1, partialMatchKey as b2, shallowEqualObjects as b3, isPlainArray as b4, isPlainObject as b5, sleep as b6, replaceData as b7, addToEnd as b8, addToStart as b9, type QueryStore as ba, type Action as bb, getDefaultState as bc, type Retryer as bd, type RetryValue as be, type RetryDelayValue as bf, canFetch as bg, createRetryer as bh, QueryObserver as c, type MutationCacheNotifyEvent as d, MutationObserver as e, matchMutation as f, type MutationFilters as g, hashKey as h, isServer as i, type QueryFilters as j, keepPreviousData as k, isCancelledError as l, matchQuery as m, type QueryState as n, Query as o, Mutation as p, type MutationState as q, replaceEqualDeep as r, skipToken as s, type QueryKey as t, dataTagSymbol as u, type DataTag as v, type QueryFunction as w, type QueryPersister as x, type QueryFunctionContext as y, type QueriesPlaceholderDataFunction as z };
+interface DehydrateOptions {
+    shouldDehydrateMutation?: (mutation: Mutation) => boolean;
+    shouldDehydrateQuery?: (query: Query) => boolean;
+}
+interface HydrateOptions {
+    defaultOptions?: {
+        queries?: QueryOptions;
+        mutations?: MutationOptions<unknown, DefaultError, unknown, unknown>;
+    };
+}
+interface DehydratedMutation {
+    mutationKey?: MutationKey;
+    state: MutationState;
+    meta?: MutationMeta;
+    scope?: MutationScope;
+}
+interface DehydratedQuery {
+    queryHash: string;
+    queryKey: QueryKey;
+    state: QueryState;
+    promise?: Promise<unknown>;
+    meta?: QueryMeta;
+}
+interface DehydratedState {
+    mutations: Array<DehydratedMutation>;
+    queries: Array<DehydratedQuery>;
+}
+declare function defaultShouldDehydrateMutation(mutation: Mutation): boolean;
+declare function defaultShouldDehydrateQuery(query: Query): boolean;
+declare function dehydrate(client: QueryClient, options?: DehydrateOptions): DehydratedState;
+declare function hydrate(client: QueryClient, dehydratedState: unknown, options?: HydrateOptions): void;
+
+export { type InitialPageParam as $, dataTagSymbol as A, type DataTag as B, CancelledError as C, type DehydrateOptions as D, type QueryFunction as E, type StaleTime as F, type QueryPersister as G, type HydrateOptions as H, type QueryFunctionContext as I, type InitialDataFunction as J, type QueriesPlaceholderDataFunction as K, type QueryKeyHashFunction as L, MutationCache as M, type NoInfer as N, type OmitKeyof as O, type PlaceholderDataFunction as P, QueryCache as Q, type Register as R, type SkipToken as S, type GetPreviousPageParamFunction as T, type Updater as U, type GetNextPageParamFunction as V, type InfiniteData as W, type QueryMeta as X, type NetworkMode as Y, type NotifyOnChangeProps as Z, type QueryOptions as _, type QueryCacheNotifyEvent as a, type FetchMeta as a$, type InfiniteQueryPageParamsOptions as a0, type ThrowOnError as a1, type QueryObserverOptions as a2, type WithRequired as a3, type Optional as a4, type DefaultedQueryObserverOptions as a5, type InfiniteQueryObserverOptions as a6, type DefaultedInfiniteQueryObserverOptions as a7, type FetchQueryOptions as a8, type EnsureQueryDataOptions as a9, type InfiniteQueryObserverResult as aA, type MutationKey as aB, type MutationStatus as aC, type MutationScope as aD, type MutationMeta as aE, type MutationFunction as aF, type MutationOptions as aG, type MutationObserverOptions as aH, type MutateOptions as aI, type MutateFunction as aJ, type MutationObserverBaseResult as aK, type MutationObserverIdleResult as aL, type MutationObserverLoadingResult as aM, type MutationObserverErrorResult as aN, type MutationObserverSuccessResult as aO, type MutationObserverResult as aP, type QueryClientConfig as aQ, type DefaultOptions as aR, type CancelOptions as aS, type SetDataOptions as aT, type NotifyEventType as aU, type NotifyEvent as aV, type QueryBehavior as aW, type ObserverFetchOptions as aX, type NotifyOptions as aY, type FetchContext as aZ, type FetchDirection as a_, type FetchInfiniteQueryOptions as aa, type ResultOptions as ab, type RefetchOptions as ac, type InvalidateQueryFilters as ad, type RefetchQueryFilters as ae, type InvalidateOptions as af, type ResetOptions as ag, type FetchNextPageOptions as ah, type FetchPreviousPageOptions as ai, type QueryStatus as aj, type FetchStatus as ak, type QueryObserverBaseResult as al, type QueryObserverPendingResult as am, type QueryObserverLoadingResult as an, type QueryObserverLoadingErrorResult as ao, type QueryObserverRefetchErrorResult as ap, type QueryObserverSuccessResult as aq, type DefinedQueryObserverResult as ar, type QueryObserverResult as as, type InfiniteQueryObserverBaseResult as at, type InfiniteQueryObserverPendingResult as au, type InfiniteQueryObserverLoadingResult as av, type InfiniteQueryObserverLoadingErrorResult as aw, type InfiniteQueryObserverRefetchErrorResult as ax, type InfiniteQueryObserverSuccessResult as ay, type DefinedInfiniteQueryObserverResult as az, QueryClient as b, type FetchOptions as b0, type Action$1 as b1, type SetStateOptions as b2, fetchState as b3, type QueryTypeFilter as b4, noop as b5, functionalUpdate as b6, isValidTimeout as b7, timeUntilStale as b8, resolveStaleTime as b9, hashQueryKeyByOptions as ba, partialMatchKey as bb, shallowEqualObjects as bc, isPlainArray as bd, isPlainObject as be, sleep as bf, replaceData as bg, addToEnd as bh, addToStart as bi, ensureQueryFn as bj, type QueryStore as bk, type Action as bl, getDefaultState as bm, type Retryer as bn, type RetryValue as bo, type RetryDelayValue as bp, canFetch as bq, createRetryer as br, QueryObserver as c, type MutationCacheNotifyEvent as d, MutationObserver as e, matchMutation as f, type MutationFilters as g, hashKey as h, isServer as i, type QueryFilters as j, keepPreviousData as k, isCancelledError as l, matchQuery as m, dehydrate as n, hydrate as o, defaultShouldDehydrateQuery as p, defaultShouldDehydrateMutation as q, replaceEqualDeep as r, skipToken as s, type QueryState as t, Query as u, Mutation as v, type MutationState as w, type DehydratedState as x, type DefaultError as y, type QueryKey as z };

package/build/legacy/{types-BvcshvE9.d.cts → hydration-XP7CH-6g.d.cts}

@@ -71,9 +71,10 @@ interface FetchMeta {
         direction: FetchDirection;
     };
 }
-interface FetchOptions {
+interface FetchOptions<TData = unknown> {
     cancelRefetch?: boolean;
     meta?: FetchMeta;
+    initialPromise?: Promise<TData>;
 }
 interface FailedAction$1<TError> {
     type: 'failed';
@@ -122,6 +123,7 @@ declare class Query<TQueryFnData = unknown, TError = DefaultError, TData = TQuer
     observers: Array<QueryObserver<any, any, any, any, any>>;
     constructor(config: QueryConfig<TQueryFnData, TError, TData, TQueryKey>);
     get meta(): QueryMeta | undefined;
+    get promise(): Promise<TData> | undefined;
     setOptions(options?: QueryOptions<TQueryFnData, TError, TData, TQueryKey>): void;
     protected optionalRemove(): void;
     setData(newData: TData, options?: SetDataOptions & {
@@ -141,7 +143,7 @@ declare class Query<TQueryFnData = unknown, TError = DefaultError, TData = TQuer
     removeObserver(observer: QueryObserver<any, any, any, any, any>): void;
     getObserversCount(): number;
     invalidate(): void;
-    fetch(options?: QueryOptions<TQueryFnData, TError, TData, TQueryKey>, fetchOptions?: FetchOptions): Promise<TData>;
+    fetch(options?: QueryOptions<TQueryFnData, TError, TData, TQueryKey>, fetchOptions?: FetchOptions<TQueryFnData>): Promise<TData>;
 }
 declare function fetchState<TQueryFnData, TError, TData, TQueryKey extends QueryKey>(data: TData | undefined, options: QueryOptions<TQueryFnData, TError, TData, TQueryKey>): {
     readonly error?: null | undefined;
@@ -202,6 +204,7 @@ declare function noop(): undefined;
 declare function functionalUpdate<TInput, TOutput>(updater: Updater<TInput, TOutput>, input: TInput): TOutput;
 declare function isValidTimeout(value: unknown): value is number;
 declare function timeUntilStale(updatedAt: number, staleTime?: number): number;
+declare function resolveStaleTime<TQueryFnData = unknown, TError = DefaultError, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey>(staleTime: undefined | StaleTime<TQueryFnData, TError, TData, TQueryKey>, query: Query<TQueryFnData, TError, TData, TQueryKey>): number | undefined;
 declare function matchQuery(filters: QueryFilters, query: Query<any, any, any, any>): boolean;
 declare function matchMutation(filters: MutationFilters, mutation: Mutation<any, any>): boolean;
 declare function hashQueryKeyByOptions<TQueryKey extends QueryKey = QueryKey>(queryKey: TQueryKey, options?: Pick<QueryOptions<any, any, any, any>, 'queryKeyHashFn'>): string;
@@ -233,6 +236,10 @@ declare function addToEnd<T>(items: Array<T>, item: T, max?: number): Array<T>;
 declare function addToStart<T>(items: Array<T>, item: T, max?: number): Array<T>;
 declare const skipToken: unique symbol;
 type SkipToken = typeof skipToken;
+declare const ensureQueryFn: <TQueryFnData = unknown, TQueryKey extends QueryKey = QueryKey>(options: {
+    queryFn?: typeof skipToken | QueryFunction<TQueryFnData, TQueryKey> | undefined;
+    queryHash?: string | undefined;
+}, fetchOptions?: FetchOptions<TQueryFnData> | undefined) => QueryFunction<TQueryFnData, TQueryKey>;
 
 interface QueryCacheConfig {
     onError?: (error: DefaultError, query: Query<unknown, unknown, unknown>) => void;
@@ -284,7 +291,7 @@ declare class QueryCache extends Subscribable<QueryCacheListener> {
     #private;
     config: QueryCacheConfig;
     constructor(config?: QueryCacheConfig);
-    build<TQueryFnData, TError, TData, TQueryKey extends QueryKey>(client: QueryClient, options: WithRequired<QueryOptions<TQueryFnData, TError, TData, TQueryKey>, 'queryKey'>, state?: QueryState<TData, TError>): Query<TQueryFnData, TError, TData, TQueryKey>;
+    build<TQueryFnData = unknown, TError = DefaultError, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey>(client: QueryClient, options: WithRequired<QueryOptions<TQueryFnData, TError, TData, TQueryKey>, 'queryKey'>, state?: QueryState<TData, TError>): Query<TQueryFnData, TError, TData, TQueryKey>;
     add(query: Query<any, any, any, any>): void;
     remove(query: Query<any, any, any, any>): void;
     clear(): void;
@@ -461,6 +468,7 @@ declare function getDefaultState<TData, TError, TVariables, TContext>(): Mutatio
 
 interface RetryerConfig<TData = unknown, TError = DefaultError> {
     fn: () => TData | Promise<TData>;
+    initialPromise?: Promise<TData>;
     abort?: () => void;
     onError?: (error: TError) => void;
     onSuccess?: (data: TData) => void;
@@ -507,6 +515,7 @@ type DataTag<TType, TValue> = TType & {
     [dataTagSymbol]: TValue;
 };
 type QueryFunction<T = unknown, TQueryKey extends QueryKey = QueryKey, TPageParam = never> = (context: QueryFunctionContext<TQueryKey, TPageParam>) => T | Promise<T>;
+type StaleTime<TQueryFnData = unknown, TError = DefaultError, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey> = number | ((query: Query<TQueryFnData, TError, TData, TQueryKey>) => number);
 type QueryPersister<T = unknown, TQueryKey extends QueryKey = QueryKey, TPageParam = never> = [TPageParam] extends [never] ? (queryFn: QueryFunction<T, TQueryKey, never>, context: QueryFunctionContext<TQueryKey>, query: Query) => T | Promise<T> : (queryFn: QueryFunction<T, TQueryKey, TPageParam>, context: QueryFunctionContext<TQueryKey>, query: Query) => T | Promise<T>;
 type QueryFunctionContext<TQueryKey extends QueryKey = QueryKey, TPageParam = never> = [TPageParam] extends [never] ? {
     queryKey: TQueryKey;
@@ -613,8 +622,9 @@ interface QueryObserverOptions<TQueryFnData = unknown, TError = DefaultError, TD
     /**
      * The time in milliseconds after data is considered stale.
      * If set to `Infinity`, the data will never be considered stale.
+     * If set to a function, the function will be executed with the query to compute a `staleTime`.
      */
-    staleTime?: number;
+    staleTime?: StaleTime<TQueryFnData, TError, TQueryData, TQueryKey>;
     /**
      * If set to a number, the query will continuously refetch at this frequency in milliseconds.
      * If set to a function, the function will be executed with the latest data and query to compute a frequency
@@ -700,7 +710,7 @@ interface FetchQueryOptions<TQueryFnData = unknown, TError = DefaultError, TData
      * The time in milliseconds after data is considered stale.
      * If the data is fresh it will be returned from the cache.
      */
-    staleTime?: number;
+    staleTime?: StaleTime<TQueryFnData, TError, TData, TQueryKey>;
 }
 interface EnsureQueryDataOptions<TQueryFnData = unknown, TError = DefaultError, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey, TPageParam = never> extends FetchQueryOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam> {
     revalidateIfStale?: boolean;
@@ -1173,6 +1183,8 @@ interface QueryClientConfig {
 interface DefaultOptions<TError = DefaultError> {
     queries?: OmitKeyof<QueryObserverOptions<unknown, TError>, 'suspense' | 'queryKey'>;
     mutations?: MutationObserverOptions<unknown, TError, unknown, unknown>;
+    hydrate?: HydrateOptions['defaultOptions'];
+    dehydrate?: DehydrateOptions;
 }
 interface CancelOptions {
     revert?: boolean;
@@ -1186,4 +1198,36 @@ interface NotifyEvent {
     type: NotifyEventType;
 }
 
-export { type DefaultedInfiniteQueryObserverOptions as $, type QueryKeyHashFunction as A, type GetNextPageParamFunction as B, CancelledError as C, type DefaultError as D, type InfiniteData as E, type QueryMeta as F, type GetPreviousPageParamFunction as G, type NetworkMode as H, type InitialDataFunction as I, type NotifyOnChangeProps as J, type QueryOptions as K, type InitialPageParam as L, MutationCache as M, type NoInfer as N, type OmitKeyof as O, type PlaceholderDataFunction as P, QueryCache as Q, type Register as R, type SkipToken as S, type InfiniteQueryPageParamsOptions as T, type Updater as U, type ThrowOnError as V, type QueryObserverOptions as W, type WithRequired as X, type Optional as Y, type DefaultedQueryObserverOptions as Z, type InfiniteQueryObserverOptions as _, type QueryCacheNotifyEvent as a, isValidTimeout as a$, type FetchQueryOptions as a0, type EnsureQueryDataOptions as a1, type FetchInfiniteQueryOptions as a2, type ResultOptions as a3, type RefetchOptions as a4, type InvalidateQueryFilters as a5, type RefetchQueryFilters as a6, type InvalidateOptions as a7, type ResetOptions as a8, type FetchNextPageOptions as a9, type MutateOptions as aA, type MutateFunction as aB, type MutationObserverBaseResult as aC, type MutationObserverIdleResult as aD, type MutationObserverLoadingResult as aE, type MutationObserverErrorResult as aF, type MutationObserverSuccessResult as aG, type MutationObserverResult as aH, type QueryClientConfig as aI, type DefaultOptions as aJ, type CancelOptions as aK, type SetDataOptions as aL, type NotifyEventType as aM, type NotifyEvent as aN, type QueryBehavior as aO, type ObserverFetchOptions as aP, type NotifyOptions as aQ, type FetchContext as aR, type FetchDirection as aS, type FetchMeta as aT, type FetchOptions as aU, type Action$1 as aV, type SetStateOptions as aW, fetchState as aX, type QueryTypeFilter as aY, noop as aZ, functionalUpdate as a_, type FetchPreviousPageOptions as aa, type QueryStatus as ab, type FetchStatus as ac, type QueryObserverBaseResult as ad, type QueryObserverPendingResult as ae, type QueryObserverLoadingResult as af, type QueryObserverLoadingErrorResult as ag, type QueryObserverRefetchErrorResult as ah, type QueryObserverSuccessResult as ai, type DefinedQueryObserverResult as aj, type QueryObserverResult as ak, type InfiniteQueryObserverBaseResult as al, type InfiniteQueryObserverPendingResult as am, type InfiniteQueryObserverLoadingResult as an, type InfiniteQueryObserverLoadingErrorResult as ao, type InfiniteQueryObserverRefetchErrorResult as ap, type InfiniteQueryObserverSuccessResult as aq, type DefinedInfiniteQueryObserverResult as ar, type InfiniteQueryObserverResult as as, type MutationKey as at, type MutationStatus as au, type MutationScope as av, type MutationMeta as aw, type MutationFunction as ax, type MutationOptions as ay, type MutationObserverOptions as az, QueryClient as b, timeUntilStale as b0, hashQueryKeyByOptions as b1, partialMatchKey as b2, shallowEqualObjects as b3, isPlainArray as b4, isPlainObject as b5, sleep as b6, replaceData as b7, addToEnd as b8, addToStart as b9, type QueryStore as ba, type Action as bb, getDefaultState as bc, type Retryer as bd, type RetryValue as be, type RetryDelayValue as bf, canFetch as bg, createRetryer as bh, QueryObserver as c, type MutationCacheNotifyEvent as d, MutationObserver as e, matchMutation as f, type MutationFilters as g, hashKey as h, isServer as i, type QueryFilters as j, keepPreviousData as k, isCancelledError as l, matchQuery as m, type QueryState as n, Query as o, Mutation as p, type MutationState as q, replaceEqualDeep as r, skipToken as s, type QueryKey as t, dataTagSymbol as u, type DataTag as v, type QueryFunction as w, type QueryPersister as x, type QueryFunctionContext as y, type QueriesPlaceholderDataFunction as z };
+interface DehydrateOptions {
+    shouldDehydrateMutation?: (mutation: Mutation) => boolean;
+    shouldDehydrateQuery?: (query: Query) => boolean;
+}
+interface HydrateOptions {
+    defaultOptions?: {
+        queries?: QueryOptions;
+        mutations?: MutationOptions<unknown, DefaultError, unknown, unknown>;
+    };
+}
+interface DehydratedMutation {
+    mutationKey?: MutationKey;
+    state: MutationState;
+    meta?: MutationMeta;
+    scope?: MutationScope;
+}
+interface DehydratedQuery {
+    queryHash: string;
+    queryKey: QueryKey;
+    state: QueryState;
+    promise?: Promise<unknown>;
+    meta?: QueryMeta;
+}
+interface DehydratedState {
+    mutations: Array<DehydratedMutation>;
+    queries: Array<DehydratedQuery>;
+}
+declare function defaultShouldDehydrateMutation(mutation: Mutation): boolean;
+declare function defaultShouldDehydrateQuery(query: Query): boolean;
+declare function dehydrate(client: QueryClient, options?: DehydrateOptions): DehydratedState;
+declare function hydrate(client: QueryClient, dehydratedState: unknown, options?: HydrateOptions): void;
+
+export { type InitialPageParam as $, dataTagSymbol as A, type DataTag as B, CancelledError as C, type DehydrateOptions as D, type QueryFunction as E, type StaleTime as F, type QueryPersister as G, type HydrateOptions as H, type QueryFunctionContext as I, type InitialDataFunction as J, type QueriesPlaceholderDataFunction as K, type QueryKeyHashFunction as L, MutationCache as M, type NoInfer as N, type OmitKeyof as O, type PlaceholderDataFunction as P, QueryCache as Q, type Register as R, type SkipToken as S, type GetPreviousPageParamFunction as T, type Updater as U, type GetNextPageParamFunction as V, type InfiniteData as W, type QueryMeta as X, type NetworkMode as Y, type NotifyOnChangeProps as Z, type QueryOptions as _, type QueryCacheNotifyEvent as a, type FetchMeta as a$, type InfiniteQueryPageParamsOptions as a0, type ThrowOnError as a1, type QueryObserverOptions as a2, type WithRequired as a3, type Optional as a4, type DefaultedQueryObserverOptions as a5, type InfiniteQueryObserverOptions as a6, type DefaultedInfiniteQueryObserverOptions as a7, type FetchQueryOptions as a8, type EnsureQueryDataOptions as a9, type InfiniteQueryObserverResult as aA, type MutationKey as aB, type MutationStatus as aC, type MutationScope as aD, type MutationMeta as aE, type MutationFunction as aF, type MutationOptions as aG, type MutationObserverOptions as aH, type MutateOptions as aI, type MutateFunction as aJ, type MutationObserverBaseResult as aK, type MutationObserverIdleResult as aL, type MutationObserverLoadingResult as aM, type MutationObserverErrorResult as aN, type MutationObserverSuccessResult as aO, type MutationObserverResult as aP, type QueryClientConfig as aQ, type DefaultOptions as aR, type CancelOptions as aS, type SetDataOptions as aT, type NotifyEventType as aU, type NotifyEvent as aV, type QueryBehavior as aW, type ObserverFetchOptions as aX, type NotifyOptions as aY, type FetchContext as aZ, type FetchDirection as a_, type FetchInfiniteQueryOptions as aa, type ResultOptions as ab, type RefetchOptions as ac, type InvalidateQueryFilters as ad, type RefetchQueryFilters as ae, type InvalidateOptions as af, type ResetOptions as ag, type FetchNextPageOptions as ah, type FetchPreviousPageOptions as ai, type QueryStatus as aj, type FetchStatus as ak, type QueryObserverBaseResult as al, type QueryObserverPendingResult as am, type QueryObserverLoadingResult as an, type QueryObserverLoadingErrorResult as ao, type QueryObserverRefetchErrorResult as ap, type QueryObserverSuccessResult as aq, type DefinedQueryObserverResult as ar, type QueryObserverResult as as, type InfiniteQueryObserverBaseResult as at, type InfiniteQueryObserverPendingResult as au, type InfiniteQueryObserverLoadingResult as av, type InfiniteQueryObserverLoadingErrorResult as aw, type InfiniteQueryObserverRefetchErrorResult as ax, type InfiniteQueryObserverSuccessResult as ay, type DefinedInfiniteQueryObserverResult as az, QueryClient as b, type FetchOptions as b0, type Action$1 as b1, type SetStateOptions as b2, fetchState as b3, type QueryTypeFilter as b4, noop as b5, functionalUpdate as b6, isValidTimeout as b7, timeUntilStale as b8, resolveStaleTime as b9, hashQueryKeyByOptions as ba, partialMatchKey as bb, shallowEqualObjects as bc, isPlainArray as bd, isPlainObject as be, sleep as bf, replaceData as bg, addToEnd as bh, addToStart as bi, ensureQueryFn as bj, type QueryStore as bk, type Action as bl, getDefaultState as bm, type Retryer as bn, type RetryValue as bo, type RetryDelayValue as bp, canFetch as bq, createRetryer as br, QueryObserver as c, type MutationCacheNotifyEvent as d, MutationObserver as e, matchMutation as f, type MutationFilters as g, hashKey as h, isServer as i, type QueryFilters as j, keepPreviousData as k, isCancelledError as l, matchQuery as m, dehydrate as n, hydrate as o, defaultShouldDehydrateQuery as p, defaultShouldDehydrateMutation as q, replaceEqualDeep as r, skipToken as s, type QueryState as t, Query as u, Mutation as v, type MutationState as w, type DehydratedState as x, type DefaultError as y, type QueryKey as z };

package/build/legacy/hydration.cjs

@@ -35,10 +35,21 @@ function dehydrateMutation(mutation) {
   };
 }
 function dehydrateQuery(query) {
+  var _a;
   return {
     state: query.state,
     queryKey: query.queryKey,
     queryHash: query.queryHash,
+    ...query.state.status === "pending" && {
+      promise: (_a = query.promise) == null ? void 0 : _a.catch((error) => {
+        if (process.env.NODE_ENV !== "production") {
+          console.error(
+            `A query that was dehydrated as pending ended up rejecting. [${query.queryHash}]: ${error}; The error will be redacted in production builds`
+          );
+        }
+        return Promise.reject(new Error("redacted"));
+      })
+    },
     ...query.meta && { meta: query.meta }
   };
 }
@@ -49,11 +60,12 @@ function defaultShouldDehydrateQuery(query) {
   return query.state.status === "success";
 }
 function dehydrate(client, options = {}) {
-  const filterMutation = options.shouldDehydrateMutation ?? defaultShouldDehydrateMutation;
+  var _a, _b;
+  const filterMutation = options.shouldDehydrateMutation ?? ((_a = client.getDefaultOptions().dehydrate) == null ? void 0 : _a.shouldDehydrateMutation) ?? defaultShouldDehydrateMutation;
   const mutations = client.getMutationCache().getAll().flatMap(
     (mutation) => filterMutation(mutation) ? [dehydrateMutation(mutation)] : []
   );
-  const filterQuery = options.shouldDehydrateQuery ?? defaultShouldDehydrateQuery;
+  const filterQuery = options.shouldDehydrateQuery ?? ((_b = client.getDefaultOptions().dehydrate) == null ? void 0 : _b.shouldDehydrateQuery) ?? defaultShouldDehydrateQuery;
   const queries = client.getQueryCache().getAll().flatMap((query) => filterQuery(query) ? [dehydrateQuery(query)] : []);
   return { mutations, queries };
 }
@@ -66,41 +78,46 @@ function hydrate(client, dehydratedState, options) {
   const mutations = dehydratedState.mutations || [];
   const queries = dehydratedState.queries || [];
   mutations.forEach(({ state, ...mutationOptions }) => {
-    var _a;
+    var _a, _b;
     mutationCache.build(
       client,
       {
-        ...(_a = options == null ? void 0 : options.defaultOptions) == null ? void 0 : _a.mutations,
+        ...(_a = client.getDefaultOptions().hydrate) == null ? void 0 : _a.mutations,
+        ...(_b = options == null ? void 0 : options.defaultOptions) == null ? void 0 : _b.mutations,
         ...mutationOptions
       },
       state
     );
   });
-  queries.forEach(({ queryKey, state, queryHash, meta }) => {
-    var _a;
-    const query = queryCache.get(queryHash);
+  queries.forEach(({ queryKey, state, queryHash, meta, promise }) => {
+    var _a, _b;
+    let query = queryCache.get(queryHash);
     if (query) {
       if (query.state.dataUpdatedAt < state.dataUpdatedAt) {
         const { fetchStatus: _ignored, ...dehydratedQueryState } = state;
         query.setState(dehydratedQueryState);
       }
-      return;
+    } else {
+      query = queryCache.build(
+        client,
+        {
+          ...(_a = client.getDefaultOptions().hydrate) == null ? void 0 : _a.queries,
+          ...(_b = options == null ? void 0 : options.defaultOptions) == null ? void 0 : _b.queries,
+          queryKey,
+          queryHash,
+          meta
+        },
+        // Reset fetch status to idle to avoid
+        // query being stuck in fetching state upon hydration
+        {
+          ...state,
+          fetchStatus: "idle"
+        }
+      );
+    }
+    if (promise) {
+      void query.fetch(void 0, { initialPromise: promise });
     }
-    queryCache.build(
-      client,
-      {
-        ...(_a = options == null ? void 0 : options.defaultOptions) == null ? void 0 : _a.queries,
-        queryKey,
-        queryHash,
-        meta
-      },
-      // Reset fetch status to idle to avoid
-      // query being stuck in fetching state upon hydration
-      {
-        ...state,
-        fetchStatus: "idle"
-      }
-    );
   });
 }
 // Annotate the CommonJS export names for ESM import in node:

package/build/legacy/hydration.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hydration.ts"],"sourcesContent":["import type {\n  DefaultError,\n  MutationKey,\n  MutationMeta,\n  MutationOptions,\n  MutationScope,\n  QueryKey,\n  QueryMeta,\n  QueryOptions,\n} from './types'\nimport type { QueryClient } from './queryClient'\nimport type { Query, QueryState } from './query'\nimport type { Mutation, MutationState } from './mutation'\n\n// TYPES\n\nexport interface DehydrateOptions {\n  shouldDehydrateMutation?: (mutation: Mutation) => boolean\n  shouldDehydrateQuery?: (query: Query) => boolean\n}\n\nexport interface HydrateOptions {\n  defaultOptions?: {\n    queries?: QueryOptions\n    mutations?: MutationOptions<unknown, DefaultError, unknown, unknown>\n  }\n}\n\ninterface DehydratedMutation {\n  mutationKey?: MutationKey\n  state: MutationState\n  meta?: MutationMeta\n  scope?: MutationScope\n}\n\ninterface DehydratedQuery {\n  queryHash: string\n  queryKey: QueryKey\n  state: QueryState\n  meta?: QueryMeta\n}\n\nexport interface DehydratedState {\n  mutations: Array<DehydratedMutation>\n  queries: Array<DehydratedQuery>\n}\n\n// FUNCTIONS\n\nfunction dehydrateMutation(mutation: Mutation): DehydratedMutation {\n  return {\n    mutationKey: mutation.options.mutationKey,\n    state: mutation.state,\n    ...(mutation.options.scope && { scope: mutation.options.scope }),\n    ...(mutation.meta && { meta: mutation.meta }),\n  }\n}\n\n// Most config is not dehydrated but instead meant to configure again when\n// consuming the de/rehydrated data, typically with useQuery on the client.\n// Sometimes it might make sense to prefetch data on the server and include\n// in the html-payload, but not consume it on the initial render.\nfunction dehydrateQuery(query: Query): DehydratedQuery {\n  return {\n    state: query.state,\n    queryKey: query.queryKey,\n    queryHash: query.queryHash,\n    ...(query.meta && { meta: query.meta }),\n  }\n}\n\nexport function defaultShouldDehydrateMutation(mutation: Mutation) {\n  return mutation.state.isPaused\n}\n\nexport function defaultShouldDehydrateQuery(query: Query) {\n  return query.state.status === 'success'\n}\n\nexport function dehydrate(\n  client: QueryClient,\n  options: DehydrateOptions = {},\n): DehydratedState {\n  const filterMutation =\n    options.shouldDehydrateMutation ?? defaultShouldDehydrateMutation\n\n  const mutations = client\n    .getMutationCache()\n    .getAll()\n    .flatMap((mutation) =>\n      filterMutation(mutation) ? [dehydrateMutation(mutation)] : [],\n    )\n\n  const filterQuery =\n    options.shouldDehydrateQuery ?? defaultShouldDehydrateQuery\n\n  const queries = client\n    .getQueryCache()\n    .getAll()\n    .flatMap((query) => (filterQuery(query) ? [dehydrateQuery(query)] : []))\n\n  return { mutations, queries }\n}\n\nexport function hydrate(\n  client: QueryClient,\n  dehydratedState: unknown,\n  options?: HydrateOptions,\n): void {\n  if (typeof dehydratedState !== 'object' || dehydratedState === null) {\n    return\n  }\n\n  const mutationCache = client.getMutationCache()\n  const queryCache = client.getQueryCache()\n\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  const mutations = (dehydratedState as DehydratedState).mutations || []\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  const queries = (dehydratedState as DehydratedState).queries || []\n\n  mutations.forEach(({ state, ...mutationOptions }) => {\n    mutationCache.build(\n      client,\n      {\n        ...options?.defaultOptions?.mutations,\n        ...mutationOptions,\n      },\n      state,\n    )\n  })\n\n  queries.forEach(({ queryKey, state, queryHash, meta }) => {\n    const query = queryCache.get(queryHash)\n\n    // Do not hydrate if an existing query exists with newer data\n    if (query) {\n      if (query.state.dataUpdatedAt < state.dataUpdatedAt) {\n        // omit fetchStatus from dehydrated state\n        // so that query stays in its current fetchStatus\n        const { fetchStatus: _ignored, ...dehydratedQueryState } = state\n        query.setState(dehydratedQueryState)\n      }\n      return\n    }\n\n    // Restore query\n    queryCache.build(\n      client,\n      {\n        ...options?.defaultOptions?.queries,\n        queryKey,\n        queryHash,\n        meta,\n      },\n      // Reset fetch status to idle to avoid\n      // query being stuck in fetching state upon hydration\n      {\n        ...state,\n        fetchStatus: 'idle',\n      },\n    )\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiDA,SAAS,kBAAkB,UAAwC;AACjE,SAAO;AAAA,IACL,aAAa,SAAS,QAAQ;AAAA,IAC9B,OAAO,SAAS;AAAA,IAChB,GAAI,SAAS,QAAQ,SAAS,EAAE,OAAO,SAAS,QAAQ,MAAM;AAAA,IAC9D,GAAI,SAAS,QAAQ,EAAE,MAAM,SAAS,KAAK;AAAA,EAC7C;AACF;AAMA,SAAS,eAAe,OAA+B;AACrD,SAAO;AAAA,IACL,OAAO,MAAM;AAAA,IACb,UAAU,MAAM;AAAA,IAChB,WAAW,MAAM;AAAA,IACjB,GAAI,MAAM,QAAQ,EAAE,MAAM,MAAM,KAAK;AAAA,EACvC;AACF;AAEO,SAAS,+BAA+B,UAAoB;AACjE,SAAO,SAAS,MAAM;AACxB;AAEO,SAAS,4BAA4B,OAAc;AACxD,SAAO,MAAM,MAAM,WAAW;AAChC;AAEO,SAAS,UACd,QACA,UAA4B,CAAC,GACZ;AACjB,QAAM,iBACJ,QAAQ,2BAA2B;AAErC,QAAM,YAAY,OACf,iBAAiB,EACjB,OAAO,EACP;AAAA,IAAQ,CAAC,aACR,eAAe,QAAQ,IAAI,CAAC,kBAAkB,QAAQ,CAAC,IAAI,CAAC;AAAA,EAC9D;AAEF,QAAM,cACJ,QAAQ,wBAAwB;AAElC,QAAM,UAAU,OACb,cAAc,EACd,OAAO,EACP,QAAQ,CAAC,UAAW,YAAY,KAAK,IAAI,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,CAAE;AAEzE,SAAO,EAAE,WAAW,QAAQ;AAC9B;AAEO,SAAS,QACd,QACA,iBACA,SACM;AACN,MAAI,OAAO,oBAAoB,YAAY,oBAAoB,MAAM;AACnE;AAAA,EACF;AAEA,QAAM,gBAAgB,OAAO,iBAAiB;AAC9C,QAAM,aAAa,OAAO,cAAc;AAGxC,QAAM,YAAa,gBAAoC,aAAa,CAAC;AAErE,QAAM,UAAW,gBAAoC,WAAW,CAAC;AAEjE,YAAU,QAAQ,CAAC,EAAE,OAAO,GAAG,gBAAgB,MAAM;AAzHvD;AA0HI,kBAAc;AAAA,MACZ;AAAA,MACA;AAAA,QACE,IAAG,wCAAS,mBAAT,mBAAyB;AAAA,QAC5B,GAAG;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AAED,UAAQ,QAAQ,CAAC,EAAE,UAAU,OAAO,WAAW,KAAK,MAAM;AApI5D;AAqII,UAAM,QAAQ,WAAW,IAAI,SAAS;AAGtC,QAAI,OAAO;AACT,UAAI,MAAM,MAAM,gBAAgB,MAAM,eAAe;AAGnD,cAAM,EAAE,aAAa,UAAU,GAAG,qBAAqB,IAAI;AAC3D,cAAM,SAAS,oBAAoB;AAAA,MACrC;AACA;AAAA,IACF;AAGA,eAAW;AAAA,MACT;AAAA,MACA;AAAA,QACE,IAAG,wCAAS,mBAAT,mBAAyB;AAAA,QAC5B;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA;AAAA;AAAA,MAGA;AAAA,QACE,GAAG;AAAA,QACH,aAAa;AAAA,MACf;AAAA,IACF;AAAA,EACF,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../../src/hydration.ts"],"sourcesContent":["import type {\n  DefaultError,\n  MutationKey,\n  MutationMeta,\n  MutationOptions,\n  MutationScope,\n  QueryKey,\n  QueryMeta,\n  QueryOptions,\n} from './types'\nimport type { QueryClient } from './queryClient'\nimport type { Query, QueryState } from './query'\nimport type { Mutation, MutationState } from './mutation'\n\n// TYPES\n\nexport interface DehydrateOptions {\n  shouldDehydrateMutation?: (mutation: Mutation) => boolean\n  shouldDehydrateQuery?: (query: Query) => boolean\n}\n\nexport interface HydrateOptions {\n  defaultOptions?: {\n    queries?: QueryOptions\n    mutations?: MutationOptions<unknown, DefaultError, unknown, unknown>\n  }\n}\n\ninterface DehydratedMutation {\n  mutationKey?: MutationKey\n  state: MutationState\n  meta?: MutationMeta\n  scope?: MutationScope\n}\n\ninterface DehydratedQuery {\n  queryHash: string\n  queryKey: QueryKey\n  state: QueryState\n  promise?: Promise<unknown>\n  meta?: QueryMeta\n}\n\nexport interface DehydratedState {\n  mutations: Array<DehydratedMutation>\n  queries: Array<DehydratedQuery>\n}\n\n// FUNCTIONS\n\nfunction dehydrateMutation(mutation: Mutation): DehydratedMutation {\n  return {\n    mutationKey: mutation.options.mutationKey,\n    state: mutation.state,\n    ...(mutation.options.scope && { scope: mutation.options.scope }),\n    ...(mutation.meta && { meta: mutation.meta }),\n  }\n}\n\n// Most config is not dehydrated but instead meant to configure again when\n// consuming the de/rehydrated data, typically with useQuery on the client.\n// Sometimes it might make sense to prefetch data on the server and include\n// in the html-payload, but not consume it on the initial render.\nfunction dehydrateQuery(query: Query): DehydratedQuery {\n  return {\n    state: query.state,\n    queryKey: query.queryKey,\n    queryHash: query.queryHash,\n    ...(query.state.status === 'pending' && {\n      promise: query.promise?.catch((error) => {\n        if (process.env.NODE_ENV !== 'production') {\n          console.error(\n            `A query that was dehydrated as pending ended up rejecting. [${query.queryHash}]: ${error}; The error will be redacted in production builds`,\n          )\n        }\n        return Promise.reject(new Error('redacted'))\n      }),\n    }),\n    ...(query.meta && { meta: query.meta }),\n  }\n}\n\nexport function defaultShouldDehydrateMutation(mutation: Mutation) {\n  return mutation.state.isPaused\n}\n\nexport function defaultShouldDehydrateQuery(query: Query) {\n  return query.state.status === 'success'\n}\n\nexport function dehydrate(\n  client: QueryClient,\n  options: DehydrateOptions = {},\n): DehydratedState {\n  const filterMutation =\n    options.shouldDehydrateMutation ??\n    client.getDefaultOptions().dehydrate?.shouldDehydrateMutation ??\n    defaultShouldDehydrateMutation\n\n  const mutations = client\n    .getMutationCache()\n    .getAll()\n    .flatMap((mutation) =>\n      filterMutation(mutation) ? [dehydrateMutation(mutation)] : [],\n    )\n\n  const filterQuery =\n    options.shouldDehydrateQuery ??\n    client.getDefaultOptions().dehydrate?.shouldDehydrateQuery ??\n    defaultShouldDehydrateQuery\n\n  const queries = client\n    .getQueryCache()\n    .getAll()\n    .flatMap((query) => (filterQuery(query) ? [dehydrateQuery(query)] : []))\n\n  return { mutations, queries }\n}\n\nexport function hydrate(\n  client: QueryClient,\n  dehydratedState: unknown,\n  options?: HydrateOptions,\n): void {\n  if (typeof dehydratedState !== 'object' || dehydratedState === null) {\n    return\n  }\n\n  const mutationCache = client.getMutationCache()\n  const queryCache = client.getQueryCache()\n\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  const mutations = (dehydratedState as DehydratedState).mutations || []\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  const queries = (dehydratedState as DehydratedState).queries || []\n\n  mutations.forEach(({ state, ...mutationOptions }) => {\n    mutationCache.build(\n      client,\n      {\n        ...client.getDefaultOptions().hydrate?.mutations,\n        ...options?.defaultOptions?.mutations,\n        ...mutationOptions,\n      },\n      state,\n    )\n  })\n\n  queries.forEach(({ queryKey, state, queryHash, meta, promise }) => {\n    let query = queryCache.get(queryHash)\n\n    // Do not hydrate if an existing query exists with newer data\n    if (query) {\n      if (query.state.dataUpdatedAt < state.dataUpdatedAt) {\n        // omit fetchStatus from dehydrated state\n        // so that query stays in its current fetchStatus\n        const { fetchStatus: _ignored, ...dehydratedQueryState } = state\n        query.setState(dehydratedQueryState)\n      }\n    } else {\n      // Restore query\n      query = queryCache.build(\n        client,\n        {\n          ...client.getDefaultOptions().hydrate?.queries,\n          ...options?.defaultOptions?.queries,\n          queryKey,\n          queryHash,\n          meta,\n        },\n        // Reset fetch status to idle to avoid\n        // query being stuck in fetching state upon hydration\n        {\n          ...state,\n          fetchStatus: 'idle',\n        },\n      )\n    }\n\n    if (promise) {\n      // this doesn't actually fetch - it just creates a retryer\n      // which will re-use the passed `initialPromise`\n      void query.fetch(undefined, { initialPromise: promise })\n    }\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkDA,SAAS,kBAAkB,UAAwC;AACjE,SAAO;AAAA,IACL,aAAa,SAAS,QAAQ;AAAA,IAC9B,OAAO,SAAS;AAAA,IAChB,GAAI,SAAS,QAAQ,SAAS,EAAE,OAAO,SAAS,QAAQ,MAAM;AAAA,IAC9D,GAAI,SAAS,QAAQ,EAAE,MAAM,SAAS,KAAK;AAAA,EAC7C;AACF;AAMA,SAAS,eAAe,OAA+B;AA/DvD;AAgEE,SAAO;AAAA,IACL,OAAO,MAAM;AAAA,IACb,UAAU,MAAM;AAAA,IAChB,WAAW,MAAM;AAAA,IACjB,GAAI,MAAM,MAAM,WAAW,aAAa;AAAA,MACtC,UAAS,WAAM,YAAN,mBAAe,MAAM,CAAC,UAAU;AACvC,YAAI,QAAQ,IAAI,aAAa,cAAc;AACzC,kBAAQ;AAAA,YACN,+DAA+D,MAAM,SAAS,MAAM,KAAK;AAAA,UAC3F;AAAA,QACF;AACA,eAAO,QAAQ,OAAO,IAAI,MAAM,UAAU,CAAC;AAAA,MAC7C;AAAA,IACF;AAAA,IACA,GAAI,MAAM,QAAQ,EAAE,MAAM,MAAM,KAAK;AAAA,EACvC;AACF;AAEO,SAAS,+BAA+B,UAAoB;AACjE,SAAO,SAAS,MAAM;AACxB;AAEO,SAAS,4BAA4B,OAAc;AACxD,SAAO,MAAM,MAAM,WAAW;AAChC;AAEO,SAAS,UACd,QACA,UAA4B,CAAC,GACZ;AA7FnB;AA8FE,QAAM,iBACJ,QAAQ,6BACR,YAAO,kBAAkB,EAAE,cAA3B,mBAAsC,4BACtC;AAEF,QAAM,YAAY,OACf,iBAAiB,EACjB,OAAO,EACP;AAAA,IAAQ,CAAC,aACR,eAAe,QAAQ,IAAI,CAAC,kBAAkB,QAAQ,CAAC,IAAI,CAAC;AAAA,EAC9D;AAEF,QAAM,cACJ,QAAQ,0BACR,YAAO,kBAAkB,EAAE,cAA3B,mBAAsC,yBACtC;AAEF,QAAM,UAAU,OACb,cAAc,EACd,OAAO,EACP,QAAQ,CAAC,UAAW,YAAY,KAAK,IAAI,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,CAAE;AAEzE,SAAO,EAAE,WAAW,QAAQ;AAC9B;AAEO,SAAS,QACd,QACA,iBACA,SACM;AACN,MAAI,OAAO,oBAAoB,YAAY,oBAAoB,MAAM;AACnE;AAAA,EACF;AAEA,QAAM,gBAAgB,OAAO,iBAAiB;AAC9C,QAAM,aAAa,OAAO,cAAc;AAGxC,QAAM,YAAa,gBAAoC,aAAa,CAAC;AAErE,QAAM,UAAW,gBAAoC,WAAW,CAAC;AAEjE,YAAU,QAAQ,CAAC,EAAE,OAAO,GAAG,gBAAgB,MAAM;AAxIvD;AAyII,kBAAc;AAAA,MACZ;AAAA,MACA;AAAA,QACE,IAAG,YAAO,kBAAkB,EAAE,YAA3B,mBAAoC;AAAA,QACvC,IAAG,wCAAS,mBAAT,mBAAyB;AAAA,QAC5B,GAAG;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AAED,UAAQ,QAAQ,CAAC,EAAE,UAAU,OAAO,WAAW,MAAM,QAAQ,MAAM;AApJrE;AAqJI,QAAI,QAAQ,WAAW,IAAI,SAAS;AAGpC,QAAI,OAAO;AACT,UAAI,MAAM,MAAM,gBAAgB,MAAM,eAAe;AAGnD,cAAM,EAAE,aAAa,UAAU,GAAG,qBAAqB,IAAI;AAC3D,cAAM,SAAS,oBAAoB;AAAA,MACrC;AAAA,IACF,OAAO;AAEL,cAAQ,WAAW;AAAA,QACjB;AAAA,QACA;AAAA,UACE,IAAG,YAAO,kBAAkB,EAAE,YAA3B,mBAAoC;AAAA,UACvC,IAAG,wCAAS,mBAAT,mBAAyB;AAAA,UAC5B;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA;AAAA;AAAA,QAGA;AAAA,UACE,GAAG;AAAA,UACH,aAAa;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAEA,QAAI,SAAS;AAGX,WAAK,MAAM,MAAM,QAAW,EAAE,gBAAgB,QAAQ,CAAC;AAAA,IACzD;AAAA,EACF,CAAC;AACH;","names":[]}

package/build/legacy/hydration.d.cts

@@ -1,36 +1,3 @@
-import { p as Mutation, o as Query, K as QueryOptions, ay as MutationOptions, D as DefaultError, b as QueryClient, at as MutationKey, q as MutationState, aw as MutationMeta, av as MutationScope, t as QueryKey, n as QueryState, F as QueryMeta } from './types-BvcshvE9.cjs';
+export { D as DehydrateOptions, x as DehydratedState, H as HydrateOptions, q as defaultShouldDehydrateMutation, p as defaultShouldDehydrateQuery, n as dehydrate, o as hydrate } from './hydration-XP7CH-6g.cjs';
 import './removable.cjs';
 import './subscribable.cjs';
-
-interface DehydrateOptions {
-    shouldDehydrateMutation?: (mutation: Mutation) => boolean;
-    shouldDehydrateQuery?: (query: Query) => boolean;
-}
-interface HydrateOptions {
-    defaultOptions?: {
-        queries?: QueryOptions;
-        mutations?: MutationOptions<unknown, DefaultError, unknown, unknown>;
-    };
-}
-interface DehydratedMutation {
-    mutationKey?: MutationKey;
-    state: MutationState;
-    meta?: MutationMeta;
-    scope?: MutationScope;
-}
-interface DehydratedQuery {
-    queryHash: string;
-    queryKey: QueryKey;
-    state: QueryState;
-    meta?: QueryMeta;
-}
-interface DehydratedState {
-    mutations: Array<DehydratedMutation>;
-    queries: Array<DehydratedQuery>;
-}
-declare function defaultShouldDehydrateMutation(mutation: Mutation): boolean;
-declare function defaultShouldDehydrateQuery(query: Query): boolean;
-declare function dehydrate(client: QueryClient, options?: DehydrateOptions): DehydratedState;
-declare function hydrate(client: QueryClient, dehydratedState: unknown, options?: HydrateOptions): void;
-
-export { type DehydrateOptions, type DehydratedState, type HydrateOptions, defaultShouldDehydrateMutation, defaultShouldDehydrateQuery, dehydrate, hydrate };

package/build/legacy/hydration.d.ts

@@ -1,36 +1,3 @@
-import { p as Mutation, o as Query, K as QueryOptions, ay as MutationOptions, D as DefaultError, b as QueryClient, at as MutationKey, q as MutationState, aw as MutationMeta, av as MutationScope, t as QueryKey, n as QueryState, F as QueryMeta } from './types-BtrVwz9w.js';
+export { D as DehydrateOptions, x as DehydratedState, H as HydrateOptions, q as defaultShouldDehydrateMutation, p as defaultShouldDehydrateQuery, n as dehydrate, o as hydrate } from './hydration-DJZYTIMr.js';
 import './removable.js';
 import './subscribable.js';
-
-interface DehydrateOptions {
-    shouldDehydrateMutation?: (mutation: Mutation) => boolean;
-    shouldDehydrateQuery?: (query: Query) => boolean;
-}
-interface HydrateOptions {
-    defaultOptions?: {
-        queries?: QueryOptions;
-        mutations?: MutationOptions<unknown, DefaultError, unknown, unknown>;
-    };
-}
-interface DehydratedMutation {
-    mutationKey?: MutationKey;
-    state: MutationState;
-    meta?: MutationMeta;
-    scope?: MutationScope;
-}
-interface DehydratedQuery {
-    queryHash: string;
-    queryKey: QueryKey;
-    state: QueryState;
-    meta?: QueryMeta;
-}
-interface DehydratedState {
-    mutations: Array<DehydratedMutation>;
-    queries: Array<DehydratedQuery>;
-}
-declare function defaultShouldDehydrateMutation(mutation: Mutation): boolean;
-declare function defaultShouldDehydrateQuery(query: Query): boolean;
-declare function dehydrate(client: QueryClient, options?: DehydrateOptions): DehydratedState;
-declare function hydrate(client: QueryClient, dehydratedState: unknown, options?: HydrateOptions): void;
-
-export { type DehydrateOptions, type DehydratedState, type HydrateOptions, defaultShouldDehydrateMutation, defaultShouldDehydrateQuery, dehydrate, hydrate };

package/build/legacy/hydration.js

@@ -10,10 +10,21 @@ function dehydrateMutation(mutation) {
   };
 }
 function dehydrateQuery(query) {
+  var _a;
   return {
     state: query.state,
     queryKey: query.queryKey,
     queryHash: query.queryHash,
+    ...query.state.status === "pending" && {
+      promise: (_a = query.promise) == null ? void 0 : _a.catch((error) => {
+        if (process.env.NODE_ENV !== "production") {
+          console.error(
+            `A query that was dehydrated as pending ended up rejecting. [${query.queryHash}]: ${error}; The error will be redacted in production builds`
+          );
+        }
+        return Promise.reject(new Error("redacted"));
+      })
+    },
     ...query.meta && { meta: query.meta }
   };
 }
@@ -24,11 +35,12 @@ function defaultShouldDehydrateQuery(query) {
   return query.state.status === "success";
 }
 function dehydrate(client, options = {}) {
-  const filterMutation = options.shouldDehydrateMutation ?? defaultShouldDehydrateMutation;
+  var _a, _b;
+  const filterMutation = options.shouldDehydrateMutation ?? ((_a = client.getDefaultOptions().dehydrate) == null ? void 0 : _a.shouldDehydrateMutation) ?? defaultShouldDehydrateMutation;
   const mutations = client.getMutationCache().getAll().flatMap(
     (mutation) => filterMutation(mutation) ? [dehydrateMutation(mutation)] : []
   );
-  const filterQuery = options.shouldDehydrateQuery ?? defaultShouldDehydrateQuery;
+  const filterQuery = options.shouldDehydrateQuery ?? ((_b = client.getDefaultOptions().dehydrate) == null ? void 0 : _b.shouldDehydrateQuery) ?? defaultShouldDehydrateQuery;
   const queries = client.getQueryCache().getAll().flatMap((query) => filterQuery(query) ? [dehydrateQuery(query)] : []);
   return { mutations, queries };
 }
@@ -41,41 +53,46 @@ function hydrate(client, dehydratedState, options) {
   const mutations = dehydratedState.mutations || [];
   const queries = dehydratedState.queries || [];
   mutations.forEach(({ state, ...mutationOptions }) => {
-    var _a;
+    var _a, _b;
     mutationCache.build(
       client,
       {
-        ...(_a = options == null ? void 0 : options.defaultOptions) == null ? void 0 : _a.mutations,
+        ...(_a = client.getDefaultOptions().hydrate) == null ? void 0 : _a.mutations,
+        ...(_b = options == null ? void 0 : options.defaultOptions) == null ? void 0 : _b.mutations,
         ...mutationOptions
       },
       state
     );
   });
-  queries.forEach(({ queryKey, state, queryHash, meta }) => {
-    var _a;
-    const query = queryCache.get(queryHash);
+  queries.forEach(({ queryKey, state, queryHash, meta, promise }) => {
+    var _a, _b;
+    let query = queryCache.get(queryHash);
     if (query) {
       if (query.state.dataUpdatedAt < state.dataUpdatedAt) {
         const { fetchStatus: _ignored, ...dehydratedQueryState } = state;
         query.setState(dehydratedQueryState);
       }
-      return;
+    } else {
+      query = queryCache.build(
+        client,
+        {
+          ...(_a = client.getDefaultOptions().hydrate) == null ? void 0 : _a.queries,
+          ...(_b = options == null ? void 0 : options.defaultOptions) == null ? void 0 : _b.queries,
+          queryKey,
+          queryHash,
+          meta
+        },
+        // Reset fetch status to idle to avoid
+        // query being stuck in fetching state upon hydration
+        {
+          ...state,
+          fetchStatus: "idle"
+        }
+      );
+    }
+    if (promise) {
+      void query.fetch(void 0, { initialPromise: promise });
     }
-    queryCache.build(
-      client,
-      {
-        ...(_a = options == null ? void 0 : options.defaultOptions) == null ? void 0 : _a.queries,
-        queryKey,
-        queryHash,
-        meta
-      },
-      // Reset fetch status to idle to avoid
-      // query being stuck in fetching state upon hydration
-      {
-        ...state,
-        fetchStatus: "idle"
-      }
-    );
   });
 }
 export {