@azure/communication-react 1.18.0-beta.1 → 1.19.0-alpha-202407230014

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

@@ -19,6 +19,7 @@ import { CallAdapterLocator } from '../../CallComposite/adapter/AzureCommunicati
 import { StatefulCallClient } from "../../../../../calling-stateful-client/src";
 import { StatefulChatClient } from "../../../../../chat-stateful-client/src";
 import { ChatThreadClient } from '@azure/communication-chat';
+import { UploadChatImageResult } from "../../../../../acs-ui-common/src";
 import { JoinCallOptions, StartCallIdentifier } from '../../CallComposite/adapter/CallAdapter';
 import { AzureCommunicationCallAdapterOptions } from '../../CallComposite/adapter/AzureCommunicationCallAdapter';
 import { IsCaptionsActiveChangedListener, CaptionsReceivedListener, IsCaptionLanguageChangedListener, IsSpokenLanguageChangedListener } from '../../CallComposite/adapter/CallAdapter';
@@ -109,7 +110,11 @@ export declare class AzureCommunicationCallWithChatAdapter implements CallWithCh
     /** Fetch initial Call and Chat data such as chat messages. */
     fetchInitialData(): Promise<void>;
     /** Send a chat message. */
-    sendMessage(content: string, /* @conditional-compile-remove(file-sharing-acs) */ options?: MessageOptions): Promise<void>;
+    sendMessage(content: string, options?: MessageOptions): Promise<void>;
+    /** Upload a chat image. */
+    uploadImage(image: Blob, imageFileName: string): Promise<UploadChatImageResult>;
+    /** Delete a chat image. */
+    deleteImage(imageId: string): Promise<void>;
     /** Send a chat read receipt. */
     sendReadReceipt(chatMessageId: string): Promise<void>;
     /** Send an isTyping indicator. */
@@ -140,6 +145,8 @@ export declare class AzureCommunicationCallWithChatAdapter implements CallWithCh
     startSpotlight(userIds?: string[]): Promise<void>;
     stopSpotlight(userIds?: string[]): Promise<void>;
     stopAllSpotlight(): Promise<void>;
+    muteParticipant(userId: string): Promise<void>;
+    muteAllRemoteParticipants(): Promise<void>;
     on(event: 'callParticipantsJoined', listener: ParticipantsJoinedListener): void;
     on(event: 'callParticipantsLeft', listener: ParticipantsLeftListener): void;
     on(event: 'callEnded', listener: CallEndedListener): void;
@@ -226,7 +233,8 @@ export declare class TeamsMeetingLinkProvider implements ChatThreadProvider {
     private callAdapterPromise;
     /** @conditional-compile-remove(meeting-id) */
     private callAdapterSubscription?;
-    constructor(locator: TeamsMeetingLinkLocator, /** @conditional-compile-remove(meeting-id) */ callAdapterPromise: Promise<CallAdapter>);
+    constructor(locator: TeamsMeetingLinkLocator, 
+    /** @conditional-compile-remove(meeting-id) */ callAdapterPromise: Promise<CallAdapter>);
     isCallInfoRequired(): boolean;
     getChatThread(): string;
     getChatThreadPromise(): Promise<string>;

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

@@ -74,7 +74,7 @@ export class AzureCommunicationCallWithChatAdapter {
         this.onCallStateChange = onCallStateChange;
     }
     setChatAdapterPromise(chatAdapter) {
-        chatAdapter.then(adapter => {
+        chatAdapter.then((adapter) => {
             if (!this.isAdapterDisposed) {
                 this.updateChatAdapter(adapter);
             }
@@ -116,6 +116,10 @@ export class AzureCommunicationCallWithChatAdapter {
         this.disposeScreenShareStreamView.bind(this);
         this.fetchInitialData.bind(this);
         this.sendMessage.bind(this);
+        /* @conditional-compile-remove(rich-text-editor-image-upload) */
+        this.uploadImage.bind(this);
+        /* @conditional-compile-remove(rich-text-editor-image-upload) */
+        this.deleteImage.bind(this);
         this.sendReadReceipt.bind(this);
         this.sendTypingIndicator.bind(this);
         this.loadPreviousChatMessages.bind(this);
@@ -334,23 +338,43 @@ 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.executeWithResolvedChatAdapter(adapter => {
+            return yield this.executeWithResolvedChatAdapter((adapter) => {
                 return adapter.fetchInitialData();
             });
         });
     }
     /** Send a chat message. */
-    sendMessage(content, /* @conditional-compile-remove(file-sharing-acs) */ options) {
+    sendMessage(content, 
+    /* @conditional-compile-remove(file-sharing-acs) */
+    options) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.executeWithResolvedChatAdapter(adapter => {
+            return yield this.executeWithResolvedChatAdapter((adapter) => {
                 return adapter.sendMessage(content, /* @conditional-compile-remove(file-sharing-acs) */ options);
             });
         });
     }
+    /* @conditional-compile-remove(rich-text-editor-image-upload) */
+    /** Upload a chat image. */
+    uploadImage(image, imageFileName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.executeWithResolvedChatAdapter((adapter) => {
+                return adapter.uploadImage(image, imageFileName);
+            });
+        });
+    }
+    /* @conditional-compile-remove(rich-text-editor-image-upload) */
+    /** Delete a chat image. */
+    deleteImage(imageId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.executeWithResolvedChatAdapter((adapter) => {
+                return adapter.deleteImage(imageId);
+            });
+        });
+    }
     /** Send a chat read receipt. */
     sendReadReceipt(chatMessageId) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.executeWithResolvedChatAdapter(adapter => {
+            return yield this.executeWithResolvedChatAdapter((adapter) => {
                 return adapter.sendReadReceipt(chatMessageId);
             });
         });
@@ -358,7 +382,7 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Send an isTyping indicator. */
     sendTypingIndicator() {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.executeWithResolvedChatAdapter(adapter => {
+            return yield this.executeWithResolvedChatAdapter((adapter) => {
                 return adapter.sendTypingIndicator();
             });
         });
@@ -366,7 +390,7 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Load previous Chat messages. */
     loadPreviousChatMessages(messagesToLoad) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.executeWithResolvedChatAdapter(adapter => {
+            return yield this.executeWithResolvedChatAdapter((adapter) => {
                 return adapter.loadPreviousChatMessages(messagesToLoad);
             });
         });
@@ -374,7 +398,7 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Update an existing message. */
     updateMessage(messageId, content, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this.executeWithResolvedChatAdapter(adapter => {
+            return this.executeWithResolvedChatAdapter((adapter) => {
                 return adapter.updateMessage(messageId, content, options);
             });
         });
@@ -382,20 +406,20 @@ export class AzureCommunicationCallWithChatAdapter {
     /** Delete an existing message. */
     deleteMessage(messageId) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.executeWithResolvedChatAdapter(adapter => {
+            return yield this.executeWithResolvedChatAdapter((adapter) => {
                 return adapter.deleteMessage(messageId);
             });
         });
     }
     downloadResourceToCache(resourceDetails) {
         return __awaiter(this, void 0, void 0, function* () {
-            this.executeWithResolvedChatAdapter(adapter => {
+            this.executeWithResolvedChatAdapter((adapter) => {
                 adapter.downloadResourceToCache(resourceDetails);
             });
         });
     }
     removeResourceFromCache(resourceDetails) {
-        this.executeWithResolvedChatAdapter(adapter => {
+        this.executeWithResolvedChatAdapter((adapter) => {
             adapter.removeResourceFromCache(resourceDetails);
         });
     }
@@ -487,6 +511,18 @@ export class AzureCommunicationCallWithChatAdapter {
             return this.callAdapter.stopAllSpotlight();
         });
     }
+    /* @conditional-compile-remove(soft-mute) */
+    muteParticipant(userId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.callAdapter.muteParticipant(userId);
+        });
+    }
+    /* @conditional-compile-remove(soft-mute) */
+    muteAllRemoteParticipants() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.callAdapter.muteAllRemoteParticipants();
+        });
+    }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     on(event, listener) {
         switch (event) {
@@ -533,37 +569,37 @@ export class AzureCommunicationCallWithChatAdapter {
                 this.callAdapter.on('isSpokenLanguageChanged', listener);
                 break;
             case 'messageReceived':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.on('messageReceived', listener);
                 });
                 break;
             case 'messageEdited':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.on('messageEdited', listener);
                 });
                 break;
             case 'messageDeleted':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.on('messageDeleted', listener);
                 });
                 break;
             case 'messageSent':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.on('messageSent', listener);
                 });
                 break;
             case 'messageRead':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.on('messageRead', listener);
                 });
                 break;
             case 'chatParticipantsAdded':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.on('participantsAdded', listener);
                 });
                 break;
             case 'chatParticipantsRemoved':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.on('participantsRemoved', listener);
                 });
                 break;
@@ -571,7 +607,7 @@ export class AzureCommunicationCallWithChatAdapter {
                 this.callAdapter.on('error', listener);
                 break;
             case 'chatError':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.on('error', listener);
                 });
                 break;
@@ -628,37 +664,37 @@ export class AzureCommunicationCallWithChatAdapter {
                 this.callAdapter.off('isSpokenLanguageChanged', listener);
                 break;
             case 'messageReceived':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.off('messageReceived', listener);
                 });
                 break;
             case 'messageEdited':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.off('messageEdited', listener);
                 });
                 break;
             case 'messageDeleted':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.off('messageDeleted', listener);
                 });
                 break;
             case 'messageSent':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.off('messageSent', listener);
                 });
                 break;
             case 'messageRead':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.off('messageRead', listener);
                 });
                 break;
             case 'chatParticipantsAdded':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.off('participantsAdded', listener);
                 });
                 break;
             case 'chatParticipantsRemoved':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.off('participantsRemoved', listener);
                 });
                 break;
@@ -666,7 +702,7 @@ export class AzureCommunicationCallWithChatAdapter {
                 this.callAdapter.off('error', listener);
                 break;
             case 'chatError':
-                this.executeWithResolvedChatAdapter(adapter => {
+                this.executeWithResolvedChatAdapter((adapter) => {
                     adapter.off('error', listener);
                 });
                 break;
@@ -713,7 +749,8 @@ export class CallAndChatProvider {
  * @private
  */
 export class TeamsMeetingLinkProvider {
-    constructor(locator, /** @conditional-compile-remove(meeting-id) */ callAdapterPromise) {
+    constructor(locator, 
+    /** @conditional-compile-remove(meeting-id) */ callAdapterPromise) {
         this.locator = locator;
         /** @conditional-compile-remove(meeting-id) */
         this.callAdapterPromise = callAdapterPromise;
@@ -731,8 +768,8 @@ export class TeamsMeetingLinkProvider {
             /** @conditional-compile-remove(meeting-id) */
             {
                 // Wait for the call to be connected and get the chat thread ID from `call.callInfo`.
-                const chatThreadPromise = new Promise(resolve => {
-                    this.callAdapterPromise.then(callAdapter => {
+                const chatThreadPromise = new Promise((resolve) => {
+                    this.callAdapterPromise.then((callAdapter) => {
                         // Ensure function is idempotent by removing any existing subscription.
                         this.callAdapterSubscription && callAdapter.offStateChange(this.callAdapterSubscription);
                         this.callAdapterSubscription = (state) => {
@@ -775,17 +812,17 @@ export class TeamsMeetingIdProvider {
      */
     getChatThreadPromise() {
         return __awaiter(this, void 0, void 0, function* () {
-            return new Promise(resolve => {
+            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)) {
-                        this.callAdapter.then(adapter => {
+                        this.callAdapter.then((adapter) => {
                             adapter.offStateChange(stateChangeListener);
                         });
                         resolve((_c = state.call.info) === null || _c === void 0 ? void 0 : _c.threadId);
                     }
                 };
-                this.callAdapter.then(adapter => {
+                this.callAdapter.then((adapter) => {
                     var _a, _b, _c;
                     const callState = (_a = adapter.getState().call) === null || _a === void 0 ? void 0 : _a.state;
                     const threadId = (_c = (_b = adapter.getState().call) === null || _b === void 0 ? void 0 : _b.info) === null || _c === void 0 ? void 0 : _c.threadId;
@@ -844,7 +881,26 @@ export const createAzureCommunicationCallWithChatAdapter = (_a) => __awaiter(voi
  *
  * @public
  */
-export const useAzureCommunicationCallWithChatAdapter = (args, afterCreate, beforeDispose) => {
+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.
@@ -899,7 +955,18 @@ export const useAzureCommunicationCallWithChatAdapter = (args, afterCreate, befo
         }))();
     }, 
     // 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, 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 () => {