@dangao/bun-server 3.0.3 → 3.0.5

package/dist/core/cluster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cluster.d.ts","sourceRoot":"","sources":["../../src/core/cluster.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAS;gBAER,OAAO,EAAE;QAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,WAAW,CAAC;KACpB;IAWD;;OAEG;IACI,OAAO,IAAI,WAAW,GAAG,OAAO;IAIvC;;;;;OAKG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuClC,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,uBAAuB;YAiBjB,UAAU;IA4BxB,OAAO,CAAC,gBAAgB;YAkBV,oBAAoB;YA4BpB,gBAAgB;IA2B9B,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;WACW,QAAQ,IAAI,OAAO;IAIjC;;OAEG;WACW,WAAW,IAAI,MAAM;IAInC;;;OAGG;WACW,cAAc,IAAI,WAAW,GAAG,OAAO,GAAG,IAAI;CAI7D"}
+{"version":3,"file":"cluster.d.ts","sourceRoot":"","sources":["../../src/core/cluster.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAS;gBAER,OAAO,EAAE;QAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,WAAW,CAAC;KACpB;IAWD;;OAEG;IACI,OAAO,IAAI,WAAW,GAAG,OAAO;IAIvC;;;;;OAKG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuClC,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,uBAAuB;YAiBjB,UAAU;IA6BxB,OAAO,CAAC,gBAAgB;YAkBV,oBAAoB;YA4BpB,gBAAgB;IA2B9B,OAAO,CAAC,mBAAmB;IAoC3B;;OAEG;WACW,QAAQ,IAAI,OAAO;IAIjC;;OAEG;WACW,WAAW,IAAI,MAAM;IAInC;;;OAGG;WACW,cAAc,IAAI,WAAW,GAAG,OAAO,GAAG,IAAI;CAI7D"}

package/dist/database/connection-pool.d.ts

@@ -22,6 +22,16 @@ export declare class ConnectionPool {
      * 关闭连接池
      */
     close(): Promise<void>;
+    /**
+     * 获取连接并返回 Disposable 对象，支持 `await using` 语法（Bun 1.3.12+ / TC39 Explicit Resource Management）
+     *
+     * @example
+     * await using { connection } = await pool.acquireDisposable();
+     * // 作用域结束时自动调用 release，无需手动释放
+     */
+    acquireDisposable(): Promise<{
+        connection: unknown;
+    } & Disposable>;
     /**
      * 获取池状态信息
      */

package/dist/database/connection-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-pool.d.ts","sourceRoot":"","sources":["../../src/database/connection-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,cAAc,EAEf,MAAM,SAAS,CAAC;AAyBjB;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,kBAAkB,CAAoC;IAC9D,OAAO,CAAC,SAAS,CAAS;gBAGxB,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,qBAA0B;IAWrC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IA8BxC;;OAEG;IACI,OAAO,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAUzC;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBnC;;OAEG;IACI,YAAY,IAAI;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;KACxB;IAUD;;OAEG;YACW,gBAAgB;IAY9B;;OAEG;YACW,yBAAyB;IAuBvC;;OAEG;YACW,sBAAsB;IAqBpC;;OAEG;YACW,wBAAwB;IAoBtC;;OAEG;YACW,qBAAqB;IA0BnC;;OAEG;YACW,eAAe;IAW7B;;OAEG;YACW,qBAAqB;IAWnC;;OAEG;YACW,uBAAuB;IAarC;;OAEG;YACW,oBAAoB;IAalC;;OAEG;YACW,iBAAiB;IAoB/B;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}
+{"version":3,"file":"connection-pool.d.ts","sourceRoot":"","sources":["../../src/database/connection-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,cAAc,EAEf,MAAM,SAAS,CAAC;AAyBjB;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,kBAAkB,CAAoC;IAC9D,OAAO,CAAC,SAAS,CAAS;gBAGxB,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,qBAA0B;IAWrC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IA8BxC;;OAEG;IACI,OAAO,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAUzC;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBnC;;;;;;OAMG;IACU,iBAAiB,IAAI,OAAO,CAAC;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,GAAG,UAAU,CAAC;IAQ/E;;OAEG;IACI,YAAY,IAAI;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;KACxB;IAUD;;OAEG;YACW,gBAAgB;IAY9B;;OAEG;YACW,yBAAyB;IAuBvC;;OAEG;YACW,sBAAsB;IAqBpC;;OAEG;YACW,wBAAwB;IAoBtC;;OAEG;YACW,qBAAqB;IA0BnC;;OAEG;YACW,eAAe;IAW7B;;OAEG;YACW,qBAAqB;IAWnC;;OAEG;YACW,uBAAuB;IAarC;;OAEG;YACW,oBAAoB;IAalC;;OAEG;YACW,iBAAiB;IAoB/B;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}

package/dist/index.js

@@ -196,6 +196,9 @@ var init_parser = __esm(() => {
     },
     renderMarkdown(md) {
       return Bun.markdown.html(md, { headings: true });
+    },
+    renderMarkdownAnsi(md) {
+      return Bun.markdown.ansi(md);
     }
   };
 });
@@ -12548,6 +12551,10 @@ var init_parser2 = __esm(() => {
       const { marked: markedSync } = (init_marked_esm(), __toCommonJS(exports_marked_esm));
       markedSync.setOptions({ async: false });
       return markedSync(md);
+    },
+    renderMarkdownAnsi(md) {
+      const html = this.renderMarkdown(md);
+      return html.replace(/<[^>]+>/g, "");
     }
   };
 });
@@ -12704,7 +12711,10 @@ function setupWebSocket(httpServer, handlers) {
     throw new Error(`[bun-server] WebSocket on Node.js requires the ws package.
 ` + "Install it with: bun add ws");
   }
-  const { WebSocketServer } = wsModule;
+  const WebSocketServer = wsModule.WebSocketServer ?? wsModule.default?.WebSocketServer ?? wsModule.Server;
+  if (!WebSocketServer) {
+    throw new Error("[bun-server] Could not find WebSocketServer in the ws module. " + "Please ensure ws >= 7.5.0 is installed.");
+  }
   const wss = new WebSocketServer({ noServer: true });
   httpServer.on("upgrade", (request, socket, head) => {
     wss.handleUpgrade(request, socket, head, (ws) => {
@@ -46064,6 +46074,13 @@ class ConnectionPool {
     this.connections = [];
     this.isClosing = false;
   }
+  async acquireDisposable() {
+    const connection2 = await this.acquire();
+    return {
+      connection: connection2,
+      [Symbol.dispose]: () => this.release(connection2)
+    };
+  }
   getPoolStats() {
     const inUse = this.connections.filter((conn) => conn.inUse).length;
     return {
@@ -48282,6 +48299,7 @@ var QUEUE_SERVICE_TOKEN = Symbol("@dangao/bun-server:queue:service");
 var QUEUE_OPTIONS_TOKEN = Symbol("@dangao/bun-server:queue:options");
 
 // src/queue/service.ts
+init_runtime();
 class QueueService {
   store;
   defaultQueue;
@@ -48340,12 +48358,19 @@ class QueueService {
     if (options.runOnInit) {
       await this.add(jobName, {}, undefined, queue);
     }
-    const interval = this.parseCronInterval(options.pattern);
-    if (interval > 0) {
-      const timer2 = setInterval(async () => {
+    if (getRuntime().engine === "bun") {
+      const job = Bun.cron(options.pattern, async () => {
         await this.add(jobName, {}, undefined, queue);
-      }, interval);
-      this.cronTimers.set(key, timer2);
+      });
+      this.cronTimers.set(key, job);
+    } else {
+      const interval = this.parseCronInterval(options.pattern);
+      if (interval > 0) {
+        const timer2 = setInterval(async () => {
+          await this.add(jobName, {}, undefined, queue);
+        }, interval);
+        this.cronTimers.set(key, timer2);
+      }
     }
   }
   startWorker(queueName) {
@@ -48405,8 +48430,12 @@ class QueueService {
     return -1;
   }
   destroy() {
-    for (const timer2 of this.cronTimers.values()) {
-      clearInterval(timer2);
+    for (const handle of this.cronTimers.values()) {
+      if (handle && typeof handle === "object" && "stop" in handle) {
+        handle.stop();
+      } else {
+        clearInterval(handle);
+      }
     }
     this.cronTimers.clear();
     this.cronJobs.clear();

package/dist/index.node.mjs

@@ -199,6 +199,9 @@ var init_parser = __esm(() => {
     },
     renderMarkdown(md) {
       return Bun.markdown.html(md, { headings: true });
+    },
+    renderMarkdownAnsi(md) {
+      return Bun.markdown.ansi(md);
     }
   };
 });
@@ -509,6 +512,10 @@ var init_parser2 = __esm(() => {
       const { marked: markedSync } = __require("marked");
       markedSync.setOptions({ async: false });
       return markedSync(md);
+    },
+    renderMarkdownAnsi(md) {
+      const html = this.renderMarkdown(md);
+      return html.replace(/<[^>]+>/g, "");
     }
   };
 });
@@ -665,7 +672,10 @@ function setupWebSocket(httpServer, handlers) {
     throw new Error(`[bun-server] WebSocket on Node.js requires the ws package.
 ` + "Install it with: bun add ws");
   }
-  const { WebSocketServer } = wsModule;
+  const WebSocketServer = wsModule.WebSocketServer ?? wsModule.default?.WebSocketServer ?? wsModule.Server;
+  if (!WebSocketServer) {
+    throw new Error("[bun-server] Could not find WebSocketServer in the ws module. " + "Please ensure ws >= 7.5.0 is installed.");
+  }
   const wss = new WebSocketServer({ noServer: true });
   httpServer.on("upgrade", (request, socket, head) => {
     wss.handleUpgrade(request, socket, head, (ws) => {
@@ -10895,6 +10905,13 @@ class ConnectionPool {
     this.connections = [];
     this.isClosing = false;
   }
+  async acquireDisposable() {
+    const connection = await this.acquire();
+    return {
+      connection,
+      [Symbol.dispose]: () => this.release(connection)
+    };
+  }
   getPoolStats() {
     const inUse = this.connections.filter((conn) => conn.inUse).length;
     return {
@@ -13113,6 +13130,7 @@ var QUEUE_SERVICE_TOKEN = Symbol("@dangao/bun-server:queue:service");
 var QUEUE_OPTIONS_TOKEN = Symbol("@dangao/bun-server:queue:options");
 
 // src/queue/service.ts
+init_runtime();
 class QueueService {
   store;
   defaultQueue;
@@ -13171,12 +13189,19 @@ class QueueService {
     if (options.runOnInit) {
       await this.add(jobName, {}, undefined, queue);
     }
-    const interval = this.parseCronInterval(options.pattern);
-    if (interval > 0) {
-      const timer = setInterval(async () => {
+    if (getRuntime().engine === "bun") {
+      const job = Bun.cron(options.pattern, async () => {
         await this.add(jobName, {}, undefined, queue);
-      }, interval);
-      this.cronTimers.set(key, timer);
+      });
+      this.cronTimers.set(key, job);
+    } else {
+      const interval = this.parseCronInterval(options.pattern);
+      if (interval > 0) {
+        const timer = setInterval(async () => {
+          await this.add(jobName, {}, undefined, queue);
+        }, interval);
+        this.cronTimers.set(key, timer);
+      }
     }
   }
   startWorker(queueName) {
@@ -13236,8 +13261,12 @@ class QueueService {
     return -1;
   }
   destroy() {
-    for (const timer of this.cronTimers.values()) {
-      clearInterval(timer);
+    for (const handle of this.cronTimers.values()) {
+      if (handle && typeof handle === "object" && "stop" in handle) {
+        handle.stop();
+      } else {
+        clearInterval(handle);
+      }
     }
     this.cronTimers.clear();
     this.cronJobs.clear();

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

@@ -1 +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"}
+{"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,cAoB9B,CAAC"}

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

@@ -1 +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"}
+{"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,cAqC/B,CAAC"}

package/dist/platform/types.d.ts

@@ -48,6 +48,8 @@ export interface IParserAdapter {
     parseJSON5(content: string): unknown;
     parseJSONL(content: string): unknown[];
     renderMarkdown(md: string): string;
+    /** 将 Markdown 渲染为 ANSI 着色字符串，用于终端 / CLI 输出（Bun 1.3.12+） */
+    renderMarkdownAnsi(md: string): string;
 }
 /**
  * 子进程接口

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/platform/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7B,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,gDAAgD;IAChD,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa;IACb,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,WAAW;IACX,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,aAAa;IACb,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;IACzD,MAAM,IAAI,UAAU,CAAC;IACrB,MAAM,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IACvC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACvC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAAC;IAC5C,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IACzG,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,IAAI,IAAI,CAAC;IACb,gCAAgC;IAChC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;IAClE,qBAAqB;IACrB,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,mCAAmC;IACnC,SAAS,IAAI,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC1E;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/platform/types.ts"],"names":[],"mappings":"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"}

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

@@ -1 +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"}
+{"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;AAIjB;;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,CAA6E;gBAE/C,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;IA6BhB;;;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;CAYvB"}

package/package.json

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

package/src/core/cluster.ts

@@ -186,7 +186,8 @@ export class ClusterManager {
     );
 
     this.socketDir = join(tmpdir(), `bun-cluster-${process.pid}`);
-    // Clean up stale directory from a previous run with the same PID
+    // Bun 1.3.12+：绑定已存在的 unix socket 会正确抛出 EADDRINUSE（不再静默覆盖），
+    // 因此必须在启动前清理同 PID 上一次运行遗留的目录。
     try { rmSync(this.socketDir, { recursive: true, force: true }); } catch (_error) { /* ignore */ }
     mkdirSync(this.socketDir, { recursive: true });
 
@@ -291,6 +292,9 @@ export class ClusterManager {
           );
 
           const socketPath = this.socketPaths[index]!;
+          // Bun 1.3.12+：worker 正常退出时 Bun.serve stop() 会自动删除 socket 文件；
+          // 但崩溃（SIGKILL / 异常退出）时 stop() 不会被调用，socket 文件仍残留，
+          // 此处手动清理确保新 worker 能成功绑定（否则会得到 EADDRINUSE）。
           try { rmSync(socketPath); } catch (_error) { /* ignore */ }
 
           this.workers[index] = this.spawnProxyWorker(index, socketPath);

package/src/database/connection-pool.ts

@@ -116,6 +116,21 @@ export class ConnectionPool {
     this.isClosing = false;
   }
 
+  /**
+   * 获取连接并返回 Disposable 对象，支持 `await using` 语法（Bun 1.3.12+ / TC39 Explicit Resource Management）
+   *
+   * @example
+   * await using { connection } = await pool.acquireDisposable();
+   * // 作用域结束时自动调用 release，无需手动释放
+   */
+  public async acquireDisposable(): Promise<{ connection: unknown } & Disposable> {
+    const connection = await this.acquire();
+    return {
+      connection,
+      [Symbol.dispose]: () => this.release(connection),
+    };
+  }
+
   /**
    * 获取池状态信息
    */

package/src/platform/bun/parser.ts

@@ -16,4 +16,8 @@ export const bunParserAdapter: IParserAdapter = {
   renderMarkdown(md: string): string {
     return Bun.markdown.html(md, { headings: true });
   },
+
+  renderMarkdownAnsi(md: string): string {
+    return Bun.markdown.ansi(md);
+  },
 };

package/src/platform/node/http.ts

@@ -178,8 +178,19 @@ function setupWebSocket<T>(
       'Install it with: bun add ws',
     );
   }
-  const { WebSocketServer } = wsModule;
-  const wss = new WebSocketServer({ noServer: true });
+  // Handle CJS (WebSocketServer as class property) and ESM interop (named export)
+  // Also falls back to .Server for ws < 7.5.0
+  const WebSocketServer =
+    (wsModule as unknown as Record<string, unknown>).WebSocketServer ??
+    (wsModule as unknown as { default?: Record<string, unknown> }).default?.WebSocketServer ??
+    (wsModule as unknown as Record<string, unknown>).Server;
+  if (!WebSocketServer) {
+    throw new Error(
+      '[bun-server] Could not find WebSocketServer in the ws module. ' +
+      'Please ensure ws >= 7.5.0 is installed.',
+    );
+  }
+  const wss = new (WebSocketServer as new (opts: unknown) => import('ws').WebSocketServer)({ noServer: true });
 
   httpServer.on('upgrade', (request, socket, head) => {
     wss.handleUpgrade(request, socket, head, (ws) => {

package/src/platform/node/parser.ts

@@ -31,4 +31,10 @@ export const nodeParserAdapter: IParserAdapter = {
     markedSync.setOptions({ async: false });
     return markedSync(md) as string;
   },
+
+  renderMarkdownAnsi(md: string): string {
+    // Node.js 平台无 Bun.markdown.ansi()，降级为纯文本（去除 HTML 标签）
+    const html = this.renderMarkdown(md);
+    return html.replace(/<[^>]+>/g, '');
+  },
 };

package/src/platform/types.ts

@@ -53,6 +53,8 @@ export interface IParserAdapter {
   parseJSON5(content: string): unknown;
   parseJSONL(content: string): unknown[];
   renderMarkdown(md: string): string;
+  /** 将 Markdown 渲染为 ANSI 着色字符串，用于终端 / CLI 输出（Bun 1.3.12+） */
+  renderMarkdownAnsi(md: string): string;
 }
 
 /**

package/src/queue/service.ts

@@ -10,6 +10,7 @@ import type {
   CronOptions,
 } from './types';
 import { QUEUE_OPTIONS_TOKEN } from './types';
+import { getRuntime } from '../platform/runtime';
 
 /**
  * 队列服务
@@ -23,7 +24,7 @@ export class QueueService {
   private workers: Map<string, Set<Promise<void>>> = new Map();
   private cronJobs: Map<string, { handler: JobHandler; options: CronOptions }> =
     new Map();
-  private cronTimers: Map<string, ReturnType<typeof setInterval>> = new Map();
+  private cronTimers: Map<string, ReturnType<typeof setInterval> | { stop(): void }> = new Map();
 
   public constructor(@Inject(QUEUE_OPTIONS_TOKEN) options: QueueModuleOptions) {
     this.store = options.store!;
@@ -158,14 +159,21 @@ export class QueueService {
       await this.add(jobName, {} as T, undefined, queue);
     }
 
-    // 解析 Cron 表达式并设置定时器
-    // 注意：这里简化实现，实际应该使用 cron 解析库
-    const interval = this.parseCronInterval(options.pattern);
-    if (interval > 0) {
-      const timer = setInterval(async () => {
+    if (getRuntime().engine === 'bun') {
+      // Bun 平台：使用原生 Bun.cron() —— 支持完整 cron 表达式、无重叠、--hot 安全、UTC 调度
+      const job = (Bun as any).cron(options.pattern, async () => {
         await this.add(jobName, {} as T, undefined, queue);
-      }, interval);
-      this.cronTimers.set(key, timer);
+      });
+      this.cronTimers.set(key, job);
+    } else {
+      // Node.js 平台兜底：简化实现，仅支持基础 cron 格式
+      const interval = this.parseCronInterval(options.pattern);
+      if (interval > 0) {
+        const timer = setInterval(async () => {
+          await this.add(jobName, {} as T, undefined, queue);
+        }, interval);
+        this.cronTimers.set(key, timer);
+      }
     }
   }
 
@@ -291,9 +299,12 @@ export class QueueService {
    * 销毁服务，清理资源
    */
   public destroy(): void {
-    // 清理所有定时器
-    for (const timer of this.cronTimers.values()) {
-      clearInterval(timer);
+    for (const handle of this.cronTimers.values()) {
+      if (handle && typeof handle === 'object' && 'stop' in handle) {
+        (handle as { stop(): void }).stop();
+      } else {
+        clearInterval(handle as ReturnType<typeof setInterval>);
+      }
     }
     this.cronTimers.clear();
     this.cronJobs.clear();

package/src/types/bun-augment.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Bun v1.3.12 新增 API 的类型补全
+ * 待 @types/bun 升级至对应版本后可删除此文件
+ */
+declare module 'bun' {
+  namespace markdown {
+    /**
+     * 将 Markdown 字符串渲染为带 ANSI 转义码的彩色终端文本（Bun 1.3.12+）
+     */
+    function ansi(
+      input: string,
+      options?: {
+        /** 是否输出 ANSI 颜色转义码，默认 true */
+        colors?: boolean;
+        /** 是否输出可点击超链接（OSC 8），默认 false */
+        hyperlinks?: boolean;
+        /** 文本换行列宽，默认终端宽度 */
+        columns?: number;
+        /** 是否通过 Kitty Graphics Protocol 内联图片，默认 false */
+        kittyGraphics?: boolean;
+      },
+    ): string;
+  }
+}

package/tests/database/sqlite-adapter.test.ts

@@ -1,6 +1,11 @@
-import { describe, expect, test } from 'bun:test';
+import { beforeAll, describe, expect, test } from 'bun:test';
 
 import { Semaphore, SqliteAdapter } from '../../src/database/sqlite-adapter';
+import { initRuntime } from '../../src/platform/runtime';
+
+beforeAll(() => {
+  initRuntime();
+});
 
 describe('SqliteAdapter', () => {
   test('should execute query and write', async () => {
@@ -15,7 +20,7 @@ describe('SqliteAdapter', () => {
     );
     await adapter.execute('INSERT INTO users (name) VALUES (?)', ['alice']);
 
-    const rows = adapter.query<{ id: number; name: string }>(
+    const rows = await adapter.query<{ id: number; name: string }>(
       'SELECT * FROM users',
     );
     expect(rows.length).toBe(1);