@microsoft/teams-js 2.0.0-beta.3-dev.68 → 2.0.0-beta.3-dev.69

package/dist/MicrosoftTeams.d.ts

@@ -3446,12 +3446,21 @@ export namespace media {
                     * @param mediaEvent indicates what the event that needs to be signaled to the host client
                     * Optional; @param callback is used to send app if host client has successfully handled the notification event or not
                     */
-                protected notifyEventToHost(mediaEvent: MediaControllerEvent, callback?: (err?: SdkError) => void): void;
+                protected notifyEventToHost(mediaEvent: MediaControllerEvent, callback?: (err?: SdkError) => void): Promise<void>;
                 /**
+                    * Function to programatically stop the ongoing media event
+                    *
+                    * @returns A resolved promise
+                    * */
+                stop(): Promise<void>;
+                /**
+                    * @deprecated
+                    * As of 2.0.0-beta.3, please use {@link MediaController.stop MediaController.stop(): Promise\<void\>} instead.
+                 
                     * Function to programatically stop the ongoing media event
                     * Optional; @param callback is used to send app if host client has successfully stopped the event or not
                     */
-                stop(callback?: (err?: SdkError) => void): void;
+                stop(callback: (err?: SdkError) => void): void;
         }
         /**
             * Callback which will register your app to listen to lifecycle events during the video capture flow
@@ -3555,6 +3564,12 @@ export namespace media {
                 sequence: number;
                 file: Blob;
         }
+        /**
+            * Select an attachment using camera/gallery
+            *
+            * @param mediaInputs - The input params to customize the media to be selected
+            * @returns  A promise resolved with an array of media data or rejected with an @see SdkError
+            */
         export function selectMedia(mediaInputs: MediaInputs): Promise<Media[]>;
         /**
             * Select an attachment using camera/gallery

package/dist/MicrosoftTeams.js

@@ -1120,7 +1120,7 @@ __webpack_require__.d(__webpack_exports__, {
 });
 
 ;// CONCATENATED MODULE: ./src/internal/constants.ts
-var version = "2.0.0-beta.3-dev.68";
+var version = "2.0.0-beta.3-dev.69";
 /**
  * @hidden
  * The client version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
@@ -1748,7 +1748,7 @@ function ensureInitialized() {
  *
  * @internal
  */
-function isAPISupportedByPlatform(requiredVersion) {
+function isCurrentSDKVersionAtLeast(requiredVersion) {
     if (requiredVersion === void 0) { requiredVersion = defaultSDKVersionForCompatCheck; }
     var value = compareSDKVersions(GlobalVars.clientSupportedSDKVersion, requiredVersion);
     if (isNaN(value)) {
@@ -1768,22 +1768,21 @@ function isHostClientMobile() {
 /**
  * @hidden
  * Helper function which indicates if current API is supported on mobile or not.
- * @returns SdkError if host client is not android/ios or if the requiredVersion is not
+ * @throws SdkError if host client is not android/ios or if the requiredVersion is not
  *          supported by platform or not. Null is returned in case of success.
  *
  * @internal
  */
-function isApiSupportedOnMobile(requiredVersion) {
+function throwExceptionIfMobileApiIsNotSupported(requiredVersion) {
     if (requiredVersion === void 0) { requiredVersion = defaultSDKVersionForCompatCheck; }
     if (!isHostClientMobile()) {
         var notSupportedError = { errorCode: ErrorCode.NOT_SUPPORTED_ON_PLATFORM };
-        return notSupportedError;
+        throw notSupportedError;
     }
-    else if (!isAPISupportedByPlatform(requiredVersion)) {
+    else if (!isCurrentSDKVersionAtLeast(requiredVersion)) {
         var oldPlatformError = { errorCode: ErrorCode.OLD_PLATFORM };
-        return oldPlatformError;
+        throw oldPlatformError;
     }
-    return null;
 }
 /**
  * @hidden
@@ -4460,21 +4459,20 @@ function decodeAttachment(attachment, mimeType) {
 }
 /**
  * @hidden
- * Function returns null if the media call is supported on current mobile version, else SdkError.
- *
+ * Function throws an SdkError if the media call is not supported on current mobile version, else undefined.
+ * @throws an SdkError if the media call is not supported
  * @internal
  */
-function isMediaCallSupportedOnMobile(mediaInputs) {
+function throwExceptionIfMediaCallIsNotSupportedOnMobile(mediaInputs) {
     if (isMediaCallForVideoAndImageInputs(mediaInputs)) {
-        return isApiSupportedOnMobile(videoAndImageMediaAPISupportVersion);
+        return throwExceptionIfMobileApiIsNotSupported(videoAndImageMediaAPISupportVersion);
     }
     else if (isMediaCallForNonFullScreenVideoMode(mediaInputs)) {
-        return isApiSupportedOnMobile(nonFullScreenVideoModeAPISupportVersion);
+        return throwExceptionIfMobileApiIsNotSupported(nonFullScreenVideoModeAPISupportVersion);
     }
     else if (isMediaCallForImageOutputFormats(mediaInputs)) {
-        return isApiSupportedOnMobile(imageOutputFormatsAPISupportVersion);
+        return throwExceptionIfMobileApiIsNotSupported(imageOutputFormatsAPISupportVersion);
     }
-    return null;
 }
 /**
  * @hidden
@@ -4612,7 +4610,6 @@ function validatePeoplePickerInput(peoplePickerInputs) {
 }
 
 ;// CONCATENATED MODULE: ./src/public/media.ts
-/* eslint-disable @typescript-eslint/explicit-member-accessibility */
 var __extends = (undefined && undefined.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
@@ -4667,7 +4664,7 @@ var media;
                 if (!GlobalVars.isFramelessWindow) {
                     throw { errorCode: ErrorCode.NOT_SUPPORTED_ON_PLATFORM };
                 }
-                if (!isAPISupportedByPlatform(captureImageMobileSupportVersion)) {
+                if (!isCurrentSDKVersionAtLeast(captureImageMobileSupportVersion)) {
                     throw { errorCode: ErrorCode.OLD_PLATFORM };
                 }
                 resolve(sendAndHandleSdkError('captureImage'));
@@ -4699,14 +4696,14 @@ var media;
             ensureInitialized(FrameContexts.content, FrameContexts.task);
             var wrappedFunction = function () {
                 return new Promise(function (resolve) {
-                    if (!isAPISupportedByPlatform(mediaAPISupportVersion)) {
+                    if (!isCurrentSDKVersionAtLeast(mediaAPISupportVersion)) {
                         throw { errorCode: ErrorCode.OLD_PLATFORM };
                     }
                     if (!validateGetMediaInputs(_this.mimeType, _this.format, _this.content)) {
                         throw { errorCode: ErrorCode.INVALID_ARGUMENTS };
                     }
                     // Call the new get media implementation via callbacks if the client version is greater than or equal to '2.0.0'
-                    if (isAPISupportedByPlatform(getMediaCallbackSupportVersion)) {
+                    if (isCurrentSDKVersionAtLeast(getMediaCallbackSupportVersion)) {
                         resolve(_this.getMediaViaCallback());
                     }
                     else {
@@ -4807,26 +4804,33 @@ var media;
          */
         MediaController.prototype.notifyEventToHost = function (mediaEvent, callback) {
             ensureInitialized(FrameContexts.content, FrameContexts.task);
-            var err = isApiSupportedOnMobile(nonFullScreenVideoModeAPISupportVersion);
-            if (err) {
-                if (callback) {
-                    callback(err);
-                }
-                return;
-            }
+            var mediaError;
+            var promise = Promise.resolve().then(function () {
+                return throwExceptionIfMobileApiIsNotSupported(nonFullScreenVideoModeAPISupportVersion);
+            });
             var params = { mediaType: this.getMediaType(), mediaControllerEvent: mediaEvent };
             sendMessageToParent('media.controller', [params], function (err) {
                 if (callback) {
-                    callback(err);
+                    return callback(err);
+                }
+                else if (err) {
+                    mediaError = err;
+                }
+            });
+            return promise
+                .then(function () {
+                if (mediaError) {
+                    throw mediaError;
                 }
+            })
+                .catch(function (err) {
+                throw err;
             });
         };
-        /**
-         * Function to programatically stop the ongoing media event
-         * Optional; @param callback is used to send app if host client has successfully stopped the event or not
-         */
         MediaController.prototype.stop = function (callback) {
-            this.notifyEventToHost(MediaControllerEvent.StopRecording, callback);
+            var _this = this;
+            var wrappedFunction = function () { return _this.notifyEventToHost(MediaControllerEvent.StopRecording, callback); };
+            return callCallbackWithErrorOrResultFromPromiseAndReturnPromise(wrappedFunction, callback);
         };
         return MediaController;
     }());
@@ -4916,13 +4920,10 @@ var media;
         ensureInitialized(FrameContexts.content, FrameContexts.task);
         var wrappedFunction = function () {
             return new Promise(function (resolve) {
-                if (!isAPISupportedByPlatform(mediaAPISupportVersion)) {
+                if (!isCurrentSDKVersionAtLeast(mediaAPISupportVersion)) {
                     throw { errorCode: ErrorCode.OLD_PLATFORM };
                 }
-                var err = isMediaCallSupportedOnMobile(mediaInputs);
-                if (err) {
-                    throw err;
-                }
+                throwExceptionIfMediaCallIsNotSupportedOnMobile(mediaInputs);
                 if (!validateSelectMediaInputs(mediaInputs)) {
                     throw { errorCode: ErrorCode.INVALID_ARGUMENTS };
                 }
@@ -4957,7 +4958,7 @@ var media;
         ensureInitialized(FrameContexts.content, FrameContexts.task);
         var wrappedFunction = function () {
             return new Promise(function (resolve) {
-                if (!isAPISupportedByPlatform(mediaAPISupportVersion)) {
+                if (!isCurrentSDKVersionAtLeast(mediaAPISupportVersion)) {
                     throw { errorCode: ErrorCode.OLD_PLATFORM };
                 }
                 if (!validateViewImagesInput(uriList)) {
@@ -5002,7 +5003,7 @@ var media;
                     GlobalVars.hostClientType === HostClientType.teamsDisplays) {
                     throw { errorCode: ErrorCode.NOT_SUPPORTED_ON_PLATFORM };
                 }
-                if (!isAPISupportedByPlatform(scanBarCodeAPIMobileSupportVersion)) {
+                if (!isCurrentSDKVersionAtLeast(scanBarCodeAPIMobileSupportVersion)) {
                     throw { errorCode: ErrorCode.OLD_PLATFORM };
                 }
                 if (!validateScanBarCodeInput(config)) {
@@ -5040,7 +5041,7 @@ var location_location;
     location_1.getLocation = getLocation;
     function getLocationHelper(props) {
         return new Promise(function (resolve) {
-            if (!isAPISupportedByPlatform(locationAPIsRequiredVersion)) {
+            if (!isCurrentSDKVersionAtLeast(locationAPIsRequiredVersion)) {
                 throw { errorCode: ErrorCode.OLD_PLATFORM };
             }
             if (!props) {
@@ -5056,7 +5057,7 @@ var location_location;
     location_1.showLocation = showLocation;
     function showLocationHelper(location) {
         return new Promise(function (resolve) {
-            if (!isAPISupportedByPlatform(locationAPIsRequiredVersion)) {
+            if (!isCurrentSDKVersionAtLeast(locationAPIsRequiredVersion)) {
                 throw { errorCode: ErrorCode.OLD_PLATFORM };
             }
             if (!location) {
@@ -5448,7 +5449,7 @@ var people;
     people_1.selectPeople = selectPeople;
     function selectPeopleHelper(peoplePickerInputs) {
         return new Promise(function (resolve) {
-            if (!isAPISupportedByPlatform(peoplePickerRequiredVersion)) {
+            if (!isCurrentSDKVersionAtLeast(peoplePickerRequiredVersion)) {
                 throw { errorCode: ErrorCode.OLD_PLATFORM };
             }
             if (!validatePeoplePickerInput(peoplePickerInputs)) {
@@ -6687,7 +6688,7 @@ var legacy;
                     GlobalVars.hostClientType === HostClientType.teamsRoomsAndroid ||
                     GlobalVars.hostClientType === HostClientType.teamsPhones ||
                     GlobalVars.hostClientType === HostClientType.teamsDisplays) &&
-                    !isAPISupportedByPlatform(getUserJoinedTeamsSupportedAndroidClientVersion)) {
+                    !isCurrentSDKVersionAtLeast(getUserJoinedTeamsSupportedAndroidClientVersion)) {
                     var oldPlatformError = { errorCode: ErrorCode.OLD_PLATFORM };
                     throw new Error(JSON.stringify(oldPlatformError));
                 }