@azure/communication-react 1.11.0-beta.1 → 1.11.1-alpha-202312160012

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

@@ -10,8 +10,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { compositeLogger } from '../../../Logger';
-import { _isInCall } from "../../../../../calling-component-bindings/src";
-import { createStatefulCallClient } from "../../../../../calling-stateful-client/src";
+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';
@@ -32,9 +32,13 @@ import { createProfileStateModifier } from './OnFetchProfileCallback';
 /* @conditional-compile-remove(video-background-effects) */
 import { getBackgroundEffectFromSelectedEffect } from '../utils';
 import { getSelectedCameraFromAdapterState } from '../utils';
+/* @conditional-compile-remove(calling-sounds) */
+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) {
+    constructor(clientState, isTeamsCall, 
+    /* @conditional-compile-remove(rooms) */
+    isRoomsCall, options) {
         var _a, _b, _c, _d;
         this.emitter = new EventEmitter();
         this.state = {
@@ -43,6 +47,7 @@ class CallContext {
             displayName: (_a = clientState.callAgent) === null || _a === void 0 ? void 0 : _a.displayName,
             devices: clientState.deviceManager,
             call: undefined,
+            /* @conditional-compile-remove(calling-sounds) */ targetCallees: undefined,
             page: 'configuration',
             latestErrors: clientState.latestErrors,
             isTeamsCall,
@@ -54,13 +59,16 @@ class CallContext {
             /* @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
+            cameraStatus: undefined,
+            /* @conditional-compile-remove(calling-sounds) */ sounds: options === null || options === void 0 ? void 0 : options.callingSounds
         };
         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) */
@@ -86,6 +94,10 @@ class CallContext {
     setCurrentCallId(callId) {
         this.callId = callId;
     }
+    /* @conditional-compile-remove(calling-sounds) */
+    setTargetCallee(targetCallees) {
+        this.setState(Object.assign(Object.assign({}, this.state), { targetCallees }));
+    }
     onCallEnded(handler) {
         this.emitter.on('callEnded', handler);
     }
@@ -104,21 +116,26 @@ class CallContext {
             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(unsupported-browser) */ environmentInfo, /* @conditional-compile-remove(call-transfer) */ transferCall);
+        const newPage = getCallCompositePage(call, latestEndedCall, 
+        /* @conditional-compile-remove(unsupported-browser) */ environmentInfo, 
+        /* @conditional-compile-remove(call-transfer) */ transferCall);
         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 }));
         }
     }
@@ -172,6 +189,13 @@ const findLatestAcceptedTransfer = (acceptedTransfers) => {
  * @private
  */
 export class AzureCommunicationCallAdapter {
+    get call() {
+        return this._call;
+    }
+    set call(newCall) {
+        this.resetDiagnosticsForwarder(newCall);
+        this._call = newCall;
+    }
     constructor(callClient, locator, callAgent, deviceManager, options) {
         var _a;
         this.participantSubscribers = new Map();
@@ -188,15 +212,17 @@ export class AzureCommunicationCallAdapter {
         this.callAgent = callAgent;
         this.locator = locator;
         this.deviceManager = deviceManager;
-        const isTeamsMeeting = ('meetingLink' in this.locator);
+        const isTeamsMeeting = 'meetingLink' in this.locator;
         /* @conditional-compile-remove(rooms) */
-        const isRoomsCall = ('roomId' in this.locator);
+        const isRoomsCall = 'roomId' in this.locator;
         /* @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.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.context.onCallEnded((endCallData) => this.emitter.emit('callEnded', endCallData));
         const onStateChange = (clientState) => {
-            var _a, _b;
+            var _a, _b, _c, _d;
             // unsubscribe when the instance gets disposed
             if (!this) {
                 callClient.offStateChange(onStateChange);
@@ -210,6 +236,13 @@ export class AzureCommunicationCallAdapter {
             if ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id) {
                 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) => {
+                    this.callClient.disposeView(undefined, undefined, view);
+                });
+            }
             this.context.updateClientState(clientState);
             /* @conditional-compile-remove(call-transfer) */
             const acceptedTransferCallState = this.context.getState().acceptedTransferCallState;
@@ -217,9 +250,12 @@ export class AzureCommunicationCallAdapter {
             // TODO: Remove this if statement when Calling SDK prevents accepting transfer requests that have timed out
             // This is to handle the case when there has been an accepted transfer call that is now in the connected state
             // AND is not the current call. Ensure we leave the current call.
-            if (acceptedTransferCallState && acceptedTransferCallState.state === 'Connected' && ((_b = this.call) === null || _b === void 0 ? void 0 : _b.id) && acceptedTransferCallState.id !== this.call.id) {
+            if (acceptedTransferCallState &&
+                acceptedTransferCallState.state === 'Connected' &&
+                ((_d = this.call) === null || _d === void 0 ? void 0 : _d.id) &&
+                acceptedTransferCallState.id !== this.call.id) {
                 const cAgent = callAgent;
-                const transferCall = cAgent.calls.find(call => call.id === acceptedTransferCallState.id);
+                const transferCall = cAgent.calls.find((call) => call.id === acceptedTransferCallState.id);
                 if (transferCall) {
                     const oldCall = this.call;
                     this.processNewCall(transferCall);
@@ -234,7 +270,8 @@ export class AzureCommunicationCallAdapter {
                 }
             }
         };
-        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;
@@ -245,7 +282,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);
@@ -263,7 +300,7 @@ export class AzureCommunicationCallAdapter {
             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); });
+                    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);
@@ -278,13 +315,6 @@ export class AzureCommunicationCallAdapter {
             this.callAgent.on('callsUpdated', onTeamsCallsUpdated);
         }
     }
-    get call() {
-        return this._call;
-    }
-    set call(newCall) {
-        this.resetDiagnosticsForwarder(newCall);
-        this._call = newCall;
-    }
     // TODO: update this to include the 'selectedCameraChanged' when calling adds it to the device manager
     subscribeDeviceManagerEvents() {
         this.deviceManager.on('selectedMicrophoneChanged', () => {
@@ -351,6 +381,8 @@ 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);
     }
     dispose() {
         this.resetDiagnosticsForwarder();
@@ -423,21 +455,17 @@ 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)] }
+                : {};
             /* @conditional-compile-remove(teams-adhoc-call) */
             /* @conditional-compile-remove(PSTN-calls) */
             if (isOutboundCall(this.locator)) {
                 const phoneNumber = this.getState().alternateCallerId;
                 return this.startCall(this.locator.participantIds, {
-                    alternateCallerId: phoneNumber ? {
-                        phoneNumber: phoneNumber
-                    } : undefined,
+                    alternateCallerId: phoneNumber ? { phoneNumber: phoneNumber } : undefined,
                     audioOptions,
                     videoOptions
                 });
@@ -448,9 +476,9 @@ export class AzureCommunicationCallAdapter {
         });
     }
     _joinCall(audioOptions, videoOptions) {
-        const isTeamsMeeting = ('meetingLink' in this.locator);
+        const isTeamsMeeting = 'meetingLink' in this.locator;
         /* @conditional-compile-remove(rooms) */
-        const isRoomsCall = ('roomId' in this.locator);
+        const isRoomsCall = 'roomId' in this.locator;
         /* @conditional-compile-remove(teams-identity-support) */
         if (_isTeamsCallAgent(this.callAgent)) {
             if (!isTeamsMeeting) {
@@ -518,7 +546,8 @@ export class AzureCommunicationCallAdapter {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.handlers.onHangUp(forEveryone);
             this.unsubscribeCallEvents();
-            this.handlers = createHandlers(this.callClient, this.callAgent, this.deviceManager, undefined, /* @conditional-compile-remove(video-background-effects) */ {
+            this.handlers = createHandlers(this.callClient, this.callAgent, this.deviceManager, undefined, 
+            /* @conditional-compile-remove(video-background-effects) */ {
                 onResolveVideoBackgroundEffectsDependency: this.onResolveVideoBackgroundEffectsDependency
             });
             // We set the adapter.call object to undefined immediately when a call is ended.
@@ -598,9 +627,9 @@ export class AzureCommunicationCallAdapter {
     unmute() {
         return __awaiter(this, void 0, void 0, function* () {
             return yield this.asyncTeeErrorToEventEmitter(() => __awaiter(this, void 0, void 0, function* () {
-                var _a, _b;
+                var _a, _b, _c;
                 this.context.setIsLocalMicrophoneEnabled(true);
-                if (_isInCall((_a = this.call) === null || _a === void 0 ? void 0 : _a.state) && ((_b = this.call) === null || _b === void 0 ? void 0 : _b.isMuted)) {
+                if ((_isInCall((_a = this.call) === null || _a === void 0 ? void 0 : _a.state) || _isInLobbyOrConnecting((_b = this.call) === null || _b === void 0 ? void 0 : _b.state)) && ((_c = this.call) === null || _c === void 0 ? void 0 : _c.isMuted)) {
                     yield this.handlers.onToggleMicrophone();
                 }
             }));
@@ -679,7 +708,7 @@ export class AzureCommunicationCallAdapter {
         if (_isInCall((_b = (_a = this.getState().call) === null || _a === void 0 ? void 0 : _a.state) !== null && _b !== void 0 ? _b : 'None')) {
             throw new Error('You are already in the call.');
         }
-        const idsToAdd = participants.map(participant => {
+        const idsToAdd = participants.map((participant) => {
             let backendId = participant;
             if (typeof participant === 'string') {
                 backendId = _toCommunicationIdentifier(participant);
@@ -692,6 +721,8 @@ export class AzureCommunicationCallAdapter {
             }
             return backendId;
         });
+        /* @conditional-compile-remove(calling-sounds) */
+        this.context.setTargetCallee(idsToAdd);
         const call = this.handlers.onStartCall(idsToAdd, options);
         if (!call) {
             throw new Error('Unable to start call.');
@@ -704,7 +735,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();
@@ -750,7 +782,12 @@ export class AzureCommunicationCallAdapter {
         var _a;
         return __awaiter(this, void 0, void 0, function* () {
             if (((_a = this.call) === null || _a === void 0 ? void 0 : _a.state) === 'LocalHold') {
-                this.handlers.onToggleHold();
+                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();
+                    }
+                });
             }
         });
     }
@@ -784,6 +821,12 @@ 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);
+        });
+    }
     getState() {
         return this.context.getState();
     }
@@ -821,20 +864,26 @@ export class AzureCommunicationCallAdapter {
         }
     }
     subscribeCallEvents() {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        /* @conditional-compile-remove(calling-sounds) */
+        if (this.call) {
+            this.callingSoundSubscriber = new CallingSoundSubscriber(this.call, this.getState().targetCallees, this.getState().sounds);
+        }
         (_a = this.call) === null || _a === void 0 ? void 0 : _a.on('remoteParticipantsUpdated', this.onRemoteParticipantsUpdated.bind(this));
         (_b = this.call) === null || _b === void 0 ? void 0 : _b.on('isMutedChanged', this.isMyMutedChanged.bind(this));
         (_c = this.call) === null || _c === void 0 ? void 0 : _c.on('isScreenSharingOnChanged', this.isScreenSharingOnChanged.bind(this));
         (_d = this.call) === null || _d === void 0 ? void 0 : _d.on('idChanged', this.callIdChanged.bind(this));
         /* @conditional-compile-remove(close-captions) */
         (_e = this.call) === null || _e === void 0 ? void 0 : _e.on('stateChanged', this.subscribeToCaptionEvents.bind(this));
+        /* @conditional-compile-remove(rooms) */
+        (_f = this.call) === null || _f === void 0 ? void 0 : _f.on('roleChanged', this.roleChanged.bind(this));
         /* @conditional-compile-remove(call-transfer) */
-        (_f = this.call) === null || _f === void 0 ? void 0 : _f.feature(Features.Transfer).on('transferRequested', this.transferRequested.bind(this));
+        (_g = this.call) === null || _g === void 0 ? void 0 : _g.feature(Features.Transfer).on('transferRequested', this.transferRequested.bind(this));
         /* @conditional-compile-remove(capabilities) */
-        (_g = this.call) === null || _g === void 0 ? void 0 : _g.feature(Features.Capabilities).on('capabilitiesChanged', this.capabilitiesChanged.bind(this));
+        (_h = this.call) === null || _h === void 0 ? void 0 : _h.feature(Features.Capabilities).on('capabilitiesChanged', this.capabilitiesChanged.bind(this));
     }
     unsubscribeCallEvents() {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         for (const subscriber of this.participantSubscribers.values()) {
             subscriber.unsubscribeAll();
         }
@@ -843,24 +892,26 @@ export class AzureCommunicationCallAdapter {
         (_b = this.call) === null || _b === void 0 ? void 0 : _b.off('isMutedChanged', this.isMyMutedChanged.bind(this));
         (_c = this.call) === null || _c === void 0 ? void 0 : _c.off('isScreenSharingOnChanged', this.isScreenSharingOnChanged.bind(this));
         (_d = this.call) === null || _d === void 0 ? void 0 : _d.off('idChanged', this.callIdChanged.bind(this));
+        /* @conditional-compile-remove(rooms) */
+        (_e = this.call) === null || _e === void 0 ? void 0 : _e.off('roleChanged', this.roleChanged.bind(this));
         /* @conditional-compile-remove(close-captions) */
         this.unsubscribeFromCaptionEvents();
+        /* @conditional-compile-remove(calling-sounds) */
+        if (this.callingSoundSubscriber) {
+            this.callingSoundSubscriber.unsubscribeAll();
+        }
     }
     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));
@@ -868,15 +919,11 @@ 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) */
     captionsReceived(captionsInfo) {
-        this.emitter.emit('captionsReceived', {
-            captionsInfo
-        });
+        this.emitter.emit('captionsReceived', { captionsInfo });
     }
     /* @conditional-compile-remove(close-captions) */
     isCaptionsActiveChanged() {
@@ -911,32 +958,43 @@ export class AzureCommunicationCallAdapter {
                     audioOptions: (_d = options === null || options === void 0 ? void 0 : options.audioOptions) !== null && _d !== void 0 ? _d : {
                         muted: !!((_e = this.context.getState().call) === null || _e === void 0 ? void 0 : _e.isMuted)
                     },
-                    videoOptions: (_f = options === null || options === void 0 ? void 0 : options.videoOptions) !== null && _f !== void 0 ? _f : ( /* maintain video state if options.videoOptions is not defined */videoSource ? {
-                        localVideoStreams: [new LocalVideoStream(videoSource)]
-                    } : undefined)
+                    videoOptions: (_f = options === null || options === void 0 ? void 0 : options.videoOptions) !== null && _f !== void 0 ? _f : 
+                    /* maintain video state if options.videoOptions is not defined */
+                    (videoSource ? { localVideoStreams: [new LocalVideoStream(videoSource)] } : undefined)
                 });
             } });
         this.emitter.emit('transferRequested', newArgs);
     }
     /* @conditional-compile-remove(capabilities) */
     capabilitiesChanged(data) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         if (((_a = data.newValue.turnVideoOn) === null || _a === void 0 ? void 0 : _a.isPresent) === false) {
-            this.stopCamera();
+            // Only stop camera when the call state is not on hold. The Calling SDK does not allow us to stop camera when
+            // the call state is on hold.
+            if (((_b = this.call) === null || _b === void 0 ? void 0 : _b.state) !== 'LocalHold' && ((_c = this.call) === null || _c === void 0 ? void 0 : _c.state) !== 'RemoteHold') {
+                this.stopCamera();
+            }
+            this.disposeLocalVideoStreamView();
         }
-        if (((_b = data.newValue.unmuteMic) === null || _b === void 0 ? void 0 : _b.isPresent) === false) {
+        if (((_d = data.newValue.unmuteMic) === null || _d === void 0 ? void 0 : _d.isPresent) === false) {
             this.mute();
         }
-        if (((_c = data.newValue.shareScreen) === null || _c === void 0 ? void 0 : _c.isPresent) === false) {
+        if (((_e = data.newValue.shareScreen) === null || _e === void 0 ? void 0 : _e.isPresent) === false) {
             this.stopScreenShare();
         }
         this.emitter.emit('capabilitiesChanged', data);
     }
+    /* @conditional-compile-remove(rooms) */
+    roleChanged() {
+        var _a, _b;
+        if (((_a = this.call) === null || _a === void 0 ? void 0 : _a.role) === 'Consumer') {
+            (_b = this.call) === null || _b === void 0 ? void 0 : _b.feature(Features.RaiseHand).lowerHand();
+        }
+        this.emitter.emit('roleChanged');
+    }
     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) {
@@ -987,17 +1045,38 @@ export class AzureCommunicationCallAdapter {
 export const createAzureCommunicationCallAdapter = ({ userId, displayName, credential, locator, 
 /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId, 
 /* @conditional-compile-remove(video-background-effects) */ options }) => __awaiter(void 0, void 0, void 0, function* () {
+    return _createAzureCommunicationCallAdapterInner({
+        userId,
+        displayName,
+        credential,
+        locator,
+        /* @conditional-compile-remove(PSTN-calls) */
+        alternateCallerId,
+        /* @conditional-compile-remove(video-background-effects) */
+        options
+    });
+});
+/**
+ * This inner function is used to allow injection of TelemetryImplementationHint without changing the public API.
+ *
+ * @internal
+ */
+export const _createAzureCommunicationCallAdapterInner = ({ userId, displayName, credential, locator, 
+/* @conditional-compile-remove(PSTN-calls) */ alternateCallerId, 
+/* @conditional-compile-remove(video-background-effects) */ options, telemetryImplementationHint = 'Call' }) => __awaiter(void 0, void 0, void 0, function* () {
     if (!_isValidIdentifier(userId)) {
         throw new Error('Invalid identifier. Please provide valid identifier object.');
     }
-    const callClient = createStatefulCallClient({
+    const callClient = _createStatefulCallClientInner({
         userId,
-        /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId
-    });
+        /* @conditional-compile-remove(PSTN-calls) */
+        alternateCallerId
+    }, undefined, telemetryImplementationHint);
     const callAgent = yield callClient.createCallAgent(credential, {
         displayName
     });
-    const adapter = createAzureCommunicationCallAdapterFromClient(callClient, callAgent, locator, /* @conditional-compile-remove(video-background-effects) */ options);
+    const adapter = createAzureCommunicationCallAdapterFromClient(callClient, callAgent, locator, 
+    /* @conditional-compile-remove(video-background-effects) */ options);
     return adapter;
 });
 /* @conditional-compile-remove(teams-identity-support) */
@@ -1005,9 +1084,9 @@ export const createAzureCommunicationCallAdapter = ({ userId, displayName, crede
  * @beta
  */
 export const createTeamsCallAdapter = ({ userId, credential, locator, options }) => __awaiter(void 0, void 0, void 0, function* () {
-    const callClient = createStatefulCallClient({
+    const callClient = _createStatefulCallClientInner({
         userId
-    });
+    }, undefined, 'Call');
     const callAgent = yield callClient.createTeamsCallAgent(credential, {
         undefined
     });
@@ -1106,9 +1185,20 @@ const useAzureCommunicationCallAdapterGeneric = (args, afterCreate, beforeDispos
         }))();
     }, 
     // Explicitly list all arguments so that caller doesn't have to memoize the `args` object.
-    [adapterRef, afterCreateRef, beforeDisposeRef, adapterKind, credential, locator, userId, displayName,
+    [
+        adapterRef,
+        afterCreateRef,
+        beforeDisposeRef,
+        adapterKind,
+        credential,
+        locator,
+        userId,
+        displayName,
+        /* @conditional-compile-remove(PSTN-calls) */
         alternateCallerId,
-        options]);
+        /* @conditional-compile-remove(teams-identity-support) */
+        options
+    ]);
     // Dispose any existing adapter when the component unmounts.
     useEffect(() => {
         return () => {
@@ -1139,7 +1229,26 @@ const useAzureCommunicationCallAdapterGeneric = (args, afterCreate, beforeDispos
  *
  * @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, afterCreate, beforeDispose, 'AzureCommunication');
 };
 /* @conditional-compile-remove(teams-identity-support) */
@@ -1157,7 +1266,26 @@ export const useAzureCommunicationCallAdapter = (args, afterCreate, beforeDispos
  *
  * @beta
  */
-export const useTeamsCallAdapter = (args, afterCreate, beforeDispose) => {
+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, afterCreate, beforeDispose, 'Teams');
 };
 /**
@@ -1169,14 +1297,15 @@ export const useTeamsCallAdapter = (args, afterCreate, beforeDispose) => {
  * @public
  */
 export const createAzureCommunicationCallAdapterFromClient = (callClient, callAgent, locator, options) => __awaiter(void 0, 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();
-    return new AzureCommunicationCallAdapter(callClient, locator, callAgent, deviceManager, /* @conditional-compile-remove(video-background-effects) */ options);
+    return new AzureCommunicationCallAdapter(callClient, locator, callAgent, deviceManager, 
+    /* @conditional-compile-remove(video-background-effects) */ options);
 });
 /* @conditional-compile-remove(teams-identity-support) */
 /**
@@ -1188,7 +1317,7 @@ export const createAzureCommunicationCallAdapterFromClient = (callClient, callAg
  * @beta
  */
 export const createTeamsCallAdapterFromClient = (callClient, callAgent, locator, options) => __awaiter(void 0, 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();