@pangza/core 1.1.6 → 1.1.7

package/README.md

@@ -1,3 +1,3 @@
-# @pangza/core
-
-Application / IoC / Logger / config / Json / Validate / Exception
+# @pangza/core
+
+Application / IoC / Logger / config / Json / Validate / Exception

package/dist/Application/aop.d.ts

@@ -0,0 +1,91 @@
+import "reflect-metadata";
+import type { Request, Response } from "express";
+import type { RouteOption } from "./types";
+/** 当前 HTTP 调用上下文（Controller 管线内由 mountRoute 注入） */
+export interface MethodInvocationContext {
+    req?: Request;
+    res?: Response;
+    option?: RouteOption;
+    /** 路由路径（若有） */
+    path?: string;
+    /** HTTP 方法（若有） */
+    httpMethod?: string;
+    controllerName?: string;
+    handlerName?: string;
+}
+/**
+ * 方法调用连接点（对齐 Spring ProceedingJoinPoint）。
+ * - 修改 `args` 可影响后续 Advice / 原方法
+ * - 必须调用 `proceed()`（或自行短路返回）才会继续链
+ */
+export interface MethodInvocation {
+    target: object;
+    methodName: string;
+    args: unknown[];
+    /** HTTP 场景下有值；纯 Service 调用可能为空 */
+    context?: MethodInvocationContext;
+    proceed: () => Promise<unknown>;
+}
+/** Around：完整包裹；order 越小越靠外（优先级越高，对齐 Spring Ordered） */
+export type AroundAdvice = (invocation: MethodInvocation) => unknown | Promise<unknown>;
+export type BeforeAdvice = (invocation: Omit<MethodInvocation, "proceed">) => void | Promise<void>;
+export type AfterReturningAdvice = (invocation: Omit<MethodInvocation, "proceed">, result: unknown) => unknown | void | Promise<unknown | void>;
+export type AfterThrowingAdvice = (invocation: Omit<MethodInvocation, "proceed">, error: unknown) => void | Promise<void>;
+export type AfterAdvice = (invocation: Omit<MethodInvocation, "proceed">, error?: unknown) => void | Promise<void>;
+export interface AdviceOptions {
+    /** 越小越靠外，默认 0 */
+    order?: number;
+}
+interface AdviceEntry {
+    kind: "around" | "before" | "afterReturning" | "afterThrowing" | "after";
+    order: number;
+    around?: AroundAdvice;
+    before?: BeforeAdvice;
+    afterReturning?: AfterReturningAdvice;
+    afterThrowing?: AfterThrowingAdvice;
+    after?: AfterAdvice;
+}
+/** 读取当前请求管线注入的调用上下文（非 HTTP 调用则为 undefined） */
+export declare function getMethodInvocationContext(): MethodInvocationContext | undefined;
+/** 供 Application.mountRoute 包裹业务回调 */
+export declare function runWithMethodInvocationContext<T>(ctx: MethodInvocationContext, fn: () => T | Promise<T>): T | Promise<T>;
+export declare function getMethodAdvices(ctor: Function, methodName: string): readonly AdviceEntry[];
+/**
+ * 将元数据中的 Before/After* 折成 Around，再按 order 串链执行。
+ */
+export declare function runAdviceChain(original: (...args: unknown[]) => unknown, target: object, methodName: string, args: unknown[], entries: readonly AdviceEntry[], context?: MethodInvocationContext): Promise<unknown>;
+/**
+ * 创建 Around 装饰器（自定义注解的推荐入口）。
+ *
+ * @example
+ * export const Audit = (title: string) =>
+ *   createAroundDecorator(async (inv) => {
+ *     console.log("audit", title, inv.methodName, inv.context?.req?.path);
+ *     return inv.proceed();
+ *   }, { order: 100 });
+ *
+ * // 使用
+ * @PostMapping("/save")
+ * @Audit("保存用户")
+ * save(@RequestBody() body: User) { ... }
+ */
+export declare function createAroundDecorator(advice: AroundAdvice, options?: AdviceOptions): MethodDecorator;
+/** 直接使用的 Around 方法装饰器 */
+export declare function Around(advice: AroundAdvice, options?: AdviceOptions): MethodDecorator;
+export declare function createBeforeDecorator(advice: BeforeAdvice, options?: AdviceOptions): MethodDecorator;
+export declare function Before(advice: BeforeAdvice, options?: AdviceOptions): MethodDecorator;
+export declare function createAfterReturningDecorator(advice: AfterReturningAdvice, options?: AdviceOptions): MethodDecorator;
+export declare function AfterReturning(advice: AfterReturningAdvice, options?: AdviceOptions): MethodDecorator;
+export declare function createAfterThrowingDecorator(advice: AfterThrowingAdvice, options?: AdviceOptions): MethodDecorator;
+export declare function AfterThrowing(advice: AfterThrowingAdvice, options?: AdviceOptions): MethodDecorator;
+export declare function createAfterDecorator(advice: AfterAdvice, options?: AdviceOptions): MethodDecorator;
+export declare function After(advice: AfterAdvice, options?: AdviceOptions): MethodDecorator;
+export declare function markAdvice(key: string | symbol): MethodDecorator;
+/**
+ * 为 `markAdvice(key)` 注册切面（可在标记之前或之后调用）。
+ */
+export declare function registerAroundAdvice(key: string | symbol, advice: AroundAdvice, options?: AdviceOptions): void;
+/** 创建「标记装饰器」：等价于固定 key 的 markAdvice */
+export declare function createMarkDecorator(key: string | symbol): () => MethodDecorator;
+export {};
+//# sourceMappingURL=aop.d.ts.map

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

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

package/dist/Application/aop.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMethodInvocationContext = getMethodInvocationContext;
+exports.runWithMethodInvocationContext = runWithMethodInvocationContext;
+exports.getMethodAdvices = getMethodAdvices;
+exports.runAdviceChain = runAdviceChain;
+exports.createAroundDecorator = createAroundDecorator;
+exports.Around = Around;
+exports.createBeforeDecorator = createBeforeDecorator;
+exports.Before = Before;
+exports.createAfterReturningDecorator = createAfterReturningDecorator;
+exports.AfterReturning = AfterReturning;
+exports.createAfterThrowingDecorator = createAfterThrowingDecorator;
+exports.AfterThrowing = AfterThrowing;
+exports.createAfterDecorator = createAfterDecorator;
+exports.After = After;
+exports.markAdvice = markAdvice;
+exports.registerAroundAdvice = registerAroundAdvice;
+exports.createMarkDecorator = createMarkDecorator;
+require("reflect-metadata");
+const node_async_hooks_1 = require("node:async_hooks");
+const METHOD_ADVICES_KEY = Symbol.for("pangza.aop.methodAdvices");
+const ADVISED_FLAG = Symbol.for("pangza.aop.advised");
+const invocationAls = new node_async_hooks_1.AsyncLocalStorage();
+/** 读取当前请求管线注入的调用上下文（非 HTTP 调用则为 undefined） */
+function getMethodInvocationContext() {
+    return invocationAls.getStore();
+}
+/** 供 Application.mountRoute 包裹业务回调 */
+function runWithMethodInvocationContext(ctx, fn) {
+    return invocationAls.run(ctx, fn);
+}
+function getAdviceMap(ctor) {
+    return (Reflect.getMetadata(METHOD_ADVICES_KEY, ctor) ?? {});
+}
+function setAdviceMap(ctor, map) {
+    Reflect.defineMetadata(METHOD_ADVICES_KEY, map, ctor);
+}
+function addAdvice(ctor, methodName, entry) {
+    const map = { ...getAdviceMap(ctor) };
+    const list = map[methodName] ? [...map[methodName]] : [];
+    list.push(entry);
+    map[methodName] = list;
+    setAdviceMap(ctor, map);
+}
+function getMethodAdvices(ctor, methodName) {
+    return getAdviceMap(ctor)[methodName] ?? [];
+}
+function sortEntries(entries) {
+    return [...entries].sort((a, b) => a.order - b.order);
+}
+/**
+ * 将元数据中的 Before/After* 折成 Around，再按 order 串链执行。
+ */
+async function runAdviceChain(original, target, methodName, args, entries, context) {
+    if (!entries.length) {
+        return original.apply(target, args);
+    }
+    const sorted = sortEntries(entries);
+    const aroundList = sorted.map((e) => toAround(e));
+    let index = 0;
+    const invocation = {
+        target,
+        methodName,
+        args,
+        context: context ?? getMethodInvocationContext(),
+        proceed: async () => {
+            if (index < aroundList.length) {
+                const advice = aroundList[index++];
+                return advice(invocation);
+            }
+            return original.apply(target, invocation.args);
+        },
+    };
+    return invocation.proceed();
+}
+function toAround(entry) {
+    if (entry.kind === "around" && entry.around) {
+        return entry.around;
+    }
+    if (entry.kind === "before" && entry.before) {
+        const before = entry.before;
+        return async (inv) => {
+            await before(inv);
+            return inv.proceed();
+        };
+    }
+    if (entry.kind === "afterReturning" && entry.afterReturning) {
+        const afterReturning = entry.afterReturning;
+        return async (inv) => {
+            const result = await inv.proceed();
+            const out = await afterReturning(inv, result);
+            return out === undefined ? result : out;
+        };
+    }
+    if (entry.kind === "afterThrowing" && entry.afterThrowing) {
+        const afterThrowing = entry.afterThrowing;
+        return async (inv) => {
+            try {
+                return await inv.proceed();
+            }
+            catch (err) {
+                await afterThrowing(inv, err);
+                throw err;
+            }
+        };
+    }
+    if (entry.kind === "after" && entry.after) {
+        const after = entry.after;
+        return async (inv) => {
+            let error;
+            try {
+                return await inv.proceed();
+            }
+            catch (err) {
+                error = err;
+                throw err;
+            }
+            finally {
+                await after(inv, error);
+            }
+        };
+    }
+    return (inv) => inv.proceed();
+}
+function ensureAdvised(target, propertyKey, descriptor) {
+    const original = descriptor.value;
+    if (typeof original !== "function")
+        return;
+    if (original[ADVISED_FLAG]) {
+        return;
+    }
+    const methodName = String(propertyKey);
+    const advised = async function (...args) {
+        const ctor = this.constructor;
+        const entries = resolveMethodAdviceEntries(ctor, methodName);
+        return runAdviceChain(original, this, methodName, args, entries, getMethodInvocationContext());
+    };
+    advised[ADVISED_FLAG] = true;
+    descriptor.value = advised;
+}
+function createAdviceDecorator(entry) {
+    return (target, propertyKey, descriptor) => {
+        if (!descriptor || typeof descriptor.value !== "function") {
+            return descriptor;
+        }
+        const ctor = target.constructor;
+        addAdvice(ctor, String(propertyKey), {
+            ...entry,
+            order: entry.order ?? 0,
+        });
+        ensureAdvised(target, propertyKey, descriptor);
+        return descriptor;
+    };
+}
+/**
+ * 创建 Around 装饰器（自定义注解的推荐入口）。
+ *
+ * @example
+ * export const Audit = (title: string) =>
+ *   createAroundDecorator(async (inv) => {
+ *     console.log("audit", title, inv.methodName, inv.context?.req?.path);
+ *     return inv.proceed();
+ *   }, { order: 100 });
+ *
+ * // 使用
+ * @PostMapping("/save")
+ * @Audit("保存用户")
+ * save(@RequestBody() body: User) { ... }
+ */
+function createAroundDecorator(advice, options = {}) {
+    return createAdviceDecorator({
+        kind: "around",
+        around: advice,
+        order: options.order,
+    });
+}
+/** 直接使用的 Around 方法装饰器 */
+function Around(advice, options = {}) {
+    return createAroundDecorator(advice, options);
+}
+function createBeforeDecorator(advice, options = {}) {
+    return createAdviceDecorator({
+        kind: "before",
+        before: advice,
+        order: options.order,
+    });
+}
+function Before(advice, options = {}) {
+    return createBeforeDecorator(advice, options);
+}
+function createAfterReturningDecorator(advice, options = {}) {
+    return createAdviceDecorator({
+        kind: "afterReturning",
+        afterReturning: advice,
+        order: options.order,
+    });
+}
+function AfterReturning(advice, options = {}) {
+    return createAfterReturningDecorator(advice, options);
+}
+function createAfterThrowingDecorator(advice, options = {}) {
+    return createAdviceDecorator({
+        kind: "afterThrowing",
+        afterThrowing: advice,
+        order: options.order,
+    });
+}
+function AfterThrowing(advice, options = {}) {
+    return createAfterThrowingDecorator(advice, options);
+}
+function createAfterDecorator(advice, options = {}) {
+    return createAdviceDecorator({
+        kind: "after",
+        after: advice,
+        order: options.order,
+    });
+}
+function After(advice, options = {}) {
+    return createAfterDecorator(advice, options);
+}
+/**
+ * 按「注解标记」注册全局 Around：先用 `markAdvice(key)` 标方法，再 `registerAroundAdvice(key, fn)`。
+ * 更接近 Spring `@Around("@annotation(...)")`；注册与标记顺序无关（运行时合并）。
+ */
+const MARKER_ADVICES = new Map();
+const METHOD_MARKERS_KEY = Symbol.for("pangza.aop.methodMarkers");
+function getMethodMarkers(ctor, methodName) {
+    const map = Reflect.getMetadata(METHOD_MARKERS_KEY, ctor) ?? {};
+    return map[methodName] ?? [];
+}
+/** 本地 Advice + marker 全局 Advice */
+function resolveMethodAdviceEntries(ctor, methodName) {
+    const local = [...getMethodAdvices(ctor, methodName)];
+    for (const key of getMethodMarkers(ctor, methodName)) {
+        const reg = MARKER_ADVICES.get(key);
+        if (!reg)
+            continue;
+        local.push({
+            kind: "around",
+            around: reg.advice,
+            order: reg.order,
+        });
+    }
+    return local;
+}
+function markAdvice(key) {
+    return (target, propertyKey, descriptor) => {
+        if (!descriptor || typeof descriptor.value !== "function") {
+            return descriptor;
+        }
+        const ctor = target.constructor;
+        const methodName = String(propertyKey);
+        const map = Reflect.getMetadata(METHOD_MARKERS_KEY, ctor) ?? {};
+        const list = map[methodName] ? [...map[methodName]] : [];
+        if (!list.includes(key))
+            list.push(key);
+        map[methodName] = list;
+        Reflect.defineMetadata(METHOD_MARKERS_KEY, map, ctor);
+        ensureAdvised(target, propertyKey, descriptor);
+        return descriptor;
+    };
+}
+/**
+ * 为 `markAdvice(key)` 注册切面（可在标记之前或之后调用）。
+ */
+function registerAroundAdvice(key, advice, options = {}) {
+    MARKER_ADVICES.set(key, { advice, order: options.order ?? 0 });
+}
+/** 创建「标记装饰器」：等价于固定 key 的 markAdvice */
+function createMarkDecorator(key) {
+    return () => markAdvice(key);
+}
+//# sourceMappingURL=aop.js.map

package/dist/Application/aop.js.map

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

package/dist/Application/callbackArgs.js

@@ -55,6 +55,22 @@ function resolveRawCallbackArgs(req, res, option, arity = 2) {
     }
     return args;
 }
+/** urlencoded / multipart 字段在 req.body；multer 等会挂 file(s) */
+function resolveFormData(req, fieldName) {
+    const body = req.body && typeof req.body === "object" ? req.body : {};
+    if (fieldName !== undefined) {
+        return body[fieldName];
+    }
+    const anyReq = req;
+    if (anyReq.file !== undefined || anyReq.files !== undefined) {
+        return {
+            ...body,
+            ...(anyReq.file !== undefined ? { file: anyReq.file } : {}),
+            ...(anyReq.files !== undefined ? { files: anyReq.files } : {}),
+        };
+    }
+    return body;
+}
 function resolveParamInject(req, meta) {
     switch (meta.source) {
         case "body":
@@ -65,6 +81,8 @@ function resolveParamInject(req, meta) {
             return req.headers ?? {};
         case "cookie":
             return req.cookies ?? {};
+        case "form":
+            return resolveFormData(req, meta.name);
         case "path": {
             const values = Object.values(req.params ?? {});
             if (meta.pathIndex !== undefined) {
@@ -92,6 +110,8 @@ function resolveCallbackArg(req, option) {
             return req.headers ?? {};
         case types_1.ParamType.COOKIE:
             return req.cookies ?? {};
+        case types_1.ParamType.FORM:
+            return resolveFormData(req);
         case types_1.ParamType.PATH:
         case types_1.ParamType.PARAMS: {
             const values = Object.values(req.params ?? {});

package/dist/Application/callbackArgs.js.map

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

package/dist/Application/decorators.d.ts

@@ -62,6 +62,21 @@ export declare function RequestPath(index?: number): ParameterDecorator;
 export declare function RequestHeader(): ParameterDecorator;
 /** 注入 req.cookies（需自行挂 cookie 解析中间件） */
 export declare function RequestCookie(): ParameterDecorator;
+/**
+ * 注入表单数据（urlencoded / multipart 字段，落在 req.body）。
+ * 需先 `registry(urlencoded({ extended: true }))`；multipart 文件需自行挂 multer 等。
+ *
+ * - `@RequestForm()`：整个表单对象；若存在 `req.file` / `req.files` 一并附上
+ * - `@RequestForm("name")`：单个字段
+ *
+ * @example
+ * @PostMapping("/login")
+ * login(@RequestForm() form: { username: string; password: string }) {}
+ *
+ * @PostMapping("/upload")
+ * upload(@RequestForm("title") title: string) {}
+ */
+export declare function RequestForm(name?: string): ParameterDecorator;
 /**
  * 属性注入：从合并后的 application*.yaml 按路径取值。
  * 支持 `server.port`、`${server.port}`、`${server.port:3990}`；

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

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/Application/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgBnD,8BAA8B;AAC9B,eAAO,MAAM,eAAe,eAAuC,CAAC;AAEpE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAK,GAAG,cAAc,CAWtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEzD;AAgBD,6CAA6C;AAC7C,eAAO,MAAM,UAAU,2BAdO,WAAW,KAAG,eAcQ,CAAC;AAErD,+CAA+C;AAC/C,eAAO,MAAM,WAAW,2BAjBM,WAAW,KAAG,eAiBU,CAAC;AAEvD,6CAA6C;AAC7C,eAAO,MAAM,UAAU,2BApBO,WAAW,KAAG,eAoBQ,CAAC;AAErD,mDAAmD;AACnD,eAAO,MAAM,aAAa,2BAvBI,WAAW,KAAG,eAuBc,CAAC;AAE3D,wBAAgB,cAAc,IAAI,eAAe,CAIhD;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,aAAa,CAAA;CAAE,GAChC,eAAe,CAOjB;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,aAAa,CAAA;CAAE,GAChC,eAAe,CAOjB;AAED,wBAAgB,UAAU,IAAI,eAAe,CAM5C;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,MAAM,GAAE,eAAoB,GAAG,eAAe,CAIjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,IAAI,eAAe,CAItC;AAED,sCAAsC;AACtC,wBAAgB,WAAW,IAAI,kBAAkB,CAQhD;AAED,mBAAmB;AACnB,wBAAgB,YAAY,IAAI,kBAAkB,CAQjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAS9D;AAED,wBAAwB;AACxB,wBAAgB,aAAa,IAAI,kBAAkB,CAQlD;AAED,wCAAwC;AACxC,wBAAgB,aAAa,IAAI,kBAAkB,CAQlD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CACnB,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,OAAO,GACrB,iBAAiB,CAuCnB;AAED,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/Application/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgBnD,8BAA8B;AAC9B,eAAO,MAAM,eAAe,eAAuC,CAAC;AAEpE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAK,GAAG,cAAc,CAWtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEzD;AAgBD,6CAA6C;AAC7C,eAAO,MAAM,UAAU,2BAdO,WAAW,KAAG,eAcQ,CAAC;AAErD,+CAA+C;AAC/C,eAAO,MAAM,WAAW,2BAjBM,WAAW,KAAG,eAiBU,CAAC;AAEvD,6CAA6C;AAC7C,eAAO,MAAM,UAAU,2BApBO,WAAW,KAAG,eAoBQ,CAAC;AAErD,mDAAmD;AACnD,eAAO,MAAM,aAAa,2BAvBI,WAAW,KAAG,eAuBc,CAAC;AAE3D,wBAAgB,cAAc,IAAI,eAAe,CAIhD;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,aAAa,CAAA;CAAE,GAChC,eAAe,CAOjB;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,aAAa,CAAA;CAAE,GAChC,eAAe,CAOjB;AAED,wBAAgB,UAAU,IAAI,eAAe,CAM5C;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,MAAM,GAAE,eAAoB,GAAG,eAAe,CAIjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,IAAI,eAAe,CAItC;AAED,sCAAsC;AACtC,wBAAgB,WAAW,IAAI,kBAAkB,CAQhD;AAED,mBAAmB;AACnB,wBAAgB,YAAY,IAAI,kBAAkB,CAQjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAS9D;AAED,wBAAwB;AACxB,wBAAgB,aAAa,IAAI,kBAAkB,CAQlD;AAED,wCAAwC;AACxC,wBAAgB,aAAa,IAAI,kBAAkB,CAQlD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAS7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CACnB,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,OAAO,GACrB,iBAAiB,CAuCnB;AAED,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/Application/decorators.js

@@ -14,6 +14,7 @@ exports.RequestQuery = RequestQuery;
 exports.RequestPath = RequestPath;
 exports.RequestHeader = RequestHeader;
 exports.RequestCookie = RequestCookie;
+exports.RequestForm = RequestForm;
 exports.Value = Value;
 require("reflect-metadata");
 const config_1 = require("../config");
@@ -176,6 +177,31 @@ function RequestCookie() {
         });
     };
 }
+/**
+ * 注入表单数据（urlencoded / multipart 字段，落在 req.body）。
+ * 需先 `registry(urlencoded({ extended: true }))`；multipart 文件需自行挂 multer 等。
+ *
+ * - `@RequestForm()`：整个表单对象；若存在 `req.file` / `req.files` 一并附上
+ * - `@RequestForm("name")`：单个字段
+ *
+ * @example
+ * @PostMapping("/login")
+ * login(@RequestForm() form: { username: string; password: string }) {}
+ *
+ * @PostMapping("/upload")
+ * upload(@RequestForm("title") title: string) {}
+ */
+function RequestForm(name) {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey === undefined)
+            return;
+        (0, metadata_1.addMethodParam)(target.constructor, String(propertyKey), {
+            index: parameterIndex,
+            source: "form",
+            name,
+        });
+    };
+}
 /**
  * 属性注入：从合并后的 application*.yaml 按路径取值。
  * 支持 `server.port`、`${server.port}`、`${server.port:3990}`；

package/dist/Application/decorators.js.map

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

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"}