@microsoft/teams-js 2.29.0-beta.1 → 2.29.0

package/dist/umd/MicrosoftTeams.js

@@ -995,6 +995,7 @@ __webpack_require__.d(__webpack_exports__, {
   ChannelType: () => (/* reexport */ ChannelType),
   ChildAppWindow: () => (/* reexport */ ChildAppWindow),
   DialogDimension: () => (/* reexport */ DialogDimension),
+  EmailAddress: () => (/* reexport */ EmailAddress),
   ErrorCode: () => (/* reexport */ ErrorCode),
   FileOpenPreference: () => (/* reexport */ FileOpenPreference),
   FrameContexts: () => (/* reexport */ FrameContexts),
@@ -1025,6 +1026,7 @@ __webpack_require__.d(__webpack_exports__, {
   enablePrintCapability: () => (/* reexport */ enablePrintCapability),
   executeDeepLink: () => (/* reexport */ executeDeepLink),
   externalAppAuthentication: () => (/* reexport */ externalAppAuthentication),
+  externalAppAuthenticationForCEA: () => (/* reexport */ externalAppAuthenticationForCEA),
   externalAppCardActions: () => (/* reexport */ externalAppCardActions),
   externalAppCardActionsForCEA: () => (/* reexport */ externalAppCardActionsForCEA),
   externalAppCommands: () => (/* reexport */ externalAppCommands),
@@ -3509,7 +3511,7 @@ const _minRuntimeConfigToUninitialize = {
  * @hidden
  *  Package version.
  */
-const version = "2.29.0-beta.1";
+const version = "2.29.0";
 
 ;// CONCATENATED MODULE: ./src/internal/internalAPIs.ts
 
@@ -7829,36 +7831,6 @@ var UserSettingTypes;
      */
     UserSettingTypes["theme"] = "theme";
 })(UserSettingTypes || (UserSettingTypes = {}));
-/**
- * @beta
- * @hidden
- * The types for ActionOpenUrl
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-var ActionOpenUrlType;
-(function (ActionOpenUrlType) {
-    ActionOpenUrlType["DeepLinkDialog"] = "DeepLinkDialog";
-    ActionOpenUrlType["DeepLinkOther"] = "DeepLinkOther";
-    ActionOpenUrlType["DeepLinkStageView"] = "DeepLinkStageView";
-    ActionOpenUrlType["GenericUrl"] = "GenericUrl";
-})(ActionOpenUrlType || (ActionOpenUrlType = {}));
-/**
- * @beta
- * @hidden
- * Error codes that can be thrown from IExternalAppCardActionService.handleActionOpenUrl
- * and IExternalAppCardActionForCEAService.handleActionOpenUrl
- *
- * @internal
- * Limited to Microsoft-internal use
- */
-var ActionOpenUrlErrorCode;
-(function (ActionOpenUrlErrorCode) {
-    ActionOpenUrlErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
-    ActionOpenUrlErrorCode["INVALID_LINK"] = "INVALID_LINK";
-    ActionOpenUrlErrorCode["NOT_SUPPORTED"] = "NOT_SUPPORTED";
-})(ActionOpenUrlErrorCode || (ActionOpenUrlErrorCode = {}));
 
 ;// CONCATENATED MODULE: ./src/private/privateAPIs.ts
 /* eslint-disable @typescript-eslint/no-explicit-any */
@@ -8188,13 +8160,29 @@ const externalAppAuthenticationTelemetryVersionNumber = "v2" /* ApiVersionNumber
  */
 var externalAppAuthentication;
 (function (externalAppAuthentication) {
+    /**
+     * @beta
+     * @hidden
+     * Determines if the provided response object is an instance of IActionExecuteResponse
+     * @internal
+     * Limited to Microsoft-internal use
+     * @param response The object to check whether it is of IActionExecuteResponse type
+     */
+    function isActionExecuteResponse(response) {
+        const actionResponse = response;
+        return (actionResponse.responseType === externalAppAuthentication.InvokeResponseType.ActionExecuteInvokeResponse &&
+            actionResponse.value !== undefined &&
+            actionResponse.statusCode !== undefined &&
+            actionResponse.type !== undefined);
+    }
+    externalAppAuthentication.isActionExecuteResponse = isActionExecuteResponse;
     /**
      * @hidden
      * This is the only allowed value for IActionExecuteInvokeRequest.type. Used for validation
      * @internal
      * Limited to Microsoft-internal use
      */
-    const ActionExecuteInvokeRequestType = 'Action.Execute';
+    externalAppAuthentication.ActionExecuteInvokeRequestType = 'Action.Execute';
     /**
      * @hidden
      * Used to differentiate between IOriginalRequestInfo types
@@ -8217,6 +8205,23 @@ var externalAppAuthentication;
         InvokeResponseType["ActionExecuteInvokeResponse"] = "ActionExecuteInvokeResponse";
         InvokeResponseType["QueryMessageExtensionResponse"] = "QueryMessageExtensionResponse";
     })(InvokeResponseType = externalAppAuthentication.InvokeResponseType || (externalAppAuthentication.InvokeResponseType = {}));
+    /**
+     * @beta
+     * @hidden
+     * Determines if the provided error object is an instance of InvokeError
+     * @internal
+     * Limited to Microsoft-internal use
+     * @param err The error object to check whether it is of InvokeError type
+     */
+    function isInvokeError(err) {
+        if (typeof err !== 'object' || err === null) {
+            return false;
+        }
+        const error = err;
+        return (Object.values(externalAppAuthentication.InvokeErrorCode).includes(error.errorCode) &&
+            (error.message === undefined || typeof error.message === 'string'));
+    }
+    externalAppAuthentication.isInvokeError = isInvokeError;
     /**
      * @hidden
      *
@@ -8236,10 +8241,10 @@ var externalAppAuthentication;
     function validateOriginalRequestInfo(originalRequestInfo) {
         if (originalRequestInfo.requestType === OriginalRequestType.ActionExecuteInvokeRequest) {
             const actionExecuteRequest = originalRequestInfo;
-            if (actionExecuteRequest.type !== ActionExecuteInvokeRequestType) {
+            if (actionExecuteRequest.type !== externalAppAuthentication.ActionExecuteInvokeRequestType) {
                 const error = {
                     errorCode: InvokeErrorCode.INTERNAL_ERROR,
-                    message: `Invalid action type ${actionExecuteRequest.type}. Action type must be "${ActionExecuteInvokeRequestType}"`,
+                    message: `Invalid action type ${actionExecuteRequest.type}. Action type must be "${externalAppAuthentication.ActionExecuteInvokeRequestType}"`,
                 };
                 throw error;
             }
@@ -8430,6 +8435,189 @@ var externalAppAuthentication;
     externalAppAuthentication.isSupported = isSupported;
 })(externalAppAuthentication || (externalAppAuthentication = {}));
 
+;// CONCATENATED MODULE: ./src/private/externalAppAuthenticationForCEA.ts
+var externalAppAuthenticationForCEA_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());
+    });
+};
+
+
+
+
+
+
+
+const externalAppAuthenticationForCEA_externalAppAuthenticationTelemetryVersionNumber = "v2" /* ApiVersionNumber.V_2 */;
+/**
+ * @hidden
+ * Namespace to delegate authentication requests to the host for custom engine agents
+ * @internal
+ * Limited to Microsoft-internal use
+ * @beta
+ */
+var externalAppAuthenticationForCEA;
+(function (externalAppAuthenticationForCEA) {
+    /**
+     * @beta
+     * @hidden
+     * Signals to the host to perform SSO authentication for the application specified by the app ID, and then send the authResult to the application backend.
+     * @internal
+     * Limited to Microsoft-internal use
+     * @param appId App ID of the app upon whose behalf Copilot is requesting authentication. This must be a UUID.
+     * @param conversationId ConversationId To tell the bot what conversation the calls are coming from
+     * @param authTokenRequest Parameters for SSO authentication
+     * @throws InvokeError if the host encounters an error while authenticating
+     * @returns A promise that resolves when authentication succeeds and rejects with InvokeError on failure
+     */
+    function authenticateWithSSO(appId, conversationId, authTokenRequest) {
+        return externalAppAuthenticationForCEA_awaiter(this, void 0, void 0, function* () {
+            ensureInitialized(runtime, FrameContexts.content);
+            if (!isSupported()) {
+                throw errorNotSupportedOnPlatform;
+            }
+            validateId(conversationId, new Error('conversation id is not valid.'));
+            const error = yield sendAndUnwrap(getApiVersionTag(externalAppAuthenticationForCEA_externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthenticationForCEA.authenticateWithSSO" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateWithSSO */), "externalAppAuthenticationForCEA.authenticateWithSSO" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateWithSSO */, appId.toString(), conversationId, authTokenRequest.claims, authTokenRequest.silent);
+            if (error) {
+                throw error;
+            }
+        });
+    }
+    externalAppAuthenticationForCEA.authenticateWithSSO = authenticateWithSSO;
+    /**
+     * @beta
+     * @hidden
+     * Signals to the host to perform authentication using the given authentication parameters and then send the auth result to the application backend.
+     * @internal
+     * Limited to Microsoft-internal use
+     * @param appId App ID of the app upon whose behalf Copilot is requesting authentication. This must be a UUID.
+     * @param conversationId ConversationId To tell the bot what conversation the calls are coming from
+     * @param authenticateParameters Parameters for the authentication pop-up
+     * @throws InvokeError if the host encounters an error while authenticating
+     * @returns A promise that resolves from the application backend and rejects with InvokeError if the host encounters an error while authenticating
+     */
+    function authenticateWithOauth(appId, conversationId, authenticateParameters) {
+        return externalAppAuthenticationForCEA_awaiter(this, void 0, void 0, function* () {
+            ensureInitialized(runtime, FrameContexts.content);
+            if (!isSupported()) {
+                throw errorNotSupportedOnPlatform;
+            }
+            validateId(conversationId, new Error('conversation id is not valid.'));
+            // Ask the parent window to open an authentication window with the parameters provided by the caller.
+            const error = yield sendAndUnwrap(getApiVersionTag(externalAppAuthenticationForCEA_externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthenticationForCEA.authenticateWithOauth" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateWithOauth */), "externalAppAuthenticationForCEA.authenticateWithOauth" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateWithOauth */, appId.toString(), conversationId, authenticateParameters.url.href, authenticateParameters.width, authenticateParameters.height, authenticateParameters.isExternal);
+            if (error) {
+                throw error;
+            }
+        });
+    }
+    externalAppAuthenticationForCEA.authenticateWithOauth = authenticateWithOauth;
+    /**
+     * @beta
+     * @hidden
+     * Signals to the host to perform authentication using the given authentication parameters and then resend the request to the application backend with the authentication result.
+     * @internal
+     * Limited to Microsoft-internal use
+     * @param appId App ID of the app upon whose behalf Copilot is requesting authentication. This must be a UUID.
+     * @param conversationId ConversationId To tell the bot what conversation the calls are coming from
+     * @param authenticateParameters Parameters for the authentication pop-up
+     * @param originalRequestInfo Information about the original request that should be resent
+     * @throws InvokeError if the host encounters an error while authenticating or resending the request
+     * @returns A promise that resolves to the IActionExecuteResponse from the application backend and rejects with InvokeError if the host encounters an error while authenticating or resending the request
+     */
+    function authenticateAndResendRequest(appId, conversationId, authenticateParameters, originalRequestInfo) {
+        return externalAppAuthenticationForCEA_awaiter(this, void 0, void 0, function* () {
+            ensureInitialized(runtime, FrameContexts.content);
+            if (!isSupported()) {
+                throw errorNotSupportedOnPlatform;
+            }
+            validateId(conversationId, new Error('conversation id is not valid.'));
+            validateOriginalRequestInfo(originalRequestInfo);
+            // Ask the parent window to open an authentication window with the parameters provided by the caller.
+            const response = yield sendAndUnwrap(getApiVersionTag(externalAppAuthenticationForCEA_externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthenticationForCEA.authenticateAndResendRequest" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateAndResendRequest */), "externalAppAuthenticationForCEA.authenticateAndResendRequest" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateAndResendRequest */, appId.toString(), conversationId, originalRequestInfo, authenticateParameters.url.href, authenticateParameters.width, authenticateParameters.height, authenticateParameters.isExternal);
+            if (externalAppAuthentication.isActionExecuteResponse(response)) {
+                return response;
+            }
+            else {
+                throw externalAppAuthentication.isInvokeError(response) ? response : defaultExternalAppError;
+            }
+        });
+    }
+    externalAppAuthenticationForCEA.authenticateAndResendRequest = authenticateAndResendRequest;
+    /**
+     * @beta
+     * @hidden
+     * Signals to the host to perform SSO authentication for the application specified by the app ID and then resend the request to the application backend with the authentication result and originalRequestInfo
+     * @internal
+     * Limited to Microsoft-internal use
+     * @param appId App ID of the app upon whose behalf Copilot is requesting authentication. This must be a UUID.
+     * @param conversationId ConversationId To tell the bot what conversation the calls are coming from
+     * @param authTokenRequest Parameters for SSO authentication
+     * @param originalRequestInfo Information about the original request that should be resent
+     * @throws InvokeError if the host encounters an error while authenticating or resending the request
+     * @returns A promise that resolves to the IActionExecuteResponse from the application backend and rejects with InvokeError if the host encounters an error while authenticating or resending the request
+     */
+    function authenticateWithSSOAndResendRequest(appId, conversationId, authTokenRequest, originalRequestInfo) {
+        return externalAppAuthenticationForCEA_awaiter(this, void 0, void 0, function* () {
+            ensureInitialized(runtime, FrameContexts.content);
+            if (!isSupported()) {
+                throw errorNotSupportedOnPlatform;
+            }
+            validateId(conversationId, new Error('conversation id is not valid.'));
+            validateOriginalRequestInfo(originalRequestInfo);
+            const response = yield sendAndUnwrap(getApiVersionTag(externalAppAuthenticationForCEA_externalAppAuthenticationTelemetryVersionNumber, "externalAppAuthenticationForCEA.authenticateWithSSOAndResendRequest" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateWithSSOAndResendRequest */), "externalAppAuthenticationForCEA.authenticateWithSSOAndResendRequest" /* ApiName.ExternalAppAuthenticationForCEA_AuthenticateWithSSOAndResendRequest */, appId.toString(), conversationId, originalRequestInfo, authTokenRequest.claims, authTokenRequest.silent);
+            if (externalAppAuthentication.isActionExecuteResponse(response)) {
+                return response;
+            }
+            else {
+                throw externalAppAuthentication.isInvokeError(response) ? response : defaultExternalAppError;
+            }
+        });
+    }
+    externalAppAuthenticationForCEA.authenticateWithSSOAndResendRequest = authenticateWithSSOAndResendRequest;
+    /**
+     * @beta
+     * @hidden
+     * Checks if the externalAppAuthenticationForCEA capability is supported by the host
+     * @returns boolean to represent whether externalAppAuthenticationForCEA capability is supported
+     * @throws Error if {@linkcode app.initialize} has not successfully completed
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    function isSupported() {
+        return ensureInitialized(runtime) && runtime.supports.externalAppAuthenticationForCEA ? true : false;
+    }
+    externalAppAuthenticationForCEA.isSupported = isSupported;
+    /**
+     * @hidden
+     * @internal
+     * Limited to Microsoft-internal use
+     * @beta
+     */
+    function validateOriginalRequestInfo(actionExecuteRequest) {
+        if (actionExecuteRequest.type !== externalAppAuthentication.ActionExecuteInvokeRequestType) {
+            const error = {
+                errorCode: externalAppAuthentication.InvokeErrorCode.INTERNAL_ERROR,
+                message: `Invalid action type ${actionExecuteRequest.type}. Action type must be "${externalAppAuthentication.ActionExecuteInvokeRequestType}"`,
+            };
+            throw error;
+        }
+    }
+    /**
+     * @hidden
+     * @internal
+     * Limited to Microsoft-internal use
+     * @beta
+     */
+    const defaultExternalAppError = {
+        errorCode: externalAppAuthentication.InvokeErrorCode.INTERNAL_ERROR,
+        message: 'No valid response received',
+    };
+})(externalAppAuthenticationForCEA || (externalAppAuthenticationForCEA = {}));
+
 ;// CONCATENATED MODULE: ./src/private/externalAppCardActions.ts
 
 
@@ -8462,6 +8650,21 @@ var externalAppCardActions;
         ActionOpenUrlType["DeepLinkStageView"] = "DeepLinkStageView";
         ActionOpenUrlType["GenericUrl"] = "GenericUrl";
     })(ActionOpenUrlType = externalAppCardActions.ActionOpenUrlType || (externalAppCardActions.ActionOpenUrlType = {}));
+    /**
+     * @beta
+     * @hidden
+     * Error codes that can be thrown from IExternalAppCardActionService.handleActionOpenUrl
+     * and IExternalAppCardActionForCEAService.handleActionOpenUrl
+     *
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    let ActionOpenUrlErrorCode;
+    (function (ActionOpenUrlErrorCode) {
+        ActionOpenUrlErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+        ActionOpenUrlErrorCode["INVALID_LINK"] = "INVALID_LINK";
+        ActionOpenUrlErrorCode["NOT_SUPPORTED"] = "NOT_SUPPORTED";
+    })(ActionOpenUrlErrorCode = externalAppCardActions.ActionOpenUrlErrorCode || (externalAppCardActions.ActionOpenUrlErrorCode = {}));
     /**
      * @beta
      * @hidden
@@ -8579,7 +8782,7 @@ var externalAppCardActionsForCEA;
                 throw errorNotSupportedOnPlatform;
             }
             validateId(conversationId, new Error('conversation id is not valid.'));
-            const [error, response] = yield sendMessageToParentAsync(getApiVersionTag(externalAppCardActionsForCEA_externalAppCardActionsTelemetryVersionNumber, "externalAppCardActionsForCEA.processActionOpenUrl" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionOpenUrl */), "externalAppCardActionsForCEA.processActionOpenUrl" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionOpenUrl */, [appId, url.href, conversationId]);
+            const [error, response] = yield sendMessageToParentAsync(getApiVersionTag(externalAppCardActionsForCEA_externalAppCardActionsTelemetryVersionNumber, "externalAppCardActionsForCEA.processActionOpenUrl" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionOpenUrl */), "externalAppCardActionsForCEA.processActionOpenUrl" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionOpenUrl */, [appId.toString(), conversationId, url.href]);
             if (error) {
                 throw error;
             }
@@ -8608,7 +8811,7 @@ var externalAppCardActionsForCEA;
                 throw errorNotSupportedOnPlatform;
             }
             validateId(conversationId, new Error('conversation id is not valid.'));
-            const error = yield sendAndUnwrap(getApiVersionTag(externalAppCardActionsForCEA_externalAppCardActionsTelemetryVersionNumber, "externalAppCardActionsForCEA.processActionSubmit" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionSubmit */), "externalAppCardActionsForCEA.processActionSubmit" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionSubmit */, [appId, conversationId, actionSubmitPayload]);
+            const error = yield sendAndUnwrap(getApiVersionTag(externalAppCardActionsForCEA_externalAppCardActionsTelemetryVersionNumber, "externalAppCardActionsForCEA.processActionSubmit" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionSubmit */), "externalAppCardActionsForCEA.processActionSubmit" /* ApiName.ExternalAppCardActionsForCEA_ProcessActionSubmit */, appId.toString(), conversationId, actionSubmitPayload);
             if (error) {
                 throw error;
             }
@@ -11517,6 +11720,35 @@ var hostEntity;
 
 
 
+
+
+;// CONCATENATED MODULE: ./src/internal/emailAddressValidation.ts
+function validateEmailAddress(emailString) {
+    const emailIsEmptyOrUndefined = emailString ? emailString.length <= 0 : true;
+    const atIndex = emailString === null || emailString === void 0 ? void 0 : emailString.indexOf('@');
+    const periodIndexAfterAt = emailString === null || emailString === void 0 ? void 0 : emailString.indexOf('.', atIndex);
+    if (emailIsEmptyOrUndefined || atIndex === -1 || periodIndexAfterAt === -1) {
+        throw new Error('Input email address does not have the correct format.');
+    }
+}
+
+;// CONCATENATED MODULE: ./src/public/emailAddress.ts
+
+/**
+ * Represents a validated email.
+ */
+class EmailAddress {
+    constructor(val) {
+        this.val = val;
+        validateEmailAddress(val);
+    }
+    /**
+     * Retrieve the validated email address as a string.
+     */
+    toString() {
+        return this.val;
+    }
+}
 
 ;// CONCATENATED MODULE: ./src/internal/deepLinkConstants.ts
 /**
@@ -13319,7 +13551,7 @@ var meeting;
                 throw new Error((_a = error === null || error === void 0 ? void 0 : error.errorCode) === null || _a === void 0 ? void 0 : _a.toString());
             }
             if ((((_b = response.details) === null || _b === void 0 ? void 0 : _b.type) == CallType.GroupCall || ((_c = response.details) === null || _c === void 0 ? void 0 : _c.type) == CallType.OneOnOneCall) &&
-                !response.details.originalCaller) {
+                !response.details.originalCallerInfo) {
                 throw new Error(ErrorCode.NOT_SUPPORTED_ON_PLATFORM.toString());
             }
             return response;
@@ -16600,6 +16832,7 @@ var marketplace;
 
 
 
+