@dangao/bun-server 3.2.0 → 3.3.0

package/src/interceptor/base-interceptor.ts

@@ -15,11 +15,11 @@ export abstract class BaseInterceptor implements Interceptor {
   public abstract execute<T>(
     target: unknown,
     propertyKey: string | symbol,
-    originalMethod: (...args: unknown[]) => T | Promise<T>,
-    args: unknown[],
+    originalMethod: (...args: any[]) => T | Promise<T>,
+    args: any[],
     container: Container,
     context?: Context,
-  ): Promise<T>;
+  ): Promise<any>;
 
   /**
    * 前置处理（可选）
@@ -33,7 +33,7 @@ export abstract class BaseInterceptor implements Interceptor {
   protected async before(
     target: unknown,
     propertyKey: string | symbol,
-    args: unknown[],
+    args: any[],
     container: Container,
     context?: Context,
   ): Promise<void> {
@@ -141,7 +141,7 @@ export abstract class BaseInterceptor implements Interceptor {
    */
   protected resolveService<T>(
     container: Container,
-    token: (new (...args: unknown[]) => T) | string | symbol,
+    token: (new (...args: any[]) => T) | string | symbol,
   ): T {
     return container.resolve<T>(token);
   }
@@ -200,4 +200,3 @@ export abstract class BaseInterceptor implements Interceptor {
     return context.getParam(paramName);
   }
 }
-

package/src/interceptor/builtin/log-interceptor.ts

@@ -84,8 +84,8 @@ export class LogInterceptor extends BaseInterceptor {
   public async execute<T>(
     target: unknown,
     propertyKey: string | symbol,
-    originalMethod: (...args: unknown[]) => T | Promise<T>,
-    args: unknown[],
+    originalMethod: (...args: any[]) => T | Promise<T>,
+    args: any[],
     container: Container,
     context?: Context,
   ): Promise<T> {
@@ -175,4 +175,3 @@ export class LogInterceptor extends BaseInterceptor {
     }
   }
 }
-

package/src/interceptor/builtin/permission-interceptor.ts

@@ -91,8 +91,8 @@ export class PermissionInterceptor extends BaseInterceptor {
   public async execute<T>(
     target: unknown,
     propertyKey: string | symbol,
-    originalMethod: (...args: unknown[]) => T | Promise<T>,
-    args: unknown[],
+    originalMethod: (...args: any[]) => T | Promise<T>,
+    args: any[],
     container: Container,
     context?: Context,
   ): Promise<T> {
@@ -170,4 +170,3 @@ export class PermissionInterceptor extends BaseInterceptor {
     return null;
   }
 }
-

package/src/interceptor/interceptor-chain.ts

@@ -22,8 +22,8 @@ export class InterceptorChain {
     interceptors: Interceptor[],
     target: unknown,
     propertyKey: string | symbol,
-    originalMethod: (...args: unknown[]) => T | Promise<T>,
-    args: unknown[],
+    originalMethod: (...args: any[]) => T | Promise<T>,
+    args: any[],
     container: Container,
     context?: Context,
   ): Promise<T> {
@@ -36,7 +36,7 @@ export class InterceptorChain {
     let index = 0;
     let currentArgs = args; // Track arguments that might be modified by interceptors
     
-    const next = async (modifiedArgs?: unknown[]): Promise<T> => {
+    const next = async (modifiedArgs?: any[]): Promise<T> => {
       // 如果拦截器传递了新参数，使用新参数；否则使用当前参数
       if (modifiedArgs && modifiedArgs.length > 0) {
         currentArgs = modifiedArgs;
@@ -50,11 +50,11 @@ export class InterceptorChain {
       const interceptor = interceptors[index++];
       
       // 执行当前拦截器，传递 next 作为下一个执行函数
-      // 注意：拦截器接口要求 originalMethod 的类型是 (...args: unknown[]) => T | Promise<T>
+      // 注意：拦截器接口要求 originalMethod 的类型是 (...args: any[]) => T | Promise<T>
       // 这允许原始方法可以是同步（返回 T）或异步（返回 Promise<T>）
       // 虽然 next 函数是异步的（总是返回 Promise<T>），但我们保持类型签名为 T | Promise<T>
       // 以符合拦截器接口的要求。拦截器应该使用 Promise.resolve() 来统一处理同步和异步返回值
-      const wrappedNext = (...nextArgs: unknown[]): T | Promise<T> => {
+      const wrappedNext = (...nextArgs: any[]): T | Promise<T> => {
         // 如果拦截器传递了新参数，传递给 next；否则传递 undefined（使用当前参数）
         // next 是异步函数，总是返回 Promise<T>，但类型签名允许 T | Promise<T>
         const result = next(nextArgs.length > 0 ? nextArgs : undefined);
@@ -70,10 +70,9 @@ export class InterceptorChain {
         currentArgs, // Pass current args to the interceptor
         container,
         context,
-      );
+      ) as T;
     };
 
     return await next();
   }
 }
-

package/src/interceptor/interceptor-registry.ts

@@ -22,8 +22,11 @@ export class InterceptorRegistry {
   public register(
     metadataKey: symbol,
     interceptor: Interceptor,
-    priority: number = 100,
+    priority: number | { priority?: number } = 100,
   ): void {
+    const resolvedPriority = typeof priority === 'number'
+      ? priority
+      : priority.priority ?? 100;
     if (!this.interceptors.has(metadataKey)) {
       this.interceptors.set(metadataKey, []);
     }
@@ -39,7 +42,7 @@ export class InterceptorRegistry {
       metadataList.push({
         metadataKey,
         interceptor,
-        priority,
+        priority: resolvedPriority,
       });
       
       // 按优先级排序（数字越小优先级越高）
@@ -129,4 +132,3 @@ export class InterceptorRegistry {
     return total;
   }
 }
-

package/src/interceptor/types.ts

@@ -6,6 +6,12 @@ import type { Context } from '../core/context';
  * 定义拦截器的核心执行方法
  */
 export interface Interceptor {
+  /**
+   * Optional priority used by registries/tests that carry interceptor metadata
+   * alongside the executable interceptor instance.
+   */
+  priority?: number;
+
   /**
    * 执行拦截器逻辑
    * @param target - 目标对象（控制器实例的原型）
@@ -19,11 +25,11 @@ export interface Interceptor {
   execute<T>(
     target: unknown,
     propertyKey: string | symbol,
-    originalMethod: (...args: unknown[]) => T | Promise<T>,
-    args: unknown[],
+    originalMethod: (...args: any[]) => T | Promise<T>,
+    args: any[],
     container: Container,
     context?: Context,
-  ): Promise<T>;
+  ): Promise<any>;
 }
 
 /**
@@ -49,4 +55,3 @@ export interface InterceptorMetadata {
  * 拦截器注册表 Token
  */
 export const INTERCEPTOR_REGISTRY_TOKEN = Symbol('@dangao/bun-server:interceptor-registry');
-

package/src/microservice/service-client/types.ts

@@ -1,4 +1,5 @@
 import type { ServiceInstance } from '../service-registry/types';
+export type { ServiceInstance } from '../service-registry/types';
 
 /**
  * 负载均衡策略类型
@@ -183,4 +184,3 @@ export class ServiceCallError extends Error {
     this.name = 'ServiceCallError';
   }
 }
-

package/src/microservice/tracing/tracer.ts

@@ -172,14 +172,27 @@ export class Tracer {
   /**
    * 添加 Span 事件
    */
-  public addSpanEvent(spanId: SpanId, event: Omit<SpanEvent, 'timestamp'>): void {
+  public addSpanEvent(
+    spanId: SpanId,
+    event: string,
+    attributes?: Record<string, string | number | boolean>,
+  ): void;
+  public addSpanEvent(spanId: SpanId, event: Omit<SpanEvent, 'timestamp'>): void;
+  public addSpanEvent(
+    spanId: SpanId,
+    event: string | Omit<SpanEvent, 'timestamp'>,
+    attributes?: Record<string, string | number | boolean>,
+  ): void {
     const span = this.activeSpans.get(spanId);
     if (span) {
       if (!span.events) {
         span.events = [];
       }
+      const spanEvent = typeof event === 'string'
+        ? { name: event, attributes }
+        : event;
       span.events.push({
-        ...event,
+        ...spanEvent,
         timestamp: Date.now(),
       });
     }
@@ -290,4 +303,3 @@ export class Tracer {
     this.activeSpans.clear();
   }
 }
-

package/src/middleware/builtin/file-upload.ts

@@ -3,13 +3,15 @@ import { FileHandler } from '../../request/file-handler';
 
 export interface FileUploadOptions {
   maxSize?: number;
+  maxFileSize?: number;
+  uploadDir?: string;
 }
 
 /**
  * 简单的文件上传中间件：解析 multipart/form-data 并将文件附加到 context.body
  */
 export function createFileUploadMiddleware(options: FileUploadOptions = {}): Middleware {
-  const maxSize = options.maxSize ?? 10 * 1024 * 1024;
+  const maxSize = options.maxSize ?? options.maxFileSize ?? 10 * 1024 * 1024;
 
   return async (context, next) => {
     const contentType = context.getHeader('Content-Type');
@@ -39,4 +41,3 @@ export function createFileUploadMiddleware(options: FileUploadOptions = {}): Mid
   };
 }
 
-

package/src/middleware/builtin/rate-limit.ts

@@ -88,7 +88,12 @@ export interface RateLimitOptions {
   /**
    * 时间窗口内的最大请求数
    */
-  max: number;
+  max?: number;
+
+  /**
+   * 时间窗口内的最大请求数别名，兼容装饰器早期写法。
+   */
+  limit?: number;
 
   /**
    * 时间窗口（毫秒）
@@ -108,6 +113,11 @@ export interface RateLimitOptions {
    */
   keyGenerator?: (context: Context) => string | Promise<string>;
 
+  /**
+   * 返回 true 时跳过限流。
+   */
+  skip?: (context: Context) => boolean | Promise<boolean>;
+
   /**
    * 是否跳过成功响应（只对错误响应计数）
    * @default false
@@ -157,9 +167,11 @@ function defaultKeyGenerator(context: Context): string {
 export function createRateLimitMiddleware(options: RateLimitOptions): Middleware {
   const {
     max,
+    limit,
     windowMs = 60000, // 默认 1 分钟
     store = new MemoryRateLimitStore(),
     keyGenerator = defaultKeyGenerator,
+    skip,
     skipSuccessfulRequests = false,
     skipFailedRequests = false,
     message = 'Too Many Requests',
@@ -167,31 +179,36 @@ export function createRateLimitMiddleware(options: RateLimitOptions): Middleware
     standardHeaders = true,
     legacyHeaders = true,
   } = options;
+  const requestLimit = limit ?? max ?? 100;
 
   return async (context: Context, next) => {
+    if (skip && await skip(context)) {
+      return await next();
+    }
+
     // 生成限流键
     const key = await keyGenerator(context);
     const currentCount = await store.increment(key, windowMs);
 
     // 计算剩余请求数和重置时间
-    const remaining = Math.max(0, max - currentCount);
+    const remaining = Math.max(0, requestLimit - currentCount);
     const resetTime = Date.now() + windowMs;
 
     // 设置响应头
     if (standardHeaders) {
-      context.setHeader('RateLimit-Limit', max.toString());
+      context.setHeader('RateLimit-Limit', requestLimit.toString());
       context.setHeader('RateLimit-Remaining', remaining.toString());
       context.setHeader('RateLimit-Reset', Math.ceil(resetTime / 1000).toString());
     }
 
     if (legacyHeaders) {
-      context.setHeader('X-RateLimit-Limit', max.toString());
+      context.setHeader('X-RateLimit-Limit', requestLimit.toString());
       context.setHeader('X-RateLimit-Remaining', remaining.toString());
       context.setHeader('X-RateLimit-Reset', Math.ceil(resetTime / 1000).toString());
     }
 
     // 检查是否超过限制
-    if (currentCount > max) {
+    if (currentCount > requestLimit) {
       context.setStatus(statusCode);
       return context.createErrorResponse({
         error: message,

package/src/queue/service.ts

@@ -17,7 +17,7 @@ import { getRuntime } from '../platform/runtime';
  */
 @Injectable()
 export class QueueService {
-  private store: QueueStore;
+  public readonly store: QueueStore;
   private defaultQueue: string;
   private enableWorker: boolean;
   private concurrency: number;

package/src/queue/types.ts

@@ -24,6 +24,11 @@ export interface JobOptions {
    */
   attempts?: number;
 
+  /**
+   * 任务重试次数别名，兼容早期 API。
+   */
+  retries?: number;
+
   /**
    * 任务重试延迟（毫秒）
    */
@@ -90,7 +95,22 @@ export interface Job<T = JobData> {
   /**
    * 更新时间
    */
-  updatedAt: number;
+  updatedAt?: number;
+
+  /**
+   * 完成结果
+   */
+  result?: unknown;
+
+  /**
+   * 完成时间
+   */
+  completedAt?: number;
+
+  /**
+   * 失败错误信息
+   */
+  error?: string;
 }
 
 /**
@@ -141,6 +161,25 @@ export interface QueueStore {
     status: Job['status'],
   ): Promise<boolean>;
 
+  complete?(
+    queueName: string,
+    jobId: string,
+    result?: unknown,
+  ): Promise<boolean>;
+
+  fail?(
+    queueName: string,
+    jobId: string,
+    error: Error,
+  ): Promise<boolean>;
+
+  getStats?(queueName: string): Promise<{
+    waiting: number;
+    active: number;
+    completed: number;
+    failed: number;
+  }>;
+
   /**
    * 删除任务
    * @param queueName - 队列名称

package/src/router/decorators.ts

@@ -1,5 +1,4 @@
 import 'reflect-metadata';
-import type { RouteHandler } from './types';
 import { RouteRegistry } from './registry';
 import type { HttpMethod } from './types';
 import { CONTROLLER_METADATA_KEY } from '../controller/controller';
@@ -15,7 +14,7 @@ export const ROUTE_METADATA_KEY = Symbol('route');
 export interface RouteMetadata {
   method: HttpMethod;
   path: string;
-  handler: RouteHandler;
+  handler: (...args: any[]) => unknown;
   /**
    * 属性键（用于控制器方法）
    */
@@ -75,7 +74,7 @@ function createRouteDecorator(method: HttpMethod, path: string = '') {
     existingRoutes.push({
       method,
       path: path ?? '',
-      handler: descriptor.value as RouteHandler,
+      handler: descriptor.value as (...args: any[]) => unknown,
       propertyKey: propertyKeyStr || undefined,
     });
     Reflect.defineMetadata(ROUTE_METADATA_KEY, existingRoutes, target);

package/src/security/guards/types.ts

@@ -16,6 +16,8 @@ export interface CanActivate {
   canActivate(context: ExecutionContext): boolean | Promise<boolean>;
 }
 
+export type Guard = CanActivate;
+
 /**
  * HTTP 参数主机接口
  * 提供 HTTP 请求相关的上下文信息
@@ -141,4 +143,3 @@ export const GUARD_REGISTRY_TOKEN = Symbol('@dangao/bun-server:guard-registry');
  * Roles 元数据键
  */
 export const ROLES_METADATA_KEY = Symbol('@dangao/bun-server:roles');
-

package/src/security/types.ts

@@ -35,7 +35,7 @@ export interface Credentials {
   /**
    * 凭据数据
    */
-  data: unknown;
+  data: any;
 }
 
 /**
@@ -162,4 +162,3 @@ export interface SecurityContext {
    */
   getAuthorities(): string[];
 }
-

package/src/session/service.ts

@@ -25,7 +25,7 @@ export class SessionService {
   ) {
     this.store = options.store!;
     this.name = options.name ?? 'sessionId';
-    this.maxAge = options.maxAge ?? 86400000; // 24 小时
+    this.maxAge = options.maxAge ?? options.ttl ?? 86400000; // 24 小时
     this.rolling = options.rolling ?? true;
     this.cookieOptions = {
       secure: options.cookie?.secure ?? false,

package/src/session/types.ts

@@ -317,6 +317,11 @@ export interface SessionModuleOptions {
    */
   maxAge?: number;
 
+  /**
+   * Session 最大存活时间别名。
+   */
+  ttl?: number;
+
   /**
    * 是否在每次访问时更新过期时间
    * @default true
@@ -327,6 +332,11 @@ export interface SessionModuleOptions {
    * Cookie 选项
    */
   cookie?: {
+    /**
+     * Cookie 名称别名，优先使用顶层 name。
+     */
+    name?: string;
+
     /**
      * 是否只在 HTTPS 下发送
      * @default false

package/src/swagger/decorators.ts

@@ -50,13 +50,25 @@ export function ApiOperation(metadata: ApiOperationMetadata): MethodDecorator {
  * 用于描述 API 参数
  * @param metadata - 参数元数据
  */
-export function ApiParam(metadata: ApiParamMetadata): ParameterDecorator {
-  return function (target: unknown, propertyKey: string | symbol | undefined, parameterIndex: number) {
+export function ApiParam(metadata: ApiParamMetadata): ParameterDecorator & MethodDecorator {
+  const decorator = (
+    target: Object,
+    propertyKey: string | symbol | undefined,
+    descriptorOrParameterIndex: TypedPropertyDescriptor<any> | number,
+  ): void => {
+    const paramMetadata: ApiParamMetadata = {
+      in: 'path',
+      ...metadata,
+    };
     const existingParams: Array<{ index: number; metadata: ApiParamMetadata }> =
       Reflect.getMetadata(API_PARAM_METADATA_KEY, target as Object, propertyKey!) || [];
-    existingParams.push({ index: parameterIndex, metadata });
+    const index = typeof descriptorOrParameterIndex === 'number'
+      ? descriptorOrParameterIndex
+      : -1;
+    existingParams.push({ index, metadata: paramMetadata });
     Reflect.defineMetadata(API_PARAM_METADATA_KEY, existingParams, target as Object, propertyKey!);
   };
+  return decorator as ParameterDecorator & MethodDecorator;
 }
 
 /**
@@ -130,4 +142,3 @@ export function getApiResponses(
 ): ApiResponseMetadata[] {
   return Reflect.getMetadata(API_RESPONSE_METADATA_KEY, target as Object, propertyKey) || [];
 }
-

package/src/swagger/generator.ts

@@ -139,7 +139,7 @@ export class SwaggerGenerator {
         for (const match of pathParamMatches) {
           const paramName = match[1];
           // 检查是否已经有手动定义的参数
-          const existingParam = params.find((p) => p.metadata.name === paramName && p.metadata.in === 'path');
+          const existingParam = params.find((p) => p.metadata.name === paramName && (p.metadata.in ?? 'path') === 'path');
           if (!existingParam) {
             // 自动添加路径参数
             pathParams.push({
@@ -155,7 +155,7 @@ export class SwaggerGenerator {
         for (const param of params) {
           pathParams.push({
             name: param.metadata.name,
-            in: param.metadata.in,
+            in: param.metadata.in ?? 'path',
             description: param.metadata.description,
             required: param.metadata.required,
             schema: param.metadata.schema,
@@ -332,4 +332,3 @@ export class SwaggerGenerator {
     return path;
   }
 }
-

package/src/swagger/types.ts

@@ -60,7 +60,7 @@ export interface ApiParamMetadata {
     enum?: unknown[];
     default?: unknown;
   };
-  in: 'query' | 'path' | 'header' | 'cookie';
+  in?: 'query' | 'path' | 'header' | 'cookie';
 }
 
 /**
@@ -185,4 +185,3 @@ export interface SwaggerDocument {
     patch?: SwaggerPathItem;
   }>;
 }
-

package/src/testing/harness.ts

@@ -22,7 +22,7 @@ export class PerformanceHarness {
   public static async benchmark(
     name: string,
     iterations: number,
-    runner: (iteration: number) => void | Promise<void>,
+    runner: (iteration: number) => unknown | Promise<unknown>,
   ): Promise<BenchmarkResult> {
     if (iterations <= 0) {
       throw new Error('iterations must be greater than 0');
@@ -93,4 +93,3 @@ export class StressTester {
     };
   }
 }
-

package/src/testing/test-client.ts

@@ -9,7 +9,7 @@ interface RequestOptions {
 interface TestResponse {
   status: number;
   headers: Headers;
-  body: unknown;
+  body: any;
   text: string;
   ok: boolean;
 }
@@ -94,7 +94,7 @@ export class TestHttpClient {
     const response = await fetch(url, fetchOptions);
     const text = await response.text();
 
-    let body: unknown;
+    let body: any;
     try {
       body = JSON.parse(text);
     } catch (_error) {

package/src/testing/testing-module.ts

@@ -5,7 +5,7 @@ import { Container } from '../di/container';
 import { ModuleRegistry } from '../di/module-registry';
 import { ControllerRegistry } from '../controller/controller';
 import { RouteRegistry } from '../router/registry';
-import { MODULE_METADATA_KEY, type ModuleMetadata, type ModuleClass, type ModuleProvider, type ProviderToken } from '../di/module';
+import { MODULE_METADATA_KEY, invokeFactoryProvider, type ModuleMetadata, type ModuleClass, type ModuleProvider, type ProviderToken } from '../di/module';
 import type { Constructor } from '../core/types';
 import { TestHttpClient } from './test-client';
 
@@ -13,7 +13,7 @@ interface ProviderOverride {
   token: ProviderToken;
   useValue?: unknown;
   useClass?: Constructor<unknown>;
-  useFactory?: () => unknown;
+  useFactory?: (...args: any[]) => unknown;
 }
 
 /**
@@ -75,7 +75,7 @@ export class TestingModuleBuilder {
         } else if (override.useClass) {
           result.push({ provide: override.token, useClass: override.useClass });
         } else if (override.useFactory) {
-          result.push({ provide: override.token, useFactory: override.useFactory as (container: Container) => unknown });
+          result.push({ provide: override.token, useFactory: override.useFactory });
         }
         overrideMap.delete(key as string | symbol);
       } else {
@@ -121,7 +121,7 @@ class ProviderOverrideBuilder {
   /**
    * 使用工厂函数覆盖
    */
-  public useFactory(factory: () => unknown): TestingModuleBuilder {
+  public useFactory(factory: (...args: any[]) => unknown): TestingModuleBuilder {
     this.builder.addOverride({ token: this.token, useFactory: factory });
     return this.builder;
   }
@@ -177,7 +177,7 @@ export class TestingModule {
         container.registerInstance(provider.provide, provider.useValue);
       } else if ('useFactory' in provider && provider.provide) {
         container.register(provider.provide as Constructor<unknown>, {
-          factory: () => (provider as { useFactory: (container: Container) => unknown }).useFactory(container),
+          factory: () => invokeFactoryProvider(provider, container),
         });
       } else if ('useClass' in provider) {
         const token = (provider as { provide?: ProviderToken }).provide ?? (provider as { useClass: Constructor<unknown> }).useClass;

package/src/validation/errors.ts

@@ -9,10 +9,15 @@ export interface ValidationIssue {
    */
   property?: string;
 
+  /**
+   * 属性路径别名，兼容早期错误对象形状。
+   */
+  path?: string;
+
   /**
    * 失败的规则名称
    */
-  rule: string;
+  rule?: string;
 
   /**
    * 错误信息
@@ -73,4 +78,3 @@ export class ValidationError extends Error {
   }
 }
 
-

package/tests/bun-test-shim.d.ts

@@ -0,0 +1,11 @@
+declare module 'bun:test' {
+  export const describe: any;
+  export const test: any;
+  export const it: any;
+  export const expect: any;
+  export const beforeEach: any;
+  export const afterEach: any;
+  export const beforeAll: any;
+  export const afterAll: any;
+  export const mock: any;
+}