@microsoft/teams-js 2.0.0-beta.3-dev.10 → 2.0.0-beta.3-dev.11

package/dist/MicrosoftTeams.d.ts

@@ -2853,6 +2853,16 @@ export namespace pages {
             * @returns Promise that resolves when the navigation has completed.
             */
         function navigateCrossDomain(url: string): Promise<void>;
+        /**
+            * Navigate to the given App ID and Page ID, with optional parameters for a WebURL (if the app cannot
+            * be navigated to, such as if it is not installed), Channel ID (for apps installed as a channel tab), and
+            * Sub-page ID (for navigating to specific content within the page). This is equivalent to navigating to
+            * a deep link with the above data, but does not require the app to build a URL or worry about different
+            * deep link formats for different hosts.
+            * @param params Parameters for the navigation
+            * @returns a promise that will resolve if the navigation was successful
+            */
+        function navigateToApp(params: NavigateToAppParams): Promise<void>;
         /**
             * Registers a handler for changes from or to full-screen view for a tab.
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
@@ -2863,6 +2873,32 @@ export namespace pages {
             * Checks if page capability is supported currently
             */
         function isSupported(): boolean;
+        /**
+            * Parameters for the NavigateToApp API
+            */
+        interface NavigateToAppParams {
+                /**
+                    * ID of the App to navigate to
+                    */
+                appId: string;
+                /**
+                    * Developer-defined ID of the Page to navigate to within the app (Formerly EntityID)
+                    */
+                pageId: string;
+                /**
+                    * Optional URL to open if the navigation cannot be completed within the host
+                    */
+                webUrl?: string;
+                /**
+                    * Optional developer-defined ID describing the content to navigate to within the Page. This will be passed
+                    * back to the App via the Context object.
+                    */
+                subPageId?: string;
+                /**
+                    * Optional ID of the Teams Channel where the app should be opened
+                    */
+                channelId?: string;
+        }
         /**
             * Namespace to interact with the teams specific part of the SDK.
             */

package/dist/MicrosoftTeams.js

@@ -395,7 +395,7 @@ __webpack_require__.d(__webpack_exports__, {
 });
 
 ;// CONCATENATED MODULE: ./src/internal/constants.ts
-var version = '2.0.0-beta.3-dev.10';
+var version = '2.0.0-beta.3-dev.11';
 /**
  * @hidden
  * The SDK version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
@@ -780,6 +780,19 @@ function callCallbackWithErrorOrResultOrNullFromPromiseAndReturnPromise(funcHelp
     });
     return p;
 }
+function createTeamsAppLink(params) {
+    var url = new URL('https://teams.microsoft.com/l/entity/' +
+        encodeURIComponent(params.appId) +
+        '/' +
+        encodeURIComponent(params.pageId));
+    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 }));
+    }
+    return url.toString();
+}
 
 ;// CONCATENATED MODULE: ./src/internal/internalAPIs.ts
 
@@ -887,6 +900,7 @@ var runtime = {
 };
 var teamsRuntimeConfig = {
     apiVersion: 1,
+    isLegacyTeams: true,
     supports: {
         appInstallDialog: {},
         appEntity: {},
@@ -2110,6 +2124,7 @@ function transformLegacyContextToAppContext(legacyContext) {
 
 
 
+
 /**
  * Navigation specific part of the SDK.
  *
@@ -2154,6 +2169,27 @@ var pages;
         });
     }
     pages.navigateCrossDomain = navigateCrossDomain;
+    /**
+     * Navigate to the given App ID and Page ID, with optional parameters for a WebURL (if the app cannot
+     * be navigated to, such as if it is not installed), Channel ID (for apps installed as a channel tab), and
+     * Sub-page ID (for navigating to specific content within the page). This is equivalent to navigating to
+     * a deep link with the above data, but does not require the app to build a URL or worry about different
+     * deep link formats for different hosts.
+     * @param params Parameters for the navigation
+     * @returns a promise that will resolve if the navigation was successful
+     */
+    function navigateToApp(params) {
+        return new Promise(function (resolve) {
+            ensureInitialized(FrameContexts.content, FrameContexts.sidePanel, FrameContexts.settings, FrameContexts.task, FrameContexts.stage, FrameContexts.meetingStage);
+            if (runtime.isLegacyTeams) {
+                resolve(sendAndHandleStatusAndReason('executeDeepLink', createTeamsAppLink(params)));
+            }
+            else {
+                resolve(sendAndHandleStatusAndReason('pages.navigateToApp', params));
+            }
+        });
+    }
+    pages.navigateToApp = navigateToApp;
     /**
      * Registers a handler for changes from or to full-screen view for a tab.
      * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.