diff --git a/docs/architecture/realtime-events-web-push-and-bounded-polling.md b/docs/architecture/realtime-events-web-push-and-bounded-polling.md index 93317107..4659ab70 100644 --- a/docs/architecture/realtime-events-web-push-and-bounded-polling.md +++ b/docs/architecture/realtime-events-web-push-and-bounded-polling.md @@ -810,7 +810,10 @@ effectiveDelay = max(localDelay, validServerNotBefore) `waitClosed` throw를 포함한 session의 모든 종료 경로에서 한다 (`reconnect-coordinator.ts:888-902`). valid heartbeat는 SSE `onComment`와 WebSocket `HEARTBEAT_ACK` 관측이다. 조합 코드가 이를 - `markValidHeartbeatOrEvent`로 넘긴다. + `markValidHeartbeatOrEvent`로 넘긴다. WebSocket `heartbeatEligible()`이 + false인 동안(hidden 탭)은 heartbeat를 보내지 않아 ACK가 없다. 조용한 + stream은 그동안 예산을 새로 받지 못한다. hidden 연결은 닫거나 visible + 복귀 때 새 run을 만든다(0929/04-04). - stream reconnect는 realtime recovery coordinator, credential recovery는 session owner, Poll attempt 사이 cadence는 poll coordinator가 각각 소유한다. Poll-bound REST transport retry와 Query retry는 끈다. 같은 logical recovery의 diff --git a/src/adapters/realtime/websocket/websocket-connection.ts b/src/adapters/realtime/websocket/websocket-connection.ts index 0417c313..db99cd95 100644 --- a/src/adapters/realtime/websocket/websocket-connection.ts +++ b/src/adapters/realtime/websocket/websocket-connection.ts @@ -179,6 +179,13 @@ export type WebSocketConnectionDependencies = Readonly<{ | RealtimeResult | Promise>; onRecoveryRequired(request: WebSocketRecoveryRequest): void; + /** + * False pauses sending HEARTBEAT (e.g. a hidden tab, design 6.4); absent or + * true sends it. While paused no HEARTBEAT_ACK arrives, so a quiet stream + * has no valid signal and the reconnect budget is never reset + * (`isReconnectAttemptResetEligible`). Close a hidden connection, or start a + * new run when the tab is visible again (0929/04-04). + */ heartbeatEligible?(): boolean; observe?(observation: WebSocketConnectionObservation): void; verifyCursorRotation?(input: Readonly<{