@microsoft/teamsfx 1.1.2-alpha.062e4a5ea.0 → 1.1.2-alpha.11f97f07d.0

package/dist/index.node.cjs.js

@@ -1904,135 +1904,284 @@ exports.NotificationTargetType = void 0;
      * The notification will be sent to a personal chat.
      */
     NotificationTargetType["Person"] = "Person";
-})(exports.NotificationTargetType || (exports.NotificationTargetType = {}));
+})(exports.NotificationTargetType || (exports.NotificationTargetType = {}));
+/**
+ * Options used to control how the response card will be sent to users.
+ */
+exports.AdaptiveCardResponse = void 0;
+(function (AdaptiveCardResponse) {
+    /**
+     * The response card will be replaced the current one for the interactor who trigger the action.
+     */
+    AdaptiveCardResponse[AdaptiveCardResponse["ReplaceForInteractor"] = 0] = "ReplaceForInteractor";
+    /**
+     * The response card will be replaced the current one for all users in the chat.
+     */
+    AdaptiveCardResponse[AdaptiveCardResponse["ReplaceForAll"] = 1] = "ReplaceForAll";
+    /**
+     * The response card will be sent as a new message for all users in the chat.
+     */
+    AdaptiveCardResponse[AdaptiveCardResponse["NewForAll"] = 2] = "NewForAll";
+})(exports.AdaptiveCardResponse || (exports.AdaptiveCardResponse = {}));
+/**
+ * Status code for an `application/vnd.microsoft.error` invoke response.
+ */
+exports.InvokeResponseErrorCode = void 0;
+(function (InvokeResponseErrorCode) {
+    /**
+     * Invalid request.
+     */
+    InvokeResponseErrorCode[InvokeResponseErrorCode["BadRequest"] = 400] = "BadRequest";
+    /**
+     * Internal server error.
+     */
+    InvokeResponseErrorCode[InvokeResponseErrorCode["InternalServerError"] = 500] = "InternalServerError";
+})(exports.InvokeResponseErrorCode || (exports.InvokeResponseErrorCode = {}));
 
-// Copyright (c) Microsoft Corporation.
 /**
+ * Available response type for an adaptive card invoke response.
  * @internal
  */
-function cloneConversation(conversation) {
-    return JSON.parse(JSON.stringify(conversation));
-}
+var InvokeResponseType;
+(function (InvokeResponseType) {
+    InvokeResponseType["AdaptiveCard"] = "application/vnd.microsoft.card.adaptive";
+    InvokeResponseType["Message"] = "application/vnd.microsoft.activity.message";
+    InvokeResponseType["Error"] = "application/vnd.microsoft.error";
+})(InvokeResponseType || (InvokeResponseType = {}));
 /**
- * @internal
+ * Provides methods for formatting various invoke responses a bot can send to respond to an invoke request.
+ *
+ * @remarks
+ * All of these functions return an {@link InvokeResponse} object, which can be
+ * passed as input to generate a new `invokeResponse` activity.
+ *
+ * This example sends an invoke response that contains an adaptive card.
+ *
+ * ```typescript
+ *
+ * const myCard: IAdaptiveCard = {
+ *    type: "AdaptiveCard",
+ *    body: [
+ *     {
+ *       "type": "TextBlock",
+ *       "text": "This is a sample card"
+ *     }],
+ *     $schema: "http://adaptivecards.io/schemas/adaptive-card.json",
+ *     version: "1.4"
+ *  };
+ *
+ * const invokeResponse = InvokeResponseFactory.adaptiveCard(myCard);
+ * await context.sendActivity({
+ *    type: ActivityTypes.InvokeResponse,
+ *    value: invokeResponse,
+ *  });
+ * ```
  */
-function getTargetType(conversationReference) {
-    var _a;
-    const conversationType = (_a = conversationReference.conversation) === null || _a === void 0 ? void 0 : _a.conversationType;
-    if (conversationType === "personal") {
-        return exports.NotificationTargetType.Person;
+class InvokeResponseFactory {
+    /**
+     * Create an invoke response from a text message.
+     * The type of the invoke response is `application/vnd.microsoft.activity.message`
+     * indicates the request was successfully processed.
+     *
+     * @param message A text message included in a invoke response.
+     *
+     * @returns {InvokeResponse} An InvokeResponse object.
+     */
+    static textMessage(message) {
+        if (!message) {
+            throw new Error("The text message cannot be null or empty");
+        }
+        return {
+            status: botbuilder.StatusCodes.OK,
+            body: {
+                statusCode: botbuilder.StatusCodes.OK,
+                type: InvokeResponseType.Message,
+                value: message,
+            },
+        };
     }
-    else if (conversationType === "groupChat") {
-        return exports.NotificationTargetType.Group;
+    /**
+     * Create an invoke response from an adaptive card.
+     *
+     * The type of the invoke response is `application/vnd.microsoft.card.adaptive` indicates
+     * the request was successfully processed, and the response includes an adaptive card
+     * that the client should display in place of the current one.
+     *
+     * @param card The adaptive card JSON payload.
+     *
+     * @returns {InvokeResponse} An InvokeResponse object.
+     */
+    static adaptiveCard(card) {
+        if (!card) {
+            throw new Error("The adaptive card content cannot be null or undefined");
+        }
+        return {
+            status: botbuilder.StatusCodes.OK,
+            body: {
+                statusCode: botbuilder.StatusCodes.OK,
+                type: InvokeResponseType.AdaptiveCard,
+                value: card,
+            },
+        };
     }
-    else if (conversationType === "channel") {
-        return exports.NotificationTargetType.Channel;
+    /**
+     * Create an invoke response with error code and message.
+     *
+     * The type of the invoke response is `application/vnd.microsoft.error` indicates
+     * the request was failed to processed.
+     *
+     * @param errorCode The status code indicates error, available values:
+     *  - 400 (BadRequest): indicate the incoming request was invalid.
+     *  - 500 (InternalServerError): indicate an unexpected error occurred.
+     * @param errorMessage The error message.
+     *
+     * @returns {InvokeResponse} An InvokeResponse object.
+     */
+    static errorResponse(errorCode, errorMessage) {
+        return {
+            status: botbuilder.StatusCodes.OK,
+            body: {
+                statusCode: errorCode,
+                type: InvokeResponseType.Error,
+                value: {
+                    code: errorCode.toString(),
+                    message: errorMessage,
+                },
+            },
+        };
     }
-    else {
-        return undefined;
+    /**
+     * Create an invoke response with status code and response value.
+     * @param statusCode The status code.
+     * @param body The value of the response body.
+     *
+     * @returns {InvokeResponse} An InvokeResponse object.
+     */
+    static createInvokeResponse(statusCode, body) {
+        return {
+            status: statusCode,
+            body: body,
+        };
     }
-}
-/**
- * @internal
- */
-function getTeamsBotInstallationId(context) {
-    var _a, _b, _c, _d;
-    return (_d = (_c = (_b = (_a = context.activity) === null || _a === void 0 ? void 0 : _a.channelData) === null || _b === void 0 ? void 0 : _b.team) === null || _c === void 0 ? void 0 : _c.id) !== null && _d !== void 0 ? _d : context.activity.conversation.id;
 }
 
-// Copyright (c) Microsoft Corporation.
-/**
- * @internal
- */
-var ActivityType;
-(function (ActivityType) {
-    ActivityType[ActivityType["CurrentBotInstalled"] = 0] = "CurrentBotInstalled";
-    ActivityType[ActivityType["CurrentBotMessaged"] = 1] = "CurrentBotMessaged";
-    ActivityType[ActivityType["CurrentBotUninstalled"] = 2] = "CurrentBotUninstalled";
-    ActivityType[ActivityType["TeamDeleted"] = 3] = "TeamDeleted";
-    ActivityType[ActivityType["TeamRestored"] = 4] = "TeamRestored";
-    ActivityType[ActivityType["Unknown"] = 5] = "Unknown";
-})(ActivityType || (ActivityType = {}));
 /**
  * @internal
  */
-class NotificationMiddleware {
-    constructor(options) {
-        this.conversationReferenceStore = options.conversationReferenceStore;
+class CardActionMiddleware {
+    constructor(handlers) {
+        this.actionHandlers = [];
+        this.defaultMessage = "Your response was sent to the app";
+        if (handlers && handlers.length > 0) {
+            this.actionHandlers.push(...handlers);
+        }
     }
     onTurn(context, next) {
+        var _a, _b, _c;
         return tslib.__awaiter(this, void 0, void 0, function* () {
-            const type = this.classifyActivity(context.activity);
-            switch (type) {
-                case ActivityType.CurrentBotInstalled:
-                case ActivityType.TeamRestored: {
-                    const reference = botbuilder.TurnContext.getConversationReference(context.activity);
-                    yield this.conversationReferenceStore.set(reference);
-                    break;
-                }
-                case ActivityType.CurrentBotMessaged: {
-                    yield this.tryAddMessagedReference(context);
-                    break;
-                }
-                case ActivityType.CurrentBotUninstalled:
-                case ActivityType.TeamDeleted: {
-                    const reference = botbuilder.TurnContext.getConversationReference(context.activity);
-                    yield this.conversationReferenceStore.delete(reference);
-                    break;
+            if (context.activity.name === "adaptiveCard/action") {
+                const action = context.activity.value.action;
+                const actionVerb = action.verb;
+                for (const handler of this.actionHandlers) {
+                    if (((_a = handler.triggerVerb) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === (actionVerb === null || actionVerb === void 0 ? void 0 : actionVerb.toLowerCase())) {
+                        let response;
+                        try {
+                            response = yield handler.handleActionInvoked(context, action.data);
+                        }
+                        catch (error) {
+                            const errorResponse = InvokeResponseFactory.errorResponse(exports.InvokeResponseErrorCode.InternalServerError, error.message);
+                            yield this.sendInvokeResponse(context, errorResponse);
+                            throw error;
+                        }
+                        const responseType = (_b = response.body) === null || _b === void 0 ? void 0 : _b.type;
+                        switch (responseType) {
+                            case InvokeResponseType.AdaptiveCard:
+                                const card = (_c = response.body) === null || _c === void 0 ? void 0 : _c.value;
+                                if (!card) {
+                                    const errorMessage = "Adaptive card content cannot be found in the response body";
+                                    yield this.sendInvokeResponse(context, InvokeResponseFactory.errorResponse(exports.InvokeResponseErrorCode.InternalServerError, errorMessage));
+                                    throw new Error(errorMessage);
+                                }
+                                if (card.refresh && handler.adaptiveCardResponse !== exports.AdaptiveCardResponse.NewForAll) {
+                                    // Card won't be refreshed with AdaptiveCardResponse.ReplaceForInteractor.
+                                    // So set to AdaptiveCardResponse.ReplaceForAll here.
+                                    handler.adaptiveCardResponse = exports.AdaptiveCardResponse.ReplaceForAll;
+                                }
+                                const activity = botbuilder.MessageFactory.attachment(botbuilder.CardFactory.adaptiveCard(card));
+                                if (handler.adaptiveCardResponse === exports.AdaptiveCardResponse.NewForAll) {
+                                    yield this.sendInvokeResponse(context, InvokeResponseFactory.textMessage(this.defaultMessage));
+                                    yield context.sendActivity(activity);
+                                }
+                                else if (handler.adaptiveCardResponse === exports.AdaptiveCardResponse.ReplaceForAll) {
+                                    activity.id = context.activity.replyToId;
+                                    yield context.updateActivity(activity);
+                                    yield this.sendInvokeResponse(context, response);
+                                }
+                                else {
+                                    yield this.sendInvokeResponse(context, response);
+                                }
+                                break;
+                            case InvokeResponseType.Message:
+                            case InvokeResponseType.Error:
+                            default:
+                                yield this.sendInvokeResponse(context, response);
+                                break;
+                        }
+                        break;
+                    }
                 }
             }
             yield next();
         });
     }
-    classifyActivity(activity) {
-        var _a, _b;
-        const activityType = activity.type;
-        if (activityType === "installationUpdate") {
-            const action = (_a = activity.action) === null || _a === void 0 ? void 0 : _a.toLowerCase();
-            if (action === "add") {
-                return ActivityType.CurrentBotInstalled;
-            }
-            else {
-                return ActivityType.CurrentBotUninstalled;
-            }
-        }
-        else if (activityType === "conversationUpdate") {
-            const eventType = (_b = activity.channelData) === null || _b === void 0 ? void 0 : _b.eventType;
-            if (eventType === "teamDeleted") {
-                return ActivityType.TeamDeleted;
-            }
-            else if (eventType === "teamRestored") {
-                return ActivityType.TeamRestored;
-            }
-        }
-        else if (activityType === "message") {
-            return ActivityType.CurrentBotMessaged;
-        }
-        return ActivityType.Unknown;
-    }
-    tryAddMessagedReference(context) {
-        var _a, _b, _c, _d;
+    sendInvokeResponse(context, response) {
         return tslib.__awaiter(this, void 0, void 0, function* () {
-            const reference = botbuilder.TurnContext.getConversationReference(context.activity);
-            const conversationType = (_a = reference === null || reference === void 0 ? void 0 : reference.conversation) === null || _a === void 0 ? void 0 : _a.conversationType;
-            if (conversationType === "personal" || conversationType === "groupChat") {
-                if (!(yield this.conversationReferenceStore.check(reference))) {
-                    yield this.conversationReferenceStore.set(reference);
-                }
-            }
-            else if (conversationType === "channel") {
-                const teamId = (_d = (_c = (_b = context.activity) === null || _b === void 0 ? void 0 : _b.channelData) === null || _c === void 0 ? void 0 : _c.team) === null || _d === void 0 ? void 0 : _d.id;
-                if (teamId !== undefined) {
-                    const teamReference = cloneConversation(reference);
-                    teamReference.conversation.id = teamId;
-                    if (!(yield this.conversationReferenceStore.check(teamReference))) {
-                        yield this.conversationReferenceStore.set(teamReference);
-                    }
-                }
-            }
+            yield context.sendActivity({
+                type: botbuilder.ActivityTypes.InvokeResponse,
+                value: response,
+            });
         });
     }
-}
+}
+
+/**
+ * A card action bot to respond to adaptive card universal actions.
+ */
+class CardActionBot {
+    /**
+     * Creates a new instance of the `CardActionBot`.
+     *
+     * @param adapter The bound `BotFrameworkAdapter`.
+     * @param options - initialize options
+     */
+    constructor(adapter, options) {
+        this.middleware = new CardActionMiddleware(options === null || options === void 0 ? void 0 : options.actions);
+        this.adapter = adapter.use(this.middleware);
+    }
+    /**
+     * Registers a card action handler to the bot.
+     * @param actionHandler A card action handler to be registered.
+     */
+    registerHandler(actionHandler) {
+        if (actionHandler) {
+            this.middleware.actionHandlers.push(actionHandler);
+        }
+    }
+    /**
+     * Registers card action handlers to the bot.
+     * @param actionHandlers A set of card action handlers to be registered.
+     */
+    registerHandlers(actionHandlers) {
+        if (actionHandlers) {
+            this.middleware.actionHandlers.push(...actionHandlers);
+        }
+    }
+}
+
+// Copyright (c) Microsoft Corporation.
+/**
+ * @internal
+ */
 class CommandResponseMiddleware {
     constructor(handlers) {
         this.commandHandlers = [];
@@ -2064,6 +2213,7 @@ class CommandResponseMiddleware {
                                 yield context.sendActivity(replyActivity);
                             }
                         }
+                        break;
                     }
                 }
             }
@@ -2145,6 +2295,134 @@ class CommandBot {
     }
 }
 
+// Copyright (c) Microsoft Corporation.
+/**
+ * @internal
+ */
+function cloneConversation(conversation) {
+    return JSON.parse(JSON.stringify(conversation));
+}
+/**
+ * @internal
+ */
+function getTargetType(conversationReference) {
+    var _a;
+    const conversationType = (_a = conversationReference.conversation) === null || _a === void 0 ? void 0 : _a.conversationType;
+    if (conversationType === "personal") {
+        return exports.NotificationTargetType.Person;
+    }
+    else if (conversationType === "groupChat") {
+        return exports.NotificationTargetType.Group;
+    }
+    else if (conversationType === "channel") {
+        return exports.NotificationTargetType.Channel;
+    }
+    else {
+        return undefined;
+    }
+}
+/**
+ * @internal
+ */
+function getTeamsBotInstallationId(context) {
+    var _a, _b, _c, _d;
+    return (_d = (_c = (_b = (_a = context.activity) === null || _a === void 0 ? void 0 : _a.channelData) === null || _b === void 0 ? void 0 : _b.team) === null || _c === void 0 ? void 0 : _c.id) !== null && _d !== void 0 ? _d : context.activity.conversation.id;
+}
+
+// Copyright (c) Microsoft Corporation.
+/**
+ * @internal
+ */
+var ActivityType;
+(function (ActivityType) {
+    ActivityType[ActivityType["CurrentBotInstalled"] = 0] = "CurrentBotInstalled";
+    ActivityType[ActivityType["CurrentBotMessaged"] = 1] = "CurrentBotMessaged";
+    ActivityType[ActivityType["CurrentBotUninstalled"] = 2] = "CurrentBotUninstalled";
+    ActivityType[ActivityType["TeamDeleted"] = 3] = "TeamDeleted";
+    ActivityType[ActivityType["TeamRestored"] = 4] = "TeamRestored";
+    ActivityType[ActivityType["Unknown"] = 5] = "Unknown";
+})(ActivityType || (ActivityType = {}));
+/**
+ * @internal
+ */
+class NotificationMiddleware {
+    constructor(options) {
+        this.conversationReferenceStore = options.conversationReferenceStore;
+    }
+    onTurn(context, next) {
+        return tslib.__awaiter(this, void 0, void 0, function* () {
+            const type = this.classifyActivity(context.activity);
+            switch (type) {
+                case ActivityType.CurrentBotInstalled:
+                case ActivityType.TeamRestored: {
+                    const reference = botbuilder.TurnContext.getConversationReference(context.activity);
+                    yield this.conversationReferenceStore.set(reference);
+                    break;
+                }
+                case ActivityType.CurrentBotMessaged: {
+                    yield this.tryAddMessagedReference(context);
+                    break;
+                }
+                case ActivityType.CurrentBotUninstalled:
+                case ActivityType.TeamDeleted: {
+                    const reference = botbuilder.TurnContext.getConversationReference(context.activity);
+                    yield this.conversationReferenceStore.delete(reference);
+                    break;
+                }
+            }
+            yield next();
+        });
+    }
+    classifyActivity(activity) {
+        var _a, _b;
+        const activityType = activity.type;
+        if (activityType === "installationUpdate") {
+            const action = (_a = activity.action) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+            if (action === "add") {
+                return ActivityType.CurrentBotInstalled;
+            }
+            else {
+                return ActivityType.CurrentBotUninstalled;
+            }
+        }
+        else if (activityType === "conversationUpdate") {
+            const eventType = (_b = activity.channelData) === null || _b === void 0 ? void 0 : _b.eventType;
+            if (eventType === "teamDeleted") {
+                return ActivityType.TeamDeleted;
+            }
+            else if (eventType === "teamRestored") {
+                return ActivityType.TeamRestored;
+            }
+        }
+        else if (activityType === "message") {
+            return ActivityType.CurrentBotMessaged;
+        }
+        return ActivityType.Unknown;
+    }
+    tryAddMessagedReference(context) {
+        var _a, _b, _c, _d;
+        return tslib.__awaiter(this, void 0, void 0, function* () {
+            const reference = botbuilder.TurnContext.getConversationReference(context.activity);
+            const conversationType = (_a = reference === null || reference === void 0 ? void 0 : reference.conversation) === null || _a === void 0 ? void 0 : _a.conversationType;
+            if (conversationType === "personal" || conversationType === "groupChat") {
+                if (!(yield this.conversationReferenceStore.check(reference))) {
+                    yield this.conversationReferenceStore.set(reference);
+                }
+            }
+            else if (conversationType === "channel") {
+                const teamId = (_d = (_c = (_b = context.activity) === null || _b === void 0 ? void 0 : _b.channelData) === null || _c === void 0 ? void 0 : _c.team) === null || _d === void 0 ? void 0 : _d.id;
+                if (teamId !== undefined) {
+                    const teamReference = cloneConversation(reference);
+                    teamReference.conversation.id = teamId;
+                    if (!(yield this.conversationReferenceStore.check(teamReference))) {
+                        yield this.conversationReferenceStore.set(teamReference);
+                    }
+                }
+            }
+        });
+    }
+}
+
 // Copyright (c) Microsoft Corporation.
 /**
  * @internal
@@ -2682,7 +2960,7 @@ class ConversationBot {
      * @param options - initialize options
      */
     constructor(options) {
-        var _a, _b;
+        var _a, _b, _c;
         if (options.adapter) {
             this.adapter = options.adapter;
         }
@@ -2695,6 +2973,9 @@ class ConversationBot {
         if ((_b = options.notification) === null || _b === void 0 ? void 0 : _b.enabled) {
             this.notification = new NotificationBot(this.adapter, options.notification);
         }
+        if ((_c = options.cardAction) === null || _c === void 0 ? void 0 : _c.enabled) {
+            this.cardAction = new CardActionBot(this.adapter, options.cardAction);
+        }
     }
     createDefaultAdapter(adapterConfig) {
         const adapter = adapterConfig === undefined
@@ -2887,11 +3168,13 @@ exports.ApiKeyProvider = ApiKeyProvider;
 exports.AppCredential = AppCredential;
 exports.BasicAuthProvider = BasicAuthProvider;
 exports.BearerTokenAuthProvider = BearerTokenAuthProvider;
+exports.CardActionBot = CardActionBot;
 exports.CertificateAuthProvider = CertificateAuthProvider;
 exports.Channel = Channel;
 exports.CommandBot = CommandBot;
 exports.ConversationBot = ConversationBot;
 exports.ErrorWithCode = ErrorWithCode;
+exports.InvokeResponseFactory = InvokeResponseFactory;
 exports.Member = Member;
 exports.MessageBuilder = MessageBuilder;
 exports.MsGraphAuthProvider = MsGraphAuthProvider;