@xemahq/biomes-platform-ms365 0.1.0

package/dist/graph/graph-types.d.ts

@@ -0,0 +1,81 @@
+export declare enum GraphChangeType {
+    CREATED = "created",
+    UPDATED = "updated",
+    DELETED = "deleted"
+}
+export interface GraphChangeNotification {
+    readonly subscriptionId: string;
+    readonly subscriptionExpirationDateTime?: string;
+    readonly changeType: GraphChangeType;
+    readonly clientState?: string;
+    readonly resource: string;
+    readonly resourceData?: {
+        readonly id?: string;
+        readonly '@odata.type'?: string;
+        readonly '@odata.id'?: string;
+    };
+    readonly tenantId?: string;
+}
+export interface GraphChangeNotificationCollection {
+    readonly value: readonly GraphChangeNotification[];
+}
+export interface GraphEmailAddress {
+    readonly name?: string;
+    readonly address?: string;
+}
+export interface GraphRecipient {
+    readonly emailAddress?: GraphEmailAddress;
+}
+export interface GraphItemBody {
+    readonly contentType?: string;
+    readonly content?: string;
+}
+export interface GraphFileAttachment {
+    readonly '@odata.type'?: string;
+    readonly id?: string;
+    readonly name?: string;
+    readonly contentType?: string;
+    readonly size?: number;
+    readonly contentId?: string;
+    readonly isInline?: boolean;
+}
+export interface GraphMessageResource {
+    readonly id: string;
+    readonly conversationId?: string;
+    readonly internetMessageId?: string;
+    readonly subject?: string;
+    readonly receivedDateTime?: string;
+    readonly sentDateTime?: string;
+    readonly from?: GraphRecipient;
+    readonly sender?: GraphRecipient;
+    readonly toRecipients?: readonly GraphRecipient[];
+    readonly ccRecipients?: readonly GraphRecipient[];
+    readonly bccRecipients?: readonly GraphRecipient[];
+    readonly body?: GraphItemBody;
+    readonly bodyPreview?: string;
+    readonly categories?: readonly string[];
+    readonly hasAttachments?: boolean;
+    readonly attachments?: readonly GraphFileAttachment[];
+    readonly internetMessageHeaders?: ReadonlyArray<{
+        readonly name?: string;
+        readonly value?: string;
+    }>;
+}
+export interface GraphSubscription {
+    readonly id: string;
+    readonly resource: string;
+    readonly changeType: GraphChangeType;
+    readonly notificationUrl: string;
+    readonly expirationDateTime: string;
+    readonly clientState?: string;
+}
+export interface GraphUser {
+    readonly mail?: string | null;
+    readonly userPrincipalName?: string;
+}
+export interface GraphMessageDeltaPage {
+    readonly value: readonly GraphMessageResource[];
+    readonly '@odata.nextLink'?: string;
+    readonly '@odata.deltaLink'?: string;
+}
+//# sourceMappingURL=graph-types.d.ts.map

package/dist/graph/graph-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-types.d.ts","sourceRoot":"","sources":["../../src/graph/graph-types.ts"],"names":[],"mappings":"AAqBA,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAGD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE;QACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAGD,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAE5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAEtD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,aAAa,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAGD,MAAM,WAAW,SAAS;IAExB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAEhD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC"}

package/dist/graph/graph-types.js

@@ -0,0 +1,7 @@
+export var GraphChangeType;
+(function (GraphChangeType) {
+    GraphChangeType["CREATED"] = "created";
+    GraphChangeType["UPDATED"] = "updated";
+    GraphChangeType["DELETED"] = "deleted";
+})(GraphChangeType || (GraphChangeType = {}));
+//# sourceMappingURL=graph-types.js.map

package/dist/graph/graph-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-types.js","sourceRoot":"","sources":["../../src/graph/graph-types.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,sCAAmB,CAAA;IACnB,sCAAmB,CAAA;AACrB,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B"}

package/dist/graph/mail-envelope.d.ts

@@ -0,0 +1,12 @@
+import { type MappedEnvelope, type Result } from '@xemahq/biome-sdk/adapter';
+import type { GraphMessageResource } from './graph-types.js';
+export declare const MAIL_ENTITY_KIND_MESSAGE = "MESSAGE";
+export declare const MAIL_EVENT: {
+    readonly MESSAGE_RECEIVED: "mail.message.received";
+    readonly MESSAGE_SENT: "mail.message.sent";
+};
+export interface BuildMailEnvelopeOptions {
+    readonly event?: (typeof MAIL_EVENT)[keyof typeof MAIL_EVENT];
+}
+export declare function buildMailEnvelope(message: GraphMessageResource, options?: BuildMailEnvelopeOptions): Result<MappedEnvelope>;
+//# sourceMappingURL=mail-envelope.d.ts.map

package/dist/graph/mail-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-envelope.d.ts","sourceRoot":"","sources":["../../src/graph/mail-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAIjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAgB7D,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAGlD,eAAO,MAAM,UAAU;;;CAGb,CAAC;AAEX,MAAM,WAAW,wBAAwB;IAKvC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;CAC/D;AAOD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,oBAAoB,EAC7B,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAAC,cAAc,CAAC,CAcxB"}

package/dist/graph/mail-envelope.js

@@ -0,0 +1,23 @@
+import { ok } from '@xemahq/biome-sdk/adapter';
+import { normalizeGraphMessage } from './message-normalizer.js';
+export const MAIL_ENTITY_KIND_MESSAGE = 'MESSAGE';
+export const MAIL_EVENT = {
+    MESSAGE_RECEIVED: 'mail.message.received',
+    MESSAGE_SENT: 'mail.message.sent',
+};
+export function buildMailEnvelope(message, options = {}) {
+    const normalized = normalizeGraphMessage(message);
+    if (!normalized.ok) {
+        return normalized;
+    }
+    const payload = normalized.value;
+    const envelope = {
+        entityKind: MAIL_ENTITY_KIND_MESSAGE,
+        event: options.event ?? MAIL_EVENT.MESSAGE_RECEIVED,
+        payload: payload,
+        externalId: payload.messageId,
+        ...(payload.threadId === undefined ? {} : { externalSpaceKey: payload.threadId }),
+    };
+    return ok(envelope);
+}
+//# sourceMappingURL=mail-envelope.js.map

package/dist/graph/mail-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-envelope.js","sourceRoot":"","sources":["../../src/graph/mail-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAoC,MAAM,2BAA2B,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAkBhE,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAGlD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,gBAAgB,EAAE,uBAAuB;IACzC,YAAY,EAAE,mBAAmB;CACzB,CAAC;AAeX,MAAM,UAAU,iBAAiB,CAC/B,OAA6B,EAC7B,UAAoC,EAAE;IAEtC,MAAM,UAAU,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC;IACjC,MAAM,QAAQ,GAAmB;QAC/B,UAAU,EAAE,wBAAwB;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,gBAAgB;QACnD,OAAO,EAAE,OAAuD;QAChE,UAAU,EAAE,OAAO,CAAC,SAAS;QAC7B,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;KAClF,CAAC;IACF,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;AACtB,CAAC"}

package/dist/graph/message-normalizer.d.ts

@@ -0,0 +1,25 @@
+import { type Result } from '@xemahq/biome-sdk/adapter';
+import type { GraphMessageResource } from './graph-types.js';
+export interface CanonicalMailAttachment {
+    readonly filename: string;
+    readonly contentType: string;
+    readonly size: number;
+    readonly contentId?: string;
+}
+export interface CanonicalMailMessage {
+    readonly messageId: string;
+    readonly threadId?: string;
+    readonly from: string;
+    readonly to: string[];
+    readonly cc?: string[];
+    readonly bcc?: string[];
+    readonly subject: string;
+    readonly bodyText?: string;
+    readonly bodyHtml?: string;
+    readonly headers?: Record<string, string>;
+    readonly receivedAt: string;
+    readonly labels?: string[];
+    readonly attachments?: CanonicalMailAttachment[];
+}
+export declare function normalizeGraphMessage(message: GraphMessageResource): Result<CanonicalMailMessage>;
+//# sourceMappingURL=message-normalizer.d.ts.map

package/dist/graph/message-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-normalizer.d.ts","sourceRoot":"","sources":["../../src/graph/message-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAE/E,OAAO,KAAK,EAEV,oBAAoB,EAErB,MAAM,kBAAkB,CAAC;AAoB1B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,EAAE,CAAC;CAClD;AAYD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAAC,oBAAoB,CAAC,CA4E9B"}

package/dist/graph/message-normalizer.js

@@ -0,0 +1,143 @@
+import { adapterError, err, ok } from '@xemahq/biome-sdk/adapter';
+const FILE_ATTACHMENT_ODATA_TYPE = '#microsoft.graph.fileAttachment';
+export function normalizeGraphMessage(message) {
+    if (!message || typeof message !== 'object') {
+        return err(adapterError('malformed-payload', 'graph message resource is not an object'));
+    }
+    const messageId = nonEmpty(message.id);
+    if (!messageId) {
+        return err(adapterError('malformed-payload', 'graph message: id required'));
+    }
+    const from = recipientAddress(message.from) ?? recipientAddress(message.sender);
+    if (!from) {
+        return err(adapterError('malformed-payload', 'graph message: from.emailAddress.address (or sender) required', { path: 'from.emailAddress.address' }));
+    }
+    const to = recipientAddresses(message.toRecipients);
+    if (to.length === 0) {
+        return err(adapterError('malformed-payload', 'graph message: at least one toRecipients[].emailAddress.address required', { path: 'toRecipients' }));
+    }
+    const subject = typeof message.subject === 'string' ? message.subject : '';
+    const receivedAt = resolveReceivedAt(message);
+    if (!receivedAt) {
+        return err(adapterError('malformed-payload', 'graph message: receivedDateTime or sentDateTime required', { path: 'receivedDateTime' }));
+    }
+    const cc = recipientAddresses(message.ccRecipients);
+    const bcc = recipientAddresses(message.bccRecipients);
+    const { bodyText, bodyHtml } = splitBody(message);
+    const headers = normalizeHeaders(message);
+    const labels = normalizeLabels(message.categories);
+    const attachments = normalizeAttachments(message.attachments);
+    const canonical = {
+        messageId,
+        from,
+        to,
+        subject,
+        receivedAt,
+        ...optional('threadId', nonEmpty(message.conversationId)),
+        ...optionalArray('cc', cc),
+        ...optionalArray('bcc', bcc),
+        ...optional('bodyText', bodyText),
+        ...optional('bodyHtml', bodyHtml),
+        ...optional('headers', headers),
+        ...optionalArray('labels', labels),
+        ...optionalArray('attachments', attachments),
+    };
+    return ok(canonical);
+}
+function resolveReceivedAt(message) {
+    return nonEmpty(message.receivedDateTime) ?? nonEmpty(message.sentDateTime);
+}
+function splitBody(message) {
+    const body = message.body;
+    if (body && typeof body === 'object') {
+        const content = typeof body.content === 'string' ? body.content : undefined;
+        if (content !== undefined && content.length > 0) {
+            const contentType = (body.contentType ?? '').toLowerCase();
+            if (contentType === 'html') {
+                return { bodyHtml: content };
+            }
+            return { bodyText: content };
+        }
+    }
+    const preview = nonEmpty(message.bodyPreview);
+    return preview ? { bodyText: preview } : {};
+}
+function normalizeHeaders(message) {
+    const out = {};
+    const internetMessageId = nonEmpty(message.internetMessageId);
+    if (internetMessageId) {
+        out['message-id'] = internetMessageId;
+    }
+    for (const header of message.internetMessageHeaders ?? []) {
+        const name = nonEmpty(header?.name);
+        const value = typeof header?.value === 'string' ? header.value : undefined;
+        if (name && value !== undefined) {
+            out[name.toLowerCase()] = value;
+        }
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+function normalizeLabels(categories) {
+    if (!Array.isArray(categories)) {
+        return [];
+    }
+    return categories.filter((c) => typeof c === 'string' && c.length > 0);
+}
+function normalizeAttachments(attachments) {
+    if (!Array.isArray(attachments)) {
+        return [];
+    }
+    const out = [];
+    for (const raw of attachments) {
+        if (!raw || typeof raw !== 'object') {
+            continue;
+        }
+        const odataType = raw['@odata.type'];
+        if (odataType !== undefined && odataType !== FILE_ATTACHMENT_ODATA_TYPE) {
+            continue;
+        }
+        const filename = nonEmpty(raw.name);
+        const contentType = nonEmpty(raw.contentType);
+        if (!filename || !contentType) {
+            continue;
+        }
+        const size = typeof raw.size === 'number' && raw.size >= 0 ? raw.size : 0;
+        const contentId = nonEmpty(raw.contentId);
+        out.push({
+            filename,
+            contentType,
+            size,
+            ...optional('contentId', contentId),
+        });
+    }
+    return out;
+}
+function recipientAddress(recipient) {
+    if (!recipient || typeof recipient !== 'object') {
+        return undefined;
+    }
+    return nonEmpty(recipient.emailAddress?.address);
+}
+function recipientAddresses(recipients) {
+    if (!Array.isArray(recipients)) {
+        return [];
+    }
+    const out = [];
+    for (const recipient of recipients) {
+        const address = recipientAddress(recipient);
+        if (address) {
+            out.push(address);
+        }
+    }
+    return out;
+}
+function nonEmpty(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function optional(key, value) {
+    return value === undefined ? {} : { [key]: value };
+}
+function optionalArray(key, value) {
+    return value.length === 0 ? {} : { [key]: value };
+}
+//# sourceMappingURL=message-normalizer.js.map

package/dist/graph/message-normalizer.js.map

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

package/dist/graph/subscription-lifecycle.d.ts

@@ -0,0 +1,19 @@
+import { type Result } from '@xemahq/biome-sdk/adapter';
+import { GraphClient, type CreateSubscriptionInput } from './graph-client.js';
+import type { GraphChangeNotification, GraphMessageResource, GraphSubscription } from './graph-types.js';
+export declare function resolveValidationHandshake(query: Readonly<Record<string, string | undefined>>): string | null;
+export declare function verifyClientState(notification: GraphChangeNotification, expectedClientState: string): Result<void>;
+export interface ParsedMessageResource {
+    readonly userId: string;
+    readonly messageId: string;
+}
+export declare function parseMessageResourcePath(notification: GraphChangeNotification): Result<ParsedMessageResource>;
+export declare function isRenewalDue(expirationDateTime: string, now?: number): boolean;
+export declare function nextExpiration(now?: number): string;
+export declare function getMailboxAddress(client: GraphClient): Promise<Result<string>>;
+export declare function establishInboxSubscription(client: GraphClient, input: CreateSubscriptionInput): Promise<Result<GraphSubscription>>;
+export declare function renewIfDue(client: GraphClient, subscription: Pick<GraphSubscription, 'id' | 'expirationDateTime'>, now?: number): Promise<Result<GraphSubscription | null>>;
+export declare function drainMessageDelta(client: GraphClient, userId: string, startLink: string | undefined, onMessage: (message: GraphMessageResource) => Promise<void>, maxPages?: number): Promise<Result<{
+    deltaLink: string | null;
+}>>;
+//# sourceMappingURL=subscription-lifecycle.d.ts.map

package/dist/graph/subscription-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-lifecycle.d.ts","sourceRoot":"","sources":["../../src/graph/subscription-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAE/E,OAAO,EACL,WAAW,EAGX,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AA6B1B,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAClD,MAAM,GAAG,IAAI,CAGf;AASD,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,uBAAuB,EACrC,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAAC,IAAI,CAAC,CASd;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAWD,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,uBAAuB,GACpC,MAAM,CAAC,qBAAqB,CAAC,CAmB/B;AAuCD,wBAAgB,YAAY,CAC1B,kBAAkB,EAAE,MAAM,EAC1B,GAAG,GAAE,MAAmB,GACvB,OAAO,CAOT;AAGD,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAmB,GAAG,MAAM,CAE/D;AAeD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAYpF;AAUD,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAEpC;AAUD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,oBAAoB,CAAC,EAClE,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC,CAS3C;AAeD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,SAAS,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,EAC3D,QAAQ,SAAK,GACZ,OAAO,CAAC,MAAM,CAAC;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC,CAuB/C"}

package/dist/graph/subscription-lifecycle.js

@@ -0,0 +1,114 @@
+import { adapterError, err, ok } from '@xemahq/biome-sdk/adapter';
+import { MAX_SUBSCRIPTION_LIFETIME_MS, SUBSCRIPTION_RENEWAL_SKEW_MS, } from './graph-client.js';
+export function resolveValidationHandshake(query) {
+    const token = query['validationToken'];
+    return typeof token === 'string' && token.length > 0 ? token : null;
+}
+export function verifyClientState(notification, expectedClientState) {
+    const provided = notification.clientState;
+    if (typeof provided !== 'string' || provided.length === 0) {
+        return err(adapterError('verification-failed', 'graph notification missing clientState'));
+    }
+    if (provided !== expectedClientState) {
+        return err(adapterError('verification-failed', 'graph notification clientState mismatch'));
+    }
+    return ok(undefined);
+}
+export function parseMessageResourcePath(notification) {
+    const resource = notification.resource;
+    if (typeof resource !== 'string' || resource.length === 0) {
+        return err(adapterError('malformed-payload', 'graph notification: empty resource path'));
+    }
+    const userId = extractSegment(resource, 'users');
+    if (!userId) {
+        return err(adapterError('malformed-payload', `graph notification: cannot extract userId from "${resource}"`));
+    }
+    const messageId = nonEmpty(notification.resourceData?.id) ?? extractSegment(resource, 'messages');
+    if (!messageId) {
+        return err(adapterError('malformed-payload', `graph notification: cannot extract messageId from "${resource}"`));
+    }
+    return ok({ userId, messageId });
+}
+function extractSegment(resource, segment) {
+    const parts = resource.split('/').filter((p) => p.length > 0);
+    for (let i = 0; i < parts.length - 1; i++) {
+        const keyMatch = /^([A-Za-z]+)(?:\('([^']*)'\))?$/.exec(parts[i] ?? '');
+        if (!keyMatch) {
+            continue;
+        }
+        const [, key, inlineValue] = keyMatch;
+        if (key?.toLowerCase() !== segment.toLowerCase()) {
+            continue;
+        }
+        if (inlineValue && inlineValue.length > 0) {
+            return inlineValue;
+        }
+        const next = parts[i + 1] ?? '';
+        const nextInline = /^[A-Za-z]+\('([^']*)'\)$/.exec(next);
+        if (nextInline?.[1]) {
+            return nextInline[1];
+        }
+        return next.length > 0 ? next : undefined;
+    }
+    return undefined;
+}
+export function isRenewalDue(expirationDateTime, now = Date.now()) {
+    const expiresAt = Date.parse(expirationDateTime);
+    if (Number.isNaN(expiresAt)) {
+        return true;
+    }
+    return expiresAt - now <= SUBSCRIPTION_RENEWAL_SKEW_MS;
+}
+export function nextExpiration(now = Date.now()) {
+    return new Date(now + MAX_SUBSCRIPTION_LIFETIME_MS).toISOString();
+}
+export async function getMailboxAddress(client) {
+    const result = await client.getMe();
+    if (!result.ok) {
+        return result;
+    }
+    const address = nonEmpty(result.value.mail) ?? nonEmpty(result.value.userPrincipalName);
+    if (!address) {
+        return err(adapterError('malformed-payload', 'graph /me returned neither mail nor userPrincipalName'));
+    }
+    return ok(address);
+}
+export async function establishInboxSubscription(client, input) {
+    return client.createSubscription(input);
+}
+export async function renewIfDue(client, subscription, now = Date.now()) {
+    if (!isRenewalDue(subscription.expirationDateTime, now)) {
+        return ok(null);
+    }
+    const result = await client.renewSubscription(subscription.id);
+    if (!result.ok) {
+        return result;
+    }
+    return ok(result.value);
+}
+export async function drainMessageDelta(client, userId, startLink, onMessage, maxPages = 50) {
+    let cursor = startLink;
+    let deltaLink = null;
+    for (let page = 0; page < maxPages; page++) {
+        const result = await client.getMessageDelta(userId, cursor);
+        if (!result.ok) {
+            return result;
+        }
+        const pageData = result.value;
+        for (const message of pageData.value) {
+            await onMessage(message);
+        }
+        const nextLink = pageData['@odata.nextLink'];
+        if (nextLink) {
+            cursor = nextLink;
+            continue;
+        }
+        deltaLink = pageData['@odata.deltaLink'] ?? null;
+        return ok({ deltaLink });
+    }
+    return ok({ deltaLink: cursor ?? null });
+}
+function nonEmpty(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+//# sourceMappingURL=subscription-lifecycle.js.map

package/dist/graph/subscription-lifecycle.js.map

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

package/install-schema/install.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "ms365-connector-install",
+  "title": "Microsoft 365 Mail Intake Settings",
+  "type": "object",
+  "required": ["integration", "mailboxUserId"],
+  "properties": {
+    "integration": {
+      "type": "string",
+      "title": "Microsoft 365 connection",
+      "description": "Which connected Microsoft 365 tenant this installation uses.",
+      "x-widget": "credential-picker",
+      "x-widget-config": { "provider": "microsoft_graph" }
+    },
+    "mailboxUserId": {
+      "type": "string",
+      "title": "Mailbox",
+      "description": "User id or UPN of the mailbox to monitor for inbound mail (e.g. intake@contoso.onmicrosoft.com)."
+    },
+    "folder": {
+      "type": "string",
+      "title": "Mail folder",
+      "description": "Well-known folder to subscribe to (default: inbox).",
+      "enum": ["inbox", "archive", "clutter", "junkemail"],
+      "default": "inbox"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@xemahq/biomes-platform-ms365",
+  "version": "0.1.0",
+  "license": "LicenseRef-Xema-BSL-1.1",
+  "type": "module",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "main": "dist/connector-adapters/index.js",
+  "files": [
+    "dist",
+    "install-schema",
+    "xema-biome.json",
+    "contributions"
+  ],
+  "exports": {
+    "./connector-adapters": {
+      "types": "./dist/connector-adapters/index.d.ts",
+      "default": "./dist/connector-adapters/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@xemahq/biome-sdk": "^3.0.0",
+    "@xemahq/kernel-contracts": "^5.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.2.3",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test ./tests/**/*.test.mjs"
+  }
+}