@decocms/apps 0.25.2 → 0.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/apps",
-  "version": "0.25.2",
+  "version": "0.26.0",
   "type": "module",
   "description": "Deco commerce apps for TanStack Start - Shopify, VTEX, commerce types, analytics utils",
   "exports": {
@@ -37,7 +37,11 @@
     "./vtex/hooks/*": "./vtex/hooks/*.ts",
     "./vtex/inline-loaders/workflowProducts": "./vtex/inline-loaders/workflowProducts.ts",
     "./vtex/middleware": "./vtex/middleware.ts",
-    "./vtex/invoke": "./vtex/invoke.ts"
+    "./vtex/invoke": "./vtex/invoke.ts",
+    "./resend": "./resend/index.ts",
+    "./resend/client": "./resend/client.ts",
+    "./resend/types": "./resend/types.ts",
+    "./resend/actions/send": "./resend/actions/send.ts"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -68,6 +72,7 @@
     "commerce/",
     "shopify/",
     "vtex/",
+    "resend/",
     "!**/__tests__/"
   ],
   "engines": {

package/resend/actions/send.ts

@@ -0,0 +1,57 @@
+import { getResendConfig } from "../client";
+import type { CreateEmailOptions, CreateEmailResponse } from "../types";
+
+/**
+ * Send an email via Resend API.
+ *
+ * ```ts
+ * import { sendEmail } from "@decocms/apps/resend/actions/send";
+ *
+ * const result = await sendEmail({
+ *   subject: "Hello",
+ *   html: "<p>World</p>",
+ * });
+ * ```
+ *
+ * Fields not provided fall back to the defaults set in `configureResend()`.
+ */
+export async function sendEmail(
+	payload: Partial<CreateEmailOptions> & { subject?: string; html?: string },
+): Promise<CreateEmailResponse> {
+	const config = getResendConfig();
+
+	const body: CreateEmailOptions = {
+		from: payload.from ?? config.emailFrom ?? "Contact <onboarding@resend.dev>",
+		to: payload.to ?? config.emailTo ?? [],
+		subject: payload.subject ?? config.subject ?? "No subject",
+		...(payload.bcc && { bcc: payload.bcc }),
+		...(payload.cc && { cc: payload.cc }),
+		...(payload.reply_to && { reply_to: payload.reply_to }),
+		...(payload.html && { html: payload.html }),
+		...(payload.text && { text: payload.text }),
+		...(payload.headers && { headers: payload.headers }),
+	};
+
+	const response = await fetch("https://api.resend.com/emails", {
+		method: "POST",
+		headers: {
+			Authorization: `Bearer ${config.apiKey}`,
+			"Content-Type": "application/json",
+		},
+		body: JSON.stringify(body),
+	});
+
+	const data = await response.json();
+
+	if (!response.ok) {
+		return {
+			data: null,
+			error: data,
+		};
+	}
+
+	return {
+		data,
+		error: null,
+	};
+}

package/resend/client.ts

@@ -0,0 +1,30 @@
+import type { ResendConfig } from "./types";
+
+let _config: ResendConfig | null = null;
+
+/**
+ * Configure the Resend client. Call once in your site's setup.ts.
+ *
+ * ```ts
+ * import { configureResend } from "@decocms/apps/resend/client";
+ *
+ * configureResend({
+ *   apiKey: process.env.RESEND_API_KEY!,
+ *   emailFrom: "Contact <hello@example.com>",
+ *   emailTo: ["team@example.com"],
+ *   subject: "Contact form submission",
+ * });
+ * ```
+ */
+export function configureResend(config: ResendConfig) {
+	_config = config;
+}
+
+export function getResendConfig(): ResendConfig {
+	if (!_config) {
+		throw new Error(
+			"Resend not configured. Call configureResend() in setup.ts before using Resend actions.",
+		);
+	}
+	return _config;
+}

package/resend/index.ts

@@ -0,0 +1,10 @@
+export { sendEmail } from "./actions/send";
+export { configureResend, getResendConfig } from "./client";
+export type {
+	CreateEmailOptions,
+	CreateEmailResponse,
+	CreateEmailResponseSuccess,
+	ErrorResponse,
+	ResendConfig,
+	ResendErrorCodeKey,
+} from "./types";

package/resend/types.ts

@@ -0,0 +1,54 @@
+export const RESEND_ERROR_CODES_BY_KEY = {
+	missing_required_field: 422,
+	invalid_access: 422,
+	invalid_parameter: 422,
+	invalid_region: 422,
+	rate_limit_exceeded: 429,
+	missing_api_key: 401,
+	invalid_api_Key: 403,
+	invalid_from_address: 403,
+	validation_error: 403,
+	not_found: 404,
+	method_not_allowed: 405,
+	application_error: 500,
+	internal_server_error: 500,
+} as const;
+
+export type ResendErrorCodeKey = keyof typeof RESEND_ERROR_CODES_BY_KEY;
+
+export interface ErrorResponse {
+	message: string;
+	name: ResendErrorCodeKey;
+}
+
+export interface CreateEmailResponseSuccess {
+	/** The ID of the newly created email. */
+	id: string;
+}
+
+export interface CreateEmailResponse {
+	data: CreateEmailResponseSuccess | null;
+	error: ErrorResponse | null;
+}
+
+export interface CreateEmailOptions {
+	from?: string;
+	to: string | string[];
+	subject: string;
+	bcc?: string | string[];
+	cc?: string | string[];
+	reply_to?: string | string[];
+	html?: string;
+	text?: string;
+	headers?: Record<string, string>;
+}
+
+export interface ResendConfig {
+	apiKey: string;
+	/** Default sender — e.g. "Contact <onboarding@resend.dev>" */
+	emailFrom?: string;
+	/** Default recipients */
+	emailTo?: string[];
+	/** Default subject */
+	subject?: string;
+}