koatty 3.13.2 → 4.0.3

package/dist/index.js

@@ -1,6 +1,6 @@
 /*!
 * @Author: richen
-* @Date: 2025-04-25 21:47:59
+* @Date: 2026-01-28 11:05:04
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/
@@ -19,17 +19,19 @@ var a = require("koatty_lib");
 
 var n = require("koatty_router");
 
-var s = require("koatty_logger");
+var i = require("koatty_logger");
 
-var i = require("koatty_loader");
+var s = require("koatty_loader");
 
 var l = require("koatty_serve");
 
+var p = require("koatty_trace");
+
 var c = require("path");
 
-function p(e) {
+function d(e) {
   var t = Object.create(null);
-  if (e) Object.keys(e).forEach((function(o) {
+  if (e) Object.keys(e).forEach(function(o) {
     if (o !== "default") {
       var r = Object.getOwnPropertyDescriptor(e, o);
       Object.defineProperty(t, o, r.get ? r : {
@@ -39,17 +41,17 @@ function p(e) {
         }
       });
     }
-  }));
+  });
   t.default = e;
   return Object.freeze(t);
 }
 
-var f = p(c);
+var f = d(c);
 
-var d = "3.13.2";
+var u = "4.0.3";
 
-var u = {
-  node: ">12.0.0"
+var g = {
+  node: ">=18.0.0"
 };
 
 /*
@@ -60,16 +62,25 @@ var u = {
  * @LastEditTime: 2024-10-31 17:52:43
  * @License: BSD (3-Clause)
  * @Copyright (c): <richenlin(at)gmail.com>
- */ const g = s.DefaultLogger;
+ */ const y = i.DefaultLogger;
 
-function h(e, t) {
-  if (t.logLevel) s.DefaultLogger.setLevel(t.logLevel);
+function L(e, t) {
+  if (!e.appDebug) i.DefaultLogger.enableBuffering({
+    maxBufferSize: 200,
+    flushInterval: 500,
+    flushOnLevel: "error"
+  });
+  if (t.logLevel) i.DefaultLogger.setLevel(t.logLevel);
   if (t.logFilePath && !e.silent) {
     a.Helper.define(e, "logsPath", t.logFilePath);
     process.env.LOGS_PATH = t.logFilePath;
-    s.DefaultLogger.setLogFilePath(t.logFilePath);
+    i.DefaultLogger.setLogFilePath(t.logFilePath);
   }
-  if (t.sensFields) s.DefaultLogger.setSensFields(t.sensFields);
+  if (t.sensFields) i.DefaultLogger.setSensFields(t.sensFields);
+  e.once(o.AppEvent.appStop, async () => {
+    await i.DefaultLogger.flush();
+    await i.DefaultLogger.destroy();
+  });
 }
 
 /*
@@ -80,11 +91,11 @@ function h(e, t) {
  * @LastEditTime: 2025-01-14 16:14:10
  * @License: BSD (3-Clause)
  * @Copyright (c): <richenlin(at)gmail.com>
- */ const y = d;
+ */ const v = u;
 
-const C = u.node.slice(1) || "12.0.0";
+const E = g.node.slice(1) || "12.0.0";
 
-function m(e, t, o, r) {
+function h(e, t, o, r) {
   if (a.Helper.isClass(o) && o.name != e) throw Error(`The file(${t}) name should be always the same as class name.`);
   if (o["__esModule"]) if (o.name === void 0) {
     const r = Object.keys(o);
@@ -96,19 +107,19 @@ function m(e, t, o, r) {
   return;
 }
 
-function L() {
-  let e = C;
+function C() {
+  let e = E;
   e = e.slice(0, e.lastIndexOf("."));
   let t = process.version;
   if (t[0] === "v") t = t.slice(1);
   t = t.slice(0, t.lastIndexOf("."));
   if (a.Helper.toNumber(e) > a.Helper.toNumber(t)) {
-    g.Error(`Koatty need node version > ${e}, current version is ${t}, please upgrade it.`);
+    y.Fatal(`Koatty need node version > ${e}, current version is ${t}, please upgrade it.`);
     process.exit(-1);
   }
 }
 
-const v = () => {
+const m = () => {
   let e = !1;
   const t = JSON.stringify(process.argv[1]);
   if (t.indexOf("jest") > -1) e = !0;
@@ -123,11 +134,11 @@ const v = () => {
  * @LastEditTime: 2023-12-09 23:00:13
  * @License: BSD (3-Clause)
  * @Copyright (c): <richenlin(at)gmail.com>
- */ const E = "COMPONENT_SCAN";
+ */ const w = "COMPONENT_SCAN";
 
 const O = "CONFIGURATION_SCAN";
 
-const w = `\n\n┬┌─┌─┐┌─┐┌┬┐┌┬┐┬ ┬\n├┴┐│ │├─┤ │  │ └┬┘\n┴ ┴└─┘┴ ┴ ┴  ┴  ┴ \n-------------------------------------------\nhttps://github.com/koatty\n`
+const A = `\n\n┬┌─┌─┐┌─┐┌┬┐┌┬┐┬ ┬\n├┴┐│ │├─┤ │  │ └┬┘\n┴ ┴└─┘┴ ┴ ┴  ┴  ┴ \n-------------------------------------------\nhttps://github.com/koatty\n`
 /*
  * @Description: framework loader
  * @Usage:
@@ -143,7 +154,7 @@ class Loader {
     this.app = e;
   }
   static initialize(e) {
-    if (e.env == "development") g.setLevel("debug"); else g.setLevel("info");
+    if (e.env == "development") y.setLevel("debug"); else y.setLevel("info");
     const t = e.rootPath || process.cwd();
     const o = e.appPath || f.resolve(t, e.appDebug ? "src" : "dist");
     const r = f.resolve(__dirname, "..");
@@ -157,6 +168,7 @@ class Loader {
         e.version = e.version || t.version;
       }
     }
+    y.Warn("Using process.env for paths is deprecated. Use app.rootPath, app.appPath, app.koattyPath instead.");
     process.env.ROOT_PATH = t;
     process.env.APP_PATH = o;
     process.env.KOATTY_PATH = r;
@@ -165,7 +177,7 @@ class Loader {
   }
   static GetComponentMeta(e, o) {
     let r = [];
-    const n = t.IOC.getClassMetadata(t.TAGGED_CLS, E, o);
+    const n = t.IOC.getClassMetadata(t.TAGGED_CLS, w, o);
     if (n) if (a.Helper.isArray(n)) r = n; else r.push(n);
     if (r.length < 1) r = [ e.appPath ];
     return r;
@@ -180,9 +192,9 @@ class Loader {
     const o = Loader.GetComponentMeta(e, t);
     const r = Loader.GetConfigurationMeta(e, t);
     const a = new Set;
-    i.Load(o, "", ((e, t, o) => {
-      m(e, t, o, a);
-    }), [ "**/**.js", "**/**.ts", "!**/**.d.ts" ], [ ...r, `${t.name || ".no"}.ts` ]);
+    s.Load(o, "", (e, t, o) => {
+      h(e, t, o, a);
+    }, [ "**/**.js", "**/**.ts", "!**/**.d.ts" ], [ ...r, `${t.name || ".no"}.ts` ]);
     a.clear();
   }
   static SetLogger(e) {
@@ -195,7 +207,7 @@ class Loader {
       if (t.logsLevel) r = t.logsLevel.toLowerCase();
       if (t.logsPath) a = t.logsPath;
       if (t.sensFields) n = t.sensFields;
-      h(e, {
+      L(e, {
         logLevel: r,
         logFilePath: a,
         sensFields: n
@@ -205,78 +217,155 @@ class Loader {
   static LoadAppEventHooks(e, r) {
     const n = new Map;
     for (const e of o.AppEventArr) {
-      let o;
+      let i;
       switch (e) {
-       case "appBoot":
-        o = t.IOC.getClassMetadata(t.TAGGED_CLS, "appBoot", r);
-        if (a.Helper.isArray(o)) n.set("appBoot", o);
+       case o.AppEvent.appBoot:
+        i = t.IOC.getClassMetadata(t.TAGGED_CLS, o.AppEvent.appBoot, r);
+        if (a.Helper.isArray(i)) n.set(o.AppEvent.appBoot, i);
         break;
 
-       case "appReady":
-        o = t.IOC.getClassMetadata(t.TAGGED_CLS, "appReady", r);
-        if (a.Helper.isArray(o)) n.set("appReady", o);
+       case o.AppEvent.appReady:
+        i = t.IOC.getClassMetadata(t.TAGGED_CLS, o.AppEvent.appReady, r);
+        if (a.Helper.isArray(i)) n.set(o.AppEvent.appReady, i);
         break;
 
-       case "appStart":
-        o = t.IOC.getClassMetadata(t.TAGGED_CLS, "appStart", r);
-        if (a.Helper.isArray(o)) n.set("appStart", o);
+       case o.AppEvent.appStart:
+        i = t.IOC.getClassMetadata(t.TAGGED_CLS, o.AppEvent.appStart, r);
+        if (a.Helper.isArray(i)) n.set(o.AppEvent.appStart, i);
         break;
 
-       case "appStop":
-        o = t.IOC.getClassMetadata(t.TAGGED_CLS, "appStop", r);
-        if (a.Helper.isArray(o)) n.set("appStop", o);
+       case o.AppEvent.appStop:
+        i = t.IOC.getClassMetadata(t.TAGGED_CLS, o.AppEvent.appStop, r);
+        if (a.Helper.isArray(i)) n.set(o.AppEvent.appStop, i);
         break;
       }
     }
-    for (const [t, o] of n) for (const r of o) e.once(t, (() => r(e)));
+    for (const [t, o] of n) for (const r of o) e.once(t, () => r(e));
   }
-  static async LoadAllComponents(e, t) {
-    var o, r, s;
-    g.Log("Koatty", "", "Load Configurations ...");
-    const i = Loader.GetConfigurationMeta(e, t);
-    const c = new Loader(e);
-    c.LoadConfigs(i);
-    const p = (o = e.config("server")) !== null && o !== void 0 ? o : {
-      protocol: "http"
-    };
-    const f = (r = p.protocol) !== null && r !== void 0 ? r : "http";
-    a.Helper.define(e, "server", l.NewServe(e, p));
-    const d = (s = e.config(void 0, "router")) !== null && s !== void 0 ? s : {};
-    a.Helper.define(e, "router", n.NewRouter(e, {
-      protocol: f,
-      ...d
-    }));
-    g.Log("Koatty", "", "Load Components ...");
-    await c.LoadComponents();
-    g.Log("Koatty", "", "Load Middlewares ...");
-    await c.LoadMiddlewares();
-    g.Log("Koatty", "", "Load Services ...");
-    await c.LoadServices();
-    g.Log("Koatty", "", "Load Controllers ...");
-    const u = await c.LoadControllers();
-    g.Log("Koatty", "", "Load Routers ...");
-    c.LoadRouter(u);
+  static async LoadAllComponents(e, r) {
+    try {
+      if (a.Helper.isFunction(t.IOC.preloadMetadata)) t.IOC.preloadMetadata();
+    } catch {
+      y.Warn("[Loader] preloadMetadata is optional, ignore if not available");
+    }
+    y.Log("Koatty", "", "Load Configurations ...");
+    const n = Loader.GetConfigurationMeta(e, r);
+    const i = new Loader(e);
+    i.LoadConfigs(n);
+    Loader.SetLogger(e);
+    y.Log("Koatty", "", "Emit Config Loaded ...");
+    await o.asyncEvent(e, o.AppEvent.configLoaded);
+    y.Log("Koatty", "", "Initializing Component Manager ...");
+    const s = new o.ComponentManager(e);
+    a.Helper.define(e, "componentManager", s);
+    s.discoverPlugins();
+    s.registerCorePluginHooks();
+    const l = s.getStats();
+    y.Log("Koatty", "", `Discovered ${l.corePlugins} core plugins, ${l.userPlugins} user plugins`);
+    y.Log("Koatty", "", "Emit Before Component Load ...");
+    await o.asyncEvent(e, o.AppEvent.beforeComponentLoad);
+    y.Log("Koatty", "", "Load Components ...");
+    await i.LoadComponents(s);
+    y.Log("Koatty", "", "Emit After Component Load ...");
+    await o.asyncEvent(e, o.AppEvent.afterComponentLoad);
+    y.Log("Koatty", "", "Emit Before Middleware Load ...");
+    await o.asyncEvent(e, o.AppEvent.beforeMiddlewareLoad);
+    y.Log("Koatty", "", "Load Middlewares ...");
+    await i.LoadMiddlewares();
+    y.Log("Koatty", "", "Emit After Middleware Load ...");
+    await o.asyncEvent(e, o.AppEvent.afterMiddlewareLoad);
+    y.Log("Koatty", "", "Emit Before Service Load ...");
+    await o.asyncEvent(e, o.AppEvent.beforeServiceLoad);
+    y.Log("Koatty", "", "Load Services ...");
+    await i.LoadServices();
+    y.Log("Koatty", "", "Emit After Service Load ...");
+    await o.asyncEvent(e, o.AppEvent.afterServiceLoad);
+    y.Log("Koatty", "", "Emit Before Controller Load ...");
+    await o.asyncEvent(e, o.AppEvent.beforeControllerLoad);
+    y.Log("Koatty", "", "Load Controllers ...");
+    const p = await i.LoadControllers();
+    y.Log("Koatty", "", "Emit After Controller Load ...");
+    await o.asyncEvent(e, o.AppEvent.afterControllerLoad);
+    y.Log("Koatty", "", "Emit Before Router Load ...");
+    await o.asyncEvent(e, o.AppEvent.beforeRouterLoad);
+    y.Log("Koatty", "", "Load Routers ...");
+    await i.LoadRouter(p);
+    y.Log("Koatty", "", "Emit After Router Load ...");
+    await o.asyncEvent(e, o.AppEvent.afterRouterLoad);
+  }
+  static CreateServers(e, t, o) {
+    if (o.length > 1) {
+      const r = [];
+      const n = a.Helper.isArray(t.port) ? t.port : [ t.port ];
+      const i = [];
+      for (let e = 0; e < o.length; e++) if (e < n.length) i.push(a.Helper.toNumber(n[e])); else i.push(a.Helper.toNumber(n[0]) + e);
+      for (let a = 0; a < o.length; a++) {
+        const n = o[a];
+        const s = {
+          ...t,
+          protocol: n,
+          port: i[a]
+        };
+        r.push(l.NewServe(e, s));
+      }
+      return r;
+    } else {
+      const r = o[0];
+      const a = {
+        protocol: r,
+        ...t
+      };
+      return l.NewServe(e, a);
+    }
+  }
+  static CreateRouters(e, t, o) {
+    if (o.length > 1) {
+      const r = {};
+      for (const a of o) {
+        const o = {
+          protocol: a,
+          ...t
+        };
+        if (t.ext && t.ext[a]) o.ext = t.ext[a];
+        r[a] = n.NewRouter(e, o);
+      }
+      return r;
+    } else {
+      const r = o[0];
+      return n.NewRouter(e, {
+        protocol: r,
+        ...t
+      });
+    }
   }
   LoadConfigs(t) {
     const o = {};
-    i.Load([ "./config" ], this.app.koattyPath, (function(e, t, r) {
+    s.Load([ "./config" ], this.app.koattyPath, function(e, t, r) {
       o[e] = r;
-    }));
+    });
     if (a.Helper.isArray(t)) t = t.length > 0 ? t : [ "./config" ];
     let r = e.LoadConfigs(t, this.app.appPath);
     r = a.Helper.extend(o, r, !0);
     this.app.setMetaData("_configs", r);
   }
   async LoadMiddlewares() {
-    var e;
-    let r = this.app.config(void 0, "middleware");
-    if (a.Helper.isEmpty(r)) r = {
+    var e, r, n;
+    try {
+      const t = (e = this.app.config("trace")) !== null && e !== void 0 ? e : {};
+      const o = p.Trace(t, this.app);
+      a.Helper.define(this.app, "tracer", o);
+      this.app.use(o);
+      y.Debug(`Load trace middleware`);
+    } catch (e) {
+      y.Warn(`Trace middleware failed to load: ${e.message}`);
+    }
+    let i = this.app.config(void 0, "middleware");
+    if (a.Helper.isEmpty(i)) i = {
       config: {},
-      list: [],
-      routeList: []
+      list: []
     };
-    const n = (e = t.IOC.listClass("MIDDLEWARE")) !== null && e !== void 0 ? e : [];
-    n.forEach((e => {
+    const s = (r = t.IOC.listClass("MIDDLEWARE")) !== null && r !== void 0 ? r : [];
+    s.forEach(e => {
       var r;
       e.id = ((r = e.id) !== null && r !== void 0 ? r : "").replace("MIDDLEWARE:", "");
       if (e.id && a.Helper.isClass(e.target)) {
@@ -288,44 +377,54 @@ class Loader {
         const r = t.IOC.getInsByClass(e.target);
         if (!o.implementsMiddlewareInterface(r)) throw Error(`The middleware ${e.id} must implements interface 'IMiddleware'.`);
       }
-    }));
-    const s = r.list || [];
-    const i = new Set([]);
-    s.forEach((e => {
-      i.add(e);
-    }));
-    const l = r.routeList || [];
+    });
+    const l = i.list || [];
     const c = new Set([]);
-    l.forEach((e => {
+    l.forEach(e => {
       c.add(e);
-    }));
-    const p = r.config || {};
-    for (const e of i) {
-      const o = t.IOC.get(e, "MIDDLEWARE");
-      if (!o) throw Error(`Middleware ${e} load error.`);
-      if (!a.Helper.isFunction(o.run)) throw Error(`The middleware ${e} must implements interface 'IMiddleware'.`);
-      g.Debug(`Load middleware: ${e}`);
-      const r = p[e] || {};
-      const n = await o.run(r, this.app);
-      if (a.Helper.isFunction(n)) if (n.length < 3) this.app.use(n); else this.app.useExp(n);
-    }
+    });
+    const d = i.config || {};
     for (const e of c) {
       const r = t.IOC.get(e, "MIDDLEWARE");
-      if (!r) throw Error(`Router middleware ${e} load error.`);
-      if (!a.Helper.isFunction(r.run)) throw Error(`The router middleware ${e} must implements interface 'IMiddleware'.`);
-      g.Debug(`Load router middleware: ${e}`);
-      const n = await r.run(p[e] || {}, this.app);
-      if (a.Helper.isFunction(n)) this.app.setMetaData(`routerMiddleware_${e}`, n.length > 2 ? o.parseExp(n) : n);
+      if (!r) throw Error(`Middleware ${e} load error.`);
+      if (!a.Helper.isFunction(r.run)) throw Error(`The middleware ${e} must implements interface 'IMiddleware'.`);
+      y.Debug(`Load middleware: ${e}`);
+      const i = d[e] || {};
+      const l = (n = s.find(t => t.id === e)) === null || n === void 0 ? void 0 : n.target;
+      let p = {};
+      if (l) try {
+        p = t.IOC.getPropertyData(o.MIDDLEWARE_OPTIONS, l, e) || {};
+      } catch {
+        p = {};
+      }
+      const c = {
+        ...p,
+        ...i
+      };
+      if (c.enabled === !1) {
+        y.Warn(`The middleware ${e} has been loaded but is disabled.`);
+        continue;
+      }
+      const f = await r.run(c, this.app);
+      if (a.Helper.isFunction(f)) {
+        let t = f;
+        if (c.protocol) {
+          const r = a.Helper.isArray(c.protocol) ? c.protocol : [ c.protocol ];
+          y.Log("Koatty", "", `Middleware ${e} limited to protocols: ${r.join(", ")}`);
+          t = o.protocolMiddleware(r, f);
+        }
+        if (t.length < 3) this.app.use(t); else this.app.useExp(t);
+      }
     }
   }
   async LoadControllers() {
     const e = t.IOC.listClass("CONTROLLER");
     const r = [];
-    e.forEach((e => {
+    e.forEach(e => {
       var n;
       e.id = ((n = e.id) !== null && n !== void 0 ? n : "").replace("CONTROLLER:", "");
       if (e.id && a.Helper.isClass(e.target)) {
-        g.Debug(`Load controller: ${e.id}`);
+        y.Debug(`Load controller: ${e.id}`);
         t.IOC.reg(e.id, e.target, {
           scope: "Prototype",
           type: "CONTROLLER",
@@ -335,31 +434,30 @@ class Loader {
         if (!o.implementsControllerInterface(a)) throw Error(`The controller ${e.id} must implements interface 'IController'.`);
         r.push(e.id);
       }
-    }));
+    });
     return r;
   }
   async LoadServices() {
-    const e = t.IOC.listClass("SERVICE");
-    e.forEach((e => {
-      var r;
-      e.id = ((r = e.id) !== null && r !== void 0 ? r : "").replace("SERVICE:", "");
-      if (e.id && a.Helper.isClass(e.target)) {
-        g.Debug(`Load service: ${e.id}`);
-        t.IOC.reg(e.id, e.target, {
+    var e;
+    const r = t.IOC.listClass("SERVICE");
+    for (const n of r) {
+      n.id = ((e = n.id) !== null && e !== void 0 ? e : "").replace("SERVICE:", "");
+      if (n.id && a.Helper.isClass(n.target)) {
+        y.Debug(`Load service: ${n.id}`);
+        t.IOC.reg(n.id, n.target, {
           scope: "Singleton",
           type: "SERVICE",
           args: []
         });
-        const r = t.IOC.getInsByClass(e.target);
-        if (!o.implementsServiceInterface(r)) throw Error(`The service ${e.id} must implements interface 'IService'.`);
+        const e = t.IOC.getInsByClass(n.target);
+        if (!o.implementsServiceInterface(e)) throw Error(`The service ${n.id} must implements interface 'IService'.`);
       }
-    }));
+    }
   }
-  async LoadComponents() {
-    var e, r;
-    const n = t.IOC.listClass("COMPONENT");
-    const s = [];
-    n.forEach((async e => {
+  async LoadComponents(e) {
+    var r, n;
+    const i = t.IOC.listClass("COMPONENT");
+    i.forEach(e => {
       var r;
       e.id = ((r = e.id) !== null && r !== void 0 ? r : "").replace("COMPONENT:", "");
       if (a.Helper.isClass(e.target)) {
@@ -368,36 +466,56 @@ class Loader {
           type: "COMPONENT",
           args: []
         });
-        if (e.id && e.id.endsWith("Plugin")) {
-          const r = t.IOC.getInsByClass(e.target);
-          if (!o.implementsPluginInterface(r)) throw Error(`The plugin ${e.id} must implements interface 'IPlugin'.`);
-          s.push(e.id);
-        }
         if (e.id && e.id.endsWith("Aspect")) {
           const r = t.IOC.getInsByClass(e.target);
           if (!o.implementsAspectInterface(r)) throw Error(`The aspect ${e.id} must implements interface 'IAspect'.`);
         }
       }
-    }));
-    let i = this.app.config(void 0, "plugin");
-    if (a.Helper.isEmpty(i)) i = {
-      config: {},
-      list: []
-    };
-    const l = (e = i.list) !== null && e !== void 0 ? e : [];
-    for (const e of l) {
-      const o = t.IOC.get(e, "COMPONENT");
-      if (!o) throw Error(`Plugin ${e} load error.`);
-      if (!a.Helper.isFunction(o.run)) throw Error(`Plugin ${e} must implements interface 'IPlugin'.`);
-      if (i.config[e] === !1) {
-        g.Warn(`Plugin ${e} already loaded but not effective.`);
-        continue;
+    });
+    if (e) await e.loadUserPlugins(); else {
+      y.Warn("Loading plugins in legacy mode");
+      let e = this.app.config(void 0, "plugin");
+      if (a.Helper.isEmpty(e)) e = {
+        config: {},
+        list: []
+      };
+      const o = (r = e.list) !== null && r !== void 0 ? r : [];
+      for (const r of o) {
+        const o = t.IOC.get(r, "COMPONENT");
+        if (!o) throw Error(`Plugin ${r} load error.`);
+        if (!a.Helper.isFunction(o.run)) throw Error(`Plugin ${r} must implements interface 'IPlugin'.`);
+        if (e.config[r] === !1) {
+          y.Warn(`Plugin ${r} already loaded but not effective.`);
+          continue;
+        }
+        await o.run((n = e.config[r]) !== null && n !== void 0 ? n : {}, this.app);
       }
-      await o.run((r = i.config[e]) !== null && r !== void 0 ? r : {}, this.app);
     }
   }
   async LoadRouter(e) {
-    await this.app.router.LoadRouter(this.app, e);
+    var t;
+    const o = this.app.router;
+    y.Log("Koatty", "", "============ LoadRouter START ============");
+    y.Log("Koatty", "", "router type:", typeof o);
+    y.Log("Koatty", "", "router is object:", a.Helper.isObject(o));
+    y.Log("Koatty", "", "router has LoadRouter:", a.Helper.isFunction(o === null || o === void 0 ? void 0 : o.LoadRouter));
+    y.Log("Koatty", "", "Controllers to load:", e);
+    if (a.Helper.isObject(o) && !a.Helper.isFunction(o.LoadRouter)) {
+      const r = o;
+      y.Log("Koatty", "", `Multi-protocol routing: found ${Object.keys(r).length} routers (${Object.keys(r).join(", ")})`);
+      for (const o in r) {
+        y.Log("Koatty", "", `Checking protocol: ${o}, has LoadRouter:`, a.Helper.isFunction((t = r[o]) === null || t === void 0 ? void 0 : t.LoadRouter));
+        if (r[o] && a.Helper.isFunction(r[o].LoadRouter)) {
+          y.Log("Koatty", "", `Loading routes for protocol: ${o}`);
+          await r[o].LoadRouter(this.app, e);
+          y.Log("Koatty", "", `Completed loading routes for protocol: ${o}`);
+        }
+      }
+    } else if (a.Helper.isFunction(o.LoadRouter)) {
+      y.Log("Koatty", "", "Single protocol routing");
+      await o.LoadRouter(this.app, e);
+    } else y.Warn("No valid router found! router:", o);
+    y.Log("Koatty", "", "============ LoadRouter END ============");
   }
 }
 
@@ -409,29 +527,30 @@ class Loader {
  * @LastEditTime: 2025-01-14 16:11:21
  * @License: BSD (3-Clause)
  * @Copyright (c): <richenlin(at)gmail.com>
- */ function I(e) {
+ */ function b(e) {
   return function(t) {
     if (!(t.prototype instanceof o.Koatty)) throw new Error(`class does not inherit from Koatty`);
-    S(t, e);
+    H(t, e);
+    return t;
   };
 }
 
 function P(e) {
   return async t => {
     if (!(t.prototype instanceof o.Koatty)) throw new Error(`class ${t.name} does not inherit from Koatty`);
-    return await S(t, e, !0);
+    return await H(t, e, !0);
   };
 }
 
-function b(e) {
+function S(e) {
   return r => {
     if (!(r.prototype instanceof o.Koatty)) throw new Error(`class does not inherit from Koatty`);
     e = e !== null && e !== void 0 ? e : "";
-    t.IOC.saveClassMetadata(t.TAGGED_CLS, E, e, r);
+    t.IOC.saveClassMetadata(t.TAGGED_CLS, w, e, r);
   };
 }
 
-function A(e) {
+function I(e) {
   return r => {
     if (!(r.prototype instanceof o.Koatty)) throw new Error(`class does not inherit from Koatty`);
     e = e !== null && e !== void 0 ? e : "";
@@ -439,59 +558,81 @@ function A(e) {
   };
 }
 
-function H(e, o, r) {
+function K(e, o, r) {
   t.IOC.attachClassMetadata(t.TAGGED_CLS, e, o, r);
 }
 
-const S = async function(e, r, n = !1) {
-  L();
-  const s = v();
-  if (!n && s) return;
-  const i = Reflect.construct(e, []);
-  if (s) {
-    i.silent = !0;
-    g.enable(!1);
+const H = async function(e, r, n = !1) {
+  C();
+  const i = m();
+  if (!n && i) return;
+  const s = Reflect.construct(e, []);
+  if (i) {
+    s.silent = !0;
+    y.enable(!1);
   }
   try {
-    if (!i.silent) g.Log("Koatty", w);
-    if (!(i instanceof o.Koatty)) throw new Error(`class ${e.name} does not inherit from Koatty`);
-    Loader.initialize(i);
+    if (!s.silent) console.log(A);
+    if (!(s instanceof o.Koatty)) throw new Error(`class ${e.name} does not inherit from Koatty`);
+    Loader.initialize(s);
     if (a.Helper.isFunction(r)) {
-      g.Log("Koatty", "", "Execute bootFunc ...");
-      await r(i);
+      y.Log("Koatty", "", "Execute bootFunc ...");
+      await r(s);
     }
-    t.IOC.setApp(i);
-    g.Log("Koatty", "", "ComponentScan ...");
-    Loader.CheckAllComponents(i, e);
-    Loader.LoadAppEventHooks(i, e);
-    g.Log("Koatty", "", "Emit App Boot ...");
-    await o.asyncEvent(i, "appBoot");
-    await Loader.LoadAllComponents(i, e);
-    g.Log("Koatty", "", "Emit App Ready ...");
-    await o.asyncEvent(i, "appReady");
-    if (!s) i.listen(M);
-    return i;
+    t.IOC.setApp(s);
+    y.Log("Koatty", "", "ComponentScan ...");
+    Loader.CheckAllComponents(s, e);
+    Loader.LoadAppEventHooks(s, e);
+    y.Log("Koatty", "", "Emit App Boot ...");
+    await o.asyncEvent(s, o.AppEvent.appBoot);
+    await Loader.LoadAllComponents(s, e);
+    y.Log("Koatty", "", "Emit App Ready ...");
+    await o.asyncEvent(s, o.AppEvent.appReady);
+    if (!i) {
+      y.Log("Koatty", "", "Emit Before Server Start ...");
+      await o.asyncEvent(s, o.AppEvent.beforeServerStart);
+      s.listen(M);
+      y.Log("Koatty", "", "Emit After Server Start ...");
+      await o.asyncEvent(s, o.AppEvent.afterServerStart);
+    }
+    return s;
   } catch (e) {
-    g.Error(e);
-    process.exit();
+    y.Fatal(e);
+    process.exit(1);
   }
 };
 
 const M = e => {
-  let t = [];
-  if (!Array.isArray(e.server)) t = [ e.server ]; else t = e.server;
-  g.Log("Koatty", "", "====================================");
-  g.Log("Koatty", "", `Nodejs Version: ${process.version}`);
-  g.Log("Koatty", "", `Koatty Version: v${y}`);
-  g.Log("Koatty", "", `App Environment: ${e.env}`);
-  t.forEach((e => {
-    g.Log("Koatty", "", `Server: ${e.options.protocol.toUpperCase()} running at ${e.options.protocol === "http2" ? "https" : e.options.protocol}://${e.options.hostname || "127.0.0.1"}:${e.options.port}/`);
-  }));
-  g.Log("Koatty", "", "====================================");
-  if (e.appDebug) g.Warn(`Running in debug mode.`);
-  Loader.SetLogger(e);
+  y.Log("Koatty", "", "====================================");
+  y.Log("Koatty", "", `Nodejs Version: ${process.version}`);
+  y.Log("Koatty", "", `Koatty Version: v${v}`);
+  y.Log("Koatty", "", `App Environment: ${e.env}`);
+  if (e.appDebug) y.Warn(`Running in debug mode.`);
+  y.Log("Koatty", "", "====================================");
 };
 
+/*
+ * @Description: framework main file
+ * @Usage:
+ * @Author: richen
+ * @Date: 2023-12-09 21:56:32
+ * @LastEditTime: 2025-01-14 16:12:41
+ * @License: BSD (3-Clause)
+ * @Copyright (c): <richenlin(at)gmail.com>
+ */ function R() {
+  try {
+    require("koatty_router/dist/RouterPlugin");
+  } catch (e) {}
+  try {
+    require("koatty_serve/dist/ServePlugin");
+  } catch (e) {}
+  try {
+    require("koatty_trace/dist/TracePlugin");
+  } catch (e) {}
+}
+
+R();
+
 Object.defineProperty(exports, "Config", {
   enumerable: !0,
   get: function() {
@@ -506,50 +647,50 @@ Object.defineProperty(exports, "Helper", {
   }
 });
 
-exports.BindEventHook = H;
+exports.BindEventHook = K;
 
-exports.Bootstrap = I;
+exports.Bootstrap = b;
 
-exports.ComponentScan = b;
+exports.ComponentScan = S;
 
-exports.ConfigurationScan = A;
+exports.ConfigurationScan = I;
 
 exports.ExecBootStrap = P;
 
-exports.Logger = g;
+exports.Logger = y;
 
-Object.keys(t).forEach((function(e) {
+Object.keys(t).forEach(function(e) {
   if (e !== "default" && !Object.prototype.hasOwnProperty.call(exports, e)) Object.defineProperty(exports, e, {
     enumerable: !0,
     get: function() {
       return t[e];
     }
   });
-}));
+});
 
-Object.keys(o).forEach((function(e) {
+Object.keys(o).forEach(function(e) {
   if (e !== "default" && !Object.prototype.hasOwnProperty.call(exports, e)) Object.defineProperty(exports, e, {
     enumerable: !0,
     get: function() {
       return o[e];
     }
   });
-}));
+});
 
-Object.keys(r).forEach((function(e) {
+Object.keys(r).forEach(function(e) {
   if (e !== "default" && !Object.prototype.hasOwnProperty.call(exports, e)) Object.defineProperty(exports, e, {
     enumerable: !0,
     get: function() {
       return r[e];
     }
   });
-}));
+});
 
-Object.keys(n).forEach((function(e) {
+Object.keys(n).forEach(function(e) {
   if (e !== "default" && !Object.prototype.hasOwnProperty.call(exports, e)) Object.defineProperty(exports, e, {
     enumerable: !0,
     get: function() {
       return n[e];
     }
   });
-}));
+});