@microsoft/agents-hosting-extensions-teams 0.5.1-g2e246ff274

package/dist/src/activity-extensions/teamsChannelDataSettings.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { z } from 'zod';
+import { ChannelInfo } from './channelInfo';
+/**
+ * Represents settings for Teams channel data.
+ */
+export interface TeamsChannelDataSettings {
+    /**
+     * The selected channel information.
+     */
+    selectedChannel?: ChannelInfo;
+    /**
+     * Additional properties.
+     */
+    [properties: string]: unknown;
+}
+/**
+ * Zod schema for validating TeamsChannelDataSettings objects.
+ */
+export declare const teamsChannelDataSettingsZodSchema: z.ZodObject<{
+    selectedChannel: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type?: string | undefined;
+        id?: string | undefined;
+        name?: string | undefined;
+    }, {
+        type?: string | undefined;
+        id?: string | undefined;
+        name?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    selectedChannel?: {
+        type?: string | undefined;
+        id?: string | undefined;
+        name?: string | undefined;
+    } | undefined;
+}, {
+    selectedChannel?: {
+        type?: string | undefined;
+        id?: string | undefined;
+        name?: string | undefined;
+    } | undefined;
+}>;

package/dist/src/activity-extensions/teamsChannelDataSettings.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.teamsChannelDataSettingsZodSchema = void 0;
+const zod_1 = require("zod");
+const channelInfo_1 = require("./channelInfo");
+/**
+ * Zod schema for validating TeamsChannelDataSettings objects.
+ */
+exports.teamsChannelDataSettingsZodSchema = zod_1.z.object({
+    selectedChannel: channelInfo_1.channelInfoZodSchema.optional()
+});
+//# sourceMappingURL=teamsChannelDataSettings.js.map

package/dist/src/activity-extensions/teamsChannelDataSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamsChannelDataSettings.js","sourceRoot":"","sources":["../../../src/activity-extensions/teamsChannelDataSettings.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AACvB,+CAAiE;AAgBjE;;GAEG;AACU,QAAA,iCAAiC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,eAAe,EAAE,kCAAoB,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAA"}

package/dist/src/activity-extensions/teamsConversationUpdateEvents.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { ConversationUpdateEvents } from '@microsoft/agents-hosting';
+/**
+ * Represents the types of conversation update events specific to Microsoft Teams.
+ * Extends the base `ConversationUpdateEvents` with additional Teams-specific events.
+ */
+export type TeamsConversationUpdateEvents = ConversationUpdateEvents | 
+/**
+ * Event triggered when a new channel is created.
+ */
+'channelCreated'
+/**
+ * Event triggered when a channel is renamed.
+ */
+ | 'channelRenamed'
+/**
+ * Event triggered when a channel is deleted.
+ */
+ | 'channelDeleted'
+/**
+ * Event triggered when a deleted channel is restored.
+ */
+ | 'channelRestored'
+/**
+ * Event triggered when a team is renamed.
+ */
+ | 'teamRenamed'
+/**
+ * Event triggered when a team is deleted.
+ */
+ | 'teamDeleted'
+/**
+ * Event triggered when a team is permanently deleted.
+ */
+ | 'teamHardDeleted'
+/**
+ * Event triggered when a team is archived.
+ */
+ | 'teamArchived'
+/**
+ * Event triggered when an archived team is unarchived.
+ */
+ | 'teamUnarchived'
+/**
+ * Event triggered when a deleted team is restored.
+ */
+ | 'teamRestored'
+/**
+ * Event triggered when the topic name is updated.
+ */
+ | 'topicName'
+/**
+ * Event triggered when the conversation history is disclosed.
+ */
+ | 'historyDisclosed';

package/dist/src/activity-extensions/teamsConversationUpdateEvents.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=teamsConversationUpdateEvents.js.map

package/dist/src/activity-extensions/teamsConversationUpdateEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamsConversationUpdateEvents.js","sourceRoot":"","sources":["../../../src/activity-extensions/teamsConversationUpdateEvents.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/src/activity-extensions/teamsMeetingInfo.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { z } from 'zod';
+/**
+ * Represents information about a Teams meeting.
+ */
+export interface TeamsMeetingInfo {
+    /**
+     * The ID of the meeting.
+     */
+    id?: string;
+}
+/**
+ * Zod schema for validating TeamsMeetingInfo objects.
+ */
+export declare const teamsMeetingInfoZodSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | undefined;
+}, {
+    id?: string | undefined;
+}>;

package/dist/src/activity-extensions/teamsMeetingInfo.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.teamsMeetingInfoZodSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Zod schema for validating TeamsMeetingInfo objects.
+ */
+exports.teamsMeetingInfoZodSchema = zod_1.z.object({
+    id: zod_1.z.string().min(1).optional()
+});
+//# sourceMappingURL=teamsMeetingInfo.js.map

package/dist/src/activity-extensions/teamsMeetingInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamsMeetingInfo.js","sourceRoot":"","sources":["../../../src/activity-extensions/teamsMeetingInfo.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAYvB;;GAEG;AACU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAA"}

package/dist/src/activity-extensions/teamsMessageEvents.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export type TeamsMessageEvents = 'undeleteMessage' | 'softDeleteMessage' | 'editMessage';

package/dist/src/activity-extensions/teamsMessageEvents.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=teamsMessageEvents.js.map

package/dist/src/activity-extensions/teamsMessageEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamsMessageEvents.js","sourceRoot":"","sources":["../../../src/activity-extensions/teamsMessageEvents.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/src/activity-extensions/tenantInfo.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { z } from 'zod';
+/**
+ * Represents information about a tenant.
+ */
+export interface TenantInfo {
+    /**
+     * The ID of the tenant.
+     */
+    id?: string;
+}
+/**
+ * Zod schema for validating TenantInfo objects.
+ */
+export declare const tenantInfoZodSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | undefined;
+}, {
+    id?: string | undefined;
+}>;

package/dist/src/activity-extensions/tenantInfo.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tenantInfoZodSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Zod schema for validating TenantInfo objects.
+ */
+exports.tenantInfoZodSchema = zod_1.z.object({
+    id: zod_1.z.string().min(1).optional()
+});
+//# sourceMappingURL=tenantInfo.js.map

package/dist/src/activity-extensions/tenantInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenantInfo.js","sourceRoot":"","sources":["../../../src/activity-extensions/tenantInfo.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAYvB;;GAEG;AACU,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAA"}

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

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export * from './teamsConnectorClient';
+export * from './teamsConnectorClient.types';

package/dist/src/client/index.js

@@ -0,0 +1,23 @@
+"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("./teamsConnectorClient"), exports);
+__exportStar(require("./teamsConnectorClient.types"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,yDAAsC;AACtC,+DAA4C"}

package/dist/src/client/teamsConnectorClient.d.ts

@@ -0,0 +1,146 @@
+import { Activity, ChannelAccount } from '@microsoft/agents-activity';
+import { TeamsChannelAccount } from '../activity-extensions/teamsChannelAccount';
+import { MeetingInfo } from '../meeting/meetingInfo';
+import { MeetingNotification } from '../meeting/meetingNotification';
+import { MeetingNotificationResponse } from '../meeting/meetingNotificationResponse';
+import { ChannelInfo } from '../activity-extensions/channelInfo';
+import { BatchFailedEntriesResponse, BatchOperationStateResponse, CancelOperationResponse, TeamDetails, TeamsBatchOperationResponse, TeamsMember, TeamsPagedMembersResult } from './teamsConnectorClient.types';
+import { ConnectorClient } from '@microsoft/agents-hosting';
+/**
+ * A client for interacting with Microsoft Teams APIs.
+ * Extends the ConnectorClient class to provide Teams-specific functionalities.
+ */
+export declare class TeamsConnectorClient {
+    private client;
+    private axiosInstance;
+    constructor(client: ConnectorClient);
+    /**
+     * Retrieves a member from a conversation or team.
+     * @param activity - The activity containing the context.
+     * @param userId - The ID of the user to retrieve.
+     * @returns A TeamsChannelAccount representing the member.
+     */
+    static getMember(activity: Activity, userId: string): Promise<TeamsChannelAccount>;
+    /**
+     * Retrieves the team ID from an activity.
+     * @param activity - The activity containing the context.
+     * @returns The team ID as a string.
+     * @throws Error if the activity is missing or invalid.
+     */
+    private static getTeamId;
+    /**
+     * Retrieves a member from a team.
+     * @param activity - The activity containing the context.
+     * @param teamId - The ID of the team.
+     * @param userId - The ID of the user to retrieve.
+     * @returns A TeamsChannelAccount representing the team member.
+     * @throws Error if the teamId or userId is missing.
+     */
+    static getTeamMember(activity: any, teamId?: string, userId?: string): Promise<ChannelAccount>;
+    /**
+     * Retrieves a member from a conversation.
+     * @param conversationId - The ID of the conversation.
+     * @param userId - The ID of the user to retrieve.
+     * @returns A ChannelAccount representing the conversation member.
+     */
+    getConversationMember(conversationId: string, userId: string): Promise<ChannelAccount>;
+    /**
+     * Retrieves a member from a conversation or team internally.
+     * @param activity - The activity containing the context.
+     * @param conversationId - The ID of the conversation.
+     * @param userId - The ID of the user to retrieve.
+     * @returns A ChannelAccount representing the member.
+     * @throws Error if the conversationId is missing or the client is unavailable.
+     */
+    static getMemberInternal(activity: any, conversationId: string | undefined, userId: string): Promise<ChannelAccount>;
+    /**
+     * Retrieves paged members of a conversation.
+     * @param conversationId - The ID of the conversation.
+     * @param pageSize - The number of members per page.
+     * @param continuationToken - The token for pagination.
+     * @returns A TeamsPagedMembersResult containing the paged members.
+     */
+    getConversationPagedMember(conversationId: string, pageSize: number, continuationToken: string): Promise<TeamsPagedMembersResult>;
+    /**
+     * Fetches the list of channels in a team.
+     * @param teamId - The ID of the team.
+     * @returns An array of ChannelInfo objects representing the channels.
+     */
+    fetchChannelList(teamId: string): Promise<ChannelInfo[]>;
+    /**
+     * Fetches the details of a team.
+     * @param teamId - The ID of the team.
+     * @returns A TeamDetails object containing the team details.
+     */
+    fetchTeamDetails(teamId: string): Promise<TeamDetails>;
+    /**
+     * Fetches information about a meeting participant.
+     * @param meetingId - The ID of the meeting.
+     * @param participantId - The ID of the participant.
+     * @param tenantId - The tenant ID.
+     * @returns A string containing participant information.
+     */
+    fetchMeetingParticipant(meetingId: string, participantId: string, tenantId: string): Promise<string>;
+    /**
+     * Fetches information about a meeting.
+     * @param meetingId - The ID of the meeting.
+     * @returns A MeetingInfo object containing the meeting information.
+     */
+    fetchMeetingInfo(meetingId: string): Promise<MeetingInfo>;
+    /**
+     * Sends a notification to a meeting.
+     * @param meetingId - The ID of the meeting.
+     * @param notification - The notification to send.
+     * @returns A MeetingNotificationResponse object containing the response.
+     */
+    sendMeetingNotification(meetingId: string, notification: MeetingNotification): Promise<MeetingNotificationResponse>;
+    /**
+     * Sends a message to a list of users.
+     * @param activity - The activity to send.
+     * @param tenantId - The tenant ID.
+     * @param members - The list of members to send the message to.
+     * @returns A TeamsBatchOperationResponse object containing the response.
+     */
+    sendMessageToListOfUsers(activity: Activity, tenantId: string, members: TeamsMember[]): Promise<TeamsBatchOperationResponse>;
+    /**
+     * Sends a message to all users in a tenant.
+     * @param activity - The activity to send.
+     * @param tenandId - The tenant ID.
+     * @returns A TeamsBatchOperationResponse object containing the response.
+     */
+    sendMessageToAllUsersInTenant(activity: Activity, tenandId: string): Promise<TeamsBatchOperationResponse>;
+    /**
+     * Sends a message to all users in a team.
+     * @param activity - The activity to send.
+     * @param tenantId - The tenant ID.
+     * @param teamId - The team ID.
+     * @returns A TeamsBatchOperationResponse object containing the response.
+     */
+    sendMessageToAllUsersInTeam(activity: Activity, tenantId: string, teamId: string): Promise<TeamsBatchOperationResponse>;
+    /**
+     * Sends a message to a list of channels.
+     * @param activity - The activity to send.
+     * @param tenantId - The tenant ID.
+     * @param members - The list of members to send the message to.
+     * @returns A TeamsBatchOperationResponse object containing the response.
+     */
+    sendMessageToListOfChannels(activity: Activity, tenantId: string, members: TeamsMember[]): Promise<TeamsBatchOperationResponse>;
+    /**
+     * Retrieves the state of a batch operation.
+     * @param operationId - The ID of the operation.
+     * @returns A BatchOperationStateResponse object containing the operation state.
+     */
+    getOperationState(operationId: string): Promise<BatchOperationStateResponse>;
+    /**
+     * Retrieves the failed entries of a batch operation.
+     * @param operationId - The ID of the operation.
+     * @returns A BatchFailedEntriesResponse object containing the failed entries.
+     */
+    getFailedEntries(operationId: string): Promise<BatchFailedEntriesResponse>;
+    /**
+     * Cancels a batch operation.
+     * @param operationId - The ID of the operation.
+     * @returns A CancelOperationResponse object containing the response.
+     */
+    cancelOperation(operationId: string): Promise<CancelOperationResponse>;
+}