@whereby.com/assistant-sdk 0.0.0-canary-20250912144626 → 0.0.0-canary-20250916140846

package/dist/index.cjs

@@ -30,9 +30,11 @@ function _interopNamespaceDefault(e) {
 
 var dotenv__namespace = /*#__PURE__*/_interopNamespaceDefault(dotenv);
 
-const ASSISTANT_JOIN_SUCCESS = "ASSISTANT_JOIN_SUCCESS";
+const TRIGGER_EVENT_SUCCESS = "trigger_event_success";
 
 const AUDIO_STREAM_READY = "AUDIO_STREAM_READY";
+const ASSISTANT_JOINED_ROOM = "ASSISTANT_JOINED_ROOM";
+const ASSISTANT_LEFT_ROOM = "ASSISTANT_LEFT_ROOM";
 
 /******************************************************************************
 Copyright (c) Microsoft Corporation.
@@ -516,6 +518,15 @@ class Assistant extends EventEmitter {
         this.mediaStream = null;
         this.audioSource = null;
         this.combinedStream = null;
+        this.roomUrl = null;
+        this.handleConnectionStatusChange = (status) => {
+            if (status === "connected") {
+                this.emit(ASSISTANT_JOINED_ROOM, { roomUrl: this.roomUrl || "" });
+            }
+            if (["left", "kicked"].includes(status)) {
+                this.emit(ASSISTANT_LEFT_ROOM, { roomUrl: this.roomUrl || "" });
+            }
+        };
         this.assistantKey = assistantKey;
         this.client = new core.WherebyClient();
         this.roomConnection = this.client.getRoomConnection();
@@ -540,6 +551,7 @@ class Assistant extends EventEmitter {
             const audioMixer = new AudioMixer(handleStreamReady);
             this.combinedStream = audioMixer.getCombinedAudioStream();
             this.roomConnection.subscribeToRemoteParticipants(audioMixer.handleRemoteParticipants.bind(audioMixer));
+            this.roomConnection.subscribeToConnectionStatus(this.handleConnectionStatusChange);
         }
     }
     joinRoom(roomUrl) {
@@ -547,6 +559,7 @@ class Assistant extends EventEmitter {
             if (this.mediaStream) {
                 yield this.localMedia.startMedia(this.mediaStream);
             }
+            this.roomUrl = roomUrl;
             this.roomConnection.initialize({
                 localMediaOptions: {
                     audio: false,
@@ -649,7 +662,7 @@ function buildRoomUrl(roomPath, wherebySubdomain, baseDomain = "whereby.com") {
     return `https://${wherebyDomain}${roomPath}`;
 }
 
-const webhookRouter = (webhookTriggers, emitter, assistantKey, startCombinedAudioStream = false, startLocalMedia = false) => {
+const webhookRouter = (webhookTriggers, emitter) => {
     const router = express.Router();
     const jsonParser = bodyParser.json();
     router.get("/", (_, res) => {
@@ -657,15 +670,31 @@ const webhookRouter = (webhookTriggers, emitter, assistantKey, startCombinedAudi
         res.end();
     });
     router.post("/", jsonParser, (req, res) => {
-        var _a;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         assert(req.body, "message body is required");
         assert("type" in req.body, "webhook type is required");
-        const shouldTriggerOnReceivedWebhook = (_a = webhookTriggers[req.body.type]) === null || _a === void 0 ? void 0 : _a.call(webhookTriggers, req.body);
+        let shouldTriggerOnReceivedWebhook = false;
+        switch (req.body.type) {
+            case "room.client.joined":
+                shouldTriggerOnReceivedWebhook =
+                    (_b = (_a = webhookTriggers["room.client.joined"]) === null || _a === void 0 ? void 0 : _a.call(webhookTriggers, req.body)) !== null && _b !== void 0 ? _b : false;
+                break;
+            case "room.client.left":
+                shouldTriggerOnReceivedWebhook =
+                    (_d = (_c = webhookTriggers["room.client.left"]) === null || _c === void 0 ? void 0 : _c.call(webhookTriggers, req.body)) !== null && _d !== void 0 ? _d : false;
+                break;
+            case "room.session.started":
+                shouldTriggerOnReceivedWebhook =
+                    (_f = (_e = webhookTriggers["room.session.started"]) === null || _e === void 0 ? void 0 : _e.call(webhookTriggers, req.body)) !== null && _f !== void 0 ? _f : false;
+                break;
+            case "room.session.ended":
+                shouldTriggerOnReceivedWebhook =
+                    (_h = (_g = webhookTriggers["room.session.ended"]) === null || _g === void 0 ? void 0 : _g.call(webhookTriggers, req.body)) !== null && _h !== void 0 ? _h : false;
+                break;
+        }
         if (shouldTriggerOnReceivedWebhook) {
             const roomUrl = buildRoomUrl(req.body.data.roomName, req.body.data.subdomain);
-            const assistant = new Assistant({ assistantKey, startCombinedAudioStream, startLocalMedia });
-            assistant.joinRoom(roomUrl);
-            emitter.emit(ASSISTANT_JOIN_SUCCESS, { roomUrl, triggerWebhook: req.body, assistant });
+            emitter.emit(TRIGGER_EVENT_SUCCESS, { roomUrl, triggerWebhook: req.body });
         }
         res.status(200);
         res.end();
@@ -673,17 +702,14 @@ const webhookRouter = (webhookTriggers, emitter, assistantKey, startCombinedAudi
     return router;
 };
 class Trigger extends EventEmitter.EventEmitter {
-    constructor({ webhookTriggers = {}, port = 8080, assistantKey, startCombinedAudioStream, startLocalMedia, }) {
+    constructor({ webhookTriggers = {}, port = 8080 }) {
         super();
         this.webhookTriggers = webhookTriggers;
         this.port = port;
-        this.assistantKey = assistantKey;
-        this.startCombinedAudioStream = startCombinedAudioStream !== null && startCombinedAudioStream !== void 0 ? startCombinedAudioStream : false;
-        this.startLocalMedia = startLocalMedia !== null && startLocalMedia !== void 0 ? startLocalMedia : false;
     }
     start() {
         const app = express();
-        const router = webhookRouter(this.webhookTriggers, this, this.assistantKey, this.startCombinedAudioStream, this.startLocalMedia);
+        const router = webhookRouter(this.webhookTriggers, this);
         app.use(router);
         const server = app.listen(this.port, () => {
             // console.log(`Bot trigger server now running on port[${this.port}]`);
@@ -694,9 +720,11 @@ class Trigger extends EventEmitter.EventEmitter {
     }
 }
 
-exports.ASSISTANT_JOIN_SUCCESS = ASSISTANT_JOIN_SUCCESS;
+exports.ASSISTANT_JOINED_ROOM = ASSISTANT_JOINED_ROOM;
+exports.ASSISTANT_LEFT_ROOM = ASSISTANT_LEFT_ROOM;
 exports.AUDIO_STREAM_READY = AUDIO_STREAM_READY;
 exports.Assistant = Assistant;
 exports.AudioSink = AudioSink;
 exports.AudioSource = AudioSource;
+exports.TRIGGER_EVENT_SUCCESS = TRIGGER_EVENT_SUCCESS;
 exports.Trigger = Trigger;

package/dist/index.d.cts

@@ -36,50 +36,8 @@ declare global {
     }
 }
 
-declare const AUDIO_STREAM_READY = "AUDIO_STREAM_READY";
-type AssistantEvents = {
-    [AUDIO_STREAM_READY]: [{
-        stream: MediaStream;
-        track: MediaStreamTrack;
-    }];
-};
-
-type AssistantOptions = {
-    assistantKey: string;
-    startCombinedAudioStream?: boolean;
-    startLocalMedia?: boolean;
-};
-declare class Assistant extends EventEmitter<AssistantEvents> {
-    private assistantKey;
-    private client;
-    private roomConnection;
-    private localMedia;
-    private mediaStream;
-    private audioSource;
-    private combinedStream;
-    constructor({ assistantKey, startCombinedAudioStream, startLocalMedia }: AssistantOptions);
-    joinRoom(roomUrl: string): Promise<void>;
-    startLocalMedia(): void;
-    getLocalMediaStream(): MediaStream | null;
-    getLocalAudioSource(): wrtc__default.nonstandard.RTCAudioSource | null;
-    getRoomConnection(): RoomConnectionClient;
-    getCombinedAudioStream(): MediaStream | null;
-    getRemoteParticipants(): RemoteParticipantState[];
-    startCloudRecording(): void;
-    stopCloudRecording(): void;
-    sendChatMessage(message: string): void;
-    spotlightParticipant(participantId: string): void;
-    removeSpotlight(participantId: string): void;
-    requestAudioEnable(participantId: string, enable: boolean): void;
-    requestVideoEnable(participantId: string, enable: boolean): void;
-    acceptWaitingParticipant(participantId: string): void;
-    rejectWaitingParticipant(participantId: string): void;
-    subscribeToRemoteParticipants(callback: (participants: RemoteParticipantState[]) => void): () => void;
-    subscribeToChatMessages(callback: (messages: ChatMessage[]) => void): () => void;
-}
-
 type WebhookType = "room.client.joined" | "room.client.left" | "room.session.started" | "room.session.ended";
-declare const ASSISTANT_JOIN_SUCCESS = "ASSISTANT_JOIN_SUCCESS";
+declare const TRIGGER_EVENT_SUCCESS = "trigger_event_success";
 interface WherebyWebhookBase {
     type: WebhookType;
     apiVersion: "1.0";
@@ -117,37 +75,82 @@ interface WherebyWebhookRoomSessionEnded extends WherebyWebhookBase {
     data: WherebyWebhookInRoom;
 }
 type TriggerEvents = {
-    [ASSISTANT_JOIN_SUCCESS]: [{
+    [TRIGGER_EVENT_SUCCESS]: [{
         roomUrl: string;
         triggerWebhook: WherebyWebhookType;
-        assistant: Assistant;
     }];
 };
 type WherebyWebhookType = WherebyWebhookRoomClientJoined | WherebyWebhookRoomClientLeft | WherebyWebhookRoomSessionStarted | WherebyWebhookRoomSessionEnded;
 type WherebyWebhookTriggerTypes = {
-    "room.client.joined": WherebyWebhookBase;
-    "room.client.left": WherebyWebhookBase;
+    "room.client.joined": WherebyWebhookRoomClientJoined;
+    "room.client.left": WherebyWebhookRoomClientLeft;
     "room.session.started": WherebyWebhookRoomSessionStarted;
-    "room.session.ended": WherebyWebhookBase;
+    "room.session.ended": WherebyWebhookRoomSessionEnded;
 };
 type WherebyWebhookTriggers = Partial<{
     [Type in keyof WherebyWebhookTriggerTypes]: (data: WherebyWebhookTriggerTypes[Type]) => boolean;
 }>;
 
-interface TriggerOptions {
-    webhookTriggers: WherebyWebhookTriggers;
-    port?: number;
+declare const AUDIO_STREAM_READY = "AUDIO_STREAM_READY";
+declare const ASSISTANT_JOINED_ROOM = "ASSISTANT_JOINED_ROOM";
+declare const ASSISTANT_LEFT_ROOM = "ASSISTANT_LEFT_ROOM";
+type AssistantEvents = {
+    [ASSISTANT_JOINED_ROOM]: [{
+        roomUrl: string;
+    }];
+    [ASSISTANT_LEFT_ROOM]: [{
+        roomUrl: string;
+    }];
+    [AUDIO_STREAM_READY]: [{
+        stream: MediaStream;
+        track: MediaStreamTrack;
+    }];
+};
+
+type AssistantOptions = {
     assistantKey: string;
     startCombinedAudioStream?: boolean;
     startLocalMedia?: boolean;
+};
+declare class Assistant extends EventEmitter<AssistantEvents> {
+    private assistantKey;
+    private client;
+    private roomConnection;
+    private localMedia;
+    private mediaStream;
+    private audioSource;
+    private combinedStream;
+    private roomUrl;
+    constructor({ assistantKey, startCombinedAudioStream, startLocalMedia }: AssistantOptions);
+    private handleConnectionStatusChange;
+    joinRoom(roomUrl: string): Promise<void>;
+    startLocalMedia(): void;
+    getLocalMediaStream(): MediaStream | null;
+    getLocalAudioSource(): wrtc__default.nonstandard.RTCAudioSource | null;
+    getRoomConnection(): RoomConnectionClient;
+    getCombinedAudioStream(): MediaStream | null;
+    getRemoteParticipants(): RemoteParticipantState[];
+    startCloudRecording(): void;
+    stopCloudRecording(): void;
+    sendChatMessage(message: string): void;
+    spotlightParticipant(participantId: string): void;
+    removeSpotlight(participantId: string): void;
+    requestAudioEnable(participantId: string, enable: boolean): void;
+    requestVideoEnable(participantId: string, enable: boolean): void;
+    acceptWaitingParticipant(participantId: string): void;
+    rejectWaitingParticipant(participantId: string): void;
+    subscribeToRemoteParticipants(callback: (participants: RemoteParticipantState[]) => void): () => void;
+    subscribeToChatMessages(callback: (messages: ChatMessage[]) => void): () => void;
+}
+
+interface TriggerOptions {
+    webhookTriggers: WherebyWebhookTriggers;
+    port?: number;
 }
 declare class Trigger extends EventEmitter$1<TriggerEvents> {
     private webhookTriggers;
     private port;
-    private assistantKey;
-    private startCombinedAudioStream;
-    private startLocalMedia;
-    constructor({ webhookTriggers, port, assistantKey, startCombinedAudioStream, startLocalMedia, }: TriggerOptions);
+    constructor({ webhookTriggers, port }: TriggerOptions);
     start(): void;
 }
 
@@ -166,4 +169,5 @@ declare class AudioSink extends wrtc__default.nonstandard.RTCAudioSink {
     }) => void): () => void;
 }
 
-export { ASSISTANT_JOIN_SUCCESS, AUDIO_STREAM_READY, Assistant, AudioSink, AudioSource, Trigger };
+export { ASSISTANT_JOINED_ROOM, ASSISTANT_LEFT_ROOM, AUDIO_STREAM_READY, Assistant, AudioSink, AudioSource, TRIGGER_EVENT_SUCCESS, Trigger };
+export type { AssistantEvents };

package/dist/index.d.mts

@@ -36,50 +36,8 @@ declare global {
     }
 }
 
-declare const AUDIO_STREAM_READY = "AUDIO_STREAM_READY";
-type AssistantEvents = {
-    [AUDIO_STREAM_READY]: [{
-        stream: MediaStream;
-        track: MediaStreamTrack;
-    }];
-};
-
-type AssistantOptions = {
-    assistantKey: string;
-    startCombinedAudioStream?: boolean;
-    startLocalMedia?: boolean;
-};
-declare class Assistant extends EventEmitter<AssistantEvents> {
-    private assistantKey;
-    private client;
-    private roomConnection;
-    private localMedia;
-    private mediaStream;
-    private audioSource;
-    private combinedStream;
-    constructor({ assistantKey, startCombinedAudioStream, startLocalMedia }: AssistantOptions);
-    joinRoom(roomUrl: string): Promise<void>;
-    startLocalMedia(): void;
-    getLocalMediaStream(): MediaStream | null;
-    getLocalAudioSource(): wrtc__default.nonstandard.RTCAudioSource | null;
-    getRoomConnection(): RoomConnectionClient;
-    getCombinedAudioStream(): MediaStream | null;
-    getRemoteParticipants(): RemoteParticipantState[];
-    startCloudRecording(): void;
-    stopCloudRecording(): void;
-    sendChatMessage(message: string): void;
-    spotlightParticipant(participantId: string): void;
-    removeSpotlight(participantId: string): void;
-    requestAudioEnable(participantId: string, enable: boolean): void;
-    requestVideoEnable(participantId: string, enable: boolean): void;
-    acceptWaitingParticipant(participantId: string): void;
-    rejectWaitingParticipant(participantId: string): void;
-    subscribeToRemoteParticipants(callback: (participants: RemoteParticipantState[]) => void): () => void;
-    subscribeToChatMessages(callback: (messages: ChatMessage[]) => void): () => void;
-}
-
 type WebhookType = "room.client.joined" | "room.client.left" | "room.session.started" | "room.session.ended";
-declare const ASSISTANT_JOIN_SUCCESS = "ASSISTANT_JOIN_SUCCESS";
+declare const TRIGGER_EVENT_SUCCESS = "trigger_event_success";
 interface WherebyWebhookBase {
     type: WebhookType;
     apiVersion: "1.0";
@@ -117,37 +75,82 @@ interface WherebyWebhookRoomSessionEnded extends WherebyWebhookBase {
     data: WherebyWebhookInRoom;
 }
 type TriggerEvents = {
-    [ASSISTANT_JOIN_SUCCESS]: [{
+    [TRIGGER_EVENT_SUCCESS]: [{
         roomUrl: string;
         triggerWebhook: WherebyWebhookType;
-        assistant: Assistant;
     }];
 };
 type WherebyWebhookType = WherebyWebhookRoomClientJoined | WherebyWebhookRoomClientLeft | WherebyWebhookRoomSessionStarted | WherebyWebhookRoomSessionEnded;
 type WherebyWebhookTriggerTypes = {
-    "room.client.joined": WherebyWebhookBase;
-    "room.client.left": WherebyWebhookBase;
+    "room.client.joined": WherebyWebhookRoomClientJoined;
+    "room.client.left": WherebyWebhookRoomClientLeft;
     "room.session.started": WherebyWebhookRoomSessionStarted;
-    "room.session.ended": WherebyWebhookBase;
+    "room.session.ended": WherebyWebhookRoomSessionEnded;
 };
 type WherebyWebhookTriggers = Partial<{
     [Type in keyof WherebyWebhookTriggerTypes]: (data: WherebyWebhookTriggerTypes[Type]) => boolean;
 }>;
 
-interface TriggerOptions {
-    webhookTriggers: WherebyWebhookTriggers;
-    port?: number;
+declare const AUDIO_STREAM_READY = "AUDIO_STREAM_READY";
+declare const ASSISTANT_JOINED_ROOM = "ASSISTANT_JOINED_ROOM";
+declare const ASSISTANT_LEFT_ROOM = "ASSISTANT_LEFT_ROOM";
+type AssistantEvents = {
+    [ASSISTANT_JOINED_ROOM]: [{
+        roomUrl: string;
+    }];
+    [ASSISTANT_LEFT_ROOM]: [{
+        roomUrl: string;
+    }];
+    [AUDIO_STREAM_READY]: [{
+        stream: MediaStream;
+        track: MediaStreamTrack;
+    }];
+};
+
+type AssistantOptions = {
     assistantKey: string;
     startCombinedAudioStream?: boolean;
     startLocalMedia?: boolean;
+};
+declare class Assistant extends EventEmitter<AssistantEvents> {
+    private assistantKey;
+    private client;
+    private roomConnection;
+    private localMedia;
+    private mediaStream;
+    private audioSource;
+    private combinedStream;
+    private roomUrl;
+    constructor({ assistantKey, startCombinedAudioStream, startLocalMedia }: AssistantOptions);
+    private handleConnectionStatusChange;
+    joinRoom(roomUrl: string): Promise<void>;
+    startLocalMedia(): void;
+    getLocalMediaStream(): MediaStream | null;
+    getLocalAudioSource(): wrtc__default.nonstandard.RTCAudioSource | null;
+    getRoomConnection(): RoomConnectionClient;
+    getCombinedAudioStream(): MediaStream | null;
+    getRemoteParticipants(): RemoteParticipantState[];
+    startCloudRecording(): void;
+    stopCloudRecording(): void;
+    sendChatMessage(message: string): void;
+    spotlightParticipant(participantId: string): void;
+    removeSpotlight(participantId: string): void;
+    requestAudioEnable(participantId: string, enable: boolean): void;
+    requestVideoEnable(participantId: string, enable: boolean): void;
+    acceptWaitingParticipant(participantId: string): void;
+    rejectWaitingParticipant(participantId: string): void;
+    subscribeToRemoteParticipants(callback: (participants: RemoteParticipantState[]) => void): () => void;
+    subscribeToChatMessages(callback: (messages: ChatMessage[]) => void): () => void;
+}
+
+interface TriggerOptions {
+    webhookTriggers: WherebyWebhookTriggers;
+    port?: number;
 }
 declare class Trigger extends EventEmitter$1<TriggerEvents> {
     private webhookTriggers;
     private port;
-    private assistantKey;
-    private startCombinedAudioStream;
-    private startLocalMedia;
-    constructor({ webhookTriggers, port, assistantKey, startCombinedAudioStream, startLocalMedia, }: TriggerOptions);
+    constructor({ webhookTriggers, port }: TriggerOptions);
     start(): void;
 }
 
@@ -166,4 +169,5 @@ declare class AudioSink extends wrtc__default.nonstandard.RTCAudioSink {
     }) => void): () => void;
 }
 
-export { ASSISTANT_JOIN_SUCCESS, AUDIO_STREAM_READY, Assistant, AudioSink, AudioSource, Trigger };
+export { ASSISTANT_JOINED_ROOM, ASSISTANT_LEFT_ROOM, AUDIO_STREAM_READY, Assistant, AudioSink, AudioSource, TRIGGER_EVENT_SUCCESS, Trigger };
+export type { AssistantEvents };

package/dist/index.d.ts

@@ -36,50 +36,8 @@ declare global {
     }
 }
 
-declare const AUDIO_STREAM_READY = "AUDIO_STREAM_READY";
-type AssistantEvents = {
-    [AUDIO_STREAM_READY]: [{
-        stream: MediaStream;
-        track: MediaStreamTrack;
-    }];
-};
-
-type AssistantOptions = {
-    assistantKey: string;
-    startCombinedAudioStream?: boolean;
-    startLocalMedia?: boolean;
-};
-declare class Assistant extends EventEmitter<AssistantEvents> {
-    private assistantKey;
-    private client;
-    private roomConnection;
-    private localMedia;
-    private mediaStream;
-    private audioSource;
-    private combinedStream;
-    constructor({ assistantKey, startCombinedAudioStream, startLocalMedia }: AssistantOptions);
-    joinRoom(roomUrl: string): Promise<void>;
-    startLocalMedia(): void;
-    getLocalMediaStream(): MediaStream | null;
-    getLocalAudioSource(): wrtc__default.nonstandard.RTCAudioSource | null;
-    getRoomConnection(): RoomConnectionClient;
-    getCombinedAudioStream(): MediaStream | null;
-    getRemoteParticipants(): RemoteParticipantState[];
-    startCloudRecording(): void;
-    stopCloudRecording(): void;
-    sendChatMessage(message: string): void;
-    spotlightParticipant(participantId: string): void;
-    removeSpotlight(participantId: string): void;
-    requestAudioEnable(participantId: string, enable: boolean): void;
-    requestVideoEnable(participantId: string, enable: boolean): void;
-    acceptWaitingParticipant(participantId: string): void;
-    rejectWaitingParticipant(participantId: string): void;
-    subscribeToRemoteParticipants(callback: (participants: RemoteParticipantState[]) => void): () => void;
-    subscribeToChatMessages(callback: (messages: ChatMessage[]) => void): () => void;
-}
-
 type WebhookType = "room.client.joined" | "room.client.left" | "room.session.started" | "room.session.ended";
-declare const ASSISTANT_JOIN_SUCCESS = "ASSISTANT_JOIN_SUCCESS";
+declare const TRIGGER_EVENT_SUCCESS = "trigger_event_success";
 interface WherebyWebhookBase {
     type: WebhookType;
     apiVersion: "1.0";
@@ -117,37 +75,82 @@ interface WherebyWebhookRoomSessionEnded extends WherebyWebhookBase {
     data: WherebyWebhookInRoom;
 }
 type TriggerEvents = {
-    [ASSISTANT_JOIN_SUCCESS]: [{
+    [TRIGGER_EVENT_SUCCESS]: [{
         roomUrl: string;
         triggerWebhook: WherebyWebhookType;
-        assistant: Assistant;
     }];
 };
 type WherebyWebhookType = WherebyWebhookRoomClientJoined | WherebyWebhookRoomClientLeft | WherebyWebhookRoomSessionStarted | WherebyWebhookRoomSessionEnded;
 type WherebyWebhookTriggerTypes = {
-    "room.client.joined": WherebyWebhookBase;
-    "room.client.left": WherebyWebhookBase;
+    "room.client.joined": WherebyWebhookRoomClientJoined;
+    "room.client.left": WherebyWebhookRoomClientLeft;
     "room.session.started": WherebyWebhookRoomSessionStarted;
-    "room.session.ended": WherebyWebhookBase;
+    "room.session.ended": WherebyWebhookRoomSessionEnded;
 };
 type WherebyWebhookTriggers = Partial<{
     [Type in keyof WherebyWebhookTriggerTypes]: (data: WherebyWebhookTriggerTypes[Type]) => boolean;
 }>;
 
-interface TriggerOptions {
-    webhookTriggers: WherebyWebhookTriggers;
-    port?: number;
+declare const AUDIO_STREAM_READY = "AUDIO_STREAM_READY";
+declare const ASSISTANT_JOINED_ROOM = "ASSISTANT_JOINED_ROOM";
+declare const ASSISTANT_LEFT_ROOM = "ASSISTANT_LEFT_ROOM";
+type AssistantEvents = {
+    [ASSISTANT_JOINED_ROOM]: [{
+        roomUrl: string;
+    }];
+    [ASSISTANT_LEFT_ROOM]: [{
+        roomUrl: string;
+    }];
+    [AUDIO_STREAM_READY]: [{
+        stream: MediaStream;
+        track: MediaStreamTrack;
+    }];
+};
+
+type AssistantOptions = {
     assistantKey: string;
     startCombinedAudioStream?: boolean;
     startLocalMedia?: boolean;
+};
+declare class Assistant extends EventEmitter<AssistantEvents> {
+    private assistantKey;
+    private client;
+    private roomConnection;
+    private localMedia;
+    private mediaStream;
+    private audioSource;
+    private combinedStream;
+    private roomUrl;
+    constructor({ assistantKey, startCombinedAudioStream, startLocalMedia }: AssistantOptions);
+    private handleConnectionStatusChange;
+    joinRoom(roomUrl: string): Promise<void>;
+    startLocalMedia(): void;
+    getLocalMediaStream(): MediaStream | null;
+    getLocalAudioSource(): wrtc__default.nonstandard.RTCAudioSource | null;
+    getRoomConnection(): RoomConnectionClient;
+    getCombinedAudioStream(): MediaStream | null;
+    getRemoteParticipants(): RemoteParticipantState[];
+    startCloudRecording(): void;
+    stopCloudRecording(): void;
+    sendChatMessage(message: string): void;
+    spotlightParticipant(participantId: string): void;
+    removeSpotlight(participantId: string): void;
+    requestAudioEnable(participantId: string, enable: boolean): void;
+    requestVideoEnable(participantId: string, enable: boolean): void;
+    acceptWaitingParticipant(participantId: string): void;
+    rejectWaitingParticipant(participantId: string): void;
+    subscribeToRemoteParticipants(callback: (participants: RemoteParticipantState[]) => void): () => void;
+    subscribeToChatMessages(callback: (messages: ChatMessage[]) => void): () => void;
+}
+
+interface TriggerOptions {
+    webhookTriggers: WherebyWebhookTriggers;
+    port?: number;
 }
 declare class Trigger extends EventEmitter$1<TriggerEvents> {
     private webhookTriggers;
     private port;
-    private assistantKey;
-    private startCombinedAudioStream;
-    private startLocalMedia;
-    constructor({ webhookTriggers, port, assistantKey, startCombinedAudioStream, startLocalMedia, }: TriggerOptions);
+    constructor({ webhookTriggers, port }: TriggerOptions);
     start(): void;
 }
 
@@ -166,4 +169,5 @@ declare class AudioSink extends wrtc__default.nonstandard.RTCAudioSink {
     }) => void): () => void;
 }
 
-export { ASSISTANT_JOIN_SUCCESS, AUDIO_STREAM_READY, Assistant, AudioSink, AudioSource, Trigger };
+export { ASSISTANT_JOINED_ROOM, ASSISTANT_LEFT_ROOM, AUDIO_STREAM_READY, Assistant, AudioSink, AudioSource, TRIGGER_EVENT_SUCCESS, Trigger };
+export type { AssistantEvents };

package/dist/index.mjs

@@ -9,9 +9,11 @@ import bodyParser from 'body-parser';
 import { networkInterfaces } from 'os';
 import * as dotenv from 'dotenv';
 
-const ASSISTANT_JOIN_SUCCESS = "ASSISTANT_JOIN_SUCCESS";
+const TRIGGER_EVENT_SUCCESS = "trigger_event_success";
 
 const AUDIO_STREAM_READY = "AUDIO_STREAM_READY";
+const ASSISTANT_JOINED_ROOM = "ASSISTANT_JOINED_ROOM";
+const ASSISTANT_LEFT_ROOM = "ASSISTANT_LEFT_ROOM";
 
 /******************************************************************************
 Copyright (c) Microsoft Corporation.
@@ -495,6 +497,15 @@ class Assistant extends EventEmitter$1 {
         this.mediaStream = null;
         this.audioSource = null;
         this.combinedStream = null;
+        this.roomUrl = null;
+        this.handleConnectionStatusChange = (status) => {
+            if (status === "connected") {
+                this.emit(ASSISTANT_JOINED_ROOM, { roomUrl: this.roomUrl || "" });
+            }
+            if (["left", "kicked"].includes(status)) {
+                this.emit(ASSISTANT_LEFT_ROOM, { roomUrl: this.roomUrl || "" });
+            }
+        };
         this.assistantKey = assistantKey;
         this.client = new WherebyClient();
         this.roomConnection = this.client.getRoomConnection();
@@ -519,6 +530,7 @@ class Assistant extends EventEmitter$1 {
             const audioMixer = new AudioMixer(handleStreamReady);
             this.combinedStream = audioMixer.getCombinedAudioStream();
             this.roomConnection.subscribeToRemoteParticipants(audioMixer.handleRemoteParticipants.bind(audioMixer));
+            this.roomConnection.subscribeToConnectionStatus(this.handleConnectionStatusChange);
         }
     }
     joinRoom(roomUrl) {
@@ -526,6 +538,7 @@ class Assistant extends EventEmitter$1 {
             if (this.mediaStream) {
                 yield this.localMedia.startMedia(this.mediaStream);
             }
+            this.roomUrl = roomUrl;
             this.roomConnection.initialize({
                 localMediaOptions: {
                     audio: false,
@@ -628,7 +641,7 @@ function buildRoomUrl(roomPath, wherebySubdomain, baseDomain = "whereby.com") {
     return `https://${wherebyDomain}${roomPath}`;
 }
 
-const webhookRouter = (webhookTriggers, emitter, assistantKey, startCombinedAudioStream = false, startLocalMedia = false) => {
+const webhookRouter = (webhookTriggers, emitter) => {
     const router = express.Router();
     const jsonParser = bodyParser.json();
     router.get("/", (_, res) => {
@@ -636,15 +649,31 @@ const webhookRouter = (webhookTriggers, emitter, assistantKey, startCombinedAudi
         res.end();
     });
     router.post("/", jsonParser, (req, res) => {
-        var _a;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         assert(req.body, "message body is required");
         assert("type" in req.body, "webhook type is required");
-        const shouldTriggerOnReceivedWebhook = (_a = webhookTriggers[req.body.type]) === null || _a === void 0 ? void 0 : _a.call(webhookTriggers, req.body);
+        let shouldTriggerOnReceivedWebhook = false;
+        switch (req.body.type) {
+            case "room.client.joined":
+                shouldTriggerOnReceivedWebhook =
+                    (_b = (_a = webhookTriggers["room.client.joined"]) === null || _a === void 0 ? void 0 : _a.call(webhookTriggers, req.body)) !== null && _b !== void 0 ? _b : false;
+                break;
+            case "room.client.left":
+                shouldTriggerOnReceivedWebhook =
+                    (_d = (_c = webhookTriggers["room.client.left"]) === null || _c === void 0 ? void 0 : _c.call(webhookTriggers, req.body)) !== null && _d !== void 0 ? _d : false;
+                break;
+            case "room.session.started":
+                shouldTriggerOnReceivedWebhook =
+                    (_f = (_e = webhookTriggers["room.session.started"]) === null || _e === void 0 ? void 0 : _e.call(webhookTriggers, req.body)) !== null && _f !== void 0 ? _f : false;
+                break;
+            case "room.session.ended":
+                shouldTriggerOnReceivedWebhook =
+                    (_h = (_g = webhookTriggers["room.session.ended"]) === null || _g === void 0 ? void 0 : _g.call(webhookTriggers, req.body)) !== null && _h !== void 0 ? _h : false;
+                break;
+        }
         if (shouldTriggerOnReceivedWebhook) {
             const roomUrl = buildRoomUrl(req.body.data.roomName, req.body.data.subdomain);
-            const assistant = new Assistant({ assistantKey, startCombinedAudioStream, startLocalMedia });
-            assistant.joinRoom(roomUrl);
-            emitter.emit(ASSISTANT_JOIN_SUCCESS, { roomUrl, triggerWebhook: req.body, assistant });
+            emitter.emit(TRIGGER_EVENT_SUCCESS, { roomUrl, triggerWebhook: req.body });
         }
         res.status(200);
         res.end();
@@ -652,17 +681,14 @@ const webhookRouter = (webhookTriggers, emitter, assistantKey, startCombinedAudi
     return router;
 };
 class Trigger extends EventEmitter {
-    constructor({ webhookTriggers = {}, port = 8080, assistantKey, startCombinedAudioStream, startLocalMedia, }) {
+    constructor({ webhookTriggers = {}, port = 8080 }) {
         super();
         this.webhookTriggers = webhookTriggers;
         this.port = port;
-        this.assistantKey = assistantKey;
-        this.startCombinedAudioStream = startCombinedAudioStream !== null && startCombinedAudioStream !== void 0 ? startCombinedAudioStream : false;
-        this.startLocalMedia = startLocalMedia !== null && startLocalMedia !== void 0 ? startLocalMedia : false;
     }
     start() {
         const app = express();
-        const router = webhookRouter(this.webhookTriggers, this, this.assistantKey, this.startCombinedAudioStream, this.startLocalMedia);
+        const router = webhookRouter(this.webhookTriggers, this);
         app.use(router);
         const server = app.listen(this.port, () => {
             // console.log(`Bot trigger server now running on port[${this.port}]`);
@@ -673,4 +699,4 @@ class Trigger extends EventEmitter {
     }
 }
 
-export { ASSISTANT_JOIN_SUCCESS, AUDIO_STREAM_READY, Assistant, AudioSink, AudioSource, Trigger };
+export { ASSISTANT_JOINED_ROOM, ASSISTANT_LEFT_ROOM, AUDIO_STREAM_READY, Assistant, AudioSink, AudioSource, TRIGGER_EVENT_SUCCESS, Trigger };

package/dist/legacy-esm.js

@@ -9,9 +9,11 @@ import bodyParser from 'body-parser';
 import { networkInterfaces } from 'os';
 import * as dotenv from 'dotenv';
 
-const ASSISTANT_JOIN_SUCCESS = "ASSISTANT_JOIN_SUCCESS";
+const TRIGGER_EVENT_SUCCESS = "trigger_event_success";
 
 const AUDIO_STREAM_READY = "AUDIO_STREAM_READY";
+const ASSISTANT_JOINED_ROOM = "ASSISTANT_JOINED_ROOM";
+const ASSISTANT_LEFT_ROOM = "ASSISTANT_LEFT_ROOM";
 
 /******************************************************************************
 Copyright (c) Microsoft Corporation.
@@ -495,6 +497,15 @@ class Assistant extends EventEmitter$1 {
         this.mediaStream = null;
         this.audioSource = null;
         this.combinedStream = null;
+        this.roomUrl = null;
+        this.handleConnectionStatusChange = (status) => {
+            if (status === "connected") {
+                this.emit(ASSISTANT_JOINED_ROOM, { roomUrl: this.roomUrl || "" });
+            }
+            if (["left", "kicked"].includes(status)) {
+                this.emit(ASSISTANT_LEFT_ROOM, { roomUrl: this.roomUrl || "" });
+            }
+        };
         this.assistantKey = assistantKey;
         this.client = new WherebyClient();
         this.roomConnection = this.client.getRoomConnection();
@@ -519,6 +530,7 @@ class Assistant extends EventEmitter$1 {
             const audioMixer = new AudioMixer(handleStreamReady);
             this.combinedStream = audioMixer.getCombinedAudioStream();
             this.roomConnection.subscribeToRemoteParticipants(audioMixer.handleRemoteParticipants.bind(audioMixer));
+            this.roomConnection.subscribeToConnectionStatus(this.handleConnectionStatusChange);
         }
     }
     joinRoom(roomUrl) {
@@ -526,6 +538,7 @@ class Assistant extends EventEmitter$1 {
             if (this.mediaStream) {
                 yield this.localMedia.startMedia(this.mediaStream);
             }
+            this.roomUrl = roomUrl;
             this.roomConnection.initialize({
                 localMediaOptions: {
                     audio: false,
@@ -628,7 +641,7 @@ function buildRoomUrl(roomPath, wherebySubdomain, baseDomain = "whereby.com") {
     return `https://${wherebyDomain}${roomPath}`;
 }
 
-const webhookRouter = (webhookTriggers, emitter, assistantKey, startCombinedAudioStream = false, startLocalMedia = false) => {
+const webhookRouter = (webhookTriggers, emitter) => {
     const router = express.Router();
     const jsonParser = bodyParser.json();
     router.get("/", (_, res) => {
@@ -636,15 +649,31 @@ const webhookRouter = (webhookTriggers, emitter, assistantKey, startCombinedAudi
         res.end();
     });
     router.post("/", jsonParser, (req, res) => {
-        var _a;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         assert(req.body, "message body is required");
         assert("type" in req.body, "webhook type is required");
-        const shouldTriggerOnReceivedWebhook = (_a = webhookTriggers[req.body.type]) === null || _a === void 0 ? void 0 : _a.call(webhookTriggers, req.body);
+        let shouldTriggerOnReceivedWebhook = false;
+        switch (req.body.type) {
+            case "room.client.joined":
+                shouldTriggerOnReceivedWebhook =
+                    (_b = (_a = webhookTriggers["room.client.joined"]) === null || _a === void 0 ? void 0 : _a.call(webhookTriggers, req.body)) !== null && _b !== void 0 ? _b : false;
+                break;
+            case "room.client.left":
+                shouldTriggerOnReceivedWebhook =
+                    (_d = (_c = webhookTriggers["room.client.left"]) === null || _c === void 0 ? void 0 : _c.call(webhookTriggers, req.body)) !== null && _d !== void 0 ? _d : false;
+                break;
+            case "room.session.started":
+                shouldTriggerOnReceivedWebhook =
+                    (_f = (_e = webhookTriggers["room.session.started"]) === null || _e === void 0 ? void 0 : _e.call(webhookTriggers, req.body)) !== null && _f !== void 0 ? _f : false;
+                break;
+            case "room.session.ended":
+                shouldTriggerOnReceivedWebhook =
+                    (_h = (_g = webhookTriggers["room.session.ended"]) === null || _g === void 0 ? void 0 : _g.call(webhookTriggers, req.body)) !== null && _h !== void 0 ? _h : false;
+                break;
+        }
         if (shouldTriggerOnReceivedWebhook) {
             const roomUrl = buildRoomUrl(req.body.data.roomName, req.body.data.subdomain);
-            const assistant = new Assistant({ assistantKey, startCombinedAudioStream, startLocalMedia });
-            assistant.joinRoom(roomUrl);
-            emitter.emit(ASSISTANT_JOIN_SUCCESS, { roomUrl, triggerWebhook: req.body, assistant });
+            emitter.emit(TRIGGER_EVENT_SUCCESS, { roomUrl, triggerWebhook: req.body });
         }
         res.status(200);
         res.end();
@@ -652,17 +681,14 @@ const webhookRouter = (webhookTriggers, emitter, assistantKey, startCombinedAudi
     return router;
 };
 class Trigger extends EventEmitter {
-    constructor({ webhookTriggers = {}, port = 8080, assistantKey, startCombinedAudioStream, startLocalMedia, }) {
+    constructor({ webhookTriggers = {}, port = 8080 }) {
         super();
         this.webhookTriggers = webhookTriggers;
         this.port = port;
-        this.assistantKey = assistantKey;
-        this.startCombinedAudioStream = startCombinedAudioStream !== null && startCombinedAudioStream !== void 0 ? startCombinedAudioStream : false;
-        this.startLocalMedia = startLocalMedia !== null && startLocalMedia !== void 0 ? startLocalMedia : false;
     }
     start() {
         const app = express();
-        const router = webhookRouter(this.webhookTriggers, this, this.assistantKey, this.startCombinedAudioStream, this.startLocalMedia);
+        const router = webhookRouter(this.webhookTriggers, this);
         app.use(router);
         const server = app.listen(this.port, () => {
             // console.log(`Bot trigger server now running on port[${this.port}]`);
@@ -673,4 +699,4 @@ class Trigger extends EventEmitter {
     }
 }
 
-export { ASSISTANT_JOIN_SUCCESS, AUDIO_STREAM_READY, Assistant, AudioSink, AudioSource, Trigger };
+export { ASSISTANT_JOINED_ROOM, ASSISTANT_LEFT_ROOM, AUDIO_STREAM_READY, Assistant, AudioSink, AudioSource, TRIGGER_EVENT_SUCCESS, Trigger };

package/package.json

@@ -2,7 +2,7 @@
   "name": "@whereby.com/assistant-sdk",
   "description": "Assistant SDK for whereby.com",
   "author": "Whereby AS",
-  "version": "0.0.0-canary-20250912144626",
+  "version": "0.0.0-canary-20250916140846",
   "license": "MIT",
   "files": [
     "dist",
@@ -47,8 +47,6 @@
     }
   },
   "devDependencies": {
-    "body-parser": "2.2.0",
-    "express": "5.1.0",
     "eslint": "^9.29.0",
     "prettier": "^3.5.3",
     "typescript": "^5.8.3",
@@ -60,10 +58,13 @@
   },
   "dependencies": {
     "@roamhq/wrtc": "github:whereby/node-webrtc#patch/rtc_audio_source",
+    "@types/web": "^0.0.267",
+    "body-parser": "2.2.0",
     "dotenv": "^16.4.5",
+    "express": "5.1.0",
     "uuid": "^11.0.3",
     "ws": "^8.18.0",
-    "@whereby.com/core": "0.0.0-canary-20250912144626"
+    "@whereby.com/core": "0.0.0-canary-20250916140846"
   },
   "prettier": "@whereby.com/prettier-config",
   "scripts": {