// VA-P23 · Microsoft Graph change-notification webhook (M09 Block D). PUBLIC // endpoint. Two contracts: // 1. Validation handshake: Graph POSTs ?validationToken=… and expects the // token echoed back as text/plain 200 within 10 seconds. // 2. Notifications: each item carries the per-mailbox `clientState` secret — // the ONLY auth mechanism — which must equal the stored value on the // mailbox the subscription id resolves to. Mismatches are ack'd without // persisting (a non-2xx would make Graph retry + eventually kill the // subscription). Valid items are persisted `pending`; the worker drain // cron runs the per-folder delta sync. import { type ActionFunctionArgs } from "react-router"; import { resolveMicrosoftMailboxRlsIdentity } from "@hivegrid/db/rls-resolvers.server"; import { runWithRlsContext } from "@hivegrid/db/rls-context.server"; import { getMicrosoftWebhookMailbox, recordEmailWebhookEvent } from "~/modules/emailInbox/db/emailInbox.db.server"; const ACCEPTED = new Response(null, { status: 202 }); const MAX_GRAPH_NOTIFICATIONS_PER_REQUEST = 100; const MAX_GRAPH_SUBSCRIPTION_ID_LENGTH = 256; const MAX_GRAPH_CLIENT_STATE_LENGTH = 1_024; interface GraphNotification { subscriptionId?: string; clientState?: string; changeType?: string; resource?: string; resourceData?: { id?: string }; } export const action = async ({ request }: ActionFunctionArgs) => { if (request.method !== "POST") { return new Response(null, { status: 405 }); } // 1) Subscription validation handshake — echo the token as text/plain. const validationToken = new URL(request.url).searchParams.get("validationToken"); if (validationToken) { return new Response(validationToken, { status: 200, headers: { "content-type": "text/plain" } }); } let body: { value?: GraphNotification[] }; try { body = (await request.json()) as { value?: GraphNotification[] }; } catch { return ACCEPTED; } const notifications = body.value; if (!Array.isArray(notifications) || notifications.length > MAX_GRAPH_NOTIFICATIONS_PER_REQUEST) { return ACCEPTED; } for (const notification of notifications) { if ( !notification || typeof notification !== "object" || Array.isArray(notification) || typeof notification.subscriptionId !== "string" || notification.subscriptionId.length === 0 || notification.subscriptionId.length > MAX_GRAPH_SUBSCRIPTION_ID_LENGTH || typeof notification.clientState !== "string" || notification.clientState.length === 0 || notification.clientState.length > MAX_GRAPH_CLIENT_STATE_LENGTH ) { continue; } let identity: Awaited>; try { identity = await resolveMicrosoftMailboxRlsIdentity(notification.subscriptionId, notification.clientState); } catch { continue; } if (!identity) { continue; } await runWithRlsContext({ tenantId: identity.tenantId, userId: identity.userId }, async () => { const mailbox = await getMicrosoftWebhookMailbox({ tenantId: identity.tenantId, ownerUserId: identity.userId, mailboxId: identity.resourceId, subscriptionId: notification.subscriptionId!, clientState: notification.clientState!, }); if (!mailbox) return; await recordEmailWebhookEvent({ tenantId: mailbox.tenantId, mailboxId: mailbox.id, provider: "microsoft", notificationPayload: { subscriptionId: notification.subscriptionId, changeType: notification.changeType ?? null, resource: notification.resource ?? null, resourceId: notification.resourceData?.id ?? null, }, }); }); } return ACCEPTED; }; // Resource route: no default component. A GET (e.g. health probe) just 200s. export const loader = () => new Response(null, { status: 200 });