@peerbit/document-react 0.1.0

package/dist/src/useQuery.js

@@ -0,0 +1,433 @@
+import { ClosedError, Documents } from "@peerbit/document";
+import * as indexerTypes from "@peerbit/indexer-interface";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { v4 as uuid } from "uuid";
+/* ────────────────────────── 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 iteratorRefs = useRef([]);
+    const itemIdRef = useRef(new WeakMap());
+    const emptyResultsRef = useRef(false);
+    const closeControllerRef = useRef(null);
+    const waitedOnceRef = useRef(false);
+    /* 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]);
+    /* ────────────── utilities ────────────── */
+    const log = (...a) => {
+        if (!options.debug)
+            return;
+        if (typeof options.debug === "boolean")
+            console.log(...a);
+        else
+            console.log(options.debug, ...a);
+    };
+    const updateAll = (combined) => {
+        allRef.current = combined;
+        setAll(combined);
+    };
+    const reset = () => {
+        iteratorRefs.current?.forEach(({ iterator }) => iterator.close());
+        iteratorRefs.current = [];
+        closeControllerRef.current?.abort(new Error("Reset"));
+        closeControllerRef.current = new AbortController();
+        emptyResultsRef.current = false;
+        waitedOnceRef.current = false;
+        allRef.current = [];
+        itemIdRef.current = new WeakMap();
+        setAll([]);
+        setIsLoading(false);
+        log("Iterators reset");
+    };
+    /* ────────── rebuild iterators when db list / query etc. change ────────── */
+    useEffect(() => {
+        /* 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;
+        }
+        reset();
+        const abortSignal = closeControllerRef.current?.signal;
+        const onMissedResults = (evt) => {
+            console.error("Not effective yet: missed results", evt);
+            /* if (allRef.current.length > 0 || typeof options.remote !== "object" || !options.updates) {
+                return;
+            }
+            console.log("Missed results, loading more", evt.amount);
+            loadMore(evt.amount); */
+        };
+        let draining = false;
+        const scheduleDrain = (ref, amount, opts) => {
+            log("Schedule drain", draining, ref, amount);
+            if (draining)
+                return;
+            draining = true;
+            loadMore(amount, opts)
+                .catch((e) => {
+                if (!(e instanceof ClosedError))
+                    throw e;
+            })
+                .finally(() => {
+                draining = false;
+            });
+        };
+        iteratorRefs.current = openDbs.map((db) => {
+            let currentRef;
+            const iterator = db.index.iterate(query ?? {}, {
+                closePolicy: "manual",
+                local: options.local ?? true,
+                remote: options.remote
+                    ? {
+                        ...(typeof options?.remote === "object"
+                            ? {
+                                ...options.remote,
+                                onLateResults: onMissedResults,
+                                wait: {
+                                    ...options?.remote?.wait,
+                                    timeout: options?.remote?.wait?.timeout ?? 5000,
+                                },
+                            }
+                            : options?.remote
+                                ? {
+                                    onLateResults: onMissedResults,
+                                }
+                                : undefined),
+                    }
+                    : undefined,
+                resolve,
+                signal: abortSignal,
+                updates: {
+                    push: typeof options.updates === "boolean"
+                        ? options.updates
+                        : typeof options.updates === "object" && options.updates.push
+                            ? true
+                            : false,
+                    merge: typeof options.updates === "boolean" && options.updates
+                        ? true
+                        : typeof options.updates === "object" && options.updates.merge
+                            ? true
+                            : false,
+                    notify: (reason) => {
+                        log("notify", { reason, currentRef: !!currentRef });
+                        if (reason === "change" || reason === "push" || reason === "join") {
+                            const drainAmount = options.batchSize ?? 10;
+                            scheduleDrain(iterator, drainAmount, {
+                                force: true,
+                            });
+                        }
+                    },
+                    onBatch: (batch, props) => {
+                        log("onBatch", { batch, props, currentRef: !!currentRef });
+                        if (props.reason === "join" ||
+                            props.reason === "change" ||
+                            props.reason === "push") {
+                            if (!currentRef)
+                                return;
+                            handleBatch(iteratorRefs.current, [
+                                { ref: currentRef, items: batch },
+                            ]);
+                        }
+                    },
+                },
+            });
+            const ref = {
+                id: uuid(),
+                db,
+                iterator,
+                itemsConsumed: 0,
+            };
+            currentRef = ref;
+            log("Iterator init", ref.id, "db", db.address);
+            return ref;
+        });
+        /* store a deterministic id (useful for external keys) */
+        setId(uuid());
+        /* prefetch if requested */
+        if (options.prefetch)
+            void loadMore();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        dbs.map((d) => d?.address).join("|"),
+        options.query,
+        options.resolve,
+        options.reverse,
+        options.batchSize,
+    ]);
+    /* ────────────── loadMore implementation ────────────── */
+    const batchSize = options.batchSize ?? 10;
+    const shouldWait = () => {
+        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;
+    };
+    /* helper to turn primitive ids into stable map keys */
+    const idToKey = (value) => {
+        switch (typeof value) {
+            case "string":
+                return `s:${value}`;
+            case "number":
+                return `n:${value}`;
+            default:
+                return `b:${value.toString()}`;
+        }
+    };
+    const handleBatch = async (iterators, batches) => {
+        if (!iterators.length) {
+            log("No iterators in handleBatch");
+            return false;
+        }
+        const totalFetched = batches.reduce((sum, batch) => sum + batch.items.length, 0);
+        if (totalFetched === 0) {
+            log("No items fetched");
+            emptyResultsRef.current = iterators.every((i) => i.iterator.done());
+            return !emptyResultsRef.current;
+        }
+        let processed = batches;
+        if (options.transform) {
+            const transform = options.transform;
+            processed = await Promise.all(batches.map(async ({ ref, items }) => ({
+                ref,
+                items: await Promise.all(items.map(transform)),
+            })));
+        }
+        const prev = allRef.current;
+        const next = [...prev];
+        const keyIndex = new Map();
+        prev.forEach((item, idx) => {
+            const key = itemIdRef.current.get(item);
+            if (key)
+                keyIndex.set(key, idx);
+        });
+        const seenHeads = new Set(prev.map((x) => x.__context?.head));
+        const freshItems = [];
+        let hasMutations = false;
+        log("Processing batches", { processed, keyIndex });
+        for (const { ref, items } of processed) {
+            const db = ref.db;
+            for (const item of items) {
+                const ctx = item.__context;
+                const head = ctx?.head;
+                let key = null;
+                try {
+                    key = idToKey(db.index.resolveId(item).primitive);
+                }
+                catch (error) {
+                    log("useQuery: failed to resolve id", error);
+                }
+                if (key && keyIndex.has(key)) {
+                    const existingIndex = keyIndex.get(key);
+                    const current = next[existingIndex];
+                    const currentContext = current?.__context;
+                    const incomingContext = ctx;
+                    const shouldReplace = !currentContext ||
+                        !incomingContext ||
+                        currentContext.modified <= incomingContext.modified;
+                    if (shouldReplace && current !== item) {
+                        itemIdRef.current.delete(current);
+                        next[existingIndex] = item;
+                        hasMutations = true;
+                    }
+                    if (key) {
+                        itemIdRef.current.set(item, key);
+                        keyIndex.set(key, existingIndex);
+                    }
+                    if (head != null)
+                        seenHeads.add(head);
+                    continue;
+                }
+                if (head != null && seenHeads.has(head))
+                    continue;
+                if (head != null)
+                    seenHeads.add(head);
+                freshItems.push(item);
+                if (key) {
+                    itemIdRef.current.set(item, key);
+                    keyIndex.set(key, prev.length + freshItems.length - 1);
+                }
+            }
+        }
+        if (!freshItems.length && !hasMutations) {
+            emptyResultsRef.current = iterators.every((i) => i.iterator.done());
+            log("No new items or mutations");
+            return !emptyResultsRef.current;
+        }
+        const combined = reverseRef.current
+            ? [...freshItems.reverse(), ...next]
+            : [...next, ...freshItems];
+        log("Updating all with", {
+            prevLength: prev.length,
+            freshLength: freshItems.length,
+            combinedLength: combined.length,
+        });
+        updateAll(combined);
+        emptyResultsRef.current = iterators.every((i) => i.iterator.done());
+        return !emptyResultsRef.current;
+    };
+    const drainRoundRobin = async (iterators, n) => {
+        const batches = [];
+        for (const ref of iterators) {
+            if (ref.iterator.done())
+                continue;
+            const batch = await ref.iterator.next(n);
+            log("Iterator", ref.id, "fetched", batch.length, "items");
+            if (batch.length) {
+                ref.itemsConsumed += batch.length;
+                batches.push({ ref, items: batch });
+            }
+        }
+        return handleBatch(iterators, batches);
+    };
+    /*  maybe make the rule that if results are empty and we get results from joining
+     set the results to the joining results
+     when results are not empty use onMerge option to merge the results ?  */
+    const loadMore = async (n = batchSize, opts) => {
+        const iterators = iteratorRefs.current;
+        if (!iterators.length) {
+            log("No iterators or already empty", {
+                length: iterators.length,
+                emptyResultsRef: emptyResultsRef.current,
+            });
+            return false;
+        }
+        if (emptyResultsRef.current && !opts?.force) {
+            log("Skipping loadMore due to empty state");
+            return false;
+        }
+        else if (opts?.force) {
+            emptyResultsRef.current = false;
+        }
+        setIsLoading(true);
+        try {
+            /* one-time replicator warm-up across all DBs */
+            if (shouldWait()) {
+                /*   if (
+                     typeof options.remote === "object" &&
+                     options.remote.wait
+                 ) {
+                     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);
+                             }
+                         })
+                     );
+                 }*/
+                markWaited();
+            }
+            return drainRoundRobin(iterators, n);
+        }
+        catch (e) {
+            if (!(e instanceof ClosedError))
+                throw e;
+            return false;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    };
+    /* ────────────── live-merge listeners ────────────── */
+    useEffect(() => {
+        if (!options.updates) {
+            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.updates,
+        options.query,
+        options.resolve,
+        options.reverse,
+    ]);
+    /* ────────────── public API – unchanged from the caller's perspective ────────────── */
+    return {
+        items: all,
+        loadMore,
+        isLoading,
+        empty: () => emptyResultsRef.current,
+        id,
+    };
+};
+//# sourceMappingURL=useQuery.js.map

package/dist/src/useQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQuery.js","sourceRoot":"","sources":["../../src/useQuery.tsx"],"names":[],"mappings":"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"}

package/dist/src/utils.d.ts

@@ -0,0 +1,4 @@
+export declare function debounceLeadingTrailing<T extends (this: any, ...args: any[]) => void>(func: T, delay: number): ((this: ThisParameterType<T>, ...args: Parameters<T>) => void) & {
+    cancel: () => void;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,uBAAuB,CACtC,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAE7C,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,GACX,CAAC,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG;IACnE,MAAM,EAAE,MAAM,IAAI,CAAC;CACnB,CA+CA"}

package/dist/src/utils.js

@@ -0,0 +1,41 @@
+export function debounceLeadingTrailing(func, delay) {
+    let timeoutId = null;
+    let lastArgs = null;
+    let lastThis;
+    let pendingTrailing = false;
+    const debounced = function (...args) {
+        if (!timeoutId) {
+            // Leading call: no timer means this is the first call in this period.
+            func.apply(this, args);
+        }
+        else {
+            // Subsequent calls during the delay mark that a trailing call is needed.
+            pendingTrailing = true;
+        }
+        // Always update with the most recent context and arguments.
+        lastArgs = args;
+        lastThis = this;
+        // Reset the timer.
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => {
+            timeoutId = null;
+            // If there were any calls during the delay, call the function on the trailing edge.
+            if (pendingTrailing && lastArgs) {
+                func.apply(lastThis, lastArgs);
+            }
+            // Reset the trailing flag after the trailing call.
+            pendingTrailing = false;
+        }, delay);
+    };
+    debounced.cancel = () => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+        pendingTrailing = false;
+    };
+    return debounced;
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,uBAAuB,CAGtC,IAAO,EACP,KAAa;IAIb,IAAI,SAAS,GAAyC,IAAI,CAAC;IAC3D,IAAI,QAAQ,GAAyB,IAAI,CAAC;IAC1C,IAAI,QAAa,CAAC;IAClB,IAAI,eAAe,GAAG,KAAK,CAAC;IAE5B,MAAM,SAAS,GAAG,UAEjB,GAAG,IAAmB;QAEtB,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,sEAAsE;YACtE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACP,yEAAyE;YACzE,eAAe,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,4DAA4D;QAC5D,QAAQ,GAAG,IAAI,CAAC;QAChB,QAAQ,GAAG,IAAI,CAAC;QAEhB,mBAAmB;QACnB,IAAI,SAAS,EAAE,CAAC;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;QACD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,SAAS,GAAG,IAAI,CAAC;YACjB,oFAAoF;YACpF,IAAI,eAAe,IAAI,QAAQ,EAAE,CAAC;gBACjC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAChC,CAAC;YACD,mDAAmD;YACnD,eAAe,GAAG,KAAK,CAAC;QACzB,CAAC,EAAE,KAAK,CAAC,CAAC;IACX,CAEC,CAAC;IAEF,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE;QACvB,IAAI,SAAS,EAAE,CAAC;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,eAAe,GAAG,KAAK,CAAC;IACzB,CAAC,CAAC;IAEF,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@peerbit/document-react",
+  "version": "0.1.0",
+  "description": "React hooks for @peerbit/document",
+  "sideEffects": false,
+  "type": "module",
+  "types": "./dist/src/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "*",
+        "dist/*",
+        "dist/src/*",
+        "dist/src/*/index"
+      ],
+      "src/*": [
+        "*",
+        "dist/*",
+        "dist/src/*",
+        "dist/src/*/index"
+      ]
+    }
+  },
+  "files": [
+    "src",
+    "dist",
+    "!vitest",
+    "!dist/vitest",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "uuid": "^10.0.0",
+    "@peerbit/document": "10.1.0",
+    "@peerbit/react": "0.0.34",
+    "@peerbit/logger": "2.0.0",
+    "@peerbit/indexer-interface": "2.1.0"
+  },
+  "devDependencies": {
+    "@dao-xyz/borsh": "^6.0.0",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^19.2.4",
+    "@types/react-dom": "^19.2.3",
+    "@types/libsodium-wrappers": "^0.7.14",
+    "libsodium-wrappers": "^0.7.14",
+    "react-dom": "^19.0.0",
+    "happy-dom": "^20.0.10",
+    "vitest": "^4.0.12",
+    "@peerbit/blocks-interface": "1.5.0",
+    "peerbit": "4.4.0",
+    "@peerbit/program": "1.0.0"
+  },
+  "author": "dao.xyz",
+  "license": "MIT",
+  "scripts": {
+    "clean": "aegir clean",
+    "build": "aegir build --no-bundle",
+    "test": "vitest run --project node && vitest run --project dom",
+    "test:node": "vitest run --project node",
+    "test:dom": "vitest run --project dom",
+    "lint": "aegir lint"
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from "./utils.js";
+export { useLocal } from "./useLocal.js";
+export { useQuery, type UseQuerySharedOptions } from "./useQuery.js";
+export { useCount } from "./useCount.js";
+export { FastMutex } from "@peerbit/react";

package/src/useCount.tsx

@@ -0,0 +1,57 @@
+import { ClosedError, Documents } from "@peerbit/document";
+import * as indexerTypes from "@peerbit/indexer-interface";
+import { useEffect, useRef, useState } from "react";
+import { debounceLeadingTrailing } from "./utils.js";
+
+type QueryOptons = {
+	query: indexerTypes.Query[] | indexerTypes.QueryLike;
+	id?: string;
+};
+export const useCount = <T extends Record<string, any>>(
+	db?: Documents<T, any, any>,
+	options?: {
+		debounce?: number;
+		debug?: boolean; // add debug option here
+	} & QueryOptons,
+) => {
+	const [count, setCount] = useState<number>(0);
+	const countRef = useRef<number>(0);
+
+	useEffect(() => {
+		if (!db || db.closed) {
+			return;
+		}
+
+		const _l = async (args?: any) => {
+			try {
+				const count = await db.count({
+					query: options?.query,
+					approximate: true,
+				});
+				countRef.current = count;
+				setCount(count);
+			} catch (error) {
+				if (error instanceof ClosedError) {
+					return;
+				}
+				throw error;
+			}
+		};
+
+		const debounced = debounceLeadingTrailing(_l, options?.debounce ?? 1000);
+
+		const handleChange = () => {
+			debounced();
+		};
+
+		debounced();
+		db.events.addEventListener("change", handleChange);
+
+		return () => {
+			db.events.removeEventListener("change", handleChange);
+			debounced.cancel();
+		};
+	}, [db?.closed ? undefined : db?.rootAddress, options?.id ?? options?.query]);
+
+	return count;
+};