@microsoft/teamsfx 2.0.0-experimental.0 → 2.0.1-alpha.0d47bc042.0

package/dist/index.esm5.js

@@ -9,7 +9,6 @@ import axios from 'axios';
 // Licensed under the MIT license.
 /**
  * Error code to trace the error types.
- * @beta
  */
 var ErrorCode;
 (function (ErrorCode) {
@@ -33,6 +32,30 @@ var ErrorCode;
      * Channel is not supported error.
      */
     ErrorCode["ChannelNotSupported"] = "ChannelNotSupported";
+    /**
+     * Failed to retrieve sso token
+     */
+    ErrorCode["FailedToRetrieveSsoToken"] = "FailedToRetrieveSsoToken";
+    /**
+     * Failed to process sso handler
+     */
+    ErrorCode["FailedToProcessSsoHandler"] = "FailedToProcessSsoHandler";
+    /**
+     * Cannot find command
+     */
+    ErrorCode["CannotFindCommand"] = "CannotFindCommand";
+    /**
+     * Failed to run sso step
+     */
+    ErrorCode["FailedToRunSsoStep"] = "FailedToRunSsoStep";
+    /**
+     * Failed to run dedup step
+     */
+    ErrorCode["FailedToRunDedupStep"] = "FailedToRunDedupStep";
+    /**
+     * Sso activity handler is undefined
+     */
+    ErrorCode["SsoActivityHandlerIsUndefined"] = "SsoActivityHandlerIsUndefined";
     /**
      * Runtime is not supported error.
      */
@@ -88,6 +111,15 @@ ErrorMessage.NodejsRuntimeNotSupported = "{0} is not supported in Node.";
 ErrorMessage.FailToAcquireTokenOnBehalfOfUser = "Failed to acquire access token on behalf of user: {0}";
 // ChannelNotSupported Error
 ErrorMessage.OnlyMSTeamsChannelSupported = "{0} is only supported in MS Teams Channel";
+ErrorMessage.FailedToProcessSsoHandler = "Failed to process sso handler: {0}";
+// FailedToRetrieveSsoToken Error
+ErrorMessage.FailedToRetrieveSsoToken = "Failed to retrieve sso token, user failed to finish the AAD consent flow.";
+// CannotFindCommand Error
+ErrorMessage.CannotFindCommand = "Cannot find command: {0}";
+ErrorMessage.FailedToRunSsoStep = "Failed to run dialog to retrieve sso token: {0}";
+ErrorMessage.FailedToRunDedupStep = "Failed to run dialog to remove duplicated messages: {0}";
+// SsoActivityHandlerIsUndefined Error
+ErrorMessage.SsoActivityHandlerIsNull = "Sso command can only be used or added when sso activity handler is not undefined";
 // IdentityTypeNotSupported Error
 ErrorMessage.IdentityTypeNotSupported = "{0} identity is not supported in {1}";
 // AuthorizationInfoError
@@ -98,10 +130,9 @@ ErrorMessage.EmptyParameter = "Parameter {0} is empty";
 ErrorMessage.DuplicateHttpsOptionProperty = "Axios HTTPS agent already defined value for property {0}";
 ErrorMessage.DuplicateApiKeyInHeader = "The request already defined api key in request header with name {0}.";
 ErrorMessage.DuplicateApiKeyInQueryParam = "The request already defined api key in query parameter with name {0}.";
+ErrorMessage.OnlySupportInQueryActivity = "The handleMessageExtensionQueryWithToken only support in handleTeamsMessagingExtensionQuery with composeExtension/query type.";
 /**
  * Error class with code and message thrown by the SDK.
- *
- * @beta
  */
 class ErrorWithCode extends Error {
     /**
@@ -109,8 +140,6 @@ class ErrorWithCode extends Error {
      *
      * @param {string} message - error message.
      * @param {ErrorCode} code - error code.
-     *
-     * @beta
      */
     constructor(message, code) {
         if (!code) {
@@ -128,8 +157,6 @@ class ErrorWithCode extends Error {
 // Licensed under the MIT license.
 /**
  * Log level.
- *
- * @beta
  */
 var LogLevel;
 (function (LogLevel) {
@@ -154,8 +181,6 @@ var LogLevel;
  * Update log level helper.
  *
  * @param { LogLevel } level - log level in configuration
- *
- * @beta
  */
 function setLogLevel(level) {
     internalLogger.level = level;
@@ -164,8 +189,6 @@ function setLogLevel(level) {
  * Get log level.
  *
  * @returns Log level
- *
- * @beta
  */
 function getLogLevel() {
     return internalLogger.level;
@@ -240,8 +263,6 @@ const internalLogger = new InternalLogger();
  *   error: console.error,
  * });
  * ```
- *
- * @beta
  */
 function setLogger(logger) {
     internalLogger.customLogger = logger;
@@ -259,8 +280,6 @@ function setLogger(logger) {
  *   }
  * });
  * ```
- *
- * @beta
  */
 function setLogFunction(logFunction) {
     internalLogger.customLogFunction = logFunction;
@@ -303,6 +322,7 @@ function getUserInfoFromSsoToken(ssoToken) {
     const userInfo = {
         displayName: tokenObject.name,
         objectId: tokenObject.oid,
+        tenantId: tokenObject.tid,
         preferredUserName: "",
     };
     if (tokenObject.ver === "2.0") {
@@ -411,8 +431,6 @@ function validateScopesType(value) {
  *
  * @remarks
  * Only works in in server side.
- *
- * @beta
  */
 class AppCredential {
     /**
@@ -420,7 +438,6 @@ class AppCredential {
      *
      * @remarks
      * Only works in in server side.
-     * @beta
      */
     constructor(authConfig) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "AppCredential"), ErrorCode.RuntimeNotSupported);
@@ -430,7 +447,6 @@ class AppCredential {
      *
      * @remarks
      * Only works in in server side.
-     * @beta
      */
     getToken(scopes, options) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -445,8 +461,6 @@ class AppCredential {
  *
  * @remarks
  * Can only be used in server side.
- *
- * @beta
  */
 class OnBehalfOfUserCredential {
     /**
@@ -454,7 +468,6 @@ class OnBehalfOfUserCredential {
      *
      * @remarks
      * Can Only works in in server side.
-     * @beta
      */
     constructor(ssoToken, config) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "OnBehalfOfUserCredential"), ErrorCode.RuntimeNotSupported);
@@ -463,7 +476,6 @@ class OnBehalfOfUserCredential {
      * Get access token from credential.
      * @remarks
      * Can only be used in server side.
-     * @beta
      */
     getToken(scopes, options) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -474,7 +486,6 @@ class OnBehalfOfUserCredential {
      * Get basic user info from SSO token.
      * @remarks
      * Can only be used in server side.
-     * @beta
      */
     getUserInfo() {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "OnBehalfOfUserCredential"), ErrorCode.RuntimeNotSupported);
@@ -490,8 +501,6 @@ const loginPageHeight = 535;
  *
  * @remarks
  * Can only be used within Teams.
- *
- * @beta
  */
 class TeamsUserCredential {
     /**
@@ -515,8 +524,6 @@ class TeamsUserCredential {
      *
      * @throws {@link ErrorCode|InvalidConfiguration} when client id, initiate login endpoint or simple auth endpoint is not found in config.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is nodeJS.
-     *
-     * @beta
      */
     constructor(authConfig) {
         internalLogger.info("Create teams user credential");
@@ -538,21 +545,20 @@ class TeamsUserCredential {
      * await credential.login("https://graph.microsoft.com/User.Read Calendars.Read"); // multiple scopes using string
      * ```
      * @param scopes - The list of scopes for which the token will have access, before that, we will request user to consent.
+     * @param { string[] } resources - The optional list of resources for full trust Teams apps.
      *
      * @throws {@link ErrorCode|InternalError} when failed to login with unknown error.
      * @throws {@link ErrorCode|ConsentFailed} when user canceled or failed to consent.
      * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is nodeJS.
-     *
-     * @beta
      */
-    login(scopes) {
+    login(scopes, resources) {
         return __awaiter(this, void 0, void 0, function* () {
             validateScopesType(scopes);
             const scopesStr = typeof scopes === "string" ? scopes : scopes.join(" ");
             internalLogger.info(`Popup login page to get user's access token with scopes: ${scopesStr}`);
             if (!this.initialized) {
-                yield this.init();
+                yield this.init(resources);
             }
             yield app.initialize();
             let result;
@@ -602,6 +608,9 @@ class TeamsUserCredential {
      * Get access token from credential.
      *
      * Important: Access tokens are stored in sessionStorage, read more here: https://aka.ms/teamsfx-session-storage-notice
+     * Important: Full trust applications do not read the resource information from the webApplicationInfo section of the app
+     * manifest. Instead, this resource (along with any additional resources from which to request tokens) must be provided
+     * as a list of resources to the getToken() method through a GetTeamsUserTokenOptions object.
      *
      * @example
      * ```typescript
@@ -615,6 +624,9 @@ class TeamsUserCredential {
      * await credential.getToken("User.Read Application.Read.All") // Get Graph access token for multiple scopes using space-separated string
      * await credential.getToken("https://graph.microsoft.com/User.Read") // Get Graph access token with full resource URI
      * await credential.getToken(["https://outlook.office.com/Mail.Read"]) // Get Outlook access token
+     *
+     * const options: GetTeamsUserTokenOptions = { resources: ["https://domain.example.com"] }; // set up resources for full trust apps.
+     * await credential.getToken([], options) // Get sso token from teams client - only use this approach for full trust apps.
      * ```
      *
      * @param {string | string[]} scopes - The list of scopes for which the token will have access.
@@ -629,13 +641,13 @@ class TeamsUserCredential {
      * If scopes is empty string or array, it returns SSO token.
      * If scopes is non-empty, it returns access token for target scope.
      * Throw error if get access token failed.
-     *
-     * @beta
      */
     getToken(scopes, options) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             validateScopesType(scopes);
-            const ssoToken = yield this.getSSOToken();
+            const resources = (_a = options) === null || _a === void 0 ? void 0 : _a.resources;
+            const ssoToken = yield this.getSSOToken(resources);
             const scopeStr = typeof scopes === "string" ? scopes : scopes.join(" ");
             if (scopeStr === "") {
                 internalLogger.info("Get SSO token");
@@ -644,7 +656,7 @@ class TeamsUserCredential {
             else {
                 internalLogger.info("Get access token with scopes: " + scopeStr);
                 if (!this.initialized) {
-                    yield this.init();
+                    yield this.init(resources);
                 }
                 let tokenResponse;
                 const scopesArray = typeof scopes === "string" ? scopes.split(" ") : scopes;
@@ -691,6 +703,8 @@ class TeamsUserCredential {
     /**
      * Get basic user info from SSO token
      *
+     * @param {string[]} resources - The optional list of resources for full trust Teams apps.
+     *
      * @example
      * ```typescript
      * const currentUser = await credential.getUserInfo();
@@ -701,19 +715,17 @@ class TeamsUserCredential {
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is nodeJS.
      *
      * @returns Basic user info with user displayName, objectId and preferredUserName.
-     *
-     * @beta
      */
-    getUserInfo() {
+    getUserInfo(resources) {
         return __awaiter(this, void 0, void 0, function* () {
             internalLogger.info("Get basic user info from SSO token");
-            const ssoToken = yield this.getSSOToken();
+            const ssoToken = yield this.getSSOToken(resources);
             return getUserInfoFromSsoToken(ssoToken.token);
         });
     }
-    init() {
+    init(resources) {
         return __awaiter(this, void 0, void 0, function* () {
-            const ssoToken = yield this.getSSOToken();
+            const ssoToken = yield this.getSSOToken(resources);
             const info = getTenantIdAndLoginHintFromSsoToken(ssoToken.token);
             this.loginHint = info.loginHint;
             this.tid = info.tid;
@@ -733,9 +745,12 @@ class TeamsUserCredential {
     /**
      * Get SSO token using teams SDK
      * It will try to get SSO token from memory first, if SSO token doesn't exist or about to expired, then it will using teams SDK to get SSO token
+     *
+     * @param {string[]} resources - The optional list of resources for full trust Teams apps.
+     *
      * @returns SSO token
      */
-    getSSOToken() {
+    getSSOToken(resources) {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.ssoToken) {
                 if (this.ssoToken.expiresOnTimestamp - Date.now() > tokenRefreshTimeSpanInMillisecond) {
@@ -743,10 +758,17 @@ class TeamsUserCredential {
                     return this.ssoToken;
                 }
             }
-            const params = {};
+            const params = { resources: resources !== null && resources !== void 0 ? resources : [] };
             let token;
             try {
                 yield app.initialize();
+            }
+            catch (err) {
+                const errorMsg = "Initialize teams sdk failed due to not running inside Teams environment";
+                internalLogger.error(errorMsg);
+                throw new ErrorWithCode(errorMsg, ErrorCode.InternalError);
+            }
+            try {
                 token = yield authentication.getAuthToken(params);
             }
             catch (err) {
@@ -811,24 +833,12 @@ class TeamsUserCredential {
             throw new ErrorWithCode(errorMessage, ErrorCode.InternalError);
         }
     }
-    // Come from here: https://github.com/wictorwilen/msteams-react-base-component/blob/master/src/useTeams.ts
-    checkInTeams() {
-        if ((window.parent === window.self && window.nativeInterface) ||
-            window.navigator.userAgent.includes("Teams/") ||
-            window.name === "embedded-page-container" ||
-            window.name === "extension-tab-frame") {
-            return true;
-        }
-        return false;
-    }
 }
 
 // Copyright (c) Microsoft Corporation.
 const defaultScope = "https://graph.microsoft.com/.default";
 /**
  * Microsoft Graph auth provider for Teams Framework
- *
- * @beta
  */
 class MsGraphAuthProvider {
     /**
@@ -840,8 +850,6 @@ class MsGraphAuthProvider {
      * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
      *
      * @returns An instance of MsGraphAuthProvider.
-     *
-     * @beta
      */
     constructor(teamsfx, scopes) {
         this.teamsfx = teamsfx;
@@ -935,8 +943,6 @@ class MsGraphAuthProvider {
  * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
  *
  * @returns Graph client with specified scopes.
- *
- * @beta
  */
 function createMicrosoftGraphClient(teamsfx, scopes) {
     internalLogger.info("Create Microsoft Graph Client");
@@ -952,7 +958,6 @@ function createMicrosoftGraphClient(teamsfx, scopes) {
  * Generate connection configuration consumed by tedious.
  * @remarks
  * Only works in in server side.
- * @beta
  */
 function getTediousConnectionConfig(teamsfx, databaseName) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -1008,8 +1013,6 @@ function getTediousConnectionConfig(teamsfx, databaseName) {
  *      }
  * ]));
  * ```
- *
- * @beta
  */
 class TeamsBotSsoPrompt {
     /**
@@ -1020,8 +1023,6 @@ class TeamsBotSsoPrompt {
      *
      * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     constructor(teamsfx, dialogId, settings) {
         this.teamsfx = teamsfx;
@@ -1041,8 +1042,6 @@ class TeamsBotSsoPrompt {
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
      *
      * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
      */
     beginDialog(dc) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -1064,8 +1063,6 @@ class TeamsBotSsoPrompt {
      *
      * @throws {@link ErrorCode|ChannelNotSupported} when bot channel is not MS Teams.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     continueDialog(dc) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -1086,8 +1083,6 @@ class TeamsBotSsoPrompt {
  * ```typescript
  * const client = createApiClient("https://my-api-endpoint-base-url", new BasicAuthProvider("xxx","xxx"));
  * ```
- *
- * @beta
  */
 function createApiClient(apiEndpoint, authProvider) {
     // Add a request interceptor
@@ -1105,14 +1100,10 @@ function createApiClient(apiEndpoint, authProvider) {
 // Copyright (c) Microsoft Corporation.
 /**
  * Provider that handles Bearer Token authentication
- *
- * @beta
  */
 class BearerTokenAuthProvider {
     /**
      * @param { () => Promise<string> } getToken - Function that returns the content of bearer token used in http request
-     *
-     * @beta
      */
     constructor(getToken) {
         this.getToken = getToken;
@@ -1126,8 +1117,6 @@ class BearerTokenAuthProvider {
      * @returns Updated axios request config.
      *
      * @throws {@link ErrorCode|AuthorizationInfoAlreadyExists} - when Authorization header already exists in request configuration.
-     *
-     * @beta
      */
     AddAuthenticationInfo(config) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -1147,8 +1136,6 @@ class BearerTokenAuthProvider {
 // Copyright (c) Microsoft Corporation.
 /**
  * Provider that handles Basic authentication
- *
- * @beta
  */
 class BasicAuthProvider {
     /**
@@ -1158,8 +1145,6 @@ class BasicAuthProvider {
      *
      * @throws {@link ErrorCode|InvalidParameter} - when username or password is empty.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     constructor(userName, password) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "BasicAuthProvider"), ErrorCode.RuntimeNotSupported);
@@ -1174,8 +1159,6 @@ class BasicAuthProvider {
      *
      * @throws {@link ErrorCode|AuthorizationInfoAlreadyExists} - when Authorization header or auth property already exists in request configuration.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     AddAuthenticationInfo(config) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -1187,8 +1170,6 @@ class BasicAuthProvider {
 // Copyright (c) Microsoft Corporation.
 /**
  * Provider that handles API Key authentication
- *
- * @beta
  */
 class ApiKeyProvider {
     /**
@@ -1199,8 +1180,6 @@ class ApiKeyProvider {
      *
      * @throws {@link ErrorCode|InvalidParameter} - when key name or key value is empty.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     constructor(keyName, keyValue, keyLocation) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "ApiKeyProvider"), ErrorCode.RuntimeNotSupported);
@@ -1215,8 +1194,6 @@ class ApiKeyProvider {
      *
      * @throws {@link ErrorCode|AuthorizationInfoAlreadyExists} - when API key already exists in request header or url query parameter.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     AddAuthenticationInfo(config) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -1226,8 +1203,6 @@ class ApiKeyProvider {
 }
 /**
  * Define available location for API Key location
- *
- * @beta
  */
 var ApiKeyLocation;
 (function (ApiKeyLocation) {
@@ -1244,15 +1219,11 @@ var ApiKeyLocation;
 // Copyright (c) Microsoft Corporation.
 /**
  * Provider that handles Certificate authentication
- *
- * @beta
  */
 class CertificateAuthProvider {
     /**
      *
      * @param { SecureContextOptions } certOption - information about the cert used in http requests
-     *
-     * @beta
      */
     constructor(certOption) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "CertificateAuthProvider"), ErrorCode.RuntimeNotSupported);
@@ -1267,8 +1238,6 @@ class CertificateAuthProvider {
      *
      * @throws {@link ErrorCode|InvalidParameter} - when custom httpsAgent in the request has duplicate properties with certOption provided in constructor.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     AddAuthenticationInfo(config) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -1312,8 +1281,6 @@ function createPfxCertOption(pfx, options) {
 // Licensed under the MIT license.
 /**
  * Identity type to use in authentication.
- *
- * @beta
  */
 var IdentityType;
 (function (IdentityType) {
@@ -1330,7 +1297,6 @@ var IdentityType;
 // Copyright (c) Microsoft Corporation.
 /**
  * A class providing credential and configuration.
- * @beta
  */
 class TeamsFx {
     constructor(identityType, customConfig) {
@@ -1343,8 +1309,9 @@ class TeamsFx {
         this.configuration = new Map();
         this.loadFromEnv();
         if (customConfig) {
-            for (const key of Object.keys(customConfig)) {
-                const value = customConfig[key];
+            const myConfig = Object.assign({}, customConfig);
+            for (const key of Object.keys(myConfig)) {
+                const value = myConfig[key];
                 if (value) {
                     this.configuration.set(key, value);
                 }
@@ -1392,14 +1359,14 @@ class TeamsFx {
         }
         return this.teamsUserCredential;
     }
-    getUserInfo() {
+    getUserInfo(resources) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.getCredential().getUserInfo();
+            return yield this.getCredential().getUserInfo(resources);
         });
     }
-    login(scopes) {
+    login(scopes, resources) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.getCredential().login(scopes);
+            yield this.getCredential().login(scopes, resources);
         });
     }
     setSsoToken(ssoToken) {
@@ -1428,6 +1395,65 @@ class TeamsFx {
     }
 }
 
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+/**
+ * The target type where the notification will be sent to.
+ *
+ * @remarks
+ * - "Channel" means to a team channel. (By default, notification to a team will be sent to its "General" channel.)
+ * - "Group" means to a group chat.
+ * - "Person" means to a personal chat.
+ */
+var NotificationTargetType;
+(function (NotificationTargetType) {
+    /**
+     * The notification will be sent to a team channel.
+     * (By default, notification to a team will be sent to its "General" channel.)
+     */
+    NotificationTargetType["Channel"] = "Channel";
+    /**
+     * The notification will be sent to a group chat.
+     */
+    NotificationTargetType["Group"] = "Group";
+    /**
+     * The notification will be sent to a personal chat.
+     */
+    NotificationTargetType["Person"] = "Person";
+})(NotificationTargetType || (NotificationTargetType = {}));
+/**
+ * Options used to control how the response card will be sent to users.
+ */
+var AdaptiveCardResponse;
+(function (AdaptiveCardResponse) {
+    /**
+     * The response card will be replaced the current one for the interactor who trigger the action.
+     */
+    AdaptiveCardResponse[AdaptiveCardResponse["ReplaceForInteractor"] = 0] = "ReplaceForInteractor";
+    /**
+     * The response card will be replaced the current one for all users in the chat.
+     */
+    AdaptiveCardResponse[AdaptiveCardResponse["ReplaceForAll"] = 1] = "ReplaceForAll";
+    /**
+     * The response card will be sent as a new message for all users in the chat.
+     */
+    AdaptiveCardResponse[AdaptiveCardResponse["NewForAll"] = 2] = "NewForAll";
+})(AdaptiveCardResponse || (AdaptiveCardResponse = {}));
+/**
+ * Status code for an `application/vnd.microsoft.error` invoke response.
+ */
+var InvokeResponseErrorCode;
+(function (InvokeResponseErrorCode) {
+    /**
+     * Invalid request.
+     */
+    InvokeResponseErrorCode[InvokeResponseErrorCode["BadRequest"] = 400] = "BadRequest";
+    /**
+     * Internal server error.
+     */
+    InvokeResponseErrorCode[InvokeResponseErrorCode["InternalServerError"] = 500] = "InternalServerError";
+})(InvokeResponseErrorCode || (InvokeResponseErrorCode = {}));
+
 // Copyright (c) Microsoft Corporation.
 /**
  * Provide utilities for bot conversation, including:
@@ -1436,8 +1462,6 @@ class TeamsFx {
  *
  * @remarks
  * Only work on server side.
- *
- * @beta
  */
 class ConversationBot {
     /**
@@ -1447,8 +1471,6 @@ class ConversationBot {
      *
      * @remarks
      * Only work on server side.
-     *
-     * @beta
      */
     constructor(options) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "ConversationBot"), ErrorCode.RuntimeNotSupported);
@@ -1462,8 +1484,6 @@ class ConversationBot {
      *
      * @remarks
      * Only work on server side.
-     *
-     * @beta
      */
     requestHandler(req, res, logic) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -1472,6 +1492,51 @@ class ConversationBot {
     }
 }
 
+// Copyright (c) Microsoft Corporation.
+/*
+ * Sso execution dialog, use to handle sso command
+ */
+class BotSsoExecutionDialog {
+    /**
+     * Creates a new instance of the BotSsoExecutionDialog.
+     * @param dedupStorage Helper storage to remove duplicated messages
+     * @param requiredScopes The list of scopes for which the token will have access
+     * @param teamsfx {@link TeamsFx} instance for authentication
+     */
+    constructor(dedupStorage, requiredScopes, teamsfx) {
+        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "BotSsoExecutionDialog"), ErrorCode.RuntimeNotSupported);
+    }
+    /**
+     * Add TeamsFxBotSsoCommandHandler instance
+     * @param handler {@link BotSsoExecutionDialogHandler} callback function
+     * @param triggerPatterns The trigger pattern
+     */
+    addCommand(handler, triggerPatterns) {
+        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "BotSsoExecutionDialog"), ErrorCode.RuntimeNotSupported);
+    }
+    /**
+     * The run method handles the incoming activity (in the form of a DialogContext) and passes it through the dialog system.
+     *
+     * @param context The context object for the current turn.
+     * @param accessor The instance of StatePropertyAccessor for dialog system.
+     */
+    run(context, accessor) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "BotSsoExecutionDialog"), ErrorCode.RuntimeNotSupported);
+        });
+    }
+    /**
+     * Called when the component is ending.
+     *
+     * @param context Context for the current turn of conversation.
+     */
+    onEndDialog(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "BotSsoExecutionDialog"), ErrorCode.RuntimeNotSupported);
+        });
+    }
+}
+
 // Copyright (c) Microsoft Corporation.
 /**
  * Send a plain text message to a notification target.
@@ -1481,11 +1546,10 @@ class ConversationBot {
  *
  * @param target - the notification target.
  * @param text - the plain text message.
+ * @param onError - an optional error handler that can catch exceptions during message sending.
  * @returns A `Promise` representing the asynchronous operation.
- *
- * @beta
  */
-function sendMessage(target, text) {
+function sendMessage(target, text, onError) {
     throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "sendMessage"), ErrorCode.RuntimeNotSupported);
 }
 /**
@@ -1496,11 +1560,10 @@ function sendMessage(target, text) {
  *
  * @param target - the notification target.
  * @param card - the adaptive card raw JSON.
+ * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
  * @returns A `Promise` representing the asynchronous operation.
- *
- * @beta
  */
-function sendAdaptiveCard(target, card) {
+function sendAdaptiveCard(target, card, onError) {
     throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "sendAdaptiveCard"), ErrorCode.RuntimeNotSupported);
 }
 /**
@@ -1510,8 +1573,6 @@ function sendAdaptiveCard(target, card) {
  * Only work on server side.
  *
  * It's recommended to get channels from {@link TeamsBotInstallation.channels()}.
- *
- * @beta
  */
 class Channel {
     /**
@@ -1524,8 +1585,6 @@ class Channel {
      *
      * @param parent - The parent {@link TeamsBotInstallation} where this channel is created from.
      * @param info - Detailed channel information.
-     *
-     * @beta
      */
     constructor(parent, info) {
         /**
@@ -1533,10 +1592,8 @@ class Channel {
          *
          * @remarks
          * Only work on server side.
-         *
-         * @beta
          */
-        this.type = "Channel";
+        this.type = NotificationTargetType.Channel;
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "Channel"), ErrorCode.RuntimeNotSupported);
     }
     /**
@@ -1546,11 +1603,10 @@ class Channel {
      * Only work on server side.
      *
      * @param text - the plain text message.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during message sending.
+     * @returns the response of sending message.
      */
-    sendMessage(text) {
+    sendMessage(text, onError) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "Channel"), ErrorCode.RuntimeNotSupported);
     }
     /**
@@ -1560,11 +1616,10 @@ class Channel {
      * Only work on server side.
      *
      * @param card - the adaptive card raw JSON.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+     * @returns the response of sending adaptive card message.
      */
-    sendAdaptiveCard(card) {
+    sendAdaptiveCard(card, onError) {
         return __awaiter(this, void 0, void 0, function* () {
             throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "Channel"), ErrorCode.RuntimeNotSupported);
         });
@@ -1577,8 +1632,6 @@ class Channel {
  * Only work on server side.
  *
  * It's recommended to get members from {@link TeamsBotInstallation.members()}.
- *
- * @beta
  */
 class Member {
     /**
@@ -1591,8 +1644,6 @@ class Member {
      *
      * @param parent - The parent {@link TeamsBotInstallation} where this member is created from.
      * @param account - Detailed member account information.
-     *
-     * @beta
      */
     constructor(parent, account) {
         /**
@@ -1600,10 +1651,8 @@ class Member {
          *
          * @remarks
          * Only work on server side.
-         *
-         * @beta
          */
-        this.type = "Person";
+        this.type = NotificationTargetType.Person;
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "Member"), ErrorCode.RuntimeNotSupported);
     }
     /**
@@ -1613,11 +1662,10 @@ class Member {
      * Only work on server side.
      *
      * @param text - the plain text message.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during message sending.
+     * @returns the response of sending message.
      */
-    sendMessage(text) {
+    sendMessage(text, onError) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "Member"), ErrorCode.RuntimeNotSupported);
     }
     /**
@@ -1627,11 +1675,10 @@ class Member {
      * Only work on server side.
      *
      * @param card - the adaptive card raw JSON.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+     * @returns the response of sending adaptive card message.
      */
-    sendAdaptiveCard(card) {
+    sendAdaptiveCard(card, onError) {
         return __awaiter(this, void 0, void 0, function* () {
             throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "Member"), ErrorCode.RuntimeNotSupported);
         });
@@ -1647,8 +1694,6 @@ class Member {
  * Only work on server side.
  *
  * It's recommended to get bot installations from {@link ConversationBot.installations()}.
- *
- * @beta
  */
 class TeamsBotInstallation {
     /**
@@ -1661,8 +1706,6 @@ class TeamsBotInstallation {
      *
      * @param adapter - the bound `BotFrameworkAdapter`.
      * @param conversationReference - the bound `ConversationReference`.
-     *
-     * @beta
      */
     constructor(adapter, conversationReference) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "TeamsBotInstallation"), ErrorCode.RuntimeNotSupported);
@@ -1674,11 +1717,10 @@ class TeamsBotInstallation {
      * Only work on server side.
      *
      * @param text - the plain text message.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during message sending.
+     * @returns the response of sending message.
      */
-    sendMessage(text) {
+    sendMessage(text, onError) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "TeamsBotInstallation"), ErrorCode.RuntimeNotSupported);
     }
     /**
@@ -1688,11 +1730,10 @@ class TeamsBotInstallation {
      * Only work on server side.
      *
      * @param card - the adaptive card raw JSON.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+     * @returns the response of sending adaptive card message.
      */
-    sendAdaptiveCard(card) {
+    sendAdaptiveCard(card, onError) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "TeamsBotInstallation"), ErrorCode.RuntimeNotSupported);
     }
     /**
@@ -1702,8 +1743,6 @@ class TeamsBotInstallation {
      * Only work on server side.
      *
      * @returns an array of channels if bot is installed into a team, otherwise returns an empty array.
-     *
-     * @beta
      */
     channels() {
         return __awaiter(this, void 0, void 0, function* () {
@@ -1717,14 +1756,22 @@ class TeamsBotInstallation {
      * Only work on server side.
      *
      * @returns an array of members from where the bot is installed.
-     *
-     * @beta
      */
     members() {
         return __awaiter(this, void 0, void 0, function* () {
             throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "TeamsBotInstallation"), ErrorCode.RuntimeNotSupported);
         });
     }
+    /**
+     * Get team details from this bot installation
+     *
+     * @returns the team details if bot is installed into a team, otherwise returns undefined.
+     */
+    getTeamDetails() {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "TeamsBotInstallation"), ErrorCode.RuntimeNotSupported);
+        });
+    }
 }
 /**
  * Provide static utilities for bot notification.
@@ -1750,8 +1797,6 @@ class TeamsBotInstallation {
  *   }
  * }
  * ```
- *
- * @beta
  */
 class NotificationBot {
     /**
@@ -1764,8 +1809,6 @@ class NotificationBot {
      *
      * @param adapter - the bound `BotFrameworkAdapter`
      * @param options - initialize options
-     *
-     * @beta
      */
     constructor(adapter, options) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "NotificationBot"), ErrorCode.RuntimeNotSupported);
@@ -1779,15 +1822,101 @@ class NotificationBot {
      * The result is retrieving from the persisted storage.
      *
      * @returns - an array of {@link TeamsBotInstallation}.
-     *
-     * @beta
      */
     static installations() {
         return __awaiter(this, void 0, void 0, function* () {
             throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "NotificationBot"), ErrorCode.RuntimeNotSupported);
         });
     }
-}
+    /**
+     * Returns the first {@link Member} where predicate is true, and undefined otherwise.
+     *
+     * @remarks
+     * Only work on server side.
+     *
+     * @param predicate find calls predicate once for each member of the installation,
+     * until it finds one where predicate returns true. If such a member is found, find
+     * immediately returns that member. Otherwise, find returns undefined.
+     * @param scope the scope to find members from the installations
+     * (personal chat, group chat, Teams channel).
+     * @returns the first {@link Member} where predicate is true, and undefined otherwise.
+     */
+    findMember(predicate, scope) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "NotificationBot"), ErrorCode.RuntimeNotSupported);
+        });
+    }
+    /**
+     * Returns the first {@link Channel} where predicate is true, and undefined otherwise.
+     *
+     * @remarks
+     * Only work on server side.
+     *
+     * @param predicate find calls predicate once for each channel of the installation,
+     * until it finds one where predicate returns true. If such a channel is found, find
+     * immediately returns that channel. Otherwise, find returns undefined.
+     * @returns the first {@link Channel} where predicate is true, and undefined otherwise.
+     */
+    findChannel(predicate) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "NotificationBot"), ErrorCode.RuntimeNotSupported);
+        });
+    }
+    /**
+     * Returns all {@link Member} where predicate is true, and empty array otherwise.
+     *
+     * @remarks
+     * Only work on server side.
+     *
+     * @param predicate find calls predicate for each member of the installation.
+     * @param scope the scope to find members from the installations
+     * (personal chat, group chat, Teams channel).
+     * @returns an array of {@link Member} where predicate is true, and empty array otherwise.
+     */
+    findAllMembers(predicate, scope) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "NotificationBot"), ErrorCode.RuntimeNotSupported);
+        });
+    }
+    /**
+     * Returns all {@link Channel} where predicate is true, and empty array otherwise.
+     *
+     * @remarks
+     * Only work on server side.
+     *
+     * @param predicate find calls predicate for each channel of the installation.
+     * @returns an array of {@link Channel} where predicate is true, and empty array otherwise.
+     */
+    findAllChannels(predicate) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "NotificationBot"), ErrorCode.RuntimeNotSupported);
+        });
+    }
+}
+/**
+ * The search scope when calling {@link NotificationBot.findMember} and {@link NotificationBot.findAllMembers}.
+ * The search scope is a flagged enum and it can be combined with `|`.
+ * For example, to search from personal chat and group chat, use `SearchScope.Person | SearchScope.Group`.
+ */
+var SearchScope;
+(function (SearchScope) {
+    /**
+     * Search members from the installations in personal chat only.
+     */
+    SearchScope[SearchScope["Person"] = 1] = "Person";
+    /**
+     * Search members from the installations in group chat only.
+     */
+    SearchScope[SearchScope["Group"] = 2] = "Group";
+    /**
+     * Search members from the installations in Teams channel only.
+     */
+    SearchScope[SearchScope["Channel"] = 4] = "Channel";
+    /**
+     * Search members from all installations including personal chat, group chat and Teams channel.
+     */
+    SearchScope[SearchScope["All"] = 7] = "All";
+})(SearchScope || (SearchScope = {}));
 
 // Copyright (c) Microsoft Corporation.
 /**
@@ -1795,8 +1924,6 @@ class NotificationBot {
  *
  * @remarks
  * Only work on server side.
- *
- * @beta
  */
 class CommandBot {
     /**
@@ -1804,8 +1931,6 @@ class CommandBot {
      *
      * @param adapter The bound `BotFrameworkAdapter`.
      * @param commands The commands to registered with the command bot. Each command should implement the interface {@link TeamsFxBotCommandHandler} so that it can be correctly handled by this command bot.
-     *
-     * @beta
      */
     constructor(adapter, commands) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "CommandBot"), ErrorCode.RuntimeNotSupported);
@@ -1817,8 +1942,6 @@ class CommandBot {
      *
      * @remarks
      * Only work on server side.
-     *
-     * @beta
      */
     registerCommand(command) {
         throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "CommandBot"), ErrorCode.RuntimeNotSupported);
@@ -1830,13 +1953,76 @@ class CommandBot {
      *
      * @remarks
      * Only work on server side.
-     *
-     * @beta
      */
     registerCommands(commands) {
-        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "CommandnBot"), ErrorCode.RuntimeNotSupported);
+        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "CommandBot"), ErrorCode.RuntimeNotSupported);
+    }
+    /**
+     * Registers a sso command into the command bot.
+     *
+     * @param command The command to register.
+     */
+    registerSsoCommand(ssoCommand) {
+        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "CommandBot"), ErrorCode.RuntimeNotSupported);
+    }
+    /**
+     * Registers commands into the command bot.
+     *
+     * @param commands The commands to register.
+     */
+    registerSsoCommands(ssoCommands) {
+        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "CommandBot"), ErrorCode.RuntimeNotSupported);
+    }
+}
+
+/**
+ * A card action bot to respond to adaptive card universal actions.
+ *
+ * @remarks
+ * Only work on server side.
+ */
+class CardActionBot {
+    /**
+     * Creates a new instance of the `CardActionBot`.
+     *
+     * @param adapter The bound `BotFrameworkAdapter`.
+     * @param options - initialize options
+     */
+    constructor(adapter, options) {
+        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "CardActionBot"), ErrorCode.RuntimeNotSupported);
     }
+    /**
+     * Registers a card action handler to the bot.
+     * @param actionHandler A card action handler to be registered.
+     *
+     * @remarks
+     * Only work on server side.
+     */
+    registerHandler(actionHandler) {
+        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "CardActionBot"), ErrorCode.RuntimeNotSupported);
+    }
+    /**
+     * Registers card action handlers to the bot.
+     * @param actionHandlers A set of card action handlers to be registered.
+     *
+     * @remarks
+     * Only work on server side.
+     */
+    registerHandlers(actionHandlers) {
+        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "CardActionBot"), ErrorCode.RuntimeNotSupported);
+    }
+}
+
+/**
+ * Users execute query with SSO or Access Token.
+ * @remarks
+ * Only works in in server side.
+ */
+function handleMessageExtensionQueryWithToken(context, config, scopes, logic) {
+    return __awaiter(this, void 0, void 0, function* () {
+        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "queryWithToken in message extension"), ErrorCode.RuntimeNotSupported);
+    });
 }
 
-export { ApiKeyLocation, ApiKeyProvider, AppCredential, BasicAuthProvider, BearerTokenAuthProvider, CertificateAuthProvider, Channel, CommandBot, ConversationBot, ErrorCode, ErrorWithCode, IdentityType, LogLevel, Member, MsGraphAuthProvider, NotificationBot, OnBehalfOfUserCredential, TeamsBotInstallation, TeamsBotSsoPrompt, TeamsFx, TeamsUserCredential, createApiClient, createMicrosoftGraphClient, createPemCertOption, createPfxCertOption, getLogLevel, getTediousConnectionConfig, sendAdaptiveCard, sendMessage, setLogFunction, setLogLevel, setLogger };
+export { AdaptiveCardResponse, ApiKeyLocation, ApiKeyProvider, AppCredential, BasicAuthProvider, BearerTokenAuthProvider, BotSsoExecutionDialog, CardActionBot, CertificateAuthProvider, Channel, CommandBot, ConversationBot, ErrorCode, ErrorWithCode, IdentityType, InvokeResponseErrorCode, LogLevel, Member, MsGraphAuthProvider, NotificationBot, NotificationTargetType, OnBehalfOfUserCredential, TeamsBotInstallation, TeamsBotSsoPrompt, TeamsFx, TeamsUserCredential, createApiClient, createMicrosoftGraphClient, createPemCertOption, createPfxCertOption, getLogLevel, getTediousConnectionConfig, handleMessageExtensionQueryWithToken, sendAdaptiveCard, sendMessage, setLogFunction, setLogLevel, setLogger };
 //# sourceMappingURL=index.esm5.js.map