@microsoft/agents-hosting-extensions-msteams 1.7.0-beta.10.g0c6864b626

package/dist/src/fileConsents/fileConsent.js

@@ -0,0 +1,79 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileConsent = void 0;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const agents_hosting_1 = require("@microsoft/agents-hosting");
+const teamsTurnContext_1 = require("../teamsTurnContext");
+function isFileConsentAction(context, action) {
+    var _a;
+    const activityAction = (_a = context.activity.value) === null || _a === void 0 ? void 0 : _a.action;
+    return (context.activity.type === agents_activity_1.ActivityTypes.Invoke &&
+        context.activity.channelId === 'msteams' &&
+        typeof context.activity.name === 'string' &&
+        context.activity.name.toLowerCase() === 'fileconsent/invoke' &&
+        typeof activityAction === 'string' &&
+        activityAction.toLowerCase() === action);
+}
+/**
+ * Registers handlers for Microsoft Teams file consent card actions.
+ *
+ * @typeParam TState - The turn state type used by the agent application.
+ */
+class FileConsent {
+    /**
+     * Creates a Teams file consent route helper.
+     *
+     * @param app - The agent application that receives the registered routes.
+     */
+    constructor(app) {
+        this._app = app;
+    }
+    /**
+     * Registers a handler for accepted file consent cards.
+     *
+     * @param handler - Handler invoked with the file consent card response.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This file consent helper for chaining.
+     */
+    onAccept(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isFileConsentAction(context, 'accept'));
+        };
+        const routeHandler = async (context, state) => {
+            const cardResponse = context.activity.value;
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, cardResponse);
+            const invokeResponse = new agents_activity_1.Activity(agents_activity_1.ActivityTypes.InvokeResponse);
+            invokeResponse.value = { status: 200 };
+            await context.sendActivity(invokeResponse);
+        };
+        this._app.addRoute(routeSel, routeHandler, true, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for declined file consent cards.
+     *
+     * @param handler - Handler invoked with the file consent card response.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This file consent helper for chaining.
+     */
+    onDecline(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isFileConsentAction(context, 'decline'));
+        };
+        const routeHandler = async (context, state) => {
+            const cardResponse = context.activity.value;
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, cardResponse);
+            const invokeResponse = new agents_activity_1.Activity(agents_activity_1.ActivityTypes.InvokeResponse);
+            invokeResponse.value = { status: 200 };
+            await context.sendActivity(invokeResponse);
+        };
+        this._app.addRoute(routeSel, routeHandler, true, rank, authHandlers);
+        return this;
+    }
+}
+exports.FileConsent = FileConsent;
+//# sourceMappingURL=fileConsent.js.map

package/dist/src/fileConsents/fileConsent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileConsent.js","sourceRoot":"","sources":["../../../src/fileConsents/fileConsent.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;AAElC,gEAAoE;AACpE,8DAA4H;AAE5H,0DAAsD;AAItD,SAAS,mBAAmB,CAAE,OAAoB,EAAE,MAA4B;;IAC9E,MAAM,cAAc,GAAG,MAAC,OAAO,CAAC,QAAQ,CAAC,KAAa,0CAAE,MAAM,CAAA;IAC9D,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,+BAAa,CAAC,MAAM;QAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS;QACxC,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ;QACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,oBAAoB;QAC5D,OAAO,cAAc,KAAK,QAAQ;QAClC,cAAc,CAAC,WAAW,EAAE,KAAK,MAAM,CACxC,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAa,WAAW;IAGtB;;;;OAIG;IACH,YAAa,GAA6B;QACxC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;IACjB,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAE,OAAmC,EAAE,OAAe,0BAAS,CAAC,WAAW,EAAE,eAAyB,EAAE;QAC9G,MAAM,QAAQ,GAAkB,CAAC,OAAoB,EAAE,EAAE;YACvD,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;QAChE,CAAC,CAAA;QACD,MAAM,YAAY,GAAyB,KAAK,EAAE,OAAoB,EAAE,KAAa,EAAE,EAAE;YACvF,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAgC,CAAA;YACtE,MAAM,OAAO,CAAC,IAAI,mCAAgB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAA;YACjE,MAAM,cAAc,GAAG,IAAI,0BAAQ,CAAC,+BAAa,CAAC,cAAc,CAAC,CAAA;YACjE,cAAc,CAAC,KAAK,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;YACtC,MAAM,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;QAC5C,CAAC,CAAA;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QACpE,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAE,OAAmC,EAAE,OAAe,0BAAS,CAAC,WAAW,EAAE,eAAyB,EAAE;QAC/G,MAAM,QAAQ,GAAkB,CAAC,OAAoB,EAAE,EAAE;YACvD,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;QACjE,CAAC,CAAA;QACD,MAAM,YAAY,GAAyB,KAAK,EAAE,OAAoB,EAAE,KAAa,EAAE,EAAE;YACvF,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAgC,CAAA;YACtE,MAAM,OAAO,CAAC,IAAI,mCAAgB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAA;YACjE,MAAM,cAAc,GAAG,IAAI,0BAAQ,CAAC,+BAAa,CAAC,cAAc,CAAC,CAAA;YACjE,cAAc,CAAC,KAAK,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;YACtC,MAAM,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;QAC5C,CAAC,CAAA;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QACpE,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAzDD,kCAyDC"}

package/dist/src/fileConsents/index.d.ts

@@ -0,0 +1 @@
+export * from './fileConsent';

package/dist/src/fileConsents/index.js

@@ -0,0 +1,20 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./fileConsent"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/fileConsents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fileConsents/index.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;;;;;;;;;;;;;;AAElC,gDAA6B"}

package/dist/src/graphClientFactory.d.ts

@@ -0,0 +1,10 @@
+import { type AuthProvider, type Authorization, type TurnContext } from '@microsoft/agents-hosting';
+import { Client as GraphClient } from '@microsoft/microsoft-graph-client';
+/**
+ * Creates a Microsoft Graph client authenticated with a delegated user token.
+ */
+export declare function createUserGraphClient(authorization: Authorization, context: TurnContext, handlerName?: string, graphBaseUrl?: string): GraphClient;
+/**
+ * Creates a Microsoft Graph client authenticated with an app-only token.
+ */
+export declare function createAppGraphClient(tokenProvider: AuthProvider, graphBaseUrl?: string): GraphClient;

package/dist/src/graphClientFactory.js

@@ -0,0 +1,98 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUserGraphClient = createUserGraphClient;
+exports.createAppGraphClient = createAppGraphClient;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const microsoft_graph_client_1 = require("@microsoft/microsoft-graph-client");
+const errorHelper_1 = require("./errorHelper");
+const DEFAULT_GRAPH_BASE_URL = 'https://graph.microsoft.com/v1.0';
+class UserTokenProvider {
+    constructor(authorization, context, handlerName) {
+        this.authorization = authorization;
+        this.context = context;
+        this.handlerName = handlerName;
+    }
+    async getAccessToken() {
+        var _a;
+        const handlerName = (_a = this.handlerName) !== null && _a !== void 0 ? _a : this.getDefaultHandlerName();
+        const { token } = await this.authorization.getToken(this.context, handlerName);
+        if (!(token === null || token === void 0 ? void 0 : token.trim())) {
+            throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.TeamsGraphTokenUnavailable, undefined, { handlerName });
+        }
+        return token;
+    }
+    getDefaultHandlerName() {
+        var _a, _b, _c;
+        const authorization = this.authorization;
+        const handlerIds = (_c = (_b = (_a = authorization.manager) === null || _a === void 0 ? void 0 : _a.handlers) === null || _b === void 0 ? void 0 : _b.map((handler) => handler.id)) !== null && _c !== void 0 ? _c : [];
+        if (handlerIds.length === 1) {
+            return handlerIds[0];
+        }
+        if (handlerIds.length === 0) {
+            throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.TeamsGraphAuthorizationHandlerRequired);
+        }
+        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.TeamsGraphAuthorizationHandlerNameRequired);
+    }
+}
+class AppTokenProvider {
+    constructor(tokenProvider, scope) {
+        this.tokenProvider = tokenProvider;
+        this.scope = scope;
+    }
+    async getAccessToken() {
+        return await this.tokenProvider.getAccessToken(this.scope);
+    }
+}
+/**
+ * Creates a Microsoft Graph client authenticated with a delegated user token.
+ */
+function createUserGraphClient(authorization, context, handlerName, graphBaseUrl = DEFAULT_GRAPH_BASE_URL) {
+    if (!authorization) {
+        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.TeamsGraphParameterRequired, undefined, { parameterName: 'authorization' });
+    }
+    if (!context) {
+        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.TeamsGraphParameterRequired, undefined, { parameterName: 'context' });
+    }
+    if (!graphBaseUrl) {
+        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.TeamsGraphParameterRequired, undefined, { parameterName: 'graphBaseUrl' });
+    }
+    let graphUrl;
+    try {
+        graphUrl = new URL(graphBaseUrl);
+    }
+    catch {
+        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.TeamsGraphInvalidBaseUrl);
+    }
+    return microsoft_graph_client_1.Client.initWithMiddleware(createGraphClientOptions(new UserTokenProvider(authorization, context, handlerName), graphBaseUrl, graphUrl));
+}
+/**
+ * Creates a Microsoft Graph client authenticated with an app-only token.
+ */
+function createAppGraphClient(tokenProvider, graphBaseUrl = DEFAULT_GRAPH_BASE_URL) {
+    if (!tokenProvider) {
+        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.TeamsGraphParameterRequired, undefined, { parameterName: 'tokenProvider' });
+    }
+    if (!graphBaseUrl) {
+        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.TeamsGraphParameterRequired, undefined, { parameterName: 'graphBaseUrl' });
+    }
+    let graphUrl;
+    try {
+        graphUrl = new URL(graphBaseUrl);
+    }
+    catch {
+        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.TeamsGraphInvalidBaseUrl);
+    }
+    const scope = `${graphUrl.origin}/.default`;
+    return microsoft_graph_client_1.Client.initWithMiddleware(createGraphClientOptions(new AppTokenProvider(tokenProvider, scope), graphBaseUrl, graphUrl));
+}
+function createGraphClientOptions(authProvider, graphBaseUrl, graphUrl) {
+    return {
+        authProvider,
+        baseUrl: graphBaseUrl,
+        defaultVersion: '',
+        customHosts: new Set([graphUrl.hostname])
+    };
+}
+//# sourceMappingURL=graphClientFactory.js.map

package/dist/src/graphClientFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphClientFactory.js","sourceRoot":"","sources":["../../src/graphClientFactory.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,20 @@
+export * from './activity-extensions';
+export * from './app';
+export * from './channels';
+export * from './config';
+export { Errors as TeamsExtensionErrors } from './errorHelper';
+export * from './fileConsents';
+export * from './meetings';
+export * from './meetings/meeting';
+export * from './messageExtensions';
+export * from './messages';
+export * from './models';
+export * from './taskModules';
+export * from './teams';
+export type { TeamsActivity } from './teamsActivity';
+export * from './teamsActivityExtensions';
+export * from './teamsAgentExtension';
+export * from './teamsModelExtensions';
+export * from './teamsTurnContext';
+export { type TeamsRouteHandler } from './teamsRouteHandler';
+export * from './teamsProactiveServiceEndpoints';

package/dist/src/index.js

@@ -0,0 +1,39 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TeamsExtensionErrors = void 0;
+__exportStar(require("./activity-extensions"), exports);
+__exportStar(require("./app"), exports);
+__exportStar(require("./channels"), exports);
+__exportStar(require("./config"), exports);
+var errorHelper_1 = require("./errorHelper");
+Object.defineProperty(exports, "TeamsExtensionErrors", { enumerable: true, get: function () { return errorHelper_1.Errors; } });
+__exportStar(require("./fileConsents"), exports);
+__exportStar(require("./meetings"), exports);
+__exportStar(require("./meetings/meeting"), exports);
+__exportStar(require("./messageExtensions"), exports);
+__exportStar(require("./messages"), exports);
+__exportStar(require("./models"), exports);
+__exportStar(require("./taskModules"), exports);
+__exportStar(require("./teams"), exports);
+__exportStar(require("./teamsActivityExtensions"), exports);
+__exportStar(require("./teamsAgentExtension"), exports);
+__exportStar(require("./teamsModelExtensions"), exports);
+__exportStar(require("./teamsTurnContext"), exports);
+__exportStar(require("./teamsProactiveServiceEndpoints"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;;;;;;;;;;;;;;;AAElC,wDAAqC;AACrC,wCAAqB;AACrB,6CAA0B;AAC1B,2CAAwB;AACxB,6CAA8D;AAArD,mHAAA,MAAM,OAAwB;AACvC,iDAA8B;AAC9B,6CAA0B;AAC1B,qDAAkC;AAClC,sDAAmC;AACnC,6CAA0B;AAC1B,2CAAwB;AACxB,gDAA6B;AAC7B,0CAAuB;AAEvB,4DAAyC;AACzC,wDAAqC;AACrC,yDAAsC;AACtC,qDAAkC;AAElC,mEAAgD"}

package/dist/src/meetings/index.d.ts

@@ -0,0 +1 @@
+export * from './meeting';

package/dist/src/meetings/index.js

@@ -0,0 +1,20 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./meeting"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/meetings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/meetings/index.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;;;;;;;;;;;;;;AAElC,4CAAyB"}

package/dist/src/meetings/meeting.d.ts

@@ -0,0 +1,84 @@
+import { AgentApplication, TurnState } from '@microsoft/agents-hosting';
+import type { MeetingDetails, TeamsChannelAccount } from '@microsoft/teams.api';
+import { TeamsTurnContext } from '../teamsTurnContext';
+/**
+ * Details provided by Teams meeting participant join and leave events.
+ */
+export interface MeetingParticipantsEventDetails {
+    /**
+     * Participants included in the meeting event.
+     */
+    members: {
+        /**
+         * The Teams user account for the participant.
+         */
+        user: TeamsChannelAccount;
+        /**
+         * Meeting-specific participant state.
+         */
+        meeting: {
+            /**
+             * Indicates whether the participant is currently in the meeting.
+             */
+            inMeeting: boolean;
+            /**
+             * Participant role in the meeting.
+             */
+            role: string;
+        };
+    }[];
+}
+type MeetingStartHandler<TState extends TurnState> = (context: TeamsTurnContext, state: TState, details: MeetingDetails) => Promise<void>;
+type MeetingEndHandler<TState extends TurnState> = (context: TeamsTurnContext, state: TState, details: MeetingDetails) => Promise<void>;
+type MeetingParticipantsHandler<TState extends TurnState> = (context: TeamsTurnContext, state: TState, details: MeetingParticipantsEventDetails) => Promise<void>;
+/**
+ * Registers handlers for Microsoft Teams meeting events.
+ *
+ * @typeParam TState - The turn state type used by the agent application.
+ */
+export declare class Meeting<TState extends TurnState> {
+    private _app;
+    /**
+     * Creates a Teams meeting route helper.
+     *
+     * @param app - The agent application that receives the registered routes.
+     */
+    constructor(app: AgentApplication<TState>);
+    /**
+     * Registers a handler for Teams meeting start events.
+     *
+     * @param handler - Handler invoked with meeting details.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This meeting helper for chaining.
+     */
+    onStart(handler: MeetingStartHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for Teams meeting end events.
+     *
+     * @param handler - Handler invoked with meeting details.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This meeting helper for chaining.
+     */
+    onEnd(handler: MeetingEndHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for Teams meeting participant join events.
+     *
+     * @param handler - Handler invoked with participant event details.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This meeting helper for chaining.
+     */
+    onParticipantsJoin(handler: MeetingParticipantsHandler<TState>, rank?: number, authHandlers?: string[]): this;
+    /**
+     * Registers a handler for Teams meeting participant leave events.
+     *
+     * @param handler - Handler invoked with participant event details.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This meeting helper for chaining.
+     */
+    onParticipantsLeave(handler: MeetingParticipantsHandler<TState>, rank?: number, authHandlers?: string[]): this;
+}
+export {};

package/dist/src/meetings/meeting.js

@@ -0,0 +1,107 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Meeting = void 0;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const agents_hosting_1 = require("@microsoft/agents-hosting");
+const teamsTurnContext_1 = require("../teamsTurnContext");
+function isMeetingEvent(context, eventName) {
+    return (context.activity.type === agents_activity_1.ActivityTypes.Event &&
+        context.activity.channelId === 'msteams' &&
+        typeof context.activity.name === 'string' &&
+        context.activity.name.toLowerCase() === eventName.toLowerCase());
+}
+/**
+ * Registers handlers for Microsoft Teams meeting events.
+ *
+ * @typeParam TState - The turn state type used by the agent application.
+ */
+class Meeting {
+    /**
+     * Creates a Teams meeting route helper.
+     *
+     * @param app - The agent application that receives the registered routes.
+     */
+    constructor(app) {
+        this._app = app;
+    }
+    /**
+     * Registers a handler for Teams meeting start events.
+     *
+     * @param handler - Handler invoked with meeting details.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This meeting helper for chaining.
+     */
+    onStart(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isMeetingEvent(context, 'application/vnd.microsoft.meetingStart'));
+        };
+        const routeHandler = async (context, state) => {
+            const details = context.activity.value;
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, details);
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for Teams meeting end events.
+     *
+     * @param handler - Handler invoked with meeting details.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This meeting helper for chaining.
+     */
+    onEnd(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isMeetingEvent(context, 'application/vnd.microsoft.meetingEnd'));
+        };
+        const routeHandler = async (context, state) => {
+            const details = context.activity.value;
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, details);
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for Teams meeting participant join events.
+     *
+     * @param handler - Handler invoked with participant event details.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This meeting helper for chaining.
+     */
+    onParticipantsJoin(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isMeetingEvent(context, 'application/vnd.microsoft.meetingParticipantJoin'));
+        };
+        const routeHandler = async (context, state) => {
+            const details = context.activity.value;
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, details);
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+    /**
+     * Registers a handler for Teams meeting participant leave events.
+     *
+     * @param handler - Handler invoked with participant event details.
+     * @param rank - Optional route rank used for route ordering.
+     * @param authHandlers - Optional authorization handlers required by the route.
+     * @returns This meeting helper for chaining.
+     */
+    onParticipantsLeave(handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = []) {
+        const routeSel = (context) => {
+            return Promise.resolve(isMeetingEvent(context, 'application/vnd.microsoft.meetingParticipantLeave'));
+        };
+        const routeHandler = async (context, state) => {
+            const details = context.activity.value;
+            await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, details);
+        };
+        this._app.addRoute(routeSel, routeHandler, false, rank, authHandlers);
+        return this;
+    }
+}
+exports.Meeting = Meeting;
+//# sourceMappingURL=meeting.js.map

package/dist/src/meetings/meeting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meeting.js","sourceRoot":"","sources":["../../../src/meetings/meeting.ts"],"names":[],"mappings":"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"}

package/dist/src/messageExtensions/index.d.ts

@@ -0,0 +1,2 @@
+export { messagingExtensionQueryZodSchema, parseValueMessagingExtensionQuery } from './messagingExtensionQuery';
+export * from './messageExtension';

package/dist/src/messageExtensions/index.js

@@ -0,0 +1,24 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseValueMessagingExtensionQuery = exports.messagingExtensionQueryZodSchema = void 0;
+var messagingExtensionQuery_1 = require("./messagingExtensionQuery");
+Object.defineProperty(exports, "messagingExtensionQueryZodSchema", { enumerable: true, get: function () { return messagingExtensionQuery_1.messagingExtensionQueryZodSchema; } });
+Object.defineProperty(exports, "parseValueMessagingExtensionQuery", { enumerable: true, get: function () { return messagingExtensionQuery_1.parseValueMessagingExtensionQuery; } });
+__exportStar(require("./messageExtension"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/messageExtensions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/messageExtensions/index.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;;;;;;;;;;;;;;;AAElC,qEAA+G;AAAtG,2IAAA,gCAAgC,OAAA;AAAE,4IAAA,iCAAiC,OAAA;AAC5E,qDAAkC"}