@azure/communication-react 1.14.0 → 1.14.1-alpha-202403210013

package/dist/dist-esm/react-composites/src/composites/CallComposite/adapter/AzureCommunicationCallAdapter.js

@@ -12,6 +12,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { compositeLogger } from '../../../Logger';
 import { _isInCall, _isInLobbyOrConnecting } from "../../../../../calling-component-bindings/src";
 import { _createStatefulCallClientInner } from "../../../../../calling-stateful-client/src";
+/* @conditional-compile-remove(teams-identity-support) */
+import { _isTeamsCallAgent } from "../../../../../calling-stateful-client/src";
 import { LocalVideoStream as SDKLocalVideoStream } from '@azure/communication-calling';
 /* @conditional-compile-remove(unsupported-browser) */ /* @conditional-compile-remove(video-background-effects) */ /* @conditional-compile-remove(close-captions) */ /* @conditional-compile-remove(capabilities) */
 import { Features } from '@azure/communication-calling';
@@ -19,6 +21,10 @@ import { EventEmitter } from 'events';
 import { getCallCompositePage, getLocatorOrTargetCallees, IsCallEndedPage, isCameraOn } from '../utils';
 import { toFlatCommunicationIdentifier, _toCommunicationIdentifier, _isValidIdentifier } from "../../../../../acs-ui-common/src";
 import { isMicrosoftTeamsUserIdentifier } from '@azure/communication-common';
+/* @conditional-compile-remove(teams-identity-support) */ /* @conditional-compile-remove(PSTN-calls) */
+import { isCommunicationUserIdentifier } from '@azure/communication-common';
+/* @conditional-compile-remove(PSTN-calls) */
+import { isPhoneNumberIdentifier } from '@azure/communication-common';
 import { ParticipantSubscriber } from './ParticipantSubcriber';
 import { DiagnosticsForwarder } from './DiagnosticsForwarder';
 import { useEffect, useRef, useState } from 'react';
@@ -31,7 +37,9 @@ import { getSelectedCameraFromAdapterState } from '../utils';
 import { CallingSoundSubscriber } from './CallingSoundSubscriber';
 /** Context of call, which is a centralized context for all state updates */
 class CallContext {
-    constructor(clientState, isTeamsCall, /* @conditional-compile-remove(rooms) */ isRoomsCall, options, targetCallees) {
+    constructor(clientState, isTeamsCall, 
+    /* @conditional-compile-remove(rooms) */
+    isRoomsCall, options, targetCallees) {
         var _a, _b, _c, _d;
         this.emitter = new EventEmitter();
         this.state = {
@@ -45,20 +53,29 @@ class CallContext {
             latestErrors: clientState.latestErrors,
             isTeamsCall,
             /* @conditional-compile-remove(rooms) */ isRoomsCall,
+            /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId: clientState.alternateCallerId,
+            /* @conditional-compile-remove(unsupported-browser) */ environmentInfo: clientState.environmentInfo,
+            /* @conditional-compile-remove(unsupported-browser) */ unsupportedBrowserVersionsAllowed: false,
             /* @conditional-compile-remove(video-background-effects) */ videoBackgroundImages: (_b = options === null || options === void 0 ? void 0 : options.videoBackgroundOptions) === null || _b === void 0 ? void 0 : _b.videoBackgroundImages,
             /* @conditional-compile-remove(video-background-effects) */
             onResolveVideoEffectDependency: (_c = options === null || options === void 0 ? void 0 : options.videoBackgroundOptions) === null || _c === void 0 ? void 0 : _c.onResolveDependency,
             /* @conditional-compile-remove(video-background-effects) */ selectedVideoBackgroundEffect: undefined,
             cameraStatus: undefined,
-            /* @conditional-compile-remove(calling-sounds) */ sounds: options === null || options === void 0 ? void 0 : options.callingSounds
+            /* @conditional-compile-remove(calling-sounds) */ sounds: options === null || options === void 0 ? void 0 : options.callingSounds,
+            /* @conditional-compile-remove(reaction) */ reactions: options === null || options === void 0 ? void 0 : options.reactionResources
         };
         this.emitter.setMaxListeners((_d = options === null || options === void 0 ? void 0 : options.maxListeners) !== null && _d !== void 0 ? _d : 50);
         this.bindPublicMethods();
-        this.displayNameModifier = (options === null || options === void 0 ? void 0 : options.onFetchProfile) ? createProfileStateModifier(options.onFetchProfile, () => {
-            this.setState(this.getState());
-        }) : undefined;
+        this.displayNameModifier = (options === null || options === void 0 ? void 0 : options.onFetchProfile)
+            ? createProfileStateModifier(options.onFetchProfile, () => {
+                this.setState(this.getState());
+            })
+            : undefined;
+    }
+    bindPublicMethods() {
+        /* @conditional-compile-remove(unsupported-browser) */
+        this.setAllowedUnsupportedBrowser.bind(this);
     }
-    bindPublicMethods() { }
     onStateChange(handler) {
         this.emitter.on('stateChanged', handler);
     }
@@ -95,25 +112,39 @@ class CallContext {
         const latestEndedCall = clientState.callsEnded ? findLatestEndedCall(clientState.callsEnded) : undefined;
         // As the state is transitioning to a new state, trigger appropriate callback events.
         const oldPage = this.state.page;
+        /* @conditional-compile-remove(unsupported-browser) */
+        const environmentInfo = {
+            environmentInfo: this.state.environmentInfo,
+            unsupportedBrowserVersionOptedIn: this.state.unsupportedBrowserVersionsAllowed
+        };
         /* @conditional-compile-remove(call-transfer) */
-        const latestAcceptedTransfer = (call === null || call === void 0 ? void 0 : call.transfer.acceptedTransfers) ? findLatestAcceptedTransfer(call.transfer.acceptedTransfers) : undefined;
+        const latestAcceptedTransfer = (call === null || call === void 0 ? void 0 : call.transfer.acceptedTransfers)
+            ? findLatestAcceptedTransfer(call.transfer.acceptedTransfers)
+            : undefined;
         /* @conditional-compile-remove(call-transfer) */
         const transferCall = latestAcceptedTransfer ? clientState.calls[latestAcceptedTransfer.callId] : undefined;
-        const newPage = getCallCompositePage(call, latestEndedCall, /* @conditional-compile-remove(call-transfer) */ transferCall);
+        const newPage = getCallCompositePage(call, latestEndedCall, 
+        /* @conditional-compile-remove(call-transfer) */ transferCall, 
+        /* @conditional-compile-remove(unsupported-browser) */ environmentInfo);
         if (!IsCallEndedPage(oldPage) && IsCallEndedPage(newPage)) {
-            this.emitter.emit('callEnded', {
-                callId: this.callId
-            });
+            this.emitter.emit('callEnded', { callId: this.callId });
             // Reset the callId to undefined as the call has ended.
             this.setCurrentCallId(undefined);
             // Make sure that the call is set to undefined in the state.
             call = undefined;
         }
         if (this.state.page) {
-            this.setState(Object.assign(Object.assign({}, this.state), { userId: clientState.userId, displayName: (_a = clientState.callAgent) === null || _a === void 0 ? void 0 : _a.displayName, call, page: newPage, endedCall: latestEndedCall, devices: clientState.deviceManager, latestErrors: clientState.latestErrors, cameraStatus: (call === null || call === void 0 ? void 0 : call.localVideoStreams.find(s => s.mediaStreamType === 'Video')) || clientState.deviceManager.unparentedViews.find(s => s.mediaStreamType === 'Video') ? 'On' : 'Off', 
+            this.setState(Object.assign(Object.assign({}, this.state), { userId: clientState.userId, displayName: (_a = clientState.callAgent) === null || _a === void 0 ? void 0 : _a.displayName, call, page: newPage, endedCall: latestEndedCall, devices: clientState.deviceManager, latestErrors: clientState.latestErrors, cameraStatus: (call === null || call === void 0 ? void 0 : call.localVideoStreams.find((s) => s.mediaStreamType === 'Video')) ||
+                    clientState.deviceManager.unparentedViews.find((s) => s.mediaStreamType === 'Video')
+                    ? 'On'
+                    : 'Off', 
                 /* @conditional-compile-remove(call-transfer) */ acceptedTransferCallState: transferCall }));
         }
     }
+    /* @conditional-compile-remove(unsupported-browser) */
+    setAllowedUnsupportedBrowser() {
+        this.setState(Object.assign(Object.assign({}, this.state), { unsupportedBrowserVersionsAllowed: true }));
+    }
     /* @conditional-compile-remove(video-background-effects) */
     setBackroundPickerImages(videoBackgroundImages) {
         this.setState(Object.assign(Object.assign({}, this.state), { videoBackgroundImages }));
@@ -181,16 +212,24 @@ export class AzureCommunicationCallAdapter {
         this.bindPublicMethods();
         this.callClient = callClient;
         this.callAgent = callAgent;
-        this.targetCallees = getLocatorOrTargetCallees(locatorOrTargetCalless) === true ? locatorOrTargetCalless : undefined;
-        this.locator = getLocatorOrTargetCallees(locatorOrTargetCalless) === false ? locatorOrTargetCalless : undefined;
+        this.targetCallees =
+            getLocatorOrTargetCallees(locatorOrTargetCalless) === true
+                ? locatorOrTargetCalless
+                : undefined;
+        this.locator =
+            getLocatorOrTargetCallees(locatorOrTargetCalless) === false
+                ? locatorOrTargetCalless
+                : undefined;
         this.deviceManager = deviceManager;
         const isTeamsMeeting = this.locator ? 'meetingLink' in this.locator : false;
         /* @conditional-compile-remove(rooms) */
         const isRoomsCall = this.locator ? 'roomId' in this.locator : false;
         /* @conditional-compile-remove(video-background-effects) */
         this.onResolveVideoBackgroundEffectsDependency = (_a = options === null || options === void 0 ? void 0 : options.videoBackgroundOptions) === null || _a === void 0 ? void 0 : _a.onResolveDependency;
-        this.context = new CallContext(callClient.getState(), isTeamsMeeting, /* @conditional-compile-remove(rooms) */ isRoomsCall, /* @conditional-compile-remove(video-background-effects) */ options, this.targetCallees);
-        this.context.onCallEnded(endCallData => this.emitter.emit('callEnded', endCallData));
+        this.context = new CallContext(callClient.getState(), isTeamsMeeting, 
+        /* @conditional-compile-remove(rooms) */ isRoomsCall, 
+        /* @conditional-compile-remove(video-background-effects) */ options, this.targetCallees);
+        this.context.onCallEnded((endCallData) => this.emitter.emit('callEnded', endCallData));
         const onStateChange = (clientState) => {
             var _a, _b, _c;
             // unsubscribe when the instance gets disposed
@@ -207,14 +246,16 @@ export class AzureCommunicationCallAdapter {
                 this.context.setCurrentCallId(this.call.id);
             }
             // If the call connects we need to clean up any previous unparentedViews
-            if ((((_b = this.call) === null || _b === void 0 ? void 0 : _b.state) === 'InLobby' || ((_c = this.call) === null || _c === void 0 ? void 0 : _c.state) === 'Connected') && this.callClient.getState().deviceManager.unparentedViews.length > 0) {
-                this.callClient.getState().deviceManager.unparentedViews.forEach(view => {
+            if ((((_b = this.call) === null || _b === void 0 ? void 0 : _b.state) === 'InLobby' || ((_c = this.call) === null || _c === void 0 ? void 0 : _c.state) === 'Connected') &&
+                this.callClient.getState().deviceManager.unparentedViews.length > 0) {
+                this.callClient.getState().deviceManager.unparentedViews.forEach((view) => {
                     this.callClient.disposeView(undefined, undefined, view);
                 });
             }
             this.context.updateClientState(clientState);
         };
-        this.handlers = createHandlers(callClient, callAgent, deviceManager, undefined, /* @conditional-compile-remove(video-background-effects) */ {
+        this.handlers = createHandlers(callClient, callAgent, deviceManager, undefined, 
+        /* @conditional-compile-remove(video-background-effects) */ {
             onResolveVideoBackgroundEffectsDependency: this.onResolveVideoBackgroundEffectsDependency
         });
         this.onClientStateChange = onStateChange;
@@ -225,7 +266,7 @@ export class AzureCommunicationCallAdapter {
             const onCallsUpdated = (args) => {
                 var _a;
                 if ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id) {
-                    const removedCall = args.removed.find(call => { var _a; return call.id === ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id); });
+                    const removedCall = args.removed.find((call) => { var _a; return call.id === ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id); });
                     if (removedCall) {
                         const removedCallState = this.callClient.getState().callsEnded[removedCall.id];
                         const latestAcceptedTransfer = findLatestAcceptedTransfer(removedCallState.transfer.acceptedTransfers);
@@ -239,6 +280,25 @@ export class AzureCommunicationCallAdapter {
             };
             this.callAgent.on('callsUpdated', onCallsUpdated);
         }
+        /* @conditional-compile-remove(teams-identity-support) */
+        if (this.callAgent.kind === 'TeamsCallAgent') {
+            const onTeamsCallsUpdated = (args) => {
+                var _a;
+                if ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id) {
+                    const removedCall = args.removed.find((call) => { var _a; return call.id === ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id); });
+                    if (removedCall) {
+                        const removedCallState = this.callClient.getState().callsEnded[removedCall.id];
+                        const latestAcceptedTransfer = findLatestAcceptedTransfer(removedCallState.transfer.acceptedTransfers);
+                        const _callAgent = callAgent;
+                        const transferCall = _callAgent.calls.find((call) => call.id === (latestAcceptedTransfer === null || latestAcceptedTransfer === void 0 ? void 0 : latestAcceptedTransfer.callId));
+                        if (transferCall) {
+                            this.processNewCall(transferCall);
+                        }
+                    }
+                }
+            };
+            this.callAgent.on('callsUpdated', onTeamsCallsUpdated);
+        }
     }
     // TODO: update this to include the 'selectedCameraChanged' when calling adds it to the device manager
     subscribeDeviceManagerEvents() {
@@ -270,8 +330,9 @@ export class AzureCommunicationCallAdapter {
         this.startCall.bind(this);
         this.startScreenShare.bind(this);
         this.stopScreenShare.bind(this);
-        /* @conditional-compile-remove(raise-hand) */
         this.raiseHand.bind(this);
+        /* @conditional-compile-remove(reaction) */
+        this.onReactionClick.bind(this);
         this.lowerHand.bind(this);
         this.removeParticipant.bind(this);
         this.createStreamView.bind(this);
@@ -282,7 +343,15 @@ export class AzureCommunicationCallAdapter {
         this.on.bind(this);
         this.off.bind(this);
         this.processNewCall.bind(this);
+        /* @conditional-compile-remove(PSTN-calls) */
+        this.addParticipant.bind(this);
+        /* @conditional-compile-remove(PSTN-calls) */
+        this.holdCall.bind(this);
+        /* @conditional-compile-remove(PSTN-calls) */
+        this.resumeCall.bind(this);
         this.sendDtmfTone.bind(this);
+        /* @conditional-compile-remove(unsupported-browser) */
+        this.allowUnsupportedBrowserVersion.bind(this);
         /* @conditional-compile-remove(close-captions) */
         {
             this.startCaptions.bind(this);
@@ -296,6 +365,14 @@ export class AzureCommunicationCallAdapter {
         this.stopVideoBackgroundEffects.bind(this);
         /* @conditional-compile-remove(video-background-effects) */
         this.updateBackgroundPickerImages.bind(this);
+        /* @conditional-compile-remove(end-of-call-survey) */
+        this.submitSurvey.bind(this);
+        /* @conditional-compile-remove(spotlight) */
+        this.startSpotlight.bind(this);
+        /* @conditional-compile-remove(spotlight) */
+        this.stopSpotlight.bind(this);
+        /* @conditional-compile-remove(spotlight) */
+        this.stopAllSpotlight.bind(this);
     }
     dispose() {
         this.resetDiagnosticsForwarder();
@@ -371,13 +448,11 @@ export class AzureCommunicationCallAdapter {
                     shouldCameraBeOnInCall = options.cameraOn;
                 }
             }
-            const audioOptions = {
-                muted: !shouldMicrophoneBeOnInCall
-            };
+            const audioOptions = { muted: !shouldMicrophoneBeOnInCall };
             const selectedCamera = getSelectedCameraFromAdapterState(this.getState());
-            const videoOptions = selectedCamera && shouldCameraBeOnInCall ? {
-                localVideoStreams: [new SDKLocalVideoStream(selectedCamera)]
-            } : {};
+            const videoOptions = selectedCamera && shouldCameraBeOnInCall
+                ? { localVideoStreams: [new SDKLocalVideoStream(selectedCamera)] }
+                : {};
             const call = this._joinCall(audioOptions, videoOptions);
             this.processNewCall(call);
             return call;
@@ -387,6 +462,16 @@ export class AzureCommunicationCallAdapter {
         const isTeamsMeeting = this.locator ? 'meetingLink' in this.locator : false;
         /* @conditional-compile-remove(rooms) */
         const isRoomsCall = this.locator ? 'roomId' in this.locator : false;
+        /* @conditional-compile-remove(teams-identity-support) */
+        if (_isTeamsCallAgent(this.callAgent)) {
+            if (!isTeamsMeeting) {
+                throw new Error('Locator not supported by TeamsCallAgent');
+            }
+            return this.callAgent.join(this.locator, {
+                audioOptions,
+                videoOptions
+            });
+        }
         if (isTeamsMeeting) {
             return this.callAgent.join(this.locator, {
                 audioOptions,
@@ -443,12 +528,13 @@ export class AzureCommunicationCallAdapter {
     leaveCall(forEveryone) {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.getState().page === 'transferring') {
-                const transferCall = this.callAgent.calls.filter(call => { var _a; return call.id === ((_a = this.getState().acceptedTransferCallState) === null || _a === void 0 ? void 0 : _a.id); })[0];
+                const transferCall = this.callAgent.calls.filter((call) => { var _a; return call.id === ((_a = this.getState().acceptedTransferCallState) === null || _a === void 0 ? void 0 : _a.id); })[0];
                 transferCall === null || transferCall === void 0 ? void 0 : transferCall.hangUp();
             }
             yield this.handlers.onHangUp(forEveryone);
             this.unsubscribeCallEvents();
-            this.handlers = createHandlers(this.callClient, this.callAgent, this.deviceManager, this.call, /* @conditional-compile-remove(video-background-effects) */ {
+            this.handlers = createHandlers(this.callClient, this.callAgent, this.deviceManager, this.call, 
+            /* @conditional-compile-remove(video-background-effects) */ {
                 onResolveVideoBackgroundEffectsDependency: this.onResolveVideoBackgroundEffectsDependency
             });
             // We set the adapter.call object to undefined immediately when a call is ended.
@@ -556,7 +642,6 @@ export class AzureCommunicationCallAdapter {
             }));
         });
     }
-    /* @conditional-compile-remove(raise-hand) */
     raiseHand() {
         return __awaiter(this, void 0, void 0, function* () {
             return yield this.asyncTeeErrorToEventEmitter(() => __awaiter(this, void 0, void 0, function* () {
@@ -564,7 +649,6 @@ export class AzureCommunicationCallAdapter {
             }));
         });
     }
-    /* @conditional-compile-remove(raise-hand) */
     lowerHand() {
         return __awaiter(this, void 0, void 0, function* () {
             return yield this.asyncTeeErrorToEventEmitter(() => __awaiter(this, void 0, void 0, function* () {
@@ -572,6 +656,19 @@ export class AzureCommunicationCallAdapter {
             }));
         });
     }
+    /* @conditional-compile-remove(reaction) */
+    onReactionClick(reaction) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.asyncTeeErrorToEventEmitter(() => __awaiter(this, void 0, void 0, function* () {
+                yield this.handlers.onReactionClick(reaction);
+            }));
+        });
+    }
+    /* @conditional-compile-remove(unsupported-browser) */
+    allowUnsupportedBrowserVersion() {
+        this.context.setAllowedUnsupportedBrowser();
+        this.context.updateClientState(this.callClient.getState());
+    }
     /* @conditional-compile-remove(video-background-effects) */
     startVideoBackgroundEffect(videoBackgroundEffect) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -607,13 +704,13 @@ export class AzureCommunicationCallAdapter {
         const isCameraOn = this.getState().cameraStatus === 'On';
         const selectedCamera = getSelectedCameraFromAdapterState(this.getState());
         /* we only configure the video options here since the Calling SDK always unmutes the participant when starting a call */
-        const startCallVideoOptions = selectedCamera ? {
-            videoOptions: isCameraOn ? {
-                localVideoStreams: [new SDKLocalVideoStream(selectedCamera)]
-            } : undefined
-        } : {};
+        const startCallVideoOptions = selectedCamera
+            ? {
+                videoOptions: isCameraOn ? { localVideoStreams: [new SDKLocalVideoStream(selectedCamera)] } : undefined
+            }
+            : {};
         const combinedCallOptions = Object.assign(Object.assign({}, startCallVideoOptions), options);
-        const idsToAdd = participants.map(participant => {
+        const idsToAdd = participants.map((participant) => {
             const backendId = _toCommunicationIdentifier(participant);
             if ('phoneNumber' in backendId) {
                 if ((options === null || options === void 0 ? void 0 : options.alternateCallerId) === undefined) {
@@ -636,7 +733,8 @@ export class AzureCommunicationCallAdapter {
         this.context.setCurrentCallId(call.id);
         // Resync state after callId is set
         this.context.updateClientState(this.callClient.getState());
-        this.handlers = createHandlers(this.callClient, this.callAgent, this.deviceManager, this.call, /* @conditional-compile-remove(video-background-effects) */ {
+        this.handlers = createHandlers(this.callClient, this.callAgent, this.deviceManager, this.call, 
+        /* @conditional-compile-remove(video-background-effects) */ {
             onResolveVideoBackgroundEffectsDependency: this.onResolveVideoBackgroundEffectsDependency
         });
         this.subscribeCallEvents();
@@ -652,9 +750,52 @@ export class AzureCommunicationCallAdapter {
     removeParticipant(userId) {
         return __awaiter(this, void 0, void 0, function* () {
             let participant = userId;
+            /* @conditional-compile-remove(PSTN-calls) */
+            participant = _toCommunicationIdentifier(userId);
             this.handlers.onRemoveParticipant(participant);
         });
     }
+    /* @conditional-compile-remove(PSTN-calls) */
+    addParticipant(participant, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (isPhoneNumberIdentifier(participant) && options) {
+                this.handlers.onAddParticipant(participant, options);
+            }
+            else if (isCommunicationUserIdentifier(participant)) {
+                this.handlers.onAddParticipant(participant);
+            }
+        });
+    }
+    /* @conditional-compile-remove(PSTN-calls) */
+    holdCall() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            if (((_a = this.call) === null || _a === void 0 ? void 0 : _a.state) !== 'LocalHold') {
+                if ((_b = this.call) === null || _b === void 0 ? void 0 : _b.isLocalVideoStarted) {
+                    this.stopCamera().then(() => {
+                        this.handlers.onToggleHold();
+                    });
+                }
+                else {
+                    this.handlers.onToggleHold();
+                }
+            }
+        });
+    }
+    /* @conditional-compile-remove(PSTN-calls) */
+    resumeCall() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (((_a = this.call) === null || _a === void 0 ? void 0 : _a.state) === 'LocalHold') {
+                this.handlers.onToggleHold().then(() => {
+                    var _a;
+                    if (((_a = this.call) === null || _a === void 0 ? void 0 : _a.feature(Features.Capabilities).capabilities.turnVideoOn.isPresent) === false) {
+                        this.stopCamera();
+                    }
+                });
+            }
+        });
+    }
     sendDtmfTone(dtmfTone) {
         return __awaiter(this, void 0, void 0, function* () {
             this.handlers.onSendDtmfTone(dtmfTone);
@@ -684,6 +825,30 @@ export class AzureCommunicationCallAdapter {
             this.handlers.onSetSpokenLanguage(language);
         });
     }
+    /* @conditional-compile-remove(end-of-call-survey) */
+    submitSurvey(survey) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.handlers.onSubmitSurvey(survey);
+        });
+    }
+    /* @conditional-compile-remove(spotlight) */
+    startSpotlight(userIds) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.handlers.onStartSpotlight(userIds);
+        });
+    }
+    /* @conditional-compile-remove(spotlight) */
+    stopSpotlight(userIds) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.handlers.onStopSpotlight(userIds);
+        });
+    }
+    /* @conditional-compile-remove(spotlight) */
+    stopAllSpotlight() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.handlers.onStopAllSpotlight();
+        });
+    }
     getState() {
         return this.context.getState();
     }
@@ -699,29 +864,53 @@ export class AzureCommunicationCallAdapter {
     }
     /* @conditional-compile-remove(close-captions) */
     subscribeToCaptionEvents() {
-        var _a;
-        if (this.call && this.call.state === 'Connected' && this.context.getState().isTeamsCall) {
-            const captionsFeature = (_a = this.call) === null || _a === void 0 ? void 0 : _a.feature(Features.Captions).captions;
-            captionsFeature.on('CaptionsReceived', this.captionsReceived.bind(this));
-            captionsFeature.on('CaptionsActiveChanged', this.isCaptionsActiveChanged.bind(this));
-            captionsFeature.on('CaptionLanguageChanged', this.isCaptionLanguageChanged.bind(this));
-            captionsFeature.on('SpokenLanguageChanged', this.isSpokenLanguageChanged.bind(this));
+        var _a, _b;
+        if (this.call && this.call.state === 'Connected') {
+            if (this.context.getState().isTeamsCall) {
+                const captionsFeature = (_a = this.call) === null || _a === void 0 ? void 0 : _a.feature(Features.Captions).captions;
+                captionsFeature.on('CaptionsReceived', this.teamsCaptionsReceived.bind(this));
+                captionsFeature.on('CaptionsActiveChanged', this.isCaptionsActiveChanged.bind(this));
+                captionsFeature.on('CaptionLanguageChanged', this.isCaptionLanguageChanged.bind(this));
+                captionsFeature.on('SpokenLanguageChanged', this.isSpokenLanguageChanged.bind(this));
+            }
+            else {
+                /* @conditional-compile-remove(acs-close-captions) */
+                const captionsFeature = (_b = this.call) === null || _b === void 0 ? void 0 : _b.feature(Features.Captions).captions;
+                /* @conditional-compile-remove(acs-close-captions) */
+                captionsFeature.on('CaptionsReceived', this.captionsReceived.bind(this));
+                /* @conditional-compile-remove(acs-close-captions) */
+                captionsFeature.on('CaptionsActiveChanged', this.isCaptionsActiveChanged.bind(this));
+                /* @conditional-compile-remove(acs-close-captions) */
+                captionsFeature.on('SpokenLanguageChanged', this.isSpokenLanguageChanged.bind(this));
+            }
         }
     }
     /* @conditional-compile-remove(close-captions) */
     unsubscribeFromCaptionEvents() {
-        var _a, _b;
-        if (this.call && this.call.state === 'Connected' && this.context.getState().isTeamsCall) {
-            const captionsFeature = (_a = this.call) === null || _a === void 0 ? void 0 : _a.feature(Features.Captions).captions;
-            captionsFeature.off('CaptionsReceived', this.captionsReceived.bind(this));
-            captionsFeature.off('CaptionsActiveChanged', this.isCaptionsActiveChanged.bind(this));
-            captionsFeature.off('CaptionLanguageChanged', this.isCaptionLanguageChanged.bind(this));
-            captionsFeature.off('SpokenLanguageChanged', this.isSpokenLanguageChanged.bind(this));
-            (_b = this.call) === null || _b === void 0 ? void 0 : _b.off('stateChanged', this.subscribeToCaptionEvents.bind(this));
+        var _a, _b, _c;
+        if (this.call && this.call.state === 'Connected') {
+            if (this.context.getState().isTeamsCall) {
+                const captionsFeature = (_a = this.call) === null || _a === void 0 ? void 0 : _a.feature(Features.Captions).captions;
+                captionsFeature.off('CaptionsReceived', this.teamsCaptionsReceived.bind(this));
+                captionsFeature.off('CaptionsActiveChanged', this.isCaptionsActiveChanged.bind(this));
+                captionsFeature.off('CaptionLanguageChanged', this.isCaptionLanguageChanged.bind(this));
+                captionsFeature.off('SpokenLanguageChanged', this.isSpokenLanguageChanged.bind(this));
+            }
+            else {
+                /* @conditional-compile-remove(acs-close-captions) */
+                const captionsFeature = (_b = this.call) === null || _b === void 0 ? void 0 : _b.feature(Features.Captions).captions;
+                /* @conditional-compile-remove(acs-close-captions) */
+                captionsFeature.off('CaptionsReceived', this.captionsReceived.bind(this));
+                /* @conditional-compile-remove(acs-close-captions) */
+                captionsFeature.off('CaptionsActiveChanged', this.isCaptionsActiveChanged.bind(this));
+                /* @conditional-compile-remove(acs-close-captions) */
+                captionsFeature.off('SpokenLanguageChanged', this.isSpokenLanguageChanged.bind(this));
+            }
+            (_c = this.call) === null || _c === void 0 ? void 0 : _c.off('stateChanged', this.subscribeToCaptionEvents.bind(this));
         }
     }
     subscribeCallEvents() {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         /* @conditional-compile-remove(calling-sounds) */
         if (this.call) {
             this.callingSoundSubscriber = new CallingSoundSubscriber(this.call, this.getState().targetCallees, this.getState().sounds);
@@ -738,6 +927,8 @@ export class AzureCommunicationCallAdapter {
         (_g = this.call) === null || _g === void 0 ? void 0 : _g.feature(Features.Transfer).on('transferAccepted', this.transferAccepted.bind(this));
         /* @conditional-compile-remove(capabilities) */
         (_h = this.call) === null || _h === void 0 ? void 0 : _h.feature(Features.Capabilities).on('capabilitiesChanged', this.capabilitiesChanged.bind(this));
+        /* @conditional-compile-remove(spotlight) */
+        (_j = this.call) === null || _j === void 0 ? void 0 : _j.feature(Features.Spotlight).on('spotlightChanged', this.spotlightChanged.bind(this));
     }
     unsubscribeCallEvents() {
         var _a, _b, _c, _d, _e;
@@ -760,19 +951,15 @@ export class AzureCommunicationCallAdapter {
     }
     onRemoteParticipantsUpdated({ added, removed }) {
         if (added && added.length > 0) {
-            this.emitter.emit('participantsJoined', {
-                joined: added
-            });
+            this.emitter.emit('participantsJoined', { joined: added });
         }
         if (removed && removed.length > 0) {
-            this.emitter.emit('participantsLeft', {
-                removed: removed
-            });
+            this.emitter.emit('participantsLeft', { removed: removed });
         }
-        added.forEach(participant => {
+        added.forEach((participant) => {
             this.participantSubscribers.set(toFlatCommunicationIdentifier(participant.identifier), new ParticipantSubscriber(participant, this.emitter));
         });
-        removed.forEach(participant => {
+        removed.forEach((participant) => {
             const subscriber = this.participantSubscribers.get(toFlatCommunicationIdentifier(participant.identifier));
             subscriber && subscriber.unsubscribeAll();
             this.participantSubscribers.delete(toFlatCommunicationIdentifier(participant.identifier));
@@ -780,15 +967,15 @@ export class AzureCommunicationCallAdapter {
     }
     isScreenSharingOnChanged() {
         var _a;
-        this.emitter.emit('isLocalScreenSharingActiveChanged', {
-            isScreenSharingOn: (_a = this.call) === null || _a === void 0 ? void 0 : _a.isScreenSharingOn
-        });
+        this.emitter.emit('isLocalScreenSharingActiveChanged', { isScreenSharingOn: (_a = this.call) === null || _a === void 0 ? void 0 : _a.isScreenSharingOn });
     }
     /* @conditional-compile-remove(close-captions) */
+    teamsCaptionsReceived(captionsInfo) {
+        this.emitter.emit('captionsReceived', { captionsInfo });
+    }
+    /* @conditional-compile-remove(acs-close-captions) */
     captionsReceived(captionsInfo) {
-        this.emitter.emit('captionsReceived', {
-            captionsInfo
-        });
+        this.emitter.emit('captionsReceived', { captionsInfo });
     }
     /* @conditional-compile-remove(close-captions) */
     isCaptionsActiveChanged() {
@@ -845,11 +1032,13 @@ export class AzureCommunicationCallAdapter {
         }
         this.emitter.emit('roleChanged');
     }
+    /* @conditional-compile-remove(spotlight) */
+    spotlightChanged(args) {
+        this.emitter.emit('spotlightChanged', args);
+    }
     callIdChanged() {
         var _a;
-        ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id) && this.emitter.emit('callIdChanged', {
-            callId: this.call.id
-        });
+        ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id) && this.emitter.emit('callIdChanged', { callId: this.call.id });
     }
     resetDiagnosticsForwarder(newCall) {
         if (this.diagnosticsForwarder) {
@@ -911,6 +1100,8 @@ export function createAzureCommunicationCallAdapter(args) {
             credential: args.credential,
             locator: args.locator,
             targetCallees: args.targetCallees,
+            /* @conditional-compile-remove(PSTN-calls) */
+            alternateCallerId: args.alternateCallerId,
             /* @conditional-compile-remove(video-background-effects) */
             options: args.options
         });
@@ -921,26 +1112,48 @@ export function createAzureCommunicationCallAdapter(args) {
  *
  * @internal
  */
-export const _createAzureCommunicationCallAdapterInner = ({ userId, displayName, credential, locator, targetCallees, 
-/* @conditional-compile-remove(video-background-effects) */ options, telemetryImplementationHint = 'Call' }) => __awaiter(void 0, void 0, void 0, function* () {
+export const _createAzureCommunicationCallAdapterInner = (_a) => __awaiter(void 0, [_a], void 0, function* ({ userId, displayName, credential, locator, targetCallees, 
+/* @conditional-compile-remove(PSTN-calls) */ alternateCallerId, 
+/* @conditional-compile-remove(video-background-effects) */ options, telemetryImplementationHint = 'Call' }) {
     if (!_isValidIdentifier(userId)) {
         throw new Error('Invalid identifier. Please provide valid identifier object.');
     }
     const callClient = _createStatefulCallClientInner({
-        userId
+        userId,
+        /* @conditional-compile-remove(PSTN-calls) */
+        alternateCallerId
     }, undefined, telemetryImplementationHint);
     const callAgent = yield callClient.createCallAgent(credential, {
         displayName
     });
     let adapter;
     if (locator) {
-        adapter = createAzureCommunicationCallAdapterFromClient(callClient, callAgent, locator, /* @conditional-compile-remove(video-background-effects) */ options);
+        adapter = createAzureCommunicationCallAdapterFromClient(callClient, callAgent, locator, 
+        /* @conditional-compile-remove(video-background-effects) */ options);
     }
     else {
-        adapter = createAzureCommunicationCallAdapterFromClient(callClient, callAgent, targetCallees, /* @conditional-compile-remove(video-background-effects) */ options);
+        adapter = createAzureCommunicationCallAdapterFromClient(callClient, callAgent, targetCallees, 
+        /* @conditional-compile-remove(video-background-effects) */ options);
     }
     return adapter;
 });
+/* @conditional-compile-remove(teams-identity-support) */
+/**
+ * @beta
+ */
+export const createTeamsCallAdapter = (_b) => __awaiter(void 0, [_b], void 0, function* ({ userId, credential, locator, options }) {
+    if (isCommunicationUserIdentifier(userId)) {
+        throw new Error('Communication User identifier is not supported by TeamsCallAdapter, please use our AzureCommunicationCallAdapter.');
+    }
+    const callClient = _createStatefulCallClientInner({
+        userId
+    }, undefined, 'Call');
+    const callAgent = yield callClient.createTeamsCallAgent(credential, {
+        undefined
+    });
+    const adapter = createTeamsCallAdapterFromClient(callClient, callAgent, locator, options);
+    return adapter;
+});
 /**
  * @private
  */
@@ -949,6 +1162,8 @@ function useAzureCommunicationCallAdapterGeneric(args, adapterKind = 'AzureCommu
     const locator = 'locator' in args ? args.locator : undefined;
     const targetCallees = 'targetCallees' in args ? args.targetCallees : undefined;
     const displayName = 'displayName' in args ? args.displayName : undefined;
+    /* @conditional-compile-remove(PSTN-calls) */
+    const alternateCallerId = 'alternateCallerId' in args ? args.alternateCallerId : undefined;
     /* @conditional-compile-remove(video-background-effects) */
     const options = 'options' in args ? args.options : undefined;
     // State update needed to rerender the parent component when a new adapter is created.
@@ -965,7 +1180,7 @@ function useAzureCommunicationCallAdapterGeneric(args, adapterKind = 'AzureCommu
     afterCreateRef.current = afterCreate;
     beforeDisposeRef.current = beforeDispose;
     useEffect(() => {
-        if (!credential || !locator && !targetCallees || !userId) {
+        if (!credential || (!locator && !targetCallees) || !userId) {
             return;
         }
         if (adapterKind === 'AzureCommunication' && !displayName) {
@@ -1001,6 +1216,7 @@ function useAzureCommunicationCallAdapterGeneric(args, adapterKind = 'AzureCommu
                         displayName: displayName,
                         locator,
                         userId: userId,
+                        /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId,
                         /* @conditional-compile-remove(video-background-effects) */ options
                     }));
                 }
@@ -1010,6 +1226,7 @@ function useAzureCommunicationCallAdapterGeneric(args, adapterKind = 'AzureCommu
                         displayName: displayName,
                         targetCallees,
                         userId: userId,
+                        /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId,
                         /* @conditional-compile-remove(video-background-effects) */ options
                     }));
                 }
@@ -1020,6 +1237,13 @@ function useAzureCommunicationCallAdapterGeneric(args, adapterKind = 'AzureCommu
                     return;
                 }
                 creatingAdapterRef.current = true;
+                /* @conditional-compile-remove(teams-identity-support) */
+                newAdapter = (yield createTeamsCallAdapter({
+                    credential,
+                    locator: locator,
+                    userId: userId,
+                    options
+                }));
             }
             else {
                 throw new Error('Unreachable code, unknown adapterKind');
@@ -1036,7 +1260,20 @@ function useAzureCommunicationCallAdapterGeneric(args, adapterKind = 'AzureCommu
         }))();
     }, 
     // Explicitly list all arguments so that caller doesn't have to memoize the `args` object.
-    [adapterRef, afterCreateRef, beforeDisposeRef, adapterKind, credential, locator, userId, displayName, options, targetCallees]);
+    [
+        adapterRef,
+        afterCreateRef,
+        beforeDisposeRef,
+        adapterKind,
+        credential,
+        locator,
+        userId,
+        displayName,
+        /* @conditional-compile-remove(PSTN-calls) */
+        alternateCallerId,
+        options,
+        targetCallees
+    ]);
     // Dispose any existing adapter when the component unmounts.
     useEffect(() => {
         return () => {
@@ -1067,9 +1304,65 @@ function useAzureCommunicationCallAdapterGeneric(args, adapterKind = 'AzureCommu
  *
  * @public
  */
-export const useAzureCommunicationCallAdapter = (args, afterCreate, beforeDispose) => {
+export const useAzureCommunicationCallAdapter = (
+/**
+ * Arguments to be passed to {@link createAzureCommunicationCallAdapter}.
+ *
+ * Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments
+ * as they are created. The adapter is only created when all arguments are defined.
+ */
+args, 
+/**
+ * Optional callback to modify the adapter once it is created.
+ *
+ * If set, must return the modified adapter.
+ */
+afterCreate, 
+/**
+ * Optional callback called before the adapter is disposed.
+ *
+ * This is useful for clean up tasks, e.g., leaving any ongoing calls.
+ */
+beforeDispose) => {
     return useAzureCommunicationCallAdapterGeneric(args, 'AzureCommunication', afterCreate, beforeDispose);
 };
+/* @conditional-compile-remove(teams-identity-support) */
+/**
+ * A custom React hook to simplify the creation of {@link TeamsCallAdapter}.
+ *
+ * Similar to {@link createTeamsAzureCommunicationCallAdapter}, but takes care of asynchronous
+ * creation of the adapter internally.
+ *
+ * Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments
+ * as they are created. The adapter is only created when all arguments are defined.
+ *
+ * Note that you must memoize the arguments to avoid recreating adapter on each render.
+ * See storybook for typical usage examples.
+ *
+ * @beta
+ */
+export const useTeamsCallAdapter = (
+/**
+ * Arguments to be passed to {@link createAzureCommunicationCallAdapter}.
+ *
+ * Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments
+ * as they are created. The adapter is only created when all arguments are defined.
+ */
+args, 
+/**
+ * Optional callback to modify the adapter once it is created.
+ *
+ * If set, must return the modified adapter.
+ */
+afterCreate, 
+/**
+ * Optional callback called before the adapter is disposed.
+ *
+ * This is useful for clean up tasks, e.g., leaving any ongoing calls.
+ */
+beforeDispose) => {
+    return useAzureCommunicationCallAdapterGeneric(args, 'Teams', afterCreate, beforeDispose);
+};
 /**
  * Create a {@link CallAdapter} using the provided {@link StatefulCallClient}.
  *
@@ -1078,21 +1371,45 @@ export const useAzureCommunicationCallAdapter = (args, afterCreate, beforeDispos
  *
  * @public
  */
-export function createAzureCommunicationCallAdapterFromClient(callClient, callAgent, locatorOrtargetCallees, /* @conditional-compile-remove(video-background-effects) */ options) {
+export function createAzureCommunicationCallAdapterFromClient(callClient, callAgent, locatorOrtargetCallees, 
+/* @conditional-compile-remove(video-background-effects) */ options) {
     return __awaiter(this, void 0, void 0, function* () {
-        const deviceManager = yield callClient.getDeviceManager();
+        const deviceManager = (yield callClient.getDeviceManager());
         yield Promise.all([deviceManager.getCameras(), deviceManager.getMicrophones()]);
         if (deviceManager.isSpeakerSelectionAvailable) {
             yield deviceManager.getSpeakers();
         }
+        /* @conditional-compile-remove(unsupported-browser) */
+        yield callClient.feature(Features.DebugInfo).getEnvironmentInfo();
         if (getLocatorOrTargetCallees(locatorOrtargetCallees)) {
-            return new AzureCommunicationCallAdapter(callClient, locatorOrtargetCallees, callAgent, deviceManager, /* @conditional-compile-remove(video-background-effects) */ options);
+            return new AzureCommunicationCallAdapter(callClient, locatorOrtargetCallees, callAgent, deviceManager, 
+            /* @conditional-compile-remove(video-background-effects) */ options);
         }
         else {
-            return new AzureCommunicationCallAdapter(callClient, locatorOrtargetCallees, callAgent, deviceManager, /* @conditional-compile-remove(video-background-effects) */ options);
+            return new AzureCommunicationCallAdapter(callClient, locatorOrtargetCallees, callAgent, deviceManager, 
+            /* @conditional-compile-remove(video-background-effects) */ options);
         }
     });
 }
+/* @conditional-compile-remove(teams-identity-support) */
+/**
+ * Create a {@link TeamsCallAdapter} using the provided {@link StatefulCallClient}.
+ *
+ * Useful if you want to keep a reference to {@link StatefulCallClient}.
+ * Consider using {@link createAzureCommunicationCallAdapter} for a simpler API.
+ *
+ * @beta
+ */
+export const createTeamsCallAdapterFromClient = (callClient, callAgent, locator, options) => __awaiter(void 0, void 0, void 0, function* () {
+    const deviceManager = (yield callClient.getDeviceManager());
+    yield Promise.all([deviceManager.getCameras(), deviceManager.getMicrophones()]);
+    if (deviceManager.isSpeakerSelectionAvailable) {
+        yield deviceManager.getSpeakers();
+    }
+    /* @conditional-compile-remove(unsupported-browser) */
+    yield callClient.feature(Features.DebugInfo).getEnvironmentInfo();
+    return new AzureCommunicationCallAdapter(callClient, locator, callAgent, deviceManager, options);
+});
 const isCallError = (e) => {
     return 'target' in e && 'innerError' in e;
 };