opticore-webapp 1.0.65 → 1.0.67

package/dist/index.d.cts

@@ -1,18 +1,26 @@
-import { CorsOptions } from 'cors';
 import { Server } from 'http';
+import { TDependency } from 'opticore-dependency-inject';
 import { express } from 'opticore-express';
 import { LoggerCore } from 'opticore-logger';
-import { TDependencyKey, TDependency } from 'opticore-dependency-inject';
+import { CorsOptions } from 'cors';
+import { TFeatureRoutes } from 'opticore-router';
 
-interface IRouteDefinition {
-    path: string;
-    handler: express.Router;
+interface WebServerConstructorInterface {
+    app: express.Application;
+    loggerConfig: LoggerCore;
+    localLanguage: string;
+    environmentPath: any;
+    corsOriginOptions?: Partial<CorsOptions>;
 }
 
-type TFeatureRoutes = {
-    featureRoute: IRouteDefinition[];
-};
-
+/**
+ * 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
+ */
 declare class WebServerCore {
     private serverUtility;
     private expressApp;
@@ -22,54 +30,58 @@ declare class WebServerCore {
     private readonly getEnvironment;
     private readonly environmentPath;
     private serverListenEvent;
-    constructor(app: express.Application, loggerConfig: LoggerCore, localLanguage: string, environmentPath: any, corsOriginOptions?: Partial<CorsOptions>);
+    private currentRoutes;
+    private currentDependencies;
+    private server;
+    private errorEmitter;
+    private serverState;
+    private lastError;
+    private hotReloadAttempts;
+    private hotReloadSuccesses;
+    private hotReloadFailures;
+    constructor(paramsConstructor: WebServerConstructorInterface);
+    onStartServer(routers: TFeatureRoutes[], databaseCallback?: (env: any) => void, dependenciesProvider?: TDependency[]): Server | undefined;
     /**
-     *
-     * @param dependencies
+     * ✅✅✅ Configuration de la gestion d'erreurs
      */
-    registerDependencies(dependencies: Map<TDependencyKey, any>): void;
+    private setupErrorHandling;
+    private setupServerEvents;
+    private notifyServerReady;
+    private setupSignalHandlers;
+    private setupIPCHandlers;
     /**
-     *
-     * @param routers
-     * @param databaseCallback
-     * @param dependenciesProvider
+     * ✅✅✅ HOT RELOAD avec gestion d'état stricte
      */
-    onStartServer(routers: TFeatureRoutes[], databaseCallback: (env: any) => void, dependenciesProvider?: TDependency[]): any;
+    private performTrueHotReload;
     /**
-     *
-     * @param serverWeb
+     * Nettoie le cache des modules applicatifs
      */
-    onListeningOnServerEvent(serverWeb: Server): void;
+    private clearApplicationModulesCache;
+    private reloadConfigurations;
+    private reloadDependencies;
     /**
-     *
-     * @param serverWeb
+     * ✅✅✅ Notifier le watcher : SUCCÈS
      */
-    onRequestOnServerEvent(serverWeb: Server): void;
+    private notifyWatcherReloadSuccess;
     /**
-     *
-     * @param allFeatureRoutes
-     * @private
+     * ✅✅✅ Notifier le watcher : BLOQUÉ PAR ERREUR TRANSFORM
      */
-    private registerRoutes;
+    private notifyWatcherBlockedByError;
     /**
-     *
-     * @param localLanguage
-     * @private
+     * ✅✅✅ Notifier le watcher : ERREUR GÉNÉRIQUE
      */
-    private stackTraceErrorHandling;
+    private notifyWatcherReloadError;
     /**
-     *
-     * @private
+     * ✅✅✅ Parser les détails d'une TransformError
      */
+    private parseTransformError;
+    private registerRoutes;
     private infoWebApp;
+    private shutdown;
 }
 
 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,18 +1,26 @@
-import { CorsOptions } from 'cors';
 import { Server } from 'http';
+import { TDependency } from 'opticore-dependency-inject';
 import { express } from 'opticore-express';
 import { LoggerCore } from 'opticore-logger';
-import { TDependencyKey, TDependency } from 'opticore-dependency-inject';
+import { CorsOptions } from 'cors';
+import { TFeatureRoutes } from 'opticore-router';
 
-interface IRouteDefinition {
-    path: string;
-    handler: express.Router;
+interface WebServerConstructorInterface {
+    app: express.Application;
+    loggerConfig: LoggerCore;
+    localLanguage: string;
+    environmentPath: any;
+    corsOriginOptions?: Partial<CorsOptions>;
 }
 
-type TFeatureRoutes = {
-    featureRoute: IRouteDefinition[];
-};
-
+/**
+ * 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
+ */
 declare class WebServerCore {
     private serverUtility;
     private expressApp;
@@ -22,54 +30,58 @@ declare class WebServerCore {
     private readonly getEnvironment;
     private readonly environmentPath;
     private serverListenEvent;
-    constructor(app: express.Application, loggerConfig: LoggerCore, localLanguage: string, environmentPath: any, corsOriginOptions?: Partial<CorsOptions>);
+    private currentRoutes;
+    private currentDependencies;
+    private server;
+    private errorEmitter;
+    private serverState;
+    private lastError;
+    private hotReloadAttempts;
+    private hotReloadSuccesses;
+    private hotReloadFailures;
+    constructor(paramsConstructor: WebServerConstructorInterface);
+    onStartServer(routers: TFeatureRoutes[], databaseCallback?: (env: any) => void, dependenciesProvider?: TDependency[]): Server | undefined;
     /**
-     *
-     * @param dependencies
+     * ✅✅✅ Configuration de la gestion d'erreurs
      */
-    registerDependencies(dependencies: Map<TDependencyKey, any>): void;
+    private setupErrorHandling;
+    private setupServerEvents;
+    private notifyServerReady;
+    private setupSignalHandlers;
+    private setupIPCHandlers;
     /**
-     *
-     * @param routers
-     * @param databaseCallback
-     * @param dependenciesProvider
+     * ✅✅✅ HOT RELOAD avec gestion d'état stricte
      */
-    onStartServer(routers: TFeatureRoutes[], databaseCallback: (env: any) => void, dependenciesProvider?: TDependency[]): any;
+    private performTrueHotReload;
     /**
-     *
-     * @param serverWeb
+     * Nettoie le cache des modules applicatifs
      */
-    onListeningOnServerEvent(serverWeb: Server): void;
+    private clearApplicationModulesCache;
+    private reloadConfigurations;
+    private reloadDependencies;
     /**
-     *
-     * @param serverWeb
+     * ✅✅✅ Notifier le watcher : SUCCÈS
      */
-    onRequestOnServerEvent(serverWeb: Server): void;
+    private notifyWatcherReloadSuccess;
     /**
-     *
-     * @param allFeatureRoutes
-     * @private
+     * ✅✅✅ Notifier le watcher : BLOQUÉ PAR ERREUR TRANSFORM
      */
-    private registerRoutes;
+    private notifyWatcherBlockedByError;
     /**
-     *
-     * @param localLanguage
-     * @private
+     * ✅✅✅ Notifier le watcher : ERREUR GÉNÉRIQUE
      */
-    private stackTraceErrorHandling;
+    private notifyWatcherReloadError;
     /**
-     *
-     * @private
+     * ✅✅✅ Parser les détails d'une TransformError
      */
+    private parseTransformError;
+    private registerRoutes;
     private infoWebApp;
+    private shutdown;
 }
 
 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 };