@fluxmail/provider-gmail 0.1.0

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+import { EmailError } from '@fluxmail/core';
+export declare function isRetryable(err: unknown): boolean;
+/**
+ * A non-idempotent request can be committed before a 5xx reaches the client,
+ * so retrying can duplicate its effect. Retry only responses that reject the
+ * request before processing it.
+ */
+export declare function isRetryableForNonIdempotentRequest(err: unknown): boolean;
+/** Map googleapis errors onto the normalized EmailError codes. */
+export declare function toEmailError(err: unknown): EmailError;
+export declare function withRetry<T>(fn: () => Promise<T>, maxRetries?: number, retryable?: (err: unknown) => boolean): Promise<T>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA4B5C,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAWjD;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAIxE;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CA2BrD;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,SAAI,EACd,SAAS,GAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAqB,GACjD,OAAO,CAAC,CAAC,CAAC,CAYZ"}

package/dist/errors.js

@@ -0,0 +1,79 @@
+import { EmailError } from '@fluxmail/core';
+function statusOf(err) {
+    if (typeof err.code === 'number')
+        return err.code;
+    if (typeof err.code === 'string' && /^\d+$/.test(err.code))
+        return Number(err.code);
+    return err.response?.status;
+}
+function reasonsOf(err) {
+    return [...(err.errors ?? []), ...(err.response?.data?.error?.errors ?? [])]
+        .map((item) => item.reason)
+        .filter((reason) => !!reason);
+}
+function isRateLimitReason(reason) {
+    return /^(?:user)?rateLimitExceeded$/i.test(reason);
+}
+export function isRetryable(err) {
+    const e = err;
+    const status = statusOf(e);
+    return (status === 429 ||
+        status === 500 ||
+        status === 502 ||
+        status === 503 ||
+        status === 504 ||
+        (status === 403 && reasonsOf(e).some(isRateLimitReason)));
+}
+/**
+ * A non-idempotent request can be committed before a 5xx reaches the client,
+ * so retrying can duplicate its effect. Retry only responses that reject the
+ * request before processing it.
+ */
+export function isRetryableForNonIdempotentRequest(err) {
+    const e = err;
+    const status = statusOf(e);
+    return status === 429 || (status === 403 && reasonsOf(e).some(isRateLimitReason));
+}
+/** Map googleapis errors onto the normalized EmailError codes. */
+export function toEmailError(err) {
+    if (err instanceof EmailError)
+        return err;
+    const e = err;
+    const status = statusOf(e);
+    const message = e.message ?? e.response?.data?.error?.message ?? 'Gmail API error';
+    const reasons = reasonsOf(e);
+    // invalid_grant = revoked/expired refresh token; comes back as a 400.
+    if (status === 401 || /invalid_grant/i.test(message)) {
+        return new EmailError('auth_expired', `Gmail authorization expired or revoked: ${message}`);
+    }
+    if (status === 429 ||
+        reasons.some((reason) => isRateLimitReason(reason) || /^(?:dailyLimit|quota)Exceeded$/i.test(reason))) {
+        return new EmailError('rate_limited', `Gmail rate limit hit: ${message}`);
+    }
+    if (status === 403) {
+        return new EmailError('provider_unavailable', `Gmail permission denied: ${message}`);
+    }
+    if (status === 404) {
+        return new EmailError('not_found', `Not found in Gmail: ${message}`);
+    }
+    if (status === 400) {
+        return new EmailError('invalid_request', message);
+    }
+    return new EmailError('provider_unavailable', `Gmail API failure: ${message}`);
+}
+export async function withRetry(fn, maxRetries = 3, retryable = isRetryable) {
+    let attempt = 0;
+    for (;;) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (attempt >= maxRetries || !retryable(err))
+                throw toEmailError(err);
+            const delayMs = 500 * 2 ** attempt + Math.floor(Math.random() * 250);
+            await new Promise((r) => setTimeout(r, delayMs));
+            attempt++;
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/gmailProvider.d.ts

@@ -0,0 +1,58 @@
+import type { OAuth2Client } from 'googleapis-common';
+import { type AttachmentMeta, type Capabilities, type DraftInput, type EmailProvider, type EmailQuery, type Folder, type GetMessageOpts, type Message, type ModifyAction, type Page, type PageOpts, type SendResult, type Thread } from '@fluxmail/core';
+export interface GmailProviderOptions {
+    accountId: string;
+    email: string;
+    /** Stored sender name used when Gmail settings and the current Google profile have no name. */
+    displayName?: string;
+    auth: OAuth2Client;
+}
+export declare const GMAIL_CAPABILITIES: Capabilities;
+export declare class GmailProvider implements EmailProvider {
+    readonly capabilities: Capabilities;
+    private readonly gmail;
+    private readonly accountId;
+    private readonly email;
+    private readonly displayName;
+    private readonly auth;
+    private labelCache;
+    /** undefined = not resolved yet; null = no name available. */
+    private senderName;
+    constructor(opts: GmailProviderOptions);
+    /**
+     * Sender name for the From header, matching what the Gmail UI would use:
+     * the primary send-as displayName when set, else the current Google profile
+     * name, with the stored account name as an offline fallback.
+     */
+    private resolveSenderName;
+    testConnection(): Promise<void>;
+    private labels;
+    private labelNameMap;
+    /** Gmail messages carry the DRAFT label, but only Draft resources expose the draft id. */
+    private attachDraftIds;
+    private resolveLabelId;
+    listMessages(q: EmailQuery, page?: PageOpts): Promise<Page<Message>>;
+    getMessage(id: string, opts?: GetMessageOpts): Promise<Message>;
+    getThread(threadId: string): Promise<Thread>;
+    private parseFullMessage;
+    listFolders(): Promise<Folder[]>;
+    /** Resolve reply threading (headers + Gmail thread id) from the message being replied to. */
+    private resolveReply;
+    /** Threading already present on an existing draft, so content updates keep a reply on its thread. */
+    private resolveExistingDraftThreading;
+    private composeRaw;
+    private draftToMessage;
+    createDraft(d: DraftInput): Promise<Message>;
+    getDraft(draftId: string): Promise<Message>;
+    updateDraft(draftId: string, d: DraftInput): Promise<Message>;
+    deleteDraft(draftId: string): Promise<void>;
+    send(input: DraftInput | {
+        draftId: string;
+    }): Promise<SendResult>;
+    modify(ids: string[], action: ModifyAction): Promise<void>;
+    getAttachment(messageId: string, attachmentId: string): Promise<{
+        meta: AttachmentMeta;
+        content: Buffer;
+    }>;
+}
+//# sourceMappingURL=gmailProvider.d.ts.map

package/dist/gmailProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmailProvider.d.ts","sourceRoot":"","sources":["../src/gmailProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,MAAM,EAEX,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,MAAM,EACZ,MAAM,gBAAgB,CAAC;AAgCxB,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,eAAO,MAAM,kBAAkB,EAAE,YAKhC,CAAC;AAEF,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAsB;IAEzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,UAAU,CAAuE;IACzF,8DAA8D;IAC9D,OAAO,CAAC,UAAU,CAA4B;gBAElC,IAAI,EAAE,oBAAoB;IAQtC;;;;OAIG;YACW,iBAAiB;IAuCzB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;YAIvB,MAAM;YAUN,YAAY;IAK1B,0FAA0F;YAC5E,cAAc;YA0Bd,cAAc;IAoBtB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAuDpE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ/D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAgBpC,gBAAgB;IA+BxB,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBtC,6FAA6F;YAC/E,YAAY;IAsB1B,qGAAqG;YACvF,6BAA6B;YAmB7B,UAAU;YAwBV,cAAc;IAQtB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAc5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAe7D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBlE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAgE1D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAejH"}

package/dist/gmailProvider.js

@@ -0,0 +1,453 @@
+import { google } from 'googleapis';
+import { EmailError, isEmailError, replySubject, } from '@fluxmail/core';
+import { toGmailQuery, ROLE_TO_LABEL } from './query.js';
+import { decodeBase64Url, decodeTextPart, encodeBase64Url, findAttachment, parseGmailMessage, parseGmailMessageWithParts, } from './parse.js';
+import { buildRawMessage } from './mime.js';
+import { isRetryableForNonIdempotentRequest, withRetry } from './errors.js';
+const LABEL_TO_ROLE = {
+    INBOX: 'inbox',
+    SENT: 'sent',
+    DRAFT: 'drafts',
+    TRASH: 'trash',
+    SPAM: 'spam',
+    STARRED: 'starred',
+};
+const METADATA_HEADERS = ['From', 'To', 'Cc', 'Bcc', 'Reply-To', 'Subject', 'Date', 'Message-ID', 'References', 'In-Reply-To'];
+const LABEL_CACHE_TTL_MS = 60_000;
+const HYDRATE_CONCURRENCY = 10;
+const DEFAULT_PAGE_SIZE = 25;
+const MAX_PAGE_SIZE = 100;
+const NON_IDEMPOTENT_MAX_RETRIES = 3;
+const BATCH_MODIFY_MAX_IDS = 1_000;
+const GOOGLE_USERINFO_URL = 'https://openidconnect.googleapis.com/v1/userinfo';
+const IMMUTABLE_SYSTEM_LABELS = new Set(['sent', 'draft', 'drafts']);
+export const GMAIL_CAPABILITIES = {
+    labels: true,
+    serverThreads: true,
+    serverSearch: 'rich',
+    snippets: true,
+};
+export class GmailProvider {
+    capabilities = GMAIL_CAPABILITIES;
+    gmail;
+    accountId;
+    email;
+    displayName;
+    auth;
+    labelCache = null;
+    /** undefined = not resolved yet; null = no name available. */
+    senderName;
+    constructor(opts) {
+        this.accountId = opts.accountId;
+        this.email = opts.email;
+        this.displayName = opts.displayName;
+        this.auth = opts.auth;
+        this.gmail = google.gmail({ version: 'v1', auth: opts.auth });
+    }
+    /**
+     * Sender name for the From header, matching what the Gmail UI would use:
+     * the primary send-as displayName when set, else the current Google profile
+     * name, with the stored account name as an offline fallback.
+     */
+    async resolveSenderName() {
+        if (this.senderName !== undefined)
+            return this.senderName;
+        let lookupFailed = false;
+        let sendAsName;
+        try {
+            const res = await withRetry(() => this.gmail.users.settings.sendAs.list({ userId: 'me' }));
+            const primary = res.data.sendAs?.find((s) => s.isPrimary) ??
+                res.data.sendAs?.find((s) => s.sendAsEmail === this.email);
+            sendAsName = primary?.displayName?.trim() || undefined;
+        }
+        catch {
+            // Fall through to the profile and stored account name.
+            lookupFailed = true;
+        }
+        if (sendAsName) {
+            this.senderName = sendAsName;
+            return this.senderName;
+        }
+        try {
+            const res = await withRetry(() => this.auth.request({ url: GOOGLE_USERINFO_URL }));
+            const profileName = res.data.name?.trim();
+            if (profileName) {
+                this.senderName = profileName;
+                return this.senderName;
+            }
+        }
+        catch {
+            // Profile lookup is optional; sending should still work without it.
+            lookupFailed = true;
+        }
+        const fallback = this.displayName?.trim() || null;
+        // Cache "no name configured", but not a transient lookup failure: the next
+        // send should try Gmail again rather than pin the offline fallback.
+        if (!lookupFailed)
+            this.senderName = fallback;
+        return fallback;
+    }
+    async testConnection() {
+        await withRetry(() => this.gmail.users.getProfile({ userId: 'me' }));
+    }
+    async labels(forceRefresh = false) {
+        if (!forceRefresh && this.labelCache && Date.now() - this.labelCache.fetchedAt < LABEL_CACHE_TTL_MS) {
+            return this.labelCache.labels;
+        }
+        const res = await withRetry(() => this.gmail.users.labels.list({ userId: 'me' }));
+        const labels = res.data.labels ?? [];
+        this.labelCache = { fetchedAt: Date.now(), labels };
+        return labels;
+    }
+    async labelNameMap() {
+        const labels = await this.labels();
+        return new Map(labels.filter((l) => l.id && l.name).map((l) => [l.id, l.name]));
+    }
+    /** Gmail messages carry the DRAFT label, but only Draft resources expose the draft id. */
+    async attachDraftIds(messages) {
+        const unresolved = new Map(messages.filter((message) => message.flags.draft).map((message) => [message.id, message]));
+        if (!unresolved.size)
+            return;
+        let pageToken;
+        do {
+            const res = await withRetry(() => this.gmail.users.drafts.list({
+                userId: 'me',
+                maxResults: 500,
+                ...(pageToken ? { pageToken } : {}),
+            }));
+            for (const draft of res.data.drafts ?? []) {
+                const message = draft.message?.id ? unresolved.get(draft.message.id) : undefined;
+                if (message && draft.id) {
+                    message.draftId = draft.id;
+                    unresolved.delete(message.id);
+                }
+            }
+            pageToken = res.data.nextPageToken ?? undefined;
+        } while (unresolved.size && pageToken);
+    }
+    async resolveLabelId(folder, createIfMissing = false) {
+        const role = folder.toLowerCase();
+        if (IMMUTABLE_SYSTEM_LABELS.has(role)) {
+            throw new EmailError('invalid_request', `Gmail does not allow changing the "${role}" system label`);
+        }
+        if (ROLE_TO_LABEL[role])
+            return ROLE_TO_LABEL[role];
+        const labels = await this.labels();
+        const match = labels.find((l) => l.id === folder || l.name?.toLowerCase() === folder.toLowerCase());
+        if (match?.id)
+            return match.id;
+        if (!createIfMissing) {
+            throw new EmailError('not_found', `No Gmail label or folder named "${folder}"`);
+        }
+        const created = await withRetry(() => this.gmail.users.labels.create({ userId: 'me', requestBody: { name: folder } }));
+        this.labelCache = null;
+        if (!created.data.id)
+            throw new EmailError('provider_unavailable', 'Gmail did not return a label id');
+        return created.data.id;
+    }
+    async listMessages(q, page) {
+        const labels = await this.labels();
+        const gq = toGmailQuery(q, (folder) => {
+            const match = labels.find((l) => l.id === folder || l.name?.toLowerCase() === folder.toLowerCase());
+            return match?.id ?? null;
+        });
+        const pageSize = Math.min(page?.pageSize ?? DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE);
+        const res = await withRetry(() => this.gmail.users.messages.list({
+            userId: 'me',
+            maxResults: pageSize,
+            ...(page?.pageToken ? { pageToken: page.pageToken } : {}),
+            ...(gq.q ? { q: gq.q } : {}),
+            ...(gq.labelIds ? { labelIds: gq.labelIds } : {}),
+            ...(gq.includeSpamTrash ? { includeSpamTrash: true } : {}),
+        }));
+        const ids = (res.data.messages ?? []).map((m) => m.id).filter(Boolean);
+        const labelNames = await this.labelNameMap();
+        const items = [];
+        for (let i = 0; i < ids.length; i += HYDRATE_CONCURRENCY) {
+            const chunk = ids.slice(i, i + HYDRATE_CONCURRENCY);
+            const fetched = await Promise.allSettled(chunk.map((id) => withRetry(() => this.gmail.users.messages.get({
+                userId: 'me',
+                id,
+                format: 'metadata',
+                metadataHeaders: METADATA_HEADERS,
+            }))));
+            for (const result of fetched) {
+                if (result.status === 'rejected') {
+                    if (isEmailError(result.reason) && result.reason.code === 'not_found')
+                        continue;
+                    throw result.reason;
+                }
+                items.push(parseGmailMessage(result.value.data, {
+                    accountId: this.accountId,
+                    labelNames,
+                    includeBody: false,
+                }));
+            }
+        }
+        await this.attachDraftIds(items);
+        const out = { items };
+        if (res.data.nextPageToken)
+            out.nextPageToken = res.data.nextPageToken;
+        return out;
+    }
+    async getMessage(id, opts) {
+        const res = await withRetry(() => this.gmail.users.messages.get({ userId: 'me', id, format: 'full' }));
+        const labelNames = await this.labelNameMap();
+        const message = await this.parseFullMessage(res.data, labelNames, opts?.includeHeaders ?? false);
+        await this.attachDraftIds([message]);
+        return message;
+    }
+    async getThread(threadId) {
+        const res = await withRetry(() => this.gmail.users.threads.get({ userId: 'me', id: threadId, format: 'full' }));
+        const labelNames = await this.labelNameMap();
+        const messages = await Promise.all((res.data.messages ?? []).map((message) => this.parseFullMessage(message, labelNames)));
+        await this.attachDraftIds(messages);
+        return {
+            id: res.data.id ?? threadId,
+            subject: messages[0]?.subject ?? '',
+            messages,
+        };
+    }
+    async parseFullMessage(raw, labelNames, includeHeaders = false) {
+        const { message, externalBodyParts } = parseGmailMessageWithParts(raw, {
+            accountId: this.accountId,
+            labelNames,
+            includeBody: true,
+            includeAttachments: true,
+            includeHeaders,
+        });
+        for (const field of ['text', 'html']) {
+            const external = externalBodyParts[field];
+            if (!external)
+                continue;
+            const res = await withRetry(() => this.gmail.users.messages.attachments.get({
+                userId: 'me',
+                messageId: raw.id ?? message.id,
+                id: external.attachmentId,
+            }));
+            if (res.data.data == null) {
+                throw new EmailError('provider_unavailable', `Gmail returned no ${field} body data`);
+            }
+            message.body ??= {};
+            message.body[field] = decodeTextPart(external.part, res.data.data);
+        }
+        return message;
+    }
+    async listFolders() {
+        const labels = await this.labels(true);
+        const folders = [];
+        for (const label of labels) {
+            if (!label.id || !label.name)
+                continue;
+            // Hide Gmail-internal labels that aren't useful as folders.
+            if (label.id.startsWith('CATEGORY_') || label.id === 'CHAT' || label.id === 'UNREAD' || label.id === 'IMPORTANT') {
+                continue;
+            }
+            const folder = { id: label.id, name: label.name };
+            const role = LABEL_TO_ROLE[label.id];
+            if (role)
+                folder.role = role;
+            if (typeof label.messagesUnread === 'number')
+                folder.unreadCount = label.messagesUnread;
+            folders.push(folder);
+        }
+        return folders;
+    }
+    /** Resolve reply threading (headers + Gmail thread id) from the message being replied to. */
+    async resolveReply(replyToMessageId) {
+        const res = await withRetry(() => this.gmail.users.messages.get({
+            userId: 'me',
+            id: replyToMessageId,
+            format: 'metadata',
+            metadataHeaders: ['Message-ID', 'References', 'Subject'],
+        }));
+        const headers = res.data.payload?.headers ?? [];
+        const get = (name) => headers.find((h) => h.name?.toLowerCase() === name.toLowerCase())?.value ?? '';
+        const messageId = get('Message-ID');
+        const references = [get('References'), messageId].filter(Boolean).join(' ');
+        const out = {
+            threadId: res.data.threadId ?? '',
+            subject: get('Subject'),
+        };
+        if (messageId)
+            out.inReplyTo = messageId;
+        if (references)
+            out.references = references;
+        return out;
+    }
+    /** Threading already present on an existing draft, so content updates keep a reply on its thread. */
+    async resolveExistingDraftThreading(draftId) {
+        const res = await withRetry(() => this.gmail.users.drafts.get({ userId: 'me', id: draftId, format: 'metadata' }));
+        const message = res.data.message;
+        if (!message)
+            return undefined;
+        const headers = message.payload?.headers ?? [];
+        const get = (name) => headers.find((h) => h.name?.toLowerCase() === name.toLowerCase())?.value ?? '';
+        const out = {};
+        if (message.threadId)
+            out.threadId = message.threadId;
+        const inReplyTo = get('In-Reply-To');
+        if (inReplyTo)
+            out.inReplyTo = inReplyTo;
+        const references = get('References');
+        if (references)
+            out.references = references;
+        return out;
+    }
+    async composeRaw(d, existingThreading) {
+        let threading;
+        let threadId;
+        const draft = { ...d };
+        if (d.replyToMessageId) {
+            const reply = await this.resolveReply(d.replyToMessageId);
+            threading = reply;
+            threadId = reply.threadId || undefined;
+            if (!draft.subject)
+                draft.subject = replySubject(reply.subject);
+        }
+        else if (existingThreading) {
+            threading = existingThreading;
+            threadId = existingThreading.threadId;
+        }
+        const senderName = await this.resolveSenderName();
+        const from = senderName ? { name: senderName, email: this.email } : { email: this.email };
+        const raw = await buildRawMessage(draft, from, threading);
+        const out = { raw: encodeBase64Url(raw) };
+        if (threadId)
+            out.threadId = threadId;
+        return out;
+    }
+    async draftToMessage(draft) {
+        const messageId = draft.message?.id;
+        if (!messageId)
+            throw new EmailError('provider_unavailable', 'Gmail draft has no message id');
+        const message = await this.getMessage(messageId);
+        if (draft.id)
+            message.draftId = draft.id;
+        return message;
+    }
+    async createDraft(d) {
+        const { raw, threadId } = await this.composeRaw(d);
+        const res = await withRetry(() => this.gmail.users.drafts.create({
+            userId: 'me',
+            requestBody: { message: { raw, ...(threadId ? { threadId } : {}) } },
+        }), NON_IDEMPOTENT_MAX_RETRIES, isRetryableForNonIdempotentRequest);
+        return this.draftToMessage(res.data);
+    }
+    async getDraft(draftId) {
+        const res = await withRetry(() => this.gmail.users.drafts.get({ userId: 'me', id: draftId }));
+        return this.draftToMessage(res.data);
+    }
+    async updateDraft(draftId, d) {
+        // Replacing a reply draft's content must not detach it from its thread:
+        // carry the draft's threading over unless the caller re-derives it.
+        const existing = d.replyToMessageId ? undefined : await this.resolveExistingDraftThreading(draftId);
+        const { raw, threadId } = await this.composeRaw(d, existing);
+        const res = await withRetry(() => this.gmail.users.drafts.update({
+            userId: 'me',
+            id: draftId,
+            requestBody: { message: { raw, ...(threadId ? { threadId } : {}) } },
+        }));
+        return this.draftToMessage(res.data);
+    }
+    async deleteDraft(draftId) {
+        await withRetry(() => this.gmail.users.drafts.delete({ userId: 'me', id: draftId }));
+    }
+    async send(input) {
+        if ('draftId' in input) {
+            const res = await withRetry(() => this.gmail.users.drafts.send({ userId: 'me', requestBody: { id: input.draftId } }), NON_IDEMPOTENT_MAX_RETRIES, isRetryableForNonIdempotentRequest);
+            return { id: res.data.id ?? '', threadId: res.data.threadId ?? res.data.id ?? '' };
+        }
+        if (!input.to?.length && !input.cc?.length && !input.bcc?.length) {
+            throw new EmailError('invalid_request', 'Cannot send a message with no recipients');
+        }
+        const { raw, threadId } = await this.composeRaw(input);
+        const res = await withRetry(() => this.gmail.users.messages.send({
+            userId: 'me',
+            requestBody: { raw, ...(threadId ? { threadId } : {}) },
+        }), NON_IDEMPOTENT_MAX_RETRIES, isRetryableForNonIdempotentRequest);
+        return { id: res.data.id ?? '', threadId: res.data.threadId ?? res.data.id ?? '' };
+    }
+    async modify(ids, action) {
+        if (!ids.length)
+            return;
+        if (action === 'trash' || action === 'untrash' || action === 'delete') {
+            for (const id of ids) {
+                if (action === 'trash')
+                    await withRetry(() => this.gmail.users.messages.trash({ userId: 'me', id }));
+                else if (action === 'untrash')
+                    await withRetry(() => this.gmail.users.messages.untrash({ userId: 'me', id }));
+                else
+                    await withRetry(() => this.gmail.users.messages.delete({ userId: 'me', id }));
+            }
+            return;
+        }
+        let addLabelIds = [];
+        let removeLabelIds = [];
+        if (action === 'markRead')
+            removeLabelIds = ['UNREAD'];
+        else if (action === 'markUnread')
+            addLabelIds = ['UNREAD'];
+        else if (action === 'star')
+            addLabelIds = ['STARRED'];
+        else if (action === 'unstar')
+            removeLabelIds = ['STARRED'];
+        else if (action === 'archive')
+            removeLabelIds = ['INBOX'];
+        else if ('move' in action) {
+            const role = action.move.toLowerCase();
+            if (role === 'all' || role === 'starred') {
+                throw new EmailError('invalid_request', `Cannot move messages to "${role}"; it is a view, not a destination`);
+            }
+            if (role === 'archive') {
+                // Gmail has no archive label: archiving is just leaving the inbox.
+                removeLabelIds = ['INBOX'];
+            }
+            else {
+                const target = await this.resolveLabelId(action.move, true);
+                addLabelIds = [target];
+                if (target !== 'INBOX')
+                    removeLabelIds = ['INBOX'];
+            }
+        }
+        else if ('addLabels' in action) {
+            const labels = [...new Set(action.addLabels)];
+            if (labels.length > 100) {
+                throw new EmailError('invalid_request', 'Gmail allows at most 100 labels in one modification');
+            }
+            addLabelIds = await Promise.all(labels.map((label) => this.resolveLabelId(label, true)));
+        }
+        else if ('removeLabels' in action) {
+            const labels = [...new Set(action.removeLabels)];
+            if (labels.length > 100) {
+                throw new EmailError('invalid_request', 'Gmail allows at most 100 labels in one modification');
+            }
+            removeLabelIds = await Promise.all(labels.map((label) => this.resolveLabelId(label)));
+        }
+        for (let offset = 0; offset < ids.length; offset += BATCH_MODIFY_MAX_IDS) {
+            const chunk = ids.slice(offset, offset + BATCH_MODIFY_MAX_IDS);
+            await withRetry(() => this.gmail.users.messages.batchModify({
+                userId: 'me',
+                requestBody: {
+                    ids: chunk,
+                    ...(addLabelIds.length ? { addLabelIds } : {}),
+                    ...(removeLabelIds.length ? { removeLabelIds } : {}),
+                },
+            }));
+        }
+    }
+    async getAttachment(messageId, attachmentId) {
+        const msg = await withRetry(() => this.gmail.users.messages.get({ userId: 'me', id: messageId, format: 'full' }));
+        const attachment = findAttachment(msg.data.payload, attachmentId);
+        if (!attachment)
+            throw new EmailError('not_found', `Attachment ${attachmentId} not found on message ${messageId}`);
+        if (attachment.content !== undefined) {
+            return { meta: attachment.meta, content: attachment.content };
+        }
+        const res = await withRetry(() => this.gmail.users.messages.attachments.get({ userId: 'me', messageId, id: attachmentId }));
+        if (res.data.data == null)
+            throw new EmailError('provider_unavailable', 'Gmail returned no attachment data');
+        return { meta: attachment.meta, content: decodeBase64Url(res.data.data) };
+    }
+}
+//# sourceMappingURL=gmailProvider.js.map

package/dist/gmailProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmailProvider.js","sourceRoot":"","sources":["../src/gmailProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAC;AAEnD,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,GAeb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAyB,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,kCAAkC,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,aAAa,GAA+B;IAChD,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AAC/H,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,0BAA0B,GAAG,CAAC,CAAC;AACrC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AACnC,MAAM,mBAAmB,GAAG,kDAAkD,CAAC;AAC/E,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAUrE,MAAM,CAAC,MAAM,kBAAkB,GAAiB;IAC9C,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,MAAM;IACpB,QAAQ,EAAE,IAAI;CACf,CAAC;AAEF,MAAM,OAAO,aAAa;IACf,YAAY,GAAiB,kBAAkB,CAAC;IAExC,KAAK,CAAiB;IACtB,SAAS,CAAS;IAClB,KAAK,CAAS;IACd,WAAW,CAAqB;IAChC,IAAI,CAAe;IAC5B,UAAU,GAAkE,IAAI,CAAC;IACzF,8DAA8D;IACtD,UAAU,CAA4B;IAE9C,YAAY,IAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,iBAAiB;QAC7B,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC;QAC1D,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,IAAI,UAA8B,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3F,MAAM,OAAO,GACX,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACzC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7D,UAAU,GAAG,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;YACvD,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;YAC7B,OAAO,IAAI,CAAC,UAAU,CAAC;QACzB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAoB,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,CACnE,CAAC;YACF,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YAC1C,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC;gBAC9B,OAAO,IAAI,CAAC,UAAU,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;YACpE,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;QAClD,2EAA2E;QAC3E,oEAAoE;QACpE,IAAI,CAAC,YAAY;YAAE,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC;QAC9C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvE,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,YAAY,GAAG,KAAK;QACvC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,GAAG,kBAAkB,EAAE,CAAC;YACpG,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAChC,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClF,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACnC,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAG,EAAE,CAAC,CAAC,IAAK,CAAC,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,0FAA0F;IAClF,KAAK,CAAC,cAAc,CAAC,QAAmB;QAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAC1F,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,IAAI;YAAE,OAAO;QAE7B,IAAI,SAA6B,CAAC;QAClC,GAAG,CAAC;YACF,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC3B,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,GAAG;gBACf,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpC,CAAC,CACH,CAAC;YACF,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;gBAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACjF,IAAI,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;oBACxB,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;oBAC3B,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;YACD,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,SAAS,CAAC;QAClD,CAAC,QAAQ,UAAU,CAAC,IAAI,IAAI,SAAS,EAAE;IACzC,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,eAAe,GAAG,KAAK;QAClE,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAClC,IAAI,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,sCAAsC,IAAI,gBAAgB,CAAC,CAAC;QACtG,CAAC;QACD,IAAI,aAAa,CAAC,IAAI,CAAC;YAAE,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACpG,IAAI,KAAK,EAAE,EAAE;YAAE,OAAO,KAAK,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,UAAU,CAAC,WAAW,EAAE,mCAAmC,MAAM,GAAG,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CACnC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAChF,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,UAAU,CAAC,sBAAsB,EAAE,iCAAiC,CAAC,CAAC;QACtG,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,CAAa,EAAE,IAAe;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YACpG,OAAO,KAAK,EAAE,EAAE,IAAI,IAAI,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,iBAAiB,EAAE,aAAa,CAAC,CAAC;QAC9E,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC7B,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,QAAQ;YACpB,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5B,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3D,CAAC,CACH,CAAC;QAEF,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAc,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,mBAAmB,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC;YACpD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CACf,SAAS,CAAC,GAAG,EAAE,CACb,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAC5B,MAAM,EAAE,IAAI;gBACZ,EAAE;gBACF,MAAM,EAAE,UAAU;gBAClB,eAAe,EAAE,gBAAgB;aAClC,CAAC,CACH,CACF,CACF,CAAC;YACF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;oBACjC,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,WAAW;wBAAE,SAAS;oBAChF,MAAM,MAAM,CAAC,MAAM,CAAC;gBACtB,CAAC;gBACD,KAAK,CAAC,IAAI,CACR,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;oBACnC,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,UAAU;oBACV,WAAW,EAAE,KAAK;iBACnB,CAAC,CACH,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,GAAG,GAAkB,EAAE,KAAK,EAAE,CAAC;QACrC,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa;YAAE,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC;QACvE,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,IAAqB;QAChD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACvG,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,IAAI,KAAK,CAAC,CAAC;QACjG,MAAM,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC9B,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAC7E,CAAC;QACF,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CACvF,CAAC;QACF,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,QAAQ;YAC3B,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE;YACnC,QAAQ;SACT,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,GAA4B,EAC5B,UAA+B,EAC/B,cAAc,GAAG,KAAK;QAEtB,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,0BAA0B,CAAC,GAAG,EAAE;YACrE,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU;YACV,WAAW,EAAE,IAAI;YACjB,kBAAkB,EAAE,IAAI;YACxB,cAAc;SACf,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,MAAM,CAAU,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC;gBACxC,MAAM,EAAE,IAAI;gBACZ,SAAS,EAAE,GAAG,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE;gBAC/B,EAAE,EAAE,QAAQ,CAAC,YAAY;aAC1B,CAAC,CACH,CAAC;YACF,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;gBAC1B,MAAM,IAAI,UAAU,CAAC,sBAAsB,EAAE,qBAAqB,KAAK,YAAY,CAAC,CAAC;YACvF,CAAC;YACD,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;gBAAE,SAAS;YACvC,4DAA4D;YAC5D,IAAI,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,KAAK,WAAW,EAAE,CAAC;gBACjH,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAW,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAC1D,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;YAC7B,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ;gBAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC;YACxF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,6FAA6F;IACrF,KAAK,CAAC,YAAY,CAAC,gBAAwB;QACjD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC5B,MAAM,EAAE,IAAI;YACZ,EAAE,EAAE,gBAAgB;YACpB,MAAM,EAAE,UAAU;YAClB,eAAe,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC;SACzD,CAAC,CACH,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QAC7G,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5E,MAAM,GAAG,GAA6D;YACpE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE;YACjC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC;SACxB,CAAC;QACF,IAAI,SAAS;YAAE,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;QACzC,IAAI,UAAU;YAAE,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;QAC5C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,qGAAqG;IAC7F,KAAK,CAAC,6BAA6B,CACzC,OAAe;QAEf,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAC/E,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QAC7G,MAAM,GAAG,GAA6C,EAAE,CAAC;QACzD,IAAI,OAAO,CAAC,QAAQ;YAAE,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACtD,MAAM,SAAS,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;QACrC,IAAI,SAAS;YAAE,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;QACzC,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;QACrC,IAAI,UAAU;YAAE,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;QAC5C,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,CAAa,EACb,iBAA4D;QAE5D,IAAI,SAAuC,CAAC;QAC5C,IAAI,QAA4B,CAAC;QACjC,MAAM,KAAK,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;YAC1D,SAAS,GAAG,KAAK,CAAC;YAClB,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC;YACvC,IAAI,CAAC,KAAK,CAAC,OAAO;gBAAE,KAAK,CAAC,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClE,CAAC;aAAM,IAAI,iBAAiB,EAAE,CAAC;YAC7B,SAAS,GAAG,iBAAiB,CAAC;YAC9B,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC;QACxC,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1F,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAuC,EAAE,GAAG,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9E,IAAI,QAAQ;YAAE,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACtC,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,KAA4B;QACvD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,UAAU,CAAC,sBAAsB,EAAE,+BAA+B,CAAC,CAAC;QAC9F,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,EAAE;YAAE,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,CAAa;QAC7B,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,GAAG,EAAE,CACH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YAC7B,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;SACrE,CAAC,EACJ,0BAA0B,EAC1B,kCAAkC,CACnC,CAAC;QACF,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,CAAa;QAC9C,wEAAwE;QACxE,oEAAoE;QACpE,MAAM,QAAQ,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC;QACpG,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YAC7B,MAAM,EAAE,IAAI;YACZ,EAAE,EAAE,OAAO;YACX,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;SACrE,CAAC,CACH,CAAC;QACF,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAuC;QAChD,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,EACxF,0BAA0B,EAC1B,kCAAkC,CACnC,CAAC;YACF,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;YACjE,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,0CAA0C,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,GAAG,EAAE,CACH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC7B,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;SACxD,CAAC,EACJ,0BAA0B,EAC1B,kCAAkC,CACnC,CAAC;QACF,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAa,EAAE,MAAoB;QAC9C,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,OAAO;QAExB,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtE,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;gBACrB,IAAI,MAAM,KAAK,OAAO;oBAAE,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;qBAChG,IAAI,MAAM,KAAK,SAAS;oBAAE,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;;oBACzG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YACrF,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,WAAW,GAAa,EAAE,CAAC;QAC/B,IAAI,cAAc,GAAa,EAAE,CAAC;QAClC,IAAI,MAAM,KAAK,UAAU;YAAE,cAAc,GAAG,CAAC,QAAQ,CAAC,CAAC;aAClD,IAAI,MAAM,KAAK,YAAY;YAAE,WAAW,GAAG,CAAC,QAAQ,CAAC,CAAC;aACtD,IAAI,MAAM,KAAK,MAAM;YAAE,WAAW,GAAG,CAAC,SAAS,CAAC,CAAC;aACjD,IAAI,MAAM,KAAK,QAAQ;YAAE,cAAc,GAAG,CAAC,SAAS,CAAC,CAAC;aACtD,IAAI,MAAM,KAAK,SAAS;YAAE,cAAc,GAAG,CAAC,OAAO,CAAC,CAAC;aACrD,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACzC,MAAM,IAAI,UAAU,CAClB,iBAAiB,EACjB,4BAA4B,IAAI,oCAAoC,CACrE,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,mEAAmE;gBACnE,cAAc,GAAG,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC5D,WAAW,GAAG,CAAC,MAAM,CAAC,CAAC;gBACvB,IAAI,MAAM,KAAK,OAAO;oBAAE,cAAc,GAAG,CAAC,OAAO,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;aAAM,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACxB,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,qDAAqD,CAAC,CAAC;YACjG,CAAC;YACD,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3F,CAAC;aAAM,IAAI,cAAc,IAAI,MAAM,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;YACjD,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACxB,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,qDAAqD,CAAC,CAAC;YACjG,CAAC;YACD,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxF,CAAC;QAED,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC;YACzE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAAC,CAAC;YAC/D,MAAM,SAAS,CAAC,GAAG,EAAE,CACnB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACpC,MAAM,EAAE,IAAI;gBACZ,WAAW,EAAE;oBACX,GAAG,EAAE,KAAK;oBACV,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC9C,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACrD;aACF,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,YAAoB;QACzD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAC/E,CAAC;QACF,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,UAAU,CAAC,WAAW,EAAE,cAAc,YAAY,yBAAyB,SAAS,EAAE,CAAC,CAAC;QACnH,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC;QAChE,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CACzF,CAAC;QACF,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI;YAAE,MAAM,IAAI,UAAU,CAAC,sBAAsB,EAAE,mCAAmC,CAAC,CAAC;QAC7G,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC5E,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { GmailProvider, GMAIL_CAPABILITIES, type GmailProviderOptions } from './gmailProvider.js';
+export { toGmailQuery } from './query.js';
+export { parseGmailMessage, walkParts } from './parse.js';
+export { toEmailError, withRetry } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { GmailProvider, GMAIL_CAPABILITIES } from './gmailProvider.js';
+export { toGmailQuery } from './query.js';
+export { parseGmailMessage, walkParts } from './parse.js';
+export { toEmailError, withRetry } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAA6B,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/mime.d.ts

@@ -0,0 +1,8 @@
+import { type DraftInput, type EmailAddress } from '@fluxmail/core';
+export interface ThreadingHeaders {
+    inReplyTo?: string;
+    references?: string;
+}
+/** Build a raw RFC 5322 message from a DraftInput. */
+export declare function buildRawMessage(draft: DraftInput, from: EmailAddress, threading?: ThreadingHeaders): Promise<Buffer>;
+//# sourceMappingURL=mime.d.ts.map

package/dist/mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../src/mime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhF,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAuBD,sDAAsD;AACtD,wBAAsB,eAAe,CACnC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,YAAY,EAClB,SAAS,CAAC,EAAE,gBAAgB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAgCjB"}

package/dist/mime.js

@@ -0,0 +1,61 @@
+import MailComposer from 'nodemailer/lib/mail-composer/index.js';
+import { EmailError } from '@fluxmail/core';
+function toMailAddresses(addrs) {
+    if (!addrs?.length)
+        return undefined;
+    return addrs.map((a) => ({ name: a.name ?? '', address: a.email }));
+}
+function decodeAttachmentContent(rawContent) {
+    // RFC 2045 base64 may be wrapped in whitespace (e.g. `base64` CLI output).
+    const content = rawContent.replace(/\s+/g, '');
+    if (content === '')
+        return Buffer.alloc(0);
+    if (!/^[A-Za-z0-9+/]*={0,2}$/.test(content) || content.length % 4 === 1) {
+        throw new EmailError('invalid_request', 'Attachment content must be valid base64');
+    }
+    const unpadded = content.replace(/=+$/, '');
+    const padded = unpadded + '='.repeat((4 - (unpadded.length % 4)) % 4);
+    const decoded = Buffer.from(padded, 'base64');
+    if (decoded.toString('base64').replace(/=+$/, '') !== unpadded) {
+        throw new EmailError('invalid_request', 'Attachment content must be valid base64');
+    }
+    return decoded;
+}
+/** Build a raw RFC 5322 message from a DraftInput. */
+export async function buildRawMessage(draft, from, threading) {
+    const options = {
+        from: { name: from.name ?? '', address: from.email },
+        to: toMailAddresses(draft.to),
+        cc: toMailAddresses(draft.cc),
+        bcc: toMailAddresses(draft.bcc),
+        subject: draft.subject ?? '',
+        text: draft.body.text,
+        html: draft.body.html,
+        attachments: draft.attachments?.map((a) => ({
+            filename: a.filename,
+            content: decodeAttachmentContent(a.content),
+            contentType: a.mimeType,
+            ...(a.contentId ? { cid: a.contentId } : {}),
+            ...(a.disposition ? { contentDisposition: a.disposition } : {}),
+        })),
+    };
+    if (threading?.inReplyTo)
+        options.inReplyTo = threading.inReplyTo;
+    if (threading?.references)
+        options.references = threading.references;
+    const composer = new MailComposer(options);
+    const compiled = composer.compile();
+    // Gmail derives recipients from the raw headers; without this the Bcc header
+    // (which MailComposer strips by default) never reaches Gmail and bcc
+    // recipients silently get nothing. Gmail removes it before delivery.
+    compiled.keepBcc = true;
+    return new Promise((resolve, reject) => {
+        compiled.build((err, message) => {
+            if (err)
+                reject(err);
+            else
+                resolve(message);
+        });
+    });
+}
+//# sourceMappingURL=mime.js.map

package/dist/mime.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,39 @@
+import type { gmail_v1 } from 'googleapis';
+import { type AttachmentMeta, type Message, type MessageBody } from '@fluxmail/core';
+export declare function decodeBase64Url(data: string): Buffer;
+export declare function encodeBase64Url(data: Buffer): string;
+export declare function decodeTextPart(part: gmail_v1.Schema$MessagePart, encoded?: string): string;
+type BodyField = 'text' | 'html';
+export interface ExternalBodyPart {
+    attachmentId: string;
+    part: gmail_v1.Schema$MessagePart;
+}
+export type ExternalBodyParts = Partial<Record<BodyField, ExternalBodyPart>>;
+interface WalkedParts {
+    body: MessageBody;
+    attachments: AttachmentMeta[];
+    externalBodyParts: ExternalBodyParts;
+}
+interface ParsedAttachment {
+    meta: AttachmentMeta;
+    content?: Buffer;
+}
+/** Walk the MIME tree collecting the preferred text/html bodies and attachment metadata. */
+export declare function walkParts(payload: gmail_v1.Schema$MessagePart | undefined): WalkedParts;
+export declare function findAttachment(payload: gmail_v1.Schema$MessagePart | undefined, attachmentId: string): ParsedAttachment | undefined;
+export interface ParseContext {
+    accountId: string;
+    /** Gmail label id -> display name, for translating labelIds. */
+    labelNames: Map<string, string>;
+    includeBody: boolean;
+    /** Set only when the Gmail response includes the MIME payload. */
+    includeAttachments?: boolean;
+    includeHeaders?: boolean;
+}
+export declare function parseGmailMessage(msg: gmail_v1.Schema$Message, ctx: ParseContext): Message;
+export declare function parseGmailMessageWithParts(msg: gmail_v1.Schema$Message, ctx: ParseContext): {
+    message: Message;
+    externalBodyParts: ExternalBodyParts;
+};
+export {};
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAEL,KAAK,cAAc,EAGnB,KAAK,OAAO,EACZ,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAExB,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAMD,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,EAAE,OAAO,SAAwB,GAAG,MAAM,CAMzG;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjC,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAE7E,UAAU,WAAW;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED,UAAU,gBAAgB;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsDD,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,kBAAkB,GAAG,SAAS,GAAG,WAAW,CA2BvF;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,QAAQ,CAAC,kBAAkB,GAAG,SAAS,EAChD,YAAY,EAAE,MAAM,GACnB,gBAAgB,GAAG,SAAS,CAa9B;AAuBD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAE1F;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,QAAQ,CAAC,cAAc,EAC5B,GAAG,EAAE,YAAY,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,iBAAiB,EAAE,iBAAiB,CAAA;CAAE,CAqD5D"}

package/dist/parse.js

@@ -0,0 +1,190 @@
+import iconv from 'iconv-lite';
+import { parseAddressList, } from '@fluxmail/core';
+export function decodeBase64Url(data) {
+    return Buffer.from(data.replace(/-/g, '+').replace(/_/g, '/'), 'base64');
+}
+export function encodeBase64Url(data) {
+    return data.toString('base64').replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+function headerValue(payload, name) {
+    return payload?.headers?.find((h) => h.name?.toLowerCase() === name.toLowerCase())?.value ?? undefined;
+}
+export function decodeTextPart(part, encoded = part.body?.data ?? '') {
+    const data = decodeBase64Url(encoded);
+    const contentType = headerValue(part, 'Content-Type') ?? '';
+    const charset = contentType.match(/charset\s*=\s*(?:"([^"]+)"|'([^']+)'|([^;\s]+))/i);
+    const encoding = charset?.[1] ?? charset?.[2] ?? charset?.[3] ?? 'utf-8';
+    return iconv.decode(data, iconv.encodingExists(encoding) ? encoding : 'utf-8');
+}
+function parseAttachment(part, path) {
+    const body = part.body;
+    const rawContentId = headerValue(part, 'Content-ID')?.trim();
+    const contentId = rawContentId?.replace(/^<|>$/g, '');
+    const rawDisposition = headerValue(part, 'Content-Disposition')?.split(';', 1)[0]?.trim().toLowerCase();
+    const isMessageBody = part.mimeType === 'text/plain' || part.mimeType === 'text/html';
+    const hasContent = body?.attachmentId != null || body?.data != null;
+    const isAttachment = !!part.filename ||
+        rawDisposition === 'attachment' ||
+        (!isMessageBody && !part.mimeType?.startsWith('multipart/') && (hasContent || !!contentId || rawDisposition === 'inline'));
+    if (!isAttachment)
+        return undefined;
+    const disposition = rawDisposition === 'inline' || rawDisposition === 'attachment'
+        ? rawDisposition
+        : contentId
+            ? 'inline'
+            : undefined;
+    const metadata = {
+        ...(contentId ? { contentId } : {}),
+        ...(disposition ? { disposition } : {}),
+    };
+    const fallbackId = part.partId ?? path.join('.');
+    const filename = part.filename || `${disposition === 'inline' ? 'inline' : 'attachment'}-${fallbackId}`;
+    if (body?.attachmentId) {
+        return {
+            meta: {
+                id: body.attachmentId,
+                filename,
+                mimeType: part.mimeType ?? '',
+                sizeBytes: body.size ?? 0,
+                ...metadata,
+            },
+        };
+    }
+    if (body?.data != null) {
+        const content = decodeBase64Url(body.data);
+        return {
+            meta: {
+                id: `inline:${part.partId ?? path.join('.')}`,
+                filename,
+                mimeType: part.mimeType ?? '',
+                sizeBytes: body.size ?? content.length,
+                ...metadata,
+            },
+            content,
+        };
+    }
+    return undefined;
+}
+/** Walk the MIME tree collecting the preferred text/html bodies and attachment metadata. */
+export function walkParts(payload) {
+    const result = { body: {}, attachments: [], externalBodyParts: {} };
+    if (!payload)
+        return result;
+    const visit = (part, partPath) => {
+        const mimeType = part.mimeType ?? '';
+        const attachment = parseAttachment(part, partPath);
+        if (attachment) {
+            result.attachments.push(attachment.meta);
+            return;
+        }
+        const bodyField = mimeType === 'text/plain' ? 'text' : mimeType === 'text/html' ? 'html' : undefined;
+        if (bodyField && result.body[bodyField] === undefined && result.externalBodyParts[bodyField] === undefined) {
+            if (part.body?.data != null) {
+                result.body[bodyField] = decodeTextPart(part);
+                return;
+            }
+            if (part.body?.attachmentId) {
+                result.externalBodyParts[bodyField] = { attachmentId: part.body.attachmentId, part };
+                return;
+            }
+        }
+        for (const [index, child] of (part.parts ?? []).entries())
+            visit(child, [...partPath, index]);
+    };
+    visit(payload, [0]);
+    return result;
+}
+export function findAttachment(payload, attachmentId) {
+    if (!payload)
+        return undefined;
+    const visit = (part, partPath) => {
+        const attachment = parseAttachment(part, partPath);
+        if (attachment?.meta.id === attachmentId)
+            return attachment;
+        for (const [index, child] of (part.parts ?? []).entries()) {
+            const found = visit(child, [...partPath, index]);
+            if (found)
+                return found;
+        }
+        return undefined;
+    };
+    return visit(payload, [0]);
+}
+/** System labels that pin a message's canonical location, most specific first. */
+const LOCATION_LABEL_ROLES = [
+    ['TRASH', 'trash'],
+    ['SPAM', 'spam'],
+    ['DRAFT', 'drafts'],
+    ['INBOX', 'inbox'],
+    ['SENT', 'sent'],
+];
+/** Gmail has no archive label: archived mail is whatever carries no location label. */
+function deriveFolder(labelIds, labelNames) {
+    for (const [labelId, role] of LOCATION_LABEL_ROLES) {
+        if (labelIds.includes(labelId)) {
+            return { id: labelId, name: labelNames.get(labelId) ?? labelId, role };
+        }
+    }
+    return { id: 'archive', name: 'Archive', role: 'archive' };
+}
+const INTERESTING_HEADERS = ['message-id', 'in-reply-to', 'references', 'list-unsubscribe'];
+export function parseGmailMessage(msg, ctx) {
+    return parseGmailMessageWithParts(msg, ctx).message;
+}
+export function parseGmailMessageWithParts(msg, ctx) {
+    const payload = msg.payload;
+    const labelIds = msg.labelIds ?? [];
+    const from = parseAddressList(headerValue(payload, 'From'))[0];
+    const dateHeader = headerValue(payload, 'Date');
+    const dateMs = msg.internalDate ? Number(msg.internalDate) : dateHeader ? Date.parse(dateHeader) : Date.now();
+    const message = {
+        id: msg.id ?? '',
+        threadId: msg.threadId ?? msg.id ?? '',
+        accountId: ctx.accountId,
+        folder: deriveFolder(labelIds, ctx.labelNames),
+        labels: labelIds
+            .filter((id) => !id.startsWith('CATEGORY_'))
+            .map((id) => ctx.labelNames.get(id) ?? id),
+        to: parseAddressList(headerValue(payload, 'To')),
+        subject: headerValue(payload, 'Subject') ?? '',
+        date: new Date(dateMs).toISOString(),
+        flags: {
+            read: !labelIds.includes('UNREAD'),
+            starred: labelIds.includes('STARRED'),
+            draft: labelIds.includes('DRAFT'),
+        },
+    };
+    if (from)
+        message.from = from;
+    const cc = parseAddressList(headerValue(payload, 'Cc'));
+    if (cc.length)
+        message.cc = cc;
+    const bcc = parseAddressList(headerValue(payload, 'Bcc'));
+    if (bcc.length)
+        message.bcc = bcc;
+    const replyTo = parseAddressList(headerValue(payload, 'Reply-To'));
+    if (replyTo.length)
+        message.replyTo = replyTo;
+    if (msg.snippet)
+        message.snippet = msg.snippet;
+    let externalBodyParts = {};
+    if (ctx.includeBody || ctx.includeAttachments) {
+        const walked = walkParts(payload);
+        if (ctx.includeAttachments)
+            message.attachments = walked.attachments;
+        if (ctx.includeBody)
+            message.body = walked.body;
+        externalBodyParts = walked.externalBodyParts;
+    }
+    if (ctx.includeHeaders) {
+        const headers = {};
+        for (const h of payload?.headers ?? []) {
+            if (h.name && h.value && INTERESTING_HEADERS.includes(h.name.toLowerCase())) {
+                headers[h.name] = h.value;
+            }
+        }
+        message.headers = headers;
+    }
+    return { message, externalBodyParts };
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EACL,gBAAgB,GAMjB,MAAM,gBAAgB,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,WAAW,CAAC,OAAgD,EAAE,IAAY;IACjF,OAAO,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,KAAK,IAAI,SAAS,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAiC,EAAE,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE;IAC/F,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,CAAC;IAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IACzE,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACjF,CAAC;AAsBD,SAAS,eAAe,CAAC,IAAiC,EAAE,IAAc;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC;IAC7D,MAAM,SAAS,GAAG,YAAY,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,EAAE,qBAAqB,CAAC,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxG,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,KAAK,YAAY,IAAI,IAAI,CAAC,QAAQ,KAAK,WAAW,CAAC;IACtF,MAAM,UAAU,GAAG,IAAI,EAAE,YAAY,IAAI,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;IACpE,MAAM,YAAY,GAChB,CAAC,CAAC,IAAI,CAAC,QAAQ;QACf,cAAc,KAAK,YAAY;QAC/B,CAAC,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,IAAI,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC;IAC7H,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IAEpC,MAAM,WAAW,GACf,cAAc,KAAK,QAAQ,IAAI,cAAc,KAAK,YAAY;QAC5D,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,SAAS;YACT,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,SAAS,CAAC;IAClB,MAAM,QAAQ,GAAG;QACf,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,IAAI,UAAU,EAAE,CAAC;IACxG,IAAI,IAAI,EAAE,YAAY,EAAE,CAAC;QACvB,OAAO;YACL,IAAI,EAAE;gBACJ,EAAE,EAAE,IAAI,CAAC,YAAY;gBACrB,QAAQ;gBACR,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;gBAC7B,SAAS,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;gBACzB,GAAG,QAAQ;aACZ;SACF,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO;YACL,IAAI,EAAE;gBACJ,EAAE,EAAE,UAAU,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;gBAC7C,QAAQ;gBACR,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;gBAC7B,SAAS,EAAE,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM;gBACtC,GAAG,QAAQ;aACZ;YACD,OAAO;SACR,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,SAAS,CAAC,OAAgD;IACxE,MAAM,MAAM,GAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC;IACjF,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAE5B,MAAM,KAAK,GAAG,CAAC,IAAiC,EAAE,QAAkB,EAAE,EAAE;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GACb,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACrF,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3G,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;gBAC9C,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;gBAC5B,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;gBACrF,OAAO;YACT,CAAC;QACH,CAAC;QACD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;YAAE,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAChG,CAAC,CAAC;IACF,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAgD,EAChD,YAAoB;IAEpB,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,MAAM,KAAK,GAAG,CAAC,IAAiC,EAAE,QAAkB,EAAgC,EAAE;QACpG,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,UAAU,EAAE,IAAI,CAAC,EAAE,KAAK,YAAY;YAAE,OAAO,UAAU,CAAC;QAC5D,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;YACjD,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;QAC1B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IACF,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,kFAAkF;AAClF,MAAM,oBAAoB,GAAgC;IACxD,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,OAAO,EAAE,QAAQ,CAAC;IACnB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,MAAM,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,uFAAuF;AACvF,SAAS,YAAY,CAAC,QAAkB,EAAE,UAA+B;IACvE,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,oBAAoB,EAAE,CAAC;QACnD,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,mBAAmB,GAAG,CAAC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC;AAY5F,MAAM,UAAU,iBAAiB,CAAC,GAA4B,EAAE,GAAiB;IAC/E,OAAO,0BAA0B,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,GAA4B,EAC5B,GAAiB;IAEjB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAE9G,MAAM,OAAO,GAAY;QACvB,EAAE,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE;QACtC,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC;QAC9C,MAAM,EAAE,QAAQ;aACb,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;aAC3C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5C,EAAE,EAAE,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChD,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE;QAC9C,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE;QACpC,KAAK,EAAE;YACL,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAClC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;YACrC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;SAClC;KACF,CAAC;IAEF,IAAI,IAAI;QAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,GAAG,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACxD,IAAI,EAAE,CAAC,MAAM;QAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1D,IAAI,GAAG,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;IAClC,MAAM,OAAO,GAAG,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;IAC9C,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAE/C,IAAI,iBAAiB,GAAsB,EAAE,CAAC;IAC9C,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,GAAG,CAAC,kBAAkB;YAAE,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACrE,IAAI,GAAG,CAAC,WAAW;YAAE,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QAChD,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAC/C,CAAC;IAED,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;QACvB,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBAC5E,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AACxC,CAAC"}

package/dist/query.d.ts

@@ -0,0 +1,13 @@
+import { type EmailQuery } from '@fluxmail/core';
+export declare const ROLE_TO_LABEL: Record<string, string>;
+export interface GmailQuery {
+    q?: string;
+    labelIds?: string[];
+    includeSpamTrash?: boolean;
+}
+/**
+ * Translate the unified EmailQuery into Gmail's q= syntax + labelIds.
+ * `resolveLabelId` maps a user folder name/id to a Gmail label id (null if unknown).
+ */
+export declare function toGmailQuery(q: EmailQuery, resolveLabelId: (folder: string) => string | null): GmailQuery;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOhD,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAcD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,UAAU,EACb,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAChD,UAAU,CAkCZ"}

package/dist/query.js

@@ -0,0 +1,73 @@
+import { EmailError } from '@fluxmail/core';
+export const ROLE_TO_LABEL = {
+    inbox: 'INBOX',
+    sent: 'SENT',
+    drafts: 'DRAFT',
+    trash: 'TRASH',
+    spam: 'SPAM',
+    starred: 'STARRED',
+};
+function quote(value) {
+    return /[\s"]/.test(value) ? `"${value.replace(/"/g, '\\"')}"` : value;
+}
+function epochSeconds(iso, field) {
+    const millis = new Date(iso).getTime();
+    if (!Number.isFinite(millis)) {
+        throw new EmailError('invalid_request', `${field} must be a valid ISO date, got "${iso}"`);
+    }
+    return Math.floor(millis / 1000);
+}
+/**
+ * Translate the unified EmailQuery into Gmail's q= syntax + labelIds.
+ * `resolveLabelId` maps a user folder name/id to a Gmail label id (null if unknown).
+ */
+export function toGmailQuery(q, resolveLabelId) {
+    const parts = [];
+    const out = {};
+    if (q.folder) {
+        const role = q.folder.toLowerCase();
+        if (role === 'archive') {
+            parts.push('in:archive');
+        }
+        else if (role === 'all') {
+            parts.push('in:anywhere');
+            out.includeSpamTrash = true;
+        }
+        else if (ROLE_TO_LABEL[role]) {
+            out.labelIds = [ROLE_TO_LABEL[role]];
+            if (role === 'trash' || role === 'spam')
+                out.includeSpamTrash = true;
+        }
+        else {
+            const labelId = resolveLabelId(q.folder);
+            if (labelId)
+                out.labelIds = [labelId];
+            else
+                parts.push(`label:${quote(q.folder)}`);
+        }
+    }
+    if (q.text)
+        parts.push(q.text);
+    if (q.from)
+        parts.push(`from:${quote(q.from)}`);
+    if (q.to)
+        parts.push(`to:${quote(q.to)}`);
+    if (q.subject)
+        parts.push(`subject:${quote(q.subject)}`);
+    if (q.unreadOnly)
+        parts.push('is:unread');
+    if (q.starredOnly)
+        parts.push('is:starred');
+    if (q.hasAttachment)
+        parts.push('has:attachment');
+    if (q.after)
+        parts.push(`after:${epochSeconds(q.after, 'after')}`);
+    if (q.before)
+        parts.push(`before:${epochSeconds(q.before, 'before')}`);
+    if (q.rawProviderQuery)
+        parts.push(q.rawProviderQuery);
+    if (parts.length)
+        out.q = parts.join(' ');
+    return out;
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@fluxmail/provider-gmail",
+  "version": "0.1.0",
+  "description": "Gmail adapter for the Fluxmail unified email API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "googleapis": "^173.0.0",
+    "googleapis-common": "8.0.2",
+    "iconv-lite": "^0.7.3",
+    "nodemailer": "^9.0.3",
+    "@fluxmail/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "@types/nodemailer": "^8.0.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}