@nexushub/client 0.4.0 → 0.4.2

package/dist/react-C795ypnM.d.ts

@@ -0,0 +1,386 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+
+interface MinimalNexusConfig {
+    apiUrl?: string;
+    analyticsUrl?: string;
+    apiKey?: string;
+    projectId?: string;
+}
+declare const DEFAULT_API_URL = "https://endpoints.gnexus.co.tz";
+declare const DEFAULT_ANALYTICS_URL = "https://sentry.gnexus.co.tz";
+declare const LOCAL_NEST_URL = "https://endpoints.gnexus.co.tz";
+declare const LOCAL_RUST_URL = "https://sentry.gnexus.co.tz";
+declare const getEnvConfig: () => MinimalNexusConfig;
+declare const mergeConfigs: (base: MinimalNexusConfig, override: Partial<MinimalNexusConfig>) => MinimalNexusConfig;
+declare const getFullConfig: (partialConfig?: Partial<MinimalNexusConfig>) => MinimalNexusConfig;
+declare const validateConfig: (config: MinimalNexusConfig) => string[];
+
+interface NexusConfig extends MinimalNexusConfig {
+    debug?: boolean;
+    cacheStrategy?: 'memory' | 'localStorage' | 'none';
+    revalidateTime?: number;
+    timeout?: number;
+    retries?: number;
+}
+interface NexusConfig {
+    projectId: string;
+    apiUrl: string;
+}
+interface ContentResponse<T = any> {
+    id: string;
+    type: string;
+    data: T;
+    meta: {
+        version: number;
+        updatedAt: string;
+        locale?: string;
+        cacheStatus: 'hit' | 'miss' | 'stale';
+    };
+}
+interface CollectionResponse<T = any> {
+    items: T[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+    meta?: {
+        fetchedAt: string;
+        cacheStatus: string;
+        filters?: Record<string, any>;
+    };
+}
+interface CacheMetadata {
+    timestamp: number;
+    etag?: string;
+    expiresAt: number;
+    tags: string[];
+}
+interface CacheEntry<T = any> {
+    data: T;
+    metadata: CacheMetadata;
+}
+interface CollectionQuery {
+    page?: number;
+    limit?: number;
+    sort?: string;
+    order?: 'asc' | 'desc';
+    filter?: Record<string, any>;
+    fields?: string[];
+    search?: string;
+    include?: string[];
+}
+interface ErrorResponse {
+    code: string;
+    message: string;
+    details?: any;
+    timestamp: string;
+}
+
+declare class ContentEngine {
+    private config;
+    private localCache;
+    private memoryCache;
+    private browserCache?;
+    private rateLimiter;
+    private backoff;
+    private requestBatcher;
+    private circuitBreaker;
+    private defaultRevalidate;
+    private cacheStrategy;
+    private abortController?;
+    private isServer;
+    constructor(config: NexusConfig);
+    /**
+     * Fetch a Single Page with full strategy pipeline
+     */
+    getPage<T = any>(slug: string, options?: {
+        revalidate?: number;
+        tags?: string[];
+        forceRefresh?: boolean;
+        includeMetadata?: boolean;
+    }): Promise<T>;
+    private _getPage;
+    /**
+     * Fetch a Collection (Optimized)
+     */
+    getCollection<T = any>(collectionId: string, query?: CollectionQuery, options?: {
+        revalidate?: number;
+        tags?: string[];
+        forceRefresh?: boolean;
+        includeMetadata?: boolean;
+    }): Promise<CollectionResponse<T>>;
+    private _getCollection;
+    /**
+     * Fetch Global Settings with nested includes support
+     */
+    getGlobals<T = any>(options?: {
+        include?: string[];
+        revalidate?: number;
+        forceRefresh?: boolean;
+    }): Promise<T>;
+    /**
+     * Get a single item from a collection (Uses Request Batching)
+     * If you call this 10 times in a loop, it sends 1 HTTP request.
+     */
+    getItem<T = any>(collectionId: string, itemId: string, options?: {
+        revalidate?: number;
+        tags?: string[];
+        include?: string[];
+    }): Promise<T>;
+    /**
+     * Search across collections
+     */
+    search<T = any>(query: string, options?: {
+        collections?: string[];
+        fields?: string[];
+        limit?: number;
+        revalidate?: number;
+    }): Promise<{
+        results: T[];
+        total: number;
+    }>;
+    /**
+     * Prefetch content for better performance
+     */
+    prefetch(urls: string[]): Promise<void>;
+    /**
+     * Robust Real-time Subscriptions (SSE) with Auto-Reconnect
+     */
+    subscribeToUpdates(callback: (data: any) => void): () => void;
+    /**
+     * Check all caches in order of speed
+     */
+    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
+     */
+    invalidateCache(tags: string[]): void;
+    /**
+     * Clear all caches
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        memory: {
+            size: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        browser: {
+            size: number;
+        } | null;
+        local: {
+            loaded: boolean;
+        };
+    };
+    private fetchPage;
+    private fetchCollection;
+    private applyLocalQuery;
+    private fetchWithTimeout;
+    private getHeaders;
+    private isCacheValid;
+    private normalizeError;
+    /**
+     * Cancel ongoing requests
+     */
+    cancelRequests(): void;
+    /**
+     * Cleanup resources
+     */
+    private cleanup;
+}
+
+declare class AnalyticsEngine {
+    private tracker;
+    private cleanupFns;
+    private isInitialized;
+    private maxScrollDepth;
+    private scrollThresholdsFired;
+    private scrollTimer?;
+    constructor(config: NexusConfig);
+    start(): void;
+    private lastPath;
+    pageView(customReferrer?: string): void;
+    private setupShareTracking;
+    private setupScrollTracking;
+    private clickBuffer;
+    private setupClickTracking;
+    private setupFormTracking;
+    private setupOutboundTracking;
+    private setupVideoTracking;
+    private setupErrorTracking;
+    private setupRouteTracking;
+    private isInitializedByReactProvider;
+    identify(userId: string, traits?: Record<string, any>): Promise<boolean>;
+    group(groupId: string, traits?: Record<string, any>): Promise<boolean>;
+    alias(newId: string): Promise<boolean>;
+    reset(performGdprScrub?: boolean): void;
+    track(eventName: string, properties?: Record<string, any>): void;
+    trackPurchase(orderData: {
+        orderId: string;
+        total: number;
+        revenue?: number;
+        currency?: string;
+        products: Array<{
+            id: string;
+            name: string;
+            price: number;
+            quantity: number;
+            sku?: string;
+        }>;
+    }): void;
+    trackError(error: Error, context?: Record<string, any>): void;
+    private sendIdentityRequest;
+    getSessionId(): string;
+    stop(isFinalShutdown?: boolean): void;
+}
+
+declare class NexusClient {
+    private config;
+    content: ContentEngine;
+    analytics?: AnalyticsEngine;
+    constructor(config?: Partial<NexusConfig>);
+    /**
+     * Helper alias for cleaner content fetching.
+     */
+    getPage<T = any>(slug: string, options?: any): Promise<T>;
+    /**
+     * Returns a readonly snapshot of the current config.
+     */
+    getConfig(): Readonly<NexusConfig>;
+    /**
+     * Updates specific config fields at runtime.
+     * Replaces the previous pattern of `(nexus as any).config.projectId = x`
+     * which bypassed TypeScript and mutated internal state unsafely.
+     */
+    updateConfig(updates: Partial<NexusConfig>): void;
+}
+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;
+}
+interface LiveFeedContextValue {
+    latestEvent: LiveAnalyticsEvent | null;
+    isConnected: boolean;
+}
+declare const useNexusLiveFeed: () => LiveFeedContextValue;
+declare const NexusProvider: ({ children, projectId, disableAnalytics, hasConsent, enableLiveFeed, onLiveEvent, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
+declare const useNexus: () => NexusClient;
+declare const useNexusAnalytics: () => {
+    track: (eventName: string, properties?: Record<string, any>) => void;
+    identify: (userId: string, traits?: Record<string, any>) => Promise<boolean>;
+    group: (groupId: string, traits?: Record<string, any>) => Promise<boolean>;
+    alias: (newId: string) => Promise<boolean>;
+    trackPurchase: (orderData: {
+        orderId: string;
+        total: number;
+        revenue?: number;
+        currency?: string;
+        products: Array<{
+            id: string;
+            name: string;
+            price: number;
+            quantity: number;
+            sku?: string;
+        }>;
+    }) => void;
+    trackError: (error: Error, context?: Record<string, any>) => void;
+    reset: (performGdprScrub?: boolean) => void;
+};
+
+interface SiteUser {
+    id: string;
+    email: string;
+    username?: string;
+    firstName?: string;
+    lastName?: string;
+    avatarUrl?: string;
+    role: string;
+    organizationId?: string;
+    organizationTraits?: Record<string, any>;
+    metadata?: Record<string, any>;
+    createdAt: string;
+}
+interface AuthState {
+    user: SiteUser | null;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    error: AuthError | null;
+}
+interface AuthError {
+    code: string;
+    message: string;
+    status: number;
+}
+interface LoginCredentials {
+    email: string;
+    password: string;
+}
+interface RegisterCredentials {
+    email: string;
+    password: string;
+    username?: string;
+    firstName?: string;
+    lastName?: string;
+    metadata?: Record<string, any>;
+}
+interface AuthContextType extends AuthState {
+    login: (creds: LoginCredentials) => Promise<void>;
+    register: (creds: RegisterCredentials) => Promise<void>;
+    logout: () => Promise<void>;
+    updateProfile: (data: Partial<SiteUser>) => Promise<void>;
+    requestPasswordReset: (email: string) => Promise<void>;
+}
+
+declare const AuthProvider: ({ children, config, }: {
+    children: React.ReactNode;
+    config: NexusConfig;
+}) => react_jsx_runtime.JSX.Element;
+declare const useNexusAuth: () => AuthContextType;
+
+export { AnalyticsEngine as A, type CacheEntry as C, DEFAULT_ANALYTICS_URL as D, type ErrorResponse as E, LOCAL_NEST_URL as L, type MinimalNexusConfig as M, NexusClient as N, type RegisterCredentials as R, type SiteUser as S, type AuthContextType as a, type AuthError as b, AuthProvider as c, type AuthState as d, type CacheMetadata as e, type CollectionQuery as f, type CollectionResponse as g, ContentEngine as h, type ContentResponse as i, DEFAULT_API_URL as j, LOCAL_RUST_URL as k, type LoginCredentials as l, type NexusConfig as m, NexusProvider as n, type NexusProviderProps as o, createNexusClient as p, getEnvConfig as q, getFullConfig as r, mergeConfigs as s, nexus as t, useNexus as u, useNexusAuth as v, validateConfig as w, useNexusAnalytics as x, useNexusLiveFeed as y };

package/dist/react.cjs

@@ -0,0 +1,17 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+
+
+
+
+
+
+
+var _chunkFMMFQP5Ocjs = require('./chunk-FMMFQP5O.cjs');
+
+
+
+
+
+
+
+exports.AuthProvider = _chunkFMMFQP5Ocjs.AuthProvider; exports.NexusProvider = _chunkFMMFQP5Ocjs.NexusProvider; exports.useNexus = _chunkFMMFQP5Ocjs.useNexus; exports.useNexusAnalytics = _chunkFMMFQP5Ocjs.useNexusAnalytics; exports.useNexusAuth = _chunkFMMFQP5Ocjs.useNexusAuth; exports.useNexusLiveFeed = _chunkFMMFQP5Ocjs.useNexusLiveFeed;

package/dist/react.d.cts

@@ -0,0 +1,3 @@
+export { c as AuthProvider, n as NexusProvider, u as useNexus, x as useNexusAnalytics, v as useNexusAuth, y as useNexusLiveFeed } from './react-C795ypnM.cjs';
+import 'react/jsx-runtime';
+import 'react';

package/dist/react.d.ts

@@ -0,0 +1,3 @@
+export { c as AuthProvider, n as NexusProvider, u as useNexus, x as useNexusAnalytics, v as useNexusAuth, y as useNexusLiveFeed } from './react-C795ypnM.js';
+import 'react/jsx-runtime';
+import 'react';

package/dist/react.js

@@ -0,0 +1,17 @@
+"use client";
+import {
+  AuthProvider,
+  NexusProvider,
+  useNexus,
+  useNexusAnalytics,
+  useNexusAuth,
+  useNexusLiveFeed
+} from "./chunk-G4SHBWAQ.js";
+export {
+  AuthProvider,
+  NexusProvider,
+  useNexus,
+  useNexusAnalytics,
+  useNexusAuth,
+  useNexusLiveFeed
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nexushub/client",
   "private": false,
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "The God-Tier NexusHub SDK",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -11,7 +11,21 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs",
+      "default": "./dist/react.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "react": [
+        "./dist/react.d.ts"
+      ]
     }
   },
   "bin": {