@nexushub/client 1.1.6 → 1.1.8

package/dist/index.d.cts

@@ -1,5 +1,69 @@
 import { I as ILocalCache } from './cache-types-B39iNHfE.cjs';
 
+/**
+ * NexusHub Shared Cache Implementations
+ *
+ * Contains MemoryCache (LRU) and BrowserCache (LocalStorage)
+ * which are safe for universal usage.
+ */
+interface CacheOptions {
+    maxSize?: number;
+    ttl?: number;
+    /** false means platform-controlled immutable cache. */
+    revalidate?: number | false;
+    tags?: string[];
+}
+interface CacheStats {
+    size: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    evictions: number;
+}
+declare const CacheTags: {
+    project: (projectId: string) => string;
+    content: (slug: string) => string;
+    collection: (collectionId: string) => string;
+    global: string;
+    user: (userId: string) => string;
+    media: (mediaId: string) => string;
+};
+declare class MemoryCache {
+    private cache;
+    private tagIndex;
+    private stats;
+    private maxSize;
+    private defaultTTL;
+    constructor(options?: CacheOptions);
+    set<T = any>(key: string, data: T, options?: CacheOptions): void;
+    get<T = any>(key: string): {
+        data: T;
+        metadata: any;
+    } | null;
+    delete(key: string): boolean;
+    invalidateByTags(tags: string[]): void;
+    clear(): void;
+    getStats(): CacheStats;
+    private evictLRU;
+    private calculateSize;
+    private updateHitRate;
+}
+declare class BrowserCache {
+    private projectId;
+    private prefix;
+    private maxSize;
+    private currentSize;
+    constructor(projectId: string);
+    set<T = any>(key: string, data: T, ttl?: number): void;
+    get<T = any>(key: string): T | null;
+    delete(key: string): void;
+    clear(): void;
+    private getStorageKey;
+    private calculateCurrentSize;
+    private calculateStorageSize;
+    private evictOldest;
+}
+
 interface MinimalNexusConfig {
     apiUrl?: string;
     analyticsUrl?: string;
@@ -122,14 +186,9 @@ declare class ContentEngine {
     private circuitBreaker;
     private defaultRevalidate;
     private cacheStrategy;
-    private abortController?;
     private isServer;
     constructor(config: NexusConfig);
-    /** Update runtime configuration without exposing internal mutation. */
     updateConfig(config: NexusConfig): void;
-    /**
-     * Fetch a Single Page with full strategy pipeline
-     */
     getPage<T = any>(slug: string, options?: {
         revalidate?: number | false;
         tags?: string[];
@@ -137,67 +196,41 @@ declare class ContentEngine {
         includeMetadata?: boolean;
     }): Promise<T>;
     private _getPage;
-    /**
-     * Fetch a Collection (Optimized)
-     */
     getCollection<T = any>(collectionId: string, query?: CollectionQuery, options?: {
         revalidate?: number | false;
         tags?: string[];
         forceRefresh?: boolean;
         includeMetadata?: boolean;
     }): Promise<CollectionResponse<T>>;
-    private _getCollection;
-    /**
-     * Fetch Global Settings
-     */
     getGlobals<T = any>(options?: {
         include?: string[];
         revalidate?: number | false;
         forceRefresh?: boolean;
         tags?: string[];
     }): Promise<T>;
-    /**
-     * Get a single item from a collection (Uses Request Batching)
-     */
     getItem<T = any>(collectionId: string, itemId: string, options?: {
         revalidate?: number | false;
         tags?: string[];
         include?: string[];
+        forceRefresh?: boolean;
     }): Promise<T>;
-    /**
-     * Search across collections
-     */
     search<T = any>(query: string, options?: {
         collections?: string[];
         fields?: string[];
         limit?: number;
         revalidate?: number | false;
+        forceRefresh?: boolean;
     }): Promise<{
         results: T[];
         total: number;
     }>;
-    /**
-     * Prefetch content
-     */
     prefetch(urls: string[]): Promise<void>;
-    /**
-     * Robust Real-time Subscriptions (SSE) with Auto-Reconnect
-     */
     subscribeToUpdates(callback: (data: any) => void): () => void;
-    private checkCaches;
     private writeCache;
     invalidateCache(tags: string[]): void;
     clearCache(): void;
     getCacheStats(): {
-        memory: {
-            size: number;
-            hits: number;
-            misses: number;
-            hitRate: number;
-        };
-        browser: {
-            size: number;
-        } | null;
+        memory: CacheStats;
         local: {
             loaded: boolean;
         };
@@ -208,12 +241,7 @@ declare class ContentEngine {
     private fetchWithTimeout;
     private getHeaders;
     private isCacheValid;
-    /**
-     * 🛡️ FIX: Normalizes timeout errors (AbortError, 408, or Timeout messages)
-     * into clean, standardized "Request timeout" errors.
-     */
     private normalizeError;
-    cancelRequests(): void;
     cleanup(): void;
 }
 
@@ -384,15 +412,7 @@ declare class NexusClient {
      */
     diagnostics(): {
         cache: {
-            memory: {
-                size: number;
-                hits: number;
-                misses: number;
-                hitRate: number;
-            };
-            browser: {
-                size: number;
-            } | null;
+            memory: CacheStats;
             local: {
                 loaded: boolean;
             };
@@ -485,70 +505,6 @@ interface AuthContextType extends AuthState {
     requestPasswordReset: (email: string) => Promise<void>;
 }
 
-/**
- * NexusHub Shared Cache Implementations
- *
- * Contains MemoryCache (LRU) and BrowserCache (LocalStorage)
- * which are safe for universal usage.
- */
-interface CacheOptions {
-    maxSize?: number;
-    ttl?: number;
-    /** false means platform-controlled immutable cache. */
-    revalidate?: number | false;
-    tags?: string[];
-}
-interface CacheStats {
-    size: number;
-    hits: number;
-    misses: number;
-    hitRate: number;
-    evictions: number;
-}
-declare const CacheTags: {
-    project: (projectId: string) => string;
-    content: (slug: string) => string;
-    collection: (collectionId: string) => string;
-    global: string;
-    user: (userId: string) => string;
-    media: (mediaId: string) => string;
-};
-declare class MemoryCache {
-    private cache;
-    private tagIndex;
-    private stats;
-    private maxSize;
-    private defaultTTL;
-    constructor(options?: CacheOptions);
-    set<T = any>(key: string, data: T, options?: CacheOptions): void;
-    get<T = any>(key: string): {
-        data: T;
-        metadata: any;
-    } | null;
-    delete(key: string): boolean;
-    invalidateByTags(tags: string[]): void;
-    clear(): void;
-    getStats(): CacheStats;
-    private evictLRU;
-    private calculateSize;
-    private updateHitRate;
-}
-declare class BrowserCache {
-    private projectId;
-    private prefix;
-    private maxSize;
-    private currentSize;
-    constructor(projectId: string);
-    set<T = any>(key: string, data: T, ttl?: number): void;
-    get<T = any>(key: string): T | null;
-    delete(key: string): void;
-    clear(): void;
-    private getStorageKey;
-    private calculateCurrentSize;
-    private calculateStorageSize;
-    private evictOldest;
-}
-
 declare class LocalCacheProxy implements ILocalCache {
     private instance;
     private cachePath?;

package/dist/index.d.ts

@@ -1,5 +1,69 @@
 import { I as ILocalCache } from './cache-types-B39iNHfE.js';
 
+/**
+ * NexusHub Shared Cache Implementations
+ *
+ * Contains MemoryCache (LRU) and BrowserCache (LocalStorage)
+ * which are safe for universal usage.
+ */
+interface CacheOptions {
+    maxSize?: number;
+    ttl?: number;
+    /** false means platform-controlled immutable cache. */
+    revalidate?: number | false;
+    tags?: string[];
+}
+interface CacheStats {
+    size: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    evictions: number;
+}
+declare const CacheTags: {
+    project: (projectId: string) => string;
+    content: (slug: string) => string;
+    collection: (collectionId: string) => string;
+    global: string;
+    user: (userId: string) => string;
+    media: (mediaId: string) => string;
+};
+declare class MemoryCache {
+    private cache;
+    private tagIndex;
+    private stats;
+    private maxSize;
+    private defaultTTL;
+    constructor(options?: CacheOptions);
+    set<T = any>(key: string, data: T, options?: CacheOptions): void;
+    get<T = any>(key: string): {
+        data: T;
+        metadata: any;
+    } | null;
+    delete(key: string): boolean;
+    invalidateByTags(tags: string[]): void;
+    clear(): void;
+    getStats(): CacheStats;
+    private evictLRU;
+    private calculateSize;
+    private updateHitRate;
+}
+declare class BrowserCache {
+    private projectId;
+    private prefix;
+    private maxSize;
+    private currentSize;
+    constructor(projectId: string);
+    set<T = any>(key: string, data: T, ttl?: number): void;
+    get<T = any>(key: string): T | null;
+    delete(key: string): void;
+    clear(): void;
+    private getStorageKey;
+    private calculateCurrentSize;
+    private calculateStorageSize;
+    private evictOldest;
+}
+
 interface MinimalNexusConfig {
     apiUrl?: string;
     analyticsUrl?: string;
@@ -122,14 +186,9 @@ declare class ContentEngine {
     private circuitBreaker;
     private defaultRevalidate;
     private cacheStrategy;
-    private abortController?;
     private isServer;
     constructor(config: NexusConfig);
-    /** Update runtime configuration without exposing internal mutation. */
     updateConfig(config: NexusConfig): void;
-    /**
-     * Fetch a Single Page with full strategy pipeline
-     */
     getPage<T = any>(slug: string, options?: {
         revalidate?: number | false;
         tags?: string[];
@@ -137,67 +196,41 @@ declare class ContentEngine {
         includeMetadata?: boolean;
     }): Promise<T>;
     private _getPage;
-    /**
-     * Fetch a Collection (Optimized)
-     */
     getCollection<T = any>(collectionId: string, query?: CollectionQuery, options?: {
         revalidate?: number | false;
         tags?: string[];
         forceRefresh?: boolean;
         includeMetadata?: boolean;
     }): Promise<CollectionResponse<T>>;
-    private _getCollection;
-    /**
-     * Fetch Global Settings
-     */
     getGlobals<T = any>(options?: {
         include?: string[];
         revalidate?: number | false;
         forceRefresh?: boolean;
         tags?: string[];
     }): Promise<T>;
-    /**
-     * Get a single item from a collection (Uses Request Batching)
-     */
     getItem<T = any>(collectionId: string, itemId: string, options?: {
         revalidate?: number | false;
         tags?: string[];
         include?: string[];
+        forceRefresh?: boolean;
     }): Promise<T>;
-    /**
-     * Search across collections
-     */
     search<T = any>(query: string, options?: {
         collections?: string[];
         fields?: string[];
         limit?: number;
         revalidate?: number | false;
+        forceRefresh?: boolean;
     }): Promise<{
         results: T[];
         total: number;
     }>;
-    /**
-     * Prefetch content
-     */
     prefetch(urls: string[]): Promise<void>;
-    /**
-     * Robust Real-time Subscriptions (SSE) with Auto-Reconnect
-     */
     subscribeToUpdates(callback: (data: any) => void): () => void;
-    private checkCaches;
     private writeCache;
     invalidateCache(tags: string[]): void;
     clearCache(): void;
     getCacheStats(): {
-        memory: {
-            size: number;
-            hits: number;
-            misses: number;
-            hitRate: number;
-        };
-        browser: {
-            size: number;
-        } | null;
+        memory: CacheStats;
         local: {
             loaded: boolean;
         };
@@ -208,12 +241,7 @@ declare class ContentEngine {
     private fetchWithTimeout;
     private getHeaders;
     private isCacheValid;
-    /**
-     * 🛡️ FIX: Normalizes timeout errors (AbortError, 408, or Timeout messages)
-     * into clean, standardized "Request timeout" errors.
-     */
     private normalizeError;
-    cancelRequests(): void;
     cleanup(): void;
 }
 
@@ -384,15 +412,7 @@ declare class NexusClient {
      */
     diagnostics(): {
         cache: {
-            memory: {
-                size: number;
-                hits: number;
-                misses: number;
-                hitRate: number;
-            };
-            browser: {
-                size: number;
-            } | null;
+            memory: CacheStats;
             local: {
                 loaded: boolean;
             };
@@ -485,70 +505,6 @@ interface AuthContextType extends AuthState {
     requestPasswordReset: (email: string) => Promise<void>;
 }
 
-/**
- * NexusHub Shared Cache Implementations
- *
- * Contains MemoryCache (LRU) and BrowserCache (LocalStorage)
- * which are safe for universal usage.
- */
-interface CacheOptions {
-    maxSize?: number;
-    ttl?: number;
-    /** false means platform-controlled immutable cache. */
-    revalidate?: number | false;
-    tags?: string[];
-}
-interface CacheStats {
-    size: number;
-    hits: number;
-    misses: number;
-    hitRate: number;
-    evictions: number;
-}
-declare const CacheTags: {
-    project: (projectId: string) => string;
-    content: (slug: string) => string;
-    collection: (collectionId: string) => string;
-    global: string;
-    user: (userId: string) => string;
-    media: (mediaId: string) => string;
-};
-declare class MemoryCache {
-    private cache;
-    private tagIndex;
-    private stats;
-    private maxSize;
-    private defaultTTL;
-    constructor(options?: CacheOptions);
-    set<T = any>(key: string, data: T, options?: CacheOptions): void;
-    get<T = any>(key: string): {
-        data: T;
-        metadata: any;
-    } | null;
-    delete(key: string): boolean;
-    invalidateByTags(tags: string[]): void;
-    clear(): void;
-    getStats(): CacheStats;
-    private evictLRU;
-    private calculateSize;
-    private updateHitRate;
-}
-declare class BrowserCache {
-    private projectId;
-    private prefix;
-    private maxSize;
-    private currentSize;
-    constructor(projectId: string);
-    set<T = any>(key: string, data: T, ttl?: number): void;
-    get<T = any>(key: string): T | null;
-    delete(key: string): void;
-    clear(): void;
-    private getStorageKey;
-    private calculateCurrentSize;
-    private calculateStorageSize;
-    private evictOldest;
-}
-
 declare class LocalCacheProxy implements ILocalCache {
     private instance;
     private cachePath?;