agent-inbox 0.2.4 → 0.2.5

package/dist/mail/address-book.d.ts

@@ -1,43 +0,0 @@
-/**
- * Mail identity / address book.
- *
- * Maps between agent ids and external email addresses, and declares which
- * domains we own (for inbound RCPT acceptance). Plus-addressing aware:
- * `agent+scope@domain` resolves to agent `agent` in inbox scope `scope`.
- *
- * See docs/MAIL-INTEROP-PLAN.md §6.
- */
-import type { MailIdentityConfig } from "../types.js";
-import type { MailAddress } from "./types.js";
-export interface ResolvedInbound {
-    agentId: string;
-    /** Inbox scope from plus-addressing, if present. */
-    scope?: string;
-}
-export declare class AddressBook {
-    private localDomains;
-    /** lower-cased address → agentId */
-    private byAddress;
-    /** agentId → canonical address */
-    private byAgent;
-    private catchAllAgentId?;
-    /** Address mappings that collided (same address → multiple agents). */
-    readonly conflicts: string[];
-    constructor(config: MailIdentityConfig);
-    /** Primary local domain — used to mint Message-IDs and default from-addresses. */
-    primaryDomain(): string;
-    /** True if `domain` (or a parent of it) is one we receive mail for. */
-    ownsDomain(domain: string): boolean;
-    /**
-     * Resolve an inbound recipient email to a local agent (+ scope).
-     * Returns undefined if the domain is not ours, or the mailbox is unknown and
-     * no catch-all is configured.
-     */
-    resolveInbound(address: string): ResolvedInbound | undefined;
-    /**
-     * Resolve the from-address for an outbound sender agent. Falls back to
-     * `<agentId>@<primaryDomain>` when the agent has no explicit mapping.
-     */
-    resolveFrom(agentId: string): MailAddress;
-}
-//# sourceMappingURL=address-book.d.ts.map

package/dist/mail/address-book.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"address-book.d.ts","sourceRoot":"","sources":["../../src/mail/address-book.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAW;IAC/B,oCAAoC;IACpC,OAAO,CAAC,SAAS,CAA6B;IAC9C,kCAAkC;IAClC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAM;gBAEtB,MAAM,EAAE,kBAAkB;IAkBtC,kFAAkF;IAClF,aAAa,IAAI,MAAM;IAIvB,uEAAuE;IACvE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAOnC;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAoB5D;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;CAK1C"}

package/dist/mail/address-book.js

@@ -1,95 +0,0 @@
-/**
- * Mail identity / address book.
- *
- * Maps between agent ids and external email addresses, and declares which
- * domains we own (for inbound RCPT acceptance). Plus-addressing aware:
- * `agent+scope@domain` resolves to agent `agent` in inbox scope `scope`.
- *
- * See docs/MAIL-INTEROP-PLAN.md §6.
- */
-export class AddressBook {
-    localDomains;
-    /** lower-cased address → agentId */
-    byAddress = new Map();
-    /** agentId → canonical address */
-    byAgent = new Map();
-    catchAllAgentId;
-    /** Address mappings that collided (same address → multiple agents). */
-    conflicts = [];
-    constructor(config) {
-        this.localDomains = config.localDomains.map((d) => d.toLowerCase());
-        this.catchAllAgentId = config.catchAllAgentId;
-        for (const { agentId, address } of config.mappings) {
-            const lower = address.toLowerCase();
-            const existing = this.byAddress.get(lower);
-            if (existing !== undefined && existing !== agentId) {
-                // Two agents mapped to the same address — inbound routing would be
-                // ambiguous. Keep the first and record the collision for surfacing.
-                this.conflicts.push(`${address} → ${existing} & ${agentId}`);
-                continue;
-            }
-            this.byAddress.set(lower, agentId);
-            // First mapping for an agent is its canonical from-address.
-            if (!this.byAgent.has(agentId))
-                this.byAgent.set(agentId, address);
-        }
-    }
-    /** Primary local domain — used to mint Message-IDs and default from-addresses. */
-    primaryDomain() {
-        return this.localDomains[0] ?? "localhost";
-    }
-    /** True if `domain` (or a parent of it) is one we receive mail for. */
-    ownsDomain(domain) {
-        const d = domain.toLowerCase();
-        return this.localDomains.some((own) => d === own || d.endsWith(`.${own}`));
-    }
-    /**
-     * Resolve an inbound recipient email to a local agent (+ scope).
-     * Returns undefined if the domain is not ours, or the mailbox is unknown and
-     * no catch-all is configured.
-     */
-    resolveInbound(address) {
-        const parsed = splitAddress(address);
-        if (!parsed)
-            return undefined;
-        const { local, domain } = parsed;
-        if (!this.ownsDomain(domain))
-            return undefined;
-        // Plus-addressing: agent+scope → base agent, scope.
-        const plusIdx = local.indexOf("+");
-        const base = plusIdx === -1 ? local : local.slice(0, plusIdx);
-        const scope = plusIdx === -1 ? undefined : local.slice(plusIdx + 1) || undefined;
-        const canonical = `${base}@${domain}`.toLowerCase();
-        const agentId = this.byAddress.get(canonical);
-        if (agentId)
-            return { agentId, scope };
-        if (this.catchAllAgentId)
-            return { agentId: this.catchAllAgentId, scope };
-        return undefined;
-    }
-    /**
-     * Resolve the from-address for an outbound sender agent. Falls back to
-     * `<agentId>@<primaryDomain>` when the agent has no explicit mapping.
-     */
-    resolveFrom(agentId) {
-        const mapped = this.byAgent.get(agentId);
-        if (mapped)
-            return { address: mapped };
-        return { address: `${agentId}@${this.primaryDomain()}` };
-    }
-}
-/** Split an addr-spec into local-part and domain. Returns undefined if malformed. */
-function splitAddress(address) {
-    const at = address.indexOf("@");
-    if (at <= 0 || at !== address.lastIndexOf("@") || at === address.length - 1) {
-        // Reject empty local/domain and unquoted multiple "@" (e.g. "a@b@c"), so
-        // this layer agrees with parseAddress (which splits on the first "@").
-        return undefined;
-    }
-    const domain = address.slice(at + 1);
-    // A domain must not contain "/" (a federation scope separator) — defensive.
-    if (domain.includes("/"))
-        return undefined;
-    return { local: address.slice(0, at), domain };
-}
-//# sourceMappingURL=address-book.js.map

package/dist/mail/address-book.js.map

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

package/dist/mail/attachment-store.d.ts

@@ -1,31 +0,0 @@
-/**
- * Attachment byte stores.
- *
- * `MailAttachment.contentRef` is opaque; bytes live behind an AttachmentStore.
- * Default impl is SQLite-backed (atomic with the message, single-file backup,
- * works with the in-memory DB used in tests). A filesystem impl is opt-in for
- * large/high-volume deployments (added later). Refs are content-addressed
- * (sha256) so identical bytes dedup. See docs/MAIL-INTEROP-PLAN.md §4c.
- */
-import type Database from "better-sqlite3";
-import type { AttachmentStore } from "./types.js";
-export declare class SqliteAttachmentStore implements AttachmentStore {
-    private db;
-    private table;
-    private putStmt;
-    private getStmt;
-    private delStmt;
-    /**
-     * @param db     A better-sqlite3 handle (lifecycle owned by the caller).
-     * @param prefix Table name prefix to match the Storage convention. Default "".
-     */
-    constructor(db: Database.Database, prefix?: string);
-    private migrate;
-    put(bytes: Buffer, meta: {
-        contentType: string;
-        filename?: string;
-    }): Promise<string>;
-    get(ref: string): Promise<Buffer>;
-    delete(ref: string): Promise<void>;
-}
-//# sourceMappingURL=attachment-store.d.ts.map

package/dist/mail/attachment-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attachment-store.d.ts","sourceRoot":"","sources":["../../src/mail/attachment-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,qBAAsB,YAAW,eAAe;IAWzD,OAAO,CAAC,EAAE;IAVZ,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAqB;IAEpC;;;OAGG;gBAEO,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAC7B,MAAM,GAAE,MAAW;IAerB,OAAO,CAAC,OAAO;IAaT,GAAG,CACP,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,OAAO,CAAC,MAAM,CAAC;IAcZ,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOjC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIzC"}

package/dist/mail/attachment-store.js

@@ -1,74 +0,0 @@
-/**
- * Attachment byte stores.
- *
- * `MailAttachment.contentRef` is opaque; bytes live behind an AttachmentStore.
- * Default impl is SQLite-backed (atomic with the message, single-file backup,
- * works with the in-memory DB used in tests). A filesystem impl is opt-in for
- * large/high-volume deployments (added later). Refs are content-addressed
- * (sha256) so identical bytes dedup. See docs/MAIL-INTEROP-PLAN.md §4c.
- */
-import { createHash } from "node:crypto";
-export class SqliteAttachmentStore {
-    db;
-    table;
-    putStmt;
-    getStmt;
-    delStmt;
-    /**
-     * @param db     A better-sqlite3 handle (lifecycle owned by the caller).
-     * @param prefix Table name prefix to match the Storage convention. Default "".
-     */
-    constructor(db, prefix = "") {
-        this.db = db;
-        this.table = `${prefix}mail_attachments`;
-        this.migrate();
-        this.putStmt = this.db.prepare(`INSERT INTO ${this.table} (ref, content_type, filename, bytes, size_bytes, created_at)
-       VALUES (@ref, @content_type, @filename, @bytes, @size_bytes, @created_at)
-       ON CONFLICT(ref) DO NOTHING`);
-        this.getStmt = this.db.prepare(`SELECT bytes FROM ${this.table} WHERE ref = ?`);
-        this.delStmt = this.db.prepare(`DELETE FROM ${this.table} WHERE ref = ?`);
-    }
-    migrate() {
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS ${this.table} (
-        ref TEXT PRIMARY KEY,
-        content_type TEXT NOT NULL,
-        filename TEXT,
-        bytes BLOB NOT NULL,
-        size_bytes INTEGER NOT NULL,
-        created_at TEXT NOT NULL
-      );
-    `);
-    }
-    async put(bytes, meta) {
-        const ref = "sha256:" + createHash("sha256").update(bytes).digest("hex");
-        // ON CONFLICT DO NOTHING — content-addressed, so identical bytes are deduped.
-        this.putStmt.run({
-            ref,
-            content_type: meta.contentType,
-            filename: meta.filename ?? null,
-            bytes,
-            size_bytes: bytes.length,
-            created_at: new Date().toISOString(),
-        });
-        return ref;
-    }
-    async get(ref) {
-        assertValidRef(ref);
-        const row = this.getStmt.get(ref);
-        if (!row)
-            throw new Error(`Attachment not found: ${ref}`);
-        return row.bytes;
-    }
-    async delete(ref) {
-        assertValidRef(ref);
-        this.delStmt.run(ref);
-    }
-}
-/** Refs are always sha256-of-content; reject anything else (parity with FS store). */
-function assertValidRef(ref) {
-    if (!/^sha256:[0-9a-f]{64}$/.test(ref)) {
-        throw new Error(`Invalid attachment ref: ${ref}`);
-    }
-}
-//# sourceMappingURL=attachment-store.js.map

package/dist/mail/attachment-store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"attachment-store.js","sourceRoot":"","sources":["../../src/mail/attachment-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,OAAO,qBAAqB;IAWtB;IAVF,KAAK,CAAS;IACd,OAAO,CAAqB;IAC5B,OAAO,CAAqB;IAC5B,OAAO,CAAqB;IAEpC;;;OAGG;IACH,YACU,EAAqB,EAC7B,SAAiB,EAAE;QADX,OAAE,GAAF,EAAE,CAAmB;QAG7B,IAAI,CAAC,KAAK,GAAG,GAAG,MAAM,kBAAkB,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC5B,eAAe,IAAI,CAAC,KAAK;;mCAEI,CAC9B,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC5B,qBAAqB,IAAI,CAAC,KAAK,gBAAgB,CAChD,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,KAAK,gBAAgB,CAAC,CAAC;IAC5E,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;mCACkB,IAAI,CAAC,KAAK;;;;;;;;KAQxC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CACP,KAAa,EACb,IAAgD;QAEhD,MAAM,GAAG,GAAG,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzE,8EAA8E;QAC9E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;YACf,GAAG;YACH,YAAY,EAAE,IAAI,CAAC,WAAW;YAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;YAC/B,KAAK;YACL,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,cAAc,CAAC,GAAG,CAAC,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAkC,CAAC;QACnE,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,cAAc,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;CACF;AAED,sFAAsF;AACtF,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/mail/email-mapper.d.ts

@@ -1,41 +0,0 @@
-/**
- * Bidirectional mapping between RFC 5322 email and agent-inbox Messages.
- *
- * Parallels src/mesh/type-mapper.ts. Two pure functions:
- *   - inboundMailToMessage: external email → inbox Message
- *   - messageToOutboundMail: inbox Message → rendered OutboundMail
- *
- * Threading: RFC Message-ID / In-Reply-To / References map onto the inbox's
- * thread_tag + in_reply_to. The RFC Message-ID is preserved in metadata so a
- * later reply can reconstruct the In-Reply-To / References chain. See §5.
- */
-import type { Message } from "../types.js";
-import type { AddressBook } from "./address-book.js";
-import type { InboundMail, OutboundMail } from "./types.js";
-export interface InboundMapContext {
-    addressBook: AddressBook;
-    /** Scope assigned when plus-addressing does not specify one. */
-    defaultScope?: string;
-    /**
-     * Resolve an RFC Message-ID we have already stored to its inbox Message id,
-     * so an inbound reply can set `in_reply_to` to the real parent.
-     */
-    lookupInboxIdByRfcMessageId?: (rfcMessageId: string) => string | undefined;
-}
-export interface OutboundMapContext {
-    addressBook: AddressBook;
-    /** Domain used to mint Message-IDs. Defaults to the address book primary domain. */
-    messageIdDomain?: string;
-    /** The RFC Message-ID we recorded when the parent inbox message was sent/received. */
-    lookupRfcMessageId?: (inboxId: string) => string | undefined;
-    /** The References chain recorded for the parent inbox message. */
-    lookupReferences?: (inboxId: string) => string[] | undefined;
-}
-/** Thrown when no inbound recipient resolves to a local agent. */
-export declare class UnknownRecipientError extends Error {
-    readonly recipients: string[];
-    constructor(recipients: string[]);
-}
-export declare function inboundMailToMessage(mail: InboundMail, ctx: InboundMapContext): Message;
-export declare function messageToOutboundMail(msg: Message, ctx: OutboundMapContext): OutboundMail;
-//# sourceMappingURL=email-mapper.d.ts.map

package/dist/mail/email-mapper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"email-mapper.d.ts","sourceRoot":"","sources":["../../src/mail/email-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAwC,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAGb,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,WAAW,CAAC;IACzB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,2BAA2B,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC5E;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,oFAAoF;IACpF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7D,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EAAE,GAAG,SAAS,CAAC;CAC9D;AAED,kEAAkE;AAClE,qBAAa,qBAAsB,SAAQ,KAAK;aAClB,UAAU,EAAE,MAAM,EAAE;gBAApB,UAAU,EAAE,MAAM,EAAE;CAMjD;AAMD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAkET;AAMD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,kBAAkB,GACtB,YAAY,CAyCd"}

package/dist/mail/email-mapper.js

@@ -1,216 +0,0 @@
-/**
- * Bidirectional mapping between RFC 5322 email and agent-inbox Messages.
- *
- * Parallels src/mesh/type-mapper.ts. Two pure functions:
- *   - inboundMailToMessage: external email → inbox Message
- *   - messageToOutboundMail: inbox Message → rendered OutboundMail
- *
- * Threading: RFC Message-ID / In-Reply-To / References map onto the inbox's
- * thread_tag + in_reply_to. The RFC Message-ID is preserved in metadata so a
- * later reply can reconstruct the In-Reply-To / References chain. See §5.
- */
-import { ulid } from "ulid";
-import { createHash } from "node:crypto";
-import { normalizeContent } from "../router/message-router.js";
-/** Thrown when no inbound recipient resolves to a local agent. */
-export class UnknownRecipientError extends Error {
-    recipients;
-    constructor(recipients) {
-        super(`No inbound recipient resolved to a local agent: ${recipients.join(", ")}`);
-        this.recipients = recipients;
-        this.name = "UnknownRecipientError";
-    }
-}
-// ---------------------------------------------------------------------------
-// Inbound: email → Message
-// ---------------------------------------------------------------------------
-export function inboundMailToMessage(mail, ctx) {
-    const recipients = [];
-    const unresolved = [];
-    let scope;
-    const addKind = (addrs, kind) => {
-        for (const a of addrs ?? []) {
-            const resolved = ctx.addressBook.resolveInbound(a.address);
-            if (!resolved) {
-                unresolved.push(a.address);
-                continue;
-            }
-            recipients.push({ agent_id: resolved.agentId, kind });
-            // First resolved recipient with a plus-address scope wins. "to" is
-            // processed before "cc", so a to-scope still takes precedence, but a
-            // cc-only scoped recipient is no longer silently dropped.
-            if (scope === undefined && resolved.scope) {
-                scope = resolved.scope;
-            }
-        }
-    };
-    addKind(mail.to, "to");
-    addKind(mail.cc, "cc");
-    if (recipients.length === 0) {
-        throw new UnknownRecipientError(unresolved);
-    }
-    const rfcMessageId = mail.headers.messageId;
-    const rfcInReplyTo = mail.headers.inReplyTo;
-    const rfcReferences = mail.headers.references;
-    const metadata = {};
-    if (rfcMessageId)
-        metadata.rfcMessageId = rfcMessageId;
-    if (rfcInReplyTo)
-        metadata.rfcInReplyTo = rfcInReplyTo;
-    if (rfcReferences)
-        metadata.rfcReferences = rfcReferences;
-    if (mail.html)
-        metadata.htmlBody = mail.html;
-    if (mail.authResults)
-        metadata.authResults = mail.authResults;
-    if (mail.remote)
-        metadata.remote = mail.remote;
-    if (mail.envelopeFrom)
-        metadata.envelopeFrom = mail.envelopeFrom;
-    if (mail.bounce)
-        metadata.bounce = mail.bounce;
-    if (mail.attachments?.length)
-        metadata.mailAttachments = mail.attachments;
-    // Resolve in_reply_to to a real inbox id when we can; otherwise leave it unset
-    // (the RFC id is retained in metadata for later correlation).
-    let inReplyTo;
-    if (rfcInReplyTo && ctx.lookupInboxIdByRfcMessageId) {
-        inReplyTo = ctx.lookupInboxIdByRfcMessageId(rfcInReplyTo);
-    }
-    const text = mail.text ?? "";
-    return {
-        id: ulid(),
-        scope: scope ?? ctx.defaultScope ?? "default",
-        sender_id: mail.from.address,
-        recipients,
-        subject: mail.subject,
-        content: normalizeContent(text),
-        thread_tag: deriveThreadTag(rfcReferences, rfcInReplyTo, rfcMessageId),
-        in_reply_to: inReplyTo,
-        importance: importanceFromHeaders(mail.headers.raw),
-        metadata,
-        created_at: mail.receivedAt,
-    };
-}
-// ---------------------------------------------------------------------------
-// Outbound: Message → email
-// ---------------------------------------------------------------------------
-export function messageToOutboundMail(msg, ctx) {
-    const domain = ctx.messageIdDomain ?? ctx.addressBook.primaryDomain();
-    const to = recipientsOfKind(msg, "to");
-    const cc = recipientsOfKind(msg, "cc");
-    const bcc = recipientsOfKind(msg, "bcc");
-    const { inReplyTo, references } = buildThreadingHeaders(msg, ctx);
-    const text = textFromContent(msg);
-    const html = typeof msg.metadata.htmlBody === "string"
-        ? msg.metadata.htmlBody
-        : undefined;
-    const attachments = validateAttachments(msg.metadata.mailAttachments);
-    // Only forward an explicit, opt-in hints object to the backend. We do NOT
-    // dump arbitrary internal message metadata to the external mail provider.
-    const backendHints = msg.metadata.mailBackendHints &&
-        typeof msg.metadata.mailBackendHints === "object"
-        ? msg.metadata.mailBackendHints
-        : undefined;
-    return {
-        idempotencyKey: msg.id,
-        from: ctx.addressBook.resolveFrom(msg.sender_id),
-        to,
-        ...(cc.length ? { cc } : {}),
-        ...(bcc.length ? { bcc } : {}),
-        subject: msg.subject,
-        text,
-        ...(html ? { html } : {}),
-        headers: {
-            messageId: mintMessageId(msg.id, domain),
-            ...(inReplyTo ? { inReplyTo } : {}),
-            ...(references && references.length ? { references } : {}),
-        },
-        ...(attachments ? { attachments } : {}),
-        ...(backendHints ? { backendHints } : {}),
-    };
-}
-/** Validate untrusted attachment metadata, dropping malformed entries. */
-function validateAttachments(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const out = [];
-    for (const a of value) {
-        if (a &&
-            typeof a === "object" &&
-            typeof a.contentRef === "string" &&
-            typeof a.contentType === "string") {
-            const att = a;
-            out.push({
-                contentRef: att.contentRef,
-                contentType: att.contentType,
-                sizeBytes: typeof att.sizeBytes === "number" ? att.sizeBytes : 0,
-                ...(typeof att.filename === "string" ? { filename: att.filename } : {}),
-                ...(typeof att.contentId === "string" ? { contentId: att.contentId } : {}),
-            });
-        }
-    }
-    return out.length ? out : undefined;
-}
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-function recipientsOfKind(msg, kind) {
-    return msg.recipients
-        .filter((r) => r.kind === kind)
-        .map((r) => ({ address: r.agent_id }));
-}
-/** Stable thread tag from the root of the References chain. */
-function deriveThreadTag(references, inReplyTo, messageId) {
-    const root = (references && references.length > 0 ? references[0] : undefined) ??
-        inReplyTo ??
-        messageId;
-    if (!root)
-        return undefined;
-    const hash = createHash("sha1").update(root).digest("hex").slice(0, 12);
-    return `mail-${hash}`;
-}
-function buildThreadingHeaders(msg, ctx) {
-    if (!msg.in_reply_to) {
-        // Fresh thread, but a recorded RFC References chain (e.g. from the inbound
-        // side) should still be carried if present in metadata.
-        const meta = msg.metadata.rfcReferences;
-        return { references: Array.isArray(meta) ? meta : undefined };
-    }
-    const domain = ctx.messageIdDomain ?? ctx.addressBook.primaryDomain();
-    const parentRfcId = ctx.lookupRfcMessageId?.(msg.in_reply_to) ??
-        mintMessageId(msg.in_reply_to, domain);
-    const parentRefs = ctx.lookupReferences?.(msg.in_reply_to) ??
-        (Array.isArray(msg.metadata.rfcReferences)
-            ? msg.metadata.rfcReferences
-            : []);
-    return {
-        inReplyTo: parentRfcId,
-        references: [...parentRefs, parentRfcId],
-    };
-}
-function mintMessageId(inboxId, domain) {
-    return `<${inboxId}@${domain}>`;
-}
-function textFromContent(msg) {
-    const c = msg.content;
-    if (c.type === "text" && typeof c.text === "string")
-        return c.text;
-    return JSON.stringify(c);
-}
-function importanceFromHeaders(raw) {
-    const header = (k) => {
-        const v = raw[k];
-        return (Array.isArray(v) ? v[0] : v ?? "").toString().toLowerCase();
-    };
-    const importance = header("importance");
-    const priority = header("x-priority");
-    if (importance === "high" || priority.startsWith("1") || priority.startsWith("2")) {
-        return "high";
-    }
-    if (importance === "low" || priority.startsWith("4") || priority.startsWith("5")) {
-        return "low";
-    }
-    return "normal";
-}
-//# sourceMappingURL=email-mapper.js.map

package/dist/mail/email-mapper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"email-mapper.js","sourceRoot":"","sources":["../../src/mail/email-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAmC/D,kEAAkE;AAClE,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAClB;IAA5B,YAA4B,UAAoB;QAC9C,KAAK,CACH,mDAAmD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3E,CAAC;QAHwB,eAAU,GAAV,UAAU,CAAU;QAI9C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,MAAM,UAAU,oBAAoB,CAClC,IAAiB,EACjB,GAAsB;IAEtB,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,KAAyB,CAAC;IAE9B,MAAM,OAAO,GAAG,CAAC,KAAgC,EAAE,IAAmB,EAAE,EAAE;QACxE,KAAK,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC3B,SAAS;YACX,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,mEAAmE;YACnE,qEAAqE;YACrE,0DAA0D;YAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAC1C,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAEvB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;IAE9C,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,IAAI,YAAY;QAAE,QAAQ,CAAC,YAAY,GAAG,YAAY,CAAC;IACvD,IAAI,YAAY;QAAE,QAAQ,CAAC,YAAY,GAAG,YAAY,CAAC;IACvD,IAAI,aAAa;QAAE,QAAQ,CAAC,aAAa,GAAG,aAAa,CAAC;IAC1D,IAAI,IAAI,CAAC,IAAI;QAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;IAC7C,IAAI,IAAI,CAAC,WAAW;QAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC9D,IAAI,IAAI,CAAC,MAAM;QAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC/C,IAAI,IAAI,CAAC,YAAY;QAAE,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACjE,IAAI,IAAI,CAAC,MAAM;QAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC/C,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM;QAAE,QAAQ,CAAC,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC;IAE1E,+EAA+E;IAC/E,8DAA8D;IAC9D,IAAI,SAA6B,CAAC;IAClC,IAAI,YAAY,IAAI,GAAG,CAAC,2BAA2B,EAAE,CAAC;QACpD,SAAS,GAAG,GAAG,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAE7B,OAAO;QACL,EAAE,EAAE,IAAI,EAAE;QACV,KAAK,EAAE,KAAK,IAAI,GAAG,CAAC,YAAY,IAAI,SAAS;QAC7C,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;QAC5B,UAAU;QACV,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC;QAC/B,UAAU,EAAE,eAAe,CAAC,aAAa,EAAE,YAAY,EAAE,YAAY,CAAC;QACtE,WAAW,EAAE,SAAS;QACtB,UAAU,EAAE,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;QACnD,QAAQ;QACR,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,MAAM,UAAU,qBAAqB,CACnC,GAAY,EACZ,GAAuB;IAEvB,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;IAEtE,MAAM,EAAE,GAAG,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEzC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAElE,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,QAAQ,CAAC,QAAQ,KAAK,QAAQ;QACpD,CAAC,CAAE,GAAG,CAAC,QAAQ,CAAC,QAAmB;QACnC,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,WAAW,GAAG,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEtE,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,YAAY,GAChB,GAAG,CAAC,QAAQ,CAAC,gBAAgB;QAC7B,OAAO,GAAG,CAAC,QAAQ,CAAC,gBAAgB,KAAK,QAAQ;QAC/C,CAAC,CAAE,GAAG,CAAC,QAAQ,CAAC,gBAA4C;QAC5D,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,cAAc,EAAE,GAAG,CAAC,EAAE;QACtB,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC;QAChD,EAAE;QACF,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5B,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,IAAI;QACJ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE;YACP,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC;YACxC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3D;QACD,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IACE,CAAC;YACD,OAAO,CAAC,KAAK,QAAQ;YACrB,OAAQ,CAAoB,CAAC,UAAU,KAAK,QAAQ;YACpD,OAAQ,CAAoB,CAAC,WAAW,KAAK,QAAQ,EACrD,CAAC;YACD,MAAM,GAAG,GAAG,CAAmB,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC;gBACP,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,SAAS,EAAE,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBAChE,GAAG,CAAC,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,GAAG,CAAC,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,GAAY,EAAE,IAAmB;IACzD,OAAO,GAAG,CAAC,UAAU;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,+DAA+D;AAC/D,SAAS,eAAe,CACtB,UAAgC,EAChC,SAA6B,EAC7B,SAA6B;IAE7B,MAAM,IAAI,GACR,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,SAAS;QACT,SAAS,CAAC;IACZ,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxE,OAAO,QAAQ,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,qBAAqB,CAC5B,GAAY,EACZ,GAAuB;IAEvB,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QACrB,2EAA2E;QAC3E,wDAAwD;QACxD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC;QACxC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAiB,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAC9E,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;IACtE,MAAM,WAAW,GACf,GAAG,CAAC,kBAAkB,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC;QACzC,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAEzC,MAAM,UAAU,GACd,GAAG,CAAC,gBAAgB,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC;QACvC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC;YACxC,CAAC,CAAE,GAAG,CAAC,QAAQ,CAAC,aAA0B;YAC1C,CAAC,CAAC,EAAE,CAAC,CAAC;IAEV,OAAO;QACL,SAAS,EAAE,WAAW;QACtB,UAAU,EAAE,CAAC,GAAG,UAAU,EAAE,WAAW,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAAe,EAAE,MAAc;IACpD,OAAO,IAAI,OAAO,IAAI,MAAM,GAAG,CAAC;AAClC,CAAC;AAED,SAAS,eAAe,CAAC,GAAY;IACnC,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;IACtB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,IAAI,CAAC;IACnE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,qBAAqB,CAC5B,GAAsC;IAEtC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE;QACnC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC;IACtE,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACtC,IAAI,UAAU,KAAK,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAClF,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,UAAU,KAAK,KAAK,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/mail/fs-attachment-store.d.ts

@@ -1,38 +0,0 @@
-/**
- * Filesystem-backed AttachmentStore — opt-in for large/high-volume deployments.
- *
- * Keeps attachment bytes out of the SQLite DB (no WAL bloat, no synchronous
- * blob I/O blocking the event loop). Content-addressed by sha256, so identical
- * bytes dedup. Files live at `<dir>/<aa>/<sha256>` (sharded by the first byte
- * to avoid one enormous directory).
- *
- * Durability: writes go to a unique temp file, are fsync'd, then atomically
- * renamed into place. Because the caller stores the attachment (this `put`)
- * BEFORE committing the message row that references it, a crash can only ever
- * leave an orphan file (reclaimable by GC) — never a row pointing at missing
- * bytes. See docs/MAIL-INTEROP-PLAN.md §4c.
- */
-import type { AttachmentStore } from "./types.js";
-export declare class FsAttachmentStore implements AttachmentStore {
-    private dir;
-    constructor(dir: string);
-    put(bytes: Buffer, _meta: {
-        contentType: string;
-        filename?: string;
-    }): Promise<string>;
-    get(ref: string): Promise<Buffer>;
-    delete(ref: string): Promise<void>;
-    /**
-     * Garbage-collect orphan files: delete any stored attachment whose ref is not
-     * in `liveRefs` AND that is older than `minAgeMs` (default 1h).
-     *
-     * The age guard prevents a TOCTOU race: an attachment is `put` (file lands on
-     * disk) before the message row that references it is committed, so a just-
-     * written file may legitimately not appear in a `liveRefs` snapshot yet.
-     * Skipping recently-written files avoids deleting such in-flight attachments.
-     */
-    gc(liveRefs: Set<string>, minAgeMs?: number): Promise<number>;
-    private pathForHex;
-    private pathForRef;
-}
-//# sourceMappingURL=fs-attachment-store.d.ts.map

package/dist/mail/fs-attachment-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fs-attachment-store.d.ts","sourceRoot":"","sources":["../../src/mail/fs-attachment-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,qBAAa,iBAAkB,YAAW,eAAe;IAC3C,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM;IAEzB,GAAG,CACP,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAChD,OAAO,CAAC,MAAM,CAAC;IAoCZ,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYjC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;;;;;OAQG;IACG,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAE,MAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoC9E,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,UAAU;CASnB"}