@dangao/bun-server 0.4.0 → 1.0.1

package/dist/middleware/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/middleware/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;gBAE7B,kBAAkB,GAAE,UAAU,EAAO;IAIxD;;;OAGG;IACI,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIxC;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,cAAc,IAAI,OAAO;IAIhC;;;;;OAKG;IACU,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC;CAwBlF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,UAAU,EAAE,EACzB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,QAAQ,CAAC,CAOnB"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/middleware/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;gBAE7B,kBAAkB,GAAE,UAAU,EAAO;IAIxD;;;OAGG;IACI,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIxC;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,cAAc,IAAI,OAAO;IAIhC;;;;;OAKG;IACU,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC;CA6BlF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,UAAU,EAAE,EACzB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,QAAQ,CAAC,CAOnB"}

package/dist/queue/decorators.d.ts

@@ -0,0 +1,63 @@
+import 'reflect-metadata';
+/**
+ * 队列配置
+ */
+export interface QueueOptions {
+    /**
+     * 队列名称
+     * @default 'default'
+     */
+    name?: string;
+}
+/**
+ * Cron 配置
+ */
+export interface CronDecoratorOptions {
+    /**
+     * Cron 表达式
+     */
+    pattern: string;
+    /**
+     * 时区
+     * @default 'UTC'
+     */
+    timezone?: string;
+    /**
+     * 是否立即执行一次
+     * @default false
+     */
+    runOnInit?: boolean;
+    /**
+     * 队列名称
+     * @default 'default'
+     */
+    queueName?: string;
+}
+/**
+ * 队列装饰器元数据
+ */
+export interface QueueMetadata {
+    name?: string;
+}
+export interface CronMetadata {
+    pattern: string;
+    timezone?: string;
+    runOnInit?: boolean;
+    queueName?: string;
+}
+/**
+ * 标记方法为队列任务处理器
+ * @param options - 队列配置
+ */
+export declare function Queue(options?: QueueOptions): MethodDecorator;
+/**
+ * 标记方法为定时任务（Cron）
+ * @param options - Cron 配置
+ */
+export declare function Cron(options: CronDecoratorOptions): MethodDecorator;
+/**
+ * 获取队列装饰器元数据
+ */
+export declare function getQueueMetadata(target: unknown): QueueMetadata | undefined;
+export declare function getCronMetadata(target: unknown): CronMetadata | undefined;
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/queue/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAQ1B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,eAAe,CAYjE;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe,CAenE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAE3E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAEzE"}

package/dist/queue/index.d.ts

@@ -0,0 +1,6 @@
+export { QueueModule } from './queue-module';
+export { QueueService } from './service';
+export { Queue, Cron, getQueueMetadata, getCronMetadata, type QueueOptions, type CronDecoratorOptions, type QueueMetadata, type CronMetadata, } from './decorators';
+export { MemoryQueueStore, QUEUE_SERVICE_TOKEN, QUEUE_OPTIONS_TOKEN, } from './types';
+export type { QueueStore, QueueModuleOptions, Job, JobData, JobHandler, JobOptions, CronOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACL,KAAK,EACL,IAAI,EACJ,gBAAgB,EAChB,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,GAAG,EACH,OAAO,EACP,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/queue/queue-module.d.ts

@@ -0,0 +1,9 @@
+import { type QueueModuleOptions } from './types';
+export declare class QueueModule {
+    /**
+     * 创建队列模块
+     * @param options - 模块配置
+     */
+    static forRoot(options?: QueueModuleOptions): typeof QueueModule;
+}
+//# sourceMappingURL=queue-module.d.ts.map

package/dist/queue/queue-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-module.d.ts","sourceRoot":"","sources":["../../src/queue/queue-module.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,kBAAkB,EAExB,MAAM,SAAS,CAAC;AAEjB,qBAGa,WAAW;IACtB;;;OAGG;WACW,OAAO,CACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,WAAW;CA0CtB"}

package/dist/queue/service.d.ts

@@ -0,0 +1,93 @@
+import type { QueueModuleOptions, Job, JobData, JobHandler, JobOptions, CronOptions } from './types';
+/**
+ * 队列服务
+ */
+export declare class QueueService {
+    private store;
+    private defaultQueue;
+    private enableWorker;
+    private concurrency;
+    private workers;
+    private cronJobs;
+    private cronTimers;
+    constructor(options: QueueModuleOptions);
+    /**
+     * 添加任务
+     * @param jobName - 任务名称
+     * @param data - 任务数据
+     * @param options - 任务选项
+     * @param queueName - 队列名称（可选，默认使用 defaultQueue）
+     * @returns 任务 ID
+     */
+    add<T = JobData>(jobName: string, data: T, options?: JobOptions, queueName?: string): Promise<string>;
+    /**
+     * 获取任务
+     * @param jobId - 任务 ID
+     * @param queueName - 队列名称（可选）
+     * @returns 任务，如果不存在则返回 undefined
+     */
+    get<T = JobData>(jobId: string, queueName?: string): Promise<Job<T> | undefined>;
+    /**
+     * 删除任务
+     * @param jobId - 任务 ID
+     * @param queueName - 队列名称（可选）
+     * @returns 是否删除成功
+     */
+    delete(jobId: string, queueName?: string): Promise<boolean>;
+    /**
+     * 清空队列
+     * @param queueName - 队列名称（可选）
+     * @returns 是否清空成功
+     */
+    clear(queueName?: string): Promise<boolean>;
+    /**
+     * 获取队列中的任务数量
+     * @param queueName - 队列名称（可选）
+     * @returns 任务数量
+     */
+    count(queueName?: string): Promise<number>;
+    /**
+     * 注册任务处理器
+     * @param jobName - 任务名称
+     * @param handler - 任务处理器
+     * @param queueName - 队列名称（可选）
+     */
+    registerHandler<T = JobData>(jobName: string, handler: JobHandler<T>, queueName?: string): Promise<void>;
+    /**
+     * 注册定时任务（Cron）
+     * @param jobName - 任务名称
+     * @param handler - 任务处理器
+     * @param options - Cron 配置
+     * @param queueName - 队列名称（可选）
+     */
+    registerCron<T = JobData>(jobName: string, handler: JobHandler<T>, options: CronOptions, queueName?: string): Promise<void>;
+    /**
+     * 启动工作进程
+     * @param queueName - 队列名称
+     */
+    private startWorker;
+    /**
+     * 处理队列
+     * @param queueName - 队列名称
+     */
+    private processQueue;
+    /**
+     * 获取处理器
+     * @param jobName - 任务名称
+     * @param queueName - 队列名称
+     * @returns 处理器，如果不存在则返回 undefined
+     */
+    private getHandler;
+    /**
+     * 解析 Cron 表达式为间隔时间（毫秒）
+     * 注意：这是简化实现，实际应该使用专业的 cron 解析库
+     * @param pattern - Cron 表达式
+     * @returns 间隔时间（毫秒），如果无法解析则返回 -1
+     */
+    private parseCronInterval;
+    /**
+     * 销毁服务，清理资源
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/queue/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/queue/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,kBAAkB,EAClB,GAAG,EACH,OAAO,EACP,UAAU,EACV,UAAU,EACV,WAAW,EACZ,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,qBACa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,QAAQ,CACJ;IACZ,OAAO,CAAC,UAAU,CAA0D;gBAE5B,OAAO,EAAE,kBAAkB;IAW3E;;;;;;;OAOG;IACU,GAAG,CAAC,CAAC,GAAG,OAAO,EAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,UAAU,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;IAgBlB;;;;;OAKG;IACU,GAAG,CAAC,CAAC,GAAG,OAAO,EAC1B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAK9B;;;;;OAKG;IACU,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxE;;;;OAIG;IACU,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxD;;;;OAIG;IACU,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvD;;;;;OAKG;IACU,eAAe,CAAC,CAAC,GAAG,OAAO,EACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAehB;;;;;;OAMG;IACU,YAAY,CAAC,CAAC,GAAG,OAAO,EACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EACtB,OAAO,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAsBhB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAenB;;;OAGG;YACW,YAAY;IAoC1B;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAUlB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;IACI,OAAO,IAAI,IAAI;CASvB"}

package/dist/queue/types.d.ts

@@ -0,0 +1,204 @@
+/**
+ * 任务数据
+ */
+export interface JobData {
+    [key: string]: unknown;
+}
+/**
+ * 任务选项
+ */
+export interface JobOptions {
+    /**
+     * 任务延迟（毫秒）
+     */
+    delay?: number;
+    /**
+     * 任务优先级（数字越大优先级越高）
+     */
+    priority?: number;
+    /**
+     * 任务重试次数
+     */
+    attempts?: number;
+    /**
+     * 任务重试延迟（毫秒）
+     */
+    backoff?: {
+        type: 'fixed' | 'exponential';
+        delay: number;
+    };
+    /**
+     * 任务超时时间（毫秒）
+     */
+    timeout?: number;
+    /**
+     * 任务 ID（如果不提供则自动生成）
+     */
+    jobId?: string;
+    /**
+     * 是否移除任务（如果已完成）
+     */
+    removeOnComplete?: boolean | number;
+    /**
+     * 是否移除任务（如果失败）
+     */
+    removeOnFail?: boolean | number;
+}
+/**
+ * 任务
+ */
+export interface Job<T = JobData> {
+    /**
+     * 任务 ID
+     */
+    id: string;
+    /**
+     * 任务名称
+     */
+    name: string;
+    /**
+     * 任务数据
+     */
+    data: T;
+    /**
+     * 任务选项
+     */
+    options?: JobOptions;
+    /**
+     * 任务状态
+     */
+    status: 'waiting' | 'active' | 'completed' | 'failed' | 'delayed';
+    /**
+     * 创建时间
+     */
+    createdAt: number;
+    /**
+     * 更新时间
+     */
+    updatedAt: number;
+}
+/**
+ * 任务处理器
+ */
+export type JobHandler<T = JobData> = (job: Job<T>) => Promise<void> | void;
+/**
+ * 队列存储接口
+ */
+export interface QueueStore {
+    /**
+     * 添加任务
+     * @param queueName - 队列名称
+     * @param job - 任务
+     * @returns 任务 ID
+     */
+    add<T = JobData>(queueName: string, job: Omit<Job<T>, 'id' | 'status' | 'createdAt' | 'updatedAt'>): Promise<string>;
+    /**
+     * 获取任务
+     * @param queueName - 队列名称
+     * @param jobId - 任务 ID
+     * @returns 任务，如果不存在则返回 undefined
+     */
+    get<T = JobData>(queueName: string, jobId: string): Promise<Job<T> | undefined>;
+    /**
+     * 获取下一个待处理的任务
+     * @param queueName - 队列名称
+     * @returns 任务，如果没有则返回 undefined
+     */
+    getNext<T = JobData>(queueName: string): Promise<Job<T> | undefined>;
+    /**
+     * 更新任务状态
+     * @param queueName - 队列名称
+     * @param jobId - 任务 ID
+     * @param status - 新状态
+     * @returns 是否更新成功
+     */
+    updateStatus(queueName: string, jobId: string, status: Job['status']): Promise<boolean>;
+    /**
+     * 删除任务
+     * @param queueName - 队列名称
+     * @param jobId - 任务 ID
+     * @returns 是否删除成功
+     */
+    delete(queueName: string, jobId: string): Promise<boolean>;
+    /**
+     * 清空队列
+     * @param queueName - 队列名称
+     * @returns 是否清空成功
+     */
+    clear(queueName: string): Promise<boolean>;
+    /**
+     * 获取队列中的任务数量
+     * @param queueName - 队列名称
+     * @returns 任务数量
+     */
+    count(queueName: string): Promise<number>;
+}
+/**
+ * 内存队列存储实现
+ */
+export declare class MemoryQueueStore implements QueueStore {
+    private queues;
+    private jobCounter;
+    add<T = JobData>(queueName: string, job: Omit<Job<T>, 'id' | 'status' | 'createdAt' | 'updatedAt'>): Promise<string>;
+    get<T = JobData>(queueName: string, jobId: string): Promise<Job<T> | undefined>;
+    getNext<T = JobData>(queueName: string): Promise<Job<T> | undefined>;
+    updateStatus(queueName: string, jobId: string, status: Job['status']): Promise<boolean>;
+    delete(queueName: string, jobId: string): Promise<boolean>;
+    clear(queueName: string): Promise<boolean>;
+    count(queueName: string): Promise<number>;
+    private getQueue;
+}
+/**
+ * Cron 表达式配置
+ */
+export interface CronOptions {
+    /**
+     * Cron 表达式（支持标准 5 字段格式：分 时 日 月 周）
+     * 例如：'0 0 * * *' 表示每天午夜执行
+     */
+    pattern: string;
+    /**
+     * 时区
+     * @default 'UTC'
+     */
+    timezone?: string;
+    /**
+     * 是否立即执行一次
+     * @default false
+     */
+    runOnInit?: boolean;
+}
+/**
+ * QueueModule 配置选项
+ */
+export interface QueueModuleOptions {
+    /**
+     * 队列存储实现
+     * @default MemoryQueueStore
+     */
+    store?: QueueStore;
+    /**
+     * 默认队列名称
+     * @default 'default'
+     */
+    defaultQueue?: string;
+    /**
+     * 是否启用工作进程
+     * @default true
+     */
+    enableWorker?: boolean;
+    /**
+     * 工作进程并发数
+     * @default 1
+     */
+    concurrency?: number;
+}
+/**
+ * QueueService Token
+ */
+export declare const QUEUE_SERVICE_TOKEN: unique symbol;
+/**
+ * QueueModule Options Token
+ */
+export declare const QUEUE_OPTIONS_TOKEN: unique symbol;
+//# sourceMappingURL=types.d.ts.map

package/dist/queue/types.d.ts.map

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

package/dist/router/router.d.ts

@@ -1,6 +1,6 @@
 import type { Context } from '../core/context';
 import { Route } from './route';
-import type { HttpMethod, RouteHandler } from './types';
+import type { HttpMethod, RouteHandler, RouteMatch } from './types';
 import type { Middleware } from '../middleware';
 /**
  * 路由器类
@@ -13,6 +13,11 @@ export declare class Router {
     private readonly routes;
     private readonly staticRoutes;
     private readonly dynamicRoutes;
+    /**
+     * 路由匹配结果缓存（method:path -> { route, match }）
+     * 用于避免重复匹配，提升性能
+     */
+    private readonly matchCache;
     /**
      * 规范化路径（移除尾部斜杠，除非是根路径）
      */
@@ -64,6 +69,16 @@ export declare class Router {
      * @returns 匹配的路由，如果没有找到则返回 undefined
      */
     findRoute(method: HttpMethod, path: string): Route | undefined;
+    /**
+     * 查找匹配的路由并返回匹配结果（包含参数）
+     * @param method - HTTP 方法
+     * @param path - 请求路径
+     * @returns 匹配结果，包含路由和参数，如果没有找到则返回 undefined
+     */
+    findRouteWithMatch(method: HttpMethod, path: string): {
+        route: Route;
+        match: RouteMatch;
+    } | undefined;
     /**
      * 预处理请求：仅匹配路由并设置路径参数 / routeHandler，但不执行处理器
      * 供安全过滤器等中间件在真正执行前基于路由元数据做鉴权

package/dist/router/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;GAGG;AACH,qBAAa,MAAM;IACjB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;;;OAQG;IACI,QAAQ,CACb,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,UAAU,EAAO,EAC9B,eAAe,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACrD,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAaP;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAItF;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIxF;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIvF;;;;;OAKG;IACI,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAerE;;;OAGG;IACU,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvD;;;;OAIG;IACU,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAepE;;;OAGG;IACI,SAAS,IAAI,SAAS,KAAK,EAAE;IAIpC;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;GAGG;AACH,qBAAa,MAAM;IACjB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0D;IAErF;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;;;OAQG;IACI,QAAQ,CACb,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,UAAU,EAAO,EAC9B,eAAe,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACrD,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAgBP;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAItF;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIrF;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIxF;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAIvF;;;;;OAKG;IACI,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAKrE;;;;;OAKG;IACI,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,SAAS;IAmC5G;;;OAGG;IACU,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBvD;;;;OAIG;IACU,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IA4BpE;;;OAGG;IACI,SAAS,IAAI,SAAS,KAAK,EAAE;IAIpC;;OAEG;IACI,KAAK,IAAI,IAAI;CAMrB"}

package/dist/session/decorators.d.ts

@@ -0,0 +1,16 @@
+import 'reflect-metadata';
+import type { Context } from '../core/context';
+import { Container } from '../di/container';
+/**
+ * Session 参数装饰器
+ * 用于在控制器方法中注入 Session 对象
+ */
+export declare function Session(): (target: any, propertyKey: string | symbol | undefined, parameterIndex: number) => void;
+/**
+ * 获取 Session 对象（用于参数绑定）
+ * @param context - 请求上下文
+ * @param container - DI 容器
+ * @returns Session 对象，如果不存在则返回 undefined
+ */
+export declare function getSessionFromContext(context: Context, container: Container): Promise<unknown | undefined>;
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/session/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C;;;GAGG;AACH,wBAAgB,OAAO,4FAEtB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAoB9B"}

package/dist/session/index.d.ts

@@ -0,0 +1,8 @@
+export { SessionModule } from './session-module';
+export { SessionService } from './service';
+export { createSessionMiddleware } from './middleware';
+export { Session as SessionDecorator, getSessionFromContext } from './decorators';
+export { MemorySessionStore, RedisSessionStore, SESSION_SERVICE_TOKEN, SESSION_OPTIONS_TOKEN, } from './types';
+export type { SessionStore, } from './types';
+export type { SessionModuleOptions, Session, SessionData, RedisSessionStoreOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,oBAAoB,EACpB,OAAO,EACP,WAAW,EACX,wBAAwB,GACzB,MAAM,SAAS,CAAC"}

package/dist/session/middleware.d.ts

@@ -0,0 +1,8 @@
+import type { Middleware } from '../middleware/middleware';
+import type { Container } from '../di/container';
+/**
+ * Session 中间件
+ * 从 Cookie 中读取 Session ID，并将 Session 对象附加到 Context
+ */
+export declare function createSessionMiddleware(container: Container): Middleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/session/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/session/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,0BAA0B,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,UAAU,CAsFZ"}

package/dist/session/service.d.ts

@@ -0,0 +1,86 @@
+import type { SessionModuleOptions, Session, SessionData } from './types';
+/**
+ * Session 服务
+ */
+export declare class SessionService {
+    private store;
+    private name;
+    private maxAge;
+    private rolling;
+    private cookieOptions;
+    constructor(options: SessionModuleOptions);
+    /**
+     * 生成 Session ID
+     * @returns Session ID
+     */
+    private generateSessionId;
+    /**
+     * 创建新 Session
+     * @param initialData - 初始数据
+     * @returns Session
+     */
+    create(initialData?: SessionData): Promise<Session>;
+    /**
+     * 获取 Session
+     * @param sessionId - Session ID
+     * @returns Session，如果不存在或已过期则返回 undefined
+     */
+    get(sessionId: string): Promise<Session | undefined>;
+    /**
+     * 更新 Session 数据
+     * @param sessionId - Session ID
+     * @param data - 新数据
+     * @returns 是否更新成功
+     */
+    set(sessionId: string, data: SessionData): Promise<boolean>;
+    /**
+     * 获取 Session 数据中的某个值
+     * @param sessionId - Session ID
+     * @param key - 数据键
+     * @returns 数据值，如果不存在则返回 undefined
+     */
+    getValue<T = unknown>(sessionId: string, key: string): Promise<T | undefined>;
+    /**
+     * 设置 Session 数据中的某个值
+     * @param sessionId - Session ID
+     * @param key - 数据键
+     * @param value - 数据值
+     * @returns 是否设置成功
+     */
+    setValue<T = unknown>(sessionId: string, key: string, value: T): Promise<boolean>;
+    /**
+     * 删除 Session 数据中的某个值
+     * @param sessionId - Session ID
+     * @param key - 数据键
+     * @returns 是否删除成功
+     */
+    deleteValue(sessionId: string, key: string): Promise<boolean>;
+    /**
+     * 删除 Session
+     * @param sessionId - Session ID
+     * @returns 是否删除成功
+     */
+    delete(sessionId: string): Promise<boolean>;
+    /**
+     * 更新 Session 的最后访问时间
+     * @param sessionId - Session ID
+     * @returns 是否更新成功
+     */
+    touch(sessionId: string): Promise<boolean>;
+    /**
+     * 获取 Cookie 名称
+     * @returns Cookie 名称
+     */
+    getCookieName(): string;
+    /**
+     * 获取 Cookie 选项
+     * @returns Cookie 选项
+     */
+    getCookieOptions(): Required<SessionModuleOptions>['cookie'];
+    /**
+     * 获取最大存活时间
+     * @returns 最大存活时间（毫秒）
+     */
+    getMaxAge(): number;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/session/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/session/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,oBAAoB,EACpB,OAAO,EACP,WAAW,EACZ,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,qBACa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,aAAa,CAA2C;gBAG/B,OAAO,EAAE,oBAAoB;IAe9D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;OAIG;IACU,MAAM,CAAC,WAAW,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAcpE;;;;OAIG;IACU,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAcjE;;;;;OAKG;IACU,GAAG,CACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,OAAO,CAAC;IAgBnB;;;;;OAKG;IACU,QAAQ,CAAC,CAAC,GAAG,OAAO,EAC/B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IASzB;;;;;;OAMG;IACU,QAAQ,CAAC,CAAC,GAAG,OAAO,EAC/B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,OAAO,CAAC;IAgBnB;;;;;OAKG;IACU,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB1E;;;;OAIG;IACU,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxD;;;;OAIG;IACU,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD;;;OAGG;IACI,aAAa,IAAI,MAAM;IAI9B;;;OAGG;IACI,gBAAgB,IAAI,QAAQ,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC;IAInE;;;OAGG;IACI,SAAS,IAAI,MAAM;CAG3B"}

package/dist/session/session-module.d.ts

@@ -0,0 +1,9 @@
+import { type SessionModuleOptions } from './types';
+export declare class SessionModule {
+    /**
+     * 创建 Session 模块
+     * @param options - 模块配置
+     */
+    static forRoot(options?: SessionModuleOptions): typeof SessionModule;
+}
+//# sourceMappingURL=session-module.d.ts.map

package/dist/session/session-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-module.d.ts","sourceRoot":"","sources":["../../src/session/session-module.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,oBAAoB,EAE1B,MAAM,SAAS,CAAC;AAEjB,qBAGa,aAAa;IACxB;;;OAGG;WACW,OAAO,CACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,aAAa;CA+CxB"}