@microsoft/teams-js 2.2.0 → 2.3.0-beta.1

package/dist/MicrosoftTeams.d.ts

@@ -5,56 +5,86 @@
     * Namespace to interact with the logging part of the SDK.
     * This object is used to send the app logs on demand to the host client
     *
-    * Hide from docs
-    *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export namespace logs {
         /**
             * @hidden
-            * Hide from docs
-            * ------
+            *
             * Registers a handler for getting app log
             *
             * @param handler - The handler to invoke to get the app log
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function registerGetLogHandler(handler: () => string): void;
+        /**
+            * @hidden
+            *
+            * @returns boolean to represent whether the logs capability is supported
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
         function isSupported(): boolean;
 }
 
 /**
     * @hidden
-    * Hide from docs
-    * --------
+    *
     * Information about all members in a chat
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export interface ChatMembersInformation {
         members: ThreadMember[];
 }
 /**
     * @hidden
-    * Hide from docs
-    * --------
+    *
     * Information about a chat member
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export interface ThreadMember {
         /**
             * @hidden
             * The member's user principal name in the current tenant.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         upn: string;
 }
+/**
+    * @hidden
+    *
+    * @internal
+    * Limited to Microsoft-internal use
+    */
 export enum NotificationTypes {
         fileDownloadStart = "fileDownloadStart",
         fileDownloadComplete = "fileDownloadComplete"
 }
+/**
+    * @hidden
+    *
+    * @internal
+    * Limited to Microsoft-internal use
+    */
 export interface ShowNotificationParameters {
         message: string;
         notificationType: NotificationTypes;
 }
 /**
     * @hidden
-    * Hide from docs.
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export enum ViewerActionTypes {
         view = "view",
@@ -63,143 +93,197 @@ export enum ViewerActionTypes {
 }
 /**
     * @hidden
-    * Hide from docs.
-    * ------
+    *
     * User setting changes that can be subscribed to
     */
 export enum UserSettingTypes {
         /**
             * @hidden
             * Use this key to subscribe to changes in user's file open preference
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         fileOpenPreference = "fileOpenPreference",
         /**
             * @hidden
             * Use this key to subscribe to theme changes
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         theme = "theme"
 }
 /**
     * @hidden
-    * Hide from docs.
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export interface FilePreviewParameters {
         /**
             * @hidden
             * The developer-defined unique ID for the file.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         entityId: string;
         /**
             * @hidden
             * The display name of the file.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         title: string;
         /**
             * @hidden
             * An optional description of the file.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         description?: string;
         /**
             * @hidden
             * The file extension; e.g. pptx, docx, etc.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         type: string;
         /**
             * @hidden
             * A url to the source of the file, used to open the content in the user's default browser
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         objectUrl: string;
         /**
             * @hidden
             * Optional; an alternate self-authenticating url used to preview the file in Mobile clients and offer it for download by the user
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         downloadUrl?: string;
         /**
             * @hidden
             * Optional; an alternate url optimized for previewing the file in web and desktop clients
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         webPreviewUrl?: string;
         /**
             * @hidden
             * Optional; an alternate url that allows editing of the file in web and desktop clients
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         webEditUrl?: string;
         /**
             * @hidden
             * Optional; the base url of the site where the file is hosted
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         baseUrl?: string;
         /**
             * @hidden
-            * Deprecated; prefer using viewerAction instead
+            * Deprecated; prefer using {@linkcode viewerAction} instead
             * Optional; indicates whether the file should be opened in edit mode
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         editFile?: boolean;
         /**
             * @hidden
             * Optional; the developer-defined unique ID for the sub-entity to return to when the file stage closes.
             * This field should be used to restore to a specific state within an entity, such as scrolling to or activating a specific piece of content.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         subEntityId?: string;
         /**
             * @hidden
             * Optional; indicates the mode in which file should be opened. Takes precedence over edit mode.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         viewerAction?: ViewerActionTypes;
         /**
             * @hidden
             * Optional; indicates how user prefers to open the file
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         fileOpenPreference?: FileOpenPreference;
         /**
+            * @hidden
             * Optional; id required to enable conversation button in files. Will be channel id in case file is shared in a channel or the chat id in p2p chat case.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         conversationId?: string;
 }
 /**
     * @hidden
-    * Hide from docs
-    * --------
+    *
     * Query parameters used when fetching team information
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export interface TeamInstanceParameters {
         /**
             * @hidden
             * Flag allowing to select favorite teams only
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         favoriteTeamsOnly?: boolean;
 }
 /**
     * @hidden
-    * Hide from docs
-    * --------
+    *
     * Information on userJoined Teams
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export interface UserJoinedTeamsInformation {
         /**
             * @hidden
             * List of team information
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         userJoinedTeams: TeamInformation[];
 }
 
-/**
-    * @internal
-    */
-export function initializePrivateApis(): void;
 /**
     * @hidden
-    * Hide from docs.
-    * ------
     * Upload a custom App manifest directly to both team and personal scopes.
     * This method works just for the first party Apps.
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function uploadCustomApp(manifestBlob: Blob, onComplete?: (status: boolean, reason?: string) => void): void;
 /**
     * @hidden
-    * Internal use only
     * Sends a custom action MessageRequest to host or parent window
     *
     * @param actionName - Specifies name of the custom action to be sent
@@ -208,11 +292,11 @@ export function uploadCustomApp(manifestBlob: Blob, onComplete?: (status: boolea
     * @returns id of sent message
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function sendCustomMessage(actionName: string, args?: any[], callback?: (...args: any[]) => void): void;
 /**
     * @hidden
-    * Internal use only
     * Sends a custom action MessageEvent to a child iframe/window, only if you are not using auth popup.
     * Otherwise it will go to the auth popup (which becomes the child)
     *
@@ -221,17 +305,18 @@ export function sendCustomMessage(actionName: string, args?: any[], callback?: (
     * @returns id of sent message
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function sendCustomEvent(actionName: string, args?: any[]): void;
 /**
     * @hidden
-    * Internal use only
     * Adds a handler for an action sent by a child window or parent window
     *
     * @param actionName - Specifies name of the action message to handle
     * @param customHandler - The callback to invoke when the action message is received. The return value is sent to the child
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function registerCustomHandler(actionName: string, customHandler: (...args: any[]) => any[]): void;
 /**
@@ -242,94 +327,129 @@ export function registerCustomHandler(actionName: string, customHandler: (...arg
     * @param handler - When a subscribed setting is updated this handler is called
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function registerUserSettingsChangeHandler(settingTypes: UserSettingTypes[], handler: (settingType: UserSettingTypes, value: any) => void): void;
 /**
     * @hidden
-    * Hide from docs.
-    * ------
     * Opens a client-friendly preview of the specified file.
     *
     * @param file - The file to preview.
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export function openFilePreview(filePreviewParameters: FilePreviewParameters): void;
 
 /**
     * @hidden
-    * Hide from docs.
-    * ------
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export interface OpenConversationRequest {
         /**
             * @hidden
             * The Id of the subEntity where the conversation is taking place
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         subEntityId: string;
         /**
             * @hidden
             * The title of the conversation
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         title: string;
         /**
             * @hidden
             * The Id of the conversation. This is optional and should be specified whenever a previous conversation about a specific sub-entity has already been started before
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         conversationId?: string;
         /**
             * @hidden
             * The Id of the channel. This is optional and should be specified whenever a conversation is started or opened in a personal app scope
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         channelId?: string;
         /**
             * @hidden
             * The entity Id of the tab
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         entityId: string;
         /**
             * @hidden
             * A function that is called once the conversation Id has been created
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         onStartConversation?: (conversationResponse: ConversationResponse) => void;
         /**
             * @hidden
             * A function that is called if the pane is closed
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         onCloseConversation?: (conversationResponse: ConversationResponse) => void;
 }
 /**
     * @hidden
-    * Hide from docs.
-    * ------
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export interface ConversationResponse {
         /**
             * @hidden
+            *
+            * Limited to Microsoft-internal use
             * The Id of the subEntity where the conversation is taking place
             */
         subEntityId: string;
         /**
             * @hidden
             * The Id of the conversation. This is optional and should be specified whenever a previous conversation about a specific sub-entity has already been started before
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         conversationId?: string;
         /**
             * @hidden
             * The Id of the channel. This is optional and should be specified whenever a conversation is started or opened in a personal app scope
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         channelId?: string;
         /**
             * @hidden
             * The entity Id of the tab
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         entityId?: string;
 }
 /**
     * @hidden
     * Namespace to interact with the conversational subEntities inside the tab
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export namespace conversations {
         /**
@@ -339,13 +459,18 @@ export namespace conversations {
             * Allows the user to start or continue a conversation with each subentity inside the tab
             *
             * @returns Promise resolved upon completion
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function openConversation(openConversationRequest: OpenConversationRequest): Promise<void>;
         /**
             * @hidden
-            * Hide from docs
-            * --------------
+            *
             * Allows the user to close the conversation in the right pane
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function closeConversation(): void;
         /**
@@ -359,23 +484,34 @@ export namespace conversations {
             * @returns Promise resolved with information on all chat members
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getChatMembers(): Promise<ChatMembersInformation>;
+        /**
+            * @returns boolean to represent whether conversations capability is supported
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
         function isSupported(): boolean;
 }
 
 /**
     * @hidden
-    * Hide from docs
-    * ------
+    *
     * Namespace to interact with the files specific part of the SDK.
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export namespace files {
         /**
             * @hidden
-            * Hide from docs
-            * ------
+            *
             * Cloud storage providers registered with Microsoft Teams
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum CloudStorageProvider {
                 Dropbox = "DROPBOX",
@@ -396,10 +532,11 @@ export namespace files {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             *
             * External third-party cloud storages providers interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface IExternalProvider extends IWopiService {
                 providerType: CloudStorageProviderType;
@@ -407,9 +544,11 @@ export namespace files {
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Cloud storage provider type enums
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum CloudStorageProviderType {
                 Sharepoint = 0,
@@ -425,155 +564,231 @@ export namespace files {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             *
             * Cloud storage folder interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageFolder {
                 /**
                     * @hidden
                     * ID of the cloud storage folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 id: string;
                 /**
                     * @hidden
                     * Display Name/Title of the cloud storage folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 title: string;
                 /**
                     * @hidden
                     * ID of the cloud storage folder in the provider
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 folderId: string;
                 /**
                     * @hidden
                     * Type of the cloud storage folder provider integration
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 providerType: CloudStorageProviderType;
                 /**
                     * @hidden
                     * Code of the supported cloud storage folder provider
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 providerCode: CloudStorageProvider;
                 /**
                     * @hidden
                     * Display name of the owner of the cloud storage folder provider
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 ownerDisplayName: string;
                 /**
                     * @hidden
                     * Sharepoint specific siteURL of the folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 siteUrl?: string;
                 /**
                     * @hidden
                     * Sharepoint specific serverRelativeUrl of the folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 serverRelativeUrl?: string;
                 /**
                     * @hidden
                     * Sharepoint specific libraryType of the folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 libraryType?: string;
                 /**
                     * @hidden
                     * Sharepoint specific accessType of the folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 accessType?: string;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             *
             * Cloud storage item interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageFolderItem {
                 /**
                     * @hidden
                     * ID of the item in the provider
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 id: string;
                 /**
                     * @hidden
                     * Display name/title
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 title: string;
                 /**
                     * @hidden
                     * Key to differentiate files and subdirectory
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 isSubdirectory: boolean;
                 /**
                     * @hidden
                     * File extension
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 type: string;
                 /**
                     * @hidden
                     * Last modifed time of the item
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 lastModifiedTime: string;
                 /**
                     * @hidden
                     * Display size of the items in bytes
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 size: number;
                 /**
                     * @hidden
                     * URL of the file
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 objectUrl: string;
                 /**
                     * @hidden
                     * Temporary access token for the item
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 accessToken?: string;
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Files entity user interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface IFilesEntityUser {
                 /**
+                    * @hidden
                     * User name.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 displayName: string;
                 /**
+                    * @hidden
                     * User email.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 email: string;
                 /**
+                    * @hidden
                     * User MRI.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 mri: string;
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Special Document Library enum
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum SpecialDocumentLibraryType {
                 ClassMaterials = "classMaterials"
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Document Library Access enum
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum DocumentLibraryAccessType {
                 Readonly = "readonly"
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * SharePoint file interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface ISharePointFile {
                 siteId?: string;
@@ -600,9 +815,11 @@ export namespace files {
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Download status enum
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum FileDownloadStatus {
                 Downloaded = "Downloaded",
@@ -611,42 +828,76 @@ export namespace files {
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Download Files interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface IFileItem {
                 /**
+                    * @hidden
                     * ID of the file metadata
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 objectId?: string;
                 /**
+                    * @hidden
                     * Path of the file
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 path?: string;
                 /**
+                    * @hidden
                     * Size of the file in bytes
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 sizeInBytes?: number;
                 /**
+                    * @hidden
                     * Download status
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 status?: FileDownloadStatus;
                 /**
+                    * @hidden
                     * Download timestamp
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 timestamp: Date;
                 /**
+                    * @hidden
                     * File name
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 title: string;
                 /**
+                    * @hidden
                     * Type of file i.e. the file extension.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 extension: string;
         }
         /**
+            * @hidden
             * Object used to represent a file
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface File extends Blob {
                 /**
@@ -667,6 +918,9 @@ export namespace files {
             * Hide from docs
             *
             * Actions specific to 3P cloud storage provider file and / or account
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum CloudStorageProviderFileAction {
                 Download = "DOWNLOAD",
@@ -678,6 +932,9 @@ export namespace files {
             * Hide from docs
             *
             * Interface for 3P cloud storage provider request content type
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageProviderRequest<T> {
                 content: T;
@@ -687,6 +944,9 @@ export namespace files {
             * Hide from docs
             *
             * Base interface for 3P cloud storage provider action request content
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageProviderContent {
                 providerCode: CloudStorageProvider;
@@ -697,6 +957,9 @@ export namespace files {
             *
             * 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(.)
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageProviderNewFileContent extends CloudStorageProviderContent {
                 newFileName: string;
@@ -708,6 +971,9 @@ export namespace files {
             * Hide from docs
             *
             * Interface representing 3P cloud storage provider rename existing file action
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageProviderRenameFileContent extends CloudStorageProviderContent {
                 existingFile: CloudStorageFolderItem | ISharePointFile;
@@ -718,6 +984,9 @@ export namespace files {
             * Hide from docs
             *
             * Interface representing 3P cloud storage provider delete existing file(s) action
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageProviderDeleteFileContent extends CloudStorageProviderContent {
                 itemList: CloudStorageFolderItem[] | ISharePointFile[];
@@ -727,6 +996,9 @@ export namespace files {
             * Hide from docs
             *
             * Interface representing 3P cloud storage provider download existing file(s) action
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageProviderDownloadFileContent extends CloudStorageProviderContent {
                 itemList: CloudStorageFolderItem[] | ISharePointFile[];
@@ -736,6 +1008,9 @@ export namespace files {
             * Hide from docs
             *
             * Interface representing 3P cloud storage provider upload existing file(s) action
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageProviderUploadFileContent extends CloudStorageProviderContent {
                 itemList: File[];
@@ -748,6 +1023,9 @@ export namespace files {
             * Gets a list of cloud storage folders added to the channel
             * @param channelId - ID of the channel whose cloud storage folders should be retrieved
             * @param callback - Callback that will be triggered post folders load
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function getCloudStorageFolders(channelId: string, callback: (error: SdkError, folders: CloudStorageFolder[]) => void): void;
         /**
@@ -758,6 +1036,9 @@ export namespace files {
             *
             * @param channelId - ID of the channel to add cloud storage folder
             * @param callback - Callback that will be triggered post add folder flow is compelete
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function addCloudStorageFolder(channelId: string, callback: (error: SdkError, isFolderAdded: boolean, folders: CloudStorageFolder[]) => void): void;
         /**
@@ -770,6 +1051,9 @@ export namespace files {
             * @param channelId - ID of the channel where folder is to be deleted
             * @param folderToDelete - cloud storage folder to be deleted
             * @param callback - Callback that will be triggered post delete
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function deleteCloudStorageFolder(channelId: string, folderToDelete: CloudStorageFolder, callback: (error: SdkError, isFolderDeleted: boolean) => void): void;
         /**
@@ -782,6 +1066,9 @@ export namespace files {
             * @param folder - Cloud storage folder (CloudStorageFolder) / sub directory (CloudStorageFolderItem)
             * @param providerCode - Code of the cloud storage folder provider
             * @param callback - Callback that will be triggered post contents are loaded
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function getCloudStorageFolderContents(folder: CloudStorageFolder | CloudStorageFolderItem, providerCode: CloudStorageProvider, callback: (error: SdkError, items: CloudStorageFolderItem[]) => void): void;
         /**
@@ -794,6 +1081,9 @@ export namespace files {
             * @param file - cloud storage file that should be opened
             * @param providerCode - Code of the cloud storage folder provider
             * @param fileOpenPreference - Whether file should be opened in web/inline
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function openCloudStorageFile(file: CloudStorageFolderItem, providerCode: CloudStorageProvider, fileOpenPreference?: FileOpenPreference.Web | FileOpenPreference.Inline): void;
         /**
@@ -802,12 +1092,18 @@ export namespace files {
             * third party cloud storage accounts that the tenant supports
             * @param excludeAddedProviders: return a list of support third party
             * cloud storages that hasn't been added yet.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function getExternalProviders(excludeAddedProviders: boolean, callback: (error: SdkError, providers: IExternalProvider[]) => void): void;
         /**
             * @hidden
             * Allow 1st party apps to call this function to move files
             * among SharePoint and third party cloud storages.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function copyMoveFiles(selectedFiles: CloudStorageFolderItem[] | ISharePointFile[], providerCode: CloudStorageProvider, destinationFolder: CloudStorageFolderItem | ISharePointFile, destinationProviderCode: CloudStorageProvider, isMove: boolean, callback: (error?: SdkError) => void): void;
         /**
@@ -817,6 +1113,9 @@ export namespace files {
             *
             * Gets list of downloads for current user
             * @param callback Callback that will be triggered post downloads load
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function getFileDownloads(callback: (error?: SdkError, files?: IFileItem[]) => void): void;
         /**
@@ -826,6 +1125,9 @@ export namespace files {
             * Open download preference folder if fileObjectId value is undefined else open folder containing the file with id fileObjectId
             * @param fileObjectId - Id of the file whose containing folder should be opened
             * @param callback Callback that will be triggered post open download folder/path
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function openDownloadFolder(fileObjectId: string, callback: (error?: SdkError) => void): void;
         /**
@@ -837,6 +1139,9 @@ export namespace files {
             * 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
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function addCloudStorageProvider(callback: (error?: SdkError) => void): void;
         /**
@@ -849,6 +1154,9 @@ export namespace files {
             *
             * @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
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function removeCloudStorageProvider(logoutRequest: CloudStorageProviderRequest<CloudStorageProviderContent>, callback: (error?: SdkError) => void): void;
         /**
@@ -859,6 +1167,9 @@ 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
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function addCloudStorageProviderFile(addNewFileRequest: CloudStorageProviderRequest<CloudStorageProviderNewFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
         /**
@@ -869,6 +1180,9 @@ 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
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function renameCloudStorageProviderFile(renameFileRequest: CloudStorageProviderRequest<CloudStorageProviderRenameFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
         /**
@@ -880,6 +1194,9 @@ export namespace files {
             *
             * @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
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function deleteCloudStorageProviderFile(deleteFileRequest: CloudStorageProviderRequest<CloudStorageProviderDeleteFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
         /**
@@ -891,6 +1208,9 @@ export namespace files {
             *
             * @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
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function downloadCloudStorageProviderFile(downloadFileRequest: CloudStorageProviderRequest<CloudStorageProviderDownloadFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
         /**
@@ -901,6 +1221,9 @@ export namespace files {
             *
             * @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
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function uploadCloudStorageProviderFile(uploadFileRequest: CloudStorageProviderRequest<CloudStorageProviderUploadFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
         /**
@@ -912,6 +1235,7 @@ export namespace files {
             *
             * @param handler - When 3P cloud storage provider list is updated this handler is called
             *
+            * @internal Limited to Microsoft-internal use
             */
         export function registerCloudStorageProviderListChangeHandler(handler: () => void): void;
         /**
@@ -923,151 +1247,194 @@ export namespace files {
             *
             * @param handler - When 3P cloud storage provider content is updated this handler is called
             *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function registerCloudStorageProviderContentChangeHandler(handler: () => void): void;
         export {};
 }
 
+/**
+    * @hidden
+    *
+    * @internal
+    * Limited to Microsoft-internal use
+    */
 export namespace meetingRoom {
         /**
             * @hidden
-            * Hide from docs
-            * ------
+            *
             * Data structure to represent a meeting room.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface MeetingRoomInfo {
                 /**
                     * @hidden
                     * Endpoint id of the meeting room.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 endpointId: string;
                 /**
                     * @hidden
                     * Device name of the meeting room.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 deviceName: string;
                 /**
                     * @hidden
                     * Client type of the meeting room.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 clientType: string;
                 /**
                     * @hidden
                     * Client version of the meeting room.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 clientVersion: string;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Type of Media control capabilities of a meeting room.
             */
         type MediaControls = 'toggleMute' | 'toggleCamera' | 'toggleCaptions' | 'volume';
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Types of Stage Layout control capabilities of a meeting room.
             */
         type StageLayoutControls = 'showVideoGallery' | 'showContent' | 'showVideoGalleryAndContent' | 'showLargeGallery' | 'showTogether';
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Types of Meeting Control capabilities of a meeting room.
             */
         type MeetingControls = 'leaveMeeting';
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Types of Stage Layout State of a meeting room.
             */
         type StageLayoutStates = 'Gallery' | 'Content + gallery' | 'Content' | 'Large gallery' | 'Together mode';
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Data structure to represent capabilities of a meeting room.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface MeetingRoomCapability {
                 /**
                     * @hidden
                     * Media control capabilities, value can be "toggleMute", "toggleCamera", "toggleCaptions", "volume".
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 mediaControls: MediaControls[];
                 /**
                     * @hidden
                     * Main stage layout control capabilities, value can be "showVideoGallery", "showContent", "showVideoGalleryAndContent", "showLargeGallery", "showTogether".
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 stageLayoutControls: StageLayoutControls[];
                 /**
                     * @hidden
                     * Meeting control capabilities, value can be "leaveMeeting".
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 meetingControls: MeetingControls[];
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Data structure to represent states of a meeting room.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface MeetingRoomState {
                 /**
                     * @hidden
                     * Current mute state, true: mute, false: unmute.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 toggleMute: boolean;
                 /**
                     * @hidden
                     * Current camera state, true: camera on, false: camera off.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 toggleCamera: boolean;
                 /**
                     * @hidden
                     * Current captions state, true: captions on, false: captions off.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 toggleCaptions: boolean;
                 /**
                     * @hidden
                     * Current main stage layout state, value can be one of "Gallery", "Content + gallery", "Content", "Large gallery" and "Together mode".
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 stageLayout: StageLayoutStates;
                 /**
                     * @hidden
                     * Current leaveMeeting state, true: leave, false: no-op.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 leaveMeeting: boolean;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Fetch the meeting room info that paired with current client.
             *
             * @returns Promise resolved with meeting room info or rejected with SdkError value
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function getPairedMeetingRoomInfo(): Promise<MeetingRoomInfo>;
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Send a command to paired meeting room.
             *
             * @param commandName The command name.
             * @returns Promise resolved upon completion or rejected with SdkError value
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function sendCommandToPairedMeetingRoom(commandName: string): Promise<void>;
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Registers a handler for meeting room capabilities update.
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler The handler to invoke when the capabilities of meeting room update.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function registerMeetingRoomCapabilitiesUpdateHandler(handler: (capabilities: MeetingRoomCapability) => void): void;
         /**
@@ -1077,57 +1444,91 @@ export namespace meetingRoom {
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler The handler to invoke when the states of meeting room update.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        export function registerMeetingRoomStatesUpdateHandler(handler: (states: MeetingRoomState) => void): void;
+        /**
+            * @hidden
+            *
+            * @returns boolean to represent whether the meetingRoom capability is supported
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
-        export function registerMeetingRoomStatesUpdateHandler(handler: (states: MeetingRoomState) => void): void;
         export function isSupported(): boolean;
         export {};
 }
 
 export namespace notifications {
-    /**
-      * @hidden
-      * Hide from docs.
-      * ------
-      * display notification API.
-      *
-      * @param message - Notification message.
-      * @param notificationType - Notification type
-      *
-      * @internal
-      */
-    function showNotification(showNotificationParameters: ShowNotificationParameters): void;
-    function isSupported(): boolean;
+        /**
+            * @hidden
+            * display notification API.
+            *
+            * @param message - Notification message.
+            * @param notificationType - Notification type
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function showNotification(showNotificationParameters: ShowNotificationParameters): void;
+        /**
+            * @hidden
+            * @returns boolean to represent whether the notifications capability is supported
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function isSupported(): boolean;
 }
 
+/**
+    * @hidden
+    *
+    * @internal
+    * Limited to Microsoft-internal use
+    */
 export namespace remoteCamera {
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Data structure to represent patricipant details needed to request control of camera.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         interface Participant {
                 /**
                     * @hidden
                     * Id of participant.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 id: string;
                 /**
                     * @hidden
                     * Display name of participant.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 displayName?: string;
                 /**
                     * @hidden
                     * Active indicates whether the participant's device is actively being controlled.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 active?: boolean;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Enum used to indicate possible camera control commands.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         enum ControlCommand {
                 Reset = "Reset",
@@ -1140,62 +1541,90 @@ export namespace remoteCamera {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Data structure to indicate the current state of the device.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         interface DeviceState {
                 /**
                     * @hidden
                     * All operation are available to apply.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 available: boolean;
                 /**
                     * @hidden
                     * Either camera doesnt support to get state or It unable to apply command.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 error: boolean;
                 /**
                     * @hidden
                     * Reset max out or already applied. Client Disable Reset.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 reset: boolean;
                 /**
                     * @hidden
                     * ZoomIn maxed out.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 zoomIn: boolean;
                 /**
                     * @hidden
                     * ZoomOut maxed out.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 zoomOut: boolean;
                 /**
                     * @hidden
                     * PanLeft reached max left.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 panLeft: boolean;
                 /**
                     * @hidden
                     * PanRight reached max right.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 panRight: boolean;
                 /**
                     * @hidden
                     * TiltUp reached top.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 tiltUp: boolean;
                 /**
                     * @hidden
                     * TiltDown reached bottom.
+                    *
+                    * @internal Limited to Microsoft-internal use
                     */
                 tiltDown: boolean;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Enum used to indicate the reason for the error.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         enum ErrorReason {
                 CommandResetError = 0,
@@ -1209,27 +1638,35 @@ export namespace remoteCamera {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Data structure to indicate the status of the current session.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         interface SessionStatus {
                 /**
                     * @hidden
                     * Whether the far-end user is controlling a  device.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 inControl: boolean;
                 /**
                     * @hidden
                     * Reason the  control session was terminated.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 terminatedReason?: SessionTerminatedReason;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Enum used to indicate the reason the session was terminated.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         enum SessionTerminatedReason {
                 None = 0,
@@ -1246,20 +1683,19 @@ export namespace remoteCamera {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Fetch a list of the participants with controllable-cameras in a meeting.
             *
             * @param callback - Callback contains 2 parameters, error and participants.
             * error can either contain an error of type SdkError, incase of an error, or null when fetch is successful
             * participants can either contain an array of Participant objects, incase of a successful fetch or null when it fails
             * participants: object that contains an array of participants with controllable-cameras
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function getCapableParticipants(callback: (error: SdkError | null, participants: Participant[] | null) => void): void;
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Request control of a participant's camera.
             *
             * @param participant - Participant specifies the participant to send the request for camera control.
@@ -1267,25 +1703,30 @@ export namespace remoteCamera {
             * error can either contain an error of type SdkError, incase of an error, or null when fetch is successful
             * requestResponse can either contain the true/false value, incase of a successful request or null when it fails
             * requestResponse: True means request was accepted and false means request was denied
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function requestControl(participant: Participant, callback: (error: SdkError | null, requestResponse: boolean | null) => void): void;
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Send control command to the participant's camera.
             *
             * @param ControlCommand - ControlCommand specifies the command for controling the camera.
             * @param callback - Callback to invoke when the command response returns.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function sendControlCommand(ControlCommand: ControlCommand, callback: (error: SdkError | null) => void): void;
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Terminate the remote  session
             *
             * @param callback - Callback to invoke when the command response returns.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function terminateSession(callback: (error: SdkError | null) => void): void;
         /**
@@ -1294,6 +1735,9 @@ export namespace remoteCamera {
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler - The handler to invoke when the list of participants with controllable-cameras changes.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function registerOnCapableParticipantsChangeHandler(handler: (participantChange: Participant[]) => void): void;
         /**
@@ -1302,6 +1746,9 @@ export namespace remoteCamera {
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler - The handler to invoke when there is an error from the camera handler.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function registerOnErrorHandler(handler: (error: ErrorReason) => void): void;
         /**
@@ -1310,6 +1757,9 @@ export namespace remoteCamera {
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler - The handler to invoke when the controlled device changes state.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function registerOnDeviceStateChangeHandler(handler: (deviceStateChange: DeviceState) => void): void;
         /**
@@ -1318,46 +1768,76 @@ export namespace remoteCamera {
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler - The handler to invoke when the current session status changes.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function registerOnSessionStatusChangeHandler(handler: (sessionStatusChange: SessionStatus) => void): void;
+        /**
+            * @hidden
+            * @returns boolean to represent whether the remoteCamera capability is supported
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
         function isSupported(): boolean;
 }
 
 /**
     * @hidden
     * Namespace to interact with the application entities specific part of the SDK.
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export namespace appEntity {
         /**
             * @hidden
-            * Hide from docs
-            * --------
+            *
             * Information on an app entity
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         interface AppEntity {
                 /**
                     * @hidden
                     * ID of the application
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 appId: string;
                 /**
                     * @hidden
                     * URL for the application's icon
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 appIconUrl: string;
                 /**
                     * @hidden
                     * Content URL for the app entity
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 contentUrl: string;
                 /**
                     * @hidden
                     * The display name for the app entity
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 displayName: string;
                 /**
                     * @hidden
                     * Website URL for the app entity. It is meant to be opened by the user in a browser.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 websiteUrl: string;
         }
@@ -1373,12 +1853,20 @@ export namespace appEntity {
             * @param callback Callback that will be triggered once the app entity information is available.
             *                 The callback takes two arguments: an SdkError in case something happened (i.e.
             *                 no permissions to execute the API) and the app entity configuration, if available
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function selectAppEntity(threadId: string, categories: string[], subEntityId: string, callback: (sdkError?: SdkError, appEntity?: AppEntity) => void): void;
         /**
+            * @hidden
+            *
             * Checks if appEntity capability is supported by the host
             * @returns true if the appEntity capability is enabled in runtime.supports.appEntity and
             * false if it is disabled
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function isSupported(): boolean;
 }
@@ -1386,10 +1874,9 @@ export namespace appEntity {
 /**
     * @hidden
     * Namespace to interact with the `teams` specific part of the SDK.
-    * ------
-    * Hide from docs
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export namespace teams {
         enum ChannelType {
@@ -1397,6 +1884,12 @@ export namespace teams {
                 Private = 1,
                 Shared = 2
         }
+        /**
+            * @hidden
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
         interface ChannelInfo {
                 siteUrl: string;
                 objectId: string;
@@ -1406,11 +1899,12 @@ export namespace teams {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Get a list of channels belong to a Team
             *
             * @param groupId - a team's objectId
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function getTeamChannels(groupId: string, callback: (error: SdkError, channels: ChannelInfo[]) => void): void;
         /**
@@ -1420,6 +1914,9 @@ export namespace teams {
             *
             * @param threadId - ID of the thread where the app entity will be created; if threadId is not
             * provided, the threadId from route params will be used.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function refreshSiteUrl(threadId: string, callback: (error: SdkError) => void): void;
         /**
@@ -1428,55 +1925,65 @@ export namespace teams {
             *
             * @returns true if the teams capability is enabled in runtime.supports.teams and
             * false if it is disabled
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function isSupported(): boolean;
         /**
             * @hidden
-            * Hide from docs
-            * ------
-            *
             * @internal
+            * Limited to Microsoft-internal use
             */
         namespace fullTrust {
+                /**
+                    * @hidden
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    */
                 namespace joinedTeams {
                         /**
                             * @hidden
-                            * Hide from docs
-                            * ------
                             * Allows an app to retrieve information of all user joined teams
                             *
                             * @param teamInstanceParameters - Optional flags that specify whether to scope call to favorite teams
                             * @returns Promise that resolves with information about the user joined teams or rejects with an error when the operation has completed
+                            *
+                            * @internal
+                            * Limited to Microsoft-internal use
                             */
                         function getUserJoinedTeams(teamInstanceParameters?: TeamInstanceParameters): Promise<UserJoinedTeamsInformation>;
                         /**
                             * @hidden
-                            * Hide from docs
-                            * ------
                             * Checks if teams.fullTrust.joinedTeams capability is supported by the host
                             *
                             * @returns true if the teams.fullTrust.joinedTeams capability is enabled in
                             * runtime.supports.teams.fullTrust.joinedTeams and false if it is disabled
+                            *
+                            * @internal
+                            * Limited to Microsoft-internal use
                             */
                         function isSupported(): boolean;
                 }
                 /**
                     * @hidden
-                    * Hide from docs
-                    * ------
                     * Allows an app to get the configuration setting value
                     *
                     * @param key - The key for the config setting
                     * @returns Promise that resolves with the value for the provided configuration setting or rejects with an error when the operation has completed
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 function getConfigSetting(key: string): Promise<string>;
                 /**
                     * @hidden
-                    * Hide from docs
-                    * ------
                     * Checks if teams.fullTrust capability is supported by the host
                     * @returns true if the teams.fullTrust capability is enabled in runtime.supports.teams.fullTrust and
                     * false if it is disabled
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 function isSupported(): boolean;
         }
@@ -1542,13 +2049,12 @@ export namespace authentication {
         function getAuthToken(authTokenRequest?: AuthTokenRequest): void;
         /**
             * @hidden
-            * Hide from docs.
-            * ------
             * Requests the decoded Azure AD user identity on behalf of the app.
             *
             * @returns Promise that resolves with the {@link UserProfile}.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getUser(): Promise<UserProfile>;
         /**
@@ -1556,12 +2062,11 @@ export namespace authentication {
             * As of 2.0.0, please use {@link authentication.getUser authentication.getUser(): Promise\<UserProfile\>} instead.
             *
             * @hidden
-            * Hide from docs.
-            * ------
             * Requests the decoded Azure AD user identity on behalf of the app.
             *
             * @param userRequest - It passes success/failure callbacks in the userRequest object(deprecated)
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getUser(userRequest: UserRequest): void;
         /**
@@ -1656,26 +2161,34 @@ export namespace authentication {
         type AuthTokenRequest = AuthTokenRequestParameters & LegacyCallBacks;
         /**
             * @hidden
-            * Hide from docs.
-            * ------
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface UserProfile {
                 /**
                     * @hidden
                     * The intended recipient of the token. The application that receives the token must verify that the audience
                     * value is correct and reject any tokens intended for a different audience.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 aud: string;
                 /**
                     * @hidden
                     * Identifies how the subject of the token was authenticated.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 amr: string[];
                 /**
                     * @hidden
                     * Stores the time at which the token was issued. It is often used to measure token freshness.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 iat: number;
                 /**
@@ -1683,28 +2196,43 @@ export namespace authentication {
                     * Identifies the security token service (STS) that constructs and returns the token. In the tokens that Azure AD
                     * returns, the issuer is sts.windows.net. The GUID in the issuer claim value is the tenant ID of the Azure AD
                     * directory. The tenant ID is an immutable and reliable identifier of the directory.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 iss: string;
                 /**
                     * @hidden
                     * Provides the last name, surname, or family name of the user as defined in the Azure AD user object.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 family_name: string;
                 /**
                     * @hidden
                     * Provides the first or "given" name of the user, as set on the Azure AD user object.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 given_name: string;
                 /**
                     * @hidden
                     * Provides a human-readable value that identifies the subject of the token. This value is not guaranteed to
                     * be unique within a tenant and is designed to be used only for display purposes.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 unique_name: string;
                 /**
                     * @hidden
                     * Contains a unique identifier of an object in Azure AD. This value is immutable and cannot be reassigned or
                     * reused. Use the object ID to identify an object in queries to Azure AD.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 oid: string;
                 /**
@@ -1713,6 +2241,9 @@ export namespace authentication {
                     * This value is immutable and cannot be reassigned or reused, so it can be used to perform authorization
                     * checks safely. Because the subject is always present in the tokens the Azure AD issues, we recommended
                     * using this value in a general-purpose authorization system.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 sub: string;
                 /**
@@ -1720,6 +2251,9 @@ export namespace authentication {
                     * An immutable, non-reusable identifier that identifies the directory tenant that issued the token. You can
                     * use this value to access tenant-specific directory resources in a multitenant application. For example,
                     * you can use this value to identify the tenant in a call to the Graph API.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 tid: string;
                 /**
@@ -1728,6 +2262,9 @@ export namespace authentication {
                     * should verify that the current date is within the token lifetime; otherwise it should reject the token. The
                     * service might allow for up to five minutes beyond the token lifetime to account for any differences in clock
                     * time ("time skew") between Azure AD and the service.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 exp: number;
                 /**
@@ -1736,16 +2273,25 @@ export namespace authentication {
                     * should verify that the current date is within the token lifetime; otherwise it should reject the token. The
                     * service might allow for up to five minutes beyond the token lifetime to account for any differences in clock
                     * time ("time skew") between Azure AD and the service.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 nbf: number;
                 /**
                     * @hidden
                     * Stores the user name of the user principal.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 upn: string;
                 /**
                     * @hidden
                     * Stores the version number of the token.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 ver: string;
         }
@@ -1753,11 +2299,10 @@ export namespace authentication {
             * @deprecated
             * As of 2.0.0, this interface has been deprecated in favor of a Promise-based pattern.
             * @hidden
-            * Hide from docs.
-            * ------
             * Describes the UserRequest. Success callback describes how a successful request is handled.
             * Failure callback describes how a failed request is handled.
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface UserRequest {
                 /**
@@ -1862,6 +2407,7 @@ export interface TabInstance {
         tabName: string;
         /**
             * @internal
+            * Limited to Microsoft-internal use
             * @protected
             */
         internalTabInstanceId?: string;
@@ -2595,9 +3141,9 @@ export interface DialogSize {
 }
 /**
     * @hidden
-    * Hide from docs.
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export interface LoadContext {
         /**
@@ -3075,27 +3621,28 @@ export namespace app {
                     */
                 actionInfo?: ActionInfo;
                 /**
-                    * Info of the app
+                    * Properties about the current session for your app
                     */
                 app: AppInfo;
                 /**
-                    * Info of the current page of App
+                    * Info about the current page context hosting your app
                     */
                 page: PageInfo;
                 /**
-                    * Info of the user
+                    * Info about the currently logged in user running the app.
+                    * If the current user is not logged in/authenticated (e.g. a meeting app running for an anonymously-joined partcipant) this will be `undefined`.
                     */
                 user?: UserInfo;
                 /**
-                    * Info of the Microsoft Teams channel
+                    * When running in the context of a Teams channel, provides information about the channel, else `undefined`
                     */
                 channel?: ChannelInfo;
                 /**
-                    * Info of the Microsoft Teams chat
+                    * When running in the context of a Teams chat, provides information about the chat, else `undefined`
                     */
                 chat?: ChatInfo;
                 /**
-                    * Info of the Microsoft Teams meeting
+                    * When running in the context of a Teams meeting, provides information about the meeting, else `undefined`
                     */
                 meeting?: MeetingInfo;
                 /**
@@ -3103,11 +3650,13 @@ export namespace app {
                     */
                 sharepoint?: any;
                 /**
-                    * Info of the sharePoint site associated with the team.
+                    * When running in Teams for an organization with a tenant, provides information about the SharePoint site associated with the team.
+                    * Will be `undefined` when not running in Teams for an organization with a tenant.
                     */
                 sharePointSite?: SharePointSiteInfo;
                 /**
-                    * Info of the Microsoft Teams team
+                    * When running in Teams, provides information about the Team context in which your app is running.
+                    * Will be `undefined` when not running in Teams.
                     */
                 team?: TeamInfo;
         }
@@ -3135,20 +3684,18 @@ export namespace app {
         function initialize(validMessageOrigins?: string[]): Promise<void>;
         /**
             * @hidden
-            * Hide from docs.
-            * ------
             * Undocumented function used to set a mock window for unit tests
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function _initialize(hostWindow: any): void;
         /**
             * @hidden
-            * Hide from docs.
-            * ------
             * Undocumented function used to clear state between unit tests
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function _uninitialize(): void;
         /**
@@ -3354,10 +3901,11 @@ export namespace dialog {
         /**
             * @hidden
             * 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 initialization
             * @internal
+            * Limited to Microsoft-internal use
             */
         function initialize(): void;
         /**
@@ -3450,20 +3998,20 @@ export namespace dialog {
         }
         /**
             * @hidden
-            * Hide from docs
-            * --------
+            *
             * Convert UrlDialogInfo to DialogInfo to send the information to host in {@linkcode open} API.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getDialogInfoFromUrlDialogInfo(urlDialogInfo: UrlDialogInfo): DialogInfo;
         /**
             * @hidden
-            * Hide from docs
-            * --------
+            *
             * Convert BotUrlDialogInfo to DialogInfo to send the information to host in {@linkcode bot.open} API.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getDialogInfoFromBotUrlDialogInfo(botUrlDialogInfo: BotUrlDialogInfo): DialogInfo;
 }
@@ -3585,6 +4133,7 @@ export namespace pages {
             * @param handler - The handler for placing focus within the application.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function registerFocusEnterHandler(handler: (navigateForward: boolean) => void): void;
         /**
@@ -3738,9 +4287,10 @@ export namespace pages {
                 /**
                     * @hidden
                     * Hide from docs because this function is only used during initialization
-                    * ------------------
+                    *
                     * Adds register handlers for settings.save and settings.remove upon initialization. Function is called in {@link app.initializeHelper}
                     * @internal
+                    * Limited to Microsoft-internal use
                     */
                 function initialize(): void;
                 /**
@@ -3972,21 +4522,33 @@ export namespace menus {
         /**
             * @hidden
             * Represents information about item in View Configuration.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         interface ViewConfiguration {
                 /**
                     * @hidden
                     * Unique identifier of view.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 id: string;
                 /**
                     * @hidden
                     * Display title of the view.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 title: string;
                 /**
                     * @hidden
                     * Additional information for accessibility.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 contentDescription?: string;
         }
@@ -4569,10 +5131,10 @@ export namespace location {
 export namespace meeting {
         /**
             * @hidden
-            * Hide from docs
-            * Data structure to represent a meeting details
+            * Data structure to represent meeting details
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface IMeetingDetailsResponse {
                 /**
@@ -4638,10 +5200,10 @@ export namespace meeting {
         }
         /**
             * @hidden
-            * Hide from docs
             * Data structure to represent a conversation object.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface IConversation {
                 /**
@@ -4652,10 +5214,10 @@ export namespace meeting {
         }
         /**
             * @hidden
-            * Hide from docs
             * Data structure to represent an organizer object.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface IOrganizer {
                 /**
@@ -4795,8 +5357,6 @@ export namespace meeting {
         function toggleIncomingClientAudio(callback: (error: SdkError | null, result: boolean | null) => void): void;
         /**
             * @hidden
-            * Hide from docs
-            *
             * Allows an app to get the meeting details for the meeting
             *
             * @param callback - Callback contains 2 parameters, error and meetingDetailsResponse.
@@ -4804,6 +5364,7 @@ export namespace meeting {
             * result can either contain a IMeetingDetailsResponse value, in case of a successful get or null when the get fails
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getMeetingDetails(callback: (error: SdkError | null, meetingDetails: IMeetingDetailsResponse | null) => void): void;
         /**
@@ -4815,6 +5376,7 @@ export namespace meeting {
             * authenticationTokenOfAnonymousUser can either contain a string value, incase of a successful get or null when the get fails
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getAuthenticationTokenForAnonymousUser(callback: (error: SdkError | null, authenticationTokenOfAnonymousUser: string | null) => void): void;
         /**
@@ -4924,10 +5486,10 @@ export namespace meeting {
 export namespace monetization {
         /**
             * @hidden
-            * Hide from docs
             * Data structure to represent a subscription plan.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface PlanInfo {
                 /**
@@ -4943,7 +5505,6 @@ export namespace monetization {
         }
         /**
             * @hidden
-            * Hide from docs
             * Open dialog to start user's purchase experience
             *
             * @param planInfo optional parameter. It contains info of the subscription plan pushed to users.
@@ -4951,6 +5512,7 @@ export namespace monetization {
             * @returns Promise that will be resolved when the operation has completed or rejected with SdkError value
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function openPurchaseExperience(planInfo?: PlanInfo): Promise<void>;
         /**
@@ -4958,7 +5520,6 @@ export namespace monetization {
             * As of 2.0.0, please use {@link monetization.openPurchaseExperience monetization.openPurchaseExperience(planInfo?: PlanInfo): Promise\<void\>} instead.
             *
             * @hidden
-            * Hide from docs
             * Open dialog to start user's purchase experience
             *
             * @param callback Callback contains 1 parameters, error.
@@ -4966,6 +5527,7 @@ export namespace monetization {
             * error can either contain an error of type SdkError, incase of an error, or null when get is successful
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function openPurchaseExperience(callback: (error: SdkError | null) => void, planInfo?: PlanInfo): void;
         function isSupported(): boolean;
@@ -5251,6 +5813,10 @@ export namespace video {
                     * RGB stride, valid only when video frame format is RGB
                     */
                 stride?: number;
+                /**
+                    * The time stamp of the current video frame
+                    */
+                timestamp?: number;
         }
         /**
             * Video frame format enum, currently only support NV12
@@ -5324,6 +5890,92 @@ export namespace video {
         function isSupported(): boolean;
 }
 
+/**
+    * Allows your application to interact with the host M365 application's search box.
+    * By integrating your application with the host's search box, users can search
+    * your app using the same search box they use elsewhere in Teams, Outlook, or Office.
+    *
+    * This functionality is in Beta.
+    * @beta
+    */
+export namespace search {
+        /**
+            * This interface contains information pertaining to the contents of the host M365 application's search box
+            *
+            * @beta
+            */
+        interface SearchQuery {
+                /** The current search term in the host search experience */
+                searchTerm: string;
+                /** Timestamp sequence value to ensure messages are processed in correct order / combine them. */
+                timestamp: number;
+        }
+        /**
+            * This type will store the SearchQuery and allow other logic to be made inside the handler.
+            *
+            * @beta
+            */
+        type SearchQueryHandler = (query: SearchQuery) => void;
+        /**
+            * Allows the caller to register for various events fired by the host search experience.
+            * Calling this function indicates that your application intends to plug into the host's search box and handle search events,
+            * when the user is actively using your page/tab.
+            *
+            * The host may visually update its search box, e.g. with the name or icon of your application.
+            *
+            * Your application should *not* re-render inside of these callbacks, there may be a large number
+            * of onChangeHandler calls if the user is typing rapidly in the search box.
+            *
+            * @param onChangeHandler - This optional handler will be called when the user first starts using the
+            * host's search box and as the user types their query. Can be used to put your application into a
+            * word-wheeling state or to display suggestions as the user is typing.
+            *
+            * This handler will be called with an empty {@link SearchQuery.searchTerm} when search is beginning, and subsequently,
+            * with the current contents of the search box.
+            *
+            * @param onClosedHandler - This handler will be called when the user exits or cancels their search.
+            * Should be used to return your application to its most recent, non-search state. The value of {@link SearchQuery.searchTerm}
+            * will be whatever the last query was before ending search.
+            *
+            * @param onExecuteHandler - The handler will be called when the user executes their
+            * search (by pressing Enter for example). Should be used to display the full list of search results.
+            * The value of {@link SearchQuery.searchTerm} is the complete query the user entered in the search box.
+            *
+            * @example
+            * ``` ts
+            * search.registerHandlers(
+                query => {
+                    console.log(`Update your application with the changed search query: ${query.searchTerm}`);
+                },
+                query => {
+                    console.log('Update your application to handle the search experience being closed. Last query: ${query.searchTerm}');
+                },
+                query => {
+                    console.log(`Update your application to handle an executed search result: ${query.searchTerm}`);
+                },
+             );
+            * ```
+            *
+            * @beta
+            */
+        function registerHandlers(onClosedHandler: SearchQueryHandler, onExecuteHandler: SearchQueryHandler, onChangeHandler?: SearchQueryHandler): void;
+        /**
+            * Allows the caller to unregister for all events fired by the host search experience. Calling
+            * this function will cause your app to stop appearing in the set of search scopes in the hosts
+            *
+            * @beta
+            */
+        function unregisterHandlers(): void;
+        /**
+            * Checks if search capability is supported by the host
+            * @returns true if the search capability is supported by the host and false otherwise
+            * false if it is disabled
+            *
+            * @beta
+            */
+        function isSupported(): boolean;
+}
+
 export namespace sharing {
         export const SharingAPIMessages: {
                 shareWebContent: string;
@@ -5568,11 +6220,10 @@ export function initialize(callback?: () => void, validMessageOrigins?: string[]
     * As of 2.0.0, please use {@link app._initialize app._initialize(hostWindow: any): void} instead.
     *
     * @hidden
-    * Hide from docs.
-    * ------
     * Undocumented function used to set a mock window for unit tests
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function _initialize(hostWindow: any): void;
 /**
@@ -5580,11 +6231,10 @@ export function _initialize(hostWindow: any): void;
     * As of 2.0.0, please use {@link app._uninitialize app._uninitialize(): void} instead.
     *
     * @hidden
-    * Hide from docs.
-    * ------
     * Undocumented function used to clear state between unit tests
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function _uninitialize(): void;
 /**