@songfreedom/sse-client 0.0.0-stage → 0.1.0

package/client.js

@@ -0,0 +1,614 @@
+import { SSEError, isRetryableStatus, toSSEError } from "./errors.js";
+import { DEFAULT_MAX_BUFFER_SIZE, createSSEParser, } from "./parser.js";
+const EVENT_STREAM_CONTENT_TYPE = "text/event-stream";
+/** 防止「刚连上就断」时形成紧循环 */
+const MIN_RETRY_DELAY = 200;
+/**
+ * SSE 客户端。
+ *
+ * - 基于 `fetch` + `ReadableStream`，支持自定义请求头与 POST body
+ * - 断线自动重连（指数退避 + 抖动），401 等不可重试错误直接终止
+ * - 用 `Last-Event-ID` 做断点续传
+ * - 按事件名路由到多个订阅者，一条连接服务多个组件
+ * - 空闲看门狗、主动轮换、断网/切后台挂起、连接共享（见 `acquireSSEClient`）
+ */
+export class SSEClient {
+    options;
+    parser;
+    eventFilter;
+    state = "idle";
+    finished = false;
+    running = false;
+    suspended = null;
+    attempt = 0;
+    lastEventIdValue = "";
+    serverRetryDelay;
+    idleTimedOut = false;
+    rotating = false;
+    idleTimer = null;
+    rotateTimer = null;
+    cancelController = new AbortController();
+    attemptController = null;
+    runPromise = null;
+    resumeWaiter = null;
+    lifecycleBound = false;
+    onVisibilityChange;
+    onOffline;
+    onOnline;
+    messageHandlers = new Set();
+    eventHandlers = new Map();
+    statusHandlers = new Set();
+    errorHandlers = new Set();
+    openHandlers = new Set();
+    closeHandlers = new Set();
+    constructor(options) {
+        if (!options?.url) {
+            throw new Error("[sse-client] 缺少 url");
+        }
+        this.options = options;
+        this.parser = createSSEParser({
+            maxBufferSize: options.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE,
+            onEvent: (event) => this.handleParsedEvent(event),
+            onRetry: (delay) => {
+                this.serverRetryDelay = delay;
+            },
+        });
+        this.eventFilter = options.events?.length ? new Set(options.events) : null;
+        if (options.onMessage)
+            this.onMessage(options.onMessage);
+        if (options.onStatus)
+            this.onStatus(options.onStatus);
+        if (options.onError)
+            this.onError(options.onError);
+        if (options.onOpen)
+            this.onOpen(options.onOpen);
+        if (options.onClose)
+            this.onClose(options.onClose);
+        if (options.autoStart !== false) {
+            this.start();
+        }
+    }
+    /** 当前状态 */
+    get status() {
+        return this.state;
+    }
+    /** 是否已最终关闭（不会再重连） */
+    get closed() {
+        return this.finished;
+    }
+    /** 连续重试次数，连接稳定后归零 */
+    get attempts() {
+        return this.attempt;
+    }
+    /** 最近一次事件 id，重连时通过 Last-Event-ID 带给服务端 */
+    get lastEventId() {
+        return this.lastEventIdValue;
+    }
+    /** 连接终止（无论正常关闭还是放弃重连）后 resolve，不会 reject */
+    get done() {
+        return this.runPromise ?? Promise.resolve();
+    }
+    /** 建立连接；已连接或已挂起时调用无副作用 */
+    start() {
+        if (this.running || this.suspended) {
+            return this;
+        }
+        if (this.finished) {
+            this.reset();
+        }
+        // 页面本来就不可见时先不发请求，等 visibilitychange 再建连（WebView 预加载场景常见）
+        if (this.options.pauseWhenHidden &&
+            typeof document !== "undefined" &&
+            document.hidden) {
+            this.suspended = "hidden";
+            this.setState("idle");
+            return this;
+        }
+        this.running = true;
+        this.bindLifecycle();
+        this.runPromise = this.connect()
+            .catch((error) => {
+            // 兜底：调用方回调抛错也不能变成未处理的 Promise 拒绝
+            this.finish("error", toSSEError(error));
+        })
+            .finally(() => {
+            this.running = false;
+        });
+        return this;
+    }
+    /** 主动关闭，不再重连 */
+    close() {
+        if (this.finished) {
+            return;
+        }
+        this.finish("user");
+    }
+    /** 关闭后重新连接，保留 lastEventId 以便续传 */
+    restart() {
+        this.close();
+        return this.start();
+    }
+    on(event, handler) {
+        let handlers = this.eventHandlers.get(event);
+        if (!handlers) {
+            handlers = new Set();
+            this.eventHandlers.set(event, handlers);
+        }
+        handlers.add(handler);
+        return () => {
+            const current = this.eventHandlers.get(event);
+            if (!current) {
+                return;
+            }
+            current.delete(handler);
+            if (!current.size) {
+                this.eventHandlers.delete(event);
+            }
+        };
+    }
+    /** 只订阅一次，触发后自动退订 */
+    once(event, handler) {
+        const off = this.on(event, (data, message) => {
+            off();
+            handler(data, message);
+        });
+        return off;
+    }
+    /** 订阅所有消息（不区分事件名） */
+    onMessage(handler) {
+        return subscribe(this.messageHandlers, handler);
+    }
+    onStatus(handler) {
+        return subscribe(this.statusHandlers, handler);
+    }
+    onError(handler) {
+        return subscribe(this.errorHandlers, handler);
+    }
+    onOpen(handler) {
+        return subscribe(this.openHandlers, handler);
+    }
+    onClose(handler) {
+        return subscribe(this.closeHandlers, handler);
+    }
+    // ---------------------------------------------------------------------------
+    // 内部实现
+    // ---------------------------------------------------------------------------
+    get retryBaseDelay() {
+        return this.options.retryBaseDelay ?? 1000;
+    }
+    get retryMaxDelay() {
+        return this.options.retryMaxDelay ?? 30_000;
+    }
+    get maxRetry() {
+        return this.options.maxRetry ?? Infinity;
+    }
+    get stableAfter() {
+        return this.options.stableAfter ?? 10_000;
+    }
+    get reconnectOnEnd() {
+        return this.options.reconnectOnEnd ?? true;
+    }
+    reset() {
+        this.finished = false;
+        this.attempt = 0;
+        this.idleTimedOut = false;
+        this.rotating = false;
+        this.suspended = null;
+        this.serverRetryDelay = undefined;
+        this.clearTimers();
+        this.cancelController = new AbortController();
+        this.attemptController = null;
+        this.parser.reset();
+    }
+    async connect() {
+        while (!this.finished) {
+            if (this.suspended) {
+                // 挂起期间不重连，等 resume() 唤醒
+                await this.waitForResume();
+                continue;
+            }
+            const startedAt = Date.now();
+            this.setState(this.attempt === 0 ? "connecting" : "reconnecting");
+            this.attemptController = new AbortController();
+            const signal = this.attemptController.signal;
+            let failure = null;
+            try {
+                await this.openOnce(signal);
+            }
+            catch (error) {
+                failure = toSSEError(error);
+            }
+            this.clearIdle();
+            this.clearRotate();
+            if (this.finished) {
+                return;
+            }
+            if (this.suspended) {
+                this.setState("idle");
+                continue;
+            }
+            // 主动轮换：立即重连并保留 lastEventId，不走退避
+            if (this.rotating) {
+                this.rotating = false;
+                this.attempt = 0;
+                continue;
+            }
+            // 空闲超时按「可重试的网络异常」处理，避免心跳缺失时连接假死
+            if (this.idleTimedOut) {
+                this.idleTimedOut = false;
+                failure = new SSEError("SSE 连接空闲超时，准备重连", { kind: "heartbeat", retryable: true });
+            }
+            const elapsed = Date.now() - startedAt;
+            // 连接存活足够久，说明本次失败是偶发的，重置重试计数
+            if (elapsed >= this.stableAfter) {
+                this.attempt = 0;
+            }
+            this.attempt += 1;
+            if (failure) {
+                this.emit(this.errorHandlers, failure, this.attempt);
+            }
+            if (!failure && !this.reconnectOnEnd) {
+                this.finish("end");
+                return;
+            }
+            const delay = await this.decideDelay({
+                attempt: this.attempt,
+                error: failure ?? undefined,
+                elapsed,
+            });
+            if (delay === false) {
+                this.finish(failure ? "error" : "end", failure ?? undefined);
+                return;
+            }
+            this.setState("reconnecting");
+            await this.sleep(delay);
+        }
+    }
+    /** 建立一次连接并持续读取，直到流结束（失败时抛错） */
+    async openOnce(signal) {
+        const { url, method = "POST", body, fetch: fetchImpl } = this.options;
+        const init = {
+            method,
+            headers: await this.resolveHeaders(),
+            body: method === "GET" || body === undefined ? undefined : serializeBody(body),
+            signal,
+            cache: "no-store",
+            credentials: "same-origin",
+        };
+        const response = fetchImpl ? await fetchImpl(url, init) : await fetch(url, init);
+        if (!response.ok) {
+            throw new SSEError(`SSE 请求失败：HTTP ${response.status}`, {
+                kind: "http",
+                status: response.status,
+                retryable: isRetryableStatus(response.status),
+            });
+        }
+        if (this.options.strictContentType !== false) {
+            const contentType = (response.headers.get("content-type") ?? "").toLowerCase();
+            if (!contentType.startsWith(EVENT_STREAM_CONTENT_TYPE)) {
+                // 最典型的两种原因：被网关/鉴权页拦截返回 HTML，或后端没设 produces
+                throw new SSEError(`SSE 响应的 content-type 不是 ${EVENT_STREAM_CONTENT_TYPE}，实际为 "${contentType || "(空)"}"`, { kind: "protocol", status: response.status, retryable: false });
+            }
+        }
+        if (!response.body) {
+            throw new SSEError("当前环境不支持流式响应读取（response.body 为空）", {
+                kind: "protocol",
+                status: response.status,
+                retryable: false,
+            });
+        }
+        this.setState("open");
+        this.armRotate();
+        this.emit(this.openHandlers, response);
+        this.parser.reset();
+        const reader = response.body.getReader();
+        // 用 stream 模式解码，避免多字节字符被切在两个 chunk 之间时出现乱码
+        const decoder = new TextDecoder("utf-8");
+        this.armIdle();
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    break;
+                }
+                this.armIdle();
+                this.parser.feed(decoder.decode(value, { stream: true }));
+                if (this.parser.overflowed) {
+                    // 服务端从不发空行或单条消息过大，重连也不会好转
+                    throw new SSEError("SSE 数据超出解析缓冲上限，已重置连接", {
+                        kind: "protocol",
+                        retryable: false,
+                    });
+                }
+            }
+            this.parser.feed(decoder.decode());
+        }
+        finally {
+            try {
+                reader.releaseLock();
+            }
+            catch {
+                // abort 之后 releaseLock 可能抛错，忽略即可
+            }
+            this.clearIdle();
+            this.clearRotate();
+        }
+    }
+    async resolveHeaders() {
+        const { headers, method = "POST" } = this.options;
+        const extra = typeof headers === "function" ? await headers() : headers;
+        const resolved = new Headers(extra);
+        if (!resolved.has("Accept")) {
+            resolved.set("Accept", EVENT_STREAM_CONTENT_TYPE);
+        }
+        if (method !== "GET" && !resolved.has("Content-Type")) {
+            resolved.set("Content-Type", "application/json");
+        }
+        if (this.lastEventIdValue) {
+            resolved.set("Last-Event-ID", this.lastEventIdValue);
+        }
+        return resolved;
+    }
+    handleParsedEvent(event) {
+        // 结束哨兵要在 parse 之前判断：`[DONE]` 不是合法 JSON，先解析会直接报错
+        if (this.options.endSignal !== undefined && event.data === this.options.endSignal) {
+            this.finish("end");
+            return;
+        }
+        let data = event.data;
+        if (this.options.parse) {
+            try {
+                data = this.options.parse(event.data);
+            }
+            catch (error) {
+                this.reportHandlerError(error);
+                return;
+            }
+        }
+        const id = event.id || this.lastEventIdValue;
+        if (id) {
+            this.lastEventIdValue = id;
+        }
+        const name = event.event || "message";
+        // 白名单过滤放在 id 更新之后，保证续传位置不回退
+        if (this.eventFilter && !this.eventFilter.has(name)) {
+            return;
+        }
+        this.dispatch({
+            id,
+            event: name,
+            data,
+            raw: event.data,
+            receivedAt: Date.now(),
+        });
+    }
+    dispatch(message) {
+        this.emit(this.messageHandlers, message);
+        const named = this.eventHandlers.get(message.event);
+        if (named) {
+            for (const handler of [...named]) {
+                this.safeCall(handler, message.data, message);
+            }
+        }
+        if (message.event !== "*") {
+            const wildcard = this.eventHandlers.get("*");
+            if (wildcard) {
+                for (const handler of [...wildcard]) {
+                    this.safeCall(handler, message.data, message);
+                }
+            }
+        }
+    }
+    emit(handlers, ...args) {
+        for (const handler of [...handlers]) {
+            this.safeCall(handler, ...args);
+        }
+    }
+    safeCall(handler, ...args) {
+        try {
+            handler(...args);
+        }
+        catch (error) {
+            this.reportHandlerError(error);
+        }
+    }
+    reportHandlerError(error) {
+        if (this.options.onHandlerError) {
+            this.options.onHandlerError(error);
+            return;
+        }
+        console.error("[sse-client] 回调函数抛出异常", error);
+    }
+    async decideDelay(context) {
+        if (this.options.retry) {
+            return await this.options.retry(context);
+        }
+        if (context.error && !context.error.retryable) {
+            return false;
+        }
+        if (context.attempt > this.maxRetry) {
+            return false;
+        }
+        return this.nextDelay(context.attempt);
+    }
+    /** 重连延迟：服务端 `retry:` 优先，否则指数退避 + ±20% 抖动 */
+    nextDelay(attempt) {
+        if (this.serverRetryDelay !== undefined) {
+            return Math.max(Math.min(this.serverRetryDelay, this.retryMaxDelay), MIN_RETRY_DELAY);
+        }
+        const exponential = Math.min(this.retryMaxDelay, this.retryBaseDelay * 2 ** (attempt - 1));
+        const jittered = Math.round(exponential * (0.8 + Math.random() * 0.4));
+        return Math.max(jittered, MIN_RETRY_DELAY);
+    }
+    sleep(delay) {
+        return new Promise((resolve) => {
+            if (this.finished) {
+                resolve();
+                return;
+            }
+            const onCancel = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            const timer = setTimeout(() => {
+                this.cancelController.signal.removeEventListener("abort", onCancel);
+                resolve();
+            }, delay);
+            this.cancelController.signal.addEventListener("abort", onCancel, { once: true });
+        });
+    }
+    waitForResume() {
+        if (this.finished) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            // 只由 resume() / finish() 唤醒，循环因此不会在挂起时退出
+            this.resumeWaiter = resolve;
+        });
+    }
+    armIdle() {
+        const timeout = this.options.idleTimeout ?? 0;
+        if (!timeout) {
+            return;
+        }
+        this.clearIdle();
+        this.idleTimer = setTimeout(() => {
+            this.idleTimedOut = true;
+            this.attemptController?.abort();
+        }, timeout);
+    }
+    armRotate() {
+        const interval = this.options.rotateInterval ?? 0;
+        if (!interval) {
+            return;
+        }
+        this.clearRotate();
+        this.rotateTimer = setTimeout(() => {
+            this.rotating = true;
+            this.attemptController?.abort();
+        }, interval);
+    }
+    clearIdle() {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+    }
+    clearRotate() {
+        if (this.rotateTimer) {
+            clearTimeout(this.rotateTimer);
+            this.rotateTimer = null;
+        }
+    }
+    clearTimers() {
+        this.clearIdle();
+        this.clearRotate();
+    }
+    setState(next) {
+        if (this.state === next) {
+            return;
+        }
+        this.state = next;
+        this.emit(this.statusHandlers, next);
+    }
+    // ---------------------------------------------------------------------------
+    // 断网 / 切后台
+    // ---------------------------------------------------------------------------
+    /** 网络上下线始终启用：断网期间不重连，恢复后立即重连 */
+    bindLifecycle() {
+        if (this.lifecycleBound) {
+            return;
+        }
+        this.lifecycleBound = true;
+        if (typeof window !== "undefined" && typeof window.addEventListener === "function") {
+            this.onOffline = () => this.suspend("offline");
+            this.onOnline = () => {
+                if (this.suspended === "offline") {
+                    this.resume();
+                }
+            };
+            window.addEventListener("offline", this.onOffline);
+            window.addEventListener("online", this.onOnline);
+        }
+        if (this.options.pauseWhenHidden &&
+            typeof document !== "undefined" &&
+            typeof document.addEventListener === "function") {
+            this.onVisibilityChange = () => {
+                if (document.hidden) {
+                    this.suspend("hidden");
+                }
+                else if (this.suspended === "hidden") {
+                    this.resume();
+                }
+            };
+            document.addEventListener("visibilitychange", this.onVisibilityChange);
+        }
+    }
+    unbindLifecycle() {
+        if (typeof window !== "undefined" && typeof window.removeEventListener === "function") {
+            if (this.onOffline)
+                window.removeEventListener("offline", this.onOffline);
+            if (this.onOnline)
+                window.removeEventListener("online", this.onOnline);
+        }
+        if (this.onVisibilityChange && typeof document !== "undefined") {
+            document.removeEventListener("visibilitychange", this.onVisibilityChange);
+        }
+        this.onOffline = undefined;
+        this.onOnline = undefined;
+        this.onVisibilityChange = undefined;
+        this.lifecycleBound = false;
+    }
+    suspend(reason) {
+        if (this.finished || this.suspended) {
+            return;
+        }
+        this.suspended = reason;
+        this.clearTimers();
+        this.attemptController?.abort();
+        this.setState("idle");
+    }
+    resume() {
+        if (this.finished) {
+            return;
+        }
+        this.suspended = null;
+        this.attempt = 0;
+        if (this.running) {
+            this.resumeWaiter?.();
+            this.resumeWaiter = null;
+            return;
+        }
+        this.start();
+    }
+    finish(reason, error) {
+        if (this.finished) {
+            return;
+        }
+        this.finished = true;
+        this.clearTimers();
+        this.unbindLifecycle();
+        this.cancelController.abort();
+        this.attemptController?.abort();
+        // 唤醒可能卡在「挂起等待」里的连接循环
+        this.resumeWaiter?.();
+        this.resumeWaiter = null;
+        this.setState("closed");
+        this.emit(this.closeHandlers, reason, error);
+    }
+}
+/** 请求体序列化：字符串 / Blob / FormData 原样发送，其余按 JSON */
+function serializeBody(body) {
+    if (typeof body === "string" || body instanceof Blob || body instanceof FormData) {
+        return body;
+    }
+    return JSON.stringify(body);
+}
+/** 统一的订阅/退订实现 */
+function subscribe(handlers, handler) {
+    handlers.add(handler);
+    return () => {
+        handlers.delete(handler);
+    };
+}
+//# sourceMappingURL=client.js.map

package/client.js.map

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

package/errors.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 连接异常分类，便于日志/埋点聚合，也便于 `retry` 策略区分处理：
+ * - `http`：服务端返回非 2xx
+ * - `network`：网络层失败（DNS、连接重置等）
+ * - `heartbeat`：静默超时，连接疑似僵死
+ * - `protocol`：响应不符合 SSE 约定（content-type 不对、缓冲溢出）
+ * - `aborted`：连接被中断（切后台、断网挂起、主动关闭）
+ * - `retry-exhausted`：重试次数耗尽
+ */
+export type SSEErrorKind = "http" | "network" | "heartbeat" | "protocol" | "aborted" | "retry-exhausted";
+/** 连接异常，区分「可重试」与「不可重试」，避免 401 之类错误被无限重连 */
+export declare class SSEError extends Error {
+    /** 异常分类 */
+    readonly kind: SSEErrorKind;
+    /** HTTP 状态码，仅 kind === "http" 时有值 */
+    readonly status?: number;
+    /** 是否允许重试 */
+    readonly retryable: boolean;
+    constructor(message: string, options?: {
+        kind?: SSEErrorKind;
+        status?: number;
+        retryable?: boolean;
+        cause?: unknown;
+    });
+}
+/** 这些状态码说明服务端暂时不可用，可以重试 */
+export declare function isRetryableStatus(status: number): boolean;
+/** 把任意异常归一成 SSEError */
+export declare function toSSEError(error: unknown): SSEError;
+//# sourceMappingURL=errors.d.ts.map

package/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAEzG,2CAA2C;AAC3C,qBAAa,QAAS,SAAQ,KAAK;IACjC,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa;IACb,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAG1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,YAAY,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAW/F;AAED,2BAA2B;AAC3B,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAwB;AACxB,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAUnD"}