koatty 3.13.0 → 4.0.0

package/dist/index.mjs

@@ -1,6 +1,6 @@
 /*!
 * @Author: richen
-* @Date: 2025-04-19 23:06:49
+* @Date: 2025-11-02 10:59:15
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/
@@ -9,36 +9,38 @@ import { LoadConfigs as t } from "koatty_config";
 
 export { Config } from "koatty_config";
 
-import { IOC as e, TAGGED_CLS as o } from "koatty_container";
+import { IOC as o, TAGGED_CLS as e } from "koatty_container";
 
 export * from "koatty_container";
 
-import { AppEventArr as a, implementsMiddlewareInterface as s, parseExp as r, implementsControllerInterface as i, implementsServiceInterface as n, implementsPluginInterface as l, implementsAspectInterface as c, Koatty as p, asyncEvent as d } from "koatty_core";
+import { AppEvent as a, AppEventArr as r, implementsMiddlewareInterface as s, MIDDLEWARE_OPTIONS as i, protocolMiddleware as n, implementsControllerInterface as l, implementsServiceInterface as c, implementsPluginInterface as d, implementsAspectInterface as p, Koatty as f, asyncEvent as u } from "koatty_core";
 
 export * from "koatty_core";
 
 export * from "koatty_exception";
 
-import { Helper as f } from "koatty_lib";
+import { Helper as g } from "koatty_lib";
 
 export { Helper } from "koatty_lib";
 
-import { NewRouter as g } from "koatty_router";
+import { NewRouter as h } from "koatty_router";
 
 export * from "koatty_router";
 
-import { DefaultLogger as u } from "koatty_logger";
+import { DefaultLogger as y } from "koatty_logger";
 
-import { Load as h } from "koatty_loader";
+import { Load as m } from "koatty_loader";
 
-import { NewServe as m } from "koatty_serve";
+import { NewServe as L } from "koatty_serve";
 
-import * as y from "path";
+import { Trace as v } from "koatty_trace";
 
-var L = "3.13.0";
+import * as C from "path";
 
-var v = {
-  node: ">12.0.0"
+var w = "3.14.0-beta.1";
+
+var E = {
+  node: ">=18.0.0"
 };
 
 /*
@@ -49,16 +51,25 @@ var v = {
  * @LastEditTime: 2024-10-31 17:52:43
  * @License: BSD (3-Clause)
  * @Copyright (c): <richenlin(at)gmail.com>
- */ const w = u;
-
-function C(t, e) {
-  if (e.logLevel) u.setLevel(e.logLevel);
-  if (e.logFilePath && !t.silent) {
-    f.define(t, "logsPath", e.logFilePath);
-    process.env.LOGS_PATH = e.logFilePath;
-    u.setLogFilePath(e.logFilePath);
+ */ const b = y;
+
+function R(t, o) {
+  if (!t.appDebug) y.enableBuffering({
+    maxBufferSize: 200,
+    flushInterval: 500,
+    flushOnLevel: "error"
+  });
+  if (o.logLevel) y.setLevel(o.logLevel);
+  if (o.logFilePath && !t.silent) {
+    g.define(t, "logsPath", o.logFilePath);
+    process.env.LOGS_PATH = o.logFilePath;
+    y.setLogFilePath(o.logFilePath);
   }
-  if (e.sensFields) u.setSensFields(e.sensFields);
+  if (o.sensFields) y.setSensFields(o.sensFields);
+  t.once(a.appStop, async () => {
+    await y.flush();
+    await y.destroy();
+  });
 }
 
 /*
@@ -69,38 +80,38 @@ function C(t, e) {
  * @LastEditTime: 2025-01-14 16:14:10
  * @License: BSD (3-Clause)
  * @Copyright (c): <richenlin(at)gmail.com>
- */ const E = L;
+ */ const P = w;
 
-const P = v.node.slice(1) || "12.0.0";
+const A = E.node.slice(1) || "12.0.0";
 
-function A(t, e, o, a) {
-  if (f.isClass(o) && o.name != t) throw Error(`The file(${e}) name should be always the same as class name.`);
-  if (o["__esModule"]) if (o.name === void 0) {
-    const a = Object.keys(o);
-    if (a[0] != t && f.isClass(o[a[0]])) throw Error(`The file(${e}) name should be always the same as class name.`);
-  } else if (o.name != t) throw Error(`The file(${e}) name should be always the same as class name.`);
+function M(t, o, e, a) {
+  if (g.isClass(e) && e.name != t) throw Error(`The file(${o}) name should be always the same as class name.`);
+  if (e["__esModule"]) if (e.name === void 0) {
+    const a = Object.keys(e);
+    if (a[0] != t && g.isClass(e[a[0]])) throw Error(`The file(${o}) name should be always the same as class name.`);
+  } else if (e.name != t) throw Error(`The file(${o}) name should be always the same as class name.`);
   if (!a) return;
-  if (a.has(t)) throw new Error(`A same class already exists. at \`${e}\`.`);
+  if (a.has(t)) throw new Error(`A same class already exists. at \`${o}\`.`);
   a.add(t);
   return;
 }
 
-function M() {
-  let t = P;
+function K() {
+  let t = A;
   t = t.slice(0, t.lastIndexOf("."));
-  let e = process.version;
-  if (e[0] === "v") e = e.slice(1);
-  e = e.slice(0, e.lastIndexOf("."));
-  if (f.toNumber(t) > f.toNumber(e)) {
-    w.Error(`Koatty need node version > ${t}, current version is ${e}, please upgrade it.`);
+  let o = process.version;
+  if (o[0] === "v") o = o.slice(1);
+  o = o.slice(0, o.lastIndexOf("."));
+  if (g.toNumber(t) > g.toNumber(o)) {
+    b.Fatal(`Koatty need node version > ${t}, current version is ${o}, please upgrade it.`);
     process.exit(-1);
   }
 }
 
 const $ = () => {
   let t = !1;
-  const e = JSON.stringify(process.argv[1]);
-  if (e.indexOf("jest") > -1) t = !0;
+  const o = JSON.stringify(process.argv[1]);
+  if (o.indexOf("jest") > -1) t = !0;
   return t;
 };
 
@@ -112,11 +123,11 @@ const $ = () => {
  * @LastEditTime: 2023-12-09 23:00:13
  * @License: BSD (3-Clause)
  * @Copyright (c): <richenlin(at)gmail.com>
- */ const R = "COMPONENT_SCAN";
+ */ const k = "COMPONENT_SCAN";
 
-const k = "CONFIGURATION_SCAN";
+const O = "CONFIGURATION_SCAN";
 
-const T = `\n\n┬┌─┌─┐┌─┐┌┬┐┌┬┐┬ ┬\n├┴┐│ │├─┤ │  │ └┬┘\n┴ ┴└─┘┴ ┴ ┴  ┴  ┴ \n-------------------------------------------\nhttps://github.com/koatty\n`
+const S = `\n\n┬┌─┌─┐┌─┐┌┬┐┌┬┐┬ ┬\n├┴┐│ │├─┤ │  │ └┬┘\n┴ ┴└─┘┴ ┴ ┴  ┴  ┴ \n-------------------------------------------\nhttps://github.com/koatty\n`
 /*
  * @Description: framework loader
  * @Usage:
@@ -132,261 +143,352 @@ class Loader {
     this.app = t;
   }
   static initialize(t) {
-    if (t.env == "development") w.setLevel("debug"); else w.setLevel("info");
-    const e = t.rootPath || process.cwd();
-    const o = t.appPath || y.resolve(e, t.appDebug ? "src" : "dist");
-    const a = y.resolve(__dirname, "..");
-    f.define(t, "rootPath", e);
-    f.define(t, "appPath", o);
-    f.define(t, "koattyPath", a);
-    if (f.isEmpty(t.name)) {
-      const e = f.safeRequire(`${y.dirname(o)}/package.json`);
-      if (e.name) {
-        t.name = e.name;
-        t.version = t.version || e.version;
+    if (t.env == "development") b.setLevel("debug"); else b.setLevel("info");
+    const o = t.rootPath || process.cwd();
+    const e = t.appPath || C.resolve(o, t.appDebug ? "src" : "dist");
+    const a = C.resolve(__dirname, "..");
+    g.define(t, "rootPath", o);
+    g.define(t, "appPath", e);
+    g.define(t, "koattyPath", a);
+    if (g.isEmpty(t.name)) {
+      const o = g.safeRequire(`${C.dirname(e)}/package.json`);
+      if (o.name) {
+        t.name = o.name;
+        t.version = t.version || o.version;
       }
     }
-    process.env.ROOT_PATH = e;
-    process.env.APP_PATH = o;
+    process.env.ROOT_PATH = o;
+    process.env.APP_PATH = e;
     process.env.KOATTY_PATH = a;
-    f.define(t, "thinkPath", a);
+    g.define(t, "thinkPath", a);
     process.env.THINK_PATH = a;
   }
   static GetComponentMeta(t, a) {
-    let s = [];
-    const r = e.getClassMetadata(o, R, a);
-    if (r) if (f.isArray(r)) s = r; else s.push(r);
-    if (s.length < 1) s = [ t.appPath ];
-    return s;
-  }
-  static GetConfigurationMeta(t, a) {
-    const s = e.getClassMetadata(o, k, a);
     let r = [];
-    if (s) if (f.isArray(s)) r = s; else r.push(s);
+    const s = o.getClassMetadata(e, k, a);
+    if (s) if (g.isArray(s)) r = s; else r.push(s);
+    if (r.length < 1) r = [ t.appPath ];
     return r;
   }
-  static CheckAllComponents(t, e) {
-    const o = Loader.GetComponentMeta(t, e);
-    const a = Loader.GetConfigurationMeta(t, e);
-    const s = new Set;
-    h(o, "", ((t, e, o) => {
-      A(t, e, o, s);
-    }), [ "**/**.js", "**/**.ts", "!**/**.d.ts" ], [ ...a, `${e.name || ".no"}.ts` ]);
-    s.clear();
+  static GetConfigurationMeta(t, a) {
+    const r = o.getClassMetadata(e, O, a);
+    let s = [];
+    if (r) if (g.isArray(r)) s = r; else s.push(r);
+    return s;
+  }
+  static CheckAllComponents(t, o) {
+    const e = Loader.GetComponentMeta(t, o);
+    const a = Loader.GetConfigurationMeta(t, o);
+    const r = new Set;
+    m(e, "", (t, o, e) => {
+      M(t, o, e, r);
+    }, [ "**/**.js", "**/**.ts", "!**/**.d.ts" ], [ ...a, `${o.name || ".no"}.ts` ]);
+    r.clear();
   }
   static SetLogger(t) {
-    const e = t.getMetaData("_configs") || [];
-    const o = e[0] || {};
-    if (o.config) {
-      const e = o.config;
-      let a = "debug", s = "", r = [];
+    const o = t.getMetaData("_configs") || [];
+    const e = o[0] || {};
+    if (e.config) {
+      const o = e.config;
+      let a = "debug", r = "", s = [];
       if (t.env === "production") a = "info";
-      if (e.logsLevel) a = e.logsLevel.toLowerCase();
-      if (e.logsPath) s = e.logsPath;
-      if (e.sensFields) r = e.sensFields;
-      C(t, {
+      if (o.logsLevel) a = o.logsLevel.toLowerCase();
+      if (o.logsPath) r = o.logsPath;
+      if (o.sensFields) s = o.sensFields;
+      R(t, {
         logLevel: a,
-        logFilePath: s,
-        sensFields: r
+        logFilePath: r,
+        sensFields: s
       });
     }
   }
   static LoadAppEventHooks(t, s) {
-    const r = new Map;
-    for (const t of a) {
-      let a;
+    const i = new Map;
+    for (const t of r) {
+      let r;
       switch (t) {
-       case "appBoot":
-        a = e.getClassMetadata(o, "appBoot", s);
-        if (f.isArray(a)) r.set("appBoot", a);
+       case a.appBoot:
+        r = o.getClassMetadata(e, a.appBoot, s);
+        if (g.isArray(r)) i.set(a.appBoot, r);
         break;
 
-       case "appReady":
-        a = e.getClassMetadata(o, "appReady", s);
-        if (f.isArray(a)) r.set("appReady", a);
+       case a.appReady:
+        r = o.getClassMetadata(e, a.appReady, s);
+        if (g.isArray(r)) i.set(a.appReady, r);
         break;
 
-       case "appStart":
-        a = e.getClassMetadata(o, "appStart", s);
-        if (f.isArray(a)) r.set("appStart", a);
+       case a.appStart:
+        r = o.getClassMetadata(e, a.appStart, s);
+        if (g.isArray(r)) i.set(a.appStart, r);
         break;
 
-       case "appStop":
-        a = e.getClassMetadata(o, "appStop", s);
-        if (f.isArray(a)) r.set("appStop", a);
+       case a.appStop:
+        r = o.getClassMetadata(e, a.appStop, s);
+        if (g.isArray(r)) i.set(a.appStop, r);
         break;
       }
     }
-    for (const [e, o] of r) for (const a of o) t.once(e, (() => a(t)));
+    for (const [o, e] of i) for (const a of e) t.once(o, () => a(t));
   }
   static async LoadAllComponents(t, e) {
-    var o, a, s;
-    w.Log("Koatty", "", "Load Configurations ...");
-    const r = Loader.GetConfigurationMeta(t, e);
-    const i = new Loader(t);
-    i.LoadConfigs(r);
-    const n = (o = t.config("server")) !== null && o !== void 0 ? o : {
+    var a, r, s;
+    try {
+      if (g.isFunction(o.preloadMetadata)) o.preloadMetadata();
+    } catch {
+      b.Warn("[Loader] preloadMetadata is optional, ignore if not available");
+    }
+    b.Log("Koatty", "", "Load Configurations ...");
+    const i = Loader.GetConfigurationMeta(t, e);
+    const n = new Loader(t);
+    n.LoadConfigs(i);
+    Loader.SetLogger(t);
+    const l = (a = t.config("server")) !== null && a !== void 0 ? a : {
       protocol: "http"
     };
-    const l = (a = n.protocol) !== null && a !== void 0 ? a : "http";
-    f.define(t, "server", m(t, n));
-    const c = (s = t.config(void 0, "router")) !== null && s !== void 0 ? s : {};
-    f.define(t, "router", g(t, {
-      protocol: l,
-      ...c
-    }));
-    w.Log("Koatty", "", "Load Components ...");
-    await i.LoadComponents();
-    w.Log("Koatty", "", "Load Middlewares ...");
-    await i.LoadMiddlewares();
-    w.Log("Koatty", "", "Load Services ...");
-    await i.LoadServices();
-    w.Log("Koatty", "", "Load Controllers ...");
-    const p = await i.LoadControllers();
-    w.Log("Koatty", "", "Load Routers ...");
-    i.LoadRouter(p);
+    const c = (r = l.protocol) !== null && r !== void 0 ? r : "http";
+    const d = (s = t.config(void 0, "router")) !== null && s !== void 0 ? s : {};
+    const p = g.isArray(c) ? c : [ c ];
+    const f = Loader.CreateServers(t, l, p);
+    g.define(t, "server", f);
+    const u = Loader.CreateRouters(t, d, p);
+    g.define(t, "router", u);
+    b.Log("Koatty", "", "Load Components ...");
+    await n.LoadComponents();
+    b.Log("Koatty", "", "Load Middlewares ...");
+    await n.LoadMiddlewares();
+    b.Log("Koatty", "", "Load Services ...");
+    await n.LoadServices();
+    b.Log("Koatty", "", "Load Controllers ...");
+    const h = await n.LoadControllers();
+    b.Log("Koatty", "", "Load Routers ...");
+    await n.LoadRouter(h);
+  }
+  static CreateServers(t, o, e) {
+    if (e.length > 1) {
+      const a = [];
+      const r = g.isArray(o.port) ? o.port : [ o.port ];
+      const s = [];
+      for (let t = 0; t < e.length; t++) if (t < r.length) s.push(g.toNumber(r[t])); else s.push(g.toNumber(r[0]) + t);
+      for (let r = 0; r < e.length; r++) {
+        const i = e[r];
+        const n = {
+          ...o,
+          protocol: i,
+          port: s[r]
+        };
+        a.push(L(t, n));
+      }
+      return a;
+    } else {
+      const a = e[0];
+      const r = {
+        protocol: a,
+        ...o
+      };
+      return L(t, r);
+    }
+  }
+  static CreateRouters(t, o, e) {
+    if (e.length > 1) {
+      const a = {};
+      for (const r of e) {
+        const e = {
+          protocol: r,
+          ...o
+        };
+        if (o.ext && o.ext[r]) e.ext = o.ext[r];
+        a[r] = h(t, e);
+      }
+      return a;
+    } else {
+      const a = e[0];
+      return h(t, {
+        protocol: a,
+        ...o
+      });
+    }
   }
-  LoadConfigs(e) {
-    const o = {};
-    h([ "./config" ], this.app.koattyPath, (function(t, e, a) {
-      o[t] = a;
-    }));
-    if (f.isArray(e)) e = e.length > 0 ? e : [ "./config" ];
-    let a = t(e, this.app.appPath);
-    a = f.extend(o, a, !0);
+  LoadConfigs(o) {
+    const e = {};
+    m([ "./config" ], this.app.koattyPath, function(t, o, a) {
+      e[t] = a;
+    });
+    if (g.isArray(o)) o = o.length > 0 ? o : [ "./config" ];
+    let a = t(o, this.app.appPath);
+    a = g.extend(e, a, !0);
     this.app.setMetaData("_configs", a);
   }
   async LoadMiddlewares() {
-    var t;
-    let o = this.app.config(void 0, "middleware");
-    if (f.isEmpty(o)) o = {
+    var t, e, a;
+    try {
+      const o = (t = this.app.config("trace")) !== null && t !== void 0 ? t : {};
+      const e = v(o, this.app);
+      g.define(this.app, "tracer", e);
+      this.app.use(e);
+      b.Debug(`Load trace middleware`);
+    } catch (t) {
+      b.Warn(`Trace middleware failed to load: ${t.message}`);
+    }
+    let r = this.app.config(void 0, "middleware");
+    if (g.isEmpty(r)) r = {
       config: {},
-      list: [],
-      routeList: []
+      list: []
     };
-    const a = (t = e.listClass("MIDDLEWARE")) !== null && t !== void 0 ? t : [];
-    a.forEach((t => {
-      var o;
-      t.id = ((o = t.id) !== null && o !== void 0 ? o : "").replace("MIDDLEWARE:", "");
-      if (t.id && f.isClass(t.target)) {
-        e.reg(t.id, t.target, {
+    const l = (e = o.listClass("MIDDLEWARE")) !== null && e !== void 0 ? e : [];
+    l.forEach(t => {
+      var e;
+      t.id = ((e = t.id) !== null && e !== void 0 ? e : "").replace("MIDDLEWARE:", "");
+      if (t.id && g.isClass(t.target)) {
+        o.reg(t.id, t.target, {
           scope: "Prototype",
           type: "MIDDLEWARE",
           args: []
         });
-        const o = e.getInsByClass(t.target);
-        if (!s(o)) throw Error(`The middleware ${t.id} must implements interface 'IMiddleware'.`);
+        const e = o.getInsByClass(t.target);
+        if (!s(e)) throw Error(`The middleware ${t.id} must implements interface 'IMiddleware'.`);
+      }
+    });
+    const c = r.list || [];
+    const d = new Set([]);
+    c.forEach(t => {
+      d.add(t);
+    });
+    const p = r.config || {};
+    for (const t of d) {
+      const e = o.get(t, "MIDDLEWARE");
+      if (!e) throw Error(`Middleware ${t} load error.`);
+      if (!g.isFunction(e.run)) throw Error(`The middleware ${t} must implements interface 'IMiddleware'.`);
+      b.Debug(`Load middleware: ${t}`);
+      const r = p[t] || {};
+      const s = (a = l.find(o => o.id === t)) === null || a === void 0 ? void 0 : a.target;
+      let c = {};
+      if (s) try {
+        c = o.getPropertyData(i, s, t) || {};
+      } catch {
+        c = {};
+      }
+      const d = {
+        ...c,
+        ...r
+      };
+      if (d.enabled === !1) {
+        b.Warn(`The middleware ${t} has been loaded but is disabled.`);
+        continue;
+      }
+      const f = await e.run(d, this.app);
+      if (g.isFunction(f)) {
+        let o = f;
+        if (d.protocol) {
+          const e = g.isArray(d.protocol) ? d.protocol : [ d.protocol ];
+          b.Log("Koatty", "", `Middleware ${t} limited to protocols: ${e.join(", ")}`);
+          o = n(e, f);
+        }
+        if (o.length < 3) this.app.use(o); else this.app.useExp(o);
       }
-    }));
-    const i = o.list || [];
-    const n = new Set([]);
-    i.forEach((t => {
-      n.add(t);
-    }));
-    const l = o.routeList || [];
-    const c = new Set([]);
-    l.forEach((t => {
-      c.add(t);
-    }));
-    const p = o.config || {};
-    for (const t of n) {
-      const o = e.get(t, "MIDDLEWARE");
-      if (!o) throw Error(`Middleware ${t} load error.`);
-      if (!f.isFunction(o.run)) throw Error(`The middleware ${t} must implements interface 'IMiddleware'.`);
-      w.Debug(`Load middleware: ${t}`);
-      const a = p[t] || {};
-      const s = await o.run(a, this.app);
-      if (f.isFunction(s)) if (s.length < 3) this.app.use(s); else this.app.useExp(s);
-    }
-    for (const t of c) {
-      const o = e.get(t, "MIDDLEWARE");
-      if (!o) throw Error(`Router middleware ${t} load error.`);
-      if (!f.isFunction(o.run)) throw Error(`The router middleware ${t} must implements interface 'IMiddleware'.`);
-      w.Debug(`Load router middleware: ${t}`);
-      const a = await o.run(p[t] || {}, this.app);
-      if (f.isFunction(a)) this.app.setMetaData(`routerMiddleware_${t}`, a.length > 2 ? r(a) : a);
     }
   }
   async LoadControllers() {
-    const t = e.listClass("CONTROLLER");
-    const o = [];
-    t.forEach((t => {
+    const t = o.listClass("CONTROLLER");
+    const e = [];
+    t.forEach(t => {
       var a;
       t.id = ((a = t.id) !== null && a !== void 0 ? a : "").replace("CONTROLLER:", "");
-      if (t.id && f.isClass(t.target)) {
-        w.Debug(`Load controller: ${t.id}`);
-        e.reg(t.id, t.target, {
+      if (t.id && g.isClass(t.target)) {
+        b.Debug(`Load controller: ${t.id}`);
+        o.reg(t.id, t.target, {
           scope: "Prototype",
           type: "CONTROLLER",
           args: []
         });
-        const a = e.getInsByClass(t.target);
-        if (!i(a)) throw Error(`The controller ${t.id} must implements interface 'IController'.`);
-        o.push(t.id);
+        const a = o.getInsByClass(t.target);
+        if (!l(a)) throw Error(`The controller ${t.id} must implements interface 'IController'.`);
+        e.push(t.id);
       }
-    }));
-    return o;
+    });
+    return e;
   }
   async LoadServices() {
-    const t = e.listClass("SERVICE");
-    t.forEach((t => {
-      var o;
-      t.id = ((o = t.id) !== null && o !== void 0 ? o : "").replace("SERVICE:", "");
-      if (t.id && f.isClass(t.target)) {
-        w.Debug(`Load service: ${t.id}`);
-        e.reg(t.id, t.target, {
+    const t = o.listClass("SERVICE");
+    t.forEach(t => {
+      var e;
+      t.id = ((e = t.id) !== null && e !== void 0 ? e : "").replace("SERVICE:", "");
+      if (t.id && g.isClass(t.target)) {
+        b.Debug(`Load service: ${t.id}`);
+        o.reg(t.id, t.target, {
           scope: "Singleton",
           type: "SERVICE",
           args: []
         });
-        const o = e.getInsByClass(t.target);
-        if (!n(o)) throw Error(`The service ${t.id} must implements interface 'IService'.`);
+        const e = o.getInsByClass(t.target);
+        if (!c(e)) throw Error(`The service ${t.id} must implements interface 'IService'.`);
       }
-    }));
+    });
   }
   async LoadComponents() {
-    var t, o;
-    const a = e.listClass("COMPONENT");
-    const s = [];
-    a.forEach((async t => {
-      var o;
-      t.id = ((o = t.id) !== null && o !== void 0 ? o : "").replace("COMPONENT:", "");
-      if (f.isClass(t.target)) {
-        e.reg(t.id, t.target, {
+    var t, e;
+    const a = o.listClass("COMPONENT");
+    const r = [];
+    a.forEach(async t => {
+      var e;
+      t.id = ((e = t.id) !== null && e !== void 0 ? e : "").replace("COMPONENT:", "");
+      if (g.isClass(t.target)) {
+        o.reg(t.id, t.target, {
           scope: "Singleton",
           type: "COMPONENT",
           args: []
         });
         if (t.id && t.id.endsWith("Plugin")) {
-          const o = e.getInsByClass(t.target);
-          if (!l(o)) throw Error(`The plugin ${t.id} must implements interface 'IPlugin'.`);
-          s.push(t.id);
+          const e = o.getInsByClass(t.target);
+          if (!d(e)) throw Error(`The plugin ${t.id} must implements interface 'IPlugin'.`);
+          r.push(t.id);
         }
         if (t.id && t.id.endsWith("Aspect")) {
-          const o = e.getInsByClass(t.target);
-          if (!c(o)) throw Error(`The aspect ${t.id} must implements interface 'IAspect'.`);
+          const e = o.getInsByClass(t.target);
+          if (!p(e)) throw Error(`The aspect ${t.id} must implements interface 'IAspect'.`);
         }
       }
-    }));
-    let r = this.app.config(void 0, "plugin");
-    if (f.isEmpty(r)) r = {
+    });
+    let s = this.app.config(void 0, "plugin");
+    if (g.isEmpty(s)) s = {
       config: {},
       list: []
     };
-    const i = (t = r.list) !== null && t !== void 0 ? t : [];
+    const i = (t = s.list) !== null && t !== void 0 ? t : [];
     for (const t of i) {
-      const a = e.get(t, "COMPONENT");
+      const a = o.get(t, "COMPONENT");
       if (!a) throw Error(`Plugin ${t} load error.`);
-      if (!f.isFunction(a.run)) throw Error(`Plugin ${t} must implements interface 'IPlugin'.`);
-      if (r.config[t] === !1) {
-        w.Warn(`Plugin ${t} already loaded but not effective.`);
+      if (!g.isFunction(a.run)) throw Error(`Plugin ${t} must implements interface 'IPlugin'.`);
+      if (s.config[t] === !1) {
+        b.Warn(`Plugin ${t} already loaded but not effective.`);
         continue;
       }
-      await a.run((o = r.config[t]) !== null && o !== void 0 ? o : {}, this.app);
+      await a.run((e = s.config[t]) !== null && e !== void 0 ? e : {}, this.app);
     }
   }
   async LoadRouter(t) {
-    await this.app.router.LoadRouter(this.app, t);
+    var o;
+    const e = this.app.router;
+    b.Log("Koatty", "", "============ LoadRouter START ============");
+    b.Log("Koatty", "", "router type:", typeof e);
+    b.Log("Koatty", "", "router is object:", g.isObject(e));
+    b.Log("Koatty", "", "router has LoadRouter:", g.isFunction(e === null || e === void 0 ? void 0 : e.LoadRouter));
+    b.Log("Koatty", "", "Controllers to load:", t);
+    if (g.isObject(e) && !g.isFunction(e.LoadRouter)) {
+      const a = e;
+      b.Log("Koatty", "", `Multi-protocol routing: found ${Object.keys(a).length} routers (${Object.keys(a).join(", ")})`);
+      for (const e in a) {
+        b.Log("Koatty", "", `Checking protocol: ${e}, has LoadRouter:`, g.isFunction((o = a[e]) === null || o === void 0 ? void 0 : o.LoadRouter));
+        if (a[e] && g.isFunction(a[e].LoadRouter)) {
+          b.Log("Koatty", "", `Loading routes for protocol: ${e}`);
+          await a[e].LoadRouter(this.app, t);
+          b.Log("Koatty", "", `Completed loading routes for protocol: ${e}`);
+        }
+      }
+    } else if (g.isFunction(e.LoadRouter)) {
+      b.Log("Koatty", "", "Single protocol routing");
+      await e.LoadRouter(this.app, t);
+    } else b.Warn("No valid router found! router:", e);
+    b.Log("Koatty", "", "============ LoadRouter END ============");
   }
 }
 
@@ -398,87 +500,82 @@ class Loader {
  * @LastEditTime: 2025-01-14 16:11:21
  * @License: BSD (3-Clause)
  * @Copyright (c): <richenlin(at)gmail.com>
- */ function _(t) {
-  return function(e) {
-    if (!(e.prototype instanceof p)) throw new Error(`class does not inherit from Koatty`);
-    b(e, t);
+ */ function T(t) {
+  return function(o) {
+    if (!(o.prototype instanceof f)) throw new Error(`class does not inherit from Koatty`);
+    x(o, t);
+    return o;
   };
 }
 
-function O(t) {
-  return async e => {
-    if (!(e.prototype instanceof p)) throw new Error(`class ${e.name} does not inherit from Koatty`);
-    return await b(e, t, !0);
+function _(t) {
+  return async o => {
+    if (!(o.prototype instanceof f)) throw new Error(`class ${o.name} does not inherit from Koatty`);
+    return await x(o, t, !0);
   };
 }
 
-function S(t) {
+function F(t) {
   return a => {
-    if (!(a.prototype instanceof p)) throw new Error(`class does not inherit from Koatty`);
+    if (!(a.prototype instanceof f)) throw new Error(`class does not inherit from Koatty`);
     t = t !== null && t !== void 0 ? t : "";
-    e.saveClassMetadata(o, R, t, a);
+    o.saveClassMetadata(e, k, t, a);
   };
 }
 
-function I(t) {
+function N(t) {
   return a => {
-    if (!(a.prototype instanceof p)) throw new Error(`class does not inherit from Koatty`);
+    if (!(a.prototype instanceof f)) throw new Error(`class does not inherit from Koatty`);
     t = t !== null && t !== void 0 ? t : "";
-    e.saveClassMetadata(o, k, t, a);
+    o.saveClassMetadata(e, O, t, a);
   };
 }
 
-function K(t, a, s) {
-  e.attachClassMetadata(o, t, a, s);
+function I(t, a, r) {
+  o.attachClassMetadata(e, t, a, r);
 }
 
-const b = async function(t, o, a = !1) {
-  M();
+const x = async function(t, e, r = !1) {
+  K();
   const s = $();
-  if (!a && s) return;
-  const r = Reflect.construct(t, []);
+  if (!r && s) return;
+  const i = Reflect.construct(t, []);
   if (s) {
-    r.silent = !0;
-    w.enable(!1);
+    i.silent = !0;
+    b.enable(!1);
   }
   try {
-    if (!r.silent) w.Log("Koatty", T);
-    if (!(r instanceof p)) throw new Error(`class ${t.name} does not inherit from Koatty`);
-    Loader.initialize(r);
-    if (f.isFunction(o)) {
-      w.Log("Koatty", "", "Execute bootFunc ...");
-      await o(r);
+    if (!i.silent) console.log(S);
+    if (!(i instanceof f)) throw new Error(`class ${t.name} does not inherit from Koatty`);
+    Loader.initialize(i);
+    if (g.isFunction(e)) {
+      b.Log("Koatty", "", "Execute bootFunc ...");
+      await e(i);
     }
-    e.setApp(r);
-    w.Log("Koatty", "", "ComponentScan ...");
-    Loader.CheckAllComponents(r, t);
-    Loader.LoadAppEventHooks(r, t);
-    w.Log("Koatty", "", "Emit App Boot ...");
-    await d(r, "appBoot");
-    await Loader.LoadAllComponents(r, t);
-    w.Log("Koatty", "", "Emit App Ready ...");
-    await d(r, "appReady");
-    if (!s) r.listen(N);
-    return r;
+    o.setApp(i);
+    b.Log("Koatty", "", "ComponentScan ...");
+    Loader.CheckAllComponents(i, t);
+    Loader.LoadAppEventHooks(i, t);
+    b.Log("Koatty", "", "Emit App Boot ...");
+    await u(i, a.appBoot);
+    await Loader.LoadAllComponents(i, t);
+    b.Log("Koatty", "", "Emit App Ready ...");
+    await u(i, a.appReady);
+    if (!s) i.listen(D);
+    return i;
   } catch (t) {
-    w.Error(t);
-    process.exit();
+    b.Fatal(t);
+    process.exit(1);
   }
 };
 
-const N = t => {
-  let e = [];
-  if (!Array.isArray(t.server)) e = [ t.server ]; else e = t.server;
-  w.Log("Koatty", "", "====================================");
-  w.Log("Koatty", "", `Nodejs Version: ${process.version}`);
-  w.Log("Koatty", "", `Koatty Version: v${E}`);
-  w.Log("Koatty", "", `App Environment: ${t.env}`);
-  e.forEach((t => {
-    w.Log("Koatty", "", `Server: ${t.options.protocol.toUpperCase()} running at ${t.options.protocol === "http2" ? "https" : t.options.protocol}://${t.options.hostname || "127.0.0.1"}:${t.options.port}/`);
-  }));
-  w.Log("Koatty", "", "====================================");
-  if (t.appDebug) w.Warn(`Running in debug mode.`);
-  Loader.SetLogger(t);
+const D = t => {
+  b.Log("Koatty", "", "====================================");
+  b.Log("Koatty", "", `Nodejs Version: ${process.version}`);
+  b.Log("Koatty", "", `Koatty Version: v${P}`);
+  b.Log("Koatty", "", `App Environment: ${t.env}`);
+  if (t.appDebug) b.Warn(`Running in debug mode.`);
+  b.Log("Koatty", "", "====================================");
 };
 
-export { K as BindEventHook, _ as Bootstrap, S as ComponentScan, I as ConfigurationScan, O as ExecBootStrap, w as Logger };
+export { I as BindEventHook, T as Bootstrap, F as ComponentScan, N as ConfigurationScan, _ as ExecBootStrap, b as Logger };