@microsoft/teams-js 2.53.1 → 2.54.0

package/README.md

@@ -24,7 +24,7 @@ To install the stable [version](https://learn.microsoft.com/javascript/api/overv
 
 ### Production
 
-You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.53.1/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.54.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.53.1/js/MicrosoftTeams.min.js"
-  integrity="sha384-u/ADAeV1WhPQrTvoCmXcIhzguvD7vpAOyMxZFTIk4lTwgZAKtRKT1SFqOWTyQJ/s"
+  src="https://res.cdn.office.net/teams-js/2.54.0/js/MicrosoftTeams.min.js"
+  integrity="sha384-PIuQ2V7hlz4b1x3G1mPCYYZiWTjxzRTL6bf547xR9ARsAeNv2DAzti86LQnFCwlo"
   crossorigin="anonymous"
 ></script>
 
 <!-- Microsoft Teams JavaScript API (via npm) -->
-<script src="node_modules/@microsoft/teams-js@2.53.1/dist/MicrosoftTeams.min.js"></script>
+<script src="node_modules/@microsoft/teams-js@2.54.0/dist/MicrosoftTeams.min.js"></script>
 
 <!-- Microsoft Teams JavaScript API (via local) -->
 <script src="MicrosoftTeams.min.js"></script>

package/dist/esm/packages/teams-js/dts/internal/telemetry.d.ts

@@ -216,6 +216,7 @@ export declare const enum ApiName {
     MessageChannels_Telemetry_GetTelemetryPort = "messageChannels.telemetry.getTelemetryPort",
     MessageChannels_DataLayer_GetDataLayerPort = "messageChannels.dataLayer.getDataLayerPort",
     Monetization_OpenPurchaseExperience = "monetization.openPurchaseExperience",
+    MouseRelay_NavigateHistory = "mouseRelay.navigateHistory",
     Navigation_NavigateBack = "navigation.navigateBack",
     Navigation_NavigateCrossDomain = "navigation.navigateCrossDomain",
     Navigation_NavigateToTab = "navigation.navigateToTab",

package/dist/esm/packages/teams-js/dts/public/clipboard.d.ts

@@ -1,11 +1,32 @@
 /**
  * Interact with the system clipboard
  *
+ * @deprecated
+ * As of TeamsJS v2.54.0, the clipboard capability is deprecated. These APIs may stop working at
+ * any time without notice: support for this capability in Teams and other host apps may be removed
+ * entirely and independently of a TeamsJS major release, so continued functionality is not
+ * guaranteed. The intended long-term replacement is the standardized Clipboard API provided by the
+ * browser ({@link https://developer.mozilla.org/docs/Web/API/Clipboard_API | Clipboard API}, `navigator.clipboard`).
+ * Note that using the browser-native Clipboard API directly within Teams hosts is not yet fully
+ * supported; it depends on native device permission handling that is still being enabled as a
+ * separate effort.
+ *
  * @beta
  * @module
  */
 /**
  * Function to copy data to clipboard.
+ *
+ * @deprecated
+ * As of TeamsJS v2.54.0, the clipboard capability is deprecated. These APIs may stop working at
+ * any time without notice: support for this capability in Teams and other host apps may be removed
+ * entirely and independently of a TeamsJS major release, so continued functionality is not
+ * guaranteed. The intended long-term replacement is the standardized Clipboard API provided by the
+ * browser ({@link https://developer.mozilla.org/docs/Web/API/Clipboard_API | Clipboard API}, `navigator.clipboard`).
+ * Note that using the browser-native Clipboard API directly within Teams hosts is not yet fully
+ * supported; it depends on native device permission handling that is still being enabled as a
+ * separate effort.
+ *
  * @remarks
  * Note: clipboard.write only supports Text, HTML, PNG, and JPEG data format.
  *       MIME type for Text -> `text/plain`, HTML -> `text/html`, PNG/JPEG -> `image/(png | jpeg)`
@@ -19,6 +40,16 @@ export declare function write(blob: Blob): Promise<void>;
 /**
  * Function to read data from clipboard.
  *
+ * @deprecated
+ * As of TeamsJS v2.54.0, the clipboard capability is deprecated. These APIs may stop working at
+ * any time without notice: support for this capability in Teams and other host apps may be removed
+ * entirely and independently of a TeamsJS major release, so continued functionality is not
+ * guaranteed. The intended long-term replacement is the standardized Clipboard API provided by the
+ * browser ({@link https://developer.mozilla.org/docs/Web/API/Clipboard_API | Clipboard API}, `navigator.clipboard`).
+ * Note that using the browser-native Clipboard API directly within Teams hosts is not yet fully
+ * supported; it depends on native device permission handling that is still being enabled as a
+ * separate effort.
+ *
  * @returns A promise blob which resolves to the data read from the clipboard or
  *          rejects stating the reason for failure.
  *          Note: Returned blob type will contain one of the MIME type `image/png`, `text/plain` or `text/html`.
@@ -30,6 +61,16 @@ export declare function read(): Promise<Blob>;
  *
  * @throws Error if {@linkcode app.initialize} has not successfully completed
  *
+ * @deprecated
+ * As of TeamsJS v2.54.0, the clipboard capability is deprecated. These APIs may stop working at
+ * any time without notice: support for this capability in Teams and other host apps may be removed
+ * entirely and independently of a TeamsJS major release, so continued functionality is not
+ * guaranteed. The intended long-term replacement is the standardized Clipboard API provided by the
+ * browser ({@link https://developer.mozilla.org/docs/Web/API/Clipboard_API | Clipboard API}, `navigator.clipboard`).
+ * Note that using the browser-native Clipboard API directly within Teams hosts is not yet fully
+ * supported; it depends on native device permission handling that is still being enabled as a
+ * separate effort.
+ *
  * @beta
  */
 export declare function isSupported(): boolean;

package/dist/esm/packages/teams-js/dts/public/index.d.ts

@@ -47,5 +47,6 @@ export * as tasks from './tasks';
 export * as liveShare from './liveShareHost';
 export { LiveShareHost } from './liveShareHost';
 export * as marketplace from './marketplace';
+export * as mouseRelay from './mouseRelay';
 export { ISerializable } from './serializable.interface';
 export * as shortcutRelay from './shortcutRelay';

package/dist/esm/packages/teams-js/dts/public/interfaces.d.ts

@@ -1225,7 +1225,17 @@ export declare enum EduType {
     Other = "other"
 }
 /**
- * Currently supported Mime type
+ * Currently supported MIME types
+ *
+ * @deprecated
+ * As of TeamsJS v2.54.0, the clipboard capability is deprecated. These APIs may stop working at
+ * any time without notice: support for this capability in Teams and other host apps may be removed
+ * entirely and independently of a TeamsJS major release, so continued functionality is not
+ * guaranteed. The intended long-term replacement is the standardized Clipboard API provided by the
+ * browser ({@link https://developer.mozilla.org/docs/Web/API/Clipboard_API | Clipboard API}, `navigator.clipboard`).
+ * Note that using the browser-native Clipboard API directly within Teams hosts is not yet fully
+ * supported; it depends on native device permission handling that is still being enabled as a
+ * separate effort.
  */
 export declare enum ClipboardSupportedMimeType {
     TextPlain = "text/plain",
@@ -1235,9 +1245,19 @@ export declare enum ClipboardSupportedMimeType {
 }
 /**
  * Clipboard write parameters
+ *
+ * @deprecated
+ * As of TeamsJS v2.54.0, the clipboard capability is deprecated. These APIs may stop working at
+ * any time without notice: support for this capability in Teams and other host apps may be removed
+ * entirely and independently of a TeamsJS major release, so continued functionality is not
+ * guaranteed. The intended long-term replacement is the standardized Clipboard API provided by the
+ * browser ({@link https://developer.mozilla.org/docs/Web/API/Clipboard_API | Clipboard API}, `navigator.clipboard`).
+ * Note that using the browser-native Clipboard API directly within Teams hosts is not yet fully
+ * supported; it depends on native device permission handling that is still being enabled as a
+ * separate effort.
  */
 export interface ClipboardParams {
-    /** Mime Type of data to be copied to Clipboard */
+    /** MIME type of data to be copied to Clipboard */
     mimeType: ClipboardSupportedMimeType;
     /** Blob content in Base64 string format */
     content: string;

package/dist/esm/packages/teams-js/dts/public/meeting/meeting.d.ts

@@ -806,6 +806,10 @@ export declare enum EventActionSource {
      * Source is calendar form join teams meeting button.
      */
     M365CalendarFormJoinTeamsMeetingButton = "m365_calendar_form_join_teams_meeting_button",
+    /**
+     * Source is the M365 calendar Meet Now start action.
+     */
+    M365CalendarMeetNow = "m365_calendar_meet_now",
     /**
      * Other sources.
      */

package/dist/esm/packages/teams-js/dts/public/mouseRelay.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Lets an app inside a Teams iframe relay the mouse back (X1) / forward (X2)
+ * buttons to the host so they drive Teams history navigation.
+ *
+ * @module
+ */
+/**
+ * The direction of a relayed history-navigation intent.
+ */
+export type NavigationDirection = 'back' | 'forward';
+/**
+ * Enable the capability so the mouse back (X1) / forward (X2) buttons pressed
+ * inside this iframe drive Teams history navigation in the host.
+ *
+ * @throws Error if {@link app.initialize} has not successfully completed or the
+ * host does not support the mouseRelay capability.
+ */
+export declare function enableMouseRelayCapability(): Promise<void>;
+/**
+ * Disable the mouse relay capability, detaching its listeners so the mouse
+ * back (X1) / forward (X2) buttons no longer drive Teams history navigation.
+ *
+ * @throws Error if {@link app.initialize} has not successfully completed or the
+ * host does not support the mouseRelay capability.
+ */
+export declare function disableMouseRelayCapability(): void;
+/**
+ * Checks if the mouseRelay capability is supported by the host.
+ * @returns boolean to represent whether the mouseRelay capability is supported.
+ *
+ * @throws Error if {@link app.initialize} has not successfully completed.
+ */
+export declare function isSupported(): boolean;

package/dist/esm/packages/teams-js/dts/public/runtime.d.ts

@@ -74,6 +74,7 @@ interface IRuntimeV4 extends IBaseRuntime {
             readonly dataLayer?: {};
         };
         readonly monetization?: {};
+        readonly mouseRelay?: {};
         readonly nestedAppAuth?: {};
         readonly notifications?: {};
         readonly otherAppStateChange?: {};

package/dist/esm/packages/teams-js/src/index.js

@@ -1 +1 @@
-export{NotificationTypes,UserSettingTypes,ViewerActionTypes}from"./private/interfaces.js";export{openFilePreview,registerCustomHandler,registerUserSettingsChangeHandler,sendCustomEvent,sendCustomMessage,uploadCustomApp}from"./private/privateAPIs.js";import*as e from"./private/externalAppAuthentication.js";export{e as externalAppAuthentication};export{UserAuthenticationState}from"./private/externalAppAuthentication.js";import*as r from"./private/logs.js";export{r as logs};import*as t from"./private/conversations.js";export{t as conversations};import*as o from"./private/copilot/copilot.js";export{o as copilot};import*as p from"./private/copilot/sidePanelInterfaces.js";export{p as sidePanelInterfaces};import*as i from"./private/externalAppAuthenticationForCEA.js";export{i as externalAppAuthenticationForCEA};import*as a from"./private/externalAppCardActions.js";export{a as externalAppCardActions};import*as s from"./private/externalAppCardActionsForCEA.js";export{s as externalAppCardActionsForCEA};import*as m from"./private/externalAppCardActionsForDA.js";export{m as externalAppCardActionsForDA};import*as n from"./private/externalAppCommands.js";export{n as externalAppCommands};import*as l from"./private/files.js";export{l as files};import*as c from"./private/meetingRoom.js";export{c as meetingRoom};import*as f from"./private/messageChannels/messageChannels.js";export{f as messageChannels};import*as u from"./private/nestedAppAuth/nestedAppAuthBridge.js";export{u as nestedAppAuthBridge};import*as x from"./private/notifications.js";export{x as notifications};import*as j from"./private/otherAppStateChange.js";export{j as otherAppStateChange};import*as d from"./private/plugins.js";export{d as plugins};import*as g from"./private/remoteCamera.js";export{g as remoteCamera};import*as b from"./private/appEntity.js";export{b as appEntity};import*as v from"./private/teams/teams.js";export{v as teams};import*as A from"./private/videoEffectsEx.js";export{A as videoEffectsEx};import*as C from"./private/hostEntity/hostEntity.js";export{C as hostEntity};import*as h from"./private/store.js";export{h as store};import*as S from"./private/widgetHosting/widgetHosting.js";export{S as widgetHosting};export{ChannelType,DialogDimension,FrameContexts,HostClientType,HostName,RenderingSurfaces,DialogDimension as TaskModuleDimension,TeamType,UserTeamRole}from"./public/constants.js";export{ActionObjectType,EduType,ErrorCode,FileOpenPreference,SecondaryM365ContentIdName}from"./public/interfaces.js";export{AppId}from"./public/appId.js";export{EmailAddress}from"./public/emailAddress.js";export{activateChildProxyingCommunication,getCurrentFeatureFlagsState,overwriteFeatureFlagsState,setFeatureFlagsState}from"./public/featureFlags.js";export{getAdaptiveCardSchemaVersion}from"./public/adaptiveCards.js";export{ChildAppWindow,ParentAppWindow}from"./public/appWindow.js";export{ValidatedSafeString}from"./public/validatedSafeString.js";export{version}from"./public/version.js";export{enablePrintCapability,executeDeepLink,getContext,getMruTabInstances,getTabInstances,initialize,initializeWithFrameContext,print,registerAppButtonClickHandler,registerAppButtonHoverEnterHandler,registerAppButtonHoverLeaveHandler,registerBackButtonHandler,registerBeforeUnloadHandler,registerChangeSettingsHandler,registerFocusEnterHandler,registerFullScreenHandler,registerOnLoadHandler,registerOnThemeChangeHandler,setFrameContext,shareDeepLink}from"./public/publicAPIs.js";export{navigateBack,navigateCrossDomain,navigateToTab,returnFocus}from"./public/navigation.js";export{UUID}from"./public/uuidObject.js";import*as H from"./public/liveShareHost.js";export{H as liveShare};export{LiveShareHost}from"./public/liveShareHost.js";import*as F from"./public/authentication.js";export{F as authentication};import*as y from"./public/app/app.js";export{y as app};import*as T from"./public/appPerformanceMetrics.js";export{T as appPerformanceMetrics};import*as E from"./public/appInstallDialog.js";export{E as appInstallDialog};import*as w from"./public/barCode.js";export{w as barCode};import*as I from"./public/chat.js";export{I as chat};import*as D from"./public/clipboard.js";export{D as clipboard};import*as P from"./public/dialog/dialog.js";export{P as dialog};import*as B from"./public/nestedAppAuth.js";export{B as nestedAppAuth};import*as k from"./public/geoLocation/geoLocation.js";export{k as geoLocation};import*as L from"./public/pages/pages.js";export{L as pages};import*as M from"./public/menus.js";export{M as menus};import*as U from"./public/media.js";export{U as media};import*as O from"./public/secondaryBrowser.js";export{O as secondaryBrowser};import*as V from"./public/location.js";export{V as location};import*as z from"./public/meeting/meeting.js";export{z as meeting};import*as R from"./public/monetization.js";export{R as monetization};import*as W from"./public/calendar.js";export{W as calendar};import*as N from"./public/mail/mail.js";export{N as mail};import*as q from"./public/teamsAPIs.js";export{q as teamsCore};import*as G from"./public/people.js";export{G as people};import*as J from"./public/profile.js";export{J as profile};import*as K from"./public/videoEffects.js";export{K as videoEffects};import*as Q from"./public/search.js";export{Q as search};import*as X from"./public/sharing/sharing.js";export{X as sharing};import*as Y from"./public/stageView/stageView.js";export{Y as stageView};import*as Z from"./public/visualMedia/visualMedia.js";export{Z as visualMedia};import*as $ from"./public/webStorage.js";export{$ as webStorage};import*as _ from"./public/call.js";export{_ as call};import*as ee from"./public/appInitialization.js";export{ee as appInitialization};import*as re from"./public/thirdPartyCloudStorage.js";export{re as thirdPartyCloudStorage};import*as te from"./public/settings.js";export{te as settings};import*as oe from"./public/tasks.js";export{oe as tasks};import*as pe from"./public/marketplace.js";export{pe as marketplace};import*as ie from"./public/shortcutRelay.js";export{ie as shortcutRelay};
+export{NotificationTypes,UserSettingTypes,ViewerActionTypes}from"./private/interfaces.js";export{openFilePreview,registerCustomHandler,registerUserSettingsChangeHandler,sendCustomEvent,sendCustomMessage,uploadCustomApp}from"./private/privateAPIs.js";import*as e from"./private/externalAppAuthentication.js";export{e as externalAppAuthentication};export{UserAuthenticationState}from"./private/externalAppAuthentication.js";import*as r from"./private/logs.js";export{r as logs};import*as t from"./private/conversations.js";export{t as conversations};import*as o from"./private/copilot/copilot.js";export{o as copilot};import*as p from"./private/copilot/sidePanelInterfaces.js";export{p as sidePanelInterfaces};import*as i from"./private/externalAppAuthenticationForCEA.js";export{i as externalAppAuthenticationForCEA};import*as a from"./private/externalAppCardActions.js";export{a as externalAppCardActions};import*as s from"./private/externalAppCardActionsForCEA.js";export{s as externalAppCardActionsForCEA};import*as m from"./private/externalAppCardActionsForDA.js";export{m as externalAppCardActionsForDA};import*as n from"./private/externalAppCommands.js";export{n as externalAppCommands};import*as l from"./private/files.js";export{l as files};import*as c from"./private/meetingRoom.js";export{c as meetingRoom};import*as f from"./private/messageChannels/messageChannels.js";export{f as messageChannels};import*as u from"./private/nestedAppAuth/nestedAppAuthBridge.js";export{u as nestedAppAuthBridge};import*as x from"./private/notifications.js";export{x as notifications};import*as j from"./private/otherAppStateChange.js";export{j as otherAppStateChange};import*as d from"./private/plugins.js";export{d as plugins};import*as g from"./private/remoteCamera.js";export{g as remoteCamera};import*as b from"./private/appEntity.js";export{b as appEntity};import*as v from"./private/teams/teams.js";export{v as teams};import*as A from"./private/videoEffectsEx.js";export{A as videoEffectsEx};import*as C from"./private/hostEntity/hostEntity.js";export{C as hostEntity};import*as h from"./private/store.js";export{h as store};import*as S from"./private/widgetHosting/widgetHosting.js";export{S as widgetHosting};export{ChannelType,DialogDimension,FrameContexts,HostClientType,HostName,RenderingSurfaces,DialogDimension as TaskModuleDimension,TeamType,UserTeamRole}from"./public/constants.js";export{ActionObjectType,EduType,ErrorCode,FileOpenPreference,SecondaryM365ContentIdName}from"./public/interfaces.js";export{AppId}from"./public/appId.js";export{EmailAddress}from"./public/emailAddress.js";export{activateChildProxyingCommunication,getCurrentFeatureFlagsState,overwriteFeatureFlagsState,setFeatureFlagsState}from"./public/featureFlags.js";export{getAdaptiveCardSchemaVersion}from"./public/adaptiveCards.js";export{ChildAppWindow,ParentAppWindow}from"./public/appWindow.js";export{ValidatedSafeString}from"./public/validatedSafeString.js";export{version}from"./public/version.js";export{enablePrintCapability,executeDeepLink,getContext,getMruTabInstances,getTabInstances,initialize,initializeWithFrameContext,print,registerAppButtonClickHandler,registerAppButtonHoverEnterHandler,registerAppButtonHoverLeaveHandler,registerBackButtonHandler,registerBeforeUnloadHandler,registerChangeSettingsHandler,registerFocusEnterHandler,registerFullScreenHandler,registerOnLoadHandler,registerOnThemeChangeHandler,setFrameContext,shareDeepLink}from"./public/publicAPIs.js";export{navigateBack,navigateCrossDomain,navigateToTab,returnFocus}from"./public/navigation.js";export{UUID}from"./public/uuidObject.js";import*as H from"./public/liveShareHost.js";export{H as liveShare};export{LiveShareHost}from"./public/liveShareHost.js";import*as y from"./public/authentication.js";export{y as authentication};import*as F from"./public/app/app.js";export{F as app};import*as T from"./public/appPerformanceMetrics.js";export{T as appPerformanceMetrics};import*as E from"./public/appInstallDialog.js";export{E as appInstallDialog};import*as w from"./public/barCode.js";export{w as barCode};import*as I from"./public/chat.js";export{I as chat};import*as D from"./public/clipboard.js";export{D as clipboard};import*as P from"./public/dialog/dialog.js";export{P as dialog};import*as B from"./public/nestedAppAuth.js";export{B as nestedAppAuth};import*as k from"./public/geoLocation/geoLocation.js";export{k as geoLocation};import*as L from"./public/pages/pages.js";export{L as pages};import*as M from"./public/menus.js";export{M as menus};import*as U from"./public/media.js";export{U as media};import*as O from"./public/secondaryBrowser.js";export{O as secondaryBrowser};import*as R from"./public/location.js";export{R as location};import*as V from"./public/meeting/meeting.js";export{V as meeting};import*as z from"./public/monetization.js";export{z as monetization};import*as W from"./public/calendar.js";export{W as calendar};import*as N from"./public/mail/mail.js";export{N as mail};import*as q from"./public/teamsAPIs.js";export{q as teamsCore};import*as G from"./public/people.js";export{G as people};import*as J from"./public/profile.js";export{J as profile};import*as K from"./public/videoEffects.js";export{K as videoEffects};import*as Q from"./public/search.js";export{Q as search};import*as X from"./public/sharing/sharing.js";export{X as sharing};import*as Y from"./public/stageView/stageView.js";export{Y as stageView};import*as Z from"./public/visualMedia/visualMedia.js";export{Z as visualMedia};import*as $ from"./public/webStorage.js";export{$ as webStorage};import*as _ from"./public/call.js";export{_ as call};import*as ee from"./public/appInitialization.js";export{ee as appInitialization};import*as re from"./public/thirdPartyCloudStorage.js";export{re as thirdPartyCloudStorage};import*as te from"./public/settings.js";export{te as settings};import*as oe from"./public/tasks.js";export{oe as tasks};import*as pe from"./public/marketplace.js";export{pe as marketplace};import*as ie from"./public/mouseRelay.js";export{ie as mouseRelay};import*as ae from"./public/shortcutRelay.js";export{ae as shortcutRelay};

package/dist/esm/packages/teams-js/src/public/meeting/meeting.js

@@ -1 +1 @@
-import{__awaiter as e}from"../../../../../node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.55.1_tslib@2.8.1_typescript@4.9.5/node_modules/tslib/tslib.es6.js";import{sendMessageToParent as n,sendAndHandleSdkError as t}from"../../internal/communication.js";import{registerHandler as i,doesHandlerExist as a,removeHandler as o}from"../../internal/handlers.js";import{ensureInitialized as r}from"../../internal/internalAPIs.js";import{getApiVersionTag as l}from"../../internal/telemetry.js";import{FrameContexts as g}from"../constants.js";import{ErrorCode as s}from"../interfaces.js";import{runtime as d}from"../runtime.js";import*as c from"./appShareButton.js";export{c as appShareButton};const u="v1";var m,p,h,C,S,f;function b(e){if(!e)throw new Error("[get incoming client audio state] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.getIncomingClientAudioState"),"getIncomingClientAudioState",e)}function A(e){if(!e)throw new Error("[toggle incoming client audio] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.toggleIncomingClientAudio"),"toggleIncomingClientAudio",e)}function w(e){if(!e)throw new Error("[get meeting details] Callback cannot be null");r(d,g.sidePanel,g.meetingStage,g.settings,g.content),n(l(u,"meeting.getMeetingDetails"),"meeting.getMeetingDetails",e)}function v(){var n,i,a;return e(this,void 0,void 0,function*(){let e;r(d,g.sidePanel,g.meetingStage,g.settings,g.content);try{const n=!0;e=yield t(l("v2","meeting.getMeetingDetailsVerbose"),"meeting.getMeetingDetails",n)}catch(e){throw new Error(null===(n=null==e?void 0:e.errorCode)||void 0===n?void 0:n.toString())}if(((null===(i=e.details)||void 0===i?void 0:i.type)==C.GroupCall||(null===(a=e.details)||void 0===a?void 0:a.type)==C.OneOnOneCall)&&!e.details.originalCallerInfo)throw new Error(s.NOT_SUPPORTED_ON_PLATFORM.toString());return e})}function H(e){if(!e)throw new Error("[get Authentication Token For AnonymousUser] Callback cannot be null");r(d,g.sidePanel,g.meetingStage,g.task),n(l(u,"meeting.getAuthenticationTokenForAnonymousUser"),"meeting.getAuthenticationTokenForAnonymousUser",e)}function k(e){if(!e)throw new Error("[get live stream state] Callback cannot be null");r(d,g.sidePanel),n(l(u,"meeting.getLiveStreamState"),"meeting.getLiveStreamState",e)}function _(e,t,i){if(!e)throw new Error("[request start live streaming] Callback cannot be null");r(d,g.sidePanel),n(l(u,"meeting.requestStartLiveStreaming"),"meeting.requestStartLiveStreaming",[t,i],e)}function M(e){if(!e)throw new Error("[request stop live streaming] Callback cannot be null");r(d,g.sidePanel),n(l(u,"meeting.requestStopLiveStreaming"),"meeting.requestStopLiveStreaming",e)}function E(e){if(!e)throw new Error("[register live stream changed handler] Handler cannot be null");r(d,g.sidePanel),i(l(u,"meeting.registerLiveStreamChangedHandler"),"meeting.liveStreamChanged",e)}function P(e,t,i={sharingProtocol:S.Collaborative}){if(!e)throw new Error("[share app content to stage] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.shareAppContentToStage"),"meeting.shareAppContentToStage",[t,i],e)}function j(e){if(!e)throw new Error("[get app content stage sharing capabilities] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.getAppContentStageSharingCapabilities"),"meeting.getAppContentStageSharingCapabilities",e)}function q(e){if(!e)throw new Error("[stop sharing app content to stage] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.stopSharingAppContentToStage"),"meeting.stopSharingAppContentToStage",e)}function T(e){if(!e)throw new Error("[get app content stage sharing state] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.getAppContentStageSharingState"),"meeting.getAppContentStageSharingState",e)}function D(e){if(!e)throw new Error("[registerSpeakingStateChangeHandler] Handler cannot be null");r(d,g.sidePanel,g.meetingStage),i(l(u,"meeting.registerSpeakingStateChangeHandler"),"meeting.speakingStateChanged",e)}function y(e){if(!e)throw new Error("[registerRaiseHandStateChangedHandler] Handler cannot be null");r(d,g.sidePanel,g.meetingStage),i(l(u,"meeting.registerRaiseHandStateChangedHandler"),"meeting.raiseHandStateChanged",e)}function O(e){if(!e)throw new Error("[registerMeetingReactionReceivedHandler] Handler cannot be null");r(d,g.sidePanel,g.meetingStage),i(l(u,"meeting.registerMeetingReactionReceivedHandler"),"meeting.meetingReactionReceived",e)}function R(e){if(void 0===(null==e?void 0:e.joinWebUrl)||null===(null==e?void 0:e.joinWebUrl))return Promise.reject(new Error("Invalid joinMeetingParams"));r(d);const n={joinWebUrl:e.joinWebUrl.href,source:e.source||f.Other};return t(l("v2","meeting.joinMeeting"),"meeting.joinMeeting",n)}function I(t,s){if(!s)throw new Error("[requestAppAudioHandling] Callback response cannot be null");if(!t.micMuteStateChangedCallback)throw new Error("[requestAppAudioHandling] Callback Mic mute state handler cannot be null");r(d,g.sidePanel,g.meetingStage),t.isAppHandlingAudio?function(t,a){const o=(n,o)=>{if(n&&null!=o)throw new Error("[requestAppAudioHandling] Callback response - both parameters cannot be set");if(n)throw new Error(`[requestAppAudioHandling] Callback response - SDK error ${n.errorCode} ${n.message}`);if("boolean"!=typeof o)throw new Error("[requestAppAudioHandling] Callback response - isHostAudioless must be a boolean");const r=n=>e(this,void 0,void 0,function*(){try{const e=yield t.micMuteStateChangedCallback(n);F(e,e.isMicMuted===n.isMicMuted?m.HostInitiated:m.AppDeclinedToChange)}catch(e){F(n,m.AppFailedToChange)}});i(l(u,"meeting.registerMicStateChangeHandler"),"meeting.micStateChanged",r);const g=e=>{var n;null===(n=t.audioDeviceSelectionChangedCallback)||void 0===n||n.call(t,e)};i(l(u,"meeting.registerAudioDeviceSelectionChangedHandler"),"meeting.audioDeviceSelectionChanged",g),a(o)};n(l(u,"meeting.requestAppAudioHandling"),"meeting.requestAppAudioHandling",[t.isAppHandlingAudio],o)}(t,s):function(e,t){const i=(e,n)=>{if(e&&null!=n)throw new Error("[requestAppAudioHandling] Callback response - both parameters cannot be set");if(e)throw new Error(`[requestAppAudioHandling] Callback response - SDK error ${e.errorCode} ${e.message}`);if("boolean"!=typeof n)throw new Error("[requestAppAudioHandling] Callback response - isHostAudioless must be a boolean");a("meeting.micStateChanged")&&o("meeting.micStateChanged"),a("meeting.audioDeviceSelectionChanged")&&o("meeting.audioDeviceSelectionChanged"),t(n)};n(l(u,"meeting.requestAppAudioHandling"),"meeting.requestAppAudioHandling",[e.isAppHandlingAudio],i)}(t,s)}function U(e){F(e,m.AppInitiated)}function F(e,t){r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.setMicStateWithReason"),"meeting.updateMicState",[e,t])}!function(e){e[e.HostInitiated=0]="HostInitiated",e[e.AppInitiated=1]="AppInitiated",e[e.AppDeclinedToChange=2]="AppDeclinedToChange",e[e.AppFailedToChange=3]="AppFailedToChange"}(m||(m={})),function(e){e.like="like",e.heart="heart",e.laugh="laugh",e.surprised="surprised",e.applause="applause"}(p||(p={})),function(e){e.Unknown="Unknown",e.Adhoc="Adhoc",e.Scheduled="Scheduled",e.Recurring="Recurring",e.Broadcast="Broadcast",e.MeetNow="MeetNow"}(h||(h={})),function(e){e.OneOnOneCall="oneOnOneCall",e.GroupCall="groupCall"}(C||(C={})),function(e){e.Collaborative="Collaborative",e.ScreenShare="ScreenShare"}(S||(S={})),function(e){e.M365CalendarGridContextMenu="m365_calendar_grid_context_menu",e.M365CalendarGridPeek="m365_calendar_grid_peek",e.M365CalendarGridEventCardJoinButton="m365_calendar_grid_event_card_join_button",e.M365CalendarFormRibbonJoinButton="m365_calendar_form_ribbon_join_button",e.M365CalendarFormJoinTeamsMeetingButton="m365_calendar_form_join_teams_meeting_button",e.Other="other"}(f||(f={}));export{C as CallType,f as EventActionSource,p as MeetingReactionType,h as MeetingType,S as SharingProtocol,j as getAppContentStageSharingCapabilities,T as getAppContentStageSharingState,H as getAuthenticationTokenForAnonymousUser,b as getIncomingClientAudioState,k as getLiveStreamState,w as getMeetingDetails,v as getMeetingDetailsVerbose,R as joinMeeting,E as registerLiveStreamChangedHandler,O as registerMeetingReactionReceivedHandler,y as registerRaiseHandStateChangedHandler,D as registerSpeakingStateChangeHandler,I as requestAppAudioHandling,_ as requestStartLiveStreaming,M as requestStopLiveStreaming,P as shareAppContentToStage,q as stopSharingAppContentToStage,A as toggleIncomingClientAudio,U as updateMicState};
+import{__awaiter as e}from"../../../../../node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.55.1_tslib@2.8.1_typescript@4.9.5/node_modules/tslib/tslib.es6.js";import{sendMessageToParent as n,sendAndHandleSdkError as t}from"../../internal/communication.js";import{registerHandler as i,doesHandlerExist as a,removeHandler as o}from"../../internal/handlers.js";import{ensureInitialized as r}from"../../internal/internalAPIs.js";import{getApiVersionTag as l}from"../../internal/telemetry.js";import{FrameContexts as g}from"../constants.js";import{ErrorCode as s}from"../interfaces.js";import{runtime as d}from"../runtime.js";import*as c from"./appShareButton.js";export{c as appShareButton};const u="v1";var m,p,h,C,S,f;function b(e){if(!e)throw new Error("[get incoming client audio state] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.getIncomingClientAudioState"),"getIncomingClientAudioState",e)}function A(e){if(!e)throw new Error("[toggle incoming client audio] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.toggleIncomingClientAudio"),"toggleIncomingClientAudio",e)}function w(e){if(!e)throw new Error("[get meeting details] Callback cannot be null");r(d,g.sidePanel,g.meetingStage,g.settings,g.content),n(l(u,"meeting.getMeetingDetails"),"meeting.getMeetingDetails",e)}function v(){var n,i,a;return e(this,void 0,void 0,function*(){let e;r(d,g.sidePanel,g.meetingStage,g.settings,g.content);try{const n=!0;e=yield t(l("v2","meeting.getMeetingDetailsVerbose"),"meeting.getMeetingDetails",n)}catch(e){throw new Error(null===(n=null==e?void 0:e.errorCode)||void 0===n?void 0:n.toString())}if(((null===(i=e.details)||void 0===i?void 0:i.type)==C.GroupCall||(null===(a=e.details)||void 0===a?void 0:a.type)==C.OneOnOneCall)&&!e.details.originalCallerInfo)throw new Error(s.NOT_SUPPORTED_ON_PLATFORM.toString());return e})}function H(e){if(!e)throw new Error("[get Authentication Token For AnonymousUser] Callback cannot be null");r(d,g.sidePanel,g.meetingStage,g.task),n(l(u,"meeting.getAuthenticationTokenForAnonymousUser"),"meeting.getAuthenticationTokenForAnonymousUser",e)}function _(e){if(!e)throw new Error("[get live stream state] Callback cannot be null");r(d,g.sidePanel),n(l(u,"meeting.getLiveStreamState"),"meeting.getLiveStreamState",e)}function k(e,t,i){if(!e)throw new Error("[request start live streaming] Callback cannot be null");r(d,g.sidePanel),n(l(u,"meeting.requestStartLiveStreaming"),"meeting.requestStartLiveStreaming",[t,i],e)}function M(e){if(!e)throw new Error("[request stop live streaming] Callback cannot be null");r(d,g.sidePanel),n(l(u,"meeting.requestStopLiveStreaming"),"meeting.requestStopLiveStreaming",e)}function E(e){if(!e)throw new Error("[register live stream changed handler] Handler cannot be null");r(d,g.sidePanel),i(l(u,"meeting.registerLiveStreamChangedHandler"),"meeting.liveStreamChanged",e)}function P(e,t,i={sharingProtocol:S.Collaborative}){if(!e)throw new Error("[share app content to stage] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.shareAppContentToStage"),"meeting.shareAppContentToStage",[t,i],e)}function j(e){if(!e)throw new Error("[get app content stage sharing capabilities] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.getAppContentStageSharingCapabilities"),"meeting.getAppContentStageSharingCapabilities",e)}function q(e){if(!e)throw new Error("[stop sharing app content to stage] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.stopSharingAppContentToStage"),"meeting.stopSharingAppContentToStage",e)}function T(e){if(!e)throw new Error("[get app content stage sharing state] Callback cannot be null");r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.getAppContentStageSharingState"),"meeting.getAppContentStageSharingState",e)}function D(e){if(!e)throw new Error("[registerSpeakingStateChangeHandler] Handler cannot be null");r(d,g.sidePanel,g.meetingStage),i(l(u,"meeting.registerSpeakingStateChangeHandler"),"meeting.speakingStateChanged",e)}function y(e){if(!e)throw new Error("[registerRaiseHandStateChangedHandler] Handler cannot be null");r(d,g.sidePanel,g.meetingStage),i(l(u,"meeting.registerRaiseHandStateChangedHandler"),"meeting.raiseHandStateChanged",e)}function O(e){if(!e)throw new Error("[registerMeetingReactionReceivedHandler] Handler cannot be null");r(d,g.sidePanel,g.meetingStage),i(l(u,"meeting.registerMeetingReactionReceivedHandler"),"meeting.meetingReactionReceived",e)}function R(e){if(void 0===(null==e?void 0:e.joinWebUrl)||null===(null==e?void 0:e.joinWebUrl))return Promise.reject(new Error("Invalid joinMeetingParams"));r(d);const n={joinWebUrl:e.joinWebUrl.href,source:e.source||f.Other};return t(l("v2","meeting.joinMeeting"),"meeting.joinMeeting",n)}function I(t,s){if(!s)throw new Error("[requestAppAudioHandling] Callback response cannot be null");if(!t.micMuteStateChangedCallback)throw new Error("[requestAppAudioHandling] Callback Mic mute state handler cannot be null");r(d,g.sidePanel,g.meetingStage),t.isAppHandlingAudio?function(t,a){const o=(n,o)=>{if(n&&null!=o)throw new Error("[requestAppAudioHandling] Callback response - both parameters cannot be set");if(n)throw new Error(`[requestAppAudioHandling] Callback response - SDK error ${n.errorCode} ${n.message}`);if("boolean"!=typeof o)throw new Error("[requestAppAudioHandling] Callback response - isHostAudioless must be a boolean");const r=n=>e(this,void 0,void 0,function*(){try{const e=yield t.micMuteStateChangedCallback(n);F(e,e.isMicMuted===n.isMicMuted?m.HostInitiated:m.AppDeclinedToChange)}catch(e){F(n,m.AppFailedToChange)}});i(l(u,"meeting.registerMicStateChangeHandler"),"meeting.micStateChanged",r);const g=e=>{var n;null===(n=t.audioDeviceSelectionChangedCallback)||void 0===n||n.call(t,e)};i(l(u,"meeting.registerAudioDeviceSelectionChangedHandler"),"meeting.audioDeviceSelectionChanged",g),a(o)};n(l(u,"meeting.requestAppAudioHandling"),"meeting.requestAppAudioHandling",[t.isAppHandlingAudio],o)}(t,s):function(e,t){const i=(e,n)=>{if(e&&null!=n)throw new Error("[requestAppAudioHandling] Callback response - both parameters cannot be set");if(e)throw new Error(`[requestAppAudioHandling] Callback response - SDK error ${e.errorCode} ${e.message}`);if("boolean"!=typeof n)throw new Error("[requestAppAudioHandling] Callback response - isHostAudioless must be a boolean");a("meeting.micStateChanged")&&o("meeting.micStateChanged"),a("meeting.audioDeviceSelectionChanged")&&o("meeting.audioDeviceSelectionChanged"),t(n)};n(l(u,"meeting.requestAppAudioHandling"),"meeting.requestAppAudioHandling",[e.isAppHandlingAudio],i)}(t,s)}function U(e){F(e,m.AppInitiated)}function F(e,t){r(d,g.sidePanel,g.meetingStage),n(l(u,"meeting.setMicStateWithReason"),"meeting.updateMicState",[e,t])}!function(e){e[e.HostInitiated=0]="HostInitiated",e[e.AppInitiated=1]="AppInitiated",e[e.AppDeclinedToChange=2]="AppDeclinedToChange",e[e.AppFailedToChange=3]="AppFailedToChange"}(m||(m={})),function(e){e.like="like",e.heart="heart",e.laugh="laugh",e.surprised="surprised",e.applause="applause"}(p||(p={})),function(e){e.Unknown="Unknown",e.Adhoc="Adhoc",e.Scheduled="Scheduled",e.Recurring="Recurring",e.Broadcast="Broadcast",e.MeetNow="MeetNow"}(h||(h={})),function(e){e.OneOnOneCall="oneOnOneCall",e.GroupCall="groupCall"}(C||(C={})),function(e){e.Collaborative="Collaborative",e.ScreenShare="ScreenShare"}(S||(S={})),function(e){e.M365CalendarGridContextMenu="m365_calendar_grid_context_menu",e.M365CalendarGridPeek="m365_calendar_grid_peek",e.M365CalendarGridEventCardJoinButton="m365_calendar_grid_event_card_join_button",e.M365CalendarFormRibbonJoinButton="m365_calendar_form_ribbon_join_button",e.M365CalendarFormJoinTeamsMeetingButton="m365_calendar_form_join_teams_meeting_button",e.M365CalendarMeetNow="m365_calendar_meet_now",e.Other="other"}(f||(f={}));export{C as CallType,f as EventActionSource,p as MeetingReactionType,h as MeetingType,S as SharingProtocol,j as getAppContentStageSharingCapabilities,T as getAppContentStageSharingState,H as getAuthenticationTokenForAnonymousUser,b as getIncomingClientAudioState,_ as getLiveStreamState,w as getMeetingDetails,v as getMeetingDetailsVerbose,R as joinMeeting,E as registerLiveStreamChangedHandler,O as registerMeetingReactionReceivedHandler,y as registerRaiseHandStateChangedHandler,D as registerSpeakingStateChangeHandler,I as requestAppAudioHandling,k as requestStartLiveStreaming,M as requestStopLiveStreaming,P as shareAppContentToStage,q as stopSharingAppContentToStage,A as toggleIncomingClientAudio,U as updateMicState};

package/dist/esm/packages/teams-js/src/public/mouseRelay.js

@@ -0,0 +1 @@
+import{__awaiter as t}from"../../../../node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.55.1_tslib@2.8.1_typescript@4.9.5/node_modules/tslib/tslib.es6.js";import{callFunctionInHost as e}from"../internal/communication.js";import{ensureInitialized as o}from"../internal/internalAPIs.js";import{getApiVersionTag as n}from"../internal/telemetry.js";import{errorNotSupportedOnPlatform as r}from"./constants.js";import{runtime as i}from"./runtime.js";class u{constructor(t){this.direction=t}serialize(){return{direction:this.direction}}}function s(t){return 3===t?"back":4===t?"forward":void 0}function m(t){void 0!==s(t.button)&&(t.preventDefault(),t.stopImmediatePropagation())}function a(t){const o=s(t.button);o&&(t.preventDefault(),t.stopImmediatePropagation(),e("mouseRelay.navigateHistory",[new u(o)],n("v2","mouseRelay.navigateHistory")))}let c=!1;function p(){return t(this,void 0,void 0,function*(){if(!l())throw r;c||(document.addEventListener("mousedown",m,{capture:!0}),document.addEventListener("mouseup",a,{capture:!0}),document.addEventListener("auxclick",m,{capture:!0})),c=!0})}function d(){if(!l())throw r;c=!1,document.removeEventListener("mousedown",m,{capture:!0}),document.removeEventListener("mouseup",a,{capture:!0}),document.removeEventListener("auxclick",m,{capture:!0})}function l(){return!(!o(i)||!i.supports.mouseRelay)}export{d as disableMouseRelayCapability,p as enableMouseRelayCapability,l as isSupported};

package/dist/esm/packages/teams-js/src/public/version.js

@@ -1 +1 @@
-const o="2.53.1";export{o as version};
+const o="2.54.0";export{o as version};

package/dist/umd/MicrosoftTeams.js

@@ -1059,6 +1059,7 @@ __webpack_require__.d(__webpack_exports__, {
   menus: () => (/* reexport */ menus_namespaceObject),
   messageChannels: () => (/* reexport */ messageChannels_namespaceObject),
   monetization: () => (/* reexport */ monetization_namespaceObject),
+  mouseRelay: () => (/* reexport */ mouseRelay_namespaceObject),
   navigateBack: () => (/* reexport */ navigation_navigateBack),
   navigateCrossDomain: () => (/* reexport */ navigation_navigateCrossDomain),
   navigateToTab: () => (/* reexport */ navigation_navigateToTab),
@@ -2081,6 +2082,15 @@ __webpack_require__.d(marketplace_namespaceObject, {
   updateCartStatus: () => (updateCartStatus)
 });
 
+// NAMESPACE OBJECT: ./src/public/mouseRelay.ts
+var mouseRelay_namespaceObject = {};
+__webpack_require__.r(mouseRelay_namespaceObject);
+__webpack_require__.d(mouseRelay_namespaceObject, {
+  disableMouseRelayCapability: () => (disableMouseRelayCapability),
+  enableMouseRelayCapability: () => (enableMouseRelayCapability),
+  isSupported: () => (mouseRelay_isSupported)
+});
+
 // NAMESPACE OBJECT: ./src/public/shortcutRelay.ts
 var shortcutRelay_namespaceObject = {};
 __webpack_require__.r(shortcutRelay_namespaceObject);
@@ -2294,7 +2304,17 @@ var EduType;
     EduType["Other"] = "other";
 })(EduType || (EduType = {}));
 /**
- * Currently supported Mime type
+ * Currently supported MIME types
+ *
+ * @deprecated
+ * As of TeamsJS v2.54.0, the clipboard capability is deprecated. These APIs may stop working at
+ * any time without notice: support for this capability in Teams and other host apps may be removed
+ * entirely and independently of a TeamsJS major release, so continued functionality is not
+ * guaranteed. The intended long-term replacement is the standardized Clipboard API provided by the
+ * browser ({@link https://developer.mozilla.org/docs/Web/API/Clipboard_API | Clipboard API}, `navigator.clipboard`).
+ * Note that using the browser-native Clipboard API directly within Teams hosts is not yet fully
+ * supported; it depends on native device permission handling that is still being enabled as a
+ * separate effort.
  */
 var ClipboardSupportedMimeType;
 (function (ClipboardSupportedMimeType) {
@@ -4674,7 +4694,7 @@ function isSerializable(arg) {
  * @hidden
  *  Package version.
  */
-const version = "2.53.1";
+const version = "2.54.0";
 
 ;// ./src/public/featureFlags.ts
 // All build feature flags are defined inside this object. Any build feature flag must have its own unique getter and setter function. This pattern allows for client apps to treeshake unused code and avoid including code guarded by this feature flags in the final bundle. If this property isn't desired, use the below runtime feature flags object.
@@ -16123,6 +16143,16 @@ function chat_isSupported() {
 /**
  * Interact with the system clipboard
  *
+ * @deprecated
+ * As of TeamsJS v2.54.0, the clipboard capability is deprecated. These APIs may stop working at
+ * any time without notice: support for this capability in Teams and other host apps may be removed
+ * entirely and independently of a TeamsJS major release, so continued functionality is not
+ * guaranteed. The intended long-term replacement is the standardized Clipboard API provided by the
+ * browser ({@link https://developer.mozilla.org/docs/Web/API/Clipboard_API | Clipboard API}, `navigator.clipboard`).
+ * Note that using the browser-native Clipboard API directly within Teams hosts is not yet fully
+ * supported; it depends on native device permission handling that is still being enabled as a
+ * separate effort.
+ *
  * @beta
  * @module
  */
@@ -16149,6 +16179,17 @@ var clipboard_awaiter = (undefined && undefined.__awaiter) || function (thisArg,
 const clipboardTelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
 /**
  * Function to copy data to clipboard.
+ *
+ * @deprecated
+ * As of TeamsJS v2.54.0, the clipboard capability is deprecated. These APIs may stop working at
+ * any time without notice: support for this capability in Teams and other host apps may be removed
+ * entirely and independently of a TeamsJS major release, so continued functionality is not
+ * guaranteed. The intended long-term replacement is the standardized Clipboard API provided by the
+ * browser ({@link https://developer.mozilla.org/docs/Web/API/Clipboard_API | Clipboard API}, `navigator.clipboard`).
+ * Note that using the browser-native Clipboard API directly within Teams hosts is not yet fully
+ * supported; it depends on native device permission handling that is still being enabled as a
+ * separate effort.
+ *
  * @remarks
  * Note: clipboard.write only supports Text, HTML, PNG, and JPEG data format.
  *       MIME type for Text -> `text/plain`, HTML -> `text/html`, PNG/JPEG -> `image/(png | jpeg)`
@@ -16178,6 +16219,16 @@ function write(blob) {
 /**
  * Function to read data from clipboard.
  *
+ * @deprecated
+ * As of TeamsJS v2.54.0, the clipboard capability is deprecated. These APIs may stop working at
+ * any time without notice: support for this capability in Teams and other host apps may be removed
+ * entirely and independently of a TeamsJS major release, so continued functionality is not
+ * guaranteed. The intended long-term replacement is the standardized Clipboard API provided by the
+ * browser ({@link https://developer.mozilla.org/docs/Web/API/Clipboard_API | Clipboard API}, `navigator.clipboard`).
+ * Note that using the browser-native Clipboard API directly within Teams hosts is not yet fully
+ * supported; it depends on native device permission handling that is still being enabled as a
+ * separate effort.
+ *
  * @returns A promise blob which resolves to the data read from the clipboard or
  *          rejects stating the reason for failure.
  *          Note: Returned blob type will contain one of the MIME type `image/png`, `text/plain` or `text/html`.
@@ -16205,6 +16256,16 @@ function read() {
  *
  * @throws Error if {@linkcode app.initialize} has not successfully completed
  *
+ * @deprecated
+ * As of TeamsJS v2.54.0, the clipboard capability is deprecated. These APIs may stop working at
+ * any time without notice: support for this capability in Teams and other host apps may be removed
+ * entirely and independently of a TeamsJS major release, so continued functionality is not
+ * guaranteed. The intended long-term replacement is the standardized Clipboard API provided by the
+ * browser ({@link https://developer.mozilla.org/docs/Web/API/Clipboard_API | Clipboard API}, `navigator.clipboard`).
+ * Note that using the browser-native Clipboard API directly within Teams hosts is not yet fully
+ * supported; it depends on native device permission handling that is still being enabled as a
+ * separate effort.
+ *
  * @beta
  */
 function clipboard_isSupported() {
@@ -17409,6 +17470,10 @@ var EventActionSource;
      * Source is calendar form join teams meeting button.
      */
     EventActionSource["M365CalendarFormJoinTeamsMeetingButton"] = "m365_calendar_form_join_teams_meeting_button";
+    /**
+     * Source is the M365 calendar Meet Now start action.
+     */
+    EventActionSource["M365CalendarMeetNow"] = "m365_calendar_meet_now";
     /**
      * Other sources.
      */
@@ -20353,6 +20418,138 @@ function marketplace_isSupported() {
     return ensureInitialized(runtime) && runtime.supports.marketplace ? true : false;
 }
 
+;// ./src/public/mouseRelay.ts
+/**
+ * Lets an app inside a Teams iframe relay the mouse back (X1) / forward (X2)
+ * buttons to the host so they drive Teams history navigation.
+ *
+ * @module
+ */
+var mouseRelay_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());
+    });
+};
+
+
+
+
+
+/* ------------------------------------------------------------------ */
+/* Utils                                                              */
+/* ------------------------------------------------------------------ */
+/** `MouseEvent.button` value for the back (X1) button. */
+const MOUSE_BUTTON_BACK = 3;
+/** `MouseEvent.button` value for the forward (X2) button. */
+const MOUSE_BUTTON_FORWARD = 4;
+class SerializableNavigationIntent {
+    constructor(direction) {
+        this.direction = direction;
+    }
+    serialize() {
+        return { direction: this.direction };
+    }
+}
+/**
+ * Maps a `MouseEvent.button` value to a navigation direction, or `undefined`
+ * for any button other than the back (X1) / forward (X2) buttons.
+ */
+function directionForButton(button) {
+    if (button === MOUSE_BUTTON_BACK) {
+        return 'back';
+    }
+    if (button === MOUSE_BUTTON_FORWARD) {
+        return 'forward';
+    }
+    return undefined;
+}
+/**
+ * Suppress the iframe's own native X1/X2 history navigation (and the synthetic
+ * `click`). Attached to `mousedown` (earliest, most reliable) and `auxclick`;
+ * never relays.
+ */
+function suppressX1X2(event) {
+    if (directionForButton(event.button) !== undefined) {
+        event.preventDefault();
+        event.stopImmediatePropagation();
+    }
+}
+/**
+ * Relay the back/forward intent to the host on `mouseup` (release), matching
+ * the browser's native timing so press-and-hold does nothing until release.
+ */
+function mouseupHandler(event) {
+    const direction = directionForButton(event.button);
+    if (!direction) {
+        return; // not the back/forward button
+    }
+    event.preventDefault();
+    event.stopImmediatePropagation();
+    callFunctionInHost("mouseRelay.navigateHistory" /* ApiName.MouseRelay_NavigateHistory */, [new SerializableNavigationIntent(direction)], getApiVersionTag("v2" /* ApiVersionNumber.V_2 */, "mouseRelay.navigateHistory" /* ApiName.MouseRelay_NavigateHistory */));
+}
+/* ------------------------------------------------------------------ */
+/* In-memory                                                          */
+/* ------------------------------------------------------------------ */
+/**
+ * @hidden
+ * @internal
+ * Flag to indicate the mouse relay capability has been enabled, so that we do
+ * not register the event listeners multiple times.
+ */
+let isMouseRelayCapabilityEnabled = false;
+/* ------------------------------------------------------------------ */
+/* API                                                                */
+/* ------------------------------------------------------------------ */
+/**
+ * Enable the capability so the mouse back (X1) / forward (X2) buttons pressed
+ * inside this iframe drive Teams history navigation in the host.
+ *
+ * @throws Error if {@link app.initialize} has not successfully completed or the
+ * host does not support the mouseRelay capability.
+ */
+function enableMouseRelayCapability() {
+    return mouseRelay_awaiter(this, void 0, void 0, function* () {
+        if (!mouseRelay_isSupported()) {
+            throw errorNotSupportedOnPlatform;
+        }
+        if (!isMouseRelayCapabilityEnabled) {
+            document.addEventListener('mousedown', suppressX1X2, { capture: true });
+            document.addEventListener('mouseup', mouseupHandler, { capture: true });
+            document.addEventListener('auxclick', suppressX1X2, { capture: true });
+        }
+        isMouseRelayCapabilityEnabled = true;
+    });
+}
+/**
+ * Disable the mouse relay capability, detaching its listeners so the mouse
+ * back (X1) / forward (X2) buttons no longer drive Teams history navigation.
+ *
+ * @throws Error if {@link app.initialize} has not successfully completed or the
+ * host does not support the mouseRelay capability.
+ */
+function disableMouseRelayCapability() {
+    if (!mouseRelay_isSupported()) {
+        throw errorNotSupportedOnPlatform;
+    }
+    isMouseRelayCapabilityEnabled = false;
+    document.removeEventListener('mousedown', suppressX1X2, { capture: true });
+    document.removeEventListener('mouseup', mouseupHandler, { capture: true });
+    document.removeEventListener('auxclick', suppressX1X2, { capture: true });
+}
+/**
+ * Checks if the mouseRelay capability is supported by the host.
+ * @returns boolean to represent whether the mouseRelay capability is supported.
+ *
+ * @throws Error if {@link app.initialize} has not successfully completed.
+ */
+function mouseRelay_isSupported() {
+    return ensureInitialized(runtime) && runtime.supports.mouseRelay ? true : false;
+}
+
 ;// ./src/public/shortcutRelay.ts
 /**
  * Allows host shortcuts to function in your application by forwarding keyboard shortcuts to the host.
@@ -20695,6 +20892,8 @@ const DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE = 'data-disable-shortcuts-forwarding
 
 
 
+
+
 
 ;// ./src/index.ts