@tomei/mailer 0.6.0 → 0.7.1-dev.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomei/mailer",
-  "version": "0.6.0",
+  "version": "0.7.1-dev.1",
   "description": "Tomei Mailer Package",
   "main": "dist/index.js",
   "scripts": {
@@ -19,20 +19,20 @@
     "@eslint/js": "^9.35.0",
     "@tsconfig/node18": "^18.2.4",
     "@types/jest": "^30.0.0",
-    "@types/node": "^24.3.1",
+    "@types/node": "^24.5.2",
     "@types/nodemailer": "^7.0.1",
-    "@typescript-eslint/eslint-plugin": "^8.43.0",
-    "@typescript-eslint/parser": "^8.43.0",
+    "@typescript-eslint/eslint-plugin": "^8.44.0",
+    "@typescript-eslint/parser": "^8.44.0",
     "eslint": "^9.35.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-prettier": "^5.5.4",
     "globals": "^16.4.0",
     "husky": "^9.1.7",
     "jest": "^30.1.3",
     "nodemailer-mock": "^2.0.9",
     "prettier": "^3.6.2",
-    "ts-jest": "^29.4.1",
+    "ts-jest": "^29.4.3",
     "ts-node": "^10.9.2",
     "tsc-watch": "^7.1.1",
     "typescript": "^5.9.2"
@@ -42,6 +42,6 @@
   },
   "peerDependencies": {
     "@tomei/config": "^0.3.22",
-    "nodemailer": "^6.10.1"
+    "nodemailer": "^7.0.6"
   }
 }

package/src/interfaces/EmailLog.ts

@@ -0,0 +1,93 @@
+export type EmailStatus = 'success' | 'failed' | 'pending';
+
+export class EmailLog {
+  id: string;
+  recipient: string;
+  subject: string;
+  emailType: string;
+  bodyHtml: string;
+  bodyText: string;
+  payload: string;
+  private _status: EmailStatus;
+  error?: string;
+  sentAt: Date;
+  createdAt: Date;
+  updatedAt?: Date;
+  resentFromId?: string;
+  resendMethod?: string;
+  resentById?: string;
+
+  constructor(params: {
+    id: string;
+    recipient: string;
+    subject: string;
+    emailType: string;
+    bodyHtml: string;
+    bodyText: string;
+    payload: string;
+    status?: EmailStatus;
+    error?: string;
+    sentAt?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    resentFromId?: string;
+    resendMethod?: string;
+    resentById?: string;
+  }) {
+    this.id = params.id;
+    this.recipient = params.recipient;
+    this.subject = params.subject;
+    this.emailType = params.emailType;
+    this.bodyHtml = params.bodyHtml;
+    this.bodyText = params.bodyText;
+    this.payload = params.payload;
+    this.error = params.error;
+    this.sentAt = params.sentAt ?? new Date();
+    this.createdAt = params.createdAt ?? new Date();
+    this.updatedAt = params.updatedAt;
+    this.resentFromId = params.resentFromId;
+    this.resendMethod = params.resendMethod;
+    this.resentById = params.resentById;
+
+    // Ensure stored status is lowercase and valid
+    const initialStatus = (params.status ?? 'pending') as string;
+    this._status = EmailLog.normalizeStatus(initialStatus);
+  }
+
+  // Enforce lowercase when reading
+  get status(): EmailStatus {
+    return this._status;
+  }
+
+  // Setting status always stores lowercase and validates value
+  set status(value: EmailStatus) {
+    this._status = EmailLog.normalizeStatus(value as string);
+    this.updatedAt = new Date();
+  }
+
+  // Normalize and validate incoming status strings
+  private static normalizeStatus(s: string): EmailStatus {
+    const lower = (s ?? '').toLowerCase();
+    if (lower === 'success' || lower === 'failed' || lower === 'pending') {
+      return lower as EmailStatus;
+    }
+    throw new Error(`Invalid EmailStatus value: ${s}`);
+  }
+
+  // Only allow transitions from pending -> success|failed
+  updateStatus(newStatus: EmailStatus): void {
+    const normalized = EmailLog.normalizeStatus(newStatus as string);
+    if (this._status !== 'pending') {
+      throw new Error(
+        `Invalid status transition: only 'pending' -> 'success'|'failed' allowed (current: ${this._status})`,
+      );
+    }
+    if (normalized !== 'success' && normalized !== 'failed') {
+      throw new Error(
+        `Invalid target status: ${normalized}. Must be 'success' or 'failed'`,
+      );
+    }
+    this._status = normalized;
+    this.updatedAt = new Date();
+  }
+}

package/src/interfaces/IEmailRepository.ts

@@ -0,0 +1,7 @@
+import { EmailLog, EmailStatus } from './EmailLog';
+
+export interface IEmailRepository {
+  listAll(): Promise<EmailLog[]>;
+  filterByStatus(status: EmailStatus): Promise<EmailLog[]>;
+  findByRecipient(recipient: string): Promise<EmailLog[]>;
+}

package/src/mailer/smtp-mailer.ts

@@ -52,6 +52,33 @@ export class SMTPMailer extends MailerBase {
         'isMailerLogEnabled',
       );
 
+      const testReceipientEmail = ComponentConfig.getComponentConfigValue(
+        '@tomei/mailer',
+        'testReceipientEmail',
+      );
+
+      const environment = ComponentConfig.getComponentConfigValue(
+        '@tomei/mailer',
+        'environment',
+      );
+
+      if (
+        !host ||
+        !port ||
+        !user ||
+        !pass ||
+        !environment ||
+        !testReceipientEmail
+      ) {
+        throw new Error(
+          'Host, port, user, pass, environment, or test receipient email is not defined in the configuration.',
+        );
+      }
+
+      if (environment !== 'production') {
+        options.to = testReceipientEmail;
+      }
+
       const transportConfig: TransportConfig = {
         host,
         port,