@decocms/apps 0.25.1 → 0.26.0

package/commerce/sdk/formatPrice.ts

@@ -16,5 +16,11 @@ const formatter = (currency: string, locale: string) => {
 	return formatters.get(key)!;
 };
 
-export const formatPrice = (price: number | undefined, currency = "BRL", locale = "pt-BR") =>
-	price !== undefined ? formatter(currency, locale).format(price) : null;
+export const formatPrice = (
+	price: number | undefined | null,
+	currency = "BRL",
+	locale = "pt-BR",
+) =>
+	price != null && Number.isFinite(price)
+		? formatter(currency, locale).format(price)
+		: null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/apps",
-  "version": "0.25.1",
+  "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;
+}

package/vtex/inline-loaders/productListingPage.ts

@@ -294,6 +294,24 @@ export default async function vtexProductListingPage(props: PLPProps): Promise<a
 			}
 		}
 
+		// Handle VTEX `map` query param (e.g. /1368?map=productClusterIds).
+		// The `map` param tells IS how to interpret each path segment as a facet type.
+		// Segments and map values are positionally matched (comma-separated).
+		if (facets.length === 0 && pageUrl && __pagePath) {
+			const mapParam = pageUrl.searchParams.get("map");
+			if (mapParam) {
+				const segments = __pagePath.split("/").filter(Boolean);
+				const mapValues = mapParam.split(",");
+				for (let i = 0; i < Math.min(segments.length, mapValues.length); i++) {
+					const key = mapValues[i].trim();
+					const value = decodeURIComponent(segments[i]);
+					if (key && value) {
+						facets.push({ key, value });
+					}
+				}
+			}
+		}
+
 		let pageTypes: PageType[] = [];
 
 		if (

package/vtex/utils/transform.ts

@@ -577,7 +577,7 @@ const SHELF_PROPERTY_NAMES = new Set([
  *
  * Differences from toProduct():
  * - Images: capped at 2 per SKU (front + back)
- * - Offers: first seller only, stripped installments (keeps ListPrice, SalePrice, SRP, PIX, best no-interest)
+ * - Offers: best seller only (in-stock first, then cheapest), stripped installments (keeps ListPrice, SalePrice, SRP, PIX, best no-interest)
  * - isVariantOf: single in-stock variant at level 0
  * - additionalProperty: filtered to known-used property names
  * - Drops: description, video, isAccessoryOrSparePartFor, alternateName, gtin, releaseDate, model
@@ -603,12 +603,13 @@ export const toProductShelf = <P extends LegacyProductVTEX | ProductVTEX>(
 	}));
 	const finalImages = mappedImages.length > 0 ? mappedImages : [DEFAULT_IMAGE];
 
-	// Offers: first seller only, lean
-	const firstSeller = (sku.sellers ?? [])[0];
-	const fullOffer = firstSeller
-		? (isLegacyProduct(product) ? toOfferLegacy : toOffer)(firstSeller)
-		: undefined;
-	const leanOffers = fullOffer ? [buildOfferShelf(fullOffer)] : [];
+	// Offers: best seller (in-stock first, then cheapest), lean.
+	// Must consider ALL sellers so marketplace products where sellers[0]
+	// is OOS but another seller has stock still show as available.
+	const offerConverter = isLegacyProduct(product) ? toOfferLegacy : toOffer;
+	const allOffers = (sku.sellers ?? []).map(offerConverter).sort(bestOfferFirst);
+	const bestOffer = allOffers[0];
+	const leanOffers = bestOffer ? [buildOfferShelf(bestOffer)] : [];
 
 	// isVariantOf: single in-stock variant at level 0
 	const isVariantOf =