@microsoft/teams-js 2.19.1-beta.0 → 2.20.0-beta.1

package/dist/MicrosoftTeams.d.ts

@@ -276,14 +276,6 @@ export interface UserJoinedTeamsInformation {
         userJoinedTeams: TeamInformation[];
 }
 
-/**
-    * @hidden
-    * 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
@@ -1393,7 +1385,9 @@ export namespace files {
             * @hidden
             * Hide from docs
             *
-            * Gets a list of cloud storage folders added to the channel
+            * Gets a list of cloud storage folders added to the channel. This function will not timeout;
+            * the callback will only return when the host responds with a list of folders or error.
+            *
             * @param channelId - ID of the channel whose cloud storage folders should be retrieved
             * @param callback - Callback that will be triggered post folders load
             *
@@ -1861,12 +1855,6 @@ export namespace notifications {
         function isSupported(): boolean;
 }
 
-/**
-    * @hidden
-    *
-    * @internal
-    * Limited to Microsoft-internal use
-    */
 export namespace remoteCamera {
         /**
             * @hidden
@@ -2254,13 +2242,6 @@ export namespace appEntity {
         function isSupported(): boolean;
 }
 
-/**
-    * @hidden
-    * Namespace to interact with the `teams` specific part of the SDK.
-    *
-    * @internal
-    * Limited to Microsoft-internal use
-    */
 export namespace teams {
         enum ChannelType {
                 Regular = 0,
@@ -2376,14 +2357,6 @@ export namespace teams {
         }
 }
 
-/**
-    * @hidden
-    * Extended video API
-    * @beta
-    *
-    * @internal
-    * Limited to Microsoft-internal use
-    */
 export namespace videoEffectsEx {
         const frameProcessingTimeoutInMs = 2000;
         /**
@@ -2649,10 +2622,10 @@ export namespace authentication {
             * @param authenticateParameters - Parameters describing the authentication window used for executing the authentication flow
             *
             * @returns `Promise` that will be fulfilled with the result from the authentication pop-up, if successful. The string in this result is provided in the parameter
-            * passed by your app when it calls {@link notifySuccess} in the pop-up window after returning from the identity provider redirect.
+            * passed by your app when it calls {@link authentication.notifySuccess authentication.notifySuccess(result?: string): void} in the pop-up window after returning from the identity provider redirect.
             *
             * @throws `Error` if the authentication request fails or is canceled by the user. This error is provided in the parameter passed by your app when it calls
-            * {@link notifyFailure} in the pop-up window after returning from the identity provider redirect. However, in some cases it can also be provided by
+            * {@link authentication.notifyFailure authentication.notifyFailure(result?: string): void} in the pop-up window after returning from the identity provider redirect. However, in some cases it can also be provided by
             * the infrastructure depending on the failure (e.g., a user cancelation)
             *
             */
@@ -2730,9 +2703,8 @@ export namespace authentication {
             *
             * @param result - Specifies a result for the authentication. If specified, the frame that initiated the authentication pop-up receives
             * this value in its callback or via the `Promise` return value
-            * @param callbackUrl - Specifies the url to redirect back to if the client is Win32 Outlook.
             */
-        function notifySuccess(result?: string, callbackUrl?: string): void;
+        function notifySuccess(result?: string): void;
         /**
             * When using {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>}, the
             * window that was opened to execute the authentication flow should call this method after authentiction to notify the caller of
@@ -2746,9 +2718,9 @@ export namespace authentication {
             *
             * @param result - Specifies a result for the authentication. If specified, the frame that initiated the authentication pop-up receives
             * this value in its callback or via the `Promise` return value
-            * @param callbackUrl - Specifies the url to redirect back to if the client is Win32 Outlook.
+            * @param _callbackUrl - This parameter is deprecated and unused
             */
-        function notifyFailure(reason?: string, callbackUrl?: string): void;
+        function notifyFailure(result?: string): void;
         /**
             * @deprecated
             * As of 2.0.0, this interface has been deprecated in favor of leveraging the `Promise` returned from {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>}
@@ -2824,6 +2796,10 @@ export namespace authentication {
                     * An optional flag indicating whether to attempt the token acquisition silently or allow a prompt to be shown.
                     */
                 silent?: boolean;
+                /**
+                    * An optional identifier of the home tenant for which to acquire the acess token for (used in cross-tenant shared channels).
+                    */
+                tenantId?: string;
         }
         /**
             * @deprecated
@@ -4995,35 +4971,55 @@ export namespace dialog {
                     */
                 function submit(result?: string | object, appIds?: string | string[]): void;
                 /**
-                    *  Send message to the parent from dialog
+                    * Subcapability that allows communication between the dialog and the parent app.
                     *
                     * @remarks
-                    * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
-                    *
-                    * @param message - The message to send to the parent
+                    * Note that dialog can be invoked from parentless scenarios e.g. Search Message Extensions. The subcapability `parentCommunication` is not supported in such scenarios.
                     *
                     * @beta
                     */
-                function sendMessageToParentFromDialog(message: any): void;
-                /**
-                    *  Send message to the dialog from the parent
-                    *
-                    * @param message - The message to send
-                    *
-                    * @beta
-                    */
-                function sendMessageToDialog(message: any): void;
-                /**
-                    * Register a listener that will be triggered when a message is received from the app that opened the dialog.
-                    *
-                    * @remarks
-                    * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
-                    *
-                    * @param listener - The listener that will be triggered.
-                    *
-                    * @beta
-                    */
-                function registerOnMessageFromParent(listener: PostMessageChannel): void;
+                namespace parentCommunication {
+                        /**
+                            *  Send message to the parent from dialog
+                            *
+                            * @remarks
+                            * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
+                            *
+                            * @param message - The message to send to the parent
+                            *
+                            * @beta
+                            */
+                        function sendMessageToParentFromDialog(message: any): void;
+                        /**
+                            *  Send message to the dialog from the parent
+                            *
+                            * @param message - The message to send
+                            *
+                            * @beta
+                            */
+                        function sendMessageToDialog(message: any): void;
+                        /**
+                            * Register a listener that will be triggered when a message is received from the app that opened the dialog.
+                            *
+                            * @remarks
+                            * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
+                            *
+                            * @param listener - The listener that will be triggered.
+                            *
+                            * @beta
+                            */
+                        function registerOnMessageFromParent(listener: PostMessageChannel): void;
+                        /**
+                            * Checks if dialog.url.parentCommunication capability is supported by the host
+                            *
+                            * @returns boolean to represent whether dialog.url.parentCommunication capability is supported
+                            *
+                            * @throws Error if {@linkcode app.initialize} has not successfully completed
+                            *
+                            * @beta
+                            */
+                        function isSupported(): boolean;
+                }
                 /**
                     * Checks if dialog.url module is supported by the host
                     *
@@ -5285,6 +5281,9 @@ export function getTabInstancesHelper(apiVersionTag: string, tabInstanceParamete
 export function getMruTabInstancesHelper(apiVersionTag: string, tabInstanceParameters?: TabInstanceParameters): Promise<TabInformation>;
 export function shareDeepLinkHelper(apiVersionTag: string, deepLinkParameters: ShareDeepLinkParameters): void;
 export function setCurrentFrameHelper(apiVersionTag: string, frameInfo: FrameInfo): void;
+export function configSetValidityStateHelper(apiVersionTag: string, validityState: boolean): void;
+export function getConfigHelper(apiVersionTag: string): Promise<pages.InstanceConfig>;
+export function configSetConfigHelper(apiVersionTag: string, instanceConfig: pages.InstanceConfig): Promise<void>;
 /**
     * Navigation-specific part of the SDK.
     */
@@ -5510,10 +5509,11 @@ export namespace pages {
                     * @internal
                     * Limited to Microsoft-internal use
                     *
+                    * @param apiVersionTag - The API version tag, which is used for telemetry, composed by API version number and source API name.
                     * @param handler - The handler to invoke when the user selects the Save button.
                     * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
                     */
-                function registerOnSaveHandlerHelper(handler: (evt: SaveEvent) => void, versionSpecificHelper?: () => void): void;
+                function registerOnSaveHandlerHelper(apiVersionTag: string, handler: (evt: SaveEvent) => void, versionSpecificHelper?: () => void): void;
                 /**
                     * Registers a handler for user attempts to remove content. This handler should be used
                     * to remove the underlying resource powering the content.
@@ -5529,10 +5529,11 @@ export namespace pages {
                     * @internal
                     * Limited to Microsoft-internal use
                     *
+                    * @param apiVersionTag - The API version tag, which is used for telemetry, composed by API version number and source API name.
                     * @param handler - The handler to invoke when the user selects the Remove button.
                     * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
                     */
-                function registerOnRemoveHandlerHelper(handler: (evt: RemoveEvent) => void, versionSpecificHelper?: () => void): void;
+                function registerOnRemoveHandlerHelper(apiVersionTag: string, handler: (evt: RemoveEvent) => void, versionSpecificHelper?: () => void): void;
                 /**
                     * Registers a handler for when the tab configuration is changed by the user
                     * @param handler - The handler to invoke when the user clicks on Settings.
@@ -5638,6 +5639,8 @@ export namespace pages {
             * Hide from docs
             * ------
             * Provides APIs to interact with the full-trust part of the SDK. Limited to 1P applications
+            * @internal
+            * Limited to Microsoft-internal use
             */
         namespace fullTrust {
                 /**
@@ -5645,6 +5648,7 @@ export namespace pages {
                     * Hide from docs
                     * ------
                     * Place the tab into full-screen mode.
+                    *
                     */
                 function enterFullscreen(): void;
                 /**
@@ -9713,7 +9717,7 @@ export { VideoEffectCallBack as DefaultVideoEffectCallBack };
     * This class is used to monitor the performance of video processing, and report performance events.
     */
 export class VideoPerformanceMonitor {
-        constructor(reportPerformanceEvent: (actionName: string, args: unknown[]) => void);
+        constructor(reportPerformanceEvent: (apiVersionTag: string, actionName: string, args: unknown[]) => void);
         /**
             * Start to check frame processing time intervally
             * and report performance event if the average frame processing time is too long.