@nexushub/client 0.0.4 → 0.0.7

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

@@ -1,18 +1,22 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
+export { LocalCache } from './content/local-cache-server.cjs';
 
 interface MinimalNexusConfig {
     apiUrl?: string;
+    analyticsUrl?: string;
     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 DEFAULT_API_URL = "http://localhost:3001";
+declare const DEFAULT_ANALYTICS_URL = "http://localhost:3002";
+declare const LOCAL_NEST_URL = "http://localhost:3001";
+declare const LOCAL_RUST_URL = "http://localhost:3002";
 declare const getEnvConfig: () => MinimalNexusConfig;
+/**
+ * Merges base environment config with manual overrides from the constructor
+ */
 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[];
 
@@ -258,10 +262,27 @@ declare class NexusClient {
 declare const nexus: NexusClient;
 declare const createNexusClient: (config: Partial<NexusConfig>) => NexusClient;
 
-declare const NexusProvider: ({ children, projectId }: {
+interface NexusProviderProps {
     children: React.ReactNode;
+    /**
+     * Optional project ID override.
+     * If provided, this will override the environment variable NEXT_PUBLIC_NEXUS_ID.
+     */
     projectId?: string;
-}) => react_jsx_runtime.JSX.Element;
+    /**
+     * Optional configuration to disable analytics tracking (e.g., for GDPR compliance).
+     */
+    disableAnalytics?: boolean;
+}
+/**
+ * The God-Tier NexusHub Provider.
+ *
+ * 1. Orchestrates the Authentication state.
+ * 2. Manages the Analytics lifecycle.
+ * 3. Automates Page View tracking on route changes.
+ * 4. Provides the NexusClient singleton via Context.
+ */
+declare const NexusProvider: ({ children, projectId, disableAnalytics, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
 
 interface SiteUser {
     id: string;
@@ -314,14 +335,10 @@ declare const AuthProvider: ({ children, config }: {
 declare const useNexusAuth: () => AuthContextType;
 
 /**
- * NexusHub Advanced Caching System
+ * NexusHub Shared Cache Implementations
  *
- * Features:
- * 1. Multi-layer caching (Memory > Local > Remote)
- * 2. Cache tagging for precise invalidation
- * 3. LRU eviction policy
- * 4. Cache statistics and monitoring
- * 5. Development mode with filesystem cache
+ * Contains MemoryCache (LRU) and BrowserCache (LocalStorage)
+ * which are safe for universal usage.
  */
 interface CacheOptions {
     maxSize?: number;
@@ -364,19 +381,6 @@ declare class MemoryCache {
     private calculateSize;
     private updateHitRate;
 }
-declare class LocalCache {
-    private data;
-    private hasLoaded;
-    private cachePath;
-    constructor(customPath?: string);
-    isLoaded(): boolean;
-    private load;
-    getPage(slug: string): any;
-    getCollection(collectionId: string): any[] | null;
-    getGlobals(): any;
-    getAllData(): any;
-    private shouldWarnAboutMissingCache;
-}
 declare class BrowserCache {
     private projectId;
     private prefix;
@@ -395,4 +399,4 @@ declare class BrowserCache {
 
 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_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 };
+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, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, NexusProvider, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, useNexusAuth, validateConfig };

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

@@ -1,18 +1,22 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
+export { LocalCache } from './content/local-cache-server.js';
 
 interface MinimalNexusConfig {
     apiUrl?: string;
+    analyticsUrl?: string;
     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 DEFAULT_API_URL = "http://localhost:3001";
+declare const DEFAULT_ANALYTICS_URL = "http://localhost:3002";
+declare const LOCAL_NEST_URL = "http://localhost:3001";
+declare const LOCAL_RUST_URL = "http://localhost:3002";
 declare const getEnvConfig: () => MinimalNexusConfig;
+/**
+ * Merges base environment config with manual overrides from the constructor
+ */
 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[];
 
@@ -258,10 +262,27 @@ declare class NexusClient {
 declare const nexus: NexusClient;
 declare const createNexusClient: (config: Partial<NexusConfig>) => NexusClient;
 
-declare const NexusProvider: ({ children, projectId }: {
+interface NexusProviderProps {
     children: React.ReactNode;
+    /**
+     * Optional project ID override.
+     * If provided, this will override the environment variable NEXT_PUBLIC_NEXUS_ID.
+     */
     projectId?: string;
-}) => react_jsx_runtime.JSX.Element;
+    /**
+     * Optional configuration to disable analytics tracking (e.g., for GDPR compliance).
+     */
+    disableAnalytics?: boolean;
+}
+/**
+ * The God-Tier NexusHub Provider.
+ *
+ * 1. Orchestrates the Authentication state.
+ * 2. Manages the Analytics lifecycle.
+ * 3. Automates Page View tracking on route changes.
+ * 4. Provides the NexusClient singleton via Context.
+ */
+declare const NexusProvider: ({ children, projectId, disableAnalytics, }: NexusProviderProps) => react_jsx_runtime.JSX.Element;
 
 interface SiteUser {
     id: string;
@@ -314,14 +335,10 @@ declare const AuthProvider: ({ children, config }: {
 declare const useNexusAuth: () => AuthContextType;
 
 /**
- * NexusHub Advanced Caching System
+ * NexusHub Shared Cache Implementations
  *
- * Features:
- * 1. Multi-layer caching (Memory > Local > Remote)
- * 2. Cache tagging for precise invalidation
- * 3. LRU eviction policy
- * 4. Cache statistics and monitoring
- * 5. Development mode with filesystem cache
+ * Contains MemoryCache (LRU) and BrowserCache (LocalStorage)
+ * which are safe for universal usage.
  */
 interface CacheOptions {
     maxSize?: number;
@@ -364,19 +381,6 @@ declare class MemoryCache {
     private calculateSize;
     private updateHitRate;
 }
-declare class LocalCache {
-    private data;
-    private hasLoaded;
-    private cachePath;
-    constructor(customPath?: string);
-    isLoaded(): boolean;
-    private load;
-    getPage(slug: string): any;
-    getCollection(collectionId: string): any[] | null;
-    getGlobals(): any;
-    getAllData(): any;
-    private shouldWarnAboutMissingCache;
-}
 declare class BrowserCache {
     private projectId;
     private prefix;
@@ -395,4 +399,4 @@ declare class BrowserCache {
 
 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_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 };
+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, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, NexusProvider, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, useNexusAuth, validateConfig };