@zyther/tzmail 0.1.3 → 0.5.0

package/dist/templates/themes/pastel.theme.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PastelTheme = void 0;
+const theme_enum_1 = require("../../core/enums/theme.enum");
+class PastelTheme {
+    id = theme_enum_1.ThemeType.PASTEL;
+    name = 'Pastel';
+    light = {
+        primary: '#76536B',
+        secondary: '#796C78',
+        background: '#FFFAF4',
+        text: '#352D36',
+        textMuted: '#655B65',
+        border: '#E8DCD9',
+        success: '#356B56',
+        error: '#9B4148',
+        warning: '#80551F'
+    };
+    dark = {
+        primary: '#765A80',
+        secondary: '#C7B7CB',
+        background: '#211D27',
+        text: '#F7F0F5',
+        textMuted: '#C9BEC9',
+        border: '#49404D',
+        success: '#8FCBAA',
+        error: '#F0A0A4',
+        warning: '#E8C17B'
+    };
+    typography = {
+        fontFamily: 'Arial, Helvetica, sans-serif',
+        fontSizes: {
+            small: '14px',
+            medium: '16px',
+            large: '18px',
+            xlarge: '26px'
+        },
+        fontWeights: {
+            normal: 400,
+            medium: 500,
+            bold: 700
+        }
+    };
+    spacing = {
+        xs: '6px',
+        sm: '12px',
+        md: '20px',
+        lg: '30px',
+        xl: '44px'
+    };
+    emailStyles = {
+        maxWidthPx: 600,
+        container: {
+            borderColor: 'border',
+            borderWidth: '1px',
+            borderRadius: '14px',
+            boxShadow: '0 2px 10px rgba(53, 45, 54, 0.08)'
+        },
+        header: {
+            accentColor: 'primary',
+            accentWidth: '3px',
+            horizontalPadding: '28px',
+            logoColor: 'primary',
+            logoFontFamily: 'Georgia, "Times New Roman", serif',
+            logoLetterSpacing: '0.03em',
+            imageBorderRadius: '10px'
+        },
+        body: {
+            accentColor: 'secondary',
+            accentWidth: '2px',
+            borderRadius: '10px',
+            boxShadow: 'none',
+            horizontalPadding: '28px',
+            lineHeight: 1.6
+        },
+        button: {
+            appearance: 'solid',
+            borderRadius: '18px',
+            borderWidth: '1px',
+            boxShadow: 'none',
+            letterSpacing: '0.01em'
+        },
+        footer: {
+            accentColor: 'border',
+            accentWidth: '1px'
+        }
+    };
+}
+exports.PastelTheme = PastelTheme;

package/dist/templates/themes/sunset.theme.d.ts

@@ -0,0 +1,12 @@
+import { ThemeType } from '../../core/enums/theme.enum';
+import { ITheme, IThemeColors, ITypography, ISpacing, IThemeEmailStyles } from './theme.interface';
+export declare class SunsetTheme implements ITheme {
+    id: ThemeType;
+    name: string;
+    light: IThemeColors;
+    dark: IThemeColors;
+    typography: ITypography;
+    spacing: ISpacing;
+    emailStyles: IThemeEmailStyles;
+}
+//# sourceMappingURL=sunset.theme.d.ts.map

package/dist/templates/themes/sunset.theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sunset.theme.d.ts","sourceRoot":"","sources":["../../../src/templates/themes/sunset.theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEnG,qBAAa,WAAY,YAAW,MAAM;IACxC,EAAE,YAAoB;IACtB,IAAI,SAAY;IAEhB,KAAK,EAAE,YAAY,CAUjB;IAEF,IAAI,EAAE,YAAY,CAUhB;IAEF,UAAU,EAAE,WAAW,CAarB;IAEF,OAAO,EAAE,QAAQ,CAMf;IAEF,WAAW,EAAE,iBAAiB,CAqC5B;CACH"}

package/dist/templates/themes/sunset.theme.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SunsetTheme = void 0;
+const theme_enum_1 = require("../../core/enums/theme.enum");
+class SunsetTheme {
+    id = theme_enum_1.ThemeType.SUNSET;
+    name = 'Sunset';
+    light = {
+        primary: '#A63F32',
+        secondary: '#8A5548',
+        background: '#FFF7F0',
+        text: '#38242E',
+        textMuted: '#755B60',
+        border: '#E8CFC4',
+        success: '#286B4D',
+        error: '#A52E35',
+        warning: '#81500A'
+    };
+    dark = {
+        primary: '#FF927A',
+        secondary: '#E8B077',
+        background: '#211923',
+        text: '#FFF1E8',
+        textMuted: '#C8B3B8',
+        border: '#503842',
+        success: '#81D0A4',
+        error: '#FF8A91',
+        warning: '#F5C36B'
+    };
+    typography = {
+        fontFamily: 'Arial, Helvetica, sans-serif',
+        fontSizes: {
+            small: '14px',
+            medium: '16px',
+            large: '18px',
+            xlarge: '26px'
+        },
+        fontWeights: {
+            normal: 400,
+            medium: 500,
+            bold: 700
+        }
+    };
+    spacing = {
+        xs: '6px',
+        sm: '12px',
+        md: '20px',
+        lg: '30px',
+        xl: '44px'
+    };
+    emailStyles = {
+        maxWidthPx: 600,
+        container: {
+            borderColor: 'border',
+            borderWidth: '1px',
+            borderRadius: '12px',
+            boxShadow: '0 2px 8px rgba(0, 0, 0, 0.08)'
+        },
+        header: {
+            accentColor: 'primary',
+            accentWidth: '3px',
+            horizontalPadding: '30px',
+            logoColor: 'primary',
+            logoFontFamily: 'Georgia, "Times New Roman", serif',
+            logoTextTransform: 'uppercase',
+            logoLetterSpacing: '1.2px',
+            imageBorderRadius: '6px'
+        },
+        body: {
+            accentColor: 'secondary',
+            accentWidth: '2px',
+            borderRadius: '8px',
+            boxShadow: 'none',
+            horizontalPadding: '30px',
+            lineHeight: 1.6
+        },
+        button: {
+            appearance: 'solid',
+            borderRadius: '6px',
+            borderWidth: '1px',
+            boxShadow: 'none',
+            letterSpacing: '0.4px'
+        },
+        footer: {
+            accentColor: 'border',
+            accentWidth: '1px'
+        }
+    };
+}
+exports.SunsetTheme = SunsetTheme;

package/dist/templates/themes/system.theme.d.ts

@@ -1,5 +1,5 @@
 import { ThemeType } from '../../core/enums/theme.enum';
-import { ITheme } from './theme.interface';
+import { ITheme, IThemeEmailStyles } from './theme.interface';
 export declare class SystemTheme implements ITheme {
     id: ThemeType;
     name: string;
@@ -46,5 +46,6 @@ export declare class SystemTheme implements ITheme {
         lg: string;
         xl: string;
     };
+    emailStyles: IThemeEmailStyles;
 }
 //# sourceMappingURL=system.theme.d.ts.map

package/dist/templates/themes/system.theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.theme.d.ts","sourceRoot":"","sources":["../../../src/templates/themes/system.theme.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,qBAAa,WAAY,YAAW,MAAM;IACxC,EAAE,YAAoB;IACtB,IAAI,SAAY;IAEhB,KAAK;;;;;;;;;;MAUH;IAEF,IAAI;;;;;;;;;;MAUF;IAEF,UAAU;;;;;;;;;;;;;MAaR;IAEF,OAAO;;;;;;MAML;CACH"}
+{"version":3,"file":"system.theme.d.ts","sourceRoot":"","sources":["../../../src/templates/themes/system.theme.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,qBAAa,WAAY,YAAW,MAAM;IACxC,EAAE,YAAoB;IACtB,IAAI,SAAY;IAEhB,KAAK;;;;;;;;;;MAUH;IAEF,IAAI;;;;;;;;;;MAUF;IAEF,UAAU;;;;;;;;;;;;;MAaR;IAEF,OAAO;;;;;;MAML;IAEF,WAAW,EAAE,iBAAiB,CAmC5B;CACH"}

package/dist/templates/themes/system.theme.js

@@ -3,52 +3,86 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SystemTheme = void 0;
 const theme_enum_1 = require("../../core/enums/theme.enum");
 class SystemTheme {
-    constructor() {
-        this.id = theme_enum_1.ThemeType.SYSTEM;
-        this.name = 'System';
-        this.light = {
-            primary: '#3b82f6',
-            secondary: '#6b7280',
-            background: '#ffffff',
-            text: '#111827',
-            textMuted: '#6b7280',
-            border: '#e5e7eb',
-            success: '#10b981',
-            error: '#ef4444',
-            warning: '#f59e0b'
-        };
-        this.dark = {
-            primary: '#3b82f6',
-            secondary: '#9ca3af',
-            background: '#111827',
-            text: '#f9fafb',
-            textMuted: '#9ca3af',
-            border: '#374151',
-            success: '#10b981',
-            error: '#ef4444',
-            warning: '#f59e0b'
-        };
-        this.typography = {
-            fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif',
-            fontSizes: {
-                small: '12px',
-                medium: '14px',
-                large: '16px',
-                xlarge: '20px'
-            },
-            fontWeights: {
-                normal: 400,
-                medium: 500,
-                bold: 700
-            }
-        };
-        this.spacing = {
-            xs: '4px',
-            sm: '8px',
-            md: '16px',
-            lg: '24px',
-            xl: '32px'
-        };
-    }
+    id = theme_enum_1.ThemeType.SYSTEM;
+    name = 'System';
+    light = {
+        primary: '#3b82f6',
+        secondary: '#6b7280',
+        background: '#ffffff',
+        text: '#111827',
+        textMuted: '#6b7280',
+        border: '#e5e7eb',
+        success: '#10b981',
+        error: '#ef4444',
+        warning: '#f59e0b'
+    };
+    dark = {
+        primary: '#3b82f6',
+        secondary: '#9ca3af',
+        background: '#111827',
+        text: '#f9fafb',
+        textMuted: '#9ca3af',
+        border: '#374151',
+        success: '#10b981',
+        error: '#ef4444',
+        warning: '#f59e0b'
+    };
+    typography = {
+        fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif',
+        fontSizes: {
+            small: '12px',
+            medium: '14px',
+            large: '16px',
+            xlarge: '20px'
+        },
+        fontWeights: {
+            normal: 400,
+            medium: 500,
+            bold: 700
+        }
+    };
+    spacing = {
+        xs: '4px',
+        sm: '8px',
+        md: '16px',
+        lg: '24px',
+        xl: '32px'
+    };
+    emailStyles = {
+        maxWidthPx: 600,
+        container: {
+            borderColor: 'border',
+            borderWidth: '1px',
+            borderRadius: '8px',
+            boxShadow: '0 1px 3px rgba(0, 0, 0, 0.08)'
+        },
+        header: {
+            accentColor: 'primary',
+            accentWidth: '3px',
+            horizontalPadding: '24px',
+            logoColor: 'primary',
+            logoLetterSpacing: '0.01em',
+            imageBorderRadius: '4px'
+        },
+        body: {
+            accentColor: 'primary',
+            accentWidth: '2px',
+            borderRadius: '4px',
+            boxShadow: 'none',
+            horizontalPadding: '24px',
+            lineHeight: 1.6
+        },
+        button: {
+            appearance: 'solid',
+            borderRadius: '6px',
+            borderWidth: '0px',
+            boxShadow: 'none',
+            letterSpacing: '0.01em'
+        },
+        footer: {
+            accentColor: 'secondary',
+            accentWidth: '1px'
+        }
+    };
 }
 exports.SystemTheme = SystemTheme;

package/dist/templates/themes/theme.interface.d.ts

@@ -1,4 +1,50 @@
 import { ThemeType } from "../../core/enums/theme.enum";
+export type IThemeColorToken = 'primary' | 'secondary' | 'border' | 'none';
+export type IThemeTextTransform = 'none' | 'uppercase' | 'capitalize';
+/**
+ * Optional, email-client-conscious visual tokens used by TemplateBuilder.
+ * Existing custom ITheme implementations remain compatible when this is omitted.
+ */
+export interface IThemeEmailStyles {
+    /** Fixed-width fallback for desktop email clients; the renderer also emits fluid width styles. */
+    maxWidthPx: number;
+    container: {
+        borderColor: IThemeColorToken;
+        borderWidth: string;
+        borderRadius: string;
+        boxShadow: string;
+    };
+    header: {
+        accentColor: IThemeColorToken;
+        accentWidth: string;
+        horizontalPadding: string;
+        logoColor: 'text' | 'primary' | 'secondary';
+        logoFontFamily?: string;
+        logoTextTransform?: IThemeTextTransform;
+        logoLetterSpacing?: string;
+        imageBorderRadius: string;
+    };
+    body: {
+        accentColor: IThemeColorToken;
+        accentWidth: string;
+        borderRadius: string;
+        boxShadow: string;
+        horizontalPadding: string;
+        lineHeight: number;
+    };
+    button: {
+        appearance: 'solid' | 'outline';
+        borderRadius: string;
+        borderWidth: string;
+        boxShadow: string;
+        textTransform?: IThemeTextTransform;
+        letterSpacing?: string;
+    };
+    footer: {
+        accentColor: IThemeColorToken;
+        accentWidth: string;
+    };
+}
 export interface ITheme {
     id: ThemeType;
     name: string;
@@ -6,6 +52,8 @@ export interface ITheme {
     dark: IThemeColors;
     typography: ITypography;
     spacing: ISpacing;
+    /** Optional structural style tokens; omitted tokens fall back to conservative email-safe defaults. */
+    emailStyles?: IThemeEmailStyles;
 }
 export interface IThemeColors {
     primary: string;

package/dist/templates/themes/theme.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.interface.d.ts","sourceRoot":"","sources":["../../../src/templates/themes/theme.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,SAAS,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,WAAW,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ"}
+{"version":3,"file":"theme.interface.d.ts","sourceRoot":"","sources":["../../../src/templates/themes/theme.interface.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,17 +1,21 @@
 {
   "name": "@zyther/tzmail",
-  "version": "0.1.3",
-  "description": "A powerful and flexible TypeScript/Node.js email package built on top of Nodemailer, featuring a robust templating system with built-in themes, caching, and easy attachment management.",
+  "version": "0.5.0",
+  "description": "TypeScript email templates, multi-provider delivery and optional BullMQ asynchronous queues.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "scripts": {
     "build": "tsc",
     "dev": "ts-node src/index.ts",
     "start": "node dist/index.js",
-    "lint": "eslint src --ext .ts"
+    "lint": "eslint . --max-warnings=0",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test test/*.test.cjs",
+    "gallery:build": "npm run build && node scripts/generate-theme-gallery.cjs"
   },
   "author": "zytherdev <zyther.dev@outlook.com>",
   "homepage": "https://github.com/zytherdev/tzmail#readme",
@@ -22,6 +26,9 @@
     "type": "git",
     "url": "git+https://github.com/zytherdev/tzmail.git"
   },
+  "engines": {
+    "node": ">=20"
+  },
   "license": "ISC",
   "keywords": [
     "email",
@@ -29,25 +36,40 @@
     "typescript",
     "nodejs",
     "smtp",
+    "sendgrid",
+    "amazon-ses",
+    "mailgun",
+    "bullmq",
+    "redis-queue",
     "mail",
     "nodemailer",
     "templates",
     "themes"
   ],
-
   "peerDependencies": {
-    "nodemailer": "^6.9.0 || ^7 || ^8"
+    "nodemailer": "^6.9.0 || ^7 || ^8",
+    "@aws-sdk/client-sesv2": "^3.0.0",
+    "bullmq": "^5.0.0 || ^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-sesv2": {
+      "optional": true
+    },
+    "bullmq": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@types/nodemailer": "^7.0.11"
   },
-
   "devDependencies": {
-    "@types/jest": "^29.5.11",
+    "@eslint/js": "^10.0.1",
     "@types/node": "^25.5.0",
-    "@types/nodemailer": "^7.0.11",
-    "jest": "^29.7.0",
+    "eslint": "^10.14.0",
+    "globals": "^17.14.0",
     "nodemailer": "^8.0.3",
     "ts-node": "^10.9.2",
-    "typescript": "^5.0.0"
-  },
-
-  "dependencies": {}
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.72.1"
+  }
 }

package/src/core/enums/template-part.enum.ts

@@ -0,0 +1,7 @@
+
+export enum TemplatePart {
+  HEADER = 'header',
+  BODY = 'body',
+  FOOTER = 'footer',
+  BUTTON = 'button'
+}

package/src/core/enums/theme.enum.ts

@@ -0,0 +1,18 @@
+
+export enum ThemeType {
+  SYSTEM = 'system',
+  MONOKAI = 'monokai',
+  MODERN = 'modern',
+  CORPORATE = 'corporate',
+  MINIMAL = 'minimal',
+  AURORA = 'aurora',
+  OCEAN = 'ocean',
+  SUNSET = 'sunset',
+  LAVENDER = 'lavender',
+  FOREST = 'forest',
+  EDITORIAL = 'editorial',
+  PASTEL = 'pastel',
+  NEOBRUTAL = 'neobrutal',
+  GLASS = 'glass',
+  MIDNIGHT = 'midnight'
+}

package/src/core/interfaces/email.interface.ts

@@ -0,0 +1,116 @@
+import { ITemplate } from './template.interface';
+
+export interface IEmailOptions {
+  to: string | string[];
+  subject: string;
+  from?: string;
+  cc?: string | string[];
+  bcc?: string | string[];
+  attachments?: IAttachment[];
+  template?: ITemplate;
+  /** Primitive named values interpolated into `{{variable}}` placeholders. */
+  templateData?: Record<string, unknown>;
+  text?: string;
+  html?: string;
+}
+
+export interface IAttachment {
+  filename: string;
+  content?: string | Buffer;
+  path?: string;
+  contentType?: string;
+  cid?: string;
+}
+
+/**
+ * Typed outcome of an email attempt. `success` is true only when the transport
+ * did not report rejected recipients. `partial` means that at least one
+ * recipient was accepted and at least one rejected; a failure result must not
+ * be interpreted as successful delivery. `error` retains the original thrown
+ * validation, rendering or transport error, when present.
+ */
+export interface IEmailSendResult {
+  success: boolean;
+  status: 'success' | 'partial' | 'failure';
+  messageId?: string;
+  response?: string;
+  accepted?: Array<string | { address: string; name: string }>;
+  rejected?: Array<string | { address: string; name: string }>;
+  error?: unknown;
+  errorStage?: 'validation' | 'render' | 'smtp' | 'provider';
+}
+
+export type IEmailAuth =
+  | { user: string; pass: string; type?: 'login' | 'Login' | 'LOGIN' }
+  | {
+      user: string;
+      type: 'oauth2' | 'OAuth2' | 'OAUTH2';
+      clientId?: string;
+      clientSecret?: string;
+      refreshToken?: string;
+      accessToken?: string;
+      accessUrl?: string;
+      expires?: number;
+      timeout?: number;
+      privateKey?: string | { key: string; passphrase: string };
+      serviceClient?: string;
+      provisionCallback?: (
+        user: string,
+        renew: boolean,
+        callback: (error: Error | null, accessToken: string, expires: number) => void
+      ) => void;
+    }
+  | { user: string; pass: string; type: 'custom' | 'Custom' | 'CUSTOM'; method: string };
+
+export interface IEmailConfig {
+  host: string;
+  port: number;
+  secure: boolean;
+  /** Reuse SMTP connections; set true with pool sizing for sustained throughput. */
+  pool?: boolean;
+  maxConnections?: number;
+  maxMessages?: number;
+  /** Shared rate limiter window and message limit (requires pool: true). */
+  rateDelta?: number;
+  rateLimit?: number;
+  connectionTimeout?: number;
+  greetingTimeout?: number;
+  socketTimeout?: number;
+  auth: IEmailAuth;
+  defaultFrom?: string;
+}
+
+/** SendGrid Web API v3 settings. API keys should come from a secret manager. */
+export interface ISendGridConfig {
+  apiKey: string;
+  defaultFrom: string;
+  /** Optional API base URL, for example the regional EU API endpoint. */
+  apiUrl?: string;
+  requestTimeoutMs?: number;
+  /** Optional per-attachment memory guard; API attachments are encoded in memory. */
+  maxAttachmentBytes?: number;
+}
+
+/** Mailgun Messages API settings. */
+export interface IMailgunConfig {
+  apiKey: string;
+  domain: string;
+  defaultFrom: string;
+  region?: 'us' | 'eu';
+  /** Optional custom API base URL, useful for regional or controlled endpoints. */
+  apiUrl?: string;
+  requestTimeoutMs?: number;
+  /** Optional per-attachment memory guard; API attachments are uploaded in memory. */
+  maxAttachmentBytes?: number;
+}
+
+/** Amazon SES v2 settings; when credentials are omitted, the AWS SDK default credential chain is used. */
+export interface IAmazonSesConfig {
+  region: string;
+  defaultFrom?: string;
+  credentials?: {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+  };
+}