@recursiv/sdk 0.2.0

package/dist/lib/webhooks.js

@@ -0,0 +1,91 @@
+export class WebhookVerificationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WebhookVerificationError';
+    }
+}
+/**
+ * Validates a webhook signature, protecting against tampering and replay attacks.
+ * Designed to work in Node.js, Edge runtimes, and Cloudflare Workers.
+ */
+export async function verifyWebhookSignature({ payload, signatureHeader, secret, toleranceMs = 5 * 60 * 1000, }) {
+    if (!signatureHeader) {
+        throw new WebhookVerificationError('Missing signature header');
+    }
+    // Header format: t=1614264667,v1=a2b...
+    const parts = signatureHeader.split(',');
+    let timestamp;
+    let signature;
+    for (const part of parts) {
+        const [key, value] = part.split('=');
+        if (key === 't') {
+            timestamp = value;
+        }
+        else if (key === 'v1') {
+            signature = value;
+        }
+    }
+    if (!timestamp || !signature) {
+        throw new WebhookVerificationError('Invalid signature header format');
+    }
+    const timestampNum = parseInt(timestamp, 10);
+    if (isNaN(timestampNum)) {
+        throw new WebhookVerificationError('Invalid timestamp in signature header');
+    }
+    const now = Date.now();
+    // Check if timestamp is too old or too far in the future
+    if (Math.abs(now - timestampNum) > toleranceMs) {
+        throw new WebhookVerificationError('Webhook timestamp is outside of the tolerance zone (potential replay attack)');
+    }
+    const payloadStr = typeof payload === 'string' ? payload : new TextDecoder().decode(payload);
+    const payloadToSign = `${timestamp}.${payloadStr}`;
+    const encoder = new TextEncoder();
+    // Use Web Crypto API for edge compatibility
+    const crypto = globalThis.crypto;
+    if (!crypto || !crypto.subtle) {
+        throw new WebhookVerificationError('Web Crypto API is not available in this environment');
+    }
+    const key = await crypto.subtle.importKey('raw', encoder.encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['verify']);
+    const signatureBytes = hexToBytes(signature);
+    if (!signatureBytes) {
+        throw new WebhookVerificationError('Invalid signature encoding');
+    }
+    const isValid = await crypto.subtle.verify('HMAC', key, signatureBytes.buffer, encoder.encode(payloadToSign));
+    if (!isValid) {
+        throw new WebhookVerificationError('Invalid webhook signature');
+    }
+    return true;
+}
+/**
+ * Parses and validates a webhook payload.
+ * Returns the typed event object. Checks idempotency using the event ID.
+ */
+export async function constructWebhookEvent(payload, signatureHeader, secret, toleranceMs) {
+    await verifyWebhookSignature({ payload, signatureHeader, secret, toleranceMs });
+    const payloadStr = typeof payload === 'string' ? payload : new TextDecoder().decode(payload);
+    let event;
+    try {
+        event = JSON.parse(payloadStr);
+    }
+    catch (error) {
+        throw new WebhookVerificationError('Invalid JSON payload');
+    }
+    if (!event || !event.id || !event.type) {
+        throw new WebhookVerificationError('Invalid event payload structure');
+    }
+    // The event ID itself acts as the idempotency key for webhooks
+    return { event, idempotencyKey: event.id };
+}
+function hexToBytes(hex) {
+    if (hex.length % 2 !== 0)
+        return null;
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        const val = parseInt(hex.substring(i * 2, i * 2 + 2), 16);
+        if (isNaN(val))
+            return null;
+        bytes[i] = val;
+    }
+    return bytes;
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/lib/webhooks.js.map

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

package/dist/react/index.d.ts

@@ -0,0 +1,2 @@
+export * from './useChat.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,2 @@
+export * from './useChat.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/react/useChat.d.ts

@@ -0,0 +1,26 @@
+import type { Recursiv } from '../index.js';
+import type { ChatMessageEvent, ChatMessageEditEvent, ChatMessageDeleteEvent, TypingEvent, AgentThinkingEvent } from '../realtime.js';
+export interface UseChatOptions {
+    conversationId?: string;
+    onMessage?: (msg: ChatMessageEvent) => void;
+    onEdit?: (msg: ChatMessageEditEvent) => void;
+    onDelete?: (msg: ChatMessageDeleteEvent) => void;
+    onTyping?: (event: TypingEvent) => void;
+    onAgentThinking?: (event: AgentThinkingEvent) => void;
+}
+/**
+ * A React hook that manages WebSocket connections for a specific conversation.
+ * It will automatically connect, join the conversation room, and listen for events.
+ *
+ * @param recursiv The initialized Recursiv SDK client
+ * @param options Configuration for the chat connection
+ * @returns Functions to interact with the chat via WebSocket
+ */
+export declare function useChat(recursiv: Recursiv, options?: UseChatOptions): {
+    isConnected: boolean;
+    error: Error | null;
+    sendTyping: () => void;
+    fetchHistory: (limit?: number, cursor?: string) => Promise<import("../types.js").PaginatedResponse<import("../types.js").Message>>;
+    sendMessage: (content: string, replyToId?: string) => Promise<import("../types.js").SingleResponse<import("../types.js").SentMessage>>;
+};
+//# sourceMappingURL=useChat.d.ts.map

package/dist/react/useChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../../src/react/useChat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEtI,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,cAAmB;;;;2BA+FxC,MAAM,WAAgB,MAAM;2BAK3B,MAAM,cAAc,MAAM;EAS1D"}

package/dist/react/useChat.js

@@ -0,0 +1,111 @@
+import * as React from 'react';
+/**
+ * A React hook that manages WebSocket connections for a specific conversation.
+ * It will automatically connect, join the conversation room, and listen for events.
+ *
+ * @param recursiv The initialized Recursiv SDK client
+ * @param options Configuration for the chat connection
+ * @returns Functions to interact with the chat via WebSocket
+ */
+export function useChat(recursiv, options = {}) {
+    const { conversationId, onMessage, onEdit, onDelete, onTyping, onAgentThinking } = options;
+    const [isConnected, setIsConnected] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    // Store callbacks in refs to avoid constant re-subscriptions
+    const callbacksRef = React.useRef({
+        onMessage,
+        onEdit,
+        onDelete,
+        onTyping,
+        onAgentThinking
+    });
+    React.useEffect(() => {
+        callbacksRef.current = { onMessage, onEdit, onDelete, onTyping, onAgentThinking };
+    });
+    React.useEffect(() => {
+        let mounted = true;
+        let cleanupFuncs = [];
+        const setupRealtime = async () => {
+            try {
+                await recursiv.realtime.connect();
+                if (!mounted)
+                    return;
+                setIsConnected(true);
+                setError(null);
+                if (conversationId) {
+                    recursiv.realtime.joinConversation(conversationId);
+                }
+                // Setup generic listeners that delegate to the ref'd callbacks
+                const unsubs = [
+                    recursiv.realtime.onMessage((msg) => {
+                        if (!conversationId || msg.conversationId === conversationId) {
+                            callbacksRef.current.onMessage?.(msg);
+                        }
+                    }),
+                    recursiv.realtime.onMessageEdit((msg) => {
+                        if (!conversationId || msg.conversationId === conversationId) {
+                            callbacksRef.current.onEdit?.(msg);
+                        }
+                    }),
+                    recursiv.realtime.onMessageDelete((msg) => {
+                        if (!conversationId || msg.conversationId === conversationId) {
+                            callbacksRef.current.onDelete?.(msg);
+                        }
+                    }),
+                    recursiv.realtime.onTyping((evt) => {
+                        if (!conversationId || evt.conversationId === conversationId) {
+                            callbacksRef.current.onTyping?.(evt);
+                        }
+                    }),
+                    recursiv.realtime.onAgentThinking((evt) => {
+                        if (!conversationId || evt.conversationId === conversationId) {
+                            callbacksRef.current.onAgentThinking?.(evt);
+                        }
+                    })
+                ];
+                cleanupFuncs = unsubs.filter(Boolean);
+            }
+            catch (err) {
+                if (mounted) {
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                    setIsConnected(false);
+                }
+            }
+        };
+        setupRealtime();
+        return () => {
+            mounted = false;
+            cleanupFuncs.forEach(fn => { fn(); });
+            if (conversationId) {
+                recursiv.realtime.leaveConversation(conversationId);
+            }
+        };
+    }, [recursiv, conversationId]);
+    const sendTyping = React.useCallback(() => {
+        if (conversationId && isConnected) {
+            recursiv.realtime.sendTyping(conversationId);
+        }
+    }, [conversationId, isConnected, recursiv]);
+    return {
+        isConnected,
+        error,
+        sendTyping,
+        // Provide a helper to fetch historical messages via REST
+        fetchHistory: async (limit = 50, cursor) => {
+            if (!conversationId)
+                throw new Error('No conversationId provided');
+            return recursiv.chat.messages(conversationId, { limit, cursor });
+        },
+        // Provide a helper to send messages via REST
+        sendMessage: async (content, replyToId) => {
+            if (!conversationId)
+                throw new Error('No conversationId provided');
+            return recursiv.chat.send({
+                conversation_id: conversationId,
+                content,
+                reply_to_id: replyToId
+            });
+        }
+    };
+}
+//# sourceMappingURL=useChat.js.map

package/dist/react/useChat.js.map

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

package/dist/realtime.d.ts

@@ -0,0 +1,67 @@
+import { Socket } from 'socket.io-client';
+import { HttpClient } from './client.js';
+export interface ChatMessageEvent {
+    id: string;
+    conversationId: string;
+    text?: string;
+    sender: {
+        id: string;
+        name: string;
+        username?: string;
+        image?: string;
+        isAi?: boolean;
+    };
+    createdAt: string;
+}
+export interface ChatMessageEditEvent {
+    id: string;
+    conversationId: string;
+    text?: string;
+    updatedAt?: string;
+}
+export interface ChatMessageDeleteEvent {
+    id: string;
+    conversationId: string;
+}
+export interface TypingEvent {
+    conversationId: string;
+    userId: string;
+    userName?: string;
+    isTyping: boolean;
+}
+export interface AgentThinkingEvent {
+    conversationId: string;
+    agentId: string;
+    agentName: string;
+    agentUsername?: string;
+    agentImage?: string;
+    model?: string;
+    status: 'thinking' | 'generating' | 'done' | 'error';
+    tokenCount?: number;
+    elapsedMs?: number;
+    messageId?: string;
+    chunk?: string;
+    accumulatedContent?: string;
+    isContinuing?: boolean;
+}
+export declare class RealtimeClient {
+    private socket;
+    private client;
+    private connectionPromise;
+    constructor(client: HttpClient);
+    /**
+     * Connects to the WebSocket server using a temporary WebSocket token
+     */
+    connect(): Promise<Socket>;
+    disconnect(): void;
+    getSocket(): Socket | null;
+    joinConversation(conversationId: string): void;
+    leaveConversation(conversationId: string): void;
+    sendTyping(conversationId: string): void;
+    onMessage(callback: (msg: ChatMessageEvent) => void): (() => void) | undefined;
+    onMessageEdit(callback: (msg: ChatMessageEditEvent) => void): (() => void) | undefined;
+    onMessageDelete(callback: (msg: ChatMessageDeleteEvent) => void): (() => void) | undefined;
+    onTyping(callback: (event: TypingEvent) => void): (() => void) | undefined;
+    onAgentThinking(callback: (event: AgentThinkingEvent) => void): (() => void) | undefined;
+}
+//# sourceMappingURL=realtime.d.ts.map

package/dist/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,iBAAiB,CAAgC;gBAE7C,MAAM,EAAE,UAAU;IAI9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAqDhC,UAAU;IAQV,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B,gBAAgB,CAAC,cAAc,EAAE,MAAM;IAMvC,iBAAiB,CAAC,cAAc,EAAE,MAAM;IAMxC,UAAU,CAAC,cAAc,EAAE,MAAM;IAMjC,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;IAK9E,aAAa,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;IAKtF,eAAe,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;IAK1F,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;IAK1E,eAAe,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;CAIzF"}

package/dist/realtime.js

@@ -0,0 +1,104 @@
+import { io } from 'socket.io-client';
+export class RealtimeClient {
+    socket = null;
+    client;
+    connectionPromise = null;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Connects to the WebSocket server using a temporary WebSocket token
+     */
+    async connect() {
+        if (this.socket?.connected) {
+            return this.socket;
+        }
+        if (this.connectionPromise) {
+            return this.connectionPromise;
+        }
+        this.connectionPromise = (async () => {
+            try {
+                // Fetch a short-lived WS token via REST API
+                const response = await this.client.get('/trpc/sessionManagement.getWebSocketToken');
+                const token = response.result?.data?.token;
+                if (!token) {
+                    throw new Error('Failed to fetch WebSocket token');
+                }
+                const socket = io(this.client.baseOrigin, {
+                    path: '/socket.io',
+                    transports: ['websocket', 'polling'],
+                    auth: { token },
+                    autoConnect: true,
+                    reconnection: true,
+                });
+                this.socket = socket;
+                return await new Promise((resolve, reject) => {
+                    socket.on('connect', () => {
+                        resolve(socket);
+                    });
+                    socket.on('connect_error', (err) => {
+                        socket.disconnect();
+                        if (this.socket === socket) {
+                            this.socket = null;
+                        }
+                        if (this.connectionPromise !== null) {
+                            this.connectionPromise = null;
+                        }
+                        reject(err);
+                    });
+                });
+            }
+            catch (error) {
+                this.connectionPromise = null;
+                throw error;
+            }
+        })();
+        return this.connectionPromise;
+    }
+    disconnect() {
+        if (this.socket) {
+            this.socket.disconnect();
+            this.socket = null;
+        }
+        this.connectionPromise = null;
+    }
+    getSocket() {
+        return this.socket;
+    }
+    joinConversation(conversationId) {
+        if (this.socket?.connected) {
+            this.socket.emit('join_conversation', conversationId);
+        }
+    }
+    leaveConversation(conversationId) {
+        if (this.socket?.connected) {
+            this.socket.emit('leave_conversation', conversationId);
+        }
+    }
+    sendTyping(conversationId) {
+        if (this.socket?.connected) {
+            this.socket.emit('chat_typing', { conversationId });
+        }
+    }
+    onMessage(callback) {
+        this.socket?.on('chat_message', callback);
+        return () => this.socket?.off('chat_message', callback);
+    }
+    onMessageEdit(callback) {
+        this.socket?.on('chat_message_edit', callback);
+        return () => this.socket?.off('chat_message_edit', callback);
+    }
+    onMessageDelete(callback) {
+        this.socket?.on('chat_message_delete', callback);
+        return () => this.socket?.off('chat_message_delete', callback);
+    }
+    onTyping(callback) {
+        this.socket?.on('chat_typing', callback);
+        return () => this.socket?.off('chat_typing', callback);
+    }
+    onAgentThinking(callback) {
+        this.socket?.on('agent_thinking', callback);
+        return () => this.socket?.off('agent_thinking', callback);
+    }
+}
+//# sourceMappingURL=realtime.js.map

package/dist/realtime.js.map

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