@bernierllc/email-sender 5.2.1 → 5.3.0

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

@@ -0,0 +1,48 @@
+/**
+ * AWS SES Sender Manager
+ *
+ * Manages sender identity lifecycle via the SES v2 API:
+ *   - CreateEmailIdentity / DeleteEmailIdentity
+ *   - GetEmailIdentity (verification status + DKIM tokens)
+ *   - ListEmailIdentities
+ *   - PutEmailIdentityConfigurationSetAttributes (limited update)
+ *
+ * SES uses domain-based verification. When an email identity is created,
+ * SES automatically initiates DKIM verification and returns DKIM tokens
+ * that must be published as DNS CNAME records.
+ */
+import type { ProviderCreateSenderInput, ProviderUpdateSenderInput, ProviderSenderResult, ProviderDeleteResult, ProviderVerificationResult, ProviderVerificationType, DNSRecord, ProviderValidationResult, ProviderSender, SenderConfiguration, SyncResult } from '@bernierllc/email-sender-manager';
+/** Minimal logger interface accepted by the sender manager. */
+export interface SesSenderManagerLogger {
+    info: (message: string) => void;
+    debug: (message: string) => void;
+    warn: (message: string) => void;
+}
+/**
+ * Shape of the SES v2 client we depend on.
+ *
+ * We accept `any` in the constructor so the caller can pass an actual
+ * `SESv2Client` (from `@aws-sdk/client-sesv2`) or a test double.  The
+ * methods listed below are the only ones we invoke.
+ */
+export interface SesClientShape {
+    send(command: unknown): Promise<unknown>;
+}
+export declare class SesSenderManager {
+    private readonly sesClient;
+    private readonly logger;
+    constructor(sesClient: SesClientShape, logger?: SesSenderManagerLogger);
+    createSender(input: ProviderCreateSenderInput): Promise<ProviderSenderResult>;
+    updateSender(input: ProviderUpdateSenderInput): Promise<ProviderSenderResult>;
+    deleteSender(providerSenderId: string): Promise<ProviderDeleteResult>;
+    getVerificationType(): ProviderVerificationType;
+    initiateVerification(providerSenderId: string): Promise<ProviderVerificationResult>;
+    checkVerificationStatus(providerSenderId: string): Promise<ProviderVerificationResult>;
+    getDnsRequirements(providerSenderId: string): Promise<DNSRecord[]>;
+    getVerifiedSenders(): Promise<ProviderSender[]>;
+    validateSender(email: string): Promise<ProviderValidationResult>;
+    syncSender(sender: SenderConfiguration): Promise<SyncResult>;
+    getCapabilities(): string[];
+    private buildDkimDnsRecords;
+}
+//# sourceMappingURL=sender-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sender-manager.d.ts","sourceRoot":"","sources":["../../../src/providers/ses/sender-manager.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAE1B,wBAAwB,EAGxB,SAAS,EACT,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,UAAU,EACX,MAAM,kCAAkC,CAAC;AAE1C,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAkHD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAEhD,SAAS,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,sBAAsB;IAShE,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA8D7E,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmE7E,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqC3E,mBAAmB,IAAI,wBAAwB;IAIzC,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAMnF,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAwDtF,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAyBlE,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAmD/C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAgDhE,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IA6ClE,eAAe,IAAI,MAAM,EAAE;IAQ3B,OAAO,CAAC,mBAAmB;CAQ5B"}

package/dist/providers/ses/sender-manager.js

@@ -0,0 +1,437 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SesSenderManager = void 0;
+// ---------------------------------------------------------------------------
+// Internal helpers for building SES v2 command objects without importing
+// the actual AWS SDK at compile time.  The real SDK is only required at
+// runtime by the existing SES provider (ses.ts) which dynamically
+// `require`s it.  We mirror that approach: the caller hands us an
+// already-initialised client and we construct plain command objects that
+// the SDK client can dispatch.
+// ---------------------------------------------------------------------------
+function createEmailIdentityCommand(params) {
+    return { input: params, __brand: 'CreateEmailIdentity' };
+}
+function deleteEmailIdentityCommand(params) {
+    return { input: params, __brand: 'DeleteEmailIdentity' };
+}
+function getEmailIdentityCommand(params) {
+    return { input: params, __brand: 'GetEmailIdentity' };
+}
+function listEmailIdentitiesCommand(params) {
+    return { input: params, __brand: 'ListEmailIdentities' };
+}
+function putConfigSetAttributesCommand(params) {
+    return { input: params, __brand: 'PutEmailIdentityConfigurationSetAttributes' };
+}
+// ---------------------------------------------------------------------------
+// Status mapping
+// ---------------------------------------------------------------------------
+function mapSesVerificationStatus(sesStatus) {
+    switch (sesStatus?.toUpperCase()) {
+        case 'SUCCESS':
+            return 'verified';
+        case 'PENDING':
+            return 'pending';
+        case 'FAILED':
+            return 'failed';
+        case 'TEMPORARY_FAILURE':
+            return 'pending';
+        case 'NOT_STARTED':
+            return 'not_started';
+        default:
+            return 'not_started';
+    }
+}
+function extractDomain(email) {
+    const atIndex = email.indexOf('@');
+    if (atIndex === -1) {
+        return email; // Assume the string is already a domain
+    }
+    return email.substring(atIndex + 1).toLowerCase();
+}
+// ---------------------------------------------------------------------------
+// Error helper
+// ---------------------------------------------------------------------------
+function buildProviderError(code, message, cause, field) {
+    return {
+        code,
+        message,
+        ...(field !== undefined ? { field } : {}),
+        ...(cause !== undefined ? { cause } : {}),
+    };
+}
+function mapSesErrorCode(error) {
+    const err = error;
+    const name = err.name ?? err.code ?? err.Code ?? '';
+    switch (name) {
+        case 'AlreadyExistsException':
+            return 'SENDER_ALREADY_EXISTS';
+        case 'NotFoundException':
+            return 'SENDER_NOT_FOUND';
+        case 'TooManyRequestsException':
+        case 'LimitExceededException':
+            return 'RATE_LIMITED';
+        case 'BadRequestException':
+        case 'ValidationException':
+            return 'INVALID_EMAIL';
+        case 'UnauthorizedException':
+        case 'AccessDeniedException':
+            return 'AUTHENTICATION_FAILED';
+        default:
+            break;
+    }
+    const statusCode = err.$metadata?.httpStatusCode;
+    if (statusCode === 429)
+        return 'RATE_LIMITED';
+    if (statusCode === 401 || statusCode === 403)
+        return 'AUTHENTICATION_FAILED';
+    return 'PROVIDER_ERROR';
+}
+// ---------------------------------------------------------------------------
+// SesSenderManager
+// ---------------------------------------------------------------------------
+class SesSenderManager {
+    constructor(sesClient, logger) {
+        this.sesClient = sesClient;
+        this.logger = logger;
+    }
+    // ------------------------------------------------------------------
+    // Create
+    // ------------------------------------------------------------------
+    async createSender(input) {
+        if (!input.fromEmail) {
+            return {
+                success: false,
+                providerSenderId: '',
+                email: '',
+                verificationStatus: 'not_started',
+                error: buildProviderError('MISSING_REQUIRED_FIELD', 'fromEmail is required', undefined, 'fromEmail'),
+            };
+        }
+        const domain = extractDomain(input.fromEmail);
+        const identity = domain; // SES operates on domain identities
+        try {
+            const command = createEmailIdentityCommand({ EmailIdentity: identity });
+            const response = await this.sesClient.send(command);
+            const dkimTokens = response.DkimAttributes?.Tokens ?? [];
+            const dkimStatus = response.DkimAttributes?.Status ?? 'PENDING';
+            this.logger?.info(`Created SES identity for domain ${identity}`);
+            return {
+                success: true,
+                providerSenderId: identity,
+                email: input.fromEmail,
+                verificationStatus: mapSesVerificationStatus(dkimStatus),
+                metadata: {
+                    domain: identity,
+                    dkimTokens,
+                    dkimSigningEnabled: response.DkimAttributes?.SigningEnabled ?? false,
+                    verifiedForSending: response.VerifiedForSendingStatus ?? false,
+                },
+            };
+        }
+        catch (error) {
+            const errCode = mapSesErrorCode(error);
+            const message = error instanceof Error ? error.message : 'Unknown SES error';
+            this.logger?.warn(`Failed to create SES identity for ${identity}: ${message}`);
+            return {
+                success: false,
+                providerSenderId: identity,
+                email: input.fromEmail,
+                verificationStatus: 'not_started',
+                error: buildProviderError(errCode, message, error instanceof Error ? error : undefined),
+            };
+        }
+    }
+    // ------------------------------------------------------------------
+    // Update
+    // ------------------------------------------------------------------
+    async updateSender(input) {
+        if (!input.providerSenderId) {
+            return {
+                success: false,
+                providerSenderId: '',
+                email: '',
+                verificationStatus: 'not_started',
+                error: buildProviderError('MISSING_REQUIRED_FIELD', 'providerSenderId is required', undefined, 'providerSenderId'),
+            };
+        }
+        // SES only supports updating the configuration set association
+        const configurationSet = input.providerFields?.['configurationSet'];
+        if (!configurationSet) {
+            // SES does not support updating fromName, replyTo, etc. on identities
+            return {
+                success: false,
+                providerSenderId: input.providerSenderId,
+                email: input.providerSenderId,
+                verificationStatus: 'not_started',
+                error: buildProviderError('UNSUPPORTED_OPERATION', 'SES does not support updating sender identity fields. Only configurationSet can be changed via providerFields.'),
+            };
+        }
+        try {
+            const command = putConfigSetAttributesCommand({
+                EmailIdentity: input.providerSenderId,
+                ConfigurationSetName: configurationSet,
+            });
+            await this.sesClient.send(command);
+            this.logger?.info(`Updated configuration set for ${input.providerSenderId} to ${configurationSet}`);
+            // Fetch current status after update
+            const status = await this.checkVerificationStatus(input.providerSenderId);
+            return {
+                success: true,
+                providerSenderId: input.providerSenderId,
+                email: input.providerSenderId,
+                verificationStatus: status.status,
+                metadata: {
+                    configurationSet,
+                },
+            };
+        }
+        catch (error) {
+            const errCode = mapSesErrorCode(error);
+            const message = error instanceof Error ? error.message : 'Unknown SES error';
+            return {
+                success: false,
+                providerSenderId: input.providerSenderId,
+                email: input.providerSenderId,
+                verificationStatus: 'not_started',
+                error: buildProviderError(errCode, message, error instanceof Error ? error : undefined),
+            };
+        }
+    }
+    // ------------------------------------------------------------------
+    // Delete
+    // ------------------------------------------------------------------
+    async deleteSender(providerSenderId) {
+        if (!providerSenderId) {
+            return {
+                success: false,
+                providerSenderId: '',
+                error: buildProviderError('MISSING_REQUIRED_FIELD', 'providerSenderId is required', undefined, 'providerSenderId'),
+            };
+        }
+        try {
+            const command = deleteEmailIdentityCommand({ EmailIdentity: providerSenderId });
+            await this.sesClient.send(command);
+            this.logger?.info(`Deleted SES identity ${providerSenderId}`);
+            return {
+                success: true,
+                providerSenderId,
+            };
+        }
+        catch (error) {
+            const errCode = mapSesErrorCode(error);
+            const message = error instanceof Error ? error.message : 'Unknown SES error';
+            this.logger?.warn(`Failed to delete SES identity ${providerSenderId}: ${message}`);
+            return {
+                success: false,
+                providerSenderId,
+                error: buildProviderError(errCode, message, error instanceof Error ? error : undefined),
+            };
+        }
+    }
+    // ------------------------------------------------------------------
+    // Verification
+    // ------------------------------------------------------------------
+    getVerificationType() {
+        return 'domain';
+    }
+    async initiateVerification(providerSenderId) {
+        // SES auto-initiates verification when the identity is created.
+        // We simply fetch the current status and return it.
+        return this.checkVerificationStatus(providerSenderId);
+    }
+    async checkVerificationStatus(providerSenderId) {
+        if (!providerSenderId) {
+            return {
+                success: false,
+                providerSenderId: '',
+                status: 'not_started',
+                verificationType: 'domain',
+                error: buildProviderError('MISSING_REQUIRED_FIELD', 'providerSenderId is required', undefined, 'providerSenderId'),
+            };
+        }
+        try {
+            const command = getEmailIdentityCommand({ EmailIdentity: providerSenderId });
+            const response = await this.sesClient.send(command);
+            const dkimStatus = response.DkimAttributes?.Status ?? 'NOT_STARTED';
+            const verificationStatus = mapSesVerificationStatus(dkimStatus);
+            const dkimTokens = response.DkimAttributes?.Tokens ?? [];
+            const dnsRecords = this.buildDkimDnsRecords(dkimTokens, providerSenderId);
+            this.logger?.debug(`Verification status for ${providerSenderId}: ${verificationStatus}`);
+            return {
+                success: true,
+                providerSenderId,
+                status: verificationStatus,
+                verificationType: 'domain',
+                dnsRecords,
+                message: verificationStatus === 'verified'
+                    ? `Domain ${providerSenderId} is verified for sending.`
+                    : `Domain ${providerSenderId} verification is ${verificationStatus}. Add the DKIM CNAME records to your DNS.`,
+            };
+        }
+        catch (error) {
+            const errCode = mapSesErrorCode(error);
+            const message = error instanceof Error ? error.message : 'Unknown SES error';
+            return {
+                success: false,
+                providerSenderId,
+                status: 'not_started',
+                verificationType: 'domain',
+                error: buildProviderError(errCode, message, error instanceof Error ? error : undefined),
+            };
+        }
+    }
+    async getDnsRequirements(providerSenderId) {
+        if (!providerSenderId) {
+            return [];
+        }
+        try {
+            const command = getEmailIdentityCommand({ EmailIdentity: providerSenderId });
+            const response = await this.sesClient.send(command);
+            const dkimTokens = response.DkimAttributes?.Tokens ?? [];
+            return this.buildDkimDnsRecords(dkimTokens, providerSenderId);
+        }
+        catch (_error) {
+            this.logger?.warn(`Failed to fetch DNS requirements for ${providerSenderId}`);
+            return [];
+        }
+    }
+    // ------------------------------------------------------------------
+    // Listing & validation
+    // ------------------------------------------------------------------
+    async getVerifiedSenders() {
+        try {
+            const senders = [];
+            let nextToken;
+            do {
+                const command = listEmailIdentitiesCommand({
+                    PageSize: 100,
+                    ...(nextToken !== undefined ? { NextToken: nextToken } : {}),
+                });
+                const response = await this.sesClient.send(command);
+                for (const identity of response.EmailIdentities ?? []) {
+                    const name = identity.IdentityName ?? '';
+                    const isVerified = identity.SendingEnabled ?? false;
+                    const identityType = identity.IdentityType ?? 'UNKNOWN';
+                    senders.push({
+                        id: name,
+                        email: name,
+                        name: name,
+                        isVerified,
+                        verificationStatus: isVerified ? 'verified' : 'pending',
+                        domain: identityType === 'DOMAIN' ? name : extractDomain(name),
+                        metadata: {
+                            identityType,
+                            sendingEnabled: isVerified,
+                        },
+                    });
+                }
+                nextToken = response.NextToken;
+            } while (nextToken);
+            this.logger?.info(`Fetched ${senders.length} SES identities`);
+            return senders;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown SES error';
+            this.logger?.warn(`Failed to list SES identities: ${message}`);
+            throw error;
+        }
+    }
+    async validateSender(email) {
+        const domain = extractDomain(email);
+        try {
+            const command = getEmailIdentityCommand({ EmailIdentity: domain });
+            const response = await this.sesClient.send(command);
+            const isVerified = response.VerifiedForSendingStatus ?? false;
+            const dkimStatus = response.DkimAttributes?.Status ?? 'NOT_STARTED';
+            return {
+                isVerified,
+                verificationStatus: mapSesVerificationStatus(dkimStatus),
+                lastChecked: new Date(),
+                metadata: {
+                    domain,
+                    identityType: response.IdentityType,
+                    dkimSigningEnabled: response.DkimAttributes?.SigningEnabled ?? false,
+                    dkimTokens: response.DkimAttributes?.Tokens ?? [],
+                },
+            };
+        }
+        catch (error) {
+            // If the identity doesn't exist, the sender is not verified
+            const err = error;
+            if (err.name === 'NotFoundException') {
+                return {
+                    isVerified: false,
+                    verificationStatus: 'not_started',
+                    lastChecked: new Date(),
+                    metadata: {
+                        domain,
+                        error: 'Identity not found in SES',
+                    },
+                };
+            }
+            throw error;
+        }
+    }
+    async syncSender(sender) {
+        const domain = extractDomain(sender.fromEmail);
+        try {
+            const command = getEmailIdentityCommand({ EmailIdentity: domain });
+            const response = await this.sesClient.send(command);
+            const isVerified = response.VerifiedForSendingStatus ?? false;
+            const dkimStatus = response.DkimAttributes?.Status ?? 'NOT_STARTED';
+            return {
+                success: true,
+                senderId: sender.id,
+                synced: true,
+                message: `SES identity ${domain} is ${isVerified ? 'verified' : 'not verified'} (DKIM: ${dkimStatus})`,
+            };
+        }
+        catch (error) {
+            const err = error;
+            if (err.name === 'NotFoundException') {
+                return {
+                    success: true,
+                    senderId: sender.id,
+                    synced: false,
+                    message: `SES identity ${domain} does not exist. Create it to begin verification.`,
+                };
+            }
+            const message = error instanceof Error ? error.message : 'Unknown SES error';
+            return {
+                success: false,
+                senderId: sender.id,
+                synced: false,
+                message: `Failed to sync SES identity ${domain}: ${message}`,
+                error: message,
+            };
+        }
+    }
+    // ------------------------------------------------------------------
+    // Capabilities
+    // ------------------------------------------------------------------
+    getCapabilities() {
+        return ['send', 'domain_verification', 'dkim'];
+    }
+    // ------------------------------------------------------------------
+    // Private helpers
+    // ------------------------------------------------------------------
+    buildDkimDnsRecords(tokens, _domain) {
+        return tokens.map(token => ({
+            type: 'CNAME',
+            host: `${token}._domainkey`,
+            value: `${token}.dkim.amazonses.com`,
+            ttl: 1800,
+        }));
+    }
+}
+exports.SesSenderManager = SesSenderManager;
+//# sourceMappingURL=sender-manager.js.map

package/dist/providers/ses/sender-manager.js.map

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

package/dist/providers/ses.d.ts

@@ -4,6 +4,7 @@
  */
 import { EmailProvider } from './base';
 import type { EmailMessage, SendResult, EmailProviderConfig, EmailProviderCapabilities, EmailValidationResult, EmailTemplate, DeliveryStatus, WebhookEvent } from '../types';
+import { SesSenderManager } from './ses/sender-manager';
 interface SesConfig extends EmailProviderConfig {
     provider: 'ses';
     apiKey: string;
@@ -14,7 +15,29 @@ interface SesConfig extends EmailProviderConfig {
 }
 export declare class SesProvider extends EmailProvider {
     private sesClient;
+    private senderManager?;
     constructor(config: SesConfig);
+    /**
+     * Get the SES sender manager for identity lifecycle operations.
+     *
+     * The sender manager wraps the SES v2 API for creating, verifying,
+     * and deleting email/domain identities.
+     *
+     * NOTE: The sender manager requires an SES **v2** client
+     * (`@aws-sdk/client-sesv2`), while the existing provider uses the
+     * v1 SDK (`aws-sdk`).  If you need sender management, pass a v2
+     * client via `setSesV2Client()` before calling this method, or
+     * construct a `SesSenderManager` directly.
+     */
+    getSenderManager(): SesSenderManager;
+    /**
+     * Provide an SES v2 client for the sender manager.
+     *
+     * @param sesV2Client An initialised `SESv2Client` from `@aws-sdk/client-sesv2`
+     */
+    setSesV2Client(sesV2Client: {
+        send(command: unknown): Promise<unknown>;
+    }): void;
     private initializeClient;
     sendEmail(message: EmailMessage): Promise<SendResult>;
     sendBatch(emails: EmailMessage[]): Promise<SendResult[]>;

package/dist/providers/ses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ses.d.ts","sourceRoot":"","sources":["../../src/providers/ses.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,YAAY,EAEb,MAAM,UAAU,CAAC;AAGlB,UAAU,SAAU,SAAQ,mBAAmB;IAC7C,QAAQ,EAAE,KAAK,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAkCD,qBAAa,WAAY,SAAQ,aAAa;IAC5C,OAAO,CAAC,SAAS,CAAM;gBAEX,MAAM,EAAE,SAAS;IAK7B,OAAO,CAAC,gBAAgB;IAkBlB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAmCrD,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YA2BhD,cAAc;IAyCb,iBAAiB,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC;IAuCP,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBzG,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA2B9D,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAkBhC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAiBpE,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAM1E,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAUxC,qBAAqB,IAAI,qBAAqB;IA+B9C,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB;IA6BlE,eAAe,IAAI,yBAAyB;IA4BrD,OAAO,CAAC,mBAAmB;IAkD3B,OAAO,CAAC,cAAc;CAsBvB"}
+{"version":3,"file":"ses.d.ts","sourceRoot":"","sources":["../../src/providers/ses.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,YAAY,EAEb,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,UAAU,SAAU,SAAQ,mBAAmB;IAC7C,QAAQ,EAAE,KAAK,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAkCD,qBAAa,WAAY,SAAQ,aAAa;IAC5C,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,aAAa,CAAC,CAAmB;gBAE7B,MAAM,EAAE,SAAS;IAK7B;;;;;;;;;;;OAWG;IACH,gBAAgB,IAAI,gBAAgB;IAUpC;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE;QAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAI/E,OAAO,CAAC,gBAAgB;IAkBlB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAmCrD,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YA2BhD,cAAc;IAyCb,iBAAiB,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC;IAuCP,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBzG,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA2B9D,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAkBhC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAiBpE,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAM1E,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAUxC,qBAAqB,IAAI,qBAAqB;IA+B9C,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB;IA6BlE,eAAe,IAAI,yBAAyB;IA4BrD,OAAO,CAAC,mBAAmB;IAkD3B,OAAO,CAAC,cAAc;CAsBvB"}

package/dist/providers/ses.js

@@ -14,11 +14,41 @@ exports.SesProvider = void 0;
  */
 const base_1 = require("./base");
 const types_1 = require("../types");
+const sender_manager_1 = require("./ses/sender-manager");
 class SesProvider extends base_1.EmailProvider {
     constructor(config) {
         super(config);
         this.initializeClient();
     }
+    /**
+     * Get the SES sender manager for identity lifecycle operations.
+     *
+     * The sender manager wraps the SES v2 API for creating, verifying,
+     * and deleting email/domain identities.
+     *
+     * NOTE: The sender manager requires an SES **v2** client
+     * (`@aws-sdk/client-sesv2`), while the existing provider uses the
+     * v1 SDK (`aws-sdk`).  If you need sender management, pass a v2
+     * client via `setSesV2Client()` before calling this method, or
+     * construct a `SesSenderManager` directly.
+     */
+    getSenderManager() {
+        if (!this.senderManager) {
+            // Attempt to use the existing v1 client as a fallback.
+            // The v1 client does not have a `.send()` method with the v2
+            // command pattern, so this is best-effort.
+            this.senderManager = new sender_manager_1.SesSenderManager(this.sesClient);
+        }
+        return this.senderManager;
+    }
+    /**
+     * Provide an SES v2 client for the sender manager.
+     *
+     * @param sesV2Client An initialised `SESv2Client` from `@aws-sdk/client-sesv2`
+     */
+    setSesV2Client(sesV2Client) {
+        this.senderManager = new sender_manager_1.SesSenderManager(sesV2Client);
+    }
     initializeClient() {
         try {
             // Dynamically import AWS SDK to avoid bundling issues