doover-js 0.4.6 → 0.4.8

package/dist/apis/messages-api.d.ts

@@ -28,5 +28,6 @@ export declare class MessagesApi {
     patchMessage(agentId: string, channelName: string, messageId: string, body: MessageBody, params?: MessageMutationParams): Promise<unknown>;
     deleteMessage(agentId: string, channelName: string, messageId: string): Promise<unknown>;
     getMessageAttachment(agentId: string, channelName: string, messageId: string, attachmentId: string): Promise<Blob>;
+    getInvocationLogs<TLog = unknown>(agentId: string, channelName: string, messageId: string): Promise<TLog[]>;
     createMultipartPayload(jsonPayload: Record<string, unknown>, attachments: Array<Blob | File>): FormData;
 }

package/dist/apis/messages-api.js

@@ -33,6 +33,9 @@ class MessagesApi {
     getMessageAttachment(agentId, channelName, messageId, attachmentId) {
         return this.rest.get(`/agents/${agentId}/channels/${channelName}/messages/${messageId}/attachments/${attachmentId}`);
     }
+    getInvocationLogs(agentId, channelName, messageId) {
+        return this.rest.get(`/agents/${agentId}/channels/${channelName}/messages/${messageId}/logs`);
+    }
     createMultipartPayload(jsonPayload, attachments) {
         const formData = new FormData();
         formData.set("json_payload", JSON.stringify(jsonPayload));

package/dist/react/index.d.ts

@@ -17,6 +17,8 @@ export { useChannelMessages, channelMessagesQueryKey, } from "./useChannelMessag
 export type { UseChannelMessagesOptions, UseChannelMessagesResult, } from "./useChannelMessages";
 export { useChannelMessage, channelMessageQueryKey, } from "./useChannelMessage";
 export type { UseChannelMessageOptions, UseChannelMessageResult, } from "./useChannelMessage";
+export { useInvocationLogs, invocationLogsQueryKey, } from "./useInvocationLogs";
+export type { UseInvocationLogsOptions } from "./useInvocationLogs";
 export { useSendRpc } from "./useSendRpc";
 export type { RpcCommandId, RpcStatusEvent, SendRpcVariables, UseSendRpcOptions, UseSendRpcResult, } from "./useSendRpc";
 export { useMultiAgentAggregates, multiAgentAggregatesQueryKey, } from "./useMultiAgentAggregates";

package/dist/react/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resetSharedQueryClient = exports.getSharedQueryClient = exports.useTurnCredentials = exports.multiAgentChannelMessagesQueryKey = exports.useMultiAgentChannelMessages = exports.multiAgentAggregatesQueryKey = exports.useMultiAgentAggregates = exports.useSendRpc = exports.channelMessageQueryKey = exports.useChannelMessage = exports.channelMessagesQueryKey = exports.useChannelMessages = exports.useUpdateMessage = exports.useUpdateAggregate = exports.useSendMessage = exports.useAgentChannel = exports.channelAggregateQueryKey = exports.useChannelAggregate = exports.useChannelSubscription = exports.agentConnectionsQueryKey = exports.useAgentConnections = exports.useConnectionState = exports.useDooverClient = exports.DooverProvider = void 0;
+exports.resetSharedQueryClient = exports.getSharedQueryClient = exports.useTurnCredentials = exports.multiAgentChannelMessagesQueryKey = exports.useMultiAgentChannelMessages = exports.multiAgentAggregatesQueryKey = exports.useMultiAgentAggregates = exports.useSendRpc = exports.invocationLogsQueryKey = exports.useInvocationLogs = exports.channelMessageQueryKey = exports.useChannelMessage = exports.channelMessagesQueryKey = exports.useChannelMessages = exports.useUpdateMessage = exports.useUpdateAggregate = exports.useSendMessage = exports.useAgentChannel = exports.channelAggregateQueryKey = exports.useChannelAggregate = exports.useChannelSubscription = exports.agentConnectionsQueryKey = exports.useAgentConnections = exports.useConnectionState = exports.useDooverClient = exports.DooverProvider = void 0;
 var context_1 = require("./context");
 Object.defineProperty(exports, "DooverProvider", { enumerable: true, get: function () { return context_1.DooverProvider; } });
 Object.defineProperty(exports, "useDooverClient", { enumerable: true, get: function () { return context_1.useDooverClient; } });
@@ -28,6 +28,9 @@ Object.defineProperty(exports, "channelMessagesQueryKey", { enumerable: true, ge
 var useChannelMessage_1 = require("./useChannelMessage");
 Object.defineProperty(exports, "useChannelMessage", { enumerable: true, get: function () { return useChannelMessage_1.useChannelMessage; } });
 Object.defineProperty(exports, "channelMessageQueryKey", { enumerable: true, get: function () { return useChannelMessage_1.channelMessageQueryKey; } });
+var useInvocationLogs_1 = require("./useInvocationLogs");
+Object.defineProperty(exports, "useInvocationLogs", { enumerable: true, get: function () { return useInvocationLogs_1.useInvocationLogs; } });
+Object.defineProperty(exports, "invocationLogsQueryKey", { enumerable: true, get: function () { return useInvocationLogs_1.invocationLogsQueryKey; } });
 var useSendRpc_1 = require("./useSendRpc");
 Object.defineProperty(exports, "useSendRpc", { enumerable: true, get: function () { return useSendRpc_1.useSendRpc; } });
 var useMultiAgentAggregates_1 = require("./useMultiAgentAggregates");

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/dist/react/useInvocationLogs.d.ts

@@ -0,0 +1,23 @@
+import { type UseQueryResult } from "@tanstack/react-query";
+import type { ChannelIdentifier } from "../types/viewer";
+export declare function invocationLogsQueryKey(agentId: string | undefined, channelName: string | undefined, messageId: string | undefined): readonly ["doover", "agent", string | undefined, "channel", string | undefined, "message", string | undefined, "logs"];
+export interface UseInvocationLogsOptions {
+    /** Defaults to true. Set false to skip the query (e.g. dialog closed). */
+    enabled?: boolean;
+    /**
+     * react-query retry behaviour. Defaults to false — the logs endpoint
+     * commonly 404s while logs are still materialising server-side, and a
+     * manual refetch button is friendlier than silent retry.
+     */
+    retry?: boolean | number;
+}
+/**
+ * Fetch the log entries for a single invocation message. The `/logs`
+ * endpoint is only meaningful for invocation messages (channel name like
+ * `dv-proc-inv-…`); other message types return 404.
+ *
+ * Generic on `TLog` — the shape of a single log entry. Defaults to `unknown`
+ * because log payloads are domain-specific (lambda telemetry, app-level
+ * structured logs, etc.) and doover-js does not own the canonical shape.
+ */
+export declare function useInvocationLogs<TLog = unknown>(identifier: ChannelIdentifier, messageId: string | undefined, options?: UseInvocationLogsOptions): UseQueryResult<TLog[]>;

package/dist/react/useInvocationLogs.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invocationLogsQueryKey = invocationLogsQueryKey;
+exports.useInvocationLogs = useInvocationLogs;
+const react_query_1 = require("@tanstack/react-query");
+const context_1 = require("./context");
+function invocationLogsQueryKey(agentId, channelName, messageId) {
+    return [
+        "doover",
+        "agent",
+        agentId,
+        "channel",
+        channelName,
+        "message",
+        messageId,
+        "logs",
+    ];
+}
+/**
+ * Fetch the log entries for a single invocation message. The `/logs`
+ * endpoint is only meaningful for invocation messages (channel name like
+ * `dv-proc-inv-…`); other message types return 404.
+ *
+ * Generic on `TLog` — the shape of a single log entry. Defaults to `unknown`
+ * because log payloads are domain-specific (lambda telemetry, app-level
+ * structured logs, etc.) and doover-js does not own the canonical shape.
+ */
+function useInvocationLogs(identifier, messageId, options) {
+    const client = (0, context_1.useDooverClient)();
+    const { agentId, channelName } = identifier;
+    return (0, react_query_1.useQuery)({
+        queryKey: invocationLogsQueryKey(agentId, channelName, messageId),
+        queryFn: () => client.messages.getInvocationLogs(agentId, channelName, messageId),
+        enabled: !!agentId &&
+            !!channelName &&
+            !!messageId &&
+            (options?.enabled ?? true),
+        retry: options?.retry ?? false,
+        staleTime: Infinity,
+    });
+}

package/dist/test/react.test.js

@@ -336,6 +336,42 @@ function wrapper(client) {
         });
         await (0, react_1.waitFor)(() => (0, chai_1.expect)(result.current.data?.response?.status).to.equal("success"));
     });
+    (0, mocha_1.it)("useInvocationLogs fetches logs for the message", async () => {
+        const messageId = (0, snowflake_1.generateSnowflakeIdAtTime)(new Date("2026-01-01T00:00:00.000Z"));
+        const fetchMock = (0, helpers_1.createFetchMock)(() => (0, helpers_1.createJsonResponse)([
+            { level: "INFO", message: "hello", timestamp: 1 },
+            { level: "ERROR", message: "boom", timestamp: 2 },
+        ]));
+        const client = new doover_client_1.DooverClient({
+            dataRestUrl: "https://api.example.com",
+            controlApiUrl: "https://control.example.com",
+            dataWssUrl: "wss://ws.example.com",
+            fetchImpl: fetchMock,
+            webSocketImpl: helpers_1.MockWebSocket,
+            disableBrowserLifecycleHooks: true,
+        });
+        const { result } = (0, react_1.renderHook)(() => (0, react_2.useInvocationLogs)({ agentId: "a1", channelName: "dv-proc-inv-1" }, messageId), { wrapper: wrapper(client) });
+        await (0, react_1.waitFor)(() => (0, chai_1.expect)(result.current.isSuccess).to.equal(true));
+        (0, chai_1.expect)(result.current.data?.map((l) => l.level)).to.deep.equal([
+            "INFO",
+            "ERROR",
+        ]);
+        const requestUrl = fetchMock.firstCall?.args[0];
+        (0, chai_1.expect)(requestUrl).to.contain(`/agents/a1/channels/dv-proc-inv-1/messages/${messageId}/logs`);
+    });
+    (0, mocha_1.it)("useInvocationLogs is disabled when messageId is undefined", () => {
+        const fetchMock = (0, helpers_1.createFetchMock)(() => (0, helpers_1.createJsonResponse)([]));
+        const client = new doover_client_1.DooverClient({
+            dataRestUrl: "https://api.example.com",
+            controlApiUrl: "https://control.example.com",
+            dataWssUrl: "wss://ws.example.com",
+            fetchImpl: fetchMock,
+            webSocketImpl: helpers_1.MockWebSocket,
+            disableBrowserLifecycleHooks: true,
+        });
+        (0, react_1.renderHook)(() => (0, react_2.useInvocationLogs)({ agentId: "a1", channelName: "dv-proc-inv-1" }, undefined), { wrapper: wrapper(client) });
+        (0, chai_1.expect)(fetchMock.callCount).to.equal(0);
+    });
     (0, mocha_1.it)("getSharedQueryClient returns the same QueryClient across callers", () => {
         (0, react_2.resetSharedQueryClient)();
         const a = (0, react_2.getSharedQueryClient)();

package/package.json

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