@basedest/mailer 0.0.0-development

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Configuration for the mailer. Provided by the host application.
+ */
+export interface MailerConfig {
+    provider: 'log' | 'resend';
+    from: string;
+    resendApiKey?: string;
+    retryEnabled?: boolean;
+    rateLimitPerMinute?: number;
+}
+//# 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;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":""}

package/dist/factory.d.ts

@@ -0,0 +1,8 @@
+import type { Mailer } from './index';
+import type { MailerConfig } from './config';
+import type { MailerLogger } from './logger';
+export interface CreateMailerOptions {
+    logger?: MailerLogger;
+}
+export declare function createMailer(config: MailerConfig, options?: CreateMailerOptions): Mailer;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAM7C,MAAM,WAAW,mBAAmB;IAChC,MAAM,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAwCxF"}

package/dist/factory.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMailer = createMailer;
+const log_1 = require("./log");
+const resend_1 = require("./resend");
+const with_rate_limit_1 = require("./with-rate-limit");
+const with_retry_1 = require("./with-retry");
+function createMailer(config, options) {
+    const logger = options?.logger;
+    let mailer;
+    switch (config.provider) {
+        case 'resend':
+            mailer = new resend_1.ResendMailer({
+                apiKey: config.resendApiKey,
+                from: config.from,
+            });
+            break;
+        case 'log':
+        default:
+            mailer = new log_1.LogMailer({ logger });
+            break;
+    }
+    if (config.retryEnabled) {
+        mailer = (0, with_retry_1.withRetry)(mailer, {
+            maxAttempts: 3,
+            delayMs: 1000,
+            onDeadLetter(params, error) {
+                logger?.log({
+                    level: 'error',
+                    message: 'Mail dead letter',
+                    extra: {
+                        to: params.to,
+                        subject: params.subject,
+                        error: error.message,
+                    },
+                });
+            },
+        });
+    }
+    if (config.rateLimitPerMinute != null && config.rateLimitPerMinute > 0) {
+        mailer = (0, with_rate_limit_1.withRateLimit)(mailer, { maxPerMinute: config.rateLimitPerMinute });
+    }
+    return mailer;
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":";;AAYA,oCAwCC;AAjDD,+BAAkC;AAClC,qCAAwC;AACxC,uDAAkD;AAClD,6CAAyC;AAMzC,SAAgB,YAAY,CAAC,MAAoB,EAAE,OAA6B;IAC5E,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAC/B,IAAI,MAAc,CAAC;IAEnB,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,QAAQ;YACT,MAAM,GAAG,IAAI,qBAAY,CAAC;gBACtB,MAAM,EAAE,MAAM,CAAC,YAAa;gBAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;aACpB,CAAC,CAAC;YACH,MAAM;QACV,KAAK,KAAK,CAAC;QACX;YACI,MAAM,GAAG,IAAI,eAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YACnC,MAAM;IACd,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACtB,MAAM,GAAG,IAAA,sBAAS,EAAC,MAAM,EAAE;YACvB,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,IAAI;YACb,YAAY,CAAC,MAAM,EAAE,KAAK;gBACtB,MAAM,EAAE,GAAG,CAAC;oBACR,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,kBAAkB;oBAC3B,KAAK,EAAE;wBACH,EAAE,EAAE,MAAM,CAAC,EAAE;wBACb,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,KAAK,EAAE,KAAK,CAAC,OAAO;qBACvB;iBACJ,CAAC,CAAC;YACP,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IAED,IAAI,MAAM,CAAC,kBAAkB,IAAI,IAAI,IAAI,MAAM,CAAC,kBAAkB,GAAG,CAAC,EAAE,CAAC;QACrE,MAAM,GAAG,IAAA,+BAAa,EAAC,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from 'react';
+export interface SendParams {
+    to: string | string[];
+    subject: string;
+    /** HTML string or React node (e.g. React Email template). */
+    body: string | ReactNode;
+    /** Optional locale for future i18n; no translation in this layer. */
+    locale?: string;
+    from?: string;
+    replyTo?: string;
+    /** Optional idempotency key for retry/dedup. */
+    idempotencyKey?: string;
+}
+export type SendResult = {
+    success: true;
+    id?: string;
+} | {
+    success: false;
+    error: Error;
+};
+export interface Mailer {
+    send(params: SendParams): Promise<SendResult>;
+}
+export * from './config';
+export * from './factory';
+export * from './logger';
+//# 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,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,UAAU,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAE3F,MAAM,WAAW,MAAM;IACnB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACjD;AAED,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config"), exports);
+__exportStar(require("./factory"), exports);
+__exportStar(require("./logger"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAqBA,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB"}

package/dist/log.d.ts

@@ -0,0 +1,11 @@
+import type { Mailer, SendParams, SendResult } from './index';
+import type { MailerLogger } from './logger';
+export interface LogMailerOptions {
+    logger?: MailerLogger;
+}
+export declare class LogMailer implements Mailer {
+    private logger;
+    constructor(options?: LogMailerOptions);
+    send(params: SendParams): Promise<SendResult>;
+}
+//# sourceMappingURL=log.d.ts.map

package/dist/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAe7C,MAAM,WAAW,gBAAgB;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,qBAAa,SAAU,YAAW,MAAM;IACpC,OAAO,CAAC,MAAM,CAAe;gBAEjB,OAAO,CAAC,EAAE,gBAAgB;IAIhC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAatD"}

package/dist/log.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogMailer = void 0;
+const BODY_PREVIEW_MAX_LEN = 200;
+function bodyPreview(body) {
+    if (typeof body === 'string') {
+        return body.length <= BODY_PREVIEW_MAX_LEN ? body : `${body.slice(0, BODY_PREVIEW_MAX_LEN)}...`;
+    }
+    return '[React template]';
+}
+const noopLogger = {
+    log: () => { },
+};
+class LogMailer {
+    constructor(options) {
+        this.logger = options?.logger ?? noopLogger;
+    }
+    async send(params) {
+        const to = Array.isArray(params.to) ? params.to : [params.to];
+        this.logger.log({
+            message: 'Mail (log provider)',
+            extra: {
+                to,
+                subject: params.subject,
+                bodyPreview: bodyPreview(params.body),
+                locale: params.locale,
+            },
+        });
+        return { success: true };
+    }
+}
+exports.LogMailer = LogMailer;
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":";;;AAGA,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,SAAS,WAAW,CAAC,IAAwB;IACzC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,KAAK,CAAC;IACpG,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,GAAiB;IAC7B,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC;AAMF,MAAa,SAAS;IAGlB,YAAY,OAA0B;QAClC,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,UAAU,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAkB;QACzB,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;YACZ,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE;gBACH,EAAE;gBACF,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;gBACrC,MAAM,EAAE,MAAM,CAAC,MAAM;aACxB;SACJ,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;CACJ;AApBD,8BAoBC"}

package/dist/logger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Minimal logger interface for mailer. The host application provides
+ */
+export interface MailerLogger {
+    log(opts: {
+        level?: 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+        message: string;
+        extra?: Record<string, unknown>;
+    }): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,GAAG,CAAC,IAAI,EAAE;QACN,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;QACtD,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,IAAI,CAAC;CACZ"}

package/dist/logger.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":""}

package/dist/resend.d.ts

@@ -0,0 +1,12 @@
+import type { Mailer, SendParams, SendResult } from './index';
+export interface ResendMailerOptions {
+    apiKey: string;
+    from: string;
+}
+export declare class ResendMailer implements Mailer {
+    private client;
+    private defaultFrom;
+    constructor(options: ResendMailerOptions);
+    send(params: SendParams): Promise<SendResult>;
+}
+//# sourceMappingURL=resend.d.ts.map

package/dist/resend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend.d.ts","sourceRoot":"","sources":["../src/resend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAa,YAAW,MAAM;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,mBAAmB;IAKlC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CA6BtD"}

package/dist/resend.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResendMailer = void 0;
+const resend_1 = require("resend");
+class ResendMailer {
+    constructor(options) {
+        this.client = new resend_1.Resend(options.apiKey);
+        this.defaultFrom = options.from;
+    }
+    async send(params) {
+        const to = Array.isArray(params.to) ? params.to : [params.to];
+        const from = params.from ?? this.defaultFrom;
+        const payload = typeof params.body === 'string' ? { html: params.body } : { react: params.body };
+        const { data, error } = await this.client.emails.send({
+            from,
+            to,
+            subject: params.subject,
+            replyTo: params.replyTo,
+            ...payload,
+        }, params.idempotencyKey ? { idempotencyKey: params.idempotencyKey } : undefined);
+        if (error) {
+            const err = error instanceof Error
+                ? error
+                : new Error(typeof error.message === 'string'
+                    ? error.message
+                    : String(error));
+            return { success: false, error: err };
+        }
+        return { success: true, id: data?.id ?? undefined };
+    }
+}
+exports.ResendMailer = ResendMailer;
+//# sourceMappingURL=resend.js.map

package/dist/resend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend.js","sourceRoot":"","sources":["../src/resend.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAQhC,MAAa,YAAY;IAIrB,YAAY,OAA4B;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,eAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAkB;QACzB,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC;QAC7C,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAEjG,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CACjD;YACI,IAAI;YACJ,EAAE;YACF,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,OAAO;SACb,EACD,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAChF,CAAC;QAEF,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,GAAG,GACL,KAAK,YAAY,KAAK;gBAClB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,IAAI,KAAK,CACL,OAAQ,KAA8B,CAAC,OAAO,KAAK,QAAQ;oBACvD,CAAC,CAAE,KAA6B,CAAC,OAAO;oBACxC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACtB,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,SAAS,EAAE,CAAC;IACxD,CAAC;CACJ;AAtCD,oCAsCC"}

package/dist/with-rate-limit.d.ts

@@ -0,0 +1,11 @@
+import type { Mailer } from './index';
+export interface RateLimitOptions {
+    /** Max number of sends per minute. When exceeded, send() returns failure. */
+    maxPerMinute: number;
+}
+/**
+ * In-memory sliding-window rate limiter. When over limit, returns
+ * { success: false, error: Error('Rate limit exceeded') } without calling the inner mailer.
+ */
+export declare function withRateLimit(mailer: Mailer, options: RateLimitOptions): Mailer;
+//# sourceMappingURL=with-rate-limit.d.ts.map

package/dist/with-rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-rate-limit.d.ts","sourceRoot":"","sources":["../src/with-rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA0B,MAAM,SAAS,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC7B,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAyB/E"}

package/dist/with-rate-limit.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRateLimit = withRateLimit;
+/**
+ * In-memory sliding-window rate limiter. When over limit, returns
+ * { success: false, error: Error('Rate limit exceeded') } without calling the inner mailer.
+ */
+function withRateLimit(mailer, options) {
+    const { maxPerMinute } = options;
+    const timestamps = [];
+    function pruneOlderThanOneMinute(now) {
+        const cutoff = now - 60000;
+        while (timestamps.length > 0 && timestamps[0] < cutoff) {
+            timestamps.shift();
+        }
+    }
+    return {
+        async send(params) {
+            const now = Date.now();
+            pruneOlderThanOneMinute(now);
+            if (timestamps.length >= maxPerMinute) {
+                return {
+                    success: false,
+                    error: new Error('Mailer rate limit exceeded'),
+                };
+            }
+            timestamps.push(now);
+            return mailer.send(params);
+        },
+    };
+}
+//# sourceMappingURL=with-rate-limit.js.map

package/dist/with-rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-rate-limit.js","sourceRoot":"","sources":["../src/with-rate-limit.ts"],"names":[],"mappings":";;AAWA,sCAyBC;AA7BD;;;GAGG;AACH,SAAgB,aAAa,CAAC,MAAc,EAAE,OAAyB;IACnE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACjC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,SAAS,uBAAuB,CAAC,GAAW;QACxC,MAAM,MAAM,GAAG,GAAG,GAAG,KAAM,CAAC;QAC5B,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,CAAC,CAAE,GAAG,MAAM,EAAE,CAAC;YACtD,UAAU,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACL,CAAC;IAED,OAAO;QACH,KAAK,CAAC,IAAI,CAAC,MAAkB;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,uBAAuB,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,UAAU,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;gBACpC,OAAO;oBACH,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,IAAI,KAAK,CAAC,4BAA4B,CAAC;iBACjD,CAAC;YACN,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/with-retry.d.ts

@@ -0,0 +1,11 @@
+import type { Mailer, SendParams } from './index';
+export interface RetryOptions {
+    /** Max send attempts including the first. Default 3. */
+    maxAttempts?: number;
+    /** Delay in ms before each retry. Default 1000. */
+    delayMs?: number;
+    /** Called after final failure; no persistence in this layer. */
+    onDeadLetter?(params: SendParams, error: Error): void | Promise<void>;
+}
+export declare function withRetry(mailer: Mailer, options?: RetryOptions): Mailer;
+//# sourceMappingURL=with-retry.d.ts.map

package/dist/with-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-retry.d.ts","sourceRoot":"","sources":["../src/with-retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAc,MAAM,SAAS,CAAC;AAE9D,MAAM,WAAW,YAAY;IACzB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,YAAY,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAMD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAoBxE"}

package/dist/with-retry.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRetry = withRetry;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function withRetry(mailer, options) {
+    const maxAttempts = options?.maxAttempts ?? 3;
+    const delayMs = options?.delayMs ?? 1000;
+    const onDeadLetter = options?.onDeadLetter;
+    return {
+        async send(params) {
+            let lastResult = null;
+            for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+                lastResult = await mailer.send(params);
+                if (lastResult.success)
+                    return lastResult;
+                if (attempt < maxAttempts)
+                    await sleep(delayMs);
+            }
+            const result = lastResult;
+            if (onDeadLetter) {
+                await Promise.resolve(onDeadLetter(params, result.error));
+            }
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=with-retry.js.map

package/dist/with-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-retry.js","sourceRoot":"","sources":["../src/with-retry.ts"],"names":[],"mappings":";;AAeA,8BAoBC;AAxBD,SAAS,KAAK,CAAC,EAAU;IACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,SAAgB,SAAS,CAAC,MAAc,EAAE,OAAsB;IAC5D,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;IACzC,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAE3C,OAAO;QACH,KAAK,CAAC,IAAI,CAAC,MAAkB;YACzB,IAAI,UAAU,GAAsB,IAAI,CAAC;YACzC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;gBACtD,UAAU,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACvC,IAAI,UAAU,CAAC,OAAO;oBAAE,OAAO,UAAU,CAAC;gBAC1C,IAAI,OAAO,GAAG,WAAW;oBAAE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,MAAM,GAAG,UAA+C,CAAC;YAC/D,IAAI,YAAY,EAAE,CAAC;gBACf,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/package.json

@@ -0,0 +1,82 @@
+{
+    "name": "@basedest/mailer",
+    "version": "0.0.0-development",
+    "description": "Mailer abstraction with Resend, retry, and rate-limiting support",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/basedest/mailer.git"
+    },
+    "scripts": {
+        "build": "tsc",
+        "type-check": "tsc --noEmit",
+        "lint": "eslint .",
+        "lint:fix": "eslint . --fix",
+        "prepare": "husky",
+        "semantic-release": "semantic-release"
+    },
+    "lint-staged": {
+        "*.{json,md}": [
+            "prettier --write"
+        ],
+        "*.ts": [
+            "eslint --fix"
+        ]
+    },
+    "keywords": [],
+    "author": "basedest <basedest@icloud.com>",
+    "license": "ISC",
+    "packageManager": "pnpm@10.28.2",
+    "pnpm": {
+        "overrides": {
+            "minimatch": ">=10.2.1"
+        }
+    },
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "dependencies": {
+        "resend": "^6.9.1"
+    },
+    "peerDependencies": {
+        "react": ">=18.0.0"
+    },
+    "peerDependenciesMeta": {
+        "react": {
+            "optional": true
+        }
+    },
+    "devDependencies": {
+        "@commitlint/cli": "^20.4.0",
+        "@commitlint/config-conventional": "^20.4.0",
+        "@semantic-release/commit-analyzer": "^13.0.1",
+        "@semantic-release/git": "^10.0.1",
+        "@semantic-release/github": "^12.0.3",
+        "@semantic-release/npm": "^12.0.1",
+        "@semantic-release/release-notes-generator": "^14.1.0",
+        "@eslint/js": "^9.39.2",
+        "@types/node": "^22.0.0",
+        "@types/react": "^19.0.0",
+        "@typescript-eslint/eslint-plugin": "^8.54.0",
+        "@typescript-eslint/parser": "^8.54.0",
+        "eslint": "^9.39.2",
+        "eslint-config-prettier": "^10.1.8",
+        "eslint-plugin-prettier": "^5.5.0",
+        "husky": "^9.0.0",
+        "lint-staged": "^16.2.7",
+        "prettier": "^3.8.1",
+        "semantic-release": "^25.0.3",
+        "typescript": "^5.9.3"
+    }
+}