@microsoft/teamsfx 1.1.2-alpha.8882e735e.0 → 1.1.2-alpha.8d60b4f8e.0

package/dist/index.esm5.js

@@ -32,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.
      */
@@ -87,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
@@ -97,6 +130,7 @@ 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.
  */
@@ -511,19 +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.
      */
-    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);
             }
             return new Promise((resolve, reject) => {
                 microsoftTeams.initialize(() => {
@@ -576,6 +611,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
@@ -589,6 +627,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.
@@ -605,9 +646,11 @@ class TeamsUserCredential {
      * Throw error if get access token failed.
      */
     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");
@@ -616,7 +659,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;
@@ -663,6 +706,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();
@@ -674,16 +719,16 @@ class TeamsUserCredential {
      *
      * @returns Basic user info with user displayName, objectId and preferredUserName.
      */
-    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;
@@ -703,9 +748,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 new Promise((resolve, reject) => {
             if (this.ssoToken) {
                 if (this.ssoToken.expiresOnTimestamp - Date.now() > tokenRefreshTimeSpanInMillisecond) {
@@ -743,7 +791,7 @@ class TeamsUserCredential {
                             internalLogger.error(errorMsg);
                             reject(new ErrorWithCode(errorMsg, ErrorCode.InternalError));
                         },
-                        resources: [],
+                        resources: resources !== null && resources !== void 0 ? resources : [],
                     });
                 });
             }
@@ -1278,8 +1326,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);
                 }
@@ -1327,14 +1376,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) {
@@ -1460,6 +1509,117 @@ 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.
+/**
+ * Default sso execution activity handler
+ */
+class DefaultBotSsoExecutionActivityHandler {
+    /**
+     * Creates a new instance of the DefaultBotSsoExecutionActivityHandler.
+     * @param ssoConfig configuration for sso command bot
+     */
+    constructor(ssoConfig) {
+        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "DefaultBotSsoExecutionActivityHandler"), ErrorCode.RuntimeNotSupported);
+    }
+    /**
+     * Add TeamsFxBotSsoCommandHandler instance to sso execution dialog
+     * @param handler {@link BotSsoExecutionDialogHandler} callback function
+     * @param triggerPatterns The trigger pattern
+     */
+    addCommand(handler, triggerPatterns) {
+        throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "DefaultBotSsoExecutionActivityHandler"), ErrorCode.RuntimeNotSupported);
+    }
+    /**
+     * Called to initiate the event emission process.
+     * @param context The context object for the current turn.
+     */
+    run(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "DefaultBotSsoExecutionActivityHandler"), ErrorCode.RuntimeNotSupported);
+        });
+    }
+    /**
+     * Receives invoke activities with Activity name of 'signin/verifyState'.
+     * @param context A context object for this turn.
+     * @param query Signin state (part of signin action auth flow) verification invoke query.
+     * @returns A promise that represents the work queued.
+     */
+    handleTeamsSigninVerifyState(context, query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "DefaultBotSsoExecutionActivityHandler"), ErrorCode.RuntimeNotSupported);
+        });
+    }
+    /**
+     * Receives invoke activities with Activity name of 'signin/tokenExchange'
+     * @param context A context object for this turn.
+     * @param query Signin state (part of signin action auth flow) verification invoke query
+     * @returns A promise that represents the work queued.
+     */
+    handleTeamsSigninTokenExchange(context, query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "DefaultBotSsoExecutionActivityHandler"), ErrorCode.RuntimeNotSupported);
+        });
+    }
+    /**
+     * Handle signin invoke activity type.
+     *
+     * @param context The context object for the current turn.
+     *
+     * @remarks
+     * Override this method to support channel-specific behavior across multiple channels.
+     */
+    onSignInInvoke(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new ErrorWithCode(formatString(ErrorMessage.BrowserRuntimeNotSupported, "DefaultBotSsoExecutionActivityHandler"), ErrorCode.RuntimeNotSupported);
+        });
+    }
+}
+
 // Copyright (c) Microsoft Corporation.
 /**
  * Send a plain text message to a notification target.
@@ -1677,6 +1837,16 @@ class TeamsBotInstallation {
             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.
@@ -1733,7 +1903,95 @@ class NotificationBot {
             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.
 /**
@@ -1774,6 +2032,22 @@ class CommandBot {
     registerCommands(commands) {
         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);
+    }
 }
 
 /**
@@ -1814,5 +2088,16 @@ class CardActionBot {
     }
 }
 
-export { AdaptiveCardResponse, ApiKeyLocation, ApiKeyProvider, AppCredential, BasicAuthProvider, BearerTokenAuthProvider, 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, sendAdaptiveCard, sendMessage, setLogFunction, setLogLevel, setLogger };
+/**
+ * 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 { AdaptiveCardResponse, ApiKeyLocation, ApiKeyProvider, AppCredential, BasicAuthProvider, BearerTokenAuthProvider, BotSsoExecutionDialog, CardActionBot, CertificateAuthProvider, Channel, CommandBot, ConversationBot, DefaultBotSsoExecutionActivityHandler, 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