captivate-chat-api/dist/api/Conversation.d.ts

This is a wrapper for captivate chat api socket custom channel

interface Action {
    id: string;
    data: any;
}
/**
 * Represents a conversation session, handling WebSocket communication and event management.
 */
export declare class Conversation {
    apiKey: string;
    private conversationId;
    private socket;
    private listeners;
    private metadata;
    private local_id;
    private mode;
    /**
     * Initializes a new Conversation instance.
     * @param conversationId - The unique identifier of the conversation.
     * @param socket - The WebSocket instance for communication.
     * @param metadata - Optional metadata for the conversation.
     * @param apiKey - Optional API key for REST operations.
     * @param mode - The mode of operation ('prod' or 'dev').
     */
    constructor(conversation_id: string, socket: WebSocket, metadata?: object, apiKey?: string, mode?: 'prod' | 'dev');
    private handleMessage;
    restartListeners(): void;
    /**
     * Adds an event listener for a specific event type.
     * @param eventType - The type of event to listen for.
     * @param callback - The function to invoke when the event occurs.
     */
    private addListener;
    /**
     * Registers a listener for messages from the bot or live chat.
     * @param callback - The function to handle incoming messages.
     */
    onMessage(callback: (message: string, type: string) => void): void;
    /**
       * Registers a listener for receiving actions.
       * @param callback - The function to handle incoming action.
       */
    onActionReceived(callback: (actions: [Action]) => void): void;
    /**
     * Registers a listener for updates to the conversation.
     * @param callback - The function to handle conversation updates.
     */
    onConversationUpdate(callback: (update: any) => void): void;
    /**
     * Registers a listener for error events.
     * @param callback - The function to handle errors.
     */
    onError(callback: (error: any) => void): void;
    /**
     * Sends a message to the conversation.
     * @param content - The message content to send.
     * @returns A promise that resolves when the message is sent.
     */
    sendMessage(content: object | string): Promise<void>;
    /**
    * Sets metadata for the conversation and listens for success confirmation.
    * @param metadata - An object containing the metadata to set.
    * @returns A promise that resolves when the metadata update is successful.
    */
    setMetadata(metadata: object): Promise<void>;
    /**
   * Sets private metadata for the conversation (not visible to frontend).
   * @param privateMeta - An object containing the private metadata to set.
   * @returns A promise that resolves when the metadata update is successful.
   */
    setPrivateMetadata(privateMeta: object): Promise<void>;
    /**
     * Sends an action to the conversation.
     * @param actionId - The unique ID of the action to send.
     * @param data - Optional data associated with the action.
     * @returns A promise that resolves when the action is sent.
     */
    sendAction(actionId: string, data?: object): Promise<void>;
    /**
     * Requests the transcript of the conversation with automatic file URL refresh.
     * @returns A promise that resolves to the conversation transcript with refreshed file URLs.
     */
    getTranscript(): Promise<object[]>;
    /**
     * Refreshes expired file URLs in the transcript.
     * @param transcript - The transcript array to process.
     * @returns A promise that resolves to the transcript with refreshed file URLs.
     */
    private refreshExpiredFileUrls;
    /**
   * Requests metadata for the conversation.
   * @returns A promise that resolves to the conversation metadata.
   */
    getMetadata(): Promise<object>;
    /**
      * Deletes this conversation.
      * @returns A promise that resolves when the conversation is deleted successfully.
      */
    delete(): Promise<void>;
    /**
     * Converts a File object to base64 string.
     * @param file - The File object to convert.
     * @returns A promise that resolves to the base64 string.
     */
    private fileToBase64;
    /**
     * Converts a Blob object to base64 string.
     * @param blob - The Blob object to convert.
     * @returns A promise that resolves to the base64 string.
     */
    private blobToBase64;
    /**
     * Edits a message in the conversation.
     * @param messageId - The ID of the message to edit.
     * @param content - The new content for the message (object or string).
     * @returns A promise that resolves when the edit is confirmed by user_message_updated.
     */
    editMessage(messageId: string, content: object | string): Promise<void>;
    /**
     * Sends a payload to the WebSocket.
     * @param eventType - The type of event being sent.
     * @param payload - The payload data to include with the event.
     * @returns A promise that resolves when the payload is sent.
     */
    private sendPayload;
    /**
     * Removes a specific event listener.
     * @param eventType - The type of event.
     * @param callback - The callback function to remove.
     */
    private removeListener;
    /**
     * Gets the unique identifier of the conversation.
     * @returns The conversation ID.
     */
    getConversationId(): string;
}
export {};