@pangza/core 1.1.5 → 1.1.7

package/dist/Application/filters.d.ts

@@ -0,0 +1,67 @@
+import "reflect-metadata";
+import type { Request, RequestHandler, Response } from "express";
+export declare const WEB_FILTER_KEY: unique symbol;
+/**
+ * Filter 链（对齐 Servlet FilterChain）。
+ * `await chain.doFilter(req, res)` 会跑完后续 Filter + 路由并等到响应结束。
+ */
+export interface FilterChain {
+    doFilter(req: Request, res: Response): Promise<void>;
+}
+/**
+ * Servlet 风格 Filter：在 Dispatcher（路由）之外包裹请求。
+ *
+ * @example
+ * class TimingFilter implements Filter {
+ *   async doFilter(req, res, chain) {
+ *     const t = Date.now();
+ *     await chain.doFilter(req, res);
+ *     console.log(req.path, Date.now() - t);
+ *   }
+ * }
+ */
+export interface Filter {
+    doFilter(req: Request, res: Response, chain: FilterChain): void | Promise<void>;
+}
+/** @WebFilter / addFilter 注册选项（对齐 FilterRegistrationBean） */
+export interface FilterOptions {
+    /** 越小越靠前，默认 0 */
+    order?: number;
+    /** 生效路径，默认 `["/**"]` */
+    urlPatterns?: string[];
+    /** 排除路径 */
+    excludePatterns?: string[];
+}
+export interface FilterRegistration {
+    filter: Filter;
+    order: number;
+    urlPatterns: string[];
+    excludePatterns: string[];
+}
+export declare function isFilter(bean: unknown): bean is Filter;
+export declare function addFilterRegistration(filter: Filter, options?: FilterOptions): void;
+export declare function getFilterRegistrations(): readonly FilterRegistration[];
+export declare function clearFilters(): void;
+export declare function isFiltersMounted(): boolean;
+export declare function markFiltersMounted(): void;
+/** 按 order 升序得到注册表副本 */
+export declare function sortedFilterRegistrations(): FilterRegistration[];
+/**
+ * 将单个 Filter 转为 Express 中间件。
+ * `await chain.doFilter()` 在响应 `finish`/`close` 后 resolve，便于写 after 逻辑。
+ */
+export declare function createFilterMiddleware(reg: FilterRegistration): RequestHandler;
+/**
+ * 类装饰器：标记 Servlet 风格 Filter（类加载时自动注册）。
+ *
+ * @example
+ * @WebFilter({ urlPatterns: ["/api/**"], order: 1 })
+ * class TimingFilter implements Filter {
+ *   async doFilter(req, res, chain) {
+ *     await chain.doFilter(req, res);
+ *   }
+ * }
+ */
+export declare function WebFilter(options?: FilterOptions): ClassDecorator;
+export declare function getWebFilterOptions(ctor: Function): FilterOptions;
+//# sourceMappingURL=filters.d.ts.map

package/dist/Application/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/Application/filters.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAgB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG/E,eAAO,MAAM,cAAc,eAAyC,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CACN,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,WAAW,GACjB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW;IACX,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAKD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAMtD;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,aAAkB,GAC1B,IAAI,CASN;AAED,wBAAgB,sBAAsB,IAAI,SAAS,kBAAkB,EAAE,CAEtE;AAED,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAwB;AACxB,wBAAgB,yBAAyB,IAAI,kBAAkB,EAAE,CAEhE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,kBAAkB,GACtB,cAAc,CAuChB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,cAAc,CASrE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,CAEjE"}

package/dist/Application/filters.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEB_FILTER_KEY = void 0;
+exports.isFilter = isFilter;
+exports.addFilterRegistration = addFilterRegistration;
+exports.getFilterRegistrations = getFilterRegistrations;
+exports.clearFilters = clearFilters;
+exports.isFiltersMounted = isFiltersMounted;
+exports.markFiltersMounted = markFiltersMounted;
+exports.sortedFilterRegistrations = sortedFilterRegistrations;
+exports.createFilterMiddleware = createFilterMiddleware;
+exports.WebFilter = WebFilter;
+exports.getWebFilterOptions = getWebFilterOptions;
+require("reflect-metadata");
+const pathMatch_1 = require("./pathMatch");
+exports.WEB_FILTER_KEY = Symbol.for("pangza.webFilter.options");
+const registrations = [];
+let filtersMounted = false;
+function isFilter(bean) {
+    return (!!bean &&
+        typeof bean === "object" &&
+        typeof bean.doFilter === "function");
+}
+function addFilterRegistration(filter, options = {}) {
+    registrations.push({
+        filter,
+        order: options.order ?? 0,
+        urlPatterns: options.urlPatterns?.length
+            ? options.urlPatterns
+            : ["/**"],
+        excludePatterns: options.excludePatterns ?? [],
+    });
+}
+function getFilterRegistrations() {
+    return registrations;
+}
+function clearFilters() {
+    registrations.length = 0;
+    filtersMounted = false;
+}
+function isFiltersMounted() {
+    return filtersMounted;
+}
+function markFiltersMounted() {
+    filtersMounted = true;
+}
+/** 按 order 升序得到注册表副本 */
+function sortedFilterRegistrations() {
+    return [...registrations].sort((a, b) => a.order - b.order);
+}
+/**
+ * 将单个 Filter 转为 Express 中间件。
+ * `await chain.doFilter()` 在响应 `finish`/`close` 后 resolve，便于写 after 逻辑。
+ */
+function createFilterMiddleware(reg) {
+    return (req, res, next) => {
+        if (!(0, pathMatch_1.matchPathPatterns)(req.path, reg.urlPatterns, reg.excludePatterns)) {
+            next();
+            return;
+        }
+        const chain = {
+            doFilter: (_r = req, s = res) => new Promise((resolve, reject) => {
+                let settled = false;
+                const finish = () => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    resolve();
+                };
+                s.once("finish", finish);
+                s.once("close", finish);
+                next((err) => {
+                    if (err) {
+                        s.removeListener("finish", finish);
+                        s.removeListener("close", finish);
+                        reject(err);
+                        return;
+                    }
+                    // 下游已同步结束响应时尽快放开 after；否则等 finish
+                    if (s.writableEnded) {
+                        finish();
+                    }
+                });
+            }),
+        };
+        Promise.resolve(reg.filter.doFilter(req, res, chain)).catch((err) => {
+            next(err);
+        });
+    };
+}
+/**
+ * 类装饰器：标记 Servlet 风格 Filter（类加载时自动注册）。
+ *
+ * @example
+ * @WebFilter({ urlPatterns: ["/api/**"], order: 1 })
+ * class TimingFilter implements Filter {
+ *   async doFilter(req, res, chain) {
+ *     await chain.doFilter(req, res);
+ *   }
+ * }
+ */
+function WebFilter(options = {}) {
+    return (ctor) => {
+        const Ctor = ctor;
+        Reflect.defineMetadata(exports.WEB_FILTER_KEY, options, Ctor);
+        const { default: Application } = require("./index");
+        Application.registerFilter(Ctor);
+    };
+}
+function getWebFilterOptions(ctor) {
+    return Reflect.getMetadata(exports.WEB_FILTER_KEY, ctor) ?? {};
+}
+//# sourceMappingURL=filters.js.map

package/dist/Application/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../src/Application/filters.ts"],"names":[],"mappings":"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"}

package/dist/Application/index.d.ts

@@ -1,7 +1,8 @@
 import express from 'express';
 import type { RouteOption } from './types';
 import { ParamType } from './types';
-import { type RequestInterceptor, type ResponseInterceptor } from './interceptors';
+import { type RequestInterceptor, type ResponseInterceptor, type HandlerInterceptor, type InterceptorOptions } from './interceptors';
+import { type Filter, type FilterOptions } from './filters';
 export declare function applicationStart(): import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
 export declare class Application {
     private static routerMounted;
@@ -16,6 +17,9 @@ export declare class Application {
     private static ormRegistered;
     /** 已注册过的 Controller，防止重复挂路由 */
     private static registeredControllers;
+    /** 已注册过的 Filter / Interceptor 类 */
+    private static registeredFilters;
+    private static registeredInterceptors;
     /** 已 require 过的模块文件 */
     private static loadedFiles;
     /**
@@ -51,14 +55,43 @@ export declare class Application {
      * });
      */
     static addResponseInterceptor(fn: ResponseInterceptor): typeof Application;
-    /** 清空全部请求/响应拦截器 */
+    /**
+     * 注册 Servlet 风格 Filter（实例或类）。
+     * start() 时按 order 挂到路由之前；也可用 `@WebFilter()`。
+     *
+     * @example
+     * Application.addFilter(new TimingFilter(), { urlPatterns: ["/api/**"], order: 1 });
+     */
+    static addFilter(filter: Filter | (new () => Filter), options?: FilterOptions): typeof Application;
+    /**
+     * 注册 Spring MVC 风格 HandlerInterceptor（实例或类）。
+     * 也可用 `@Interceptor()`。
+     *
+     * @example
+     * Application.addInterceptor(new LogInterceptor(), { include: ["/api/**"] });
+     */
+    static addInterceptor(interceptor: HandlerInterceptor | (new () => HandlerInterceptor), options?: InterceptorOptions): typeof Application;
+    /** 装饰器 / 扫描：注册 Filter 类 */
+    static registerFilter(Ctor: new () => object, options?: FilterOptions): typeof Application;
+    /** 装饰器 / 扫描：注册 HandlerInterceptor 类 */
+    static registerInterceptor(Ctor: new () => object, options?: InterceptorOptions): typeof Application;
+    /**
+     * 将已注册 Filter 按 order 挂到 Express（路由之前）。
+     * start() 会自动调用；一般无需手动。
+     */
+    static mountFilters(): typeof Application;
+    /** 清空函数式请求/响应拦截器与 HandlerInterceptor 注册 */
     static clearInterceptors(): typeof Application;
+    /** 清空 Filter 注册（需在 start / mountFilters 之前） */
+    static clearFilters(): typeof Application;
     /**
      * 追加模块扫描目录（可多次调用）。
      * 目录内带 @Controller 的类会被自动注册进路由。
+     * 推荐 `.scan(__dirname)`：ts-node 跑 src 时扫源码，`node dist/main.js` 时扫编译产物。
      *
      * @example
      * Application
+     *   .scan(__dirname)
      *   .scan('src/business')
      *   .scan('src/modules', 'src/plugins')
      *   .registry(...).start();
@@ -84,7 +117,7 @@ export declare class Application {
     static getScanRoots(): string[];
     /**
      * 启动服务：
-     * 自动 loadControllers → routes → listen
+     * 自动 loadControllers → mountFilters → routes → listen
      * 使用者通常只需 registry(...).start()
      */
     static start(): typeof Application;
@@ -144,9 +177,14 @@ export declare class Application {
 export default Application;
 export { ParamType };
 export type { RouteOption, ApplicationInit, ApplicationDestroy } from './types';
-export type { RequestInterceptor, ResponseInterceptor, RequestInterceptorContext, ResponseInterceptorContext, } from './interceptors';
+export type { RequestInterceptor, ResponseInterceptor, RequestInterceptorContext, ResponseInterceptorContext, HandlerInterceptor, HandlerInfo, InterceptorOptions, } from './interceptors';
+export { Interceptor } from './interceptors';
+export type { Filter, FilterChain, FilterOptions, } from './filters';
+export { WebFilter } from './filters';
+export type { MethodInvocation, MethodInvocationContext, AroundAdvice, BeforeAdvice, AfterAdvice, AfterReturningAdvice, AfterThrowingAdvice, AdviceOptions, } from './aop';
+export { Around, Before, After, AfterReturning, AfterThrowing, createAroundDecorator, createBeforeDecorator, createAfterDecorator, createAfterReturningDecorator, createAfterThrowingDecorator, markAdvice, registerAroundAdvice, createMarkDecorator, getMethodInvocationContext, getMethodAdvices, } from './aop';
 export { runApplicationInits, runApplicationDestroys, hookProcessDestroy, isApplicationInit, isApplicationDestroy, } from './lifecycle';
-export { Controller, GetMapping, PostMapping, PutMapping, DeleteMapping, AuthCheckLogin, AuthCheckRole, AuthCheckPermission, AuthIgnore, Log, Flux, RequestBody, RequestQuery, RequestPath, RequestHeader, RequestCookie, Value, } from "./decorators";
+export { Controller, GetMapping, PostMapping, PutMapping, DeleteMapping, AuthCheckLogin, AuthCheckRole, AuthCheckPermission, AuthIgnore, Log, Flux, RequestBody, RequestQuery, RequestPath, RequestHeader, RequestCookie, RequestForm, Value, } from "./decorators";
 export { Container } from "./container";
 export type { Ctor } from "./container";
 export { Component, Resource, Service, Inject, } from "./iocDecorators";

package/dist/Application/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Application/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Application/index.ts"],"names":[],"mappings":"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"}

package/dist/Application/index.js

@@ -36,7 +36,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAPPER_DELEGATE_METHODS = exports.BaseService = exports.registerBeansFromComponent = exports.getBeanMethods = exports.Bean = exports.Inject = exports.Service = exports.Resource = exports.Component = exports.Container = exports.Value = exports.RequestCookie = exports.RequestHeader = exports.RequestPath = exports.RequestQuery = exports.RequestBody = exports.Flux = exports.Log = exports.AuthIgnore = exports.AuthCheckPermission = exports.AuthCheckRole = exports.AuthCheckLogin = exports.DeleteMapping = exports.PutMapping = exports.PostMapping = exports.GetMapping = exports.Controller = exports.isApplicationDestroy = exports.isApplicationInit = exports.hookProcessDestroy = exports.runApplicationDestroys = exports.runApplicationInits = exports.ParamType = exports.Application = void 0;
+exports.registerBeansFromComponent = exports.getBeanMethods = exports.Bean = exports.Inject = exports.Service = exports.Resource = exports.Component = exports.Container = exports.Value = exports.RequestForm = exports.RequestCookie = exports.RequestHeader = exports.RequestPath = exports.RequestQuery = exports.RequestBody = exports.Flux = exports.Log = exports.AuthIgnore = exports.AuthCheckPermission = exports.AuthCheckRole = exports.AuthCheckLogin = exports.DeleteMapping = exports.PutMapping = exports.PostMapping = exports.GetMapping = exports.Controller = exports.isApplicationDestroy = exports.isApplicationInit = exports.hookProcessDestroy = exports.runApplicationDestroys = exports.runApplicationInits = exports.getMethodAdvices = exports.getMethodInvocationContext = exports.createMarkDecorator = exports.registerAroundAdvice = exports.markAdvice = exports.createAfterThrowingDecorator = exports.createAfterReturningDecorator = exports.createAfterDecorator = exports.createBeforeDecorator = exports.createAroundDecorator = exports.AfterThrowing = exports.AfterReturning = exports.After = exports.Before = exports.Around = exports.WebFilter = exports.Interceptor = exports.ParamType = exports.Application = void 0;
+exports.MAPPER_DELEGATE_METHODS = exports.BaseService = void 0;
 exports.applicationStart = applicationStart;
 const express_1 = __importStar(require("express"));
 const fs_1 = __importDefault(require("fs"));
@@ -56,6 +57,8 @@ const lifecycle_1 = require("./lifecycle");
 const processGuards_1 = require("./processGuards");
 const warmup_1 = require("./warmup");
 const interceptors_1 = require("./interceptors");
+const filters_1 = require("./filters");
+const aop_1 = require("./aop");
 /** 可选分包：未安装时鉴权/审计/限流/ORM 相关能力降级跳过 */
 function validateMod() {
     return (0, optional_1.optionalRequire)('@pangza/validate');
@@ -176,17 +179,98 @@ class Application {
         (0, interceptors_1.addResponseInterceptor)(fn);
         return this;
     }
-    /** 清空全部请求/响应拦截器 */
+    /**
+     * 注册 Servlet 风格 Filter（实例或类）。
+     * start() 时按 order 挂到路由之前；也可用 `@WebFilter()`。
+     *
+     * @example
+     * Application.addFilter(new TimingFilter(), { urlPatterns: ["/api/**"], order: 1 });
+     */
+    static addFilter(filter, options) {
+        if (typeof filter === "function") {
+            return this.registerFilter(filter, options);
+        }
+        (0, filters_1.addFilterRegistration)(filter, options);
+        return this;
+    }
+    /**
+     * 注册 Spring MVC 风格 HandlerInterceptor（实例或类）。
+     * 也可用 `@Interceptor()`。
+     *
+     * @example
+     * Application.addInterceptor(new LogInterceptor(), { include: ["/api/**"] });
+     */
+    static addInterceptor(interceptor, options) {
+        if (typeof interceptor === "function") {
+            return this.registerInterceptor(interceptor, options);
+        }
+        (0, interceptors_1.addInterceptorRegistration)(interceptor, options);
+        return this;
+    }
+    /** 装饰器 / 扫描：注册 Filter 类 */
+    static registerFilter(Ctor, options) {
+        if (this.registeredFilters.has(Ctor)) {
+            return this;
+        }
+        this.registeredFilters.add(Ctor);
+        const { Container } = require("./container");
+        Container.bindClass(Ctor);
+        const instance = Container.get(Ctor);
+        if (!(0, filters_1.isFilter)(instance)) {
+            throw new Error(`[Application] ${Ctor.name} 需实现 Filter.doFilter`);
+        }
+        (0, filters_1.addFilterRegistration)(instance, options ?? (0, filters_1.getWebFilterOptions)(Ctor));
+        return this;
+    }
+    /** 装饰器 / 扫描：注册 HandlerInterceptor 类 */
+    static registerInterceptor(Ctor, options) {
+        if (this.registeredInterceptors.has(Ctor)) {
+            return this;
+        }
+        this.registeredInterceptors.add(Ctor);
+        const { Container } = require("./container");
+        Container.bindClass(Ctor);
+        const instance = Container.get(Ctor);
+        if (!(0, interceptors_1.isHandlerInterceptor)(instance)) {
+            throw new Error(`[Application] ${Ctor.name} 需实现 HandlerInterceptor 的 preHandle / postHandle / afterCompletion 之一`);
+        }
+        (0, interceptors_1.addInterceptorRegistration)(instance, options ?? (0, interceptors_1.getHandlerInterceptorOptions)(Ctor));
+        return this;
+    }
+    /**
+     * 将已注册 Filter 按 order 挂到 Express（路由之前）。
+     * start() 会自动调用；一般无需手动。
+     */
+    static mountFilters() {
+        if ((0, filters_1.isFiltersMounted)()) {
+            return this;
+        }
+        for (const reg of (0, filters_1.sortedFilterRegistrations)()) {
+            app.use((0, filters_1.createFilterMiddleware)(reg));
+        }
+        (0, filters_1.markFiltersMounted)();
+        return this;
+    }
+    /** 清空函数式请求/响应拦截器与 HandlerInterceptor 注册 */
     static clearInterceptors() {
         (0, interceptors_1.clearInterceptors)();
+        this.registeredInterceptors = new WeakSet();
+        return this;
+    }
+    /** 清空 Filter 注册（需在 start / mountFilters 之前） */
+    static clearFilters() {
+        (0, filters_1.clearFilters)();
+        this.registeredFilters = new WeakSet();
         return this;
     }
     /**
      * 追加模块扫描目录（可多次调用）。
      * 目录内带 @Controller 的类会被自动注册进路由。
+     * 推荐 `.scan(__dirname)`：ts-node 跑 src 时扫源码，`node dist/main.js` 时扫编译产物。
      *
      * @example
      * Application
+     *   .scan(__dirname)
      *   .scan('src/business')
      *   .scan('src/modules', 'src/plugins')
      *   .registry(...).start();
@@ -253,7 +337,7 @@ class Application {
     }
     /**
      * 启动服务：
-     * 自动 loadControllers → routes → listen
+     * 自动 loadControllers → mountFilters → routes → listen
      * 使用者通常只需 registry(...).start()
      */
     static start() {
@@ -261,6 +345,7 @@ class Application {
         if (!this.controllersLoaded) {
             this.loadControllers();
         }
+        this.mountFilters();
         this.routes();
         applicationStart();
         return this;
@@ -386,6 +471,10 @@ class Application {
             "entity",
             "mapper",
             "service",
+            "filter",
+            "filters",
+            "interceptor",
+            "interceptors",
             "controller",
             "controllers",
             "advice",
@@ -407,6 +496,12 @@ class Application {
         if (!fs_1.default.existsSync(dir)) {
             return;
         }
+        // 无 ts-node/tsx 等 hook 时，require(.ts) 会 SyntaxError；只加载可执行的 JS
+        const canRequireTs = Boolean(require
+            .extensions?.[".ts"]);
+        const entryFile = require.main?.filename
+            ? path_1.default.normalize(require.main.filename)
+            : "";
         for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
             const full = path_1.default.join(dir, entry.name);
             if (entry.isDirectory()) {
@@ -422,7 +517,21 @@ class Application {
                 entry.name.endsWith(".map")) {
                 continue;
             }
+            // 打包运行时不要 require 源码；同名优先 .js（避免 src 与产物混扫）
+            if (/\.(ts|mts|cts)$/.test(entry.name)) {
+                if (!canRequireTs) {
+                    continue;
+                }
+                const jsSibling = full.replace(/\.(mts|cts|ts)$/, ".js");
+                if (fs_1.default.existsSync(jsSibling)) {
+                    continue;
+                }
+            }
             const resolved = path_1.default.normalize(full);
+            // 跳过入口自身，避免 scan(dist) 时二次执行 main 导致 Application already started
+            if (entryFile && resolved === entryFile) {
+                continue;
+            }
             if (this.loadedFiles.has(resolved)) {
                 continue;
             }
@@ -568,13 +677,34 @@ class Application {
             const startTime = Date.now();
             let result;
             let error;
+            const meta = option;
+            const handler = {
+                path,
+                method: method.toUpperCase(),
+                controllerName: meta?.__controllerName,
+                handlerName: meta?.__handlerName,
+                option,
+            };
             try {
                 await this.applyRouteAuth(option, req);
                 await this.applyRouteGuards(option, req);
+                const preOk = await (0, interceptors_1.runHandlerPreHandle)(req, response, handler);
+                if (!preOk || response.headersSent) {
+                    return;
+                }
                 const reqCtx = await (0, interceptors_1.runRequestInterceptors)(req, response, option);
                 if (response.headersSent) {
                     return;
                 }
+                const invocationCtx = {
+                    req,
+                    res: response,
+                    option,
+                    path,
+                    httpMethod: method.toUpperCase(),
+                    controllerName: meta?.__controllerName,
+                    handlerName: meta?.__handlerName,
+                };
                 if (option?.flux || option?.raw) {
                     if (reqCtx.skipHandler) {
                         return;
@@ -588,7 +718,7 @@ class Application {
                         if (vm)
                             await vm(args, option.paramTypes ?? []);
                     }
-                    await callback(...args);
+                    await (0, aop_1.runWithMethodInvocationContext)(invocationCtx, () => callback(...args));
                 }
                 else {
                     if (!reqCtx.skipHandler) {
@@ -598,12 +728,17 @@ class Application {
                             if (vm)
                                 await vm(args, option.paramTypes ?? []);
                         }
-                        result = await callback(...args);
+                        result = await (0, aop_1.runWithMethodInvocationContext)(invocationCtx, () => callback(...args));
                     }
                     else {
                         result = reqCtx.data;
                     }
-                    const serialized = Json_1.ObjectMapper.writeValue(result);
+                    let serialized = Json_1.ObjectMapper.writeValue(result);
+                    serialized = await (0, interceptors_1.runHandlerPostHandle)(req, response, handler, serialized);
+                    if (response.headersSent) {
+                        result = serialized;
+                        return;
+                    }
                     const resCtx = await (0, interceptors_1.runResponseInterceptors)({
                         req,
                         res: response,
@@ -628,6 +763,7 @@ class Application {
                 await (0, Exception_1.handleException)(req, response, e);
             }
             finally {
+                await (0, interceptors_1.runHandlerAfterCompletion)(req, response, handler, error);
                 this.scheduleOperationLog(req, option, {
                     result: error ? undefined : result,
                     error,
@@ -663,6 +799,9 @@ Application.redisRegistered = false;
 Application.ormRegistered = false;
 /** 已注册过的 Controller，防止重复挂路由 */
 Application.registeredControllers = new WeakSet();
+/** 已注册过的 Filter / Interceptor 类 */
+Application.registeredFilters = new WeakSet();
+Application.registeredInterceptors = new WeakSet();
 /** 已 require 过的模块文件 */
 Application.loadedFiles = new Set();
 /**
@@ -671,6 +810,26 @@ Application.loadedFiles = new Set();
  */
 Application.scanRoots = [];
 exports.default = Application;
+var interceptors_2 = require("./interceptors");
+Object.defineProperty(exports, "Interceptor", { enumerable: true, get: function () { return interceptors_2.Interceptor; } });
+var filters_2 = require("./filters");
+Object.defineProperty(exports, "WebFilter", { enumerable: true, get: function () { return filters_2.WebFilter; } });
+var aop_2 = require("./aop");
+Object.defineProperty(exports, "Around", { enumerable: true, get: function () { return aop_2.Around; } });
+Object.defineProperty(exports, "Before", { enumerable: true, get: function () { return aop_2.Before; } });
+Object.defineProperty(exports, "After", { enumerable: true, get: function () { return aop_2.After; } });
+Object.defineProperty(exports, "AfterReturning", { enumerable: true, get: function () { return aop_2.AfterReturning; } });
+Object.defineProperty(exports, "AfterThrowing", { enumerable: true, get: function () { return aop_2.AfterThrowing; } });
+Object.defineProperty(exports, "createAroundDecorator", { enumerable: true, get: function () { return aop_2.createAroundDecorator; } });
+Object.defineProperty(exports, "createBeforeDecorator", { enumerable: true, get: function () { return aop_2.createBeforeDecorator; } });
+Object.defineProperty(exports, "createAfterDecorator", { enumerable: true, get: function () { return aop_2.createAfterDecorator; } });
+Object.defineProperty(exports, "createAfterReturningDecorator", { enumerable: true, get: function () { return aop_2.createAfterReturningDecorator; } });
+Object.defineProperty(exports, "createAfterThrowingDecorator", { enumerable: true, get: function () { return aop_2.createAfterThrowingDecorator; } });
+Object.defineProperty(exports, "markAdvice", { enumerable: true, get: function () { return aop_2.markAdvice; } });
+Object.defineProperty(exports, "registerAroundAdvice", { enumerable: true, get: function () { return aop_2.registerAroundAdvice; } });
+Object.defineProperty(exports, "createMarkDecorator", { enumerable: true, get: function () { return aop_2.createMarkDecorator; } });
+Object.defineProperty(exports, "getMethodInvocationContext", { enumerable: true, get: function () { return aop_2.getMethodInvocationContext; } });
+Object.defineProperty(exports, "getMethodAdvices", { enumerable: true, get: function () { return aop_2.getMethodAdvices; } });
 var lifecycle_2 = require("./lifecycle");
 Object.defineProperty(exports, "runApplicationInits", { enumerable: true, get: function () { return lifecycle_2.runApplicationInits; } });
 Object.defineProperty(exports, "runApplicationDestroys", { enumerable: true, get: function () { return lifecycle_2.runApplicationDestroys; } });
@@ -694,6 +853,7 @@ Object.defineProperty(exports, "RequestQuery", { enumerable: true, get: function
 Object.defineProperty(exports, "RequestPath", { enumerable: true, get: function () { return decorators_1.RequestPath; } });
 Object.defineProperty(exports, "RequestHeader", { enumerable: true, get: function () { return decorators_1.RequestHeader; } });
 Object.defineProperty(exports, "RequestCookie", { enumerable: true, get: function () { return decorators_1.RequestCookie; } });
+Object.defineProperty(exports, "RequestForm", { enumerable: true, get: function () { return decorators_1.RequestForm; } });
 Object.defineProperty(exports, "Value", { enumerable: true, get: function () { return decorators_1.Value; } });
 var container_1 = require("./container");
 Object.defineProperty(exports, "Container", { enumerable: true, get: function () { return container_1.Container; } });