@microsoft/teams-js 2.43.0 → 2.45.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.43.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.45.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.43.0/js/MicrosoftTeams.min.js"
-  integrity="sha384-0nHNpMJRciJQlpaCyCYK4yo0UU4tusQNisqsYd0ViC1d+tHWCoicv0wyyqSyV45f"
+  src="https://res.cdn.office.net/teams-js/2.45.0/js/MicrosoftTeams.min.js"
+  integrity="sha384-1ul+vDBl1B71YBndX5+TpWnAkYZfjzoOgjg57X9Gq3SsDAnN4OLELHWv+hoS/zjU"
   crossorigin="anonymous"
 ></script>
 
 <!-- Microsoft Teams JavaScript API (via npm) -->
-<script src="node_modules/@microsoft/teams-js@2.43.0/dist/MicrosoftTeams.min.js"></script>
+<script src="node_modules/@microsoft/teams-js@2.45.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

@@ -106,6 +106,8 @@ export declare const enum ApiName {
     ExternalAppAuthentication_AuthenticateWithSSOAndResendRequest = "externalAppAuthentication.authenticateWithSSOAndResendRequest",
     ExternalAppAuthentication_AuthenticateWithOauth2 = "externalAppAuthentication.authenticateWithOauth2",
     ExternalAppAuthentication_AuthenticateWithPowerPlatformConnectorPlugins = "externalAppAuthentication.authenticateWithPowerPlatformConnectorPlugins",
+    ExternalAppAuthentication_AuthenticateWithConnector = "externalAppAuthentication.authenticateWithConnector",
+    ExternalAppAuthentication_GetUserAuthenticationStateForConnector = "externalAppAuthentication.getUserAuthenticationStateForConnector",
     ExternalAppAuthenticationForCEA_AuthenticateWithOauth = "externalAppAuthenticationForCEA.authenticateWithOauth",
     ExternalAppAuthenticationForCEA_AuthenticateWithSSO = "externalAppAuthenticationForCEA.authenticateWithSSO",
     ExternalAppAuthenticationForCEA_AuthenticateAndResendRequest = "externalAppAuthenticationForCEA.authenticateAndResendRequest",

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

@@ -6,6 +6,7 @@
  * @module
  */
 import { ResponseHandler } from '../internal/responseHandler';
+import { UUID } from '../public';
 import { ISerializable } from '../public/serializable.interface';
 /*********** BEGIN REQUEST TYPE ************/
 /**
@@ -371,6 +372,79 @@ export declare function authenticateWithOauth2(titleId: string, oauthConfigId: s
  * @returns A promise that resolves when authentication succeeds and rejects with InvokeError on failure
  */
 export declare function authenticateWithPowerPlatformConnectorPlugins(titleId: string, signInUrl?: URL, oauthWindowParameters?: OauthWindowProperties): Promise<void>;
+/**
+ * Parameters required to authenticate with connectors.
+ *
+ * @beta
+ * @hidden
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * @property connectorId - The unique identifier for the connector.
+ * @property oauthConfigId - The OAuth configuration ID associated with the connector.
+ * @property correlationVector - The correlation vector (UUID) for tracking the authentication request. If not provided, one will be generated.
+ */
+export interface ConnectorParameters {
+    /** The unique identifier for the connector. */
+    connectorId: string;
+    /** The OAuth configuration ID associated with the connector. */
+    oAuthConfigId: string;
+    /** The trace ID (UUID) for tracking the authentication request. */
+    traceId: UUID;
+    /** Optional parameters for the OAuth sign-in window. */
+    windowParameters?: OauthWindowProperties;
+}
+export declare class SerializableConnectorParameters implements ISerializable {
+    private param;
+    constructor(param: ConnectorParameters);
+    serialize(): object;
+}
+/**
+ * @beta
+ * @hidden
+ * Signals to the host to perform authentication with connectors using the provided parameters.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * @param input - The parameters required for connectors authentication, including connectorId, oauthConfigId, and optional oauthWindowParameters.
+ * @returns A promise that resolves when authentication succeeds and rejects with InvokeError on failure.
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ */
+export declare function authenticateWithConnector(input: ConnectorParameters): Promise<void>;
+/**
+ * @hidden
+ * Represents the possible authentication states for a user in the context of federated connectors.
+ *
+ * @enum {number}
+ * @property {number} Invalid - The authentication state is invalid or not established.
+ * @property {number} Valid - The authentication state is valid and the user is authenticated.
+ * @property {number} Expired - The authentication state has expired and re-authentication is required.
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare enum UserAuthenticationState {
+    /** The authentication state is invalid or not established. */
+    Invalid = "Invalid",
+    /** The authentication state is valid and the user is authenticated. */
+    Valid = "Valid",
+    /** The authentication state has expired and re-authentication is required. */
+    Expired = "Expired"
+}
+/**
+ * @beta
+ * @hidden
+ * Retrieves the authentication state for a user for a given federated connector.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * @param connectorId - The unique identifier for the federated connector.
+ * @param oauthConfigId - The OAuth configuration ID associated with the connector.
+ * @returns A promise that resolves to the user's authentication state for the federated connector.
+ * @throws Error if the capability is not supported or if initialization has not completed.
+ */
+export declare function getUserAuthenticationStateForConnector(input: ConnectorParameters): Promise<UserAuthenticationState>;
 /**
  * @hidden
  * Checks if the externalAppAuthentication capability is supported by the host

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

@@ -6,6 +6,7 @@ export { ConversationResponse, OpenConversationRequest } from './conversations';
 export * as copilot from './copilot/copilot';
 export * as sidePanelInterfaces from './copilot/sidePanelInterfaces';
 export * as externalAppAuthentication from './externalAppAuthentication';
+export { ConnectorParameters, UserAuthenticationState } from './externalAppAuthentication';
 export * as externalAppAuthenticationForCEA from './externalAppAuthenticationForCEA';
 export * as externalAppCardActions from './externalAppCardActions';
 export * as externalAppCardActionsForCEA from './externalAppCardActionsForCEA';

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

@@ -1050,6 +1050,11 @@ export interface AppEligibilityInformation {
      * Education Eligibility Information for the app user
      */
     userClassification: UserClassification | null;
+    /**
+     * Describes settings available to the user.
+     * If this property is undefined, it indicates that the host is an older version that doesn't support this property.
+     */
+    settings?: AppSettings | null;
 }
 /**
  * @hidden
@@ -1081,6 +1086,28 @@ export interface UserClassificationWithEduType {
      */
     persona: Persona.Faculty | Persona.Student;
 }
+/**
+ * @hidden
+ * @beta
+ * Represents the settings set available to the user.
+ */
+export interface AppSettings {
+    /**
+     * Describes conversation settings available to the user.
+     */
+    conversationSettings?: AppConversationSettings | null;
+}
+/**
+ * @hidden
+ * @beta
+ * Represents the conversation settings available to the user.
+ */
+export interface AppConversationSettings {
+    /**
+     * Indicates OCE admin toggle
+     */
+    isOptionalConnectedExperiencesEnabled: boolean;
+}
 /**
  * @hidden
  *

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/logs.js";export{e as logs};import*as r from"./private/conversations.js";export{r as conversations};import*as t from"./private/copilot/copilot.js";export{t as copilot};import*as o from"./private/copilot/sidePanelInterfaces.js";export{o as sidePanelInterfaces};import*as p from"./private/externalAppAuthentication.js";export{p as externalAppAuthentication};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/remoteCamera.js";export{d as remoteCamera};import*as g from"./private/appEntity.js";export{g as appEntity};import*as b from"./private/teams/teams.js";export{b as teams};import*as v from"./private/videoEffectsEx.js";export{v as videoEffectsEx};import*as C from"./private/hostEntity/hostEntity.js";export{C as hostEntity};import*as A from"./private/store.js";export{A as store};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 S from"./public/authentication.js";export{S as authentication};import*as H from"./public/app/app.js";export{H as app};import*as F from"./public/appInstallDialog.js";export{F as appInstallDialog};import*as y from"./public/barCode.js";export{y as barCode};import*as T from"./public/chat.js";export{T as chat};import*as E from"./public/clipboard.js";export{E as clipboard};import*as I from"./public/dialog/dialog.js";export{I as dialog};import*as D from"./public/nestedAppAuth.js";export{D as nestedAppAuth};import*as w from"./public/geoLocation/geoLocation.js";export{w as geoLocation};import*as P from"./public/pages/pages.js";export{P as pages};import*as B from"./public/menus.js";export{B as menus};import*as k from"./public/media.js";export{k as media};import*as L from"./public/secondaryBrowser.js";export{L as secondaryBrowser};import*as M from"./public/location.js";export{M as location};import*as U from"./public/meeting/meeting.js";export{U as meeting};import*as O from"./public/monetization.js";export{O as monetization};import*as V from"./public/calendar.js";export{V as calendar};import*as z from"./public/mail/mail.js";export{z as mail};import*as R from"./public/teamsAPIs.js";export{R as teamsCore};import*as W from"./public/people.js";export{W as people};import*as N from"./public/profile.js";export{N as profile};import*as q from"./public/videoEffects.js";export{q as videoEffects};import*as G from"./public/search.js";export{G as search};import*as J from"./public/sharing/sharing.js";export{J as sharing};import*as K from"./public/stageView/stageView.js";export{K as stageView};import*as Q from"./public/visualMedia/visualMedia.js";export{Q as visualMedia};import*as X from"./public/webStorage.js";export{X as webStorage};import*as Y from"./public/call.js";export{Y as call};import*as Z from"./public/appInitialization.js";export{Z as appInitialization};import*as $ from"./public/thirdPartyCloudStorage.js";export{$ as thirdPartyCloudStorage};import*as _ from"./public/settings.js";export{_ as settings};import*as ee from"./public/tasks.js";export{ee as tasks};import*as re from"./public/marketplace.js";export{re as marketplace};import*as te from"./public/shortcutRelay.js";export{te 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/remoteCamera.js";export{d as remoteCamera};import*as g from"./private/appEntity.js";export{g as appEntity};import*as b from"./private/teams/teams.js";export{b as teams};import*as v from"./private/videoEffectsEx.js";export{v as videoEffectsEx};import*as A from"./private/hostEntity/hostEntity.js";export{A as hostEntity};import*as C from"./private/store.js";export{C as store};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 S from"./public/authentication.js";export{S as authentication};import*as H from"./public/app/app.js";export{H as app};import*as F from"./public/appInstallDialog.js";export{F as appInstallDialog};import*as y from"./public/barCode.js";export{y as barCode};import*as T from"./public/chat.js";export{T as chat};import*as E from"./public/clipboard.js";export{E as clipboard};import*as I from"./public/dialog/dialog.js";export{I as dialog};import*as D from"./public/nestedAppAuth.js";export{D as nestedAppAuth};import*as w from"./public/geoLocation/geoLocation.js";export{w as geoLocation};import*as P from"./public/pages/pages.js";export{P as pages};import*as B from"./public/menus.js";export{B as menus};import*as k from"./public/media.js";export{k as media};import*as L from"./public/secondaryBrowser.js";export{L as secondaryBrowser};import*as U from"./public/location.js";export{U as location};import*as M from"./public/meeting/meeting.js";export{M as meeting};import*as O from"./public/monetization.js";export{O as monetization};import*as V from"./public/calendar.js";export{V as calendar};import*as z from"./public/mail/mail.js";export{z as mail};import*as R from"./public/teamsAPIs.js";export{R as teamsCore};import*as W from"./public/people.js";export{W as people};import*as N from"./public/profile.js";export{N as profile};import*as q from"./public/videoEffects.js";export{q as videoEffects};import*as G from"./public/search.js";export{G as search};import*as J from"./public/sharing/sharing.js";export{J as sharing};import*as K from"./public/stageView/stageView.js";export{K as stageView};import*as Q from"./public/visualMedia/visualMedia.js";export{Q as visualMedia};import*as X from"./public/webStorage.js";export{X as webStorage};import*as Y from"./public/call.js";export{Y as call};import*as Z from"./public/appInitialization.js";export{Z as appInitialization};import*as $ from"./public/thirdPartyCloudStorage.js";export{$ as thirdPartyCloudStorage};import*as _ from"./public/settings.js";export{_ as settings};import*as ee from"./public/tasks.js";export{ee as tasks};import*as re from"./public/marketplace.js";export{re as marketplace};import*as te from"./public/shortcutRelay.js";export{te as shortcutRelay};

package/dist/esm/packages/teams-js/src/private/externalAppAuthentication.js

@@ -1 +1 @@
-import{sendMessageToParentAsync as e}from"../internal/communication.js";import{ensureInitialized as t}from"../internal/internalAPIs.js";import{ResponseHandler as n}from"../internal/responseHandler.js";import{getApiVersionTag as i}from"../internal/telemetry.js";import{isPrimitiveOrPlainObject as r,validateId as o,validateUrl as s}from"../internal/utils.js";import{FrameContexts as a,errorNotSupportedOnPlatform as u}from"../public/constants.js";import{runtime as c}from"../public/runtime.js";import{AppId as h}from"../public/appId.js";const l="v2";class p{constructor(e){this.invokeRequest=e}serialize(){return this.invokeRequest}}function f(e){const t=e;return t.responseType===R.ActionExecuteInvokeResponse&&void 0!==t.value&&void 0!==t.statusCode&&void 0!==t.type}const m="Action.Execute";var d,R,A;!function(e){e.ActionExecuteInvokeRequest="ActionExecuteInvokeRequest",e.QueryMessageExtensionRequest="QueryMessageExtensionRequest"}(d||(d={})),function(e){e.ActionExecuteInvokeResponse="ActionExecuteInvokeResponse",e.QueryMessageExtensionResponse="QueryMessageExtensionResponse"}(R||(R={}));class x extends n{validate(e){return f(e)}deserialize(e){return e}}function w(e){if("object"!=typeof e||null===e)return!1;const t=e;return Object.values(A).includes(t.errorCode)&&(void 0===t.message||"string"==typeof t.message)}function E(e){e.requestType===d.ActionExecuteInvokeRequest?v(e):e.requestType===d.QueryMessageExtensionRequest&&function(e){if(e.commandId.length>64)throw new Error("originalRequestInfo.commandId exceeds the maximum size of 64 characters");if(e.parameters.length>5)throw new Error("originalRequestInfo.parameters exceeds the maximum size of 5");for(const t of e.parameters){if(t.name.length>64)throw new Error("originalRequestInfo.parameters.name exceeds the maximum size of 64 characters");if(t.value.length>512)throw new Error("originalRequestInfo.parameters.value exceeds the maximum size of 512 characters")}}(e)}function v(e){if(e.type!==m){throw{errorCode:A.INTERNAL_ERROR,message:`Invalid action type ${e.type}. Action type must be "${m}"`}}if(!r(e.data)){throw{errorCode:A.INTERNAL_ERROR,message:`Invalid data type ${typeof e.data}. Data must be a primitive or a plain object.`}}}function g(n,r,o){if(t(c,a.content),!j())throw u;const s=new h(n);return E(o),e(i(l,"externalAppAuthentication.authenticateAndResendRequest"),"externalAppAuthentication.authenticateAndResendRequest",[s.toString(),o,r.url.href,r.width,r.height,r.isExternal]).then((([e,t])=>{if(e&&null!=t.responseType)return t;throw t}))}function I(n,r){if(t(c,a.content),!j())throw u;const o=new h(n);return e(i(l,"externalAppAuthentication.authenticateWithSSO"),"externalAppAuthentication.authenticateWithSSO",[o.toString(),r.claims,r.silent]).then((([e,t])=>{if(!e)throw t}))}function y(n,r,o){if(t(c,a.content),!j())throw u;const s=new h(n);return E(o),e(i(l,"externalAppAuthentication.authenticateWithSSOAndResendRequest"),"externalAppAuthentication.authenticateWithSSOAndResendRequest",[s.toString(),o,r.claims,r.silent]).then((([e,t])=>{if(e&&null!=t.responseType)return t;throw t}))}function q(n,r,s){if(t(c,a.content),!j())throw u;return o(n,new Error("titleId is Invalid.")),o(r,new Error("oauthConfigId is Invalid.")),e(i(l,"externalAppAuthentication.authenticateWithOauth2"),"externalAppAuthentication.authenticateWithOauth2",[n,r,s.width,s.height,s.isExternal]).then((([e,t])=>{if(!e)throw t}))}function S(n,r,h){if(t(c,a.content),!j())throw u;return o(n,new Error("titleId is Invalid.")),r&&s(r),e(i(l,"externalAppAuthentication.authenticateWithPowerPlatformConnectorPlugins"),"externalAppAuthentication.authenticateWithPowerPlatformConnectorPlugins",[n,null==r?void 0:r.toString(),null==h?void 0:h.width,null==h?void 0:h.height,null==h?void 0:h.isExternal]).then((([e,t])=>{if(!e)throw t}))}function j(){return!(!t(c)||!c.supports.externalAppAuthentication)}!function(e){e.INTERNAL_ERROR="INTERNAL_ERROR"}(A||(A={}));export{m as ActionExecuteInvokeRequestType,x as ActionExecuteResponseHandler,A as InvokeErrorCode,R as InvokeResponseType,d as OriginalRequestType,p as SerializableActionExecuteInvokeRequest,g as authenticateAndResendRequest,q as authenticateWithOauth2,S as authenticateWithPowerPlatformConnectorPlugins,I as authenticateWithSSO,y as authenticateWithSSOAndResendRequest,f as isActionExecuteResponse,w as isInvokeError,j as isSupported,v as validateActionExecuteInvokeRequest};
+import{sendMessageToParentAsync as e,callFunctionInHost as t,callFunctionInHostAndHandleResponse as n}from"../internal/communication.js";import{ensureInitialized as i}from"../internal/internalAPIs.js";import{ResponseHandler as r}from"../internal/responseHandler.js";import{getApiVersionTag as o}from"../internal/telemetry.js";import{isPrimitiveOrPlainObject as a,validateId as s,validateUrl as u}from"../internal/utils.js";import{FrameContexts as c,errorNotSupportedOnPlatform as h}from"../public/constants.js";import{runtime as l}from"../public/runtime.js";import{AppId as p}from"../public/appId.js";const d="v2";class f{constructor(e){this.invokeRequest=e}serialize(){return this.invokeRequest}}function m(e){const t=e;return t.responseType===w.ActionExecuteInvokeResponse&&void 0!==t.value&&void 0!==t.statusCode&&void 0!==t.type}const A="Action.Execute";var I,w,v,x;!function(e){e.ActionExecuteInvokeRequest="ActionExecuteInvokeRequest",e.QueryMessageExtensionRequest="QueryMessageExtensionRequest"}(I||(I={})),function(e){e.ActionExecuteInvokeResponse="ActionExecuteInvokeResponse",e.QueryMessageExtensionResponse="QueryMessageExtensionResponse"}(w||(w={}));class R extends r{validate(e){return m(e)}deserialize(e){return e}}function g(e){if("object"!=typeof e||null===e)return!1;const t=e;return Object.values(v).includes(t.errorCode)&&(void 0===t.message||"string"==typeof t.message)}function E(e){e.requestType===I.ActionExecuteInvokeRequest?y(e):e.requestType===I.QueryMessageExtensionRequest&&function(e){if(e.commandId.length>64)throw new Error("originalRequestInfo.commandId exceeds the maximum size of 64 characters");if(e.parameters.length>5)throw new Error("originalRequestInfo.parameters exceeds the maximum size of 5");for(const t of e.parameters){if(t.name.length>64)throw new Error("originalRequestInfo.parameters.name exceeds the maximum size of 64 characters");if(t.value.length>512)throw new Error("originalRequestInfo.parameters.value exceeds the maximum size of 512 characters")}}(e)}function y(e){if(e.type!==A){throw{errorCode:v.INTERNAL_ERROR,message:`Invalid action type ${e.type}. Action type must be "${A}"`}}if(!a(e.data)){throw{errorCode:v.INTERNAL_ERROR,message:`Invalid data type ${typeof e.data}. Data must be a primitive or a plain object.`}}}function q(t,n,r){if(i(l,c.content),!k())throw h;const a=new p(t);return E(r),e(o(d,"externalAppAuthentication.authenticateAndResendRequest"),"externalAppAuthentication.authenticateAndResendRequest",[a.toString(),r,n.url.href,n.width,n.height,n.isExternal]).then((([e,t])=>{if(e&&null!=t.responseType)return t;throw t}))}function C(t,n){if(i(l,c.content),!k())throw h;const r=new p(t);return e(o(d,"externalAppAuthentication.authenticateWithSSO"),"externalAppAuthentication.authenticateWithSSO",[r.toString(),n.claims,n.silent]).then((([e,t])=>{if(!e)throw t}))}function S(t,n,r){if(i(l,c.content),!k())throw h;const a=new p(t);return E(r),e(o(d,"externalAppAuthentication.authenticateWithSSOAndResendRequest"),"externalAppAuthentication.authenticateWithSSOAndResendRequest",[a.toString(),r,n.claims,n.silent]).then((([e,t])=>{if(e&&null!=t.responseType)return t;throw t}))}function j(t,n,r){if(i(l,c.content),!k())throw h;return s(t,new Error("titleId is Invalid.")),s(n,new Error("oauthConfigId is Invalid.")),e(o(d,"externalAppAuthentication.authenticateWithOauth2"),"externalAppAuthentication.authenticateWithOauth2",[t,n,r.width,r.height,r.isExternal]).then((([e,t])=>{if(!e)throw t}))}function O(t,n,r){if(i(l,c.content),!k())throw h;return s(t,new Error("titleId is Invalid.")),n&&u(n),e(o(d,"externalAppAuthentication.authenticateWithPowerPlatformConnectorPlugins"),"externalAppAuthentication.authenticateWithPowerPlatformConnectorPlugins",[t,null==n?void 0:n.toString(),null==r?void 0:r.width,null==r?void 0:r.height,null==r?void 0:r.isExternal]).then((([e,t])=>{if(!e)throw t}))}!function(e){e.INTERNAL_ERROR="INTERNAL_ERROR"}(v||(v={}));class P{constructor(e){this.param=e}serialize(){var e,t,n;return{connectorId:this.param.connectorId,oAuthConfigId:this.param.oAuthConfigId,traceId:null!==(n=null===(t=null===(e=this.param.traceId)||void 0===e?void 0:e.toString)||void 0===t?void 0:t.call(e))&&void 0!==n?n:this.param.traceId,windowParameters:this.param.windowParameters?Object.assign({},this.param.windowParameters):void 0}}}function W(e){if(i(l,c.content),!k())throw h;return s(e.connectorId,new Error("connectorId is Invalid.")),s(e.oAuthConfigId,new Error("oauthConfigId is Invalid.")),t("externalAppAuthentication.authenticateWithConnector",[new P(e)],o(d,"externalAppAuthentication.authenticateWithConnector"),g)}!function(e){e.Invalid="Invalid",e.Valid="Valid",e.Expired="Expired"}(x||(x={}));class b extends r{validate(e){return"string"==typeof e&&e in x}deserialize(e){return e}}function T(e){if(i(l,c.content),!k())throw h;return s(e.connectorId,new Error("connectorId is Invalid.")),s(e.oAuthConfigId,new Error("oAuthConfigId is Invalid.")),n("externalAppAuthentication.getUserAuthenticationStateForConnector",[new P(e)],new b,o(d,"externalAppAuthentication.getUserAuthenticationStateForConnector"),g)}function k(){return!(!i(l)||!l.supports.externalAppAuthentication)}export{A as ActionExecuteInvokeRequestType,R as ActionExecuteResponseHandler,v as InvokeErrorCode,w as InvokeResponseType,I as OriginalRequestType,f as SerializableActionExecuteInvokeRequest,P as SerializableConnectorParameters,x as UserAuthenticationState,q as authenticateAndResendRequest,W as authenticateWithConnector,j as authenticateWithOauth2,O as authenticateWithPowerPlatformConnectorPlugins,C as authenticateWithSSO,S as authenticateWithSSOAndResendRequest,T as getUserAuthenticationStateForConnector,m as isActionExecuteResponse,g as isInvokeError,k as isSupported,y as validateActionExecuteInvokeRequest};

package/dist/esm/packages/teams-js/src/private/externalAppAuthenticationForCEA.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 n,callFunctionInHostAndHandleResponse as e}from"../internal/communication.js";import{validateAppIdInstance as i}from"../internal/idValidation.js";import{ensureInitialized as o}from"../internal/internalAPIs.js";import{getApiVersionTag as r}from"../internal/telemetry.js";import{validateId as a}from"../internal/utils.js";import{FrameContexts as u,errorNotSupportedOnPlatform as c}from"../public/constants.js";import{runtime as h}from"../public/runtime.js";import{validateActionExecuteInvokeRequest as s,ActionExecuteResponseHandler as p,SerializableActionExecuteInvokeRequest as l,isInvokeError as A}from"./externalAppAuthentication.js";const m="v2";function d(e,i,a){return t(this,void 0,void 0,(function*(){if(o(h,u.content),!v())throw c;return w(e,i),n("externalAppAuthenticationForCEA.authenticateWithSSO",[e,i,a.authId,a.connectionName,a.claims,a.silent],r(m,"externalAppAuthenticationForCEA.authenticateWithSSO"),A)}))}function f(e,i,a){return t(this,void 0,void 0,(function*(){if(o(h,u.content),!v())throw c;return w(e,i),n("externalAppAuthenticationForCEA.authenticateWithOauth",[e,i,a.url.href,a.width,a.height,a.isExternal],r(m,"externalAppAuthenticationForCEA.authenticateWithOauth"),A)}))}function x(n,i,a,d){return t(this,void 0,void 0,(function*(){if(o(h,u.content),!v())throw c;return w(n,i),s(d),e("externalAppAuthenticationForCEA.authenticateAndResendRequest",[n,i,new l(d),a.url.href,a.width,a.height,a.isExternal],new p,r(m,"externalAppAuthenticationForCEA.authenticateAndResendRequest"),A)}))}function E(n,i,a,d){return t(this,void 0,void 0,(function*(){if(o(h,u.content),!v())throw c;return w(n,i),s(d),e("externalAppAuthenticationForCEA.authenticateWithSSOAndResendRequest",[n,i,new l(d),a.authId,a.connectionName,a.claims,a.silent],new p,r(m,"externalAppAuthenticationForCEA.authenticateWithSSOAndResendRequest"),A)}))}function v(){return!(!o(h)||!h.supports.externalAppAuthenticationForCEA)}function w(t,n){a(n,new Error("conversation id is not valid.")),i(t)}export{x as authenticateAndResendRequest,f as authenticateWithOauth,d as authenticateWithSSO,E as authenticateWithSSOAndResendRequest,v as isSupported,w as validateInput};
+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 n,callFunctionInHostAndHandleResponse as e}from"../internal/communication.js";import{validateAppIdInstance as i}from"../internal/idValidation.js";import{ensureInitialized as o}from"../internal/internalAPIs.js";import{getApiVersionTag as r}from"../internal/telemetry.js";import{validateId as a}from"../internal/utils.js";import{FrameContexts as u,errorNotSupportedOnPlatform as c}from"../public/constants.js";import{runtime as h}from"../public/runtime.js";import{isInvokeError as s,validateActionExecuteInvokeRequest as p,ActionExecuteResponseHandler as l,SerializableActionExecuteInvokeRequest as A}from"./externalAppAuthentication.js";const m="v2";function d(e,i,a){return t(this,void 0,void 0,(function*(){if(o(h,u.content),!v())throw c;return w(e,i),n("externalAppAuthenticationForCEA.authenticateWithSSO",[e,i,a.authId,a.connectionName,a.claims,a.silent],r(m,"externalAppAuthenticationForCEA.authenticateWithSSO"),s)}))}function f(e,i,a){return t(this,void 0,void 0,(function*(){if(o(h,u.content),!v())throw c;return w(e,i),n("externalAppAuthenticationForCEA.authenticateWithOauth",[e,i,a.url.href,a.width,a.height,a.isExternal],r(m,"externalAppAuthenticationForCEA.authenticateWithOauth"),s)}))}function x(n,i,a,d){return t(this,void 0,void 0,(function*(){if(o(h,u.content),!v())throw c;return w(n,i),p(d),e("externalAppAuthenticationForCEA.authenticateAndResendRequest",[n,i,new A(d),a.url.href,a.width,a.height,a.isExternal],new l,r(m,"externalAppAuthenticationForCEA.authenticateAndResendRequest"),s)}))}function E(n,i,a,d){return t(this,void 0,void 0,(function*(){if(o(h,u.content),!v())throw c;return w(n,i),p(d),e("externalAppAuthenticationForCEA.authenticateWithSSOAndResendRequest",[n,i,new A(d),a.authId,a.connectionName,a.claims,a.silent],new l,r(m,"externalAppAuthenticationForCEA.authenticateWithSSOAndResendRequest"),s)}))}function v(){return!(!o(h)||!h.supports.externalAppAuthenticationForCEA)}function w(t,n){a(n,new Error("conversation id is not valid.")),i(t)}export{x as authenticateAndResendRequest,f as authenticateWithOauth,d as authenticateWithSSO,E as authenticateWithSSOAndResendRequest,v as isSupported,w as validateInput};

package/dist/esm/packages/teams-js/src/private/privateAPIs.js

@@ -1 +1 @@
-import{shouldEventBeRelayedToChild as e,sendMessageEventToChild as t}from"../internal/childCommunication.js";import{sendMessageToParent as n}from"../internal/communication.js";import{registerHandler as i}from"../internal/handlers.js";import{ensureInitialized as r}from"../internal/internalAPIs.js";import{getApiVersionTag as o}from"../internal/telemetry.js";import{getGenericOnCompleteHandler as s}from"../internal/utils.js";import{FrameContexts as l}from"../public/constants.js";import{runtime as m}from"../public/runtime.js";const a="v1";function p(e,t){r(m),n(o(a,"uploadCustomApp"),"uploadCustomApp",[e],t||s())}function c(e,t,i){r(m),n(o(a,"sendCustomMessage"),e,t,i)}function u(n,i){if(r(m),!e())throw new Error("The child window has not yet been initialized or is not present");t(n,i)}function d(e,t){r(m),i(o(a,"registerCustomHandler"),e,((...e)=>t.apply(this,e)))}function f(e,t){r(m),i(o(a,"registerUserSettingsChangeHandler"),"userSettingsChange",t,!0,[e])}function w(e){r(m,l.content,l.task);const t=[e.entityId,e.title,e.description,e.type,e.objectUrl,e.downloadUrl,e.webPreviewUrl,e.webEditUrl,e.baseUrl,e.editFile,e.subEntityId,e.viewerAction,e.fileOpenPreference,e.conversationId,e.sizeInBytes];n(o(a,"openFilePreview"),"openFilePreview",t)}export{w as openFilePreview,d as registerCustomHandler,f as registerUserSettingsChangeHandler,u as sendCustomEvent,c as sendCustomMessage,p as uploadCustomApp};
+import{shouldEventBeRelayedToChild as e,sendMessageEventToChild as t}from"../internal/childCommunication.js";import{sendMessageToParent as n}from"../internal/communication.js";import{registerHandler as i}from"../internal/handlers.js";import{ensureInitialized as r}from"../internal/internalAPIs.js";import{getApiVersionTag as o}from"../internal/telemetry.js";import{getGenericOnCompleteHandler as s}from"../internal/utils.js";import{FrameContexts as l}from"../public/constants.js";import{runtime as a}from"../public/runtime.js";const m="v1";function p(e,t){r(a),n(o(m,"uploadCustomApp"),"uploadCustomApp",[e],t||s())}function c(e,t,i){r(a),n(o(m,"sendCustomMessage"),e,t,i)}function u(n,i){if(r(a),!e())throw new Error("The child window has not yet been initialized or is not present");t(n,i)}function d(e,t){r(a),i(o(m,"registerCustomHandler"),e,((...e)=>t.apply(this,e)))}function f(e,t){r(a),i(o(m,"registerUserSettingsChangeHandler"),"userSettingsChange",t,!0,[e])}function w(e){r(a,l.content,l.sidePanel,l.task);const t=[e.entityId,e.title,e.description,e.type,e.objectUrl,e.downloadUrl,e.webPreviewUrl,e.webEditUrl,e.baseUrl,e.editFile,e.subEntityId,e.viewerAction,e.fileOpenPreference,e.conversationId,e.sizeInBytes];n(o(m,"openFilePreview"),"openFilePreview",t)}export{w as openFilePreview,d as registerCustomHandler,f as registerUserSettingsChangeHandler,u as sendCustomEvent,c as sendCustomMessage,p as uploadCustomApp};

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

@@ -1 +1 @@
-const o="2.43.0";export{o as version};
+const o="2.45.0";export{o as version};

package/dist/umd/MicrosoftTeams.js

@@ -1010,6 +1010,7 @@ __webpack_require__.d(__webpack_exports__, {
   TaskModuleDimension: () => (/* reexport */ DialogDimension),
   TeamType: () => (/* reexport */ TeamType),
   UUID: () => (/* reexport */ UUID),
+  UserAuthenticationState: () => (/* reexport */ UserAuthenticationState),
   UserSettingTypes: () => (/* reexport */ UserSettingTypes),
   UserTeamRole: () => (/* reexport */ UserTeamRole),
   ValidatedSafeString: () => (/* reexport */ validatedSafeString_ValidatedSafeString),
@@ -1417,11 +1418,15 @@ __webpack_require__.d(externalAppAuthentication_namespaceObject, {
   InvokeResponseType: () => (InvokeResponseType),
   OriginalRequestType: () => (OriginalRequestType),
   SerializableActionExecuteInvokeRequest: () => (SerializableActionExecuteInvokeRequest),
+  SerializableConnectorParameters: () => (SerializableConnectorParameters),
+  UserAuthenticationState: () => (UserAuthenticationState),
   authenticateAndResendRequest: () => (authenticateAndResendRequest),
+  authenticateWithConnector: () => (authenticateWithConnector),
   authenticateWithOauth2: () => (authenticateWithOauth2),
   authenticateWithPowerPlatformConnectorPlugins: () => (authenticateWithPowerPlatformConnectorPlugins),
   authenticateWithSSO: () => (authenticateWithSSO),
   authenticateWithSSOAndResendRequest: () => (authenticateWithSSOAndResendRequest),
+  getUserAuthenticationStateForConnector: () => (getUserAuthenticationStateForConnector),
   isActionExecuteResponse: () => (isActionExecuteResponse),
   isInvokeError: () => (isInvokeError),
   isSupported: () => (externalAppAuthentication_isSupported),
@@ -4644,7 +4649,7 @@ function isSerializable(arg) {
  * @hidden
  *  Package version.
  */
-const version = "2.43.0";
+const version = "2.45.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.
@@ -9212,7 +9217,7 @@ function registerUserSettingsChangeHandler(settingTypes, handler) {
  * Limited to Microsoft-internal use
  */
 function openFilePreview(filePreviewParameters) {
-    ensureInitialized(runtime, FrameContexts.content, FrameContexts.task);
+    ensureInitialized(runtime, FrameContexts.content, FrameContexts.sidePanel, FrameContexts.task);
     const params = [
         filePreviewParameters.entityId,
         filePreviewParameters.title,
@@ -9901,6 +9906,7 @@ class CloseSidePanelResponseHandler extends ResponseHandler {
 
 
 
+
 /**
  * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
  */
@@ -10207,6 +10213,109 @@ function authenticateWithPowerPlatformConnectorPlugins(titleId, signInUrl, oauth
         }
     });
 }
+class SerializableConnectorParameters {
+    constructor(param) {
+        this.param = param;
+    }
+    serialize() {
+        var _a, _b, _c;
+        return {
+            connectorId: this.param.connectorId,
+            oAuthConfigId: this.param.oAuthConfigId,
+            traceId: (_c = (_b = (_a = this.param.traceId) === null || _a === void 0 ? void 0 : _a.toString) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : this.param.traceId,
+            windowParameters: this.param.windowParameters ? Object.assign({}, this.param.windowParameters) : undefined,
+        };
+    }
+}
+/**
+ * @beta
+ * @hidden
+ * Signals to the host to perform authentication with connectors using the provided parameters.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * @param input - The parameters required for connectors authentication, including connectorId, oauthConfigId, and optional oauthWindowParameters.
+ * @returns A promise that resolves when authentication succeeds and rejects with InvokeError on failure.
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ */
+function authenticateWithConnector(input) {
+    ensureInitialized(runtime, FrameContexts.content);
+    if (!externalAppAuthentication_isSupported()) {
+        throw errorNotSupportedOnPlatform;
+    }
+    validateId(input.connectorId, new Error('connectorId is Invalid.'));
+    validateId(input.oAuthConfigId, new Error('oauthConfigId is Invalid.'));
+    return callFunctionInHost("externalAppAuthentication.authenticateWithConnector" /* ApiName.ExternalAppAuthentication_AuthenticateWithConnector */, [new SerializableConnectorParameters(input)], getApiVersionTag(externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthentication.authenticateWithConnector" /* ApiName.ExternalAppAuthentication_AuthenticateWithConnector */), isInvokeError);
+}
+/**
+ * @hidden
+ * Represents the possible authentication states for a user in the context of federated connectors.
+ *
+ * @enum {number}
+ * @property {number} Invalid - The authentication state is invalid or not established.
+ * @property {number} Valid - The authentication state is valid and the user is authenticated.
+ * @property {number} Expired - The authentication state has expired and re-authentication is required.
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+var UserAuthenticationState;
+(function (UserAuthenticationState) {
+    /** The authentication state is invalid or not established. */
+    UserAuthenticationState["Invalid"] = "Invalid";
+    /** The authentication state is valid and the user is authenticated. */
+    UserAuthenticationState["Valid"] = "Valid";
+    /** The authentication state has expired and re-authentication is required. */
+    UserAuthenticationState["Expired"] = "Expired";
+})(UserAuthenticationState || (UserAuthenticationState = {}));
+/**
+ * @hidden
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * Response handler for user authentication state for federated connectors.
+ * Validates and deserializes the response from the host to ensure it matches the UserAuthenticationState enum.
+ */
+class UserAuthenticationStateResponseHandler extends ResponseHandler {
+    /**
+     * Validates if the response is a valid UserAuthenticationState value.
+     * @param response - The response received from the host.
+     * @returns True if the response is a valid UserAuthenticationState, false otherwise.
+     */
+    validate(response) {
+        return typeof response === 'string' && response in UserAuthenticationState;
+    }
+    /**
+     * Deserializes the response to a UserAuthenticationState value.
+     * @param response - The response received from the host.
+     * @returns The response cast as UserAuthenticationState.
+     */
+    deserialize(response) {
+        return response;
+    }
+}
+/**
+ * @beta
+ * @hidden
+ * Retrieves the authentication state for a user for a given federated connector.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * @param connectorId - The unique identifier for the federated connector.
+ * @param oauthConfigId - The OAuth configuration ID associated with the connector.
+ * @returns A promise that resolves to the user's authentication state for the federated connector.
+ * @throws Error if the capability is not supported or if initialization has not completed.
+ */
+function getUserAuthenticationStateForConnector(input) {
+    ensureInitialized(runtime, FrameContexts.content);
+    if (!externalAppAuthentication_isSupported()) {
+        throw errorNotSupportedOnPlatform;
+    }
+    validateId(input.connectorId, new Error('connectorId is Invalid.'));
+    validateId(input.oAuthConfigId, new Error('oAuthConfigId is Invalid.'));
+    return callFunctionInHostAndHandleResponse("externalAppAuthentication.getUserAuthenticationStateForConnector" /* ApiName.ExternalAppAuthentication_GetUserAuthenticationStateForConnector */, [new SerializableConnectorParameters(input)], new UserAuthenticationStateResponseHandler(), getApiVersionTag(externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthentication.getUserAuthenticationStateForConnector" /* ApiName.ExternalAppAuthentication_GetUserAuthenticationStateForConnector */), isInvokeError);
+}
 /**
  * @hidden
  * Checks if the externalAppAuthentication capability is supported by the host
@@ -14027,6 +14136,7 @@ function serializeValidSize(size) {
 
 
 
+