@authup/server-core 1.0.0-beta.45 → 1.0.0-beta.47

package/dist/core/mail/format/blocks.mjs

@@ -0,0 +1,47 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/core/mail/format/blocks.ts
+function paragraph(text) {
+	return {
+		type: "paragraph",
+		text
+	};
+}
+function code(label, value) {
+	return {
+		type: "code",
+		label,
+		value
+	};
+}
+function action(label, url) {
+	return {
+		type: "action",
+		label,
+		url
+	};
+}
+function note(text) {
+	return {
+		type: "note",
+		text
+	};
+}
+/**
+* Only http(s) URLs may become call-to-action links. Action URLs are built
+* from `publicUrl` config today, so this is defense in depth against a
+* future caller passing an attacker-influenced value (e.g. `javascript:`).
+*/ function isSafeActionURL(input) {
+	let parsed;
+	try {
+		parsed = new URL(input);
+	} catch {
+		return false;
+	}
+	return parsed.protocol === "http:" || parsed.protocol === "https:";
+}
+//#endregion
+export { action, code, isSafeActionURL, note, paragraph };
+
+//# sourceMappingURL=blocks.mjs.map

package/dist/core/mail/format/blocks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.mjs","names":["paragraph","text","type","code","label","value","action","url","note","isSafeActionURL","input","parsed","URL","protocol"],"sources":["../../../../src/core/mail/format/blocks.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type {\n    MailActionBlock,\n    MailCodeBlock,\n    MailNoteBlock,\n    MailParagraphBlock,\n} from './types.ts';\n\nexport function paragraph(text: string): MailParagraphBlock {\n    return { type: 'paragraph', text };\n}\n\nexport function code(label: string, value: string): MailCodeBlock {\n    return {\n        type: 'code', \n        label, \n        value, \n    };\n}\n\nexport function action(label: string, url: string): MailActionBlock {\n    return {\n        type: 'action', \n        label, \n        url, \n    };\n}\n\nexport function note(text: string): MailNoteBlock {\n    return { type: 'note', text };\n}\n\n/**\n * Only http(s) URLs may become call-to-action links. Action URLs are built\n * from `publicUrl` config today, so this is defense in depth against a\n * future caller passing an attacker-influenced value (e.g. `javascript:`).\n */\nexport function isSafeActionURL(input: string): boolean {\n    let parsed: URL;\n\n    try {\n        parsed = new URL(input);\n    } catch {\n        return false;\n    }\n\n    return parsed.protocol === 'http:' || parsed.protocol === 'https:';\n}\n"],"mappings":";;;;AAcA,SAAgBA,UAAUC,MAAY;CAClC,OAAO;EAAEC,MAAM;EAAaD;CAAK;AACrC;AAEA,SAAgBE,KAAKC,OAAeC,OAAa;CAC7C,OAAO;EACHH,MAAM;EACNE;EACAC;CACJ;AACJ;AAEA,SAAgBC,OAAOF,OAAeG,KAAW;CAC7C,OAAO;EACHL,MAAM;EACNE;EACAG;CACJ;AACJ;AAEA,SAAgBC,KAAKP,MAAY;CAC7B,OAAO;EAAEC,MAAM;EAAQD;CAAK;AAChC;;;;;GAOA,SAAgBQ,gBAAgBC,OAAa;CACzC,IAAIC;CAEJ,IAAI;EACAA,SAAS,IAAIC,IAAIF,KAAAA;CACrB,QAAQ;EACJ,OAAO;CACX;CAEA,OAAOC,OAAOE,aAAa,WAAWF,OAAOE,aAAa;AAC9D"}

package/dist/core/mail/format/html.d.ts

@@ -0,0 +1,9 @@
+import type { MailDocument } from './types.ts';
+export declare function escapeHtml(input: string): string;
+/**
+ * Wrap the block list in a small branded HTML shell. Inline styles only —
+ * mail clients strip <style>/external CSS. The preheader is rendered
+ * invisible but picked up by clients as the preview line.
+ */
+export declare function renderHtmlDocument(document: MailDocument): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/core/mail/format/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../../src/core/mail/format/html.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD;AAyBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAgBjE"}

package/dist/core/mail/format/html.mjs

@@ -0,0 +1,41 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/core/mail/format/html.ts
+function escapeHtml(input) {
+	return input.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function renderBlock(block) {
+	switch (block.type) {
+		case "paragraph": return `<p style="margin:0 0 16px;">${escapeHtml(block.text)}</p>`;
+		case "code": return `<p style="margin:0 0 4px;font-size:13px;color:#9aa0aa;">${escapeHtml(block.label)}</p>
+        <p style="margin:0 0 16px;font-family:monospace;font-size:16px;letter-spacing:0.04em;word-break:break-all;background:#f4f4f6;border-radius:8px;padding:12px 14px;">${escapeHtml(block.value)}</p>`;
+		case "action": return `<p style="margin:24px 0 16px;">
+            <a href="${escapeHtml(block.url)}" style="display:inline-block;padding:10px 18px;border-radius:8px;background:#6d7fcc;color:#ffffff;text-decoration:none;font-weight:600;">${escapeHtml(block.label)}</a>
+        </p>`;
+		case "note": return `<p style="margin:0 0 8px;font-size:13px;color:#9aa0aa;">${escapeHtml(block.text)}</p>`;
+		default: return "";
+	}
+}
+/**
+* Wrap the block list in a small branded HTML shell. Inline styles only —
+* mail clients strip <style>/external CSS. The preheader is rendered
+* invisible but picked up by clients as the preview line.
+*/ function renderHtmlDocument(document) {
+	const preheader = document.preview ? `<div style="display:none;max-height:0;overflow:hidden;mso-hide:all;">${escapeHtml(document.preview)}</div>` : "";
+	return `<!doctype html>
+<html lang="${escapeHtml(document.lang || "en")}">
+<body style="margin:0;padding:24px;background:#f4f4f6;font-family:Nunito,Segoe UI,Arial,sans-serif;color:#26272c;">
+    ${preheader}
+    <div style="max-width:480px;margin:0 auto;background:#ffffff;border-radius:12px;padding:28px;">
+        <div style="font-family:Asap,Arial,sans-serif;font-weight:700;font-size:20px;color:#6d7fcc;margin-bottom:16px;">Authup</div>
+        ${document.blocks.map((block) => renderBlock(block)).join("\n        ")}
+    </div>
+    <div style="max-width:480px;margin:12px auto 0;text-align:center;font-size:12px;color:#9aa0aa;">Made with &#128154;</div>
+</body>
+</html>`;
+}
+//#endregion
+export { escapeHtml, renderHtmlDocument };
+
+//# sourceMappingURL=html.mjs.map

package/dist/core/mail/format/html.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.mjs","names":["escapeHtml","input","replace","renderBlock","block","type","text","label","value","url","renderHtmlDocument","document","preheader","preview","lang","blocks","map","join"],"sources":["../../../../src/core/mail/format/html.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { MailBlock, MailDocument } from './types.ts';\n\nexport function escapeHtml(input: string): string {\n    return input\n        .replace(/&/g, '&amp;')\n        .replace(/</g, '&lt;')\n        .replace(/>/g, '&gt;')\n        .replace(/\"/g, '&quot;')\n        .replace(/'/g, '&#39;');\n}\n\nfunction renderBlock(block: MailBlock): string {\n    switch (block.type) {\n        case 'paragraph': {\n            return `<p style=\"margin:0 0 16px;\">${escapeHtml(block.text)}</p>`;\n        }\n        case 'code': {\n            return `<p style=\"margin:0 0 4px;font-size:13px;color:#9aa0aa;\">${escapeHtml(block.label)}</p>\n        <p style=\"margin:0 0 16px;font-family:monospace;font-size:16px;letter-spacing:0.04em;word-break:break-all;background:#f4f4f6;border-radius:8px;padding:12px 14px;\">${escapeHtml(block.value)}</p>`;\n        }\n        case 'action': {\n            return `<p style=\"margin:24px 0 16px;\">\n            <a href=\"${escapeHtml(block.url)}\" style=\"display:inline-block;padding:10px 18px;border-radius:8px;background:#6d7fcc;color:#ffffff;text-decoration:none;font-weight:600;\">${escapeHtml(block.label)}</a>\n        </p>`;\n        }\n        case 'note': {\n            return `<p style=\"margin:0 0 8px;font-size:13px;color:#9aa0aa;\">${escapeHtml(block.text)}</p>`;\n        }\n        default: {\n            return '';\n        }\n    }\n}\n\n/**\n * Wrap the block list in a small branded HTML shell. Inline styles only —\n * mail clients strip <style>/external CSS. The preheader is rendered\n * invisible but picked up by clients as the preview line.\n */\nexport function renderHtmlDocument(document: MailDocument): string {\n    const preheader = document.preview ?\n        `<div style=\"display:none;max-height:0;overflow:hidden;mso-hide:all;\">${escapeHtml(document.preview)}</div>` :\n        '';\n\n    return `<!doctype html>\n<html lang=\"${escapeHtml(document.lang || 'en')}\">\n<body style=\"margin:0;padding:24px;background:#f4f4f6;font-family:Nunito,Segoe UI,Arial,sans-serif;color:#26272c;\">\n    ${preheader}\n    <div style=\"max-width:480px;margin:0 auto;background:#ffffff;border-radius:12px;padding:28px;\">\n        <div style=\"font-family:Asap,Arial,sans-serif;font-weight:700;font-size:20px;color:#6d7fcc;margin-bottom:16px;\">Authup</div>\n        ${document.blocks.map((block) => renderBlock(block)).join('\\n        ')}\n    </div>\n    <div style=\"max-width:480px;margin:12px auto 0;text-align:center;font-size:12px;color:#9aa0aa;\">Made with &#128154;</div>\n</body>\n</html>`;\n}\n"],"mappings":";;;;AASA,SAAgBA,WAAWC,OAAa;CACpC,OAAOA,MACFC,QAAQ,MAAM,OAAA,CAAA,CACdA,QAAQ,MAAM,MAAA,CAAA,CACdA,QAAQ,MAAM,MAAA,CAAA,CACdA,QAAQ,MAAM,QAAA,CAAA,CACdA,QAAQ,MAAM,OAAA;AACvB;AAEA,SAASC,YAAYC,OAAgB;CACjC,QAAQA,MAAMC,MAAd;EACI,KAAK,aACD,OAAO,+BAA+BL,WAAWI,MAAME,IAAI,EAAE;EAEjE,KAAK,QACD,OAAO,2DAA2DN,WAAWI,MAAMG,KAAK,EAAE;6KACuEP,WAAWI,MAAMI,KAAK,EAAE;EAE7L,KAAK,UACD,OAAO;uBACIR,WAAWI,MAAMK,GAAG,EAAE,4IAA4IT,WAAWI,MAAMG,KAAK,EAAE;;EAGzM,KAAK,QACD,OAAO,2DAA2DP,WAAWI,MAAME,IAAI,EAAE;EAE7F,SACI,OAAO;CAEf;AACJ;;;;;GAOA,SAAgBI,mBAAmBC,UAAsB;CACrD,MAAMC,YAAYD,SAASE,UACvB,wEAAwEb,WAAWW,SAASE,OAAO,EAAE,UACrG;CAEJ,OAAO;cACGb,WAAWW,SAASG,QAAQ,IAAA,EAAM;;MAE1CF,UAAU;;;UAGND,SAASI,OAAOC,KAAKZ,UAAUD,YAAYC,KAAAA,CAAAA,CAAAA,CAAQa,KAAK,YAAA,EAAc;;;;;AAKhF"}

package/dist/core/mail/format/index.d.ts

@@ -0,0 +1,5 @@
+export * from './blocks.ts';
+export * from './html.ts';
+export * from './text.ts';
+export * from './types.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/mail/format/index.ts"],"names":[],"mappings":"AAOA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/core/mail/format/index.mjs

@@ -0,0 +1,7 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { action, code, isSafeActionURL, note, paragraph } from "./blocks.mjs";
+import { escapeHtml, renderHtmlDocument } from "./html.mjs";
+import { renderTextDocument } from "./text.mjs";
+export { action, code, escapeHtml, isSafeActionURL, note, paragraph, renderHtmlDocument, renderTextDocument };

package/dist/core/mail/format/text.d.ts

@@ -0,0 +1,3 @@
+import type { MailDocument } from './types.ts';
+export declare function renderTextDocument(document: MailDocument): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/core/mail/format/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/core/mail/format/text.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,YAAY,CAAC;AAsB1D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAKjE"}

package/dist/core/mail/format/text.mjs

@@ -0,0 +1,20 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/core/mail/format/text.ts
+function renderBlock(block) {
+	switch (block.type) {
+		case "paragraph": return block.text;
+		case "code": return `${block.label}: ${block.value}`;
+		case "action": return `${block.label}: ${block.url}`;
+		case "note": return block.text;
+		default: return "";
+	}
+}
+function renderTextDocument(document) {
+	return document.blocks.map((block) => renderBlock(block)).filter((line) => line.length > 0).join("\n\n");
+}
+//#endregion
+export { renderTextDocument };
+
+//# sourceMappingURL=text.mjs.map

package/dist/core/mail/format/text.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.mjs","names":["renderBlock","block","type","text","label","value","url","renderTextDocument","document","blocks","map","filter","line","length","join"],"sources":["../../../../src/core/mail/format/text.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { MailBlock, MailDocument } from './types.ts';\n\nfunction renderBlock(block: MailBlock): string {\n    switch (block.type) {\n        case 'paragraph': {\n            return block.text;\n        }\n        case 'code': {\n            return `${block.label}: ${block.value}`;\n        }\n        case 'action': {\n            return `${block.label}: ${block.url}`;\n        }\n        case 'note': {\n            return block.text;\n        }\n        default: {\n            return '';\n        }\n    }\n}\n\nexport function renderTextDocument(document: MailDocument): string {\n    return document.blocks\n        .map((block) => renderBlock(block))\n        .filter((line) => line.length > 0)\n        .join('\\n\\n');\n}\n"],"mappings":";;;;AASA,SAASA,YAAYC,OAAgB;CACjC,QAAQA,MAAMC,MAAd;EACI,KAAK,aACD,OAAOD,MAAME;EAEjB,KAAK,QACD,OAAO,GAAGF,MAAMG,MAAM,IAAIH,MAAMI;EAEpC,KAAK,UACD,OAAO,GAAGJ,MAAMG,MAAM,IAAIH,MAAMK;EAEpC,KAAK,QACD,OAAOL,MAAME;EAEjB,SACI,OAAO;CAEf;AACJ;AAEA,SAAgBI,mBAAmBC,UAAsB;CACrD,OAAOA,SAASC,OACXC,KAAKT,UAAUD,YAAYC,KAAAA,CAAAA,CAAAA,CAC3BU,QAAQC,SAASA,KAAKC,SAAS,CAAA,CAAA,CAC/BC,KAAK,MAAA;AACd"}

package/dist/core/mail/format/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Structural building blocks of a mail body. Templates compose blocks;
+ * the html/text formatters turn the same block list into both mail parts,
+ * so the two representations cannot drift apart.
+ */
+export type MailParagraphBlock = {
+    type: 'paragraph';
+    text: string;
+};
+export type MailCodeBlock = {
+    type: 'code';
+    label: string;
+    value: string;
+};
+export type MailActionBlock = {
+    type: 'action';
+    label: string;
+    url: string;
+};
+export type MailNoteBlock = {
+    type: 'note';
+    text: string;
+};
+export type MailBlock = MailParagraphBlock | MailCodeBlock | MailActionBlock | MailNoteBlock;
+export type MailDocument = {
+    lang?: string;
+    preview?: string;
+    blocks: MailBlock[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/mail/format/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/mail/format/types.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,kBAAkB,GAC1C,aAAa,GACb,eAAe,GACf,aAAa,CAAC;AAEd,MAAM,MAAM,YAAY,GAAG;IAEvB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,EAAE,CAAC;CACvB,CAAC"}

package/dist/core/mail/format/types.mjs

@@ -0,0 +1,4 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+export {};

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

@@ -1,2 +1,5 @@
+export * from './format/types.ts';
+export * from './renderer.ts';
+export * from './template/index.ts';
 export * from './types.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/mail/index.ts"],"names":[],"mappings":"AAOA,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/mail/index.ts"],"names":[],"mappings":"AAOA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC"}

package/dist/core/mail/index.mjs

@@ -1,4 +1,9 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-export {};
+import { defineMailTemplate } from "./template/define.mjs";
+import { MailTemplateName } from "./template/types.mjs";
+import { MAIL_TEMPLATE_REGISTRY } from "./template/registry.mjs";
+import { MailTemplateRenderer } from "./renderer.mjs";
+import "./template/index.mjs";
+export { MAIL_TEMPLATE_REGISTRY, MailTemplateName, MailTemplateRenderer, defineMailTemplate };

package/dist/core/mail/renderer.d.ts

@@ -0,0 +1,10 @@
+import { Ilingo } from 'ilingo';
+import type { MailTemplateName } from './template/types.ts';
+import type { IMailTemplateRenderer, MailContent, MailRenderInput } from './types.ts';
+export declare class MailTemplateRenderer implements IMailTemplateRenderer {
+    protected ilingo: Ilingo;
+    constructor();
+    render<N extends MailTemplateName>(input: MailRenderInput<N>): Promise<MailContent>;
+    protected translate(locale: string, key: string, data?: Record<string, any>): Promise<string>;
+}
+//# sourceMappingURL=renderer.d.ts.map

package/dist/core/mail/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/core/mail/renderer.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,MAAM,EAAe,MAAM,QAAQ,CAAC;AAM7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EACR,qBAAqB,EACrB,WAAW,EACX,eAAe,EAClB,MAAM,YAAY,CAAC;AAEpB,qBAAa,oBAAqB,YAAW,qBAAqB;IAC9D,SAAS,CAAC,MAAM,EAAG,MAAM,CAAC;;IASpB,MAAM,CAAC,CAAC,SAAS,gBAAgB,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;cA6BzE,SAAS,CACrB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,OAAO,CAAC,MAAM,CAAC;CAcrB"}

package/dist/core/mail/renderer.mjs

@@ -0,0 +1,49 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { isSafeActionURL } from "./format/blocks.mjs";
+import { renderHtmlDocument } from "./format/html.mjs";
+import { renderTextDocument } from "./format/text.mjs";
+import { MAIL_TEMPLATE_REGISTRY } from "./template/registry.mjs";
+import { InternalError } from "@authup/errors";
+import { CATALOGS, DEFAULT_LOCALE, TranslatorTranslationNamespace, matchLocale } from "@authup/i18n";
+import { Ilingo, MemoryStore } from "ilingo";
+//#region src/core/mail/renderer.ts
+var MailTemplateRenderer = class {
+	ilingo;
+	constructor() {
+		this.ilingo = new Ilingo({
+			store: new MemoryStore({ data: CATALOGS }),
+			locale: DEFAULT_LOCALE
+		});
+	}
+	async render(input) {
+		const template = MAIL_TEMPLATE_REGISTRY[input.template];
+		const locale = matchLocale(input.locale) ?? DEFAULT_LOCALE;
+		const output = await template.build(input.params, (key, data) => this.translate(locale, key, data));
+		const document = {
+			lang: locale,
+			preview: output.preview,
+			blocks: output.blocks.filter((block) => block.type !== "action" || isSafeActionURL(block.url))
+		};
+		return {
+			subject: output.subject,
+			html: renderHtmlDocument(document),
+			text: renderTextDocument(document)
+		};
+	}
+	async translate(locale, key, data) {
+		const value = await this.ilingo.get({
+			namespace: TranslatorTranslationNamespace.MAIL,
+			key,
+			locale,
+			data
+		});
+		if (typeof value === "undefined") throw new InternalError(`The mail translation "${key}" (locale: ${locale}) could not be resolved.`);
+		return value;
+	}
+};
+//#endregion
+export { MailTemplateRenderer };
+
+//# sourceMappingURL=renderer.mjs.map

package/dist/core/mail/renderer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.mjs","names":["InternalError","CATALOGS","DEFAULT_LOCALE","TranslatorTranslationNamespace","matchLocale","Ilingo","MemoryStore","isSafeActionURL","renderHtmlDocument","renderTextDocument","MAIL_TEMPLATE_REGISTRY","MailTemplateRenderer","ilingo","store","data","locale","render","input","template","output","build","params","key","translate","document","lang","preview","blocks","filter","block","type","url","subject","html","text","value","get","namespace","MAIL"],"sources":["../../../src/core/mail/renderer.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { InternalError } from '@authup/errors';\nimport {\n    CATALOGS,\n    DEFAULT_LOCALE,\n    TranslatorTranslationNamespace,\n    matchLocale,\n} from '@authup/i18n';\nimport { Ilingo, MemoryStore } from 'ilingo';\nimport { isSafeActionURL } from './format/blocks.ts';\nimport { renderHtmlDocument } from './format/html.ts';\nimport { renderTextDocument } from './format/text.ts';\nimport type { MailDocument } from './format/types.ts';\nimport { MAIL_TEMPLATE_REGISTRY } from './template/registry.ts';\nimport type { MailTemplateName } from './template/types.ts';\nimport type {\n    IMailTemplateRenderer,\n    MailContent,\n    MailRenderInput,\n} from './types.ts';\n\nexport class MailTemplateRenderer implements IMailTemplateRenderer {\n    protected ilingo : Ilingo;\n\n    constructor() {\n        this.ilingo = new Ilingo({\n            store: new MemoryStore({ data: CATALOGS }),\n            locale: DEFAULT_LOCALE,\n        });\n    }\n\n    async render<N extends MailTemplateName>(input: MailRenderInput<N>): Promise<MailContent> {\n        const template = MAIL_TEMPLATE_REGISTRY[input.template];\n\n        // Narrow the requested BCP-47 tag onto an authored catalog locale\n        // up front, so the copy and the rendered `<html lang>` agree.\n        const locale = matchLocale(input.locale) ?? DEFAULT_LOCALE;\n\n        const output = await template.build(\n            input.params,\n            (key, data) => this.translate(locale, key, data),\n        );\n\n        const document : MailDocument = {\n            lang: locale,\n            preview: output.preview,\n            // Central guard: a call-to-action never renders with a non-http(s)\n            // URL, regardless of what an individual template composed.\n            blocks: output.blocks.filter(\n                (block) => block.type !== 'action' || isSafeActionURL(block.url),\n            ),\n        };\n\n        return {\n            subject: output.subject,\n            html: renderHtmlDocument(document),\n            text: renderTextDocument(document),\n        };\n    }\n\n    protected async translate(\n        locale: string,\n        key: string,\n        data?: Record<string, any>,\n    ): Promise<string> {\n        const value = await this.ilingo.get({\n            namespace: TranslatorTranslationNamespace.MAIL,\n            key,\n            locale,\n            data,\n        });\n\n        if (typeof value === 'undefined') {\n            throw new InternalError(`The mail translation \"${key}\" (locale: ${locale}) could not be resolved.`);\n        }\n\n        return value;\n    }\n}\n"],"mappings":";;;;;;;;;;;AA2BA,IAAaW,uBAAb,MAAaA;CACCC;CAEV,cAAc;EACV,KAAKA,SAAS,IAAIP,OAAO;GACrBQ,OAAO,IAAIP,YAAY,EAAEQ,MAAMb,SAAS,CAAA;GACxCc,QAAQb;EACZ,CAAA;CACJ;CAEA,MAAMc,OAAmCC,OAAiD;EACtF,MAAMC,WAAWR,uBAAuBO,MAAMC;EAI9C,MAAMH,SAASX,YAAYa,MAAMF,MAAM,KAAKb;EAE5C,MAAMiB,SAAS,MAAMD,SAASE,MAC1BH,MAAMI,SACLC,KAAKR,SAAS,KAAKS,UAAUR,QAAQO,KAAKR,IAAAA,CAAAA;EAG/C,MAAMU,WAA0B;GAC5BC,MAAMV;GACNW,SAASP,OAAOO;GAGhBC,QAAQR,OAAOQ,OAAOC,QACjBC,UAAUA,MAAMC,SAAS,YAAYvB,gBAAgBsB,MAAME,GAAG,CAAA;EAEvE;EAEA,OAAO;GACHC,SAASb,OAAOa;GAChBC,MAAMzB,mBAAmBgB,QAAAA;GACzBU,MAAMzB,mBAAmBe,QAAAA;EAC7B;CACJ;CAEA,MAAgBD,UACZR,QACAO,KACAR,MACe;EACf,MAAMqB,QAAQ,MAAM,KAAKvB,OAAOwB,IAAI;GAChCC,WAAWlC,+BAA+BmC;GAC1ChB;GACAP;GACAD;EACJ,CAAA;EAEA,IAAI,OAAOqB,UAAU,aACjB,MAAM,IAAInC,cAAc,yBAAyBsB,IAAI,aAAaP,OAAO,yBAAyB;EAGtG,OAAOoB;CACX;AACJ"}

package/dist/core/mail/template/define.d.ts

@@ -0,0 +1,7 @@
+import type { MailTemplate, MailTemplateName } from './types.ts';
+/**
+ * Identity helper that pins down the per-template params (via `name`) so
+ * `build` is fully typed at the call site.
+ */
+export declare function defineMailTemplate<N extends MailTemplateName>(template: MailTemplate<N>): MailTemplate<N>;
+//# sourceMappingURL=define.d.ts.map

package/dist/core/mail/template/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../../src/core/mail/template/define.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,gBAAgB,EACzD,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAC1B,YAAY,CAAC,CAAC,CAAC,CAEjB"}

package/dist/core/mail/template/define.mjs

@@ -0,0 +1,14 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/core/mail/template/define.ts
+/**
+* Identity helper that pins down the per-template params (via `name`) so
+* `build` is fully typed at the call site.
+*/ function defineMailTemplate(template) {
+	return template;
+}
+//#endregion
+export { defineMailTemplate };
+
+//# sourceMappingURL=define.mjs.map

package/dist/core/mail/template/define.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.mjs","names":["defineMailTemplate","template"],"sources":["../../../../src/core/mail/template/define.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { MailTemplate, MailTemplateName } from './types.ts';\n\n/**\n * Identity helper that pins down the per-template params (via `name`) so\n * `build` is fully typed at the call site.\n */\nexport function defineMailTemplate<N extends MailTemplateName>(\n    template: MailTemplate<N>,\n): MailTemplate<N> {\n    return template;\n}\n"],"mappings":";;;;;;;GAaA,SAAgBA,mBACZC,UAAyB;CAEzB,OAAOA;AACX"}

package/dist/core/mail/template/index.d.ts

@@ -0,0 +1,4 @@
+export * from './define.ts';
+export * from './registry.ts';
+export * from './types.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/mail/template/index.ts"],"names":[],"mappings":"AAOA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/core/mail/template/index.mjs

@@ -0,0 +1,7 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { defineMailTemplate } from "./define.mjs";
+import { MailTemplateName } from "./types.mjs";
+import { MAIL_TEMPLATE_REGISTRY } from "./registry.mjs";
+export { MAIL_TEMPLATE_REGISTRY, MailTemplateName, defineMailTemplate };

package/dist/core/mail/template/registry.d.ts

@@ -0,0 +1,6 @@
+import type { MailTemplate } from './types.ts';
+import { MailTemplateName } from './types.ts';
+export declare const MAIL_TEMPLATE_REGISTRY: {
+    [N in MailTemplateName]: MailTemplate<N>;
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/mail/template/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/core/mail/template/registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,sBAAsB,EAAE;KAAG,CAAC,IAAI,gBAAgB,GAAG,YAAY,CAAC,CAAC,CAAC;CAG9E,CAAC"}

package/dist/core/mail/template/registry.mjs

@@ -0,0 +1,15 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { MailTemplateName } from "./types.mjs";
+import { passwordResetMailTemplate } from "./templates/password-reset.mjs";
+import { registrationActivationMailTemplate } from "./templates/registration-activation.mjs";
+//#region src/core/mail/template/registry.ts
+const MAIL_TEMPLATE_REGISTRY = {
+	[MailTemplateName.REGISTRATION_ACTIVATION]: registrationActivationMailTemplate,
+	[MailTemplateName.PASSWORD_RESET]: passwordResetMailTemplate
+};
+//#endregion
+export { MAIL_TEMPLATE_REGISTRY };
+
+//# sourceMappingURL=registry.mjs.map

package/dist/core/mail/template/registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.mjs","names":["passwordResetMailTemplate","registrationActivationMailTemplate","MailTemplateName","MAIL_TEMPLATE_REGISTRY","REGISTRATION_ACTIVATION","PASSWORD_RESET"],"sources":["../../../../src/core/mail/template/registry.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { passwordResetMailTemplate } from './templates/password-reset.ts';\nimport { registrationActivationMailTemplate } from './templates/registration-activation.ts';\nimport type { MailTemplate } from './types.ts';\nimport { MailTemplateName } from './types.ts';\n\nexport const MAIL_TEMPLATE_REGISTRY: { [N in MailTemplateName]: MailTemplate<N> } = {\n    [MailTemplateName.REGISTRATION_ACTIVATION]: registrationActivationMailTemplate,\n    [MailTemplateName.PASSWORD_RESET]: passwordResetMailTemplate,\n};\n"],"mappings":";;;;;;;AAYA,MAAaG,yBAAuE;EAC/ED,iBAAiBE,0BAA0BH;EAC3CC,iBAAiBG,iBAAiBL;AACvC"}

package/dist/core/mail/template/templates/password-reset.d.ts

@@ -0,0 +1,3 @@
+import { MailTemplateName } from '../types.ts';
+export declare const passwordResetMailTemplate: import("../types.ts").MailTemplate<MailTemplateName.PASSWORD_RESET>;
+//# sourceMappingURL=password-reset.d.ts.map

package/dist/core/mail/template/templates/password-reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"password-reset.d.ts","sourceRoot":"","sources":["../../../../../src/core/mail/template/templates/password-reset.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,yBAAyB,qEA2BpC,CAAC"}

package/dist/core/mail/template/templates/password-reset.mjs

@@ -0,0 +1,36 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { action, code, note, paragraph } from "../../format/blocks.mjs";
+import { defineMailTemplate } from "../define.mjs";
+import { MailTemplateName } from "../types.mjs";
+import { TranslatorTranslationMailKey } from "@authup/i18n";
+//#region src/core/mail/template/templates/password-reset.ts
+const passwordResetMailTemplate = defineMailTemplate({
+	name: MailTemplateName.PASSWORD_RESET,
+	build: async (params, t) => {
+		const [subject, intro, codeLabel, actionLabel, hint] = await Promise.all([
+			t(TranslatorTranslationMailKey.PASSWORD_RESET_SUBJECT),
+			t(TranslatorTranslationMailKey.PASSWORD_RESET_INTRO),
+			t(TranslatorTranslationMailKey.CODE),
+			t(TranslatorTranslationMailKey.PASSWORD_RESET_ACTION),
+			t(TranslatorTranslationMailKey.PASSWORD_RESET_HINT)
+		]);
+		const expiry = params.expiresInMinutes ? await t(TranslatorTranslationMailKey.PASSWORD_RESET_EXPIRY, { minutes: params.expiresInMinutes }) : void 0;
+		return {
+			subject,
+			preview: intro,
+			blocks: [
+				paragraph(intro),
+				code(codeLabel, params.code),
+				...params.url ? [action(actionLabel, params.url)] : [],
+				...expiry ? [note(expiry)] : [],
+				note(hint)
+			]
+		};
+	}
+});
+//#endregion
+export { passwordResetMailTemplate };
+
+//# sourceMappingURL=password-reset.mjs.map

package/dist/core/mail/template/templates/password-reset.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"password-reset.mjs","names":["TranslatorTranslationMailKey","action","code","note","paragraph","defineMailTemplate","MailTemplateName","passwordResetMailTemplate","name","PASSWORD_RESET","build","params","t","subject","intro","codeLabel","actionLabel","hint","Promise","all","PASSWORD_RESET_SUBJECT","PASSWORD_RESET_INTRO","CODE","PASSWORD_RESET_ACTION","PASSWORD_RESET_HINT","expiry","expiresInMinutes","PASSWORD_RESET_EXPIRY","minutes","undefined","preview","blocks","url"],"sources":["../../../../../src/core/mail/template/templates/password-reset.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { TranslatorTranslationMailKey } from '@authup/i18n';\nimport { \n    action, \n    code, \n    note, \n    paragraph, \n} from '../../format/blocks.ts';\nimport { defineMailTemplate } from '../define.ts';\nimport { MailTemplateName } from '../types.ts';\n\nexport const passwordResetMailTemplate = defineMailTemplate({\n    name: MailTemplateName.PASSWORD_RESET,\n    build: async (params, t) => {\n        const [subject, intro, codeLabel, actionLabel, hint] = await Promise.all([\n            t(TranslatorTranslationMailKey.PASSWORD_RESET_SUBJECT),\n            t(TranslatorTranslationMailKey.PASSWORD_RESET_INTRO),\n            t(TranslatorTranslationMailKey.CODE),\n            t(TranslatorTranslationMailKey.PASSWORD_RESET_ACTION),\n            t(TranslatorTranslationMailKey.PASSWORD_RESET_HINT),\n        ]);\n\n        const expiry = params.expiresInMinutes ?\n            await t(TranslatorTranslationMailKey.PASSWORD_RESET_EXPIRY, { minutes: params.expiresInMinutes }) :\n            undefined;\n\n        return {\n            subject,\n            preview: intro,\n            blocks: [\n                paragraph(intro),\n                code(codeLabel, params.code),\n                ...(params.url ? [action(actionLabel, params.url)] : []),\n                ...(expiry ? [note(expiry)] : []),\n                note(hint),\n            ],\n        };\n    },\n});\n"],"mappings":";;;;;;;;AAiBA,MAAaO,4BAA4BF,mBAAmB;CACxDG,MAAMF,iBAAiBG;CACvBC,OAAO,OAAOC,QAAQC,MAAAA;EAClB,MAAM,CAACC,SAASC,OAAOC,WAAWC,aAAaC,QAAQ,MAAMC,QAAQC,IAAI;GACrEP,EAAEZ,6BAA6BoB,sBAAsB;GACrDR,EAAEZ,6BAA6BqB,oBAAoB;GACnDT,EAAEZ,6BAA6BsB,IAAI;GACnCV,EAAEZ,6BAA6BuB,qBAAqB;GACpDX,EAAEZ,6BAA6BwB,mBAAmB;GACrD;EAED,MAAMC,SAASd,OAAOe,mBAClB,MAAMd,EAAEZ,6BAA6B2B,uBAAuB,EAAEC,SAASjB,OAAOe,iBAAiB,CAAA,IAC/FG,KAAAA;EAEJ,OAAO;GACHhB;GACAiB,SAAShB;GACTiB,QAAQ;IACJ3B,UAAUU,KAAAA;IACVZ,KAAKa,WAAWJ,OAAOT,IAAI;OACvBS,OAAOqB,MAAM,CAAC/B,OAAOe,aAAaL,OAAOqB,GAAG,CAAA,IAAK,CAAA;OACjDP,SAAS,CAACtB,KAAKsB,MAAAA,CAAAA,IAAW,CAAA;IAC9BtB,KAAKc,IAAAA;;EAEb;CACJ;AACJ,CAAA"}

package/dist/core/mail/template/templates/registration-activation.d.ts

@@ -0,0 +1,3 @@
+import { MailTemplateName } from '../types.ts';
+export declare const registrationActivationMailTemplate: import("../types.ts").MailTemplate<MailTemplateName.REGISTRATION_ACTIVATION>;
+//# sourceMappingURL=registration-activation.d.ts.map

package/dist/core/mail/template/templates/registration-activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration-activation.d.ts","sourceRoot":"","sources":["../../../../../src/core/mail/template/templates/registration-activation.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,kCAAkC,8EAsB7C,CAAC"}

package/dist/core/mail/template/templates/registration-activation.mjs

@@ -0,0 +1,34 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { action, code, note, paragraph } from "../../format/blocks.mjs";
+import { defineMailTemplate } from "../define.mjs";
+import { MailTemplateName } from "../types.mjs";
+import { TranslatorTranslationMailKey } from "@authup/i18n";
+//#region src/core/mail/template/templates/registration-activation.ts
+const registrationActivationMailTemplate = defineMailTemplate({
+	name: MailTemplateName.REGISTRATION_ACTIVATION,
+	build: async (params, t) => {
+		const [subject, intro, codeLabel, actionLabel, hint] = await Promise.all([
+			t(TranslatorTranslationMailKey.REGISTRATION_ACTIVATION_SUBJECT),
+			t(TranslatorTranslationMailKey.REGISTRATION_ACTIVATION_INTRO),
+			t(TranslatorTranslationMailKey.CODE),
+			t(TranslatorTranslationMailKey.REGISTRATION_ACTIVATION_ACTION),
+			t(TranslatorTranslationMailKey.REGISTRATION_ACTIVATION_HINT)
+		]);
+		return {
+			subject,
+			preview: intro,
+			blocks: [
+				paragraph(intro),
+				code(codeLabel, params.code),
+				...params.url ? [action(actionLabel, params.url)] : [],
+				note(hint)
+			]
+		};
+	}
+});
+//#endregion
+export { registrationActivationMailTemplate };
+
+//# sourceMappingURL=registration-activation.mjs.map

package/dist/core/mail/template/templates/registration-activation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration-activation.mjs","names":["TranslatorTranslationMailKey","action","code","note","paragraph","defineMailTemplate","MailTemplateName","registrationActivationMailTemplate","name","REGISTRATION_ACTIVATION","build","params","t","subject","intro","codeLabel","actionLabel","hint","Promise","all","REGISTRATION_ACTIVATION_SUBJECT","REGISTRATION_ACTIVATION_INTRO","CODE","REGISTRATION_ACTIVATION_ACTION","REGISTRATION_ACTIVATION_HINT","preview","blocks","url"],"sources":["../../../../../src/core/mail/template/templates/registration-activation.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { TranslatorTranslationMailKey } from '@authup/i18n';\nimport { \n    action, \n    code, \n    note, \n    paragraph, \n} from '../../format/blocks.ts';\nimport { defineMailTemplate } from '../define.ts';\nimport { MailTemplateName } from '../types.ts';\n\nexport const registrationActivationMailTemplate = defineMailTemplate({\n    name: MailTemplateName.REGISTRATION_ACTIVATION,\n    build: async (params, t) => {\n        const [subject, intro, codeLabel, actionLabel, hint] = await Promise.all([\n            t(TranslatorTranslationMailKey.REGISTRATION_ACTIVATION_SUBJECT),\n            t(TranslatorTranslationMailKey.REGISTRATION_ACTIVATION_INTRO),\n            t(TranslatorTranslationMailKey.CODE),\n            t(TranslatorTranslationMailKey.REGISTRATION_ACTIVATION_ACTION),\n            t(TranslatorTranslationMailKey.REGISTRATION_ACTIVATION_HINT),\n        ]);\n\n        return {\n            subject,\n            preview: intro,\n            blocks: [\n                paragraph(intro),\n                code(codeLabel, params.code),\n                ...(params.url ? [action(actionLabel, params.url)] : []),\n                note(hint),\n            ],\n        };\n    },\n});\n"],"mappings":";;;;;;;;AAiBA,MAAaO,qCAAqCF,mBAAmB;CACjEG,MAAMF,iBAAiBG;CACvBC,OAAO,OAAOC,QAAQC,MAAAA;EAClB,MAAM,CAACC,SAASC,OAAOC,WAAWC,aAAaC,QAAQ,MAAMC,QAAQC,IAAI;GACrEP,EAAEZ,6BAA6BoB,+BAA+B;GAC9DR,EAAEZ,6BAA6BqB,6BAA6B;GAC5DT,EAAEZ,6BAA6BsB,IAAI;GACnCV,EAAEZ,6BAA6BuB,8BAA8B;GAC7DX,EAAEZ,6BAA6BwB,4BAA4B;GAC9D;EAED,OAAO;GACHX;GACAY,SAASX;GACTY,QAAQ;IACJtB,UAAUU,KAAAA;IACVZ,KAAKa,WAAWJ,OAAOT,IAAI;OACvBS,OAAOgB,MAAM,CAAC1B,OAAOe,aAAaL,OAAOgB,GAAG,CAAA,IAAK,CAAA;IACrDxB,KAAKc,IAAAA;;EAEb;CACJ;AACJ,CAAA"}

package/dist/core/mail/template/types.d.ts

@@ -0,0 +1,39 @@
+import type { TranslatorTranslationMailKey } from '@authup/i18n';
+import type { MailBlock } from '../format/types.ts';
+export declare enum MailTemplateName {
+    REGISTRATION_ACTIVATION = "registration-activation",
+    PASSWORD_RESET = "password-reset"
+}
+export type MailTemplateParamsMap = {
+    [MailTemplateName.REGISTRATION_ACTIVATION]: {
+        code: string;
+        url?: string;
+    };
+    [MailTemplateName.PASSWORD_RESET]: {
+        code: string;
+        url?: string;
+        expiresInMinutes?: number;
+    };
+};
+/**
+ * Locale-bound translator handed to a template's `build`. Resolves a key
+ * of the `authupMail` namespace (`@authup/i18n`) through ilingo — `data`
+ * feeds `{{var}}` interpolation. Async so file- or remote-backed override
+ * stores can slot in behind the same contract.
+ */
+export type MailTemplateTranslator = (key: `${TranslatorTranslationMailKey}`, data?: Record<string, any>) => Promise<string>;
+export type MailTemplateBuildOutput = {
+    subject: string;
+    preview?: string;
+    blocks: MailBlock[];
+};
+/**
+ * A mail template composes its body from blocks; subject, html and text
+ * all derive from the same build output. Copy is not embedded — it is
+ * resolved per locale through the supplied translator.
+ */
+export type MailTemplate<N extends MailTemplateName = MailTemplateName> = {
+    name: N;
+    build(params: MailTemplateParamsMap[N], t: MailTemplateTranslator): Promise<MailTemplateBuildOutput>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/mail/template/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/mail/template/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,oBAAY,gBAAgB;IACxB,uBAAuB,4BAA4B;IACnD,cAAc,mBAAmB;CACpC;AAED,MAAM,MAAM,qBAAqB,GAAG;IAChC,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,EAAE;QACxC,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,CAAC,gBAAgB,CAAC,cAAc,CAAC,EAAE;QAC/B,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;CACL,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACjC,GAAG,EAAE,GAAG,4BAA4B,EAAE,EACtC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KACzB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,MAAM,uBAAuB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,EAAE,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI;IACtE,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,CACD,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAChC,CAAC,EAAE,sBAAsB,GAC1B,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACvC,CAAC"}

package/dist/core/mail/template/types.mjs

@@ -0,0 +1,13 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/core/mail/template/types.ts
+var MailTemplateName = /*#__PURE__*/ function(MailTemplateName) {
+	MailTemplateName["REGISTRATION_ACTIVATION"] = "registration-activation";
+	MailTemplateName["PASSWORD_RESET"] = "password-reset";
+	return MailTemplateName;
+}({});
+//#endregion
+export { MailTemplateName };
+
+//# sourceMappingURL=types.mjs.map

package/dist/core/mail/template/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":["MailTemplateName"],"sources":["../../../../src/core/mail/template/types.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { TranslatorTranslationMailKey } from '@authup/i18n';\nimport type { MailBlock } from '../format/types.ts';\n\nexport enum MailTemplateName {\n    REGISTRATION_ACTIVATION = 'registration-activation',\n    PASSWORD_RESET = 'password-reset',\n}\n\nexport type MailTemplateParamsMap = {\n    [MailTemplateName.REGISTRATION_ACTIVATION]: {\n        code: string,\n        url?: string,\n    },\n    [MailTemplateName.PASSWORD_RESET]: {\n        code: string,\n        url?: string,\n        expiresInMinutes?: number,\n    },\n};\n\n/**\n * Locale-bound translator handed to a template's `build`. Resolves a key\n * of the `authupMail` namespace (`@authup/i18n`) through ilingo — `data`\n * feeds `{{var}}` interpolation. Async so file- or remote-backed override\n * stores can slot in behind the same contract.\n */\nexport type MailTemplateTranslator = (\n    key: `${TranslatorTranslationMailKey}`,\n    data?: Record<string, any>,\n) => Promise<string>;\n\nexport type MailTemplateBuildOutput = {\n    subject: string,\n    // Hidden preheader shown by mail clients as the preview line.\n    preview?: string,\n    blocks: MailBlock[],\n};\n\n/**\n * A mail template composes its body from blocks; subject, html and text\n * all derive from the same build output. Copy is not embedded — it is\n * resolved per locale through the supplied translator.\n */\nexport type MailTemplate<N extends MailTemplateName = MailTemplateName> = {\n    name: N,\n    build(\n        params: MailTemplateParamsMap[N],\n        t: MailTemplateTranslator,\n    ): Promise<MailTemplateBuildOutput>,\n};\n"],"mappings":";;;;AAUA,IAAO,mBAAKA,uBAAAA,kBAAAA;;;QAAAA"}

package/dist/core/mail/types.d.ts

@@ -1,3 +1,4 @@
+import type { MailTemplateName, MailTemplateParamsMap } from './template/types.ts';
 export type MailAddress = {
     name: string;
     address: string;
@@ -12,4 +13,24 @@ export type MailSendOptions = {
 export interface IMailClient {
     send(options: MailSendOptions): Promise<void>;
 }
+export type MailRenderInput<N extends MailTemplateName = MailTemplateName> = {
+    template: N;
+    params: MailTemplateParamsMap[N];
+    locale?: string;
+};
+export type MailContent = {
+    subject: string;
+    html: string;
+    text: string;
+};
+/**
+ * Renders a localized, branded mail (subject + html + text) from a template
+ * name and typed params. Decouples mail copy/markup from the workflow
+ * services, which pass `{ template, params, locale }` instead of building
+ * HTML. Async because copy resolution runs through ilingo's store contract
+ * (memory today; file- or remote-backed overrides tomorrow).
+ */
+export interface IMailTemplateRenderer {
+    render<N extends MailTemplateName>(input: MailRenderInput<N>): Promise<MailContent>;
+}
 //# sourceMappingURL=types.d.ts.map