@trokky/trokky 2.0.3

package/dist/mail/adapters/smtp.js

@@ -0,0 +1,180 @@
+/**
+ * SMTP Mail Adapter
+ *
+ * Production-ready SMTP adapter using Nodemailer.
+ * Supports standard SMTP servers, Gmail, Outlook, and more.
+ */
+import nodemailer from 'nodemailer';
+import { createLogger } from '../../core/index.js';
+export class SMTPMailAdapter {
+    transporter;
+    config;
+    logger = createLogger('mail', 'SMTPMailAdapter');
+    constructor(config) {
+        if (!config.host || !config.port) {
+            throw new Error('SMTP host and port are required');
+        }
+        if (!config.auth?.user || !config.auth?.pass) {
+            throw new Error('SMTP authentication credentials are required');
+        }
+        this.config = {
+            host: config.host,
+            port: config.port,
+            secure: config.secure ?? false,
+            auth: config.auth,
+            pool: config.pool ?? false,
+            maxConnections: config.maxConnections ?? 5,
+            from: config.from || 'noreply@example.com',
+            fromName: config.fromName || '',
+            timeout: config.timeout || 10000,
+            debug: config.debug ?? false,
+        };
+        // Create Nodemailer transporter
+        this.transporter = nodemailer.createTransport({
+            host: this.config.host,
+            port: this.config.port,
+            secure: this.config.secure,
+            auth: {
+                user: this.config.auth.user,
+                pass: this.config.auth.pass,
+            },
+            pool: this.config.pool,
+            maxConnections: this.config.maxConnections,
+            connectionTimeout: this.config.timeout,
+        });
+        if (this.config.debug) {
+            this.logger.info('SMTP mail adapter initialized', {
+                host: this.config.host,
+                port: this.config.port,
+                secure: this.config.secure,
+                pool: this.config.pool,
+                from: this.config.from,
+            });
+        }
+    }
+    async send(message) {
+        try {
+            const startTime = Date.now();
+            // Convert attachments to Nodemailer format
+            const attachments = message.attachments?.map((att) => ({
+                filename: att.filename,
+                content: att.content,
+                contentType: att.contentType,
+                encoding: att.encoding,
+                cid: att.cid,
+            }));
+            // Prepare Nodemailer email data
+            const mailOptions = {
+                from: message.fromName ? `"${message.fromName}" <${message.from}>` : message.from,
+                to: message.to,
+                cc: message.cc,
+                bcc: message.bcc,
+                subject: message.subject,
+                text: message.text,
+                html: message.html,
+                replyTo: message.replyTo,
+                attachments,
+                headers: message.headers,
+            };
+            const info = await this.transporter.sendMail(mailOptions);
+            const processingTime = Date.now() - startTime;
+            if (this.config.debug) {
+                this.logger.info('Email sent via SMTP', {
+                    to: message.to,
+                    subject: message.subject,
+                    messageId: info.messageId,
+                    processingTime,
+                });
+            }
+            return {
+                success: true,
+                messageId: info.messageId,
+                timestamp: new Date(),
+                providerData: {
+                    accepted: info.accepted,
+                    rejected: info.rejected,
+                    response: info.response,
+                },
+            };
+        }
+        catch (error) {
+            this.logger.error('Failed to send email via SMTP', error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                providerData: { error },
+            };
+        }
+    }
+    async sendBatch(messages) {
+        const startTime = Date.now();
+        const results = [];
+        let successCount = 0;
+        let failureCount = 0;
+        // If pooling is enabled, send concurrently
+        // Otherwise send sequentially
+        if (this.config.pool) {
+            const batchResults = await Promise.all(messages.map((msg) => this.send(msg)));
+            for (const result of batchResults) {
+                results.push(result);
+                if (result.success) {
+                    successCount++;
+                }
+                else {
+                    failureCount++;
+                }
+            }
+        }
+        else {
+            // Send sequentially if not using connection pool
+            for (const message of messages) {
+                const result = await this.send(message);
+                results.push(result);
+                if (result.success) {
+                    successCount++;
+                }
+                else {
+                    failureCount++;
+                }
+            }
+        }
+        const processingTime = Date.now() - startTime;
+        this.logger.info('Batch email completed', {
+            total: messages.length,
+            successCount,
+            failureCount,
+            processingTime,
+        });
+        return {
+            successCount,
+            failureCount,
+            results,
+            processingTime,
+        };
+    }
+    async healthCheck() {
+        try {
+            // Verify SMTP connection
+            await this.transporter.verify();
+            this.logger.debug('SMTP connection verified');
+            return true;
+        }
+        catch (error) {
+            this.logger.error('SMTP health check failed', error);
+            return false;
+        }
+    }
+    getAdapterName() {
+        return 'smtp';
+    }
+    /**
+     * Close the SMTP connection pool
+     */
+    async close() {
+        if (this.config.pool) {
+            this.transporter.close();
+            this.logger.debug('SMTP connection pool closed');
+        }
+    }
+}
+//# sourceMappingURL=smtp.js.map

package/dist/mail/adapters/smtp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.js","sourceRoot":"","sources":["../../../src/mail/adapters/smtp.ts"],"names":[],"mappings":"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"}

package/dist/mail/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @trokky/mail - Core Mail Package
+ *
+ * Framework-agnostic mail layer with adapter pattern and templating.
+ */
+export type { MailAdapter, MailMessage, MailAttachment, MailResult, MailBatchResult, TemplateRenderer, TemplateData, RenderedTemplate, BaseMailAdapterConfig, SMTPMailAdapterConfig, ResendMailAdapterConfig, GmailMailAdapterConfig, SESMailAdapterConfig, ConsoleMailAdapterConfig, } from './types.js';
+export { BuiltInTemplateRenderer } from './templates/built-in-templates.js';
+export type { BuiltInTemplateOptions } from './templates/built-in-templates.js';
+export { CustomTemplateRenderer } from './templates/custom-template-renderer.js';
+export type { CustomTemplate, CustomTemplateFunction, TemplateDefinition, CustomTemplateRendererConfig, } from './templates/custom-template-renderer.js';
+export { MailService } from './mail-service.js';
+export type { MailServiceConfig, SendPasswordResetOptions, SendPasswordChangedOptions, SendOTPOptions, SendSecurityAlertOptions, SendUserInviteOptions, SendWelcomeOptions, SendAccountApprovedOptions, SendAccountRejectedOptions, } from './mail-service.js';
+export { MailNotificationService } from './notification-service.js';
+export type { MailNotificationConfig } from './notification-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mail/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mail/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAA;AAC3E,YAAY,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAA;AAE/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAA;AAChF,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,4BAA4B,GAC7B,MAAM,yCAAyC,CAAA;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/mail/index.js

@@ -0,0 +1,13 @@
+/**
+ * @trokky/mail - Core Mail Package
+ *
+ * Framework-agnostic mail layer with adapter pattern and templating.
+ */
+// Template system
+export { BuiltInTemplateRenderer } from './templates/built-in-templates.js';
+export { CustomTemplateRenderer } from './templates/custom-template-renderer.js';
+// Mail service
+export { MailService } from './mail-service.js';
+// Notification service
+export { MailNotificationService } from './notification-service.js';
+//# sourceMappingURL=index.js.map

package/dist/mail/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mail/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,kBAAkB;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAA;AAG3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAA;AAQhF,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAa/C,uBAAuB;AACvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/mail/mail-service.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Mail Service
+ *
+ * High-level email service that provides template rendering and
+ * common email operations for the application.
+ */
+import type { User } from '../core/index.js';
+import type { MailAdapter, MailMessage, MailResult, MailBatchResult, TemplateRenderer, TemplateData } from './types.js';
+export interface MailServiceConfig {
+    /** Mail adapter instance */
+    adapter: MailAdapter;
+    /** Template renderer instance */
+    templateRenderer: TemplateRenderer;
+    /** Default sender email */
+    defaultFrom: string;
+    /** Default sender name */
+    defaultFromName?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface SendPasswordResetOptions {
+    /** User to send reset email to */
+    user: User;
+    /** Password reset token */
+    resetToken: string;
+    /** Full reset URL */
+    resetUrl: string;
+    /** Token expiry in minutes */
+    expiryMinutes?: number;
+}
+export interface SendPasswordChangedOptions {
+    /** User whose password was changed */
+    user: User;
+    /** Timestamp of password change */
+    changedAt?: Date;
+}
+export interface SendOTPOptions {
+    /** Recipient email address */
+    to: string;
+    /** OTP code */
+    otpCode: string;
+    /** OTP expiry in minutes */
+    expiryMinutes?: number;
+    /** Purpose of OTP */
+    purpose?: string;
+}
+export interface SendSecurityAlertOptions {
+    /** User to notify */
+    user: User;
+    /** Type of security alert */
+    alertType: string;
+    /** Alert details */
+    details: string;
+    /** Timestamp of event */
+    timestamp?: Date;
+    /** Action required message */
+    actionRequired?: string;
+}
+export interface SendUserInviteOptions {
+    /** Email to send invitation to */
+    to: string;
+    /** Name of person inviting */
+    inviterName: string;
+    /** Invitation URL */
+    inviteUrl: string;
+    /** Invitation expiry date */
+    expiresAt?: Date;
+}
+export interface SendUserCreatedOptions {
+    /** User that was created */
+    user: User;
+    /** Temporary password for the user */
+    temporaryPassword: string;
+    /** Optional login URL */
+    loginUrl?: string;
+}
+export interface SendWelcomeOptions {
+    /** User to welcome */
+    user: User;
+}
+export interface SendAccountApprovedOptions {
+    /** User whose account was approved */
+    user: User;
+}
+export interface SendAccountRejectedOptions {
+    /** Email to notify */
+    to: string;
+    /** Rejection reason */
+    reason: string;
+    /** Rejection timestamp */
+    rejectedAt?: Date;
+}
+export declare class MailService {
+    private adapter;
+    private templateRenderer;
+    private defaultFrom;
+    private defaultFromName?;
+    private logger;
+    private initialized;
+    constructor(config: MailServiceConfig);
+    /**
+     * Initialize the mail service
+     */
+    initialize(): Promise<void>;
+    /**
+     * Send password reset email
+     */
+    sendPasswordReset(options: SendPasswordResetOptions): Promise<MailResult>;
+    /**
+     * Send password changed notification
+     */
+    sendPasswordChanged(options: SendPasswordChangedOptions): Promise<MailResult>;
+    /**
+     * Send OTP verification email
+     */
+    sendOTP(options: SendOTPOptions): Promise<MailResult>;
+    /**
+     * Send security alert email
+     */
+    sendSecurityAlert(options: SendSecurityAlertOptions): Promise<MailResult>;
+    /**
+     * Send user invitation email
+     */
+    sendUserInvite(options: SendUserInviteOptions): Promise<MailResult>;
+    /**
+     * Send user created email with credentials
+     */
+    sendUserCreated(options: SendUserCreatedOptions): Promise<MailResult>;
+    /**
+     * Send welcome email
+     */
+    sendWelcome(options: SendWelcomeOptions): Promise<MailResult>;
+    /**
+     * Send account approved notification
+     */
+    sendAccountApproved(options: SendAccountApprovedOptions): Promise<MailResult>;
+    /**
+     * Send account rejected notification
+     */
+    sendAccountRejected(options: SendAccountRejectedOptions): Promise<MailResult>;
+    /**
+     * Send email using a template
+     */
+    sendTemplate(templateId: string, to: string | string[], data: TemplateData): Promise<MailResult>;
+    /**
+     * Send raw email message
+     */
+    send(message: MailMessage): Promise<MailResult>;
+    /**
+     * Send batch emails
+     */
+    sendBatch(messages: MailMessage[]): Promise<MailBatchResult>;
+    /**
+     * Verify email service is working
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Get adapter name
+     */
+    getAdapterName(): string;
+    /**
+     * Get available templates
+     */
+    getAvailableTemplates(): string[];
+    /**
+     * Check if service is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Release the adapter's transport. The SMTP adapter pools TCP connections that keep the
+     * process alive once its server has stopped; the adapter is private here, so the shutdown
+     * path needs this to reach it. Adapters with nothing to release (console, Resend) simply
+     * do not define `close`, and this becomes a no-op.
+     *
+     * Sending after this will fail at the transport, so only call it while shutting down.
+     */
+    close(): Promise<void>;
+    private ensureInitialized;
+}
+//# sourceMappingURL=mail-service.d.ts.map

package/dist/mail/mail-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-service.d.ts","sourceRoot":"","sources":["../../src/mail/mail-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAE5C,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACb,MAAM,YAAY,CAAA;AAMnB,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB,iCAAiC;IACjC,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,0BAA0B;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAMD,MAAM,WAAW,wBAAwB;IACvC,kCAAkC;IAClC,IAAI,EAAE,IAAI,CAAA;IACV,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,sCAAsC;IACtC,IAAI,EAAE,IAAI,CAAA;IACV,mCAAmC;IACnC,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,eAAe;IACf,OAAO,EAAE,MAAM,CAAA;IACf,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,qBAAqB;IACrB,IAAI,EAAE,IAAI,CAAA;IACV,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,IAAI,EAAE,IAAI,CAAA;IACV,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAA;IACzB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,IAAI,EAAE,IAAI,CAAA;CACX;AAED,MAAM,WAAW,0BAA0B;IACzC,sCAAsC;IACtC,IAAI,EAAE,IAAI,CAAA;CACX;AAED,MAAM,WAAW,0BAA0B;IACzC,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,0BAA0B;IAC1B,UAAU,CAAC,EAAE,IAAI,CAAA;CAClB;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,eAAe,CAAC,CAAQ;IAChC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,WAAW,CAAiB;gBAExB,MAAM,EAAE,iBAAiB;IAerC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BjC;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC;IAwB/E;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC;IAuBnF;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAwB3D;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC;IA0B/E;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAwBzE;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;IA0B3E;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBnE;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC;IAuBnF;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC;IA2BnF;;OAEG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EACrB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,UAAU,CAAC;IAwBtB;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBrD;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAqBlE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAIjC;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,OAAO,CAAC,iBAAiB;CAK1B"}