@decocms/apps 0.25.2 → 0.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/apps",
-  "version": "0.25.2",
+  "version": "0.27.0",
   "type": "module",
   "description": "Deco commerce apps for TanStack Start - Shopify, VTEX, commerce types, analytics utils",
   "exports": {
@@ -37,7 +37,12 @@
     "./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/mod": "./resend/mod.ts",
+    "./resend/client": "./resend/client.ts",
+    "./resend/types": "./resend/types.ts",
+    "./resend/actions/send": "./resend/actions/send.ts"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -68,6 +73,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/mod.ts

@@ -0,0 +1,53 @@
+/**
+ * Resend app module — standard autoconfig contract.
+ *
+ * Each Deco app exports:
+ * - `configure(blockData, resolveSecret)` — set up the client from CMS block data
+ * - `handlers` — record of invoke handler keys → handler functions
+ *
+ * The framework's `autoconfigApps()` calls these generically — no hardcoded
+ * app knowledge needed in the framework.
+ */
+
+import { configureResend } from "./client";
+import { sendEmail } from "./actions/send";
+
+export interface AppModContract {
+	configure: (
+		blockData: any,
+		resolveSecret: (value: unknown, envKey: string) => Promise<string | null>,
+	) => Promise<boolean>;
+	handlers: Record<string, (props: any, request: Request) => Promise<any>>;
+}
+
+/**
+ * Configure Resend from CMS block data.
+ * Returns true if configured successfully, false if missing credentials.
+ */
+export async function configure(
+	block: any,
+	resolveSecret: (value: unknown, envKey: string) => Promise<string | null>,
+): Promise<boolean> {
+	const apiKey = await resolveSecret(block.apiKey, "RESEND_API_KEY");
+	if (!apiKey) return false;
+
+	configureResend({
+		apiKey,
+		emailFrom: block.emailFrom
+			? `${block.emailFrom.name || "Contact"} <${block.emailFrom.domain || "onboarding@resend.dev"}>`
+			: undefined,
+		emailTo: block.emailTo,
+		subject: block.subject,
+	});
+
+	return true;
+}
+
+/**
+ * Invoke handlers registered under /deco/invoke/{key}.
+ * Both with and without .ts suffix for compatibility.
+ */
+export const handlers: Record<string, (props: any, request: Request) => Promise<any>> = {
+	"resend/actions/emails/send": (props) => sendEmail(props),
+	"resend/actions/emails/send.ts": (props) => sendEmail(props),
+};

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;
+}