@nexushub/client 0.0.1 → 0.0.3

package/dist/{index.d.mts → src/index.d.mts}

@@ -6,6 +6,15 @@ interface MinimalNexusConfig {
     apiKey?: string;
     projectId?: string;
 }
+declare const DEFAULT_API_URL = "https://api.nexushub.com/v1";
+declare const DEFAULT_CDN_URL = "https://cdn.nexushub.com";
+declare const getEnvConfig: () => MinimalNexusConfig;
+declare const mergeConfigs: (base: MinimalNexusConfig, override: Partial<MinimalNexusConfig>) => MinimalNexusConfig;
+declare const hasRequiredConfig: (config: MinimalNexusConfig) => config is MinimalNexusConfig & {
+    projectId: string;
+};
+declare const getFullConfig: (partialConfig?: Partial<MinimalNexusConfig>) => MinimalNexusConfig;
+declare const validateConfig: (config: MinimalNexusConfig) => string[];
 
 interface NexusConfig extends MinimalNexusConfig {
     debug?: boolean;
@@ -78,13 +87,14 @@ declare class ContentEngine {
     private rateLimiter;
     private backoff;
     private requestBatcher;
+    private circuitBreaker;
     private defaultRevalidate;
     private cacheStrategy;
     private abortController?;
     private isServer;
     constructor(config: NexusConfig);
     /**
-     * Fetch a Singleton Page with enhanced caching
+     * Fetch a Single Page with full strategy pipeline
      */
     getPage<T = any>(slug: string, options?: {
         revalidate?: number;
@@ -94,7 +104,7 @@ declare class ContentEngine {
     }): Promise<T>;
     private _getPage;
     /**
-     * Fetch a Collection with advanced query capabilities
+     * Fetch a Collection (Optimized)
      */
     getCollection<T = any>(collectionId: string, query?: CollectionQuery, options?: {
         revalidate?: number;
@@ -112,7 +122,8 @@ declare class ContentEngine {
         forceRefresh?: boolean;
     }): Promise<T>;
     /**
-     * Fetch a single item from a collection
+     * 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;
@@ -135,6 +146,15 @@ declare class ContentEngine {
      * 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;
     /**
      * Invalidate cache by tags
      */
@@ -160,30 +180,77 @@ declare class ContentEngine {
             loaded: boolean;
         };
     };
-    /**
-     * Cancel ongoing requests
-     */
-    cancelRequests(): void;
-    /**
-     * Subscribe to content updates (SSE)
-     */
-    subscribeToUpdates(callback: (data: any) => void): () => void;
     private fetchPage;
     private fetchCollection;
-    private fetchWithTimeout;
     private applyLocalQuery;
-    private isCacheValid;
+    private fetchWithTimeout;
     private getHeaders;
+    private isCacheValid;
     private normalizeError;
+    /**
+     * Cancel ongoing requests
+     */
+    cancelRequests(): void;
     /**
      * Cleanup resources
      */
     private cleanup;
 }
 
+/**
+ * NexusHub Analytics Engine
+ * Orchestrates automatic event capture, performance monitoring, and user tracking.
+ */
+declare class AnalyticsEngine {
+    private tracker;
+    private cleanupFns;
+    private isInitialized;
+    constructor(config: NexusConfig);
+    start(): void;
+    pageView(): void;
+    private setupShareTracking;
+    /**
+     * 1. IDENTIFY: Link anonymous session to a User ID
+     */
+    identify(userId: string, traits?: Record<string, any>): Promise<boolean>;
+    /**
+     * 2. GROUP: Link the current user to a Company/Organization (B2B)
+     * Required for the /api/group Rust route.
+     */
+    group(groupId: string, traits?: Record<string, any>): Promise<boolean>;
+    /**
+     * 3. ALIAS: Merge two identities (e.g. "Guest_123" -> "User_99")
+     * Required for the /api/alias Rust route.
+     */
+    alias(newId: string): Promise<boolean>;
+    /**
+     * 4. RESET: Clear local data and (optionally) request GDPR scrub
+     */
+    reset(performGdprScrub?: boolean): void;
+    track(eventName: string, properties?: Record<string, any>): void;
+    trackPurchase(orderData: {
+        orderId: string;
+        total: number;
+        currency?: string;
+        products: Array<{
+            id: string;
+            price: number;
+            quantity: number;
+        }>;
+    }): void;
+    trackError(error: Error, context?: Record<string, any>): void;
+    private sendIdentityRequest;
+    private setupClickTracking;
+    private setupFormTracking;
+    private setupRouteTracking;
+    getSessionId(): string;
+    stop(): void;
+}
+
 declare class NexusClient {
     private config;
     content: ContentEngine;
+    analytics?: AnalyticsEngine;
     constructor(config?: Partial<NexusConfig>);
     getPage<T = any>(slug: string, options?: any): Promise<T>;
     getConfig(): Readonly<NexusConfig>;
@@ -199,16 +266,26 @@ declare const NexusProvider: ({ children, projectId }: {
 interface SiteUser {
     id: string;
     email: string;
-    name?: string;
+    username?: string;
+    firstName?: string;
+    lastName?: string;
     avatarUrl?: string;
     role: string;
-    metadata: Record<string, any>;
+    organizationId?: string;
+    organizationTraits?: Record<string, any>;
+    metadata?: Record<string, any>;
+    createdAt: string;
 }
 interface AuthState {
     user: SiteUser | null;
-    isLoading: boolean;
-    error: Error | null;
     isAuthenticated: boolean;
+    isLoading: boolean;
+    error: AuthError | null;
+}
+interface AuthError {
+    code: string;
+    message: string;
+    status: number;
 }
 interface LoginCredentials {
     email: string;
@@ -217,17 +294,23 @@ interface LoginCredentials {
 interface RegisterCredentials {
     email: string;
     password: string;
-    name?: 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>;
-    loginWithGoogle: () => 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;
 
 /**
@@ -310,47 +393,6 @@ declare class BrowserCache {
     private evictOldest;
 }
 
-/**
- * Advanced strategies for resilience and performance
- */
-interface RateLimiterConfig {
-    maxRequests: number;
-    timeWindow: number;
-}
-declare class RateLimiter {
-    private requests;
-    private config;
-    constructor(config: RateLimiterConfig);
-    checkLimit(): Promise<void>;
-    getStats(): {
-        currentRequests: number;
-        limit: number;
-    };
-}
-interface BackoffConfig {
-    maxRetries: number;
-    baseDelay: number;
-    maxDelay: number;
-    jitter?: boolean;
-}
-declare class ExponentialBackoff {
-    private config;
-    constructor(config: BackoffConfig);
-    execute<T>(fn: () => Promise<T>, onRetry?: (attempt: number, delay: number, error: Error) => void): Promise<T>;
-    private calculateDelay;
-    private isClientError;
-    private isRateLimitError;
-}
-declare class RequestBatcher {
-    private batchWindow;
-    private maxBatchSize;
-    private batch;
-    private batchTimeout?;
-    private processing;
-    constructor(batchWindow?: number, // milliseconds
-    maxBatchSize?: number);
-    schedule<T>(key: string, request: () => Promise<T>): Promise<T>;
-    private processBatch;
-}
+declare const VERSION = "0.0.1";
 
-export { type BackoffConfig, BrowserCache, type CacheEntry, type CacheMetadata, type CacheOptions, type CacheStats, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, type ErrorResponse, ExponentialBackoff, LocalCache, MemoryCache, NexusClient, type NexusConfig, NexusProvider, RateLimiter, type RateLimiterConfig, RequestBatcher, type SiteUser, createNexusClient, nexus, useNexusAuth };
+export { AnalyticsEngine, type AuthContextType, type AuthError, AuthProvider, type AuthState, BrowserCache, type CacheEntry, type CacheMetadata, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, DEFAULT_API_URL, DEFAULT_CDN_URL, type ErrorResponse, LocalCache, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, NexusProvider, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, hasRequiredConfig, mergeConfigs, nexus, useNexusAuth, validateConfig };

package/dist/{index.d.ts → src/index.d.ts}

@@ -6,6 +6,15 @@ interface MinimalNexusConfig {
     apiKey?: string;
     projectId?: string;
 }
+declare const DEFAULT_API_URL = "https://api.nexushub.com/v1";
+declare const DEFAULT_CDN_URL = "https://cdn.nexushub.com";
+declare const getEnvConfig: () => MinimalNexusConfig;
+declare const mergeConfigs: (base: MinimalNexusConfig, override: Partial<MinimalNexusConfig>) => MinimalNexusConfig;
+declare const hasRequiredConfig: (config: MinimalNexusConfig) => config is MinimalNexusConfig & {
+    projectId: string;
+};
+declare const getFullConfig: (partialConfig?: Partial<MinimalNexusConfig>) => MinimalNexusConfig;
+declare const validateConfig: (config: MinimalNexusConfig) => string[];
 
 interface NexusConfig extends MinimalNexusConfig {
     debug?: boolean;
@@ -78,13 +87,14 @@ declare class ContentEngine {
     private rateLimiter;
     private backoff;
     private requestBatcher;
+    private circuitBreaker;
     private defaultRevalidate;
     private cacheStrategy;
     private abortController?;
     private isServer;
     constructor(config: NexusConfig);
     /**
-     * Fetch a Singleton Page with enhanced caching
+     * Fetch a Single Page with full strategy pipeline
      */
     getPage<T = any>(slug: string, options?: {
         revalidate?: number;
@@ -94,7 +104,7 @@ declare class ContentEngine {
     }): Promise<T>;
     private _getPage;
     /**
-     * Fetch a Collection with advanced query capabilities
+     * Fetch a Collection (Optimized)
      */
     getCollection<T = any>(collectionId: string, query?: CollectionQuery, options?: {
         revalidate?: number;
@@ -112,7 +122,8 @@ declare class ContentEngine {
         forceRefresh?: boolean;
     }): Promise<T>;
     /**
-     * Fetch a single item from a collection
+     * 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;
@@ -135,6 +146,15 @@ declare class ContentEngine {
      * 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;
     /**
      * Invalidate cache by tags
      */
@@ -160,30 +180,77 @@ declare class ContentEngine {
             loaded: boolean;
         };
     };
-    /**
-     * Cancel ongoing requests
-     */
-    cancelRequests(): void;
-    /**
-     * Subscribe to content updates (SSE)
-     */
-    subscribeToUpdates(callback: (data: any) => void): () => void;
     private fetchPage;
     private fetchCollection;
-    private fetchWithTimeout;
     private applyLocalQuery;
-    private isCacheValid;
+    private fetchWithTimeout;
     private getHeaders;
+    private isCacheValid;
     private normalizeError;
+    /**
+     * Cancel ongoing requests
+     */
+    cancelRequests(): void;
     /**
      * Cleanup resources
      */
     private cleanup;
 }
 
+/**
+ * NexusHub Analytics Engine
+ * Orchestrates automatic event capture, performance monitoring, and user tracking.
+ */
+declare class AnalyticsEngine {
+    private tracker;
+    private cleanupFns;
+    private isInitialized;
+    constructor(config: NexusConfig);
+    start(): void;
+    pageView(): void;
+    private setupShareTracking;
+    /**
+     * 1. IDENTIFY: Link anonymous session to a User ID
+     */
+    identify(userId: string, traits?: Record<string, any>): Promise<boolean>;
+    /**
+     * 2. GROUP: Link the current user to a Company/Organization (B2B)
+     * Required for the /api/group Rust route.
+     */
+    group(groupId: string, traits?: Record<string, any>): Promise<boolean>;
+    /**
+     * 3. ALIAS: Merge two identities (e.g. "Guest_123" -> "User_99")
+     * Required for the /api/alias Rust route.
+     */
+    alias(newId: string): Promise<boolean>;
+    /**
+     * 4. RESET: Clear local data and (optionally) request GDPR scrub
+     */
+    reset(performGdprScrub?: boolean): void;
+    track(eventName: string, properties?: Record<string, any>): void;
+    trackPurchase(orderData: {
+        orderId: string;
+        total: number;
+        currency?: string;
+        products: Array<{
+            id: string;
+            price: number;
+            quantity: number;
+        }>;
+    }): void;
+    trackError(error: Error, context?: Record<string, any>): void;
+    private sendIdentityRequest;
+    private setupClickTracking;
+    private setupFormTracking;
+    private setupRouteTracking;
+    getSessionId(): string;
+    stop(): void;
+}
+
 declare class NexusClient {
     private config;
     content: ContentEngine;
+    analytics?: AnalyticsEngine;
     constructor(config?: Partial<NexusConfig>);
     getPage<T = any>(slug: string, options?: any): Promise<T>;
     getConfig(): Readonly<NexusConfig>;
@@ -199,16 +266,26 @@ declare const NexusProvider: ({ children, projectId }: {
 interface SiteUser {
     id: string;
     email: string;
-    name?: string;
+    username?: string;
+    firstName?: string;
+    lastName?: string;
     avatarUrl?: string;
     role: string;
-    metadata: Record<string, any>;
+    organizationId?: string;
+    organizationTraits?: Record<string, any>;
+    metadata?: Record<string, any>;
+    createdAt: string;
 }
 interface AuthState {
     user: SiteUser | null;
-    isLoading: boolean;
-    error: Error | null;
     isAuthenticated: boolean;
+    isLoading: boolean;
+    error: AuthError | null;
+}
+interface AuthError {
+    code: string;
+    message: string;
+    status: number;
 }
 interface LoginCredentials {
     email: string;
@@ -217,17 +294,23 @@ interface LoginCredentials {
 interface RegisterCredentials {
     email: string;
     password: string;
-    name?: 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>;
-    loginWithGoogle: () => 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;
 
 /**
@@ -310,47 +393,6 @@ declare class BrowserCache {
     private evictOldest;
 }
 
-/**
- * Advanced strategies for resilience and performance
- */
-interface RateLimiterConfig {
-    maxRequests: number;
-    timeWindow: number;
-}
-declare class RateLimiter {
-    private requests;
-    private config;
-    constructor(config: RateLimiterConfig);
-    checkLimit(): Promise<void>;
-    getStats(): {
-        currentRequests: number;
-        limit: number;
-    };
-}
-interface BackoffConfig {
-    maxRetries: number;
-    baseDelay: number;
-    maxDelay: number;
-    jitter?: boolean;
-}
-declare class ExponentialBackoff {
-    private config;
-    constructor(config: BackoffConfig);
-    execute<T>(fn: () => Promise<T>, onRetry?: (attempt: number, delay: number, error: Error) => void): Promise<T>;
-    private calculateDelay;
-    private isClientError;
-    private isRateLimitError;
-}
-declare class RequestBatcher {
-    private batchWindow;
-    private maxBatchSize;
-    private batch;
-    private batchTimeout?;
-    private processing;
-    constructor(batchWindow?: number, // milliseconds
-    maxBatchSize?: number);
-    schedule<T>(key: string, request: () => Promise<T>): Promise<T>;
-    private processBatch;
-}
+declare const VERSION = "0.0.1";
 
-export { type BackoffConfig, BrowserCache, type CacheEntry, type CacheMetadata, type CacheOptions, type CacheStats, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, type ErrorResponse, ExponentialBackoff, LocalCache, MemoryCache, NexusClient, type NexusConfig, NexusProvider, RateLimiter, type RateLimiterConfig, RequestBatcher, type SiteUser, createNexusClient, nexus, useNexusAuth };
+export { AnalyticsEngine, type AuthContextType, type AuthError, AuthProvider, type AuthState, BrowserCache, type CacheEntry, type CacheMetadata, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, DEFAULT_API_URL, DEFAULT_CDN_URL, type ErrorResponse, LocalCache, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, NexusProvider, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, hasRequiredConfig, mergeConfigs, nexus, useNexusAuth, validateConfig };