@weifuwujs/weifuwu 0.9.0

package/dist/websocket/close-code.d.ts

@@ -0,0 +1,22 @@
+/**
+ * WebSocket 关闭码与校验（RFC 6455 §7.4）。
+ *
+ * 引擎实现已交给 `ws`，这里只保留框架公开 API 需要的最小常量与校验。
+ */
+export declare const CLOSE_CODE: {
+    readonly NORMAL: 1000;
+    readonly GOING_AWAY: 1001;
+    readonly PROTOCOL_ERROR: 1002;
+    readonly UNSUPPORTED_DATA: 1003;
+    readonly NO_STATUS: 1005;
+    readonly ABNORMAL: 1006;
+    readonly INVALID_PAYLOAD: 1007;
+    readonly POLICY_VIOLATION: 1008;
+    readonly MESSAGE_TOO_BIG: 1009;
+    readonly MANDATORY_EXTENSION: 1010;
+    readonly INTERNAL_ERROR: 1011;
+    readonly TLS_HANDSHAKE: 1015;
+};
+/** 关闭码是否允许由应用主动发送 */
+export declare function isValidCloseCode(code: number): boolean;
+//# sourceMappingURL=close-code.d.ts.map

package/dist/websocket/close-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-code.d.ts","sourceRoot":"","sources":["../../src/websocket/close-code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAab,CAAA;AAEV,qBAAqB;AACrB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWtD"}

package/dist/websocket/close-code.js

@@ -0,0 +1,35 @@
+/**
+ * WebSocket 关闭码与校验（RFC 6455 §7.4）。
+ *
+ * 引擎实现已交给 `ws`，这里只保留框架公开 API 需要的最小常量与校验。
+ */
+export const CLOSE_CODE = {
+    NORMAL: 1000,
+    GOING_AWAY: 1001,
+    PROTOCOL_ERROR: 1002,
+    UNSUPPORTED_DATA: 1003,
+    NO_STATUS: 1005,
+    ABNORMAL: 1006,
+    INVALID_PAYLOAD: 1007,
+    POLICY_VIOLATION: 1008,
+    MESSAGE_TOO_BIG: 1009,
+    MANDATORY_EXTENSION: 1010,
+    INTERNAL_ERROR: 1011,
+    TLS_HANDSHAKE: 1015,
+};
+/** 关闭码是否允许由应用主动发送 */
+export function isValidCloseCode(code) {
+    if (code >= 3000 && code <= 4999)
+        return true;
+    if (code < 1000)
+        return false;
+    switch (code) {
+        case CLOSE_CODE.NO_STATUS:
+        case CLOSE_CODE.ABNORMAL:
+        case CLOSE_CODE.TLS_HANDSHAKE:
+            return false;
+        default:
+            return true;
+    }
+}
+//# sourceMappingURL=close-code.js.map

package/dist/websocket/close-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-code.js","sourceRoot":"","sources":["../../src/websocket/close-code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,IAAI;IACZ,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,IAAI;IACtB,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,IAAI;IACd,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;IACrB,mBAAmB,EAAE,IAAI;IACzB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;CACX,CAAA;AAEV,qBAAqB;AACrB,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IAC7C,IAAI,IAAI,GAAG,IAAI;QAAE,OAAO,KAAK,CAAA;IAC7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU,CAAC,SAAS,CAAC;QAC1B,KAAK,UAAU,CAAC,QAAQ,CAAC;QACzB,KAAK,UAAU,CAAC,aAAa;YAC3B,OAAO,KAAK,CAAA;QACd;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC"}

package/dist/websocket/connection.d.ts

@@ -0,0 +1,71 @@
+import type { WebSocket as WsSocket } from 'ws';
+export type WebSocketReadyState = 'open' | 'closing' | 'closed';
+export interface WebSocketMessage {
+    data: string | Uint8Array;
+    binary: boolean;
+}
+export interface WebSocketEventMap {
+    message: (data: string | Uint8Array, isBinary: boolean) => void;
+    close: (code: number, reason: string) => void;
+    error: (error: Error) => void;
+    ping: (data: Uint8Array) => void;
+    pong: (data: Uint8Array) => void;
+}
+export interface WebSocketConnectionOptions {
+    /** 协商出的子协议 */
+    protocol?: string;
+    /** 单条消息最大字节数（已在 `ws` 握手层生效，此处仅记录） */
+    maxMessageSize?: number;
+    /** 自动回 pong（由 `ws` 内核负责），默认 true */
+    autoPong?: boolean;
+    /** close 握手超时后强制断开，默认 5000ms（由 `ws` 负责） */
+    closeTimeout?: number;
+    /** 服务端主动 ping 间隔（ms），默认关闭 */
+    pingInterval?: number;
+    /** 空闲超时（ms），默认关闭 */
+    idleTimeout?: number;
+    /** @deprecated 升级时多读到的字节已由 `ws` 处理 */
+    head?: Uint8Array;
+}
+/**
+ * 服务端 WebSocket 连接。
+ *
+ * ```ts
+ * app.ws('/chat', (socket) => ({
+ *   onMessage: (socket, message) => socket.send(message.data),
+ * }))
+ * ```
+ *
+ * 握手、帧编解码、协议协商、关闭握手与自动 pong 都由 `ws` 完成；
+ * 本类只做事件与消息形状的适配。
+ */
+export declare class WebSocketConnection implements AsyncIterable<WebSocketMessage> {
+    #private;
+    constructor(ws: WsSocket, options?: WebSocketConnectionOptions);
+    get readyState(): WebSocketReadyState;
+    get protocol(): string;
+    get bufferedAmount(): number;
+    get remoteAddress(): string | undefined;
+    on<E extends keyof WebSocketEventMap>(event: E, listener: WebSocketEventMap[E]): this;
+    off<E extends keyof WebSocketEventMap>(event: E, listener: WebSocketEventMap[E]): this;
+    once<E extends keyof WebSocketEventMap>(event: E, listener: WebSocketEventMap[E]): this;
+    /** 发送文本或二进制消息，返回 false 表示内核缓冲区已满 */
+    send(data: string | Uint8Array | ArrayBuffer | ArrayBufferView): boolean;
+    /** 发送 ping 控制帧 */
+    ping(data?: Uint8Array): boolean;
+    /** 发送 pong 控制帧 */
+    pong(data?: Uint8Array): boolean;
+    /** 发起关闭握手；不传 code 表示 1000 */
+    close(code?: number, reason?: string): void;
+    /** 立即断开，不进行关闭握手 */
+    terminate(): void;
+    [Symbol.asyncIterator](): AsyncIterableIterator<WebSocketMessage>;
+    /** @internal 由框架在业务 handler 执行前调用，补发升级后立即到达的消息 */
+    start(): void;
+    /**
+     * @internal dev 护栏：连接是否已有消息消费者
+     * （`onMessage` 会经 `message` 事件派发；也计入用户监听器与活跃迭代）
+     */
+    hasMessageConsumer(): boolean;
+}
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/websocket/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,SAAS,IAAI,QAAQ,EAAE,MAAM,IAAI,CAAA;AAGxD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;IACzB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAC/D,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAA;IAChC,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAA;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oBAAoB;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,YAAW,aAAa,CAAC,gBAAgB,CAAC;;gBAwB7D,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAE,0BAA+B;IAmBlE,IAAI,UAAU,IAAI,mBAAmB,CASpC;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAKtC;IAED,EAAE,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAClC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC7B,IAAI;IAUP,GAAG,CAAC,CAAC,SAAS,MAAM,iBAAiB,EACnC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC7B,IAAI;IAKP,IAAI,CAAC,CAAC,SAAS,MAAM,iBAAiB,EACpC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC7B,IAAI;IAQP,oCAAoC;IACpC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,eAAe,GAAG,OAAO;IAQxE,kBAAkB;IAClB,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO;IAUhC,kBAAkB;IAClB,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO;IAUhC,6BAA6B;IAC7B,KAAK,CAAC,IAAI,GAAE,MAA0B,EAAE,MAAM,SAAK,GAAG,IAAI;IAa1D,mBAAmB;IACnB,SAAS,IAAI,IAAI;IAOV,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,gBAAgB,CAAC;IAgBxE,kDAAkD;IAClD,KAAK,IAAI,IAAI;IAab;;;OAGG;IACH,kBAAkB,IAAI,OAAO;CAkG9B"}

package/dist/websocket/connection.js

@@ -0,0 +1,287 @@
+import { CLOSE_CODE, isValidCloseCode } from "./close-code.js";
+/**
+ * 服务端 WebSocket 连接。
+ *
+ * ```ts
+ * app.ws('/chat', (socket) => ({
+ *   onMessage: (socket, message) => socket.send(message.data),
+ * }))
+ * ```
+ *
+ * 握手、帧编解码、协议协商、关闭握手与自动 pong 都由 `ws` 完成；
+ * 本类只做事件与消息形状的适配。
+ */
+export class WebSocketConnection {
+    #ws;
+    #listeners = new Map();
+    /** `start()` 之后因异步迭代而积压的消息 */
+    #queue = [];
+    /** `start()` 之前收到的消息，按序补发 */
+    #early = [];
+    #waiters = [];
+    #state = 'open';
+    #protocol;
+    #pingInterval;
+    #idleTimeout;
+    #closeCode = CLOSE_CODE.NO_STATUS;
+    #closeReason = '';
+    #started = false;
+    #flushed = false;
+    #iterating = false;
+    #pending = [];
+    #pingTimer;
+    #idleTimer;
+    constructor(ws, options = {}) {
+        this.#ws = ws;
+        this.#protocol = options.protocol ?? ws.protocol ?? '';
+        this.#pingInterval = options.pingInterval;
+        this.#idleTimeout = options.idleTimeout;
+        ws.on('message', (data, isBinary) => this.#onMessage(data, isBinary));
+        ws.on('close', (code, reason) => this.#onClose(code, reason.toString()));
+        ws.on('error', (error) => this.#onError(error));
+        ws.on('ping', (data) => {
+            this.#resetIdleTimer();
+            this.#emit('ping', toUint8(data));
+        });
+        ws.on('pong', (data) => {
+            this.#resetIdleTimer();
+            this.#emit('pong', toUint8(data));
+        });
+    }
+    get readyState() {
+        switch (this.#ws.readyState) {
+            case 2:
+                return 'closing';
+            case 3:
+                return 'closed';
+            default:
+                return this.#state;
+        }
+    }
+    get protocol() {
+        return this.#protocol;
+    }
+    get bufferedAmount() {
+        return this.#ws.bufferedAmount;
+    }
+    get remoteAddress() {
+        const socket = this.#ws._socket;
+        return socket?.remoteAddress;
+    }
+    on(event, listener) {
+        let set = this.#listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.#listeners.set(event, set);
+        }
+        set.add(listener);
+        return this;
+    }
+    off(event, listener) {
+        this.#listeners.get(event)?.delete(listener);
+        return this;
+    }
+    once(event, listener) {
+        const wrapped = ((...args) => {
+            this.off(event, wrapped);
+            listener(...args);
+        });
+        return this.on(event, wrapped);
+    }
+    /** 发送文本或二进制消息，返回 false 表示内核缓冲区已满 */
+    send(data) {
+        if (this.readyState !== 'open') {
+            throw new Error('WebSocket is not open');
+        }
+        this.#ws.send(data);
+        return this.#ws.bufferedAmount === 0;
+    }
+    /** 发送 ping 控制帧 */
+    ping(data) {
+        if (this.#state === 'closed' || this.#ws.readyState !== 1)
+            return false;
+        const payload = data ?? new Uint8Array(0);
+        if (payload.byteLength > 125) {
+            throw new RangeError('Control frame payload must be <= 125 bytes');
+        }
+        this.#ws.ping(payload);
+        return true;
+    }
+    /** 发送 pong 控制帧 */
+    pong(data) {
+        if (this.#state === 'closed' || this.#ws.readyState !== 1)
+            return false;
+        const payload = data ?? new Uint8Array(0);
+        if (payload.byteLength > 125) {
+            throw new RangeError('Control frame payload must be <= 125 bytes');
+        }
+        this.#ws.pong(payload);
+        return true;
+    }
+    /** 发起关闭握手；不传 code 表示 1000 */
+    close(code = CLOSE_CODE.NORMAL, reason = '') {
+        if (this.#state !== 'open' || this.#ws.readyState !== 1)
+            return;
+        if (!isValidCloseCode(code)) {
+            throw new RangeError(`Invalid WebSocket close code: ${code}`);
+        }
+        this.#state = 'closing';
+        this.#closeCode = code;
+        this.#closeReason = reason;
+        this.#stopKeepalive();
+        this.#ws.close(code, reason);
+    }
+    /** 立即断开，不进行关闭握手 */
+    terminate() {
+        if (this.#state === 'closed')
+            return;
+        this.#state = 'closed';
+        this.#stopTimers();
+        this.#ws.terminate();
+    }
+    async *[Symbol.asyncIterator]() {
+        this.#iterating = true;
+        while (true) {
+            if (this.#queue.length > 0) {
+                yield this.#queue.shift();
+                continue;
+            }
+            if (this.readyState === 'closed')
+                return;
+            const result = await new Promise((resolve, reject) => this.#waiters.push({ resolve, reject }));
+            if (result.done)
+                return;
+            yield result.value;
+        }
+    }
+    /** @internal 由框架在业务 handler 执行前调用，补发升级后立即到达的消息 */
+    start() {
+        if (this.#started)
+            return;
+        this.#started = true;
+        for (const message of this.#early.splice(0))
+            this.#pushMessage(message);
+        this.#flushPending();
+        if (this.#pingInterval && this.#pingInterval > 0) {
+            this.#pingTimer = setInterval(() => this.ping(), this.#pingInterval);
+            this.#pingTimer.unref?.();
+        }
+        this.#resetIdleTimer();
+    }
+    /**
+     * @internal dev 护栏：连接是否已有消息消费者
+     * （`onMessage` 会经 `message` 事件派发；也计入用户监听器与活跃迭代）
+     */
+    hasMessageConsumer() {
+        return (this.#listeners.get('message')?.size ?? 0) > 0 || this.#iterating;
+    }
+    // -------------------------------------------------------------------------
+    #onMessage(data, isBinary) {
+        this.#resetIdleTimer();
+        const message = isBinary
+            ? { data: toUint8(data), binary: true }
+            : { data: decodeText(data), binary: false };
+        if (this.#started)
+            this.#pushMessage(message);
+        else
+            this.#early.push(message);
+    }
+    #onClose(code, reason) {
+        this.#closeCode = code;
+        this.#closeReason = reason;
+        this.#state = 'closed';
+        this.#stopTimers();
+        this.#finish();
+    }
+    #onError(error) {
+        this.#emit('error', error);
+        if (this.readyState === 'closed' && this.#state !== 'closed') {
+            this.#onClose(this.#closeCode, this.#closeReason);
+        }
+    }
+    #pushMessage(message) {
+        const waiter = this.#waiters.shift();
+        if (waiter) {
+            waiter.resolve({ value: message, done: false });
+        }
+        else if (this.#iterating) {
+            this.#queue.push(message);
+        }
+        this.#emit('message', message.data, message.binary);
+    }
+    #finish() {
+        if (this.#flushed)
+            return;
+        this.#flushed = true;
+        for (const waiter of this.#waiters.splice(0)) {
+            waiter.resolve({ value: undefined, done: true });
+        }
+        this.#emit('close', this.#closeCode, this.#closeReason);
+    }
+    #resetIdleTimer() {
+        if (!this.#idleTimeout || this.#idleTimeout <= 0)
+            return;
+        if (this.#idleTimer)
+            clearTimeout(this.#idleTimer);
+        this.#idleTimer = setTimeout(() => {
+            this.close(CLOSE_CODE.GOING_AWAY, 'Idle timeout');
+        }, this.#idleTimeout);
+        this.#idleTimer.unref?.();
+    }
+    #stopTimers() {
+        this.#stopKeepalive();
+    }
+    #stopKeepalive() {
+        if (this.#pingTimer)
+            clearInterval(this.#pingTimer);
+        if (this.#idleTimer)
+            clearTimeout(this.#idleTimer);
+        this.#pingTimer = undefined;
+        this.#idleTimer = undefined;
+    }
+    #emit(event, ...args) {
+        const dispatch = () => {
+            const listeners = this.#listeners.get(event);
+            if (!listeners)
+                return;
+            for (const listener of listeners) {
+                try {
+                    listener(...args);
+                }
+                catch (error) {
+                    if (event !== 'error') {
+                        this.#emit('error', error instanceof Error ? error : new Error(String(error)));
+                    }
+                    else {
+                        console.error(error);
+                    }
+                }
+            }
+        };
+        if (this.#started)
+            dispatch();
+        else
+            this.#pending.push(dispatch);
+    }
+    #flushPending() {
+        const pending = this.#pending;
+        this.#pending = [];
+        for (const task of pending)
+            task();
+    }
+}
+function toUint8(data) {
+    if (Array.isArray(data))
+        return new Uint8Array(Buffer.concat(data));
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+}
+function decodeText(data) {
+    if (Array.isArray(data))
+        return Buffer.concat(data).toString('utf8');
+    if (data instanceof ArrayBuffer)
+        return Buffer.from(data).toString('utf8');
+    return data.toString('utf8');
+}
+//# sourceMappingURL=connection.js.map

package/dist/websocket/connection.js.map

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

package/dist/websocket/index.d.ts

@@ -0,0 +1,7 @@
+export { acceptWebSocket, validateUpgradeRequest } from './accept.ts';
+export type { AcceptOptions } from './accept.ts';
+export { CLOSE_CODE, isValidCloseCode } from './close-code.ts';
+export { WebSocketConnection } from './connection.ts';
+export type { WebSocketConnectionOptions, WebSocketEventMap, WebSocketMessage, WebSocketReadyState, } from './connection.ts';
+export type { WebSocketHandler, WebSocketHandlers, WebSocketLifecycle, WebSocketMiddleware, WebSocketNext, WebSocketOptions, WsRegistrar, } from './types.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,YAAY,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAA"}

package/dist/websocket/index.js

@@ -0,0 +1,4 @@
+export { acceptWebSocket, validateUpgradeRequest } from "./accept.js";
+export { CLOSE_CODE, isValidCloseCode } from "./close-code.js";
+export { WebSocketConnection } from "./connection.js";
+//# sourceMappingURL=index.js.map

package/dist/websocket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAErE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/websocket/types.d.ts

@@ -0,0 +1,66 @@
+import type { Context, ContextWithParams, Middleware, Next } from '../types.ts';
+import type { WebSocketConnection, WebSocketMessage } from './connection.ts';
+/** 每条 WS 路由 / 升级请求的选项 */
+export interface WebSocketOptions {
+    /** 服务端支持的子协议，按客户端优先级挑选第一个匹配项 */
+    protocols?: string[];
+    /** 单条消息（分片合并后）最大字节数，默认 4 MiB */
+    maxMessageSize?: number;
+    /** 自动回 pong，默认 true */
+    autoPong?: boolean;
+    /** close 握手超时（ms），默认 5000 */
+    closeTimeout?: number;
+    /** 服务端主动 ping 间隔（ms），默认关闭 */
+    pingInterval?: number;
+    /** 空闲超时（ms），默认关闭 */
+    idleTimeout?: number;
+    /** 追加到 101 响应里的头 */
+    headers?: Record<string, string>;
+}
+/**
+ * 连接的生命周期回调。三者都可选；回调抛错会走 `onError` →
+ * `app.onError` → `console.error`，并默认以 1011 关闭连接。
+ */
+export interface WebSocketLifecycle<C extends Context = Context> {
+    /** 每条消息按到达顺序串行 await（天然背压） */
+    onMessage?(socket: WebSocketConnection, message: WebSocketMessage, ctx: C): void | Promise<void>;
+    /** 恰好调用一次（正常关闭 / 错误 / terminate） */
+    onClose?(socket: WebSocketConnection, code: number, reason: string, ctx: C): void | Promise<void>;
+    /** 消息/关闭回调或底层连接出错；抛错则回落 `app.onError` → `console.error` */
+    onError?(socket: WebSocketConnection, error: Error, ctx: C): void | Promise<void>;
+}
+/**
+ * WebSocket 终端：**工厂**，每连接调用一次（可异步）。
+ *
+ * - 工厂体就是 open 钩子（欢迎语、异步加入房间都写在这里）
+ * - 闭包就是连接级状态（定时器、房间订阅……），无需外部 WeakMap
+ * - 返回生命周期对象；返回 `void` 表示纯流式模式（自行 `socket.on` / `for await`）
+ * - 工厂结算前到达的消息由框架缓冲，不会丢
+ */
+export type WebSocketHandler<C extends Context = Context> = (socket: WebSocketConnection, ctx: C) => WebSocketLifecycle<C> | void | Promise<WebSocketLifecycle<C> | void>;
+/** WS 中间件的 `next`：返回 HTTP `Response` 表示拒绝升级 */
+export type WebSocketNext<Out extends Context = Context> = Next<Out, Response | void>;
+/**
+ * WebSocket 中间件：与 HTTP 中间件是同一个 {@link Middleware} 类型，
+ * 结果类型固定为 `Response | void`（同一个实例可以同时用于 `app.use` 与 `app.ws`，
+ * 但需要把中间件注解为 `Middleware<In, Out, Response | void>`）。
+ */
+export type WebSocketMiddleware<In extends Context = Context, Out extends Context = In> = Middleware<In, Out, Response | void>;
+/** 一条 WS 路由的处理链：任意个中间件 + 最后的处理器工厂 */
+export type WebSocketHandlers<C extends Context, Path extends string> = [
+    ...middlewares: WebSocketMiddleware<ContextWithParams<C, Path>>[],
+    handler: WebSocketHandler<ContextWithParams<C, Path>>
+];
+/** `app.ws(path, ...)` 的调用签名 */
+export interface WsRegistrar<C extends Context, Prefix extends string, R> {
+    <P extends string>(path: P, handler: WebSocketHandler<ContextWithParams<C, `${Prefix}${P}`>>): R;
+    <P extends string, O1 extends Context>(path: P, middleware: WebSocketMiddleware<ContextWithParams<C, `${Prefix}${P}`>, O1>, handler: WebSocketHandler<O1 & ContextWithParams<C, `${Prefix}${P}`>>): R;
+    <P extends string, O1 extends Context, O2 extends Context>(path: P, middleware1: WebSocketMiddleware<ContextWithParams<C, `${Prefix}${P}`>, O1>, middleware2: WebSocketMiddleware<O1 & ContextWithParams<C, `${Prefix}${P}`>, O2>, handler: WebSocketHandler<O2 & ContextWithParams<C, `${Prefix}${P}`>>): R;
+    <P extends string>(path: P, options: WebSocketOptions, handler: WebSocketHandler<ContextWithParams<C, `${Prefix}${P}`>>): R;
+    <P extends string, O1 extends Context>(path: P, options: WebSocketOptions, middleware: WebSocketMiddleware<ContextWithParams<C, `${Prefix}${P}`>, O1>, handler: WebSocketHandler<O1 & ContextWithParams<C, `${Prefix}${P}`>>): R;
+    /** 带选项、3 个及以上中间件：类型不再逐步累积 */
+    <P extends string>(path: P, options: WebSocketOptions, ...handlers: WebSocketHandlers<C, `${Prefix}${P}`>): R;
+    /** 3 个及以上中间件：类型不再逐步累积 */
+    <P extends string>(path: P, ...handlers: WebSocketHandlers<C, `${Prefix}${P}`>): R;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/websocket/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/websocket/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/websocket/types.ts"],"names":[],"mappings":""}