@dangao/bun-server 1.2.0 → 1.3.0

package/dist/controller/decorators.d.ts

@@ -8,7 +8,9 @@ export declare enum ParamType {
     PARAM = "param",
     HEADER = "header",
     SESSION = "session",
-    CONTEXT = "context"
+    CONTEXT = "context",
+    QUERY_MAP = "query_map",
+    HEADER_MAP = "header_map"
 }
 /**
  * 参数元数据
@@ -17,6 +19,7 @@ export interface ParamMetadata {
     type: ParamType;
     key?: string;
     index: number;
+    options?: unknown;
 }
 /**
  * 参数装饰器工厂
@@ -45,6 +48,32 @@ export declare function Param(key: string): (target: any, propertyKey: string |
  * @param key - 请求头键
  */
 export declare function Header(key: string): (target: any, propertyKey: string | symbol | undefined, parameterIndex: number) => void;
+/**
+ * QueryMap 注解选项
+ */
+export interface QueryMapOptions<T = unknown> {
+    transform?: (input: Record<string, string | string[]>) => T | Promise<T>;
+    validate?: (dto: T) => void | Promise<void>;
+}
+/**
+ * HeaderMap 注解选项
+ */
+export interface HeaderMapOptions<T = unknown> {
+    normalize?: boolean;
+    pick?: string[];
+    transform?: (input: Record<string, string | string[]>) => T | Promise<T>;
+    validate?: (dto: T) => void | Promise<void>;
+}
+/**
+ * QueryMap 参数装饰器
+ * 一次性注入完整查询对象
+ */
+export declare function QueryMap<T = Record<string, string | string[]>>(options?: QueryMapOptions<T> | ((input: Record<string, string | string[]>) => T | Promise<T>)): (target: any, propertyKey: string | symbol | undefined, parameterIndex: number) => void;
+/**
+ * HeaderMap 参数装饰器
+ * 一次性注入完整 headers 对象
+ */
+export declare function HeaderMap<T = Record<string, string | string[]>>(options?: HeaderMapOptions<T> | ((input: Record<string, string | string[]>) => T | Promise<T>)): (target: any, propertyKey: string | symbol | undefined, parameterIndex: number) => void;
 /**
  * Context 参数装饰器
  * 用于在控制器方法中注入当前请求的 Context 对象

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

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/controller/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAO1B;;GAEG;AACH,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,IAC/C,QAAQ,GAAG,EAAE,aAAa,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,gBAAgB,MAAM,UAM/F;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,YAZN,GAAG,eAAe,MAAM,GAAG,MAAM,GAAG,SAAS,kBAAkB,MAAM,UAc/F;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,YApBN,GAAG,eAAe,MAAM,GAAG,MAAM,GAAG,SAAS,kBAAkB,MAAM,UAsB/F;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,YA5BN,GAAG,eAAe,MAAM,GAAG,MAAM,GAAG,SAAS,kBAAkB,MAAM,UA8B/F;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,YApCP,GAAG,eAAe,MAAM,GAAG,MAAM,GAAG,SAAS,kBAAkB,MAAM,UAsC/F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,aAtDI,GAAG,eAAe,MAAM,GAAG,MAAM,GAAG,SAAS,kBAAkB,MAAM,UAwD/F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CAElF"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/controller/decorators.ts"],"names":[],"mappings":"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"}

package/dist/controller/index.d.ts

@@ -1,5 +1,5 @@
-export { Body, Query, Param, Header, Context, getParamMetadata, ParamType } from './decorators';
-export type { ParamMetadata } from './decorators';
+export { Body, Query, QueryMap, Param, Header, HeaderMap, Context, getParamMetadata, ParamType, } from './decorators';
+export type { ParamMetadata, QueryMapOptions, HeaderMapOptions, } from './decorators';
 export { ParamBinder } from './param-binder';
 export { Controller, ControllerRegistry } from './controller';
 export type { ControllerMetadata } from './controller';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/controller/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAChG,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/controller/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,KAAK,EACL,MAAM,EACN,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,aAAa,EACb,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/controller/param-binder.d.ts

@@ -50,5 +50,17 @@ export declare class ParamBinder {
      * @returns Header 值
      */
     private static getHeaderValue;
+    /**
+     * 获取 QueryMap 值
+     * @param options - 装饰器选项
+     * @param context - 请求上下文
+     */
+    private static getQueryMapValue;
+    /**
+     * 获取 HeaderMap 值
+     * @param options - 装饰器选项
+     * @param context - 请求上下文
+     */
+    private static getHeaderMapValue;
 }
 //# sourceMappingURL=param-binder.d.ts.map

package/dist/controller/param-binder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"param-binder.d.ts","sourceRoot":"","sources":["../../src/controller/param-binder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK5C;;;GAGG;AACH,qBAAa,WAAW;IACtB;;;;;;;OAOG;WACiB,IAAI,CACtB,MAAM,EAAE,GAAG,EACX,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC;IAyBrB;;;;;;OAMG;mBACkB,QAAQ;IAwD7B;;;;;OAKG;mBACkB,YAAY;IAWjC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAI5B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAI5B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;CAG9B"}
+{"version":3,"file":"param-binder.d.ts","sourceRoot":"","sources":["../../src/controller/param-binder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAQ/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK5C;;;GAGG;AACH,qBAAa,WAAW;IACtB;;;;;;;OAOG;WACiB,IAAI,CACtB,MAAM,EAAE,GAAG,EACX,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC;IAyBrB;;;;;;OAMG;mBACkB,QAAQ;IA4D7B;;;;;OAKG;mBACkB,YAAY;IAWjC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAI5B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAI5B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B;;;;OAIG;mBACkB,gBAAgB;IA0BrC;;;;OAIG;mBACkB,iBAAiB;CAuCvC"}

package/dist/index.d.ts

@@ -6,9 +6,9 @@ export { Route, Router, RouteRegistry } from './router';
 export { GET, POST, PUT, DELETE, PATCH } from './router/decorators';
 export type { HttpMethod, RouteHandler, RouteMatch } from './router/types';
 export { BodyParser, RequestWrapper, ResponseBuilder } from './request';
-export { Body, Query, Param, Header, ParamBinder, Controller, ControllerRegistry } from './controller';
+export { Body, Query, QueryMap, Param, Header, HeaderMap, ParamBinder, Controller, ControllerRegistry, } from './controller';
 export { Context as ContextParam } from './controller';
-export type { ParamMetadata, ControllerMetadata } from './controller';
+export type { ParamMetadata, QueryMapOptions, HeaderMapOptions, ControllerMetadata, } from './controller';
 export { Container } from './di/container';
 export { Injectable, Inject } from './di/decorators';
 export { Lifecycle, type ProviderConfig, type DependencyMetadata } from './di/types';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1478,6 +1478,22 @@ function Param(key) {
 function Header(key) {
   return createParamDecorator("header" /* HEADER */, key);
 }
+function QueryMap(options) {
+  return function(target, propertyKey, parameterIndex) {
+    const existingParams = Reflect.getMetadata(PARAM_METADATA_KEY, target, propertyKey) || [];
+    const normalizedOptions = typeof options === "function" ? { transform: options } : options ?? {};
+    existingParams.push({ type: "query_map" /* QUERY_MAP */, index: parameterIndex, options: normalizedOptions });
+    Reflect.defineMetadata(PARAM_METADATA_KEY, existingParams, target, propertyKey);
+  };
+}
+function HeaderMap(options) {
+  return function(target, propertyKey, parameterIndex) {
+    const existingParams = Reflect.getMetadata(PARAM_METADATA_KEY, target, propertyKey) || [];
+    const normalizedOptions = typeof options === "function" ? { transform: options } : options ?? {};
+    existingParams.push({ type: "header_map" /* HEADER_MAP */, index: parameterIndex, options: normalizedOptions });
+    Reflect.defineMetadata(PARAM_METADATA_KEY, existingParams, target, propertyKey);
+  };
+}
 function Context2() {
   return createParamDecorator("context" /* CONTEXT */);
 }
@@ -1690,6 +1706,10 @@ class ParamBinder {
         return;
       case "context" /* CONTEXT */:
         return contextStore.getStore() ?? context;
+      case "query_map" /* QUERY_MAP */:
+        return await this.getQueryMapValue(meta.options, context);
+      case "header_map" /* HEADER_MAP */:
+        return await this.getHeaderMapValue(meta.options, context);
       default:
         return;
     }
@@ -1713,6 +1733,52 @@ class ParamBinder {
   static getHeaderValue(key, context) {
     return context.getHeader(key);
   }
+  static async getQueryMapValue(options, context) {
+    const result = {};
+    const searchParams = context.query;
+    for (const key of searchParams.keys()) {
+      const values = searchParams.getAll(key);
+      if (values.length === 1) {
+        result[key] = values[0];
+      } else {
+        result[key] = values;
+      }
+    }
+    let output = result;
+    if (options?.transform) {
+      output = await options.transform(result);
+    }
+    if (options?.validate) {
+      await options.validate(output);
+    }
+    return output;
+  }
+  static async getHeaderMapValue(options, context) {
+    const normalize = options?.normalize ?? true;
+    const pick = options?.pick?.map((key) => key.toLowerCase());
+    const headers = context.headers;
+    const result = {};
+    headers.forEach((value, rawKey) => {
+      const key = normalize ? rawKey.toLowerCase() : rawKey;
+      if (pick && !pick.includes(key)) {
+        return;
+      }
+      const parts = value.split(",").map((item) => item.trim()).filter((item) => item.length > 0);
+      if (parts.length <= 1) {
+        result[key] = parts[0] ?? "";
+      } else {
+        result[key] = parts;
+      }
+    });
+    let output = result;
+    if (options?.transform) {
+      output = await options.transform(result);
+    }
+    if (options?.validate) {
+      await options.validate(output);
+    }
+    return output;
+  }
 }
 
 // src/controller/metadata.ts
@@ -6782,6 +6848,7 @@ export {
   QueueService,
   QueueModule,
   Queue,
+  QueryMap,
   Query,
   QUEUE_SERVICE_TOKEN,
   QUEUE_OPTIONS_TOKEN,
@@ -6842,6 +6909,7 @@ export {
   INTERCEPTOR_REGISTRY_TOKEN,
   HttpException,
   HealthModule,
+  HeaderMap,
   Header,
   HEALTH_OPTIONS_TOKEN,
   HEALTH_INDICATORS_TOKEN,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dangao/bun-server",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/controller/decorators.ts

@@ -15,6 +15,8 @@ export enum ParamType {
   HEADER = 'header',
   SESSION = 'session',
   CONTEXT = 'context',
+  QUERY_MAP = 'query_map',
+  HEADER_MAP = 'header_map',
 }
 
 /**
@@ -24,6 +26,7 @@ export interface ParamMetadata {
   type: ParamType;
   key?: string;
   index: number;
+  options?: unknown;
 }
 
 /**
@@ -73,6 +76,58 @@ export function Header(key: string) {
   return createParamDecorator(ParamType.HEADER, key);
 }
 
+/**
+ * QueryMap 注解选项
+ */
+export interface QueryMapOptions<T = unknown> {
+  transform?: (input: Record<string, string | string[]>) => T | Promise<T>;
+  validate?: (dto: T) => void | Promise<void>;
+}
+
+/**
+ * HeaderMap 注解选项
+ */
+export interface HeaderMapOptions<T = unknown> {
+  normalize?: boolean;
+  pick?: string[];
+  transform?: (input: Record<string, string | string[]>) => T | Promise<T>;
+  validate?: (dto: T) => void | Promise<void>;
+}
+
+/**
+ * QueryMap 参数装饰器
+ * 一次性注入完整查询对象
+ */
+export function QueryMap<T = Record<string, string | string[]>>(
+  options?: QueryMapOptions<T> | ((input: Record<string, string | string[]>) => T | Promise<T>),
+) {
+  return function (target: any, propertyKey: string | symbol | undefined, parameterIndex: number) {
+    const existingParams: ParamMetadata[] =
+      Reflect.getMetadata(PARAM_METADATA_KEY, target, propertyKey as string) || [];
+    const normalizedOptions: QueryMapOptions<T> =
+      typeof options === 'function' ? { transform: options } : options ?? {};
+    existingParams.push({ type: ParamType.QUERY_MAP, index: parameterIndex, options: normalizedOptions });
+    Reflect.defineMetadata(PARAM_METADATA_KEY, existingParams, target, propertyKey as string);
+  };
+}
+
+/**
+ * HeaderMap 参数装饰器
+ * 一次性注入完整 headers 对象
+ */
+export function HeaderMap<T = Record<string, string | string[]>>(
+  options?: HeaderMapOptions<T> | ((input: Record<string, string | string[]>) => T | Promise<T>),
+) {
+  return function (target: any, propertyKey: string | symbol | undefined, parameterIndex: number) {
+    const existingParams: ParamMetadata[] =
+      Reflect.getMetadata(PARAM_METADATA_KEY, target, propertyKey as string) || [];
+    const normalizedOptions: HeaderMapOptions<T> =
+      typeof options === 'function' ? { transform: options } : options ?? {};
+    existingParams.push({ type: ParamType.HEADER_MAP, index: parameterIndex, options: normalizedOptions });
+    Reflect.defineMetadata(PARAM_METADATA_KEY, existingParams, target, propertyKey as string);
+  };
+}
+
 /**
  * Context 参数装饰器
  * 用于在控制器方法中注入当前请求的 Context 对象

package/src/controller/index.ts

@@ -1,5 +1,19 @@
-export { Body, Query, Param, Header, Context, getParamMetadata, ParamType } from './decorators';
-export type { ParamMetadata } from './decorators';
+export {
+  Body,
+  Query,
+  QueryMap,
+  Param,
+  Header,
+  HeaderMap,
+  Context,
+  getParamMetadata,
+  ParamType,
+} from './decorators';
+export type {
+  ParamMetadata,
+  QueryMapOptions,
+  HeaderMapOptions,
+} from './decorators';
 export { ParamBinder } from './param-binder';
 export { Controller, ControllerRegistry } from './controller';
 export type { ControllerMetadata } from './controller';

package/src/controller/param-binder.ts

@@ -1,5 +1,11 @@
 import type { Context } from '../core/context';
-import { getParamMetadata, ParamType, type ParamMetadata } from './decorators';
+import {
+  getParamMetadata,
+  ParamType,
+  type ParamMetadata,
+  type QueryMapOptions,
+  type HeaderMapOptions,
+} from './decorators';
 import { Container } from '../di/container';
 import { SessionService } from '../session/service';
 import { SESSION_SERVICE_TOKEN } from '../session/types';
@@ -106,6 +112,10 @@ export class ParamBinder {
       case ParamType.CONTEXT:
         // 从 AsyncLocalStorage 获取当前请求的 Context
         return contextStore.getStore() ?? context;
+      case ParamType.QUERY_MAP:
+        return await this.getQueryMapValue(meta.options as QueryMapOptions, context);
+      case ParamType.HEADER_MAP:
+        return await this.getHeaderMapValue(meta.options as HeaderMapOptions, context);
       default:
         return undefined;
     }
@@ -157,5 +167,81 @@ export class ParamBinder {
   private static getHeaderValue(key: string, context: Context): string | null {
     return context.getHeader(key);
   }
+
+  /**
+   * 获取 QueryMap 值
+   * @param options - 装饰器选项
+   * @param context - 请求上下文
+   */
+  private static async getQueryMapValue(
+    options: QueryMapOptions | undefined,
+    context: Context,
+  ): Promise<unknown> {
+    const result: Record<string, string | string[]> = {};
+    const searchParams = context.query;
+    // 收集所有键，处理重复 key -> string[]
+    for (const key of searchParams.keys()) {
+      const values = searchParams.getAll(key);
+      if (values.length === 1) {
+        result[key] = values[0];
+      } else {
+        result[key] = values;
+      }
+    }
+
+    let output: unknown = result;
+    if (options?.transform) {
+      output = await options.transform(result);
+    }
+    if (options?.validate) {
+      await options.validate(output as never);
+    }
+    return output;
+  }
+
+  /**
+   * 获取 HeaderMap 值
+   * @param options - 装饰器选项
+   * @param context - 请求上下文
+   */
+  private static async getHeaderMapValue(
+    options: HeaderMapOptions | undefined,
+    context: Context,
+  ): Promise<unknown> {
+    const normalize = options?.normalize ?? true;
+    // Headers API 总是将 header 名称规范化为小写，所以 pick 数组也应该总是小写化
+    const pick = options?.pick?.map((key) => key.toLowerCase());
+    const headers = context.headers;
+    const result: Record<string, string | string[]> = {};
+
+    headers.forEach((value, rawKey) => {
+      // Headers API 总是返回小写的 key，所以 rawKey 已经是小写
+      // normalize 选项决定结果中的 key 格式（虽然实际上总是小写）
+      const key = normalize ? rawKey.toLowerCase() : rawKey;
+      if (pick && !pick.includes(key)) {
+        return;
+      }
+      // 处理可能的多值（逗号分隔），统一 trim
+      const parts = value
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+      if (parts.length <= 1) {
+        // 单值也保持 trim 后的形态
+        result[key] = parts[0] ?? '';
+      } else {
+        result[key] = parts;
+      }
+    });
+
+    let output: unknown = result;
+    if (options?.transform) {
+      output = await options.transform(result);
+    }
+    if (options?.validate) {
+      await options.validate(output as never);
+    }
+    return output;
+  }
 }
 

package/src/index.ts

@@ -6,9 +6,24 @@ export { Route, Router, RouteRegistry } from './router';
 export { GET, POST, PUT, DELETE, PATCH } from './router/decorators';
 export type { HttpMethod, RouteHandler, RouteMatch } from './router/types';
 export { BodyParser, RequestWrapper, ResponseBuilder } from './request';
-export { Body, Query, Param, Header, ParamBinder, Controller, ControllerRegistry } from './controller';
+export {
+  Body,
+  Query,
+  QueryMap,
+  Param,
+  Header,
+  HeaderMap,
+  ParamBinder,
+  Controller,
+  ControllerRegistry,
+} from './controller';
 export { Context as ContextParam } from './controller';
-export type { ParamMetadata, ControllerMetadata } from './controller';
+export type {
+  ParamMetadata,
+  QueryMapOptions,
+  HeaderMapOptions,
+  ControllerMetadata,
+} from './controller';
 export { Container } from './di/container';
 export { Injectable, Inject } from './di/decorators';
 export { Lifecycle, type ProviderConfig, type DependencyMetadata } from './di/types';

package/tests/controller/param-map.test.ts

@@ -0,0 +1,237 @@
+import { describe, expect, test } from 'bun:test';
+
+import { ParamBinder } from '../../src/controller/param-binder';
+import {
+  QueryMap,
+  HeaderMap,
+  type QueryMapOptions,
+  type HeaderMapOptions,
+} from '../../src/controller/decorators';
+import { Context } from '../../src/core/context';
+
+class QueryMapController {
+  public constructor(public readonly store: unknown[] = []) {}
+
+  public async handle(@QueryMap() query: Record<string, string | string[]>) {
+    this.store.push(query);
+    return query;
+  }
+
+  public async handleTransformed(
+    @QueryMap<{ name: string; age: number }>((input) => ({
+      name: (input.name as string) ?? '',
+      age: Number((input.age as string) ?? '0'),
+    }))
+    query: { name: string; age: number },
+  ) {
+    this.store.push(query);
+    return query;
+  }
+
+  public async handleValidated(
+    @QueryMap<{ foo: string }>(
+      ((input) => ({ foo: input.foo as string })) as QueryMapOptions<{ foo: string }>['transform'],
+    )
+    query: { foo: string },
+  ) {
+    if (!query.foo) {
+      throw new Error('validation failed');
+    }
+    this.store.push(query);
+    return query;
+  }
+}
+
+class HeaderMapController {
+  public constructor(public readonly store: unknown[] = []) {}
+
+  public async handle(
+    @HeaderMap() headers: Record<string, string | string[]>,
+  ) {
+    this.store.push(headers);
+    return headers;
+  }
+
+  public async handlePicked(
+    @HeaderMap({
+      normalize: true,
+      pick: ['x-custom', 'x-list'],
+    })
+    headers: Record<string, string | string[]>,
+  ) {
+    this.store.push(headers);
+    return headers;
+  }
+
+  public async handlePickedWithNormalizeFalse(
+    @HeaderMap({
+      normalize: false,
+      pick: ['X-Custom', 'X-List'], // 混合大小写
+    })
+    headers: Record<string, string | string[]>,
+  ) {
+    this.store.push(headers);
+    return headers;
+  }
+
+  public async handleTransformed(
+    @HeaderMap<{ token: string }>((input) => ({
+      token: (input.authorization as string) ?? '',
+    }))
+    headers: { token: string },
+  ) {
+    this.store.push(headers);
+    return headers;
+  }
+}
+
+function createContext(url: string, init?: RequestInit) {
+  return new Context(new Request(url, init));
+}
+
+describe('ParamBinder QueryMap', () => {
+  test('should aggregate query params into map with arrays', async () => {
+    const controller = new QueryMapController();
+    const ctx = createContext('http://localhost/api?q=1&q=2&name=alice');
+    const params = await ParamBinder.bind(
+      controller,
+      'handle',
+      ctx,
+    );
+    expect(params[0]).toEqual({ q: ['1', '2'], name: 'alice' });
+  });
+
+  test('should transform query map', async () => {
+    const controller = new QueryMapController();
+    const ctx = createContext('http://localhost/api?name=alice&age=20');
+    const params = await ParamBinder.bind(
+      controller,
+      'handleTransformed',
+      ctx,
+    );
+    expect(params[0]).toEqual({ name: 'alice', age: 20 });
+  });
+
+  test('should validate query map via user code', async () => {
+    const controller = new QueryMapController();
+    const ctx = createContext('http://localhost/api?foo=bar');
+    const params = await ParamBinder.bind(
+      controller,
+      'handleValidated',
+      ctx,
+    );
+    expect(params[0]).toEqual({ foo: 'bar' });
+  });
+});
+
+describe('ParamBinder HeaderMap', () => {
+  test('should aggregate headers into map with optional array', async () => {
+    const controller = new HeaderMapController();
+    const ctx = createContext('http://localhost/api', {
+      headers: {
+        'X-Token': 'abc',
+        'X-List': 'a, b',
+      },
+    });
+    const params = await ParamBinder.bind(
+      controller,
+      'handle',
+      ctx,
+    );
+    expect(params[0]).toMatchObject({
+      'x-token': 'abc',
+      'x-list': ['a', 'b'],
+    });
+  });
+
+  test('should pick and normalize headers', async () => {
+    const controller = new HeaderMapController();
+    const ctx = createContext('http://localhost/api', {
+      headers: {
+        'X-Custom': 'val',
+        'X-List': 'a, b',
+        'Other': 'ignore',
+      },
+    });
+    const params = await ParamBinder.bind(
+      controller,
+      'handlePicked',
+      ctx,
+    );
+    expect(params[0]).toEqual({
+      'x-custom': 'val',
+      'x-list': ['a', 'b'],
+    });
+  });
+
+  test('should pick headers with case-insensitive pick when normalize=true (default)', async () => {
+    const controller = new HeaderMapController();
+    const ctx = createContext('http://localhost/api', {
+      headers: {
+        'X-CUSTOM': 'val',
+        'X-LIST': 'a, b',
+        'Other': 'ignore',
+      },
+    });
+    const params = await ParamBinder.bind(
+      controller,
+      'handlePicked',
+      ctx,
+    );
+    expect(params[0]).toEqual({
+      'x-custom': 'val',
+      'x-list': ['a', 'b'],
+    });
+  });
+
+  test('should transform headers', async () => {
+    const controller = new HeaderMapController();
+    const ctx = createContext('http://localhost/api', {
+      headers: {
+        Authorization: '  Bearer token123  ',
+      },
+    });
+    const params = await ParamBinder.bind(
+      controller,
+      'handleTransformed',
+      ctx,
+    );
+    expect(params[0]).toEqual({ token: 'Bearer token123' });
+  });
+
+  test('should trim single header value when no comma', async () => {
+    const controller = new HeaderMapController();
+    const ctx = createContext('http://localhost/api', {
+      headers: {
+        'X-Single': '  abc  ',
+      },
+    });
+    const params = await ParamBinder.bind(controller, 'handle', ctx);
+    expect(params[0]).toMatchObject({
+      'x-single': 'abc',
+    });
+  });
+
+  test('should pick headers with mixed-case pick keys when normalize=false', async () => {
+    const controller = new HeaderMapController();
+    const ctx = createContext('http://localhost/api', {
+      headers: {
+        'X-Custom': 'val',
+        'X-List': 'a, b',
+        'Other': 'ignore',
+      },
+    });
+    const params = await ParamBinder.bind(
+      controller,
+      'handlePickedWithNormalizeFalse',
+      ctx,
+    );
+    // Headers API 总是返回小写的 key，所以即使 normalize=false，结果中的 key 也是小写
+    expect(params[0]).toEqual({
+      'x-custom': 'val',
+      'x-list': ['a', 'b'],
+    });
+  });
+});
+
+