@connextable/popbill 1.0.0

package/dist/index.mjs

@@ -0,0 +1,1599 @@
+import { PopbillErrorStage, PopbillErrorType, createInputValidationError, normalizePopbillError } from "@connextable/popbill-compat/errors";
+import { normalizeOptionalString, normalizeRequiredString, toBoolean } from "@connextable/popbill-utils";
+import { createTaxinvoicePromiseService } from "@connextable/popbill-compat/factory";
+//#region src/services/tax-invoice/adapters/error.ts
+/**
+* TaxInvoice facade 메서드를 실행하고 예외를 `PopbillApiError`로 표준화합니다.
+*/
+async function invokeTaxInvoiceMethod(context, operation, handler) {
+	try {
+		return await handler();
+	} catch (error) {
+		const throwableError = toThrowablePopbillError(normalizePopbillError(error, { operation }));
+		safelyDispatchError(context.onError, throwableError);
+		throw throwableError;
+	}
+}
+/**
+* 에러 훅이 예외를 던져도 원래 API 에러를 보존하기 위해 안전하게 호출합니다.
+*/
+function safelyDispatchError(handler, error) {
+	if (!handler) return;
+	try {
+		handler(error);
+	} catch {}
+}
+function toThrowablePopbillError(error) {
+	return Object.assign(new Error(error.message), error);
+}
+//#endregion
+//#region src/services/tax-invoice/mappers/document.ts
+/**
+* modern 세금계산서 문서 입력을 compat 세금계산서 API 모델로 변환합니다.
+*/
+function mapTaxInvoiceDocument(taxInvoiceDocumentInput) {
+	return removeUndefinedProperties$1({
+		writeSpecification: taxInvoiceDocumentInput.writeSpecificationEnabled,
+		writeDate: taxInvoiceDocumentInput.writtenDate,
+		chargeDirection: taxInvoiceDocumentInput.chargeDirection,
+		issueType: taxInvoiceDocumentInput.issueType,
+		purposeType: taxInvoiceDocumentInput.purposeType,
+		issueTiming: taxInvoiceDocumentInput.issueTimingCode,
+		taxType: taxInvoiceDocumentInput.taxType,
+		...mapSupplierFields(taxInvoiceDocumentInput.supplier),
+		...mapBuyerFields(taxInvoiceDocumentInput.buyer),
+		...mapTrusteeFields(taxInvoiceDocumentInput.trustee),
+		taxTotal: taxInvoiceDocumentInput.paymentSummary?.totalTaxAmount,
+		supplyCostTotal: taxInvoiceDocumentInput.paymentSummary?.totalSupplyCostAmount,
+		totalAmount: taxInvoiceDocumentInput.paymentSummary?.totalAmount,
+		cash: taxInvoiceDocumentInput.paymentSummary?.cashAmount,
+		chkBill: taxInvoiceDocumentInput.paymentSummary?.checkAmount,
+		note: taxInvoiceDocumentInput.paymentSummary?.promissoryNoteAmount,
+		credit: taxInvoiceDocumentInput.paymentSummary?.creditAmount,
+		modifyCode: taxInvoiceDocumentInput.modification?.modificationReasonCode,
+		orgNTSConfirmNum: taxInvoiceDocumentInput.modification?.originalNationalTaxServiceConfirmationNumber,
+		serialNum: taxInvoiceDocumentInput.taxInvoiceSerialNumber,
+		remark1: taxInvoiceDocumentInput.remarkOne,
+		remark2: taxInvoiceDocumentInput.remarkTwo,
+		remark3: taxInvoiceDocumentInput.remarkThree,
+		kwon: taxInvoiceDocumentInput.bookVolumeNumber,
+		ho: taxInvoiceDocumentInput.bookIssueNumber,
+		businessLicenseYN: taxInvoiceDocumentInput.includeBusinessLicenseImage,
+		bankBookYN: taxInvoiceDocumentInput.includeBankBookImage,
+		detailList: taxInvoiceDocumentInput.lineItems?.map(mapLineItem),
+		addContactList: taxInvoiceDocumentInput.additionalContacts?.map(mapAdditionalContact)
+	});
+}
+/**
+* modern 세금계산서 문서 입력 목록을 compat 세금계산서 API 모델 목록으로 변환합니다.
+*/
+function mapTaxInvoiceDocuments(taxInvoiceDocumentInputs) {
+	return taxInvoiceDocumentInputs.map(mapTaxInvoiceDocument);
+}
+/**
+* 공급자 입력을 raw 공급자 필드로 변환합니다.
+*/
+function mapSupplierFields(supplierInput) {
+	if (!supplierInput) return {};
+	return removeUndefinedProperties$1({
+		invoicerCorpNum: supplierInput.businessNumber,
+		invoicerMgtKey: supplierInput.managementKey,
+		invoicerTaxRegID: supplierInput.taxRegistrationIdentifier,
+		invoicerCorpName: supplierInput.companyName,
+		invoicerCEOName: supplierInput.chiefExecutiveOfficerName,
+		invoicerAddr: supplierInput.address,
+		invoicerBizClass: supplierInput.businessClass,
+		invoicerBizType: supplierInput.businessType,
+		invoicerContactName: supplierInput.contactName,
+		invoicerTEL: supplierInput.telephoneNumber,
+		invoicerHP: supplierInput.mobilePhoneNumber,
+		invoicerEmail: supplierInput.emailAddress,
+		invoicerSMSSendYN: supplierInput.sendTextMessage,
+		invoicerPrintYN: supplierInput.printEnabled,
+		invoicerRDN: supplierInput.residentRegistrationNumber,
+		invoicerOLN: supplierInput.foreignerRegistrationNumber,
+		invoicerTaxNum: supplierInput.branchBusinessNumber,
+		invoicerPSerialNum: supplierInput.branchSerialNumber,
+		invoicerCorpCls: supplierInput.corporationClassification,
+		invoicerDeptName: supplierInput.departmentName
+	});
+}
+/**
+* 공급받는자 입력을 raw 공급받는자 필드로 변환합니다.
+*/
+function mapBuyerFields(buyerInput) {
+	if (!buyerInput) return {};
+	return removeUndefinedProperties$1({
+		invoiceeType: buyerInput.recipientType,
+		invoiceeCorpNum: buyerInput.businessNumber,
+		invoiceeMgtKey: buyerInput.managementKey,
+		invoiceeTaxRegID: buyerInput.taxRegistrationIdentifier,
+		invoiceeCorpName: buyerInput.companyName,
+		invoiceeCEOName: buyerInput.chiefExecutiveOfficerName,
+		invoiceeAddr: buyerInput.address,
+		invoiceeBizClass: buyerInput.businessClass,
+		invoiceeBizType: buyerInput.businessType,
+		invoiceeContactName1: buyerInput.contactName,
+		invoiceeTEL1: buyerInput.telephoneNumber,
+		invoiceeHP1: buyerInput.mobilePhoneNumber,
+		invoiceeEmail1: buyerInput.emailAddress,
+		invoiceeContactName2: buyerInput.secondaryContactName,
+		invoiceeTEL2: buyerInput.secondaryTelephoneNumber,
+		invoiceeHP2: buyerInput.secondaryMobilePhoneNumber,
+		invoiceeEmail2: buyerInput.secondaryEmailAddress,
+		invoiceeSMSSendYN: buyerInput.sendTextMessage,
+		invoiceePrintYN: buyerInput.printEnabled,
+		invoiceeRDN: buyerInput.residentRegistrationNumber,
+		invoiceeOLN: buyerInput.foreignerRegistrationNumber,
+		invoiceeTaxNum: buyerInput.branchBusinessNumber,
+		invoiceePSerialNum: buyerInput.branchSerialNumber,
+		invoiceeCorpCls: buyerInput.corporationClassification,
+		invoiceeDeptName1: buyerInput.primaryDepartmentName ?? buyerInput.departmentName,
+		invoiceeDeptName2: buyerInput.secondaryDepartmentName,
+		closeDownState: buyerInput.businessStatus,
+		closeDownStateDate: buyerInput.businessStatusDate
+	});
+}
+/**
+* 수탁자 입력을 raw 수탁자 필드로 변환합니다.
+*/
+function mapTrusteeFields(trusteeInput) {
+	if (!trusteeInput) return {};
+	return removeUndefinedProperties$1({
+		trusteeCorpNum: trusteeInput.businessNumber,
+		trusteeMgtKey: trusteeInput.managementKey,
+		trusteeTaxRegID: trusteeInput.taxRegistrationIdentifier,
+		trusteeCorpName: trusteeInput.companyName,
+		trusteeCEOName: trusteeInput.chiefExecutiveOfficerName,
+		trusteeAddr: trusteeInput.address,
+		trusteeBizClass: trusteeInput.businessClass,
+		trusteeBizType: trusteeInput.businessType,
+		trusteeContactName: trusteeInput.contactName,
+		trusteeTEL: trusteeInput.telephoneNumber,
+		trusteeHP: trusteeInput.mobilePhoneNumber,
+		trusteeEmail: trusteeInput.emailAddress,
+		trusteeSMSSendYN: trusteeInput.sendTextMessage,
+		trusteePrintYN: trusteeInput.printEnabled,
+		trusteeRDN: trusteeInput.residentRegistrationNumber,
+		trusteeOLN: trusteeInput.foreignerRegistrationNumber,
+		trusteeTaxNum: trusteeInput.branchBusinessNumber,
+		trusteePSerialNum: trusteeInput.branchSerialNumber,
+		trusteeCorpCls: trusteeInput.corporationClassification,
+		trusteeDeptName: trusteeInput.departmentName
+	});
+}
+/**
+* 상세 품목 입력을 raw 상세 품목 모델로 변환합니다.
+*/
+function mapLineItem(lineItemInput) {
+	return {
+		serialNum: lineItemInput.lineNumber,
+		purchaseDT: lineItemInput.transactionDate,
+		itemName: lineItemInput.itemName,
+		spec: lineItemInput.specification,
+		qty: lineItemInput.quantity,
+		unitCost: lineItemInput.unitCostAmount,
+		supplyCost: lineItemInput.supplyCostAmount,
+		tax: lineItemInput.taxAmount,
+		remark: lineItemInput.remark
+	};
+}
+/**
+* 추가 담당자 입력을 raw 추가 담당자 모델로 변환합니다.
+*/
+function mapAdditionalContact(additionalContactInput) {
+	return {
+		serialNum: additionalContactInput.sequenceNumber,
+		contactName: additionalContactInput.contactName,
+		email: additionalContactInput.emailAddress
+	};
+}
+/**
+* 객체에서 `undefined` 값만 제거하여 API 요청 본문을 정리합니다.
+*/
+function removeUndefinedProperties$1(sourceObject) {
+	const definedEntries = Object.entries(sourceObject).filter(([, value]) => value !== void 0);
+	return Object.fromEntries(definedEntries);
+}
+//#endregion
+//#region src/services/tax-invoice/mappers/invoice-info.ts
+/**
+* compat `getInfo` 응답을 modern TaxInvoiceInfo로 변환합니다.
+*/
+function mapTaxInvoiceInfo(response) {
+	return {
+		itemKey: response.itemKey,
+		taxType: response.taxType,
+		writtenDate: response.writeDate,
+		registeredAt: response.regDT,
+		issueType: response.issueType,
+		totalSupplyCost: response.supplyCostTotal,
+		totalTax: response.taxTotal,
+		purposeType: response.purposeType,
+		issuedAt: response.issueDT,
+		isLateIssued: toBoolean(response.lateIssueYN),
+		isOpen: toBoolean(response.openYN),
+		openedAt: response.openDT,
+		stateMemo: response.stateMemo,
+		stateCode: toRequiredStateCode(response.stateCode),
+		stateChangedAt: response.stateDT,
+		nationalTaxServiceConfirmationNumber: response.ntsconfirmNum,
+		nationalTaxServiceResult: response.ntsresult,
+		nationalTaxServiceSentAt: response.ntssendDT,
+		nationalTaxServiceResultReceivedAt: response.ntsresultDT,
+		nationalTaxServiceSendErrorCode: response.ntssendErrCode,
+		modificationCode: response.modifyCode,
+		isApiLinkedDocument: toBoolean(response.interOPYN),
+		supplierCompanyName: response.invoicerCorpName,
+		supplierBusinessNumber: response.invoicerCorpNum,
+		supplierManagementKey: response.invoicerMgtKey,
+		isSupplierPrinted: toBoolean(response.invoicerPrintYN),
+		buyerCompanyName: response.invoiceeCorpName,
+		buyerBusinessNumber: response.invoiceeCorpNum,
+		buyerManagementKey: response.invoiceeMgtKey,
+		isBuyerPrinted: toBoolean(response.invoiceePrintYN),
+		buyerBusinessStatus: response.closeDownState,
+		buyerBusinessStatusDate: response.closeDownStateDate,
+		trusteeCompanyName: response.trusteeCorpName,
+		trusteeBusinessNumber: response.trusteeCorpNum,
+		trusteeManagementKey: response.trusteeMgtKey,
+		isTrusteePrinted: response.trusteePrintYN === void 0 ? void 0 : toBoolean(response.trusteePrintYN)
+	};
+}
+function toRequiredStateCode(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string") {
+		const normalizedNumber = Number(value);
+		if (Number.isFinite(normalizedNumber)) return normalizedNumber;
+	}
+	throw new Error(`유효하지 않은 stateCode 응답값입니다. (${String(value)})`);
+}
+//#endregion
+//#region src/services/tax-invoice/types/document.ts
+/**
+* 세금계산서 과금 방향 값입니다.
+*/
+const TaxInvoiceChargeDirectionValues = {
+	/**
+	* 값: `정과금`, 의미: 공급자에게 과금되는 일반 방향
+	*/
+	NormalCharge: "정과금",
+	/**
+	* 값: `역과금`, 의미: 공급받는자에게 과금되는 역방향
+	*/
+	ReverseCharge: "역과금"
+};
+/**
+* 세금계산서 발행 형태 값입니다.
+*/
+const TaxInvoiceIssueTypes = {
+	/**
+	* 값: `정발행`, 의미: 공급자 중심의 일반 발행
+	*/
+	Normal: "정발행",
+	/**
+	* 값: `역발행`, 의미: 공급받는자 요청 기반 발행
+	*/
+	Reverse: "역발행",
+	/**
+	* 값: `위수탁`, 의미: 수탁자 대행 발행
+	*/
+	Trustee: "위수탁"
+};
+/**
+* 세금계산서 영수/청구 값입니다.
+*/
+const TaxInvoicePurposeTypes = {
+	/**
+	* 값: `영수`, 의미: 영수 목적
+	*/
+	Receipt: "영수",
+	/**
+	* 값: `청구`, 의미: 청구 목적
+	*/
+	Claim: "청구",
+	/**
+	* 값: `없음`, 의미: 목적 구분 없음
+	*/
+	None: "없음"
+};
+/**
+* 세금계산서 과세 유형 값입니다.
+*/
+const TaxInvoiceTaxationTypes = {
+	/**
+	* 값: `과세`, 의미: 일반 과세
+	*/
+	Taxable: "과세",
+	/**
+	* 값: `영세`, 의미: 영세율
+	*/
+	ZeroRated: "영세",
+	/**
+	* 값: `면세`, 의미: 면세
+	*/
+	Exempt: "면세"
+};
+/**
+* 공급받는자 구분 값입니다.
+*/
+const TaxInvoiceRecipientTypes = {
+	/**
+	* 값: `사업자`, 의미: 사업자 번호 기반
+	*/
+	Business: "사업자",
+	/**
+	* 값: `개인`, 의미: 주민등록번호 기반
+	*/
+	Individual: "개인",
+	/**
+	* 값: `외국인`, 의미: 외국인 식별번호 기반
+	*/
+	Foreigner: "외국인"
+};
+/**
+* 공급받는자 휴폐업 상태 값입니다.
+*/
+const TaxInvoiceBusinessStatusValues = {
+	/**
+	* 값: `null`, 의미: 미확인
+	*/
+	NotChecked: null,
+	/**
+	* 값: `0`, 의미: 미등록
+	*/
+	NotRegistered: 0,
+	/**
+	* 값: `1`, 의미: 사업중
+	*/
+	Operating: 1,
+	/**
+	* 값: `2`, 의미: 폐업
+	*/
+	Closed: 2,
+	/**
+	* 값: `3`, 의미: 휴업
+	*/
+	Suspended: 3,
+	/**
+	* 값: `4`, 의미: 확인실패
+	*/
+	CheckFailed: 4
+};
+/**
+* 수정세금계산서 사유코드 값입니다.
+*/
+const TaxInvoiceModificationReasonCodes = {
+	/**
+	* 값: `1`, 의미: 기재사항 착오 정정
+	*/
+	CorrectingEntryErrors: 1,
+	/**
+	* 값: `2`, 의미: 공급가액 변동
+	*/
+	SupplyAmountAdjustment: 2,
+	/**
+	* 값: `3`, 의미: 환입
+	*/
+	Return: 3,
+	/**
+	* 값: `4`, 의미: 계약의 해제
+	*/
+	ContractCancellation: 4,
+	/**
+	* 값: `5`, 의미: 내국신용장 사후 개설
+	*/
+	PostIssuedDomesticLetterOfCredit: 5,
+	/**
+	* 값: `6`, 의미: 착오에 의한 이중 발급
+	*/
+	DuplicateIssuanceByMistake: 6
+};
+//#endregion
+//#region src/services/tax-invoice/types/response.ts
+/**
+* 초대량 처리 상태 값입니다.
+*/
+const TaxInvoiceBulkIssueSubmissionTransactionStates = {
+	/**
+	* 값: `0`, 의미: 미처리 상태
+	*/
+	NotProcessed: 0,
+	/**
+	* 값: `1`, 의미: 처리중 상태
+	*/
+	Processing: 1,
+	/**
+	* 값: `2`, 의미: 완료 상태
+	*/
+	Completed: 2
+};
+//#endregion
+//#region src/services/tax-invoice/types/index.ts
+/**
+* 세금계산서 문서번호 유형 상수입니다.
+*/
+const TaxInvoiceDocumentKeyTypes = {
+	/**
+	* 코드: `SELL`, 설명: 매출 문서번호 유형
+	*/
+	Sales: "SELL",
+	/**
+	* 코드: `BUY`, 설명: 매입 문서번호 유형
+	*/
+	Purchase: "BUY",
+	/**
+	* 코드: `TRUSTEE`, 설명: 위수탁 문서번호 유형
+	*/
+	Trustee: "TRUSTEE"
+};
+/**
+* 세금계산서 문서함 범위 상수입니다.
+*/
+const TaxInvoiceBoxScopes = {
+	/**
+	* 코드: `TBOX`, 설명: 임시 문서함
+	*/
+	TemporaryDocumentBox: "TBOX",
+	/**
+	* 코드: `SWBOX`, 설명: 매출 발행 대기함
+	*/
+	SalesIssueWaitingBox: "SWBOX",
+	/**
+	* 코드: `SBOX`, 설명: 매출 문서함
+	*/
+	SalesDocumentBox: "SBOX",
+	/**
+	* 코드: `PWBOX`, 설명: 매입 발행 대기함
+	*/
+	PurchaseIssueWaitingBox: "PWBOX",
+	/**
+	* 코드: `PBOX`, 설명: 매입 문서함
+	*/
+	PurchaseDocumentBox: "PBOX",
+	/**
+	* 코드: `WRITE`, 설명: 정발행 작성
+	*/
+	WriteInvoice: "WRITE"
+};
+/**
+* 검색일자 유형 상수입니다.
+*/
+const TaxInvoiceDateType = {
+	/**
+	* 코드: `R`, 설명: 등록일자
+	*/
+	Registered: "R",
+	/**
+	* 코드: `W`, 설명: 작성일자
+	*/
+	Written: "W",
+	/**
+	* 코드: `I`, 설명: 발행일자
+	*/
+	Issued: "I"
+};
+/**
+* 검색 정렬 방향 상수입니다.
+*/
+const TaxInvoiceSortOrder = {
+	/**
+	* 코드: `D`, 설명: 내림차순
+	*/
+	Descending: "D",
+	/**
+	* 코드: `A`, 설명: 오름차순
+	*/
+	Ascending: "A"
+};
+/**
+* 검색 문서유형 코드 상수입니다.
+*/
+const TaxInvoiceSearchInvoiceTypeCodes = {
+	/**
+	* 코드: `N`, 설명: 세금계산서
+	*/
+	Normal: "N",
+	/**
+	* 코드: `M`, 설명: 수정세금계산서
+	*/
+	Modified: "M"
+};
+/**
+* 검색 과세형태 코드 상수입니다.
+*/
+const TaxInvoiceSearchTaxationTypeCodes = {
+	/**
+	* 코드: `T`, 설명: 과세
+	*/
+	Taxable: "T",
+	/**
+	* 코드: `N`, 설명: 면세
+	*/
+	Exempt: "N",
+	/**
+	* 코드: `Z`, 설명: 영세
+	*/
+	ZeroRated: "Z"
+};
+/**
+* 검색 발행형태 코드 상수입니다.
+*/
+const TaxInvoiceSearchIssueTypeCodes = {
+	/**
+	* 코드: `N`, 설명: 정발행
+	*/
+	Normal: "N",
+	/**
+	* 코드: `R`, 설명: 역발행
+	*/
+	Reverse: "R",
+	/**
+	* 코드: `T`, 설명: 위수탁
+	*/
+	Trustee: "T"
+};
+/**
+* 검색 종사업장번호 주체 코드 상수입니다.
+*/
+const TaxInvoiceSearchTaxRegistrationIdentifierTypes = {
+	/**
+	* 코드: `S`, 설명: 공급자
+	*/
+	Supplier: "S",
+	/**
+	* 코드: `B`, 설명: 공급받는자
+	*/
+	Buyer: "B",
+	/**
+	* 코드: `T`, 설명: 수탁자
+	*/
+	Trustee: "T"
+};
+/**
+* 검색 종사업장번호 유무 코드 상수입니다.
+*/
+const TaxInvoiceSearchTaxRegistrationIdentifierAvailabilities = {
+	/**
+	* 코드: `0`, 설명: 종사업장번호 없음
+	*/
+	No: "0",
+	/**
+	* 코드: `1`, 설명: 종사업장번호 있음
+	*/
+	Yes: "1"
+};
+/**
+* 검색 작성유형 코드 상수입니다.
+*/
+const TaxInvoiceSearchInteroperabilityTypes = {
+	/**
+	* 코드: `0`, 설명: 팝빌 웹 작성
+	*/
+	PopbillWeb: "0",
+	/**
+	* 코드: `1`, 설명: API 작성
+	*/
+	Api: "1"
+};
+/**
+* 검색 등록유형 코드 상수입니다.
+*/
+const TaxInvoiceSearchRegistrationTypeCodes = {
+	/**
+	* 코드: `P`, 설명: 팝빌 등록(발행)
+	*/
+	Popbill: "P",
+	/**
+	* 코드: `H`, 설명: 홈택스/ASP 등록(발행)
+	*/
+	HomeTax: "H"
+};
+/**
+* 검색 조건의 휴폐업 상태 상수입니다.
+*/
+const TaxInvoiceCloseDownStateCodes = {
+	/**
+	* 코드: `N`, 설명: 미확인
+	*/
+	NotChecked: "N",
+	/**
+	* 코드: `0`, 설명: 미등록
+	*/
+	NotRegistered: "0",
+	/**
+	* 코드: `1`, 설명: 사업중
+	*/
+	Operating: "1",
+	/**
+	* 코드: `2`, 설명: 폐업
+	*/
+	Closed: "2",
+	/**
+	* 코드: `3`, 설명: 휴업
+	*/
+	Suspended: "3",
+	/**
+	* 코드: `4`, 설명: 확인실패
+	*/
+	CheckFailed: "4"
+};
+/**
+* 전자명세서 문서유형 코드 상수입니다.
+*/
+const TaxInvoiceStatementItemCodes = {
+	/**
+	* 코드: `121`, 설명: 거래명세서
+	*/
+	TradeStatement: 121,
+	/**
+	* 코드: `122`, 설명: 청구서
+	*/
+	Invoice: 122,
+	/**
+	* 코드: `123`, 설명: 견적서
+	*/
+	Estimate: 123,
+	/**
+	* 코드: `124`, 설명: 발주서
+	*/
+	PurchaseOrder: 124,
+	/**
+	* 코드: `125`, 설명: 입금표
+	*/
+	Deposit: 125,
+	/**
+	* 코드: `126`, 설명: 영수증
+	*/
+	Receipt: 126
+};
+/**
+* 메일 전송 유형 코드 상수입니다.
+*/
+const TaxInvoiceEmailTypes = {
+	/**
+	* 코드: `ETC_CERT_EXPIRATION`, 설명: 인증서 만료 안내
+	*/
+	EtcCertExpiration: "ETC_CERT_EXPIRATION",
+	/**
+	* 코드: `TAX_CANCEL_ISSUE`, 설명: 발행취소
+	*/
+	TaxCancelIssue: "TAX_CANCEL_ISSUE",
+	/**
+	* 코드: `TAX_CANCEL_REQUEST`, 설명: 역발행 요청 취소
+	*/
+	TaxCancelRequest: "TAX_CANCEL_REQUEST",
+	/**
+	* 코드: `TAX_CHECK`, 설명: 수신확인
+	*/
+	TaxCheck: "TAX_CHECK",
+	/**
+	* 코드: `TAX_CLOSEDOWN`, 설명: 휴폐업 알림
+	*/
+	TaxClosedown: "TAX_CLOSEDOWN",
+	/**
+	* 코드: `TAX_ISSUE`, 설명: 발행완료(수신자)
+	*/
+	TaxIssue: "TAX_ISSUE",
+	/**
+	* 코드: `TAX_ISSUE_INVOICER`, 설명: 발행완료(공급자)
+	*/
+	TaxIssueInvoicer: "TAX_ISSUE_INVOICER",
+	/**
+	* 코드: `TAX_NTSFAIL_INVOICER`, 설명: 국세청 전송실패(공급자)
+	*/
+	TaxNtsFailInvoicer: "TAX_NTSFAIL_INVOICER",
+	/**
+	* 코드: `TAX_REFUSE`, 설명: 역발행 거부
+	*/
+	TaxRefuse: "TAX_REFUSE",
+	/**
+	* 코드: `TAX_REQUEST`, 설명: 역발행 요청
+	*/
+	TaxRequest: "TAX_REQUEST",
+	/**
+	* 코드: `TAX_REVERSE_ISSUE`, 설명: 역발행 완료
+	*/
+	TaxReverseIssue: "TAX_REVERSE_ISSUE",
+	/**
+	* 코드: `TAX_TRUST_CANCEL_ISSUE`, 설명: 위수탁 발행취소
+	*/
+	TaxTrustCancelIssue: "TAX_TRUST_CANCEL_ISSUE",
+	/**
+	* 코드: `TAX_TRUST_CANCEL_ISSUE_INVOICER`, 설명: 위수탁 발행취소(공급자)
+	*/
+	TaxTrustCancelIssueInvoicer: "TAX_TRUST_CANCEL_ISSUE_INVOICER",
+	/**
+	* 코드: `TAX_TRUST_ISSUE`, 설명: 위수탁 발행완료
+	*/
+	TaxTrustIssue: "TAX_TRUST_ISSUE",
+	/**
+	* 코드: `TAX_TRUST_ISSUE_INVOICER`, 설명: 위수탁 발행완료(공급자)
+	*/
+	TaxTrustIssueInvoicer: "TAX_TRUST_ISSUE_INVOICER",
+	/**
+	* 코드: `TAX_TRUST_ISSUE_TRUSTEE`, 설명: 위수탁 발행완료(수탁자)
+	*/
+	TaxTrustIssueTrustee: "TAX_TRUST_ISSUE_TRUSTEE",
+	/**
+	* 코드: `TAX_ACCEPT`, 설명: 역발행 승인(legacy)
+	*/
+	TaxAccept: "TAX_ACCEPT",
+	/**
+	* 코드: `TAX_DENY`, 설명: 역발행 거부(legacy)
+	*/
+	TaxDeny: "TAX_DENY",
+	/**
+	* 코드: `TAX_CANCEL_SEND`, 설명: 발행안함 취소(legacy)
+	*/
+	TaxCancelSend: "TAX_CANCEL_SEND"
+};
+/**
+* 수정세금계산서 사유코드입니다.
+*/
+const TaxInvoiceModificationCodes = TaxInvoiceModificationReasonCodes;
+//#endregion
+//#region src/services/tax-invoice/mappers/response.ts
+/**
+* 공통 API 처리결과를 도메인 처리결과로 변환합니다.
+*/
+function mapTaxInvoiceOperationResult(taxInvoiceApiResponse) {
+	return {
+		resultCode: toRequiredNumber(taxInvoiceApiResponse.code, "code"),
+		resultMessage: taxInvoiceApiResponse.message
+	};
+}
+/**
+* 발행 결과를 도메인 발행 결과로 변환합니다.
+*/
+function mapTaxInvoiceIssueResult(taxInvoiceApiResponse) {
+	return removeUndefinedProperties({
+		...mapTaxInvoiceOperationResult(taxInvoiceApiResponse),
+		nationalTaxServiceConfirmationNumber: taxInvoiceApiResponse.ntsConfirmNum,
+		issuedAt: taxInvoiceApiResponse.issueDT
+	});
+}
+/**
+* 초대량 접수 결과를 도메인 결과로 변환합니다.
+*/
+function mapTaxInvoiceBulkSubmitResult(taxInvoiceApiResponse) {
+	return removeUndefinedProperties({
+		...mapTaxInvoiceOperationResult(taxInvoiceApiResponse),
+		receiptIdentifier: taxInvoiceApiResponse.receiptID
+	});
+}
+/**
+* 초대량 접수결과 조회 응답을 도메인 결과로 변환합니다.
+*/
+function mapTaxInvoiceBulkIssueSubmissionResult(taxInvoiceApiResponse) {
+	return removeUndefinedProperties({
+		...mapTaxInvoiceOperationResult(taxInvoiceApiResponse),
+		receiptIdentifier: taxInvoiceApiResponse.receiptID,
+		submissionIdentifier: taxInvoiceApiResponse.submitID,
+		submittedDocumentCount: toOptionalNumber(taxInvoiceApiResponse.submitCount),
+		succeededDocumentCount: toOptionalNumber(taxInvoiceApiResponse.successCount),
+		failedDocumentCount: toOptionalNumber(taxInvoiceApiResponse.failCount),
+		transactionState: toOptionalNumber(taxInvoiceApiResponse.txState),
+		transactionStartedAt: taxInvoiceApiResponse.txStartDT,
+		transactionCompletedAt: taxInvoiceApiResponse.txEndDT,
+		transactionResultCode: toOptionalNumber(taxInvoiceApiResponse.txResultCode),
+		issueResults: taxInvoiceApiResponse.issueResult?.map(mapTaxInvoiceBulkIssueSubmissionResultItem)
+	});
+}
+/**
+* 다건 문서 요약 응답을 도메인 목록으로 변환합니다.
+*/
+function mapTaxInvoiceInfos(taxInvoiceApiResponse) {
+	return taxInvoiceApiResponse.map(mapTaxInvoiceInfo);
+}
+/**
+* 문서 상세 응답을 도메인 문서 상세로 변환합니다.
+*/
+function mapTaxInvoiceDocumentOutput(taxInvoiceApiResponse) {
+	return removeUndefinedProperties({
+		writeSpecificationEnabled: taxInvoiceApiResponse.writeSpecification,
+		writtenDate: taxInvoiceApiResponse.writeDate,
+		chargeDirection: toTaxInvoiceChargeDirection(taxInvoiceApiResponse.chargeDirection),
+		issueType: taxInvoiceApiResponse.issueType,
+		purposeType: taxInvoiceApiResponse.purposeType,
+		issueTimingCode: taxInvoiceApiResponse.issueTiming,
+		taxType: taxInvoiceApiResponse.taxType,
+		supplier: mapSupplierOutput(taxInvoiceApiResponse),
+		buyer: mapBuyerOutput(taxInvoiceApiResponse),
+		trustee: mapTrusteeOutput(taxInvoiceApiResponse),
+		paymentSummary: removeUndefinedProperties({
+			totalTaxAmount: taxInvoiceApiResponse.taxTotal,
+			totalSupplyCostAmount: taxInvoiceApiResponse.supplyCostTotal,
+			totalAmount: taxInvoiceApiResponse.totalAmount,
+			cashAmount: taxInvoiceApiResponse.cash,
+			checkAmount: taxInvoiceApiResponse.chkBill,
+			promissoryNoteAmount: taxInvoiceApiResponse.note,
+			creditAmount: taxInvoiceApiResponse.credit
+		}),
+		modification: removeUndefinedProperties({
+			modificationReasonCode: taxInvoiceApiResponse.modifyCode,
+			originalNationalTaxServiceConfirmationNumber: taxInvoiceApiResponse.orgNTSConfirmNum
+		}),
+		taxInvoiceSerialNumber: taxInvoiceApiResponse.serialNum,
+		remarkOne: taxInvoiceApiResponse.remark1,
+		remarkTwo: taxInvoiceApiResponse.remark2,
+		remarkThree: taxInvoiceApiResponse.remark3,
+		bookVolumeNumber: taxInvoiceApiResponse.kwon,
+		bookIssueNumber: taxInvoiceApiResponse.ho,
+		includeBusinessLicenseImage: toOptionalBoolean(taxInvoiceApiResponse.businessLicenseYN),
+		includeBankBookImage: toOptionalBoolean(taxInvoiceApiResponse.bankBookYN),
+		lineItems: taxInvoiceApiResponse.detailList?.map((lineItem) => removeUndefinedProperties({
+			lineNumber: lineItem.serialNum,
+			transactionDate: lineItem.purchaseDT,
+			itemName: lineItem.itemName,
+			specification: lineItem.spec,
+			quantity: lineItem.qty,
+			unitCostAmount: lineItem.unitCost,
+			supplyCostAmount: lineItem.supplyCost,
+			taxAmount: lineItem.tax,
+			remark: lineItem.remark
+		})),
+		additionalContacts: taxInvoiceApiResponse.addContactList?.map((additionalContact) => removeUndefinedProperties({
+			sequenceNumber: additionalContact.serialNum,
+			contactName: additionalContact.contactName,
+			emailAddress: additionalContact.email
+		})),
+		issuedAt: taxInvoiceApiResponse.issueDT,
+		stateCode: toOptionalNumber(taxInvoiceApiResponse.stateCode),
+		stateChangedAt: taxInvoiceApiResponse.stateDT,
+		isLateIssued: toOptionalBoolean(taxInvoiceApiResponse.lateIssueYN),
+		isOpen: toOptionalBoolean(taxInvoiceApiResponse.openYN),
+		openedAt: taxInvoiceApiResponse.openDT,
+		nationalTaxServiceConfirmationNumber: taxInvoiceApiResponse.ntsconfirmNum,
+		nationalTaxServiceResultCode: taxInvoiceApiResponse.ntsresult,
+		nationalTaxServiceSentAt: taxInvoiceApiResponse.ntssendDT,
+		nationalTaxServiceResultReceivedAt: taxInvoiceApiResponse.ntsresultDT,
+		nationalTaxServiceSendErrorCode: taxInvoiceApiResponse.ntssendErrCode,
+		isApiLinkedDocument: toOptionalBoolean(taxInvoiceApiResponse.interOPYN)
+	});
+}
+/**
+* 문서번호 사용 여부 응답을 도메인 결과로 변환합니다.
+*/
+function mapTaxInvoiceInvoiceManagementKeyUsage(taxInvoiceApiResponse) {
+	if (typeof taxInvoiceApiResponse === "boolean") return { isInUse: taxInvoiceApiResponse };
+	return removeUndefinedProperties({
+		isInUse: typeof taxInvoiceApiResponse.itemKey === "string" && taxInvoiceApiResponse.itemKey.length > 0,
+		itemKey: taxInvoiceApiResponse.itemKey
+	});
+}
+/**
+* XML 조회 응답을 도메인 결과로 변환합니다.
+*/
+function mapTaxInvoiceXmlResult(taxInvoiceApiResponse) {
+	return removeUndefinedProperties({
+		operationResult: taxInvoiceApiResponse.code === void 0 || taxInvoiceApiResponse.message === void 0 ? void 0 : mapTaxInvoiceOperationResult({
+			code: taxInvoiceApiResponse.code,
+			message: taxInvoiceApiResponse.message
+		}),
+		itemKey: taxInvoiceApiResponse.itemKey,
+		invoiceManagementKey: taxInvoiceApiResponse.mgtKey,
+		xmlContent: taxInvoiceApiResponse.retObject
+	});
+}
+/**
+* 검색 응답을 도메인 검색 결과로 변환합니다.
+*/
+function mapTaxInvoiceSearchResult(taxInvoiceApiResponse) {
+	return removeUndefinedProperties({
+		operationResult: mapTaxInvoiceOperationResult(taxInvoiceApiResponse),
+		totalCount: toOptionalNumber(taxInvoiceApiResponse.total),
+		pageSize: toOptionalNumber(taxInvoiceApiResponse.perPage),
+		pageNumber: toOptionalNumber(taxInvoiceApiResponse.pageNum),
+		pageCount: toOptionalNumber(taxInvoiceApiResponse.pageCount),
+		invoiceSummaries: (taxInvoiceApiResponse.list ?? []).map(mapTaxInvoiceInfo)
+	});
+}
+/**
+* 문서 로그 응답을 도메인 로그 목록으로 변환합니다.
+*/
+function mapTaxInvoiceLogs(taxInvoiceApiResponse) {
+	return taxInvoiceApiResponse.map((logEntry) => removeUndefinedProperties({
+		documentLogTypeCode: toOptionalNumber(logEntry.docLogType),
+		logMessage: logEntry.log,
+		processTypeCode: logEntry.procType,
+		processCompanyName: logEntry.procCorpName,
+		processContactName: logEntry.procContactName,
+		processDescription: logEntry.procMemo,
+		registeredAt: logEntry.regDT,
+		ipAddress: logEntry.ip
+	}));
+}
+/**
+* URL 문자열을 URL 응답으로 래핑합니다.
+*/
+function mapTaxInvoiceAccessUrlFromString(accessUrl) {
+	return { accessUrl };
+}
+/**
+* URL 객체를 URL 응답으로 변환합니다.
+*/
+function mapTaxInvoiceAccessUrl(taxInvoiceApiResponse) {
+	return { accessUrl: taxInvoiceApiResponse.url };
+}
+/**
+* 첨부파일 목록 응답을 도메인 목록으로 변환합니다.
+*/
+function mapTaxInvoiceAttachedFiles(taxInvoiceApiResponse) {
+	return taxInvoiceApiResponse.map((attachedFile) => removeUndefinedProperties({
+		sequenceNumber: attachedFile.serialNum,
+		fileIdentifier: attachedFile.attachedFile,
+		displayName: attachedFile.displayName,
+		registeredAt: attachedFile.regDT
+	}));
+}
+/**
+* 이메일 전송설정 응답을 도메인 목록으로 변환합니다.
+*/
+function mapTaxInvoiceEmailSendSettings(taxInvoiceApiResponse) {
+	return taxInvoiceApiResponse.map((emailSendSetting) => removeUndefinedProperties({
+		emailTypeCode: emailSendSetting.emailType,
+		sendEnabled: toOptionalBoolean(emailSendSetting.sendYN)
+	}));
+}
+/**
+* 국세청 전송설정 응답을 도메인 설정으로 변환합니다.
+*/
+function mapTaxInvoiceSendToNationalTaxServiceSetting(taxInvoiceApiResponse) {
+	return { sendToNationalTaxServiceEnabled: toBoolean(taxInvoiceApiResponse.sendToNTS) };
+}
+/**
+* 인증서 만료일 문자열을 도메인 결과로 래핑합니다.
+*/
+function mapTaxInvoiceTaxCertificateExpiration(expirationDateTime) {
+	return { expirationDateTime };
+}
+/**
+* 인증서 정보 응답을 도메인 정보로 변환합니다.
+*/
+function mapTaxInvoiceTaxCertificateInfo(taxInvoiceApiResponse) {
+	return removeUndefinedProperties({
+		registeredAt: taxInvoiceApiResponse.regDT,
+		expiredAt: taxInvoiceApiResponse.expireDT,
+		issuerDistinguishedName: taxInvoiceApiResponse.issuerDN,
+		subjectDistinguishedName: taxInvoiceApiResponse.subjectDN,
+		issuerName: taxInvoiceApiResponse.issuerName,
+		policyObjectIdentifier: taxInvoiceApiResponse.OID,
+		registeredContactName: taxInvoiceApiResponse.regContactName,
+		registeredContactIdentifier: taxInvoiceApiResponse.regContactID
+	});
+}
+/**
+* 초대량 개별 처리 결과를 도메인 항목으로 변환합니다.
+*/
+function mapTaxInvoiceBulkIssueSubmissionResultItem(taxInvoiceApiResponse) {
+	return removeUndefinedProperties({
+		invoiceDocumentKeyTypeCode: taxInvoiceApiResponse.keyType,
+		supplierInvoiceManagementKey: taxInvoiceApiResponse.invoicerMgtKey,
+		trusteeInvoiceManagementKey: taxInvoiceApiResponse.trusteeMgtKey,
+		resultCode: toOptionalNumber(taxInvoiceApiResponse.code),
+		resultMessage: taxInvoiceApiResponse.message,
+		nationalTaxServiceConfirmationNumber: taxInvoiceApiResponse.ntsconfirmNum,
+		receivedAt: taxInvoiceApiResponse.receiptDT,
+		issuedAt: taxInvoiceApiResponse.issueDT
+	});
+}
+/**
+* 공급자 응답 필드를 도메인 공급자 정보로 변환합니다.
+*/
+function mapSupplierOutput(taxInvoiceApiResponse) {
+	return compactOptionalObject({
+		businessNumber: taxInvoiceApiResponse.invoicerCorpNum,
+		managementKey: taxInvoiceApiResponse.invoicerMgtKey,
+		taxRegistrationIdentifier: taxInvoiceApiResponse.invoicerTaxRegID,
+		companyName: taxInvoiceApiResponse.invoicerCorpName,
+		chiefExecutiveOfficerName: taxInvoiceApiResponse.invoicerCEOName,
+		address: taxInvoiceApiResponse.invoicerAddr,
+		businessClass: taxInvoiceApiResponse.invoicerBizClass,
+		businessType: taxInvoiceApiResponse.invoicerBizType,
+		contactName: taxInvoiceApiResponse.invoicerContactName,
+		telephoneNumber: taxInvoiceApiResponse.invoicerTEL,
+		mobilePhoneNumber: taxInvoiceApiResponse.invoicerHP,
+		emailAddress: taxInvoiceApiResponse.invoicerEmail,
+		sendTextMessage: toOptionalBoolean(taxInvoiceApiResponse.invoicerSMSSendYN),
+		printEnabled: toOptionalBoolean(taxInvoiceApiResponse.invoicerPrintYN),
+		residentRegistrationNumber: taxInvoiceApiResponse.invoicerRDN,
+		foreignerRegistrationNumber: taxInvoiceApiResponse.invoicerOLN,
+		branchBusinessNumber: taxInvoiceApiResponse.invoicerTaxNum,
+		branchSerialNumber: taxInvoiceApiResponse.invoicerPSerialNum,
+		corporationClassification: taxInvoiceApiResponse.invoicerCorpCls,
+		departmentName: taxInvoiceApiResponse.invoicerDeptName
+	});
+}
+/**
+* 공급받는자 응답 필드를 도메인 공급받는자 정보로 변환합니다.
+*/
+function mapBuyerOutput(taxInvoiceApiResponse) {
+	return compactOptionalObject({
+		recipientType: taxInvoiceApiResponse.invoiceeType,
+		businessNumber: taxInvoiceApiResponse.invoiceeCorpNum,
+		managementKey: taxInvoiceApiResponse.invoiceeMgtKey,
+		taxRegistrationIdentifier: taxInvoiceApiResponse.invoiceeTaxRegID,
+		companyName: taxInvoiceApiResponse.invoiceeCorpName,
+		chiefExecutiveOfficerName: taxInvoiceApiResponse.invoiceeCEOName,
+		address: taxInvoiceApiResponse.invoiceeAddr,
+		businessClass: taxInvoiceApiResponse.invoiceeBizClass,
+		businessType: taxInvoiceApiResponse.invoiceeBizType,
+		contactName: taxInvoiceApiResponse.invoiceeContactName1,
+		telephoneNumber: taxInvoiceApiResponse.invoiceeTEL1,
+		mobilePhoneNumber: taxInvoiceApiResponse.invoiceeHP1,
+		emailAddress: taxInvoiceApiResponse.invoiceeEmail1,
+		secondaryContactName: taxInvoiceApiResponse.invoiceeContactName2,
+		secondaryTelephoneNumber: taxInvoiceApiResponse.invoiceeTEL2,
+		secondaryMobilePhoneNumber: taxInvoiceApiResponse.invoiceeHP2,
+		secondaryEmailAddress: taxInvoiceApiResponse.invoiceeEmail2,
+		sendTextMessage: toOptionalBoolean(taxInvoiceApiResponse.invoiceeSMSSendYN),
+		printEnabled: toOptionalBoolean(taxInvoiceApiResponse.invoiceePrintYN),
+		residentRegistrationNumber: taxInvoiceApiResponse.invoiceeRDN,
+		foreignerRegistrationNumber: taxInvoiceApiResponse.invoiceeOLN,
+		branchBusinessNumber: taxInvoiceApiResponse.invoiceeTaxNum,
+		branchSerialNumber: taxInvoiceApiResponse.invoiceePSerialNum,
+		corporationClassification: taxInvoiceApiResponse.invoiceeCorpCls,
+		departmentName: taxInvoiceApiResponse.invoiceeDeptName1,
+		primaryDepartmentName: taxInvoiceApiResponse.invoiceeDeptName1,
+		secondaryDepartmentName: taxInvoiceApiResponse.invoiceeDeptName2,
+		businessStatus: taxInvoiceApiResponse.closeDownState,
+		businessStatusDate: taxInvoiceApiResponse.closeDownStateDate
+	});
+}
+/**
+* 수탁자 응답 필드를 도메인 수탁자 정보로 변환합니다.
+*/
+function mapTrusteeOutput(taxInvoiceApiResponse) {
+	return compactOptionalObject({
+		businessNumber: taxInvoiceApiResponse.trusteeCorpNum,
+		managementKey: taxInvoiceApiResponse.trusteeMgtKey,
+		taxRegistrationIdentifier: taxInvoiceApiResponse.trusteeTaxRegID,
+		companyName: taxInvoiceApiResponse.trusteeCorpName,
+		chiefExecutiveOfficerName: taxInvoiceApiResponse.trusteeCEOName,
+		address: taxInvoiceApiResponse.trusteeAddr,
+		businessClass: taxInvoiceApiResponse.trusteeBizClass,
+		businessType: taxInvoiceApiResponse.trusteeBizType,
+		contactName: taxInvoiceApiResponse.trusteeContactName,
+		telephoneNumber: taxInvoiceApiResponse.trusteeTEL,
+		mobilePhoneNumber: taxInvoiceApiResponse.trusteeHP,
+		emailAddress: taxInvoiceApiResponse.trusteeEmail,
+		sendTextMessage: toOptionalBoolean(taxInvoiceApiResponse.trusteeSMSSendYN),
+		printEnabled: toOptionalBoolean(taxInvoiceApiResponse.trusteePrintYN),
+		residentRegistrationNumber: taxInvoiceApiResponse.trusteeRDN,
+		foreignerRegistrationNumber: taxInvoiceApiResponse.trusteeOLN,
+		branchBusinessNumber: taxInvoiceApiResponse.trusteeTaxNum,
+		branchSerialNumber: taxInvoiceApiResponse.trusteePSerialNum,
+		corporationClassification: taxInvoiceApiResponse.trusteeCorpCls,
+		departmentName: taxInvoiceApiResponse.trusteeDeptName
+	});
+}
+/**
+* 문자열/숫자 값을 숫자로 안전하게 변환합니다.
+*/
+function toOptionalNumber(value) {
+	if (value === void 0) return;
+	if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
+	const normalizedNumber = Number(value);
+	return Number.isFinite(normalizedNumber) ? normalizedNumber : void 0;
+}
+function toRequiredNumber(value, fieldName) {
+	const normalizedNumber = toOptionalNumber(value);
+	if (normalizedNumber !== void 0) return normalizedNumber;
+	throw new Error(`유효하지 않은 ${fieldName} 응답값입니다. (${String(value)})`);
+}
+/**
+* 불리언 문자열/값을 불리언으로 안전하게 변환합니다.
+*/
+function toOptionalBoolean(value) {
+	if (value === void 0) return;
+	return toBoolean(value);
+}
+/**
+* 과금 방향 문자열을 도메인 과금 방향으로 안전하게 정규화합니다.
+*/
+function toTaxInvoiceChargeDirection(chargeDirection) {
+	if (chargeDirection === TaxInvoiceChargeDirectionValues.NormalCharge) return TaxInvoiceChargeDirectionValues.NormalCharge;
+	if (chargeDirection === TaxInvoiceChargeDirectionValues.ReverseCharge) return TaxInvoiceChargeDirectionValues.ReverseCharge;
+}
+/**
+* 모든 필드가 비어있으면 `undefined`를 반환하고, 아니면 정리된 객체를 반환합니다.
+*/
+function compactOptionalObject(sourceObject) {
+	const normalizedObject = removeUndefinedProperties(sourceObject);
+	return Object.keys(normalizedObject).length === 0 ? void 0 : normalizedObject;
+}
+/**
+* 객체에서 `undefined` 값만 제거합니다.
+*/
+function removeUndefinedProperties(sourceObject) {
+	const definedEntries = Object.entries(sourceObject).filter(([, value]) => value !== void 0);
+	return Object.fromEntries(definedEntries);
+}
+//#endregion
+//#region src/services/tax-invoice/service.ts
+const KOREA_TIME_ZONE = "Asia/Seoul";
+const SEARCH_STATE_CODE_PATTERN = /^\d[\d*][\d*]$/;
+const KOREA_DATE_FORMATTER = new Intl.DateTimeFormat("en-US", {
+	timeZone: KOREA_TIME_ZONE,
+	year: "numeric",
+	month: "2-digit",
+	day: "2-digit"
+});
+const SEARCH_INVOICES_OPERATION = "taxInvoice.searchInvoices";
+/**
+* TaxInvoice modern facade 서비스를 생성합니다.
+*
+* 입력 DTO를 compat positional 인자로 변환하고,
+* compat 에러를 `PopbillApiError`로 표준화하여 재throw 합니다.
+*/
+function createTaxInvoiceService(input) {
+	const compatTaxInvoiceService = input.compatTaxInvoiceService;
+	return {
+		issueInvoiceImmediately(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.issueInvoiceImmediately", async () => {
+				return mapTaxInvoiceIssueResult(await compatTaxInvoiceService.registIssue(request.businessNumber, mapTaxInvoiceDocument(request.taxInvoiceDocument), request.writeSpecification, request.forceIssue, request.historyMemo, request.emailSubject, request.dealInvoiceManagementKey, input.defaultUserId));
+			});
+		},
+		submitBulkIssue(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.submitBulkIssue", async () => {
+				return mapTaxInvoiceBulkSubmitResult(await compatTaxInvoiceService.bulkSubmit(request.businessNumber, request.submissionIdentifier, mapTaxInvoiceDocuments(request.taxInvoiceDocuments), request.forceIssue, input.defaultUserId));
+			});
+		},
+		getBulkIssueSubmissionResult(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getBulkIssueSubmissionResult", async () => {
+				return mapTaxInvoiceBulkIssueSubmissionResult(await compatTaxInvoiceService.getBulkResult(request.businessNumber, request.submissionIdentifier, input.defaultUserId));
+			});
+		},
+		registerInvoice(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.registerInvoice", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.register(request.businessNumber, mapTaxInvoiceDocument(request.taxInvoiceDocument), input.defaultUserId));
+			});
+		},
+		updateInvoice(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.updateInvoice", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.update(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, mapTaxInvoiceDocument(request.taxInvoiceDocument), input.defaultUserId));
+			});
+		},
+		issueInvoice(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.issueInvoice", async () => {
+				return mapTaxInvoiceIssueResult(await compatTaxInvoiceService.issue(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, request.historyMemo, request.emailSubject, request.forceIssue, input.defaultUserId));
+			});
+		},
+		cancelIssuedInvoice(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.cancelIssuedInvoice", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.cancelIssue(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, request.historyMemo, input.defaultUserId));
+			});
+		},
+		requestReverseIssueImmediately(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.requestReverseIssueImmediately", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.registRequest(request.businessNumber, mapTaxInvoiceDocument(request.taxInvoiceDocument), request.historyMemo, input.defaultUserId));
+			});
+		},
+		requestReverseIssue(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.requestReverseIssue", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.request(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, request.historyMemo, input.defaultUserId));
+			});
+		},
+		cancelReverseIssueRequest(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.cancelReverseIssueRequest", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.cancelRequest(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, request.historyMemo, input.defaultUserId));
+			});
+		},
+		refuseReverseIssueRequest(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.refuseReverseIssueRequest", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.refuse(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, request.historyMemo, input.defaultUserId));
+			});
+		},
+		deleteInvoice(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.deleteInvoice", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.delete(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		sendInvoiceToNTS(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.sendInvoiceToNTS", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.sendToNTS(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		async getInvoiceInfo(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getInvoiceInfo", async () => {
+				return mapTaxInvoiceInfo(await compatTaxInvoiceService.getInfo(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		getInvoicesInfo(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getInvoicesInfo", async () => {
+				return mapTaxInvoiceInfos(await compatTaxInvoiceService.getInfos(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKeys, input.defaultUserId));
+			});
+		},
+		getInvoiceDetailInfo(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getInvoiceDetailInfo", async () => {
+				return mapTaxInvoiceDocumentOutput(await compatTaxInvoiceService.getDetailInfo(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		checkInvoiceManagementKeyInUse(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.checkInvoiceManagementKeyInUse", async () => {
+				return mapTaxInvoiceInvoiceManagementKeyUsage(await compatTaxInvoiceService.checkMgtKeyInUse(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		getInvoiceXML(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getInvoiceXML", async () => {
+				return mapTaxInvoiceXmlResult(await compatTaxInvoiceService.getXML(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		searchInvoices(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.searchInvoices", async () => {
+				const normalizedSearchRequest = normalizeSearchInvoicesRequest(request);
+				return mapTaxInvoiceSearchResult(await compatTaxInvoiceService.search(request.businessNumber, request.invoiceDocumentKeyType, normalizedSearchRequest.searchDateType, normalizedSearchRequest.startDate, normalizedSearchRequest.endDate, normalizedSearchRequest.invoiceStateCodes, normalizedSearchRequest.invoiceTypeCodes, normalizedSearchRequest.taxationTypeCodes, normalizedSearchRequest.lateIssueOnly, normalizedSearchRequest.sortOrder, normalizedSearchRequest.pageNumber, normalizedSearchRequest.pageSize, normalizedSearchRequest.taxRegistrationIdentifierType, normalizedSearchRequest.taxRegistrationIdentifierAvailability, normalizedSearchRequest.taxRegistrationIdentifier, normalizedSearchRequest.queryText, normalizedSearchRequest.interoperabilityType, input.defaultUserId, normalizedSearchRequest.issueTypeCodes, normalizedSearchRequest.registrationTypeCodes, toCompatCloseDownStateCodes(normalizedSearchRequest.closeDownStateCodes), normalizedSearchRequest.invoiceManagementKeyOrNationalTaxServiceConfirmationNumber));
+			});
+		},
+		getInvoiceLogs(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getInvoiceLogs", async () => {
+				return mapTaxInvoiceLogs(await compatTaxInvoiceService.getLogs(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		getTaxInvoiceBoxURL(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getTaxInvoiceBoxURL", async () => {
+				return mapTaxInvoiceAccessUrlFromString(await compatTaxInvoiceService.getURL(request.businessNumber, request.taxInvoiceBoxScope, input.defaultUserId));
+			});
+		},
+		getInvoicePopupURL(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getInvoicePopupURL", async () => {
+				return mapTaxInvoiceAccessUrlFromString(await compatTaxInvoiceService.getPopUpURL(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		getInvoiceViewURL(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getInvoiceViewURL", async () => {
+				return mapTaxInvoiceAccessUrlFromString(await compatTaxInvoiceService.getViewURL(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		getSupplierInvoicePrintURL(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getSupplierInvoicePrintURL", async () => {
+				return mapTaxInvoiceAccessUrlFromString(await compatTaxInvoiceService.getPrintURL(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		getBuyerInvoicePrintURL(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getBuyerInvoicePrintURL", async () => {
+				return mapTaxInvoiceAccessUrlFromString(await compatTaxInvoiceService.getEPrintURL(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		getBulkInvoicePrintURL(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getBulkInvoicePrintURL", async () => {
+				return mapTaxInvoiceAccessUrlFromString(await compatTaxInvoiceService.getMassPrintURL(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKeys, input.defaultUserId));
+			});
+		},
+		getInvoiceMailURL(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getInvoiceMailURL", async () => {
+				return mapTaxInvoiceAccessUrlFromString(await compatTaxInvoiceService.getMailURL(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		getInvoicePDFURL(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getInvoicePDFURL", async () => {
+				return mapTaxInvoiceAccessUrlFromString(await compatTaxInvoiceService.getPDFURL(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		getSealAndAttachmentRegistrationURL(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getSealAndAttachmentRegistrationURL", async () => {
+				return mapTaxInvoiceAccessUrl(await compatTaxInvoiceService.getSealURL(request.businessNumber, input.defaultUserId));
+			});
+		},
+		attachFileFromPath(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.attachFileFromPath", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.attachFile(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, request.displayName, request.filePath, input.defaultUserId));
+			});
+		},
+		attachFileFromBinary(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.attachFileFromBinary", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.attachFileBinary(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, {
+					fileName: request.fileName,
+					fileData: request.fileData
+				}, input.defaultUserId));
+			});
+		},
+		deleteAttachedFile(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.deleteAttachedFile", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.deleteFile(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, request.fileIdentifier, input.defaultUserId));
+			});
+		},
+		getAttachedFiles(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getAttachedFiles", async () => {
+				return mapTaxInvoiceAttachedFiles(await compatTaxInvoiceService.getFiles(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		resendInvoiceEmail(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.resendInvoiceEmail", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.sendEmail(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, request.receiverEmailAddress, input.defaultUserId));
+			});
+		},
+		resendInvoiceSMS(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.resendInvoiceSMS", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.sendSMS(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, request.senderPhoneNumber, request.receiverPhoneNumber, request.messageBody, input.defaultUserId));
+			});
+		},
+		resendInvoiceFAX(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.resendInvoiceFAX", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.sendFAX(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, request.senderNumber, request.receiverNumber, input.defaultUserId));
+			});
+		},
+		attachInvoiceStatement(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.attachInvoiceStatement", async () => {
+				const statementItemCode = normalizeStatementItemCode(request.statementItemCode, "taxInvoice.attachInvoiceStatement");
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.attachStatement(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, statementItemCode, request.statementManagementKey, input.defaultUserId));
+			});
+		},
+		detachInvoiceStatement(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.detachInvoiceStatement", async () => {
+				const statementItemCode = normalizeStatementItemCode(request.statementItemCode, "taxInvoice.detachInvoiceStatement");
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.detachStatement(request.businessNumber, request.invoiceDocumentKeyType, request.invoiceManagementKey, statementItemCode, request.statementManagementKey, input.defaultUserId));
+			});
+		},
+		assignInvoiceManagementKey(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.assignInvoiceManagementKey", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.assignMgtKey(request.businessNumber, request.invoiceDocumentKeyType, request.itemKey, request.invoiceManagementKey, input.defaultUserId));
+			});
+		},
+		getEmailSendSettings(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getEmailSendSettings", async () => {
+				return mapTaxInvoiceEmailSendSettings(await compatTaxInvoiceService.listEmailConfig(request.businessNumber, input.defaultUserId));
+			});
+		},
+		updateEmailSendSettings(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.updateEmailSendSettings", async () => {
+				const emailType = normalizeEmailType(request.emailType, "taxInvoice.updateEmailSendSettings");
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.updateEmailConfig(request.businessNumber, emailType, request.sendEnabled, input.defaultUserId));
+			});
+		},
+		getSendToNTSSettings(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getSendToNTSSettings", async () => {
+				return mapTaxInvoiceSendToNationalTaxServiceSetting(await compatTaxInvoiceService.getSendToNTSConfig(request.businessNumber, input.defaultUserId));
+			});
+		},
+		getTaxCertificateRegistrationURL(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getTaxCertificateRegistrationURL", async () => {
+				return mapTaxInvoiceAccessUrl(await compatTaxInvoiceService.getTaxCertURL(request.businessNumber, input.defaultUserId));
+			});
+		},
+		getTaxCertificateExpirationDate(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getTaxCertificateExpirationDate", async () => {
+				return mapTaxInvoiceTaxCertificateExpiration(await compatTaxInvoiceService.getCertificateExpireDate(request.businessNumber, input.defaultUserId));
+			});
+		},
+		checkTaxCertificateValidation(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.checkTaxCertificateValidation", async () => {
+				return mapTaxInvoiceOperationResult(await compatTaxInvoiceService.checkCertValidation(request.businessNumber, input.defaultUserId));
+			});
+		},
+		getTaxCertificateInfo(request) {
+			return invokeTaxInvoiceMethod(input, "taxInvoice.getTaxCertificateInfo", async () => {
+				return mapTaxInvoiceTaxCertificateInfo(await compatTaxInvoiceService.getTaxCertInfo(request.businessNumber, input.defaultUserId));
+			});
+		}
+	};
+}
+function normalizeSearchInvoicesRequest(request) {
+	return {
+		searchDateType: normalizeCodeValue(request.searchDateType, Object.values(TaxInvoiceDateType), "searchDateType", SEARCH_INVOICES_OPERATION),
+		startDate: normalizeSearchDateInput(request.startDate, "startDate", SEARCH_INVOICES_OPERATION),
+		endDate: normalizeSearchDateInput(request.endDate, "endDate", SEARCH_INVOICES_OPERATION),
+		invoiceStateCodes: normalizeSearchStateCodes(request.invoiceStateCodes),
+		invoiceTypeCodes: normalizeCodeArray(request.invoiceTypeCodes, Object.values(TaxInvoiceSearchInvoiceTypeCodes), "invoiceTypeCodes", SEARCH_INVOICES_OPERATION),
+		taxationTypeCodes: normalizeCodeArray(request.taxationTypeCodes, Object.values(TaxInvoiceSearchTaxationTypeCodes), "taxationTypeCodes", SEARCH_INVOICES_OPERATION),
+		lateIssueOnly: request.lateIssueOnly,
+		sortOrder: normalizeCodeValue(request.sortOrder, Object.values(TaxInvoiceSortOrder), "sortOrder", SEARCH_INVOICES_OPERATION),
+		pageNumber: request.pageNumber,
+		pageSize: request.pageSize,
+		taxRegistrationIdentifierType: normalizeOptionalCodeValue(request.taxRegistrationIdentifierType, Object.values(TaxInvoiceSearchTaxRegistrationIdentifierTypes), "taxRegistrationIdentifierType", SEARCH_INVOICES_OPERATION),
+		taxRegistrationIdentifierAvailability: normalizeOptionalCodeValue(request.taxRegistrationIdentifierAvailability, Object.values(TaxInvoiceSearchTaxRegistrationIdentifierAvailabilities), "taxRegistrationIdentifierAvailability", SEARCH_INVOICES_OPERATION),
+		taxRegistrationIdentifier: request.taxRegistrationIdentifier,
+		queryText: request.queryText,
+		interoperabilityType: normalizeOptionalCodeValue(request.interoperabilityType, Object.values(TaxInvoiceSearchInteroperabilityTypes), "interoperabilityType", SEARCH_INVOICES_OPERATION),
+		issueTypeCodes: normalizeOptionalCodeArray(request.issueTypeCodes, Object.values(TaxInvoiceSearchIssueTypeCodes), "issueTypeCodes", SEARCH_INVOICES_OPERATION),
+		registrationTypeCodes: normalizeOptionalCodeArray(request.registrationTypeCodes, Object.values(TaxInvoiceSearchRegistrationTypeCodes), "registrationTypeCodes", SEARCH_INVOICES_OPERATION),
+		closeDownStateCodes: normalizeOptionalCodeArray(request.closeDownStateCodes, Object.values(TaxInvoiceCloseDownStateCodes), "closeDownStateCodes", SEARCH_INVOICES_OPERATION),
+		invoiceManagementKeyOrNationalTaxServiceConfirmationNumber: request.invoiceManagementKeyOrNationalTaxServiceConfirmationNumber
+	};
+}
+function toCompatCloseDownStateCodes(closeDownStateCodes) {
+	return closeDownStateCodes;
+}
+function normalizeSearchStateCodes(searchStateCodes) {
+	if (!Array.isArray(searchStateCodes)) throw createInputValidationError("invoiceStateCodes는 배열이어야 해.", {
+		operation: SEARCH_INVOICES_OPERATION,
+		stage: PopbillErrorStage.ValidateInput
+	});
+	return searchStateCodes.map((searchStateCode, index) => {
+		if (typeof searchStateCode !== "string" || !SEARCH_STATE_CODE_PATTERN.test(searchStateCode)) throw createInputValidationError(`invoiceStateCodes[${index}]에 유효하지 않은 상태코드가 있어. 허용 패턴: 숫자 3자리 또는 2/3자리 와일드카드 (예: 300, 3**, 60*)`, {
+			operation: SEARCH_INVOICES_OPERATION,
+			stage: PopbillErrorStage.ValidateInput
+		});
+		return searchStateCode;
+	});
+}
+function normalizeSearchDateInput(dateInput, fieldName, operation) {
+	if (dateInput instanceof Date) {
+		if (!Number.isFinite(dateInput.getTime())) throw createInputValidationError(`${fieldName}는 유효한 Date여야 해.`, {
+			operation,
+			stage: PopbillErrorStage.ValidateInput
+		});
+		return formatDateToKoreaDateString(dateInput);
+	}
+	if (typeof dateInput !== "string") throw createInputValidationError(`${fieldName}는 yyyyMMdd 문자열 또는 Date여야 해.`, {
+		operation,
+		stage: PopbillErrorStage.ValidateInput
+	});
+	const normalizedDateInput = dateInput.trim();
+	if (!isValidDateString(normalizedDateInput)) throw createInputValidationError(`${fieldName}는 yyyyMMdd 형식의 유효한 날짜여야 해.`, {
+		operation,
+		stage: PopbillErrorStage.ValidateInput
+	});
+	return normalizedDateInput;
+}
+function formatDateToKoreaDateString(date) {
+	let year = "";
+	let month = "";
+	let day = "";
+	for (const datePart of KOREA_DATE_FORMATTER.formatToParts(date)) {
+		if (datePart.type === "year") {
+			year = datePart.value;
+			continue;
+		}
+		if (datePart.type === "month") {
+			month = datePart.value;
+			continue;
+		}
+		if (datePart.type === "day") day = datePart.value;
+	}
+	return `${year}${month}${day}`;
+}
+function isValidDateString(dateString) {
+	const match = /^(\d{4})(\d{2})(\d{2})$/.exec(dateString);
+	if (!match) return false;
+	const year = Number(match[1]);
+	const month = Number(match[2]);
+	const day = Number(match[3]);
+	const normalizedDate = new Date(Date.UTC(year, month - 1, day));
+	return normalizedDate.getUTCFullYear() === year && normalizedDate.getUTCMonth() === month - 1 && normalizedDate.getUTCDate() === day;
+}
+function normalizeStatementItemCode(statementItemCode, operation) {
+	return normalizeCodeValue(statementItemCode, Object.values(TaxInvoiceStatementItemCodes), "statementItemCode", operation);
+}
+function normalizeEmailType(emailType, operation) {
+	return normalizeCodeValue(emailType, Object.values(TaxInvoiceEmailTypes), "emailType", operation);
+}
+function normalizeOptionalCodeValue(codeValue, allowedValues, fieldName, operation) {
+	if (codeValue === void 0) return;
+	return normalizeCodeValue(codeValue, allowedValues, fieldName, operation);
+}
+function normalizeOptionalCodeArray(codeValues, allowedValues, fieldName, operation) {
+	if (codeValues === void 0) return;
+	return normalizeCodeArray(codeValues, allowedValues, fieldName, operation);
+}
+function normalizeCodeArray(codeValues, allowedValues, fieldName, operation) {
+	if (!Array.isArray(codeValues)) throw createInputValidationError(`${fieldName}는 배열이어야 해.`, {
+		operation,
+		stage: PopbillErrorStage.ValidateInput
+	});
+	return codeValues.map((codeValue, index) => normalizeCodeValue(codeValue, allowedValues, `${fieldName}[${index}]`, operation));
+}
+function normalizeCodeValue(codeValue, allowedValues, fieldName, operation) {
+	for (const allowedValue of allowedValues) if (codeValue === allowedValue) return allowedValue;
+	throw createInputValidationError(`${fieldName}에 유효하지 않은 값이 있어. 허용값: ${allowedValues.map((allowedValue) => String(allowedValue)).join(", ")} (입력값: ${String(codeValue)})`, {
+		operation,
+		stage: PopbillErrorStage.ValidateInput
+	});
+}
+//#endregion
+//#region src/internal/compat/tax-invoice-service.ts
+const DEFAULT_REQUEST_TIMEOUT_MILLISECONDS$1 = 18e4;
+const DEFAULT_ACCEPT_ENCODING$1 = "gzip";
+/**
+* `@connextable/popbill-compat` Taxinvoice promise 서비스를 client 단위 인스턴스로 생성합니다.
+*/
+function createCompatTaxInvoiceService(input) {
+	return createTaxinvoicePromiseService({
+		LinkID: input.linkId,
+		SecretKey: input.secretKey,
+		IsTest: input.isTest ?? false,
+		UseStaticIP: input.useStaticIp ?? false,
+		UseGAIP: input.useGaIp ?? false,
+		UseLocalTimeYN: input.useLocalTime ?? true,
+		IPRestrictOnOff: input.ipRestrictOnOff ?? true,
+		requestTimeoutMs: input.requestTimeoutMilliseconds ?? DEFAULT_REQUEST_TIMEOUT_MILLISECONDS$1,
+		acceptLanguage: normalizeOptionalString(input.acceptLanguage),
+		acceptEncoding: input.acceptEncoding === void 0 ? DEFAULT_ACCEPT_ENCODING$1 : input.acceptEncoding
+	});
+}
+//#endregion
+//#region src/client/index.ts
+const DEFAULT_REQUEST_TIMEOUT_MILLISECONDS = 18e4;
+const DEFAULT_ACCEPT_ENCODING = "gzip";
+/**
+* modern Popbill client를 생성합니다.
+*/
+function createPopbillClient(config) {
+	const normalizedConfig = normalizeClientConfiguration(config);
+	return { services: { taxInvoice: createTaxInvoiceService({
+		compatTaxInvoiceService: createCompatTaxInvoiceService(normalizedConfig),
+		defaultUserId: normalizedConfig.userId,
+		onError: normalizedConfig.onError
+	}) } };
+}
+/**
+* 입력 설정을 런타임 안전성 기준으로 정규화합니다.
+*/
+function normalizeClientConfiguration(config) {
+	return {
+		linkId: normalizeRequiredString(config.linkId, "linkId는 필수입니다."),
+		secretKey: normalizeRequiredString(config.secretKey, "secretKey는 필수입니다."),
+		userId: normalizeRequiredString(config.userId, "userId는 필수입니다."),
+		isTest: config.isTest ?? false,
+		useStaticIp: config.useStaticIp ?? false,
+		useGaIp: config.useGaIp ?? false,
+		useLocalTime: config.useLocalTime ?? true,
+		ipRestrictOnOff: config.ipRestrictOnOff ?? true,
+		acceptEncoding: config.acceptEncoding === void 0 ? DEFAULT_ACCEPT_ENCODING : config.acceptEncoding,
+		acceptLanguage: normalizeOptionalString(config.acceptLanguage),
+		requestTimeoutMilliseconds: normalizeRequestTimeoutMilliseconds(config.requestTimeoutMs),
+		onError: config.onError
+	};
+}
+function normalizeRequestTimeoutMilliseconds(requestTimeoutMs) {
+	if (requestTimeoutMs === void 0) return DEFAULT_REQUEST_TIMEOUT_MILLISECONDS;
+	if (!Number.isInteger(requestTimeoutMs) || requestTimeoutMs <= 0) throw new Error("requestTimeoutMs는 1 이상의 정수여야 합니다.");
+	return requestTimeoutMs;
+}
+//#endregion
+//#region src/services/tax-invoice/methods.ts
+/**
+* TaxInvoice modern facade 공개 메서드 목록입니다.
+* 문서 섹션(발행/전송, 정보확인, 보기/인쇄, 부가기능, 인증서 관리) 순서를 유지합니다.
+*/
+const TAX_INVOICE_METHODS = [
+	"issueInvoiceImmediately",
+	"submitBulkIssue",
+	"getBulkIssueSubmissionResult",
+	"registerInvoice",
+	"updateInvoice",
+	"issueInvoice",
+	"cancelIssuedInvoice",
+	"requestReverseIssueImmediately",
+	"requestReverseIssue",
+	"cancelReverseIssueRequest",
+	"refuseReverseIssueRequest",
+	"deleteInvoice",
+	"sendInvoiceToNTS",
+	"getInvoiceInfo",
+	"getInvoicesInfo",
+	"getInvoiceDetailInfo",
+	"checkInvoiceManagementKeyInUse",
+	"getInvoiceXML",
+	"searchInvoices",
+	"getInvoiceLogs",
+	"getTaxInvoiceBoxURL",
+	"getInvoicePopupURL",
+	"getInvoiceViewURL",
+	"getSupplierInvoicePrintURL",
+	"getBuyerInvoicePrintURL",
+	"getBulkInvoicePrintURL",
+	"getInvoiceMailURL",
+	"getInvoicePDFURL",
+	"getSealAndAttachmentRegistrationURL",
+	"attachFileFromPath",
+	"attachFileFromBinary",
+	"deleteAttachedFile",
+	"getAttachedFiles",
+	"resendInvoiceEmail",
+	"resendInvoiceSMS",
+	"resendInvoiceFAX",
+	"attachInvoiceStatement",
+	"detachInvoiceStatement",
+	"assignInvoiceManagementKey",
+	"getEmailSendSettings",
+	"updateEmailSendSettings",
+	"getSendToNTSSettings",
+	"getTaxCertificateRegistrationURL",
+	"getTaxCertificateExpirationDate",
+	"checkTaxCertificateValidation",
+	"getTaxCertificateInfo"
+];
+//#endregion
+export { PopbillErrorStage, PopbillErrorType, TAX_INVOICE_METHODS, TaxInvoiceBoxScopes, TaxInvoiceBulkIssueSubmissionTransactionStates, TaxInvoiceBusinessStatusValues, TaxInvoiceChargeDirectionValues, TaxInvoiceCloseDownStateCodes, TaxInvoiceDateType, TaxInvoiceDocumentKeyTypes, TaxInvoiceEmailTypes, TaxInvoiceIssueTypes, TaxInvoiceModificationCodes, TaxInvoiceModificationReasonCodes, TaxInvoicePurposeTypes, TaxInvoiceRecipientTypes, TaxInvoiceSearchInteroperabilityTypes, TaxInvoiceSearchInvoiceTypeCodes, TaxInvoiceSearchIssueTypeCodes, TaxInvoiceSearchRegistrationTypeCodes, TaxInvoiceSearchTaxRegistrationIdentifierAvailabilities, TaxInvoiceSearchTaxRegistrationIdentifierTypes, TaxInvoiceSearchTaxationTypeCodes, TaxInvoiceSortOrder, TaxInvoiceStatementItemCodes, TaxInvoiceTaxationTypes, createPopbillClient };