@microsoft/teams-js 2.35.0-beta.0 → 2.35.0-beta.2

package/dist/umd/MicrosoftTeams.js

@@ -1011,7 +1011,9 @@ __webpack_require__.d(__webpack_exports__, {
   UUID: () => (/* reexport */ UUID),
   UserSettingTypes: () => (/* reexport */ UserSettingTypes),
   UserTeamRole: () => (/* reexport */ UserTeamRole),
+  ValidatedSafeString: () => (/* reexport */ validatedSafeString_ValidatedSafeString),
   ViewerActionTypes: () => (/* reexport */ ViewerActionTypes),
+  activateChildProxyingCommunication: () => (/* reexport */ activateChildProxyingCommunication),
   app: () => (/* reexport */ app_namespaceObject),
   appEntity: () => (/* reexport */ appEntity_namespaceObject),
   appInitialization: () => (/* reexport */ appInitialization_namespaceObject),
@@ -1031,11 +1033,13 @@ __webpack_require__.d(__webpack_exports__, {
   externalAppAuthenticationForCEA: () => (/* reexport */ externalAppAuthenticationForCEA_namespaceObject),
   externalAppCardActions: () => (/* reexport */ externalAppCardActions_namespaceObject),
   externalAppCardActionsForCEA: () => (/* reexport */ externalAppCardActionsForCEA_namespaceObject),
+  externalAppCardActionsForDA: () => (/* reexport */ externalAppCardActionsForDA_namespaceObject),
   externalAppCommands: () => (/* reexport */ externalAppCommands_namespaceObject),
   files: () => (/* reexport */ files_namespaceObject),
   geoLocation: () => (/* reexport */ geoLocation_namespaceObject),
   getAdaptiveCardSchemaVersion: () => (/* reexport */ getAdaptiveCardSchemaVersion),
   getContext: () => (/* reexport */ publicAPIs_getContext),
+  getCurrentFeatureFlagsState: () => (/* reexport */ getCurrentFeatureFlagsState),
   getMruTabInstances: () => (/* reexport */ publicAPIs_getMruTabInstances),
   getTabInstances: () => (/* reexport */ publicAPIs_getTabInstances),
   hostEntity: () => (/* reexport */ hostEntity_namespaceObject),
@@ -1059,6 +1063,7 @@ __webpack_require__.d(__webpack_exports__, {
   notifications: () => (/* reexport */ notifications_namespaceObject),
   openFilePreview: () => (/* reexport */ openFilePreview),
   otherAppStateChange: () => (/* reexport */ otherAppStateChange_namespaceObject),
+  overwriteFeatureFlagsState: () => (/* reexport */ overwriteFeatureFlagsState),
   pages: () => (/* reexport */ pages_namespaceObject),
   people: () => (/* reexport */ people_namespaceObject),
   print: () => (/* reexport */ publicAPIs_print),
@@ -1081,6 +1086,7 @@ __webpack_require__.d(__webpack_exports__, {
   secondaryBrowser: () => (/* reexport */ secondaryBrowser_namespaceObject),
   sendCustomEvent: () => (/* reexport */ sendCustomEvent),
   sendCustomMessage: () => (/* reexport */ sendCustomMessage),
+  setFeatureFlagsState: () => (/* reexport */ setFeatureFlagsState),
   setFrameContext: () => (/* reexport */ setFrameContext),
   settings: () => (/* reexport */ settings_namespaceObject),
   shareDeepLink: () => (/* reexport */ publicAPIs_shareDeepLink),
@@ -1412,6 +1418,15 @@ __webpack_require__.d(externalAppCardActionsForCEA_namespaceObject, {
   processActionSubmit: () => (externalAppCardActionsForCEA_processActionSubmit)
 });
 
+// NAMESPACE OBJECT: ./src/private/externalAppCardActionsForDA.ts
+var externalAppCardActionsForDA_namespaceObject = {};
+__webpack_require__.r(externalAppCardActionsForDA_namespaceObject);
+__webpack_require__.d(externalAppCardActionsForDA_namespaceObject, {
+  SerializableActionOpenUrlDialogInfo: () => (SerializableActionOpenUrlDialogInfo),
+  isSupported: () => (externalAppCardActionsForDA_isSupported),
+  processActionOpenUrlDialog: () => (processActionOpenUrlDialog)
+});
+
 // NAMESPACE OBJECT: ./src/private/externalAppCommands.ts
 var externalAppCommands_namespaceObject = {};
 __webpack_require__.r(externalAppCommands_namespaceObject);
@@ -4026,6 +4041,25 @@ class UUID {
     toString() {
         return this.uuid;
     }
+    /**
+     * @returns A serializable representation of an uuid, used for passing uuids to the host.
+     */
+    serialize() {
+        return this.toString();
+    }
+}
+/**
+ * @hidden
+ * Checks if the incoming id is an instance of ValidatedSafeString
+ * @param id An object to check if it's an instance of ValidatedSafeString
+ * @throws Error with a message describing the violation
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function validateUuidInstance(id) {
+    if (!(id instanceof UUID)) {
+        throw new Error(`Potential id (${JSON.stringify(id)}) is invalid; it is not an instance of UUID class.`);
+    }
 }
 
 ;// ./src/internal/telemetry.ts
@@ -4484,7 +4518,65 @@ function isSerializable(arg) {
  * @hidden
  *  Package version.
  */
-const version = "2.35.0-beta.0";
+const version = "2.35.0-beta.2";
+
+;// ./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.
+const buildFeatureFlags = {
+    childProxyingCommunication: false,
+};
+/**
+ * This function enables child proxying communication for apps that still needs it.
+ *
+ * @deprecated Child proxying is considered an insecure feature and will be removed in future releases.
+ */
+function activateChildProxyingCommunication() {
+    buildFeatureFlags.childProxyingCommunication = true;
+}
+/**
+ * @hidden
+ * @internal
+ * Limited to Microsoft-internal use.
+ */
+function isChildProxyingEnabled() {
+    return buildFeatureFlags.childProxyingCommunication;
+}
+/**
+ * @hidden
+ * @internal
+ * Limited to Microsoft-internal use.
+ */
+function resetBuildFeatureFlags() {
+    buildFeatureFlags.childProxyingCommunication = false;
+}
+// Default runtime feature flags
+const defaultFeatureFlags = {
+    disableEnforceOriginMatchForChildResponses: false,
+};
+// Object that stores the current runtime feature flag state
+let runtimeFeatureFlags = defaultFeatureFlags;
+/**
+ * @returns The current state of the runtime feature flags.
+ */
+function getCurrentFeatureFlagsState() {
+    return runtimeFeatureFlags;
+}
+/**
+ * It sets the runtime feature flags to the new feature flags provided.
+ * @param featureFlags The new feature flags to set.
+ */
+function setFeatureFlagsState(featureFlags) {
+    runtimeFeatureFlags = featureFlags;
+}
+/**
+ * It overwrites all the feature flags in the runtime feature flags object with the new feature flags provided.
+ * @param newFeatureFlags The new feature flags to set.
+ * @returns The current state of the runtime feature flags.
+ */
+function overwriteFeatureFlagsState(newFeatureFlags) {
+    setFeatureFlagsState(Object.assign(Object.assign({}, runtimeFeatureFlags), newFeatureFlags));
+    return getCurrentFeatureFlagsState();
+}
 
 ;// ./src/internal/messageObjects.ts
 var messageObjects_rest = (undefined && undefined.__rest) || function (s, e) {
@@ -4689,7 +4781,8 @@ function processAdditionalValidOrigins(validMessageOrigins) {
     GlobalVars.additionalValidOrigins = combinedOriginUrls;
 }
 
-;// ./src/internal/appIdValidation.ts
+;// ./src/internal/idValidation.ts
+
 
 
 /**
@@ -4703,13 +4796,15 @@ function processAdditionalValidOrigins(validMessageOrigins) {
  * @param potentialAppId A string to check if it's a "valid" app id
  * @throws Error with a message describing the exact validation violation
  */
-function validateStringAsAppId(potentialAppId) {
-    if (hasScriptTags(potentialAppId)) {
-        throw new Error(`Potential app id (${potentialAppId}) is invalid; it contains script tags.`);
-    }
+function validateStringLength(potentialAppId) {
     if (!isStringWithinAppIdLengthLimits(potentialAppId)) {
         throw new Error(`Potential app id (${potentialAppId}) is invalid; its length ${potentialAppId.length} is not within the length limits (${minimumValidAppIdLength}-${maximumValidAppIdLength}).`);
     }
+}
+function validateSafeContent(potentialAppId) {
+    if (hasScriptTags(potentialAppId)) {
+        throw new Error(`Potential app id (${potentialAppId}) is invalid; it contains script tags.`);
+    }
     if (doesStringContainNonPrintableCharacters(potentialAppId)) {
         throw new Error(`Potential app id (${potentialAppId}) is invalid; it contains non-printable characters.`);
     }
@@ -4738,9 +4833,56 @@ function validateAppIdInstance(potentialAppId) {
         throw new Error(`Potential app id (${potentialAppId}) is invalid; it is not an instance of AppId class.`);
     }
 }
+/**
+ * @hidden
+ * Checks if the incoming string is an instance of ValidatedSafeString
+ * @param incomingString An object to check if it's an instance of ValidatedSafeString
+ * @throws Error with a message describing the violation
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function validateSafeStringInstance(incomingString) {
+    if (!(incomingString instanceof ValidatedSafeString)) {
+        throw new Error(`The string (${incomingString}) is invalid; it is not an instance of ValidatedSafeString class.`);
+    }
+}
+
+;// ./src/public/validatedSafeString.ts
+
+/**
+ * A strongly typed class used to represent a "valid" string id.
+ */
+class validatedSafeString_ValidatedSafeString {
+    /**
+     * Creates a strongly-typed Id from a string
+     *
+     * @param idAsString An id represented as a string
+     * @throws Error with a message describing the exact validation violation
+     */
+    constructor(idAsString) {
+        this.idAsString = idAsString;
+        validateSafeContent(idAsString);
+    }
+    /**
+     * @hidden
+     * @internal
+     *
+     * @returns A serializable representation of an AppId, used for passing AppIds to the host.
+     */
+    serialize() {
+        return this.toString();
+    }
+    /**
+     * Returns the app id as a string
+     */
+    toString() {
+        return this.idAsString;
+    }
+}
 
 ;// ./src/public/appId.ts
 
+
 /**
  * A strongly-typed class used to represent a "valid" app id.
  *
@@ -4752,7 +4894,7 @@ function validateAppIdInstance(potentialAppId) {
  * for script tags, length, and non-printable characters. Validation will be updated in the future to ensure
  * the app id is a valid UUID as legacy apps update.
  */
-class AppId {
+class AppId extends validatedSafeString_ValidatedSafeString {
     /**
      * Creates a strongly-typed AppId from a string
      *
@@ -4760,23 +4902,17 @@ class AppId {
      * @throws Error with a message describing the exact validation violation
      */
     constructor(appIdAsString) {
-        this.appIdAsString = appIdAsString;
-        validateStringAsAppId(appIdAsString);
+        super(appIdAsString);
+        validateStringLength(appIdAsString);
     }
     /**
-     * @hidden
-     * @internal
+     * Returns a JSON representation of the AppId object
+     * @returns A JSON representation of the AppId object
      *
-     * @returns A serializable representation of an AppId, used for passing AppIds to the host.
-     */
-    serialize() {
-        return this.toString();
-    }
-    /**
-     * Returns the app id as a string
+     * note: this method maintains backward compatibility for JSON serialization
      */
-    toString() {
-        return this.appIdAsString;
+    toJSON() {
+        return { appIdAsString: this.toString() };
     }
 }
 
@@ -7522,6 +7658,7 @@ var childCommunication_awaiter = (undefined && undefined.__awaiter) || function
 
 
 
+
 const communicationLogger = getLogger('childProxyingCommunication');
 /**
  * @internal
@@ -7545,6 +7682,9 @@ function uninitializeChildCommunication() {
  * Limited to Microsoft-internal use
  */
 function shouldEventBeRelayedToChild() {
+    if (!isChildProxyingEnabled()) {
+        return false;
+    }
     return !!ChildCommunication.window;
 }
 /**
@@ -7553,6 +7693,9 @@ function shouldEventBeRelayedToChild() {
  * Limited to Microsoft-internal use
  */
 function shouldProcessChildMessage(messageSource, messageOrigin) {
+    if (!isChildProxyingEnabled()) {
+        return false;
+    }
     if (!ChildCommunication.window || ChildCommunication.window.closed || messageSource === ChildCommunication.window) {
         ChildCommunication.window = messageSource;
         ChildCommunication.origin = messageOrigin;
@@ -7610,14 +7753,22 @@ function handleIncomingMessage(evt, sendMessageToParentHelper, setCallbackForReq
  */
 function sendChildMessageToParent(message, sendMessageToParentHelper, setCallbackForRequest) {
     const request = sendMessageToParentHelper(getApiVersionTag("v2" /* ApiVersionNumber.V_2 */, "tasks.startTask" /* ApiName.Tasks_StartTask */), message.func, message.args, true);
+    // Copy variable to new pointer
+    const requestChildWindowOrigin = ChildCommunication.origin;
     setCallbackForRequest(request.uuid, (...args) => {
-        if (ChildCommunication.window) {
-            const isPartialResponse = args.pop();
-            handleIncomingMessageFromChildLogger('Message from parent being relayed to child, id: %s', getMessageIdsAsLogString(message));
-            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-            // @ts-ignore
-            sendMessageResponseToChild(message.id, message.uuid, args, isPartialResponse);
+        if (!ChildCommunication.window) {
+            return;
         }
+        if (!getCurrentFeatureFlagsState().disableEnforceOriginMatchForChildResponses &&
+            requestChildWindowOrigin !== ChildCommunication.origin) {
+            handleIncomingMessageFromChildLogger('Origin of child window has changed, not sending response back to child window');
+            return;
+        }
+        const isPartialResponse = args.pop();
+        handleIncomingMessageFromChildLogger('Message from parent being relayed to child, id: %s', getMessageIdsAsLogString(message));
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        sendMessageResponseToChild(message.id, message.uuid, args, isPartialResponse);
     });
 }
 /**
@@ -9557,7 +9708,14 @@ function externalAppAuthenticationForCEA_authenticateWithSSO(appId, conversation
             throw errorNotSupportedOnPlatform;
         }
         validateInput(appId, conversationId);
-        return callFunctionInHost("externalAppAuthenticationForCEA.authenticateWithSSO" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateWithSSO */, [appId, conversationId, authTokenRequest.claims, authTokenRequest.silent], getApiVersionTag(externalAppAuthenticationForCEA_externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthenticationForCEA.authenticateWithSSO" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateWithSSO */), isInvokeError);
+        return callFunctionInHost("externalAppAuthenticationForCEA.authenticateWithSSO" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateWithSSO */, [
+            appId,
+            conversationId,
+            authTokenRequest.authId,
+            authTokenRequest.connectionName,
+            authTokenRequest.claims,
+            authTokenRequest.silent,
+        ], getApiVersionTag(externalAppAuthenticationForCEA_externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthenticationForCEA.authenticateWithSSO" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateWithSSO */), isInvokeError);
     });
 }
 /**
@@ -9889,6 +10047,138 @@ function externalAppCardActionsForCEA_isSupported() {
     return ensureInitialized(runtime) && runtime.supports.externalAppCardActionsForCEA ? true : false;
 }
 
+;// ./src/private/constants.ts
+/**
+ * @hidden
+ * Error codes that can be thrown from externalAppCommands and externalAppCardCommands Action Submit specifically
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+var ExternalAppErrorCode;
+(function (ExternalAppErrorCode) {
+    ExternalAppErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(ExternalAppErrorCode || (ExternalAppErrorCode = {}));
+
+;// ./src/private/externalAppErrorHandling.ts
+
+/**
+ * @hidden
+ * Determines if the provided error object is an instance of ExternalAppError
+ * @internal
+ * Limited to Microsoft-internal use
+ * @param err The error object to check whether it is of ExternalAppError type
+ */
+function isExternalAppError(err) {
+    if (typeof err !== 'object' || err === null) {
+        return false;
+    }
+    const error = err;
+    return (Object.values(ExternalAppErrorCode).includes(error.errorCode) &&
+        (error.message === undefined || typeof error.message === 'string'));
+}
+
+;// ./src/private/externalAppCardActionsForDA.ts
+/**
+ * @beta
+ * @hidden
+ * Module to delegate adaptive card action for Declarative Agents execution to the host
+ * @internal
+ * Limited to Microsoft-internal use
+ * @module
+ */
+var externalAppCardActionsForDA_awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+
+
+
+
+
+
+
+
+/**
+ * All of APIs in this capability file should send out API version v2 ONLY
+ */
+const externalAppCardActionsForDATelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
+/**
+ * @beta
+ * @hidden
+ * Delegates an Adaptive Card Action.OpenUrlDialog request to the host for the application with the provided app ID
+ * @internal
+ * Limited to Microsoft-internal use
+ * @param appId ID of the application the request is intended for. This must be a UUID
+ * @param actionOpenUrlDialogInfo Information required to open the URL dialog
+ * @param traceId The trace identifier used for monitoring and live site investigations
+ * @returns Promise that resolves when the request is completed and rejects with ExternalAppError if the request fails
+ */
+function processActionOpenUrlDialog(appId, actionOpenUrlDialogInfo, traceId) {
+    return externalAppCardActionsForDA_awaiter(this, void 0, void 0, function* () {
+        ensureInitialized(runtime, FrameContexts.content);
+        if (!externalAppCardActionsForDA_isSupported()) {
+            throw errorNotSupportedOnPlatform;
+        }
+        externalAppCardActionsForDA_validateInput(appId, traceId);
+        return callFunctionInHost("externalAppCardActionsForDA.processActionOpenUrlDialog" /* ApiName.ExternalAppCardActionsForDA_ProcessActionOpenUrlDialog */, [appId, new SerializableActionOpenUrlDialogInfo(actionOpenUrlDialogInfo), traceId], getApiVersionTag(externalAppCardActionsForDATelemetryVersionNumber, "externalAppCardActionsForDA.processActionOpenUrlDialog" /* ApiName.ExternalAppCardActionsForDA_ProcessActionOpenUrlDialog */), isExternalAppError);
+    });
+}
+/**
+ * @beta
+ * @hidden
+ * Checks if the externalAppCardActions capability is supported by the host
+ * @returns boolean to represent whether externalAppCardActions capability is supported
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function externalAppCardActionsForDA_isSupported() {
+    return ensureInitialized(runtime) && runtime.supports.externalAppCardActionsForDA ? true : false;
+}
+/**
+ * @beta
+ * @hidden
+ * Checks if the externalAppCardActions capability is supported by the host
+ * @returns boolean to represent whether externalAppCardActions capability is supported
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+function externalAppCardActionsForDA_validateInput(appId, traceId) {
+    validateAppIdInstance(appId);
+    validateUuidInstance(traceId);
+}
+/**
+ * @beta
+ * @hidden
+ * Serializable class for ActionOpenUrlDialogInfo to send info to the host
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+class SerializableActionOpenUrlDialogInfo {
+    constructor(info) {
+        this.info = info;
+    }
+    serialize() {
+        const { url, title, size } = this.info;
+        return {
+            url: url.href,
+            title,
+            size,
+        };
+    }
+}
+
 ;// ./src/private/externalAppCommands.ts
 /**
  * @hidden
@@ -12942,6 +13232,8 @@ function serializeValidSize(size) {
 
 
 
+
+
 
 
 
@@ -18342,6 +18634,8 @@ function marketplace_isSupported() {
 
 
 
+
+