@faapi/faapi 6.21.0 → 6.22.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FaapiMiddleware, A as AppRegistries, R as RouteManifest, a as FaapiContext, C as CorsOptions, T as TaskClient, H as HelmetOptions, L as LogConfig, I as InjectorMap, b as TaskFailedHandler, W as WsRouteManifest, c as TaskQueueDeps, d as TaskQueue, e as TaskDriver, f as TaskRegistry, g as TaskManifest, h as ToolMetadata, i as AgentCore, j as AgentMetadata, k as CreateLoggerOptions, l as Logger } from './routeTypes-gyz4PMh7.js';
-export { m as AgentHandleFactory, n as AgentHandleStore, o as AgentPathMeta, p as AgentRegistry, q as AgentToolDescriptor, r as FaapiContextConfig, s as FaapiTaskMeta, t as FailOptions, u as Injector, v as LogEntry, w as LogLevel, x as LogSink, y as RouteInfo, z as RouteInputSchema, B as RouteOutputSchema, D as RouteParamSchema, S as SkillRegistry, E as SseEvent, G as SseWriter, J as TaskContext, K as TaskDriverJob, M as TaskDriverProcess, N as TaskDriverRecord, O as TaskFailedInfo, P as TaskJob, Q as TaskJobStatus, U as TaskMetadata, V as TaskModule, X as TaskRegistriesSnapshot, Y as TaskRegistriesView, Z as ToolCore, _ as ToolPathMeta, $ as ToolRegistry, a0 as cors, a1 as createAppRegistries, a2 as createTaskRegistriesView, a3 as createTaskRegistry, a4 as helmet } from './routeTypes-gyz4PMh7.js';
+import { F as FaapiMiddleware, A as AppRegistries, R as RouteManifest, a as FaapiContext, C as CorsOptions, T as TaskClient, H as HelmetOptions, L as LogConfig, I as InjectorMap, b as TaskFailedHandler, W as WsRouteManifest, c as TaskQueueDeps, d as TaskQueue, e as TaskDriver, f as TaskRegistry, g as TaskManifest, h as ToolMetadata, i as AgentCore, j as AgentMetadata, k as CreateLoggerOptions, l as Logger } from './routeTypes-CXWkRx4W.js';
+export { m as AgentHandleFactory, n as AgentHandleStore, o as AgentPathMeta, p as AgentRegistry, q as AgentToolDescriptor, r as FaapiContextConfig, s as FaapiTaskMeta, t as FailOptions, u as Injector, v as LogEntry, w as LogLevel, x as LogSink, y as RouteInfo, z as RouteInputSchema, B as RouteOutputSchema, D as RouteParamSchema, S as SkillRegistry, E as SseEvent, G as SseOptions, J as SseWriter, K as TaskContext, M as TaskDriverJob, N as TaskDriverProcess, O as TaskDriverRecord, P as TaskFailedInfo, Q as TaskJob, U as TaskJobStatus, V as TaskMetadata, X as TaskModule, Y as TaskRegistriesSnapshot, Z as TaskRegistriesView, _ as ToolCore, $ as ToolPathMeta, a0 as ToolRegistry, a1 as cors, a2 as createAppRegistries, a3 as createTaskRegistriesView, a4 as createTaskRegistry, a5 as helmet } from './routeTypes-CXWkRx4W.js';
 import * as node_http from 'node:http';
 import { Server, IncomingMessage, ServerResponse } from 'node:http';
 import { Socket } from 'node:net';

package/dist/index.js

@@ -4782,13 +4782,28 @@ function encodeSseEvent(event) {
   return out;
 }
 function createSseWriter(options = {}) {
-  const { onFirstWrite } = options;
+  const { onFirstWrite, keepOpen = false } = options;
   const encoder = new TextEncoder();
   let controller = null;
   let closed = false;
   let aborted = false;
   let firstWriteTriggered = false;
   let drainWaiters = [];
+  let closeCallbacks = [];
+  let closeCallbacksFired = false;
+  const safeRunCallback = (callback) => {
+    try {
+      callback();
+    } catch {
+    }
+  };
+  const runCloseCallbacks = () => {
+    if (closeCallbacksFired) return;
+    closeCallbacksFired = true;
+    const callbacks = closeCallbacks;
+    closeCallbacks = [];
+    for (const callback of callbacks) safeRunCallback(callback);
+  };
   const resolveDrainWaiters = () => {
     const waiters = drainWaiters;
     drainWaiters = [];
@@ -4812,6 +4827,7 @@ function createSseWriter(options = {}) {
         aborted = true;
         closed = true;
         controller = null;
+        runCloseCallbacks();
         resolveDrainWaiters();
       }
     },
@@ -4854,6 +4870,7 @@ function createSseWriter(options = {}) {
     close() {
       if (closed) return;
       closed = true;
+      runCloseCallbacks();
       resolveDrainWaiters();
       if (controller) {
         try {
@@ -4863,6 +4880,13 @@ function createSseWriter(options = {}) {
         controller = null;
       }
     },
+    onClose(callback) {
+      if (closeCallbacksFired) {
+        safeRunCallback(callback);
+        return;
+      }
+      closeCallbacks.push(callback);
+    },
     get closed() {
       return closed;
     },
@@ -4879,6 +4903,9 @@ function createSseWriter(options = {}) {
     get aborted() {
       return aborted;
     },
+    get keepOpen() {
+      return keepOpen;
+    },
     get response() {
       return response;
     }
@@ -5088,10 +5115,15 @@ function createContextFromUrl(request, url, params, config = {}, ip = "", regist
      * 接入底层连接——流式期间字节即产即达（见 createServer.md「SSE 提前接管」）。
      * 无钩子场景（app.inject / 测试直调 invokeHandler）回落为 handler 返回后交出。
      *
+     * `{ keepOpen: true }` 声明流生命周期独立于 handler 返回：handler 返回后框架
+     * 不自动 close（长连接订阅模式，清理推送源用 writer.onClose）；handler 抛错
+     * 的兜底 close 不受影响。详见 runtime/sse.md「长连接订阅模式」。
+     *
      * 与 ctx.json / ctx.html 互斥：一个 handler 只能用一种响应方式。
      */
-    sse() {
+    sse(options) {
       const writer = createSseWriter({
+        keepOpen: options?.keepOpen,
         onFirstWrite: (response) => {
           ctx.__earlyRespond?.(response);
         }
@@ -5491,7 +5523,7 @@ async function invokeHandler(handler, ctx, body, middlewares, injectors) {
   const pickSseAndAutoClose = () => {
     const sseWriter = ctx.__sseWriter;
     if (!sseWriter) return null;
-    if (!sseWriter.closed && !sseWriter.aborted) {
+    if (!sseWriter.keepOpen && !sseWriter.closed && !sseWriter.aborted) {
       sseWriter.close();
     }
     return mergeMeta(sseWriter.response, meta);