@weaverse/hydrogen 5.14.1 → 5.15.0

package/dist/index.d.mts

@@ -293,6 +293,7 @@ declare function withWeaverse(Component: ComponentType<any>, options?: WithWeave
  */
 declare function useThemeSettings<T = HydrogenThemeSettings>(): T;
 
+type BuilderApiCacheTarget = 'custom-pages' | 'merchant-overrides' | 'project' | 'theme-settings';
 declare class WeaverseClient {
     API: "v1";
     basePageConfigs: Omit<WeaverseProjectConfigs, 'requestInfo'>;
@@ -413,6 +414,7 @@ declare class WeaverseClient {
      * ```
      */
     fetchWithCache: <T = unknown>(url: string, options?: RequestInit & {
+        cacheTarget?: BuilderApiCacheTarget;
         strategy?: CachingStrategy;
     }) => Promise<T>;
     /**

package/dist/index.d.ts

@@ -293,6 +293,7 @@ declare function withWeaverse(Component: ComponentType<any>, options?: WithWeave
  */
 declare function useThemeSettings<T = HydrogenThemeSettings>(): T;
 
+type BuilderApiCacheTarget = 'custom-pages' | 'merchant-overrides' | 'project' | 'theme-settings';
 declare class WeaverseClient {
     API: "v1";
     basePageConfigs: Omit<WeaverseProjectConfigs, 'requestInfo'>;
@@ -413,6 +414,7 @@ declare class WeaverseClient {
      * ```
      */
     fetchWithCache: <T = unknown>(url: string, options?: RequestInit & {
+        cacheTarget?: BuilderApiCacheTarget;
         strategy?: CachingStrategy;
     }) => Promise<T>;
     /**

package/dist/index.js

@@ -995,19 +995,34 @@ function useThemeSettings() {
   return settings;
 }
 var CACHE_DURATIONS = {
-  /** Short cache for frequently changing content (10 seconds) */
-  SHORT: 10,
-  /** Long cache duration - 23 hours to maximize CDN hits before daily refresh */
-  LONG: 82800
+  /** Short browser freshness for content that can change in Builder */
+  SHORT: 60,
+  /** Shared cache freshness for anonymous storefront traffic */
+  SHARED_SHORT: 300,
+  /** Long stale window so slow Builder responses do not block storefront rendering */
+  LONG: 86400,
+  /** Extra freshness for sitemap-like index data */
+  STATIC: 3600
 };
 var DEFAULT_FETCH_TIMEOUT_MS = 1e4;
 var API_PATH = "v1";
 var DEFAULT_CACHE_STRATEGY = {
   maxAge: CACHE_DURATIONS.SHORT,
-  sMaxAge: CACHE_DURATIONS.SHORT,
+  sMaxAge: CACHE_DURATIONS.SHARED_SHORT,
   staleWhileRevalidate: CACHE_DURATIONS.LONG,
   staleIfError: CACHE_DURATIONS.LONG
 };
+var SMART_CACHE_STRATEGIES = {
+  project: DEFAULT_CACHE_STRATEGY,
+  "theme-settings": DEFAULT_CACHE_STRATEGY,
+  "merchant-overrides": DEFAULT_CACHE_STRATEGY,
+  "custom-pages": {
+    maxAge: CACHE_DURATIONS.SHORT,
+    sMaxAge: CACHE_DURATIONS.STATIC,
+    staleWhileRevalidate: CACHE_DURATIONS.LONG,
+    staleIfError: CACHE_DURATIONS.LONG
+  }
+};
 var WeaverseClient = class {
   API = API_PATH;
   basePageConfigs;
@@ -1349,19 +1364,23 @@ var WeaverseClient = class {
    * ```
    */
   fetchWithCache = async (url, options = {}) => {
-    const strategy = options.strategy || hydrogen.CacheCustom(DEFAULT_CACHE_STRATEGY);
+    const { cacheTarget, strategy: strategyOverride, ...fetchOptions } = options;
+    const strategy = strategyOverride || hydrogen.CacheCustom(
+      cacheTarget ? SMART_CACHE_STRATEGIES[cacheTarget] : DEFAULT_CACHE_STRATEGY
+    );
     const cacheKey = [
       "weaverse-fetch",
       url,
       options.method || "GET",
-      options.body,
-      this.configs.projectId
+      fetchOptions.body,
+      this.configs.projectId,
+      cacheTarget || "default"
     ];
     let result;
-    if (this.configs.isDesignMode) {
-      result = await this.directFetch(url, options);
+    if (this.configs.isDesignMode || this.configs.isRevisionPreview) {
+      result = await this.directFetch(url, fetchOptions);
     } else {
-      result = await this.withCache.fetch(url, options, {
+      result = await this.withCache.fetch(url, fetchOptions, {
         cacheKey,
         cacheStrategy: strategy,
         shouldCacheResponse: (response) => {
@@ -1398,6 +1417,7 @@ var WeaverseClient = class {
       const [data, merchantOverrides] = await Promise.all([
         this.fetchWithCache(url, {
           method: "POST",
+          cacheTarget: "theme-settings",
           strategy,
           body,
           headers: {
@@ -1492,6 +1512,7 @@ var WeaverseClient = class {
         url,
         {
           method: "GET",
+          cacheTarget: "merchant-overrides",
           strategy,
           headers: {
             Accept: "application/json"
@@ -1555,7 +1576,7 @@ var WeaverseClient = class {
       const qs = params.toString();
       const url = `${weaverseHost}/api/public/v1/projects/${projectId}/custom-pages${qs ? `?${qs}` : ""}`;
       try {
-        const result = await this.fetchWithCache(url);
+        const result = await this.fetchWithCache(url, { cacheTarget: "custom-pages" });
         entries.push(...result.data || []);
         if (!result.nextCursor) {
           return entries;
@@ -1655,6 +1676,7 @@ var WeaverseClient = class {
       const url = this.getApiUrl("project");
       const projectData = await this.fetchWithCache(url, {
         ...reqInit,
+        cacheTarget: "project",
         strategy
       });
       if (hasError(projectData)) {