@nexushub/client 0.1.3 → 0.1.6

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);
@@ -1336,7 +1388,7 @@ var initVitals = (tracker) => {
 // src/analytics/storage.ts
 var DB_NAME = "NexusHub_Analytics";
 var STORE_NAME = "events_queue";
-var DB_VERSION = 1;
+var DB_VERSION = 2;
 var EventStorage = class {
   constructor() {
     this.db = null;
@@ -1349,7 +1401,9 @@ var EventStorage = class {
     return new Promise((resolve, reject) => {
       const request = indexedDB.open(DB_NAME, DB_VERSION);
       request.onerror = () => {
-        console.warn("[NexusHub] Failed to open IndexedDB. Falling back to memory.");
+        console.warn(
+          "[NexusHub] Failed to open IndexedDB. Falling back to memory."
+        );
         resolve();
       };
       request.onsuccess = (event) => {
@@ -1358,9 +1412,13 @@ var EventStorage = class {
       };
       request.onupgradeneeded = (event) => {
         const db = event.target.result;
-        if (!db.objectStoreNames.contains(STORE_NAME)) {
-          db.createObjectStore(STORE_NAME, { keyPath: "id", autoIncrement: true });
+        if (db.objectStoreNames.contains(STORE_NAME)) {
+          db.deleteObjectStore(STORE_NAME);
         }
+        db.createObjectStore(STORE_NAME, {
+          keyPath: "id",
+          autoIncrement: true
+        });
       };
     });
   }

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);
@@ -1336,7 +1388,7 @@ var initVitals = (tracker) => {
 // src/analytics/storage.ts
 var DB_NAME = "NexusHub_Analytics";
 var STORE_NAME = "events_queue";
-var DB_VERSION = 1;
+var DB_VERSION = 2;
 var EventStorage = class {
   constructor() {
     this.db = null;
@@ -1349,7 +1401,9 @@ var EventStorage = class {
     return new Promise((resolve, reject) => {
       const request = indexedDB.open(DB_NAME, DB_VERSION);
       request.onerror = () => {
-        console.warn("[NexusHub] Failed to open IndexedDB. Falling back to memory.");
+        console.warn(
+          "[NexusHub] Failed to open IndexedDB. Falling back to memory."
+        );
         resolve();
       };
       request.onsuccess = (event) => {
@@ -1358,9 +1412,13 @@ var EventStorage = class {
       };
       request.onupgradeneeded = (event) => {
         const db = event.target.result;
-        if (!db.objectStoreNames.contains(STORE_NAME)) {
-          db.createObjectStore(STORE_NAME, { keyPath: "id", autoIncrement: true });
+        if (db.objectStoreNames.contains(STORE_NAME)) {
+          db.deleteObjectStore(STORE_NAME);
         }
+        db.createObjectStore(STORE_NAME, {
+          keyPath: "id",
+          autoIncrement: true
+        });
       };
     });
   }

package/package.json

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