@weaverse/hydrogen 5.9.0 → 5.9.2

package/dist/index.js

@@ -8,18 +8,7 @@ var reactRouter = require('react-router');
 var react$1 = require('react');
 var reactErrorBoundary = require('react-error-boundary');
 
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-// src/components/main.tsx
-var main_exports = {};
-__export(main_exports, {
-  default: () => main_default,
-  schema: () => schema
-});
+// src/index.ts
 function Main(props) {
   let { children, dangerouslySetInnerHTML, ...rest } = props;
   return /* @__PURE__ */ jsxRuntime.jsx(
@@ -38,7 +27,12 @@ var schema = schema$1.createSchema({
 });
 
 // src/components/index.ts
-var defaultComponents = [main_exports];
+var defaultComponents = [
+  {
+    default: main_default,
+    schema
+  }
+];
 function createFlatDataContext(matches) {
   const context = {};
   for (const match of matches) {
@@ -92,6 +86,9 @@ function isThemeSettingsResponse(data) {
 function isValidHydrogenSchema(schema2) {
   return schema$1.isValidSchema(schema2);
 }
+function hasWeaverseStudio(window2) {
+  return "weaverseStudio" in window2 && typeof window2.weaverseStudio === "object";
+}
 
 // src/utils/index.ts
 var warnedTypes = /* @__PURE__ */ new Set();
@@ -153,6 +150,8 @@ function getWeaverseConfigs(request, env) {
     weaverseVersion,
     weaverseApiKey
   } = queries;
+  let url = new URL(request.url);
+  let isRevisionPreview = url.searchParams.has("__revisionId");
   return {
     projectId: weaverseProjectId || WEAVERSE_PROJECT_ID || envFromProcess.WEAVERSE_PROJECT_ID || "",
     weaverseHost: weaverseHost || WEAVERSE_HOST || envFromProcess.WEAVERSE_HOST || "https://studio.weaverse.io",
@@ -161,6 +160,7 @@ function getWeaverseConfigs(request, env) {
     weaverseVersion: weaverseVersion || "",
     isDesignMode,
     isPreviewMode,
+    isRevisionPreview,
     sectionType: sectionType || "",
     publicEnv: {
       PUBLIC_STORE_DOMAIN: PUBLIC_STORE_DOMAIN || "",
@@ -292,13 +292,15 @@ function getPreviewData(type, components, weaverseHost) {
     }
   };
 }
-var ThemeSettingsStore = class extends react.EventEmitter {
+var ThemeSettingsStore = class {
   settings = {};
   schema;
   publicEnv;
+  listeners = /* @__PURE__ */ new Set();
+  MAX_LISTENERS = 100;
+  isDestroyed = false;
   constructor(data) {
-    super();
-    let { theme, schema: schema2, publicEnv } = data || {};
+    const { theme, schema: schema2, publicEnv } = data || {};
     this.settings = { ...theme };
     this.schema = schema2;
     this.publicEnv = publicEnv;
@@ -307,17 +309,63 @@ var ThemeSettingsStore = class extends react.EventEmitter {
     }
   }
   updateThemeSettings = (newSettings) => {
+    if (this.isDestroyed) {
+      console.warn("ThemeSettingsStore: Cannot update destroyed store");
+      return;
+    }
     this.settings = {
       ...this.settings,
       ...newSettings
     };
-    this.emit(this.settings);
+    this.emit();
   };
   getSnapshot = () => this.settings;
   getServerSnapshot = () => this.settings;
+  subscribe = (callback) => {
+    if (this.isDestroyed) {
+      console.warn("ThemeSettingsStore: Cannot subscribe to destroyed store");
+      return () => {
+      };
+    }
+    if (this.listeners.size >= this.MAX_LISTENERS) {
+      console.warn(
+        `ThemeSettingsStore: Maximum listeners (${this.MAX_LISTENERS}) exceeded. Possible memory leak detected.`
+      );
+      return () => {
+      };
+    }
+    this.listeners.add(callback);
+    return () => {
+      this.listeners.delete(callback);
+    };
+  };
+  emit = () => {
+    if (this.isDestroyed) {
+      return;
+    }
+    const currentListeners = Array.from(this.listeners);
+    for (const listener of currentListeners) {
+      try {
+        listener();
+      } catch (error) {
+        console.error("ThemeSettingsStore: Listener error", error);
+      }
+    }
+  };
+  // Method to properly clean up the store
+  destroy = () => {
+    if (this.isDestroyed) {
+      return;
+    }
+    this.listeners.clear();
+    this.isDestroyed = true;
+    if (react.isBrowser && window.__weaverseThemeSettingsStore === this) {
+      window.__weaverseThemeSettingsStore = void 0;
+    }
+  };
 };
 function useThemeSettingsStore() {
-  let data = reactRouter.useRouteLoaderData("root");
+  const data = reactRouter.useRouteLoaderData("root");
   if (react.isBrowser && window.__weaverseThemeSettingsStore) {
     return window.__weaverseThemeSettingsStore;
   }
@@ -331,10 +379,16 @@ function useStudio(weaverse) {
   let { pathname, search } = reactRouter.useLocation();
   let navigate = reactRouter.useNavigate();
   let themeSettingsStore = useThemeSettingsStore();
-  let { isDesignMode, weaverseHost, weaverseVersion, isPreviewMode } = weaverse;
+  let {
+    isDesignMode,
+    weaverseHost,
+    weaverseVersion,
+    isPreviewMode,
+    isRevisionPreview
+  } = weaverse;
   react$1.useEffect(() => {
     if (navigation.state === "idle") {
-      if (isPreviewMode) {
+      if (isRevisionPreview || isPreviewMode) {
         let previewSrc = `${weaverseHost}/static/studio/hydrogen/preview.js?v=${weaverseVersion}`;
         react.loadScript(previewSrc).catch(console.error);
       } else if (isDesignMode) {
@@ -346,7 +400,9 @@ function useStudio(weaverse) {
         };
         let studioSrc = `${weaverseHost}/static/studio/hydrogen/index.js?v=${weaverseVersion}`;
         react.loadScript(studioSrc).then(() => {
-          window.weaverseStudio?.init(weaverse);
+          if (hasWeaverseStudio(window)) {
+            window.weaverseStudio.init(weaverse);
+          }
         }).catch(console.error);
       }
     }
@@ -391,6 +447,7 @@ var WeaverseHydrogen = class extends react.Weaverse {
   weaverseVersion;
   isDesignMode;
   isPreviewMode;
+  isRevisionPreview;
   sectionType;
   static itemInstances;
   static elementRegistry;
@@ -407,6 +464,7 @@ var WeaverseHydrogen = class extends react.Weaverse {
     this.weaverseVersion = params.weaverseVersion || "";
     this.isDesignMode = params.isDesignMode ?? false;
     this.isPreviewMode = params.isPreviewMode ?? false;
+    this.isRevisionPreview = params.isRevisionPreview ?? false;
     this.sectionType = params.sectionType || "";
   }
 };
@@ -420,7 +478,9 @@ function createWeaverseInstance(params) {
     }
     if (weaverse?.isDesignMode) {
       weaverse.requestInfo = params.requestInfo;
-      window.weaverseStudio?.refreshStudio(params);
+      if (hasWeaverseStudio(window)) {
+        window.weaverseStudio.refreshStudio(params);
+      }
     }
     return weaverse;
   }
@@ -459,7 +519,7 @@ function registerComponent(element) {
 var WeaverseHydrogenRoot = react$1.memo(
   ({
     components,
-    errorComponent: ErrorComponent = ({ error }) => /* @__PURE__ */ jsxRuntime.jsx("div", { children: error?.message || "An unexpected error occurred" })
+    errorComponent: ErrorComponent = ({ error }) => /* @__PURE__ */ jsxRuntime.jsx("div", { children: error instanceof Error ? error.message : "An unexpected error occurred" })
   }) => {
     const matches = reactRouter.useMatches();
     const enhancedDataContext = createWeaverseDataContext(matches);
@@ -614,7 +674,9 @@ var WeaverseClient = class {
       weaverseApiBase: this.configs.weaverseApiBase,
       weaverseApiKey: this.configs.weaverseApiKey,
       weaverseVersion: this.configs.weaverseVersion,
-      isDesignMode: this.configs.isDesignMode
+      isDesignMode: this.configs.isDesignMode,
+      isPreviewMode: this.configs.isPreviewMode,
+      isRevisionPreview: this.configs.isRevisionPreview
     };
     this.basePageRequestBody = {
       isDesignMode: this.configs.isDesignMode,
@@ -856,6 +918,23 @@ var WeaverseClient = class {
     }
     return `${weaverseHost}/api/public/${endpoint}`;
   }
+  /**
+   * Fetch data with caching support for both design mode and production.
+   * Uses direct fetch in design mode, Hydrogen's withCache in production.
+   * Automatically includes projectId in cache key for multi-project isolation.
+   *
+   * @param url - The URL to fetch from
+   * @param options - Fetch options including optional cache strategy
+   * @returns Promise resolving to the fetched data
+   *
+   * @example
+   * ```typescript
+   * const data = await weaverse.fetchWithCache<MyData>(
+   *   'https://api.example.com/data',
+   *   { method: 'POST', body: JSON.stringify({ key: 'value' }) }
+   * )
+   * ```
+   */
   fetchWithCache = async (url, options = {}) => {
     const strategy = options.strategy || hydrogen.CacheCustom(DEFAULT_CACHE_STRATEGY);
     const cacheKey = [
@@ -880,6 +959,19 @@ var WeaverseClient = class {
     }
     return result.data;
   };
+  /**
+   * Load theme settings from Weaverse API with fallback to schema defaults.
+   * Merges remote settings with local theme schema and handles design mode serialization.
+   *
+   * @param strategy - Optional cache strategy override
+   * @returns Promise resolving to theme settings response
+   *
+   * @example
+   * ```typescript
+   * const settings = await weaverse.loadThemeSettings()
+   * const primaryColor = settings.theme.colors?.primary
+   * ```
+   */
   loadThemeSettings = async (strategy) => {
     const defaultThemeSettings = generateDataFromSchema(this.themeSchema);
     try {
@@ -955,6 +1047,13 @@ var WeaverseClient = class {
       };
     }
   };
+  /**
+   * Generate fallback page with default structure when page data is unavailable.
+   * Used internally when API returns no page or when page needs default content.
+   *
+   * @param message - Custom message to display in the fallback page
+   * @returns HydrogenPageData with single main component containing the message
+   */
   generateFallbackPage = (message) => {
     const rootId = crypto.randomUUID();
     return {
@@ -970,6 +1069,34 @@ var WeaverseClient = class {
       ]
     };
   };
+  /**
+   * Load page data from Weaverse API with optional route-level project override.
+   * Fetches page content, executes component loaders, and handles empty items fallback.
+   *
+   * @param params - Optional page loading parameters
+   * @param params.type - Page type (HOME, PAGE, PRODUCT, COLLECTION, etc.)
+   * @param params.handle - Page handle for dynamic routes
+   * @param params.locale - Locale override
+   * @param params.projectId - Route-level project ID override (for multi-project)
+   * @param params.strategy - Custom cache strategy override
+   * @returns Promise resolving to page data or null on error
+   *
+   * @example
+   * ```typescript
+   * // Basic usage
+   * const data = await weaverse.loadPage()
+   *
+   * // With page type
+   * const data = await weaverse.loadPage({ type: 'HOME' })
+   *
+   * // Route-level project override
+   * const data = await weaverse.loadPage({
+   *   type: 'PAGE',
+   *   handle: 'about',
+   *   projectId: 'campaign-project-123'
+   * })
+   * ```
+   */
   loadPage = async (params = {}) => {
     try {
       const { request, storefront, basePageRequestBody, basePageConfigs } = this;
@@ -1054,6 +1181,13 @@ var WeaverseClient = class {
       if (!page) {
         page = this.generateFallbackPage("Please add new section to start.");
       }
+      if (page?.items?.length === 0) {
+        page.items.push({
+          type: "main",
+          id: page.rootId || crypto.randomUUID(),
+          data: {}
+        });
+      }
       if (page?.items) {
         const items = page.items;
         page.items = await Promise.all(items.map(this.execComponentLoader));
@@ -1201,6 +1335,7 @@ exports.getRequestQueries = getRequestQueries;
 exports.getSelectedProductOptions = getSelectedProductOptions;
 exports.getWeaverseConfigs = getWeaverseConfigs;
 exports.hasError = hasError;
+exports.hasWeaverseStudio = hasWeaverseStudio;
 exports.isFetchProjectPayload = isFetchProjectPayload;
 exports.isProjectIdFunction = isProjectIdFunction;
 exports.isThemeSettingsResponse = isThemeSettingsResponse;