@c9up/goldstone 0.0.0-stage → 0.1.0

package/dist/Mailbox.js

@@ -0,0 +1,326 @@
+/**
+ * One IMAP mailbox: its connection, opened on first use, and what the
+ * application does with it.
+ *
+ *   const support = inbox.mailbox('support')
+ *   for (const uid of await support.search({ seen: false })) {
+ *     const message = await support.fetch(uid)
+ *   }
+ *   const stop = support.watch(async (message, { uid }) => { … })
+ *
+ * Every message read goes through {@link readMessage}: its size is asked of
+ * the server first, so one over the limit is refused without being
+ * downloaded; it is then parsed, and its sender checked (DKIM, SPF, DMARC)
+ * unless `authenticate: false`.
+ */
+import { ImapFlow } from "imapflow";
+import { assertSecure } from "./config.js";
+import { GoldstoneError } from "./errors.js";
+import { readMessage, } from "./ReceivedMessage.js";
+/** Wait before reconnect attempt `n`: 0.5 s, 1 s, 2 s… up to 30 s. */
+export function reconnectDelay(attempt) {
+    return Math.min(500 * 2 ** Math.max(attempt - 1, 0), 30_000);
+}
+const DEFAULT_MAX_BYTES = 25 * 1024 * 1024;
+/**
+ * Room for what is not a message in one response: SEARCH answers for a big
+ * mailbox, the framing around a literal.
+ */
+const RESPONSE_ROOM = 64 * 1024 * 1024;
+/** imapflow's codes for a response it stopped reading at the cap. */
+const OVERSIZED = new Set([
+    "LiteralTooLarge",
+    "ResponseTooLarge",
+    "LineTooLarge",
+]);
+function oversized(error) {
+    const code = typeof error === "object" && error !== null
+        ? Reflect.get(error, "code")
+        : undefined;
+    return typeof code === "string" && OVERSIZED.has(code);
+}
+export class Mailbox {
+    name;
+    #config;
+    #limits;
+    #authenticate;
+    #remoteContent;
+    #client;
+    #watches = new Set();
+    #cutOff = new WeakMap();
+    constructor(name, config, options = {}) {
+        assertSecure(name, config);
+        this.name = name;
+        this.#config = config;
+        this.#limits = options.limits;
+        this.#authenticate = options.authenticate ?? true;
+        this.#remoteContent = options.remoteContent;
+    }
+    /** Every folder's path, as the server names it. */
+    async folders() {
+        const client = await this.#connection();
+        return (await client.list()).map((folder) => folder.path);
+    }
+    /** UIDs of the messages that match, in `folder` (default `INBOX`). */
+    async search(criteria, folder = "INBOX") {
+        return this.#in(folder, async (client) => {
+            const uids = await client.search(criteria, { uid: true });
+            return Array.isArray(uids) ? [...uids].sort((a, b) => a - b) : [];
+        });
+    }
+    /**
+     * One message, parsed — or `undefined` when no message has that UID.
+     * Refused with `E_GOLDSTONE_MESSAGE_TOO_LARGE` before download when the
+     * server says it is over the limit.
+     */
+    async fetch(uid, folder = "INBOX") {
+        return this.#in(folder, (client) => this.#read(client, uid));
+    }
+    async markSeen(uids, folder = "INBOX") {
+        if (isEmpty(uids))
+            return;
+        await this.#in(folder, (client) => client.messageFlagsAdd(range(uids), ["\\Seen"], { uid: true }));
+    }
+    async markUnseen(uids, folder = "INBOX") {
+        if (isEmpty(uids))
+            return;
+        await this.#in(folder, (client) => client.messageFlagsRemove(range(uids), ["\\Seen"], { uid: true }));
+    }
+    async move(uids, to, folder = "INBOX") {
+        if (isEmpty(uids))
+            return;
+        await this.#in(folder, (client) => client.messageMove(range(uids), to, { uid: true }));
+    }
+    async delete(uids, folder = "INBOX") {
+        if (isEmpty(uids))
+            return;
+        await this.#in(folder, (client) => client.messageDelete(range(uids), { uid: true }));
+    }
+    /**
+     * Call `handler` for every new message, as it arrives (IDLE), on a
+     * connection of its own. A lost connection is reopened with a growing
+     * wait, and what arrived meanwhile is delivered on return: messages are
+     * followed by UID, so none is skipped and none delivered twice.
+     *
+     * A handler that throws does not stop the watch, and the message is not
+     * offered again — a message that always fails would otherwise stall the
+     * mailbox. Resolves the returned function once the watch has stopped.
+     */
+    watch(handler, options = {}) {
+        const folder = options.folder ?? "INBOX";
+        const report = options.onError ??
+            ((error) => console.error(`[inbox] ${this.name}/${folder}:`, error));
+        let last = options.afterUid;
+        let uidValidity;
+        let stopped = false;
+        let current;
+        let wake;
+        const deliverNew = async (client) => {
+            const after = last ?? 0;
+            const found = await client.search({ uid: `${after + 1}:*` }, { uid: true });
+            const uids = (Array.isArray(found) ? found : [])
+                .filter((uid) => uid > after)
+                .sort((a, b) => a - b);
+            for (const uid of uids) {
+                if (stopped)
+                    return;
+                try {
+                    const message = await this.#read(client, uid);
+                    if (message)
+                        await handler(message, { uid });
+                }
+                catch (error) {
+                    report(error);
+                    // The connection is gone (a server pushing more than the
+                    // limit is cut off): what is left is delivered after the
+                    // reconnection, not skipped as if it had failed. A message
+                    // over the limit is skipped: it would be refused again.
+                    if (!client.usable) {
+                        if (error instanceof GoldstoneError &&
+                            error.code === "E_GOLDSTONE_MESSAGE_TOO_LARGE") {
+                            last = uid;
+                        }
+                        return;
+                    }
+                }
+                last = uid;
+            }
+        };
+        const run = async () => {
+            let attempt = 0;
+            while (!stopped) {
+                try {
+                    const client = await this.#open();
+                    current = client;
+                    const opened = await client.mailboxOpen(folder);
+                    if (uidValidity !== undefined && opened.uidValidity !== uidValidity) {
+                        report(new GoldstoneError("E_GOLDSTONE_UIDVALIDITY_CHANGED", `[inbox] ${this.name}/${folder} renumbered its messages; watching resumes from the newest`));
+                        last = undefined;
+                    }
+                    uidValidity = opened.uidValidity;
+                    if (last === undefined)
+                        last = opened.uidNext - 1;
+                    attempt = 0;
+                    await new Promise((resolve, reject) => {
+                        // Listening before the catch-up: the server announces
+                        // mail that arrives during its FETCHes, and an EXISTS
+                        // nobody hears leaves the message waiting for the next.
+                        // Every delivery runs after the previous one.
+                        let queue = Promise.resolve();
+                        client.on("exists", () => {
+                            queue = queue.then(() => deliverNew(client)).catch(report);
+                        });
+                        client.on("close", () => resolve());
+                        client.on("error", () => { });
+                        wake = resolve;
+                        if (stopped)
+                            resolve();
+                        // A catch-up that fails reopens the connection.
+                        queue = deliverNew(client).catch(reject);
+                    });
+                }
+                catch (error) {
+                    if (!stopped)
+                        report(error);
+                }
+                current?.close();
+                current = undefined;
+                if (stopped)
+                    break;
+                attempt += 1;
+                await new Promise((resolve) => {
+                    const timer = setTimeout(resolve, reconnectDelay(attempt));
+                    wake = () => {
+                        clearTimeout(timer);
+                        resolve();
+                    };
+                });
+            }
+        };
+        const done = run();
+        const stop = async () => {
+            stopped = true;
+            wake?.();
+            await current?.logout().catch(() => { });
+            await done;
+            this.#watches.delete(stop);
+        };
+        this.#watches.add(stop);
+        return stop;
+    }
+    /** Stop every watch and log out. */
+    async close() {
+        await Promise.all([...this.#watches].map((stop) => stop()));
+        const client = this.#client;
+        this.#client = undefined;
+        if (client) {
+            await client.then((c) => c.logout()).catch(() => { });
+        }
+    }
+    async #read(client, uid) {
+        const maxBytes = this.#limits?.maxBytes ?? DEFAULT_MAX_BYTES;
+        const sized = await client.fetchOne(String(uid), { uid: true, size: true }, { uid: true });
+        if (!sized)
+            return undefined;
+        if (sized.size !== undefined && sized.size > maxBytes) {
+            throw new GoldstoneError("E_GOLDSTONE_MESSAGE_TOO_LARGE", `[inbox] message ${uid} is ${sized.size} bytes, over the ${maxBytes} allowed — not downloaded`);
+        }
+        // The server's size is a claim: the connection itself refuses a
+        // literal over the limit, before buffering it.
+        let full;
+        try {
+            full = await client.fetchOne(String(uid), { uid: true, source: true }, { uid: true });
+        }
+        catch (error) {
+            if (oversized(error) || oversized(this.#cutOff.get(client))) {
+                throw new GoldstoneError("E_GOLDSTONE_MESSAGE_TOO_LARGE", `[inbox] message ${uid} is over the ${maxBytes} bytes allowed, whatever size the server reported — not downloaded`, { cause: error });
+            }
+            throw error;
+        }
+        if (full === false || full === undefined || full.source === undefined) {
+            return undefined;
+        }
+        return readMessage(full.source, {
+            limits: this.#limits,
+            authenticate: this.#authenticate,
+            remoteContent: this.#remoteContent,
+        });
+    }
+    async #in(folder, work) {
+        const client = await this.#connection();
+        const lock = await client.getMailboxLock(folder);
+        try {
+            return await work(client);
+        }
+        finally {
+            lock.release();
+        }
+    }
+    /** The shared connection, opened on first use and again after a loss. */
+    #connection() {
+        if (!this.#client) {
+            const opening = this.#open();
+            this.#client = opening;
+            opening.then((client) => client.on("close", () => {
+                if (this.#client === opening)
+                    this.#client = undefined;
+            }), () => {
+                if (this.#client === opening)
+                    this.#client = undefined;
+            });
+        }
+        return this.#client;
+    }
+    async #open() {
+        const config = this.#config;
+        // `starttls` alone means a plaintext connection upgraded: TLS from
+        // the first byte is the default only without it.
+        const secure = config.secure ?? config.starttls !== true;
+        const auth = "pass" in config.auth
+            ? { user: config.auth.user, pass: config.auth.pass }
+            : {
+                user: config.auth.user,
+                accessToken: typeof config.auth.accessToken === "function"
+                    ? await config.auth.accessToken()
+                    : config.auth.accessToken,
+            };
+        const maxBytes = this.#limits?.maxBytes ?? DEFAULT_MAX_BYTES;
+        const client = new ImapFlow({
+            // Whatever the server says a message weighs, never buffer more
+            // than the limit for one, nor much more for any response.
+            maxLiteralSize: maxBytes,
+            maxResponseSize: Math.max(maxBytes, RESPONSE_ROOM) + 64 * 1024,
+            maxLineLength: Math.max(maxBytes, RESPONSE_ROOM),
+            host: config.host,
+            port: config.port ?? (secure ? 993 : 143),
+            secure,
+            // Never the silent fallback to cleartext: either TLS from the start,
+            // or STARTTLS that must succeed, or a plaintext test server allowed
+            // by name.
+            doSTARTTLS: !secure && config.allowInsecure !== true
+                ? true
+                : config.starttls === true,
+            tls: config.tls,
+            auth,
+            logger: false,
+            // IDLE starts after this much quiet; the default (15 s) delays every
+            // new-message notification by as much.
+            autoIdleDelay: 1000,
+        });
+        // The error that cut the connection, which a pending fetch does not
+        // always reject with.
+        client.on("error", (error) => {
+            this.#cutOff.set(client, error);
+        });
+        await client.connect();
+        return client;
+    }
+}
+/** An empty list is nothing to do — and an empty range a protocol error. */
+function isEmpty(uids) {
+    return Array.isArray(uids) && uids.length === 0;
+}
+function range(uids) {
+    return Array.isArray(uids) ? uids.join(",") : String(uids);
+}
+//# sourceMappingURL=Mailbox.js.map

package/dist/Mailbox.js.map

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

package/dist/ReceivedMessage.d.ts

@@ -0,0 +1,152 @@
+/**
+ * A received mail, parsed as the hostile input it is.
+ *
+ *   const message = await parseMessage(raw)
+ *   message.subject
+ *   message.html            // sanitized: safe to render
+ *   message.attachments[0].fileName   // safe to save under
+ *
+ * The parsing happens in Rust, in one call and off the JavaScript thread:
+ * the raw bytes go in, this comes out. The size is checked before a byte is
+ * parsed, the structure is bounded after, and what the sender controls — the
+ * HTML, the attachment names — is made safe before it reaches the
+ * application.
+ */
+import { type AuthenticateOptions, type Authenticity } from "./authenticity.js";
+import { GoldstoneError } from "./errors.js";
+import type { JsMessage } from "./native/generated.js";
+/** Bounds on one message; each one left out keeps its default. */
+export interface Limits {
+    /** Size of the raw message, checked before parsing. Default 25 MiB. */
+    maxBytes?: number;
+    /**
+     * MIME parts, the message itself included, and the parts of the
+     * messages it carries (message/rfc822). Default 1 000.
+     */
+    maxParts?: number;
+    /** Nesting depth of multiparts and carried messages. Default 32. */
+    maxDepth?: number;
+    /** Header fields in one header block, the message's or a part's. Default 1 000. */
+    maxHeaders?: number;
+    /** Size of one header block. Default 1 MiB. */
+    maxHeaderBytes?: number;
+    /** Number of attachments. Default 100. */
+    maxAttachments?: number;
+    /** Size of one decoded attachment. Default 25 MiB. */
+    maxAttachmentBytes?: number;
+    /**
+     * Size of the HTML body that is sanitized. Over it, the message is still
+     * read, without `html` (see `htmlError`). Default 512 KiB.
+     */
+    maxHtmlBytes?: number;
+}
+export interface Mailbox {
+    readonly name?: string;
+    readonly address?: string;
+}
+export interface Header {
+    readonly name: string;
+    /** As received, encoded words included. */
+    readonly value: string;
+}
+export interface Attachment {
+    /**
+     * Safe to save under, on any system: the last path segment of what the
+     * sender wrote, with control, invisible and bidi characters and the
+     * characters Windows refuses (`< > : " | ? *`, `:` naming an NTFS stream)
+     * replaced by `_`, without leading dots, trailing dots or spaces, or a
+     * Windows device name (`CON`, `COM1`, `CONIN$`…), at most 255 bytes.
+     */
+    readonly fileName: string;
+    /** The name as the sender wrote it. For display only — never a path. */
+    readonly originalName?: string;
+    readonly contentType: string;
+    readonly size: number;
+    readonly content: Uint8Array;
+    readonly contentId?: string;
+    readonly inline: boolean;
+}
+export declare class ReceivedMessage {
+    #private;
+    readonly messageId?: string;
+    readonly subject?: string;
+    readonly date?: Date;
+    readonly from: readonly Mailbox[];
+    readonly to: readonly Mailbox[];
+    readonly cc: readonly Mailbox[];
+    readonly bcc: readonly Mailbox[];
+    readonly replyTo: readonly Mailbox[];
+    readonly inReplyTo: readonly string[];
+    readonly references: readonly string[];
+    readonly headers: readonly Header[];
+    readonly text?: string;
+    /**
+     * Sanitized for display: no script, no event handler, no `javascript:`
+     * URL, and no remote content unless `remoteContent: "allow"`.
+     */
+    readonly html?: string;
+    /**
+     * Why `html` is absent although the message has an HTML body: over
+     * `maxHtmlBytes` (`E_GOLDSTONE_HTML_TOO_LARGE`), nested too deep
+     * (`…_HTML_TOO_DEEP`), or building a tree out of proportion to its markup
+     * (`…_HTML_TOO_COMPLEX`). Sanitizing such HTML would cost time that grows
+     * faster than its size; the text and the rest of the message are there.
+     */
+    readonly htmlError?: GoldstoneError;
+    readonly attachments: readonly Attachment[];
+    /**
+     * Who really sent it — present when the message was read with
+     * {@link readMessage} (as a mailbox reads it), absent from
+     * {@link parseMessage}, which does no DNS.
+     */
+    readonly authenticity?: Authenticity;
+    constructor(parsed: JsMessage, authenticity?: Authenticity);
+    /**
+     * The first header of that name, any case: the copy the message's
+     * fields (`from`, `subject`…) read too. Every copy is in `headers`.
+     */
+    header(name: string): string | undefined;
+    /**
+     * The HTML exactly as the sender wrote it. Never render it: it can carry
+     * scripts. It exists for what has to see the original — archiving,
+     * forwarding, forensic inspection.
+     */
+    unsanitizedHtml(): string | undefined;
+}
+export interface ParseOptions {
+    limits?: Limits;
+    /**
+     * Whether the sanitized `html` may load remote content by itself —
+     * images, backgrounds, video posters. `"block"` (the default) removes
+     * those URLs: rendering a remote image tells the sender the message was
+     * opened, when, and from where. `cid:` references to the message's own
+     * parts are kept either way. Links stay: they are followed only when
+     * clicked.
+     */
+    remoteContent?: "block" | "allow";
+}
+/**
+ * Parse one received message — raw RFC 5322 bytes, as IMAP fetches them or
+ * a provider posts them. The work runs off the event loop.
+ *
+ * Rejects with a `GoldstoneError` on a message over a limit
+ * (`E_GOLDSTONE_MESSAGE_TOO_LARGE`, `…_TOO_MANY_PARTS`, `…_TOO_DEEP`,
+ * `…_TOO_MANY_HEADERS`, `…_HEADERS_TOO_LARGE`, `…_MISSING_BOUNDARIES`,
+ * `…_BOUNDARY_TOO_LONG`, `…_TOO_MANY_ATTACHMENTS`, `…_ATTACHMENT_TOO_LARGE`) or not a message at
+ * all (`E_GOLDSTONE_NOT_A_MESSAGE`).
+ */
+export declare function parseMessage(raw: Uint8Array, options?: ParseOptions): Promise<ReceivedMessage>;
+export interface ReadOptions extends ParseOptions {
+    /**
+     * Check DKIM, SPF and DMARC — `true` (the default), `false`, or the
+     * envelope and bounds {@link authenticate} takes.
+     */
+    authenticate?: boolean | AuthenticateOptions;
+}
+/**
+ * Parse a received message AND check who sent it, the verdict on
+ * `message.authenticity`. Both come from one parse: the From the verdict
+ * speaks for is the From the message shows.
+ */
+export declare function readMessage(raw: Uint8Array, options?: ReadOptions): Promise<ReceivedMessage>;
+//# sourceMappingURL=ReceivedMessage.d.ts.map

package/dist/ReceivedMessage.d.ts.map

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