@microsoft/teams-js 2.9.0-beta.0 → 2.9.1

package/README.md

@@ -24,7 +24,7 @@ To install the stable [version](https://learn.microsoft.com/javascript/api/overv
 
 ### Production
 
-You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.8.0/js/MicrosoftTeams.min.js) or point your package manager at them.
+You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.9.1/js/MicrosoftTeams.min.js) or point your package manager at them.
 
 ## Usage
 
@@ -45,13 +45,13 @@ Reference the library inside of your `.html` page using:
 ```html
 <!-- Microsoft Teams JavaScript API (via CDN) -->
 <script
-  src="https://res.cdn.office.net/teams-js/2.8.0/js/MicrosoftTeams.min.js"
-  integrity="sha384-/DJ9oJEFZSpGiUQx9Na5Yb5svOPPqSb3khKxJ/YgoZ2GtrkzWgSTBpESy3LvMPVk"
+  src="https://res.cdn.office.net/teams-js/2.9.1/js/MicrosoftTeams.min.js"
+  integrity="sha384-xnsUQ1tUqsrutBJl0vuf4/hufzLFWW8ZhGnhItfpQ0/BtWgM2uw6YT6BQ5YaKBSM"
   crossorigin="anonymous"
 ></script>
 
 <!-- Microsoft Teams JavaScript API (via npm) -->
-<script src="node_modules/@microsoft/teams-js@2.8.0/dist/MicrosoftTeams.min.js"></script>
+<script src="node_modules/@microsoft/teams-js@2.9.1/dist/MicrosoftTeams.min.js"></script>
 
 <!-- Microsoft Teams JavaScript API (via local) -->
 <script src="MicrosoftTeams.min.js"></script>

package/dist/MicrosoftTeams.d.ts

@@ -2208,26 +2208,45 @@ export namespace videoEx {
     * This object is used for starting or completing authentication flows.
     */
 export namespace authentication {
+        /**
+            * @hidden
+            * @internal
+            * Limited to Microsoft-internal use; automatically called when library is initialized
+            */
         function initialize(): void;
         /**
             * @deprecated
-            * As of 2.0.0, this function has been deprecated in favor of a Promise-based pattern.
-            * Registers the authentication Communication.handlers
+            * As of 2.0.0, this function has been deprecated in favor of a Promise-based pattern using {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>}
             *
-            * @param authenticateParameters - A set of values that configure the authentication pop-up.
+            * Registers handlers to be called with the result of an authentication flow triggered using {@link authentication.authenticate authentication.authenticate(authenticateParameters?: AuthenticateParameters): void}
+            *
+            * @param authenticateParameters - Configuration for authentication flow pop-up result communication
             */
         function registerAuthenticationHandlers(authenticateParameters: AuthenticateParameters): void;
         /**
-            * Initiates an authentication request, which opens a new window with the specified settings.
+            * Initiates an authentication flow which requires a new window.
+            * There are two primary uses for this function:
+            * 1. When your app needs to authenticate using a 3rd-party identity provider (not Azure Active Directory)
+            * 2. When your app needs to show authentication UI that is blocked from being shown in an iframe (e.g., Azure Active Directory consent prompts)
+            *
+            * For more details, see [Enable authentication using third-party OAuth provider](https://learn.microsoft.com/microsoftteams/platform/tabs/how-to/authentication/auth-flow-tab)
+            *
+            * This function is *not* needed for "standard" Azure SSO usage. Using {@link getAuthToken} is usually sufficient in that case. For more, see
+            * [Enable SSO for tab apps](https://learn.microsoft.com/microsoftteams/platform/tabs/how-to/authentication/tab-sso-overview))
             *
             * @remarks
             * The authentication flow must start and end from the same domain, otherwise success and failure messages won't be returned to the window that initiated the call.
+            * The [Teams authentication flow](https://learn.microsoft.com/microsoftteams/platform/tabs/how-to/authentication/auth-flow-tab) starts and ends at an endpoint on
+            * your own service (with a redirect round-trip to the 3rd party identity provider in the middle).
             *
-            * @param authenticateParameters - The parameters for the authentication request. It is a required parameter since v2 upgrade
+            * @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.
+            * @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.
             *
-            * @throws Error if the authentication request fails or is canceled by the user.
+            * @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
+            * the infrastructure depending on the failure (e.g., a user cancelation)
             *
             */
         function authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise<string>;
@@ -2235,30 +2254,36 @@ export namespace authentication {
             * @deprecated
             * As of 2.0.0, please use {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} instead.
             *
-            * Initiates an authentication request, which opens a new window with the specified settings.
-            *
-            * @remarks
-            * The authentication flow must start and end from the same domain, otherwise success and failure messages won't be returned to the window that initiated the call.
+            * The documentation for {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} applies
+            * to this function.
+            * The one difference is that instead of the result being returned via the `Promise`, the result is returned to the callback functions provided in the
+            * `authenticateParameters` parameter.
             *
-            * @param authenticateParameters - The parameters for the authentication request.
+            * @param authenticateParameters - Parameters describing the authentication window used for executing the authentication flow and callbacks used for indicating the result
             *
             */
         function authenticate(authenticateParameters?: AuthenticateParameters): void;
         /**
-            * Requests an Azure AD token to be issued on behalf of the app. The token is acquired from the cache
-            * if it is not expired. Otherwise a request is sent to Azure AD to obtain a new token.
+            * Requests an Azure AD token to be issued on behalf of your app in an SSO flow.
+            * The token is acquired from the cache if it is not expired. Otherwise a request is sent to Azure AD to
+            * obtain a new token.
+            * This function is used to enable SSO scenarios. See [Enable SSO for tab apps](https://learn.microsoft.com/microsoftteams/platform/tabs/how-to/authentication/tab-sso-overview)
+            * for more details.
             *
             * @param authTokenRequest - An optional set of values that configure the token request.
             *
-            * @returns Promise that will be fulfilled with the token if successful.
+            * @returns `Promise` that will be resolved with the token, if successful.
+            *
+            * @throws `Error` if the request fails in some way
             */
         function getAuthToken(authTokenRequest?: AuthTokenRequestParameters): Promise<string>;
         /**
             * @deprecated
             * As of 2.0.0, please use {@link authentication.getAuthToken authentication.getAuthToken(authTokenRequest: AuthTokenRequestParameters): Promise\<string\>} instead.
             *
-            * Requests an Azure AD token to be issued on behalf of the app. The token is acquired from the cache
-            * if it is not expired. Otherwise a request is sent to Azure AD to obtain a new token.
+            * The documentation {@link authentication.getAuthToken authentication.getAuthToken(authTokenRequest: AuthTokenRequestParameters): Promise\<string\>} applies to this
+            * function as well. The one difference when using this function is that the result is provided in the callbacks in the `authTokenRequest` parameter
+            * instead of as a `Promise`.
             *
             * @param authTokenRequest - An optional set of values that configure the token request.
             * It contains callbacks to call in case of success/failure
@@ -2287,30 +2312,39 @@ export namespace authentication {
             */
         function getUser(userRequest: UserRequest): void;
         /**
-            * Notifies the frame that initiated this authentication request that the request was successful.
+            * 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
+            * {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} that the
+            * authentication request was successful.
             *
             * @remarks
-            * This function is usable only on the authentication window.
+            * This function is usable only from the authentication window.
             * This call causes the authentication window to be closed.
             *
-            * @param result - Specifies a result for the authentication. If specified, the frame that initiated the authentication pop-up receives this value in its callback.
+            * @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;
         /**
-            * Notifies the frame that initiated this authentication request that the request failed.
+            * 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
+            * {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} that the
+            * authentication request failed.
+    
             *
             * @remarks
             * This function is usable only on the authentication window.
             * This call causes the authentication window to be closed.
             *
-            * @param result - Specifies a result for the authentication. If specified, the frame that initiated the authentication pop-up receives this value in its callback.
+            * @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 notifyFailure(reason?: string, callbackUrl?: string): void;
         /**
             * @deprecated
-            * As of 2.0.0, this interface has been deprecated in favor of a Promise-based pattern.
+            * 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\>}
             *-------------------------
             * Used in {@link AuthenticateParameters} and {@link AuthTokenRequest}
             */
@@ -2318,12 +2352,14 @@ export namespace authentication {
                 /**
                     * @deprecated
                     * As of 2.0.0, this property has been deprecated in favor of a Promise-based pattern.
+                    *
                     * A function that is called if the request succeeds.
                     */
                 successCallback?: (result: string) => void;
                 /**
                     * @deprecated
                     * As of 2.0.0, this property has been deprecated in favor of a Promise-based pattern.
+                    *
                     * A function that is called if the request fails, with the reason for the failure.
                     */
                 failureCallback?: (reason: string) => void;
@@ -2345,13 +2381,22 @@ export namespace authentication {
                     */
                 height?: number;
                 /**
-                    * The flag which indicates whether the auth page should be opened in an external browser. This flag has no effect on the web client.
+                    * Some identity providers restrict their authentication pages from being displayed in embedded browsers (e.g., a web view inside of a native application)
+                    * If the identity provider you are using prevents embedded browser usage, this flag should be set to `true` to enable the authentication page specified in
+                    * the {@link url} property to be opened in an external browser.
+                    * If this flag is `false`, the page will be opened directly within the current hosting application.
+                    *
+                    * This flag is ignored when the host for the application is a web app (as opposed to a native application) as the behavior is unnecessary in a web-only
+                    * environment without an embedded browser.
                     */
                 isExternal?: boolean;
         }
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link AuthenticatePopUpParameters} instead.
+            * As of 2.0.0, please use {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} and
+            * the associated {@link AuthenticatePopUpParameters} instead.
+            *
+            * @see {@link LegacyCallBacks}
             */
         type AuthenticateParameters = AuthenticatePopUpParameters & LegacyCallBacks;
         /**
@@ -2359,7 +2404,9 @@ export namespace authentication {
             */
         interface AuthTokenRequestParameters {
                 /**
-                    * An optional list of resource for which to acquire the access token; only used for full trust apps.
+                    * @hidden
+                    * @internal
+                    * An list of resources for which to acquire the access token; only for internal Microsoft usage
                     */
                 resources?: string[];
                 /**
@@ -2600,7 +2647,11 @@ export enum HostName {
         /**
             * Teams
             */
-        teams = "Teams"
+        teams = "Teams",
+        /**
+            * Modern Teams
+            */
+        teamsModern = "TeamsModern"
 }
 export enum FrameContexts {
         settings = "settings",
@@ -4196,7 +4247,15 @@ export namespace chat {
 export {};
 
 /**
-    * Namespace to interact with the dialog module-specific part of the SDK.
+    * This group of capabilities enables apps to show modal dialogs. There are two primary types of dialogs: URL-based dialogs and [Adaptive Card](https://learn.microsoft.com/adaptive-cards/) dialogs.
+    * Both types of dialogs are shown on top of your app, preventing interaction with your app while they are displayed.
+    * - URL-based dialogs allow you to specify a URL from which the contents will be shown inside the dialog.
+    *   - For URL dialogs, use the functions and interfaces in the {@link dialog.url} namespace.
+    * - Adaptive Card-based dialogs allow you to provide JSON describing an Adaptive Card that will be shown inside the dialog.
+    *   - For Adaptive Card dialogs, use the functions and interfaces in the {@link dialog.adaptiveCard} namespace.
+    *
+    * @remarks Note that dialogs were previously called "task modules". While they have been renamed for clarity, the functionality has been maintained.
+    * For more details, see [Dialogs](https://learn.microsoft.com/microsoftteams/platform/task-modules-and-cards/what-are-task-modules)
     *
     * @beta
     */
@@ -4227,6 +4286,9 @@ export namespace dialog {
         /**
             * Handler used for receiving results when a dialog closes, either the value passed by {@linkcode url.submit}
             * or an error if the dialog was closed by the user.
+            *
+            * @see {@linkcode ISdkResponse}
+            *
             * @beta
             */
         type DialogSubmitHandler = (result: ISdkResponse) => void;
@@ -4359,14 +4421,11 @@ export namespace dialog {
                 function getDialogInfoFromBotUrlDialogInfo(botUrlDialogInfo: BotUrlDialogInfo): DialogInfo;
         }
         /**
-            * Checks if dialog capability is supported by the host
-            * @returns boolean to represent whether dialog capabilty is supported
-            *
-            * @throws Error if {@linkcode app.initialize} has not successfully completed
+            * This function currently serves no purpose and should not be used. All functionality that used
+            * to be covered by this method is now in subcapabilities and those isSupported methods should be
+            * used directly.
             *
-            * @throws Error if {@linkcode app.initialize} has not successfully completed
-            *
-            * @beta
+            * @hidden
             */
         function isSupported(): boolean;
         /**
@@ -7422,9 +7481,13 @@ export namespace settings {
 export namespace tasks {
         /**
             * @deprecated
-            * As of 2.8.0, please use {@link dialog.url.open dialog.url.open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} for url based dialogs
-            * and {@link dialog.url.bot.open dialog.url.bot.open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} for bot-based dialogs. In Teams,
-            * this function can be used for Adaptive Card-based dialogs. Support for Adaptive Card-based dialogs is coming to other hosts in the future.
+            * As of 2.8.0:
+            * - For url-based dialogs, please use {@link dialog.url.open dialog.url.open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} .
+            * - For url-based dialogs with bot interaction, please use {@link dialog.url.bot.open dialog.url.bot.open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void}
+            * - For Adaptive Card-based dialogs:
+            *   - In Teams, please continue to use this function until the new functions in {@link dialog.adaptiveCard} have been fully implemented. You can tell at runtime when they are implemented in Teams by checking
+            *     the return value of the {@link dialog.adaptiveCard.isSupported} function. This documentation line will also be removed once they have been fully implemented in Teams.
+            *   - In all other hosts, please use {@link dialog.adaptiveCard.open dialog.adaptiveCard.open(cardDialogInfo: CardDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void}
             *
             * Allows an app to open the task module.
             *

package/dist/MicrosoftTeams.js

@@ -7,7 +7,7 @@
 		exports["microsoftTeams"] = factory();
 	else
 		root["microsoftTeams"] = factory();
-})(self, function() {
+})(self, () => {
 return /******/ (() => { // webpackBootstrap
 /******/ 	var __webpack_modules__ = ({
 
@@ -1477,6 +1477,10 @@ var HostName;
      * Teams
      */
     HostName["teams"] = "Teams";
+    /**
+     * Modern Teams
+     */
+    HostName["teamsModern"] = "TeamsModern";
 })(HostName || (HostName = {}));
 // Ensure these declarations stay in sync with the framework.
 var FrameContexts;
@@ -2151,7 +2155,7 @@ var _minRuntimeConfigToUninitialize = {
 };
 
 ;// CONCATENATED MODULE: ./src/public/version.ts
-var version = "2.9.0-beta.0";
+var version = "2.9.1";
 
 ;// CONCATENATED MODULE: ./src/internal/internalAPIs.ts
 
@@ -2302,6 +2306,11 @@ var authentication;
 (function (authentication) {
     var authHandlers;
     var authWindowMonitor;
+    /**
+     * @hidden
+     * @internal
+     * Limited to Microsoft-internal use; automatically called when library is initialized
+     */
     function initialize() {
         registerHandler('authentication.authenticate.success', handleSuccess, false);
         registerHandler('authentication.authenticate.failure', handleFailure, false);
@@ -2310,10 +2319,11 @@ var authentication;
     var authParams;
     /**
      * @deprecated
-     * As of 2.0.0, this function has been deprecated in favor of a Promise-based pattern.
-     * Registers the authentication Communication.handlers
+     * As of 2.0.0, this function has been deprecated in favor of a Promise-based pattern using {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>}
      *
-     * @param authenticateParameters - A set of values that configure the authentication pop-up.
+     * Registers handlers to be called with the result of an authentication flow triggered using {@link authentication.authenticate authentication.authenticate(authenticateParameters?: AuthenticateParameters): void}
+     *
+     * @param authenticateParameters - Configuration for authentication flow pop-up result communication
      */
     function registerAuthenticationHandlers(authenticateParameters) {
         authParams = authenticateParameters;
@@ -2563,13 +2573,17 @@ var authentication;
         });
     }
     /**
-     * Notifies the frame that initiated this authentication request that the request was successful.
+     * 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
+     * {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} that the
+     * authentication request was successful.
      *
      * @remarks
-     * This function is usable only on the authentication window.
+     * This function is usable only from the authentication window.
      * This call causes the authentication window to be closed.
      *
-     * @param result - Specifies a result for the authentication. If specified, the frame that initiated the authentication pop-up receives this value in its callback.
+     * @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, callbackUrl) {
@@ -2581,13 +2595,18 @@ var authentication;
     }
     authentication.notifySuccess = notifySuccess;
     /**
-     * Notifies the frame that initiated this authentication request that the request failed.
+     * 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
+     * {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} that the
+     * authentication request failed.
+  
      *
      * @remarks
      * This function is usable only on the authentication window.
      * This call causes the authentication window to be closed.
      *
-     * @param result - Specifies a result for the authentication. If specified, the frame that initiated the authentication pop-up receives this value in its callback.
+     * @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 notifyFailure(reason, callbackUrl) {
@@ -2698,7 +2717,15 @@ var authentication;
 
 
 /**
- * Namespace to interact with the dialog module-specific part of the SDK.
+ * This group of capabilities enables apps to show modal dialogs. There are two primary types of dialogs: URL-based dialogs and [Adaptive Card](https://learn.microsoft.com/adaptive-cards/) dialogs.
+ * Both types of dialogs are shown on top of your app, preventing interaction with your app while they are displayed.
+ * - URL-based dialogs allow you to specify a URL from which the contents will be shown inside the dialog.
+ *   - For URL dialogs, use the functions and interfaces in the {@link dialog.url} namespace.
+ * - Adaptive Card-based dialogs allow you to provide JSON describing an Adaptive Card that will be shown inside the dialog.
+ *   - For Adaptive Card dialogs, use the functions and interfaces in the {@link dialog.adaptiveCard} namespace.
+ *
+ * @remarks Note that dialogs were previously called "task modules". While they have been renamed for clarity, the functionality has been maintained.
+ * For more details, see [Dialogs](https://learn.microsoft.com/microsoftteams/platform/task-modules-and-cards/what-are-task-modules)
  *
  * @beta
  */
@@ -2947,14 +2974,11 @@ var dialog;
         url.getDialogInfoFromBotUrlDialogInfo = getDialogInfoFromBotUrlDialogInfo;
     })(url = dialog.url || (dialog.url = {}));
     /**
-     * Checks if dialog capability is supported by the host
-     * @returns boolean to represent whether dialog capabilty is supported
-     *
-     * @throws Error if {@linkcode app.initialize} has not successfully completed
+     * This function currently serves no purpose and should not be used. All functionality that used
+     * to be covered by this method is now in subcapabilities and those isSupported methods should be
+     * used directly.
      *
-     * @throws Error if {@linkcode app.initialize} has not successfully completed
-     *
-     * @beta
+     * @hidden
      */
     function isSupported() {
         return ensureInitialized(runtime) && runtime.supports.dialog ? true : false;
@@ -8808,9 +8832,13 @@ var tasks;
 (function (tasks) {
     /**
      * @deprecated
-     * As of 2.8.0, please use {@link dialog.url.open dialog.url.open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} for url based dialogs
-     * and {@link dialog.url.bot.open dialog.url.bot.open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} for bot-based dialogs. In Teams,
-     * this function can be used for Adaptive Card-based dialogs. Support for Adaptive Card-based dialogs is coming to other hosts in the future.
+     * As of 2.8.0:
+     * - For url-based dialogs, please use {@link dialog.url.open dialog.url.open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} .
+     * - For url-based dialogs with bot interaction, please use {@link dialog.url.bot.open dialog.url.bot.open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void}
+     * - For Adaptive Card-based dialogs:
+     *   - In Teams, please continue to use this function until the new functions in {@link dialog.adaptiveCard} have been fully implemented. You can tell at runtime when they are implemented in Teams by checking
+     *     the return value of the {@link dialog.adaptiveCard.isSupported} function. This documentation line will also be removed once they have been fully implemented in Teams.
+     *   - In all other hosts, please use {@link dialog.adaptiveCard.open dialog.adaptiveCard.open(cardDialogInfo: CardDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void}
      *
      * Allows an app to open the task module.
      *