@fluxmail/core 0.1.0

package/dist/addresses.d.ts

@@ -0,0 +1,5 @@
+import type { EmailAddress } from './types.js';
+/** Parse an RFC 5322 address list ("Ann <a@x.com>, b@y.com") into structured addresses. */
+export declare function parseAddressList(raw: string | undefined): EmailAddress[];
+export declare function parseSingleAddress(raw: string): EmailAddress | null;
+//# sourceMappingURL=addresses.d.ts.map

package/dist/addresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.d.ts","sourceRoot":"","sources":["../src/addresses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,EAAE,CAoBxE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAanE"}

package/dist/addresses.js

@@ -0,0 +1,48 @@
+/** Parse an RFC 5322 address list ("Ann <a@x.com>, b@y.com") into structured addresses. */
+export function parseAddressList(raw) {
+    if (!raw)
+        return [];
+    const out = [];
+    let depth = 0;
+    let inQuotes = false;
+    let current = '';
+    const flush = () => {
+        const addr = parseSingleAddress(current.trim());
+        if (addr)
+            out.push(addr);
+        current = '';
+    };
+    for (const ch of raw) {
+        if (ch === '"')
+            inQuotes = !inQuotes;
+        else if (!inQuotes && ch === '(')
+            depth++;
+        else if (!inQuotes && ch === ')')
+            depth = Math.max(0, depth - 1);
+        if (ch === ',' && !inQuotes && depth === 0)
+            flush();
+        else
+            current += ch;
+    }
+    flush();
+    return out;
+}
+export function parseSingleAddress(raw) {
+    if (!raw)
+        return null;
+    const angled = raw.match(/^\s*(?:"?([^"]*)"?\s+)?<([^>]+)>\s*$/);
+    if (angled?.[2]) {
+        const name = angled[1]?.trim();
+        const email = angled[2].trim();
+        if (!/^[^\s<>,;@]+@[^\s<>,;@]+$/.test(email))
+            return null;
+        return { email, ...(name ? { name } : {}) };
+    }
+    if ((raw.match(/@/g) ?? []).length !== 1)
+        return null;
+    const bare = raw.match(/[^\s<>,;@]+@[^\s<>,;@]+/);
+    if (bare)
+        return { email: bare[0] };
+    return null;
+}
+//# sourceMappingURL=addresses.js.map

package/dist/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../src/addresses.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAAC,GAAuB;IACtD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,GAAG,EAAE,CAAC;IACf,CAAC,CAAC;IACF,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,EAAE,KAAK,GAAG;YAAE,QAAQ,GAAG,CAAC,QAAQ,CAAC;aAChC,IAAI,CAAC,QAAQ,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aACrC,IAAI,CAAC,QAAQ,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACjE,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,QAAQ,IAAI,KAAK,KAAK,CAAC;YAAE,KAAK,EAAE,CAAC;;YAC/C,OAAO,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,KAAK,EAAE,CAAC;IACR,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACjE,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1D,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAClD,IAAI,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,9 @@
+export type EmailErrorCode = 'auth_expired' | 'rate_limited' | 'not_found' | 'invalid_request' | 'provider_unavailable' | 'entitlement_exceeded' | 'unsupported_capability';
+export declare class EmailError extends Error {
+    readonly code: EmailErrorCode;
+    /** Machine-readable extras, e.g. { reauthUrl } for auth_expired. */
+    readonly data?: Record<string, unknown>;
+    constructor(code: EmailErrorCode, message: string, data?: Record<string, unknown>);
+}
+export declare function isEmailError(err: unknown): err is EmailError;
+//# 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,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,cAAc,GACd,WAAW,GACX,iBAAiB,GACjB,sBAAsB,GACtB,sBAAsB,GACtB,wBAAwB,CAAC;AAE7B,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE5B,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMlF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAE5D"}

package/dist/errors.js

@@ -0,0 +1,15 @@
+export class EmailError extends Error {
+    code;
+    /** Machine-readable extras, e.g. { reauthUrl } for auth_expired. */
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.name = 'EmailError';
+        this.code = code;
+        this.data = data;
+    }
+}
+export function isEmailError(err) {
+    return err instanceof EmailError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IAC9B,oEAAoE;IAC3D,IAAI,CAA2B;IAExC,YAAY,IAAoB,EAAE,OAAe,EAAE,IAA8B;QAC/E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,GAAG,YAAY,UAAU,CAAC;AACnC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './provider.js';
+export * from './reply.js';
+export * from './addresses.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,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './provider.js';
+export * from './reply.js';
+export * from './addresses.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,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,35 @@
+import type { AttachmentMeta, Capabilities, DraftInput, EmailQuery, Folder, Message, ModifyAction, Page, PageOpts, SendResult, Thread } from './types.js';
+export interface GetMessageOpts {
+    /** Include selected RFC 5322 headers (Message-ID, References, ...). */
+    includeHeaders?: boolean;
+}
+/**
+ * The unified provider contract. Every provider package (gmail, outlook, imap)
+ * implements exactly this; nothing above this layer knows which provider it
+ * is talking to.
+ */
+export interface EmailProvider {
+    readonly capabilities: Capabilities;
+    /** Cheap connectivity + auth check. Throws EmailError('auth_expired') on bad credentials. */
+    testConnection(): Promise<void>;
+    /** Metadata-level listing (no bodies). */
+    listMessages(q: EmailQuery, page?: PageOpts): Promise<Page<Message>>;
+    /** Full message including body and attachment metadata. */
+    getMessage(id: string, opts?: GetMessageOpts): Promise<Message>;
+    getThread(threadId: string): Promise<Thread>;
+    listFolders(): Promise<Folder[]>;
+    createDraft(d: DraftInput): Promise<Message>;
+    /** Fetch a draft by draft id (message with draftId populated). */
+    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=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,UAAU,EACV,UAAU,EACV,MAAM,EACN,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,MAAM,EACP,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAEpC,6FAA6F;IAC7F,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC,0CAA0C;IAC1C,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,2DAA2D;IAC3D,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjC,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEnE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD"}

package/dist/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":""}

package/dist/reply.d.ts

@@ -0,0 +1,18 @@
+import type { EmailAddress, Message } from './types.js';
+export interface ReplyRecipients {
+    to: EmailAddress[];
+    cc: EmailAddress[];
+}
+/**
+ * Compute reply / reply-all recipients from the original message. Provider-agnostic:
+ * reply targets Reply-To (falling back to From); reply-all additionally includes the
+ * original To/Cc, minus the replying account's own address.
+ */
+export declare function computeReplyRecipients(original: Message, ownAddress: string, replyAll: boolean): ReplyRecipients;
+/** "Re: subject" without stacking prefixes. */
+export declare function replySubject(subject: string): string;
+/** "Fwd: subject" without stacking prefixes. */
+export declare function forwardSubject(subject: string): string;
+export declare function formatAddress(a: EmailAddress): string;
+export declare function formatAddressList(addrs: EmailAddress[] | undefined): string;
+//# sourceMappingURL=reply.d.ts.map

package/dist/reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../src/reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,YAAY,EAAE,CAAC;IACnB,EAAE,EAAE,YAAY,EAAE,CAAC;CACpB;AAeD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,GAChB,eAAe,CAejB;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAErD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,SAAS,GAAG,MAAM,CAE3E"}

package/dist/reply.js

@@ -0,0 +1,45 @@
+function sameAddress(a, b) {
+    return a.email.trim().toLowerCase() === b.email.trim().toLowerCase();
+}
+function dedupe(addrs) {
+    const out = [];
+    for (const a of addrs) {
+        if (!a.email)
+            continue;
+        if (!out.some((b) => sameAddress(a, b)))
+            out.push(a);
+    }
+    return out;
+}
+/**
+ * Compute reply / reply-all recipients from the original message. Provider-agnostic:
+ * reply targets Reply-To (falling back to From); reply-all additionally includes the
+ * original To/Cc, minus the replying account's own address.
+ */
+export function computeReplyRecipients(original, ownAddress, replyAll) {
+    const self = { email: ownAddress };
+    const replyTarget = original.replyTo?.length ? original.replyTo : original.from ? [original.from] : [];
+    if (!replyAll) {
+        const to = dedupe(replyTarget).filter((a) => !sameAddress(a, self));
+        // Replying to yourself (e.g. a note in Sent): fall back to the original To.
+        return { to: to.length ? to : dedupe(original.to), cc: [] };
+    }
+    const to = dedupe([...replyTarget, ...original.to]).filter((a) => !sameAddress(a, self));
+    const cc = dedupe(original.cc ?? []).filter((a) => !sameAddress(a, self) && !to.some((b) => sameAddress(a, b)));
+    return { to: to.length ? to : [self], cc };
+}
+/** "Re: subject" without stacking prefixes. */
+export function replySubject(subject) {
+    return /^\s*re:/i.test(subject) ? subject : `Re: ${subject}`;
+}
+/** "Fwd: subject" without stacking prefixes. */
+export function forwardSubject(subject) {
+    return /^\s*fwd?:/i.test(subject) ? subject : `Fwd: ${subject}`;
+}
+export function formatAddress(a) {
+    return a.name ? `${a.name} <${a.email}>` : a.email;
+}
+export function formatAddressList(addrs) {
+    return (addrs ?? []).map(formatAddress).join(', ');
+}
+//# sourceMappingURL=reply.js.map

package/dist/reply.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,145 @@
+export type Provider = 'gmail' | 'outlook' | 'imap';
+export interface Capabilities {
+    /** Gmail: many-to-many labels. Outlook/IMAP: a message lives in exactly one folder. */
+    labels: boolean;
+    /** Gmail/Outlook thread server-side; IMAP threads are synthesized from References headers. */
+    serverThreads: boolean;
+    /** Gmail q= / Graph $search vs IMAP SEARCH. */
+    serverSearch: 'rich' | 'basic';
+    /** Whether list results include snippets without fetching bodies. */
+    snippets: boolean;
+}
+export interface Account {
+    id: string;
+    provider: Provider;
+    email: string;
+    displayName?: string;
+    status: 'active' | 'auth_error' | 'disabled';
+    capabilities: Capabilities;
+    /** Owning member on the instance; absent means the mailbox is shared. */
+    memberId?: string;
+}
+export interface EmailAddress {
+    name?: string;
+    email: string;
+}
+export type FolderRole = 'inbox' | 'sent' | 'drafts' | 'trash' | 'spam' | 'archive' | 'starred' | 'all';
+export interface Folder {
+    id: string;
+    /** Display path, e.g. "Projects/2026". */
+    name: string;
+    role?: FolderRole;
+    unreadCount?: number;
+}
+export interface AttachmentMeta {
+    id: string;
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    /** RFC Content-ID without angle brackets, used by HTML cid: references. */
+    contentId?: string;
+    disposition?: 'inline' | 'attachment';
+}
+export interface MessageBody {
+    text?: string;
+    html?: string;
+}
+export interface MessageFlags {
+    read: boolean;
+    starred: boolean;
+    draft: boolean;
+}
+export interface Message {
+    id: string;
+    threadId: string;
+    accountId: string;
+    /** Present when this message is a draft; use with updateDraft/deleteDraft/send. */
+    draftId?: string;
+    /** Canonical location. Gmail: derived from labels; Outlook/IMAP: the containing folder. */
+    folder?: Folder;
+    /** Gmail only (capabilities.labels). Label names. */
+    labels?: string[];
+    from?: EmailAddress;
+    to: EmailAddress[];
+    cc?: EmailAddress[];
+    bcc?: EmailAddress[];
+    replyTo?: EmailAddress[];
+    subject: string;
+    /** ISO 8601. */
+    date: string;
+    snippet?: string;
+    /** Populated on getMessage/getThread, not on list. */
+    body?: MessageBody;
+    /** Populated on getMessage/getThread; omitted when a list response has no MIME metadata. */
+    attachments?: AttachmentMeta[];
+    flags: MessageFlags;
+    /** Selected RFC 5322 headers (Message-ID, References, In-Reply-To, ...) when requested. */
+    headers?: Record<string, string>;
+}
+export interface Thread {
+    id: string;
+    subject: string;
+    messages: Message[];
+}
+export interface AttachmentInput {
+    filename: string;
+    mimeType: string;
+    /** Base64-encoded content. */
+    content: string;
+    /** Preserve embedded HTML images when forwarding. */
+    contentId?: string;
+    disposition?: 'inline' | 'attachment';
+}
+export interface DraftInput {
+    /** Optional when derived from a reply (replyToMessageId). */
+    to?: EmailAddress[];
+    cc?: EmailAddress[];
+    bcc?: EmailAddress[];
+    /** Defaults to "Re: ..." when replying. */
+    subject?: string;
+    body: MessageBody;
+    attachments?: AttachmentInput[];
+    /**
+     * Reply threading: the adapter resolves this message's Message-ID/References
+     * (and provider thread id) so the sent message threads correctly everywhere.
+     */
+    replyToMessageId?: string;
+}
+export interface SendResult {
+    id: string;
+    threadId: string;
+}
+export type ModifyAction = 'markRead' | 'markUnread' | 'star' | 'unstar' | 'archive' | 'trash' | 'untrash' | 'delete' | {
+    move: string;
+} | {
+    addLabels: string[];
+} | {
+    removeLabels: string[];
+};
+export interface EmailQuery {
+    /** Folder id or role. Defaults to no folder restriction. */
+    folder?: string;
+    /** Full-text search. */
+    text?: string;
+    from?: string;
+    to?: string;
+    subject?: string;
+    unreadOnly?: boolean;
+    starredOnly?: boolean;
+    hasAttachment?: boolean;
+    /** ISO date (inclusive). */
+    after?: string;
+    /** ISO date (exclusive). */
+    before?: string;
+    /** Escape hatch: passed to the provider verbatim (e.g. Gmail q=). */
+    rawProviderQuery?: string;
+}
+export interface PageOpts {
+    pageSize?: number;
+    pageToken?: string;
+}
+export interface Page<T> {
+    items: T[];
+    nextPageToken?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@fluxmail/core",
+  "version": "0.1.0",
+  "description": "Unified email types and provider interface for Fluxmail",
+  "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"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}