@resq-systems/email-templates 0.3.0

package/README.md

@@ -0,0 +1,236 @@
+<!--
+  Copyright 2026 ResQ Systems, Inc.
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+# @resq-systems/email-templates
+
+Type-safe transactional email templates for React apps and backend pipelines.
+
+- **One contract.** Every email is a validated `{ name, to, data }` payload, described by an [Effect Schema](https://effect.website) discriminated union. Nothing else can be enqueued or rendered.
+- **React Email components.** Templates are React components built on [React Email](https://react.email) with a `<Tailwind>` theme mapped to the dark-first ResQ Systems brand — red primary, Syne/DM Sans/DM Mono — with oklch tokens converted to email-safe hex.
+- **Headless render.** `renderEmail(payload)` returns `{ to, subject, html, text }` with no DOM — safe to call from queue workers, cron jobs, and other pipelines.
+- **Pluggable sending.** A provider-agnostic `EmailSender` port with an optional Resend adapter under `@resq-systems/email-templates/send`.
+
+## Install
+
+```sh
+bun add @resq-systems/email-templates effect react react-dom
+# only if you use the ./send Resend adapter:
+bun add resend
+```
+
+`effect`, `react`, and `react-dom` are peer dependencies; `resend` is an optional peer needed only for `./send`.
+
+## Subpaths
+
+| Import | Contents | Runtime |
+| --- | --- | --- |
+| `@resq-systems/email-templates` | `EmailPayload` schema, types, `decodeEmailPayload`, `registry`, `renderEmail` | browser + server |
+| `@resq-systems/email-templates/emails` | `Email` primitives, `emailColors`, and the template components | browser + server |
+| `@resq-systems/email-templates/send` | `EmailSender` port, `createResendSender`, `sendEmail` | **server only** |
+
+## Pipeline / worker usage
+
+Validate an untrusted payload, render it, and send it:
+
+```ts
+import { renderEmail } from "@resq-systems/email-templates";
+import { createResendSender, sendEmail } from "@resq-systems/email-templates/send";
+
+const sender = createResendSender(); // reads RESEND_API_KEY
+
+// One-shot: render + send
+const result = await sendEmail(
+	sender,
+	{ name: "otp", to: "user@example.com", data: { code: "123456", firstName: "Ada" } },
+	{ from: "ResQ Systems <noreply@resq.example>" },
+);
+
+if (!result.ok) {
+	// result.error = { name, message }
+}
+```
+
+Or render now and hand the HTML to any transport:
+
+```ts
+import { renderEmail } from "@resq-systems/email-templates";
+
+const { subject, html, text } = await renderEmail({
+	name: "password-reset",
+	to: "user@example.com",
+	data: { firstName: "Ada", resetUrl: "https://app.resq.example/reset?token=…" },
+});
+// pass subject/html/text to SES, Postmark, Nodemailer, etc.
+```
+
+The payload is validated at the boundary — an unknown `name` or missing required `data` throws `EmailValidationError`.
+
+## React app usage
+
+Import a template component directly (for in-app previews or your own rendering):
+
+```tsx
+import { WelcomeEmail } from "@resq-systems/email-templates/emails";
+
+<WelcomeEmail firstName="Ada" verifyUrl="https://app.resq.example/verify" />;
+```
+
+## Templates
+
+| `name` | `data` |
+| --- | --- |
+| `otp` | `code`, `firstName?`, `expiresInMinutes?` |
+| `welcome` | `firstName`, `verifyUrl?` |
+| `password-reset` | `firstName?`, `resetUrl`, `expiresInMinutes?` |
+| `notification` | `title`, `body`, `severity?`, `actionUrl?`, `actionLabel?` |
+| `incident-alert` | `incidentId`, `title`, `severity`, `summary`, `location?`, `detectedAt?`, `dashboardUrl` |
+
+## Theming
+
+Templates render in the dark-first ResQ Systems brand by default, sourced from
+[`@resq-systems/constants`](../constants)`/tokens`. Rebrand any render without forking:
+
+```ts
+const { html } = await renderEmail(payload, {
+	theme: { colors: { primary: "#0ea5e9" }, fontsHref: null },
+});
+```
+
+Or wrap React usage in a provider:
+
+```tsx
+import { EmailThemeContext, mergeEmailTheme } from "@resq-systems/email-templates";
+
+<EmailThemeContext.Provider value={mergeEmailTheme({ colors: { primary: "#0ea5e9" } })}>
+	<WelcomeEmail firstName="Ada" />
+</EmailThemeContext.Provider>;
+```
+
+`colors` map to Tailwind `theme.extend.colors`; unset keys fall back to the ResQ Systems
+defaults. Change the brand for every app at once by editing `@resq-systems/constants`.
+
+## Custom template suites
+
+Compose your own typed `{ name, to, data }` contract — spread the built-in
+`resqEmailTemplates` and add your own, or start fresh:
+
+```tsx
+import { createMailer, defineEmailTemplate, Email, resqEmailTemplates } from "@resq-systems/email-templates";
+import { Schema } from "effect";
+
+const shiftReminder = defineEmailTemplate({
+	name: "shift-reminder",
+	data: Schema.Struct({ operator: Schema.NonEmptyString, startsAt: Schema.String }),
+	subject: (d) => `Shift at ${d.startsAt}`,
+	Component: (d) => (
+		<Email.Shell preview="Your shift">
+			<Email.Title>Hi {d.operator}</Email.Title>
+			<Email.Paragraph>Your shift starts at {d.startsAt}.</Email.Paragraph>
+		</Email.Shell>
+	),
+});
+
+const mailer = createMailer([...resqEmailTemplates, shiftReminder]);
+const { html, text } = await mailer.renderEmail({
+	name: "shift-reminder",
+	to: "op@resq.software",
+	data: { operator: "Ada", startsAt: "18:00" },
+});
+```
+
+`mailer` exposes `{ schema, registry, names, decode, renderEmail }`, each fully
+typed over your template set — unknown names and bad `data` are rejected at decode.
+
+## Adding a built-in template
+
+1. Add the `data` schema (and its inferred type) in [`src/schemas.ts`](src/schemas.ts).
+2. Create the component in `src/emails/<name>.tsx` from `Email.*` primitives.
+3. Register it in [`src/templates.tsx`](src/templates.tsx) via `defineEmailTemplate`, then add it to `resqEmailTemplates`.
+4. Export the component from `src/emails/index.ts` and add a preview in `emails/<name>.tsx`.
+
+## Custom sender
+
+Implement the `EmailSender` port to use any provider:
+
+```ts
+import type { EmailSender } from "@resq-systems/email-templates/send";
+
+export const sesSender: EmailSender = {
+	async send({ from, to, subject, html, text }) {
+		// call your provider, then:
+		return { ok: true, id: "…" };
+	},
+};
+```
+
+## Preview
+
+```sh
+bun --filter @resq-systems/email-templates email:dev   # http://localhost:3000
+```
+
+## Runtime support
+
+`renderEmail()` runs in **Node and Bun** (it uses `react-dom/server`). It does **not** run on Cloudflare Workers / `workerd` — `@react-email/render` resolves to its Node build there and throws at runtime (OpenNext #1205). For edge/Workers delivery, pre-render at build time (`bun --filter @resq-systems/email-templates email:export`) or render in a Node/Bun pipeline and ship the resulting HTML/text.
+
+Sender config follows the ResQ Systems convention: `RESEND_API_KEY` (required) and `RESEND_FROM` (verified sender, e.g. `ResQ Systems <updates@send.resq.software>`).
+
+## Email-client safety
+
+Email clients drop `oklch()`, `color-mix()`, and CSS custom properties, and many ignore `rem` and flex/grid. Templates therefore:
+
+- use the hex `emailColors` snapshot (keep it in sync with the oklch design tokens);
+- pass `pixelBasedPreset` to `<Tailwind>` so utilities emit `px`;
+- avoid responsive prefixes and flex/grid — use `Section` for layout.
+
+## Prerequisites
+
+- **Runtime**: Bun 1.1+ or Node.js 20+
+- **Peer Dependencies**: `react`, `react-dom` (v19+ recommended)
+- **Services**: Requires a Resend API key for direct delivery.
+
+## Configuration
+
+- **Resend Token**: Supply `RESEND_API_KEY` to the environment.
+- **SMTP Transport**: If not using Resend, implement a custom `EmailSender` (e.g., using Nodemailer or SES).
+
+## Testing
+
+```sh
+bun --filter @resq-systems/email-templates test
+```
+
+Coverage includes behavioural tests (contract validation, subject/link presence,
+theme overrides) plus **HTML/text regression snapshots** for every built-in
+template in [`tests/snapshots.test.ts`](tests/snapshots.test.ts). Because
+`renderEmail()` is deterministic for fixed input, the committed
+`tests/__snapshots__` baseline catches unintended changes to markup, inline
+styles, or the plaintext fallback. When a change is intentional, re-baseline and
+review the diff:
+
+```sh
+bun --filter @resq-systems/email-templates test -u
+```
+
+Snapshots are the email-appropriate substitute for Storybook/Chromatic here:
+React Email renders to client-accurate HTML (tables + inline styles), which a
+browser-oriented Storybook would not represent faithfully. For a live, mail-client
+preview during development, use `email:dev` (see [Preview](#preview)).
+
+## Troubleshooting
+
+- **Rendering Failures**: Next.js Server Components might struggle with client-side React Email components. Render mailers asynchronously on the server.
+

package/lib/contract.d.ts

@@ -0,0 +1,125 @@
+import { EmailValidationError } from "./mailer.js";
+import { resqMailer } from "./suite.js";
+//#region src/contract.d.ts
+/** Effect Schema union for every built-in ResQ Systems email `{ name, to, data }`. */
+declare const EmailPayload: import("effect/Schema").Top;
+/** The validated payload type for the built-in ResQ Systems templates. */
+type EmailPayload = ReturnType<typeof resqMailer.decode>;
+/** Every built-in template name (the union discriminant). */
+type EmailName = EmailPayload["name"];
+/** The `data` shape for a given built-in template name. */
+type EmailTemplateData<N extends EmailName> = Extract<EmailPayload, {
+  name: N;
+}>["data"];
+/**
+ * Validate an untrusted `{ name, to, data }` payload at the system boundary.
+ * Throws {@link EmailValidationError} on failure.
+ */
+declare const decodeEmailPayload: (input: unknown) => {
+  readonly name: "incident-alert";
+  readonly to: string;
+  readonly data: {
+    readonly incidentId: string;
+    readonly title: string;
+    readonly severity: "critical" | "info" | "warning";
+    readonly summary: string;
+    readonly location?: string | undefined;
+    readonly detectedAt?: string | undefined;
+    readonly dashboardUrl: string;
+  };
+  readonly category?: "transactional" | "marketing";
+  readonly unsubscribeUrl?: string;
+} | {
+  readonly name: "mission-approval";
+  readonly to: string;
+  readonly data: {
+    readonly missionId: string;
+    readonly title: string;
+    readonly summary?: string | undefined;
+    readonly requestedBy?: string | undefined;
+    readonly severity?: "critical" | "info" | "warning" | undefined;
+    readonly approveUrl: string;
+    readonly expiresInMinutes?: number | undefined;
+  };
+  readonly category?: "transactional" | "marketing";
+  readonly unsubscribeUrl?: string;
+} | {
+  readonly name: "new-device-login";
+  readonly to: string;
+  readonly data: {
+    readonly firstName?: string | undefined;
+    readonly device?: string | undefined;
+    readonly location?: string | undefined;
+    readonly ipAddress?: string | undefined;
+    readonly at?: string | undefined;
+    readonly secureAccountUrl?: string | undefined;
+  };
+  readonly category?: "transactional" | "marketing";
+  readonly unsubscribeUrl?: string;
+} | {
+  readonly name: "notification";
+  readonly to: string;
+  readonly data: {
+    readonly title: string;
+    readonly body: string;
+    readonly severity?: "error" | "info" | "success" | "warning" | undefined;
+    readonly actionUrl?: string | undefined;
+    readonly actionLabel?: string | undefined;
+  };
+  readonly category?: "transactional" | "marketing";
+  readonly unsubscribeUrl?: string;
+} | {
+  readonly name: "org-invitation";
+  readonly to: string;
+  readonly data: {
+    readonly orgName: string;
+    readonly inviterName?: string | undefined;
+    readonly orgRole?: string | undefined;
+    readonly acceptUrl: string;
+    readonly expiresInDays?: number | undefined;
+  };
+  readonly category?: "transactional" | "marketing";
+  readonly unsubscribeUrl?: string;
+} | {
+  readonly name: "otp";
+  readonly to: string;
+  readonly data: {
+    readonly code: string;
+    readonly firstName?: string | undefined;
+    readonly expiresInMinutes?: number | undefined;
+  };
+  readonly category?: "transactional" | "marketing";
+  readonly unsubscribeUrl?: string;
+} | {
+  readonly name: "password-changed";
+  readonly to: string;
+  readonly data: {
+    readonly firstName?: string | undefined;
+    readonly changedAt?: string | undefined;
+    readonly secureAccountUrl?: string | undefined;
+  };
+  readonly category?: "transactional" | "marketing";
+  readonly unsubscribeUrl?: string;
+} | {
+  readonly name: "password-reset";
+  readonly to: string;
+  readonly data: {
+    readonly firstName?: string | undefined;
+    readonly resetUrl: string;
+    readonly expiresInMinutes?: number | undefined;
+  };
+  readonly category?: "transactional" | "marketing";
+  readonly unsubscribeUrl?: string;
+} | {
+  readonly name: "welcome";
+  readonly to: string;
+  readonly data: {
+    readonly firstName: string;
+    readonly verifyUrl?: string | undefined;
+  };
+  readonly category?: "transactional" | "marketing";
+  readonly unsubscribeUrl?: string;
+};
+//#endregion
+export { EmailName, EmailPayload, EmailTemplateData, EmailValidationError, decodeEmailPayload };
+//# sourceMappingURL=contract.d.ts.map

package/lib/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","names":[],"sources":["../src/contract.ts"],"mappings":";;;;cAqBa,sCAAY;;KAGb,eAAe,kBAAkB,WAAW;;KAG5C,YAAY;;KAGZ,kBAAkB,UAAU,aAAa,QAAQ;EAAgB,MAAM;;;;;;cAMtE,qBAAkB"}

package/lib/contract.js

@@ -0,0 +1,29 @@
+import { EmailValidationError } from "./mailer.js";
+import { resqMailer } from "./suite.js";
+//#region src/contract.ts
+/**
+* Copyright 2026 ResQ Systems, Inc.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+/** Effect Schema union for every built-in ResQ Systems email `{ name, to, data }`. */
+const EmailPayload = resqMailer.schema;
+/**
+* Validate an untrusted `{ name, to, data }` payload at the system boundary.
+* Throws {@link EmailValidationError} on failure.
+*/
+const decodeEmailPayload = resqMailer.decode;
+//#endregion
+export { EmailPayload, EmailValidationError, decodeEmailPayload };
+
+//# sourceMappingURL=contract.js.map

package/lib/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","names":[],"sources":["../src/contract.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 { resqMailer } from \"./suite.js\";\n\nexport { EmailValidationError } from \"./mailer.js\";\n\n/** Effect Schema union for every built-in ResQ Systems email `{ name, to, data }`. */\nexport const EmailPayload = resqMailer.schema;\n\n/** The validated payload type for the built-in ResQ Systems templates. */\nexport type EmailPayload = ReturnType<typeof resqMailer.decode>;\n\n/** Every built-in template name (the union discriminant). */\nexport type EmailName = EmailPayload[\"name\"];\n\n/** The `data` shape for a given built-in template name. */\nexport type EmailTemplateData<N extends EmailName> = Extract<EmailPayload, { name: N }>[\"data\"];\n\n/**\n * Validate an untrusted `{ name, to, data }` payload at the system boundary.\n * Throws {@link EmailValidationError} on failure.\n */\nexport const decodeEmailPayload = resqMailer.decode;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,MAAa,eAAe,WAAW;;;;;AAevC,MAAa,qBAAqB,WAAW"}

package/lib/emails/incident-alert.d.ts

@@ -0,0 +1,8 @@
+import { IncidentAlertData } from "../schemas.js";
+//#region src/emails/incident-alert.d.ts
+type IncidentAlertEmailProps = IncidentAlertData;
+/** Incident / dispatch alert for ResQ Systems disaster-response operators. */
+declare function IncidentAlertEmail({ incidentId, title, severity, summary, location, detectedAt, dashboardUrl }: IncidentAlertEmailProps): import("react").JSX.Element;
+//#endregion
+export { IncidentAlertEmail, IncidentAlertEmailProps };
+//# sourceMappingURL=incident-alert.d.ts.map

package/lib/emails/incident-alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-alert.d.ts","names":[],"sources":["../../src/emails/incident-alert.tsx"],"mappings":";;KAmBY,0BAA0B;;iBAStB,qBACf,YACA,OACA,UACA,SACA,UACA,YACA,gBACE,0CAAuB,IAAA"}

package/lib/emails/incident-alert.js

@@ -0,0 +1,44 @@
+import { Email } from "./primitives.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/emails/incident-alert.tsx
+const severityClass = {
+	info: "text-info",
+	warning: "text-warning",
+	critical: "text-danger"
+};
+/** Incident / dispatch alert for ResQ Systems disaster-response operators. */
+function IncidentAlertEmail({ incidentId, title, severity = "warning", summary, location, detectedAt, dashboardUrl = "https://app.resq.software/incidents" }) {
+	const meta = [
+		`Incident ${incidentId}`,
+		location,
+		detectedAt
+	].filter(Boolean).join(" · ");
+	return /* @__PURE__ */ jsxs(Email.Shell, {
+		preview: `[${severity.toUpperCase()}] ${title}`,
+		children: [
+			/* @__PURE__ */ jsx(Email.Header, {}),
+			/* @__PURE__ */ jsxs(Email.Text, {
+				className: `mb-2 font-mono text-xs font-medium uppercase tracking-wide ${severityClass[severity]}`,
+				children: [severity, " incident"]
+			}),
+			/* @__PURE__ */ jsx(Email.Title, { children: title }),
+			/* @__PURE__ */ jsx(Email.Paragraph, { children: summary }),
+			/* @__PURE__ */ jsx(Email.Text, {
+				className: "mb-2 font-mono text-xs uppercase tracking-wide text-muted",
+				children: meta
+			}),
+			/* @__PURE__ */ jsx(Email.CTA, {
+				href: dashboardUrl,
+				children: "Open incident dashboard"
+			}),
+			/* @__PURE__ */ jsx(Email.LegalFooter, {
+				category: "transactional",
+				reason: "You are receiving this alert because you are on-call for ResQ Systems disaster response."
+			})
+		]
+	});
+}
+//#endregion
+export { IncidentAlertEmail };
+
+//# sourceMappingURL=incident-alert.js.map

package/lib/emails/incident-alert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-alert.js","names":[],"sources":["../../src/emails/incident-alert.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 { IncidentAlertData } from \"../schemas.js\";\nimport { Email } from \"./primitives.js\";\n\nexport type IncidentAlertEmailProps = IncidentAlertData;\n\nconst severityClass: Record<\"info\" | \"warning\" | \"critical\", string> = {\n\tinfo: \"text-info\",\n\twarning: \"text-warning\",\n\tcritical: \"text-danger\",\n};\n\n/** Incident / dispatch alert for ResQ Systems disaster-response operators. */\nexport function IncidentAlertEmail({\n\tincidentId,\n\ttitle,\n\tseverity = \"warning\",\n\tsummary,\n\tlocation,\n\tdetectedAt,\n\tdashboardUrl = \"https://app.resq.software/incidents\",\n}: IncidentAlertEmailProps) {\n\tconst meta = [`Incident ${incidentId}`, location, detectedAt].filter(Boolean).join(\" · \");\n\n\treturn (\n\t\t<Email.Shell preview={`[${severity.toUpperCase()}] ${title}`}>\n\t\t\t<Email.Header />\n\t\t\t<Email.Text\n\t\t\t\tclassName={`mb-2 font-mono text-xs font-medium uppercase tracking-wide ${severityClass[severity]}`}\n\t\t\t>\n\t\t\t\t{severity} incident\n\t\t\t</Email.Text>\n\t\t\t<Email.Title>{title}</Email.Title>\n\t\t\t<Email.Paragraph>{summary}</Email.Paragraph>\n\t\t\t<Email.Text className=\"mb-2 font-mono text-xs uppercase tracking-wide text-muted\">\n\t\t\t\t{meta}\n\t\t\t</Email.Text>\n\t\t\t<Email.CTA href={dashboardUrl}>Open incident dashboard</Email.CTA>\n\t\t\t<Email.LegalFooter\n\t\t\t\tcategory=\"transactional\"\n\t\t\t\treason=\"You are receiving this alert because you are on-call for ResQ Systems disaster response.\"\n\t\t\t/>\n\t\t</Email.Shell>\n\t);\n}\n"],"mappings":";;;AAqBA,MAAM,gBAAiE;CACtE,MAAM;CACN,SAAS;CACT,UAAU;AACX;;AAGA,SAAgB,mBAAmB,EAClC,YACA,OACA,WAAW,WACX,SACA,UACA,YACA,eAAe,yCACY;CAC3B,MAAM,OAAO;EAAC,YAAY;EAAc;EAAU;CAAU,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK;CAExF,OACC,qBAAC,MAAM,OAAP;EAAa,SAAS,IAAI,SAAS,YAAY,EAAE,IAAI;YAArD;GACC,oBAAC,MAAM,QAAP,CAAe,CAAA;GACf,qBAAC,MAAM,MAAP;IACC,WAAW,8DAA8D,cAAc;cADxF,CAGE,UAAS,WACC;;GACZ,oBAAC,MAAM,OAAP,EAAA,UAAc,MAAmB,CAAA;GACjC,oBAAC,MAAM,WAAP,EAAA,UAAkB,QAAyB,CAAA;GAC3C,oBAAC,MAAM,MAAP;IAAY,WAAU;cACpB;GACU,CAAA;GACZ,oBAAC,MAAM,KAAP;IAAW,MAAM;cAAc;GAAkC,CAAA;GACjE,oBAAC,MAAM,aAAP;IACC,UAAS;IACT,QAAO;GACP,CAAA;EACW;;AAEf"}

package/lib/emails/index.d.ts

@@ -0,0 +1,13 @@
+import { EmailMessage, EmailMessageContext, EmailOrgIdentity, EmailTheme, EmailThemeContext, EmailThemeFonts, EmailThemeOverride, buildTailwindConfig, defaultEmailTheme, mergeEmailTheme, resolveEmailTheme, withEmailMessage, withEmailTheme } from "./theme.js";
+import { IncidentAlertEmail, IncidentAlertEmailProps } from "./incident-alert.js";
+import { EmailColorToken, emailColors, emailFonts, emailOrg } from "./tokens.js";
+import { Email } from "./primitives.js";
+import { OtpEmail, OtpEmailProps } from "./otp.js";
+import { WelcomeEmail, WelcomeEmailProps } from "./welcome.js";
+import { PasswordResetEmail, PasswordResetEmailProps } from "./password-reset.js";
+import { NotificationEmail, NotificationEmailProps } from "./notification.js";
+import { PasswordChangedEmail, PasswordChangedEmailProps } from "./password-changed.js";
+import { NewDeviceLoginEmail, NewDeviceLoginEmailProps } from "./new-device-login.js";
+import { MissionApprovalEmail, MissionApprovalEmailProps } from "./mission-approval.js";
+import { OrgInvitationEmail, OrgInvitationEmailProps } from "./org-invitation.js";
+export { Email, EmailColorToken, EmailMessage, EmailMessageContext, EmailOrgIdentity, EmailTheme, EmailThemeContext, EmailThemeFonts, EmailThemeOverride, IncidentAlertEmail, IncidentAlertEmailProps, MissionApprovalEmail, MissionApprovalEmailProps, NewDeviceLoginEmail, NewDeviceLoginEmailProps, NotificationEmail, NotificationEmailProps, OrgInvitationEmail, OrgInvitationEmailProps, OtpEmail, OtpEmailProps, PasswordChangedEmail, PasswordChangedEmailProps, PasswordResetEmail, PasswordResetEmailProps, WelcomeEmail, WelcomeEmailProps, buildTailwindConfig, defaultEmailTheme, emailColors, emailFonts, emailOrg, mergeEmailTheme, resolveEmailTheme, withEmailMessage, withEmailTheme };

package/lib/emails/index.js

@@ -0,0 +1,13 @@
+import { emailColors, emailFonts, emailOrg } from "./tokens.js";
+import { EmailMessageContext, EmailThemeContext, buildTailwindConfig, defaultEmailTheme, mergeEmailTheme, resolveEmailTheme, withEmailMessage, withEmailTheme } from "./theme.js";
+import { Email } from "./primitives.js";
+import { IncidentAlertEmail } from "./incident-alert.js";
+import { MissionApprovalEmail } from "./mission-approval.js";
+import { NewDeviceLoginEmail } from "./new-device-login.js";
+import { NotificationEmail } from "./notification.js";
+import { OrgInvitationEmail } from "./org-invitation.js";
+import { OtpEmail } from "./otp.js";
+import { PasswordChangedEmail } from "./password-changed.js";
+import { PasswordResetEmail } from "./password-reset.js";
+import { WelcomeEmail } from "./welcome.js";
+export { Email, EmailMessageContext, EmailThemeContext, IncidentAlertEmail, MissionApprovalEmail, NewDeviceLoginEmail, NotificationEmail, OrgInvitationEmail, OtpEmail, PasswordChangedEmail, PasswordResetEmail, WelcomeEmail, buildTailwindConfig, defaultEmailTheme, emailColors, emailFonts, emailOrg, mergeEmailTheme, resolveEmailTheme, withEmailMessage, withEmailTheme };

package/lib/emails/mission-approval.d.ts

@@ -0,0 +1,8 @@
+import { MissionApprovalData } from "../schemas.js";
+//#region src/emails/mission-approval.d.ts
+type MissionApprovalEmailProps = MissionApprovalData;
+/** Approver sign-off request for a ResQ Systems mission / plan execution. */
+declare function MissionApprovalEmail({ missionId, title, summary, requestedBy, severity, approveUrl, expiresInMinutes }: MissionApprovalEmailProps): import("react").JSX.Element;
+//#endregion
+export { MissionApprovalEmail, MissionApprovalEmailProps };
+//# sourceMappingURL=mission-approval.d.ts.map

package/lib/emails/mission-approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-approval.d.ts","names":[],"sources":["../../src/emails/mission-approval.tsx"],"mappings":";;KAmBY,4BAA4B;;iBASxB,uBACf,WACA,OACA,SACA,aACA,UACA,YACA,oBACE,4CAAyB,IAAA"}

package/lib/emails/mission-approval.js

@@ -0,0 +1,46 @@
+import { Email } from "./primitives.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/emails/mission-approval.tsx
+const severityClass = {
+	info: "text-info",
+	warning: "text-warning",
+	critical: "text-danger"
+};
+/** Approver sign-off request for a ResQ Systems mission / plan execution. */
+function MissionApprovalEmail({ missionId, title, summary, requestedBy, severity, approveUrl = "https://app.example.com/missions/approve", expiresInMinutes }) {
+	const meta = [`Mission ${missionId}`, requestedBy ? `Requested by ${requestedBy}` : null].filter(Boolean).join(" · ");
+	return /* @__PURE__ */ jsxs(Email.Shell, {
+		preview: `Mission approval needed: ${title}`,
+		children: [
+			/* @__PURE__ */ jsx(Email.Header, {}),
+			severity ? /* @__PURE__ */ jsxs(Email.Text, {
+				className: `mb-2 font-mono text-xs font-medium uppercase tracking-wide ${severityClass[severity]}`,
+				children: [severity, " priority"]
+			}) : null,
+			/* @__PURE__ */ jsx(Email.Title, { children: title }),
+			/* @__PURE__ */ jsx(Email.Paragraph, { children: "A mission needs your sign-off before it can execute." }),
+			summary ? /* @__PURE__ */ jsx(Email.Paragraph, { children: summary }) : null,
+			/* @__PURE__ */ jsx(Email.Text, {
+				className: "mb-2 font-mono text-xs uppercase tracking-wide text-muted",
+				children: meta
+			}),
+			/* @__PURE__ */ jsx(Email.CTA, {
+				href: approveUrl,
+				children: "Review & approve"
+			}),
+			expiresInMinutes ? /* @__PURE__ */ jsxs(Email.Paragraph, { children: [
+				"This approval request expires in ",
+				expiresInMinutes,
+				" minutes."
+			] }) : null,
+			/* @__PURE__ */ jsx(Email.LegalFooter, {
+				category: "transactional",
+				reason: "You are receiving this email because you are an approver for ResQ Systems mission operations."
+			})
+		]
+	});
+}
+//#endregion
+export { MissionApprovalEmail };
+
+//# sourceMappingURL=mission-approval.js.map

package/lib/emails/mission-approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-approval.js","names":[],"sources":["../../src/emails/mission-approval.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 { MissionApprovalData } from \"../schemas.js\";\nimport { Email } from \"./primitives.js\";\n\nexport type MissionApprovalEmailProps = MissionApprovalData;\n\nconst severityClass: Record<\"info\" | \"warning\" | \"critical\", string> = {\n\tinfo: \"text-info\",\n\twarning: \"text-warning\",\n\tcritical: \"text-danger\",\n};\n\n/** Approver sign-off request for a ResQ Systems mission / plan execution. */\nexport function MissionApprovalEmail({\n\tmissionId,\n\ttitle,\n\tsummary,\n\trequestedBy,\n\tseverity,\n\tapproveUrl = \"https://app.example.com/missions/approve\",\n\texpiresInMinutes,\n}: MissionApprovalEmailProps) {\n\tconst meta = [`Mission ${missionId}`, requestedBy ? `Requested by ${requestedBy}` : null]\n\t\t.filter(Boolean)\n\t\t.join(\" · \");\n\n\treturn (\n\t\t<Email.Shell preview={`Mission approval needed: ${title}`}>\n\t\t\t<Email.Header />\n\t\t\t{severity ? (\n\t\t\t\t<Email.Text\n\t\t\t\t\tclassName={`mb-2 font-mono text-xs font-medium uppercase tracking-wide ${severityClass[severity]}`}\n\t\t\t\t>\n\t\t\t\t\t{severity} priority\n\t\t\t\t</Email.Text>\n\t\t\t) : null}\n\t\t\t<Email.Title>{title}</Email.Title>\n\t\t\t<Email.Paragraph>A mission needs your sign-off before it can execute.</Email.Paragraph>\n\t\t\t{summary ? <Email.Paragraph>{summary}</Email.Paragraph> : null}\n\t\t\t<Email.Text className=\"mb-2 font-mono text-xs uppercase tracking-wide text-muted\">\n\t\t\t\t{meta}\n\t\t\t</Email.Text>\n\t\t\t<Email.CTA href={approveUrl}>Review &amp; approve</Email.CTA>\n\t\t\t{expiresInMinutes ? (\n\t\t\t\t<Email.Paragraph>\n\t\t\t\t\tThis approval request expires in {expiresInMinutes} minutes.\n\t\t\t\t</Email.Paragraph>\n\t\t\t) : null}\n\t\t\t<Email.LegalFooter\n\t\t\t\tcategory=\"transactional\"\n\t\t\t\treason=\"You are receiving this email because you are an approver for ResQ Systems mission operations.\"\n\t\t\t/>\n\t\t</Email.Shell>\n\t);\n}\n"],"mappings":";;;AAqBA,MAAM,gBAAiE;CACtE,MAAM;CACN,SAAS;CACT,UAAU;AACX;;AAGA,SAAgB,qBAAqB,EACpC,WACA,OACA,SACA,aACA,UACA,aAAa,4CACb,oBAC6B;CAC7B,MAAM,OAAO,CAAC,WAAW,aAAa,cAAc,gBAAgB,gBAAgB,IAAI,CAAC,CACvF,OAAO,OAAO,CAAC,CACf,KAAK,KAAK;CAEZ,OACC,qBAAC,MAAM,OAAP;EAAa,SAAS,4BAA4B;YAAlD;GACC,oBAAC,MAAM,QAAP,CAAe,CAAA;GACd,WACA,qBAAC,MAAM,MAAP;IACC,WAAW,8DAA8D,cAAc;cADxF,CAGE,UAAS,WACC;QACT;GACJ,oBAAC,MAAM,OAAP,EAAA,UAAc,MAAmB,CAAA;GACjC,oBAAC,MAAM,WAAP,EAAA,UAAiB,uDAAqE,CAAA;GACrF,UAAU,oBAAC,MAAM,WAAP,EAAA,UAAkB,QAAyB,CAAA,IAAI;GAC1D,oBAAC,MAAM,MAAP;IAAY,WAAU;cACpB;GACU,CAAA;GACZ,oBAAC,MAAM,KAAP;IAAW,MAAM;cAAY;GAA+B,CAAA;GAC3D,mBACA,qBAAC,MAAM,WAAP,EAAA,UAAA;IAAiB;IACkB;IAAiB;GACnC,EAAA,CAAA,IACd;GACJ,oBAAC,MAAM,aAAP;IACC,UAAS;IACT,QAAO;GACP,CAAA;EACW;;AAEf"}

package/lib/emails/new-device-login.d.ts

@@ -0,0 +1,8 @@
+import { NewDeviceLoginData } from "../schemas.js";
+//#region src/emails/new-device-login.d.ts
+type NewDeviceLoginEmailProps = NewDeviceLoginData;
+/** Security alert: a new device or location signed in to the account. */
+declare function NewDeviceLoginEmail({ firstName, device, location, ipAddress, at, secureAccountUrl }: NewDeviceLoginEmailProps): import("react").JSX.Element;
+//#endregion
+export { NewDeviceLoginEmail, NewDeviceLoginEmailProps };
+//# sourceMappingURL=new-device-login.d.ts.map

package/lib/emails/new-device-login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-device-login.d.ts","names":[],"sources":["../../src/emails/new-device-login.tsx"],"mappings":";;KAmBY,2BAA2B;;iBAGvB,sBACf,WACA,QACA,UACA,WACA,IACA,oBACE,2CAAwB,IAAA"}

package/lib/emails/new-device-login.js

@@ -0,0 +1,47 @@
+import { Email } from "./primitives.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/emails/new-device-login.tsx
+/** Security alert: a new device or location signed in to the account. */
+function NewDeviceLoginEmail({ firstName, device, location, ipAddress, at, secureAccountUrl }) {
+	const meta = [
+		device,
+		location,
+		ipAddress,
+		at
+	].filter(Boolean).join(" · ");
+	return /* @__PURE__ */ jsxs(Email.Shell, {
+		preview: "New sign-in to your ResQ Systems account",
+		children: [
+			/* @__PURE__ */ jsx(Email.Header, {}),
+			/* @__PURE__ */ jsx(Email.Title, { children: "New sign-in to your account" }),
+			firstName ? /* @__PURE__ */ jsxs(Email.Paragraph, { children: [
+				"Hi ",
+				firstName,
+				","
+			] }) : null,
+			/* @__PURE__ */ jsx(Email.Paragraph, { children: "We noticed a new sign-in to your ResQ Systems account." }),
+			meta ? /* @__PURE__ */ jsx(Email.Text, {
+				className: "mb-4 font-mono text-xs uppercase tracking-wide text-muted",
+				children: meta
+			}) : null,
+			/* @__PURE__ */ jsxs(Email.Paragraph, { children: [
+				"If this was you, no action is needed.",
+				" ",
+				secureAccountUrl ? "If you don't recognize this sign-in, secure your account now." : "If you don't recognize this sign-in, please contact support immediately."
+			] }),
+			secureAccountUrl ? /* @__PURE__ */ jsx(Email.CTA, {
+				href: secureAccountUrl,
+				children: "Secure your account"
+			}) : null,
+			/* @__PURE__ */ jsx(Email.SupportLine, { children: "Don't recognize this sign-in?" }),
+			/* @__PURE__ */ jsx(Email.LegalFooter, {
+				category: "transactional",
+				reason: "You are receiving this email because a new sign-in to your ResQ Systems account was detected."
+			})
+		]
+	});
+}
+//#endregion
+export { NewDeviceLoginEmail };
+
+//# sourceMappingURL=new-device-login.js.map

package/lib/emails/new-device-login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-device-login.js","names":[],"sources":["../../src/emails/new-device-login.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 { NewDeviceLoginData } from \"../schemas.js\";\nimport { Email } from \"./primitives.js\";\n\nexport type NewDeviceLoginEmailProps = NewDeviceLoginData;\n\n/** Security alert: a new device or location signed in to the account. */\nexport function NewDeviceLoginEmail({\n\tfirstName,\n\tdevice,\n\tlocation,\n\tipAddress,\n\tat,\n\tsecureAccountUrl,\n}: NewDeviceLoginEmailProps) {\n\tconst meta = [device, location, ipAddress, at].filter(Boolean).join(\" · \");\n\n\treturn (\n\t\t<Email.Shell preview=\"New sign-in to your ResQ Systems account\">\n\t\t\t<Email.Header />\n\t\t\t<Email.Title>New sign-in to your account</Email.Title>\n\t\t\t{firstName ? <Email.Paragraph>Hi {firstName},</Email.Paragraph> : null}\n\t\t\t<Email.Paragraph>We noticed a new sign-in to your ResQ Systems account.</Email.Paragraph>\n\t\t\t{meta ? (\n\t\t\t\t<Email.Text className=\"mb-4 font-mono text-xs uppercase tracking-wide text-muted\">\n\t\t\t\t\t{meta}\n\t\t\t\t</Email.Text>\n\t\t\t) : null}\n\t\t\t<Email.Paragraph>\n\t\t\t\tIf this was you, no action is needed.{\" \"}\n\t\t\t\t{secureAccountUrl\n\t\t\t\t\t? \"If you don't recognize this sign-in, secure your account now.\"\n\t\t\t\t\t: \"If you don't recognize this sign-in, please contact support immediately.\"}\n\t\t\t</Email.Paragraph>\n\t\t\t{secureAccountUrl ? <Email.CTA href={secureAccountUrl}>Secure your account</Email.CTA> : null}\n\t\t\t<Email.SupportLine>Don't recognize this sign-in?</Email.SupportLine>\n\t\t\t<Email.LegalFooter\n\t\t\t\tcategory=\"transactional\"\n\t\t\t\treason=\"You are receiving this email because a new sign-in to your ResQ Systems account was detected.\"\n\t\t\t/>\n\t\t</Email.Shell>\n\t);\n}\n"],"mappings":";;;;AAsBA,SAAgB,oBAAoB,EACnC,WACA,QACA,UACA,WACA,IACA,oBAC4B;CAC5B,MAAM,OAAO;EAAC;EAAQ;EAAU;EAAW;CAAE,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK;CAEzE,OACC,qBAAC,MAAM,OAAP;EAAa,SAAQ;YAArB;GACC,oBAAC,MAAM,QAAP,CAAe,CAAA;GACf,oBAAC,MAAM,OAAP,EAAA,UAAa,8BAAwC,CAAA;GACpD,YAAY,qBAAC,MAAM,WAAP,EAAA,UAAA;IAAiB;IAAI;IAAU;GAAkB,EAAA,CAAA,IAAI;GAClE,oBAAC,MAAM,WAAP,EAAA,UAAiB,yDAAuE,CAAA;GACvF,OACA,oBAAC,MAAM,MAAP;IAAY,WAAU;cACpB;GACU,CAAA,IACT;GACJ,qBAAC,MAAM,WAAP,EAAA,UAAA;IAAiB;IACsB;IACrC,mBACE,kEACA;GACa,EAAA,CAAA;GAChB,mBAAmB,oBAAC,MAAM,KAAP;IAAW,MAAM;cAAkB;GAA8B,CAAA,IAAI;GACzF,oBAAC,MAAM,aAAP,EAAA,UAAmB,gCAAgD,CAAA;GACnE,oBAAC,MAAM,aAAP;IACC,UAAS;IACT,QAAO;GACP,CAAA;EACW;;AAEf"}

package/lib/emails/notification.d.ts

@@ -0,0 +1,8 @@
+import { NotificationData } from "../schemas.js";
+//#region src/emails/notification.d.ts
+type NotificationEmailProps = NotificationData;
+/** Generic notification / alert email with an optional call-to-action. */
+declare function NotificationEmail({ title, body, severity, actionUrl, actionLabel }: NotificationEmailProps): import("react").JSX.Element;
+//#endregion
+export { NotificationEmail, NotificationEmailProps };
+//# sourceMappingURL=notification.d.ts.map

package/lib/emails/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","names":[],"sources":["../../src/emails/notification.tsx"],"mappings":";;KAmBY,yBAAyB;;iBAUrB,oBACf,OACA,MACA,UACA,WACA,eACE,yCAAsB,IAAA"}