261022_03_ENH: 발송 취소 가능 여부 타입과 판별 헬퍼 추가

This commit is contained in:
2026-10-22 15:42:49 +09:00
parent 1e71bdcfee
commit 63ee0ab049
6 changed files with 36 additions and 6 deletions

View File

@@ -228,13 +228,19 @@ export type ReportExcelResponse = FileResponse;
/** 현재 취소 상태는 cancellationStatus로 판단하며 cancelDt만으로 판단하지 않는다. */
export type BulkSendInfo = {
/**
* 조회 시점의 예약 취소 가능 여부. 취소 버튼 표시·활성화 기준으로 사용한다.
* 조회 이후 상태가 바뀔 수 있으므로 최종 결과는 취소 API 응답(SendCancelResponse) 건수로 판단한다.
* 구버전 응답에서는 값이 없으며(undefined), 이 경우 취소 불가로 취급한다.
*/
cancelable?: boolean;
/** 벌크 취소 요청자 이력. */
cancelUser?: string;
/** 벌크 취소 요청 일시 이력. 현재 상태 판정에 사용하지 않는다. */
cancelDt?: string;
/** 현재 취소 상태인 상세 건수. */
canceledCount?: number;
/** 벌크의 현재 취소 상태. */
/** 벌크의 현재 취소 상태. 취소 가능 여부는 cancelable로 판단한다. */
cancellationStatus?: SendCancellationStatus;
bulkSendKey: string;
reqstSvc: string;
@@ -256,6 +262,12 @@ export type BulkSendInfo = {
* 표시명은 서버의 resultLabel을 그대로 사용한다("예약 취소"). 별도 결과 코드 목록 API는 없다.
*/
export type SendInfo = {
/**
* 조회 시점의 예약 취소 가능 여부. 취소 버튼 표시·활성화 기준으로 사용한다.
* 조회 이후 상태가 바뀔 수 있으므로 최종 결과는 취소 API 응답(SendCancelResponse) 건수로 판단한다.
* 구버전 응답에서는 값이 없으며(undefined), 이 경우 취소 불가로 취급한다.
*/
cancelable?: boolean;
/** 개별 취소 식별자. cmid가 아니다. */
sendIdx?: number;
/** 취소 요청자. */
@@ -293,6 +305,12 @@ export type SendInfo = {
* 별도 결과 코드 목록 API는 없다.
*/
export type SendResultInfo = {
/**
* 조회 시점의 예약 취소 가능 여부. 취소 버튼 표시·활성화 기준으로 사용한다.
* 조회 이후 상태가 바뀔 수 있으므로 최종 결과는 취소 API 응답(SendCancelResponse) 건수로 판단한다.
* 구버전 응답에서는 값이 없으며(undefined), 이 경우 취소 불가로 취급한다.
*/
cancelable?: boolean;
/** 개별 취소 식별자. cmid가 아니다. 최신 발송 축약 조회에는 제공되지 않는다. */
sendIdx?: number;
/** 취소 요청자. */

View File

@@ -7,8 +7,16 @@ export const EMAIL_RESERVE_CANCELED_RESULT_CODE = 108;
/** 문자(SMS, LMS_MMS)·알림톡(KKO) 예약 취소 결과 코드. */
export const SMS_KKO_RESERVE_CANCELED_RESULT_CODE = 9998;
/**
* 예약 취소 버튼을 활성화할 수 있는지 판단한다. cancelable === true일 때만 true.
* 값이 없으면(구버전 응답) false. cancelDt나 결과 라벨·코드로 추정하지 않는다.
*/
export const isSendCancelable = (item: { cancelable?: boolean }): boolean =>
item.cancelable === true;
/**
* 채널과 resultCode로 개별 건의 현재 예약 취소 상태를 판단한다.
* 현재 취소 상태 표시용이며, 취소 가능 여부 판단에는 isSendCancelable을 사용한다.
* cancelDt는 요청 이력이므로 상태 판정에 사용하지 않는다. 알 수 없는 채널은 false.
* 표시명은 서버의 resultViewLabel/resultLabel을 그대로 사용한다("예약 취소").
* 별도 결과 코드 목록 API는 없다.