@decocms/parity 0.11.4 → 0.11.5

package/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.11.5](https://github.com/decocms/parity/compare/v0.11.4...v0.11.5) (2026-06-17)
+
+### Fixed
+
+* **Variant clicks now wait for navigation.** Deco TanStack PDPs render size/color pickers as `<a href="<product>/p?skuId=N">` links — clicking navigates to a different SKU URL. The previous `click + waitForTimeout(400)` ran add-to-cart against the pre-nav page where the variant was still "unselected". New `clickAndMaybeWait` helper races the click with `page.waitForNavigation` so the flow runs against the post-navigation page when it happens, and falls through when it doesn't (button-radio case).
+* **`validateAddToCart` now uses `cartOpenedIndicator` selectors.** The new selector key from 0.11.4 (`[aria-label='Fechar notificação']` / `[aria-label='Fechar carrinho']` + generic role fallbacks) is now actually wired into the post-click drawer-open probe, so Deco TanStack notifications correctly mark add-to-cart as `ok` via the `drawer-open` signal.
+
+### Added
+
+* **Landing-page detection before LLM recovery on missing buy button.** When step 6 (add-to-cart) can't find a buy button, the runner now checks whether the page even looks like a PDP (schema:Product JSON-LD, `<form>` with button, price text, variant inputs). If fewer than 2 PDP signals fire, the step is skipped with `PDP appears to be a landing page (...)` instead of burning LLM recovery budget on a page that has nothing to recover. Reasons are surfaced in the skip note so the user immediately knows why.
+
+### Verification (live against bagaggio)
+
+| Version | Steps reached on cand |
+| --- | --- |
+| 0.11.2 and earlier | 3/9 (stops at enter-pdp) |
+| 0.11.3 | 4/9 (stops at select-variant) |
+| 0.11.4 | 6/9 (stops at add-to-cart) |
+| **0.11.5** | **9/9** (reaches go-checkout) |
+
 ## [0.11.4](https://github.com/decocms/parity/compare/v0.11.3...v0.11.4) (2026-06-17)
 
 ### Added

package/dist/cli.js

@@ -12776,12 +12776,20 @@ async function flowPurchaseJourney(ctx) {
     reportStart(6, "add-to-cart");
     let buyHit = await firstVisibleLocator(page, selFor(ctx, "buyButton"));
     let buyRecovered = false;
-    if (!buyHit && budget.remaining > 0) {
-      const recovery = await attemptRecovery(page, ctx, "add-to-cart", "Clicar no botão de comprar/adicionar ao carrinho", selFor(ctx, "buyButton"));
-      if (recovery) {
-        buyHit = recovery;
-        buyRecovered = true;
-        budget.remaining--;
+    if (!buyHit) {
+      const landingCheck = await detectLandingPage(page);
+      if (landingCheck.isLanding) {
+        steps.push(makeSkipStep(6, "add-to-cart", ctx, `PDP appears to be a landing page (${landingCheck.reasons.join("; ")}) — no buy form to test`));
+        reportEnd(6, "add-to-cart", "skipped", 0, "landing page detected");
+        return { pages, steps };
+      }
+      if (budget.remaining > 0) {
+        const recovery = await attemptRecovery(page, ctx, "add-to-cart", "Clicar no botão de comprar/adicionar ao carrinho", selFor(ctx, "buyButton"));
+        if (recovery) {
+          buyHit = recovery;
+          buyRecovered = true;
+          budget.remaining--;
+        }
       }
     }
     if (!buyHit) {
@@ -13232,6 +13240,56 @@ async function fillCep(page, selector, cep) {
     return false;
   }
 }
+async function detectLandingPage(page) {
+  const reasons = [];
+  let pdpSignalCount = 0;
+  try {
+    const hasSchema = await page.locator(`script[type='application/ld+json']:has-text('"@type":"Product"')`).first().count().catch(() => 0);
+    if (hasSchema > 0)
+      pdpSignalCount++;
+    else
+      reasons.push("no schema:Product JSON-LD");
+  } catch {
+    reasons.push("no schema:Product JSON-LD");
+  }
+  try {
+    const hasItemtype = await page.locator("[itemtype*='Product']").first().count();
+    if (hasItemtype > 0)
+      pdpSignalCount++;
+  } catch {}
+  try {
+    const hasForm = await page.locator("form:has(button)").first().count();
+    if (hasForm > 0)
+      pdpSignalCount++;
+    else
+      reasons.push("no <form> with button");
+  } catch {
+    reasons.push("no <form> with button");
+  }
+  try {
+    const bodyText = await page.locator("body").innerText({ timeout: 500 });
+    if (/R\$\s*\d+|\$\s*\d+\.\d{2}|€\s*\d+|\bUSD\s*\d+/i.test(bodyText)) {
+      pdpSignalCount++;
+    } else {
+      reasons.push("no price text (R$ / $ / €)");
+    }
+  } catch {
+    reasons.push("no price text (R$ / $ / €)");
+  }
+  try {
+    const hasVariantInput = await page.locator("select, input[type='number'], input[type='radio']").first().count();
+    if (hasVariantInput > 0)
+      pdpSignalCount++;
+  } catch {}
+  return { isLanding: pdpSignalCount < 2, reasons };
+}
+async function clickAndMaybeWait(page, locator, _label) {
+  await Promise.allSettled([
+    page.waitForNavigation({ timeout: 5000, waitUntil: "domcontentloaded" }),
+    locator.click({ timeout: 2000 })
+  ]);
+  await page.waitForTimeout(600);
+}
 async function selectVariant(page, ctx) {
   const actions = [];
   let primarySelectorKey;
@@ -13275,10 +13333,7 @@ async function selectVariant(page, ctx) {
     const sizeHit = await firstVisibleLocator(page, selFor(ctx, "sizeSwatch"));
     if (sizeHit && !await sizeHit.locator.isDisabled().catch(() => false)) {
       const sizeText = (await sizeHit.locator.innerText().catch(() => "")).slice(0, 20).trim();
-      await sizeHit.locator.click({ timeout: 2000 }).catch(() => {
-        return;
-      });
-      await page.waitForTimeout(400);
+      await clickAndMaybeWait(page, sizeHit.locator, "sizeSwatch");
       actions.push(`Selecionou tamanho${sizeText ? ` '${sizeText}'` : ""} (\`${sizeHit.selector}\`)`);
       trackPrimary("sizeSwatch", sizeHit.selector);
     }
@@ -13287,10 +13342,7 @@ async function selectVariant(page, ctx) {
   if (colorHit && !await colorHit.locator.isDisabled().catch(() => false)) {
     const colorText = (await colorHit.locator.innerText().catch(() => "")).slice(0, 20).trim();
     const colorLabel = colorText || await colorHit.locator.getAttribute("aria-label").catch(() => null) || "";
-    await colorHit.locator.click({ timeout: 2000 }).catch(() => {
-      return;
-    });
-    await page.waitForTimeout(400);
+    await clickAndMaybeWait(page, colorHit.locator, "colorSwatch");
     actions.push(`Selecionou cor${colorLabel ? ` '${colorLabel}'` : ""} (\`${colorHit.selector}\`)`);
     trackPrimary("colorSwatch", colorHit.selector);
   }
@@ -13441,6 +13493,7 @@ async function validateAddToCart(page, ctx, cartCountBefore, beforeUrl) {
       };
     }
     const drawerSelectors = [
+      ...selFor(ctx, "cartOpenedIndicator"),
       "[role='dialog']",
       "[data-minicart][aria-expanded='true']",
       "[data-cart-drawer].open",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/parity",
-  "version": "0.11.4",
+  "version": "0.11.5",
   "description": "E2E parity validator for site migrations. Compares prod vs cand and reports UI, functional, SEO, visual, and Web Vitals deltas with an LLM-ranked HTML report.",
   "type": "module",
   "license": "MIT",