opticore-webapp 1.0.70 → 1.0.71

package/dist/index.cjs

@@ -30,20 +30,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  HotReloadWatcher: () => HotReloadWatcher,
   WebServer: () => WebServerCore,
   envPath: () => envPath
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/core/webServer.core.ts
-var path2 = __toESM(require("path"), 1);
-var import_node_process3 = __toESM(require("process"), 1);
+var path3 = __toESM(require("path"), 1);
+var import_node_process4 = __toESM(require("process"), 1);
 var import_cors = __toESM(require("cors"), 1);
 var import_opticore_catch_exception_error3 = require("opticore-catch-exception-error");
 var import_opticore_express2 = require("opticore-express");
 var import_opticore_env_access2 = require("opticore-env-access");
-var import_opticore_http_response3 = require("opticore-http-response");
-var import_opticore_translator2 = require("opticore-translator");
+var import_opticore_http_response4 = require("opticore-http-response");
+var import_opticore_translator3 = require("opticore-translator");
 var import_opticore_request_call_event = require("opticore-request-call-event");
 
 // src/core/handlers/eventProcess.handler.ts
@@ -149,16 +150,35 @@ var dependenciesContainerProvider = (localLang) => {
   return new import_opticore_dependency_inject.SContainer(localLang, dependencies);
 };
 
+// src/application/service/core.service.ts
+var import_opticore_dependency_inject2 = require("opticore-dependency-inject");
+
+// src/utils/parsingDateTime.utils.ts
+var parsingDateTimeUtils = (localFormatTime) => {
+  const now = /* @__PURE__ */ new Date();
+  const formatter = new Intl.DateTimeFormat(localFormatTime, {
+    day: "2-digit",
+    month: "2-digit",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit",
+    hour12: false
+  });
+  return formatter.format(now);
+};
+
 // src/application/service/core.service.ts
 var CoreService = class {
   localLanguage;
   environmentPath;
   serverLog;
   logger;
+  container;
   constructor(localLang, environmentPath) {
     this.loadTranslationFiles();
     this.environmentPath = environmentPath;
     this.localLanguage = localLang;
+    this.container = new import_opticore_dependency_inject2.SContainer(localLang);
     this.serverLog = dependenciesContainerProvider(localLang).resolve("OpticoreLogger");
     this.logger = dependenciesContainerProvider(localLang).resolve("LoggerCore");
   }
@@ -298,7 +318,7 @@ var CoreService = class {
     this.loadTranslationFiles();
     try {
       const getEnvironment = (0, import_opticore_env_access.getEnvironmentValue)(this.environmentPath);
-      const msg5 = getEnvironment.protocolTransfert === "" ? import_ansi_colors.default.underline(`http://${host}:${port}`) : import_ansi_colors.default.underline(`${getEnvironment.protocolTransfert}://${host}:${port}`);
+      const msg5 = getEnvironment.protocolTransfer === "" ? import_ansi_colors.default.underline(`http://${host}:${port}`) : import_ansi_colors.default.underline(`${getEnvironment.protocolTransfer}://${host}:${port}`);
       const messages = [
         import_opticore_translator.TranslationLoader.t("webServerListening", this.localLanguage),
         import_opticore_translator.TranslationLoader.t("webServerUsingNodeVersion", this.localLanguage, { nodeVersion: this.getVersions().nodeVersion }),
@@ -318,17 +338,31 @@ var CoreService = class {
       });
       console.log(border);
       console.log("\n");
-      this.logger.success({
-        title: import_opticore_translator.TranslationLoader.t("serverRunningTitle", this.localLanguage),
-        message: import_opticore_translator.TranslationLoader.t("serverRunningAt", this.localLanguage, { server: msg5 })
-      });
       this.serverLog.serverLog({
-        timestamp: (/* @__PURE__ */ new Date()).toString(),
+        timestamp: parsingDateTimeUtils(getEnvironment.localFormatTime),
         level: "SERVER",
         title: import_opticore_translator.TranslationLoader.t("serverRunningTitle", this.localLanguage),
         typeName: import_opticore_translator.TranslationLoader.t("opticoreServerTypeName", this.localLanguage),
         message: import_opticore_translator.TranslationLoader.t("serverRunningAt", this.localLanguage, { server: msg5 })
       });
+      const dependenciesList = this.container.listDependencies();
+      if (dependenciesList.length > 0) {
+        this.serverLog.opticoreLog({
+          level: "OPTICORE",
+          message: import_opticore_translator.TranslationLoader.t("DEPENDENCIES_STORED", this.localLanguage, { dependenciesList: dependenciesList.join(", ") }),
+          timestamp: parsingDateTimeUtils(getEnvironment.localFormatTime),
+          title: import_opticore_translator.TranslationLoader.t("DEPENDENCIES_CONTAINER", this.localLanguage),
+          typeName: "DEPENDENCIES_CONTAINER"
+        });
+      } else {
+        this.serverLog.opticoreLog({
+          level: "OPTICORE",
+          message: import_opticore_translator.TranslationLoader.t("NO_DEPENDENCIES_STORED", this.localLanguage),
+          timestamp: parsingDateTimeUtils(getEnvironment.localFormatTime),
+          title: import_opticore_translator.TranslationLoader.t("DEPENDENCIES_CONTAINER", this.localLanguage),
+          typeName: "DEPENDENCIES_CONTAINER"
+        });
+      }
     } catch (err) {
       this.logger.error({
         message: err.message,
@@ -392,10 +426,46 @@ var SServerStartError = (err, environmentPath) => {
 };
 
 // src/core/webServer.core.ts
-var import_opticore_dependency_inject2 = require("opticore-dependency-inject");
+var import_opticore_dependency_inject3 = require("opticore-dependency-inject");
+
+// src/application/service/getEnvFileLoading.service.ts
+var import_path = __toESM(require("path"), 1);
+var import_node_process3 = __toESM(require("process"), 1);
+var import_fs = __toESM(require("fs"), 1);
+var import_opticore_translator2 = require("opticore-translator");
+var import_opticore_http_response3 = require("opticore-http-response");
+var getEnvFileLoadingService = (filePath, localLanguage) => {
+  loaderTranslationFile(localLanguage);
+  const logger = dependenciesContainerProvider(localLanguage).resolve("LoggerCore");
+  try {
+    const fullPath = import_path.default.resolve(import_node_process3.default.cwd(), filePath);
+    if (import_fs.default.existsSync(fullPath)) {
+      const env = import_fs.default.readFileSync(fullPath, "utf-8");
+      const lines = env.split("\n");
+      lines.forEach((line) => {
+        const match = line.match(/^([^#=]+)=([^#]+)$/);
+        if (match) {
+          const key = match[1].trim();
+          import_node_process3.default.env[key] = match[2].trim();
+        }
+      });
+    }
+  } catch (err) {
+    logger.error({
+      message: err.message,
+      title: import_opticore_translator2.TranslationLoader.t("EnvFileLoading", localLanguage),
+      errorType: err.code,
+      stackTrace: err.stack,
+      httpCodeValue: import_opticore_http_response3.HttpStatusCode.INTERNAL_SERVER_ERROR
+    });
+  }
+};
+
+// src/core/webServer.core.ts
 var WebServerCore = class {
   serverUtility;
   expressApp = (0, import_opticore_express2.express)();
+  container;
   localLanguage;
   loggerConfig;
   routerExpressApp;
@@ -411,6 +481,7 @@ var WebServerCore = class {
     this.loggerConfig = paramsConstructor.loggerConfig;
     this.localLanguage = paramsConstructor.localLanguage;
     this.environmentPath = paramsConstructor.environmentPath;
+    this.container = new import_opticore_dependency_inject3.SContainer(paramsConstructor.localLanguage);
     this.expressApp.use(import_opticore_express2.express.json());
     this.expressApp.use(import_opticore_express2.express.raw());
     this.expressApp.use(import_opticore_express2.express.text());
@@ -419,16 +490,17 @@ var WebServerCore = class {
     this.serverListenEvent = new import_opticore_catch_exception_error3.ServerListenEventError(paramsConstructor.localLanguage);
     this.serverUtility = new CoreService(paramsConstructor.localLanguage, paramsConstructor.environmentPath);
   }
+  /**
+   *
+   * @param dependencies
+   */
   registerDependencies(dependencies2) {
+    this.loadTranslationFiles();
     try {
+      getEnvFileLoadingService(".env", this.localLanguage);
       if (dependencies2 && dependencies2.length > 0) {
         dependencies2.forEach((dependency) => {
-          return new import_opticore_dependency_inject2.SContainer(this.localLanguage).register(dependency.key, dependency.factory, dependency.scope);
-        });
-      } else {
-        SLogger(this.environmentPath).logger.info({
-          message: import_opticore_translator2.TranslationLoader.t("NO_REGISTER_DEPENDENCIES", this.localLanguage),
-          title: import_opticore_translator2.TranslationLoader.t("REGISTER_DEPENDENCIES", this.localLanguage)
+          this.container.register(dependency.key, dependency.factory, dependency.scope);
         });
       }
     } catch (err) {
@@ -437,12 +509,19 @@ var WebServerCore = class {
         title: "Register Dependencies",
         errorType: err.code,
         stackTrace: err.stack,
-        httpCodeValue: import_opticore_http_response3.HttpStatusCode.INTERNAL_SERVER_ERROR
+        httpCodeValue: import_opticore_http_response4.HttpStatusCode.INTERNAL_SERVER_ERROR
       });
     }
   }
+  /**
+   *
+   * @param routers
+   * @param databaseCallback
+   * @param dependenciesProvider
+   */
   onStartServer(routers, databaseCallback, dependenciesProvider) {
     this.loadTranslationFiles();
+    getEnvFileLoadingService(".env", this.localLanguage);
     if (this.getEnvironmentValue.appPort === "" && Number(this.getEnvironmentValue.appPort) === 0) {
       this.serverListenEvent.hostPortUndefined(Number(this.getEnvironmentValue.appPort));
     } else if (this.getEnvironmentValue.appHost === "") {
@@ -451,11 +530,11 @@ var WebServerCore = class {
       this.serverListenEvent.portUndefined();
     } else if (this.localLanguage === "") {
       SLogger(this.environmentPath).logger.error({
-        message: import_opticore_translator2.TranslationLoader.t("noDefaultLocalLang", this.localLanguage),
-        title: import_opticore_translator2.TranslationLoader.t("noLocalLang", this.localLanguage),
-        errorType: import_opticore_translator2.TranslationLoader.t("localLangMissing", this.localLanguage),
+        message: import_opticore_translator3.TranslationLoader.t("noDefaultLocalLang", this.localLanguage),
+        title: import_opticore_translator3.TranslationLoader.t("noLocalLang", this.localLanguage),
+        errorType: import_opticore_translator3.TranslationLoader.t("localLangMissing", this.localLanguage),
         stackTrace: void 0,
-        httpCodeValue: import_opticore_http_response3.HttpStatusCode.NOT_FOUND
+        httpCodeValue: import_opticore_http_response4.HttpStatusCode.NOT_FOUND
       });
     } else {
       return this.expressApp.listen(
@@ -464,8 +543,11 @@ var WebServerCore = class {
           this.loadTranslationFiles();
           try {
             databaseCallback(this.getEnvironmentValue);
-            new import_opticore_dependency_inject2.SContainer(this.localLanguage, dependenciesProvider);
-            this.expressApp.use(import_opticore_express2.express.static(path2.join(import_node_process3.default.cwd(), "public/template")));
+            if (dependenciesProvider) {
+              this.registerDependencies(dependenciesProvider);
+            }
+            this.container.loadServices();
+            this.expressApp.use(import_opticore_express2.express.static(path3.join(import_node_process4.default.cwd(), "public/template")));
             this.registerRoutes(routers);
           } catch (err) {
             SServerStartError(err, this.environmentPath);
@@ -474,6 +556,10 @@ var WebServerCore = class {
       );
     }
   }
+  /**
+   *
+   * @param serverWeb
+   */
   onListeningOnServerEvent(serverWeb) {
     this.loadTranslationFiles();
     serverWeb.on(import_opticore_catch_exception_error3.CEventNameError.error, (err) => {
@@ -486,6 +572,10 @@ var WebServerCore = class {
       this.infoWebApp();
     });
   }
+  /**
+   *
+   * @param serverWeb
+   */
   onRequestOnServerEvent(serverWeb) {
     this.loadTranslationFiles();
     serverWeb.on(import_opticore_catch_exception_error3.CEventNameError.request, (req, res) => {
@@ -538,8 +628,400 @@ var WebServerCore = class {
     );
   }
 };
+
+// src/hotReload/hotReload.watcher.ts
+var import_child_process = require("child_process");
+var import_fs2 = require("fs");
+var import_promises = require("fs/promises");
+var import_path2 = require("path");
+var import_dotenv = require("dotenv");
+var import_chalk2 = __toESM(require("chalk"), 1);
+var import_ansi_colors2 = __toESM(require("ansi-colors"), 1);
+var import_gradient_string = __toESM(require("gradient-string"), 1);
+var DEFAULT_WATCH_EXTENSIONS = [".ts", ".js", ".mjs", ".cjs", ".json"];
+var DEFAULT_HOT_RELOAD_EXTENSIONS = [".json"];
+var DEFAULT_IGNORE = [
+  "node_modules",
+  "dist",
+  ".git",
+  "package.json",
+  "package-lock.json",
+  ".idea",
+  ".vscode",
+  "coverage",
+  "logs"
+];
+var DEFAULT_DEBOUNCE_MS = 300;
+var DEFAULT_MAX_CRASH_RESTARTS = 5;
+var HotReloadWatcher = class {
+  cfg;
+  child = null;
+  watchers = [];
+  debounceTimer = null;
+  isRestarting = false;
+  crashRestartCount = 0;
+  started = false;
+  restartStart = 0;
+  constructor(config) {
+    this.cfg = {
+      entry: (0, import_path2.resolve)(config.entry),
+      runtime: config.runtime ?? "node",
+      runtimeArgs: config.runtimeArgs ?? [],
+      rootDir: (0, import_path2.resolve)(config.rootDir ?? process.cwd()),
+      watchDirs: config.watchDirs ?? [],
+      watchExtensions: config.watchExtensions ?? DEFAULT_WATCH_EXTENSIONS,
+      ignore: [...DEFAULT_IGNORE, ...config.ignore ?? []],
+      envFile: config.envFile ?? ".env",
+      hotReloadExtensions: config.hotReloadExtensions ?? DEFAULT_HOT_RELOAD_EXTENSIONS,
+      debounceMs: config.debounceMs ?? DEFAULT_DEBOUNCE_MS,
+      restartOnCrash: config.restartOnCrash ?? true,
+      maxCrashRestarts: config.maxCrashRestarts ?? DEFAULT_MAX_CRASH_RESTARTS
+    };
+  }
+  // ─── Public API ──────────────────────────────────────────────────────────
+  async start() {
+    if (this.started) return;
+    this.started = true;
+    this.printBanner();
+    this.spawnChild();
+    await this.setupWatchers();
+    this.setupProcessSignals();
+  }
+  async stop() {
+    this.watchers.forEach((w) => {
+      w.close();
+    });
+    this.watchers = [];
+    await this.killChild(true);
+    this.printStopped();
+  }
+  // ─── Child process management ────────────────────────────────────────────
+  spawnChild() {
+    const { entry, runtime, runtimeArgs } = this.cfg;
+    try {
+      this.child = runtime === "node" ? (0, import_child_process.fork)(entry, [], {
+        stdio: ["inherit", "inherit", "inherit", "ipc"],
+        env: process.env
+      }) : (0, import_child_process.spawn)(runtime, [...runtimeArgs, entry], {
+        stdio: "inherit",
+        env: process.env,
+        shell: false
+      });
+      this.child.on("exit", (code) => {
+        if (this.isRestarting) return;
+        if (code !== 0 && code !== null) {
+          this.printCrash(code);
+          if (this.cfg.restartOnCrash && this.crashRestartCount < this.cfg.maxCrashRestarts) {
+            this.crashRestartCount++;
+            this.printCrashRetry(this.crashRestartCount, this.cfg.maxCrashRestarts);
+            setTimeout(() => {
+              this.spawnChild();
+            }, 1e3);
+          } else if (this.crashRestartCount >= this.cfg.maxCrashRestarts) {
+            this.printCrashLimit(this.cfg.maxCrashRestarts);
+            process.exit(1);
+          }
+        }
+      });
+      this.child.on("error", (err) => {
+        this.printError(`Failed to start child process: ${err.message}`);
+      });
+    } catch (err) {
+      this.printError(`Cannot spawn '${runtime} ${entry}': ${err.message}`);
+      process.exit(1);
+    }
+  }
+  async killChild(silent = false) {
+    if (!this.child) return;
+    const child = this.child;
+    this.child = null;
+    await new Promise((done) => {
+      const forceKill = setTimeout(() => {
+        child.kill("SIGKILL");
+        done();
+      }, 3e3);
+      child.once("exit", () => {
+        clearTimeout(forceKill);
+        done();
+      });
+      child.kill("SIGTERM");
+    });
+  }
+  // ─── File watching ────────────────────────────────────────────────────────
+  async setupWatchers() {
+    const dirs = [
+      this.cfg.rootDir,
+      ...this.cfg.watchDirs.map((d) => (0, import_path2.resolve)(d))
+    ];
+    for (const dir of dirs) {
+      await this.watchDirectoryRecursive(dir);
+    }
+  }
+  async watchDirectoryRecursive(dir) {
+    if (this.shouldIgnoreDir(dir)) return;
+    try {
+      await (0, import_promises.access)(dir);
+    } catch {
+      return;
+    }
+    try {
+      const watcher = (0, import_fs2.watch)(dir, (event2, filename) => {
+        if (!filename) return;
+        this.onFileChange((0, import_path2.join)(dir, filename));
+      });
+      watcher.on("error", () => {
+      });
+      this.watchers.push(watcher);
+      const entries = await (0, import_promises.readdir)(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          await this.watchDirectoryRecursive((0, import_path2.join)(dir, entry.name));
+        }
+      }
+    } catch {
+    }
+  }
+  // ─── Change handling ─────────────────────────────────────────────────────
+  onFileChange(filePath) {
+    if (this.shouldIgnoreFile(filePath)) return;
+    if (!this.isWatchedFile(filePath)) return;
+    const rel = (0, import_path2.relative)(this.cfg.rootDir, filePath);
+    if (this.isHotReloadable(filePath)) {
+      this.doHotReload(filePath, rel);
+    } else {
+      this.scheduleRestart(rel);
+    }
+  }
+  doHotReload(filePath, relativePath) {
+    if (this.isEnvFile(filePath)) {
+      (0, import_dotenv.config)({ path: filePath, override: true });
+      this.printHot(relativePath, "env variables reloaded");
+      this.sendIpc({ type: "hot-reload", file: relativePath, kind: "env" });
+    } else {
+      this.printHot(relativePath, "json config reloaded");
+      this.sendIpc({ type: "hot-reload", file: relativePath, kind: "json" });
+    }
+  }
+  scheduleRestart(relativePath) {
+    if (this.debounceTimer) clearTimeout(this.debounceTimer);
+    this.debounceTimer = setTimeout(async () => {
+      this.printReloading(relativePath);
+      this.restartStart = Date.now();
+      this.isRestarting = true;
+      this.crashRestartCount = 0;
+      await this.killChild(true);
+      this.isRestarting = false;
+      this.spawnChild();
+      this.printReady(Date.now() - this.restartStart);
+    }, this.cfg.debounceMs);
+  }
+  // ─── IPC ─────────────────────────────────────────────────────────────────
+  sendIpc(message) {
+    if (this.child && typeof this.child.send === "function") {
+      try {
+        this.child.send(message);
+      } catch {
+      }
+    }
+  }
+  // ─── Ignore / watch filters ───────────────────────────────────────────────
+  shouldIgnoreDir(dirPath) {
+    return this.cfg.ignore.some((p) => dirPath.includes(`/${p}`) || dirPath.endsWith(p));
+  }
+  shouldIgnoreFile(filePath) {
+    const name = (0, import_path2.basename)(filePath);
+    const rel = (0, import_path2.relative)(this.cfg.rootDir, filePath);
+    return this.cfg.ignore.some((p) => name === p || rel.includes(p) || filePath.includes(`/${p}/`));
+  }
+  isWatchedFile(filePath) {
+    if (this.isEnvFile(filePath)) return true;
+    return this.cfg.watchExtensions.includes((0, import_path2.extname)(filePath));
+  }
+  isHotReloadable(filePath) {
+    if (this.isEnvFile(filePath)) return true;
+    return this.cfg.hotReloadExtensions.includes((0, import_path2.extname)(filePath));
+  }
+  isEnvFile(filePath) {
+    const name = (0, import_path2.basename)(filePath);
+    return name === this.cfg.envFile || name.startsWith(".env");
+  }
+  // ─── ANSI strip helper (for width calculation) ────────────────────────────
+  strip(str) {
+    return str.replace(/\[[0-9;]*m/g, "").replace(/\][^]*/g, "");
+  }
+  // ─── Timestamp ────────────────────────────────────────────────────────────
+  ts() {
+    const n = /* @__PURE__ */ new Date();
+    const h = String(n.getHours()).padStart(2, "0");
+    const m = String(n.getMinutes()).padStart(2, "0");
+    const s = String(n.getSeconds()).padStart(2, "0");
+    return `${h}:${m}:${s}`;
+  }
+  // ─── Console output ───────────────────────────────────────────────────────
+  /**
+   * Startup banner — mirrors the infoServer() box style from CoreService.
+   *
+   *   ╔══════════════════════════════════════════╗
+   *   gradient title
+   *   ╔══ bgGreen box ════════════════════════╗
+   *    entry    dist/index.js
+   *    runtime  node  (IPC enabled)
+   *    root     ./src
+   *    watching .ts  .js  .json  .env
+   *    debounce 300ms
+   *   ╚══════════════════════════════════════════╝
+   */
+  printBanner() {
+    const entryRel = (0, import_path2.relative)(process.cwd(), this.cfg.entry) || this.cfg.entry;
+    const rootRel = (0, import_path2.relative)(process.cwd(), this.cfg.rootDir) || ".";
+    const runtimeStr = this.cfg.runtime === "node" ? `node  ${import_chalk2.default.blackBright("(IPC enabled)")}` : this.cfg.runtime;
+    const extStr = [...this.cfg.watchExtensions, ".env"].join("  ");
+    const ignoreStr = this.cfg.ignore.slice(0, 4).join("  ") + (this.cfg.ignore.length > 4 ? `  ${import_chalk2.default.blackBright(`+${this.cfg.ignore.length - 4} more`)}` : "");
+    const TITLE = "OPTICORE  HOT  RELOAD";
+    const rows = [
+      ` entry     ${import_chalk2.default.white.bold(entryRel)}`,
+      ` runtime   ${runtimeStr}`,
+      ` root      ${import_chalk2.default.white(rootRel)}`,
+      ` watching  ${import_chalk2.default.cyan(extStr)}`,
+      ` ignoring  ${import_chalk2.default.blackBright(ignoreStr)}`,
+      ` debounce  ${import_chalk2.default.white(`${this.cfg.debounceMs}ms`)}`
+    ];
+    const maxLen = Math.max(
+      TITLE.length + 4,
+      ...rows.map((r) => this.strip(r).length)
+    ) + 4;
+    const border = import_chalk2.default.bgGreen.white(" ".repeat(maxLen));
+    const titlePad = " ".repeat(Math.max(0, Math.floor((maxLen - TITLE.length) / 2)));
+    console.log("\n" + titlePad + (0, import_gradient_string.default)(["#43e97b", "#38f9d7", "#00c6fb"])(TITLE));
+    console.log(border);
+    rows.forEach((row) => {
+      const cleanLen = this.strip(row).length;
+      const padding = Math.max(0, maxLen - cleanLen - 2);
+      console.log(import_chalk2.default.bgGreen.white(` ${row}${" ".repeat(padding)} `));
+    });
+    console.log(border);
+    console.log(import_chalk2.default.blackBright(` watching for changes...
+`));
+  }
+  /**
+   * HOT event — in-process reload, no server restart.
+   *
+   *   ✔  [ HOT ]  14:23:45  |  .env                →  env variables reloaded
+   */
+  printHot(file, action) {
+    const badge = import_ansi_colors2.default.bgCyan(import_ansi_colors2.default.white.bold("  HOT  "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    const filePart = import_chalk2.default.cyan.bold(file.padEnd(32));
+    const arrow = import_chalk2.default.green("\u2192");
+    const msg = import_chalk2.default.green(action);
+    console.log(`  ${import_chalk2.default.green("\u2714")}  ${badge}  ${ts}  ${sep}  ${filePart} ${arrow}  ${msg}`);
+  }
+  /**
+   * RELOAD event — server restart triggered.
+   *
+   *   ⚡  [ RELOAD ]  14:24:03  |  src/routes/user.ts   →  restarting server...
+   */
+  printReloading(file) {
+    const badge = import_ansi_colors2.default.bgYellow(import_ansi_colors2.default.white.bold(" RELOAD "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    const filePart = import_chalk2.default.yellow.bold(file.padEnd(32));
+    const arrow = import_chalk2.default.yellow("\u2192");
+    const msg = import_chalk2.default.yellow("restarting server...");
+    console.log(`
+  ${import_chalk2.default.yellow("\u26A1")}  ${badge}  ${ts}  ${sep}  ${filePart} ${arrow}  ${msg}`);
+  }
+  /**
+   * READY event — server successfully restarted.
+   * Uses the same full-width bgGreen border as infoServer().
+   *
+   *   ════════════════════════════════════════════
+   *    READY   server restarted in 245ms
+   *   ════════════════════════════════════════════
+   */
+  printReady(elapsedMs) {
+    const msg = `  server restarted in ${import_chalk2.default.white.bold(`${elapsedMs}ms`)}`;
+    const cleanLen = this.strip(msg).length;
+    const width = Math.max(52, cleanLen + 6);
+    const border = import_chalk2.default.bgGreen.white(" ".repeat(width));
+    const padding = Math.max(0, width - cleanLen - 2);
+    const line = import_chalk2.default.bgGreen.white(` ${import_chalk2.default.bgGreen.white.bold("  READY ")} ${msg}${" ".repeat(padding)} `);
+    console.log(`  ${border}`);
+    console.log(`  ${line}`);
+    console.log(`  ${border}
+`);
+  }
+  /**
+   * CRASH event — unexpected child process exit.
+   *
+   *   ✘  [ CRASH ]  14:24:10  |  server exited with code 1
+   */
+  printCrash(code) {
+    const badge = import_ansi_colors2.default.bgRed(import_ansi_colors2.default.white.bold("  CRASH "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    const msg = import_chalk2.default.red(`server exited with code ${import_chalk2.default.bold(String(code))}`);
+    console.log(`
+  ${import_chalk2.default.red("\u2718")}  ${badge}  ${ts}  ${sep}  ${msg}`);
+  }
+  /**
+   * RETRY event — auto-restart after crash.
+   *
+   *   ↺  [ RETRY ]  14:24:11  |  attempt 1 / 5
+   */
+  printCrashRetry(attempt, max) {
+    const badge = import_ansi_colors2.default.bgMagenta(import_ansi_colors2.default.white.bold("  RETRY "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    const msg = import_chalk2.default.magenta(`auto-restart attempt ${import_chalk2.default.bold(`${attempt} / ${max}`)}`);
+    console.log(`  ${import_chalk2.default.magenta("\u21BA")}  ${badge}  ${ts}  ${sep}  ${msg}`);
+  }
+  /**
+   * LIMIT reached — give up restarting.
+   */
+  printCrashLimit(max) {
+    const badge = import_ansi_colors2.default.bgRed(import_ansi_colors2.default.white.bold("  ERROR "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    const msg = import_chalk2.default.red(`max crash restarts reached (${import_chalk2.default.bold(String(max))}), giving up`);
+    console.log(`
+  ${import_chalk2.default.red("\u2718")}  ${badge}  ${ts}  ${sep}  ${msg}
+`);
+  }
+  /**
+   * Error — miscellaneous internal error.
+   */
+  printError(message) {
+    const badge = import_ansi_colors2.default.bgRed(import_ansi_colors2.default.white.bold("  ERROR "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    console.error(`  ${import_chalk2.default.red("\u2718")}  ${badge}  ${ts}  ${sep}  ${import_chalk2.default.red(message)}`);
+  }
+  /**
+   * Stopped — watcher shut down.
+   */
+  printStopped() {
+    const badge = import_ansi_colors2.default.bgBlackBright(import_ansi_colors2.default.white.bold(" STOPPED"));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    console.log(`  ${import_chalk2.default.gray("\u25A0")}  ${badge}  ${ts}  ${sep}  ${import_chalk2.default.gray("watcher stopped")}
+`);
+  }
+  // ─── Graceful shutdown ────────────────────────────────────────────────────
+  setupProcessSignals() {
+    const shutdown = async () => {
+      console.log("");
+      await this.stop();
+      process.exit(0);
+    };
+    process.once("SIGINT", shutdown);
+    process.once("SIGTERM", shutdown);
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  HotReloadWatcher,
   WebServer,
   envPath
 });