pipework 0.69.0 → 0.71.0

package/dist/infra/email/inbound.js

@@ -0,0 +1,451 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { copyFile, mkdir, readdir, readFile, stat, unlink } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { Readable } from 'node:stream';
+import { sql } from '../../data/db/sql.js';
+import { pipeSystem } from '../../data/db/db.js';
+import { schema } from '../../data/schema/namespace.js';
+import { fitting } from '../../request/di/index.js';
+import { getContext } from '../../request/context/store.js';
+import { getBaseLogger } from '../../core/logging/index.js';
+import { __flowStep } from '../../trace/runtime/flow-step.js';
+import { auditEmail } from './audit.js';
+import { parseMime } from './mime.js';
+import { snsHandler } from './sns.js';
+export const RECEIVE_JOB = 'pipework.email.receive';
+const DEFAULT_RETENTION_DAYS = 30;
+const DEFAULT_MAX_RAW_BYTES = 41_943_040;
+const DEFAULT_SWEEP_LIMIT = 500;
+export class RawNotFoundError extends Error {
+    constructor(detail) {
+        super(`raw message not found: ${detail}`);
+    }
+}
+export class RawTooLargeError extends Error {
+    maxBytes;
+    constructor(maxBytes) {
+        super(`raw message is larger than ${maxBytes} bytes`);
+        this.maxBytes = maxBytes;
+    }
+}
+async function collect(stream, maxBytes) {
+    const parts = [];
+    let size = 0;
+    for await (const chunk of stream) {
+        const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += buf.length;
+        if (size > maxBytes) {
+            if (stream instanceof Readable)
+                stream.destroy();
+            throw new RawTooLargeError(maxBytes);
+        }
+        parts.push(buf);
+    }
+    return Buffer.concat(parts);
+}
+/**
+ * The SES receipt source. SES stores each raw message in S3 (receipt rule action "S3" with an SNS topic)
+ * and notifies the topic; `inbound.webhook` verifies the notification and records it, and the receive job
+ * reads the object from `bucket`. A notification whose action is not S3 (for example the SNS action,
+ * which carries the message inline), or whose type is not `Received`, is answered 200 and ignored.
+ */
+export function sesReceipt(config) {
+    if (config.topicArns.length === 0)
+        throw new Error('[pipework] mail.sesReceipt needs at least one topic ARN in topicArns.');
+    return {
+        kind: 'ses',
+        ses: config,
+        async read(location, maxBytes) {
+            let stream;
+            try {
+                stream = await config.bucket.read(String(location['key']));
+            }
+            catch (err) {
+                if (/\bNoSuchKey\b/.test(err instanceof Error ? err.message : String(err)))
+                    throw new RawNotFoundError(String(location['key']));
+                throw err;
+            }
+            return collect(stream, maxBytes);
+        },
+        async remove(location) {
+            await config.bucket.remove(String(location['key']));
+        },
+    };
+}
+/**
+ * The development source: `.eml` files dropped in `dir` are received by `inbound.scan()`, which copies each
+ * to `<dir>/received/` (where the raw copy stays until `sweep`) and removes the original. Refused when the
+ * environment is `production`.
+ */
+export function inboundFolder(config) {
+    return {
+        kind: 'folder',
+        folder: config,
+        async read(location, maxBytes) {
+            const path = String(location['path']);
+            try {
+                if ((await stat(path)).size > maxBytes)
+                    throw new RawTooLargeError(maxBytes);
+                return await readFile(path);
+            }
+            catch (err) {
+                if (err.code === 'ENOENT')
+                    throw new RawNotFoundError(path);
+                throw err;
+            }
+        },
+        async remove(location) {
+            try {
+                await unlink(String(location['path']));
+            }
+            catch (err) {
+                if (err.code !== 'ENOENT')
+                    throw err;
+            }
+        },
+    };
+}
+function toDate(value) {
+    if (value instanceof Date)
+        return value;
+    const text = String(value);
+    return new Date(/(Z|[+-]\d\d(:?\d\d)?)$/.test(text) ? text : `${text.replace(' ', 'T')}Z`);
+}
+/** A Postgres text-array literal, sent as one parameter and cast with `::text[]`. */
+function textArray(values) {
+    return `{${values.map(v => `"${v.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`).join(',')}}`;
+}
+function verdictsOf(receipt) {
+    const status = (key) => {
+        const v = receipt[key];
+        return typeof v?.status === 'string' ? v.status : null;
+    };
+    return {
+        spam: status('spamVerdict'), virus: status('virusVerdict'), spf: status('spfVerdict'),
+        dkim: status('dkimVerdict'), dmarc: status('dmarcVerdict'),
+    };
+}
+function addressOf(a) {
+    return a === null ? { address: '', name: '' } : { address: a.address, name: a.name };
+}
+/**
+ * Receiving email. `inbound.webhook` (SES) or `inbound.scan` (folder) records each message in
+ * `pipework_email_inbound` and enqueues the `pipework.email.receive` job, once per message. The job
+ * reads the raw message, parses it, assigns a conversation, resolves the tenant, stores the attachments
+ * as that tenant's files and calls `onMessage` with a `ReceivedEmail`.
+ *
+ * Needs blueprint `email: {}` (table `pipework_email_inbound`; `pipework_email_messages` gains `conversation_id`).
+ * The row is not tenant-scoped (it exists before a tenant is known) and holds no bodies: the raw message
+ * is the copy and `sweep` deletes it after `rawRetentionDays`.
+ *
+ * Threading: the ids in In-Reply-To then References are matched to an earlier received message's
+ * Message-ID, or, for an id `<X@region.amazonses.com>`, to a sent message whose `provider_message_id` is `X`
+ * (set the sent message's conversation with `mail.send({ conversationId })` or `inReplyTo`). The first match
+ * decides the conversation; with none the message starts one (`isNewConversation: true`). Ids are matched exactly.
+ * A received message is matched only when its tenant equals the tenant `resolveTenant` named for this message or
+ * either is null; a sent message's conversation is refused when it holds a received message of another tenant.
+ *
+ * Threading is not authentication: Message-IDs are not secret and From is forgeable. Before attaching a message to
+ * a conversation's participants, the app checks `from` against them and the DKIM and DMARC verdicts.
+ *
+ * The receive job is a trace step `pipework/email:receive` with an `EmailInbound:received` audit record on success.
+ * A handler error (or a failure reading the raw message) rethrows so the queue retries; attachments stored by
+ * an earlier attempt are reused. Set `maxAttempts` on the queue. A raw message over `maxRawBytes` is marked
+ * `failed` and not retried. Message bodies are never logged.
+ */
+export function createInbound(config) {
+    if (config.source.kind === 'folder' && config.environment === 'production') {
+        throw new Error('[pipework] mail.inboundFolder is refused in production.\n\n' +
+            '  The stand-in reads .eml files from a folder.\n' +
+            '  Configure a real source, e.g. mail.sesReceipt({ bucket, topicArns }).\n');
+    }
+    const retentionDays = Math.floor(config.rawRetentionDays ?? DEFAULT_RETENTION_DAYS);
+    const maxRawBytes = config.maxRawBytes ?? DEFAULT_MAX_RAW_BYTES;
+    if (!(retentionDays >= 0))
+        throw new Error('[pipework] inbound rawRetentionDays must be zero or more.');
+    if (!(maxRawBytes > 0))
+        throw new Error('[pipework] inbound maxRawBytes must be positive.');
+    async function record(source, sourceId, location, extra) {
+        const traceId = getContext()?.trace?.id ?? null;
+        return pipeSystem().transaction(async (tx) => {
+            const inserted = await tx.execute(sql `
+        INSERT INTO pipework_email_inbound
+          (source_id, source, raw_location, raw_expires_at, verdicts, recipients, from_address, trace_id)
+        VALUES (${sourceId}, ${source}, ${JSON.stringify(location)}::jsonb, now() + make_interval(days => ${retentionDays}::int),
+          ${extra.verdicts === null ? null : JSON.stringify(extra.verdicts)}::jsonb,
+          ${extra.recipients === null ? null : JSON.stringify(extra.recipients)}::jsonb, ${extra.from}, ${traceId}::uuid)
+        ON CONFLICT (source_id) DO NOTHING
+        RETURNING id`);
+            if (inserted.length === 0)
+                return null;
+            const inboundId = inserted[0]['id'];
+            await config.queue.enqueue(tx, { type: RECEIVE_JOB, payload: { inboundId }, continueFlow: true });
+            return inboundId;
+        });
+    }
+    async function ingestNotification(message) {
+        let parsed;
+        try {
+            parsed = JSON.parse(message);
+        }
+        catch {
+            return { ignored: true };
+        }
+        if (typeof parsed !== 'object' || parsed === null)
+            return { ignored: true };
+        const event = parsed;
+        if (event['notificationType'] !== 'Received')
+            return { ignored: true };
+        const mailPart = event['mail'];
+        const receipt = event['receipt'];
+        const action = receipt?.['action'];
+        if (typeof mailPart?.messageId !== 'string' || receipt === undefined)
+            return { ignored: true };
+        if (action?.type !== 'S3' || typeof action.bucketName !== 'string' || typeof action.objectKey !== 'string') {
+            getBaseLogger().info({ event: 'email receipt ignored', actionType: action?.type ?? null }, 'SES receipt ignored: its action is not S3');
+            return { ignored: true };
+        }
+        const recipientList = Array.isArray(receipt['recipients']) ? receipt['recipients'] : mailPart.destination;
+        const recipients = Array.isArray(recipientList) ? recipientList.filter((r) => typeof r === 'string') : [];
+        const id = await record('ses', mailPart.messageId, { bucket: action.bucketName, key: action.objectKey }, {
+            verdicts: verdictsOf(receipt), recipients, from: typeof mailPart.source === 'string' ? mailPart.source : null,
+        });
+        if (id === null)
+            getBaseLogger().info({ event: 'email receipt duplicate', sourceId: mailPart.messageId }, 'SES receipt already recorded');
+        return {};
+    }
+    async function thread(ids, recorded, tenantId) {
+        const db = pipeSystem();
+        if (ids.length > 0) {
+            const sesLocals = ids.flatMap(id => {
+                const m = /^(.+)@[^@]*amazonses\.com$/i.exec(id);
+                return m === null ? [] : [m[1]];
+            });
+            const received = await db.execute(sql `
+        SELECT message_id_header AS id, conversation_id FROM pipework_email_inbound
+        WHERE message_id_header = ANY(${textArray(ids)}::text[]) AND conversation_id IS NOT NULL
+          AND (${tenantId}::uuid IS NULL OR tenant_id IS NULL OR tenant_id = ${tenantId}::uuid)`);
+            const sent = sesLocals.length === 0 ? [] : await db.execute(sql `
+        SELECT provider_message_id AS id, conversation_id FROM pipework_email_messages
+        WHERE provider_message_id = ANY(${textArray(sesLocals)}::text[]) AND conversation_id IS NOT NULL`);
+            const byId = new Map();
+            for (const r of received)
+                byId.set(r['id'], r['conversation_id']);
+            const bySes = new Map();
+            for (const r of sent) {
+                const conversation = r['conversation_id'];
+                const foreign = tenantId === null ? [] : await db.execute(sql `
+          SELECT 1 FROM pipework_email_inbound
+          WHERE conversation_id = ${conversation}::uuid AND tenant_id IS NOT NULL AND tenant_id <> ${tenantId}::uuid LIMIT 1`);
+                if (foreign.length === 0)
+                    bySes.set(r['id'], conversation);
+            }
+            for (const id of ids) {
+                const hit = byId.get(id) ?? bySes.get(/^(.+)@[^@]*amazonses\.com$/i.exec(id)?.[1] ?? '\u0000');
+                if (hit !== undefined)
+                    return { conversationId: hit, isNew: false };
+            }
+        }
+        // No match: this message's own conversation, kept from an earlier attempt of the job.
+        if (recorded !== null)
+            return { conversationId: recorded, isNew: true };
+        return { conversationId: randomUUID(), isNew: true };
+    }
+    async function fail(id, error) {
+        await pipeSystem().execute(sql `UPDATE pipework_email_inbound SET status = 'failed', error = ${error} WHERE id = ${id}::uuid`);
+        await auditEmail('failed', id, { error }, 'EmailInbound');
+        getBaseLogger().error({ event: 'email receive failed', inboundId: id }, `received email not handled: ${error}`);
+        return { status: 'failed' };
+    }
+    const receive = __flowStep({ ref: 'pipework/email:receive' }, async (inboundId) => {
+        const db = pipeSystem();
+        const row = (await db.execute(sql `SELECT * FROM pipework_email_inbound WHERE id = ${inboundId}::uuid`))[0];
+        if (row === undefined)
+            throw new Error(`[pipework] Received email ${inboundId} does not exist.`);
+        const status = row['status'];
+        if (status === 'processed' || status === 'failed')
+            return { status };
+        if (config.source.kind === 'folder' && getContext()?.instance.config.environment === 'production') {
+            throw new Error('[pipework] mail.inboundFolder is refused in production.');
+        }
+        if (row['raw_deleted_at'] !== null)
+            return fail(inboundId, 'the raw message was deleted before it was handled');
+        let raw;
+        try {
+            raw = await config.source.read(row['raw_location'], maxRawBytes);
+        }
+        catch (err) {
+            if (err instanceof RawTooLargeError || err instanceof RawNotFoundError)
+                return fail(inboundId, err.message);
+            const message = err instanceof Error ? err.message : String(err);
+            await db.execute(sql `UPDATE pipework_email_inbound SET error = ${message} WHERE id = ${inboundId}::uuid`);
+            throw err;
+        }
+        const parsed = parseMime(raw);
+        const recipients = row['recipients'] ?? [...parsed.to, ...parsed.cc].map(a => a.address);
+        const verdicts = row['verdicts'] ?? null;
+        const unthreaded = {
+            id: inboundId,
+            messageId: parsed.messageId, inReplyTo: parsed.inReplyTo, references: parsed.references,
+            from: addressOf(parsed.from),
+            to: parsed.to.map(addressOf), cc: parsed.cc.map(addressOf), replyTo: parsed.replyTo.map(addressOf),
+            subject: parsed.subject, date: parsed.date, text: parsed.text, html: parsed.html,
+            attachments: parsed.attachments.map(a => ({
+                filename: a.filename, mediaType: a.mediaType, size: a.size, sha256: createHash('sha256').update(a.content).digest('hex'),
+                contentId: a.contentId, inline: a.inline, file: null,
+            })),
+            verdicts, recipients,
+        };
+        let tenantId = row['tenant_id'] ?? null;
+        if (tenantId === null && config.resolveTenant !== undefined)
+            tenantId = await config.resolveTenant(unthreaded);
+        const { conversationId, isNew } = await thread(parsed.threadIds, row['conversation_id'] ?? null, tenantId);
+        const base = { ...unthreaded, conversationId, isNewConversation: isNew, tenantId };
+        await db.execute(sql `
+      UPDATE pipework_email_inbound SET
+        message_id_header = ${parsed.messageId}, in_reply_to = ${parsed.inReplyTo}, "references" = ${JSON.stringify(parsed.references)}::jsonb,
+        from_address = ${base.from.address}, subject = ${parsed.subject}, conversation_id = ${conversationId}::uuid,
+        tenant_id = ${tenantId}::uuid, recipients = ${JSON.stringify(recipients)}::jsonb, error = NULL
+      WHERE id = ${inboundId}::uuid`);
+        let attachments = base.attachments;
+        if (config.storage !== undefined && tenantId !== null && parsed.attachments.length > 0) {
+            const storage = config.storage;
+            const stored = Array.isArray(row['attachment_files']) ? [...row['attachment_files']] : [];
+            const files = [];
+            for (let i = 0; i < parsed.attachments.length; i++) {
+                const part = parsed.attachments[i];
+                let file = null;
+                const earlier = stored[i];
+                if (typeof earlier === 'string')
+                    file = await storage.getFor(tenantId, earlier);
+                if (file === null) {
+                    file = await storage.putFor(tenantId, {
+                        body: Readable.from([part.content]), mediaType: part.mediaType,
+                        ...(part.filename !== null ? { filename: part.filename } : {}),
+                        expectedSha256: attachments[i].sha256,
+                    });
+                    stored[i] = file.id;
+                    await db.execute(sql `UPDATE pipework_email_inbound SET attachment_files = ${JSON.stringify(stored)}::jsonb WHERE id = ${inboundId}::uuid`);
+                }
+                files.push(file);
+            }
+            attachments = attachments.map((a, i) => ({ ...a, file: files[i] ?? null }));
+        }
+        try {
+            await config.onMessage({ ...base, tenantId, attachments });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            await db.execute(sql `UPDATE pipework_email_inbound SET error = ${message} WHERE id = ${inboundId}::uuid`);
+            throw err;
+        }
+        const traceId = getContext()?.trace?.id ?? null;
+        await db.execute(sql `
+      UPDATE pipework_email_inbound SET status = 'processed', processed_at = now(), error = NULL, trace_id = COALESCE(${traceId}::uuid, trace_id)
+      WHERE id = ${inboundId}::uuid`);
+        await auditEmail('received', inboundId, {
+            conversationId, isNewConversation: isNew, tenantId, attachments: attachments.length,
+        }, 'EmailInbound');
+        return { status: 'processed' };
+    });
+    const receiveJob = fitting.use().job(RECEIVE_JOB)
+        .input(schema.check.object({ inboundId: schema.check.string() }))
+        .fit(async ({ input }) => receive(input.inboundId));
+    return {
+        webhook(webhook) {
+            const ses = config.source.ses;
+            if (config.source.kind !== 'ses' || ses === undefined) {
+                throw new Error('[pipework] inbound.webhook needs a mail.sesReceipt source; this inbound reads a folder.');
+            }
+            return snsHandler({
+                path: webhook.path, topicArns: ses.topicArns,
+                ...(ses.region !== undefined ? { region: ses.region } : {}),
+                ...(ses.fetchCert !== undefined ? { fetchCert: ses.fetchCert } : {}),
+                ...(ses.confirm !== undefined ? { confirm: ses.confirm } : {}),
+            }, ingestNotification);
+        },
+        jobs: [receiveJob],
+        async scan() {
+            const folder = config.source.folder;
+            if (config.source.kind !== 'folder' || folder === undefined) {
+                throw new Error('[pipework] inbound.scan needs a mail.inboundFolder source; this inbound receives through SES.');
+            }
+            let names;
+            try {
+                names = (await readdir(folder.dir)).filter(n => n.toLowerCase().endsWith('.eml')).sort();
+            }
+            catch (err) {
+                if (err.code === 'ENOENT')
+                    return { received: 0, duplicates: 0 };
+                throw err;
+            }
+            const done = join(folder.dir, 'received');
+            let received = 0;
+            let duplicates = 0;
+            for (const name of names) {
+                const from = join(folder.dir, name);
+                if (!(await stat(from)).isFile())
+                    continue;
+                const bytes = await readFile(from);
+                const sha = createHash('sha256').update(bytes).digest('hex');
+                await mkdir(done, { recursive: true });
+                const to = join(done, `${sha.slice(0, 12)}-${basename(name)}`);
+                await copyFile(from, to);
+                const id = await record('folder', `folder:${sha}`, { path: to }, { verdicts: null, recipients: null, from: null });
+                await unlink(from);
+                if (id === null)
+                    duplicates++;
+                else
+                    received++;
+            }
+            return { received, duplicates };
+        },
+        async sweep(options) {
+            const limit = options?.limit ?? DEFAULT_SWEEP_LIMIT;
+            const db = pipeSystem();
+            const due = await db.execute(sql `
+        SELECT id, raw_location FROM pipework_email_inbound
+        WHERE raw_expires_at <= now() AND raw_deleted_at IS NULL
+        ORDER BY raw_expires_at LIMIT ${limit}`);
+            let deleted = 0;
+            let failed = 0;
+            for (const row of due) {
+                try {
+                    await config.source.remove(row['raw_location']);
+                    await db.execute(sql `UPDATE pipework_email_inbound SET raw_deleted_at = now() WHERE id = ${row['id']}::uuid`);
+                    deleted++;
+                }
+                catch (err) {
+                    failed++;
+                    getBaseLogger().error({ err, inboundId: row['id'] }, 'inbound sweep could not delete a raw message');
+                }
+            }
+            return { deleted, failed };
+        },
+        async get(id) {
+            if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id))
+                return null;
+            const row = (await pipeSystem().execute(sql `SELECT * FROM pipework_email_inbound WHERE id = ${id}::uuid`))[0];
+            if (row === undefined)
+                return null;
+            const date = (v) => (v === null || v === undefined ? null : toDate(v));
+            return {
+                id: row['id'],
+                source: row['source'],
+                status: row['status'],
+                error: row['error'] ?? null,
+                messageId: row['message_id_header'] ?? null,
+                conversationId: row['conversation_id'] ?? null,
+                tenantId: row['tenant_id'] ?? null,
+                subject: row['subject'] ?? null,
+                fromAddress: row['from_address'] ?? null,
+                verdicts: row['verdicts'] ?? null,
+                receivedAt: toDate(row['received_at']),
+                processedAt: date(row['processed_at']),
+                rawExpiresAt: toDate(row['raw_expires_at']),
+                rawDeletedAt: date(row['raw_deleted_at']),
+            };
+        },
+    };
+}
+//# sourceMappingURL=inbound.js.map

package/dist/infra/email/inbound.js.map

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

package/dist/infra/email/index.d.ts

@@ -1,5 +1,6 @@
 export { createMail, normalizeAddress, SEND_JOB, type Mail, type MailConfig, type SendInput, type SendResult, type RenderedEmail, type EmailTemplates } from './mail.js';
 export { ses, devStandIn, type MailProvider, type OutgoingMessage, type SesConfig } from './providers.js';
+export { createInbound, sesReceipt, inboundFolder, RECEIVE_JOB, type Inbound, type InboundConfig, type InboundSource, type InboundRecord, type InboundScanResult, type InboundSweepResult, type ReceivedEmail, type ReceivedAttachment, type EmailAddress, type EmailVerdicts, type UnthreadedEmail, type SesReceiptConfig, } from './inbound.js';
 export { snsWebhook, type SnsWebhookConfig } from './sns.js';
 export { signV4, type SigV4Request, type AwsCredentials } from '../aws/sigv4.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/infra/email/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infra/email/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAC1G,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACzG,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infra/email/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAC1G,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACzG,OAAO,EACL,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAC/H,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAC/G,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,GAChE,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/infra/email/index.js

@@ -1,5 +1,6 @@
 export { createMail, normalizeAddress, SEND_JOB } from './mail.js';
 export { ses, devStandIn } from './providers.js';
+export { createInbound, sesReceipt, inboundFolder, RECEIVE_JOB, } from './inbound.js';
 export { snsWebhook } from './sns.js';
 export { signV4 } from '../aws/sigv4.js';
 //# sourceMappingURL=index.js.map

package/dist/infra/email/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infra/email/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EACJ,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,GAAG,EAAE,UAAU,EAA2D,MAAM,gBAAgB,CAAA;AACzG,OAAO,EAAE,UAAU,EAAyB,MAAM,UAAU,CAAA;AAC5D,OAAO,EAAE,MAAM,EAA0C,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infra/email/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EACJ,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,GAAG,EAAE,UAAU,EAA2D,MAAM,gBAAgB,CAAA;AACzG,OAAO,EACL,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,GAGtD,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,UAAU,EAAyB,MAAM,UAAU,CAAA;AAC5D,OAAO,EAAE,MAAM,EAA0C,MAAM,iBAAiB,CAAA"}

package/dist/infra/email/mail.d.ts

@@ -29,6 +29,16 @@ export interface SendInput<T extends EmailTemplates, K extends keyof T & string>
     readonly data: Parameters<T[K]>[0];
     /** Idempotency key: a second send with the same key sends nothing. */
     readonly key: string;
+    /**
+     * Puts the message in a conversation, so a reply to it threads there (the provider's message id
+     * is matched against `References`/`In-Reply-To` of received mail). Default: the conversation of `inReplyTo`.
+     */
+    readonly conversationId?: string;
+    /**
+     * The id of a received message (`ReceivedEmail.id`) this one answers: the sent message carries
+     * `In-Reply-To: <its Message-ID>` and `References` with its references plus its Message-ID (at most 20 ids).
+     */
+    readonly inReplyTo?: string;
 }
 export interface SendResult {
     readonly messageId: string;
@@ -45,6 +55,8 @@ export interface Mail<T extends EmailTemplates> {
     readonly jobs: readonly Handler<Record<string, unknown>, unknown>[];
 }
 export declare const SEND_JOB = "pipework.email.send";
+/** The reply headers for a message answering a received one: In-Reply-To, and References capped to 20 ids and the provider's header length. */
+export declare function replyHeaders(messageId: string, references: readonly string[]): Record<string, string>;
 export declare function normalizeAddress(address: string): string;
 /**
  * Creates the transactional email interface.
@@ -56,13 +68,14 @@ export declare function normalizeAddress(address: string): string;
  * provider call is a trace step and `Email:sent` / `Email:suppressed` / `Email:failed`
  * audit records are written under it, in the trace of the flow that called `send`.
  *
- * Needs blueprint `email: {}` (tables `pipework_email_messages`, `pipework_email_suppressions`).
+ * Needs blueprint `email: {}` (tables `pipework_email_messages`, `pipework_email_suppressions`, `pipework_email_inbound`).
  * A provider error returns the message to `queued` with `error` set and rethrows, so the
  * queue retries (set `maxAttempts` on the queue); if the queue gives up the row keeps the error.
  * A run claims the message with a conditional update (`status` `queued`, or `sending` for longer than
  * `sendingStaleSeconds`), so a re-run of a job whose first run is still in flight does not call the provider.
  * Residual window: a crash mid-send leaves the message `sending` for the stale window, after which a retry
  * may send it once more; likewise if the provider accepted it and the process died before the row was marked `sent`. SES v2 has no idempotency token to close it.
+ * With `conversationId` / `inReplyTo` the message joins a conversation and carries reply headers (see `SendInput`).
  * Message bodies and template data are never logged.
  */
 export declare function createMail<T extends EmailTemplates>(config: MailConfig<T>): Mail<T>;

package/dist/infra/email/mail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../../src/infra/email/mail.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAA;AAOhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAGxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,sFAAsF;AAEtF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,aAAa,CAAC,CAAA;AAEzE,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,cAAc;IAClD,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAA;IACrB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,oGAAoG;IACpG,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CACtC;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM;IAC7E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAClC,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,IAAI,CAAC,CAAC,SAAS,cAAc;IAC5C;;;OAGG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACrF,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,CAAA;CACpE;AAED,eAAO,MAAM,QAAQ,wBAAwB,CAAA;AAG7C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,cAAc,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAqHnF"}
+{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../../src/infra/email/mail.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAA;AAOhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAGxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,sFAAsF;AAEtF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,aAAa,CAAC,CAAA;AAEzE,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,cAAc;IAClD,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAA;IACrB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,oGAAoG;IACpG,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CACtC;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM;IAC7E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAClC,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,IAAI,CAAC,CAAC,SAAS,cAAc;IAC5C;;;OAGG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACrF,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,CAAA;CACpE;AAED,eAAO,MAAM,QAAQ,wBAAwB,CAAA;AAM7C,+IAA+I;AAC/I,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKrG;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,cAAc,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CA6InF"}