reactjrx 1.142.1 → 1.142.3

package/dist/lib/binding/useLiveBehaviorSubject.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -12,11 +12,16 @@ type CacheEntry = {
 };
 export declare class QueryClient$ {
     readonly queryClient: QueryClient;
-    readonly queryMap: Map<string, CacheEntry>;
+    /**
+     * Keyed by the query's own `queryKey` array: the one TanStack passes to
+     * `queryFn` and exposes as `query.queryKey`. Entries therefore match their
+     * query whatever its `queryKeyHashFn`, and nothing is hashed.
+     */
+    readonly queryMap: Map<QueryKey, CacheEntry>;
     constructor(queryClient: QueryClient);
-    getQuery(queryHash: string): CacheEntry | undefined;
+    getQuery(queryKey: QueryKey): CacheEntry | undefined;
     setQuery(queryKey: QueryKey, query$: Observable<unknown>, signal: AbortSignal): CacheEntry;
-    deleteQuery(queryHash: string, { cancelQuery }?: {
+    deleteQuery(queryKey: QueryKey, { cancelQuery }?: {
         cancelQuery?: boolean;
     }): void;
     destroy(): void;

package/dist/lib/queries/QueryClientProvider$.liveQuery.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/state/persistence/persistSignals.d.ts

@@ -1,20 +1,30 @@
+import { Observable } from 'rxjs';
 import { Signal } from '../Signal';
 import { Adapter } from './adapters/Adapter';
 import { SignalPersistenceConfig } from './types';
-export declare function persistSignals({ entries, onHydrated, adapter, }: {
-    entries: Array<SignalPersistenceConfig<Signal<any, string>>>;
+type AnySignal = Signal<any, string>;
+type Entry = SignalPersistenceConfig<AnySignal>;
+/**
+ * Hydrates the signals of the latest `entries$` list from the adapter, then
+ * persists their updates to it. Entries are matched by signal, so a new array
+ * holding the same signals changes nothing:
+ * - an added signal is hydrated, then persisted;
+ * - a signal still in the list keeps running untouched;
+ * - a removed signal stops being persisted, after its pending value is saved.
+ *
+ * Emits `{ type: "hydrated" }` once, the first time every entry added so far
+ * has been hydrated (right away for an empty list). An entry that fails to
+ * hydrate is logged and never persisted, and holds back that emission until
+ * it is removed.
+ */
+export declare function persistSignals({ entries$, onHydrated, adapter, }: {
+    entries$: Observable<Entry[]>;
     /**
-     * Triggered after first successful hydrate
+     * Called when `{ type: "hydrated" }` is emitted.
      */
     onHydrated?: () => void;
-    /**
-     * Requires a stable instance otherwise the hydration
-     * process will start again. This is useful when you
-     * need to change adapter during runtime.
-     */
     adapter: Adapter;
-}): import('rxjs').Observable<{
+}): Observable<{
     type: "hydrated";
-} | {
-    type: "persisted";
 }>;
+export {};

package/dist/lib/state/react/usePersistSignals.d.ts

@@ -1,27 +1,29 @@
 import { Adapter } from '../persistence/adapters/Adapter';
 import { SignalPersistenceConfig } from '../persistence/types';
 /**
- * Make sure to pass stable reference of entries and adapter if you don't
- * intentionally want to start over the process.
+ * Hydrates the signals of `entries` from `adapter`, then persists their
+ * updates to it.
  *
- * `isHydrated` will be `true` after the first successful hydration. This value
- * will be reset as soon as the adapter reference changes.
+ * `isHydrated` becomes `true` once the entries have been hydrated for the
+ * first time. Entries added later do not change it. It is reset when the
+ * adapter changes.
  */
 export declare function usePersistSignals({ entries, onHydrated, adapter, }: {
     /**
-     * Passing a new list of entries will start over the process
-     * once the current one is finished. Use a stable reference to avoid
-     * infinite loop.
+     * Entries are matched by signal, so the array does not need a stable
+     * reference. A signal is hydrated when it is added, then persisted while it
+     * stays in the list. When it is removed, its pending value is saved and it
+     * stops being persisted.
      */
     entries?: Array<SignalPersistenceConfig<any>>;
     /**
-     * Triggered after first successful hydrate
+     * Called once per adapter, when `isHydrated` becomes `true`.
      */
     onHydrated?: () => void;
     /**
-     * Passing a new adapter reference will start over the process
-     * once the current one is finished. Use a stable reference to avoid
-     * infinite loop.
+     * Passing a new adapter reference starts over: pending values are saved to
+     * the previous adapter, then every entry is hydrated from the new one. Use a
+     * stable reference to avoid infinite loop.
      */
     adapter?: Adapter;
 }): {

package/dist/lib/state/react/usePersistSignals.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/utils/operators/retryBackoff.d.ts

@@ -17,9 +17,8 @@ export declare function exponentialBackoffDelay(iteration: number, initialInterv
 /**
  * Returns an Observable that mirrors the source Observable with the exception
  * of an error. If the source Observable calls error, rather than propagating
- * the error call this method will resubscribe to the source Observable with
- * exponentially increasing interval and up to a maximum of count
- * re-subscriptions (if provided). Retrying can be cancelled at any point if
- * shouldRetry returns false.
+ * the error this operator resubscribes to the source Observable after a
+ * backoff delay (exponentially increasing by default). Retrying stops as soon
+ * as `retry` returns false.
  */
 export declare function retryBackoff<T, TError>(config: RetryBackoffConfig<T, TError>): <T_1>(source: Observable<T_1>) => Observable<T | T_1>;

package/dist/tests/liveQuery.d.ts

@@ -1,11 +1,20 @@
 import { QueryClient } from '@tanstack/react-query';
 import { default as React } from 'react';
+import { BehaviorSubject } from 'rxjs';
 export declare function createQueryClient(): QueryClient;
 export declare const liveQueryOptions: {
     networkMode: "always";
     gcTime: number;
     staleTime: number;
 };
+/**
+ * Emulates a live database query: `queryFn` emits a fresh copy of the current
+ * items whenever `liveQuery$` pushes a new list.
+ */
+export declare function createLiveQuerySource(initialItems: string[]): {
+    liveQuery$: BehaviorSubject<string[]>;
+    queryFn: () => import('rxjs').Observable<string[]>;
+};
 export declare function createWrapper(queryClient: QueryClient): ({ children }: {
     children: React.ReactNode;
 }) => import("react/jsx-runtime").JSX.Element;

package/dist/tests/teardown.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

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