@microsoft/teams-js 2.0.0-beta.7 → 2.1.0-beta.0

package/README.md

@@ -2,7 +2,7 @@
 
 Welcome to the Teams JavaScript client SDK! For breaking changes, please refer to our [changelog](./CHANGELOG.md) in the current `<root>/packages/teams-js` directory.
 
-This JavaScript library is part of the [Microsoft Teams developer platform](https://docs.microsoft.com/en-us/microsoftteams/platform/overview?view=msteams-client-js-beta). See full [SDK reference documentation](https://docs.microsoft.com/en-us/javascript/api/overview/msteams-client?view=msteams-client-js-beta).
+This JavaScript library is part of the [Microsoft Teams developer platform](https://docs.microsoft.com/en-us/microsoftteams/platform/). See full [SDK reference documentation](https://docs.microsoft.com/javascript/api/overview/msteams-client?view=msteams-client-js-latest).
 
 ## Getting Started
 
@@ -12,19 +12,19 @@ Whenever building or testing the Teams client SDK, you can run `yarn build` or `
 
 ## Installation
 
-To install the latest [2.0 preview version](https://docs.microsoft.com/en-us/javascript/api/overview/msteams-client?view=msteams-client-js-beta):
+To install the stable [version](https://docs.microsoft.com/javascript/api/overview/msteams-client?view=msteams-client-js-latest):
 
 ### npm
 
-`npm install --save @microsoft/teams-js@next`
+`npm install --save @microsoft/teams-js`
 
 ### yarn
 
-`yarn add @microsoft/teams-js@next`
+`yarn add @microsoft/teams-js`
 
 ### Production
 
-You can access [these files on unpkg](https://res.cdn.office.net/teams-js/2.0.0-beta.7/js/MicrosoftTeams.min.js), download them, or point your package manager to them.
+You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.0.0/js/MicrosoftTeams.min.js) or point your package manager at them.
 
 ## Usage
 
@@ -45,13 +45,13 @@ Reference the SDK inside of your `.html` page using:
 ```html
 <!-- Microsoft Teams JavaScript API (via CDN) -->
 <script
-  src="https://res.cdn.office.net/teams-js/2.0.0-beta.7/js/MicrosoftTeams.min.js"
-  integrity="sha384-u9MstnkqBQI9EtqTMRCoqno88AbVbKQ/iEN3UJqBUaIBSW3wEYsWEOTp3Im6mCdn"
+  src="https://res.cdn.office.net/teams-js/2.0.0/js/MicrosoftTeams.min.js"
+  integrity="sha384-QtTBFeFlfRDZBfwHJHYQp7MdLJ2C3sfAEB1Qpy+YblvjavBye+q87TELpTnvlXw4"
   crossorigin="anonymous"
 ></script>
 
 <!-- Microsoft Teams JavaScript API (via npm) -->
-<script src="node_modules/@microsoft/teams-js@2.0.0-beta.7/dist/MicrosoftTeams.min.js"></script>
+<script src="node_modules/@microsoft/teams-js@2.0.0/dist/MicrosoftTeams.min.js"></script>
 
 <!-- Microsoft Teams JavaScript API (via local) -->
 <script src="MicrosoftTeams.min.js"></script>

package/dist/MicrosoftTeams.d.ts

@@ -645,6 +645,66 @@ export namespace files {
                     */
                 extension: string;
         }
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Actions specific to 3P cloud storage provider file and / or account
+            */
+        export enum CloudStorageProviderFileAction {
+                Download = "DOWNLOAD",
+                Upload = "UPLOAD",
+                Delete = "DELETE"
+        }
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Interface for 3P cloud storage provider request content type
+            */
+        export interface CloudStorageProviderRequest<T> {
+                content: T;
+        }
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Base interface for 3P cloud storage provider action request content
+            */
+        export interface CloudStorageProviderContent {
+                providerCode: CloudStorageProvider;
+        }
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Interface representing 3P cloud storage provider add new file action.
+            * The file extension represents type of file e.g. docx, pptx etc. and need not be prefixed with dot(.)
+            */
+        export interface CloudStorageProviderNewFileContent extends CloudStorageProviderContent {
+                newFileName: string;
+                newFileExtension: string;
+        }
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Interface representing 3P cloud storage provider rename existing file action
+            */
+        export interface CloudStorageProviderRenameFileContent extends CloudStorageProviderContent {
+                existingFile: CloudStorageFolderItem | ISharePointFile;
+                newFile: CloudStorageFolderItem | ISharePointFile;
+        }
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Interface representing 3P cloud storage provider actions like Upload / Download / Delete file(s)
+            */
+        export interface CloudStorageProviderActionContent extends CloudStorageProviderContent {
+                action: CloudStorageProviderFileAction;
+                itemList: CloudStorageFolderItem[] | ISharePointFile[];
+        }
         /**
             * @hidden
             * Hide from docs
@@ -732,6 +792,85 @@ export namespace files {
             * @param callback Callback that will be triggered post open download folder/path
             */
         export function openDownloadFolder(fileObjectId: string, callback: (error?: SdkError) => void): void;
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Initiates add 3P cloud storage provider flow, where a pop up window opens for user to select required
+            * 3P provider from the configured policy supported 3P provider list, following which user authentication
+            * for selected 3P provider is performed on success of which the selected 3P provider support is added for user
+            *
+            * @param callback Callback that will be triggered post add 3P cloud storage provider action
+            */
+        export function addCloudStorageProvider(callback: (error?: SdkError) => void): void;
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Initiates signout of 3P cloud storage provider flow, which will remove the selected
+            * 3P cloud storage provider from the list of added providers. No other user input and / or action
+            * is required except the 3P cloud storage provider to signout from
+            *
+            * @param logoutRequest 3P cloud storage provider remove action request content
+            * @param callback Callback that will be triggered post signout of 3P cloud storage provider action
+            */
+        export function removeCloudStorageProvider(logoutRequest: CloudStorageProviderRequest<CloudStorageProviderContent>, callback: (error?: SdkError) => void): void;
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Initiates the add 3P cloud storage file flow, which will add a new file for the given 3P provider
+            *
+            * @param addNewFileRequest 3P cloud storage provider add action request content
+            * @param callback Callback that will be triggered post adding a new file flow is finished
+            */
+        export function addCloudStorageProviderFile(addNewFileRequest: CloudStorageProviderRequest<CloudStorageProviderNewFileContent>, callback: (error?: SdkError) => void): void;
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Initiates the rename 3P cloud storage file flow, which will rename an existing file in the given 3P provider
+            *
+            * @param renameFileRequest 3P cloud storage provider rename action request content
+            * @param callback Callback that will be triggered post renaming an existing file flow is finished
+            */
+        export function renameCloudStorageProviderFile(renameFileRequest: CloudStorageProviderRequest<CloudStorageProviderRenameFileContent>, callback: (error?: SdkError) => void): void;
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Initiates the 3P cloud storage provider file action (Upload / Download / Delete) flow
+            *
+            * Upload Action : Allows uploading file(s) to the given 3P cloud storage provider
+            * Download Action : Allows downloading file(s) from the given 3P cloud storage provider
+            * Delete Action : Allows deleting file(s) from the given 3P cloud storage provider
+            *
+            * @param cloudStorageProviderFileActionRequest 3P cloud storage provider file action (Upload / Download / Delete) request content
+            * @param callback Callback that will be triggered post 3P cloud storage action
+            */
+        export function performCloudStorageProviderFileAction(cloudStorageProviderFileActionRequest: CloudStorageProviderRequest<CloudStorageProviderActionContent>, callback: (error?: SdkError) => void): void;
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Register a handler to be called when a user's 3P cloud storage provider list changes i.e.
+            * post adding / removing a 3P provider, list is updated
+            *
+            * @param handler - When 3P cloud storage provider list is updated this handler is called
+            *
+            */
+        export function registerCloudStorageProviderListChangeHandler(handler: () => void): void;
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Register a handler to be called when a user's 3P cloud storage provider content changes i.e.
+            * when file(s) is/are added / renamed / deleted / uploaded, the list of files is updated
+            *
+            * @param handler - When 3P cloud storage provider content is updated this handler is called
+            *
+            */
+        export function registerCloudStorageProviderContentChangeHandler(handler: () => void): void;
         export {};
 }
 
@@ -4152,6 +4291,57 @@ export namespace meeting {
                     */
                 isSpeakingDetected: boolean;
         }
+        /**
+            * Property bag for the meeting reaction received event
+            *
+            * @beta
+            */
+        interface MeetingReactionReceivedEventData {
+                /**
+                    * Indicates the type of meeting reaction received
+                    */
+                meetingReactionType?: MeetingReactionType;
+                /**
+                    * error object in case there is a failure
+                    */
+                error?: SdkError;
+        }
+        /**
+            * Interface for raiseHandState properties
+            *
+            * @beta
+            */
+        interface IRaiseHandState {
+                /** Indicates whether the selfParticipant's hand is raised or not*/
+                isHandRaised: boolean;
+        }
+        /**
+            * Property bag for the raiseHandState changed event
+            *
+            * @beta
+            */
+        interface RaiseHandStateChangedEventData {
+                /**
+                    * entire raiseHandState object for the selfParticipant
+                    */
+                raiseHandState: IRaiseHandState;
+                /**
+                    * error object in case there is a failure
+                    */
+                error?: SdkError;
+        }
+        /**
+            * Different types of meeting reactions that can be sent/received
+            *
+            * @beta
+            */
+        enum MeetingReactionType {
+                like = "like",
+                heart = "heart",
+                laugh = "laugh",
+                surprised = "surprised",
+                applause = "applause"
+        }
         enum MeetingType {
                 Unknown = "Unknown",
                 Adhoc = "Adhoc",
@@ -4289,6 +4479,26 @@ export namespace meeting {
             * @param handler The handler to invoke when the speaking state of any participant changes (start/stop speaking).
             */
         function registerSpeakingStateChangeHandler(handler: (speakingState: ISpeakingState) => void): void;
+        /**
+            * Registers a handler for changes to the selfParticipant's (current user's) raiseHandState. If the selfParticipant raises their hand, isHandRaised
+            * will be true. By default and if the selfParticipant hand is lowered, isHandRaised will be false. This API will return {@link RaiseHandStateChangedEvent}
+            * that will have the raiseHandState or an error object. Only one handler can be registered at a time. A subsequent registration
+            * replaces an existing registration.
+            *
+            * @param handler The handler to invoke when the selfParticipant's (current user's) raiseHandState changes.
+            *
+            * @beta
+            */
+        function registerRaiseHandStateChangedHandler(handler: (eventData: RaiseHandStateChangedEventData) => void): void;
+        /**
+            * Registers a handler for receiving meeting reactions. When the selfParticipant (current user) successfully sends a meeting reaction and it is being rendered on the UI, the meetingReactionType will be populated. Only one handler can be registered
+            * at a time. A subsequent registration replaces an existing registration.
+            *
+            * @param handler The handler to invoke when the selfParticipant (current user) successfully sends a meeting reaction
+            *
+            * @beta
+            */
+        function registerMeetingReactionReceivedHandler(handler: (eventData: MeetingReactionReceivedEventData) => void): void;
 }
 
 export namespace monetization {
@@ -4499,6 +4709,94 @@ export namespace people {
         function isSupported(): boolean;
 }
 
+/**
+    * Namespace for profile related APIs.
+    *
+    * @beta
+    */
+export namespace profile {
+        /**
+            * Opens a profile card at a specified position to show profile information about a persona.
+            * @param showProfileRequest The parameters to position the card and identify the target user.
+            * @returns Promise that will be fulfilled when the operation has completed
+            */
+        function showProfile(showProfileRequest: ShowProfileRequest): Promise<void>;
+        /**
+            * The type of modalities that are supported when showing a profile.
+            * Can be provided as an optional hint with the request and will be
+            * respected if the hosting M365 application supports it.
+            */
+        type Modality = 'Card' | 'Expanded';
+        /**
+            * The type of the profile trigger.
+            *  - MouseHover: The user hovered a target.
+            *  - MouseClick: The user clicked a target.
+            *  - KeyboardPress: The user initiated the show profile request with their keyboard.
+            *  - AppRequest: The show profile request is happening programmatically, without direct user interaction.
+            */
+        type TriggerType = 'MouseHover' | 'MouseClick' | 'KeyboardPress' | 'AppRequest';
+        /**
+            * The set of identifiers that are supported for resolving the persona.
+            *
+            * At least one is required, and if multiple are provided then only the highest
+            * priority one will be used (AadObjectId > Upn > Smtp).
+            */
+        type PersonaIdentifiers = {
+                /**
+                    * The object id in Azure Active Directory.
+                    *
+                    * This id is guaranteed to be unique for an object within a tenant,
+                    * and so if provided will lead to a more performant lookup. It can
+                    * be resolved via MS Graph (see https://docs.microsoft.com/en-us/graph/api/resources/users
+                    * for examples).
+                    */
+                readonly AadObjectId?: string;
+                /**
+                    * The primary SMTP address.
+                    */
+                readonly Smtp?: string;
+                /**
+                    * The user principle name.
+                    */
+                readonly Upn?: string;
+        };
+        /**
+            * The persona to show the profile for.
+            */
+        interface Persona {
+                /**
+                    * The set of identifiers that are supported for resolving the persona.
+                    */
+                identifiers: PersonaIdentifiers;
+                /**
+                    * Optional display name override. If not specified the user's display name will be resolved normally.
+                    */
+                displayName?: string;
+        }
+        /**
+            * Input parameters provided to the showProfile API.
+            */
+        interface ShowProfileRequest {
+                /**
+                    * An optional hint to the hosting M365 application about which modality of the profile you want to show.
+                    */
+                modality?: Modality;
+                /**
+                    * The information about the persona to show the profile for.
+                    */
+                persona: Persona;
+                /**
+                    * The bounding rectangle of the target.
+                    */
+                targetElementBoundingRect: DOMRect;
+                /**
+                    * Specifies which user interaction was used to trigger the API call.
+                    */
+                triggerType: TriggerType;
+        }
+        function isSupported(): boolean;
+}
+
 /**
     * Namespace to video extensibility of the SDK
     */
@@ -4691,26 +4989,40 @@ export namespace stageView {
 }
 
 export namespace call {
-    enum CallModalities {
-        Unknown = "unknown",
-        Audio = "audio",
-        Video = "video",
-        VideoBasedScreenSharing = "videoBasedScreenSharing",
-        Data = "data"
-    }
-    interface StartCallParams {
-        targets: string[];
-        requestedModalities?: CallModalities[];
-        source?: string;
-    }
-    /**
-      * Starts a call with other users
-      *
-      * @param startCallParams - Parameters for the call
-      * @returns If the call is accepted
-      */
-    function startCall(startCallParams: StartCallParams): Promise<boolean>;
-    function isSupported(): boolean;
+        enum CallModalities {
+                Unknown = "unknown",
+                Audio = "audio",
+                Video = "video",
+                VideoBasedScreenSharing = "videoBasedScreenSharing",
+                Data = "data"
+        }
+        interface StartCallParams {
+                /**
+                    * Comma-separated list of user IDs representing the participants of the call.
+                    *
+                    * @remarks
+                    * Currently the User ID field supports the Azure AD UserPrincipalName,
+                    * typically an email address, or in case of a PSTN call, it supports a pstn
+                    * mri 4:<phonenumber>.
+                    */
+                targets: string[];
+                /**
+                    * List of modalities for the call. Defaults to [“audio”].
+                    */
+                requestedModalities?: CallModalities[];
+                /**
+                    * An optional parameter that informs about the source of the deep link
+                    */
+                source?: string;
+        }
+        /**
+            * Starts a call with other users
+            *
+            * @param startCallParams - Parameters for the call
+            * @returns If the call is accepted
+            */
+        function startCall(startCallParams: StartCallParams): Promise<boolean>;
+        function isSupported(): boolean;
 }
 
 /**