@azure/communication-react 1.4.2-alpha-202211230015.0 → 1.4.2-alpha-202211260013.0

package/dist/communication-react.d.ts

@@ -524,11 +524,33 @@ export declare interface BrowserPermissionDeniedStyles extends BaseCustomStyles
 }
 
 /**
- * {@link CallComposite} Adapter interface.
+ *  An Adapter interface specific for Azure Communication identity which extends {@link CommonCallAdapter}.
  *
  * @public
  */
-export declare interface CallAdapter extends AdapterState<CallAdapterState>, Disposable, CallAdapterCallManagement, CallAdapterDeviceManagement, CallAdapterSubscribers {
+export declare interface CallAdapter extends CommonCallAdapter {
+    /**
+     * Join the call with microphone initially on/off.
+     *
+     * @param microphoneOn - Whether microphone is initially enabled
+     *
+     * @public
+     */
+    joinCall(microphoneOn?: boolean): Call | undefined;
+    /**
+     * Start the call.
+     *
+     * @param participants - An array of participant ids to join
+     *
+     * @public
+     */
+    startCall(participants: string[], options?: StartCallOptions): Call | undefined;
+    /**
+     * Start the call.
+     * @param participants - An array of {@link @azure/communication-common#CommunicationIdentifier} to be called
+     * @beta
+     */
+    startCall(participants: CommunicationIdentifier[], options?: StartCallOptions): Call | undefined;
 }
 
 /**
@@ -541,11 +563,11 @@ export declare type CallAdapterCallEndedEvent = {
 };
 
 /**
- * Functionality for managing the current call.
- *
+ * Functionality for managing the current call or start a new call
+ * @deprecated CallAdapter interface will be flatten, consider using CallAdapter directly
  * @public
  */
-export declare interface CallAdapterCallManagement {
+export declare interface CallAdapterCallManagement extends CallAdapterCallOperations {
     /**
      * Join the call with microphone initially on/off.
      *
@@ -554,6 +576,28 @@ export declare interface CallAdapterCallManagement {
      * @public
      */
     joinCall(microphoneOn?: boolean): Call | undefined;
+    /**
+     * Start the call.
+     *
+     * @param participants - An array of participant ids to join
+     *
+     * @public
+     */
+    startCall(participants: string[], options?: StartCallOptions): Call | undefined;
+    /**
+     * Start the call.
+     * @param participants - An array of {@link @azure/communication-common#CommunicationIdentifier} to be called
+     * @beta
+     */
+    startCall(participants: CommunicationIdentifier[], options?: StartCallOptions): Call | undefined;
+}
+
+/**
+ * Functionality for managing the current call.
+ *
+ * @public
+ */
+export declare interface CallAdapterCallOperations {
     /**
      * Leave the call
      *
@@ -590,20 +634,6 @@ export declare interface CallAdapterCallManagement {
      * @public
      */
     unmute(): Promise<void>;
-    /**
-     * Start the call.
-     *
-     * @param participants - An array of participant ids to join
-     *
-     * @public
-     */
-    startCall(participants: string[], options?: StartCallOptions): Call | undefined;
-    /**
-     * Start the call.
-     * @param participants - An array of {@link @azure/communication-common#CommunicationIdentifier} to be called
-     * @beta
-     */
-    startCall(participants: CommunicationIdentifier[], options?: StartCallOptions): Call | undefined;
     /**
      * Start sharing the screen during a call.
      *
@@ -682,7 +712,7 @@ export declare interface CallAdapterCallManagement {
 }
 
 /**
- * {@link CallAdapter} state inferred from Azure Communication Services backend.
+ * {@link CommonCallAdapter} state inferred from Azure Communication Services backend.
  *
  * @public
  */
@@ -814,7 +844,7 @@ export declare type CallAdapterOptionalFeatures = {
 };
 
 /**
- * {@link CallAdapter} state.
+ * {@link CommonCallAdapter} state.
  *
  * @public
  */
@@ -939,7 +969,7 @@ export declare interface CallAdapterSubscribers {
 }
 
 /**
- * {@link CallAdapter} state for pure UI purposes.
+ * {@link CommonCallAdapter} state for pure UI purposes.
  *
  * @public
  */
@@ -1246,7 +1276,7 @@ export declare interface CallCompositeProps extends BaseCompositeProps<CallCompo
      * An adapter provides logic and data to the composite.
      * Composite can also be controlled using the adapter.
      */
-    adapter: CallAdapter;
+    adapter: CommonCallAdapter;
     /**
      * Optimizes the composite form factor for either desktop or mobile.
      * @remarks `mobile` is currently only optimized for Portrait mode on mobile devices and does not support landscape.
@@ -3440,6 +3470,36 @@ export declare type ClientState = CallClientState & ChatClientState;
  */
 export declare type Common<A, B> = Pick<A, CommonProperties<A, B>>;
 
+/**
+ * {@link CallComposite} Adapter interface.
+ *
+ * @public
+ */
+export declare interface CommonCallAdapter extends AdapterState<CallAdapterState>, Disposable, CallAdapterCallOperations, CallAdapterDeviceManagement, CallAdapterSubscribers {
+    /**
+     * Join the call with microphone initially on/off.
+     *
+     * @param microphoneOn - Whether microphone is initially enabled
+     *
+     * @public
+     */
+    joinCall(microphoneOn?: boolean): void;
+    /**
+     * Start the call.
+     *
+     * @param participants - An array of participant ids to join
+     *
+     * @public
+     */
+    startCall(participants: string[], options?: StartCallOptions): void;
+    /**
+     * Start the call.
+     * @param participants - An array of {@link @azure/communication-common#CommunicationIdentifier} to be called
+     * @beta
+     */
+    startCall(participants: CommunicationIdentifier[], options?: StartCallOptions): void;
+}
+
 /**
  * Object containing all the handlers required for calling components.
  *
@@ -4070,6 +4130,21 @@ export declare const createAzureCommunicationChatAdapter: ({ endpoint: endpointU
  */
 export declare const createAzureCommunicationChatAdapterFromClient: (chatClient: StatefulChatClient, chatThreadClient: ChatThreadClient) => Promise<ChatAdapter>;
 
+/**
+ * @beta
+ */
+export declare const createAzureCommunicationTeamsCallAdapter: ({ userId, credential, locator, alternateCallerId }: AzureCommunicationCallAdapterArgs) => Promise<TeamsCallAdapter>;
+
+/**
+ * Create a {@link TeamsCallAdapter} using the provided {@link StatefulCallClient}.
+ *
+ * Useful if you want to keep a reference to {@link StatefulCallClient}.
+ * Consider using {@link createAzureCommunicationCallAdapter} for a simpler API.
+ *
+ * @beta
+ */
+export declare const createAzureCommunicationTeamsCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: TeamsCallAgent, locator: CallAdapterLocator) => Promise<TeamsCallAdapter>;
+
 /**
  * Create the default implementation of {@link CallingHandlers} for teams call.
  *
@@ -5041,6 +5116,16 @@ export declare interface ErrorBarProps extends IMessageBarProps {
      * Currently active errors.
      */
     activeErrorMessages: ActiveErrorMessage[];
+    /**
+     * If set, errors with {@link ActiveErrorMessage.timestamp} older than the time this component is mounted
+     * are not shown.
+     *
+     * This is useful when using the {@link ErrorBar} with a stateful client that handles more than one call
+     * or chat thread. Set this prop to ignore errors from previous call or chat.
+     *
+     * @defaultValue false
+     */
+    ignorePremountErrors?: boolean;
 }
 
 /**
@@ -7488,6 +7573,36 @@ export declare interface SystemMessageCommon extends MessageCommon {
     iconName: string;
 }
 
+/**
+ * An Adapter interface specific for Teams identity which extends {@link CommonCallAdapter}.
+ *
+ * @beta
+ */
+export declare interface TeamsCallAdapter extends CommonCallAdapter {
+    /**
+     * Join the call with microphone initially on/off.
+     *
+     * @param microphoneOn - Whether microphone is initially enabled
+     *
+     * @beta
+     */
+    joinCall(microphoneOn?: boolean): TeamsCall | undefined;
+    /**
+     * Start the call.
+     *
+     * @param participants - An array of participant ids to join
+     *
+     * @beta
+     */
+    startCall(participants: string[], options?: StartCallOptions): TeamsCall | undefined;
+    /**
+     * Start the call.
+     * @param participants - An array of {@link @azure/communication-common#CommunicationIdentifier} to be called
+     * @beta
+     */
+    startCall(participants: CommunicationIdentifier[], options?: StartCallOptions): TeamsCall | undefined;
+}
+
 /**
  * Object containing all the teams call handlers required for calling components.
  *
@@ -7768,6 +7883,22 @@ export declare const useAzureCommunicationCallWithChatAdapter: (args: Partial<Az
  */
 export declare const useAzureCommunicationChatAdapter: (args: Partial<AzureCommunicationChatAdapterArgs>, afterCreate?: ((adapter: ChatAdapter) => Promise<ChatAdapter>) | undefined, beforeDispose?: ((adapter: ChatAdapter) => Promise<void>) | undefined) => ChatAdapter | undefined;
 
+/**
+ * A custom React hook to simplify the creation of {@link TeamsCallAdapter}.
+ *
+ * Similar to {@link createTeamsAzureCommunicationCallAdapter}, but takes care of asynchronous
+ * creation of the adapter internally.
+ *
+ * Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments
+ * as they are created. The adapter is only created when all arguments are defined.
+ *
+ * Note that you must memoize the arguments to avoid recreating adapter on each render.
+ * See storybook for typical usage examples.
+ *
+ * @beta
+ */
+export declare const useAzureCommunicationTeamsCallAdapter: (args: Partial<AzureCommunicationCallAdapterArgs>, afterCreate?: ((adapter: TeamsCallAdapter) => Promise<TeamsCallAdapter>) | undefined, beforeDispose?: ((adapter: TeamsCallAdapter) => Promise<void>) | undefined) => TeamsCallAdapter | undefined;
+
 /**
  * Hook to obtain {@link @azure/communication-calling#Call} from the provider.
  *
@@ -8212,6 +8343,10 @@ export declare interface VideoTileProps {
      */
     participantState?: ParticipantState;
     strings?: VideoTileStrings;
+    /**
+     * Callback triggered by video tile on touch and hold.
+     */
+    onLongTouch?: () => void;
 }
 
 /**