@sayren/store-sdk 0.20.0 → 0.21.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("주문 수량"),
@@ -3111,401 +3604,149 @@ const cancelBySellerRequestSchema = z.object({
 * 제공 처리 요청 (이슈 #48) — `POST /v1/order-items/{orderItemId}/fulfill`. 배송 없는 주문상품(`MANUAL`)을
 * 제공 완료(`DELIVERED`)로 바꾼다.
 */
-const fulfillRequestSchema = z.object({ note: z.string().trim().max(1e3).optional().describe("구매자에게 보일 이용 안내(예: 예약 방법, 수령 장소). 주문 상세에 실린다") });
-/** 제공 처리 일괄 요청 — `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 fulfillRequestSchema = z.object({ note: z.string().trim().max(1e3).optional().describe("구매자에게 보일 이용 안내(예: 예약 방법, 수령 장소). 주문 상세에 실린다") });
+/** 제공 처리 일괄 요청 — `POST /v1/order-items/fulfill` */
+const fulfillBulkRequestSchema = z.object({
+	orderItemIds: z.array(z.string()).min(1).max(100),
+	note: fulfillRequestSchema.shape.note
 });
-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()
+/** `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()
 });
-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()
+/** `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` — 호스팅 끄기 확인 입력이 현재 슬러그와 다르다
@@ -4325,6 +4567,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 +4589,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()
 });
@@ -4907,6 +5158,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 } }),
@@ -5607,7 +5873,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 +6148,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_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_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, 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, 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, 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, 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, storefrontSuspensionSchema, 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 };