@microsoft/teams-js 2.34.0-beta.0 → 2.34.0-beta.1

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

@@ -152,6 +152,7 @@ export declare const enum ApiName {
     Logs_Receive = "log.receive",
     Logs_RegisterLogRequestHandler = "log.request",
     Mail_ComposeMail = "mail.composeMail",
+    Mail_Handoff_ComposeMail = "mail.handoff.composeMail",
     Mail_OpenMailItem = "mail.openMailItem",
     Marketplace_AddOrUpdateCartItems = "marketplace.addOrUpdateCartItems",
     Marketplace_GetCart = "marketplace.getCart",

package/dist/esm/packages/teams-js/dts/private/copilot/customTelemetry.d.ts

@@ -7,6 +7,16 @@
  * @module
  */
 import { UUID } from '../../public/uuidObject';
+/**
+ * @hidden
+ * @internal
+ * Limited to Microsoft-internal use
+ * @beta
+ * @returns boolean to represent whether copilot.customTelemetry capability is supported
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ */
+export declare function isSupported(): boolean;
 /**
  * Sends custom telemetry data to the host.
  *

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

@@ -32,7 +32,7 @@ export declare function registerAuthenticationHandlers(authenticateParameters: A
  *
  * @remarks
  * The authentication flow must start and end from the same domain, otherwise success and failure messages won't be returned to the window that initiated the call.
- * The [Teams authentication flow](https://learn.microsoft.com/microsoftteams/platform/tabs/how-to/authentication/auth-flow-tab) starts and ends at an endpoint on
+ * The [authentication flow](https://learn.microsoft.com/microsoftteams/platform/tabs/how-to/authentication/auth-flow-tab) starts and ends at an endpoint on
  * your own service (with a redirect round-trip to the 3rd party identity provider in the middle).
  *
  * @param authenticateParameters - Parameters describing the authentication window used for executing the authentication flow
@@ -116,16 +116,24 @@ export declare function getUser(): Promise<UserProfile>;
 export declare function getUser(userRequest: UserRequest): void;
 /**
  * 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
+ * window that was opened to execute the authentication flow should call this method after authentication 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.
+ * The `result` parameter should **never** contain the token that was received from the identity provider, because a malicious app (rather than your own app) might have opened
+ * the authentication window. If that was the case, passing the token in this parameter would leak it to them. More secure methods for completing the authentication flow include:
+ * - For a purely browser-based experience (e.g., a personal app/tab app), you could store the token in browser local storage and then have your personal app retrieve it once
+ * this `notifySuccess` call is received.
+ * - For a server-based experience (e.g., a message extension), your authentication window could store the token on your service and then generate a unique code passed via this
+ * `result` parameter. The caller can then use the unique code to retrieve the token from your service.
+ *
+ * This function is usable only from an authentication window opened with {@link authentication.authenticate authentication.authenticate(authenticateParameters: AuthenticatePopUpParameters): Promise\<string\>}.
  * 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
+ * this value in its callback or via the `Promise` return value.
+ *
  */
 export declare function notifySuccess(result?: string): void;
 /**

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

@@ -22,7 +22,7 @@ export * as location from './location';
 export * as meeting from './meeting/meeting';
 export * as monetization from './monetization';
 export * as calendar from './calendar';
-export * as mail from './mail';
+export * as mail from './mail/mail';
 export * as teamsCore from './teamsAPIs';
 export * as people from './people';
 export * as profile from './profile';

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

@@ -0,0 +1,48 @@
+/**
+ * Used to interact with mail capability, including opening and composing mail.
+ * @module
+ *
+ * @beta
+ */
+import { ComposeMailParams } from './mail';
+/**
+ * Extended parameters for {@link composeMail}, including support for external handoff.
+ *
+ * This interface wraps {@link ComposeMailParamsWithHandoff} to provide additional functionality for scenarios
+ * where an external handoff is needed, such as transferring a draft email created in BizChat.
+ *
+ * @see {@link ComposeNewParams} for parameters when composing a new mail item.
+ * @see {@link ComposeReplyOrForwardParams} for reply or forward-specific parameters.
+ * @see {@link ComposeMailType} for supported mail operation types.
+ *
+ * @beta
+ */
+export interface ComposeMailParamsWithHandoff {
+    /**
+     * Base parameters for composing a mail item.
+     */
+    composeMailParams: ComposeMailParams;
+    /**
+     * Use this endpoint to retrieve the handoff payload when BizChat creates an email draft for external handoff.
+     */
+    handoffId: string;
+}
+/**
+ * Compose a new email in the user's mailbox, opening it in the drafts UX instead of the standard email.
+ *
+ * @param composeMailParamsWithHandoff - Object that specifies the type of mail item to compose and the details of the mail item.
+ * @returns { Promise<void> } - promise resolves after the compose window has opened successfully in host SDK.
+ * @throws Error with a message describing whether the capability is not initialized or the input is invalid.
+ *
+ * @beta
+ */
+export declare function composeMailWithHandoff(composeMailParamsWithHandoff: ComposeMailParamsWithHandoff): Promise<void>;
+/**
+ * Checks if the mail capability and handoff sub-capability is supported by the host
+ * @returns boolean to represent whether the handoff sub-capability is supported
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ *
+ * @beta
+ */
+export declare function isSupported(): boolean;

package/dist/esm/packages/teams-js/dts/public/{mail.d.ts → mail/mail.d.ts}

@@ -2,6 +2,7 @@
  * Used to interact with mail capability, including opening and composing mail.
  * @module
  */
+import * as handoff from './handoff';
 /**
  * Opens a mail message in the host.
  *
@@ -86,9 +87,11 @@ export interface ComposeReplyOrForwardParams<T extends ComposeMailType> extends
 /**
  * Parameters supplied to {@link composeMail} when composing a new mail item
  *
+ * For ComposeMailType.New, it is valid to pass empty arrays for toRecipients, ccRecipients, and bccRecipients.
+ * This will result in a new email with (pre-populated) body content but no pre-populated recipients.
  * @see {@link ComposeNewParams}
  * @see {@link ComposeReplyOrForwardParams}
  * @see {@link ComposeMailType}
  */
 export type ComposeMailParams = ComposeNewParams | ComposeReplyOrForwardParams<ComposeMailType.Reply> | ComposeReplyOrForwardParams<ComposeMailType.ReplyAll> | ComposeReplyOrForwardParams<ComposeMailType.Forward>;
-export {};
+export { handoff };

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

@@ -57,7 +57,9 @@ interface IRuntimeV4 extends IBaseRuntime {
         readonly secondaryBrowser?: {};
         readonly location?: {};
         readonly logs?: {};
-        readonly mail?: {};
+        readonly mail?: {
+            readonly handoff?: {};
+        };
         readonly marketplace?: {};
         readonly meetingRoom?: {};
         readonly menus?: {};

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 r from"./private/logs.js";export{r as logs};import*as e from"./private/conversations.js";export{e as conversations};import*as o from"./private/copilot/copilot.js";export{o as copilot};import*as t from"./private/externalAppAuthentication.js";export{t as externalAppAuthentication};import*as p from"./private/externalAppAuthenticationForCEA.js";export{p as externalAppAuthenticationForCEA};import*as i from"./private/externalAppCardActions.js";export{i as externalAppCardActions};import*as s from"./private/externalAppCardActionsForCEA.js";export{s as externalAppCardActionsForCEA};import*as a from"./private/externalAppCommands.js";export{a as externalAppCommands};import*as m from"./private/files.js";export{m as files};import*as n from"./private/meetingRoom.js";export{n as meetingRoom};import*as l from"./private/messageChannels/messageChannels.js";export{l as messageChannels};import*as c from"./private/notifications.js";export{c as notifications};import*as f from"./private/otherAppStateChange.js";export{f as otherAppStateChange};import*as x from"./private/remoteCamera.js";export{x as remoteCamera};import*as u from"./private/appEntity.js";export{u as appEntity};import*as j from"./private/teams/teams.js";export{j as teams};import*as b from"./private/videoEffectsEx.js";export{b as videoEffectsEx};import*as d from"./private/hostEntity/hostEntity.js";export{d as hostEntity};import*as g from"./private/store.js";export{g as store};export{ChannelType,DialogDimension,FrameContexts,HostClientType,HostName,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{getAdaptiveCardSchemaVersion}from"./public/adaptiveCards.js";export{ChildAppWindow,ParentAppWindow}from"./public/appWindow.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 v from"./public/liveShareHost.js";export{v as liveShare};export{LiveShareHost}from"./public/liveShareHost.js";import*as C from"./public/authentication.js";export{C as authentication};import*as A from"./public/app/app.js";export{A as app};import*as h from"./public/appInstallDialog.js";export{h as appInstallDialog};import*as H from"./public/barCode.js";export{H as barCode};import*as T from"./public/chat.js";export{T as chat};import*as y from"./public/clipboard.js";export{y as clipboard};import*as E from"./public/dialog/dialog.js";export{E as dialog};import*as S from"./public/nestedAppAuth.js";export{S as nestedAppAuth};import*as I from"./public/geoLocation/geoLocation.js";export{I as geoLocation};import*as D from"./public/pages/pages.js";export{D as pages};import*as F from"./public/menus.js";export{F as menus};import*as w from"./public/media.js";export{w as media};import*as k from"./public/secondaryBrowser.js";export{k as secondaryBrowser};import*as B from"./public/location.js";export{B as location};import*as P from"./public/meeting/meeting.js";export{P as meeting};import*as L from"./public/monetization.js";export{L as monetization};import*as M from"./public/calendar.js";export{M as calendar};import*as U from"./public/mail.js";export{U as mail};import*as O from"./public/teamsAPIs.js";export{O as teamsCore};import*as z from"./public/people.js";export{z as people};import*as V from"./public/profile.js";export{V as profile};import*as W from"./public/videoEffects.js";export{W as videoEffects};import*as N from"./public/search.js";export{N as search};import*as R from"./public/sharing/sharing.js";export{R as sharing};import*as q from"./public/stageView/stageView.js";export{q as stageView};import*as G from"./public/visualMedia/visualMedia.js";export{G as visualMedia};import*as J from"./public/webStorage.js";export{J as webStorage};import*as K from"./public/call.js";export{K as call};import*as Q from"./public/appInitialization.js";export{Q as appInitialization};import*as X from"./public/thirdPartyCloudStorage.js";export{X as thirdPartyCloudStorage};import*as Y from"./public/settings.js";export{Y as settings};import*as Z from"./public/tasks.js";export{Z as tasks};import*as $ from"./public/marketplace.js";export{$ as marketplace};
+export{NotificationTypes,UserSettingTypes,ViewerActionTypes}from"./private/interfaces.js";export{openFilePreview,registerCustomHandler,registerUserSettingsChangeHandler,sendCustomEvent,sendCustomMessage,uploadCustomApp}from"./private/privateAPIs.js";import*as r from"./private/logs.js";export{r as logs};import*as e from"./private/conversations.js";export{e as conversations};import*as o from"./private/copilot/copilot.js";export{o as copilot};import*as t from"./private/externalAppAuthentication.js";export{t as externalAppAuthentication};import*as p from"./private/externalAppAuthenticationForCEA.js";export{p as externalAppAuthenticationForCEA};import*as i from"./private/externalAppCardActions.js";export{i as externalAppCardActions};import*as s from"./private/externalAppCardActionsForCEA.js";export{s as externalAppCardActionsForCEA};import*as a from"./private/externalAppCommands.js";export{a as externalAppCommands};import*as m from"./private/files.js";export{m as files};import*as n from"./private/meetingRoom.js";export{n as meetingRoom};import*as l from"./private/messageChannels/messageChannels.js";export{l as messageChannels};import*as c from"./private/notifications.js";export{c as notifications};import*as f from"./private/otherAppStateChange.js";export{f as otherAppStateChange};import*as x from"./private/remoteCamera.js";export{x as remoteCamera};import*as u from"./private/appEntity.js";export{u as appEntity};import*as j from"./private/teams/teams.js";export{j as teams};import*as b from"./private/videoEffectsEx.js";export{b as videoEffectsEx};import*as d from"./private/hostEntity/hostEntity.js";export{d as hostEntity};import*as g from"./private/store.js";export{g as store};export{ChannelType,DialogDimension,FrameContexts,HostClientType,HostName,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{getAdaptiveCardSchemaVersion}from"./public/adaptiveCards.js";export{ChildAppWindow,ParentAppWindow}from"./public/appWindow.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 v from"./public/liveShareHost.js";export{v as liveShare};export{LiveShareHost}from"./public/liveShareHost.js";import*as C from"./public/authentication.js";export{C as authentication};import*as A from"./public/app/app.js";export{A as app};import*as h from"./public/appInstallDialog.js";export{h as appInstallDialog};import*as H from"./public/barCode.js";export{H as barCode};import*as T from"./public/chat.js";export{T as chat};import*as y from"./public/clipboard.js";export{y as clipboard};import*as E from"./public/dialog/dialog.js";export{E as dialog};import*as S from"./public/nestedAppAuth.js";export{S as nestedAppAuth};import*as I from"./public/geoLocation/geoLocation.js";export{I as geoLocation};import*as D from"./public/pages/pages.js";export{D as pages};import*as F from"./public/menus.js";export{F as menus};import*as w from"./public/media.js";export{w as media};import*as k from"./public/secondaryBrowser.js";export{k as secondaryBrowser};import*as B from"./public/location.js";export{B as location};import*as P from"./public/meeting/meeting.js";export{P as meeting};import*as L from"./public/monetization.js";export{L as monetization};import*as M from"./public/calendar.js";export{M as calendar};import*as U from"./public/mail/mail.js";export{U as mail};import*as O from"./public/teamsAPIs.js";export{O as teamsCore};import*as z from"./public/people.js";export{z as people};import*as V from"./public/profile.js";export{V as profile};import*as W from"./public/videoEffects.js";export{W as videoEffects};import*as N from"./public/search.js";export{N as search};import*as R from"./public/sharing/sharing.js";export{R as sharing};import*as q from"./public/stageView/stageView.js";export{q as stageView};import*as G from"./public/visualMedia/visualMedia.js";export{G as visualMedia};import*as J from"./public/webStorage.js";export{J as webStorage};import*as K from"./public/call.js";export{K as call};import*as Q from"./public/appInitialization.js";export{Q as appInitialization};import*as X from"./public/thirdPartyCloudStorage.js";export{X as thirdPartyCloudStorage};import*as Y from"./public/settings.js";export{Y as settings};import*as Z from"./public/tasks.js";export{Z as tasks};import*as $ from"./public/marketplace.js";export{$ as marketplace};

package/dist/esm/packages/teams-js/src/private/copilot/customTelemetry.js

@@ -1 +1 @@
-import{__awaiter as t}from"../../../../../node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.24.4_tslib@2.6.3_typescript@4.9.5/node_modules/tslib/tslib.es6.js";import{callFunctionInHost as o}from"../../internal/communication.js";import{ensureInitialized as e}from"../../internal/internalAPIs.js";import{getLogger as r,getApiVersionTag as i}from"../../internal/telemetry.js";import{getCurrentTimestamp as m}from"../../internal/utils.js";import{runtime as n}from"../../public/runtime.js";const s=r("copilot");function l(r,l){var p;return void 0===l&&(l=null!==(p=m())&&void 0!==p?p:Date.now()),t(this,void 0,void 0,(function*(){return e(n),s("Sending custom telemetry data to host for stage: %s to record timestamp: %s",r,l),o("copilot.customTelemetry.sendCustomTelemetryData",[r.toString(),l],i("v2","copilot.customTelemetry.sendCustomTelemetryData"))}))}export{l as sendCustomTelemetryData};
+import{__awaiter as t}from"../../../../../node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.24.4_tslib@2.6.3_typescript@4.9.5/node_modules/tslib/tslib.es6.js";import{callFunctionInHost as o}from"../../internal/communication.js";import{ensureInitialized as e}from"../../internal/internalAPIs.js";import{getLogger as r,getApiVersionTag as i}from"../../internal/telemetry.js";import{getCurrentTimestamp as n}from"../../internal/utils.js";import{runtime as m}from"../../public/runtime.js";const s=r("copilot");function l(){var t;return e(m)&&!!(null===(t=m.supports.copilot)||void 0===t?void 0:t.customTelemetry)}function p(r,l){var p;return void 0===l&&(l=null!==(p=n())&&void 0!==p?p:Date.now()),t(this,void 0,void 0,(function*(){return e(m),s("Sending custom telemetry data to host for stage: %s to record timestamp: %s",r,l),o("copilot.customTelemetry.sendCustomTelemetryData",[r.toString(),l],i("v2","copilot.customTelemetry.sendCustomTelemetryData"))}))}export{l as isSupported,p as sendCustomTelemetryData};

package/dist/esm/packages/teams-js/src/public/mail/handoff.js

@@ -0,0 +1 @@
+import{callFunctionInHost as o}from"../../internal/communication.js";import{validateEmailAddress as t}from"../../internal/emailAddressValidation.js";import{ensureInitialized as n}from"../../internal/internalAPIs.js";import{getApiVersionTag as r}from"../../internal/telemetry.js";import{FrameContexts as i}from"../constants.js";import{runtime as e}from"../runtime.js";import{ComposeMailType as a}from"./mail.js";function s(o){o&&0!==o.length&&o.forEach((o=>{t(o)}))}function m(t){if(n(e,i.content),!f())throw new Error("Not supported");return function(o){if(!o.handoffId||0==o.handoffId.trim().length||""===o.handoffId.trim())throw new Error("handoffId should not be null or empty string.");const t=o.composeMailParams;t.type===a.New&&(s(t.toRecipients),s(t.ccRecipients),s(t.bccRecipients))}(t),o("mail.handoff.composeMail",[new c(t)],r("v2","mail.handoff.composeMail"))}function f(){return!!(n(e)&&e.supports.mail&&e.supports.mail.handoff)}class c{constructor(o){this.composeMailParamsWithHandoff=o}serialize(){return this.composeMailParamsWithHandoff}}export{m as composeMailWithHandoff,f as isSupported};

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

@@ -0,0 +1 @@
+import{sendAndHandleStatusAndReason as r}from"../../internal/communication.js";import{ensureInitialized as o}from"../../internal/internalAPIs.js";import{getApiVersionTag as t}from"../../internal/telemetry.js";import{FrameContexts as e}from"../constants.js";import{runtime as n}from"../runtime.js";import*as i from"./handoff.js";export{i as handoff};function m(i){return new Promise((m=>{if(o(n,e.content),!l())throw new Error("Not supported");if(!i.itemId||!i.itemId.trim())throw new Error("Must supply an itemId to openMailItem");m(r(t("v2","mail.openMailItem"),"mail.openMailItem",i))}))}function p(i){return new Promise((m=>{if(o(n,e.content),!l())throw new Error("Not supported");m(r(t("v2","mail.composeMail"),"mail.composeMail",i))}))}function l(){return!(!o(n)||!n.supports.mail)}var a;!function(r){r.New="new",r.Reply="reply",r.ReplyAll="replyAll",r.Forward="forward"}(a||(a={}));export{a as ComposeMailType,p as composeMail,l as isSupported,m as openMailItem};

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

@@ -1 +1 @@
-const t="2.34.0-beta.0";export{t as version};
+const t="2.34.0-beta.1";export{t as version};

package/dist/umd/MicrosoftTeams.js

@@ -1353,6 +1353,7 @@ __webpack_require__.d(conversations_namespaceObject, {
 var customTelemetry_namespaceObject = {};
 __webpack_require__.r(customTelemetry_namespaceObject);
 __webpack_require__.d(customTelemetry_namespaceObject, {
+  isSupported: () => (customTelemetry_isSupported),
   sendCustomTelemetryData: () => (sendCustomTelemetryData)
 });
 
@@ -1771,12 +1772,21 @@ __webpack_require__.d(calendar_namespaceObject, {
   openCalendarItem: () => (openCalendarItem)
 });
 
-// NAMESPACE OBJECT: ./src/public/mail.ts
+// NAMESPACE OBJECT: ./src/public/mail/handoff.ts
+var handoff_namespaceObject = {};
+__webpack_require__.r(handoff_namespaceObject);
+__webpack_require__.d(handoff_namespaceObject, {
+  composeMailWithHandoff: () => (composeMailWithHandoff),
+  isSupported: () => (handoff_isSupported)
+});
+
+// NAMESPACE OBJECT: ./src/public/mail/mail.ts
 var mail_namespaceObject = {};
 __webpack_require__.r(mail_namespaceObject);
 __webpack_require__.d(mail_namespaceObject, {
   ComposeMailType: () => (ComposeMailType),
   composeMail: () => (composeMail),
+  handoff: () => (handoff_namespaceObject),
   isSupported: () => (mail_isSupported),
   openMailItem: () => (openMailItem)
 });
@@ -4460,7 +4470,7 @@ function isSerializable(arg) {
  * @hidden
  *  Package version.
  */
-const version = "2.34.0-beta.0";
+const version = "2.34.0-beta.1";
 
 ;// ./src/internal/internalAPIs.ts
 
@@ -9289,6 +9299,19 @@ var customTelemetry_awaiter = (undefined && undefined.__awaiter) || function (th
 
 const copilotTelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
 const copilotLogger = getLogger('copilot');
+/**
+ * @hidden
+ * @internal
+ * Limited to Microsoft-internal use
+ * @beta
+ * @returns boolean to represent whether copilot.customTelemetry capability is supported
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ */
+function customTelemetry_isSupported() {
+    var _a;
+    return ensureInitialized(runtime) && !!((_a = runtime.supports.copilot) === null || _a === void 0 ? void 0 : _a.customTelemetry);
+}
 /**
  * Sends custom telemetry data to the host.
  *
@@ -15559,20 +15582,116 @@ function calendar_isSupported() {
     return ensureInitialized(runtime) && runtime.supports.calendar ? true : false;
 }
 
-;// ./src/public/mail.ts
+;// ./src/public/mail/handoff.ts
 /**
  * Used to interact with mail capability, including opening and composing mail.
  * @module
+ *
+ * @beta
  */
 
 
 
 
 
+
+
 /**
  * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
  */
 const mailTelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
+/**
+ * Validates an array of email addresses.
+ * For ComposeMailType.New, it is valid to pass empty arrays for toRecipients, ccRecipients, and bccRecipients.
+ * This will result in a new email with handed-off (pre-populated) body content but no pre-populated recipients.
+ *
+ * @param emails - An optional array of email addresses to validate.
+ * @throws Error with a message describing if the email address is invalid.
+ *
+ * @beta
+ */
+function validateEmails(emails) {
+    if (!emails || emails.length === 0) {
+        return; // If the array is undefined or empty, consider it valid
+    }
+    // Use validateEmailAddress for each email in the param
+    emails.forEach((email) => {
+        validateEmailAddress(email); // This will throw an error if the email is invalid
+    });
+}
+/**
+ * Validates email addresses in the given ComposeMailParams object.
+ * Validates `toRecipients`, `ccRecipients`, and `bccRecipients` for `ComposeNewParams`.
+ *
+ * @param params - The incoming ComposeMailParams object.
+ * @throws Error with a message describing if the email address is invalid.
+ *
+ * @beta
+ */
+function validateHandoffComposeMailParams(param) {
+    if (!param.handoffId || param.handoffId.trim().length == 0 || param.handoffId.trim() === '') {
+        throw new Error('handoffId should not be null or empty string.');
+    }
+    const composeMailParams = param.composeMailParams;
+    if (composeMailParams.type === ComposeMailType.New) {
+        validateEmails(composeMailParams.toRecipients);
+        validateEmails(composeMailParams.ccRecipients);
+        validateEmails(composeMailParams.bccRecipients);
+    }
+    // For Reply, ReplyAll, and Forward types, no validation needed
+}
+/**
+ * Compose a new email in the user's mailbox, opening it in the drafts UX instead of the standard email.
+ *
+ * @param composeMailParamsWithHandoff - Object that specifies the type of mail item to compose and the details of the mail item.
+ * @returns { Promise<void> } - promise resolves after the compose window has opened successfully in host SDK.
+ * @throws Error with a message describing whether the capability is not initialized or the input is invalid.
+ *
+ * @beta
+ */
+function composeMailWithHandoff(composeMailParamsWithHandoff) {
+    ensureInitialized(runtime, FrameContexts.content);
+    if (!handoff_isSupported()) {
+        throw new Error('Not supported');
+    }
+    validateHandoffComposeMailParams(composeMailParamsWithHandoff);
+    return callFunctionInHost("mail.handoff.composeMail" /* ApiName.Mail_Handoff_ComposeMail */, [new SerializableComposeMailParamsWithHandoff(composeMailParamsWithHandoff)], getApiVersionTag(mailTelemetryVersionNumber, "mail.handoff.composeMail" /* ApiName.Mail_Handoff_ComposeMail */));
+}
+/**
+ * Checks if the mail capability and handoff sub-capability is supported by the host
+ * @returns boolean to represent whether the handoff sub-capability is supported
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ *
+ * @beta
+ */
+function handoff_isSupported() {
+    return ensureInitialized(runtime) && runtime.supports.mail && runtime.supports.mail.handoff ? true : false;
+}
+class SerializableComposeMailParamsWithHandoff {
+    constructor(composeMailParamsWithHandoff) {
+        this.composeMailParamsWithHandoff = composeMailParamsWithHandoff;
+    }
+    serialize() {
+        return this.composeMailParamsWithHandoff;
+    }
+}
+
+;// ./src/public/mail/mail.ts
+/**
+ * Used to interact with mail capability, including opening and composing mail.
+ * @module
+ */
+
+
+
+
+
+
+/**
+ * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
+ */
+const mail_mailTelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
 /**
  * Opens a mail message in the host.
  *
@@ -15587,7 +15706,7 @@ function openMailItem(openMailItemParams) {
         if (!openMailItemParams.itemId || !openMailItemParams.itemId.trim()) {
             throw new Error('Must supply an itemId to openMailItem');
         }
-        resolve(sendAndHandleStatusAndReason(getApiVersionTag(mailTelemetryVersionNumber, "mail.openMailItem" /* ApiName.Mail_OpenMailItem */), 'mail.openMailItem', openMailItemParams));
+        resolve(sendAndHandleStatusAndReason(getApiVersionTag(mail_mailTelemetryVersionNumber, "mail.openMailItem" /* ApiName.Mail_OpenMailItem */), 'mail.openMailItem', openMailItemParams));
     });
 }
 /**
@@ -15602,7 +15721,7 @@ function composeMail(composeMailParams) {
         if (!mail_isSupported()) {
             throw new Error('Not supported');
         }
-        resolve(sendAndHandleStatusAndReason(getApiVersionTag(mailTelemetryVersionNumber, "mail.composeMail" /* ApiName.Mail_ComposeMail */), 'mail.composeMail', composeMailParams));
+        resolve(sendAndHandleStatusAndReason(getApiVersionTag(mail_mailTelemetryVersionNumber, "mail.composeMail" /* ApiName.Mail_ComposeMail */), 'mail.composeMail', composeMailParams));
     });
 }
 /**
@@ -15626,6 +15745,7 @@ var ComposeMailType;
     /** Compose a new mail message with the content of an existing mail message forwarded to a new recipient. */
     ComposeMailType["Forward"] = "forward";
 })(ComposeMailType || (ComposeMailType = {}));
+
 
 ;// ./src/public/teamsAPIs.ts
 /**