@microsoft/teams-js 2.20.0-beta.2 → 2.20.0-beta.4

package/README.md

@@ -24,7 +24,7 @@ To install the stable [version](https://learn.microsoft.com/javascript/api/overv
 
 ### Production
 
-You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.19.0/js/MicrosoftTeams.min.js) or point your package manager at them.
+You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.20.0/js/MicrosoftTeams.min.js) or point your package manager at them.
 
 ## Usage
 
@@ -45,13 +45,13 @@ Reference the library inside of your `.html` page using:
 ```html
 <!-- Microsoft Teams JavaScript API (via CDN) -->
 <script
-  src="https://res.cdn.office.net/teams-js/2.19.0/js/MicrosoftTeams.min.js"
-  integrity="sha384-h+MoYshcGDPMLlXjHLt2dSgsgYyWQ+yHd4Ob13htDsu8trGPea8Vooa8+tLtRzU7"
+  src="https://res.cdn.office.net/teams-js/2.20.0/js/MicrosoftTeams.min.js"
+  integrity="sha384-wBC2cOp5ArjIyhxoK1NtXvJb98SbNojaoD6hXpvxWil+g4O1M2rXNtywEcAoQ8bl"
   crossorigin="anonymous"
 ></script>
 
 <!-- Microsoft Teams JavaScript API (via npm) -->
-<script src="node_modules/@microsoft/teams-js@2.19.0/dist/MicrosoftTeams.min.js"></script>
+<script src="node_modules/@microsoft/teams-js@2.20.0/dist/MicrosoftTeams.min.js"></script>
 
 <!-- Microsoft Teams JavaScript API (via local) -->
 <script src="MicrosoftTeams.min.js"></script>

package/dist/MicrosoftTeams.d.ts

@@ -1829,6 +1829,57 @@ export namespace meetingRoom {
         export {};
 }
 
+/**
+    * @hidden
+    * Namespace to request message ports from the host application.
+    *
+    * @beta
+    *
+    * @internal
+    * Limited to Microsoft-internal use
+    */
+export namespace messageChannels {
+        /**
+            * @hidden
+            * @beta
+            *
+            * Fetches a MessagePort to batch telemetry through the host's telemetry worker.
+            * The port is cached once received, so subsequent calls return the same port.
+            * @returns MessagePort.
+            *
+            * @throws Error if {@linkcode app.initialize} has not successfully completed,
+            * if the host does not support the feature, or if the port request is rejected.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function getTelemetryPort(): Promise<MessagePort>;
+        /**
+            * @hidden
+            *
+            * @beta
+            *
+            * Checks if the messageChannels capability is supported by the host
+            * @returns boolean to represent whether the messageChannels capability is supported
+            *
+            * @throws Error if {@linkcode app.initialize} has not successfully completed
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function isSupported(): boolean;
+        /**
+            * @hidden
+            * Undocumented function used to clear state between unit tests
+            *
+            * @beta
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function _clearTelemetryPort(): void;
+}
+
 export namespace notifications {
         /**
             * @hidden
@@ -4128,6 +4179,10 @@ export interface ClipboardParams {
 }
 
 export function appInitializeHelper(apiVersionTag: string, validMessageOrigins?: string[]): Promise<void>;
+export function notifyAppLoadedHelper(apiVersionTag: string): void;
+export function notifyExpectedFailureHelper(apiVersionTag: string, expectedFailureRequest: app.IExpectedFailureRequest): void;
+export function notifyFailureHelper(apiVersiontag: string, appInitializationFailedRequest: app.IFailedRequest): void;
+export function notifySuccessHelper(apiVersionTag: string): void;
 export function registerOnThemeChangeHandlerHelper(apiVersionTag: string, handler: app.themeHandler): void;
 export function openLinkHelper(apiVersionTag: string, deepLink: string): Promise<void>;
 /**
@@ -4224,7 +4279,7 @@ export namespace app {
                     */
                 locale: string;
                 /**
-                    * The current UI theme of the host. Possible values: "default", "dark", or "contrast".
+                    * The current UI theme of the host. Possible values: "default", "dark", "contrast" or "glass".
                     */
                 theme: string;
                 /**
@@ -8546,10 +8601,6 @@ export namespace call {
         function isSupported(): boolean;
 }
 
-/**
-    * @deprecated
-    * As of 2.0.0, please use {@link app} namespace instead.
-    */
 export namespace appInitialization {
         /**
             * @deprecated

package/dist/MicrosoftTeams.js

@@ -883,6 +883,7 @@ __webpack_require__.d(__webpack_exports__, {
   meeting: () => (/* reexport */ meeting),
   meetingRoom: () => (/* reexport */ meetingRoom),
   menus: () => (/* reexport */ menus),
+  messageChannels: () => (/* reexport */ messageChannels),
   monetization: () => (/* reexport */ monetization),
   navigateBack: () => (/* reexport */ navigateBack),
   navigateCrossDomain: () => (/* reexport */ navigateCrossDomain),
@@ -990,7 +991,16 @@ var ApiName;
     ApiName["App_NotifySuccess"] = "app.notifySuccess";
     ApiName["App_OpenLink"] = "app.openLink";
     ApiName["App_RegisterOnThemeChangeHandler"] = "app.registerOnThemeChangeHandler";
+    ApiName["AppInitialization_NotifyAppLoaded"] = "appInitialization.notifyAppLoaded";
+    ApiName["AppInitialization_NotifyExpectedFailure"] = "appInitialization.notifyExpectedFailure";
+    ApiName["AppInitialization_NotifyFailure"] = "appInitialization.notifyFailure";
+    ApiName["AppInitialization_NotifySuccess"] = "appInitialization.notifySuccess";
     ApiName["AppEntity_SelectAppEntity"] = "appEntity.selectAppEntity";
+    ApiName["AppInstallDialog_OpenAppInstallDialog"] = "appInstallDialog.openAppInstallDialog";
+    ApiName["AppWindow_ChildAppWindow_AddEventListener"] = "appWindow.childAppWindow.addEventListener";
+    ApiName["AppWindow_ChildAppWindow_PostMessage"] = "appWindow.childAppWindow.postMessage";
+    ApiName["AppWindow_ParentAppWindow_AddEventListener"] = "appWindow.parentAppWindow.addEventListener";
+    ApiName["AppWindow_ParentAppWindow_PostMessage"] = "appWindow.parentAppWindow.postMessage";
     ApiName["BarCode_HasPermission"] = "barCode.hasPermission";
     ApiName["BarCode_RequestPermission"] = "barCode.requestPermission";
     ApiName["BarCode_ScanBarCode"] = "barCode.scanBarCode";
@@ -1096,6 +1106,7 @@ var ApiName;
     ApiName["Menus_SetNavBarMenu"] = "menus.setNavBarMenu";
     ApiName["Menus_SetUpViews"] = "menus.setUpViews";
     ApiName["Menus_ShowActionMenu"] = "menus.showActionMenu";
+    ApiName["MessageChannels_GetTelemetryPort"] = "messageChannels.getTelemetryPort";
     ApiName["Monetization_OpenPurchaseExperience"] = "monetization.openPurchaseExperience";
     ApiName["Navigation_NavigateBack"] = "navigation.navigateBack";
     ApiName["Navigation_NavigateCrossDomain"] = "navigation.navigateCrossDomain";
@@ -1155,6 +1166,8 @@ var ApiName;
     ApiName["PublicAPIs_SetFrameContext"] = "setFrameContext";
     ApiName["PublicAPIs_ShareDeepLink"] = "shareDeepLink";
     ApiName["RegisterHandler"] = "registerHandler";
+    ApiName["RegisterBeforeUnloadHandler"] = "registerBeforeUnloadHandler";
+    ApiName["RegisterLoadHandler"] = "registerLoadHandler";
     ApiName["RegisterOnThemeChangeHandler"] = "registerOnThemeChangeHandler";
     ApiName["RemoteCamera_GetCapableParticipants"] = "remoteCamera.getCapableParticipants";
     ApiName["RemoteCamera_RegisterOnCapableParticipantsChangeHandler"] = "remoteCamera.registerOnCapableParticipantsChangeHandler";
@@ -1208,6 +1221,9 @@ var ApiName;
     ApiName["VideoEffectsEx_RegisterSetFrameProcessTimeLimitHandler"] = "videoEffectsEX.registerSetFrameProcessTimeLimitHandler";
     ApiName["VideoEffectsEx_RegisterStartVideoExtensibilityVideoStreamHandler"] = "videoEffectsEX.registerStartVideoExtensibilityVideoStreamHandler";
     ApiName["VideoEffectsEx_UpdatePersonalizedEffects"] = "videoEffectsEx.updatePersonalizedEffects";
+    ApiName["VideoEffectsUtils_EffectFailure"] = "videoEffectsUtils.effectFailure";
+    ApiName["VideoEffectsUtils_ReportVideoEffectChanged"] = "videoEffectsUtils.reportVideoEffectChanged";
+    ApiName["VideoEffectsUtils_TransformerWithMetadata_Constructor"] = "videoEffectsUtils.transformerWithMetadata.constructor";
     ApiName["VideoPerformanceMonitor_Constructor"] = "videoPerformanceMonitor.performanceDataGenerated";
     ApiName["VideoPerformanceMonitor_ReportFrameProcessed"] = "videoPerformanceMonitor.reportFrameProcessed";
     ApiName["VideoPerformanceMonitor_ReportTextureStreamAcquired"] = "videoPerformanceMonitor.reportTextureStreamAcquired";
@@ -1762,7 +1778,9 @@ var ChannelType;
 /** An error object indicating that the requested operation or feature is not supported on the current platform or device.
  * @typedef {Object} SdkError
  */
-const errorNotSupportedOnPlatform = { errorCode: ErrorCode.NOT_SUPPORTED_ON_PLATFORM };
+const errorNotSupportedOnPlatform = {
+    errorCode: ErrorCode.NOT_SUPPORTED_ON_PLATFORM,
+};
 /**
  * @hidden
  *
@@ -2502,7 +2520,7 @@ const _minRuntimeConfigToUninitialize = {
  * @hidden
  *  Package version.
  */
-const version = "2.20.0-beta.2";
+const version = "2.20.0-beta.4";
 
 ;// CONCATENATED MODULE: ./src/internal/internalAPIs.ts
 
@@ -3808,6 +3826,24 @@ function appInitializeHelper(apiVersionTag, validMessageOrigins) {
         return Promise.resolve();
     }
 }
+function notifyAppLoadedHelper(apiVersionTag) {
+    sendMessageToParentWithVersion(apiVersionTag, app.Messages.AppLoaded, [version]);
+}
+function notifyExpectedFailureHelper(apiVersionTag, expectedFailureRequest) {
+    sendMessageToParentWithVersion(apiVersionTag, app.Messages.ExpectedFailure, [
+        expectedFailureRequest.reason,
+        expectedFailureRequest.message,
+    ]);
+}
+function notifyFailureHelper(apiVersiontag, appInitializationFailedRequest) {
+    sendMessageToParentWithVersion(apiVersiontag, app.Messages.Failure, [
+        appInitializationFailedRequest.reason,
+        appInitializationFailedRequest.message,
+    ]);
+}
+function notifySuccessHelper(apiVersionTag) {
+    sendMessageToParentWithVersion(apiVersionTag, app.Messages.Success, [version]);
+}
 const initializeHelperLogger = appLogger.extend('initializeHelper');
 function initializeHelper(apiVersionTag, validMessageOrigins) {
     return new Promise((resolve) => {
@@ -4065,7 +4101,7 @@ var app;
      */
     function notifyAppLoaded() {
         ensureInitializeCalled();
-        sendMessageToParentWithVersion(getApiVersionTag(appTelemetryVersionNumber, ApiName.App_NotifyAppLoaded), app.Messages.AppLoaded, [version]);
+        notifyAppLoadedHelper(getApiVersionTag(appTelemetryVersionNumber, ApiName.App_NotifyAppLoaded));
     }
     app.notifyAppLoaded = notifyAppLoaded;
     /**
@@ -4073,7 +4109,7 @@ var app;
      */
     function notifySuccess() {
         ensureInitializeCalled();
-        sendMessageToParentWithVersion(getApiVersionTag(appTelemetryVersionNumber, ApiName.App_NotifySuccess), app.Messages.Success, [version]);
+        notifySuccessHelper(getApiVersionTag(appTelemetryVersionNumber, ApiName.App_NotifySuccess));
     }
     app.notifySuccess = notifySuccess;
     /**
@@ -4084,7 +4120,7 @@ var app;
      */
     function notifyFailure(appInitializationFailedRequest) {
         ensureInitializeCalled();
-        sendMessageToParentWithVersion(getApiVersionTag(appTelemetryVersionNumber, ApiName.App_NotifyFailure), app.Messages.Failure, [appInitializationFailedRequest.reason, appInitializationFailedRequest.message]);
+        notifyFailureHelper(getApiVersionTag(appTelemetryVersionNumber, ApiName.App_NotifyFailure), appInitializationFailedRequest);
     }
     app.notifyFailure = notifyFailure;
     /**
@@ -4094,7 +4130,7 @@ var app;
      */
     function notifyExpectedFailure(expectedFailureRequest) {
         ensureInitializeCalled();
-        sendMessageToParentWithVersion(getApiVersionTag(appTelemetryVersionNumber, ApiName.App_NotifyExpectedFailure), app.Messages.ExpectedFailure, [expectedFailureRequest.reason, expectedFailureRequest.message]);
+        notifyExpectedFailureHelper(getApiVersionTag(appTelemetryVersionNumber, ApiName.App_NotifyExpectedFailure), expectedFailureRequest);
     }
     app.notifyExpectedFailure = notifyExpectedFailure;
     /**
@@ -5309,7 +5345,8 @@ function handleBeforeUnload() {
  */
 function handlers_registerBeforeSuspendOrTerminateHandler(handler) {
     HandlersPrivate.beforeSuspendOrTerminateHandler = handler;
-    !isNullOrUndefined(handler) && sendMessageToParent('registerHandler', ['beforeUnload']);
+    !isNullOrUndefined(handler) &&
+        sendMessageToParentWithVersion(getApiVersionTag(ApiVersionNumber.V_2, ApiName.RegisterBeforeUnloadHandler), 'registerHandler', ['beforeUnload']);
 }
 /**
  * @internal
@@ -5317,7 +5354,8 @@ function handlers_registerBeforeSuspendOrTerminateHandler(handler) {
  */
 function handlers_registerOnResumeHandler(handler) {
     HandlersPrivate.resumeHandler = handler;
-    !isNullOrUndefined(handler) && sendMessageToParent('registerHandler', ['load']);
+    !isNullOrUndefined(handler) &&
+        sendMessageToParentWithVersion(getApiVersionTag(ApiVersionNumber.V_2, ApiName.RegisterLoadHandler), 'registerHandler', ['load']);
 }
 
 ;// CONCATENATED MODULE: ./src/internal/nestedAppAuth.ts
@@ -5480,6 +5518,7 @@ CommunicationPrivate.topMessageQueue = [];
 CommunicationPrivate.nextMessageId = 0;
 CommunicationPrivate.callbacks = {};
 CommunicationPrivate.promiseCallbacks = {};
+CommunicationPrivate.portCallbacks = {};
 /**
  * @internal
  * Limited to Microsoft-internal use
@@ -5548,6 +5587,7 @@ function uninitializeCommunication() {
     CommunicationPrivate.nextMessageId = 0;
     CommunicationPrivate.callbacks = {};
     CommunicationPrivate.promiseCallbacks = {};
+    CommunicationPrivate.portCallbacks = {};
 }
 /**
  * @hidden
@@ -5682,6 +5722,36 @@ function sendMessageToParentAsync(actionName, args = undefined) {
         resolve(waitForResponse(request.id));
     });
 }
+/**
+ * @hidden
+ * Send a message to parent requesting a MessageChannel Port.
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function requestPortFromParentWithVersion(apiVersionTag, actionName, args = undefined) {
+    if (!isFollowingApiVersionTagFormat(apiVersionTag)) {
+        throw Error(`apiVersionTag: ${apiVersionTag} passed in doesn't follow the pattern starting with 'v' followed by digits, then underscore with words, please check.`);
+    }
+    const request = sendMessageToParentHelper(apiVersionTag, actionName, args);
+    return waitForPort(request.id);
+}
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function waitForPort(requestId) {
+    return new Promise((resolve, reject) => {
+        CommunicationPrivate.portCallbacks[requestId] = (port, args) => {
+            if (port instanceof MessagePort) {
+                resolve(port);
+            }
+            else {
+                // First arg is the error message, if present
+                reject(args && args.length > 0 ? args[0] : new Error('Host responded without port or error details.'));
+            }
+        };
+    });
+}
 /**
  * @internal
  * Limited to Microsoft-internal use
@@ -5982,6 +6052,17 @@ function handleParentMessage(evt) {
             logger('Removing registered promise callback for message %i', message.id);
             delete CommunicationPrivate.promiseCallbacks[message.id];
         }
+        const portCallback = CommunicationPrivate.portCallbacks[message.id];
+        if (portCallback) {
+            logger('Invoking the registered port callback for message %i with arguments %o', message.id, message.args);
+            let port;
+            if (evt.ports && evt.ports[0] instanceof MessagePort) {
+                port = evt.ports[0];
+            }
+            portCallback(port, message.args);
+            logger('Removing registered port callback for message %i', message.id);
+            delete CommunicationPrivate.portCallbacks[message.id];
+        }
     }
     else if ('func' in evt.data && typeof evt.data.func === 'string') {
         // Delegate the request to the proper handler
@@ -6661,6 +6742,11 @@ function createTeamsDeepLinkForAppInstallDialog(appId) {
 
 
 
+
+/**
+ * v1 APIs telemetry file: All of APIs in this capability file should send out API version v1 ONLY
+ */
+const appInstallDialogTelemetryVersionNumber = ApiVersionNumber.V_1;
 var appInstallDialog;
 (function (appInstallDialog) {
     /**
@@ -6674,11 +6760,14 @@ var appInstallDialog;
             if (!isSupported()) {
                 throw new Error('Not supported');
             }
+            const apiVersionTag = getApiVersionTag(appInstallDialogTelemetryVersionNumber, ApiName.AppInstallDialog_OpenAppInstallDialog);
             if (runtime_runtime.isLegacyTeams) {
-                resolve(sendAndHandleStatusAndReason('executeDeepLink', createTeamsDeepLinkForAppInstallDialog(openAPPInstallDialogParams.appId)));
+                resolve(sendAndHandleStatusAndReasonWithVersion(apiVersionTag, 'executeDeepLink', createTeamsDeepLinkForAppInstallDialog(openAPPInstallDialogParams.appId)));
             }
             else {
-                sendMessageToParent('appInstallDialog.openAppInstallDialog', [openAPPInstallDialogParams]);
+                sendMessageToParentWithVersion(apiVersionTag, 'appInstallDialog.openAppInstallDialog', [
+                    openAPPInstallDialogParams,
+                ]);
                 resolve();
             }
         });
@@ -7891,6 +7980,11 @@ function getAdaptiveCardSchemaVersion() {
 
 
 
+
+/**
+ * v1 APIs telemetry file: All of APIs in this capability file should send out API version v1 ONLY
+ */
+const appWindowTelemetryVersionNumber = ApiVersionNumber.V_1;
 /**
  * An object that application can utilize to establish communication
  * with the child window it opened, which contains the corresponding task.
@@ -7904,7 +7998,7 @@ class ChildAppWindow {
      */
     postMessage(message, onComplete) {
         internalAPIs_ensureInitialized(runtime_runtime);
-        sendMessageToParent('messageForChild', [message], onComplete ? onComplete : getGenericOnCompleteHandler());
+        sendMessageToParentWithVersion(getApiVersionTag(appWindowTelemetryVersionNumber, ApiName.AppWindow_ChildAppWindow_PostMessage), 'messageForChild', [message], onComplete ? onComplete : getGenericOnCompleteHandler());
     }
     /**
      * Add a listener that will be called when an event is received from the ChildAppWindow.
@@ -7915,7 +8009,7 @@ class ChildAppWindow {
     addEventListener(type, listener) {
         internalAPIs_ensureInitialized(runtime_runtime);
         if (type === 'message') {
-            registerHandler('messageForParent', listener);
+            registerHandlerWithVersion(getApiVersionTag(appWindowTelemetryVersionNumber, ApiName.AppWindow_ChildAppWindow_AddEventListener), 'messageForParent', listener);
         }
     }
 }
@@ -7938,7 +8032,7 @@ class ParentAppWindow {
      */
     postMessage(message, onComplete) {
         internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.task);
-        sendMessageToParent('messageForParent', [message], onComplete ? onComplete : getGenericOnCompleteHandler());
+        sendMessageToParentWithVersion(getApiVersionTag(appWindowTelemetryVersionNumber, ApiName.AppWindow_ParentAppWindow_PostMessage), 'messageForParent', [message], onComplete ? onComplete : getGenericOnCompleteHandler());
     }
     /**
      * Add a listener that will be called when an event is received from the ParentAppWindow.
@@ -7949,7 +8043,7 @@ class ParentAppWindow {
     addEventListener(type, listener) {
         internalAPIs_ensureInitialized(runtime_runtime, FrameContexts.task);
         if (type === 'message') {
-            registerHandler('messageForChild', listener);
+            registerHandlerWithVersion(getApiVersionTag(appWindowTelemetryVersionNumber, ApiName.AppWindow_ParentAppWindow_AddEventListener), 'messageForChild', listener);
         }
     }
 }
@@ -8854,11 +8948,12 @@ var calendar;
             if (!isSupported()) {
                 throw new Error('Not supported');
             }
+            const apiVersionTag = getApiVersionTag(calendarTelemetryVersionNumber, ApiName.Calendar_ComposeMeeting);
             if (runtime_runtime.isLegacyTeams) {
-                resolve(sendAndHandleStatusAndReason('executeDeepLink', createTeamsDeepLinkForCalendar(composeMeetingParams.attendees, composeMeetingParams.startTime, composeMeetingParams.endTime, composeMeetingParams.subject, composeMeetingParams.content)));
+                resolve(sendAndHandleStatusAndReasonWithVersion(apiVersionTag, 'executeDeepLink', createTeamsDeepLinkForCalendar(composeMeetingParams.attendees, composeMeetingParams.startTime, composeMeetingParams.endTime, composeMeetingParams.subject, composeMeetingParams.content)));
             }
             else {
-                resolve(sendAndHandleStatusAndReasonWithVersion(getApiVersionTag(calendarTelemetryVersionNumber, ApiName.Calendar_ComposeMeeting), 'calendar.composeMeeting', composeMeetingParams));
+                resolve(sendAndHandleStatusAndReasonWithVersion(apiVersionTag, 'calendar.composeMeeting', composeMeetingParams));
             }
         });
     }
@@ -9296,6 +9391,16 @@ var videoEffectsUtils_awaiter = (undefined && undefined.__awaiter) || function (
 
 
 
+
+/**
+ * @hidden
+ * Align with the W3C spec: https://www.w3.org/TR/webcodecs/
+ *
+ * @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 videoEffectsUtilTelemetryVersionNumber = ApiVersionNumber.V_2;
 /**
  * @hidden
  * Create a MediaStreamTrack from the media stream with the given streamId and processed by videoFrameHandler.
@@ -9606,7 +9711,7 @@ class TransformerWithMetadata {
                 },
             };
         });
-        registerHandler('video.mediaStream.audioInferenceDiscardStatusChange', ({ discardAudioInferenceResult }) => {
+        registerHandlerWithVersion(getApiVersionTag(videoEffectsUtilTelemetryVersionNumber, ApiName.VideoEffectsUtils_TransformerWithMetadata_Constructor), 'video.mediaStream.audioInferenceDiscardStatusChange', ({ discardAudioInferenceResult }) => {
             this.shouldDiscardAudioInferenceResult = discardAudioInferenceResult;
         });
     }
@@ -9620,11 +9725,11 @@ function createEffectParameterChangeCallback(callback, videoPerformanceMonitor)
         callback(effectId, effectParam)
             .then(() => {
             videoPerformanceMonitor === null || videoPerformanceMonitor === void 0 ? void 0 : videoPerformanceMonitor.reportVideoEffectChanged(effectId || '', effectParam);
-            sendMessageToParent('video.videoEffectReadiness', [true, effectId, undefined, effectParam]);
+            sendMessageToParentWithVersion(getApiVersionTag(videoEffectsUtilTelemetryVersionNumber, ApiName.VideoEffectsUtils_ReportVideoEffectChanged), 'video.videoEffectReadiness', [true, effectId, undefined, effectParam]);
         })
             .catch((reason) => {
             const validReason = reason in videoEffects.EffectFailureReason ? reason : videoEffects.EffectFailureReason.InitializationFailure;
-            sendMessageToParent('video.videoEffectReadiness', [false, effectId, validReason, effectParam]);
+            sendMessageToParentWithVersion(getApiVersionTag(videoEffectsUtilTelemetryVersionNumber, ApiName.VideoEffectsUtils_EffectFailure), 'video.videoEffectReadiness', [false, effectId, validReason, effectParam]);
         });
     };
 }
@@ -10776,10 +10881,14 @@ var call;
 
 ;// CONCATENATED MODULE: ./src/public/appInitialization.ts
 
+
 /**
  * @deprecated
  * As of 2.0.0, please use {@link app} namespace instead.
+ *
+ * v1 APIs telemetry file: All of APIs in this capability file should send out API version v1 ONLY
  */
+const appInitializationTelemetryVersionNumber = ApiVersionNumber.V_1;
 var appInitialization;
 (function (appInitialization) {
     /**
@@ -10807,7 +10916,7 @@ var appInitialization;
      * Notifies the frame that app has loaded and to hide the loading indicator if one is shown.
      */
     function notifyAppLoaded() {
-        app.notifyAppLoaded();
+        notifyAppLoadedHelper(getApiVersionTag(appInitializationTelemetryVersionNumber, ApiName.AppInitialization_NotifyAppLoaded));
     }
     appInitialization.notifyAppLoaded = notifyAppLoaded;
     /**
@@ -10817,7 +10926,7 @@ var appInitialization;
      * Notifies the frame that app initialization is successful and is ready for user interaction.
      */
     function notifySuccess() {
-        app.notifySuccess();
+        notifySuccessHelper(getApiVersionTag(appInitializationTelemetryVersionNumber, ApiName.AppInitialization_NotifySuccess));
     }
     appInitialization.notifySuccess = notifySuccess;
     /**
@@ -10829,7 +10938,7 @@ var appInitialization;
      * during initialization as well as an optional message.
      */
     function notifyFailure(appInitializationFailedRequest) {
-        app.notifyFailure(appInitializationFailedRequest);
+        notifyFailureHelper(getApiVersionTag(appInitializationTelemetryVersionNumber, ApiName.AppInitialization_NotifyFailure), appInitializationFailedRequest);
     }
     appInitialization.notifyFailure = notifyFailure;
     /**
@@ -10840,7 +10949,7 @@ var appInitialization;
      * @param expectedFailureRequest - The expected failure request containing the reason and an optional message
      */
     function notifyExpectedFailure(expectedFailureRequest) {
-        app.notifyExpectedFailure(expectedFailureRequest);
+        notifyExpectedFailureHelper(getApiVersionTag(appInitializationTelemetryVersionNumber, ApiName.AppInitialization_NotifyExpectedFailure), expectedFailureRequest);
     }
     appInitialization.notifyExpectedFailure = notifyExpectedFailure;
 })(appInitialization || (appInitialization = {}));
@@ -13270,6 +13379,97 @@ var meetingRoom;
     meetingRoom.isSupported = isSupported;
 })(meetingRoom || (meetingRoom = {}));
 
+;// CONCATENATED MODULE: ./src/private/messageChannels.ts
+var messageChannels_awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+
+
+
+
+
+/**
+ * @hidden
+ * Namespace to request message ports from the host application.
+ *
+ * @beta
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+var messageChannels;
+(function (messageChannels) {
+    let telemetryPort;
+    const messageChannelsTelemetryVersionNumber = ApiVersionNumber.V_1;
+    const logger = getLogger('messageChannels');
+    /**
+     * @hidden
+     * @beta
+     *
+     * Fetches a MessagePort to batch telemetry through the host's telemetry worker.
+     * The port is cached once received, so subsequent calls return the same port.
+     * @returns MessagePort.
+     *
+     * @throws Error if {@linkcode app.initialize} has not successfully completed,
+     * if the host does not support the feature, or if the port request is rejected.
+     *
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    function getTelemetryPort() {
+        return messageChannels_awaiter(this, void 0, void 0, function* () {
+            // If the port has already been initialized, return it.
+            if (telemetryPort) {
+                logger('Returning telemetry port from cache');
+                return telemetryPort;
+            }
+            if (!isSupported()) {
+                throw errorNotSupportedOnPlatform;
+            }
+            // Send request for telemetry port, will throw if the request is rejected
+            telemetryPort = yield requestPortFromParentWithVersion(getApiVersionTag(messageChannelsTelemetryVersionNumber, ApiName.MessageChannels_GetTelemetryPort), 'messageChannels.getTelemetryPort');
+            return telemetryPort;
+        });
+    }
+    messageChannels.getTelemetryPort = getTelemetryPort;
+    /**
+     * @hidden
+     *
+     * @beta
+     *
+     * Checks if the messageChannels capability is supported by the host
+     * @returns boolean to represent whether the messageChannels capability is supported
+     *
+     * @throws Error if {@linkcode app.initialize} has not successfully completed
+     *
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    function isSupported() {
+        return internalAPIs_ensureInitialized(runtime_runtime) && runtime_runtime.supports.messageChannels ? true : false;
+    }
+    messageChannels.isSupported = isSupported;
+    /**
+     * @hidden
+     * Undocumented function used to clear state between unit tests
+     *
+     * @beta
+     *
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    function _clearTelemetryPort() {
+        telemetryPort = undefined;
+    }
+    messageChannels._clearTelemetryPort = _clearTelemetryPort;
+})(messageChannels || (messageChannels = {}));
+
 ;// CONCATENATED MODULE: ./src/private/notifications.ts
 
 
@@ -14121,6 +14321,7 @@ var videoEffectsEx;
 
 
 
+
 
 ;// CONCATENATED MODULE: ./src/index.ts