@peerbit/react 0.0.26 → 0.0.27

package/lib/esm/useQuery.d.ts

@@ -1,22 +1,21 @@
 import { Documents, DocumentsChange, WithContext } from "@peerbit/document";
 import * as indexerTypes from "@peerbit/indexer-interface";
-import { WithIndexedContext } from "@peerbit/document/dist/src/search";
-type QueryLike = {
-    query?: indexerTypes.Query[] | indexerTypes.QueryLike;
-    sort?: indexerTypes.Sort[] | indexerTypes.Sort | indexerTypes.SortLike;
-};
+import { WithIndexedContext } from "@peerbit/document";
 type QueryOptions = {
     query: QueryLike;
     id?: string;
 };
-type RemoteQueryOptions = {
-    warmup?: number;
-    joining?: {
-        waitFor?: number;
-    };
-    eager?: boolean;
+export type QueryLike = {
+    /** Mongo-style selector or array of selectors */
+    query?: indexerTypes.QueryLike | indexerTypes.Query[];
+    /** Sort definition compatible with `@peerbit/indexer-interface` */
+    sort?: indexerTypes.SortLike | indexerTypes.Sort | indexerTypes.Sort[];
 };
-export declare const useQuery: <T extends Record<string, any>, I extends Record<string, any>, R extends boolean | undefined = true, RT = R extends false ? WithContext<I> : WithIndexedContext<T, I>>(db?: Documents<T, I>, options?: {
+/**
+ * All the non-DB-specific options supported by the original single-DB hook.
+ * They stay fully backward-compatible.
+ */
+export type UseQuerySharedOptions<T, I, R extends boolean | undefined, RT> = {
     resolve?: R;
     transform?: (r: RT) => Promise<RT>;
     debounce?: number;
@@ -26,15 +25,34 @@ export declare const useQuery: <T extends Record<string, any>, I extends Record<
     reverse?: boolean;
     batchSize?: number;
     prefetch?: boolean;
+    ignoreUpdates?: boolean;
     onChange?: {
         merge?: boolean | ((c: DocumentsChange<T, I>) => DocumentsChange<T, I> | Promise<DocumentsChange<T, I>> | undefined);
         update?: (prev: RT[], change: DocumentsChange<T, I>) => RT[] | Promise<RT[]>;
     };
     local?: boolean;
-    remote?: boolean | RemoteQueryOptions;
-} & QueryOptions) => {
+    remote?: boolean | {
+        warmup?: number;
+        joining?: {
+            waitFor?: number;
+        };
+        eager?: boolean;
+    };
+} & QueryOptions;
+/**
+ * `useQuery` – unified hook that accepts **either**
+ *   1. a single `Documents` instance
+ *   2. an array of `Documents` instances
+ *   3. *or* omits the first argument and provides `dbs` inside the `options` object.
+ *
+ * It supersedes the original single-DB version as well as the experimental
+ * `useMultiQuery` so callers never have to choose between two APIs.
+ */
+export declare const useQuery: <T extends Record<string, any>, I extends Record<string, any>, R extends boolean | undefined = true, RT = R extends false ? WithContext<I> : WithIndexedContext<T, I>>(
+/** Single DB or list of DBs. 100 % backward-compatible with the old single param. */
+dbOrDbs: Documents<T, I> | Documents<T, I>[] | undefined, options: UseQuerySharedOptions<T, I, R, RT>) => {
     items: RT[];
-    loadMore: (n?: number, pollEvenIfWasEmpty?: boolean) => Promise<boolean | undefined>;
+    loadMore: (n?: number) => Promise<boolean>;
     isLoading: boolean;
     empty: () => boolean;
     id: string | undefined;

package/lib/esm/useQuery.js

@@ -1,27 +1,46 @@
-import { useState, useEffect, useRef } from "react";
+import { useState, useEffect, useRef, useMemo } from "react";
 import { ClosedError, } from "@peerbit/document";
 import { AbortError } from "@peerbit/time";
 import { NoPeersError } from "@peerbit/shared-log";
 import { v4 as uuid } from "uuid";
-/* ────────────── main hook ────────────── */
-export const useQuery = (db, options) => {
+/* ────────────────────────── Main Hook ────────────────────────── */
+/**
+ * `useQuery` – unified hook that accepts **either**
+ *   1. a single `Documents` instance
+ *   2. an array of `Documents` instances
+ *   3. *or* omits the first argument and provides `dbs` inside the `options` object.
+ *
+ * It supersedes the original single-DB version as well as the experimental
+ * `useMultiQuery` so callers never have to choose between two APIs.
+ */
+export const useQuery = (
+/** Single DB or list of DBs. 100 % backward-compatible with the old single param. */
+dbOrDbs, options) => {
+    /* ────────────── normalise DBs input ────────────── */
+    const dbs = useMemo(() => {
+        if (Array.isArray(dbOrDbs))
+            return dbOrDbs;
+        if (dbOrDbs)
+            return [dbOrDbs];
+        return [];
+    }, [dbOrDbs]);
     /* ────────────── state & refs ────────────── */
     const [all, setAll] = useState([]);
     const allRef = useRef([]);
     const [isLoading, setIsLoading] = useState(false);
-    const loadingMoreRef = useRef(false);
-    const iteratorRef = useRef(null);
+    const iteratorRefs = useRef([]);
     const emptyResultsRef = useRef(false);
     const closeControllerRef = useRef(null);
     const waitedOnceRef = useRef(false);
-    const [id, setId] = useState(undefined);
-    const reverseRef = useRef(options?.reverse);
+    /* keep an id mostly for debugging – mirrors original behaviour */
+    const [id, setId] = useState(options.id);
+    const reverseRef = useRef(options.reverse);
     useEffect(() => {
-        reverseRef.current = options?.reverse;
-    }, [options?.reverse]);
-    /* ────────────── util ────────────── */
+        reverseRef.current = options.reverse;
+    }, [options.reverse]);
+    /* ────────────── utilities ────────────── */
     const log = (...a) => {
-        if (!options?.debug)
+        if (!options.debug)
             return;
         if (typeof options.debug === "boolean")
             console.log(...a);
@@ -32,230 +51,159 @@ export const useQuery = (db, options) => {
         allRef.current = combined;
         setAll(combined);
     };
-    const reset = (fromRef) => {
-        const toClose = iteratorRef.current;
-        if (toClose && fromRef && toClose !== fromRef) {
-            return;
-        }
-        iteratorRef.current = null;
+    const reset = () => {
+        iteratorRefs.current.forEach(({ iterator }) => iterator.close());
+        iteratorRefs.current = [];
         closeControllerRef.current?.abort();
         closeControllerRef.current = new AbortController();
         emptyResultsRef.current = false;
-        toClose?.iterator.close();
+        waitedOnceRef.current = false;
         allRef.current = [];
         setAll([]);
         setIsLoading(false);
-        loadingMoreRef.current = false;
-        log("Iterator reset", toClose?.id, fromRef?.id);
-        setId(undefined);
+        log("Iterators reset");
     };
+    /* ────────── rebuild iterators when db list / query etc. change ────────── */
     useEffect(() => {
-        waitedOnceRef.current = false;
-    }, [db, options?.id ?? options?.query, options?.resolve, options?.reverse]);
-    /* ────────────── effect: (re)create iterator ────────────── */
-    useEffect(() => {
-        if (!db || db.closed || options?.query == null) {
-            reset(null);
+        /* derive canonical list of open DBs */
+        const openDbs = dbs.filter((d) => Boolean(d && !d.closed));
+        const { query, resolve } = options;
+        if (!openDbs.length || query == null) {
+            reset();
             return;
         }
-        const initIterator = () => {
-            let id = options?.id ?? uuid();
-            let remoteQueryOptions = options.remote == null || options.remote === false
-                ? false
-                : {
-                    ...(typeof options.remote === "object"
-                        ? options.remote
-                        : {}),
-                    joining: typeof options.remote === "object" &&
-                        options.remote.joining?.waitFor !== undefined
-                        ? {
-                            waitFor: options.remote.joining?.waitFor ??
-                                5e3,
-                            onMissedResults: ({ amount }) => {
-                                loadMore(amount, true);
-                            },
-                        }
-                        : undefined,
-                };
-            const ref = {
-                id,
-                iterator: db.index.iterate(options.query ?? {}, {
-                    local: options?.local ?? true,
-                    remote: remoteQueryOptions,
-                    resolve: options?.resolve,
-                    signal: closeControllerRef.current?.signal,
-                }),
-                itemsConsumed: 0,
-            };
-            iteratorRef.current = ref;
-            if (options?.prefetch) {
-                loadMore();
-            }
-            setId(id);
-            log("Iterator initialised", ref.id);
+        reset();
+        const abortSignal = closeControllerRef.current?.signal;
+        iteratorRefs.current = openDbs.map((db) => {
+            const iterator = db.index.iterate(query ?? {}, {
+                local: options.local ?? true,
+                remote: options.remote ?? undefined,
+                resolve,
+                signal: abortSignal,
+            });
+            const ref = { id: uuid(), db, iterator, itemsConsumed: 0 };
+            log("Iterator init", ref.id, "db", db.address);
             return ref;
-        };
-        reset(iteratorRef.current);
-        const newIteratorRef = initIterator();
-        /* live-merge listener (optional) */
-        let handleChange;
-        if (options?.onChange && options.onChange.merge !== false) {
-            const mergeFn = typeof options.onChange.merge === "function"
-                ? options.onChange.merge
-                : (c) => c;
-            handleChange = async (e) => {
-                log("Merge change", e.detail, "iterator", newIteratorRef.id);
-                const filtered = await mergeFn(e.detail);
-                if (!filtered ||
-                    (filtered.added.length === 0 &&
-                        filtered.removed.length === 0))
-                    return;
-                let merged;
-                if (options.onChange?.update) {
-                    merged = [
-                        ...(await options.onChange?.update(allRef.current, filtered)),
-                    ];
-                }
-                else {
-                    merged = await db.index.updateResults(allRef.current, filtered, options.query || {}, options.resolve ?? true);
-                    log("After update", {
-                        current: allRef.current,
-                        merged,
-                        filtered,
-                        query: options.query,
-                    });
-                    const expectedDiff = filtered.added.length - filtered.removed.length;
-                    if (merged === allRef.current ||
-                        (expectedDiff !== 0 &&
-                            merged.length === allRef.current.length)) {
-                        // no change
-                        log("no change after merge");
-                        return;
-                    }
-                }
-                updateAll(options?.reverse ? merged.reverse() : merged);
-            };
-            db.events.addEventListener("change", handleChange);
-        }
-        return () => {
-            handleChange &&
-                db.events.removeEventListener("change", handleChange);
-            reset(newIteratorRef);
-        };
-    }, [
-        db?.closed ? undefined : db?.address,
-        options?.id ?? options?.query,
-        options?.resolve,
-        options?.reverse,
-    ]);
-    /* ────────────── loadMore (once-wait aware) ────────────── */
-    const batchSize = options?.batchSize ?? 10;
+        });
+        /* prefetch if requested */
+        if (options.prefetch)
+            void loadMore();
+        /* store a deterministic id (useful for external keys) */
+        setId(uuid());
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [dbs.map((d) => d?.address).join("|"), options.query, options.resolve, options.reverse]);
+    /* ────────────── loadMore implementation ────────────── */
+    const batchSize = options.batchSize ?? 10;
     const shouldWait = () => {
-        if (waitedOnceRef.current) {
+        if (waitedOnceRef.current)
             return false;
-        }
-        if (options?.remote === false)
+        if (options.remote === false)
             return false;
-        if (options?.remote === true)
-            return true;
-        if (options?.remote == null)
-            return true;
-        if (typeof options?.remote === "object") {
-            return true;
-        }
-        return true;
+        return true; // mimic original behaviour – wait once if remote allowed
     };
     const markWaited = () => {
         waitedOnceRef.current = true;
     };
-    const loadMore = async (n = batchSize, pollEvenIfWasEmpty = false) => {
-        const iterator = iteratorRef.current;
-        if (!iterator ||
-            (emptyResultsRef.current && !pollEvenIfWasEmpty) ||
-            iterator.iterator.done() ||
-            loadingMoreRef.current) {
+    const loadMore = async (n = batchSize) => {
+        const iterators = iteratorRefs.current;
+        if (!iterators.length || emptyResultsRef.current)
             return false;
-        }
         setIsLoading(true);
-        loadingMoreRef.current = true;
         try {
-            /* ── optional replicate-wait ── */
+            /* one-time replicator warm-up across all DBs */
             if (shouldWait()) {
-                log("Wait for replicators", iterator.id);
-                let t0 = Date.now();
-                const warmup = typeof options?.remote === "object" &&
-                    typeof options?.remote.warmup === "number"
-                    ? options?.remote.warmup
-                    : undefined;
-                if (warmup) {
-                    await db?.log
-                        .waitForReplicators({
-                        timeout: warmup,
-                        signal: closeControllerRef.current?.signal,
-                    })
-                        .catch((e) => {
-                        if (e instanceof AbortError ||
-                            e instanceof NoPeersError)
-                            return;
-                        console.warn("Remote replicators not ready", e);
-                    })
-                        .finally(() => {
-                        log("Wait for replicators done", iterator.id, "time", Date.now() - t0);
-                        markWaited();
-                    });
+                if (typeof options.remote === "object" && options.remote.warmup) {
+                    await Promise.all(iterators.map(async ({ db }) => {
+                        try {
+                            await db.log.waitForReplicators({
+                                timeout: options.remote.warmup,
+                                signal: closeControllerRef.current?.signal,
+                            });
+                        }
+                        catch (e) {
+                            if (e instanceof AbortError || e instanceof NoPeersError)
+                                return;
+                            console.warn("Remote replicators not ready", e);
+                        }
+                    }));
                 }
+                markWaited();
             }
-            else {
-                log("Skip wait for replicators", iterator.id);
-            }
-            /* ── fetch next batch ── */
-            log("Retrieve next batch", iterator.id);
-            let newItems = await iterator.iterator.next(n);
-            if (options?.transform) {
-                log("Transform start", iterator.id);
-                newItems = await Promise.all(newItems.map(options.transform));
-                log("Transform end", iterator.id);
-            }
-            /* iterator might have been reset while we were async… */
-            if (iteratorRef.current !== iterator) {
-                log("Iterator reset while loading more");
-                return false;
+            /* pull items round-robin */
+            const newlyFetched = [];
+            for (const ref of iterators) {
+                if (ref.iterator.done())
+                    continue;
+                const batch = await ref.iterator.next(n); // pull up to <n> at once
+                if (batch.length) {
+                    ref.itemsConsumed += batch.length;
+                    newlyFetched.push(...batch);
+                }
             }
-            iterator.itemsConsumed += newItems.length;
-            emptyResultsRef.current = newItems.length === 0;
-            if (newItems.length) {
-                log("Loaded more items for iterator", iterator.id, "current id", iteratorRef.current?.id, "new items", newItems.length, "previous results", allRef.current.length, "batchSize", batchSize, "items consumed", iterator.itemsConsumed);
-                const prev = allRef.current;
-                const dedup = new Set(prev.map((x) => x.__context.head));
-                const unique = newItems.filter((x) => !dedup.has(x.__context.head));
-                if (!unique.length)
-                    return;
-                const combined = reverseRef.current
-                    ? [...unique.reverse(), ...prev]
-                    : [...prev, ...unique];
-                updateAll(combined);
+            if (!newlyFetched.length) {
+                emptyResultsRef.current = iterators.every((i) => i.iterator.done());
+                return !emptyResultsRef.current;
             }
-            else {
-                log("No new items", iterator.id);
+            /* optional transform */
+            let processed = newlyFetched;
+            if (options.transform) {
+                processed = await Promise.all(processed.map(options.transform));
             }
-            return !iterator.iterator.done();
+            /* deduplicate & merge */
+            const prev = allRef.current;
+            const dedupHeads = new Set(prev.map((x) => x.__context.head));
+            const unique = processed.filter((x) => !dedupHeads.has(x.__context.head));
+            if (!unique.length)
+                return !iterators.every((i) => i.iterator.done());
+            const combined = reverseRef.current ? [...unique.reverse(), ...prev] : [...prev, ...unique];
+            updateAll(combined);
+            emptyResultsRef.current = iterators.every((i) => i.iterator.done());
+            return !emptyResultsRef.current;
         }
         catch (e) {
             if (!(e instanceof ClosedError))
                 throw e;
+            return false;
         }
         finally {
             setIsLoading(false);
-            loadingMoreRef.current = false;
         }
     };
-    /* ────────────── public API ────────────── */
+    /* ────────────── live-merge listeners ────────────── */
+    useEffect(() => {
+        if (!options.onChange || options.onChange.merge === false)
+            return;
+        const listeners = iteratorRefs.current.map(({ db, id: itId }) => {
+            const mergeFn = typeof options.onChange?.merge === "function" ? options.onChange.merge : (c) => c;
+            const handler = async (e) => {
+                log("Merge change", e.detail, "it", itId);
+                const filtered = await mergeFn(e.detail);
+                if (!filtered || (!filtered.added.length && !filtered.removed.length))
+                    return;
+                let merged;
+                if (options.onChange?.update) {
+                    merged = await options.onChange.update(allRef.current, filtered);
+                }
+                else {
+                    merged = await db.index.updateResults(allRef.current, filtered, options.query || {}, options.resolve ?? true);
+                }
+                updateAll(options.reverse ? merged.reverse() : merged);
+            };
+            db.events.addEventListener("change", handler);
+            return { db, handler };
+        });
+        return () => {
+            listeners.forEach(({ db, handler }) => db.events.removeEventListener("change", handler));
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [iteratorRefs.current.map((r) => r.db.address).join("|"), options.onChange]);
+    /* ────────────── public API – unchanged from the caller's perspective ────────────── */
     return {
         items: all,
         loadMore,
         isLoading,
         empty: () => emptyResultsRef.current,
-        id: id,
+        id,
     };
 };
 //# sourceMappingURL=useQuery.js.map

package/lib/esm/useQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"useQuery.js","sourceRoot":"","sources":["../../src/useQuery.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAc,MAAM,OAAO,CAAC;AAChE,OAAO,EACH,WAAW,GAKd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAgBlC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAMpB,EAAoB,EACpB,OAwBgB,EAClB,EAAE;IAIA,gDAAgD;IAChD,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAS,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAS,EAAE,CAAC,CAAC;IAClC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,MAAM,CAAU,KAAK,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,MAAM,CAIhB,IAAI,CAAC,CAAC;IAChB,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,kBAAkB,GAAG,MAAM,CAAyB,IAAI,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAqB,SAAS,CAAC,CAAC;IAE5D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,SAAS,CAAC,GAAG,EAAE;QACX,UAAU,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IAC1C,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEvB,wCAAwC;IACxC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAQ,EAAE,EAAE;QACxB,IAAI,CAAC,OAAO,EAAE,KAAK;YAAE,OAAO;QAC5B,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;;YACrD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,EAAE;QACnC,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC1B,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CACV,OAGQ,EACV,EAAE;QACA,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;QACpC,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YAC5C,OAAO;QACX,CAAC;QAED,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;QAE3B,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACpC,kBAAkB,CAAC,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;QACnD,eAAe,CAAC,OAAO,GAAG,KAAK,CAAC;QAEhC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;QAE1B,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,CAAC,CAAC;QAEX,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,cAAc,CAAC,OAAO,GAAG,KAAK,CAAC;QAC/B,GAAG,CAAC,gBAAgB,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAChD,KAAK,CAAC,SAAS,CAAC,CAAC;IACrB,CAAC,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACX,aAAa,CAAC,OAAO,GAAG,KAAK,CAAC;IAClC,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5E,+DAA+D;IAC/D,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,IAAI,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,CAAC;YACZ,OAAO;QACX,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,EAAE;YACtB,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;YAC/B,IAAI,kBAAkB,GAClB,OAAO,CAAC,MAAM,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK;gBAC9C,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC;oBACI,GAAG,CAAC,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;wBAClC,CAAC,CAAC,OAAO,CAAC,MAAM;wBAChB,CAAC,CAAC,EAAE,CAAC;oBACT,OAAO,EACH,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;wBAClC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS;wBACzC,CAAC,CAAC;4BACI,OAAO,EACH,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO;gCAC/B,GAAG;4BACP,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;gCAC5B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;4BAC3B,CAAC;yBACJ;wBACH,CAAC,CAAC,SAAS;iBACtB,CAAC;YACZ,MAAM,GAAG,GAAG;gBACR,EAAE;gBACF,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE;oBAC5C,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;oBAC7B,MAAM,EAAE,kBAAkB;oBAC1B,OAAO,EAAE,OAAO,EAAE,OAAO;oBACzB,MAAM,EAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM;iBAC7C,CAA0B;gBAC3B,aAAa,EAAE,CAAC;aACnB,CAAC;YACF,WAAW,CAAC,OAAO,GAAG,GAAG,CAAC;YAC1B,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACpB,QAAQ,EAAE,CAAC;YACf,CAAC;YACD,KAAK,CAAC,EAAE,CAAC,CAAC;YAEV,GAAG,CAAC,sBAAsB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACpC,OAAO,GAAG,CAAC;QACf,CAAC,CAAC;QAEF,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3B,MAAM,cAAc,GAAG,YAAY,EAAE,CAAC;QAEtC,oCAAoC;QACpC,IAAI,YAEW,CAAC;QAEhB,IAAI,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACxD,MAAM,OAAO,GACT,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,KAAK,UAAU;gBACxC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK;gBACxB,CAAC,CAAC,CAAC,CAAwB,EAAE,EAAE,CAAC,CAAC,CAAC;YAE1C,YAAY,GAAG,KAAK,EAAE,CAAqC,EAAE,EAAE;gBAC3D,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;gBAC7D,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBACzC,IACI,CAAC,QAAQ;oBACT,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;wBACxB,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;oBAElC,OAAO;gBAEX,IAAI,MAAc,CAAC;gBACnB,IAAI,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;oBAC3B,MAAM,GAAG;wBACL,GAAG,CAAC,MAAM,OAAO,CAAC,QAAQ,EAAE,MAAM,CAC9B,MAAM,CAAC,OAAO,EACd,QAAQ,CACX,CAAC;qBACL,CAAC;gBACN,CAAC;qBAAM,CAAC;oBACJ,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,CACjC,MAAM,CAAC,OAA4B,EACnC,QAAQ,EACR,OAAO,CAAC,KAAK,IAAI,EAAE,EACnB,OAAO,CAAC,OAAO,IAAI,IAAI,CAC1B,CAAC;oBAEF,GAAG,CAAC,cAAc,EAAE;wBAChB,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,MAAM;wBACN,QAAQ;wBACR,KAAK,EAAE,OAAO,CAAC,KAAK;qBACvB,CAAC,CAAC;oBACH,MAAM,YAAY,GACd,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;oBAEpD,IACI,MAAM,KAAK,MAAM,CAAC,OAAO;wBACzB,CAAC,YAAY,KAAK,CAAC;4BACf,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAC9C,CAAC;wBACC,YAAY;wBACZ,GAAG,CAAC,uBAAuB,CAAC,CAAC;wBAC7B,OAAO;oBACX,CAAC;gBACL,CAAC;gBAED,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC5D,CAAC,CAAC;YAEF,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,GAAG,EAAE;YACR,YAAY;gBACR,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAC1D,KAAK,CAAC,cAAc,CAAC,CAAC;QAC1B,CAAC,CAAC;IACN,CAAC,EAAE;QACC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO;QACpC,OAAO,EAAE,EAAE,IAAI,OAAO,EAAE,KAAK;QAC7B,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,8DAA8D;IAC9D,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;IAE3C,MAAM,UAAU,GAAG,GAAY,EAAE;QAC7B,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,OAAO,EAAE,MAAM,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,OAAO,EAAE,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC1C,IAAI,OAAO,EAAE,MAAM,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QACzC,IAAI,OAAO,OAAO,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,GAAG,EAAE;QACpB,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;IACjC,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,EAClB,IAAY,SAAS,EACrB,kBAAkB,GAAG,KAAK,EAC5B,EAAE;QACA,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC;QACrC,IACI,CAAC,QAAQ;YACT,CAAC,eAAe,CAAC,OAAO,IAAI,CAAC,kBAAkB,CAAC;YAChD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;YACxB,cAAc,CAAC,OAAO,EACxB,CAAC;YACC,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC;QAE9B,IAAI,CAAC;YACD,mCAAmC;YACnC,IAAI,UAAU,EAAE,EAAE,CAAC;gBACf,GAAG,CAAC,sBAAsB,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACzC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAEpB,MAAM,MAAM,GACR,OAAO,OAAO,EAAE,MAAM,KAAK,QAAQ;oBACnC,OAAO,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,QAAQ;oBACtC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM;oBACxB,CAAC,CAAC,SAAS,CAAC;gBAEpB,IAAI,MAAM,EAAE,CAAC;oBACT,MAAM,EAAE,EAAE,GAAG;yBACR,kBAAkB,CAAC;wBAChB,OAAO,EAAE,MAAM;wBACf,MAAM,EAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM;qBAC7C,CAAC;yBACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;wBACT,IACI,CAAC,YAAY,UAAU;4BACvB,CAAC,YAAY,YAAY;4BAEzB,OAAO;wBACX,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,CAAC,CAAC,CAAC;oBACpD,CAAC,CAAC;yBACD,OAAO,CAAC,GAAG,EAAE;wBACV,GAAG,CACC,2BAA2B,EAC3B,QAAQ,CAAC,EAAE,EACX,MAAM,EACN,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAClB,CAAC;wBACF,UAAU,EAAE,CAAC;oBACjB,CAAC,CAAC,CAAC;gBACX,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,GAAG,CAAC,2BAA2B,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClD,CAAC;YAED,4BAA4B;YAC5B,GAAG,CAAC,qBAAqB,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAExC,IAAI,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAE/C,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;gBACrB,GAAG,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAEpC,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC9D,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YACtC,CAAC;YAED,yDAAyD;YAEzD,IAAI,WAAW,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACnC,GAAG,CAAC,mCAAmC,CAAC,CAAC;gBACzC,OAAO,KAAK,CAAC;YACjB,CAAC;YAED,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC;YAE1C,eAAe,CAAC,OAAO,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;YAEhD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAClB,GAAG,CACC,gCAAgC,EAChC,QAAQ,CAAC,EAAE,EACX,YAAY,EACZ,WAAW,CAAC,OAAO,EAAE,EAAE,EACvB,WAAW,EACX,QAAQ,CAAC,MAAM,EACf,kBAAkB,EAClB,MAAM,CAAC,OAAO,CAAC,MAAM,EACrB,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,QAAQ,CAAC,aAAa,CACzB,CAAC;gBACF,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;gBAC5B,MAAM,KAAK,GAAG,IAAI,GAAG,CACjB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAC7C,CAAC;gBACF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAE,CAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAC/C,CAAC;gBACF,IAAI,CAAC,MAAM,CAAC,MAAM;oBAAE,OAAO;gBAE3B,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO;oBAC/B,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC;oBAChC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC;gBAC3B,SAAS,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACJ,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,IAAI,CAAC,CAAC,CAAC,YAAY,WAAW,CAAC;gBAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;gBAAS,CAAC;YACP,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,cAAc,CAAC,OAAO,GAAG,KAAK,CAAC;QACnC,CAAC;IACL,CAAC,CAAC;IAEF,8CAA8C;IAC9C,OAAO;QACH,KAAK,EAAE,GAAG;QACV,QAAQ;QACR,SAAS;QACT,KAAK,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO;QACpC,EAAE,EAAE,EAAE;KACT,CAAC;AACN,CAAC,CAAC"}
+{"version":3,"file":"useQuery.js","sourceRoot":"","sources":["../../src/useQuery.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@peerbit/react",
-    "version": "0.0.26",
+    "version": "0.0.27",
     "homepage": "https://dao-xyz.github.io/peerbit-examples",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -70,5 +70,5 @@
             "last 1 safari version"
         ]
     },
-    "gitHead": "d2ac39e97a21f0607ca0e77fe20affa0dbaaaa67"
+    "gitHead": "727b1345b244358196a3782f7b1a61b26d8db498"
 }

package/src/useQuery.tsx

@@ -1,4 +1,4 @@
-import { useState, useEffect, useRef, useReducer } from "react";
+import { useState, useEffect, useRef, useMemo } from "react";
 import {
     ClosedError,
     Documents,
@@ -10,82 +10,113 @@ import * as indexerTypes from "@peerbit/indexer-interface";
 import { AbortError } from "@peerbit/time";
 import { NoPeersError } from "@peerbit/shared-log";
 import { v4 as uuid } from "uuid";
-import { WithIndexedContext } from "@peerbit/document/dist/src/search";
-import { on } from "events";
-/* ────────────── helper types ────────────── */
-type QueryLike = {
-    query?: indexerTypes.Query[] | indexerTypes.QueryLike;
-    sort?: indexerTypes.Sort[] | indexerTypes.Sort | indexerTypes.SortLike;
-};
+import { WithIndexedContext } from "@peerbit/document";
+
 type QueryOptions = { query: QueryLike; id?: string };
 
-type RemoteQueryOptions = {
-    warmup?: number;
-    joining?: { waitFor?: number };
-    eager?: boolean;
+/* ────────────── helper types ────────────── */
+export type QueryLike = {
+    /** Mongo-style selector or array of selectors */
+    query?: indexerTypes.QueryLike | indexerTypes.Query[];
+    /** Sort definition compatible with `@peerbit/indexer-interface` */
+    sort?: indexerTypes.SortLike | indexerTypes.Sort | indexerTypes.Sort[];
 };
 
-/* ────────────── main hook ────────────── */
+/**
+ * All the non-DB-specific options supported by the original single-DB hook.
+ * They stay fully backward-compatible.
+ */
+export type UseQuerySharedOptions<T, I, R extends boolean | undefined, RT> = {
+    /* original behavioural flags */
+    resolve?: R;
+    transform?: (r: RT) => Promise<RT>;
+    debounce?: number;
+    debug?: boolean | { id: string };
+    reverse?: boolean;
+    batchSize?: number;
+    prefetch?: boolean;
+    ignoreUpdates?: boolean;
+    onChange?: {
+        merge?:
+            | boolean
+            | ((
+                  c: DocumentsChange<T, I>
+              ) =>
+                  | DocumentsChange<T, I>
+                  | Promise<DocumentsChange<T, I>>
+                  | undefined);
+        update?: (
+            prev: RT[],
+            change: DocumentsChange<T, I>
+        ) => RT[] | Promise<RT[]>;
+    };
+    local?: boolean;
+    remote?:
+        | boolean
+        | {
+              warmup?: number;
+              joining?: { waitFor?: number };
+              eager?: boolean;
+          };
+} & QueryOptions;
+
+/* ────────────────────────── Main Hook ────────────────────────── */
+/**
+ * `useQuery` – unified hook that accepts **either**
+ *   1. a single `Documents` instance
+ *   2. an array of `Documents` instances
+ *   3. *or* omits the first argument and provides `dbs` inside the `options` object.
+ *
+ * It supersedes the original single-DB version as well as the experimental
+ * `useMultiQuery` so callers never have to choose between two APIs.
+ */
 export const useQuery = <
     T extends Record<string, any>,
     I extends Record<string, any>,
     R extends boolean | undefined = true,
     RT = R extends false ? WithContext<I> : WithIndexedContext<T, I>
 >(
-    db?: Documents<T, I>,
-    options?: {
-        resolve?: R;
-        transform?: (r: RT) => Promise<RT>;
-        debounce?: number;
-        debug?: boolean | { id: string };
-        reverse?: boolean;
-        batchSize?: number;
-        prefetch?: boolean;
-        onChange?: {
-            merge?:
-                | boolean
-                | ((
-                      c: DocumentsChange<T, I>
-                  ) =>
-                      | DocumentsChange<T, I>
-                      | Promise<DocumentsChange<T, I>>
-                      | undefined);
-            update?: (
-                prev: RT[],
-                change: DocumentsChange<T, I>
-            ) => RT[] | Promise<RT[]>;
-        };
-        local?: boolean;
-        remote?: boolean | RemoteQueryOptions;
-    } & QueryOptions
+    /** Single DB or list of DBs. 100 % backward-compatible with the old single param. */
+    dbOrDbs: Documents<T, I> | Documents<T, I>[] | undefined,
+    options: UseQuerySharedOptions<T, I, R, RT>
 ) => {
-    /* ── «Item» is the concrete element type flowing through the hook ── */
+    /* ─────── internal type alias for convenience ─────── */
     type Item = RT;
 
+    /* ────────────── normalise DBs input ────────────── */
+    const dbs = useMemo<(Documents<T, I> | undefined)[]>(() => {
+        if (Array.isArray(dbOrDbs)) return dbOrDbs;
+        if (dbOrDbs) return [dbOrDbs];
+        return [];
+    }, [dbOrDbs]);
+
     /* ────────────── state & refs ────────────── */
     const [all, setAll] = useState<Item[]>([]);
     const allRef = useRef<Item[]>([]);
     const [isLoading, setIsLoading] = useState(false);
-    const loadingMoreRef = useRef<boolean>(false);
-    const iteratorRef = useRef<{
-        id?: string;
-        iterator: ResultsIterator<Item>;
-        itemsConsumed: number;
-    } | null>(null);
+    const iteratorRefs = useRef<
+        {
+            id: string;
+            db: Documents<T, I>;
+            iterator: ResultsIterator<Item>;
+            itemsConsumed: number;
+        }[]
+    >([]);
     const emptyResultsRef = useRef(false);
     const closeControllerRef = useRef<AbortController | null>(null);
     const waitedOnceRef = useRef(false);
 
-    const [id, setId] = useState<string | undefined>(undefined);
+    /* keep an id mostly for debugging – mirrors original behaviour */
+    const [id, setId] = useState<string | undefined>(options.id);
 
-    const reverseRef = useRef(options?.reverse);
+    const reverseRef = useRef(options.reverse);
     useEffect(() => {
-        reverseRef.current = options?.reverse;
-    }, [options?.reverse]);
+        reverseRef.current = options.reverse;
+    }, [options.reverse]);
 
-    /* ────────────── util ────────────── */
+    /* ────────────── utilities ────────────── */
     const log = (...a: any[]) => {
-        if (!options?.debug) return;
+        if (!options.debug) return;
         if (typeof options.debug === "boolean") console.log(...a);
         else console.log(options.debug.id, ...a);
     };
@@ -95,311 +126,215 @@ export const useQuery = <
         setAll(combined);
     };
 
-    const reset = (
-        fromRef: {
-            id?: string;
-            iterator: ResultsIterator<Item>;
-        } | null
-    ) => {
-        const toClose = iteratorRef.current;
-        if (toClose && fromRef && toClose !== fromRef) {
-            return;
-        }
-
-        iteratorRef.current = null;
+    const reset = () => {
+        iteratorRefs.current.forEach(({ iterator }) => iterator.close());
+        iteratorRefs.current = [];
 
         closeControllerRef.current?.abort();
         closeControllerRef.current = new AbortController();
         emptyResultsRef.current = false;
-
-        toClose?.iterator.close();
+        waitedOnceRef.current = false;
 
         allRef.current = [];
         setAll([]);
-
         setIsLoading(false);
-        loadingMoreRef.current = false;
-        log("Iterator reset", toClose?.id, fromRef?.id);
-        setId(undefined);
+        log("Iterators reset");
     };
 
+    /* ────────── rebuild iterators when db list / query etc. change ────────── */
     useEffect(() => {
-        waitedOnceRef.current = false;
-    }, [db, options?.id ?? options?.query, options?.resolve, options?.reverse]);
-
-    /* ────────────── effect: (re)create iterator ────────────── */
-    useEffect(() => {
-        if (!db || db.closed || options?.query == null) {
-            reset(null);
+        /* derive canonical list of open DBs */
+        const openDbs = dbs.filter((d): d is Documents<T, I> =>
+            Boolean(d && !d.closed)
+        );
+        const { query, resolve } = options;
+
+        if (!openDbs.length || query == null) {
+            reset();
             return;
         }
 
-        const initIterator = () => {
-            let id = options?.id ?? uuid();
-            let remoteQueryOptions =
-                options.remote == null || options.remote === false
-                    ? false
-                    : {
-                          ...(typeof options.remote === "object"
-                              ? options.remote
-                              : {}),
-                          joining:
-                              typeof options.remote === "object" &&
-                              options.remote.joining?.waitFor !== undefined
-                                  ? {
-                                        waitFor:
-                                            options.remote.joining?.waitFor ??
-                                            5e3,
-                                        onMissedResults: ({ amount }) => {
-                                            loadMore(amount, true);
-                                        },
-                                    }
-                                  : undefined,
-                      };
-            const ref = {
-                id,
-                iterator: db.index.iterate(options.query ?? {}, {
-                    local: options?.local ?? true,
-                    remote: remoteQueryOptions,
-                    resolve: options?.resolve,
-                    signal: closeControllerRef.current?.signal,
-                }) as ResultsIterator<Item>,
-                itemsConsumed: 0,
-            };
-            iteratorRef.current = ref;
-            if (options?.prefetch) {
-                loadMore();
-            }
-            setId(id);
-
-            log("Iterator initialised", ref.id);
-            return ref;
-        };
-
-        reset(iteratorRef.current);
-        const newIteratorRef = initIterator();
-
-        /* live-merge listener (optional) */
-        let handleChange:
-            | ((e: CustomEvent<DocumentsChange<T, I>>) => void | Promise<void>)
-            | undefined;
-
-        if (options?.onChange && options.onChange.merge !== false) {
-            const mergeFn =
-                typeof options.onChange.merge === "function"
-                    ? options.onChange.merge
-                    : (c: DocumentsChange<T, I>) => c;
-
-            handleChange = async (e: CustomEvent<DocumentsChange<T, I>>) => {
-                log("Merge change", e.detail, "iterator", newIteratorRef.id);
-                const filtered = await mergeFn(e.detail);
-                if (
-                    !filtered ||
-                    (filtered.added.length === 0 &&
-                        filtered.removed.length === 0)
-                )
-                    return;
-
-                let merged: Item[];
-                if (options.onChange?.update) {
-                    merged = [
-                        ...(await options.onChange?.update(
-                            allRef.current,
-                            filtered
-                        )),
-                    ];
-                } else {
-                    merged = await db.index.updateResults(
-                        allRef.current as WithContext<RT>[],
-                        filtered,
-                        options.query || {},
-                        options.resolve ?? true
-                    );
+        reset();
+        const abortSignal = closeControllerRef.current?.signal;
 
-                    log("After update", {
-                        current: allRef.current,
-                        merged,
-                        filtered,
-                        query: options.query,
-                    });
-                    const expectedDiff =
-                        filtered.added.length - filtered.removed.length;
-
-                    if (
-                        merged === allRef.current ||
-                        (expectedDiff !== 0 &&
-                            merged.length === allRef.current.length)
-                    ) {
-                        // no change
-                        log("no change after merge");
-                        return;
-                    }
-                }
-
-                updateAll(options?.reverse ? merged.reverse() : merged);
-            };
+        iteratorRefs.current = openDbs.map((db) => {
+            const iterator = db.index.iterate(query ?? {}, {
+                local: options.local ?? true,
+                remote: options.remote ?? undefined,
+                resolve,
+                signal: abortSignal,
+            }) as ResultsIterator<Item>;
 
-            db.events.addEventListener("change", handleChange);
-        }
+            const ref = { id: uuid(), db, iterator, itemsConsumed: 0 };
+            log("Iterator init", ref.id, "db", db.address);
+            return ref;
+        });
 
-        return () => {
-            handleChange &&
-                db.events.removeEventListener("change", handleChange);
-            reset(newIteratorRef);
-        };
+        /* prefetch if requested */
+        if (options.prefetch) void loadMore();
+        /* store a deterministic id (useful for external keys) */
+        setId(uuid());
+        // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [
-        db?.closed ? undefined : db?.address,
-        options?.id ?? options?.query,
-        options?.resolve,
-        options?.reverse,
+        dbs.map((d) => d?.address).join("|"),
+        options.query,
+        options.resolve,
+        options.reverse,
     ]);
 
-    /* ────────────── loadMore (once-wait aware) ────────────── */
-    const batchSize = options?.batchSize ?? 10;
+    /* ────────────── loadMore implementation ────────────── */
+    const batchSize = options.batchSize ?? 10;
 
     const shouldWait = (): boolean => {
-        if (waitedOnceRef.current) {
-            return false;
-        }
-        if (options?.remote === false) return false;
-        if (options?.remote === true) return true;
-        if (options?.remote == null) return true;
-        if (typeof options?.remote === "object") {
-            return true;
-        }
-        return true;
+        if (waitedOnceRef.current) return false;
+        if (options.remote === false) return false;
+        return true; // mimic original behaviour – wait once if remote allowed
     };
 
     const markWaited = () => {
         waitedOnceRef.current = true;
     };
 
-    const loadMore = async (
-        n: number = batchSize,
-        pollEvenIfWasEmpty = false
-    ) => {
-        const iterator = iteratorRef.current;
-        if (
-            !iterator ||
-            (emptyResultsRef.current && !pollEvenIfWasEmpty) ||
-            iterator.iterator.done() ||
-            loadingMoreRef.current
-        ) {
-            return false;
-        }
+    const loadMore = async (n: number = batchSize): Promise<boolean> => {
+        const iterators = iteratorRefs.current;
+        if (!iterators.length || emptyResultsRef.current) return false;
 
         setIsLoading(true);
-        loadingMoreRef.current = true;
-
         try {
-            /* ── optional replicate-wait ── */
+            /* one-time replicator warm-up across all DBs */
             if (shouldWait()) {
-                log("Wait for replicators", iterator.id);
-                let t0 = Date.now();
-
-                const warmup =
-                    typeof options?.remote === "object" &&
-                    typeof options?.remote.warmup === "number"
-                        ? options?.remote.warmup
-                        : undefined;
-
-                if (warmup) {
-                    await db?.log
-                        .waitForReplicators({
-                            timeout: warmup,
-                            signal: closeControllerRef.current?.signal,
-                        })
-                        .catch((e) => {
-                            if (
-                                e instanceof AbortError ||
-                                e instanceof NoPeersError
-                            )
-                                return;
-                            console.warn("Remote replicators not ready", e);
+                if (
+                    typeof options.remote === "object" &&
+                    options.remote.warmup
+                ) {
+                    await Promise.all(
+                        iterators.map(async ({ db }) => {
+                            try {
+                                await db.log.waitForReplicators({
+                                    timeout: (options.remote as { warmup })
+                                        .warmup,
+                                    signal: closeControllerRef.current?.signal,
+                                });
+                            } catch (e) {
+                                if (
+                                    e instanceof AbortError ||
+                                    e instanceof NoPeersError
+                                )
+                                    return;
+                                console.warn("Remote replicators not ready", e);
+                            }
                         })
-                        .finally(() => {
-                            log(
-                                "Wait for replicators done",
-                                iterator.id,
-                                "time",
-                                Date.now() - t0
-                            );
-                            markWaited();
-                        });
+                    );
                 }
-            } else {
-                log("Skip wait for replicators", iterator.id);
+                markWaited();
             }
 
-            /* ── fetch next batch ── */
-            log("Retrieve next batch", iterator.id);
-
-            let newItems = await iterator.iterator.next(n);
-
-            if (options?.transform) {
-                log("Transform start", iterator.id);
-
-                newItems = await Promise.all(newItems.map(options.transform));
-                log("Transform end", iterator.id);
+            /* pull items round-robin */
+            const newlyFetched: Item[] = [];
+            for (const ref of iterators) {
+                if (ref.iterator.done()) continue;
+                const batch = await ref.iterator.next(n); // pull up to <n> at once
+                if (batch.length) {
+                    ref.itemsConsumed += batch.length;
+                    newlyFetched.push(...batch);
+                }
             }
 
-            /* iterator might have been reset while we were async… */
-
-            if (iteratorRef.current !== iterator) {
-                log("Iterator reset while loading more");
-                return false;
+            if (!newlyFetched.length) {
+                emptyResultsRef.current = iterators.every((i) =>
+                    i.iterator.done()
+                );
+                return !emptyResultsRef.current;
             }
 
-            iterator.itemsConsumed += newItems.length;
-
-            emptyResultsRef.current = newItems.length === 0;
-
-            if (newItems.length) {
-                log(
-                    "Loaded more items for iterator",
-                    iterator.id,
-                    "current id",
-                    iteratorRef.current?.id,
-                    "new items",
-                    newItems.length,
-                    "previous results",
-                    allRef.current.length,
-                    "batchSize",
-                    batchSize,
-                    "items consumed",
-                    iterator.itemsConsumed
-                );
-                const prev = allRef.current;
-                const dedup = new Set(
-                    prev.map((x) => (x as any).__context.head)
-                );
-                const unique = newItems.filter(
-                    (x) => !dedup.has((x as any).__context.head)
-                );
-                if (!unique.length) return;
-
-                const combined = reverseRef.current
-                    ? [...unique.reverse(), ...prev]
-                    : [...prev, ...unique];
-                updateAll(combined);
-            } else {
-                log("No new items", iterator.id);
+            /* optional transform */
+            let processed = newlyFetched;
+            if (options.transform) {
+                processed = await Promise.all(processed.map(options.transform));
             }
-            return !iterator.iterator.done();
+
+            /* deduplicate & merge */
+            const prev = allRef.current;
+            const dedupHeads = new Set(
+                prev.map((x) => (x as any).__context.head)
+            );
+            const unique = processed.filter(
+                (x) => !dedupHeads.has((x as any).__context.head)
+            );
+            if (!unique.length)
+                return !iterators.every((i) => i.iterator.done());
+
+            const combined = reverseRef.current
+                ? [...unique.reverse(), ...prev]
+                : [...prev, ...unique];
+            updateAll(combined);
+
+            emptyResultsRef.current = iterators.every((i) => i.iterator.done());
+            return !emptyResultsRef.current;
         } catch (e) {
             if (!(e instanceof ClosedError)) throw e;
+            return false;
         } finally {
             setIsLoading(false);
-            loadingMoreRef.current = false;
         }
     };
 
-    /* ────────────── public API ────────────── */
+    /* ────────────── live-merge listeners ────────────── */
+    useEffect(() => {
+        if (!options.onChange || options.onChange.merge === false) return;
+
+        const listeners = iteratorRefs.current.map(({ db, id: itId }) => {
+            const mergeFn =
+                typeof options.onChange?.merge === "function"
+                    ? options.onChange.merge
+                    : (c: DocumentsChange<T, I>) => c;
+
+            const handler = async (e: CustomEvent<DocumentsChange<T, I>>) => {
+                log("Merge change", e.detail, "it", itId);
+                const filtered = await mergeFn(e.detail);
+                if (
+                    !filtered ||
+                    (!filtered.added.length && !filtered.removed.length)
+                )
+                    return;
+
+                let merged: Item[];
+                if (options.onChange?.update) {
+                    merged = await options.onChange.update(
+                        allRef.current,
+                        filtered
+                    );
+                } else {
+                    merged = await db.index.updateResults(
+                        allRef.current as WithContext<RT>[],
+                        filtered,
+                        options.query || {},
+                        options.resolve ?? true
+                    );
+                }
+                updateAll(options.reverse ? merged.reverse() : merged);
+            };
+            db.events.addEventListener("change", handler);
+            return { db, handler };
+        });
+
+        return () => {
+            listeners.forEach(({ db, handler }) =>
+                db.events.removeEventListener("change", handler)
+            );
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        iteratorRefs.current.map((r) => r.db.address).join("|"),
+        options.onChange,
+    ]);
+
+    /* ────────────── public API – unchanged from the caller's perspective ────────────── */
     return {
         items: all,
         loadMore,
         isLoading,
         empty: () => emptyResultsRef.current,
-        id: id,
+        id,
     };
 };