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

package/dist/MicrosoftTeams.d.ts

@@ -351,6 +351,123 @@ export function registerCustomHandler(actionName: string, customHandler: (...arg
     */
 export function registerUserSettingsChangeHandler(settingTypes: UserSettingTypes[], handler: (settingType: UserSettingTypes, value: any) => void): void;
 
+/**
+    *
+    * @internal
+    */
+interface OpenChatRequest {
+        /**
+            * @hidden
+            * The message to send when opening chat
+            */
+        message?: string;
+}
+/**
+    * @hidden
+    * Hide from docs.
+    * ------
+    *
+    * @internal
+    */
+export interface OpenSingleChatRequest extends OpenChatRequest {
+        /**
+            * @hidden
+            * User's UPN to open chat with
+            */
+        user: string;
+}
+/**
+    * @hidden
+    * Hide from docs.
+    * ------
+    *
+    * @internal
+    */
+export interface OpenGroupChatRequest extends OpenChatRequest {
+        /**
+            * @hidden
+            * Array containing UPNs of users to open chat with
+            */
+        users: string[];
+        /**
+            * @hidden
+            * The display name of a conversation for 3 or more users
+            */
+        topic?: string;
+}
+/**
+    * @hidden
+    * Hide from docs.
+    * ------
+    *
+    * @internal
+    */
+export interface OpenConversationRequest {
+        /**
+            * @hidden
+            * The Id of the subEntity where the conversation is taking place
+            */
+        subEntityId: string;
+        /**
+            * @hidden
+            * The title of the conversation
+            */
+        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
+            */
+        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
+            */
+        channelId?: string;
+        /**
+            * @hidden
+            * The entity Id of the tab
+            */
+        entityId: string;
+        /**
+            * @hidden
+            * A function that is called once the conversation Id has been created
+            */
+        onStartConversation?: (conversationResponse: ConversationResponse) => void;
+        /**
+            * @hidden
+            * A function that is called if the pane is closed
+            */
+        onCloseConversation?: (conversationResponse: ConversationResponse) => void;
+}
+/**
+    * @hidden
+    * Hide from docs.
+    * ------
+    *
+    * @internal
+    */
+export interface ConversationResponse {
+        /**
+            * @hidden
+            * 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
+            */
+        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
+            */
+        channelId?: string;
+        /**
+            * @hidden
+            * The entity Id of the tab
+            */
+        entityId?: string;
+}
 /**
     * @hidden
     * Namespace to interact with the conversational subEntities inside the tab
@@ -362,34 +479,62 @@ export namespace chat {
             * @hidden
             * Hide from docs
             * --------------
-            * Allows the user to start or continue a conversation with each subentity inside the tab
+            * Allows the user to open a chat with a single user and allows
+            * for the user to specify the message they wish to send.
+            *
+            *@param openChatRequest: {@link OpenSingleChatRequest}- a request object that contains a user's email as well as an optional message parameter.
             *
             * @returns Promise resolved upon completion
             */
-        function openConversation(openConversationRequest: OpenConversationRequest): Promise<void>;
+        function openChat(openChatRequest: OpenSingleChatRequest): Promise<void>;
         /**
             * @hidden
             * Hide from docs
             * --------------
-            * Allows the user to close the conversation in the right pane
+            * Allows the user to create a chat with multiple users (2+) and allows
+            * for the user to specify a message and name the topic of the conversation. If
+            * only 1 user is provided into users array default back to origin openChat.
+            *
+            * @param openChatRequest: {@link OpenGroupChatRequest} - a request object that contains a list of user emails as well as optional parameters for message and topic (display name for the group chat).
+            *
+            * @returns Promise resolved upon completion
             */
-        function closeConversation(): void;
+        function openGroupChat(openChatRequest: OpenGroupChatRequest): Promise<void>;
         /**
             * @hidden
             * Hide from docs
             * ------
-            * Allows an app to retrieve information of all chat members
-            * Because a malicious party run your content in a browser, this value should
-            * be used only as a hint as to who the members are and never as proof of membership.
+            * Allows retrieval of information for all chat members.
+            * NOTE: This value should be used only as a hint as to who the members are
+            * and never as proof of membership in case your app is being hosted by a malicious party.
             *
-            * @param callback The callback to invoke when the {@link ChatMembersInformation} object is retrieved.
             * @returns Promise resolved with information on all chat members
             *
             * @internal
             */
         function getChatMembers(): Promise<ChatMembersInformation>;
         function isSupported(): boolean;
+        namespace conversation {
+                /**
+                    * @hidden
+                    * Hide from docs
+                    * --------------
+                    * Allows the user to start or continue a conversation with each subentity inside the tab
+                    *
+                    * @returns Promise resolved upon completion
+                    */
+                function openConversation(openConversationRequest: OpenConversationRequest): Promise<void>;
+                /**
+                    * @hidden
+                    * Hide from docs
+                    * --------------
+                    * Allows the user to close the conversation in the right pane
+                    */
+                function closeConversation(): void;
+                function isSupported(): boolean;
+        }
 }
+export {};
 
 /**
     * @hidden
@@ -2179,78 +2324,9 @@ export interface DialogInfo {
     * As of 2.0.0-beta.1, please use {@link DialogInfo} instead.
     */
 export type TaskInfo = DialogInfo;
-/**
-    * @hidden
-    * Hide from docs.
-    * ------
-    *
-    * @internal
-    */
-export interface OpenConversationRequest {
-        /**
-            * @hidden
-            * The Id of the subEntity where the conversation is taking place
-            */
-        subEntityId: string;
-        /**
-            * @hidden
-            * The title of the conversation
-            */
-        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
-            */
-        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
-            */
-        channelId?: string;
-        /**
-            * @hidden
-            * The entity Id of the tab
-            */
-        entityId: string;
-        /**
-            * @hidden
-            * A function that is called once the conversation Id has been created
-            */
-        onStartConversation?: (conversationResponse: ConversationResponse) => void;
-        /**
-            * @hidden
-            * A function that is called if the pane is closed
-            */
-        onCloseConversation?: (conversationResponse: ConversationResponse) => void;
-}
-/**
-    * @hidden
-    * Hide from docs.
-    * ------
-    *
-    * @internal
-    */
-export interface ConversationResponse {
-        /**
-            * @hidden
-            * 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
-            */
-        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
-            */
-        channelId?: string;
-        /**
-            * @hidden
-            * The entity Id of the tab
-            */
-        entityId?: string;
+export interface DialogSize {
+        height: DialogDimension | number;
+        width: DialogDimension | number;
 }
 /**
     * @hidden
@@ -2799,12 +2875,6 @@ export namespace dialog {
             * @returns a function that can be used to send messages to the dialog.
             */
         function open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): PostMessageChannel;
-        /**
-            * Update height/width dialog info properties.
-            *
-            * @param dialogInfo - An object containing width and height properties
-            */
-        function resize(dialogInfo: DialogInfo): void;
         /**
             * Submit the dialog module.
             *
@@ -2827,6 +2897,15 @@ export namespace dialog {
             */
         function registerOnMessageFromParent(listener: (message: any) => void): void;
         function isSupported(): boolean;
+        namespace update {
+                /**
+                    * Update dimensions - height/width of a dialog.
+                    *
+                    * @param dimensions - An object containing width and height properties.
+                    */
+                function resize(dimensions: DialogSize): void;
+                function isSupported(): boolean;
+        }
         namespace bot {
                 function open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): PostMessageChannel;
                 function isSupported(): boolean;
@@ -5104,7 +5183,7 @@ export namespace tasks {
         function startTask(taskInfo: TaskInfo, submitHandler?: (err: string, result: string | object) => void): IAppWindow;
         /**
             * @deprecated
-            * As of 2.0.0-beta.1, please use {@link dialog.resize dialog.resize(dialogInfo: DialogInfo): void} instead.
+            * As of 2.0.0-beta.4, please use {@link dialog.update.resize dialog.update.resize(dimensions: DialogSize): void} instead.
             *
             * Update height/width task info properties.
             *

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.15";
+var version = "2.0.0-beta.4-dev.18";
 /**
  * @hidden
  * The client version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
@@ -1819,9 +1819,12 @@ var runtime = {
         bot: undefined,
         calendar: undefined,
         call: undefined,
-        chat: undefined,
+        chat: {
+            conversation: undefined,
+        },
         dialog: {
             bot: undefined,
+            update: undefined,
         },
         location: undefined,
         logs: undefined,
@@ -1857,9 +1860,12 @@ var teamsRuntimeConfig = {
         appEntity: {},
         bot: {},
         call: {},
-        chat: {},
+        chat: {
+            conversation: {},
+        },
         dialog: {
             bot: {},
+            update: {},
         },
         files: {},
         location: {},
@@ -4147,66 +4153,68 @@ var chat;
      * @hidden
      * Hide from docs
      * --------------
-     * Allows the user to start or continue a conversation with each subentity inside the tab
+     * Allows the user to open a chat with a single user and allows
+     * for the user to specify the message they wish to send.
+     *
+     *@param openChatRequest: {@link OpenSingleChatRequest}- a request object that contains a user's email as well as an optional message parameter.
      *
      * @returns Promise resolved upon completion
      */
-    function openConversation(openConversationRequest) {
+    function openChat(openChatRequest) {
         return new Promise(function (resolve) {
             ensureInitialized(FrameContexts.content);
-            var sendPromise = sendAndHandleStatusAndReason('conversations.openConversation', {
-                title: openConversationRequest.title,
-                subEntityId: openConversationRequest.subEntityId,
-                conversationId: openConversationRequest.conversationId,
-                channelId: openConversationRequest.channelId,
-                entityId: openConversationRequest.entityId,
+            var sendPromise = sendAndHandleStatusAndReason('chat.openChat', {
+                members: openChatRequest.user,
+                message: openChatRequest.message,
             });
-            if (openConversationRequest.onStartConversation) {
-                registerHandler('startConversation', function (subEntityId, conversationId, channelId, entityId) {
-                    return openConversationRequest.onStartConversation({
-                        subEntityId: subEntityId,
-                        conversationId: conversationId,
-                        channelId: channelId,
-                        entityId: entityId,
-                    });
-                });
-            }
-            if (openConversationRequest.onCloseConversation) {
-                registerHandler('closeConversation', function (subEntityId, conversationId, channelId, entityId) {
-                    return openConversationRequest.onCloseConversation({
-                        subEntityId: subEntityId,
-                        conversationId: conversationId,
-                        channelId: channelId,
-                        entityId: entityId,
-                    });
-                });
-            }
             resolve(sendPromise);
         });
     }
-    chat.openConversation = openConversation;
+    chat.openChat = openChat;
     /**
      * @hidden
      * Hide from docs
      * --------------
-     * Allows the user to close the conversation in the right pane
+     * Allows the user to create a chat with multiple users (2+) and allows
+     * for the user to specify a message and name the topic of the conversation. If
+     * only 1 user is provided into users array default back to origin openChat.
+     *
+     * @param openChatRequest: {@link OpenGroupChatRequest} - a request object that contains a list of user emails as well as optional parameters for message and topic (display name for the group chat).
+     *
+     * @returns Promise resolved upon completion
      */
-    function closeConversation() {
-        ensureInitialized(FrameContexts.content);
-        sendMessageToParent('conversations.closeConversation');
-        removeHandler('startConversation');
-        removeHandler('closeConversation');
+    function openGroupChat(openChatRequest) {
+        return new Promise(function (resolve) {
+            if (openChatRequest.users.length < 1) {
+                throw Error('OpenGroupChat Failed: No users specified');
+            }
+            if (openChatRequest.users.length === 1) {
+                var chatRequest = {
+                    user: openChatRequest.users[0],
+                    message: openChatRequest.message,
+                };
+                openChat(chatRequest);
+            }
+            else {
+                ensureInitialized(FrameContexts.content);
+                var sendPromise = sendAndHandleStatusAndReason('chat.openChat', {
+                    members: openChatRequest.users,
+                    message: openChatRequest.message,
+                    topic: openChatRequest.topic,
+                });
+                resolve(sendPromise);
+            }
+        });
     }
-    chat.closeConversation = closeConversation;
+    chat.openGroupChat = openGroupChat;
     /**
      * @hidden
      * Hide from docs
      * ------
-     * Allows an app to retrieve information of all chat members
-     * Because a malicious party run your content in a browser, this value should
-     * be used only as a hint as to who the members are and never as proof of membership.
+     * Allows retrieval of information for all chat members.
+     * NOTE: This value should be used only as a hint as to who the members are
+     * and never as proof of membership in case your app is being hosted by a malicious party.
      *
-     * @param callback The callback to invoke when the {@link ChatMembersInformation} object is retrieved.
      * @returns Promise resolved with information on all chat members
      *
      * @internal
@@ -4222,6 +4230,68 @@ var chat;
         return runtime.supports.chat ? true : false;
     }
     chat.isSupported = isSupported;
+    var conversation;
+    (function (conversation) {
+        /**
+         * @hidden
+         * Hide from docs
+         * --------------
+         * Allows the user to start or continue a conversation with each subentity inside the tab
+         *
+         * @returns Promise resolved upon completion
+         */
+        function openConversation(openConversationRequest) {
+            return new Promise(function (resolve) {
+                ensureInitialized(FrameContexts.content);
+                var sendPromise = sendAndHandleStatusAndReason('conversations.openConversation', {
+                    title: openConversationRequest.title,
+                    subEntityId: openConversationRequest.subEntityId,
+                    conversationId: openConversationRequest.conversationId,
+                    channelId: openConversationRequest.channelId,
+                    entityId: openConversationRequest.entityId,
+                });
+                if (openConversationRequest.onStartConversation) {
+                    registerHandler('startConversation', function (subEntityId, conversationId, channelId, entityId) {
+                        return openConversationRequest.onStartConversation({
+                            subEntityId: subEntityId,
+                            conversationId: conversationId,
+                            channelId: channelId,
+                            entityId: entityId,
+                        });
+                    });
+                }
+                if (openConversationRequest.onCloseConversation) {
+                    registerHandler('closeConversation', function (subEntityId, conversationId, channelId, entityId) {
+                        return openConversationRequest.onCloseConversation({
+                            subEntityId: subEntityId,
+                            conversationId: conversationId,
+                            channelId: channelId,
+                            entityId: entityId,
+                        });
+                    });
+                }
+                resolve(sendPromise);
+            });
+        }
+        conversation.openConversation = openConversation;
+        /**
+         * @hidden
+         * Hide from docs
+         * --------------
+         * Allows the user to close the conversation in the right pane
+         */
+        function closeConversation() {
+            ensureInitialized(FrameContexts.content);
+            sendMessageToParent('conversations.closeConversation');
+            removeHandler('startConversation');
+            removeHandler('closeConversation');
+        }
+        conversation.closeConversation = closeConversation;
+        function isSupported() {
+            return runtime.supports.chat.conversation ? true : false;
+        }
+        conversation.isSupported = isSupported;
+    })(conversation = chat.conversation || (chat.conversation = {}));
 })(chat || (chat = {}));
 
 ;// CONCATENATED MODULE: ./src/public/appInstallDialog.ts
@@ -4255,17 +4325,6 @@ var appInstallDialog;
 /* eslint-disable @typescript-eslint/explicit-module-boundary-types */
 /* eslint-disable @typescript-eslint/ban-types */
 /* eslint-disable @typescript-eslint/no-unused-vars */
-var __rest = (undefined && undefined.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
 
 
 
@@ -4298,22 +4357,6 @@ var dialog;
         return sendMessageToDialog;
     }
     dialog.open = open;
-    /**
-     * Update height/width dialog info properties.
-     *
-     * @param dialogInfo - An object containing width and height properties
-     */
-    function resize(dialogInfo) {
-        ensureInitialized(FrameContexts.content, FrameContexts.sidePanel, FrameContexts.task, FrameContexts.meetingStage);
-        var width = dialogInfo.width, height = dialogInfo.height, extra = __rest(dialogInfo, ["width", "height"]);
-        if (!Object.keys(extra).length) {
-            sendMessageToParent('tasks.updateTask', [dialogInfo]);
-        }
-        else {
-            throw new Error('resize requires a dialogInfo argument containing only width and height');
-        }
-    }
-    dialog.resize = resize;
     /**
      * Submit the dialog module.
      *
@@ -4355,6 +4398,23 @@ var dialog;
         return runtime.supports.dialog ? true : false;
     }
     dialog.isSupported = isSupported;
+    var update;
+    (function (update) {
+        /**
+         * Update dimensions - height/width of a dialog.
+         *
+         * @param dimensions - An object containing width and height properties.
+         */
+        function resize(dimensions) {
+            ensureInitialized(FrameContexts.content, FrameContexts.sidePanel, FrameContexts.task, FrameContexts.meetingStage);
+            sendMessageToParent('tasks.updateTask', [dimensions]);
+        }
+        update.resize = resize;
+        function isSupported() {
+            return runtime.supports.dialog ? (runtime.supports.dialog.update ? true : false) : false;
+        }
+        update.isSupported = isSupported;
+    })(update = dialog.update || (dialog.update = {}));
     var bot;
     (function (bot) {
         function open(botUrlDialogInfo, submitHandler, messageFromChildHandler) {
@@ -6351,6 +6411,17 @@ var settings;
 
 ;// CONCATENATED MODULE: ./src/public/tasks.ts
 /* eslint-disable @typescript-eslint/ban-types */
+var __rest = (undefined && undefined.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 
 
 
@@ -6396,14 +6467,20 @@ var tasks;
     tasks.startTask = startTask;
     /**
      * @deprecated
-     * As of 2.0.0-beta.1, please use {@link dialog.resize dialog.resize(dialogInfo: DialogInfo): void} instead.
+     * As of 2.0.0-beta.4, please use {@link dialog.update.resize dialog.update.resize(dimensions: DialogSize): void} instead.
      *
      * Update height/width task info properties.
      *
      * @param taskInfo - An object containing width and height properties
      */
     function updateTask(taskInfo) {
-        dialog.resize(taskInfo);
+        taskInfo = getDefaultSizeIfNotProvided(taskInfo);
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        var width = taskInfo.width, height = taskInfo.height, extra = __rest(taskInfo, ["width", "height"]);
+        if (Object.keys(extra).length) {
+            throw new Error('resize requires a TaskInfo argument containing only width and height');
+        }
+        dialog.update.resize(taskInfo);
     }
     tasks.updateTask = updateTask;
     /**