@c9up/rover 0.1.3

package/dist/RoverError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoverError.js","sourceRoot":"","sources":["../src/RoverError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACpC,4CAA4C;IACnC,IAAI,CAAS;IACtB,0CAA0C;IACjC,OAAO,CAAyB;IACzC,yCAAyC;IAChC,IAAI,CAAU;IACvB,8CAA8C;IACrC,UAAU,CAAU;IAC7B,sCAAsC;IAC7B,UAAU,CAAU;IAC7B,2CAA2C;IAClC,OAAO,CAAU;IAC1B,+DAA+D;IACtD,aAAa,CAAU;IAEhC,YACC,IAAY,EACZ,OAAe,EACf,OAOC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QAChC,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,CAAC;IAC7C,CAAC;CACD"}

package/dist/RoverProvider.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Duck-typed slice of the host's IoC container — rover does NOT import
+ * `@c9up/ream` so it stays publishable as a standalone package.
+ */
+interface RoverContainer {
+    singleton(token: unknown, factory: () => unknown): void;
+    resolve<T = unknown>(token: unknown): T;
+}
+interface RoverConfigStore {
+    get<T = unknown>(key: string): T | undefined;
+}
+export interface RoverAppContext {
+    container: RoverContainer;
+    config: RoverConfigStore;
+}
+export default class RoverProvider {
+    protected app: RoverAppContext;
+    constructor(app: RoverAppContext);
+    register(): void;
+    boot(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=RoverProvider.d.ts.map

package/dist/RoverProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoverProvider.d.ts","sourceRoot":"","sources":["../src/RoverProvider.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,UAAU,cAAc;IACvB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CACxC;AACD,UAAU,gBAAgB;IACzB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AACD,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,OAAO,aAAa;IACrB,SAAS,CAAC,GAAG,EAAE,eAAe;gBAApB,GAAG,EAAE,eAAe;IAE1C,QAAQ;IA0BF,IAAI;IAOJ,QAAQ;CACd"}

package/dist/RoverProvider.js

@@ -0,0 +1,51 @@
+import { Mail } from "./Mail.js";
+import { setMail } from "./services/main.js";
+export default class RoverProvider {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    register() {
+        this.app.container.singleton(Mail, () => {
+            const config = this.app.config.get("mail");
+            return new Mail(config ?? {
+                default: "log",
+                from: "noreply@localhost",
+                transports: { log: { transport: "log" } },
+            }, {
+                // Optional-peer wiring: if `@c9up/bay` is installed and its
+                // `QueueManager` is registered in the container, Mail gets
+                // queue support for `sendLater()`. If not, `sendLater()`
+                // throws `MAIL_QUEUE_REQUIRED` at call time (by design).
+                queue: tryResolve(this.app, "QueueManager"),
+                // Same pattern for the event bus `Emitter` — enables `mail.sent`
+                // / `mail.failed` emission when available.
+                emitter: tryResolve(this.app, "Emitter"),
+            });
+        });
+        this.app.container.singleton("mail", () => {
+            return this.app.container.resolve(Mail);
+        });
+    }
+    async boot() {
+        // Populate the `@c9up/rover/services/main` singleton with the
+        // container-resolved Mail instance so apps can
+        // `import mail from '@c9up/rover/services/main'` from anywhere.
+        setMail(this.app.container.resolve(Mail));
+    }
+    async shutdown() { }
+}
+/**
+ * Resolve a token from the container without throwing when it's not
+ * registered. Rover never hard-depends on Bay or the event bus — both wire-points
+ * are purely opt-in.
+ */
+function tryResolve(app, token) {
+    try {
+        return app.container.resolve(token);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=RoverProvider.js.map

package/dist/RoverProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoverProvider.js","sourceRoot":"","sources":["../src/RoverProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAkB7C,MAAM,CAAC,OAAO,OAAO,aAAa;IACX;IAAtB,YAAsB,GAAoB;QAApB,QAAG,GAAH,GAAG,CAAiB;IAAG,CAAC;IAE9C,QAAQ;QACP,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE;YACvC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAa,MAAM,CAAC,CAAC;YACvD,OAAO,IAAI,IAAI,CACd,MAAM,IAAI;gBACT,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,mBAAmB;gBACzB,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE;aACzC,EACD;gBACC,4DAA4D;gBAC5D,2DAA2D;gBAC3D,yDAAyD;gBACzD,yDAAyD;gBACzD,KAAK,EAAE,UAAU,CAAe,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC;gBACzD,iEAAiE;gBACjE,2CAA2C;gBAC3C,OAAO,EAAE,UAAU,CAAc,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC;aACrD,CACD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE;YACzC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAO,IAAI,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACT,8DAA8D;QAC9D,+CAA+C;QAC/C,gEAAgE;QAChE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAO,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,QAAQ,KAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAI,GAAoB,EAAE,KAAa;IACzD,IAAI,CAAC;QACJ,OAAO,GAAG,CAAC,SAAS,CAAC,OAAO,CAAI,KAAK,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { MailConfig } from "./Mail.js";
+export declare function defineConfig(config: MailConfig): MailConfig;
+export type { MailConfig };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE3D;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/config.js

@@ -0,0 +1,4 @@
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC9C,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { MailAddress } from "./BaseMail.js";
+export { BaseMail } from "./BaseMail.js";
+export { defineConfig } from "./config.js";
+export { RoverError } from "./RoverError.js";
+export type { EmitterLike, MailAttachment, MailConfig, MailFailedEvent, MailHooks, MailMessage, MailSendOutcome, MailSendResult, MailSentEvent, MailTransport, MailTransportFactory, } from "./Mail.js";
+export { LogTransport, Mail, MessageBuilder, registerTransport, SmtpTransport, } from "./Mail.js";
+export { default as RoverProvider } from "./RoverProvider.js";
+export { DEFAULT_RETRY_CONFIG, isRetryableError, type RetryConfig, } from "./retry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,eAAe,EACf,SAAS,EACT,WAAW,EACX,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,oBAAoB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,YAAY,EACZ,IAAI,EACJ,cAAc,EACd,iBAAiB,EACjB,aAAa,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACN,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,WAAW,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { BaseMail } from "./BaseMail.js";
+export { defineConfig } from "./config.js";
+export { RoverError } from "./RoverError.js";
+export { LogTransport, Mail, MessageBuilder, registerTransport, SmtpTransport, } from "./Mail.js";
+export { default as RoverProvider } from "./RoverProvider.js";
+export { DEFAULT_RETRY_CONFIG, isRetryableError, } from "./retry.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAc7C,OAAO,EACN,YAAY,EACZ,IAAI,EACJ,cAAc,EACd,iBAAiB,EACjB,aAAa,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACN,oBAAoB,EACpB,gBAAgB,GAEhB,MAAM,YAAY,CAAC"}

package/dist/queue/MailJob.d.ts

@@ -0,0 +1,41 @@
+import type { MailMessage } from "../Mail.js";
+export declare const MAIL_JOB_NAME = "mail.send";
+export interface MailJobPayload {
+    message: MailMessage;
+    transport?: string;
+}
+/**
+ * Minimal structural interface for Bay's `QueueManager` — peer-dep friendly,
+ * matches `@c9up/bay`'s public API so `new QueueManager(driver)` is assignable.
+ */
+export interface BayQueueLike {
+    register(name: string, handler: BayJobHandlerLike): void;
+    dispatch(name: string, payload: unknown, options?: {
+        maxAttempts?: number;
+    }): Promise<string>;
+}
+export interface BayJobHandlerLike {
+    handle(payload: unknown): Promise<void>;
+}
+/** Pared-down RetryConfig shape — avoids importing from `../retry.js` into queue/. */
+interface RetryOverride {
+    maxAttempts: number;
+    baseDelayMs: number;
+    factor: number;
+    maxDelayMs?: number;
+}
+export interface MailDispatcher {
+    dispatchMessage(message: MailMessage, transport?: string, overrideRetry?: RetryOverride): Promise<void>;
+}
+/**
+ * Bay job handler for queued mail. Sets `maxAttempts: 1` so the in-process
+ * retry loop runs exactly once per job execution — Bay's own `maxAttempts`
+ * handles re-dispatch on throw. Prevents sync × queue retry compounding.
+ */
+export declare class MailJobHandler implements BayJobHandlerLike {
+    #private;
+    constructor(mail: MailDispatcher);
+    handle(payload: unknown): Promise<void>;
+}
+export {};
+//# sourceMappingURL=MailJob.d.ts.map

package/dist/queue/MailJob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MailJob.d.ts","sourceRoot":"","sources":["../../src/queue/MailJob.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzD,QAAQ,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,MAAM,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,sFAAsF;AACtF,UAAU,aAAa;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC9B,eAAe,CACd,OAAO,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,aAAa,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,cAAe,YAAW,iBAAiB;;gBAG3C,IAAI,EAAE,cAAc;IAI1B,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAY7C"}

package/dist/queue/MailJob.js

@@ -0,0 +1,75 @@
+import { Buffer } from "node:buffer";
+import { RoverError } from "../RoverError.js";
+export const MAIL_JOB_NAME = "mail.send";
+/**
+ * Bay job handler for queued mail. Sets `maxAttempts: 1` so the in-process
+ * retry loop runs exactly once per job execution — Bay's own `maxAttempts`
+ * handles re-dispatch on throw. Prevents sync × queue retry compounding.
+ */
+export class MailJobHandler {
+    #mail;
+    constructor(mail) {
+        this.#mail = mail;
+    }
+    async handle(payload) {
+        const parsed = validatePayload(payload);
+        // `{ maxAttempts: 1 }` alone is sufficient — the loop runs exactly once
+        // and `computeBackoffMs` is never reached; the other RetryConfig fields
+        // resolve to defaults via `resolveRetryConfig` but don't affect control
+        // flow. Matches AC 8 wording exactly.
+        await this.#mail.dispatchMessage(revive(parsed.message), parsed.transport, {
+            maxAttempts: 1,
+            baseDelayMs: 0,
+            factor: 1,
+        });
+    }
+}
+/**
+ * Narrow an `unknown` payload from the queue driver into a `MailJobPayload`.
+ * Throws `MAIL_JOB_MALFORMED` when the shape is unrecognisable so Bay records
+ * a clean failure rather than crashing inside `dispatchMessage` with a raw
+ * `TypeError`.
+ */
+function validatePayload(payload) {
+    if (!payload || typeof payload !== "object") {
+        throw new RoverError("MAIL_JOB_MALFORMED", "Mail job payload is missing or not an object", { hint: "Queue driver returned a non-object — check serialisation." });
+    }
+    const asObj = payload;
+    const message = asObj.message;
+    if (!message || typeof message !== "object") {
+        throw new RoverError("MAIL_JOB_MALFORMED", "Mail job payload.message is missing or not an object", {
+            hint: "Payload shape must be { message: MailMessage, transport?: string }.",
+        });
+    }
+    const m = message;
+    if (typeof m.from !== "string" ||
+        !Array.isArray(m.to) ||
+        !Array.isArray(m.attachments)) {
+        throw new RoverError("MAIL_JOB_MALFORMED", "Mail job payload.message does not match MailMessage shape", {
+            hint: "Expected `{ from: string, to: string[], ..., attachments: [] }`.",
+        });
+    }
+    const transport = typeof asObj.transport === "string" ? asObj.transport : undefined;
+    return { message: message, transport };
+}
+/**
+ * Revive Buffer attachments after JSON round-trip. Node serialises `Buffer` as
+ * `{ type: "Buffer", data: [...bytes] }`; we reconstruct to real `Buffer`.
+ */
+function revive(message) {
+    if (!message.attachments || message.attachments.length === 0)
+        return message;
+    const attachments = message.attachments.map((att) => {
+        if (typeof att.content === "string")
+            return att;
+        if (Buffer.isBuffer(att.content))
+            return att;
+        const serialised = att.content;
+        if (serialised?.type === "Buffer" && Array.isArray(serialised.data)) {
+            return { ...att, content: Buffer.from(serialised.data) };
+        }
+        return att;
+    });
+    return { ...message, attachments };
+}
+//# sourceMappingURL=MailJob.js.map

package/dist/queue/MailJob.js.map

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

package/dist/retry.d.ts

@@ -0,0 +1,20 @@
+export interface RetryConfig {
+    maxAttempts: number;
+    baseDelayMs: number;
+    factor: number;
+    maxDelayMs?: number;
+}
+export declare const DEFAULT_RETRY_CONFIG: Required<RetryConfig>;
+/**
+ * A failure is retryable when:
+ *   - it's a `MAIL_PROVIDER_ERROR` with `upstreamStatus` 429 or ≥ 500
+ *   - or it's a `MAIL_PROVIDER_ERROR` whose `context.networkCode` is a known
+ *     retryable Node errno (SDK wrappers surface the original errno this way
+ *     when the HTTP layer never produced a status)
+ *   - or it's a raw Error with a matching Node networking errno on `.code`
+ * 4xx (non-429) is treated as permanent: retrying won't help.
+ */
+export declare function isRetryableError(err: unknown): boolean;
+export declare function computeBackoffMs(attempt: number, config: Required<RetryConfig>, err?: unknown): number;
+export declare function resolveRetryConfig(globalConfig: RetryConfig | undefined, transportConfig: RetryConfig | undefined): Required<RetryConfig>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,WAAW,CAKtD,CAAC;AAUF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA4BtD;AAED,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC7B,GAAG,CAAC,EAAE,OAAO,GACX,MAAM,CAgBR;AAED,wBAAgB,kBAAkB,CACjC,YAAY,EAAE,WAAW,GAAG,SAAS,EACrC,eAAe,EAAE,WAAW,GAAG,SAAS,GACtC,QAAQ,CAAC,WAAW,CAAC,CA8CvB"}

package/dist/retry.js

@@ -0,0 +1,101 @@
+import { RoverError } from "./RoverError.js";
+export const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 3,
+    baseDelayMs: 500,
+    factor: 2,
+    maxDelayMs: 10_000,
+};
+const RETRYABLE_ERRNO = new Set([
+    "ETIMEDOUT",
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "ENOTFOUND",
+    "EAI_AGAIN",
+]);
+/**
+ * A failure is retryable when:
+ *   - it's a `MAIL_PROVIDER_ERROR` with `upstreamStatus` 429 or ≥ 500
+ *   - or it's a `MAIL_PROVIDER_ERROR` whose `context.networkCode` is a known
+ *     retryable Node errno (SDK wrappers surface the original errno this way
+ *     when the HTTP layer never produced a status)
+ *   - or it's a raw Error with a matching Node networking errno on `.code`
+ * 4xx (non-429) is treated as permanent: retrying won't help.
+ */
+export function isRetryableError(err) {
+    if (err instanceof RoverError && err.code === "MAIL_PROVIDER_ERROR") {
+        const statusStr = err.context.upstreamStatus;
+        const status = Number(statusStr);
+        if (Number.isFinite(status)) {
+            if (status === 429)
+                return true;
+            if (status >= 500 && status < 600)
+                return true;
+        }
+        const networkCode = err.context.networkCode;
+        if (networkCode && RETRYABLE_ERRNO.has(networkCode))
+            return true;
+        return false;
+    }
+    if (err instanceof Error) {
+        const code = err.code;
+        if (typeof code === "string" && RETRYABLE_ERRNO.has(code))
+            return true;
+        // Node 18+ `fetch` (undici) wraps the underlying socket error in
+        // `cause` and surfaces `TypeError: fetch failed` at the top level —
+        // the original errno is on `err.cause.code`, not `err.code`. Without
+        // this branch transient ECONNRESET/ENOTFOUND/etc. from raw fetch
+        // look indistinguishable from a permanent failure and never retry.
+        const cause = err.cause;
+        if (cause && typeof cause === "object") {
+            const causeCode = cause.code;
+            if (typeof causeCode === "string" && RETRYABLE_ERRNO.has(causeCode))
+                return true;
+        }
+    }
+    return false;
+}
+export function computeBackoffMs(attempt, config, err) {
+    // Honour the provider's Retry-After hint when present (Mailgun/SendGrid/
+    // SES/Resend transports capture it into `context.retryAfter`). Value is
+    // seconds per HTTP RFC 7231 §7.1.3; we cap at `maxDelayMs` so a malicious
+    // or mistaken provider can't force a very-long wait.
+    if (err instanceof RoverError && err.code === "MAIL_PROVIDER_ERROR") {
+        const hint = err.context.retryAfter;
+        if (hint) {
+            const seconds = Number(hint);
+            if (Number.isFinite(seconds) && seconds >= 0) {
+                return Math.min(config.maxDelayMs, Math.max(50, seconds * 1000));
+            }
+        }
+    }
+    const raw = config.baseDelayMs * config.factor ** (attempt - 1);
+    return Math.min(config.maxDelayMs, Math.max(50, raw));
+}
+export function resolveRetryConfig(globalConfig, transportConfig) {
+    // Skip entries whose value is `undefined` so a partial override doesn't
+    // clobber a default or global value. Pre-spread filter is required because
+    // `{ ...obj }` propagates explicit-undefined keys.
+    const strip = (x) => x
+        ? Object.fromEntries(Object.entries(x).filter(([, v]) => v !== undefined))
+        : {};
+    const merged = {
+        ...DEFAULT_RETRY_CONFIG,
+        ...strip(globalConfig),
+        ...strip(transportConfig),
+    };
+    if (!Number.isInteger(merged.maxAttempts) || merged.maxAttempts < 1) {
+        throw new RoverError("MAIL_RETRY_CONFIG", `RetryConfig.maxAttempts must be an integer >= 1 (got ${merged.maxAttempts})`, { hint: "Set retry.maxAttempts to a positive integer." });
+    }
+    if (typeof merged.baseDelayMs !== "number" ||
+        !Number.isFinite(merged.baseDelayMs) ||
+        merged.baseDelayMs < 0) {
+        throw new RoverError("MAIL_RETRY_CONFIG", `RetryConfig.baseDelayMs must be a non-negative finite number (got ${merged.baseDelayMs})`, { hint: "Use 0 or a positive number; the 50 ms floor kicks in anyway." });
+    }
+    if (typeof merged.factor !== "number" ||
+        !Number.isFinite(merged.factor) ||
+        merged.factor <= 0) {
+        throw new RoverError("MAIL_RETRY_CONFIG", `RetryConfig.factor must be a positive finite number (got ${merged.factor})`, { hint: "Use >= 1 for exponential growth; 1 means constant delay." });
+    }
+    return merged;
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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

package/dist/services/main.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Default `Mail` singleton — mirror of Adonis's
+ * `import mail from '@adonisjs/mail/services/main'` shape.
+ *
+ * The instance is populated by `RoverProvider.boot()` once the
+ * container has resolved the `Mail` binding. Callers can `import mail`
+ * before boot — the proxy delays method access until `setMail` runs.
+ *
+ *   import mail from '@c9up/rover/services/main'
+ *
+ *   await mail.send((m) => m.to(user.email).subject('Hi').text('Hello'))
+ */
+import type { Mail } from "../Mail.js";
+/** @internal Set the resolved singleton (called by RoverProvider.boot). */
+export declare function setMail(mail: Mail): void;
+/** @internal Get the resolved singleton (or `undefined` pre-boot). */
+export declare function getMail(): Mail | undefined;
+declare const mail: Mail;
+export default mail;
+//# sourceMappingURL=main.d.ts.map

package/dist/services/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAExC;AAED,sEAAsE;AACtE,wBAAgB,OAAO,IAAI,IAAI,GAAG,SAAS,CAE1C;AAED,QAAA,MAAM,IAAI,EAAE,IAWV,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/services/main.js

@@ -0,0 +1,33 @@
+/**
+ * Default `Mail` singleton — mirror of Adonis's
+ * `import mail from '@adonisjs/mail/services/main'` shape.
+ *
+ * The instance is populated by `RoverProvider.boot()` once the
+ * container has resolved the `Mail` binding. Callers can `import mail`
+ * before boot — the proxy delays method access until `setMail` runs.
+ *
+ *   import mail from '@c9up/rover/services/main'
+ *
+ *   await mail.send((m) => m.to(user.email).subject('Hi').text('Hello'))
+ */
+let instance;
+/** @internal Set the resolved singleton (called by RoverProvider.boot). */
+export function setMail(mail) {
+    instance = mail;
+}
+/** @internal Get the resolved singleton (or `undefined` pre-boot). */
+export function getMail() {
+    return instance;
+}
+const mail = new Proxy({}, {
+    get(_target, prop) {
+        if (!instance) {
+            throw new Error("[rover] Mail singleton accessed before RoverProvider.boot() ran. " +
+                "Check that `@c9up/rover/provider` is listed in your reamrc.ts providers.");
+        }
+        const value = Reflect.get(instance, prop, instance);
+        return typeof value === "function" ? value.bind(instance) : value;
+    },
+});
+export default mail;
+//# sourceMappingURL=main.js.map

package/dist/services/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,IAAI,QAA0B,CAAC;AAE/B,2EAA2E;AAC3E,MAAM,UAAU,OAAO,CAAC,IAAU;IACjC,QAAQ,GAAG,IAAI,CAAC;AACjB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,OAAO;IACtB,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,MAAM,IAAI,GAAS,IAAI,KAAK,CAAC,EAAU,EAAE;IACxC,GAAG,CAAC,OAAO,EAAE,IAAI;QAChB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,mEAAmE;gBAClE,0EAA0E,CAC3E,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/templating/SimpleTemplate.d.ts

@@ -0,0 +1,7 @@
+export declare function setViewsRoot(rootDir: string): void;
+export declare function getViewsRoot(): string;
+/** Reset cached compiled templates (test helper). */
+export declare function resetCache(): void;
+export declare function render(source: string, data: Record<string, unknown>): Promise<string>;
+export declare function renderFile(viewPath: string, data: Record<string, unknown>, _visited?: Set<string>): Promise<string>;
+//# sourceMappingURL=SimpleTemplate.d.ts.map

package/dist/templating/SimpleTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleTemplate.d.ts","sourceRoot":"","sources":["../../src/templating/SimpleTemplate.ts"],"names":[],"mappings":"AAoBA,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,qDAAqD;AACrD,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,wBAAsB,MAAM,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,wBAAsB,UAAU,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,OAAO,CAAC,MAAM,CAAC,CAIjB"}