@stacksjs/email 0.69.2 → 0.70.0

package/dist/base.d.ts

@@ -0,0 +1,130 @@
+import type { EmailDriver, EmailDriverConfig, EmailMessage, EmailResult, RenderOptions } from '@stacksjs/types';
+
+export declare abstract class BaseEmailDriver implements EmailDriver {
+  public abstract name: string
+  protected config: Required<EmailDriverConfig>
+
+  constructor(config?: EmailDriverConfig) {
+    this.config = {
+      maxRetries: config?.maxRetries || 3,
+      retryTimeout: config?.retryTimeout || 1000,
+      ...config,
+    }
+  }
+
+  public configure(config: EmailDriverConfig): void {
+    this.config = { ...this.config, ...config }
+  }
+
+  public abstract send(message: EmailMessage, options?: RenderOptions): Promise<EmailResult>
+
+  protected validateMessage(message: EmailMessage): boolean {
+    if (!message.from?.address) {
+      throw new Error('Email sender address is required')
+    }
+
+    if (!message.to || (Array.isArray(message.to) && message.to.length === 0)) {
+      throw new Error('At least one recipient is required')
+    }
+
+    if (!message.subject) {
+      throw new Error('Email subject is required')
+    }
+
+    return true
+  }
+
+  protected formatAddresses(addresses: string | string[] | EmailAddress[] | undefined): string[] {
+    if (!addresses)
+      return []
+
+    if (typeof addresses === 'string') {
+      return [addresses]
+    }
+
+    return addresses.map((addr) => {
+      if (typeof addr === 'string')
+        return addr
+      return addr.name ? `${addr.name} <${addr.address}>` : addr.address
+    })
+  }
+
+  protected async handleError(error: unknown, message: EmailMessage): Promise<EmailResult> {
+    const err = error instanceof Error ? error : new Error(String(error))
+
+    log.error(`[${this.name}] Email sending failed`, {
+      error: err.message,
+      stack: err.stack,
+      to: message.to,
+      subject: message.subject,
+    })
+
+    let result: EmailResult = {
+      message: `Email sending failed: ${err.message}`,
+      success: false,
+      provider: this.name,
+    }
+
+    if (message.onError) {
+      const customResult = message.onError(err)
+      const handlerResult = customResult instanceof Promise
+        ? await customResult
+        : customResult
+
+      result = {
+        ...result,
+        ...handlerResult,
+        success: false,
+        provider: this.name,
+      }
+    }
+
+    return result
+  }
+
+  protected async handleSuccess(message: EmailMessage, messageId?: string): Promise<EmailResult> {
+    let result: EmailResult = {
+      message: 'Email sent successfully',
+      success: true,
+      provider: this.name,
+      messageId,
+    }
+
+    try {
+      if (message.handle) {
+        const customResult = message.handle()
+        const handlerResult = customResult instanceof Promise
+          ? await customResult
+          : customResult
+
+        result = {
+          ...result,
+          ...handlerResult,
+          success: true,
+          provider: this.name,
+          messageId,
+        }
+      }
+
+      if (message.onSuccess) {
+        const successResult = message.onSuccess()
+        const handlerResult = successResult instanceof Promise
+          ? await successResult
+          : successResult
+
+        result = {
+          ...result,
+          ...handlerResult,
+          success: true,
+          provider: this.name,
+          messageId,
+        }
+      }
+    }
+    catch (error) {
+      return this.handleError(error, message)
+    }
+
+    return result
+  }
+}

package/dist/email.d.ts

@@ -0,0 +1,2 @@
+declare const driver: unknown;
+export declare const mail: Mail;

package/dist/index.d.ts

@@ -1 +1,3 @@
-export * as ses from './ses'
+export * from './drivers'
+export * from './email'
+export * from './types'