@microsoft/teamsfx 0.6.3-alpha.8d048e1f1.0 → 0.6.3-alpha.b31d198d3.0

package/types/teamsfx.d.ts

@@ -1,3 +1,5 @@
+/// <reference types="node" />
+
 import { AccessToken } from '@azure/identity';
 import { Activity } from 'botbuilder-core';
 import { Activity as Activity_2 } from 'botbuilder';
@@ -19,11 +21,68 @@ import { GetTokenOptions } from '@azure/identity';
 import { HeroCard } from 'botbuilder';
 import { O365ConnectorCard } from 'botbuilder';
 import { ReceiptCard } from 'botbuilder';
+import { SecureContextOptions } from 'tls';
 import { TeamsChannelAccount } from 'botbuilder';
 import { ThumbnailCard } from 'botbuilder';
 import { TokenCredential } from '@azure/identity';
 import { TokenResponse } from 'botframework-schema';
 import { TurnContext } from 'botbuilder-core';
+import { TurnContext as TurnContext_2 } from 'botbuilder';
+import { WebRequest } from 'botbuilder';
+import { WebResponse } from 'botbuilder';
+
+/**
+ * Define available location for API Key location
+ *
+ * @beta
+ */
+export declare enum ApiKeyLocation {
+    /**
+     * The API Key is placed in request header
+     */
+    Header = 0,
+    /**
+     * The API Key is placed in query parameter
+     */
+    QueryParams = 1
+}
+
+/**
+ * Provider that handles API Key authentication
+ *
+ * @beta
+ */
+export declare class ApiKeyProvider implements AuthProvider {
+    private keyName;
+    private keyValue;
+    private keyLocation;
+    /**
+     *
+     * @param { string } keyName - The name of request header or query parameter that specifies API Key
+     * @param { string } keyValue - The value of API Key
+     * @param { ApiKeyLocation } keyLocation - The location of API Key: request header or query parameter.
+     *
+     * @throws {@link ErrorCode|InvalidParameter} - when key name or key value is empty.
+     * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
+     *
+     * @beta
+     */
+    constructor(keyName: string, keyValue: string, keyLocation: ApiKeyLocation);
+    /**
+     * Adds authentication info to http requests
+     *
+     * @param { AxiosRequestConfig } config - Contains all the request information and can be updated to include extra authentication info.
+     * Refer https://axios-http.com/docs/req_config for detailed document.
+     *
+     * @returns Updated axios request config.
+     *
+     * @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: AxiosRequestConfig): Promise<AxiosRequestConfig>;
+}
 
 /**
  * Represent Microsoft 365 tenant identity, and it is usually used when user is not involved like time-triggered automation job.
@@ -148,7 +207,7 @@ export declare interface AuthProvider {
     /**
      * Adds authentication info to http requests
      *
-     * @param config - Contains all the request information and can be updated to include extra authentication info.
+     * @param { AxiosRequestConfig } config - Contains all the request information and can be updated to include extra authentication info.
      * Refer https://axios-http.com/docs/req_config for detailed document.
      *
      * @beta
@@ -156,6 +215,43 @@ export declare interface AuthProvider {
     AddAuthenticationInfo: (config: AxiosRequestConfig) => Promise<AxiosRequestConfig>;
 }
 
+export { AxiosInstance }
+
+/**
+ * Provider that handles Basic authentication
+ *
+ * @beta
+ */
+export declare class BasicAuthProvider implements AuthProvider {
+    private userName;
+    private password;
+    /**
+     *
+     * @param { string } userName - Username used in basic auth
+     * @param { string } password - Password used in basic auth
+     *
+     * @throws {@link ErrorCode|InvalidParameter} - when username or password is empty.
+     * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
+     *
+     * @beta
+     */
+    constructor(userName: string, password: string);
+    /**
+     * Adds authentication info to http requests
+     *
+     * @param { AxiosRequestConfig } config - Contains all the request information and can be updated to include extra authentication info.
+     * Refer https://axios-http.com/docs/req_config for detailed document.
+     *
+     * @returns Updated axios request config.
+     *
+     * @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: AxiosRequestConfig): Promise<AxiosRequestConfig>;
+}
+
 /**
  * Provider that handles Bearer Token authentication
  *
@@ -164,7 +260,7 @@ export declare interface AuthProvider {
 export declare class BearerTokenAuthProvider implements AuthProvider {
     private getToken;
     /**
-     * @param getToken Function that returns the content of bearer token used in http request
+     * @param { () => Promise<string> } getToken - Function that returns the content of bearer token used in http request
      *
      * @beta
      */
@@ -172,9 +268,44 @@ export declare class BearerTokenAuthProvider implements AuthProvider {
     /**
      * Adds authentication info to http requests
      *
-     * @param config - Contains all the request information and can be updated to include extra authentication info.
+     * @param { AxiosRequestConfig } config - Contains all the request information and can be updated to include extra authentication info.
+     * Refer https://axios-http.com/docs/req_config for detailed document.
+     *
+     * @returns Updated axios request config.
+     *
+     * @throws {@link ErrorCode|AuthorizationInfoAlreadyExists} - when Authorization header already exists in request configuration.
+     *
+     * @beta
+     */
+    AddAuthenticationInfo(config: AxiosRequestConfig): Promise<AxiosRequestConfig>;
+}
+
+/**
+ * Provider that handles Certificate authentication
+ *
+ * @beta
+ */
+export declare class CertificateAuthProvider implements AuthProvider {
+    private certOption;
+    /**
+     *
+     * @param { SecureContextOptions } certOption - information about the cert used in http requests
+     *
+     * @throws {@link ErrorCode|InvalidParameter} - when cert option is empty.
+     *
+     * @beta
+     */
+    constructor(certOption: SecureContextOptions);
+    /**
+     * Adds authentication info to http requests.
+     *
+     * @param { AxiosRequestConfig } config - Contains all the request information and can be updated to include extra authentication info.
      * Refer https://axios-http.com/docs/req_config for detailed document.
      *
+     * @returns Updated axios request config.
+     *
+     * @throws {@link ErrorCode|InvalidParameter} - when custom httpsAgent in the request has duplicate properties with certOption provided in constructor.
+     *
      * @beta
      */
     AddAuthenticationInfo(config: AxiosRequestConfig): Promise<AxiosRequestConfig>;
@@ -290,7 +421,7 @@ export declare interface CommandMessage {
      */
     text: string;
     /**
-     * The capture groups that matched to the {@link triggerPatterns} in a {@link TeamsFxBotCommandHandler} instance.
+     * The capture groups that matched to the {@link TriggerPatterns} in a {@link TeamsFxBotCommandHandler} instance.
      */
     matches?: RegExpMatchArray;
 }
@@ -312,7 +443,7 @@ export declare interface CommandOptions {
 /**
  * Provide utilities for bot conversation, including:
  *   - handle command and response.
- *   - send notification to varies targets (e.g., member, channel, incoming wehbook).
+ *   - send notification to varies targets (e.g., member, group, channel).
  *
  * @example
  * For command and response, you can register your commands through the constructor, or use the `registerCommand` and `registerCommands` API to add commands later.
@@ -322,9 +453,7 @@ export declare interface CommandOptions {
  * const conversationBot = new ConversationBot({
  *   command: {
  *     enabled: true,
- *     options: {
- *         commands: [ new HelloWorldCommandHandler() ],
- *     },
+ *     commands: [ new HelloWorldCommandHandler() ],
  *   },
  * });
  *
@@ -332,7 +461,7 @@ export declare interface CommandOptions {
  * conversationBot.command.registerCommand(new HelpCommandHandler());
  * ```
  *
- * For notification, you can enable notification at initialization, then send notificaations at any time.
+ * For notification, you can enable notification at initialization, then send notifications at any time.
  *
  * ```typescript
  * // enable through constructor
@@ -360,7 +489,7 @@ export declare interface CommandOptions {
  *
  * For command and response, ensure each command should ONLY be registered with the command once, otherwise it'll cause unexpected behavior if you register the same command more than once.
  *
- * For notification, set `notification.options.storage` in {@link ConversationOptions} to use your own storage implementation.
+ * For notification, set `notification.storage` in {@link ConversationOptions} to use your own storage implementation.
  *
  * @beta
  */
@@ -386,11 +515,39 @@ export declare class ConversationBot {
     /**
      * Creates new instance of the `ConversationBot`.
      *
+     * @remarks
+     * It's recommended to create your own adapter and storage for production environment instead of the default one.
+     *
      * @param options - initialize options
      *
      * @beta
      */
     constructor(options: ConversationOptions);
+    private createDefaultAdapter;
+    /**
+     * The request handler to integrate with web request.
+     *
+     * @param req - an Express or Restify style request object.
+     * @param res - an Express or Restify style response object.
+     * @param logic - the additional function to handle bot context.
+     *
+     * @example
+     * For example, to use with Restify:
+     * ``` typescript
+     * // The default/empty behavior
+     * server.post("api/messages", conversationBot.requestHandler);
+     *
+     * // Or, add your own logic
+     * server.post("api/messages", async (req, res) => {
+     *   await conversationBot.requestHandler(req, res, async (context) => {
+     *     // your-own-context-logic
+     *   });
+     * });
+     * ```
+     *
+     * @beta
+     */
+    requestHandler(req: WebRequest, res: WebResponse, logic?: (context: TurnContext_2) => Promise<any>): Promise<void>;
 }
 
 /**
@@ -400,48 +557,52 @@ export declare class ConversationBot {
  */
 export declare interface ConversationOptions {
     /**
-     * The bot adapter. If not provided, a default adapter will be created with BOT_ID and BOT_PASSWORD from environment variables.
+     * The bot adapter. If not provided, a default adapter will be created:
+     * - with `adapterConfig` as constructor parameter.
+     * - with a default error handler that logs error to console, sends trace activity, and sends error message to user.
+     *
+     * @remarks
+     * If neither `adapter` nor `adapterConfig` is provided, will use BOT_ID and BOT_PASSWORD from environment variables.
      *
      * @beta
      */
     adapter?: BotFrameworkAdapter;
+    /**
+     * If `adapter` is not provided, this `adapterConfig` will be passed to the new `BotFrameworkAdapter` when created internally.
+     *
+     * @remarks
+     * If neither `adapter` nor `adapterConfig` is provided, will use BOT_ID and BOT_PASSWORD from environment variables.
+     *
+     * @beta
+     */
+    adapterConfig?: {
+        [key: string]: unknown;
+    };
     /**
      * The command part.
      *
      * @beta
      */
-    command: {
+    command?: CommandOptions & {
         /**
          * Whether to enable command or not.
          *
          * @beta
          */
-        enabled: boolean;
-        /**
-         * The command options if command is enabled.
-         *
-         * @beta
-         */
-        options: CommandOptions;
+        enabled?: boolean;
     };
     /**
      * The notification part.
      *
      * @beta
      */
-    notification: {
+    notification?: NotificationOptions_2 & {
         /**
          * Whether to enable notification or not.
          *
          * @beta
          */
-        enabled: boolean;
-        /**
-         * The notification options if notification is enabled.
-         *
-         * @beta
-         */
-        options: NotificationOptions_2;
+        enabled?: boolean;
     };
 }
 
@@ -515,1251 +676,1283 @@ export declare function createApiClient(apiEndpoint: string, authProvider: AuthP
 export declare function createMicrosoftGraphClient(teamsfx: TeamsFxConfiguration, scopes?: string | string[]): Client;
 
 /**
- * Error code to trace the error types.
- * @beta
- */
-export declare enum ErrorCode {
-    /**
-     * Invalid parameter error.
-     */
-    InvalidParameter = "InvalidParameter",
-    /**
-     * Invalid configuration error.
-     */
-    InvalidConfiguration = "InvalidConfiguration",
-    /**
-     * Invalid certificate error.
-     */
-    InvalidCertificate = "InvalidCertificate",
-    /**
-     * Internal error.
-     */
-    InternalError = "InternalError",
-    /**
-     * Channel is not supported error.
-     */
-    ChannelNotSupported = "ChannelNotSupported",
-    /**
-     * Runtime is not supported error.
-     */
-    RuntimeNotSupported = "RuntimeNotSupported",
-    /**
-     * User failed to finish the AAD consent flow failed.
-     */
-    ConsentFailed = "ConsentFailed",
-    /**
-     * The user or administrator has not consented to use the application error.
-     */
-    UiRequiredError = "UiRequiredError",
-    /**
-     * Token is not within its valid time range error.
-     */
-    TokenExpiredError = "TokenExpiredError",
-    /**
-     * Call service (AAD or simple authentication server) failed.
-     */
-    ServiceError = "ServiceError",
-    /**
-     * Operation failed.
-     */
-    FailedOperation = "FailedOperation",
-    /**
-     * Invalid response error.
-     */
-    InvalidResponse = "InvalidResponse",
-    /**
-     * Identity type error.
-     */
-    IdentityTypeNotSupported = "IdentityTypeNotSupported"
-}
-
-/**
- * Error class with code and message thrown by the SDK.
+ * Helper to create SecureContextOptions from PEM format cert
  *
- * @beta
- */
-export declare class ErrorWithCode extends Error {
-    /**
-     * Error code
+ * @param { string | Buffer } cert - The cert chain in PEM format
+ * @param { string | Buffer } key - The private key for the cert chain
+ * @param { string? } passphrase - The passphrase for private key
+ * @param { string? | Buffer? } ca - Overrides the trusted CA certificates
      *
-     * @readonly
-     */
-    code: string | undefined;
-    /**
-     * Constructor of ErrorWithCode.
+     * @returns Instance of SecureContextOptions
      *
-     * @param {string} message - error message.
-     * @param {ErrorCode} code - error code.
+     * @throws {@link ErrorCode|InvalidParameter} - when any parameter is empty
      *
-     * @beta
      */
-    constructor(message?: string, code?: ErrorCode);
-}
+ export declare function createPemCertOption(cert: string | Buffer, key: string | Buffer, passphrase?: string, ca?: string | Buffer): SecureContextOptions;
 
-/**
- * Get log level.
- *
- * @returns Log level
- *
- * @beta
- */
-export declare function getLogLevel(): LogLevel | undefined;
+ /**
+  * Helper to create SecureContextOptions from PFX format cert
+  *
+  * @param { string | Buffer } pfx - The content of .pfx file
+  * @param { string? } passphrase - Optional. The passphrase of .pfx file
+  *
+  * @returns Instance of SecureContextOptions
+  *
+  * @throws {@link ErrorCode|InvalidParameter} - when any parameter is empty
+  *
+  */
+ export declare function createPfxCertOption(pfx: string | Buffer, passphrase?: string): SecureContextOptions;
 
-/**
- * Generate connection configuration consumed by tedious.
- *
- * @param {TeamsFx} teamsfx - Used to provide configuration and auth
- * @param { string? } databaseName - specify database name to override default one if there are multiple databases.
- *
- * @returns Connection configuration of tedious for the SQL.
- *
- * @throws {@link ErrorCode|InvalidConfiguration} when SQL config resource configuration is invalid.
- * @throws {@link ErrorCode|InternalError} when get user MSI token failed or MSI token is invalid.
- * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
- *
- * @beta
- */
-export declare function getTediousConnectionConfig(teamsfx: TeamsFx, databaseName?: string): Promise<ConnectionConfig>;
+ /**
+  * Error code to trace the error types.
+  * @beta
+  */
+ export declare enum ErrorCode {
+     /**
+      * Invalid parameter error.
+      */
+     InvalidParameter = "InvalidParameter",
+     /**
+      * Invalid configuration error.
+      */
+     InvalidConfiguration = "InvalidConfiguration",
+     /**
+      * Invalid certificate error.
+      */
+     InvalidCertificate = "InvalidCertificate",
+     /**
+      * Internal error.
+      */
+     InternalError = "InternalError",
+     /**
+      * Channel is not supported error.
+      */
+     ChannelNotSupported = "ChannelNotSupported",
+     /**
+      * Runtime is not supported error.
+      */
+     RuntimeNotSupported = "RuntimeNotSupported",
+     /**
+      * User failed to finish the AAD consent flow failed.
+      */
+     ConsentFailed = "ConsentFailed",
+     /**
+      * The user or administrator has not consented to use the application error.
+      */
+     UiRequiredError = "UiRequiredError",
+     /**
+      * Token is not within its valid time range error.
+      */
+     TokenExpiredError = "TokenExpiredError",
+     /**
+      * Call service (AAD or simple authentication server) failed.
+      */
+     ServiceError = "ServiceError",
+     /**
+      * Operation failed.
+      */
+     FailedOperation = "FailedOperation",
+     /**
+      * Invalid response error.
+      */
+     InvalidResponse = "InvalidResponse",
+     /**
+      * Identity type error.
+      */
+     IdentityTypeNotSupported = "IdentityTypeNotSupported",
+     /**
+      * Authentication info already exists error.
+      */
+     AuthorizationInfoAlreadyExists = "AuthorizationInfoAlreadyExists"
+ }
 
-/**
- * Identity type to use in authentication.
- *
- * @beta
- */
-export declare enum IdentityType {
-    /**
-     * Represents the current user of Teams.
-     */
-    User = "User",
-    /**
-     * Represents the application itself.
-     */
-    App = "Application"
-}
+ /**
+  * Error class with code and message thrown by the SDK.
+  *
+  * @beta
+  */
+ export declare class ErrorWithCode extends Error {
+     /**
+      * Error code
+      *
+      * @readonly
+      */
+     code: string | undefined;
+     /**
+      * Constructor of ErrorWithCode.
+      *
+      * @param {string} message - error message.
+      * @param {ErrorCode} code - error code.
+      *
+      * @beta
+      */
+     constructor(message?: string, code?: ErrorCode);
+ }
 
-/**
- * Log function for customized logging.
- *
- * @beta
- */
-export declare type LogFunction = (level: LogLevel, message: string) => void;
+ /**
+  * Get log level.
+  *
+  * @returns Log level
+  *
+  * @beta
+  */
+ export declare function getLogLevel(): LogLevel | undefined;
 
-/**
- * Interface for customized logger.
- * @beta
- */
-export declare interface Logger {
-    /**
-     * Writes to error level logging or lower.
-     */
-    error(message: string): void;
-    /**
-     * Writes to warning level logging or lower.
-     */
-    warn(message: string): void;
-    /**
-     * Writes to info level logging or lower.
-     */
-    info(message: string): void;
-    /**
-     * Writes to verbose level logging.
-     */
-    verbose(message: string): void;
-}
+ /**
+  * Generate connection configuration consumed by tedious.
+  *
+  * @param {TeamsFx} teamsfx - Used to provide configuration and auth
+  * @param { string? } databaseName - specify database name to override default one if there are multiple databases.
+  *
+  * @returns Connection configuration of tedious for the SQL.
+  *
+  * @throws {@link ErrorCode|InvalidConfiguration} when SQL config resource configuration is invalid.
+  * @throws {@link ErrorCode|InternalError} when get user MSI token failed or MSI token is invalid.
+  * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
+  *
+  * @beta
+  */
+ export declare function getTediousConnectionConfig(teamsfx: TeamsFx, databaseName?: string): Promise<ConnectionConfig>;
 
-/**
- * Log level.
- *
- * @beta
- */
-export declare enum LogLevel {
-    /**
-     * Show verbose, information, warning and error message.
-     */
-    Verbose = 0,
-    /**
-     * Show information, warning and error message.
-     */
-    Info = 1,
-    /**
-     * Show warning and error message.
-     */
-    Warn = 2,
-    /**
-     * Show error message.
-     */
-    Error = 3
-}
+ /**
+  * Identity type to use in authentication.
+  *
+  * @beta
+  */
+ export declare enum IdentityType {
+     /**
+      * Represents the current user of Teams.
+      */
+     User = "User",
+     /**
+      * Represents the application itself.
+      */
+     App = "Application"
+ }
 
-/**
- * A {@link NotificationTarget} that represents a team member.
- *
- * @remarks
- * It's recommended to get members from {@link TeamsBotInstallation.members()}.
- *
- * @beta
- */
-export declare class Member implements NotificationTarget {
-    /**
-     * The parent {@link TeamsBotInstallation} where this member is created from.
-     *
-     * @beta
-     */
-    readonly parent: TeamsBotInstallation;
-    /**
-     * Detailed member account information.
-     *
-     * @beta
-     */
-    readonly account: TeamsChannelAccount;
-    /**
-     * Notification target type. For member it's always "Person".
-     *
-     * @beta
-     */
-    readonly type: NotificationTargetType;
-    /**
-     * Constuctor.
-     *
-     * @remarks
-     * It's recommended to get members from {@link TeamsBotInstallation.members()}, instead of using this constructor.
-     *
-     * @param parent - The parent {@link TeamsBotInstallation} where this member is created from.
-     * @param account - Detailed member account information.
-     *
-     * @beta
-     */
-    constructor(parent: TeamsBotInstallation, account: TeamsChannelAccount);
-    /**
-     * Send a plain text message.
-     *
-     * @param text - the plain text message.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
-     */
-    sendMessage(text: string): Promise<void>;
-    /**
-     * Send an adaptive card message.
-     *
-     * @param card - the adaptive card raw JSON.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
-     */
-    sendAdaptiveCard(card: unknown): Promise<void>;
-    /**
-     * @internal
-     */
-    private newConversation;
-}
+ /**
+  * Log function for customized logging.
+  *
+  * @beta
+  */
+ export declare type LogFunction = (level: LogLevel, message: string) => void;
 
-/**
- * Provides utility method to build bot message with cards that supported in Teams.
- */
-export declare class MessageBuilder {
-    /**
-     * Build a bot message activity attached with adaptive card.
-     *
-     * @param getCardData Function to prepare your card data.
-     * @param cardTemplate The adaptive card template.
-     * @returns A bot message activity attached with an adaptive card.
-     *
-     * @example
-     * ```javascript
-     * const cardTemplate = {
-     *   type: "AdaptiveCard",
-     *   body: [
-     *     {
-     *       "type": "TextBlock",
-     *       "text": "${title}",
-     *       "size": "Large"
-     *     },
-     *     {
-     *       "type": "TextBlock",
-     *       "text": "${description}"
-     *     }],
-     *     $schema: "http://adaptivecards.io/schemas/adaptive-card.json",
-     *     version: "1.4"
-     *  };
-     *
-     * type CardData = {
-     *   title: string,
-     *   description: string
-     * };
-     * const card = MessageBuilder.attachAdaptiveCard<CardData>(() => {
-     *     return {
-     *       title: "sample card title",
-     *       description: "sample card description"
-     *     }}, cardTemplate);
-     * ```
-     *
-     * @beta
-     */
-    static attachAdaptiveCard<TData>(getCardData: () => TData, cardTemplate: any): Partial<Activity_2>;
-    /**
-     * Build a bot message activity attached with an adaptive card.
-     *
-     * @param card The adaptive card content.
-     * @returns A bot message activity attached with an adaptive card.
-     *
-     * @beta
-     */
-    static attachAdaptiveCardWithoutData(card: any): Partial<Activity_2>;
-    /**
-     * Build a bot message activity attached with an hero card.
-     *
-     * @param title The card title.
-     * @param images Optional. The array of images to include on the card.
-     * @param buttons Optional. The array of buttons to include on the card. Each `string` in the array
-     *      is converted to an `imBack` button with a title and value set to the value of the string.
-     * @param other Optional. Any additional properties to include on the card.
-     *
-     * @returns A bot message activity attached with a hero card.
-     *
-     * @example
-     * ```javascript
-     * const message = MessageBuilder.attachHeroCard(
-     *      'sample title',
-     *      ['https://example.com/sample.jpg'],
-     *      ['action']
-     * );
-     * ```
-     *
-     * @beta
-     */
-    static attachHeroCard(title: string, images?: (CardImage | string)[], buttons?: (CardAction | string)[], other?: Partial<HeroCard>): Partial<Activity_2>;
-    /**
-     * Returns an attachment for a sign-in card.
-     *
-     * @param title The title for the card's sign-in button.
-     * @param url The URL of the sign-in page to use.
-     * @param text Optional. Additional text to include on the card.
-     *
-     * @returns A bot message activity attached with a sign-in card.
-     *
-     * @remarks
-     * For channels that don't natively support sign-in cards, an alternative message is rendered.
-     *
-     * @beta
-     */
-    static attachSigninCard(title: string, url: string, text?: string): Partial<Activity_2>;
-    /**
-     * Build a bot message activity attached with an Office 365 connector card.
-     *
-     * @param card A description of the Office 365 connector card.
-     * @returns A bot message activity attached with an Office 365 connector card.
-     *
-     * @beta
-     */
-    static attachO365ConnectorCard(card: O365ConnectorCard): Partial<Activity_2>;
-    /**
-     * Build a message activity attached with a receipt card.
-     * @param card A description of the receipt card.
-     * @returns A message activity attached with a receipt card.
-     *
-     * @beta
-     */
-    static AttachReceiptCard(card: ReceiptCard): Partial<Activity_2>;
-    /**
-     *
-     * @param title The card title.
-     * @param images Optional. The array of images to include on the card.
-     * @param buttons Optional. The array of buttons to include on the card. Each `string` in the array
-     *      is converted to an `imBack` button with a title and value set to the value of the string.
-     * @param other Optional. Any additional properties to include on the card.
-     * @returns A message activity attached with a thumbnail card
-     *
-     * @beta
-     */
-    static attachThumbnailCard(title: string, images?: (CardImage | string)[], buttons?: (CardAction | string)[], other?: Partial<ThumbnailCard>): Partial<Activity_2>;
-    /**
-     * Add an attachement to a bot activity.
-     * @param attachement The attachment object to attach.
-     * @returns A message activity with an attachment.
-     *
-     * @beta
-     */
-    static attachContent(attachement: Attachment): Partial<Activity_2>;
-}
+ /**
+  * Interface for customized logger.
+  * @beta
+  */
+ export declare interface Logger {
+     /**
+      * Writes to error level logging or lower.
+      */
+     error(message: string): void;
+     /**
+      * Writes to warning level logging or lower.
+      */
+     warn(message: string): void;
+     /**
+      * Writes to info level logging or lower.
+      */
+     info(message: string): void;
+     /**
+      * Writes to verbose level logging.
+      */
+     verbose(message: string): void;
+ }
 
-/**
- * Microsoft Graph auth provider for Teams Framework
- *
- * @beta
- */
-export declare class MsGraphAuthProvider implements AuthenticationProvider {
-    private teamsfx;
-    private scopes;
-    /**
-     * Constructor of MsGraphAuthProvider.
-     *
-     * @param {TeamsFx} teamsfx - Used to provide configuration and auth.
-     * @param {string | string[]} scopes - The list of scopes for which the token will have access.
-     *
-     * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
-     *
-     * @returns An instance of MsGraphAuthProvider.
-     *
-     * @beta
-     */
-    constructor(teamsfx: TeamsFxConfiguration, scopes?: string | string[]);
-    /**
-     * Get access token for Microsoft Graph API requests.
-     *
-     * @throws {@link ErrorCode|InternalError} when get access token failed due to empty token or unknown other problems.
-     * @throws {@link ErrorCode|TokenExpiredError} when SSO token has already expired.
-     * @throws {@link ErrorCode|UiRequiredError} when need user consent to get access token.
-     * @throws {@link ErrorCode|ServiceError} when failed to get access token from simple auth or AAD server.
-     * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
-     *
-     * @returns Access token from the credential.
-     *
-     */
-    getAccessToken(): Promise<string>;
-}
+ /**
+  * Log level.
+  *
+  * @beta
+  */
+ export declare enum LogLevel {
+     /**
+      * Show verbose, information, warning and error message.
+      */
+     Verbose = 0,
+     /**
+      * Show information, warning and error message.
+      */
+     Info = 1,
+     /**
+      * Show warning and error message.
+      */
+     Warn = 2,
+     /**
+      * Show error message.
+      */
+     Error = 3
+ }
 
-/**
- * Provide utilities to send notification to varies targets (e.g., member, channel, incoming wehbook).
- *
- * @beta
- */
-export declare class NotificationBot {
-    private readonly conversationReferenceStore;
-    private readonly adapter;
-    /**
-     * constructor of the notification bot.
-     *
-     * @remarks
-     * To ensure accuracy, it's recommended to initialize before handling any message.
-     *
-     * @param adapter - the bound `BotFrameworkAdapter`
-     * @param options - initialize options
-     *
-     * @beta
-     */
-    constructor(adapter: BotFrameworkAdapter, options?: NotificationOptions_2);
-    /**
-     * Get all targets where the bot is installed.
-     *
-     * @remarks
-     * The result is retrieving from the persisted storage.
-     *
-     * @returns - an array of {@link TeamsBotInstallation}.
-     *
-     * @beta
-     */
-    installations(): Promise<TeamsBotInstallation[]>;
-}
+ /**
+  * A {@link NotificationTarget} that represents a team member.
+  *
+  * @remarks
+  * It's recommended to get members from {@link TeamsBotInstallation.members()}.
+  *
+  * @beta
+  */
+ export declare class Member implements NotificationTarget {
+     /**
+      * The parent {@link TeamsBotInstallation} where this member is created from.
+      *
+      * @beta
+      */
+     readonly parent: TeamsBotInstallation;
+     /**
+      * Detailed member account information.
+      *
+      * @beta
+      */
+     readonly account: TeamsChannelAccount;
+     /**
+      * Notification target type. For member it's always "Person".
+      *
+      * @beta
+      */
+     readonly type: NotificationTargetType;
+     /**
+      * Constuctor.
+      *
+      * @remarks
+      * It's recommended to get members from {@link TeamsBotInstallation.members()}, instead of using this constructor.
+      *
+      * @param parent - The parent {@link TeamsBotInstallation} where this member is created from.
+      * @param account - Detailed member account information.
+      *
+      * @beta
+      */
+     constructor(parent: TeamsBotInstallation, account: TeamsChannelAccount);
+     /**
+      * Send a plain text message.
+      *
+      * @param text - the plain text message.
+      * @returns A `Promise` representing the asynchronous operation.
+      *
+      * @beta
+      */
+     sendMessage(text: string): Promise<void>;
+     /**
+      * Send an adaptive card message.
+      *
+      * @param card - the adaptive card raw JSON.
+      * @returns A `Promise` representing the asynchronous operation.
+      *
+      * @beta
+      */
+     sendAdaptiveCard(card: unknown): Promise<void>;
+     /**
+      * @internal
+      */
+     private newConversation;
+ }
 
-/**
- * Options to initialize {@link NotificationBot}.
- *
- * @beta
- */
-declare interface NotificationOptions_2 {
-    /**
-     * An optional storage to persist bot notification connections.
-     *
-     * @remarks
-     * If `storage` is not provided, a default local file storage will be used,
-     * which stores notification connections into:
-     *   - ".notification.localstore.json" if running locally
-     *   - "${process.env.TEMP}/.notification.localstore.json" if `process.env.RUNNING_ON_AZURE` is set to "1"
-     *
-     * It's recommended to use your own shared storage for production environment.
-     *
-     * @beta
-     */
-    storage?: NotificationTargetStorage;
-}
-export { NotificationOptions_2 as NotificationOptions }
+ /**
+  * Provides utility method to build bot message with cards that supported in Teams.
+  */
+ export declare class MessageBuilder {
+     /**
+      * Build a bot message activity attached with adaptive card.
+      *
+      * @param cardTemplate The adaptive card template.
+      * @param data card data used to render the template.
+      * @returns A bot message activity attached with an adaptive card.
+      *
+      * @example
+      * ```javascript
+      * const cardTemplate = {
+      *   type: "AdaptiveCard",
+      *   body: [
+      *     {
+      *       "type": "TextBlock",
+      *       "text": "${title}",
+      *       "size": "Large"
+      *     },
+      *     {
+      *       "type": "TextBlock",
+      *       "text": "${description}"
+      *     }],
+      *     $schema: "http://adaptivecards.io/schemas/adaptive-card.json",
+      *     version: "1.4"
+      *  };
+      *
+      * type CardData = {
+      *   title: string,
+      *   description: string
+      * };
+      * const card = MessageBuilder.attachAdaptiveCard<CardData>(
+      *   cardTemplate, {
+      *   title: "sample card title",
+      *   description: "sample card description"
+      * });
+      * ```
+      *
+      * @beta
+      */
+     static attachAdaptiveCard<TData>(cardTemplate: any, data: TData): Partial<Activity_2>;
+     /**
+      * Build a bot message activity attached with an adaptive card.
+      *
+      * @param card The adaptive card content.
+      * @returns A bot message activity attached with an adaptive card.
+      *
+      * @beta
+      */
+     static attachAdaptiveCardWithoutData(card: any): Partial<Activity_2>;
+     /**
+      * Build a bot message activity attached with an hero card.
+      *
+      * @param title The card title.
+      * @param images Optional. The array of images to include on the card.
+      * @param buttons Optional. The array of buttons to include on the card. Each `string` in the array
+      *      is converted to an `imBack` button with a title and value set to the value of the string.
+      * @param other Optional. Any additional properties to include on the card.
+      *
+      * @returns A bot message activity attached with a hero card.
+      *
+      * @example
+      * ```javascript
+      * const message = MessageBuilder.attachHeroCard(
+      *      'sample title',
+      *      ['https://example.com/sample.jpg'],
+      *      ['action']
+      * );
+      * ```
+      *
+      * @beta
+      */
+     static attachHeroCard(title: string, images?: (CardImage | string)[], buttons?: (CardAction | string)[], other?: Partial<HeroCard>): Partial<Activity_2>;
+     /**
+      * Returns an attachment for a sign-in card.
+      *
+      * @param title The title for the card's sign-in button.
+      * @param url The URL of the sign-in page to use.
+      * @param text Optional. Additional text to include on the card.
+      *
+      * @returns A bot message activity attached with a sign-in card.
+      *
+      * @remarks
+      * For channels that don't natively support sign-in cards, an alternative message is rendered.
+      *
+      * @beta
+      */
+     static attachSigninCard(title: string, url: string, text?: string): Partial<Activity_2>;
+     /**
+      * Build a bot message activity attached with an Office 365 connector card.
+      *
+      * @param card A description of the Office 365 connector card.
+      * @returns A bot message activity attached with an Office 365 connector card.
+      *
+      * @beta
+      */
+     static attachO365ConnectorCard(card: O365ConnectorCard): Partial<Activity_2>;
+     /**
+      * Build a message activity attached with a receipt card.
+      * @param card A description of the receipt card.
+      * @returns A message activity attached with a receipt card.
+      *
+      * @beta
+      */
+     static AttachReceiptCard(card: ReceiptCard): Partial<Activity_2>;
+     /**
+      *
+      * @param title The card title.
+      * @param images Optional. The array of images to include on the card.
+      * @param buttons Optional. The array of buttons to include on the card. Each `string` in the array
+      *      is converted to an `imBack` button with a title and value set to the value of the string.
+      * @param other Optional. Any additional properties to include on the card.
+      * @returns A message activity attached with a thumbnail card
+      *
+      * @beta
+      */
+     static attachThumbnailCard(title: string, images?: (CardImage | string)[], buttons?: (CardAction | string)[], other?: Partial<ThumbnailCard>): Partial<Activity_2>;
+     /**
+      * Add an attachement to a bot activity.
+      * @param attachement The attachment object to attach.
+      * @returns A message activity with an attachment.
+      *
+      * @beta
+      */
+     static attachContent(attachement: Attachment): Partial<Activity_2>;
+ }
 
-/**
- * Represent a notification target.
- *
- * @beta
- */
-export declare interface NotificationTarget {
-    /**
-     * The type of target, could be "Channel" or "Group" or "Person".
-     *
-     * @beta
-     */
-    readonly type?: NotificationTargetType;
-    /**
-     * Send a plain text message.
-     *
-     * @param text - the plain text message.
-     *
-     * @beta
-     */
-    sendMessage(text: string): Promise<void>;
-    /**
-     * Send an adaptive card message.
-     *
-     * @param card - the adaptive card raw JSON.
-     *
-     * @beta
-     */
-    sendAdaptiveCard(card: unknown): Promise<void>;
-}
+ /**
+  * Microsoft Graph auth provider for Teams Framework
+  *
+  * @beta
+  */
+ export declare class MsGraphAuthProvider implements AuthenticationProvider {
+     private teamsfx;
+     private scopes;
+     /**
+      * Constructor of MsGraphAuthProvider.
+      *
+      * @param {TeamsFx} teamsfx - Used to provide configuration and auth.
+      * @param {string | string[]} scopes - The list of scopes for which the token will have access.
+      *
+      * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
+      *
+      * @returns An instance of MsGraphAuthProvider.
+      *
+      * @beta
+      */
+     constructor(teamsfx: TeamsFxConfiguration, scopes?: string | string[]);
+     /**
+      * Get access token for Microsoft Graph API requests.
+      *
+      * @throws {@link ErrorCode|InternalError} when get access token failed due to empty token or unknown other problems.
+      * @throws {@link ErrorCode|TokenExpiredError} when SSO token has already expired.
+      * @throws {@link ErrorCode|UiRequiredError} when need user consent to get access token.
+      * @throws {@link ErrorCode|ServiceError} when failed to get access token from simple auth or AAD server.
+      * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
+      *
+      * @returns Access token from the credential.
+      *
+      */
+     getAccessToken(): Promise<string>;
+ }
 
-/**
- * Interface for a storage provider that stores and retrieves notification target references.
- *
- * @beta
- */
-export declare interface NotificationTargetStorage {
-    /**
-     * Read one notification target by its key.
-     *
-     * @param key - the key of a notification target.
-     *
-     * @returns - the notification target. Or undefined if not found.
-     *
-     * @beta
-     */
-    read(key: string): Promise<{
-        [key: string]: unknown;
-    } | undefined>;
-    /**
-     * List all stored notification targets.
-     *
-     * @returns - an array of notification target. Or an empty array if nothing is stored.
-     *
-     * @beta
-     */
-    list(): Promise<{
-        [key: string]: unknown;
-    }[]>;
-    /**
-     * Write one notification target by its key.
-     *
-     * @param key - the key of a notification target.
-     * @param object - the notification target.
-     *
-     * @beta
-     */
-    write(key: string, object: {
-        [key: string]: unknown;
-    }): Promise<void>;
-    /**
-     * Delete one notificaton target by its key.
-     *
-     * @param key - the key of a notification target.
-     *
-     * @beta
-     */
-    delete(key: string): Promise<void>;
-}
+ /**
+  * Provide utilities to send notification to varies targets (e.g., member, group, channel).
+  *
+  * @beta
+  */
+ export declare class NotificationBot {
+     private readonly conversationReferenceStore;
+     private readonly adapter;
+     /**
+      * constructor of the notification bot.
+      *
+      * @remarks
+      * To ensure accuracy, it's recommended to initialize before handling any message.
+      *
+      * @param adapter - the bound `BotFrameworkAdapter`
+      * @param options - initialize options
+      *
+      * @beta
+      */
+     constructor(adapter: BotFrameworkAdapter, options?: NotificationOptions_2);
+     /**
+      * Get all targets where the bot is installed.
+      *
+      * @remarks
+      * The result is retrieving from the persisted storage.
+      *
+      * @returns - an array of {@link TeamsBotInstallation}.
+      *
+      * @beta
+      */
+     installations(): Promise<TeamsBotInstallation[]>;
+ }
 
-/**
- * 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.
- *
- * @beta
- */
-export declare type NotificationTargetType = "Channel" | "Group" | "Person";
+ /**
+  * Options to initialize {@link NotificationBot}.
+  *
+  * @beta
+  */
+ declare interface NotificationOptions_2 {
+     /**
+      * An optional storage to persist bot notification connections.
+      *
+      * @remarks
+      * If `storage` is not provided, a default local file storage will be used,
+      * which stores notification connections into:
+      *   - ".notification.localstore.json" if running locally
+      *   - "${process.env.TEMP}/.notification.localstore.json" if `process.env.RUNNING_ON_AZURE` is set to "1"
+      *
+      * It's recommended to use your own shared storage for production environment.
+      *
+      * @beta
+      */
+     storage?: NotificationTargetStorage;
+ }
+ export { NotificationOptions_2 as NotificationOptions }
 
-/**
- * Represent on-behalf-of flow to get user identity, and it is designed to be used in server side.
- *
- * @example
- * ```typescript
- * const credential = new OnBehalfOfUserCredential(ssoToken);
- * ```
- *
- * @remarks
- * Can only be used in server side.
- *
- * @beta
- */
-export declare class OnBehalfOfUserCredential implements TokenCredential {
-    private msalClient;
-    private ssoToken;
-    /**
-     * Constructor of OnBehalfOfUserCredential
-     *
-     * @remarks
-     * Only works in in server side.
-     *
-     * @param {string} ssoToken - User token provided by Teams SSO feature.
-     * @param {AuthenticationConfiguration} config - The authentication configuration. Use environment variables if not provided.
-     *
-     * @throws {@link ErrorCode|InvalidConfiguration} when client id, client secret, certificate content, authority host or tenant id is not found in config.
-     * @throws {@link ErrorCode|InternalError} when SSO token is not valid.
-     * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
-     */
-    constructor(ssoToken: string, config: AuthenticationConfiguration);
-    /**
-     * Get access token from credential.
-     *
-     * @example
-     * ```typescript
-     * await credential.getToken([]) // Get SSO token using empty string array
-     * await credential.getToken("") // Get SSO token using empty string
-     * await credential.getToken([".default"]) // Get Graph access token with default scope using string array
-     * await credential.getToken(".default") // Get Graph access token with default scope using string
-     * await credential.getToken(["User.Read"]) // Get Graph access token for single scope using string array
-     * await credential.getToken("User.Read") // Get Graph access token for single scope using string
-     * await credential.getToken(["User.Read", "Application.Read.All"]) // Get Graph access token for multiple scopes using string array
-     * 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
-     * ```
-     *
-     * @param {string | string[]} scopes - The list of scopes for which the token will have access.
-     * @param {GetTokenOptions} options - The options used to configure any requests this TokenCredential implementation might make.
-     *
-     * @throws {@link ErrorCode|InternalError} when failed to acquire access token on behalf of user with unknown error.
-     * @throws {@link ErrorCode|TokenExpiredError} when SSO token has already expired.
-     * @throws {@link ErrorCode|UiRequiredError} when need user consent to get access token.
-     * @throws {@link ErrorCode|ServiceError} when failed to get access token from simple auth server.
-     * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
-     * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @returns Access token with expected scopes.
-     *
-     * @remarks
-     * If scopes is empty string or array, it returns SSO token.
-     * If scopes is non-empty, it returns access token for target scope.
-     *
-     * @beta
-     */
-    getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken | null>;
-    /**
-     * Get basic user info from SSO token.
-     *
-     * @example
-     * ```typescript
-     * const currentUser = getUserInfo();
-     * ```
-     *
-     * @throws {@link ErrorCode|InternalError} when SSO token is not valid.
-     * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @returns Basic user info with user displayName, objectId and preferredUserName.
-     *
-     * @beta
-     */
-    getUserInfo(): UserInfo;
-    private generateAuthServerError;
-}
+ /**
+  * Represent a notification target.
+  *
+  * @beta
+  */
+ export declare interface NotificationTarget {
+     /**
+      * The type of target, could be "Channel" or "Group" or "Person".
+      *
+      * @beta
+      */
+     readonly type?: NotificationTargetType;
+     /**
+      * Send a plain text message.
+      *
+      * @param text - the plain text message.
+      *
+      * @beta
+      */
+     sendMessage(text: string): Promise<void>;
+     /**
+      * Send an adaptive card message.
+      *
+      * @param card - the adaptive card raw JSON.
+      *
+      * @beta
+      */
+     sendAdaptiveCard(card: unknown): Promise<void>;
+ }
 
-/**
- * Send an adaptive card message to a notification target.
- *
- * @param target - the notification target.
- * @param card - the adaptive card raw JSON.
- * @returns A `Promise` representing the asynchronous operation.
- *
- * @beta
- */
-export declare function sendAdaptiveCard(target: NotificationTarget, card: unknown): Promise<void>;
+ /**
+  * Interface for a storage provider that stores and retrieves notification target references.
+  *
+  * @beta
+  */
+ export declare interface NotificationTargetStorage {
+     /**
+      * Read one notification target by its key.
+      *
+      * @param key - the key of a notification target.
+      *
+      * @returns - the notification target. Or undefined if not found.
+      *
+      * @beta
+      */
+     read(key: string): Promise<{
+         [key: string]: unknown;
+     } | undefined>;
+     /**
+      * List all stored notification targets.
+      *
+      * @returns - an array of notification target. Or an empty array if nothing is stored.
+      *
+      * @beta
+      */
+     list(): Promise<{
+         [key: string]: unknown;
+     }[]>;
+     /**
+      * Write one notification target by its key.
+      *
+      * @param key - the key of a notification target.
+      * @param object - the notification target.
+      *
+      * @beta
+      */
+     write(key: string, object: {
+         [key: string]: unknown;
+     }): Promise<void>;
+     /**
+      * Delete one notificaton target by its key.
+      *
+      * @param key - the key of a notification target.
+      *
+      * @beta
+      */
+     delete(key: string): Promise<void>;
+ }
 
-/**
- * Send a plain text message to a notification target.
- *
- * @param target - the notification target.
- * @param text - the plain text message.
- * @returns A `Promise` representing the asynchronous operation.
- *
- * @beta
- */
-export declare function sendMessage(target: NotificationTarget, text: string): Promise<void>;
+ /**
+  * 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.
+  *
+  * @beta
+  */
+ export declare type NotificationTargetType = "Channel" | "Group" | "Person";
 
-/**
- * Set custom log function. Use the function if it's set. Priority is lower than setLogger.
- *
- * @param {LogFunction} logFunction - custom log function. If it's undefined, custom log function will be cleared.
- *
- * @example
- * ```typescript
- * setLogFunction((level: LogLevel, message: string) => {
- *   if (level === LogLevel.Error) {
- *     console.log(message);
- *   }
- * });
- * ```
- *
- * @beta
- */
-export declare function setLogFunction(logFunction?: LogFunction): void;
+ /**
+  * Represent on-behalf-of flow to get user identity, and it is designed to be used in server side.
+  *
+  * @example
+  * ```typescript
+  * const credential = new OnBehalfOfUserCredential(ssoToken);
+  * ```
+  *
+  * @remarks
+  * Can only be used in server side.
+  *
+  * @beta
+  */
+ export declare class OnBehalfOfUserCredential implements TokenCredential {
+     private msalClient;
+     private ssoToken;
+     /**
+      * Constructor of OnBehalfOfUserCredential
+      *
+      * @remarks
+      * Only works in in server side.
+      *
+      * @param {string} ssoToken - User token provided by Teams SSO feature.
+      * @param {AuthenticationConfiguration} config - The authentication configuration. Use environment variables if not provided.
+      *
+      * @throws {@link ErrorCode|InvalidConfiguration} when client id, client secret, certificate content, authority host or tenant id is not found in config.
+      * @throws {@link ErrorCode|InternalError} when SSO token is not valid.
+      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
+      *
+      * @beta
+      */
+     constructor(ssoToken: string, config: AuthenticationConfiguration);
+     /**
+      * Get access token from credential.
+      *
+      * @example
+      * ```typescript
+      * await credential.getToken([]) // Get SSO token using empty string array
+      * await credential.getToken("") // Get SSO token using empty string
+      * await credential.getToken([".default"]) // Get Graph access token with default scope using string array
+      * await credential.getToken(".default") // Get Graph access token with default scope using string
+      * await credential.getToken(["User.Read"]) // Get Graph access token for single scope using string array
+      * await credential.getToken("User.Read") // Get Graph access token for single scope using string
+      * await credential.getToken(["User.Read", "Application.Read.All"]) // Get Graph access token for multiple scopes using string array
+      * 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
+      * ```
+      *
+      * @param {string | string[]} scopes - The list of scopes for which the token will have access.
+      * @param {GetTokenOptions} options - The options used to configure any requests this TokenCredential implementation might make.
+      *
+      * @throws {@link ErrorCode|InternalError} when failed to acquire access token on behalf of user with unknown error.
+      * @throws {@link ErrorCode|TokenExpiredError} when SSO token has already expired.
+      * @throws {@link ErrorCode|UiRequiredError} when need user consent to get access token.
+      * @throws {@link ErrorCode|ServiceError} when failed to get access token from simple auth server.
+      * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
+      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
+      *
+      * @returns Access token with expected scopes.
+      *
+      * @remarks
+      * If scopes is empty string or array, it returns SSO token.
+      * If scopes is non-empty, it returns access token for target scope.
+      *
+      * @beta
+      */
+     getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken | null>;
+     /**
+      * Get basic user info from SSO token.
+      *
+      * @example
+      * ```typescript
+      * const currentUser = getUserInfo();
+      * ```
+      *
+      * @throws {@link ErrorCode|InternalError} when SSO token is not valid.
+      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
+      *
+      * @returns Basic user info with user displayName, objectId and preferredUserName.
+      *
+      * @beta
+      */
+     getUserInfo(): UserInfo;
+     private generateAuthServerError;
+ }
 
-/**
- * Set custom logger. Use the output functions if it's set. Priority is higher than setLogFunction.
- *
- * @param {Logger} logger - custom logger. If it's undefined, custom logger will be cleared.
- *
- * @example
- * ```typescript
- * setLogger({
- *   verbose: console.debug,
- *   info: console.info,
- *   warn: console.warn,
- *   error: console.error,
- * });
- * ```
- *
- * @beta
- */
-export declare function setLogger(logger?: Logger): void;
+ /**
+  * Send an adaptive card message to a notification target.
+  *
+  * @param target - the notification target.
+  * @param card - the adaptive card raw JSON.
+  * @returns A `Promise` representing the asynchronous operation.
+  *
+  * @beta
+  */
+ export declare function sendAdaptiveCard(target: NotificationTarget, card: unknown): Promise<void>;
 
-/**
- * Update log level helper.
- *
- * @param { LogLevel } level - log level in configuration
- *
- * @beta
- */
-export declare function setLogLevel(level: LogLevel): void;
+ /**
+  * Send a plain text message to a notification target.
+  *
+  * @param target - the notification target.
+  * @param text - the plain text message.
+  * @returns A `Promise` representing the asynchronous operation.
+  *
+  * @beta
+  */
+ export declare function sendMessage(target: NotificationTarget, text: string): Promise<void>;
 
-/**
- * A {@link NotificationTarget} that represents a bot installation. Teams Bot could be installed into
- * - Personal chat
- * - Group chat
- * - Team (by default the `General` channel)
- *
- * @remarks
- * It's recommended to get bot installations from {@link ConversationBot.installations()}.
- *
- * @beta
- */
-export declare class TeamsBotInstallation implements NotificationTarget {
-    /**
-     * The bound `BotFrameworkAdapter`.
-     *
-     * @beta
-     */
-    readonly adapter: BotFrameworkAdapter;
-    /**
-     * The bound `ConversationReference`.
-     *
-     * @beta
-     */
-    readonly conversationReference: Partial<ConversationReference>;
-    /**
-     * Notification target type.
-     *
-     * @remarks
-     * - "Channel" means bot is installed into a team and notification will be sent to its "General" channel.
-     * - "Group" means bot is installed into a group chat.
-     * - "Person" means bot is installed into a personal scope and notification will be sent to personal chat.
-     *
-     * @beta
-     */
-    readonly type?: NotificationTargetType;
-    /**
-     * Constructor
-     *
-     * @remarks
-     * It's recommended to get bot installations from {@link ConversationBot.installations()}, instead of using this constructor.
-     *
-     * @param adapter - the bound `BotFrameworkAdapter`.
-     * @param conversationReference - the bound `ConversationReference`.
-     *
-     * @beta
-     */
-    constructor(adapter: BotFrameworkAdapter, conversationReference: Partial<ConversationReference>);
-    /**
-     * Send a plain text message.
-     *
-     * @param text - the plain text message.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
-     */
-    sendMessage(text: string): Promise<void>;
-    /**
-     * Send an adaptive card message.
-     *
-     * @param card - the adaptive card raw JSON.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
-     */
-    sendAdaptiveCard(card: unknown): Promise<void>;
-    /**
-     * Get channels from this bot installation.
-     *
-     * @returns an array of channels if bot is installed into a team, otherwise returns an empty array.
-     *
-     * @beta
-     */
-    channels(): Promise<Channel[]>;
-    /**
-     * Get members from this bot installation.
-     *
-     * @returns an array of members from where the bot is installed.
-     *
-     * @beta
-     */
-    members(): Promise<Member[]>;
-}
+ /**
+  * Set custom log function. Use the function if it's set. Priority is lower than setLogger.
+  *
+  * @param {LogFunction} logFunction - custom log function. If it's undefined, custom log function will be cleared.
+  *
+  * @example
+  * ```typescript
+  * setLogFunction((level: LogLevel, message: string) => {
+  *   if (level === LogLevel.Error) {
+  *     console.log(message);
+  *   }
+  * });
+  * ```
+  *
+  * @beta
+  */
+ export declare function setLogFunction(logFunction?: LogFunction): void;
 
-/**
- * Creates a new prompt that leverage Teams Single Sign On (SSO) support for bot to automatically sign in user and
- * help receive oauth token, asks the user to consent if needed.
- *
- * @remarks
- * The prompt will attempt to retrieve the users current token of the desired scopes and store it in
- * the token store.
- *
- * User will be automatically signed in leveraging Teams support of Bot Single Sign On(SSO):
- * https://docs.microsoft.com/en-us/microsoftteams/platform/bots/how-to/authentication/auth-aad-sso-bots
- *
- * @example
- * When used with your bots `DialogSet` you can simply add a new instance of the prompt as a named
- * dialog using `DialogSet.add()`. You can then start the prompt from a waterfall step using either
- * `DialogContext.beginDialog()` or `DialogContext.prompt()`. The user will be prompted to sign in as
- * needed and their access token will be passed as an argument to the callers next waterfall step:
- *
- * ```JavaScript
- * const { ConversationState, MemoryStorage } = require('botbuilder');
- * const { DialogSet, WaterfallDialog } = require('botbuilder-dialogs');
- * const { TeamsBotSsoPrompt } = require('@microsoft/teamsfx');
- *
- * const convoState = new ConversationState(new MemoryStorage());
- * const dialogState = convoState.createProperty('dialogState');
- * const dialogs = new DialogSet(dialogState);
- *
- * dialogs.add(new TeamsBotSsoPrompt('TeamsBotSsoPrompt', {
- *    scopes: ["User.Read"],
- * }));
- *
- * dialogs.add(new WaterfallDialog('taskNeedingLogin', [
- *      async (step) => {
- *          return await step.beginDialog('TeamsBotSsoPrompt');
- *      },
- *      async (step) => {
- *          const token = step.result;
- *          if (token) {
- *
- *              // ... continue with task needing access token ...
- *
- *          } else {
- *              await step.context.sendActivity(`Sorry... We couldn't log you in. Try again later.`);
- *              return await step.endDialog();
- *          }
- *      }
- * ]));
- * ```
- *
- * @beta
- */
-export declare class TeamsBotSsoPrompt extends Dialog {
-    private teamsfx;
-    private settings;
-    /**
-     * Constructor of TeamsBotSsoPrompt.
-     *
-     * @param {TeamsFx} teamsfx - Used to provide configuration and auth
-     * @param dialogId Unique ID of the dialog within its parent `DialogSet` or `ComponentDialog`.
-     * @param settings Settings used to configure the prompt.
-     *
-     * @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: TeamsFx, dialogId: string, settings: TeamsBotSsoPromptSettings);
-    /**
-     * Called when a prompt dialog is pushed onto the dialog stack and is being activated.
-     * @remarks
-     * If the task is successful, the result indicates whether the prompt is still
-     * active after the turn has been processed by the prompt.
-     *
-     * @param dc The DialogContext for the current turn of the conversation.
-     *
-     * @throws {@link ErrorCode|InvalidParameter} when timeout property in teams bot sso prompt settings is not number or is not positive.
-     * @throws {@link ErrorCode|ChannelNotSupported} when bot channel is not MS Teams.
-     * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
-     */
-    beginDialog(dc: DialogContext): Promise<DialogTurnResult>;
-    /**
-     * Called when a prompt dialog is the active dialog and the user replied with a new activity.
-     *
-     * @remarks
-     * If the task is successful, the result indicates whether the dialog is still
-     * active after the turn has been processed by the dialog.
-     * The prompt generally continues to receive the user's replies until it accepts the
-     * user's reply as valid input for the prompt.
-     *
-     * @param dc The DialogContext for the current turn of the conversation.
-     *
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @throws {@link ErrorCode|ChannelNotSupported} when bot channel is not MS Teams.
-     * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
-     */
-    continueDialog(dc: DialogContext): Promise<DialogTurnResult>;
-    private loadAndValidateConfig;
-    /**
-     * Ensure bot is running in MS Teams since TeamsBotSsoPrompt is only supported in MS Teams channel.
-     * @param dc dialog context
-     * @throws {@link ErrorCode|ChannelNotSupported} if bot channel is not MS Teams
-     * @internal
-     */
-    private ensureMsTeamsChannel;
-    /**
-     * Send OAuthCard that tells Teams to obtain an authentication token for the bot application.
-     * For details see https://docs.microsoft.com/en-us/microsoftteams/platform/bots/how-to/authentication/auth-aad-sso-bots.
-     *
-     * @internal
-     */
-    private sendOAuthCardAsync;
-    /**
-     * Get sign in resource.
-     *
-     * @throws {@link ErrorCode|InvalidConfiguration} if client id, tenant id or initiate login endpoint is not found in config.
-     *
-     * @internal
-     */
-    private getSignInResource;
-    /**
-     * @internal
-     */
-    private recognizeToken;
-    /**
-     * @internal
-     */
-    private getTokenExchangeInvokeResponse;
-    /**
-     * @internal
-     */
-    private isTeamsVerificationInvoke;
-    /**
-     * @internal
-     */
-    private isTokenExchangeRequestInvoke;
-    /**
-     * @internal
-     */
-    private isTokenExchangeRequest;
-}
+ /**
+  * Set custom logger. Use the output functions if it's set. Priority is higher than setLogFunction.
+  *
+  * @param {Logger} logger - custom logger. If it's undefined, custom logger will be cleared.
+  *
+  * @example
+  * ```typescript
+  * setLogger({
+  *   verbose: console.debug,
+  *   info: console.info,
+  *   warn: console.warn,
+  *   error: console.error,
+  * });
+  * ```
+  *
+  * @beta
+  */
+ export declare function setLogger(logger?: Logger): void;
 
-/**
- * Settings used to configure an TeamsBotSsoPrompt instance.
- *
- * @beta
- */
-export declare interface TeamsBotSsoPromptSettings {
-    /**
-     * The array of strings that declare the desired permissions and the resources requested.
-     */
-    scopes: string[];
-    /**
-     * (Optional) number of milliseconds the prompt will wait for the user to authenticate.
-     * Defaults to a value `900,000` (15 minutes.)
-     */
-    timeout?: number;
-    /**
-     * (Optional) value indicating whether the TeamsBotSsoPrompt should end upon receiving an
-     * invalid message.  Generally the TeamsBotSsoPrompt will end the auth flow when receives user
-     * message not related to the auth flow. Setting the flag to false ignores the user's message instead.
-     * Defaults to value `true`
-     */
-    endOnInvalidMessage?: boolean;
-}
+ /**
+  * Update log level helper.
+  *
+  * @param { LogLevel } level - log level in configuration
+  *
+  * @beta
+  */
+ export declare function setLogLevel(level: LogLevel): void;
 
-/**
- * Token response provided by Teams Bot SSO prompt
- *
- * @beta
- */
-export declare interface TeamsBotSsoPromptTokenResponse extends TokenResponse {
-    /**
-     * SSO token for user
-     */
-    ssoToken: string;
-    /**
-     * Expire time of SSO token
-     */
-    ssoTokenExpiration: string;
-}
+ /**
+  * A {@link NotificationTarget} that represents a bot installation. Teams Bot could be installed into
+  * - Personal chat
+  * - Group chat
+  * - Team (by default the `General` channel)
+  *
+  * @remarks
+  * It's recommended to get bot installations from {@link ConversationBot.installations()}.
+  *
+  * @beta
+  */
+ export declare class TeamsBotInstallation implements NotificationTarget {
+     /**
+      * The bound `BotFrameworkAdapter`.
+      *
+      * @beta
+      */
+     readonly adapter: BotFrameworkAdapter;
+     /**
+      * The bound `ConversationReference`.
+      *
+      * @beta
+      */
+     readonly conversationReference: Partial<ConversationReference>;
+     /**
+      * Notification target type.
+      *
+      * @remarks
+      * - "Channel" means bot is installed into a team and notification will be sent to its "General" channel.
+      * - "Group" means bot is installed into a group chat.
+      * - "Person" means bot is installed into a personal scope and notification will be sent to personal chat.
+      *
+      * @beta
+      */
+     readonly type?: NotificationTargetType;
+     /**
+      * Constructor
+      *
+      * @remarks
+      * It's recommended to get bot installations from {@link ConversationBot.installations()}, instead of using this constructor.
+      *
+      * @param adapter - the bound `BotFrameworkAdapter`.
+      * @param conversationReference - the bound `ConversationReference`.
+      *
+      * @beta
+      */
+     constructor(adapter: BotFrameworkAdapter, conversationReference: Partial<ConversationReference>);
+     /**
+      * Send a plain text message.
+      *
+      * @param text - the plain text message.
+      * @returns A `Promise` representing the asynchronous operation.
+      *
+      * @beta
+      */
+     sendMessage(text: string): Promise<void>;
+     /**
+      * Send an adaptive card message.
+      *
+      * @param card - the adaptive card raw JSON.
+      * @returns A `Promise` representing the asynchronous operation.
+      *
+      * @beta
+      */
+     sendAdaptiveCard(card: unknown): Promise<void>;
+     /**
+      * Get channels from this bot installation.
+      *
+      * @returns an array of channels if bot is installed into a team, otherwise returns an empty array.
+      *
+      * @beta
+      */
+     channels(): Promise<Channel[]>;
+     /**
+      * Get members from this bot installation.
+      *
+      * @returns an array of members from where the bot is installed.
+      *
+      * @beta
+      */
+     members(): Promise<Member[]>;
+ }
 
-/**
- * A class providing credential and configuration.
- * @beta
- */
-export declare class TeamsFx implements TeamsFxConfiguration {
-    private configuration;
-    private oboUserCredential?;
-    private appCredential?;
-    private identityType;
-    /**
-     * Constructor of TeamsFx
-     *
-     * @param {IdentityType} identityType - Choose user or app identity
-     * @param customConfig - key/value pairs of customized configuration that overrides default ones.
-     *
-     * @throws {@link ErrorCode|IdentityTypeNotSupported} when setting app identity in browser.
-     *
-     * @beta
-     */
-    constructor(identityType?: IdentityType, customConfig?: Record<string, string>);
-    /**
-     * Identity type set by user.
-     *
-     * @returns identity type.
-     * @beta
-     */
-    getIdentityType(): IdentityType;
-    /**
-     * Credential instance according to identity type choice.
-     *
-     * @remarks If user identity is chose, will return {@link TeamsUserCredential}
-     * in browser environment and {@link OnBehalfOfUserCredential} in NodeJS. If app
-     * identity is chose, will return {@link AppCredential}.
-     *
-     * @returns instance implements TokenCredential interface.
-     * @beta
-     */
-    getCredential(): TokenCredential;
-    /**
-     * Get user information.
-     * @returns UserInfo object.
-     * @beta
-     */
-    getUserInfo(): Promise<UserInfo>;
-    /**
-     * Popup login page to get user's access token with specific scopes.
-     *
-     * @remarks
-     * Only works in Teams client APP. User will be redirected to the authorization page to login and consent.
-     *
-     * @example
-     * ```typescript
-     * await teamsfx.login(["https://graph.microsoft.com/User.Read"]); // single scope using string array
-     * await teamsfx.login("https://graph.microsoft.com/User.Read"); // single scopes using string
-     * await teamsfx.login(["https://graph.microsoft.com/User.Read", "Calendars.Read"]); // multiple scopes using string array
-     * await teamsfx.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.
-     *
-     * @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: string | string[]): Promise<void>;
-    /**
-     * Set SSO token when using user identity in NodeJS.
-     * @param {string} ssoToken - used for on behalf of user flow.
-     * @returns self instance.
-     * @beta
-     */
-    setSsoToken(ssoToken: string): TeamsFx;
-    /**
-     * Usually used by service plugins to retrieve specific config
-     * @param {string} key - configuration key.
-     * @returns value in configuration.
-     * @beta
-     */
-    getConfig(key: string): string;
-    /**
-     * Check the value of specific key.
-     * @param {string} key - configuration key.
-     * @returns true if corresponding value is not empty string.
-     * @beta
-     */
-    hasConfig(key: string): boolean;
-    /**
-     * Get all configurations.
-     * @returns key value mappings.
-     * @beta
-     */
-    getConfigs(): Record<string, string>;
-    /**
-     * Load configuration from environment variables.
-     */
-    private loadFromEnv;
-}
+ /**
+  * Creates a new prompt that leverage Teams Single Sign On (SSO) support for bot to automatically sign in user and
+  * help receive oauth token, asks the user to consent if needed.
+  *
+  * @remarks
+  * The prompt will attempt to retrieve the users current token of the desired scopes and store it in
+  * the token store.
+  *
+  * User will be automatically signed in leveraging Teams support of Bot Single Sign On(SSO):
+  * https://docs.microsoft.com/en-us/microsoftteams/platform/bots/how-to/authentication/auth-aad-sso-bots
+  *
+  * @example
+  * When used with your bots `DialogSet` you can simply add a new instance of the prompt as a named
+  * dialog using `DialogSet.add()`. You can then start the prompt from a waterfall step using either
+  * `DialogContext.beginDialog()` or `DialogContext.prompt()`. The user will be prompted to sign in as
+  * needed and their access token will be passed as an argument to the callers next waterfall step:
+  *
+  * ```JavaScript
+  * const { ConversationState, MemoryStorage } = require('botbuilder');
+  * const { DialogSet, WaterfallDialog } = require('botbuilder-dialogs');
+  * const { TeamsBotSsoPrompt } = require('@microsoft/teamsfx');
+  *
+  * const convoState = new ConversationState(new MemoryStorage());
+  * const dialogState = convoState.createProperty('dialogState');
+  * const dialogs = new DialogSet(dialogState);
+  *
+  * dialogs.add(new TeamsBotSsoPrompt('TeamsBotSsoPrompt', {
+  *    scopes: ["User.Read"],
+  * }));
+  *
+  * dialogs.add(new WaterfallDialog('taskNeedingLogin', [
+  *      async (step) => {
+  *          return await step.beginDialog('TeamsBotSsoPrompt');
+  *      },
+  *      async (step) => {
+  *          const token = step.result;
+  *          if (token) {
+  *
+  *              // ... continue with task needing access token ...
+  *
+  *          } else {
+  *              await step.context.sendActivity(`Sorry... We couldn't log you in. Try again later.`);
+  *              return await step.endDialog();
+  *          }
+  *      }
+  * ]));
+  * ```
+  *
+  * @beta
+  */
+ export declare class TeamsBotSsoPrompt extends Dialog {
+     private teamsfx;
+     private settings;
+     /**
+      * Constructor of TeamsBotSsoPrompt.
+      *
+      * @param {TeamsFx} teamsfx - Used to provide configuration and auth
+      * @param dialogId Unique ID of the dialog within its parent `DialogSet` or `ComponentDialog`.
+      * @param settings Settings used to configure the prompt.
+      *
+      * @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: TeamsFx, dialogId: string, settings: TeamsBotSsoPromptSettings);
+     /**
+      * Called when a prompt dialog is pushed onto the dialog stack and is being activated.
+      * @remarks
+      * If the task is successful, the result indicates whether the prompt is still
+      * active after the turn has been processed by the prompt.
+      *
+      * @param dc The DialogContext for the current turn of the conversation.
+      *
+      * @throws {@link ErrorCode|InvalidParameter} when timeout property in teams bot sso prompt settings is not number or is not positive.
+      * @throws {@link ErrorCode|ChannelNotSupported} when bot channel is not MS Teams.
+      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
+      *
+      * @returns A `Promise` representing the asynchronous operation.
+      *
+      * @beta
+      */
+     beginDialog(dc: DialogContext): Promise<DialogTurnResult>;
+     /**
+      * Called when a prompt dialog is the active dialog and the user replied with a new activity.
+      *
+      * @remarks
+      * If the task is successful, the result indicates whether the dialog is still
+      * active after the turn has been processed by the dialog.
+      * The prompt generally continues to receive the user's replies until it accepts the
+      * user's reply as valid input for the prompt.
+      *
+      * @param dc The DialogContext for the current turn of the conversation.
+      *
+      * @returns A `Promise` representing the asynchronous operation.
+      *
+      * @throws {@link ErrorCode|ChannelNotSupported} when bot channel is not MS Teams.
+      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
+      *
+      * @beta
+      */
+     continueDialog(dc: DialogContext): Promise<DialogTurnResult>;
+     private loadAndValidateConfig;
+     /**
+      * Ensure bot is running in MS Teams since TeamsBotSsoPrompt is only supported in MS Teams channel.
+      * @param dc dialog context
+      * @throws {@link ErrorCode|ChannelNotSupported} if bot channel is not MS Teams
+      * @internal
+      */
+     private ensureMsTeamsChannel;
+     /**
+      * Send OAuthCard that tells Teams to obtain an authentication token for the bot application.
+      * For details see https://docs.microsoft.com/en-us/microsoftteams/platform/bots/how-to/authentication/auth-aad-sso-bots.
+      *
+      * @internal
+      */
+     private sendOAuthCardAsync;
+     /**
+      * Get sign in resource.
+      *
+      * @throws {@link ErrorCode|InvalidConfiguration} if client id, tenant id or initiate login endpoint is not found in config.
+      *
+      * @internal
+      */
+     private getSignInResource;
+     /**
+      * @internal
+      */
+     private recognizeToken;
+     /**
+      * @internal
+      */
+     private getTokenExchangeInvokeResponse;
+     /**
+      * @internal
+      */
+     private isTeamsVerificationInvoke;
+     /**
+      * @internal
+      */
+     private isTokenExchangeRequestInvoke;
+     /**
+      * @internal
+      */
+     private isTokenExchangeRequest;
+ }
 
-/**
- * Interface for a command handler that can process command to a TeamsFx bot and return a response.
- *
- * @beta
- */
-export declare interface TeamsFxBotCommandHandler {
-    /**
-     * The string or regular expression patterns that can trigger this handler.
-     */
-    triggerPatterns: TriggerPatterns;
-    /**
-     * Handles a bot command received activity.
-     *
-     * @param context The bot context.
-     * @param message The command message the user types from Teams.
-     * @returns A `Promise` representing an activity or text to send as the command response.
-     */
-    handleCommandReceived(context: TurnContext, message: CommandMessage): Promise<string | Partial<Activity>>;
-}
+ /**
+  * Settings used to configure an TeamsBotSsoPrompt instance.
+  *
+  * @beta
+  */
+ export declare interface TeamsBotSsoPromptSettings {
+     /**
+      * The array of strings that declare the desired permissions and the resources requested.
+      */
+     scopes: string[];
+     /**
+      * (Optional) number of milliseconds the prompt will wait for the user to authenticate.
+      * Defaults to a value `900,000` (15 minutes.)
+      */
+     timeout?: number;
+     /**
+      * (Optional) value indicating whether the TeamsBotSsoPrompt should end upon receiving an
+      * invalid message.  Generally the TeamsBotSsoPrompt will end the auth flow when receives user
+      * message not related to the auth flow. Setting the flag to false ignores the user's message instead.
+      * Defaults to value `true`
+      */
+     endOnInvalidMessage?: boolean;
+ }
 
-/**
- * TeamsFx interface that provides credential and configuration.
- * @beta
- */
-declare interface TeamsFxConfiguration {
-    /**
-     * Identity type set by user.
-     *
-     * @returns identity type.
-     * @beta
-     */
-    getIdentityType(): IdentityType;
-    /**
-     * Credential instance according to identity type choice.
-     *
-     * @remarks If user identity is chose, will return {@link TeamsUserCredential}
-     * in browser environment and {@link OnBehalfOfUserCredential} in NodeJS. If app
-     * identity is chose, will return {@link AppCredential}.
-     *
-     * @returns instance implements TokenCredential interface.
-     * @beta
-     */
-    getCredential(): TokenCredential;
-    /**
-     * Get user information.
-     * @returns UserInfo object.
-     * @beta
-     */
-    getUserInfo(): Promise<UserInfo>;
-    /**
-     * Popup login page to get user's access token with specific scopes.
-     *
-     * @remarks
-     * Only works in Teams client APP. User will be redirected to the authorization page to login and consent.
-     *
-     * @example
-     * ```typescript
-     * await teamsfx.login(["https://graph.microsoft.com/User.Read"]); // single scope using string array
-     * await teamsfx.login("https://graph.microsoft.com/User.Read"); // single scopes using string
-     * await teamsfx.login(["https://graph.microsoft.com/User.Read", "Calendars.Read"]); // multiple scopes using string array
-     * await teamsfx.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.
-     *
-     * @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: string | string[]): Promise<void>;
-    /**
-     * Set SSO token when using user identity in NodeJS.
-     * @param {string} ssoToken - used for on behalf of user flow.
-     * @returns self instance.
-     * @beta
-     */
-    setSsoToken(ssoToken: string): TeamsFxConfiguration;
-    /**
-     * Usually used by service plugins to retrieve specific config
-     * @param {string} key - configuration key.
-     * @returns value in configuration.
-     * @beta
-     */
-    getConfig(key: string): string;
-    /**
-     * Check the value of specific key.
-     * @param {string} key - configuration key.
-     * @returns true if corresponding value is not empty string.
-     * @beta
-     */
-    hasConfig(key: string): boolean;
-    /**
-     * Get all configurations.
-     * @returns key value mappings.
-     * @beta
-     */
-    getConfigs(): Record<string, string>;
-}
+ /**
+  * Token response provided by Teams Bot SSO prompt
+  *
+  * @beta
+  */
+ export declare interface TeamsBotSsoPromptTokenResponse extends TokenResponse {
+     /**
+      * SSO token for user
+      */
+     ssoToken: string;
+     /**
+      * Expire time of SSO token
+      */
+     ssoTokenExpiration: string;
+ }
 
-/**
- * Represent Teams current user's identity, and it is used within Teams client applications.
- *
- * @remarks
- * Can only be used within Teams.
- *
- * @beta
- */
-export declare class TeamsUserCredential implements TokenCredential {
-    /**
-     * Constructor of TeamsUserCredential.
-     * @remarks
-     * Can only be used within Teams.
-     * @beta
-     */
-    constructor(authConfig: AuthenticationConfiguration);
-    /**
-     * Popup login page to get user's access token with specific scopes.
-     * @remarks
-     * Can only be used within Teams.
-     * @beta
-     */
-    login(scopes: string | string[]): Promise<void>;
-    /**
-     * Get access token from credential.
-     * @remarks
-     * Can only be used within Teams.
-     * @beta
-     */
-    getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken | null>;
-    /**
-     * Get basic user info from SSO token
-     * @remarks
-     * Can only be used within Teams.
-     * @beta
-     */
-    getUserInfo(): Promise<UserInfo>;
-}
+ /**
+  * A class providing credential and configuration.
+  * @beta
+  */
+ export declare class TeamsFx implements TeamsFxConfiguration {
+     private configuration;
+     private oboUserCredential?;
+     private appCredential?;
+     private identityType;
+     /**
+      * Constructor of TeamsFx
+      *
+      * @param {IdentityType} identityType - Choose user or app identity
+      * @param customConfig - key/value pairs of customized configuration that overrides default ones.
+      *
+      * @throws {@link ErrorCode|IdentityTypeNotSupported} when setting app identity in browser.
+      *
+      * @beta
+      */
+     constructor(identityType?: IdentityType, customConfig?: Record<string, string>);
+     /**
+      * Identity type set by user.
+      *
+      * @returns identity type.
+      * @beta
+      */
+     getIdentityType(): IdentityType;
+     /**
+      * Credential instance according to identity type choice.
+      *
+      * @remarks If user identity is chose, will return {@link TeamsUserCredential}
+      * in browser environment and {@link OnBehalfOfUserCredential} in NodeJS. If app
+      * identity is chose, will return {@link AppCredential}.
+      *
+      * @returns instance implements TokenCredential interface.
+      * @beta
+      */
+     getCredential(): TokenCredential;
+     /**
+      * Get user information.
+      * @returns UserInfo object.
+      * @beta
+      */
+     getUserInfo(): Promise<UserInfo>;
+     /**
+      * Popup login page to get user's access token with specific scopes.
+      *
+      * @remarks
+      * Only works in Teams client APP. User will be redirected to the authorization page to login and consent.
+      *
+      * @example
+      * ```typescript
+      * await teamsfx.login(["https://graph.microsoft.com/User.Read"]); // single scope using string array
+      * await teamsfx.login("https://graph.microsoft.com/User.Read"); // single scopes using string
+      * await teamsfx.login(["https://graph.microsoft.com/User.Read", "Calendars.Read"]); // multiple scopes using string array
+      * await teamsfx.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.
+      *
+      * @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: string | string[]): Promise<void>;
+     /**
+      * Set SSO token when using user identity in NodeJS.
+      * @param {string} ssoToken - used for on behalf of user flow.
+      * @returns self instance.
+      * @beta
+      */
+     setSsoToken(ssoToken: string): TeamsFx;
+     /**
+      * Usually used by service plugins to retrieve specific config
+      * @param {string} key - configuration key.
+      * @returns value in configuration.
+      * @beta
+      */
+     getConfig(key: string): string;
+     /**
+      * Check the value of specific key.
+      * @param {string} key - configuration key.
+      * @returns true if corresponding value is not empty string.
+      * @beta
+      */
+     hasConfig(key: string): boolean;
+     /**
+      * Get all configurations.
+      * @returns key value mappings.
+      * @beta
+      */
+     getConfigs(): Record<string, string>;
+     /**
+      * Load configuration from environment variables.
+      */
+     private loadFromEnv;
+ }
 
-/**
- * The trigger pattern used to trigger a {@link TeamsFxBotCommandHandler} instance.
- */
-export declare type TriggerPatterns = string | RegExp | (string | RegExp)[];
+ /**
+  * Interface for a command handler that can process command to a TeamsFx bot and return a response.
+  *
+  * @beta
+  */
+ export declare interface TeamsFxBotCommandHandler {
+     /**
+      * The string or regular expression patterns that can trigger this handler.
+      */
+     triggerPatterns: TriggerPatterns;
+     /**
+      * Handles a bot command received activity.
+      *
+      * @param context The bot context.
+      * @param message The command message the user types from Teams.
+      * @returns A `Promise` representing an activity or text to send as the command response.
+      */
+     handleCommandReceived(context: TurnContext, message: CommandMessage): Promise<string | Partial<Activity>>;
+ }
 
-/**
- * UserInfo with user displayName, objectId and preferredUserName.
- *
- * @beta
- */
-export declare interface UserInfo {
-    /**
-     * User Display Name.
-     *
-     * @readonly
-     */
-    displayName: string;
-    /**
-     * User unique reference within the Azure Active Directory domain.
-     *
-     * @readonly
-     */
-    objectId: string;
-    /**
-     * Usually be the email address.
-     *
-     * @readonly
-     */
-    preferredUserName: string;
-}
+ /**
+  * TeamsFx interface that provides credential and configuration.
+  * @beta
+  */
+ declare interface TeamsFxConfiguration {
+     /**
+      * Identity type set by user.
+      *
+      * @returns identity type.
+      * @beta
+      */
+     getIdentityType(): IdentityType;
+     /**
+      * Credential instance according to identity type choice.
+      *
+      * @remarks If user identity is chose, will return {@link TeamsUserCredential}
+      * in browser environment and {@link OnBehalfOfUserCredential} in NodeJS. If app
+      * identity is chose, will return {@link AppCredential}.
+      *
+      * @returns instance implements TokenCredential interface.
+      * @beta
+      */
+     getCredential(): TokenCredential;
+     /**
+      * Get user information.
+      * @returns UserInfo object.
+      * @beta
+      */
+     getUserInfo(): Promise<UserInfo>;
+     /**
+      * Popup login page to get user's access token with specific scopes.
+      *
+      * @remarks
+      * Only works in Teams client APP. User will be redirected to the authorization page to login and consent.
+      *
+      * @example
+      * ```typescript
+      * await teamsfx.login(["https://graph.microsoft.com/User.Read"]); // single scope using string array
+      * await teamsfx.login("https://graph.microsoft.com/User.Read"); // single scopes using string
+      * await teamsfx.login(["https://graph.microsoft.com/User.Read", "Calendars.Read"]); // multiple scopes using string array
+      * await teamsfx.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.
+      *
+      * @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: string | string[]): Promise<void>;
+     /**
+      * Set SSO token when using user identity in NodeJS.
+      * @param {string} ssoToken - used for on behalf of user flow.
+      * @returns self instance.
+      * @beta
+      */
+     setSsoToken(ssoToken: string): TeamsFxConfiguration;
+     /**
+      * Usually used by service plugins to retrieve specific config
+      * @param {string} key - configuration key.
+      * @returns value in configuration.
+      * @beta
+      */
+     getConfig(key: string): string;
+     /**
+      * Check the value of specific key.
+      * @param {string} key - configuration key.
+      * @returns true if corresponding value is not empty string.
+      * @beta
+      */
+     hasConfig(key: string): boolean;
+     /**
+      * Get all configurations.
+      * @returns key value mappings.
+      * @beta
+      */
+     getConfigs(): Record<string, string>;
+ }
+
+ /**
+  * Represent Teams current user's identity, and it is used within Teams client applications.
+  *
+  * @remarks
+  * Can only be used within Teams.
+  *
+  * @beta
+  */
+ export declare class TeamsUserCredential implements TokenCredential {
+     /**
+      * Constructor of TeamsUserCredential.
+      * @remarks
+      * Can only be used within Teams.
+      * @beta
+      */
+     constructor(authConfig: AuthenticationConfiguration);
+     /**
+      * Popup login page to get user's access token with specific scopes.
+      * @remarks
+      * Can only be used within Teams.
+      * @beta
+      */
+     login(scopes: string | string[]): Promise<void>;
+     /**
+      * Get access token from credential.
+      * @remarks
+      * Can only be used within Teams.
+      * @beta
+      */
+     getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken | null>;
+     /**
+      * Get basic user info from SSO token
+      * @remarks
+      * Can only be used within Teams.
+      * @beta
+      */
+     getUserInfo(): Promise<UserInfo>;
+ }
+
+ /**
+  * The trigger pattern used to trigger a {@link TeamsFxBotCommandHandler} instance.
+  */
+ export declare type TriggerPatterns = string | RegExp | (string | RegExp)[];
+
+ /**
+  * UserInfo with user displayName, objectId and preferredUserName.
+  *
+  * @beta
+  */
+ export declare interface UserInfo {
+     /**
+      * User Display Name.
+      *
+      * @readonly
+      */
+     displayName: string;
+     /**
+      * User unique reference within the Azure Active Directory domain.
+      *
+      * @readonly
+      */
+     objectId: string;
+     /**
+      * Usually be the email address.
+      *
+      * @readonly
+      */
+     preferredUserName: string;
+ }
 
-export { }
+ export { }