v2.30.0

Minor changes

• Updated copilot.eligibility.getEligibilityInfo to be async and get the eligibility info from the host if it is not already available.

Patches

• Updated edgeapi.freya.svc.cloud.microsoft to chatuxmanager.svc.cloud.microsoft.
• Updated edgeapi endpoint from edgeapi.svc.cloud.microsoft to edgeapi.freya.svc.cloud.microsoft in valid domains list. Added work.bing.com to valid domains list.
• Clarified usage for validMessageOrigins parameter on app.initialize in documentation.

v2.29.0

Minor changes

• Added support for externalAppAuthenticationForCEA capability
• Added support for externalAppCardActionsForCEA capability.
• Added logging for current teamsjs instance and timestamps
• Added a Rollup built bundle of Teams-JS
• Added three properties to ICallDetails, originalCallerInfo, dialedEntityInfo, and callId, created a new type ICallParticipantIdentifiers, and deprecated the originalCaller and dialedEntity properties
• Updated pages.navigateToApp to now optionally accept a more type-safe input object
• Added logging for version on startup

Patches

• Updated logging for messages to be clearer
• Added edgeapi.svc.cloud.microsoft to valid domains list
• Updated internal app id validation
• Unified common data models for external card actions into externalAppCardActions namespace.
• Updated types for externalAppCardActionsForCEA capability.

v2.28.0

2.28.0

Minor changes

• Removed invalid validations for content fields on IContentResponse interface
• Added 1P-only hostEntity capability for adding and configuring, removing, renaming, re-configuring and fetching all tabs.
• Added optional field messageId to stageView.open. Passing messageId to stageView.open allows opening the stageView in a channel meeting
• Added optional enum attribute for registerFocusEnterHandler and returnFocus APIs that allows developers to send and receive more nuanced information about where focus should go in their app or the host respectively
• Added copilot and copilot.eligibility capability that will get the eligibility information of the user using M365ChatApp. The capability is still awaiting support in one or most host applications. To track availability of this capability across different hosts see https://aka.ms/capmatrix
• Added new AppId class to use as a type where app ids are being stored

Patches

• Fixed a bug with AppEligibilityInformation that could cause app.initialize to fail.
• Added *.m365.cloud.microsoft to dynamic domain list
• Moved AppId type to public folder
• Enabled webStorage capability to be used on Teams Mobile in compatibility scenarios
• Updated documentation on usage of versionAndPlatformAgnosticTeamsRuntimeConfig and mapTeamsVersionToSupportedCapabilities

v2.26.0

Minor changes

• Added self capability that will allow the stage to perform an operation on itself (eg. close). The capability is still awaiting support in one or most host applications. To track availability of this capability across different hosts see https://aka.ms/capmatrix
• Added support for any *.cloud.microsoft domain to be a valid host
• Added new fields to VideoFrameConfig and VideoFrameData to allow specifying additional capabilities to be applied to a video frame and reading arbitrary attributes on a video frame respectively. The capability is still awaiting support in one or most host applications. To track availability of this capability across different hosts see https://aka.ms/capmatrix
• Added chatId in pages.navigateToApp api for deep link support in chat

Patches

• Added WXP domain for unified store to the dynamic domain list
• Fixed behavior of the isValidOriginsCacheEmpty function whose name was backwards of what it was actually doing
• Updated error handling of malformed/missing origin URLs
• Updated authentication.getUser to properly unwrap SdkError returned from host into a message
• Used app and authentication apis for diagnostic app functionality.

v2.25.0

Patches

• Fixed dialog.url.submit api to support only FrameContext.content.
• Updated clipboard.isSupported so that it does not depend on navigator.clipboard in frameless contexts.
• Updated whitespace in clipboard.ts to match conventions

v2.24.0

Minor changes

• Updated app.lifecycle.registerBeforeSuspendOrTerminateHandler to be asynchronous, and updated app.lifecycle.registerOnResumeHandler to accept a new Handler type, changing contentUrl from string to URL object.
• Added uuid parameter to MessageRequest and MessageResponse interfaces
• Added a new page property (isBackgroundLoad) for app context. This will be an indicator that the app is being loaded in the background.

v2.23.0

Minor changes

• Added a new API externalAppAuthentication.authenticateWithPowerPlatformConnectorPlugins. It can be used to perform authentication with Power Platform connector plugins.
• Added messageChannels.telemetry and moved existing telemetryPort code into it. Added new messageChannels.dataLayer subcapability and added code for interacting with the host data layer.
• Added meeting.getMeetingDetailsVerbose to allow retrieving additional meeting details from supported hosts.
• Added support for content frame context to liveShare capability. Live Share SDK works now in Chat/Channel Tab and Collab Stage view contexts with this change.

Patches

• Cleaned up import structure in the private folder
• Fixed API telemetry tag for pages.navigateToApp function
• Updated authentication.authenticate so that it only accepts https URLs.
• Added validMessageOrigins to be passed to parentWindow.
• Updated webStorage capability to query host for capability support, rather than using a hardcoded answer.
• Fixed a bug with exported const enums
• Made a skeletonized version of the buffer npm package as a temporary measure to reduce bundle size

v2.22.0

Minor changes

• Added OtherAppStateChange capability that will allow limited 1P apps to receive events when other apps are installed on the host. The capability is still awaiting support in one or more host applications. To track availability of this capability across different hosts see https://aka.ms/capmatrix
• Added an optional parameter fromElement to processActionOpenUrl in externalAppCardActions
• Validate appId in all APIs in externalAppAuthentication, externalAppCardActions and externalAppCommands.
• Added nested app auth support check api for app developers
• Added a new API externalAppAuthentication.authenticateWithOauth2. It can be used to signal to the host to perform Oauth2 authentication for the app specified by title id.
• Added externalAppCommands 1P internal-only capability

Patches

• Made some enums const to reduce package size
• Fixed clipboard issue for desktop client to resolve 'DOMExecption: Document not focused' error
• Removed one default valid origin
• Removed validation that appIds are UUIDs since some very old published apps have IDs that are not UUIDs (they were published before the manifest schema specified they had to be UUIDs)

v2.21.0

Minor changes

• Added meeting.joinMeeting function
• Removed Beta/Preview tag on chat capability. To track availability of this capability across different hosts see https://aka.ms/capmatrix

Patches

• Updated all capabilities to include versions to enable hosts to identify exact function being used
• Updated documentation on OpenSingleChatRequest interface and updated all URLs to remove locale-specific portions.
• Updated base64ToBlob function to accept special characters
• Removed one default valid origin
• Fixed bug where authentication.getUser telemetry was being incorrectly recorded
• Fixed bug in API Version telemetry

v2.20.0

Wed, 07 Feb 2024 18:02:49 GMT

Minor changes

• Added communication for nested app auth
• Added private MessageChannels capability
• Enabled acquiring of access token for cross-tenant resources
• Added new subcapability dialog.url.parentCommunication for dialog-parent communication related APIs. The isSupported function in this subcapability will return false if it is invoked from a parentless scenario.

Patches

• Added telemetry for appInitialization, appInstallDialog, appWindow, calendar, and videoEffectEx capabilities.
• Added apiVersionTag for telemetry in Profile, Search, SecondaryBrowser, Settings, Sharing, StageView, VideoEffects and VisualMedia capabilites
• Fixed bug where thirdPartyCloudStorage.getDragAndDropFiles failed deterministically
• Updated eslint package and fixed subsequent linting errors
• Removed unused callbackUrl parameter from authentication.notifySuccess and authentication.notifyFailure (in an API-compatible way)
• Added telemetry to chat, interactive, meeting, menus,monetization and people capabilities
• Added apiVersionTags for telemetry in Conversations, Files, Logs, MeetingRoom and Notifications capabilities
• Added windows.msn.com to validOrigins list
• Added apiVersionTag for telemetry in privateAPIs and remoteCamera, teams, videoEffectsEx capabilities