@faststore/core 4.1.0-dev.1 → 4.1.0-dev.11

package/.turbo/turbo-generate.log

@@ -1,9 +1,9 @@
 
-> @faststore/core@4.1.0-dev.0 generate /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.1.0-dev.10 generate /home/runner/work/faststore/faststore/packages/core
 > pnpm run gen-types && pnpm run cache-graphql 
 
 
-> @faststore/core@4.1.0-dev.0 gen-types /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.1.0-dev.10 gen-types /home/runner/work/faststore/faststore/packages/core
 > node ../cli/bin/run generate-types .
 
 [STARTED] Parse Configuration
@@ -19,7 +19,7 @@
 [COMPLETED] Generate to /home/runner/work/faststore/faststore/packages/core/@generated/
 [COMPLETED] Generate outputs
 
-> @faststore/core@4.1.0-dev.0 cache-graphql /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.1.0-dev.10 cache-graphql /home/runner/work/faststore/faststore/packages/core
 > node ../cli/bin/run cache-graphql --config=./discovery.config.default.js --queries=./@generated/persisted-documents.json
 
 [Info] - Config file location: /home/runner/work/faststore/faststore/packages/core/discovery.config.default.js

package/.turbo/turbo-test.log

@@ -1,13 +1,13 @@
 
-> @faststore/core@4.1.0-dev.0 test /home/runner/work/faststore/faststore/packages/core
+> @faststore/core@4.1.0-dev.10 test /home/runner/work/faststore/faststore/packages/core
 > vitest run
 
 
  RUN  v4.0.7 /home/runner/work/faststore/faststore/packages/core
 
- ✓  node  test/utils/match-url.test.ts (10 tests) 30ms
- ✓  node  test/utils/localization/bindingPaths.test.ts (71 tests) 69ms
- ✓  node  test/sdk/localization/bindingSelector.test.ts (18 tests) 11ms
+ ✓  node  test/utils/match-url.test.ts (10 tests) 15ms
+ ✓  node  test/utils/localization/bindingPaths.test.ts (71 tests) 32ms
+ ✓  node  test/sdk/localization/bindingSelector.test.ts (18 tests) 27ms
 stderr | test/sdk/localization/store-url.browser.test.ts
 Error in optimistic validation: TypeError: Cannot read properties of undefined (reading 'read')
     at validateCart (/home/runner/work/faststore/faststore/packages/core/src/sdk/cart/index.ts:119:27)
@@ -23,26 +23,26 @@
     at a (/home/runner/work/faststore/faststore/packages/sdk/dist/es/index.mjs:353:23)
     at processTicksAndRejections (node:internal/process/task_queues:103:5)
 
- ✓  node  test/sdk/search/useSearchHistory.test.ts (13 tests) 192ms
- ✓  browser  test/sdk/localization/store-url.browser.test.ts (3 tests) 18ms
- ✓  node  test/sdk/localization/useBindingSelector.test.tsx (12 tests) 27ms
- ✓  node  test/utils/cookieCacheBusting.test.ts (10 tests) 31ms
- ✓  node  test/utils/multipleTemplates.test.ts (8 tests) 12ms
- ✓  node  test/utils/clearCookies.test.ts (20 tests) 87ms
- ✓  node  test/server/cms/global.test.ts (3 tests) 26ms
- ✓  node  test/server/content/service.test.ts (5 tests) 18ms
- ✓  node  test/sdk/localization/store-url.test.ts (1 test) 7ms
- ✓  node  test/utils/getRequestHostname.test.ts (12 tests) 22ms
- ✓  node  test/utils/validateSessionRefreshToken.test.ts (6 tests) 17ms
+ ✓  node  test/utils/cookieCacheBusting.test.ts (10 tests) 18ms
+ ✓  node  test/sdk/search/useSearchHistory.test.ts (13 tests) 67ms
+ ✓  browser  test/sdk/localization/store-url.browser.test.ts (3 tests) 24ms
+ ✓  node  test/sdk/localization/useBindingSelector.test.tsx (12 tests) 17ms
+ ✓  node  test/utils/multipleTemplates.test.ts (8 tests) 10ms
+ ✓  node  test/utils/clearCookies.test.ts (20 tests) 70ms
+ ✓  node  test/server/cms/global.test.ts (3 tests) 16ms
+ ✓  node  test/server/content/service.test.ts (5 tests) 12ms
+ ✓  node  test/utils/getRequestHostname.test.ts (12 tests) 26ms
+ ✓  node  test/sdk/localization/store-url.test.ts (1 test) 18ms
+ ✓  node  test/utils/validateSessionRefreshToken.test.ts (6 tests) 12ms
  ✓  node  test/pages/api/preview.test.ts (2 tests) 21ms
- ✓  node  test/server/cms/index.test.ts (2 tests) 11ms
- ✓  node  test/server/index.test.ts (7 tests) 1871ms
-       ✓ should return a valid merged GraphQL schema  551ms
-       ✓ should exist with its plugins  698ms
-       ✓ should handle options and execute  588ms
+ ✓  node  test/server/cms/index.test.ts (2 tests) 10ms
+ ✓  node  test/server/index.test.ts (7 tests) 1244ms
+       ✓ should return a valid merged GraphQL schema  353ms
+       ✓ should exist with its plugins  305ms
+       ✓ should handle options and execute  566ms
 
  Test Files  17 passed (17)
       Tests  203 passed (203)
-   Start at  18:20:28
-   Duration  13.59s (transform 5.13s, setup 0ms, collect 16.12s, tests 2.47s, environment 7.63s, prepare 575ms)
+   Start at  21:21:56
+   Duration  11.38s (transform 5.19s, setup 0ms, collect 14.71s, tests 1.64s, environment 7.48s, prepare 532ms)
 

package/AGENTS.md

@@ -0,0 +1,167 @@
+# AGENTS.md — `@faststore/core`
+
+> Inherits from [`/AGENTS.md`](../../AGENTS.md) (root). This file adds context specific to `@faststore/core`.
+
+## Purpose
+
+`@faststore/core` is the **integration layer** that orchestrates all packages. It is a Next.js application acting as the reference implementation and starter template for FastStore stores.
+
+## Tech
+
+- Next.js 16 (SSR/SSG)
+- React 18.2
+- GraphQL via `@faststore/api`
+- SCSS Modules for component styles
+
+## Key Directories
+
+- `src/components/` — application components grouped by domain (`account`, `cart`, `cms`, `localization`, `navigation`, `product`, `region`, `search`, `sections`, `templates`, `ui`)
+- `src/pages/` — Next.js file-based routing
+- `src/sdk/` — store-level SDK logic and hooks
+- `src/server/` — server-side utilities
+- `src/customizations/` — store-specific overrides
+- `src/experimental/` — experimental features
+- `cms/faststore/` — CMS configuration (`sections.json`, `base.jsonc`, `content-types.json`)
+- `@generated/` — auto-generated GraphQL types (DO NOT edit)
+- `api/` — GraphQL handler setup
+- `cypress/` — E2E tests
+
+## Key Files
+
+- `next.config.js` — Next.js configuration
+- `discovery.config.default.js` / `discovery.config.js` — store routing/discovery
+- `codegen.ts` — GraphQL code generation config
+- `cms/faststore/sections.json` — CMS sections definition (~2700 lines)
+- `src/Layout.tsx` — main layout
+- `src/constants.ts` — app constants
+- `vtex.env` — platform env file
+- `lighthouserc.js` — Lighthouse CI config
+- `next-seo.config.ts` — SEO defaults
+
+## Common Patterns
+
+### Section/Page component with SCSS Modules
+
+```tsx
+// src/components/sections/MySection/MySection.tsx
+import styles from './my-section.module.scss'
+
+export interface MySectionProps {
+  title: string
+  buyButton: { label: string }
+}
+
+function MySection({ title, buyButton }: MySectionProps) {
+  return (
+    <Section className={styles.section}>
+      {/* JSX using library components */}
+    </Section>
+  )
+}
+
+export default MySection
+```
+
+### Composing with library components
+
+Import from `@faststore/ui` and alias with `UI` prefix to avoid local name collisions:
+
+```tsx
+import {
+  Accordion as UIAccordion,
+  AccordionButton as UIAccordionButton,
+  AccordionItem as UIAccordionItem,
+  AccordionPanel as UIAccordionPanel,
+} from '@faststore/ui'
+
+function ProductDescription({ descriptionData }: Props) {
+  return (
+    <UIAccordion>
+      <UIAccordionItem>
+        <UIAccordionButton>Title</UIAccordionButton>
+        <UIAccordionPanel>Content</UIAccordionPanel>
+      </UIAccordionItem>
+    </UIAccordion>
+  )
+}
+```
+
+### Analytics events
+
+```ts
+import { sendAnalyticsEvent } from '@faststore/sdk'
+
+sendAnalyticsEvent({
+  name: 'event_name',
+  params: {
+    /* event data */
+  },
+})
+```
+
+## Common Tasks
+
+### Adding a section
+
+1. Create component under `src/components/sections/MySection/` (SCSS Modules).
+2. Compose with `@faststore/ui` components.
+3. Add the section definition to `cms/faststore/sections.json` (props, schema, defaults).
+4. Export from the section folder's `index.ts`.
+
+### Adding a page
+
+1. Create file under `src/pages/` (e.g. `product/[slug].tsx`).
+2. Use Next.js conventions (`getStaticProps`, `getServerSideProps`).
+3. Compose with sections and components.
+
+### Adding a store-specific UI component
+
+1. Place under `src/components/ui/` or `src/components/sections/`.
+2. Create `*.module.scss` alongside the component.
+3. Compose library components from `@faststore/ui`.
+
+### Updating styles
+
+- For core/sections: edit the `.module.scss` next to the component.
+- For library tokens: edit `packages/ui/src/styles/`.
+
+### Managing SVG icons
+
+Icons are loaded from a single sprite at `public/icons.svg` via the `Icon` component from `@faststore/ui`.
+
+1. Open `public/icons.svg` and add a new `<symbol>` with a unique `id`
+2. Remove `fill`, `stroke-width`, `width`, `height`, and `color` attributes from the symbol so it can be styled via CSS
+3. Use the icon in any component:
+
+```tsx
+import { Icon } from '@faststore/ui'
+
+;<Icon name="Bell" weight="thin" />
+```
+
+This project uses icons from [Phosphor Icons](https://phosphoricons.com/).
+
+## Tests
+
+`@faststore/core` separates tests by environment:
+
+- **Node tests:** `*.test.{ts,tsx}` run in Node.
+- **Browser tests:** `*.browser.test.{ts,tsx}` run in a browser-like environment.
+
+Run:
+
+```bash
+cd packages/core
+pnpm test           # unit + integration
+pnpm test:e2e       # Cypress E2E
+pnpm lhci           # Lighthouse performance audit
+```
+
+## Generated Files (DO NOT EDIT)
+
+- `@generated/` — GraphQL types
+- `dist/` — build outputs
+
+## Performance
+
+`@faststore/core` MUST generate static pages using Jamstack principles for optimal TTFB and Core Web Vitals. Lighthouse CI gates apply. See root [Architectural Principles §II](../../AGENTS.md).

package/CHANGELOG.md

@@ -3,6 +3,56 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 4.1.0-dev.11 (2026-05-15)
+
+**Note:** Version bump only for package @faststore/core
+
+# [4.1.0-dev.10](https://github.com/vtex/faststore/compare/v4.1.0...v4.1.0-dev.10) (2026-05-15)
+
+**Note:** Version bump only for package @faststore/core
+
+# [4.1.0-dev.9](https://github.com/vtex/faststore/compare/v4.1.0-dev.8...v4.1.0-dev.9) (2026-05-15)
+
+**Note:** Version bump only for package @faststore/core
+
+# [4.1.0-dev.8](https://github.com/vtex/faststore/compare/v4.1.0-dev.7...v4.1.0-dev.8) (2026-05-15)
+
+**Note:** Version bump only for package @faststore/core
+
+# [4.1.0-dev.7](https://github.com/vtex/faststore/compare/v4.1.0-dev.6...v4.1.0-dev.7) (2026-05-15)
+
+**Note:** Version bump only for package @faststore/core
+
+# [4.1.0-dev.6](https://github.com/vtex/faststore/compare/v4.1.0-dev.5...v4.1.0-dev.6) (2026-05-14)
+
+**Note:** Version bump only for package @faststore/core
+
+# [4.1.0-dev.5](https://github.com/vtex/faststore/compare/v4.1.0-dev.4...v4.1.0-dev.5) (2026-05-14)
+
+### Bug Fixes
+
+- region slider section render ([#3318](https://github.com/vtex/faststore/issues/3318)) ([f9f5e0d](https://github.com/vtex/faststore/commit/f9f5e0dbd6c3e92b24a3fb1e21a95bfb1c6744f1)), closes [#2887](https://github.com/vtex/faststore/issues/2887) [#2961](https://github.com/vtex/faststore/issues/2961) [#3071](https://github.com/vtex/faststore/issues/3071)
+
+# [4.1.0-dev.4](https://github.com/vtex/faststore/compare/v4.1.0-dev.3...v4.1.0-dev.4) (2026-05-13)
+
+**Note:** Version bump only for package @faststore/core
+
+# [4.1.0-dev.3](https://github.com/vtex/faststore/compare/v4.1.0-dev.2...v4.1.0-dev.3) (2026-05-13)
+
+**Note:** Version bump only for package @faststore/core
+
+# [4.1.0-dev.2](https://github.com/vtex/faststore/compare/v4.1.0-dev.1...v4.1.0-dev.2) (2026-05-12)
+
+### Bug Fixes
+
+- allow_all_components for CMS ([#3312](https://github.com/vtex/faststore/issues/3312)) ([eadeaa3](https://github.com/vtex/faststore/commit/eadeaa36782b40be0fe7fb16604f7a5bc3da2b79))
+
+# 4.1.0 (2026-05-11)
+
+### Features
+
+- version bump 4.1.0 ([#3310](https://github.com/vtex/faststore/issues/3310)) ([1ea7bac](https://github.com/vtex/faststore/commit/1ea7bac649d783e50a9e79f8fe412009ae4a87f7)), closes [#3309](https://github.com/vtex/faststore/issues/3309) [#3308](https://github.com/vtex/faststore/issues/3308) [#3306](https://github.com/vtex/faststore/issues/3306) [#3304](https://github.com/vtex/faststore/issues/3304) [#3301](https://github.com/vtex/faststore/issues/3301)
+
 # [4.1.0-dev.1](https://github.com/vtex/faststore/compare/v4.1.0-dev.0...v4.1.0-dev.1) (2026-05-11)
 
 **Note:** Version bump only for package @faststore/core