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

package/dist/dist-esm/react-composites/src/composites/CallWithChatComposite/adapter/AzureCommunicationCallWithChatAdapter.d.ts

@@ -1,15 +1,26 @@
 import { AudioDeviceInfo, Call, CallAgent, GroupCallLocator, PermissionConstraints, PropertyChangedEvent, TeamsMeetingLinkLocator, StartCallOptions, VideoDeviceInfo } from '@azure/communication-calling';
+import { StartCaptionsOptions } from '@azure/communication-calling';
+import { AddPhoneNumberOptions, DtmfTone } from '@azure/communication-calling';
 import { CreateVideoStreamViewResult, VideoStreamOptions } from "../../../../../react-components/src";
+import { AttachmentDownloadResult } from "../../../../../react-components/src";
+import { FileMetadata } from "../../../../../react-components/src";
 import { ParticipantsJoinedListener, ParticipantsLeftListener, IsMutedChangedListener, CallIdChangedListener, IsLocalScreenSharingActiveChangedListener, DisplayNameChangedListener, IsSpeakingChangedListener, CallAdapter, CallEndedListener } from '../../CallComposite';
 import { MessageReceivedListener, MessageReadListener, ChatAdapter, ParticipantsRemovedListener, ParticipantsAddedListener } from '../../ChatComposite';
+import { FileUploadManager } from '../../ChatComposite';
 import { CallWithChatAdapter } from './CallWithChatAdapter';
 import { CallWithChatAdapterState } from '../state/CallWithChatAdapterState';
+import { AzureCommunicationChatAdapterOptions } from '../../ChatComposite/adapter/AzureCommunicationChatAdapter';
 import { CommunicationTokenCredential, CommunicationUserIdentifier } from '@azure/communication-common';
+import { CommunicationIdentifier, PhoneNumberIdentifier } from '@azure/communication-common';
 import { AdapterError } from '../../common/adapters';
+import { CallParticipantsLocator } from '../../CallComposite/adapter/AzureCommunicationCallAdapter';
 import { CallAdapterLocator } from '../../CallComposite/adapter/AzureCommunicationCallAdapter';
 import { StatefulCallClient } from "../../../../../calling-stateful-client/src";
 import { StatefulChatClient } from "../../../../../chat-stateful-client/src";
 import { ChatThreadClient } from '@azure/communication-chat';
+import { AzureCommunicationCallAdapterOptions } from '../../CallComposite/adapter/AzureCommunicationCallAdapter';
+import { IsCaptionsActiveChangedListener, CaptionsReceivedListener } from '../../CallComposite/adapter/CallAdapter';
+import { VideoBackgroundImage, VideoBackgroundEffect } from '../../CallComposite';
 /**
  * CallWithChat adapter backed by Azure Communication Services.
  * Created for easy use with the {@link CallWithChatComposite}.
@@ -27,7 +38,7 @@ export declare class AzureCommunicationCallWithChatAdapter implements CallWithCh
     /** Leave current Call. */
     leaveCall(forEveryone?: boolean): Promise<void>;
     /** Start a new Call. */
-    startCall(participants: string[], options?: StartCallOptions): Call | undefined;
+    startCall(participants: string[] | /* @conditional-compile-remove(PSTN-calls) */ CommunicationIdentifier[], options?: StartCallOptions): Call | undefined;
     /**
      * Subscribe to state change events.
      * @param handler - handler to be called when the state changes. This is passed the new state.
@@ -43,7 +54,7 @@ export declare class AzureCommunicationCallWithChatAdapter implements CallWithCh
     /** Dispose of the current CallWithChatAdapter. */
     dispose(): void;
     /** Remove a participant from the Call only. */
-    removeParticipant(userId: string): Promise<void>;
+    removeParticipant(userId: string | /* @conditional-compile-remove(PSTN-calls) */ CommunicationIdentifier): Promise<void>;
     setCamera(device: VideoDeviceInfo, options?: VideoStreamOptions): Promise<void>;
     /** Set the microphone to be used in the Call. */
     setMicrophone(device: AudioDeviceInfo): Promise<void>;
@@ -72,6 +83,12 @@ export declare class AzureCommunicationCallWithChatAdapter implements CallWithCh
     createStreamView(remoteUserId?: string, options?: VideoStreamOptions): Promise<void | CreateVideoStreamViewResult>;
     /** Dispose of a created stream view of a remote participants video feed. */
     disposeStreamView(remoteUserId?: string, options?: VideoStreamOptions): Promise<void>;
+    /** Dispose of a remote screen share */
+    disposeScreenShareStreamView(remoteUserId: string): Promise<void>;
+    /** Dispose of a remote video stream */
+    disposeRemoteVideoStreamView(remoteUserId: string): Promise<void>;
+    /** Dispose of the local video stream */
+    disposeLocalVideoStreamView(): Promise<void>;
     /** Fetch initial Call and Chat data such as chat messages. */
     fetchInitialData(): Promise<void>;
     /** Send a chat message. */
@@ -86,6 +103,30 @@ export declare class AzureCommunicationCallWithChatAdapter implements CallWithCh
     updateMessage(messageId: string, content: string, metadata?: Record<string, string>): Promise<void>;
     /** Delete an existing message. */
     deleteMessage(messageId: string): Promise<void>;
+    registerActiveFileUploads: (files: File[]) => FileUploadManager[];
+    registerCompletedFileUploads: (metadata: FileMetadata[]) => FileUploadManager[];
+    clearFileUploads: () => void;
+    cancelFileUpload: (id: string) => void;
+    updateFileUploadProgress: (id: string, progress: number) => void;
+    updateFileUploadErrorMessage: (id: string, errorMessage: string) => void;
+    updateFileUploadMetadata: (id: string, metadata: FileMetadata) => void;
+    downloadAttachments(options: {
+        attachmentUrls: string[];
+    }): Promise<AttachmentDownloadResult[]>;
+    holdCall(): Promise<void>;
+    resumeCall(): Promise<void>;
+    addParticipant(participant: PhoneNumberIdentifier, options?: AddPhoneNumberOptions): Promise<void>;
+    addParticipant(participant: CommunicationUserIdentifier): Promise<void>;
+    sendDtmfTone(dtmfTone: DtmfTone): Promise<void>;
+    allowUnsupportedBrowserVersion(): void;
+    startCaptions(options?: StartCaptionsOptions): Promise<void>;
+    stopCaptions(): Promise<void>;
+    setCaptionLanguage(language: string): Promise<void>;
+    setSpokenLanguage(language: string): Promise<void>;
+    startVideoBackgroundEffect(videoBackgroundEffect: VideoBackgroundEffect): Promise<void>;
+    stopVideoBackgroundEffects(): Promise<void>;
+    updateBackgroundPickerImages(backgroundImages: VideoBackgroundImage[]): void;
+    updateSelectedVideoBackgroundEffect(selectedVideoBackground: VideoBackgroundEffect): void;
     on(event: 'callParticipantsJoined', listener: ParticipantsJoinedListener): void;
     on(event: 'callParticipantsLeft', listener: ParticipantsLeftListener): void;
     on(event: 'callEnded', listener: CallEndedListener): void;
@@ -103,6 +144,8 @@ export declare class AzureCommunicationCallWithChatAdapter implements CallWithCh
     on(event: 'selectedMicrophoneChanged', listener: PropertyChangedEvent): void;
     on(event: 'selectedSpeakerChanged', listener: PropertyChangedEvent): void;
     on(event: 'chatError', listener: (e: AdapterError) => void): void;
+    on(event: 'captionsReceived', listener: CaptionsReceivedListener): void;
+    on(event: 'isCaptionsActiveChanged', listener: IsCaptionsActiveChangedListener): void;
     off(event: 'callParticipantsJoined', listener: ParticipantsJoinedListener): void;
     off(event: 'callParticipantsLeft', listener: ParticipantsLeftListener): void;
     off(event: 'callEnded', listener: CallEndedListener): void;
@@ -120,6 +163,8 @@ export declare class AzureCommunicationCallWithChatAdapter implements CallWithCh
     off(event: 'chatParticipantsAdded', listener: ParticipantsAddedListener): void;
     off(event: 'chatParticipantsRemoved', listener: ParticipantsRemovedListener): void;
     off(event: 'chatError', listener: (e: AdapterError) => void): void;
+    off(event: 'captionsReceived', listener: CaptionsReceivedListener): void;
+    off(event: 'isCaptionsActiveChanged', listener: IsCaptionsActiveChangedListener): void;
 }
 /**
  * Arguments for use in {@link createAzureCommunicationCallWithChatAdapter} to join a Call with an associated Chat thread.
@@ -128,7 +173,7 @@ export declare class AzureCommunicationCallWithChatAdapter implements CallWithCh
  */
 export interface CallAndChatLocator {
     /** Locator used by {@link createAzureCommunicationCallWithChatAdapter} to locate the call to join */
-    callLocator: GroupCallLocator;
+    callLocator: GroupCallLocator | /* @conditional-compile-remove(teams-adhoc-call) */ CallParticipantsLocator;
     /** Chat thread ID used by {@link createAzureCommunicationCallWithChatAdapter} to locate the chat thread to join */
     chatThreadId: string;
 }
@@ -143,6 +188,8 @@ export declare type AzureCommunicationCallWithChatAdapterArgs = {
     displayName: string;
     credential: CommunicationTokenCredential;
     locator: CallAndChatLocator | TeamsMeetingLinkLocator;
+    alternateCallerId?: string;
+    callAdapterOptions?: AzureCommunicationCallAdapterOptions;
 };
 /**
  * Create a CallWithChatAdapter backed by Azure Communication services
@@ -150,7 +197,7 @@ export declare type AzureCommunicationCallWithChatAdapterArgs = {
  *
  * @public
  */
-export declare const createAzureCommunicationCallWithChatAdapter: ({ userId, displayName, credential, endpoint, locator }: AzureCommunicationCallWithChatAdapterArgs) => Promise<CallWithChatAdapter>;
+export declare const createAzureCommunicationCallWithChatAdapter: ({ userId, displayName, credential, endpoint, locator, alternateCallerId, callAdapterOptions }: AzureCommunicationCallWithChatAdapterArgs) => Promise<CallWithChatAdapter>;
 /**
  * A custom React hook to simplify the creation of {@link CallWithChatAdapter}.
  *
@@ -177,6 +224,7 @@ export declare type AzureCommunicationCallWithChatAdapterFromClientArgs = {
     callClient: StatefulCallClient;
     chatClient: StatefulChatClient;
     chatThreadClient: ChatThreadClient;
+    options?: AzureCommunicationChatAdapterOptions;
 };
 /**
  * Create a {@link CallWithChatAdapter} using the provided {@link StatefulChatClient} and {@link StatefulCallClient}.
@@ -186,7 +234,7 @@ export declare type AzureCommunicationCallWithChatAdapterFromClientArgs = {
  *
  * @public
  */
-export declare const createAzureCommunicationCallWithChatAdapterFromClients: ({ callClient, callAgent, callLocator, chatClient, chatThreadClient }: AzureCommunicationCallWithChatAdapterFromClientArgs) => Promise<CallWithChatAdapter>;
+export declare const createAzureCommunicationCallWithChatAdapterFromClients: ({ callClient, callAgent, callLocator, chatClient, chatThreadClient, options }: AzureCommunicationCallWithChatAdapterFromClientArgs) => Promise<CallWithChatAdapter>;
 /**
  * Create a {@link CallWithChatAdapter} from the underlying adapters.
  *

package/dist/dist-esm/react-composites/src/composites/CallWithChatComposite/adapter/AzureCommunicationCallWithChatAdapter.js

@@ -13,9 +13,12 @@ import { createAzureCommunicationCallAdapter } from '../../CallComposite';
 import { callWithChatAdapterStateFromBackingStates, mergeCallAdapterStateIntoCallWithChatAdapterState, mergeChatAdapterStateIntoCallWithChatAdapterState } from '../state/CallWithChatAdapterState';
 import { createAzureCommunicationChatAdapter, createAzureCommunicationChatAdapterFromClient } from '../../ChatComposite/adapter/AzureCommunicationChatAdapter';
 import { EventEmitter } from 'events';
+/* @conditional-compile-remove(PSTN-calls) */
+import { isCommunicationUserIdentifier } from '@azure/communication-common';
 import { getChatThreadFromTeamsLink } from './parseTeamsUrl';
 import { createAzureCommunicationCallAdapterFromClient } from '../../CallComposite/adapter/AzureCommunicationCallAdapter';
 import { useEffect, useRef, useState } from 'react';
+import { _toCommunicationIdentifier } from "../../../../../acs-ui-common/src";
 /** Context of Call with Chat, which is a centralized context for all state updates */
 class CallWithChatContext {
     constructor(clientState, maxListeners = 50) {
@@ -52,6 +55,34 @@ class CallWithChatContext {
  */
 export class AzureCommunicationCallWithChatAdapter {
     constructor(callAdapter, chatAdapter) {
+        /* @conditional-compile-remove(file-sharing) */
+        this.registerActiveFileUploads = (files) => {
+            return this.chatAdapter.registerActiveFileUploads(files);
+        };
+        /* @conditional-compile-remove(file-sharing) */
+        this.registerCompletedFileUploads = (metadata) => {
+            return this.chatAdapter.registerCompletedFileUploads(metadata);
+        };
+        /* @conditional-compile-remove(file-sharing) */
+        this.clearFileUploads = () => {
+            this.chatAdapter.clearFileUploads();
+        };
+        /* @conditional-compile-remove(file-sharing) */
+        this.cancelFileUpload = (id) => {
+            this.chatAdapter.cancelFileUpload(id);
+        };
+        /* @conditional-compile-remove(file-sharing) */
+        this.updateFileUploadProgress = (id, progress) => {
+            this.chatAdapter.updateFileUploadProgress(id, progress);
+        };
+        /* @conditional-compile-remove(file-sharing) */
+        this.updateFileUploadErrorMessage = (id, errorMessage) => {
+            this.chatAdapter.updateFileUploadErrorMessage(id, errorMessage);
+        };
+        /* @conditional-compile-remove(file-sharing) */
+        this.updateFileUploadMetadata = (id, metadata) => {
+            this.chatAdapter.updateFileUploadMetadata(id, metadata);
+        };
         this.bindPublicMethods();
         this.callAdapter = callAdapter;
         this.chatAdapter = chatAdapter;
@@ -91,6 +122,7 @@ export class AzureCommunicationCallWithChatAdapter {
         this.removeParticipant.bind(this);
         this.createStreamView.bind(this);
         this.disposeStreamView.bind(this);
+        this.disposeScreenShareStreamView.bind(this);
         this.fetchInitialData.bind(this);
         this.sendMessage.bind(this);
         this.sendReadReceipt.bind(this);
@@ -100,6 +132,44 @@ export class AzureCommunicationCallWithChatAdapter {
         this.deleteMessage.bind(this);
         this.on.bind(this);
         this.off.bind(this);
+        /* @conditional-compile-remove(file-sharing) */
+        this.registerActiveFileUploads = this.registerActiveFileUploads.bind(this);
+        /* @conditional-compile-remove(file-sharing) */
+        this.registerCompletedFileUploads = this.registerCompletedFileUploads.bind(this);
+        /* @conditional-compile-remove(file-sharing) */
+        this.clearFileUploads = this.clearFileUploads.bind(this);
+        /* @conditional-compile-remove(file-sharing) */
+        this.cancelFileUpload = this.cancelFileUpload.bind(this);
+        /* @conditional-compile-remove(file-sharing) */
+        this.updateFileUploadProgress = this.updateFileUploadProgress.bind(this);
+        /* @conditional-compile-remove(file-sharing) */
+        this.updateFileUploadErrorMessage = this.updateFileUploadErrorMessage.bind(this);
+        /* @conditional-compile-remove(file-sharing) */
+        this.updateFileUploadMetadata = this.updateFileUploadMetadata.bind(this);
+        /* @conditional-compile-remove(teams-inline-images-and-file-sharing) */
+        this.downloadAttachments = this.downloadAttachments.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.addParticipant.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);
     }
     /** Join existing Call. */
     joinCall(microphoneOn) {
@@ -115,6 +185,8 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Start a new Call. */
     startCall(participants, options) {
         let communicationParticipants = participants;
+        /* @conditional-compile-remove(PSTN-calls) */
+        communicationParticipants = participants.map(_toCommunicationIdentifier);
         return this.callAdapter.startCall(communicationParticipants, options);
     }
     /**
@@ -146,6 +218,8 @@ export class AzureCommunicationCallWithChatAdapter {
     removeParticipant(userId) {
         return __awaiter(this, void 0, void 0, function* () {
             let participant = userId;
+            /* @conditional-compile-remove(PSTN-calls) */
+            participant = _toCommunicationIdentifier(userId);
             yield this.callAdapter.removeParticipant(participant);
         });
     }
@@ -237,6 +311,24 @@ export class AzureCommunicationCallWithChatAdapter {
             yield this.callAdapter.disposeStreamView(remoteUserId, options);
         });
     }
+    /** Dispose of a remote screen share */
+    disposeScreenShareStreamView(remoteUserId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.callAdapter.disposeScreenShareStreamView(remoteUserId);
+        });
+    }
+    /** Dispose of a remote video stream */
+    disposeRemoteVideoStreamView(remoteUserId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.callAdapter.disposeRemoteVideoStreamView(remoteUserId);
+        });
+    }
+    /** Dispose of the local video stream */
+    disposeLocalVideoStreamView() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.callAdapter.disposeLocalVideoStreamView();
+        });
+    }
     /** Fetch initial Call and Chat data such as chat messages. */
     fetchInitialData() {
         return __awaiter(this, void 0, void 0, function* () {
@@ -279,6 +371,89 @@ export class AzureCommunicationCallWithChatAdapter {
             return yield this.chatAdapter.deleteMessage(messageId);
         });
     }
+    /* @conditional-compile-remove(teams-inline-images-and-file-sharing) */
+    downloadAttachments(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.chatAdapter.downloadAttachments(options);
+        });
+    }
+    /* @conditional-compile-remove(PSTN-calls) */
+    holdCall() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.callAdapter.holdCall();
+        });
+    }
+    /* @conditional-compile-remove(PSTN-calls) */
+    resumeCall() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.callAdapter.resumeCall();
+        });
+    }
+    /* @conditional-compile-remove(PSTN-calls) */
+    addParticipant(participant, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (isCommunicationUserIdentifier(participant)) {
+                return yield this.callAdapter.addParticipant(participant);
+            }
+            else {
+                return yield this.callAdapter.addParticipant(participant, options);
+            }
+        });
+    }
+    /* @conditional-compile-remove(PSTN-calls) */
+    sendDtmfTone(dtmfTone) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.callAdapter.sendDtmfTone(dtmfTone);
+        });
+    }
+    /* @conditional-compile-remove(unsupported-browser) */
+    allowUnsupportedBrowserVersion() {
+        return this.callAdapter.allowUnsupportedBrowserVersion();
+    }
+    /* @conditional-compile-remove(close-captions) */
+    startCaptions(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.callAdapter.startCaptions(options);
+        });
+    }
+    /* @conditional-compile-remove(close-captions) */
+    stopCaptions() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.callAdapter.stopCaptions();
+        });
+    }
+    /* @conditional-compile-remove(close-captions) */
+    setCaptionLanguage(language) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.callAdapter.setCaptionLanguage(language);
+        });
+    }
+    /* @conditional-compile-remove(close-captions) */
+    setSpokenLanguage(language) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.callAdapter.setSpokenLanguage(language);
+        });
+    }
+    /* @conditional-compile-remove(video-background-effects) */
+    startVideoBackgroundEffect(videoBackgroundEffect) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.callAdapter.startVideoBackgroundEffect(videoBackgroundEffect);
+        });
+    }
+    /* @conditional-compile-remove(video-background-effects) */
+    stopVideoBackgroundEffects() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.callAdapter.stopVideoBackgroundEffects();
+        });
+    }
+    /* @conditional-compile-remove(video-background-effects) */
+    updateBackgroundPickerImages(backgroundImages) {
+        return this.callAdapter.updateBackgroundPickerImages(backgroundImages);
+    }
+    /* @conditional-compile-remove(video-background-effects) */
+    updateSelectedVideoBackgroundEffect(selectedVideoBackground) {
+        return this.callAdapter.updateSelectedVideoBackgroundEffect(selectedVideoBackground);
+    }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     on(event, listener) {
         switch (event) {
@@ -312,6 +487,14 @@ export class AzureCommunicationCallWithChatAdapter {
             case 'selectedSpeakerChanged':
                 this.callAdapter.on('selectedSpeakerChanged', listener);
                 break;
+            /* @conditional-compile-remove(close-captions) */
+            case 'captionsReceived':
+                this.callAdapter.on('captionsReceived', listener);
+                break;
+            /* @conditional-compile-remove(close-captions) */
+            case 'isCaptionsActiveChanged':
+                this.callAdapter.on('isCaptionsActiveChanged', listener);
+                break;
             case 'messageReceived':
                 this.chatAdapter.on('messageReceived', listener);
                 break;
@@ -370,6 +553,14 @@ export class AzureCommunicationCallWithChatAdapter {
             case 'selectedSpeakerChanged':
                 this.callAdapter.off('selectedSpeakerChanged', listener);
                 break;
+            /* @conditional-compile-remove(close-captions) */
+            case 'captionsReceived':
+                this.callAdapter.off('captionsReceived', listener);
+                break;
+            /* @conditional-compile-remove(close-captions) */
+            case 'isCaptionsActiveChanged':
+                this.callAdapter.off('isCaptionsActiveChanged', listener);
+                break;
             case 'messageReceived':
                 this.chatAdapter.off('messageReceived', listener);
                 break;
@@ -402,15 +593,21 @@ export class AzureCommunicationCallWithChatAdapter {
  *
  * @public
  */
-export const createAzureCommunicationCallWithChatAdapter = ({ userId, displayName, credential, endpoint, locator }) => __awaiter(void 0, void 0, void 0, function* () {
+export const createAzureCommunicationCallWithChatAdapter = ({ userId, displayName, credential, endpoint, locator, 
+/* @conditional-compile-remove(PSTN-calls) */ alternateCallerId, 
+/* @conditional-compile-remove(rooms) */ /* @conditional-compile-remove(video-background-effects) */ callAdapterOptions }) => __awaiter(void 0, void 0, void 0, function* () {
     const callAdapterLocator = isTeamsMeetingLinkLocator(locator) ? locator : locator.callLocator;
     const createCallAdapterPromise = createAzureCommunicationCallAdapter({
         userId,
         displayName,
         credential,
-        locator: callAdapterLocator
+        locator: callAdapterLocator,
+        /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId,
+        /* @conditional-compile-remove(rooms) */ options: callAdapterOptions
     });
-    const threadId = isTeamsMeetingLinkLocator(locator) ? getChatThreadFromTeamsLink(locator.meetingLink) : locator.chatThreadId;
+    const threadId = isTeamsMeetingLinkLocator(locator)
+        ? getChatThreadFromTeamsLink(locator.meetingLink)
+        : locator.chatThreadId;
     const createChatAdapterPromise = createAzureCommunicationChatAdapter({
         endpoint,
         userId,
@@ -435,8 +632,29 @@ export const createAzureCommunicationCallWithChatAdapter = ({ userId, displayNam
  *
  * @public
  */
-export const useAzureCommunicationCallWithChatAdapter = (args, afterCreate, beforeDispose) => {
-    const { credential, displayName, endpoint, locator, userId } = args;
+export const useAzureCommunicationCallWithChatAdapter = (
+/**
+ * Arguments to be passed to {@link createAzureCommunicationCallWithChatAdapter}.
+ *
+ * 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, endpoint, locator, userId, 
+    /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId, 
+    /* @conditional-compile-remove(rooms) */ callAdapterOptions } = 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.
@@ -471,7 +689,9 @@ export const useAzureCommunicationCallWithChatAdapter = (args, afterCreate, befo
                 displayName,
                 endpoint,
                 locator,
-                userId
+                userId,
+                /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId,
+                /* @conditional-compile-remove(rooms) */ callAdapterOptions
             });
             if (afterCreateRef.current) {
                 newAdapter = yield afterCreateRef.current(newAdapter);
@@ -481,7 +701,18 @@ export const useAzureCommunicationCallWithChatAdapter = (args, afterCreate, befo
         }))();
     }, 
     // Explicitly list all arguments so that caller doesn't have to memoize the `args` object.
-    [adapterRef, afterCreateRef, beforeDisposeRef, credential, displayName, endpoint, locator, userId]);
+    [
+        adapterRef,
+        afterCreateRef,
+        /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId,
+        beforeDisposeRef,
+        credential,
+        displayName,
+        endpoint,
+        locator,
+        userId,
+        /* @conditional-compile-remove(rooms) */ callAdapterOptions
+    ]);
     // Dispose any existing adapter when the component unmounts.
     useEffect(() => {
         return () => {
@@ -506,9 +737,13 @@ export const useAzureCommunicationCallWithChatAdapter = (args, afterCreate, befo
  *
  * @public
  */
-export const createAzureCommunicationCallWithChatAdapterFromClients = ({ callClient, callAgent, callLocator, chatClient, chatThreadClient }) => __awaiter(void 0, void 0, void 0, function* () {
+export const createAzureCommunicationCallWithChatAdapterFromClients = ({ callClient, callAgent, callLocator, chatClient, chatThreadClient, 
+/* @conditional-compile-remove(teams-inline-images-and-file-sharing) */
+options }) => __awaiter(void 0, void 0, void 0, function* () {
     const createCallAdapterPromise = createAzureCommunicationCallAdapterFromClient(callClient, callAgent, callLocator);
-    const createChatAdapterPromise = createAzureCommunicationChatAdapterFromClient(chatClient, chatThreadClient);
+    const createChatAdapterPromise = createAzureCommunicationChatAdapterFromClient(chatClient, chatThreadClient, 
+    /* @conditional-compile-remove(teams-inline-images-and-file-sharing) */
+    options);
     const [callAdapter, chatAdapter] = yield Promise.all([createCallAdapterPromise, createChatAdapterPromise]);
     return new AzureCommunicationCallWithChatAdapter(callAdapter, chatAdapter);
 });