doover-js 0.4.6 → 0.4.7

package/dist/react/useChannelMessages.d.ts

@@ -19,6 +19,20 @@ export interface UseChannelMessagesOptions {
      * snowflake so server-stamped messages don't get missed).
      */
     initialBefore?: string;
+    /**
+     * Optional lower-bound snowflake id. The server only returns messages
+     * newer than this on every page, so paginating older eventually returns
+     * an empty page and `hasNextPage` flips to false — useful for fetching
+     * a bounded time window (e.g. last 24h) without a manual cutoff loop on
+     * the consumer side.
+     */
+    after?: string;
+    /**
+     * Keep paging older automatically until `hasNextPage` is false. Almost
+     * always combined with `after` (or a small channel) — without a lower
+     * bound this will walk the channel back to its first message.
+     */
+    autoPaginate?: boolean;
 }
 type Page<TData> = MessageStructure<TData>[];
 export interface UseChannelMessagesResult<TData> extends Omit<UseInfiniteQueryResult<InfiniteData<Page<TData>>>, "data"> {

package/dist/react/useChannelMessages.js

@@ -22,6 +22,8 @@ function useChannelMessages(identifier, options) {
     const liveUpdates = options?.liveUpdates ?? true;
     const fields = options?.fields;
     const initialBefore = options?.initialBefore;
+    const after = options?.after;
+    const autoPaginate = options?.autoPaginate ?? false;
     const key = channelMessagesQueryKey(agentId, channelName);
     const onMessage = (0, react_1.useCallback)((message) => {
         queryClient.setQueryData(key, (current) => {
@@ -50,10 +52,18 @@ function useChannelMessages(identifier, options) {
                 ...(typeof pageParam === "string" ? { before: pageParam } : {}),
                 ...(limit !== undefined ? { limit } : {}),
                 ...(fields && fields.length > 0 ? { field_name: fields } : {}),
+                ...(after !== undefined ? { after } : {}),
             });
             return (page ?? []);
         },
     });
+    (0, react_1.useEffect)(() => {
+        if (!autoPaginate)
+            return;
+        if (query.isFetching || !query.hasNextPage)
+            return;
+        query.fetchNextPage();
+    }, [autoPaginate, query.isFetching, query.hasNextPage, query.fetchNextPage]);
     const messages = (0, react_1.useMemo)(() => (query.data?.pages ?? []).flat(), [query.data]);
     return { ...query, messages };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doover-js",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "TypeScript client for Doover.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",