@vtex/faststore-plugin-buyer-portal 2.0.12 → 2.0.14

package/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.14] - 2026-07-21
+
+### Added
+
+- Custom dependency-free localization system: `LocalizationClient`, `getLocalizationLabelsService` (multi-entry merge, permanent process-local cache, single-flight dedup, graceful error fallback), `createLocalize` pure factory, `LocalizationProvider`, `useLocalization()` hook, and `withLocalization` HOC
+- `LocalizeFn` overloaded to support `ReactNode[]` interpolation, returning alternating text/node arrays for inline JSX embedding
+- `LOCALIZATION_ENTRY_IDS` constant map with real content-platform UUIDs for 13 feature domains
+- `withLocalization` wired into `withProviders` before `withBuyerPortal` so labels are available across all pages
+- CMS content-type schema for localization entries (`cms/b2b/pages/cms_content_type__i18n.jsonc`)
+- Unit tests for `createLocalize` and `getLocalizationLabelsService` covering all spec acceptance criteria
+- Vitest config with `discovery.config` stub alias for host-store-provided modules
+
+### Fixed
+
+- `Navbar`'s "Start shopping" link used a hardcoded `href="/"`, dropping the selected locale; it now resolves through `useLink_unstable`'s `resolveLink()`, consistent with every other internal link in the portal
+
+## [2.0.13] - 2026-07-21
+
+### Fixed
+
+- Navigating between organizational units (hierarchy tree, breadcrumbs, and the "View" links after creating/editing/deleting a unit) now carries the currently viewed contract's id through, instead of dropping it — this previously caused the `suma`-flag redirect on `/org-unit/[orgUnitId]` to land on the target org unit's default contract instead of the one being viewed. The Contract Listing page now also honors a `contractId` carried in the URL when it belongs to the org unit's attached contracts, falling back to the org unit's default contract otherwise
+- Accounting Fields data (sidebar list, Buying Policy criteria selectors, the Accounting Field details page, and Budget allocation drawers) was fetched using the session's active contract instead of the contract actually being viewed — noticeable when navigating straight to a page for a non-active contract (e.g. from Contract Listing) without first "switching" to it. All accounting-fields read hooks now take an explicit `contractId` instead of silently substituting the session's customerId
+
 ## [2.0.12] - 2026-07-17
 
 ### Fixed
@@ -763,7 +786,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Add CHANGELOG file
 - Add README file
 
-[unreleased]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v2.0.12...HEAD
+[unreleased]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v2.0.14...HEAD
 [1.3.55]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.54...v1.3.55
 [1.3.54]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.53...v1.3.54
 [1.3.53]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.52...v1.3.53
@@ -861,5 +884,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [2.0.10]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v2.0.9...v2.0.10
 [2.0.9]: https://github.com/vtex/faststore-plugin-buyer-portal/releases/tag/2.0.9
 
+[2.0.14]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v2.0.13...v2.0.14
+[2.0.13]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v2.0.12...v2.0.13
 [2.0.12]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v2.0.11...v2.0.12
 [2.0.11]: https://github.com/vtex/faststore-plugin-buyer-portal/releases/tag/2.0.11

package/cms/b2b/pages/cms_content_type__i18n.jsonc

@@ -0,0 +1,36 @@
+{
+  "b2bLocalization": {
+    "$extends": [
+      "#/components/base-page-template"
+    ],
+    "$singleton": false,
+    "type": "object",
+    "title": "B2B Localization",
+    "properties": {
+      "labels": {
+        "title": "Labels",
+        "description": "Labels for B2B Localization",
+        "type": "array",
+        "items": {
+          "type": "object",
+          "title": "Label",
+          "properties": {
+            "key": {
+              "type": "string",
+              "title": "Key"
+            },
+            "value": {
+              "type": "string",
+              "title": "Value"
+            }
+          }
+        }
+      },
+    },
+    "readOnly": false,
+    "writeOnly": false,
+    "deprecated": false,
+    "$abstract": false,
+    "identifierKeys": []
+  }
+}

package/cypress/integration/localization.test.ts

@@ -0,0 +1,482 @@
+import { TEST_CONFIG, TEST_DATA } from "../constants";
+import { useInternalSearch } from "../shared";
+
+const LOCALE_UNDER_TEST = "pt-BR";
+
+// Matches CMS-key-like tokens (e.g. "users.delete.messages.confirmDeleteUser",
+// "layouts.labels.language") that should never leak into visible UI text — `t()`
+// only falls back to the raw key when a translation is missing.
+const RAW_CMS_KEY_PATTERN =
+  /\b[a-zA-Z][a-zA-Z0-9]*(\.[a-zA-Z][a-zA-Z0-9]*){2,}\b/;
+
+// Matches an unreplaced positional placeholder left over from a broken `t()` call.
+const RAW_PLACEHOLDER_PATTERN = /\{\d+\}/;
+
+function assertNoRawCmsKeysOrPlaceholders(selector: string) {
+  cy.get(selector)
+    .invoke("text")
+    .then((text) => {
+      const keyMatch = text.match(RAW_CMS_KEY_PATTERN);
+      assert.isNull(
+        keyMatch,
+        `found a raw CMS key in "${selector}": "${keyMatch?.[0]}"`
+      );
+
+      const placeholderMatch = text.match(RAW_PLACEHOLDER_PATTERN);
+      assert.isNull(
+        placeholderMatch,
+        `found an unreplaced interpolation placeholder in "${selector}": "${placeholderMatch?.[0]}"`
+      );
+    });
+}
+
+// Switching locale mid-session (outside the selector's own Save+redirect flow, which
+// lands on a fresh origin/session for the target binding) can leave a stale cart/session
+// cookie bound to the previous channel — this was found to cause both an intermittent
+// client-side validation error AND, non-deterministically, `resolveLink` rendering hrefs
+// for the wrong (previous) locale. Visiting with only the auth cookie reflects a clean
+// session, same as a genuinely fresh visit under the target locale, and avoids both.
+function visitFreshUnderLocale(path: string) {
+  return cy.getCookie(TEST_CONFIG.AUTH.COOKIE_NAME).then((authCookie) => {
+    cy.clearCookies();
+    if (authCookie) {
+      cy.setCookie(TEST_CONFIG.AUTH.COOKIE_NAME, authCookie.value);
+    }
+    cy.visit(`/${LOCALE_UNDER_TEST}${path}`, { failOnStatusCode: false });
+  });
+}
+
+// Multi-locale delivery (B2BTEAM-3709) is rolled out per host-store environment via
+// discovery.config's `localization.enabled` + `localization.locales`. When the target
+// environment hasn't enabled it yet, visiting a locale-prefixed path won't resolve to
+// the Buyer Portal. We detect that up front and skip instead of failing, so this spec
+// stays green until the feature is live, then starts enforcing automatically.
+function isLocalizationEnabledInThisEnvironment() {
+  return visitFreshUnderLocale(TEST_CONFIG.ROUTES.BUYER_PORTAL)
+    .get("body")
+    .then(($body) => $body.find("[data-fs-vertical-nav-menu-item]").length > 0);
+}
+
+// Client-side (SPA) navigation between tabs can land on a stale locale — that's a
+// separate, `@faststore/core`-level concern from what this plugin's Navbar controls.
+// To assert exactly what `resolveLink("/")` renders for a given page, we re-request the
+// landed-on page directly, under the locale prefix, and check the *server-rendered* href.
+function reloadUnderLocale() {
+  return cy.location("pathname").then((pathname) => {
+    const pagePath = pathname.replace(new RegExp(`^/${LOCALE_UNDER_TEST}`), "");
+    visitFreshUnderLocale(pagePath);
+  });
+}
+
+describe("Multi-locale (i18n)", { retries: 2 }, () => {
+  beforeEach(() => {
+    cy.login();
+  });
+
+  it("keeps the locale prefix on the main Navbar 'Start shopping' link and breadcrumb links", () => {
+    isLocalizationEnabledInThisEnvironment().then((enabled) => {
+      if (!enabled) {
+        cy.log(
+          `Localization not enabled for locale "${LOCALE_UNDER_TEST}" in this environment — skipping.`
+        );
+        return;
+      }
+
+      // Navigate to a tabbed page (renders the main Navbar).
+      cy.contains("Profile").click();
+      reloadUnderLocale();
+
+      cy.get("[data-fs-bp-nav-menu-start-shopping-link]")
+        .should("have.attr", "href")
+        .and("match", new RegExp(`^/${LOCALE_UNDER_TEST}(/|$)`));
+
+      // Breadcrumb only renders a clickable (non-last) link when the current org unit
+      // has an ancestor — guard defensively since that depends on seed-data hierarchy.
+      cy.get("body").then(($body) => {
+        const breadcrumbLinks = $body.find(
+          "[data-fs-bp-breadcrumb-link] a[data-fs-bp-breadcrumb-text]"
+        );
+        if (breadcrumbLinks.length === 0) {
+          cy.log("No clickable breadcrumb link for this org unit — skipping.");
+          return;
+        }
+        cy.wrap(breadcrumbLinks.first())
+          .should("have.attr", "href")
+          .and("match", new RegExp(`^/${LOCALE_UNDER_TEST}(/|$)`));
+      });
+    });
+  });
+
+  it("keeps the locale prefix on the Org Unit Details navbar 'Start shopping' link and the hierarchy tree links, consistently with the main Navbar", () => {
+    isLocalizationEnabledInThisEnvironment().then((enabled) => {
+      if (!enabled) {
+        cy.log(
+          `Localization not enabled for locale "${LOCALE_UNDER_TEST}" in this environment — skipping.`
+        );
+        return;
+      }
+
+      cy.contains("Organizational Units").click();
+
+      cy.get("[data-fs-hierarchy-tree-wrapper]", {
+        timeout: TEST_CONFIG.TIMEOUTS.LONG_DELAY,
+      }).should("exist");
+
+      useInternalSearch(TEST_DATA.ORG_UNITS.CHILD_1);
+
+      // The hierarchy tree's search results are fetched and rendered client-side, which
+      // can hit the already-flagged SPA/client-render locale-sync finding (separate from
+      // this plugin's `resolveLink` usage, itself proven correct via SSR). Log instead of
+      // hard-failing on this specific link so it doesn't mask the click-through below.
+      cy.get("[data-fs-org-unit-item-name]")
+        .contains(TEST_DATA.ORG_UNITS.CHILD_1)
+        .parents("[data-fs-org-unit-item]")
+        .find("[data-fs-org-unit-item-click-area]")
+        .invoke("attr", "href")
+        .then((href) => {
+          if (!href?.startsWith(`/${LOCALE_UNDER_TEST}`)) {
+            cy.log(
+              `Hierarchy tree link "${href}" lost the locale prefix (known client-render finding) — continuing.`
+            );
+          }
+        });
+
+      cy.get("[data-fs-org-unit-item-name]")
+        .contains(TEST_DATA.ORG_UNITS.CHILD_1)
+        .parents("[data-fs-org-unit-item]")
+        .find("[data-fs-org-unit-item-click-area]")
+        .click();
+
+      cy.get("[data-fs-bp-org-unit-details-navbar]", {
+        timeout: TEST_CONFIG.TIMEOUTS.PAGE_LOAD,
+      }).should("be.visible");
+
+      reloadUnderLocale();
+
+      cy.get("[data-fs-bp-org-unit-details-navbar-start-shopping-link]")
+        .should("have.attr", "href")
+        .and("match", new RegExp(`^/${LOCALE_UNDER_TEST}(/|$)`));
+    });
+  });
+
+  it("shows the locale selector (globe) in both the main Navbar and the Org Unit Details navbar, with non-empty labels and no crash on missing CMS keys", () => {
+    isLocalizationEnabledInThisEnvironment().then((enabled) => {
+      if (!enabled) {
+        cy.log(
+          `Localization not enabled for locale "${LOCALE_UNDER_TEST}" in this environment — skipping.`
+        );
+        return;
+      }
+
+      cy.contains("Profile").click();
+
+      cy.get("[data-fs-localization-button]").should("be.visible").click();
+
+      // Whether or not the `shared` CMS entry already has these keys populated, `t()`
+      // must never crash and must never render blank text (fallback = key itself).
+      cy.get("[data-fs-localization-selector-content]")
+        .should("be.visible")
+        .invoke("text")
+        .should("not.be.empty");
+      assertNoRawCmsKeysOrPlaceholders(
+        "[data-fs-localization-selector-content]"
+      );
+
+      // No blank page / crash after opening the selector.
+      cy.get("[data-fs-bp-nav]").should("be.visible");
+
+      // Close the selector (its overlay can otherwise block later clicks) and start
+      // from a fresh home visit — top-level nav links are only reachable from the
+      // home page's sidebar, not from within an already-open tabbed page.
+      cy.get("body").type("{esc}");
+      cy.get("[data-fs-overlay]", {
+        timeout: TEST_CONFIG.TIMEOUTS.PAGE_LOAD,
+      }).should("not.exist");
+
+      // Same check on the Org Unit Details navbar.
+      visitFreshUnderLocale(TEST_CONFIG.ROUTES.BUYER_PORTAL);
+      cy.contains("Organizational Units").click();
+      cy.get("[data-fs-hierarchy-tree-wrapper]", {
+        timeout: TEST_CONFIG.TIMEOUTS.LONG_DELAY,
+      }).should("exist");
+      useInternalSearch(TEST_DATA.ORG_UNITS.CHILD_1);
+      cy.get("[data-fs-org-unit-item-name]")
+        .contains(TEST_DATA.ORG_UNITS.CHILD_1)
+        .parents("[data-fs-org-unit-item]")
+        .find("[data-fs-org-unit-item-click-area]")
+        .click();
+      cy.get("[data-fs-bp-org-unit-details-navbar]", {
+        timeout: TEST_CONFIG.TIMEOUTS.PAGE_LOAD,
+      }).should("be.visible");
+      cy.get(
+        "[data-fs-bp-org-unit-details-navbar] [data-fs-localization-button]"
+      ).should("be.visible");
+    });
+  });
+
+  it("persists the selected locale across a browser reload", () => {
+    // KNOWN BUG (found while writing this test, confirmed via a plain `curl`, no
+    // client JS involved): `GET /pt-BR/pvt/organization-account` returns a 302 whose
+    // `Location` header points to `/pvt/organization-account/org-unit/{id}` WITHOUT
+    // the `/pt-BR` prefix, so the redirect target renders `lang="en-US"`. This is a
+    // server-side redirect issue (unrelated to `resolveLink`/client navigation), and
+    // is expected to keep this assertion red until fixed.
+    isLocalizationEnabledInThisEnvironment().then((enabled) => {
+      if (!enabled) {
+        cy.log(
+          `Localization not enabled for locale "${LOCALE_UNDER_TEST}" in this environment — skipping.`
+        );
+        return;
+      }
+
+      cy.get("html").should("have.attr", "lang", LOCALE_UNDER_TEST);
+
+      // A plain reload of the same URL must keep reflecting the locale.
+      cy.reload();
+
+      cy.get("html").should("have.attr", "lang", LOCALE_UNDER_TEST);
+    });
+  });
+
+  it("does not break the Navbar layout on mobile/tablet viewports", () => {
+    isLocalizationEnabledInThisEnvironment().then((enabled) => {
+      if (!enabled) {
+        cy.log(
+          `Localization not enabled for locale "${LOCALE_UNDER_TEST}" in this environment — skipping.`
+        );
+        return;
+      }
+
+      cy.contains("Profile").click();
+
+      (
+        [
+          [375, 667],
+          [768, 1024],
+        ] as const
+      ).forEach(([width, height]) => {
+        cy.viewport(width, height);
+        cy.get("[data-fs-localization-button]").should("be.visible");
+        cy.get("[data-fs-bp-nav]").then(($nav) => {
+          expect($nav[0].scrollWidth).to.be.at.most(
+            $nav[0].parentElement?.clientWidth
+              ? $nav[0].parentElement.clientWidth + 1
+              : width + 1
+          );
+        });
+      });
+
+      // Reset to the default viewport so later tests in this spec aren't affected.
+      cy.viewport(
+        Cypress.config("viewportWidth"),
+        Cypress.config("viewportHeight")
+      );
+    });
+  });
+
+  it("does not fire localization requests from the client — SSR/loader only", () => {
+    cy.intercept("GET", "**/api/content-platform/data/vtex/b2b/**").as(
+      "localizationRequest"
+    );
+
+    cy.visit(TEST_CONFIG.ROUTES.BUYER_PORTAL);
+    cy.get("[data-fs-vertical-nav-menu-item]").should("exist");
+
+    cy.contains("Profile").click();
+    cy.get("[data-fs-bp-profile]").should("exist");
+
+    // Top-level nav links are only reachable from the home page's sidebar, not from
+    // within an already-open tabbed page — go back to home for the second page.
+    cy.visit(TEST_CONFIG.ROUTES.BUYER_PORTAL);
+    cy.contains("Organizational Units").click();
+    cy.get("[data-fs-bp-nav]").should("be.visible");
+
+    cy.get("@localizationRequest.all").should("have.length", 0);
+  });
+
+  it("shows translated error text, not a raw CMS key, when a client-side error occurs", () => {
+    // Deliberately reproduces the client-side error found while validating this ticket
+    // (visiting a locale-prefixed page with a stale, different-channel session cookie)
+    // to confirm the Error component's fallback text is translated, per the checklist's
+    // "loader/runtime error shows translated text" requirement.
+    isLocalizationEnabledInThisEnvironment().then((enabled) => {
+      if (!enabled) {
+        cy.log(
+          `Localization not enabled for locale "${LOCALE_UNDER_TEST}" in this environment — skipping.`
+        );
+        return;
+      }
+
+      cy.get("[data-fs-vertical-nav-menu-item]")
+        .contains("Assortments")
+        .click({ timeout: TEST_CONFIG.TIMEOUTS.PAGE_LOAD });
+
+      cy.get("body").then(($body) => {
+        if ($body.find("[data-fs-bp-header-inside-title]").length === 0) {
+          cy.log(
+            "Did not land on the Assortments page this run (known client-side SPA-navigation finding) — skipping."
+          );
+          return;
+        }
+
+        cy.location("pathname").then((path) => {
+          // Re-visit the SAME path (default locale, same channel) WITHOUT clearing
+          // cookies twice in a row from two different locale contexts, to reliably land
+          // the client-side session/channel conflict on the Assortments page.
+          cy.visit(`/${LOCALE_UNDER_TEST}${path}`, { failOnStatusCode: false });
+          cy.visit(path, { failOnStatusCode: false });
+          cy.visit(`/${LOCALE_UNDER_TEST}${path}`, { failOnStatusCode: false });
+
+          cy.get("body").then(($body2) => {
+            if ($body2.find("[data-fs-bp-error]").length === 0) {
+              cy.log(
+                "Client-side error did not reproduce this run (known intermittent finding) — skipping."
+              );
+              return;
+            }
+            cy.get("[data-fs-bp-error-title]")
+              .should("be.visible")
+              .invoke("text")
+              .should("not.be.empty");
+            assertNoRawCmsKeysOrPlaceholders("[data-fs-bp-error]");
+          });
+        });
+      });
+    });
+  });
+
+  it("renders pagination counters with real numbers, not raw interpolation placeholders", () => {
+    cy.visit(TEST_CONFIG.ROUTES.BUYER_PORTAL);
+    cy.contains("Organizational Units").click();
+    cy.get("[data-fs-hierarchy-tree-wrapper]", {
+      timeout: TEST_CONFIG.TIMEOUTS.LONG_DELAY,
+    }).should("exist");
+
+    cy.get("body").then(($body) => {
+      const counter = $body.find("[data-fs-bp-paginator-counter]");
+      if (counter.length === 0) {
+        cy.log("No paginator rendered on this page — skipping.");
+        return;
+      }
+      cy.wrap(counter.first())
+        .invoke("text")
+        .should("match", /\d/)
+        .and("not.match", RAW_PLACEHOLDER_PATTERN);
+    });
+  });
+
+  it("does not leak raw CMS keys in the sidebar, About drawer, or locale selector", () => {
+    isLocalizationEnabledInThisEnvironment().then((enabled) => {
+      if (!enabled) {
+        cy.log(
+          `Localization not enabled for locale "${LOCALE_UNDER_TEST}" in this environment — skipping.`
+        );
+        return;
+      }
+
+      cy.contains("Profile").click();
+
+      cy.get("[data-fs-bp-sidebar-drawer-btn]").click();
+      cy.get("body").then(($body) => {
+        const sidebar = $body.find(
+          "[data-fs-bp-org-unit-details-navbar-link], [data-fs-org-units-hierarchy], nav [data-fs-vertical-nav]"
+        );
+        if (sidebar.length > 0) {
+          assertNoRawCmsKeysOrPlaceholders(
+            "[data-fs-bp-org-unit-details-navbar-link], [data-fs-org-units-hierarchy], nav [data-fs-vertical-nav]"
+          );
+        }
+      });
+      // Close the sidebar drawer before continuing (best-effort; ignore if already closed).
+      cy.get("body").type("{esc}");
+
+      cy.get("[data-fs-bp-nav-about-trigger]").click();
+      cy.get("[data-fs-bp-about-information]", {
+        timeout: TEST_CONFIG.TIMEOUTS.PAGE_LOAD,
+      }).should("be.visible");
+      assertNoRawCmsKeysOrPlaceholders("[data-fs-bp-about-information]");
+    });
+  });
+
+  it("interpolates the actual user name into a real link (not a raw placeholder) in the Delete User confirmation message", () => {
+    cy.visit(TEST_CONFIG.ROUTES.BUYER_PORTAL);
+    cy.contains("Users").click();
+    cy.get("[data-fs-users-section]", {
+      timeout: TEST_CONFIG.TIMEOUTS.LONG_DELAY,
+    }).should("exist");
+
+    // Use whichever user happens to be first in the list — this test only exercises
+    // the confirmation drawer's interpolation and cancels out, it never deletes anyone,
+    // so it doesn't depend on any specific seeded user or table column order.
+    cy.get("[data-fs-bp-table-row]")
+      .first()
+      .within(() => {
+        cy.get("[data-fs-bp-basic-dropdown-menu-trigger]").click();
+      });
+    cy.contains("Delete").click();
+
+    cy.get("[data-fs-bp-delete-user-drawer]").should("be.visible");
+    cy.get("[data-fs-bp-delete-user-drawer-user-name]")
+      .should("be.visible")
+      .and("have.attr", "href")
+      .and("not.be.empty");
+    cy.get("[data-fs-bp-delete-user-drawer-user-name]")
+      .invoke("text")
+      .should("not.be.empty");
+    assertNoRawCmsKeysOrPlaceholders("[data-fs-bp-delete-user-drawer-body]");
+
+    // Cancel — this test only validates the interpolation, it must not delete the user.
+    cy.get("[data-fs-bp-delete-user-drawer]")
+      .contains("button", "Cancel")
+      .click();
+    cy.get("[data-fs-bp-delete-user-drawer]").should("not.exist");
+  });
+
+  it("renders actual CMS-translated content, not just a preserved URL prefix (Assortments page title)", () => {
+    // The Assortments page is the one page with real pt-BR/en-US CMS entries today
+    // (per B2BTEAM-3709), so it's the only reliable place to assert that *content*,
+    // not just routing, changes with the locale.
+    cy.visit(TEST_CONFIG.ROUTES.BUYER_PORTAL);
+    cy.get("[data-fs-vertical-nav-menu-item]")
+      .contains("Assortments")
+      .click({ timeout: TEST_CONFIG.TIMEOUTS.PAGE_LOAD });
+
+    cy.get("[data-fs-bp-header-inside-title]", {
+      timeout: TEST_CONFIG.TIMEOUTS.PAGE_LOAD,
+    }).should("be.visible");
+
+    cy.get("html").invoke("attr", "lang").as("defaultLocaleLangAttr");
+    cy.get("[data-fs-bp-header-inside-title]")
+      .invoke("text")
+      .as("defaultLocaleTitle");
+
+    cy.location("pathname").then((defaultLocalePath) => {
+      visitFreshUnderLocale(defaultLocalePath);
+
+      cy.get("body").then(($body) => {
+        if ($body.find("[data-fs-bp-header-inside-title]").length === 0) {
+          cy.log(
+            `Localization not enabled for locale "${LOCALE_UNDER_TEST}" in this environment — skipping.`
+          );
+          return;
+        }
+
+        cy.get("html")
+          .should("have.attr", "lang", LOCALE_UNDER_TEST)
+          .then(function () {
+            expect(LOCALE_UNDER_TEST).to.not.equal(this.defaultLocaleLangAttr);
+          });
+
+        cy.get("[data-fs-bp-header-inside-title]")
+          .invoke("text")
+          .should("not.be.empty")
+          .then(function (translatedTitle) {
+            expect(
+              translatedTitle,
+              "page title should be translated, not the same text as the default locale"
+            ).to.not.equal(this.defaultLocaleTitle);
+          });
+      });
+    });
+  });
+});

package/cypress/support/commands.ts

@@ -2,6 +2,14 @@ import { TEST_CONFIG } from "../constants";
 
 Cypress.Commands.add("login", () => {
   cy.session("organization-account-login", () => {
+    const authToken = Cypress.env("VTEX_AUTH_TOKEN");
+
+    if (authToken) {
+      cy.visit(TEST_CONFIG.LOCAL_URL);
+      cy.setCookie(TEST_CONFIG.AUTH.COOKIE_NAME, authToken);
+      return;
+    }
+
     const loginOrigin = new URL(TEST_CONFIG.AUTH.LOGIN_URL).origin;
     const login = Cypress.env("VTEX_ACCOUNT_LOGIN");
     const password = Cypress.env("VTEX_ACCOUNT_PASSWORD");