teams-api 0.7.0 → 0.9.0

package/dist/actions/utility-actions.js

@@ -0,0 +1,200 @@
+"use strict";
+/**
+ * Utility action definitions.
+ *
+ * Actions: whoami, get-members, get-transcript.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTranscript = exports.whoami = exports.getMembers = void 0;
+const formatters_js_1 = require("./formatters.js");
+const conversation_resolution_js_1 = require("./conversation-resolution.js");
+exports.getMembers = {
+    name: "get-members",
+    title: "Get Conversation Members",
+    description: "List members of a conversation. " +
+        "Identify the conversation by topic name (--chat), " +
+        "person name for 1:1 chats (--to), or direct ID (--conversation-id). " +
+        "At least one identifier is required. " +
+        "Display names are resolved via the Teams profile API when available, with message history as fallback. " +
+        "Note: 1:1 chat members may have empty display names if profile resolution is unavailable.",
+    parameters: [...conversation_resolution_js_1.conversationParameters],
+    execute: async (client, parameters) => {
+        const { conversationId } = await (0, conversation_resolution_js_1.resolveConversationId)(client, parameters);
+        return client.getMembers(conversationId);
+    },
+    formatResult: (result) => {
+        const members = result;
+        const people = members.filter((member) => member.memberType === "person");
+        const bots = members.filter((member) => member.memberType === "bot");
+        const lines = [`\n${people.length} people, ${bots.length} bots:\n`];
+        for (const member of people) {
+            const name = member.displayName || "(unknown)";
+            lines.push(`  ${name} (${member.role}) — ${member.id}`);
+        }
+        if (bots.length > 0) {
+            lines.push("");
+            lines.push("  Bots/Apps:");
+            for (const bot of bots) {
+                const name = bot.displayName || "(unnamed bot)";
+                lines.push(`  ${name} — ${bot.id}`);
+            }
+        }
+        return lines.join("\n");
+    },
+    formatMarkdown: (result) => {
+        const members = result;
+        const people = members.filter((member) => member.memberType === "person");
+        const bots = members.filter((member) => member.memberType === "bot");
+        const lines = [
+            `## Members (${people.length} people, ${bots.length} bots)`,
+            "",
+        ];
+        if (people.length > 0) {
+            lines.push("| Name | Role | ID |");
+            lines.push("|------|------|----|");
+            for (const member of people) {
+                const name = member.displayName || "(unknown)";
+                lines.push(`| ${name} | ${member.role} | ${member.id} |`);
+            }
+        }
+        if (bots.length > 0) {
+            lines.push("", "### Bots/Apps", "");
+            lines.push("| Name | ID |");
+            lines.push("|------|----|");
+            for (const bot of bots) {
+                const name = bot.displayName || "(unnamed bot)";
+                lines.push(`| ${name} | ${bot.id} |`);
+            }
+        }
+        return lines.join("\n");
+    },
+    formatToon: (result) => {
+        const members = result;
+        const people = members.filter((member) => member.memberType === "person");
+        const bots = members.filter((member) => member.memberType === "bot");
+        const lines = [
+            (0, formatters_js_1.toonHeader)("👥", `${people.length} People, ${bots.length} Bots`),
+        ];
+        for (const member of people) {
+            const name = member.displayName || "(unknown)";
+            lines.push("");
+            lines.push(`  👤 ${name} · ${member.role}`);
+            lines.push(`     ${member.id}`);
+        }
+        if (bots.length > 0) {
+            lines.push("");
+            lines.push("  🤖 Bots/Apps:");
+            for (const bot of bots) {
+                const name = bot.displayName || "(unnamed bot)";
+                lines.push(`     🤖 ${name} — ${bot.id}`);
+            }
+        }
+        return lines.join("\n");
+    },
+};
+exports.whoami = {
+    name: "whoami",
+    title: "Current User Info",
+    description: "Get the display name and region of the currently authenticated user.",
+    parameters: [],
+    execute: async (client) => {
+        const displayName = await client.getCurrentUserDisplayName();
+        const token = client.getToken();
+        return { displayName, region: token.region };
+    },
+    formatResult: (result) => {
+        const { displayName, region } = result;
+        return `${displayName} (region: ${region})`;
+    },
+    formatMarkdown: (result) => {
+        const { displayName, region } = result;
+        return [`## ${displayName}`, "", `- **Region:** ${region}`].join("\n");
+    },
+    formatToon: (result) => {
+        const { displayName, region } = result;
+        return [(0, formatters_js_1.toonHeader)("🙋", displayName), `  📍 region: ${region}`].join("\n");
+    },
+};
+exports.getTranscript = {
+    name: "get-transcript",
+    title: "Get Meeting Transcript",
+    description: "Get the meeting transcript from a conversation that contains a recorded meeting. " +
+        "Identify the conversation by topic name (--chat), " +
+        "person name for 1:1 chats (--to), or direct ID (--conversation-id). " +
+        "Use --raw-vtt to get the original VTT file instead of parsed output.",
+    parameters: [
+        ...conversation_resolution_js_1.conversationParameters,
+        {
+            name: "rawVtt",
+            type: "boolean",
+            description: "Return the original VTT file content instead of parsed transcript (default: false)",
+            required: false,
+            default: false,
+        },
+    ],
+    execute: async (client, parameters) => {
+        const { conversationId } = await (0, conversation_resolution_js_1.resolveConversationId)(client, parameters);
+        const rawVtt = parameters.rawVtt ?? false;
+        const transcriptResult = await client.getTranscript(conversationId);
+        if (rawVtt) {
+            return { rawVtt: transcriptResult.rawVtt, format: "vtt" };
+        }
+        return transcriptResult;
+    },
+    formatResult: (result) => {
+        const data = result;
+        if ("format" in data && data.format === "vtt") {
+            return data.rawVtt;
+        }
+        const transcript = data;
+        const groups = (0, formatters_js_1.groupBySpeaker)(transcript.entries);
+        const lines = [
+            `\nTranscript: ${transcript.meetingTitle} (${transcript.entries.length} segments)\n`,
+        ];
+        for (const group of groups) {
+            const time = (0, formatters_js_1.formatTimestamp)(group.startTime);
+            lines.push(`  [${time}] ${group.speaker}:`);
+            lines.push(`    ${group.segments.join(" ")}`);
+        }
+        return lines.join("\n");
+    },
+    formatMarkdown: (result) => {
+        const data = result;
+        if ("format" in data && data.format === "vtt") {
+            return ["```vtt", data.rawVtt, "```"].join("\n");
+        }
+        const transcript = data;
+        const groups = (0, formatters_js_1.groupBySpeaker)(transcript.entries);
+        const lines = [
+            `## Transcript: ${transcript.meetingTitle}`,
+            "",
+            `*${transcript.entries.length} segments*`,
+            "",
+        ];
+        for (const group of groups) {
+            const time = (0, formatters_js_1.formatTimestamp)(group.startTime);
+            lines.push(`**${group.speaker}** *(${time})*`, "");
+            lines.push(group.segments.join(" "), "");
+        }
+        return lines.join("\n");
+    },
+    formatToon: (result) => {
+        const data = result;
+        if ("format" in data && data.format === "vtt") {
+            return data.rawVtt;
+        }
+        const transcript = data;
+        const groups = (0, formatters_js_1.groupBySpeaker)(transcript.entries);
+        const lines = [
+            (0, formatters_js_1.toonHeader)("🎙️", `Transcript: ${transcript.meetingTitle} (${transcript.entries.length} segments)`),
+        ];
+        for (const group of groups) {
+            const time = (0, formatters_js_1.formatTimestamp)(group.startTime);
+            lines.push("");
+            lines.push(`  🗣️  ${group.speaker} · ${time}`);
+            lines.push(`      ${group.segments.join(" ")}`);
+        }
+        return lines.join("\n");
+    },
+};
+//# sourceMappingURL=utility-actions.js.map

package/dist/actions/utility-actions.js.map

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

package/dist/api/attachments.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Attachment parsing and download utilities for Teams messages.
+ *
+ * Handles two types of attachments:
+ * - Inline images (AMS) — embedded as `<img>` tags in message HTML
+ * - File attachments (SharePoint) — referenced in `properties.files` JSON
+ */
+import type { TeamsToken, ImageAttachment, FileAttachment } from "../types.js";
+/**
+ * Extract inline image attachments from message HTML content.
+ *
+ * Parses `<img>` tags with `itemtype="http://schema.skype.com/AMSImage"` and
+ * extracts the AMS object ID, URL, and dimensions from the tag attributes.
+ */
+export declare function parseInlineImages(content: string): ImageAttachment[];
+/**
+ * Parse file attachments from the raw `properties.files` JSON string.
+ *
+ * File attachments are SharePoint-hosted documents, videos, and other files
+ * shared through Teams. They have a separate schema from inline images.
+ */
+export declare function parseFileAttachments(rawFiles: unknown): FileAttachment[];
+/**
+ * Fetch an image from the AMS (Async Media Service).
+ *
+ * Returns the raw binary data and content type. Uses the skype token
+ * for authentication (same pattern as transcript fetching).
+ *
+ * @param view - AMS view name: "imgo" (compressed), "imgpsh_fullsize_anim" (full-size)
+ */
+export declare function fetchAmsImage(token: TeamsToken, amsObjectId: string, view?: "imgo" | "imgpsh_fullsize_anim"): Promise<{
+    data: Buffer;
+    contentType: string;
+    size: number;
+}>;
+/**
+ * Upload an image to the AMS (Async Media Service).
+ *
+ * Creates a new AMS object with permissions for the target conversation,
+ * uploads the image data, and returns the object ID that can be referenced
+ * in message HTML via `<img>` tags.
+ *
+ * Requires the AMS/IC3 Bearer token (audience: ic3.teams.office.com), not the
+ * middle-tier bearer or skype token.
+ */
+export declare function uploadAmsImage(token: TeamsToken, imageData: Buffer, fileName: string, conversationId: string): Promise<{
+    amsObjectId: string;
+}>;
+/** Response from SharePoint file upload. */
+export interface SharePointUploadResult {
+    /** SharePoint item unique ID. */
+    itemId: string;
+    /** SharePoint site ID. */
+    siteId: string;
+    /** File name (may differ from input if conflict-renamed). */
+    fileName: string;
+    /** File extension without dot. */
+    fileType: string;
+    /** Direct SharePoint file URL. */
+    fileUrl: string;
+    /** WebDAV URL for the file. */
+    webDavUrl: string;
+    /** SharePoint site base URL. */
+    siteBaseUrl: string;
+    /** SharePoint personal site path segment (e.g. "/personal/user_domain_com/"). */
+    personalPath: string;
+}
+/**
+ * Upload a file to SharePoint OneDrive for Business (Teams Chat Files folder).
+ *
+ * Files shared in Teams conversations are stored in the sender's OneDrive
+ * under "Microsoft Teams Chat Files". This function uploads a file there
+ * using the SharePoint REST API, matching the same flow the Teams web client uses.
+ *
+ * @param email - The sender's corporate email (used to derive the personal site path)
+ */
+export declare function uploadSharePointFile(token: TeamsToken, fileData: Buffer, fileName: string, email: string): Promise<SharePointUploadResult>;
+/**
+ * Build the `properties.files` JSON string for a message with file attachments.
+ *
+ * This JSON is included in the message body when sending messages with
+ * SharePoint-hosted file attachments.
+ */
+export declare function buildFilesPropertyJson(uploadResults: SharePointUploadResult[]): string;
+/**
+ * Build an HTML `<img>` tag for an AMS-hosted image.
+ *
+ * This produces the same markup that the Teams web client generates.
+ */
+export declare function buildAmsImageTag(amsObjectId: string, width?: number, height?: number): string;
+/**
+ * Download a file attachment from SharePoint.
+ *
+ * File attachments in Teams are hosted on SharePoint (OneDrive for Business).
+ * This function downloads the file content using the SharePoint REST API
+ * and the captured SharePoint bearer token.
+ *
+ * @param fileUrl - Direct SharePoint URL from `FileAttachment.fileUrl`
+ */
+export declare function fetchSharePointFile(token: TeamsToken, fileUrl: string, itemId: string): Promise<{
+    data: Buffer;
+    contentType: string;
+    size: number;
+    fileName: string;
+}>;
+//# sourceMappingURL=attachments.d.ts.map

package/dist/api/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/api/attachments.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAW/E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAuCpE;AAiBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,EAAE,CA6BxE;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,MAAM,GAAG,sBAA+B,GAC7C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB9D;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAiElC;AAED,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAC;CACtB;AA6BD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,sBAAsB,CAAC,CA6DjC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,sBAAsB,EAAE,GACtC,MAAM,CAiCR;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAKR;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CA+CD"}

package/dist/api/attachments.js

@@ -0,0 +1,341 @@
+"use strict";
+/**
+ * Attachment parsing and download utilities for Teams messages.
+ *
+ * Handles two types of attachments:
+ * - Inline images (AMS) — embedded as `<img>` tags in message HTML
+ * - File attachments (SharePoint) — referenced in `properties.files` JSON
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseInlineImages = parseInlineImages;
+exports.parseFileAttachments = parseFileAttachments;
+exports.fetchAmsImage = fetchAmsImage;
+exports.uploadAmsImage = uploadAmsImage;
+exports.uploadSharePointFile = uploadSharePointFile;
+exports.buildFilesPropertyJson = buildFilesPropertyJson;
+exports.buildAmsImageTag = buildAmsImageTag;
+exports.fetchSharePointFile = fetchSharePointFile;
+const common_js_1 = require("./common.js");
+const AMS_BASE = "https://as-prod.asyncgw.teams.microsoft.com/v1/objects";
+/**
+ * Teams client version header required by the AMS API.
+ * AMS uses this to determine the "platform id" and rejects requests without it.
+ */
+const AMS_CLIENT_VERSION = "1415/26022704215";
+/**
+ * Extract inline image attachments from message HTML content.
+ *
+ * Parses `<img>` tags with `itemtype="http://schema.skype.com/AMSImage"` and
+ * extracts the AMS object ID, URL, and dimensions from the tag attributes.
+ */
+function parseInlineImages(content) {
+    const images = [];
+    const imagePattern = /<img\s+[^>]*itemtype="http:\/\/schema\.skype\.com\/AMSImage"[^>]*>/gi;
+    let match;
+    while ((match = imagePattern.exec(content)) !== null) {
+        const tag = match[0];
+        const contentPosition = match.index;
+        const srcMatch = tag.match(/src="([^"]+)"/);
+        if (!srcMatch)
+            continue;
+        const url = srcMatch[1];
+        const amsIdMatch = url.match(/\/objects\/([^/]+)\//);
+        if (!amsIdMatch)
+            continue;
+        const amsObjectId = amsIdMatch[1];
+        let width = null;
+        let height = null;
+        const widthMatch = tag.match(/width:(\d+)px/);
+        const heightMatch = tag.match(/height:(\d+)px/);
+        if (widthMatch)
+            width = Number(widthMatch[1]);
+        if (heightMatch)
+            height = Number(heightMatch[1]);
+        const fullSizeUrl = `${AMS_BASE}/${amsObjectId}/views/imgpsh_fullsize_anim`;
+        images.push({
+            amsObjectId,
+            url,
+            fullSizeUrl,
+            width,
+            height,
+            contentPosition,
+        });
+    }
+    return images;
+}
+/**
+ * Parse file attachments from the raw `properties.files` JSON string.
+ *
+ * File attachments are SharePoint-hosted documents, videos, and other files
+ * shared through Teams. They have a separate schema from inline images.
+ */
+function parseFileAttachments(rawFiles) {
+    let entries;
+    if (typeof rawFiles === "string") {
+        try {
+            entries = JSON.parse(rawFiles);
+        }
+        catch {
+            return [];
+        }
+    }
+    else if (Array.isArray(rawFiles)) {
+        entries = rawFiles;
+    }
+    else {
+        return [];
+    }
+    if (!Array.isArray(entries))
+        return [];
+    return entries
+        .filter((entry) => entry["@type"] === "http://schema.skype.com/File" && entry.fileName)
+        .map((entry) => ({
+        itemId: entry.itemid ?? entry.id ?? "",
+        fileName: entry.fileName ?? entry.title ?? "",
+        fileType: entry.fileType ?? "",
+        fileUrl: entry.fileInfo?.fileUrl ?? entry.objectUrl ?? "",
+        shareUrl: entry.fileInfo?.shareUrl ?? "",
+    }));
+}
+/**
+ * Fetch an image from the AMS (Async Media Service).
+ *
+ * Returns the raw binary data and content type. Uses the skype token
+ * for authentication (same pattern as transcript fetching).
+ *
+ * @param view - AMS view name: "imgo" (compressed), "imgpsh_fullsize_anim" (full-size)
+ */
+async function fetchAmsImage(token, amsObjectId, view = "imgo") {
+    const url = `${AMS_BASE}/${amsObjectId}/views/${view}`;
+    const response = await (0, common_js_1.fetchWithRetry)(url, {
+        headers: {
+            Authorization: `skype_token ${token.skypeToken}`,
+        },
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new common_js_1.ApiAuthError(`AMS image fetch authentication failed: ${response.status} ${response.statusText}`);
+        }
+        throw new Error(`Failed to fetch AMS image: ${response.status} ${response.statusText}`);
+    }
+    const contentType = response.headers.get("content-type") ?? "image/jpeg";
+    const arrayBuffer = await response.arrayBuffer();
+    const data = Buffer.from(arrayBuffer);
+    return { data, contentType, size: data.length };
+}
+/**
+ * Upload an image to the AMS (Async Media Service).
+ *
+ * Creates a new AMS object with permissions for the target conversation,
+ * uploads the image data, and returns the object ID that can be referenced
+ * in message HTML via `<img>` tags.
+ *
+ * Requires the AMS/IC3 Bearer token (audience: ic3.teams.office.com), not the
+ * middle-tier bearer or skype token.
+ */
+async function uploadAmsImage(token, imageData, fileName, conversationId) {
+    if (!token.amsToken) {
+        throw new Error("AMS token is required for image upload but was not captured during authentication.");
+    }
+    // Step 1: Create the AMS object with inline permissions
+    const createResponse = await (0, common_js_1.fetchWithRetry)(`${AMS_BASE}/`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${token.amsToken}`,
+            "Content-Type": "application/json",
+            "x-ms-client-version": AMS_CLIENT_VERSION,
+        },
+        body: JSON.stringify({
+            type: "pish/image",
+            permissions: { [conversationId]: ["read"] },
+            sharingMode: "Attached",
+            filename: fileName,
+        }),
+    });
+    if (!createResponse.ok) {
+        if (createResponse.status === 401) {
+            throw new common_js_1.ApiAuthError(`AMS object creation failed: ${createResponse.status} ${createResponse.statusText}`);
+        }
+        const errorText = await createResponse.text();
+        throw new Error(`Failed to create AMS object: ${createResponse.status} ${createResponse.statusText} — ${errorText}`);
+    }
+    const createData = (await createResponse.json());
+    const amsObjectId = createData.id;
+    // Step 2: Upload the image content to the fixed "imgpsh" content path
+    const uploadResponse = await (0, common_js_1.fetchWithRetry)(`${AMS_BASE}/${amsObjectId}/content/imgpsh`, {
+        method: "PUT",
+        headers: {
+            Authorization: `Bearer ${token.amsToken}`,
+            "Content-Type": "application/octet-stream",
+            "x-ms-client-version": AMS_CLIENT_VERSION,
+        },
+        body: imageData,
+    });
+    if (!uploadResponse.ok) {
+        if (uploadResponse.status === 401) {
+            throw new common_js_1.ApiAuthError(`AMS image upload failed: ${uploadResponse.status} ${uploadResponse.statusText}`);
+        }
+        const errorText = await uploadResponse.text();
+        throw new Error(`Failed to upload AMS image: ${uploadResponse.status} ${uploadResponse.statusText} — ${errorText}`);
+    }
+    return { amsObjectId };
+}
+/**
+ * Derive the SharePoint personal site URL components from a token and email.
+ *
+ * The SharePoint host comes from `token.sharePointHost` (captured from the
+ * MSAL cache during authentication).
+ * The personal path is derived from the email by replacing `.` and `@` with `_`.
+ */
+function deriveSharePointSiteInfo(token, email) {
+    if (!token.sharePointHost) {
+        throw new Error("SharePoint host is required for file upload but was not captured during authentication. " +
+            "Re-authenticate to capture the SharePoint host.");
+    }
+    const siteBaseUrl = `https://${token.sharePointHost}`;
+    // email "user.name@company.com" → "user_name_company_com"
+    const personalSegment = email.replace(/[.@]/g, "_");
+    const personalPath = `/personal/${personalSegment}`;
+    return { siteBaseUrl, personalPath };
+}
+/**
+ * Upload a file to SharePoint OneDrive for Business (Teams Chat Files folder).
+ *
+ * Files shared in Teams conversations are stored in the sender's OneDrive
+ * under "Microsoft Teams Chat Files". This function uploads a file there
+ * using the SharePoint REST API, matching the same flow the Teams web client uses.
+ *
+ * @param email - The sender's corporate email (used to derive the personal site path)
+ */
+async function uploadSharePointFile(token, fileData, fileName, email) {
+    if (!token.sharePointToken) {
+        throw new Error("SharePoint token is required for file upload but was not captured during authentication. " +
+            "Re-authenticate to capture the SharePoint token.");
+    }
+    const { siteBaseUrl, personalPath } = deriveSharePointSiteInfo(token, email);
+    const encodedFileName = encodeURIComponent(fileName);
+    const uploadUrl = `${siteBaseUrl}${personalPath}/_api/v2.0/drive/root:/Microsoft%20Teams%20Chat%20Files/${encodedFileName}:/content` +
+        `?@name.conflictBehavior=rename&$select=*,sharepointIds,webDavUrl`;
+    const response = await (0, common_js_1.fetchWithRetry)(uploadUrl, {
+        method: "PUT",
+        headers: {
+            Authorization: `Bearer ${token.sharePointToken}`,
+            "Content-Type": "application/octet-stream",
+        },
+        body: fileData,
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new common_js_1.ApiAuthError(`SharePoint file upload authentication failed: ${response.status} ${response.statusText}`);
+        }
+        const errorText = await response.text();
+        throw new Error(`Failed to upload file to SharePoint: ${response.status} ${response.statusText} — ${errorText}`);
+    }
+    const data = (await response.json());
+    const fileExtension = data.name.includes(".")
+        ? (data.name.split(".").pop() ?? "")
+        : "";
+    return {
+        itemId: data.sharepointIds.listItemUniqueId,
+        siteId: data.sharepointIds.siteId,
+        fileName: data.name,
+        fileType: fileExtension,
+        fileUrl: data.webUrl,
+        webDavUrl: data.webDavUrl,
+        siteBaseUrl,
+        personalPath,
+    };
+}
+/**
+ * Build the `properties.files` JSON string for a message with file attachments.
+ *
+ * This JSON is included in the message body when sending messages with
+ * SharePoint-hosted file attachments.
+ */
+function buildFilesPropertyJson(uploadResults) {
+    const files = uploadResults.map((result) => ({
+        "@type": "http://schema.skype.com/File",
+        version: 2,
+        id: result.itemId,
+        itemid: result.itemId,
+        fileName: result.fileName,
+        fileType: result.fileType,
+        title: result.fileName,
+        type: result.fileType,
+        state: "active",
+        objectUrl: `${result.siteBaseUrl}${result.personalPath}/Documents/Microsoft%20Teams%20Chat%20Files/${encodeURIComponent(result.fileName)}`,
+        baseUrl: `${result.siteBaseUrl}${result.personalPath}/`,
+        permissionScope: "users",
+        sharepointIds: {
+            listItemUniqueId: result.itemId,
+            siteId: result.siteId,
+        },
+        fileInfo: {
+            itemId: null,
+            fileUrl: `${result.siteBaseUrl}${result.personalPath}/Documents/Microsoft%20Teams%20Chat%20Files/${encodeURIComponent(result.fileName)}`,
+            siteUrl: `${result.siteBaseUrl}${result.personalPath}/`,
+            serverRelativeUrl: `${result.personalPath}/Documents/Microsoft Teams Chat Files/${result.fileName}`,
+            shareUrl: null,
+            shareId: null,
+        },
+        fileChicletState: {
+            serviceName: "p2p",
+            state: "active",
+        },
+    }));
+    return JSON.stringify(files);
+}
+/**
+ * Build an HTML `<img>` tag for an AMS-hosted image.
+ *
+ * This produces the same markup that the Teams web client generates.
+ */
+function buildAmsImageTag(amsObjectId, width, height) {
+    const src = `${AMS_BASE}/${amsObjectId}/views/imgo`;
+    const styleAttribute = width && height ? ` style="width:${width}px; height:${height}px"` : "";
+    return `<img src="${src}" itemscope="" itemtype="http://schema.skype.com/AMSImage"${styleAttribute}>`;
+}
+/**
+ * Download a file attachment from SharePoint.
+ *
+ * File attachments in Teams are hosted on SharePoint (OneDrive for Business).
+ * This function downloads the file content using the SharePoint REST API
+ * and the captured SharePoint bearer token.
+ *
+ * @param fileUrl - Direct SharePoint URL from `FileAttachment.fileUrl`
+ */
+async function fetchSharePointFile(token, fileUrl, itemId) {
+    if (!token.sharePointToken) {
+        throw new Error("SharePoint token is required for file download but was not captured during authentication. " +
+            "Re-authenticate to capture the SharePoint token.");
+    }
+    // Extract the SharePoint site base URL and the personal site path from fileUrl.
+    // fileUrl looks like: https://tenant-my.sharepoint.com/personal/user_name_company_com/Documents/...
+    const parsedUrl = new URL(fileUrl);
+    const siteBaseUrl = `${parsedUrl.protocol}//${parsedUrl.host}`;
+    const pathSegments = decodeURIComponent(parsedUrl.pathname).split("/");
+    // pathSegments: ['', 'personal', 'user_name_company_com', 'Documents', ...]
+    const personalPath = `/${pathSegments[1]}/${pathSegments[2]}`;
+    // Use the SharePoint drive items API with the item's unique ID.
+    // This avoids path-encoding issues with special characters in filenames,
+    // and works for files on any user's personal OneDrive.
+    const downloadUrl = `${siteBaseUrl}${personalPath}/_api/v2.0/drive/items/${itemId}/content`;
+    const response = await (0, common_js_1.fetchWithRetry)(downloadUrl, {
+        headers: {
+            Authorization: `Bearer ${token.sharePointToken}`,
+        },
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new common_js_1.ApiAuthError(`SharePoint file download authentication failed: ${response.status} ${response.statusText}`);
+        }
+        throw new Error(`Failed to download SharePoint file: ${response.status} ${response.statusText}`);
+    }
+    const contentType = response.headers.get("content-type") ?? "application/octet-stream";
+    const arrayBuffer = await response.arrayBuffer();
+    const data = Buffer.from(arrayBuffer);
+    // Extract filename from the original file URL path
+    const fileName = pathSegments[pathSegments.length - 1] ?? "unknown";
+    return { data, contentType, size: data.length, fileName };
+}
+//# sourceMappingURL=attachments.js.map