/** * 경매 거부코드 → 사용자 문구 매핑(프론트 전용). * * 서버(`apps/api/.../auction-rejection.ts`)가 ack에 실어주는 설명적 거부코드 * `auctionRejectionReason`를 사람이 읽는 한국어 문구로 바꾼다. reason 문자열은 * 서버와의 계약이므로 양쪽을 함께 바꿔야 한다(서버는 영문 message도 함께 보내므로, * 매핑이 빠진 reason은 message로 폴백된다). * * 또한 ack가 없는 `error` 이벤트 채널(영문 message만 옴)도 같은 톤의 한국어로 * 바꿀 수 있도록 영문 message → 한국어 매핑을 함께 둔다. */ /** 서버 `AUCTION_REJECTION_REASON`와 1:1로 맞춘 사용자 문구. */ const REASON_TO_USER_MESSAGE: Record = { // 구조 전환 AUCTION_TRANSITION_REJECTED_BECAUSE_LIVE_STATE_CHANGED_BEFORE_APPLY: '경매 상태가 바뀌어 최신 상태로 맞췄어요. 다시 시도해 주세요.', AUCTION_TRANSITION_REJECTED_BECAUSE_AUCTION_NOT_IN_BIDDING_PHASE: '이미 입찰 단계가 아니에요. 최신 상태로 맞췄어요.', AUCTION_TRANSITION_REJECTED_BECAUSE_PHASE_DOES_NOT_ALLOW_ADVANCE: '이미 다음 단계로 넘어간 상태예요. 최신 상태로 맞췄어요.', AUCTION_TRANSITION_REJECTED_BECAUSE_NO_WINNING_BID_TO_MARK_SOLD: '낙찰할 입찰이 없어요. 최신 상태로 맞췄어요.', AUCTION_TRANSITION_REJECTED_BECAUSE_ACTIVE_BID_PRESENT: '진행 중인 입찰이 있어 유찰할 수 없어요.', AUCTION_TRANSITION_REJECTED_BECAUSE_REQUEST_COORDINATION_RETRYABLE: '잠시 처리 중이라 반영되지 않았어요. 다시 시도해 주세요.', // 입찰 BID_REJECTED_BECAUSE_BID_ROUND_ALREADY_ADVANCED: '이미 다음 선수로 넘어갔어요.', BID_REJECTED_BECAUSE_BID_ROUND_DEADLINE_PASSED: '마감되어 반영되지 않았어요.', BID_REJECTED_BECAUSE_AUCTION_NOT_IN_BIDDING_PHASE: '지금은 입찰할 수 없는 단계예요.', BID_REJECTED_BECAUSE_AMOUNT_NOT_HIGHER_THAN_CURRENT_HIGHEST: '더 높은 입찰이 있었어요.', BID_REJECTED_BECAUSE_TEAM_ROSTER_FULL: '팀 정원이 가득 찼어요.', BID_REJECTED_BECAUSE_INSUFFICIENT_REMAINING_POINTS_FOR_SLOTS: '남은 슬롯을 고려하면 포인트가 부족해요.', BID_REJECTED_BECAUSE_UNKNOWN_TEAM: '알 수 없는 팀이에요.', BID_REJECTED_BECAUSE_DUPLICATE_REQUEST_PAYLOAD_CONFLICT: '중복된 요청이에요.', BID_REJECTED_BECAUSE_RATE_LIMITED: '요청이 너무 많아요. 잠시 후 다시 시도해 주세요.', // 공통 AUCTION_REQUEST_REJECTED_BECAUSE_REALTIME_STATE_UNAVAILABLE: '실시간 상태를 불러오는 중이에요. 잠시 후 다시 시도해 주세요.', }; /** ack 없이 `error` 이벤트로만 오는 영문 message → 한국어. */ const ENGLISH_MESSAGE_TO_USER_MESSAGE: Record = { 'Bid deadline has already expired.': '마감되어 반영되지 않았어요.', 'Bid must exceed current bid.': '더 높은 입찰이 있었어요.', 'Bid round has already changed.': '이미 다음 선수로 넘어갔어요.', 'Auction is not in bidding phase.': '지금은 입찰할 수 없는 단계예요.', 'Team already has maximum members.': '팀 정원이 가득 찼어요.', 'Bid must reserve minimum points for remaining slots.': '남은 슬롯을 고려하면 포인트가 부족해요.', 'Unknown team.': '알 수 없는 팀이에요.', 'Bid request conflicts with an earlier request.': '중복된 요청이에요.', 'Cannot advance from current phase.': '이미 다음 단계로 넘어간 상태예요. 최신 상태로 맞췄어요.', 'No bid to mark sold.': '낙찰할 입찰이 없어요. 최신 상태로 맞췄어요.', 'Cannot pass a player with an active bid.': '진행 중인 입찰이 있어 유찰할 수 없어요.', }; const DEFAULT_REJECTION_MESSAGE = '요청이 반영되지 않았어요.'; const DEFAULT_ERROR_MESSAGE = '실시간 경매 연결 중 오류가 발생했습니다.'; export interface AuctionRejectionAckLike { auctionRejectionReason?: string; code?: string; message?: string; resyncRecommended?: boolean; } /** 거부 ack → 사용자 문구. reason 매핑 우선, 없으면 영문 message 매핑, 그래도 없으면 원문/기본값. */ export function resolveAuctionRejectionMessage( ack: AuctionRejectionAckLike, ): string { if (ack.auctionRejectionReason) { const mapped = REASON_TO_USER_MESSAGE[ack.auctionRejectionReason]; if (mapped) return mapped; } if (ack.message) { const mapped = ENGLISH_MESSAGE_TO_USER_MESSAGE[ack.message]; if (mapped) return mapped; } return ack.message ?? ack.code ?? DEFAULT_REJECTION_MESSAGE; } /** `error` 이벤트(영문 message) → 사용자 문구. */ export function resolveAuctionErrorMessage(message?: string): string { if (message && ENGLISH_MESSAGE_TO_USER_MESSAGE[message]) { return ENGLISH_MESSAGE_TO_USER_MESSAGE[message]; } return message ?? DEFAULT_ERROR_MESSAGE; } /** 최신 상태로 rebaseline 후 재시도가 권장되는 거부인지. */ export function isAuctionResyncRecommended(ack: AuctionRejectionAckLike): boolean { return ack.resyncRecommended === true; }