feat(outlook-mail): request meeting-message type and expand event iCalUId

Widens the Graph mail client's $select to include meetingMessageType and
meetingRequestType, and adds $expand=event($select=iCalUId) to the initial
conversation and folder-page queries, so callers can detect calendar
meeting messages and their event UID. Downstream consumption of these
fields is left for a follow-up change.

Author: KrisBraun

connectors/outlook-mail/src/graph-mail-api.test.ts

@@ -1,6 +1,7 @@
 import { describe, expect, it } from "vitest";
 import {
   conversationSource,
+  GraphMailApi,
   isConversationFlagged,
   isConversationUnread,
   isViaRewrittenName,
@@ -177,3 +178,38 @@ describe("small helpers", () => {
     expect(conversationSource("A@B.com", "c1")).toBe("outlook-mail:a@b.com:c1");
   });
 });
+
+describe("GraphMailApi queries", () => {
+  it("getConversationMessages requests meeting fields + expands event", async () => {
+    const calls: Array<Record<string, string> | undefined> = [];
+    const api = new GraphMailApi("tok");
+    api.call = async (
+      _method: string,
+      _url: string,
+      params?: Record<string, string>
+    ) => {
+      calls.push(params);
+      return { value: [] };
+    };
+    await api.getConversationMessages("conv-1");
+    expect(calls[0]?.$select).toContain("meetingMessageType");
+    expect(calls[0]?.$select).toContain("meetingRequestType");
+    expect(calls[0]?.$expand).toBe("event($select=iCalUId)");
+  });
+
+  it("getMessagesPage requests meeting fields + expands event on the non-nextLink branch", async () => {
+    const calls: Array<Record<string, string> | undefined> = [];
+    const api = new GraphMailApi("tok");
+    api.call = async (
+      _method: string,
+      _url: string,
+      params?: Record<string, string>
+    ) => {
+      calls.push(params);
+      return { value: [] };
+    };
+    await api.getMessagesPage({ folderId: "f-inbox" });
+    expect(calls[0]?.$select).toContain("meetingMessageType");
+    expect(calls[0]?.$expand).toBe("event($select=iCalUId)");
+  });
+});

connectors/outlook-mail/src/graph-mail-api.ts

@@ -39,6 +39,10 @@ export type GraphMessage = {
   hasAttachments?: boolean;
   webLink?: string;
   internetMessageHeaders?: GraphHeader[];
+  "@odata.type"?: string;
+  meetingMessageType?: string;
+  meetingRequestType?: string;
+  event?: { iCalUId?: string };
 };
 
 export type GraphMailFolder = {
@@ -139,6 +143,8 @@ export const MESSAGE_SELECT = [
   "parentFolderId",
   "hasAttachments",
   "webLink",
+  "meetingMessageType",
+  "meetingRequestType",
 ].join(",");
 
 /** Upload-session chunk size: 10 × 320 KiB (Graph requires 320 KiB multiples). */
@@ -251,6 +257,7 @@ export class GraphMailApi {
         $top: String(args.top ?? 20),
         $orderby: "receivedDateTime desc",
         $select: MESSAGE_SELECT,
+        $expand: "event($select=iCalUId)",
       };
       if (args.since) {
         params.$filter = `receivedDateTime ge ${args.since.toISOString()}`;
@@ -292,6 +299,7 @@ export class GraphMailApi {
       $filter: `conversationId eq ${odataQuote(conversationId)}`,
       $top: "100",
       $select: MESSAGE_SELECT,
+      $expand: "event($select=iCalUId)",
     });
     for (let page = 0; page < 5; page++) {
       messages.push(...((data?.value as GraphMessage[] | undefined) ?? []));