fix: recover auction client from rejected transitions

거부(특히 낙관적 동시성 CONFLICT)를 받은 클라가 낡은 상태에 멈춰 후속
액션을 반복 거부받던 문제를 해결한다.

- 서버: 거부 ack에 설명적 거부코드(auctionRejectionReason)와 resync 권장
  여부, 그리고 resync 권장 거부에 한해 최신 권위 state를 동봉한다. 구조 전환
  거부는 내부 code(CONFLICT 등)를 구조화해 던져 매핑 가능하게 한다.
- 클라: 거부 시 동봉된 state로 즉시 rebaseline(없으면 join으로 재요청)하고,
  "낡은 화면" 거부면 구조 액션을 1회 자동 재시도한다. 거부 문구를 거부코드
  기반 한국어로 매핑한다(error 이벤트 채널 포함).

신규 auction-rejection 모듈로 짧은 내부 코드를 맥락이 담긴 설명적 코드로
변환한다.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
dahyeonandClaude Opus 4.8 committed 2026-06-23 13:26:45 -07:00
1 parent 09d304d782
commit 55b80e62cd
6 files changed
+477 -15

No files matched your search

+60 -4
View File
@@ -3,6 +3,11 @@ import { io, type Socket } from 'socket.io-client';
import { API_BASE_URL, useAuthUserId } from '../config';
import { acquireAccessToken } from '../lib/auth/token-provider';
import type { ApiAuction, ApiAuctionChatMessage, Position } from './types';
import {
isAuctionResyncRecommended,
resolveAuctionErrorMessage,
resolveAuctionRejectionMessage,
} from './auctionRejectionMessages';
type ConnectionStatus =
| 'idle'
@@ -84,12 +89,14 @@ interface BidDiagnosticsPayload {
}
interface BidAckPayload {
auctionRejectionReason?: string;
bidDelta?: BidDeltaPayload | null;
bidDiagnostics?: BidDiagnosticsPayload;
bidServerTiming?: BidServerTimingPayload;
code?: string;
message?: string;
rejected?: boolean;
resyncRecommended?: boolean;
state?: ApiAuction;
}
@@ -435,7 +442,8 @@ export function useAuctionSocket(matchId: string | undefined) {
});
socket.on('error', (payload: { message?: string }) => {
setError(payload.message ?? '실시간 경매 연결 중 오류가 발생했습니다.');
// ack 없는 error 채널(영문 message만)도 같은 톤의 한국어로 매핑한다.
setError(resolveAuctionErrorMessage(payload.message));
});
})();
@@ -527,7 +535,21 @@ export function useAuctionSocket(matchId: string | undefined) {
};
}
function emitAuctionAction(eventName: string, payload: AuctionActionPayload) {
// 거부 등으로 클라 상태가 낡았을 때 서버 최신 state를 다시 받아 rebaseline한다.
// join 핸들러가 getStateByMatchId → broadcastState로 fresh state를 내려주고,
// revision 가드상 더 높은 revision이라 정상 적용된다(force-resync 아님).
function resyncAuctionState() {
const socket = socketRef.current;
if (!socket || !socket.connected || !matchId) return;
socket.emit('join', { matchId });
}
// retryAttempt: 거부 후 자동 재시도 횟수(루프 방지를 위해 1회로 제한).
function emitAuctionAction(
eventName: string,
payload: AuctionActionPayload,
retryAttempt = 0,
) {
const socket = socketRef.current;
if (!socket || !socket.connected) {
setError('소켓이 아직 연결되지 않았습니다.');
@@ -557,15 +579,41 @@ export function useAuctionSocket(matchId: string | undefined) {
actionPayload,
(ack?: {
auctionActionRequestId?: string;
auctionRejectionReason?: string;
code?: string;
message?: string;
rejected?: boolean;
resyncRecommended?: boolean;
state?: ApiAuction;
}) => {
if (ack?.rejected) {
clearPendingActionRequest(
ack?.auctionActionRequestId ?? auctionActionRequestId,
);
setError(ack.code ?? '경매 진행 상태가 반영되지 않았습니다.');
// 1) rebaseline: 서버가 동봉한 최신 state를 즉시 반영(없으면 join으로 재요청).
// commitAuctionState는 latestAuctionRef를 동기로 갱신하므로, 이후
// buildAuctionActionPayload는 최신 관측값(revision/phase/선수)을 읽는다.
if (ack.state) {
commitAuctionState(ack.state);
} else if (isAuctionResyncRecommended(ack)) {
resyncAuctionState();
}
// 2) 자동 재시도: "낡은 화면 때문에 거부"였고 동기 rebaseline 소스(state)가
// 있을 때만 1회. assignedPosition 등 원래 payload는 유지하고 관측값/요청
// id만 새로 만든다. 재시도 시에는 중간 에러 문구를 띄우지 않는다(무음 복구).
const canAutoRetry =
Boolean(ack.state) &&
isAuctionResyncRecommended(ack) &&
retryAttempt < 1;
if (canAutoRetry) {
emitAuctionAction(
eventName,
{ ...payload, ...buildAuctionActionPayload() },
retryAttempt + 1,
);
} else {
setError(resolveAuctionRejectionMessage(ack));
}
return;
}
const ackState = ack?.state;
@@ -644,7 +692,15 @@ export function useAuctionSocket(matchId: string | undefined) {
captureBidLatencyDiagnostics(ack);
if (ack?.rejected) {
clearPendingBidRequest(bidRequestId);
setError(ack.message ?? ack.code ?? '입찰이 반영되지 않았습니다.');
// 입찰 거부도 최신 state로 rebaseline(예: 0초 입찰 EXPIRED → 만료된
// 라운드 화면에서 벗어나게). 단 입찰은 자동 재시도하지 않는다(의도치
// 않은 금액 재입찰 방지).
if (ack.state) {
commitAuctionState(ack.state);
} else if (isAuctionResyncRecommended(ack)) {
resyncAuctionState();
}
setError(resolveAuctionRejectionMessage(ack));
return;
}
if (ack?.bidDelta) {