@sayren/store-sdk 0.20.0 → 0.22.0

package/dist/index.mjs

@@ -1258,8 +1258,9 @@ const couponRejectReasonSchema = z.enum([
 	"NO_ELIGIBLE_ITEMS",
 	"MIN_ORDER_AMOUNT",
 	"LINE_NOT_ELIGIBLE",
+	"LINE_AMBIGUOUS",
 	"NO_DISCOUNT"
-]).describe("쿠폰을 적용하지 못한 사유. `DUPLICATE_COUPON`=같은 쿠폰을 두 번 넣음, `STACK_LIMIT`=같은 종류의 쿠폰이 이미 적용됨(주문 쿠폰·배송비 쿠폰은 주문당 1장, 상품 쿠폰은 주문상품 한 줄에 1장), `NOT_STARTED`=사용 기간 전, `EXPIRED`=사용 기간 지남, `MEMBER_ONLY`=회원 전용, `FIRST_ORDER_ONLY`=첫 구매 전용, `NO_ELIGIBLE_ITEMS`=대상 상품이 주문에 없음, `MIN_ORDER_AMOUNT`=최소 주문 금액 미달, `LINE_NOT_ELIGIBLE`=지정한 주문상품이 대상이 아니거나 이미 상품 쿠폰이 있음, `NO_DISCOUNT`=할인할 금액이 없음");
+]).describe("쿠폰을 적용하지 못한 사유. `DUPLICATE_COUPON`=같은 쿠폰을 두 번 넣음, `STACK_LIMIT`=같은 종류의 쿠폰이 이미 적용됨(주문 쿠폰·배송비 쿠폰은 주문당 1장, 상품 쿠폰은 주문상품 한 줄에 1장), `NOT_STARTED`=사용 기간 전, `EXPIRED`=사용 기간 지남, `MEMBER_ONLY`=회원 전용, `FIRST_ORDER_ONLY`=첫 구매 전용, `NO_ELIGIBLE_ITEMS`=대상 상품이 주문에 없음, `MIN_ORDER_AMOUNT`=최소 주문 금액 미달, `LINE_NOT_ELIGIBLE`=지정한 주문상품이 대상이 아니거나 이미 상품 쿠폰이 있음, `LINE_AMBIGUOUS`=지정한 `optionId`의 줄이 여럿이라 줄을 정할 수 없음(`lineId`로 지목한다), `NO_DISCOUNT`=할인할 금액이 없음");
 /** 쿠폰 적용 뒤 결제 금액의 하한 — 0원 결제 경로가 없어 이보다 작으면 결제를 시작하지 않는다(400 `PAYMENT_AMOUNT_TOO_LOW`) */
 const MIN_PAYMENT_AMOUNT = 100;
 /**
@@ -2887,6 +2888,496 @@ const paymentListQuerySchema = z.object({
 	size: z.string().optional().describe("페이지 크기 (기본 20, 최대 100)")
 });
 //#endregion
+//#region src/schemas/upload.ts
+/**
+* 업로드 용도. 허용 확장자와 크기 상한이 용도별로 다르다.
+*
+* - `product-image`: 상품 목록·상세의 상품 이미지. 목록 썸네일로 쓰이므로 정지 이미지만 받는다.
+* - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
+*/
+const uploadPurposeSchema = z.enum(["product-image", "description"]);
+const MB = 1048576;
+/**
+* 용도별 업로드 제한 — 서버(`POST /v1/uploads`)와 클라이언트가 공유하는 단일 원천이다.
+*
+* 크기는 **요청이 스스로 신고한 값**으로만 검사한다. 바이트는 api를 거치지 않고 CDN으로
+* 직접 PUT되므로 이 검사는 셀러가 올리기 전에 알게 하는 장치이고, 실제 상한은 CDN이 강제한다.
+*/
+const UPLOAD_PURPOSE_LIMITS = {
+	"product-image": {
+		extensions: [
+			"jpg",
+			"jpeg",
+			"png",
+			"webp",
+			"avif",
+			"gif"
+		],
+		maxBytes: 10 * MB
+	},
+	description: {
+		extensions: [
+			"jpg",
+			"jpeg",
+			"png",
+			"gif",
+			"webp",
+			"avif",
+			"svg",
+			"mp4",
+			"webm",
+			"mov"
+		],
+		maxBytes: 50 * MB
+	}
+};
+/** 파일명의 소문자 확장자. 확장자가 없으면 `""` */
+function uploadExtensionOf(filename) {
+	const dot = filename.lastIndexOf(".");
+	if (dot < 0 || dot === filename.length - 1) return "";
+	return filename.slice(dot + 1).toLowerCase();
+}
+/**
+* 용도 제한 위반 여부. 통과하면 `null`.
+* 서버가 던지는 오류와 콘솔이 먼저 띄우는 안내가 갈리지 않도록 한 함수로 판정한다.
+*/
+function uploadRejection(purpose, filename, size) {
+	const limit = UPLOAD_PURPOSE_LIMITS[purpose];
+	if (!limit.extensions.includes(uploadExtensionOf(filename))) return {
+		status: 400,
+		code: "UNSUPPORTED_FILE_TYPE",
+		message: `지원하지 않는 파일 형식입니다. ${limit.extensions.join(", ")}만 올릴 수 있습니다`
+	};
+	if (size !== void 0 && size > limit.maxBytes) return {
+		status: 413,
+		code: "FILE_TOO_LARGE",
+		message: `파일이 너무 큽니다. ${Math.floor(limit.maxBytes / MB)}MB까지 올릴 수 있습니다`
+	};
+	return null;
+}
+/**
+* 미디어 업로드 자리 발급 — `POST /v1/uploads`.
+*
+* 파일 바이트는 api를 거치지 않는다. 응답의 `uploadUrl`로 클라이언트가 직접 PUT하고,
+* 끝나면 `url`이 공개 주소가 된다. 서버가 객체 키를 정하므로 요청은 파일명만 보낸다
+* (확장자만 쓰이고 이름 자체는 저장되지 않는다).
+*/
+const uploadRequestSchema = z.object({
+	filename: z.string().min(1).max(255),
+	purpose: uploadPurposeSchema.default("description").describe("업로드 용도. 허용 확장자와 크기 상한이 용도별로 다르다"),
+	size: z.number().int().positive().optional().describe("파일 바이트 크기. 주면 용도별 상한을 발급 전에 검사한다")
+});
+const uploadTicketSchema = z.object({
+	/** 업로드 완료 후 공개될 주소 */
+	url: z.url(),
+	/** 파일 바이트를 PUT할 presigned URL. 1시간 유효 */
+	uploadUrl: z.url()
+});
+//#endregion
+//#region src/schemas/product.ts
+const productStatusSchema = z.enum([
+	"SALE",
+	"SUSPENDED",
+	"OUT_OF_STOCK",
+	"CLOSED"
+]);
+const productSummarySchema = z.object({
+	productId: z.string(),
+	name: z.string(),
+	status: productStatusSchema,
+	salePrice: z.number().int().describe("판매가. 원(KRW) 단위 정수"),
+	discountedPrice: z.number().int().nullable().describe("즉시 할인 적용가. 원 단위. 할인이 없으면 null"),
+	/** usable variant 재고 합계 (서버 계산) */
+	stockQuantity: z.number().int().describe("판매 가능한 옵션 재고의 합계. 서버가 계산한다"),
+	categoryId: z.string().nullable(),
+	thumbnailUrl: z.url().optional(),
+	/** optionGroups.length > 0 */
+	hasOptions: z.boolean(),
+	fulfillment: z.object({ type: fulfillmentTypeResponseSchema }).describe("상품 이행의 유형. 유형별 속성은 단건 조회(`GET /v1/products/{productId}`)의 `fulfillment`에 있다"),
+	updatedAt: z.string()
+});
+/** 옵션 축(그룹)이 가지는 값 하나 — 예: 축 "색상"의 값 "블랙" */
+const optionValueSchema = z.object({
+	valueId: z.string(),
+	name: z.string(),
+	sortOrder: z.number().int()
+});
+/** 옵션 축(그룹) — 예: "색상", "사이즈" */
+const optionGroupSchema = z.object({
+	groupId: z.string(),
+	name: z.string(),
+	sortOrder: z.number().int(),
+	values: z.array(optionValueSchema)
+});
+/**
+* 판매 단위(SKU). variantId는 기존 optionId 값 공간을 승계하므로
+* 카트·주문·리뷰·클레임의 optionId가 곧 variantId다.
+*/
+const productVariantSchema = z.object({
+	variantId: z.string(),
+	/** 축 sortOrder 순서와 1:1 대응. 옵션 없는 상품은 [] */
+	valueIds: z.array(z.string()),
+	/** 값 이름을 " / "로 이은 파생 표시명. 옵션 없으면 "" */
+	name: z.string(),
+	additionalPrice: z.number().int(),
+	stockQuantity: z.number().int(),
+	sku: z.string().nullable(),
+	barcode: z.string().nullable(),
+	costPrice: z.number().int().nullable(),
+	weightGram: z.number().int().nullable(),
+	sellerCode: z.string().nullable(),
+	usable: z.boolean(),
+	hasOrders: z.boolean().optional().describe("주문에 담긴 적이 있는 조합인가(이슈 #59). true인 조합은 옵션 교체에서 뺄 수 없고(409 `OPTION_HAS_ORDERS`) `usable: false`로 판매를 끈다. 서버는 항상 싣는다. 요청에는 쓰지 않는다")
+});
+/** 옵션 축(그룹) 최대 개수 — 스키마 상한의 단일 원천 */
+const MAX_OPTION_GROUPS = 3;
+/** 축 하나가 가질 수 있는 값의 최대 개수 */
+const MAX_VALUES_PER_GROUP = 100;
+/** 상품 하나가 가질 수 있는 variant(SKU) 최대 개수 */
+const MAX_VARIANTS = 500;
+/** 추가 선택 옵션명 최대 개수 */
+const MAX_ADDON_GROUPS = 5;
+/** 직접 입력 항목 최대 개수 */
+const MAX_CUSTOM_INPUTS = 5;
+/** 직접 입력 항목 최대 글자 수의 상한 */
+const MAX_CUSTOM_INPUT_LENGTH = 200;
+/** 조합 수가 이 값 이상이면 콘솔이 경고한다(상한은 `MAX_VARIANTS`) */
+const VARIANT_COUNT_WARNING = 100;
+/**
+* 옵션 값 정렬 순서 — 등록순·가나다순·낮은 추가금순·높은 추가금순. 서버가 저장할 때 이 순서로 값의 `sortOrder`를 매긴다.
+* 추가금순은 추가 선택 값이면 값의 추가금, 조합 값이면 그 값이 든 조합 추가금의 최솟값으로 비교하고 같으면 등록순이다.
+*/
+const optionSortSchema = z.enum([
+	"REGISTERED",
+	"NAME",
+	"PRICE_ASC",
+	"PRICE_DESC"
+]);
+/** 추가 선택 값 — 예: 옵션명 "선물 포장"의 값 "포장함"(+2,000원) */
+const addonValueSchema = z.object({
+	valueId: z.string(),
+	name: z.string(),
+	sortOrder: z.number().int(),
+	additionalPrice: z.number().int().describe("이 값을 고르면 단가에 더하는 금액(원, 0 이상)"),
+	usable: z.boolean().describe("사용 여부. false면 구매자에게 보이지 않고 고를 수 없다")
+});
+/** 추가 선택 옵션명 */
+const addonGroupSchema = z.object({
+	groupId: z.string(),
+	name: z.string(),
+	sortOrder: z.number().int(),
+	required: z.boolean().describe("구매자가 꼭 골라야 하는가. false면 고르지 않아도 된다"),
+	values: z.array(addonValueSchema)
+});
+/** 직접 입력 항목 — 예: 각인 문구 */
+const customInputSchema = z.object({
+	inputId: z.string(),
+	label: z.string().describe("항목명"),
+	placeholder: z.string().nullable().describe("입력 안내(구매자 입력 칸의 안내 문구). 없으면 null"),
+	maxLength: z.number().int().describe("최대 글자 수"),
+	required: z.boolean(),
+	usable: z.boolean().describe("사용 여부. false면 구매자에게 보이지 않는다"),
+	sortOrder: z.number().int()
+});
+/**
+* 직접 입력 항목명에 쓸 수 없는 개인정보성 단어 — 콘솔 검사와 서버 400(`CUSTOM_INPUT_LABEL_FORBIDDEN`)이 이 목록 하나를 쓴다.
+* 구매자 개인정보는 주문 정보로 받는다. 직접 입력 항목으로 받으면 보관·파기 규칙 밖에 남는다.
+*/
+const CUSTOM_INPUT_FORBIDDEN_WORDS = [
+	"연락처",
+	"전화",
+	"휴대폰",
+	"핸드폰",
+	"폰번호",
+	"메일",
+	"주소",
+	"주민",
+	"생년월일",
+	"생일",
+	"실명",
+	"계좌",
+	"카드번호",
+	"비밀번호",
+	"여권",
+	"통관",
+	"phone",
+	"mobile",
+	"mail",
+	"address"
+];
+/** 금지어 비교용 정규화 — NFKC(전각·호환 문자를 보통 문자로)·소문자 뒤 문자·숫자만 남긴다(공백·기호·제로폭 문자로 쪼갠 우회를 막는다) */
+function forbiddenWordKeyOf(text) {
+	return text.normalize("NFKC").toLowerCase().replace(/[^\p{L}\p{N}]/gu, "");
+}
+/**
+* 직접 입력 항목명·입력 안내에 든 개인정보성 금지어. 없으면 null. 공백·기호·대소문자·전각을 무시한다.
+* 서버는 항목명과 입력 안내 둘 다 이 함수로 검사한다(안내에 「연락처를 적어 주십시오」라고 쓰는 우회를 막는다).
+*/
+function customInputLabelForbiddenWord(label) {
+	const normalized = forbiddenWordKeyOf(label);
+	return CUSTOM_INPUT_FORBIDDEN_WORDS.find((word) => normalized.includes(forbiddenWordKeyOf(word))) ?? null;
+}
+/** 옵션명·값 이름 — 앞뒤 공백을 지우고 빈 값은 받지 않는다 */
+const optionNameSchema = z.string().trim().min(1).max(50);
+const addonValueRequestSchema = z.object({
+	/** 전달 시 기존 값 행을 유지(UPDATE). 생략하면 신규 발급 */
+	valueId: z.string().optional(),
+	name: optionNameSchema,
+	additionalPrice: z.number().int().min(0).default(0).describe("추가금(원, 0 이상)"),
+	usable: z.boolean().default(true)
+});
+const addonGroupRequestSchema = z.object({
+	/** 전달 시 기존 옵션명 행을 유지(UPDATE). 조합 옵션명의 id는 줄 수 없다(방식을 바꾸려면 새 옵션명으로 보낸다) */
+	groupId: z.string().optional(),
+	name: optionNameSchema,
+	required: z.boolean().default(false),
+	values: z.array(addonValueRequestSchema).min(1).max(100)
+});
+const customInputRequestSchema = z.object({
+	/** 전달 시 기존 항목 행을 유지(UPDATE). 생략하면 신규 발급 */
+	inputId: z.string().optional(),
+	label: z.string().trim().min(1).max(30),
+	placeholder: z.string().trim().max(100).nullish(),
+	maxLength: z.number().int().min(1).max(200),
+	required: z.boolean().default(false),
+	usable: z.boolean().default(true)
+});
+/**
+* 주문상품·장바구니·주문서 줄의 옵션 선택 스냅샷 한 칸 — 주문 시점 이름이다(상품을 고쳐도 바뀌지 않는다).
+* 조합 옵션은 옵션명마다 한 칸이고 추가금은 조합 단위라 0이다(조합 추가금은 단가에 들어 있다). 추가 선택은 값의 추가금이다.
+*/
+const optionSelectionSchema = z.object({
+	kind: z.string().describe("옵션명 방식. 현재 값은 `combination`·`addon`이고 값이 추가될 수 있어 문자열로 받는다"),
+	groupName: z.string(),
+	valueName: z.string(),
+	additionalPrice: z.number().int()
+});
+/** 구매자가 적은 직접 입력값 — 주문 시점 항목명과 값 */
+const customInputValueSchema = z.object({
+	label: z.string(),
+	value: z.string()
+});
+const discountSchema = z.object({
+	productId: z.string(),
+	discountType: z.enum(["RATE", "AMOUNT"]),
+	discountValue: z.number().int(),
+	discountedPrice: z.number().int(),
+	startAt: z.string().nullable(),
+	endAt: z.string().nullable()
+});
+const productSchema = productSummarySchema.extend({
+	description: z.string().optional(),
+	/**
+	* 상세설명 에디터(@avarlabs/editor)의 직렬화 상태. 재편집 때 이 값으로 문서를 복원한다.
+	* 표시는 `description`(HTML)이 맡는다 — 소비자는 이 필드를 몰라도 된다.
+	*/
+	descriptionJson: z.string().nullable().optional(),
+	originalPrice: z.number().int().nullable().optional(),
+	images: z.array(z.url()).optional(),
+	attributes: z.array(z.object({
+		attributeId: z.string(),
+		value: z.string()
+	})).optional(),
+	optionGroups: z.array(optionGroupSchema),
+	/** 모든 상품이 최소 1개 variant를 갖는다 (옵션 없으면 default variant 1개) */
+	variants: z.array(productVariantSchema),
+	addonGroups: z.array(addonGroupSchema).optional().default([]).describe("추가 선택 옵션명(이슈 #59). 없으면 빈 배열. 서버는 항상 싣는다"),
+	customInputs: z.array(customInputSchema).optional().default([]).describe("직접 입력 항목(이슈 #59). 사용하지 않는 항목도 싣는다. 없으면 빈 배열. 서버는 항상 싣는다"),
+	optionSort: optionSortSchema.optional().default("REGISTERED").describe("옵션 값 정렬 순서(이슈 #59). 서버는 항상 싣는다"),
+	fulfillment: productFulfillmentResponseSchema,
+	fulfillmentTypeLocked: z.boolean().describe("판매 이력(주문상품)이 있어 상품 유형(`fulfillment.type`)을 바꿀 수 없는가. true면 다른 유형으로 수정하는 요청이 409 `FULFILLMENT_TYPE_LOCKED`다. 같은 유형 안의 속성은 바꿀 수 있다"),
+	refundPolicy: productRefundPolicyPatchSchema.nullable().describe("상품별 환불 정책 덮어쓰기(상품이 정한 항목만). null이면 스토어 기본 환불 정책을 쓴다. 반품·교환 배송비(`returnDeliveryFee`·`exchangeDeliveryFee`)는 배송 상품에만 있다"),
+	/**
+	* 설정된 즉시할인. `GET /products/{productId}/discount`의 응답과 같은 형태다(이슈 #51).
+	* 할인이 없으면 null이다. 이 필드를 싣기 전 서버의 응답에는 없으므로 optional이다.
+	*/
+	discount: discountSchema.nullable().optional().describe("설정된 즉시할인. GET /v1/products/{productId}/discount 응답과 같은 형태다. 할인이 없으면 null"),
+	createdAt: z.string().optional()
+});
+/** 상품 하나에 등록할 수 있는 이미지 최대 장수 — 첫 장이 대표(썸네일)다 */
+const MAX_PRODUCT_IMAGES = 10;
+/**
+* 상품 이미지 주소의 와이어 형식 — URL이고 2048자 이하다.
+*
+* https·확장자 규칙은 여기서 강제하지 않고 `productImageRejection`이 판정한다. 서버가
+* **새로 추가된 주소에만** 그 규칙을 적용해야 하기 때문이다(규칙이 생기기 전에 저장된
+* 주소 하나로 상품 수정 전체가 막히면 셀러가 빠져나갈 길이 없다).
+*
+* 응답 스키마(`productSchema.images`)도 넓게 둔다. 과거에 저장된 주소를 파싱 오류로
+* 만들면 상품 조회 자체가 막힌다.
+*/
+const productImageUrlSchema = z.url().max(2048).describe("상품 이미지 주소. https만 허용하고, 확장자가 있으면 이미지 형식이어야 한다");
+/**
+* 상품에 **새로 붙이는** 이미지 주소의 규칙. 통과하면 `null`.
+*
+* - https만 받는다. http는 https 스토어프론트에서 혼합 콘텐츠로 차단되고 `data:`·`javascript:`는
+*   상세 화면에 박히는 주입 경로가 된다.
+* - 호스트는 제한하지 않는다 — 셀러가 이미 쓰는 이미지 호스트를 그대로 붙일 수 있어야 한다.
+* - 경로에 확장자가 있으면 상품 이미지 형식이어야 한다(svg·동영상 거부). **확장자가 없으면 통과시킨다**
+*   — 외부 이미지 CDN은 확장자 없는 키를 쓰는 경우가 흔하고, 주소만으로는 실제 형식을 알 수 없다.
+*/
+function productImageRejection(url) {
+	if (url.length > 2048) return {
+		code: "INVALID_IMAGE_URL",
+		message: "이미지 주소가 너무 깁니다"
+	};
+	let parsed;
+	try {
+		parsed = new URL(url);
+	} catch {
+		return {
+			code: "INVALID_IMAGE_URL",
+			message: "이미지 주소 형식이 아닙니다"
+		};
+	}
+	if (parsed.protocol !== "https:") return {
+		code: "INVALID_IMAGE_URL",
+		message: "이미지 주소는 https로 시작해야 합니다"
+	};
+	const extension = uploadExtensionOf(parsed.pathname);
+	const allowed = UPLOAD_PURPOSE_LIMITS["product-image"].extensions;
+	if (extension && !allowed.includes(extension)) return {
+		code: "UNSUPPORTED_FILE_TYPE",
+		message: `상품 이미지는 ${allowed.join(", ")}만 쓸 수 있습니다`
+	};
+	return null;
+}
+/**
+* 식별 코드 — 빈 문자열·공백만 있는 값은 거부한다.
+* `""`를 통과시키면 서버 중복 사전 검사(falsy skip)와 DB partial unique
+* (`WHERE ... is not null`)의 판정이 갈려 409 대신 500이 나간다.
+*/
+const codeSchema = z.string().trim().min(1).max(64);
+const optionValueRequestSchema = z.object({
+	/** 전달 시 기존 값 행을 유지(UPDATE). 생략하면 신규 발급 */
+	valueId: z.string().optional(),
+	name: z.string().min(1).max(50)
+});
+const optionGroupRequestSchema = z.object({
+	/** 전달 시 기존 축 행을 유지(UPDATE). 생략하면 신규 발급 */
+	groupId: z.string().optional(),
+	name: z.string().min(1).max(50),
+	values: z.array(optionValueRequestSchema).min(1).max(100)
+});
+const productVariantRequestSchema = z.object({
+	/** 기존 variant 유지 시 전달. 생략하면 신규 생성 */
+	variantId: z.string().optional(),
+	/** optionGroups 순서대로 각 축에서 고른 값 이름. 서버가 이름 → valueId를 해석한다 */
+	valueNames: z.array(z.string()).default([]),
+	additionalPrice: z.number().int().default(0),
+	/**
+	* 생략 = 기존 재고 유지 (신규 variant는 0).
+	* 구조 교체(PUT)가 폼 로드 시점의 재고를 되쓰지 않게 하는 옵트인 필드다 —
+	* 재고만 바꿀 때는 PATCH /products/{id}/variants/{variantId}/stock을 쓴다.
+	*/
+	stockQuantity: z.number().int().min(0).optional(),
+	sku: codeSchema.optional(),
+	barcode: codeSchema.optional(),
+	costPrice: z.number().int().min(0).optional(),
+	weightGram: z.number().int().min(0).optional(),
+	sellerCode: codeSchema.optional(),
+	usable: z.boolean().default(true)
+});
+/** 축 × 값 → variant 전체 교체 요청 (PUT /products/{productId}/options) */
+const optionModelRequestSchema = z.object({
+	optionGroups: z.array(optionGroupRequestSchema).max(3).default([]),
+	variants: z.array(productVariantRequestSchema).min(1).max(500),
+	addonGroups: z.array(addonGroupRequestSchema).max(5).optional().describe("추가 선택 옵션명 전체(이슈 #59). 주면 통째로 바꾸고, 생략하면 등록은 없음·수정은 현재 값을 그대로 둔다. 끄려면 빈 배열을 보낸다. 기능이 열리기 전에는 비어 있지 않은 값이 409 `OPTION_ADDONS_UNAVAILABLE`이다"),
+	customInputs: z.array(customInputRequestSchema).max(5).optional().describe("직접 입력 항목 전체(이슈 #59). 배열 순서가 표시 순서다. 주면 통째로 바꾸고, 생략하면 등록은 없음·수정은 현재 값을 그대로 둔다. 항목명에 개인정보성 단어(`CUSTOM_INPUT_FORBIDDEN_WORDS`)가 있으면 400 `CUSTOM_INPUT_LABEL_FORBIDDEN`, 기능이 열리기 전에는 비어 있지 않은 값이 409 `OPTION_ADDONS_UNAVAILABLE`이다"),
+	optionSort: optionSortSchema.optional().describe("옵션 값 정렬 순서(이슈 #59). 서버가 이 순서로 값의 `sortOrder`를 다시 매긴다. 생략하면 등록은 `REGISTERED`, 수정은 현재 값이다")
+});
+/** GET /products/{productId}/options 응답 */
+const optionModelSchema = z.object({
+	optionGroups: z.array(optionGroupSchema),
+	variants: z.array(productVariantSchema),
+	addonGroups: z.array(addonGroupSchema).optional().default([]).describe("추가 선택 옵션명(이슈 #59). 없으면 빈 배열. 서버는 항상 싣는다"),
+	customInputs: z.array(customInputSchema).optional().default([]).describe("직접 입력 항목(이슈 #59). 없으면 빈 배열. 서버는 항상 싣는다"),
+	optionSort: optionSortSchema.optional().default("REGISTERED").describe("옵션 값 정렬 순서(이슈 #59). 서버는 항상 싣는다")
+});
+/**
+* 재고 변경 택일 위반 문구 — SDK `.refine`과 서버 DomainException이 공유하는 단일 원천.
+* 경로에 따라 셀러가 다른 문구를 받지 않게 한다.
+*/
+const VARIANT_STOCK_EXCLUSIVE_MESSAGE = "stockQuantity 또는 adjustment 중 하나만 전달해야 합니다";
+/**
+* variant 재고 변경 요청 — 절대값(`stockQuantity`) 또는 증감(`adjustment`) 택일.
+* 서버도 같은 규칙을 400 VALIDATION_FAILED로 검증한다(이중 방어).
+*/
+const variantStockRequestSchema = z.object({
+	stockQuantity: z.number().int().min(0).optional(),
+	adjustment: z.number().int().optional()
+}).refine((v) => v.stockQuantity !== void 0 !== (v.adjustment !== void 0), { message: VARIANT_STOCK_EXCLUSIVE_MESSAGE });
+/** PATCH /products/{productId}/variants/{variantId}/stock 응답 */
+const variantStockSchema = z.object({
+	variantId: z.string(),
+	stockQuantity: z.number().int()
+});
+/**
+* 상품 쓰기 요청의 공통 필드 — 등록(POST)과 전체 수정(PUT)이 같다. 이행(`fulfillment`)만 두 요청의 스키마가 다르다.
+*
+* 최상위가 `strictObject`다. 모르는 필드는 400이다 — 이슈 #57 이전의 평면 필드(`deliveryFee`·`fulfillmentType`·`returnFee` 등)를
+* 보낸 요청이 조용히 무시되지 않게 한다. 옛 필드는 `fulfillment.{유형}.…`과 `refundPolicy`로 옮겼다.
+*/
+const productWriteShape = {
+	name: z.string().min(1).max(100),
+	categoryId: z.string().min(1, "카테고리를 선택해주십시오"),
+	salePrice: z.number().int().min(10).multipleOf(10, "판매가는 10원 단위여야 합니다 (INVALID_PRICE_UNIT)").describe("판매가. 원(KRW) 단위 정수, 최소 10원, 10원 단위"),
+	originalPrice: z.number().int().optional().describe("정가(할인 전 표시 가격). 원 단위"),
+	description: z.string().optional(),
+	/**
+	* 상세설명 에디터(@avarlabs/editor)의 직렬화 상태. 재편집 때 이 값으로 문서를 복원한다.
+	* 표시는 `description`(HTML)이 맡는다 — 소비자는 이 필드를 몰라도 된다.
+	*/
+	descriptionJson: z.string().nullable().optional(),
+	images: z.array(productImageUrlSchema).min(1).max(10).optional().describe("상품 이미지 주소 목록. 첫 장이 대표 이미지(썸네일)다"),
+	attributes: z.array(z.object({
+		attributeId: z.string(),
+		value: z.string()
+	})).optional(),
+	refundPolicy: productRefundPolicyPatchSchema.nullish().describe("상품별 환불 정책 — 준 항목만 스토어 기본을 덮어쓴다. `null`이나 생략은 스토어 기본을 그대로 쓴다는 뜻이다. 반품·교환 배송비(`returnDeliveryFee`·`exchangeDeliveryFee`)는 배송 상품에만 줄 수 있다(다른 유형은 400)"),
+	...optionModelRequestSchema.shape,
+	sourceOptionSetIds: z.array(z.string()).max(10).optional().describe("쓰기 전용(이슈 #59) — 이 저장으로 옵션을 불러온 저장 옵션 id. 상품 저장과 같은 트랜잭션에서 불러오기 기록을 남겨 저장 옵션의 `importedProductCount`를 센다. 없는 id는 무시한다")
+};
+const productCreateRequestSchema = z.strictObject({
+	...productWriteShape,
+	fulfillment: productFulfillmentCreateSchema.optional().describe("상품 이행. `type`이 유형이고 같은 이름의 키가 유형별 속성이다. 생략하면 배송 상품(기본값)이다. 배송 상품이 아닌 유형은 판매가 열린 유형만 등록할 수 있다(409 `FULFILLMENT_TYPE_NOT_AVAILABLE`)")
+});
+const fulfillmentUpdateDescription = "상품 이행. 생략하면 바꾸지 않는다. 주면 유형 안 필드를 모두 담아 통째로 바꾼다(현재 값과 병합하지 않는다). 판매 이력이 있으면 유형을 바꿀 수 없다(409 `FULFILLMENT_TYPE_LOCKED`)";
+/** 전체 수정(PUT) — 공통 필드는 등록과 같고, 이행은 생략하면 현재 값 유지, 주면 필드가 모두 필수다 */
+const productReplaceRequestSchema = z.strictObject({
+	...productWriteShape,
+	fulfillment: productFulfillmentUpdateSchema.optional().describe(fulfillmentUpdateDescription)
+});
+const productPatchRequestSchema = z.strictObject({
+	name: z.string().max(100).optional(),
+	salePrice: z.number().int().multipleOf(10).optional(),
+	status: productStatusSchema.optional(),
+	fulfillment: productFulfillmentUpdateSchema.optional().describe(fulfillmentUpdateDescription),
+	refundPolicy: productRefundPolicyPatchSchema.nullable().optional().describe("상품별 환불 정책. 주면 통째로 바꾼다(준 항목만 스토어 기본을 덮어쓴다). `null`은 덮어쓰기를 지워 스토어 기본을 따른다. 생략하면 바꾸지 않는다")
+}).refine((value) => Object.values(value).some((v) => v !== void 0), { message: "최소 1개 필드가 필요합니다" });
+const productSortSchema = z.enum([
+	"createdAt.desc",
+	"createdAt.asc",
+	"salePrice.asc",
+	"salePrice.desc",
+	"updatedAt.desc"
+]);
+/** `GET /v1/products` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
+const productListQuerySchema = z.object({
+	status: productStatusSchema.optional().describe("판매 상태 필터"),
+	categoryId: z.string().optional().describe("카테고리 필터 — 하위 카테고리의 상품도 포함"),
+	keyword: z.string().optional().describe("상품명 검색 (포함)"),
+	sellerCode: z.string().optional().describe("판매자 상품코드 — 이 코드가 붙은 variant를 가진 상품"),
+	sort: productSortSchema.optional().describe("정렬 (기본 createdAt.desc)"),
+	...pageQueryShape()
+});
+const discountRequestSchema = z.object({
+	discountType: z.enum(["RATE", "AMOUNT"]),
+	discountValue: z.number().int().min(1),
+	startAt: z.string().optional(),
+	endAt: z.string().optional()
+});
+//#endregion
 //#region src/schemas/order.ts
 const orderSummarySchema = z.object({
 	orderId: z.string(),
@@ -2926,6 +3417,8 @@ const orderItemSchema = z.object({
 	productName: z.string(),
 	optionId: z.string().nullable(),
 	optionName: z.string().nullable(),
+	optionSelections: z.array(optionSelectionSchema).optional().default([]).describe("주문 시점 옵션 선택(이슈 #59) — 조합 옵션(옵션명마다 한 칸, 추가금 0)과 추가 선택(값의 추가금). 옵션이 없거나 이 필드 이전 주문은 빈 배열. 서버는 항상 싣는다"),
+	customInputs: z.array(customInputValueSchema).optional().default([]).describe("구매자가 적은 직접 입력값(주문 시점 항목명과 값, 이슈 #59). 없으면 빈 배열. 서버는 항상 싣는다"),
 	sellerCode: z.string().nullable(),
 	fulfillmentSnapshot: orderItemFulfillmentSnapshotResponseSchema.describe("주문 시점 이행 스냅샷(이슈 #57). `type`이 주문 시점 상품 유형이다. 배송 상품이 아니면 발송·배송완료 대신 제공 처리를 하고, `DELIVERED`는 제공 완료다. 상품을 나중에 고쳐도 바뀌지 않는다. 제공 기록은 `fulfillment`에 있다"),
 	quantity: z.number().int().describe("주문 수량"),
@@ -3115,397 +3608,145 @@ const fulfillRequestSchema = z.object({ note: z.string().trim().max(1e3).optiona
 /** 제공 처리 일괄 요청 — `POST /v1/order-items/fulfill` */
 const fulfillBulkRequestSchema = z.object({
 	orderItemIds: z.array(z.string()).min(1).max(100),
-	note: fulfillRequestSchema.shape.note
-});
-/** `POST /v1/order-items/{orderItemId}/cancel` 응답 — 셀러 직권취소 환불 결과 */
-const cancelBySellerResultSchema = z.object({
-	orderItemId: z.string(),
-	refundAmount: z.number().int().describe("실제 환불한 금액 — 수량 비율 상품 실결제 금액(쿠폰 배분을 뺀 금액) + 배송비 환불 − 조건부 무료배송 미달 차감 + 되돌린 쿠폰 차감(`couponChargeRefundAmount`)"),
-	quantity: z.number().int().describe("취소한 수량"),
-	canceledQuantity: z.number().int().describe("취소 후 누적 취소 수량"),
-	deliveryFeeRefundAmount: z.number().int().describe("환불에 포함된 배송비. 배송 묶음(같은 상품)이 모두 취소됐고 환불 정책이 켜져 있을 때만 0보다 크다"),
-	deliveryFeeChargeAmount: z.number().int().describe("조건부 무료배송 기준 미달로 환불액에서 뺀 배송비. 정책이 꺼져 있으면 항상 0이다"),
-	couponChargeAmount: z.number().int().optional().default(0).describe("쿠폰 조건 미달 차감. 판매자 취소는 차감하지 않으므로 늘 0이다. 서버는 항상 싣는다"),
-	couponChargeRefundAmount: z.number().int().optional().default(0).describe("환불액에 더한, 앞선 환불에서 뺀 쿠폰 차감을 되돌린 몫. 서버는 항상 싣는다"),
-	refundedAt: z.string()
-});
-/** `PUT /v1/order-items/{orderItemId}/memo` 응답 — 빈 문자열로 저장하면 메모가 지워져 `null`이다 */
-const orderItemMemoResultSchema = z.object({
-	orderItemId: z.string(),
-	sellerMemo: z.string().nullable()
-});
-/** `POST /v1/order-items/{orderItemId}/purchase-decision/request` 응답 */
-const purchaseDecisionRequestResultSchema = z.object({
-	orderItemId: z.string(),
-	requestedAt: z.string()
-});
-/** `POST /v1/order-items/{orderItemId}/purchase-decision/extend` 응답 — 연장은 최대 2회 */
-const purchaseDecisionExtendResultSchema = z.object({
-	orderItemId: z.string(),
-	autoDecisionDate: z.string(),
-	extendCount: z.number().int().max(2)
-});
-/**
-* `GET /v1/orders/{orderId}/address-change-requests` 응답 — 배송지 변경 요청 플로우는 아직 제공하지 않아
-* 현재는 항상 빈 배열이다
-*/
-const addressChangeRequestListSchema = z.array(z.record(z.string(), z.unknown())).describe("배송지 변경 요청 목록 (현재 항상 빈 배열)");
-//#endregion
-//#region src/schemas/upload.ts
-/**
-* 업로드 용도. 허용 확장자와 크기 상한이 용도별로 다르다.
-*
-* - `product-image`: 상품 목록·상세의 상품 이미지. 목록 썸네일로 쓰이므로 정지 이미지만 받는다.
-* - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
-*/
-const uploadPurposeSchema = z.enum(["product-image", "description"]);
-const MB = 1048576;
-/**
-* 용도별 업로드 제한 — 서버(`POST /v1/uploads`)와 클라이언트가 공유하는 단일 원천이다.
-*
-* 크기는 **요청이 스스로 신고한 값**으로만 검사한다. 바이트는 api를 거치지 않고 CDN으로
-* 직접 PUT되므로 이 검사는 셀러가 올리기 전에 알게 하는 장치이고, 실제 상한은 CDN이 강제한다.
-*/
-const UPLOAD_PURPOSE_LIMITS = {
-	"product-image": {
-		extensions: [
-			"jpg",
-			"jpeg",
-			"png",
-			"webp",
-			"avif",
-			"gif"
-		],
-		maxBytes: 10 * MB
-	},
-	description: {
-		extensions: [
-			"jpg",
-			"jpeg",
-			"png",
-			"gif",
-			"webp",
-			"avif",
-			"svg",
-			"mp4",
-			"webm",
-			"mov"
-		],
-		maxBytes: 50 * MB
-	}
-};
-/** 파일명의 소문자 확장자. 확장자가 없으면 `""` */
-function uploadExtensionOf(filename) {
-	const dot = filename.lastIndexOf(".");
-	if (dot < 0 || dot === filename.length - 1) return "";
-	return filename.slice(dot + 1).toLowerCase();
-}
-/**
-* 용도 제한 위반 여부. 통과하면 `null`.
-* 서버가 던지는 오류와 콘솔이 먼저 띄우는 안내가 갈리지 않도록 한 함수로 판정한다.
-*/
-function uploadRejection(purpose, filename, size) {
-	const limit = UPLOAD_PURPOSE_LIMITS[purpose];
-	if (!limit.extensions.includes(uploadExtensionOf(filename))) return {
-		status: 400,
-		code: "UNSUPPORTED_FILE_TYPE",
-		message: `지원하지 않는 파일 형식입니다. ${limit.extensions.join(", ")}만 올릴 수 있습니다`
-	};
-	if (size !== void 0 && size > limit.maxBytes) return {
-		status: 413,
-		code: "FILE_TOO_LARGE",
-		message: `파일이 너무 큽니다. ${Math.floor(limit.maxBytes / MB)}MB까지 올릴 수 있습니다`
-	};
-	return null;
-}
-/**
-* 미디어 업로드 자리 발급 — `POST /v1/uploads`.
-*
-* 파일 바이트는 api를 거치지 않는다. 응답의 `uploadUrl`로 클라이언트가 직접 PUT하고,
-* 끝나면 `url`이 공개 주소가 된다. 서버가 객체 키를 정하므로 요청은 파일명만 보낸다
-* (확장자만 쓰이고 이름 자체는 저장되지 않는다).
-*/
-const uploadRequestSchema = z.object({
-	filename: z.string().min(1).max(255),
-	purpose: uploadPurposeSchema.default("description").describe("업로드 용도. 허용 확장자와 크기 상한이 용도별로 다르다"),
-	size: z.number().int().positive().optional().describe("파일 바이트 크기. 주면 용도별 상한을 발급 전에 검사한다")
-});
-const uploadTicketSchema = z.object({
-	/** 업로드 완료 후 공개될 주소 */
-	url: z.url(),
-	/** 파일 바이트를 PUT할 presigned URL. 1시간 유효 */
-	uploadUrl: z.url()
-});
-//#endregion
-//#region src/schemas/product.ts
-const productStatusSchema = z.enum([
-	"SALE",
-	"SUSPENDED",
-	"OUT_OF_STOCK",
-	"CLOSED"
-]);
-const productSummarySchema = z.object({
-	productId: z.string(),
-	name: z.string(),
-	status: productStatusSchema,
-	salePrice: z.number().int().describe("판매가. 원(KRW) 단위 정수"),
-	discountedPrice: z.number().int().nullable().describe("즉시 할인 적용가. 원 단위. 할인이 없으면 null"),
-	/** usable variant 재고 합계 (서버 계산) */
-	stockQuantity: z.number().int().describe("판매 가능한 옵션 재고의 합계. 서버가 계산한다"),
-	categoryId: z.string().nullable(),
-	thumbnailUrl: z.url().optional(),
-	/** optionGroups.length > 0 */
-	hasOptions: z.boolean(),
-	fulfillment: z.object({ type: fulfillmentTypeResponseSchema }).describe("상품 이행의 유형. 유형별 속성은 단건 조회(`GET /v1/products/{productId}`)의 `fulfillment`에 있다"),
-	updatedAt: z.string()
-});
-/** 옵션 축(그룹)이 가지는 값 하나 — 예: 축 "색상"의 값 "블랙" */
-const optionValueSchema = z.object({
-	valueId: z.string(),
-	name: z.string(),
-	sortOrder: z.number().int()
-});
-/** 옵션 축(그룹) — 예: "색상", "사이즈" */
-const optionGroupSchema = z.object({
-	groupId: z.string(),
-	name: z.string(),
-	sortOrder: z.number().int(),
-	values: z.array(optionValueSchema)
-});
-/**
-* 판매 단위(SKU). variantId는 기존 optionId 값 공간을 승계하므로
-* 카트·주문·리뷰·클레임의 optionId가 곧 variantId다.
-*/
-const productVariantSchema = z.object({
-	variantId: z.string(),
-	/** 축 sortOrder 순서와 1:1 대응. 옵션 없는 상품은 [] */
-	valueIds: z.array(z.string()),
-	/** 값 이름을 " / "로 이은 파생 표시명. 옵션 없으면 "" */
-	name: z.string(),
-	additionalPrice: z.number().int(),
-	stockQuantity: z.number().int(),
-	sku: z.string().nullable(),
-	barcode: z.string().nullable(),
-	costPrice: z.number().int().nullable(),
-	weightGram: z.number().int().nullable(),
-	sellerCode: z.string().nullable(),
-	usable: z.boolean()
-});
-const discountSchema = z.object({
-	productId: z.string(),
-	discountType: z.enum(["RATE", "AMOUNT"]),
-	discountValue: z.number().int(),
-	discountedPrice: z.number().int(),
-	startAt: z.string().nullable(),
-	endAt: z.string().nullable()
-});
-const productSchema = productSummarySchema.extend({
-	description: z.string().optional(),
-	/**
-	* 상세설명 에디터(@avarlabs/editor)의 직렬화 상태. 재편집 때 이 값으로 문서를 복원한다.
-	* 표시는 `description`(HTML)이 맡는다 — 소비자는 이 필드를 몰라도 된다.
-	*/
-	descriptionJson: z.string().nullable().optional(),
-	originalPrice: z.number().int().nullable().optional(),
-	images: z.array(z.url()).optional(),
-	attributes: z.array(z.object({
-		attributeId: z.string(),
-		value: z.string()
-	})).optional(),
-	optionGroups: z.array(optionGroupSchema),
-	/** 모든 상품이 최소 1개 variant를 갖는다 (옵션 없으면 default variant 1개) */
-	variants: z.array(productVariantSchema),
-	fulfillment: productFulfillmentResponseSchema,
-	fulfillmentTypeLocked: z.boolean().describe("판매 이력(주문상품)이 있어 상품 유형(`fulfillment.type`)을 바꿀 수 없는가. true면 다른 유형으로 수정하는 요청이 409 `FULFILLMENT_TYPE_LOCKED`다. 같은 유형 안의 속성은 바꿀 수 있다"),
-	refundPolicy: productRefundPolicyPatchSchema.nullable().describe("상품별 환불 정책 덮어쓰기(상품이 정한 항목만). null이면 스토어 기본 환불 정책을 쓴다. 반품·교환 배송비(`returnDeliveryFee`·`exchangeDeliveryFee`)는 배송 상품에만 있다"),
-	/**
-	* 설정된 즉시할인. `GET /products/{productId}/discount`의 응답과 같은 형태다(이슈 #51).
-	* 할인이 없으면 null이다. 이 필드를 싣기 전 서버의 응답에는 없으므로 optional이다.
-	*/
-	discount: discountSchema.nullable().optional().describe("설정된 즉시할인. GET /v1/products/{productId}/discount 응답과 같은 형태다. 할인이 없으면 null"),
-	createdAt: z.string().optional()
+	note: fulfillRequestSchema.shape.note
+});
+/** `POST /v1/order-items/{orderItemId}/cancel` 응답 — 셀러 직권취소 환불 결과 */
+const cancelBySellerResultSchema = z.object({
+	orderItemId: z.string(),
+	refundAmount: z.number().int().describe("실제 환불한 금액 — 수량 비율 상품 실결제 금액(쿠폰 배분을 뺀 금액) + 배송비 환불 − 조건부 무료배송 미달 차감 + 되돌린 쿠폰 차감(`couponChargeRefundAmount`)"),
+	quantity: z.number().int().describe("취소한 수량"),
+	canceledQuantity: z.number().int().describe("취소 후 누적 취소 수량"),
+	deliveryFeeRefundAmount: z.number().int().describe("환불에 포함된 배송비. 배송 묶음(같은 상품)이 모두 취소됐고 환불 정책이 켜져 있을 때만 0보다 크다"),
+	deliveryFeeChargeAmount: z.number().int().describe("조건부 무료배송 기준 미달로 환불액에서 뺀 배송비. 정책이 꺼져 있으면 항상 0이다"),
+	couponChargeAmount: z.number().int().optional().default(0).describe("쿠폰 조건 미달 차감. 판매자 취소는 차감하지 않으므로 늘 0이다. 서버는 항상 싣는다"),
+	couponChargeRefundAmount: z.number().int().optional().default(0).describe("환불액에 더한, 앞선 환불에서 뺀 쿠폰 차감을 되돌린 몫. 서버는 항상 싣는다"),
+	refundedAt: z.string()
+});
+/** `PUT /v1/order-items/{orderItemId}/memo` 응답 — 빈 문자열로 저장하면 메모가 지워져 `null`이다 */
+const orderItemMemoResultSchema = z.object({
+	orderItemId: z.string(),
+	sellerMemo: z.string().nullable()
+});
+/** `POST /v1/order-items/{orderItemId}/purchase-decision/request` 응답 */
+const purchaseDecisionRequestResultSchema = z.object({
+	orderItemId: z.string(),
+	requestedAt: z.string()
+});
+/** `POST /v1/order-items/{orderItemId}/purchase-decision/extend` 응답 — 연장은 최대 2회 */
+const purchaseDecisionExtendResultSchema = z.object({
+	orderItemId: z.string(),
+	autoDecisionDate: z.string(),
+	extendCount: z.number().int().max(2)
 });
-/** 상품 하나에 등록할 수 있는 이미지 최대 장수 — 첫 장이 대표(썸네일)다 */
-const MAX_PRODUCT_IMAGES = 10;
 /**
-* 상품 이미지 주소의 와이어 형식 — URL이고 2048자 이하다.
-*
-* https·확장자 규칙은 여기서 강제하지 않고 `productImageRejection`이 판정한다. 서버가
-* **새로 추가된 주소에만** 그 규칙을 적용해야 하기 때문이다(규칙이 생기기 전에 저장된
-* 주소 하나로 상품 수정 전체가 막히면 셀러가 빠져나갈 길이 없다).
-*
-* 응답 스키마(`productSchema.images`)도 넓게 둔다. 과거에 저장된 주소를 파싱 오류로
-* 만들면 상품 조회 자체가 막힌다.
+* `GET /v1/orders/{orderId}/address-change-requests` 응답 — 배송지 변경 요청 플로우는 아직 제공하지 않아
+* 현재는 항상 빈 배열이다
 */
-const productImageUrlSchema = z.url().max(2048).describe("상품 이미지 주소. https만 허용하고, 확장자가 있으면 이미지 형식이어야 한다");
+const addressChangeRequestListSchema = z.array(z.record(z.string(), z.unknown())).describe("배송지 변경 요청 목록 (현재 항상 빈 배열)");
+//#endregion
+//#region src/schemas/saved-option-set.ts
 /**
-* 상품에 **새로 붙이는** 이미지 주소의 규칙. 통과하면 `null`.
+* 저장 옵션 (이슈 #59) — 자주 쓰는 옵션 구성을 이름 붙여 두고 상품 등록에서 불러온다.
 *
-* - https만 받는다. http는 https 스토어프론트에서 혼합 콘텐츠로 차단되고 `data:`·`javascript:`는
-*   상세 화면에 박히는 주입 경로가 된다.
-* - 호스트는 제한하지 않는다 — 셀러가 이미 쓰는 이미지 호스트를 그대로 붙일 수 있어야 한다.
-* - 경로에 확장자가 있으면 상품 이미지 형식이어야 한다(svg·동영상 거부). **확장자가 없으면 통과시킨다**
-*   — 외부 이미지 CDN은 확장자 없는 키를 쓰는 경우가 흔하고, 주소만으로는 실제 형식을 알 수 없다.
-*/
-function productImageRejection(url) {
-	if (url.length > 2048) return {
-		code: "INVALID_IMAGE_URL",
-		message: "이미지 주소가 너무 깁니다"
-	};
-	let parsed;
-	try {
-		parsed = new URL(url);
-	} catch {
-		return {
-			code: "INVALID_IMAGE_URL",
-			message: "이미지 주소 형식이 아닙니다"
-		};
-	}
-	if (parsed.protocol !== "https:") return {
-		code: "INVALID_IMAGE_URL",
-		message: "이미지 주소는 https로 시작해야 합니다"
-	};
-	const extension = uploadExtensionOf(parsed.pathname);
-	const allowed = UPLOAD_PURPOSE_LIMITS["product-image"].extensions;
-	if (extension && !allowed.includes(extension)) return {
-		code: "UNSUPPORTED_FILE_TYPE",
-		message: `상품 이미지는 ${allowed.join(", ")}만 쓸 수 있습니다`
-	};
-	return null;
-}
-/** 옵션 축(그룹) 최대 개수 — 스키마 상한의 단일 원천 */
-const MAX_OPTION_GROUPS = 3;
-/** 축 하나가 가질 수 있는 값의 최대 개수 */
-const MAX_VALUES_PER_GROUP = 100;
-/** 상품 하나가 가질 수 있는 variant(SKU) 최대 개수 */
-const MAX_VARIANTS = 500;
-/**
-* 식별 코드 — 빈 문자열·공백만 있는 값은 거부한다.
-* `""`를 통과시키면 서버 중복 사전 검사(falsy skip)와 DB partial unique
-* (`WHERE ... is not null`)의 판정이 갈려 409 대신 500이 나간다.
+* **불러오기는 복사다.** 저장 옵션을 고치거나 지워도 이미 불러온 상품의 옵션은 그대로다. 재고·SKU·사용 여부는 상품마다
+* 달라 저장하지 않는다. 추가금은 조합별이 아니라 **값별**로 둔다 — 조합 옵션으로 불러오면 조합 추가금은 고른 값 추가금의 합이다.
 */
-const codeSchema = z.string().trim().min(1).max(64);
-const optionValueRequestSchema = z.object({
-	/** 전달 시 기존 값 행을 유지(UPDATE). 생략하면 신규 발급 */
-	valueId: z.string().optional(),
-	name: z.string().min(1).max(50)
+/** 스토어당 저장 옵션 최대 개수 */
+const MAX_SAVED_OPTION_SETS = 200;
+/** 저장 옵션 이름 최대 글자 수 */
+const MAX_SAVED_OPTION_SET_NAME = 50;
+/** 옵션명 방식 — `combination`(조합: 값의 조합이 판매 단위가 된다)·`addon`(추가 선택: 재고 없이 추가금만) */
+const optionGroupKindSchema = z.enum(["combination", "addon"]);
+const nameSchema = z.string().trim().min(1).max(50);
+const savedOptionValueSchema = z.object({
+	name: z.string(),
+	additionalPrice: z.number().int().describe("값별 추가금(원, 0 이상)")
 });
-const optionGroupRequestSchema = z.object({
-	/** 전달 시 기존 축 행을 유지(UPDATE). 생략하면 신규 발급 */
-	groupId: z.string().optional(),
-	name: z.string().min(1).max(50),
-	values: z.array(optionValueRequestSchema).min(1).max(100)
+const savedOptionGroupSchema = z.object({
+	name: z.string(),
+	kind: z.string().describe("옵션명 방식. 현재 값은 `combination`·`addon`이고 값이 추가될 수 있어 문자열로 받는다"),
+	required: z.boolean().describe("추가 선택을 구매자가 꼭 고르는가. 조합 옵션명은 항상 false다"),
+	values: z.array(savedOptionValueSchema)
+});
+const savedCustomInputSchema = z.object({
+	label: z.string(),
+	placeholder: z.string().nullable(),
+	maxLength: z.number().int(),
+	required: z.boolean()
+});
+const savedOptionSetSchema = z.object({
+	optionSetId: z.string(),
+	name: z.string(),
+	optionSort: optionSortSchema,
+	groups: z.array(savedOptionGroupSchema).describe("옵션명. 배열 순서가 입력 순서다"),
+	customInputs: z.array(savedCustomInputSchema),
+	importedProductCount: z.number().int().describe("이 저장 옵션을 불러온 상품 수(중복 없이, 지운 상품 제외). 불러오기 기록으로 센다"),
+	createdAt: z.string(),
+	updatedAt: z.string()
 });
-const productVariantRequestSchema = z.object({
-	/** 기존 variant 유지 시 전달. 생략하면 신규 생성 */
-	variantId: z.string().optional(),
-	/** optionGroups 순서대로 각 축에서 고른 값 이름. 서버가 이름 → valueId를 해석한다 */
-	valueNames: z.array(z.string()).default([]),
-	additionalPrice: z.number().int().default(0),
-	/**
-	* 생략 = 기존 재고 유지 (신규 variant는 0).
-	* 구조 교체(PUT)가 폼 로드 시점의 재고를 되쓰지 않게 하는 옵트인 필드다 —
-	* 재고만 바꿀 때는 PATCH /products/{id}/variants/{variantId}/stock을 쓴다.
-	*/
-	stockQuantity: z.number().int().min(0).optional(),
-	sku: codeSchema.optional(),
-	barcode: codeSchema.optional(),
-	costPrice: z.number().int().min(0).optional(),
-	weightGram: z.number().int().min(0).optional(),
-	sellerCode: codeSchema.optional(),
-	usable: z.boolean().default(true)
+const savedOptionValueRequestSchema = z.object({
+	name: nameSchema,
+	additionalPrice: z.number().int().min(0).default(0)
 });
-/** 축 × 값 → variant 전체 교체 요청 (PUT /products/{productId}/options) */
-const optionModelRequestSchema = z.object({
-	optionGroups: z.array(optionGroupRequestSchema).max(3).default([]),
-	variants: z.array(productVariantRequestSchema).min(1).max(500)
+const savedOptionGroupRequestSchema = z.object({
+	name: nameSchema,
+	kind: optionGroupKindSchema,
+	required: z.boolean().default(false).describe("추가 선택만 쓴다. 조합 옵션명에 true를 주면 400이다"),
+	values: z.array(savedOptionValueRequestSchema).min(1).max(100)
 });
-/** GET /products/{productId}/options 응답 */
-const optionModelSchema = z.object({
-	optionGroups: z.array(optionGroupSchema),
-	variants: z.array(productVariantSchema)
+const savedCustomInputRequestSchema = z.object({
+	label: z.string().trim().min(1).max(30),
+	placeholder: z.string().trim().max(100).nullish(),
+	maxLength: z.number().int().min(1).max(200),
+	required: z.boolean().default(false)
 });
 /**
-* 재고 변경 택일 위반 문구 — SDK `.refine`과 서버 DomainException이 공유하는 단일 원천.
-* 경로에 따라 셀러가 다른 문구를 받지 않게 한다.
-*/
-const VARIANT_STOCK_EXCLUSIVE_MESSAGE = "stockQuantity 또는 adjustment 중 하나만 전달해야 합니다";
-/**
-* variant 재고 변경 요청 — 절대값(`stockQuantity`) 또는 증감(`adjustment`) 택일.
-* 서버도 같은 규칙을 400 VALIDATION_FAILED로 검증한다(이중 방어).
+* 저장 옵션 만들기·수정 본문. 조합 옵션명은 최대 `MAX_OPTION_GROUPS`개, 추가 선택은 최대 `MAX_ADDON_GROUPS`개이고
+* 옵션명과 직접 입력 항목이 모두 비면 400이다. 수정(PUT)은 통째로 바꾼다.
 */
-const variantStockRequestSchema = z.object({
-	stockQuantity: z.number().int().min(0).optional(),
-	adjustment: z.number().int().optional()
-}).refine((v) => v.stockQuantity !== void 0 !== (v.adjustment !== void 0), { message: VARIANT_STOCK_EXCLUSIVE_MESSAGE });
-/** PATCH /products/{productId}/variants/{variantId}/stock 응답 */
-const variantStockSchema = z.object({
-	variantId: z.string(),
-	stockQuantity: z.number().int()
+const savedOptionSetRequestSchema = z.object({
+	name: z.string().trim().min(1).max(50),
+	optionSort: optionSortSchema.default("REGISTERED"),
+	groups: z.array(savedOptionGroupRequestSchema).max(8).default([]),
+	customInputs: z.array(savedCustomInputRequestSchema).max(5).default([])
 });
 /**
-* 상품 쓰기 요청의 공통 필드 — 등록(POST)과 전체 수정(PUT)이 같다. 이행(`fulfillment`)만 두 요청의 스키마가 다르다.
+* 상품에서 저장 (`POST /v1/saved-option-sets/from-product`) — 상품의 현재 옵션을 저장 옵션으로 만든다.
 *
-* 최상위가 `strictObject`다. 모르는 필드는 400이다 — 이슈 #57 이전의 평면 필드(`deliveryFee`·`fulfillmentType`·`returnFee` 등)를
-* 보낸 요청이 조용히 무시되지 않게 한다. 옛 필드는 `fulfillment.{유형}.…`과 `refundPolicy`로 옮겼다.
+* 조합 추가금이 값별 추가금의 합으로 되돌려지면 값별로 저장하고, 조합마다 제각각이면 추가금을 빼고
+* 응답 `additionalPriceDropped: true`로 알린다. `replaceOptionSetId`를 주면 그 저장 옵션을 덮어쓴다(이름 중복의 덮어쓰기).
 */
-const productWriteShape = {
-	name: z.string().min(1).max(100),
-	categoryId: z.string().min(1, "카테고리를 선택해주십시오"),
-	salePrice: z.number().int().min(10).multipleOf(10, "판매가는 10원 단위여야 합니다 (INVALID_PRICE_UNIT)").describe("판매가. 원(KRW) 단위 정수, 최소 10원, 10원 단위"),
-	originalPrice: z.number().int().optional().describe("정가(할인 전 표시 가격). 원 단위"),
-	description: z.string().optional(),
-	/**
-	* 상세설명 에디터(@avarlabs/editor)의 직렬화 상태. 재편집 때 이 값으로 문서를 복원한다.
-	* 표시는 `description`(HTML)이 맡는다 — 소비자는 이 필드를 몰라도 된다.
-	*/
-	descriptionJson: z.string().nullable().optional(),
-	images: z.array(productImageUrlSchema).min(1).max(10).optional().describe("상품 이미지 주소 목록. 첫 장이 대표 이미지(썸네일)다"),
-	attributes: z.array(z.object({
-		attributeId: z.string(),
-		value: z.string()
-	})).optional(),
-	refundPolicy: productRefundPolicyPatchSchema.nullish().describe("상품별 환불 정책 — 준 항목만 스토어 기본을 덮어쓴다. `null`이나 생략은 스토어 기본을 그대로 쓴다는 뜻이다. 반품·교환 배송비(`returnDeliveryFee`·`exchangeDeliveryFee`)는 배송 상품에만 줄 수 있다(다른 유형은 400)"),
-	...optionModelRequestSchema.shape
-};
-const productCreateRequestSchema = z.strictObject({
-	...productWriteShape,
-	fulfillment: productFulfillmentCreateSchema.optional().describe("상품 이행. `type`이 유형이고 같은 이름의 키가 유형별 속성이다. 생략하면 배송 상품(기본값)이다. 배송 상품이 아닌 유형은 판매가 열린 유형만 등록할 수 있다(409 `FULFILLMENT_TYPE_NOT_AVAILABLE`)")
-});
-const fulfillmentUpdateDescription = "상품 이행. 생략하면 바꾸지 않는다. 주면 유형 안 필드를 모두 담아 통째로 바꾼다(현재 값과 병합하지 않는다). 판매 이력이 있으면 유형을 바꿀 수 없다(409 `FULFILLMENT_TYPE_LOCKED`)";
-/** 전체 수정(PUT) — 공통 필드는 등록과 같고, 이행은 생략하면 현재 값 유지, 주면 필드가 모두 필수다 */
-const productReplaceRequestSchema = z.strictObject({
-	...productWriteShape,
-	fulfillment: productFulfillmentUpdateSchema.optional().describe(fulfillmentUpdateDescription)
-});
-const productPatchRequestSchema = z.strictObject({
-	name: z.string().max(100).optional(),
-	salePrice: z.number().int().multipleOf(10).optional(),
-	status: productStatusSchema.optional(),
-	fulfillment: productFulfillmentUpdateSchema.optional().describe(fulfillmentUpdateDescription),
-	refundPolicy: productRefundPolicyPatchSchema.nullable().optional().describe("상품별 환불 정책. 주면 통째로 바꾼다(준 항목만 스토어 기본을 덮어쓴다). `null`은 덮어쓰기를 지워 스토어 기본을 따른다. 생략하면 바꾸지 않는다")
-}).refine((value) => Object.values(value).some((v) => v !== void 0), { message: "최소 1개 필드가 필요합니다" });
-const productSortSchema = z.enum([
-	"createdAt.desc",
-	"createdAt.asc",
-	"salePrice.asc",
-	"salePrice.desc",
-	"updatedAt.desc"
+const savedOptionSetFromProductRequestSchema = z.object({
+	productId: z.string(),
+	name: z.string().trim().min(1).max(50),
+	includeOptions: z.boolean().default(true).describe("옵션명(조합·추가 선택)을 저장하는가"),
+	includeCustomInputs: z.boolean().default(true).describe("직접 입력 항목을 저장하는가"),
+	replaceOptionSetId: z.string().optional().describe("덮어쓸 저장 옵션 id. 생략하면 새로 만든다")
+});
+const savedOptionSetFromProductResultSchema = z.object({
+	optionSet: savedOptionSetSchema,
+	additionalPriceDropped: z.boolean().describe("조합 추가금을 값별 추가금으로 되돌릴 수 없어 추가금을 빼고 저장했는가")
+});
+/** 구성 필터 — 조합 옵션명·추가 선택 옵션명·직접 입력 항목을 가진 저장 옵션 */
+const savedOptionSetCompositionSchema = z.enum([
+	"combination",
+	"addon",
+	"customInput"
 ]);
-/** `GET /v1/products` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
-const productListQuerySchema = z.object({
-	status: productStatusSchema.optional().describe("판매 상태 필터"),
-	categoryId: z.string().optional().describe("카테고리 필터 — 하위 카테고리의 상품도 포함"),
-	keyword: z.string().optional().describe("상품명 검색 (포함)"),
-	sellerCode: z.string().optional().describe("판매자 상품코드 — 이 코드가 붙은 variant를 가진 상품"),
-	sort: productSortSchema.optional().describe("정렬 (기본 createdAt.desc)"),
-	...pageQueryShape()
-});
-const discountRequestSchema = z.object({
-	discountType: z.enum(["RATE", "AMOUNT"]),
-	discountValue: z.number().int().min(1),
-	startAt: z.string().optional(),
-	endAt: z.string().optional()
+const savedOptionSetSortSchema = z.enum([
+	"updatedAt.desc",
+	"name.asc",
+	"importedProductCount.desc"
+]);
+/** `GET /v1/saved-option-sets` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
+const savedOptionSetListQuerySchema = z.object({
+	keyword: z.string().optional().describe("이름 검색 (포함, 대소문자 무시)"),
+	composition: savedOptionSetCompositionSchema.optional().describe("구성 필터"),
+	sort: savedOptionSetSortSchema.optional().describe("정렬 (기본 updatedAt.desc)"),
+	...pageQueryShape({
+		defaultSize: 20,
+		maxSize: 200
+	})
 });
 //#endregion
 //#region src/schemas/shipping-policy.ts
@@ -4188,6 +4429,7 @@ const sellerAddressRequestSchema = z.object({
 * - 409 `STOREFRONT_SITE_CREATE_LIMIT` — 사이트는 스토어당 30일에 3번까지 만든다
 * - 409 `STOREFRONT_SITE_CHANGED` — 읽은 상태(`expected*`)와 현재 상태가 다르다. 다시 읽고 시도한다
 * - 409 `STOREFRONT_SITE_NOT_ACTIVE` — 정지(`SUSPENDED`)된 사이트는 바꾸거나 끌 수 없다
+* - 409 `STORE_SUSPENDED` — 정지된 스토어에는 사이트를 만들 수 없다
 * - 409 `STOREFRONT_VERSION_NOT_READY` — 빌드가 끝나지 않았거나 실패한 버전은 발행할 수 없다
 * - 409 `STOREFRONT_NO_ROLLBACK_TARGET` — 되돌릴 이전 발행 버전이 없다
 * - 400 `STOREFRONT_SLUG_CONFIRM_MISMATCH` — 호스팅 끄기 확인 입력이 현재 슬러그와 다르다
@@ -4209,6 +4451,16 @@ const sellerAddressRequestSchema = z.object({
 * - 409 `STOREFRONT_BUILD_IN_PROGRESS` — 이 사이트에 끝나지 않은 빌드가 있다(사이트당 하나)
 * - 404 `STOREFRONT_BUILD_NOT_FOUND`
 * - 502 `STOREFRONT_SANDBOX_UNAVAILABLE` — 편집 Sandbox 호출이 실패했다. 잠시 뒤 다시 한다
+*
+* 소스 내려받기·올리기(#60, `/v1/storefront/site/source/**`, `sayren` CLI):
+* - 409 `SOURCE_CHANGED` — 작업 트리가 내려받은 뒤(`expectedBaseRef`) 바뀌었다(콘솔·AI 편집). `error.details.currentRef`
+* - 409 `EDIT_SESSION_OPEN` — 편집 환경이 열려 있다. `endEditSession: true`로 끄고 진행할 수 있다
+* - 409 `SOURCE_BLOBS_MISSING` — 올리지 않은 파일 내용이 있다(`error.details.hashes`). `POST source/blobs`로 올리고 다시 한다
+* - 409 `DEPENDENCY_REJECTED` — 쓸 수 없는 npm 의존성이다(`error.details.rejected: [{ name, version, reason, detail }]`)
+* - 413 `SOURCE_TOO_MANY_NEW_FILES` — 한 번에 새 내용이 800개를 넘는다(`error.details.max`). 나눠서 바꾼다
+* - 400 `DEPENDENCY_FILES_MISMATCH` — `packageJson`·`lockfile` 내용이 목록의 해시와 다르거나 빠졌다
+* - 400 `INVALID_SOURCE_REF` · `BLOB_HASH_MISMATCH` · `INVALID_FILE_PATH`(`.env*`·작업 트리 밖 경로)
+* - 404 `STOREFRONT_SOURCE_NOT_FOUND` — 그 스냅샷이 없다
 */
 /**
 * 슬러그 형식 — 스토어 코드와 같은 DNS 라벨 규칙(소문자·숫자·하이픈 3~30자, 하이픈으로 시작·끝 불가)에
@@ -4231,7 +4483,8 @@ const RESERVED_STOREFRONT_SLUGS = [
 	"suspended",
 	"dispatch",
 	"control",
-	"outbound"
+	"outbound",
+	"sites"
 ];
 /**
 * 편집 미리보기 호스트 접미사 — 편집 미리보기 주소는 `{사이트 id 정규화}-preview.{호스팅 도메인}`이다(M2b). 사이트 주소와 같은
@@ -4291,6 +4544,7 @@ const storefrontVersionSchema = z.object({
 	source: z.enum(["TEMPLATE", "EDIT"]).describe("`TEMPLATE` 템플릿 산출물 그대로 · `EDIT` 편집 작업 트리를 빌드함"),
 	buildId: z.string().nullable().describe("편집 버전의 빌드 (`GET /v1/storefront/site/builds/{buildId}`). 템플릿 버전은 null"),
 	createdByType: z.string().describe("만든 행위자 유형 (`USER`·`AGENT`·`APP`·`TOKEN`·`SYSTEM`). 늘어날 수 있다"),
+	createdVia: z.string().nullable().optional().describe("만든 경로 (`CONSOLE` 콘솔 · `AI` AI 에이전트(MCP) · `CLI` `sayren` CLI · `API` 관리 API · `SYSTEM` 자동). 늘어날 수 있다"),
 	createdAt: z.string().describe("만든 시각 (ISO 8601)")
 });
 const storefrontSiteStatusSchema = z.enum([
@@ -4303,7 +4557,7 @@ const storefrontSourceModeSchema = z.enum(["MANAGED", "CUSTOM"]).describe("`MANA
 const storefrontDomainSchema = z.object({
 	hostname: z.string().describe("호스트 이름 (예: `mystore.sayren.co`)"),
 	kind: z.enum(["PLATFORM", "CUSTOM"]).describe("`PLATFORM` 슬러그 주소 · `CUSTOM` 내 도메인"),
-	status: z.enum(["ACTIVE", "HELD"]).describe("`ACTIVE` 사용 중 · `HELD` 슬러그를 바꿔 보류 중(새 주소로 301)"),
+	status: z.enum(["ACTIVE", "HELD"]).describe("`ACTIVE` 사용 중 · `HELD` 슬러그를 바꿔 보류 중(새 주소로 301). 연결 중인 내 도메인은 싣지 않는다(`GET /v1/storefront/site/domains`)"),
 	isPrimary: z.boolean().describe("대표 주소인가 (`Store.storefrontUrl`)"),
 	holdUntil: z.string().nullable().describe("보류가 끝나는 시각 (ISO 8601). 보류가 아니면 null")
 });
@@ -4325,6 +4579,14 @@ const storefrontProvisioningSchema = z.object({
 * 인증서가 덮으므로 따로 준비할 것이 없다. 이 주소는 편집 미리보기 링크(콘솔 전용)로 받은 쿠키가 있어야 열린다.
 */
 const storefrontEditPreviewSchema = z.object({ hostname: z.string().nullable().describe("편집 미리보기 호스트 (예: `sfs-ab12cd34-preview.sayren.co`). 편집을 쓸 수 없으면 null") });
+/**
+* 사이트 정지 — 운영 정책에 따라 플랫폼 운영자가 사이트를 정지한다. 정지 중에는 방문자에게 정지 안내가 보이고 발행·되돌리기·템플릿 변경·
+* 공개 전환·슬러그 변경·끄기·편집이 409 `STOREFRONT_SITE_NOT_ACTIVE`다. 셀러가 풀 수 없다(고객센터로 문의한다).
+*/
+const storefrontSuspensionSchema = z.object({
+	reason: z.string().nullable().describe("정지 사유. 운영자가 적은 안내이고 없으면 null"),
+	suspendedAt: z.string().nullable().describe("정지한 시각 (ISO 8601)")
+});
 const storefrontSiteSchema = z.object({
 	siteId: z.string(),
 	slug: z.string().describe("주소 슬러그"),
@@ -4339,6 +4601,7 @@ const storefrontSiteSchema = z.object({
 	provisioning: storefrontProvisioningSchema,
 	editPreview: storefrontEditPreviewSchema,
 	slugChangesRemaining: z.number().int().min(0).describe(`최근 30일 기준 남은 슬러그 변경 횟수`),
+	suspension: storefrontSuspensionSchema.nullable().optional().describe("정지 정보. `status`가 `SUSPENDED`일 때만 있고 그 밖은 null"),
 	createdAt: z.string(),
 	updatedAt: z.string()
 });
@@ -4396,6 +4659,186 @@ const storefrontPreviewLinkSchema = z.object({
 	url: z.string().describe("미리보기 링크 — 5분 안에 연다"),
 	expiresAt: z.string().describe("링크 만료 시각 (ISO 8601)")
 });
+/**
+* 연결할 수 없는 도메인 — 플랫폼이 쓰는 도메인과 그 하위(기본 주소는 슬러그로 바꾼다). 호스팅 도메인은 서버 설정이라
+* `storefrontCustomHostnameProblem`의 인자로 따로 받는다.
+*/
+const STOREFRONT_PLATFORM_DOMAINS = [
+	"sayren.co",
+	"sayren.app",
+	"sayren.shop",
+	"avarlabs.com"
+];
+/** 공개 인터넷에서 쓸 수 없는 최상위 도메인(RFC 2606·6761·6762 등) */
+const NON_PUBLIC_TLDS = [
+	"example",
+	"localhost",
+	"local",
+	"test",
+	"invalid",
+	"onion",
+	"internal",
+	"arpa",
+	"home",
+	"lan",
+	"corp",
+	"intranet",
+	"alt"
+];
+/**
+* 공용 접미사 — 누구나 그 아래 이름을 받는 도메인이라 접미사 자체는 연결할 수 없다. Public Suffix List 전체가 아니라 자주 틀리는
+* 것만 둔다(여기 없는 접미사도 TXT 소유 확인을 통과할 수 없어 연결되지 않는다 — 이 목록은 추가 단계에서 빨리 알려 주는 안내다).
+*/
+const STOREFRONT_PUBLIC_SUFFIXES = [
+	"co.kr",
+	"or.kr",
+	"ne.kr",
+	"go.kr",
+	"ac.kr",
+	"re.kr",
+	"pe.kr",
+	"mil.kr",
+	"hs.kr",
+	"ms.kr",
+	"es.kr",
+	"sc.kr",
+	"kg.kr",
+	"seoul.kr",
+	"busan.kr",
+	"incheon.kr",
+	"daegu.kr",
+	"gwangju.kr",
+	"daejeon.kr",
+	"ulsan.kr",
+	"gyeonggi.kr",
+	"gangwon.kr",
+	"chungbuk.kr",
+	"chungnam.kr",
+	"jeonbuk.kr",
+	"jeonnam.kr",
+	"gyeongbuk.kr",
+	"gyeongnam.kr",
+	"jeju.kr",
+	"co.jp",
+	"ne.jp",
+	"or.jp",
+	"com.cn",
+	"net.cn",
+	"com.tw",
+	"com.hk",
+	"co.uk",
+	"org.uk",
+	"com.au",
+	"net.au",
+	"com.sg",
+	"co.nz",
+	"com.br",
+	"github.io",
+	"gitlab.io",
+	"pages.dev",
+	"workers.dev",
+	"vercel.app",
+	"netlify.app",
+	"herokuapp.com",
+	"web.app",
+	"firebaseapp.com",
+	"blogspot.com",
+	"cloudfront.net",
+	"azurewebsites.net",
+	"myshopify.com",
+	"wixsite.com",
+	"cafe24.com",
+	"imweb.me"
+];
+/** 스토어당 연결할 수 있는 도메인 수 기본값 — 요금제(#44) 전의 상한이다. 실제 값은 `GET …/domains`의 `limit` */
+const STOREFRONT_CUSTOM_DOMAIN_LIMIT_DEFAULT = 2;
+/** DNS를 넣을 때까지 기다리는 기간(일) — 지나면 `FAILED`(`DNS_NOT_CONFIGURED`) */
+const STOREFRONT_DOMAIN_DNS_WAIT_DAYS = 7;
+/** 연결된 도메인의 DNS가 이 서비스를 가리키지 않아도 연결을 유지하는 기간(일) — 지나면 서버가 해제한다 */
+const STOREFRONT_DOMAIN_DNS_GRACE_DAYS = 7;
+/** 소유 확인 TXT 레코드의 이름 앞부분 — `_sayren-verify.{도메인}` */
+const STOREFRONT_DOMAIN_TXT_LABEL = "_sayren-verify";
+const LABEL = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+const PUNYCODE_TLD = /^xn--[a-z0-9-]{1,59}$/;
+const ALPHA_TLD = /^[a-z]{2,63}$/;
+/**
+* 도메인 정규화 — 앞뒤 공백·끝 점을 떼고 소문자로 바꾸며 국제화 도메인은 punycode(`xn--`)로 바꾼다. 스킴·경로·포트가 붙은 입력
+* (`https://www.a.com/`)은 호스트만 남기지 않고 그대로 두어 형식 검사에서 떨어진다(서버는 사용자가 적은 도메인만 받는다).
+* 변환할 수 없으면 입력을 소문자로만 바꿔 돌려준다(형식 검사가 거부한다).
+*/
+function normalizeStorefrontHostname(input) {
+	const trimmed = input.trim().replace(/\.+$/, "");
+	if (!trimmed || /[\s/:?#@\\[\]%]/.test(trimmed)) return trimmed.toLowerCase();
+	if (/^[\x21-\x7e]+$/.test(trimmed)) return trimmed.toLowerCase();
+	try {
+		return new URL(`http://${trimmed}`).hostname.toLowerCase();
+	} catch {
+		return trimmed.toLowerCase();
+	}
+}
+/**
+* 연결할 수 있는 도메인인가(정규화한 값 기준). 문제가 없으면 null이다. 규칙: 253자 이하, 라벨 2개 이상, 라벨은 소문자·숫자·하이픈
+* 63자 이하(하이픈으로 시작·끝 불가), 최상위 도메인은 영문자이거나 punycode, IP 주소·와일드카드·공개 인터넷 밖 최상위 도메인·
+* 플랫폼 도메인과 그 하위·공용 접미사 자체는 안 된다. 제어·디스패치 Worker가 형식 규칙의 복제본을 들고 있다(api
+* `test/storefront-hosting-parity.spec.ts`가 대조한다).
+*/
+function storefrontCustomHostnameProblem(hostname, hostingDomain = "sayren.co") {
+	if (hostname.startsWith("*.")) return "WILDCARD";
+	if (/^\d{1,3}(\.\d{1,3}){3}$/.test(hostname) || /^\[?[0-9a-f:.]*:[0-9a-f:.]*\]?$/.test(hostname)) return "IP_ADDRESS";
+	if (hostname.length === 0 || hostname.length > 253) return "FORMAT";
+	const labels = hostname.split(".");
+	if (labels.length < 2) return "SINGLE_LABEL";
+	if (!labels.every((label) => LABEL.test(label))) return "FORMAT";
+	const tld = labels[labels.length - 1] ?? "";
+	if (!ALPHA_TLD.test(tld) && !PUNYCODE_TLD.test(tld)) return "FORMAT";
+	if (NON_PUBLIC_TLDS.includes(tld)) return "NON_PUBLIC_TLD";
+	const platform = /* @__PURE__ */ new Set([...STOREFRONT_PLATFORM_DOMAINS, hostingDomain.toLowerCase()]);
+	for (const domain of platform) if (hostname === domain || hostname.endsWith(`.${domain}`)) return "PLATFORM_DOMAIN";
+	if (STOREFRONT_PUBLIC_SUFFIXES.includes(hostname)) return "PUBLIC_SUFFIX";
+	return null;
+}
+/** 소유 확인 TXT 레코드의 전체 이름 */
+function storefrontDomainTxtNameOf(hostname) {
+	return `${STOREFRONT_DOMAIN_TXT_LABEL}.${hostname}`;
+}
+const storefrontCustomDomainStatusSchema = z.enum([
+	"PENDING_DNS",
+	"PENDING_VALIDATION",
+	"ACTIVE",
+	"FAILED"
+]).describe("`PENDING_DNS` DNS 설정 대기(소유 확인 전) · `PENDING_VALIDATION` 소유 확인됨, 인증서 발급 중 · `ACTIVE` 연결됨 · `FAILED` 연결 실패(`failureCode`)");
+const storefrontDnsRecordSchema = z.object({
+	type: z.enum(["CNAME", "TXT"]).describe("레코드 유형"),
+	name: z.string().describe("레코드 이름 (전체 이름, 예: `_sayren-verify.shop.brand.com`)"),
+	value: z.string().describe("레코드 값"),
+	purpose: z.enum(["ROUTING", "OWNERSHIP"]).describe("`ROUTING` 연결 · `OWNERSHIP` 소유 확인")
+});
+const storefrontSiteDomainSchema = z.object({
+	domainId: z.string(),
+	hostname: z.string().describe("호스트 이름 (punycode, 소문자)"),
+	kind: z.enum(["PLATFORM", "CUSTOM"]).describe("`PLATFORM` 기본 주소(슬러그) · `CUSTOM` 내 도메인"),
+	status: storefrontCustomDomainStatusSchema.describe("기본 주소는 늘 `ACTIVE`다. 내 도메인은 연결 단계"),
+	isPrimary: z.boolean().describe("대표 주소인가 (`Store.storefrontUrl`). 대표가 아닌 주소는 대표로 301한다"),
+	dnsRecords: z.array(storefrontDnsRecordSchema).describe("DNS에 넣을 레코드. 기본 주소는 빈 배열"),
+	certificateStatus: z.enum([
+		"PENDING",
+		"ACTIVE",
+		"FAILED"
+	]).nullable().describe("인증서 상태. 소유 확인 전·기본 주소는 null"),
+	failureCode: z.string().nullable().describe("실패·경고 코드. `DNS_NOT_CONFIGURED` 기한 안에 TXT를 찾지 못함 · `VALIDATION_TIMEOUT` 인증서 발급 기한 지남 · `CERTIFICATE_FAILED` 인증서 발급 실패 · `DNS_NOT_POINTING` 연결된 뒤 DNS가 이 서비스를 가리키지 않음(기한이 지나면 해제) · `DOMAIN_TAKEN` 다른 스토어가 먼저 소유를 확인함 · `HOSTNAME_BLOCKED` 연결이 막힘 · `HOSTNAME_CONFLICT` 연결 준비 중 충돌(운영 확인). 늘어날 수 있다"),
+	verifiedAt: z.string().nullable().describe("소유를 확인한 시각 (ISO 8601)"),
+	activatedAt: z.string().nullable().describe("연결된 시각 (ISO 8601)"),
+	checkedAt: z.string().nullable().describe("마지막으로 확인한 시각 (ISO 8601)"),
+	createdAt: z.string()
+});
+/** `GET /v1/storefront/site/domains` — 사이트의 주소 목록(기본 주소 + 내 도메인)과 연결 설정 */
+const storefrontSiteDomainsSchema = z.object({
+	enabled: z.boolean().describe("내 도메인을 추가할 수 있는가 (플랫폼 스위치)"),
+	limit: z.number().int().min(0).describe("스토어당 내 도메인 수 상한 (해제한 도메인은 세지 않는다)"),
+	target: z.string().describe("CNAME 대상 (예: `sites.sayren.co`)"),
+	domains: z.array(storefrontSiteDomainSchema).describe("대표 주소 먼저, 그다음 추가한 순서")
+});
+const addStorefrontDomainRequestSchema = z.object({ hostname: z.string().min(1).max(300).describe("연결할 도메인 (예: `shop.brand.com`). 서버가 소문자·punycode로 정규화한다") });
 /** 플랫폼 전체 동시 편집 환경 상한 */
 const STOREFRONT_EDIT_CAPACITY = 20;
 /** 활동이 없으면 편집 환경이 잠드는 시간(분). 작업 트리는 보존된다 */
@@ -4672,9 +5115,11 @@ const STOREFRONT_BUILD_TERMINAL_STATUSES = [
 ];
 /**
 * 빌드 단계 — 이 순서로 돈다. 첫 실패에서 멈추지만 규칙 검증(`VERIFY`)은 실패해도 타입 검사까지 이어서 해 한 번에 알려 준다.
-* `UPLOAD`는 사이트 버전 Worker 업로드다(성공하면 발행할 수 있다). 값은 늘어날 수 있다.
+* `UPLOAD`는 사이트 버전 Worker 업로드다(성공하면 발행할 수 있다). `DEPENDENCIES`는 빌드 시작 전 의존성 검사(거절 목록·보안 권고)다.
+* 값은 늘어날 수 있다.
 */
 const STOREFRONT_BUILD_STAGES = [
+	"DEPENDENCIES",
 	"VERIFY",
 	"RESTORE",
 	"INSTALL",
@@ -4684,13 +5129,37 @@ const STOREFRONT_BUILD_STAGES = [
 	"PACK",
 	"UPLOAD"
 ];
+/**
+* 의존성 검사 결과 한 줄(#61) — 거절(`DEPENDENCY_REJECTED`의 `details.rejected`)·경고(빌드 `dependencies`, 소스 교체 `dependencyWarnings`)가
+* 같은 모양이다. 대상 패키지와 사유. 셀러가 고칠 수 있게 버전·권고 id·거절 사유를 싣는다.
+* `reason`: `DENYLISTED`(거절 목록) · `ADVISORY`(보안 권고) · `MALWARE`(악성 코드 권고, 패키지 전체) · `INSTALL_SCRIPT`(루트
+* package.json의 설치 훅은 거절, 의존성의 설치 스크립트는 경고) · `UNSUPPORTED_SOURCE`(레지스트리 밖 설치 경로) · `BUNDLED_DEPENDENCIES`(묶여
+* 오는 의존성, 경고) · `INVALID_MANIFEST`(package.json·잠금 파일 형식), 늘어날 수 있다.
+*/
+const storefrontDependencyFindingSchema = z.object({
+	name: z.string().describe("패키지 이름. 파일 전체의 문제면 `package.json`·`pnpm-lock.yaml`"),
+	version: z.string().nullable().describe("해당 버전. 버전과 무관하면 null"),
+	reason: z.string().describe("사유 코드"),
+	detail: z.string().describe("셀러용 설명"),
+	advisory: z.object({
+		id: z.string(),
+		url: z.string().nullable(),
+		severity: z.string(),
+		title: z.string()
+	}).nullable().optional().describe("보안 권고(사유가 `ADVISORY`·`MALWARE`일 때)")
+});
+const storefrontBuildDependenciesSchema = z.object({
+	checkedPackages: z.number().int().min(0).describe("검사한 설치 트리의 패키지(이름·버전) 수"),
+	rejected: z.array(storefrontDependencyFindingSchema).describe("빌드를 막은 의존성"),
+	warnings: z.array(storefrontDependencyFindingSchema).describe("빌드는 막지 않는 경고(중간 이하 심각도 권고)")
+});
 const storefrontBuildSchema = z.object({
 	buildId: z.string(),
 	versionId: z.string(),
 	versionNumber: z.number().int().min(1),
 	status: storefrontBuildStatusSchema,
-	failureStage: z.string().nullable().describe("실패한 단계 (`VERIFY`·`RESTORE`·`INSTALL`·`TYPECHECK`·`BUILD`·`BUNDLE`·`PACK`·`UPLOAD`, 늘어날 수 있다). 실패가 아니면 null"),
-	errorCode: z.string().nullable().describe("실패 코드 (`RULES_VIOLATED`·`INSTALL_FAILED`·`TYPECHECK_FAILED`·`BUILD_FAILED`·`BUNDLE_FAILED`·`ARTIFACT_INVALID`·`UPLOAD_FAILED`·`SOURCE_NOT_FOUND`·`CAPACITY_EXHAUSTED`·`INTERNAL`, 늘어날 수 있다). 실패가 아니면 null"),
+	failureStage: z.string().nullable().describe("실패한 단계 (`DEPENDENCIES`·`VERIFY`·`RESTORE`·`INSTALL`·`TYPECHECK`·`BUILD`·`BUNDLE`·`PACK`·`UPLOAD`, 늘어날 수 있다). 실패가 아니면 null"),
+	errorCode: z.string().nullable().describe("실패 코드 (`DEPENDENCY_REJECTED`·`DEPENDENCY_CHECK_UNAVAILABLE`·`DEPENDENCIES_CHANGED`·`RULES_VIOLATED`·`INSTALL_FAILED`·`INSTALL_TOO_LARGE`·`TYPECHECK_FAILED`·`BUILD_FAILED`·`BUILD_TIMEOUT`·`BUNDLE_FAILED`·`ARTIFACT_TOO_LARGE`·`ARTIFACT_INVALID`·`UPLOAD_FAILED`·`SOURCE_NOT_FOUND`·`CAPACITY_EXHAUSTED`·`INTERNAL`, 늘어날 수 있다). 실패가 아니면 null"),
 	logTail: z.string().nullable().describe("실패 단계 출력 꼬리 (최대 8KB). 없으면 null"),
 	stages: z.array(z.object({
 		stage: z.string(),
@@ -4698,6 +5167,7 @@ const storefrontBuildSchema = z.object({
 		durationMs: z.number().int().min(0)
 	})).describe("끝난 단계 (도는 순서)"),
 	verify: storefrontVerifyReportSchema.nullable().describe("규칙 검증 보고서(위반 상세는 50건까지). 그 단계까지 가지 못했으면 null"),
+	dependencies: storefrontBuildDependenciesSchema.nullable().optional().describe("의존성 검사 결과(거절 목록·보안 권고). 빌드 시작 전에 돈다. 거절이 있으면 `failureStage: DEPENDENCIES`, `errorCode: DEPENDENCY_REJECTED`다. 아직 검사 전이면 null(옛 서버는 싣지 않는다)"),
 	queuedAt: z.string(),
 	startedAt: z.string().nullable(),
 	finishedAt: z.string().nullable(),
@@ -4708,7 +5178,10 @@ const storefrontBuildListQuerySchema = z.object({ limit: z.coerce.number().int()
 * `POST /v1/storefront/site/versions` — 지금 작업 트리를 고정해 버전을 만든다(빌드 시작). 사이트당 끝나지 않은 빌드는
 * 하나다(409 `STOREFRONT_BUILD_IN_PROGRESS`). 편집 환경이 없어도 된다.
 */
-const createStorefrontVersionRequestSchema = z.object({ message: z.string().max(200).optional().describe("버전 메모 (에이전트는 바꾼 내용 요약)") });
+const createStorefrontVersionRequestSchema = z.object({
+	message: z.string().max(200).optional().describe("버전 메모 (에이전트는 바꾼 내용 요약)"),
+	expectedSourceRef: z.string().max(200).optional().describe("고정할 작업 트리 (`PUT /v1/storefront/site/source`의 `sourceRef`). 주면 지금 작업 트리가 이 값일 때만 버전을 만든다(다르면 409 `SOURCE_CHANGED`)")
+});
 /** 버전 만들기 응답 (201) — 버전은 `BUILDING`, 빌드는 `QUEUED`로 시작한다. 결과는 `GET builds/{buildId}`로 본다 */
 const storefrontVersionCreatedSchema = z.object({
 	version: storefrontVersionSchema,
@@ -4720,6 +5193,80 @@ const storefrontVersionCreatedSchema = z.object({
 * 없으면 409 `EDIT_SESSION_REQUIRED`다(편집 환경이 `STARTING`이면 링크는 주고, 미리보기 화면이 기동 대기를 보여 준다).
 */
 const createStorefrontEditPreviewLinkRequestSchema = createStorefrontPreviewLinkRequestSchema;
+/** 압축 파일 조각 하나의 최대 크기(바이트) */
+const STOREFRONT_SOURCE_PART_BYTES = 4194304;
+/** 내용 올리기 한 번의 최대 파일 수 */
+const STOREFRONT_SOURCE_BLOB_BATCH_MAX = 200;
+/** 작업 트리 파일 수 상한 */
+const STOREFRONT_WORKSPACE_MAX_FILES = 2e3;
+/** 작업 트리 스냅샷 키 — `sources/{siteId}/{sha256}.tgz` */
+const storefrontSourceRefSchema = z.string().regex(/^sources\/sfs_[a-z0-9]{8,40}\/[0-9a-f]{64}\.tgz$/, "작업 트리 스냅샷 키 형식이 아닙니다").describe("작업 트리 스냅샷 (`sources/{siteId}/{sha256}.tgz`, 내용 주소)");
+/** `GET /v1/storefront/site/source` — 지금 작업 트리(편집 환경이 떠 있으면 지금 내용을 고정한다) */
+const storefrontSourceSchema = z.object({
+	siteId: z.string(),
+	storeId: z.string(),
+	storeCode: z.string().describe("스토어 코드 — 로컬 개발 서버의 `SAYREN_STORE_CODE`"),
+	sourceRef: storefrontSourceRefSchema,
+	treeSha256: z.string().describe("트리 지문 (경로 오름차순 `{path}\\t{sha256}\\n`의 SHA-256)"),
+	files: z.number().int().min(0).describe("파일 수"),
+	bytes: z.number().int().min(0).describe("파일 크기 합"),
+	archive: z.object({
+		format: z.literal("tar+gzip"),
+		bytes: z.number().int().min(0).describe("압축 파일 크기"),
+		sha256: z.string().describe("압축 파일의 SHA-256 (`sourceRef`의 해시와 같다)"),
+		parts: z.number().int().min(0).describe("`GET source/archive`로 받을 조각 수"),
+		partBytes: z.number().int().describe("조각 하나의 최대 크기")
+	}),
+	editSessionOpen: z.boolean().describe("편집 환경이 열려 있는가 (올리기 전에 끄거나 `endEditSession`)")
+});
+const storefrontSourceArchiveQuerySchema = z.object({
+	sourceRef: storefrontSourceRefSchema,
+	part: z.coerce.number().int().min(0).max(100).optional().describe("조각 번호 (0부터, 기본 0)")
+});
+/** `GET /v1/storefront/site/source/archive` — 압축 파일 조각 */
+const storefrontSourceArchivePartSchema = z.object({
+	sourceRef: storefrontSourceRefSchema,
+	part: z.number().int().min(0),
+	parts: z.number().int().min(0),
+	offset: z.number().int().min(0),
+	bytes: z.number().int().min(0).describe("이 조각의 크기"),
+	totalBytes: z.number().int().min(0),
+	content: z.string().describe("조각 내용 (base64)")
+});
+/** `POST /v1/storefront/site/source/blobs` — 파일 내용 올리기(해시 키, 다시 올려도 안전하다). 작업 트리는 바뀌지 않는다 */
+const uploadStorefrontSourceBlobsRequestSchema = z.object({ blobs: z.array(z.object({
+	hash: storefrontFileHashSchema,
+	content: z.string().describe("파일 내용 (base64, 1MiB까지)")
+})).min(1).max(200) });
+const storefrontSourceBlobsResultSchema = z.object({
+	stored: z.number().int().min(0).describe("새로 올린 수"),
+	existing: z.number().int().min(0).describe("이미 있던 수")
+});
+/**
+* `PUT /v1/storefront/site/source` — 작업 트리 전체를 이 목록으로 바꾼다(없는 경로는 지운다). 전부 아니면 전무다.
+* `package.json`·`pnpm-lock.yaml`도 바꿀 수 있고 의존성은 허용 목록 안이어야 한다. `.env*`·작업 트리 밖 경로는 받지 않는다.
+*/
+const replaceStorefrontSourceRequestSchema = z.object({
+	expectedBaseRef: storefrontSourceRefSchema.optional().describe("내려받은 작업 트리. 지금 작업 트리가 이 값일 때만 바꾼다. 생략하면 조건 없이 덮어쓴다"),
+	files: z.array(z.object({
+		path: storefrontFilePathSchema,
+		hash: storefrontFileHashSchema,
+		size: z.number().int().min(0).max(STOREFRONT_FILE_MAX_BYTES)
+	})).min(1).max(STOREFRONT_WORKSPACE_MAX_FILES).refine((files) => new Set(files.map((file) => file.path)).size === files.length, { message: "같은 경로를 두 번 실을 수 없습니다" }),
+	endEditSession: z.boolean().optional().describe("열린 편집 환경을 끄고 진행한다 (기본 false — 열려 있으면 409 `EDIT_SESSION_OPEN`)"),
+	packageJson: z.string().max(STOREFRONT_FILE_MAX_BYTES).optional().describe("`files`에 `package.json`이 있으면 그 내용(utf8). 서버가 의존성을 판정한다. 해시가 목록과 다르면 400 `DEPENDENCY_FILES_MISMATCH`"),
+	lockfile: z.string().max(STOREFRONT_FILE_MAX_BYTES).optional().describe("`files`에 `pnpm-lock.yaml`이 있으면 그 내용(utf8)")
+});
+const storefrontSourceReplacedSchema = z.object({
+	sourceRef: storefrontSourceRefSchema.describe("새 작업 트리 — 다음 올리기의 `expectedBaseRef`"),
+	previousRef: z.string().describe("바꾸기 전 작업 트리"),
+	treeSha256: z.string(),
+	files: z.number().int().min(0),
+	bytes: z.number().int().min(0),
+	changed: z.boolean().describe("내용이 바뀌었는가 (같은 트리를 다시 올리면 false)"),
+	endedEditSession: z.boolean().describe("열린 편집 환경을 끄고 진행했는가"),
+	dependencyWarnings: z.array(storefrontDependencyFindingSchema).describe("배포를 막지 않는 의존성 경고 (보안 권고 등)")
+});
 //#endregion
 //#region src/client.ts
 function formBody(fields) {
@@ -4907,6 +5454,21 @@ function createStoreClient(options) {
 			setDiscount: (productId, body) => storeHttp.request("PUT", path`/products/${productId}/discount`, discountSchema, { body: discountRequestSchema.parse(body) }),
 			removeDiscount: (productId) => storeHttp.requestVoid("DELETE", path`/products/${productId}/discount`)
 		},
+		/**
+		* 저장 옵션 (이슈 #59) — 자주 쓰는 옵션 구성. 불러오기는 복사라 저장 옵션을 고쳐도 불러온 상품은 바뀌지 않는다.
+		* 권한은 상품과 같다(`product:r`·`product:rw`).
+		*/
+		savedOptionSets: {
+			list: (params) => storeHttp.request("GET", "/saved-option-sets", pageSchema(savedOptionSetSchema), { query: params }),
+			get: (optionSetId) => storeHttp.request("GET", path`/saved-option-sets/${optionSetId}`, savedOptionSetSchema),
+			/** 이름이 겹치면 409 `OPTION_SET_NAME_TAKEN`, 스토어당 200개를 넘으면 409 `OPTION_SET_LIMIT_EXCEEDED` */
+			create: (body) => storeHttp.request("POST", "/saved-option-sets", savedOptionSetSchema, { body: savedOptionSetRequestSchema.parse(body) }),
+			/** 통째로 바꾼다. 불러온 상품은 바뀌지 않는다 */
+			update: (optionSetId, body) => storeHttp.request("PUT", path`/saved-option-sets/${optionSetId}`, savedOptionSetSchema, { body: savedOptionSetRequestSchema.parse(body) }),
+			remove: (optionSetId) => storeHttp.requestVoid("DELETE", path`/saved-option-sets/${optionSetId}`),
+			/** 상품의 현재 옵션을 저장 옵션으로 만든다(또는 `replaceOptionSetId`를 덮어쓴다) */
+			saveFromProduct: (body) => storeHttp.request("POST", "/saved-option-sets/from-product", savedOptionSetFromProductResultSchema, { body: savedOptionSetFromProductRequestSchema.parse(body) })
+		},
 		categories: {
 			list: (params) => storeHttp.request("GET", "/categories", z.array(categorySchema), { query: params }),
 			tree: () => storeHttp.request("GET", "/categories", z.array(categoryTreeNodeSchema), { query: { tree: true } }),
@@ -5317,6 +5879,19 @@ list: (params) => storeHttp.request("GET", "/audit-logs", auditLogPageSchema, {
 			* 콘솔에서 로그인한 OWNER·ADMIN만 받는다
 			*/
 			createPreviewLink: (body = {}) => storeHttp.request("POST", "/storefront/site/preview-link", storefrontPreviewLinkSchema, { body: createStorefrontPreviewLinkRequestSchema.parse(body) }),
+			/** `GET /v1/storefront/site/domains` — 주소 목록(기본 주소 + 내 도메인)과 DNS 안내 */
+			listDomains: () => storeHttp.request("GET", "/storefront/site/domains", storefrontSiteDomainsSchema),
+			/**
+			* `POST /v1/storefront/site/domains` (201) — 내 도메인을 추가한다. 응답의 `dnsRecords`를 DNS에 넣으면 서버가 소유를 확인하고
+			* 인증서를 발급한다
+			*/
+			addDomain: (body) => storeHttp.request("POST", "/storefront/site/domains", storefrontSiteDomainSchema, { body: addStorefrontDomainRequestSchema.parse(body) }),
+			/** `POST /v1/storefront/site/domains/{domainId}/verify` — DNS를 곧바로 다시 확인한다(실패한 도메인은 처음부터 다시) */
+			verifyDomain: (domainId) => storeHttp.request("POST", path`/storefront/site/domains/${domainId}/verify`, storefrontSiteDomainSchema),
+			/** `POST /v1/storefront/site/domains/{domainId}/primary` — 대표 주소로 지정한다. 다른 주소는 대표 주소로 301한다 */
+			setPrimaryDomain: (domainId) => storeHttp.request("POST", path`/storefront/site/domains/${domainId}/primary`, storefrontSiteDomainsSchema),
+			/** `DELETE /v1/storefront/site/domains/{domainId}` — 내 도메인 연결을 해제한다(곧바로 끊긴다) */
+			removeDomain: (domainId) => storeHttp.requestVoid("DELETE", path`/storefront/site/domains/${domainId}`),
 			/** `POST /v1/storefront/site/disable` — 호스팅을 끈다(사이트 `CLOSED`, 슬러그 90일 보류). 다시 만들 수 있다 */
 			disable: (body) => storeHttp.request("POST", "/storefront/site/disable", storefrontSiteSchema, { body: disableStorefrontHostingRequestSchema.parse(body) }),
 			/** `GET /v1/storefront/site/editing` — 편집 환경 상태(열린 환경·동시 상한·미리보기 인증서) */
@@ -5365,7 +5940,18 @@ list: (params) => storeHttp.request("GET", "/audit-logs", auditLogPageSchema, {
 			/** `GET /v1/storefront/site/builds?limit=` — 빌드 목록(최신 먼저) */
 			listBuilds: (params = {}) => storeHttp.request("GET", "/storefront/site/builds", z.array(storefrontBuildSchema), { query: params }),
 			/** `GET /v1/storefront/site/builds/{buildId}` — 빌드 상태·실패 단계·로그 꼬리·규칙 결과 */
-			getBuild: (buildId) => storeHttp.request("GET", path`/storefront/site/builds/${buildId}`, storefrontBuildSchema)
+			getBuild: (buildId) => storeHttp.request("GET", path`/storefront/site/builds/${buildId}`, storefrontBuildSchema),
+			/** `GET /v1/storefront/site/source` — 지금 작업 트리를 고정하고 압축 파일(tar.gz) 크기·조각 수를 알린다 */
+			getSource: () => storeHttp.request("GET", "/storefront/site/source", storefrontSourceSchema),
+			/** `GET /v1/storefront/site/source/archive?sourceRef=&part=` — 압축 파일 조각(base64, 4MiB까지) */
+			getSourceArchive: (params) => storeHttp.request("GET", "/storefront/site/source/archive", storefrontSourceArchivePartSchema, { query: storefrontSourceArchiveQuerySchema.parse(params) }),
+			/** `POST /v1/storefront/site/source/blobs` — 파일 내용 올리기(해시 키). 작업 트리는 바뀌지 않는다 */
+			uploadSourceBlobs: (body) => storeHttp.request("POST", "/storefront/site/source/blobs", storefrontSourceBlobsResultSchema, { body: uploadStorefrontSourceBlobsRequestSchema.parse(body) }),
+			/**
+			* `PUT /v1/storefront/site/source` — 작업 트리 전체를 바꾼다. 409 `SOURCE_CHANGED`(내려받은 뒤 바뀜)·`EDIT_SESSION_OPEN`·
+			* `SOURCE_BLOBS_MISSING`(`details.hashes`를 올리고 다시)
+			*/
+			replaceSource: (body) => storeHttp.request("PUT", "/storefront/site/source", storefrontSourceReplacedSchema, { body: replaceStorefrontSourceRequestSchema.parse(body) })
 		},
 		store: {
 			get: () => storeHttp.request("GET", "/store", storeSchema),
@@ -5607,7 +6193,12 @@ const orderWebhookEventDataSchema = z.object({
 	testPayment: z.boolean().optional().default(false).describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다. 이 필드가 없는 이전 이벤트는 false로 읽는다"),
 	couponDiscountAmount: z.number().int().optional().default(0).describe("주문이 받은 상품·주문 쿠폰 할인 합계 (원). 즉시할인(`discountAmount`)과 별개다. 쿠폰이 없거나 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
 	orderItemId: z.string().optional().describe("이벤트를 만든 주문상품 ID. 배송 없는 상품 제공으로 보내는 `ORDER.DELIVERED`에만 실린다. 택배 배송완료와 그 밖의 주문 이벤트에는 없다"),
-	fulfillmentSnapshot: orderItemFulfillmentSnapshotResponseSchema.optional().describe("이벤트를 만든 주문상품의 주문 시점 이행 스냅샷(주문상품 응답의 `fulfillmentSnapshot`과 같다, 이슈 #57). 배송 없는 상품의 제공 완료는 `ORDER.DELIVERED`로도 오고 `type`이 `MANUAL`이다. `orderItemId`가 있는 이벤트에만 실린다")
+	fulfillmentSnapshot: orderItemFulfillmentSnapshotResponseSchema.optional().describe("이벤트를 만든 주문상품의 주문 시점 이행 스냅샷(주문상품 응답의 `fulfillmentSnapshot`과 같다, 이슈 #57). 배송 없는 상품의 제공 완료는 `ORDER.DELIVERED`로도 오고 `type`이 `MANUAL`이다. `orderItemId`가 있는 이벤트에만 실린다"),
+	itemOptions: z.array(z.object({
+		orderItemId: z.string(),
+		optionSelections: z.array(optionSelectionSchema),
+		customInputs: z.array(customInputValueSchema)
+	})).optional().describe("추가 선택·직접 입력이 있는 주문상품의 주문 시점 선택값(이슈 #59, 주문상품 응답의 `optionSelections`·`customInputs`와 같다). `ORDER.PAID`에만 실리고 그런 주문상품이 없으면 없다")
 });
 /**
 * `ORDER.FULFILLED` — 배송 없는 주문상품(`MANUAL`)을 제공했다(이슈 #48). 셀러의 제공 처리
@@ -5877,4 +6468,4 @@ function createStoreSession(options) {
 	};
 }
 //#endregion
-export { APPROVAL_ALREADY_DECIDED_CODE, APPROVAL_REQUIRED_CODE, ApiError, ApprovalPendingError, CASH_RECEIPT_STATUS_VALUES, COUPON_CODE_PATTERN, COUPON_CONDITIONS_DEFAULTS, COUPON_TARGET_ALL, COUPON_TARGET_LIST_MAX, FULFILLMENT_RULES, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_OPTION_GROUPS, MAX_PRODUCT_IMAGES, MAX_VALUES_PER_GROUP, MAX_VARIANTS, MCP_TELEMETRY_MAX_RESULTS, MIN_PAYMENT_AMOUNT, NO_COUPON_SETTLEMENT, NO_SHIPPING_BUNDLE_KEY, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, REFUND_POLICY_DELIVERY_FEE_KEYS, REMOTE_AREA_ZIP_RANGES, RESERVED_STOREFRONT_SLUGS, RESERVED_STORE_CODES, SHIPPING_POLICY_DEFAULTS, STOREFRONT_BLOCKED_PATH_SEGMENTS, STOREFRONT_BUILD_STAGES, STOREFRONT_BUILD_TERMINAL_STATUSES, STOREFRONT_CHECK_TERMINAL_STATUSES, STOREFRONT_EDIT_ACTIVITY_TIMEOUT_MINUTES, STOREFRONT_EDIT_CAPACITY, STOREFRONT_EDIT_IDLE_MINUTES, STOREFRONT_EDIT_PREVIEW_SUFFIX, STOREFRONT_EDIT_START_STAGES, STOREFRONT_FILE_BATCH_MAX, STOREFRONT_FILE_MAX_BYTES, STOREFRONT_PATH_SEGMENT_PATTERN, STOREFRONT_SEARCH_REGEX_MAX_LENGTH, STOREFRONT_SITE_CREATE_LIMIT, STOREFRONT_SLUG_CHANGE_LIMIT, STOREFRONT_SLUG_CHANGE_WINDOW_DAYS, STOREFRONT_SLUG_HOLD_DAYS, STOREFRONT_SLUG_PATTERN, STOREFRONT_WORKSPACE_MAX_BYTES, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_FAILURE_REASONS, WEBHOOK_HEADERS, WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES, WEBHOOK_RESOURCE_TYPES, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addressChangeRequestListSchema, addressTypeSchema, agentPolicyDecisionSchema, allocateByWeight, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approvalDecisionRequestSchema, approvalListQuerySchema, approvalPageSchema, approvalRequestSchema, approvalStatusSchema, approveClaimResultSchema, auditActorSchema, auditActorTypeSchema, auditLogListQuerySchema, auditLogOutcomeSchema, auditLogPageSchema, auditLogSchema, auditLogSourceSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeStorefrontSlugRequestSchema, changeStorefrontTemplateRequestSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, consentActionSchema, consentKindSchema, consentSourceSchema, couponBenefitSchema, couponConditionsInputSchema, couponConditionsSchema, couponDiscountOf, couponIssueListQuerySchema, couponIssueMethodSchema, couponIssueSchema, couponIssueStatusSchema, couponKindSchema, couponListQuerySchema, couponRedemptionListQuerySchema, couponRedemptionSchema, couponRejectReasonSchema, couponRuleSchema, couponSchema, couponStatsSchema, couponStatusSchema, couponTargetInputSchema, couponTargetSchema, createCouponRequestSchema, createPkcePair, createStoreClient, createStoreSession, createStorefrontEditPreviewLinkRequestSchema, createStorefrontPreviewLinkRequestSchema, createStorefrontSiteRequestSchema, createStorefrontVersionRequestSchema, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerCouponSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deleteStorefrontFileRequestSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, disableStorefrontHostingRequestSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, fulfillBulkRequestSchema, fulfillRequestSchema, fulfillmentRuleOf, fulfillmentTypeOf, fulfillmentTypeResponseSchema, fulfillmentTypeSchema, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationDeliveryStatusSchema, invitationListQuerySchema, invitationSchema, inviteMemberRequestSchema, isCouponTargetLine, isEditableStorefrontPath, isReservedStoreCode, isReservedStorefrontSlug, isStoreScope, isWebOrigin, issueCouponRequestSchema, issueCouponResultSchema, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, mcpRuleResultSchema, mcpToolEventSchema, moveStorefrontFileRequestSchema, myAccountSchema, myStoreSchema, normalizeCouponCode, normalizeStorefrontPath, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, openFulfillmentUnion, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderCanceledWebhookEventDataSchema, orderCanceledWebhookEventSchema, orderDiscountSchema, orderFulfilledWebhookEventDataSchema, orderFulfilledWebhookEventSchema, orderItemFulfillmentSchema, orderItemFulfillmentSnapshotResponseSchema, orderItemFulfillmentSnapshotSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productFulfillmentCreateSchema, productFulfillmentResponseSchema, productFulfillmentSchema, productFulfillmentUpdateSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productRefundPolicyPatchSchema, productReplaceRequestSchema, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedPaidRefundBase, proratedRefundBase, publishStorefrontVersionRequestSchema, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, quoteDelivery, quotePricing, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, remoteAreaLabelOf, remoteAreaOf, remoteAreaSchema, remoteSurchargeOf, requiresCollection, requiresShipping, resolveRefundPolicy, resolveShippingPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, rollbackStorefrontRequestSchema, runStorefrontCheckRequestSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, searchStorefrontFilesRequestSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, setStorefrontVisibilityRequestSchema, settleCouponShortfall, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, storefrontBuildListQuerySchema, storefrontBuildSchema, storefrontBuildStatusSchema, storefrontCheckSchema, storefrontCheckStatusSchema, storefrontDomainSchema, storefrontEditPreviewLabelOf, storefrontEditPreviewSchema, storefrontEditSessionSchema, storefrontEditSessionStatusSchema, storefrontEditingSchema, storefrontFileConflictDetailsSchema, storefrontFileContentQuerySchema, storefrontFileContentSchema, storefrontFileDeleteResultSchema, storefrontFileEncodingSchema, storefrontFileEntrySchema, storefrontFileHashSchema, storefrontFileListQuerySchema, storefrontFileListSchema, storefrontFileMoveResultSchema, storefrontFilePathSchema, storefrontFileSearchResultSchema, storefrontFileWriteResultSchema, storefrontHostingSchema, storefrontPreviewLinkSchema, storefrontProvisioningSchema, storefrontRuleResultSchema, storefrontRuleSeveritySchema, storefrontSiteSchema, storefrontSiteStatusSchema, storefrontSlugAvailabilityQuerySchema, storefrontSlugAvailabilitySchema, storefrontSlugSchema, storefrontSourceModeSchema, storefrontTemplateSchema, storefrontVerifyReportSchema, storefrontVersionCreatedSchema, storefrontVersionSchema, storefrontVersionStatusSchema, storefrontVisibilitySchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, updateCouponRequestSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updateMemberRoleRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema, writeDryRunResultSchema, writePreviewSchema, writeStorefrontFilesRequestSchema };
+export { APPROVAL_ALREADY_DECIDED_CODE, APPROVAL_REQUIRED_CODE, ApiError, ApprovalPendingError, CASH_RECEIPT_STATUS_VALUES, COUPON_CODE_PATTERN, COUPON_CONDITIONS_DEFAULTS, COUPON_TARGET_ALL, COUPON_TARGET_LIST_MAX, CUSTOM_INPUT_FORBIDDEN_WORDS, FULFILLMENT_RULES, MAX_ADDON_GROUPS, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_CUSTOM_INPUTS, MAX_CUSTOM_INPUT_LENGTH, MAX_OPTION_GROUPS, MAX_PRODUCT_IMAGES, MAX_SAVED_OPTION_SETS, MAX_SAVED_OPTION_SET_NAME, MAX_VALUES_PER_GROUP, MAX_VARIANTS, MCP_TELEMETRY_MAX_RESULTS, MIN_PAYMENT_AMOUNT, NO_COUPON_SETTLEMENT, NO_SHIPPING_BUNDLE_KEY, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, REFUND_POLICY_DELIVERY_FEE_KEYS, REMOTE_AREA_ZIP_RANGES, RESERVED_STOREFRONT_SLUGS, RESERVED_STORE_CODES, SHIPPING_POLICY_DEFAULTS, STOREFRONT_BLOCKED_PATH_SEGMENTS, STOREFRONT_BUILD_STAGES, STOREFRONT_BUILD_TERMINAL_STATUSES, STOREFRONT_CHECK_TERMINAL_STATUSES, STOREFRONT_CUSTOM_DOMAIN_LIMIT_DEFAULT, STOREFRONT_DOMAIN_DNS_GRACE_DAYS, STOREFRONT_DOMAIN_DNS_WAIT_DAYS, STOREFRONT_DOMAIN_TXT_LABEL, STOREFRONT_EDIT_ACTIVITY_TIMEOUT_MINUTES, STOREFRONT_EDIT_CAPACITY, STOREFRONT_EDIT_IDLE_MINUTES, STOREFRONT_EDIT_PREVIEW_SUFFIX, STOREFRONT_EDIT_START_STAGES, STOREFRONT_FILE_BATCH_MAX, STOREFRONT_FILE_MAX_BYTES, STOREFRONT_PATH_SEGMENT_PATTERN, STOREFRONT_PLATFORM_DOMAINS, STOREFRONT_PUBLIC_SUFFIXES, STOREFRONT_SEARCH_REGEX_MAX_LENGTH, STOREFRONT_SITE_CREATE_LIMIT, STOREFRONT_SLUG_CHANGE_LIMIT, STOREFRONT_SLUG_CHANGE_WINDOW_DAYS, STOREFRONT_SLUG_HOLD_DAYS, STOREFRONT_SLUG_PATTERN, STOREFRONT_SOURCE_BLOB_BATCH_MAX, STOREFRONT_SOURCE_PART_BYTES, STOREFRONT_WORKSPACE_MAX_BYTES, STOREFRONT_WORKSPACE_MAX_FILES, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, VARIANT_COUNT_WARNING, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_FAILURE_REASONS, WEBHOOK_HEADERS, WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES, WEBHOOK_RESOURCE_TYPES, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addStorefrontDomainRequestSchema, addonGroupRequestSchema, addonGroupSchema, addonValueRequestSchema, addonValueSchema, addressChangeRequestListSchema, addressTypeSchema, agentPolicyDecisionSchema, allocateByWeight, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approvalDecisionRequestSchema, approvalListQuerySchema, approvalPageSchema, approvalRequestSchema, approvalStatusSchema, approveClaimResultSchema, auditActorSchema, auditActorTypeSchema, auditLogListQuerySchema, auditLogOutcomeSchema, auditLogPageSchema, auditLogSchema, auditLogSourceSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeStorefrontSlugRequestSchema, changeStorefrontTemplateRequestSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, consentActionSchema, consentKindSchema, consentSourceSchema, couponBenefitSchema, couponConditionsInputSchema, couponConditionsSchema, couponDiscountOf, couponIssueListQuerySchema, couponIssueMethodSchema, couponIssueSchema, couponIssueStatusSchema, couponKindSchema, couponListQuerySchema, couponRedemptionListQuerySchema, couponRedemptionSchema, couponRejectReasonSchema, couponRuleSchema, couponSchema, couponStatsSchema, couponStatusSchema, couponTargetInputSchema, couponTargetSchema, createCouponRequestSchema, createPkcePair, createStoreClient, createStoreSession, createStorefrontEditPreviewLinkRequestSchema, createStorefrontPreviewLinkRequestSchema, createStorefrontSiteRequestSchema, createStorefrontVersionRequestSchema, customInputLabelForbiddenWord, customInputRequestSchema, customInputSchema, customInputValueSchema, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerCouponSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deleteStorefrontFileRequestSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, disableStorefrontHostingRequestSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, fulfillBulkRequestSchema, fulfillRequestSchema, fulfillmentRuleOf, fulfillmentTypeOf, fulfillmentTypeResponseSchema, fulfillmentTypeSchema, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationDeliveryStatusSchema, invitationListQuerySchema, invitationSchema, inviteMemberRequestSchema, isCouponTargetLine, isEditableStorefrontPath, isReservedStoreCode, isReservedStorefrontSlug, isStoreScope, isWebOrigin, issueCouponRequestSchema, issueCouponResultSchema, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, mcpRuleResultSchema, mcpToolEventSchema, moveStorefrontFileRequestSchema, myAccountSchema, myStoreSchema, normalizeCouponCode, normalizeStorefrontHostname, normalizeStorefrontPath, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, openFulfillmentUnion, optionGroupKindSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionSelectionSchema, optionSortSchema, optionValueRequestSchema, optionValueSchema, orderCanceledWebhookEventDataSchema, orderCanceledWebhookEventSchema, orderDiscountSchema, orderFulfilledWebhookEventDataSchema, orderFulfilledWebhookEventSchema, orderItemFulfillmentSchema, orderItemFulfillmentSnapshotResponseSchema, orderItemFulfillmentSnapshotSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productFulfillmentCreateSchema, productFulfillmentResponseSchema, productFulfillmentSchema, productFulfillmentUpdateSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productRefundPolicyPatchSchema, productReplaceRequestSchema, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedPaidRefundBase, proratedRefundBase, publishStorefrontVersionRequestSchema, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, quoteDelivery, quotePricing, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, remoteAreaLabelOf, remoteAreaOf, remoteAreaSchema, remoteSurchargeOf, replaceStorefrontSourceRequestSchema, requiresCollection, requiresShipping, resolveRefundPolicy, resolveShippingPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, rollbackStorefrontRequestSchema, runStorefrontCheckRequestSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, savedCustomInputRequestSchema, savedCustomInputSchema, savedOptionGroupRequestSchema, savedOptionGroupSchema, savedOptionSetCompositionSchema, savedOptionSetFromProductRequestSchema, savedOptionSetFromProductResultSchema, savedOptionSetListQuerySchema, savedOptionSetRequestSchema, savedOptionSetSchema, savedOptionSetSortSchema, savedOptionValueRequestSchema, savedOptionValueSchema, scopeAccessSchema, searchStorefrontFilesRequestSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, setStorefrontVisibilityRequestSchema, settleCouponShortfall, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, storefrontBuildDependenciesSchema, storefrontBuildListQuerySchema, storefrontBuildSchema, storefrontBuildStatusSchema, storefrontCheckSchema, storefrontCheckStatusSchema, storefrontCustomDomainStatusSchema, storefrontCustomHostnameProblem, storefrontDependencyFindingSchema, storefrontDnsRecordSchema, storefrontDomainSchema, storefrontDomainTxtNameOf, storefrontEditPreviewLabelOf, storefrontEditPreviewSchema, storefrontEditSessionSchema, storefrontEditSessionStatusSchema, storefrontEditingSchema, storefrontFileConflictDetailsSchema, storefrontFileContentQuerySchema, storefrontFileContentSchema, storefrontFileDeleteResultSchema, storefrontFileEncodingSchema, storefrontFileEntrySchema, storefrontFileHashSchema, storefrontFileListQuerySchema, storefrontFileListSchema, storefrontFileMoveResultSchema, storefrontFilePathSchema, storefrontFileSearchResultSchema, storefrontFileWriteResultSchema, storefrontHostingSchema, storefrontPreviewLinkSchema, storefrontProvisioningSchema, storefrontRuleResultSchema, storefrontRuleSeveritySchema, storefrontSiteDomainSchema, storefrontSiteDomainsSchema, storefrontSiteSchema, storefrontSiteStatusSchema, storefrontSlugAvailabilityQuerySchema, storefrontSlugAvailabilitySchema, storefrontSlugSchema, storefrontSourceArchivePartSchema, storefrontSourceArchiveQuerySchema, storefrontSourceBlobsResultSchema, storefrontSourceModeSchema, storefrontSourceRefSchema, storefrontSourceReplacedSchema, storefrontSourceSchema, storefrontSuspensionSchema, storefrontTemplateSchema, storefrontVerifyReportSchema, storefrontVersionCreatedSchema, storefrontVersionSchema, storefrontVersionStatusSchema, storefrontVisibilitySchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, updateCouponRequestSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updateMemberRoleRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadStorefrontSourceBlobsRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema, writeDryRunResultSchema, writePreviewSchema, writeStorefrontFilesRequestSchema };