@shoppexio/builder-contracts 0.1.11 → 0.1.12

package/dist/preview-boot.d.ts

@@ -64,5 +64,7 @@ export declare const PreviewBootPayloadSchema: z.ZodObject<{
     artifactStale: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type PreviewBootPayload = z.infer<typeof PreviewBootPayloadSchema>;
+/** Merge preview session identity + draft builder settings into an existing initial-data blob. */
+export declare function mergePreviewBootFieldsIntoInitialData(initialData: Record<string, unknown>, payload: PreviewBootPayload): Record<string, unknown>;
 export declare function mergePreviewBootIntoInitialData(payload: PreviewBootPayload): Record<string, unknown>;
 //# sourceMappingURL=preview-boot.d.ts.map

package/dist/preview-boot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview-boot.d.ts","sourceRoot":"","sources":["../src/preview-boot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AAIvE,eAAO,MAAM,oBAAoB;;;;;iBAOjB,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAS1B,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB"}
+{"version":3,"file":"preview-boot.d.ts","sourceRoot":"","sources":["../src/preview-boot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AAIvE,eAAO,MAAM,oBAAoB;;;;;iBAOjB,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAS1B,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,kGAAkG;AAClG,wBAAgB,qCAAqC,CACnD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB"}

package/dist/preview-boot.js

@@ -21,10 +21,11 @@ export const PreviewBootPayloadSchema = z
     artifactStale: z.boolean().optional(),
 })
     .strict();
-export function mergePreviewBootIntoInitialData(payload) {
-    const existingStore = isRecord(payload.storefrontSeed.store) ? payload.storefrontSeed.store : {};
+/** Merge preview session identity + draft builder settings into an existing initial-data blob. */
+export function mergePreviewBootFieldsIntoInitialData(initialData, payload) {
+    const existingStore = isRecord(initialData.store) ? initialData.store : {};
     return {
-        ...payload.storefrontSeed,
+        ...initialData,
         store: {
             ...existingStore,
             id: payload.shopId,
@@ -33,6 +34,9 @@ export function mergePreviewBootIntoInitialData(payload) {
         },
     };
 }
+export function mergePreviewBootIntoInitialData(payload) {
+    return mergePreviewBootFieldsIntoInitialData(payload.storefrontSeed, payload);
+}
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }

package/dist/preview-protocol.d.ts

@@ -432,6 +432,11 @@ export declare const PreviewInlineEditCommitResponseSchema: z.ZodObject<{
     contentPath: z.ZodString;
     value: z.ZodString;
 }, z.core.$strict>;
+/** Iframe reports in-preview navigation (pathname + search) for server-liquid block renders. */
+export declare const PreviewRouteChangedResponseSchema: z.ZodObject<{
+    type: z.ZodLiteral<"PREVIEW_ROUTE_CHANGED">;
+    path: z.ZodString;
+}, z.core.$strict>;
 export declare const PreviewResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"BOOTSTRAP_OK">;
     revision: z.ZodNumber;
@@ -566,6 +571,9 @@ export declare const PreviewResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject
     blockId: z.ZodString;
     contentPath: z.ZodString;
     value: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"PREVIEW_ROUTE_CHANGED">;
+    path: z.ZodString;
 }, z.core.$strict>], "type">;
 export type PreviewResponse = z.infer<typeof PreviewResponseSchema>;
 //# sourceMappingURL=preview-protocol.d.ts.map

package/dist/preview-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview-protocol.d.ts","sourceRoot":"","sources":["../src/preview-protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"preview-protocol.d.ts","sourceRoot":"","sources":["../src/preview-protocol.ts"],"names":[],"mappings":"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"}

package/dist/preview-protocol.js

@@ -250,6 +250,13 @@ export const PreviewInlineEditCommitResponseSchema = z
     value: z.string(),
 })
     .strict();
+/** Iframe reports in-preview navigation (pathname + search) for server-liquid block renders. */
+export const PreviewRouteChangedResponseSchema = z
+    .object({
+    type: z.literal('PREVIEW_ROUTE_CHANGED'),
+    path: z.string().min(1),
+})
+    .strict();
 export const PreviewResponseSchema = z.discriminatedUnion('type', [
     PreviewBootstrapOkResponseSchema,
     PreviewBootFailedResponseSchema,
@@ -263,4 +270,5 @@ export const PreviewResponseSchema = z.discriminatedUnion('type', [
     PreviewBlockRectResponseSchema,
     PreviewInserterHoverResponseSchema,
     PreviewInlineEditCommitResponseSchema,
+    PreviewRouteChangedResponseSchema,
 ]);

package/dist/preview-route.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Normalizes the storefront route visible inside a theme-preview iframe after the
+ * worker strips the `/s/:sessionId/:draftToken` prefix via history.replaceState.
+ */
+export declare function readPreviewStorefrontRoutePath(pathname: string, search?: string, hash?: string): string | null;
+//# sourceMappingURL=preview-route.d.ts.map

package/dist/preview-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-route.d.ts","sourceRoot":"","sources":["../src/preview-route.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAK,EACX,IAAI,SAAK,GACR,MAAM,GAAG,IAAI,CAaf"}

package/dist/preview-route.js

@@ -0,0 +1,16 @@
+/**
+ * Normalizes the storefront route visible inside a theme-preview iframe after the
+ * worker strips the `/s/:sessionId/:draftToken` prefix via history.replaceState.
+ */
+export function readPreviewStorefrontRoutePath(pathname, search = '', hash = '') {
+    const path = pathname.trim() || '/';
+    if (path.includes('/__shoppex/')) {
+        return null;
+    }
+    const lastSegment = path.split('/').pop() ?? '';
+    if (lastSegment.includes('.')) {
+        return null;
+    }
+    const normalizedPath = path.replace(/\/+$/, '') || '/';
+    return `${normalizedPath}${search}${hash}`;
+}

package/dist/storefront-initial-data-html.d.ts

@@ -12,6 +12,13 @@ export declare function buildPlainInitialDataScript(initialData: Record<string,
 export declare function buildWrappedStorefrontInitialDataScript(serialized: string, deployedThemeEntryPathPattern: RegExp): string;
 export declare function injectPlainInitialDataBeforeHeadClose(html: string, script: string): string;
 export declare function injectPreviewInitialData(html: string, payload: PreviewBootPayload): string;
+/**
+ * Server-liquid preview pages are SSR'd with live storefront slices (storeStats, catalog, …).
+ * Replacing their initial-data scripts with the build-time artifact seed drops live sales counts
+ * and the bootstrap hydration pass overwrites hero stats back to 0. Keep the SSR snapshot and
+ * only merge preview-session fields (shop id/slug + draft builder settings).
+ */
+export declare function injectServerLiquidPreviewBoot(html: string, payload: PreviewBootPayload): string;
 export declare function assertSingleInitialDataScript(html: string, expectedSlug: string): void;
 export declare function safeJson(value: unknown): string;
 //# sourceMappingURL=storefront-initial-data-html.d.ts.map

package/dist/storefront-initial-data-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storefront-initial-data-html.d.ts","sourceRoot":"","sources":["../src/storefront-initial-data-html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,eAAO,MAAM,0BAA0B,QAC8K,CAAC;AAEtN,eAAO,MAAM,2BAA2B,QACuB,CAAC;AAOhE,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAYrF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWnF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAExF;AAED,wBAAgB,uCAAuC,CACrD,UAAU,EAAE,MAAM,EAClB,6BAA6B,EAAE,MAAM,GACpC,MAAM,CAOR;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1F;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAK1F;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAmBtF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C"}
+{"version":3,"file":"storefront-initial-data-html.d.ts","sourceRoot":"","sources":["../src/storefront-initial-data-html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM5D,eAAO,MAAM,0BAA0B,QAC8K,CAAC;AAEtN,eAAO,MAAM,2BAA2B,QACuB,CAAC;AAOhE,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAYrF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWnF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAExF;AAED,wBAAgB,uCAAuC,CACrD,UAAU,EAAE,MAAM,EAClB,6BAA6B,EAAE,MAAM,GACpC,MAAM,CAOR;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1F;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAK1F;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAa/F;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAmBtF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C"}

package/dist/storefront-initial-data-html.js

@@ -1,4 +1,4 @@
-import { mergePreviewBootIntoInitialData } from "./preview-boot.js";
+import { mergePreviewBootFieldsIntoInitialData, mergePreviewBootIntoInitialData, } from "./preview-boot.js";
 export const HTML_INITIAL_BLOCK_PATTERN = /<!--shoppex-initial-data:start--><script>\(function\(\)\{[\s\S]*?window\.__SHOPPEX_INITIAL__=([\s\S]*?)(?=;\}\)\(\);<\/script><!--shoppex-initial-data:end-->);\}\)\(\);<\/script><!--shoppex-initial-data:end-->/;
 export const LEGACY_HTML_INITIAL_PATTERN = /<script>\s*window\.__SHOPPEX_INITIAL__=([\s\S]*?)<\/script>/;
 const HTML_INITIAL_BLOCK_GLOBAL_PATTERN = new RegExp(HTML_INITIAL_BLOCK_PATTERN.source, 'g');
@@ -61,6 +61,25 @@ export function injectPreviewInitialData(html, payload) {
     const script = buildPlainInitialDataScript(initialData);
     return injectPlainInitialDataBeforeHeadClose(withoutScripts, script);
 }
+/**
+ * Server-liquid preview pages are SSR'd with live storefront slices (storeStats, catalog, …).
+ * Replacing their initial-data scripts with the build-time artifact seed drops live sales counts
+ * and the bootstrap hydration pass overwrites hero stats back to 0. Keep the SSR snapshot and
+ * only merge preview-session fields (shop id/slug + draft builder settings).
+ */
+export function injectServerLiquidPreviewBoot(html, payload) {
+    const existing = findInitialDataPayload(html);
+    if (!existing) {
+        const merged = mergePreviewBootFieldsIntoInitialData({ store: {} }, payload);
+        const withoutScripts = stripAllInitialDataScripts(html);
+        const script = buildPlainInitialDataScript(merged);
+        return injectPlainInitialDataBeforeHeadClose(withoutScripts, script);
+    }
+    const merged = mergePreviewBootFieldsIntoInitialData(existing, payload);
+    const withoutScripts = stripAllInitialDataScripts(html);
+    const script = buildPlainInitialDataScript(merged);
+    return injectPlainInitialDataBeforeHeadClose(withoutScripts, script);
+}
 export function assertSingleInitialDataScript(html, expectedSlug) {
     const count = countInitialDataScripts(html);
     if (count !== 1) {

package/dist/theme-schemes.d.ts

@@ -1,9 +1,9 @@
-export declare const PUBLIC_BUILDER_THEME_SCHEMES: readonly ["default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "clean-minimal"];
+export declare const PUBLIC_BUILDER_THEME_SCHEMES: readonly ["default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "clean-minimal", "shadow"];
 export type PublicBuilderThemeScheme = (typeof PUBLIC_BUILDER_THEME_SCHEMES)[number];
 export declare const STARTER_BUILDER_THEME_SCHEMES: readonly ["blank"];
 export declare const THEME_STORE_DISABLED_SCHEMES: readonly [];
-export declare const THEME_STORE_INSTALLABLE_SCHEMES: readonly ["default", "starlight", "pulse", "vault", "clean-minimal", "classic", "phantom", "nebula", "apex"];
-export declare const BUILDER_READY_THEME_SCHEMES: readonly ["blank", "default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "clean-minimal"];
+export declare const THEME_STORE_INSTALLABLE_SCHEMES: readonly ["default", "starlight", "pulse", "vault", "clean-minimal", "classic", "phantom", "nebula", "apex", "shadow"];
+export declare const BUILDER_READY_THEME_SCHEMES: readonly ["blank", "default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "clean-minimal", "shadow"];
 export type ThemeStoreInstallableScheme = (typeof THEME_STORE_INSTALLABLE_SCHEMES)[number];
 export type StarterBuilderThemeScheme = (typeof STARTER_BUILDER_THEME_SCHEMES)[number];
 export type BuilderReadyThemeScheme = (typeof BUILDER_READY_THEME_SCHEMES)[number];

package/dist/theme-schemes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-schemes.d.ts","sourceRoot":"","sources":["../src/theme-schemes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,8GAU/B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAErF,eAAO,MAAM,6BAA6B,oBAAqB,CAAC;AAEhE,eAAO,MAAM,4BAA4B,aAA4D,CAAC;AAItG,eAAO,MAAM,+BAA+B,8GAUY,CAAC;AAEzD,eAAO,MAAM,2BAA2B,uHAG9B,CAAC;AAEX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3F,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AACvF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,wBAAwB,CAE3F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,2BAA2B,CAEtC;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,yBAAyB,CAE7F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,uBAAuB,CAEzF"}
+{"version":3,"file":"theme-schemes.d.ts","sourceRoot":"","sources":["../src/theme-schemes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,wHAW/B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAErF,eAAO,MAAM,6BAA6B,oBAAqB,CAAC;AAEhE,eAAO,MAAM,4BAA4B,aAA4D,CAAC;AAItG,eAAO,MAAM,+BAA+B,wHAWY,CAAC;AAEzD,eAAO,MAAM,2BAA2B,iIAG9B,CAAC;AAEX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3F,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AACvF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,wBAAwB,CAE3F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,2BAA2B,CAEtC;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,yBAAyB,CAE7F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,uBAAuB,CAEzF"}

package/dist/theme-schemes.js

@@ -8,6 +8,7 @@ export const PUBLIC_BUILDER_THEME_SCHEMES = [
     'apex',
     'vault',
     'clean-minimal',
+    'shadow',
 ];
 export const STARTER_BUILDER_THEME_SCHEMES = ['blank'];
 export const THEME_STORE_DISABLED_SCHEMES = [];
@@ -22,6 +23,7 @@ export const THEME_STORE_INSTALLABLE_SCHEMES = [
     'phantom',
     'nebula',
     'apex',
+    'shadow',
 ];
 export const BUILDER_READY_THEME_SCHEMES = [
     ...STARTER_BUILDER_THEME_SCHEMES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shoppexio/builder-contracts",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Shared Builder v2 contracts for Shoppex dashboard, backend, preview runtime, and themes",
   "type": "module",
   "repository": {
@@ -91,6 +91,12 @@
       "import": "./dist/preview-protocol.js",
       "default": "./dist/preview-protocol.js"
     },
+    "./preview-route": {
+      "bun": "./src/preview-route.ts",
+      "types": "./dist/preview-route.d.ts",
+      "import": "./dist/preview-route.js",
+      "default": "./dist/preview-route.js"
+    },
     "./preview-boot": {
       "bun": "./src/preview-boot.ts",
       "types": "./dist/preview-boot.d.ts",

package/src/builder-contracts.test.ts

@@ -857,7 +857,7 @@ describe('@shoppex/builder-contracts', () => {
 
   test('parses official theme manifests with transparent contact-form backgrounds', () => {
     const repoRoot = join(import.meta.dir, '../../..');
-    for (const theme of ['default', 'nebula', 'classic', 'pulse', 'starlight', 'vault', 'phantom', 'apex']) {
+    for (const theme of ['default', 'nebula', 'classic', 'pulse', 'starlight', 'vault', 'phantom', 'apex', 'shadow']) {
       const manifestPath = join(repoRoot, 'themes', theme, 'theme.manifest.json');
       const raw = JSON.parse(readFileSync(manifestPath, 'utf8'));
       expect(ThemeManifestSchema.safeParse(raw).success, `${theme} manifest should validate`).toBe(true);

package/src/preview-boot.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'bun:test';
-import { mergePreviewBootIntoInitialData, PreviewBootPayloadSchema } from './preview-boot.ts';
+import { mergePreviewBootFieldsIntoInitialData, mergePreviewBootIntoInitialData, PreviewBootPayloadSchema } from './preview-boot.ts';
 
 describe('PreviewBootPayloadSchema', () => {
   it('accepts storefront seeds with catalog fields from built theme artifacts', () => {
@@ -69,4 +69,41 @@ describe('PreviewBootPayloadSchema', () => {
     expect(initialData.addons).toEqual([{ id: 'addon_1' }]);
     expect(initialData.menus).toEqual([{ id: 'menu_1' }]);
   });
+
+  it('mergePreviewBootFieldsIntoInitialData preserves live storeStats from SSR snapshots', () => {
+    const initialData = mergePreviewBootFieldsIntoInitialData(
+      {
+        store: { slug: 'florain', name: 'Florain' },
+        storeStats: { sales: '29', products: '13+', rating: '0.0' },
+        products: [{ uniqid: 'p1' }],
+      },
+      {
+        shopId: 'shop_1',
+        shopSlug: 'florain',
+        builderSettings: {
+          version: 2,
+          revision: 2,
+          theme: {
+            content: {},
+            layout: {},
+            style_slots: {},
+            pages: [],
+            terms: {},
+          },
+        },
+        storefrontSeed: {
+          store: { slug: 'stale-artifact', products_sold_count: 0 },
+          storeStats: { sales: '0' },
+        },
+      },
+    );
+
+    expect(initialData.storeStats).toEqual({ sales: '29', products: '13+', rating: '0.0' });
+    expect(initialData.products).toEqual([{ uniqid: 'p1' }]);
+    expect(initialData.store).toMatchObject({
+      id: 'shop_1',
+      slug: 'florain',
+      name: 'Florain',
+    });
+  });
 });

package/src/preview-boot.ts

@@ -29,12 +29,14 @@ export const PreviewBootPayloadSchema = z
 
 export type PreviewBootPayload = z.infer<typeof PreviewBootPayloadSchema>;
 
-export function mergePreviewBootIntoInitialData(
+/** Merge preview session identity + draft builder settings into an existing initial-data blob. */
+export function mergePreviewBootFieldsIntoInitialData(
+  initialData: Record<string, unknown>,
   payload: PreviewBootPayload,
 ): Record<string, unknown> {
-  const existingStore = isRecord(payload.storefrontSeed.store) ? payload.storefrontSeed.store : {};
+  const existingStore = isRecord(initialData.store) ? initialData.store : {};
   return {
-    ...payload.storefrontSeed,
+    ...initialData,
     store: {
       ...existingStore,
       id: payload.shopId,
@@ -44,6 +46,15 @@ export function mergePreviewBootIntoInitialData(
   };
 }
 
+export function mergePreviewBootIntoInitialData(
+  payload: PreviewBootPayload,
+): Record<string, unknown> {
+  return mergePreviewBootFieldsIntoInitialData(
+    payload.storefrontSeed as Record<string, unknown>,
+    payload,
+  );
+}
+
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === 'object' && value !== null && !Array.isArray(value);
 }

package/src/preview-protocol.test.ts

@@ -259,6 +259,17 @@ describe('PreviewResponseSchema', () => {
     }
   });
 
+  it('accepts PREVIEW_ROUTE_CHANGED with storefront path', () => {
+    const parsed = PreviewResponseSchema.parse({
+      type: 'PREVIEW_ROUTE_CHANGED',
+      path: '/products?category=fivem&sort=price-asc',
+    });
+    expect(parsed.type).toBe('PREVIEW_ROUTE_CHANGED');
+    if (parsed.type === 'PREVIEW_ROUTE_CHANGED') {
+      expect(parsed.path).toBe('/products?category=fivem&sort=price-asc');
+    }
+  });
+
   it('rejects INLINE_EDIT_COMMIT without contentPath', () => {
     const result = PreviewResponseSchema.safeParse({
       type: 'INLINE_EDIT_COMMIT',

package/src/preview-protocol.ts

@@ -286,6 +286,14 @@ export const PreviewInlineEditCommitResponseSchema = z
   })
   .strict();
 
+/** Iframe reports in-preview navigation (pathname + search) for server-liquid block renders. */
+export const PreviewRouteChangedResponseSchema = z
+  .object({
+    type: z.literal('PREVIEW_ROUTE_CHANGED'),
+    path: z.string().min(1),
+  })
+  .strict();
+
 export const PreviewResponseSchema = z.discriminatedUnion('type', [
   PreviewBootstrapOkResponseSchema,
   PreviewBootFailedResponseSchema,
@@ -299,5 +307,6 @@ export const PreviewResponseSchema = z.discriminatedUnion('type', [
   PreviewBlockRectResponseSchema,
   PreviewInserterHoverResponseSchema,
   PreviewInlineEditCommitResponseSchema,
+  PreviewRouteChangedResponseSchema,
 ]);
 export type PreviewResponse = z.infer<typeof PreviewResponseSchema>;

package/src/preview-route.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, test } from 'vitest';
+import { readPreviewStorefrontRoutePath } from './preview-route';
+
+describe('readPreviewStorefrontRoutePath', () => {
+  test('returns pathname and search for storefront routes', () => {
+    expect(readPreviewStorefrontRoutePath('/products', '?category=fivem&sort=price-asc'))
+      .toBe('/products?category=fivem&sort=price-asc');
+  });
+
+  test('normalizes trailing slashes on non-root paths', () => {
+    expect(readPreviewStorefrontRoutePath('/products/', '?page=2')).toBe('/products?page=2');
+  });
+
+  test('preserves root path', () => {
+    expect(readPreviewStorefrontRoutePath('/', '?currency=EUR')).toBe('/?currency=EUR');
+  });
+
+  test('rejects asset and sidecar paths', () => {
+    expect(readPreviewStorefrontRoutePath('/assets/built.css')).toBeNull();
+    expect(readPreviewStorefrontRoutePath('/s/session/token/__shoppex/preview-boot.json')).toBeNull();
+  });
+});

package/src/preview-route.ts

@@ -0,0 +1,22 @@
+/**
+ * Normalizes the storefront route visible inside a theme-preview iframe after the
+ * worker strips the `/s/:sessionId/:draftToken` prefix via history.replaceState.
+ */
+export function readPreviewStorefrontRoutePath(
+  pathname: string,
+  search = '',
+  hash = '',
+): string | null {
+  const path = pathname.trim() || '/';
+  if (path.includes('/__shoppex/')) {
+    return null;
+  }
+
+  const lastSegment = path.split('/').pop() ?? '';
+  if (lastSegment.includes('.')) {
+    return null;
+  }
+
+  const normalizedPath = path.replace(/\/+$/, '') || '/';
+  return `${normalizedPath}${search}${hash}`;
+}

package/src/storefront-initial-data-html.test.ts

@@ -6,6 +6,7 @@ import {
   countInitialDataScripts,
   findInitialDataPayload,
   injectPreviewInitialData,
+  injectServerLiquidPreviewBoot,
   stripAllInitialDataScripts,
 } from './storefront-initial-data-html.ts';
 
@@ -56,6 +57,31 @@ describe('storefront-initial-data-html', () => {
       slug: 'demo-shop',
     });
   });
+
+  it('preserves live storeStats when merging preview boot into server-liquid SSR initial data', () => {
+    const html = [
+      '<html><head>',
+      '<script>window.__SHOPPEX_INITIAL__={"store":{"slug":"florain","name":"Florain"},"storeStats":{"sales":"29","products":"13+","rating":"0.0"}};</script>',
+      '<script data-shoppex-bootstrap="v2">window.shopId="shop_1";</script>',
+      '</head><body><span data-shoppex-runtime-stat="sales">29</span></body></html>',
+    ].join('');
+
+    const next = injectServerLiquidPreviewBoot(html, samplePayload);
+    expect(countInitialDataScripts(next)).toBe(1);
+    assertSingleInitialDataScript(next, 'demo-shop');
+    expect(findInitialDataPayload(next)).toMatchObject({
+      storeStats: {
+        sales: '29',
+        products: '13+',
+        rating: '0.0',
+      },
+      store: {
+        id: 'shop_1',
+        slug: 'demo-shop',
+        name: 'Florain',
+      },
+    });
+  });
   it('throws when assert sees zero or multiple scripts', () => {
     expect(() => assertSingleInitialDataScript('<html></html>', 'demo-shop')).toThrow();
     const html = [

package/src/storefront-initial-data-html.ts

@@ -1,5 +1,8 @@
 import type { PreviewBootPayload } from './preview-boot.ts';
-import { mergePreviewBootIntoInitialData } from './preview-boot.ts';
+import {
+  mergePreviewBootFieldsIntoInitialData,
+  mergePreviewBootIntoInitialData,
+} from './preview-boot.ts';
 
 export const HTML_INITIAL_BLOCK_PATTERN =
   /<!--shoppex-initial-data:start--><script>\(function\(\)\{[\s\S]*?window\.__SHOPPEX_INITIAL__=([\s\S]*?)(?=;\}\)\(\);<\/script><!--shoppex-initial-data:end-->);\}\)\(\);<\/script><!--shoppex-initial-data:end-->/;
@@ -86,6 +89,27 @@ export function injectPreviewInitialData(html: string, payload: PreviewBootPaylo
   return injectPlainInitialDataBeforeHeadClose(withoutScripts, script);
 }
 
+/**
+ * Server-liquid preview pages are SSR'd with live storefront slices (storeStats, catalog, …).
+ * Replacing their initial-data scripts with the build-time artifact seed drops live sales counts
+ * and the bootstrap hydration pass overwrites hero stats back to 0. Keep the SSR snapshot and
+ * only merge preview-session fields (shop id/slug + draft builder settings).
+ */
+export function injectServerLiquidPreviewBoot(html: string, payload: PreviewBootPayload): string {
+  const existing = findInitialDataPayload(html);
+  if (!existing) {
+    const merged = mergePreviewBootFieldsIntoInitialData({ store: {} }, payload);
+    const withoutScripts = stripAllInitialDataScripts(html);
+    const script = buildPlainInitialDataScript(merged);
+    return injectPlainInitialDataBeforeHeadClose(withoutScripts, script);
+  }
+
+  const merged = mergePreviewBootFieldsIntoInitialData(existing, payload);
+  const withoutScripts = stripAllInitialDataScripts(html);
+  const script = buildPlainInitialDataScript(merged);
+  return injectPlainInitialDataBeforeHeadClose(withoutScripts, script);
+}
+
 export function assertSingleInitialDataScript(html: string, expectedSlug: string): void {
   const count = countInitialDataScripts(html);
   if (count !== 1) {

package/src/theme-schemes.ts

@@ -8,6 +8,7 @@ export const PUBLIC_BUILDER_THEME_SCHEMES = [
   'apex',
   'vault',
   'clean-minimal',
+  'shadow',
 ] as const;
 
 export type PublicBuilderThemeScheme = (typeof PUBLIC_BUILDER_THEME_SCHEMES)[number];
@@ -28,6 +29,7 @@ export const THEME_STORE_INSTALLABLE_SCHEMES = [
   'phantom',
   'nebula',
   'apex',
+  'shadow',
 ] as const satisfies readonly PublicBuilderThemeScheme[];
 
 export const BUILDER_READY_THEME_SCHEMES = [