koatty 4.1.0 → 4.1.2

package/.turbo/turbo-build.log

@@ -1,17 +1,17 @@
 
 
-> koatty@4.1.0 build /Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty
+> koatty@4.1.2 build /Users/richen/Workspace/nodejs/koatty-monorepo/packages/koatty
 > npm run build:js && npm run build:dts && npm run build:doc && npm run build:cp
 
 
-> koatty@4.1.0 build:js
+> koatty@4.1.2 build:js
 > npx rollup --bundleConfigAsCjs -c .rollup.config.js
 
 
 ./src/index.ts → ./dist/index.js, ./dist/index.mjs...
-created ./dist/index.js, ./dist/index.mjs in 993ms
+created ./dist/index.js, ./dist/index.mjs in 1s
 ⠙⠙
-> koatty@4.1.0 build:dts
+> koatty@4.1.2 build:dts
 > bash scripts/build-dts.sh
 
 🔨 Building type declarations for koatty...
@@ -33,7 +33,7 @@
 ✅ All dependencies ready (waited 2ms)
 📝 Running TypeScript compiler...
 ⠙📦 Running API Extractor...
-
+⠙
 api-extractor 7.55.2  - https://api-extractor.com/
 
 Using configuration from ./api-extractor.json
@@ -64,7 +64,7 @@ Analysis will use the bundled TypeScript version 5.8.2
 API Extractor completed successfully
 ⠙✅ Type declarations built successfully
 ⠙
-> koatty@4.1.0 build:doc
+> koatty@4.1.2 build:doc
 > npx api-documenter markdown --input temp --output docs/api
 
 
@@ -75,7 +75,7 @@ Reading koatty.api.json
 Deleting old output from docs/api
 Writing koatty package
 ⠙⠙
-> koatty@4.1.0 build:cp
+> koatty@4.1.2 build:cp
 > node scripts/copyFiles && node scripts/postBuild
 
 Copied package.json to dist/

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 4.1.2
+
+### Patch Changes
+
+- build
+- Updated dependencies
+  - koatty_serve@3.1.1
+  - koatty_trace@2.1.1
+
+## 4.1.1
+
+### Patch Changes
+
+- build
+
 ## 4.1.0
 
 ### Minor Changes

package/README.md

@@ -23,7 +23,7 @@ Koa + TypeScript + IOC = Koatty. **Koatty** is a progressive Node.js framework f
 - ✅ **Protocol-Specific Middleware** - Bind middleware to specific protocols with `@Middleware({ protocol: [...] })`
 - ✅ **Graceful Shutdown** - Enhanced connection pool management and cleanup handlers
 - ✅ **Enhanced gRPC Support** - Timeout detection, duplicate call protection, streaming improvements
-- ✅ **Application Lifecycle Hooks** - Custom decorators with `BindEventHook` API for boot/ready/stop events
+- ✅ **Application Lifecycle Hooks** - Custom decorators with `@OnEvent` decorator API for framework lifecycle events
 - ✅ **Version Conflict Detection** - Automatic detection and resolution of dependency conflicts
 - ✅ **GraphQL over HTTP/2** - Automatic HTTP/2 upgrade with SSL for multiplexing and compression
 - ✅ **Global Exception Handling** - `@ExceptionHandler()` decorator for centralized error management
@@ -274,24 +274,34 @@ export class LoggerPlugin implements IPlugin {
 
 **Application Lifecycle Events:**
 ```typescript
-// Use BindEventHook to customize application behavior
-export function CustomDecorator(): ClassDecorator {
-  return (target: Function) => {
-    BindEventHook(AppEvent.appBoot, async (app: KoattyApplication) => {
-      // Executed during application boot
-      console.log('App is booting...');
-    }, target);
-    
-    BindEventHook(AppEvent.appReady, async (app: KoattyApplication) => {
-      // Executed when app is ready
-      console.log('App is ready!');
-    }, target);
-    
-    BindEventHook(AppEvent.appStop, async (app: KoattyApplication) => {
-      // Executed during graceful shutdown
-      console.log('App is stopping...');
-    }, target);
-  };
+// Use @OnEvent to hook into application lifecycle events
+@Component("MyComponent", { 
+  scope: 'user', 
+  priority: 50,
+  description: 'Custom component example'
+})
+export class MyComponent {
+  
+  // Execute when router loads
+  @OnEvent(AppEvent.loadRouter)
+  async initRouter(app: KoattyApplication) {
+    console.log('Initializing router...');
+    // Custom router initialization logic
+  }
+  
+  // Execute when application is ready
+  @OnEvent(AppEvent.appReady)
+  async onReady(app: KoattyApplication) {
+    console.log('Application ready');
+    // Service registration, connection pool initialization, etc.
+  }
+  
+  // Execute when application stops
+  @OnEvent(AppEvent.appStop)
+  async cleanup(app: KoattyApplication) {
+    console.log('Cleaning up resources...');
+    // Close connections, release resources
+  }
 }
 ```
 

package/dist/README.md

@@ -23,7 +23,7 @@ Koa + TypeScript + IOC = Koatty. **Koatty** is a progressive Node.js framework f
 - ✅ **Protocol-Specific Middleware** - Bind middleware to specific protocols with `@Middleware({ protocol: [...] })`
 - ✅ **Graceful Shutdown** - Enhanced connection pool management and cleanup handlers
 - ✅ **Enhanced gRPC Support** - Timeout detection, duplicate call protection, streaming improvements
-- ✅ **Application Lifecycle Hooks** - Custom decorators with `BindEventHook` API for boot/ready/stop events
+- ✅ **Application Lifecycle Hooks** - Custom decorators with `@OnEvent` decorator API for framework lifecycle events
 - ✅ **Version Conflict Detection** - Automatic detection and resolution of dependency conflicts
 - ✅ **GraphQL over HTTP/2** - Automatic HTTP/2 upgrade with SSL for multiplexing and compression
 - ✅ **Global Exception Handling** - `@ExceptionHandler()` decorator for centralized error management
@@ -274,24 +274,34 @@ export class LoggerPlugin implements IPlugin {
 
 **Application Lifecycle Events:**
 ```typescript
-// Use BindEventHook to customize application behavior
-export function CustomDecorator(): ClassDecorator {
-  return (target: Function) => {
-    BindEventHook(AppEvent.appBoot, async (app: KoattyApplication) => {
-      // Executed during application boot
-      console.log('App is booting...');
-    }, target);
-    
-    BindEventHook(AppEvent.appReady, async (app: KoattyApplication) => {
-      // Executed when app is ready
-      console.log('App is ready!');
-    }, target);
-    
-    BindEventHook(AppEvent.appStop, async (app: KoattyApplication) => {
-      // Executed during graceful shutdown
-      console.log('App is stopping...');
-    }, target);
-  };
+// Use @OnEvent to hook into application lifecycle events
+@Component("MyComponent", { 
+  scope: 'user', 
+  priority: 50,
+  description: 'Custom component example'
+})
+export class MyComponent {
+  
+  // Execute when router loads
+  @OnEvent(AppEvent.loadRouter)
+  async initRouter(app: KoattyApplication) {
+    console.log('Initializing router...');
+    // Custom router initialization logic
+  }
+  
+  // Execute when application is ready
+  @OnEvent(AppEvent.appReady)
+  async onReady(app: KoattyApplication) {
+    console.log('Application ready');
+    // Service registration, connection pool initialization, etc.
+  }
+  
+  // Execute when application stops
+  @OnEvent(AppEvent.appStop)
+  async cleanup(app: KoattyApplication) {
+    console.log('Cleaning up resources...');
+    // Close connections, release resources
+  }
 }
 ```
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /*!
 * @Author: richen
-* @Date: 2026-01-31 09:50:38
+* @Date: 2026-02-03 10:52:27
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/

package/dist/index.js

@@ -1,6 +1,6 @@
 /*!
 * @Author: richen
-* @Date: 2026-01-31 09:50:32
+* @Date: 2026-02-03 10:52:21
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/
@@ -165,7 +165,6 @@ class Loader {
         e.version = e.version || t.version;
       }
     }
-    u.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 = a;
@@ -458,7 +457,7 @@ class Loader {
   return function(a) {
     if (!(a.prototype instanceof o.Koatty)) throw new Error(`class does not inherit from Koatty`);
     t.IOC.saveClass("COMPONENT", a, "KOATTY_APP");
-    k(a, e);
+    H(a, e);
     return a;
   };
 }
@@ -466,7 +465,7 @@ class Loader {
 function A(e) {
   return async t => {
     if (!(t.prototype instanceof o.Koatty)) throw new Error(`class ${t.name} does not inherit from Koatty`);
-    return await k(t, e, !0);
+    return await H(t, e, !0);
   };
 }
 
@@ -486,7 +485,7 @@ function M(e) {
   };
 }
 
-const k = async function(e, a, n = !1) {
+const H = async function(e, a, n = !1) {
   if (process.env.NODE_DEBUG) {
     const e = process.env.NODE_DEBUG.split(",").filter(e => !e.includes("winston")).join(",");
     process.env.NODE_DEBUG = e;
@@ -511,14 +510,14 @@ const k = async function(e, a, n = !1) {
     u.Log("Koatty", "", "ComponentScan ...");
     Loader.CheckAllComponents(i, e);
     await Loader.LoadAllComponents(i, e);
-    if (!s) i.listen(H);
+    if (!s) i.listen(T);
     return i;
   } catch (e) {
     u.Fatal(e);
   }
 };
 
-const H = e => {
+const T = e => {
   u.Log("Koatty", "", "====================================");
   u.Log("Koatty", "", `Nodejs Version: ${process.version}`);
   u.Log("Koatty", "", `Koatty Version: v${m}`);

package/dist/index.mjs

@@ -1,19 +1,19 @@
 /*!
 * @Author: richen
-* @Date: 2026-01-31 09:50:32
+* @Date: 2026-02-03 10:52:21
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/
 */
-import { LoadConfigs as t } from "koatty_config";
+import { LoadConfigs as e } from "koatty_config";
 
 export { Config } from "koatty_config";
 
-import { IOC as e, TAGGED_CLS as o } from "koatty_container";
+import { IOC as t, TAGGED_CLS as o } from "koatty_container";
 
 export * from "koatty_container";
 
-import { AppEvent as a, AppEventArr as s, asyncEvent as n, ComponentManager as i, implementsMiddlewareInterface as r, MIDDLEWARE_OPTIONS as l, protocolMiddleware as c, implementsControllerInterface as d, implementsServiceInterface as p, implementsAspectInterface as f, Koatty as g } from "koatty_core";
+import { AppEvent as a, AppEventArr as s, asyncEvent as n, ComponentManager as i, implementsMiddlewareInterface as r, MIDDLEWARE_OPTIONS as l, protocolMiddleware as c, implementsControllerInterface as d, implementsServiceInterface as f, implementsAspectInterface as p, Koatty as g } from "koatty_core";
 
 export * from "koatty_core";
 
@@ -46,22 +46,22 @@ import * as v from "path";
  */
 const L = u;
 
-function w(t, e) {
-  if (!t.appDebug) {
+function w(e, t) {
+  if (!e.appDebug) {
     u.enableBatch(!0);
     u.setBatchConfig({
       maxSize: 200,
       flushInterval: 500
     });
   }
-  if (e.logLevel) u.setLevel(e.logLevel);
-  if (e.logFilePath && !t.silent) {
-    m.define(t, "logsPath", e.logFilePath);
-    process.env.LOGS_PATH = e.logFilePath;
-    u.setLogFilePath(e.logFilePath);
+  if (t.logLevel) u.setLevel(t.logLevel);
+  if (t.logFilePath && !e.silent) {
+    m.define(e, "logsPath", t.logFilePath);
+    process.env.LOGS_PATH = t.logFilePath;
+    u.setLogFilePath(t.logFilePath);
   }
-  if (e.sensFields) u.setSensFields(e.sensFields);
-  t.once(a.appStop, async () => {
+  if (t.sensFields) u.setSensFields(t.sensFields);
+  e.once(a.appStop, async () => {
     await u.flushBatch();
     await u.destroy();
   });
@@ -81,34 +81,34 @@ const {engines: E, version: P} = C;
 
 const b = P;
 
-const k = E.node.slice(1) || "12.0.0";
+const M = E.node.slice(1) || "12.0.0";
 
-function M(t, e, o, a) {
-  if (m.isClass(o) && o.name != t) throw Error(`The file(${e}) name should be always the same as class name.`);
+function k(e, t, o, a) {
+  if (m.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 a = Object.keys(o);
-    if (a[0] != t && m.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.`);
+    if (a[0] != e && m.isClass(o[a[0]])) throw Error(`The file(${t}) name should be always the same as class name.`);
+  } else if (o.name != e) throw Error(`The file(${t}) 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}\`.`);
-  a.add(t);
+  if (a.has(e)) throw new Error(`A same class already exists. at \`${t}\`.`);
+  a.add(e);
   return;
 }
 
 function O() {
-  let t = k;
-  t = t.slice(0, t.lastIndexOf("."));
-  let e = process.version;
-  if (e[0] === "v") e = e.slice(1);
+  let e = M;
   e = e.slice(0, e.lastIndexOf("."));
-  if (m.toNumber(t) > m.toNumber(e)) L.Fatal(`Koatty need node version > ${t}, current version is ${e}, please upgrade it.`);
+  let t = process.version;
+  if (t[0] === "v") t = t.slice(1);
+  t = t.slice(0, t.lastIndexOf("."));
+  if (m.toNumber(e) > m.toNumber(t)) L.Fatal(`Koatty need node version > ${e}, current version is ${t}, please upgrade it.`);
 }
 
 const T = () => {
-  let t = !1;
-  const e = JSON.stringify(process.argv[1]);
-  if (e.indexOf("jest") > -1) t = !0;
-  return t;
+  let e = !1;
+  const t = JSON.stringify(process.argv[1]);
+  if (t.indexOf("jest") > -1) e = !0;
+  return e;
 };
 
 /*
@@ -135,95 +135,94 @@ const $ = `\n\n┬┌─┌─┐┌─┐┌┬┐┌┬┐┬ ┬\n├┴┐
  */;
 
 class Loader {
-  constructor(t) {
-    this.app = t;
+  constructor(e) {
+    this.app = e;
   }
-  static initialize(t) {
-    if (t.env == "development") L.setLevel("debug"); else L.setLevel("info");
-    const e = t.rootPath || process.cwd();
-    const o = t.appPath || v.resolve(e, t.appDebug ? "src" : "dist");
+  static initialize(e) {
+    if (e.env == "development") L.setLevel("debug"); else L.setLevel("info");
+    const t = e.rootPath || process.cwd();
+    const o = e.appPath || v.resolve(t, e.appDebug ? "src" : "dist");
     const a = v.resolve(__dirname, "..");
-    m.define(t, "rootPath", e);
-    m.define(t, "appPath", o);
-    m.define(t, "koattyPath", a);
-    if (m.isEmpty(t.name)) {
-      const e = m.safeRequire(`${v.dirname(o)}/package.json`);
-      if (e.name) {
-        t.name = e.name;
-        t.version = t.version || e.version;
+    m.define(e, "rootPath", t);
+    m.define(e, "appPath", o);
+    m.define(e, "koattyPath", a);
+    if (m.isEmpty(e.name)) {
+      const t = m.safeRequire(`${v.dirname(o)}/package.json`);
+      if (t.name) {
+        e.name = t.name;
+        e.version = e.version || t.version;
       }
     }
-    L.Warn("Using process.env for paths is deprecated. Use app.rootPath, app.appPath, app.koattyPath instead.");
-    process.env.ROOT_PATH = e;
+    process.env.ROOT_PATH = t;
     process.env.APP_PATH = o;
     process.env.KOATTY_PATH = a;
-    m.define(t, "thinkPath", a);
+    m.define(e, "thinkPath", a);
     process.env.THINK_PATH = a;
   }
-  static GetComponentMeta(t, a) {
+  static GetComponentMeta(e, a) {
     let s = [];
-    const n = e.getClassMetadata(o, _, a);
+    const n = t.getClassMetadata(o, _, a);
     if (n) if (m.isArray(n)) s = n; else s.push(n);
-    if (s.length < 1) s = [ t.appPath ];
+    if (s.length < 1) s = [ e.appPath ];
     return s;
   }
-  static GetConfigurationMeta(t, a) {
-    const s = e.getClassMetadata(o, A, a);
+  static GetConfigurationMeta(e, a) {
+    const s = t.getClassMetadata(o, A, a);
     let n = [];
     if (s) if (m.isArray(s)) n = s; else n.push(s);
     return n;
   }
-  static CheckAllComponents(t, e) {
-    const o = Loader.GetComponentMeta(t, e);
-    const a = Loader.GetConfigurationMeta(t, e);
+  static CheckAllComponents(e, t) {
+    const o = Loader.GetComponentMeta(e, t);
+    const a = Loader.GetConfigurationMeta(e, t);
     const s = new Set;
-    h(o, "", (t, e, o) => {
-      M(t, e, o, s);
-    }, [ "**/**.js", "**/**.ts", "!**/**.d.ts" ], [ ...a, `${e.name || ".no"}.ts` ]);
+    h(o, "", (e, t, o) => {
+      k(e, t, o, s);
+    }, [ "**/**.js", "**/**.ts", "!**/**.d.ts" ], [ ...a, `${t.name || ".no"}.ts` ]);
     s.clear();
   }
-  static SetLogger(t) {
-    const e = t.getMetaData("_configs") || [];
-    const o = e[0] || {};
+  static SetLogger(e) {
+    const t = e.getMetaData("_configs") || [];
+    const o = t[0] || {};
     if (o.config) {
-      const e = o.config;
+      const t = o.config;
       let a = "debug", s = "", n = [];
-      if (t.env === "production") a = "info";
-      if (e.logsLevel) a = e.logsLevel.toLowerCase();
-      if (e.logsPath) s = e.logsPath;
-      if (e.sensFields) n = e.sensFields;
-      w(t, {
+      if (e.env === "production") a = "info";
+      if (t.logsLevel) a = t.logsLevel.toLowerCase();
+      if (t.logsPath) s = t.logsPath;
+      if (t.sensFields) n = t.sensFields;
+      w(e, {
         logLevel: a,
         logFilePath: s,
         sensFields: n
       });
     }
   }
-  static async LoadAllComponents(t, o) {
+  static async LoadAllComponents(e, o) {
     try {
-      if (m.isFunction(e.preloadMetadata)) e.preloadMetadata();
+      if (m.isFunction(t.preloadMetadata)) t.preloadMetadata();
     } catch {
       L.Warn("[Loader] preloadMetadata is optional, ignore if not available");
     }
-    const r = Loader.GetConfigurationMeta(t, o);
-    const l = new Loader(t);
-    for (const e of s) switch (e) {
+    const r = Loader.GetConfigurationMeta(e, o);
+    const l = new Loader(e);
+    for (const t of s) switch (t) {
      case a.appBoot:
       L.Log("Koatty", "", "Load Configurations ...");
       l.LoadConfigs(r);
-      Loader.SetLogger(t);
-      await n(t, e);
+      Loader.SetLogger(e);
+      await n(e, t);
       break;
 
      case a.loadConfigure:
       L.Log("Koatty", "", "Emit loadConfigure ...");
-      await n(t, e);
+      await n(e, t);
       break;
 
      case a.loadComponent:
       L.Log("Koatty", "", "Initializing Component Manager ...");
-      const s = new i(t);
-      m.define(t, "componentManager", s);
+      const s = new i(e);
+      m.define(e, "componentManager", s);
       s.discoverComponents();
       const c = s.getStats();
       L.Log("Koatty", "", `Discovered ${c.coreComponents} core components, ${c.userComponents} user components`);
@@ -231,108 +230,108 @@ class Loader {
       await l.LoadComponents(s);
       s.registerAppEvents(o);
       s.registerCoreComponentHooks();
-      await n(t, e);
+      await n(e, t);
       break;
 
      case a.loadPlugin:
       L.Log("Koatty", "", "Emit loadPlugin ...");
-      await n(t, e);
+      await n(e, t);
       break;
 
      case a.loadMiddleware:
       L.Log("Koatty", "", "Load Middlewares ...");
       await l.LoadMiddlewares();
-      await n(t, e);
+      await n(e, t);
       break;
 
      case a.loadService:
       L.Log("Koatty", "", "Load Services ...");
       await l.LoadServices();
-      await n(t, e);
+      await n(e, t);
       break;
 
      case a.loadController:
       L.Log("Koatty", "", "Load Controllers ...");
       await l.LoadControllers();
-      await n(t, e);
+      await n(e, t);
       break;
 
      case a.loadRouter:
       L.Log("Koatty", "", "Initialize Router and Load Routes ...");
-      await n(t, e);
+      await n(e, t);
       break;
 
      case a.loadServe:
       L.Log("Koatty", "", "Emit loadServe ...");
-      await n(t, e);
+      await n(e, t);
       break;
 
      case a.appReady:
       L.Log("Koatty", "", "Emit appReady ...");
-      await n(t, e);
+      await n(e, t);
       break;
 
      default:
-      await n(t, e);
+      await n(e, t);
       break;
     }
   }
-  LoadConfigs(e) {
+  LoadConfigs(t) {
     const o = {};
-    h([ "./config" ], this.app.koattyPath, function(t, e, a) {
-      o[t] = a;
+    h([ "./config" ], this.app.koattyPath, function(e, t, a) {
+      o[e] = a;
     });
-    if (m.isArray(e)) e = e.length > 0 ? e : [ "./config" ];
-    let a = t(e, this.app.appPath);
+    if (m.isArray(t)) t = t.length > 0 ? t : [ "./config" ];
+    let a = e(t, this.app.appPath);
     a = m.extend(o, a, !0);
     this.app.setMetaData("_configs", a);
   }
   async LoadMiddlewares() {
-    var t, o, a, s;
+    var e, o, a, s;
     let n = this.app.config(void 0, "middleware");
     if (m.isEmpty(n)) n = {
       config: {},
       list: []
     };
     try {
-      const e = (o = (t = n.config) === null || t === void 0 ? void 0 : t.trace) !== null && o !== void 0 ? o : {};
-      const a = y(e, this.app);
+      const t = (o = (e = n.config) === null || e === void 0 ? void 0 : e.trace) !== null && o !== void 0 ? o : {};
+      const a = y(t, this.app);
       m.define(this.app, "tracer", a);
       this.app.use(a);
       L.Debug(`Trace middleware registered`);
-    } catch (t) {
-      L.Warn(`Trace middleware failed to load: ${t.message}`);
+    } catch (e) {
+      L.Warn(`Trace middleware failed to load: ${e.message}`);
     }
-    const i = (a = e.listClass("MIDDLEWARE")) !== null && a !== void 0 ? a : [];
-    i.forEach(t => {
+    const i = (a = t.listClass("MIDDLEWARE")) !== null && a !== void 0 ? a : [];
+    i.forEach(e => {
       var o;
-      t.id = ((o = t.id) !== null && o !== void 0 ? o : "").replace("MIDDLEWARE:", "");
-      if (t.id && m.isClass(t.target)) {
-        e.reg(t.id, t.target, {
+      e.id = ((o = e.id) !== null && o !== void 0 ? o : "").replace("MIDDLEWARE:", "");
+      if (e.id && m.isClass(e.target)) {
+        t.reg(e.id, e.target, {
           scope: "Prototype",
           type: "MIDDLEWARE",
           args: []
         });
-        const o = e.getInsByClass(t.target);
-        if (!r(o)) throw Error(`The middleware ${t.id} must implements interface 'IMiddleware'.`);
+        const o = t.getInsByClass(e.target);
+        if (!r(o)) throw Error(`The middleware ${e.id} must implements interface 'IMiddleware'.`);
       }
     });
     const d = n.list || [];
-    const p = new Set([]);
-    d.forEach(t => {
-      p.add(t);
+    const f = new Set([]);
+    d.forEach(e => {
+      f.add(e);
     });
-    const f = n.config || {};
-    for (const t of Array.from(p)) {
-      const o = e.get(t, "MIDDLEWARE");
-      if (!o) throw Error(`Middleware ${t} load error.`);
-      if (!m.isFunction(o.run)) throw Error(`The middleware ${t} must implements interface 'IMiddleware'.`);
-      L.Debug(`Load middleware: ${t}`);
-      const a = f[t] || {};
-      const n = (s = i.find(e => e.id === t)) === null || s === void 0 ? void 0 : s.target;
+    const p = n.config || {};
+    for (const e of Array.from(f)) {
+      const o = t.get(e, "MIDDLEWARE");
+      if (!o) throw Error(`Middleware ${e} load error.`);
+      if (!m.isFunction(o.run)) throw Error(`The middleware ${e} must implements interface 'IMiddleware'.`);
+      L.Debug(`Load middleware: ${e}`);
+      const a = p[e] || {};
+      const n = (s = i.find(t => t.id === e)) === null || s === void 0 ? void 0 : s.target;
       let r = {};
       if (n) try {
-        r = e.getPropertyData(l, n, t) || {};
+        r = t.getPropertyData(l, n, e) || {};
       } catch {
         r = {};
       }
@@ -341,94 +340,94 @@ class Loader {
         ...a
       };
       if (d.enabled === !1) {
-        L.Warn(`The middleware ${t} has been loaded but is disabled.`);
+        L.Warn(`The middleware ${e} has been loaded but is disabled.`);
         continue;
       }
-      const p = await o.run(d, this.app);
-      if (m.isFunction(p)) {
-        let e = p;
+      const f = await o.run(d, this.app);
+      if (m.isFunction(f)) {
+        let t = f;
         if (d.protocol) {
           const o = m.isArray(d.protocol) ? d.protocol : [ d.protocol ];
-          L.Log("Koatty", "", `Middleware ${t} limited to protocols: ${o.join(", ")}`);
-          e = c(o, p);
+          L.Log("Koatty", "", `Middleware ${e} limited to protocols: ${o.join(", ")}`);
+          t = c(o, f);
         }
-        if (e.length < 3) this.app.use(e); else this.app.useExp(e);
+        if (t.length < 3) this.app.use(t); else this.app.useExp(t);
       }
     }
   }
   async LoadControllers() {
-    const t = e.listClass("CONTROLLER");
+    const e = t.listClass("CONTROLLER");
     const o = [];
-    t.forEach(t => {
+    e.forEach(e => {
       var a;
-      t.id = ((a = t.id) !== null && a !== void 0 ? a : "").replace("CONTROLLER:", "");
-      if (t.id && m.isClass(t.target)) {
-        L.Debug(`Load controller: ${t.id}`);
-        e.reg(t.id, t.target, {
+      e.id = ((a = e.id) !== null && a !== void 0 ? a : "").replace("CONTROLLER:", "");
+      if (e.id && m.isClass(e.target)) {
+        L.Debug(`Load controller: ${e.id}`);
+        t.reg(e.id, e.target, {
           scope: "Prototype",
           type: "CONTROLLER",
           args: []
         });
-        const a = e.getInsByClass(t.target);
-        if (!d(a)) throw Error(`The controller ${t.id} must implements interface 'IController'.`);
-        o.push(t.id);
+        const a = t.getInsByClass(e.target);
+        if (!d(a)) throw Error(`The controller ${e.id} must implements interface 'IController'.`);
+        o.push(e.id);
       }
     });
     this.app.setMetaData("_controllers", o);
     return o;
   }
   async LoadServices() {
-    var t;
-    const o = e.listClass("SERVICE");
+    var e;
+    const o = t.listClass("SERVICE");
     for (const a of o) {
-      a.id = ((t = a.id) !== null && t !== void 0 ? t : "").replace("SERVICE:", "");
+      a.id = ((e = a.id) !== null && e !== void 0 ? e : "").replace("SERVICE:", "");
       if (a.id && m.isClass(a.target)) {
         L.Debug(`Load service: ${a.id}`);
-        e.reg(a.id, a.target, {
+        t.reg(a.id, a.target, {
           scope: "Singleton",
           type: "SERVICE",
           args: []
         });
-        const t = e.getInsByClass(a.target);
-        if (!p(t)) throw Error(`The service ${a.id} must implements interface 'IService'.`);
+        const e = t.getInsByClass(a.target);
+        if (!f(e)) throw Error(`The service ${a.id} must implements interface 'IService'.`);
       }
     }
   }
-  async LoadComponents(t) {
+  async LoadComponents(e) {
     var o, a;
-    const s = e.listClass("COMPONENT");
-    s.forEach(t => {
+    const s = t.listClass("COMPONENT");
+    s.forEach(e => {
       var o;
-      t.id = ((o = t.id) !== null && o !== void 0 ? o : "").replace("COMPONENT:", "");
-      if (m.isClass(t.target)) {
-        e.reg(t.id, t.target, {
+      e.id = ((o = e.id) !== null && o !== void 0 ? o : "").replace("COMPONENT:", "");
+      if (m.isClass(e.target)) {
+        t.reg(e.id, e.target, {
           scope: "Singleton",
           type: "COMPONENT",
           args: []
         });
-        if (t.id && t.id.endsWith("Aspect")) {
-          const o = e.getInsByClass(t.target);
-          if (!f(o)) throw Error(`The aspect ${t.id} must implements interface 'IAspect'.`);
+        if (e.id && e.id.endsWith("Aspect")) {
+          const o = t.getInsByClass(e.target);
+          if (!p(o)) throw Error(`The aspect ${e.id} must implements interface 'IAspect'.`);
         }
       }
     });
-    if (t) await t.loadUserComponents(); else {
+    if (e) await e.loadUserComponents(); else {
       L.Warn("Loading plugins in legacy mode");
-      let t = this.app.config(void 0, "plugin");
-      if (m.isEmpty(t)) t = {
+      let e = this.app.config(void 0, "plugin");
+      if (m.isEmpty(e)) e = {
         config: {},
         list: []
       };
-      const s = (o = t.list) !== null && o !== void 0 ? o : [];
+      const s = (o = e.list) !== null && o !== void 0 ? o : [];
       for (const o of s) {
-        const s = e.get(o, "COMPONENT");
+        const s = t.get(o, "COMPONENT");
         if (!s) throw Error(`Plugin ${o} load error.`);
         if (!m.isFunction(s.run)) throw Error(`Plugin ${o} must implements interface 'IPlugin'.`);
-        if (t.config[o] === !1) {
+        if (e.config[o] === !1) {
           L.Warn(`Plugin ${o} already loaded but not effective.`);
           continue;
         }
-        await s.run((a = t.config[o]) !== null && a !== void 0 ? a : {}, this.app);
+        await s.run((a = e.config[o]) !== null && a !== void 0 ? a : {}, this.app);
       }
     }
   }
@@ -442,78 +441,78 @@ class Loader {
  * @LastEditTime: 2025-01-14 16:11:21
  * @License: BSD (3-Clause)
  * @Copyright (c): <richenlin(at)gmail.com>
- */ function K(t) {
+ */ function K(e) {
   return function(o) {
     if (!(o.prototype instanceof g)) throw new Error(`class does not inherit from Koatty`);
-    e.saveClass("COMPONENT", o, "KOATTY_APP");
-    I(o, t);
+    t.saveClass("COMPONENT", o, "KOATTY_APP");
+    I(o, e);
     return o;
   };
 }
 
-function N(t) {
-  return async e => {
-    if (!(e.prototype instanceof g)) throw new Error(`class ${e.name} does not inherit from Koatty`);
-    return await I(e, t, !0);
+function N(e) {
+  return async t => {
+    if (!(t.prototype instanceof g)) throw new Error(`class ${t.name} does not inherit from Koatty`);
+    return await I(t, e, !0);
   };
 }
 
-function D(t) {
+function D(e) {
   return a => {
     if (!(a.prototype instanceof g)) throw new Error(`class does not inherit from Koatty`);
-    t = t !== null && t !== void 0 ? t : "";
-    e.saveClassMetadata(o, _, t, a);
+    e = e !== null && e !== void 0 ? e : "";
+    t.saveClassMetadata(o, _, e, a);
   };
 }
 
-function S(t) {
+function S(e) {
   return a => {
     if (!(a.prototype instanceof g)) throw new Error(`class does not inherit from Koatty`);
-    t = t !== null && t !== void 0 ? t : "";
-    e.saveClassMetadata(o, A, t, a);
+    e = e !== null && e !== void 0 ? e : "";
+    t.saveClassMetadata(o, A, e, a);
   };
 }
 
-const I = async function(t, o, a = !1) {
+const I = async function(e, o, a = !1) {
   if (process.env.NODE_DEBUG) {
-    const t = process.env.NODE_DEBUG.split(",").filter(t => !t.includes("winston")).join(",");
-    process.env.NODE_DEBUG = t;
+    const e = process.env.NODE_DEBUG.split(",").filter(e => !e.includes("winston")).join(",");
+    process.env.NODE_DEBUG = e;
   }
   O();
   const s = T();
   if (!a && s) return;
-  const n = Reflect.construct(t, []);
+  const n = Reflect.construct(e, []);
   if (s) {
     n.silent = !0;
     L.enable(!1);
   }
   try {
     if (!n.silent) console.log($);
-    if (!(n instanceof g)) throw new Error(`class ${t.name} does not inherit from Koatty`);
+    if (!(n instanceof g)) throw new Error(`class ${e.name} does not inherit from Koatty`);
     Loader.initialize(n);
     if (m.isFunction(o)) {
       L.Log("Koatty", "", "Execute bootFunc ...");
       await o(n);
     }
-    e.setApp(n);
+    t.setApp(n);
     L.Log("Koatty", "", "ComponentScan ...");
-    Loader.CheckAllComponents(n, t);
-    await Loader.LoadAllComponents(n, t);
+    Loader.CheckAllComponents(n, e);
+    await Loader.LoadAllComponents(n, e);
     if (!s) n.listen(R);
     return n;
-  } catch (t) {
-    L.Fatal(t);
+  } catch (e) {
+    L.Fatal(e);
   }
 };
 
-const R = t => {
+const R = e => {
   L.Log("Koatty", "", "====================================");
   L.Log("Koatty", "", `Nodejs Version: ${process.version}`);
   L.Log("Koatty", "", `Koatty Version: v${b}`);
-  L.Log("Koatty", "", `App Environment: ${t.env}`);
-  if (t.appDebug) L.Warn(`Running in debug mode.`);
+  L.Log("Koatty", "", `App Environment: ${e.env}`);
+  if (e.appDebug) L.Warn(`Running in debug mode.`);
   L.Log("Koatty", "", "====================================");
-  n(t, a.appStart);
+  n(e, a.appStart);
 };
 
 export { K as Bootstrap, D as ComponentScan, S as ConfigurationScan, N as ExecBootStrap, L as Logger };

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koatty",
-  "version": "4.1.0",
+  "version": "4.1.2",
   "description": "Koa + Typescript = koatty. Use Typescript's decorator implement auto injection.",
   "scripts": {
     "build": "npm run build:js && npm run build:dts && npm run build:doc && npm run build:cp",
@@ -91,8 +91,8 @@
     "koatty_loader": "^1.1.4",
     "koatty_logger": "^2.4.0",
     "koatty_router": "^2.1.0",
-    "koatty_serve": "^3.1.0",
-    "koatty_trace": "^2.1.0",
+    "koatty_serve": "^3.1.1",
+    "koatty_trace": "^2.1.1",
     "ts-morph": "^27.0.2"
   }
 }

package/examples/basic-app/package.json

@@ -11,8 +11,11 @@
   ],
   "author": "richenlin",
   "license": "BSD-3-Clause",
+  "scripts": {
+    "dev": "node --nolazy -r ts-node/register ./src/App.ts"
+  },
   "devDependencies": {
-    "@types/node": "^24.9.1",
+    "@types/node": "^25.1.0",
     "ts-node": "^10.x.x",
     "tsconfig-paths": "^4.x.x",
     "typescript": "^5.x.x"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koatty",
-  "version": "4.1.0",
+  "version": "4.1.2",
   "description": "Koa + Typescript = koatty. Use Typescript's decorator implement auto injection.",
   "main": "./dist/index.js",
   "exports": {
@@ -75,15 +75,15 @@
     "koa": "^3.1.1",
     "ts-morph": "^27.0.2",
     "koatty_config": "1.2.9",
-    "koatty_core": "2.1.0",
+    "koatty_container": "2.0.0",
     "koatty_exception": "2.1.0",
+    "koatty_core": "2.1.0",
     "koatty_lib": "1.4.5",
     "koatty_logger": "2.4.0",
-    "koatty_loader": "1.1.4",
-    "koatty_serve": "3.1.0",
-    "koatty_trace": "2.1.0",
     "koatty_router": "2.1.0",
-    "koatty_container": "2.0.0"
+    "koatty_trace": "2.1.1",
+    "koatty_serve": "3.1.1",
+    "koatty_loader": "1.1.4"
   },
   "scripts": {
     "build": "npm run build:js && npm run build:dts && npm run build:doc && npm run build:cp",