@decocms/apps-vtex 7.27.0 → 7.28.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/apps-vtex",
-  "version": "7.27.0",
+  "version": "7.28.1",
   "type": "module",
   "description": "Deco commerce app: VTEX integration",
   "repository": {
@@ -51,10 +51,10 @@
     "lint:unused": "knip"
   },
   "dependencies": {
-    "@decocms/blocks": "7.27.0",
-    "@decocms/apps-commerce": "7.27.0",
-    "@decocms/apps-website": "7.27.0",
-    "@decocms/tanstack": "7.27.0"
+    "@decocms/blocks": "7.28.1",
+    "@decocms/apps-commerce": "7.28.1",
+    "@decocms/apps-website": "7.28.1",
+    "@decocms/tanstack": "7.28.1"
   },
   "peerDependencies": {
     "@tanstack/react-query": ">=5.0.0",

package/src/utils/__tests__/transform.test.ts

@@ -23,6 +23,7 @@ import {
 	toAdditionalPropertySpecification,
 	toBrand,
 	toPostalAddress,
+	toProductShelf,
 	toProductVariant,
 } from "../transform";
 
@@ -696,3 +697,68 @@ describe("toProductVariant", () => {
 		expect(result.productID).toBe("SKU1");
 	});
 });
+
+describe("toProductShelf", () => {
+	const makeSku = (overrides: Record<string, unknown> = {}) =>
+		({
+			itemId: "SKU1",
+			name: "Test SKU",
+			referenceId: [{ Key: "RefId", Value: "REF-SKU1" }],
+			images: [{ imageUrl: "https://img.com/1.jpg", imageText: "Front", imageLabel: "front" }],
+			sellers: [
+				{
+					sellerId: "1",
+					sellerName: "Seller One",
+					commertialOffer: {
+						AvailableQuantity: 10,
+						Price: 99.9,
+						ListPrice: 129.9,
+						spotPrice: 89.9,
+						PriceValidUntil: "2025-12-31",
+						Installments: [],
+						GiftSkuIds: [],
+						teasers: [],
+					},
+				},
+			],
+			// Campanha is the VTEX spec MonteCarlo uses to tag launches ("Lançamentos").
+			variations: [
+				{ name: "Cor", values: ["Preto"] },
+				{ name: "Campanha", values: ["Lançamentos"] },
+			],
+		}) as any;
+
+	const makeProduct = (overrides: Record<string, unknown> = {}) =>
+		({
+			origin: "intelligent-search",
+			productId: "PROD1",
+			productName: "Test Product",
+			brand: "TestBrand",
+			linkText: "test-product",
+			categories: ["/Electronics/"],
+			categoriesIds: ["/1/"],
+			categoryId: "1",
+			productClusters: [{ id: "100", name: "Sale" }],
+			clusterHighlights: [],
+			items: [makeSku()],
+			...overrides,
+		}) as any;
+
+	const options = { baseUrl: "https://example.com", priceCurrency: "BRL" };
+
+	it("keeps the Campanha launch spec in product-level additionalProperty", () => {
+		const result = toProductShelf(makeProduct(), makeSku(), 0, options);
+		expect(result.additionalProperty).toEqual(
+			expect.arrayContaining([
+				expect.objectContaining({ name: "Campanha", value: "Lançamentos" }),
+			]),
+		);
+	});
+
+	it("populates isVariantOf.additionalProperty with the launch spec (ReleaseFlag reads it)", () => {
+		const result = toProductShelf(makeProduct(), makeSku(), 0, options);
+		const groupProps = result.isVariantOf?.additionalProperty ?? [];
+		expect(groupProps.length).toBeGreaterThan(0);
+		expect(groupProps.some((p) => p.value === "Lançamentos")).toBe(true);
+	});
+});

package/src/utils/transform.ts

@@ -576,6 +576,7 @@ const buildOfferShelf = (offer: Offer): Offer => {
 const SHELF_PROPERTY_NAMES = new Set([
 	"category",
 	"cluster",
+	"Campanha",
 	"Cor",
 	"Tamanho",
 	"Voltagem",
@@ -621,6 +622,19 @@ export const toProductShelf = <P extends LegacyProductVTEX | ProductVTEX>(
 	const bestOffer = allOffers[0];
 	const leanOffers = bestOffer ? [buildOfferShelf(bestOffer)] : [];
 
+	// additionalProperty: filter to known-used names
+	const specificationsAdditionalProperty = isLegacySku(sku)
+		? toAdditionalPropertiesLegacy(sku)
+		: toAdditionalProperties(sku);
+	const categoryAdditionalProperties = toAdditionalPropertyCategories(product) ?? [];
+	const clusterAdditionalProperties = toAdditionalPropertyClusters(product) ?? [];
+
+	const additionalProperty = [
+		...specificationsAdditionalProperty,
+		...categoryAdditionalProperties,
+		...clusterAdditionalProperties,
+	].filter((prop) => SHELF_PROPERTY_NAMES.has(prop.name ?? ""));
+
 	// isVariantOf: single in-stock variant at level 0
 	const isVariantOf =
 		level < 1
@@ -633,24 +647,14 @@ export const toProductShelf = <P extends LegacyProductVTEX | ProductVTEX>(
 						hasVariant: singleVariant,
 						url: getProductGroupURL(baseUrl, product).href,
 						name: product.productName,
-						additionalProperty: [],
+						// Carry the shelf-safe group props (incl. "Campanha") so ProductCard
+						// flags that read isVariantOf.additionalProperty (e.g. ReleaseFlag ->
+						// "Lançamento") still fire on shelf/carousel cards.
+						additionalProperty,
 					} satisfies ProductGroup;
 				})()
 			: undefined;
 
-	// additionalProperty: filter to known-used names
-	const specificationsAdditionalProperty = isLegacySku(sku)
-		? toAdditionalPropertiesLegacy(sku)
-		: toAdditionalProperties(sku);
-	const categoryAdditionalProperties = toAdditionalPropertyCategories(product) ?? [];
-	const clusterAdditionalProperties = toAdditionalPropertyClusters(product) ?? [];
-
-	const additionalProperty = [
-		...specificationsAdditionalProperty,
-		...categoryAdditionalProperties,
-		...clusterAdditionalProperties,
-	].filter((prop) => SHELF_PROPERTY_NAMES.has(prop.name ?? ""));
-
 	const categoriesString = splitCategory(product.categories[0]).join(DEFAULT_CATEGORY_SEPARATOR);
 
 	return {