opticore-webapp 1.0.66 → 1.0.68

package/dist/index.d.cts

@@ -1,104 +1,224 @@
-import { CorsOptions } from 'cors';
 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 { TDependencyKey, TDependency } from 'opticore-dependency-inject';
+import { CorsOptions } from 'cors';
 
-interface IRouteDefinition {
-    path: string;
-    handler: express.Router;
+interface WebServerConstructorInterface {
+    app: express.Application;
+    loggerConfig: LoggerCore;
+    localLanguage: string;
+    environmentPath: any;
+    corsOriginOptions?: Partial<CorsOptions>;
 }
 
-type TFeatureRoutes = {
-    featureName?: string;
-    featureRoute: IRouteDefinition[];
-};
+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;
     private readonly getEnvironment;
     private readonly environmentPath;
     private serverListenEvent;
-    private isHotReloading;
     private currentRoutes;
     private currentDependencies;
-    constructor(app: express.Application, loggerConfig: LoggerCore, localLanguage: string, environmentPath: any, corsOriginOptions?: Partial<CorsOptions>);
+    private server;
+    private errorEmitter;
+    private isWatcherEnabled;
+    private serverStatus;
+    private serverStartTime;
+    constructor(paramsConstructor: WebServerConstructorInterface);
+    onStartServer(routers: TFeatureRoutes[], databaseCallback?: (env: any) => void, dependenciesProvider?: TDependency[]): Server | undefined;
     /**
-     *
-     * @param dependencies
+     * Error handling configuration
      */
-    registerDependencies(dependencies: Map<TDependencyKey, any>): void;
+    private setupErrorHandling;
     /**
-     *
-     * @param routers
-     * @param databaseCallback
-     * @param dependenciesProvider
+     * Setup server events
      */
-    onStartServer(routers: TFeatureRoutes[], databaseCallback: (env: any) => void, dependenciesProvider?: TDependency[]): any;
+    private setupServerEvents;
     /**
-     *
-     * @param serverWeb
+     * Initialize file watcher
      */
-    onListeningOnServerEvent(serverWeb: Server): void;
+    private initializeFileWatcher;
     /**
-     *
-     * @param serverWeb
+     * Setup watcher events
      */
-    onRequestOnServerEvent(serverWeb: Server): void;
+    private setupWatcherEvents;
     /**
-     *
-     * @param allFeatureRoutes
-     * @private
+     * Handle file changes detected by watcher
      */
-    private registerRoutes;
+    private handleFileChange;
     /**
-     *
-     * @param localLanguage
-     * @private
+     * Handle hot reload requested by watcher
      */
-    private stackTraceErrorHandling;
+    private handleHotReload;
     /**
-     *
-     * @private
+     * Handle watcher errors
      */
-    private infoWebApp;
-    private setupSignalHandlers;
+    private handleWatcherError;
     /**
-     * Logique de rechargement à chaud
+     * Notify file change without action
      */
-    private handleHotReload;
+    private notifyFileChange;
     /**
-     * Clear server module cache
+     * Reload environment configuration
      */
-    private clearServerCache;
+    private reloadEnvironmentConfig;
     /**
-     * Recharger les configurations
+     * 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;
     /**
-     * Recharger les dépendances
+     * Reload dependencies
      */
     private reloadDependencies;
     /**
-     * Recharger les routes
+     * Register routes
+     */
+    private registerRoutes;
+    /**
+     * Parse transform error
      */
-    private reloadRoutes;
+    private parseTransformError;
     /**
-     * Recharger les services
+     * Display server info
      */
-    private reloadServices;
+    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;
 
-type TFeatureRouteDefinition = {
-    featureRoute: IRouteDefinition[];
-};
-
-type KernelModuleType = [TFeatureRouteDefinition[], () => void];
+type KernelModuleType = [any[], () => void];
 
-export { type IRouteDefinition, type KernelModuleType, type TFeatureRoutes, WebServerCore as WebServer, envPath };
+export { type KernelModuleType, WebServerCore as WebServer, envPath };

package/dist/index.d.ts

@@ -1,104 +1,224 @@
-import { CorsOptions } from 'cors';
 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 { TDependencyKey, TDependency } from 'opticore-dependency-inject';
+import { CorsOptions } from 'cors';
 
-interface IRouteDefinition {
-    path: string;
-    handler: express.Router;
+interface WebServerConstructorInterface {
+    app: express.Application;
+    loggerConfig: LoggerCore;
+    localLanguage: string;
+    environmentPath: any;
+    corsOriginOptions?: Partial<CorsOptions>;
 }
 
-type TFeatureRoutes = {
-    featureName?: string;
-    featureRoute: IRouteDefinition[];
-};
+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;
     private readonly getEnvironment;
     private readonly environmentPath;
     private serverListenEvent;
-    private isHotReloading;
     private currentRoutes;
     private currentDependencies;
-    constructor(app: express.Application, loggerConfig: LoggerCore, localLanguage: string, environmentPath: any, corsOriginOptions?: Partial<CorsOptions>);
+    private server;
+    private errorEmitter;
+    private isWatcherEnabled;
+    private serverStatus;
+    private serverStartTime;
+    constructor(paramsConstructor: WebServerConstructorInterface);
+    onStartServer(routers: TFeatureRoutes[], databaseCallback?: (env: any) => void, dependenciesProvider?: TDependency[]): Server | undefined;
     /**
-     *
-     * @param dependencies
+     * Error handling configuration
      */
-    registerDependencies(dependencies: Map<TDependencyKey, any>): void;
+    private setupErrorHandling;
     /**
-     *
-     * @param routers
-     * @param databaseCallback
-     * @param dependenciesProvider
+     * Setup server events
      */
-    onStartServer(routers: TFeatureRoutes[], databaseCallback: (env: any) => void, dependenciesProvider?: TDependency[]): any;
+    private setupServerEvents;
     /**
-     *
-     * @param serverWeb
+     * Initialize file watcher
      */
-    onListeningOnServerEvent(serverWeb: Server): void;
+    private initializeFileWatcher;
     /**
-     *
-     * @param serverWeb
+     * Setup watcher events
      */
-    onRequestOnServerEvent(serverWeb: Server): void;
+    private setupWatcherEvents;
     /**
-     *
-     * @param allFeatureRoutes
-     * @private
+     * Handle file changes detected by watcher
      */
-    private registerRoutes;
+    private handleFileChange;
     /**
-     *
-     * @param localLanguage
-     * @private
+     * Handle hot reload requested by watcher
      */
-    private stackTraceErrorHandling;
+    private handleHotReload;
     /**
-     *
-     * @private
+     * Handle watcher errors
      */
-    private infoWebApp;
-    private setupSignalHandlers;
+    private handleWatcherError;
     /**
-     * Logique de rechargement à chaud
+     * Notify file change without action
      */
-    private handleHotReload;
+    private notifyFileChange;
     /**
-     * Clear server module cache
+     * Reload environment configuration
      */
-    private clearServerCache;
+    private reloadEnvironmentConfig;
     /**
-     * Recharger les configurations
+     * 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;
     /**
-     * Recharger les dépendances
+     * Reload dependencies
      */
     private reloadDependencies;
     /**
-     * Recharger les routes
+     * Register routes
+     */
+    private registerRoutes;
+    /**
+     * Parse transform error
      */
-    private reloadRoutes;
+    private parseTransformError;
     /**
-     * Recharger les services
+     * Display server info
      */
-    private reloadServices;
+    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;
 
-type TFeatureRouteDefinition = {
-    featureRoute: IRouteDefinition[];
-};
-
-type KernelModuleType = [TFeatureRouteDefinition[], () => void];
+type KernelModuleType = [any[], () => void];
 
-export { type IRouteDefinition, type KernelModuleType, type TFeatureRoutes, WebServerCore as WebServer, envPath };
+export { type KernelModuleType, WebServerCore as WebServer, envPath };