koatty 3.13.2 → 4.0.3

package/dist/index.mjs

@@ -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/
@@ -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, asyncEvent as i, ComponentManager as s, implementsMiddlewareInterface as n, MIDDLEWARE_OPTIONS as l, protocolMiddleware as c, implementsControllerInterface as d, implementsServiceInterface as p, implementsAspectInterface as f, Koatty as g } from "koatty_core";
 
 export * from "koatty_core";
 
 export * from "koatty_exception";
 
-import { Helper as f } from "koatty_lib";
+import { Helper as u } from "koatty_lib";
 
 export { Helper } from "koatty_lib";
 
-import { NewRouter as g } from "koatty_router";
+import { NewRouter as L } 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 h } from "koatty_serve";
 
-import * as y from "path";
+import { Trace as v } from "koatty_trace";
 
-var L = "3.13.2";
+import * as w from "path";
 
-var v = {
-  node: ">12.0.0"
+var C = "4.0.3";
+
+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 K = y;
+
+function P(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) {
+    u.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 b = C;
 
-const P = v.node.slice(1) || "12.0.0";
+const M = 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 R(t, o, e, a) {
+  if (u.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 && u.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 S() {
+  let t = M;
   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 (u.toNumber(t) > u.toNumber(o)) {
+    K.Fatal(`Koatty need node version > ${t}, current version is ${o}, please upgrade it.`);
     process.exit(-1);
   }
 }
 
-const $ = () => {
+const A = () => {
   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 $ = "CONFIGURATION_SCAN";
 
-const T = `\n\n┬┌─┌─┐┌─┐┌┬┐┌┬┐┬ ┬\n├┴┐│ │├─┤ │  │ └┬┘\n┴ ┴└─┘┴ ┴ ┴  ┴  ┴ \n-------------------------------------------\nhttps://github.com/koatty\n`
+const O = `\n\n┬┌─┌─┐┌─┐┌┬┐┌┬┐┬ ┬\n├┴┐│ │├─┤ │  │ └┬┘\n┴ ┴└─┘┴ ┴ ┴  ┴  ┴ \n-------------------------------------------\nhttps://github.com/koatty\n`
 /*
  * @Description: framework loader
  * @Usage:
@@ -132,261 +143,368 @@ 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") K.setLevel("debug"); else K.setLevel("info");
+    const o = t.rootPath || process.cwd();
+    const e = t.appPath || w.resolve(o, t.appDebug ? "src" : "dist");
+    const a = w.resolve(__dirname, "..");
+    u.define(t, "rootPath", o);
+    u.define(t, "appPath", e);
+    u.define(t, "koattyPath", a);
+    if (u.isEmpty(t.name)) {
+      const o = u.safeRequire(`${w.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;
+    K.Warn("Using process.env for paths is deprecated. Use app.rootPath, app.appPath, app.koattyPath instead.");
+    process.env.ROOT_PATH = o;
+    process.env.APP_PATH = e;
     process.env.KOATTY_PATH = a;
-    f.define(t, "thinkPath", a);
+    u.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 i = o.getClassMetadata(e, k, a);
+    if (i) if (u.isArray(i)) r = i; else r.push(i);
+    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, $, a);
+    let i = [];
+    if (r) if (u.isArray(r)) i = r; else i.push(r);
+    return i;
+  }
+  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) => {
+      R(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 = "", i = [];
       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) i = o.sensFields;
+      P(t, {
         logLevel: a,
-        logFilePath: s,
-        sensFields: r
+        logFilePath: r,
+        sensFields: i
       });
     }
   }
-  static LoadAppEventHooks(t, s) {
-    const r = new Map;
-    for (const t of a) {
-      let a;
+  static LoadAppEventHooks(t, i) {
+    const s = 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, i);
+        if (u.isArray(r)) s.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, i);
+        if (u.isArray(r)) s.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, i);
+        if (u.isArray(r)) s.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, i);
+        if (u.isArray(r)) s.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 s) for (const a of e) t.once(o, () => a(t));
   }
   static async LoadAllComponents(t, e) {
-    var o, a, s;
-    w.Log("Koatty", "", "Load Configurations ...");
+    try {
+      if (u.isFunction(o.preloadMetadata)) o.preloadMetadata();
+    } catch {
+      K.Warn("[Loader] preloadMetadata is optional, ignore if not available");
+    }
+    K.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 : {
-      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 n = new Loader(t);
+    n.LoadConfigs(r);
+    Loader.SetLogger(t);
+    K.Log("Koatty", "", "Emit Config Loaded ...");
+    await i(t, a.configLoaded);
+    K.Log("Koatty", "", "Initializing Component Manager ...");
+    const l = new s(t);
+    u.define(t, "componentManager", l);
+    l.discoverPlugins();
+    l.registerCorePluginHooks();
+    const c = l.getStats();
+    K.Log("Koatty", "", `Discovered ${c.corePlugins} core plugins, ${c.userPlugins} user plugins`);
+    K.Log("Koatty", "", "Emit Before Component Load ...");
+    await i(t, a.beforeComponentLoad);
+    K.Log("Koatty", "", "Load Components ...");
+    await n.LoadComponents(l);
+    K.Log("Koatty", "", "Emit After Component Load ...");
+    await i(t, a.afterComponentLoad);
+    K.Log("Koatty", "", "Emit Before Middleware Load ...");
+    await i(t, a.beforeMiddlewareLoad);
+    K.Log("Koatty", "", "Load Middlewares ...");
+    await n.LoadMiddlewares();
+    K.Log("Koatty", "", "Emit After Middleware Load ...");
+    await i(t, a.afterMiddlewareLoad);
+    K.Log("Koatty", "", "Emit Before Service Load ...");
+    await i(t, a.beforeServiceLoad);
+    K.Log("Koatty", "", "Load Services ...");
+    await n.LoadServices();
+    K.Log("Koatty", "", "Emit After Service Load ...");
+    await i(t, a.afterServiceLoad);
+    K.Log("Koatty", "", "Emit Before Controller Load ...");
+    await i(t, a.beforeControllerLoad);
+    K.Log("Koatty", "", "Load Controllers ...");
+    const d = await n.LoadControllers();
+    K.Log("Koatty", "", "Emit After Controller Load ...");
+    await i(t, a.afterControllerLoad);
+    K.Log("Koatty", "", "Emit Before Router Load ...");
+    await i(t, a.beforeRouterLoad);
+    K.Log("Koatty", "", "Load Routers ...");
+    await n.LoadRouter(d);
+    K.Log("Koatty", "", "Emit After Router Load ...");
+    await i(t, a.afterRouterLoad);
   }
-  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);
+  static CreateServers(t, o, e) {
+    if (e.length > 1) {
+      const a = [];
+      const r = u.isArray(o.port) ? o.port : [ o.port ];
+      const i = [];
+      for (let t = 0; t < e.length; t++) if (t < r.length) i.push(u.toNumber(r[t])); else i.push(u.toNumber(r[0]) + t);
+      for (let r = 0; r < e.length; r++) {
+        const s = e[r];
+        const n = {
+          ...o,
+          protocol: s,
+          port: i[r]
+        };
+        a.push(h(t, n));
+      }
+      return a;
+    } else {
+      const a = e[0];
+      const r = {
+        protocol: a,
+        ...o
+      };
+      return h(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] = L(t, e);
+      }
+      return a;
+    } else {
+      const a = e[0];
+      return L(t, {
+        protocol: a,
+        ...o
+      });
+    }
+  }
+  LoadConfigs(o) {
+    const e = {};
+    m([ "./config" ], this.app.koattyPath, function(t, o, a) {
+      e[t] = a;
+    });
+    if (u.isArray(o)) o = o.length > 0 ? o : [ "./config" ];
+    let a = t(o, this.app.appPath);
+    a = u.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);
+      u.define(this.app, "tracer", e);
+      this.app.use(e);
+      K.Debug(`Load trace middleware`);
+    } catch (t) {
+      K.Warn(`Trace middleware failed to load: ${t.message}`);
+    }
+    let r = this.app.config(void 0, "middleware");
+    if (u.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 i = (e = o.listClass("MIDDLEWARE")) !== null && e !== void 0 ? e : [];
+    i.forEach(t => {
+      var e;
+      t.id = ((e = t.id) !== null && e !== void 0 ? e : "").replace("MIDDLEWARE:", "");
+      if (t.id && u.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 (!n(e)) throw Error(`The middleware ${t.id} must implements interface 'IMiddleware'.`);
+      }
+    });
+    const s = r.list || [];
+    const d = new Set([]);
+    s.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 (!u.isFunction(e.run)) throw Error(`The middleware ${t} must implements interface 'IMiddleware'.`);
+      K.Debug(`Load middleware: ${t}`);
+      const r = p[t] || {};
+      const s = (a = i.find(o => o.id === t)) === null || a === void 0 ? void 0 : a.target;
+      let n = {};
+      if (s) try {
+        n = o.getPropertyData(l, s, t) || {};
+      } catch {
+        n = {};
+      }
+      const d = {
+        ...n,
+        ...r
+      };
+      if (d.enabled === !1) {
+        K.Warn(`The middleware ${t} has been loaded but is disabled.`);
+        continue;
+      }
+      const f = await e.run(d, this.app);
+      if (u.isFunction(f)) {
+        let o = f;
+        if (d.protocol) {
+          const e = u.isArray(d.protocol) ? d.protocol : [ d.protocol ];
+          K.Log("Koatty", "", `Middleware ${t} limited to protocols: ${e.join(", ")}`);
+          o = c(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 && u.isClass(t.target)) {
+        K.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 (!d(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, {
+    var t;
+    const e = o.listClass("SERVICE");
+    for (const a of e) {
+      a.id = ((t = a.id) !== null && t !== void 0 ? t : "").replace("SERVICE:", "");
+      if (a.id && u.isClass(a.target)) {
+        K.Debug(`Load service: ${a.id}`);
+        o.reg(a.id, a.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 t = o.getInsByClass(a.target);
+        if (!p(t)) throw Error(`The service ${a.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, {
+  async LoadComponents(t) {
+    var e, a;
+    const r = o.listClass("COMPONENT");
+    r.forEach(t => {
+      var e;
+      t.id = ((e = t.id) !== null && e !== void 0 ? e : "").replace("COMPONENT:", "");
+      if (u.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);
-        }
         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 (!f(e)) throw Error(`The aspect ${t.id} must implements interface 'IAspect'.`);
         }
       }
-    }));
-    let r = this.app.config(void 0, "plugin");
-    if (f.isEmpty(r)) r = {
-      config: {},
-      list: []
-    };
-    const i = (t = r.list) !== null && t !== void 0 ? t : [];
-    for (const t of i) {
-      const a = e.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.`);
-        continue;
+    });
+    if (t) await t.loadUserPlugins(); else {
+      K.Warn("Loading plugins in legacy mode");
+      let t = this.app.config(void 0, "plugin");
+      if (u.isEmpty(t)) t = {
+        config: {},
+        list: []
+      };
+      const r = (e = t.list) !== null && e !== void 0 ? e : [];
+      for (const e of r) {
+        const r = o.get(e, "COMPONENT");
+        if (!r) throw Error(`Plugin ${e} load error.`);
+        if (!u.isFunction(r.run)) throw Error(`Plugin ${e} must implements interface 'IPlugin'.`);
+        if (t.config[e] === !1) {
+          K.Warn(`Plugin ${e} already loaded but not effective.`);
+          continue;
+        }
+        await r.run((a = t.config[e]) !== null && a !== void 0 ? a : {}, this.app);
       }
-      await a.run((o = r.config[t]) !== null && o !== void 0 ? o : {}, this.app);
     }
   }
   async LoadRouter(t) {
-    await this.app.router.LoadRouter(this.app, t);
+    var o;
+    const e = this.app.router;
+    K.Log("Koatty", "", "============ LoadRouter START ============");
+    K.Log("Koatty", "", "router type:", typeof e);
+    K.Log("Koatty", "", "router is object:", u.isObject(e));
+    K.Log("Koatty", "", "router has LoadRouter:", u.isFunction(e === null || e === void 0 ? void 0 : e.LoadRouter));
+    K.Log("Koatty", "", "Controllers to load:", t);
+    if (u.isObject(e) && !u.isFunction(e.LoadRouter)) {
+      const a = e;
+      K.Log("Koatty", "", `Multi-protocol routing: found ${Object.keys(a).length} routers (${Object.keys(a).join(", ")})`);
+      for (const e in a) {
+        K.Log("Koatty", "", `Checking protocol: ${e}, has LoadRouter:`, u.isFunction((o = a[e]) === null || o === void 0 ? void 0 : o.LoadRouter));
+        if (a[e] && u.isFunction(a[e].LoadRouter)) {
+          K.Log("Koatty", "", `Loading routes for protocol: ${e}`);
+          await a[e].LoadRouter(this.app, t);
+          K.Log("Koatty", "", `Completed loading routes for protocol: ${e}`);
+        }
+      }
+    } else if (u.isFunction(e.LoadRouter)) {
+      K.Log("Koatty", "", "Single protocol routing");
+      await e.LoadRouter(this.app, t);
+    } else K.Warn("No valid router found! router:", e);
+    K.Log("Koatty", "", "============ LoadRouter END ============");
   }
 }
 
@@ -398,87 +516,110 @@ 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 g)) 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 g)) 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 g)) 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 g)) 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, $, 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 s = $();
-  if (!a && s) return;
-  const r = Reflect.construct(t, []);
+const x = async function(t, e, r = !1) {
+  S();
+  const s = A();
+  if (!r && s) return;
+  const n = Reflect.construct(t, []);
   if (s) {
-    r.silent = !0;
-    w.enable(!1);
+    n.silent = !0;
+    K.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 (!n.silent) console.log(O);
+    if (!(n instanceof g)) throw new Error(`class ${t.name} does not inherit from Koatty`);
+    Loader.initialize(n);
+    if (u.isFunction(e)) {
+      K.Log("Koatty", "", "Execute bootFunc ...");
+      await e(n);
     }
-    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(n);
+    K.Log("Koatty", "", "ComponentScan ...");
+    Loader.CheckAllComponents(n, t);
+    Loader.LoadAppEventHooks(n, t);
+    K.Log("Koatty", "", "Emit App Boot ...");
+    await i(n, a.appBoot);
+    await Loader.LoadAllComponents(n, t);
+    K.Log("Koatty", "", "Emit App Ready ...");
+    await i(n, a.appReady);
+    if (!s) {
+      K.Log("Koatty", "", "Emit Before Server Start ...");
+      await i(n, a.beforeServerStart);
+      n.listen(D);
+      K.Log("Koatty", "", "Emit After Server Start ...");
+      await i(n, a.afterServerStart);
+    }
+    return n;
   } catch (t) {
-    w.Error(t);
-    process.exit();
+    K.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 => {
+  K.Log("Koatty", "", "====================================");
+  K.Log("Koatty", "", `Nodejs Version: ${process.version}`);
+  K.Log("Koatty", "", `Koatty Version: v${b}`);
+  K.Log("Koatty", "", `App Environment: ${t.env}`);
+  if (t.appDebug) K.Warn(`Running in debug mode.`);
+  K.Log("Koatty", "", "====================================");
 };
 
-export { K as BindEventHook, _ as Bootstrap, S as ComponentScan, I as ConfigurationScan, O as ExecBootStrap, w as Logger };
+/*
+ * @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 B() {
+  try {
+    require("koatty_router/dist/RouterPlugin");
+  } catch (t) {}
+  try {
+    require("koatty_serve/dist/ServePlugin");
+  } catch (t) {}
+  try {
+    require("koatty_trace/dist/TracePlugin");
+  } catch (t) {}
+}
+
+B();
+
+export { I as BindEventHook, T as Bootstrap, F as ComponentScan, N as ConfigurationScan, _ as ExecBootStrap, K as Logger };