@microsoft/teams-js 2.51.0 → 2.53.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.51.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.53.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.51.0/js/MicrosoftTeams.min.js"
-  integrity="sha384-U54aLArLUNmLIfKxJ7P5Ybiq6sXmSH6aNROHNdKLpABDXH+KB/wE17SEz43/zsAe"
+  src="https://res.cdn.office.net/teams-js/2.53.0/js/MicrosoftTeams.min.js"
+  integrity="sha384-UFKwOGC8ix6vOFFC4vH8hSpjwkQXZmSjCx8aaxwhbtm+6joQdNvD7b4pPk82cYAD"
   crossorigin="anonymous"
 ></script>
 
 <!-- Microsoft Teams JavaScript API (via npm) -->
-<script src="node_modules/@microsoft/teams-js@2.51.0/dist/MicrosoftTeams.min.js"></script>
+<script src="node_modules/@microsoft/teams-js@2.53.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/public/sharing/sharing.d.ts

@@ -15,14 +15,14 @@ export declare const SharingAPIMessages: {
      */
     shareWebContent: string;
 };
-type ContentType = 'URL';
+type ContentType = 'URL' | 'FILE';
 /** Represents parameters for base shared content. */
 interface IBaseSharedContent {
     /** Shared content type  */
     type: ContentType;
 }
 /** IShareRequestContentType defines share request type. */
-export type IShareRequestContentType = IURLContent;
+export type IShareRequestContentType = IURLContent | IFileContent;
 /** Represents IShareRequest parameters interface.
  * @typeparam T - The identity type
  */
@@ -30,6 +30,23 @@ export interface IShareRequest<T> {
     /** Content of the share request. */
     content: T[];
 }
+/** Represents IFileContent parameters. */
+export interface IFileContent extends IBaseSharedContent {
+    /** Type */
+    type: 'FILE';
+    /**
+     * Required URL of the file to share
+     */
+    url: string;
+    /**
+     * Default initial message text
+     */
+    message?: string;
+    /**
+     * Show file preview, defaults to true
+     */
+    preview?: boolean;
+}
 /** Represents IURLContent parameters. */
 export interface IURLContent extends IBaseSharedContent {
     /** Type */

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

@@ -1,8 +1,6 @@
 /**
  * Allows host shortcuts to function in your application by forwarding keyboard shortcuts to the host.
  *
- * This functionality is in Beta.
- * @beta
  * @module
  */
 /**
@@ -26,20 +24,17 @@ export type OverridableShortcutHandler = (event: KeyboardEvent, data: Overridabl
  * • Pass `undefined` to remove an existing handler.
  * • Returns the previous handler so callers can restore it if needed.
  *
- * @beta
  */
 export declare function setOverridableShortcutHandler(handler: OverridableShortcutHandler | undefined): OverridableShortcutHandler | undefined;
 /**
  * Reset the state of the shortcut relay capability.
  * This is useful for tests to ensure a clean state.
  *
- * @beta
  */
 export declare function resetIsShortcutRelayCapabilityEnabled(): void;
 /**
  * Enable capability to support host shortcuts.
  *
- * @beta
  */
 export declare function enableShortcutRelayCapability(): Promise<void>;
 /**
@@ -48,13 +43,11 @@ export declare function enableShortcutRelayCapability(): Promise<void>;
  *
  * @throws Error if {@link app.initialize} has not successfully completed
  *
- * @beta
  */
 export declare function isSupported(): boolean;
 /**
  * Allow apps to define zones where shortcuts should not be forwarded to the host.
  * This is useful for input fields for password where shortcuts should not trigger host actions.
  *
- * @beta
  */
 export declare const DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE = "data-disable-shortcuts-forwarding";

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

@@ -1 +1 @@
-import{sendAndHandleSdkError as e}from"../../internal/communication.js";import{ensureInitialized as t}from"../../internal/internalAPIs.js";import{getApiVersionTag as n}from"../../internal/telemetry.js";import{callCallbackWithSdkErrorFromPromiseAndReturnPromise as r}from"../../internal/utils.js";import{FrameContexts as o,errorNotSupportedOnPlatform as s}from"../constants.js";import{ErrorCode as i}from"../interfaces.js";import{runtime as m}from"../runtime.js";import*as a from"./history.js";export{a as history};const c={shareWebContent:"sharing.shareWebContent"};function f(e,s){try{!function(e){if(!(e&&e.content&&e.content.length)){throw{errorCode:i.INVALID_ARGUMENTS,message:"Shared content is missing"}}}(e),function(e){let t;if(e.content.some(e=>!e.type))throw t={errorCode:i.INVALID_ARGUMENTS,message:"Shared content type cannot be undefined"},t;if(e.content.some(t=>t.type!==e.content[0].type))throw t={errorCode:i.INVALID_ARGUMENTS,message:"Shared content must be of the same type"},t}(e),function(e){let t;if("URL"!==e.content[0].type)throw t={errorCode:i.INVALID_ARGUMENTS,message:"Content type is unsupported"},t;if(e.content.some(e=>!e.url))throw t={errorCode:i.INVALID_ARGUMENTS,message:"URLs are required for URL content types"},t}(e)}catch(e){return r(()=>Promise.reject(e),s)}t(m,o.content,o.sidePanel,o.task,o.stage,o.meetingStage);const a=n(s?"v1":"v2","sharing.shareWebContent");return r(p,s,a,e)}function p(t,n){return new Promise(r=>{if(!h())throw s;r(e(t,c.shareWebContent,n))})}function h(){return!(!t(m)||!m.supports.sharing)}export{c as SharingAPIMessages,h as isSupported,f as shareWebContent};
+import{sendAndHandleSdkError as e}from"../../internal/communication.js";import{ensureInitialized as t}from"../../internal/internalAPIs.js";import{getApiVersionTag as r}from"../../internal/telemetry.js";import{callCallbackWithSdkErrorFromPromiseAndReturnPromise as n}from"../../internal/utils.js";import{FrameContexts as o,errorNotSupportedOnPlatform as s}from"../constants.js";import{ErrorCode as i}from"../interfaces.js";import{runtime as a}from"../runtime.js";import*as m from"./history.js";export{m as history};const c={shareWebContent:"sharing.shareWebContent"};function f(e,s){try{!function(e){if(!(e&&e.content&&e.content.length)){throw{errorCode:i.INVALID_ARGUMENTS,message:"Shared content is missing"}}}(e),function(e){let t;if(e.content.some(e=>!e.type))throw t={errorCode:i.INVALID_ARGUMENTS,message:"Shared content type cannot be undefined"},t;if(e.content.some(t=>t.type!==e.content[0].type))throw t={errorCode:i.INVALID_ARGUMENTS,message:"Shared content must be of the same type"},t}(e),e.content.forEach(h)}catch(e){return n(()=>Promise.reject(e),s)}t(a,o.content,o.sidePanel,o.task,o.stage,o.meetingStage);const m=r(s?"v1":"v2","sharing.shareWebContent");return n(p,s,m,e)}function p(t,r){return new Promise(n=>{if(!u())throw s;n(e(t,c.shareWebContent,r))})}function h(e){if("URL"===e.type){if(!e.url)throw{errorCode:i.INVALID_ARGUMENTS,message:"URLs are required for URL content types"}}else{if("FILE"!==e.type)throw{errorCode:i.INVALID_ARGUMENTS,message:"Content type is unsupported"};if(!e.url)throw{errorCode:i.INVALID_ARGUMENTS,message:"File URLs are required for File content types"}}}function u(){return!(!t(a)||!a.supports.sharing)}export{c as SharingAPIMessages,u as isSupported,f as shareWebContent};

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

@@ -1 +1 @@
-import{__awaiter as t}from"../../../../node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.55.1_tslib@2.8.1_typescript@4.9.5/node_modules/tslib/tslib.es6.js";import{callFunctionInHost as e,callFunctionInHostAndHandleResponse as r}from"../internal/communication.js";import{registerHandler as o}from"../internal/handlers.js";import{ensureInitialized as n}from"../internal/internalAPIs.js";import{ResponseHandler as s}from"../internal/responseHandler.js";import{getApiVersionTag as i}from"../internal/telemetry.js";import{errorNotSupportedOnPlatform as a}from"./constants.js";import{runtime as c}from"./runtime.js";class h{constructor(t){this.event=t}serialize(){return{altKey:this.event.altKey,bubbles:this.event.bubbles,cancelBubble:this.event.cancelBubble,charCode:this.event.charCode,code:this.event.code,composed:this.event.composed,ctrlKey:this.event.ctrlKey,defaultPrevented:this.event.defaultPrevented,detail:this.event.detail,eventPhase:this.event.eventPhase,isComposing:this.event.isComposing,isTrusted:this.event.isTrusted,key:this.event.key,keyCode:this.event.keyCode,location:this.event.location,metaKey:this.event.metaKey,repeat:this.event.repeat,returnValue:this.event.returnValue,shiftKey:this.event.shiftKey,timeStamp:this.event.timeStamp,type:this.event.type,which:this.event.which}}}function u(t){return t.toLowerCase().split("+").sort().join("+")}function l(t,e){if(function(t){return t.ctrlKey||t.shiftKey||t.altKey||t.metaKey||!!t.key&&"escape"===t.key.toLowerCase()}(e)){const r=function(t){return[t.ctrlKey&&"ctrl",t.shiftKey&&"shift",t.altKey&&"alt",t.metaKey&&"meta",t.key.toLowerCase()].filter(Boolean).sort().join("+")}(e);if(t.has(r))return{matchedShortcut:r,isOverridable:f.has(r)}}return{matchedShortcut:void 0,isOverridable:!1}}function d(t){y.clear(),t.shortcuts.forEach(t=>{y.add(u(t))}),f.clear(),t.overridableShortcuts.forEach(t=>{f.add(u(t))})}class v extends s{validate(t){return t&&Array.isArray(t.shortcuts)&&Array.isArray(t.overridableShortcuts)}deserialize(t){return t}}function m(t){if(t.target.closest(`[${g}]`))return;const{matchedShortcut:r,isOverridable:o}=l(y,t);if(!r)return;if(o&&p){if(p(t,{matchedShortcut:r}))return}const n=new h(t);e("shortcutRelay.forwardShortcutEvent",[n],i("v2","shortcutRelay.forwardShortcutEvent")),t.preventDefault(),t.stopImmediatePropagation()}const f=new Set,y=new Set;let p,b=!1;function w(t){if(!C())throw a;const e=p;return p=t,e}function K(){if(!C())throw a;b=!1,y.clear(),f.clear(),p=void 0,document.removeEventListener("keydown",m,{capture:!0})}function S(){return t(this,void 0,void 0,function*(){if(!C())throw a;var t;d(yield r("shortcutRelay.getHostShortcuts",[],new v,i("v2","shortcutRelay.getHostShortcuts"))),b||document.addEventListener("keydown",m,{capture:!0}),b=!0,t=t=>{d(t)},o(i("v2","shortcutRelay.hostShortcutChanged"),"shortcutRelay.hostShortcutChanged",t)})}function C(){return!(!n(c)||!c.supports.shortcutRelay)}const g="data-disable-shortcuts-forwarding";export{g as DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE,S as enableShortcutRelayCapability,C as isSupported,K as resetIsShortcutRelayCapabilityEnabled,w as setOverridableShortcutHandler};
+import{__awaiter as t}from"../../../../node_modules/.pnpm/@rollup_plugin-typescript@11.1.6_rollup@4.55.1_tslib@2.8.1_typescript@4.9.5/node_modules/tslib/tslib.es6.js";import{callFunctionInHost as e,callFunctionInHostAndHandleResponse as r}from"../internal/communication.js";import{registerHandler as o}from"../internal/handlers.js";import{ensureInitialized as n}from"../internal/internalAPIs.js";import{ResponseHandler as s}from"../internal/responseHandler.js";import{getApiVersionTag as i}from"../internal/telemetry.js";import{errorNotSupportedOnPlatform as a}from"./constants.js";import{runtime as c}from"./runtime.js";class h{constructor(t){this.event=t}serialize(){return{altKey:this.event.altKey,bubbles:this.event.bubbles,cancelBubble:this.event.cancelBubble,charCode:this.event.charCode,code:this.event.code,composed:this.event.composed,ctrlKey:this.event.ctrlKey,defaultPrevented:this.event.defaultPrevented,detail:this.event.detail,eventPhase:this.event.eventPhase,isComposing:this.event.isComposing,isTrusted:this.event.isTrusted,key:this.event.key,keyCode:this.event.keyCode,location:this.event.location,metaKey:this.event.metaKey,repeat:this.event.repeat,returnValue:this.event.returnValue,shiftKey:this.event.shiftKey,timeStamp:this.event.timeStamp,type:this.event.type,which:this.event.which}}}function u(t){return t.toLowerCase().split("+").sort().join("+")}function l(t,e){if(function(t){return t.ctrlKey||t.shiftKey||t.altKey||t.metaKey||!!t.key&&"escape"===t.key.toLowerCase()||!!t.key&&/^F\d+$/i.test(t.key)}(e)){const r=function(t){return[t.ctrlKey&&"ctrl",t.shiftKey&&"shift",t.altKey&&"alt",t.metaKey&&"meta",t.key.toLowerCase()].filter(Boolean).sort().join("+")}(e);if(t.has(r))return{matchedShortcut:r,isOverridable:y.has(r)}}return{matchedShortcut:void 0,isOverridable:!1}}function d(t){f.clear(),t.shortcuts.forEach(t=>{f.add(u(t))}),y.clear(),t.overridableShortcuts.forEach(t=>{y.add(u(t))})}class v extends s{validate(t){return t&&Array.isArray(t.shortcuts)&&Array.isArray(t.overridableShortcuts)}deserialize(t){return t}}function m(t){if(t.target.closest(`[${C}]`))return;const{matchedShortcut:r,isOverridable:o}=l(f,t);if(!r)return;if(o&&p){if(p(t,{matchedShortcut:r}))return}const n=new h(t);e("shortcutRelay.forwardShortcutEvent",[n],i("v2","shortcutRelay.forwardShortcutEvent")),t.preventDefault(),t.stopImmediatePropagation()}const y=new Set,f=new Set;let p,b=!1;function w(t){if(!k())throw a;const e=p;return p=t,e}function K(){if(!k())throw a;b=!1,f.clear(),y.clear(),p=void 0,document.removeEventListener("keydown",m,{capture:!0})}function S(){return t(this,void 0,void 0,function*(){if(!k())throw a;var t;d(yield r("shortcutRelay.getHostShortcuts",[],new v,i("v2","shortcutRelay.getHostShortcuts"))),b||document.addEventListener("keydown",m,{capture:!0}),b=!0,t=t=>{d(t)},o(i("v2","shortcutRelay.hostShortcutChanged"),"shortcutRelay.hostShortcutChanged",t)})}function k(){return!(!n(c)||!c.supports.shortcutRelay)}const C="data-disable-shortcuts-forwarding";export{C as DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE,S as enableShortcutRelayCapability,k as isSupported,K as resetIsShortcutRelayCapabilityEnabled,w as setOverridableShortcutHandler};

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

@@ -1 +1 @@
-const o="2.51.0";export{o as version};
+const o="2.53.0";export{o as version};

package/dist/umd/MicrosoftTeams.js

@@ -4679,7 +4679,7 @@ function isSerializable(arg) {
  * @hidden
  *  Package version.
  */
-const version = "2.51.0";
+const version = "2.53.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.
@@ -18386,25 +18386,24 @@ function validateTypeConsistency(shareRequest) {
         throw err;
     }
 }
-function validateContentForSupportedTypes(shareRequest) {
-    let err;
-    if (shareRequest.content[0].type === 'URL') {
-        if (shareRequest.content.some((item) => !item.url)) {
-            err = {
-                errorCode: ErrorCode.INVALID_ARGUMENTS,
-                message: 'URLs are required for URL content types',
-            };
-            throw err;
+function validateContentItem(item) {
+    if (item.type === 'URL') {
+        if (!item.url) {
+            throw { errorCode: ErrorCode.INVALID_ARGUMENTS, message: 'URLs are required for URL content types' };
+        }
+    }
+    else if (item.type === 'FILE') {
+        if (!item.url) {
+            throw { errorCode: ErrorCode.INVALID_ARGUMENTS, message: 'File URLs are required for File content types' };
         }
     }
     else {
-        err = {
-            errorCode: ErrorCode.INVALID_ARGUMENTS,
-            message: 'Content type is unsupported',
-        };
-        throw err;
+        throw { errorCode: ErrorCode.INVALID_ARGUMENTS, message: 'Content type is unsupported' };
     }
 }
+function validateContentForSupportedTypes(shareRequest) {
+    shareRequest.content.forEach(validateContentItem);
+}
 /**
  * Checks if the sharing capability is supported by the host
  * @returns boolean to represent whether the sharing capability is supported
@@ -20350,8 +20349,6 @@ function marketplace_isSupported() {
 /**
  * Allows host shortcuts to function in your application by forwarding keyboard shortcuts to the host.
  *
- * This functionality is in Beta.
- * @beta
  * @module
  */
 var shortcutRelay_awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
@@ -20430,10 +20427,15 @@ function eventToCanonicalShortcut(e) {
 /**
  * Checks if the event is a valid shortcut event.
  * A valid shortcut event is one that has at least one modifier key pressed
- * (ctrl, shift, alt, meta) or the Escape key.
+ * (ctrl, shift, alt, meta), the Escape key, or a function key (F1–F24).
  */
 function isValidShortcutEvent(e) {
-    return e.ctrlKey || e.shiftKey || e.altKey || e.metaKey || (!!e.key && e.key.toLowerCase() === 'escape');
+    return (e.ctrlKey ||
+        e.shiftKey ||
+        e.altKey ||
+        e.metaKey ||
+        (!!e.key && e.key.toLowerCase() === 'escape') ||
+        (!!e.key && /^F\d+$/i.test(e.key)));
 }
 function isMatchingShortcut(shortcuts, e) {
     if (isValidShortcutEvent(e)) {
@@ -20533,7 +20535,6 @@ let isShortcutRelayCapabilityEnabled = false;
  * • Pass `undefined` to remove an existing handler.
  * • Returns the previous handler so callers can restore it if needed.
  *
- * @beta
  */
 function setOverridableShortcutHandler(handler) {
     if (!shortcutRelay_isSupported()) {
@@ -20547,7 +20548,6 @@ function setOverridableShortcutHandler(handler) {
  * Reset the state of the shortcut relay capability.
  * This is useful for tests to ensure a clean state.
  *
- * @beta
  */
 function resetIsShortcutRelayCapabilityEnabled() {
     if (!shortcutRelay_isSupported()) {
@@ -20562,7 +20562,6 @@ function resetIsShortcutRelayCapabilityEnabled() {
 /**
  * Enable capability to support host shortcuts.
  *
- * @beta
  */
 function enableShortcutRelayCapability() {
     return shortcutRelay_awaiter(this, void 0, void 0, function* () {
@@ -20589,7 +20588,6 @@ function enableShortcutRelayCapability() {
  *
  * @throws Error if {@link app.initialize} has not successfully completed
  *
- * @beta
  */
 function shortcutRelay_isSupported() {
     return ensureInitialized(runtime) && runtime.supports.shortcutRelay ? true : false;
@@ -20598,7 +20596,6 @@ function shortcutRelay_isSupported() {
  * Allow apps to define zones where shortcuts should not be forwarded to the host.
  * This is useful for input fields for password where shortcuts should not trigger host actions.
  *
- * @beta
  */
 const DISABLE_SHORTCUT_FORWARDING_ATTRIBUTE = 'data-disable-shortcuts-forwarding';