@microsoft/teams-js 2.1.0-beta.5 → 2.2.0-beta.0

package/dist/MicrosoftTeams.d.ts

@@ -645,6 +645,23 @@ export namespace files {
                     */
                 extension: string;
         }
+        /**
+            * Object used to represent a file
+            */
+        export interface File extends Blob {
+                /**
+                    * Last modified timestamp
+                    */
+                lastModified: Date;
+                /**
+                    * Name of the file
+                    */
+                name: string;
+                /**
+                    * The file path to uniquely identify it within the file hierarchy
+                    */
+                filePath: string;
+        }
         /**
             * @hidden
             * Hide from docs
@@ -684,6 +701,7 @@ export namespace files {
         export interface CloudStorageProviderNewFileContent extends CloudStorageProviderContent {
                 newFileName: string;
                 newFileExtension: string;
+                destinationFolder: CloudStorageFolderItem | ISharePointFile;
         }
         /**
             * @hidden
@@ -699,12 +717,30 @@ export namespace files {
             * @hidden
             * Hide from docs
             *
-            * Interface representing 3P cloud storage provider actions like Upload / Download / Delete file(s)
+            * Interface representing 3P cloud storage provider delete existing file(s) action
+            */
+        export interface CloudStorageProviderDeleteFileContent extends CloudStorageProviderContent {
+                itemList: CloudStorageFolderItem[] | ISharePointFile[];
+        }
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Interface representing 3P cloud storage provider download existing file(s) action
             */
-        export interface CloudStorageProviderActionContent extends CloudStorageProviderContent {
-                action: CloudStorageProviderFileAction;
+        export interface CloudStorageProviderDownloadFileContent extends CloudStorageProviderContent {
                 itemList: CloudStorageFolderItem[] | ISharePointFile[];
         }
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Interface representing 3P cloud storage provider upload existing file(s) action
+            */
+        export interface CloudStorageProviderUploadFileContent extends CloudStorageProviderContent {
+                itemList: File[];
+                destinationFolder: CloudStorageFolderItem | ISharePointFile;
+        }
         /**
             * @hidden
             * Hide from docs
@@ -824,7 +860,7 @@ export namespace files {
             * @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;
+        export function addCloudStorageProviderFile(addNewFileRequest: CloudStorageProviderRequest<CloudStorageProviderNewFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
         /**
             * @hidden
             * Hide from docs
@@ -834,21 +870,39 @@ export namespace files {
             * @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;
+        export function renameCloudStorageProviderFile(renameFileRequest: CloudStorageProviderRequest<CloudStorageProviderRenameFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Initiates the delete 3P cloud storage file(s) / folder (folder has to be empty) flow,
+            * which will delete existing file(s) / folder from the given 3P provider
+            *
+            * @param deleteFileRequest 3P cloud storage provider delete action request content
+            * @param callback Callback that will be triggered post deleting existing file(s) flow is finished
+            */
+        export function deleteCloudStorageProviderFile(deleteFileRequest: CloudStorageProviderRequest<CloudStorageProviderDeleteFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
         /**
             * @hidden
             * Hide from docs
             *
-            * Initiates the 3P cloud storage provider file action (Upload / Download / Delete) flow
+            * Initiates the download 3P cloud storage file(s) flow,
+            * which will download existing file(s) from the given 3P provider in the teams client side without sharing any file info in the callback
             *
-            * 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 downloadFileRequest 3P cloud storage provider download file(s) action request content
+            * @param callback Callback that will be triggered post downloading existing file(s) flow is finished
+            */
+        export function downloadCloudStorageProviderFile(downloadFileRequest: CloudStorageProviderRequest<CloudStorageProviderDownloadFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
+        /**
+            * @hidden
+            * Hide from docs
             *
-            * @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
+            * Initiates the upload 3P cloud storage file(s) flow, which will upload file(s) to the given 3P provider
+            *
+            * @param uploadFileRequest 3P cloud storage provider upload file(s) action request content
+            * @param callback Callback that will be triggered post uploading file(s) flow is finished
             */
-        export function performCloudStorageProviderFileAction(cloudStorageProviderFileActionRequest: CloudStorageProviderRequest<CloudStorageProviderActionContent>, callback: (error?: SdkError) => void): void;
+        export function uploadCloudStorageProviderFile(uploadFileRequest: CloudStorageProviderRequest<CloudStorageProviderUploadFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
         /**
             * @hidden
             * Hide from docs
@@ -1931,20 +1985,95 @@ export enum FileOpenPreference {
         Desktop = "desktop",
         Web = "web"
 }
+/**
+    * Possible Action Types
+    *
+    * @beta
+    */
+export enum ActionObjectType {
+        M365Content = "m365content"
+}
+/**
+    * Data pertaining to object(s) the action is being performed on
+    *
+    * @param T The type of action being implemented
+    *
+    * @beta
+    */
+export interface BaseActionObject<T extends ActionObjectType> {
+        type: T;
+}
+/**
+    * Stores information needed to represent M365 Content stored
+    * in OneDrive or Sharepoint
+    *
+    * @beta
+    */
+export interface M365ContentAction extends BaseActionObject<ActionObjectType.M365Content> {
+        /**
+            * Only office content IDs are passed to the app. Apps should use these ids
+            * to query the Microsoft graph for more details.
+            */
+        itemId: string;
+        secondaryId?: SecondaryId;
+}
+/**
+    * Contains information on what Graph item is being queried
+    *
+    * @beta
+    */
+export interface SecondaryId {
+        name: SecondaryM365ContentIdName;
+        value: string;
+}
+/**
+    * These correspond with field names in the MSGraph
+    *
+    * @beta
+    */
+export enum SecondaryM365ContentIdName {
+        DriveId = "driveId",
+        GroupId = "groupId",
+        SiteId = "siteId",
+        UserId = "userId"
+}
+/**
+    * Information common to all actions
+    *
+    * @beta
+    */
+export interface ActionInfo {
+        /**
+            * Maps to the action id supplied inside the manifest
+            */
+        actionId: string;
+        /**
+            * Array of corresponding action objects
+            */
+        actionObjects: BaseActionObject<ActionObjectType>[];
+}
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link app.Context} instead.
+    * As of 2.0.0, please use the {@link app.Context} interface and its updated properties instead.
     *
     * @remarks
-    * For more details on the updated {@link app.Context} interface, visit
-    * {@link https://docs.microsoft.com/microsoftteams/platform/tabs/how-to/using-teams-client-sdk#updates-to-the-context-interface}.
+    * For more details about the updated {@link app.Context} interface, visit the
+    * [Teams JavaScript client SDK](https://docs.microsoft.com/microsoftteams/platform/tabs/how-to/using-teams-client-sdk#updates-to-the-context-interface)
+    * overview article.
     *
     * Represents the structure of the received context message.
     */
 export interface Context {
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.groupId} instead
+            * As of 2.0.0, please use {@link ActionInfo | app.Context.actionInfo} instead
+            *
+            * Common information applicable to all content actions
+            */
+        actionInfo?: ActionInfo;
+        /**
+            * @deprecated
+            * As of 2.0.0, please use {@link app.TeamInfo.groupId | app.Context.team.groupId} instead
             *
             * The Office 365 group ID for the team with which the content is associated.
             * This field is available only when the identity permission is requested in the manifest.
@@ -1952,49 +2081,49 @@ export interface Context {
         groupId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.internalId} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.internalId | app.Context.team.internalId} instead
             *
             * The Microsoft Teams ID for the team with which the content is associated.
             */
         teamId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.displayName} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.displayName | app.Context.team.displayName} instead
             *
             * The name for the team with which the content is associated.
             */
         teamName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.id} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.id | app.Context.channel.id} instead
             *
             * The Microsoft Teams ID for the channel with which the content is associated.
             */
         channelId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.displayName} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.displayName | app.Context.channel.displayName} instead
             *
             * The name for the channel with which the content is associated.
             */
         channelName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.membershipType} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.membershipType | app.Context.channel.membershipType} instead
             *
             * The type of the channel with which the content is associated.
             */
         channelType?: ChannelType;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.id} instead
+            * As of 2.0.0, please use {@link app.PageInfo.id | app.Context.page.id} instead
             *
             * The developer-defined unique ID for the entity this content points to.
             */
         entityId: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.subPageId} instead
+            * As of 2.0.0, please use {@link app.PageInfo.subPageId | app.Context.page.subPageId} instead
             *
             * The developer-defined unique ID for the sub-entity this content points to.
             * This field should be used to restore to a specific state within an entity,
@@ -2003,7 +2132,7 @@ export interface Context {
         subEntityId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.locale} instead
+            * As of 2.0.0, please use {@link app.AppInfo.locale | app.Context.app.locale} instead
             *
             * The current locale that the user has configured for the app formatted as
             * languageId-countryId (for example, en-us).
@@ -2011,7 +2140,7 @@ export interface Context {
         locale: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.osLocaleInfo} instead
+            * As of 2.0.0, please use {@link app.AppInfo.osLocaleInfo | app.Context.app.osLocaleInfo} instead
             *
             * More detailed locale info from the user's OS if available. Can be used together with
             * the @microsoft/globe NPM package to ensure your app respects the user's OS date and
@@ -2021,7 +2150,8 @@ export interface Context {
         /**
             * @deprecated
             *
-            * As of 2.0.0, please use {@link app.Context.user.loginHint} or {@link app.Context.user.userPrincipalName} instead.
+            * As of 2.0.0, please use {@link app.UserInfo.loginHint | app.Context.user.loginHint} or
+            * {@link app.UserInfo.userPrincipalName | app.Context.user.userPrincipalName} instead.
             * The UPN of the current user.
             * Because a malicious party can run your content in a browser, this value should
             * be used only as a hint as to who the user is and never as proof of identity.
@@ -2030,7 +2160,7 @@ export interface Context {
         upn?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.tenant.id} instead
+            * As of 2.0.0, please use {@link app.TenantInfo.id | app.Context.user.tenant.id} instead
             *
             * The Azure AD tenant ID of the current user.
             * Because a malicious party can run your content in a browser, this value should
@@ -2040,77 +2170,77 @@ export interface Context {
         tid?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.theme} instead
+            * As of 2.0.0, please use {@link app.AppInfo.theme | app.Context.app.theme} instead
             *
             * The current UI theme.
             */
         theme?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.isFullScreen} instead
+            * As of 2.0.0, please use {@link app.PageInfo.isFullScreen | app.Context.page.isFullScreen} instead
             *
             * Indication whether the tab is in full-screen mode.
             */
         isFullScreen?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.type} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.type | app.Context.team.type} instead
             *
             * The type of the team.
             */
         teamType?: TeamType;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.teamSiteUrl} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSiteUrl | app.Context.sharePointSite.teamSiteUrl} instead
             *
             * The root SharePoint site associated with the team.
             */
         teamSiteUrl?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.teamSiteDomain} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSiteDomain | app.Context.sharePointSite.teamSiteDomain} instead
             *
             * The domain of the root SharePoint site associated with the team.
             */
         teamSiteDomain?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.teamSitePath} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSitePath | app.Context.sharePointSite.teamSitePath} instead
             *
             * The relative path to the SharePoint site associated with the team.
             */
         teamSitePath?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.ownerTeamTenantId} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.ownerTenantId | app.Context.channel.ownerTenantId} instead
             *
             * The tenant ID of the host team.
             */
         hostTeamTenantId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.ownerGroupId} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.ownerGroupId | app.Context.channel.ownerGroupId} instead
             *
             * The AAD group ID of the host team.
             */
         hostTeamGroupId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.relativeUrl} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.relativeUrl | app.Context.channel.relativeUrl} instead
             *
             * The relative path to the SharePoint folder associated with the channel.
             */
         channelRelativeUrl?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.host.sessionId} instead
+            * As of 2.0.0, please use {@link app.AppHostInfo.sessionId | app.Context.app.host.sessionId} instead
             *
             * Unique ID for the current Teams session for use in correlating telemetry data.
             */
         sessionId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.userRole} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.userRole | app.Context.team.userRole} instead
             *
             * The user's role in the team.
             * Because a malicious party can run your content in a browser, this value should
@@ -2119,14 +2249,14 @@ export interface Context {
         userTeamRole?: UserTeamRole;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.chat.id} instead
+            * As of 2.0.0, please use {@link app.ChatInfo.id | app.Context.chat.id} instead
             *
             * The Microsoft Teams ID for the chat with which the content is associated.
             */
         chatId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.loginHint} instead
+            * As of 2.0.0, please use {@link app.UserInfo.loginHint | app.Context.user.loginHint} instead
             *
             * A value suitable for use as a login_hint when authenticating with Azure AD.
             * Because a malicious party can run your content in a browser, this value should
@@ -2136,7 +2266,7 @@ export interface Context {
         loginHint?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.userPrincipalName} instead
+            * As of 2.0.0, please use {@link app.UserInfo.userPrincipalName | app.Context.user.userPrincipalName} instead
             *
             * The UPN of the current user. This may be an externally-authenticated UPN (e.g., guest users).
             * Because a malicious party run your content in a browser, this value should
@@ -2146,7 +2276,7 @@ export interface Context {
         userPrincipalName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.id} instead
+            * As of 2.0.0, please use {@link app.UserInfo.id | app.Context.user.id} instead
             *
             * The Azure AD object id of the current user.
             * Because a malicious party run your content in a browser, this value should
@@ -2156,7 +2286,7 @@ export interface Context {
         userObjectId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.isArchived} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.isArchived | app.Context.team.isArchived} instead
             *
             * Indicates whether team is archived.
             * Apps should use this as a signal to prevent any changes to content associated with archived teams.
@@ -2164,14 +2294,14 @@ export interface Context {
         isTeamArchived?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.host.name} instead
+            * As of 2.0.0, please use {@link app.AppHostInfo.name | app.Context.app.host.name} instead
             *
             * The name of the host client. Possible values are: Office, Orange, Outlook, Teams
             */
         hostName?: HostName;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.host.clientType} instead
+            * As of 2.0.0, please use {@link app.AppHostInfo.clientType | app.Context.app.host.clientType} instead
             *
             * The type of the host client. Possible values are : android, ios, web, desktop, rigel(deprecated, use teamsRoomsWindows instead),
             * surfaceHub, teamsRoomsWindows, teamsRoomsAndroid, teamsPhones, teamsDisplays
@@ -2179,35 +2309,35 @@ export interface Context {
         hostClientType?: HostClientType;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.frameContext} instead
+            * As of 2.0.0, please use {@link app.PageInfo.frameContext | app.Context.page.frameContext} instead
             *
             * The context where tab url is loaded (content, task, setting, remove, sidePanel)
             */
         frameContext?: FrameContexts;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharepoint} instead
+            * As of 2.0.0, please use {@link app.Context | app.Context.sharepoint} instead
             *
             * SharePoint context. This is only available when hosted in SharePoint.
             */
         sharepoint?: any;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.tenant.teamsSku} instead
+            * As of 2.0.0, please use {@link app.TenantInfo.teamsSku | app.Context.tenant.teamsSku} instead
             *
             * The type of license for the current users tenant.
             */
         tenantSKU?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.licenseType} instead
+            * As of 2.0.0, please use {@link app.UserInfo.licenseType | app.Context.user.licenseType} instead
             *
             * The license type for the current user.
             */
         userLicenseType?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.parentMessageId} instead
+            * As of 2.0.0, please use {@link app.AppInfo.parentMessageId | app.Context.app.parentMessageId} instead
             *
             * The ID of the parent message from which this task module was launched.
             * This is only available in task modules launched from bot cards.
@@ -2215,119 +2345,119 @@ export interface Context {
         parentMessageId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.host.ringId} instead
+            * As of 2.0.0, please use {@link app.AppHostInfo.ringId | app.Context.app.host.ringId} instead
             *
             * Current ring ID
             */
         ringId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.sessionId} instead
+            * As of 2.0.0, please use {@link app.AppInfo.sessionId | app.Context.app.sessionId} instead
             *
             * Unique ID for the current session for use in correlating telemetry data.
             */
         appSessionId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.appLaunchId} instead
+            * As of 2.0.0, please use {@link app.AppInfo.appLaunchId | app.Context.app.appLaunchId} instead
             *
             * ID for the current visible app which is different for across cached sessions. Used for correlating telemetry data``
             */
         appLaunchId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.isCallingAllowed} instead
+            * As of 2.0.0, please use {@link app.UserInfo.isCallingAllowed | app.Context.user.isCallingAllowed} instead
             *
             * Represents whether calling is allowed for the current logged in User
             */
         isCallingAllowed?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.isPSTNCallingAllowed} instead
+            * As of 2.0.0, please use {@link app.UserInfo.isPSTNCallingAllowed | app.Context.user.isPSTNCallingAllowed} instead
             *
             * Represents whether PSTN calling is allowed for the current logged in User
             */
         isPSTNCallingAllowed?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.meeting.id} instead
+            * As of 2.0.0, please use {@link app.MeetingInfo.id | app.Context.meeting.id} instead
             *
             * Meeting Id used by tab when running in meeting context
             */
         meetingId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.defaultOneNoteSectionId} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.defaultOneNoteSectionId | app.Context.channel.defaultOneNoteSectionId} instead
             *
             * The OneNote section ID that is linked to the channel.
             */
         defaultOneNoteSectionId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.isMultiWindow} instead
+            * As of 2.0.0, please use {@link app.PageInfo.isMultiWindow | app.Context.page.isMultiWindow} instead
             *
             * Indication whether the tab is in a pop out window
             */
         isMultiWindow?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.iconPositionVertical} instead
+            * As of 2.0.0, please use {@link app.AppInfo.iconPositionVertical | app.Context.app.iconPositionVertical} instead
             *
             * Personal app icon y coordinate position
             */
         appIconPosition?: number;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.sourceOrigin} instead
+            * As of 2.0.0, please use {@link app.PageInfo.sourceOrigin | app.Context.page.sourceOrigin} instead
             *
             * Source origin from where the tab is opened
             */
         sourceOrigin?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.userClickTime} instead
+            * As of 2.0.0, please use {@link app.AppInfo.userClickTime | app.Context.app.userClickTime} instead
             *
             * Time when the user clicked on the tab
             */
         userClickTime?: number;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.templateId} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.templateId | app.Context.team.templateId} instead
             *
             * Team Template ID if there was a Team Template associated with the creation of the team.
             */
         teamTemplateId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.userFileOpenPreference} instead
+            * As of 2.0.0, please use {@link app.AppInfo.userFileOpenPreference | app.Context.app.userFileOpenPreference} instead
             *
             * Where the user prefers the file to be opened from by default during file open
             */
         userFileOpenPreference?: FileOpenPreference;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.displayName} instead
+            * As of 2.0.0, please use {@link app.UserInfo.displayName | app.Context.user.displayName} instead
             *
             * The address book name of the current user.
             */
         userDisplayName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.teamSiteId} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSiteId | app.Context.sharePointSite.teamSiteId} instead
             *
             * Teamsite ID, aka sharepoint site id.
             */
         teamSiteId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.mySiteDomain} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.mySiteDomain | app.Context.sharePointSite.mySiteDomain} instead
             *
             * The SharePoint my site domain associated with the user.
             */
         mySiteDomain?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.mySitePath} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.mySitePath | app.Context.sharePointSite.mySitePath} instead
             *
             * The SharePoint relative path to the current users mysite
             */
@@ -2938,6 +3068,12 @@ export namespace app {
             * Represents structure of the received context message.
             */
         interface Context {
+                /**
+                    * Content Action Info
+                    *
+                    * @beta
+                    */
+                actionInfo?: ActionInfo;
                 /**
                     * Info of the app
                     */
@@ -3070,11 +3206,15 @@ export namespace appInstallDialog {
 
 /**
     * Namespace to interact with the barcode scanning-specific part of the SDK.
+    *
+    * @beta
     */
 export namespace barCode {
         /**
             * Data structure to customize the barcode scanning experience in scanBarCode API.
             * All properties in BarCodeConfig are optional and have default values in the platform
+            *
+            * @beta
             */
         interface BarCodeConfig {
                 /**
@@ -3089,24 +3229,32 @@ export namespace barCode {
             * @param barCodeConfig - input configuration to customize the barcode scanning experience
             *
             * @returns a scanned code
+            *
+            * @beta
             */
         function scanBarCode(barCodeConfig: BarCodeConfig): Promise<string>;
         /**
             * Checks whether or not media has user permission
             *
             * @returns true if the user has granted the app permission to media information, false otherwise
+            *
+            * @beta
             */
         function hasPermission(): Promise<boolean>;
         /**
             * Requests user permission for media
             *
             * @returns true if the user has granted the app permission to the media, false otherwise
+            *
+            * @beta
             */
         function requestPermission(): Promise<boolean>;
         /**
             * Checks if barCode capability is supported by the host
             *
             * @returns boolean to represent whether barCode is supported
+            *
+            * @beta
             */
         function isSupported(): boolean;
 }
@@ -3208,7 +3356,7 @@ export namespace dialog {
             * Hide from docs because this function is only used during initialization
             * ------------------
             * Adds register handlers for messageForChild upon initialization and only in the tasks FrameContext. {@link FrameContexts.task}
-            * Function is called during app intitialization
+            * Function is called during app initialization
             * @internal
             */
         function initialize(): void;
@@ -3226,7 +3374,7 @@ export namespace dialog {
             */
         function open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void;
         /**
-            * Submit the dialog module.
+            * Submit the dialog module and close the dialog
             *
             * @param result - The result to be sent to the bot or the app. Typically a JSON object or a serialized version of it
             * @param appIds - Helps to validate that the call originates from the same appId as the one that invoked the task module
@@ -4211,9 +4359,7 @@ export namespace media {
                 notifyEventToApp(mediaEvent: MediaControllerEvent): void;
         }
         /**
-            * @hidden
-            * Hide from docs
-            * --------
+            * @beta
             * Events which are used to communicate between the app and the host client during the media recording flow
             */
         export enum MediaControllerEvent {
@@ -4550,12 +4696,20 @@ export namespace meeting {
                     */
                 isAppSharing: boolean;
         }
+        /**
+            * Property bag for the speakingState changed event
+            *
+            */
         interface ISpeakingState {
                 /**
                     * Indicates whether one or more participants in a meeting are speaking, or
                     * if no participants are speaking
                     */
                 isSpeakingDetected: boolean;
+                /**
+                    * error object in case there is a failure
+                    */
+                error?: SdkError;
         }
         /**
             * Property bag for the meeting reaction received event
@@ -4738,9 +4892,9 @@ export namespace meeting {
             */
         function getAppContentStageSharingState(callback: (error: SdkError | null, appContentStageSharingState: IAppContentStageSharingState | null) => void): void;
         /**
-            * Registers a handler for changes to paticipant speaking states. If any participant is speaking, isSpeakingDetected
-            * will be true. If no participants are speaking, isSpeakingDetected will be false. Only one handler can be registered
-            * at a time. A subsequent registration replaces an existing registration.
+            * Registers a handler for changes to paticipant speaking states. This API returns {@link ISpeakingState}, which will have isSpeakingDetected
+            * and/or an error object. If any participant is speaking, isSpeakingDetected will be true. If no participants are speaking, isSpeakingDetected
+            * will be false. Default value is false. Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler The handler to invoke when the speaking state of any participant changes (start/stop speaking).
             */
@@ -5590,7 +5744,7 @@ export function getMruTabInstances(callback: (tabInfo: TabInformation) => void,
 export function shareDeepLink(deepLinkParameters: DeepLinkParameters): void;
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link app.openLink core.openLink(deepLink: string): Promise\<void\>} instead.
+    * As of 2.0.0, please use {@link app.openLink app.openLink(deepLink: string): Promise\<void\>} instead.
     *
     * Execute deep link API.
     *
@@ -5610,7 +5764,7 @@ export function setFrameContext(frameContext: FrameContext): void;
     * @deprecated
     * As of 2.0.0, please use {@link pages.initializeWithFrameContext pages.initializeWithFrameContext(frameInfo: FrameInfo, callback?: () => void, validMessageOrigins?: string[],): void} instead.
     *
-    * Initilize with FrameContext
+    * Initialize with FrameContext
     *
     * @param frameContext - FrameContext information to be set
     * @param callback - The optional callback to be invoked be invoked after initilizing the frame context
@@ -5808,7 +5962,7 @@ export namespace tasks {
         function getBotUrlDialogInfoFromTaskInfo(taskInfo: TaskInfo): BotUrlDialogInfo;
         /**
             * Sets the height and width of the {@link TaskInfo} object to the original height and width, if initially specified,
-            * otherwise uses the height and width values corresponding to {@link TaskModuleDimension.Small}
+            * otherwise uses the height and width values corresponding to {@link TaskModuleDimension | TaskModuleDimension.Small}
             * @param taskInfo TaskInfo object from which to extract size info, if specified
             * @returns TaskInfo with height and width specified
             */