@rfkit/json-rpc-websocket 0.2.0 → 0.2.1

package/core/client.d.ts

@@ -0,0 +1,107 @@
+/**
+ * 现代化 JSON-RPC WebSocket 客户端
+ * 特性：
+ * - 完全类型安全
+ * - 自动重连
+ * - 请求超时
+ * - 心跳检测
+ * - 流式响应
+ * - 性能监控
+ */
+import type { JsonRpcResponse } from '../types/jsonrpc';
+import type { ConnectionOptions, NotificationOptions, PerformanceStats, RequestOptions, SocketEvents, StreamController, StreamOptions } from '../types/socket';
+import { ConnectionState } from '../types/socket';
+import { EventEmitter } from './event-emitter';
+export declare class JsonRpcWebSocketClient extends EventEmitter<SocketEvents> {
+    private ws;
+    private options;
+    private pendingRequests;
+    private streamCallbacks;
+    private reconnectAttempts;
+    private reconnectTimeoutId;
+    private heartbeatIntervalId;
+    private stats;
+    private responseTimes;
+    constructor(options: ConnectionOptions);
+    /**
+     * 获取连接状态
+     */
+    get state(): ConnectionState;
+    /**
+     * 是否已连接
+     */
+    get isConnected(): boolean;
+    /**
+     * 获取性能统计
+     */
+    getStats(): Readonly<PerformanceStats>;
+    /**
+     * 建立连接
+     */
+    private connect;
+    /**
+     * 处理连接打开
+     */
+    private handleOpen;
+    /**
+     * 处理收到消息
+     */
+    private handleMessage;
+    /**
+     * 处理连接关闭
+     */
+    private handleClose;
+    /**
+     * 处理连接错误
+     */
+    private handleError;
+    /**
+     * 安排重连
+     */
+    private scheduleReconnect;
+    /**
+     * 启动心跳
+     */
+    private startHeartbeat;
+    /**
+     * 停止心跳
+     */
+    private stopHeartbeat;
+    /**
+     * 拒绝所有待处理的请求
+     */
+    private rejectAllPendingRequests;
+    /**
+     * 更新响应时间统计
+     */
+    private updateResponseTime;
+    /**
+     * 发送请求
+     */
+    request<TResult = unknown, TParams = unknown>(options: RequestOptions<TParams>): Promise<TResult>;
+    /**
+     * 发送通知（不需要响应）
+     */
+    notify<TParams = unknown>(options: NotificationOptions<TParams>): Promise<void>;
+    /**
+     * 创建流式请求
+     */
+    stream<TResult = unknown, TParams = unknown>(options: StreamOptions<TParams>, callback: (response: JsonRpcResponse<TResult>) => void): StreamController;
+    /**
+     * 发送原始数据（用于转发）
+     */
+    sendRaw(data: ArrayBuffer | Uint8Array): void;
+    /**
+     * 关闭连接
+     */
+    close(code?: number, reason?: string): void;
+    /**
+     * 更换 URL 并重连
+     */
+    reconnectToUrl(url: string): void;
+    /**
+     * 调试日志
+     */
+    private log;
+}
+//# sourceMappingURL=client.d.ts.map

package/core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAEhB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAe,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAa/C,qBAAa,sBAAuB,SAAQ,YAAY,CAAC,YAAY,CAAC;IACpE,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,eAAe,CAGnB;IACJ,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,mBAAmB,CAA+B;IAC1D,OAAO,CAAC,KAAK,CAQX;IACF,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,EAAE,iBAAiB;IAMtC;;OAEG;IACH,IAAI,KAAK,IAAI,eAAe,CAE3B;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,QAAQ,IAAI,QAAQ,CAAC,gBAAgB,CAAC;IAItC;;OAEG;IACH,OAAO,CAAC,OAAO;IAmBf;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkDrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAQhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACG,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAChD,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC;IA0CnB;;OAEG;IACG,MAAM,CAAC,OAAO,GAAG,OAAO,EAC5B,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACH,MAAM,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACzC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,EAC/B,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,IAAI,GACrD,gBAAgB;IA0CnB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI;IAQ7C;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAuB3C;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQjC;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/core/event-emitter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 类型安全的事件发射器
+ */
+export declare class EventEmitter<TEvents extends Record<string, unknown>> {
+    private listeners;
+    /**
+     * 监听事件
+     */
+    on<K extends keyof TEvents>(event: K, listener: (data: TEvents[K]) => void): () => void;
+    /**
+     * 监听一次事件
+     */
+    once<K extends keyof TEvents>(event: K, listener: (data: TEvents[K]) => void): () => void;
+    /**
+     * 取消监听事件
+     */
+    off<K extends keyof TEvents>(event: K, listener: (data: TEvents[K]) => void): void;
+    /**
+     * 触发事件
+     */
+    emit<K extends keyof TEvents>(event: K, data: TEvents[K]): void;
+    /**
+     * 移除所有监听器
+     */
+    removeAllListeners(event?: keyof TEvents): void;
+    /**
+     * 获取事件监听器数量
+     */
+    listenerCount(event: keyof TEvents): number;
+}
+//# sourceMappingURL=event-emitter.d.ts.map

package/core/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../src/core/event-emitter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,YAAY,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,OAAO,CAAC,SAAS,CAGb;IAEJ;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EACxB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GACnC,MAAM,IAAI;IAUb;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAC1B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GACnC,MAAM,IAAI;IAQb;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,EACzB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GACnC,IAAI;IAUP;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAgB/D;;OAEG;IACH,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI;IAQ/C;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,OAAO,GAAG,MAAM;CAG5C"}

package/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * JSON-RPC WebSocket Client (v2)
+ * 现代化、类型安全的 JSON-RPC over WebSocket 实现
+ */
+export { JsonRpcWebSocketClient as default } from './core/client';
+export { JsonRpcWebSocketClient } from './core/client';
+export type { JsonRpcRequest, JsonRpcResponse, JsonRpcSuccess, JsonRpcError, JsonRpcNotification, JsonRpcMessage, JsonRpcErrorCode, ConnectionOptions, RequestOptions, NotificationOptions, StreamOptions, StreamController, SocketEvents, PerformanceStats, ConnectionState, MessageEventData, SocketEvent, } from './types';
+export { encode, decode, serialize, deserialize } from './pack';
+export type { SerializeOptions, DeserializeOptions } from './pack/types';
+export { generateUUID } from './tools';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,sBAAsB,IAAI,OAAO,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGvD,YAAY,EAEV,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAEhB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAEhB,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGzE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}