@nexushub/client 0.8.6 → 0.8.8

package/dist/react.cjs

@@ -2438,6 +2438,89 @@ async function parseError(res) {
   }
 }
 
+// src/notifications/push-client.ts
+var NexusPushClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Helper to convert Base64 VAPID key to Uint8Array for WebPush security
+   */
+  urlBase64ToUint8Array(base64String) {
+    const padding = "=".repeat((4 - base64String.length % 4) % 4);
+    const base64 = (base64String + padding).replace(/\-/g, "+").replace(/_/g, "/");
+    const rawData = window.atob(base64);
+    const outputArray = new Uint8Array(rawData.length);
+    for (let i = 0; i < rawData.length; ++i) {
+      outputArray[i] = rawData.charCodeAt(i);
+    }
+    return outputArray;
+  }
+  /**
+   * Requests browser notification permissions and registers the WebPush subscription
+   */
+  async requestSubscription(serviceWorkerPath = "/sw.js") {
+    if (typeof window === "undefined" || !("serviceWorker" in navigator) || !("PushManager" in window)) {
+      console.warn(
+        "[NexusHub] Push notifications are not supported in this browser environment."
+      );
+      return false;
+    }
+    try {
+      const permission = await Notification.requestPermission();
+      if (permission !== "granted") {
+        console.warn("[NexusHub] Notification permission denied by user.");
+        return false;
+      }
+      const vapidRes = await fetch(
+        `${this.config.apiUrl}/notifications/vapid-key`,
+        {
+          headers: {
+            Authorization: `Bearer ${this.config.apiKey}`,
+            "x-nexus-project": this.config.projectId
+          }
+        }
+      );
+      if (!vapidRes.ok) throw new Error("Failed to fetch VAPID public key.");
+      const { publicKey } = await vapidRes.json();
+      const registration = await navigator.serviceWorker.register(serviceWorkerPath);
+      await navigator.serviceWorker.ready;
+      const subscription = await registration.pushManager.subscribe({
+        userVisibleOnly: true,
+        // 🚀 RESOLVED: Cast as 'any' to bypass strict DOM BufferSource typings
+        applicationServerKey: this.urlBase64ToUint8Array(publicKey)
+      });
+      const rawSub = subscription.toJSON();
+      if (!rawSub.endpoint || !_optionalChain([rawSub, 'access', _46 => _46.keys, 'optionalAccess', _47 => _47.auth]) || !_optionalChain([rawSub, 'access', _48 => _48.keys, 'optionalAccess', _49 => _49.p256dh])) {
+        throw new Error(
+          "Malformed subscription payload received from browser."
+        );
+      }
+      const res = await fetch(
+        `${this.config.apiUrl}/notifications/project/${this.config.projectId}/subscribe`,
+        {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.config.apiKey}`,
+            "x-nexus-project": this.config.projectId
+          },
+          body: JSON.stringify({
+            endpoint: rawSub.endpoint,
+            auth: rawSub.keys.auth,
+            p256dh: rawSub.keys.p256dh,
+            provider: "WEB_PUSH"
+          })
+        }
+      );
+      return res.ok;
+    } catch (err) {
+      console.error("[NexusHub] WebPush subscription failed:", err);
+      return false;
+    }
+  }
+};
+
 // src/components/NexusProvider.tsx
 
 var NexusContext = _react.createContext.call(void 0, nexus);
@@ -2466,11 +2549,10 @@ var NexusProvider = ({
   projectId,
   disableAnalytics = false,
   hasConsent = true,
-  // NEW: default true to preserve existing behaviour
   enableLiveFeed = false,
-  // NEW
-  onLiveEvent
-  // NEW
+  onLiveEvent,
+  autoPromptPush = true
+  // 🚀 Default: true for zero-config automatic visitor subscription
 }) => {
   const isInitialized = _react.useRef.call(void 0, false);
   const socketRef = _react.useRef.call(void 0, null);
@@ -2488,6 +2570,29 @@ var NexusProvider = ({
     }
     return nexus.getConfig();
   }, [projectId]);
+  _react.useEffect.call(void 0, () => {
+    if (typeof window === "undefined" || !("serviceWorker" in navigator))
+      return;
+    navigator.serviceWorker.register("/sw.js").then(async (registration) => {
+      if (nexus.getConfig().debug) {
+        console.log("[NexusHub] \u26A1 Sovereign Service Worker Active.");
+      }
+      if (autoPromptPush && "Notification" in window && Notification.permission === "default") {
+        const pushClient = new NexusPushClient(nexus.getConfig());
+        await pushClient.requestSubscription("/sw.js");
+        return;
+      }
+      if ("Notification" in window && Notification.permission === "granted") {
+        try {
+          const pushClient = new NexusPushClient(nexus.getConfig());
+          await pushClient.requestSubscription("/sw.js");
+        } catch (e16) {
+        }
+      }
+    }).catch((err) => {
+      console.warn("[NexusHub] Service Worker registration failed:", err);
+    });
+  }, [autoPromptPush]);
   _react.useEffect.call(void 0, () => {
     if (typeof window === "undefined" || disableAnalytics || !hasConsent)
       return;
@@ -2513,7 +2618,7 @@ var NexusProvider = ({
     try {
       const { io } = await Promise.resolve().then(() => _interopRequireWildcard(require("socket.io-client")));
       const cfg = nexus.getConfig();
-      const wsUrl = cfg.apiUrl || "http://localhost:3001";
+      const wsUrl = cfg.apiUrl || "https://gnapex.co.tz";
       const socket = io(`${wsUrl}/analytics`, {
         auth: { token: cfg.apiKey },
         query: { projectId: cfg.projectId },
@@ -2531,7 +2636,7 @@ var NexusProvider = ({
       });
       socket.on("live_event", (event) => {
         setLatestEvent(event);
-        _optionalChain([onLiveEvent, 'optionalCall', _46 => _46(event)]);
+        _optionalChain([onLiveEvent, 'optionalCall', _50 => _50(event)]);
       });
       socketRef.current = socket;
     } catch (err) {
@@ -2694,7 +2799,7 @@ function NexusVideo({
   const isYouTube = value.includes("youtube.com") || value.includes("youtu.be");
   const isVimeo = value.includes("vimeo.com");
   if (isYouTube) {
-    const videoId = value.includes("youtu.be") ? value.split("/").pop() : _optionalChain([value, 'access', _47 => _47.split, 'call', _48 => _48("v="), 'access', _49 => _49[1], 'optionalAccess', _50 => _50.split, 'call', _51 => _51("&"), 'access', _52 => _52[0]]);
+    const videoId = value.includes("youtu.be") ? value.split("/").pop() : _optionalChain([value, 'access', _51 => _51.split, 'call', _52 => _52("v="), 'access', _53 => _53[1], 'optionalAccess', _54 => _54.split, 'call', _55 => _55("&"), 'access', _56 => _56[0]]);
     return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
       "iframe",
       {

package/dist/react.d.cts

@@ -237,6 +237,7 @@ interface NexusProviderProps {
     hasConsent?: boolean;
     enableLiveFeed?: boolean;
     onLiveEvent?: (event: LiveAnalyticsEvent) => void;
+    autoPromptPush?: boolean;
 }
 interface LiveAnalyticsEvent {
     eventType: string;
@@ -262,7 +263,7 @@ interface LiveFeedContextValue {
     isConnected: boolean;
 }
 declare const useNexusLiveFeed: () => LiveFeedContextValue;
-declare const NexusProvider: ({ children, projectId, disableAnalytics, hasConsent, enableLiveFeed, onLiveEvent, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
+declare const NexusProvider: ({ children, projectId, disableAnalytics, hasConsent, enableLiveFeed, onLiveEvent, autoPromptPush, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
 declare const useNexus: () => NexusClient;
 declare const useNexusAnalytics: () => {
     track: (eventName: string, properties?: Record<string, any>) => void;

package/dist/react.d.ts

@@ -237,6 +237,7 @@ interface NexusProviderProps {
     hasConsent?: boolean;
     enableLiveFeed?: boolean;
     onLiveEvent?: (event: LiveAnalyticsEvent) => void;
+    autoPromptPush?: boolean;
 }
 interface LiveAnalyticsEvent {
     eventType: string;
@@ -262,7 +263,7 @@ interface LiveFeedContextValue {
     isConnected: boolean;
 }
 declare const useNexusLiveFeed: () => LiveFeedContextValue;
-declare const NexusProvider: ({ children, projectId, disableAnalytics, hasConsent, enableLiveFeed, onLiveEvent, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
+declare const NexusProvider: ({ children, projectId, disableAnalytics, hasConsent, enableLiveFeed, onLiveEvent, autoPromptPush, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
 declare const useNexus: () => NexusClient;
 declare const useNexusAnalytics: () => {
     track: (eventName: string, properties?: Record<string, any>) => void;

package/dist/react.js

@@ -2438,6 +2438,89 @@ async function parseError(res) {
   }
 }
 
+// src/notifications/push-client.ts
+var NexusPushClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Helper to convert Base64 VAPID key to Uint8Array for WebPush security
+   */
+  urlBase64ToUint8Array(base64String) {
+    const padding = "=".repeat((4 - base64String.length % 4) % 4);
+    const base64 = (base64String + padding).replace(/\-/g, "+").replace(/_/g, "/");
+    const rawData = window.atob(base64);
+    const outputArray = new Uint8Array(rawData.length);
+    for (let i = 0; i < rawData.length; ++i) {
+      outputArray[i] = rawData.charCodeAt(i);
+    }
+    return outputArray;
+  }
+  /**
+   * Requests browser notification permissions and registers the WebPush subscription
+   */
+  async requestSubscription(serviceWorkerPath = "/sw.js") {
+    if (typeof window === "undefined" || !("serviceWorker" in navigator) || !("PushManager" in window)) {
+      console.warn(
+        "[NexusHub] Push notifications are not supported in this browser environment."
+      );
+      return false;
+    }
+    try {
+      const permission = await Notification.requestPermission();
+      if (permission !== "granted") {
+        console.warn("[NexusHub] Notification permission denied by user.");
+        return false;
+      }
+      const vapidRes = await fetch(
+        `${this.config.apiUrl}/notifications/vapid-key`,
+        {
+          headers: {
+            Authorization: `Bearer ${this.config.apiKey}`,
+            "x-nexus-project": this.config.projectId
+          }
+        }
+      );
+      if (!vapidRes.ok) throw new Error("Failed to fetch VAPID public key.");
+      const { publicKey } = await vapidRes.json();
+      const registration = await navigator.serviceWorker.register(serviceWorkerPath);
+      await navigator.serviceWorker.ready;
+      const subscription = await registration.pushManager.subscribe({
+        userVisibleOnly: true,
+        // 🚀 RESOLVED: Cast as 'any' to bypass strict DOM BufferSource typings
+        applicationServerKey: this.urlBase64ToUint8Array(publicKey)
+      });
+      const rawSub = subscription.toJSON();
+      if (!rawSub.endpoint || !rawSub.keys?.auth || !rawSub.keys?.p256dh) {
+        throw new Error(
+          "Malformed subscription payload received from browser."
+        );
+      }
+      const res = await fetch(
+        `${this.config.apiUrl}/notifications/project/${this.config.projectId}/subscribe`,
+        {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.config.apiKey}`,
+            "x-nexus-project": this.config.projectId
+          },
+          body: JSON.stringify({
+            endpoint: rawSub.endpoint,
+            auth: rawSub.keys.auth,
+            p256dh: rawSub.keys.p256dh,
+            provider: "WEB_PUSH"
+          })
+        }
+      );
+      return res.ok;
+    } catch (err) {
+      console.error("[NexusHub] WebPush subscription failed:", err);
+      return false;
+    }
+  }
+};
+
 // src/components/NexusProvider.tsx
 import { jsx as jsx2, jsxs } from "react/jsx-runtime";
 var NexusContext = createContext2(nexus);
@@ -2466,11 +2549,10 @@ var NexusProvider = ({
   projectId,
   disableAnalytics = false,
   hasConsent = true,
-  // NEW: default true to preserve existing behaviour
   enableLiveFeed = false,
-  // NEW
-  onLiveEvent
-  // NEW
+  onLiveEvent,
+  autoPromptPush = true
+  // 🚀 Default: true for zero-config automatic visitor subscription
 }) => {
   const isInitialized = useRef(false);
   const socketRef = useRef(null);
@@ -2488,6 +2570,29 @@ var NexusProvider = ({
     }
     return nexus.getConfig();
   }, [projectId]);
+  useEffect2(() => {
+    if (typeof window === "undefined" || !("serviceWorker" in navigator))
+      return;
+    navigator.serviceWorker.register("/sw.js").then(async (registration) => {
+      if (nexus.getConfig().debug) {
+        console.log("[NexusHub] \u26A1 Sovereign Service Worker Active.");
+      }
+      if (autoPromptPush && "Notification" in window && Notification.permission === "default") {
+        const pushClient = new NexusPushClient(nexus.getConfig());
+        await pushClient.requestSubscription("/sw.js");
+        return;
+      }
+      if ("Notification" in window && Notification.permission === "granted") {
+        try {
+          const pushClient = new NexusPushClient(nexus.getConfig());
+          await pushClient.requestSubscription("/sw.js");
+        } catch {
+        }
+      }
+    }).catch((err) => {
+      console.warn("[NexusHub] Service Worker registration failed:", err);
+    });
+  }, [autoPromptPush]);
   useEffect2(() => {
     if (typeof window === "undefined" || disableAnalytics || !hasConsent)
       return;
@@ -2513,7 +2618,7 @@ var NexusProvider = ({
     try {
       const { io } = await import("socket.io-client");
       const cfg = nexus.getConfig();
-      const wsUrl = cfg.apiUrl || "http://localhost:3001";
+      const wsUrl = cfg.apiUrl || "https://gnapex.co.tz";
       const socket = io(`${wsUrl}/analytics`, {
         auth: { token: cfg.apiKey },
         query: { projectId: cfg.projectId },

package/package.json

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