@nexushub/client 0.4.1 → 0.4.2

package/dist/index.d.cts

@@ -1,362 +1,7 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import React from 'react';
+export { A as AnalyticsEngine, a as AuthContextType, b as AuthError, c as AuthProvider, d as AuthState, C as CacheEntry, e as CacheMetadata, f as CollectionQuery, g as CollectionResponse, h as ContentEngine, i as ContentResponse, D as DEFAULT_ANALYTICS_URL, j as DEFAULT_API_URL, E as ErrorResponse, L as LOCAL_NEST_URL, k as LOCAL_RUST_URL, l as LoginCredentials, M as MinimalNexusConfig, N as NexusClient, m as NexusConfig, n as NexusProvider, o as NexusProviderProps, R as RegisterCredentials, S as SiteUser, p as createNexusClient, q as getEnvConfig, r as getFullConfig, s as mergeConfigs, t as nexus, u as useNexus, v as useNexusAuth, w as validateConfig } from './react-C795ypnM.cjs';
 import { I as ILocalCache } from './cache-types-B39iNHfE.cjs';
-
-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;
-}
-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;
-    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;
+import 'react/jsx-runtime';
+import 'react';
 
 /**
  * NexusHub Shared Cache Implementations
@@ -435,4 +80,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 { BrowserCache, CacheTags, LocalCacheProxy as LocalCache, MemoryCache, VERSION };