@microsoft/teamsfx 1.2.1-alpha.cecbda807.0 → 1.2.1-rc.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/teamsfx",
-  "version": "1.2.1-alpha.cecbda807.0",
+  "version": "1.2.1-rc.1",
   "description": "Microsoft Teams Framework for Node.js and browser.",
   "main": "dist/index.node.cjs.js",
   "browser": "dist/index.esm2017.js",
@@ -49,7 +49,7 @@
     "@azure/identity": "^2.0.1",
     "@azure/msal-browser": "^2.21.0",
     "@azure/msal-node": "~1.1.0",
-    "@microsoft/adaptivecards-tools": "1.0.4-alpha.cecbda807.0",
+    "@microsoft/adaptivecards-tools": "^1.1.0-rc.0",
     "@microsoft/microsoft-graph-client": "^3.0.1",
     "axios": "^0.27.2",
     "botbuilder": ">=4.15.0 <5.0.0",
@@ -129,7 +129,7 @@
     "webpack": "^5.62.1",
     "yargs": "^17.2.1"
   },
-  "gitHead": "1f26d824db654b005c7a4e86242a028b45be8c72",
+  "gitHead": "4a129d1ba158b94149387811fe2d58e6a2ef1801",
   "publishConfig": {
     "access": "public"
   },

package/types/teamsfx.d.ts

@@ -538,16 +538,20 @@ export declare class Channel implements NotificationTarget {
      * Send a plain text message.
      *
      * @param text - the plain text message.
+     * @param onError - an optional error handler that can catch exceptions during message sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
      * @returns the response of sending message.
      */
-    sendMessage(text: string): Promise<MessageResponse>;
+    sendMessage(text: string, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * Send an adaptive card message.
      *
      * @param card - the adaptive card raw JSON.
+     * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
      * @returns the response of sending adaptive card message.
      */
-    sendAdaptiveCard(card: unknown): Promise<MessageResponse>;
+    sendAdaptiveCard(card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * @internal
      */
@@ -1215,16 +1219,20 @@ export declare class Member implements NotificationTarget {
      * Send a plain text message.
      *
      * @param text - the plain text message.
+     * @param onError - an optional error handler that can catch exceptions during message sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
      * @returns the response of sending message.
      */
-    sendMessage(text: string): Promise<MessageResponse>;
+    sendMessage(text: string, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * Send an adaptive card message.
      *
      * @param card - the adaptive card raw JSON.
+     * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
      * @returns the response of sending adaptive card message.
      */
-    sendAdaptiveCard(card: unknown): Promise<MessageResponse>;
+    sendAdaptiveCard(card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * @internal
      */
@@ -1438,6 +1446,7 @@ export declare class NotificationBot {
     findMember(predicate: (member: Member) => Promise<boolean>, scope?: SearchScope): Promise<Member | undefined>;
     /**
      * Returns the first {@link Channel} where predicate is true, and undefined otherwise.
+     * (Ensure the bot app is installed into the `General` channel, otherwise undefined will be returned.)
      *
      * @param predicate find calls predicate once for each channel of the installation,
      * until it finds one where predicate returns true. If such a channel is found, find
@@ -1456,6 +1465,7 @@ export declare class NotificationBot {
     findAllMembers(predicate: (member: Member) => Promise<boolean>, scope?: SearchScope): Promise<Member[]>;
     /**
      * Returns all {@link Channel} where predicate is true, and empty array otherwise.
+     * (Ensure the bot app is installed into the `General` channel, otherwise empty array will be returned.)
      *
      * @param predicate find calls predicate for each channel of the installation.
      * @returns an array of {@link Channel} where predicate is true, and empty array otherwise.
@@ -1495,18 +1505,22 @@ export declare interface NotificationTarget {
      * Send a plain text message.
      *
      * @param text - the plain text message.
+     * @param onError - an optional error handler that can catch exceptions during message sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
      *
      * @returns the response of sending message.
      */
-    sendMessage(text: string): Promise<MessageResponse>;
+    sendMessage(text: string, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * Send an adaptive card message.
      *
      * @param card - the adaptive card raw JSON.
+     * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
      *
      * @returns the response of sending adaptive card message.
      */
-    sendAdaptiveCard(card: unknown): Promise<MessageResponse>;
+    sendAdaptiveCard(card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
 }
 
 /**
@@ -1680,18 +1694,22 @@ export declare enum SearchScope {
  *
  * @param target - the notification target.
  * @param card - the adaptive card raw JSON.
+ * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+ * If not defined, error will be handled by `BotAdapter.onTurnError`.
  * @returns the response of sending adaptive card message.
  */
-export declare function sendAdaptiveCard(target: NotificationTarget, card: unknown): Promise<MessageResponse>;
+export declare function sendAdaptiveCard(target: NotificationTarget, card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
 
 /**
  * Send a plain text message to a notification target.
  *
  * @param target - the notification target.
  * @param text - the plain text message.
+ * @param onError - an optional error handler that can catch exceptions during message sending.
+ * If not defined, error will be handled by `BotAdapter.onTurnError`.
  * @returns the response of sending message.
  */
-export declare function sendMessage(target: NotificationTarget, text: string): Promise<MessageResponse>;
+export declare function sendMessage(target: NotificationTarget, text: string, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
 
 /**
  * Set custom log function. Use the function if it's set. Priority is lower than setLogger.
@@ -1774,16 +1792,20 @@ export declare class TeamsBotInstallation implements NotificationTarget {
      * Send a plain text message.
      *
      * @param text - the plain text message.
+     * @param onError - an optional error handler that can catch exceptions during message sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
      * @returns the response of sending message.
      */
-    sendMessage(text: string): Promise<MessageResponse>;
+    sendMessage(text: string, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * Send an adaptive card message.
      *
      * @param card - the adaptive card raw JSON.
+     * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
      * @returns the response of sending adaptive card message.
      */
-    sendAdaptiveCard(card: unknown): Promise<MessageResponse>;
+    sendAdaptiveCard(card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * Get channels from this bot installation.
      *