@microsoft/teams-js 2.0.0-beta.4-dev.14 → 2.0.0-beta.4-dev.15

package/dist/MicrosoftTeams.d.ts

@@ -2109,6 +2109,39 @@ export interface DeepLinkParameters {
             */
         subEntityWebUrl?: string;
 }
+export interface DialogSize {
+        /**
+            * The requested height of the webview/iframe.
+            */
+        height: DialogDimension | number;
+        /**
+            * The requested width of the webview/iframe.
+            */
+        width: DialogDimension | number;
+}
+export interface UrlDialogInfo {
+        /**
+            * The url to be rendered in the webview/iframe.
+            */
+        url: string;
+        size: DialogSize;
+        /**
+            * Title of the task module.
+            */
+        title?: string;
+        /**
+            * If client doesnt support the URL, the URL that needs to be opened in the browser.
+            */
+        fallbackUrl?: string;
+}
+export interface BotUrlDialogInfo extends UrlDialogInfo {
+        /**
+            * Specifies a bot ID to send the result of the user's interaction with the task module.
+            * The bot will receive a task/complete invoke event with a JSON object
+            * in the event payload.
+            */
+        completionBotId: string;
+}
 export interface DialogInfo {
         /**
             * The url to be rendered in the webview/iframe.
@@ -2749,14 +2782,23 @@ export namespace appInstallDialog {
     *
     * @beta
     */
+export interface SdkResponse {
+        err: string;
+        result: string | object;
+}
 export namespace dialog {
+        type PostMessageChannel = (message: any, onComplete?: (status: boolean, reason?: string) => void) => void;
+        type DialogSubmitHandler = (result: SdkResponse) => void;
         /**
             * Allows an app to open the dialog module.
             *
-            * @param dialogInfo - An object containing the parameters of the dialog module
-            * @param submitHandler - Handler to call when the task module is completed
+            * @param urlDialogInfo - An object containing the parameters of the dialog module.
+            * @param submitHandler - This Handler is called when the dialog has been submitted or closed.
+            * @param messageFromChildHandler - Handler that triggers if dialog sends a message to the app.
+            *
+            * @returns a function that can be used to send messages to the dialog.
             */
-        function open(dialogInfo: DialogInfo, submitHandler?: (err: string, result: string | object) => void): IAppWindow;
+        function open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): PostMessageChannel;
         /**
             * Update height/width dialog info properties.
             *
@@ -2785,6 +2827,10 @@ export namespace dialog {
             */
         function registerOnMessageFromParent(listener: (message: any) => void): void;
         function isSupported(): boolean;
+        namespace bot {
+                function open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): PostMessageChannel;
+                function isSupported(): boolean;
+        }
 }
 
 /**
@@ -5048,7 +5094,7 @@ export namespace settings {
 export namespace tasks {
         /**
             * @deprecated
-            * As of 2.0.0-beta.1, please use {@link dialog.open dialog.open(dialogInfo: DialogInfo, submitHandler?: (err: string, result: string) => void): IAppWindow} instead.
+            * As of 2.0.0-beta.4, please use {@link dialog.open(dialogInfo: DialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): PostMessageChannel} instead.
             *
             * Allows an app to open the task module.
             *
@@ -5075,5 +5121,8 @@ 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;
+        function getUrlDialogInfoFromTaskInfo(taskInfo: TaskInfo): UrlDialogInfo;
+        function getBotUrlDialogInfoFromTaskInfo(taskInfo: TaskInfo): BotUrlDialogInfo;
+        function getDefaultSizeIfNotProvided(taskInfo: TaskInfo): TaskInfo;
 }
 

package/dist/MicrosoftTeams.js

@@ -1121,7 +1121,7 @@ __webpack_require__.d(__webpack_exports__, {
 });
 
 ;// CONCATENATED MODULE: ./src/internal/constants.ts
-var version = "2.0.0-beta.4-dev.14";
+var version = "2.0.0-beta.4-dev.15";
 /**
  * @hidden
  * The client version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
@@ -1820,7 +1820,9 @@ var runtime = {
         calendar: undefined,
         call: undefined,
         chat: undefined,
-        dialog: undefined,
+        dialog: {
+            bot: undefined,
+        },
         location: undefined,
         logs: undefined,
         mail: undefined,
@@ -1856,7 +1858,9 @@ var teamsRuntimeConfig = {
         bot: {},
         call: {},
         chat: {},
-        dialog: {},
+        dialog: {
+            bot: {},
+        },
         files: {},
         location: {},
         logs: {},
@@ -4247,78 +4251,6 @@ var appInstallDialog;
     appInstallDialog.isSupported = isSupported;
 })(appInstallDialog || (appInstallDialog = {}));
 
-;// CONCATENATED MODULE: ./src/public/appWindow.ts
-/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
-/* eslint-disable @typescript-eslint/no-explicit-any */
-/* eslint-disable @typescript-eslint/ban-types */
-
-
-
-
-
-var ChildAppWindow = /** @class */ (function () {
-    function ChildAppWindow() {
-    }
-    /**
-     * Send a message to the ChildAppWindow.
-     *
-     * @param message - The message to send
-     * @param onComplete - The callback to know if the postMessage has been success/failed.
-     */
-    ChildAppWindow.prototype.postMessage = function (message, onComplete) {
-        ensureInitialized();
-        sendMessageToParent('messageForChild', [message], onComplete ? onComplete : getGenericOnCompleteHandler());
-    };
-    /**
-     * Add a listener that will be called when an event is received from the ChildAppWindow.
-     *
-     * @param type - The event to listen to. Currently the only supported type is 'message'.
-     * @param listener - The listener that will be called
-     */
-    ChildAppWindow.prototype.addEventListener = function (type, listener) {
-        if (type === 'message') {
-            registerHandler('messageForParent', listener);
-        }
-    };
-    return ChildAppWindow;
-}());
-
-var ParentAppWindow = /** @class */ (function () {
-    function ParentAppWindow() {
-    }
-    Object.defineProperty(ParentAppWindow, "Instance", {
-        get: function () {
-            // Do you need arguments? Make it a regular method instead.
-            return this._instance || (this._instance = new this());
-        },
-        enumerable: false,
-        configurable: true
-    });
-    /**
-     * Send a message to the ParentAppWindow.
-     *
-     * @param message - The message to send
-     * @param onComplete - The callback to know if the postMessage has been success/failed.
-     */
-    ParentAppWindow.prototype.postMessage = function (message, onComplete) {
-        ensureInitialized(FrameContexts.task);
-        sendMessageToParent('messageForParent', [message], onComplete ? onComplete : getGenericOnCompleteHandler());
-    };
-    /**
-     * Add a listener that will be called when an event is received from the ParentAppWindow.
-     *
-     * @param type - The event to listen to. Currently the only supported type is 'message'.
-     * @param listener - The listener that will be called
-     */
-    ParentAppWindow.prototype.addEventListener = function (type, listener) {
-        if (type === 'message') {
-            registerHandler('messageForChild', listener);
-        }
-    };
-    return ParentAppWindow;
-}());
-
-
 ;// CONCATENATED MODULE: ./src/public/dialog.ts
 /* eslint-disable @typescript-eslint/explicit-module-boundary-types */
 /* eslint-disable @typescript-eslint/ban-types */
@@ -4340,27 +4272,30 @@ var __rest = (undefined && undefined.__rest) || function (s, e) {
 
 
 
-
-/**
- * Namespace to interact with the dialog module-specific part of the SDK.
- *
- * @remarks
- * This object is usable only on the content frame.
- *
- * @beta
- */
 var dialog;
 (function (dialog) {
     /**
      * Allows an app to open the dialog module.
      *
-     * @param dialogInfo - An object containing the parameters of the dialog module
-     * @param submitHandler - Handler to call when the task module is completed
+     * @param urlDialogInfo - An object containing the parameters of the dialog module.
+     * @param submitHandler - This Handler is called when the dialog has been submitted or closed.
+     * @param messageFromChildHandler - Handler that triggers if dialog sends a message to the app.
+     *
+     * @returns a function that can be used to send messages to the dialog.
      */
-    function open(dialogInfo, submitHandler) {
+    function open(urlDialogInfo, submitHandler, messageFromChildHandler) {
         ensureInitialized(FrameContexts.content, FrameContexts.sidePanel, FrameContexts.meetingStage);
-        sendMessageToParent('tasks.startTask', [dialogInfo], submitHandler);
-        return new ChildAppWindow();
+        if (messageFromChildHandler) {
+            registerHandler('messageForParent', messageFromChildHandler);
+        }
+        sendMessageToParent('tasks.startTask', [urlDialogInfo], function (err, result) {
+            submitHandler({ err: err, result: result });
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        var sendMessageToDialog = function (message, onComplete) {
+            sendMessageToParent('messageForChild', [message], onComplete ? onComplete : getGenericOnCompleteHandler());
+        };
+        return sendMessageToDialog;
     }
     dialog.open = open;
     /**
@@ -4420,8 +4355,102 @@ var dialog;
         return runtime.supports.dialog ? true : false;
     }
     dialog.isSupported = isSupported;
+    var bot;
+    (function (bot) {
+        function open(botUrlDialogInfo, submitHandler, messageFromChildHandler) {
+            ensureInitialized(FrameContexts.content, FrameContexts.sidePanel, FrameContexts.meetingStage);
+            if (messageFromChildHandler) {
+                registerHandler('messageForParent', messageFromChildHandler);
+            }
+            sendMessageToParent('tasks.startTask', [botUrlDialogInfo], function (err, result) {
+                submitHandler({ err: err, result: result });
+            });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            var sendMessageToDialog = function (message, onComplete) {
+                sendMessageToParent('messageForChild', [message], onComplete ? onComplete : getGenericOnCompleteHandler());
+            };
+            return sendMessageToDialog;
+        }
+        bot.open = open;
+        function isSupported() {
+            return runtime.supports.dialog ? (runtime.supports.dialog.bot ? true : false) : false;
+        }
+        bot.isSupported = isSupported;
+    })(bot = dialog.bot || (dialog.bot = {}));
 })(dialog || (dialog = {}));
 
+;// CONCATENATED MODULE: ./src/public/appWindow.ts
+/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable @typescript-eslint/ban-types */
+
+
+
+
+
+var ChildAppWindow = /** @class */ (function () {
+    function ChildAppWindow() {
+    }
+    /**
+     * Send a message to the ChildAppWindow.
+     *
+     * @param message - The message to send
+     * @param onComplete - The callback to know if the postMessage has been success/failed.
+     */
+    ChildAppWindow.prototype.postMessage = function (message, onComplete) {
+        ensureInitialized();
+        sendMessageToParent('messageForChild', [message], onComplete ? onComplete : getGenericOnCompleteHandler());
+    };
+    /**
+     * Add a listener that will be called when an event is received from the ChildAppWindow.
+     *
+     * @param type - The event to listen to. Currently the only supported type is 'message'.
+     * @param listener - The listener that will be called
+     */
+    ChildAppWindow.prototype.addEventListener = function (type, listener) {
+        if (type === 'message') {
+            registerHandler('messageForParent', listener);
+        }
+    };
+    return ChildAppWindow;
+}());
+
+var ParentAppWindow = /** @class */ (function () {
+    function ParentAppWindow() {
+    }
+    Object.defineProperty(ParentAppWindow, "Instance", {
+        get: function () {
+            // Do you need arguments? Make it a regular method instead.
+            return this._instance || (this._instance = new this());
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Send a message to the ParentAppWindow.
+     *
+     * @param message - The message to send
+     * @param onComplete - The callback to know if the postMessage has been success/failed.
+     */
+    ParentAppWindow.prototype.postMessage = function (message, onComplete) {
+        ensureInitialized(FrameContexts.task);
+        sendMessageToParent('messageForParent', [message], onComplete ? onComplete : getGenericOnCompleteHandler());
+    };
+    /**
+     * Add a listener that will be called when an event is received from the ParentAppWindow.
+     *
+     * @param type - The event to listen to. Currently the only supported type is 'message'.
+     * @param listener - The listener that will be called
+     */
+    ParentAppWindow.prototype.addEventListener = function (type, listener) {
+        if (type === 'message') {
+            registerHandler('messageForChild', listener);
+        }
+    };
+    return ParentAppWindow;
+}());
+
+
 ;// CONCATENATED MODULE: ./src/internal/mediaUtil.ts
 
 
@@ -6324,6 +6353,9 @@ var settings;
 /* eslint-disable @typescript-eslint/ban-types */
 
 
+
+
+
 /**
  * @deprecated
  * As of 2.0.0-beta.1, please use {@link dialog} namespace instead.
@@ -6336,7 +6368,7 @@ var tasks;
 (function (tasks) {
     /**
      * @deprecated
-     * As of 2.0.0-beta.1, please use {@link dialog.open dialog.open(dialogInfo: DialogInfo, submitHandler?: (err: string, result: string) => void): IAppWindow} instead.
+     * As of 2.0.0-beta.4, please use {@link dialog.open(dialogInfo: DialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): PostMessageChannel} instead.
      *
      * Allows an app to open the task module.
      *
@@ -6344,7 +6376,22 @@ var tasks;
      * @param submitHandler - Handler to call when the task module is completed
      */
     function startTask(taskInfo, submitHandler) {
-        return dialog.open(getDialogInfoFromTaskInfo(taskInfo), submitHandler);
+        taskInfo = getDefaultSizeIfNotProvided(taskInfo);
+        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);
+            });
+        }
+        else {
+            dialog.open(getUrlDialogInfoFromTaskInfo(taskInfo), function (sdkResponse) {
+                return submitHandler(sdkResponse.err, sdkResponse.result);
+            });
+        }
+        return new ChildAppWindow();
     }
     tasks.startTask = startTask;
     /**
@@ -6372,35 +6419,39 @@ var tasks;
         dialog.submit(result, appIds);
     }
     tasks.submitTask = submitTask;
-    function getDialogInfoFromTaskInfo(taskInfo) {
-        var dialogHeight = taskInfo.height && typeof taskInfo.height !== 'number'
-            ? getDialogDimensionFromTaskModuleDimension(taskInfo.height)
-            : taskInfo.height;
-        var dialogWidth = taskInfo.width && typeof taskInfo.width !== 'number'
-            ? getDialogDimensionFromTaskModuleDimension(taskInfo.width)
-            : taskInfo.width;
-        var dialogInfo = {
+    function getUrlDialogInfoFromTaskInfo(taskInfo) {
+        var urldialogInfo = {
             url: taskInfo.url,
-            card: taskInfo.card,
-            height: dialogHeight,
-            width: dialogWidth,
+            size: {
+                height: taskInfo.height,
+                width: taskInfo.width,
+            },
+            title: taskInfo.title,
+            fallbackUrl: taskInfo.fallbackUrl,
+        };
+        return urldialogInfo;
+    }
+    tasks.getUrlDialogInfoFromTaskInfo = getUrlDialogInfoFromTaskInfo;
+    function getBotUrlDialogInfoFromTaskInfo(taskInfo) {
+        var botUrldialogInfo = {
+            url: taskInfo.url,
+            size: {
+                height: taskInfo.height,
+                width: taskInfo.width,
+            },
             title: taskInfo.title,
             fallbackUrl: taskInfo.fallbackUrl,
             completionBotId: taskInfo.completionBotId,
         };
-        return dialogInfo;
+        return botUrldialogInfo;
     }
-    function getDialogDimensionFromTaskModuleDimension(taskModuleDimension) {
-        if (taskModuleDimension === TaskModuleDimension.Large) {
-            return TaskModuleDimension.Large;
-        }
-        else if (taskModuleDimension === TaskModuleDimension.Medium) {
-            return TaskModuleDimension.Medium;
-        }
-        else {
-            return TaskModuleDimension.Small;
-        }
+    tasks.getBotUrlDialogInfoFromTaskInfo = getBotUrlDialogInfoFromTaskInfo;
+    function getDefaultSizeIfNotProvided(taskInfo) {
+        taskInfo.height = taskInfo.height ? taskInfo.height : TaskModuleDimension.Small;
+        taskInfo.width = taskInfo.width ? taskInfo.width : TaskModuleDimension.Small;
+        return taskInfo;
     }
+    tasks.getDefaultSizeIfNotProvided = getDefaultSizeIfNotProvided;
 })(tasks || (tasks = {}));
 
 ;// CONCATENATED MODULE: ./src/public/index.ts