@onlive.ai/common-121 0.2.66 → 0.2.163

package/services/conversation/conversation.service.d.ts

@@ -0,0 +1,533 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+import { Room as Room$1 } from 'livekit-client';
+import { ConversationServiceOptions, UserApiResponse, AgentData, CreateRoomOptions, EvaluateRoomOptions, GetRoomsOptions, RoomsApiResponse, PersistMessageOptions, MessagesApiResponse, GetMessagesOptions, ApiMessage, MessageReportOptions, MessageReactionOptions, MessageListener, TypingListener, ContextualEvent, RequestNewRoomOptions, RoomApiResponse, CallRequest, CallRequestListener, RoomSyncData, NewRoomRequestData } from './conversation.types.js';
+import '@livekit/components-core';
+import '../firebase/firebase-api.js';
+import 'firebase/database';
+
+/**
+ * Extended Room class with persistent metadata.
+ *
+ * @description Extends LiveKit Room with additional properties for
+ * tracking room lifecycle and metadata.
+ */
+declare class Room extends Room$1 {
+    /** Unique room identifier */
+    id: string;
+    /** Group identifier for room categorization */
+    groupId: string;
+    /** ISO timestamp of room creation */
+    createdAt: string;
+    /** ISO timestamp when user connected */
+    connectedAt: string;
+}
+/**
+ * @summary Unified service for conversation management.
+ *
+ * @description A comprehensive service that combines real-time communication (LiveKit)
+ * with presence and request management (Firebase) for handling conversations.
+ * This service manages room lifecycle, messaging, typing indicators, call requests,
+ * and agent presence in a unified API.
+ *
+ * @example
+ * ```typescript
+ * const service = new ConversationService({
+ *   organizationId: 'org-123',
+ *   apiUrl: 'https://api.example.com',
+ *   firebaseConfig: { ... }
+ * });
+ *
+ * // Register user and create room
+ * await service.registerUser('user-123', 'secret');
+ * const room = await service.createRoom({
+ *   language: 'en',
+ *   timezone: 'America/New_York'
+ * });
+ *
+ * // Subscribe to messages
+ * service.subscribeMessages((messages) => {
+ *   console.log('New messages:', messages);
+ * });
+ * ```
+ */
+declare class ConversationService {
+    /** Message event listeners */
+    private listeners;
+    /** Typing indicator listeners */
+    private typingListeners;
+    /** Map for deduplicating transcription segments */
+    private transcriptionMap;
+    /** Base API URL */
+    private apiUrl;
+    /** Authentication service URL */
+    private authUrl?;
+    /** Organization identifier */
+    private organizationId;
+    /** LiveKit chat topic */
+    private channelTopic;
+    /** LiveKit transcription topic */
+    private transcriptionTopic;
+    /** LiveKit events topic */
+    private eventsTopic;
+    /** Message persistence mode */
+    private messagePersistence;
+    /** Abort controllers for cancellable requests */
+    private abortControllers;
+    /** Current authentication token */
+    private authToken;
+    /** Firebase API instance (optional) */
+    private firebaseApi?;
+    /** Firebase presence path */
+    private presencePath?;
+    /** Firebase calls path */
+    private callsPath?;
+    /** Active Firebase unsubscribers */
+    private firebaseUnsubscribers;
+    /** Set of seen request IDs for deduplication */
+    private seenRequestIds;
+    /** Map for content-based deduplication */
+    private lastSnapshotById;
+    /** Current LiveKit room instance */
+    room: Room;
+    /**
+     * Initializes a new instance of the ConversationService.
+     *
+     * @param {ConversationServiceOptions} options - Service configuration options.
+     */
+    constructor(options: ConversationServiceOptions);
+    /**
+     * Creates a new LiveKit Room instance with default settings.
+     *
+     * @private
+     * @returns {Room} New Room instance.
+     */
+    private createRoomInstance;
+    /**
+     * Ensures a room instance exists, creating one if necessary.
+     *
+     * @returns {Room} Current or new Room instance.
+     */
+    ensureRoom(): Room;
+    /**
+     * Initializes Firebase services for presence and request management.
+     *
+     * @private
+     * @param {FirebaseConfig} config - Firebase configuration.
+     */
+    private initializeFirebase;
+    /**
+     * Sets up LiveKit room event handlers for messaging and typing.
+     *
+     * @private
+     */
+    private initializeRoomHandlers;
+    /**
+     * Registers a user for conversation access.
+     *
+     * @async
+     * @param {string} externalId - External user identifier.
+     * @param {string} secret - User authentication secret.
+     * @param {Record<string, unknown>} [userData] - Additional user data.
+     * @param {Record<string, unknown>} [metadata] - User metadata.
+     * @returns {Promise<UserApiResponse>} User registration response with token.
+     */
+    registerUser(externalId: string, secret: string, userData?: Record<string, unknown>, metadata?: Record<string, unknown>): Promise<UserApiResponse>;
+    /**
+     * Registers an agent for handling conversations.
+     *
+     * @async
+     * @param {string} externalId - External agent identifier.
+     * @param {AgentData} agentData - Agent profile data.
+     * @returns {Promise<string>} Authentication token.
+     */
+    registerAgent(externalId: string, agentData: AgentData): Promise<string>;
+    /**
+     * Decodes a JWT token payload without verification.
+     *
+     * @private
+     * @param {string} token - JWT token string.
+     * @returns {{ username?: string; sub?: string; iat?: number; exp?: number } | null} Decoded payload or null if invalid.
+     */
+    private decodeJwtPayload;
+    /**
+     * Creates a new conversation room.
+     *
+     * @async
+     * @param {CreateRoomOptions} options - Room creation options.
+     * @param {Record<string, string>} [userData] - User attributes to set.
+     * @returns {Promise<Room>} Connected room instance.
+     */
+    createRoom(options: CreateRoomOptions, userData?: Record<string, string>): Promise<Room>;
+    /**
+     * Joins an existing conversation room.
+     *
+     * @async
+     * @param {string} roomId - Room identifier to join.
+     * @param {string} timezone - User's timezone.
+     * @param {string} language - Preferred language.
+     * @param {Record<string, unknown>} [attributes] - Additional attributes.
+     * @returns {Promise<Room>} Connected room instance.
+     */
+    joinRoom(roomId: string, timezone: string, language: string, attributes?: Record<string, unknown>): Promise<Room>;
+    /**
+     * Sets room metadata from API response.
+     *
+     * @private
+     * @param {RoomApiResponse} response - Room API response.
+     */
+    private setRoomMetadata;
+    /**
+     * Sets up handler for participant attribute changes.
+     *
+     * @private
+     */
+    private setupParticipantAttributesHandler;
+    /**
+     * Evaluates/rates the current room.
+     *
+     * @async
+     * @param {EvaluateRoomOptions} options - Evaluation options.
+     * @returns {Promise<void>}
+     */
+    evaluateRoom(options: EvaluateRoomOptions): Promise<void>;
+    /**
+     * Closes the current room on the server.
+     *
+     * @async
+     * @returns {Promise<void>}
+     */
+    closeRoom(): Promise<void>;
+    /**
+     * Disconnects from the current room.
+     *
+     * @async
+     * @returns {Promise<void>}
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Closes the room on server and disconnects locally.
+     *
+     * @async
+     * @returns {Promise<void>}
+     */
+    disconnectAndCloseRoom(): Promise<void>;
+    /**
+     * Marks a room as read.
+     *
+     * @async
+     * @param {string} roomId - Room identifier.
+     * @returns {Promise<void>}
+     */
+    readRoom(roomId: string): Promise<void>;
+    /**
+     * Fetches a list of rooms based on options.
+     *
+     * @async
+     * @param {GetRoomsOptions} options - Room listing options.
+     * @returns {Promise<RoomsApiResponse>} Paginated room list.
+     */
+    getRooms(options: GetRoomsOptions): Promise<RoomsApiResponse>;
+    /**
+     * Handles incoming messages from LiveKit.
+     *
+     * @private
+     */
+    private handleIncomingMessage;
+    /**
+     * Emits a message to all subscribed listeners.
+     *
+     * @private
+     * @param {ApiMessage} message - Message to emit.
+     */
+    private emitMessage;
+    /**
+     * Sends a message in the current room.
+     *
+     * @async
+     * @param {string} message - Message content.
+     * @param {Record<string, string>} [attributes] - Message attributes.
+     * @returns {Promise<void>}
+     */
+    sendMessage(message: string, attributes?: Record<string, string>): Promise<void>;
+    /**
+     * Persists a message to the server.
+     *
+     * @async
+     * @param {PersistMessageOptions} options - Persistence options.
+     * @returns {Promise<MessagesApiResponse>}
+     */
+    persistMessage(options: PersistMessageOptions): Promise<MessagesApiResponse>;
+    /**
+     * Fetches messages based on options.
+     *
+     * @async
+     * @param {GetMessagesOptions} options - Message fetching options.
+     * @returns {Promise<ApiMessage[]>} Array of messages.
+     */
+    getMessages(options: GetMessagesOptions): Promise<ApiMessage[]>;
+    /**
+     * Reports a message for moderation.
+     *
+     * @async
+     * @param {MessageReportOptions} options - Report options.
+     * @returns {Promise<void>}
+     */
+    sendMessageReport(options: MessageReportOptions): Promise<void>;
+    /**
+     * Deletes a message report.
+     *
+     * @async
+     * @param {MessageReportOptions} options - Report options.
+     * @returns {Promise<void>}
+     */
+    deleteMessageReport(options: MessageReportOptions): Promise<void>;
+    /**
+     * Updates reactions on a message.
+     *
+     * @async
+     * @param {MessageReactionOptions} options - Reaction options.
+     * @returns {Promise<void>}
+     */
+    updateMessageReactions(options: MessageReactionOptions): Promise<void>;
+    /**
+     * Subscribes to incoming messages.
+     *
+     * @param {MessageListener<M>} callback - Message listener callback.
+     * @returns {() => void} Unsubscribe function.
+     */
+    subscribeMessages<M extends ApiMessage = ApiMessage>(callback: MessageListener<M>): () => void;
+    /**
+     * Handles data received events for typing indicators.
+     *
+     * @private
+     */
+    private handleDataReceived;
+    /**
+     * Emits a typing indicator to all listeners.
+     *
+     * @private
+     * @param {TypingIndicator} indicator - Typing indicator data.
+     */
+    private emitTypingIndicator;
+    /**
+     * Sends a typing indicator to other participants.
+     *
+     * @async
+     * @param {boolean} isTyping - Whether the user is currently typing.
+     * @returns {Promise<void>}
+     */
+    sendTypingIndicator(isTyping: boolean): Promise<void>;
+    /**
+     * Subscribes to typing indicators from other participants.
+     *
+     * @param {TypingListener} listener - Typing indicator listener.
+     * @returns {() => void} Unsubscribe function.
+     */
+    subscribeTypingIndicators(listener: TypingListener): () => void;
+    /**
+     * Unsubscribes a typing indicator listener.
+     *
+     * @param {TypingListener} listener - Listener to remove.
+     */
+    unsubscribeTypingIndicators(listener: TypingListener): void;
+    /**
+     * Sends a contextual event to the room.
+     *
+     * @async
+     * @param {ContextualEvent} event - Event to send.
+     * @returns {Promise<void>}
+     */
+    sendContextualEvent(event: ContextualEvent): Promise<void>;
+    /**
+     * Requests a new room (call transfer).
+     *
+     * @async
+     * @param {RequestNewRoomOptions} options - Request options.
+     * @returns {Promise<RoomApiResponse>} New room details.
+     */
+    requestNewRoom(options: RequestNewRoomOptions): Promise<RoomApiResponse>;
+    /**
+     * Confirms an active room request.
+     *
+     * @async
+     * @param {string} roomId - Room identifier.
+     * @returns {Promise<{ success: boolean; message: string; roomId: string }>}
+     */
+    confirmRoomRequest(roomId: string): Promise<{
+        success: boolean;
+        message: string;
+        roomId: string;
+    }>;
+    /**
+     * Cancels an active room request.
+     *
+     * @async
+     * @param {string} roomId - Room identifier.
+     * @returns {Promise<{ success: boolean; message: string; roomId: string }>}
+     */
+    cancelRoomRequest(roomId: string): Promise<{
+        success: boolean;
+        message: string;
+        roomId: string;
+    }>;
+    /**
+     * Finishes an active call.
+     *
+     * @async
+     * @returns {Promise<void>}
+     */
+    finishCall(): Promise<void>;
+    /**
+     * Checks if Firebase is initialized.
+     *
+     * @returns {boolean} True if Firebase features are available.
+     */
+    isFirebaseEnabled(): boolean;
+    /**
+     * Gets Firebase API and paths, throwing if not initialized.
+     *
+     * @private
+     * @throws {Error} If Firebase is not initialized.
+     * @returns {{ api: FirebaseApi; presencePath: string; callsPath: string }}
+     */
+    private getFirebase;
+    /**
+     * Gets the presence path for an agent.
+     *
+     * @private
+     * @param {string} agentId - Agent identifier.
+     * @returns {string} Firebase path.
+     */
+    private buildAgentPresencePath;
+    /**
+     * Subscribes to presence changes for all agents.
+     *
+     * @param {(agentId: string, data: object | null) => void} callback - Change handler.
+     * @returns {() => void} Unsubscribe function.
+     */
+    onPresenceChange(callback: (agentId: string, data: object | null) => void): () => void;
+    /**
+     * Subscribes to presence changes for a specific agent.
+     *
+     * @param {string} agentId - Agent identifier.
+     * @param {(agentId: string, data: object | null) => void} callback - Change handler.
+     * @returns {() => void} Unsubscribe function.
+     */
+    onPresenceAgentChange(agentId: string, callback: (agentId: string, data: object | null) => void): () => void;
+    /**
+     * Creates a new call request via API.
+     *
+     * @async
+     * @param {Omit<CallRequest, "status" | "createdAt">} requestData - Request data.
+     * @returns {Promise<string>} Request identifier.
+     */
+    createCallRequest(requestData: Omit<CallRequest, "status" | "createdAt" | "id">): Promise<string>;
+    /**
+     * Subscribes to new call requests.
+     *
+     * @param {CallRequestListener} callback - Request handler.
+     * @returns {() => void} Unsubscribe function.
+     */
+    onNewCallRequest(callback: CallRequestListener): () => void;
+    /**
+     * Subscribes to call request changes.
+     *
+     * @param {CallRequestListener} callback - Change handler.
+     * @returns {() => void} Unsubscribe function.
+     */
+    onCallRequestChange(callback: CallRequestListener): () => void;
+    /**
+     * Subscribes to call request removals.
+     *
+     * @param {(id: string) => void} callback - Removal handler.
+     * @returns {() => void} Unsubscribe function.
+     */
+    onCallRequestRemoved(callback: (id: string) => void): () => void;
+    /**
+     * Accepts a call request.
+     *
+     * @async
+     * @param {string} requestId - Request identifier.
+     * @returns {Promise<void>}
+     */
+    acceptCallRequest(requestId: string): Promise<void>;
+    /**
+     * Cancels a call request via API.
+     *
+     * @async
+     * @param {string} requestId - Request identifier.
+     * @returns {Promise<void>}
+     */
+    cancelCallRequest(requestId: string): Promise<void>;
+    /**
+     * Cancels onDisconnect behavior for a request.
+     *
+     * @async
+     * @param {string} requestId - Request identifier.
+     * @returns {Promise<void>}
+     */
+    cancelOnDisconnect(requestId: string): Promise<void>;
+    /**
+     * Subscribes to pending call requests with deduplication.
+     *
+     * @param {CallRequestListener} callback - Request handler.
+     * @param {{ resetSeen?: boolean }} [options] - Subscription options.
+     * @returns {() => void} Unsubscribe function.
+     */
+    subscribePendingRequests(callback: CallRequestListener, options?: {
+        resetSeen?: boolean;
+    }): () => void;
+    /**
+     * Subscribes to request changes with content deduplication.
+     *
+     * @param {CallRequestListener} callback - Change handler.
+     * @returns {() => void} Unsubscribe function.
+     */
+    subscribeRequestChanges(callback: CallRequestListener): () => void;
+    /**
+     * Attempts to safely accept a request if still pending.
+     *
+     * @async
+     * @param {string} requestId - Request identifier.
+     * @returns {Promise<boolean>} True if successfully accepted.
+     */
+    tryAcceptRequest(requestId: string): Promise<boolean>;
+    /**
+     * Subscribes to room sync notifications.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {(data: RoomSyncData | null) => void} callback - Sync handler.
+     * @returns {() => void} Unsubscribe function.
+     */
+    onRoomSync(roomId: string, callback: (data: RoomSyncData | null) => void): () => void;
+    /**
+     * Clears the sync flag for a room.
+     *
+     * @async
+     * @param {string} roomId - Room identifier.
+     * @param {string} [reason] - Reason for clearing.
+     * @returns {Promise<void>}
+     */
+    clearRoomSync(roomId: string, reason?: string): Promise<void>;
+    /**
+     * Subscribes to new room request notifications.
+     *
+     * @param {string} roomId - Origin room identifier.
+     * @param {(data: NewRoomRequestData | null) => void} callback - Request handler.
+     * @returns {() => void} Unsubscribe function.
+     */
+    onNewRoomRequest(roomId: string, callback: (data: NewRoomRequestData | null) => void): () => void;
+    /**
+     * Removes all Firebase listeners.
+     */
+    unsubscribeAllFirebase(): void;
+    /**
+     * Cleans up all resources and connections.
+     *
+     * @async
+     * @returns {Promise<void>}
+     */
+    destroy(): Promise<void>;
+}
+
+export { ConversationService, Room };

package/services/conversation/conversation.service.js

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+import{Session as m}from"@onlive.ai/tracker";import{Room as G,RoomEvent as y}from"livekit-client";import{initializeApp as z}from"firebase/app";import{query as g,endAt as q,equalTo as U,get as R,getDatabase as $,limitToFirst as j,limitToLast as D,onChildAdded as f,onChildChanged as v,onChildRemoved as T,onDisconnect as C,onValue as I,orderByChild as N,orderByKey as L,orderByValue as F,push as E,ref as B,remove as J,runTransaction as X,set as A,startAt as Q,update as K}from"firebase/database";var p=class{constructor(e){this.onChildChanged=(e,t)=>v(this.ref(e),i=>t(i.key||"",i.val(),i));this.onChildRemoved=(e,t)=>T(this.ref(e),i=>t(i.key||"",i.val(),i));this.onChildChangedQuery=(e,t)=>v(e,i=>t(i.key||"",i.val(),i));this.onChildRemovedQuery=(e,t)=>T(e,i=>t(i.key||"",i.val(),i));let t=z(e.config);this.db=$(t)}ref(e){return B(this.db,e)}async getOnce(e){let t=await R(this.ref(e));return t.exists()?t.val():null}async getOnceQuery(e){let t=await R(e),i=[];return t.exists()&&t.forEach(s=>{i.push({key:s.key||"",value:s.val()})}),i}onValue(e,t){return I(this.ref(e),i=>t(i.key??"",i.val(),i),i=>console.error("onValue error",i))}onValueQuery(e,t){return I(e,i=>t(i.key??"",i.val(),i),i=>console.error("onValueQuery error",i))}onChildAdded(e,t){return f(this.ref(e),i=>t(i.key||"",i.val(),i),i=>console.error("onChildAdded error",i))}onChildAddedQuery(e,t){return f(e,i=>t(i.key||"",i.val(),i),i=>console.error("onChildAddedQuery error",i))}write(e,t){return A(this.ref(e),t)}update(e,t){return K(this.ref(e),t)}remove(e){return J(this.ref(e))}async push(e,t){let i=E(this.ref(e));return await A(i,t),i.key}onDisconnectUpdate(e,t){return C(this.ref(e)).update(t)}cancelOnDisconnect(e){return C(this.ref(e)).cancel()}transaction(e,t){return X(this.ref(e),i=>t(i))}query(e,t={}){let i=this.ref(e);return t.orderBy==="child"&&t.childKey&&(i=g(i,N(t.childKey))),t.orderBy==="key"&&(i=g(i,L())),t.orderBy==="value"&&(i=g(i,F())),t.startAt!=null&&(i=g(i,Q(t.startAt))),t.endAt!=null&&(i=g(i,q(t.endAt))),t.equalTo!=null&&(i=g(i,U(t.equalTo))),t.limitFirst!=null&&(i=g(i,j(t.limitFirst))),t.limitLast!=null&&(i=g(i,D(t.limitLast))),i}};var a=async(o,e)=>{let t=await fetch(o,e);if(!t.ok){let i=await t.json().catch(()=>({}));throw new Error(JSON.stringify({status:t.status,statusText:t.statusText,...i}))}return t&&t.json()};var P=o=>{let e="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789",t="";for(let i=0;i<o;i++)t+=e.charAt(Math.floor(Math.random()*e.length));return t};import{Generator as _,Session as l}from"@onlive.ai/tracker";var d="chatbot",u=class o{static hasSession(){return!!l.getCookie(d)}static getSession(e={role:"guest",regenerate:!1}){e.regenerate&&(l.id=_.uuid(),l.deleteCookie(d));let t=l.getCookie(d);return t&&o.isValidSession(t,e.role)?t:o.createSession(e.role)}static createSession(e){let t={externalId:e==="agent"?String(o.getUserId()||l.id):l.id,secret:P(16),createdAt:new Date().toISOString()};return l.setCookie(d,t,3600*24*365),t}static isValidSession(e,t){if(t==="guest")return!0;let i=o.getUserId();return!!(i&&String(i)===e.externalId)}static getUserId(){return l.getCookie("user-id",{objectKey:"userId",storageKey:"user",storageType:"localStorage",ttl:3600*24*365,preserveData:!0})}static updateSessionWithRegistrationData(e){let t=l.getCookie(d);if(t||(t=o.createSession("guest")),t){let i={...t,registrationData:e};l.setCookie(d,i,3600*24*365)}}static hasRegistrationData(){return!!l.getCookie(d)?.registrationData}static async getAgentInfo(e){return fetch(`${e}/api/v1/auth/user-info`,{credentials:"include"}).then(t=>t.json())}static getRegistrationData(){return l.getCookie(d)?.registrationData}};var O="lk.chat",S="lk.transcription",w="lk.events",h="typing-indicator";var b=class extends G{},x=class{constructor(e){this.listeners=new Set;this.typingListeners=new Set;this.transcriptionMap=new Map;this.abortControllers={register:new AbortController,createRoom:new AbortController,closeRoom:new AbortController,evaluateRoom:new AbortController,persistMessage:new AbortController,sendMessageReport:new AbortController,deleteMessageReport:new AbortController,updateMessageReactions:new AbortController,getRooms:new AbortController};this.authToken=null;this.firebaseUnsubscribers={};this.seenRequestIds=new Set;this.lastSnapshotById=new Map;this.handleIncomingMessage=async(e,t)=>{let i=e?.info?.id,s=e.info?.attributes?.["lk.segment_id"];s&&(this.transcriptionMap.has(s)?i=this.transcriptionMap.get(s)||"":this.transcriptionMap.set(s,i));let n=t?.identity?this.room.getParticipantByIdentity(t.identity):void 0,r="";for await(let c of e)r+=c,this.emitMessage({id:i,timestamp:Date.now(),message:r,assets:JSON.parse(e.info?.attributes?.assets||"[]"),from:n});this.messagePersistence==="client"&&this.persistMessage({roomId:this.room.id,content:r,externalId:i,identity:n?.identity,kind:n?.kind})};this.emitMessage=e=>{for(let t of this.listeners)t([e])};this.handleDataReceived=(e,t,i,s)=>{if(s===h)try{let n=JSON.parse(new TextDecoder().decode(e));if(n.type==="typing"&&n.participantId!==this.room.localParticipant.identity){let r={type:"typing",isTyping:n.isTyping,timestamp:n.timestamp,participantId:n.participantId};this.emitTypingIndicator(r)}}catch(n){console.warn("Failed to parse typing indicator:",n)}};this.emitTypingIndicator=e=>{for(let t of this.typingListeners)t(e)};this.apiUrl=e.apiUrl,this.authUrl=e.authUrl,this.organizationId=e.organizationId,this.channelTopic=e.channelTopic||O,this.transcriptionTopic=e.transcriptionTopic||S,this.eventsTopic=e.eventsTopic||w,this.messagePersistence=e.messagePersistence||"disabled",this.room=this.createRoomInstance(),e.firebaseConfig&&this.initializeFirebase(e.firebaseConfig)}createRoomInstance(){return new b({adaptiveStream:!0,dynacast:!0})}ensureRoom(){return this.room||(this.room=this.createRoomInstance()),this.room}initializeFirebase(e){this.firebaseApi=new p({config:e}),this.presencePath=`orgs/${this.organizationId}/presence`,this.callsPath=`orgs/${this.organizationId}/calls`}initializeRoomHandlers(){try{this.room.unregisterTextStreamHandler(this.channelTopic),this.room.unregisterTextStreamHandler(this.transcriptionTopic)}catch{}this.room.off(y.DataReceived,this.handleDataReceived),this.room.registerTextStreamHandler(this.channelTopic,this.handleIncomingMessage),this.room.registerTextStreamHandler(this.transcriptionTopic,this.handleIncomingMessage),this.room.on(y.DataReceived,this.handleDataReceived)}async registerUser(e,t,i,s){let n=await a(`${this.apiUrl}/users/register`,{method:"POST",body:JSON.stringify({externalId:e,secret:t,...i,metadata:s}),headers:{"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},signal:this.abortControllers.register.signal});return this.authToken=n.token,n}async registerAgent(e,t){let i=m.getCookie("livekit-agent-token");if(i){if(this.decodeJwtPayload(i)?.username===t.name)return this.authToken=i,i;m.deleteCookie("livekit-agent-token")}let s=await a(`${this.authUrl}/admins/register`,{method:"POST",body:JSON.stringify({externalId:e,name:t.name,email:t.email,avatar:t.avatar}),headers:{"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},credentials:"include",signal:this.abortControllers.register.signal});return m.setCookie("livekit-agent-token",s.token,1440*60),this.authToken=s.token,s.token}decodeJwtPayload(e){try{let t=e.split(".");if(t.length!==3)return null;let i=t[1],s=atob(i.replace(/-/g,"+").replace(/_/g,"/"));return JSON.parse(s)}catch{return null}}async createRoom(e,t={}){this.room=this.ensureRoom();let i=await a(`${this.apiUrl}/rooms`,{method:"POST",body:JSON.stringify(e),headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},signal:this.abortControllers.createRoom.signal});return this.setRoomMetadata(i),this.setupParticipantAttributesHandler(),this.room.connect(i.wsURL,i.token).then(()=>{this.room.localParticipant.setAttributes(t)}),this.initializeRoomHandlers(),this.room}async joinRoom(e,t,i,s){let n=await a(`${this.apiUrl}/rooms/${e}/join`,{method:"POST",body:JSON.stringify({timezone:t,language:i,...s??{}}),headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},signal:this.abortControllers.createRoom.signal});return this.setRoomMetadata(n),this.setupParticipantAttributesHandler(),await this.room.connect(n.wsURL,n.token),this.initializeRoomHandlers(),this.room}setRoomMetadata(e){this.room.id=e.id,this.room.groupId=e.groupId,this.room.createdAt=e.createdAt,this.room.connectedAt=new Date().toISOString()}setupParticipantAttributesHandler(){this.room.on(y.ParticipantAttributesChanged,e=>{e.identity===this.room.localParticipant.identity&&u.updateSessionWithRegistrationData(e.attributes)})}async evaluateRoom(e){let t=e.roomId||this.room?.id;if(!t)throw new Error("Room ID is required for evaluation");return a(`${this.apiUrl}/rooms/${t}/evaluate`,{method:"POST",body:JSON.stringify({rating:e.rating,comment:e.comment}),headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},signal:this.abortControllers.evaluateRoom.signal})}async closeRoom(){if(this.room)return a(`${this.apiUrl}/rooms/${this.room.id}/close`,{method:"POST",headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},signal:this.abortControllers.closeRoom.signal})}async disconnect(){this.room&&(this.room.removeAllListeners(),await this.room.disconnect(),this.room=null)}async disconnectAndCloseRoom(){await this.closeRoom(),await this.disconnect()}async readRoom(e){return a(`${this.apiUrl}/rooms/${e}/read`,{method:"POST",headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},signal:this.abortControllers.persistMessage.signal})}async getRooms(e){let t=new URLSearchParams;return e.page&&t.append("page",e.page.toString()),e.limit&&t.append("limit",e.limit.toString()),e.offset&&t.append("offset",e.offset.toString()),e.orderBy&&t.append("orderBy",e.orderBy),e.orderDir&&t.append("orderDir",e.orderDir),e.ids?.length&&t.append("ids",e.ids.join(",")),e.with?.length&&t.append("with",e.with.join(",")),e.count?.length&&t.append("count",e.count.join(",")),e.latestOnly&&t.append("latestOnly",e.latestOnly.toString()),e.includeUnread&&t.append("includeUnread",e.includeUnread.toString()),e.roomStatus&&t.append("roomStatus",e.roomStatus),e.archived&&t.append("archived",e.archived.toString()),e.participantIds?.length&&t.append("participantIds",e.participantIds.join(",")),e.participantExternalIds?.length&&t.append("participantExternalIds",e.participantExternalIds.join(",")),e.groupId&&t.append("groupId",e.groupId),e.hasMessages!==void 0&&t.append("hasMessages",e.hasMessages.toString()),a(`${this.authUrl}/rooms?${t}`,{method:"GET",headers:{"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},credentials:"include",signal:this.abortControllers.getRooms.signal})}async sendMessage(e,t){let i=await this.room.localParticipant.sendText(e,{topic:this.channelTopic,attributes:t});this.emitMessage({id:i.id,timestamp:Date.now(),message:e,assets:JSON.parse(t?.assets||"[]"),from:this.room.localParticipant}),this.messagePersistence==="client"&&this.persistMessage({roomId:this.room.id,content:e,externalId:i.id,identity:this.room.localParticipant?.identity,kind:this.room.localParticipant?.kind})}async persistMessage(e){return a(`${this.apiUrl}/messages/create`,{method:"POST",body:JSON.stringify(e),headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},signal:this.abortControllers.persistMessage.signal})}async getMessages(e){let t=new URLSearchParams;return e.limit&&t.append("limit",e.limit.toString()),e.with&&t.append("with",e.with.join(",")),(await a(`${this.apiUrl}/messages/search${t.size?`?${t.toString()}`:""}`,{method:"POST",body:JSON.stringify(e),headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},signal:this.abortControllers.createRoom.signal})).items}async sendMessageReport(e){try{return a(`${this.apiUrl}/messages/${e.messageId}/report`,{method:"POST",headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},signal:this.abortControllers.sendMessageReport.signal})}catch(t){console.error("Error sending message report:",t)}}async deleteMessageReport(e){try{return a(`${this.apiUrl}/messages/${e.messageId}/report`,{method:"DELETE",headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},signal:this.abortControllers.deleteMessageReport.signal})}catch(t){console.error("Error deleting message report:",t)}}async updateMessageReactions(e){try{return a(`${this.apiUrl}/messages/${e.messageId}/reactions`,{method:"PATCH",body:JSON.stringify({add:e.add||[],remove:e.remove||[]}),headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},signal:this.abortControllers.updateMessageReactions.signal})}catch(t){console.error("Error updating message reactions:",t)}}subscribeMessages(e){return this.listeners.add(e),()=>{this.listeners.delete(e)}}async sendTypingIndicator(e){try{let t=new TextEncoder().encode(JSON.stringify({type:"typing",isTyping:e,timestamp:Date.now(),participantId:this.room.localParticipant.identity}));await this.room.localParticipant.publishData(t,{reliable:!1,topic:h})}catch(t){console.warn("Failed to send typing indicator:",t)}}subscribeTypingIndicators(e){return this.typingListeners.add(e),()=>{this.typingListeners.delete(e)}}unsubscribeTypingIndicators(e){this.typingListeners.delete(e)}async sendContextualEvent(e){try{let t=JSON.stringify(e);await this.room.localParticipant.sendText(t,{topic:this.eventsTopic})}catch(t){console.warn("Failed to send event:",t)}}async requestNewRoom(e){return a(`${this.apiUrl}/rooms/request-new`,{method:"POST",body:JSON.stringify(e),headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"}})}async confirmRoomRequest(e){return a(`${this.apiUrl}/rooms/confirm-call`,{method:"POST",body:JSON.stringify({roomId:e}),headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"}})}async cancelRoomRequest(e){return a(`${this.apiUrl}/rooms/cancel-call`,{method:"POST",body:JSON.stringify({roomId:e}),headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"}})}async finishCall(){return a(`${this.apiUrl}/rooms/finish-call`,{method:"POST",body:JSON.stringify({roomId:this.room.id}),headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"}})}isFirebaseEnabled(){return!!(this.firebaseApi&&this.presencePath&&this.callsPath)}getFirebase(){if(!this.firebaseApi||!this.presencePath||!this.callsPath)throw new Error("Firebase is not initialized. Provide firebaseConfig in constructor.");return{api:this.firebaseApi,presencePath:this.presencePath,callsPath:this.callsPath}}buildAgentPresencePath(e){return`${this.presencePath}/${e}`}onPresenceChange(e){let{api:t,presencePath:i}=this.getFirebase();return t.onChildChanged(i,(s,n)=>e(s,n))}onPresenceAgentChange(e,t){let{api:i}=this.getFirebase();return i.onValue(this.buildAgentPresencePath(e),(s,n)=>t(s,n))}async createCallRequest(e){let{api:t,callsPath:i}=this.getFirebase(),n=(await a(`${this.apiUrl}/rooms/call-request`,{method:"POST",headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},body:JSON.stringify(e)})).id;return t.onDisconnectUpdate(`${i}/${n}`,{status:"disconnected"}),n}onNewCallRequest(e){let{api:t,callsPath:i}=this.getFirebase();return t.onChildAdded(i,(s,n)=>e(s,{...n,id:s}))}onCallRequestChange(e){let{api:t,callsPath:i}=this.getFirebase();return t.onChildChanged(i,(s,n)=>e(s,{...n,id:s}))}onCallRequestRemoved(e){let{api:t,callsPath:i}=this.getFirebase();return t.onChildRemoved(i,s=>e(s))}async acceptCallRequest(e){let{api:t,callsPath:i}=this.getFirebase();return await t.cancelOnDisconnect(`${i}/${e}`),t.update(`${i}/${e}`,{status:"accepted"})}async cancelCallRequest(e){let{api:t,callsPath:i}=this.getFirebase();await t.cancelOnDisconnect(`${i}/${e}`),await a(`${this.apiUrl}/rooms/call-request/cancel`,{method:"POST",headers:{Authorization:`Bearer ${this.authToken}`,"X-Onlive-Organization-Id":this.organizationId,"Content-Type":"application/json"},body:JSON.stringify({callId:e})})}async cancelOnDisconnect(e){let{api:t,callsPath:i}=this.getFirebase();await t.cancelOnDisconnect(`${i}/${e}`)}subscribePendingRequests(e,t={}){let{api:i,callsPath:s}=this.getFirebase();t.resetSeen&&this.seenRequestIds.clear(),this.firebaseUnsubscribers["pending-requests"]?.();let n=i.query(s,{orderBy:"child",childKey:"status",equalTo:"pending"}),r=i.onChildAddedQuery(n,(c,k)=>{if(!c||this.seenRequestIds.has(c))return;let M={...k,id:c};this.seenRequestIds.add(c),e(c,M)});return this.firebaseUnsubscribers["pending-requests"]=r,()=>{r?.(),delete this.firebaseUnsubscribers["pending-requests"]}}subscribeRequestChanges(e){let{api:t,callsPath:i}=this.getFirebase();this.firebaseUnsubscribers["request-changes"]?.();let s=t.onChildChanged(i,(n,r)=>{if(!n)return;let c=JSON.stringify(r);this.lastSnapshotById.get(n)!==c&&(this.lastSnapshotById.set(n,c),e(n,{...r,id:n}))});return this.firebaseUnsubscribers["request-changes"]=s,()=>{s?.(),delete this.firebaseUnsubscribers["request-changes"]}}async tryAcceptRequest(e){let{api:t,callsPath:i}=this.getFirebase(),s=`${i}/${e}`;return await t.transaction(s,r=>r&&(r.status==="pending"?{...r,status:"accepted"}:r)),(await t.getOnce(s))?.status==="accepted"}onRoomSync(e,t){let{api:i}=this.getFirebase(),s=`orgs/${this.organizationId}/rooms/${e}/sync`;return i.onValue(s,(n,r)=>{t(r)})}async clearRoomSync(e,t){let{api:i}=this.getFirebase(),s=`orgs/${this.organizationId}/rooms/${e}/sync`;await i.write(s,{needsSync:!1,reason:t||null,timestamp:Date.now()})}onNewRoomRequest(e,t){let{api:i}=this.getFirebase(),s=`orgs/${this.organizationId}/rooms/${e}/call`;return i.onValue(s,(n,r)=>{t(r)})}unsubscribeAllFirebase(){Object.values(this.firebaseUnsubscribers).forEach(e=>e?.()),this.firebaseUnsubscribers={}}async destroy(){this.unsubscribeAllFirebase(),this.listeners.clear(),this.typingListeners.clear(),this.transcriptionMap.clear(),this.seenRequestIds.clear(),this.lastSnapshotById.clear(),Object.values(this.abortControllers).forEach(e=>e.abort()),await this.disconnect()}};export{x as ConversationService,b as Room};

package/services/conversation/conversation.types.cjs

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+"use strict";var r=Object.defineProperty;var o=Object.getOwnPropertyDescriptor;var a=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var p=(e,t)=>{for(var s in t)r(e,s,{get:t[s],enumerable:!0})},d=(e,t,s,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of a(t))!g.call(e,n)&&n!==s&&r(e,n,{get:()=>t[n],enumerable:!(i=o(t,n))||i.enumerable});return e};var m=e=>d(r({},"__esModule",{value:!0}),e);var y={};p(y,{CHAT_TOPIC:()=>c,EVENTS_TOPIC:()=>l,TRANSCRIPTION_TOPIC:()=>u,TYPING_INDICATOR_TOPIC:()=>x});module.exports=m(y);var c="lk.chat",u="lk.transcription",l="lk.events",x="typing-indicator";0&&(module.exports={CHAT_TOPIC,EVENTS_TOPIC,TRANSCRIPTION_TOPIC,TYPING_INDICATOR_TOPIC});