@deneb-ui/ui 2.0.38 → 2.0.39

package/dist/SiteDataProvider.d.ts

@@ -1,4 +1,6 @@
 import React, { type ReactNode } from 'react';
+import type { ProductItem } from './EditableProductCard';
+import type { ServiceItem } from './EditableServiceCard';
 export declare const DENEB_PREVIEW_DATA_MESSAGE = "DENEB_PREVIEW_SITE_DATA";
 export declare const PREVIEW_DATA_MESSAGE = "FIVORA_PREVIEW_SITE_DATA";
 export declare const LEGACY_PREVIEW_DATA_MESSAGE: string;
@@ -11,10 +13,34 @@ export declare const LEGACY_PREVIEW_FOCUS_MESSAGE: string;
 export declare const PREVIEW_FIELD_ATTRIBUTE = "data-preview-field-path";
 export { STYLE_PATCH_MESSAGE, DENEB_STYLE_PATCH_MESSAGE } from '@deneb-ui/core';
 export type GenericRecord = Record<string, any>;
+export interface SiteDataApiConfig {
+    baseUrl?: string | null;
+    catalogUrl?: string | null;
+    contactUrl?: string | null;
+    analyticsUrl?: string | null;
+    [key: string]: unknown;
+}
+export interface SiteDataProject {
+    id?: string | null;
+    slug?: string | null;
+    title?: string | null;
+    status?: string | null;
+    [key: string]: unknown;
+}
+export interface SiteInstanceData {
+    id?: string | null;
+    slug?: string | null;
+    domain?: string | null;
+    subdomain?: string | null;
+    customDomain?: string | null;
+    liveUrl?: string | null;
+    [key: string]: unknown;
+}
 export type SiteData = {
-    project?: {
-        id?: string | null;
-    } | null;
+    project?: SiteDataProject | null;
+    siteInstance?: SiteInstanceData | null;
+    api?: SiteDataApiConfig | null;
+    shop?: GenericRecord | null;
     merchant?: GenericRecord | null;
     template?: {
         structure?: {
@@ -26,6 +52,8 @@ export type SiteData = {
         requiredPages?: string[] | null;
     } | null;
     content?: GenericRecord | null;
+    media?: Record<string, string[]> | null;
+    seo?: GenericRecord | null;
     styles?: GenericRecord | null;
     [key: string]: unknown;
 };
@@ -44,8 +72,17 @@ export interface SiteDataProviderProps<T = SiteData> {
     children: ReactNode;
     initialSiteData?: T;
     fallbackSiteData?: T;
+    /**
+     * Optional custom live catalog endpoint.
+     * If omitted, defaults to `/api/site-catalog/${slug}/live-data`.
+     */
+    liveCatalogEndpoint?: string;
+    /**
+     * Optional site slug for live rehydration. If omitted, resolved from initialSiteData.
+     */
+    siteSlug?: string;
 }
-export declare function SiteDataProvider<T extends SiteData = SiteData>({ children, initialSiteData, fallbackSiteData, }: SiteDataProviderProps<T>): React.JSX.Element;
+export declare function SiteDataProvider<T extends SiteData = SiteData>({ children, initialSiteData, fallbackSiteData, liveCatalogEndpoint, siteSlug, }: SiteDataProviderProps<T>): React.JSX.Element;
 export declare function useSiteData<T = SiteData>(): T;
 export declare function contentObject(value: unknown): GenericRecord;
 export declare function contentText(value: unknown): string;
@@ -62,3 +99,27 @@ export declare const DenebDataProvider: typeof SiteDataProvider;
 export declare const useDenebData: typeof useSiteData;
 export declare const DenebDataContext: React.Context<SiteData>;
 export type DenebData = SiteData;
+/**
+ * Hook to retrieve products cleanly from SiteData, supporting both
+ * top-level content.products and nested content.home.products.
+ */
+export declare function useProducts(fallback?: ProductItem[]): ProductItem[];
+/**
+ * Hook to retrieve services cleanly from SiteData, supporting both
+ * top-level content.services and nested content.home.services.
+ */
+export declare function useServices(fallback?: ServiceItem[]): ServiceItem[];
+/**
+ * Hook to access official Fivora backend API endpoints (catalogUrl, contactUrl, analyticsUrl).
+ */
+export declare function useSiteApi(): SiteDataApiConfig | null;
+/**
+ * Hook to access full catalog metadata and live status.
+ */
+export declare function useSiteCatalog(): {
+    products: ProductItem[];
+    services: ServiceItem[];
+    project: SiteDataProject | null;
+    siteInstance: SiteInstanceData | null;
+    api: SiteDataApiConfig | null;
+};

package/dist/SiteDataProvider.js

@@ -16,6 +16,10 @@ exports.contentNumber = contentNumber;
 exports.parseFieldPath = parseFieldPath;
 exports.getFieldStyle = getFieldStyle;
 exports.useFieldStyle = useFieldStyle;
+exports.useProducts = useProducts;
+exports.useServices = useServices;
+exports.useSiteApi = useSiteApi;
+exports.useSiteCatalog = useSiteCatalog;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const core_1 = require("@deneb-ui/core");
@@ -167,13 +171,92 @@ function readCachedSiteData() {
         return null;
     }
 }
-function SiteDataProvider({ children, initialSiteData, fallbackSiteData, }) {
+function SiteDataProvider({ children, initialSiteData, fallbackSiteData, liveCatalogEndpoint, siteSlug, }) {
     // SSR HTML and the first client paint must match. Reading sessionStorage here
     // causes React hydration error #418 when a previous preview left merchant
     // content in the cache. Cache is applied after mount in useEffect instead.
     const [siteData, setSiteData] = (0, react_1.useState)(() => {
         return (initialSiteData ?? fallbackSiteData ?? {});
     });
+    // Real-time catalog & theme hydration for standalone live sites
+    (0, react_1.useEffect)(() => {
+        if (typeof window === "undefined" || window.parent !== window)
+            return;
+        const candidateSlug = siteSlug ||
+            initialSiteData?.siteInstance?.slug ||
+            initialSiteData?.project?.slug ||
+            initialSiteData?.project?.id;
+        const endpoint = liveCatalogEndpoint ||
+            initialSiteData?.api?.catalogUrl ||
+            (candidateSlug && initialSiteData?.api?.baseUrl
+                ? `${initialSiteData.api.baseUrl.replace(/\/+$/, '')}/site-catalog/${candidateSlug}/live-data`
+                : candidateSlug
+                    ? `/site-catalog/${candidateSlug}/live-data`
+                    : null);
+        if (!endpoint)
+            return;
+        const controller = new AbortController();
+        fetch(endpoint, {
+            signal: controller.signal,
+            headers: { Accept: "application/json" },
+        })
+            .then((res) => (res.ok ? res.json() : null))
+            .then((live) => {
+            if (!live || !isRecord(live))
+                return;
+            setSiteData((current) => {
+                const currentContent = isRecord(current.content) ? current.content : {};
+                const currentHome = isRecord(currentContent.home) ? currentContent.home : null;
+                const nextProducts = Array.isArray(live.products)
+                    ? live.products
+                    : currentContent.products;
+                const nextServices = Array.isArray(live.services)
+                    ? live.services
+                    : currentContent.services;
+                return {
+                    ...current,
+                    content: {
+                        ...currentContent,
+                        ...(nextProducts !== undefined ? { products: nextProducts } : {}),
+                        ...(nextServices !== undefined ? { services: nextServices } : {}),
+                        ...(currentHome
+                            ? {
+                                home: {
+                                    ...currentHome,
+                                    ...(nextProducts !== undefined && 'products' in currentHome
+                                        ? { products: nextProducts }
+                                        : {}),
+                                    ...(nextServices !== undefined && 'services' in currentHome
+                                        ? { services: nextServices }
+                                        : {}),
+                                    ...(nextProducts !== undefined && 'featuredProducts' in currentHome
+                                        ? { featuredProducts: nextProducts }
+                                        : {}),
+                                },
+                            }
+                            : {}),
+                    },
+                };
+            });
+            // Dynamic theme variable injection for instant color updates
+            if (isRecord(live.theme)) {
+                const rootStyle = document.documentElement.style;
+                if (typeof live.theme.primaryColor === "string") {
+                    rootStyle.setProperty("--brand-primary", live.theme.primaryColor);
+                }
+                if (typeof live.theme.secondaryColor === "string") {
+                    rootStyle.setProperty("--brand-secondary", live.theme.secondaryColor);
+                }
+                if (typeof live.theme.accentColor === "string") {
+                    rootStyle.setProperty("--brand-accent", live.theme.accentColor);
+                }
+            }
+        })
+            .catch(() => {
+            // Gracefully keep pre-rendered static fallback if live API is unreachable
+        });
+        return () => controller.abort();
+    }, [liveCatalogEndpoint, siteSlug, initialSiteData]);
     (0, react_1.useEffect)(() => {
         let parentOrigin = resolveParentOrigin();
         const applyIncomingSiteData = (incoming) => {
@@ -342,3 +425,71 @@ function useFieldStyle(path) {
 exports.DenebDataProvider = SiteDataProvider;
 exports.useDenebData = useSiteData;
 exports.DenebDataContext = exports.SiteDataContext;
+/**
+ * Hook to retrieve products cleanly from SiteData, supporting both
+ * top-level content.products and nested content.home.products.
+ */
+function useProducts(fallback = []) {
+    const siteData = useSiteData();
+    const content = isRecord(siteData?.content) ? siteData.content : null;
+    if (!content)
+        return fallback;
+    if (Array.isArray(content.products) && content.products.length > 0) {
+        return content.products;
+    }
+    const home = isRecord(content.home) ? content.home : null;
+    if (home) {
+        if (Array.isArray(home.products) && home.products.length > 0) {
+            return home.products;
+        }
+        if (Array.isArray(home.featuredProducts) && home.featuredProducts.length > 0) {
+            return home.featuredProducts;
+        }
+    }
+    return fallback;
+}
+/**
+ * Hook to retrieve services cleanly from SiteData, supporting both
+ * top-level content.services and nested content.home.services.
+ */
+function useServices(fallback = []) {
+    const siteData = useSiteData();
+    const content = isRecord(siteData?.content) ? siteData.content : null;
+    if (!content)
+        return fallback;
+    if (Array.isArray(content.services) && content.services.length > 0) {
+        return content.services;
+    }
+    const home = isRecord(content.home) ? content.home : null;
+    if (home) {
+        if (Array.isArray(home.services) && home.services.length > 0) {
+            return home.services;
+        }
+        if (Array.isArray(home.featuredServices) && home.featuredServices.length > 0) {
+            return home.featuredServices;
+        }
+    }
+    return fallback;
+}
+/**
+ * Hook to access official Fivora backend API endpoints (catalogUrl, contactUrl, analyticsUrl).
+ */
+function useSiteApi() {
+    const siteData = useSiteData();
+    return siteData?.api ?? null;
+}
+/**
+ * Hook to access full catalog metadata and live status.
+ */
+function useSiteCatalog() {
+    const products = useProducts();
+    const services = useServices();
+    const siteData = useSiteData();
+    return {
+        products,
+        services,
+        project: siteData?.project ?? null,
+        siteInstance: siteData?.siteInstance ?? null,
+        api: siteData?.api ?? null,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deneb-ui/ui",
-  "version": "2.0.38",
+  "version": "2.0.39",
   "description": "Visual-first React component library for editable commerce storefronts. Built for Next.js and Fivora.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -49,7 +49,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deneb-ui/core": "^2.0.38"
+    "@deneb-ui/core": "^2.0.39"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",