@xcelsior/email 1.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,22 @@
+
+> @xcelsior/email@1.0.0 build /Users/tuannguyen/Work/excelsior-packages/packages/services/email
+> tsup
+
+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 Target: es2020
+CLI Cleaning output folder
+CJS Build start
+ESM Build start
+CJS dist/index.js     7.42 KB
+CJS dist/index.js.map 11.60 KB
+CJS ⚡️ Build success in 22ms
+ESM dist/index.mjs     5.19 KB
+ESM dist/index.mjs.map 11.34 KB
+ESM ⚡️ Build success in 23ms
+DTS Build start
+DTS ⚡️ Build success in 1149ms
+DTS dist/index.d.ts  849.00 B
+DTS dist/index.d.mts 849.00 B

package/.turbo/turbo-lint.log

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

package/.turbo/turbo-test.log

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

package/biome.json

@@ -0,0 +1,3 @@
+{
+    "extends": "//"
+}

package/dist/index.d.mts

@@ -0,0 +1,21 @@
+import * as nodemailer_lib_smtp_pool from 'nodemailer/lib/smtp-pool';
+
+interface Email {
+    to?: string | null;
+    from?: string;
+    reference?: string;
+    template?: string;
+    idempotencyKey?: string;
+    replyTo?: string | null;
+    text?: string;
+    attachments?: any[];
+    subject: string;
+}
+declare const emailTransporter: (sourceArn: string | undefined, logger?: any) => {
+    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 };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import * as nodemailer_lib_smtp_pool from 'nodemailer/lib/smtp-pool';
+
+interface Email {
+    to?: string | null;
+    from?: string;
+    reference?: string;
+    template?: string;
+    idempotencyKey?: string;
+    replyTo?: string | null;
+    text?: string;
+    attachments?: any[];
+    subject: string;
+}
+declare const emailTransporter: (sourceArn: string | undefined, logger?: any) => {
+    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 };

package/dist/index.js

@@ -0,0 +1,232 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  emailTransporter: () => emailTransporter,
+  renderTemplate: () => renderTemplate,
+  renderTemplateFile: () => renderTemplateFile
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/email.ts
+var import_client_sesv2 = require("@aws-sdk/client-sesv2");
+var import_nodemailer = __toESM(require("nodemailer"));
+
+// src/email-log.ts
+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;
+    this.dynamoClient = new import_client_dynamodb.DynamoDBClient({
+      region: process.env.AWS_REGION
+    });
+    this.docClient = import_lib_dynamodb.DynamoDBDocumentClient.from(this.dynamoClient);
+  }
+  async logEmail({
+    subject,
+    sender,
+    receiver,
+    status,
+    error,
+    idempotencyKey,
+    reference = (0, import_uuid.v4)()
+  }) {
+    const timestamp = Date.now();
+    const log = {
+      reference,
+      timestamp,
+      subject,
+      sender,
+      receiver,
+      status,
+      idempotencyKey,
+      ...error && { error }
+    };
+    await this.docClient.send(
+      new import_lib_dynamodb.PutCommand({
+        TableName: this.tableName,
+        Item: log
+      })
+    );
+    return reference;
+  }
+  async getEmailByIdempotencyKey(idempotencyKey) {
+    if (!idempotencyKey) {
+      return null;
+    }
+    const result = await this.docClient.send(
+      new import_lib_dynamodb.QueryCommand({
+        TableName: this.tableName,
+        IndexName: "idempotency-key-index",
+        KeyConditionExpression: "idempotencyKey = :idempotencyKey",
+        ExpressionAttributeValues: {
+          ":idempotencyKey": idempotencyKey
+        },
+        Limit: 1
+      })
+    );
+    return result.Items?.[0];
+  }
+};
+
+// src/email.ts
+var sesClient = new import_client_sesv2.SESv2Client({
+  region: process.env.AWS_REGION
+});
+var emailOptions = process.env.NODE_ENV === "development" ? {
+  port: 1025,
+  host: process.env.SMTP_HOST
+} : {
+  SES: { sesClient, SendEmailCommand: import_client_sesv2.SendEmailCommand }
+};
+var emailTransporter = (sourceArn, logger = console) => {
+  const transporter = import_nodemailer.default.createTransport(
+    {
+      ...emailOptions,
+      debug: true
+    },
+    {
+      ses: {
+        FromEmailAddressIdentityArn: sourceArn
+      }
+    }
+  );
+  return {
+    async sendMail({
+      to,
+      reference,
+      from,
+      replyTo,
+      template,
+      text,
+      attachments = [],
+      idempotencyKey,
+      subject
+    }, idempotentCheck) {
+      if (!to) {
+        return;
+      }
+      const sender = from;
+      const emailLogService = new EmailLogService();
+      try {
+        if (idempotentCheck) {
+          const existingEmail = await emailLogService.getEmailByIdempotencyKey(idempotencyKey);
+          if (existingEmail) {
+            logger.info(`Email with idempotency key ${idempotencyKey} already sent`);
+            return;
+          }
+        }
+        const result = await transporter.sendMail({
+          to,
+          from: sender,
+          replyTo: replyTo ?? void 0,
+          html: template,
+          text,
+          subject,
+          attachments
+        });
+        await emailLogService.logEmail({
+          subject: subject || "No Subject",
+          reference,
+          sender: sender || "Unknown Sender",
+          idempotencyKey,
+          receiver: to,
+          status: "success"
+        });
+        return result;
+      } catch (error) {
+        await emailLogService.logEmail({
+          subject: subject || "No Subject",
+          sender: sender || "Unknown Sender",
+          receiver: to,
+          status: "failed",
+          error: error instanceof Error ? error.message : String(error)
+        });
+        throw error;
+      }
+    }
+  };
+};
+
+// src/template.ts
+var import_node_fs = __toESM(require("fs"));
+var import_utils = require("@excelsior/utils");
+var import_handlebars = __toESM(require("handlebars"));
+var import_lodash = __toESM(require("lodash"));
+var import_moment = __toESM(require("moment"));
+var { getDateTime } = import_utils.dates;
+var { convertMoneyFormat, moneyFormat } = import_utils.formatters;
+import_handlebars.default.registerHelper("multiply", (a, b) => a * b);
+import_handlebars.default.registerHelper("datetime", (a) => (0, import_moment.default)(getDateTime(a)).format("DD/MM/YYYY HH:mm"));
+import_handlebars.default.registerHelper("moneyFormat", (a, ...others) => {
+  let currency = "AUD";
+  if (others.length > 1) {
+    currency = others[0];
+  }
+  return moneyFormat(a, currency);
+});
+import_handlebars.default.registerHelper(
+  "convertMoneyFormat",
+  (amount, currency, rate = 1) => convertMoneyFormat(amount, currency, rate)
+);
+import_handlebars.default.registerHelper("titleCase", (string) => {
+  if (!string) return "";
+  return import_lodash.default.startCase(import_lodash.default.camelCase(string)).replace(/\s/g, " ");
+});
+import_handlebars.default.registerHelper("choose", (a, b) => a ? a : b);
+import_handlebars.default.registerHelper(
+  "phoneFormat",
+  (phone) => `${phone.substring(0, phone.length / 2 - 2)}****${phone.substring(phone.length / 2 + 2)}`
+);
+import_handlebars.default.registerHelper("title", (title) => import_lodash.default.startCase(title));
+import_handlebars.default.registerHelper("eq", (a, b) => a === b);
+import_handlebars.default.registerHelper("lowercase", (title) => title.toLowerCase());
+import_handlebars.default.registerHelper("JSONparse", (string, key) => JSON.parse(string)[key]);
+import_handlebars.default.registerHelper("incr", (a) => a + 1);
+import_handlebars.default.registerHelper("gt", (a, b) => a > b);
+function renderTemplate(content, data) {
+  return import_handlebars.default.compile(content)(data);
+}
+async function renderTemplateFile(file, data) {
+  const content = await import_node_fs.default.promises.readFile(file, {
+    encoding: "utf-8"
+  });
+  return renderTemplate(content, data);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  emailTransporter,
+  renderTemplate,
+  renderTemplateFile
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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.NODE_ENV === 'development'\n        ? {\n              port: 1025,\n              host: process.env.SMTP_HOST,\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 = (sourceArn: string | undefined, logger: any = console) => {\n    const transporter = nodemailer.createTransport(\n        {\n            ...emailOptions,\n            debug: true,\n        } as any,\n        {\n            ses: {\n                FromEmailAddressIdentityArn: sourceArn,\n            },\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\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;\n    private readonly docClient: DynamoDBDocumentClient;\n\n    constructor() {\n        this.tableName = process.env.EMAIL_TABLE_NAME!;\n        this.dynamoClient = new DynamoDBClient({\n            region: process.env.AWS_REGION,\n        });\n        this.docClient = DynamoDBDocumentClient.from(this.dynamoClient);\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        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) {\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 '@excelsior/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

@@ -0,0 +1,193 @@
+// src/email.ts
+import { SendEmailCommand, SESv2Client } from "@aws-sdk/client-sesv2";
+import nodemailer from "nodemailer";
+
+// src/email-log.ts
+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;
+    this.dynamoClient = new DynamoDBClient({
+      region: process.env.AWS_REGION
+    });
+    this.docClient = DynamoDBDocumentClient.from(this.dynamoClient);
+  }
+  async logEmail({
+    subject,
+    sender,
+    receiver,
+    status,
+    error,
+    idempotencyKey,
+    reference = uuidv4()
+  }) {
+    const timestamp = Date.now();
+    const log = {
+      reference,
+      timestamp,
+      subject,
+      sender,
+      receiver,
+      status,
+      idempotencyKey,
+      ...error && { error }
+    };
+    await this.docClient.send(
+      new PutCommand({
+        TableName: this.tableName,
+        Item: log
+      })
+    );
+    return reference;
+  }
+  async getEmailByIdempotencyKey(idempotencyKey) {
+    if (!idempotencyKey) {
+      return null;
+    }
+    const result = await this.docClient.send(
+      new QueryCommand({
+        TableName: this.tableName,
+        IndexName: "idempotency-key-index",
+        KeyConditionExpression: "idempotencyKey = :idempotencyKey",
+        ExpressionAttributeValues: {
+          ":idempotencyKey": idempotencyKey
+        },
+        Limit: 1
+      })
+    );
+    return result.Items?.[0];
+  }
+};
+
+// src/email.ts
+var sesClient = new SESv2Client({
+  region: process.env.AWS_REGION
+});
+var emailOptions = process.env.NODE_ENV === "development" ? {
+  port: 1025,
+  host: process.env.SMTP_HOST
+} : {
+  SES: { sesClient, SendEmailCommand }
+};
+var emailTransporter = (sourceArn, logger = console) => {
+  const transporter = nodemailer.createTransport(
+    {
+      ...emailOptions,
+      debug: true
+    },
+    {
+      ses: {
+        FromEmailAddressIdentityArn: sourceArn
+      }
+    }
+  );
+  return {
+    async sendMail({
+      to,
+      reference,
+      from,
+      replyTo,
+      template,
+      text,
+      attachments = [],
+      idempotencyKey,
+      subject
+    }, idempotentCheck) {
+      if (!to) {
+        return;
+      }
+      const sender = from;
+      const emailLogService = new EmailLogService();
+      try {
+        if (idempotentCheck) {
+          const existingEmail = await emailLogService.getEmailByIdempotencyKey(idempotencyKey);
+          if (existingEmail) {
+            logger.info(`Email with idempotency key ${idempotencyKey} already sent`);
+            return;
+          }
+        }
+        const result = await transporter.sendMail({
+          to,
+          from: sender,
+          replyTo: replyTo ?? void 0,
+          html: template,
+          text,
+          subject,
+          attachments
+        });
+        await emailLogService.logEmail({
+          subject: subject || "No Subject",
+          reference,
+          sender: sender || "Unknown Sender",
+          idempotencyKey,
+          receiver: to,
+          status: "success"
+        });
+        return result;
+      } catch (error) {
+        await emailLogService.logEmail({
+          subject: subject || "No Subject",
+          sender: sender || "Unknown Sender",
+          receiver: to,
+          status: "failed",
+          error: error instanceof Error ? error.message : String(error)
+        });
+        throw error;
+      }
+    }
+  };
+};
+
+// src/template.ts
+import fs from "fs";
+import { formatters, dates } from "@excelsior/utils";
+import handlebars from "handlebars";
+import _ from "lodash";
+import moment from "moment";
+var { getDateTime } = dates;
+var { convertMoneyFormat, moneyFormat } = formatters;
+handlebars.registerHelper("multiply", (a, b) => a * b);
+handlebars.registerHelper("datetime", (a) => moment(getDateTime(a)).format("DD/MM/YYYY HH:mm"));
+handlebars.registerHelper("moneyFormat", (a, ...others) => {
+  let currency = "AUD";
+  if (others.length > 1) {
+    currency = others[0];
+  }
+  return moneyFormat(a, currency);
+});
+handlebars.registerHelper(
+  "convertMoneyFormat",
+  (amount, currency, rate = 1) => convertMoneyFormat(amount, currency, rate)
+);
+handlebars.registerHelper("titleCase", (string) => {
+  if (!string) return "";
+  return _.startCase(_.camelCase(string)).replace(/\s/g, " ");
+});
+handlebars.registerHelper("choose", (a, b) => a ? a : b);
+handlebars.registerHelper(
+  "phoneFormat",
+  (phone) => `${phone.substring(0, phone.length / 2 - 2)}****${phone.substring(phone.length / 2 + 2)}`
+);
+handlebars.registerHelper("title", (title) => _.startCase(title));
+handlebars.registerHelper("eq", (a, b) => a === b);
+handlebars.registerHelper("lowercase", (title) => title.toLowerCase());
+handlebars.registerHelper("JSONparse", (string, key) => JSON.parse(string)[key]);
+handlebars.registerHelper("incr", (a) => a + 1);
+handlebars.registerHelper("gt", (a, b) => a > b);
+function renderTemplate(content, data) {
+  return handlebars.compile(content)(data);
+}
+async function renderTemplateFile(file, data) {
+  const content = await fs.promises.readFile(file, {
+    encoding: "utf-8"
+  });
+  return renderTemplate(content, data);
+}
+export {
+  emailTransporter,
+  renderTemplate,
+  renderTemplateFile
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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.NODE_ENV === 'development'\n        ? {\n              port: 1025,\n              host: process.env.SMTP_HOST,\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 = (sourceArn: string | undefined, logger: any = console) => {\n    const transporter = nodemailer.createTransport(\n        {\n            ...emailOptions,\n            debug: true,\n        } as any,\n        {\n            ses: {\n                FromEmailAddressIdentityArn: sourceArn,\n            },\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\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;\n    private readonly docClient: DynamoDBDocumentClient;\n\n    constructor() {\n        this.tableName = process.env.EMAIL_TABLE_NAME!;\n        this.dynamoClient = new DynamoDBClient({\n            region: process.env.AWS_REGION,\n        });\n        this.docClient = DynamoDBDocumentClient.from(this.dynamoClient);\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        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) {\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 '@excelsior/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/jest.config.js

@@ -0,0 +1,10 @@
+const baseConfig = require('../../../jest.config.base');
+
+/** @type {import('jest').Config} */
+const config = {
+    ...baseConfig,
+    displayName: '@xcelsior/email',
+    rootDir: '.',
+};
+
+module.exports = config;

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@xcelsior/email",
+  "version": "1.0.0",
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "require": "./dist/index.js"
+    }
+  },
+  "main": "src/index.ts",
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "peerDependencies": {
+    "@aws-sdk/client-dynamodb": "^3.782.0",
+    "@aws-sdk/lib-dynamodb": "^3.782.0"
+  },
+  "dependencies": {
+    "lodash": "^4.17.21",
+    "handlebars": "^4.7.8",
+    "moment": "^2.30.1",
+    "nodemailer": "^7.0.4",
+    "@aws-sdk/client-sesv2": "^3.840.0",
+    "uuid": "^11.1.0",
+    "@xcelsior/utils": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/lodash": "^4.17.20",
+    "@types/node": "^24.0.10",
+    "@types/nodemailer": "^6.4.17",
+    "@types/uuid": "^10.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "jest --passWithNoTests",
+    "lint": "biome check ."
+  }
+}

package/src/email-log.ts

@@ -0,0 +1,78 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocumentClient, PutCommand, QueryCommand } from '@aws-sdk/lib-dynamodb';
+import { v4 as uuidv4 } from 'uuid';
+
+interface EmailLog {
+    reference?: string;
+    timestamp: number;
+    subject: string;
+    sender: string;
+    receiver: string;
+    idempotencyKey?: string;
+    status: 'success' | 'failed';
+    error?: string;
+}
+
+export class EmailLogService {
+    private readonly tableName: string;
+    private readonly dynamoClient: DynamoDBClient;
+    private readonly docClient: DynamoDBDocumentClient;
+
+    constructor() {
+        this.tableName = process.env.EMAIL_TABLE_NAME!;
+        this.dynamoClient = new DynamoDBClient({
+            region: process.env.AWS_REGION,
+        });
+        this.docClient = DynamoDBDocumentClient.from(this.dynamoClient);
+    }
+
+    async logEmail({
+        subject,
+        sender,
+        receiver,
+        status,
+        error,
+        idempotencyKey,
+        reference = uuidv4(),
+    }: Omit<EmailLog, 'timestamp'>): Promise<string> {
+        const timestamp = Date.now();
+
+        const log: EmailLog = {
+            reference,
+            timestamp,
+            subject,
+            sender,
+            receiver,
+            status,
+            idempotencyKey,
+            ...(error && { error }),
+        };
+
+        await this.docClient.send(
+            new PutCommand({
+                TableName: this.tableName,
+                Item: log,
+            })
+        );
+        return reference;
+    }
+
+    async getEmailByIdempotencyKey(idempotencyKey: string | undefined) {
+        if (!idempotencyKey) {
+            return null;
+        }
+
+        const result = await this.docClient.send(
+            new QueryCommand({
+                TableName: this.tableName,
+                IndexName: 'idempotency-key-index',
+                KeyConditionExpression: 'idempotencyKey = :idempotencyKey',
+                ExpressionAttributeValues: {
+                    ':idempotencyKey': idempotencyKey,
+                },
+                Limit: 1,
+            })
+        );
+        return result.Items?.[0] as EmailLog | null;
+    }
+}

package/src/email.ts

@@ -0,0 +1,128 @@
+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.NODE_ENV === 'development'
+        ? {
+              port: 1025,
+              host: process.env.SMTP_HOST,
+          }
+        : {
+              SES: { sesClient, SendEmailCommand },
+          };
+
+export interface Email {
+    to?: string | null;
+    from?: string;
+    reference?: string;
+    template?: string;
+    idempotencyKey?: string;
+    replyTo?: string | null;
+    text?: string;
+    attachments?: any[];
+    subject: string;
+}
+
+export const emailTransporter = (sourceArn: string | undefined, logger: any = console) => {
+    const transporter = nodemailer.createTransport(
+        {
+            ...emailOptions,
+            debug: true,
+        } as any,
+        {
+            ses: {
+                FromEmailAddressIdentityArn: sourceArn,
+            },
+        } as any
+    );
+
+    return {
+        async sendMail(
+            {
+                to,
+                reference,
+                from,
+                replyTo,
+                template,
+                text,
+                attachments = [],
+                idempotencyKey,
+                subject,
+            }: Email,
+            idempotentCheck?: boolean
+        ) {
+            if (!to) {
+                return;
+            }
+            const sender = from;
+            const emailLogService = new EmailLogService();
+
+            try {
+                if (idempotentCheck) {
+                    const existingEmail =
+                        await emailLogService.getEmailByIdempotencyKey(idempotencyKey);
+                    if (existingEmail) {
+                        logger.info(`Email with idempotency key ${idempotencyKey} already sent`);
+                        return;
+                    }
+                }
+                const result = await transporter.sendMail({
+                    to,
+                    from: sender,
+                    replyTo: replyTo ?? undefined,
+                    html: template,
+                    text,
+                    subject,
+                    attachments,
+                });
+
+                // Log successful email
+                await emailLogService.logEmail({
+                    subject: subject || 'No Subject',
+                    reference,
+                    sender: sender || 'Unknown Sender',
+                    idempotencyKey,
+                    receiver: to,
+                    status: 'success',
+                });
+
+                return result;
+            } catch (error) {
+                // Log failed email
+                await emailLogService.logEmail({
+                    subject: subject || 'No Subject',
+                    sender: sender || 'Unknown Sender',
+                    receiver: to,
+                    status: 'failed',
+                    error: error instanceof Error ? error.message : String(error),
+                });
+
+                throw error;
+            }
+        },
+    };
+};

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './email';
+export * from './template';

package/src/template.ts

@@ -0,0 +1,59 @@
+import fs from 'node:fs';
+import { formatters, dates } from '@xcelsior/utils';
+import handlebars from 'handlebars';
+import _ from 'lodash';
+import moment from 'moment';
+
+const { getDateTime } = dates;
+const { convertMoneyFormat, moneyFormat } = formatters;
+
+handlebars.registerHelper('multiply', (a, b) => a * b);
+
+handlebars.registerHelper('datetime', (a) => moment(getDateTime(a)).format('DD/MM/YYYY HH:mm'));
+
+handlebars.registerHelper('moneyFormat', (a, ...others) => {
+    let currency = 'AUD' as const;
+    if (others.length > 1) {
+        currency = others[0] as any;
+    }
+    return moneyFormat(a, currency);
+});
+
+handlebars.registerHelper('convertMoneyFormat', (amount, currency, rate = 1) =>
+    convertMoneyFormat(amount, currency, rate)
+);
+
+handlebars.registerHelper('titleCase', (string) => {
+    if (!string) return '';
+    return _.startCase(_.camelCase(string)).replace(/\s/g, ' ');
+});
+
+handlebars.registerHelper('choose', (a, b) => (a ? a : b));
+
+handlebars.registerHelper(
+    'phoneFormat',
+    (phone) =>
+        `${phone.substring(0, phone.length / 2 - 2)}****${phone.substring(phone.length / 2 + 2)}`
+);
+
+handlebars.registerHelper('title', (title) => _.startCase(title));
+
+handlebars.registerHelper('eq', (a, b) => a === b);
+handlebars.registerHelper('lowercase', (title: string) => title.toLowerCase());
+
+handlebars.registerHelper('JSONparse', (string, key) => JSON.parse(string)[key]);
+
+handlebars.registerHelper('incr', (a) => a + 1);
+
+handlebars.registerHelper('gt', (a, b) => a > b);
+
+export function renderTemplate(content: string, data: Record<string, any>): string {
+    return handlebars.compile(content)(data);
+}
+
+export async function renderTemplateFile(file: string, data: Record<string, any>) {
+    const content = await fs.promises.readFile(file, {
+        encoding: 'utf-8',
+    });
+    return renderTemplate(content, data);
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+    "extends": "../../../tsconfig.json",
+    "compilerOptions": {
+        "outDir": "dist",
+        "rootDir": "src"
+    },
+    "include": ["src"]
+}

package/tsup.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+    entry: ['src/index.ts'],
+    format: ['cjs', 'esm'],
+    dts: true,
+    splitting: false,
+    sourcemap: true,
+    clean: true,
+});