@microsoft/teams-js 2.1.0 → 2.2.0

package/dist/MicrosoftTeams.js

@@ -1043,6 +1043,7 @@ __webpack_require__.r(__webpack_exports__);
 
 // EXPORTS
 __webpack_require__.d(__webpack_exports__, {
+  "ActionObjectType": () => (/* reexport */ ActionObjectType),
   "ChannelType": () => (/* reexport */ ChannelType),
   "ChildAppWindow": () => (/* reexport */ ChildAppWindow),
   "DialogDimension": () => (/* reexport */ DialogDimension),
@@ -1053,6 +1054,7 @@ __webpack_require__.d(__webpack_exports__, {
   "HostName": () => (/* reexport */ HostName),
   "NotificationTypes": () => (/* reexport */ NotificationTypes),
   "ParentAppWindow": () => (/* reexport */ ParentAppWindow),
+  "SecondaryM365ContentIdName": () => (/* reexport */ SecondaryM365ContentIdName),
   "TaskModuleDimension": () => (/* reexport */ TaskModuleDimension),
   "TeamType": () => (/* reexport */ TeamType),
   "UserSettingTypes": () => (/* reexport */ UserSettingTypes),
@@ -1125,7 +1127,7 @@ __webpack_require__.d(__webpack_exports__, {
 });
 
 ;// CONCATENATED MODULE: ./src/internal/constants.ts
-var version = "2.1.0";
+var version = "2.2.0";
 /**
  * @hidden
  * The client version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
@@ -1287,6 +1289,27 @@ var FileOpenPreference;
     FileOpenPreference["Desktop"] = "desktop";
     FileOpenPreference["Web"] = "web";
 })(FileOpenPreference || (FileOpenPreference = {}));
+/**
+ * Possible Action Types
+ *
+ * @beta
+ */
+var ActionObjectType;
+(function (ActionObjectType) {
+    ActionObjectType["M365Content"] = "m365content";
+})(ActionObjectType || (ActionObjectType = {}));
+/**
+ * These correspond with field names in the MSGraph
+ *
+ * @beta
+ */
+var SecondaryM365ContentIdName;
+(function (SecondaryM365ContentIdName) {
+    SecondaryM365ContentIdName["DriveId"] = "driveId";
+    SecondaryM365ContentIdName["GroupId"] = "groupId";
+    SecondaryM365ContentIdName["SiteId"] = "siteId";
+    SecondaryM365ContentIdName["UserId"] = "userId";
+})(SecondaryM365ContentIdName || (SecondaryM365ContentIdName = {}));
 var ErrorCode;
 (function (ErrorCode) {
     /**
@@ -2569,7 +2592,7 @@ var dialog;
      * Hide from docs because this function is only used during initialization
      * ------------------
      * Adds register handlers for messageForChild upon initialization and only in the tasks FrameContext. {@link FrameContexts.task}
-     * Function is called during app intitialization
+     * Function is called during app initialization
      * @internal
      */
     function initialize() {
@@ -2617,7 +2640,7 @@ var dialog;
     }
     dialog.open = open;
     /**
-     * Submit the dialog module.
+     * Submit the dialog module and close the dialog
      *
      * @param result - The result to be sent to the bot or the app. Typically a JSON object or a serialized version of it
      * @param appIds - Helps to validate that the call originates from the same appId as the one that invoked the task module
@@ -3348,6 +3371,7 @@ var app_app;
  */
 function transformLegacyContextToAppContext(legacyContext) {
     var context = {
+        actionInfo: legacyContext.actionInfo,
         app: {
             locale: legacyContext.locale,
             sessionId: legacyContext.appSessionId ? legacyContext.appSessionId : '',
@@ -5123,9 +5147,7 @@ var media;
     }(MediaController));
     media.VideoController = VideoController;
     /**
-     * @hidden
-     * Hide from docs
-     * --------
+     * @beta
      * Events which are used to communicate between the app and the host client during the media recording flow
      */
     var MediaControllerEvent;
@@ -5611,7 +5633,7 @@ var chat;
      */
     function openChat(openChatRequest) {
         return new Promise(function (resolve) {
-            ensureInitialized(FrameContexts.content);
+            ensureInitialized(FrameContexts.content, FrameContexts.task);
             if (!isSupported()) {
                 throw errorNotSupportedOnPlatform;
             }
@@ -5650,7 +5672,7 @@ var chat;
                 openChat(chatRequest);
             }
             else {
-                ensureInitialized(FrameContexts.content);
+                ensureInitialized(FrameContexts.content, FrameContexts.task);
                 if (!isSupported()) {
                     throw errorNotSupportedOnPlatform;
                 }
@@ -6201,9 +6223,9 @@ var meeting;
     }
     meeting.getAppContentStageSharingState = getAppContentStageSharingState;
     /**
-     * Registers a handler for changes to paticipant speaking states. If any participant is speaking, isSpeakingDetected
-     * will be true. If no participants are speaking, isSpeakingDetected will be false. Only one handler can be registered
-     * at a time. A subsequent registration replaces an existing registration.
+     * Registers a handler for changes to paticipant speaking states. This API returns {@link ISpeakingState}, which will have isSpeakingDetected
+     * and/or an error object. If any participant is speaking, isSpeakingDetected will be true. If no participants are speaking, isSpeakingDetected
+     * will be false. Default value is false. Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
      *
      * @param handler The handler to invoke when the speaking state of any participant changes (start/stop speaking).
      */
@@ -7205,7 +7227,7 @@ function shareDeepLink(deepLinkParameters) {
 }
 /**
  * @deprecated
- * As of 2.0.0, please use {@link app.openLink core.openLink(deepLink: string): Promise\<void\>} instead.
+ * As of 2.0.0, please use {@link app.openLink app.openLink(deepLink: string): Promise\<void\>} instead.
  *
  * Execute deep link API.
  *
@@ -7237,7 +7259,7 @@ function setFrameContext(frameContext) {
  * @deprecated
  * As of 2.0.0, please use {@link pages.initializeWithFrameContext pages.initializeWithFrameContext(frameInfo: FrameInfo, callback?: () => void, validMessageOrigins?: string[],): void} instead.
  *
- * Initilize with FrameContext
+ * Initialize with FrameContext
  *
  * @param frameContext - FrameContext information to be set
  * @param callback - The optional callback to be invoked be invoked after initilizing the frame context
@@ -7254,6 +7276,8 @@ function initializeWithFrameContext(frameContext, callback, validMessageOrigins)
  */
 function transformAppContextToLegacyContext(appContext) {
     var context = {
+        // actionInfo
+        actionInfo: appContext.actionInfo,
         // app
         locale: appContext.app.locale,
         appSessionId: appContext.app.sessionId,
@@ -7631,7 +7655,7 @@ var tasks;
     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}
+     * otherwise uses the height and width values corresponding to {@link TaskModuleDimension | TaskModuleDimension.Small}
      * @param taskInfo TaskInfo object from which to extract size info, if specified
      * @returns TaskInfo with height and width specified
      */
@@ -8037,26 +8061,80 @@ var files;
      * @hidden
      * Hide from docs
      *
-     * Initiates the 3P cloud storage provider file action (Upload / Download / Delete) flow
+     * Initiates the delete 3P cloud storage file(s) / folder (folder has to be empty) flow,
+     * which will delete existing file(s) / folder from the given 3P provider
      *
-     * Upload Action : Allows uploading file(s) to the given 3P cloud storage provider
-     * Download Action : Allows downloading file(s) from the given 3P cloud storage provider
-     * Delete Action : Allows deleting file(s) from the given 3P cloud storage provider
+     * @param deleteFileRequest 3P cloud storage provider delete action request content
+     * @param callback Callback that will be triggered post deleting existing file(s) flow is finished
+     */
+    function deleteCloudStorageProviderFile(deleteFileRequest, callback) {
+        ensureInitialized(FrameContexts.content);
+        if (!callback) {
+            throw getSdkError(ErrorCode.INVALID_ARGUMENTS, '[files.deleteCloudStorageProviderFile] callback cannot be null');
+        }
+        if (!(deleteFileRequest &&
+            deleteFileRequest.content &&
+            deleteFileRequest.content.itemList &&
+            deleteFileRequest.content.itemList.length > 0)) {
+            throw getSdkError(ErrorCode.INVALID_ARGUMENTS, '[files.deleteCloudStorageProviderFile] 3P cloud storage provider request content details are missing');
+        }
+        sendMessageToParent('files.deleteCloudStorageProviderFile', [deleteFileRequest], callback);
+    }
+    files_1.deleteCloudStorageProviderFile = deleteCloudStorageProviderFile;
+    /**
+     * @hidden
+     * Hide from docs
+     *
+     * Initiates the download 3P cloud storage file(s) flow,
+     * which will download existing file(s) from the given 3P provider in the teams client side without sharing any file info in the callback
+     *
+     * @param downloadFileRequest 3P cloud storage provider download file(s) action request content
+     * @param callback Callback that will be triggered post downloading existing file(s) flow is finished
+     */
+    function downloadCloudStorageProviderFile(downloadFileRequest, callback) {
+        ensureInitialized(FrameContexts.content);
+        if (!callback) {
+            throw getSdkError(ErrorCode.INVALID_ARGUMENTS, '[files.downloadCloudStorageProviderFile] callback cannot be null');
+        }
+        if (!(downloadFileRequest &&
+            downloadFileRequest.content &&
+            downloadFileRequest.content.itemList &&
+            downloadFileRequest.content.itemList.length > 0)) {
+            throw getSdkError(ErrorCode.INVALID_ARGUMENTS, '[files.downloadCloudStorageProviderFile] 3P cloud storage provider request content details are missing');
+        }
+        sendMessageToParent('files.downloadCloudStorageProviderFile', [downloadFileRequest], callback);
+    }
+    files_1.downloadCloudStorageProviderFile = downloadCloudStorageProviderFile;
+    /**
+     * @hidden
+     * Hide from docs
      *
-     * @param cloudStorageProviderFileActionRequest 3P cloud storage provider file action (Upload / Download / Delete) request content
-     * @param callback Callback that will be triggered post 3P cloud storage action
+     * Initiates the upload 3P cloud storage file(s) flow, which will upload file(s) to the given 3P provider
+     *
+     * @param uploadFileRequest 3P cloud storage provider upload file(s) action request content
+     * @param callback Callback that will be triggered post uploading file(s) flow is finished
      */
-    function performCloudStorageProviderFileAction(cloudStorageProviderFileActionRequest, callback) {
+    function uploadCloudStorageProviderFile(uploadFileRequest, callback) {
         ensureInitialized(FrameContexts.content);
         if (!callback) {
-            throw getSdkError(ErrorCode.INVALID_ARGUMENTS, '[files.performCloudStorageProviderFileAction] callback cannot be null');
+            throw getSdkError(ErrorCode.INVALID_ARGUMENTS, '[files.uploadCloudStorageProviderFile] callback cannot be null');
+        }
+        if (!(uploadFileRequest &&
+            uploadFileRequest.content &&
+            uploadFileRequest.content.itemList &&
+            uploadFileRequest.content.itemList.length > 0)) {
+            throw getSdkError(ErrorCode.INVALID_ARGUMENTS, '[files.uploadCloudStorageProviderFile] 3P cloud storage provider request content details are missing');
         }
-        if (!(cloudStorageProviderFileActionRequest && cloudStorageProviderFileActionRequest.content)) {
-            throw getSdkError(ErrorCode.INVALID_ARGUMENTS, '[files.performCloudStorageProviderFileAction] 3P cloud storage provider request content is missing');
+        if (!(uploadFileRequest.content.destinationFolder &&
+            (uploadFileRequest.content.providerCode === CloudStorageProvider.SharePoint
+                ? uploadFileRequest.content.destinationFolder.isFolder
+                : uploadFileRequest.content.destinationFolder.isSubdirectory) &&
+            uploadFileRequest.content.destinationFolder.objectUrl)) {
+            throw getSdkError(ErrorCode.INVALID_ARGUMENTS, '[files.uploadCloudStorageProviderFile] Invalid destination folder details');
         }
-        sendMessageToParent('files.performCloudStorageProviderFileAction', [cloudStorageProviderFileActionRequest], callback);
+        sendMessageToParent('files.uploadCloudStorageProviderFile', [uploadFileRequest], callback);
     }
-    files_1.performCloudStorageProviderFileAction = performCloudStorageProviderFileAction;
+    files_1.uploadCloudStorageProviderFile = uploadCloudStorageProviderFile;
     /**
      * @hidden
      * Hide from docs
@@ -8072,7 +8150,7 @@ var files;
         if (!handler) {
             throw new Error('[registerCloudStorageProviderListChangeHandler] Handler cannot be null');
         }
-        registerHandler('files.cloudStorageProviderList', handler);
+        registerHandler('files.cloudStorageProviderListChange', handler);
     }
     files_1.registerCloudStorageProviderListChangeHandler = registerCloudStorageProviderListChangeHandler;
     /**
@@ -8090,7 +8168,7 @@ var files;
         if (!handler) {
             throw new Error('[registerCloudStorageProviderContentChangeHandler] Handler cannot be null');
         }
-        registerHandler('files.cloudStorageProviderContent', handler);
+        registerHandler('files.cloudStorageProviderContentChange', handler);
     }
     files_1.registerCloudStorageProviderContentChangeHandler = registerCloudStorageProviderContentChangeHandler;
     function getSdkError(errorCode, message) {