@tomei/mailer 0.7.1-dev.2 → 0.10.0-dev.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomei/mailer",
-  "version": "0.7.1-dev.2",
+  "version": "0.10.0-dev.1",
   "description": "Tomei Mailer Package",
   "main": "dist/index.js",
   "scripts": {

package/src/interfaces/EmailLog.ts

@@ -1,6 +1,6 @@
-export type EmailStatus = 'success' | 'failed' | 'pending';
+export type EmailStatus = 'pending' | 'success' | 'failed';
 
-export class EmailLog {
+export interface EmailLogProps {
   id: string;
   recipient: string;
   subject: string;
@@ -8,86 +8,84 @@ export class EmailLog {
   bodyHtml: string;
   bodyText: string;
   payload: string;
-  private _status: EmailStatus;
+  status?: string;
   error?: string;
-  sentAt: Date;
-  createdAt: Date;
+  sentAt?: Date;
+  createdAt?: Date;
   updatedAt?: Date;
   resentFromId?: string;
   resendMethod?: string;
   resentById?: string;
+}
+
+export class EmailLog {
+  public readonly id: string;
+  public readonly recipient: string;
+  public readonly subject: string;
+  public readonly emailType: string;
+  public readonly bodyHtml: string;
+  public readonly bodyText: string;
+  public readonly payload: string;
+
+  public error?: string;
+
+  public readonly sentAt: Date;
+  public readonly createdAt: Date;
+  public updatedAt?: Date;
+
+  public readonly resentFromId?: string;
+  public readonly resendMethod?: string;
+  public readonly resentById?: string;
+
+  private _status: EmailStatus;
+
+  constructor(props: EmailLogProps) {
+    this.id = props.id;
+    this.recipient = props.recipient;
+    this.subject = props.subject;
+    this.emailType = props.emailType;
+    this.bodyHtml = props.bodyHtml;
+    this.bodyText = props.bodyText;
+    this.payload = props.payload;
+
+    this.sentAt = props.sentAt || new Date();
+    this.createdAt = props.createdAt || new Date();
+    this.updatedAt = props.updatedAt;
 
-  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);
+    this.resentFromId = props.resentFromId;
+    this.resendMethod = props.resendMethod;
+    this.resentById = props.resentById;
+
+    this.error = props.error;
+    this._status = this.normalizeStatus(props.status);
   }
 
-  // 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();
-  }
+  public updateStatus(status: EmailStatus | string): void {
+    const normalized = this.normalizeStatus(status);
 
-  // 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;
+    if (this._status === normalized) {
+      return;
     }
-    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'`,
+        `Invalid status transition: cannot change from '${this._status}' to '${normalized}'`,
       );
     }
+
     this._status = normalized;
     this.updatedAt = new Date();
   }
+
+  private normalizeStatus(status?: string): EmailStatus {
+    const s = (status || 'pending').toLowerCase();
+    if (s === 'pending' || s === 'success' || s === 'failed') {
+      return s as EmailStatus;
+    }
+    throw new Error(`Invalid EmailStatus value: ${status}`);
+  }
 }

package/src/interfaces/IEmailRepository.ts

@@ -1,7 +1,18 @@
 import { EmailLog, EmailStatus } from './EmailLog';
 
+export class MailFilter {
+  status?: EmailStatus;
+  recipient?: string;
+  subject?: string;
+  fromDate?: Date;
+  toDate?: Date;
+
+  hasValue(): boolean {
+    return Object.values(this).some((value) => value);
+  }
+}
+
 export interface IEmailRepository {
   listAll(): Promise<EmailLog[]>;
-  filterByStatus(status: EmailStatus): Promise<EmailLog[]>;
-  findByRecipient(recipient: string): Promise<EmailLog[]>;
+  listWithFilter(filter: MailFilter): Promise<EmailLog[]>;
 }

package/src/interfaces/index.ts

@@ -2,4 +2,4 @@ export { ILogTransactionOption } from './log-transaction-options.interface';
 export { IMailLog } from './mail-log.interface';
 export { ISendMailConfig } from './mail-config.interface';
 export { EmailLog } from './EmailLog';
-export { IEmailRepository } from './IEmailRepository';
+export { IEmailRepository, MailFilter } from './IEmailRepository';