@awsmbiz/inbis-notifications 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,644 @@
+import { AppError, isPlaceholderEmail } from "@awsmbiz/inbis-core";
+// src/layout.ts
+const NEUTRAL_ACCENT = "#18181b";
+const HEX_COLOR = /^#[0-9a-fA-F]{6}$/;
+function escapeHtml(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
+}
+function httpsUrl(value) {
+	if (value === void 0) return void 0;
+	try {
+		return new URL(value).protocol === "https:" ? value : void 0;
+	} catch {
+		return;
+	}
+}
+function paragraph(text, style = "margin:0 0 16px;font-size:15px;line-height:24px;color:#3f3f46") {
+	return `<p style="${style}">${escapeHtml(text)}</p>`;
+}
+/**
+* Renders a branded email as plain text and HTML. All text is escaped; the
+* accent colour must be `#rrggbb` and the logo an https URL, otherwise they
+* are left out. Table-based, inline-styled HTML for broad client support.
+*/
+function renderBrandedEmail(content) {
+	const { brand } = content;
+	const accent = brand.accentColor !== void 0 && HEX_COLOR.test(brand.accentColor) ? brand.accentColor : NEUTRAL_ACCENT;
+	const logo = httpsUrl(brand.logoUrl);
+	const footer = brand.footer?.trim();
+	const text = [
+		content.greeting,
+		"",
+		...content.intro.flatMap((line) => [line, ""]),
+		`${content.action.label}: ${content.action.url}`,
+		"",
+		...content.outro.flatMap((line) => [line, ""]),
+		content.signOff,
+		...footer === void 0 || footer === "" ? [] : [
+			"",
+			"--",
+			footer
+		]
+	].join("\n");
+	const header = logo === void 0 ? `<p style="margin:0;font-size:18px;font-weight:600;color:#18181b">${escapeHtml(brand.name)}</p>` : `<img src="${escapeHtml(logo)}" alt="${escapeHtml(brand.name)}" height="32" style="display:block;height:32px;border:0">`;
+	const href = escapeHtml(content.action.url);
+	const html = `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${escapeHtml(content.subject)}</title>
+</head>
+<body style="margin:0;padding:0;background:#f4f4f5;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="background:#f4f4f5;padding:24px 12px">
+<tr><td align="center">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="max-width:560px;background:#ffffff;border:1px solid #e4e4e7;border-radius:8px">
+<tr><td style="padding:24px 32px 0">${header}</td></tr>
+<tr><td style="padding:24px 32px 8px">
+<h1 style="margin:0 0 16px;font-size:20px;line-height:28px;color:#18181b">${escapeHtml(content.heading)}</h1>
+${paragraph(content.greeting)}
+${content.intro.map((line) => paragraph(line)).join("\n")}
+<table role="presentation" cellpadding="0" cellspacing="0" style="margin:8px 0 24px"><tr><td style="border-radius:6px;background:${accent}">
+<a href="${href}" style="display:inline-block;padding:12px 20px;font-size:15px;font-weight:600;color:#ffffff;text-decoration:none">${escapeHtml(content.action.label)}</a>
+</td></tr></table>
+${paragraph(content.linkFallback, "margin:0 0 8px;font-size:13px;line-height:20px;color:#71717a")}
+<p style="margin:0 0 24px;font-size:13px;line-height:20px;word-break:break-all"><a href="${href}" style="color:${accent}">${href}</a></p>
+${content.outro.map((line) => paragraph(line)).join("\n")}
+${paragraph(content.signOff)}
+</td></tr>
+</table>
+${footer === void 0 || footer === "" ? "" : paragraph(footer, "margin:16px 0 0;font-size:12px;line-height:18px;color:#71717a")}
+</td></tr>
+</table>
+</body>
+</html>
+`;
+	return {
+		subject: content.subject,
+		text,
+		html
+	};
+}
+// src/messages.ts
+/**
+* Every string of the email templates, by message key. English only in the
+* baseline; another locale is another catalogue passed to
+* `createAuthEmailTemplates`. `{name}` placeholders are filled at render time.
+*/
+const emailMessages = {
+	"email.greeting": "Hi {name},",
+	"email.greetingNoName": "Hi,",
+	"email.linkFallback": "If the button does not work, copy this link into your browser:",
+	"email.signOff": "— The {appName} team",
+	"auth.verifyEmail.subject": "Verify your email address for {appName}",
+	"auth.verifyEmail.heading": "Verify your email address",
+	"auth.verifyEmail.intro": "Confirm that this is your email address to finish setting up your {appName} account.",
+	"auth.verifyEmail.action": "Verify email address",
+	"auth.verifyEmail.expiry": "This link works for {minutes} minutes.",
+	"auth.verifyEmail.ignore": "If you did not create an account, you can ignore this email.",
+	"auth.resetPassword.subject": "Reset your {appName} password",
+	"auth.resetPassword.heading": "Reset your password",
+	"auth.resetPassword.intro": "Someone asked to reset the password of your {appName} account.",
+	"auth.resetPassword.action": "Reset password",
+	"auth.resetPassword.expiry": "This link works for {minutes} minutes and can be used once.",
+	"auth.resetPassword.ignore": "If you did not ask for this, ignore this email: your password stays the same.",
+	"auth.invitation.subject": "{inviter} invited you to {appName}",
+	"auth.invitation.subjectNoInviter": "You are invited to {appName}",
+	"auth.invitation.heading": "You are invited to {appName}",
+	"auth.invitation.intro": "{inviter} invited you to join {appName}.",
+	"auth.invitation.introNoInviter": "You have been invited to join {appName}.",
+	"auth.invitation.introAdmin": "You will join as an administrator.",
+	"auth.invitation.action": "Accept invitation",
+	"auth.invitation.expiry": "This invitation works for {duration} and can be used once.",
+	"auth.invitation.ignore": "If you were not expecting this invitation, you can ignore this email.",
+	"duration.minutes": "{count} minutes",
+	"duration.hours": "{count} hours",
+	"duration.days": "{count} days"
+};
+/** Fills `{name}` placeholders; unknown placeholders are left as they are. */
+function format(template, values) {
+	return template.replace(/\{(\w+)\}/g, (match, name) => values[name] ?? match);
+}
+// src/auth-templates.ts
+function linkEmail(messages, kind, input) {
+	const values = {
+		appName: input.brand.name,
+		minutes: String(input.expiresInMinutes),
+		name: input.recipientName.trim()
+	};
+	const m = (key) => format(messages[key], values);
+	return renderBrandedEmail({
+		brand: input.brand,
+		subject: m(`auth.${kind}.subject`),
+		greeting: values.name === "" ? m("email.greetingNoName") : m("email.greeting"),
+		heading: m(`auth.${kind}.heading`),
+		intro: [m(`auth.${kind}.intro`)],
+		action: {
+			label: m(`auth.${kind}.action`),
+			url: input.url
+		},
+		linkFallback: m("email.linkFallback"),
+		outro: [m(`auth.${kind}.expiry`), m(`auth.${kind}.ignore`)],
+		signOff: m("email.signOff")
+	});
+}
+/** A lifetime in whole days, else whole hours, else minutes. */
+function duration(messages, minutes) {
+	if (minutes % 1440 === 0) return format(messages["duration.days"], { count: String(minutes / 1440) });
+	if (minutes % 60 === 0) return format(messages["duration.hours"], { count: String(minutes / 60) });
+	return format(messages["duration.minutes"], { count: String(minutes) });
+}
+function invitationEmail(messages, input) {
+	const inviter = input.inviterName.trim();
+	const name = input.recipientName.trim();
+	const values = {
+		appName: input.brand.name,
+		inviter,
+		name,
+		duration: duration(messages, input.expiresInMinutes)
+	};
+	const m = (key) => format(messages[key], values);
+	return renderBrandedEmail({
+		brand: input.brand,
+		subject: inviter === "" ? m("auth.invitation.subjectNoInviter") : m("auth.invitation.subject"),
+		greeting: name === "" ? m("email.greetingNoName") : m("email.greeting"),
+		heading: m("auth.invitation.heading"),
+		intro: [inviter === "" ? m("auth.invitation.introNoInviter") : m("auth.invitation.intro"), ...input.role === "admin" ? [m("auth.invitation.introAdmin")] : []],
+		action: {
+			label: m("auth.invitation.action"),
+			url: input.url
+		},
+		linkFallback: m("email.linkFallback"),
+		outro: [m("auth.invitation.expiry"), m("auth.invitation.ignore")],
+		signOff: m("email.signOff")
+	});
+}
+/** Auth email templates over a message catalogue (one locale). */
+function createAuthEmailTemplates(messages = emailMessages) {
+	return {
+		verifyEmail: (input) => linkEmail(messages, "verifyEmail", input),
+		resetPassword: (input) => linkEmail(messages, "resetPassword", input),
+		invitation: (input) => invitationEmail(messages, input)
+	};
+}
+/** The English auth email templates; pass to `createInbisAuth({ emailTemplates })`. */
+const authEmailTemplates = createAuthEmailTemplates();
+// src/communication-service.ts
+/**
+* Types a service binding as the communication service. `wrangler types`
+* types a service binding without the service's source as a plain `Fetcher`;
+* at runtime its RPC methods are callable all the same.
+*/
+function communicationServiceBinding(binding) {
+	return binding;
+}
+/** Throws at startup when the app ID is missing; it must be the platform-set `APP_ID`. */
+function requireAppId(appId) {
+	if (typeof appId !== "string" || appId.trim() === "") throw new Error("The communication service needs the app's APP_ID (set by the platform); it is missing or blank.");
+	return appId;
+}
+/** The message of an error that crossed the RPC boundary (custom classes do not survive it). */
+function errorMessage(error) {
+	if (error instanceof Error) return error.message;
+	if (typeof error === "string") return error;
+	return "";
+}
+// src/errors.ts
+/** Throws `EMAIL_RECIPIENT_PLACEHOLDER` for a phone-only user's placeholder address (plan §5.5). */
+function refusePlaceholderRecipient(to) {
+	if (isPlaceholderEmail(to)) throw new EmailDeliveryError({ code: "EMAIL_RECIPIENT_PLACEHOLDER" });
+}
+const DETAILS = {
+	EMAIL_APP_NOT_REGISTERED: {
+		message: "Email is not set up for this app.",
+		retryable: false,
+		status: 500
+	},
+	EMAIL_APP_SUSPENDED: {
+		message: "Email sending is suspended for this app.",
+		retryable: false,
+		status: 503
+	},
+	EMAIL_QUOTA_EXCEEDED: {
+		message: "The monthly email limit is reached.",
+		retryable: true,
+		status: 503
+	},
+	EMAIL_UNSUPPORTED_FIELD: {
+		message: "This email cannot be sent as configured.",
+		retryable: false,
+		status: 500
+	},
+	EMAIL_SENDER_NOT_VERIFIED: {
+		message: "The email sender is not verified.",
+		retryable: false,
+		status: 502
+	},
+	EMAIL_RECIPIENT_NOT_ALLOWED: {
+		message: "The email recipient is not allowed.",
+		retryable: false,
+		status: 502
+	},
+	EMAIL_RATE_LIMITED: {
+		message: "Email sending is rate limited. Try again later.",
+		retryable: true,
+		status: 503
+	},
+	EMAIL_DAILY_LIMIT_EXCEEDED: {
+		message: "The daily email limit is reached.",
+		retryable: true,
+		status: 503
+	},
+	EMAIL_SENDER_MISSING: {
+		message: "No email sender address is configured.",
+		retryable: false,
+		status: 500
+	},
+	EMAIL_RECIPIENT_PLACEHOLDER: {
+		message: "This account has no email address to send to.",
+		retryable: false,
+		status: 400
+	},
+	EMAIL_DELIVERY_FAILED: {
+		message: "The email could not be sent.",
+		retryable: false,
+		status: 502
+	}
+};
+/**
+* An email that was not accepted for delivery. Never swallowed: adapters throw it.
+* The message is caller-safe (no addresses or content); the service's error
+* is kept as `cause` for logs.
+*/
+var EmailDeliveryError = class extends AppError {
+	providerCode;
+	/** True when sending the same message later may succeed (rate, daily or monthly limits). */
+	retryable;
+	constructor(options) {
+		const details = DETAILS[options.code];
+		super({
+			code: options.code,
+			message: details.message,
+			status: details.status,
+			cause: options.cause
+		});
+		this.name = "EmailDeliveryError";
+		this.providerCode = options.providerCode;
+		this.retryable = details.retryable;
+	}
+};
+const SMS_DETAILS = {
+	SMS_TEMPLATE_NOT_CONFIGURED: {
+		message: "No SMS template is configured for this message.",
+		retryable: false,
+		status: 500
+	},
+	SMS_TEMPLATE_VARIABLE_MISSING: {
+		message: "The SMS template needs a value the message lacks.",
+		retryable: false,
+		status: 500
+	},
+	SMS_RECIPIENT_INVALID: {
+		message: "The SMS recipient is not a valid phone number.",
+		retryable: false,
+		status: 400
+	},
+	SMS_APP_NOT_REGISTERED: {
+		message: "SMS is not set up for this app.",
+		retryable: false,
+		status: 500
+	},
+	SMS_APP_SUSPENDED: {
+		message: "SMS sending is suspended for this app.",
+		retryable: false,
+		status: 503
+	},
+	SMS_QUOTA_EXCEEDED: {
+		message: "The monthly SMS limit is reached.",
+		retryable: true,
+		status: 503
+	},
+	SMS_INVALID: {
+		message: "The SMS could not be sent as configured.",
+		retryable: false,
+		status: 500
+	},
+	SMS_TEMPLATE_MISMATCH: {
+		message: "The SMS does not match its registered template.",
+		retryable: false,
+		status: 500
+	},
+	SMS_PROVIDER_UNAVAILABLE: {
+		message: "The SMS provider is unavailable. Try again later.",
+		retryable: true,
+		status: 503
+	},
+	SMS_DELIVERY_FAILED: {
+		message: "The SMS could not be sent.",
+		retryable: false,
+		status: 502
+	}
+};
+/**
+* An SMS that was not accepted for delivery, or that could not be sent as configured.
+* Never swallowed: adapters throw it. The message is caller-safe (no numbers or
+* content); the service's error is kept as `cause` for logs.
+*/
+var SmsDeliveryError = class extends AppError {
+	providerStatus;
+	/** True when sending the same message later may succeed. */
+	retryable;
+	constructor(options) {
+		const details = SMS_DETAILS[options.code];
+		super({
+			code: options.code,
+			message: details.message,
+			status: details.status,
+			cause: options.cause
+		});
+		this.name = "SmsDeliveryError";
+		this.providerStatus = options.providerStatus;
+		this.retryable = details.retryable;
+	}
+};
+function serviceErrorKind(message) {
+	if (message.startsWith("No app registered with app_id")) return "APP_NOT_REGISTERED";
+	if (/^App ".*" is suspended$/.test(message)) return "APP_SUSPENDED";
+	if (/^App ".*" has exceeded its monthly quota$/.test(message)) return "QUOTA_EXCEEDED";
+}
+const PROVIDER_CODES = {
+	E_SENDER_NOT_VERIFIED: "EMAIL_SENDER_NOT_VERIFIED",
+	E_RECIPIENT_NOT_ALLOWED: "EMAIL_RECIPIENT_NOT_ALLOWED",
+	E_RATE_LIMIT_EXCEEDED: "EMAIL_RATE_LIMITED",
+	E_DAILY_LIMIT_EXCEEDED: "EMAIL_DAILY_LIMIT_EXCEEDED"
+};
+/** Maps an error thrown by the communication service's `sendEmail` to an {@link EmailDeliveryError}. */
+function fromServiceEmailError(error) {
+	const message = errorMessage(error);
+	const kind = serviceErrorKind(message);
+	if (kind !== void 0) return new EmailDeliveryError({
+		code: `EMAIL_${kind}`,
+		cause: error
+	});
+	if (message.startsWith("The Cloudflare send path does not support")) return new EmailDeliveryError({
+		code: "EMAIL_UNSUPPORTED_FIELD",
+		cause: error
+	});
+	const providerCode = /\bE_[A-Z_]+\b/.exec(message)?.[0];
+	return new EmailDeliveryError({
+		code: (providerCode === void 0 ? void 0 : PROVIDER_CODES[providerCode]) ?? "EMAIL_DELIVERY_FAILED",
+		...providerCode === void 0 ? {} : { providerCode },
+		cause: error
+	});
+}
+/** Chatico statuses the service records for its own automatic retry (besides 5xx). */
+const RETRIED_CHATICO_STATUSES = /* @__PURE__ */ new Set([
+	402,
+	408,
+	413
+]);
+/** Maps an error thrown by the communication service's `sendSms` to an {@link SmsDeliveryError}. */
+function fromServiceSmsError(error) {
+	const message = errorMessage(error);
+	const kind = serviceErrorKind(message);
+	if (kind !== void 0) return new SmsDeliveryError({
+		code: `SMS_${kind}`,
+		cause: error
+	});
+	if (message.startsWith("sendSms needs at least one recipient")) return new SmsDeliveryError({
+		code: "SMS_INVALID",
+		cause: error
+	});
+	const chatico = /^Chatico send failed \((\d+)\)/.exec(message);
+	if (chatico?.[1] !== void 0) {
+		const providerStatus = Number(chatico[1]);
+		return new SmsDeliveryError({
+			code: providerStatus === 409 ? "SMS_TEMPLATE_MISMATCH" : providerStatus >= 500 || RETRIED_CHATICO_STATUSES.has(providerStatus) ? "SMS_PROVIDER_UNAVAILABLE" : "SMS_DELIVERY_FAILED",
+			providerStatus,
+			cause: error
+		});
+	}
+	return new SmsDeliveryError({
+		code: "SMS_DELIVERY_FAILED",
+		cause: error
+	});
+}
+// src/communication-service-email.ts
+/** Splits `Name <address>` into its parts; a bare address has no name. */
+function parseMailbox(value) {
+	const match = /^\s*(.*?)\s*<([^<>]+)>\s*$/.exec(value);
+	if (match?.[2] === void 0) return { email: value.trim() };
+	const name = match[1]?.replace(/^"(.*)"$/, "$1") ?? "";
+	return name === "" ? { email: match[2].trim() } : {
+		name,
+		email: match[2].trim()
+	};
+}
+/**
+* {@link EmailSender} over AWSM's shared communication service. Without `smtp`
+* it uses the metered Cloudflare path, which takes only plain-string addresses:
+* a display name in `from` is dropped there (kept on the SMTP path). Quota,
+* suspension and retries belong to the service. Every failure is thrown as an
+* {@link EmailDeliveryError}; nothing is swallowed or logged.
+*/
+function createCommunicationServiceEmailSender(options) {
+	const appId = requireAppId(options.appId);
+	const { binding, smtp } = options;
+	return { async send(message) {
+		refusePlaceholderRecipient(message.to);
+		const from = message.from ?? options.from;
+		if (from === void 0 || from.trim() === "") throw new EmailDeliveryError({ code: "EMAIL_SENDER_MISSING" });
+		const sender = parseMailbox(from);
+		const replyTo = message.replyTo ?? options.replyTo;
+		const email = {
+			from: smtp === void 0 ? sender.email : sender,
+			to: parseMailbox(message.to).email,
+			...replyTo === void 0 ? {} : { reply: parseMailbox(replyTo).email },
+			subject: message.subject,
+			text: message.text,
+			...message.html === void 0 ? {} : { html: message.html }
+		};
+		let result;
+		try {
+			result = smtp === void 0 ? await binding.sendEmail(appId, email) : await binding.sendEmail(appId, email, smtp);
+		} catch (error) {
+			throw fromServiceEmailError(error);
+		}
+		const messageId = typeof result === "object" && result !== null && "messageId" in result ? result.messageId : void 0;
+		return typeof messageId === "string" && messageId !== "" ? { messageId } : {};
+	} };
+}
+// src/communication-service-sms.ts
+const E164 = /^\+[1-9]\d{6,14}$/;
+/** `+919876543210` → `919876543210` (country code first, no `+`). The default. */
+function e164DigitsRecipient(e164) {
+	return e164.slice(1);
+}
+/** `+919876543210` → `9876543210` (Indian numbers without the country code); other numbers as {@link e164DigitsRecipient}. */
+function indianTenDigitRecipient(e164) {
+	return /^\+91\d{10}$/.test(e164) ? e164.slice(3) : e164.slice(1);
+}
+function blank(value) {
+	return value === void 0 || value.trim() === "";
+}
+/** Throws at startup on any missing or incomplete template, naming it (never any content). */
+function validateTemplates(options) {
+	for (const key of options.requiredTemplates ?? []) if (options.templates[key] === void 0) throw new Error(`SMS template "${key}" is not configured.`);
+	for (const [key, template] of Object.entries(options.templates)) {
+		if (blank(template.smsHeader ?? options.smsHeader)) throw new Error(`SMS template "${key}" has no DLT sender header.`);
+		if (blank(template.templateId)) throw new Error(`SMS template "${key}" has no DLT template ID.`);
+		if (blank(template.text)) throw new Error(`SMS template "${key}" has no text.`);
+	}
+}
+function render$2(text, variables) {
+	return text.replace(/\{(\w+)\}/g, (_, name) => {
+		const value = variables[name];
+		if (value === void 0) throw new SmsDeliveryError({ code: "SMS_TEMPLATE_VARIABLE_MISSING" });
+		return value;
+	});
+}
+/**
+* {@link SmsSender} over AWSM's shared communication service (Chatico, AWSM as
+* the DLT entity). The message's `template.id` picks the app's DLT
+* configuration; the text sent is that template's text with the message's
+* variables filled in (the message's own `text` is not sent). Quota,
+* suspension and retries belong to the service. Every failure is thrown as an
+* {@link SmsDeliveryError}; nothing is swallowed or logged.
+*/
+function createCommunicationServiceSmsSender(options) {
+	const appId = requireAppId(options.appId);
+	validateTemplates(options);
+	const formatRecipient = options.formatRecipient ?? e164DigitsRecipient;
+	const { binding } = options;
+	return { async send(message) {
+		const template = message.template === void 0 ? void 0 : options.templates[message.template.id];
+		if (template === void 0 || message.template === void 0) throw new SmsDeliveryError({ code: "SMS_TEMPLATE_NOT_CONFIGURED" });
+		if (!E164.test(message.to)) throw new SmsDeliveryError({ code: "SMS_RECIPIENT_INVALID" });
+		const text = render$2(template.text, message.template.variables);
+		let result;
+		try {
+			result = await binding.sendSms(appId, {
+				smsHeader: template.smsHeader ?? options.smsHeader ?? "",
+				templateId: template.templateId,
+				recipients: [formatRecipient(message.to)],
+				message: text
+			});
+		} catch (error) {
+			throw fromServiceSmsError(error);
+		}
+		const messageId = result.messageIds[0] ?? result.submissionId;
+		return messageId === "" ? {} : { messageId };
+	} };
+}
+// src/log-email.ts
+const TEXT_LINK = /https?:\/\/[^\s<>"')\]]+/g;
+const HREF = /href\s*=\s*"([^"]+)"|href\s*=\s*'([^']+)'/gi;
+function decodeEntities(value) {
+	return value.replaceAll("&quot;", "\"").replaceAll("&#39;", "'").replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&amp;", "&");
+}
+function linksOf(text, html) {
+	const links = [...text.matchAll(TEXT_LINK)].map((match) => match[0]);
+	for (const match of html?.matchAll(HREF) ?? []) {
+		const href = decodeEntities(match[1] ?? match[2] ?? "");
+		if (/^https?:\/\//i.test(href)) links.push(href);
+	}
+	return [...new Set(links)];
+}
+function render$1(email) {
+	return [
+		`[email ${email.messageId}]`,
+		`From: ${email.from ?? "(none)"}`,
+		`To: ${email.to}`,
+		...email.replyTo === void 0 ? [] : [`Reply-To: ${email.replyTo}`],
+		`Subject: ${email.subject}`,
+		"",
+		email.text,
+		"",
+		email.html === void 0 ? "(no HTML part)" : `(HTML part: ${email.html.length} characters)`,
+		...email.links.length === 0 ? [] : ["Links:", ...email.links.map((link) => `  ${link}`)]
+	].join("\n");
+}
+/**
+* Development {@link EmailSender} that prints every email in full (addresses,
+* subject, text body and links) instead of delivering it, and keeps the recent
+* ones for an outbox viewer. Nothing is silently discarded.
+*
+* Never use it where real users expect email: it delivers nothing, and its
+* output (and outbox) contains live verification and reset links.
+*/
+function createLogEmailSender(options = {}) {
+	const print = options.print ?? ((text) => {
+		console.info(text);
+	});
+	const keep = options.keep ?? 50;
+	const recent = [];
+	let sent = 0;
+	return {
+		send(message) {
+			if (isPlaceholderEmail(message.to)) return Promise.reject(new EmailDeliveryError({ code: "EMAIL_RECIPIENT_PLACEHOLDER" }));
+			sent += 1;
+			const email = {
+				messageId: `log-${Date.now().toString(36)}-${sent}`,
+				sentAt: (/* @__PURE__ */ new Date()).toISOString(),
+				to: message.to,
+				from: message.from ?? options.from,
+				replyTo: message.replyTo,
+				subject: message.subject,
+				text: message.text,
+				html: message.html,
+				links: linksOf(message.text, message.html)
+			};
+			recent.push(email);
+			if (recent.length > keep) recent.splice(0, recent.length - keep);
+			print(render$1(email));
+			return Promise.resolve({ messageId: email.messageId });
+		},
+		recent: () => recent
+	};
+}
+// src/log-sms.ts
+function render(sms) {
+	return [
+		`[sms ${sms.messageId}]`,
+		`To: ${sms.to}`,
+		...sms.templateId === void 0 ? [] : [`Template: ${sms.templateId}`],
+		"",
+		sms.text
+	].join("\n");
+}
+/**
+* Development {@link SmsSender} that prints every message in full instead of
+* delivering it, and keeps the recent ones for an outbox viewer. Nothing is
+* silently discarded.
+*
+* Never use it where real users expect SMS: it delivers nothing, and its
+* output (and outbox) contains live sign-in codes.
+*/
+function createLogSmsSender(options = {}) {
+	const print = options.print ?? ((text) => {
+		console.info(text);
+	});
+	const keep = options.keep ?? 50;
+	const recent = [];
+	let sent = 0;
+	return {
+		send(message) {
+			sent += 1;
+			const sms = {
+				messageId: `log-sms-${Date.now().toString(36)}-${sent}`,
+				sentAt: (/* @__PURE__ */ new Date()).toISOString(),
+				to: message.to,
+				text: message.text,
+				templateId: message.template?.id
+			};
+			recent.push(sms);
+			if (recent.length > keep) recent.splice(0, recent.length - keep);
+			print(render(sms));
+			return Promise.resolve({ messageId: sms.messageId });
+		},
+		recent: () => recent
+	};
+}
+export { EmailDeliveryError, SmsDeliveryError, authEmailTemplates, communicationServiceBinding, createAuthEmailTemplates, createCommunicationServiceEmailSender, createCommunicationServiceSmsSender, createLogEmailSender, createLogSmsSender, e164DigitsRecipient, emailMessages, indianTenDigitRecipient, renderBrandedEmail };
+
+//# sourceMappingURL=index.js.map