feat: add support for Teams meeting start/end events (#3757)

Author: mdrichardson

libraries/botbuilder-core/src/activityHandler.ts

@@ -457,7 +457,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to use custom logic for emitting events.
+     * Override this method to use custom logic for emitting events.
      *
      * The default logic is to call any handlers registered via [onTurn](xref:botbuilder-core.ActivityHandler.onTurn),
      * and then continue by calling [ActivityHandlerBase.onTurnActivity](xref:botbuilder-core.ActivityHandlerBase.onTurnActivity).
@@ -474,7 +474,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onMessage](xref:botbuilder-core.ActivityHandler.onMessage),
@@ -489,7 +489,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      * The default logic is to check for a signIn invoke and handle that
      * and then continue by calling [defaultNextEvent](xref:botbuilder-core.ActivityHandler.defaultNextEvent).
      */
@@ -531,7 +531,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      */
     protected async onSignInInvoke(context: TurnContext): Promise<void> {
         throw new InvokeException(StatusCodes.NOT_IMPLEMENTED);
@@ -556,7 +556,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onEndOfConversationActivity](xref:botbuilder-core.ActivityHandler.onMessage),
@@ -572,7 +572,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onTypingActivity](xref:botbuilder-core.ActivityHandler.onTypingActivity),
@@ -588,7 +588,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onInstallationUpdateActivity](xref:botbuilder-core.ActivityHandler.onInstallationUpdateActivity),
@@ -624,7 +624,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels or to add
+     * Override this method to support channel-specific behavior across multiple channels or to add
      * custom conversation update sub-type events.
      *
      * The default logic is:
@@ -651,7 +651,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onInstallationUpdateAdd](xref:botbuilder-core.ActivityHandler.onInstallationUpdateAdd),
@@ -667,7 +667,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onInstallationUpdateRemove](xref:botbuilder-core.ActivityHandler.onInstallationUpdateRemove),
@@ -683,7 +683,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onUnrecognizedActivityType](xref:botbuilder-core.ActivityHandler.onUnrecognizedActivityType),
@@ -743,7 +743,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onConversationUpdate](xref:botbuilder-core.ActivityHandler.onConversationUpdate),
@@ -762,7 +762,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels or to add
+     * Override this method to support channel-specific behavior across multiple channels or to add
      * custom conversation update sub-type events.
      *
      * The default logic is:
@@ -786,7 +786,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onMessageReaction](xref:botbuilder-core.ActivityHandler.onMessageReaction),
@@ -806,7 +806,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onReactionsAdded](xref:botbuilder-core.ActivityHandler.onReactionsAdded),
@@ -823,7 +823,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onReactionsRemoved](xref:botbuilder-core.ActivityHandler.onReactionsRemoved),
@@ -842,7 +842,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels or to add
+     * Override this method to support channel-specific behavior across multiple channels or to add
      * custom message reaction sub-type events.
      *
      * The default logic is:
@@ -864,7 +864,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels.
+     * Override this method to support channel-specific behavior across multiple channels.
      *
      * The default logic is to call any handlers registered via
      * [onEvent](xref:botbuilder-core.ActivityHandler.onEvent),
@@ -883,7 +883,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to support channel-specific behavior across multiple channels or to add custom event sub-type events.
+     * Override this method to support channel-specific behavior across multiple channels or to add custom event sub-type events.
      * For certain channels, such as  Web Chat and custom Direct Line clients, developers can emit custom event activities from the client.
      *
      * The default logic is:
@@ -905,7 +905,7 @@ export class ActivityHandler extends ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to use custom logic for emitting events.
+     * Override this method to use custom logic for emitting events.
      *
      * The default logic is to call any handlers registered via [onDialog](xref:botbuilder-core.ActivityHandler.onDialog),
      * and then complete the event emission process.

libraries/botbuilder-core/src/activityHandlerBase.ts

@@ -6,7 +6,7 @@ import { ActivityTypes, ChannelAccount, MessageReaction, TurnContext } from '.';
 import { InvokeResponse } from './invokeResponse';
 import { StatusCodes } from './statusCodes';
 
-// This key is exported internally so that subclassed ActivityHandlers and BotAdapters will not overwrite any already set InvokeResponses.
+// This key is exported internally so that subclassed ActivityHandlers and BotAdapters will not override any already set InvokeResponses.
 export const INVOKE_RESPONSE_KEY = Symbol('invokeResponse');
 
 /**
@@ -37,7 +37,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to use custom logic for emitting events.
+     * Override this method to use custom logic for emitting events.
      *
      * The default logic is to call any type-specific and sub-type handlers registered via
      * the various _on event_ methods. Type-specific events are defined for:
@@ -97,7 +97,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _message_ handlers and then continue the event
+     * Override this method to run registered _message_ handlers and then continue the event
      * emission process.
      */
     protected async onMessageActivity(context: TurnContext): Promise<void> {
@@ -110,7 +110,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _conversation update_ handlers and then continue the event
+     * Override this method to run registered _conversation update_ handlers and then continue the event
      * emission process.
      *
      * The default logic is:
@@ -145,7 +145,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _message reaction_ handlers and then continue the event
+     * Override this method to run registered _message reaction_ handlers and then continue the event
      * emission process.
      *
      * The default logic is:
@@ -168,7 +168,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _event_ handlers and then continue the event
+     * Override this method to run registered _event_ handlers and then continue the event
      * emission process.
      */
     protected async onEventActivity(context: TurnContext): Promise<void> {
@@ -181,7 +181,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to handle particular invoke calls.
+     * Override this method to handle particular invoke calls.
      */
     protected async onInvokeActivity(context: TurnContext): Promise<InvokeResponse> {
         return { status: StatusCodes.NOT_IMPLEMENTED };
@@ -193,7 +193,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _end of conversation_ handlers and then continue the event
+     * Override this method to run registered _end of conversation_ handlers and then continue the event
      * emission process.
      */
     protected async onEndOfConversationActivity(context: TurnContext): Promise<void> {
@@ -206,7 +206,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _typing_ handlers and then continue the event
+     * Override this method to run registered _typing_ handlers and then continue the event
      * emission process.
      */
     protected async onTypingActivity(context: TurnContext): Promise<void> {
@@ -219,7 +219,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _installationupdate_ handlers and then continue the event
+     * Override this method to run registered _installationupdate_ handlers and then continue the event
      * emission process.
      */
     protected async onInstallationUpdateActivity(context: TurnContext): Promise<void> {
@@ -241,7 +241,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _installationupdateadd_ handlers and then continue the event
+     * Override this method to run registered _installationupdateadd_ handlers and then continue the event
      * emission process.
      */
     protected async onInstallationUpdateAddActivity(context: TurnContext): Promise<void> {
@@ -254,7 +254,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _installationupdateremove_ handlers and then continue the event
+     * Override this method to run registered _installationupdateremove_ handlers and then continue the event
      * emission process.
      */
     protected async onInstallationUpdateRemoveActivity(context: TurnContext): Promise<void> {
@@ -267,7 +267,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _unrecognized_ handlers and then continue the event
+     * Override this method to run registered _unrecognized_ handlers and then continue the event
      * emission process.
      */
     protected async onUnrecognizedActivity(context: TurnContext): Promise<void> {
@@ -282,7 +282,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _members added_ handlers and then continue the event
+     * Override this method to run registered _members added_ handlers and then continue the event
      * emission process.
      */
     protected async onMembersAddedActivity(membersAdded: ChannelAccount[], context: TurnContext): Promise<void> {
@@ -297,7 +297,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _members removed_ handlers and then continue the event
+     * Override this method to run registered _members removed_ handlers and then continue the event
      * emission process.
      */
     protected async onMembersRemovedActivity(membersRemoved: ChannelAccount[], context: TurnContext): Promise<void> {
@@ -312,7 +312,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _reactions added_ handlers and then continue the event
+     * Override this method to run registered _reactions added_ handlers and then continue the event
      * emission process.
      */
     protected async onReactionsAddedActivity(reactionsAdded: MessageReaction[], context: TurnContext): Promise<void> {
@@ -327,7 +327,7 @@ export class ActivityHandlerBase {
      * @param context The context object for the current turn.
      *
      * @remarks
-     * Overwrite this method to run registered _reactions removed_ handlers and then continue the event
+     * Override this method to run registered _reactions removed_ handlers and then continue the event
      * emission process.
      */
     protected async onReactionsRemovedActivity(