@microsoft/teams-js 2.1.0-beta.0 → 2.1.0-beta.3

package/dist/MicrosoftTeams.d.ts

@@ -2313,6 +2313,9 @@ export interface BotUrlDialogInfo extends UrlDialogInfo {
             */
         completionBotId: string;
 }
+/**
+    * Data structure to describe dialog information
+    */
 export interface DialogInfo {
         /**
             * The url to be rendered in the webview/iframe.
@@ -4481,7 +4484,7 @@ export namespace meeting {
         function registerSpeakingStateChangeHandler(handler: (speakingState: ISpeakingState) => void): void;
         /**
             * Registers a handler for changes to the selfParticipant's (current user's) raiseHandState. If the selfParticipant raises their hand, isHandRaised
-            * will be true. By default and if the selfParticipant hand is lowered, isHandRaised will be false. This API will return {@link RaiseHandStateChangedEvent}
+            * will be true. By default and if the selfParticipant hand is lowered, isHandRaised will be false. This API will return {@link RaiseHandStateChangedEventData}
             * that will have the raiseHandState or an error object. Only one handler can be registered at a time. A subsequent registration
             * replaces an existing registration.
             *
@@ -5401,7 +5404,7 @@ export namespace settings {
         function setValidityState(validityState: boolean): void;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link pages.config.getConfig pages.config.getConfig(): Promise\<Config\>} instead.
+            * As of 2.0.0, please use {@link pages.getConfig pages.getConfig(): Promise\<InstanceConfig\>} instead.
             *
             * Gets the settings for the current instance.
             *
@@ -5455,8 +5458,9 @@ export namespace settings {
 export namespace tasks {
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link dialog.open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): PostMessageChannel} for url based dialogs
-            * and {@link dialog.bot.open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): PostMessageChannel} for bot based dialogs.
+            * As of 2.0.0, please use {@link dialog.open dialog.open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} for url based dialogs
+            * and {@link dialog.bot.open dialog.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.
             *
             * Allows an app to open the task module.
             *
@@ -5475,7 +5479,7 @@ export namespace tasks {
         function updateTask(taskInfo: TaskInfo): void;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link dialog.submit dialog.submit(result?: string | object, appIds?: string | string[]): void} instead.
+            * As of 2.0.0, please use {@link dialog.submit} instead.
             *
             * Submit the task module.
             *
@@ -5483,8 +5487,24 @@ export namespace tasks {
             * @param appIds - Helps to validate that the call originates from the same appId as the one that invoked the task module
             */
         function submitTask(result?: string | object, appIds?: string | string[]): void;
+        /**
+            * Converts {@link TaskInfo} to {@link UrlDialogInfo}
+            * @param taskInfo - TaskInfo object to convert
+            * @returns - Converted UrlDialogInfo object
+            */
         function getUrlDialogInfoFromTaskInfo(taskInfo: TaskInfo): UrlDialogInfo;
+        /**
+            * Converts {@link TaskInfo} to {@link BotUrlDialogInfo}
+            * @param taskInfo - TaskInfo object to convert
+            * @returns - converted BotUrlDialogInfo object
+            */
         function getBotUrlDialogInfoFromTaskInfo(taskInfo: TaskInfo): BotUrlDialogInfo;
+        /**
+            * Sets the height and width of the {@link TaskInfo} object to the original height and width, if initially specified,
+            * otherwise uses the height and width values corresponding to {@link TaskModuleDimension.Small}
+            * @param taskInfo TaskInfo object from which to extract size info, if specified
+            * @returns TaskInfo with height and width specified
+            */
         function getDefaultSizeIfNotProvided(taskInfo: TaskInfo): TaskInfo;
 }
 

package/dist/MicrosoftTeams.js

@@ -1122,7 +1122,7 @@ __webpack_require__.d(__webpack_exports__, {
 });
 
 ;// CONCATENATED MODULE: ./src/internal/constants.ts
-var version = "2.1.0-beta.0";
+var version = "2.1.0-beta.3";
 /**
  * @hidden
  * The client version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
@@ -2581,7 +2581,7 @@ var dialog;
         }
         var dialogInfo = getDialogInfoFromUrlDialogInfo(urlDialogInfo);
         sendMessageToParent('tasks.startTask', [dialogInfo], function (err, result) {
-            submitHandler({ err: err, result: result });
+            submitHandler === null || submitHandler === void 0 ? void 0 : submitHandler({ err: err, result: result });
             removeHandler('messageForParent');
         });
     }
@@ -2720,7 +2720,7 @@ var dialog;
             }
             var dialogInfo = getDialogInfoFromBotUrlDialogInfo(botUrlDialogInfo);
             sendMessageToParent('tasks.startTask', [dialogInfo], function (err, result) {
-                submitHandler({ err: err, result: result });
+                submitHandler === null || submitHandler === void 0 ? void 0 : submitHandler({ err: err, result: result });
                 removeHandler('messageForParent');
             });
         }
@@ -4052,6 +4052,10 @@ function removeHandler(name) {
     delete HandlersPrivate.handlers[name];
 }
 /** @internal */
+function doesHandlerExist(name) {
+    return HandlersPrivate.handlers[name] != null;
+}
+/** @internal */
 function handlers_registerOnThemeChangeHandler(handler) {
     HandlersPrivate.themeChangeHandler = handler;
     handler && sendMessageToParent('registerHandler', ['themeChange']);
@@ -4788,7 +4792,7 @@ function createTeamsDeepLinkForAppInstallDialog(appId) {
     if (!appId) {
         throw new Error('App ID must be set when creating an app install dialog deep link');
     }
-    return teamsDeepLinkProtocol + "://" + teamsDeepLinkHost + teamsDeepLinkUrlPathForAppInstall + encodeURIComponent(appId) + "/";
+    return teamsDeepLinkProtocol + "://" + teamsDeepLinkHost + teamsDeepLinkUrlPathForAppInstall + encodeURIComponent(appId);
 }
 
 ;// CONCATENATED MODULE: ./src/public/appInstallDialog.ts
@@ -5934,7 +5938,7 @@ var meeting;
     meeting.registerSpeakingStateChangeHandler = registerSpeakingStateChangeHandler;
     /**
      * Registers a handler for changes to the selfParticipant's (current user's) raiseHandState. If the selfParticipant raises their hand, isHandRaised
-     * will be true. By default and if the selfParticipant hand is lowered, isHandRaised will be false. This API will return {@link RaiseHandStateChangedEvent}
+     * will be true. By default and if the selfParticipant hand is lowered, isHandRaised will be false. This API will return {@link RaiseHandStateChangedEventData}
      * that will have the raiseHandState or an error object. Only one handler can be registered at a time. A subsequent registration
      * replaces an existing registration.
      *
@@ -7090,7 +7094,7 @@ var settings;
     settings.setValidityState = setValidityState;
     /**
      * @deprecated
-     * As of 2.0.0, please use {@link pages.config.getConfig pages.config.getConfig(): Promise\<Config\>} instead.
+     * As of 2.0.0, please use {@link pages.getConfig pages.getConfig(): Promise\<InstanceConfig\>} instead.
      *
      * Gets the settings for the current instance.
      *
@@ -7186,8 +7190,9 @@ var tasks;
 (function (tasks) {
     /**
      * @deprecated
-     * As of 2.0.0, please use {@link dialog.open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): PostMessageChannel} for url based dialogs
-     * and {@link dialog.bot.open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): PostMessageChannel} for bot based dialogs.
+     * As of 2.0.0, please use {@link dialog.open dialog.open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} for url based dialogs
+     * and {@link dialog.bot.open dialog.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.
      *
      * Allows an app to open the task module.
      *
@@ -7195,19 +7200,18 @@ var tasks;
      * @param submitHandler - Handler to call when the task module is completed
      */
     function startTask(taskInfo, submitHandler) {
+        var dialogSubmitHandler = submitHandler
+            ? function (sdkResponse) { return submitHandler(sdkResponse.err, sdkResponse.result); }
+            : undefined;
         if (taskInfo.card !== undefined || taskInfo.url === undefined) {
             ensureInitialized(FrameContexts.content, FrameContexts.sidePanel, FrameContexts.meetingStage);
             sendMessageToParent('tasks.startTask', [taskInfo], submitHandler);
         }
         else if (taskInfo.completionBotId !== undefined) {
-            dialog.bot.open(getBotUrlDialogInfoFromTaskInfo(taskInfo), function (sdkResponse) {
-                return submitHandler(sdkResponse.err, sdkResponse.result);
-            });
+            dialog.bot.open(getBotUrlDialogInfoFromTaskInfo(taskInfo), dialogSubmitHandler);
         }
         else {
-            dialog.open(getUrlDialogInfoFromTaskInfo(taskInfo), function (sdkResponse) {
-                return submitHandler(sdkResponse.err, sdkResponse.result);
-            });
+            dialog.open(getUrlDialogInfoFromTaskInfo(taskInfo), dialogSubmitHandler);
         }
         return new ChildAppWindow();
     }
@@ -7232,7 +7236,7 @@ var tasks;
     tasks.updateTask = updateTask;
     /**
      * @deprecated
-     * As of 2.0.0, please use {@link dialog.submit dialog.submit(result?: string | object, appIds?: string | string[]): void} instead.
+     * As of 2.0.0, please use {@link dialog.submit} instead.
      *
      * Submit the task module.
      *
@@ -7243,6 +7247,11 @@ var tasks;
         dialog.submit(result, appIds);
     }
     tasks.submitTask = submitTask;
+    /**
+     * Converts {@link TaskInfo} to {@link UrlDialogInfo}
+     * @param taskInfo - TaskInfo object to convert
+     * @returns - Converted UrlDialogInfo object
+     */
     function getUrlDialogInfoFromTaskInfo(taskInfo) {
         var urldialogInfo = {
             url: taskInfo.url,
@@ -7256,6 +7265,11 @@ var tasks;
         return urldialogInfo;
     }
     tasks.getUrlDialogInfoFromTaskInfo = getUrlDialogInfoFromTaskInfo;
+    /**
+     * Converts {@link TaskInfo} to {@link BotUrlDialogInfo}
+     * @param taskInfo - TaskInfo object to convert
+     * @returns - converted BotUrlDialogInfo object
+     */
     function getBotUrlDialogInfoFromTaskInfo(taskInfo) {
         var botUrldialogInfo = {
             url: taskInfo.url,
@@ -7270,6 +7284,12 @@ var tasks;
         return botUrldialogInfo;
     }
     tasks.getBotUrlDialogInfoFromTaskInfo = getBotUrlDialogInfoFromTaskInfo;
+    /**
+     * Sets the height and width of the {@link TaskInfo} object to the original height and width, if initially specified,
+     * otherwise uses the height and width values corresponding to {@link TaskModuleDimension.Small}
+     * @param taskInfo TaskInfo object from which to extract size info, if specified
+     * @returns TaskInfo with height and width specified
+     */
     function getDefaultSizeIfNotProvided(taskInfo) {
         taskInfo.height = taskInfo.height ? taskInfo.height : TaskModuleDimension.Small;
         taskInfo.width = taskInfo.width ? taskInfo.width : TaskModuleDimension.Small;