@azure/communication-react 1.4.0 → 1.4.2-alpha-202211010021.0

package/dist/dist-esm/react-composites/src/composites/CallComposite/Strings.d.ts

@@ -170,9 +170,129 @@ export interface CallCompositeStrings {
      * Tooltip text used to inform a user that toggling microphone in lobby is not supported.
      */
     microphoneToggleInLobbyNotAllowed: string;
+    /**
+     * Side pane People section Title.
+     */
+    peoplePaneTitle: string;
+    /**
+     * Aria label string for return to call back button
+     */
+    returnToCallButtonAriaLabel?: string;
+    /**
+     * Aria Description string for return to call button
+     */
+    returnToCallButtonAriaDescription?: string;
+    /**
+     * control bar People button label
+     */
+    peopleButtonLabel: string;
+    /**
+     * control bar Chat button label.
+     */
+    chatButtonLabel: string;
+    /**
+     * Label for SidePaneHeader dismiss button
+     */
+    dismissSidePaneButtonLabel?: string;
+    /**
+     * Side pane People section subheader.
+     */
+    peoplePaneSubTitle: string;
+    /**
+     * Label for button to copy invite link
+     */
+    copyInviteLinkButtonLabel: string;
+    /**
+     * Label for button to open dialpad
+     */
+    openDialpadButtonLabel: string;
+    /**
+     * Label for menu item to remove participant
+     */
+    removeMenuLabel: string;
+    /**
+     * Label for add people dropdown
+     */
+    peoplePaneAddPeopleButtonLabel: string;
+    /**
+     * Label for button to start a call
+     */
+    dialpadStartCallButtonLabel: string;
+    /**
+     * Title for dialpad Modal
+     */
+    dialpadModalTitle: string;
+    /**
+     * Aria Label for dialpad Modal
+     */
+    dialpadModalAriaLabel: string;
+    /**
+     * Aria Label for dialpad Modal close button
+     */
+    dialpadCloseModalButtonAriaLabel: string;
+    /**
+     * label for more button in the Calling composite
+     */
+    moreButtonCallingLabel: string;
+    /**
+     * Label for the resume call button on the hold pane
+     */
+    resumeCallButtonLabel: string;
+    /**
+     * Label for the resume call button on the hold pane when call is resuming
+     */
+    resumingCallButtonLabel: string;
+    /**
+     * Aria label for the resume call button on the hold pane
+     */
+    resumeCallButtonAriaLabel: string;
+    /**
+     * Aria label for the resume call button on the hold pane when call is resuming
+     */
+    resumingCallButtonAriaLabel: string;
+    /**
+     * Label for the hold pane
+     */
+    holdScreenLabel: string;
+    /**
+     * Placeholder text for dtmf dialpad
+     */
+    dtmfDialpadPlaceholderText: string;
+    /**
+     * Label for the button to open dtmf dialpad
+     */
+    openDtmfDialpadLabel: string;
     /**
      * aria label for when the invite link has been actioned
      */
     copyInviteLinkActionedAriaLabel: string;
+    /**
+     * Title text of the page shown to the user when the user attempts to join a room that cannot be found.
+     */
+    roomNotFoundTitle: string;
+    /**
+     * More details text of the page shown to the user when the user attempts to join a room that cannot be found.
+     */
+    roomNotFoundDetails?: string;
+    /**
+     * Title text of the page shown to the user when the user attempts to join a room to which they are not invited.
+     */
+    deniedPermissionToRoomTitle: string;
+    /**
+     * More details text of the page shown to the user when the user attempts to join a room to which they are not invited.
+     */
+    deniedPermissionToRoomDetails?: string;
+    /**
+     * Control bar People button ToolTipContent
+     */
+    peopleButtonTooltipOpen: string;
+    /**
+     * Control bar People button ToolTipContent
+     */
+    peopleButtonTooltipClose: string;
+    /**
+     * Label disaplayed on the lobby screen during a 1:1 outbound call.
+     */
+    outboundCallingNoticeString: string;
 }
 //# sourceMappingURL=Strings.d.ts.map

package/dist/dist-esm/react-composites/src/composites/CallComposite/Strings.js.map

@@ -1 +1 @@
-{"version":3,"file":"Strings.js","sourceRoot":"","sources":["../../../../../../preprocess-dist/react-composites/src/composites/CallComposite/Strings.tsx"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC"}
+{"version":3,"file":"Strings.js","sourceRoot":"","sources":["../../../../../../../react-composites/src/composites/CallComposite/Strings.tsx"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\n/**\n * Strings used by the {@link CallComposite} directly.\n *\n * This strings are in addition to those used by the components from the component library.\n *\n * @public\n */\nexport interface CallCompositeStrings {\n  /**\n   * Title of configuration page.\n   */\n  configurationPageTitle: string;\n  /**\n   * Optional 1-2 lines on the call details used on the configuration page.\n   */\n  configurationPageCallDetails?: string;\n  /**\n   * Text in button to start call in configuration page.\n   */\n  startCallButtonLabel: string;\n  /**\n   * Text in button to rejoin an ended call.\n   */\n  rejoinCallButtonLabel: string;\n  /**\n   * Placeholder text for local device settings dropdowns.\n   */\n  defaultPlaceHolder: string;\n  /**\n   * Label for camera dropdown.\n   */\n  cameraLabel: string;\n  /**\n   * Label for sound dropdown.\n   */\n  soundLabel: string;\n  /**\n   * Error shown when camera access is blocked by the browser.\n   */\n  cameraPermissionDenied: string;\n  /**\n   * Error shown when the camera is turned off.\n   */\n  cameraTurnedOff: string;\n  /**\n   * Error shown when microphone access is blocked by the browser.\n   */\n  microphonePermissionDenied: string;\n  /**\n   * Title text of the page shown to the user when joining a Teams meeting fails because meeting owner denied access.\n   */\n  failedToJoinTeamsMeetingReasonAccessDeniedTitle: string;\n  /**\n   * More details text of the page shown to the user when joining a Teams meeting fails because meeting owner denied access.\n   */\n  failedToJoinTeamsMeetingReasonAccessDeniedMoreDetails?: string;\n  /**\n   * Title text of the page shown to the user when joining a call fails due to a network problem.\n   */\n  failedToJoinCallDueToNoNetworkTitle: string;\n  /**\n   * More details text of the page shown to the user when joining a call fails due to a network problem.\n   */\n  failedToJoinCallDueToNoNetworkMoreDetails?: string;\n  /**\n   * Title text of the page shown to the user when they leave a call in the call composite.\n   */\n  leftCallTitle: string;\n  /**\n   * More details text of the page shown to the user when they leave a call in the call composite.\n   */\n  leftCallMoreDetails?: string;\n  /**\n   * Title text of the page shown to the user when they are removed from a call in the call composite.\n   */\n  removedFromCallTitle: string;\n  /**\n   * More details text of the page shown to the user when they are removed from a call in the call composite.\n   */\n  removedFromCallMoreDetails?: string;\n  /**\n   * Text shown to the user on the lobby screen when connecting to a call.\n   */\n  lobbyScreenConnectingToCallTitle: string;\n  /**\n   * Optional addition details shown to the user on the lobby screen when connection to a call.\n   */\n  lobbyScreenConnectingToCallMoreDetails?: string;\n  /**\n   * Text shown to the user on the lobby screen when waiting to be admitted to a call.\n   */\n  lobbyScreenWaitingToBeAdmittedTitle: string;\n  /**\n   * Optional additional details shown to the user on the lobby screen when waiting to be admitted to a call.\n   */\n  lobbyScreenWaitingToBeAdmittedMoreDetails?: string;\n  /**\n   * Message shown to the user when they are speaking while muted.\n   */\n  mutedMessage: string;\n  /**\n   * Text for link to MS privacy policy in Compliance Banner.\n   */\n  privacyPolicy: string;\n  /**\n   * Text for link to learn more about a specific subject.\n   */\n  learnMore: string;\n  /**\n   * Message to let user know the meeting is only being recorded (no transcription) in ComplianceBanner.\n   */\n  complianceBannerNowOnlyRecording: string;\n  /**\n   * Message to let user know the meeting is only being transcripted (no recording) in ComplianceBanner.\n   */\n  complianceBannerNowOnlyTranscription: string;\n  /**\n   * Message to let user know recording and transcription of the meeting are saved in ComplianceBanner.\n   */\n  complianceBannerRecordingAndTranscriptionSaved: string;\n  /**\n   * Message to let user know recording and transcription of the meeting have started in ComplianceBanner.\n   */\n  complianceBannerRecordingAndTranscriptionStarted: string;\n  /**\n   * Message to let user know recording and transcription of the meeting have stopped in ComplianceBanner.\n   */\n  complianceBannerRecordingAndTranscriptionStopped: string;\n  /**\n   * Message to let user know recording of the meeting is being saved in ComplianceBanner.\n   */\n  complianceBannerRecordingSaving: string;\n  /**\n   * Message to let user know recording of the meeting has started in ComplianceBanner.\n   */\n  complianceBannerRecordingStarted: string;\n  /**\n   * Message to let user know recording of the meeting has stopped in ComplianceBanner.\n   */\n  complianceBannerRecordingStopped: string;\n  /**\n   * Message to let user know they are giving consent to meeting being transcripted in ComplianceBanner.\n   */\n  complianceBannerTranscriptionConsent: string;\n  /**\n   * Message to let user know transcription of the meeting is being saved in ComplianceBanner.\n   */\n  complianceBannerTranscriptionSaving: string;\n  /**\n   * Message to let user know transcription of the meeting has started in ComplianceBanner.\n   */\n  complianceBannerTranscriptionStarted: string;\n  /**\n   * Message to let user know the transcription of the meeting has stopped in ComplianceBanner.\n   */\n  complianceBannerTranscriptionStopped: string;\n  /**\n   * Text for close button.\n   */\n  close: string;\n  /**\n   * Title text of the page shown to the user when there is intermittent network failure during a call.\n   */\n  networkReconnectTitle: string;\n  /**\n   * More details text of the page shown to the user when there is intermittent network failure during a call.\n   */\n  networkReconnectMoreDetails: string;\n  /**\n   * Tooltip text used to inform a user that toggling microphone in lobby is not supported.\n   */\n  microphoneToggleInLobbyNotAllowed: string;\n  /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Side pane People section Title.\n   */\n  peoplePaneTitle: string;\n  /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Aria label string for return to call back button\n   */\n  returnToCallButtonAriaLabel?: string;\n  /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Aria Description string for return to call button\n   */\n  returnToCallButtonAriaDescription?: string;\n  /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * control bar People button label\n   */\n  peopleButtonLabel: string;\n  /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * control bar Chat button label.\n   */\n  chatButtonLabel: string;\n  /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Label for SidePaneHeader dismiss button\n   */\n  dismissSidePaneButtonLabel?: string;\n  /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Side pane People section subheader.\n   */\n  peoplePaneSubTitle: string;\n  /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Label for button to copy invite link\n   */\n  copyInviteLinkButtonLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */\n  /**\n   * Label for button to open dialpad\n   */\n  openDialpadButtonLabel: string;\n  /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Label for menu item to remove participant\n   */\n  removeMenuLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */\n  /**\n   * Label for add people dropdown\n   */\n  peoplePaneAddPeopleButtonLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */\n  /**\n   * Label for button to start a call\n   */\n  dialpadStartCallButtonLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */\n  /**\n   * Title for dialpad Modal\n   */\n  dialpadModalTitle: string;\n  /* @conditional-compile-remove(PSTN-calls) */\n  /**\n   * Aria Label for dialpad Modal\n   */\n  dialpadModalAriaLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */\n  /**\n   * Aria Label for dialpad Modal close button\n   */\n  dialpadCloseModalButtonAriaLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */ /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * label for more button in the Calling composite\n   */\n  moreButtonCallingLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */ /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Label for the resume call button on the hold pane\n   */\n  resumeCallButtonLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */ /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Label for the resume call button on the hold pane when call is resuming\n   */\n  resumingCallButtonLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */ /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Aria label for the resume call button on the hold pane\n   */\n  resumeCallButtonAriaLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */ /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Aria label for the resume call button on the hold pane when call is resuming\n   */\n  resumingCallButtonAriaLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */ /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Label for the hold pane\n   */\n  holdScreenLabel: string;\n  /* @conditional-compile-remove(PSTN-calls) */\n  /**\n   * Placeholder text for dtmf dialpad\n   */\n  dtmfDialpadPlaceholderText: string;\n  /* @conditional-compile-remove(PSTN-calls) */\n  /**\n   * Label for the button to open dtmf dialpad\n   */\n  openDtmfDialpadLabel: string;\n  /**\n   * aria label for when the invite link has been actioned\n   */\n  copyInviteLinkActionedAriaLabel: string;\n  /* @conditional-compile-remove(rooms) */\n  /**\n   * Title text of the page shown to the user when the user attempts to join a room that cannot be found.\n   */\n  roomNotFoundTitle: string;\n  /* @conditional-compile-remove(rooms) */\n  /**\n   * More details text of the page shown to the user when the user attempts to join a room that cannot be found.\n   */\n  roomNotFoundDetails?: string;\n  /* @conditional-compile-remove(rooms) */\n  /**\n   * Title text of the page shown to the user when the user attempts to join a room to which they are not invited.\n   */\n  deniedPermissionToRoomTitle: string;\n  /* @conditional-compile-remove(rooms) */\n  /**\n   * More details text of the page shown to the user when the user attempts to join a room to which they are not invited.\n   */\n  deniedPermissionToRoomDetails?: string;\n  /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Control bar People button ToolTipContent\n   */\n  peopleButtonTooltipOpen: string;\n  /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Control bar People button ToolTipContent\n   */\n  peopleButtonTooltipClose: string;\n  /* @conditional-compile-remove(PSTN-calls) */ /* @conditional-compile-remove(one-to-n-calling) */\n  /**\n   * Label disaplayed on the lobby screen during a 1:1 outbound call.\n   */\n  outboundCallingNoticeString: string;\n}\n"]}

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

@@ -1,8 +1,10 @@
 import { StatefulCallClient, StatefulDeviceManager } from "../../../../../calling-stateful-client/src";
 import { CallAgent, Call, GroupCallLocator, TeamsMeetingLinkLocator, AudioDeviceInfo, VideoDeviceInfo, PermissionConstraints, PropertyChangedEvent, StartCallOptions } from '@azure/communication-calling';
+import { RoomCallLocator } from '@azure/communication-calling';
+import { AddPhoneNumberOptions, DtmfTone } from '@azure/communication-calling';
 import { CallAdapter, CallEndedListener, CallIdChangedListener, CallAdapterState, DisplayNameChangedListener, IsMutedChangedListener, IsLocalScreenSharingActiveChangedListener, IsSpeakingChangedListener, ParticipantsJoinedListener, ParticipantsLeftListener, DiagnosticChangedEventListner } from './CallAdapter';
 import { CreateVideoStreamViewResult, VideoStreamOptions } from "../../../../../react-components/src";
-import { CommunicationTokenCredential, CommunicationUserIdentifier, CommunicationIdentifier } from '@azure/communication-common';
+import { CommunicationTokenCredential, CommunicationUserIdentifier, PhoneNumberIdentifier, CommunicationIdentifier } from '@azure/communication-common';
 import { AdapterError } from '../../common/adapters';
 /**
  * @private
@@ -46,7 +48,12 @@ export declare class AzureCommunicationCallAdapter implements CallAdapter {
     stopScreenShare(): Promise<void>;
     startCall(participants: string[] | CommunicationIdentifier[], options?: StartCallOptions): Call | undefined;
     private processNewCall;
-    removeParticipant(userId: string): Promise<void>;
+    removeParticipant(userId: string | /* @conditional-compile-remove(PSTN-calls) */ CommunicationIdentifier): Promise<void>;
+    addParticipant(participant: PhoneNumberIdentifier, options?: AddPhoneNumberOptions): Promise<void>;
+    addParticipant(participant: CommunicationUserIdentifier): Promise<void>;
+    holdCall(): Promise<void>;
+    resumeCall(): Promise<void>;
+    sendDtmfTone(dtmfTone: DtmfTone): Promise<void>;
     getState(): CallAdapterState;
     onStateChange(handler: (state: CallAdapterState) => void): void;
     offStateChange(handler: (state: CallAdapterState) => void): void;
@@ -84,12 +91,28 @@ export declare class AzureCommunicationCallAdapter implements CallAdapter {
     private asyncTeeErrorToEventEmitter;
     private teeErrorToEventEmitter;
 }
+/**
+ * Locator used by {@link createAzureCommunicationCallAdapter} to call one or more participants
+ *
+ * @remarks
+ * This is currently in beta and only supports calling one Teams User.
+ *
+ * @example
+ * ```
+ * ['8:orgid:ab220efe-5725-4742-9792-9fba7c9ac458']
+ * ```
+ *
+ * @beta
+ */
+export declare type CallParticipantsLocator = {
+    participantIds: string[];
+};
 /**
  * Locator used by {@link createAzureCommunicationCallAdapter} to locate the call to join
  *
  * @public
  */
-export declare type CallAdapterLocator = TeamsMeetingLinkLocator | GroupCallLocator;
+export declare type CallAdapterLocator = TeamsMeetingLinkLocator | GroupCallLocator | /* @conditional-compile-remove(rooms) */ RoomCallLocator | /* @conditional-compile-remove(teams-adhoc-call) */ /* @conditional-compile-remove(PSTN-calls) */ CallParticipantsLocator;
 /**
  * Arguments for creating the Azure Communication Services implementation of {@link CallAdapter}.
  *
@@ -102,6 +125,7 @@ export declare type AzureCommunicationCallAdapterArgs = {
     displayName: string;
     credential: CommunicationTokenCredential;
     locator: CallAdapterLocator;
+    alternateCallerId?: string;
 };
 /**
  * Create a {@link CallAdapter} backed by Azure Communication Services.
@@ -112,7 +136,7 @@ export declare type AzureCommunicationCallAdapterArgs = {
  *
  * @public
  */
-export declare const createAzureCommunicationCallAdapter: ({ userId, displayName, credential, locator }: AzureCommunicationCallAdapterArgs) => Promise<CallAdapter>;
+export declare const createAzureCommunicationCallAdapter: ({ userId, displayName, credential, locator, alternateCallerId }: AzureCommunicationCallAdapterArgs) => Promise<CallAdapter>;
 /**
  * A custom React hook to simplify the creation of {@link CallAdapter}.
  *

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

@@ -1,3 +1,5 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -7,8 +9,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT license.
 import { createDefaultCallingHandlers, _isInCall } from "../../../../../calling-component-bindings/src";
 import { createStatefulCallClient } from "../../../../../calling-stateful-client/src";
 import { EventEmitter } from 'events';
@@ -31,7 +31,8 @@ class CallContext {
             call: undefined,
             page: 'configuration',
             latestErrors: clientState.latestErrors,
-            isTeamsCall
+            isTeamsCall,
+            /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId: clientState.alternateCallerId
         };
     }
     onStateChange(handler) {
@@ -49,7 +50,8 @@ class CallContext {
     }
     setIsLocalMicrophoneEnabled(isLocalPreviewMicrophoneEnabled) {
         this.setState(Object.assign(Object.assign({}, this.state), { isLocalPreviewMicrophoneEnabled }));
-    } // This is the key to find current call object in client state
+    }
+    // This is the key to find current call object in client state
     setCurrentCallId(callId) {
         this.callId = callId;
     }
@@ -62,14 +64,15 @@ class CallContext {
     updateClientState(clientState) {
         var _a;
         let call = this.callId ? clientState.calls[this.callId] : undefined;
-        const latestEndedCall = findLatestEndedCall(clientState.callsEnded); // As the state is transitioning to a new state, trigger appropriate callback events.
+        const latestEndedCall = findLatestEndedCall(clientState.callsEnded);
+        // As the state is transitioning to a new state, trigger appropriate callback events.
         const oldPage = this.state.page;
         const newPage = getCallCompositePage(call, latestEndedCall);
         if (!IsCallEndedPage(oldPage) && IsCallEndedPage(newPage)) {
-            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.
+            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) {
@@ -110,16 +113,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;
         this.context = new CallContext(callClient.getState(), isTeamsMeeting);
-        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
             if (!this) {
                 callClient.offStateChange(onStateChange);
                 return;
-            } // `updateClientState` searches for the current call from all the calls in the state using a cached `call.id`
+            }
+            // `updateClientState` searches for the current call from all the calls in the state using a cached `call.id`
             // from the call object. `call.id` can change during a call. We must update the cached `call.id` before
             // calling `updateClientState` so that we find the correct state object for the call even when `call.id`
             // has changed.
@@ -133,7 +137,7 @@ export class AzureCommunicationCallAdapter {
         this.onClientStateChange = onStateChange;
         this.subscribeDeviceManagerEvents();
         this.callClient.onStateChange(onStateChange);
-    } // TODO: update this to include the 'selectedCameraChanged' when calling adds it to the device manager
+    }
     get call() {
         return this._call;
     }
@@ -141,6 +145,7 @@ export class AzureCommunicationCallAdapter {
         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', () => {
             this.emitter.emit('selectedMicrophoneChanged');
@@ -176,6 +181,14 @@ 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);
+        /* @conditional-compile-remove(PSTN-calls) */
+        this.sendDtmfTone.bind(this);
     }
     dispose() {
         this.resetDiagnosticsForwarder();
@@ -216,25 +229,41 @@ 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)
-            }; // TODO: find a way to expose stream to here
-            const videoOptions = {
-                localVideoStreams: this.localStream ? [this.localStream] : undefined
-            };
+            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 };
+            /* @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;
         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
@@ -264,7 +293,8 @@ export class AzureCommunicationCallAdapter {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.handlers.onHangUp(forEveryone);
             this.unsubscribeCallEvents();
-            this.handlers = createDefaultCallingHandlers(this.callClient, this.callAgent, this.deviceManager, undefined); // We set the adapter.call object to undefined immediately when a call is ended.
+            this.handlers = createDefaultCallingHandlers(this.callClient, this.callAgent, this.deviceManager, undefined);
+            // We set the adapter.call object to undefined immediately when a call is ended.
             // We do not set the context.callId to undefined because it is a part of the immutable data flow loop.
             this.call = undefined;
             this.stopCamera();
@@ -357,7 +387,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) => {
             // 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);
@@ -381,7 +411,8 @@ export class AzureCommunicationCallAdapter {
     }
     processNewCall(call) {
         this.call = call;
-        this.context.setCurrentCallId(call.id); // Resync state after callId is set
+        this.context.setCurrentCallId(call.id);
+        // Resync state after callId is set
         this.context.updateClientState(this.callClient.getState());
         this.handlers = createDefaultCallingHandlers(this.callClient, this.callAgent, this.deviceManager, this.call);
         this.subscribeCallEvents();
@@ -389,9 +420,46 @@ 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() {
+        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);
+        });
+    }
     getState() {
         return this.context.getState();
     }
@@ -401,6 +469,7 @@ export class AzureCommunicationCallAdapter {
     offStateChange(handler) {
         this.context.offStateChange(handler);
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     on(event, listener) {
         this.emitter.on(event, listener);
     }
@@ -429,10 +498,10 @@ export class AzureCommunicationCallAdapter {
         if (removed && removed.length > 0) {
             this.emitter.emit('participantsLeft', 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));
@@ -440,15 +509,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 });
     }
     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) {
@@ -458,6 +523,7 @@ export class AzureCommunicationCallAdapter {
             this.diagnosticsForwarder = new DiagnosticsForwarder(this.emitter, newCall);
         }
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     off(event, listener) {
         this.emitter.off(event, listener);
     }
@@ -495,9 +561,11 @@ 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 }) => __awaiter(void 0, void 0, void 0, function* () {
     const callClient = createStatefulCallClient({
-        userId
+        userId,
+        /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId
     });
     const callAgent = yield callClient.createCallAgent(credential, {
         displayName
@@ -519,12 +587,34 @@ export const createAzureCommunicationCallAdapter = ({ userId, displayName, crede
  *
  * @public
  */
-export const useAzureCommunicationCallAdapter = (args, afterCreate, beforeDispose) => {
-    const { credential, displayName, locator, userId } = args; // 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.
+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) => {
+    const { credential, displayName, locator, userId, /*@conditional-compile-remove(PSTN-calls) */ alternateCallerId } = args;
+    // 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.
     const adapterRef = useRef(undefined);
     const afterCreateRef = useRef(undefined);
-    const beforeDisposeRef = useRef(undefined); // These refs are updated on *each* render, so that the latest values
+    const beforeDisposeRef = useRef(undefined);
+    // These refs are updated on *each* render, so that the latest values
     // are used in the `useEffect` closures below.
     // Using a Ref ensures that new values for the callbacks do not trigger the
     // useEffect blocks, and a new adapter creation / distruction is not triggered.
@@ -551,7 +641,8 @@ export const useAzureCommunicationCallAdapter = (args, afterCreate, beforeDispos
                 credential,
                 displayName,
                 locator,
-                userId
+                userId,
+                /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId
             });
             if (afterCreateRef.current) {
                 newAdapter = yield afterCreateRef.current(newAdapter);
@@ -559,8 +650,19 @@ export const useAzureCommunicationCallAdapter = (args, afterCreate, beforeDispos
             adapterRef.current = newAdapter;
             setAdapter(newAdapter);
         }))();
-    }, // Explicitly list all arguments so that caller doesn't have to memoize the `args` object.
-    [adapterRef, afterCreateRef, beforeDisposeRef, credential, displayName, locator, userId]); // Dispose any existing adapter when the component unmounts.
+    }, 
+    // Explicitly list all arguments so that caller doesn't have to memoize the `args` object.
+    [
+        adapterRef,
+        afterCreateRef,
+        /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId,
+        beforeDisposeRef,
+        credential,
+        displayName,
+        locator,
+        userId
+    ]);
+    // Dispose any existing adapter when the component unmounts.
     useEffect(() => {
         return () => {
             (() => __awaiter(void 0, void 0, void 0, function* () {
@@ -585,10 +687,15 @@ export const useAzureCommunicationCallAdapter = (args, afterCreate, beforeDispos
  * @public
  */
 export const createAzureCommunicationCallAdapterFromClient = (callClient, callAgent, locator) => __awaiter(void 0, void 0, void 0, function* () {
-    const deviceManager = yield callClient.getDeviceManager();
+    const deviceManager = (yield callClient.getDeviceManager());
     return new AzureCommunicationCallAdapter(callClient, locator, callAgent, deviceManager);
 });
 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