@resq-systems/email-templates 0.3.0

package/lib/schemas.d.ts

@@ -0,0 +1,86 @@
+import { Schema } from "effect";
+//#region src/schemas.d.ts
+/**
+ * A non-empty, absolute http(s) URL. Validated with a pattern check (blocks
+ * `javascript:`/relative hrefs) but decoded as a plain `string`, so template
+ * props stay ergonomic. Exported for consumers building their own templates.
+ */
+declare const HttpUrl: Schema.String;
+/**
+ * Compliance class of an email send. `transactional` skips unsubscribe UI;
+ * `marketing` requires an unsubscribe affordance in the legal footer.
+ */
+declare const emailCategory: Schema.Literals<readonly ["transactional", "marketing"]>;
+type EmailCategory = typeof emailCategory.Type;
+declare const otpData: Schema.Struct<{
+  readonly code: Schema.NonEmptyString;
+  readonly firstName: Schema.optional<Schema.String>;
+  readonly expiresInMinutes: Schema.optional<Schema.Number>;
+}>;
+declare const welcomeData: Schema.Struct<{
+  readonly firstName: Schema.NonEmptyString;
+  readonly verifyUrl: Schema.optional<Schema.String>;
+}>;
+declare const passwordResetData: Schema.Struct<{
+  readonly firstName: Schema.optional<Schema.String>;
+  readonly resetUrl: Schema.String;
+  readonly expiresInMinutes: Schema.optional<Schema.Number>;
+}>;
+declare const notificationData: Schema.Struct<{
+  readonly title: Schema.NonEmptyString;
+  readonly body: Schema.NonEmptyString;
+  readonly severity: Schema.optional<Schema.Literals<readonly ["info", "success", "warning", "error"]>>;
+  readonly actionUrl: Schema.optional<Schema.String>;
+  readonly actionLabel: Schema.optional<Schema.String>;
+}>;
+declare const incidentAlertData: Schema.Struct<{
+  readonly incidentId: Schema.NonEmptyString;
+  readonly title: Schema.NonEmptyString;
+  readonly severity: Schema.Literals<readonly ["info", "warning", "critical"]>;
+  readonly summary: Schema.NonEmptyString;
+  readonly location: Schema.optional<Schema.String>;
+  readonly detectedAt: Schema.optional<Schema.String>;
+  readonly dashboardUrl: Schema.String;
+}>;
+declare const passwordChangedData: Schema.Struct<{
+  readonly firstName: Schema.optional<Schema.String>;
+  readonly changedAt: Schema.optional<Schema.String>;
+  readonly secureAccountUrl: Schema.optional<Schema.String>;
+}>;
+declare const newDeviceLoginData: Schema.Struct<{
+  readonly firstName: Schema.optional<Schema.String>;
+  readonly device: Schema.optional<Schema.String>;
+  readonly location: Schema.optional<Schema.String>;
+  readonly ipAddress: Schema.optional<Schema.String>;
+  readonly at: Schema.optional<Schema.String>;
+  readonly secureAccountUrl: Schema.optional<Schema.String>;
+}>;
+declare const missionApprovalData: Schema.Struct<{
+  readonly missionId: Schema.NonEmptyString;
+  readonly title: Schema.NonEmptyString;
+  readonly summary: Schema.optional<Schema.String>;
+  readonly requestedBy: Schema.optional<Schema.String>;
+  readonly severity: Schema.optional<Schema.Literals<readonly ["info", "warning", "critical"]>>;
+  readonly approveUrl: Schema.String;
+  readonly expiresInMinutes: Schema.optional<Schema.Number>;
+}>;
+declare const orgInvitationData: Schema.Struct<{
+  readonly orgName: Schema.NonEmptyString;
+  readonly inviterName: Schema.optional<Schema.String>;
+  readonly orgRole: Schema.optional<Schema.String>;
+  readonly acceptUrl: Schema.String;
+  readonly expiresInDays: Schema.optional<Schema.Number>;
+}>;
+/** Inferred `data` types for the built-in templates (used for component props). */
+type OtpData = typeof otpData.Type;
+type WelcomeData = typeof welcomeData.Type;
+type PasswordResetData = typeof passwordResetData.Type;
+type NotificationData = typeof notificationData.Type;
+type IncidentAlertData = typeof incidentAlertData.Type;
+type PasswordChangedData = typeof passwordChangedData.Type;
+type NewDeviceLoginData = typeof newDeviceLoginData.Type;
+type MissionApprovalData = typeof missionApprovalData.Type;
+type OrgInvitationData = typeof orgInvitationData.Type;
+//#endregion
+export { EmailCategory, HttpUrl, IncidentAlertData, MissionApprovalData, NewDeviceLoginData, NotificationData, OrgInvitationData, OtpData, PasswordChangedData, PasswordResetData, WelcomeData, emailCategory, incidentAlertData, missionApprovalData, newDeviceLoginData, notificationData, orgInvitationData, otpData, passwordChangedData, passwordResetData, welcomeData };
+//# sourceMappingURL=schemas.d.ts.map

package/lib/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","names":[],"sources":["../src/schemas.ts"],"mappings":";;;;;;;cAuBa,SAAO,OAAA;;;;;cAMP,eAAa,OAAA;KACd,uBAAuB,cAAc;cAEpC,SAAO,OAAA;;;;;cAMP,aAAW,OAAA;;;;cAKX,mBAAiB,OAAA;;;;;cAMjB,kBAAgB,OAAA;;;;;;;cAQhB,mBAAiB,OAAA;;;;;;;;;cAYjB,qBAAmB,OAAA;;;;;cAQnB,oBAAkB,OAAA;;;;;;;;cAalB,qBAAmB,OAAA;;;;;;;;;cAWnB,mBAAiB,OAAA;;;;;;;;KASlB,iBAAiB,QAAQ;KACzB,qBAAqB,YAAY;KACjC,2BAA2B,kBAAkB;KAC7C,0BAA0B,iBAAiB;KAC3C,2BAA2B,kBAAkB;KAC7C,6BAA6B,oBAAoB;KACjD,4BAA4B,mBAAmB;KAC/C,6BAA6B,oBAAoB;KACjD,2BAA2B,kBAAkB"}

package/lib/schemas.js

@@ -0,0 +1,104 @@
+import { Schema } from "effect";
+//#region src/schemas.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.
+*/
+/**
+* A non-empty, absolute http(s) URL. Validated with a pattern check (blocks
+* `javascript:`/relative hrefs) but decoded as a plain `string`, so template
+* props stay ergonomic. Exported for consumers building their own templates.
+*/
+const HttpUrl = Schema.String.check(Schema.isPattern(/^https?:\/\/\S+$/i));
+/**
+* Compliance class of an email send. `transactional` skips unsubscribe UI;
+* `marketing` requires an unsubscribe affordance in the legal footer.
+*/
+const emailCategory = Schema.Literals(["transactional", "marketing"]);
+const otpData = Schema.Struct({
+	code: Schema.NonEmptyString,
+	firstName: Schema.optional(Schema.String),
+	expiresInMinutes: Schema.optional(Schema.Number)
+});
+const welcomeData = Schema.Struct({
+	firstName: Schema.NonEmptyString,
+	verifyUrl: Schema.optional(HttpUrl)
+});
+const passwordResetData = Schema.Struct({
+	firstName: Schema.optional(Schema.String),
+	resetUrl: HttpUrl,
+	expiresInMinutes: Schema.optional(Schema.Number)
+});
+const notificationData = Schema.Struct({
+	title: Schema.NonEmptyString,
+	body: Schema.NonEmptyString,
+	severity: Schema.optional(Schema.Literals([
+		"info",
+		"success",
+		"warning",
+		"error"
+	])),
+	actionUrl: Schema.optional(HttpUrl),
+	actionLabel: Schema.optional(Schema.String)
+});
+const incidentAlertData = Schema.Struct({
+	incidentId: Schema.NonEmptyString,
+	title: Schema.NonEmptyString,
+	severity: Schema.Literals([
+		"info",
+		"warning",
+		"critical"
+	]),
+	summary: Schema.NonEmptyString,
+	location: Schema.optional(Schema.String),
+	detectedAt: Schema.optional(Schema.String),
+	dashboardUrl: HttpUrl
+});
+const passwordChangedData = Schema.Struct({
+	firstName: Schema.optional(Schema.String),
+	changedAt: Schema.optional(Schema.String),
+	secureAccountUrl: Schema.optional(HttpUrl)
+});
+const newDeviceLoginData = Schema.Struct({
+	firstName: Schema.optional(Schema.String),
+	device: Schema.optional(Schema.String),
+	location: Schema.optional(Schema.String),
+	ipAddress: Schema.optional(Schema.String),
+	at: Schema.optional(Schema.String),
+	secureAccountUrl: Schema.optional(HttpUrl)
+});
+const missionApprovalData = Schema.Struct({
+	missionId: Schema.NonEmptyString,
+	title: Schema.NonEmptyString,
+	summary: Schema.optional(Schema.String),
+	requestedBy: Schema.optional(Schema.String),
+	severity: Schema.optional(Schema.Literals([
+		"info",
+		"warning",
+		"critical"
+	])),
+	approveUrl: HttpUrl,
+	expiresInMinutes: Schema.optional(Schema.Number)
+});
+const orgInvitationData = Schema.Struct({
+	orgName: Schema.NonEmptyString,
+	inviterName: Schema.optional(Schema.String),
+	orgRole: Schema.optional(Schema.String),
+	acceptUrl: HttpUrl,
+	expiresInDays: Schema.optional(Schema.Number)
+});
+//#endregion
+export { HttpUrl, emailCategory, incidentAlertData, missionApprovalData, newDeviceLoginData, notificationData, orgInvitationData, otpData, passwordChangedData, passwordResetData, welcomeData };
+
+//# sourceMappingURL=schemas.js.map

package/lib/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","names":["S"],"sources":["../src/schemas.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 { Schema as S } from \"effect\";\n\n/**\n * A non-empty, absolute http(s) URL. Validated with a pattern check (blocks\n * `javascript:`/relative hrefs) but decoded as a plain `string`, so template\n * props stay ergonomic. Exported for consumers building their own templates.\n */\nexport const HttpUrl = S.String.check(S.isPattern(/^https?:\\/\\/\\S+$/i));\n\n/**\n * Compliance class of an email send. `transactional` skips unsubscribe UI;\n * `marketing` requires an unsubscribe affordance in the legal footer.\n */\nexport const emailCategory = S.Literals([\"transactional\", \"marketing\"]);\nexport type EmailCategory = typeof emailCategory.Type;\n\nexport const otpData = S.Struct({\n\tcode: S.NonEmptyString,\n\tfirstName: S.optional(S.String),\n\texpiresInMinutes: S.optional(S.Number),\n});\n\nexport const welcomeData = S.Struct({\n\tfirstName: S.NonEmptyString,\n\tverifyUrl: S.optional(HttpUrl),\n});\n\nexport const passwordResetData = S.Struct({\n\tfirstName: S.optional(S.String),\n\tresetUrl: HttpUrl,\n\texpiresInMinutes: S.optional(S.Number),\n});\n\nexport const notificationData = S.Struct({\n\ttitle: S.NonEmptyString,\n\tbody: S.NonEmptyString,\n\tseverity: S.optional(S.Literals([\"info\", \"success\", \"warning\", \"error\"])),\n\tactionUrl: S.optional(HttpUrl),\n\tactionLabel: S.optional(S.String),\n});\n\nexport const incidentAlertData = S.Struct({\n\tincidentId: S.NonEmptyString,\n\ttitle: S.NonEmptyString,\n\tseverity: S.Literals([\"info\", \"warning\", \"critical\"]),\n\tsummary: S.NonEmptyString,\n\tlocation: S.optional(S.String),\n\t// Preformatted timestamp string (caller formats/localizes) to avoid\n\t// timezone/format ambiguity inside the email.\n\tdetectedAt: S.optional(S.String),\n\tdashboardUrl: HttpUrl,\n});\n\nexport const passwordChangedData = S.Struct({\n\tfirstName: S.optional(S.String),\n\t// Preformatted timestamp string (caller formats/localizes).\n\tchangedAt: S.optional(S.String),\n\t// Where to secure the account if the change was not authorized.\n\tsecureAccountUrl: S.optional(HttpUrl),\n});\n\nexport const newDeviceLoginData = S.Struct({\n\tfirstName: S.optional(S.String),\n\t// Human-readable client, e.g. \"Chrome on macOS\".\n\tdevice: S.optional(S.String),\n\t// Human-readable place, e.g. \"Newark, DE, USA\".\n\tlocation: S.optional(S.String),\n\tipAddress: S.optional(S.String),\n\t// Preformatted timestamp string (caller formats/localizes).\n\tat: S.optional(S.String),\n\t// Where to review activity / secure the account if the sign-in was not the recipient.\n\tsecureAccountUrl: S.optional(HttpUrl),\n});\n\nexport const missionApprovalData = S.Struct({\n\tmissionId: S.NonEmptyString,\n\ttitle: S.NonEmptyString,\n\tsummary: S.optional(S.String),\n\trequestedBy: S.optional(S.String),\n\tseverity: S.optional(S.Literals([\"info\", \"warning\", \"critical\"])),\n\t// Approver sign-off link (e.g. the HCE mission-approval route).\n\tapproveUrl: HttpUrl,\n\texpiresInMinutes: S.optional(S.Number),\n});\n\nexport const orgInvitationData = S.Struct({\n\torgName: S.NonEmptyString,\n\tinviterName: S.optional(S.String),\n\torgRole: S.optional(S.String),\n\tacceptUrl: HttpUrl,\n\texpiresInDays: S.optional(S.Number),\n});\n\n/** Inferred `data` types for the built-in templates (used for component props). */\nexport type OtpData = typeof otpData.Type;\nexport type WelcomeData = typeof welcomeData.Type;\nexport type PasswordResetData = typeof passwordResetData.Type;\nexport type NotificationData = typeof notificationData.Type;\nexport type IncidentAlertData = typeof incidentAlertData.Type;\nexport type PasswordChangedData = typeof passwordChangedData.Type;\nexport type NewDeviceLoginData = typeof newDeviceLoginData.Type;\nexport type MissionApprovalData = typeof missionApprovalData.Type;\nexport type OrgInvitationData = typeof orgInvitationData.Type;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,UAAUA,OAAE,OAAO,MAAMA,OAAE,UAAU,mBAAmB,CAAC;;;;;AAMtE,MAAa,gBAAgBA,OAAE,SAAS,CAAC,iBAAiB,WAAW,CAAC;AAGtE,MAAa,UAAUA,OAAE,OAAO;CAC/B,MAAMA,OAAE;CACR,WAAWA,OAAE,SAASA,OAAE,MAAM;CAC9B,kBAAkBA,OAAE,SAASA,OAAE,MAAM;AACtC,CAAC;AAED,MAAa,cAAcA,OAAE,OAAO;CACnC,WAAWA,OAAE;CACb,WAAWA,OAAE,SAAS,OAAO;AAC9B,CAAC;AAED,MAAa,oBAAoBA,OAAE,OAAO;CACzC,WAAWA,OAAE,SAASA,OAAE,MAAM;CAC9B,UAAU;CACV,kBAAkBA,OAAE,SAASA,OAAE,MAAM;AACtC,CAAC;AAED,MAAa,mBAAmBA,OAAE,OAAO;CACxC,OAAOA,OAAE;CACT,MAAMA,OAAE;CACR,UAAUA,OAAE,SAASA,OAAE,SAAS;EAAC;EAAQ;EAAW;EAAW;CAAO,CAAC,CAAC;CACxE,WAAWA,OAAE,SAAS,OAAO;CAC7B,aAAaA,OAAE,SAASA,OAAE,MAAM;AACjC,CAAC;AAED,MAAa,oBAAoBA,OAAE,OAAO;CACzC,YAAYA,OAAE;CACd,OAAOA,OAAE;CACT,UAAUA,OAAE,SAAS;EAAC;EAAQ;EAAW;CAAU,CAAC;CACpD,SAASA,OAAE;CACX,UAAUA,OAAE,SAASA,OAAE,MAAM;CAG7B,YAAYA,OAAE,SAASA,OAAE,MAAM;CAC/B,cAAc;AACf,CAAC;AAED,MAAa,sBAAsBA,OAAE,OAAO;CAC3C,WAAWA,OAAE,SAASA,OAAE,MAAM;CAE9B,WAAWA,OAAE,SAASA,OAAE,MAAM;CAE9B,kBAAkBA,OAAE,SAAS,OAAO;AACrC,CAAC;AAED,MAAa,qBAAqBA,OAAE,OAAO;CAC1C,WAAWA,OAAE,SAASA,OAAE,MAAM;CAE9B,QAAQA,OAAE,SAASA,OAAE,MAAM;CAE3B,UAAUA,OAAE,SAASA,OAAE,MAAM;CAC7B,WAAWA,OAAE,SAASA,OAAE,MAAM;CAE9B,IAAIA,OAAE,SAASA,OAAE,MAAM;CAEvB,kBAAkBA,OAAE,SAAS,OAAO;AACrC,CAAC;AAED,MAAa,sBAAsBA,OAAE,OAAO;CAC3C,WAAWA,OAAE;CACb,OAAOA,OAAE;CACT,SAASA,OAAE,SAASA,OAAE,MAAM;CAC5B,aAAaA,OAAE,SAASA,OAAE,MAAM;CAChC,UAAUA,OAAE,SAASA,OAAE,SAAS;EAAC;EAAQ;EAAW;CAAU,CAAC,CAAC;CAEhE,YAAY;CACZ,kBAAkBA,OAAE,SAASA,OAAE,MAAM;AACtC,CAAC;AAED,MAAa,oBAAoBA,OAAE,OAAO;CACzC,SAASA,OAAE;CACX,aAAaA,OAAE,SAASA,OAAE,MAAM;CAChC,SAASA,OAAE,SAASA,OAAE,MAAM;CAC5B,WAAW;CACX,eAAeA,OAAE,SAASA,OAAE,MAAM;AACnC,CAAC"}

package/lib/send/index.d.ts

@@ -0,0 +1,4 @@
+import { EmailSender, SendEmailInput, SendResult } from "./sender.js";
+import { createResendSender } from "./resend-sender.js";
+import { SendEmailOptions, sendEmail } from "./send-email.js";
+export { EmailSender, SendEmailInput, SendEmailOptions, SendResult, createResendSender, sendEmail };

package/lib/send/index.js

@@ -0,0 +1,3 @@
+import { createResendSender } from "./resend-sender.js";
+import { sendEmail } from "./send-email.js";
+export { createResendSender, sendEmail };

package/lib/send/resend-sender.d.ts

@@ -0,0 +1,14 @@
+import { EmailSender } from "./sender.js";
+//#region src/send/resend-sender.d.ts
+/**
+ * Create an {@link EmailSender} backed by Resend.
+ *
+ * Server-only — never import this into a browser bundle or the API key leaks.
+ * The key is read from the explicit argument or the `RESEND_API_KEY` env var and
+ * validated up front (fail fast). Resend returns `{ data, error }` for API-level
+ * failures rather than throwing, so we branch on `error` instead of try/catch.
+ */
+declare function createResendSender(apiKey?: string | undefined): EmailSender;
+//#endregion
+export { createResendSender };
+//# sourceMappingURL=resend-sender.d.ts.map

package/lib/send/resend-sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend-sender.d.ts","names":[],"sources":["../../src/send/resend-sender.ts"],"mappings":";;;;;;;;;;iBA2BgB,mBACf,8BACE"}

package/lib/send/resend-sender.js

@@ -0,0 +1,76 @@
+import { Resend } from "resend";
+//#region src/send/resend-sender.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.
+*/
+/**
+* Create an {@link EmailSender} backed by Resend.
+*
+* Server-only — never import this into a browser bundle or the API key leaks.
+* The key is read from the explicit argument or the `RESEND_API_KEY` env var and
+* validated up front (fail fast). Resend returns `{ data, error }` for API-level
+* failures rather than throwing, so we branch on `error` instead of try/catch.
+*/
+function createResendSender(apiKey = process.env.RESEND_API_KEY) {
+	if (!apiKey) throw new Error("RESEND_API_KEY is required to create a Resend sender");
+	const resend = new Resend(apiKey);
+	return { async send(input) {
+		const payload = {
+			from: input.from,
+			to: input.to,
+			subject: input.subject,
+			html: input.html,
+			text: input.text,
+			replyTo: input.replyTo,
+			cc: input.cc,
+			bcc: input.bcc,
+			headers: input.headers
+		};
+		const options = input.idempotencyKey ? { idempotencyKey: input.idempotencyKey } : void 0;
+		try {
+			const { data, error } = await resend.emails.send(payload, options);
+			if (error) return {
+				ok: false,
+				error: {
+					name: error.name,
+					message: error.message
+				}
+			};
+			if (!data) return {
+				ok: false,
+				error: {
+					name: "unknown_error",
+					message: "Resend returned no data and no error"
+				}
+			};
+			return {
+				ok: true,
+				id: data.id
+			};
+		} catch (err) {
+			return {
+				ok: false,
+				error: {
+					name: "transport_error",
+					message: err instanceof Error ? err.message : String(err)
+				}
+			};
+		}
+	} };
+}
+//#endregion
+export { createResendSender };
+
+//# sourceMappingURL=resend-sender.js.map

package/lib/send/resend-sender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend-sender.js","names":[],"sources":["../../src/send/resend-sender.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 { Resend } from \"resend\";\nimport type { EmailSender, SendEmailInput, SendResult } from \"./sender.js\";\n\n/**\n * Create an {@link EmailSender} backed by Resend.\n *\n * Server-only — never import this into a browser bundle or the API key leaks.\n * The key is read from the explicit argument or the `RESEND_API_KEY` env var and\n * validated up front (fail fast). Resend returns `{ data, error }` for API-level\n * failures rather than throwing, so we branch on `error` instead of try/catch.\n */\nexport function createResendSender(\n\tapiKey: string | undefined = process.env.RESEND_API_KEY,\n): EmailSender {\n\tif (!apiKey) {\n\t\tthrow new Error(\"RESEND_API_KEY is required to create a Resend sender\");\n\t}\n\n\tconst resend = new Resend(apiKey);\n\n\treturn {\n\t\tasync send(input: SendEmailInput): Promise<SendResult> {\n\t\t\t// `to`/`html`/`text` are always populated on the pipeline path (see\n\t\t\t// renderEmail); the localized cast keeps Resend's html|text|react union\n\t\t\t// happy without leaking `any`.\n\t\t\tconst payload = {\n\t\t\t\tfrom: input.from,\n\t\t\t\tto: input.to,\n\t\t\t\tsubject: input.subject,\n\t\t\t\thtml: input.html,\n\t\t\t\ttext: input.text,\n\t\t\t\treplyTo: input.replyTo,\n\t\t\t\tcc: input.cc,\n\t\t\t\tbcc: input.bcc,\n\t\t\t\theaders: input.headers,\n\t\t\t} as Parameters<typeof resend.emails.send>[0];\n\n\t\t\tconst options = input.idempotencyKey ? { idempotencyKey: input.idempotencyKey } : undefined;\n\n\t\t\ttry {\n\t\t\t\tconst { data, error } = await resend.emails.send(payload, options);\n\n\t\t\t\tif (error) {\n\t\t\t\t\treturn { ok: false, error: { name: error.name, message: error.message } };\n\t\t\t\t}\n\n\t\t\t\tif (!data) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tok: false,\n\t\t\t\t\t\terror: { name: \"unknown_error\", message: \"Resend returned no data and no error\" },\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\treturn { ok: true, id: data.id };\n\t\t\t} catch (err) {\n\t\t\t\t// The SDK returns { data, error } for API errors, but can still THROW\n\t\t\t\t// on transport failures (fetch rejection, DNS, aborted request), so the\n\t\t\t\t// whole call is wrapped to honor the never-throws contract of send().\n\t\t\t\treturn {\n\t\t\t\t\tok: false,\n\t\t\t\t\terror: {\n\t\t\t\t\t\tname: \"transport_error\",\n\t\t\t\t\t\tmessage: err instanceof Error ? err.message : String(err),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,mBACf,SAA6B,QAAQ,IAAI,gBAC3B;CACd,IAAI,CAAC,QACJ,MAAM,IAAI,MAAM,sDAAsD;CAGvE,MAAM,SAAS,IAAI,OAAO,MAAM;CAEhC,OAAO,EACN,MAAM,KAAK,OAA4C;EAItD,MAAM,UAAU;GACf,MAAM,MAAM;GACZ,IAAI,MAAM;GACV,SAAS,MAAM;GACf,MAAM,MAAM;GACZ,MAAM,MAAM;GACZ,SAAS,MAAM;GACf,IAAI,MAAM;GACV,KAAK,MAAM;GACX,SAAS,MAAM;EAChB;EAEA,MAAM,UAAU,MAAM,iBAAiB,EAAE,gBAAgB,MAAM,eAAe,IAAI,KAAA;EAElF,IAAI;GACH,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,OAAO,KAAK,SAAS,OAAO;GAEjE,IAAI,OACH,OAAO;IAAE,IAAI;IAAO,OAAO;KAAE,MAAM,MAAM;KAAM,SAAS,MAAM;IAAQ;GAAE;GAGzE,IAAI,CAAC,MACJ,OAAO;IACN,IAAI;IACJ,OAAO;KAAE,MAAM;KAAiB,SAAS;IAAuC;GACjF;GAGD,OAAO;IAAE,IAAI;IAAM,IAAI,KAAK;GAAG;EAChC,SAAS,KAAK;GAIb,OAAO;IACN,IAAI;IACJ,OAAO;KACN,MAAM;KACN,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;IACzD;GACD;EACD;CACD,EACD;AACD"}

package/lib/send/send-email.d.ts

@@ -0,0 +1,19 @@
+import { EmailSender, SendResult } from "./sender.js";
+//#region src/send/send-email.d.ts
+interface SendEmailOptions {
+  /** Verified sender address, e.g. "ResQ Systems <updates@send.resq.software>". */
+  from: string;
+  replyTo?: string | string[];
+  /** Stable key so Resend de-dupes identical sends for 24h. */
+  idempotencyKey?: string;
+  /** Extra headers passed through to the sender. */
+  headers?: Record<string, string>;
+}
+/**
+ * Render a validated payload and hand it to a sender in one call. Convenience
+ * wiring for the common pipeline case: `sendEmail(sender, payload, { from })`.
+ */
+declare function sendEmail(sender: EmailSender, payload: unknown, options: SendEmailOptions): Promise<SendResult>;
+//#endregion
+export { SendEmailOptions, sendEmail };
+//# sourceMappingURL=send-email.d.ts.map

package/lib/send/send-email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-email.d.ts","names":[],"sources":["../../src/send/send-email.ts"],"mappings":";;UAoBiB;;EAEhB;EACA;;EAEA;;EAEA,UAAU;;;;;;iBAOW,UACrB,QAAQ,aACR,kBACA,SAAS,mBACP,QAAQ"}

package/lib/send/send-email.js

@@ -0,0 +1,67 @@
+import { EmailValidationError } from "../mailer.js";
+import { renderEmail } from "../render.js";
+//#region src/send/send-email.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.
+*/
+/**
+* Render a validated payload and hand it to a sender in one call. Convenience
+* wiring for the common pipeline case: `sendEmail(sender, payload, { from })`.
+*/
+async function sendEmail(sender, payload, options) {
+	let rendered;
+	try {
+		rendered = await renderEmail(payload);
+	} catch (err) {
+		if (err instanceof EmailValidationError) return {
+			ok: false,
+			error: {
+				name: err.name,
+				message: err.message
+			}
+		};
+		return {
+			ok: false,
+			error: {
+				name: "render_error",
+				message: err instanceof Error ? err.message : String(err)
+			}
+		};
+	}
+	try {
+		return await sender.send({
+			from: options.from,
+			to: rendered.to,
+			subject: rendered.subject,
+			html: rendered.html,
+			text: rendered.text,
+			replyTo: options.replyTo,
+			idempotencyKey: options.idempotencyKey,
+			headers: options.headers
+		});
+	} catch (err) {
+		return {
+			ok: false,
+			error: {
+				name: "sender_error",
+				message: err instanceof Error ? err.message : String(err)
+			}
+		};
+	}
+}
+//#endregion
+export { sendEmail };
+
+//# sourceMappingURL=send-email.js.map

package/lib/send/send-email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-email.js","names":[],"sources":["../../src/send/send-email.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 { EmailValidationError } from \"../mailer.js\";\nimport { renderEmail } from \"../render.js\";\nimport type { EmailSender, SendResult } from \"./sender.js\";\n\nexport interface SendEmailOptions {\n\t/** Verified sender address, e.g. \"ResQ Systems <updates@send.resq.software>\". */\n\tfrom: string;\n\treplyTo?: string | string[];\n\t/** Stable key so Resend de-dupes identical sends for 24h. */\n\tidempotencyKey?: string;\n\t/** Extra headers passed through to the sender. */\n\theaders?: Record<string, string>;\n}\n\n/**\n * Render a validated payload and hand it to a sender in one call. Convenience\n * wiring for the common pipeline case: `sendEmail(sender, payload, { from })`.\n */\nexport async function sendEmail(\n\tsender: EmailSender,\n\tpayload: unknown,\n\toptions: SendEmailOptions,\n): Promise<SendResult> {\n\tlet rendered: Awaited<ReturnType<typeof renderEmail>>;\n\ttry {\n\t\trendered = await renderEmail(payload);\n\t} catch (err) {\n\t\t// Preserve the never-throws SendResult contract (see the sender adapters):\n\t\t// an invalid payload — or any other render failure — becomes a failure\n\t\t// result instead of a rejected promise, so pipeline callers that only\n\t\t// branch on `SendResult` never hit an unhandled rejection.\n\t\t// EmailValidationError keeps its name so callers can tell a bad payload\n\t\t// apart from an unexpected render error.\n\t\tif (err instanceof EmailValidationError) {\n\t\t\treturn { ok: false, error: { name: err.name, message: err.message } };\n\t\t}\n\t\treturn {\n\t\t\tok: false,\n\t\t\terror: {\n\t\t\t\tname: \"render_error\",\n\t\t\t\tmessage: err instanceof Error ? err.message : String(err),\n\t\t\t},\n\t\t};\n\t}\n\n\ttry {\n\t\treturn await sender.send({\n\t\t\tfrom: options.from,\n\t\t\tto: rendered.to,\n\t\t\tsubject: rendered.subject,\n\t\t\thtml: rendered.html,\n\t\t\ttext: rendered.text,\n\t\t\treplyTo: options.replyTo,\n\t\t\tidempotencyKey: options.idempotencyKey,\n\t\t\theaders: options.headers,\n\t\t});\n\t} catch (err) {\n\t\t// EmailSender.send is expected to normalize failures into SendResult, but a\n\t\t// third-party sender might still throw; keep sendEmail's never-throws\n\t\t// contract regardless, tagged distinctly so it isn't confused with a\n\t\t// render_error.\n\t\treturn {\n\t\t\tok: false,\n\t\t\terror: {\n\t\t\t\tname: \"sender_error\",\n\t\t\t\tmessage: err instanceof Error ? err.message : String(err),\n\t\t\t},\n\t\t};\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAkCA,eAAsB,UACrB,QACA,SACA,SACsB;CACtB,IAAI;CACJ,IAAI;EACH,WAAW,MAAM,YAAY,OAAO;CACrC,SAAS,KAAK;EAOb,IAAI,eAAe,sBAClB,OAAO;GAAE,IAAI;GAAO,OAAO;IAAE,MAAM,IAAI;IAAM,SAAS,IAAI;GAAQ;EAAE;EAErE,OAAO;GACN,IAAI;GACJ,OAAO;IACN,MAAM;IACN,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GACzD;EACD;CACD;CAEA,IAAI;EACH,OAAO,MAAM,OAAO,KAAK;GACxB,MAAM,QAAQ;GACd,IAAI,SAAS;GACb,SAAS,SAAS;GAClB,MAAM,SAAS;GACf,MAAM,SAAS;GACf,SAAS,QAAQ;GACjB,gBAAgB,QAAQ;GACxB,SAAS,QAAQ;EAClB,CAAC;CACF,SAAS,KAAK;EAKb,OAAO;GACN,IAAI;GACJ,OAAO;IACN,MAAM;IACN,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GACzD;EACD;CACD;AACD"}

package/lib/send/sender.d.ts

@@ -0,0 +1,58 @@
+//#region src/send/sender.d.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.
+ */
+/** Provider-agnostic input for sending a single email. */
+interface SendEmailInput {
+  from: string;
+  to: string | string[];
+  subject: string;
+  html?: string;
+  text?: string;
+  replyTo?: string | string[];
+  cc?: string | string[];
+  bcc?: string | string[];
+  /** Stable key so Resend de-dupes identical sends for 24h. */
+  idempotencyKey?: string;
+  /** Extra headers, e.g. RFC 8058 `List-Unsubscribe` for marketing mail. */
+  headers?: Record<string, string>;
+}
+/** Normalized send result. Providers map their responses onto this shape. */
+type SendResult = {
+  ok: true;
+  id: string;
+} | {
+  ok: false;
+  error: {
+    name: string;
+    message: string;
+  };
+};
+/**
+ * Port for an email transport. Implement this to plug in any provider (Resend,
+ * SES, Postmark, SMTP); the rest of the package depends only on this interface.
+ */
+interface EmailSender {
+  /**
+   * Send one email. Implementations SHOULD normalize transport/API failures into
+   * a `{ ok: false, error }` result rather than throwing (the bundled Resend
+   * adapter does). `sendEmail` still guards against a throwing sender, but
+   * honoring this contract keeps the failure `name`/`message` provider-accurate.
+   */
+  send(input: SendEmailInput): Promise<SendResult>;
+}
+//#endregion
+export { EmailSender, SendEmailInput, SendResult };
+//# sourceMappingURL=sender.d.ts.map

package/lib/send/sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.d.ts","names":[],"sources":["../../src/send/sender.ts"],"mappings":";;;;;;;;;;;;;;;;;UAiBiB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;;EAEA,UAAU;;;KAIC;EACP;EAAU;;EACV;EAAW;IAAS;IAAc;;;;;;;UAMtB;;;;;;;EAOhB,KAAK,OAAO,iBAAiB,QAAQ"}

package/lib/suite.d.ts

@@ -0,0 +1,130 @@
+import { Mailer } from "./mailer.js";
+//#region src/suite.d.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.
+ */
+/**
+ * The default mailer over the built-in ResQ Systems templates — the single source of
+ * truth behind the package's `EmailPayload`, `decodeEmailPayload`, `registry`,
+ * and `renderEmail` exports.
+ */
+declare const resqMailer: Mailer<{
+  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 { resqMailer };
+//# sourceMappingURL=suite.d.ts.map

package/lib/suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite.d.ts","names":[],"sources":["../src/suite.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;cAwBa,YAAA"}

package/lib/suite.js

@@ -0,0 +1,28 @@
+import { createMailer } from "./mailer.js";
+import { resqEmailTemplates } from "./templates.js";
+//#region src/suite.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.
+*/
+/**
+* The default mailer over the built-in ResQ Systems templates — the single source of
+* truth behind the package's `EmailPayload`, `decodeEmailPayload`, `registry`,
+* and `renderEmail` exports.
+*/
+const resqMailer = createMailer(resqEmailTemplates);
+//#endregion
+export { resqMailer };
+
+//# sourceMappingURL=suite.js.map

package/lib/suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite.js","names":[],"sources":["../src/suite.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 { createMailer } from \"./mailer.js\";\nimport { resqEmailTemplates } from \"./templates.js\";\n\n/**\n * The default mailer over the built-in ResQ Systems templates — the single source of\n * truth behind the package's `EmailPayload`, `decodeEmailPayload`, `registry`,\n * and `renderEmail` exports.\n */\nexport const resqMailer = createMailer(resqEmailTemplates);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,aAAa,aAAa,kBAAkB"}