@procedures/mail 0.0.0-stage → 0.2.3

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// The root registers nothing: import "<package>/register", or give the module to createRegistry()
+export * from "./module.js";
+export * from "./procedures.js";
+export * from "./mime.js";
+export * from "./imap.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,kGAAkG;AAClG,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/mime.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The headers and the readable text of a raw RFC 822 message. It reads multipart bodies,
+ * quoted-printable and base64, and HTML-only messages. It is not a mail client: it ignores
+ * attachments, inline images and the headers of the parts.
+ */
+/** This function gives the text of an HTML body as lines. A cell, a row, a paragraph or a break ends a line. */
+export declare const htmlText: (html: string) => string;
+/** This function gives the top-level headers of a raw message, unfolded, with lowercase names. */
+export declare const messageHeaders: (raw: Uint8Array | string) => ReadonlyMap<string, string>;
+/** This function decodes the RFC 2047 encoded words (`=?UTF-8?Q?...?=`) of a header value. */
+export declare const decodeWords: (value: string) => string;
+/** This function gives the text of a message: its plain parts, or its HTML as lines when it has no plain part. */
+export declare const messageText: (raw: Uint8Array | string) => string;
+/** An address of a header: `Name <user@host>`, `<user@host>` or `user@host`. */
+export interface MailAddress {
+    readonly name?: string | undefined;
+    readonly address: string;
+}
+/** This function reads the addresses of an address header (From, To, Cc). */
+export declare const parseAddresses: (value: string) => MailAddress[];
+//# 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":"AAAA;;;;GAIG;AAgEH,gHAAgH;AAChH,eAAO,MAAM,QAAQ,SAAU,MAAM,KAAG,MAW7B,CAAC;AAkCZ,kGAAkG;AAClG,eAAO,MAAM,cAAc,QAAS,UAAU,GAAG,MAAM,KAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAA+B,CAAC;AAEpH,8FAA8F;AAC9F,eAAO,MAAM,WAAW,UAAW,MAAM,KAAG,MAKxC,CAAC;AAEL,kHAAkH;AAClH,eAAO,MAAM,WAAW,QAAS,UAAU,GAAG,MAAM,KAAG,MAYtD,CAAC;AAEF,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,6EAA6E;AAC7E,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,WAAW,EAYzD,CAAC"}

package/dist/mime.js

@@ -0,0 +1,139 @@
+/**
+ * The headers and the readable text of a raw RFC 822 message. It reads multipart bodies,
+ * quoted-printable and base64, and HTML-only messages. It is not a mail client: it ignores
+ * attachments, inline images and the headers of the parts.
+ */
+const split = (text) => {
+    const at = text.search(/\r?\n\r?\n/);
+    const head = at === -1 ? text : text.slice(0, at);
+    const body = at === -1 ? "" : text.slice(at).replace(/^\r?\n\r?\n/, "");
+    const headers = new Map();
+    // A header continues on each line that starts with white space (RFC 5322 folding)
+    for (const line of head.replace(/\r?\n[ \t]+/g, " ").split(/\r?\n/)) {
+        const colon = line.indexOf(":");
+        if (colon <= 0)
+            continue;
+        headers.set(line.slice(0, colon).trim().toLowerCase(), line.slice(colon + 1).trim());
+    }
+    return { headers, body };
+};
+const param = (value, name) => {
+    const match = new RegExp(`(?:^|;)\\s*${name}\\s*=\\s*(?:"([^"]*)"|([^;\\s]+))`, "i").exec(value);
+    return match?.[1] ?? match?.[2];
+};
+const quotedPrintable = (text) => text.replace(/=\r?\n/g, "").replace(/=([0-9A-F]{2})/gi, (_, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
+const decode = (body, encoding, charset) => {
+    const transfer = (encoding ?? "7bit").toLowerCase();
+    const bytes = transfer === "base64"
+        ? Buffer.from(body.replace(/\s+/g, ""), "base64")
+        : transfer === "quoted-printable"
+            ? Buffer.from(quotedPrintable(body), "latin1")
+            : Buffer.from(body, "latin1");
+    const set = (charset ?? "utf-8").toLowerCase();
+    return set === "utf-8" || set === "utf8" || set === "us-ascii" ? bytes.toString("utf8") : bytes.toString("latin1");
+};
+const ENTITIES = {
+    nbsp: " ",
+    lt: "<",
+    gt: ">",
+    quot: '"',
+    apos: "'",
+    ndash: "-",
+    mdash: "-",
+    rsquo: "'",
+    lsquo: "'",
+    ldquo: '"',
+    rdquo: '"',
+};
+/** `&amp;` is the last replacement, so `&amp;lt;` stays the text "&lt;". */
+const entities = (text) => text
+    .replace(/&#(\d+);/g, (_, code) => String.fromCodePoint(Number(code)))
+    .replace(/&#x([0-9a-f]+);/gi, (_, hex) => String.fromCodePoint(Number.parseInt(hex, 16)))
+    .replace(/&([a-z]+);/gi, (whole, name) => ENTITIES[name.toLowerCase()] ?? whole)
+    .replace(/&amp;/gi, "&");
+/** This function gives the text of an HTML body as lines. A cell, a row, a paragraph or a break ends a line. */
+export const htmlText = (html) => entities(html
+    .replace(/<(script|style|head)\b[\s\S]*?<\/\1>/gi, " ")
+    .replace(/<br\s*\/?>/gi, "\n")
+    .replace(/<\/(?:p|div|tr|td|th|li|h[1-6]|table|tbody|section)>/gi, "\n")
+    .replace(/<[^>]+>/g, " "))
+    .replace(/[ \t ]+/g, " ")
+    .replace(/ *\n */g, "\n")
+    .replace(/\n{2,}/g, "\n")
+    .trim();
+const walk = (text, plain, html, depth) => {
+    if (depth > 8)
+        return;
+    const { headers, body } = split(text);
+    const type = headers.get("content-type") ?? "text/plain";
+    const mime = (type.split(";")[0] ?? "").trim().toLowerCase();
+    if (mime.startsWith("multipart/")) {
+        const boundary = param(type, "boundary");
+        if (boundary === undefined)
+            return;
+        const delimiter = `--${boundary}`;
+        let current;
+        for (const line of body.split(/\r?\n/)) {
+            if (line.startsWith(delimiter)) {
+                if (current !== undefined)
+                    walk(current.join("\r\n"), plain, html, depth + 1);
+                // After the closing delimiter comes the epilogue, which is not content
+                if (line.startsWith(`${delimiter}--`))
+                    return;
+                current = [];
+                continue;
+            }
+            current?.push(line);
+        }
+        if (current !== undefined)
+            walk(current.join("\r\n"), plain, html, depth + 1);
+        return;
+    }
+    if (!mime.startsWith("text/"))
+        return;
+    if (/^attachment/i.test(headers.get("content-disposition") ?? ""))
+        return;
+    const decoded = decode(body, headers.get("content-transfer-encoding"), param(type, "charset"));
+    if (mime === "text/html")
+        html.push(decoded);
+    else if (mime === "text/plain")
+        plain.push(decoded);
+};
+const asText = (raw) => (typeof raw === "string" ? raw : Buffer.from(raw).toString("latin1"));
+/** This function gives the top-level headers of a raw message, unfolded, with lowercase names. */
+export const messageHeaders = (raw) => split(asText(raw)).headers;
+/** This function decodes the RFC 2047 encoded words (`=?UTF-8?Q?...?=`) of a header value. */
+export const decodeWords = (value) => value.replace(/\?=\s+=\?/g, "?==?").replace(/=\?([^?]+)\?([BQ])\?([^?]*)\?=/gi, (_, charset, encoding, text) => {
+    const bytes = encoding.toUpperCase() === "B" ? Buffer.from(text, "base64") : Buffer.from(quotedPrintable(text.replace(/_/g, " ")), "latin1");
+    return /^utf-?8$/i.test(charset) ? bytes.toString("utf8") : bytes.toString("latin1");
+});
+/** This function gives the text of a message: its plain parts, or its HTML as lines when it has no plain part. */
+export const messageText = (raw) => {
+    const plain = [];
+    const html = [];
+    walk(asText(raw), plain, html, 0);
+    if (plain.some((part) => part.trim().length > 0)) {
+        return plain
+            .join("\n")
+            .replace(/\r\n/g, "\n")
+            .replace(/[ \t ]+/g, " ")
+            .trim();
+    }
+    return html.map(htmlText).join("\n").trim();
+};
+/** This function reads the addresses of an address header (From, To, Cc). */
+export const parseAddresses = (value) => {
+    const out = [];
+    // Commas inside quotes do not separate addresses
+    for (const part of value.match(/(?:"[^"]*"|[^,])+/g) ?? []) {
+        const text = decodeWords(part.trim());
+        const angle = /^(.*?)<([^<>]+)>\s*$/.exec(text);
+        const address = (angle ? angle[2] : text)?.trim() ?? "";
+        if (!address.includes("@"))
+            continue;
+        const name = angle?.[1]?.trim().replace(/^"|"$/g, "").trim();
+        out.push(name ? { name, address } : { address });
+    }
+    return out;
+};
+//# 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/module.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The procedures of @procedures/mail as data. Importing this file registers nothing.
+ */
+import { type ProcedureModule, type ProcedureRegistry } from "@procedures/client";
+export declare const mailModule: ProcedureModule;
+export default mailModule;
+/**
+ * This function registers the procedures of @procedures/mail in a registry. The default is the
+ * global registry.
+ */
+export declare function registerMailProcedures(registry?: ProcedureRegistry): void;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAqD,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGrI,eAAO,MAAM,UAAU,EAAE,eAAkE,CAAC;eAE7E,UAAU;AAEzB;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,GAAE,iBAAsC,GAAG,IAAI,CAE7F"}

package/dist/module.js

@@ -0,0 +1,15 @@
+/**
+ * The procedures of @procedures/mail as data. Importing this file registers nothing.
+ */
+import { defineModule, registerModules, PROCEDURE_REGISTRY } from "@procedures/client";
+import { mailProcedures } from "./procedures.js";
+export const mailModule = defineModule("@procedures/mail", mailProcedures);
+export default mailModule;
+/**
+ * This function registers the procedures of @procedures/mail in a registry. The default is the
+ * global registry.
+ */
+export function registerMailProcedures(registry = PROCEDURE_REGISTRY) {
+    registerModules(registry, [mailModule]);
+}
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAgD,MAAM,oBAAoB,CAAC;AACrI,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,UAAU,GAAoB,YAAY,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC;AAE5F,eAAe,UAAU,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAQ,GAAsB,kBAAkB;IACrF,eAAe,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/procedures.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The procedures of `@procedures/mail`: `mail.parse` and `mail.headers`.
+ */
+import { type AnyProcedure } from "@procedures/client";
+import { type ImapClientFactory } from "./imap.js";
+import { type MailAddress } from "./mime.js";
+interface ParseOutput {
+    headers: Record<string, string>;
+    subject?: string | undefined;
+    from: MailAddress[];
+    to: MailAddress[];
+    date?: string | undefined;
+    text: string;
+}
+/** This function gives the headers, the addresses and the text of a raw message. */
+export declare function parseMessage(raw: string): ParseOutput;
+export declare const mailParseProcedure: AnyProcedure;
+/** This function replaces the IMAP client of `mail.headers` (for tests). Undefined restores `imapflow`. */
+export declare function setImapClientFactory(factory: ImapClientFactory | undefined): void;
+export declare const mailHeadersProcedure: AnyProcedure;
+export declare const mailProcedures: AnyProcedure[];
+export {};
+//# sourceMappingURL=procedures.d.ts.map

package/dist/procedures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../src/procedures.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAA+B,KAAK,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AAE3G,OAAO,EAAe,KAAK,iBAAiB,EAAmB,MAAM,WAAW,CAAC;AACjF,OAAO,EAA4D,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAavG,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,EAAE,EAAE,WAAW,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAUD,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAarD;AAED,eAAO,MAAM,kBAAkB,EAAE,YAUP,CAAC;AA0C3B,2GAA2G;AAC3G,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAEjF;AAED,eAAO,MAAM,oBAAoB,EAAE,YA0BT,CAAC;AAE3B,eAAO,MAAM,cAAc,EAAE,YAAY,EAA+C,CAAC"}

package/dist/procedures.js

@@ -0,0 +1,109 @@
+/**
+ * The procedures of `@procedures/mail`: `mail.parse` and `mail.headers`.
+ */
+import { createProcedure, zodAdapter } from "@procedures/client";
+import { z } from "zod";
+import { readHeaders } from "./imap.js";
+import { decodeWords, messageHeaders, messageText, parseAddresses } from "./mime.js";
+const addressSchema = z.object({ name: z.string().optional(), address: z.string() });
+// =============================================================================
+// mail.parse
+// =============================================================================
+const ParseInputSchema = z.object({
+    raw: z.string().describe("The raw message (RFC 822): the headers, an empty line, the body"),
+});
+const ParseOutputSchema = z.object({
+    headers: z.record(z.string(), z.string()),
+    subject: z.string().optional(),
+    from: z.array(addressSchema),
+    to: z.array(addressSchema),
+    date: z.string().optional(),
+    text: z.string(),
+});
+/** This function gives the headers, the addresses and the text of a raw message. */
+export function parseMessage(raw) {
+    const headers = messageHeaders(raw);
+    const subject = headers.get("subject");
+    const dateHeader = headers.get("date");
+    const date = dateHeader !== undefined && !Number.isNaN(Date.parse(dateHeader)) ? new Date(dateHeader).toISOString() : undefined;
+    return {
+        headers: Object.fromEntries(headers),
+        ...(subject !== undefined ? { subject: decodeWords(subject) } : {}),
+        from: parseAddresses(headers.get("from") ?? ""),
+        to: parseAddresses(headers.get("to") ?? ""),
+        ...(date !== undefined ? { date } : {}),
+        text: messageText(raw),
+    };
+}
+export const mailParseProcedure = createProcedure()
+    .path(["mail", "parse"])
+    .input(zodAdapter(ParseInputSchema))
+    .output(zodAdapter(ParseOutputSchema))
+    .meta({
+    description: "Read the headers, the addresses and the text of a raw email message",
+    output: "json",
+    effects: { reads: [], writes: [] },
+})
+    .handler(async (input) => parseMessage(input.raw))
+    .build();
+// =============================================================================
+// mail.headers
+// =============================================================================
+const HeadersInputSchema = z.object({
+    host: z.string().min(1).describe("The IMAP server, for example imap.gmail.com"),
+    port: z.number().int().min(1).max(65_535).default(993).describe("The port (default: 993)"),
+    secure: z.boolean().default(true).describe("Use TLS from the start (default: true)"),
+    user: z.string().min(1).describe("The user name of the mailbox"),
+    passwordEnv: z
+        .string()
+        .regex(/^[A-Za-z_][A-Za-z0-9_]*$/)
+        .default("IMAP_PASSWORD")
+        .describe("The name of the environment variable that holds the password. The password is never an input, so no log records it."),
+    mailbox: z.string().min(1).default("INBOX").describe("The mailbox (default: INBOX)"),
+    sinceDays: z.number().int().min(1).max(365).default(1).describe("The messages of this number of days (default: 1)"),
+    limit: z.number().int().min(1).max(5_000).default(200).describe("The maximum number of messages, the newest first (default: 200)"),
+    timeoutMs: z.number().int().positive().max(600_000).default(60_000).describe("The time limit, in milliseconds (default: 60000)"),
+});
+const HeadersOutputSchema = z.object({
+    messages: z.array(z.object({
+        uid: z.number(),
+        subject: z.string(),
+        from: z.array(addressSchema),
+        to: z.array(addressSchema),
+        date: z.string().optional(),
+        seen: z.boolean(),
+    })),
+});
+/** Tests replace the IMAP client. */
+let clientFactory;
+/** This function replaces the IMAP client of `mail.headers` (for tests). Undefined restores `imapflow`. */
+export function setImapClientFactory(factory) {
+    clientFactory = factory;
+}
+export const mailHeadersProcedure = createProcedure()
+    .path(["mail", "headers"])
+    .input(zodAdapter(HeadersInputSchema))
+    .output(zodAdapter(HeadersOutputSchema))
+    .meta({
+    description: "Give the headers of the recent messages of an IMAP mailbox, read only (no message becomes read)",
+    args: ["host", "user"],
+    output: "json",
+    effects: { reads: ["network"], writes: [] },
+})
+    .handler(async (input, ctx) => {
+    const password = process.env[input.passwordEnv];
+    if (!password)
+        throw new Error(`Set the environment variable ${input.passwordEnv} to the password of the mailbox`);
+    const messages = await readHeaders({ host: input.host, port: input.port, secure: input.secure, user: input.user, password }, {
+        mailbox: input.mailbox,
+        since: new Date(Date.now() - input.sinceDays * 86_400_000),
+        limit: input.limit,
+        timeoutMs: input.timeoutMs,
+        signal: ctx?.signal,
+        clientFactory,
+    });
+    return { messages };
+})
+    .build();
+export const mailProcedures = [mailParseProcedure, mailHeadersProcedure];
+//# sourceMappingURL=procedures.js.map

package/dist/procedures.js.map

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

package/dist/register.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Importing this file registers the procedures of @procedures/mail in the global registry:
+ * `import "@procedures/mail/register"`. The package root registers nothing.
+ */
+export * from "./module.js";
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,cAAc,aAAa,CAAC"}

package/dist/register.js

@@ -0,0 +1,8 @@
+/**
+ * Importing this file registers the procedures of @procedures/mail in the global registry:
+ * `import "@procedures/mail/register"`. The package root registers nothing.
+ */
+import { registerMailProcedures } from "./module.js";
+export * from "./module.js";
+registerMailProcedures();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,cAAc,aAAa,CAAC;AAE5B,sBAAsB,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,80 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/mail",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.3",
+  "description": "Email procedures: the headers, addresses and text of a raw MIME message, and the headers of recent IMAP messages, read only.",
+  "keywords": [
+    "email",
+    "mime",
+    "imap",
+    "rfc822",
+    "procedures"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/mail"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./module": {
+      "types": "./dist/module.d.ts",
+      "import": "./dist/module.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/register.js"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@procedures/client": "0.2.3",
+    "zod": "^4.6.5",
+    "imapflow": "~2.2.1"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "@types/node": "^22.0.0",
+    "@mark1russell7/cue": "^1.0.0",
+    "vitest": "^5.0.3"
+  },
+  "client": {
+    "procedures": "./dist/register.js"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }

package/src/imap.ts

@@ -0,0 +1,126 @@
+/**
+ * The headers of the recent messages of an IMAP mailbox. It opens the mailbox read only (EXAMINE)
+ * and fetches the envelope and the flags of each message, so it changes no flag: a message stays
+ * unread.
+ */
+
+import type { MailAddress } from "./mime.js";
+
+/** The part of an IMAP client that this module uses (the shape of `imapflow`). */
+export interface ImapClientLike {
+  connect(): Promise<void>;
+  logout(): Promise<void>;
+  close(): void;
+  getMailboxLock(mailbox: string, options?: { readOnly?: boolean }): Promise<{ release(): void }>;
+  fetch(
+    range: { since: Date },
+    query: { envelope: true; flags: true; uid: true }
+  ): AsyncIterable<{
+    uid: number;
+    flags?: Set<string> | undefined;
+    envelope?:
+      | {
+          subject?: string | undefined;
+          date?: Date | undefined;
+          from?: Array<{ name?: string | undefined; address?: string | undefined }> | undefined;
+          to?: Array<{ name?: string | undefined; address?: string | undefined }> | undefined;
+        }
+      | undefined;
+  }>;
+}
+
+/** The connection of an IMAP client. */
+export interface ImapConnection {
+  readonly host: string;
+  readonly port: number;
+  readonly secure: boolean;
+  readonly user: string;
+  readonly password: string;
+}
+
+/** The headers of one message. */
+export interface MailHeader {
+  readonly uid: number;
+  readonly subject: string;
+  readonly from: MailAddress[];
+  readonly to: MailAddress[];
+  /** The date of the message (ISO 8601), when it has one */
+  readonly date?: string | undefined;
+  readonly seen: boolean;
+}
+
+export type ImapClientFactory = (connection: ImapConnection) => Promise<ImapClientLike>;
+
+const imapflowClient: ImapClientFactory = async (connection) => {
+  const { ImapFlow } = await import("imapflow");
+  return new ImapFlow({
+    host: connection.host,
+    port: connection.port,
+    secure: connection.secure,
+    auth: { user: connection.user, pass: connection.password },
+    logger: false,
+  }) as unknown as ImapClientLike;
+};
+
+const addresses = (list: Array<{ name?: string | undefined; address?: string | undefined }> | undefined): MailAddress[] =>
+  (list ?? [])
+    .filter((entry): entry is { name?: string; address: string } => typeof entry.address === "string")
+    .map((entry) => (entry.name ? { name: entry.name, address: entry.address } : { address: entry.address }));
+
+export interface ReadHeadersOptions {
+  readonly mailbox: string;
+  readonly since: Date;
+  readonly limit: number;
+  readonly timeoutMs: number;
+  readonly signal?: AbortSignal | undefined;
+  readonly clientFactory?: ImapClientFactory | undefined;
+}
+
+/**
+ * This function gives the headers of the messages of a mailbox since a date, the newest first, at
+ * most `limit`. A time limit or an abort closes the connection.
+ */
+export async function readHeaders(connection: ImapConnection, options: ReadHeadersOptions): Promise<MailHeader[]> {
+  const client = await (options.clientFactory ?? imapflowClient)(connection);
+  let stopped: string | undefined;
+  let loggedOut = false;
+  const stop = (reason: string): void => {
+    stopped ??= reason;
+    client.close();
+  };
+  const timer = setTimeout(() => stop(`no answer in ${options.timeoutMs} ms`), options.timeoutMs);
+  const onAbort = (): void => stop("the call was aborted");
+  options.signal?.addEventListener("abort", onAbort, { once: true });
+  try {
+    if (options.signal?.aborted) throw new Error("the call was aborted");
+    await client.connect();
+    const lock = await client.getMailboxLock(options.mailbox, { readOnly: true });
+    const headers: MailHeader[] = [];
+    try {
+      for await (const message of client.fetch({ since: options.since }, { envelope: true, flags: true, uid: true })) {
+        const envelope = message.envelope;
+        headers.push({
+          uid: message.uid,
+          subject: envelope?.subject ?? "",
+          from: addresses(envelope?.from),
+          to: addresses(envelope?.to),
+          ...(envelope?.date ? { date: envelope.date.toISOString() } : {}),
+          seen: message.flags?.has("\\Seen") ?? false,
+        });
+      }
+    } finally {
+      lock.release();
+    }
+    await client.logout();
+    loggedOut = true;
+    return headers.sort((a, b) => b.uid - a.uid).slice(0, options.limit);
+  } catch (error) {
+    if (stopped !== undefined) throw new Error(`The IMAP server did not finish: ${stopped}`);
+    throw error;
+  } finally {
+    clearTimeout(timer);
+    options.signal?.removeEventListener("abort", onAbort);
+    // An error leaves the connection open: close it
+    if (!loggedOut && stopped === undefined) client.close();
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+// The root registers nothing: import "<package>/register", or give the module to createRegistry()
+export * from "./module.js";
+export * from "./procedures.js";
+export * from "./mime.js";
+export * from "./imap.js";