opticore-webapp 1.0.67 → 1.0.68

package/dist/index.d.cts

@@ -1,9 +1,9 @@
 import { Server } from 'http';
 import { TDependency } from 'opticore-dependency-inject';
+import { TFeatureRoutes } from 'opticore-router';
 import { express } from 'opticore-express';
 import { LoggerCore } from 'opticore-logger';
 import { CorsOptions } from 'cors';
-import { TFeatureRoutes } from 'opticore-router';
 
 interface WebServerConstructorInterface {
     app: express.Application;
@@ -13,17 +13,33 @@ interface WebServerConstructorInterface {
     corsOriginOptions?: Partial<CorsOptions>;
 }
 
-/**
- * WebServerCore - Architecture Serveur-Autorité
- *
- * Le serveur gère strictement ses états :
- * - READY : Prêt à recevoir des demandes de hot reload
- * - RELOADING : En cours de hot reload
- * - BLOCKED : Bloqué par une erreur, refuse les nouveaux reloads
- */
+type TServerStatus = "READY" | "RELOADING" | "BLOCKED" | "ERROR" | "STARTING" | "STOPPING";
+
+interface IServerStateInfo {
+    status: TServerStatus;
+    isRunning: boolean;
+    host: string;
+    port: number;
+    language: string;
+    watcherEnabled: boolean;
+    watcherActive?: boolean;
+    routesCount: number;
+    dependenciesCount: number;
+    startTime?: Date;
+    currentTime?: Date;
+    uptime?: number;
+    memoryUsage?: NodeJS.MemoryUsage;
+    uptimeFormatted?: string;
+    pid?: any;
+    platform?: any;
+    nodeVersion?: any;
+    cwd?: any;
+}
+
 declare class WebServerCore {
     private serverUtility;
     private expressApp;
+    private fileWatcher;
     private readonly localLanguage;
     private readonly loggerConfig;
     private readonly routerExpressApp;
@@ -34,50 +50,171 @@ declare class WebServerCore {
     private currentDependencies;
     private server;
     private errorEmitter;
-    private serverState;
-    private lastError;
-    private hotReloadAttempts;
-    private hotReloadSuccesses;
-    private hotReloadFailures;
+    private isWatcherEnabled;
+    private serverStatus;
+    private serverStartTime;
     constructor(paramsConstructor: WebServerConstructorInterface);
     onStartServer(routers: TFeatureRoutes[], databaseCallback?: (env: any) => void, dependenciesProvider?: TDependency[]): Server | undefined;
     /**
-     * ✅✅✅ Configuration de la gestion d'erreurs
+     * Error handling configuration
      */
     private setupErrorHandling;
+    /**
+     * Setup server events
+     */
     private setupServerEvents;
-    private notifyServerReady;
-    private setupSignalHandlers;
-    private setupIPCHandlers;
     /**
-     * ✅✅✅ HOT RELOAD avec gestion d'état stricte
+     * Initialize file watcher
      */
-    private performTrueHotReload;
+    private initializeFileWatcher;
     /**
-     * Nettoie le cache des modules applicatifs
+     * Setup watcher events
      */
-    private clearApplicationModulesCache;
-    private reloadConfigurations;
-    private reloadDependencies;
+    private setupWatcherEvents;
     /**
-     * ✅✅✅ Notifier le watcher : SUCCÈS
+     * Handle file changes detected by watcher
      */
-    private notifyWatcherReloadSuccess;
+    private handleFileChange;
     /**
-     * ✅✅✅ Notifier le watcher : BLOQUÉ PAR ERREUR TRANSFORM
+     * Handle hot reload requested by watcher
      */
-    private notifyWatcherBlockedByError;
+    private handleHotReload;
     /**
-     * ✅✅✅ Notifier le watcher : ERREUR GÉNÉRIQUE
+     * Handle watcher errors
      */
-    private notifyWatcherReloadError;
+    private handleWatcherError;
     /**
-     * ✅✅✅ Parser les détails d'une TransformError
+     * Notify file change without action
+     */
+    private notifyFileChange;
+    /**
+     * Reload environment configuration
+     */
+    private reloadEnvironmentConfig;
+    /**
+     * Execute hot reload for environment files
+     */
+    private executeHotReloadEnvironment;
+    /**
+     * Reload configuration files
+     */
+    private reloadConfigurationFiles;
+    /**
+     * Execute hot reload for config files
+     */
+    private executeHotReloadConfig;
+    /**
+     * Reload application routes
+     */
+    private reloadApplicationRoutes;
+    /**
+     * Execute hot reload for routes
+     */
+    private executeHotReloadRoutes;
+    /**
+     * Execute hot reload for dependencies
+     */
+    private executeHotReloadDependencies;
+    /**
+     * Notify environment reload
+     */
+    private notifyEnvironmentReload;
+    /**
+     * Reload specific route
+     */
+    private reloadSpecificRoute;
+    /**
+     * Reload router for specific file
+     */
+    private reloadRouterForFile;
+    /**
+     * Reload configurations
+     */
+    private reloadConfigurations;
+    /**
+     * Reload dependencies
+     */
+    private reloadDependencies;
+    /**
+     * Register routes
      */
-    private parseTransformError;
     private registerRoutes;
+    /**
+     * Parse transform error
+     */
+    private parseTransformError;
+    /**
+     * Display server info
+     */
     private infoWebApp;
+    /**
+     * Stop file watcher
+     */
+    private stopFileWatcher;
+    /**
+     * Shutdown server
+     */
     private shutdown;
+    /**
+     * Enable/disable watcher
+     */
+    setWatcherEnabled(enabled: boolean): void;
+    /**
+     * Get watcher status
+     */
+    getWatcherStatus(): {
+        enabled: boolean;
+        active: boolean;
+    };
+    /**
+     * Get server state information
+     */
+    getServerState(): IServerStateInfo;
+    /**
+     * Simple method to get just the status
+     */
+    getServerStatus(): TServerStatus;
+    /**
+     * Get server statistics for monitoring
+     */
+    getServerStats(): {
+        status: TServerStatus;
+        uptime: string;
+        memory: {
+            rss: string;
+            heapTotal: string;
+            heapUsed: string;
+            external: string;
+        };
+        performance: {
+            cpuUsage: NodeJS.CpuUsage;
+            resourceUsage?: NodeJS.ResourceUsage;
+        };
+    };
+    /**
+     * Format bytes to human readable string
+     */
+    private formatBytes;
+    /**
+     * Format uptime to human readable string
+     */
+    private formatUptime;
+    /**
+     * Add watch directories
+     */
+    addWatchDirectories(directories: string[]): void;
+    /**
+     * Clear file cache
+     */
+    clearFileCache(): void;
+    /**
+     * Force reload configurations
+     */
+    forceReloadConfig(): void;
+    /**
+     * Restart watcher
+     */
+    restartWatcher(): void;
 }
 
 declare const envPath: string;

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { Server } from 'http';
 import { TDependency } from 'opticore-dependency-inject';
+import { TFeatureRoutes } from 'opticore-router';
 import { express } from 'opticore-express';
 import { LoggerCore } from 'opticore-logger';
 import { CorsOptions } from 'cors';
-import { TFeatureRoutes } from 'opticore-router';
 
 interface WebServerConstructorInterface {
     app: express.Application;
@@ -13,17 +13,33 @@ interface WebServerConstructorInterface {
     corsOriginOptions?: Partial<CorsOptions>;
 }
 
-/**
- * WebServerCore - Architecture Serveur-Autorité
- *
- * Le serveur gère strictement ses états :
- * - READY : Prêt à recevoir des demandes de hot reload
- * - RELOADING : En cours de hot reload
- * - BLOCKED : Bloqué par une erreur, refuse les nouveaux reloads
- */
+type TServerStatus = "READY" | "RELOADING" | "BLOCKED" | "ERROR" | "STARTING" | "STOPPING";
+
+interface IServerStateInfo {
+    status: TServerStatus;
+    isRunning: boolean;
+    host: string;
+    port: number;
+    language: string;
+    watcherEnabled: boolean;
+    watcherActive?: boolean;
+    routesCount: number;
+    dependenciesCount: number;
+    startTime?: Date;
+    currentTime?: Date;
+    uptime?: number;
+    memoryUsage?: NodeJS.MemoryUsage;
+    uptimeFormatted?: string;
+    pid?: any;
+    platform?: any;
+    nodeVersion?: any;
+    cwd?: any;
+}
+
 declare class WebServerCore {
     private serverUtility;
     private expressApp;
+    private fileWatcher;
     private readonly localLanguage;
     private readonly loggerConfig;
     private readonly routerExpressApp;
@@ -34,50 +50,171 @@ declare class WebServerCore {
     private currentDependencies;
     private server;
     private errorEmitter;
-    private serverState;
-    private lastError;
-    private hotReloadAttempts;
-    private hotReloadSuccesses;
-    private hotReloadFailures;
+    private isWatcherEnabled;
+    private serverStatus;
+    private serverStartTime;
     constructor(paramsConstructor: WebServerConstructorInterface);
     onStartServer(routers: TFeatureRoutes[], databaseCallback?: (env: any) => void, dependenciesProvider?: TDependency[]): Server | undefined;
     /**
-     * ✅✅✅ Configuration de la gestion d'erreurs
+     * Error handling configuration
      */
     private setupErrorHandling;
+    /**
+     * Setup server events
+     */
     private setupServerEvents;
-    private notifyServerReady;
-    private setupSignalHandlers;
-    private setupIPCHandlers;
     /**
-     * ✅✅✅ HOT RELOAD avec gestion d'état stricte
+     * Initialize file watcher
      */
-    private performTrueHotReload;
+    private initializeFileWatcher;
     /**
-     * Nettoie le cache des modules applicatifs
+     * Setup watcher events
      */
-    private clearApplicationModulesCache;
-    private reloadConfigurations;
-    private reloadDependencies;
+    private setupWatcherEvents;
     /**
-     * ✅✅✅ Notifier le watcher : SUCCÈS
+     * Handle file changes detected by watcher
      */
-    private notifyWatcherReloadSuccess;
+    private handleFileChange;
     /**
-     * ✅✅✅ Notifier le watcher : BLOQUÉ PAR ERREUR TRANSFORM
+     * Handle hot reload requested by watcher
      */
-    private notifyWatcherBlockedByError;
+    private handleHotReload;
     /**
-     * ✅✅✅ Notifier le watcher : ERREUR GÉNÉRIQUE
+     * Handle watcher errors
      */
-    private notifyWatcherReloadError;
+    private handleWatcherError;
     /**
-     * ✅✅✅ Parser les détails d'une TransformError
+     * Notify file change without action
+     */
+    private notifyFileChange;
+    /**
+     * Reload environment configuration
+     */
+    private reloadEnvironmentConfig;
+    /**
+     * Execute hot reload for environment files
+     */
+    private executeHotReloadEnvironment;
+    /**
+     * Reload configuration files
+     */
+    private reloadConfigurationFiles;
+    /**
+     * Execute hot reload for config files
+     */
+    private executeHotReloadConfig;
+    /**
+     * Reload application routes
+     */
+    private reloadApplicationRoutes;
+    /**
+     * Execute hot reload for routes
+     */
+    private executeHotReloadRoutes;
+    /**
+     * Execute hot reload for dependencies
+     */
+    private executeHotReloadDependencies;
+    /**
+     * Notify environment reload
+     */
+    private notifyEnvironmentReload;
+    /**
+     * Reload specific route
+     */
+    private reloadSpecificRoute;
+    /**
+     * Reload router for specific file
+     */
+    private reloadRouterForFile;
+    /**
+     * Reload configurations
+     */
+    private reloadConfigurations;
+    /**
+     * Reload dependencies
+     */
+    private reloadDependencies;
+    /**
+     * Register routes
      */
-    private parseTransformError;
     private registerRoutes;
+    /**
+     * Parse transform error
+     */
+    private parseTransformError;
+    /**
+     * Display server info
+     */
     private infoWebApp;
+    /**
+     * Stop file watcher
+     */
+    private stopFileWatcher;
+    /**
+     * Shutdown server
+     */
     private shutdown;
+    /**
+     * Enable/disable watcher
+     */
+    setWatcherEnabled(enabled: boolean): void;
+    /**
+     * Get watcher status
+     */
+    getWatcherStatus(): {
+        enabled: boolean;
+        active: boolean;
+    };
+    /**
+     * Get server state information
+     */
+    getServerState(): IServerStateInfo;
+    /**
+     * Simple method to get just the status
+     */
+    getServerStatus(): TServerStatus;
+    /**
+     * Get server statistics for monitoring
+     */
+    getServerStats(): {
+        status: TServerStatus;
+        uptime: string;
+        memory: {
+            rss: string;
+            heapTotal: string;
+            heapUsed: string;
+            external: string;
+        };
+        performance: {
+            cpuUsage: NodeJS.CpuUsage;
+            resourceUsage?: NodeJS.ResourceUsage;
+        };
+    };
+    /**
+     * Format bytes to human readable string
+     */
+    private formatBytes;
+    /**
+     * Format uptime to human readable string
+     */
+    private formatUptime;
+    /**
+     * Add watch directories
+     */
+    addWatchDirectories(directories: string[]): void;
+    /**
+     * Clear file cache
+     */
+    clearFileCache(): void;
+    /**
+     * Force reload configurations
+     */
+    forceReloadConfig(): void;
+    /**
+     * Restart watcher
+     */
+    restartWatcher(): void;
 }
 
 declare const envPath: string;