@zintrust/core 0.1.26 → 0.1.28

package/src/tools/mail/template-loader.ts

@@ -0,0 +1,128 @@
+import { ErrorFactory } from '@exceptions/ZintrustError';
+import { readFile } from '@node-singletons/fs';
+import { dirname, join } from '@node-singletons/path';
+import { fileURLToPath } from '@node-singletons/url';
+
+import { Env } from '@config/env';
+import type { TemplateVariables } from '@mail/template-utils';
+import { interpolate } from '@mail/template-utils';
+
+/**
+ * Load and render email template with variable substitution
+ */
+export async function loadTemplate(
+  templateName: string,
+  variables: TemplateVariables = {}
+): Promise<string> {
+  try {
+    const baseDir = dirname(fileURLToPath(import.meta.url));
+    const isPath = templateName.includes('/') || templateName.endsWith('.html');
+    let templatePath: string;
+    if (isPath) {
+      if (templateName.startsWith('/')) {
+        templatePath = templateName;
+      } else {
+        templatePath = join(process.cwd(), templateName);
+      }
+    } else {
+      templatePath = join(baseDir, 'templates', `${templateName}.html`);
+    }
+    let template: string;
+    try {
+      template = await readFile(templatePath, 'utf-8');
+    } catch {
+      // Fallback to built-in directory if the supplied name looked like a file but wasn't found
+      const fallbackPath = join(
+        baseDir,
+        'templates',
+        templateName.endsWith('.html') ? templateName : `${templateName}.html`
+      );
+      template = await readFile(fallbackPath, 'utf-8');
+    }
+
+    // Replace variables using shared interpolate util
+    const mergedVars: TemplateVariables = {
+      year: new Date().getFullYear().toString(),
+      APP_NAME: Env.APP_NAME ?? 'ZinTrust',
+      ...variables,
+    };
+    let rendered = interpolate(template, mergedVars);
+
+    // Handle conditional blocks {{#if_condition}}...{{/if_condition}}
+    rendered = renderConditionals(rendered, variables);
+
+    // Handle loops {{#each_array}}...{{/each_array}}
+    rendered = renderLoops(rendered, variables);
+
+    return rendered;
+  } catch (error) {
+    throw ErrorFactory.createConfigError(`Failed to load template ${templateName}: ${error}`);
+  }
+}
+
+/**
+ * Render conditional blocks {{#if_condition}}...{{/if_condition}}
+ */
+function renderConditionals(template: string, variables: TemplateVariables): string {
+  const conditionalRegex = /{{#if_(\w+)}}(.+?){{\/if_\1}}/gs;
+
+  return template.replaceAll(
+    conditionalRegex,
+    (_fullMatch: string, condition: string, content: string): string => {
+      const value = variables[condition];
+
+      if (value === true || value === 'true') {
+        return content;
+      }
+
+      return '';
+    }
+  );
+}
+
+/**
+ * Render loop blocks {{#each_array}}...{{/each_array}}
+ */
+function renderLoops(template: string, variables: TemplateVariables): string {
+  const loopRegex = /{{#each_(\w+)}}(.+?){{\/each_\1}}/gs;
+
+  return template.replaceAll(
+    loopRegex,
+    (_fullMatch: string, arrayName: string, content: string): string => {
+      const array = variables[arrayName] as unknown[] | undefined;
+
+      if (!Array.isArray(array)) {
+        return '';
+      }
+
+      return array
+        .map((item): string => {
+          let rendered = content;
+
+          if (typeof item === 'object' && item !== null) {
+            for (const [key, value] of Object.entries(item as Record<string, unknown>)) {
+              const regex = new RegExp(`{{${key}}}`, 'g');
+              rendered = rendered.replaceAll(regex, String(value ?? ''));
+            }
+          }
+
+          return rendered;
+        })
+        .join('');
+    }
+  );
+}
+
+/**
+ * Get list of available templates
+ */
+export function getAvailableTemplates(): string[] {
+  return [
+    'welcome.html',
+    'password-reset.html',
+    'job-completed.html',
+    'worker-alert.html',
+    'performance-report.html',
+    'general.html',
+  ];
+}

package/src/tools/mail/template-utils.ts

@@ -0,0 +1,19 @@
+/**
+ * Template utilities shared by mail modules.
+ */
+
+export type TemplateVariables = Record<string, unknown>;
+
+/**
+ * Simple handlebars‐style interpolation: replaces all occurrences of
+ * `{{ key }}` (whitespace optional) with String(value).
+ */
+export function interpolate(template: string, data: TemplateVariables): string {
+  let out = template;
+  for (const [key, value] of Object.entries(data)) {
+    const replacement = value === null || value === undefined ? '' : String(value);
+    const regex = new RegExp(String.raw`{{\s*${key}\s*}}`, 'g');
+    out = out.replace(regex, replacement);
+  }
+  return out;
+}

package/src/tools/mail/templates/auth-password-reset.html

@@ -0,0 +1,231 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <title>Password Reset Request</title>
+    <style>
+      body {
+        margin: 0;
+        padding: 0;
+        background-color: #0b1220;
+        color: #e2e8f0;
+        font-family:
+          -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+      }
+
+      .email-container {
+        max-width: 600px;
+        margin: 40px auto;
+        background-color: #0f172a;
+        border: 1px solid #334155;
+        border-radius: 12px;
+        overflow: hidden;
+      }
+
+      .header {
+        padding: 40px 40px 30px;
+        text-align: center;
+        background: linear-gradient(180deg, rgba(239, 68, 68, 0.15), rgba(220, 38, 38, 0.08));
+        border-bottom: 1px solid #334155;
+      }
+
+      .icon {
+        width: 48px;
+        height: 48px;
+        margin: 0 auto 20px;
+        border-radius: 12px;
+        border: 1px solid rgba(239, 68, 68, 0.35);
+        background: linear-gradient(180deg, rgba(239, 68, 68, 0.2), rgba(220, 38, 38, 0.1));
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+      }
+
+      .title {
+        margin: 0 0 8px;
+        font-size: 28px;
+        font-weight: 700;
+        color: #e2e8f0;
+        line-height: 1.2;
+      }
+
+      .subtitle {
+        margin: 0;
+        font-size: 16px;
+        color: #e2e8f0;
+        line-height: 1.5;
+      }
+
+      .content {
+        padding: 40px;
+      }
+
+      .greeting {
+        margin: 0 0 24px;
+        font-size: 15px;
+        color: #f1f5f9;
+        line-height: 1.6;
+      }
+
+      .message {
+        margin: 0 0 24px;
+        font-size: 15px;
+        color: #f1f5f9;
+        line-height: 1.6;
+      }
+
+      .button-container {
+        margin-bottom: 30px;
+        text-align: center;
+      }
+
+      .reset-button {
+        display: inline-block;
+        padding: 14px 32px;
+        background: linear-gradient(135deg, #ef4444, #dc2626);
+        color: #ffffff;
+        text-decoration: none;
+        border-radius: 8px;
+        font-weight: 600;
+        font-size: 15px;
+        border: 1px solid rgba(217, 82, 82, 0.8);
+      }
+
+      .security-notice {
+        padding: 16px;
+        background: rgba(251, 191, 36, 0.08);
+        border-left: 3px solid #fbbf24;
+        border-radius: 6px;
+        margin-bottom: 30px;
+      }
+
+      .security-notice p {
+        margin: 0;
+        font-size: 14px;
+        color: #e2e8f0;
+        line-height: 1.6;
+      }
+
+      .security-notice strong {
+        color: #fbbf24;
+      }
+
+      .expiry {
+        margin: 0 0 16px;
+        font-size: 14px;
+        color: #e2e8f0;
+        line-height: 1.6;
+      }
+
+      .expiry strong {
+        color: #e2e8f0;
+      }
+
+      .alternative-link {
+        margin: 0;
+        font-size: 13px;
+        color: #e2e8f0;
+        line-height: 1.6;
+      }
+
+      .alternative-link a {
+        color: #bae6fd;
+        text-decoration: none;
+        word-break: break-all;
+      }
+
+      .divider {
+        margin: 30px 0;
+        border-top: 1px solid #334155;
+      }
+
+      .support {
+        margin: 0;
+        font-size: 14px;
+        color: #e2e8f0;
+        line-height: 1.6;
+      }
+
+      .support a {
+        color: #bae6fd;
+        text-decoration: none;
+      }
+
+      .footer {
+        padding: 30px 40px;
+        background: rgba(15, 23, 42, 0.65);
+        border-top: 1px solid #334155;
+        text-align: center;
+      }
+
+      .footer p {
+        margin: 0;
+        font-size: 12px;
+        color: #64748b;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="email-container">
+      <!-- Header -->
+      <div class="header">
+        <div class="icon">
+          <span style="font-size: 24px">🔒</span>
+        </div>
+        <h1 class="title">Password Reset Request</h1>
+        <p class="subtitle">We received a request to reset your password</p>
+      </div>
+
+      <!-- Main Content -->
+      <div class="content">
+        <p class="greeting">Hi <strong style="color: #e2e8f0">{{name}}</strong>,</p>
+
+        <p class="message">
+          Someone requested a password reset for your {{APP_NAME}} account (<strong
+            style="color: #e2e8f0"
+            >{{email}}</strong
+          >). If this was you, click the button below to reset your password:
+        </p>
+
+        <!-- CTA Button -->
+        <div class="button-container">
+          <a href="{{reset_url}}" class="reset-button">Reset Password</a>
+        </div>
+
+        <!-- Security Notice -->
+        <div class="security-notice">
+          <p>
+            <strong>⚠ Security Notice</strong><br />
+            If you didn't request this password reset, please ignore this email. Your password will
+            remain unchanged.
+          </p>
+        </div>
+
+        <p class="expiry">
+          For security reasons, this link will expire in <strong>{{expiryMinutes}} minutes</strong>.
+        </p>
+
+        <!-- Alternative Link -->
+        <p class="alternative-link">
+          If the button above doesn't work, copy and paste this link into your browser:<br />
+          <a href="{{reset_url}}">{{reset_url}}</a>
+        </p>
+
+        <!-- Divider -->
+        <div class="divider"></div>
+
+        <p class="support">
+          If you continue to have problems, please contact our
+          <a href="{{support_url}}">support team</a>.
+        </p>
+      </div>
+
+      <!-- Footer -->
+      <div class="footer">
+        <p>&copy; {{year}} {{APP_NAME}}. All rights reserved.</p>
+      </div>
+    </div>
+  </body>
+</html>

package/src/tools/mail/templates/auth-welcome.html

@@ -0,0 +1,236 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <title>Welcome to {{APP_NAME}}</title>
+    <!--[if mso]>
+      <style type="text/css">
+        table {
+          border-collapse: collapse;
+        }
+      </style>
+    <![endif]-->
+    <style>
+      body {
+        margin: 0;
+        padding: 0;
+        background-color: #0b1220;
+        font-family:
+          -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+      }
+
+      .email-container {
+        max-width: 600px;
+        margin: 40px auto;
+        background-color: #0f172a;
+        border: 1px solid #334155;
+        border-radius: 12px;
+        overflow: hidden;
+      }
+
+      .header {
+        padding: 40px 40px 30px;
+        text-align: center;
+        background: linear-gradient(180deg, rgba(14, 165, 233, 0.18), rgba(2, 132, 199, 0.1));
+        border-bottom: 1px solid #334155;
+      }
+
+      .icon {
+        width: 48px;
+        height: 48px;
+        margin: 0 auto 20px;
+        border-radius: 12px;
+        border: 1px solid rgba(14, 165, 233, 0.35);
+        background: linear-gradient(180deg, rgba(14, 165, 233, 0.25), rgba(2, 132, 199, 0.15));
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+      }
+
+      .title {
+        margin: 0 0 8px;
+        font-size: 28px;
+        font-weight: 700;
+        color: #e2e8f0;
+        line-height: 1.2;
+      }
+
+      .subtitle {
+        margin: 0;
+        font-size: 16px;
+        color: #e2e8f0;
+        line-height: 1.5;
+      }
+
+      .content {
+        padding: 40px;
+      }
+
+      .getting-started {
+        margin: 0 0 20px;
+        font-size: 20px;
+        font-weight: 700;
+        color: #f1f5f9;
+      }
+
+      .steps {
+        width: 100%;
+        border-collapse: collapse;
+        margin-bottom: 30px;
+      }
+
+      .step-item {
+        padding: 16px;
+        background: rgba(14, 165, 233, 0.08);
+        border-left: 3px solid #0ea5e9;
+        border-radius: 6px;
+      }
+
+      .step-item p {
+        margin: 0 0 12px;
+        font-size: 14px;
+        color: #f1f5f9;
+        line-height: 1.6;
+      }
+
+      .message {
+        margin: 0 0 24px;
+        font-size: 15px;
+        color: #f1f5f9;
+        line-height: 1.6;
+      }
+
+      .button-container {
+        margin-bottom: 30px;
+        text-align: center;
+      }
+
+      .verify-button {
+        display: inline-block;
+        padding: 14px 32px;
+        background: linear-gradient(135deg, #1e3a8a, #1a2e4a);
+        color: #ffffff;
+        text-decoration: none;
+        border-radius: 8px;
+        font-weight: 600;
+        font-size: 15px;
+        border: 1px solid rgba(30, 58, 138, 0.5);
+      }
+
+      .expiry-notice {
+        margin: 0;
+        font-size: 13px;
+        color: #f1f5f9;
+        line-height: 1.5;
+        text-align: center;
+      }
+
+      .expiry-notice em {
+        font-style: italic;
+      }
+
+      .divider {
+        margin: 30px 0;
+        border-top: 1px solid #334155;
+      }
+
+      .support {
+        margin: 0;
+        font-size: 14px;
+        color: #e2e8f0;
+        line-height: 1.6;
+      }
+
+      .support a {
+        color: #bae6fd;
+        text-decoration: none;
+      }
+
+      .footer {
+        padding: 30px 40px;
+        background: rgba(15, 23, 42, 0.65);
+        border-top: 1px solid #334155;
+        text-align: center;
+      }
+
+      .footer p {
+        margin: 0;
+        font-size: 12px;
+        color: #64748b;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="email-container">
+      <!-- Header with Logo -->
+      <div class="header">
+        <div class="icon">
+          <span style="font-size: 24px">🎉</span>
+        </div>
+        <h1 class="title">Welcome, {{name}}!</h1>
+        <p class="subtitle">
+          Thanks for joining {{APP_NAME}} — we're excited to have you on board.
+        </p>
+      </div>
+
+      <!-- Main Content -->
+      <div class="content">
+        <h2 class="getting-started">Getting Started</h2>
+
+        <table class="steps">
+          <tr>
+            <th
+              style="
+                text-align: left;
+                padding: 12px;
+                background: rgba(14, 165, 233, 0.12);
+                border-bottom: 2px solid #0ea5e9;
+                color: #ffffff;
+                font-weight: 600;
+              "
+            >
+              Getting Started Steps
+            </th>
+          </tr>
+          <tr>
+            <td>
+              <div class="step-item">
+                <p>
+                  ✓ Verify your email<br />
+                  ✓ Complete your profile<br />
+                  ✓ Explore features
+                </p>
+              </div>
+            </td>
+          </tr>
+        </table>
+
+        <p class="message">To activate your account, please verify your email address:</p>
+
+        <!-- CTA Button -->
+        <div class="button-container">
+          <a href="{{confirmLink}}" class="verify-button">Verify Email Address</a>
+        </div>
+
+        <p class="expiry-notice">
+          <em>This link expires in {{expiryMinutes}} minutes.</em>
+        </p>
+
+        <!-- Divider -->
+        <div class="divider"></div>
+
+        <p class="support">
+          If you have any questions, reply to this email or contact our
+          <a href="{{support_url}}">support team</a>. We're here to help!
+        </p>
+      </div>
+
+      <!-- Footer -->
+      <div class="footer">
+        <p>&copy; {{year}} {{APP_NAME}}. All rights reserved.</p>
+      </div>
+    </div>
+  </body>
+</html>