@nexushub/client 0.1.4 → 0.1.7

package/dist/index.cjs

@@ -988,6 +988,46 @@ var ContentEngine = class {
       this.browserCache.set(key, data, options.revalidate * 1e3);
     }
   }
+  // packages/client-sdk/src/content/index.ts
+  /**
+   * ⚡ THE PULSE: Next.js Cache Revalidation Receiver
+   * Used in app/api/nexus-revalidate/route.ts to handle instant updates from the NexusHub backend.
+   *
+   * @param req The incoming Request object from Next.js
+   * @param revalidateFn The revalidateTag function imported from 'next/cache'
+   */
+  async handleRevalidation(req, revalidateFn) {
+    try {
+      if (!req.body) {
+        return { success: false, message: "Missing Pulse Payload" };
+      }
+      const body = await req.json();
+      const { secret, tag } = body;
+      if (!secret || secret !== this.config.projectId) {
+        if (this.config.debug) {
+          console.warn(`[NexusHub] \u26A0\uFE0F Blocked unauthorized Pulse request.`);
+        }
+        return { success: false, message: "Invalid Pulse Signature" };
+      }
+      const targetTag = tag || "content_all";
+      revalidateFn(targetTag);
+      this.invalidateCache([targetTag]);
+      if (this.config.debug) {
+        console.log(
+          `[NexusHub] \u26A1 Pulse Received: Successfully revalidated tag [${targetTag}]`
+        );
+      }
+      return { success: true, now: Date.now() };
+    } catch (e) {
+      if (this.config.debug) {
+        console.error(`[NexusHub] \u274C Pulse Processing Error:`, e.message);
+      }
+      return {
+        success: false,
+        message: "Malformed Pulse Payload or Processing Error"
+      };
+    }
+  }
   /**
    * Invalidate cache by tags
    */
@@ -1032,7 +1072,9 @@ var ContentEngine = class {
     }
     const res = await this.fetchWithTimeout(url, {
       method: "GET",
-      headers: this.getHeaders()
+      headers: this.getHeaders(),
+      tags,
+      revalidate
     });
     if (!res.ok) {
       if (res.status === 404) {
@@ -1071,7 +1113,9 @@ var ContentEngine = class {
     }
     const res = await this.fetchWithTimeout(url, {
       method: "GET",
-      headers: this.getHeaders()
+      headers: this.getHeaders(),
+      tags,
+      revalidate
     });
     if (!res.ok) {
       throw new Error(`API Error ${res.status}: ${res.statusText}`);
@@ -1144,12 +1188,20 @@ var ContentEngine = class {
     };
   }
   async fetchWithTimeout(url, options = {}) {
-    const { timeout = this.config.timeout || 1e4, ...fetchOptions } = options;
+    const {
+      timeout = this.config.timeout || 1e4,
+      tags = [],
+      revalidate,
+      ...fetchOptions
+    } = options;
     const controller = new AbortController();
     const id = setTimeout(() => controller.abort(), timeout);
+    const nextConfig = this.isServer ? { next: { tags, revalidate } } : {};
     try {
       const response = await fetch(url, {
         ...fetchOptions,
+        ...nextConfig,
+        // Inject Next.js tags
         signal: controller.signal
       });
       clearTimeout(id);

package/dist/index.d.cts

@@ -156,6 +156,18 @@ declare class ContentEngine {
      */
     private checkCaches;
     private writeCache;
+    /**
+     * ⚡ THE PULSE: Next.js Cache Revalidation Receiver
+     * Used in app/api/nexus-revalidate/route.ts to handle instant updates from the NexusHub backend.
+     *
+     * @param req The incoming Request object from Next.js
+     * @param revalidateFn The revalidateTag function imported from 'next/cache'
+     */
+    handleRevalidation(req: Request, revalidateFn: (tag: string) => void): Promise<{
+        success: boolean;
+        message?: string;
+        now?: number;
+    }>;
     /**
      * Invalidate cache by tags
      */

package/dist/index.d.ts

@@ -156,6 +156,18 @@ declare class ContentEngine {
      */
     private checkCaches;
     private writeCache;
+    /**
+     * ⚡ THE PULSE: Next.js Cache Revalidation Receiver
+     * Used in app/api/nexus-revalidate/route.ts to handle instant updates from the NexusHub backend.
+     *
+     * @param req The incoming Request object from Next.js
+     * @param revalidateFn The revalidateTag function imported from 'next/cache'
+     */
+    handleRevalidation(req: Request, revalidateFn: (tag: string) => void): Promise<{
+        success: boolean;
+        message?: string;
+        now?: number;
+    }>;
     /**
      * Invalidate cache by tags
      */

package/dist/index.js

@@ -988,6 +988,46 @@ var ContentEngine = class {
       this.browserCache.set(key, data, options.revalidate * 1e3);
     }
   }
+  // packages/client-sdk/src/content/index.ts
+  /**
+   * ⚡ THE PULSE: Next.js Cache Revalidation Receiver
+   * Used in app/api/nexus-revalidate/route.ts to handle instant updates from the NexusHub backend.
+   *
+   * @param req The incoming Request object from Next.js
+   * @param revalidateFn The revalidateTag function imported from 'next/cache'
+   */
+  async handleRevalidation(req, revalidateFn) {
+    try {
+      if (!req.body) {
+        return { success: false, message: "Missing Pulse Payload" };
+      }
+      const body = await req.json();
+      const { secret, tag } = body;
+      if (!secret || secret !== this.config.projectId) {
+        if (this.config.debug) {
+          console.warn(`[NexusHub] \u26A0\uFE0F Blocked unauthorized Pulse request.`);
+        }
+        return { success: false, message: "Invalid Pulse Signature" };
+      }
+      const targetTag = tag || "content_all";
+      revalidateFn(targetTag);
+      this.invalidateCache([targetTag]);
+      if (this.config.debug) {
+        console.log(
+          `[NexusHub] \u26A1 Pulse Received: Successfully revalidated tag [${targetTag}]`
+        );
+      }
+      return { success: true, now: Date.now() };
+    } catch (e) {
+      if (this.config.debug) {
+        console.error(`[NexusHub] \u274C Pulse Processing Error:`, e.message);
+      }
+      return {
+        success: false,
+        message: "Malformed Pulse Payload or Processing Error"
+      };
+    }
+  }
   /**
    * Invalidate cache by tags
    */
@@ -1032,7 +1072,9 @@ var ContentEngine = class {
     }
     const res = await this.fetchWithTimeout(url, {
       method: "GET",
-      headers: this.getHeaders()
+      headers: this.getHeaders(),
+      tags,
+      revalidate
     });
     if (!res.ok) {
       if (res.status === 404) {
@@ -1071,7 +1113,9 @@ var ContentEngine = class {
     }
     const res = await this.fetchWithTimeout(url, {
       method: "GET",
-      headers: this.getHeaders()
+      headers: this.getHeaders(),
+      tags,
+      revalidate
     });
     if (!res.ok) {
       throw new Error(`API Error ${res.status}: ${res.statusText}`);
@@ -1144,12 +1188,20 @@ var ContentEngine = class {
     };
   }
   async fetchWithTimeout(url, options = {}) {
-    const { timeout = this.config.timeout || 1e4, ...fetchOptions } = options;
+    const {
+      timeout = this.config.timeout || 1e4,
+      tags = [],
+      revalidate,
+      ...fetchOptions
+    } = options;
     const controller = new AbortController();
     const id = setTimeout(() => controller.abort(), timeout);
+    const nextConfig = this.isServer ? { next: { tags, revalidate } } : {};
     try {
       const response = await fetch(url, {
         ...fetchOptions,
+        ...nextConfig,
+        // Inject Next.js tags
         signal: controller.signal
       });
       clearTimeout(id);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nexushub/client",
   "private": false,
-  "version": "0.1.4",
+  "version": "0.1.7",
   "description": "The God-Tier NexusHub SDK",
   "type": "module",
   "main": "./dist/index.cjs",