@nexushub/client 0.7.8 → 0.7.9

package/dist/index.cjs

@@ -936,7 +936,7 @@ var ContentEngine = class {
     });
     this.requestBatcher = new RequestBatcher(20, 50);
     this.circuitBreaker = new CircuitBreaker();
-    this.defaultRevalidate = config.revalidateTime || false;
+    this.defaultRevalidate = config.revalidateTime ?? false;
     this.cacheStrategy = config.cacheStrategy || "memory";
     if (!this.isServer) {
       window.addEventListener("beforeunload", this.cleanup.bind(this));
@@ -1200,7 +1200,10 @@ var ContentEngine = class {
         method: "GET",
         headers: this.getHeaders(),
         tags: fetchTags,
-        revalidate: options.revalidate || this.defaultRevalidate
+        // ?? not || — see the constructor comment on defaultRevalidate for
+        // why: an explicit `revalidate: 0` on this call must not be
+        // discarded in favor of the engine's default.
+        revalidate: options.revalidate ?? this.defaultRevalidate
       });
       if (!res.ok) {
         throw new Error(`API Error ${res.status}: ${res.statusText}`);
@@ -1208,7 +1211,7 @@ var ContentEngine = class {
       const json = await res.json();
       const data = json.data || json;
       this.writeCache(cacheKey, data, {
-        revalidate: options.revalidate || this.defaultRevalidate,
+        revalidate: options.revalidate ?? this.defaultRevalidate,
         tags: fetchTags
       });
       return data;
@@ -1252,19 +1255,49 @@ var ContentEngine = class {
   }
   /**
    * Robust Real-time Subscriptions (SSE) with Auto-Reconnect
+   *
+   * ⚠️ SCOPE — READ BEFORE RELYING ON THIS FOR "instant" UPDATES:
+   * This connects from the BROWSER TAB it's called in, and on message it
+   * only clears THIS SDK INSTANCE's in-memory `memoryCache` (via
+   * invalidateCache below) in THAT browser tab's JS heap. In a typical
+   * Next.js deployment — and Cloudflare specifically, which is stateless
+   * per-request at the edge — that is a different process/isolate than the
+   * one that will render the NEXT server request for this content. So:
+   *   - ✅ Useful for: a client component that reads from `nexus.content`
+   *     directly in the browser and re-renders in place without a page
+   *     navigation (e.g. a live-updating dashboard widget).
+   *   - ❌ NOT sufficient for: "user A edits content in the CMS, user B's
+   *     already-loaded page updates" via a server-rendered page. That
+   *     requires the backend's /api/revalidate webhook (see
+   *     content.service.ts `pingNextRevalidateWebhook`) to have actually
+   *     cleared the *server's* Data Cache, so the NEXT navigation or
+   *     server request picks up fresh data. This SSE channel does not
+   *     replace that — it's a complementary, browser-local optimization.
+   * If your symptom was "stale content after editing," fix the webhook
+   * wiring first; treat this method as an enhancement layered on top.
    */
   subscribeToUpdates(callback) {
     if (this.isServer || typeof EventSource === "undefined") {
-      console.warn("[NexusHub] EventSource not supported in this environment");
+      if (this.config.debug) {
+        console.warn(
+          "[NexusHub] subscribeToUpdates() called in a non-browser environment (server render or SSR pass) \u2014 this is expected and safely skipped; EventSource only makes sense client-side."
+        );
+      }
       return () => {
       };
     }
+    if (!this.config.apiKey) {
+      console.warn(
+        "[NexusHub] subscribeToUpdates(): no apiKey configured, the SSE connection will likely be rejected by the backend. Set NEXT_PUBLIC_NEXUS_KEY."
+      );
+    }
     let eventSource = null;
     let retryCount = 0;
     let isClosed = false;
+    const MAX_RETRY_DELAY_MS = 3e4;
     const connect = () => {
       if (isClosed) return;
-      const url = `${this.config.apiUrl}/content/${this.config.projectId}/updates?key=${this.config.apiKey}`;
+      const url = `${this.config.apiUrl}/content/${this.config.projectId}/updates?key=${this.config.apiKey ?? ""}`;
       eventSource = new EventSource(url);
       eventSource.onopen = () => {
         retryCount = 0;
@@ -1272,27 +1305,40 @@ var ContentEngine = class {
           console.log("[NexusHub] \u{1F7E2} Real-time stream connected");
       };
       eventSource.onmessage = (event) => {
+        let data;
         try {
-          const data = JSON.parse(event.data);
-          if (data.type === "content.updated" && data.slug) {
-            this.invalidateCache([CacheTags.content(data.slug)]);
-          }
-          if (data.type === "collection.updated") {
-            this.invalidateCache([CacheTags.collection(data.collectionId)]);
-          }
-          callback(data);
+          data = JSON.parse(event.data);
         } catch (e) {
           console.error("[NexusHub] SSE Parse Error", e);
+          return;
+        }
+        if (!data || typeof data.type !== "string") {
+          return;
         }
+        if (data.type === "content.updated" && data.slug) {
+          this.invalidateCache([CacheTags.content(data.slug)]);
+        }
+        if (data.type === "collection.updated" && data.collectionId) {
+          this.invalidateCache([CacheTags.collection(data.collectionId)]);
+        }
+        if (data.type === "schema.updated") {
+          this.clearCache();
+        }
+        callback(data);
       };
       eventSource.onerror = () => {
         eventSource?.close();
         if (isClosed) return;
-        const timeout = Math.min(1e3 * Math.pow(2, retryCount), 1e4);
-        retryCount++;
-        console.warn(
-          `[NexusHub] \u{1F534} Stream disconnected. Reconnecting in ${timeout}ms...`
+        const timeout = Math.min(
+          1e3 * Math.pow(2, retryCount),
+          MAX_RETRY_DELAY_MS
         );
+        retryCount++;
+        if (this.config.debug) {
+          console.warn(
+            `[NexusHub] \u{1F534} Stream disconnected. Reconnecting in ${timeout}ms...`
+          );
+        }
         setTimeout(connect, timeout);
       };
     };
@@ -1517,8 +1563,11 @@ var ContentEngine = class {
     const controller = new AbortController();
     const id = setTimeout(() => controller.abort(), timeout);
     const nextConfig = this.isServer ? {
-      cache: "force-cache",
-      next: { tags, revalidate: revalidate === false ? false : revalidate }
+      cache: revalidate === 0 ? "no-store" : "force-cache",
+      next: {
+        tags,
+        revalidate: revalidate === false ? false : revalidate
+      }
     } : {};
     try {
       const response = await fetch(url, {
@@ -2541,13 +2590,20 @@ function getSelector(el, depth = 0) {
 }
 
 // src/client.ts
+var DEFAULT_REVALIDATE_SECONDS = 60;
 var NexusClient = class {
   constructor(config) {
     const fullConfig = getFullConfig(config);
     this.config = {
       debug: config?.debug ?? false,
       cacheStrategy: config?.cacheStrategy ?? "memory",
-      revalidateTime: config?.revalidateTime ?? false,
+      // Only fall through to the safe default when revalidateTime is
+      // genuinely *unset* (undefined). An explicit `false` from the caller
+      // is a deliberate "never revalidate" choice and must be respected,
+      // not silently upgraded — `??` (not `||`) is required here so that
+      // `0` (revalidate on every request) also passes through untouched
+      // instead of being treated as falsy.
+      revalidateTime: config?.revalidateTime ?? DEFAULT_REVALIDATE_SECONDS,
       timeout: config?.timeout ?? 1e4,
       retries: config?.retries ?? 3,
       ...fullConfig

package/dist/index.d.cts

@@ -147,6 +147,26 @@ declare class ContentEngine {
     prefetch(urls: string[]): Promise<void>;
     /**
      * Robust Real-time Subscriptions (SSE) with Auto-Reconnect
+     *
+     * ⚠️ SCOPE — READ BEFORE RELYING ON THIS FOR "instant" UPDATES:
+     * This connects from the BROWSER TAB it's called in, and on message it
+     * only clears THIS SDK INSTANCE's in-memory `memoryCache` (via
+     * invalidateCache below) in THAT browser tab's JS heap. In a typical
+     * Next.js deployment — and Cloudflare specifically, which is stateless
+     * per-request at the edge — that is a different process/isolate than the
+     * one that will render the NEXT server request for this content. So:
+     *   - ✅ Useful for: a client component that reads from `nexus.content`
+     *     directly in the browser and re-renders in place without a page
+     *     navigation (e.g. a live-updating dashboard widget).
+     *   - ❌ NOT sufficient for: "user A edits content in the CMS, user B's
+     *     already-loaded page updates" via a server-rendered page. That
+     *     requires the backend's /api/revalidate webhook (see
+     *     content.service.ts `pingNextRevalidateWebhook`) to have actually
+     *     cleared the *server's* Data Cache, so the NEXT navigation or
+     *     server request picks up fresh data. This SSE channel does not
+     *     replace that — it's a complementary, browser-local optimization.
+     * If your symptom was "stale content after editing," fix the webhook
+     * wiring first; treat this method as an enhancement layered on top.
      */
     subscribeToUpdates(callback: (data: any) => void): () => void;
     private checkCaches;

package/dist/index.d.ts

@@ -147,6 +147,26 @@ declare class ContentEngine {
     prefetch(urls: string[]): Promise<void>;
     /**
      * Robust Real-time Subscriptions (SSE) with Auto-Reconnect
+     *
+     * ⚠️ SCOPE — READ BEFORE RELYING ON THIS FOR "instant" UPDATES:
+     * This connects from the BROWSER TAB it's called in, and on message it
+     * only clears THIS SDK INSTANCE's in-memory `memoryCache` (via
+     * invalidateCache below) in THAT browser tab's JS heap. In a typical
+     * Next.js deployment — and Cloudflare specifically, which is stateless
+     * per-request at the edge — that is a different process/isolate than the
+     * one that will render the NEXT server request for this content. So:
+     *   - ✅ Useful for: a client component that reads from `nexus.content`
+     *     directly in the browser and re-renders in place without a page
+     *     navigation (e.g. a live-updating dashboard widget).
+     *   - ❌ NOT sufficient for: "user A edits content in the CMS, user B's
+     *     already-loaded page updates" via a server-rendered page. That
+     *     requires the backend's /api/revalidate webhook (see
+     *     content.service.ts `pingNextRevalidateWebhook`) to have actually
+     *     cleared the *server's* Data Cache, so the NEXT navigation or
+     *     server request picks up fresh data. This SSE channel does not
+     *     replace that — it's a complementary, browser-local optimization.
+     * If your symptom was "stale content after editing," fix the webhook
+     * wiring first; treat this method as an enhancement layered on top.
      */
     subscribeToUpdates(callback: (data: any) => void): () => void;
     private checkCaches;

package/dist/index.js

@@ -890,7 +890,7 @@ var ContentEngine = class {
     });
     this.requestBatcher = new RequestBatcher(20, 50);
     this.circuitBreaker = new CircuitBreaker();
-    this.defaultRevalidate = config.revalidateTime || false;
+    this.defaultRevalidate = config.revalidateTime ?? false;
     this.cacheStrategy = config.cacheStrategy || "memory";
     if (!this.isServer) {
       window.addEventListener("beforeunload", this.cleanup.bind(this));
@@ -1154,7 +1154,10 @@ var ContentEngine = class {
         method: "GET",
         headers: this.getHeaders(),
         tags: fetchTags,
-        revalidate: options.revalidate || this.defaultRevalidate
+        // ?? not || — see the constructor comment on defaultRevalidate for
+        // why: an explicit `revalidate: 0` on this call must not be
+        // discarded in favor of the engine's default.
+        revalidate: options.revalidate ?? this.defaultRevalidate
       });
       if (!res.ok) {
         throw new Error(`API Error ${res.status}: ${res.statusText}`);
@@ -1162,7 +1165,7 @@ var ContentEngine = class {
       const json = await res.json();
       const data = json.data || json;
       this.writeCache(cacheKey, data, {
-        revalidate: options.revalidate || this.defaultRevalidate,
+        revalidate: options.revalidate ?? this.defaultRevalidate,
         tags: fetchTags
       });
       return data;
@@ -1206,19 +1209,49 @@ var ContentEngine = class {
   }
   /**
    * Robust Real-time Subscriptions (SSE) with Auto-Reconnect
+   *
+   * ⚠️ SCOPE — READ BEFORE RELYING ON THIS FOR "instant" UPDATES:
+   * This connects from the BROWSER TAB it's called in, and on message it
+   * only clears THIS SDK INSTANCE's in-memory `memoryCache` (via
+   * invalidateCache below) in THAT browser tab's JS heap. In a typical
+   * Next.js deployment — and Cloudflare specifically, which is stateless
+   * per-request at the edge — that is a different process/isolate than the
+   * one that will render the NEXT server request for this content. So:
+   *   - ✅ Useful for: a client component that reads from `nexus.content`
+   *     directly in the browser and re-renders in place without a page
+   *     navigation (e.g. a live-updating dashboard widget).
+   *   - ❌ NOT sufficient for: "user A edits content in the CMS, user B's
+   *     already-loaded page updates" via a server-rendered page. That
+   *     requires the backend's /api/revalidate webhook (see
+   *     content.service.ts `pingNextRevalidateWebhook`) to have actually
+   *     cleared the *server's* Data Cache, so the NEXT navigation or
+   *     server request picks up fresh data. This SSE channel does not
+   *     replace that — it's a complementary, browser-local optimization.
+   * If your symptom was "stale content after editing," fix the webhook
+   * wiring first; treat this method as an enhancement layered on top.
    */
   subscribeToUpdates(callback) {
     if (this.isServer || typeof EventSource === "undefined") {
-      console.warn("[NexusHub] EventSource not supported in this environment");
+      if (this.config.debug) {
+        console.warn(
+          "[NexusHub] subscribeToUpdates() called in a non-browser environment (server render or SSR pass) \u2014 this is expected and safely skipped; EventSource only makes sense client-side."
+        );
+      }
       return () => {
       };
     }
+    if (!this.config.apiKey) {
+      console.warn(
+        "[NexusHub] subscribeToUpdates(): no apiKey configured, the SSE connection will likely be rejected by the backend. Set NEXT_PUBLIC_NEXUS_KEY."
+      );
+    }
     let eventSource = null;
     let retryCount = 0;
     let isClosed = false;
+    const MAX_RETRY_DELAY_MS = 3e4;
     const connect = () => {
       if (isClosed) return;
-      const url = `${this.config.apiUrl}/content/${this.config.projectId}/updates?key=${this.config.apiKey}`;
+      const url = `${this.config.apiUrl}/content/${this.config.projectId}/updates?key=${this.config.apiKey ?? ""}`;
       eventSource = new EventSource(url);
       eventSource.onopen = () => {
         retryCount = 0;
@@ -1226,27 +1259,40 @@ var ContentEngine = class {
           console.log("[NexusHub] \u{1F7E2} Real-time stream connected");
       };
       eventSource.onmessage = (event) => {
+        let data;
         try {
-          const data = JSON.parse(event.data);
-          if (data.type === "content.updated" && data.slug) {
-            this.invalidateCache([CacheTags.content(data.slug)]);
-          }
-          if (data.type === "collection.updated") {
-            this.invalidateCache([CacheTags.collection(data.collectionId)]);
-          }
-          callback(data);
+          data = JSON.parse(event.data);
         } catch (e) {
           console.error("[NexusHub] SSE Parse Error", e);
+          return;
+        }
+        if (!data || typeof data.type !== "string") {
+          return;
         }
+        if (data.type === "content.updated" && data.slug) {
+          this.invalidateCache([CacheTags.content(data.slug)]);
+        }
+        if (data.type === "collection.updated" && data.collectionId) {
+          this.invalidateCache([CacheTags.collection(data.collectionId)]);
+        }
+        if (data.type === "schema.updated") {
+          this.clearCache();
+        }
+        callback(data);
       };
       eventSource.onerror = () => {
         eventSource?.close();
         if (isClosed) return;
-        const timeout = Math.min(1e3 * Math.pow(2, retryCount), 1e4);
-        retryCount++;
-        console.warn(
-          `[NexusHub] \u{1F534} Stream disconnected. Reconnecting in ${timeout}ms...`
+        const timeout = Math.min(
+          1e3 * Math.pow(2, retryCount),
+          MAX_RETRY_DELAY_MS
         );
+        retryCount++;
+        if (this.config.debug) {
+          console.warn(
+            `[NexusHub] \u{1F534} Stream disconnected. Reconnecting in ${timeout}ms...`
+          );
+        }
         setTimeout(connect, timeout);
       };
     };
@@ -1471,8 +1517,11 @@ var ContentEngine = class {
     const controller = new AbortController();
     const id = setTimeout(() => controller.abort(), timeout);
     const nextConfig = this.isServer ? {
-      cache: "force-cache",
-      next: { tags, revalidate: revalidate === false ? false : revalidate }
+      cache: revalidate === 0 ? "no-store" : "force-cache",
+      next: {
+        tags,
+        revalidate: revalidate === false ? false : revalidate
+      }
     } : {};
     try {
       const response = await fetch(url, {
@@ -2495,13 +2544,20 @@ function getSelector(el, depth = 0) {
 }
 
 // src/client.ts
+var DEFAULT_REVALIDATE_SECONDS = 60;
 var NexusClient = class {
   constructor(config) {
     const fullConfig = getFullConfig(config);
     this.config = {
       debug: config?.debug ?? false,
       cacheStrategy: config?.cacheStrategy ?? "memory",
-      revalidateTime: config?.revalidateTime ?? false,
+      // Only fall through to the safe default when revalidateTime is
+      // genuinely *unset* (undefined). An explicit `false` from the caller
+      // is a deliberate "never revalidate" choice and must be respected,
+      // not silently upgraded — `??` (not `||`) is required here so that
+      // `0` (revalidate on every request) also passes through untouched
+      // instead of being treated as falsy.
+      revalidateTime: config?.revalidateTime ?? DEFAULT_REVALIDATE_SECONDS,
       timeout: config?.timeout ?? 1e4,
       retries: config?.retries ?? 3,
       ...fullConfig

package/dist/react.cjs

@@ -535,7 +535,7 @@ var ContentEngine = class {
     });
     this.requestBatcher = new RequestBatcher(20, 50);
     this.circuitBreaker = new CircuitBreaker();
-    this.defaultRevalidate = config.revalidateTime || false;
+    this.defaultRevalidate = _nullishCoalesce(config.revalidateTime, () => ( false));
     this.cacheStrategy = config.cacheStrategy || "memory";
     if (!this.isServer) {
       window.addEventListener("beforeunload", this.cleanup.bind(this));
@@ -799,7 +799,10 @@ var ContentEngine = class {
         method: "GET",
         headers: this.getHeaders(),
         tags: fetchTags,
-        revalidate: options.revalidate || this.defaultRevalidate
+        // ?? not || — see the constructor comment on defaultRevalidate for
+        // why: an explicit `revalidate: 0` on this call must not be
+        // discarded in favor of the engine's default.
+        revalidate: _nullishCoalesce(options.revalidate, () => ( this.defaultRevalidate))
       });
       if (!res.ok) {
         throw new Error(`API Error ${res.status}: ${res.statusText}`);
@@ -807,7 +810,7 @@ var ContentEngine = class {
       const json = await res.json();
       const data = json.data || json;
       this.writeCache(cacheKey, data, {
-        revalidate: options.revalidate || this.defaultRevalidate,
+        revalidate: _nullishCoalesce(options.revalidate, () => ( this.defaultRevalidate)),
         tags: fetchTags
       });
       return data;
@@ -851,19 +854,49 @@ var ContentEngine = class {
   }
   /**
    * Robust Real-time Subscriptions (SSE) with Auto-Reconnect
+   *
+   * ⚠️ SCOPE — READ BEFORE RELYING ON THIS FOR "instant" UPDATES:
+   * This connects from the BROWSER TAB it's called in, and on message it
+   * only clears THIS SDK INSTANCE's in-memory `memoryCache` (via
+   * invalidateCache below) in THAT browser tab's JS heap. In a typical
+   * Next.js deployment — and Cloudflare specifically, which is stateless
+   * per-request at the edge — that is a different process/isolate than the
+   * one that will render the NEXT server request for this content. So:
+   *   - ✅ Useful for: a client component that reads from `nexus.content`
+   *     directly in the browser and re-renders in place without a page
+   *     navigation (e.g. a live-updating dashboard widget).
+   *   - ❌ NOT sufficient for: "user A edits content in the CMS, user B's
+   *     already-loaded page updates" via a server-rendered page. That
+   *     requires the backend's /api/revalidate webhook (see
+   *     content.service.ts `pingNextRevalidateWebhook`) to have actually
+   *     cleared the *server's* Data Cache, so the NEXT navigation or
+   *     server request picks up fresh data. This SSE channel does not
+   *     replace that — it's a complementary, browser-local optimization.
+   * If your symptom was "stale content after editing," fix the webhook
+   * wiring first; treat this method as an enhancement layered on top.
    */
   subscribeToUpdates(callback) {
     if (this.isServer || typeof EventSource === "undefined") {
-      console.warn("[NexusHub] EventSource not supported in this environment");
+      if (this.config.debug) {
+        console.warn(
+          "[NexusHub] subscribeToUpdates() called in a non-browser environment (server render or SSR pass) \u2014 this is expected and safely skipped; EventSource only makes sense client-side."
+        );
+      }
       return () => {
       };
     }
+    if (!this.config.apiKey) {
+      console.warn(
+        "[NexusHub] subscribeToUpdates(): no apiKey configured, the SSE connection will likely be rejected by the backend. Set NEXT_PUBLIC_NEXUS_KEY."
+      );
+    }
     let eventSource = null;
     let retryCount = 0;
     let isClosed = false;
+    const MAX_RETRY_DELAY_MS = 3e4;
     const connect = () => {
       if (isClosed) return;
-      const url = `${this.config.apiUrl}/content/${this.config.projectId}/updates?key=${this.config.apiKey}`;
+      const url = `${this.config.apiUrl}/content/${this.config.projectId}/updates?key=${_nullishCoalesce(this.config.apiKey, () => ( ""))}`;
       eventSource = new EventSource(url);
       eventSource.onopen = () => {
         retryCount = 0;
@@ -871,27 +904,40 @@ var ContentEngine = class {
           console.log("[NexusHub] \u{1F7E2} Real-time stream connected");
       };
       eventSource.onmessage = (event) => {
+        let data;
         try {
-          const data = JSON.parse(event.data);
-          if (data.type === "content.updated" && data.slug) {
-            this.invalidateCache([CacheTags.content(data.slug)]);
-          }
-          if (data.type === "collection.updated") {
-            this.invalidateCache([CacheTags.collection(data.collectionId)]);
-          }
-          callback(data);
+          data = JSON.parse(event.data);
         } catch (e) {
           console.error("[NexusHub] SSE Parse Error", e);
+          return;
+        }
+        if (!data || typeof data.type !== "string") {
+          return;
         }
+        if (data.type === "content.updated" && data.slug) {
+          this.invalidateCache([CacheTags.content(data.slug)]);
+        }
+        if (data.type === "collection.updated" && data.collectionId) {
+          this.invalidateCache([CacheTags.collection(data.collectionId)]);
+        }
+        if (data.type === "schema.updated") {
+          this.clearCache();
+        }
+        callback(data);
       };
       eventSource.onerror = () => {
         _optionalChain([eventSource, 'optionalAccess', _24 => _24.close, 'call', _25 => _25()]);
         if (isClosed) return;
-        const timeout = Math.min(1e3 * Math.pow(2, retryCount), 1e4);
-        retryCount++;
-        console.warn(
-          `[NexusHub] \u{1F534} Stream disconnected. Reconnecting in ${timeout}ms...`
+        const timeout = Math.min(
+          1e3 * Math.pow(2, retryCount),
+          MAX_RETRY_DELAY_MS
         );
+        retryCount++;
+        if (this.config.debug) {
+          console.warn(
+            `[NexusHub] \u{1F534} Stream disconnected. Reconnecting in ${timeout}ms...`
+          );
+        }
         setTimeout(connect, timeout);
       };
     };
@@ -1116,8 +1162,11 @@ var ContentEngine = class {
     const controller = new AbortController();
     const id = setTimeout(() => controller.abort(), timeout);
     const nextConfig = this.isServer ? {
-      cache: "force-cache",
-      next: { tags, revalidate: revalidate === false ? false : revalidate }
+      cache: revalidate === 0 ? "no-store" : "force-cache",
+      next: {
+        tags,
+        revalidate: revalidate === false ? false : revalidate
+      }
     } : {};
     try {
       const response = await fetch(url, {
@@ -2140,13 +2189,20 @@ function getSelector(el, depth = 0) {
 }
 
 // src/client.ts
+var DEFAULT_REVALIDATE_SECONDS = 60;
 var NexusClient = class {
   constructor(config) {
     const fullConfig = _chunkWZ47UVA2cjs.getFullConfig.call(void 0, config);
     this.config = {
       debug: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _41 => _41.debug]), () => ( false)),
       cacheStrategy: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _42 => _42.cacheStrategy]), () => ( "memory")),
-      revalidateTime: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _43 => _43.revalidateTime]), () => ( false)),
+      // Only fall through to the safe default when revalidateTime is
+      // genuinely *unset* (undefined). An explicit `false` from the caller
+      // is a deliberate "never revalidate" choice and must be respected,
+      // not silently upgraded — `??` (not `||`) is required here so that
+      // `0` (revalidate on every request) also passes through untouched
+      // instead of being treated as falsy.
+      revalidateTime: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _43 => _43.revalidateTime]), () => ( DEFAULT_REVALIDATE_SECONDS)),
       timeout: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _44 => _44.timeout]), () => ( 1e4)),
       retries: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _45 => _45.retries]), () => ( 3)),
       ...fullConfig

package/dist/react.d.cts

@@ -113,6 +113,26 @@ declare class ContentEngine {
     prefetch(urls: string[]): Promise<void>;
     /**
      * Robust Real-time Subscriptions (SSE) with Auto-Reconnect
+     *
+     * ⚠️ SCOPE — READ BEFORE RELYING ON THIS FOR "instant" UPDATES:
+     * This connects from the BROWSER TAB it's called in, and on message it
+     * only clears THIS SDK INSTANCE's in-memory `memoryCache` (via
+     * invalidateCache below) in THAT browser tab's JS heap. In a typical
+     * Next.js deployment — and Cloudflare specifically, which is stateless
+     * per-request at the edge — that is a different process/isolate than the
+     * one that will render the NEXT server request for this content. So:
+     *   - ✅ Useful for: a client component that reads from `nexus.content`
+     *     directly in the browser and re-renders in place without a page
+     *     navigation (e.g. a live-updating dashboard widget).
+     *   - ❌ NOT sufficient for: "user A edits content in the CMS, user B's
+     *     already-loaded page updates" via a server-rendered page. That
+     *     requires the backend's /api/revalidate webhook (see
+     *     content.service.ts `pingNextRevalidateWebhook`) to have actually
+     *     cleared the *server's* Data Cache, so the NEXT navigation or
+     *     server request picks up fresh data. This SSE channel does not
+     *     replace that — it's a complementary, browser-local optimization.
+     * If your symptom was "stale content after editing," fix the webhook
+     * wiring first; treat this method as an enhancement layered on top.
      */
     subscribeToUpdates(callback: (data: any) => void): () => void;
     private checkCaches;

package/dist/react.d.ts

@@ -113,6 +113,26 @@ declare class ContentEngine {
     prefetch(urls: string[]): Promise<void>;
     /**
      * Robust Real-time Subscriptions (SSE) with Auto-Reconnect
+     *
+     * ⚠️ SCOPE — READ BEFORE RELYING ON THIS FOR "instant" UPDATES:
+     * This connects from the BROWSER TAB it's called in, and on message it
+     * only clears THIS SDK INSTANCE's in-memory `memoryCache` (via
+     * invalidateCache below) in THAT browser tab's JS heap. In a typical
+     * Next.js deployment — and Cloudflare specifically, which is stateless
+     * per-request at the edge — that is a different process/isolate than the
+     * one that will render the NEXT server request for this content. So:
+     *   - ✅ Useful for: a client component that reads from `nexus.content`
+     *     directly in the browser and re-renders in place without a page
+     *     navigation (e.g. a live-updating dashboard widget).
+     *   - ❌ NOT sufficient for: "user A edits content in the CMS, user B's
+     *     already-loaded page updates" via a server-rendered page. That
+     *     requires the backend's /api/revalidate webhook (see
+     *     content.service.ts `pingNextRevalidateWebhook`) to have actually
+     *     cleared the *server's* Data Cache, so the NEXT navigation or
+     *     server request picks up fresh data. This SSE channel does not
+     *     replace that — it's a complementary, browser-local optimization.
+     * If your symptom was "stale content after editing," fix the webhook
+     * wiring first; treat this method as an enhancement layered on top.
      */
     subscribeToUpdates(callback: (data: any) => void): () => void;
     private checkCaches;