@nexushub/client 0.4.1 → 0.4.3

package/dist/index.d.cts

@@ -1,5 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import React from 'react';
 import { I as ILocalCache } from './cache-types-B39iNHfE.cjs';
 
 interface MinimalNexusConfig {
@@ -278,36 +276,6 @@ declare class NexusClient {
 declare const nexus: NexusClient;
 declare const createNexusClient: (config: Partial<NexusConfig>) => NexusClient;
 
-interface NexusProviderProps {
-    children: React.ReactNode;
-    projectId?: string;
-    disableAnalytics?: boolean;
-    hasConsent?: boolean;
-    enableLiveFeed?: boolean;
-    onLiveEvent?: (event: LiveAnalyticsEvent) => void;
-}
-interface LiveAnalyticsEvent {
-    eventType: string;
-    projectId: string;
-    sessionId: string;
-    visitorId: string;
-    userId?: string;
-    data: {
-        event_id: string;
-        event_name?: string;
-        url: string;
-        timestamp: string;
-        geo?: Record<string, any>;
-        device?: Record<string, any>;
-        performance?: Record<string, any>;
-        ecommerce?: Record<string, any>;
-    };
-    timestamp: string;
-    sequence: number;
-}
-declare const NexusProvider: ({ children, projectId, disableAnalytics, hasConsent, enableLiveFeed, onLiveEvent, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
-declare const useNexus: () => NexusClient;
-
 interface SiteUser {
     id: string;
     email: string;
@@ -352,12 +320,6 @@ interface AuthContextType extends AuthState {
     requestPasswordReset: (email: string) => Promise<void>;
 }
 
-declare const AuthProvider: ({ children, config, }: {
-    children: React.ReactNode;
-    config: NexusConfig;
-}) => react_jsx_runtime.JSX.Element;
-declare const useNexusAuth: () => AuthContextType;
-
 /**
  * NexusHub Shared Cache Implementations
  *
@@ -435,4 +397,4 @@ declare class LocalCacheProxy implements ILocalCache {
 
 declare const VERSION = "0.0.1";
 
-export { AnalyticsEngine, type AuthContextType, type AuthError, AuthProvider, type AuthState, BrowserCache, type CacheEntry, type CacheMetadata, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, DEFAULT_ANALYTICS_URL, DEFAULT_API_URL, type ErrorResponse, LOCAL_NEST_URL, LOCAL_RUST_URL, LocalCacheProxy as LocalCache, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, NexusProvider, type NexusProviderProps, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, useNexus, useNexusAuth, validateConfig };
+export { AnalyticsEngine, type AuthContextType, type AuthError, type AuthState, BrowserCache, type CacheEntry, type CacheMetadata, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, DEFAULT_ANALYTICS_URL, DEFAULT_API_URL, type ErrorResponse, LOCAL_NEST_URL, LOCAL_RUST_URL, LocalCacheProxy as LocalCache, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, validateConfig };

package/dist/index.d.ts

@@ -1,5 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import React from 'react';
 import { I as ILocalCache } from './cache-types-B39iNHfE.js';
 
 interface MinimalNexusConfig {
@@ -278,36 +276,6 @@ declare class NexusClient {
 declare const nexus: NexusClient;
 declare const createNexusClient: (config: Partial<NexusConfig>) => NexusClient;
 
-interface NexusProviderProps {
-    children: React.ReactNode;
-    projectId?: string;
-    disableAnalytics?: boolean;
-    hasConsent?: boolean;
-    enableLiveFeed?: boolean;
-    onLiveEvent?: (event: LiveAnalyticsEvent) => void;
-}
-interface LiveAnalyticsEvent {
-    eventType: string;
-    projectId: string;
-    sessionId: string;
-    visitorId: string;
-    userId?: string;
-    data: {
-        event_id: string;
-        event_name?: string;
-        url: string;
-        timestamp: string;
-        geo?: Record<string, any>;
-        device?: Record<string, any>;
-        performance?: Record<string, any>;
-        ecommerce?: Record<string, any>;
-    };
-    timestamp: string;
-    sequence: number;
-}
-declare const NexusProvider: ({ children, projectId, disableAnalytics, hasConsent, enableLiveFeed, onLiveEvent, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
-declare const useNexus: () => NexusClient;
-
 interface SiteUser {
     id: string;
     email: string;
@@ -352,12 +320,6 @@ interface AuthContextType extends AuthState {
     requestPasswordReset: (email: string) => Promise<void>;
 }
 
-declare const AuthProvider: ({ children, config, }: {
-    children: React.ReactNode;
-    config: NexusConfig;
-}) => react_jsx_runtime.JSX.Element;
-declare const useNexusAuth: () => AuthContextType;
-
 /**
  * NexusHub Shared Cache Implementations
  *
@@ -435,4 +397,4 @@ declare class LocalCacheProxy implements ILocalCache {
 
 declare const VERSION = "0.0.1";
 
-export { AnalyticsEngine, type AuthContextType, type AuthError, AuthProvider, type AuthState, BrowserCache, type CacheEntry, type CacheMetadata, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, DEFAULT_ANALYTICS_URL, DEFAULT_API_URL, type ErrorResponse, LOCAL_NEST_URL, LOCAL_RUST_URL, LocalCacheProxy as LocalCache, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, NexusProvider, type NexusProviderProps, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, useNexus, useNexusAuth, validateConfig };
+export { AnalyticsEngine, type AuthContextType, type AuthError, type AuthState, BrowserCache, type CacheEntry, type CacheMetadata, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, DEFAULT_ANALYTICS_URL, DEFAULT_API_URL, type ErrorResponse, LOCAL_NEST_URL, LOCAL_RUST_URL, LocalCacheProxy as LocalCache, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, validateConfig };

package/dist/index.js

@@ -1,3 +1,202 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/content/local-cache-server.ts
+var local_cache_server_exports = {};
+__export(local_cache_server_exports, {
+  LocalCache: () => LocalCache
+});
+import fs from "fs";
+import path from "path";
+var LocalCache;
+var init_local_cache_server = __esm({
+  "src/content/local-cache-server.ts"() {
+    "use strict";
+    LocalCache = class {
+      constructor(customPath) {
+        this.baseDir = customPath || ".nexus/local";
+      }
+      isLoaded() {
+        return fs.existsSync(path.resolve(process.cwd(), this.baseDir));
+      }
+      /**
+       * Retrieve a specific page directly from its file.
+       */
+      async getPage(slug) {
+        try {
+          const filePath = path.resolve(
+            process.cwd(),
+            this.baseDir,
+            "pages",
+            `${slug}.json`
+          );
+          if (fs.existsSync(filePath)) {
+            const fileContent = fs.readFileSync(filePath, "utf-8");
+            const pageData = JSON.parse(fileContent);
+            return pageData.data !== void 0 ? pageData.data : pageData;
+          }
+        } catch (error) {
+          if (process.env.NODE_ENV === "development") {
+            console.warn(
+              `\u26A0\uFE0F  NexusHub: Failed to load local page '${slug}':`,
+              error
+            );
+          }
+        }
+        return null;
+      }
+      /**
+       * Retrieve an entire collection from its specific collection file.
+       */
+      async getCollection(collectionId) {
+        try {
+          const filePath = path.resolve(
+            process.cwd(),
+            this.baseDir,
+            "collections",
+            `${collectionId}.json`
+          );
+          if (fs.existsSync(filePath)) {
+            const fileContent = fs.readFileSync(filePath, "utf-8");
+            return JSON.parse(fileContent);
+          }
+        } catch (error) {
+          if (process.env.NODE_ENV === "development") {
+            console.warn(
+              `\u26A0\uFE0F  NexusHub: Failed to load local collection '${collectionId}':`,
+              error
+            );
+          }
+        }
+        return null;
+      }
+      /**
+       * Retrieve global settings from its file.
+       */
+      async getGlobals() {
+        try {
+          const filePath = path.resolve(
+            process.cwd(),
+            this.baseDir,
+            "globals.json"
+          );
+          if (fs.existsSync(filePath)) {
+            const fileContent = fs.readFileSync(filePath, "utf-8");
+            return JSON.parse(fileContent);
+          }
+        } catch {
+        }
+        return null;
+      }
+      /**
+       * Returns a merged JSON of the entire workspace structure (for dev analytics/inspectors)
+       */
+      async getAllData() {
+        const pages = {};
+        const collections = {};
+        let globals = {};
+        try {
+          const pagesDir = path.resolve(process.cwd(), this.baseDir, "pages");
+          if (fs.existsSync(pagesDir)) {
+            for (const file of fs.readdirSync(pagesDir)) {
+              if (file.endsWith(".json")) {
+                const slug = path.basename(file, ".json");
+                pages[slug] = await this.getPage(slug);
+              }
+            }
+          }
+          const colsDir = path.resolve(process.cwd(), this.baseDir, "collections");
+          if (fs.existsSync(colsDir)) {
+            for (const file of fs.readdirSync(colsDir)) {
+              if (file.endsWith(".json")) {
+                const id = path.basename(file, ".json");
+                collections[id] = await this.getCollection(id) || [];
+              }
+            }
+          }
+          globals = await this.getGlobals() || {};
+        } catch {
+        }
+        return { pages, collections, globals };
+      }
+    };
+  }
+});
+
+// src/content/local-cache-client.ts
+var local_cache_client_exports = {};
+__export(local_cache_client_exports, {
+  LocalCache: () => LocalCache2
+});
+var LocalCache2;
+var init_local_cache_client = __esm({
+  "src/content/local-cache-client.ts"() {
+    "use strict";
+    LocalCache2 = class {
+      constructor(customPath) {
+        // Maintain private properties for type parity with the Server version
+        this.data = null;
+        this.hasLoaded = false;
+        this.cachePath = customPath || ".nexus/cache.json";
+      }
+      /**
+       * Always returns false in the browser as local file caching
+       * is a server-side only feature.
+       */
+      isLoaded() {
+        return false;
+      }
+      /**
+       * No-op method to maintain internal API compatibility.
+       */
+      load() {
+        return;
+      }
+      /**
+       * Returns null. Browsers should fetch pages from the Remote API
+       * or the Memory/Browser cache.
+       */
+      async getPage(_slug) {
+        return null;
+      }
+      /**
+       * Returns null. Browsers should fetch collections from the Remote API.
+       */
+      async getCollection(_collectionId) {
+        return null;
+      }
+      /**
+       * Returns null.
+       */
+      async getGlobals() {
+        return null;
+      }
+      /**
+       * Returns null.
+       */
+      async getAllData() {
+        return null;
+      }
+      /**
+       * Dummy helper to match Node implementation.
+       */
+      shouldWarnAboutMissingCache(error) {
+        const isMissing = error.code === "ENOENT";
+        const isMalformed = error instanceof SyntaxError;
+        if (process.env.NODE_ENV !== "development") return false;
+        return !isMissing || isMalformed;
+      }
+    };
+  }
+});
+
 // src/config.ts
 var DEFAULT_API_URL = "https://endpoints.gnexus.co.tz";
 var DEFAULT_ANALYTICS_URL = "https://sentry.gnexus.co.tz";
@@ -313,10 +512,10 @@ var LocalCacheProxy = class {
   async getInstance() {
     if (this.instance) return this.instance;
     if (typeof window === "undefined") {
-      const mod = await import("./content/local-cache-server.js");
+      const mod = await Promise.resolve().then(() => (init_local_cache_server(), local_cache_server_exports));
       this.instance = new mod.LocalCache(this.cachePath);
     } else {
-      const mod = await import("./content/local-cache-client.js");
+      const mod = await Promise.resolve().then(() => (init_local_cache_client(), local_cache_client_exports));
       this.instance = new mod.LocalCache(this.cachePath);
     }
     return this.instance;
@@ -2257,342 +2456,10 @@ var NexusClient = class {
 var nexus = new NexusClient();
 var createNexusClient = (config) => new NexusClient(config);
 
-// src/components/NexusProvider.tsx
-import React2, {
-  createContext as createContext2,
-  useEffect as useEffect2,
-  useRef,
-  useMemo,
-  useState as useState2,
-  useCallback as useCallback2,
-  Suspense
-} from "react";
-import { usePathname, useSearchParams } from "next/navigation";
-
-// src/auth/context.tsx
-import {
-  createContext,
-  useContext,
-  useEffect,
-  useState,
-  useCallback
-} from "react";
-import { jsx } from "react/jsx-runtime";
-var AuthContext = createContext(null);
-var AuthProvider = ({
-  children,
-  config
-}) => {
-  const [user, setUser] = useState(null);
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState(null);
-  const AUTH_BASE = `${config.apiUrl}/auth/project/${config.projectId}`;
-  const checkSession = useCallback(async () => {
-    try {
-      const res = await fetch(`${AUTH_BASE}/me`, {
-        headers: getHeaders(config)
-      });
-      if (res.ok) {
-        const data = await res.json();
-        setUser(data.user);
-        if (nexus.analytics) {
-          nexus.analytics.identify(data.user.id, {
-            email: data.user.email,
-            role: data.user.role,
-            ...data.user.metadata
-          });
-        }
-      } else {
-        setUser(null);
-      }
-    } catch (err) {
-      console.debug("[NexusHub Auth] Session check failed:", err);
-      setUser(null);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [AUTH_BASE, config]);
-  useEffect(() => {
-    checkSession();
-  }, [checkSession]);
-  const login = async (creds) => {
-    setIsLoading(true);
-    setError(null);
-    try {
-      const res = await fetch(`${AUTH_BASE}/login`, {
-        method: "POST",
-        headers: getHeaders(config),
-        body: JSON.stringify(creds)
-      });
-      if (!res.ok) throw await parseError(res);
-      const data = await res.json();
-      setUser(data.user);
-      if (nexus.analytics) {
-        await nexus.analytics.identify(data.user.id, {
-          email: data.user.email,
-          role: data.user.role,
-          login_method: "email",
-          ...data.user.metadata
-        });
-      }
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-  const register = async (creds) => {
-    setIsLoading(true);
-    setError(null);
-    try {
-      const res = await fetch(`${AUTH_BASE}/register`, {
-        method: "POST",
-        headers: getHeaders(config),
-        body: JSON.stringify(creds)
-      });
-      if (!res.ok) throw await parseError(res);
-      const data = await res.json();
-      setUser(data.user);
-      if (nexus.analytics) {
-        nexus.analytics.track("signup", { method: "email" });
-        nexus.analytics.identify(data.user.id, {
-          email: data.user.email,
-          role: data.user.role,
-          ...data.user.metadata
-        });
-      }
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-  const logout = async () => {
-    setIsLoading(true);
-    try {
-      await fetch(`${AUTH_BASE}/logout`, {
-        method: "POST",
-        headers: getHeaders(config)
-      });
-    } catch (e) {
-      console.warn("Logout network error", e);
-    } finally {
-      setUser(null);
-      setIsLoading(false);
-      if (nexus.analytics) {
-        nexus.analytics.track("logout");
-      }
-    }
-  };
-  const updateProfile = async (updates) => {
-    try {
-      const res = await fetch(`${AUTH_BASE}/profile`, {
-        method: "PATCH",
-        headers: getHeaders(config),
-        body: JSON.stringify(updates)
-      });
-      if (!res.ok) throw await parseError(res);
-      const data = await res.json();
-      setUser(data.user);
-      if (nexus.analytics) {
-        nexus.analytics.identify(data.user.id, updates);
-      }
-    } catch (err) {
-      setError(err);
-      throw err;
-    }
-  };
-  const requestPasswordReset = async (email) => {
-    const res = await fetch(`${AUTH_BASE}/password/reset-request`, {
-      method: "POST",
-      headers: getHeaders(config),
-      body: JSON.stringify({ email })
-    });
-    if (!res.ok) throw await parseError(res);
-  };
-  return /* @__PURE__ */ jsx(
-    AuthContext.Provider,
-    {
-      value: {
-        user,
-        isLoading,
-        error,
-        isAuthenticated: !!user,
-        login,
-        register,
-        logout,
-        updateProfile,
-        requestPasswordReset
-      },
-      children
-    }
-  );
-};
-var useNexusAuth = () => {
-  const context = useContext(AuthContext);
-  if (!context) {
-    throw new Error("useNexusAuth must be used within a NexusProvider");
-  }
-  return context;
-};
-function getHeaders(config) {
-  return {
-    "Content-Type": "application/json",
-    "x-nexus-project": config.projectId,
-    Authorization: `Bearer ${config.apiKey}`
-    // 👈 CRITICAL: Send the nx_pk_ key
-    // Note: We do NOT send the Master API Key here.
-    // This is client-side. The backend uses Cookies or public tokens.
-  };
-}
-async function parseError(res) {
-  try {
-    const json = await res.json();
-    return {
-      status: res.status,
-      code: json.code || "UNKNOWN_ERROR",
-      message: json.message || "An error occurred during authentication"
-    };
-  } catch {
-    return {
-      status: res.status,
-      code: "NETWORK_ERROR",
-      message: res.statusText
-    };
-  }
-}
-
-// src/components/NexusProvider.tsx
-import { jsx as jsx2, jsxs } from "react/jsx-runtime";
-var NexusContext = createContext2(nexus);
-var NexusLiveFeedContext = createContext2({
-  latestEvent: null,
-  isConnected: false
-});
-function NexusAnalyticsTracker({
-  disableAnalytics
-}) {
-  const pathname = usePathname();
-  const searchParams = useSearchParams();
-  const prevPathRef = useRef("");
-  const searchParamsString = searchParams.toString();
-  useEffect2(() => {
-    if (nexus.analytics && !disableAnalytics) {
-      nexus.analytics.pageView(prevPathRef.current || document.referrer);
-      prevPathRef.current = pathname;
-    }
-  }, [pathname, searchParamsString, disableAnalytics]);
-  return /* @__PURE__ */ jsx2("div", { id: "__nexus_react_active", style: { display: "none" } });
-}
-var NexusProvider = ({
-  children,
-  projectId,
-  disableAnalytics = false,
-  hasConsent = true,
-  // NEW: default true to preserve existing behaviour
-  enableLiveFeed = false,
-  // NEW
-  onLiveEvent
-  // NEW
-}) => {
-  const isInitialized = useRef(false);
-  const socketRef = useRef(null);
-  const [latestEvent, setLatestEvent] = useState2(
-    null
-  );
-  const [isConnected, setIsConnected] = useState2(false);
-  const liveFeedValue = useMemo(
-    () => ({ latestEvent, isConnected }),
-    [latestEvent, isConnected]
-  );
-  const config = useMemo(() => {
-    if (projectId && nexus.getConfig().projectId !== projectId) {
-      nexus.updateConfig({ projectId });
-    }
-    return nexus.getConfig();
-  }, [projectId]);
-  useEffect2(() => {
-    if (typeof window === "undefined" || disableAnalytics || !hasConsent)
-      return;
-    if (!isInitialized.current) {
-      if (!nexus.analytics) {
-        nexus.analytics = new AnalyticsEngine(nexus.getConfig());
-      }
-      nexus.analytics.start();
-      isInitialized.current = true;
-      if (nexus.getConfig().debug) {
-        console.log("[NexusHub] \u{1F680} Provider initialized analytics");
-      }
-    }
-    return () => {
-      if (nexus.analytics) {
-        nexus.analytics.stop();
-        isInitialized.current = false;
-      }
-    };
-  }, [disableAnalytics, hasConsent]);
-  const connectLiveFeed = useCallback2(async () => {
-    if (typeof window === "undefined" || !enableLiveFeed) return;
-    try {
-      const { io } = await import("socket.io-client");
-      const cfg = nexus.getConfig();
-      const wsUrl = cfg.apiUrl || "http://localhost:3001";
-      const socket = io(`${wsUrl}/analytics`, {
-        auth: { token: cfg.apiKey },
-        query: { projectId: cfg.projectId },
-        transports: ["websocket"],
-        reconnectionAttempts: 5,
-        reconnectionDelay: 2e3
-      });
-      socket.on("connect", () => {
-        setIsConnected(true);
-        if (cfg.debug) console.log("[NexusHub] \u{1F534} Live feed connected");
-      });
-      socket.on("disconnect", () => {
-        setIsConnected(false);
-        if (cfg.debug) console.log("[NexusHub] Live feed disconnected");
-      });
-      socket.on("live_event", (event) => {
-        setLatestEvent(event);
-        onLiveEvent?.(event);
-      });
-      socketRef.current = socket;
-    } catch (err) {
-      console.error("[NexusHub] Live feed connection failed:", err);
-    }
-  }, [enableLiveFeed, onLiveEvent]);
-  useEffect2(() => {
-    if (enableLiveFeed) {
-      connectLiveFeed();
-    }
-    return () => {
-      if (socketRef.current) {
-        socketRef.current.disconnect();
-        socketRef.current = null;
-        setIsConnected(false);
-      }
-    };
-  }, [enableLiveFeed, connectLiveFeed]);
-  return /* @__PURE__ */ jsx2(NexusContext.Provider, { value: nexus, children: /* @__PURE__ */ jsx2(NexusLiveFeedContext.Provider, { value: liveFeedValue, children: /* @__PURE__ */ jsxs(AuthProvider, { config, children: [
-    /* @__PURE__ */ jsx2(Suspense, { fallback: null, children: /* @__PURE__ */ jsx2(NexusAnalyticsTracker, { disableAnalytics }) }),
-    children
-  ] }) }) });
-};
-var useNexus = () => {
-  const context = React2.useContext(NexusContext);
-  if (!context) {
-    throw new Error("useNexus must be used within a NexusProvider");
-  }
-  return context;
-};
-
 // src/index.ts
 var VERSION = "0.0.1";
 export {
   AnalyticsEngine,
-  AuthProvider,
   BrowserCache,
   CacheTags,
   ContentEngine,
@@ -2603,14 +2470,11 @@ export {
   LocalCacheProxy as LocalCache,
   MemoryCache,
   NexusClient,
-  NexusProvider,
   VERSION,
   createNexusClient,
   getEnvConfig,
   getFullConfig,
   mergeConfigs,
   nexus,
-  useNexus,
-  useNexusAuth,
   validateConfig
 };