17. Proxy — 결제는 진짜 호출 전에 확인할 게 있다

class PaymentService {  async charge(amount: number, orderId: string) {    // 검증 로직이 들어오고...    if (amount <= 0) throw new Error('금액이 이상합니다.');    // 로깅 로직이 섞이고...    console.log(`결제 시도: ${orderId}`);    // 재시도 로직까지 침투했다.    try {      await pgApi.call(amount);    } catch (e) {      // 응답이 없었다고 바로 다시 호출하면 이중 결제가 될 수 있다.      // 먼저 같은 idempotency key의 승인·거래 상태를 확인한다.    }  }}

type TransactionStatus = 'APPROVED' | 'NOT_FOUND' | 'PENDING';/** 결제 시스템의 표준 인터페이스 (Subject) */interface IPaymentGateway {  charge(amount: number, orderId: string, idempotencyKey: string): Promise<void>;  getTransactionStatus(idempotencyKey: string): Promise<TransactionStatus>;  refund(amount: number, orderId: string): Promise<void>;}/** 실제 PG사 API를 호출하는 클래스 (Real Subject) */class RealPaymentGateway implements IPaymentGateway {  private transactions = new Map<string, TransactionStatus>();  async charge(amount: number, orderId: string, idempotencyKey: string): Promise<void> {    if (this.transactions.get(idempotencyKey) === 'APPROVED') {      console.log(`[API 응답] ${orderId} 번 기존 승인 재사용`);      return;    }    console.log(`[API 호출] ${orderId} 번 주문 ${amount}원 결제 요청 중...`);    if (Math.random() < 0.3) throw new Error('PG사 일시적 네트워크 오류');    this.transactions.set(idempotencyKey, 'APPROVED');    console.log(`[API 응답] ${orderId} 번 결제 완료`);  }  async getTransactionStatus(idempotencyKey: string): Promise<TransactionStatus> {    return this.transactions.get(idempotencyKey) ?? 'NOT_FOUND';  }  async refund(amount: number, orderId: string): Promise<void> {    console.log(`[API 호출] ${orderId} 번 주문 ${amount}원 환불 완료`);  }}/** 결제 대리인 (Proxy): 검증, 로깅, 안전한 재시도를 담당한다. */class PaymentGatewayProxy implements IPaymentGateway {  constructor(private real: IPaymentGateway) {}  async charge(amount: number, orderId: string, idempotencyKey = `payment:${orderId}`): Promise<void> {    if (amount <= 0) throw new Error('결제 금액은 0원보다 커야 합니다.');    const maxAttempts = 3;    for (let attempt = 1; attempt <= maxAttempts; attempt++) {      try {        console.log(`[Proxy] ${orderId} 결제 시도 ${attempt}회차`);        await this.real.charge(amount, orderId, idempotencyKey);        console.log(`[Proxy] ${orderId} 번 결제 로그 기록 완료`);        return;      } catch (error) {        const message = error instanceof Error ? error.message : '알 수 없는 에러';        const status = await this.real.getTransactionStatus(idempotencyKey);        console.warn(`[Proxy] ${attempt}회차 실패, 거래 상태: ${status} (${message})`);        if (status === 'APPROVED') {          console.log(`[Proxy] ${orderId} 번은 이미 승인되어 성공으로 처리`);          return;        }        if (status === 'PENDING') {          throw new Error('PG 거래 상태가 확인 중입니다. 상태 확인 전 재시도하지 않습니다.');        }        if (attempt === maxAttempts) {          throw error instanceof Error ? error : new Error('결제 처리 중 알 수 없는 오류 발생');        }        // NOT_FOUND가 확인된 일시적 오류에만 같은 키로 제한 재시도한다.      }    }  }  getTransactionStatus(idempotencyKey: string): Promise<TransactionStatus> {    return this.real.getTransactionStatus(idempotencyKey);  }  async refund(amount: number, orderId: string): Promise<void> {    console.log(`[Proxy] 환불 요청 로깅: ${orderId}`);    await this.real.refund(amount, orderId);  }}async function processOrder(gateway: IPaymentGateway) {  try {    await gateway.charge(25000, 'ORDER-2024-001', 'payment:ORDER-2024-001');    console.log('매장 업무: 결제 성공 확인, 주방으로 주문 전송');  } catch (error) {    const message = error instanceof Error ? error.message : '알 수 없는 결제 오류';    console.error('매장 업무: 결제 실패 안내 고객님께 발송', message);  }}const paymentProxy = new PaymentGatewayProxy(new RealPaymentGateway());processOrder(paymentProxy);