@digilogiclabs/platform-core 1.27.1 → 1.28.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/agents.js.map +1 -1
- package/dist/agents.mjs.map +1 -1
- package/dist/auth.d.mts +2 -2
- package/dist/auth.d.ts +2 -2
- package/dist/auth.js +18 -5
- package/dist/auth.js.map +1 -1
- package/dist/auth.mjs +18 -5
- package/dist/auth.mjs.map +1 -1
- package/dist/email-templates.js.map +1 -1
- package/dist/email-templates.mjs.map +1 -1
- package/dist/{env-Cgwf8ZG2.d.mts → env-CHg-CUuD.d.mts} +6 -0
- package/dist/{env-Cgwf8ZG2.d.ts → env-CHg-CUuD.d.ts} +6 -0
- package/dist/index.d.mts +253 -3
- package/dist/index.d.ts +253 -3
- package/dist/index.js +751 -7
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +739 -7
- package/dist/index.mjs.map +1 -1
- package/dist/testing.js.map +1 -1
- package/dist/testing.mjs.map +1 -1
- package/package.json +16 -16
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/email-templates/index.ts","../src/security.ts","../src/email-templates/layout.ts","../src/email-templates/templates.ts","../src/auth/tokens.ts","../src/email-templates/unsubscribe.ts","../src/interfaces/ILogger.ts","../src/resilience/retry.ts","../src/resilience/circuit-breaker.ts","../src/email-templates/transport.ts"],"sourcesContent":["/**\n * Shared email template module.\n *\n * Provides a branding-driven email layout system with pre-built templates\n * and composable HTML building blocks. Zero external dependencies —\n * only uses escapeHtml from platform-core's security module.\n *\n * @example\n * ```ts\n * import {\n * welcomeEmail,\n * digestEmail,\n * emailLayout,\n * calloutBlock,\n * } from \"@digilogiclabs/platform-core/email-templates\";\n *\n * const branding: EmailBranding = {\n * appName: \"MyApp\",\n * primaryColor: \"#667eea\",\n * fromEmail: \"noreply@myapp.com\",\n * baseUrl: \"https://myapp.com\",\n * };\n *\n * const { subject, html, text } = welcomeEmail(branding, {\n * userName: \"Alice\",\n * dashboardUrl: \"https://myapp.com/dashboard\",\n * steps: [\n * { title: \"Set up profile\", description: \"Add your photo and bio\" },\n * { title: \"Explore features\", description: \"Check out what's available\" },\n * ],\n * });\n * ```\n */\n\n// Types\nexport type {\n EmailBranding,\n EmailCTA,\n EmailStep,\n EmailStat,\n EmailTableRow,\n EmailLayoutOptions,\n EmailOutput,\n} from \"./types\";\n\n// Layout engine + building blocks\nexport {\n emailLayout,\n calloutBlock,\n stepBlock,\n statsBar,\n dataTable,\n tipBlock,\n sectionHeading,\n divider,\n escapeHtml,\n} from \"./layout\";\n\n// Pre-built templates\nexport {\n welcomeEmail,\n digestEmail,\n notificationEmail,\n moderationEmail,\n transactionEmail,\n securityEmail,\n} from \"./templates\";\n\n// Template data types\nexport type {\n WelcomeEmailData,\n DigestEmailData,\n NotificationEmailData,\n ModerationEmailData,\n ModerationAction,\n TransactionEmailData,\n SecurityEmailData,\n} from \"./templates\";\n\n// Unsubscribe (RFC 2369 + RFC 8058) — HMAC-signed token + header generators\nexport { createUnsubscribe } from \"./unsubscribe\";\nexport type { UnsubscribeConfig, UnsubscribeHelpers } from \"./unsubscribe\";\n\n// Resilient email transport — wraps any IEmail with retry + circuit + timeout\nexport { createResilientEmail } from \"./transport\";\nexport type { ResilientEmailOptions } from \"./transport\";\n","/**\n * Security Utilities\n *\n * HTML escaping, input detection, sanitization helpers,\n * timing-safe comparison, error sanitization, and request\n * correlation for safe, consistent security across all apps.\n */\n\nimport { timingSafeEqual } from \"crypto\";\n\n/** Regex for protocol-prefixed URLs */\nexport const URL_PROTOCOL_PATTERN = /(https?:\\/\\/|ftp:\\/\\/|www\\.)\\S+/i;\n\n/** Regex for bare domain names with common TLDs */\nexport const URL_DOMAIN_PATTERN =\n /\\b[\\w.-]+\\.(com|net|org|io|co|dev|app|xyz|info|biz|me|us|uk|edu|gov)\\b/i;\n\n/** Regex for HTML tags */\nexport const HTML_TAG_PATTERN = /<[^>]*>/;\n\n/**\n * Escape HTML special characters to prevent injection.\n * Use when inserting user content into HTML email templates or rendered HTML.\n */\nexport function escapeHtml(str: string): string {\n return str\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/\"/g, \""\")\n .replace(/'/g, \"'\");\n}\n\n/** Check if a string contains protocol-prefixed URLs or bare domains */\nexport function containsUrls(str: string): boolean {\n return URL_PROTOCOL_PATTERN.test(str) || URL_DOMAIN_PATTERN.test(str);\n}\n\n/** Check if a string contains HTML tags */\nexport function containsHtml(str: string): boolean {\n return HTML_TAG_PATTERN.test(str);\n}\n\n/** Strip all HTML tags from a string */\nexport function stripHtml(str: string): string {\n return str.replace(/<[^>]*>/g, \"\");\n}\n\n/**\n * Strip null bytes (U+0000) from a string.\n *\n * Postgres rejects null bytes in `text`/`varchar` columns with a hard\n * `invalid byte sequence` error (→ HTTP 500 in app handlers). Apps that\n * forward raw user input — search queries, filter params, form fields —\n * into Drizzle/raw SQL queries hit this on malicious or malformed clients\n * that inject `%00` in URLs.\n *\n * Pass `undefined`/`null` through unchanged so it composes cleanly with\n * optional query params: `stripNullBytes(url.searchParams.get('q'))?.trim()`.\n *\n * @example\n * ```typescript\n * import { stripNullBytes } from '@digilogiclabs/platform-core/auth';\n *\n * const q = stripNullBytes(url.searchParams.get('q'))?.trim();\n * const results = await db.select().where(ilike(column, `%${q}%`));\n * ```\n */\nexport function stripNullBytes(value: string): string;\nexport function stripNullBytes(value: null | undefined): null | undefined;\nexport function stripNullBytes(\n value: string | null | undefined,\n): string | null | undefined;\nexport function stripNullBytes(\n value: string | null | undefined,\n): string | null | undefined {\n if (value === null || value === undefined) return value;\n return value.replace(/\\u0000/g, \"\");\n}\n\n/**\n * Recursively strip null bytes from all string values in a plain object or\n * array. Non-string values pass through unchanged. Use on parsed JSON\n * request bodies before forwarding to DB queries.\n *\n * Preserves the object's own keys and order; does NOT mutate the input.\n * Arrays stay arrays. Stops at 8 levels deep as a guard against accidental\n * circular references (throws at depth-limit exceeded).\n *\n * @example\n * ```typescript\n * import { stripNullBytesDeep } from '@digilogiclabs/platform-core/auth';\n *\n * const body = stripNullBytesDeep(await request.json());\n * const parsed = schema.safeParse(body);\n * ```\n */\nexport function stripNullBytesDeep<T>(value: T, depth = 8): T {\n if (depth <= 0) {\n throw new Error(\"stripNullBytesDeep: max depth exceeded (circular?)\");\n }\n if (typeof value === \"string\") {\n return value.replace(/\\u0000/g, \"\") as unknown as T;\n }\n if (Array.isArray(value)) {\n return value.map((v) => stripNullBytesDeep(v, depth - 1)) as unknown as T;\n }\n if (value !== null && typeof value === \"object\") {\n const out: Record<string, unknown> = {};\n for (const [k, v] of Object.entries(value)) {\n out[k] = stripNullBytesDeep(v, depth - 1);\n }\n return out as T;\n }\n return value;\n}\n\n/**\n * Defang URLs to prevent auto-linking in email clients.\n * Converts https://evil.com → hxxps://evil[.]com\n */\nexport function defangUrl(str: string): string {\n return str\n .replace(/https:\\/\\//gi, \"hxxps://\")\n .replace(/http:\\/\\//gi, \"hxxp://\")\n .replace(/ftp:\\/\\//gi, \"fxp://\")\n .replace(\n /\\.(com|net|org|io|co|dev|app|xyz|info|biz|me|us|uk|edu|gov)\\b/gi,\n \"[$1]\",\n );\n}\n\n/**\n * Sanitize user content for safe insertion into HTML email templates.\n * Escapes HTML entities AND defangs any URLs that slipped through validation.\n */\nexport function sanitizeForEmail(str: string): string {\n return escapeHtml(str);\n}\n\n// ═══════════════════════════════════════════════════════════════\n// API SECURITY UTILITIES\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * Constant-time string comparison to prevent timing side-channel attacks.\n * Use for comparing secrets, tokens, API keys, HMAC signatures, etc.\n *\n * Returns false (not throws) for length mismatches — still constant-time\n * relative to the shorter string to avoid leaking length info.\n *\n * @example\n * ```typescript\n * if (!constantTimeEqual(providedToken, expectedSecret)) {\n * return { status: 401, error: 'Invalid token' }\n * }\n * ```\n */\nexport function constantTimeEqual(a: string, b: string): boolean {\n try {\n const aBuf = Buffer.from(a, \"utf-8\");\n const bBuf = Buffer.from(b, \"utf-8\");\n if (aBuf.length !== bBuf.length) return false;\n return timingSafeEqual(aBuf, bBuf);\n } catch {\n return false;\n }\n}\n\n/**\n * Sanitize an error for client-facing API responses.\n *\n * - 4xx errors: returns the actual message (client needs to know what went wrong)\n * - 5xx errors: returns a generic message (never leak internals to clients)\n * - Development mode: optionally includes stack trace for debugging\n *\n * @example\n * ```typescript\n * catch (error) {\n * const { message, code } = sanitizeApiError(error, 500)\n * return Response.json({ error: message, code }, { status: 500 })\n * }\n * ```\n */\nexport function sanitizeApiError(\n error: unknown,\n statusCode: number,\n isDevelopment = false,\n): { message: string; code?: string; stack?: string } {\n // Client errors — safe to expose the message\n if (statusCode >= 400 && statusCode < 500) {\n const message =\n error instanceof Error ? error.message : String(error || \"Bad request\");\n return { message };\n }\n\n // Server errors — generic message to clients, real error in logs only\n const result: { message: string; code: string; stack?: string } = {\n message: \"An internal error occurred. Please try again later.\",\n code: \"INTERNAL_ERROR\",\n };\n\n if (isDevelopment && error instanceof Error) {\n result.stack = error.stack;\n }\n\n return result;\n}\n\n/**\n * Extract a correlation/request ID from standard headers, or generate one.\n *\n * Checks (in order): X-Request-ID, X-Correlation-ID, then falls back to\n * crypto.randomUUID(). Works with any headers-like object (plain object,\n * Headers API, or a getter function).\n *\n * @example\n * ```typescript\n * // With Next.js request\n * const id = getCorrelationId((name) => request.headers.get(name))\n *\n * // With plain object\n * const id = getCorrelationId({ 'x-request-id': 'abc-123' })\n * ```\n */\nexport function getCorrelationId(\n headers:\n | Record<string, string | string[] | undefined>\n | ((name: string) => string | null | undefined),\n): string {\n const get =\n typeof headers === \"function\"\n ? headers\n : (name: string) => {\n const val = headers[name] ?? headers[name.toLowerCase()];\n return Array.isArray(val) ? val[0] : val;\n };\n\n return (\n get(\"x-request-id\") ||\n get(\"X-Request-ID\") ||\n get(\"x-correlation-id\") ||\n get(\"X-Correlation-ID\") ||\n crypto.randomUUID()\n );\n}\n","/**\n * Base email layout builder.\n *\n * Generates a fully responsive, email-client-compatible HTML email\n * using only inline styles and table-based layout.\n *\n * Every user-facing string in the layout is pre-escaped. Template functions\n * that accept user input MUST escape those values before passing them to body.\n */\nimport type { EmailBranding, EmailLayoutOptions, EmailOutput } from \"./types\";\nimport { escapeHtml } from \"../security\";\n\nconst FONT_STACK =\n \"-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif\";\n\n/**\n * Darken a hex color by a percentage (0-100).\n * Used to auto-generate gradientTo from primaryColor.\n */\nfunction darkenHex(hex: string, percent: number): string {\n const num = parseInt(hex.replace(\"#\", \"\"), 16);\n const r = Math.max(0, (num >> 16) - Math.round(2.55 * percent));\n const g = Math.max(0, ((num >> 8) & 0x00ff) - Math.round(2.55 * percent));\n const b = Math.max(0, (num & 0x0000ff) - Math.round(2.55 * percent));\n return `#${((r << 16) | (g << 8) | b).toString(16).padStart(6, \"0\")}`;\n}\n\n/**\n * Strip HTML tags for plain-text fallback.\n */\nfunction htmlToText(html: string): string {\n return html\n .replace(/<br\\s*\\/?>/gi, \"\\n\")\n .replace(/<\\/p>/gi, \"\\n\\n\")\n .replace(/<\\/div>/gi, \"\\n\")\n .replace(/<\\/tr>/gi, \"\\n\")\n .replace(/<\\/li>/gi, \"\\n\")\n .replace(/<li[^>]*>/gi, \"- \")\n .replace(/<a[^>]*href=\"([^\"]*)\"[^>]*>([^<]*)<\\/a>/gi, \"$2 ($1)\")\n .replace(/<[^>]+>/g, \"\")\n .replace(/ /g, \" \")\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/"/g, '\"')\n .replace(/'/g, \"'\")\n .replace(/→/g, \"→\")\n .replace(/\\n{3,}/g, \"\\n\\n\")\n .trim();\n}\n\n/**\n * Build a complete HTML email from branding + layout options.\n *\n * Returns `{ subject, html, text }` ready to pass to any IEmail adapter.\n */\nexport function emailLayout(\n branding: EmailBranding,\n options: EmailLayoutOptions,\n): EmailOutput {\n const gradientFrom = branding.gradientFrom ?? branding.primaryColor;\n const gradientTo =\n branding.gradientTo ?? darkenHex(branding.primaryColor, 15);\n const accentColor = branding.accentColor ?? branding.primaryColor;\n\n const preheaderHtml = options.preheader\n ? `<div style=\"display:none;font-size:1px;color:#f3f4f6;line-height:1px;max-height:0;max-width:0;opacity:0;overflow:hidden;\">${escapeHtml(options.preheader)}</div>`\n : \"\";\n\n const iconHtml = options.icon ? `${options.icon} ` : \"\";\n\n const subtitleHtml = options.subtitle\n ? `<p style=\"margin:4px 0 0;color:rgba(255,255,255,0.85);font-size:14px;\">${escapeHtml(options.subtitle)}</p>`\n : \"\";\n\n // Logo image — when branding.logoUrl is supplied, render an <img> above\n // the appName text. Email-client-safe attributes only: explicit width,\n // alt text, display:block, border:0. Hosted PNG (or JPG) only — most\n // email clients (Outlook, Gmail's image proxy) do not render SVG.\n const logoHtml = branding.logoUrl\n ? `<img src=\"${escapeHtml(branding.logoUrl)}\" alt=\"${escapeHtml(branding.appName)}\" width=\"56\" height=\"56\" style=\"display:block;margin:0 auto 10px;border:0;outline:none;text-decoration:none;border-radius:10px;background:#ffffff;padding:6px;\" />`\n : \"\";\n\n const ctaHtml = options.cta\n ? `\n <tr>\n <td style=\"padding:0 32px 24px;text-align:center;\">\n <a href=\"${escapeHtml(options.cta.url)}\"\n style=\"display:inline-block;padding:12px 28px;background:${accentColor};color:#ffffff;text-decoration:none;border-radius:6px;font-weight:600;font-size:14px;\">\n ${escapeHtml(options.cta.text)}\n </a>\n </td>\n </tr>`\n : \"\";\n\n const footerLinksHtml =\n options.footerLinks && options.footerLinks.length > 0\n ? options.footerLinks\n .map(\n (link) =>\n `<a href=\"${escapeHtml(link.url)}\" style=\"color:${accentColor};text-decoration:none;\">${escapeHtml(link.label)}</a>`,\n )\n .join(\" · \")\n : \"\";\n\n const preferencesHtml = branding.preferencesUrl\n ? `<p style=\"margin:4px 0 0;font-size:12px;color:#9ca3af;\">\n <a href=\"${escapeHtml(branding.preferencesUrl)}\" style=\"color:${accentColor};text-decoration:none;\">Update email preferences</a>\n </p>`\n : \"\";\n\n const html = `<!DOCTYPE html>\n<html lang=\"en\">\n<head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0\"><title>${escapeHtml(options.subject)}</title></head>\n<body style=\"margin:0;padding:0;background:#f3f4f6;font-family:${FONT_STACK};\">\n ${preheaderHtml}\n <table width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" style=\"background:#f3f4f6;padding:24px 0;\">\n <tr><td align=\"center\">\n <table width=\"600\" cellpadding=\"0\" cellspacing=\"0\" style=\"background:#ffffff;border-radius:8px;overflow:hidden;max-width:600px;\">\n <!-- Header -->\n <tr>\n <td style=\"background:linear-gradient(135deg,${gradientFrom},${gradientTo});padding:28px 32px;text-align:center;\">\n ${logoHtml}<h1 style=\"margin:0;color:#ffffff;font-size:22px;font-weight:700;\">${iconHtml}${escapeHtml(branding.appName)}</h1>\n ${subtitleHtml}\n </td>\n </tr>\n\n <!-- Body -->\n <tr>\n <td style=\"padding:28px 32px;color:#374151;font-size:15px;line-height:1.6;\">\n ${options.body}\n </td>\n </tr>\n\n ${ctaHtml}\n\n <!-- Footer -->\n <tr>\n <td style=\"padding:16px 32px;background:#f9fafb;text-align:center;border-top:1px solid #e5e7eb;\">\n ${footerLinksHtml ? `<p style=\"margin:0 0 4px;font-size:12px;color:#9ca3af;\">${footerLinksHtml}</p>` : \"\"}\n <p style=\"margin:0;font-size:12px;color:#9ca3af;\">\n ${branding.footerText ? escapeHtml(branding.footerText) + \" · \" : \"\"}\n <a href=\"${escapeHtml(branding.baseUrl)}\" style=\"color:${accentColor};text-decoration:none;\">${escapeHtml(branding.appName)}</a>\n </p>\n ${preferencesHtml}\n </td>\n </tr>\n </table>\n </td></tr>\n </table>\n</body>\n</html>`;\n\n const text = `${options.icon ? options.icon + \" \" : \"\"}${options.subject}\\n${\"=\".repeat(40)}\\n\\n${htmlToText(options.body)}${options.cta ? `\\n\\n${options.cta.text}: ${options.cta.url}` : \"\"}\\n\\n---\\n${branding.footerText ? branding.footerText + \"\\n\" : \"\"}${branding.appName} - ${branding.baseUrl}${branding.preferencesUrl ? \"\\nEmail preferences: \" + branding.preferencesUrl : \"\"}`;\n\n return { subject: options.subject, html, text };\n}\n\n// ─── HTML Building Blocks ────────────────────────────────────────────────────\n// These helpers generate safe HTML fragments for use inside template body content.\n// All user-provided values MUST be escaped before calling these.\n\n/** Highlighted callout box with colored left border. */\nexport function calloutBlock(\n content: string,\n color: string = \"#3b82f6\",\n): string {\n return `<div style=\"background:#f9fafb;padding:16px 20px;border-radius:8px;border-left:4px solid ${color};margin:16px 0;\">${content}</div>`;\n}\n\n/** Numbered step card (for onboarding sequences). */\nexport function stepBlock(\n number: number,\n title: string,\n description: string,\n color: string = \"#667eea\",\n): string {\n return `<div style=\"background:#f3f4f6;padding:16px;border-radius:8px;margin-bottom:12px;border-left:4px solid ${color};\">\n <p style=\"margin:0;font-weight:600;color:#111827;\">${number}. ${title}</p>\n <p style=\"margin:8px 0 0;font-size:14px;color:#6b7280;\">${description}</p>\n </div>`;\n}\n\n/** Stats bar — row of metric cards. */\nexport function statsBar(\n stats: { label: string; value: string | number }[],\n): string {\n const cells = stats\n .map(\n (s) =>\n `<span style=\"display:inline-block;margin:0 16px;font-size:14px;color:#374151;\"><strong>${escapeHtml(String(s.value))}</strong> ${escapeHtml(s.label)}</span>`,\n )\n .join(\"\");\n return `<div style=\"padding:12px 0;text-align:center;background:#f0fdf4;border-radius:6px;margin-bottom:16px;\">${cells}</div>`;\n}\n\n/** Simple data table with header row. */\nexport function dataTable(headers: string[], rows: string[][]): string {\n const headerCells = headers\n .map(\n (h) =>\n `<th style=\"padding:8px 12px;text-align:left;font-size:13px;color:#374151;border-bottom:1px solid #e5e7eb;\">${escapeHtml(h)}</th>`,\n )\n .join(\"\");\n\n const bodyRows = rows\n .map(\n (row) =>\n `<tr>${row.map((cell) => `<td style=\"padding:8px 12px;border-bottom:1px solid #e5e7eb;font-size:14px;color:#374151;\">${cell}</td>`).join(\"\")}</tr>`,\n )\n .join(\"\");\n\n return `<table width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" style=\"border:1px solid #e5e7eb;border-radius:6px;overflow:hidden;\">\n <tr style=\"background:#f9fafb;\">${headerCells}</tr>\n ${bodyRows}\n </table>`;\n}\n\n/** Info/tip box with icon. */\nexport function tipBlock(content: string, icon: string = \"💡\"): string {\n return `<div style=\"background:#eff6ff;border:2px solid #3b82f6;padding:16px 20px;border-radius:8px;margin:16px 0;\">\n <p style=\"margin:0;color:#1e40af;font-size:14px;\"><strong>${icon} Pro Tip:</strong> ${content}</p>\n </div>`;\n}\n\n/** Centered heading within email body. */\nexport function sectionHeading(text: string): string {\n return `<h2 style=\"margin:24px 0 12px;font-size:16px;color:#111827;\">${escapeHtml(text)}</h2>`;\n}\n\n/** Horizontal rule divider. */\nexport function divider(): string {\n return `<hr style=\"border:none;border-top:1px solid #e5e7eb;margin:24px 0;\">`;\n}\n\n/** Re-export escapeHtml for template authors. */\nexport { escapeHtml } from \"../security\";\n","/**\n * Pre-built email templates.\n *\n * Each template accepts branding + template-specific data, composes the\n * layout + building blocks, and returns { subject, html, text }.\n *\n * Apps call these directly — no need to touch layout internals.\n * All user-provided strings are escaped internally.\n */\nimport type { EmailBranding, EmailOutput, EmailStep, EmailStat } from \"./types\";\nimport {\n emailLayout,\n calloutBlock,\n stepBlock,\n statsBar,\n dataTable,\n tipBlock,\n sectionHeading,\n divider,\n escapeHtml,\n} from \"./layout\";\n\n// ─── Welcome / Onboarding ────────────────────────────────────────────────────\n\nexport interface WelcomeEmailData {\n /** User's display name */\n userName: string;\n /** URL to their dashboard or profile */\n dashboardUrl: string;\n /** Onboarding steps (typically 3) */\n steps: EmailStep[];\n /** Optional pro-tip text */\n tip?: string;\n}\n\nexport function welcomeEmail(\n branding: EmailBranding,\n data: WelcomeEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.userName);\n\n const stepsHtml = data.steps\n .map((s, i) =>\n stepBlock(\n i + 1,\n escapeHtml(s.title),\n escapeHtml(s.description),\n branding.accentColor ?? branding.primaryColor,\n ),\n )\n .join(\"\");\n\n const tipHtml = data.tip ? tipBlock(escapeHtml(data.tip)) : \"\";\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <p style=\"font-size:15px;margin-bottom:20px;\">\n Welcome aboard! Your account is all set up and ready to go.\n </p>\n ${sectionHeading(\"Get Started\")}\n ${stepsHtml}\n ${tipHtml}\n `;\n\n return emailLayout(branding, {\n subject: `Welcome to ${branding.appName}!`,\n preheader: `Your ${branding.appName} account is ready`,\n icon: \"🎉\",\n subtitle: \"Welcome aboard\",\n body,\n cta: { text: \"Go to Dashboard\", url: data.dashboardUrl },\n footerLinks: branding.supportEmail\n ? [{ label: \"Get Help\", url: `mailto:${branding.supportEmail}` }]\n : undefined,\n });\n}\n\n// ─── Digest / Summary ────────────────────────────────────────────────────────\n\nexport interface DigestEmailData {\n /** Recipient display name */\n recipientName: string;\n /** Period label (e.g. \"This Week\", \"March 2026\") */\n period: string;\n /** Summary stats shown in the stats bar */\n stats: EmailStat[];\n /** Main body HTML (app-specific content — must be pre-escaped) */\n contentHtml: string;\n /** Optional: URL to view full report */\n reportUrl?: string;\n /** Optional: why they're receiving this */\n subscriptionNote?: string;\n}\n\nexport function digestEmail(\n branding: EmailBranding,\n data: DigestEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.recipientName);\n const safePeriod = escapeHtml(data.period);\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <p style=\"font-size:15px;margin-bottom:16px;\">\n Here's your ${safePeriod.toLowerCase()} summary:\n </p>\n ${statsBar(data.stats)}\n ${data.contentHtml}\n ${data.subscriptionNote ? `<p style=\"margin-top:20px;font-size:13px;color:#9ca3af;\">${escapeHtml(data.subscriptionNote)}</p>` : \"\"}\n `;\n\n return emailLayout(branding, {\n subject: `${branding.appName} — ${data.period} Summary`,\n preheader: `Your ${data.period.toLowerCase()} activity on ${branding.appName}`,\n icon: \"📊\",\n subtitle: safePeriod,\n body,\n cta: data.reportUrl\n ? { text: \"View Full Report\", url: data.reportUrl }\n : undefined,\n });\n}\n\n// ─── Notification ────────────────────────────────────────────────────────────\n\nexport interface NotificationEmailData {\n /** Recipient display name */\n recipientName: string;\n /** Notification headline */\n headline: string;\n /** Main message body (HTML-safe — will be escaped) */\n message: string;\n /** Optional highlighted detail block */\n detail?: string;\n /** Optional CTA */\n actionUrl?: string;\n /** Optional CTA label (defaults to \"View Details\") */\n actionText?: string;\n}\n\nexport function notificationEmail(\n branding: EmailBranding,\n data: NotificationEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.recipientName);\n const safeHeadline = escapeHtml(data.headline);\n const safeMessage = escapeHtml(data.message);\n\n const detailHtml = data.detail\n ? calloutBlock(\n escapeHtml(data.detail),\n branding.accentColor ?? branding.primaryColor,\n )\n : \"\";\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <h2 style=\"margin:0 0 12px;font-size:18px;color:#111827;\">${safeHeadline}</h2>\n <p style=\"font-size:15px;margin-bottom:16px;\">${safeMessage}</p>\n ${detailHtml}\n `;\n\n return emailLayout(branding, {\n subject: `${branding.appName}: ${data.headline}`,\n preheader: data.message.slice(0, 100),\n body,\n cta: data.actionUrl\n ? { text: data.actionText ?? \"View Details\", url: data.actionUrl }\n : undefined,\n });\n}\n\n// ─── Moderation ──────────────────────────────────────────────────────────────\n\nexport type ModerationAction =\n | \"warning\"\n | \"suspension\"\n | \"ban\"\n | \"reinstatement\";\n\nexport interface ModerationEmailData {\n /** User display name */\n userName: string;\n /** Type of moderation action */\n action: ModerationAction;\n /** Reason for the action */\n reason: string;\n /** What the user should do next (optional) */\n nextSteps?: string;\n /** Appeal/support URL (optional) */\n appealUrl?: string;\n}\n\nconst MODERATION_CONFIG: Record<\n ModerationAction,\n { icon: string; color: string; label: string }\n> = {\n warning: { icon: \"⚠️\", color: \"#f59e0b\", label: \"Account Warning\" },\n suspension: { icon: \"🔒\", color: \"#ef4444\", label: \"Account Suspended\" },\n ban: { icon: \"🚫\", color: \"#dc2626\", label: \"Account Banned\" },\n reinstatement: { icon: \"✅\", color: \"#10b981\", label: \"Account Reinstated\" },\n};\n\nexport function moderationEmail(\n branding: EmailBranding,\n data: ModerationEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.userName);\n const config = MODERATION_CONFIG[data.action];\n\n const reasonHtml = calloutBlock(\n `<strong>Reason:</strong> ${escapeHtml(data.reason)}`,\n config.color,\n );\n\n const nextStepsHtml = data.nextSteps\n ? `<p style=\"font-size:15px;margin:16px 0;\">${escapeHtml(data.nextSteps)}</p>`\n : \"\";\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <p style=\"font-size:15px;margin-bottom:16px;\">\n ${\n data.action === \"reinstatement\"\n ? \"Good news — your account has been reinstated.\"\n : `Your account has received a ${escapeHtml(data.action)}.`\n }\n </p>\n ${reasonHtml}\n ${nextStepsHtml}\n `;\n\n return emailLayout(branding, {\n subject: `${branding.appName}: ${config.label}`,\n preheader: config.label,\n icon: config.icon,\n subtitle: config.label,\n body,\n cta: data.appealUrl\n ? { text: \"Appeal or Contact Support\", url: data.appealUrl }\n : undefined,\n });\n}\n\n// ─── Transaction / Receipt ───────────────────────────────────────────────────\n\nexport interface TransactionEmailData {\n /** Recipient display name */\n recipientName: string;\n /** Transaction headline (e.g. \"Payment Received\", \"Order Confirmed\") */\n headline: string;\n /** Line items: [label, value] pairs */\n lineItems: [string, string][];\n /** Total amount string (e.g. \"$25.00\") */\n total?: string;\n /** Optional message above the table */\n message?: string;\n /** Optional receipt/order URL */\n receiptUrl?: string;\n}\n\nexport function transactionEmail(\n branding: EmailBranding,\n data: TransactionEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.recipientName);\n const safeHeadline = escapeHtml(data.headline);\n\n const rows = data.lineItems.map(([label, value]) => [\n escapeHtml(label),\n escapeHtml(value),\n ]);\n\n if (data.total) {\n rows.push([\n `<strong>Total</strong>`,\n `<strong>${escapeHtml(data.total)}</strong>`,\n ]);\n }\n\n const messageHtml = data.message\n ? `<p style=\"font-size:15px;margin-bottom:16px;\">${escapeHtml(data.message)}</p>`\n : \"\";\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <h2 style=\"margin:0 0 12px;font-size:18px;color:#111827;\">${safeHeadline}</h2>\n ${messageHtml}\n ${dataTable([\"Item\", \"Amount\"], rows)}\n `;\n\n return emailLayout(branding, {\n subject: `${branding.appName}: ${data.headline}`,\n preheader: data.headline,\n icon: \"🧾\",\n body,\n cta: data.receiptUrl\n ? { text: \"View Receipt\", url: data.receiptUrl }\n : undefined,\n });\n}\n\n// ─── Security Alert ──────────────────────────────────────────────────────────\n\nexport interface SecurityEmailData {\n /** User display name */\n userName: string;\n /** What happened (e.g. \"Password Changed\", \"New Login Detected\") */\n event: string;\n /** Details about the event */\n details: string;\n /** Optional action URL (e.g. reset password link) */\n actionUrl?: string;\n /** Optional action label */\n actionText?: string;\n /** Expiry note (e.g. \"This link expires in 1 hour\") */\n expiryNote?: string;\n}\n\nexport function securityEmail(\n branding: EmailBranding,\n data: SecurityEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.userName);\n\n const detailHtml = calloutBlock(escapeHtml(data.details), \"#ef4444\");\n\n const expiryHtml = data.expiryNote\n ? `<p style=\"font-size:13px;color:#9ca3af;margin-top:12px;text-align:center;\">${escapeHtml(data.expiryNote)}</p>`\n : \"\";\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <p style=\"font-size:15px;margin-bottom:16px;\">\n ${escapeHtml(data.event)}\n </p>\n ${detailHtml}\n ${expiryHtml}\n <p style=\"font-size:14px;color:#6b7280;margin-top:16px;\">\n If you didn't initiate this action, please contact support immediately.\n </p>\n `;\n\n return emailLayout(branding, {\n subject: `${branding.appName}: ${data.event}`,\n preheader: data.event,\n icon: \"🔐\",\n subtitle: \"Security Alert\",\n body,\n cta: data.actionUrl\n ? { text: data.actionText ?? \"Take Action\", url: data.actionUrl }\n : undefined,\n });\n}\n","/**\n * Signed Token Helpers\n *\n * HMAC-SHA-256 signed tokens for one-click flows that need to encode a\n * small payload (email, user id, scope) without round-tripping a database.\n *\n * Generalized from the WIAN unsubscribe-token pattern (originally email-only).\n * Now accepts arbitrary string payload + optional TTL claim.\n *\n * @example Stateless unsubscribe link\n * ```typescript\n * import { signToken, verifyToken } from \"@digilogiclabs/platform-core/auth\";\n *\n * const token = signToken({\n * payload: \"user@example.com\",\n * secret: process.env.UNSUBSCRIBE_SECRET!,\n * });\n * const unsubscribeUrl = `https://app.com/unsubscribe?token=${token}`;\n *\n * // In the route handler:\n * const result = verifyToken(req.query.token, { secret: process.env.UNSUBSCRIBE_SECRET! });\n * if (!result.valid) return new Response(\"Invalid token\", { status: 400 });\n * const email = result.payload;\n * ```\n *\n * @example Time-bounded inquiry-reply token\n * ```typescript\n * const token = signToken({\n * payload: inquiryId,\n * secret: process.env.INQUIRY_REPLY_SECRET!,\n * ttlSeconds: 7 * 24 * 60 * 60, // 7-day reply window\n * });\n * // ...\n * const result = verifyToken(token, { secret, maxAgeSeconds: 7 * 24 * 60 * 60 });\n * if (!result.valid) return new Response(\"Link expired\", { status: 410 });\n * ```\n *\n * Notes:\n * - Token format is `base64url(payload[.ts]).hmac16` — `ts` (issued-at, seconds\n * since epoch) is appended when `ttlSeconds` is provided. The HMAC is truncated\n * to 16 hex chars for short URLs; truncation is safe against forgery because\n * the attacker doesn't see the secret.\n * - HMAC compare is `crypto.timingSafeEqual` — never use `===` on the result.\n * - Secret must be at least 16 chars. Caller is responsible for sourcing it\n * (env var, secrets manager, etc.) — this module never reads `process.env`.\n */\nimport crypto from \"node:crypto\";\n\nconst HMAC_HEX_CHARS = 16; // Truncate to 16 hex chars (64 bits) for short URLs\n\nexport interface SignTokenOptions {\n /** Arbitrary payload to encode + sign. Plaintext after decode — not for secrets. */\n payload: string;\n /** HMAC secret. Must be at least 16 chars. */\n secret: string;\n /**\n * Optional TTL in seconds. When set, the issued-at timestamp is appended\n * to the payload before HMAC, and `verifyToken` checks it against the\n * caller-supplied `maxAgeSeconds`. Omit for tokens that should never expire.\n */\n ttlSeconds?: number;\n}\n\nexport interface VerifyTokenOptions {\n /** HMAC secret. Must match the one passed to `signToken`. */\n secret: string;\n /**\n * Maximum age in seconds. When set, tokens older than this fail verification.\n * Must be supplied for time-bounded tokens; tokens without a timestamp claim\n * are accepted regardless of this option's value.\n */\n maxAgeSeconds?: number;\n}\n\nexport type VerifyTokenResult =\n | { valid: true; payload: string; issuedAt?: number }\n | {\n valid: false;\n payload?: undefined;\n reason: \"malformed\" | \"bad_signature\" | \"expired\";\n };\n\nfunction validateSecret(secret: string): void {\n if (typeof secret !== \"string\" || secret.length < 16) {\n throw new Error(\n \"signToken/verifyToken require a secret of at least 16 characters\",\n );\n }\n}\n\nfunction computeHmac(secret: string, signedPart: string): string {\n return crypto\n .createHmac(\"sha256\", secret)\n .update(signedPart)\n .digest(\"hex\")\n .slice(0, HMAC_HEX_CHARS);\n}\n\n/**\n * Sign a payload string with HMAC-SHA-256. Returns a URL-safe token of the\n * form `base64url(payload[.ts]).hmac16`.\n */\nexport function signToken(opts: SignTokenOptions): string {\n validateSecret(opts.secret);\n if (typeof opts.payload !== \"string\" || opts.payload.length === 0) {\n throw new Error(\"signToken requires a non-empty payload string\");\n }\n\n const signedPart =\n opts.ttlSeconds !== undefined\n ? `${opts.payload}.${Math.floor(Date.now() / 1000)}`\n : opts.payload;\n\n const encoded = Buffer.from(signedPart, \"utf-8\").toString(\"base64url\");\n const hmac = computeHmac(opts.secret, signedPart);\n return `${encoded}.${hmac}`;\n}\n\n/**\n * Verify a signed token and recover its payload. Returns a discriminated union\n * — always branch on `result.valid` before reading `.payload` / `.reason`.\n */\nexport function verifyToken(\n token: unknown,\n opts: VerifyTokenOptions,\n): VerifyTokenResult {\n validateSecret(opts.secret);\n\n if (typeof token !== \"string\" || token.length === 0) {\n return { valid: false, reason: \"malformed\" };\n }\n\n const lastDot = token.lastIndexOf(\".\");\n if (lastDot <= 0 || lastDot === token.length - 1) {\n return { valid: false, reason: \"malformed\" };\n }\n\n const encoded = token.slice(0, lastDot);\n const providedHmac = token.slice(lastDot + 1);\n\n let signedPart: string;\n try {\n signedPart = Buffer.from(encoded, \"base64url\").toString(\"utf-8\");\n } catch {\n return { valid: false, reason: \"malformed\" };\n }\n if (signedPart.length === 0) {\n return { valid: false, reason: \"malformed\" };\n }\n\n const expectedHmac = computeHmac(opts.secret, signedPart);\n if (\n providedHmac.length !== expectedHmac.length ||\n !crypto.timingSafeEqual(\n Buffer.from(providedHmac, \"utf-8\"),\n Buffer.from(expectedHmac, \"utf-8\"),\n )\n ) {\n return { valid: false, reason: \"bad_signature\" };\n }\n\n // Parse optional issued-at timestamp suffix (`payload.ts`).\n // We rely on positional structure: if the last segment after the final dot\n // in `signedPart` is a numeric string, treat it as `ts`. Payloads that\n // happen to contain dots are still recovered correctly because we only\n // strip the suffix when it parses as a number.\n const tsDot = signedPart.lastIndexOf(\".\");\n let payload = signedPart;\n let issuedAt: number | undefined;\n\n if (tsDot > 0) {\n const tsCandidate = signedPart.slice(tsDot + 1);\n const tsNum = Number(tsCandidate);\n if (Number.isFinite(tsNum) && /^\\d+$/.test(tsCandidate)) {\n payload = signedPart.slice(0, tsDot);\n issuedAt = tsNum;\n }\n }\n\n if (opts.maxAgeSeconds !== undefined && issuedAt !== undefined) {\n const ageSeconds = Math.floor(Date.now() / 1000) - issuedAt;\n if (ageSeconds > opts.maxAgeSeconds) {\n return { valid: false, reason: \"expired\" };\n }\n }\n\n return issuedAt !== undefined\n ? { valid: true, payload, issuedAt }\n : { valid: true, payload };\n}\n","/**\n * Unsubscribe URL + List-Unsubscribe Header Generators\n *\n * Implements the RFC 2369 + RFC 8058 one-click unsubscribe flow that\n * Gmail and Yahoo bulk-sender requirements (Feb 2024) made effectively\n * mandatory for any sender crossing 5k recipients/day.\n *\n * Built on `signToken` / `verifyToken` from the /auth subpath — the\n * unsubscribe token IS a signed token where the payload is the recipient's\n * email address.\n *\n * @example wiring in an email-sending route\n * ```typescript\n * import { createUnsubscribe } from \"@digilogiclabs/platform-core/email-templates\";\n *\n * const unsub = createUnsubscribe({\n * secret: process.env.UNSUBSCRIBE_SECRET!,\n * baseUrl: \"https://opensourcesports.io\",\n * mailtoUnsubscribe: \"unsubscribe@opensourcesports.io\",\n * });\n *\n * await emailAdapter.send({\n * to,\n * subject,\n * html,\n * headers: {\n * \"List-Unsubscribe\": unsub.generateListUnsubscribeHeader(to.email),\n * \"List-Unsubscribe-Post\": unsub.generateListUnsubscribePostHeader(),\n * },\n * });\n * ```\n *\n * @example in the /unsubscribe route handler\n * ```typescript\n * import { createUnsubscribe } from \"@digilogiclabs/platform-core/email-templates\";\n *\n * const unsub = createUnsubscribe({ secret, baseUrl });\n *\n * export async function GET(req: Request) {\n * const token = new URL(req.url).searchParams.get(\"token\");\n * const email = unsub.verifyToken(token);\n * if (!email) return new Response(\"Invalid token\", { status: 400 });\n * await markUnsubscribed(email);\n * return new Response(\"Unsubscribed\", { status: 200 });\n * }\n * ```\n *\n * Pair with an RFC 8058 POST handler that accepts the one-click\n * `List-Unsubscribe-Post: List-Unsubscribe=One-Click` form body.\n */\nimport { signToken, verifyToken } from \"../auth/tokens\";\n\nexport interface UnsubscribeConfig {\n /**\n * HMAC-SHA-256 secret. Must be at least 16 chars.\n * Reuse the same secret across all email sends for a given recipient pool;\n * rotating it invalidates outstanding unsubscribe links.\n */\n secret: string;\n /** App base URL (e.g. `https://opensourcesports.io`). No trailing slash. */\n baseUrl: string;\n /**\n * Optional `mailto:` address for the List-Unsubscribe header (RFC 2369).\n * When provided, the header includes both the URL and the mailto variant\n * (some clients still prefer mailto). Defaults to omitted if absent.\n */\n mailtoUnsubscribe?: string;\n /**\n * Unsubscribe URL path (defaults to `/unsubscribe`). The query string\n * appended is `?token=<token>`.\n */\n path?: string;\n}\n\nexport interface UnsubscribeHelpers {\n /** Generate a signed unsubscribe token for an email. */\n generateToken(email: string): string;\n /** Verify a token and return the email, or null if invalid. */\n verifyToken(token: unknown): string | null;\n /** Build the full unsubscribe URL — drop in email href. */\n generateUrl(email: string): string;\n /** RFC 2369 List-Unsubscribe header value. */\n generateListUnsubscribeHeader(email: string): string;\n /** RFC 8058 one-click header value (constant). */\n generateListUnsubscribePostHeader(): \"List-Unsubscribe=One-Click\";\n}\n\nfunction normalizeEmail(email: string): string {\n return email.toLowerCase().trim();\n}\n\n/**\n * Construct a bundle of unsubscribe helpers bound to a single secret +\n * base URL. Apps typically instantiate once at module load and reuse.\n */\nexport function createUnsubscribe(cfg: UnsubscribeConfig): UnsubscribeHelpers {\n if (!cfg.secret || cfg.secret.length < 16) {\n throw new Error(\n \"createUnsubscribe requires `secret` of at least 16 characters\",\n );\n }\n if (!cfg.baseUrl) {\n throw new Error(\"createUnsubscribe requires `baseUrl`\");\n }\n const baseUrl = cfg.baseUrl.replace(/\\/+$/, \"\");\n const path = (cfg.path ?? \"/unsubscribe\").replace(/^\\/?/, \"/\");\n\n return {\n generateToken(email: string): string {\n return signToken({ payload: normalizeEmail(email), secret: cfg.secret });\n },\n\n verifyToken(token: unknown): string | null {\n const result = verifyToken(token, { secret: cfg.secret });\n return result.valid ? result.payload : null;\n },\n\n generateUrl(email: string): string {\n const token = signToken({\n payload: normalizeEmail(email),\n secret: cfg.secret,\n });\n return `${baseUrl}${path}?token=${encodeURIComponent(token)}`;\n },\n\n generateListUnsubscribeHeader(email: string): string {\n const token = signToken({\n payload: normalizeEmail(email),\n secret: cfg.secret,\n });\n const url = `${baseUrl}${path}?token=${encodeURIComponent(token)}`;\n if (cfg.mailtoUnsubscribe) {\n return `<${url}>, <mailto:${cfg.mailtoUnsubscribe}?subject=unsubscribe>`;\n }\n return `<${url}>`;\n },\n\n generateListUnsubscribePostHeader(): \"List-Unsubscribe=One-Click\" {\n return \"List-Unsubscribe=One-Click\";\n },\n };\n}\n","/**\n * Logger Interface\n * Standardizes logging across the platform\n */\n\n/**\n * Log levels in order of severity\n */\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\n/**\n * Metadata that can be attached to log entries\n */\nexport interface LogMeta {\n /** Error object if logging an error */\n error?: Error;\n /** Duration in milliseconds (for timing operations) */\n duration?: number;\n /** Request ID for tracing */\n requestId?: string;\n /** User ID if applicable */\n userId?: string;\n /** Any additional key-value pairs */\n [key: string]: unknown;\n}\n\n/**\n * A structured log entry\n */\nexport interface LogEntry {\n /** Log level */\n level: LogLevel;\n /** Log message */\n message: string;\n /** When the log was created */\n timestamp: Date;\n /** Optional metadata */\n meta?: LogMeta;\n /** Logger context (e.g., service name) */\n context?: Record<string, unknown>;\n}\n\n/**\n * Logger interface for structured logging\n */\nexport interface ILogger {\n /**\n * Log a debug message (for development/troubleshooting)\n */\n debug(message: string, meta?: LogMeta): void;\n\n /**\n * Log an informational message\n */\n info(message: string, meta?: LogMeta): void;\n\n /**\n * Log a warning message\n */\n warn(message: string, meta?: LogMeta): void;\n\n /**\n * Log an error message\n */\n error(message: string, meta?: LogMeta): void;\n\n /**\n * Create a child logger with additional context\n * @param context Additional context to include in all logs from this child\n */\n child(context: Record<string, unknown>): ILogger;\n}\n\n/**\n * Configuration options for loggers\n */\nexport interface LoggerConfig {\n /** Minimum level to log */\n level?: LogLevel;\n /** Whether to pretty print (for development) */\n pretty?: boolean;\n /** Service name to include in logs */\n service?: string;\n /** Environment name */\n environment?: string;\n}\n\n/**\n * Console logger implementation (for development)\n */\nexport class ConsoleLogger implements ILogger {\n private context: Record<string, unknown>;\n private level: LogLevel;\n\n private static levelPriority: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n };\n\n constructor(config: LoggerConfig = {}) {\n this.context = {\n service: config.service,\n environment: config.environment,\n };\n this.level = config.level || \"info\";\n }\n\n private shouldLog(level: LogLevel): boolean {\n return (\n ConsoleLogger.levelPriority[level] >=\n ConsoleLogger.levelPriority[this.level]\n );\n }\n\n private log(level: LogLevel, message: string, meta?: LogMeta): void {\n if (!this.shouldLog(level)) return;\n\n const entry: LogEntry = {\n level,\n message,\n timestamp: new Date(),\n meta,\n context: this.context,\n };\n\n const prefix = `[${entry.timestamp.toISOString()}] [${level.toUpperCase()}]`;\n const contextStr =\n Object.keys(this.context).length > 0\n ? ` [${Object.entries(this.context)\n .map(([k, v]) => `${k}=${v}`)\n .join(\" \")}]`\n : \"\";\n\n switch (level) {\n case \"debug\":\n console.debug(`${prefix}${contextStr} ${message}`, meta || \"\");\n break;\n case \"info\":\n console.info(`${prefix}${contextStr} ${message}`, meta || \"\");\n break;\n case \"warn\":\n console.warn(`${prefix}${contextStr} ${message}`, meta || \"\");\n break;\n case \"error\":\n console.error(`${prefix}${contextStr} ${message}`, meta || \"\");\n if (meta?.error) {\n console.error(meta.error);\n }\n break;\n }\n }\n\n debug(message: string, meta?: LogMeta): void {\n this.log(\"debug\", message, meta);\n }\n\n info(message: string, meta?: LogMeta): void {\n this.log(\"info\", message, meta);\n }\n\n warn(message: string, meta?: LogMeta): void {\n this.log(\"warn\", message, meta);\n }\n\n error(message: string, meta?: LogMeta): void {\n this.log(\"error\", message, meta);\n }\n\n child(context: Record<string, unknown>): ILogger {\n const childLogger = new ConsoleLogger({ level: this.level });\n childLogger.context = { ...this.context, ...context };\n return childLogger;\n }\n}\n\n/**\n * No-op logger for testing or when logging is disabled\n */\nexport class NoopLogger implements ILogger {\n debug(): void {}\n info(): void {}\n warn(): void {}\n error(): void {}\n child(): ILogger {\n return this;\n }\n}\n","/**\n * Retry Pattern Implementation\n *\n * Provides configurable retry logic with exponential backoff and jitter.\n */\n\nimport type { ILogger } from \"../interfaces/ILogger\";\nimport { NoopLogger } from \"../interfaces/ILogger\";\n\n/**\n * Options for retry behavior\n */\nexport interface RetryOptions {\n /**\n * Maximum number of retry attempts\n * @default 3\n */\n maxAttempts: number;\n\n /**\n * Initial delay between retries in milliseconds\n * @default 100\n */\n baseDelay: number;\n\n /**\n * Maximum delay between retries in milliseconds\n * @default 10000\n */\n maxDelay: number;\n\n /**\n * Multiplier for exponential backoff\n * @default 2\n */\n backoffMultiplier: number;\n\n /**\n * Whether to add random jitter to delays\n * @default true\n */\n jitter: boolean;\n\n /**\n * Maximum jitter in milliseconds\n * @default 100\n */\n maxJitter: number;\n\n /**\n * Function to determine if error is retryable\n * @default All errors are retryable\n */\n retryIf?: (error: Error) => boolean;\n\n /**\n * Function to determine if error is non-retryable\n * Takes precedence over retryIf\n */\n abortIf?: (error: Error) => boolean;\n\n /**\n * Callback on each retry attempt\n */\n onRetry?: (error: Error, attempt: number, delay: number) => void;\n\n /**\n * Logger for retry operations\n */\n logger?: ILogger;\n}\n\n/**\n * Default retry options\n */\nexport const DEFAULT_RETRY_OPTIONS: RetryOptions = {\n maxAttempts: 3,\n baseDelay: 100,\n maxDelay: 10000,\n backoffMultiplier: 2,\n jitter: true,\n maxJitter: 100,\n};\n\n/**\n * Result of a retry operation\n */\nexport interface RetryResult<T> {\n /** Whether the operation succeeded */\n success: boolean;\n\n /** The result if successful */\n result?: T;\n\n /** The final error if all attempts failed */\n error?: Error;\n\n /** Number of attempts made */\n attempts: number;\n\n /** Total time spent in milliseconds */\n totalTime: number;\n}\n\n/**\n * Sleep for specified milliseconds\n */\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Calculate delay for a given attempt\n */\nfunction calculateDelay(attempt: number, options: RetryOptions): number {\n // Exponential backoff\n let delay =\n options.baseDelay * Math.pow(options.backoffMultiplier, attempt - 1);\n\n // Cap at max delay\n delay = Math.min(delay, options.maxDelay);\n\n // Add jitter\n if (options.jitter) {\n const jitter = Math.random() * options.maxJitter;\n delay += jitter;\n }\n\n return Math.floor(delay);\n}\n\n/**\n * Execute a function with retry logic\n */\nexport async function withRetry<T>(\n fn: () => Promise<T>,\n options: Partial<RetryOptions> = {},\n): Promise<T> {\n const opts: RetryOptions = { ...DEFAULT_RETRY_OPTIONS, ...options };\n const logger = opts.logger ?? new NoopLogger();\n\n let lastError: Error | undefined;\n let delay = opts.baseDelay;\n\n for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {\n try {\n return await fn();\n } catch (error) {\n lastError = error instanceof Error ? error : new Error(String(error));\n\n // Check if error is non-retryable\n if (opts.abortIf?.(lastError)) {\n logger.debug(\"Retry aborted - non-retryable error\", {\n attempt,\n error: lastError,\n });\n throw lastError;\n }\n\n // Check if error is retryable\n if (opts.retryIf && !opts.retryIf(lastError)) {\n logger.debug(\"Retry aborted - error not retryable\", {\n attempt,\n error: lastError,\n });\n throw lastError;\n }\n\n // If this was the last attempt, throw\n if (attempt >= opts.maxAttempts) {\n logger.warn(\"All retry attempts exhausted\", {\n attempts: attempt,\n error: lastError,\n });\n throw lastError;\n }\n\n // Calculate delay for next attempt\n delay = calculateDelay(attempt, opts);\n\n logger.debug(\"Retrying operation\", {\n attempt,\n maxAttempts: opts.maxAttempts,\n delay,\n error: lastError,\n });\n\n // Call retry callback\n opts.onRetry?.(lastError, attempt, delay);\n\n // Wait before next attempt\n await sleep(delay);\n }\n }\n\n // This should never happen, but TypeScript needs it\n throw lastError ?? new Error(\"Retry failed with no error\");\n}\n\n/**\n * Execute with retry and return detailed result\n */\nexport async function withRetryResult<T>(\n fn: () => Promise<T>,\n options: Partial<RetryOptions> = {},\n): Promise<RetryResult<T>> {\n const opts: RetryOptions = { ...DEFAULT_RETRY_OPTIONS, ...options };\n const startTime = Date.now();\n\n let attempts = 0;\n let lastError: Error | undefined;\n let delay = opts.baseDelay;\n\n for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {\n attempts = attempt;\n\n try {\n const result = await fn();\n return {\n success: true,\n result,\n attempts,\n totalTime: Date.now() - startTime,\n };\n } catch (error) {\n lastError = error instanceof Error ? error : new Error(String(error));\n\n if (opts.abortIf?.(lastError)) {\n break;\n }\n\n if (opts.retryIf && !opts.retryIf(lastError)) {\n break;\n }\n\n if (attempt >= opts.maxAttempts) {\n break;\n }\n\n delay = calculateDelay(attempt, opts);\n opts.onRetry?.(lastError, attempt, delay);\n await sleep(delay);\n }\n }\n\n return {\n success: false,\n error: lastError,\n attempts,\n totalTime: Date.now() - startTime,\n };\n}\n\n/**\n * Create a retryable version of a function\n */\nexport function retryable<TArgs extends unknown[], TResult>(\n fn: (...args: TArgs) => Promise<TResult>,\n options: Partial<RetryOptions> = {},\n): (...args: TArgs) => Promise<TResult> {\n return (...args: TArgs) => withRetry(() => fn(...args), options);\n}\n\n/**\n * Common retry predicates\n */\nexport const RetryPredicates = {\n /**\n * Retry on network errors\n */\n networkErrors: (error: Error): boolean => {\n const networkErrorCodes = [\n \"ECONNRESET\",\n \"ECONNREFUSED\",\n \"ETIMEDOUT\",\n \"ENOTFOUND\",\n \"EAI_AGAIN\",\n \"EHOSTUNREACH\",\n \"ENETUNREACH\",\n ];\n\n const errorCode = (error as NodeJS.ErrnoException).code;\n if (errorCode && networkErrorCodes.includes(errorCode)) {\n return true;\n }\n\n // Check for common network error messages\n const message = error.message.toLowerCase();\n return (\n message.includes(\"network\") ||\n message.includes(\"timeout\") ||\n message.includes(\"connection\") ||\n message.includes(\"socket\")\n );\n },\n\n /**\n * Retry on HTTP 5xx errors\n */\n serverErrors: (error: Error): boolean => {\n const statusCode = (error as Error & { statusCode?: number }).statusCode;\n return statusCode !== undefined && statusCode >= 500 && statusCode < 600;\n },\n\n /**\n * Retry on HTTP 429 (rate limit) errors\n */\n rateLimitErrors: (error: Error): boolean => {\n const statusCode = (error as Error & { statusCode?: number }).statusCode;\n return statusCode === 429;\n },\n\n /**\n * Retry on database deadlock errors\n */\n deadlockErrors: (error: Error): boolean => {\n const message = error.message.toLowerCase();\n return (\n message.includes(\"deadlock\") || message.includes(\"lock wait timeout\")\n );\n },\n\n /**\n * Never retry on authentication errors\n */\n authenticationErrors: (error: Error): boolean => {\n const statusCode = (error as Error & { statusCode?: number }).statusCode;\n return statusCode === 401 || statusCode === 403;\n },\n\n /**\n * Never retry on validation errors\n */\n validationErrors: (error: Error): boolean => {\n const statusCode = (error as Error & { statusCode?: number }).statusCode;\n return statusCode === 400 || statusCode === 422;\n },\n};\n\n/**\n * Common retry configurations\n */\nexport const RetryConfigs = {\n /**\n * Fast retry for quick failures\n */\n fast: {\n maxAttempts: 3,\n baseDelay: 50,\n maxDelay: 500,\n backoffMultiplier: 2,\n } as Partial<RetryOptions>,\n\n /**\n * Standard retry configuration\n */\n standard: {\n maxAttempts: 3,\n baseDelay: 100,\n maxDelay: 5000,\n backoffMultiplier: 2,\n } as Partial<RetryOptions>,\n\n /**\n * Aggressive retry for critical operations\n */\n aggressive: {\n maxAttempts: 5,\n baseDelay: 200,\n maxDelay: 30000,\n backoffMultiplier: 2,\n } as Partial<RetryOptions>,\n\n /**\n * Conservative retry for rate-limited APIs\n */\n rateLimited: {\n maxAttempts: 3,\n baseDelay: 1000,\n maxDelay: 60000,\n backoffMultiplier: 3,\n jitter: true,\n maxJitter: 500,\n } as Partial<RetryOptions>,\n\n /**\n * Database retry configuration\n */\n database: {\n maxAttempts: 3,\n baseDelay: 100,\n maxDelay: 5000,\n backoffMultiplier: 2,\n retryIf: (error: Error) =>\n RetryPredicates.networkErrors(error) ||\n RetryPredicates.deadlockErrors(error),\n abortIf: RetryPredicates.validationErrors,\n } as Partial<RetryOptions>,\n};\n","/**\n * Circuit Breaker Pattern Implementation\n *\n * Prevents cascading failures by temporarily blocking calls to a failing service.\n */\n\nimport type { ILogger } from \"../interfaces/ILogger\";\nimport { NoopLogger } from \"../interfaces/ILogger\";\n\n/**\n * Circuit breaker states\n */\nexport type CircuitState = \"closed\" | \"open\" | \"half-open\";\n\n/**\n * Options for circuit breaker behavior\n */\nexport interface CircuitBreakerOptions {\n /**\n * Name of the circuit (for logging)\n */\n name: string;\n\n /**\n * Number of failures before opening the circuit\n * @default 5\n */\n failureThreshold: number;\n\n /**\n * Time in milliseconds before attempting to close the circuit\n * @default 30000\n */\n resetTimeout: number;\n\n /**\n * Number of successful requests needed in half-open state to close the circuit\n * @default 3\n */\n successThreshold: number;\n\n /**\n * Time window in milliseconds for counting failures\n * @default 60000\n */\n failureWindow: number;\n\n /**\n * Function to determine if error should trip the circuit\n * @default All errors trip the circuit\n */\n shouldTrip?: (error: Error) => boolean;\n\n /**\n * Callback when circuit state changes\n */\n onStateChange?: (from: CircuitState, to: CircuitState) => void;\n\n /**\n * Callback when circuit opens\n */\n onOpen?: (failures: number, lastError: Error) => void;\n\n /**\n * Callback when circuit closes\n */\n onClose?: () => void;\n\n /**\n * Callback when request is rejected due to open circuit\n */\n onReject?: (state: CircuitState) => void;\n\n /**\n * Logger for circuit breaker events\n */\n logger?: ILogger;\n}\n\n/**\n * Default circuit breaker options\n */\nexport const DEFAULT_CIRCUIT_BREAKER_OPTIONS: Omit<\n CircuitBreakerOptions,\n \"name\"\n> = {\n failureThreshold: 5,\n resetTimeout: 30000,\n successThreshold: 3,\n failureWindow: 60000,\n};\n\n/**\n * Error thrown when circuit is open\n */\nexport class CircuitOpenError extends Error {\n override readonly name = \"CircuitOpenError\";\n readonly circuitName: string;\n readonly state: CircuitState;\n readonly nextAttemptAt: Date;\n\n constructor(circuitName: string, state: CircuitState, resetTimeout: number) {\n super(\n `Circuit \"${circuitName}\" is ${state}. Retry after ${resetTimeout}ms.`,\n );\n this.circuitName = circuitName;\n this.state = state;\n this.nextAttemptAt = new Date(Date.now() + resetTimeout);\n }\n}\n\n/**\n * Circuit breaker statistics\n */\nexport interface CircuitBreakerStats {\n state: CircuitState;\n failures: number;\n successes: number;\n lastFailure?: Date;\n lastSuccess?: Date;\n lastStateChange?: Date;\n totalRequests: number;\n rejectedRequests: number;\n}\n\n/**\n * Circuit breaker implementation\n */\nexport class CircuitBreaker {\n private state: CircuitState = \"closed\";\n private failures: number = 0;\n private successes: number = 0;\n private failureTimestamps: number[] = [];\n private lastFailure?: Date;\n private lastSuccess?: Date;\n private lastStateChange?: Date;\n private lastOpenedAt?: Date;\n private totalRequests: number = 0;\n private rejectedRequests: number = 0;\n private lastError?: Error;\n private readonly options: CircuitBreakerOptions;\n private readonly logger: ILogger;\n\n constructor(options: CircuitBreakerOptions) {\n this.options = {\n ...DEFAULT_CIRCUIT_BREAKER_OPTIONS,\n ...options,\n };\n this.logger = options.logger ?? new NoopLogger();\n }\n\n /**\n * Execute a function with circuit breaker protection\n */\n async execute<T>(fn: () => Promise<T>): Promise<T> {\n this.totalRequests++;\n\n // Check if circuit allows the request\n if (!this.canExecute()) {\n this.rejectedRequests++;\n this.options.onReject?.(this.state);\n\n throw new CircuitOpenError(\n this.options.name,\n this.state,\n this.getRemainingTimeout(),\n );\n }\n\n try {\n const result = await fn();\n this.onSuccess();\n return result;\n } catch (error) {\n this.onFailure(error instanceof Error ? error : new Error(String(error)));\n throw error;\n }\n }\n\n /**\n * Check if circuit allows execution\n */\n canExecute(): boolean {\n switch (this.state) {\n case \"closed\":\n return true;\n\n case \"open\":\n // Check if reset timeout has passed\n if (this.shouldAttemptReset()) {\n this.transitionTo(\"half-open\");\n return true;\n }\n return false;\n\n case \"half-open\":\n // Allow limited requests in half-open state\n return true;\n\n default:\n return false;\n }\n }\n\n /**\n * Record a successful execution\n */\n private onSuccess(): void {\n this.lastSuccess = new Date();\n this.successes++;\n\n switch (this.state) {\n case \"half-open\":\n // Check if we've had enough successes to close\n if (this.successes >= this.options.successThreshold) {\n this.transitionTo(\"closed\");\n }\n break;\n\n case \"closed\":\n // Reset failure count on success\n this.failures = 0;\n this.failureTimestamps = [];\n break;\n }\n }\n\n /**\n * Record a failed execution\n */\n private onFailure(error: Error): void {\n // Check if this error should trip the circuit\n if (this.options.shouldTrip && !this.options.shouldTrip(error)) {\n return;\n }\n\n this.lastError = error;\n this.lastFailure = new Date();\n this.failures++;\n\n const now = Date.now();\n this.failureTimestamps.push(now);\n\n // Remove old failures outside the window\n const windowStart = now - this.options.failureWindow;\n this.failureTimestamps = this.failureTimestamps.filter(\n (ts) => ts > windowStart,\n );\n\n switch (this.state) {\n case \"closed\":\n // Check if we've hit the failure threshold\n if (this.failureTimestamps.length >= this.options.failureThreshold) {\n this.transitionTo(\"open\");\n this.options.onOpen?.(this.failures, error);\n }\n break;\n\n case \"half-open\":\n // Any failure in half-open state reopens the circuit\n this.transitionTo(\"open\");\n this.options.onOpen?.(this.failures, error);\n break;\n }\n }\n\n /**\n * Transition to a new state\n */\n private transitionTo(newState: CircuitState): void {\n const oldState = this.state;\n\n if (oldState === newState) return;\n\n this.state = newState;\n this.lastStateChange = new Date();\n\n this.logger.info(`Circuit \"${this.options.name}\" state change`, {\n from: oldState,\n to: newState,\n failures: this.failures,\n successes: this.successes,\n });\n\n this.options.onStateChange?.(oldState, newState);\n\n switch (newState) {\n case \"open\":\n this.lastOpenedAt = new Date();\n this.successes = 0;\n break;\n\n case \"half-open\":\n this.successes = 0;\n break;\n\n case \"closed\":\n this.failures = 0;\n this.failureTimestamps = [];\n this.successes = 0;\n this.options.onClose?.();\n break;\n }\n }\n\n /**\n * Check if reset timeout has passed\n */\n private shouldAttemptReset(): boolean {\n if (!this.lastOpenedAt) return true;\n\n const elapsed = Date.now() - this.lastOpenedAt.getTime();\n return elapsed >= this.options.resetTimeout;\n }\n\n /**\n * Get remaining time until reset attempt\n */\n private getRemainingTimeout(): number {\n if (!this.lastOpenedAt) return 0;\n\n const elapsed = Date.now() - this.lastOpenedAt.getTime();\n return Math.max(0, this.options.resetTimeout - elapsed);\n }\n\n /**\n * Get current circuit state\n */\n getState(): CircuitState {\n return this.state;\n }\n\n /**\n * Get circuit breaker statistics\n */\n getStats(): CircuitBreakerStats {\n return {\n state: this.state,\n failures: this.failures,\n successes: this.successes,\n lastFailure: this.lastFailure,\n lastSuccess: this.lastSuccess,\n lastStateChange: this.lastStateChange,\n totalRequests: this.totalRequests,\n rejectedRequests: this.rejectedRequests,\n };\n }\n\n /**\n * Manually reset the circuit to closed state\n */\n reset(): void {\n this.transitionTo(\"closed\");\n }\n\n /**\n * Manually trip the circuit to open state\n */\n trip(): void {\n this.transitionTo(\"open\");\n }\n\n /**\n * Check if circuit is open\n */\n isOpen(): boolean {\n return this.state === \"open\";\n }\n\n /**\n * Check if circuit is closed\n */\n isClosed(): boolean {\n return this.state === \"closed\";\n }\n\n /**\n * Check if circuit is half-open\n */\n isHalfOpen(): boolean {\n return this.state === \"half-open\";\n }\n}\n\n/**\n * Create a circuit breaker\n */\nexport function createCircuitBreaker(\n options: CircuitBreakerOptions,\n): CircuitBreaker {\n return new CircuitBreaker(options);\n}\n\n/**\n * Circuit breaker registry for managing multiple circuits\n */\nexport class CircuitBreakerRegistry {\n private circuits: Map<string, CircuitBreaker> = new Map();\n private readonly logger: ILogger;\n private readonly defaultOptions: Partial<CircuitBreakerOptions>;\n\n constructor(\n options: {\n logger?: ILogger;\n defaults?: Partial<CircuitBreakerOptions>;\n } = {},\n ) {\n this.logger = options.logger ?? new NoopLogger();\n this.defaultOptions = options.defaults ?? {};\n }\n\n /**\n * Get or create a circuit breaker\n */\n get(name: string, options?: Partial<CircuitBreakerOptions>): CircuitBreaker {\n let circuit = this.circuits.get(name);\n\n if (!circuit) {\n circuit = new CircuitBreaker({\n ...DEFAULT_CIRCUIT_BREAKER_OPTIONS,\n ...this.defaultOptions,\n ...options,\n name,\n logger: options?.logger ?? this.logger,\n });\n this.circuits.set(name, circuit);\n }\n\n return circuit;\n }\n\n /**\n * Execute with a named circuit breaker\n */\n async execute<T>(\n name: string,\n fn: () => Promise<T>,\n options?: Partial<CircuitBreakerOptions>,\n ): Promise<T> {\n const circuit = this.get(name, options);\n return circuit.execute(fn);\n }\n\n /**\n * Get all circuit statistics\n */\n getAllStats(): Record<string, CircuitBreakerStats> {\n const stats: Record<string, CircuitBreakerStats> = {};\n\n for (const [name, circuit] of this.circuits) {\n stats[name] = circuit.getStats();\n }\n\n return stats;\n }\n\n /**\n * Reset all circuits\n */\n resetAll(): void {\n for (const circuit of this.circuits.values()) {\n circuit.reset();\n }\n }\n\n /**\n * Clear all circuits\n */\n clear(): void {\n this.circuits.clear();\n }\n}\n","/**\n * Resilient Email Transport Wrapper\n *\n * Wraps any `IEmail` adapter with retry + optional circuit-breaker +\n * optional timeout. Solves the \"Resend is briefly flaky / rate-limited /\n * the network blipped\" class of failure without each app re-implementing\n * the same wrapping logic.\n *\n * Defaults are conservative:\n * - retry: 3 attempts, 200ms base delay, exponential backoff with jitter\n * - circuit breaker: disabled (opt-in)\n * - timeout: disabled (opt-in)\n *\n * Wraps both `send` and `sendBatch` — `healthCheck` is NOT wrapped\n * because retry-on-health-check would mask the very thing it probes.\n *\n * @example wrap the existing ResendEmail adapter\n * ```typescript\n * import { Resend } from \"resend\";\n * import { ResendEmail } from \"@digilogiclabs/platform-core\";\n * import { createResilientEmail } from \"@digilogiclabs/platform-core/email-templates\";\n *\n * const inner = new ResendEmail(new Resend(apiKey), \"noreply@app.com\");\n * const email = createResilientEmail(inner, {\n * retry: { maxAttempts: 3 },\n * circuitBreaker: { failureThreshold: 5, openDurationMs: 30_000 },\n * timeoutMs: 5_000,\n * });\n *\n * await email.send({ to: { email: \"user@example.com\" }, subject, html });\n * ```\n *\n * Works with any IEmail adapter — Resend, SMTP, Console — not just Resend.\n * The factory name historically referenced Resend because that was the\n * first consumer; the implementation is adapter-agnostic.\n */\nimport type { IEmail, EmailMessage, EmailResult } from \"../interfaces/IEmail\";\nimport { withRetry } from \"../resilience/retry\";\nimport { CircuitBreaker } from \"../resilience/circuit-breaker\";\nimport type { CircuitBreakerOptions } from \"../resilience/circuit-breaker\";\nimport type { RetryOptions } from \"../resilience/retry\";\n\nexport interface ResilientEmailOptions {\n /**\n * Retry config. Pass `false` to disable. Defaults to `{ maxAttempts: 3 }`\n * (with the platform's standard exponential backoff + jitter).\n */\n retry?: Partial<RetryOptions> | false;\n /**\n * Circuit breaker config. Omit or pass `false` to disable.\n * When enabled, the breaker wraps the retry loop so an open circuit\n * fails fast without exhausting retries.\n */\n circuitBreaker?: CircuitBreakerOptions | false;\n /**\n * Timeout in milliseconds for a single send attempt. Omit to disable.\n * Applied per-attempt, not per-call — a request that times out is\n * still subject to retries.\n */\n timeoutMs?: number;\n}\n\nconst DEFAULT_RETRY: Partial<RetryOptions> = {\n maxAttempts: 3,\n};\n\nfunction withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {\n return new Promise<T>((resolve, reject) => {\n const timer = setTimeout(\n () => reject(new Error(`email send timed out after ${ms}ms`)),\n ms,\n );\n promise.then(\n (v) => {\n clearTimeout(timer);\n resolve(v);\n },\n (e) => {\n clearTimeout(timer);\n reject(e);\n },\n );\n });\n}\n\n/**\n * Wrap an `IEmail` adapter with retry, optional circuit breaker, and\n * optional timeout. Returns a new `IEmail` — the inner adapter is not\n * mutated.\n */\nexport function createResilientEmail(\n inner: IEmail,\n options: ResilientEmailOptions = {},\n): IEmail {\n const retryOpts =\n options.retry === false\n ? null\n : { ...DEFAULT_RETRY, ...(options.retry ?? {}) };\n const breaker = options.circuitBreaker\n ? new CircuitBreaker(options.circuitBreaker)\n : null;\n const timeoutMs = options.timeoutMs;\n\n const wrapAttempt = async <T>(fn: () => Promise<T>): Promise<T> => {\n if (timeoutMs !== undefined) {\n return withTimeout(fn(), timeoutMs);\n }\n return fn();\n };\n\n const withResilience = async <T>(fn: () => Promise<T>): Promise<T> => {\n const exec = async () => {\n if (retryOpts) {\n return withRetry(() => wrapAttempt(fn), retryOpts);\n }\n return wrapAttempt(fn);\n };\n if (breaker) {\n return breaker.execute(exec);\n }\n return exec();\n };\n\n return {\n async send(message: EmailMessage): Promise<EmailResult> {\n return withResilience(() => inner.send(message));\n },\n async sendBatch(messages: EmailMessage[]): Promise<EmailResult[]> {\n return withResilience(() => inner.sendBatch(messages));\n },\n async healthCheck(): Promise<boolean> {\n // Intentionally unwrapped — retry would mask the probe.\n return inner.healthCheck();\n },\n };\n}\n"],"mappings":"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","names":["crypto"]}
|
|
1
|
+
{"version":3,"sources":["../src/email-templates/index.ts","../src/security.ts","../src/email-templates/layout.ts","../src/email-templates/templates.ts","../src/auth/tokens.ts","../src/email-templates/unsubscribe.ts","../src/interfaces/ILogger.ts","../src/resilience/retry.ts","../src/resilience/circuit-breaker.ts","../src/email-templates/transport.ts"],"sourcesContent":["/**\n * Shared email template module.\n *\n * Provides a branding-driven email layout system with pre-built templates\n * and composable HTML building blocks. Zero external dependencies —\n * only uses escapeHtml from platform-core's security module.\n *\n * @example\n * ```ts\n * import {\n * welcomeEmail,\n * digestEmail,\n * emailLayout,\n * calloutBlock,\n * } from \"@digilogiclabs/platform-core/email-templates\";\n *\n * const branding: EmailBranding = {\n * appName: \"MyApp\",\n * primaryColor: \"#667eea\",\n * fromEmail: \"noreply@myapp.com\",\n * baseUrl: \"https://myapp.com\",\n * };\n *\n * const { subject, html, text } = welcomeEmail(branding, {\n * userName: \"Alice\",\n * dashboardUrl: \"https://myapp.com/dashboard\",\n * steps: [\n * { title: \"Set up profile\", description: \"Add your photo and bio\" },\n * { title: \"Explore features\", description: \"Check out what's available\" },\n * ],\n * });\n * ```\n */\n\n// Types\nexport type {\n EmailBranding,\n EmailCTA,\n EmailStep,\n EmailStat,\n EmailTableRow,\n EmailLayoutOptions,\n EmailOutput,\n} from \"./types\";\n\n// Layout engine + building blocks\nexport {\n emailLayout,\n calloutBlock,\n stepBlock,\n statsBar,\n dataTable,\n tipBlock,\n sectionHeading,\n divider,\n escapeHtml,\n} from \"./layout\";\n\n// Pre-built templates\nexport {\n welcomeEmail,\n digestEmail,\n notificationEmail,\n moderationEmail,\n transactionEmail,\n securityEmail,\n} from \"./templates\";\n\n// Template data types\nexport type {\n WelcomeEmailData,\n DigestEmailData,\n NotificationEmailData,\n ModerationEmailData,\n ModerationAction,\n TransactionEmailData,\n SecurityEmailData,\n} from \"./templates\";\n\n// Unsubscribe (RFC 2369 + RFC 8058) — HMAC-signed token + header generators\nexport { createUnsubscribe } from \"./unsubscribe\";\nexport type { UnsubscribeConfig, UnsubscribeHelpers } from \"./unsubscribe\";\n\n// Resilient email transport — wraps any IEmail with retry + circuit + timeout\nexport { createResilientEmail } from \"./transport\";\nexport type { ResilientEmailOptions } from \"./transport\";\n","/**\n * Security Utilities\n *\n * HTML escaping, input detection, sanitization helpers,\n * timing-safe comparison, error sanitization, and request\n * correlation for safe, consistent security across all apps.\n */\n\nimport { timingSafeEqual } from \"crypto\";\n\n/** Regex for protocol-prefixed URLs */\nexport const URL_PROTOCOL_PATTERN = /(https?:\\/\\/|ftp:\\/\\/|www\\.)\\S+/i;\n\n/** Regex for bare domain names with common TLDs */\nexport const URL_DOMAIN_PATTERN =\n /\\b[\\w.-]+\\.(com|net|org|io|co|dev|app|xyz|info|biz|me|us|uk|edu|gov)\\b/i;\n\n/** Regex for HTML tags */\nexport const HTML_TAG_PATTERN = /<[^>]*>/;\n\n/**\n * Escape HTML special characters to prevent injection.\n * Use when inserting user content into HTML email templates or rendered HTML.\n */\nexport function escapeHtml(str: string): string {\n return str\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/\"/g, \""\")\n .replace(/'/g, \"'\");\n}\n\n/** Check if a string contains protocol-prefixed URLs or bare domains */\nexport function containsUrls(str: string): boolean {\n return URL_PROTOCOL_PATTERN.test(str) || URL_DOMAIN_PATTERN.test(str);\n}\n\n/** Check if a string contains HTML tags */\nexport function containsHtml(str: string): boolean {\n return HTML_TAG_PATTERN.test(str);\n}\n\n/** Strip all HTML tags from a string */\nexport function stripHtml(str: string): string {\n return str.replace(/<[^>]*>/g, \"\");\n}\n\n/**\n * Strip null bytes (U+0000) from a string.\n *\n * Postgres rejects null bytes in `text`/`varchar` columns with a hard\n * `invalid byte sequence` error (→ HTTP 500 in app handlers). Apps that\n * forward raw user input — search queries, filter params, form fields —\n * into Drizzle/raw SQL queries hit this on malicious or malformed clients\n * that inject `%00` in URLs.\n *\n * Pass `undefined`/`null` through unchanged so it composes cleanly with\n * optional query params: `stripNullBytes(url.searchParams.get('q'))?.trim()`.\n *\n * @example\n * ```typescript\n * import { stripNullBytes } from '@digilogiclabs/platform-core/auth';\n *\n * const q = stripNullBytes(url.searchParams.get('q'))?.trim();\n * const results = await db.select().where(ilike(column, `%${q}%`));\n * ```\n */\nexport function stripNullBytes(value: string): string;\nexport function stripNullBytes(value: null | undefined): null | undefined;\nexport function stripNullBytes(\n value: string | null | undefined,\n): string | null | undefined;\nexport function stripNullBytes(\n value: string | null | undefined,\n): string | null | undefined {\n if (value === null || value === undefined) return value;\n return value.replace(/\\u0000/g, \"\");\n}\n\n/**\n * Recursively strip null bytes from all string values in a plain object or\n * array. Non-string values pass through unchanged. Use on parsed JSON\n * request bodies before forwarding to DB queries.\n *\n * Preserves the object's own keys and order; does NOT mutate the input.\n * Arrays stay arrays. Stops at 8 levels deep as a guard against accidental\n * circular references (throws at depth-limit exceeded).\n *\n * @example\n * ```typescript\n * import { stripNullBytesDeep } from '@digilogiclabs/platform-core/auth';\n *\n * const body = stripNullBytesDeep(await request.json());\n * const parsed = schema.safeParse(body);\n * ```\n */\nexport function stripNullBytesDeep<T>(value: T, depth = 8): T {\n if (depth <= 0) {\n throw new Error(\"stripNullBytesDeep: max depth exceeded (circular?)\");\n }\n if (typeof value === \"string\") {\n return value.replace(/\\u0000/g, \"\") as unknown as T;\n }\n if (Array.isArray(value)) {\n return value.map((v) => stripNullBytesDeep(v, depth - 1)) as unknown as T;\n }\n if (value !== null && typeof value === \"object\") {\n const out: Record<string, unknown> = {};\n for (const [k, v] of Object.entries(value)) {\n out[k] = stripNullBytesDeep(v, depth - 1);\n }\n return out as T;\n }\n return value;\n}\n\n/**\n * Defang URLs to prevent auto-linking in email clients.\n * Converts https://evil.com → hxxps://evil[.]com\n */\nexport function defangUrl(str: string): string {\n return str\n .replace(/https:\\/\\//gi, \"hxxps://\")\n .replace(/http:\\/\\//gi, \"hxxp://\")\n .replace(/ftp:\\/\\//gi, \"fxp://\")\n .replace(\n /\\.(com|net|org|io|co|dev|app|xyz|info|biz|me|us|uk|edu|gov)\\b/gi,\n \"[$1]\",\n );\n}\n\n/**\n * Sanitize user content for safe insertion into HTML email templates.\n * Escapes HTML entities AND defangs any URLs that slipped through validation.\n */\nexport function sanitizeForEmail(str: string): string {\n return escapeHtml(str);\n}\n\n// ═══════════════════════════════════════════════════════════════\n// API SECURITY UTILITIES\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * Constant-time string comparison to prevent timing side-channel attacks.\n * Use for comparing secrets, tokens, API keys, HMAC signatures, etc.\n *\n * Returns false (not throws) for length mismatches — still constant-time\n * relative to the shorter string to avoid leaking length info.\n *\n * @example\n * ```typescript\n * if (!constantTimeEqual(providedToken, expectedSecret)) {\n * return { status: 401, error: 'Invalid token' }\n * }\n * ```\n */\nexport function constantTimeEqual(a: string, b: string): boolean {\n try {\n const aBuf = Buffer.from(a, \"utf-8\");\n const bBuf = Buffer.from(b, \"utf-8\");\n if (aBuf.length !== bBuf.length) return false;\n return timingSafeEqual(aBuf, bBuf);\n } catch {\n return false;\n }\n}\n\n/**\n * Sanitize an error for client-facing API responses.\n *\n * - 4xx errors: returns the actual message (client needs to know what went wrong)\n * - 5xx errors: returns a generic message (never leak internals to clients)\n * - Development mode: optionally includes stack trace for debugging\n *\n * @example\n * ```typescript\n * catch (error) {\n * const { message, code } = sanitizeApiError(error, 500)\n * return Response.json({ error: message, code }, { status: 500 })\n * }\n * ```\n */\nexport function sanitizeApiError(\n error: unknown,\n statusCode: number,\n isDevelopment = false,\n): { message: string; code?: string; stack?: string } {\n // Client errors — safe to expose the message\n if (statusCode >= 400 && statusCode < 500) {\n const message =\n error instanceof Error ? error.message : String(error || \"Bad request\");\n return { message };\n }\n\n // Server errors — generic message to clients, real error in logs only\n const result: { message: string; code: string; stack?: string } = {\n message: \"An internal error occurred. Please try again later.\",\n code: \"INTERNAL_ERROR\",\n };\n\n if (isDevelopment && error instanceof Error) {\n result.stack = error.stack;\n }\n\n return result;\n}\n\n/**\n * Extract a correlation/request ID from standard headers, or generate one.\n *\n * Checks (in order): X-Request-ID, X-Correlation-ID, then falls back to\n * crypto.randomUUID(). Works with any headers-like object (plain object,\n * Headers API, or a getter function).\n *\n * @example\n * ```typescript\n * // With Next.js request\n * const id = getCorrelationId((name) => request.headers.get(name))\n *\n * // With plain object\n * const id = getCorrelationId({ 'x-request-id': 'abc-123' })\n * ```\n */\nexport function getCorrelationId(\n headers:\n | Record<string, string | string[] | undefined>\n | ((name: string) => string | null | undefined),\n): string {\n const get =\n typeof headers === \"function\"\n ? headers\n : (name: string) => {\n const val = headers[name] ?? headers[name.toLowerCase()];\n return Array.isArray(val) ? val[0] : val;\n };\n\n return (\n get(\"x-request-id\") ||\n get(\"X-Request-ID\") ||\n get(\"x-correlation-id\") ||\n get(\"X-Correlation-ID\") ||\n crypto.randomUUID()\n );\n}\n","/**\n * Base email layout builder.\n *\n * Generates a fully responsive, email-client-compatible HTML email\n * using only inline styles and table-based layout.\n *\n * Every user-facing string in the layout is pre-escaped. Template functions\n * that accept user input MUST escape those values before passing them to body.\n */\nimport type { EmailBranding, EmailLayoutOptions, EmailOutput } from \"./types\";\nimport { escapeHtml } from \"../security\";\n\nconst FONT_STACK =\n \"-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif\";\n\n/**\n * Darken a hex color by a percentage (0-100).\n * Used to auto-generate gradientTo from primaryColor.\n */\nfunction darkenHex(hex: string, percent: number): string {\n const num = parseInt(hex.replace(\"#\", \"\"), 16);\n const r = Math.max(0, (num >> 16) - Math.round(2.55 * percent));\n const g = Math.max(0, ((num >> 8) & 0x00ff) - Math.round(2.55 * percent));\n const b = Math.max(0, (num & 0x0000ff) - Math.round(2.55 * percent));\n return `#${((r << 16) | (g << 8) | b).toString(16).padStart(6, \"0\")}`;\n}\n\n/**\n * Strip HTML tags for plain-text fallback.\n */\nfunction htmlToText(html: string): string {\n return html\n .replace(/<br\\s*\\/?>/gi, \"\\n\")\n .replace(/<\\/p>/gi, \"\\n\\n\")\n .replace(/<\\/div>/gi, \"\\n\")\n .replace(/<\\/tr>/gi, \"\\n\")\n .replace(/<\\/li>/gi, \"\\n\")\n .replace(/<li[^>]*>/gi, \"- \")\n .replace(/<a[^>]*href=\"([^\"]*)\"[^>]*>([^<]*)<\\/a>/gi, \"$2 ($1)\")\n .replace(/<[^>]+>/g, \"\")\n .replace(/ /g, \" \")\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/"/g, '\"')\n .replace(/'/g, \"'\")\n .replace(/→/g, \"→\")\n .replace(/\\n{3,}/g, \"\\n\\n\")\n .trim();\n}\n\n/**\n * Build a complete HTML email from branding + layout options.\n *\n * Returns `{ subject, html, text }` ready to pass to any IEmail adapter.\n */\nexport function emailLayout(\n branding: EmailBranding,\n options: EmailLayoutOptions,\n): EmailOutput {\n const gradientFrom = branding.gradientFrom ?? branding.primaryColor;\n const gradientTo =\n branding.gradientTo ?? darkenHex(branding.primaryColor, 15);\n const accentColor = branding.accentColor ?? branding.primaryColor;\n\n const preheaderHtml = options.preheader\n ? `<div style=\"display:none;font-size:1px;color:#f3f4f6;line-height:1px;max-height:0;max-width:0;opacity:0;overflow:hidden;\">${escapeHtml(options.preheader)}</div>`\n : \"\";\n\n const iconHtml = options.icon ? `${options.icon} ` : \"\";\n\n const subtitleHtml = options.subtitle\n ? `<p style=\"margin:4px 0 0;color:rgba(255,255,255,0.85);font-size:14px;\">${escapeHtml(options.subtitle)}</p>`\n : \"\";\n\n // Logo image — when branding.logoUrl is supplied, render an <img> above\n // the appName text. Email-client-safe attributes only: explicit width,\n // alt text, display:block, border:0. Hosted PNG (or JPG) only — most\n // email clients (Outlook, Gmail's image proxy) do not render SVG.\n const logoHtml = branding.logoUrl\n ? `<img src=\"${escapeHtml(branding.logoUrl)}\" alt=\"${escapeHtml(branding.appName)}\" width=\"56\" height=\"56\" style=\"display:block;margin:0 auto 10px;border:0;outline:none;text-decoration:none;border-radius:10px;background:#ffffff;padding:6px;\" />`\n : \"\";\n\n const ctaHtml = options.cta\n ? `\n <tr>\n <td style=\"padding:0 32px 24px;text-align:center;\">\n <a href=\"${escapeHtml(options.cta.url)}\"\n style=\"display:inline-block;padding:12px 28px;background:${accentColor};color:#ffffff;text-decoration:none;border-radius:6px;font-weight:600;font-size:14px;\">\n ${escapeHtml(options.cta.text)}\n </a>\n </td>\n </tr>`\n : \"\";\n\n const footerLinksHtml =\n options.footerLinks && options.footerLinks.length > 0\n ? options.footerLinks\n .map(\n (link) =>\n `<a href=\"${escapeHtml(link.url)}\" style=\"color:${accentColor};text-decoration:none;\">${escapeHtml(link.label)}</a>`,\n )\n .join(\" · \")\n : \"\";\n\n const preferencesHtml = branding.preferencesUrl\n ? `<p style=\"margin:4px 0 0;font-size:12px;color:#9ca3af;\">\n <a href=\"${escapeHtml(branding.preferencesUrl)}\" style=\"color:${accentColor};text-decoration:none;\">Update email preferences</a>\n </p>`\n : \"\";\n\n const html = `<!DOCTYPE html>\n<html lang=\"en\">\n<head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0\"><title>${escapeHtml(options.subject)}</title></head>\n<body style=\"margin:0;padding:0;background:#f3f4f6;font-family:${FONT_STACK};\">\n ${preheaderHtml}\n <table width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" style=\"background:#f3f4f6;padding:24px 0;\">\n <tr><td align=\"center\">\n <table width=\"600\" cellpadding=\"0\" cellspacing=\"0\" style=\"background:#ffffff;border-radius:8px;overflow:hidden;max-width:600px;\">\n <!-- Header -->\n <tr>\n <td style=\"background:linear-gradient(135deg,${gradientFrom},${gradientTo});padding:28px 32px;text-align:center;\">\n ${logoHtml}<h1 style=\"margin:0;color:#ffffff;font-size:22px;font-weight:700;\">${iconHtml}${escapeHtml(branding.appName)}</h1>\n ${subtitleHtml}\n </td>\n </tr>\n\n <!-- Body -->\n <tr>\n <td style=\"padding:28px 32px;color:#374151;font-size:15px;line-height:1.6;\">\n ${options.body}\n </td>\n </tr>\n\n ${ctaHtml}\n\n <!-- Footer -->\n <tr>\n <td style=\"padding:16px 32px;background:#f9fafb;text-align:center;border-top:1px solid #e5e7eb;\">\n ${footerLinksHtml ? `<p style=\"margin:0 0 4px;font-size:12px;color:#9ca3af;\">${footerLinksHtml}</p>` : \"\"}\n <p style=\"margin:0;font-size:12px;color:#9ca3af;\">\n ${branding.footerText ? escapeHtml(branding.footerText) + \" · \" : \"\"}\n <a href=\"${escapeHtml(branding.baseUrl)}\" style=\"color:${accentColor};text-decoration:none;\">${escapeHtml(branding.appName)}</a>\n </p>\n ${preferencesHtml}\n </td>\n </tr>\n </table>\n </td></tr>\n </table>\n</body>\n</html>`;\n\n const text = `${options.icon ? options.icon + \" \" : \"\"}${options.subject}\\n${\"=\".repeat(40)}\\n\\n${htmlToText(options.body)}${options.cta ? `\\n\\n${options.cta.text}: ${options.cta.url}` : \"\"}\\n\\n---\\n${branding.footerText ? branding.footerText + \"\\n\" : \"\"}${branding.appName} - ${branding.baseUrl}${branding.preferencesUrl ? \"\\nEmail preferences: \" + branding.preferencesUrl : \"\"}`;\n\n return { subject: options.subject, html, text };\n}\n\n// ─── HTML Building Blocks ────────────────────────────────────────────────────\n// These helpers generate safe HTML fragments for use inside template body content.\n// All user-provided values MUST be escaped before calling these.\n\n/** Highlighted callout box with colored left border. */\nexport function calloutBlock(\n content: string,\n color: string = \"#3b82f6\",\n): string {\n return `<div style=\"background:#f9fafb;padding:16px 20px;border-radius:8px;border-left:4px solid ${color};margin:16px 0;\">${content}</div>`;\n}\n\n/** Numbered step card (for onboarding sequences). */\nexport function stepBlock(\n number: number,\n title: string,\n description: string,\n color: string = \"#667eea\",\n): string {\n return `<div style=\"background:#f3f4f6;padding:16px;border-radius:8px;margin-bottom:12px;border-left:4px solid ${color};\">\n <p style=\"margin:0;font-weight:600;color:#111827;\">${number}. ${title}</p>\n <p style=\"margin:8px 0 0;font-size:14px;color:#6b7280;\">${description}</p>\n </div>`;\n}\n\n/** Stats bar — row of metric cards. */\nexport function statsBar(\n stats: { label: string; value: string | number }[],\n): string {\n const cells = stats\n .map(\n (s) =>\n `<span style=\"display:inline-block;margin:0 16px;font-size:14px;color:#374151;\"><strong>${escapeHtml(String(s.value))}</strong> ${escapeHtml(s.label)}</span>`,\n )\n .join(\"\");\n return `<div style=\"padding:12px 0;text-align:center;background:#f0fdf4;border-radius:6px;margin-bottom:16px;\">${cells}</div>`;\n}\n\n/** Simple data table with header row. */\nexport function dataTable(headers: string[], rows: string[][]): string {\n const headerCells = headers\n .map(\n (h) =>\n `<th style=\"padding:8px 12px;text-align:left;font-size:13px;color:#374151;border-bottom:1px solid #e5e7eb;\">${escapeHtml(h)}</th>`,\n )\n .join(\"\");\n\n const bodyRows = rows\n .map(\n (row) =>\n `<tr>${row.map((cell) => `<td style=\"padding:8px 12px;border-bottom:1px solid #e5e7eb;font-size:14px;color:#374151;\">${cell}</td>`).join(\"\")}</tr>`,\n )\n .join(\"\");\n\n return `<table width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" style=\"border:1px solid #e5e7eb;border-radius:6px;overflow:hidden;\">\n <tr style=\"background:#f9fafb;\">${headerCells}</tr>\n ${bodyRows}\n </table>`;\n}\n\n/** Info/tip box with icon. */\nexport function tipBlock(content: string, icon: string = \"💡\"): string {\n return `<div style=\"background:#eff6ff;border:2px solid #3b82f6;padding:16px 20px;border-radius:8px;margin:16px 0;\">\n <p style=\"margin:0;color:#1e40af;font-size:14px;\"><strong>${icon} Pro Tip:</strong> ${content}</p>\n </div>`;\n}\n\n/** Centered heading within email body. */\nexport function sectionHeading(text: string): string {\n return `<h2 style=\"margin:24px 0 12px;font-size:16px;color:#111827;\">${escapeHtml(text)}</h2>`;\n}\n\n/** Horizontal rule divider. */\nexport function divider(): string {\n return `<hr style=\"border:none;border-top:1px solid #e5e7eb;margin:24px 0;\">`;\n}\n\n/** Re-export escapeHtml for template authors. */\nexport { escapeHtml } from \"../security\";\n","/**\n * Pre-built email templates.\n *\n * Each template accepts branding + template-specific data, composes the\n * layout + building blocks, and returns { subject, html, text }.\n *\n * Apps call these directly — no need to touch layout internals.\n * All user-provided strings are escaped internally.\n */\nimport type { EmailBranding, EmailOutput, EmailStep, EmailStat } from \"./types\";\nimport {\n emailLayout,\n calloutBlock,\n stepBlock,\n statsBar,\n dataTable,\n tipBlock,\n sectionHeading,\n divider,\n escapeHtml,\n} from \"./layout\";\n\n// ─── Welcome / Onboarding ────────────────────────────────────────────────────\n\nexport interface WelcomeEmailData {\n /** User's display name */\n userName: string;\n /** URL to their dashboard or profile */\n dashboardUrl: string;\n /** Onboarding steps (typically 3) */\n steps: EmailStep[];\n /** Optional pro-tip text */\n tip?: string;\n}\n\nexport function welcomeEmail(\n branding: EmailBranding,\n data: WelcomeEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.userName);\n\n const stepsHtml = data.steps\n .map((s, i) =>\n stepBlock(\n i + 1,\n escapeHtml(s.title),\n escapeHtml(s.description),\n branding.accentColor ?? branding.primaryColor,\n ),\n )\n .join(\"\");\n\n const tipHtml = data.tip ? tipBlock(escapeHtml(data.tip)) : \"\";\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <p style=\"font-size:15px;margin-bottom:20px;\">\n Welcome aboard! Your account is all set up and ready to go.\n </p>\n ${sectionHeading(\"Get Started\")}\n ${stepsHtml}\n ${tipHtml}\n `;\n\n return emailLayout(branding, {\n subject: `Welcome to ${branding.appName}!`,\n preheader: `Your ${branding.appName} account is ready`,\n icon: \"🎉\",\n subtitle: \"Welcome aboard\",\n body,\n cta: { text: \"Go to Dashboard\", url: data.dashboardUrl },\n footerLinks: branding.supportEmail\n ? [{ label: \"Get Help\", url: `mailto:${branding.supportEmail}` }]\n : undefined,\n });\n}\n\n// ─── Digest / Summary ────────────────────────────────────────────────────────\n\nexport interface DigestEmailData {\n /** Recipient display name */\n recipientName: string;\n /** Period label (e.g. \"This Week\", \"March 2026\") */\n period: string;\n /** Summary stats shown in the stats bar */\n stats: EmailStat[];\n /** Main body HTML (app-specific content — must be pre-escaped) */\n contentHtml: string;\n /** Optional: URL to view full report */\n reportUrl?: string;\n /** Optional: why they're receiving this */\n subscriptionNote?: string;\n}\n\nexport function digestEmail(\n branding: EmailBranding,\n data: DigestEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.recipientName);\n const safePeriod = escapeHtml(data.period);\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <p style=\"font-size:15px;margin-bottom:16px;\">\n Here's your ${safePeriod.toLowerCase()} summary:\n </p>\n ${statsBar(data.stats)}\n ${data.contentHtml}\n ${data.subscriptionNote ? `<p style=\"margin-top:20px;font-size:13px;color:#9ca3af;\">${escapeHtml(data.subscriptionNote)}</p>` : \"\"}\n `;\n\n return emailLayout(branding, {\n subject: `${branding.appName} — ${data.period} Summary`,\n preheader: `Your ${data.period.toLowerCase()} activity on ${branding.appName}`,\n icon: \"📊\",\n subtitle: safePeriod,\n body,\n cta: data.reportUrl\n ? { text: \"View Full Report\", url: data.reportUrl }\n : undefined,\n });\n}\n\n// ─── Notification ────────────────────────────────────────────────────────────\n\nexport interface NotificationEmailData {\n /** Recipient display name */\n recipientName: string;\n /** Notification headline */\n headline: string;\n /** Main message body (HTML-safe — will be escaped) */\n message: string;\n /** Optional highlighted detail block */\n detail?: string;\n /** Optional CTA */\n actionUrl?: string;\n /** Optional CTA label (defaults to \"View Details\") */\n actionText?: string;\n}\n\nexport function notificationEmail(\n branding: EmailBranding,\n data: NotificationEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.recipientName);\n const safeHeadline = escapeHtml(data.headline);\n const safeMessage = escapeHtml(data.message);\n\n const detailHtml = data.detail\n ? calloutBlock(\n escapeHtml(data.detail),\n branding.accentColor ?? branding.primaryColor,\n )\n : \"\";\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <h2 style=\"margin:0 0 12px;font-size:18px;color:#111827;\">${safeHeadline}</h2>\n <p style=\"font-size:15px;margin-bottom:16px;\">${safeMessage}</p>\n ${detailHtml}\n `;\n\n return emailLayout(branding, {\n subject: `${branding.appName}: ${data.headline}`,\n preheader: data.message.slice(0, 100),\n body,\n cta: data.actionUrl\n ? { text: data.actionText ?? \"View Details\", url: data.actionUrl }\n : undefined,\n });\n}\n\n// ─── Moderation ──────────────────────────────────────────────────────────────\n\nexport type ModerationAction =\n \"warning\" | \"suspension\" | \"ban\" | \"reinstatement\";\n\nexport interface ModerationEmailData {\n /** User display name */\n userName: string;\n /** Type of moderation action */\n action: ModerationAction;\n /** Reason for the action */\n reason: string;\n /** What the user should do next (optional) */\n nextSteps?: string;\n /** Appeal/support URL (optional) */\n appealUrl?: string;\n}\n\nconst MODERATION_CONFIG: Record<\n ModerationAction,\n { icon: string; color: string; label: string }\n> = {\n warning: { icon: \"⚠️\", color: \"#f59e0b\", label: \"Account Warning\" },\n suspension: { icon: \"🔒\", color: \"#ef4444\", label: \"Account Suspended\" },\n ban: { icon: \"🚫\", color: \"#dc2626\", label: \"Account Banned\" },\n reinstatement: { icon: \"✅\", color: \"#10b981\", label: \"Account Reinstated\" },\n};\n\nexport function moderationEmail(\n branding: EmailBranding,\n data: ModerationEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.userName);\n const config = MODERATION_CONFIG[data.action];\n\n const reasonHtml = calloutBlock(\n `<strong>Reason:</strong> ${escapeHtml(data.reason)}`,\n config.color,\n );\n\n const nextStepsHtml = data.nextSteps\n ? `<p style=\"font-size:15px;margin:16px 0;\">${escapeHtml(data.nextSteps)}</p>`\n : \"\";\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <p style=\"font-size:15px;margin-bottom:16px;\">\n ${\n data.action === \"reinstatement\"\n ? \"Good news — your account has been reinstated.\"\n : `Your account has received a ${escapeHtml(data.action)}.`\n }\n </p>\n ${reasonHtml}\n ${nextStepsHtml}\n `;\n\n return emailLayout(branding, {\n subject: `${branding.appName}: ${config.label}`,\n preheader: config.label,\n icon: config.icon,\n subtitle: config.label,\n body,\n cta: data.appealUrl\n ? { text: \"Appeal or Contact Support\", url: data.appealUrl }\n : undefined,\n });\n}\n\n// ─── Transaction / Receipt ───────────────────────────────────────────────────\n\nexport interface TransactionEmailData {\n /** Recipient display name */\n recipientName: string;\n /** Transaction headline (e.g. \"Payment Received\", \"Order Confirmed\") */\n headline: string;\n /** Line items: [label, value] pairs */\n lineItems: [string, string][];\n /** Total amount string (e.g. \"$25.00\") */\n total?: string;\n /** Optional message above the table */\n message?: string;\n /** Optional receipt/order URL */\n receiptUrl?: string;\n}\n\nexport function transactionEmail(\n branding: EmailBranding,\n data: TransactionEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.recipientName);\n const safeHeadline = escapeHtml(data.headline);\n\n const rows = data.lineItems.map(([label, value]) => [\n escapeHtml(label),\n escapeHtml(value),\n ]);\n\n if (data.total) {\n rows.push([\n `<strong>Total</strong>`,\n `<strong>${escapeHtml(data.total)}</strong>`,\n ]);\n }\n\n const messageHtml = data.message\n ? `<p style=\"font-size:15px;margin-bottom:16px;\">${escapeHtml(data.message)}</p>`\n : \"\";\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <h2 style=\"margin:0 0 12px;font-size:18px;color:#111827;\">${safeHeadline}</h2>\n ${messageHtml}\n ${dataTable([\"Item\", \"Amount\"], rows)}\n `;\n\n return emailLayout(branding, {\n subject: `${branding.appName}: ${data.headline}`,\n preheader: data.headline,\n icon: \"🧾\",\n body,\n cta: data.receiptUrl\n ? { text: \"View Receipt\", url: data.receiptUrl }\n : undefined,\n });\n}\n\n// ─── Security Alert ──────────────────────────────────────────────────────────\n\nexport interface SecurityEmailData {\n /** User display name */\n userName: string;\n /** What happened (e.g. \"Password Changed\", \"New Login Detected\") */\n event: string;\n /** Details about the event */\n details: string;\n /** Optional action URL (e.g. reset password link) */\n actionUrl?: string;\n /** Optional action label */\n actionText?: string;\n /** Expiry note (e.g. \"This link expires in 1 hour\") */\n expiryNote?: string;\n}\n\nexport function securityEmail(\n branding: EmailBranding,\n data: SecurityEmailData,\n): EmailOutput {\n const safeName = escapeHtml(data.userName);\n\n const detailHtml = calloutBlock(escapeHtml(data.details), \"#ef4444\");\n\n const expiryHtml = data.expiryNote\n ? `<p style=\"font-size:13px;color:#9ca3af;margin-top:12px;text-align:center;\">${escapeHtml(data.expiryNote)}</p>`\n : \"\";\n\n const body = `\n <p style=\"font-size:16px;margin-bottom:20px;\">Hi ${safeName},</p>\n <p style=\"font-size:15px;margin-bottom:16px;\">\n ${escapeHtml(data.event)}\n </p>\n ${detailHtml}\n ${expiryHtml}\n <p style=\"font-size:14px;color:#6b7280;margin-top:16px;\">\n If you didn't initiate this action, please contact support immediately.\n </p>\n `;\n\n return emailLayout(branding, {\n subject: `${branding.appName}: ${data.event}`,\n preheader: data.event,\n icon: \"🔐\",\n subtitle: \"Security Alert\",\n body,\n cta: data.actionUrl\n ? { text: data.actionText ?? \"Take Action\", url: data.actionUrl }\n : undefined,\n });\n}\n","/**\n * Signed Token Helpers\n *\n * HMAC-SHA-256 signed tokens for one-click flows that need to encode a\n * small payload (email, user id, scope) without round-tripping a database.\n *\n * Generalized from the WIAN unsubscribe-token pattern (originally email-only).\n * Now accepts arbitrary string payload + optional TTL claim.\n *\n * @example Stateless unsubscribe link\n * ```typescript\n * import { signToken, verifyToken } from \"@digilogiclabs/platform-core/auth\";\n *\n * const token = signToken({\n * payload: \"user@example.com\",\n * secret: process.env.UNSUBSCRIBE_SECRET!,\n * });\n * const unsubscribeUrl = `https://app.com/unsubscribe?token=${token}`;\n *\n * // In the route handler:\n * const result = verifyToken(req.query.token, { secret: process.env.UNSUBSCRIBE_SECRET! });\n * if (!result.valid) return new Response(\"Invalid token\", { status: 400 });\n * const email = result.payload;\n * ```\n *\n * @example Time-bounded inquiry-reply token\n * ```typescript\n * const token = signToken({\n * payload: inquiryId,\n * secret: process.env.INQUIRY_REPLY_SECRET!,\n * ttlSeconds: 7 * 24 * 60 * 60, // 7-day reply window\n * });\n * // ...\n * const result = verifyToken(token, { secret, maxAgeSeconds: 7 * 24 * 60 * 60 });\n * if (!result.valid) return new Response(\"Link expired\", { status: 410 });\n * ```\n *\n * Notes:\n * - Token format is `base64url(payload[.ts]).hmac16` — `ts` (issued-at, seconds\n * since epoch) is appended when `ttlSeconds` is provided. The HMAC is truncated\n * to 16 hex chars for short URLs; truncation is safe against forgery because\n * the attacker doesn't see the secret.\n * - HMAC compare is `crypto.timingSafeEqual` — never use `===` on the result.\n * - Secret must be at least 16 chars. Caller is responsible for sourcing it\n * (env var, secrets manager, etc.) — this module never reads `process.env`.\n */\nimport crypto from \"node:crypto\";\n\nconst HMAC_HEX_CHARS = 16; // Truncate to 16 hex chars (64 bits) for short URLs\n\nexport interface SignTokenOptions {\n /** Arbitrary payload to encode + sign. Plaintext after decode — not for secrets. */\n payload: string;\n /** HMAC secret. Must be at least 16 chars. */\n secret: string;\n /**\n * Optional TTL in seconds. When set, the issued-at timestamp is appended\n * to the payload before HMAC, and `verifyToken` checks it against the\n * caller-supplied `maxAgeSeconds`. Omit for tokens that should never expire.\n */\n ttlSeconds?: number;\n}\n\nexport interface VerifyTokenOptions {\n /** HMAC secret. Must match the one passed to `signToken`. */\n secret: string;\n /**\n * Maximum age in seconds. When set, tokens older than this fail verification.\n * Must be supplied for time-bounded tokens; tokens without a timestamp claim\n * are accepted regardless of this option's value.\n */\n maxAgeSeconds?: number;\n}\n\nexport type VerifyTokenResult =\n | { valid: true; payload: string; issuedAt?: number }\n | {\n valid: false;\n payload?: undefined;\n reason: \"malformed\" | \"bad_signature\" | \"expired\";\n };\n\nfunction validateSecret(secret: string): void {\n if (typeof secret !== \"string\" || secret.length < 16) {\n throw new Error(\n \"signToken/verifyToken require a secret of at least 16 characters\",\n );\n }\n}\n\nfunction computeHmac(secret: string, signedPart: string): string {\n return crypto\n .createHmac(\"sha256\", secret)\n .update(signedPart)\n .digest(\"hex\")\n .slice(0, HMAC_HEX_CHARS);\n}\n\n/**\n * Sign a payload string with HMAC-SHA-256. Returns a URL-safe token of the\n * form `base64url(payload[.ts]).hmac16`.\n */\nexport function signToken(opts: SignTokenOptions): string {\n validateSecret(opts.secret);\n if (typeof opts.payload !== \"string\" || opts.payload.length === 0) {\n throw new Error(\"signToken requires a non-empty payload string\");\n }\n\n const signedPart =\n opts.ttlSeconds !== undefined\n ? `${opts.payload}.${Math.floor(Date.now() / 1000)}`\n : opts.payload;\n\n const encoded = Buffer.from(signedPart, \"utf-8\").toString(\"base64url\");\n const hmac = computeHmac(opts.secret, signedPart);\n return `${encoded}.${hmac}`;\n}\n\n/**\n * Verify a signed token and recover its payload. Returns a discriminated union\n * — always branch on `result.valid` before reading `.payload` / `.reason`.\n */\nexport function verifyToken(\n token: unknown,\n opts: VerifyTokenOptions,\n): VerifyTokenResult {\n validateSecret(opts.secret);\n\n if (typeof token !== \"string\" || token.length === 0) {\n return { valid: false, reason: \"malformed\" };\n }\n\n const lastDot = token.lastIndexOf(\".\");\n if (lastDot <= 0 || lastDot === token.length - 1) {\n return { valid: false, reason: \"malformed\" };\n }\n\n const encoded = token.slice(0, lastDot);\n const providedHmac = token.slice(lastDot + 1);\n\n let signedPart: string;\n try {\n signedPart = Buffer.from(encoded, \"base64url\").toString(\"utf-8\");\n } catch {\n return { valid: false, reason: \"malformed\" };\n }\n if (signedPart.length === 0) {\n return { valid: false, reason: \"malformed\" };\n }\n\n const expectedHmac = computeHmac(opts.secret, signedPart);\n if (\n providedHmac.length !== expectedHmac.length ||\n !crypto.timingSafeEqual(\n Buffer.from(providedHmac, \"utf-8\"),\n Buffer.from(expectedHmac, \"utf-8\"),\n )\n ) {\n return { valid: false, reason: \"bad_signature\" };\n }\n\n // Parse optional issued-at timestamp suffix (`payload.ts`).\n // We rely on positional structure: if the last segment after the final dot\n // in `signedPart` is a numeric string, treat it as `ts`. Payloads that\n // happen to contain dots are still recovered correctly because we only\n // strip the suffix when it parses as a number.\n const tsDot = signedPart.lastIndexOf(\".\");\n let payload = signedPart;\n let issuedAt: number | undefined;\n\n if (tsDot > 0) {\n const tsCandidate = signedPart.slice(tsDot + 1);\n const tsNum = Number(tsCandidate);\n if (Number.isFinite(tsNum) && /^\\d+$/.test(tsCandidate)) {\n payload = signedPart.slice(0, tsDot);\n issuedAt = tsNum;\n }\n }\n\n if (opts.maxAgeSeconds !== undefined && issuedAt !== undefined) {\n const ageSeconds = Math.floor(Date.now() / 1000) - issuedAt;\n if (ageSeconds > opts.maxAgeSeconds) {\n return { valid: false, reason: \"expired\" };\n }\n }\n\n return issuedAt !== undefined\n ? { valid: true, payload, issuedAt }\n : { valid: true, payload };\n}\n","/**\n * Unsubscribe URL + List-Unsubscribe Header Generators\n *\n * Implements the RFC 2369 + RFC 8058 one-click unsubscribe flow that\n * Gmail and Yahoo bulk-sender requirements (Feb 2024) made effectively\n * mandatory for any sender crossing 5k recipients/day.\n *\n * Built on `signToken` / `verifyToken` from the /auth subpath — the\n * unsubscribe token IS a signed token where the payload is the recipient's\n * email address.\n *\n * @example wiring in an email-sending route\n * ```typescript\n * import { createUnsubscribe } from \"@digilogiclabs/platform-core/email-templates\";\n *\n * const unsub = createUnsubscribe({\n * secret: process.env.UNSUBSCRIBE_SECRET!,\n * baseUrl: \"https://opensourcesports.io\",\n * mailtoUnsubscribe: \"unsubscribe@opensourcesports.io\",\n * });\n *\n * await emailAdapter.send({\n * to,\n * subject,\n * html,\n * headers: {\n * \"List-Unsubscribe\": unsub.generateListUnsubscribeHeader(to.email),\n * \"List-Unsubscribe-Post\": unsub.generateListUnsubscribePostHeader(),\n * },\n * });\n * ```\n *\n * @example in the /unsubscribe route handler\n * ```typescript\n * import { createUnsubscribe } from \"@digilogiclabs/platform-core/email-templates\";\n *\n * const unsub = createUnsubscribe({ secret, baseUrl });\n *\n * export async function GET(req: Request) {\n * const token = new URL(req.url).searchParams.get(\"token\");\n * const email = unsub.verifyToken(token);\n * if (!email) return new Response(\"Invalid token\", { status: 400 });\n * await markUnsubscribed(email);\n * return new Response(\"Unsubscribed\", { status: 200 });\n * }\n * ```\n *\n * Pair with an RFC 8058 POST handler that accepts the one-click\n * `List-Unsubscribe-Post: List-Unsubscribe=One-Click` form body.\n */\nimport { signToken, verifyToken } from \"../auth/tokens\";\n\nexport interface UnsubscribeConfig {\n /**\n * HMAC-SHA-256 secret. Must be at least 16 chars.\n * Reuse the same secret across all email sends for a given recipient pool;\n * rotating it invalidates outstanding unsubscribe links.\n */\n secret: string;\n /** App base URL (e.g. `https://opensourcesports.io`). No trailing slash. */\n baseUrl: string;\n /**\n * Optional `mailto:` address for the List-Unsubscribe header (RFC 2369).\n * When provided, the header includes both the URL and the mailto variant\n * (some clients still prefer mailto). Defaults to omitted if absent.\n */\n mailtoUnsubscribe?: string;\n /**\n * Unsubscribe URL path (defaults to `/unsubscribe`). The query string\n * appended is `?token=<token>`.\n */\n path?: string;\n}\n\nexport interface UnsubscribeHelpers {\n /** Generate a signed unsubscribe token for an email. */\n generateToken(email: string): string;\n /** Verify a token and return the email, or null if invalid. */\n verifyToken(token: unknown): string | null;\n /** Build the full unsubscribe URL — drop in email href. */\n generateUrl(email: string): string;\n /** RFC 2369 List-Unsubscribe header value. */\n generateListUnsubscribeHeader(email: string): string;\n /** RFC 8058 one-click header value (constant). */\n generateListUnsubscribePostHeader(): \"List-Unsubscribe=One-Click\";\n}\n\nfunction normalizeEmail(email: string): string {\n return email.toLowerCase().trim();\n}\n\n/**\n * Construct a bundle of unsubscribe helpers bound to a single secret +\n * base URL. Apps typically instantiate once at module load and reuse.\n */\nexport function createUnsubscribe(cfg: UnsubscribeConfig): UnsubscribeHelpers {\n if (!cfg.secret || cfg.secret.length < 16) {\n throw new Error(\n \"createUnsubscribe requires `secret` of at least 16 characters\",\n );\n }\n if (!cfg.baseUrl) {\n throw new Error(\"createUnsubscribe requires `baseUrl`\");\n }\n const baseUrl = cfg.baseUrl.replace(/\\/+$/, \"\");\n const path = (cfg.path ?? \"/unsubscribe\").replace(/^\\/?/, \"/\");\n\n return {\n generateToken(email: string): string {\n return signToken({ payload: normalizeEmail(email), secret: cfg.secret });\n },\n\n verifyToken(token: unknown): string | null {\n const result = verifyToken(token, { secret: cfg.secret });\n return result.valid ? result.payload : null;\n },\n\n generateUrl(email: string): string {\n const token = signToken({\n payload: normalizeEmail(email),\n secret: cfg.secret,\n });\n return `${baseUrl}${path}?token=${encodeURIComponent(token)}`;\n },\n\n generateListUnsubscribeHeader(email: string): string {\n const token = signToken({\n payload: normalizeEmail(email),\n secret: cfg.secret,\n });\n const url = `${baseUrl}${path}?token=${encodeURIComponent(token)}`;\n if (cfg.mailtoUnsubscribe) {\n return `<${url}>, <mailto:${cfg.mailtoUnsubscribe}?subject=unsubscribe>`;\n }\n return `<${url}>`;\n },\n\n generateListUnsubscribePostHeader(): \"List-Unsubscribe=One-Click\" {\n return \"List-Unsubscribe=One-Click\";\n },\n };\n}\n","/**\n * Logger Interface\n * Standardizes logging across the platform\n */\n\n/**\n * Log levels in order of severity\n */\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\n/**\n * Metadata that can be attached to log entries\n */\nexport interface LogMeta {\n /** Error object if logging an error */\n error?: Error;\n /** Duration in milliseconds (for timing operations) */\n duration?: number;\n /** Request ID for tracing */\n requestId?: string;\n /** User ID if applicable */\n userId?: string;\n /** Any additional key-value pairs */\n [key: string]: unknown;\n}\n\n/**\n * A structured log entry\n */\nexport interface LogEntry {\n /** Log level */\n level: LogLevel;\n /** Log message */\n message: string;\n /** When the log was created */\n timestamp: Date;\n /** Optional metadata */\n meta?: LogMeta;\n /** Logger context (e.g., service name) */\n context?: Record<string, unknown>;\n}\n\n/**\n * Logger interface for structured logging\n */\nexport interface ILogger {\n /**\n * Log a debug message (for development/troubleshooting)\n */\n debug(message: string, meta?: LogMeta): void;\n\n /**\n * Log an informational message\n */\n info(message: string, meta?: LogMeta): void;\n\n /**\n * Log a warning message\n */\n warn(message: string, meta?: LogMeta): void;\n\n /**\n * Log an error message\n */\n error(message: string, meta?: LogMeta): void;\n\n /**\n * Create a child logger with additional context\n * @param context Additional context to include in all logs from this child\n */\n child(context: Record<string, unknown>): ILogger;\n}\n\n/**\n * Configuration options for loggers\n */\nexport interface LoggerConfig {\n /** Minimum level to log */\n level?: LogLevel;\n /** Whether to pretty print (for development) */\n pretty?: boolean;\n /** Service name to include in logs */\n service?: string;\n /** Environment name */\n environment?: string;\n}\n\n/**\n * Console logger implementation (for development)\n */\nexport class ConsoleLogger implements ILogger {\n private context: Record<string, unknown>;\n private level: LogLevel;\n\n private static levelPriority: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n };\n\n constructor(config: LoggerConfig = {}) {\n this.context = {\n service: config.service,\n environment: config.environment,\n };\n this.level = config.level || \"info\";\n }\n\n private shouldLog(level: LogLevel): boolean {\n return (\n ConsoleLogger.levelPriority[level] >=\n ConsoleLogger.levelPriority[this.level]\n );\n }\n\n private log(level: LogLevel, message: string, meta?: LogMeta): void {\n if (!this.shouldLog(level)) return;\n\n const entry: LogEntry = {\n level,\n message,\n timestamp: new Date(),\n meta,\n context: this.context,\n };\n\n const prefix = `[${entry.timestamp.toISOString()}] [${level.toUpperCase()}]`;\n const contextStr =\n Object.keys(this.context).length > 0\n ? ` [${Object.entries(this.context)\n .map(([k, v]) => `${k}=${v}`)\n .join(\" \")}]`\n : \"\";\n\n switch (level) {\n case \"debug\":\n console.debug(`${prefix}${contextStr} ${message}`, meta || \"\");\n break;\n case \"info\":\n console.info(`${prefix}${contextStr} ${message}`, meta || \"\");\n break;\n case \"warn\":\n console.warn(`${prefix}${contextStr} ${message}`, meta || \"\");\n break;\n case \"error\":\n console.error(`${prefix}${contextStr} ${message}`, meta || \"\");\n if (meta?.error) {\n console.error(meta.error);\n }\n break;\n }\n }\n\n debug(message: string, meta?: LogMeta): void {\n this.log(\"debug\", message, meta);\n }\n\n info(message: string, meta?: LogMeta): void {\n this.log(\"info\", message, meta);\n }\n\n warn(message: string, meta?: LogMeta): void {\n this.log(\"warn\", message, meta);\n }\n\n error(message: string, meta?: LogMeta): void {\n this.log(\"error\", message, meta);\n }\n\n child(context: Record<string, unknown>): ILogger {\n const childLogger = new ConsoleLogger({ level: this.level });\n childLogger.context = { ...this.context, ...context };\n return childLogger;\n }\n}\n\n/**\n * No-op logger for testing or when logging is disabled\n */\nexport class NoopLogger implements ILogger {\n debug(): void {}\n info(): void {}\n warn(): void {}\n error(): void {}\n child(): ILogger {\n return this;\n }\n}\n","/**\n * Retry Pattern Implementation\n *\n * Provides configurable retry logic with exponential backoff and jitter.\n */\n\nimport type { ILogger } from \"../interfaces/ILogger\";\nimport { NoopLogger } from \"../interfaces/ILogger\";\n\n/**\n * Options for retry behavior\n */\nexport interface RetryOptions {\n /**\n * Maximum number of retry attempts\n * @default 3\n */\n maxAttempts: number;\n\n /**\n * Initial delay between retries in milliseconds\n * @default 100\n */\n baseDelay: number;\n\n /**\n * Maximum delay between retries in milliseconds\n * @default 10000\n */\n maxDelay: number;\n\n /**\n * Multiplier for exponential backoff\n * @default 2\n */\n backoffMultiplier: number;\n\n /**\n * Whether to add random jitter to delays\n * @default true\n */\n jitter: boolean;\n\n /**\n * Maximum jitter in milliseconds\n * @default 100\n */\n maxJitter: number;\n\n /**\n * Function to determine if error is retryable\n * @default All errors are retryable\n */\n retryIf?: (error: Error) => boolean;\n\n /**\n * Function to determine if error is non-retryable\n * Takes precedence over retryIf\n */\n abortIf?: (error: Error) => boolean;\n\n /**\n * Callback on each retry attempt\n */\n onRetry?: (error: Error, attempt: number, delay: number) => void;\n\n /**\n * Logger for retry operations\n */\n logger?: ILogger;\n}\n\n/**\n * Default retry options\n */\nexport const DEFAULT_RETRY_OPTIONS: RetryOptions = {\n maxAttempts: 3,\n baseDelay: 100,\n maxDelay: 10000,\n backoffMultiplier: 2,\n jitter: true,\n maxJitter: 100,\n};\n\n/**\n * Result of a retry operation\n */\nexport interface RetryResult<T> {\n /** Whether the operation succeeded */\n success: boolean;\n\n /** The result if successful */\n result?: T;\n\n /** The final error if all attempts failed */\n error?: Error;\n\n /** Number of attempts made */\n attempts: number;\n\n /** Total time spent in milliseconds */\n totalTime: number;\n}\n\n/**\n * Sleep for specified milliseconds\n */\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Calculate delay for a given attempt\n */\nfunction calculateDelay(attempt: number, options: RetryOptions): number {\n // Exponential backoff\n let delay =\n options.baseDelay * Math.pow(options.backoffMultiplier, attempt - 1);\n\n // Cap at max delay\n delay = Math.min(delay, options.maxDelay);\n\n // Add jitter\n if (options.jitter) {\n const jitter = Math.random() * options.maxJitter;\n delay += jitter;\n }\n\n return Math.floor(delay);\n}\n\n/**\n * Execute a function with retry logic\n */\nexport async function withRetry<T>(\n fn: () => Promise<T>,\n options: Partial<RetryOptions> = {},\n): Promise<T> {\n const opts: RetryOptions = { ...DEFAULT_RETRY_OPTIONS, ...options };\n const logger = opts.logger ?? new NoopLogger();\n\n let lastError: Error | undefined;\n let delay = opts.baseDelay;\n\n for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {\n try {\n return await fn();\n } catch (error) {\n lastError = error instanceof Error ? error : new Error(String(error));\n\n // Check if error is non-retryable\n if (opts.abortIf?.(lastError)) {\n logger.debug(\"Retry aborted - non-retryable error\", {\n attempt,\n error: lastError,\n });\n throw lastError;\n }\n\n // Check if error is retryable\n if (opts.retryIf && !opts.retryIf(lastError)) {\n logger.debug(\"Retry aborted - error not retryable\", {\n attempt,\n error: lastError,\n });\n throw lastError;\n }\n\n // If this was the last attempt, throw\n if (attempt >= opts.maxAttempts) {\n logger.warn(\"All retry attempts exhausted\", {\n attempts: attempt,\n error: lastError,\n });\n throw lastError;\n }\n\n // Calculate delay for next attempt\n delay = calculateDelay(attempt, opts);\n\n logger.debug(\"Retrying operation\", {\n attempt,\n maxAttempts: opts.maxAttempts,\n delay,\n error: lastError,\n });\n\n // Call retry callback\n opts.onRetry?.(lastError, attempt, delay);\n\n // Wait before next attempt\n await sleep(delay);\n }\n }\n\n // This should never happen, but TypeScript needs it\n throw lastError ?? new Error(\"Retry failed with no error\");\n}\n\n/**\n * Execute with retry and return detailed result\n */\nexport async function withRetryResult<T>(\n fn: () => Promise<T>,\n options: Partial<RetryOptions> = {},\n): Promise<RetryResult<T>> {\n const opts: RetryOptions = { ...DEFAULT_RETRY_OPTIONS, ...options };\n const startTime = Date.now();\n\n let attempts = 0;\n let lastError: Error | undefined;\n let delay = opts.baseDelay;\n\n for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {\n attempts = attempt;\n\n try {\n const result = await fn();\n return {\n success: true,\n result,\n attempts,\n totalTime: Date.now() - startTime,\n };\n } catch (error) {\n lastError = error instanceof Error ? error : new Error(String(error));\n\n if (opts.abortIf?.(lastError)) {\n break;\n }\n\n if (opts.retryIf && !opts.retryIf(lastError)) {\n break;\n }\n\n if (attempt >= opts.maxAttempts) {\n break;\n }\n\n delay = calculateDelay(attempt, opts);\n opts.onRetry?.(lastError, attempt, delay);\n await sleep(delay);\n }\n }\n\n return {\n success: false,\n error: lastError,\n attempts,\n totalTime: Date.now() - startTime,\n };\n}\n\n/**\n * Create a retryable version of a function\n */\nexport function retryable<TArgs extends unknown[], TResult>(\n fn: (...args: TArgs) => Promise<TResult>,\n options: Partial<RetryOptions> = {},\n): (...args: TArgs) => Promise<TResult> {\n return (...args: TArgs) => withRetry(() => fn(...args), options);\n}\n\n/**\n * Common retry predicates\n */\nexport const RetryPredicates = {\n /**\n * Retry on network errors\n */\n networkErrors: (error: Error): boolean => {\n const networkErrorCodes = [\n \"ECONNRESET\",\n \"ECONNREFUSED\",\n \"ETIMEDOUT\",\n \"ENOTFOUND\",\n \"EAI_AGAIN\",\n \"EHOSTUNREACH\",\n \"ENETUNREACH\",\n ];\n\n const errorCode = (error as NodeJS.ErrnoException).code;\n if (errorCode && networkErrorCodes.includes(errorCode)) {\n return true;\n }\n\n // Check for common network error messages\n const message = error.message.toLowerCase();\n return (\n message.includes(\"network\") ||\n message.includes(\"timeout\") ||\n message.includes(\"connection\") ||\n message.includes(\"socket\")\n );\n },\n\n /**\n * Retry on HTTP 5xx errors\n */\n serverErrors: (error: Error): boolean => {\n const statusCode = (error as Error & { statusCode?: number }).statusCode;\n return statusCode !== undefined && statusCode >= 500 && statusCode < 600;\n },\n\n /**\n * Retry on HTTP 429 (rate limit) errors\n */\n rateLimitErrors: (error: Error): boolean => {\n const statusCode = (error as Error & { statusCode?: number }).statusCode;\n return statusCode === 429;\n },\n\n /**\n * Retry on database deadlock errors\n */\n deadlockErrors: (error: Error): boolean => {\n const message = error.message.toLowerCase();\n return (\n message.includes(\"deadlock\") || message.includes(\"lock wait timeout\")\n );\n },\n\n /**\n * Never retry on authentication errors\n */\n authenticationErrors: (error: Error): boolean => {\n const statusCode = (error as Error & { statusCode?: number }).statusCode;\n return statusCode === 401 || statusCode === 403;\n },\n\n /**\n * Never retry on validation errors\n */\n validationErrors: (error: Error): boolean => {\n const statusCode = (error as Error & { statusCode?: number }).statusCode;\n return statusCode === 400 || statusCode === 422;\n },\n};\n\n/**\n * Common retry configurations\n */\nexport const RetryConfigs = {\n /**\n * Fast retry for quick failures\n */\n fast: {\n maxAttempts: 3,\n baseDelay: 50,\n maxDelay: 500,\n backoffMultiplier: 2,\n } as Partial<RetryOptions>,\n\n /**\n * Standard retry configuration\n */\n standard: {\n maxAttempts: 3,\n baseDelay: 100,\n maxDelay: 5000,\n backoffMultiplier: 2,\n } as Partial<RetryOptions>,\n\n /**\n * Aggressive retry for critical operations\n */\n aggressive: {\n maxAttempts: 5,\n baseDelay: 200,\n maxDelay: 30000,\n backoffMultiplier: 2,\n } as Partial<RetryOptions>,\n\n /**\n * Conservative retry for rate-limited APIs\n */\n rateLimited: {\n maxAttempts: 3,\n baseDelay: 1000,\n maxDelay: 60000,\n backoffMultiplier: 3,\n jitter: true,\n maxJitter: 500,\n } as Partial<RetryOptions>,\n\n /**\n * Database retry configuration\n */\n database: {\n maxAttempts: 3,\n baseDelay: 100,\n maxDelay: 5000,\n backoffMultiplier: 2,\n retryIf: (error: Error) =>\n RetryPredicates.networkErrors(error) ||\n RetryPredicates.deadlockErrors(error),\n abortIf: RetryPredicates.validationErrors,\n } as Partial<RetryOptions>,\n};\n","/**\n * Circuit Breaker Pattern Implementation\n *\n * Prevents cascading failures by temporarily blocking calls to a failing service.\n */\n\nimport type { ILogger } from \"../interfaces/ILogger\";\nimport { NoopLogger } from \"../interfaces/ILogger\";\n\n/**\n * Circuit breaker states\n */\nexport type CircuitState = \"closed\" | \"open\" | \"half-open\";\n\n/**\n * Options for circuit breaker behavior\n */\nexport interface CircuitBreakerOptions {\n /**\n * Name of the circuit (for logging)\n */\n name: string;\n\n /**\n * Number of failures before opening the circuit\n * @default 5\n */\n failureThreshold: number;\n\n /**\n * Time in milliseconds before attempting to close the circuit\n * @default 30000\n */\n resetTimeout: number;\n\n /**\n * Number of successful requests needed in half-open state to close the circuit\n * @default 3\n */\n successThreshold: number;\n\n /**\n * Time window in milliseconds for counting failures\n * @default 60000\n */\n failureWindow: number;\n\n /**\n * Function to determine if error should trip the circuit\n * @default All errors trip the circuit\n */\n shouldTrip?: (error: Error) => boolean;\n\n /**\n * Callback when circuit state changes\n */\n onStateChange?: (from: CircuitState, to: CircuitState) => void;\n\n /**\n * Callback when circuit opens\n */\n onOpen?: (failures: number, lastError: Error) => void;\n\n /**\n * Callback when circuit closes\n */\n onClose?: () => void;\n\n /**\n * Callback when request is rejected due to open circuit\n */\n onReject?: (state: CircuitState) => void;\n\n /**\n * Logger for circuit breaker events\n */\n logger?: ILogger;\n}\n\n/**\n * Default circuit breaker options\n */\nexport const DEFAULT_CIRCUIT_BREAKER_OPTIONS: Omit<\n CircuitBreakerOptions,\n \"name\"\n> = {\n failureThreshold: 5,\n resetTimeout: 30000,\n successThreshold: 3,\n failureWindow: 60000,\n};\n\n/**\n * Error thrown when circuit is open\n */\nexport class CircuitOpenError extends Error {\n override readonly name = \"CircuitOpenError\";\n readonly circuitName: string;\n readonly state: CircuitState;\n readonly nextAttemptAt: Date;\n\n constructor(circuitName: string, state: CircuitState, resetTimeout: number) {\n super(\n `Circuit \"${circuitName}\" is ${state}. Retry after ${resetTimeout}ms.`,\n );\n this.circuitName = circuitName;\n this.state = state;\n this.nextAttemptAt = new Date(Date.now() + resetTimeout);\n }\n}\n\n/**\n * Circuit breaker statistics\n */\nexport interface CircuitBreakerStats {\n state: CircuitState;\n failures: number;\n successes: number;\n lastFailure?: Date;\n lastSuccess?: Date;\n lastStateChange?: Date;\n totalRequests: number;\n rejectedRequests: number;\n}\n\n/**\n * Circuit breaker implementation\n */\nexport class CircuitBreaker {\n private state: CircuitState = \"closed\";\n private failures: number = 0;\n private successes: number = 0;\n private failureTimestamps: number[] = [];\n private lastFailure?: Date;\n private lastSuccess?: Date;\n private lastStateChange?: Date;\n private lastOpenedAt?: Date;\n private totalRequests: number = 0;\n private rejectedRequests: number = 0;\n private lastError?: Error;\n private readonly options: CircuitBreakerOptions;\n private readonly logger: ILogger;\n\n constructor(options: CircuitBreakerOptions) {\n this.options = {\n ...DEFAULT_CIRCUIT_BREAKER_OPTIONS,\n ...options,\n };\n this.logger = options.logger ?? new NoopLogger();\n }\n\n /**\n * Execute a function with circuit breaker protection\n */\n async execute<T>(fn: () => Promise<T>): Promise<T> {\n this.totalRequests++;\n\n // Check if circuit allows the request\n if (!this.canExecute()) {\n this.rejectedRequests++;\n this.options.onReject?.(this.state);\n\n throw new CircuitOpenError(\n this.options.name,\n this.state,\n this.getRemainingTimeout(),\n );\n }\n\n try {\n const result = await fn();\n this.onSuccess();\n return result;\n } catch (error) {\n this.onFailure(error instanceof Error ? error : new Error(String(error)));\n throw error;\n }\n }\n\n /**\n * Check if circuit allows execution\n */\n canExecute(): boolean {\n switch (this.state) {\n case \"closed\":\n return true;\n\n case \"open\":\n // Check if reset timeout has passed\n if (this.shouldAttemptReset()) {\n this.transitionTo(\"half-open\");\n return true;\n }\n return false;\n\n case \"half-open\":\n // Allow limited requests in half-open state\n return true;\n\n default:\n return false;\n }\n }\n\n /**\n * Record a successful execution\n */\n private onSuccess(): void {\n this.lastSuccess = new Date();\n this.successes++;\n\n switch (this.state) {\n case \"half-open\":\n // Check if we've had enough successes to close\n if (this.successes >= this.options.successThreshold) {\n this.transitionTo(\"closed\");\n }\n break;\n\n case \"closed\":\n // Reset failure count on success\n this.failures = 0;\n this.failureTimestamps = [];\n break;\n }\n }\n\n /**\n * Record a failed execution\n */\n private onFailure(error: Error): void {\n // Check if this error should trip the circuit\n if (this.options.shouldTrip && !this.options.shouldTrip(error)) {\n return;\n }\n\n this.lastError = error;\n this.lastFailure = new Date();\n this.failures++;\n\n const now = Date.now();\n this.failureTimestamps.push(now);\n\n // Remove old failures outside the window\n const windowStart = now - this.options.failureWindow;\n this.failureTimestamps = this.failureTimestamps.filter(\n (ts) => ts > windowStart,\n );\n\n switch (this.state) {\n case \"closed\":\n // Check if we've hit the failure threshold\n if (this.failureTimestamps.length >= this.options.failureThreshold) {\n this.transitionTo(\"open\");\n this.options.onOpen?.(this.failures, error);\n }\n break;\n\n case \"half-open\":\n // Any failure in half-open state reopens the circuit\n this.transitionTo(\"open\");\n this.options.onOpen?.(this.failures, error);\n break;\n }\n }\n\n /**\n * Transition to a new state\n */\n private transitionTo(newState: CircuitState): void {\n const oldState = this.state;\n\n if (oldState === newState) return;\n\n this.state = newState;\n this.lastStateChange = new Date();\n\n this.logger.info(`Circuit \"${this.options.name}\" state change`, {\n from: oldState,\n to: newState,\n failures: this.failures,\n successes: this.successes,\n });\n\n this.options.onStateChange?.(oldState, newState);\n\n switch (newState) {\n case \"open\":\n this.lastOpenedAt = new Date();\n this.successes = 0;\n break;\n\n case \"half-open\":\n this.successes = 0;\n break;\n\n case \"closed\":\n this.failures = 0;\n this.failureTimestamps = [];\n this.successes = 0;\n this.options.onClose?.();\n break;\n }\n }\n\n /**\n * Check if reset timeout has passed\n */\n private shouldAttemptReset(): boolean {\n if (!this.lastOpenedAt) return true;\n\n const elapsed = Date.now() - this.lastOpenedAt.getTime();\n return elapsed >= this.options.resetTimeout;\n }\n\n /**\n * Get remaining time until reset attempt\n */\n private getRemainingTimeout(): number {\n if (!this.lastOpenedAt) return 0;\n\n const elapsed = Date.now() - this.lastOpenedAt.getTime();\n return Math.max(0, this.options.resetTimeout - elapsed);\n }\n\n /**\n * Get current circuit state\n */\n getState(): CircuitState {\n return this.state;\n }\n\n /**\n * Get circuit breaker statistics\n */\n getStats(): CircuitBreakerStats {\n return {\n state: this.state,\n failures: this.failures,\n successes: this.successes,\n lastFailure: this.lastFailure,\n lastSuccess: this.lastSuccess,\n lastStateChange: this.lastStateChange,\n totalRequests: this.totalRequests,\n rejectedRequests: this.rejectedRequests,\n };\n }\n\n /**\n * Manually reset the circuit to closed state\n */\n reset(): void {\n this.transitionTo(\"closed\");\n }\n\n /**\n * Manually trip the circuit to open state\n */\n trip(): void {\n this.transitionTo(\"open\");\n }\n\n /**\n * Check if circuit is open\n */\n isOpen(): boolean {\n return this.state === \"open\";\n }\n\n /**\n * Check if circuit is closed\n */\n isClosed(): boolean {\n return this.state === \"closed\";\n }\n\n /**\n * Check if circuit is half-open\n */\n isHalfOpen(): boolean {\n return this.state === \"half-open\";\n }\n}\n\n/**\n * Create a circuit breaker\n */\nexport function createCircuitBreaker(\n options: CircuitBreakerOptions,\n): CircuitBreaker {\n return new CircuitBreaker(options);\n}\n\n/**\n * Circuit breaker registry for managing multiple circuits\n */\nexport class CircuitBreakerRegistry {\n private circuits: Map<string, CircuitBreaker> = new Map();\n private readonly logger: ILogger;\n private readonly defaultOptions: Partial<CircuitBreakerOptions>;\n\n constructor(\n options: {\n logger?: ILogger;\n defaults?: Partial<CircuitBreakerOptions>;\n } = {},\n ) {\n this.logger = options.logger ?? new NoopLogger();\n this.defaultOptions = options.defaults ?? {};\n }\n\n /**\n * Get or create a circuit breaker\n */\n get(name: string, options?: Partial<CircuitBreakerOptions>): CircuitBreaker {\n let circuit = this.circuits.get(name);\n\n if (!circuit) {\n circuit = new CircuitBreaker({\n ...DEFAULT_CIRCUIT_BREAKER_OPTIONS,\n ...this.defaultOptions,\n ...options,\n name,\n logger: options?.logger ?? this.logger,\n });\n this.circuits.set(name, circuit);\n }\n\n return circuit;\n }\n\n /**\n * Execute with a named circuit breaker\n */\n async execute<T>(\n name: string,\n fn: () => Promise<T>,\n options?: Partial<CircuitBreakerOptions>,\n ): Promise<T> {\n const circuit = this.get(name, options);\n return circuit.execute(fn);\n }\n\n /**\n * Get all circuit statistics\n */\n getAllStats(): Record<string, CircuitBreakerStats> {\n const stats: Record<string, CircuitBreakerStats> = {};\n\n for (const [name, circuit] of this.circuits) {\n stats[name] = circuit.getStats();\n }\n\n return stats;\n }\n\n /**\n * Reset all circuits\n */\n resetAll(): void {\n for (const circuit of this.circuits.values()) {\n circuit.reset();\n }\n }\n\n /**\n * Clear all circuits\n */\n clear(): void {\n this.circuits.clear();\n }\n}\n","/**\n * Resilient Email Transport Wrapper\n *\n * Wraps any `IEmail` adapter with retry + optional circuit-breaker +\n * optional timeout. Solves the \"Resend is briefly flaky / rate-limited /\n * the network blipped\" class of failure without each app re-implementing\n * the same wrapping logic.\n *\n * Defaults are conservative:\n * - retry: 3 attempts, 200ms base delay, exponential backoff with jitter\n * - circuit breaker: disabled (opt-in)\n * - timeout: disabled (opt-in)\n *\n * Wraps both `send` and `sendBatch` — `healthCheck` is NOT wrapped\n * because retry-on-health-check would mask the very thing it probes.\n *\n * @example wrap the existing ResendEmail adapter\n * ```typescript\n * import { Resend } from \"resend\";\n * import { ResendEmail } from \"@digilogiclabs/platform-core\";\n * import { createResilientEmail } from \"@digilogiclabs/platform-core/email-templates\";\n *\n * const inner = new ResendEmail(new Resend(apiKey), \"noreply@app.com\");\n * const email = createResilientEmail(inner, {\n * retry: { maxAttempts: 3 },\n * circuitBreaker: { failureThreshold: 5, openDurationMs: 30_000 },\n * timeoutMs: 5_000,\n * });\n *\n * await email.send({ to: { email: \"user@example.com\" }, subject, html });\n * ```\n *\n * Works with any IEmail adapter — Resend, SMTP, Console — not just Resend.\n * The factory name historically referenced Resend because that was the\n * first consumer; the implementation is adapter-agnostic.\n */\nimport type { IEmail, EmailMessage, EmailResult } from \"../interfaces/IEmail\";\nimport { withRetry } from \"../resilience/retry\";\nimport { CircuitBreaker } from \"../resilience/circuit-breaker\";\nimport type { CircuitBreakerOptions } from \"../resilience/circuit-breaker\";\nimport type { RetryOptions } from \"../resilience/retry\";\n\nexport interface ResilientEmailOptions {\n /**\n * Retry config. Pass `false` to disable. Defaults to `{ maxAttempts: 3 }`\n * (with the platform's standard exponential backoff + jitter).\n */\n retry?: Partial<RetryOptions> | false;\n /**\n * Circuit breaker config. Omit or pass `false` to disable.\n * When enabled, the breaker wraps the retry loop so an open circuit\n * fails fast without exhausting retries.\n */\n circuitBreaker?: CircuitBreakerOptions | false;\n /**\n * Timeout in milliseconds for a single send attempt. Omit to disable.\n * Applied per-attempt, not per-call — a request that times out is\n * still subject to retries.\n */\n timeoutMs?: number;\n}\n\nconst DEFAULT_RETRY: Partial<RetryOptions> = {\n maxAttempts: 3,\n};\n\nfunction withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {\n return new Promise<T>((resolve, reject) => {\n const timer = setTimeout(\n () => reject(new Error(`email send timed out after ${ms}ms`)),\n ms,\n );\n promise.then(\n (v) => {\n clearTimeout(timer);\n resolve(v);\n },\n (e) => {\n clearTimeout(timer);\n reject(e);\n },\n );\n });\n}\n\n/**\n * Wrap an `IEmail` adapter with retry, optional circuit breaker, and\n * optional timeout. Returns a new `IEmail` — the inner adapter is not\n * mutated.\n */\nexport function createResilientEmail(\n inner: IEmail,\n options: ResilientEmailOptions = {},\n): IEmail {\n const retryOpts =\n options.retry === false\n ? null\n : { ...DEFAULT_RETRY, ...(options.retry ?? {}) };\n const breaker = options.circuitBreaker\n ? new CircuitBreaker(options.circuitBreaker)\n : null;\n const timeoutMs = options.timeoutMs;\n\n const wrapAttempt = async <T>(fn: () => Promise<T>): Promise<T> => {\n if (timeoutMs !== undefined) {\n return withTimeout(fn(), timeoutMs);\n }\n return fn();\n };\n\n const withResilience = async <T>(fn: () => Promise<T>): Promise<T> => {\n const exec = async () => {\n if (retryOpts) {\n return withRetry(() => wrapAttempt(fn), retryOpts);\n }\n return wrapAttempt(fn);\n };\n if (breaker) {\n return breaker.execute(exec);\n }\n return exec();\n };\n\n return {\n async send(message: EmailMessage): Promise<EmailResult> {\n return withResilience(() => inner.send(message));\n },\n async sendBatch(messages: EmailMessage[]): Promise<EmailResult[]> {\n return withResilience(() => inner.sendBatch(messages));\n },\n async healthCheck(): Promise<boolean> {\n // Intentionally unwrapped — retry would mask the probe.\n return inner.healthCheck();\n },\n };\n}\n"],"mappings":"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","names":["crypto"]}
|