koatty 4.0.0 → 4.0.4

package/dist/index.mjs

@@ -1,6 +1,6 @@
 /*!
 * @Author: richen
-* @Date: 2025-11-02 10:59:15
+* @Date: 2026-01-28 16:08:28
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/
@@ -13,17 +13,17 @@ import { IOC as o, TAGGED_CLS as e } from "koatty_container";
 
 export * from "koatty_container";
 
-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";
+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 g } from "koatty_lib";
+import { Helper as u } from "koatty_lib";
 
 export { Helper } from "koatty_lib";
 
-import { NewRouter as h } from "koatty_router";
+import { NewRouter as L } from "koatty_router";
 
 export * from "koatty_router";
 
@@ -31,13 +31,13 @@ import { DefaultLogger as y } from "koatty_logger";
 
 import { Load as m } from "koatty_loader";
 
-import { NewServe as L } from "koatty_serve";
+import { NewServe as h } from "koatty_serve";
 
 import { Trace as v } from "koatty_trace";
 
-import * as C from "path";
+import * as w from "path";
 
-var w = "3.14.0-beta.1";
+var C = "4.0.4";
 
 var E = {
   node: ">=18.0.0"
@@ -51,9 +51,9 @@ var E = {
  * @LastEditTime: 2024-10-31 17:52:43
  * @License: BSD (3-Clause)
  * @Copyright (c): <richenlin(at)gmail.com>
- */ const b = y;
+ */ const K = y;
 
-function R(t, o) {
+function P(t, o) {
   if (!t.appDebug) y.enableBuffering({
     maxBufferSize: 200,
     flushInterval: 500,
@@ -61,7 +61,7 @@ function R(t, o) {
   });
   if (o.logLevel) y.setLevel(o.logLevel);
   if (o.logFilePath && !t.silent) {
-    g.define(t, "logsPath", o.logFilePath);
+    u.define(t, "logsPath", o.logFilePath);
     process.env.LOGS_PATH = o.logFilePath;
     y.setLogFilePath(o.logFilePath);
   }
@@ -80,15 +80,15 @@ function R(t, o) {
  * @LastEditTime: 2025-01-14 16:14:10
  * @License: BSD (3-Clause)
  * @Copyright (c): <richenlin(at)gmail.com>
- */ const P = w;
+ */ const b = C;
 
-const A = E.node.slice(1) || "12.0.0";
+const M = E.node.slice(1) || "12.0.0";
 
-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.`);
+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 && g.isClass(e[a[0]])) throw Error(`The file(${o}) name should be always the same as class name.`);
+    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 \`${o}\`.`);
@@ -96,19 +96,19 @@ function M(t, o, e, a) {
   return;
 }
 
-function K() {
-  let t = A;
+function S() {
+  let t = M;
   t = t.slice(0, t.lastIndexOf("."));
   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.`);
+  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 o = JSON.stringify(process.argv[1]);
   if (o.indexOf("jest") > -1) t = !0;
@@ -125,9 +125,9 @@ const $ = () => {
  * @Copyright (c): <richenlin(at)gmail.com>
  */ const k = "COMPONENT_SCAN";
 
-const O = "CONFIGURATION_SCAN";
+const $ = "CONFIGURATION_SCAN";
 
-const S = `\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:
@@ -143,45 +143,46 @@ class Loader {
     this.app = t;
   }
   static initialize(t) {
-    if (t.env == "development") b.setLevel("debug"); else b.setLevel("info");
+    if (t.env == "development") K.setLevel("debug"); else K.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`);
+    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;
       }
     }
+    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;
-    g.define(t, "thinkPath", a);
+    u.define(t, "thinkPath", a);
     process.env.THINK_PATH = a;
   }
   static GetComponentMeta(t, a) {
     let r = [];
-    const s = o.getClassMetadata(e, k, a);
-    if (s) if (g.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 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;
+    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) => {
-      M(t, o, e, r);
+      R(t, o, e, r);
     }, [ "**/**.js", "**/**.ts", "!**/**.d.ts" ], [ ...a, `${o.name || ".no"}.ts` ]);
     r.clear();
   }
@@ -190,93 +191,111 @@ class Loader {
     const e = o[0] || {};
     if (e.config) {
       const o = e.config;
-      let a = "debug", r = "", s = [];
+      let a = "debug", r = "", i = [];
       if (t.env === "production") a = "info";
       if (o.logsLevel) a = o.logsLevel.toLowerCase();
       if (o.logsPath) r = o.logsPath;
-      if (o.sensFields) s = o.sensFields;
-      R(t, {
+      if (o.sensFields) i = o.sensFields;
+      P(t, {
         logLevel: a,
         logFilePath: r,
-        sensFields: s
+        sensFields: i
       });
     }
   }
-  static LoadAppEventHooks(t, s) {
-    const i = new Map;
+  static LoadAppEventHooks(t, i) {
+    const s = new Map;
     for (const t of r) {
       let r;
       switch (t) {
        case a.appBoot:
-        r = o.getClassMetadata(e, a.appBoot, s);
-        if (g.isArray(r)) i.set(a.appBoot, r);
+        r = o.getClassMetadata(e, a.appBoot, i);
+        if (u.isArray(r)) s.set(a.appBoot, r);
         break;
 
        case a.appReady:
-        r = o.getClassMetadata(e, a.appReady, s);
-        if (g.isArray(r)) i.set(a.appReady, r);
+        r = o.getClassMetadata(e, a.appReady, i);
+        if (u.isArray(r)) s.set(a.appReady, r);
         break;
 
        case a.appStart:
-        r = o.getClassMetadata(e, a.appStart, s);
-        if (g.isArray(r)) i.set(a.appStart, r);
+        r = o.getClassMetadata(e, a.appStart, i);
+        if (u.isArray(r)) s.set(a.appStart, r);
         break;
 
        case a.appStop:
-        r = o.getClassMetadata(e, a.appStop, s);
-        if (g.isArray(r)) i.set(a.appStop, r);
+        r = o.getClassMetadata(e, a.appStop, i);
+        if (u.isArray(r)) s.set(a.appStop, r);
         break;
       }
     }
-    for (const [o, e] of i) for (const a of e) t.once(o, () => a(t));
+    for (const [o, e] of s) for (const a of e) t.once(o, () => a(t));
   }
   static async LoadAllComponents(t, e) {
-    var a, r, s;
     try {
-      if (g.isFunction(o.preloadMetadata)) o.preloadMetadata();
+      if (u.isFunction(o.preloadMetadata)) o.preloadMetadata();
     } catch {
-      b.Warn("[Loader] preloadMetadata is optional, ignore if not available");
+      K.Warn("[Loader] preloadMetadata is optional, ignore if not available");
     }
-    b.Log("Koatty", "", "Load Configurations ...");
-    const i = Loader.GetConfigurationMeta(t, e);
+    K.Log("Koatty", "", "Load Configurations ...");
+    const r = Loader.GetConfigurationMeta(t, e);
     const n = new Loader(t);
-    n.LoadConfigs(i);
+    n.LoadConfigs(r);
     Loader.SetLogger(t);
-    const l = (a = t.config("server")) !== null && a !== void 0 ? a : {
-      protocol: "http"
-    };
-    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 ...");
+    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();
-    b.Log("Koatty", "", "Load Services ...");
+    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();
-    b.Log("Koatty", "", "Load Controllers ...");
-    const h = await n.LoadControllers();
-    b.Log("Koatty", "", "Load Routers ...");
-    await n.LoadRouter(h);
+    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);
   }
   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);
+      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 i = e[r];
+        const s = e[r];
         const n = {
           ...o,
-          protocol: i,
-          port: s[r]
+          protocol: s,
+          port: i[r]
         };
-        a.push(L(t, n));
+        a.push(h(t, n));
       }
       return a;
     } else {
@@ -285,7 +304,7 @@ class Loader {
         protocol: a,
         ...o
       };
-      return L(t, r);
+      return h(t, r);
     }
   }
   static CreateRouters(t, o, e) {
@@ -297,12 +316,12 @@ class Loader {
           ...o
         };
         if (o.ext && o.ext[r]) e.ext = o.ext[r];
-        a[r] = h(t, e);
+        a[r] = L(t, e);
       }
       return a;
     } else {
       const a = e[0];
-      return h(t, {
+      return L(t, {
         protocol: a,
         ...o
       });
@@ -313,9 +332,9 @@ class Loader {
     m([ "./config" ], this.app.koattyPath, function(t, o, a) {
       e[t] = a;
     });
-    if (g.isArray(o)) o = o.length > 0 ? o : [ "./config" ];
+    if (u.isArray(o)) o = o.length > 0 ? o : [ "./config" ];
     let a = t(o, this.app.appPath);
-    a = g.extend(e, a, !0);
+    a = u.extend(e, a, !0);
     this.app.setMetaData("_configs", a);
   }
   async LoadMiddlewares() {
@@ -323,65 +342,65 @@ class Loader {
     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);
+      u.define(this.app, "tracer", e);
       this.app.use(e);
-      b.Debug(`Load trace middleware`);
+      K.Debug(`Load trace middleware`);
     } catch (t) {
-      b.Warn(`Trace middleware failed to load: ${t.message}`);
+      K.Warn(`Trace middleware failed to load: ${t.message}`);
     }
     let r = this.app.config(void 0, "middleware");
-    if (g.isEmpty(r)) r = {
+    if (u.isEmpty(r)) r = {
       config: {},
       list: []
     };
-    const l = (e = o.listClass("MIDDLEWARE")) !== null && e !== void 0 ? e : [];
-    l.forEach(t => {
+    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 && g.isClass(t.target)) {
+      if (t.id && u.isClass(t.target)) {
         o.reg(t.id, t.target, {
           scope: "Prototype",
           type: "MIDDLEWARE",
           args: []
         });
         const e = o.getInsByClass(t.target);
-        if (!s(e)) throw Error(`The middleware ${t.id} must implements interface 'IMiddleware'.`);
+        if (!n(e)) throw Error(`The middleware ${t.id} must implements interface 'IMiddleware'.`);
       }
     });
-    const c = r.list || [];
+    const s = r.list || [];
     const d = new Set([]);
-    c.forEach(t => {
+    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 (!g.isFunction(e.run)) throw Error(`The middleware ${t} must implements interface 'IMiddleware'.`);
-      b.Debug(`Load middleware: ${t}`);
+      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 = l.find(o => o.id === t)) === null || a === void 0 ? void 0 : a.target;
-      let c = {};
+      const s = (a = i.find(o => o.id === t)) === null || a === void 0 ? void 0 : a.target;
+      let n = {};
       if (s) try {
-        c = o.getPropertyData(i, s, t) || {};
+        n = o.getPropertyData(l, s, t) || {};
       } catch {
-        c = {};
+        n = {};
       }
       const d = {
-        ...c,
+        ...n,
         ...r
       };
       if (d.enabled === !1) {
-        b.Warn(`The middleware ${t} has been loaded but is disabled.`);
+        K.Warn(`The middleware ${t} has been loaded but is disabled.`);
         continue;
       }
       const f = await e.run(d, this.app);
-      if (g.isFunction(f)) {
+      if (u.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);
+          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);
       }
@@ -393,102 +412,99 @@ class Loader {
     t.forEach(t => {
       var a;
       t.id = ((a = t.id) !== null && a !== void 0 ? a : "").replace("CONTROLLER:", "");
-      if (t.id && g.isClass(t.target)) {
-        b.Debug(`Load controller: ${t.id}`);
+      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 = o.getInsByClass(t.target);
-        if (!l(a)) throw Error(`The controller ${t.id} must implements interface 'IController'.`);
+        if (!d(a)) throw Error(`The controller ${t.id} must implements interface 'IController'.`);
         e.push(t.id);
       }
     });
     return e;
   }
   async LoadServices() {
-    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, {
+    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 e = o.getInsByClass(t.target);
-        if (!c(e)) 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, e;
-    const a = o.listClass("COMPONENT");
-    const r = [];
-    a.forEach(async t => {
+  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 (g.isClass(t.target)) {
+      if (u.isClass(t.target)) {
         o.reg(t.id, t.target, {
           scope: "Singleton",
           type: "COMPONENT",
           args: []
         });
-        if (t.id && t.id.endsWith("Plugin")) {
-          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 e = o.getInsByClass(t.target);
-          if (!p(e)) throw Error(`The aspect ${t.id} must implements interface 'IAspect'.`);
+          if (!f(e)) throw Error(`The aspect ${t.id} must implements interface 'IAspect'.`);
         }
       }
     });
-    let s = this.app.config(void 0, "plugin");
-    if (g.isEmpty(s)) s = {
-      config: {},
-      list: []
-    };
-    const i = (t = s.list) !== null && t !== void 0 ? t : [];
-    for (const t of i) {
-      const a = o.get(t, "COMPONENT");
-      if (!a) throw Error(`Plugin ${t} load error.`);
-      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;
+    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((e = s.config[t]) !== null && e !== void 0 ? e : {}, this.app);
     }
   }
   async LoadRouter(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)) {
+    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;
-      b.Log("Koatty", "", `Multi-protocol routing: found ${Object.keys(a).length} routers (${Object.keys(a).join(", ")})`);
+      K.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}`);
+        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);
-          b.Log("Koatty", "", `Completed loading routes for protocol: ${e}`);
+          K.Log("Koatty", "", `Completed loading routes for protocol: ${e}`);
         }
       }
-    } else if (g.isFunction(e.LoadRouter)) {
-      b.Log("Koatty", "", "Single protocol routing");
+    } else if (u.isFunction(e.LoadRouter)) {
+      K.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 ============");
+    } else K.Warn("No valid router found! router:", e);
+    K.Log("Koatty", "", "============ LoadRouter END ============");
   }
 }
 
@@ -502,7 +518,7 @@ class Loader {
  * @Copyright (c): <richenlin(at)gmail.com>
  */ function T(t) {
   return function(o) {
-    if (!(o.prototype instanceof f)) throw new Error(`class does not inherit from Koatty`);
+    if (!(o.prototype instanceof g)) throw new Error(`class does not inherit from Koatty`);
     x(o, t);
     return o;
   };
@@ -510,14 +526,14 @@ class Loader {
 
 function _(t) {
   return async o => {
-    if (!(o.prototype instanceof f)) throw new Error(`class ${o.name} does not inherit from Koatty`);
+    if (!(o.prototype instanceof g)) throw new Error(`class ${o.name} does not inherit from Koatty`);
     return await x(o, t, !0);
   };
 }
 
 function F(t) {
   return a => {
-    if (!(a.prototype instanceof f)) 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 : "";
     o.saveClassMetadata(e, k, t, a);
   };
@@ -525,9 +541,9 @@ function F(t) {
 
 function N(t) {
   return a => {
-    if (!(a.prototype instanceof f)) 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 : "";
-    o.saveClassMetadata(e, O, t, a);
+    o.saveClassMetadata(e, $, t, a);
   };
 }
 
@@ -536,46 +552,74 @@ function I(t, a, r) {
 }
 
 const x = async function(t, e, r = !1) {
-  K();
-  const s = $();
+  S();
+  const s = A();
   if (!r && s) return;
-  const i = Reflect.construct(t, []);
+  const n = Reflect.construct(t, []);
   if (s) {
-    i.silent = !0;
-    b.enable(!1);
+    n.silent = !0;
+    K.enable(!1);
   }
   try {
-    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);
+    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);
     }
-    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;
+    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) {
-    b.Fatal(t);
+    K.Fatal(t);
     process.exit(1);
   }
 };
 
 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", "", "====================================");
+  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 { I as BindEventHook, T as Bootstrap, F as ComponentScan, N as ConfigurationScan, _ as ExecBootStrap, b 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 };