@c9up/rover 0.1.3

package/dist/Mail.js

@@ -0,0 +1,451 @@
+import { randomBytes } from "node:crypto";
+import { RoverError } from "./RoverError.js";
+import nodemailer from "nodemailer";
+import { BaseMail } from "./BaseMail.js";
+import { MessageBuilder, } from "./MessageBuilder.js";
+import { MAIL_JOB_NAME, MailJobHandler, } from "./queue/MailJob.js";
+import { computeBackoffMs, isRetryableError, resolveRetryConfig, } from "./retry.js";
+import { setViewsRoot } from "./templating/SimpleTemplate.js";
+import { FakeMail } from "./testing/FakeMail.js";
+export { MessageBuilder };
+/**
+ * Message builder — fluent API for composing an email.
+ */
+/**
+ * SMTP transport — thin wrapper around `nodemailer`. Nodemailer handles
+ * the SMTP state machine, TLS / STARTTLS negotiation, AUTH LOGIN /
+ * PLAIN / XOAUTH2, dot-stuffing, MIME assembly, attachments, and address
+ * encoding for 10+ years. We forward the `MailMessage` shape and surface
+ * the `messageId` returned by the server.
+ */
+export class SmtpTransport {
+    #transporter;
+    constructor(config) {
+        // Host is required — defaulting to "localhost" silently hid env-var
+        // misconfigurations (SMTP_HOST unset) until the SMTP connection
+        // timed out against a nonexistent local server. Fail at
+        // construction with an actionable message instead.
+        if (config.host !== undefined && typeof config.host !== "string") {
+            throw new RoverError("MAIL_PROVIDER_CONFIG", `SMTP host must be a string, got ${typeof config.host}`, { hint: "Set config.host to your SMTP server hostname." });
+        }
+        if (typeof config.host !== "string" || config.host.length === 0) {
+            throw new RoverError("MAIL_PROVIDER_CONFIG", "SMTP host is required", {
+                hint: "Set config.host (e.g. process.env.SMTP_HOST). Use the fake / log transports for local development.",
+            });
+        }
+        const host = config.host;
+        const port = typeof config.port === "number" ? config.port : 587;
+        const secure = typeof config.secure === "boolean" ? config.secure : false;
+        const user = typeof config.user === "string" ? config.user : undefined;
+        const pass = typeof config.pass === "string" ? config.pass : undefined;
+        const requireTLS = typeof config.requireTLS === "boolean" ? config.requireTLS : undefined;
+        // Partial auth config (only user OR only pass) is almost always a typo —
+        // fail fast rather than connect anonymously and let the server reject.
+        if ((user && !pass) || (!user && pass)) {
+            throw new RoverError("MAIL_PROVIDER_CONFIG", "SMTP auth requires both `user` and `pass` or neither", {
+                hint: "Check your env vars — one half of the credential pair is missing.",
+            });
+        }
+        // Allow DI for tests: if the config carries a pre-built transporter,
+        // use it instead of nodemailer.createTransport.
+        const injected = config._transporter;
+        if (injected && typeof injected === "object" && "sendMail" in injected) {
+            this.#transporter = injected;
+        }
+        else {
+            this.#transporter = nodemailer.createTransport({
+                host,
+                port,
+                secure,
+                requireTLS,
+                auth: user && pass ? { user, pass } : undefined,
+            });
+        }
+    }
+    async send(message) {
+        if (message.to.length === 0 &&
+            message.cc.length === 0 &&
+            message.bcc.length === 0) {
+            throw new RoverError("MAIL_PROVIDER_CONFIG", "Mail message has no recipients", { hint: "Set at least one `to`, `cc`, or `bcc` before sending." });
+        }
+        try {
+            const info = await this.#transporter.sendMail({
+                from: message.from,
+                to: message.to,
+                cc: message.cc.length ? message.cc : undefined,
+                bcc: message.bcc.length ? message.bcc : undefined,
+                replyTo: message.replyTo,
+                subject: message.subject,
+                html: message.html,
+                text: message.text,
+                headers: Object.keys(message.headers).length
+                    ? message.headers
+                    : undefined,
+                attachments: message.attachments.length
+                    ? message.attachments.map((att) => ({
+                        filename: att.filename,
+                        content: att.content,
+                        contentType: att.contentType,
+                    }))
+                    : undefined,
+            });
+            if (info.messageId)
+                return { providerId: info.messageId };
+            return undefined;
+        }
+        catch (err) {
+            throw wrapSmtpError(err);
+        }
+    }
+}
+/**
+ * Normalise nodemailer / socket errors into the uniform `MAIL_PROVIDER_ERROR`
+ * shape used by the rest of the library. Preserves the `code` field (errno)
+ * in `context.networkCode` so `isRetryableError` can classify transient
+ * network failures without losing the root cause.
+ */
+function wrapSmtpError(err) {
+    if (err instanceof RoverError)
+        return err;
+    const anyErr = err;
+    const status = typeof anyErr.responseCode === "number" ? anyErr.responseCode : 0;
+    const ctx = {
+        provider: "smtp",
+        upstreamStatus: String(status),
+        providerMessage: anyErr.message ?? "unknown",
+    };
+    if (typeof anyErr.code === "string") {
+        ctx.networkCode = anyErr.code;
+    }
+    return new RoverError("MAIL_PROVIDER_ERROR", `SMTP failed: ${anyErr.message ?? "unknown"}`, {
+        hint: "Inspect `context.networkCode` (ECONNRESET/ETIMEDOUT/...) or `context.upstreamStatus` (SMTP response code) to decide retry eligibility.",
+        context: ctx,
+    });
+}
+/**
+ * Log transport — logs emails to console (development).
+ */
+export class LogTransport {
+    async send(message) {
+        console.log(`[MAIL] To: ${message.to.join(", ")} | Subject: ${message.subject}`);
+        if (message.text)
+            console.log(`  Body: ${message.text.slice(0, 200)}`);
+        return undefined;
+    }
+}
+const transportFactories = {
+    smtp: (config) => new SmtpTransport(config),
+    log: () => new LogTransport(),
+};
+/**
+ * Register a custom transport factory globally.
+ *
+ * @example
+ *   registerTransport('mailgun', (config) => new MailgunTransport(config))
+ *   // Now config/mail.ts can reference `transport: 'mailgun'`
+ */
+export function registerTransport(name, factory) {
+    transportFactories[name] = factory;
+}
+/**
+ * Mail manager — send emails via configured transport.
+ */
+export class Mail {
+    #transports = new Map();
+    #defaultTransport;
+    #defaultFrom;
+    #fakeSnapshot = null;
+    #queue = null;
+    #queueName;
+    #queueMaxAttempts;
+    #globalRetry;
+    #transportRetry = new Map();
+    #hooks;
+    #emitter;
+    constructor(config, options) {
+        this.#defaultTransport = config.default;
+        this.#defaultFrom = config.from;
+        // Bay uses a single `name` for both `register(name, handler)` and
+        // `dispatch(name, payload)`. Default to the canonical mail job name.
+        this.#queueName = config.queue?.name ?? MAIL_JOB_NAME;
+        this.#queueMaxAttempts = config.queue?.maxAttempts ?? 3;
+        this.#globalRetry = config.retry;
+        this.#hooks = options?.hooks ?? {};
+        this.#emitter = options?.emitter ?? null;
+        if (config.viewsRoot !== undefined) {
+            setViewsRoot(config.viewsRoot);
+        }
+        for (const [name, transportConfig] of Object.entries(config.transports)) {
+            const factory = transportFactories[transportConfig.transport];
+            if (!factory) {
+                throw new RoverError("MAIL_UNKNOWN_TRANSPORT", `Unknown mail transport type '${transportConfig.transport}' (configured under name '${name}')`, {
+                    hint: "Register the transport with registerTransport() before constructing Mail, or fix the typo in config.mail.transports[*].transport.",
+                });
+            }
+            this.#transports.set(name, factory(transportConfig));
+            if (transportConfig.retry) {
+                this.#transportRetry.set(name, transportConfig.retry);
+            }
+        }
+        if (options?.queue) {
+            this.#queue = options.queue;
+            this.#queue.register(this.#queueName, new MailJobHandler(this));
+        }
+    }
+    async send(arg, transport) {
+        const transportName = transport ?? this.#defaultTransport;
+        // Validate transport up-front before running any callback / prepare() side effects.
+        if (!this.#transports.has(transportName)) {
+            throw new Error(`Mail transport '${transportName}' not configured`);
+        }
+        const message = await this.#buildMessage(arg);
+        await this.dispatchMessage(message, transportName);
+    }
+    /**
+     * Enqueue a send onto the Bay queue. Returns the job id. Throws
+     * `MAIL_QUEUE_REQUIRED` if no `QueueManager` was wired through the
+     * constructor options.
+     */
+    async sendLater(arg, options) {
+        if (this.#queue === null) {
+            throw new RoverError("MAIL_QUEUE_REQUIRED", "mail.sendLater() requires @c9up/bay QueueManager", {
+                hint: "Register @c9up/bay and pass the QueueManager to Mail via RoverProvider, or use mail.send() for synchronous delivery.",
+            });
+        }
+        const message = await this.#buildMessage(arg);
+        const queueName = options?.queue ?? this.#queueName;
+        return this.#queue.dispatch(queueName, { message, transport: options?.transport }, { maxAttempts: this.#queueMaxAttempts });
+    }
+    /**
+     * Shared transport-resolve-then-send helper used by `send()` and `MailJobHandler`.
+     * Applies in-process retry with exponential backoff per `RetryConfig` resolution
+     * (per-transport > global > library default). Fires `onSent` / `onFailed` hooks.
+     *
+     * `overrideRetry` (optional) wins over config-level retry; `MailJobHandler` passes
+     * `{ maxAttempts: 1 }` so queue-level and sync-level retries don't compound.
+     */
+    async dispatchMessage(message, transportName, overrideRetry) {
+        // Defense-in-depth: queue payloads bypass `#buildMessage`, so a
+        // malformed message deserialised from storage would otherwise reach
+        // the transport with the cryptic provider error A2 was meant to
+        // eliminate. Cheap re-validation on every dispatch keeps the
+        // failure mode uniform across send() and queue dequeue.
+        validateMailMessage(message);
+        const name = transportName ?? this.#defaultTransport;
+        const t = this.#transports.get(name);
+        if (!t)
+            throw new Error(`Mail transport '${name}' not configured`);
+        const retry = overrideRetry
+            ? resolveRetryConfig(undefined, overrideRetry)
+            : resolveRetryConfig(this.#globalRetry, this.#transportRetry.get(name));
+        const generatedId = randomBytes(16).toString("hex");
+        let lastError;
+        for (let attempt = 1; attempt <= retry.maxAttempts; attempt += 1) {
+            let sendResult;
+            try {
+                sendResult = await t.send(message);
+            }
+            catch (err) {
+                lastError = err;
+                const retryable = isRetryableError(err);
+                if (!retryable || attempt === retry.maxAttempts) {
+                    const annotated = this.#withAttempts(err, attempt);
+                    this.#fireFailed({
+                        messageId: generatedId,
+                        to: message.to.slice(),
+                        cc: message.cc.slice(),
+                        bcc: message.bcc.slice(),
+                        transportName: name,
+                        error: errorDescriptor(annotated, attempt),
+                        timestamp: Date.now(),
+                    });
+                    throw annotated;
+                }
+                const delay = computeBackoffMs(attempt, retry, err);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                continue;
+            }
+            // Success path lives outside the try/catch so a throw inside the
+            // success hook cannot be mistaken for a transport failure.
+            const providerIdRaw = sendResult &&
+                typeof sendResult === "object" &&
+                "providerId" in sendResult
+                ? sendResult.providerId
+                : undefined;
+            // `??` would accept empty-string providerId; explicit truthy check
+            // so a provider returning `{ providerId: "" }` falls back to the
+            // internally generated correlation id.
+            const providerId = providerIdRaw && providerIdRaw.length > 0 ? providerIdRaw : undefined;
+            this.#fireSent({
+                messageId: providerId ?? generatedId,
+                to: message.to.slice(),
+                cc: message.cc.slice(),
+                bcc: message.bcc.slice(),
+                transportName: name,
+                timestamp: Date.now(),
+            });
+            return;
+        }
+        // Unreachable — the loop always returns or throws — but TS wants a throw.
+        throw lastError;
+    }
+    /**
+     * Return a shallow clone of `err` with `context.attempts` annotated. We
+     * avoid mutating the original error so outer retry layers / shared error
+     * references don't see their attempt counter overwritten.
+     */
+    #withAttempts(err, attempts) {
+        if (!(err instanceof RoverError))
+            return err;
+        const clone = new RoverError(err.code, err.message, {
+            hint: err.hint,
+            sourceFile: err.sourceFile,
+            sourceLine: err.sourceLine,
+            docsUrl: err.docsUrl,
+            pipelineStage: err.pipelineStage,
+            context: { ...err.context, attempts: String(attempts) },
+        });
+        if (err.stack)
+            clone.stack = err.stack;
+        return clone;
+    }
+    #fireSent(event) {
+        // Hooks are in user-land and may throw; their failure must not poison
+        // delivery outcome. Emitter errors are already defensively swallowed.
+        try {
+            this.#hooks.onSent?.(event);
+        }
+        catch (err) {
+            process.stderr.write(`[rover] onSent hook threw: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+        if (this.#emitter) {
+            try {
+                this.#emitter.emit("mail.sent", event);
+            }
+            catch {
+                // Event bus failure ≠ mail delivery failure — swallow.
+            }
+        }
+    }
+    #fireFailed(event) {
+        try {
+            this.#hooks.onFailed?.(event);
+        }
+        catch (err) {
+            process.stderr.write(`[rover] onFailed hook threw: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+        if (this.#emitter) {
+            try {
+                this.#emitter.emit("mail.failed", event);
+            }
+            catch {
+                // Event bus failure ≠ mail delivery failure — swallow.
+            }
+        }
+    }
+    async #buildMessage(arg) {
+        let result;
+        if (arg instanceof BaseMail) {
+            const built = await arg.build();
+            result = built.from ? built : { ...built, from: this.#defaultFrom };
+        }
+        else {
+            const builder = new MessageBuilder();
+            builder.from(this.#defaultFrom);
+            arg(builder);
+            result = await builder.build();
+        }
+        validateMailMessage(result);
+        return result;
+    }
+    /** Get a specific transport. */
+    use(name) {
+        const t = this.#transports.get(name);
+        if (!t)
+            throw new Error(`Mail transport '${name}' not configured`);
+        return t;
+    }
+    /**
+     * Swap the default transport with a `FakeMail` that captures every send.
+     * Call `restore()` to re-install the original. Throws if a fake is already
+     * active — nested fakes always indicate a forgotten `restore()`.
+     */
+    fake() {
+        if (this.#fakeSnapshot !== null) {
+            throw new Error("Mail.fake() already active — call restore() first");
+        }
+        const transportName = this.#defaultTransport;
+        const original = this.#transports.get(transportName);
+        if (!original) {
+            throw new Error(`Cannot fake default transport '${transportName}' — not configured`);
+        }
+        const fake = new FakeMail();
+        this.#fakeSnapshot = { transportName, original };
+        this.#transports.set(transportName, fake);
+        return fake;
+    }
+    /** Undo the swap installed by `fake()`. No-op if no fake is active. */
+    restore() {
+        if (this.#fakeSnapshot === null)
+            return;
+        const { transportName, original } = this.#fakeSnapshot;
+        this.#transports.set(transportName, original);
+        this.#fakeSnapshot = null;
+    }
+}
+/**
+ * Reject empty `from` and empty recipients before any transport is reached —
+ * keeps the failure mode uniform across SMTP / Mailgun / SendGrid / SES /
+ * Resend / log instead of relying on each transport to surface a (possibly
+ * cryptic) "no recipients" provider error.
+ */
+function validateMailMessage(message) {
+    // `MailMessage.from` is typed `string` but config-loader paths
+    // (`app.config.get<MailConfig>(...)`) cast at runtime — a missing key
+    // can yield `undefined` despite the type. Whitespace-only is also
+    // invalid per RFC 5321 reverse-path semantics.
+    if (typeof message.from !== "string" || message.from.trim() === "") {
+        throw new RoverError("MAIL_INVALID_MESSAGE", "Mail message has no `from` address", {
+            hint: "Set `config.from`, an instance `from`, or call `message.from(...)` in the builder.",
+        });
+    }
+    // Defense-in-depth on each array: `MailJob.validatePayload` only requires
+    // `to` to be an array (cc/bcc are optional at the queue boundary), so a
+    // deserialised job payload may reach here with `cc`/`bcc` as `undefined`.
+    // `.some(...)` on `undefined` throws `TypeError` instead of the
+    // structured `MAIL_INVALID_MESSAGE` this validator is supposed to surface.
+    const hasRecipient = (Array.isArray(message.to) && message.to.some(isNonEmptyAddress)) ||
+        (Array.isArray(message.cc) && message.cc.some(isNonEmptyAddress)) ||
+        (Array.isArray(message.bcc) && message.bcc.some(isNonEmptyAddress));
+    if (!hasRecipient) {
+        throw new RoverError("MAIL_INVALID_MESSAGE", "Mail message has no recipients", {
+            hint: "Call `message.to(...)`, `cc(...)`, or `bcc(...)` with a non-empty address before sending.",
+        });
+    }
+}
+function isNonEmptyAddress(addr) {
+    return typeof addr === "string" && addr.trim() !== "";
+}
+function errorDescriptor(err, attempts) {
+    if (err instanceof RoverError) {
+        const statusStr = err.context.upstreamStatus;
+        const upstream = Number(statusStr);
+        return {
+            code: err.code,
+            message: err.message,
+            upstreamStatus: Number.isFinite(upstream) ? upstream : undefined,
+            upstreamStatusRaw: statusStr,
+            attempts,
+        };
+    }
+    if (err instanceof Error) {
+        const errnoCode = err.code;
+        return {
+            code: typeof errnoCode === "string" ? errnoCode : "UNKNOWN",
+            message: err.message,
+            attempts,
+        };
+    }
+    return { code: "UNKNOWN", message: String(err), attempts };
+}
+//# sourceMappingURL=Mail.js.map

package/dist/Mail.js.map

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

package/dist/MessageBuilder.d.ts

@@ -0,0 +1,38 @@
+export interface MailMessage {
+    from: string;
+    to: string[];
+    cc: string[];
+    bcc: string[];
+    replyTo?: string;
+    subject: string;
+    html?: string;
+    text?: string;
+    attachments: MailAttachment[];
+    headers: Record<string, string>;
+}
+export interface MailAttachment {
+    filename: string;
+    content: Buffer | string;
+    contentType?: string;
+}
+export declare class MessageBuilder {
+    #private;
+    from(address: string): this;
+    to(address: string): this;
+    cc(address: string): this;
+    bcc(address: string): this;
+    replyTo(address: string): this;
+    subject(text: string): this;
+    html(content: string): this;
+    text(content: string): this;
+    attach(filename: string, content: Buffer | string, contentType?: string): this;
+    header(key: string, value: string): this;
+    /**
+     * Queue an HTML template render. The render happens lazily at `build()` time
+     * so the fluent chain stays synchronous; `build()` is async and awaits the
+     * render before returning the finalised `MailMessage`.
+     */
+    htmlView(viewPath: string, data?: Record<string, unknown>): this;
+    build(): Promise<MailMessage>;
+}
+//# sourceMappingURL=MessageBuilder.d.ts.map

package/dist/MessageBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageBuilder.d.ts","sourceRoot":"","sources":["../src/MessageBuilder.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,cAAc;;IAY1B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIzB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIzB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B,MAAM,CACL,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,WAAW,CAAC,EAAE,MAAM,GAClB,IAAI;IAKP,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK1D,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;CAUnC"}

package/dist/MessageBuilder.js

@@ -0,0 +1,70 @@
+import { renderFile as renderTemplateFile } from "./templating/SimpleTemplate.js";
+export class MessageBuilder {
+    #msg = {
+        from: "",
+        to: [],
+        cc: [],
+        bcc: [],
+        subject: "",
+        attachments: [],
+        headers: {},
+    };
+    #pendingView = null;
+    from(address) {
+        this.#msg.from = address;
+        return this;
+    }
+    to(address) {
+        this.#msg.to.push(address);
+        return this;
+    }
+    cc(address) {
+        this.#msg.cc.push(address);
+        return this;
+    }
+    bcc(address) {
+        this.#msg.bcc.push(address);
+        return this;
+    }
+    replyTo(address) {
+        this.#msg.replyTo = address;
+        return this;
+    }
+    subject(text) {
+        this.#msg.subject = text;
+        return this;
+    }
+    html(content) {
+        this.#msg.html = content;
+        return this;
+    }
+    text(content) {
+        this.#msg.text = content;
+        return this;
+    }
+    attach(filename, content, contentType) {
+        this.#msg.attachments.push({ filename, content, contentType });
+        return this;
+    }
+    header(key, value) {
+        this.#msg.headers[key] = value;
+        return this;
+    }
+    /**
+     * Queue an HTML template render. The render happens lazily at `build()` time
+     * so the fluent chain stays synchronous; `build()` is async and awaits the
+     * render before returning the finalised `MailMessage`.
+     */
+    htmlView(viewPath, data) {
+        this.#pendingView = { path: viewPath, data: data ?? {} };
+        return this;
+    }
+    async build() {
+        if (this.#pendingView !== null) {
+            this.#msg.html = await renderTemplateFile(this.#pendingView.path, this.#pendingView.data);
+            this.#pendingView = null;
+        }
+        return this.#msg;
+    }
+}
+//# sourceMappingURL=MessageBuilder.js.map

package/dist/MessageBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageBuilder.js","sourceRoot":"","sources":["../src/MessageBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAqBlF,MAAM,OAAO,cAAc;IAC1B,IAAI,GAAgB;QACnB,IAAI,EAAE,EAAE;QACR,EAAE,EAAE,EAAE;QACN,EAAE,EAAE,EAAE;QACN,GAAG,EAAE,EAAE;QACP,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;KACX,CAAC;IACF,YAAY,GAA2D,IAAI,CAAC;IAE5E,IAAI,CAAC,OAAe;QACnB,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACzB,OAAO,IAAI,CAAC;IACb,CAAC;IACD,EAAE,CAAC,OAAe;QACjB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACb,CAAC;IACD,EAAE,CAAC,OAAe;QACjB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACb,CAAC;IACD,GAAG,CAAC,OAAe;QAClB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,CAAC,OAAe;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAC5B,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,CAAC,IAAY;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,CAAC,OAAe;QACnB,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACzB,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,CAAC,OAAe;QACnB,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACzB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,CACL,QAAgB,EAChB,OAAwB,EACxB,WAAoB;QAEpB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,KAAa;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC/B,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,QAAgB,EAAE,IAA8B;QACxD,IAAI,CAAC,YAAY,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,KAAK;QACV,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,MAAM,kBAAkB,CACxC,IAAI,CAAC,YAAY,CAAC,IAAI,EACtB,IAAI,CAAC,YAAY,CAAC,IAAI,CACtB,CAAC;YACF,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;CACD"}

package/dist/RoverError.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Rover's own structured error — keeps the package framework-agnostic (no
+ * dependency on `@c9up/ream`'s `ReamError`). Mirrors the error shape Rover
+ * carries through its transports and retry logic.
+ */
+export declare class RoverError extends Error {
+    /** Error code (e.g. "ROVER_SMTP_ERROR"). */
+    readonly code: string;
+    /** Additional context key-value pairs. */
+    readonly context: Record<string, string>;
+    /** Actionable hint for the developer. */
+    readonly hint?: string;
+    /** Source file where the error originated. */
+    readonly sourceFile?: string;
+    /** Line number in the source file. */
+    readonly sourceLine?: number;
+    /** URL to the error documentation page. */
+    readonly docsUrl?: string;
+    /** Pipeline stage where the error occurred (if applicable). */
+    readonly pipelineStage?: string;
+    constructor(code: string, message: string, options?: {
+        context?: Record<string, string>;
+        hint?: string;
+        sourceFile?: string;
+        sourceLine?: number;
+        docsUrl?: string;
+        pipelineStage?: string;
+    });
+}
+//# sourceMappingURL=RoverError.d.ts.map

package/dist/RoverError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoverError.d.ts","sourceRoot":"","sources":["../src/RoverError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;gBAG/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;KACvB;CAYF"}

package/dist/RoverError.js

@@ -0,0 +1,33 @@
+/**
+ * Rover's own structured error — keeps the package framework-agnostic (no
+ * dependency on `@c9up/ream`'s `ReamError`). Mirrors the error shape Rover
+ * carries through its transports and retry logic.
+ */
+export class RoverError extends Error {
+    /** Error code (e.g. "ROVER_SMTP_ERROR"). */
+    code;
+    /** Additional context key-value pairs. */
+    context;
+    /** Actionable hint for the developer. */
+    hint;
+    /** Source file where the error originated. */
+    sourceFile;
+    /** Line number in the source file. */
+    sourceLine;
+    /** URL to the error documentation page. */
+    docsUrl;
+    /** Pipeline stage where the error occurred (if applicable). */
+    pipelineStage;
+    constructor(code, message, options) {
+        super(message);
+        this.name = "RoverError";
+        this.code = code;
+        this.context = options?.context ?? {};
+        this.hint = options?.hint;
+        this.sourceFile = options?.sourceFile;
+        this.sourceLine = options?.sourceLine;
+        this.docsUrl = options?.docsUrl;
+        this.pipelineStage = options?.pipelineStage;
+    }
+}
+//# sourceMappingURL=RoverError.js.map