@dangao/bun-server 2.3.0 → 3.0.1

package/dist/middleware/builtin/static-file.d.ts

@@ -1,14 +1,16 @@
 import type { Middleware } from '../middleware';
-import type { HeadersInit } from 'bun';
+/** Cross-runtime compatible headers input type */
+type HeadersInput = Headers | string[][] | Record<string, string>;
 export interface StaticFileOptions {
     root: string;
     prefix?: string;
     indexFile?: string;
     enableCache?: boolean;
-    headers?: HeadersInit | Headers;
+    headers?: HeadersInput;
 }
 /**
  * 静态文件服务中间件
  */
 export declare function createStaticFileMiddleware(options: StaticFileOptions): Middleware;
+export {};
 //# sourceMappingURL=static-file.d.ts.map

package/dist/middleware/builtin/static-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static-file.d.ts","sourceRoot":"","sources":["../../../src/middleware/builtin/static-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAA;AAEtC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;CACjC;AAYD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CA2DjF"}
+{"version":3,"file":"static-file.d.ts","sourceRoot":"","sources":["../../../src/middleware/builtin/static-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,kDAAkD;AAClD,KAAK,YAAY,GAAG,OAAO,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAYD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CA2DjF"}

package/dist/platform/bun/crypto.d.ts

@@ -0,0 +1,3 @@
+import type { ICryptoAdapter } from '../types';
+export declare const bunCryptoAdapter: ICryptoAdapter;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/platform/bun/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../../src/platform/bun/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,UAAU,CAAC;AAyBxD,eAAO,MAAM,gBAAgB,EAAE,cAI9B,CAAC"}

package/dist/platform/bun/fs.d.ts

@@ -0,0 +1,3 @@
+import type { IFsAdapter } from '../types';
+export declare const bunFsAdapter: IFsAdapter;
+//# sourceMappingURL=fs.d.ts.map

package/dist/platform/bun/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/platform/bun/fs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,UAAU,CAAC;AAsCrD,eAAO,MAAM,YAAY,EAAE,UAa1B,CAAC"}

package/dist/platform/bun/http.d.ts

@@ -0,0 +1,15 @@
+import type { IHttpDriver, IWebSocket } from '../types';
+/**
+ * Bun ServerWebSocket 的 IWebSocket 包装
+ */
+export declare class BunWebSocket<T> implements IWebSocket<T> {
+    private readonly ws;
+    constructor(ws: import('bun').ServerWebSocket<T>);
+    get data(): T;
+    get readyState(): number;
+    send(data: string | Buffer | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+    getNative(): import('bun').ServerWebSocket<T>;
+}
+export declare const bunHttpAdapter: IHttpDriver;
+//# sourceMappingURL=http.d.ts.map

package/dist/platform/bun/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/platform/bun/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAmC,UAAU,EAAqB,MAAM,UAAU,CAAC;AAE5G;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC,CAAE,YAAW,UAAU,CAAC,CAAC,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,OAAO,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;IAExE,IAAW,IAAI,IAAI,CAAC,CAEnB;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAEM,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI;IAI9C,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3C,SAAS,IAAI,OAAO,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;CAGrD;AAgDD,eAAO,MAAM,cAAc,EAAE,WA8B5B,CAAC"}

package/dist/platform/bun/index.d.ts

@@ -0,0 +1,3 @@
+import type { IPlatform } from '../types';
+export declare function createBunPlatform(): IPlatform;
+//# sourceMappingURL=index.d.ts.map

package/dist/platform/bun/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/bun/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAO1C,wBAAgB,iBAAiB,IAAI,SAAS,CAS7C"}

package/dist/platform/bun/parser.d.ts

@@ -0,0 +1,3 @@
+import type { IParserAdapter } from '../types';
+export declare const bunParserAdapter: IParserAdapter;
+//# sourceMappingURL=parser.d.ts.map

package/dist/platform/bun/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/platform/bun/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,eAAO,MAAM,gBAAgB,EAAE,cAgB9B,CAAC"}

package/dist/platform/bun/process.d.ts

@@ -0,0 +1,3 @@
+import type { IProcessAdapter } from '../types';
+export declare const bunProcessAdapter: IProcessAdapter;
+//# sourceMappingURL=process.d.ts.map

package/dist/platform/bun/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../src/platform/bun/process.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAA+B,MAAM,UAAU,CAAC;AAsB7E,eAAO,MAAM,iBAAiB,EAAE,eAc/B,CAAC"}

package/dist/platform/detector.d.ts

@@ -0,0 +1,9 @@
+import type { PlatformEngine } from './types';
+/**
+ * 解析运行时平台引擎
+ * 优先级：bootstrap config > CLI arg (--platform=) > env var (BUN_SERVER_PLATFORM) > auto-detect
+ *
+ * @param bootstrapConfig - 应用启动时显式指定的平台（最高优先级）
+ */
+export declare function resolvePlatform(bootstrapConfig?: PlatformEngine): PlatformEngine;
+//# sourceMappingURL=detector.d.ts.map

package/dist/platform/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/platform/detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,eAAe,CAAC,EAAE,cAAc,GAAG,cAAc,CA2BhF"}

package/dist/platform/index.d.ts

@@ -0,0 +1,4 @@
+export type { PlatformEngine, IPlatform, IFsAdapter, IFileRef, ICryptoAdapter, IHasher, IParserAdapter, IProcessAdapter, IChildProcess, SpawnOptions, IHttpDriver, IServerHandle, IWebSocket, WebSocketHandlers, HttpServeOptions, } from './types';
+export { resolvePlatform } from './detector';
+export { initRuntime, getRuntime, _resetRuntime } from './runtime';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,SAAS,EACT,UAAU,EACV,QAAQ,EACR,cAAc,EACd,OAAO,EACP,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/platform/node/crypto.d.ts

@@ -0,0 +1,3 @@
+import type { ICryptoAdapter } from '../types';
+export declare const nodeCryptoAdapter: ICryptoAdapter;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/platform/node/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../../src/platform/node/crypto.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,UAAU,CAAC;AAkCxD,eAAO,MAAM,iBAAiB,EAAE,cAI/B,CAAC"}

package/dist/platform/node/fs.d.ts

@@ -0,0 +1,3 @@
+import type { IFsAdapter } from '../types';
+export declare const nodeFsAdapter: IFsAdapter;
+//# sourceMappingURL=fs.d.ts.map

package/dist/platform/node/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/platform/node/fs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,UAAU,CAAC;AAuDrD,eAAO,MAAM,aAAa,EAAE,UA6C3B,CAAC"}

package/dist/platform/node/http.d.ts

@@ -0,0 +1,3 @@
+import type { IHttpDriver } from '../types';
+export declare const nodeHttpAdapter: IHttpDriver;
+//# sourceMappingURL=http.d.ts.map

package/dist/platform/node/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/platform/node/http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAkE,MAAM,UAAU,CAAC;AAsH5G,eAAO,MAAM,eAAe,EAAE,WA4C7B,CAAC"}

package/dist/platform/node/index.d.ts

@@ -0,0 +1,3 @@
+import type { IPlatform } from '../types';
+export declare function createNodePlatform(): IPlatform;
+//# sourceMappingURL=index.d.ts.map

package/dist/platform/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAO1C,wBAAgB,kBAAkB,IAAI,SAAS,CAS9C"}

package/dist/platform/node/parser.d.ts

@@ -0,0 +1,3 @@
+import type { IParserAdapter } from '../types';
+export declare const nodeParserAdapter: IParserAdapter;
+//# sourceMappingURL=parser.d.ts.map

package/dist/platform/node/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/platform/node/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,eAAO,MAAM,iBAAiB,EAAE,cA+B/B,CAAC"}

package/dist/platform/node/process.d.ts

@@ -0,0 +1,3 @@
+import type { IProcessAdapter } from '../types';
+export declare const nodeProcessAdapter: IProcessAdapter;
+//# sourceMappingURL=process.d.ts.map

package/dist/platform/node/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../src/platform/node/process.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAA+B,MAAM,UAAU,CAAC;AAgC7E,eAAO,MAAM,kBAAkB,EAAE,eAiBhC,CAAC"}

package/dist/platform/runtime.d.ts

@@ -0,0 +1,14 @@
+import type { IPlatform, PlatformEngine } from './types';
+/**
+ * 初始化全局运行时平台
+ * 应在 Application 构造函数中最先调用
+ *
+ * @param engine - 显式指定平台（优先级最高），省略则走优先级检测链
+ */
+export declare function initRuntime(engine?: PlatformEngine): void;
+/**
+ * 获取当前已初始化的平台运行时
+ * 必须在 initRuntime() 调用之后使用
+ */
+export declare function getRuntime(): IPlatform;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/platform/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/platform/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAKzD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAezD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,SAAS,CAStC"}

package/dist/platform/types.d.ts

@@ -0,0 +1,139 @@
+/**
+ * 支持的运行时平台标识
+ */
+export type PlatformEngine = 'bun' | 'node';
+/**
+ * 文件引用抽象接口（替代 BunFile 的直接使用）
+ */
+export interface IFileRef {
+    readonly type: string;
+    readonly size: number;
+    text(): Promise<string>;
+    bytes(): Promise<Uint8Array>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    exists(): Promise<boolean>;
+    /** 返回可读流，用于 new Response(file.stream(), ...) */
+    stream(): ReadableStream<Uint8Array>;
+}
+/**
+ * 文件系统适配器接口
+ */
+export interface IFsAdapter {
+    /** 获取文件引用 */
+    file(path: string): IFileRef;
+    /** 写入文件 */
+    write(path: string, data: string | Uint8Array | ArrayBuffer): Promise<void>;
+    /** 匹配文件列表 */
+    glob(pattern: string, cwd?: string): string[];
+}
+/**
+ * 哈希器接口（替代 Bun.CryptoHasher）
+ */
+export interface IHasher {
+    update(data: string | Uint8Array | ArrayBuffer): IHasher;
+    digest(): Uint8Array;
+    digest(encoding: 'hex' | 'base64' | 'base64url'): string;
+}
+/**
+ * 加密适配器接口
+ */
+export interface ICryptoAdapter {
+    createHasher(algorithm: string): IHasher;
+}
+/**
+ * 解析器适配器接口
+ */
+export interface IParserAdapter {
+    parseJSONC(content: string): unknown;
+    parseJSON5(content: string): unknown;
+    parseJSONL(content: string): unknown[];
+    renderMarkdown(md: string): string;
+}
+/**
+ * 子进程接口
+ */
+export interface IChildProcess {
+    readonly pid: number;
+    readonly exited: Promise<number | null>;
+    kill(signal?: string | number): void;
+}
+/**
+ * spawn 选项
+ */
+export interface SpawnOptions {
+    cmd: string[];
+    env?: Record<string, string | undefined>;
+    stdout?: 'inherit' | 'pipe' | 'ignore';
+    stderr?: 'inherit' | 'pipe' | 'ignore';
+}
+/**
+ * 进程适配器接口
+ */
+export interface IProcessAdapter {
+    spawn(options: SpawnOptions): IChildProcess;
+    sleep(ms: number): Promise<void>;
+}
+/**
+ * WebSocket 连接抽象接口（替代 Bun.ServerWebSocket）
+ */
+export interface IWebSocket<T = unknown> {
+    readonly data: T;
+    readonly readyState: number;
+    send(data: string | Buffer | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+}
+/**
+ * WebSocket 事件处理器集合
+ */
+export interface WebSocketHandlers<T = unknown> {
+    open?: (ws: IWebSocket<T>) => void | Promise<void>;
+    message?: (ws: IWebSocket<T>, msg: string | Buffer) => void | Promise<void>;
+    close?: (ws: IWebSocket<T>, code: number, reason: string) => void | Promise<void>;
+}
+/**
+ * HTTP 服务启动选项
+ */
+export interface HttpServeOptions<T = unknown> {
+    port?: number;
+    hostname?: string;
+    reusePort?: boolean;
+    idleTimeout?: number;
+    /** Unix socket 路径（cluster proxy 模式使用） */
+    unix?: string;
+    fetch: (request: Request, server: IServerHandle) => Response | Promise<Response | undefined> | undefined;
+    websocket?: WebSocketHandlers<T>;
+}
+/**
+ * 服务器句柄接口（替代 Bun.Server）
+ */
+export interface IServerHandle {
+    readonly port: number;
+    readonly hostname?: string;
+    stop(): void;
+    /** 升级 WebSocket 连接（Bun 原生升级） */
+    upgrade?(request: Request, options?: {
+        data?: unknown;
+    }): boolean;
+    /** 设置连接超时（Bun 专属） */
+    timeout?(request: Request, seconds: number): void;
+    /** 获取底层原生服务器实例（不推荐，类型为 unknown） */
+    getNative(): unknown;
+}
+/**
+ * HTTP 驱动适配器接口
+ */
+export interface IHttpDriver {
+    serve<T = unknown>(options: HttpServeOptions<T>): Promise<IServerHandle>;
+}
+/**
+ * 平台接口聚合
+ */
+export interface IPlatform {
+    readonly engine: PlatformEngine;
+    readonly fs: IFsAdapter;
+    readonly crypto: ICryptoAdapter;
+    readonly parser: IParserAdapter;
+    readonly process: IProcessAdapter;
+    readonly http: IHttpDriver;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/prompt/stores/file-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../../src/prompt/stores/file-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,UAAU,CAAC;AAIlB,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,MAAM,CAAS;gBAEJ,MAAM,GAAE,qBAA0B;IAKxC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK/C,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKvE,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAKjC,MAAM,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAOjE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAO7E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAcnC,YAAY;YAiCZ,SAAS;CAkBxB"}
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../../src/prompt/stores/file-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,UAAU,CAAC;AAKlB,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,MAAM,CAAS;gBAEJ,MAAM,GAAE,qBAA0B;IAKxC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK/C,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKvE,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAKjC,MAAM,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAOjE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAO7E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAcnC,YAAY;YAiCZ,SAAS;CAkBxB"}

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

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/rag/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAmB,MAAM,SAAS,CAAC;AAK3F;;;;;GAKG;AACH,qBACa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAGrB,OAAO,EAAE,gBAAgB,EACnB,gBAAgB,EAAE,gBAAgB,EACvC,WAAW,EAAE,WAAW;IAStD;;;;;OAKG;IACU,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoC/E;;;;OAIG;IACU,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAuB9E;;OAEG;IACU,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAMtE,QAAQ;CAiBvB"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/rag/service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAmB,MAAM,SAAS,CAAC;AAK3F;;;;;GAKG;AACH,qBACa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAGrB,OAAO,EAAE,gBAAgB,EACnB,gBAAgB,EAAE,gBAAgB,EACvC,WAAW,EAAE,WAAW;IAStD;;;;;OAKG;IACU,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoC/E;;;;OAIG;IACU,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAuB9E;;OAEG;IACU,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAMtE,QAAQ;CAiBvB"}

package/dist/request/response.d.ts

@@ -1,4 +1,5 @@
-import type { HeadersInit } from 'bun';
+/** Cross-runtime compatible headers input type */
+type HeadersInit = Headers | string[][] | Record<string, string>;
 /**
  * 响应封装类
  * 提供便捷的响应创建方法
@@ -62,4 +63,5 @@ export declare class ResponseBuilder {
         headers?: HeadersInit;
     }): Response;
 }
+export {};
 //# sourceMappingURL=response.d.ts.map

package/dist/request/response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/request/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,KAAK,CAAC;AAEjD;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;;;;OAMG;WACW,IAAI,CAChB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,MAAY,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,QAAQ;IAUX;;;;;;OAMG;WACW,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAY,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,QAAQ;IAUX;;;;;;OAMG;WACW,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAY,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,QAAQ;IAUX;;;;;OAKG;WACW,KAAK,CAAC,MAAM,GAAE,MAAY,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,QAAQ;IAQ1E;;;;;OAKG;WACW,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,QAAQ;IASnE;;;;;OAKG;WACW,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,QAAQ;IAIpE;;;;;OAKG;WACW,IAAI,CAChB,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,eAAe,EACrD,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,WAAW,CAAC;KAClB,GACL,QAAQ;CAyBZ"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/request/response.ts"],"names":[],"mappings":"AAEA,kDAAkD;AAClD,KAAK,WAAW,GAAG,OAAO,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjE;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;;;;OAMG;WACW,IAAI,CAChB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,MAAY,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,QAAQ;IAUX;;;;;;OAMG;WACW,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAY,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,QAAQ;IAUX;;;;;;OAMG;WACW,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAY,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,QAAQ;IAUX;;;;;OAKG;WACW,KAAK,CAAC,MAAM,GAAE,MAAY,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,QAAQ;IAQ1E;;;;;OAKG;WACW,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,QAAQ;IASnE;;;;;OAKG;WACW,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,QAAQ;IAIpE;;;;;OAKG;WACW,IAAI,CAChB,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,eAAe,EACrD,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,WAAW,CAAC;KAClB,GACL,QAAQ;CAyBZ"}

package/dist/security/guards/execution-context.d.ts

@@ -1,5 +1,5 @@
 import 'reflect-metadata';
-import type { ServerWebSocket } from 'bun';
+import type { IWebSocket } from '../../platform/types';
 import type { Context } from '../../core/context';
 import type { ResponseBuilder } from '../../request/response';
 import type { Constructor } from '../../core/types';
@@ -21,7 +21,7 @@ export declare class ExecutionContextImpl implements ExecutionContext {
      * @param client - WebSocket 客户端
      * @param data - 消息数据
      */
-    setWsContext(client: ServerWebSocket<unknown>, data: unknown): void;
+    setWsContext(client: IWebSocket<unknown>, data: unknown): void;
     /**
      * 获取 HTTP 上下文
      */

package/dist/security/guards/execution-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../../src/security/guards/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EAChB,MAAM,SAAS,CAAC;AAkDjB;;GAEG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAKzD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IARvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAC,CAAkB;gBAGd,GAAG,EAAE,OAAO,EACZ,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,EACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,QAAQ,EACjB,IAAI,GAAE,OAAO,EAAO,EACrC,eAAe,CAAC,EAAE,eAAe;IAKnC;;;;OAIG;IACI,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAI1E;;OAEG;IACI,YAAY,IAAI,iBAAiB;IAIxC;;OAEG;IACI,UAAU,IAAI,eAAe;IAOpC;;OAEG;IACI,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC;IAIvC;;OAEG;IACI,UAAU,IAAI,QAAQ;IAI7B;;OAEG;IACI,aAAa,IAAI,MAAM;IAI9B;;;;OAIG;IACI,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS;IAe1D;;OAEG;IACI,OAAO,IAAI,OAAO,EAAE;CAG5B"}
+{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../../src/security/guards/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EAChB,MAAM,SAAS,CAAC;AAkDjB;;GAEG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAKzD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IARvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAC,CAAkB;gBAGd,GAAG,EAAE,OAAO,EACZ,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,EACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,QAAQ,EACjB,IAAI,GAAE,OAAO,EAAO,EACrC,eAAe,CAAC,EAAE,eAAe;IAKnC;;;;OAIG;IACI,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAIrE;;OAEG;IACI,YAAY,IAAI,iBAAiB;IAIxC;;OAEG;IACI,UAAU,IAAI,eAAe;IAOpC;;OAEG;IACI,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC;IAIvC;;OAEG;IACI,UAAU,IAAI,QAAQ;IAI7B;;OAEG;IACI,aAAa,IAAI,MAAM;IAI9B;;;;OAIG;IACI,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS;IAe1D;;OAEG;IACI,OAAO,IAAI,OAAO,EAAE;CAG5B"}

package/dist/security/guards/types.d.ts

@@ -1,7 +1,7 @@
 import type { Context } from '../../core/context';
 import type { ResponseBuilder } from '../../request/response';
 import type { Constructor } from '../../core/types';
-import type { ServerWebSocket } from 'bun';
+import type { IWebSocket } from '../../platform/types';
 /**
  * 守卫接口
  * 守卫用于决定请求是否可以继续执行
@@ -39,7 +39,7 @@ export interface WsArgumentsHost {
      * 获取 WebSocket 客户端
      * @returns WebSocket 连接对象
      */
-    getClient(): ServerWebSocket<unknown>;
+    getClient(): IWebSocket<unknown>;
     /**
      * 获取消息数据
      * @returns 消息数据

package/dist/security/guards/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/security/guards/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC;IAEtB;;;OAGG;IACH,WAAW,IAAI,eAAe,GAAG,SAAS,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,SAAS,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;IAEtC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,IAAI,iBAAiB,CAAC;IAElC;;;OAGG;IACH,UAAU,IAAI,eAAe,CAAC;IAE9B;;;OAGG;IACH,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IAEjC;;;OAGG;IACH,UAAU,IAAI,QAAQ,CAAC;IAEvB;;;OAGG;IACH,aAAa,IAAI,MAAM,CAAC;IAExB;;;;OAIG;IACH,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAEpD;;;OAGG;IACH,OAAO,IAAI,OAAO,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAsC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAA8C,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAAqC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/security/guards/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC;IAEtB;;;OAGG;IACH,WAAW,IAAI,eAAe,GAAG,SAAS,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,SAAS,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IAEjC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,IAAI,iBAAiB,CAAC;IAElC;;;OAGG;IACH,UAAU,IAAI,eAAe,CAAC;IAE9B;;;OAGG;IACH,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IAEjC;;;OAGG;IACH,UAAU,IAAI,QAAQ,CAAC;IAEvB;;;OAGG;IACH,aAAa,IAAI,MAAM,CAAC;IAExB;;;;OAIG;IACH,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAEpD;;;OAGG;IACH,OAAO,IAAI,OAAO,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAsC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAA8C,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAAqC,CAAC"}

package/dist/swagger/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/swagger/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAmB,MAAM,SAAS,CAAC;AAWhF;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAEtB,OAAO,EAAE,cAAc;IAI1C;;OAEG;IACI,QAAQ,IAAI,eAAe;IAgMlC;;;OAGG;IACI,gBAAgB,IAAI,MAAM;IAuFjC;;;OAGG;IACI,oBAAoB,IAAI,MAAM;IAKrC;;OAEG;IACH,OAAO,CAAC,aAAa;CAatB"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/swagger/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAmB,MAAM,SAAS,CAAC;AAYhF;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAEtB,OAAO,EAAE,cAAc;IAI1C;;OAEG;IACI,QAAQ,IAAI,eAAe;IAgMlC;;;OAGG;IACI,gBAAgB,IAAI,MAAM;IAuFjC;;;OAGG;IACI,oBAAoB,IAAI,MAAM;IAKrC;;OAEG;IACH,OAAO,CAAC,aAAa;CAatB"}

package/dist/websocket/registry.d.ts

@@ -1,4 +1,4 @@
-import type { ServerWebSocket } from 'bun';
+import type { IWebSocket } from '../platform/types';
 import { Context } from '../core/context';
 import type { Constructor } from '@/core/types';
 export interface WebSocketConnectionData {
@@ -44,8 +44,8 @@ export declare class WebSocketGatewayRegistry {
      * @param args - 原始参数（message, code, reason 等，不包括 ws）
      */
     private invokeHandler;
-    handleOpen(ws: ServerWebSocket<WebSocketConnectionData>): Promise<void>;
-    handleMessage(ws: ServerWebSocket<WebSocketConnectionData>, message: string | ArrayBuffer | ArrayBufferView): Promise<void>;
-    handleClose(ws: ServerWebSocket<WebSocketConnectionData>, code: number, reason: string): Promise<void>;
+    handleOpen(ws: IWebSocket<WebSocketConnectionData>): Promise<void>;
+    handleMessage(ws: IWebSocket<WebSocketConnectionData>, message: string | ArrayBuffer | ArrayBufferView | Buffer): Promise<void>;
+    handleClose(ws: IWebSocket<WebSocketConnectionData>, code: number, reason: string): Promise<void>;
 }
 //# sourceMappingURL=registry.d.ts.map

package/dist/websocket/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/websocket/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAO3C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAehD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAE3D,OAAO;WAIO,WAAW,IAAI,wBAAwB;IAOrD,OAAO,CAAC,MAAM,CAAC,SAAS;IAYjB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAoCzD;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAcjC,KAAK,IAAI,IAAI;IAMpB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAoBlB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;;;;;OAMG;YACW,aAAa;IA0Gd,UAAU,CAAC,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE,aAAa,CACxB,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,EAC5C,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAC9C,OAAO,CAAC,IAAI,CAAC;IAcH,WAAW,CACtB,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,EAC5C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;CAQjB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/websocket/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMpD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAehD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAE3D,OAAO;WAIO,WAAW,IAAI,wBAAwB;IAOrD,OAAO,CAAC,MAAM,CAAC,SAAS;IAYjB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAoCzD;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAcjC,KAAK,IAAI,IAAI;IAMpB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAoBlB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;;;;;OAMG;YACW,aAAa;IA0Gd,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAclE,aAAa,CACxB,EAAE,EAAE,UAAU,CAAC,uBAAuB,CAAC,EACvC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM,GACvD,OAAO,CAAC,IAAI,CAAC;IAcH,WAAW,CACtB,EAAE,EAAE,UAAU,CAAC,uBAAuB,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;CAQjB"}

package/docs/deployment.md

@@ -1,11 +1,13 @@
 # Production Deployment Guide
 
 This guide covers best practices for deploying Bun Server Framework applications
-to production.
+to production. The framework supports both **Bun** (optimal performance) and
+**Node.js 22+** runtimes — choose the one that fits your infrastructure.
 
 ## Table of Contents
 
 - [Prerequisites](#prerequisites)
+- [Runtime Selection](#runtime-selection)
 - [Environment Setup](#environment-setup)
 - [Configuration](#configuration)
 - [Process Management](#process-management)
@@ -16,23 +18,45 @@ to production.
 
 ## Prerequisites
 
-- Bun runtime (latest stable version)
-- Node.js 18+ (for compatibility)
-- Production-ready database (PostgreSQL, MySQL, etc.)
+- **Bun** >= 1.3.10 (Bun deployment) **or** **Node.js** >= 22.0.0 (Node.js deployment)
+- Production-ready database (PostgreSQL, MySQL, SQLite, etc.)
 - Reverse proxy (Nginx, Caddy, etc.)
 
+## Runtime Selection
+
+| Criteria | Bun | Node.js |
+|---|---|---|
+| Performance | Optimal (native APIs) | Good |
+| Ecosystem | Growing | Mature |
+| Docker image | `oven/bun` | `node:22-alpine` |
+| `idleTimeout` / `reusePort` | Supported | Not available |
+| Recommended for | New projects, latency-sensitive | Existing Node.js infra |
+
+The framework auto-detects the runtime at startup. See [Platform Guide](./platform.md) for details.
+
 ## Environment Setup
 
-### Install Bun
+### Option A — Bun Runtime
 
 ```bash
-# On Linux/macOS
+# Install Bun (Linux/macOS)
 curl -fsSL https://bun.sh/install | bash
 
-# Verify installation
+# Verify
 bun --version
 ```
 
+### Option B — Node.js Runtime
+
+```bash
+# Use Node.js 22+ (LTS)
+node --version  # should be v22+
+
+# Build TypeScript to JS
+bun build src/main.ts --target=node --outdir=dist
+# or: npx tsc
+```
+
 ### Set Environment Variables
 
 Create a `.env.production` file:

package/docs/idle-timeout.md

@@ -1,13 +1,15 @@
 # idleTimeout & SSE Keep-Alive
 
+> **Platform note:** `idleTimeout`, `reusePort`, and SSE TCP keepalive via `server.timeout` are **Bun-exclusive** features. On Node.js they are silently ignored. The `@IdleTimeout(ms)` decorator (handler-level timeout) works on both runtimes. See [Platform Guide](./platform.md#bun-exclusive-features) for the full list.
+
 ## Two layers of timeout
 
 Bun Server has **two independent timeout mechanisms** — understanding their difference is critical for SSE / streaming use cases.
 
-| Layer | Config | Scope | Mechanism |
-|-------|--------|-------|-----------|
-| **TCP connection** | `Application({ idleTimeout })` | Bun.serve level | Bun kernel closes the TCP socket when no bytes flow for N seconds |
-| **Handler logic** | `@IdleTimeout(ms)` decorator | Per-route `Promise.race` | Returns `408 Request Timeout` if the handler doesn't resolve in time |
+| Layer | Config | Scope | Mechanism | Bun | Node.js |
+|-------|--------|-------|-----------|-----|---------|
+| **TCP connection** | `Application({ idleTimeout })` | Bun.serve level | Bun kernel closes the TCP socket when no bytes flow for N seconds | Yes | Ignored |
+| **Handler logic** | `@IdleTimeout(ms)` decorator | Per-route `Promise.race` | Returns `408 Request Timeout` if the handler doesn't resolve in time | Yes | Yes |
 
 > **Key point:** For SSE responses the handler returns a `Response` immediately (with a streaming body). The handler-level `@IdleTimeout` has already resolved at that point and will **not** protect or kill the stream. Only the TCP-level `idleTimeout` can break an SSE connection.
 

package/docs/migration.md

@@ -4,6 +4,49 @@
 
 ---
 
+## v2.x → v3.0 (Platform Adapter)
+
+v3.0.0 introduces the **Platform Adapter Layer** enabling Node.js 22+ support alongside Bun.
+
+### Breaking Changes
+
+| Change | Before | After |
+|---|---|---|
+| `BunServer.getServer()` return type | `Bun.Server \| undefined` | `IServerHandle \| undefined` |
+| `WsArgumentsHost.getClient()` return type | `ServerWebSocket<T>` | `IWebSocket<T>` |
+
+### Migration Steps
+
+**1. Update WebSocket guard types**
+
+```typescript
+// Before
+import type { ServerWebSocket } from 'bun';
+getClient(): ServerWebSocket<unknown>
+
+// After
+import type { IWebSocket } from '@dangao/bun-server';
+getClient(): IWebSocket<unknown>
+```
+
+**2. Update server handle access**
+
+```typescript
+// Before
+const server: Bun.Server | undefined = app.getServer();
+
+// After
+import type { IServerHandle } from '@dangao/bun-server';
+const server: IServerHandle | undefined = app.getServer();
+// Raw native access (not recommended):
+const native: unknown = app.getNativeServer();
+```
+
+**3. Everything else is backward compatible.**
+Database configuration, module APIs, controllers, services, and middleware require no changes.
+
+---
+
 ## v1.x → v2.0
 
 v2.0.0 is **fully backward compatible** with v1.x. All existing modules, APIs, and patterns continue to work without changes.