@nexushub/client 0.2.7 → 0.2.9

package/dist/index.cjs

@@ -1897,6 +1897,12 @@ var nexus = new NexusClient();
 var createNexusClient = (config) => new NexusClient(config);
 
 // src/components/NexusProvider.tsx
+
+
+
+
+
+
 var _react = require('react'); var _react2 = _interopRequireDefault(_react);
 var _navigation = require('next/navigation');
 
@@ -2098,14 +2104,24 @@ async function parseError(res) {
 // src/components/NexusProvider.tsx
 
 var NexusContext = _react.createContext.call(void 0, nexus);
+function NexusAnalyticsTracker({
+  disableAnalytics
+}) {
+  const pathname = _navigation.usePathname.call(void 0, );
+  const searchParams = _navigation.useSearchParams.call(void 0, );
+  const searchParamsString = searchParams.toString();
+  _react.useEffect.call(void 0, () => {
+    if (nexus.analytics && !disableAnalytics) {
+      nexus.analytics.pageView();
+    }
+  }, [pathname, searchParamsString, disableAnalytics]);
+  return null;
+}
 var NexusProvider = ({
   children,
   projectId,
   disableAnalytics = false
 }) => {
-  const pathname = _navigation.usePathname.call(void 0, );
-  const searchParams = _navigation.useSearchParams.call(void 0, );
-  const searchParamsString = searchParams.toString();
   const isInitialized = _react.useRef.call(void 0, false);
   const config = _react.useMemo.call(void 0, () => {
     if (projectId && nexus.getConfig().projectId !== projectId) {
@@ -2132,12 +2148,17 @@ var NexusProvider = ({
       }
     };
   }, [disableAnalytics]);
-  _react.useEffect.call(void 0, () => {
-    if (nexus.analytics && !disableAnalytics) {
-      nexus.analytics.pageView();
-    }
-  }, [pathname, searchParamsString, disableAnalytics]);
-  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, NexusContext.Provider, { value: nexus, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, AuthProvider, { config, children }) });
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, NexusContext.Provider, { value: nexus, children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, AuthProvider, { config, children: [
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _react.Suspense, { fallback: null, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, NexusAnalyticsTracker, { disableAnalytics }) }),
+    children
+  ] }) });
+};
+var useNexus = () => {
+  const context = _react2.default.useContext(NexusContext);
+  if (!context) {
+    throw new Error("useNexus must be used within a NexusProvider");
+  }
+  return context;
 };
 
 // src/index.ts
@@ -2164,4 +2185,5 @@ var VERSION = "0.0.1";
 
 
 
-exports.AnalyticsEngine = AnalyticsEngine; exports.AuthProvider = AuthProvider; exports.BrowserCache = BrowserCache; exports.CacheTags = CacheTags; exports.ContentEngine = ContentEngine; exports.DEFAULT_ANALYTICS_URL = DEFAULT_ANALYTICS_URL; exports.DEFAULT_API_URL = DEFAULT_API_URL; exports.LOCAL_NEST_URL = LOCAL_NEST_URL; exports.LOCAL_RUST_URL = LOCAL_RUST_URL; exports.LocalCache = LocalCacheProxy; exports.MemoryCache = MemoryCache; exports.NexusClient = NexusClient; exports.NexusProvider = NexusProvider; exports.VERSION = VERSION; exports.createNexusClient = createNexusClient; exports.getEnvConfig = getEnvConfig; exports.getFullConfig = getFullConfig; exports.mergeConfigs = mergeConfigs; exports.nexus = nexus; exports.useNexusAuth = useNexusAuth; exports.validateConfig = validateConfig;
+
+exports.AnalyticsEngine = AnalyticsEngine; exports.AuthProvider = AuthProvider; exports.BrowserCache = BrowserCache; exports.CacheTags = CacheTags; exports.ContentEngine = ContentEngine; exports.DEFAULT_ANALYTICS_URL = DEFAULT_ANALYTICS_URL; exports.DEFAULT_API_URL = DEFAULT_API_URL; exports.LOCAL_NEST_URL = LOCAL_NEST_URL; exports.LOCAL_RUST_URL = LOCAL_RUST_URL; exports.LocalCache = LocalCacheProxy; exports.MemoryCache = MemoryCache; exports.NexusClient = NexusClient; exports.NexusProvider = NexusProvider; exports.VERSION = VERSION; exports.createNexusClient = createNexusClient; exports.getEnvConfig = getEnvConfig; exports.getFullConfig = getFullConfig; exports.mergeConfigs = mergeConfigs; exports.nexus = nexus; exports.useNexus = useNexus; exports.useNexusAuth = useNexusAuth; exports.validateConfig = validateConfig;

package/dist/index.d.cts

@@ -285,8 +285,20 @@ interface NexusProviderProps {
  * NexusHub Provider.
  * Manages the Analytics lifecycle, automates page view tracking on route
  * changes, and exposes the NexusClient singleton via React Context.
+ *
+ * Usage in app/layout.tsx:
+ *
+ *   <NexusProvider projectId="your_id">
+ *     {children}
+ *   </NexusProvider>
+ *
+ * No manual <Suspense> wrapper needed — the provider handles it internally.
  */
 declare const NexusProvider: ({ children, projectId, disableAnalytics, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Access the raw NexusClient instance from any component inside the provider.
+ */
+declare const useNexus: () => NexusClient;
 
 interface SiteUser {
     id: string;
@@ -415,4 +427,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 RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, useNexusAuth, validateConfig };
+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 };

package/dist/index.d.ts

@@ -285,8 +285,20 @@ interface NexusProviderProps {
  * NexusHub Provider.
  * Manages the Analytics lifecycle, automates page view tracking on route
  * changes, and exposes the NexusClient singleton via React Context.
+ *
+ * Usage in app/layout.tsx:
+ *
+ *   <NexusProvider projectId="your_id">
+ *     {children}
+ *   </NexusProvider>
+ *
+ * No manual <Suspense> wrapper needed — the provider handles it internally.
  */
 declare const NexusProvider: ({ children, projectId, disableAnalytics, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Access the raw NexusClient instance from any component inside the provider.
+ */
+declare const useNexus: () => NexusClient;
 
 interface SiteUser {
     id: string;
@@ -415,4 +427,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 RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, useNexusAuth, validateConfig };
+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 };

package/dist/index.js

@@ -1897,7 +1897,13 @@ var nexus = new NexusClient();
 var createNexusClient = (config) => new NexusClient(config);
 
 // src/components/NexusProvider.tsx
-import React2, { createContext as createContext2, useEffect as useEffect2, useRef, useMemo } from "react";
+import React2, {
+  createContext as createContext2,
+  useEffect as useEffect2,
+  useRef,
+  useMemo,
+  Suspense
+} from "react";
 import { usePathname, useSearchParams } from "next/navigation";
 
 // src/auth/context.tsx
@@ -2096,16 +2102,26 @@ async function parseError(res) {
 }
 
 // src/components/NexusProvider.tsx
-import { jsx as jsx2 } from "react/jsx-runtime";
+import { jsx as jsx2, jsxs } from "react/jsx-runtime";
 var NexusContext = createContext2(nexus);
+function NexusAnalyticsTracker({
+  disableAnalytics
+}) {
+  const pathname = usePathname();
+  const searchParams = useSearchParams();
+  const searchParamsString = searchParams.toString();
+  useEffect2(() => {
+    if (nexus.analytics && !disableAnalytics) {
+      nexus.analytics.pageView();
+    }
+  }, [pathname, searchParamsString, disableAnalytics]);
+  return null;
+}
 var NexusProvider = ({
   children,
   projectId,
   disableAnalytics = false
 }) => {
-  const pathname = usePathname();
-  const searchParams = useSearchParams();
-  const searchParamsString = searchParams.toString();
   const isInitialized = useRef(false);
   const config = useMemo(() => {
     if (projectId && nexus.getConfig().projectId !== projectId) {
@@ -2132,12 +2148,17 @@ var NexusProvider = ({
       }
     };
   }, [disableAnalytics]);
-  useEffect2(() => {
-    if (nexus.analytics && !disableAnalytics) {
-      nexus.analytics.pageView();
-    }
-  }, [pathname, searchParamsString, disableAnalytics]);
-  return /* @__PURE__ */ jsx2(NexusContext.Provider, { value: nexus, children: /* @__PURE__ */ jsx2(AuthProvider, { config, children }) });
+  return /* @__PURE__ */ jsx2(NexusContext.Provider, { value: nexus, 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
@@ -2162,6 +2183,7 @@ export {
   getFullConfig,
   mergeConfigs,
   nexus,
+  useNexus,
   useNexusAuth,
   validateConfig
 };

package/package.json

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