@trokky/trokky 2.0.3

package/dist/mail/templates/built-in-templates.js

@@ -0,0 +1,416 @@
+/**
+ * Built-In Email Templates
+ *
+ * Professional, responsive email templates for common use cases.
+ * Templates are defined as methods for type safety and flexibility.
+ */
+export class BuiltInTemplateRenderer {
+    brandName;
+    brandColor;
+    supportEmail;
+    baseUrl;
+    constructor(options) {
+        this.brandName = options.brandName;
+        this.brandColor = options.brandColor || '#667eea';
+        this.supportEmail = options.supportEmail;
+        this.baseUrl = options.baseUrl;
+    }
+    render(templateId, data) {
+        const method = this.templates[templateId];
+        if (!method) {
+            throw new Error(`Template not found: ${templateId}`);
+        }
+        return method.call(this, data);
+    }
+    hasTemplate(templateId) {
+        return templateId in this.templates;
+    }
+    listTemplates() {
+        return Object.keys(this.templates);
+    }
+    // Template registry mapping IDs to render methods
+    templates = {
+        'password-reset': this.renderPasswordReset.bind(this),
+        'password-changed': this.renderPasswordChanged.bind(this),
+        'user-invite': this.renderUserInvite.bind(this),
+        'user-created': this.renderUserCreated.bind(this),
+        'welcome': this.renderWelcome.bind(this),
+        'otp-verification': this.renderOTPVerification.bind(this),
+        'security-alert': this.renderSecurityAlert.bind(this),
+        'account-approved': this.renderAccountApproved.bind(this),
+        'account-rejected': this.renderAccountRejected.bind(this),
+    };
+    // ==========================================================================
+    // TEMPLATE RENDERING METHODS
+    // ==========================================================================
+    renderPasswordReset(data) {
+        const { firstName, resetUrl, expiryMinutes = 60 } = data;
+        return {
+            subject: `Reset your password - ${this.brandName}`,
+            html: this.wrapInLayout(`
+        <h1>Password Reset Request</h1>
+        <p>Hello ${this.escapeHtml(firstName)},</p>
+        <p>You've requested to reset your password for your ${this.brandName} account.</p>
+
+        <div style="background: white; border: 2px solid ${this.brandColor}; border-radius: 8px; padding: 20px; margin: 25px 0; text-align: center;">
+          <a href="${this.escapeHtml(resetUrl)}" style="background: ${this.brandColor}; color: white; padding: 15px 40px; text-decoration: none; border-radius: 5px; display: inline-block; font-weight: bold;">Reset Password</a>
+        </div>
+
+        <p style="color: #e74c3c; font-weight: bold;">⏰ This link will expire in ${expiryMinutes} minutes.</p>
+        <p>If you didn't request this password reset, please ignore this email or contact support if you have concerns.</p>
+
+        <p style="font-size: 12px; color: #999; margin-top: 20px;">If the button doesn't work, copy and paste this link into your browser:<br>
+        <a href="${this.escapeHtml(resetUrl)}" style="color: #667eea; word-break: break-all;">${this.escapeHtml(resetUrl)}</a></p>
+      `),
+            text: `
+Password Reset Request
+
+Hello ${firstName},
+
+You've requested to reset your password for your ${this.brandName} account.
+
+Reset your password here: ${resetUrl}
+
+This link will expire in ${expiryMinutes} minutes.
+
+If you didn't request this password reset, please ignore this email or contact support if you have concerns.
+      `.trim(),
+        };
+    }
+    renderPasswordChanged(data) {
+        const { firstName, changedAt } = data;
+        return {
+            subject: `Your password has been changed - ${this.brandName}`,
+            html: this.wrapInLayout(`
+        <h1>🔒 Password Changed</h1>
+        <p>Hello ${this.escapeHtml(firstName)},</p>
+        <p>Your password was successfully changed on ${changedAt.toLocaleString()}.</p>
+
+        <div style="background: #d4edda; border: 1px solid #c3e6cb; border-radius: 5px; padding: 15px; margin: 20px 0;">
+          <p style="margin: 0; color: #155724;">✓ Your account is secure</p>
+        </div>
+
+        <p>If you didn't make this change, please contact support immediately${this.supportEmail ? ` at ${this.supportEmail}` : ''}.</p>
+      `),
+            text: `
+Password Changed
+
+Hello ${firstName},
+
+Your password was successfully changed on ${changedAt.toLocaleString()}.
+
+If you didn't make this change, please contact support immediately${this.supportEmail ? ` at ${this.supportEmail}` : ''}.
+      `.trim(),
+        };
+    }
+    renderOTPVerification(data) {
+        const { otpCode, expiryMinutes = 10, purpose = 'account verification' } = data;
+        return {
+            subject: `Your verification code for ${purpose}`,
+            html: this.wrapInLayout(`
+        <h1>Email Verification</h1>
+        <p>You've requested to verify your email for <strong>${this.escapeHtml(purpose)}</strong>.</p>
+
+        <div style="background: white; border: 2px dashed ${this.brandColor}; border-radius: 8px; padding: 20px; margin: 25px 0; text-align: center;">
+          <p style="margin: 0 0 10px 0; font-size: 14px; color: #666;">Your verification code is:</p>
+          <p style="font-size: 32px; font-weight: bold; color: ${this.brandColor}; letter-spacing: 8px; margin: 0;">${this.escapeHtml(otpCode)}</p>
+        </div>
+
+        <p style="color: #e74c3c; font-weight: bold;">⏰ This code will expire in ${expiryMinutes} minutes.</p>
+        <p>If you didn't request this verification code, please ignore this email.</p>
+      `),
+            text: `
+Email Verification
+
+You've requested to verify your email for ${purpose}.
+
+Your verification code is: ${otpCode}
+
+This code will expire in ${expiryMinutes} minutes.
+
+If you didn't request this verification code, please ignore this email.
+      `.trim(),
+        };
+    }
+    renderSecurityAlert(data) {
+        const { alertType, details, timestamp, actionRequired } = data;
+        return {
+            subject: `Security Alert: ${alertType}`,
+            html: this.wrapInLayout(`
+        <h1>🔒 Security Alert</h1>
+        <p>We detected the following security event on your account:</p>
+
+        <div style="background: white; border-left: 4px solid #f5576c; padding: 15px; margin: 20px 0;">
+          <p style="margin: 0; font-weight: bold; color: #f5576c;">${this.escapeHtml(alertType)}</p>
+          <p style="margin: 10px 0 0 0; color: #666;">${this.escapeHtml(details)}</p>
+          <p style="margin: 10px 0 0 0; font-size: 12px; color: #999;">Time: ${timestamp.toLocaleString()}</p>
+        </div>
+
+        ${actionRequired ? `
+        <div style="background: #fff3cd; border: 1px solid #ffc107; border-radius: 5px; padding: 15px; margin: 20px 0;">
+          <p style="margin: 0; font-weight: bold; color: #856404;">⚠️ Action Required:</p>
+          <p style="margin: 10px 0 0 0; color: #856404;">${this.escapeHtml(actionRequired)}</p>
+        </div>
+        ` : ''}
+
+        <p>If this wasn't you, please secure your account immediately and contact support.</p>
+      `),
+            text: `
+Security Alert
+
+We detected the following security event on your account:
+
+${alertType}
+${details}
+Time: ${timestamp.toLocaleString()}
+
+${actionRequired ? `Action Required: ${actionRequired}\n` : ''}
+If this wasn't you, please secure your account immediately and contact support.
+      `.trim(),
+        };
+    }
+    renderUserInvite(data) {
+        const { inviterName, inviteUrl, expiresAt } = data;
+        return {
+            subject: `You've been invited to ${this.brandName}`,
+            html: this.wrapInLayout(`
+        <h1>🎉 You're Invited!</h1>
+        <p><strong>${this.escapeHtml(inviterName)}</strong> has invited you to join ${this.brandName}.</p>
+
+        <div style="text-align: center; margin: 30px 0;">
+          <a href="${this.escapeHtml(inviteUrl)}" style="background: ${this.brandColor}; color: white; padding: 15px 40px; text-decoration: none; border-radius: 5px; display: inline-block; font-weight: bold;">Accept Invitation</a>
+        </div>
+
+        ${expiresAt ? `<p style="color: #e74c3c;">⏰ This invitation expires on ${expiresAt.toLocaleDateString()}.</p>` : ''}
+
+        <p style="font-size: 12px; color: #999; margin-top: 20px;">If the button doesn't work, copy and paste this link into your browser:<br>
+        <a href="${this.escapeHtml(inviteUrl)}" style="color: #667eea; word-break: break-all;">${this.escapeHtml(inviteUrl)}</a></p>
+      `),
+            text: `
+You're Invited!
+
+${inviterName} has invited you to join ${this.brandName}.
+
+Accept invitation: ${inviteUrl}
+
+${expiresAt ? `This invitation expires on ${expiresAt.toLocaleDateString()}.` : ''}
+      `.trim(),
+        };
+    }
+    renderUserCreated(data) {
+        const { firstName, email, username, temporaryPassword, loginUrl } = data;
+        return {
+            subject: `Your ${this.brandName} account has been created`,
+            html: this.wrapInLayout(`
+        <h1>Welcome to ${this.brandName}! 🎉</h1>
+        <p>Hello ${this.escapeHtml(firstName)},</p>
+        <p>An administrator has created an account for you. Here are your login credentials:</p>
+
+        <div style="background: #f8f9fa; border: 2px solid ${this.brandColor}; border-radius: 8px; padding: 20px; margin: 25px 0;">
+          <div style="margin-bottom: 15px;">
+            <p style="margin: 0; font-size: 12px; color: #666; text-transform: uppercase; letter-spacing: 1px;">Email</p>
+            <p style="margin: 5px 0 0 0; font-size: 16px; font-weight: bold; color: #333;">${this.escapeHtml(email)}</p>
+          </div>
+          <div style="margin-bottom: 15px;">
+            <p style="margin: 0; font-size: 12px; color: #666; text-transform: uppercase; letter-spacing: 1px;">Username</p>
+            <p style="margin: 5px 0 0 0; font-size: 16px; font-weight: bold; color: #333;">${this.escapeHtml(username)}</p>
+          </div>
+          <div>
+            <p style="margin: 0; font-size: 12px; color: #666; text-transform: uppercase; letter-spacing: 1px;">Temporary Password</p>
+            <p style="margin: 5px 0 0 0; font-size: 16px; font-weight: bold; color: ${this.brandColor}; font-family: monospace;">${this.escapeHtml(temporaryPassword)}</p>
+          </div>
+        </div>
+
+        <div style="background: #fff3cd; border: 1px solid #ffc107; border-radius: 5px; padding: 15px; margin: 20px 0;">
+          <p style="margin: 0; font-weight: bold; color: #856404;">🔒 Security Recommendation:</p>
+          <p style="margin: 10px 0 0 0; color: #856404;">Please change your password after your first login to ensure your account security.</p>
+        </div>
+
+        ${loginUrl ? `
+        <div style="text-align: center; margin: 30px 0;">
+          <a href="${this.escapeHtml(loginUrl)}" style="background: ${this.brandColor}; color: white; padding: 15px 40px; text-decoration: none; border-radius: 5px; display: inline-block; font-weight: bold;">Log In Now</a>
+        </div>
+        ` : ''}
+
+        <p>You can now:</p>
+        <ul style="color: #666;">
+          <li>Create and manage content</li>
+          <li>Collaborate with your team</li>
+          <li>Publish to your website</li>
+        </ul>
+
+        <p>If you have any questions, feel free to reach out to our support team${this.supportEmail ? ` at ${this.supportEmail}` : ''}.</p>
+
+        ${loginUrl ? `
+        <p style="font-size: 12px; color: #999; margin-top: 20px;">If the button doesn't work, copy and paste this link into your browser:<br>
+        <a href="${this.escapeHtml(loginUrl)}" style="color: #667eea; word-break: break-all;">${this.escapeHtml(loginUrl)}</a></p>
+        ` : ''}
+      `),
+            text: `
+Welcome to ${this.brandName}!
+
+Hello ${firstName},
+
+An administrator has created an account for you. Here are your login credentials:
+
+Email: ${email}
+Username: ${username}
+Temporary Password: ${temporaryPassword}
+
+SECURITY RECOMMENDATION: Please change your password after your first login to ensure your account security.
+
+${loginUrl ? `Log in here: ${loginUrl}\n` : ''}
+You can now:
+- Create and manage content
+- Collaborate with your team
+- Publish to your website
+
+If you have any questions, feel free to reach out to our support team${this.supportEmail ? ` at ${this.supportEmail}` : ''}.
+      `.trim(),
+        };
+    }
+    renderWelcome(data) {
+        const { firstName } = data;
+        return {
+            subject: `Welcome to ${this.brandName}!`,
+            html: this.wrapInLayout(`
+        <h1>Welcome ${this.escapeHtml(firstName)}! 🎉</h1>
+        <p>Your account has been created successfully.</p>
+
+        <p>You can now:</p>
+        <ul style="color: #666;">
+          <li>Create and manage content</li>
+          <li>Collaborate with your team</li>
+          <li>Publish to your website</li>
+        </ul>
+
+        <p>If you have any questions, feel free to reach out to our support team.</p>
+      `),
+            text: `
+Welcome ${firstName}!
+
+Your account has been created successfully.
+
+You can now:
+- Create and manage content
+- Collaborate with your team
+- Publish to your website
+
+If you have any questions, feel free to reach out to our support team.
+      `.trim(),
+        };
+    }
+    renderAccountApproved(data) {
+        const { firstName, email } = data;
+        return {
+            subject: 'Your account has been approved!',
+            html: this.wrapInLayout(`
+        <h1>🎉 Welcome ${this.escapeHtml(firstName)}!</h1>
+        <p>Great news! Your account registration has been approved.</p>
+
+        <div style="background: white; border: 2px solid ${this.brandColor}; border-radius: 8px; padding: 20px; margin: 25px 0;">
+          <p style="margin: 0; font-size: 14px; color: #666;">Account Email:</p>
+          <p style="font-size: 18px; font-weight: bold; color: ${this.brandColor}; margin: 10px 0 0 0;">${this.escapeHtml(email)}</p>
+        </div>
+
+        <p>You can now log in and start using ${this.brandName}.</p>
+      `),
+            text: `
+Welcome ${firstName}!
+
+Great news! Your account registration has been approved.
+
+Account Email: ${email}
+
+You can now log in and start using ${this.brandName}.
+      `.trim(),
+        };
+    }
+    renderAccountRejected(data) {
+        const { reason, rejectedAt } = data;
+        return {
+            subject: 'Registration Request Update',
+            html: this.wrapInLayout(`
+        <h1>Registration Status Update</h1>
+        <p>Thank you for your interest in ${this.brandName}. After reviewing your registration request, we are unable to approve your account at this time.</p>
+
+        <div style="background: white; border-left: 4px solid #e74c3c; padding: 15px; margin: 20px 0;">
+          <p style="margin: 0; font-weight: bold; color: #e74c3c;">Registration Declined</p>
+          <p style="margin: 10px 0 0 0; color: #666;">Reason: ${this.escapeHtml(reason)}</p>
+          <p style="margin: 10px 0 0 0; font-size: 12px; color: #999;">Declined at: ${rejectedAt.toLocaleString()}</p>
+        </div>
+
+        <p>If you believe this was in error or have questions, please contact our support team${this.supportEmail ? ` at ${this.supportEmail}` : ''}.</p>
+      `),
+            text: `
+Registration Status Update
+
+Thank you for your interest in ${this.brandName}. After reviewing your registration request, we are unable to approve your account at this time.
+
+Reason: ${reason}
+Declined at: ${rejectedAt.toLocaleString()}
+
+If you believe this was in error or have questions, please contact our support team${this.supportEmail ? ` at ${this.supportEmail}` : ''}.
+      `.trim(),
+        };
+    }
+    // ==========================================================================
+    // LAYOUT WRAPPER
+    // ==========================================================================
+    wrapInLayout(content) {
+        return `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${this.brandName}</title>
+</head>
+<body style="font-family: Arial, sans-serif; line-height: 1.6; color: #333; max-width: 600px; margin: 0 auto; padding: 20px; background-color: #f4f4f4;">
+  <div style="background: linear-gradient(135deg, ${this.brandColor} 0%, ${this.adjustColor(this.brandColor, -20)} 100%); padding: 30px; text-align: center; border-radius: 10px 10px 0 0;">
+    <h1 style="color: white; margin: 0; font-size: 24px;">${this.brandName}</h1>
+  </div>
+
+  <div style="background: white; padding: 30px; border-radius: 0 0 10px 10px; box-shadow: 0 2px 4px rgba(0,0,0,0.1);">
+    ${content}
+
+    <hr style="border: none; border-top: 1px solid #ddd; margin: 30px 0;">
+
+    <p style="font-size: 12px; color: #999; text-align: center; margin: 0;">
+      This is an automated message from ${this.brandName}. Please do not reply to this email.
+      ${this.supportEmail ? `<br>For support, contact <a href="mailto:${this.supportEmail}" style="color: ${this.brandColor};">${this.supportEmail}</a>` : ''}
+    </p>
+  </div>
+</body>
+</html>
+    `.trim();
+    }
+    // ==========================================================================
+    // UTILITY METHODS
+    // ==========================================================================
+    /**
+     * Darken or lighten a hex color
+     */
+    adjustColor(color, percent) {
+        const num = parseInt(color.replace('#', ''), 16);
+        const amt = Math.round(2.55 * percent);
+        const R = Math.max(0, Math.min(255, (num >> 16) + amt));
+        const G = Math.max(0, Math.min(255, ((num >> 8) & 0x00ff) + amt));
+        const B = Math.max(0, Math.min(255, (num & 0x0000ff) + amt));
+        return '#' + ((R << 16) | (G << 8) | B).toString(16).padStart(6, '0');
+    }
+    /**
+     * Escape HTML special characters
+     */
+    escapeHtml(text) {
+        const map = {
+            '&': '&amp;',
+            '<': '&lt;',
+            '>': '&gt;',
+            '"': '&quot;',
+            "'": '&#039;',
+        };
+        return text.replace(/[&<>"']/g, (char) => map[char]);
+    }
+}
+//# sourceMappingURL=built-in-templates.js.map

package/dist/mail/templates/built-in-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-templates.js","sourceRoot":"","sources":["../../../src/mail/templates/built-in-templates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,OAAO,uBAAuB;IACjB,SAAS,CAAQ;IACjB,UAAU,CAAQ;IAClB,YAAY,CAAS;IACrB,OAAO,CAAS;IAEjC,YAAY,OAA+B;QACzC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;QAClC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,SAAS,CAAA;QACjD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAChC,CAAC;IAED,MAAM,CAAC,UAAkB,EAAE,IAAkB;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAA;QACtD,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAChC,CAAC;IAED,WAAW,CAAC,UAAkB;QAC5B,OAAO,UAAU,IAAI,IAAI,CAAC,SAAS,CAAA;IACrC,CAAC;IAED,aAAa;QACX,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACpC,CAAC;IAED,kDAAkD;IAC1C,SAAS,GAA6D;QAC5E,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;QACrD,kBAAkB,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QACzD,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/C,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;QACjD,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QACxC,kBAAkB,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QACzD,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;QACrD,kBAAkB,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QACzD,kBAAkB,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;KAC1D,CAAA;IAED,6EAA6E;IAC7E,6BAA6B;IAC7B,6EAA6E;IAErE,mBAAmB,CAAC,IAAkB;QAC5C,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,EAAE,EAAE,GAAG,IAInD,CAAA;QAED,OAAO;YACL,OAAO,EAAE,yBAAyB,IAAI,CAAC,SAAS,EAAE;YAClD,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC;;mBAEX,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;8DACiB,IAAI,CAAC,SAAS;;2DAEjB,IAAI,CAAC,UAAU;qBACrD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,wBAAwB,IAAI,CAAC,UAAU;;;mFAGF,aAAa;;;;mBAI7E,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,oDAAoD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;OAClH,CAAC;YACF,IAAI,EAAE;;;QAGJ,SAAS;;mDAEkC,IAAI,CAAC,SAAS;;4BAErC,QAAQ;;2BAET,aAAa;;;OAGjC,CAAC,IAAI,EAAE;SACT,CAAA;IACH,CAAC;IAEO,qBAAqB,CAAC,IAAkB;QAC9C,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAGhC,CAAA;QAED,OAAO;YACL,OAAO,EAAE,oCAAoC,IAAI,CAAC,SAAS,EAAE;YAC7D,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC;;mBAEX,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;uDACU,SAAS,CAAC,cAAc,EAAE;;;;;;+EAMF,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;OAC3H,CAAC;YACF,IAAI,EAAE;;;QAGJ,SAAS;;4CAE2B,SAAS,CAAC,cAAc,EAAE;;oEAEF,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;OAChH,CAAC,IAAI,EAAE;SACT,CAAA;IACH,CAAC;IAEO,qBAAqB,CAAC,IAAkB;QAC9C,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,EAAE,EAAE,OAAO,GAAG,sBAAsB,EAAE,GAAG,IAIzE,CAAA;QAED,OAAO;YACL,OAAO,EAAE,8BAA8B,OAAO,EAAE;YAChD,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC;;+DAEiC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;;4DAE3B,IAAI,CAAC,UAAU;;iEAEV,IAAI,CAAC,UAAU,sCAAsC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;;;mFAG3D,aAAa;;OAEzF,CAAC;YACF,IAAI,EAAE;;;4CAGgC,OAAO;;6BAEtB,OAAO;;2BAET,aAAa;;;OAGjC,CAAC,IAAI,EAAE;SACT,CAAA;IACH,CAAC;IAEO,mBAAmB,CAAC,IAAkB;QAC5C,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,IAKzD,CAAA;QAED,OAAO;YACL,OAAO,EAAE,mBAAmB,SAAS,EAAE;YACvC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC;;;;;qEAKuC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;wDACvC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;+EACD,SAAS,CAAC,cAAc,EAAE;;;UAG/F,cAAc,CAAC,CAAC,CAAC;;;2DAGgC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;;SAEjF,CAAC,CAAC,CAAC,EAAE;;;OAGP,CAAC;YACF,IAAI,EAAE;;;;;EAKV,SAAS;EACT,OAAO;QACD,SAAS,CAAC,cAAc,EAAE;;EAEhC,cAAc,CAAC,CAAC,CAAC,oBAAoB,cAAc,IAAI,CAAC,CAAC,CAAC,EAAE;;OAEvD,CAAC,IAAI,EAAE;SACT,CAAA;IACH,CAAC;IAEO,gBAAgB,CAAC,IAAkB;QACzC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAI7C,CAAA;QAED,OAAO;YACL,OAAO,EAAE,0BAA0B,IAAI,CAAC,SAAS,EAAE;YACnD,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC;;qBAET,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,qCAAqC,IAAI,CAAC,SAAS;;;qBAG/E,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,wBAAwB,IAAI,CAAC,UAAU;;;UAG5E,SAAS,CAAC,CAAC,CAAC,2DAA2D,SAAS,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE;;;mBAGxG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,oDAAoD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;OACpH,CAAC;YACF,IAAI,EAAE;;;EAGV,WAAW,4BAA4B,IAAI,CAAC,SAAS;;qBAElC,SAAS;;EAE5B,SAAS,CAAC,CAAC,CAAC,8BAA8B,SAAS,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE;OAC3E,CAAC,IAAI,EAAE;SACT,CAAA;IACH,CAAC;IAEO,iBAAiB,CAAC,IAAkB;QAC1C,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,GAAG,IAMnE,CAAA;QAED,OAAO;YACL,OAAO,EAAE,QAAQ,IAAI,CAAC,SAAS,2BAA2B;YAC1D,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC;yBACL,IAAI,CAAC,SAAS;mBACpB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;;;6DAGgB,IAAI,CAAC,UAAU;;;6FAGiB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;;;;6FAItB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;;;;sFAIhC,IAAI,CAAC,UAAU,8BAA8B,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC;;;;;;;;;UAS3J,QAAQ,CAAC,CAAC,CAAC;;qBAEA,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,wBAAwB,IAAI,CAAC,UAAU;;SAE5E,CAAC,CAAC,CAAC,EAAE;;;;;;;;;kFASoE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;;UAE3H,QAAQ,CAAC,CAAC,CAAC;;mBAEF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,oDAAoD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;SAChH,CAAC,CAAC,CAAC,EAAE;OACP,CAAC;YACF,IAAI,EAAE;aACC,IAAI,CAAC,SAAS;;QAEnB,SAAS;;;;SAIR,KAAK;YACF,QAAQ;sBACE,iBAAiB;;;;EAIrC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE;;;;;;uEAMyB,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;OACnH,CAAC,IAAI,EAAE;SACT,CAAA;IACH,CAAC;IAEO,aAAa,CAAC,IAAkB;QACtC,MAAM,EAAE,SAAS,EAAE,GAAG,IAA6B,CAAA;QAEnD,OAAO;YACL,OAAO,EAAE,cAAc,IAAI,CAAC,SAAS,GAAG;YACxC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC;sBACR,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;;;;;;;;;;;OAWzC,CAAC;YACF,IAAI,EAAE;UACF,SAAS;;;;;;;;;;OAUZ,CAAC,IAAI,EAAE;SACT,CAAA;IACH,CAAC;IAEO,qBAAqB,CAAC,IAAkB;QAC9C,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAA4C,CAAA;QAEzE,OAAO;YACL,OAAO,EAAE,iCAAiC;YAC1C,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC;yBACL,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;;;2DAGQ,IAAI,CAAC,UAAU;;iEAET,IAAI,CAAC,UAAU,0BAA0B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;;;gDAGhF,IAAI,CAAC,SAAS;OACvD,CAAC;YACF,IAAI,EAAE;UACF,SAAS;;;;iBAIF,KAAK;;qCAEe,IAAI,CAAC,SAAS;OAC5C,CAAC,IAAI,EAAE;SACT,CAAA;IACH,CAAC;IAEO,qBAAqB,CAAC,IAAkB;QAC9C,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAA4C,CAAA;QAE3E,OAAO;YACL,OAAO,EAAE,6BAA6B;YACtC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC;;4CAEc,IAAI,CAAC,SAAS;;;;gEAIM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;sFACD,UAAU,CAAC,cAAc,EAAE;;;gGAGjB,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;OAC5I,CAAC;YACF,IAAI,EAAE;;;iCAGqB,IAAI,CAAC,SAAS;;UAErC,MAAM;eACD,UAAU,CAAC,cAAc,EAAE;;qFAE2C,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;OACjI,CAAC,IAAI,EAAE;SACT,CAAA;IACH,CAAC;IAED,6EAA6E;IAC7E,iBAAiB;IACjB,6EAA6E;IAErE,YAAY,CAAC,OAAe;QAClC,OAAO;;;;;;WAMA,IAAI,CAAC,SAAS;;;oDAG2B,IAAI,CAAC,UAAU,QAAQ,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;4DACrD,IAAI,CAAC,SAAS;;;;MAIpE,OAAO;;;;;0CAK6B,IAAI,CAAC,SAAS;QAChD,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,4CAA4C,IAAI,CAAC,YAAY,mBAAmB,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,YAAY,MAAM,CAAC,CAAC,CAAC,EAAE;;;;;KAKxJ,CAAC,IAAI,EAAE,CAAA;IACV,CAAC;IAED,6EAA6E;IAC7E,kBAAkB;IAClB,6EAA6E;IAE7E;;OAEG;IACK,WAAW,CAAC,KAAa,EAAE,OAAe;QAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,CAAA;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;QACvD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;QACjE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;QAC5D,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACvE,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,IAAY;QAC7B,MAAM,GAAG,GAA2B;YAClC,GAAG,EAAE,OAAO;YACZ,GAAG,EAAE,MAAM;YACX,GAAG,EAAE,MAAM;YACX,GAAG,EAAE,QAAQ;YACb,GAAG,EAAE,QAAQ;SACd,CAAA;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IACtD,CAAC;CACF"}

package/dist/mail/templates/custom-template-renderer.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Custom Template Renderer
+ *
+ * Allows full control over email templates with variable substitution.
+ * Users can provide their own HTML/text templates for each email type.
+ */
+import type { TemplateRenderer, TemplateData, RenderedTemplate } from '../types.js';
+/**
+ * Custom template definition
+ */
+export interface CustomTemplate {
+    /**
+     * Email subject with optional variables: {{variableName}}
+     */
+    subject: string;
+    /**
+     * Full HTML template with optional variables: {{variableName}}
+     * Receives all data passed to the template
+     */
+    html: string;
+    /**
+     * Plain text template with optional variables: {{variableName}}
+     * Receives all data passed to the template
+     */
+    text?: string;
+}
+/**
+ * Template function that receives data and returns a template
+ * Useful for dynamic template generation
+ */
+export type CustomTemplateFunction = (data: TemplateData) => CustomTemplate;
+/**
+ * Template definition - can be static or dynamic
+ */
+export type TemplateDefinition = CustomTemplate | CustomTemplateFunction;
+/**
+ * Configuration for CustomTemplateRenderer
+ */
+export interface CustomTemplateRendererConfig {
+    /**
+     * Template definitions keyed by template ID
+     */
+    templates: Record<string, TemplateDefinition>;
+    /**
+     * Fallback renderer for templates not defined in custom templates
+     * If not provided, throws error for undefined templates
+     */
+    fallback?: TemplateRenderer;
+    /**
+     * Custom variable delimiters (default: {{ and }})
+     */
+    delimiters?: {
+        start: string;
+        end: string;
+    };
+}
+/**
+ * Custom template renderer with full HTML/text control
+ *
+ * @example
+ * ```typescript
+ * const renderer = new CustomTemplateRenderer({
+ *   templates: {
+ *     'password-reset': {
+ *       subject: 'Reset your password - {{brandName}}',
+ *       html: '<h1>Hello {{firstName}}</h1><p>Click <a href="{{resetUrl}}">here</a></p>',
+ *       text: 'Hello {{firstName}}, reset your password: {{resetUrl}}',
+ *     },
+ *   },
+ * })
+ * ```
+ */
+export declare class CustomTemplateRenderer implements TemplateRenderer {
+    private templates;
+    private fallback?;
+    private startDelimiter;
+    private endDelimiter;
+    constructor(config: CustomTemplateRendererConfig);
+    /**
+     * Render a template with provided data
+     */
+    render(templateId: string, data: TemplateData): RenderedTemplate;
+    /**
+     * Check if a template exists
+     */
+    hasTemplate(templateId: string): boolean;
+    /**
+     * List all available template IDs
+     */
+    listTemplates(): string[];
+    /**
+     * Substitute variables in a template string
+     *
+     * Supports:
+     * - Simple variables: {{variableName}}
+     * - Nested variables: {{user.firstName}}
+     * - Helpers: {{formatDate:createdAt}}
+     * - Default values: {{variableName|default}}
+     */
+    private substituteVariables;
+    /**
+     * Evaluate a variable expression
+     */
+    private evaluateExpression;
+    /**
+     * Get nested value from object using dot notation
+     * e.g., "user.firstName" from { user: { firstName: "John" } }
+     */
+    private getNestedValue;
+    /**
+     * Escape special regex characters
+     */
+    private escapeRegex;
+}
+//# sourceMappingURL=custom-template-renderer.d.ts.map

package/dist/mail/templates/custom-template-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-template-renderer.d.ts","sourceRoot":"","sources":["../../../src/mail/templates/custom-template-renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAMnF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,cAAc,CAAA;AAE3E;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,sBAAsB,CAAA;AAExE;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAE7C;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAE3B;;OAEG;IACH,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;CACF;AA+ED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,QAAQ,CAAC,CAAkB;IACnC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,YAAY,CAAQ;gBAEhB,MAAM,EAAE,4BAA4B;IAOhD;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,gBAAgB;IAyBhE;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAUxC;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAazB;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmC1B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB"}