@auxee/piece-ms-teams-transcripts 0.0.2 → 0.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auxee/piece-ms-teams-transcripts",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Microsoft Teams meeting transcript monitoring and retrieval using MS Graph API with client credentials",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -14,7 +14,18 @@
     "@activepieces/pieces-common": "0.8.2",
     "@activepieces/pieces-framework": "0.20.3",
     "@activepieces/shared": "0.26.2",
-    "tslib": "^2.6.2"
+    "@sinclair/typebox": "0.34.11",
+    "axios": "1.13.1",
+    "axios-retry": "4.4.1",
+    "deepmerge-ts": "7.1.0",
+    "mime-types": "2.1.35",
+    "nanoid": "3.3.8",
+    "semver": "7.6.0",
+    "socket.io-client": "4.8.1",
+    "tslib": "^2.6.2",
+    "zod": "4.1.13"
+  },
+  "resolutions": {
+    "rollup": "npm:@rollup/wasm-node"
   }
-}
-
+}

package/src/actions/fetch-transcript.action.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Fetch Transcript Action
+ *
+ * Downloads and processes a Microsoft Teams meeting transcript.
+ *
+ * DESIGNED TO WORK WITH TRIGGER OUTPUT:
+ * This action consumes the output from the "Transcript Generated" trigger.
+ * The meetingId and transcriptId are passed automatically from the trigger.
+ *
+ * How it works:
+ * 1. Receives meetingId and transcriptId from trigger output
+ * 2. Fetches transcript content from Microsoft Graph API
+ * 3. Parses and cleans the transcript content
+ * 4. Returns clean text and optional structured segments
+ *
+ * API Endpoint:
+ * GET /communications/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content
+ *
+ * Required Permissions (Application):
+ * - OnlineMeetingTranscript.Read.All
+ */
+/**
+ * The main action definition
+ *
+ * This action is designed to consume output from the Transcript Generated trigger.
+ * The meetingId and transcriptId are passed automatically.
+ */
+export declare const fetchTranscriptAction: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").PieceAuthProperty, {
+    meetingId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    transcriptId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    meetingSubject: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    startDateTime: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    includeRawContent: import("@activepieces/pieces-framework").CheckboxProperty<false>;
+    includeSegments: import("@activepieces/pieces-framework").CheckboxProperty<false>;
+}>;

package/src/actions/fetch-transcript.action.js

@@ -0,0 +1,255 @@
+"use strict";
+/**
+ * Fetch Transcript Action
+ *
+ * Downloads and processes a Microsoft Teams meeting transcript.
+ *
+ * DESIGNED TO WORK WITH TRIGGER OUTPUT:
+ * This action consumes the output from the "Transcript Generated" trigger.
+ * The meetingId and transcriptId are passed automatically from the trigger.
+ *
+ * How it works:
+ * 1. Receives meetingId and transcriptId from trigger output
+ * 2. Fetches transcript content from Microsoft Graph API
+ * 3. Parses and cleans the transcript content
+ * 4. Returns clean text and optional structured segments
+ *
+ * API Endpoint:
+ * GET /communications/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content
+ *
+ * Required Permissions (Application):
+ * - OnlineMeetingTranscript.Read.All
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchTranscriptAction = void 0;
+const tslib_1 = require("tslib");
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const graph_token_1 = require("../utils/graph-token");
+const ms_teams_app_auth_1 = require("../auth/ms-teams-app-auth");
+/**
+ * Parses VTT (WebVTT) content into segments
+ *
+ * VTT format example:
+ * WEBVTT
+ *
+ * 00:00:00.000 --> 00:00:05.000
+ * <v John Doe>Hello everyone, welcome to the meeting.</v>
+ *
+ * 00:00:05.000 --> 00:00:10.000
+ * <v Jane Smith>Thanks John, let's get started.</v>
+ */
+const parseVttContent = (vttContent) => {
+    const segments = [];
+    const lines = vttContent.split('\n');
+    let currentTimestamp = '';
+    let currentSpeaker = '';
+    let currentText = '';
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        // Skip WEBVTT header and empty lines
+        if (trimmedLine === 'WEBVTT' || trimmedLine === '' || trimmedLine.startsWith('NOTE')) {
+            // If we have accumulated content, save it
+            if (currentText && currentSpeaker) {
+                segments.push({
+                    speaker: currentSpeaker,
+                    text: currentText.trim(),
+                    timestamp: currentTimestamp,
+                });
+                currentText = '';
+            }
+            continue;
+        }
+        // Check if this is a timestamp line (00:00:00.000 --> 00:00:05.000)
+        if (trimmedLine.includes('-->')) {
+            currentTimestamp = trimmedLine.split('-->')[0].trim();
+            continue;
+        }
+        // Check if this line contains speaker info in <v Speaker Name> format
+        const speakerMatch = trimmedLine.match(/<v\s+([^>]+)>(.+?)(?:<\/v>|$)/);
+        if (speakerMatch) {
+            // Save previous segment if exists
+            if (currentText && currentSpeaker) {
+                segments.push({
+                    speaker: currentSpeaker,
+                    text: currentText.trim(),
+                    timestamp: currentTimestamp,
+                });
+            }
+            currentSpeaker = speakerMatch[1].trim();
+            currentText = speakerMatch[2].replace(/<\/v>$/, '').trim();
+        }
+        else if (currentSpeaker) {
+            // Continuation of current speaker's text
+            currentText += ' ' + trimmedLine.replace(/<\/?v[^>]*>/g, '');
+        }
+        else {
+            // Text without speaker - try to extract or use "Unknown"
+            const textWithoutTags = trimmedLine.replace(/<\/?v[^>]*>/g, '').trim();
+            if (textWithoutTags) {
+                segments.push({
+                    speaker: 'Unknown',
+                    text: textWithoutTags,
+                    timestamp: currentTimestamp,
+                });
+            }
+        }
+    }
+    // Don't forget the last segment
+    if (currentText && currentSpeaker) {
+        segments.push({
+            speaker: currentSpeaker,
+            text: currentText.trim(),
+            timestamp: currentTimestamp,
+        });
+    }
+    return segments;
+};
+/**
+ * Cleans and normalizes transcript text
+ * Removes HTML/VTT tags, normalizes whitespace, etc.
+ */
+const cleanTranscriptText = (rawContent) => {
+    return rawContent
+        // Remove WEBVTT header
+        .replace(/^WEBVTT\s*/i, '')
+        // Remove NOTE lines
+        .replace(/^NOTE\s.*$/gm, '')
+        // Remove timestamp lines
+        .replace(/^\d{2}:\d{2}:\d{2}\.\d{3}\s*-->\s*\d{2}:\d{2}:\d{2}\.\d{3}.*$/gm, '')
+        // Remove VTT voice tags but keep content
+        .replace(/<v\s+[^>]+>/g, '')
+        .replace(/<\/v>/g, '')
+        // Remove other HTML-like tags
+        .replace(/<[^>]+>/g, '')
+        // Normalize whitespace
+        .replace(/\s+/g, ' ')
+        // Remove leading/trailing whitespace
+        .trim();
+};
+/**
+ * Converts segments to clean plain text with speaker labels
+ */
+const segmentsToPlainText = (segments) => {
+    const textParts = [];
+    let lastSpeaker = '';
+    for (const segment of segments) {
+        if (segment.speaker !== lastSpeaker) {
+            textParts.push(`\n${segment.speaker}: ${segment.text}`);
+            lastSpeaker = segment.speaker;
+        }
+        else {
+            textParts.push(segment.text);
+        }
+    }
+    return textParts.join(' ').trim();
+};
+/**
+ * The main action definition
+ *
+ * This action is designed to consume output from the Transcript Generated trigger.
+ * The meetingId and transcriptId are passed automatically.
+ */
+exports.fetchTranscriptAction = (0, pieces_framework_1.createAction)({
+    name: 'fetch_transcript',
+    displayName: 'Fetch Transcript',
+    description: 'Fetches the content of a Microsoft Teams meeting transcript. ' +
+        'Connect this to the Transcript Generated trigger to automatically process new transcripts.',
+    props: {
+        meetingId: pieces_framework_1.Property.ShortText({
+            displayName: 'Meeting ID',
+            description: 'The meeting ID from the Transcript Generated trigger. ' +
+                'Use: {{trigger.meetingId}}',
+            required: true,
+        }),
+        transcriptId: pieces_framework_1.Property.ShortText({
+            displayName: 'Transcript ID',
+            description: 'The transcript ID from the Transcript Generated trigger. ' +
+                'Use: {{trigger.transcriptId}}',
+            required: true,
+        }),
+        meetingSubject: pieces_framework_1.Property.ShortText({
+            displayName: 'Meeting Subject',
+            description: 'Optional: Pass the meeting subject from trigger for reference. ' +
+                'Use: {{trigger.meetingSubject}}',
+            required: false,
+        }),
+        startDateTime: pieces_framework_1.Property.ShortText({
+            displayName: 'Meeting Date',
+            description: 'Optional: Pass the meeting date from trigger for reference. ' +
+                'Use: {{trigger.startDateTime}}',
+            required: false,
+        }),
+        includeRawContent: pieces_framework_1.Property.Checkbox({
+            displayName: 'Include Raw VTT Content',
+            description: 'If enabled, includes the raw VTT content in the output.',
+            required: false,
+            defaultValue: false,
+        }),
+        includeSegments: pieces_framework_1.Property.Checkbox({
+            displayName: 'Include Parsed Segments',
+            description: 'If enabled, includes parsed segments with speaker/text/timestamp.',
+            required: false,
+            defaultValue: false,
+        }),
+    },
+    run(ctx) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            // Validate environment variables
+            (0, ms_teams_app_auth_1.validateMSTeamsEnv)();
+            const { meetingId, transcriptId, meetingSubject, startDateTime, includeRawContent, includeSegments } = ctx.propsValue;
+            // Fetch transcript content from Graph API using app-level endpoint
+            // GET /communications/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content
+            const endpoint = `/communications/onlineMeetings/${meetingId}/transcripts/${transcriptId}/content?$format=text/vtt`;
+            const response = yield (0, graph_token_1.graphRequest)(endpoint, {
+                method: 'GET',
+                headers: {
+                    Accept: 'text/vtt',
+                },
+            });
+            if (!response.ok) {
+                const errorText = yield response.text();
+                throw new Error(`Failed to fetch transcript: ${response.status} - ${errorText}`);
+            }
+            const rawContent = yield response.text();
+            const contentType = response.headers.get('content-type') || '';
+            // Parse the content
+            let content;
+            let segments;
+            if (contentType.includes('text/vtt') || rawContent.startsWith('WEBVTT')) {
+                // Parse VTT format
+                const parsedSegments = parseVttContent(rawContent);
+                content = segmentsToPlainText(parsedSegments);
+                if (includeSegments) {
+                    segments = parsedSegments;
+                }
+            }
+            else {
+                // Fallback: treat as plain text
+                content = cleanTranscriptText(rawContent);
+                if (includeSegments) {
+                    segments = [{
+                            speaker: 'Unknown',
+                            text: content,
+                        }];
+                }
+            }
+            // Build output
+            const output = {
+                meetingId,
+                transcriptId,
+                content,
+                meetingSubject: meetingSubject || undefined,
+                meetingDate: startDateTime || undefined,
+            };
+            // Include optional fields
+            if (includeRawContent) {
+                output.rawContent = rawContent;
+            }
+            if (includeSegments && segments) {
+                output.segments = segments;
+            }
+            return output;
+        });
+    },
+});
+//# sourceMappingURL=fetch-transcript.action.js.map

package/src/actions/fetch-transcript.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-transcript.action.js","sourceRoot":"","sources":["../../../../../../../packages/pieces/custom/ms-teams-transcripts/src/actions/fetch-transcript.action.ts"],"names":[],"mappings":"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"}

package/src/actions/send-message.action.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Send Message Action (Stub)
+ *
+ * Sends a message to a Microsoft Teams channel or chat.
+ * This is a stub implementation that can be extended for full functionality.
+ *
+ * How it works:
+ * 1. Takes team ID, channel ID, and message content as input
+ * 2. Sends message via Microsoft Graph API
+ * 3. Returns the sent message details
+ *
+ * Required Permissions (Application):
+ * - ChannelMessage.Send - To send messages to channels
+ * - Chat.ReadWrite.All - To send messages to chats (if extended)
+ *
+ * Graph API Endpoints:
+ * - Channel: POST /teams/{teamId}/channels/{channelId}/messages
+ * - Chat: POST /chats/{chatId}/messages
+ */
+/**
+ * The main action definition
+ */
+export declare const sendMessageAction: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").PieceAuthProperty, {
+    teamId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    channelId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    message: import("@activepieces/pieces-framework").LongTextProperty<true>;
+    contentType: import("@activepieces/pieces-framework").StaticDropdownProperty<string, false>;
+    subject: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+}>;

package/src/actions/send-message.action.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Send Message Action (Stub)
+ *
+ * Sends a message to a Microsoft Teams channel or chat.
+ * This is a stub implementation that can be extended for full functionality.
+ *
+ * How it works:
+ * 1. Takes team ID, channel ID, and message content as input
+ * 2. Sends message via Microsoft Graph API
+ * 3. Returns the sent message details
+ *
+ * Required Permissions (Application):
+ * - ChannelMessage.Send - To send messages to channels
+ * - Chat.ReadWrite.All - To send messages to chats (if extended)
+ *
+ * Graph API Endpoints:
+ * - Channel: POST /teams/{teamId}/channels/{channelId}/messages
+ * - Chat: POST /chats/{chatId}/messages
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendMessageAction = void 0;
+const tslib_1 = require("tslib");
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const graph_token_1 = require("../utils/graph-token");
+const ms_teams_app_auth_1 = require("../auth/ms-teams-app-auth");
+/**
+ * The main action definition
+ */
+exports.sendMessageAction = (0, pieces_framework_1.createAction)({
+    name: 'send_message',
+    displayName: 'Send Message',
+    description: 'Sends a message to a Microsoft Teams channel. ' +
+        'Supports plain text and HTML formatted messages.',
+    props: {
+        teamId: pieces_framework_1.Property.ShortText({
+            displayName: 'Team ID',
+            description: 'The unique identifier of the Microsoft Teams team. ' +
+                'You can find this in the Teams URL or via Graph API.',
+            required: true,
+        }),
+        channelId: pieces_framework_1.Property.ShortText({
+            displayName: 'Channel ID',
+            description: 'The unique identifier of the channel within the team. ' +
+                'You can find this in the Teams URL or via Graph API.',
+            required: true,
+        }),
+        message: pieces_framework_1.Property.LongText({
+            displayName: 'Message Content',
+            description: 'The message content to send. Supports plain text or HTML. ' +
+                'For HTML, include tags like <b>, <i>, <a>, etc.',
+            required: true,
+        }),
+        contentType: pieces_framework_1.Property.StaticDropdown({
+            displayName: 'Content Type',
+            description: 'The format of the message content.',
+            required: false,
+            defaultValue: 'text',
+            options: {
+                disabled: false,
+                options: [
+                    { label: 'Plain Text', value: 'text' },
+                    { label: 'HTML', value: 'html' },
+                ],
+            },
+        }),
+        subject: pieces_framework_1.Property.ShortText({
+            displayName: 'Subject (Optional)',
+            description: 'Optional subject line for the message. ' +
+                'Shows as a bold header above the message content.',
+            required: false,
+        }),
+    },
+    run(ctx) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            // Validate environment variables
+            (0, ms_teams_app_auth_1.validateMSTeamsEnv)();
+            const { teamId, channelId, message, contentType, subject } = ctx.propsValue;
+            // Build the message payload
+            const messagePayload = {
+                body: {
+                    content: message,
+                    contentType: contentType === 'html' ? 'html' : 'text',
+                },
+            };
+            // Add subject if provided
+            if (subject) {
+                messagePayload.subject = subject;
+            }
+            // Send the message
+            const endpoint = `/teams/${teamId}/channels/${channelId}/messages`;
+            try {
+                const response = yield (0, graph_token_1.graphPost)(endpoint, messagePayload);
+                return {
+                    success: true,
+                    messageId: response.id,
+                    createdAt: response.createdDateTime,
+                    webUrl: response.webUrl,
+                    content: response.body.content,
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                // Provide helpful error messages
+                if (errorMessage.includes('403')) {
+                    throw new Error('Permission denied. Ensure the app has ChannelMessage.Send permission ' +
+                        'and is installed in the target team.');
+                }
+                if (errorMessage.includes('404')) {
+                    throw new Error('Team or channel not found. Please verify the Team ID and Channel ID are correct.');
+                }
+                throw new Error(`Failed to send message: ${errorMessage}`);
+            }
+        });
+    },
+});
+//# sourceMappingURL=send-message.action.js.map

package/src/actions/send-message.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-message.action.js","sourceRoot":"","sources":["../../../../../../../packages/pieces/custom/ms-teams-transcripts/src/actions/send-message.action.ts"],"names":[],"mappings":"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"}

package/src/auth/ms-teams-app-auth.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Microsoft Teams App Authentication Module
+ *
+ * This module handles reading MS Teams credentials from environment variables.
+ * All credentials are stored as environment variables for security.
+ *
+ * Required Environment Variables:
+ * - MS_TEAMS_TENANT_ID: Your Azure AD tenant ID
+ * - MS_TEAMS_CLIENT_ID: The app registration client ID (Application ID)
+ * - MS_TEAMS_CLIENT_SECRET: The app registration client secret value
+ */
+export interface MSTeamsAuth {
+    tenantId: string;
+    clientId: string;
+    clientSecret: string;
+}
+/**
+ * Gets MS Teams authentication credentials from environment variables.
+ * These are fixed per deployment and not exposed to end users.
+ */
+export declare const getMSTeamsAuth: () => MSTeamsAuth;
+/**
+ * Validates that all required environment variables are present.
+ * Throws descriptive error if any are missing.
+ */
+export declare const validateMSTeamsEnv: () => void;

package/src/auth/ms-teams-app-auth.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Microsoft Teams App Authentication Module
+ *
+ * This module handles reading MS Teams credentials from environment variables.
+ * All credentials are stored as environment variables for security.
+ *
+ * Required Environment Variables:
+ * - MS_TEAMS_TENANT_ID: Your Azure AD tenant ID
+ * - MS_TEAMS_CLIENT_ID: The app registration client ID (Application ID)
+ * - MS_TEAMS_CLIENT_SECRET: The app registration client secret value
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateMSTeamsEnv = exports.getMSTeamsAuth = void 0;
+/**
+ * Reads an environment variable, throwing an error if required and missing
+ */
+const readEnv = (key, required = true) => {
+    const val = process.env[key];
+    if (required && !val) {
+        throw new Error(`Missing required environment variable: ${key}. ` +
+            `Please set this in your deployment configuration.`);
+    }
+    return val || '';
+};
+/**
+ * Gets MS Teams authentication credentials from environment variables.
+ * These are fixed per deployment and not exposed to end users.
+ */
+const getMSTeamsAuth = () => {
+    return {
+        tenantId: readEnv('MS_TEAMS_TENANT_ID'),
+        clientId: readEnv('MS_TEAMS_CLIENT_ID'),
+        clientSecret: readEnv('MS_TEAMS_CLIENT_SECRET'),
+    };
+};
+exports.getMSTeamsAuth = getMSTeamsAuth;
+/**
+ * Validates that all required environment variables are present.
+ * Throws descriptive error if any are missing.
+ */
+const validateMSTeamsEnv = () => {
+    const required = [
+        'MS_TEAMS_TENANT_ID',
+        'MS_TEAMS_CLIENT_ID',
+        'MS_TEAMS_CLIENT_SECRET',
+    ];
+    const missing = required.filter((key) => !process.env[key]);
+    if (missing.length > 0) {
+        throw new Error(`Missing required environment variables: ${missing.join(', ')}. ` +
+            `Please configure these for MS Teams integration.`);
+    }
+};
+exports.validateMSTeamsEnv = validateMSTeamsEnv;
+//# sourceMappingURL=ms-teams-app-auth.js.map

package/src/auth/ms-teams-app-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ms-teams-app-auth.js","sourceRoot":"","sources":["../../../../../../../packages/pieces/custom/ms-teams-transcripts/src/auth/ms-teams-app-auth.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAQH;;GAEG;AACH,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,QAAQ,GAAG,IAAI,EAAU,EAAE;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,0CAA0C,GAAG,IAAI;YACjD,mDAAmD,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,IAAI,EAAE,CAAC;AACnB,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,cAAc,GAAG,GAAgB,EAAE;IAC9C,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,oBAAoB,CAAC;QACvC,QAAQ,EAAE,OAAO,CAAC,oBAAoB,CAAC;QACvC,YAAY,EAAE,OAAO,CAAC,wBAAwB,CAAC;KAChD,CAAC;AACJ,CAAC,CAAC;AANW,QAAA,cAAc,kBAMzB;AAEF;;;GAGG;AACI,MAAM,kBAAkB,GAAG,GAAS,EAAE;IAC3C,MAAM,QAAQ,GAAG;QACf,oBAAoB;QACpB,oBAAoB;QACpB,wBAAwB;KACzB,CAAC;IAEF,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAE5D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,2CAA2C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACjE,kDAAkD,CACnD,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAfW,QAAA,kBAAkB,sBAe7B"}

package/src/{index.ts → index.d.ts}

@@ -1,75 +1,51 @@
 /**
  * Microsoft Teams Transcripts Piece
- * 
+ *
  * A custom piece for monitoring and fetching Microsoft Teams meeting transcripts
  * using Microsoft Graph API with client credentials authentication.
- * 
+ *
  * ═══════════════════════════════════════════════════════════════════════════
  * CONFIGURATION (Environment Variables)
  * ═══════════════════════════════════════════════════════════════════════════
- * 
+ *
  * This piece requires the following environment variables:
- * 
+ *
  * MS_TEAMS_TENANT_ID     - Your Azure AD tenant ID
- * MS_TEAMS_CLIENT_ID     - App registration client ID  
+ * MS_TEAMS_CLIENT_ID     - App registration client ID
  * MS_TEAMS_CLIENT_SECRET - App registration client secret
  * MS_TEAMS_USER_IDS      - (Optional) Comma-separated list of user IDs to monitor
- * 
+ *
  * These are fixed per deployment and not exposed to end users.
- * 
+ *
  * ═══════════════════════════════════════════════════════════════════════════
  * AZURE APP REGISTRATION REQUIREMENTS
  * ═══════════════════════════════════════════════════════════════════════════
- * 
+ *
  * The app registration needs these Microsoft Graph API permissions (Application):
  * - OnlineMeetingTranscript.Read.All - To read meeting transcripts
  * - OnlineMeetings.Read.All - To list online meetings
  * - User.Read.All - To enumerate users for meeting discovery
  * - ChannelMessage.Send (optional) - To send Teams messages
- * 
+ *
  * ═══════════════════════════════════════════════════════════════════════════
  * AVAILABLE TRIGGER
  * ═══════════════════════════════════════════════════════════════════════════
- * 
+ *
  * Transcript Generated
  * - Polls for new meeting transcripts
  * - Triggers once per new transcript
  * - Uses transcript ID for deduplication
- * 
+ *
  * ═══════════════════════════════════════════════════════════════════════════
  * AVAILABLE ACTIONS
  * ═══════════════════════════════════════════════════════════════════════════
- * 
+ *
  * Fetch Transcript
  * - Downloads transcript content for a specific meeting
  * - Returns clean text and structured segments
- * 
+ *
  * Send Message (stub)
  * - Send a message to a Teams channel or chat
- * 
+ *
  */
-
-import { PieceAuth, createPiece } from '@activepieces/pieces-framework';
-import { PieceCategory } from '@activepieces/shared';
-import { transcriptGeneratedTrigger } from './triggers/transcript-generated.trigger';
-import { meetingsWebhookTrigger } from './triggers/meetings-webhook.trigger';
-import { fetchTranscriptAction } from './actions/fetch-transcript.action';
-import { sendMessageAction } from './actions/send-message.action';
-
-export const msTeamsTranscripts = createPiece({
-  displayName: 'MS Teams Transcripts',
-  description:
-    'Monitor Microsoft Teams meetings for new transcripts and fetch transcript content. ' +
-    'Uses client credentials flow for application-level access.',
-  minimumSupportedRelease: '0.63.0',
-  logoUrl: 'https://cdn.activepieces.com/pieces/microsoft-teams.png',
-  categories: [PieceCategory.COMMUNICATION, PieceCategory.PRODUCTIVITY],
-  
-  // No user-facing auth - credentials come from environment variables
-  auth: PieceAuth.None(),
-  
-  actions: [fetchTranscriptAction, sendMessageAction],
-  triggers: [transcriptGeneratedTrigger, meetingsWebhookTrigger],
-  authors: ['auxee'],
-});
-
+export declare const msTeamsTranscripts: import("@activepieces/pieces-framework").Piece<import("@activepieces/pieces-framework").PieceAuthProperty>;