import * as Cause from "effect/Cause"; import * as Duration from "effect/Duration"; import * as Effect from "effect/Effect"; import * as Exit from "effect/Exit"; import * as Layer from "effect/Layer"; import * as ManagedRuntime from "effect/ManagedRuntime"; import * as Option from "effect/Option"; import * as Scope from "effect/Scope"; import * as Stream from "effect/Stream"; import { RpcClient } from "effect/unstable/rpc"; import { ClientTracingLive } from "../observability/clientTracing"; import { clearAllTrackedRpcRequests } from "./requestLatencyState"; import { createWsRpcProtocolLayer, makeWsRpcProtocolClient, type WsProtocolLifecycleHandlers, type WsRpcProtocolClient, type WsRpcProtocolSocketUrlProvider, } from "./protocol"; import { isTransportConnectionErrorMessage } from "./transportError"; interface SubscribeOptions { readonly retryDelay?: Duration.Input; readonly onResubscribe?: () => void; readonly tag?: string; } interface RequestOptions { readonly timeout?: Option.Option; } const DEFAULT_SUBSCRIPTION_RETRY_DELAY_MS = Duration.millis(250); const NOOP: () => void = () => undefined; interface TransportSession { readonly clientPromise: Promise; readonly clientScope: Scope.Closeable; readonly runtime: ManagedRuntime.ManagedRuntime; } interface StreamRequestStartInfo { readonly id: string; readonly tag: string; readonly stream: boolean; } function formatErrorMessage(error: unknown): string { if (error instanceof Error && error.message.trim().length > 0) { return error.message; } return String(error); } export class WsTransport { private readonly url: WsRpcProtocolSocketUrlProvider; private readonly lifecycleHandlers: WsProtocolLifecycleHandlers | undefined; private disposed = false; private hasReportedTransportDisconnect = false; private intentionalCloseDepth = 0; private reconnectChain: Promise = Promise.resolve(); private nextSessionId = 0; private activeSessionId = 0; private session: TransportSession; private lastHeartbeatPongAt = 0; private readonly streamRequestStartListeners = new Set<(info: StreamRequestStartInfo) => void>(); constructor( url: WsRpcProtocolSocketUrlProvider, lifecycleHandlers?: WsProtocolLifecycleHandlers, ) { this.url = url; this.lifecycleHandlers = lifecycleHandlers; this.session = this.createSession(); } async request( execute: (client: WsRpcProtocolClient) => Effect.Effect, _options?: RequestOptions, ): Promise { if (this.disposed) { throw new Error("Transport disposed"); } const session = this.session; const client = await session.clientPromise; return await session.runtime.runPromise(Effect.suspend(() => execute(client))); } async requestStream( connect: (client: WsRpcProtocolClient) => Stream.Stream, listener: (value: TValue) => void, ): Promise { if (this.disposed) { throw new Error("Transport disposed"); } const session = this.session; const client = await session.clientPromise; await session.runtime.runPromise( Stream.runForEach(connect(client), (value) => Effect.sync(() => { try { listener(value); } catch { // Swallow listener errors so the stream can finish cleanly. } }), ), ); } subscribe( connect: (client: WsRpcProtocolClient) => Stream.Stream, listener: (value: TValue) => void, options?: SubscribeOptions, ): () => void { if (this.disposed) { return () => undefined; } let active = true; let hasReceivedValue = false; const retryDelayMs = Duration.toMillis( Duration.fromInputUnsafe(options?.retryDelay ?? DEFAULT_SUBSCRIPTION_RETRY_DELAY_MS), ); let cancelCurrentStream: () => void = NOOP; void (async () => { for (;;) { if (!active || this.disposed) { return; } const session = this.session; try { const runningStream = this.runStreamOnSession( session, connect, listener, { ...(options?.tag === undefined ? {} : { tag: options.tag }), ...(hasReceivedValue ? { onStarted: () => { try { options?.onResubscribe?.(); } catch { // Swallow reconnect hook errors so the stream can recover. } }, } : {}), }, () => active, () => { this.hasReportedTransportDisconnect = false; hasReceivedValue = true; }, ); cancelCurrentStream = runningStream.cancel; await runningStream.completed; cancelCurrentStream = NOOP; } catch (error) { cancelCurrentStream = NOOP; if (!active || this.disposed) { return; } if (session !== this.session) { continue; } const formattedError = formatErrorMessage(error); if (!isTransportConnectionErrorMessage(formattedError)) { console.warn("WebSocket RPC subscription failed", { error: formattedError, }); return; } if (!this.hasReportedTransportDisconnect) { console.warn("WebSocket RPC subscription disconnected", { error: formattedError, }); } this.hasReportedTransportDisconnect = true; await sleep(retryDelayMs); } } })(); return () => { active = false; cancelCurrentStream(); }; } async reconnect() { if (this.disposed) { throw new Error("Transport disposed"); } const reconnectOperation = this.reconnectChain.then(async () => { if (this.disposed) { throw new Error("Transport disposed"); } clearAllTrackedRpcRequests(); this.lastHeartbeatPongAt = 0; const previousSession = this.session; this.session = this.createSession(); await this.closeSession(previousSession); }); this.reconnectChain = reconnectOperation.catch(() => undefined); await reconnectOperation; } isHeartbeatFresh(maxAgeMs = 15_000): boolean { return this.lastHeartbeatPongAt > 0 && Date.now() - this.lastHeartbeatPongAt <= maxAgeMs; } async dispose() { if (this.disposed) { return; } this.disposed = true; await this.closeSession(this.session); } private closeSession(session: TransportSession) { this.intentionalCloseDepth += 1; return session.runtime.runPromise(Scope.close(session.clientScope, Exit.void)).finally(() => { this.intentionalCloseDepth -= 1; session.runtime.dispose(); }); } private createSession(): TransportSession { const sessionId = this.nextSessionId + 1; this.nextSessionId = sessionId; this.activeSessionId = sessionId; const runtime = ManagedRuntime.make( Layer.mergeAll( createWsRpcProtocolLayer(this.url, { ...this.lifecycleHandlers, isActive: () => !this.disposed && this.activeSessionId === sessionId, isCloseIntentional: () => this.disposed || this.intentionalCloseDepth > 0 || this.lifecycleHandlers?.isCloseIntentional?.() === true, onHeartbeatPong: () => { this.lastHeartbeatPongAt = Date.now(); this.lifecycleHandlers?.onHeartbeatPong?.(); }, onRequestStart: (info) => { this.lifecycleHandlers?.onRequestStart?.(info); if (!info.stream) { return; } for (const listener of this.streamRequestStartListeners) { listener(info); } }, }), ClientTracingLive, ), ); const clientScope = runtime.runSync(Scope.make()); return { runtime, clientScope, clientPromise: runtime.runPromise(Scope.provide(clientScope)(makeWsRpcProtocolClient)), }; } private runStreamOnSession( session: TransportSession, connect: (client: WsRpcProtocolClient) => Stream.Stream, listener: (value: TValue) => void, requestStart: { readonly tag?: string; readonly onStarted?: () => void; }, isActive: () => boolean, markValueReceived: () => void, ): { readonly cancel: () => void; readonly completed: Promise; } { let resolveCompleted!: () => void; let rejectCompleted!: (error: unknown) => void; const completed = new Promise((resolve, reject) => { resolveCompleted = resolve; rejectCompleted = reject; }); let requestStartListener: ((info: StreamRequestStartInfo) => void) | null = null; if (requestStart.onStarted) { requestStartListener = (info) => { if (!isActive() || !info.stream) { return; } if (requestStart.tag !== undefined && info.tag !== requestStart.tag) { return; } requestStart.onStarted?.(); if (requestStartListener) { this.streamRequestStartListeners.delete(requestStartListener); requestStartListener = null; } }; this.streamRequestStartListeners.add(requestStartListener); } const cancel = session.runtime.runCallback( Effect.promise(() => session.clientPromise).pipe( Effect.flatMap((client) => Stream.runForEach(connect(client), (value) => Effect.sync(() => { if (!isActive()) { return; } markValueReceived(); try { listener(value); } catch { // Swallow listener errors so the stream stays live. } }), ), ), ), { onExit: (exit) => { if (requestStartListener) { this.streamRequestStartListeners.delete(requestStartListener); requestStartListener = null; } if (Exit.isSuccess(exit)) { resolveCompleted(); return; } rejectCompleted(Cause.squash(exit.cause)); }, }, ); return { cancel, completed, }; } } function sleep(ms: number): Promise { return new Promise((resolve) => { setTimeout(resolve, ms); }); }