npm - @resq-systems/email-templates - Versions diffs - 0.6.0 → 0.6.2 - Mend

@resq-systems/email-templates 0.6.0 → 0.6.2

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.

Files changed (91) hide show

package/lib/contract.d.ts +56 -43
package/lib/contract.d.ts.map +1 -1
package/lib/contract.js +12 -1
package/lib/contract.js.map +1 -1
package/lib/emails/incident-alert.d.ts +1 -0
package/lib/emails/incident-alert.d.ts.map +1 -1
package/lib/emails/incident-alert.js.map +1 -1
package/lib/emails/index.d.ts +1 -1
package/lib/emails/mission-approval.d.ts +1 -0
package/lib/emails/mission-approval.d.ts.map +1 -1
package/lib/emails/mission-approval.js.map +1 -1
package/lib/emails/new-device-login.d.ts +1 -0
package/lib/emails/new-device-login.d.ts.map +1 -1
package/lib/emails/new-device-login.js.map +1 -1
package/lib/emails/notification.d.ts +1 -0
package/lib/emails/notification.d.ts.map +1 -1
package/lib/emails/notification.js.map +1 -1
package/lib/emails/org-invitation.d.ts +1 -0
package/lib/emails/org-invitation.d.ts.map +1 -1
package/lib/emails/org-invitation.js.map +1 -1
package/lib/emails/otp.d.ts +1 -0
package/lib/emails/otp.d.ts.map +1 -1
package/lib/emails/otp.js.map +1 -1
package/lib/emails/password-changed.d.ts +1 -0
package/lib/emails/password-changed.d.ts.map +1 -1
package/lib/emails/password-changed.js.map +1 -1
package/lib/emails/password-reset.d.ts +1 -0
package/lib/emails/password-reset.d.ts.map +1 -1
package/lib/emails/password-reset.js.map +1 -1
package/lib/emails/primitives.d.ts.map +1 -1
package/lib/emails/primitives.js +7 -0
package/lib/emails/primitives.js.map +1 -1
package/lib/emails/theme.d.ts +86 -8
package/lib/emails/theme.d.ts.map +1 -1
package/lib/emails/theme.js +51 -3
package/lib/emails/theme.js.map +1 -1
package/lib/emails/tokens.d.ts +2 -1
package/lib/emails/tokens.d.ts.map +1 -1
package/lib/emails/tokens.js +7 -0
package/lib/emails/tokens.js.map +1 -1
package/lib/emails/welcome.d.ts +1 -0
package/lib/emails/welcome.d.ts.map +1 -1
package/lib/emails/welcome.js.map +1 -1
package/lib/index.d.ts +1 -1
package/lib/mailer.d.ts +118 -11
package/lib/mailer.d.ts.map +1 -1
package/lib/mailer.js +48 -2
package/lib/mailer.js.map +1 -1
package/lib/node_modules/@react-email/tailwind/dist/index.d.ts +1 -1
package/lib/node_modules/{tailwindcss → @react-email/tailwind/node_modules/tailwindcss}/dist/colors.d.ts +1 -1
package/lib/node_modules/@react-email/tailwind/node_modules/tailwindcss/dist/colors.d.ts.map +1 -0
package/lib/node_modules/{tailwindcss → @react-email/tailwind/node_modules/tailwindcss}/dist/lib.d.ts +1 -1
package/lib/node_modules/@react-email/tailwind/node_modules/tailwindcss/dist/lib.d.ts.map +1 -0
package/lib/node_modules/{tailwindcss → @react-email/tailwind/node_modules/tailwindcss}/dist/resolve-config-QUZ9b-Gn.d.ts +1 -1
package/lib/node_modules/@react-email/tailwind/node_modules/tailwindcss/dist/resolve-config-QUZ9b-Gn.d.ts.map +1 -0
package/lib/node_modules/{tailwindcss → @react-email/tailwind/node_modules/tailwindcss}/dist/types-DWdTiksJ.d.ts +1 -1
package/lib/node_modules/@react-email/tailwind/node_modules/tailwindcss/dist/types-DWdTiksJ.d.ts.map +1 -0
package/lib/registry.d.ts.map +1 -1
package/lib/registry.js +6 -0
package/lib/registry.js.map +1 -1
package/lib/render.d.ts +9 -2
package/lib/render.d.ts.map +1 -1
package/lib/render.js +16 -2
package/lib/render.js.map +1 -1
package/lib/schemas.d.ts +9 -0
package/lib/schemas.d.ts.map +1 -1
package/lib/schemas.js +16 -0
package/lib/schemas.js.map +1 -1
package/lib/send/index.d.ts +1 -1
package/lib/send/resend-sender.d.ts +11 -0
package/lib/send/resend-sender.d.ts.map +1 -1
package/lib/send/resend-sender.js +17 -0
package/lib/send/resend-sender.js.map +1 -1
package/lib/send/send-email.d.ts +21 -0
package/lib/send/send-email.d.ts.map +1 -1
package/lib/send/send-email.js +26 -0
package/lib/send/send-email.js.map +1 -1
package/lib/send/sender.d.ts +26 -2
package/lib/send/sender.d.ts.map +1 -1
package/lib/suite.d.ts.map +1 -1
package/lib/suite.js +7 -0
package/lib/suite.js.map +1 -1
package/lib/templates.d.ts +9 -0
package/lib/templates.d.ts.map +1 -1
package/lib/templates.js +16 -0
package/lib/templates.js.map +1 -1
package/package.json +7 -7
package/lib/node_modules/tailwindcss/dist/colors.d.ts.map +0 -1
package/lib/node_modules/tailwindcss/dist/lib.d.ts.map +0 -1
package/lib/node_modules/tailwindcss/dist/resolve-config-QUZ9b-Gn.d.ts.map +0 -1
package/lib/node_modules/tailwindcss/dist/types-DWdTiksJ.d.ts.map +0 -1

package/lib/emails/theme.d.ts CHANGED Viewed

@@ -2,21 +2,45 @@ import { EmailCategory } from "../schemas.js";
 import { TailwindConfig } from "../node_modules/@react-email/tailwind/dist/index.js";
 import { ReactElement } from "react";
 //#region src/emails/theme.d.ts
+/**
+ * Font stacks the theme exposes to Tailwind's `fontFamily` extension. Each array
+ * is a CSS font-family stack in priority order (preferred face first, generic
+ * fallback last); multi-word names are pre-quoted so they drop straight into a
+ * `font-family` value.
+ */
 interface EmailThemeFonts {
+  /** Stack for display/heading text. */
   display: string[];
+  /** Stack for body/sans text. */
   sans: string[];
+  /** Stack for monospace text (codes, metadata). */
   mono: string[];
 }
-/** Organization identity rendered into email chrome (header, signature, footer). */
+/**
+ * Organization identity rendered into email chrome (header, signature, footer).
+ *
+ * All `*Url` fields are absolute URLs. {@link EmailOrgIdentity.registeredAddress}
+ * leads with the legal entity name, so it stands alone as a complete CAN-SPAM
+ * postal line without a separate `legalName` line in the footer.
+ */
 interface EmailOrgIdentity {
+  /** Short brand name used in sign-offs, e.g. "— The {brandName} team". */
   brandName: string;
+  /** Product name shown in the header lockup beside the logo. */
   productName: string;
+  /** Full legal entity name. */
   legalName: string;
+  /** Registered postal address, prefixed with the legal name; a complete CAN-SPAM line. */
   registeredAddress: string;
+  /** Support inbox address, rendered as a `mailto:` link. */
   supportEmail: string;
+  /** Marketing/website URL (absolute). Never used as an unsubscribe target. */
   websiteUrl: string;
+  /** Absolute URL of the Terms page. */
   termsUrl: string;
+  /** Absolute URL of the Privacy page. */
   privacyUrl: string;
+  /** Absolute URL of the header logo image. */
   logoUrl: string;
 }
 /** The full, resolved theme every template renders against. */
@@ -30,22 +54,58 @@ interface EmailTheme {
   /** Optional stylesheet `<link>` injected in `<Head>` for brand webfonts. */
   fontsHref?: string;
 }
-/** A partial theme a consumer supplies to rebrand; unset keys fall back to the base. */
+/**
+ * A partial theme a consumer supplies to rebrand; unset keys fall back to the
+ * base. All object fields are **shallow**-merged over the base one level deep (see
+ * {@link resolveEmailTheme}), so supplying `colors` replaces only the named color
+ * tokens, not the whole palette.
+ */
 interface EmailThemeOverride {
+  /** Color tokens to override (email-safe hex); merged over the base palette. */
   colors?: Record<string, string>;
+  /** Font stacks to override; unspecified stacks keep the base. */
   fonts?: Partial<EmailThemeFonts>;
   /** Override organization identity fields (shallow-merged over the base). */
   org?: Partial<EmailOrgIdentity>;
-  /** Pass `null` to drop the webfont link entirely. */
+  /** Replace the webfont `<link>` href, or pass `null` to drop it entirely. */
   fontsHref?: string | null;
 }
 /** The default ResQ Systems brand theme (dark-first, red primary, Syne/DM Sans/DM Mono). */
 declare const defaultEmailTheme: EmailTheme;
-/** Merge an override onto a base theme (colors/fonts shallow-merge; `fontsHref: null` removes it). */
+/**
+ * Merge an override onto a base theme, producing a new resolved theme.
+ *
+ * Pure — never mutates `base`. `colors`, `fonts`, and `org` are **shallow**-merged
+ * (override keys replace base keys one level deep), so a partial `fonts` override
+ * keeps the base's other stacks. `fontsHref` follows a three-way rule: `null`
+ * drops the webfont link entirely, absent/`undefined` keeps the base href, and any
+ * string replaces it.
+ *
+ * @param base - The theme to start from.
+ * @param override - Fields to overlay; when omitted, `base` is returned by reference.
+ * @returns The merged theme, or `base` itself when there is no override.
+ */
 declare function resolveEmailTheme(base: EmailTheme, override?: EmailThemeOverride): EmailTheme;
-/** Merge an override onto the default ResQ Systems theme. */
+/**
+ * Merge an override onto the default ResQ Systems theme.
+ *
+ * Pure convenience wrapper over {@link resolveEmailTheme} with
+ * {@link defaultEmailTheme} as the base.
+ *
+ * @param override - Fields to overlay on the default theme.
+ * @returns The resolved theme.
+ */
 declare function mergeEmailTheme(override?: EmailThemeOverride): EmailTheme;
-/** Build the `<Tailwind config>` object from a resolved theme. */
+/**
+ * Build the `<Tailwind config>` object from a resolved theme.
+ *
+ * Pure — projects the theme's colors and font stacks into a Tailwind
+ * `theme.extend` config atop the pixel-based preset (email clients need px units,
+ * not rem).
+ *
+ * @param theme - The resolved theme to project.
+ * @returns The config object to pass to react-email's `<Tailwind>`.
+ */
 declare function buildTailwindConfig(theme: EmailTheme): {
   presets: TailwindConfig[];
   theme: {
@@ -67,13 +127,25 @@ declare const EmailThemeContext: import("react").Context<EmailTheme>;
  * Wrap an element so it renders against a theme override (used by `renderEmail`).
  * Returns the element unchanged when there is no override, so the default theme
  * flows through context.
+ *
+ * Pure — builds a new provider element and does not mutate `element`.
+ *
+ * @param element - The email element tree to wrap.
+ * @param override - Theme fields to overlay; when omitted, `element` is returned unchanged.
+ * @returns `element`, wrapped in an {@link EmailThemeContext} provider when an override is given.
  */
 declare function withEmailTheme(element: ReactElement, override?: EmailThemeOverride): ReactElement;
-/** Per-send message policy carried through context to the legal footer. */
+/**
+ * Per-send message policy carried through context to the legal footer.
+ *
+ * The unsubscribe affordance renders only when {@link EmailMessage.category} is
+ * `"marketing"` **and** {@link EmailMessage.unsubscribeUrl} is set; a marketing
+ * send with no `unsubscribeUrl` simply omits it (there is no homepage fallback).
+ */
 interface EmailMessage {
   /** Compliance class; defaults to `transactional`. */
   category: EmailCategory;
-  /** Where the unsubscribe/preferences link points (used for `marketing`). */
+  /** Absolute unsubscribe/preferences URL; only consulted for `marketing` sends. */
   unsubscribeUrl?: string;
 }
 /** Context carrying the active message policy; defaults to a transactional send. */
@@ -82,6 +154,12 @@ declare const EmailMessageContext: import("react").Context<EmailMessage>;
  * Wrap an element so it renders against a message policy (used by `renderEmail`).
  * Returns the element unchanged when no message is given, so the default
  * transactional policy flows through context.
+ *
+ * Pure — builds a new provider element and does not mutate `element`.
+ *
+ * @param element - The email element tree to wrap.
+ * @param message - The per-send policy; when omitted, `element` is returned unchanged.
+ * @returns `element`, wrapped in an {@link EmailMessageContext} provider when a message is given.
  */
 declare function withEmailMessage(element: ReactElement, message?: EmailMessage): ReactElement;
 //#endregion

package/lib/emails/theme.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"theme.d.ts","names":[],"sources":["../../src/emails/theme.tsx"],"mappings":"~~;;;;UAqBiB;EAChB;EACA;EACA~~;;;UAIgB~~;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;UAIgB~~;;EAEhB,QAAQ;;EAER,OAAO;;EAEP,KAAK;;EAEL~~;;;UAIgB;EAChB~~,SAAS~~;EACT~~,QAAQ,QAAQ;;EAEhB,MAAM,QAAQ;;EAEd;;;~~cAIY~~,mBAAmB~~;;iBAYhB~~,kBAAkB,MAAM,YAAY,WAAW,qBAAqB~~;;iBAWpE~~,gBAAgB,WAAW,qBAAqB~~;;iBAKhD~~,oBAAoB,OAAO;WAAA;;;;;;;QAOtC;QACA;QACA;;;;;;cAQQ,mCAAiB,QAAA~~;;;;;;iBAOd~~,eAAe,SAAS,cAAc,WAAW,qBAAqB;;~~UAMrE;;~~EAEhB,UAAU;;EAEV;;;cAIY,qCAAmB,QAAA~~;;;;;;iBAOhB~~,iBAAiB,SAAS,cAAc,UAAU,eAAe"}
1	+ {"version":3,"file":"theme.d.ts","names":[],"sources":["../../src/emails/theme.tsx"],"mappings":";;;;;;;;;;UAqCiB;;EAEhB;;EAEA;;EAEA;;;;;;;;;UAUgB;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;UAIgB;;EAEhB,QAAQ;;EAER,OAAO;;EAEP,KAAK;;EAEL;;;;;;;;UASgB;;EAEhB,SAAS;;EAET,QAAQ,QAAQ;;EAEhB,MAAM,QAAQ;;EAEd;;;cAQY,mBAAmB;;;;;;;;;;;;;;iBAwBhB,kBAAkB,MAAM,YAAY,WAAW,qBAAqB;;;;;;;;;;iBAmBpE,gBAAgB,WAAW,qBAAqB;;;;;;;;;;;iBAchD,oBAAoB,OAAO;WAAA;;;;;;;QAOtC;QACA;QACA;;;;;;cAQQ,mCAAiB,QAAA;;;;;;;;;;;;iBAad,eAAe,SAAS,cAAc,WAAW,qBAAqB;;;;;;;;UAYrE;;EAEhB,UAAU;;EAEV;;;cAIY,qCAAmB,QAAA;;;;;;;;;;;;iBAahB,iBAAiB,SAAS,cAAc,UAAU,eAAe"}

package/lib/emails/theme.js CHANGED Viewed

@@ -17,6 +17,13 @@ import { createContext, createElement } from "react";
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
+/**
+* @fileoverview Email theming system — the resolved `EmailTheme` shape, override
+* merging, the Tailwind config builder, and React contexts carrying the active theme
+* and per-send message policy.
+*
+* @module @resq-systems/email-templates/emails/theme
+*/
 /** The default ResQ Systems brand theme (dark-first, red primary, Syne/DM Sans/DM Mono). */
 const defaultEmailTheme = {
 	colors: { ...emailColors },
@@ -28,7 +35,19 @@ const defaultEmailTheme = {
 	org: { ...emailOrg },
 	fontsHref: emailFonts.googleFontsHref
 };
-/** Merge an override onto a base theme (colors/fonts shallow-merge; `fontsHref: null` removes it). */
+/**
+* Merge an override onto a base theme, producing a new resolved theme.
+*
+* Pure — never mutates `base`. `colors`, `fonts`, and `org` are **shallow**-merged
+* (override keys replace base keys one level deep), so a partial `fonts` override
+* keeps the base's other stacks. `fontsHref` follows a three-way rule: `null`
+* drops the webfont link entirely, absent/`undefined` keeps the base href, and any
+* string replaces it.
+*
+* @param base - The theme to start from.
+* @param override - Fields to overlay; when omitted, `base` is returned by reference.
+* @returns The merged theme, or `base` itself when there is no override.
+*/
 function resolveEmailTheme(base, override) {
 	if (!override) return base;
 	return {
@@ -47,11 +66,28 @@ function resolveEmailTheme(base, override) {
 		fontsHref: override.fontsHref === null ? void 0 : override.fontsHref ?? base.fontsHref
 	};
 }
-/** Merge an override onto the default ResQ Systems theme. */
+/**
+* Merge an override onto the default ResQ Systems theme.
+*
+* Pure convenience wrapper over {@link resolveEmailTheme} with
+* {@link defaultEmailTheme} as the base.
+*
+* @param override - Fields to overlay on the default theme.
+* @returns The resolved theme.
+*/
 function mergeEmailTheme(override) {
 	return resolveEmailTheme(defaultEmailTheme, override);
 }
-/** Build the `<Tailwind config>` object from a resolved theme. */
+/**
+* Build the `<Tailwind config>` object from a resolved theme.
+*
+* Pure — projects the theme's colors and font stacks into a Tailwind
+* `theme.extend` config atop the pixel-based preset (email clients need px units,
+* not rem).
+*
+* @param theme - The resolved theme to project.
+* @returns The config object to pass to react-email's `<Tailwind>`.
+*/
 function buildTailwindConfig(theme) {
 	return {
 		presets: [pixelBasedPreset],
@@ -71,6 +107,12 @@ const EmailThemeContext = createContext(defaultEmailTheme);
 * Wrap an element so it renders against a theme override (used by `renderEmail`).
 * Returns the element unchanged when there is no override, so the default theme
 * flows through context.
+*
+* Pure — builds a new provider element and does not mutate `element`.
+*
+* @param element - The email element tree to wrap.
+* @param override - Theme fields to overlay; when omitted, `element` is returned unchanged.
+* @returns `element`, wrapped in an {@link EmailThemeContext} provider when an override is given.
 */
 function withEmailTheme(element, override) {
 	if (!override) return element;
@@ -82,6 +124,12 @@ const EmailMessageContext = createContext({ category: "transactional" });
 * Wrap an element so it renders against a message policy (used by `renderEmail`).
 * Returns the element unchanged when no message is given, so the default
 * transactional policy flows through context.
+*
+* Pure — builds a new provider element and does not mutate `element`.
+*
+* @param element - The email element tree to wrap.
+* @param message - The per-send policy; when omitted, `element` is returned unchanged.
+* @returns `element`, wrapped in an {@link EmailMessageContext} provider when a message is given.
 */
 function withEmailMessage(element, message) {
 	if (!message) return element;

package/lib/emails/theme.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"theme.js","names":[],"sources":["../../src/emails/theme.tsx"],"sourcesContent":["/*\n Copyright 2026 ResQ Systems, Inc.\n \n Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { pixelBasedPreset } from \"@react-email/components\";\nimport { type ReactElement, createContext, createElement } from \"react\";\nimport type { EmailCategory } from \"../schemas.js\";\nimport { emailColors, emailFonts, emailOrg } from \"./tokens.js\";\n\nexport interface EmailThemeFonts {\n\tdisplay: string[];\n\tsans: string[];\n\tmono: string[];\n}\n\n/* Organization identity rendered into email chrome (header, signature, footer). /\nexport interface EmailOrgIdentity {\n\tbrandName: string;\n\tproductName: string;\n\tlegalName: string;\n\tregisteredAddress: string;\n\tsupportEmail: string;\n\twebsiteUrl: string;\n\ttermsUrl: string;\n\tprivacyUrl: string;\n\tlogoUrl: string;\n}\n\n/* The full, resolved theme every template renders against. /\nexport interface EmailTheme {\n\t/* Color tokens → Tailwind `theme.extend.colors` (email-safe hex). /\n\tcolors: Record<string, string>;\n\t/* Font stacks → Tailwind `theme.extend.fontFamily` (pre-quoted multi-word names). /\n\tfonts: EmailThemeFonts;\n\t/* Organization identity for header lockup, signatures, and legal footer. /\n\torg: EmailOrgIdentity;\n\t/* Optional stylesheet `<link>` injected in `<Head>` for brand webfonts. /\n\tfontsHref?: string;\n}\n\n/* A partial theme a consumer supplies to rebrand; unset keys fall back to the base. /\nexport interface EmailThemeOverride {\n\tcolors?: Record<string, string>;\n\tfonts?: Partial<EmailThemeFonts>;\n\t/* Override organization identity fields (shallow-merged over the base). /\n\torg?: Partial<EmailOrgIdentity>;\n\t/* Pass `null` to drop the webfont link entirely. /\n\tfontsHref?: string \| null;\n}\n\n/* The default ResQ Systems brand theme (dark-first, red primary, Syne/DM Sans/DM Mono). /\nexport const defaultEmailTheme: EmailTheme = {\n\tcolors: { ...emailColors },\n\tfonts: {\n\t\tdisplay: [...emailFonts.stacks.display],\n\t\tsans: [...emailFonts.stacks.body],\n\t\tmono: [...emailFonts.stacks.mono],\n\t},\n\torg: { ...emailOrg },\n\tfontsHref: emailFonts.googleFontsHref,\n};\n\n/* Merge an override onto a base theme (colors/fonts shallow-merge; `fontsHref: null` removes it). /\nexport function resolveEmailTheme(base: EmailTheme, override?: EmailThemeOverride): EmailTheme {\n\tif (!override) return base;\n\treturn {\n\t\tcolors: { ...base.colors, ...override.colors },\n\t\tfonts: { ...base.fonts, ...override.fonts },\n\t\torg: { ...base.org, ...override.org },\n\t\tfontsHref: override.fontsHref === null ? undefined : (override.fontsHref ?? base.fontsHref),\n\t};\n}\n\n/* Merge an override onto the default ResQ Systems theme. /\nexport function mergeEmailTheme(override?: EmailThemeOverride): EmailTheme {\n\treturn resolveEmailTheme(defaultEmailTheme, override);\n}\n\n/* Build the `<Tailwind config>` object from a resolved theme. /\nexport function buildTailwindConfig(theme: EmailTheme) {\n\treturn {\n\t\tpresets: [pixelBasedPreset],\n\t\ttheme: {\n\t\t\textend: {\n\t\t\t\tcolors: { ...theme.colors },\n\t\t\t\tfontFamily: {\n\t\t\t\t\tdisplay: [...theme.fonts.display],\n\t\t\t\t\tsans: [...theme.fonts.sans],\n\t\t\t\t\tmono: [...theme.fonts.mono],\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t};\n}\n\n/* Context carrying the active theme; defaults to the ResQ Systems brand. /\nexport const EmailThemeContext = createContext<EmailTheme>(defaultEmailTheme);\n\n/\n Wrap an element so it renders against a theme override (used by `renderEmail`).\n * Returns the element unchanged when there is no override, so the default theme\n * flows through context.\n /\nexport function withEmailTheme(element: ReactElement, override?: EmailThemeOverride): ReactElement {\n\tif (!override) return element;\n\treturn createElement(EmailThemeContext.Provider, { value: mergeEmailTheme(override) }, element);\n}\n\n/* Per-send message policy carried through context to the legal footer. /\nexport interface EmailMessage {\n\t/* Compliance class; defaults to `transactional`. /\n\tcategory: EmailCategory;\n\t/* Where the unsubscribe/preferences link points (used for `marketing`). /\n\tunsubscribeUrl?: string;\n}\n\n/* Context carrying the active message policy; defaults to a transactional send. /\nexport const EmailMessageContext = createContext<EmailMessage>({ category: \"transactional\" });\n\n/\n Wrap an element so it renders against a message policy (used by `renderEmail`).\n * Returns the element unchanged when no message is given, so the default\n * transactional policy flows through context.\n */\nexport function withEmailMessage(element: ReactElement, message?: EmailMessage): ReactElement {\n\tif (!message) return element;\n\treturn createElement(EmailMessageContext.Provider, { value: message }, element);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA+DA,MAAa,oBAAgC;CAC5C,QAAQ,EAAE,GAAG,YAAY;CACzB,OAAO;EACN,SAAS,CAAC,GAAG,WAAW,OAAO,OAAO;EACtC,MAAM,CAAC,GAAG,WAAW,OAAO,IAAI;EAChC,MAAM,CAAC,GAAG,WAAW,OAAO,IAAI;CACjC;CACA,KAAK,EAAE,GAAG,SAAS;CACnB,WAAW,WAAW;AACvB;;AAGA,SAAgB,kBAAkB,MAAkB,UAA2C;CAC9F,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO;EACN,QAAQ;GAAE,GAAG,KAAK;GAAQ,GAAG,SAAS;EAAO;EAC7C,OAAO;GAAE,GAAG,KAAK;GAAO,GAAG,SAAS;EAAM;EAC1C,KAAK;GAAE,GAAG,KAAK;GAAK,GAAG,SAAS;EAAI;EACpC,WAAW,SAAS,cAAc,OAAO,KAAA,IAAa,SAAS,aAAa,KAAK;CAClF;AACD;;AAGA,SAAgB,gBAAgB,UAA2C;CAC1E,OAAO,kBAAkB,mBAAmB,QAAQ;AACrD;;AAGA,SAAgB,oBAAoB,OAAmB;CACtD,OAAO;EACN,SAAS,CAAC,gBAAgB;EAC1B,OAAO,EACN,QAAQ;GACP,QAAQ,EAAE,GAAG,MAAM,OAAO;GAC1B,YAAY;IACX,SAAS,CAAC,GAAG,MAAM,MAAM,OAAO;IAChC,MAAM,CAAC,GAAG,MAAM,MAAM,IAAI;IAC1B,MAAM,CAAC,GAAG,MAAM,MAAM,IAAI;GAC3B;EACD,EACD;CACD;AACD;;AAGA,MAAa,oBAAoB,cAA0B,iBAAiB;;;;;;AAO5E,SAAgB,eAAe,SAAuB,UAA6C;CAClG,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO,cAAc,kBAAkB,UAAU,EAAE,OAAO,gBAAgB,QAAQ,EAAE,GAAG,OAAO;AAC/F;;AAWA,MAAa,sBAAsB,cAA4B,EAAE,UAAU,gBAAgB,CAAC;;;;;;AAO5F,SAAgB,iBAAiB,SAAuB,SAAsC;CAC7F,IAAI,CAAC,SAAS,OAAO;CACrB,OAAO,cAAc,oBAAoB,UAAU,EAAE,OAAO,QAAQ,GAAG,OAAO;AAC/E"}
1	+ {"version":3,"file":"theme.js","names":[],"sources":["../../src/emails/theme.tsx"],"sourcesContent":["/*\n Copyright 2026 ResQ Systems, Inc.\n \n Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\n/\n @fileoverview Email theming system — the resolved `EmailTheme` shape, override\n * merging, the Tailwind config builder, and React contexts carrying the active theme\n * and per-send message policy.\n \n @module @resq-systems/email-templates/emails/theme\n /\n\nimport { pixelBasedPreset } from \"@react-email/components\";\nimport { type ReactElement, createContext, createElement } from \"react\";\nimport type { EmailCategory } from \"../schemas.js\";\nimport { emailColors, emailFonts, emailOrg } from \"./tokens.js\";\n\n//#region Types\n\n/\n Font stacks the theme exposes to Tailwind's `fontFamily` extension. Each array\n * is a CSS font-family stack in priority order (preferred face first, generic\n * fallback last); multi-word names are pre-quoted so they drop straight into a\n * `font-family` value.\n /\nexport interface EmailThemeFonts {\n\t/* Stack for display/heading text. /\n\tdisplay: string[];\n\t/* Stack for body/sans text. /\n\tsans: string[];\n\t/* Stack for monospace text (codes, metadata). /\n\tmono: string[];\n}\n\n/\n Organization identity rendered into email chrome (header, signature, footer).\n \n All `Url` fields are absolute URLs. {@link EmailOrgIdentity.registeredAddress}\n leads with the legal entity name, so it stands alone as a complete CAN-SPAM\n * postal line without a separate `legalName` line in the footer.\n /\nexport interface EmailOrgIdentity {\n\t/* Short brand name used in sign-offs, e.g. \"— The {brandName} team\". /\n\tbrandName: string;\n\t/* Product name shown in the header lockup beside the logo. /\n\tproductName: string;\n\t/* Full legal entity name. /\n\tlegalName: string;\n\t/* Registered postal address, prefixed with the legal name; a complete CAN-SPAM line. /\n\tregisteredAddress: string;\n\t/* Support inbox address, rendered as a `mailto:` link. /\n\tsupportEmail: string;\n\t/* Marketing/website URL (absolute). Never used as an unsubscribe target. /\n\twebsiteUrl: string;\n\t/* Absolute URL of the Terms page. /\n\ttermsUrl: string;\n\t/* Absolute URL of the Privacy page. /\n\tprivacyUrl: string;\n\t/* Absolute URL of the header logo image. /\n\tlogoUrl: string;\n}\n\n/* The full, resolved theme every template renders against. /\nexport interface EmailTheme {\n\t/* Color tokens → Tailwind `theme.extend.colors` (email-safe hex). /\n\tcolors: Record<string, string>;\n\t/* Font stacks → Tailwind `theme.extend.fontFamily` (pre-quoted multi-word names). /\n\tfonts: EmailThemeFonts;\n\t/* Organization identity for header lockup, signatures, and legal footer. /\n\torg: EmailOrgIdentity;\n\t/* Optional stylesheet `<link>` injected in `<Head>` for brand webfonts. /\n\tfontsHref?: string;\n}\n\n/\n A partial theme a consumer supplies to rebrand; unset keys fall back to the\n * base. All object fields are shallow-merged over the base one level deep (see\n * {@link resolveEmailTheme}), so supplying `colors` replaces only the named color\n * tokens, not the whole palette.\n /\nexport interface EmailThemeOverride {\n\t/* Color tokens to override (email-safe hex); merged over the base palette. /\n\tcolors?: Record<string, string>;\n\t/* Font stacks to override; unspecified stacks keep the base. /\n\tfonts?: Partial<EmailThemeFonts>;\n\t/* Override organization identity fields (shallow-merged over the base). /\n\torg?: Partial<EmailOrgIdentity>;\n\t/* Replace the webfont `<link>` href, or pass `null` to drop it entirely. /\n\tfontsHref?: string \| null;\n}\n\n//#endregion\n\n//#region Public API\n\n/* The default ResQ Systems brand theme (dark-first, red primary, Syne/DM Sans/DM Mono). /\nexport const defaultEmailTheme: EmailTheme = {\n\tcolors: { ...emailColors },\n\tfonts: {\n\t\tdisplay: [...emailFonts.stacks.display],\n\t\tsans: [...emailFonts.stacks.body],\n\t\tmono: [...emailFonts.stacks.mono],\n\t},\n\torg: { ...emailOrg },\n\tfontsHref: emailFonts.googleFontsHref,\n};\n\n/\n Merge an override onto a base theme, producing a new resolved theme.\n \n Pure — never mutates `base`. `colors`, `fonts`, and `org` are shallow-merged\n * (override keys replace base keys one level deep), so a partial `fonts` override\n * keeps the base's other stacks. `fontsHref` follows a three-way rule: `null`\n * drops the webfont link entirely, absent/`undefined` keeps the base href, and any\n * string replaces it.\n \n @param base - The theme to start from.\n * @param override - Fields to overlay; when omitted, `base` is returned by reference.\n * @returns The merged theme, or `base` itself when there is no override.\n /\nexport function resolveEmailTheme(base: EmailTheme, override?: EmailThemeOverride): EmailTheme {\n\tif (!override) return base;\n\treturn {\n\t\tcolors: { ...base.colors, ...override.colors },\n\t\tfonts: { ...base.fonts, ...override.fonts },\n\t\torg: { ...base.org, ...override.org },\n\t\tfontsHref: override.fontsHref === null ? undefined : (override.fontsHref ?? base.fontsHref),\n\t};\n}\n\n/\n Merge an override onto the default ResQ Systems theme.\n \n Pure convenience wrapper over {@link resolveEmailTheme} with\n * {@link defaultEmailTheme} as the base.\n \n @param override - Fields to overlay on the default theme.\n * @returns The resolved theme.\n /\nexport function mergeEmailTheme(override?: EmailThemeOverride): EmailTheme {\n\treturn resolveEmailTheme(defaultEmailTheme, override);\n}\n\n/\n Build the `<Tailwind config>` object from a resolved theme.\n \n Pure — projects the theme's colors and font stacks into a Tailwind\n * `theme.extend` config atop the pixel-based preset (email clients need px units,\n * not rem).\n \n @param theme - The resolved theme to project.\n * @returns The config object to pass to react-email's `<Tailwind>`.\n /\nexport function buildTailwindConfig(theme: EmailTheme) {\n\treturn {\n\t\tpresets: [pixelBasedPreset],\n\t\ttheme: {\n\t\t\textend: {\n\t\t\t\tcolors: { ...theme.colors },\n\t\t\t\tfontFamily: {\n\t\t\t\t\tdisplay: [...theme.fonts.display],\n\t\t\t\t\tsans: [...theme.fonts.sans],\n\t\t\t\t\tmono: [...theme.fonts.mono],\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t};\n}\n\n/* Context carrying the active theme; defaults to the ResQ Systems brand. /\nexport const EmailThemeContext = createContext<EmailTheme>(defaultEmailTheme);\n\n/\n Wrap an element so it renders against a theme override (used by `renderEmail`).\n * Returns the element unchanged when there is no override, so the default theme\n * flows through context.\n \n Pure — builds a new provider element and does not mutate `element`.\n \n @param element - The email element tree to wrap.\n * @param override - Theme fields to overlay; when omitted, `element` is returned unchanged.\n * @returns `element`, wrapped in an {@link EmailThemeContext} provider when an override is given.\n /\nexport function withEmailTheme(element: ReactElement, override?: EmailThemeOverride): ReactElement {\n\tif (!override) return element;\n\treturn createElement(EmailThemeContext.Provider, { value: mergeEmailTheme(override) }, element);\n}\n\n/\n Per-send message policy carried through context to the legal footer.\n \n The unsubscribe affordance renders only when {@link EmailMessage.category} is\n * `\"marketing\"` and {@link EmailMessage.unsubscribeUrl} is set; a marketing\n * send with no `unsubscribeUrl` simply omits it (there is no homepage fallback).\n /\nexport interface EmailMessage {\n\t/* Compliance class; defaults to `transactional`. /\n\tcategory: EmailCategory;\n\t/* Absolute unsubscribe/preferences URL; only consulted for `marketing` sends. /\n\tunsubscribeUrl?: string;\n}\n\n/* Context carrying the active message policy; defaults to a transactional send. /\nexport const EmailMessageContext = createContext<EmailMessage>({ category: \"transactional\" });\n\n/\n Wrap an element so it renders against a message policy (used by `renderEmail`).\n * Returns the element unchanged when no message is given, so the default\n * transactional policy flows through context.\n \n Pure — builds a new provider element and does not mutate `element`.\n \n @param element - The email element tree to wrap.\n * @param message - The per-send policy; when omitted, `element` is returned unchanged.\n * @returns `element`, wrapped in an {@link EmailMessageContext} provider when a message is given.\n */\nexport function withEmailMessage(element: ReactElement, message?: EmailMessage): ReactElement {\n\tif (!message) return element;\n\treturn createElement(EmailMessageContext.Provider, { value: message }, element);\n}\n\n//#endregion\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA4GA,MAAa,oBAAgC;CAC5C,QAAQ,EAAE,GAAG,YAAY;CACzB,OAAO;EACN,SAAS,CAAC,GAAG,WAAW,OAAO,OAAO;EACtC,MAAM,CAAC,GAAG,WAAW,OAAO,IAAI;EAChC,MAAM,CAAC,GAAG,WAAW,OAAO,IAAI;CACjC;CACA,KAAK,EAAE,GAAG,SAAS;CACnB,WAAW,WAAW;AACvB;;;;;;;;;;;;;;AAeA,SAAgB,kBAAkB,MAAkB,UAA2C;CAC9F,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO;EACN,QAAQ;GAAE,GAAG,KAAK;GAAQ,GAAG,SAAS;EAAO;EAC7C,OAAO;GAAE,GAAG,KAAK;GAAO,GAAG,SAAS;EAAM;EAC1C,KAAK;GAAE,GAAG,KAAK;GAAK,GAAG,SAAS;EAAI;EACpC,WAAW,SAAS,cAAc,OAAO,KAAA,IAAa,SAAS,aAAa,KAAK;CAClF;AACD;;;;;;;;;;AAWA,SAAgB,gBAAgB,UAA2C;CAC1E,OAAO,kBAAkB,mBAAmB,QAAQ;AACrD;;;;;;;;;;;AAYA,SAAgB,oBAAoB,OAAmB;CACtD,OAAO;EACN,SAAS,CAAC,gBAAgB;EAC1B,OAAO,EACN,QAAQ;GACP,QAAQ,EAAE,GAAG,MAAM,OAAO;GAC1B,YAAY;IACX,SAAS,CAAC,GAAG,MAAM,MAAM,OAAO;IAChC,MAAM,CAAC,GAAG,MAAM,MAAM,IAAI;IAC1B,MAAM,CAAC,GAAG,MAAM,MAAM,IAAI;GAC3B;EACD,EACD;CACD;AACD;;AAGA,MAAa,oBAAoB,cAA0B,iBAAiB;;;;;;;;;;;;AAa5E,SAAgB,eAAe,SAAuB,UAA6C;CAClG,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO,cAAc,kBAAkB,UAAU,EAAE,OAAO,gBAAgB,QAAQ,EAAE,GAAG,OAAO;AAC/F;;AAiBA,MAAa,sBAAsB,cAA4B,EAAE,UAAU,gBAAgB,CAAC;;;;;;;;;;;;AAa5F,SAAgB,iBAAiB,SAAuB,SAAsC;CAC7F,IAAI,CAAC,SAAS,OAAO;CACrB,OAAO,cAAc,oBAAoB,UAAU,EAAE,OAAO,QAAQ,GAAG,OAAO;AAC/E"}

package/lib/emails/tokens.d.ts CHANGED Viewed

@@ -43,6 +43,7 @@ declare const emailFonts: {
   };
   readonly googleFontsHref: "https://fonts.googleapis.com/css2?family=Syne:wght@700;800&family=DM+Sans:wght@400;500&family=DM+Mono:wght@500&display=swap";
 };
+/** Union of the available email-safe color token names. */
 type EmailColorToken = keyof typeof emailColors;
 /**
  * Organization identity for email chrome (header lockup, signatures, legal
@@ -54,7 +55,7 @@ declare const emailOrg: {
   readonly productName: "ResQ Tactical OS";
   readonly legalName: "ResQ Systems, Inc.";
   readonly registeredAddress: "ResQ Systems, Inc., 131 Continental Dr, Suite 305, Newark, DE 19713, USA";
-  readonly supportEmail: "support@resq.software";
+  readonly supportEmail: "contact@resq.software";
   readonly websiteUrl: "https://resq.software";
   readonly termsUrl: "https://resq.software/legal/terms";
   readonly privacyUrl: "https://resq.software/legal/privacy";

package/lib/emails/tokens.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"tokens.d.ts","names":[],"sources":["../../src/emails/tokens.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;~~cAwBa~~;;;;;;;;;;;;;cAGA~~;;;;;;;;;;;KAED~~,+BAA+B;;;;;;cAO9B;WACZ;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA"}
1	+ {"version":3,"file":"tokens.d.ts","names":[],"sources":["../../src/emails/tokens.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cAgCa;;;;;;;;;;;;;cAGA;;;;;;;;;;;;KAGD,+BAA+B;;;;;;cAO9B;WACZ;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA"}

package/lib/emails/tokens.js CHANGED Viewed

@@ -17,6 +17,13 @@ import { colors, fonts } from "@resq-systems/constants/tokens";
 * limitations under the License.
 */
 /**
+* @fileoverview Email-safe brand tokens — the hex color palette, font stacks, and
+* organization identity, sourced from `@resq-systems/constants` so branding stays
+* centralized across apps.
+*
+* @module @resq-systems/email-templates/emails/tokens
+*/
+/**
 * Email-safe hex color tokens, sourced from the shared `@resq-systems/constants`
 * design tokens so the brand palette lives in one place across apps. Email
 * clients don't support `oklch()`, so the hex snapshot is used here.

package/lib/emails/tokens.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"tokens.js","names":[],"sources":["../../src/emails/tokens.ts"],"sourcesContent":["/*\n Copyright 2026 ResQ Systems, Inc.\n \n Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { brand } from \"@resq-systems/constants/brand\";\nimport { colors, fonts } from \"@resq-systems/constants/tokens\";\n\n/\n Email-safe hex color tokens, sourced from the shared `@resq-systems/constants`\n * design tokens so the brand palette lives in one place across apps. Email\n * clients don't support `oklch()`, so the hex snapshot is used here.\n /\nexport const emailColors = colors.hex;\n\n/* Brand font stacks + webfont stylesheet href, from the shared design tokens. /\nexport const emailFonts = fonts;\n\nexport type EmailColorToken = keyof typeof emailColors;\n\n/\n Organization identity for email chrome (header lockup, signatures, legal\n * footer), derived from the shared `@resq-systems/constants` brand so names,\n * addresses, and legal URLs live in one place across apps.\n */\nexport const emailOrg = {\n\tbrandName: brand.name,\n\tproductName: brand.productName,\n\tlegalName: brand.legalName,\n\tregisteredAddress: brand.postalAddress,\n\tsupportEmail: brand.email.support,\n\twebsiteUrl: brand.domains.marketing,\n\ttermsUrl: brand.legal.termsUrl,\n\tprivacyUrl: brand.legal.privacyUrl,\n\tlogoUrl: brand.logo,\n} as const;\n"],"mappings":"~~;;;;;;;;;;;;;;;;;;;;;;;AAwBA~~,MAAa,cAAc,OAAO;;AAGlC,MAAa,aAAa;;;;;;~~AAS1B~~,MAAa,WAAW;CACvB,WAAW,MAAM;CACjB,aAAa,MAAM;CACnB,WAAW,MAAM;CACjB,mBAAmB,MAAM;CACzB,cAAc,MAAM,MAAM;CAC1B,YAAY,MAAM,QAAQ;CAC1B,UAAU,MAAM,MAAM;CACtB,YAAY,MAAM,MAAM;CACxB,SAAS,MAAM;AAChB"}
1	+ {"version":3,"file":"tokens.js","names":[],"sources":["../../src/emails/tokens.ts"],"sourcesContent":["/*\n Copyright 2026 ResQ Systems, Inc.\n \n Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\n/\n @fileoverview Email-safe brand tokens — the hex color palette, font stacks, and\n * organization identity, sourced from `@resq-systems/constants` so branding stays\n * centralized across apps.\n \n @module @resq-systems/email-templates/emails/tokens\n /\n\nimport { brand } from \"@resq-systems/constants/brand\";\nimport { colors, fonts } from \"@resq-systems/constants/tokens\";\n\n/\n Email-safe hex color tokens, sourced from the shared `@resq-systems/constants`\n * design tokens so the brand palette lives in one place across apps. Email\n * clients don't support `oklch()`, so the hex snapshot is used here.\n /\nexport const emailColors = colors.hex;\n\n/* Brand font stacks + webfont stylesheet href, from the shared design tokens. /\nexport const emailFonts = fonts;\n\n/* Union of the available email-safe color token names. /\nexport type EmailColorToken = keyof typeof emailColors;\n\n/\n Organization identity for email chrome (header lockup, signatures, legal\n * footer), derived from the shared `@resq-systems/constants` brand so names,\n * addresses, and legal URLs live in one place across apps.\n */\nexport const emailOrg = {\n\tbrandName: brand.name,\n\tproductName: brand.productName,\n\tlegalName: brand.legalName,\n\tregisteredAddress: brand.postalAddress,\n\tsupportEmail: brand.email.support,\n\twebsiteUrl: brand.domains.marketing,\n\ttermsUrl: brand.legal.termsUrl,\n\tprivacyUrl: brand.legal.privacyUrl,\n\tlogoUrl: brand.logo,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,MAAa,cAAc,OAAO;;AAGlC,MAAa,aAAa;;;;;;AAU1B,MAAa,WAAW;CACvB,WAAW,MAAM;CACjB,aAAa,MAAM;CACnB,WAAW,MAAM;CACjB,mBAAmB,MAAM;CACzB,cAAc,MAAM,MAAM;CAC1B,YAAY,MAAM,QAAQ;CAC1B,UAAU,MAAM,MAAM;CACtB,YAAY,MAAM,MAAM;CACxB,SAAS,MAAM;AAChB"}

package/lib/emails/welcome.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import { WelcomeData } from "../schemas.js";
 //#region src/emails/welcome.d.ts
+/** Props for {@link WelcomeEmail} — the welcome template's validated `data`. */
 type WelcomeEmailProps = WelcomeData;
 /** Account welcome / onboarding email. */
 declare function WelcomeEmail({ firstName, verifyUrl }: WelcomeEmailProps): import("react").JSX.Element;

package/lib/emails/welcome.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"welcome.d.ts","names":[],"sources":["../../src/emails/welcome.tsx"],"mappings":"~~;;KAmBY~~,oBAAoB;;iBAGhB,eAAe,WAAqB,aAAa,oCAAiB,IAAA"}
1	+ {"version":3,"file":"welcome.d.ts","names":[],"sources":["../../src/emails/welcome.tsx"],"mappings":";;;KA0BY,oBAAoB;;iBAGhB,eAAe,WAAqB,aAAa,oCAAiB,IAAA"}

package/lib/emails/welcome.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"welcome.js","names":[],"sources":["../../src/emails/welcome.tsx"],"sourcesContent":["/*\n Copyright 2026 ResQ Systems, Inc.\n \n Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport type { WelcomeData } from \"../schemas.js\";\nimport { Email } from \"./primitives.js\";\n\nexport type WelcomeEmailProps = WelcomeData;\n\n/* Account welcome / onboarding email. */\nexport function WelcomeEmail({ firstName = \"there\", verifyUrl }: WelcomeEmailProps) {\n\treturn (\n\t\t<Email.Shell preview={`Welcome to ResQ Systems, ${firstName}`}>\n\t\t\t<Email.Header />\n\t\t\t<Email.Title>Welcome to ResQ Systems</Email.Title>\n\t\t\t<Email.Paragraph>Hi {firstName},</Email.Paragraph>\n\t\t\t<Email.Paragraph>\n\t\t\t\tThanks for creating an account. Everything is set up and ready when you are.\n\t\t\t</Email.Paragraph>\n\t\t\t{verifyUrl ? (\n\t\t\t\t<>\n\t\t\t\t\t<Email.Paragraph>\n\t\t\t\t\t\tConfirm your email address to finish setting up your account.\n\t\t\t\t\t</Email.Paragraph>\n\t\t\t\t\t<Email.CTA href={verifyUrl}>Verify email</Email.CTA>\n\t\t\t\t</>\n\t\t\t) : null}\n\t\t\t<Email.Signature />\n\t\t\t<Email.LegalFooter\n\t\t\t\tcategory=\"transactional\"\n\t\t\t\treason=\"You are receiving this email because you created a ResQ Systems account.\"\n\t\t\t/>\n\t\t</Email.Shell>\n\t);\n}\n"],"mappings":";;;;~~AAsBA~~,SAAgB,aAAa,EAAE,YAAY,SAAS,aAAgC;CACnF,OACC,qBAAC,MAAM,OAAP;EAAa,SAAS,4BAA4B;~~YAAlD~~;GACC,oBAAC,MAAM,QAAP,CAAe,CAAA;GACf,oBAAC,MAAM,OAAP,EAAA,UAAa,0BAAoC,CAAA;GACjD,qBAAC,MAAM,WAAP,EAAA,UAAA;IAAiB;IAAI;IAAU;GAAkB,EAAA,CAAA;GACjD,oBAAC,MAAM,WAAP,EAAA,UAAiB,+EAEA,CAAA;GAChB,YACA,qBAAA,UAAA,EAAA,UAAA,CACC,oBAAC,MAAM,WAAP,EAAA,UAAiB,gEAEA,CAAA,GACjB,oBAAC,MAAM,KAAP;IAAW,MAAM;~~cAAW~~;GAAuB,CAAA,CAClD,EAAA,CAAA,IACC;GACJ,oBAAC,MAAM,WAAP,CAAkB,CAAA;GAClB,oBAAC,MAAM,aAAP;IACC,UAAS;IACT,QAAO;GACP,CAAA;EACW;;AAEf"}
1	+ {"version":3,"file":"welcome.js","names":[],"sources":["../../src/emails/welcome.tsx"],"sourcesContent":["/*\n Copyright 2026 ResQ Systems, Inc.\n \n Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\n/\n @fileoverview Account welcome / onboarding email component.\n \n @module @resq-systems/email-templates/emails/welcome\n /\n\nimport type { WelcomeData } from \"../schemas.js\";\nimport { Email } from \"./primitives.js\";\n\n/* Props for {@link WelcomeEmail} — the welcome template's validated `data`. /\nexport type WelcomeEmailProps = WelcomeData;\n\n/* Account welcome / onboarding email. */\nexport function WelcomeEmail({ firstName = \"there\", verifyUrl }: WelcomeEmailProps) {\n\treturn (\n\t\t<Email.Shell preview={`Welcome to ResQ Systems, ${firstName}`}>\n\t\t\t<Email.Header />\n\t\t\t<Email.Title>Welcome to ResQ Systems</Email.Title>\n\t\t\t<Email.Paragraph>Hi {firstName},</Email.Paragraph>\n\t\t\t<Email.Paragraph>\n\t\t\t\tThanks for creating an account. Everything is set up and ready when you are.\n\t\t\t</Email.Paragraph>\n\t\t\t{verifyUrl ? (\n\t\t\t\t<>\n\t\t\t\t\t<Email.Paragraph>\n\t\t\t\t\t\tConfirm your email address to finish setting up your account.\n\t\t\t\t\t</Email.Paragraph>\n\t\t\t\t\t<Email.CTA href={verifyUrl}>Verify email</Email.CTA>\n\t\t\t\t</>\n\t\t\t) : null}\n\t\t\t<Email.Signature />\n\t\t\t<Email.LegalFooter\n\t\t\t\tcategory=\"transactional\"\n\t\t\t\treason=\"You are receiving this email because you created a ResQ Systems account.\"\n\t\t\t/>\n\t\t</Email.Shell>\n\t);\n}\n"],"mappings":";;;;AA6BA,SAAgB,aAAa,EAAE,YAAY,SAAS,aAAgC;CACnF,OACC,qBAAC,MAAM,OAAP;EAAa,SAAS,4BAA4B;EAAlD,UAAA;GACC,oBAAC,MAAM,QAAP,CAAe,CAAA;GACf,oBAAC,MAAM,OAAP,EAAA,UAAa,0BAAoC,CAAA;GACjD,qBAAC,MAAM,WAAP,EAAA,UAAA;IAAiB;IAAI;IAAU;GAAkB,EAAA,CAAA;GACjD,oBAAC,MAAM,WAAP,EAAA,UAAiB,+EAEA,CAAA;GAChB,YACA,qBAAA,UAAA,EAAA,UAAA,CACC,oBAAC,MAAM,WAAP,EAAA,UAAiB,gEAEA,CAAA,GACjB,oBAAC,MAAM,KAAP;IAAW,MAAM;IAAW,UAAA;GAAuB,CAAA,CAClD,EAAA,CAAA,IACC;GACJ,oBAAC,MAAM,WAAP,CAAkB,CAAA;GAClB,oBAAC,MAAM,aAAP;IACC,UAAS;IACT,QAAO;GACP,CAAA;EACW;;AAEf"}

package/lib/index.d.ts CHANGED Viewed

@@ -5,4 +5,4 @@ import { EmailName, EmailPayload, EmailTemplateData, decodeEmailPayload } from "
 import { registry } from "./registry.js";
 import { renderEmail } from "./render.js";
 import { incidentAlertTemplate, missionApprovalTemplate, newDeviceLoginTemplate, notificationTemplate, orgInvitationTemplate, otpTemplate, passwordChangedTemplate, passwordResetTemplate, resqEmailTemplates, welcomeTemplate } from "./templates.js";
-export { EmailAddress, EmailCategory, EmailMessage, EmailMessageContext, EmailName, EmailOrgIdentity, EmailPayload, type EmailRegistryEntry, EmailTemplateData, type EmailTemplateDef, EmailTheme, EmailThemeContext, EmailThemeFonts, EmailThemeOverride, EmailValidationError, HttpUrl, IncidentAlertData, type Mailer, type MailerPayload, type MailerTemplateData, MissionApprovalData, NewDeviceLoginData, NotificationData, OrgInvitationData, OtpData, PasswordChangedData, PasswordResetData, type RenderEmailOptions, type RenderedEmail, WelcomeData, buildTailwindConfig, createMailer, decodeEmailPayload, defaultEmailTheme, defineEmailTemplate, emailCategory, incidentAlertData, incidentAlertTemplate, mergeEmailTheme, missionApprovalData, missionApprovalTemplate, newDeviceLoginData, newDeviceLoginTemplate, notificationData, notificationTemplate, orgInvitationData, orgInvitationTemplate, otpData, otpTemplate, passwordChangedData, passwordChangedTemplate, passwordResetData, passwordResetTemplate, registry, renderEmail, resolveEmailTheme, resqEmailTemplates, welcomeData, welcomeTemplate, withEmailMessage, withEmailTheme };
+export { EmailAddress, type EmailCategory, type EmailMessage, EmailMessageContext, type EmailName, type EmailOrgIdentity, EmailPayload, type EmailRegistryEntry, type EmailTemplateData, type EmailTemplateDef, type EmailTheme, EmailThemeContext, type EmailThemeFonts, type EmailThemeOverride, EmailValidationError, HttpUrl, type IncidentAlertData, type Mailer, type MailerPayload, type MailerTemplateData, type MissionApprovalData, type NewDeviceLoginData, type NotificationData, type OrgInvitationData, type OtpData, type PasswordChangedData, type PasswordResetData, type RenderEmailOptions, type RenderedEmail, type WelcomeData, buildTailwindConfig, createMailer, decodeEmailPayload, defaultEmailTheme, defineEmailTemplate, emailCategory, incidentAlertData, incidentAlertTemplate, mergeEmailTheme, missionApprovalData, missionApprovalTemplate, newDeviceLoginData, newDeviceLoginTemplate, notificationData, notificationTemplate, orgInvitationData, orgInvitationTemplate, otpData, otpTemplate, passwordChangedData, passwordChangedTemplate, passwordResetData, passwordResetTemplate, registry, renderEmail, resolveEmailTheme, resqEmailTemplates, welcomeData, welcomeTemplate, withEmailMessage, withEmailTheme };

package/lib/mailer.d.ts CHANGED Viewed

@@ -3,14 +3,42 @@ import { EmailThemeOverride } from "./emails/theme.js";
 import { Schema } from "effect";
 import { ReactElement } from "react";
 //#region src/mailer.d.ts
-/** A template definition: its name, `data` schema, subject line, and component. */
+/**
+ * A template definition: its discriminant {@link EmailTemplateDef.name}, `data`
+ * schema, subject builder, and React component.
+ *
+ * `name` must be unique across the defs handed to {@link createMailer} — it is the
+ * payload union's discriminant, and a later def with a duplicate name silently
+ * overwrites the earlier one in the registry (last write wins in
+ * `Object.fromEntries`). `subject` and `Component` are only ever invoked with data
+ * that has already cleared `data`'s schema at the decode boundary, so they may
+ * treat every field as valid and should stay pure.
+ *
+ * @template Name - The literal template name (e.g. `"otp"`); the payload discriminant.
+ * @template DataSchema - The Effect Schema whose decoded `Type` is this template's `data`.
+ */
 interface EmailTemplateDef<Name extends string, DataSchema extends Schema.Top> {
+  /** Unique template name; the payload union's discriminant. */
   readonly name: Name;
+  /** Effect Schema that validates this template's `data` at the decode boundary. */
   readonly data: DataSchema;
+  /** Builds the subject line from already-validated `data`. Should be pure. */
   readonly subject: (data: DataSchema["Type"]) => string;
+  /** Renders the email body from already-validated `data`. */
   readonly Component: (data: DataSchema["Type"]) => ReactElement;
 }
-/** Identity helper that infers and preserves a template def's literal types. */
+/**
+ * Identity helper that infers and preserves a template def's literal types.
+ *
+ * Pure — returns `def` by reference, unchanged. It exists only so the `const` type
+ * parameters capture the literal `name` and the schema's `Type` at the call site;
+ * a bare object literal would widen `name` to `string` and lose the discriminant.
+ *
+ * @template Name - The literal template name; preserved via the `const` modifier.
+ * @template DataSchema - The template's `data` schema.
+ * @param def - The template definition to brand with its inferred literal types.
+ * @returns The same `def` object, typed with its narrowed literals.
+ */
 declare function defineEmailTemplate<const Name extends string, DataSchema extends Schema.Top>(def: EmailTemplateDef<Name, DataSchema>): EmailTemplateDef<Name, DataSchema>;
 /**
  * The common supertype for a heterogeneous list of template defs. The `never`
@@ -34,18 +62,38 @@ type PayloadFor<Def> = Def extends EmailTemplateDef<infer Name, infer DataSchema
   /** Unsubscribe/preferences URL, surfaced in the legal footer for `marketing`. */
   readonly unsubscribeUrl?: string;
 } : never;
-/** The discriminated payload union for a tuple of template defs. */
+/**
+ * The discriminated payload union for a tuple of template defs — one
+ * `{ name, to, data, category?, unsubscribeUrl? }` variant per def, discriminated
+ * by the literal `name` field. Narrow a value with `payload.name` to recover the
+ * matching `data` type.
+ *
+ * @template Defs - The `as const` tuple of template defs the union is built over.
+ */
 type MailerPayload<Defs extends readonly AnyTemplateDef[]> = PayloadFor<Defs[number]>;
-/** The `data` type for a given template name within a set of defs. */
+/**
+ * The `data` type for a given template name within a set of defs — the `data`
+ * field of the {@link MailerPayload} variant whose discriminant equals `Name`.
+ *
+ * @template Defs - The tuple of template defs the payload union is built over.
+ * @template Name - The literal `name` selecting a single variant's `data` shape.
+ */
 type MailerTemplateData<Defs extends readonly AnyTemplateDef[], Name extends MailerPayload<Defs>["name"]> = Extract<MailerPayload<Defs>, {
   name: Name;
 }>["data"];
-/** The rendered, provider-ready email. */
+/**
+ * The rendered, provider-ready email — the resolved output of
+ * {@link Mailer.renderEmail}. `html` and `text` are two renderings of the *same*
+ * message, so a provider may attach both as a multipart alternative.
+ */
 interface RenderedEmail {
-  /** Validated recipient (branded {@link EmailAddress}), carried from decode. */
+  /** Validated recipient (branded {@link EmailAddress}), carried through from decode. */
   to: EmailAddress;
+  /** The subject line produced by the template's `subject` builder. */
   subject: string;
+  /** The complete standalone HTML document for the email body. */
   html: string;
+  /** The plain-text alternative rendering of the same body, for text-only clients. */
   text: string;
 }
 /** Options for a mailer's `renderEmail`. */
@@ -53,13 +101,30 @@ interface RenderEmailOptions {
   /** Rebrand this render by overriding theme colors/fonts (see `EmailThemeOverride`). */
   theme?: EmailThemeOverride;
 }
-/** Thrown when an untrusted payload fails schema validation at the boundary. */
+/**
+ * Thrown when an untrusted payload fails schema validation at the decode boundary
+ * ({@link Mailer.decode}, and transitively {@link Mailer.renderEmail}).
+ *
+ * The `message` is the squashed Effect `Cause` from the failed decode; `name` is
+ * the stable literal `"EmailValidationError"`, so a caller can tell a bad payload
+ * apart from other failures by `name` without relying on `instanceof` across
+ * module/realm boundaries.
+ */
 declare class EmailValidationError extends Error {
   readonly name = "EmailValidationError";
 }
-/** A registry entry: the subject builder and component renderer for one template. */
+/**
+ * A registry entry: the subject builder and component renderer for one template.
+ *
+ * Both functions take `unknown` because the registry is keyed by name and has
+ * erased each def's `data` type. They must only be called with data that has
+ * already passed that template's schema (as {@link Mailer.renderEmail} does after
+ * {@link Mailer.decode}); calling them with unvalidated data is unsound.
+ */
 interface EmailRegistryEntry {
+  /** Builds the subject from validated `data` (typed `unknown` after name-erasure). */
   subject: (data: unknown) => string;
+  /** Renders the body element from validated `data` (typed `unknown` after name-erasure). */
   render: (data: unknown) => ReactElement;
 }
 /** A composed set of templates: contract schema, decoder, registry, and renderer. */
@@ -72,11 +137,33 @@ interface Mailer<Payload extends {
   readonly schema: Schema.Top;
   /** name → { subject, render } for every template. */
   readonly registry: Record<Payload["name"], EmailRegistryEntry>;
-  /** Every registered template name. */
+  /** Every registered template name, in def order. */
   readonly names: readonly Payload["name"][];
-  /** Validate an untrusted payload (throws {@link EmailValidationError}). */
+  /**
+   * Validate an untrusted payload against the contract union and return the
+   * narrowed {@link Payload}.
+   *
+   * @param input - Untrusted `{ name, to, data }` value from the boundary.
+   * @returns The validated, branded payload.
+   * @throws {EmailValidationError} If `input` matches no template variant — bad
+   *   `name`, a malformed/header-injecting `to`, or `data` failing its schema.
+   */
   decode(input: unknown): Payload;
-  /** Validate then render to `{ to, subject, html, text }` (headless, pipeline-safe). */
+  /**
+   * Validate then render a payload to `{ to, subject, html, text }`.
+   *
+   * Validates via {@link decode} first, then renders headlessly through
+   * `@react-email/render` — no browser, DOM, network, or clock — so it is safe in
+   * queue workers and cron jobs. Pure and stateless: concurrent calls against one
+   * mailer do not interfere, and there is no ordering guarantee between them. Does
+   * not honour an `AbortSignal`.
+   *
+   * @param input - Untrusted payload to validate and render.
+   * @param options - Optional per-render theme override.
+   * @returns A promise resolving to the rendered email.
+   * @throws {EmailValidationError} As a rejected promise, when `input` fails
+   *   validation (surfaced from {@link decode}).
+   */
   renderEmail(input: unknown, options?: RenderEmailOptions): Promise<RenderedEmail>;
 }
 /**
@@ -84,6 +171,26 @@ interface Mailer<Payload extends {
  * `{ name, to, data }` contract, a boundary decoder, a registry, and a headless
  * renderer. Spread the built-in `resqEmailTemplates` and add your own — each
  * template's `data` is validated by its Effect Schema.
+ *
+ * Pure: builds the schema union and registry eagerly and holds no mutable state;
+ * the returned `decode`/`renderEmail` are the only fallible surfaces. `defs`
+ * should have unique `name`s — a duplicate makes the later def win in the registry
+ * while both remain in the schema union (see {@link EmailTemplateDef}).
+ *
+ * @template Defs - The `as const` tuple of template defs to compose.
+ * @param defs - The template definitions; pass `[...resqEmailTemplates, myDef]` to extend the built-ins.
+ * @returns A {@link Mailer} whose `decode` throws (and `renderEmail` rejects with)
+ *   {@link EmailValidationError} on invalid input.
+ * @example
+ * ```ts
+ * const mailer = createMailer(resqEmailTemplates);
+ * const { subject } = await mailer.renderEmail({
+ *   name: "otp",
+ *   to: "user@example.com",
+ *   data: { code: "123456" },
+ * });
+ * subject; // → "Your ResQ Systems verification code: 123456"
+ * ```
  */
 declare function createMailer<const Defs extends readonly AnyTemplateDef[]>(defs: Defs): Mailer<MailerPayload<Defs>>;
 //#endregion

package/lib/mailer.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"mailer.d.ts","names":[],"sources":["../src/mailer.tsx"],"mappings":"~~;;;;;;UAoCiB~~,iBAAiB,qBAAqB,mBAAmB,OAAO~~;WACvE~~,MAAM~~;WACN~~,MAAM~~;WACN~~,UAAU,MAAM~~;WAChB~~,YAAY,MAAM,uBAAuB~~;;;iBAInC~~,0BAA0B,qBAAqB,mBAAmB,OAAO,KACxF,KAAK,iBAAiB,MAAM,cAC1B,iBAAiB,MAAM;;;;;;;UAUhB;WACA;WACA,MAAM,OAAO;WACb,UAAU;WACV,YAAY,gBAAgB;;;KAIjC,WAAW,OACf,YAAY,uBAAuB,YAAY;WAEnC,MAAM;WACN,IAAI;WACJ,MAAM;;WAEN;;WAEA~~;;;KAKD~~,cAAc,sBAAsB,oBAAoB,WAAW~~;;KAGnE~~,mBACX,sBAAsB,kBACtB,aAAa,cAAc,iBACxB,QAAQ,cAAc;EAAS,MAAM~~;;;UAGxB~~;;EAEhB,IAAI~~;EACJ;EACA;EACA~~;;;UAIgB;;EAEhB,QAAQ~~;;;cAII~~,6BAA6B;WACvB~~;;;UAIF;EAChB~~,UAAU~~;EACV~~,SAAS,kBAAkB;;;UAIX,OAChB;WAA2B;WAAuB;WAAqB;;;WAG9D,QAAQ,OAAO;;WAEf,UAAU,OAAO,iBAAiB;;WAElC,gBAAgB~~;;EAEzB~~,OAAO,iBAAiB~~;;EAExB~~,YAAY,gBAAgB,UAAU,qBAAqB,QAAQ~~;;;;;;;;iBASpD~~,mBAAmB,sBAAsB,kBACxD,MAAM,OACJ,OAAO,cAAc"}
1	+ {"version":3,"file":"mailer.d.ts","names":[],"sources":["../src/mailer.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;UA+DiB,iBAAiB,qBAAqB,mBAAmB,OAAO;;WAEvE,MAAM;;WAEN,MAAM;;WAEN,UAAU,MAAM;;WAEhB,YAAY,MAAM,uBAAuB;;;;;;;;;;;;;;iBAenC,0BAA0B,qBAAqB,mBAAmB,OAAO,KACxF,KAAK,iBAAiB,MAAM,cAC1B,iBAAiB,MAAM;;;;;;;UAUhB;WACA;WACA,MAAM,OAAO;WACb,UAAU;WACV,YAAY,gBAAgB;;;KAIjC,WAAW,OACf,YAAY,uBAAuB,YAAY;WAEnC,MAAM;WACN,IAAI;WACJ,MAAM;;WAEN;;WAEA;;;;;;;;;;KAYD,cAAc,sBAAsB,oBAAoB,WAAW;;;;;;;;KASnE,mBACX,sBAAsB,kBACtB,aAAa,cAAc,iBACxB,QAAQ,cAAc;EAAS,MAAM;;;;;;;UAOxB;;EAEhB,IAAI;;EAEJ;;EAEA;;EAEA;;;UAIgB;;EAEhB,QAAQ;;;;;;;;;;;cAYI,6BAA6B;WACvB;;;;;;;;;;UAWF;;EAEhB,UAAU;;EAEV,SAAS,kBAAkB;;;UAIX,OAChB;WAA2B;WAAuB;WAAqB;;;WAG9D,QAAQ,OAAO;;WAEf,UAAU,OAAO,iBAAiB;;WAElC,gBAAgB;;;;;;;;;;EAUzB,OAAO,iBAAiB;;;;;;;;;;;;;;;;EAgBxB,YAAY,gBAAgB,UAAU,qBAAqB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiCpD,mBAAmB,sBAAsB,kBACxD,MAAM,OACJ,OAAO,cAAc"}