@xcelsior/email 1.0.2 → 1.0.4

package/.turbo/turbo-build.log

@@ -1,22 +1,22 @@
 
-> @xcelsior/email@1.0.0 build /Users/tuannguyen/Work/excelsior-packages/packages/services/email
-> tsup
+> @xcelsior/email@1.0.3 build /Users/tuannguyen/Work/xcelsior-packages/packages/services/email
+> tsup && tsc --noEmit
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.0
-CLI Using tsup config: /Users/tuannguyen/Work/excelsior-packages/packages/services/email/tsup.config.ts
+CLI tsup v8.5.1
+CLI Using tsup config: /Users/tuannguyen/Work/xcelsior-packages/packages/services/email/tsup.config.ts
 CLI Target: es2020
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-ESM dist/index.mjs     5.19 KB
-ESM dist/index.mjs.map 11.34 KB
-ESM ⚡️ Build success in 27ms
-CJS dist/index.js     7.42 KB
-CJS dist/index.js.map 11.60 KB
-CJS ⚡️ Build success in 27ms
+ESM dist/index.mjs     5.72 KB
+ESM dist/index.mjs.map 12.54 KB
+ESM ⚡️ Build success in 40ms
+CJS dist/index.js     7.95 KB
+CJS dist/index.js.map 12.80 KB
+CJS ⚡️ Build success in 40ms
 DTS Build start
-DTS ⚡️ Build success in 3138ms
-DTS dist/index.d.ts  849.00 B
-DTS dist/index.d.mts 849.00 B
+DTS ⚡️ Build success in 1658ms
+DTS dist/index.d.ts  818.00 B
+DTS dist/index.d.mts 818.00 B

package/.turbo/turbo-lint.log

@@ -1,5 +1,5 @@
 
-> @xcelsior/email@1.0.0 lint /Users/tuannguyen/Work/excelsior-packages/packages/services/email
+> @xcelsior/email@1.0.3 lint /Users/tuannguyen/Work/xcelsior-packages/packages/services/email
 > biome check .
 
-Checked 9 files in 19ms. No fixes applied.
+Checked 9 files in 12ms. No fixes applied.

package/.turbo/turbo-test.log

@@ -1,5 +1,5 @@
 
-> @xcelsior/email@1.0.0 test /Users/tuannguyen/Work/excelsior-packages/packages/services/email
+> @xcelsior/email@1.0.3 test /Users/tuannguyen/Work/xcelsior-packages/packages/services/email
 > jest --passWithNoTests
 
 Determining test suites to run...No tests found, exiting with code 0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# @xcelsior/email
+
+## 1.0.4
+
+### Patch Changes
+
+- improve email
+
+## 1.0.3
+
+### Patch Changes
+
+- Updated dependencies [e734bf5]
+  - @xcelsior/utils@1.0.1

package/dist/index.d.mts

@@ -1,5 +1,39 @@
 import * as nodemailer_lib_smtp_pool from 'nodemailer/lib/smtp-pool';
 
+interface SMTPTransportConfig {
+    host: string;
+    port?: number;
+    auth?: {
+        user: string;
+        pass: string;
+    };
+}
+interface SESTransportConfig {
+    region?: string;
+    sourceArn?: string;
+    credentials?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+}
+interface EmailLoggingConfig {
+    /** DynamoDB table name for email logs */
+    tableName: string;
+    /** AWS region for the logging table */
+    region?: string;
+}
+interface EmailServiceConfig {
+    /** Transport type – defaults to 'ses' */
+    transport?: 'smtp' | 'ses';
+    /** SMTP options (required when transport is 'smtp') */
+    smtp?: SMTPTransportConfig;
+    /** SES options (used when transport is 'ses') */
+    ses?: SESTransportConfig;
+    /** Email logging configuration – if omitted, logging is derived from env vars */
+    logging?: EmailLoggingConfig;
+    /** Enable nodemailer debug output */
+    debug?: boolean;
+}
 interface Email {
     to?: string | null;
     from?: string;
@@ -11,11 +45,38 @@ interface Email {
     attachments?: any[];
     subject: string;
 }
-declare const emailTransporter: (logger?: any) => {
+/**
+ * Create an email transporter.
+ *
+ * Accepts an optional {@link EmailServiceConfig} so callers can pass
+ * explicit configuration instead of relying on environment variables.
+ * Any value not provided in `config` falls back to the corresponding
+ * `process.env` variable, preserving full backward-compatibility.
+ */
+declare const emailTransporter: (logger?: any, config?: EmailServiceConfig) => {
     sendMail({ to, reference, from, replyTo, template, text, attachments, idempotencyKey, subject, }: Email, idempotentCheck?: boolean): Promise<nodemailer_lib_smtp_pool.SentMessageInfo | undefined>;
 };
 
 declare function renderTemplate(content: string, data: Record<string, any>): string;
 declare function renderTemplateFile(file: string, data: Record<string, any>): Promise<string>;
 
-export { type Email, emailTransporter, renderTemplate, renderTemplateFile };
+interface EmailLog {
+    reference?: string;
+    timestamp: number;
+    subject: string;
+    sender: string;
+    receiver: string;
+    idempotencyKey?: string;
+    status: 'success' | 'failed';
+    error?: string;
+}
+declare class EmailLogService {
+    private readonly tableName;
+    private readonly dynamoClient;
+    private readonly docClient;
+    constructor(loggingConfig?: EmailLoggingConfig);
+    logEmail({ subject, sender, receiver, status, error, idempotencyKey, reference, }: Omit<EmailLog, 'timestamp'>): Promise<string>;
+    getEmailByIdempotencyKey(idempotencyKey: string | undefined): Promise<EmailLog | null>;
+}
+
+export { type Email, EmailLogService, type EmailLoggingConfig, type EmailServiceConfig, type SESTransportConfig, type SMTPTransportConfig, emailTransporter, renderTemplate, renderTemplateFile };

package/dist/index.d.ts

@@ -1,5 +1,39 @@
 import * as nodemailer_lib_smtp_pool from 'nodemailer/lib/smtp-pool';
 
+interface SMTPTransportConfig {
+    host: string;
+    port?: number;
+    auth?: {
+        user: string;
+        pass: string;
+    };
+}
+interface SESTransportConfig {
+    region?: string;
+    sourceArn?: string;
+    credentials?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+}
+interface EmailLoggingConfig {
+    /** DynamoDB table name for email logs */
+    tableName: string;
+    /** AWS region for the logging table */
+    region?: string;
+}
+interface EmailServiceConfig {
+    /** Transport type – defaults to 'ses' */
+    transport?: 'smtp' | 'ses';
+    /** SMTP options (required when transport is 'smtp') */
+    smtp?: SMTPTransportConfig;
+    /** SES options (used when transport is 'ses') */
+    ses?: SESTransportConfig;
+    /** Email logging configuration – if omitted, logging is derived from env vars */
+    logging?: EmailLoggingConfig;
+    /** Enable nodemailer debug output */
+    debug?: boolean;
+}
 interface Email {
     to?: string | null;
     from?: string;
@@ -11,11 +45,38 @@ interface Email {
     attachments?: any[];
     subject: string;
 }
-declare const emailTransporter: (logger?: any) => {
+/**
+ * Create an email transporter.
+ *
+ * Accepts an optional {@link EmailServiceConfig} so callers can pass
+ * explicit configuration instead of relying on environment variables.
+ * Any value not provided in `config` falls back to the corresponding
+ * `process.env` variable, preserving full backward-compatibility.
+ */
+declare const emailTransporter: (logger?: any, config?: EmailServiceConfig) => {
     sendMail({ to, reference, from, replyTo, template, text, attachments, idempotencyKey, subject, }: Email, idempotentCheck?: boolean): Promise<nodemailer_lib_smtp_pool.SentMessageInfo | undefined>;
 };
 
 declare function renderTemplate(content: string, data: Record<string, any>): string;
 declare function renderTemplateFile(file: string, data: Record<string, any>): Promise<string>;
 
-export { type Email, emailTransporter, renderTemplate, renderTemplateFile };
+interface EmailLog {
+    reference?: string;
+    timestamp: number;
+    subject: string;
+    sender: string;
+    receiver: string;
+    idempotencyKey?: string;
+    status: 'success' | 'failed';
+    error?: string;
+}
+declare class EmailLogService {
+    private readonly tableName;
+    private readonly dynamoClient;
+    private readonly docClient;
+    constructor(loggingConfig?: EmailLoggingConfig);
+    logEmail({ subject, sender, receiver, status, error, idempotencyKey, reference, }: Omit<EmailLog, 'timestamp'>): Promise<string>;
+    getEmailByIdempotencyKey(idempotencyKey: string | undefined): Promise<EmailLog | null>;
+}
+
+export { type Email, EmailLogService, type EmailLoggingConfig, type EmailServiceConfig, type SESTransportConfig, type SMTPTransportConfig, emailTransporter, renderTemplate, renderTemplateFile };

package/dist/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  EmailLogService: () => EmailLogService,
   emailTransporter: () => emailTransporter,
   renderTemplate: () => renderTemplate,
   renderTemplateFile: () => renderTemplateFile
@@ -45,11 +46,11 @@ var import_client_dynamodb = require("@aws-sdk/client-dynamodb");
 var import_lib_dynamodb = require("@aws-sdk/lib-dynamodb");
 var import_uuid = require("uuid");
 var EmailLogService = class {
-  constructor() {
-    this.tableName = process.env.EMAIL_TABLE_NAME;
+  constructor(loggingConfig) {
+    this.tableName = loggingConfig?.tableName ?? process.env.EMAIL_TABLE_NAME;
     if (this.tableName) {
       this.dynamoClient = new import_client_dynamodb.DynamoDBClient({
-        region: process.env.AWS_REGION
+        region: loggingConfig?.region ?? process.env.AWS_REGION
       });
       this.docClient = import_lib_dynamodb.DynamoDBDocumentClient.from(this.dynamoClient);
     }
@@ -105,33 +106,48 @@ var EmailLogService = class {
 };
 
 // src/email.ts
-var sesClient = new import_client_sesv2.SESv2Client({
-  region: process.env.AWS_REGION
-});
-var emailOptions = process.env.EMAIL_TRANSPORT === "smtp" ? {
-  port: process.env.SMTP_PORT ? parseInt(process.env.SMTP_PORT, 10) : 587,
-  host: process.env.SMTP_HOST,
-  auth: process.env.SMTP_USER && process.env.SMTP_PASSWORD ? {
-    user: process.env.SMTP_USER,
-    pass: process.env.SMTP_PASSWORD
-  } : void 0
-} : {
-  SES: { sesClient, SendEmailCommand: import_client_sesv2.SendEmailCommand }
-};
-var emailTransporter = (logger = console) => {
+function resolveTransportType(config) {
+  if (config?.transport) return config.transport;
+  if (process.env.EMAIL_TRANSPORT === "smtp") return "smtp";
+  return "ses";
+}
+function buildTransportOptions(type, config) {
+  if (type === "smtp") {
+    const smtp = config?.smtp;
+    return {
+      port: smtp?.port ?? (process.env.SMTP_PORT ? parseInt(process.env.SMTP_PORT, 10) : 587),
+      host: smtp?.host ?? process.env.SMTP_HOST,
+      auth: smtp?.auth ?? (process.env.SMTP_USER && process.env.SMTP_PASSWORD ? { user: process.env.SMTP_USER, pass: process.env.SMTP_PASSWORD } : void 0)
+    };
+  }
+  const ses = config?.ses;
+  const sesClient = new import_client_sesv2.SESv2Client({
+    region: ses?.region ?? process.env.AWS_REGION,
+    ...ses?.credentials ? { credentials: ses.credentials } : {}
+  });
+  return { SES: { sesClient, SendEmailCommand: import_client_sesv2.SendEmailCommand } };
+}
+function buildDefaultOptions(type, config) {
+  if (type === "ses") {
+    const sourceArn = config?.ses?.sourceArn ?? process.env.EMAIL_SOURCE_ARN;
+    if (sourceArn) {
+      return { ses: { FromEmailAddressIdentityArn: sourceArn } };
+    }
+  }
+  return void 0;
+}
+var emailTransporter = (logger = console, config) => {
+  const type = resolveTransportType(config);
+  const transportOptions = buildTransportOptions(type, config);
+  const defaults = buildDefaultOptions(type, config);
   const transporter = import_nodemailer.default.createTransport(
     {
-      ...emailOptions,
-      debug: true
+      ...transportOptions,
+      debug: config?.debug ?? true
     },
-    {
-      ...process.env.EMAIL_SOURCE_ARN ? {
-        ses: {
-          FromEmailAddressIdentityArn: process.env.EMAIL_SOURCE_ARN
-        }
-      } : void 0
-    }
+    defaults ? defaults : void 0
   );
+  const emailLogService = new EmailLogService(config?.logging);
   return {
     async sendMail({
       to,
@@ -148,7 +164,6 @@ var emailTransporter = (logger = console) => {
         return;
       }
       const sender = from;
-      const emailLogService = new EmailLogService();
       logger.info(
         `Sending email to ${to} with subject: ${subject}, reference: ${reference}, idempotencyKey: ${idempotencyKey}`
       );
@@ -239,6 +254,7 @@ async function renderTemplateFile(file, data) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  EmailLogService,
   emailTransporter,
   renderTemplate,
   renderTemplateFile

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/email.ts","../src/email-log.ts","../src/template.ts"],"sourcesContent":["export * from './email';\nexport * from './template';\n","import { SendEmailCommand, SESv2Client } from '@aws-sdk/client-sesv2';\nimport nodemailer from 'nodemailer';\nimport { EmailLogService } from './email-log';\n\n/**\n * Template to use\n * await emailTransporter().sendMail({\n from: 'AusVie noreply<noreply@ausvie.com.au>',\n to: 'admin@ausvie.com.au',\n subject: 'Test', // Subject line\n text: 'Test text', // plaintext version\n html: `<div>${'Test text'}</div>`, // html version\n // attachments: [\n //     {\n //         filename,\n //         content: fileData,\n //     },\n // ],\n });\n */\n// Load the AWS SDK for Node.js\n// https://stackoverflow.com/questions/23042835/sending-mail-via-aws-ses-with-attachment-in-node-js\n\nconst sesClient = new SESv2Client({\n    region: process.env.AWS_REGION,\n});\n\nconst emailOptions =\n    process.env.EMAIL_TRANSPORT === 'smtp'\n        ? {\n              port: process.env.SMTP_PORT ? parseInt(process.env.SMTP_PORT, 10) : 587,\n              host: process.env.SMTP_HOST,\n              auth:\n                  process.env.SMTP_USER && process.env.SMTP_PASSWORD\n                      ? {\n                            user: process.env.SMTP_USER,\n                            pass: process.env.SMTP_PASSWORD,\n                        }\n                      : undefined,\n          }\n        : {\n              SES: { sesClient, SendEmailCommand },\n          };\n\nexport interface Email {\n    to?: string | null;\n    from?: string;\n    reference?: string;\n    template?: string;\n    idempotencyKey?: string;\n    replyTo?: string | null;\n    text?: string;\n    attachments?: any[];\n    subject: string;\n}\n\nexport const emailTransporter = (logger: any = console) => {\n    const transporter = nodemailer.createTransport(\n        {\n            ...emailOptions,\n            debug: true,\n        } as any,\n        {\n            ...(process.env.EMAIL_SOURCE_ARN\n                ? {\n                      ses: {\n                          FromEmailAddressIdentityArn: process.env.EMAIL_SOURCE_ARN!,\n                      },\n                  }\n                : undefined),\n        } as any\n    );\n\n    return {\n        async sendMail(\n            {\n                to,\n                reference,\n                from,\n                replyTo,\n                template,\n                text,\n                attachments = [],\n                idempotencyKey,\n                subject,\n            }: Email,\n            idempotentCheck?: boolean\n        ) {\n            if (!to) {\n                return;\n            }\n            const sender = from;\n            const emailLogService = new EmailLogService();\n            logger.info(\n                `Sending email to ${to} with subject: ${subject}, reference: ${reference}, idempotencyKey: ${idempotencyKey}`\n            );\n\n            try {\n                if (idempotentCheck) {\n                    const existingEmail =\n                        await emailLogService.getEmailByIdempotencyKey(idempotencyKey);\n                    if (existingEmail) {\n                        logger.info(`Email with idempotency key ${idempotencyKey} already sent`);\n                        return;\n                    }\n                }\n                const result = await transporter.sendMail({\n                    to,\n                    from: sender,\n                    replyTo: replyTo ?? undefined,\n                    html: template,\n                    text,\n                    subject,\n                    attachments,\n                });\n\n                // Log successful email\n                await emailLogService.logEmail({\n                    subject: subject || 'No Subject',\n                    reference,\n                    sender: sender || 'Unknown Sender',\n                    idempotencyKey,\n                    receiver: to,\n                    status: 'success',\n                });\n\n                return result;\n            } catch (error) {\n                // Log failed email\n                await emailLogService.logEmail({\n                    subject: subject || 'No Subject',\n                    sender: sender || 'Unknown Sender',\n                    receiver: to,\n                    status: 'failed',\n                    error: error instanceof Error ? error.message : String(error),\n                });\n\n                throw error;\n            }\n        },\n    };\n};\n","import { DynamoDBClient } from '@aws-sdk/client-dynamodb';\nimport { DynamoDBDocumentClient, PutCommand, QueryCommand } from '@aws-sdk/lib-dynamodb';\nimport { v4 as uuidv4 } from 'uuid';\n\ninterface EmailLog {\n    reference?: string;\n    timestamp: number;\n    subject: string;\n    sender: string;\n    receiver: string;\n    idempotencyKey?: string;\n    status: 'success' | 'failed';\n    error?: string;\n}\n\nexport class EmailLogService {\n    private readonly tableName: string;\n    private readonly dynamoClient: DynamoDBClient | undefined;\n    private readonly docClient: DynamoDBDocumentClient | undefined;\n\n    constructor() {\n        this.tableName = process.env.EMAIL_TABLE_NAME!;\n        if (this.tableName) {\n            this.dynamoClient = new DynamoDBClient({\n                region: process.env.AWS_REGION,\n            });\n            this.docClient = DynamoDBDocumentClient.from(this.dynamoClient);\n        }\n    }\n\n    async logEmail({\n        subject,\n        sender,\n        receiver,\n        status,\n        error,\n        idempotencyKey,\n        reference = uuidv4(),\n    }: Omit<EmailLog, 'timestamp'>): Promise<string> {\n        if (!this.docClient) {\n            return reference;\n        }\n        const timestamp = Date.now();\n\n        const log: EmailLog = {\n            reference,\n            timestamp,\n            subject,\n            sender,\n            receiver,\n            status,\n            idempotencyKey,\n            ...(error && { error }),\n        };\n\n        await this.docClient.send(\n            new PutCommand({\n                TableName: this.tableName,\n                Item: log,\n            })\n        );\n        return reference;\n    }\n\n    async getEmailByIdempotencyKey(idempotencyKey: string | undefined) {\n        if (!idempotencyKey || !this.docClient) {\n            return null;\n        }\n\n        const result = await this.docClient.send(\n            new QueryCommand({\n                TableName: this.tableName,\n                IndexName: 'idempotency-key-index',\n                KeyConditionExpression: 'idempotencyKey = :idempotencyKey',\n                ExpressionAttributeValues: {\n                    ':idempotencyKey': idempotencyKey,\n                },\n                Limit: 1,\n            })\n        );\n        return result.Items?.[0] as EmailLog | null;\n    }\n}\n","import fs from 'node:fs';\nimport { formatters, dates } from '@xcelsior/utils';\nimport handlebars from 'handlebars';\nimport _ from 'lodash';\nimport moment from 'moment';\n\nconst { getDateTime } = dates;\nconst { convertMoneyFormat, moneyFormat } = formatters;\n\nhandlebars.registerHelper('multiply', (a, b) => a * b);\n\nhandlebars.registerHelper('datetime', (a) => moment(getDateTime(a)).format('DD/MM/YYYY HH:mm'));\n\nhandlebars.registerHelper('moneyFormat', (a, ...others) => {\n    let currency = 'AUD' as const;\n    if (others.length > 1) {\n        currency = others[0] as any;\n    }\n    return moneyFormat(a, currency);\n});\n\nhandlebars.registerHelper('convertMoneyFormat', (amount, currency, rate = 1) =>\n    convertMoneyFormat(amount, currency, rate)\n);\n\nhandlebars.registerHelper('titleCase', (string) => {\n    if (!string) return '';\n    return _.startCase(_.camelCase(string)).replace(/\\s/g, ' ');\n});\n\nhandlebars.registerHelper('choose', (a, b) => (a ? a : b));\n\nhandlebars.registerHelper(\n    'phoneFormat',\n    (phone) =>\n        `${phone.substring(0, phone.length / 2 - 2)}****${phone.substring(phone.length / 2 + 2)}`\n);\n\nhandlebars.registerHelper('title', (title) => _.startCase(title));\n\nhandlebars.registerHelper('eq', (a, b) => a === b);\nhandlebars.registerHelper('lowercase', (title: string) => title.toLowerCase());\n\nhandlebars.registerHelper('JSONparse', (string, key) => JSON.parse(string)[key]);\n\nhandlebars.registerHelper('incr', (a) => a + 1);\n\nhandlebars.registerHelper('gt', (a, b) => a > b);\n\nexport function renderTemplate(content: string, data: Record<string, any>): string {\n    return handlebars.compile(content)(data);\n}\n\nexport async function renderTemplateFile(file: string, data: Record<string, any>) {\n    const content = await fs.promises.readFile(file, {\n        encoding: 'utf-8',\n    });\n    return renderTemplate(content, data);\n}\n"],"mappings":"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","names":["uuidv4","nodemailer","handlebars","moment","_","fs"]}
+{"version":3,"sources":["../src/index.ts","../src/email.ts","../src/email-log.ts","../src/template.ts"],"sourcesContent":["export * from './email';\nexport * from './template';\nexport { EmailLogService } from './email-log';\n","import { SendEmailCommand, SESv2Client } from '@aws-sdk/client-sesv2';\nimport nodemailer from 'nodemailer';\nimport { EmailLogService } from './email-log';\n\n// ─── Configuration types ───────────────────────────────────────────\n\nexport interface SMTPTransportConfig {\n    host: string;\n    port?: number;\n    auth?: {\n        user: string;\n        pass: string;\n    };\n}\n\nexport interface SESTransportConfig {\n    region?: string;\n    sourceArn?: string;\n    credentials?: {\n        accessKeyId: string;\n        secretAccessKey: string;\n    };\n}\n\nexport interface EmailLoggingConfig {\n    /** DynamoDB table name for email logs */\n    tableName: string;\n    /** AWS region for the logging table */\n    region?: string;\n}\n\nexport interface EmailServiceConfig {\n    /** Transport type – defaults to 'ses' */\n    transport?: 'smtp' | 'ses';\n    /** SMTP options (required when transport is 'smtp') */\n    smtp?: SMTPTransportConfig;\n    /** SES options (used when transport is 'ses') */\n    ses?: SESTransportConfig;\n    /** Email logging configuration – if omitted, logging is derived from env vars */\n    logging?: EmailLoggingConfig;\n    /** Enable nodemailer debug output */\n    debug?: boolean;\n}\n\n// ─── Email payload ─────────────────────────────────────────────────\n\nexport interface Email {\n    to?: string | null;\n    from?: string;\n    reference?: string;\n    template?: string;\n    idempotencyKey?: string;\n    replyTo?: string | null;\n    text?: string;\n    attachments?: any[];\n    subject: string;\n}\n\n// ─── Internal helpers ──────────────────────────────────────────────\n\nfunction resolveTransportType(config?: EmailServiceConfig): 'smtp' | 'ses' {\n    if (config?.transport) return config.transport;\n    if (process.env.EMAIL_TRANSPORT === 'smtp') return 'smtp';\n    return 'ses';\n}\n\nfunction buildTransportOptions(type: 'smtp' | 'ses', config?: EmailServiceConfig) {\n    if (type === 'smtp') {\n        const smtp = config?.smtp;\n        return {\n            port: smtp?.port ?? (process.env.SMTP_PORT ? parseInt(process.env.SMTP_PORT, 10) : 587),\n            host: smtp?.host ?? process.env.SMTP_HOST,\n            auth:\n                smtp?.auth ??\n                (process.env.SMTP_USER && process.env.SMTP_PASSWORD\n                    ? { user: process.env.SMTP_USER, pass: process.env.SMTP_PASSWORD }\n                    : undefined),\n        };\n    }\n\n    const ses = config?.ses;\n    const sesClient = new SESv2Client({\n        region: ses?.region ?? process.env.AWS_REGION,\n        ...(ses?.credentials ? { credentials: ses.credentials } : {}),\n    });\n    return { SES: { sesClient, SendEmailCommand } };\n}\n\nfunction buildDefaultOptions(type: 'smtp' | 'ses', config?: EmailServiceConfig) {\n    if (type === 'ses') {\n        const sourceArn = config?.ses?.sourceArn ?? process.env.EMAIL_SOURCE_ARN;\n        if (sourceArn) {\n            return { ses: { FromEmailAddressIdentityArn: sourceArn } };\n        }\n    }\n    return undefined;\n}\n\n// ─── Public API ────────────────────────────────────────────────────\n\n/**\n * Create an email transporter.\n *\n * Accepts an optional {@link EmailServiceConfig} so callers can pass\n * explicit configuration instead of relying on environment variables.\n * Any value not provided in `config` falls back to the corresponding\n * `process.env` variable, preserving full backward-compatibility.\n */\nexport const emailTransporter = (logger: any = console, config?: EmailServiceConfig) => {\n    const type = resolveTransportType(config);\n    const transportOptions = buildTransportOptions(type, config);\n    const defaults = buildDefaultOptions(type, config);\n\n    const transporter = nodemailer.createTransport(\n        {\n            ...transportOptions,\n            debug: config?.debug ?? true,\n        } as any,\n        defaults ? (defaults as any) : undefined\n    );\n\n    const emailLogService = new EmailLogService(config?.logging);\n\n    return {\n        async sendMail(\n            {\n                to,\n                reference,\n                from,\n                replyTo,\n                template,\n                text,\n                attachments = [],\n                idempotencyKey,\n                subject,\n            }: Email,\n            idempotentCheck?: boolean\n        ) {\n            if (!to) {\n                return;\n            }\n            const sender = from;\n            logger.info(\n                `Sending email to ${to} with subject: ${subject}, reference: ${reference}, idempotencyKey: ${idempotencyKey}`\n            );\n\n            try {\n                if (idempotentCheck) {\n                    const existingEmail =\n                        await emailLogService.getEmailByIdempotencyKey(idempotencyKey);\n                    if (existingEmail) {\n                        logger.info(`Email with idempotency key ${idempotencyKey} already sent`);\n                        return;\n                    }\n                }\n                const result = await transporter.sendMail({\n                    to,\n                    from: sender,\n                    replyTo: replyTo ?? undefined,\n                    html: template,\n                    text,\n                    subject,\n                    attachments,\n                });\n\n                // Log successful email\n                await emailLogService.logEmail({\n                    subject: subject || 'No Subject',\n                    reference,\n                    sender: sender || 'Unknown Sender',\n                    idempotencyKey,\n                    receiver: to,\n                    status: 'success',\n                });\n\n                return result;\n            } catch (error) {\n                // Log failed email\n                await emailLogService.logEmail({\n                    subject: subject || 'No Subject',\n                    sender: sender || 'Unknown Sender',\n                    receiver: to,\n                    status: 'failed',\n                    error: error instanceof Error ? error.message : String(error),\n                });\n\n                throw error;\n            }\n        },\n    };\n};\n","import { DynamoDBClient } from '@aws-sdk/client-dynamodb';\nimport { DynamoDBDocumentClient, PutCommand, QueryCommand } from '@aws-sdk/lib-dynamodb';\nimport { v4 as uuidv4 } from 'uuid';\nimport type { EmailLoggingConfig } from './email';\n\ninterface EmailLog {\n    reference?: string;\n    timestamp: number;\n    subject: string;\n    sender: string;\n    receiver: string;\n    idempotencyKey?: string;\n    status: 'success' | 'failed';\n    error?: string;\n}\n\nexport class EmailLogService {\n    private readonly tableName: string;\n    private readonly dynamoClient: DynamoDBClient | undefined;\n    private readonly docClient: DynamoDBDocumentClient | undefined;\n\n    constructor(loggingConfig?: EmailLoggingConfig) {\n        this.tableName = loggingConfig?.tableName ?? process.env.EMAIL_TABLE_NAME!;\n        if (this.tableName) {\n            this.dynamoClient = new DynamoDBClient({\n                region: loggingConfig?.region ?? process.env.AWS_REGION,\n            });\n            this.docClient = DynamoDBDocumentClient.from(this.dynamoClient);\n        }\n    }\n\n    async logEmail({\n        subject,\n        sender,\n        receiver,\n        status,\n        error,\n        idempotencyKey,\n        reference = uuidv4(),\n    }: Omit<EmailLog, 'timestamp'>): Promise<string> {\n        if (!this.docClient) {\n            return reference;\n        }\n        const timestamp = Date.now();\n\n        const log: EmailLog = {\n            reference,\n            timestamp,\n            subject,\n            sender,\n            receiver,\n            status,\n            idempotencyKey,\n            ...(error && { error }),\n        };\n\n        await this.docClient.send(\n            new PutCommand({\n                TableName: this.tableName,\n                Item: log,\n            })\n        );\n        return reference;\n    }\n\n    async getEmailByIdempotencyKey(idempotencyKey: string | undefined) {\n        if (!idempotencyKey || !this.docClient) {\n            return null;\n        }\n\n        const result = await this.docClient.send(\n            new QueryCommand({\n                TableName: this.tableName,\n                IndexName: 'idempotency-key-index',\n                KeyConditionExpression: 'idempotencyKey = :idempotencyKey',\n                ExpressionAttributeValues: {\n                    ':idempotencyKey': idempotencyKey,\n                },\n                Limit: 1,\n            })\n        );\n        return result.Items?.[0] as EmailLog | null;\n    }\n}\n","import fs from 'node:fs';\nimport { formatters, dates } from '@xcelsior/utils';\nimport handlebars from 'handlebars';\nimport _ from 'lodash';\nimport moment from 'moment';\n\nconst { getDateTime } = dates;\nconst { convertMoneyFormat, moneyFormat } = formatters;\n\nhandlebars.registerHelper('multiply', (a, b) => a * b);\n\nhandlebars.registerHelper('datetime', (a) => moment(getDateTime(a)).format('DD/MM/YYYY HH:mm'));\n\nhandlebars.registerHelper('moneyFormat', (a, ...others) => {\n    let currency = 'AUD' as const;\n    if (others.length > 1) {\n        currency = others[0] as any;\n    }\n    return moneyFormat(a, currency);\n});\n\nhandlebars.registerHelper('convertMoneyFormat', (amount, currency, rate = 1) =>\n    convertMoneyFormat(amount, currency, rate)\n);\n\nhandlebars.registerHelper('titleCase', (string) => {\n    if (!string) return '';\n    return _.startCase(_.camelCase(string)).replace(/\\s/g, ' ');\n});\n\nhandlebars.registerHelper('choose', (a, b) => (a ? a : b));\n\nhandlebars.registerHelper(\n    'phoneFormat',\n    (phone) =>\n        `${phone.substring(0, phone.length / 2 - 2)}****${phone.substring(phone.length / 2 + 2)}`\n);\n\nhandlebars.registerHelper('title', (title) => _.startCase(title));\n\nhandlebars.registerHelper('eq', (a, b) => a === b);\nhandlebars.registerHelper('lowercase', (title: string) => title.toLowerCase());\n\nhandlebars.registerHelper('JSONparse', (string, key) => JSON.parse(string)[key]);\n\nhandlebars.registerHelper('incr', (a) => a + 1);\n\nhandlebars.registerHelper('gt', (a, b) => a > b);\n\nexport function renderTemplate(content: string, data: Record<string, any>): string {\n    return handlebars.compile(content)(data);\n}\n\nexport async function renderTemplateFile(file: string, data: Record<string, any>) {\n    const content = await fs.promises.readFile(file, {\n        encoding: 'utf-8',\n    });\n    return renderTemplate(content, data);\n}\n"],"mappings":"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","names":["uuidv4","nodemailer","handlebars","moment","_","fs"]}

package/dist/index.mjs

@@ -7,11 +7,11 @@ import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
 import { DynamoDBDocumentClient, PutCommand, QueryCommand } from "@aws-sdk/lib-dynamodb";
 import { v4 as uuidv4 } from "uuid";
 var EmailLogService = class {
-  constructor() {
-    this.tableName = process.env.EMAIL_TABLE_NAME;
+  constructor(loggingConfig) {
+    this.tableName = loggingConfig?.tableName ?? process.env.EMAIL_TABLE_NAME;
     if (this.tableName) {
       this.dynamoClient = new DynamoDBClient({
-        region: process.env.AWS_REGION
+        region: loggingConfig?.region ?? process.env.AWS_REGION
       });
       this.docClient = DynamoDBDocumentClient.from(this.dynamoClient);
     }
@@ -67,33 +67,48 @@ var EmailLogService = class {
 };
 
 // src/email.ts
-var sesClient = new SESv2Client({
-  region: process.env.AWS_REGION
-});
-var emailOptions = process.env.EMAIL_TRANSPORT === "smtp" ? {
-  port: process.env.SMTP_PORT ? parseInt(process.env.SMTP_PORT, 10) : 587,
-  host: process.env.SMTP_HOST,
-  auth: process.env.SMTP_USER && process.env.SMTP_PASSWORD ? {
-    user: process.env.SMTP_USER,
-    pass: process.env.SMTP_PASSWORD
-  } : void 0
-} : {
-  SES: { sesClient, SendEmailCommand }
-};
-var emailTransporter = (logger = console) => {
+function resolveTransportType(config) {
+  if (config?.transport) return config.transport;
+  if (process.env.EMAIL_TRANSPORT === "smtp") return "smtp";
+  return "ses";
+}
+function buildTransportOptions(type, config) {
+  if (type === "smtp") {
+    const smtp = config?.smtp;
+    return {
+      port: smtp?.port ?? (process.env.SMTP_PORT ? parseInt(process.env.SMTP_PORT, 10) : 587),
+      host: smtp?.host ?? process.env.SMTP_HOST,
+      auth: smtp?.auth ?? (process.env.SMTP_USER && process.env.SMTP_PASSWORD ? { user: process.env.SMTP_USER, pass: process.env.SMTP_PASSWORD } : void 0)
+    };
+  }
+  const ses = config?.ses;
+  const sesClient = new SESv2Client({
+    region: ses?.region ?? process.env.AWS_REGION,
+    ...ses?.credentials ? { credentials: ses.credentials } : {}
+  });
+  return { SES: { sesClient, SendEmailCommand } };
+}
+function buildDefaultOptions(type, config) {
+  if (type === "ses") {
+    const sourceArn = config?.ses?.sourceArn ?? process.env.EMAIL_SOURCE_ARN;
+    if (sourceArn) {
+      return { ses: { FromEmailAddressIdentityArn: sourceArn } };
+    }
+  }
+  return void 0;
+}
+var emailTransporter = (logger = console, config) => {
+  const type = resolveTransportType(config);
+  const transportOptions = buildTransportOptions(type, config);
+  const defaults = buildDefaultOptions(type, config);
   const transporter = nodemailer.createTransport(
     {
-      ...emailOptions,
-      debug: true
+      ...transportOptions,
+      debug: config?.debug ?? true
     },
-    {
-      ...process.env.EMAIL_SOURCE_ARN ? {
-        ses: {
-          FromEmailAddressIdentityArn: process.env.EMAIL_SOURCE_ARN
-        }
-      } : void 0
-    }
+    defaults ? defaults : void 0
   );
+  const emailLogService = new EmailLogService(config?.logging);
   return {
     async sendMail({
       to,
@@ -110,7 +125,6 @@ var emailTransporter = (logger = console) => {
         return;
       }
       const sender = from;
-      const emailLogService = new EmailLogService();
       logger.info(
         `Sending email to ${to} with subject: ${subject}, reference: ${reference}, idempotencyKey: ${idempotencyKey}`
       );
@@ -200,6 +214,7 @@ async function renderTemplateFile(file, data) {
   return renderTemplate(content, data);
 }
 export {
+  EmailLogService,
   emailTransporter,
   renderTemplate,
   renderTemplateFile

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/email.ts","../src/email-log.ts","../src/template.ts"],"sourcesContent":["import { SendEmailCommand, SESv2Client } from '@aws-sdk/client-sesv2';\nimport nodemailer from 'nodemailer';\nimport { EmailLogService } from './email-log';\n\n/**\n * Template to use\n * await emailTransporter().sendMail({\n from: 'AusVie noreply<noreply@ausvie.com.au>',\n to: 'admin@ausvie.com.au',\n subject: 'Test', // Subject line\n text: 'Test text', // plaintext version\n html: `<div>${'Test text'}</div>`, // html version\n // attachments: [\n //     {\n //         filename,\n //         content: fileData,\n //     },\n // ],\n });\n */\n// Load the AWS SDK for Node.js\n// https://stackoverflow.com/questions/23042835/sending-mail-via-aws-ses-with-attachment-in-node-js\n\nconst sesClient = new SESv2Client({\n    region: process.env.AWS_REGION,\n});\n\nconst emailOptions =\n    process.env.EMAIL_TRANSPORT === 'smtp'\n        ? {\n              port: process.env.SMTP_PORT ? parseInt(process.env.SMTP_PORT, 10) : 587,\n              host: process.env.SMTP_HOST,\n              auth:\n                  process.env.SMTP_USER && process.env.SMTP_PASSWORD\n                      ? {\n                            user: process.env.SMTP_USER,\n                            pass: process.env.SMTP_PASSWORD,\n                        }\n                      : undefined,\n          }\n        : {\n              SES: { sesClient, SendEmailCommand },\n          };\n\nexport interface Email {\n    to?: string | null;\n    from?: string;\n    reference?: string;\n    template?: string;\n    idempotencyKey?: string;\n    replyTo?: string | null;\n    text?: string;\n    attachments?: any[];\n    subject: string;\n}\n\nexport const emailTransporter = (logger: any = console) => {\n    const transporter = nodemailer.createTransport(\n        {\n            ...emailOptions,\n            debug: true,\n        } as any,\n        {\n            ...(process.env.EMAIL_SOURCE_ARN\n                ? {\n                      ses: {\n                          FromEmailAddressIdentityArn: process.env.EMAIL_SOURCE_ARN!,\n                      },\n                  }\n                : undefined),\n        } as any\n    );\n\n    return {\n        async sendMail(\n            {\n                to,\n                reference,\n                from,\n                replyTo,\n                template,\n                text,\n                attachments = [],\n                idempotencyKey,\n                subject,\n            }: Email,\n            idempotentCheck?: boolean\n        ) {\n            if (!to) {\n                return;\n            }\n            const sender = from;\n            const emailLogService = new EmailLogService();\n            logger.info(\n                `Sending email to ${to} with subject: ${subject}, reference: ${reference}, idempotencyKey: ${idempotencyKey}`\n            );\n\n            try {\n                if (idempotentCheck) {\n                    const existingEmail =\n                        await emailLogService.getEmailByIdempotencyKey(idempotencyKey);\n                    if (existingEmail) {\n                        logger.info(`Email with idempotency key ${idempotencyKey} already sent`);\n                        return;\n                    }\n                }\n                const result = await transporter.sendMail({\n                    to,\n                    from: sender,\n                    replyTo: replyTo ?? undefined,\n                    html: template,\n                    text,\n                    subject,\n                    attachments,\n                });\n\n                // Log successful email\n                await emailLogService.logEmail({\n                    subject: subject || 'No Subject',\n                    reference,\n                    sender: sender || 'Unknown Sender',\n                    idempotencyKey,\n                    receiver: to,\n                    status: 'success',\n                });\n\n                return result;\n            } catch (error) {\n                // Log failed email\n                await emailLogService.logEmail({\n                    subject: subject || 'No Subject',\n                    sender: sender || 'Unknown Sender',\n                    receiver: to,\n                    status: 'failed',\n                    error: error instanceof Error ? error.message : String(error),\n                });\n\n                throw error;\n            }\n        },\n    };\n};\n","import { DynamoDBClient } from '@aws-sdk/client-dynamodb';\nimport { DynamoDBDocumentClient, PutCommand, QueryCommand } from '@aws-sdk/lib-dynamodb';\nimport { v4 as uuidv4 } from 'uuid';\n\ninterface EmailLog {\n    reference?: string;\n    timestamp: number;\n    subject: string;\n    sender: string;\n    receiver: string;\n    idempotencyKey?: string;\n    status: 'success' | 'failed';\n    error?: string;\n}\n\nexport class EmailLogService {\n    private readonly tableName: string;\n    private readonly dynamoClient: DynamoDBClient | undefined;\n    private readonly docClient: DynamoDBDocumentClient | undefined;\n\n    constructor() {\n        this.tableName = process.env.EMAIL_TABLE_NAME!;\n        if (this.tableName) {\n            this.dynamoClient = new DynamoDBClient({\n                region: process.env.AWS_REGION,\n            });\n            this.docClient = DynamoDBDocumentClient.from(this.dynamoClient);\n        }\n    }\n\n    async logEmail({\n        subject,\n        sender,\n        receiver,\n        status,\n        error,\n        idempotencyKey,\n        reference = uuidv4(),\n    }: Omit<EmailLog, 'timestamp'>): Promise<string> {\n        if (!this.docClient) {\n            return reference;\n        }\n        const timestamp = Date.now();\n\n        const log: EmailLog = {\n            reference,\n            timestamp,\n            subject,\n            sender,\n            receiver,\n            status,\n            idempotencyKey,\n            ...(error && { error }),\n        };\n\n        await this.docClient.send(\n            new PutCommand({\n                TableName: this.tableName,\n                Item: log,\n            })\n        );\n        return reference;\n    }\n\n    async getEmailByIdempotencyKey(idempotencyKey: string | undefined) {\n        if (!idempotencyKey || !this.docClient) {\n            return null;\n        }\n\n        const result = await this.docClient.send(\n            new QueryCommand({\n                TableName: this.tableName,\n                IndexName: 'idempotency-key-index',\n                KeyConditionExpression: 'idempotencyKey = :idempotencyKey',\n                ExpressionAttributeValues: {\n                    ':idempotencyKey': idempotencyKey,\n                },\n                Limit: 1,\n            })\n        );\n        return result.Items?.[0] as EmailLog | null;\n    }\n}\n","import fs from 'node:fs';\nimport { formatters, dates } from '@xcelsior/utils';\nimport handlebars from 'handlebars';\nimport _ from 'lodash';\nimport moment from 'moment';\n\nconst { getDateTime } = dates;\nconst { convertMoneyFormat, moneyFormat } = formatters;\n\nhandlebars.registerHelper('multiply', (a, b) => a * b);\n\nhandlebars.registerHelper('datetime', (a) => moment(getDateTime(a)).format('DD/MM/YYYY HH:mm'));\n\nhandlebars.registerHelper('moneyFormat', (a, ...others) => {\n    let currency = 'AUD' as const;\n    if (others.length > 1) {\n        currency = others[0] as any;\n    }\n    return moneyFormat(a, currency);\n});\n\nhandlebars.registerHelper('convertMoneyFormat', (amount, currency, rate = 1) =>\n    convertMoneyFormat(amount, currency, rate)\n);\n\nhandlebars.registerHelper('titleCase', (string) => {\n    if (!string) return '';\n    return _.startCase(_.camelCase(string)).replace(/\\s/g, ' ');\n});\n\nhandlebars.registerHelper('choose', (a, b) => (a ? a : b));\n\nhandlebars.registerHelper(\n    'phoneFormat',\n    (phone) =>\n        `${phone.substring(0, phone.length / 2 - 2)}****${phone.substring(phone.length / 2 + 2)}`\n);\n\nhandlebars.registerHelper('title', (title) => _.startCase(title));\n\nhandlebars.registerHelper('eq', (a, b) => a === b);\nhandlebars.registerHelper('lowercase', (title: string) => title.toLowerCase());\n\nhandlebars.registerHelper('JSONparse', (string, key) => JSON.parse(string)[key]);\n\nhandlebars.registerHelper('incr', (a) => a + 1);\n\nhandlebars.registerHelper('gt', (a, b) => a > b);\n\nexport function renderTemplate(content: string, data: Record<string, any>): string {\n    return handlebars.compile(content)(data);\n}\n\nexport async function renderTemplateFile(file: string, data: Record<string, any>) {\n    const content = await fs.promises.readFile(file, {\n        encoding: 'utf-8',\n    });\n    return renderTemplate(content, data);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/email.ts","../src/email-log.ts","../src/template.ts"],"sourcesContent":["import { SendEmailCommand, SESv2Client } from '@aws-sdk/client-sesv2';\nimport nodemailer from 'nodemailer';\nimport { EmailLogService } from './email-log';\n\n// ─── Configuration types ───────────────────────────────────────────\n\nexport interface SMTPTransportConfig {\n    host: string;\n    port?: number;\n    auth?: {\n        user: string;\n        pass: string;\n    };\n}\n\nexport interface SESTransportConfig {\n    region?: string;\n    sourceArn?: string;\n    credentials?: {\n        accessKeyId: string;\n        secretAccessKey: string;\n    };\n}\n\nexport interface EmailLoggingConfig {\n    /** DynamoDB table name for email logs */\n    tableName: string;\n    /** AWS region for the logging table */\n    region?: string;\n}\n\nexport interface EmailServiceConfig {\n    /** Transport type – defaults to 'ses' */\n    transport?: 'smtp' | 'ses';\n    /** SMTP options (required when transport is 'smtp') */\n    smtp?: SMTPTransportConfig;\n    /** SES options (used when transport is 'ses') */\n    ses?: SESTransportConfig;\n    /** Email logging configuration – if omitted, logging is derived from env vars */\n    logging?: EmailLoggingConfig;\n    /** Enable nodemailer debug output */\n    debug?: boolean;\n}\n\n// ─── Email payload ─────────────────────────────────────────────────\n\nexport interface Email {\n    to?: string | null;\n    from?: string;\n    reference?: string;\n    template?: string;\n    idempotencyKey?: string;\n    replyTo?: string | null;\n    text?: string;\n    attachments?: any[];\n    subject: string;\n}\n\n// ─── Internal helpers ──────────────────────────────────────────────\n\nfunction resolveTransportType(config?: EmailServiceConfig): 'smtp' | 'ses' {\n    if (config?.transport) return config.transport;\n    if (process.env.EMAIL_TRANSPORT === 'smtp') return 'smtp';\n    return 'ses';\n}\n\nfunction buildTransportOptions(type: 'smtp' | 'ses', config?: EmailServiceConfig) {\n    if (type === 'smtp') {\n        const smtp = config?.smtp;\n        return {\n            port: smtp?.port ?? (process.env.SMTP_PORT ? parseInt(process.env.SMTP_PORT, 10) : 587),\n            host: smtp?.host ?? process.env.SMTP_HOST,\n            auth:\n                smtp?.auth ??\n                (process.env.SMTP_USER && process.env.SMTP_PASSWORD\n                    ? { user: process.env.SMTP_USER, pass: process.env.SMTP_PASSWORD }\n                    : undefined),\n        };\n    }\n\n    const ses = config?.ses;\n    const sesClient = new SESv2Client({\n        region: ses?.region ?? process.env.AWS_REGION,\n        ...(ses?.credentials ? { credentials: ses.credentials } : {}),\n    });\n    return { SES: { sesClient, SendEmailCommand } };\n}\n\nfunction buildDefaultOptions(type: 'smtp' | 'ses', config?: EmailServiceConfig) {\n    if (type === 'ses') {\n        const sourceArn = config?.ses?.sourceArn ?? process.env.EMAIL_SOURCE_ARN;\n        if (sourceArn) {\n            return { ses: { FromEmailAddressIdentityArn: sourceArn } };\n        }\n    }\n    return undefined;\n}\n\n// ─── Public API ────────────────────────────────────────────────────\n\n/**\n * Create an email transporter.\n *\n * Accepts an optional {@link EmailServiceConfig} so callers can pass\n * explicit configuration instead of relying on environment variables.\n * Any value not provided in `config` falls back to the corresponding\n * `process.env` variable, preserving full backward-compatibility.\n */\nexport const emailTransporter = (logger: any = console, config?: EmailServiceConfig) => {\n    const type = resolveTransportType(config);\n    const transportOptions = buildTransportOptions(type, config);\n    const defaults = buildDefaultOptions(type, config);\n\n    const transporter = nodemailer.createTransport(\n        {\n            ...transportOptions,\n            debug: config?.debug ?? true,\n        } as any,\n        defaults ? (defaults as any) : undefined\n    );\n\n    const emailLogService = new EmailLogService(config?.logging);\n\n    return {\n        async sendMail(\n            {\n                to,\n                reference,\n                from,\n                replyTo,\n                template,\n                text,\n                attachments = [],\n                idempotencyKey,\n                subject,\n            }: Email,\n            idempotentCheck?: boolean\n        ) {\n            if (!to) {\n                return;\n            }\n            const sender = from;\n            logger.info(\n                `Sending email to ${to} with subject: ${subject}, reference: ${reference}, idempotencyKey: ${idempotencyKey}`\n            );\n\n            try {\n                if (idempotentCheck) {\n                    const existingEmail =\n                        await emailLogService.getEmailByIdempotencyKey(idempotencyKey);\n                    if (existingEmail) {\n                        logger.info(`Email with idempotency key ${idempotencyKey} already sent`);\n                        return;\n                    }\n                }\n                const result = await transporter.sendMail({\n                    to,\n                    from: sender,\n                    replyTo: replyTo ?? undefined,\n                    html: template,\n                    text,\n                    subject,\n                    attachments,\n                });\n\n                // Log successful email\n                await emailLogService.logEmail({\n                    subject: subject || 'No Subject',\n                    reference,\n                    sender: sender || 'Unknown Sender',\n                    idempotencyKey,\n                    receiver: to,\n                    status: 'success',\n                });\n\n                return result;\n            } catch (error) {\n                // Log failed email\n                await emailLogService.logEmail({\n                    subject: subject || 'No Subject',\n                    sender: sender || 'Unknown Sender',\n                    receiver: to,\n                    status: 'failed',\n                    error: error instanceof Error ? error.message : String(error),\n                });\n\n                throw error;\n            }\n        },\n    };\n};\n","import { DynamoDBClient } from '@aws-sdk/client-dynamodb';\nimport { DynamoDBDocumentClient, PutCommand, QueryCommand } from '@aws-sdk/lib-dynamodb';\nimport { v4 as uuidv4 } from 'uuid';\nimport type { EmailLoggingConfig } from './email';\n\ninterface EmailLog {\n    reference?: string;\n    timestamp: number;\n    subject: string;\n    sender: string;\n    receiver: string;\n    idempotencyKey?: string;\n    status: 'success' | 'failed';\n    error?: string;\n}\n\nexport class EmailLogService {\n    private readonly tableName: string;\n    private readonly dynamoClient: DynamoDBClient | undefined;\n    private readonly docClient: DynamoDBDocumentClient | undefined;\n\n    constructor(loggingConfig?: EmailLoggingConfig) {\n        this.tableName = loggingConfig?.tableName ?? process.env.EMAIL_TABLE_NAME!;\n        if (this.tableName) {\n            this.dynamoClient = new DynamoDBClient({\n                region: loggingConfig?.region ?? process.env.AWS_REGION,\n            });\n            this.docClient = DynamoDBDocumentClient.from(this.dynamoClient);\n        }\n    }\n\n    async logEmail({\n        subject,\n        sender,\n        receiver,\n        status,\n        error,\n        idempotencyKey,\n        reference = uuidv4(),\n    }: Omit<EmailLog, 'timestamp'>): Promise<string> {\n        if (!this.docClient) {\n            return reference;\n        }\n        const timestamp = Date.now();\n\n        const log: EmailLog = {\n            reference,\n            timestamp,\n            subject,\n            sender,\n            receiver,\n            status,\n            idempotencyKey,\n            ...(error && { error }),\n        };\n\n        await this.docClient.send(\n            new PutCommand({\n                TableName: this.tableName,\n                Item: log,\n            })\n        );\n        return reference;\n    }\n\n    async getEmailByIdempotencyKey(idempotencyKey: string | undefined) {\n        if (!idempotencyKey || !this.docClient) {\n            return null;\n        }\n\n        const result = await this.docClient.send(\n            new QueryCommand({\n                TableName: this.tableName,\n                IndexName: 'idempotency-key-index',\n                KeyConditionExpression: 'idempotencyKey = :idempotencyKey',\n                ExpressionAttributeValues: {\n                    ':idempotencyKey': idempotencyKey,\n                },\n                Limit: 1,\n            })\n        );\n        return result.Items?.[0] as EmailLog | null;\n    }\n}\n","import fs from 'node:fs';\nimport { formatters, dates } from '@xcelsior/utils';\nimport handlebars from 'handlebars';\nimport _ from 'lodash';\nimport moment from 'moment';\n\nconst { getDateTime } = dates;\nconst { convertMoneyFormat, moneyFormat } = formatters;\n\nhandlebars.registerHelper('multiply', (a, b) => a * b);\n\nhandlebars.registerHelper('datetime', (a) => moment(getDateTime(a)).format('DD/MM/YYYY HH:mm'));\n\nhandlebars.registerHelper('moneyFormat', (a, ...others) => {\n    let currency = 'AUD' as const;\n    if (others.length > 1) {\n        currency = others[0] as any;\n    }\n    return moneyFormat(a, currency);\n});\n\nhandlebars.registerHelper('convertMoneyFormat', (amount, currency, rate = 1) =>\n    convertMoneyFormat(amount, currency, rate)\n);\n\nhandlebars.registerHelper('titleCase', (string) => {\n    if (!string) return '';\n    return _.startCase(_.camelCase(string)).replace(/\\s/g, ' ');\n});\n\nhandlebars.registerHelper('choose', (a, b) => (a ? a : b));\n\nhandlebars.registerHelper(\n    'phoneFormat',\n    (phone) =>\n        `${phone.substring(0, phone.length / 2 - 2)}****${phone.substring(phone.length / 2 + 2)}`\n);\n\nhandlebars.registerHelper('title', (title) => _.startCase(title));\n\nhandlebars.registerHelper('eq', (a, b) => a === b);\nhandlebars.registerHelper('lowercase', (title: string) => title.toLowerCase());\n\nhandlebars.registerHelper('JSONparse', (string, key) => JSON.parse(string)[key]);\n\nhandlebars.registerHelper('incr', (a) => a + 1);\n\nhandlebars.registerHelper('gt', (a, b) => a > b);\n\nexport function renderTemplate(content: string, data: Record<string, any>): string {\n    return handlebars.compile(content)(data);\n}\n\nexport async function renderTemplateFile(file: string, data: Record<string, any>) {\n    const content = await fs.promises.readFile(file, {\n        encoding: 'utf-8',\n    });\n    return renderTemplate(content, data);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xcelsior/email",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "exports": {
     ".": {
       "import": "./src/index.ts",
@@ -23,7 +23,7 @@
     "nodemailer": "^7.0.4",
     "@aws-sdk/client-sesv2": "^3.888.0",
     "uuid": "^11.1.0",
-    "@xcelsior/utils": "1.0.0"
+    "@xcelsior/utils": "1.0.1"
   },
   "devDependencies": {
     "@types/lodash": "^4.17.20",

package/src/email-log.ts

@@ -1,6 +1,7 @@
 import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
 import { DynamoDBDocumentClient, PutCommand, QueryCommand } from '@aws-sdk/lib-dynamodb';
 import { v4 as uuidv4 } from 'uuid';
+import type { EmailLoggingConfig } from './email';
 
 interface EmailLog {
     reference?: string;
@@ -18,11 +19,11 @@ export class EmailLogService {
     private readonly dynamoClient: DynamoDBClient | undefined;
     private readonly docClient: DynamoDBDocumentClient | undefined;
 
-    constructor() {
-        this.tableName = process.env.EMAIL_TABLE_NAME!;
+    constructor(loggingConfig?: EmailLoggingConfig) {
+        this.tableName = loggingConfig?.tableName ?? process.env.EMAIL_TABLE_NAME!;
         if (this.tableName) {
             this.dynamoClient = new DynamoDBClient({
-                region: process.env.AWS_REGION,
+                region: loggingConfig?.region ?? process.env.AWS_REGION,
             });
             this.docClient = DynamoDBDocumentClient.from(this.dynamoClient);
         }

package/src/email.ts

@@ -2,45 +2,47 @@ import { SendEmailCommand, SESv2Client } from '@aws-sdk/client-sesv2';
 import nodemailer from 'nodemailer';
 import { EmailLogService } from './email-log';
 
-/**
- * Template to use
- * await emailTransporter().sendMail({
- from: 'AusVie noreply<noreply@ausvie.com.au>',
- to: 'admin@ausvie.com.au',
- subject: 'Test', // Subject line
- text: 'Test text', // plaintext version
- html: `<div>${'Test text'}</div>`, // html version
- // attachments: [
- //     {
- //         filename,
- //         content: fileData,
- //     },
- // ],
- });
- */
-// Load the AWS SDK for Node.js
-// https://stackoverflow.com/questions/23042835/sending-mail-via-aws-ses-with-attachment-in-node-js
-
-const sesClient = new SESv2Client({
-    region: process.env.AWS_REGION,
-});
-
-const emailOptions =
-    process.env.EMAIL_TRANSPORT === 'smtp'
-        ? {
-              port: process.env.SMTP_PORT ? parseInt(process.env.SMTP_PORT, 10) : 587,
-              host: process.env.SMTP_HOST,
-              auth:
-                  process.env.SMTP_USER && process.env.SMTP_PASSWORD
-                      ? {
-                            user: process.env.SMTP_USER,
-                            pass: process.env.SMTP_PASSWORD,
-                        }
-                      : undefined,
-          }
-        : {
-              SES: { sesClient, SendEmailCommand },
-          };
+// ─── Configuration types ───────────────────────────────────────────
+
+export interface SMTPTransportConfig {
+    host: string;
+    port?: number;
+    auth?: {
+        user: string;
+        pass: string;
+    };
+}
+
+export interface SESTransportConfig {
+    region?: string;
+    sourceArn?: string;
+    credentials?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+}
+
+export interface EmailLoggingConfig {
+    /** DynamoDB table name for email logs */
+    tableName: string;
+    /** AWS region for the logging table */
+    region?: string;
+}
+
+export interface EmailServiceConfig {
+    /** Transport type – defaults to 'ses' */
+    transport?: 'smtp' | 'ses';
+    /** SMTP options (required when transport is 'smtp') */
+    smtp?: SMTPTransportConfig;
+    /** SES options (used when transport is 'ses') */
+    ses?: SESTransportConfig;
+    /** Email logging configuration – if omitted, logging is derived from env vars */
+    logging?: EmailLoggingConfig;
+    /** Enable nodemailer debug output */
+    debug?: boolean;
+}
+
+// ─── Email payload ─────────────────────────────────────────────────
 
 export interface Email {
     to?: string | null;
@@ -54,23 +56,71 @@ export interface Email {
     subject: string;
 }
 
-export const emailTransporter = (logger: any = console) => {
+// ─── Internal helpers ──────────────────────────────────────────────
+
+function resolveTransportType(config?: EmailServiceConfig): 'smtp' | 'ses' {
+    if (config?.transport) return config.transport;
+    if (process.env.EMAIL_TRANSPORT === 'smtp') return 'smtp';
+    return 'ses';
+}
+
+function buildTransportOptions(type: 'smtp' | 'ses', config?: EmailServiceConfig) {
+    if (type === 'smtp') {
+        const smtp = config?.smtp;
+        return {
+            port: smtp?.port ?? (process.env.SMTP_PORT ? parseInt(process.env.SMTP_PORT, 10) : 587),
+            host: smtp?.host ?? process.env.SMTP_HOST,
+            auth:
+                smtp?.auth ??
+                (process.env.SMTP_USER && process.env.SMTP_PASSWORD
+                    ? { user: process.env.SMTP_USER, pass: process.env.SMTP_PASSWORD }
+                    : undefined),
+        };
+    }
+
+    const ses = config?.ses;
+    const sesClient = new SESv2Client({
+        region: ses?.region ?? process.env.AWS_REGION,
+        ...(ses?.credentials ? { credentials: ses.credentials } : {}),
+    });
+    return { SES: { sesClient, SendEmailCommand } };
+}
+
+function buildDefaultOptions(type: 'smtp' | 'ses', config?: EmailServiceConfig) {
+    if (type === 'ses') {
+        const sourceArn = config?.ses?.sourceArn ?? process.env.EMAIL_SOURCE_ARN;
+        if (sourceArn) {
+            return { ses: { FromEmailAddressIdentityArn: sourceArn } };
+        }
+    }
+    return undefined;
+}
+
+// ─── Public API ────────────────────────────────────────────────────
+
+/**
+ * Create an email transporter.
+ *
+ * Accepts an optional {@link EmailServiceConfig} so callers can pass
+ * explicit configuration instead of relying on environment variables.
+ * Any value not provided in `config` falls back to the corresponding
+ * `process.env` variable, preserving full backward-compatibility.
+ */
+export const emailTransporter = (logger: any = console, config?: EmailServiceConfig) => {
+    const type = resolveTransportType(config);
+    const transportOptions = buildTransportOptions(type, config);
+    const defaults = buildDefaultOptions(type, config);
+
     const transporter = nodemailer.createTransport(
         {
-            ...emailOptions,
-            debug: true,
+            ...transportOptions,
+            debug: config?.debug ?? true,
         } as any,
-        {
-            ...(process.env.EMAIL_SOURCE_ARN
-                ? {
-                      ses: {
-                          FromEmailAddressIdentityArn: process.env.EMAIL_SOURCE_ARN!,
-                      },
-                  }
-                : undefined),
-        } as any
+        defaults ? (defaults as any) : undefined
     );
 
+    const emailLogService = new EmailLogService(config?.logging);
+
     return {
         async sendMail(
             {
@@ -90,7 +140,6 @@ export const emailTransporter = (logger: any = console) => {
                 return;
             }
             const sender = from;
-            const emailLogService = new EmailLogService();
             logger.info(
                 `Sending email to ${to} with subject: ${subject}, reference: ${reference}, idempotencyKey: ${idempotencyKey}`
             );

package/src/index.ts

@@ -1,2 +1,3 @@
 export * from './email';
 export * from './template';
+export { EmailLogService } from './email-log';