v2.31.1

2.31.1

Wed, 20 Nov 2024 19:25:55 GMT

Patches

• Fixed a bug causing buffer polyfill to stil be included
• Fixed bugs regarding EduTypenot being exported, and enum typings

v2.31.0

Minor changes

• Made the library treeshakable
• Made externalAppAuthenticationForCEA.ts throw Error objects instead of SdkErrors.
• Replaced Buffer with uint8array-extras to allow for buffer polyfill removal
• Added validation for AppId instance in CEA APIs
• Changed the notifySuccess function to indicate through a promise when the function finished processing in the host.
• Added new timestamp and handler for analyzing latencies due to message delays between app and hub.

Patches

• Add userClickTimeV2 to app Context to provide the timestamp when the user clicked the app using the performance timer API.
• Increased the initialize response wait-timeout to 60 sec
• Removed type: module from package.json to fix nextjs bug
• Added validation for IActionExecuteInvokeRequest.data element in ExternalAppAuthentication and ExternalAppAuthenticationForCEA capabilities. The element can be of type primitive or plain object only

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)