@dangao/bun-server 2.2.0 → 2.3.0

package/dist/ai/providers/anthropic-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/anthropic-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,iBAAkB,YAAW,WAAW;IACnD,SAAgB,IAAI,eAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAEvB,MAAM,EAAE,uBAAuB;IAOrC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IA+DvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IA8EtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;YAInC,IAAI;CAiBnB"}
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/anthropic-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,iBAAkB,YAAW,WAAW;IACnD,SAAgB,IAAI,eAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAEvB,MAAM,EAAE,uBAAuB;IAOrC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IA+DvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IAgFtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;YAInC,IAAI;CAkBnB"}

package/dist/ai/providers/google-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/google-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAEd,MAAM,EAAE,oBAAoB;IAMlC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAoEvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IAkEtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;IAIjD,OAAO,CAAC,gBAAgB;CAiBzB"}
+{"version":3,"file":"google-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/google-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAEd,MAAM,EAAE,oBAAoB;IAMlC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAqEvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IAoEtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;IAIjD,OAAO,CAAC,gBAAgB;CAiBzB"}

package/dist/ai/providers/ollama-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ollama-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/ollama-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAEnB,MAAM,GAAE,oBAAyB;IAKvC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAuCvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IA+DtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;CAGlD"}
+{"version":3,"file":"ollama-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/ollama-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAEnB,MAAM,GAAE,oBAAyB;IAKvC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAwCvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IAiEtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;CAGlD"}

package/dist/ai/providers/openai-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/openai-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAwCD,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoD;gBAEzD,MAAM,EAAE,oBAAoB;IAOlC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IA4CvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IA+EtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;YAKnC,IAAI;IA4BlB,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,YAAY;CAKrB"}
+{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/openai-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAwCD,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoD;gBAEzD,MAAM,EAAE,oBAAoB;IAOlC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IA4CvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IAiFtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;YAKnC,IAAI;IA6BlB,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,YAAY;CAKrB"}

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

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/ai/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,eAAe,EACf,SAAS,EACV,MAAM,SAAS,CAAC;AAIjB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D;;;GAGG;AACH,qBACa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAA6B;gBAGd,OAAO,EAAE,eAAe;IAY3D;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIpD;;OAEG;IACU,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IA8B9D;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IAK7D;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;IAKjD;;OAEG;IACI,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW;IAU9C;;OAEG;IACI,gBAAgB,IAAI,MAAM,EAAE;YAIrB,cAAc;IA+B5B,OAAO,CAAC,WAAW;CASpB"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/ai/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,eAAe,EACf,SAAS,EACV,MAAM,SAAS,CAAC;AAIjB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D;;;GAGG;AACH,qBACa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAA6B;gBAGd,OAAO,EAAE,eAAe;IAY3D;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIpD;;OAEG;IACU,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IA8B9D;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IAK7D;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;IAKjD;;OAEG;IACI,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW;IAU9C;;OAEG;IACI,gBAAgB,IAAI,MAAM,EAAE;YAIrB,cAAc;IA+B5B,OAAO,CAAC,WAAW;CAqBpB"}

package/dist/ai/types.d.ts

@@ -41,6 +41,11 @@ export interface AiRequest {
     tools?: AiToolDefinition[];
     /** Provider name override */
     provider?: string;
+    /**
+     * Abort signal — pass `ctx.signal` to cascade client disconnection
+     * to the upstream AI API, stopping token consumption immediately.
+     */
+    signal?: AbortSignal;
 }
 /**
  * Non-streaming AI response

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACvD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC3C,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC,KAAK,WAAW,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC;IACV,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,KAAK,CAAC,EAAE;QACN,gDAAgD;QAChD,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,2CAA2C;QAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,eAAO,MAAM,gBAAgB,eAA0C,CAAC;AACxE,eAAO,MAAM,uBAAuB,eAA0C,CAAC;AAC/E,eAAO,MAAM,sBAAsB,eAAgD,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,oBAAoB,+BAA+B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"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"}

package/dist/core/application.d.ts

@@ -37,6 +37,23 @@ export interface ApplicationOptions {
      * 框架内部会自动转换为 Bun.serve 的秒单位
      */
     idleTimeout?: number;
+    /**
+     * SSE 保活配置
+     *
+     * 框架自动检测 `Content-Type: text/event-stream` 的响应，
+     * 对该请求禁用 Bun TCP 空闲超时（`server.timeout(req, 0)`），
+     * 并按配置间隔向客户端发送 SSE 注释心跳（`: keepalive\n\n`）。
+     *
+     * 心跳可防止中间代理（nginx / 云 LB）因空闲而断开连接。
+     *
+     * @default `{ enabled: true, intervalMs: 15000 }`
+     */
+    sseKeepAlive?: {
+        /** 是否启用，默认 true */
+        enabled?: boolean;
+        /** 心跳间隔（毫秒），默认 15000 */
+        intervalMs?: number;
+    };
 }
 /**
  * 应用主类

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

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/core/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,UAAU,CAAC;AAMzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAW3C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,uBAAuB,CAAkB;gBAE9B,OAAO,GAAE,kBAAuB;IA6BnD;;;OAGG;IACI,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIxC;;OAEG;IACU,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDpE;;OAEG;YACW,oBAAoB;IAqBlC;;;OAGG;YACW,sBAAsB;IAyBpC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBlC;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB9D;;OAEG;YACW,eAAe;IAkB7B;;;;OAIG;YACW,aAAa;IAsD3B;;;OAGG;IACI,kBAAkB,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAKtE;;;OAGG;IACI,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAqBrD;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAc1C;;;OAGG;IACI,wBAAwB,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAIzE;;;OAGG;IACI,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAK/D;;;OAGG;IACI,SAAS,IAAI,SAAS,GAAG,SAAS;IAIzC;;;OAGG;YACW,gBAAgB;IA0C9B;;;OAGG;YACW,kBAAkB;IAgDhC;;;OAGG;IACI,YAAY;IAInB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAS7B"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/core/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,UAAU,CAAC;AAMzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAW3C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE;QACb,mBAAmB;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,wBAAwB;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,uBAAuB,CAAkB;gBAE9B,OAAO,GAAE,kBAAuB;IA6BnD;;;OAGG;IACI,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIxC;;OAEG;IACU,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDpE;;OAEG;YACW,oBAAoB;IAqBlC;;;OAGG;YACW,sBAAsB;IAyBpC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBlC;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB9D;;OAEG;YACW,eAAe;IAkB7B;;;;OAIG;YACW,aAAa;IAsD3B;;;OAGG;IACI,kBAAkB,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAKtE;;;OAGG;IACI,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAqBrD;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAc1C;;;OAGG;IACI,wBAAwB,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAIzE;;;OAGG;IACI,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAK/D;;;OAGG;IACI,SAAS,IAAI,SAAS,GAAG,SAAS;IAIzC;;;OAGG;YACW,gBAAgB;IA0C9B;;;OAGG;YACW,kBAAkB;IAgDhC;;;OAGG;IACI,YAAY;IAInB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAS7B"}

package/dist/core/context.d.ts

@@ -58,6 +58,11 @@ export declare class Context {
      * 是否已解析请求体
      */
     private _bodyParsed;
+    /**
+     * 客户端断连信号
+     * 当客户端主动关闭连接时 abort，可用于级联取消内部请求
+     */
+    readonly signal: AbortSignal;
     constructor(request: Request);
     /**
      * 获取请求体（自动解析）

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,KAAK,eAAe,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAEhD;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAwC;IACnF;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACI,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAE3B;;OAEG;IACH,SAAgB,GAAG,EAAE,GAAG,CAAC;IAEzB;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,KAAK,EAAE,eAAe,CAAC;IAEvC;;OAEG;IACI,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAE3C;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACI,eAAe,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACI,UAAU,EAAE,MAAM,CAAO;IAEhC;;OAEG;IACI,KAAK,EAAE,gBAAgB,EAAE,CAAM;IAEtC;;OAEG;IACH,OAAO,CAAC,KAAK,CAAC,CAAU;IAExB;;OAEG;IACH,OAAO,CAAC,WAAW,CAAkB;gBAElB,OAAO,EAAE,OAAO;IAUnC;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAQxC;;;OAGG;IACH,IAAW,IAAI,IAAI,OAAO,CAEzB;IAED;;;OAGG;IACH,IAAW,IAAI,CAAC,IAAI,EAAE,OAAO,EAG5B;IAED;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI3C;;;OAGG;IACI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ5C;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIhD;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI5C;;;;OAIG;IACI,WAAW,IAAI,MAAM;IAmB5B;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlD;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;;OAKG;IACI,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ;IA4BpE;;;;;OAKG;IACI,mBAAmB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ;IAWzE,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,aAAa;CAqCtB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,KAAK,eAAe,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAEhD;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAwC;IACnF;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACI,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAE3B;;OAEG;IACH,SAAgB,GAAG,EAAE,GAAG,CAAC;IAEzB;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,KAAK,EAAE,eAAe,CAAC;IAEvC;;OAEG;IACI,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAE3C;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACI,eAAe,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACI,UAAU,EAAE,MAAM,CAAO;IAEhC;;OAEG;IACI,KAAK,EAAE,gBAAgB,EAAE,CAAM;IAEtC;;OAEG;IACH,OAAO,CAAC,KAAK,CAAC,CAAU;IAExB;;OAEG;IACH,OAAO,CAAC,WAAW,CAAkB;IAErC;;;OAGG;IACH,SAAgB,MAAM,EAAE,WAAW,CAAC;gBAEjB,OAAO,EAAE,OAAO;IAWnC;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAQxC;;;OAGG;IACH,IAAW,IAAI,IAAI,OAAO,CAEzB;IAED;;;OAGG;IACH,IAAW,IAAI,CAAC,IAAI,EAAE,OAAO,EAG5B;IAED;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI3C;;;OAGG;IACI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ5C;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIhD;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI5C;;;;OAIG;IACI,WAAW,IAAI,MAAM;IAmB5B;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlD;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;;OAKG;IACI,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ;IA4BpE;;;;;OAKG;IACI,mBAAmB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ;IAWzE,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,aAAa;CAqCtB"}

package/dist/core/server.d.ts

@@ -39,6 +39,14 @@ export interface ServerOptions {
      * 框架内部会转换为 Bun.serve 所需的秒
      */
     idleTimeout?: number;
+    /**
+     * SSE 保活配置
+     * @see ApplicationOptions.sseKeepAlive
+     */
+    sseKeepAlive?: {
+        enabled?: boolean;
+        intervalMs?: number;
+    };
 }
 /**
  * 服务器封装类
@@ -94,5 +102,14 @@ export declare class BunServer {
      * 获取服务器主机名
      */
     getHostname(): string | undefined;
+    /**
+     * 将 SSE Response 的 body 包裹一层心跳注入流。
+     *
+     * 原始流的数据原样透传；在数据间隙中按 intervalMs 发送
+     * SSE 注释帧 `: keepalive\n\n`（客户端会忽略注释帧）。
+     *
+     * 当 signal abort / 原始流结束 / 客户端断连时自动清理定时器。
+     */
+    private static wrapSseWithHeartbeat;
 }
 //# sourceMappingURL=server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1D;;OAEG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAE7C;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAgB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAa;gBAElB,OAAO,EAAE,aAAa;IAIzC;;OAEG;IACI,KAAK,IAAI,IAAI;IAsHpB;;OAEG;IACI,IAAI,IAAI,IAAI;IAWnB;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C9D;;OAEG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACI,mBAAmB,IAAI,OAAO;IAIrC;;;OAGG;IACI,SAAS,IAAI,MAAM,CAAC,uBAAuB,CAAC,GAAG,SAAS;IAI/D;;;OAGG;IACI,SAAS,IAAI,OAAO;IAI3B;;;OAGG;IACI,OAAO,IAAI,MAAM;IAOxB;;OAEG;IACI,WAAW,IAAI,MAAM,GAAG,SAAS;CAGzC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1D;;OAEG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAE7C;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE;QACb,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAgB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAa;gBAElB,OAAO,EAAE,aAAa;IAIzC;;OAEG;IACI,KAAK,IAAI,IAAI;IAkJpB;;OAEG;IACI,IAAI,IAAI,IAAI;IAWnB;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C9D;;OAEG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACI,mBAAmB,IAAI,OAAO;IAIrC;;;OAGG;IACI,SAAS,IAAI,MAAM,CAAC,uBAAuB,CAAC,GAAG,SAAS;IAI/D;;;OAGG;IACI,SAAS,IAAI,OAAO;IAI3B;;;OAGG;IACI,OAAO,IAAI,MAAM;IAOxB;;OAEG;IACI,WAAW,IAAI,MAAM,GAAG,SAAS;IAIxC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAyDpC"}

package/dist/index.js

@@ -4154,6 +4154,7 @@ class Context {
   files = [];
   _body;
   _bodyParsed = false;
+  signal;
   constructor(request) {
     this.request = request;
     this.url = new URL2(request.url);
@@ -4162,6 +4163,7 @@ class Context {
     this.query = this.url.searchParams;
     this.headers = request.headers;
     this.responseHeaders = new Headers;
+    this.signal = request.signal;
   }
   async getBody() {
     if (!this._bodyParsed) {
@@ -4307,7 +4309,27 @@ class BunServer {
     this.isShuttingDown = false;
     this.shutdownPromise = undefined;
     this.shutdownResolve = undefined;
-    const fetchHandler = (request, server) => {
+    const sseKeepAlive = this.options.sseKeepAlive;
+    const sseHeartbeatEnabled = sseKeepAlive?.enabled !== false;
+    const sseHeartbeatIntervalMs = sseKeepAlive?.intervalMs ?? 15000;
+    const postProcessSse = (response, request, bunServer) => {
+      const ct = response.headers.get("content-type");
+      if (!ct?.includes("text/event-stream")) {
+        return response;
+      }
+      bunServer.timeout(request, 0);
+      if (sseHeartbeatEnabled && response.body) {
+        return BunServer.wrapSseWithHeartbeat(response, sseHeartbeatIntervalMs, request.signal);
+      }
+      return response;
+    };
+    const decrementAndMaybeShutdown = () => {
+      this.activeRequests--;
+      if (this.isShuttingDown && this.activeRequests === 0 && this.shutdownResolve) {
+        this.shutdownResolve();
+      }
+    };
+    const fetchHandler = (request, bunServer) => {
       if (this.isShuttingDown) {
         return new Response("Server is shutting down", { status: 503 });
       }
@@ -4319,7 +4341,7 @@ class BunServer {
         }
         const context2 = new Context(request);
         const queryParams = new URLSearchParams(url.searchParams);
-        const upgraded = server.upgrade(request, {
+        const upgraded = bunServer.upgrade(request, {
           data: {
             path: url.pathname,
             query: queryParams,
@@ -4335,19 +4357,12 @@ class BunServer {
       const context = new Context(request);
       const responsePromise = this.options.fetch(context);
       if (responsePromise instanceof Promise) {
-        responsePromise.finally(() => {
-          this.activeRequests--;
-          if (this.isShuttingDown && this.activeRequests === 0 && this.shutdownResolve) {
-            this.shutdownResolve();
-          }
-        }).catch(() => {});
-      } else {
-        this.activeRequests--;
-        if (this.isShuttingDown && this.activeRequests === 0 && this.shutdownResolve) {
-          this.shutdownResolve();
-        }
+        const processed = responsePromise.then((response) => postProcessSse(response, request, bunServer));
+        processed.finally(decrementAndMaybeShutdown).catch(() => {});
+        return processed;
       }
-      return responsePromise;
+      decrementAndMaybeShutdown();
+      return postProcessSse(responsePromise, request, bunServer);
     };
     const websocketHandlers = {
       open: async (ws) => {
@@ -4445,6 +4460,68 @@ class BunServer {
   getHostname() {
     return this.options.hostname;
   }
+  static wrapSseWithHeartbeat(original, intervalMs, signal) {
+    const encoder = new TextEncoder;
+    const keepaliveChunk = encoder.encode(`: keepalive
+
+`);
+    const originalBody = original.body;
+    let heartbeat;
+    let reader;
+    const wrapped = new ReadableStream({
+      start(controller) {
+        reader = originalBody.getReader();
+        heartbeat = setInterval(() => {
+          try {
+            controller.enqueue(keepaliveChunk);
+          } catch {
+            clearInterval(heartbeat);
+            heartbeat = undefined;
+          }
+        }, intervalMs);
+        const onAbort = () => {
+          if (heartbeat) {
+            clearInterval(heartbeat);
+            heartbeat = undefined;
+          }
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        const pump = async () => {
+          try {
+            while (true) {
+              const { done, value } = await reader.read();
+              if (done)
+                break;
+              controller.enqueue(value);
+            }
+            controller.close();
+          } catch (err) {
+            try {
+              controller.error(err);
+            } catch {}
+          } finally {
+            if (heartbeat) {
+              clearInterval(heartbeat);
+              heartbeat = undefined;
+            }
+            signal.removeEventListener("abort", onAbort);
+          }
+        };
+        pump();
+      },
+      cancel() {
+        if (heartbeat) {
+          clearInterval(heartbeat);
+          heartbeat = undefined;
+        }
+        reader?.cancel();
+      }
+    });
+    return new Response(wrapped, {
+      status: original.status,
+      headers: original.headers
+    });
+  }
 }
 
 // src/core/application.ts
@@ -6675,6 +6752,7 @@ class Application {
       hostname: finalHostname,
       reusePort: this.options.reusePort,
       idleTimeout: this.options.idleTimeout,
+      sseKeepAlive: this.options.sseKeepAlive,
       fetch: this.handleRequest.bind(this),
       websocketRegistry: this.websocketRegistry,
       gracefulShutdownTimeout: this.options.gracefulShutdownTimeout
@@ -13982,7 +14060,7 @@ class AiService {
     const fallback = this.options.fallback ?? false;
     const timeout = this.options.timeout ?? 30000;
     if (!fallback) {
-      return this.withTimeout(this.getProvider(targetName).complete(request), timeout, targetName);
+      return this.withTimeout(this.getProvider(targetName).complete(request), timeout, targetName, request.signal);
     }
     const names = [
       targetName,
@@ -13994,21 +14072,32 @@ class AiService {
         const provider = this.providers.get(name);
         if (!provider)
           continue;
-        return await this.withTimeout(provider.complete({ ...request, provider: name }), timeout, name);
+        return await this.withTimeout(provider.complete({ ...request, provider: name }), timeout, name, request.signal);
       } catch (err) {
         errors.push(`${name}: ${err instanceof Error ? err.message : String(err)}`);
       }
     }
     throw new AiAllProvidersFailed(errors);
   }
-  withTimeout(promise, ms, providerName) {
+  withTimeout(promise, ms, providerName, signal) {
     return new Promise((resolve2, reject) => {
+      if (signal?.aborted) {
+        reject(signal.reason ?? new Error("Aborted"));
+        return;
+      }
       const timer = setTimeout(() => reject(new AiTimeoutError(providerName, ms)), ms);
+      const onAbort = () => {
+        clearTimeout(timer);
+        reject(signal.reason ?? new Error("Aborted"));
+      };
+      signal?.addEventListener("abort", onAbort, { once: true });
       promise.then((val) => {
         clearTimeout(timer);
+        signal?.removeEventListener("abort", onAbort);
         resolve2(val);
       }, (err) => {
         clearTimeout(timer);
+        signal?.removeEventListener("abort", onAbort);
         reject(err);
       });
     });
@@ -14134,7 +14223,7 @@ class OpenAIProvider {
         function: { name: t.name, description: t.description, parameters: t.parameters }
       }));
     }
-    const response = await this.post("/chat/completions", body);
+    const response = await this.post("/chat/completions", body, request.signal);
     const choice = response.choices?.[0];
     const usage = response.usage ?? { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 };
     const message = choice?.message;
@@ -14174,6 +14263,7 @@ class OpenAIProvider {
     const encoder = new TextEncoder;
     const apiKey = this.apiKey;
     const baseUrl = this.baseUrl;
+    const signal = request.signal;
     return new ReadableStream({
       async start(controller2) {
         try {
@@ -14183,7 +14273,8 @@ class OpenAIProvider {
               "Content-Type": "application/json",
               Authorization: `Bearer ${apiKey}`
             },
-            body: JSON.stringify(body)
+            body: JSON.stringify(body),
+            signal
           });
           if (!res.ok || !res.body) {
             const err = await res.text();
@@ -14237,14 +14328,15 @@ class OpenAIProvider {
   countTokens(messages) {
     return Math.ceil(messages.reduce((sum, m) => sum + m.content.length, 0) / 4);
   }
-  async post(path, body) {
+  async post(path, body, signal) {
     const res = await fetch(`${this.baseUrl}${path}`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
         Authorization: `Bearer ${this.apiKey}`
       },
-      body: JSON.stringify(body)
+      body: JSON.stringify(body),
+      signal
     });
     if (res.status === 429) {
       const retryAfter = res.headers.get("retry-after");
@@ -14320,7 +14412,7 @@ class AnthropicProvider {
         input_schema: t.parameters
       }));
     }
-    const response = await this.post("/v1/messages", body);
+    const response = await this.post("/v1/messages", body, request.signal);
     const usage = response["usage"] ?? { input_tokens: 0, output_tokens: 0 };
     let content = "";
     const toolCalls = [];
@@ -14368,6 +14460,7 @@ class AnthropicProvider {
     const baseUrl = this.baseUrl;
     const anthropicVersion = this.anthropicVersion;
     const encoder = new TextEncoder;
+    const signal = request.signal;
     return new ReadableStream({
       async start(controller2) {
         try {
@@ -14378,7 +14471,8 @@ class AnthropicProvider {
               "x-api-key": apiKey,
               "anthropic-version": anthropicVersion
             },
-            body: JSON.stringify(body)
+            body: JSON.stringify(body),
+            signal
           });
           if (!res.ok || !res.body) {
             controller2.enqueue(encoder.encode(`data: ${JSON.stringify({ error: await res.text(), done: true })}
@@ -14428,7 +14522,7 @@ class AnthropicProvider {
   countTokens(messages) {
     return Math.ceil(messages.reduce((sum, m) => sum + m.content.length, 0) / 4);
   }
-  async post(path, body) {
+  async post(path, body, signal) {
     const res = await fetch(`${this.baseUrl}${path}`, {
       method: "POST",
       headers: {
@@ -14436,7 +14530,8 @@ class AnthropicProvider {
         "x-api-key": this.apiKey,
         "anthropic-version": this.anthropicVersion
       },
-      body: JSON.stringify(body)
+      body: JSON.stringify(body),
+      signal
     });
     if (res.status === 429)
       throw new AiRateLimitError(this.name);
@@ -14469,7 +14564,8 @@ class OllamaProvider {
           temperature: request.temperature,
           num_predict: request.maxTokens
         }
-      })
+      }),
+      signal: request.signal
     });
     if (!res.ok) {
       throw new AiProviderError(await res.text(), this.name, res.status);
@@ -14494,6 +14590,7 @@ class OllamaProvider {
     const model = request.model ?? this.defaultModel;
     const baseUrl = this.baseUrl;
     const encoder = new TextEncoder;
+    const signal = request.signal;
     return new ReadableStream({
       async start(controller2) {
         try {
@@ -14508,7 +14605,8 @@ class OllamaProvider {
                 temperature: request.temperature,
                 num_predict: request.maxTokens
               }
-            })
+            }),
+            signal
           });
           if (!res.ok || !res.body) {
             controller2.enqueue(encoder.encode(`data: ${JSON.stringify({ error: await res.text(), done: true })}
@@ -14590,7 +14688,8 @@ class GoogleProvider {
     const res = await fetch(`${this.baseUrl}/models/${model}:generateContent?key=${this.apiKey}`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(body)
+      body: JSON.stringify(body),
+      signal: request.signal
     });
     if (res.status === 429)
       throw new AiRateLimitError(this.name);
@@ -14633,6 +14732,7 @@ class GoogleProvider {
     const apiKey = this.apiKey;
     const baseUrl = this.baseUrl;
     const encoder = new TextEncoder;
+    const signal = request.signal;
     const body = {
       contents,
       generationConfig: { temperature: request.temperature, maxOutputTokens: request.maxTokens }
@@ -14645,7 +14745,8 @@ class GoogleProvider {
           const res = await fetch(`${baseUrl}/models/${model}:streamGenerateContent?key=${apiKey}&alt=sse`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
-            body: JSON.stringify(body)
+            body: JSON.stringify(body),
+            signal
           });
           if (!res.ok || !res.body) {
             controller2.enqueue(encoder.encode(`data: ${JSON.stringify({ error: await res.text(), done: true })}
@@ -16009,8 +16110,6 @@ class McpServer {
     });
   }
   createSseResponse() {
-    const registry = this.registry;
-    const serverInfo = this.serverInfo;
     const encoder = new TextEncoder;
     const stream = new ReadableStream({
       start(controller2) {
@@ -16022,15 +16121,6 @@ data: ${JSON.stringify({
 
 `;
         controller2.enqueue(encoder.encode(initEvent));
-        const pingInterval = setInterval(() => {
-          try {
-            controller2.enqueue(encoder.encode(`: ping
-
-`));
-          } catch (_error) {
-            clearInterval(pingInterval);
-          }
-        }, 15000);
       }
     });
     return new Response(stream, {
@@ -16038,7 +16128,7 @@ data: ${JSON.stringify({
         "Content-Type": "text/event-stream",
         "Cache-Control": "no-cache",
         Connection: "keep-alive",
-        "X-MCP-Server": `${serverInfo.name}/${serverInfo.version}`
+        "X-MCP-Server": `${this.serverInfo.name}/${this.serverInfo.version}`
       }
     });
   }

package/dist/mcp/server.d.ts

@@ -20,8 +20,11 @@ export declare class McpServer {
      */
     handleHttp(req: Request): Promise<Response>;
     /**
-     * Create an SSE response that keeps the connection open for streaming
-     * This is the SSE transport endpoint
+     * Create an SSE response that keeps the connection open for streaming.
+     *
+     * Heartbeat / keep-alive pings are handled automatically by the framework's
+     * SSE post-processor (`sseKeepAlive`), so this method no longer injects its
+     * own `setInterval`.
      */
     createSseResponse(): Response;
     private dispatch;

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;gBAExB,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa;IAKnE;;OAEG;IACU,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBtE;;;OAGG;IACU,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQxD;;;OAGG;IACI,iBAAiB,IAAI,QAAQ;YAmCtB,QAAQ;CAkEvB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;gBAExB,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa;IAKnE;;OAEG;IACU,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBtE;;;OAGG;IACU,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQxD;;;;;;OAMG;IACI,iBAAiB,IAAI,QAAQ;YAuBtB,QAAQ;CAkEvB"}

package/docs/idle-timeout.md

@@ -1,22 +1,33 @@
-# idleTimeout
+# idleTimeout & SSE Keep-Alive
 
-`idleTimeout` now supports both global and per-route configuration.
+## 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 |
+
+> **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.
+
+---
 
 ## Global idle timeout (milliseconds)
 
-Set in `Application` options using milliseconds.  
-Framework converts internally before passing to `Bun.serve`.
+Set in `Application` options using milliseconds.
+Framework converts internally before passing to `Bun.serve` (`Math.ceil(ms / 1000)` → seconds).
 
 ```ts
 const app = new Application({
   port: 3000,
-  idleTimeout: 15000, // ms
+  idleTimeout: 15000, // 15 s — applies to all non-SSE connections
 });
 ```
 
-## Per-route timeout (milliseconds)
+## Per-route timeout — `@IdleTimeout(ms)`
 
-Use `@IdleTimeout(ms)` on controller class or handler method.
+Use `@IdleTimeout(ms)` on a controller class or a handler method.
 
 ```ts
 import { Controller, GET, IdleTimeout } from '@dangao/bun-server';
@@ -38,5 +49,85 @@ class ApiController {
 }
 ```
 
-When timeout is reached, Bun Server throws `HttpException(408, "Request Timeout")`.
+### Matching & precedence
+
+1. **Method-level** `@IdleTimeout` is checked first — if present, it wins.
+2. **Class-level** `@IdleTimeout` is used as fallback.
+3. If neither is set, no handler-level timeout is applied (the route runs until the TCP timeout or until it completes).
+
+When the handler-level timeout fires, the framework throws `HttpException(408, "Request Timeout")`.
+
+---
+
+## SSE Keep-Alive (automatic)
+
+When the framework detects a response with `Content-Type: text/event-stream`, it automatically:
+
+1. **Disables the TCP idle timeout** for that request via `server.timeout(req, 0)`, preventing Bun from killing the long-lived connection.
+2. **Injects SSE comment heartbeats** (`: keepalive\n\n`) at a configurable interval, preventing intermediate proxies (nginx, cloud load balancers) from closing the connection due to inactivity.
+
+### Configuration
+
+```ts
+const app = new Application({
+  port: 3000,
+  idleTimeout: 10000, // normal requests: 10 s
+
+  // SSE keep-alive — defaults shown below
+  sseKeepAlive: {
+    enabled: true,      // auto-detect SSE and inject heartbeat
+    intervalMs: 15000,  // heartbeat every 15 s
+  },
+});
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `sseKeepAlive.enabled` | `boolean` | `true` | Enable automatic SSE detection, TCP timeout reset, and heartbeat injection |
+| `sseKeepAlive.intervalMs` | `number` | `15000` | Heartbeat interval in milliseconds |
+
+When `enabled` is `true` (default), any response whose `Content-Type` header contains `text/event-stream` triggers the SSE post-processor. You do **not** need any special decorator or annotation — detection is purely based on the response header.
+
+When `enabled` is `false`, no SSE-specific processing is applied. You would need to manage keep-alive and `server.timeout` yourself.
+
+---
+
+## Signal cascading (`ctx.signal`)
+
+`Context` exposes the client's `AbortSignal` via `ctx.signal`. When the client disconnects (network failure, browser tab closed, `curl` interrupted), this signal aborts.
+
+For AI streaming endpoints, pass `ctx.signal` to `AiService` so the upstream API request is cancelled immediately — **stopping token consumption**:
+
+```ts
+import { Controller, GET, Context as Ctx } from '@dangao/bun-server';
+import type { Context } from '@dangao/bun-server';
+
+@Controller('/chat')
+class ChatController {
+  constructor(private readonly ai: AiService) {}
+
+  @GET('/stream')
+  public stream(@Ctx() ctx: Context) {
+    const stream = this.ai.stream({
+      messages: [{ role: 'user', content: 'Hello' }],
+      signal: ctx.signal, // ← cascade client disconnect
+    });
+    return new Response(stream, {
+      headers: { 'Content-Type': 'text/event-stream' },
+    });
+  }
+}
+```
+
+> **Note:** The `Context` parameter decorator is exported as both `Context` (from `'./controller'`) and `ContextParam` (from the package root). Use whichever alias avoids name collision with the `Context` type.
+
+The full cancellation chain:
 
+```
+Client disconnects
+  → request.signal aborts
+    → heartbeat timer cleared
+      → wrapped stream cancelled
+        → AI provider fetch() aborted
+          → upstream API connection closed (tokens saved)
+```

package/docs/zh/idle-timeout.md

@@ -1,19 +1,30 @@
-# idleTimeout
+# idleTimeout 与 SSE 保活
 
-`idleTimeout` 现已支持全局与路由级两种配置方式。
+## 两层超时机制
+
+Bun Server 有**两套独立的超时机制**——理解它们的区别对 SSE / 流式场景至关重要。
+
+| 层面 | 配置方式 | 作用域 | 机制 |
+|------|----------|--------|------|
+| **TCP 连接级** | `Application({ idleTimeout })` | Bun.serve 底层 | Bun 内核在连接无数据流动 N 秒后直接断开 socket |
+| **Handler 逻辑级** | `@IdleTimeout(ms)` 装饰器 | 路由粒度的 `Promise.race` | handler 未在指定时间内 resolve 则返回 `408 Request Timeout` |
+
+> **关键：** 对于 SSE 响应，handler 会立即返回一个带流式 body 的 `Response`。此时 handler 层面的 `@IdleTimeout` 已经 resolve，**不会**保护或终止该流。只有 TCP 级别的 `idleTimeout` 才能断开 SSE 连接。
+
+---
 
 ## 全局 idleTimeout（毫秒）
 
-在 `Application` 中直接按毫秒设置，框架内部会转换后传给 `Bun.serve`。
+在 `Application` 中按毫秒设置，框架内部自动转换后传给 `Bun.serve`（`Math.ceil(ms / 1000)` → 秒）。
 
 ```ts
 const app = new Application({
   port: 3000,
-  idleTimeout: 15000, // ms
+  idleTimeout: 15000, // 15 秒 — 对所有非 SSE 连接生效
 });
 ```
 
-## 路由级超时（毫秒）
+## 路由级超时 — `@IdleTimeout(ms)`
 
 使用 `@IdleTimeout(ms)` 装饰器配置控制器级或方法级超时。
 
@@ -37,5 +48,85 @@ class ApiController {
 }
 ```
 
-超时后会抛出 `HttpException(408, "Request Timeout")`。
+### 匹配与生效规则
+
+1. **方法级** `@IdleTimeout` 优先检测——存在即生效。
+2. **类级** `@IdleTimeout` 作为兜底。
+3. 若均未设置，则不应用 handler 级超时（路由将持续运行直到 TCP 超时或自然完成）。
+
+handler 级超时触发时，框架抛出 `HttpException(408, "Request Timeout")`。
+
+---
+
+## SSE 保活（自动）
+
+当框架检测到响应的 `Content-Type` 包含 `text/event-stream` 时，会自动执行：
+
+1. **禁用该请求的 TCP 空闲超时** —— 通过 `server.timeout(req, 0)` 阻止 Bun 断开长连接。
+2. **注入 SSE 注释心跳** —— 按配置间隔发送 `: keepalive\n\n`，防止中间代理（nginx、云 LB）因空闲而断连。
+
+### 配置
+
+```ts
+const app = new Application({
+  port: 3000,
+  idleTimeout: 10000, // 普通请求：10 秒
+
+  // SSE 保活 — 以下为默认值
+  sseKeepAlive: {
+    enabled: true,      // 自动检测 SSE 并注入心跳
+    intervalMs: 15000,  // 每 15 秒一次心跳
+  },
+});
+```
+
+| 选项 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `sseKeepAlive.enabled` | `boolean` | `true` | 启用 SSE 自动检测、TCP 超时解除和心跳注入 |
+| `sseKeepAlive.intervalMs` | `number` | `15000` | 心跳间隔（毫秒） |
+
+当 `enabled` 为 `true`（默认）时，任何 `Content-Type` 头包含 `text/event-stream` 的响应都会触发 SSE 后处理器。**无需任何特殊装饰器或注解**——纯粹基于响应头自动检测。
+
+当 `enabled` 为 `false` 时，框架不做任何 SSE 特殊处理。你需要自行管理 keep-alive 和 `server.timeout`。
+
+---
+
+## 信号级联（`ctx.signal`）
+
+`Context` 通过 `ctx.signal` 暴露客户端的 `AbortSignal`。当客户端断连（网络故障、关闭浏览器标签、中断 `curl`）时，该信号会 abort。
+
+对于 AI 流式端点，将 `ctx.signal` 传递给 `AiService`，可立即取消上游 API 请求——**停止 token 消耗**：
+
+```ts
+import { Controller, GET, Context as Ctx } from '@dangao/bun-server';
+import type { Context } from '@dangao/bun-server';
+
+@Controller('/chat')
+class ChatController {
+  constructor(private readonly ai: AiService) {}
+
+  @GET('/stream')
+  public stream(@Ctx() ctx: Context) {
+    const stream = this.ai.stream({
+      messages: [{ role: 'user', content: 'Hello' }],
+      signal: ctx.signal, // ← 级联客户端断连
+    });
+    return new Response(stream, {
+      headers: { 'Content-Type': 'text/event-stream' },
+    });
+  }
+}
+```
+
+> **注意：** `Context` 参数装饰器既可通过 `Context`（从 `'./controller'`）导入，也可通过包根导出的别名 `ContextParam` 导入。推荐使用 `ContextParam` 或 `Context as Ctx` 以避免与 `Context` 类型名冲突。
+
+完整取消链路：
 
+```
+客户端断连
+  → request.signal abort
+    → 心跳定时器清理
+      → 包裹流取消
+        → AI Provider 内部 fetch() abort
+          → 上游 API 连接关闭（节省 token）
+```

package/package.json

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

package/src/ai/providers/anthropic-provider.ts

@@ -56,7 +56,7 @@ export class AnthropicProvider implements LlmProvider {
       }));
     }
 
-    const response = await this.post('/v1/messages', body);
+    const response = await this.post('/v1/messages', body, request.signal);
     const usage = (response['usage'] as { input_tokens: number; output_tokens: number }) ?? { input_tokens: 0, output_tokens: 0 };
 
     let content = '';
@@ -108,6 +108,7 @@ export class AnthropicProvider implements LlmProvider {
     const baseUrl = this.baseUrl;
     const anthropicVersion = this.anthropicVersion;
     const encoder = new TextEncoder();
+    const signal = request.signal;
 
     return new ReadableStream<Uint8Array>({
       async start(controller) {
@@ -120,6 +121,7 @@ export class AnthropicProvider implements LlmProvider {
               'anthropic-version': anthropicVersion,
             },
             body: JSON.stringify(body),
+            signal,
           });
 
           if (!res.ok || !res.body) {
@@ -170,7 +172,7 @@ export class AnthropicProvider implements LlmProvider {
     return Math.ceil(messages.reduce((sum, m) => sum + m.content.length, 0) / 4);
   }
 
-  private async post(path: string, body: Record<string, unknown>): Promise<Record<string, unknown>> {
+  private async post(path: string, body: Record<string, unknown>, signal?: AbortSignal): Promise<Record<string, unknown>> {
     const res = await fetch(`${this.baseUrl}${path}`, {
       method: 'POST',
       headers: {
@@ -179,6 +181,7 @@ export class AnthropicProvider implements LlmProvider {
         'anthropic-version': this.anthropicVersion,
       },
       body: JSON.stringify(body),
+      signal,
     });
 
     if (res.status === 429) throw new AiRateLimitError(this.name);

package/src/ai/providers/google-provider.ts

@@ -50,6 +50,7 @@ export class GoogleProvider implements LlmProvider {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify(body),
+        signal: request.signal,
       },
     );
 
@@ -95,6 +96,7 @@ export class GoogleProvider implements LlmProvider {
     const apiKey = this.apiKey;
     const baseUrl = this.baseUrl;
     const encoder = new TextEncoder();
+    const signal = request.signal;
 
     const body: Record<string, unknown> = {
       contents,
@@ -111,6 +113,7 @@ export class GoogleProvider implements LlmProvider {
               method: 'POST',
               headers: { 'Content-Type': 'application/json' },
               body: JSON.stringify(body),
+              signal,
             },
           );
 

package/src/ai/providers/ollama-provider.ts

@@ -33,6 +33,7 @@ export class OllamaProvider implements LlmProvider {
           num_predict: request.maxTokens,
         },
       }),
+      signal: request.signal,
     });
 
     if (!res.ok) {
@@ -61,6 +62,7 @@ export class OllamaProvider implements LlmProvider {
     const model = request.model ?? this.defaultModel;
     const baseUrl = this.baseUrl;
     const encoder = new TextEncoder();
+    const signal = request.signal;
 
     return new ReadableStream<Uint8Array>({
       async start(controller) {
@@ -77,6 +79,7 @@ export class OllamaProvider implements LlmProvider {
                 num_predict: request.maxTokens,
               },
             }),
+            signal,
           });
 
           if (!res.ok || !res.body) {

package/src/ai/providers/openai-provider.ts

@@ -79,7 +79,7 @@ export class OpenAIProvider implements LlmProvider {
       }));
     }
 
-    const response = await this.post('/chat/completions', body);
+    const response = await this.post('/chat/completions', body, request.signal);
     const choice = response.choices?.[0];
     const usage = response.usage ?? { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 };
     const message = choice?.message;
@@ -127,6 +127,7 @@ export class OpenAIProvider implements LlmProvider {
     const encoder = new TextEncoder();
     const apiKey = this.apiKey;
     const baseUrl = this.baseUrl;
+    const signal = request.signal;
 
     return new ReadableStream<Uint8Array>({
       async start(controller) {
@@ -138,6 +139,7 @@ export class OpenAIProvider implements LlmProvider {
               'Authorization': `Bearer ${apiKey}`,
             },
             body: JSON.stringify(body),
+            signal,
           });
 
           if (!res.ok || !res.body) {
@@ -191,7 +193,7 @@ export class OpenAIProvider implements LlmProvider {
     return Math.ceil(messages.reduce((sum, m) => sum + m.content.length, 0) / 4);
   }
 
-  private async post(path: string, body: Record<string, unknown>): Promise<OpenAiChatCompletionResponse> {
+  private async post(path: string, body: Record<string, unknown>, signal?: AbortSignal): Promise<OpenAiChatCompletionResponse> {
     const res = await fetch(`${this.baseUrl}${path}`, {
       method: 'POST',
       headers: {
@@ -199,6 +201,7 @@ export class OpenAIProvider implements LlmProvider {
         'Authorization': `Bearer ${this.apiKey}`,
       },
       body: JSON.stringify(body),
+      signal,
     });
 
     if (res.status === 429) {

package/src/ai/service.ts

@@ -120,7 +120,7 @@ export class AiService {
     const timeout = this.options.timeout ?? 30000;
 
     if (!fallback) {
-      return this.withTimeout(this.getProvider(targetName).complete(request), timeout, targetName);
+      return this.withTimeout(this.getProvider(targetName).complete(request), timeout, targetName, request.signal);
     }
 
     // Fallback chain: try target first, then others in order
@@ -134,7 +134,7 @@ export class AiService {
       try {
         const provider = this.providers.get(name);
         if (!provider) continue;
-        return await this.withTimeout(provider.complete({ ...request, provider: name }), timeout, name);
+        return await this.withTimeout(provider.complete({ ...request, provider: name }), timeout, name, request.signal);
       } catch (err) {
         errors.push(`${name}: ${err instanceof Error ? err.message : String(err)}`);
       }
@@ -143,12 +143,24 @@ export class AiService {
     throw new AiAllProvidersFailed(errors);
   }
 
-  private withTimeout<T>(promise: Promise<T>, ms: number, providerName: string): Promise<T> {
+  private withTimeout<T>(promise: Promise<T>, ms: number, providerName: string, signal?: AbortSignal): Promise<T> {
     return new Promise<T>((resolve, reject) => {
+      if (signal?.aborted) {
+        reject(signal.reason ?? new Error('Aborted'));
+        return;
+      }
+
       const timer = setTimeout(() => reject(new AiTimeoutError(providerName, ms)), ms);
+
+      const onAbort = () => {
+        clearTimeout(timer);
+        reject(signal!.reason ?? new Error('Aborted'));
+      };
+      signal?.addEventListener('abort', onAbort, { once: true });
+
       promise.then(
-        (val) => { clearTimeout(timer); resolve(val); },
-        (err) => { clearTimeout(timer); reject(err); },
+        (val) => { clearTimeout(timer); signal?.removeEventListener('abort', onAbort); resolve(val); },
+        (err) => { clearTimeout(timer); signal?.removeEventListener('abort', onAbort); reject(err); },
       );
     });
   }

package/src/ai/types.ts

@@ -45,6 +45,11 @@ export interface AiRequest {
   tools?: AiToolDefinition[];
   /** Provider name override */
   provider?: string;
+  /**
+   * Abort signal — pass `ctx.signal` to cascade client disconnection
+   * to the upstream AI API, stopping token consumption immediately.
+   */
+  signal?: AbortSignal;
 }
 
 /**

package/src/core/application.ts

@@ -61,6 +61,24 @@ export interface ApplicationOptions {
    * 框架内部会自动转换为 Bun.serve 的秒单位
    */
   idleTimeout?: number;
+
+  /**
+   * SSE 保活配置
+   *
+   * 框架自动检测 `Content-Type: text/event-stream` 的响应，
+   * 对该请求禁用 Bun TCP 空闲超时（`server.timeout(req, 0)`），
+   * 并按配置间隔向客户端发送 SSE 注释心跳（`: keepalive\n\n`）。
+   *
+   * 心跳可防止中间代理（nginx / 云 LB）因空闲而断开连接。
+   *
+   * @default `{ enabled: true, intervalMs: 15000 }`
+   */
+  sseKeepAlive?: {
+    /** 是否启用，默认 true */
+    enabled?: boolean;
+    /** 心跳间隔（毫秒），默认 15000 */
+    intervalMs?: number;
+  };
 }
 
 /**
@@ -150,6 +168,7 @@ export class Application {
       hostname: finalHostname,
       reusePort: this.options.reusePort,
       idleTimeout: this.options.idleTimeout,
+      sseKeepAlive: this.options.sseKeepAlive,
       fetch: this.handleRequest.bind(this),
       websocketRegistry: this.websocketRegistry,
       gracefulShutdownTimeout: this.options.gracefulShutdownTimeout,

package/src/core/context.ts

@@ -74,6 +74,12 @@ export class Context {
    */
   private _bodyParsed: boolean = false;
 
+  /**
+   * 客户端断连信号
+   * 当客户端主动关闭连接时 abort，可用于级联取消内部请求
+   */
+  public readonly signal: AbortSignal;
+
   public constructor(request: Request) {
     this.request = request;
     this.url = new URL(request.url);
@@ -82,6 +88,7 @@ export class Context {
     this.query = this.url.searchParams;
     this.headers = request.headers;
     this.responseHeaders = new Headers();
+    this.signal = request.signal;
   }
 
   /**

package/src/core/server.ts

@@ -47,6 +47,15 @@ export interface ServerOptions {
    * 框架内部会转换为 Bun.serve 所需的秒
    */
   idleTimeout?: number;
+
+  /**
+   * SSE 保活配置
+   * @see ApplicationOptions.sseKeepAlive
+   */
+  sseKeepAlive?: {
+    enabled?: boolean;
+    intervalMs?: number;
+  };
 }
 
 /**
@@ -81,9 +90,44 @@ export class BunServer {
     this.shutdownPromise = undefined;
     this.shutdownResolve = undefined;
 
+    const sseKeepAlive = this.options.sseKeepAlive;
+    const sseHeartbeatEnabled = sseKeepAlive?.enabled !== false;
+    const sseHeartbeatIntervalMs = sseKeepAlive?.intervalMs ?? 15_000;
+
+    const postProcessSse = (
+      response: Response,
+      request: Request,
+      bunServer: Server<WebSocketConnectionData>,
+    ): Response => {
+      const ct = response.headers.get('content-type');
+      if (!ct?.includes('text/event-stream')) {
+        return response;
+      }
+
+      // SSE detected — always disable Bun TCP idle timeout for this connection
+      bunServer.timeout(request, 0);
+
+      if (sseHeartbeatEnabled && response.body) {
+        return BunServer.wrapSseWithHeartbeat(
+          response,
+          sseHeartbeatIntervalMs,
+          request.signal,
+        );
+      }
+
+      return response;
+    };
+
+    const decrementAndMaybeShutdown = () => {
+      this.activeRequests--;
+      if (this.isShuttingDown && this.activeRequests === 0 && this.shutdownResolve) {
+        this.shutdownResolve();
+      }
+    };
+
     const fetchHandler = (
       request: Request,
-      server: Server<WebSocketConnectionData>,
+      bunServer: Server<WebSocketConnectionData>,
     ): Response | Promise<Response> | undefined => {
       if (this.isShuttingDown) {
         return new Response("Server is shutting down", { status: 503 });
@@ -101,7 +145,7 @@ export class BunServer {
         }
         const context = new Context(request);
         const queryParams = new URLSearchParams(url.searchParams);
-        const upgraded = server.upgrade(request, {
+        const upgraded = bunServer.upgrade(request, {
           data: {
             path: url.pathname,
             query: queryParams,
@@ -120,24 +164,17 @@ export class BunServer {
       const responsePromise = this.options.fetch(context);
 
       if (responsePromise instanceof Promise) {
-        responsePromise
-          .finally(() => {
-            this.activeRequests--;
-            if (this.isShuttingDown && this.activeRequests === 0 && this.shutdownResolve) {
-              this.shutdownResolve();
-            }
-          })
-          .catch(() => {
-            // errors handled by middleware pipeline
-          });
-      } else {
-        this.activeRequests--;
-        if (this.isShuttingDown && this.activeRequests === 0 && this.shutdownResolve) {
-          this.shutdownResolve();
-        }
+        const processed = responsePromise.then(
+          (response) => postProcessSse(response, request, bunServer),
+        );
+        processed
+          .finally(decrementAndMaybeShutdown)
+          .catch(() => { /* errors handled by middleware pipeline */ });
+        return processed;
       }
 
-      return responsePromise;
+      decrementAndMaybeShutdown();
+      return postProcessSse(responsePromise, request, bunServer);
     };
 
     const websocketHandlers = {
@@ -296,4 +333,70 @@ export class BunServer {
   public getHostname(): string | undefined {
     return this.options.hostname;
   }
+
+  /**
+   * 将 SSE Response 的 body 包裹一层心跳注入流。
+   *
+   * 原始流的数据原样透传；在数据间隙中按 intervalMs 发送
+   * SSE 注释帧 `: keepalive\n\n`（客户端会忽略注释帧）。
+   *
+   * 当 signal abort / 原始流结束 / 客户端断连时自动清理定时器。
+   */
+  private static wrapSseWithHeartbeat(
+    original: Response,
+    intervalMs: number,
+    signal: AbortSignal,
+  ): Response {
+    const encoder = new TextEncoder();
+    const keepaliveChunk = encoder.encode(': keepalive\n\n');
+    const originalBody = original.body!;
+    let heartbeat: ReturnType<typeof setInterval> | undefined;
+    let reader: ReadableStreamDefaultReader<Uint8Array> | undefined;
+
+    const wrapped = new ReadableStream<Uint8Array>({
+      start(controller) {
+        reader = originalBody.getReader() as ReadableStreamDefaultReader<Uint8Array>;
+
+        heartbeat = setInterval(() => {
+          try {
+            controller.enqueue(keepaliveChunk);
+          } catch {
+            clearInterval(heartbeat);
+            heartbeat = undefined;
+          }
+        }, intervalMs);
+
+        const onAbort = () => {
+          if (heartbeat) { clearInterval(heartbeat); heartbeat = undefined; }
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+
+        const pump = async () => {
+          try {
+            while (true) {
+              const { done, value } = await reader!.read();
+              if (done) break;
+              controller.enqueue(value);
+            }
+            controller.close();
+          } catch (err) {
+            try { controller.error(err); } catch { /* already closed */ }
+          } finally {
+            if (heartbeat) { clearInterval(heartbeat); heartbeat = undefined; }
+            signal.removeEventListener('abort', onAbort);
+          }
+        };
+        pump();
+      },
+      cancel() {
+        if (heartbeat) { clearInterval(heartbeat); heartbeat = undefined; }
+        reader?.cancel();
+      },
+    });
+
+    return new Response(wrapped, {
+      status: original.status,
+      headers: original.headers,
+    });
+  }
 }

package/src/mcp/server.ts

@@ -48,31 +48,22 @@ export class McpServer {
   }
 
   /**
-   * Create an SSE response that keeps the connection open for streaming
-   * This is the SSE transport endpoint
+   * Create an SSE response that keeps the connection open for streaming.
+   *
+   * Heartbeat / keep-alive pings are handled automatically by the framework's
+   * SSE post-processor (`sseKeepAlive`), so this method no longer injects its
+   * own `setInterval`.
    */
   public createSseResponse(): Response {
-    const registry = this.registry;
-    const serverInfo = this.serverInfo;
     const encoder = new TextEncoder();
 
     const stream = new ReadableStream({
       start(controller) {
-        // Send initial server info event
         const initEvent = `event: endpoint\ndata: ${JSON.stringify({
           type: 'endpoint',
           method: 'POST',
         })}\n\n`;
         controller.enqueue(encoder.encode(initEvent));
-
-        // Keep connection alive with periodic pings
-        const pingInterval = setInterval(() => {
-          try {
-            controller.enqueue(encoder.encode(': ping\n\n'));
-          } catch (_error) {
-            clearInterval(pingInterval);
-          }
-        }, 15000);
       },
     });
 
@@ -81,7 +72,7 @@ export class McpServer {
         'Content-Type': 'text/event-stream',
         'Cache-Control': 'no-cache',
         'Connection': 'keep-alive',
-        'X-MCP-Server': `${serverInfo.name}/${serverInfo.version}`,
+        'X-MCP-Server': `${this.serverInfo.name}/${this.serverInfo.version}`,
       },
     });
   }