@decocms/apps-resend 8.0.0 → 8.1.0-next.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/apps-resend",
-  "version": "8.0.0",
+  "version": "8.1.0-next.0",
   "type": "module",
   "description": "Deco app: Resend transactional email integration",
   "repository": {
@@ -28,8 +28,8 @@
     "lint:unused": "knip"
   },
   "dependencies": {
-    "@decocms/blocks": "8.0.0",
-    "@decocms/apps-commerce": "8.0.0"
+    "@decocms/blocks": "8.1.0-next.0",
+    "@decocms/apps-commerce": "8.1.0-next.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/src/__tests__/emails.test.ts

@@ -0,0 +1,54 @@
+/**
+ * The v8 Resend client (/next/upstream-clients): one typed call through the
+ * instrumented fetch, errors without bodies or keys, no retries.
+ */
+import { describe, expect, it, vi } from "vitest";
+import { createResendClient, ResendError } from "../index";
+
+function fakeFetch(status: number, body: unknown) {
+  return vi.fn(
+    async (_input: string | URL | Request, _init?: RequestInit) =>
+      new Response(JSON.stringify(body), { status }),
+  );
+}
+
+const email = {
+  from: "Store <hello@example.com>",
+  to: "shopper@example.com",
+  subject: "Your order",
+  html: "<p>Thanks</p>",
+};
+
+describe("createResendClient", () => {
+  it("sendEmail posts the email with the API key and returns its id", async () => {
+    const fetch = fakeFetch(200, { id: "email_1" });
+    const resend = createResendClient({ apiKey: "re_test" }, { fetch });
+
+    await expect(resend.sendEmail(email)).resolves.toEqual({ id: "email_1" });
+
+    const [url, init] = fetch.mock.calls[0];
+    expect(String(url)).toBe("https://api.resend.com/emails");
+    expect(init?.method).toBe("POST");
+    expect(init?.headers).toMatchObject({ authorization: "Bearer re_test" });
+    expect(JSON.parse(String(init?.body))).toEqual(email);
+  });
+
+  it("throws the operation and status, never the body or the key", async () => {
+    const fetch = fakeFetch(422, { name: "validation_error", message: "re_test is bad" });
+    const resend = createResendClient({ apiKey: "re_test" }, { fetch });
+
+    const error = await resend.sendEmail(email).catch((e: unknown) => e);
+
+    expect(error).toBeInstanceOf(ResendError);
+    expect(error).toMatchObject({ operation: "sendEmail", status: 422 });
+    expect((error as Error).message).not.toContain("re_test");
+  });
+
+  it("does not retry", async () => {
+    const fetch = fakeFetch(503, {});
+    const resend = createResendClient({ apiKey: "re_test" }, { fetch });
+
+    await expect(resend.sendEmail(email)).rejects.toThrow(ResendError);
+    expect(fetch).toHaveBeenCalledTimes(1);
+  });
+});

package/src/__tests__/send.test.ts

@@ -35,19 +35,23 @@ describe("sendEmail", () => {
 		expect(result.data).toEqual({ id: "email_abc123" });
 		expect(result.error).toBeNull();
 
-		expect(fetchSpy).toHaveBeenCalledWith("https://api.resend.com/emails", {
-			method: "POST",
-			headers: {
-				Authorization: "Bearer re_test_123",
-				"Content-Type": "application/json",
-			},
-			body: JSON.stringify({
-				from: "Test <test@example.com>",
-				to: "user@example.com",
-				subject: "Hello",
-				html: "<p>World</p>",
+		expect(fetchSpy).toHaveBeenCalledWith(
+			"https://api.resend.com/emails",
+			expect.objectContaining({
+				method: "POST",
+				headers: {
+					Authorization: "Bearer re_test_123",
+					"Content-Type": "application/json",
+				},
+				body: JSON.stringify({
+					from: "Test <test@example.com>",
+					to: "user@example.com",
+					subject: "Hello",
+					html: "<p>World</p>",
+				}),
+				signal: expect.any(AbortSignal),
 			}),
-		});
+		);
 	});
 
 	it("falls back to defaults when fields are omitted", async () => {

package/src/actions/send.ts

@@ -1,6 +1,9 @@
+import { withFetchTimeout } from "@decocms/blocks/sdk/fetchTimeout";
 import { getResendConfig } from "../client";
 import type { CreateEmailOptions, CreateEmailResponse } from "../types";
 
+const timeoutFetch = withFetchTimeout();
+
 /**
  * Send an email via Resend API.
  *
@@ -32,7 +35,7 @@ export async function sendEmail(
 		...(payload.headers && { headers: payload.headers }),
 	};
 
-	const response = await fetch("https://api.resend.com/emails", {
+	const response = await timeoutFetch("https://api.resend.com/emails", {
 		method: "POST",
 		headers: {
 			Authorization: `Bearer ${config.apiKey}`,

package/src/emails.ts

@@ -0,0 +1,52 @@
+/**
+ * The Resend client: a thin client for the Resend REST API.
+ * See /next/upstream-clients.
+ *
+ * Every request goes through `createInstrumentedFetch` (provider `resend`).
+ * No retries or circuit breaker: sending an email isn't safe to repeat.
+ * Default senders, recipients and subjects belong to the site.
+ */
+import { createInstrumentedFetch } from "@decocms/blocks/fetch";
+import type { CreateEmailOptions, CreateEmailResponseSuccess } from "./types";
+
+export interface ResendClientConfig {
+  apiKey: string;
+}
+
+/** A Resend email; the API requires a sender. */
+export type SendEmailOptions = CreateEmailOptions & { from: string };
+
+export class ResendError extends Error {
+  constructor(
+    readonly operation: string,
+    readonly status: number,
+  ) {
+    super(`resend ${operation} failed with HTTP ${status}`);
+  }
+}
+
+export function createResendClient(
+  config: ResendClientConfig,
+  options: { fetch?: typeof globalThis.fetch } = {},
+) {
+  const request = createInstrumentedFetch({ provider: "resend", fetch: options.fetch });
+
+  return {
+    /** Sends one email and returns its id. */
+    async sendEmail(email: SendEmailOptions): Promise<CreateEmailResponseSuccess> {
+      const response = await request("https://api.resend.com/emails", {
+        operation: "sendEmail",
+        method: "POST",
+        headers: {
+          authorization: `Bearer ${config.apiKey}`,
+          "content-type": "application/json",
+        },
+        body: JSON.stringify(email),
+      });
+      if (!response.ok) throw new ResendError("sendEmail", response.status);
+      return (await response.json()) as CreateEmailResponseSuccess;
+    },
+  };
+}
+
+export type ResendClient = ReturnType<typeof createResendClient>;

package/src/index.ts

@@ -1,10 +1,24 @@
+/**
+ * `@decocms/apps-resend`: the Resend client (`createResendClient`).
+ * See /next/upstream-clients.
+ *
+ * `sendEmail`, `configureResend` and `getResendConfig` are the v7 surface,
+ * kept for v7 sites.
+ */
 export { sendEmail } from "./actions/send";
 export { configureResend, getResendConfig } from "./client";
+export {
+  createResendClient,
+  type ResendClient,
+  type ResendClientConfig,
+  ResendError,
+  type SendEmailOptions,
+} from "./emails";
 export type {
-	CreateEmailOptions,
-	CreateEmailResponse,
-	CreateEmailResponseSuccess,
-	ErrorResponse,
-	ResendConfig,
-	ResendErrorCodeKey,
+  CreateEmailOptions,
+  CreateEmailResponse,
+  CreateEmailResponseSuccess,
+  ErrorResponse,
+  ResendConfig,
+  ResendErrorCodeKey,
 } from "./types";