@azure/communication-react 1.15.0 → 1.16.0-alpha-202404160012

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

@@ -12,10 +12,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { callWithChatAdapterStateFromBackingStates, mergeCallAdapterStateIntoCallWithChatAdapterState, mergeChatAdapterStateIntoCallWithChatAdapterState } from '../state/CallWithChatAdapterState';
 import { _createLazyAzureCommunicationChatAdapterInner, 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 { _createAzureCommunicationCallAdapterInner } from '../../CallComposite/adapter/AzureCommunicationCallAdapter';
 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,46 @@ class CallWithChatContext {
  */
 export class AzureCommunicationCallWithChatAdapter {
     constructor(callAdapter, chatAdapterPromise) {
+        /* @conditional-compile-remove(attachment-upload) */
+        this.registerActiveUploads = (files) => {
+            var _a, _b;
+            return (_b = (_a = this.chatAdapter) === null || _a === void 0 ? void 0 : _a.registerActiveUploads(files)) !== null && _b !== void 0 ? _b : [];
+        };
+        /* @conditional-compile-remove(attachment-upload) */
+        this.registerCompletedUploads = (metadata) => {
+            var _a, _b;
+            return (_b = (_a = this.chatAdapter) === null || _a === void 0 ? void 0 : _a.registerCompletedUploads(metadata)) !== null && _b !== void 0 ? _b : [];
+        };
+        /* @conditional-compile-remove(attachment-upload) */
+        this.clearUploads = () => {
+            this.chatAdapterPromise.then((adapter) => {
+                adapter.clearUploads();
+            });
+        };
+        /* @conditional-compile-remove(attachment-upload) */
+        this.cancelUpload = (id) => {
+            this.chatAdapterPromise.then((adapter) => {
+                adapter.cancelUpload(id);
+            });
+        };
+        /* @conditional-compile-remove(attachment-upload) */
+        this.updateUploadProgress = (id, progress) => {
+            this.chatAdapterPromise.then((adapter) => {
+                adapter.updateUploadProgress(id, progress);
+            });
+        };
+        /* @conditional-compile-remove(attachment-upload) */
+        this.updateUploadStatusMessage = (id, errorMessage) => {
+            this.chatAdapterPromise.then((adapter) => {
+                adapter.updateUploadStatusMessage(id, errorMessage);
+            });
+        };
+        /* @conditional-compile-remove(attachment-upload) */
+        this.updateUploadMetadata = (id, metadata) => {
+            this.chatAdapterPromise.then((adapter) => {
+                adapter.updateUploadMetadata(id, metadata);
+            });
+        };
         this.bindPublicMethods();
         this.callAdapter = callAdapter;
         this.context = new CallWithChatContext(callWithChatAdapterStateFromBackingStates(callAdapter));
@@ -60,8 +103,10 @@ export class AzureCommunicationCallWithChatAdapter {
         };
         this.onChatStateChange = onChatStateChange;
         this.chatAdapterPromise = chatAdapterPromise;
-        this.chatAdapterPromise.then(chatAdapter => {
+        this.chatAdapterPromise.then((chatAdapter) => {
             chatAdapter.onStateChange(this.onChatStateChange);
+            /* @conditional-compile-remove(attachment-download) @conditional-compile-remove(attachment-upload) */
+            this.chatAdapter = chatAdapter;
             this.context.updateClientStateWithChatState(chatAdapter.getState());
         });
         const onCallStateChange = (newCallAdapterState) => {
@@ -108,9 +153,31 @@ export class AzureCommunicationCallWithChatAdapter {
         this.deleteMessage.bind(this);
         this.on.bind(this);
         this.off.bind(this);
+        /* @conditional-compile-remove(attachment-upload) */
+        this.registerActiveUploads = this.registerActiveUploads.bind(this);
+        /* @conditional-compile-remove(attachment-upload) */
+        this.registerCompletedUploads = this.registerCompletedUploads.bind(this);
+        /* @conditional-compile-remove(attachment-upload) */
+        this.clearUploads = this.clearUploads.bind(this);
+        /* @conditional-compile-remove(attachment-upload) */
+        this.cancelUpload = this.cancelUpload.bind(this);
+        /* @conditional-compile-remove(attachment-upload) */
+        this.updateUploadProgress = this.updateUploadProgress.bind(this);
+        /* @conditional-compile-remove(attachment-upload) */
+        this.updateUploadStatusMessage = this.updateUploadStatusMessage.bind(this);
+        /* @conditional-compile-remove(attachment-upload) */
+        this.updateUploadMetadata = this.updateUploadMetadata.bind(this);
         this.downloadResourceToCache = this.downloadResourceToCache.bind(this);
         this.removeResourceFromCache = this.removeResourceFromCache.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);
         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);
@@ -170,11 +237,11 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Dispose of the current CallWithChatAdapter. */
     dispose() {
         return __awaiter(this, void 0, void 0, function* () {
-            this.chatAdapterPromise.then(adapter => {
+            this.chatAdapterPromise.then((adapter) => {
                 adapter.offStateChange(this.onChatStateChange);
             });
             this.callAdapter.offStateChange(this.onCallStateChange);
-            yield this.chatAdapterPromise.then(adapter => {
+            yield this.chatAdapterPromise.then((adapter) => {
                 adapter.dispose();
             });
             this.callAdapter.dispose();
@@ -184,6 +251,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);
         });
     }
@@ -314,7 +383,7 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Fetch initial Call and Chat data such as chat messages. */
     fetchInitialData() {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.chatAdapterPromise.then(adapter => {
+            return yield this.chatAdapterPromise.then((adapter) => {
                 return adapter.fetchInitialData();
             });
         });
@@ -322,7 +391,7 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Send a chat message. */
     sendMessage(content) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.chatAdapterPromise.then(adapter => {
+            return yield this.chatAdapterPromise.then((adapter) => {
                 return adapter.sendMessage(content);
             });
         });
@@ -330,7 +399,7 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Send a chat read receipt. */
     sendReadReceipt(chatMessageId) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.chatAdapterPromise.then(adapter => {
+            return yield this.chatAdapterPromise.then((adapter) => {
                 return adapter.sendReadReceipt(chatMessageId);
             });
         });
@@ -338,7 +407,7 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Send an isTyping indicator. */
     sendTypingIndicator() {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.chatAdapterPromise.then(adapter => {
+            return yield this.chatAdapterPromise.then((adapter) => {
                 return adapter.sendTypingIndicator();
             });
         });
@@ -346,7 +415,7 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Load previous Chat messages. */
     loadPreviousChatMessages(messagesToLoad) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.chatAdapterPromise.then(adapter => {
+            return yield this.chatAdapterPromise.then((adapter) => {
                 return adapter.loadPreviousChatMessages(messagesToLoad);
             });
         });
@@ -354,36 +423,64 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Update an existing message. */
     updateMessage(messageId, content, metadata, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this.chatAdapterPromise.then(adapter => {
-                return adapter.updateMessage(messageId, content, metadata);
+            return this.chatAdapterPromise.then((adapter) => {
+                return adapter.updateMessage(messageId, content, metadata, 
+                /* @conditional-compile-remove(attachment-upload) */ options);
             });
         });
     }
     /** Delete an existing message. */
     deleteMessage(messageId) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.chatAdapterPromise.then(adapter => {
+            return yield this.chatAdapterPromise.then((adapter) => {
                 return adapter.deleteMessage(messageId);
             });
         });
     }
     downloadResourceToCache(resourceDetails) {
         return __awaiter(this, void 0, void 0, function* () {
-            this.chatAdapterPromise.then(adapter => {
+            this.chatAdapterPromise.then((adapter) => {
                 adapter.downloadResourceToCache(resourceDetails);
             });
         });
     }
     removeResourceFromCache(resourceDetails) {
-        this.chatAdapterPromise.then(adapter => {
+        this.chatAdapterPromise.then((adapter) => {
             adapter.removeResourceFromCache(resourceDetails);
         });
     }
+    /* @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);
+            }
+        });
+    }
     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* () {
@@ -498,37 +595,37 @@ export class AzureCommunicationCallWithChatAdapter {
                 this.callAdapter.on('isSpokenLanguageChanged', listener);
                 break;
             case 'messageReceived':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.on('messageReceived', listener);
                 });
                 break;
             case 'messageEdited':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.on('messageEdited', listener);
                 });
                 break;
             case 'messageDeleted':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.on('messageDeleted', listener);
                 });
                 break;
             case 'messageSent':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.on('messageSent', listener);
                 });
                 break;
             case 'messageRead':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.on('messageRead', listener);
                 });
                 break;
             case 'chatParticipantsAdded':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.on('participantsAdded', listener);
                 });
                 break;
             case 'chatParticipantsRemoved':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.on('participantsRemoved', listener);
                 });
                 break;
@@ -536,7 +633,7 @@ export class AzureCommunicationCallWithChatAdapter {
                 this.callAdapter.on('error', listener);
                 break;
             case 'chatError':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.on('error', listener);
                 });
                 break;
@@ -594,37 +691,37 @@ export class AzureCommunicationCallWithChatAdapter {
                 this.callAdapter.off('isSpokenLanguageChanged', listener);
                 break;
             case 'messageReceived':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.off('messageReceived', listener);
                 });
                 break;
             case 'messageEdited':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.off('messageEdited', listener);
                 });
                 break;
             case 'messageDeleted':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.off('messageDeleted', listener);
                 });
                 break;
             case 'messageSent':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.off('messageSent', listener);
                 });
                 break;
             case 'messageRead':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.off('messageRead', listener);
                 });
                 break;
             case 'chatParticipantsAdded':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.off('participantsAdded', listener);
                 });
                 break;
             case 'chatParticipantsRemoved':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.off('participantsRemoved', listener);
                 });
                 break;
@@ -632,7 +729,7 @@ export class AzureCommunicationCallWithChatAdapter {
                 this.callAdapter.off('error', listener);
                 break;
             case 'chatError':
-                this.chatAdapterPromise.then(adapter => {
+                this.chatAdapterPromise.then((adapter) => {
                     adapter.off('error', listener);
                 });
                 break;
@@ -670,19 +767,52 @@ export class TeamsMeetingLinkProvider {
         });
     }
 }
+/** @conditional-compile-remove(meeting-id) */
+/**
+ * Arguments for use in {@link createAzureCommunicationCallWithChatAdapter} to join a Teams meeting using meeting id.
+ *
+ * @public
+ */
+export class TeamsMeetingIdProvider {
+    constructor(locator, callAdapter) {
+        this.locator = locator;
+        this.callAdapter = callAdapter;
+    }
+    /**
+     * Wait call to be connected to get thread ID.
+     * @returns the chat thread ID for the given meeting ID.
+     */
+    getChatThread() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve) => {
+                const stateChangeListener = (state) => {
+                    var _a, _b, _c;
+                    if (((_a = state.call) === null || _a === void 0 ? void 0 : _a.state) === 'Connected' && ((_b = state.call.info) === null || _b === void 0 ? void 0 : _b.threadId)) {
+                        resolve((_c = state.call.info) === null || _c === void 0 ? void 0 : _c.threadId);
+                    }
+                };
+                this.callAdapter.then((adapter) => {
+                    adapter.onStateChange(stateChangeListener);
+                });
+            });
+        });
+    }
+}
 /**
  * Create a CallWithChatAdapter backed by Azure Communication services
  * to plug into the {@link CallWithChatComposite}.
  *
  * @public
  */
-export const createAzureCommunicationCallWithChatAdapter = (_a) => __awaiter(void 0, [_a], void 0, function* ({ userId, displayName, credential, endpoint, locator, callAdapterOptions }) {
+export const createAzureCommunicationCallWithChatAdapter = (_a) => __awaiter(void 0, [_a], void 0, function* ({ userId, displayName, credential, endpoint, locator, 
+/* @conditional-compile-remove(PSTN-calls) */ alternateCallerId, callAdapterOptions }) {
     const callAdapterLocator = isTeamsMeetingLocator(locator) ? locator : locator.callLocator;
     const callAdapter = _createAzureCommunicationCallAdapterInner({
         userId,
         displayName,
         credential,
         locator: callAdapterLocator,
+        /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId,
         options: callAdapterOptions,
         telemetryImplementationHint: 'CallWithChat'
     });
@@ -704,8 +834,28 @@ export const createAzureCommunicationCallWithChatAdapter = (_a) => __awaiter(voi
  *
  * @public
  */
-export const useAzureCommunicationCallWithChatAdapter = (args, afterCreate, beforeDispose) => {
-    const { credential, displayName, endpoint, locator, userId, callAdapterOptions } = 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, 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.
@@ -747,6 +897,7 @@ export const useAzureCommunicationCallWithChatAdapter = (args, afterCreate, befo
                 endpoint,
                 locator,
                 userId,
+                /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId,
                 callAdapterOptions
             });
             if (afterCreateRef.current) {
@@ -757,7 +908,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, callAdapterOptions]);
+    [
+        adapterRef,
+        afterCreateRef,
+        /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId,
+        beforeDisposeRef,
+        credential,
+        displayName,
+        endpoint,
+        locator,
+        userId,
+        callAdapterOptions
+    ]);
     // Dispose any existing adapter when the component unmounts.
     useEffect(() => {
         return () => {
@@ -795,7 +957,7 @@ export const createAzureCommunicationCallWithChatAdapterFromClients = (_b) => __
  *
  * @internal
  */
-export const _createAzureCommunicationCallWithChatAdapterFromAdapters = (callAdapter, chatAdapter) => new AzureCommunicationCallWithChatAdapter(callAdapter, new Promise(resolve => resolve(chatAdapter)));
+export const _createAzureCommunicationCallWithChatAdapterFromAdapters = (callAdapter, chatAdapter) => new AzureCommunicationCallWithChatAdapter(callAdapter, new Promise((resolve) => resolve(chatAdapter)));
 const isTeamsMeetingLocator = (locator) => {
     return 'meetingLink' in locator || 'meetingId' in locator;
 };
@@ -803,6 +965,10 @@ const _createChatThreadAdapterInner = (locator, adapter) => {
     if ('meetingLink' in locator) {
         return new TeamsMeetingLinkProvider(locator);
     }
+    /** @conditional-compile-remove(meeting-id) */
+    if ('meetingId' in locator) {
+        return new TeamsMeetingIdProvider(locator, adapter);
+    }
     return new CallAndChatProvider(locator);
 };
 //# sourceMappingURL=AzureCommunicationCallWithChatAdapter.js.map