@decocms/parity 0.17.1 → 0.17.3

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.17.3](https://github.com/decocms/parity/compare/v0.17.2...v0.17.3) (2026-07-28)
+
+### Fixed
+
+* **`open-minicart` fallback click when already-open drawer is empty (issue #159).** Sites that use a react-query on-demand cart (query `enabled` only when a cart-intent signal is `true`) never hydrate the drawer when it opens via an add-to-cart toast side-effect — the intent signal is only set on an explicit cart-icon click, so the panel renders empty and `validateCartContainsTitle` finds 0 items. When `cartOpenMethod === "already-open"` and validation returns `found=false`, parity now looks up the `minicartTrigger` and clicks it explicitly (mirroring what the user does), waits for cart hydration, then re-validates. The fallback is skipped entirely when the drawer hydrates normally via the initial validation.
+
 ## [0.17.0](https://github.com/decocms/parity/compare/v0.16.0...v0.17.0) (2026-07-28)
 
 ### Added

package/dist/cli.js

@@ -51258,6 +51258,16 @@ async function validateCartContainsTitle(page, expectedTitle, ctx) {
     await page.waitForTimeout(2000);
     observed = await sweepTitles();
   }
+  if (observed.length === 0) {
+    const panelSelectors = selFor(ctx, "minicartPanel");
+    if (panelSelectors.length > 0) {
+      dlog2(ctx, "  validateCartContainsTitle: panel empty — waiting up to 5s for hydration");
+      await Promise.race(panelSelectors.map((p) => page.waitForSelector(`${p} *`, { timeout: 5000 }).catch(() => {
+        return;
+      })));
+      observed = await sweepTitles();
+    }
+  }
   dlog2(ctx, `  validateCartContainsTitle: observed ${observed.length} titles`);
   if (observed.length === 0) {
     return { found: false, observedTitles: [], method: "none" };
@@ -52036,49 +52046,62 @@ async function flowPurchaseJourney(ctx) {
     const beforeUrl7 = page.url();
     const spBefore7 = screenshotPath(ctx, "pj-7-minicart-before");
     await screenshotStable(page, { path: spBefore7, fullPage: false });
-    let miniHit = await firstVisibleLocator(page, selFor(ctx, "minicartTrigger"));
-    let miniRecovered = false;
-    if (!miniHit && budget.remaining > 0) {
-      const recovery = await attemptRecovery(page, ctx, "open-minicart", "Abrir o minicart/drawer do carrinho", selFor(ctx, "minicartTrigger"));
-      if (recovery) {
-        miniHit = recovery;
-        miniRecovered = true;
-        budget.remaining--;
-      }
-    }
     let cartOpenMethod = "failed";
     let miniText = "";
     let cartRevealMode = "unknown";
     let revealDiagnostics;
     const drawerAlreadyOpen = await isCartRevealed(page, expectedProductTitle, ctx) !== null;
-    if (miniHit) {
-      miniText = await miniHit.locator.innerText().catch(() => "");
-      cartRevealMode = await detectCartRevealMode(page, miniHit.locator, drawerAlreadyOpen, ctx.viewport).catch(() => "unknown");
-      dlog2(ctx, `step 7 open-minicart: cartRevealMode=${cartRevealMode}`);
-      let openResult = await openMinicart(page, miniHit, ctx, expectedProductTitle);
-      cartOpenMethod = openResult.method;
-      revealDiagnostics = openResult.diagnostics;
-      if (cartOpenMethod === "failed" && revealDiagnostics && budget.remaining > 0) {
-        const recovery = await attemptRecovery(page, ctx, "open-minicart", "Abrir o minicart/drawer do carrinho — o trigger foi clicado mas o drawer não revelou", [miniHit.selector], summarizeCartRevealDiagnostics(revealDiagnostics));
+    let miniHit = null;
+    let miniRecovered = false;
+    if (drawerAlreadyOpen) {
+      cartOpenMethod = "already-open";
+      cartRevealMode = "inline-notification";
+      dlog2(ctx, "step 7 open-minicart: drawer already visible — skipping trigger lookup");
+    } else {
+      miniHit = await firstVisibleLocator(page, selFor(ctx, "minicartTrigger"));
+      if (!miniHit && budget.remaining > 0) {
+        const recovery = await attemptRecovery(page, ctx, "open-minicart", "Abrir o minicart/drawer do carrinho", selFor(ctx, "minicartTrigger"));
         if (recovery) {
-          budget.remaining--;
           miniHit = recovery;
           miniRecovered = true;
-          openResult = await openMinicart(page, miniHit, ctx, expectedProductTitle);
-          cartOpenMethod = openResult.method;
-          revealDiagnostics = openResult.diagnostics;
+          budget.remaining--;
         }
       }
-    } else {
-      if (drawerAlreadyOpen) {
-        cartOpenMethod = "already-open";
-        cartRevealMode = "inline-notification";
-        dlog2(ctx, "step 7 open-minicart: no trigger, drawer already visible");
+      if (miniHit) {
+        miniText = await miniHit.locator.innerText().catch(() => "");
+        cartRevealMode = await detectCartRevealMode(page, miniHit.locator, false, ctx.viewport).catch(() => "unknown");
+        dlog2(ctx, `step 7 open-minicart: cartRevealMode=${cartRevealMode}`);
+        let openResult = await openMinicart(page, miniHit, ctx, expectedProductTitle);
+        cartOpenMethod = openResult.method;
+        revealDiagnostics = openResult.diagnostics;
+        if (cartOpenMethod === "failed" && revealDiagnostics && budget.remaining > 0) {
+          const recovery = await attemptRecovery(page, ctx, "open-minicart", "Abrir o minicart/drawer do carrinho — o trigger foi clicado mas o drawer não revelou", [miniHit.selector], summarizeCartRevealDiagnostics(revealDiagnostics));
+          if (recovery) {
+            budget.remaining--;
+            miniHit = recovery;
+            miniRecovered = true;
+            openResult = await openMinicart(page, miniHit, ctx, expectedProductTitle);
+            cartOpenMethod = openResult.method;
+            revealDiagnostics = openResult.diagnostics;
+          }
+        }
       }
     }
     let step7Validation;
     if (expectedProductTitle && cartOpenMethod !== "failed") {
-      const v = await validateCartContainsTitle(page, expectedProductTitle, ctx);
+      let v = await validateCartContainsTitle(page, expectedProductTitle, ctx);
+      if (cartOpenMethod === "already-open" && !v.found) {
+        const triggerHit = await firstVisibleLocator(page, selFor(ctx, "minicartTrigger"));
+        if (triggerHit) {
+          dlog2(ctx, "step 7: already-open drawer empty — clicking minicartTrigger to activate on-demand query");
+          miniHit = triggerHit;
+          await triggerHit.locator.click({ timeout: 3000 }).catch(() => {
+            return;
+          });
+          await waitForCartHydration(page);
+          v = await validateCartContainsTitle(page, expectedProductTitle, ctx);
+        }
+      }
       let reasonText;
       if (!v.found) {
         if (v.observedTitles.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/parity",
-  "version": "0.17.1",
+  "version": "0.17.3",
   "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",