@decocms/apps-vtex 7.28.0 → 7.28.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/apps-vtex",
-  "version": "7.28.0",
+  "version": "7.28.2",
   "type": "module",
   "description": "Deco commerce app: VTEX integration",
   "repository": {
@@ -51,10 +51,10 @@
     "lint:unused": "knip"
   },
   "dependencies": {
-    "@decocms/blocks": "7.28.0",
-    "@decocms/apps-commerce": "7.28.0",
-    "@decocms/apps-website": "7.28.0",
-    "@decocms/tanstack": "7.28.0"
+    "@decocms/blocks": "7.28.2",
+    "@decocms/apps-commerce": "7.28.2",
+    "@decocms/apps-website": "7.28.2",
+    "@decocms/tanstack": "7.28.2"
   },
   "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,73 @@ 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: [],
+					},
+				},
+			],
+			variations: [{ name: "Cor", values: ["Preto"] }],
+		}) as any;
+
+	// Campanha is a PRODUCT specification (in specificationGroups), NOT a sku.variation.
+	// It is the marker MonteCarlo uses to tag launches ("Lançamentos").
+	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: [],
+			specificationGroups: [
+				{ name: "Campanha", specifications: [{ name: "Campanha", values: ["Lançamentos"] }] },
+			],
+			items: [makeSku()],
+			...overrides,
+		}) as any;
+
+	const options = { baseUrl: "https://example.com", priceCurrency: "BRL" };
+
+	it("surfaces the Campanha launch spec in isVariantOf.additionalProperty (ReleaseFlag reads it)", () => {
+		const result = toProductShelf(makeProduct(), makeSku(), 0, options);
+		const groupProps = result.isVariantOf?.additionalProperty ?? [];
+		expect(groupProps).toEqual(
+			expect.arrayContaining([
+				expect.objectContaining({ name: "Campanha", value: "Lançamentos" }),
+			]),
+		);
+	});
+
+	it("leaves isVariantOf.additionalProperty empty when there is no shelf-safe group spec", () => {
+		const result = toProductShelf(
+			makeProduct({ specificationGroups: [] }),
+			makeSku(),
+			0,
+			options,
+		);
+		expect(result.isVariantOf?.additionalProperty).toEqual([]);
+	});
+});

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,28 @@ 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 ?? ""));
+
+	// Product-group specs (from specificationGroups) filtered to shelf-safe names.
+	// Launch markers like "Campanha" live here, NOT in sku.variations, so they only
+	// reach the card through the ProductGroup's additionalProperty (mirrors toProduct).
+	const groupAdditionalProperty = (
+		isLegacyProduct(product)
+			? legacyToProductGroupAdditionalProperties(product)
+			: toProductGroupAdditionalProperties(product)
+	).filter((prop) => SHELF_PROPERTY_NAMES.has(prop.name ?? ""));
+
 	// isVariantOf: single in-stock variant at level 0
 	const isVariantOf =
 		level < 1
@@ -633,24 +656,14 @@ export const toProductShelf = <P extends LegacyProductVTEX | ProductVTEX>(
 						hasVariant: singleVariant,
 						url: getProductGroupURL(baseUrl, product).href,
 						name: product.productName,
-						additionalProperty: [],
+						// Carry the shelf-safe group specs (incl. "Campanha") so ProductCard
+						// flags that read isVariantOf.additionalProperty (e.g. ReleaseFlag ->
+						// "Lançamento") still fire on shelf/carousel cards.
+						additionalProperty: groupAdditionalProperty,
 					} 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 {