@wocart/storefront 1.15.0 → 1.16.0

package/CHANGELOG.md

@@ -5,6 +5,17 @@ follows [semantic versioning](https://semver.org/): breaking changes ship only
 in a new major version, and an export is marked `@deprecated` for at least one
 minor release before a major removes it.
 
+## 1.16.0 — 2026-10-18
+
+### Changed
+
+- `pageData.get(surface)` reads the document the store composed for the
+  client's theme: a client created with `theme` sends it
+  (`/store/page-documents/{surface}?theme=`), so a store keeps one document
+  per theme and switching themes never shows another theme's page. Without
+  `theme`, the server answers the most recently saved document for the
+  surface, as before.
+
 ## 1.15.0 — 2026-10-18
 
 ### Added

package/USAGE.md

@@ -884,8 +884,9 @@ Do not invent tracking events from a landing-page slug.
 const saved = await store.pageData.get("home");   // null = never saved / failed
 ~~~
 
-One document per surface ("home" today), owned by the store and written by
-the platform's page editor — a storefront never writes it. `null` means the store has never saved one (or the read
+One document per theme and surface ("home" today), owned by the store and
+written by the platform's page editor — a storefront never writes it. A
+client created with `theme` reads the document composed for that theme. `null` means the store has never saved one (or the read
 failed): render the theme's shipped default document. The payload is
 **transport-checked only** (`version`, `surface`, `sections`) and fetched
 fresh on every call, so a save reaches the next render.

package/dist/client/page-data.d.ts

@@ -2,8 +2,10 @@
  * Page Data Namespace — the store's saved composition document.
  *
  * Deep module: hides URL construction and transport behind one call. The
- * document belongs to the store (one per surface — "home" today) and is
- * written by the platform's editor; this namespace is the theme's read side.
+ * document belongs to the store (one per theme and surface — "home" today)
+ * and is written by the platform's editor; this namespace is the theme's
+ * read side. A client created with `theme` reads that theme's document;
+ * without it, the server answers the most recently saved one for the surface.
  *
  * Transport semantics (NOT the document contract): the payload is validated
  * as `{ version, surface, sections }` and returns `null` for "no saved

package/dist/client/page-data.js

@@ -2,8 +2,10 @@
  * Page Data Namespace — the store's saved composition document.
  *
  * Deep module: hides URL construction and transport behind one call. The
- * document belongs to the store (one per surface — "home" today) and is
- * written by the platform's editor; this namespace is the theme's read side.
+ * document belongs to the store (one per theme and surface — "home" today)
+ * and is written by the platform's editor; this namespace is the theme's
+ * read side. A client created with `theme` reads that theme's document;
+ * without it, the server answers the most recently saved one for the surface.
  *
  * Transport semantics (NOT the document contract): the payload is validated
  * as `{ version, surface, sections }` and returns `null` for "no saved
@@ -24,7 +26,9 @@ export function createPageDataNamespace(core) {
     return {
         async get(surface) {
             try {
-                const document = await core.get(`/store/page-documents/${encodeURIComponent(surface)}`, PageDocumentPayloadSchema.nullable(), { operation: STOREFRONT_OPERATIONS.pageDataGet });
+                const path = `/store/page-documents/${encodeURIComponent(surface)}`;
+                const theme = core.config.theme;
+                const document = await core.get(theme === undefined ? path : `${path}?${new URLSearchParams({ theme })}`, PageDocumentPayloadSchema.nullable(), { operation: STOREFRONT_OPERATIONS.pageDataGet });
                 return document ?? null;
             }
             catch (error) {

package/dist/domain.d.ts

@@ -12,7 +12,8 @@ export interface StoreScope {
      * The key of the theme this client renders (`defineTheme({ key })` in
      * `@wocart/theme`). The store's edits to that theme's text arrive as
      * `StoreConfig.contentOverrides`; without it there are none, because edits
-     * belong to the theme that declares their keys. The server owns the key
+     * belong to the theme that declares their keys. `pageData.get` reads the
+     * documents the store composed for that theme. The server owns the key
      * format and refuses a malformed one.
      */
     readonly theme?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wocart/storefront",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Typed, validated SDK for Wocart cash-on-delivery storefronts: catalog reads, basket, checkout, OTP and order tracking, with Astro adapters.",
   "keywords": [
     "wocart",