@onlive.ai/common-121 0.2.163 → 0.2.184

package/services/conversation/mock/events.d.cts

@@ -0,0 +1,253 @@
+/*! @onlive.ai/common-121 v0.2.184 | © 2026 Onlive.ai */
+import { MockEventType, MockEventListener, MockEvent, MockRoomState, MockConnectionState, MockParticipantState, MockTrackState, MockMessageState, MockAgentState, MockAgentMessage, MockError } from './types.cjs';
+
+/**
+ * @summary Event emitter for mock LiveKit events.
+ *
+ * @description Provides an event system that mimics LiveKit's event handling,
+ * allowing subscription to various room, participant, and track events.
+ */
+
+/**
+ * @summary Event emitter for mock LiveKit service.
+ *
+ * @description Manages event subscriptions and emissions for the mock service.
+ * Supports both typed event listeners and wildcard listeners.
+ */
+declare class MockEventEmitter {
+    /** Map of event type to set of listeners */
+    private listeners;
+    /** Set of wildcard listeners that receive all events */
+    private wildcardListeners;
+    /** History of all emitted events for testing/debugging */
+    private eventHistory;
+    /** Maximum number of events to keep in history */
+    private maxHistorySize;
+    /** Whether to store events in history */
+    private recordHistory;
+    /**
+     * Sets the maximum history size.
+     *
+     * @param {number} size - Maximum number of events to keep.
+     */
+    setMaxHistorySize(size: number): void;
+    /**
+     * Enables or disables event history recording.
+     *
+     * @param {boolean} enabled - Whether to record history.
+     */
+    setRecordHistory(enabled: boolean): void;
+    /**
+     * Subscribes to a specific event type.
+     *
+     * @param {T} type - Event type to listen for.
+     * @param {MockEventListener} listener - Callback function.
+     * @returns {() => void} Unsubscribe function.
+     */
+    on<T extends MockEventType>(type: T, listener: MockEventListener): () => void;
+    /**
+     * Subscribes to a specific event type for a single emission.
+     *
+     * @param {T} type - Event type to listen for.
+     * @param {MockEventListener} listener - Callback function.
+     * @returns {() => void} Unsubscribe function.
+     */
+    once<T extends MockEventType>(type: T, listener: MockEventListener): () => void;
+    /**
+     * Unsubscribes from a specific event type.
+     *
+     * @param {T} type - Event type.
+     * @param {MockEventListener} listener - Listener to remove.
+     */
+    off<T extends MockEventType>(type: T, listener: MockEventListener): void;
+    /**
+     * Subscribes to all events.
+     *
+     * @param {MockEventListener} listener - Callback function.
+     * @returns {() => void} Unsubscribe function.
+     */
+    onAny(listener: MockEventListener): () => void;
+    /**
+     * Removes a wildcard listener.
+     *
+     * @param {MockEventListener} listener - Listener to remove.
+     */
+    offAny(listener: MockEventListener): void;
+    /**
+     * Removes all listeners for a specific event type or all events.
+     *
+     * @param {MockEventType} [type] - Event type (optional, removes all if not specified).
+     */
+    removeAllListeners(type?: MockEventType): void;
+    /**
+     * Emits an event to all relevant listeners.
+     *
+     * @param {MockEvent} event - Event to emit.
+     */
+    emit(event: MockEvent): void;
+    /**
+     * Trims event history to maximum size.
+     */
+    private trimHistory;
+    /**
+     * Emits a room created event.
+     *
+     * @param {MockRoomState} room - Created room.
+     */
+    emitRoomCreated(room: MockRoomState): void;
+    /**
+     * Emits a room ended event.
+     *
+     * @param {string} roomId - Room identifier.
+     */
+    emitRoomEnded(roomId: string): void;
+    /**
+     * Emits a room connection state changed event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {MockConnectionState} state - New state.
+     * @param {MockConnectionState} previousState - Previous state.
+     */
+    emitRoomConnectionStateChanged(roomId: string, state: MockConnectionState, previousState: MockConnectionState): void;
+    /**
+     * Emits a participant joined event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {MockParticipantState} participant - Joined participant.
+     */
+    emitParticipantJoined(roomId: string, participant: MockParticipantState): void;
+    /**
+     * Emits a participant left event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     */
+    emitParticipantLeft(roomId: string, participantIdentity: string): void;
+    /**
+     * Emits a participant attributes changed event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     * @param {Record<string, string>} attributes - New attributes.
+     * @param {Record<string, string>} previousAttributes - Previous attributes.
+     */
+    emitParticipantAttributesChanged(roomId: string, participantIdentity: string, attributes: Record<string, string>, previousAttributes: Record<string, string>): void;
+    /**
+     * Emits a track published event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     * @param {MockTrackState} track - Published track.
+     */
+    emitTrackPublished(roomId: string, participantIdentity: string, track: MockTrackState): void;
+    /**
+     * Emits a track unpublished event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     * @param {string} trackId - Track identifier.
+     */
+    emitTrackUnpublished(roomId: string, participantIdentity: string, trackId: string): void;
+    /**
+     * Emits a track muted event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} trackId - Track identifier.
+     */
+    emitTrackMuted(roomId: string, trackId: string): void;
+    /**
+     * Emits a track unmuted event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} trackId - Track identifier.
+     */
+    emitTrackUnmuted(roomId: string, trackId: string): void;
+    /**
+     * Emits a message received event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {MockMessageState} message - Received message.
+     */
+    emitMessageReceived(roomId: string, message: MockMessageState): void;
+    /**
+     * Emits a message sent event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {MockMessageState} message - Sent message.
+     */
+    emitMessageSent(roomId: string, message: MockMessageState): void;
+    /**
+     * Emits a typing indicator event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     * @param {boolean} isTyping - Whether typing.
+     */
+    emitTypingIndicator(roomId: string, participantIdentity: string, isTyping: boolean): void;
+    /**
+     * Emits an agent started event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {MockAgentState} agent - Started agent.
+     */
+    emitAgentStarted(roomId: string, agent: MockAgentState): void;
+    /**
+     * Emits an agent stopped event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} agentId - Agent identifier.
+     */
+    emitAgentStopped(roomId: string, agentId: string): void;
+    /**
+     * Emits an agent message event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} agentId - Agent identifier.
+     * @param {MockAgentMessage} message - Agent message.
+     */
+    emitAgentMessage(roomId: string, agentId: string, message: MockAgentMessage): void;
+    /**
+     * Emits a data received event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     * @param {Uint8Array} data - Received data.
+     * @param {string} [topic] - Data topic.
+     */
+    emitDataReceived(roomId: string, participantIdentity: string, data: Uint8Array, topic?: string): void;
+    /**
+     * Emits an error event.
+     *
+     * @param {MockError} error - Error details.
+     * @param {string} [roomId] - Optional room identifier.
+     */
+    emitError(error: MockError, roomId?: string): void;
+    /**
+     * Gets the event history.
+     *
+     * @param {MockEventType} [filterType] - Optional filter by event type.
+     * @returns {MockEvent[]} Array of events.
+     */
+    getHistory(filterType?: MockEventType): MockEvent[];
+    /**
+     * Gets the last N events.
+     *
+     * @param {number} count - Number of events to get.
+     * @param {MockEventType} [filterType] - Optional filter by event type.
+     * @returns {MockEvent[]} Array of events.
+     */
+    getLastEvents(count: number, filterType?: MockEventType): MockEvent[];
+    /**
+     * Clears the event history.
+     */
+    clearHistory(): void;
+    /**
+     * Gets the count of listeners for a specific event type.
+     *
+     * @param {MockEventType} type - Event type.
+     * @returns {number} Number of listeners.
+     */
+    listenerCount(type: MockEventType): number;
+}
+
+export { MockEventEmitter };

package/services/conversation/mock/events.d.ts

@@ -0,0 +1,253 @@
+/*! @onlive.ai/common-121 v0.2.184 | © 2026 Onlive.ai */
+import { MockEventType, MockEventListener, MockEvent, MockRoomState, MockConnectionState, MockParticipantState, MockTrackState, MockMessageState, MockAgentState, MockAgentMessage, MockError } from './types.js';
+
+/**
+ * @summary Event emitter for mock LiveKit events.
+ *
+ * @description Provides an event system that mimics LiveKit's event handling,
+ * allowing subscription to various room, participant, and track events.
+ */
+
+/**
+ * @summary Event emitter for mock LiveKit service.
+ *
+ * @description Manages event subscriptions and emissions for the mock service.
+ * Supports both typed event listeners and wildcard listeners.
+ */
+declare class MockEventEmitter {
+    /** Map of event type to set of listeners */
+    private listeners;
+    /** Set of wildcard listeners that receive all events */
+    private wildcardListeners;
+    /** History of all emitted events for testing/debugging */
+    private eventHistory;
+    /** Maximum number of events to keep in history */
+    private maxHistorySize;
+    /** Whether to store events in history */
+    private recordHistory;
+    /**
+     * Sets the maximum history size.
+     *
+     * @param {number} size - Maximum number of events to keep.
+     */
+    setMaxHistorySize(size: number): void;
+    /**
+     * Enables or disables event history recording.
+     *
+     * @param {boolean} enabled - Whether to record history.
+     */
+    setRecordHistory(enabled: boolean): void;
+    /**
+     * Subscribes to a specific event type.
+     *
+     * @param {T} type - Event type to listen for.
+     * @param {MockEventListener} listener - Callback function.
+     * @returns {() => void} Unsubscribe function.
+     */
+    on<T extends MockEventType>(type: T, listener: MockEventListener): () => void;
+    /**
+     * Subscribes to a specific event type for a single emission.
+     *
+     * @param {T} type - Event type to listen for.
+     * @param {MockEventListener} listener - Callback function.
+     * @returns {() => void} Unsubscribe function.
+     */
+    once<T extends MockEventType>(type: T, listener: MockEventListener): () => void;
+    /**
+     * Unsubscribes from a specific event type.
+     *
+     * @param {T} type - Event type.
+     * @param {MockEventListener} listener - Listener to remove.
+     */
+    off<T extends MockEventType>(type: T, listener: MockEventListener): void;
+    /**
+     * Subscribes to all events.
+     *
+     * @param {MockEventListener} listener - Callback function.
+     * @returns {() => void} Unsubscribe function.
+     */
+    onAny(listener: MockEventListener): () => void;
+    /**
+     * Removes a wildcard listener.
+     *
+     * @param {MockEventListener} listener - Listener to remove.
+     */
+    offAny(listener: MockEventListener): void;
+    /**
+     * Removes all listeners for a specific event type or all events.
+     *
+     * @param {MockEventType} [type] - Event type (optional, removes all if not specified).
+     */
+    removeAllListeners(type?: MockEventType): void;
+    /**
+     * Emits an event to all relevant listeners.
+     *
+     * @param {MockEvent} event - Event to emit.
+     */
+    emit(event: MockEvent): void;
+    /**
+     * Trims event history to maximum size.
+     */
+    private trimHistory;
+    /**
+     * Emits a room created event.
+     *
+     * @param {MockRoomState} room - Created room.
+     */
+    emitRoomCreated(room: MockRoomState): void;
+    /**
+     * Emits a room ended event.
+     *
+     * @param {string} roomId - Room identifier.
+     */
+    emitRoomEnded(roomId: string): void;
+    /**
+     * Emits a room connection state changed event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {MockConnectionState} state - New state.
+     * @param {MockConnectionState} previousState - Previous state.
+     */
+    emitRoomConnectionStateChanged(roomId: string, state: MockConnectionState, previousState: MockConnectionState): void;
+    /**
+     * Emits a participant joined event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {MockParticipantState} participant - Joined participant.
+     */
+    emitParticipantJoined(roomId: string, participant: MockParticipantState): void;
+    /**
+     * Emits a participant left event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     */
+    emitParticipantLeft(roomId: string, participantIdentity: string): void;
+    /**
+     * Emits a participant attributes changed event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     * @param {Record<string, string>} attributes - New attributes.
+     * @param {Record<string, string>} previousAttributes - Previous attributes.
+     */
+    emitParticipantAttributesChanged(roomId: string, participantIdentity: string, attributes: Record<string, string>, previousAttributes: Record<string, string>): void;
+    /**
+     * Emits a track published event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     * @param {MockTrackState} track - Published track.
+     */
+    emitTrackPublished(roomId: string, participantIdentity: string, track: MockTrackState): void;
+    /**
+     * Emits a track unpublished event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     * @param {string} trackId - Track identifier.
+     */
+    emitTrackUnpublished(roomId: string, participantIdentity: string, trackId: string): void;
+    /**
+     * Emits a track muted event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} trackId - Track identifier.
+     */
+    emitTrackMuted(roomId: string, trackId: string): void;
+    /**
+     * Emits a track unmuted event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} trackId - Track identifier.
+     */
+    emitTrackUnmuted(roomId: string, trackId: string): void;
+    /**
+     * Emits a message received event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {MockMessageState} message - Received message.
+     */
+    emitMessageReceived(roomId: string, message: MockMessageState): void;
+    /**
+     * Emits a message sent event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {MockMessageState} message - Sent message.
+     */
+    emitMessageSent(roomId: string, message: MockMessageState): void;
+    /**
+     * Emits a typing indicator event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     * @param {boolean} isTyping - Whether typing.
+     */
+    emitTypingIndicator(roomId: string, participantIdentity: string, isTyping: boolean): void;
+    /**
+     * Emits an agent started event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {MockAgentState} agent - Started agent.
+     */
+    emitAgentStarted(roomId: string, agent: MockAgentState): void;
+    /**
+     * Emits an agent stopped event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} agentId - Agent identifier.
+     */
+    emitAgentStopped(roomId: string, agentId: string): void;
+    /**
+     * Emits an agent message event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} agentId - Agent identifier.
+     * @param {MockAgentMessage} message - Agent message.
+     */
+    emitAgentMessage(roomId: string, agentId: string, message: MockAgentMessage): void;
+    /**
+     * Emits a data received event.
+     *
+     * @param {string} roomId - Room identifier.
+     * @param {string} participantIdentity - Participant identity.
+     * @param {Uint8Array} data - Received data.
+     * @param {string} [topic] - Data topic.
+     */
+    emitDataReceived(roomId: string, participantIdentity: string, data: Uint8Array, topic?: string): void;
+    /**
+     * Emits an error event.
+     *
+     * @param {MockError} error - Error details.
+     * @param {string} [roomId] - Optional room identifier.
+     */
+    emitError(error: MockError, roomId?: string): void;
+    /**
+     * Gets the event history.
+     *
+     * @param {MockEventType} [filterType] - Optional filter by event type.
+     * @returns {MockEvent[]} Array of events.
+     */
+    getHistory(filterType?: MockEventType): MockEvent[];
+    /**
+     * Gets the last N events.
+     *
+     * @param {number} count - Number of events to get.
+     * @param {MockEventType} [filterType] - Optional filter by event type.
+     * @returns {MockEvent[]} Array of events.
+     */
+    getLastEvents(count: number, filterType?: MockEventType): MockEvent[];
+    /**
+     * Clears the event history.
+     */
+    clearHistory(): void;
+    /**
+     * Gets the count of listeners for a specific event type.
+     *
+     * @param {MockEventType} type - Event type.
+     * @returns {number} Number of listeners.
+     */
+    listenerCount(type: MockEventType): number;
+}
+
+export { MockEventEmitter };

package/services/conversation/mock/events.js

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.184 | © 2026 Onlive.ai */
+var s=class{constructor(){this.listeners={};this.wildcardListeners=new Set;this.eventHistory=[];this.maxHistorySize=1e3;this.recordHistory=!0}setMaxHistorySize(t){this.maxHistorySize=t,this.trimHistory()}setRecordHistory(t){this.recordHistory=t}on(t,e){return this.listeners[t]||(this.listeners[t]=new Set),this.listeners[t].add(e),()=>{this.off(t,e)}}once(t,e){let i=n=>{this.off(t,i),e(n)};return this.on(t,i)}off(t,e){this.listeners[t]?.delete(e)}onAny(t){return this.wildcardListeners.add(t),()=>{this.wildcardListeners.delete(t)}}offAny(t){this.wildcardListeners.delete(t)}removeAllListeners(t){t?delete this.listeners[t]:(this.listeners={},this.wildcardListeners.clear())}emit(t){this.recordHistory&&(this.eventHistory.push(t),this.trimHistory());let e=this.listeners[t.type];if(e)for(let i of e)try{i(t)}catch(n){console.error(`Error in mock event listener for ${t.type}:`,n)}for(let i of this.wildcardListeners)try{i(t)}catch(n){console.error("Error in mock wildcard event listener:",n)}}trimHistory(){this.eventHistory.length>this.maxHistorySize&&(this.eventHistory=this.eventHistory.slice(-this.maxHistorySize))}emitRoomCreated(t){let e={type:"roomCreated",timestamp:new Date().toISOString(),roomId:t.id,room:t};this.emit(e)}emitRoomEnded(t){let e={type:"roomEnded",timestamp:new Date().toISOString(),roomId:t};this.emit(e)}emitRoomConnectionStateChanged(t,e,i){let n={type:"roomConnectionStateChanged",timestamp:new Date().toISOString(),roomId:t,state:e,previousState:i};this.emit(n)}emitParticipantJoined(t,e){let i={type:"participantJoined",timestamp:new Date().toISOString(),roomId:t,participant:e};this.emit(i)}emitParticipantLeft(t,e){let i={type:"participantLeft",timestamp:new Date().toISOString(),roomId:t,participantIdentity:e};this.emit(i)}emitParticipantAttributesChanged(t,e,i,n){let o={type:"participantAttributesChanged",timestamp:new Date().toISOString(),roomId:t,participantIdentity:e,attributes:i,previousAttributes:n};this.emit(o)}emitTrackPublished(t,e,i){let n={type:"trackPublished",timestamp:new Date().toISOString(),roomId:t,participantIdentity:e,track:i};this.emit(n)}emitTrackUnpublished(t,e,i){let n={type:"trackUnpublished",timestamp:new Date().toISOString(),roomId:t,participantIdentity:e,trackId:i};this.emit(n)}emitTrackMuted(t,e){let i={type:"trackMuted",timestamp:new Date().toISOString(),roomId:t,trackId:e};this.emit(i)}emitTrackUnmuted(t,e){let i={type:"trackUnmuted",timestamp:new Date().toISOString(),roomId:t,trackId:e};this.emit(i)}emitMessageReceived(t,e){let i={type:"messageReceived",timestamp:new Date().toISOString(),roomId:t,message:e};this.emit(i)}emitMessageSent(t,e){let i={type:"messageSent",timestamp:new Date().toISOString(),roomId:t,message:e};this.emit(i)}emitTypingIndicator(t,e,i){let n={type:"typingIndicator",timestamp:new Date().toISOString(),roomId:t,participantIdentity:e,isTyping:i};this.emit(n)}emitAgentStarted(t,e){let i={type:"agentStarted",timestamp:new Date().toISOString(),roomId:t,agent:e};this.emit(i)}emitAgentStopped(t,e){let i={type:"agentStopped",timestamp:new Date().toISOString(),roomId:t,agentId:e};this.emit(i)}emitAgentMessage(t,e,i){let n={type:"agentMessage",timestamp:new Date().toISOString(),roomId:t,agentId:e,message:i};this.emit(n)}emitDataReceived(t,e,i,n){let o={type:"dataReceived",timestamp:new Date().toISOString(),roomId:t,participantIdentity:e,data:i,topic:n};this.emit(o)}emitError(t,e){let i={type:"error",timestamp:new Date().toISOString(),roomId:e,error:t};this.emit(i)}getHistory(t){return t?this.eventHistory.filter(e=>e.type===t):[...this.eventHistory]}getLastEvents(t,e){return(e?this.eventHistory.filter(n=>n.type===e):this.eventHistory).slice(-t)}clearHistory(){this.eventHistory=[]}listenerCount(t){return(this.listeners[t]?.size??0)+this.wildcardListeners.size}};export{s as MockEventEmitter};