@trokky/trokky 2.0.3

package/dist/mail/mail-service.js

@@ -0,0 +1,370 @@
+/**
+ * Mail Service
+ *
+ * High-level email service that provides template rendering and
+ * common email operations for the application.
+ */
+import { createLogger } from '../core/index.js';
+// =============================================================================
+// MAIL SERVICE CLASS
+// =============================================================================
+export class MailService {
+    adapter;
+    templateRenderer;
+    defaultFrom;
+    defaultFromName;
+    logger = createLogger('mail', 'MailService');
+    initialized = false;
+    constructor(config) {
+        this.adapter = config.adapter;
+        this.templateRenderer = config.templateRenderer;
+        this.defaultFrom = config.defaultFrom;
+        this.defaultFromName = config.defaultFromName;
+        if (config.debug) {
+            this.logger.info('MailService initialized', {
+                adapter: this.adapter.getAdapterName(),
+                defaultFrom: this.defaultFrom,
+                templates: this.templateRenderer.listTemplates(),
+            });
+        }
+    }
+    /**
+     * Initialize the mail service
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        try {
+            const isHealthy = await this.adapter.healthCheck();
+            if (!isHealthy) {
+                this.logger.warn('Mail adapter health check failed', {
+                    adapter: this.adapter.getAdapterName(),
+                });
+            }
+            this.initialized = true;
+            this.logger.info('Mail service initialized successfully', {
+                adapter: this.adapter.getAdapterName(),
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize mail service', error);
+            throw error;
+        }
+    }
+    // ==========================================================================
+    // HIGH-LEVEL EMAIL METHODS
+    // ==========================================================================
+    /**
+     * Send password reset email
+     */
+    async sendPasswordReset(options) {
+        this.ensureInitialized();
+        const template = this.templateRenderer.render('password-reset', {
+            firstName: options.user.firstName,
+            resetUrl: options.resetUrl,
+            expiryMinutes: options.expiryMinutes || 60,
+        });
+        this.logger.info('Sending password reset email', {
+            to: options.user.email,
+            userId: options.user.id,
+        });
+        return this.adapter.send({
+            from: this.defaultFrom,
+            fromName: this.defaultFromName,
+            to: options.user.email,
+            subject: template.subject,
+            html: template.html,
+            text: template.text,
+        });
+    }
+    /**
+     * Send password changed notification
+     */
+    async sendPasswordChanged(options) {
+        this.ensureInitialized();
+        const template = this.templateRenderer.render('password-changed', {
+            firstName: options.user.firstName,
+            changedAt: options.changedAt || new Date(),
+        });
+        this.logger.info('Sending password changed notification', {
+            to: options.user.email,
+            userId: options.user.id,
+        });
+        return this.adapter.send({
+            from: this.defaultFrom,
+            fromName: this.defaultFromName,
+            to: options.user.email,
+            subject: template.subject,
+            html: template.html,
+            text: template.text,
+        });
+    }
+    /**
+     * Send OTP verification email
+     */
+    async sendOTP(options) {
+        this.ensureInitialized();
+        const template = this.templateRenderer.render('otp-verification', {
+            otpCode: options.otpCode,
+            expiryMinutes: options.expiryMinutes || 10,
+            purpose: options.purpose || 'account verification',
+        });
+        this.logger.info('Sending OTP verification email', {
+            to: options.to,
+            purpose: options.purpose,
+        });
+        return this.adapter.send({
+            from: this.defaultFrom,
+            fromName: this.defaultFromName,
+            to: options.to,
+            subject: template.subject,
+            html: template.html,
+            text: template.text,
+        });
+    }
+    /**
+     * Send security alert email
+     */
+    async sendSecurityAlert(options) {
+        this.ensureInitialized();
+        const template = this.templateRenderer.render('security-alert', {
+            alertType: options.alertType,
+            details: options.details,
+            timestamp: options.timestamp || new Date(),
+            actionRequired: options.actionRequired,
+        });
+        this.logger.warn('Sending security alert email', {
+            to: options.user.email,
+            userId: options.user.id,
+            alertType: options.alertType,
+        });
+        return this.adapter.send({
+            from: this.defaultFrom,
+            fromName: this.defaultFromName,
+            to: options.user.email,
+            subject: template.subject,
+            html: template.html,
+            text: template.text,
+        });
+    }
+    /**
+     * Send user invitation email
+     */
+    async sendUserInvite(options) {
+        this.ensureInitialized();
+        const template = this.templateRenderer.render('user-invite', {
+            inviterName: options.inviterName,
+            inviteUrl: options.inviteUrl,
+            expiresAt: options.expiresAt,
+        });
+        this.logger.info('Sending user invitation email', {
+            to: options.to,
+            inviterName: options.inviterName,
+        });
+        return this.adapter.send({
+            from: this.defaultFrom,
+            fromName: this.defaultFromName,
+            to: options.to,
+            subject: template.subject,
+            html: template.html,
+            text: template.text,
+        });
+    }
+    /**
+     * Send user created email with credentials
+     */
+    async sendUserCreated(options) {
+        this.ensureInitialized();
+        const template = this.templateRenderer.render('user-created', {
+            firstName: options.user.firstName,
+            email: options.user.email,
+            username: options.user.username,
+            temporaryPassword: options.temporaryPassword,
+            loginUrl: options.loginUrl,
+        });
+        this.logger.info('Sending user created email with credentials', {
+            to: options.user.email,
+            userId: options.user.id,
+        });
+        return this.adapter.send({
+            from: this.defaultFrom,
+            fromName: this.defaultFromName,
+            to: options.user.email,
+            subject: template.subject,
+            html: template.html,
+            text: template.text,
+        });
+    }
+    /**
+     * Send welcome email
+     */
+    async sendWelcome(options) {
+        this.ensureInitialized();
+        const template = this.templateRenderer.render('welcome', {
+            firstName: options.user.firstName,
+        });
+        this.logger.info('Sending welcome email', {
+            to: options.user.email,
+            userId: options.user.id,
+        });
+        return this.adapter.send({
+            from: this.defaultFrom,
+            fromName: this.defaultFromName,
+            to: options.user.email,
+            subject: template.subject,
+            html: template.html,
+            text: template.text,
+        });
+    }
+    /**
+     * Send account approved notification
+     */
+    async sendAccountApproved(options) {
+        this.ensureInitialized();
+        const template = this.templateRenderer.render('account-approved', {
+            firstName: options.user.firstName,
+            email: options.user.email,
+        });
+        this.logger.info('Sending account approved notification', {
+            to: options.user.email,
+            userId: options.user.id,
+        });
+        return this.adapter.send({
+            from: this.defaultFrom,
+            fromName: this.defaultFromName,
+            to: options.user.email,
+            subject: template.subject,
+            html: template.html,
+            text: template.text,
+        });
+    }
+    /**
+     * Send account rejected notification
+     */
+    async sendAccountRejected(options) {
+        this.ensureInitialized();
+        const template = this.templateRenderer.render('account-rejected', {
+            reason: options.reason,
+            rejectedAt: options.rejectedAt || new Date(),
+        });
+        this.logger.info('Sending account rejected notification', {
+            to: options.to,
+            reason: options.reason,
+        });
+        return this.adapter.send({
+            from: this.defaultFrom,
+            fromName: this.defaultFromName,
+            to: options.to,
+            subject: template.subject,
+            html: template.html,
+            text: template.text,
+        });
+    }
+    // ==========================================================================
+    // GENERIC EMAIL METHODS
+    // ==========================================================================
+    /**
+     * Send email using a template
+     */
+    async sendTemplate(templateId, to, data) {
+        this.ensureInitialized();
+        if (!this.templateRenderer.hasTemplate(templateId)) {
+            throw new Error(`Template not found: ${templateId}`);
+        }
+        const template = this.templateRenderer.render(templateId, data);
+        this.logger.info('Sending templated email', {
+            to,
+            templateId,
+        });
+        return this.adapter.send({
+            from: template.from || this.defaultFrom,
+            fromName: template.fromName || this.defaultFromName,
+            to,
+            subject: template.subject,
+            html: template.html,
+            text: template.text,
+        });
+    }
+    /**
+     * Send raw email message
+     */
+    async send(message) {
+        this.ensureInitialized();
+        // Apply defaults if not provided
+        const fullMessage = {
+            ...message,
+            from: message.from || this.defaultFrom,
+            fromName: message.fromName || this.defaultFromName,
+        };
+        this.logger.info('Sending email', {
+            to: fullMessage.to,
+            subject: fullMessage.subject,
+        });
+        return this.adapter.send(fullMessage);
+    }
+    /**
+     * Send batch emails
+     */
+    async sendBatch(messages) {
+        this.ensureInitialized();
+        // Apply defaults to all messages
+        const fullMessages = messages.map((message) => ({
+            ...message,
+            from: message.from || this.defaultFrom,
+            fromName: message.fromName || this.defaultFromName,
+        }));
+        this.logger.info('Sending batch emails', {
+            count: fullMessages.length,
+        });
+        return this.adapter.sendBatch(fullMessages);
+    }
+    // ==========================================================================
+    // UTILITY METHODS
+    // ==========================================================================
+    /**
+     * Verify email service is working
+     */
+    async healthCheck() {
+        return this.adapter.healthCheck();
+    }
+    /**
+     * Get adapter name
+     */
+    getAdapterName() {
+        return this.adapter.getAdapterName();
+    }
+    /**
+     * Get available templates
+     */
+    getAvailableTemplates() {
+        return this.templateRenderer.listTemplates();
+    }
+    /**
+     * Check if service is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * 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.
+     */
+    async close() {
+        await this.adapter.close?.();
+        this.initialized = false;
+    }
+    // ==========================================================================
+    // PRIVATE METHODS
+    // ==========================================================================
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('Mail service not initialized. Call initialize() first.');
+        }
+    }
+}
+//# sourceMappingURL=mail-service.js.map

package/dist/mail/mail-service.js.map

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

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

@@ -0,0 +1,82 @@
+/**
+ * Mail Notification Service
+ *
+ * Event-driven email notification service for Trokky CMS.
+ * Listens to system events and sends appropriate emails.
+ */
+import type { TrokkyEventBus, TrokkyCore } from '../core/index.js';
+import type { MailService } from './mail-service.js';
+export interface MailNotificationConfig {
+    /** Mail service instance */
+    mailService: MailService;
+    /** Base URL for the application (used in email links) */
+    baseUrl: string;
+    /** TrokkyCore instance for secure callback registration */
+    core: TrokkyCore;
+    /** Notification settings */
+    enabled?: {
+        passwordReset?: boolean;
+        passwordChanged?: boolean;
+        userCreated?: boolean;
+        userInvited?: boolean;
+        securityAlerts?: boolean;
+        mfaOtp?: boolean;
+    };
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export declare class MailNotificationService {
+    private mailService;
+    private eventBus;
+    private core;
+    private baseUrl;
+    private enabled;
+    private logger;
+    private initialized;
+    constructor(eventBus: TrokkyEventBus, config: MailNotificationConfig);
+    /**
+     * Initialize the notification service and setup event listeners
+     */
+    initialize(): Promise<void>;
+    /**
+     * Setup event listeners for various user events
+     */
+    private setupEventListeners;
+    /**
+     * Send password reset email
+     */
+    private sendPasswordResetEmail;
+    /**
+     * Send password changed notification
+     */
+    private sendPasswordChangedEmail;
+    /**
+     * Send user created email with credentials
+     */
+    private sendUserCreatedEmail;
+    /**
+     * Send user invitation email
+     */
+    private sendUserInviteEmail;
+    /**
+     * Send security alert email
+     */
+    private sendSecurityAlertEmail;
+    /**
+     * Send MFA OTP verification email
+     */
+    private sendMFAOTPEmail;
+    /**
+     * Check if service is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Disable all notifications temporarily
+     */
+    disableAll(): void;
+    /**
+     * Enable all notifications
+     */
+    enableAll(): void;
+}
+//# sourceMappingURL=notification-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notification-service.d.ts","sourceRoot":"","sources":["../../src/mail/notification-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAmB,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,WAAW,EAAE,WAAW,CAAA;IAExB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAA;IAEf,2DAA2D;IAC3D,IAAI,EAAE,UAAU,CAAA;IAEhB,4BAA4B;IAC5B,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,eAAe,CAAC,EAAE,OAAO,CAAA;QACzB,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,MAAM,CAAC,EAAE,OAAO,CAAA;KACjB,CAAA;IAED,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAA0D;IACzE,OAAO,CAAC,MAAM,CAAkD;IAChE,OAAO,CAAC,WAAW,CAAQ;gBAEf,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,sBAAsB;IAwBpE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsF3B;;OAEG;YACW,sBAAsB;IAgBpC;;OAEG;YACW,wBAAwB;IAYtC;;OAEG;YACW,oBAAoB;IAelC;;OAEG;YACW,mBAAmB;IAmBjC;;OAEG;YACW,sBAAsB;IAqBpC;;OAEG;YACW,eAAe;IAmB7B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,UAAU,IAAI,IAAI;IAYlB;;OAEG;IACH,SAAS,IAAI,IAAI;CAWlB"}