chore: updates dev with main 04 15

[hellofanny]

What's the purpose of this pull request?

Updates dev with latest main (fixes)

Summary by CodeRabbit

Release Notes

• Bug Fixes

  • Improved city and postal code display logic in region selector, enabling more flexible location information rendering.

• New Features

  • Added postal code-based support for delivery promise features and regional content caching.

• Chores

  • Updated internal schema definitions and cache management logic.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

Walkthrough

The PR extends cache-busting and regional logic to include postal-code awareness alongside existing person-id handling. Components (RegionBar, RegionButton) now display location info conditionally, while caching and query execution incorporate postal-code state to prevent stale data when region changes.

Changes

Cohort / File(s)	Summary
Changelog packages/components/CHANGELOG.md	Added version 3.98.1 release notes documenting simplification of city/postal code display logic in RegionBar and RegionButton.
Region Components packages/components/src/molecules/RegionBar/RegionBar.tsx, packages/core/src/components/region/RegionButton/RegionButton.tsx	Refactored conditional rendering of location details to prioritize postal code presence and render city/postal code independently, allowing either to display alone when applicable.
Cache Busting packages/core/src/utils/cookieCacheBusting.ts, packages/core/test/utils/cookieCacheBusting.test.ts	Extended cache-busting strategy to track postal-code changes alongside person-id; composite values now include timestamp, person ID, and postal code separated by ::. Updated session storage to persist postal code and regenerate cache when either axis changes.
Query & Data Fetching packages/core/src/sdk/product/usePageProductsQuery.ts, packages/core/src/sdk/product/useProductGalleryQuery.ts, packages/core/src/sdk/graphql/request.ts	Integrated postal-code awareness into query cache keys and control flow; added delivery promise checks to pause fetching during session validation and to region-aware cache operations.
Schema & Configuration packages/core/cms/faststore/schema.json, packages/core/src/server/content/service.ts, packages/core/src/components/ui/ProductGallery/ProductGalleryPage.tsx	Added reusable schema definitions (base-component, base-page-template); made storeId dynamic based on config; normalized buildExtraProductProps prop to explicitly pass undefined when absent.

Sequence Diagram(s)

sequenceDiagram
    participant Session as Session State
    participant CB as Cache Busting<br/>(cookieCacheBusting)
    participant Storage as Browser Storage<br/>(sessionStorage)
    participant Query as Query Engine<br/>(usePageProductsQuery)
    participant Server as Server/GraphQL

    Session->>CB: personId or postalCode changed
    CB->>CB: Check if both axes absent
    alt Both absent
        CB->>Storage: Clear all busting keys
        CB->>Query: Return null
    else Either axis changed
        CB->>Storage: Read last cached value
        alt Cache still valid
            CB->>Query: Return cached value
        else Cache invalid
            CB->>CB: Build new value<br/>(timestamp::personId::postalCode)
            CB->>Storage: Persist new value
            CB->>Query: Return new value
        end
    end
    
    Query->>Query: Add postalCode to<br/>cache key if enabled
    Query->>Query: Pause (doNotRun=true)<br/>if validating session
    Query->>Server: Fetch with region-aware key
    Server-->>Query: Fresh data
    Query->>Storage: Cache with region key

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Possibly related PRs

• fix: enhance cache key management in useQuery #3230: Modifies the foundational session-based cache-busting logic (getClientCacheBustingValue) that this PR extends with postal-code awareness.
• chore: adds postal code as key value #3272: Directly shares postal-code cache-keying and session-aware query logic modifications (cookieCacheBusting, usePageProductsQuery, useProductGalleryQuery).
• feat: Add ActivityFlow data parameters with search-related information #3105: Normalizes buildExtraProductProps handling in ProductGalleryPage.tsx within the same product gallery data-fetching flow.

Suggested labels

bug

Suggested reviewers

• renatomaurovtex
• eduardoformiga

Poem

📍 A postal code now guards the cache,
Changing regions? Your data won't clash.
Session and storage dance in sync,
Regions update without a blink. ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately reflects the main objective: syncing dev with main branch updates. It's concise and clear about the branch merge operation.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/updates-dev-with-main-04-15

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.