@microsoft/teams-js 2.57.0-beta.0 → 2.58.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.56.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.58.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.56.0/js/MicrosoftTeams.min.js"
-  integrity="sha384-ftygCQXhLMbuUBdLMhfAnIFTGb2SAYYAPD9iyq2LRkbWpKkEifAGD+qPVcPgthO2"
+  src="https://res.cdn.office.net/teams-js/2.58.0/js/MicrosoftTeams.min.js"
+  integrity="sha384-sMo/EOqQPa1OCup2/VBRum7oFeOS22kvs8WGDc45xK53tUVZzFR5WwFYDUYN1LO4"
   crossorigin="anonymous"
 ></script>
 
 <!-- Microsoft Teams JavaScript API (via npm) -->
-<script src="node_modules/@microsoft/teams-js@2.56.0/dist/MicrosoftTeams.min.js"></script>
+<script src="node_modules/@microsoft/teams-js@2.58.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/runtime.d.ts

@@ -98,7 +98,9 @@ interface IRuntimeV4 extends IBaseRuntime {
         };
         readonly shortcutRelay?: {};
         readonly stageView?: {
-            readonly self?: {};
+            readonly self?: {
+                readonly closeResult?: {};
+            };
         };
         readonly store?: {};
         readonly teams?: {

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

@@ -6,12 +6,17 @@
  */
 /**
  * Closes the current stage view. This function will be a no-op if called from outside of a stage view.
+ * @param result - Optional opaque serialized result passed to the host when closing.
+ * An empty string is a result. Requires the host to advertise `stageView.self.closeResult` support;
+ * otherwise the request is rejected without closing. The SDK does not interpret the result.
  * @returns Promise that resolves or rejects with an error once the stage view is closed.
+ * The promise acknowledges closing; it does not return the result to the closing application.
+ * This does not add a result callback to `stageView.open()`.
  *
  * @beta
  * @throws Error if stageView.self.close is not supported in the current context or if `app.initialize()` has not resolved successfully.
  */
-export declare function close(): Promise<void>;
+export declare function close(result?: string): Promise<void>;
 /**
  * Checks if stageView.self capability is supported by the host
  * @beta
@@ -21,3 +26,11 @@ export declare function close(): Promise<void>;
  *
  */
 export declare function isSupported(): boolean;
+/**
+ * Checks whether the host supports passing a result when closing a stage view.
+ *
+ * @beta
+ * @returns true if the host supports Stage close results; otherwise false.
+ * @throws Error if {@linkcode app.initialize} has not successfully completed.
+ */
+export declare function isCloseResultSupported(): boolean;

package/dist/esm/packages/teams-js/src/artifactsForCDN/validDomains.json.js

@@ -1 +1 @@
-var o=["teams.microsoft.com","teams.microsoft.us","gov.teams.microsoft.us","dod.teams.microsoft.us","int.teams.microsoft.com","outlook.office.com","outlook-sdf.office.com","outlook.office365.com","outlook-sdf.office365.com","outlook.office365.us","outlook-dod.office365.us","webmail.apps.mil","outlook.live.com","outlook-sdf.live.com","teams.live.com","local.teams.live.com","local.teams.live.com:8080","local.teams.office.com","local.teams.office.com:8080","devspaces.skype.com","*.www.office.com","www.office.com","word.office.com","excel.office.com","powerpoint.office.com","www.officeppe.com","*.www.microsoft365.com","www.microsoft365.com","bing.com","edgeservices.bing.com","work.bing.com","www.bing.com","www.staging-bing-int.com","*.cloud.microsoft","*.m365.cloud.microsoft","*.outlook.cloud.microsoft","chatuxmanager.svc.cloud.microsoft","copilot.microsoft.com","windows.msn.com","fa000000125.resources.office.net","fa000000129.resources.office.net","fa000000124.resources.office.net","fa000000128.resources.office.net","fa000000136.resources.office.net","fa000000125.officeapps.live.com","fa000000129.officeapps.live.com","fa000000124.officeapps.live.com","fa000000128.officeapps.live.com","fa000000136.mro1cdnstorage.public.cdn.office.net","fa000000136.mro1cdnstorage.public.onecdn.static.microsoft","substrate-msb-bizchatvnext-service.sdf01.substrate-msb-bingatwork.eastus2-sdf.cosmic-ppe.office.net","office-home-m365copilotapp.wus2sdf1.office-home-m365copilotapp.westus2-sdf.cosmic-ppe.office.net","office-home-m365copilotapp.wus2test1.office-home-m365copilotapp.westus2-test.cosmic-int.office.net","m365copilotapp.svc.cloud.microsoft","m365copilotapp.svc.cloud.dev.microsoft","ffc-copilot.officeapps.live.com","m365.cloud.dev.microsoft","m365.cloud.dev.microsoft:3001","portal.officeppe.com","ignite.m365.admin.cloud.microsoft","ignite.admin.cloud.microsoft","sdf.m365.admin.cloud.microsoft","admin-sdf.microsoft.com","canary.m365.admin.cloud.microsoft","ring0.m365.admin.cloud.microsoft","admin.microsoft.com","m365.admin.cloud.microsoft","portal.office365.us","portal.apps.mil","www.ohome.apps.mil","www.office365.us"],c={validOrigins:o};export{c as default,o as validOrigins};
+var o=["teams.microsoft.com","teams.microsoft.us","gov.teams.microsoft.us","dod.teams.microsoft.us","int.teams.microsoft.com","outlook.office.com","outlook-sdf.office.com","outlook.office365.com","outlook-sdf.office365.com","outlook.office365.us","outlook-dod.office365.us","webmail.apps.mil","outlook.live.com","outlook-sdf.live.com","teams.live.com","local.teams.live.com","local.teams.live.com:8080","local.teams.office.com","local.teams.office.com:8080","devspaces.skype.com","*.www.office.com","www.office.com","word.office.com","excel.office.com","powerpoint.office.com","www.officeppe.com","*.www.microsoft365.com","www.microsoft365.com","bing.com","edgeservices.bing.com","work.bing.com","www.bing.com","www.staging-bing-int.com","*.cloud.microsoft","*.m365.cloud.microsoft","*.outlook.cloud.microsoft","chatuxmanager.svc.cloud.microsoft","copilot.microsoft.com","windows.msn.com","fa000000125.resources.office.net","fa000000129.resources.office.net","fa000000124.resources.office.net","fa000000128.resources.office.net","fa000000136.resources.office.net","fa000000125.officeapps.live.com","fa000000129.officeapps.live.com","fa000000124.officeapps.live.com","fa000000128.officeapps.live.com","fa000000136.mro1cdnstorage.public.cdn.office.net","fa000000136.mro1cdnstorage.public.onecdn.static.microsoft","substrate.office.com","copilot-connectors.core.microsoft","substrate-msb-bizchatvnext-service.sdf01.substrate-msb-bingatwork.eastus2-sdf.cosmic-ppe.office.net","office-home-m365copilotapp.wus2sdf1.office-home-m365copilotapp.westus2-sdf.cosmic-ppe.office.net","office-home-m365copilotapp.wus2test1.office-home-m365copilotapp.westus2-test.cosmic-int.office.net","m365copilotapp.svc.cloud.microsoft","cr.m365copilotapp.svc.cloud.microsoft","m365copilotapp.svc.usgovcloud.microsoft","cr.m365copilotapp.svc.usgovcloud.microsoft","dod.m365copilotapp.svc.usgovcloud.microsoft","cr.dod.m365copilotapp.svc.usgovcloud.microsoft","m365copilotapp.svc.cloud.dev.microsoft","ffc-copilot.officeapps.live.com","m365.cloud.dev.microsoft","m365.cloud.dev.microsoft:3001","portal.officeppe.com","ignite.m365.admin.cloud.microsoft","ignite.admin.cloud.microsoft","sdf.m365.admin.cloud.microsoft","admin-sdf.microsoft.com","canary.m365.admin.cloud.microsoft","ring0.m365.admin.cloud.microsoft","admin.microsoft.com","m365.admin.cloud.microsoft","portal.office365.us","portal.apps.mil","www.ohome.apps.mil","www.office365.us"],c={validOrigins:o};export{c as default,o as validOrigins};

package/dist/esm/packages/teams-js/src/public/stageView/self.js

@@ -1 +1 @@
-import{sendAndHandleSdkError as t}from"../../internal/communication.js";import{ensureInitialized as e}from"../../internal/internalAPIs.js";import{getApiVersionTag as o}from"../../internal/telemetry.js";import{FrameContexts as r,errorNotSupportedOnPlatform as n}from"../constants.js";import{runtime as i}from"../runtime.js";function s(){return new Promise(s=>{if(e(i,r.content),!m())throw n;s(t(o("v2","stageView.self.close"),"stageView.self.close"))})}function m(){var t;return e(i)&&void 0!==(null===(t=i.supports.stageView)||void 0===t?void 0:t.self)}export{s as close,m as isSupported};
+import{sendAndHandleSdkError as e}from"../../internal/communication.js";import{ensureInitialized as o}from"../../internal/internalAPIs.js";import{getApiVersionTag as t}from"../../internal/telemetry.js";import{FrameContexts as i,errorNotSupportedOnPlatform as r}from"../constants.js";import{runtime as s}from"../runtime.js";function n(n){return new Promise(m=>{if(o(s,i.content),!l()||void 0!==n&&!f())throw r;if(void 0!==n&&"string"!=typeof n)throw new Error("[stageView.self.close] Result must be a string");m(e(t("v2","stageView.self.close"),"stageView.self.close",...void 0===n?[]:[n]))})}function l(){var e;return o(s)&&void 0!==(null===(e=s.supports.stageView)||void 0===e?void 0:e.self)}function f(){var e,t;return o(s)&&!!(null===(t=null===(e=s.supports.stageView)||void 0===e?void 0:e.self)||void 0===t?void 0:t.closeResult)}export{n as close,f as isCloseResultSupported,l as isSupported};

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

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

package/dist/umd/MicrosoftTeams.js

@@ -1979,6 +1979,7 @@ var self_namespaceObject = {};
 __webpack_require__.r(self_namespaceObject);
 __webpack_require__.d(self_namespaceObject, {
   close: () => (self_close),
+  isCloseResultSupported: () => (isCloseResultSupported),
   isSupported: () => (self_isSupported)
 });
 
@@ -2338,7 +2339,7 @@ var ClipboardSupportedMimeType;
 })(ClipboardSupportedMimeType || (ClipboardSupportedMimeType = {}));
 
 ;// ./src/artifactsForCDN/validDomains.json
-const validDomains_namespaceObject = /*#__PURE__*/JSON.parse('{"validOrigins":["teams.microsoft.com","teams.microsoft.us","gov.teams.microsoft.us","dod.teams.microsoft.us","int.teams.microsoft.com","outlook.office.com","outlook-sdf.office.com","outlook.office365.com","outlook-sdf.office365.com","outlook.office365.us","outlook-dod.office365.us","webmail.apps.mil","outlook.live.com","outlook-sdf.live.com","teams.live.com","local.teams.live.com","local.teams.live.com:8080","local.teams.office.com","local.teams.office.com:8080","devspaces.skype.com","*.www.office.com","www.office.com","word.office.com","excel.office.com","powerpoint.office.com","www.officeppe.com","*.www.microsoft365.com","www.microsoft365.com","bing.com","edgeservices.bing.com","work.bing.com","www.bing.com","www.staging-bing-int.com","*.cloud.microsoft","*.m365.cloud.microsoft","*.outlook.cloud.microsoft","chatuxmanager.svc.cloud.microsoft","copilot.microsoft.com","windows.msn.com","fa000000125.resources.office.net","fa000000129.resources.office.net","fa000000124.resources.office.net","fa000000128.resources.office.net","fa000000136.resources.office.net","fa000000125.officeapps.live.com","fa000000129.officeapps.live.com","fa000000124.officeapps.live.com","fa000000128.officeapps.live.com","fa000000136.mro1cdnstorage.public.cdn.office.net","fa000000136.mro1cdnstorage.public.onecdn.static.microsoft","substrate-msb-bizchatvnext-service.sdf01.substrate-msb-bingatwork.eastus2-sdf.cosmic-ppe.office.net","office-home-m365copilotapp.wus2sdf1.office-home-m365copilotapp.westus2-sdf.cosmic-ppe.office.net","office-home-m365copilotapp.wus2test1.office-home-m365copilotapp.westus2-test.cosmic-int.office.net","m365copilotapp.svc.cloud.microsoft","m365copilotapp.svc.cloud.dev.microsoft","ffc-copilot.officeapps.live.com","m365.cloud.dev.microsoft","m365.cloud.dev.microsoft:3001","portal.officeppe.com","ignite.m365.admin.cloud.microsoft","ignite.admin.cloud.microsoft","sdf.m365.admin.cloud.microsoft","admin-sdf.microsoft.com","canary.m365.admin.cloud.microsoft","ring0.m365.admin.cloud.microsoft","admin.microsoft.com","m365.admin.cloud.microsoft","portal.office365.us","portal.apps.mil","www.ohome.apps.mil","www.office365.us"]}');
+const validDomains_namespaceObject = /*#__PURE__*/JSON.parse('{"validOrigins":["teams.microsoft.com","teams.microsoft.us","gov.teams.microsoft.us","dod.teams.microsoft.us","int.teams.microsoft.com","outlook.office.com","outlook-sdf.office.com","outlook.office365.com","outlook-sdf.office365.com","outlook.office365.us","outlook-dod.office365.us","webmail.apps.mil","outlook.live.com","outlook-sdf.live.com","teams.live.com","local.teams.live.com","local.teams.live.com:8080","local.teams.office.com","local.teams.office.com:8080","devspaces.skype.com","*.www.office.com","www.office.com","word.office.com","excel.office.com","powerpoint.office.com","www.officeppe.com","*.www.microsoft365.com","www.microsoft365.com","bing.com","edgeservices.bing.com","work.bing.com","www.bing.com","www.staging-bing-int.com","*.cloud.microsoft","*.m365.cloud.microsoft","*.outlook.cloud.microsoft","chatuxmanager.svc.cloud.microsoft","copilot.microsoft.com","windows.msn.com","fa000000125.resources.office.net","fa000000129.resources.office.net","fa000000124.resources.office.net","fa000000128.resources.office.net","fa000000136.resources.office.net","fa000000125.officeapps.live.com","fa000000129.officeapps.live.com","fa000000124.officeapps.live.com","fa000000128.officeapps.live.com","fa000000136.mro1cdnstorage.public.cdn.office.net","fa000000136.mro1cdnstorage.public.onecdn.static.microsoft","substrate.office.com","copilot-connectors.core.microsoft","substrate-msb-bizchatvnext-service.sdf01.substrate-msb-bingatwork.eastus2-sdf.cosmic-ppe.office.net","office-home-m365copilotapp.wus2sdf1.office-home-m365copilotapp.westus2-sdf.cosmic-ppe.office.net","office-home-m365copilotapp.wus2test1.office-home-m365copilotapp.westus2-test.cosmic-int.office.net","m365copilotapp.svc.cloud.microsoft","cr.m365copilotapp.svc.cloud.microsoft","m365copilotapp.svc.usgovcloud.microsoft","cr.m365copilotapp.svc.usgovcloud.microsoft","dod.m365copilotapp.svc.usgovcloud.microsoft","cr.dod.m365copilotapp.svc.usgovcloud.microsoft","m365copilotapp.svc.cloud.dev.microsoft","ffc-copilot.officeapps.live.com","m365.cloud.dev.microsoft","m365.cloud.dev.microsoft:3001","portal.officeppe.com","ignite.m365.admin.cloud.microsoft","ignite.admin.cloud.microsoft","sdf.m365.admin.cloud.microsoft","admin-sdf.microsoft.com","canary.m365.admin.cloud.microsoft","ring0.m365.admin.cloud.microsoft","admin.microsoft.com","m365.admin.cloud.microsoft","portal.office365.us","portal.apps.mil","www.ohome.apps.mil","www.office365.us"]}');
 var artifactsForCDN_validDomains_namespaceObject = /*#__PURE__*/__webpack_require__.t(validDomains_namespaceObject, 2);
 ;// ./src/internal/constants.ts
 
@@ -4707,7 +4708,7 @@ function isSerializable(arg) {
  * @hidden
  *  Package version.
  */
-const version = "2.57.0-beta.0";
+const version = "2.58.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.
@@ -18732,18 +18733,26 @@ function sharing_isSupported() {
 const stageViewTelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
 /**
  * Closes the current stage view. This function will be a no-op if called from outside of a stage view.
+ * @param result - Optional opaque serialized result passed to the host when closing.
+ * An empty string is a result. Requires the host to advertise `stageView.self.closeResult` support;
+ * otherwise the request is rejected without closing. The SDK does not interpret the result.
  * @returns Promise that resolves or rejects with an error once the stage view is closed.
+ * The promise acknowledges closing; it does not return the result to the closing application.
+ * This does not add a result callback to `stageView.open()`.
  *
  * @beta
  * @throws Error if stageView.self.close is not supported in the current context or if `app.initialize()` has not resolved successfully.
  */
-function self_close() {
+function self_close(result) {
     return new Promise((resolve) => {
         ensureInitialized(runtime, FrameContexts.content);
-        if (!self_isSupported()) {
+        if (!self_isSupported() || (result !== undefined && !isCloseResultSupported())) {
             throw errorNotSupportedOnPlatform;
         }
-        resolve(sendAndHandleSdkError(getApiVersionTag(stageViewTelemetryVersionNumber, "stageView.self.close" /* ApiName.StageView_Self_Close */), 'stageView.self.close'));
+        if (result !== undefined && typeof result !== 'string') {
+            throw new Error('[stageView.self.close] Result must be a string');
+        }
+        resolve(sendAndHandleSdkError(getApiVersionTag(stageViewTelemetryVersionNumber, "stageView.self.close" /* ApiName.StageView_Self_Close */), 'stageView.self.close', ...(result === undefined ? [] : [result])));
     });
 }
 /**
@@ -18758,6 +18767,17 @@ function self_isSupported() {
     var _a;
     return ensureInitialized(runtime) && ((_a = runtime.supports.stageView) === null || _a === void 0 ? void 0 : _a.self) !== undefined;
 }
+/**
+ * Checks whether the host supports passing a result when closing a stage view.
+ *
+ * @beta
+ * @returns true if the host supports Stage close results; otherwise false.
+ * @throws Error if {@linkcode app.initialize} has not successfully completed.
+ */
+function isCloseResultSupported() {
+    var _a, _b;
+    return ensureInitialized(runtime) && !!((_b = (_a = runtime.supports.stageView) === null || _a === void 0 ? void 0 : _a.self) === null || _b === void 0 ? void 0 : _b.closeResult);
+}
 
 ;// ./src/public/stageView/stageView.ts
 /**