Email Guards

Foundation

Validation and sanitization utilities for email templates. Enforces safe hex colors, validates URLs (blocks javascript: and data:), normalizes recipient addresses, and clamps subject lines to SMTP-safe lengths.

core/email-guards

Installation

1 · Add registry to components.json

2 · Install component

API Reference

PropTypeDescription
sanitizeEmailTemplateHex(input, fallback)
string → stringOnly allows #rgb or #rrggbb, returns fallback otherwise.
normalizeRecipientEmail(email, context)
string → stringTrims and validates a recipient address.
requireHttpOrHttpsUrl(raw, label)
string → stringBlocks non-http(s) protocols.
optionalHttpOrHttpsUrl(raw, label)
string | undefinedLike requireHttpOrHttpsUrl but accepts undefined/null.
clampEmailSubjectLine(subject, maxLen?)
string → stringTruncates to 200 chars with ellipsis.