@microsoft/teams-js 2.19.1-beta.0 → 2.20.0-beta.1

package/dist/MicrosoftTeams.js

@@ -1012,8 +1012,8 @@ var ApiName;
     ApiName["Dialog_Url_Bot_Open"] = "dialog.url.bot.open";
     ApiName["Dialog_Url_Open"] = "dialog.url.open";
     ApiName["Dialog_Url_Submit"] = "dialog.url.submit";
-    ApiName["Dialog_Url_SendMessageToParentFromDialog"] = "dialog.url.sendMessageToParentFromDialog";
-    ApiName["Dialog_Url_SendMessageToDialog"] = "dialog.url.sendMessageToDialog";
+    ApiName["Dialog_Url_ParentCommunication_SendMessageToParentFromDialog"] = "dialog.url.parentCommunication.sendMessageToParentFromDialog";
+    ApiName["Dialog_Url_ParentCommunication_SendMessageToDialog"] = "dialog.url.parentCommunication.sendMessageToDialog";
     ApiName["Files_AddCloudStorageFolder"] = "files.addCloudStorageFolder";
     ApiName["Files_AddCloudStorageProvider"] = "files.addCloudStorageProvider";
     ApiName["Files_AddCloudStorageProviderFile"] = "files.addCloudStorageProviderFile";
@@ -1035,7 +1035,7 @@ var ApiName;
     ApiName["GeoLocation_GetCurrentLocation"] = "geoLocation.getCurrentLocation";
     ApiName["GeoLocation_HasPermission"] = "geoLocation.hasPermission";
     ApiName["GeoLocation_Map_ChooseLocation"] = "geoLocation.map.chooseLocation";
-    ApiName["GeoLocation_RequestPermission"] = "geoLocation.hasPermission";
+    ApiName["GeoLocation_RequestPermission"] = "geoLocation.requestPermission";
     ApiName["GeoLocation_ShowLocation"] = "geoLocation.showLocation";
     ApiName["Interactive_GetClientInfo"] = "interactive.getClientInfo";
     ApiName["Interactive_GetClientRoles"] = "interactive.getClientRoles";
@@ -1108,8 +1108,8 @@ var ApiName;
     ApiName["Pages_BackStack_NavigateBack"] = "pages.backStack.navigateBack";
     ApiName["Pages_BackStack_RegisterBackButtonHandler"] = "pages.backStack.registerBackButtonHandler";
     ApiName["Pages_Config_RegisterChangeConfigHandler"] = "pages.config.registerChangeConfigHandler";
-    ApiName["Pages_Config_RegisterOnRemoveHandlerHelper"] = "pages.config.registerOnRemoveHandlerHelper";
-    ApiName["Pages_Config_RegisterOnSaveHandlerHelper"] = "pages.config.registerOnSaveHandlerHelper";
+    ApiName["Pages_Config_RegisterOnRemoveHandler"] = "pages.config.registerOnRemoveHandler";
+    ApiName["Pages_Config_RegisterOnSaveHandler"] = "pages.config.registerOnSaveHandler";
     ApiName["Pages_Config_SetConfig"] = "pages.config.setConfig";
     ApiName["Pages_Config_SetValidityState"] = "pages.config.setValidityState";
     ApiName["Pages_CurrentApp_NavigateTo"] = "pages.currentApp.navigateTo";
@@ -1121,13 +1121,23 @@ var ApiName;
     ApiName["Pages_NavigateToApp"] = "pages.navigateToApp";
     ApiName["Pages_RegisterFocusEnterHandler"] = "pages.registerFocusEnterHandler";
     ApiName["Pages_RegisterFullScreenHandler"] = "pages.registerFullScreenHandler";
+    ApiName["Pages_RemoveEvent_NotifyFailure"] = "pages.removeEvent.notifyFailure";
+    ApiName["Pages_RemoveEvent_NotifySuccess"] = "pages.removeEvent.notifySuccess";
     ApiName["Pages_ReturnFocus"] = "pages.returnFocus";
+    ApiName["Pages_SaveEvent_NotifyFailure"] = "pages.saveEvent.notifyFailure";
+    ApiName["Pages_SaveEvent_NotifySuccess"] = "pages.saveEvent.notifySuccess";
     ApiName["Pages_SetCurrentFrame"] = "pages.setCurrentFrame";
     ApiName["Pages_ShareDeepLink"] = "pages.shareDeepLink";
     ApiName["Pages_Tabs_GetMruTabInstances"] = "pages.tabs.getMruTabInstances";
     ApiName["Pages_Tabs_GetTabInstances"] = "pages.tabs.getTabInstances";
     ApiName["Pages_Tabs_NavigateToTab"] = "pages.tabs.navigateToTab";
     ApiName["People_SelectPeople"] = "people.selectPeople";
+    ApiName["PrivateAPIs_OpenFilePreview"] = "openFilePreview";
+    ApiName["PrivateAPIs_RegisterCustomHandler"] = "registerCustomHandler";
+    ApiName["PrivateAPIs_RegisterUserSettingsChangeHandler"] = "registerUserSettingsChangeHandler";
+    ApiName["PrivateAPIs_SendCustomMessage"] = "sendCustomMessage";
+    ApiName["PrivateAPIs_UploadCustomApp"] = "uploadCustomApp";
+    ApiName["Profile_ShowProfile"] = "profile.showProfile";
     ApiName["PublicAPIs_ExecuteDeepLink"] = "executeDeepLink";
     ApiName["PublicAPIs_GetContext"] = "getContext";
     ApiName["PublicAPIs_GetMruTabInstances"] = "getMruTabInstances";
@@ -1146,17 +1156,70 @@ var ApiName;
     ApiName["PublicAPIs_ShareDeepLink"] = "shareDeepLink";
     ApiName["RegisterHandler"] = "registerHandler";
     ApiName["RegisterOnThemeChangeHandler"] = "registerOnThemeChangeHandler";
+    ApiName["RemoteCamera_GetCapableParticipants"] = "remoteCamera.getCapableParticipants";
+    ApiName["RemoteCamera_RegisterOnCapableParticipantsChangeHandler"] = "remoteCamera.registerOnCapableParticipantsChangeHandler";
+    ApiName["RemoteCamera_RegisterOnDeviceStateChangeHandler"] = "remoteCamera.registerOnDeviceStateChangeHandler";
+    ApiName["RemoteCamera_RegisterOnErrorHandler"] = "remoteCamera.registerOnErrorHandler";
+    ApiName["RemoteCamera_RegisterOnSessionStatusChangeHandler"] = "remoteCamera.registerOnSessionStatusChangeHandler";
+    ApiName["RemoteCamera_RequestControl"] = "remoteCamera.requestControl";
+    ApiName["RemoteCamera_SendControlCommand"] = "remoteCamera.sendControlCommand";
+    ApiName["RemoteCamera_TerminateSession"] = "remoteCamera.terminateSession";
+    ApiName["Search_CloseSearch"] = "search.closeSearch";
+    ApiName["Search_RegisterOnChangeHandler"] = "search.registerOnChangeHandler";
+    ApiName["Search_RegisterOnClosedHandler"] = "search.registerOnClosedHandler";
+    ApiName["Search_RegisterOnExecutedHandler"] = "search.registerOnExecutedHandler";
+    ApiName["Search_UnregisterHandlers"] = "search.unregisterHandlers";
+    ApiName["SecondaryBrowser_OpenUrl"] = "secondaryBrowser.openUrl";
+    ApiName["Settings_GetSettings"] = "settings.getSettings";
+    ApiName["Settings_RegisterOnRemoveHandler"] = "settings.registerOnRemoveHandler";
+    ApiName["Settings_RegisterOnSaveHandler"] = "settings.registerOnSaveHandler";
     ApiName["Settings_Remove_Failure"] = "settings.remove.failure";
     ApiName["Settings_Remove_Success"] = "settings.remove.success";
     ApiName["Settings_Save_Failure"] = "settings.save.failure";
     ApiName["Settings_Save_Success"] = "settings.save.success";
+    ApiName["Settings_SetSettings"] = "settings.setSettings";
+    ApiName["Settings_SetValidityState"] = "settings.setValidityState";
+    ApiName["StageView_Open"] = "stageView.open";
     ApiName["Tasks_StartTask"] = "tasks.startTask";
     ApiName["Tasks_SubmitTask"] = "tasks.submitTask";
     ApiName["Tasks_UpdateTask"] = "tasks.updateTask";
+    ApiName["Teams_FullTrust_GetConfigSetting"] = "teams.fullTrust.getConfigSetting";
+    ApiName["Teams_FullTrust_JoinedTeams_GetUserJoinedTeams"] = "teams.fullTrust.joinedTeams.getUserJoinedTeams";
+    ApiName["Teams_GetTeamChannels"] = "teams.getTeamChannels";
+    ApiName["Teams_RefreshSiteUrl"] = "teams.refreshSiteUrl";
+    ApiName["VideoEffects_MediaStream_RegisterForVideoFrame"] = "videoEffects.mediaStream.registerForVideoFrame";
+    ApiName["VideoEffects_NotifySelectedVideoEffectChanged"] = "videoEffects.notifySelectedVideoEffectChanged";
+    ApiName["VideoEffects_NotifyError"] = "videoEffects.notifyError";
+    ApiName["VideoEffects_NotifyVideoFrameProcessed"] = "videoEffects.notifyVideoFrameProcessed";
+    ApiName["VideoEffects_RegisterEffectParameterChangeHandler"] = "videoEffects.registerEffectParameterChangeHandler";
+    ApiName["VideoEffects_RegisterForVideoEffect"] = "videoEffects.registerForVideoEffect";
+    ApiName["VideoEffects_RegisterForVideoFrame"] = "videoEffects.registerForVideoFrame";
+    ApiName["VideoEffects_RegisterSetFrameProcessTimeLimitHandler"] = "videoEffects.setFrameProcessTimeLimitHandler";
+    ApiName["VideoEffects_RegisterStartVideoExtensibilityVideoStreamHandler"] = "videoEffects.startVideoExtensibilityVideoStreamHandler";
+    ApiName["VideoEffects_RegisterForVideoBufferHandler"] = "videoEffects.registerForVideoBufferHandler";
+    ApiName["VideoEffectsEx_MediaStream_RegisterForVideoFrame"] = "videoEffectsEX.mediaStream.registerForVideoFrame";
+    ApiName["VideoEffectsEx_NotifyError"] = "videoEffectsEx.notifyError";
+    ApiName["VideoEffectsEx_NotifySelectedVideoEffectChanged"] = "videoEffectsEx.notifySelectedVideoEffectChanged";
+    ApiName["VideoEffectsEx_NotifyVideoFrameProcessed"] = "videoEffectsEx.notifyVideoFrameProcessed";
+    ApiName["VideoEffectsEx_RegisterEffectParameterChangeHandler"] = "videoEffectsEx.registerEffectParamterChangeHandler";
+    ApiName["VideoEffectsEx_RegisterForVideoEffect"] = "videoEffectsEx.registerForVideoEffect";
+    ApiName["VideoEffectsEx_RegisterForVideoFrame"] = "videoEffectsEx.registerForVideoFrame";
+    ApiName["VideoEffectsEx_RegisterNewVideoFrameHandler"] = "videoEffectsEx.registerNewVideoFrameHandler";
+    ApiName["VideoEffectsEx_RegisterSetFrameProcessTimeLimitHandler"] = "videoEffectsEX.registerSetFrameProcessTimeLimitHandler";
+    ApiName["VideoEffectsEx_RegisterStartVideoExtensibilityVideoStreamHandler"] = "videoEffectsEX.registerStartVideoExtensibilityVideoStreamHandler";
+    ApiName["VideoEffectsEx_UpdatePersonalizedEffects"] = "videoEffectsEx.updatePersonalizedEffects";
+    ApiName["VideoPerformanceMonitor_Constructor"] = "videoPerformanceMonitor.performanceDataGenerated";
+    ApiName["VideoPerformanceMonitor_ReportFrameProcessed"] = "videoPerformanceMonitor.reportFrameProcessed";
+    ApiName["VideoPerformanceMonitor_ReportTextureStreamAcquired"] = "videoPerformanceMonitor.reportTextureStreamAcquired";
+    ApiName["VideoPerformanceMonitor_StartMonitorSlowFrameProcessing"] = "videoPerformanceMonitor.startMonitorSlowFrameProcessing";
+    ApiName["VisualMedia_HasPermission"] = "visualMedia.hasPermission";
+    ApiName["VisualMedia_Image_CaptureImages"] = "visualMedia.image.captureImages";
+    ApiName["VisualMedia_Image_RetrieveImages"] = "visualMedia.image.retrieveImages";
+    ApiName["VisualMedia_RequestPermission"] = "visualMedia.requestPermission";
 })(ApiName || (ApiName = {}));
 
 ;// CONCATENATED MODULE: ./src/artifactsForCDN/validDomains.json
-const validDomains_namespaceObject = JSON.parse('{"validOrigins":["teams.microsoft.com","teams.microsoft.us","gov.teams.microsoft.us","dod.teams.microsoft.us","int.teams.microsoft.com","teams.live.com","devspaces.skype.com","ssauth.skype.com","local.teams.live.com","local.teams.live.com:8080","local.teams.office.com","local.teams.office.com:8080","outlook.office.com","outlook-sdf.office.com","outlook.office365.com","outlook-sdf.office365.com","outlook.live.com","outlook-sdf.live.com","*.teams.microsoft.com","*.www.office.com","www.office.com","word.office.com","excel.office.com","powerpoint.office.com","www.officeppe.com","*.www.microsoft365.com","www.microsoft365.com","bing.com","edgeservices.bing.com","www.bing.com","www.staging-bing-int.com","teams.cloud.microsoft","outlook.cloud.microsoft","m365.cloud.microsoft","copilot.microsoft.com"]}');
+const validDomains_namespaceObject = JSON.parse('{"validOrigins":["teams.microsoft.com","teams.microsoft.us","gov.teams.microsoft.us","dod.teams.microsoft.us","int.teams.microsoft.com","*.teams.microsoft.com","outlook.office.com","outlook-sdf.office.com","outlook.office365.com","outlook-sdf.office365.com","outlook.live.com","outlook-sdf.live.com","teams.live.com","local.teams.live.com","local.teams.live.com:8080","local.teams.office.com","local.teams.office.com:8080","devspaces.skype.com","ssauth.skype.com","*.www.office.com","www.office.com","word.office.com","excel.office.com","powerpoint.office.com","www.officeppe.com","*.www.microsoft365.com","www.microsoft365.com","bing.com","edgeservices.bing.com","www.bing.com","www.staging-bing-int.com","teams.cloud.microsoft","outlook.cloud.microsoft","m365.cloud.microsoft","copilot.microsoft.com","windows.msn.com"]}');
 var artifactsForCDN_validDomains_namespaceObject = /*#__PURE__*/__webpack_require__.t(validDomains_namespaceObject, 2);
 ;// CONCATENATED MODULE: ./src/internal/constants.ts
 
@@ -2102,7 +2165,7 @@ var __rest = (undefined && undefined.__rest) || function (s, e) {
 
 
 const runtimeLogger = getLogger('runtime');
-const latestRuntimeApiVersion = 3;
+const latestRuntimeApiVersion = 4;
 function isLatestRuntimeVersion(runtime) {
     return runtime.apiVersion === latestRuntimeApiVersion;
 }
@@ -2134,7 +2197,7 @@ function isRuntimeInitialized(runtime) {
 }
 let runtime_runtime = _uninitializedRuntime;
 const versionAndPlatformAgnosticTeamsRuntimeConfig = {
-    apiVersion: 3,
+    apiVersion: 4,
     hostVersionsInfo: teamsMinAdaptiveCardVersion,
     isLegacyTeams: true,
     supports: {
@@ -2149,6 +2212,7 @@ const versionAndPlatformAgnosticTeamsRuntimeConfig = {
             },
             url: {
                 bot: {},
+                parentCommunication: {},
             },
             update: {},
         },
@@ -2246,6 +2310,27 @@ const upgradeChain = [
             return Object.assign(Object.assign({}, previousVersionRuntime), { apiVersion: 3, supports: newSupports });
         },
     },
+    {
+        versionToUpgradeFrom: 3,
+        upgradeToNextVersion: (previousVersionRuntime) => {
+            var _a, _b, _c, _d, _e;
+            return {
+                apiVersion: 4,
+                hostVersionsInfo: previousVersionRuntime.hostVersionsInfo,
+                isLegacyTeams: previousVersionRuntime.isLegacyTeams,
+                supports: Object.assign(Object.assign({}, previousVersionRuntime.supports), { dialog: previousVersionRuntime.supports.dialog
+                        ? {
+                            card: (_a = previousVersionRuntime.supports.dialog) === null || _a === void 0 ? void 0 : _a.card,
+                            url: {
+                                bot: (_c = (_b = previousVersionRuntime.supports.dialog) === null || _b === void 0 ? void 0 : _b.url) === null || _c === void 0 ? void 0 : _c.bot,
+                                parentCommunication: ((_d = previousVersionRuntime.supports.dialog) === null || _d === void 0 ? void 0 : _d.url) ? {} : undefined,
+                            },
+                            update: (_e = previousVersionRuntime.supports.dialog) === null || _e === void 0 ? void 0 : _e.update,
+                        }
+                        : undefined }),
+            };
+        },
+    },
 ];
 const mapTeamsVersionToSupportedCapabilities = {
     // 1.0.0 just signifies "these capabilities have practically always been supported." For some of these
@@ -2417,7 +2502,7 @@ const _minRuntimeConfigToUninitialize = {
  * @hidden
  *  Package version.
  */
-const version = "2.19.1-beta.0";
+const version = "2.20.0-beta.1";
 
 ;// CONCATENATED MODULE: ./src/internal/internalAPIs.ts
 
@@ -2691,7 +2776,6 @@ function validateOrigin(messageOrigin) {
 
 
 
-
 /**
  * Namespace to interact with the authentication-specific part of the SDK.
  *
@@ -2830,6 +2914,7 @@ var authentication;
                 authTokenRequest === null || authTokenRequest === void 0 ? void 0 : authTokenRequest.resources,
                 authTokenRequest === null || authTokenRequest === void 0 ? void 0 : authTokenRequest.claims,
                 authTokenRequest === null || authTokenRequest === void 0 ? void 0 : authTokenRequest.silent,
+                authTokenRequest === null || authTokenRequest === void 0 ? void 0 : authTokenRequest.tenantId,
             ]));
         }).then(([success, result]) => {
             if (success) {
@@ -2968,21 +3053,11 @@ var authentication;
         });
     }
     /**
-     * When using {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>}, the
-     * window that was opened to execute the authentication flow should call this method after authentiction to notify the caller of
-     * {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} that the
-     * authentication request was successful.
-     *
-     * @remarks
-     * This function is usable only from the authentication window.
-     * This call causes the authentication window to be closed.
-     *
-     * @param result - Specifies a result for the authentication. If specified, the frame that initiated the authentication pop-up receives
-     * this value in its callback or via the `Promise` return value
-     * @param callbackUrl - Specifies the url to redirect back to if the client is Win32 Outlook.
+     * @deprecated
+     * This function used to have an unused optional second parameter called callbackUrl. Because it was not used, it has been removed.
+     * Please use the {@link authentication.notifySuccess authentication.notifySuccess(result?: string): void} instead.
      */
-    function notifySuccess(result, callbackUrl) {
-        redirectIfWin32Outlook(callbackUrl, 'result', result);
+    function notifySuccess(result, _callbackUrl) {
         internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.authentication);
         sendMessageToParent('authentication.authenticate.success', [result]);
         // Wait for the message to be sent before closing the window
@@ -2990,22 +3065,11 @@ var authentication;
     }
     authentication.notifySuccess = notifySuccess;
     /**
-     * When using {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>}, the
-     * window that was opened to execute the authentication flow should call this method after authentiction to notify the caller of
-     * {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>} that the
-     * authentication request failed.
-  
-     *
-     * @remarks
-     * This function is usable only on the authentication window.
-     * This call causes the authentication window to be closed.
-     *
-     * @param result - Specifies a result for the authentication. If specified, the frame that initiated the authentication pop-up receives
-     * this value in its callback or via the `Promise` return value
-     * @param callbackUrl - Specifies the url to redirect back to if the client is Win32 Outlook.
+     * @deprecated
+     * This function used to have an unused optional second parameter called callbackUrl. Because it was not used, it has been removed.
+     * Please use the {@link authentication.notifyFailure authentication.notifyFailure(result?: string): void} instead.
      */
-    function notifyFailure(reason, callbackUrl) {
-        redirectIfWin32Outlook(callbackUrl, 'reason', reason);
+    function notifyFailure(reason, _callbackUrl) {
         internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.authentication);
         sendMessageToParent('authentication.authenticate.failure', [reason]);
         // Wait for the message to be sent before closing the window
@@ -3034,48 +3098,6 @@ var authentication;
             closeAuthenticationWindow();
         }
     }
-    /**
-     * Validates that the callbackUrl param is a valid connector url, appends the result/reason and authSuccess/authFailure as URL fragments and redirects the window
-     * @param callbackUrl - the connectors url to redirect to
-     * @param key - "result" in case of success and "reason" in case of failure
-     * @param value - the value of the passed result/reason parameter
-     */
-    function redirectIfWin32Outlook(callbackUrl, key, value) {
-        if (callbackUrl) {
-            const link = document.createElement('a');
-            link.href = decodeURIComponent(callbackUrl);
-            if (link.host &&
-                link.host !== ssrSafeWindow().location.host &&
-                link.host === 'outlook.office.com' &&
-                link.search.indexOf('client_type=Win32_Outlook') > -1) {
-                if (key && key === 'result') {
-                    if (value) {
-                        link.href = updateUrlParameter(link.href, 'result', value);
-                    }
-                    Communication.currentWindow.location.assign(updateUrlParameter(link.href, 'authSuccess', ''));
-                }
-                if (key && key === 'reason') {
-                    if (value) {
-                        link.href = updateUrlParameter(link.href, 'reason', value);
-                    }
-                    Communication.currentWindow.location.assign(updateUrlParameter(link.href, 'authFailure', ''));
-                }
-            }
-        }
-    }
-    /**
-     * Appends either result or reason as a fragment to the 'callbackUrl'
-     * @param uri - the url to modify
-     * @param key - the fragment key
-     * @param value - the fragment value
-     */
-    function updateUrlParameter(uri, key, value) {
-        const i = uri.indexOf('#');
-        let hash = i === -1 ? '#' : uri.substr(i);
-        hash = hash + '&' + key + (value !== '' ? '=' + value : '');
-        uri = i === -1 ? uri : uri.substr(0, i);
-        return uri + hash;
-    }
     /**
      * @hidden
      * Limited set of data residencies information exposed to 1P application developers
@@ -3245,69 +3267,94 @@ var dialog;
         }
         url.submit = submit;
         /**
-         *  Send message to the parent from dialog
+         * Subcapability that allows communication between the dialog and the parent app.
          *
          * @remarks
-         * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
-         *
-         * @param message - The message to send to the parent
+         * Note that dialog can be invoked from parentless scenarios e.g. Search Message Extensions. The subcapability `parentCommunication` is not supported in such scenarios.
          *
          * @beta
          */
-        function sendMessageToParentFromDialog(
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        message) {
-            internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.task);
-            if (!isSupported()) {
-                throw errorNotSupportedOnPlatform;
+        let parentCommunication;
+        (function (parentCommunication) {
+            /**
+             *  Send message to the parent from dialog
+             *
+             * @remarks
+             * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
+             *
+             * @param message - The message to send to the parent
+             *
+             * @beta
+             */
+            function sendMessageToParentFromDialog(
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            message) {
+                internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.task);
+                if (!isSupported()) {
+                    throw errorNotSupportedOnPlatform;
+                }
+                sendMessageToParentWithVersion(getApiVersionTag(dialogTelemetryVersionNumber, ApiName.Dialog_Url_ParentCommunication_SendMessageToParentFromDialog), 'messageForParent', [message]);
             }
-            sendMessageToParentWithVersion(getApiVersionTag(dialogTelemetryVersionNumber, ApiName.Dialog_Url_SendMessageToParentFromDialog), 'messageForParent', [message]);
-        }
-        url.sendMessageToParentFromDialog = sendMessageToParentFromDialog;
-        /**
-         *  Send message to the dialog from the parent
-         *
-         * @param message - The message to send
-         *
-         * @beta
-         */
-        function sendMessageToDialog(
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        message) {
-            internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.sidePanel, FrameContexts.meetingStage);
-            if (!isSupported()) {
-                throw errorNotSupportedOnPlatform;
+            parentCommunication.sendMessageToParentFromDialog = sendMessageToParentFromDialog;
+            /**
+             *  Send message to the dialog from the parent
+             *
+             * @param message - The message to send
+             *
+             * @beta
+             */
+            function sendMessageToDialog(
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            message) {
+                internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.sidePanel, FrameContexts.meetingStage);
+                if (!isSupported()) {
+                    throw errorNotSupportedOnPlatform;
+                }
+                sendMessageToParentWithVersion(getApiVersionTag(dialogTelemetryVersionNumber, ApiName.Dialog_Url_ParentCommunication_SendMessageToDialog), 'messageForChild', [message]);
             }
-            sendMessageToParentWithVersion(getApiVersionTag(dialogTelemetryVersionNumber, ApiName.Dialog_Url_SendMessageToDialog), 'messageForChild', [message]);
-        }
-        url.sendMessageToDialog = sendMessageToDialog;
-        /**
-         * Register a listener that will be triggered when a message is received from the app that opened the dialog.
-         *
-         * @remarks
-         * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
-         *
-         * @param listener - The listener that will be triggered.
-         *
-         * @beta
-         */
-        function registerOnMessageFromParent(listener) {
-            internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.task);
-            if (!isSupported()) {
-                throw errorNotSupportedOnPlatform;
+            parentCommunication.sendMessageToDialog = sendMessageToDialog;
+            /**
+             * Register a listener that will be triggered when a message is received from the app that opened the dialog.
+             *
+             * @remarks
+             * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
+             *
+             * @param listener - The listener that will be triggered.
+             *
+             * @beta
+             */
+            function registerOnMessageFromParent(listener) {
+                internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.task);
+                if (!isSupported()) {
+                    throw errorNotSupportedOnPlatform;
+                }
+                // We need to remove the original 'messageForChild'
+                // handler since the original does not allow for post messages.
+                // It is replaced by the user specified listener that is passed in.
+                removeHandler('messageForChild');
+                registerHandler('messageForChild', listener);
+                storedMessages.reverse();
+                while (storedMessages.length > 0) {
+                    const message = storedMessages.pop();
+                    listener(message);
+                }
             }
-            // We need to remove the original 'messageForChild'
-            // handler since the original does not allow for post messages.
-            // It is replaced by the user specified listener that is passed in.
-            removeHandler('messageForChild');
-            registerHandler('messageForChild', listener);
-            storedMessages.reverse();
-            while (storedMessages.length > 0) {
-                const message = storedMessages.pop();
-                listener(message);
+            parentCommunication.registerOnMessageFromParent = registerOnMessageFromParent;
+            /**
+             * Checks if dialog.url.parentCommunication capability is supported by the host
+             *
+             * @returns boolean to represent whether dialog.url.parentCommunication capability is supported
+             *
+             * @throws Error if {@linkcode app.initialize} has not successfully completed
+             *
+             * @beta
+             */
+            function isSupported() {
+                var _a, _b;
+                return internalAPIs_ensureInitialized(runtime_runtime) && !!((_b = (_a = runtime_runtime.supports.dialog) === null || _a === void 0 ? void 0 : _a.url) === null || _b === void 0 ? void 0 : _b.parentCommunication);
             }
-        }
-        url.registerOnMessageFromParent = registerOnMessageFromParent;
+            parentCommunication.isSupported = isSupported;
+        })(parentCommunication = url.parentCommunication || (url.parentCommunication = {}));
         /**
          * Checks if dialog.url module is supported by the host
          *
@@ -4310,6 +4357,31 @@ function setCurrentFrameHelper(apiVersionTag, frameInfo) {
     }
     sendMessageToParentWithVersion(apiVersionTag, 'setFrameContext', [frameInfo]);
 }
+function configSetValidityStateHelper(apiVersionTag, validityState) {
+    internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.settings, FrameContexts.remove);
+    if (!pages.config.isSupported()) {
+        throw errorNotSupportedOnPlatform;
+    }
+    sendMessageToParentWithVersion(apiVersionTag, 'settings.setValidityState', [validityState]);
+}
+function getConfigHelper(apiVersionTag) {
+    return new Promise((resolve) => {
+        internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.settings, FrameContexts.remove, FrameContexts.sidePanel);
+        if (!pages.isSupported()) {
+            throw errorNotSupportedOnPlatform;
+        }
+        resolve(sendAndUnwrapWithVersion(apiVersionTag, 'settings.getSettings'));
+    });
+}
+function configSetConfigHelper(apiVersionTag, instanceConfig) {
+    return new Promise((resolve) => {
+        internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.settings, FrameContexts.sidePanel);
+        if (!pages.config.isSupported()) {
+            throw errorNotSupportedOnPlatform;
+        }
+        resolve(sendAndHandleStatusAndReasonWithVersion(apiVersionTag, 'settings.setSettings', instanceConfig));
+    });
+}
 /**
  * Navigation-specific part of the SDK.
  */
@@ -4375,13 +4447,7 @@ var pages;
      * @returns Promise that resolves with the {@link InstanceConfig} object.
      */
     function getConfig() {
-        return new Promise((resolve) => {
-            internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.settings, FrameContexts.remove, FrameContexts.sidePanel);
-            if (!isSupported()) {
-                throw errorNotSupportedOnPlatform;
-            }
-            resolve(sendAndUnwrapWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_GetConfig), 'settings.getSettings'));
-        });
+        return getConfigHelper(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_GetConfig));
     }
     pages.getConfig = getConfig;
     /**
@@ -4533,11 +4599,7 @@ var pages;
          * @param validityState - Indicates whether the save or remove button is enabled for the user.
          */
         function setValidityState(validityState) {
-            internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.settings, FrameContexts.remove);
-            if (!isSupported()) {
-                throw errorNotSupportedOnPlatform;
-            }
-            sendMessageToParentWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_Config_SetValidityState), 'settings.setValidityState', [validityState]);
+            return configSetValidityStateHelper(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_Config_SetValidityState), validityState);
         }
         config.setValidityState = setValidityState;
         /**
@@ -4547,13 +4609,7 @@ var pages;
          * @returns Promise that resolves when the operation has completed.
          */
         function setConfig(instanceConfig) {
-            return new Promise((resolve) => {
-                internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.settings, FrameContexts.sidePanel);
-                if (!isSupported()) {
-                    throw errorNotSupportedOnPlatform;
-                }
-                resolve(sendAndHandleStatusAndReasonWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_Config_SetConfig), 'settings.setSettings', instanceConfig));
-            });
+            return configSetConfigHelper(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_Config_SetConfig), instanceConfig);
         }
         config.setConfig = setConfig;
         /**
@@ -4564,7 +4620,7 @@ var pages;
          * @param handler - The handler to invoke when the user selects the Save button.
          */
         function registerOnSaveHandler(handler) {
-            registerOnSaveHandlerHelper(handler, () => {
+            registerOnSaveHandlerHelper(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_Config_RegisterOnSaveHandler), handler, () => {
                 if (!isNullOrUndefined(handler) && !isSupported()) {
                     throw errorNotSupportedOnPlatform;
                 }
@@ -4578,18 +4634,18 @@ var pages;
          * @internal
          * Limited to Microsoft-internal use
          *
+         * @param apiVersionTag - The API version tag, which is used for telemetry, composed by API version number and source API name.
          * @param handler - The handler to invoke when the user selects the Save button.
          * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
          */
-        function registerOnSaveHandlerHelper(handler, versionSpecificHelper) {
+        function registerOnSaveHandlerHelper(apiVersionTag, handler, versionSpecificHelper) {
             // allow for registration cleanup even when not finished initializing
             !isNullOrUndefined(handler) && internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.settings);
             if (versionSpecificHelper) {
                 versionSpecificHelper();
             }
             saveHandler = handler;
-            !isNullOrUndefined(handler) &&
-                sendMessageToParentWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_Config_RegisterOnSaveHandlerHelper), 'registerHandler', ['save']);
+            !isNullOrUndefined(handler) && sendMessageToParentWithVersion(apiVersionTag, 'registerHandler', ['save']);
         }
         config.registerOnSaveHandlerHelper = registerOnSaveHandlerHelper;
         /**
@@ -4600,7 +4656,7 @@ var pages;
          * @param handler - The handler to invoke when the user selects the Remove button.
          */
         function registerOnRemoveHandler(handler) {
-            registerOnRemoveHandlerHelper(handler, () => {
+            registerOnRemoveHandlerHelper(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_Config_RegisterOnRemoveHandler), handler, () => {
                 if (!isNullOrUndefined(handler) && !isSupported()) {
                     throw errorNotSupportedOnPlatform;
                 }
@@ -4614,18 +4670,18 @@ var pages;
          * @internal
          * Limited to Microsoft-internal use
          *
+         * @param apiVersionTag - The API version tag, which is used for telemetry, composed by API version number and source API name.
          * @param handler - The handler to invoke when the user selects the Remove button.
          * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
          */
-        function registerOnRemoveHandlerHelper(handler, versionSpecificHelper) {
+        function registerOnRemoveHandlerHelper(apiVersionTag, handler, versionSpecificHelper) {
             // allow for registration cleanup even when not finished initializing
             !isNullOrUndefined(handler) && internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.remove, FrameContexts.settings);
             if (versionSpecificHelper) {
                 versionSpecificHelper();
             }
             removeHandler = handler;
-            !isNullOrUndefined(handler) &&
-                sendMessageToParentWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_Config_RegisterOnRemoveHandlerHelper), 'registerHandler', ['remove']);
+            !isNullOrUndefined(handler) && sendMessageToParentWithVersion(apiVersionTag, 'registerHandler', ['remove']);
         }
         config.registerOnRemoveHandlerHelper = registerOnRemoveHandlerHelper;
         function handleSave(result) {
@@ -4664,12 +4720,12 @@ var pages;
             }
             notifySuccess() {
                 this.ensureNotNotified();
-                sendMessageToParentWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Settings_Save_Success), 'settings.save.success');
+                sendMessageToParentWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_SaveEvent_NotifySuccess), 'settings.save.success');
                 this.notified = true;
             }
             notifyFailure(reason) {
                 this.ensureNotNotified();
-                sendMessageToParentWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Settings_Save_Failure), 'settings.save.failure', [reason]);
+                sendMessageToParentWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_SaveEvent_NotifyFailure), 'settings.save.failure', [reason]);
                 this.notified = true;
             }
             ensureNotNotified() {
@@ -4701,12 +4757,12 @@ var pages;
             }
             notifySuccess() {
                 this.ensureNotNotified();
-                sendMessageToParentWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Settings_Remove_Success), 'settings.remove.success');
+                sendMessageToParentWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_RemoveEvent_NotifySuccess), 'settings.remove.success');
                 this.notified = true;
             }
             notifyFailure(reason) {
                 this.ensureNotNotified();
-                sendMessageToParentWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Settings_Remove_Failure), 'settings.remove.failure', [reason]);
+                sendMessageToParentWithVersion(getApiVersionTag(pagesTelemetryVersionNumber, ApiName.Pages_RemoveEvent_NotifyFailure), 'settings.remove.failure', [reason]);
                 this.notified = true;
             }
             ensureNotNotified() {
@@ -4821,6 +4877,8 @@ var pages;
      * Hide from docs
      * ------
      * Provides APIs to interact with the full-trust part of the SDK. Limited to 1P applications
+     * @internal
+     * Limited to Microsoft-internal use
      */
     let fullTrust;
     (function (fullTrust) {
@@ -4829,6 +4887,7 @@ var pages;
          * Hide from docs
          * ------
          * Place the tab into full-screen mode.
+         *
          */
         function enterFullscreen() {
             internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content);
@@ -5261,6 +5320,125 @@ function handlers_registerOnResumeHandler(handler) {
     !isNullOrUndefined(handler) && sendMessageToParent('registerHandler', ['load']);
 }
 
+;// CONCATENATED MODULE: ./src/internal/nestedAppAuth.ts
+
+
+const nestedAppAuthLogger = getLogger('nestedAppAuth');
+const tryPolyfillWithNestedAppAuthBridgeLogger = nestedAppAuthLogger.extend('tryPolyfillWithNestedAppAuthBridge');
+/**
+ * @hidden
+ * Enumeration for nested app authentication message event names.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * @enum {string}
+ *
+ * @property {string} Request - Event name for a nested app authentication request.
+ * @property {string} Response - Event name for a nested app authentication response.
+ */
+var NestedAppAuthMessageEventNames;
+(function (NestedAppAuthMessageEventNames) {
+    NestedAppAuthMessageEventNames["Request"] = "NestedAppAuthRequest";
+    NestedAppAuthMessageEventNames["Response"] = "NestedAppAuthResponse";
+})(NestedAppAuthMessageEventNames || (NestedAppAuthMessageEventNames = {}));
+/**
+ * @hidden
+ * Attempt to polyfill the nestedAppAuthBridge object on the given window
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function tryPolyfillWithNestedAppAuthBridge(clientSupportedSDKVersion, window, handlers) {
+    var _a;
+    const logger = tryPolyfillWithNestedAppAuthBridgeLogger;
+    if (GlobalVars.isFramelessWindow) {
+        logger('Cannot polyfill nestedAppAuthBridge as current window is frameless');
+        return;
+    }
+    if (!window) {
+        logger('Cannot polyfill nestedAppAuthBridge as current window does not exist');
+        return;
+    }
+    const parsedClientSupportedSDKVersion = (() => {
+        try {
+            return JSON.parse(clientSupportedSDKVersion);
+        }
+        catch (e) {
+            return null;
+        }
+    })();
+    if (!parsedClientSupportedSDKVersion || !((_a = parsedClientSupportedSDKVersion.supports) === null || _a === void 0 ? void 0 : _a.nestedAppAuth)) {
+        logger('Cannot polyfill nestedAppAuthBridge as current hub does not support nested app auth');
+        return;
+    }
+    const extendedWindow = window;
+    if (extendedWindow.nestedAppAuthBridge) {
+        logger('nestedAppAuthBridge already exists on current window, skipping polyfill');
+        return;
+    }
+    const nestedAppAuthBridge = createNestedAppAuthBridge(extendedWindow, handlers);
+    if (nestedAppAuthBridge) {
+        extendedWindow.nestedAppAuthBridge = nestedAppAuthBridge;
+    }
+}
+const createNestedAppAuthBridgeLogger = nestedAppAuthLogger.extend('createNestedAppAuthBridge');
+/**
+ * @hidden
+ * Creates a bridge for nested app authentication.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * @param {Window | null} window - The window object where the nested app authentication bridge will be created. If null, the function will log an error message and return null.
+ * @returns {NestedAppAuthBridge | null} Returns an object with methods for adding and removing event listeners, and posting messages. If the provided window is null, returns null.
+ *
+ * @property {Function} addEventListener - Adds an event listener to the window. Only supports the 'message' event. If an unsupported event is passed, logs an error message.
+ * @property {Function} postMessage - Posts a message to the window. The message should be a stringified JSON object with a messageType of 'NestedAppAuthRequest'. If the message does not meet these criteria, logs an error message.
+ * @property {Function} removeEventListener - Removes an event listener from the window.
+ */
+function createNestedAppAuthBridge(window, bridgeHandlers) {
+    const logger = createNestedAppAuthBridgeLogger;
+    if (!window) {
+        logger('nestedAppAuthBridge cannot be created as current window does not exist');
+        return null;
+    }
+    const { onMessage, sendPostMessage } = bridgeHandlers;
+    const nestedAppAuthBridgeHandler = (callback) => (evt) => onMessage(evt, callback);
+    return {
+        addEventListener: (eventName, callback) => {
+            if (eventName === 'message') {
+                window.addEventListener(eventName, nestedAppAuthBridgeHandler(callback));
+            }
+            else {
+                logger(`Event ${eventName} is not supported by nestedAppAuthBridge`);
+            }
+        },
+        postMessage: (message) => {
+            // Validate that it is a valid auth bridge request message
+            const parsedMessage = (() => {
+                try {
+                    return JSON.parse(message);
+                }
+                catch (e) {
+                    return null;
+                }
+            })();
+            if (!parsedMessage ||
+                typeof parsedMessage !== 'object' ||
+                parsedMessage.messageType !== NestedAppAuthMessageEventNames.Request) {
+                logger('Unrecognized data format received by app, message being ignored. Message: %o', message);
+                return;
+            }
+            // Post the message to the top window
+            sendPostMessage(message);
+        },
+        removeEventListener: (eventName, callback) => {
+            window.removeEventListener(eventName, nestedAppAuthBridgeHandler(callback));
+        },
+    };
+}
+
 ;// CONCATENATED MODULE: ./src/internal/communication.ts
 /* eslint-disable @typescript-eslint/ban-types */
 /* eslint-disable @typescript-eslint/no-explicit-any */
@@ -5282,6 +5460,7 @@ var communication_awaiter = (undefined && undefined.__awaiter) || function (this
 
 
 
+
 const communicationLogger = getLogger('communication');
 /**
  * @internal
@@ -5297,6 +5476,7 @@ class CommunicationPrivate {
 }
 CommunicationPrivate.parentMessageQueue = [];
 CommunicationPrivate.childMessageQueue = [];
+CommunicationPrivate.topMessageQueue = [];
 CommunicationPrivate.nextMessageId = 0;
 CommunicationPrivate.callbacks = {};
 CommunicationPrivate.promiseCallbacks = {};
@@ -5314,6 +5494,7 @@ function initializeCommunication(validMessageOrigins, apiVersionTag) {
         Communication.currentWindow.parent !== Communication.currentWindow.self
             ? Communication.currentWindow.parent
             : Communication.currentWindow.opener;
+    Communication.topWindow = Communication.currentWindow.top;
     // Listen to messages from the parent or child frame.
     // Frameless windows will only receive this event from child frames and if validMessageOrigins is passed.
     if (Communication.parentWindow || validMessageOrigins) {
@@ -5338,6 +5519,10 @@ function initializeCommunication(validMessageOrigins, apiVersionTag) {
             version,
             latestRuntimeApiVersion,
         ]).then(([context, clientType, runtimeConfig, clientSupportedSDKVersion]) => {
+            tryPolyfillWithNestedAppAuthBridge(clientSupportedSDKVersion, Communication.currentWindow, {
+                onMessage: processAuthBridgeMessage,
+                sendPostMessage: sendNestedAuthRequestToTopWindow,
+            });
             return { context, clientType, runtimeConfig, clientSupportedSDKVersion };
         });
     }
@@ -5553,19 +5738,29 @@ function sendMessageToParent(actionName, argsOrCallback, callback) {
         CommunicationPrivate.callbacks[request.id] = callback;
     }
 }
-const sendMessageToParentHelperLogger = communicationLogger.extend('sendMessageToParentHelper');
+const sendNestedAuthRequestToTopWindowLogger = communicationLogger.extend('sendNestedAuthRequestToTopWindow');
 /**
  * @internal
  * Limited to Microsoft-internal use
  */
-function sendMessageToParentHelper(apiVersionTag, actionName, args) {
-    const logger = sendMessageToParentHelperLogger;
-    const targetWindow = Communication.parentWindow;
-    const request = createMessageRequest(apiVersionTag, actionName, args);
-    logger('Message %i information: %o', request.id, { actionName, args });
+function sendNestedAuthRequestToTopWindow(message) {
+    const logger = sendNestedAuthRequestToTopWindowLogger;
+    const targetWindow = Communication.topWindow;
+    const request = createNestedAppAuthRequest(message);
+    logger('Message %i information: %o', request.id, { actionName: request.func });
+    return sendRequestToTargetWindowHelper(targetWindow, request);
+}
+const sendRequestToTargetWindowHelperLogger = communicationLogger.extend('sendRequestToTargetWindowHelper');
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function sendRequestToTargetWindowHelper(targetWindow, request) {
+    const logger = sendRequestToTargetWindowHelperLogger;
+    const targetWindowName = getTargetName(targetWindow);
     if (GlobalVars.isFramelessWindow) {
         if (Communication.currentWindow && Communication.currentWindow.nativeInterface) {
-            logger('Sending message %i to parent via framelessPostMessage interface', request.id);
+            logger(`Sending message %i to ${targetWindowName} via framelessPostMessage interface`, request.id);
             Communication.currentWindow.nativeInterface.framelessPostMessage(JSON.stringify(request));
         }
     }
@@ -5574,16 +5769,29 @@ function sendMessageToParentHelper(apiVersionTag, actionName, args) {
         // If the target window isn't closed and we already know its origin, send the message right away; otherwise,
         // queue the message and send it after the origin is established
         if (targetWindow && targetOrigin) {
-            logger('Sending message %i to parent via postMessage', request.id);
+            logger(`Sending message %i to ${targetWindowName} via postMessage`, request.id);
             targetWindow.postMessage(request, targetOrigin);
         }
         else {
-            logger('Adding message %i to parent message queue', request.id);
+            logger(`Adding message %i to ${targetWindowName} message queue`, request.id);
             getTargetMessageQueue(targetWindow).push(request);
         }
     }
     return request;
 }
+const sendMessageToParentHelperLogger = communicationLogger.extend('sendMessageToParentHelper');
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function sendMessageToParentHelper(apiVersionTag, actionName, args) {
+    const logger = sendMessageToParentHelperLogger;
+    const targetWindow = Communication.parentWindow;
+    const request = createMessageRequest(apiVersionTag, actionName, args);
+    /* eslint-disable-next-line strict-null-checks/all */ /* Fix tracked by 5730662 */
+    logger('Message %i information: %o', request.id, { actionName, args });
+    return sendRequestToTargetWindowHelper(targetWindow, request);
+}
 const processMessageLogger = communicationLogger.extend('processMessage');
 /**
  * @internal
@@ -5618,6 +5826,69 @@ function processMessage(evt) {
         });
     });
 }
+const processAuthBridgeMessageLogger = communicationLogger.extend('processAuthBridgeMessage');
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function processAuthBridgeMessage(evt, onMessageReceived) {
+    var _a, _b;
+    const logger = processAuthBridgeMessageLogger;
+    // Process only if we received a valid message
+    if (!evt || !evt.data || typeof evt.data !== 'object') {
+        logger('Unrecognized message format received by app, message being ignored. Message: %o', evt);
+        return;
+    }
+    const { args } = evt.data;
+    const [, message] = args !== null && args !== void 0 ? args : [];
+    const parsedData = (() => {
+        try {
+            return JSON.parse(message);
+        }
+        catch (e) {
+            return null;
+        }
+    })();
+    // Validate that it is a valid auth bridge response message
+    if (!parsedData ||
+        typeof parsedData !== 'object' ||
+        parsedData.messageType !== NestedAppAuthMessageEventNames.Response) {
+        logger('Unrecognized data format received by app, message being ignored. Message: %o', evt);
+        return;
+    }
+    // Process only if the message is coming from a different window and a valid origin
+    // valid origins are either a pre-known origin or one specified by the app developer
+    // in their call to app.initialize
+    const messageSource = evt.source || ((_a = evt === null || evt === void 0 ? void 0 : evt.originalEvent) === null || _a === void 0 ? void 0 : _a.source);
+    const messageOrigin = evt.origin || ((_b = evt === null || evt === void 0 ? void 0 : evt.originalEvent) === null || _b === void 0 ? void 0 : _b.origin);
+    if (!messageSource) {
+        logger('Message being ignored by app because it is coming for a target that is null');
+        return;
+    }
+    if (!shouldProcessMessage(messageSource, messageOrigin)) {
+        logger('Message being ignored by app because it is either coming from the current window or a different window with an invalid origin');
+        return;
+    }
+    /**
+     * In most cases, top level window and the parent window will be same.
+     * If they're not, perform the necessary updates for the top level window.
+     *
+     * Top window logic to flush messages is kept independent so that we don't affect
+     * any of the code for the existing communication channel.
+     */
+    if (!Communication.topWindow || Communication.topWindow.closed || messageSource === Communication.topWindow) {
+        Communication.topWindow = messageSource;
+        Communication.topOrigin = messageOrigin;
+    }
+    // Clean up pointers to closed parent and child windows
+    if (Communication.topWindow && Communication.topWindow.closed) {
+        Communication.topWindow = null;
+        Communication.topOrigin = null;
+    }
+    flushMessageQueue(Communication.topWindow);
+    // Return the response to the registered callback
+    onMessageReceived(message);
+}
 const shouldProcessMessageLogger = communicationLogger.extend('shouldProcessMessage');
 /**
  * @hidden
@@ -5756,27 +6027,70 @@ function handleChildMessage(evt) {
         }
     }
 }
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * Checks if the top window and the parent window are different.
+ *
+ * @returns {boolean} Returns true if the top window and the parent window are different, false otherwise.
+ */
+function areTopAndParentWindowsDistinct() {
+    return Communication.topWindow !== Communication.parentWindow;
+}
 /**
  * @internal
  * Limited to Microsoft-internal use
  */
 function getTargetMessageQueue(targetWindow) {
-    return targetWindow === Communication.parentWindow
-        ? CommunicationPrivate.parentMessageQueue
-        : targetWindow === Communication.childWindow
-            ? CommunicationPrivate.childMessageQueue
-            : [];
+    if (targetWindow === Communication.topWindow && areTopAndParentWindowsDistinct()) {
+        return CommunicationPrivate.topMessageQueue;
+    }
+    else if (targetWindow === Communication.parentWindow) {
+        return CommunicationPrivate.parentMessageQueue;
+    }
+    else if (targetWindow === Communication.childWindow) {
+        return CommunicationPrivate.childMessageQueue;
+    }
+    else {
+        return [];
+    }
 }
 /**
  * @internal
  * Limited to Microsoft-internal use
  */
 function getTargetOrigin(targetWindow) {
-    return targetWindow === Communication.parentWindow
-        ? Communication.parentOrigin
-        : targetWindow === Communication.childWindow
-            ? Communication.childOrigin
-            : null;
+    if (targetWindow === Communication.topWindow && areTopAndParentWindowsDistinct()) {
+        return Communication.topOrigin;
+    }
+    else if (targetWindow === Communication.parentWindow) {
+        return Communication.parentOrigin;
+    }
+    else if (targetWindow === Communication.childWindow) {
+        return Communication.childOrigin;
+    }
+    else {
+        return null;
+    }
+}
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function getTargetName(targetWindow) {
+    if (targetWindow === Communication.topWindow && areTopAndParentWindowsDistinct()) {
+        return 'top';
+    }
+    else if (targetWindow === Communication.parentWindow) {
+        return 'parent';
+    }
+    else if (targetWindow === Communication.childWindow) {
+        return 'child';
+    }
+    else {
+        return null;
+    }
 }
 const flushMessageQueueLogger = communicationLogger.extend('flushMessageQueue');
 /**
@@ -5786,7 +6100,7 @@ const flushMessageQueueLogger = communicationLogger.extend('flushMessageQueue');
 function flushMessageQueue(targetWindow) {
     const targetOrigin = getTargetOrigin(targetWindow);
     const targetMessageQueue = getTargetMessageQueue(targetWindow);
-    const target = targetWindow == Communication.parentWindow ? 'parent' : 'child';
+    const target = getTargetName(targetWindow);
     while (targetWindow && targetOrigin && targetMessageQueue.length > 0) {
         const request = targetMessageQueue.shift();
         /* eslint-disable-next-line strict-null-checks/all */ /* Fix tracked by 5730662 */
@@ -5860,6 +6174,28 @@ function createMessageRequest(apiVersionTag, func, args) {
         apiversiontag: apiVersionTag,
     };
 }
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * Creates a nested app authentication request.
+ *
+ * @param {string} message - The message to be included in the request. This is typically a stringified JSON object containing the details of the authentication request.
+ * The reason for using a string is to allow complex data structures to be sent as a message while avoiding potential issues with object serialization and deserialization.
+ *
+ * @returns {NestedAppAuthRequest} Returns a NestedAppAuthRequest object with a unique id, the function name set to 'nestedAppAuthRequest', the current timestamp, an empty args array, and the provided message as data.
+ */
+function createNestedAppAuthRequest(message) {
+    return {
+        id: CommunicationPrivate.nextMessageId++,
+        func: 'nestedAppAuth.execute',
+        timestamp: Date.now(),
+        // Since this is a nested app auth request, we don't need to send any args.
+        // We avoid overloading the args array with the message to avoid potential issues processing of these messages on the hubSDK.
+        args: [],
+        data: message,
+    };
+}
 /**
  * @internal
  * Limited to Microsoft-internal use
@@ -6007,6 +6343,7 @@ var UserSettingTypes;
 
 
 
+
 /**
  * @hidden
  * Upload a custom App manifest directly to both team and personal scopes.
@@ -6014,10 +6351,13 @@ var UserSettingTypes;
  *
  * @internal
  * Limited to Microsoft-internal use
+ *
+ * v1 APIs telemetry file: All of APIs in this capability file should send out API version v1 ONLY
  */
+const privateAPIsTelemetryVersionNumber = ApiVersionNumber.V_1;
 function uploadCustomApp(manifestBlob, onComplete) {
     internalAPIs_ensureInitialized(runtime_runtime);
-    sendMessageToParent('uploadCustomApp', [manifestBlob], onComplete ? onComplete : getGenericOnCompleteHandler());
+    sendMessageToParentWithVersion(getApiVersionTag(privateAPIsTelemetryVersionNumber, ApiName.PrivateAPIs_UploadCustomApp), 'uploadCustomApp', [manifestBlob], onComplete ? onComplete : getGenericOnCompleteHandler());
 }
 /**
  * @hidden
@@ -6033,7 +6373,7 @@ function uploadCustomApp(manifestBlob, onComplete) {
  */
 function sendCustomMessage(actionName, args, callback) {
     internalAPIs_ensureInitialized(runtime_runtime);
-    sendMessageToParent(actionName, args, callback);
+    sendMessageToParentWithVersion(getApiVersionTag(privateAPIsTelemetryVersionNumber, ApiName.PrivateAPIs_SendCustomMessage), actionName, args, callback);
 }
 /**
  * @hidden
@@ -6067,7 +6407,7 @@ function sendCustomEvent(actionName, args) {
  */
 function registerCustomHandler(actionName, customHandler) {
     internalAPIs_ensureInitialized(runtime_runtime);
-    registerHandler(actionName, (...args) => {
+    registerHandlerWithVersion(getApiVersionTag(privateAPIsTelemetryVersionNumber, ApiName.PrivateAPIs_RegisterCustomHandler), actionName, (...args) => {
         return customHandler.apply(this, args);
     });
 }
@@ -6083,7 +6423,7 @@ function registerCustomHandler(actionName, customHandler) {
  */
 function registerUserSettingsChangeHandler(settingTypes, handler) {
     internalAPIs_ensureInitialized(runtime_runtime);
-    registerHandler('userSettingsChange', handler, true, [settingTypes]);
+    registerHandlerWithVersion(getApiVersionTag(privateAPIsTelemetryVersionNumber, ApiName.PrivateAPIs_RegisterUserSettingsChangeHandler), 'userSettingsChange', handler, true, [settingTypes]);
 }
 /**
  * @hidden
@@ -6113,7 +6453,7 @@ function openFilePreview(filePreviewParameters) {
         filePreviewParameters.conversationId,
         filePreviewParameters.sizeInBytes,
     ];
-    sendMessageToParent('openFilePreview', params);
+    sendMessageToParentWithVersion(getApiVersionTag(privateAPIsTelemetryVersionNumber, ApiName.PrivateAPIs_OpenFilePreview), 'openFilePreview', params);
 }
 
 ;// CONCATENATED MODULE: ./src/private/conversations.ts
@@ -7621,6 +7961,11 @@ class ParentAppWindow {
 
 
 
+
+/**
+ * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
+ */
+const secondaryBrowserTelemetryVersionNumber = ApiVersionNumber.V_2;
 /**
  * Namespace to power up the in-app browser experiences in the host app.
  * For e.g., opening a URL in the host app inside a browser
@@ -7651,7 +7996,7 @@ var secondaryBrowser;
         if (!url || !isValidHttpsURL(url)) {
             throw { errorCode: ErrorCode.INVALID_ARGUMENTS, message: 'Invalid Url: Only https URL is allowed' };
         }
-        return sendAndHandleSdkError('secondaryBrowser.open', url.toString());
+        return sendAndHandleSdkErrorWithVersion(getApiVersionTag(secondaryBrowserTelemetryVersionNumber, ApiName.SecondaryBrowser_OpenUrl), 'secondaryBrowser.open', url.toString());
     }
     secondaryBrowser.open = open;
     /**
@@ -8880,6 +9225,11 @@ function validatePersona(persona) {
 
 
 
+
+/**
+ * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
+ */
+const profileTelemetryVersionNumber = ApiVersionNumber.V_2;
 /**
  * Namespace for profile related APIs.
  *
@@ -8913,7 +9263,7 @@ var profile;
                     height: showProfileRequest.targetElementBoundingRect.height,
                 },
             };
-            resolve(sendAndHandleSdkError('profile.showProfile', requestInternal));
+            resolve(sendAndHandleSdkErrorWithVersion(getApiVersionTag(profileTelemetryVersionNumber, ApiName.Profile_ShowProfile), 'profile.showProfile', requestInternal));
         });
     }
     profile.showProfile = showProfile;
@@ -9414,6 +9764,11 @@ VideoPerformanceStatistics.maxSessionTimeoutInMs = 1000 * 30;
 ;// CONCATENATED MODULE: ./src/internal/videoPerformanceMonitor.ts
 
 
+
+/**
+ * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
+ */
+const videoPerformanceMonitorTelemetryVersionNumber = ApiVersionNumber.V_2;
 /**
  * This class is used to monitor the performance of video processing, and report performance events.
  */
@@ -9425,7 +9780,7 @@ class VideoPerformanceMonitor {
         this.frameProcessingStartedAt = 0;
         this.frameProcessingTimeCost = 0;
         this.processedFrameCount = 0;
-        this.performanceStatistics = new VideoPerformanceStatistics(VideoPerformanceMonitor.distributionBinSize, (result) => this.reportPerformanceEvent('video.performance.performanceDataGenerated', [result]));
+        this.performanceStatistics = new VideoPerformanceStatistics(VideoPerformanceMonitor.distributionBinSize, (result) => this.reportPerformanceEvent(getApiVersionTag(videoPerformanceMonitorTelemetryVersionNumber, ApiName.VideoPerformanceMonitor_Constructor), 'video.performance.performanceDataGenerated', [result]));
     }
     /**
      * Start to check frame processing time intervally
@@ -9438,7 +9793,7 @@ class VideoPerformanceMonitor {
             }
             const averageFrameProcessingTime = this.frameProcessingTimeCost / this.processedFrameCount;
             if (averageFrameProcessingTime > this.frameProcessTimeLimit) {
-                this.reportPerformanceEvent('video.performance.frameProcessingSlow', [averageFrameProcessingTime]);
+                this.reportPerformanceEvent(getApiVersionTag(videoPerformanceMonitorTelemetryVersionNumber, ApiName.VideoPerformanceMonitor_StartMonitorSlowFrameProcessing), 'video.performance.frameProcessingSlow', [averageFrameProcessingTime]);
             }
             this.frameProcessingTimeCost = 0;
             this.processedFrameCount = 0;
@@ -9506,11 +9861,7 @@ class VideoPerformanceMonitor {
         this.performanceStatistics.processEnds();
         if (!this.isFirstFrameProcessed) {
             this.isFirstFrameProcessed = true;
-            this.reportPerformanceEvent('video.performance.firstFrameProcessed', [
-                Date.now(),
-                this.appliedEffect.effectId,
-                (_a = this.appliedEffect) === null || _a === void 0 ? void 0 : _a.effectParam,
-            ]);
+            this.reportPerformanceEvent(getApiVersionTag(videoPerformanceMonitorTelemetryVersionNumber, ApiName.VideoPerformanceMonitor_ReportFrameProcessed), 'video.performance.firstFrameProcessed', [Date.now(), this.appliedEffect.effectId, (_a = this.appliedEffect) === null || _a === void 0 ? void 0 : _a.effectParam]);
         }
     }
     /**
@@ -9526,7 +9877,7 @@ class VideoPerformanceMonitor {
     reportTextureStreamAcquired() {
         if (this.gettingTextureStreamStartedAt !== undefined) {
             const timeTaken = performance.now() - this.gettingTextureStreamStartedAt;
-            this.reportPerformanceEvent('video.performance.textureStreamAcquired', [this.currentStreamId, timeTaken]);
+            this.reportPerformanceEvent(getApiVersionTag(videoPerformanceMonitorTelemetryVersionNumber, ApiName.VideoPerformanceMonitor_ReportTextureStreamAcquired), 'video.performance.textureStreamAcquired', [this.currentStreamId, timeTaken]);
         }
     }
 }
@@ -9562,6 +9913,11 @@ var videoEffects_rest = (undefined && undefined.__rest) || function (s, e) {
 
 
 
+
+/**
+ * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
+ */
+const videoEffectsTelemetryVersionNumber = ApiVersionNumber.V_2;
 /**
  * Namespace to video extensibility of the SDK
  * @beta
@@ -9570,7 +9926,7 @@ var videoEffects;
 (function (videoEffects) {
     const videoPerformanceMonitor = inServerSideRenderingEnvironment()
         ? undefined
-        : new VideoPerformanceMonitor(sendMessageToParent);
+        : new VideoPerformanceMonitor(sendMessageToParentWithVersion);
     /**
      * Video frame format enum, currently only support NV12
      * @beta
@@ -9656,7 +10012,7 @@ var videoEffects;
         if (!parameters.videoFrameHandler || !parameters.videoBufferHandler) {
             throw new Error('Both videoFrameHandler and videoBufferHandler must be provided');
         }
-        registerHandler('video.setFrameProcessTimeLimit', (timeLimitInfo) => videoPerformanceMonitor === null || videoPerformanceMonitor === void 0 ? void 0 : videoPerformanceMonitor.setFrameProcessTimeLimit(timeLimitInfo.timeLimit), false);
+        registerHandlerWithVersion(getApiVersionTag(videoEffectsTelemetryVersionNumber, ApiName.VideoEffects_RegisterSetFrameProcessTimeLimitHandler), 'video.setFrameProcessTimeLimit', (timeLimitInfo) => videoPerformanceMonitor === null || videoPerformanceMonitor === void 0 ? void 0 : videoPerformanceMonitor.setFrameProcessTimeLimit(timeLimitInfo.timeLimit), false);
         if (doesSupportMediaStream()) {
             registerForMediaStream(parameters.videoFrameHandler, parameters.config);
         }
@@ -9683,7 +10039,7 @@ var videoEffects;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        sendMessageToParent('video.videoEffectChanged', [effectChangeType, effectId]);
+        sendMessageToParentWithVersion(getApiVersionTag(videoEffectsTelemetryVersionNumber, ApiName.VideoEffects_NotifySelectedVideoEffectChanged), 'video.videoEffectChanged', [effectChangeType, effectId]);
     }
     videoEffects.notifySelectedVideoEffectChanged = notifySelectedVideoEffectChanged;
     /**
@@ -9696,8 +10052,8 @@ var videoEffects;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        registerHandler('video.effectParameterChange', createEffectParameterChangeCallback(callback, videoPerformanceMonitor), false);
-        sendMessageToParent('video.registerForVideoEffect');
+        registerHandlerWithVersion(getApiVersionTag(videoEffectsTelemetryVersionNumber, ApiName.VideoEffects_RegisterEffectParameterChangeHandler), 'video.effectParameterChange', createEffectParameterChangeCallback(callback, videoPerformanceMonitor), false);
+        sendMessageToParentWithVersion(getApiVersionTag(videoEffectsTelemetryVersionNumber, ApiName.VideoEffects_RegisterForVideoEffect), 'video.registerForVideoEffect');
     }
     videoEffects.registerForVideoEffect = registerForVideoEffect;
     /**
@@ -9706,7 +10062,7 @@ var videoEffects;
      * @beta
      */
     function notifyVideoFrameProcessed(timestamp) {
-        sendMessageToParent('video.videoFrameProcessed', [timestamp]);
+        sendMessageToParentWithVersion(getApiVersionTag(videoEffectsTelemetryVersionNumber, ApiName.VideoEffects_NotifyVideoFrameProcessed), 'video.videoFrameProcessed', [timestamp]);
     }
     /**
      * Sending error notification to host
@@ -9714,7 +10070,7 @@ var videoEffects;
      * @param errorMessage - The error message that will be sent to the host
      */
     function notifyError(errorMessage) {
-        sendMessageToParent('video.notifyError', [errorMessage]);
+        sendMessageToParentWithVersion(getApiVersionTag(videoEffectsTelemetryVersionNumber, ApiName.VideoEffects_NotifyError), 'video.notifyError', [errorMessage]);
     }
     /**
      * Checks if video capability is supported by the host.
@@ -9736,13 +10092,13 @@ var videoEffects;
         if (!isSupported() || !doesSupportMediaStream()) {
             throw errorNotSupportedOnPlatform;
         }
-        registerHandler('video.startVideoExtensibilityVideoStream', (mediaStreamInfo) => videoEffects_awaiter(this, void 0, void 0, function* () {
+        registerHandlerWithVersion(getApiVersionTag(videoEffectsTelemetryVersionNumber, ApiName.VideoEffects_RegisterStartVideoExtensibilityVideoStreamHandler), 'video.startVideoExtensibilityVideoStream', (mediaStreamInfo) => videoEffects_awaiter(this, void 0, void 0, function* () {
             // when a new streamId is ready:
             const { streamId } = mediaStreamInfo;
             const monitoredVideoFrameHandler = createMonitoredVideoFrameHandler(videoFrameHandler, videoPerformanceMonitor);
             yield processMediaStream(streamId, monitoredVideoFrameHandler, notifyError, videoPerformanceMonitor);
         }), false);
-        sendMessageToParent('video.mediaStream.registerForVideoFrame', [config]);
+        sendMessageToParentWithVersion(getApiVersionTag(videoEffectsTelemetryVersionNumber, ApiName.VideoEffects_MediaStream_RegisterForVideoFrame), 'video.mediaStream.registerForVideoFrame', [config]);
     }
     function createMonitoredVideoFrameHandler(videoFrameHandler, videoPerformanceMonitor) {
         return (videoFrameData) => videoEffects_awaiter(this, void 0, void 0, function* () {
@@ -9759,7 +10115,7 @@ var videoEffects;
         if (!isSupported() || !doesSupportSharedFrame()) {
             throw errorNotSupportedOnPlatform;
         }
-        registerHandler('video.newVideoFrame', 
+        registerHandlerWithVersion(getApiVersionTag(videoEffectsTelemetryVersionNumber, ApiName.VideoEffects_RegisterForVideoBufferHandler), 'video.newVideoFrame', 
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         (videoBufferData) => {
             if (videoBufferData) {
@@ -9771,7 +10127,7 @@ var videoEffects;
                 }, notifyError);
             }
         }, false);
-        sendMessageToParent('video.registerForVideoFrame', [config]);
+        sendMessageToParentWithVersion(getApiVersionTag(videoEffectsTelemetryVersionNumber, ApiName.VideoEffects_RegisterForVideoFrame), 'video.registerForVideoFrame', [config]);
     }
     function normalizeVideoBufferData(videoBufferData) {
         if ('videoFrameBuffer' in videoBufferData) {
@@ -9805,6 +10161,11 @@ var videoEffects;
 
 
 
+
+/**
+ * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
+ */
+const searchTelemetryVersionNumber = ApiVersionNumber.V_2;
 /**
  * Allows your application to interact with the host M365 application's search box.
  * By integrating your application with the host's search box, users can search
@@ -9864,10 +10225,10 @@ var search;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        registerHandler(onClosedHandlerName, onClosedHandler);
-        registerHandler(onExecutedHandlerName, onExecuteHandler);
+        registerHandlerWithVersion(getApiVersionTag(searchTelemetryVersionNumber, ApiName.Search_RegisterOnClosedHandler), onClosedHandlerName, onClosedHandler);
+        registerHandlerWithVersion(getApiVersionTag(searchTelemetryVersionNumber, ApiName.Search_RegisterOnExecutedHandler), onExecutedHandlerName, onExecuteHandler);
         if (onChangeHandler) {
-            registerHandler(onChangeHandlerName, onChangeHandler);
+            registerHandlerWithVersion(getApiVersionTag(searchTelemetryVersionNumber, ApiName.Search_RegisterOnChangeHandler), onChangeHandlerName, onChangeHandler);
         }
     }
     search.registerHandlers = registerHandlers;
@@ -9884,7 +10245,7 @@ var search;
         }
         // This should let the host know to stop making the app scope show up in the search experience
         // Can also be used to clean up handlers on the host if desired
-        sendMessageToParent('search.unregister');
+        sendMessageToParentWithVersion(getApiVersionTag(searchTelemetryVersionNumber, ApiName.Search_UnregisterHandlers), 'search.unregister');
         removeHandler(onChangeHandlerName);
         removeHandler(onClosedHandlerName);
         removeHandler(onExecutedHandlerName);
@@ -9913,7 +10274,7 @@ var search;
             if (!isSupported()) {
                 throw new Error('Not supported');
             }
-            resolve(sendAndHandleStatusAndReason('search.closeSearch'));
+            resolve(sendAndHandleStatusAndReasonWithVersion(getApiVersionTag(searchTelemetryVersionNumber, ApiName.Search_CloseSearch), 'search.closeSearch'));
         });
     }
     search.closeSearch = closeSearch;
@@ -9926,6 +10287,10 @@ var search;
 
 
 
+
+/* eslint-disable @typescript-eslint/no-unused-vars */
+const sharingTelemetryVersionNumber_v1 = ApiVersionNumber.V_1;
+const sharingTelemetryVersionNumber_v2 = ApiVersionNumber.V_2;
 /**
  * Namespace to open a share dialog for web content.
  * For more info, see [Share to Teams from personal app or tab](https://learn.microsoft.com/microsoftteams/platform/concepts/build-and-test/share-to-teams-from-personal-app-or-tab)
@@ -9941,6 +10306,7 @@ var sharing;
         shareWebContent: 'sharing.shareWebContent',
     };
     function shareWebContent(shareWebContentRequest, callback) {
+        const apiVersionTag = '';
         // validate the given input (synchronous check)
         try {
             validateNonEmptyContent(shareWebContentRequest);
@@ -10029,6 +10395,11 @@ var sharing;
 
 
 
+
+/**
+ * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
+ */
+const stageViewTelemetryVersionNumber = ApiVersionNumber.V_2;
 /**
  * Namespace to interact with the stage view specific part of the SDK.
  *
@@ -10072,7 +10443,7 @@ var stageView;
             if (!stageViewParams) {
                 throw new Error('[stageView.open] Stage view params cannot be null');
             }
-            resolve(sendAndHandleSdkError('stageView.open', stageViewParams));
+            resolve(sendAndHandleSdkErrorWithVersion(getApiVersionTag(stageViewTelemetryVersionNumber, ApiName.StageView_Open), 'stageView.open', stageViewParams));
         });
     }
     stageView.open = open;
@@ -10105,6 +10476,11 @@ var visualMedia_awaiter = (undefined && undefined.__awaiter) || function (thisAr
 
 
 
+
+/**
+ * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
+ */
+const visualMediaTelemetryVersionNumber = ApiVersionNumber.V_2;
 /**
  * @hidden
  * Interact with images. Allows the app developer ask the user to get images from their camera / camera roll / file system.
@@ -10158,7 +10534,7 @@ var visualMedia;
             throw errorNotSupportedOnPlatform;
         }
         const permissions = DevicePermission.Media;
-        return sendAndHandleSdkError('permissions.has', permissions);
+        return sendAndHandleSdkErrorWithVersion(getApiVersionTag(visualMediaTelemetryVersionNumber, ApiName.VisualMedia_HasPermission), 'permissions.has', permissions);
     }
     visualMedia.hasPermission = hasPermission;
     /**
@@ -10176,7 +10552,7 @@ var visualMedia;
             throw errorNotSupportedOnPlatform;
         }
         const permissions = DevicePermission.Media;
-        return sendAndHandleSdkError('permissions.request', permissions);
+        return sendAndHandleSdkErrorWithVersion(getApiVersionTag(visualMediaTelemetryVersionNumber, ApiName.VisualMedia_RequestPermission), 'permissions.request', permissions);
     }
     visualMedia.requestPermission = requestPermission;
     /**
@@ -10201,7 +10577,7 @@ var visualMedia;
                 internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.task);
                 ensureSupported();
                 ensureImageInputValid(cameraImageInputs);
-                const files = yield sendAndHandleSdkError('visualMedia.image.captureImages', cameraImageInputs);
+                const files = yield sendAndHandleSdkErrorWithVersion(getApiVersionTag(visualMediaTelemetryVersionNumber, ApiName.VisualMedia_Image_CaptureImages), 'visualMedia.image.captureImages', cameraImageInputs);
                 ensureResponseValid(cameraImageInputs.maxVisualMediaCount, files);
                 return files;
             });
@@ -10221,7 +10597,7 @@ var visualMedia;
                 internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.task);
                 ensureSupported();
                 ensureImageInputValid(galleryImageInputs);
-                const files = yield sendAndHandleSdkError('visualMedia.image.retrieveImages', galleryImageInputs);
+                const files = yield sendAndHandleSdkErrorWithVersion(getApiVersionTag(visualMediaTelemetryVersionNumber, ApiName.VisualMedia_Image_RetrieveImages), 'visualMedia.image.retrieveImages', galleryImageInputs);
                 ensureResponseValid(galleryImageInputs.maxVisualMediaCount, files);
                 return files;
             });
@@ -10996,6 +11372,11 @@ function navigateBack(onComplete) {
 
 
 
+
+/**
+ * v1 APIs telemetry file: All of APIs in this capability file should send out API version v1 ONLY
+ */
+const settingsTelemetryVersionNumber = ApiVersionNumber.V_1;
 /**
  * @deprecated
  * As of 2.0.0, please use {@link pages.config} namespace instead.
@@ -11015,7 +11396,7 @@ var settings;
      * @param validityState - Indicates whether the save or remove button is enabled for the user.
      */
     function setValidityState(validityState) {
-        pages.config.setValidityState(validityState);
+        configSetValidityStateHelper(getApiVersionTag(settingsTelemetryVersionNumber, ApiName.Settings_SetValidityState), validityState);
     }
     settings.setValidityState = setValidityState;
     /**
@@ -11028,7 +11409,7 @@ var settings;
      */
     function getSettings(callback) {
         internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.settings, FrameContexts.remove, FrameContexts.sidePanel);
-        pages.getConfig().then((config) => {
+        getConfigHelper(getApiVersionTag(settingsTelemetryVersionNumber, ApiName.Settings_GetSettings)).then((config) => {
             callback(config);
         });
     }
@@ -11045,8 +11426,7 @@ var settings;
     function setSettings(instanceSettings, onComplete) {
         internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.content, FrameContexts.settings, FrameContexts.sidePanel);
         const completionHandler = onComplete !== null && onComplete !== void 0 ? onComplete : getGenericOnCompleteHandler();
-        pages.config
-            .setConfig(instanceSettings)
+        configSetConfigHelper(getApiVersionTag(settingsTelemetryVersionNumber, ApiName.Settings_SetSettings), instanceSettings)
             .then(() => {
             completionHandler(true);
         })
@@ -11067,7 +11447,7 @@ var settings;
      * @param handler - The handler to invoke when the user selects the save button.
      */
     function registerOnSaveHandler(handler) {
-        pages.config.registerOnSaveHandlerHelper(handler);
+        pages.config.registerOnSaveHandlerHelper(getApiVersionTag(settingsTelemetryVersionNumber, ApiName.Settings_RegisterOnSaveHandler), handler);
     }
     settings.registerOnSaveHandler = registerOnSaveHandler;
     /**
@@ -11082,7 +11462,7 @@ var settings;
      * @param handler - The handler to invoke when the user selects the remove button.
      */
     function registerOnRemoveHandler(handler) {
-        pages.config.registerOnRemoveHandlerHelper(handler);
+        pages.config.registerOnRemoveHandlerHelper(getApiVersionTag(settingsTelemetryVersionNumber, ApiName.Settings_RegisterOnRemoveHandler), handler);
     }
     settings.registerOnRemoveHandler = registerOnRemoveHandler;
 })(settings || (settings = {}));
@@ -12329,7 +12709,9 @@ var files;
      * @hidden
      * Hide from docs
      *
-     * Gets a list of cloud storage folders added to the channel
+     * Gets a list of cloud storage folders added to the channel. This function will not timeout;
+     * the callback will only return when the host responds with a list of folders or error.
+     *
      * @param channelId - ID of the channel whose cloud storage folders should be retrieved
      * @param callback - Callback that will be triggered post folders load
      *
@@ -12947,12 +13329,16 @@ var notifications;
 
 
 
+
 /**
  * @hidden
  *
  * @internal
  * Limited to Microsoft-internal use
+ *
+ * v1 APIs telemetry file: All of APIs in this capability file should send out API version v1 ONLY
  */
+const remoteCameraTelemetryVersionNumber = ApiVersionNumber.V_1;
 var remoteCamera;
 (function (remoteCamera) {
     /**
@@ -13031,7 +13417,7 @@ var remoteCamera;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        sendMessageToParent('remoteCamera.getCapableParticipants', callback);
+        sendMessageToParentWithVersion(getApiVersionTag(remoteCameraTelemetryVersionNumber, ApiName.RemoteCamera_GetCapableParticipants), 'remoteCamera.getCapableParticipants', callback);
     }
     remoteCamera.getCapableParticipants = getCapableParticipants;
     /**
@@ -13058,7 +13444,7 @@ var remoteCamera;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        sendMessageToParent('remoteCamera.requestControl', [participant], callback);
+        sendMessageToParentWithVersion(getApiVersionTag(remoteCameraTelemetryVersionNumber, ApiName.RemoteCamera_RequestControl), 'remoteCamera.requestControl', [participant], callback);
     }
     remoteCamera.requestControl = requestControl;
     /**
@@ -13082,7 +13468,7 @@ var remoteCamera;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        sendMessageToParent('remoteCamera.sendControlCommand', [ControlCommand], callback);
+        sendMessageToParentWithVersion(getApiVersionTag(remoteCameraTelemetryVersionNumber, ApiName.RemoteCamera_SendControlCommand), 'remoteCamera.sendControlCommand', [ControlCommand], callback);
     }
     remoteCamera.sendControlCommand = sendControlCommand;
     /**
@@ -13102,7 +13488,7 @@ var remoteCamera;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        sendMessageToParent('remoteCamera.terminateSession', callback);
+        sendMessageToParentWithVersion(getApiVersionTag(remoteCameraTelemetryVersionNumber, ApiName.RemoteCamera_TerminateSession), 'remoteCamera.terminateSession', callback);
     }
     remoteCamera.terminateSession = terminateSession;
     /**
@@ -13123,7 +13509,7 @@ var remoteCamera;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        registerHandler('remoteCamera.capableParticipantsChange', handler);
+        registerHandlerWithVersion(getApiVersionTag(remoteCameraTelemetryVersionNumber, ApiName.RemoteCamera_RegisterOnCapableParticipantsChangeHandler), 'remoteCamera.capableParticipantsChange', handler);
     }
     remoteCamera.registerOnCapableParticipantsChangeHandler = registerOnCapableParticipantsChangeHandler;
     /**
@@ -13144,7 +13530,7 @@ var remoteCamera;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        registerHandler('remoteCamera.handlerError', handler);
+        registerHandlerWithVersion(getApiVersionTag(remoteCameraTelemetryVersionNumber, ApiName.RemoteCamera_RegisterOnErrorHandler), 'remoteCamera.handlerError', handler);
     }
     remoteCamera.registerOnErrorHandler = registerOnErrorHandler;
     /**
@@ -13165,7 +13551,7 @@ var remoteCamera;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        registerHandler('remoteCamera.deviceStateChange', handler);
+        registerHandlerWithVersion(getApiVersionTag(remoteCameraTelemetryVersionNumber, ApiName.RemoteCamera_RegisterOnDeviceStateChangeHandler), 'remoteCamera.deviceStateChange', handler);
     }
     remoteCamera.registerOnDeviceStateChangeHandler = registerOnDeviceStateChangeHandler;
     /**
@@ -13186,7 +13572,7 @@ var remoteCamera;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        registerHandler('remoteCamera.sessionStatusChange', handler);
+        registerHandlerWithVersion(getApiVersionTag(remoteCameraTelemetryVersionNumber, ApiName.RemoteCamera_RegisterOnSessionStatusChangeHandler), 'remoteCamera.sessionStatusChange', handler);
     }
     remoteCamera.registerOnSessionStatusChangeHandler = registerOnSessionStatusChangeHandler;
     /**
@@ -13281,13 +13667,17 @@ var appEntity;
 
 
 
+
 /**
  * @hidden
  * Namespace to interact with the `teams` specific part of the SDK.
  *
  * @internal
  * Limited to Microsoft-internal use
+ *
+ * v1 APIs telemetry file: All of APIs in this capability file should send out API version v1 ONLY
  */
+const teamsTelemetryVersionNumber = ApiVersionNumber.V_1;
 var teams;
 (function (teams) {
     let ChannelType;
@@ -13316,7 +13706,7 @@ var teams;
         if (!callback) {
             throw new Error('[teams.getTeamChannels] Callback cannot be null');
         }
-        sendMessageToParent('teams.getTeamChannels', [groupId], callback);
+        sendMessageToParentWithVersion(getApiVersionTag(teamsTelemetryVersionNumber, ApiName.Teams_GetTeamChannels), 'teams.getTeamChannels', [groupId], callback);
     }
     teams.getTeamChannels = getTeamChannels;
     /**
@@ -13341,7 +13731,7 @@ var teams;
         if (!callback) {
             throw new Error('[teams.refreshSiteUrl] Callback cannot be null');
         }
-        sendMessageToParent('teams.refreshSiteUrl', [threadId], callback);
+        sendMessageToParentWithVersion(getApiVersionTag(teamsTelemetryVersionNumber, ApiName.Teams_RefreshSiteUrl), 'teams.refreshSiteUrl', [threadId], callback);
     }
     teams.refreshSiteUrl = refreshSiteUrl;
     /**
@@ -13398,7 +13788,9 @@ var teams;
                         throw new Error(JSON.stringify(oldPlatformError));
                     }
                     /* eslint-disable-next-line strict-null-checks/all */ /* Fix tracked by 5730662 */
-                    resolve(sendAndUnwrap('getUserJoinedTeams', teamInstanceParameters));
+                    resolve(sendAndUnwrapWithVersion(getApiVersionTag(teamsTelemetryVersionNumber, ApiName.Teams_FullTrust_JoinedTeams_GetUserJoinedTeams), 'getUserJoinedTeams', 
+                    /* eslint-disable-next-line strict-null-checks/all */ /* Fix tracked by 5730662 */
+                    teamInstanceParameters));
                 });
             }
             joinedTeams.getUserJoinedTeams = getUserJoinedTeams;
@@ -13440,7 +13832,7 @@ var teams;
                 if (!isSupported()) {
                     throw errorNotSupportedOnPlatform;
                 }
-                resolve(sendAndUnwrap('getConfigSetting', key));
+                resolve(sendAndUnwrapWithVersion(getApiVersionTag(teamsTelemetryVersionNumber, ApiName.Teams_FullTrust_GetConfigSetting), 'getConfigSetting', key));
             });
         }
         fullTrust.getConfigSetting = getConfigSetting;
@@ -13485,6 +13877,7 @@ var videoEffectsEx_awaiter = (undefined && undefined.__awaiter) || function (thi
 
 
 
+
 /**
  * @hidden
  * Extended video API
@@ -13492,13 +13885,15 @@ var videoEffectsEx_awaiter = (undefined && undefined.__awaiter) || function (thi
  *
  * @internal
  * Limited to Microsoft-internal use
+ * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
  */
+const videoEffectsExTelemetryVersionNumber = ApiVersionNumber.V_2;
 var videoEffectsEx;
 (function (videoEffectsEx) {
     videoEffectsEx.frameProcessingTimeoutInMs = 2000;
     const videoPerformanceMonitor = inServerSideRenderingEnvironment()
         ? undefined
-        : new VideoPerformanceMonitor(sendMessageToParent);
+        : new VideoPerformanceMonitor(sendMessageToParentWithVersion);
     /**
      * @hidden
      * Error level when notifying errors to the host, the host will decide what to do acording to the error level.
@@ -13533,9 +13928,9 @@ var videoEffectsEx;
             throw new Error('Both videoFrameHandler and videoBufferHandler must be provided');
         }
         if (internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.sidePanel)) {
-            registerHandler('video.setFrameProcessTimeLimit', (timeLimit) => videoPerformanceMonitor === null || videoPerformanceMonitor === void 0 ? void 0 : videoPerformanceMonitor.setFrameProcessTimeLimit(timeLimit), false);
+            registerHandlerWithVersion(getApiVersionTag(videoEffectsExTelemetryVersionNumber, ApiName.VideoEffectsEx_RegisterSetFrameProcessTimeLimitHandler), 'video.setFrameProcessTimeLimit', (timeLimit) => videoPerformanceMonitor === null || videoPerformanceMonitor === void 0 ? void 0 : videoPerformanceMonitor.setFrameProcessTimeLimit(timeLimit), false);
             if ((_a = runtime_runtime.supports.video) === null || _a === void 0 ? void 0 : _a.mediaStream) {
-                registerHandler('video.startVideoExtensibilityVideoStream', (mediaStreamInfo) => videoEffectsEx_awaiter(this, void 0, void 0, function* () {
+                registerHandlerWithVersion(getApiVersionTag(videoEffectsExTelemetryVersionNumber, ApiName.VideoEffectsEx_RegisterStartVideoExtensibilityVideoStreamHandler), 'video.startVideoExtensibilityVideoStream', (mediaStreamInfo) => videoEffectsEx_awaiter(this, void 0, void 0, function* () {
                     const { streamId, metadataInTexture } = mediaStreamInfo;
                     const handler = videoPerformanceMonitor
                         ? createMonitoredVideoFrameHandler(parameters.videoFrameHandler, videoPerformanceMonitor)
@@ -13544,10 +13939,10 @@ var videoEffectsEx;
                         ? yield processMediaStreamWithMetadata(streamId, handler, notifyError, videoPerformanceMonitor)
                         : yield processMediaStream(streamId, handler, notifyError, videoPerformanceMonitor);
                 }), false);
-                sendMessageToParent('video.mediaStream.registerForVideoFrame', [parameters.config]);
+                sendMessageToParentWithVersion(getApiVersionTag(videoEffectsExTelemetryVersionNumber, ApiName.VideoEffectsEx_MediaStream_RegisterForVideoFrame), 'video.mediaStream.registerForVideoFrame', [parameters.config]);
             }
             else if ((_b = runtime_runtime.supports.video) === null || _b === void 0 ? void 0 : _b.sharedFrame) {
-                registerHandler('video.newVideoFrame', (videoBufferData) => {
+                registerHandlerWithVersion(getApiVersionTag(videoEffectsExTelemetryVersionNumber, ApiName.VideoEffectsEx_RegisterNewVideoFrameHandler), 'video.newVideoFrame', (videoBufferData) => {
                     if (videoBufferData) {
                         videoPerformanceMonitor === null || videoPerformanceMonitor === void 0 ? void 0 : videoPerformanceMonitor.reportStartFrameProcessing(videoBufferData.width, videoBufferData.height);
                         const clearProcessingTimeout = createFrameProcessingTimeout();
@@ -13559,7 +13954,7 @@ var videoEffectsEx;
                         }, notifyError);
                     }
                 }, false);
-                sendMessageToParent('video.registerForVideoFrame', [parameters.config]);
+                sendMessageToParentWithVersion(getApiVersionTag(videoEffectsExTelemetryVersionNumber, ApiName.VideoEffectsEx_RegisterForVideoFrame), 'video.registerForVideoFrame', [parameters.config]);
             }
             else {
                 // should not happen if isSupported() is true
@@ -13612,7 +14007,7 @@ var videoEffectsEx;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        sendMessageToParent('video.videoEffectChanged', [effectChangeType, effectId, effectParam]);
+        sendMessageToParentWithVersion(getApiVersionTag(videoEffectsExTelemetryVersionNumber, ApiName.VideoEffectsEx_NotifySelectedVideoEffectChanged), 'video.videoEffectChanged', [effectChangeType, effectId, effectParam]);
     }
     videoEffectsEx.notifySelectedVideoEffectChanged = notifySelectedVideoEffectChanged;
     /**
@@ -13629,8 +14024,8 @@ var videoEffectsEx;
         if (!isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        registerHandler('video.effectParameterChange', createEffectParameterChangeCallback(callback, videoPerformanceMonitor), false);
-        sendMessageToParent('video.registerForVideoEffect');
+        registerHandlerWithVersion(getApiVersionTag(videoEffectsExTelemetryVersionNumber, ApiName.VideoEffectsEx_RegisterEffectParameterChangeHandler), 'video.effectParameterChange', createEffectParameterChangeCallback(callback, videoPerformanceMonitor), false);
+        sendMessageToParentWithVersion(getApiVersionTag(videoEffectsExTelemetryVersionNumber, ApiName.VideoEffectsEx_RegisterForVideoEffect), 'video.registerForVideoEffect');
     }
     videoEffectsEx.registerForVideoEffect = registerForVideoEffect;
     /**
@@ -13646,7 +14041,7 @@ var videoEffectsEx;
         if (!videoEffects.isSupported()) {
             throw errorNotSupportedOnPlatform;
         }
-        sendMessageToParent('video.personalizedEffectsChanged', [effects]);
+        sendMessageToParentWithVersion(getApiVersionTag(videoEffectsExTelemetryVersionNumber, ApiName.VideoEffectsEx_UpdatePersonalizedEffects), 'video.personalizedEffectsChanged', [effects]);
     }
     videoEffectsEx.updatePersonalizedEffects = updatePersonalizedEffects;
     /**
@@ -13677,7 +14072,7 @@ var videoEffectsEx;
      * Limited to Microsoft-internal use
      */
     function notifyVideoFrameProcessed(timestamp) {
-        sendMessageToParent('video.videoFrameProcessed', [timestamp]);
+        sendMessageToParentWithVersion(getApiVersionTag(videoEffectsExTelemetryVersionNumber, ApiName.VideoEffectsEx_NotifyVideoFrameProcessed), 'video.videoFrameProcessed', [timestamp]);
     }
     /**
      * @hidden
@@ -13690,7 +14085,7 @@ var videoEffectsEx;
      * Limited to Microsoft-internal use
      */
     function notifyError(errorMessage, errorLevel = ErrorLevel.Warn) {
-        sendMessageToParent('video.notifyError', [errorMessage, errorLevel]);
+        sendMessageToParentWithVersion(getApiVersionTag(videoEffectsExTelemetryVersionNumber, ApiName.VideoEffectsEx_NotifyError), 'video.notifyError', [errorMessage, errorLevel]);
     }
     /**
      * @hidden