@sayren/storefront-sdk 0.15.0 → 0.17.0

package/dist/auth/index.mjs

@@ -1,4 +1,4 @@
-import { gt as ApiError, t as createStorefrontClient } from "../client-ZPNEEeRT.mjs";
+import { pt as ApiError, t as createStorefrontClient } from "../client-CBAgQuTc.mjs";
 //#region src/auth/index.ts
 /** 소셜 로그인 실패 — 구매자가 취소했거나(`access_denied`) state가 맞지 않는다 */
 var IdpCallbackError = class extends Error {

package/dist/{checkout-Dsv9C9Zp.mjs → checkout-C25liqdW.mjs}

@@ -2,20 +2,14 @@ import { z } from "zod";
 //#region src/schemas/fulfillment.ts
 /**
 * 구매자용 상품 이행 (이슈 #57) — 관리 API의 상품 이행에서 구매자에게 필요한 것만 싣는다. 유형, 배송 필요 여부, 배송 안내(배송비·
-* 무료 기준·반품·교환 배송비), 청약철회 제한 여부, 방문 수령지 표시값이다. 셀러 내부 값(출고지·반품지 id, 코드 풀 여부, 재고 추적 여부)은
-* 싣지 않는다.
+* 무료 기준·반품·교환 배송비)다. 셀러 내부 값(출고지·반품지 id)은 싣지 않는다.
 *
-* 유형 이름은 응답에서 문자열이고, 모르는 유형(서버가 나중에 더한 유형, 예: #56 `RESERVATION`)은 `{ type: "OTHER", rawType,
+* 유형은 `SHIPPING`(배송 상품)과 `MANUAL`(배송 없는 상품, 판매자가 제공 처리) 둘이다(이슈 #48 범위 축소).
+* 유형 이름은 응답에서 문자열이고, 모르는 유형(서버가 나중에 더한 유형)은 `{ type: "OTHER", rawType,
 * requiresShipping }`로 읽는다. `requiresShipping`은 판별 값에서 파생되지만 **모든 가지에 싣는다** — 모르는 유형에서도 주문서가
 * 배송지를 받을지 정할 수 있어야 한다.
 */
-const KNOWN_TYPES = [
-	"SHIPPING",
-	"DOWNLOAD",
-	"CODE",
-	"SERVICE",
-	"PICKUP"
-];
+const KNOWN_TYPES = ["SHIPPING", "MANUAL"];
 /** 알려진 유형만 판별 유니온으로 검사하고 모르는 유형은 `OTHER`로 읽는다. 알려진 유형의 모양이 틀리면 파싱 오류다 */
 function openUnion(known) {
 	return z.union([known, z.looseObject({
@@ -28,99 +22,115 @@ function openUnion(known) {
 	}))]);
 }
 const requiresShippingDescription = "택배 배송이 필요한가. false면 배송비가 없고 주문서가 배송지를 받지 않는다";
-const withdrawalRestrictedField = z.boolean().describe("청약철회 제한 대상인가. true면 주문서가 제한 고지 동의를 받고, 첫 다운로드·열람 뒤 단순 변심 취소·반품을 받지 않는다");
-/** 방문 수령 장소 표시값 — 주소 id는 싣지 않는다 */
-const pickupLocationSchema = z.object({
-	name: z.string().describe("수령 장소 이름"),
-	zipCode: z.string(),
-	address1: z.string(),
-	address2: z.string().nullable(),
-	phone: z.string().describe("수령 장소 연락처")
-});
 /** 상품 카드(목록·찜)의 이행 — 유형과 배송 필요 여부만. 배송비·환불 정책은 상세에서 본다 */
 const productCardFulfillmentSchema = z.object({
 	type: z.string().describe("상품 유형. 값이 추가될 수 있어 문자열로 받는다"),
 	requiresShipping: z.boolean().describe(requiresShippingDescription)
 });
 /** 상품 상세의 이행 */
-const productFulfillmentViewSchema = openUnion(z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("SHIPPING"),
-		requiresShipping: z.literal(true),
-		shipping: z.object({
-			deliveryType: z.string().describe("배송비 유형. 현재 값은 `FREE`·`PAID`·`CONDITIONAL_FREE`"),
-			deliveryFee: z.number().int().describe("기본 배송비. 원 단위. 묶음·지역 추가 배송비는 장바구니·주문서 견적이 정한다"),
-			conditionalFreeAmount: z.number().int().nullable().describe("조건부 무료 기준 금액. 조건부 무료가 아니면 null"),
-			estimatedDays: z.string().describe("예상 배송 기간 안내 문구"),
-			returnDeliveryFee: z.number().int().describe("단순 변심 반품 배송비(유효 환불 정책). 원 단위"),
-			exchangeDeliveryFee: z.number().int().describe("단순 변심 교환 배송비(유효 환불 정책). 원 단위")
-		})
-	}),
-	z.object({
-		type: z.literal("DOWNLOAD"),
-		requiresShipping: z.literal(false),
-		download: z.object({
-			limit: z.number().int().describe("다운로드 횟수 한도(수량 1개당)"),
-			days: z.number().int().describe("다운로드 기간(제공일부터 일수)"),
-			withdrawalRestricted: withdrawalRestrictedField
-		})
-	}),
-	z.object({
-		type: z.literal("CODE"),
-		requiresShipping: z.literal(false),
-		code: z.object({ withdrawalRestricted: withdrawalRestrictedField })
-	}),
-	z.object({
-		type: z.literal("SERVICE"),
-		requiresShipping: z.literal(false)
-	}),
-	z.object({
-		type: z.literal("PICKUP"),
-		requiresShipping: z.literal(false),
-		pickup: z.object({ location: pickupLocationSchema.nullable().describe("방문 수령 장소. 수령지가 지워졌으면 null이다(판매자에게 문의)") })
+const productFulfillmentViewSchema = openUnion(z.discriminatedUnion("type", [z.object({
+	type: z.literal("SHIPPING"),
+	requiresShipping: z.literal(true),
+	shipping: z.object({
+		deliveryType: z.string().describe("배송비 유형. 현재 값은 `FREE`·`PAID`·`CONDITIONAL_FREE`"),
+		deliveryFee: z.number().int().describe("기본 배송비. 원 단위. 묶음·지역 추가 배송비는 장바구니·주문서 견적이 정한다"),
+		conditionalFreeAmount: z.number().int().nullable().describe("조건부 무료 기준 금액. 조건부 무료가 아니면 null"),
+		estimatedDays: z.string().describe("예상 배송 기간 안내 문구"),
+		returnDeliveryFee: z.number().int().describe("단순 변심 반품 배송비(유효 환불 정책). 원 단위"),
+		exchangeDeliveryFee: z.number().int().describe("단순 변심 교환 배송비(유효 환불 정책). 원 단위")
 	})
-])).describe("상품 이행. `type`이 유형이고 같은 이름의 키가 유형별 안내다. 값이 추가될 수 있어 SDK는 모르는 유형을 `OTHER`로 읽는다");
+}), z.object({
+	type: z.literal("MANUAL"),
+	requiresShipping: z.literal(false)
+})])).describe("상품 이행. `type`이 유형이고 같은 이름의 키가 유형별 안내다. 값이 추가될 수 있어 SDK는 모르는 유형을 `OTHER`로 읽는다");
 /** 장바구니 줄·주문서 줄의 이행 — 주문서 줄은 주문서 시점 스냅샷이다 */
 const lineFulfillmentSchema = z.object({
 	type: z.string().describe("상품 유형. 값이 추가될 수 있어 문자열로 받는다"),
 	requiresShipping: z.boolean().describe(requiresShippingDescription),
-	withdrawalRestricted: withdrawalRestrictedField
+	withdrawalRestricted: z.boolean().optional().describe("**Deprecated** — 항상 false다. 청약철회 제한 기능을 없앴고(이슈 #48) storefront-sdk 0.15 이하 호환으로만 싣는다. 게시된 스토어프론트가 0.16 이상으로 넘어간 뒤 다음 릴리스에서 뺀다")
 });
 /**
-* 내 주문 주문상품의 주문 시점 이행 스냅샷. 상품을 나중에 고쳐도 바뀌지 않는다. 실제 제공 기록(코드 가린 값·다운로드 남은 횟수)은
+* 내 주문 주문상품의 주문 시점 이행 스냅샷. 상품을 나중에 고쳐도 바뀌지 않는다. 제공 기록(제공 시각·판매자 안내)은
 * 주문상품의 `fulfillment`다.
 */
-const myOrderItemFulfillmentSnapshotSchema = openUnion(z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("SHIPPING"),
-		requiresShipping: z.literal(true)
-	}),
-	z.object({
-		type: z.literal("DOWNLOAD"),
-		requiresShipping: z.literal(false),
-		download: z.object({ withdrawalRestricted: withdrawalRestrictedField })
-	}),
-	z.object({
-		type: z.literal("CODE"),
-		requiresShipping: z.literal(false),
-		code: z.object({ withdrawalRestricted: withdrawalRestrictedField })
-	}),
-	z.object({
-		type: z.literal("SERVICE"),
-		requiresShipping: z.literal(false)
-	}),
-	z.object({
-		type: z.literal("PICKUP"),
-		requiresShipping: z.literal(false),
-		pickup: z.object({ location: pickupLocationSchema.nullable().describe("주문 시점 방문 수령 장소. 수령지가 지워졌으면 null이다(판매자에게 문의)") })
-	})
-])).describe("주문 시점 이행 스냅샷. 값이 추가될 수 있어 SDK는 모르는 유형을 `OTHER`로 읽는다");
-/** 청약철회 제한 대상인가 — 파일 다운로드·코드 발급만 켤 수 있다 */
-function withdrawalRestrictedOfView(fulfillment) {
-	if (fulfillment.type === "DOWNLOAD") return fulfillment.download.withdrawalRestricted;
-	if (fulfillment.type === "CODE") return fulfillment.code.withdrawalRestricted;
-	return false;
+const myOrderItemFulfillmentSnapshotSchema = openUnion(z.discriminatedUnion("type", [z.object({
+	type: z.literal("SHIPPING"),
+	requiresShipping: z.literal(true)
+}), z.object({
+	type: z.literal("MANUAL"),
+	requiresShipping: z.literal(false)
+})])).describe("주문 시점 이행 스냅샷. 값이 추가될 수 있어 SDK는 모르는 유형을 `OTHER`로 읽는다");
+//#endregion
+//#region src/schemas/product-options.ts
+/**
+* 추가 선택·직접 입력 (이슈 #59) — 상품 상세의 옵션 표시, 장바구니 담기·바로 구매 요청, 줄 스냅샷의 공통 모양.
+*
+* 추가 선택은 재고가 없는 옵션이다. 구매자가 조합(옵션이 없으면 상품)을 고른 뒤 옵션명마다 값 하나를 더 고르고, 값의 추가금이
+* 단가에 더해진다. 직접 입력은 구매자가 글자를 적는 항목(각인 문구 등)이다. 추가 선택 값이나 직접 입력값이 다르면 장바구니에서 다른 줄이다.
+*/
+const addonGroupViewSchema = z.object({
+	groupId: z.string(),
+	name: z.string(),
+	required: z.boolean().describe("꼭 골라야 하는가. false면 고르지 않아도 된다(「선택 안 함」)"),
+	values: z.array(z.object({
+		valueId: z.string(),
+		name: z.string(),
+		additionalPrice: z.number().int().describe("이 값을 고르면 단가에 더하는 금액(원, 0 이상)")
+	})).describe("고를 수 있는 값(셀러가 끈 값은 빠진다)")
+});
+const customInputViewSchema = z.object({
+	inputId: z.string(),
+	label: z.string().describe("항목명"),
+	placeholder: z.string().nullable().describe("입력 안내. 없으면 null"),
+	maxLength: z.number().int().describe("최대 글자 수"),
+	required: z.boolean()
+});
+/**
+* 직접 입력값 정규화 — NFC로 모으고, 제어 문자(C0·C1·줄바꿈·줄·문단 구분자)는 공백으로, 제로폭·양방향 제어 문자는 지운 뒤
+* 앞뒤 공백을 지운다. 서버가 저장하는 값이 이것이다. 빈 문자열이면 입력하지 않은 것으로 본다.
+* (양방향 제어 문자를 두면 셀러 주문 화면의 각인 문구가 뒤집혀 보이게 할 수 있다.)
+*/
+function normalizeCustomInputValue(value) {
+	return value.normalize("NFC").replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029]/g, " ").replace(/[\u200b-\u200f\u202a-\u202e\u2060-\u2064\u2066-\u2069\ufeff]/g, "").trim();
+}
+/**
+* 직접 입력값의 글자 수 — 정규화한 값의 **코드 포인트 수**다(이모지 하나가 1자). 서버의 최대 글자 수 판정(`CUSTOM_INPUT_TOO_LONG`)과
+* 스토어프론트·콘솔의 글자 수 표시가 이 함수 하나를 쓴다. `String.length`(UTF-16)로 세면 이모지가 2자로 세어 판정이 갈린다.
+*/
+function customInputLength(value) {
+	return [...normalizeCustomInputValue(value)].length;
 }
+/** 담기·바로 구매 요청의 직접 입력값 한 칸. 앞뒤 공백을 지우고, 빈 값은 입력하지 않은 것으로 본다 */
+const customInputEntrySchema = z.object({
+	inputId: z.string(),
+	value: z.string().max(1e3)
+});
+/** 고른 추가 선택 한 칸 — 옵션명(`groupId`)과 그 옵션명의 값(`valueId`) */
+const addonSelectionSchema = z.object({
+	groupId: z.string(),
+	valueId: z.string()
+});
+/** 요청의 추가 선택·직접 입력 필드 — 담기·장바구니 수정·바로 구매가 같은 이름을 쓴다 */
+const lineSelectionRequestShape = {
+	addons: z.array(addonSelectionSchema).max(20).optional().describe("고른 추가 선택(옵션명마다 하나, 고르지 않은 옵션명은 빼고 보낸다). 필수 옵션명을 빼면 400 `ADDON_OPTION_REQUIRED`, 없거나 꺼진 값이거나 한 옵션명에서 둘을 고르면 400 `ADDON_OPTION_NOT_FOUND`"),
+	customInputs: z.array(customInputEntrySchema).max(20).optional().describe("직접 입력값. 필수 항목을 비우면 400 `CUSTOM_INPUT_REQUIRED`, 최대 글자 수를 넘으면 400 `CUSTOM_INPUT_TOO_LONG`, 없는 항목이면 400 `CUSTOM_INPUT_NOT_FOUND`")
+};
+/** 줄의 옵션 선택 스냅샷 한 칸 — 조합 옵션은 옵션명마다 한 칸이고 추가금이 0이다(조합 추가금은 단가에 들어 있다) */
+const optionSelectionViewSchema = z.object({
+	kind: z.string().describe("옵션명 방식. 현재 값은 `combination`·`addon`이고 값이 추가될 수 있어 문자열로 받는다"),
+	groupName: z.string(),
+	valueName: z.string(),
+	additionalPrice: z.number().int()
+});
+const customInputValueViewSchema = z.object({
+	label: z.string().describe("항목명"),
+	value: z.string().describe("구매자가 적은 값")
+});
+/** 응답 줄의 표시 필드 — 장바구니·주문서·주문상품이 같은 이름을 쓴다 */
+const lineSelectionResponseShape = {
+	optionSelections: z.array(optionSelectionViewSchema).optional().default([]).describe("옵션 선택(조합 옵션 + 추가 선택). 옵션이 없으면 빈 배열. 서버는 항상 싣는다"),
+	customInputs: z.array(customInputValueViewSchema).optional().default([]).describe("직접 입력값(항목명과 값). 없으면 빈 배열. 서버는 항상 싣는다")
+};
 //#endregion
 //#region src/schemas/coupon.ts
 /**
@@ -136,7 +146,8 @@ function withdrawalRestrictedOfView(fulfillment) {
 const couponApplicationSchema = z.object({
 	issueId: z.string().min(1).optional().describe("내 쿠폰(발급 쿠폰) id — `GET /me/coupons`의 `issueId`"),
 	code: z.string().trim().min(1).max(30).optional().describe("쿠폰 코드. 대소문자를 구분하지 않는다"),
-	optionId: z.string().optional().describe("상품 쿠폰을 걸 주문서 항목의 `optionId`. 생략하면 할인이 가장 큰 항목에 건다. 주문 쿠폰에는 쓰지 않는다")
+	optionId: z.string().optional().describe("상품 쿠폰을 걸 주문서 항목의 `optionId`. 생략하면 할인이 가장 큰 항목에 건다. 주문 쿠폰에는 쓰지 않는다. 같은 `optionId`의 줄이 여럿이면 적용하지 못한다(`LINE_AMBIGUOUS`) — 그때는 `lineId`를 쓴다"),
+	lineId: z.string().optional().describe("상품 쿠폰을 걸 주문서 줄의 `lineId`(이슈 #59). 주면 `optionId`보다 우선한다. 주문 쿠폰에는 쓰지 않는다")
 }).refine((value) => (value.issueId ? 1 : 0) + (value.code ? 1 : 0) === 1, { message: "issueId와 code 중 하나만 보내 주십시오" });
 /** 한 번에 적용할 수 있는 쿠폰 수 */
 const MAX_COUPONS_PER_CHECKOUT = 5;
@@ -157,8 +168,9 @@ const couponResultSchema = z.object({
 	benefit: couponBenefitViewSchema,
 	applied: z.boolean(),
 	discountAmount: z.number().int().describe("이 쿠폰의 할인액. 적용하지 못했으면 0"),
-	rejectReason: z.string().nullable().describe("적용하지 못한 사유. `MIN_ORDER_AMOUNT`(최소 주문 금액 미달)·`NO_ELIGIBLE_ITEMS`(대상 상품 없음)·`NOT_STARTED`·`EXPIRED`·`MEMBER_ONLY`(회원 전용)·`STACK_LIMIT`(같은 종류 쿠폰이 이미 적용됨)·`DUPLICATE_COUPON`·`LINE_NOT_ELIGIBLE`·`NO_DISCOUNT`·`IN_USE`(다른 결제에서 쓰는 중)·`LIMIT_REACHED`(1인 사용 한도)·`EXHAUSTED`(총 사용 한도)·`INACTIVE`(중지된 쿠폰). 값이 늘 수 있다"),
-	optionId: z.string().nullable().describe("상품 쿠폰이 걸린 주문서 항목의 `optionId`. 그 밖은 null")
+	rejectReason: z.string().nullable().describe("적용하지 못한 사유. `MIN_ORDER_AMOUNT`(최소 주문 금액 미달)·`NO_ELIGIBLE_ITEMS`(대상 상품 없음)·`NOT_STARTED`·`EXPIRED`·`MEMBER_ONLY`(회원 전용)·`STACK_LIMIT`(같은 종류 쿠폰이 이미 적용됨)·`DUPLICATE_COUPON`·`LINE_NOT_ELIGIBLE`·`NO_DISCOUNT`·`LINE_AMBIGUOUS`(같은 `optionId`의 줄이 여럿, `lineId`로 지목한다)·`IN_USE`(다른 결제에서 쓰는 중)·`LIMIT_REACHED`(1인 사용 한도)·`EXHAUSTED`(총 사용 한도)·`INACTIVE`(중지된 쿠폰). 값이 늘 수 있다"),
+	optionId: z.string().nullable().describe("상품 쿠폰이 걸린 주문서 항목의 `optionId`. 그 밖은 null"),
+	lineId: z.string().nullable().optional().default(null).describe("상품 쿠폰이 걸린 주문서 줄의 `lineId`(이슈 #59). 그 밖은 null. 서버는 항상 싣는다")
 });
 /** 쿠폰을 반영한 금액 — 결제 금액 = productAmount − couponDiscountAmount + deliveryFee − deliveryDiscountAmount */
 const pricingAmountsSchema = z.object({
@@ -180,6 +192,7 @@ const checkoutPricingSchema = z.object({
 	coupons: z.array(couponResultSchema).describe("요청한 쿠폰마다 한 줄, 요청 순서대로"),
 	items: z.array(z.object({
 		optionId: z.string().nullable(),
+		lineId: z.string().optional().describe("주문서 줄의 `lineId`(이슈 #59). 서버는 항상 싣는다"),
 		couponDiscountAmount: z.number().int().describe("이 항목에 들어간 쿠폰 할인")
 	})).describe("주문서 항목별 쿠폰 할인 — 주문서 `items`와 같은 순서"),
 	payable: z.boolean().describe("이 금액으로 결제를 시작할 수 있는가 — 적용하지 못한 쿠폰이 있거나 결제 금액이 100원 미만이면 false")
@@ -225,7 +238,8 @@ const createCheckoutRequestSchema = z.object({
 	directItem: z.object({
 		productId: z.string(),
 		optionId: z.string().optional(),
-		quantity: z.number().int().min(1)
+		quantity: z.number().int().min(1),
+		...lineSelectionRequestShape
 	}).optional()
 }).refine((value) => value.cartItemIds ? !value.directItem : !!value.directItem, { message: "cartItemIds와 directItem 중 하나만 전달해야 합니다" });
 /** 지역 추가 배송비 구분 — 우편번호로 판정한다 */
@@ -256,13 +270,15 @@ const checkoutDeliverySchema = z.object({
 const checkoutSessionSchema = z.object({
 	checkoutId: z.string(),
 	items: z.array(z.object({
+		lineId: z.string().optional().describe("주문서 줄 id(이슈 #59). 같은 `optionId`가 추가 선택·직접 입력이 달라 여러 줄에 나올 수 있어, 상품 쿠폰을 걸 줄은 이 값으로 지목한다. 서버는 항상 싣는다"),
 		productId: z.string(),
 		productName: z.string(),
 		/** variantId. 옵션 없는 상품은 default variant id */
 		optionId: z.string().nullable(),
 		optionName: z.string().nullable(),
+		...lineSelectionResponseShape,
 		quantity: z.number().int(),
-		unitPrice: z.number().int(),
+		unitPrice: z.number().int().describe("단가 — 할인 반영 판매가 + 조합 추가금 + 추가 선택 추가금"),
 		totalPrice: z.number().int(),
 		fulfillment: lineFulfillmentSchema.describe("주문서 시점 상품 이행")
 	})),
@@ -276,9 +292,9 @@ const checkoutSessionSchema = z.object({
 	delivery: checkoutDeliverySchema.describe("배송비 내역. 배송지를 입력하면 금액이 바뀔 수 있다 — 최종 금액은 결제 시작 응답의 `amounts`다"),
 	requiresShipping: z.boolean().describe("택배 배송이 필요한 상품이 있는가. false면 배송지를 받지 않는다 — 결제 시작에 `shippingAddress`를 보내지 않아도 된다"),
 	withdrawal: z.object({
-		required: z.boolean().describe("청약철회 제한 상품(제공이 시작되면 취소·반품할 수 없는 파일·코드·이용권)이 있는가. true면 `notice`를 결제 전에 보여 주고 동의를 받아 결제 시작에 `withdrawalAgreement: true`를 보낸다"),
-		notice: z.string().nullable().describe("구매자에게 보여 줄 고지 문구. `required`가 false면 null")
-	}).describe("청약철회 제한 고지(이슈 #48)"),
+		required: z.boolean(),
+		notice: z.string().nullable()
+	}).optional().describe("**Deprecated** — 항상 `{ required: false, notice: null }`이다. 청약철회 제한 고지를 없앴고(이슈 #48) storefront-sdk 0.15 이하 호환으로만 싣는다. 게시된 스토어프론트가 0.16 이상으로 넘어간 뒤 다음 릴리스에서 뺀다"),
 	expiresAt: z.string(),
 	paymentOptions: z.lazy(() => paymentOptionListSchema).describe("이 주문서에서 고를 수 있는 결제 옵션, PG 우선순위순. 셀러가 켠 PG·결제수단·간편결제만 담긴다. 비어 있으면 지금 결제할 수 없다"),
 	testPayment: z.boolean().describe("지금 결제하면 테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않습니다 — 주문서에 테스트 결제 안내를 표시합니다. 결제 요청 시점에 스토어 결제 설정으로 다시 정해지니 최종 값은 결제 요청 응답의 `testPayment`입니다")
@@ -460,9 +476,8 @@ const cashReceiptField = cashReceiptRequestSchema.optional().describe("현금영
 const startPaymentRequestSchema = z.object({
 	option: paymentOptionSchema,
 	returnUrl: z.url().max(2048).describe("결제를 마치면 돌아올 스토어프론트 주소. 스토어 결제 도메인에 등록된 도메인이어야 한다"),
-	shippingAddress: shippingAddressInputSchema.optional().describe("배송지. 주문서의 `requiresShipping`이 true면 필수이고 없으면 400 `SHIPPING_ADDRESS_REQUIRED`다. 배송이 필요 없는 주문(파일·코드·이용권·방문 수령만)은 보내지 않아도 된다. 보내면 형식을 검사한 뒤 버린다"),
+	shippingAddress: shippingAddressInputSchema.optional().describe("배송지. 주문서의 `requiresShipping`이 true면 필수이고 없으면 400 `SHIPPING_ADDRESS_REQUIRED`다. 배송이 필요 없는 주문(배송 없는 상품만)은 보내지 않아도 된다. 보내면 형식을 검사한 뒤 버린다"),
 	guest: guestInfoSchema.optional(),
-	withdrawalAgreement: z.boolean().optional().describe("청약철회 제한 동의. 주문서의 `withdrawal.required`가 true면 true여야 하고 아니면 400 `WITHDRAWAL_AGREEMENT_REQUIRED`다. 동의 시각이 주문에 남는다"),
 	cashReceipt: cashReceiptField,
 	coupons: couponApplicationListSchema.optional().describe("적용할 쿠폰(이슈 #47). 결제 시작이 쿠폰을 예약하고 할인한 금액으로 결제 금액을 정한다 — 응답의 `amounts`가 확정 금액이다. 적용하지 못하는 쿠폰이 하나라도 있으면 400 `COUPON_NOT_APPLICABLE`(`details`에 사유)이다. 결제가 실패하거나 만료되면 예약이 풀린다. 쿠폰을 바꾸려면 새로 결제를 시작한다(재시도는 같은 쿠폰을 쓴다)")
 });
@@ -537,4 +552,4 @@ const paymentMessageSchema = z.object({
 	orderId: z.string().optional()
 });
 //#endregion
-export { startPaymentRequestSchema as A, myCouponListQuerySchema as B, paymentStartSchema as C, residentNumberLike as D, remoteAreaSchema as E, checkoutPricingSchema as F, pickupLocationSchema as G, pricingAmountsSchema as H, couponApplicationListSchema as I, withdrawalRestrictedOfView as J, productCardFulfillmentSchema as K, couponApplicationSchema as L, MIN_PAYMENT_AMOUNT as M, applicableCouponSchema as N, retryPaymentRequestSchema as O, checkoutPricingRequestSchema as P, couponBenefitViewSchema as R, paymentOptionSchema as S, pgProviderSchema as T, lineFulfillmentSchema as U, myCouponSchema as V, myOrderItemFulfillmentSnapshotSchema as W, paymentFailureCategorySchema as _, cashReceiptAvailable as a, paymentOptionKey as b, cashReceiptTypeSchema as c, createCheckoutRequestSchema as d, deliveryQuoteRequestSchema as f, guestInfoSchema as g, easyPayProviderSchema as h, availablePaymentOptionSchema as i, MAX_COUPONS_PER_CHECKOUT as j, shippingAddressInputSchema as k, checkoutDeliverySchema as l, easyPayProviderResponseSchema as m, PAYMENT_RESULT_VALUES as n, cashReceiptIdentityTypeOf as o, deliveryQuoteSchema as p, productFulfillmentViewSchema as q, PAYMENT_STATUS_VALUES as r, cashReceiptRequestSchema as s, CASH_RECEIPT_METHODS as t, checkoutSessionSchema as u, paymentMessageSchema as v, paymentStatusSchema as w, paymentOptionListSchema as x, paymentMethodSchema as y, couponResultSchema as z };
+export { lineFulfillmentSchema as $, startPaymentRequestSchema as A, myCouponListQuerySchema as B, paymentStartSchema as C, residentNumberLike as D, remoteAreaSchema as E, checkoutPricingSchema as F, customInputEntrySchema as G, pricingAmountsSchema as H, couponApplicationListSchema as I, customInputViewSchema as J, customInputLength as K, couponApplicationSchema as L, MIN_PAYMENT_AMOUNT as M, applicableCouponSchema as N, retryPaymentRequestSchema as O, checkoutPricingRequestSchema as P, optionSelectionViewSchema as Q, couponBenefitViewSchema as R, paymentOptionSchema as S, pgProviderSchema as T, addonGroupViewSchema as U, myCouponSchema as V, addonSelectionSchema as W, lineSelectionResponseShape as X, lineSelectionRequestShape as Y, normalizeCustomInputValue as Z, paymentFailureCategorySchema as _, cashReceiptAvailable as a, paymentOptionKey as b, cashReceiptTypeSchema as c, createCheckoutRequestSchema as d, myOrderItemFulfillmentSnapshotSchema as et, deliveryQuoteRequestSchema as f, guestInfoSchema as g, easyPayProviderSchema as h, availablePaymentOptionSchema as i, MAX_COUPONS_PER_CHECKOUT as j, shippingAddressInputSchema as k, checkoutDeliverySchema as l, easyPayProviderResponseSchema as m, PAYMENT_RESULT_VALUES as n, productFulfillmentViewSchema as nt, cashReceiptIdentityTypeOf as o, deliveryQuoteSchema as p, customInputValueViewSchema as q, PAYMENT_STATUS_VALUES as r, cashReceiptRequestSchema as s, CASH_RECEIPT_METHODS as t, productCardFulfillmentSchema as tt, checkoutSessionSchema as u, paymentMessageSchema as v, paymentStatusSchema as w, paymentOptionListSchema as x, paymentMethodSchema as y, couponResultSchema as z };

package/dist/{client-ZPNEEeRT.mjs → client-CBAgQuTc.mjs}

@@ -1,5 +1,5 @@
 import { a as ANALYTICS_VISITOR_HEADER, r as ANALYTICS_SESSION_HEADER } from "./analytics-CgD70OqH.mjs";
-import { A as startPaymentRequestSchema, C as paymentStartSchema, F as checkoutPricingSchema, K as productCardFulfillmentSchema, N as applicableCouponSchema, O as retryPaymentRequestSchema, P as checkoutPricingRequestSchema, U as lineFulfillmentSchema, V as myCouponSchema, W as myOrderItemFulfillmentSnapshotSchema, d as createCheckoutRequestSchema, f as deliveryQuoteRequestSchema, m as easyPayProviderResponseSchema, p as deliveryQuoteSchema, q as productFulfillmentViewSchema, u as checkoutSessionSchema, w as paymentStatusSchema, y as paymentMethodSchema } from "./checkout-Dsv9C9Zp.mjs";
+import { $ as lineFulfillmentSchema, A as startPaymentRequestSchema, C as paymentStartSchema, F as checkoutPricingSchema, J as customInputViewSchema, N as applicableCouponSchema, O as retryPaymentRequestSchema, P as checkoutPricingRequestSchema, U as addonGroupViewSchema, V as myCouponSchema, X as lineSelectionResponseShape, Y as lineSelectionRequestShape, d as createCheckoutRequestSchema, et as myOrderItemFulfillmentSnapshotSchema, f as deliveryQuoteRequestSchema, m as easyPayProviderResponseSchema, nt as productFulfillmentViewSchema, p as deliveryQuoteSchema, tt as productCardFulfillmentSchema, u as checkoutSessionSchema, w as paymentStatusSchema, y as paymentMethodSchema } from "./checkout-C25liqdW.mjs";
 import { z } from "zod";
 //#region src/http.ts
 /** 표준 엔벨로프의 $.error 상세 */
@@ -243,6 +243,7 @@ const cartItemSchema = z.object({
 	thumbnailUrl: z.url().nullable().describe("담은 상품의 대표 이미지. 없으면 null"),
 	optionId: z.string().nullable(),
 	optionName: z.string().nullable(),
+	...lineSelectionResponseShape,
 	quantity: z.number().int(),
 	unitPrice: z.number().int(),
 	totalPrice: z.number().int(),
@@ -266,11 +267,14 @@ const cartSchema = z.object({
 const addCartItemRequestSchema = z.object({
 	productId: z.string(),
 	optionId: z.string().optional(),
-	quantity: z.number().int().min(1).max(999)
+	quantity: z.number().int().min(1).max(999),
+	...lineSelectionRequestShape
 });
 const updateCartItemRequestSchema = z.object({
 	quantity: z.number().int().min(1).max(999).optional(),
-	optionId: z.string().optional()
+	optionId: z.string().optional(),
+	addons: lineSelectionRequestShape.addons.describe("추가 선택을 통째로 바꾼다. 생략하면 그대로 둔다"),
+	customInputs: lineSelectionRequestShape.customInputs.describe("직접 입력값을 통째로 바꾼다. 생략하면 그대로 둔다")
 }).refine((value) => Object.values(value).some((v) => v !== void 0), { message: "최소 1개 필드가 필요합니다" });
 //#endregion
 //#region src/schemas/common.ts
@@ -347,6 +351,8 @@ const productDetailSchema = productCardSchema.extend({
 		additionalPrice: z.number().int(),
 		soldOut: z.boolean()
 	})),
+	addonGroups: z.array(addonGroupViewSchema).optional().default([]).describe("추가 선택 옵션명(이슈 #59). 배열 순서가 표시 순서다. 담기·바로 구매의 `addons`로 `{groupId, valueId}`를 보낸다. 없으면 빈 배열. 서버는 항상 싣는다"),
+	customInputs: z.array(customInputViewSchema).optional().default([]).describe("직접 입력 항목(이슈 #59). 배열 순서가 표시 순서다. 담기·바로 구매의 `customInputs`로 값을 보낸다. 없으면 빈 배열. 서버는 항상 싣는다"),
 	fulfillment: productFulfillmentViewSchema,
 	returnPeriodDays: z.number().int().describe("반품·교환을 받는 기간(수령·제공일부터 일수)"),
 	categoryPath: z.array(z.object({
@@ -601,33 +607,19 @@ const myOrderItemSchema = z.object({
 	productName: z.string(),
 	thumbnailUrl: z.url().nullable().describe("주문 시점의 대표 이미지. 없었으면 null"),
 	optionName: z.string().nullable(),
+	...lineSelectionResponseShape,
 	quantity: z.number().int().describe("주문 수량"),
 	canceledQuantity: z.number().int().describe("취소·반품으로 환불된 누적 수량. 부분 취소가 없었으면 0이다"),
 	activeQuantity: z.number().int().describe("남은 수량 (`quantity` − `canceledQuantity`). 취소·반품·교환 요청 수량의 상한이다"),
 	totalPrice: z.number().int().describe("주문상품 금액 (즉시할인 반영, 쿠폰 전)"),
 	couponDiscountAmount: z.number().int().optional().default(0).describe("이 주문상품에 배분된 쿠폰 할인. 실결제 금액은 `totalPrice − couponDiscountAmount`다. 쿠폰이 없으면 0. 서버는 항상 싣는다"),
 	status: orderItemStatusSchema,
-	fulfillmentSnapshot: myOrderItemFulfillmentSnapshotSchema.describe("주문 시점 이행 스냅샷(이슈 #57). `type`이 주문 시점 상품 유형이다. 배송 상품이 아니면 `DELIVERED`는 제공 완료(방문 수령은 수령 완료)다. 청약철회 제한 주문상품(`download`·`code`의 `withdrawalRestricted`)은 제공이 시작되면(다운로드·열람) 구매자 취소·반품을 받지 않는다"),
+	fulfillmentSnapshot: myOrderItemFulfillmentSnapshotSchema.describe("주문 시점 이행 스냅샷(이슈 #57). `type`이 주문 시점 상품 유형이다. 배송 없는 상품(`MANUAL`)이면 `DELIVERED`는 제공 완료다"),
 	fulfillment: z.object({
-		status: z.string().describe("제공 상태. `FULFILLED`(제공함)·`REVOKED`(환불 등으로 회수함). 값이 추가될 수 있어 문자열로 받는다"),
+		status: z.string().describe("제공 상태. `FULFILLED`(제공함)·`REVOKED`(전량 취소·환불로 회수함). 값이 추가될 수 있어 문자열로 받는다"),
 		fulfilledAt: z.string().describe("제공 시각 (ISO 8601)"),
-		note: z.string().nullable().describe("셀러가 남긴 이용 안내. 없으면 null"),
-		codes: z.array(z.object({
-			codeId: z.string(),
-			hint: z.string().describe("가린 코드 — 끝 4자만 보인다(예: `****AB12`)"),
-			revealedAt: z.string().nullable().describe("처음 열람한 시각. 열람 전이면 null")
-		})).optional().default([]).describe("코드 발급 상품의 코드(가린 값). 평문은 `fulfillment/reveal`로 연다. 환불로 회수된 코드는 싣지 않는다. 서버는 항상 싣는다"),
-		download: z.object({
-			count: z.number().int().describe("지금까지 받은 횟수"),
-			limit: z.number().int().describe("받을 수 있는 횟수"),
-			expiresAt: z.string().nullable().describe("받을 수 있는 기한 (ISO 8601)"),
-			files: z.array(z.object({
-				assetId: z.string(),
-				fileName: z.string(),
-				sizeBytes: z.number().int().nullable()
-			}))
-		}).nullable().optional().default(null).describe("파일 다운로드 상품의 횟수·기한·파일 목록. 파일 주소는 `downloads`로 받는다. 다른 유형은 null. 서버는 항상 싣는다")
-	}).nullable().optional().default(null).describe("비실물 상품(이용권·방문 수령 등)의 제공 정보(이슈 #48). 제공 전이거나 배송 상품이면 null이다. 비실물의 `DELIVERED`는 제공 완료(방문 수령은 수령 완료)로 표시한다. 서버는 항상 싣는다"),
+		note: z.string().nullable().describe("판매자가 제공 처리 때 남긴 이용 안내. 없으면 null")
+	}).nullable().optional().default(null).describe("배송 없는 상품의 제공 기록(이슈 #48). 제공 전이거나 배송 상품이면 null이다. 배송 없는 상품의 `DELIVERED`는 제공 완료로 표시한다. 서버는 항상 싣는다"),
 	claimStatus: z.string().nullable(),
 	reviewWritten: z.boolean(),
 	autoDecisionDate: z.string().nullable()
@@ -666,7 +658,6 @@ const myOrderSchema = z.object({
 		paidAt: z.string().nullable(),
 		receiptUrl: z.url().nullable()
 	}),
-	withdrawalAgreedAt: z.string().nullable().optional().default(null).describe("청약철회 제한 안내에 동의한 시각(이슈 #48). 제한 상품이 없던 주문은 null. 서버는 항상 싣는다"),
 	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 나가지 않았습니다 — 주문 화면에 테스트 결제 배지를 표시합니다")
 });
 /**
@@ -698,33 +689,6 @@ const purchaseDecisionResultSchema = z.object({
 	status: z.literal("PURCHASE_DECIDED"),
 	decidedAt: z.string()
 });
-/**
-* 코드 열람 응답 (이슈 #48) — `POST /storefront/v1/me/order-items/{orderItemId}/fulfillment/reveal`(회원)·
-* `POST /storefront/v1/guest/orders/{orderId}/order-items/{orderItemId}/fulfillment/reveal`(비회원).
-* 평문 코드는 이 응답에만 있다. 화면에 보인 뒤 저장하지 않는다(응답은 `Cache-Control: no-store`).
-* 첫 열람 시각은 청약철회 판단의 근거(제공 개시)로 남는다.
-*/
-const fulfillmentRevealSchema = z.object({
-	orderItemId: z.string(),
-	codes: z.array(z.object({
-		codeId: z.string(),
-		code: z.string().describe("코드 평문"),
-		revealedAt: z.string().describe("처음 열람한 시각")
-	}))
-});
-/**
-* 다운로드 요청 (이슈 #48) — `POST /storefront/v1/me/order-items/{orderItemId}/downloads`(회원)·
-* `POST /storefront/v1/guest/orders/{orderId}/order-items/{orderItemId}/downloads`(비회원, 연락처·비밀번호를 함께 보낸다).
-* 파일이 하나면 `assetId`를 생략할 수 있다.
-*/
-const downloadRequestSchema = z.object({ assetId: z.string().min(1).max(64).optional().describe("받을 파일. 파일이 여러 개면 필수다") });
-/** 다운로드 응답 — 수명 300초의 서명 주소. 받을 때마다 횟수가 하나 준다 */
-const downloadLinkSchema = z.object({
-	url: z.url().describe("서명 주소. 300초 뒤 만료된다 — 받아서 바로 쓰고 저장하지 않는다"),
-	expiresAt: z.string().describe("서명 주소 만료 시각"),
-	fileName: z.string(),
-	remaining: z.number().int().describe("남은 다운로드 횟수")
-});
 //#endregion
 //#region src/schemas/review.ts
 const publicReviewSchema = z.object({
@@ -948,27 +912,6 @@ get: () => http.request("GET", "/store", storefrontStoreSchema) },
 			*/
 			getGuestOrder: (orderId, body) => http.request("POST", path`/guest/orders/${orderId}`, myOrderSchema, { body }),
 			getDelivery: (orderItemId) => http.request("GET", path`/me/order-items/${orderItemId}/delivery`, deliveryTrackingSchema),
-			/**
-			* 코드 열람 (이슈 #48) — 코드 발급 상품의 평문 코드. 처음 열람한 시각이 제공 개시 증거로 남는다.
-			*
-			* 에러: 404 `ORDER_ITEM_NOT_FOUND`(없거나 남의 주문상품) · 404 `FULFILLMENT_NOT_FOUND`(제공 전·회수됨·코드 상품 아님) ·
-			* 429 `TOO_MANY_REQUESTS`
-			*/
-			revealCode: (orderItemId) => http.request("POST", path`/me/order-items/${orderItemId}/fulfillment/reveal`, fulfillmentRevealSchema),
-			/**
-			* 파일 다운로드 (이슈 #48) — 수명 300초의 서명 주소를 받는다. 받을 때마다 남은 횟수가 준다.
-			*
-			* 에러: 404 `FULFILLMENT_NOT_FOUND`(제공 전·회수됨·파일 상품 아님) · 409 `DOWNLOAD_LIMIT_REACHED`(횟수 소진) ·
-			* 409 `DOWNLOAD_EXPIRED`(기한 지남) · 400 `ASSET_REQUIRED`(파일이 여러 개인데 `assetId` 없음)
-			*/
-			createDownload: (orderItemId, body = {}) => http.request("POST", path`/me/order-items/${orderItemId}/downloads`, downloadLinkSchema, { body: downloadRequestSchema.parse(body) }),
-			/** 비회원 다운로드 — 비회원 주문 조회와 같은 연락처·주문 조회 비밀번호로 확인한다 */
-			createGuestDownload: (orderId, orderItemId, body) => http.request("POST", path`/guest/orders/${orderId}/order-items/${orderItemId}/downloads`, downloadLinkSchema, { body }),
-			/**
-			* 비회원 코드 열람 — 비회원 주문 조회와 같은 연락처·주문 조회 비밀번호로 확인하고 같은 시도 한도를 쓴다.
-			* 틀리면 구분 없이 404 `ORDER_NOT_FOUND`다.
-			*/
-			revealGuestCode: (orderId, orderItemId, body) => http.request("POST", path`/guest/orders/${orderId}/order-items/${orderItemId}/fulfillment/reveal`, fulfillmentRevealSchema, { body }),
 			decidePurchase: (orderItemId) => http.requestVoid("POST", path`/me/order-items/${orderItemId}/purchase-decision`)
 		},
 		myClaims: {
@@ -1010,4 +953,4 @@ get: () => http.request("GET", "/store", storefrontStoreSchema) },
 	};
 }
 //#endregion
-export { addCartItemRequestSchema as $, customerInquirySchema as A, createClaimRequestSchema as B, updateProfileRequestSchema as C, publicInquirySchema as D, createInquiryResultSchema as E, consentUpdateRequestSchema as F, productDetailSchema as G, myClaimSchema as H, memberConsentsSchema as I, productSortSchema as J, productFacetsSchema as K, claimReasonSchema as L, consentKindSchema as M, consentSourceSchema as N, createCustomerInquiryRequestSchema as O, consentStateSchema as P, pageSchema as Q, claimReturnAddressSchema as R, memberSchema as S, createInquiryRequestSchema as T, categoryNodeSchema as U, createClaimResultSchema as V, productCardSchema as W, orderItemStatusSchema as X, claimStatusSchema as Y, pageInfoSchema as Z, orderShippingAddressSchema as _, buildQuery as _t, publicReviewSchema as a, idpAuthorizeRequestSchema as at, memberAddressRequestSchema as b, updateReviewRequestSchema as c, linkIdentityRequestSchema as ct, deliveryTrackingSchema as d, signupRequestSchema as dt, cartItemSchema as et, downloadLinkSchema as f, socialProviderSchema as ft, myOrderSchema as g, ApiError as gt, myOrderItemSchema as h, withdrawalBlockedDetailsSchema as ht, createReviewResultSchema as i, idpAgreementsSchema as it, consentActionSchema as j, customerInquiryCategorySchema as k, updateReviewResultSchema as l, loginRequestSchema as lt, fulfillmentRevealSchema as m, withdrawRequestSchema as mt, storefrontStoreSchema as n, updateCartItemRequestSchema as nt, reviewPageSchema as o, idpAuthorizeResponseSchema as ot, downloadRequestSchema as p, tokenPairSchema as pt, productPageSchema as q, createReviewRequestSchema as r, anonymousSessionSchema as rt, reviewSummarySchema as s, idpTokenRequestSchema as st, createStorefrontClient as t, cartSchema as tt, writableReviewSchema as u, memberIdentitiesSchema as ut, purchaseDecisionResultSchema as v, toApiError as vt, wishlistAddResultSchema as w, memberAddressSchema as x, trackingStageResponseSchema as y, unwrapData as yt, claimTypeSchema as z };
+export { updateCartItemRequestSchema as $, consentSourceSchema as A, categoryNodeSchema as B, createInquiryResultSchema as C, customerInquirySchema as D, customerInquiryCategorySchema as E, claimReturnAddressSchema as F, productSortSchema as G, productDetailSchema as H, claimTypeSchema as I, pageInfoSchema as J, claimStatusSchema as K, createClaimRequestSchema as L, consentUpdateRequestSchema as M, memberConsentsSchema as N, consentActionSchema as O, claimReasonSchema as P, cartSchema as Q, createClaimResultSchema as R, createInquiryRequestSchema as S, createCustomerInquiryRequestSchema as T, productFacetsSchema as U, productCardSchema as V, productPageSchema as W, addCartItemRequestSchema as X, pageSchema as Y, cartItemSchema as Z, memberAddressRequestSchema as _, publicReviewSchema as a, linkIdentityRequestSchema as at, updateProfileRequestSchema as b, updateReviewRequestSchema as c, signupRequestSchema as ct, deliveryTrackingSchema as d, withdrawRequestSchema as dt, anonymousSessionSchema as et, myOrderItemSchema as f, withdrawalBlockedDetailsSchema as ft, trackingStageResponseSchema as g, unwrapData as gt, purchaseDecisionResultSchema as h, toApiError as ht, createReviewResultSchema as i, idpTokenRequestSchema as it, consentStateSchema as j, consentKindSchema as k, updateReviewResultSchema as l, socialProviderSchema as lt, orderShippingAddressSchema as m, buildQuery as mt, storefrontStoreSchema as n, idpAuthorizeRequestSchema as nt, reviewPageSchema as o, loginRequestSchema as ot, myOrderSchema as p, ApiError as pt, orderItemStatusSchema as q, createReviewRequestSchema as r, idpAuthorizeResponseSchema as rt, reviewSummarySchema as s, memberIdentitiesSchema as st, createStorefrontClient as t, idpAgreementsSchema as tt, writableReviewSchema as u, tokenPairSchema as ut, memberAddressSchema as v, publicInquirySchema as w, wishlistAddResultSchema as x, memberSchema as y, myClaimSchema as z };