@azure/communication-react 1.6.0 → 1.6.1-alpha-202306230016

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

@@ -9,10 +9,20 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+import { compositeLogger } from '../../../Logger';
 import { _isInCall } from "../../../../../calling-component-bindings/src";
 import { createStatefulCallClient } 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(call-transfer) */
+import { LocalVideoStream } from '@azure/communication-calling';
+/* @conditional-compile-remove(unsupported-browser) */
+import { Features } from '@azure/communication-calling';
 import { EventEmitter } from 'events';
 import { getCallCompositePage, IsCallEndedPage, isCameraOn } from '../utils';
+/* @conditional-compile-remove(close-captions) */
+import { _isTeamsMeetingCall } from "../../../../../calling-stateful-client/src";
 import { toFlatCommunicationIdentifier, _toCommunicationIdentifier, _isValidIdentifier } from "../../../../../acs-ui-common/src";
 import { isCommunicationUserIdentifier, isPhoneNumberIdentifier } from '@azure/communication-common';
 import { ParticipantSubscriber } from './ParticipantSubcriber';
@@ -20,6 +30,8 @@ import { DiagnosticsForwarder } from './DiagnosticsForwarder';
 import { useEffect, useRef, useState } from 'react';
 import { createHandlers } from './createHandlers';
 import { createProfileStateModifier } from './OnFetchProfileCallback';
+/* @conditional-compile-remove(video-background-effects) */
+import { getBackgroundEffectFromSelectedEffect, getSelectedCameraFromAdapterState } from '../utils';
 /** Context of call, which is a centralized context for all state updates */
 class CallContext {
     constructor(clientState, isTeamsCall, options) {
@@ -34,15 +46,26 @@ class CallContext {
             page: 'configuration',
             latestErrors: clientState.latestErrors,
             isTeamsCall,
+            /* @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(rooms) */ roleHint: options === null || options === void 0 ? void 0 : options.roleHint,
+            /* @conditional-compile-remove(video-background-effects) */ videoBackgroundImages: options === null || options === void 0 ? void 0 : options.videoBackgroundImages,
+            /* @conditional-compile-remove(video-background-effects) */ selectedVideoBackgroundEffect: undefined,
             cameraStatus: undefined
         };
         this.emitter.setMaxListeners((_b = options === null || options === void 0 ? void 0 : options.maxListeners) !== null && _b !== void 0 ? _b : 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);
     }
@@ -75,20 +98,51 @@ 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;
-        const newPage = getCallCompositePage(call, latestEndedCall);
+        /* @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;
+        /* @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);
         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 }));
+    }
+    /* @conditional-compile-remove(video-background-effects) */
+    setSelectedVideoBackgroundEffect(selectedVideoBackgroundEffect) {
+        this.setState(Object.assign(Object.assign({}, this.state), { selectedVideoBackgroundEffect }));
+    }
+    /* @conditional-compile-remove(call-transfer) */
+    setAcceptedTransferCall(call) {
+        this.setState(Object.assign(Object.assign({}, this.state), { acceptedTransferCallState: call }));
+    }
 }
 const findLatestEndedCall = (calls) => {
     var _a, _b, _c, _d;
@@ -104,6 +158,21 @@ const findLatestEndedCall = (calls) => {
     }
     return latestCall;
 };
+/* @conditional-compile-remove(call-transfer) */
+const findLatestAcceptedTransfer = (acceptedTransfers) => {
+    var _a, _b, _c, _d;
+    const acceptedTransferValues = Object.values(acceptedTransfers);
+    if (acceptedTransferValues.length === 0) {
+        return undefined;
+    }
+    let latestAcceptedTransfer = acceptedTransferValues[0];
+    for (const acceptedTransfer of acceptedTransferValues.slice(1)) {
+        if (((_b = (_a = acceptedTransfer.timestamp) === null || _a === void 0 ? void 0 : _a.getTime()) !== null && _b !== void 0 ? _b : 0) > ((_d = (_c = latestAcceptedTransfer.timestamp) === null || _c === void 0 ? void 0 : _c.getTime()) !== null && _d !== void 0 ? _d : 0)) {
+            latestAcceptedTransfer = acceptedTransfer;
+        }
+    }
+    return latestAcceptedTransfer;
+};
 /**
  * @private
  */
@@ -123,9 +192,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;
+        /* @conditional-compile-remove(rooms) */
+        // to prevent showing components that depend on role such as local video tile, camera button, etc. in a rooms call
+        // we set the default roleHint as 'Consumer' when roleHint is undefined since it has the lowest level of permissions
+        if (isRoomsCall && (options === null || options === void 0 ? void 0 : options.roleHint) === undefined) {
+            options = Object.assign(Object.assign({}, options), { roleHint: 'Consumer' });
+        }
         this.context = new CallContext(callClient.getState(), isTeamsMeeting, options);
-        this.context.onCallEnded(endCallData => this.emitter.emit('callEnded', endCallData));
+        this.context.onCallEnded((endCallData) => this.emitter.emit('callEnded', endCallData));
         const onStateChange = (clientState) => {
             var _a;
             // unsubscribe when the instance gets disposed
@@ -147,6 +224,43 @@ export class AzureCommunicationCallAdapter {
         this.onClientStateChange = onStateChange;
         this.subscribeDeviceManagerEvents();
         this.callClient.onStateChange(onStateChange);
+        /* @conditional-compile-remove(call-transfer) */
+        if (this.callAgent.kind === 'CallAgent') {
+            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); });
+                    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', onCallsUpdated);
+        }
+        else 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);
+        }
     }
     get call() {
         return this._call;
@@ -188,9 +302,35 @@ export class AzureCommunicationCallAdapter {
         this.removeParticipant.bind(this);
         this.createStreamView.bind(this);
         this.disposeStreamView.bind(this);
+        this.disposeScreenShareStreamView.bind(this);
+        this.disposeRemoteVideoStreamView.bind(this);
+        this.disposeLocalVideoStreamView.bind(this);
         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);
+        /* @conditional-compile-remove(PSTN-calls) */
+        this.sendDtmfTone.bind(this);
+        /* @conditional-compile-remove(unsupported-browser) */
+        this.allowUnsupportedBrowserVersion.bind(this);
+        /* @conditional-compile-remove(close-captions) */
+        {
+            this.startCaptions.bind(this);
+            this.stopCaptions.bind(this);
+            this.setSpokenLanguage.bind(this);
+            this.setCaptionLanguage.bind(this);
+        }
+        /* @conditional-compile-remove(video-background-effects) */
+        this.startVideoBackgroundEffect.bind(this);
+        /* @conditional-compile-remove(video-background-effects) */
+        this.stopVideoBackgroundEffects.bind(this);
+        /* @conditional-compile-remove(video-background-effects) */
+        this.updateBackgroundPickerImages.bind(this);
     }
     dispose() {
         this.resetDiagnosticsForwarder();
@@ -199,29 +339,44 @@ export class AzureCommunicationCallAdapter {
     }
     queryCameras() {
         return __awaiter(this, void 0, void 0, function* () {
+            const startTime = new Date().getTime();
             return yield this.asyncTeeErrorToEventEmitter(() => __awaiter(this, void 0, void 0, function* () {
-                return this.deviceManager.getCameras();
+                const cameras = yield this.deviceManager.getCameras();
+                const endTime = new Date().getTime();
+                compositeLogger.info('time to query cameras', endTime - startTime, 'ms');
+                return cameras;
             }));
         });
     }
     queryMicrophones() {
         return __awaiter(this, void 0, void 0, function* () {
+            const startTime = new Date().getTime();
             return yield this.asyncTeeErrorToEventEmitter(() => __awaiter(this, void 0, void 0, function* () {
-                return this.deviceManager.getMicrophones();
+                const microphones = yield this.deviceManager.getMicrophones();
+                const endTime = new Date().getTime();
+                compositeLogger.info('time to query microphones', endTime - startTime, 'ms');
+                return microphones;
             }));
         });
     }
     querySpeakers() {
         return __awaiter(this, void 0, void 0, function* () {
+            const startTime = new Date().getTime();
             return yield this.asyncTeeErrorToEventEmitter(() => __awaiter(this, void 0, void 0, function* () {
-                return this.deviceManager.isSpeakerSelectionAvailable ? this.deviceManager.getSpeakers() : [];
+                const speakers = (yield this.deviceManager.isSpeakerSelectionAvailable) ? this.deviceManager.getSpeakers() : [];
+                const endTime = new Date().getTime();
+                compositeLogger.info('time to query speakers', endTime - startTime, 'ms');
+                return speakers;
             }));
         });
     }
     askDevicePermission(constrain) {
         return __awaiter(this, void 0, void 0, function* () {
+            const startTime = new Date().getTime();
             return yield this.asyncTeeErrorToEventEmitter(() => __awaiter(this, void 0, void 0, function* () {
                 yield this.deviceManager.askDevicePermission(constrain);
+                const endTime = new Date().getTime();
+                compositeLogger.info('time to query askDevicePermissions', endTime - startTime, 'ms');
             }));
         });
     }
@@ -231,26 +386,51 @@ export class AzureCommunicationCallAdapter {
             throw new Error('You are already in the call!');
         }
         return this.teeErrorToEventEmitter(() => {
-            const audioOptions = {
-                muted: !(microphoneOn !== null && microphoneOn !== void 0 ? microphoneOn : this.getState().isLocalPreviewMicrophoneEnabled)
-            };
+            const audioOptions = { muted: !(microphoneOn !== null && microphoneOn !== void 0 ? microphoneOn : this.getState().isLocalPreviewMicrophoneEnabled) };
             // TODO: find a way to expose stream to here
-            const videoOptions = {
-                localVideoStreams: this.localStream ? [this.localStream] : undefined
-            };
+            const videoOptions = { localVideoStreams: this.localStream ? [this.localStream] : undefined };
+            /* @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,
+                    audioOptions,
+                    videoOptions
+                });
+            }
             const call = this._joinCall(audioOptions, videoOptions);
             this.processNewCall(call);
             return call;
         });
     }
     _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;
+        /* @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,
                 videoOptions
             });
         }
+        /* @conditional-compile-remove(rooms) */
+        if (isRoomsCall) {
+            return this.callAgent.join(this.locator, {
+                audioOptions,
+                videoOptions
+            });
+        }
         return this.callAgent.join(this.locator, {
             audioOptions,
             videoOptions
@@ -276,6 +456,21 @@ export class AzureCommunicationCallAdapter {
             }
         });
     }
+    disposeScreenShareStreamView(remoteUserId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.handlers.onDisposeRemoteScreenShareStreamView(remoteUserId);
+        });
+    }
+    disposeRemoteVideoStreamView(remoteUserId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.handlers.onDisposeRemoteVideoStreamView(remoteUserId);
+        });
+    }
+    disposeLocalVideoStreamView() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.handlers.onDisposeLocalStreamView();
+        });
+    }
     leaveCall(forEveryone) {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.handlers.onHangUp(forEveryone);
@@ -315,6 +510,21 @@ export class AzureCommunicationCallAdapter {
                 if (!isCameraOn(this.getState())) {
                     // First kick off the effect on the local device before starting the camera in the call.
                     // This prevents the effect not being applied for a brief moment when the camera is started.
+                    /* @conditional-compile-remove(video-background-effects) */
+                    {
+                        const selectedEffect = this.getState().selectedVideoBackgroundEffect;
+                        const selectedCamera = getSelectedCameraFromAdapterState(this.getState());
+                        if (selectedEffect && selectedCamera) {
+                            const stream = new SDKLocalVideoStream(selectedCamera);
+                            const effect = getBackgroundEffectFromSelectedEffect(selectedEffect);
+                            if (effect) {
+                                yield stream.feature(Features.VideoEffects).startEffects(effect);
+                            }
+                            else {
+                                yield stream.feature(Features.VideoEffects).stopEffects();
+                            }
+                        }
+                    }
                     yield this.handlers.onToggleCamera(options);
                 }
             }));
@@ -371,12 +581,44 @@ export class AzureCommunicationCallAdapter {
             }));
         });
     }
+    /* @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* () {
+            if (this.isBlurEffect(videoBackgroundEffect)) {
+                const blurConfig = videoBackgroundEffect;
+                yield this.handlers.onBlurVideoBackground(blurConfig);
+            }
+            else if (this.isReplacementEffect(videoBackgroundEffect)) {
+                const replaceConfig = videoBackgroundEffect;
+                yield this.handlers.onReplaceVideoBackground(replaceConfig);
+            }
+        });
+    }
+    /* @conditional-compile-remove(video-background-effects) */
+    stopVideoBackgroundEffects() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.handlers.onRemoveVideoBackgroundEffects();
+        });
+    }
+    /* @conditional-compile-remove(video-background-effects) */
+    updateBackgroundPickerImages(backgroundImages) {
+        this.context.setBackroundPickerImages(backgroundImages);
+    }
+    /* @conditional-compile-remove(video-background-effects) */
+    updateSelectedVideoBackgroundEffect(selectedVideoBackground) {
+        this.context.setSelectedVideoBackgroundEffect(selectedVideoBackground);
+    }
     startCall(participants, options) {
         var _a, _b;
         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) => {
             // FIXME: `onStartCall` does not allow a Teams user.
             // Need some way to return an error if a Teams user is provided.
             const backendId = _toCommunicationIdentifier(participant);
@@ -406,12 +648,81 @@ export class AzureCommunicationCallAdapter {
         this.handlers = createHandlers(this.callClient, this.callAgent, this.deviceManager, this.call);
         this.subscribeCallEvents();
     }
+    /* @conditional-compile-remove(video-background-effects) */
+    isBlurEffect(effect) {
+        return effect.effectName === 'blur';
+    }
+    /* @conditional-compile-remove(video-background-effects) */
+    isReplacementEffect(effect) {
+        return effect.effectName === 'replacement';
+    }
     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() {
+        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();
+            }
+        });
+    }
+    /* @conditional-compile-remove(PSTN-calls) */
+    resumeCall() {
+        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();
+            }
+        });
+    }
+    /* @conditional-compile-remove(PSTN-calls) */
+    sendDtmfTone(dtmfTone) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.handlers.onSendDtmfTone(dtmfTone);
+        });
+    }
+    /* @conditional-compile-remove(close-captions) */
+    startCaptions(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.handlers.onStartCaptions(options);
+        });
+    }
+    /* @conditional-compile-remove(close-captions) */
+    stopCaptions() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.handlers.onStopCaptions();
+        });
+    }
+    /* @conditional-compile-remove(close-captions) */
+    setCaptionLanguage(language) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.handlers.onSetCaptionLanguage(language);
+        });
+    }
+    /* @conditional-compile-remove(close-captions) */
+    setSpokenLanguage(language) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.handlers.onSetSpokenLanguage(language);
+        });
+    }
     getState() {
         return this.context.getState();
     }
@@ -425,12 +736,34 @@ export class AzureCommunicationCallAdapter {
     on(event, listener) {
         this.emitter.on(event, listener);
     }
+    /* @conditional-compile-remove(close-captions) */
+    subscribeToCaptionEvents() {
+        var _a, _b, _c;
+        if (this.call && this.call.state === 'Connected' && _isTeamsMeetingCall(this.call)) {
+            (_a = this.call) === null || _a === void 0 ? void 0 : _a.feature(Features.TeamsCaptions).on('captionsReceived', this.captionsReceived.bind(this));
+            (_b = this.call) === null || _b === void 0 ? void 0 : _b.feature(Features.TeamsCaptions).on('isCaptionsActiveChanged', this.isCaptionsActiveChanged.bind(this));
+            (_c = this.call) === null || _c === void 0 ? void 0 : _c.off('stateChanged', this.subscribeToCaptionEvents.bind(this));
+        }
+    }
+    /* @conditional-compile-remove(close-captions) */
+    unsubscribeFromCaptionEvents() {
+        var _a, _b, _c;
+        if (this.call && this.call.state === 'Connected' && _isTeamsMeetingCall(this.call)) {
+            (_a = this._call) === null || _a === void 0 ? void 0 : _a.feature(Features.TeamsCaptions).off('captionsReceived', this.captionsReceived.bind(this));
+            (_b = this._call) === null || _b === void 0 ? void 0 : _b.feature(Features.TeamsCaptions).off('isCaptionsActiveChanged', this.isCaptionsActiveChanged.bind(this));
+            (_c = this.call) === null || _c === void 0 ? void 0 : _c.off('stateChanged', this.subscribeToCaptionEvents.bind(this));
+        }
+    }
     subscribeCallEvents() {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e, _f;
         (_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(call-transfer) */
+        (_f = this.call) === null || _f === void 0 ? void 0 : _f.feature(Features.Transfer).on('transferRequested', this.transferRequested.bind(this));
     }
     unsubscribeCallEvents() {
         var _a, _b, _c, _d;
@@ -442,22 +775,20 @@ 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(close-captions) */
+        this.unsubscribeFromCaptionEvents();
     }
     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));
@@ -465,15 +796,38 @@ 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 });
+    }
+    /* @conditional-compile-remove(close-captions) */
+    isCaptionsActiveChanged() {
+        var _a;
+        this.emitter.emit('isCaptionsActiveChanged', {
+            isActive: (_a = this.call) === null || _a === void 0 ? void 0 : _a.feature(Features.TeamsCaptions).isCaptionsFeatureActive
         });
     }
+    /* @conditional-compile-remove(call-transfer) */
+    transferRequested(args) {
+        const newArgs = Object.assign(Object.assign({}, args), { accept: (options) => {
+                var _a, _b, _c, _d, _e, _f;
+                const videoSource = (_c = (_b = (_a = this.context.getState().call) === null || _a === void 0 ? void 0 : _a.localVideoStreams) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.source;
+                args.accept({
+                    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)
+                });
+            } });
+        this.emitter.emit('transferRequested', newArgs);
+    }
     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) {
@@ -521,17 +875,35 @@ export class AzureCommunicationCallAdapter {
  *
  * @public
  */
-export const createAzureCommunicationCallAdapter = ({ userId, displayName, credential, locator }) => __awaiter(void 0, void 0, void 0, function* () {
+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* () {
     if (!_isValidIdentifier(userId)) {
         throw new Error('Invalid identifier. Please provide valid identifier object.');
     }
     const callClient = createStatefulCallClient({
-        userId
+        userId,
+        /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId
     });
     const callAgent = yield callClient.createCallAgent(credential, {
         displayName
     });
-    const adapter = createAzureCommunicationCallAdapterFromClient(callClient, callAgent, locator);
+    const adapter = createAzureCommunicationCallAdapterFromClient(callClient, callAgent, locator, 
+    /* @conditional-compile-remove(video-background-effects) */ options);
+    return adapter;
+});
+/* @conditional-compile-remove(teams-identity-support) */
+/**
+ * @beta
+ */
+export const createTeamsCallAdapter = ({ userId, credential, locator, options }) => __awaiter(void 0, void 0, void 0, function* () {
+    const callClient = createStatefulCallClient({
+        userId
+    });
+    const callAgent = yield callClient.createTeamsCallAgent(credential, {
+        undefined
+    });
+    const adapter = createTeamsCallAdapterFromClient(callClient, callAgent, locator, options);
     return adapter;
 });
 /**
@@ -540,6 +912,10 @@ export const createAzureCommunicationCallAdapter = ({ userId, displayName, crede
 const useAzureCommunicationCallAdapterGeneric = (args, afterCreate, beforeDispose, adapterKind = 'AzureCommunication') => {
     const { credential, locator, userId } = args;
     const displayName = 'displayName' in args ? args.displayName : undefined;
+    /* @conditional-compile-remove(PSTN-calls) */
+    const alternateCallerId = 'alternateCallerId' in args ? args.alternateCallerId : undefined;
+    /* @conditional-compile-remove(rooms) */
+    const options = 'options' in args ? args.options : undefined;
     // State update needed to rerender the parent component when a new adapter is created.
     const [adapter, setAdapter] = useState(undefined);
     // Ref needed for cleanup to access the old adapter created asynchronously.
@@ -580,6 +956,10 @@ const useAzureCommunicationCallAdapterGeneric = (args, afterCreate, beforeDispos
                     throw new Error('Unreachable code, displayName already checked above.');
                 }
                 // This is just the type check to ensure that roleHint is defined.
+                /* @conditional-compile-remove(rooms) */
+                if (options && !('roleHint' in options)) {
+                    throw new Error('Unreachable code, provided a options without roleHint.');
+                }
                 if (creatingAdapterRef.current) {
                     console.warn('Adapter is already being created, please see storybook for more information: https://azure.github.io/communication-ui-library/?path=/story/troubleshooting--page');
                     return;
@@ -589,7 +969,9 @@ const useAzureCommunicationCallAdapterGeneric = (args, afterCreate, beforeDispos
                     credential,
                     displayName: displayName,
                     locator,
-                    userId: userId
+                    userId: userId,
+                    /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId,
+                    /* @conditional-compile-remove(rooms) */ options
                 }));
             }
             else if (adapterKind === 'Teams') {
@@ -598,6 +980,13 @@ const useAzureCommunicationCallAdapterGeneric = (args, afterCreate, beforeDispos
                     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');
@@ -614,7 +1003,21 @@ 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,
+        /* @conditional-compile-remove(rooms) */
+        /* @conditional-compile-remove(teams-identity-support) */
+        options
+    ]);
     // Dispose any existing adapter when the component unmounts.
     useEffect(() => {
         return () => {
@@ -645,9 +1048,65 @@ 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) */
+/**
+ * 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, afterCreate, beforeDispose, 'Teams');
+};
 /**
  * Create a {@link CallAdapter} using the provided {@link StatefulCallClient}.
  *
@@ -657,10 +1116,33 @@ export const useAzureCommunicationCallAdapter = (args, afterCreate, beforeDispos
  * @public
  */
 export const createAzureCommunicationCallAdapterFromClient = (callClient, callAgent, locator, options) => __awaiter(void 0, void 0, void 0, function* () {
-    const deviceManager = yield callClient.getDeviceManager();
-    return new AzureCommunicationCallAdapter(callClient, locator, callAgent, deviceManager);
+    const deviceManager = (yield callClient.getDeviceManager());
+    /* @conditional-compile-remove(unsupported-browser) */
+    yield callClient.feature(Features.DebugInfo).getEnvironmentInfo();
+    return new AzureCommunicationCallAdapter(callClient, locator, callAgent, deviceManager, 
+    /* @conditional-compile-remove(rooms) */ 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());
+    /* @conditional-compile-remove(unsupported-browser) */
+    yield callClient.feature(Features.DebugInfo).getEnvironmentInfo();
+    return new AzureCommunicationCallAdapter(callClient, locator, callAgent, deviceManager, options);
 });
 const isCallError = (e) => {
     return e['target'] !== undefined && e['innerError'] !== undefined;
 };
+/* @conditional-compile-remove(teams-adhoc-call) */
+/* @conditional-compile-remove(PSTN-calls) */
+const isOutboundCall = (callLocator) => {
+    return 'participantIds' in callLocator;
+};
 //# sourceMappingURL=AzureCommunicationCallAdapter.js.map