From bde7fa4609960d87fb07be7712b4c5b1fa08ff6e Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 5 Nov 2026 22:01:01 +0900 Subject: [PATCH] =?UTF-8?q?test(realtime):=20=EC=A1=B0=ED=95=A9=20transpor?= =?UTF-8?q?t=EC=9D=98=20OFFLINE=20=EC=9E=AC=EC=8B=9C=EB=8F=84=20=EA=B7=9C?= =?UTF-8?q?=EC=B9=99=EC=9D=84=20=ED=85=8C=EC=8A=A4=ED=8A=B8=EB=A1=9C=20?= =?UTF-8?q?=EB=8B=A4=EC=8B=9C=20=EB=A7=89=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 0929/04-01 규칙은 "환경이 online이면 transport가 낸 OFFLINE도 online 이벤트를 기다리지 않고 backoff로 재시도한다"이다 (reconnect-coordinator.ts의 RealtimeReconnectEnvironment 주석, 설계 5.3). 이 규칙을 막던 두 테스트는 SSE fetch·reader 거절이 OFFLINE이던 것을 이용했다. af00067(1103/04-04)이 SSE 거절을 PROVIDER_UNAVAILABLE로 바꾼 뒤 두 테스트는 그 kind의 재시도만 본다. 4d27b20이 지운 requireOnline() 두 줄을 되살리는 변이(MR1)에서 realtime 테스트가 모두 통과했다(리뷰 04-R4). 고른 방법: 조합 코드가 만든 transport로 그 경로를 직접 지나는 테스트 둘을 더한다. 환경은 계속 online이다. - attempt가 OFFLINE/CONNECT/retryable로 실패한다 → 3회 시도, backoff [50, 100], OFFLINE retryable로 끝난다. 관측 순서도 고정한다. - 세션이 열린 뒤 OFFLINE/RECEIVE/retryable로 닫힌다 → 3회 시도, OFFLINE retryable로 끝난다. 리뷰 대조 C1·C2와 같은 입력이고, `as never` 없이 파일의 도우미를 쓴다. 버린 대안: SSE 테스트 기대값을 OFFLINE으로 되돌리기. 템플릿 SSE는 이제 OFFLINE을 내지 않으므로 실제 동작과 다른 테스트가 된다. 위험·한계: 테스트만 더했다. 동작은 바뀌지 않는다. 그래서 RED(부모 코드)에서도 이 테스트는 통과한다. 결함을 보이는 방법은 변이 MR1이다. 검증: desktop batch에서 확인. - GREEN: node scripts/run-vitest.ts run tests/unit/realtime/ - 변이 MR1(reconnect-coordinator.ts의 두 retry 분기 뒤 OFFLINE이면 requireOnline()): 새 두 테스트가 attempts 1, result null로 실패해야 한다 Refs: 1105/04-01 --- .../realtime-reconnect-coordinator.test.ts | 87 +++++++++++++++++++ 1 file changed, 87 insertions(+) diff --git a/tests/unit/realtime/realtime-reconnect-coordinator.test.ts b/tests/unit/realtime/realtime-reconnect-coordinator.test.ts index abf6b80e..5ef1faf7 100644 --- a/tests/unit/realtime/realtime-reconnect-coordinator.test.ts +++ b/tests/unit/realtime/realtime-reconnect-coordinator.test.ts @@ -2198,6 +2198,93 @@ describe("transport failures through the reconnect coordinator", () => { ]); }); + // 1105/04-01. No template transport reports OFFLINE any more (1103/04-04), + // so the two SSE tests above no longer reach the 0929/04-01 rule. A + // composer's transport (a STOMP one, say) still may. While the environment + // stays online, its OFFLINE is retried with backoff; waiting for an online + // event that never comes would park the run with no retry and no result. + it("retries a composer transport's OFFLINE attempt failure while the browser stays online", async () => { + const clock = new ManualClock(); + const offline = realtimeFailure("OFFLINE", "CONNECT", true); + const observed: string[] = []; + let attempts = 0; + const coordinator = createRealtimeReconnectCoordinator({ + policy: policy(), + environment: new MutableOnlineEnvironment(true), + clock, + random: () => 0.5, + confirmTransportBarrier: confirmationSucceeded, + attempt: () => { + attempts += 1; + return failed(offline); + }, + observe: (observation) => observed.push(observationLabel(observation)), + }); + + let result: RealtimeResult | null = null; + void coordinator.run().then((value) => { + result = value; + }); + await advanceUntil(clock, () => result !== null); + + expect(attempts).toBe(3); + expect(clock.sleepCalls).toEqual([50, 100]); + expect(result).toEqual({ + ok: false, + error: { kind: "OFFLINE", operation: "CONNECT", retryable: true }, + }); + expect(observed).toEqual([ + "ATTEMPT_STARTED", + "RETRY_SCHEDULED:OFFLINE", + "ATTEMPT_STARTED", + "RETRY_SCHEDULED:OFFLINE", + "ATTEMPT_STARTED", + "RUN_ENDED:OFFLINE:EXHAUSTED", + ]); + }); + + it("reconnects after a composer session closes with OFFLINE while the browser stays online", async () => { + const clock = new ManualClock(); + const offline = realtimeFailure("OFFLINE", "RECEIVE", true); + const observed: string[] = []; + let attempts = 0; + const coordinator = createRealtimeReconnectCoordinator({ + policy: policy(), + environment: new MutableOnlineEnvironment(true), + clock, + random: () => 0.5, + confirmTransportBarrier: confirmationSucceeded, + attempt: () => { + attempts += 1; + return opened( + Object.freeze({ + classifyClosed: ( + receipt: RealtimeReconnectOutcome, + ) => receipt, + close: vi.fn(), + waitClosed: () => failed(offline), + }), + ); + }, + observe: (observation) => observed.push(observationLabel(observation)), + }); + + let result: RealtimeResult | null = null; + void coordinator.run().then((value) => { + result = value; + }); + await advanceUntil(clock, () => result !== null); + + expect(attempts).toBe(3); + expect(result).toEqual({ + ok: false, + error: { kind: "OFFLINE", operation: "RECEIVE", retryable: true }, + }); + expect( + observed.filter((label) => label === "RETRY_SCHEDULED:OFFLINE"), + ).toHaveLength(2); + }); + it.each(["before", "after"] as const)( "waits for the online event when the browser goes offline %s the SSE fetch rejects", async (order) => {