@headless-lms/adapter-email-resend 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mdwt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @headless-lms/adapter-email-resend
+
+Resend implementation of the `EmailSender` port from `@headless-lms/core/types`.
+
+The adapter reads no environment itself — the installation's `config.ts` parses
+env into a `ResendEmailConfig` and injects the constructed adapter:
+
+```ts
+import { ResendEmailAdapter } from "@headless-lms/adapter-email-resend";
+
+const container = await createContainer(config, {
+  adapters: { email: new ResendEmailAdapter({ apiKey, from }) },
+});
+```
+
+## Environment variables (reference installation)
+
+| Variable         | Required | Maps to  | Notes                                                    |
+| ---------------- | -------- | -------- | -------------------------------------------------------- |
+| `RESEND_API_KEY` | yes      | `apiKey` | Unset → no adapter injected; email sends fail loudly.    |
+| `EMAIL_FROM`     | no       | `from`   | e.g. `Acme LMS <noreply@acme.com>`, on a verified Resend domain. Defaults to `onboarding@resend.dev`. |

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { EmailMessage, EmailSender, Logger } from "@headless-lms/core/types";
+//#region src/index.d.ts
+interface ResendEmailConfig {
+  apiKey: string;
+  /** Sender, e.g. "Acme LMS <noreply@acme.com>". Must be on a verified Resend domain. */
+  from: string;
+}
+declare class ResendEmailAdapter implements EmailSender {
+  private readonly config;
+  private readonly logger?;
+  private readonly fetchFn;
+  constructor(config: ResendEmailConfig, logger?: Logger | undefined, fetchFn?: typeof fetch);
+  send(message: EmailMessage): Promise<void>;
+}
+//#endregion
+export { ResendEmailAdapter, ResendEmailConfig };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,41 @@
+//#region src/index.ts
+const RESEND_ENDPOINT = "https://api.resend.com/emails";
+var ResendEmailAdapter = class {
+	config;
+	logger;
+	fetchFn;
+	constructor(config, logger, fetchFn = fetch) {
+		this.config = config;
+		this.logger = logger;
+		this.fetchFn = fetchFn;
+	}
+	async send(message) {
+		const response = await this.fetchFn(RESEND_ENDPOINT, {
+			method: "POST",
+			headers: {
+				authorization: `Bearer ${this.config.apiKey}`,
+				"content-type": "application/json"
+			},
+			body: JSON.stringify({
+				from: this.config.from,
+				to: message.to,
+				subject: message.subject,
+				text: message.text,
+				...message.html !== void 0 && { html: message.html }
+			})
+		});
+		if (!response.ok) {
+			const detail = await response.json().then((body) => body && typeof body === "object" && "message" in body ? String(body.message) : "").catch(() => "");
+			this.logger?.error("email send failed", {
+				to: message.to,
+				status: response.status,
+				detail
+			});
+			throw new Error(`resend responded ${response.status}${detail ? `: ${detail}` : ""}`);
+		}
+	}
+};
+//#endregion
+export { ResendEmailAdapter };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["// Resend implementation of the EmailSender port.\nimport type { EmailSender, EmailMessage, Logger } from \"@headless-lms/core/types\";\n\nconst RESEND_ENDPOINT = \"https://api.resend.com/emails\";\n\nexport interface ResendEmailConfig {\n  apiKey: string;\n  /** Sender, e.g. \"Acme LMS <noreply@acme.com>\". Must be on a verified Resend domain. */\n  from: string;\n}\n\nexport class ResendEmailAdapter implements EmailSender {\n  constructor(\n    private readonly config: ResendEmailConfig,\n    private readonly logger?: Logger,\n    private readonly fetchFn: typeof fetch = fetch,\n  ) {}\n\n  async send(message: EmailMessage): Promise<void> {\n    const response = await this.fetchFn(RESEND_ENDPOINT, {\n      method: \"POST\",\n      headers: {\n        authorization: `Bearer ${this.config.apiKey}`,\n        \"content-type\": \"application/json\",\n      },\n      body: JSON.stringify({\n        from: this.config.from,\n        to: message.to,\n        subject: message.subject,\n        text: message.text,\n        ...(message.html !== undefined && { html: message.html }),\n      }),\n    });\n    if (!response.ok) {\n      const detail = await response\n        .json()\n        .then((body: unknown) =>\n          body && typeof body === \"object\" && \"message\" in body ? String(body.message) : \"\",\n        )\n        .catch(() => \"\");\n      this.logger?.error(\"email send failed\", { to: message.to, status: response.status, detail });\n      throw new Error(`resend responded ${response.status}${detail ? `: ${detail}` : \"\"}`);\n    }\n  }\n}\n"],"mappings":";AAGA,MAAM,kBAAkB;AAQxB,IAAa,qBAAb,MAAuD;CAElC;CACA;CACA;CAHnB,YACE,QACA,QACA,UAAyC,OACzC;EAHiB,KAAA,SAAA;EACA,KAAA,SAAA;EACA,KAAA,UAAA;CAChB;CAEH,MAAM,KAAK,SAAsC;EAC/C,MAAM,WAAW,MAAM,KAAK,QAAQ,iBAAiB;GACnD,QAAQ;GACR,SAAS;IACP,eAAe,UAAU,KAAK,OAAO;IACrC,gBAAgB;GAClB;GACA,MAAM,KAAK,UAAU;IACnB,MAAM,KAAK,OAAO;IAClB,IAAI,QAAQ;IACZ,SAAS,QAAQ;IACjB,MAAM,QAAQ;IACd,GAAI,QAAQ,SAAS,KAAA,KAAa,EAAE,MAAM,QAAQ,KAAK;GACzD,CAAC;EACH,CAAC;EACD,IAAI,CAAC,SAAS,IAAI;GAChB,MAAM,SAAS,MAAM,SAClB,KAAK,CAAC,CACN,MAAM,SACL,QAAQ,OAAO,SAAS,YAAY,aAAa,OAAO,OAAO,KAAK,OAAO,IAAI,EACjF,CAAC,CACA,YAAY,EAAE;GACjB,KAAK,QAAQ,MAAM,qBAAqB;IAAE,IAAI,QAAQ;IAAI,QAAQ,SAAS;IAAQ;GAAO,CAAC;GAC3F,MAAM,IAAI,MAAM,oBAAoB,SAAS,SAAS,SAAS,KAAK,WAAW,IAAI;EACrF;CACF;AACF"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@headless-lms/adapter-email-resend",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@headless-lms/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsdown": "^0.22.9",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "description": "Resend email adapter for the headless LMS",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mdwt/headless-lms.git",
+    "directory": "adapters/email-resend"
+  },
+  "homepage": "https://github.com/mdwt/headless-lms#readme",
+  "bugs": {
+    "url": "https://github.com/mdwt/headless-lms/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}