@bernierllc/email-sender 5.2.0 → 5.3.0

package/dist/index.d.ts

@@ -11,11 +11,16 @@ export { SmtpProvider } from './providers/smtp';
 export { SendGridProvider } from './providers/sendgrid';
 export { SesProvider } from './providers/ses';
 export { MailgunProvider } from './providers/mailgun';
+export { MailgunSenderManager, MailgunSenderError } from './providers/mailgun/sender-manager';
 export { PostmarkProvider } from './providers/postmark';
+export { PostmarkSenderManager } from './providers/postmark/sender-manager';
+export type { PostmarkSenderSignature, PostmarkSenderSignatureListResponse, PostmarkSenderManagerLogger, } from './providers/postmark/sender-manager';
 export { MandrillProvider } from './providers/mandrill';
 export { Smtp2goProvider } from './providers/smtp2go';
 export { EmailSenderError, EmailSenderErrorCode, EmailValidationError, ProviderError, RateLimitError, NetworkError, TimeoutError, } from './errors';
 export type { EmailSenderErrorOptions, EmailSenderErrorCodeType, } from './errors';
+export { SesSenderManager } from './providers/ses/sender-manager';
+export type { SesSenderManagerLogger, SesClientShape } from './providers/ses/sender-manager';
 export type { VerifiedSender, SenderValidationResult, Template, ProviderTemplate, TemplateVersion, SyncResult, TemplateAnalytics, SendGridAdvancedConfig } from './providers/sendgrid/types';
 export { SendGridApiError, TemplateNotFoundError, UnauthorizedTemplateAccessError, TemplateConflictError, SendGridRateLimitError, SendGridErrorCode, } from './providers/sendgrid/errors';
 export type { SendGridErrorCodeType } from './providers/sendgrid/errors';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AAMxB,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGvE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAMtD,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AAMxB,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGvE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,YAAY,EACV,uBAAuB,EACvB,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAMtD,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAG7F,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -21,7 +21,7 @@ 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 });
-exports.SendGridErrorCode = exports.SendGridRateLimitError = exports.TemplateConflictError = exports.UnauthorizedTemplateAccessError = exports.TemplateNotFoundError = exports.SendGridApiError = exports.TimeoutError = exports.NetworkError = exports.RateLimitError = exports.ProviderError = exports.EmailValidationError = exports.EmailSenderErrorCode = exports.EmailSenderError = exports.Smtp2goProvider = exports.MandrillProvider = exports.PostmarkProvider = exports.MailgunProvider = exports.SesProvider = exports.SendGridProvider = exports.SmtpProvider = exports.EmailProvider = exports.EmailSafetyManager = exports.EmailSender = exports.degradationInfoSchema = exports.capabilityEntrySchema = void 0;
+exports.SendGridErrorCode = exports.SendGridRateLimitError = exports.TemplateConflictError = exports.UnauthorizedTemplateAccessError = exports.TemplateNotFoundError = exports.SendGridApiError = exports.SesSenderManager = exports.TimeoutError = exports.NetworkError = exports.RateLimitError = exports.ProviderError = exports.EmailValidationError = exports.EmailSenderErrorCode = exports.EmailSenderError = exports.Smtp2goProvider = exports.MandrillProvider = exports.PostmarkSenderManager = exports.PostmarkProvider = exports.MailgunSenderError = exports.MailgunSenderManager = exports.MailgunProvider = exports.SesProvider = exports.SendGridProvider = exports.SmtpProvider = exports.EmailProvider = exports.EmailSafetyManager = exports.EmailSender = exports.degradationInfoSchema = exports.capabilityEntrySchema = void 0;
 /**
  * Email Sender - Core Library
  * Main entry point for the email sending system
@@ -51,8 +51,13 @@ var ses_1 = require("./providers/ses");
 Object.defineProperty(exports, "SesProvider", { enumerable: true, get: function () { return ses_1.SesProvider; } });
 var mailgun_1 = require("./providers/mailgun");
 Object.defineProperty(exports, "MailgunProvider", { enumerable: true, get: function () { return mailgun_1.MailgunProvider; } });
+var sender_manager_1 = require("./providers/mailgun/sender-manager");
+Object.defineProperty(exports, "MailgunSenderManager", { enumerable: true, get: function () { return sender_manager_1.MailgunSenderManager; } });
+Object.defineProperty(exports, "MailgunSenderError", { enumerable: true, get: function () { return sender_manager_1.MailgunSenderError; } });
 var postmark_1 = require("./providers/postmark");
 Object.defineProperty(exports, "PostmarkProvider", { enumerable: true, get: function () { return postmark_1.PostmarkProvider; } });
+var sender_manager_2 = require("./providers/postmark/sender-manager");
+Object.defineProperty(exports, "PostmarkSenderManager", { enumerable: true, get: function () { return sender_manager_2.PostmarkSenderManager; } });
 var mandrill_1 = require("./providers/mandrill");
 Object.defineProperty(exports, "MandrillProvider", { enumerable: true, get: function () { return mandrill_1.MandrillProvider; } });
 var smtp2go_1 = require("./providers/smtp2go");
@@ -68,6 +73,9 @@ Object.defineProperty(exports, "ProviderError", { enumerable: true, get: functio
 Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_1.RateLimitError; } });
 Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_1.NetworkError; } });
 Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
+// SES sender management (sender identity lifecycle)
+var sender_manager_3 = require("./providers/ses/sender-manager");
+Object.defineProperty(exports, "SesSenderManager", { enumerable: true, get: function () { return sender_manager_3.SesSenderManager; } });
 // SendGrid-specific errors
 var errors_2 = require("./providers/sendgrid/errors");
 Object.defineProperty(exports, "SendGridApiError", { enumerable: true, get: function () { return errors_2.SendGridApiError; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;;;;;;;;;;;;;;;AAEF;;;GAGG;AAEH,aAAa;AACb,0CAAwB;AAExB,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,8DAA8D;AAC9D,iCAAuE;AAA9D,8GAAA,qBAAqB,OAAA;AAAE,8GAAA,qBAAqB,OAAA;AAErD,eAAe;AACf,oDAAqE;AAA5D,2GAAA,WAAW,OAAA;AACpB,oEAAiE;AAAxD,0HAAA,kBAAkB,OAAA;AAE3B,mBAAmB;AACnB,yCAAiD;AAAxC,qGAAA,aAAa,OAAA;AACtB,yCAAgD;AAAvC,oGAAA,YAAY,OAAA;AACrB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AACzB,uCAA8C;AAArC,kGAAA,WAAW,OAAA;AACpB,+CAAsD;AAA7C,0GAAA,eAAe,OAAA;AACxB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AACzB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AACzB,+CAAsD;AAA7C,0GAAA,eAAe,OAAA;AAExB,oFAAoF;AACpF,yGAAyG;AAEzG,gEAAgE;AAChE,mCAQkB;AAPhB,0GAAA,gBAAgB,OAAA;AAChB,8GAAA,oBAAoB,OAAA;AACpB,8GAAA,oBAAoB,OAAA;AACpB,uGAAA,aAAa,OAAA;AACb,wGAAA,cAAc,OAAA;AACd,sGAAA,YAAY,OAAA;AACZ,sGAAA,YAAY,OAAA;AAmBd,2BAA2B;AAC3B,sDAOqC;AANnC,0GAAA,gBAAgB,OAAA;AAChB,+GAAA,qBAAqB,OAAA;AACrB,yHAAA,+BAA+B,OAAA;AAC/B,+GAAA,qBAAqB,OAAA;AACrB,gHAAA,sBAAsB,OAAA;AACtB,2GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;;;;;;;;;;;;;;;AAEF;;;GAGG;AAEH,aAAa;AACb,0CAAwB;AAExB,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,8DAA8D;AAC9D,iCAAuE;AAA9D,8GAAA,qBAAqB,OAAA;AAAE,8GAAA,qBAAqB,OAAA;AAErD,eAAe;AACf,oDAAqE;AAA5D,2GAAA,WAAW,OAAA;AACpB,oEAAiE;AAAxD,0HAAA,kBAAkB,OAAA;AAE3B,mBAAmB;AACnB,yCAAiD;AAAxC,qGAAA,aAAa,OAAA;AACtB,yCAAgD;AAAvC,oGAAA,YAAY,OAAA;AACrB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AACzB,uCAA8C;AAArC,kGAAA,WAAW,OAAA;AACpB,+CAAsD;AAA7C,0GAAA,eAAe,OAAA;AACxB,qEAA8F;AAArF,sHAAA,oBAAoB,OAAA;AAAE,oHAAA,kBAAkB,OAAA;AACjD,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AACzB,sEAA4E;AAAnE,uHAAA,qBAAqB,OAAA;AAM9B,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AACzB,+CAAsD;AAA7C,0GAAA,eAAe,OAAA;AAExB,oFAAoF;AACpF,yGAAyG;AAEzG,gEAAgE;AAChE,mCAQkB;AAPhB,0GAAA,gBAAgB,OAAA;AAChB,8GAAA,oBAAoB,OAAA;AACpB,8GAAA,oBAAoB,OAAA;AACpB,uGAAA,aAAa,OAAA;AACb,wGAAA,cAAc,OAAA;AACd,sGAAA,YAAY,OAAA;AACZ,sGAAA,YAAY,OAAA;AAOd,oDAAoD;AACpD,iEAAkE;AAAzD,kHAAA,gBAAgB,OAAA;AAezB,2BAA2B;AAC3B,sDAOqC;AANnC,0GAAA,gBAAgB,OAAA;AAChB,+GAAA,qBAAqB,OAAA;AACrB,yHAAA,+BAA+B,OAAA;AAC/B,+GAAA,qBAAqB,OAAA;AACrB,gHAAA,sBAAsB,OAAA;AACtB,2GAAA,iBAAiB,OAAA"}

package/dist/providers/mailgun/sender-manager.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Mailgun Sender Manager
+ * Manages sender identity (domain) lifecycle via the Mailgun API.
+ *
+ * Mailgun manages senders at the domain level. Creating a "sender" means
+ * registering a domain; verification is DNS-based.
+ */
+import type { ProviderCreateSenderInput, ProviderUpdateSenderInput, ProviderSenderResult, ProviderDeleteResult, ProviderVerificationResult, ProviderVerificationType, ProviderValidationResult, ProviderSender, SyncResult, SenderConfiguration, DNSRecord } from '@bernierllc/email-sender-manager';
+export declare class MailgunSenderError extends Error {
+    readonly cause: Error | undefined;
+    constructor(message: string, options?: {
+        cause?: Error;
+    });
+}
+interface SenderManagerLogger {
+    info: (message: string) => void;
+    debug: (message: string) => void;
+    error: (message: string) => void;
+}
+export declare class MailgunSenderManager {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly logger;
+    constructor(apiKey: string, baseUrl: string, logger?: SenderManagerLogger);
+    private getAuthHeader;
+    private extractDomain;
+    private mapMailgunState;
+    private mapStatusToErrorCode;
+    private mapDnsRecordType;
+    /**
+     * Create a sender by registering a domain in Mailgun.
+     * The providerSenderId is the domain name itself.
+     */
+    createSender(input: ProviderCreateSenderInput): Promise<ProviderSenderResult>;
+    /**
+     * Update a domain in Mailgun.
+     * Only DKIM key size and web scheme are supported via providerFields.
+     * Standard fields (fromName, replyToEmail, replyToName) return UNSUPPORTED_FIELD
+     * because Mailgun manages senders at the domain level, not individual identity.
+     */
+    updateSender(input: ProviderUpdateSenderInput): Promise<ProviderSenderResult>;
+    /**
+     * Delete a domain from Mailgun.
+     */
+    deleteSender(providerSenderId: string): Promise<ProviderDeleteResult>;
+    /**
+     * Mailgun uses domain-based verification.
+     */
+    getVerificationType(): ProviderVerificationType;
+    /**
+     * Initiate domain verification by triggering Mailgun's verify endpoint.
+     */
+    initiateVerification(providerSenderId: string): Promise<ProviderVerificationResult>;
+    /**
+     * Check the verification status of a domain by fetching domain info.
+     */
+    checkVerificationStatus(providerSenderId: string): Promise<ProviderVerificationResult>;
+    /**
+     * Get DNS requirements for a domain.
+     * Fetches domain info and extracts sending_dns_records and receiving_dns_records.
+     */
+    getDnsRequirements(providerSenderId: string): Promise<DNSRecord[]>;
+    /**
+     * Get all verified (active) senders (domains) from Mailgun.
+     */
+    getVerifiedSenders(): Promise<ProviderSender[]>;
+    /**
+     * Validate a sender email by checking if its domain is verified in Mailgun.
+     */
+    validateSender(email: string): Promise<ProviderValidationResult>;
+    /**
+     * Sync a sender configuration with Mailgun by checking if the domain exists.
+     */
+    syncSender(sender: SenderConfiguration): Promise<SyncResult>;
+    /**
+     * Return the capabilities of the Mailgun sender manager.
+     */
+    getCapabilities(): string[];
+    /**
+     * Map Mailgun domain response DNS records to our DNSRecord[] type.
+     */
+    private mapDnsRecords;
+}
+export {};
+//# sourceMappingURL=sender-manager.d.ts.map

package/dist/providers/mailgun/sender-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-manager.d.ts","sourceRoot":"","sources":["../../../src/providers/mailgun/sender-manager.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAE1B,wBAAwB,EAExB,wBAAwB,EACxB,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,SAAS,EAEV,MAAM,kCAAkC,CAAC;AAM1C,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAMzD;AAsCD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAMD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;gBAE7C,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB;IAUzE,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,gBAAgB;IAiBxB;;;OAGG;IACG,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmFnF;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAuFnF;;OAEG;IACG,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsC3E;;OAEG;IACH,mBAAmB,IAAI,wBAAwB;IAI/C;;OAEG;IACG,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IA2CzF;;OAEG;IACG,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAgD5F;;;OAGG;IACG,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA6BxE;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAoCrD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAqEtE;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAiDlE;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAQ3B;;OAEG;IACH,OAAO,CAAC,aAAa;CA8BtB"}