@kodelyth/msteams 2026.5.42 → 2026.6.1

package/src/attachments/graph.ts

@@ -1,489 +0,0 @@
-import { fetchWithSsrFGuard, type SsrFPolicy } from "klaw/plugin-sdk/ssrf-runtime";
-import {
-  normalizeLowercaseStringOrEmpty,
-  normalizeOptionalLowercaseString,
-  normalizeOptionalString,
-} from "klaw/plugin-sdk/string-coerce-runtime";
-import { getMSTeamsRuntime } from "../runtime.js";
-import { ensureUserAgentHeader } from "../user-agent.js";
-import { downloadMSTeamsAttachments } from "./download.js";
-import { downloadAndStoreMSTeamsRemoteMedia } from "./remote-media.js";
-import {
-  applyAuthorizationHeaderForUrl,
-  encodeGraphShareId,
-  GRAPH_ROOT,
-  estimateBase64DecodedBytes,
-  inferPlaceholder,
-  readNestedString,
-  isUrlAllowed,
-  type MSTeamsAttachmentDownloadLogger,
-  type MSTeamsAttachmentFetchPolicy,
-  type MSTeamsAttachmentResolveFn,
-  normalizeContentType,
-  resolveMediaSsrfPolicy,
-  resolveAttachmentFetchPolicy,
-  resolveRequestUrl,
-  safeFetchWithPolicy,
-} from "./shared.js";
-import type {
-  MSTeamsAccessTokenProvider,
-  MSTeamsAttachmentLike,
-  MSTeamsGraphMediaLogger,
-  MSTeamsGraphMediaResult,
-  MSTeamsInboundMedia,
-} from "./types.js";
-
-type GraphHostedContent = {
-  id?: string | null;
-  contentType?: string | null;
-  contentBytes?: string | null;
-};
-
-type GraphAttachment = {
-  id?: string | null;
-  contentType?: string | null;
-  contentUrl?: string | null;
-  name?: string | null;
-  thumbnailUrl?: string | null;
-  content?: unknown;
-};
-
-export function buildMSTeamsGraphMessageUrls(params: {
-  conversationType?: string | null;
-  conversationId?: string | null;
-  messageId?: string | null;
-  replyToId?: string | null;
-  conversationMessageId?: string | null;
-  channelData?: unknown;
-}): string[] {
-  const conversationType = normalizeLowercaseStringOrEmpty(params.conversationType ?? "");
-  const messageIdCandidates = new Set<string>();
-  const pushCandidate = (value: string | null | undefined) => {
-    const trimmed = normalizeOptionalString(value) ?? "";
-    if (trimmed) {
-      messageIdCandidates.add(trimmed);
-    }
-  };
-
-  pushCandidate(params.messageId);
-  pushCandidate(params.conversationMessageId);
-  pushCandidate(readNestedString(params.channelData, ["messageId"]));
-  pushCandidate(readNestedString(params.channelData, ["teamsMessageId"]));
-
-  const replyToId = normalizeOptionalString(params.replyToId) ?? "";
-
-  if (conversationType === "channel") {
-    const teamId =
-      readNestedString(params.channelData, ["team", "id"]) ??
-      readNestedString(params.channelData, ["teamId"]);
-    const channelId =
-      readNestedString(params.channelData, ["channel", "id"]) ??
-      readNestedString(params.channelData, ["channelId"]) ??
-      readNestedString(params.channelData, ["teamsChannelId"]);
-    if (!teamId || !channelId) {
-      return [];
-    }
-    const urls: string[] = [];
-    if (replyToId) {
-      for (const candidate of messageIdCandidates) {
-        if (candidate === replyToId) {
-          continue;
-        }
-        urls.push(
-          `${GRAPH_ROOT}/teams/${encodeURIComponent(teamId)}/channels/${encodeURIComponent(channelId)}/messages/${encodeURIComponent(replyToId)}/replies/${encodeURIComponent(candidate)}`,
-        );
-      }
-    }
-    if (messageIdCandidates.size === 0 && replyToId) {
-      messageIdCandidates.add(replyToId);
-    }
-    for (const candidate of messageIdCandidates) {
-      urls.push(
-        `${GRAPH_ROOT}/teams/${encodeURIComponent(teamId)}/channels/${encodeURIComponent(channelId)}/messages/${encodeURIComponent(candidate)}`,
-      );
-    }
-    return Array.from(new Set(urls));
-  }
-
-  const chatId = params.conversationId?.trim() || readNestedString(params.channelData, ["chatId"]);
-  if (!chatId) {
-    return [];
-  }
-  if (messageIdCandidates.size === 0 && replyToId) {
-    messageIdCandidates.add(replyToId);
-  }
-  const urls = Array.from(messageIdCandidates).map(
-    (candidate) =>
-      `${GRAPH_ROOT}/chats/${encodeURIComponent(chatId)}/messages/${encodeURIComponent(candidate)}`,
-  );
-  return Array.from(new Set(urls));
-}
-
-async function fetchGraphCollection(params: {
-  url: string;
-  accessToken: string;
-  fetchFn?: typeof fetch;
-  ssrfPolicy?: SsrFPolicy;
-}): Promise<{ status: number; items: unknown[] }> {
-  const fetchFn = params.fetchFn ?? fetch;
-  const { response, release } = await fetchWithSsrFGuard({
-    url: params.url,
-    fetchImpl: fetchFn,
-    init: {
-      headers: ensureUserAgentHeader({ Authorization: `Bearer ${params.accessToken}` }),
-    },
-    policy: params.ssrfPolicy,
-    auditContext: "msteams.graph.collection",
-  });
-  try {
-    const status = response.status;
-    if (!response.ok) {
-      return { status, items: [] };
-    }
-    try {
-      const data = (await response.json()) as { value?: unknown[] };
-      return { status, items: Array.isArray(data.value) ? data.value : [] };
-    } catch {
-      return { status, items: [] };
-    }
-  } finally {
-    await release();
-  }
-}
-
-function normalizeGraphAttachment(att: GraphAttachment): MSTeamsAttachmentLike {
-  let content: unknown = att.content;
-  if (typeof content === "string") {
-    try {
-      content = JSON.parse(content);
-    } catch {
-      // Keep as raw string if it's not JSON.
-    }
-  }
-  return {
-    contentType: normalizeContentType(att.contentType) ?? undefined,
-    contentUrl: att.contentUrl ?? undefined,
-    name: att.name ?? undefined,
-    thumbnailUrl: att.thumbnailUrl ?? undefined,
-    content,
-  };
-}
-
-/**
- * Download all hosted content from a Teams message (images, documents, etc.).
- * Renamed from downloadGraphHostedImages to support all file types.
- */
-async function downloadGraphHostedContent(params: {
-  accessToken: string;
-  messageUrl: string;
-  maxBytes: number;
-  fetchFn?: typeof fetch;
-  preserveFilenames?: boolean;
-  ssrfPolicy?: SsrFPolicy;
-  logger?: MSTeamsAttachmentDownloadLogger;
-}): Promise<{ media: MSTeamsInboundMedia[]; status: number; count: number }> {
-  const hosted = (await fetchGraphCollection({
-    url: `${params.messageUrl}/hostedContents`,
-    accessToken: params.accessToken,
-    fetchFn: params.fetchFn,
-    ssrfPolicy: params.ssrfPolicy,
-  })) as { status: number; items: GraphHostedContent[] };
-  if (hosted.items.length === 0) {
-    return { media: [], status: hosted.status, count: 0 };
-  }
-
-  const out: MSTeamsInboundMedia[] = [];
-  for (const item of hosted.items) {
-    const contentBytes = typeof item.contentBytes === "string" ? item.contentBytes : "";
-    let buffer: Buffer;
-    if (contentBytes) {
-      if (estimateBase64DecodedBytes(contentBytes) > params.maxBytes) {
-        continue;
-      }
-      try {
-        buffer = Buffer.from(contentBytes, "base64");
-      } catch (err) {
-        params.logger?.warn?.("msteams graph hostedContent base64 decode failed", {
-          error: err instanceof Error ? err.message : String(err),
-        });
-        continue;
-      }
-    } else if (item.id) {
-      // contentBytes not inline — fetch from the individual $value endpoint.
-      try {
-        const valueUrl = `${params.messageUrl}/hostedContents/${encodeURIComponent(item.id)}/$value`;
-        const { response: valRes, release } = await fetchWithSsrFGuard({
-          url: valueUrl,
-          fetchImpl: params.fetchFn ?? fetch,
-          init: {
-            headers: ensureUserAgentHeader({ Authorization: `Bearer ${params.accessToken}` }),
-          },
-          policy: params.ssrfPolicy,
-          auditContext: "msteams.graph.hostedContent.value",
-        });
-        try {
-          if (!valRes.ok) {
-            continue;
-          }
-          const saved = await getMSTeamsRuntime().channel.media.saveResponseMedia(valRes, {
-            sourceUrl: valueUrl,
-            maxBytes: params.maxBytes,
-            fallbackContentType: item.contentType ?? undefined,
-            subdir: "inbound",
-          });
-          out.push({
-            path: saved.path,
-            contentType: saved.contentType,
-            placeholder: inferPlaceholder({ contentType: saved.contentType }),
-          });
-        } finally {
-          await release();
-        }
-      } catch (err) {
-        params.logger?.warn?.("msteams graph hostedContent value fetch failed", {
-          error: err instanceof Error ? err.message : String(err),
-        });
-        continue;
-      }
-      continue;
-    } else {
-      continue;
-    }
-    if (buffer.byteLength > params.maxBytes) {
-      continue;
-    }
-    const mime = await getMSTeamsRuntime().media.detectMime({
-      buffer,
-      headerMime: item.contentType ?? undefined,
-    });
-    // Download any file type, not just images
-    try {
-      const saved = await getMSTeamsRuntime().channel.media.saveMediaBuffer(
-        buffer,
-        mime ?? item.contentType ?? undefined,
-        "inbound",
-        params.maxBytes,
-      );
-      out.push({
-        path: saved.path,
-        contentType: saved.contentType,
-        placeholder: inferPlaceholder({ contentType: saved.contentType }),
-      });
-    } catch (err) {
-      params.logger?.warn?.("msteams graph hostedContent save failed", {
-        error: err instanceof Error ? err.message : String(err),
-      });
-    }
-  }
-
-  return { media: out, status: hosted.status, count: hosted.items.length };
-}
-
-export async function downloadMSTeamsGraphMedia(params: {
-  messageUrl?: string | null;
-  tokenProvider?: MSTeamsAccessTokenProvider;
-  maxBytes: number;
-  allowHosts?: string[];
-  authAllowHosts?: string[];
-  fetchFn?: typeof fetch;
-  resolveFn?: MSTeamsAttachmentResolveFn;
-  /** When true, embeds original filename in stored path for later extraction. */
-  preserveFilenames?: boolean;
-  /** Optional logger used to surface Graph/SharePoint fetch errors. */
-  logger?: MSTeamsAttachmentDownloadLogger;
-  /** Back-compat diagnostic logger used by older tests/callers. */
-  log?: MSTeamsGraphMediaLogger;
-}): Promise<MSTeamsGraphMediaResult> {
-  if (!params.messageUrl || !params.tokenProvider) {
-    return { media: [] };
-  }
-  const policy: MSTeamsAttachmentFetchPolicy = resolveAttachmentFetchPolicy({
-    allowHosts: params.allowHosts,
-    authAllowHosts: params.authAllowHosts,
-  });
-  const ssrfPolicy = resolveMediaSsrfPolicy(policy.allowHosts);
-  const messageUrl = params.messageUrl;
-  const debugLog =
-    params.log ?? (params.logger as MSTeamsGraphMediaLogger | undefined) ?? undefined;
-  let accessToken: string;
-  try {
-    accessToken = await params.tokenProvider.getAccessToken("https://graph.microsoft.com");
-  } catch (err) {
-    debugLog?.debug?.("graph media token acquisition failed", {
-      messageUrl,
-      error: err instanceof Error ? err.message : String(err),
-    });
-    params.logger?.warn?.("msteams graph token acquisition failed", {
-      error: err instanceof Error ? err.message : String(err),
-    });
-    return { media: [], messageUrl, tokenError: true };
-  }
-
-  const fetchFn = params.fetchFn ?? fetch;
-  const sharePointMedia: MSTeamsInboundMedia[] = [];
-  const downloadedReferenceUrls = new Set<string>();
-  let messageAttachments: GraphAttachment[] = [];
-  let messageStatus: number | undefined;
-  try {
-    const { response: msgRes, release } = await fetchWithSsrFGuard({
-      url: messageUrl,
-      fetchImpl: fetchFn,
-      init: {
-        headers: ensureUserAgentHeader({ Authorization: `Bearer ${accessToken}` }),
-      },
-      policy: ssrfPolicy,
-      auditContext: "msteams.graph.message",
-    });
-    try {
-      messageStatus = msgRes.status;
-      if (msgRes.ok) {
-        let msgData: {
-          body?: { content?: string; contentType?: string };
-          attachments?: GraphAttachment[];
-        };
-        try {
-          msgData = (await msgRes.json()) as typeof msgData;
-        } catch (err) {
-          debugLog?.debug?.("graph media message parse failed", {
-            messageUrl,
-            error: err instanceof Error ? err.message : String(err),
-          });
-          params.logger?.warn?.("msteams graph message parse failed", {
-            error: err instanceof Error ? err.message : String(err),
-            messageUrl,
-          });
-          msgData = {};
-        }
-        messageAttachments = Array.isArray(msgData.attachments) ? msgData.attachments : [];
-
-        const spAttachments = messageAttachments.filter(
-          (a) => a.contentType === "reference" && a.contentUrl && a.name,
-        );
-        for (const att of spAttachments) {
-          const name = att.name ?? "file";
-          const shareUrl = att.contentUrl ?? "";
-          if (!shareUrl) {
-            continue;
-          }
-
-          try {
-            const sharesUrl = `${GRAPH_ROOT}/shares/${encodeGraphShareId(shareUrl)}/driveItem/content`;
-            if (!isUrlAllowed(sharesUrl, policy.allowHosts)) {
-              debugLog?.debug?.("graph media sharepoint url not in allowHosts", {
-                messageUrl,
-                sharesUrl,
-              });
-              continue;
-            }
-
-            const media = await downloadAndStoreMSTeamsRemoteMedia({
-              url: sharesUrl,
-              filePathHint: name,
-              maxBytes: params.maxBytes,
-              contentTypeHint: "application/octet-stream",
-              preserveFilenames: params.preserveFilenames,
-              ssrfPolicy,
-              useDirectFetch: true,
-              fetchImpl: async (input, init) => {
-                const requestUrl = resolveRequestUrl(input);
-                const headers = ensureUserAgentHeader(init?.headers);
-                applyAuthorizationHeaderForUrl({
-                  headers,
-                  url: requestUrl,
-                  authAllowHosts: policy.authAllowHosts,
-                  bearerToken: accessToken,
-                });
-                return await safeFetchWithPolicy({
-                  url: requestUrl,
-                  policy,
-                  fetchFn,
-                  requestInit: {
-                    ...init,
-                    headers,
-                  },
-                  resolveFn: params.resolveFn,
-                });
-              },
-            });
-            sharePointMedia.push(media);
-            downloadedReferenceUrls.add(shareUrl);
-          } catch (err) {
-            params.logger?.warn?.("msteams SharePoint reference download failed", {
-              error: err instanceof Error ? err.message : String(err),
-              name,
-            });
-          }
-        }
-      } else {
-        debugLog?.debug?.("graph media message fetch not ok", {
-          messageUrl,
-          status: messageStatus,
-        });
-      }
-    } finally {
-      await release();
-    }
-  } catch (err) {
-    debugLog?.debug?.("graph media message fetch failed", {
-      messageUrl,
-      error: err instanceof Error ? err.message : String(err),
-    });
-    params.logger?.warn?.("msteams graph message fetch failed", {
-      error: err instanceof Error ? err.message : String(err),
-    });
-  }
-
-  const hosted = await downloadGraphHostedContent({
-    accessToken,
-    messageUrl,
-    maxBytes: params.maxBytes,
-    fetchFn: params.fetchFn,
-    preserveFilenames: params.preserveFilenames,
-    ssrfPolicy,
-    logger: params.logger,
-  });
-
-  const normalizedAttachments = messageAttachments.map(normalizeGraphAttachment);
-  const filteredAttachments =
-    sharePointMedia.length > 0
-      ? normalizedAttachments.filter((att) => {
-          const contentType = normalizeOptionalLowercaseString(att.contentType);
-          if (contentType !== "reference") {
-            return true;
-          }
-          const url = typeof att.contentUrl === "string" ? att.contentUrl : "";
-          if (!url) {
-            return true;
-          }
-          return !downloadedReferenceUrls.has(url);
-        })
-      : normalizedAttachments;
-  let attachmentMedia: MSTeamsInboundMedia[] = [];
-  try {
-    attachmentMedia = await downloadMSTeamsAttachments({
-      attachments: filteredAttachments,
-      maxBytes: params.maxBytes,
-      tokenProvider: params.tokenProvider,
-      allowHosts: policy.allowHosts,
-      authAllowHosts: policy.authAllowHosts,
-      fetchFn: params.fetchFn,
-      resolveFn: params.resolveFn,
-      preserveFilenames: params.preserveFilenames,
-      logger: params.logger,
-    });
-  } catch (err) {
-    params.logger?.warn?.("msteams graph attachment download failed", {
-      error: err instanceof Error ? err.message : String(err),
-      messageUrl,
-    });
-  }
-
-  return {
-    media: [...sharePointMedia, ...hosted.media, ...attachmentMedia],
-    hostedCount: hosted.count,
-    attachmentCount: filteredAttachments.length + sharePointMedia.length,
-    hostedStatus: hosted.status,
-    attachmentStatus: messageStatus,
-    messageUrl,
-  };
-}

package/src/attachments/html.ts

@@ -1,122 +0,0 @@
-import {
-  ATTACHMENT_TAG_RE,
-  extractHtmlFromAttachment,
-  extractInlineImageCandidates,
-  IMG_SRC_RE,
-  isLikelyImageAttachment,
-  safeHostForUrl,
-} from "./shared.js";
-import type { MSTeamsAttachmentLike, MSTeamsHtmlAttachmentSummary } from "./types.js";
-
-/**
- * Extract every `<attachment id="...">` reference from the HTML attachments in
- * the inbound activity. Returns the complete (non-sliced) list; callers that
- * need a capped diagnostic summary can truncate after calling this helper.
- */
-export function extractMSTeamsHtmlAttachmentIds(
-  attachments: MSTeamsAttachmentLike[] | undefined,
-): string[] {
-  const list = Array.isArray(attachments) ? attachments : [];
-  if (list.length === 0) {
-    return [];
-  }
-  const ids = new Set<string>();
-  for (const att of list) {
-    const html = extractHtmlFromAttachment(att);
-    if (!html) {
-      continue;
-    }
-    ATTACHMENT_TAG_RE.lastIndex = 0;
-    let match: RegExpExecArray | null = ATTACHMENT_TAG_RE.exec(html);
-    while (match) {
-      const id = match[1]?.trim();
-      if (id) {
-        ids.add(id);
-      }
-      match = ATTACHMENT_TAG_RE.exec(html);
-    }
-  }
-  return Array.from(ids);
-}
-
-export function summarizeMSTeamsHtmlAttachments(
-  attachments: MSTeamsAttachmentLike[] | undefined,
-): MSTeamsHtmlAttachmentSummary | undefined {
-  const list = Array.isArray(attachments) ? attachments : [];
-  if (list.length === 0) {
-    return undefined;
-  }
-  let htmlAttachments = 0;
-  let imgTags = 0;
-  let dataImages = 0;
-  let cidImages = 0;
-  const srcHosts = new Set<string>();
-  let attachmentTags = 0;
-  const attachmentIds = new Set<string>();
-
-  for (const att of list) {
-    const html = extractHtmlFromAttachment(att);
-    if (!html) {
-      continue;
-    }
-    htmlAttachments += 1;
-    IMG_SRC_RE.lastIndex = 0;
-    let match: RegExpExecArray | null = IMG_SRC_RE.exec(html);
-    while (match) {
-      imgTags += 1;
-      const src = match[1]?.trim();
-      if (src) {
-        if (src.startsWith("data:")) {
-          dataImages += 1;
-        } else if (src.startsWith("cid:")) {
-          cidImages += 1;
-        } else {
-          srcHosts.add(safeHostForUrl(src));
-        }
-      }
-      match = IMG_SRC_RE.exec(html);
-    }
-
-    ATTACHMENT_TAG_RE.lastIndex = 0;
-    let attachmentMatch: RegExpExecArray | null = ATTACHMENT_TAG_RE.exec(html);
-    while (attachmentMatch) {
-      attachmentTags += 1;
-      const id = attachmentMatch[1]?.trim();
-      if (id) {
-        attachmentIds.add(id);
-      }
-      attachmentMatch = ATTACHMENT_TAG_RE.exec(html);
-    }
-  }
-
-  if (htmlAttachments === 0) {
-    return undefined;
-  }
-  return {
-    htmlAttachments,
-    imgTags,
-    dataImages,
-    cidImages,
-    srcHosts: Array.from(srcHosts).slice(0, 5),
-    attachmentTags,
-    attachmentIds: Array.from(attachmentIds).slice(0, 5),
-  };
-}
-
-export function buildMSTeamsAttachmentPlaceholder(
-  attachments: MSTeamsAttachmentLike[] | undefined,
-  limits?: { maxInlineBytes?: number; maxInlineTotalBytes?: number },
-): string {
-  const list = Array.isArray(attachments) ? attachments : [];
-  if (list.length === 0) {
-    return "";
-  }
-  const imageCount = list.filter(isLikelyImageAttachment).length;
-  const inlineCount = extractInlineImageCandidates(list, limits).length;
-  const totalImages = imageCount + inlineCount;
-  if (totalImages > 0) {
-    return `<media:image>${totalImages > 1 ? ` (${totalImages} images)` : ""}`;
-  }
-  const count = list.length;
-  return `<media:document>${count > 1 ? ` (${count} files)` : ""}`;
-}

package/src/attachments/payload.ts

@@ -1,14 +0,0 @@
-import { buildMediaPayload } from "../../runtime-api.js";
-
-export function buildMSTeamsMediaPayload(
-  mediaList: Array<{ path: string; contentType?: string }>,
-): {
-  MediaPath?: string;
-  MediaType?: string;
-  MediaUrl?: string;
-  MediaPaths?: string[];
-  MediaUrls?: string[];
-  MediaTypes?: string[];
-} {
-  return buildMediaPayload(mediaList, { preserveMediaTypeCardinality: true });
-}