@microsoft/teams-js 2.24.1-beta.1 → 2.26.0-beta.0

package/README.md

@@ -24,7 +24,7 @@ To install the stable [version](https://learn.microsoft.com/javascript/api/overv
 
 ### Production
 
-You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.24.0/js/MicrosoftTeams.min.js) or point your package manager at them.
+You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.25.0/js/MicrosoftTeams.min.js) or point your package manager at them.
 
 ## Usage
 
@@ -45,13 +45,13 @@ Reference the library inside of your `.html` page using:
 ```html
 <!-- Microsoft Teams JavaScript API (via CDN) -->
 <script
-  src="https://res.cdn.office.net/teams-js/2.24.0/js/MicrosoftTeams.min.js"
-  integrity="sha384-79NK4sbfVpgLoDFqyfj18/S1Uj8jhLBeRGvKO1Cqw5634RznExQ90myY/qV/0gsN"
+  src="https://res.cdn.office.net/teams-js/2.25.0/js/MicrosoftTeams.min.js"
+  integrity="sha384-6royw0i5cEmf/8pzbTX9dVy1pjjJA8PQOaQbGvoL/m39OdjrlcWluhQZxqy5KbJA"
   crossorigin="anonymous"
 ></script>
 
 <!-- Microsoft Teams JavaScript API (via npm) -->
-<script src="node_modules/@microsoft/teams-js@2.24.0/dist/MicrosoftTeams.min.js"></script>
+<script src="node_modules/@microsoft/teams-js@2.25.0/dist/MicrosoftTeams.min.js"></script>
 
 <!-- Microsoft Teams JavaScript API (via local) -->
 <script src="MicrosoftTeams.min.js"></script>

package/dist/MicrosoftTeams.d.ts

@@ -3027,6 +3027,9 @@ export namespace authentication {
             *
             * @returns Promise that resolves with the {@link UserProfile}.
             *
+            * @throws `Error` object in case of any problems, the most likely of which is that the calling app does not have appropriate permissions
+            * to call this method.
+            *
             * @internal
             * Limited to Microsoft-internal use
             */
@@ -3039,6 +3042,10 @@ export namespace authentication {
             * Requests the decoded Microsoft Entra user identity on behalf of the app.
             *
             * @param userRequest - It passes success/failure callbacks in the userRequest object(deprecated)
+            *
+            * @throws `Error` object in case of any problems, the most likely of which is that the calling app does not have appropriate permissions
+            * to call this method.
+            *
             * @internal
             * Limited to Microsoft-internal use
             */
@@ -3688,7 +3695,7 @@ export enum FileOpenPreference {
         Web = "web"
 }
 /**
-    * Possible Action Types
+    * Types of Action Objects
     *
     * @beta
     */
@@ -3708,8 +3715,7 @@ export interface BaseActionObject<T extends ActionObjectType> {
         type: T;
 }
 /**
-    * Stores information needed to represent M365 Content stored
-    * in OneDrive or Sharepoint
+    * Stores information needed to represent content stored in OneDrive or Sharepoint
     *
     * @beta
     */
@@ -3723,7 +3729,7 @@ export interface M365ContentAction extends BaseActionObject<ActionObjectType.M36
         secondaryId?: SecondaryId;
 }
 /**
-    * Contains information on what Graph item is being queried
+    * Contains additional IDs of the content that the action is triggered from. Maps to ids used in the Graph.
     *
     * @beta
     */
@@ -3749,13 +3755,15 @@ export enum SecondaryM365ContentIdName {
         UserId = "userId"
 }
 /**
-    * Information common to all actions
+    * Information about an Action.
     *
+    * @remarks
+    * This contains Id of the action, and the information about the object that triggered the action.
     * @beta
     */
 export interface ActionInfo {
         /**
-            * Maps to the action id supplied inside the manifest
+            * Id of the action. Maps to the action id supplied inside the manifest
             */
         actionId: string;
         /**
@@ -5790,11 +5798,11 @@ export namespace pages {
             */
         function getConfig(): Promise<InstanceConfig>;
         /**
-            * Navigates the frame to a new cross-domain URL. The domain of this URL must match at least one of the
-            * valid domains specified in the validDomains block of the manifest; otherwise, an exception will be
-            * thrown. This function needs to be used only when navigating the frame to a URL in a different domain
-            * than the current one in a way that keeps the application informed of the change and allows the SDK to
-            * continue working.
+            * @deprecated
+            * As of 2.0.0, this API is deprecated and can be replaced by the standard JavaScript
+            * API, window.location.href, when navigating the app to a new cross-domain URL. Any URL
+            * that is redirected to must be listed in the validDomains block of the manifest. Please
+            * remove any calls to this API.
             * @param url - The URL to navigate the frame to.
             * @returns Promise that resolves when the navigation has completed.
             */
@@ -5855,6 +5863,11 @@ export namespace pages {
                     * For apps installed as a channel tab, this ID can be supplied to indicate in which Teams channel the app should be opened
                     */
                 channelId?: string;
+                /**
+                * Optional ID of the chat or meeting where the app should be opened
+        
+                */
+                chatId?: string;
         }
         /**
             * Provides APIs for querying and navigating between contextual tabs of an application. Unlike personal tabs,
@@ -9525,14 +9538,10 @@ export function returnFocus(navigateForward?: boolean): void;
 export function navigateToTab(tabInstance: TabInstance, onComplete?: onCompleteHandlerFunctionType): void;
 /**
     * @deprecated
-    * As of TeamsJS v2.0.0, please use {@link pages.navigateCrossDomain pages.navigateCrossDomain(url: string): Promise\<void\>} instead.
-    *
-    * Navigates the frame to a new cross-domain URL. The domain of this URL must match at least one of the
-    * valid domains specified in the validDomains block of the manifest; otherwise, an exception will be
-    * thrown. This function needs to be used only when navigating the frame to a URL in a different domain
-    * than the current one in a way that keeps the app informed of the change and allows the SDK to
-    * continue working.
-    *
+    * As of 2.0.0, this API is deprecated and can be replaced by the standard JavaScript
+    * API, window.location.href, when navigating the app to a new cross-domain URL. Any URL
+    * that is redirected to must be listed in the validDomains block of the manifest. Please
+    * remove any calls to this API.
     * @param url - The URL to navigate the frame to.
     * @param onComplete - The callback to invoke when the action is complete.
     */

package/dist/MicrosoftTeams.js

@@ -169,7 +169,7 @@ function fromByteArray (uint8) {
 
 /***/ }),
 
-/***/ 46:
+/***/ 815:
 /***/ ((module, exports, __webpack_require__) => {
 
 /* eslint-env browser */
@@ -426,7 +426,7 @@ function localstorage() {
 	}
 }
 
-module.exports = __webpack_require__(601)(exports);
+module.exports = __webpack_require__(530)(exports);
 
 const {formatters} = module.exports;
 
@@ -445,7 +445,7 @@ formatters.j = function (v) {
 
 /***/ }),
 
-/***/ 601:
+/***/ 530:
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
 
@@ -1090,8 +1090,8 @@ __webpack_require__.d(__webpack_exports__, {
   webStorage: () => (/* reexport */ webStorage)
 });
 
-// EXTERNAL MODULE: ../../node_modules/.pnpm/debug@4.3.4/node_modules/debug/src/browser.js
-var browser = __webpack_require__(46);
+// EXTERNAL MODULE: ../../node_modules/.pnpm/debug@4.3.5/node_modules/debug/src/browser.js
+var browser = __webpack_require__(815);
 ;// CONCATENATED MODULE: ./src/internal/telemetry.ts
 
 const topLevelLogger = (0,browser.debug)('teamsJs');
@@ -2278,7 +2278,7 @@ var FileOpenPreference;
     FileOpenPreference["Web"] = "web";
 })(FileOpenPreference || (FileOpenPreference = {}));
 /**
- * Possible Action Types
+ * Types of Action Objects
  *
  * @beta
  */
@@ -2810,8 +2810,8 @@ function createTeamsAppLink(params) {
     if (params.webUrl) {
         url.searchParams.append('webUrl', params.webUrl);
     }
-    if (params.channelId || params.subPageId) {
-        url.searchParams.append('context', JSON.stringify({ channelId: params.channelId, subEntityId: params.subPageId }));
+    if (params.chatId || params.channelId || params.subPageId) {
+        url.searchParams.append('context', JSON.stringify({ chatId: params.chatId, channelId: params.channelId, subEntityId: params.subPageId }));
     }
     return url.toString();
 }
@@ -3395,7 +3395,7 @@ const _minRuntimeConfigToUninitialize = {
  * @hidden
  *  Package version.
  */
-const version = "2.24.1-beta.1";
+const version = "2.26.0-beta.0";
 
 ;// CONCATENATED MODULE: ./src/internal/internalAPIs.ts
 
@@ -4014,11 +4014,12 @@ var authentication;
             return value;
         })
             .catch((err) => {
+            const errorMessage = `Error returned, code = ${err.errorCode}, message = ${err.message}`;
             if (userRequest && userRequest.failureCallback) {
-                userRequest.failureCallback(err.message);
+                userRequest.failureCallback(errorMessage);
                 return null;
             }
-            throw err;
+            throw new Error(errorMessage);
         });
     }
     authentication.getUser = getUser;
@@ -4030,7 +4031,7 @@ var authentication;
                 return result;
             }
             else {
-                throw new Error(result);
+                throw result;
             }
         });
     }
@@ -4266,10 +4267,7 @@ function botUrlOpenHelper(apiVersionTag, urlDialogInfo, submitHandler, messageFr
     });
 }
 function urlSubmitHelper(apiVersionTag, result, appIds) {
-    // FrameContext content should not be here because dialog.submit can be called only from inside of a dialog (FrameContext task)
-    // but it's here because Teams mobile incorrectly returns FrameContext.content when calling app.getFrameContext().
-    // FrameContexts.content will be removed once the bug is fixed.
-    ensureInitialized(runtime, FrameContexts.content, FrameContexts.task);
+    ensureInitialized(runtime, FrameContexts.task);
     if (!dialog.url.isSupported()) {
         throw errorNotSupportedOnPlatform;
     }
@@ -5599,11 +5597,11 @@ var pages;
     }
     pages.getConfig = getConfig;
     /**
-     * Navigates the frame to a new cross-domain URL. The domain of this URL must match at least one of the
-     * valid domains specified in the validDomains block of the manifest; otherwise, an exception will be
-     * thrown. This function needs to be used only when navigating the frame to a URL in a different domain
-     * than the current one in a way that keeps the application informed of the change and allows the SDK to
-     * continue working.
+     * @deprecated
+     * As of 2.0.0, this API is deprecated and can be replaced by the standard JavaScript
+     * API, window.location.href, when navigating the app to a new cross-domain URL. Any URL
+     * that is redirected to must be listed in the validDomains block of the manifest. Please
+     * remove any calls to this API.
      * @param url - The URL to navigate the frame to.
      * @returns Promise that resolves when the navigation has completed.
      */
@@ -7042,7 +7040,15 @@ function shouldProcessMessage(messageSource, messageOrigin) {
             return true;
         }
         else {
-            const isOriginValid = yield validateOrigin(new URL(messageOrigin));
+            let messageOriginURL;
+            try {
+                messageOriginURL = new URL(messageOrigin);
+            }
+            catch (_) {
+                shouldProcessMessageLogger('Message has an invalid origin of %s', messageOrigin);
+                return false;
+            }
+            const isOriginValid = yield validateOrigin(messageOriginURL);
             if (!isOriginValid) {
                 shouldProcessMessageLogger('Message has an invalid origin of %s', messageOrigin);
             }
@@ -14839,14 +14845,10 @@ function navigateToTab(tabInstance, onComplete) {
 }
 /**
  * @deprecated
- * As of TeamsJS v2.0.0, please use {@link pages.navigateCrossDomain pages.navigateCrossDomain(url: string): Promise\<void\>} instead.
- *
- * Navigates the frame to a new cross-domain URL. The domain of this URL must match at least one of the
- * valid domains specified in the validDomains block of the manifest; otherwise, an exception will be
- * thrown. This function needs to be used only when navigating the frame to a URL in a different domain
- * than the current one in a way that keeps the app informed of the change and allows the SDK to
- * continue working.
- *
+ * As of 2.0.0, this API is deprecated and can be replaced by the standard JavaScript
+ * API, window.location.href, when navigating the app to a new cross-domain URL. Any URL
+ * that is redirected to must be listed in the validDomains block of the manifest. Please
+ * remove any calls to this API.
  * @param url - The URL to navigate the frame to.
  * @param onComplete - The callback to invoke when the action is complete.
  */