@shoppexio/builder-contracts 0.1.3 → 0.1.6

package/dist/index.d.ts

@@ -12,6 +12,8 @@ export * from './preview-protocol.ts';
 export * from './preview-session-resolve.ts';
 export * from './preview-trusted-origins.ts';
 export * from './storefront-initial-data-html.ts';
+export * from './storefront-render-integrations.ts';
+export * from './storefront-render-seo.ts';
 export * from './storefront-typography-fonts.ts';
 export * from './style-slots.ts';
 export * from './theme-manifest.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -12,6 +12,8 @@ export * from "./preview-protocol.js";
 export * from "./preview-session-resolve.js";
 export * from "./preview-trusted-origins.js";
 export * from "./storefront-initial-data-html.js";
+export * from "./storefront-render-integrations.js";
+export * from "./storefront-render-seo.js";
 export * from "./storefront-typography-fonts.js";
 export * from "./style-slots.js";
 export * from "./theme-manifest.js";

package/dist/preview-protocol.d.ts

@@ -66,8 +66,8 @@ export declare const PreviewApplyStateMessageSchema: z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>;
 }, z.core.$strict>;
-export declare const EdgeBlockRenderModeSchema: z.ZodLiteral<"edge-block-engine">;
-export type EdgeBlockRenderMode = z.infer<typeof EdgeBlockRenderModeSchema>;
+export declare const ServerLiquidRenderModeSchema: z.ZodLiteral<"server-liquid">;
+export type ServerLiquidRenderMode = z.infer<typeof ServerLiquidRenderModeSchema>;
 export declare const PreviewBlockHtmlPatchSchema: z.ZodObject<{
     blockId: z.ZodString;
     html: z.ZodString;
@@ -78,12 +78,22 @@ export declare const PreviewApplyBlockHtmlMessageSchema: z.ZodObject<{
     revision: z.ZodNumber;
     pageId: z.ZodString;
     sourceRevision: z.ZodString;
-    renderMode: z.ZodLiteral<"edge-block-engine">;
+    renderMode: z.ZodLiteral<"server-liquid">;
     blocks: z.ZodArray<z.ZodObject<{
         blockId: z.ZodString;
         html: z.ZodString;
     }, z.core.$strict>>;
 }, z.core.$strict>;
+export type PreviewApplyBlockHtmlMessage = z.infer<typeof PreviewApplyBlockHtmlMessageSchema>;
+export declare const PreviewApplyPageHtmlMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"APPLY_PAGE_HTML">;
+    revision: z.ZodNumber;
+    pageId: z.ZodString;
+    sourceRevision: z.ZodString;
+    renderMode: z.ZodLiteral<"server-liquid">;
+    html: z.ZodString;
+}, z.core.$strict>;
+export type PreviewApplyPageHtmlMessage = z.infer<typeof PreviewApplyPageHtmlMessageSchema>;
 export declare const PreviewReloadMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"RELOAD">;
     revision: z.ZodNumber;
@@ -187,11 +197,18 @@ export declare const PreviewMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     revision: z.ZodNumber;
     pageId: z.ZodString;
     sourceRevision: z.ZodString;
-    renderMode: z.ZodLiteral<"edge-block-engine">;
+    renderMode: z.ZodLiteral<"server-liquid">;
     blocks: z.ZodArray<z.ZodObject<{
         blockId: z.ZodString;
         html: z.ZodString;
     }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"APPLY_PAGE_HTML">;
+    revision: z.ZodNumber;
+    pageId: z.ZodString;
+    sourceRevision: z.ZodString;
+    renderMode: z.ZodLiteral<"server-liquid">;
+    html: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"RELOAD">;
     revision: z.ZodNumber;
@@ -242,7 +259,7 @@ export declare const PreviewReadyHealthSchema: z.ZodDiscriminatedUnion<[z.ZodObj
     builderRuntimeProvider: z.ZodLiteral<true>;
     protocolVersion: z.ZodLiteral<2>;
 }, z.core.$strict>, z.ZodObject<{
-    edgeBlockEngine: z.ZodLiteral<true>;
+    serverLiquidEngine: z.ZodLiteral<true>;
     blockHtmlReconcile: z.ZodLiteral<true>;
     protocolVersion: z.ZodLiteral<3>;
 }, z.core.$strict>], "protocolVersion">;
@@ -255,7 +272,7 @@ export declare const PreviewReadyResponseSchema: z.ZodObject<{
         builderRuntimeProvider: z.ZodLiteral<true>;
         protocolVersion: z.ZodLiteral<2>;
     }, z.core.$strict>, z.ZodObject<{
-        edgeBlockEngine: z.ZodLiteral<true>;
+        serverLiquidEngine: z.ZodLiteral<true>;
         blockHtmlReconcile: z.ZodLiteral<true>;
         protocolVersion: z.ZodLiteral<3>;
     }, z.core.$strict>], "protocolVersion">>;
@@ -274,7 +291,7 @@ export declare const PreviewBlockHtmlAppliedResponseSchema: z.ZodObject<{
     revision: z.ZodNumber;
     pageId: z.ZodString;
     sourceRevision: z.ZodString;
-    renderMode: z.ZodLiteral<"edge-block-engine">;
+    renderMode: z.ZodLiteral<"server-liquid">;
     blocks: z.ZodArray<z.ZodObject<{
         blockId: z.ZodString;
         html: z.ZodString;
@@ -285,7 +302,7 @@ export declare const PreviewBlockHtmlFailedResponseSchema: z.ZodObject<{
     revision: z.ZodNumber;
     pageId: z.ZodString;
     sourceRevision: z.ZodOptional<z.ZodString>;
-    renderMode: z.ZodLiteral<"edge-block-engine">;
+    renderMode: z.ZodLiteral<"server-liquid">;
     blockIds: z.ZodArray<z.ZodString>;
     error: z.ZodString;
 }, z.core.$strict>;
@@ -418,7 +435,7 @@ export declare const PreviewResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         builderRuntimeProvider: z.ZodLiteral<true>;
         protocolVersion: z.ZodLiteral<2>;
     }, z.core.$strict>, z.ZodObject<{
-        edgeBlockEngine: z.ZodLiteral<true>;
+        serverLiquidEngine: z.ZodLiteral<true>;
         blockHtmlReconcile: z.ZodLiteral<true>;
         protocolVersion: z.ZodLiteral<3>;
     }, z.core.$strict>], "protocolVersion">>;
@@ -434,7 +451,7 @@ export declare const PreviewResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject
     revision: z.ZodNumber;
     pageId: z.ZodString;
     sourceRevision: z.ZodString;
-    renderMode: z.ZodLiteral<"edge-block-engine">;
+    renderMode: z.ZodLiteral<"server-liquid">;
     blocks: z.ZodArray<z.ZodObject<{
         blockId: z.ZodString;
         html: z.ZodString;
@@ -444,7 +461,7 @@ export declare const PreviewResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject
     revision: z.ZodNumber;
     pageId: z.ZodString;
     sourceRevision: z.ZodOptional<z.ZodString>;
-    renderMode: z.ZodLiteral<"edge-block-engine">;
+    renderMode: z.ZodLiteral<"server-liquid">;
     blockIds: z.ZodArray<z.ZodString>;
     error: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{

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

@@ -1 +1 @@
-{"version":3,"file":"preview-protocol.d.ts","sourceRoot":"","sources":["../src/preview-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;kBAYxB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMhC,CAAC;AAEZ,eAAO,MAAM,yBAAyB,mCAAiC,CAAC;AACxE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,2BAA2B;;;kBAK7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,kCAAkC;;;;;;;;;;kBASpC,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;kBAM5B,CAAC;AAEZ,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;kBAMnC,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;kBAIlC,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;EAA8B,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,sCAAsC;;;;;;kBAKxC,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAO/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,gCAAgC;;;;;;kBAQlC,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;uCAenC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;kBAM5B,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;kBAK9B,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;kBAMlC,CAAC;AAEZ,eAAO,MAAM,qCAAqC;;;;;;;;;;kBASvC,CAAC;AAEZ,eAAO,MAAM,oCAAoC;;;;;;;;kBAUtC,CAAC;AAEZ,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;kBAMrC,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0B5B,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;kBAOnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,8BAA8B;;;;;;;;;;kBAOhC,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;kBAOpC,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,qCAAqC;;;;;;kBAQvC,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAYhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"preview-protocol.d.ts","sourceRoot":"","sources":["../src/preview-protocol.ts"],"names":[],"mappings":"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"}

package/dist/preview-protocol.js

@@ -20,7 +20,7 @@ export const PreviewApplyStateMessageSchema = z
     state: BuilderSettingsSchema,
 })
     .strict();
-export const EdgeBlockRenderModeSchema = z.literal('edge-block-engine');
+export const ServerLiquidRenderModeSchema = z.literal('server-liquid');
 export const PreviewBlockHtmlPatchSchema = z
     .object({
     blockId: z.string().min(1),
@@ -33,8 +33,18 @@ export const PreviewApplyBlockHtmlMessageSchema = z
     revision: z.number().int().nonnegative(),
     pageId: z.string().min(1),
     sourceRevision: z.string().min(1),
-    renderMode: EdgeBlockRenderModeSchema,
-    blocks: z.array(PreviewBlockHtmlPatchSchema).min(1),
+    renderMode: ServerLiquidRenderModeSchema,
+    blocks: z.array(PreviewBlockHtmlPatchSchema),
+})
+    .strict();
+export const PreviewApplyPageHtmlMessageSchema = z
+    .object({
+    type: z.literal('APPLY_PAGE_HTML'),
+    revision: z.number().int().nonnegative(),
+    pageId: z.string().min(1),
+    sourceRevision: z.string().min(1),
+    renderMode: ServerLiquidRenderModeSchema,
+    html: z.string().min(1),
 })
     .strict();
 export const PreviewReloadMessageSchema = z
@@ -72,6 +82,7 @@ export const PreviewSetInteractionModeMessageSchema = z
 export const PreviewMessageSchema = z.discriminatedUnion('type', [
     PreviewApplyStateMessageSchema,
     PreviewApplyBlockHtmlMessageSchema,
+    PreviewApplyPageHtmlMessageSchema,
     PreviewReloadMessageSchema,
     PreviewSelectElementMessageSchema,
     PreviewRequestReadyMessageSchema,
@@ -96,7 +107,7 @@ export const PreviewReadyHealthSchema = z.discriminatedUnion('protocolVersion',
         .strict(),
     z
         .object({
-        edgeBlockEngine: z.literal(true),
+        serverLiquidEngine: z.literal(true),
         blockHtmlReconcile: z.literal(true),
         protocolVersion: z.literal(3),
     })
@@ -128,8 +139,8 @@ export const PreviewBlockHtmlAppliedResponseSchema = z
     revision: z.number().int().nonnegative(),
     pageId: z.string().min(1),
     sourceRevision: z.string().min(1),
-    renderMode: EdgeBlockRenderModeSchema,
-    blocks: z.array(PreviewBlockHtmlPatchSchema).min(1),
+    renderMode: ServerLiquidRenderModeSchema,
+    blocks: z.array(PreviewBlockHtmlPatchSchema),
 })
     .strict();
 export const PreviewBlockHtmlFailedResponseSchema = z
@@ -138,8 +149,8 @@ export const PreviewBlockHtmlFailedResponseSchema = z
     revision: z.number().int().nonnegative(),
     pageId: z.string().min(1),
     sourceRevision: z.string().min(1).optional(),
-    renderMode: EdgeBlockRenderModeSchema,
-    blockIds: z.array(z.string().min(1)).min(1),
+    renderMode: ServerLiquidRenderModeSchema,
+    blockIds: z.array(z.string().min(1)),
     error: z.string().min(1),
 })
     .strict();

package/dist/storefront-render-frame-origins.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SSOT for iframe embed origins allowed in the Storefront Render Service CSP (frame-src)
+ * and for custom-embed postMessage trust in storefront-commerce (when registered).
+ */
+export declare const STOREFRONT_RENDER_YOUTUBE_FRAME_ORIGINS: readonly ["https://www.youtube.com", "https://www.youtube-nocookie.com"];
+/** Trusted origins for custom-embed resize postMessage (storefront-commerce). */
+export declare const STOREFRONT_RENDER_CUSTOM_EMBED_TRUSTED_ORIGINS: readonly ["https://calendly.com", "https://substack.com", "https://shoppex.io"];
+/** frame-src entries for custom embed blocks (includes Substack wildcard). */
+export declare const STOREFRONT_RENDER_CUSTOM_EMBED_FRAME_SRC_ORIGINS: readonly ["https://calendly.com", "https://substack.com", "https://shoppex.io", "https://*.substack.com"];
+export declare const STOREFRONT_RENDER_ALLOWED_FRAME_ORIGINS: readonly ["https://www.youtube.com", "https://www.youtube-nocookie.com", "https://calendly.com", "https://substack.com", "https://shoppex.io", "https://*.substack.com"];
+//# sourceMappingURL=storefront-render-frame-origins.d.ts.map

package/dist/storefront-render-frame-origins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-render-frame-origins.d.ts","sourceRoot":"","sources":["../src/storefront-render-frame-origins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,uCAAuC,0EAG1C,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,8CAA8C,iFAIjD,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,gDAAgD,2GAGnD,CAAC;AAEX,eAAO,MAAM,uCAAuC,0KAG1C,CAAC"}

package/dist/storefront-render-frame-origins.js

@@ -0,0 +1,23 @@
+/**
+ * SSOT for iframe embed origins allowed in the Storefront Render Service CSP (frame-src)
+ * and for custom-embed postMessage trust in storefront-commerce (when registered).
+ */
+export const STOREFRONT_RENDER_YOUTUBE_FRAME_ORIGINS = [
+    'https://www.youtube.com',
+    'https://www.youtube-nocookie.com',
+];
+/** Trusted origins for custom-embed resize postMessage (storefront-commerce). */
+export const STOREFRONT_RENDER_CUSTOM_EMBED_TRUSTED_ORIGINS = [
+    'https://calendly.com',
+    'https://substack.com',
+    'https://shoppex.io',
+];
+/** frame-src entries for custom embed blocks (includes Substack wildcard). */
+export const STOREFRONT_RENDER_CUSTOM_EMBED_FRAME_SRC_ORIGINS = [
+    ...STOREFRONT_RENDER_CUSTOM_EMBED_TRUSTED_ORIGINS,
+    'https://*.substack.com',
+];
+export const STOREFRONT_RENDER_ALLOWED_FRAME_ORIGINS = [
+    ...STOREFRONT_RENDER_YOUTUBE_FRAME_ORIGINS,
+    ...STOREFRONT_RENDER_CUSTOM_EMBED_FRAME_SRC_ORIGINS,
+];

package/dist/storefront-render-integrations.d.ts

@@ -0,0 +1,10 @@
+export declare const STOREFRONT_RENDER_INTEGRATIONS_HEADER = "X-Shoppex-Storefront-Integrations";
+export interface StorefrontRenderIntegrationEntry {
+    provider: string;
+    enabled: boolean;
+    config: Record<string, string>;
+}
+export declare function normalizeStorefrontRenderIntegrations(value: unknown): StorefrontRenderIntegrationEntry[];
+export declare function encodeStorefrontRenderIntegrationsHeader(integrations: readonly StorefrontRenderIntegrationEntry[]): string;
+export declare function decodeStorefrontRenderIntegrationsHeader(value: string | null): StorefrontRenderIntegrationEntry[];
+//# sourceMappingURL=storefront-render-integrations.d.ts.map

package/dist/storefront-render-integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-render-integrations.d.ts","sourceRoot":"","sources":["../src/storefront-render-integrations.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qCAAqC,sCAAsC,CAAC;AAIzF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAsBD,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,OAAO,GACb,gCAAgC,EAAE,CA+BpC;AAED,wBAAgB,wCAAwC,CACtD,YAAY,EAAE,SAAS,gCAAgC,EAAE,GACxD,MAAM,CAER;AAED,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,gCAAgC,EAAE,CAOpC"}

package/dist/storefront-render-integrations.js

@@ -0,0 +1,55 @@
+export const STOREFRONT_RENDER_INTEGRATIONS_HEADER = 'X-Shoppex-Storefront-Integrations';
+const MAX_STOREFRONT_RENDER_INTEGRATIONS = 20;
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function readStringConfig(value) {
+    if (!isRecord(value)) {
+        return null;
+    }
+    const config = {};
+    for (const [key, rawValue] of Object.entries(value)) {
+        if (typeof key !== 'string' || typeof rawValue !== 'string') {
+            return null;
+        }
+        config[key] = rawValue;
+    }
+    return config;
+}
+export function normalizeStorefrontRenderIntegrations(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    const integrations = [];
+    const seenProviders = new Set();
+    for (const rawEntry of value) {
+        if (integrations.length >= MAX_STOREFRONT_RENDER_INTEGRATIONS) {
+            break;
+        }
+        if (!isRecord(rawEntry)) {
+            continue;
+        }
+        const provider = rawEntry.provider;
+        const enabled = rawEntry.enabled;
+        const config = readStringConfig(rawEntry.config);
+        if (typeof provider !== 'string' || provider.length === 0 || typeof enabled !== 'boolean' || !config) {
+            continue;
+        }
+        if (seenProviders.has(provider)) {
+            continue;
+        }
+        seenProviders.add(provider);
+        integrations.push({ provider, enabled, config });
+    }
+    return integrations;
+}
+export function encodeStorefrontRenderIntegrationsHeader(integrations) {
+    return encodeURIComponent(JSON.stringify(normalizeStorefrontRenderIntegrations(integrations)));
+}
+export function decodeStorefrontRenderIntegrationsHeader(value) {
+    if (value === null) {
+        throw new Error(`${STOREFRONT_RENDER_INTEGRATIONS_HEADER} is required.`);
+    }
+    const parsed = JSON.parse(decodeURIComponent(value));
+    return normalizeStorefrontRenderIntegrations(parsed);
+}

package/dist/storefront-render-seo.d.ts

@@ -0,0 +1,11 @@
+export declare const STOREFRONT_RENDER_SEO_HEADER = "X-Shoppex-Storefront-Seo";
+export interface StorefrontRenderSeoMetadata {
+    title: string;
+    description: string;
+    ogImage: string;
+    favicon: string;
+}
+export declare function normalizeStorefrontRenderSeoMetadata(value: unknown): StorefrontRenderSeoMetadata | null;
+export declare function encodeStorefrontRenderSeoHeader(metadata: StorefrontRenderSeoMetadata): string;
+export declare function decodeStorefrontRenderSeoHeader(value: string | null): StorefrontRenderSeoMetadata;
+//# sourceMappingURL=storefront-render-seo.d.ts.map

package/dist/storefront-render-seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-render-seo.d.ts","sourceRoot":"","sources":["../src/storefront-render-seo.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AAEvE,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,GAAG,IAAI,CAgBvG;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,2BAA2B,GAAG,MAAM,CAE7F;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,2BAA2B,CAWjG"}

package/dist/storefront-render-seo.js

@@ -0,0 +1,30 @@
+export const STOREFRONT_RENDER_SEO_HEADER = 'X-Shoppex-Storefront-Seo';
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+export function normalizeStorefrontRenderSeoMetadata(value) {
+    if (!isRecord(value)) {
+        return null;
+    }
+    const { title, description, ogImage, favicon } = value;
+    if (typeof title !== 'string'
+        || typeof description !== 'string'
+        || typeof ogImage !== 'string'
+        || typeof favicon !== 'string') {
+        return null;
+    }
+    return { title, description, ogImage, favicon };
+}
+export function encodeStorefrontRenderSeoHeader(metadata) {
+    return encodeURIComponent(JSON.stringify(metadata));
+}
+export function decodeStorefrontRenderSeoHeader(value) {
+    if (value === null) {
+        throw new Error(`${STOREFRONT_RENDER_SEO_HEADER} is required.`);
+    }
+    const metadata = normalizeStorefrontRenderSeoMetadata(JSON.parse(decodeURIComponent(value)));
+    if (!metadata) {
+        throw new Error(`${STOREFRONT_RENDER_SEO_HEADER} is invalid.`);
+    }
+    return metadata;
+}

package/dist/theme-schemes.d.ts

@@ -1,10 +1,15 @@
-export declare const PUBLIC_BUILDER_THEME_SCHEMES: readonly ["default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "vortex", "clean-minimal"];
-export declare const STARTER_BUILDER_THEME_SCHEMES: readonly ["blank"];
-export declare const BUILDER_READY_THEME_SCHEMES: readonly ["blank", "default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "vortex", "clean-minimal"];
+export declare const PUBLIC_BUILDER_THEME_SCHEMES: readonly ["default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "clean-minimal"];
 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 ["classic", "vault", "nebula", "pulse", "phantom", "apex", "clean-minimal"];
+export declare const THEME_STORE_INSTALLABLE_SCHEMES: readonly ["default", "starlight"];
+export declare const BUILDER_READY_THEME_SCHEMES: readonly ["blank", "default", "classic", "nebula", "pulse", "phantom", "starlight", "apex", "vault", "clean-minimal"];
+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];
 export declare function isPublicBuilderThemeScheme(value: string): value is PublicBuilderThemeScheme;
+export declare function isThemeStoreDisabledScheme(value: string): boolean;
+export declare function isThemeStoreInstallableScheme(value: string): value is ThemeStoreInstallableScheme;
 export declare function isStarterBuilderThemeScheme(value: string): value is StarterBuilderThemeScheme;
 export declare function isBuilderReadyThemeScheme(value: string): value is BuilderReadyThemeScheme;
 //# sourceMappingURL=theme-schemes.d.ts.map

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,wHAW/B,CAAC;AAEX,eAAO,MAAM,6BAA6B,oBAAqB,CAAC;AAEhE,eAAO,MAAM,2BAA2B,iIAG9B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AACrF,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,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,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,sFAQe,CAAC;AAIzD,eAAO,MAAM,+BAA+B,mCAGY,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"}

package/dist/theme-schemes.js

@@ -7,10 +7,23 @@ export const PUBLIC_BUILDER_THEME_SCHEMES = [
     'starlight',
     'apex',
     'vault',
-    'vortex',
     'clean-minimal',
 ];
 export const STARTER_BUILDER_THEME_SCHEMES = ['blank'];
+export const THEME_STORE_DISABLED_SCHEMES = [
+    'classic',
+    'vault',
+    'nebula',
+    'pulse',
+    'phantom',
+    'apex',
+    'clean-minimal',
+];
+const THEME_STORE_DISABLED_SCHEME_SET = new Set(THEME_STORE_DISABLED_SCHEMES);
+export const THEME_STORE_INSTALLABLE_SCHEMES = [
+    'default',
+    'starlight',
+];
 export const BUILDER_READY_THEME_SCHEMES = [
     ...STARTER_BUILDER_THEME_SCHEMES,
     ...PUBLIC_BUILDER_THEME_SCHEMES,
@@ -18,6 +31,12 @@ export const BUILDER_READY_THEME_SCHEMES = [
 export function isPublicBuilderThemeScheme(value) {
     return PUBLIC_BUILDER_THEME_SCHEMES.includes(value);
 }
+export function isThemeStoreDisabledScheme(value) {
+    return THEME_STORE_DISABLED_SCHEME_SET.has(value);
+}
+export function isThemeStoreInstallableScheme(value) {
+    return THEME_STORE_INSTALLABLE_SCHEMES.includes(value);
+}
 export function isStarterBuilderThemeScheme(value) {
     return STARTER_BUILDER_THEME_SCHEMES.includes(value);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shoppexio/builder-contracts",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "description": "Shared Builder v2 contracts for Shoppex dashboard, backend, preview runtime, and themes",
   "type": "module",
   "repository": {
@@ -37,6 +37,24 @@
       "import": "./dist/builder-settings.js",
       "default": "./dist/builder-settings.js"
     },
+    "./storefront-render-frame-origins": {
+      "bun": "./src/storefront-render-frame-origins.ts",
+      "types": "./dist/storefront-render-frame-origins.d.ts",
+      "import": "./dist/storefront-render-frame-origins.js",
+      "default": "./dist/storefront-render-frame-origins.js"
+    },
+    "./storefront-render-integrations": {
+      "bun": "./src/storefront-render-integrations.ts",
+      "types": "./dist/storefront-render-integrations.d.ts",
+      "import": "./dist/storefront-render-integrations.js",
+      "default": "./dist/storefront-render-integrations.js"
+    },
+    "./storefront-render-seo": {
+      "bun": "./src/storefront-render-seo.ts",
+      "types": "./dist/storefront-render-seo.d.ts",
+      "import": "./dist/storefront-render-seo.js",
+      "default": "./dist/storefront-render-seo.js"
+    },
     "./events": {
       "bun": "./src/events.ts",
       "types": "./dist/events.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', 'vortex']) {
+    for (const theme of ['default', 'nebula', 'classic', 'pulse', 'starlight', 'vault', 'phantom', 'apex']) {
       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/index.ts

@@ -12,6 +12,8 @@ export * from './preview-protocol.ts';
 export * from './preview-session-resolve.ts';
 export * from './preview-trusted-origins.ts';
 export * from './storefront-initial-data-html.ts';
+export * from './storefront-render-integrations.ts';
+export * from './storefront-render-seo.ts';
 export * from './storefront-typography-fonts.ts';
 export * from './style-slots.ts';
 export * from './theme-manifest.ts';

package/src/preview-protocol.test.ts

@@ -11,7 +11,7 @@ describe('PreviewMessageSchema', () => {
       revision: 12,
       pageId: 'product',
       sourceRevision: 'theme-source-12',
-      renderMode: 'edge-block-engine',
+      renderMode: 'server-liquid',
       blocks: [
         {
           blockId: 'product-form-1',
@@ -26,12 +26,28 @@ describe('PreviewMessageSchema', () => {
     }
   });
 
+  it('accepts v3 block HTML apply messages with no blocks', () => {
+    const parsed = PreviewMessageSchema.parse({
+      type: 'APPLY_BLOCK_HTML',
+      revision: 12,
+      pageId: 'empty',
+      sourceRevision: 'theme-source-12',
+      renderMode: 'server-liquid',
+      blocks: [],
+    });
+
+    expect(parsed.type).toBe('APPLY_BLOCK_HTML');
+    if (parsed.type === 'APPLY_BLOCK_HTML') {
+      expect(parsed.blocks).toEqual([]);
+    }
+  });
+
   it('rejects v3 block HTML apply messages without sourceRevision', () => {
     const result = PreviewMessageSchema.safeParse({
       type: 'APPLY_BLOCK_HTML',
       revision: 12,
       pageId: 'product',
-      renderMode: 'edge-block-engine',
+      renderMode: 'server-liquid',
       blocks: [
         {
           blockId: 'product-form-1',
@@ -43,6 +59,22 @@ describe('PreviewMessageSchema', () => {
     expect(result.success).toBe(false);
   });
 
+  it('accepts v3 full page HTML apply messages', () => {
+    const parsed = PreviewMessageSchema.parse({
+      type: 'APPLY_PAGE_HTML',
+      revision: 13,
+      pageId: 'product',
+      sourceRevision: 'theme-source-13',
+      renderMode: 'server-liquid',
+      html: '<!doctype html><html><body><main data-page-id="product"></main></body></html>',
+    });
+
+    expect(parsed.type).toBe('APPLY_PAGE_HTML');
+    if (parsed.type === 'APPLY_PAGE_HTML') {
+      expect(parsed.html).toContain('data-page-id="product"');
+    }
+  });
+
   it('accepts SET_INTERACTION_MODE with edit/preview', () => {
     for (const mode of ['edit', 'preview'] as const) {
       const parsed = PreviewMessageSchema.parse({
@@ -63,12 +95,12 @@ describe('PreviewMessageSchema', () => {
 });
 
 describe('PreviewResponseSchema', () => {
-  it('accepts READY health for edge block protocol v3', () => {
+  it('accepts READY health for server-liquid protocol v3', () => {
     const parsed = PreviewResponseSchema.parse({
       type: 'READY',
       revision: 12,
       health: {
-        edgeBlockEngine: true,
+        serverLiquidEngine: true,
         blockHtmlReconcile: true,
         protocolVersion: 3,
       },
@@ -86,7 +118,7 @@ describe('PreviewResponseSchema', () => {
       revision: 12,
       pageId: 'product',
       sourceRevision: 'theme-source-12',
-      renderMode: 'edge-block-engine',
+      renderMode: 'server-liquid',
       blocks: [
         {
           blockId: 'footer-1',
@@ -97,7 +129,23 @@ describe('PreviewResponseSchema', () => {
 
     expect(parsed.type).toBe('BLOCK_HTML_APPLIED');
     if (parsed.type === 'BLOCK_HTML_APPLIED') {
-      expect(parsed.renderMode).toBe('edge-block-engine');
+      expect(parsed.renderMode).toBe('server-liquid');
+    }
+  });
+
+  it('accepts v3 block HTML applied responses with no blocks', () => {
+    const parsed = PreviewResponseSchema.parse({
+      type: 'BLOCK_HTML_APPLIED',
+      revision: 12,
+      pageId: 'empty',
+      sourceRevision: 'theme-source-12',
+      renderMode: 'server-liquid',
+      blocks: [],
+    });
+
+    expect(parsed.type).toBe('BLOCK_HTML_APPLIED');
+    if (parsed.type === 'BLOCK_HTML_APPLIED') {
+      expect(parsed.blocks).toEqual([]);
     }
   });
 
@@ -107,7 +155,7 @@ describe('PreviewResponseSchema', () => {
       revision: 12,
       pageId: 'product',
       sourceRevision: 'theme-source-12',
-      renderMode: 'edge-block-engine',
+      renderMode: 'server-liquid',
       blockIds: ['footer-1'],
       error: 'Rendered block root does not match block id.',
     });

package/src/preview-protocol.ts

@@ -24,8 +24,8 @@ export const PreviewApplyStateMessageSchema = z
   })
   .strict();
 
-export const EdgeBlockRenderModeSchema = z.literal('edge-block-engine');
-export type EdgeBlockRenderMode = z.infer<typeof EdgeBlockRenderModeSchema>;
+export const ServerLiquidRenderModeSchema = z.literal('server-liquid');
+export type ServerLiquidRenderMode = z.infer<typeof ServerLiquidRenderModeSchema>;
 
 export const PreviewBlockHtmlPatchSchema = z
   .object({
@@ -41,10 +41,23 @@ export const PreviewApplyBlockHtmlMessageSchema = z
     revision: z.number().int().nonnegative(),
     pageId: z.string().min(1),
     sourceRevision: z.string().min(1),
-    renderMode: EdgeBlockRenderModeSchema,
-    blocks: z.array(PreviewBlockHtmlPatchSchema).min(1),
+    renderMode: ServerLiquidRenderModeSchema,
+    blocks: z.array(PreviewBlockHtmlPatchSchema),
   })
   .strict();
+export type PreviewApplyBlockHtmlMessage = z.infer<typeof PreviewApplyBlockHtmlMessageSchema>;
+
+export const PreviewApplyPageHtmlMessageSchema = z
+  .object({
+    type: z.literal('APPLY_PAGE_HTML'),
+    revision: z.number().int().nonnegative(),
+    pageId: z.string().min(1),
+    sourceRevision: z.string().min(1),
+    renderMode: ServerLiquidRenderModeSchema,
+    html: z.string().min(1),
+  })
+  .strict();
+export type PreviewApplyPageHtmlMessage = z.infer<typeof PreviewApplyPageHtmlMessageSchema>;
 
 export const PreviewReloadMessageSchema = z
   .object({
@@ -87,6 +100,7 @@ export const PreviewSetInteractionModeMessageSchema = z
 export const PreviewMessageSchema = z.discriminatedUnion('type', [
   PreviewApplyStateMessageSchema,
   PreviewApplyBlockHtmlMessageSchema,
+  PreviewApplyPageHtmlMessageSchema,
   PreviewReloadMessageSchema,
   PreviewSelectElementMessageSchema,
   PreviewRequestReadyMessageSchema,
@@ -114,7 +128,7 @@ export const PreviewReadyHealthSchema = z.discriminatedUnion('protocolVersion',
     .strict(),
   z
     .object({
-      edgeBlockEngine: z.literal(true),
+      serverLiquidEngine: z.literal(true),
       blockHtmlReconcile: z.literal(true),
       protocolVersion: z.literal(3),
     })
@@ -151,8 +165,8 @@ export const PreviewBlockHtmlAppliedResponseSchema = z
     revision: z.number().int().nonnegative(),
     pageId: z.string().min(1),
     sourceRevision: z.string().min(1),
-    renderMode: EdgeBlockRenderModeSchema,
-    blocks: z.array(PreviewBlockHtmlPatchSchema).min(1),
+    renderMode: ServerLiquidRenderModeSchema,
+    blocks: z.array(PreviewBlockHtmlPatchSchema),
   })
   .strict();
 
@@ -162,8 +176,8 @@ export const PreviewBlockHtmlFailedResponseSchema = z
     revision: z.number().int().nonnegative(),
     pageId: z.string().min(1),
     sourceRevision: z.string().min(1).optional(),
-    renderMode: EdgeBlockRenderModeSchema,
-    blockIds: z.array(z.string().min(1)).min(1),
+    renderMode: ServerLiquidRenderModeSchema,
+    blockIds: z.array(z.string().min(1)),
     error: z.string().min(1),
   })
   .strict();

package/src/storefront-render-frame-origins.ts

@@ -0,0 +1,26 @@
+/**
+ * SSOT for iframe embed origins allowed in the Storefront Render Service CSP (frame-src)
+ * and for custom-embed postMessage trust in storefront-commerce (when registered).
+ */
+export const STOREFRONT_RENDER_YOUTUBE_FRAME_ORIGINS = [
+  'https://www.youtube.com',
+  'https://www.youtube-nocookie.com',
+] as const;
+
+/** Trusted origins for custom-embed resize postMessage (storefront-commerce). */
+export const STOREFRONT_RENDER_CUSTOM_EMBED_TRUSTED_ORIGINS = [
+  'https://calendly.com',
+  'https://substack.com',
+  'https://shoppex.io',
+] as const;
+
+/** frame-src entries for custom embed blocks (includes Substack wildcard). */
+export const STOREFRONT_RENDER_CUSTOM_EMBED_FRAME_SRC_ORIGINS = [
+  ...STOREFRONT_RENDER_CUSTOM_EMBED_TRUSTED_ORIGINS,
+  'https://*.substack.com',
+] as const;
+
+export const STOREFRONT_RENDER_ALLOWED_FRAME_ORIGINS = [
+  ...STOREFRONT_RENDER_YOUTUBE_FRAME_ORIGINS,
+  ...STOREFRONT_RENDER_CUSTOM_EMBED_FRAME_SRC_ORIGINS,
+] as const;

package/src/storefront-render-integrations.test.ts

@@ -0,0 +1,62 @@
+import { describe, expect, test } from 'bun:test';
+import {
+  decodeStorefrontRenderIntegrationsHeader,
+  encodeStorefrontRenderIntegrationsHeader,
+  normalizeStorefrontRenderIntegrations,
+  STOREFRONT_RENDER_INTEGRATIONS_HEADER,
+} from './storefront-render-integrations.ts';
+
+describe('storefront render integrations contract', () => {
+  test('round-trips integration metadata through an ASCII header value', () => {
+    const encoded = encodeStorefrontRenderIntegrationsHeader([
+      {
+        provider: 'google_tag_manager',
+        enabled: true,
+        config: { container_id: 'GTM-ABC123' },
+      },
+    ]);
+
+    expect(encoded).toBe(
+      '%5B%7B%22provider%22%3A%22google_tag_manager%22%2C%22enabled%22%3Atrue%2C%22config%22%3A%7B%22container_id%22%3A%22GTM-ABC123%22%7D%7D%5D',
+    );
+    expect(decodeStorefrontRenderIntegrationsHeader(encoded)).toEqual([
+      {
+        provider: 'google_tag_manager',
+        enabled: true,
+        config: { container_id: 'GTM-ABC123' },
+      },
+    ]);
+  });
+
+  test('normalizes malformed entries without throwing', () => {
+    expect(normalizeStorefrontRenderIntegrations([
+      {
+        provider: 'crisp',
+        enabled: true,
+        config: { website_id: 'crisp_123' },
+      },
+      {
+        provider: 'crisp',
+        enabled: true,
+        config: { website_id: 'duplicate' },
+      },
+      {
+        provider: 'broken',
+        enabled: true,
+        config: { id: 123 },
+      },
+    ])).toEqual([
+      {
+        provider: 'crisp',
+        enabled: true,
+        config: { website_id: 'crisp_123' },
+      },
+    ]);
+  });
+
+  test('fails when the required render header is missing', () => {
+    expect(() => decodeStorefrontRenderIntegrationsHeader(null)).toThrow(
+      `${STOREFRONT_RENDER_INTEGRATIONS_HEADER} is required.`,
+    );
+  });
+});

package/src/storefront-render-integrations.ts

@@ -0,0 +1,81 @@
+export const STOREFRONT_RENDER_INTEGRATIONS_HEADER = 'X-Shoppex-Storefront-Integrations';
+
+const MAX_STOREFRONT_RENDER_INTEGRATIONS = 20;
+
+export interface StorefrontRenderIntegrationEntry {
+  provider: string;
+  enabled: boolean;
+  config: Record<string, string>;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function readStringConfig(value: unknown): Record<string, string> | null {
+  if (!isRecord(value)) {
+    return null;
+  }
+
+  const config: Record<string, string> = {};
+  for (const [key, rawValue] of Object.entries(value)) {
+    if (typeof key !== 'string' || typeof rawValue !== 'string') {
+      return null;
+    }
+    config[key] = rawValue;
+  }
+
+  return config;
+}
+
+export function normalizeStorefrontRenderIntegrations(
+  value: unknown,
+): StorefrontRenderIntegrationEntry[] {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+
+  const integrations: StorefrontRenderIntegrationEntry[] = [];
+  const seenProviders = new Set<string>();
+
+  for (const rawEntry of value) {
+    if (integrations.length >= MAX_STOREFRONT_RENDER_INTEGRATIONS) {
+      break;
+    }
+    if (!isRecord(rawEntry)) {
+      continue;
+    }
+
+    const provider = rawEntry.provider;
+    const enabled = rawEntry.enabled;
+    const config = readStringConfig(rawEntry.config);
+    if (typeof provider !== 'string' || provider.length === 0 || typeof enabled !== 'boolean' || !config) {
+      continue;
+    }
+    if (seenProviders.has(provider)) {
+      continue;
+    }
+
+    seenProviders.add(provider);
+    integrations.push({ provider, enabled, config });
+  }
+
+  return integrations;
+}
+
+export function encodeStorefrontRenderIntegrationsHeader(
+  integrations: readonly StorefrontRenderIntegrationEntry[],
+): string {
+  return encodeURIComponent(JSON.stringify(normalizeStorefrontRenderIntegrations(integrations)));
+}
+
+export function decodeStorefrontRenderIntegrationsHeader(
+  value: string | null,
+): StorefrontRenderIntegrationEntry[] {
+  if (value === null) {
+    throw new Error(`${STOREFRONT_RENDER_INTEGRATIONS_HEADER} is required.`);
+  }
+
+  const parsed = JSON.parse(decodeURIComponent(value)) as unknown;
+  return normalizeStorefrontRenderIntegrations(parsed);
+}

package/src/storefront-render-seo.test.ts

@@ -0,0 +1,33 @@
+import { describe, expect, test } from 'bun:test';
+import {
+  decodeStorefrontRenderSeoHeader,
+  encodeStorefrontRenderSeoHeader,
+  STOREFRONT_RENDER_SEO_HEADER,
+} from './storefront-render-seo.ts';
+
+describe('storefront render SEO contract', () => {
+  test('round-trips SEO metadata through an ASCII header value', () => {
+    const encoded = encodeStorefrontRenderSeoHeader({
+      title: 'Demo Shop',
+      description: 'Premium digital products',
+      ogImage: 'https://cdn.example.com/og.png',
+      favicon: 'https://cdn.example.com/favicon.png',
+    });
+
+    expect(decodeStorefrontRenderSeoHeader(encoded)).toEqual({
+      title: 'Demo Shop',
+      description: 'Premium digital products',
+      ogImage: 'https://cdn.example.com/og.png',
+      favicon: 'https://cdn.example.com/favicon.png',
+    });
+  });
+
+  test('fails when the required SEO header is missing or malformed', () => {
+    expect(() => decodeStorefrontRenderSeoHeader(null)).toThrow(
+      `${STOREFRONT_RENDER_SEO_HEADER} is required.`,
+    );
+    expect(() => decodeStorefrontRenderSeoHeader(encodeURIComponent('{"title":"Missing fields"}'))).toThrow(
+      `${STOREFRONT_RENDER_SEO_HEADER} is invalid.`,
+    );
+  });
+});

package/src/storefront-render-seo.ts

@@ -0,0 +1,47 @@
+export const STOREFRONT_RENDER_SEO_HEADER = 'X-Shoppex-Storefront-Seo';
+
+export interface StorefrontRenderSeoMetadata {
+  title: string;
+  description: string;
+  ogImage: string;
+  favicon: string;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+export function normalizeStorefrontRenderSeoMetadata(value: unknown): StorefrontRenderSeoMetadata | null {
+  if (!isRecord(value)) {
+    return null;
+  }
+
+  const { title, description, ogImage, favicon } = value;
+  if (
+    typeof title !== 'string'
+    || typeof description !== 'string'
+    || typeof ogImage !== 'string'
+    || typeof favicon !== 'string'
+  ) {
+    return null;
+  }
+
+  return { title, description, ogImage, favicon };
+}
+
+export function encodeStorefrontRenderSeoHeader(metadata: StorefrontRenderSeoMetadata): string {
+  return encodeURIComponent(JSON.stringify(metadata));
+}
+
+export function decodeStorefrontRenderSeoHeader(value: string | null): StorefrontRenderSeoMetadata {
+  if (value === null) {
+    throw new Error(`${STOREFRONT_RENDER_SEO_HEADER} is required.`);
+  }
+
+  const metadata = normalizeStorefrontRenderSeoMetadata(JSON.parse(decodeURIComponent(value)) as unknown);
+  if (!metadata) {
+    throw new Error(`${STOREFRONT_RENDER_SEO_HEADER} is invalid.`);
+  }
+
+  return metadata;
+}

package/src/theme-schemes.ts

@@ -7,18 +7,36 @@ export const PUBLIC_BUILDER_THEME_SCHEMES = [
   'starlight',
   'apex',
   'vault',
-  'vortex',
   'clean-minimal',
 ] as const;
 
+export type PublicBuilderThemeScheme = (typeof PUBLIC_BUILDER_THEME_SCHEMES)[number];
+
 export const STARTER_BUILDER_THEME_SCHEMES = ['blank'] as const;
 
+export const THEME_STORE_DISABLED_SCHEMES = [
+  'classic',
+  'vault',
+  'nebula',
+  'pulse',
+  'phantom',
+  'apex',
+  'clean-minimal',
+] as const satisfies readonly PublicBuilderThemeScheme[];
+
+const THEME_STORE_DISABLED_SCHEME_SET = new Set<string>(THEME_STORE_DISABLED_SCHEMES);
+
+export const THEME_STORE_INSTALLABLE_SCHEMES = [
+  'default',
+  'starlight',
+] as const satisfies readonly PublicBuilderThemeScheme[];
+
 export const BUILDER_READY_THEME_SCHEMES = [
   ...STARTER_BUILDER_THEME_SCHEMES,
   ...PUBLIC_BUILDER_THEME_SCHEMES,
 ] as const;
 
-export type PublicBuilderThemeScheme = (typeof PUBLIC_BUILDER_THEME_SCHEMES)[number];
+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];
 
@@ -26,6 +44,16 @@ export function isPublicBuilderThemeScheme(value: string): value is PublicBuilde
   return (PUBLIC_BUILDER_THEME_SCHEMES as readonly string[]).includes(value);
 }
 
+export function isThemeStoreDisabledScheme(value: string): boolean {
+  return THEME_STORE_DISABLED_SCHEME_SET.has(value);
+}
+
+export function isThemeStoreInstallableScheme(
+  value: string,
+): value is ThemeStoreInstallableScheme {
+  return (THEME_STORE_INSTALLABLE_SCHEMES as readonly string[]).includes(value);
+}
+
 export function isStarterBuilderThemeScheme(value: string): value is StarterBuilderThemeScheme {
   return (STARTER_BUILDER_THEME_SCHEMES as readonly string[]).includes(value);
 }