@sayren/store-sdk 0.19.0 → 0.21.0

package/dist/index.mjs

@@ -975,7 +975,7 @@ const claimSchema = z.object({
 		carrierCode: z.string().nullable(),
 		trackingNumber: z.string().nullable()
 	}).nullable(),
-	fulfillmentType: z.string().optional().default("SHIPPING").describe("클레임 대상 주문상품의 상품 유형(이슈 #48). 수거가 없는 비실물(`DOWNLOAD`·`CODE`·`SERVICE`) 반품은 수거 등록 없이 접수·보류에서 바로 승인한다. 값이 추가될 수 있어 문자열로 받는다. 서버는 항상 싣는다"),
+	fulfillmentType: z.string().optional().default("SHIPPING").describe("클레임 대상 주문상품의 상품 유형(이슈 #48). 배송 없는 상품(`MANUAL`) 반품은 수거 등록 없이 접수·보류에서 바로 승인한다. 값이 추가될 수 있어 문자열로 받는다. 서버는 항상 싣는다"),
 	requestedAt: z.string(),
 	completedAt: z.string().nullable(),
 	/** 보류 중이면 자동 해제 시각(ISO 8601), 아니면 null */
@@ -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;
 /**
@@ -2031,140 +2032,6 @@ const customerWithdrawalBlockedDetailsSchema = z.object({
 	pendingPayments: z.number().int()
 });
 //#endregion
-//#region src/schemas/digital-asset.ts
-/**
-* 파일 다운로드 상품의 판매 파일 (이슈 #48 단계 3).
-*
-* 파일은 CDN **비공개 객체**다. `POST /v1/uploads`(`purpose: "digital-asset"`)로 자리를 받아 응답의 `headers`와 함께 PUT하고,
-* 응답의 `key`로 상품에 연결한다. 객체 키와 파일 주소는 어떤 응답에도 싣지 않는다 — 구매자는 제공된 주문상품에서
-* 수명 300초의 서명 주소로만 받는다. 주문은 주문 시점 파일을 스냅샷하므로 파일을 바꿔도 이미 산 구매자는 옛 파일을 받는다.
-*/
-const digitalAssetAttachRequestSchema = z.object({
-	key: z.string().min(1).max(512).describe("업로드 자리 발급 응답의 `key`. 이 스토어의 비공개 업로드 키여야 한다"),
-	fileName: z.string().trim().min(1).max(200).describe("구매자에게 보일 파일 이름(확장자 포함)"),
-	sizeBytes: z.number().int().positive().optional().describe("파일 크기(바이트). 안내용이다"),
-	contentType: z.string().max(200).optional().describe("파일 형식(MIME). 안내용이다"),
-	variantId: z.string().optional().describe("이 파일을 줄 옵션(variant). 생략하면 모든 옵션의 구매자가 받는다")
-});
-/** 판매 파일 — 객체 키·주소는 싣지 않는다 */
-const digitalAssetSchema = z.object({
-	assetId: z.string(),
-	productId: z.string(),
-	variantId: z.string().nullable().describe("옵션 전용 파일이면 그 옵션, 모든 옵션 공통이면 null"),
-	fileName: z.string(),
-	contentType: z.string().nullable(),
-	sizeBytes: z.number().int().nullable(),
-	status: z.string().describe("`ACTIVE`(새 주문에 제공)·`REMOVED`(해제 — 이미 산 구매자는 계속 받는다). 값이 추가될 수 있어 문자열로 받는다"),
-	createdAt: z.string()
-});
-/** 셀러 확인용 서명 주소 — `POST /v1/products/{productId}/digital-assets/{assetId}/preview-url` */
-const digitalAssetPreviewSchema = z.object({
-	url: z.url().describe("수명 300초의 서명 주소"),
-	expiresAt: z.string()
-});
-/** 주문상품의 다운로드 제공 정보 — 주문 응답의 `fulfillment.download` */
-const orderItemDownloadSchema = z.object({
-	count: z.number().int().describe("지금까지 받은 횟수"),
-	limit: z.number().int().describe("받을 수 있는 횟수"),
-	expiresAt: z.string().nullable().describe("받을 수 있는 기한 (ISO 8601)"),
-	firstDownloadedAt: z.string().nullable().describe("처음 받은 시각 — 제공 개시 증거다"),
-	files: z.array(z.object({
-		assetId: z.string(),
-		fileName: z.string(),
-		sizeBytes: z.number().int().nullable()
-	}))
-});
-//#endregion
-//#region src/schemas/fulfillment-code.ts
-/**
-* 코드 발급 상품의 코드 풀 (이슈 #48 단계 2) — 라이선스 키·기프트 코드처럼 결제 확정과 함께 한 개씩 배정하는 코드다.
-*
-* **평문 코드는 두 경로로만 나간다** — 구매자 열람(`POST /storefront/v1/me/order-items/{id}/fulfillment/reveal`)과 셀러 콘솔
-* 열람(`POST /v1/fulfillment-codes/{codeId}/reveal`, 콘솔 전용). 목록·주문·웹훅·API 로그에는 가린 값(`hint`)만 싣는다.
-* 코드는 결제 자격 증명과 같은 키링·AES-256-GCM으로 암호화해 저장한다.
-*/
-/**
-* 코드 상태.
-* - `AVAILABLE` 판매 가능 — 재고로 센다
-* - `ASSIGNED` 주문상품에 배정됨
-* - `REVOKED` 환불로 회수됨(구매자 화면에서 숨긴다. 코드 자체의 무효화는 셀러 시스템 몫이다)
-* - `EXPIRED` 유효기간이 지나 배정하지 않음
-* - `VOID` 셀러가 폐기함
-*/
-const fulfillmentCodeStatusSchema = z.enum([
-	"AVAILABLE",
-	"ASSIGNED",
-	"REVOKED",
-	"EXPIRED",
-	"VOID"
-]);
-/** 한 번에 올릴 수 있는 코드 수 */
-const MAX_CODES_PER_UPLOAD = 1e4;
-/** 코드 한 개의 최대 길이 */
-const MAX_CODE_LENGTH = 200;
-/**
-* 코드 일괄 업로드 요청 — `POST /v1/products/{productId}/codes`. `codes`(배열)와 `csv`(본문) 중 하나를 보낸다.
-* 앞뒤 공백은 지우고 빈 줄은 건너뛴다. 같은 상품에 이미 있는 코드와 요청 안의 중복은 받지 않는다(`duplicates`).
-*/
-const fulfillmentCodeUploadRequestSchema = z.object({
-	variantId: z.string().optional().describe("코드를 채울 옵션(variant) ID. 옵션 없는 상품은 생략한다(기본 옵션)"),
-	codes: z.array(z.string()).max(MAX_CODES_PER_UPLOAD).optional().describe(`코드 목록. 한 번에 ${MAX_CODES_PER_UPLOAD}개까지. \`csv\`와 둘 중 하나만 보낸다`),
-	csv: z.string().max(4e6).optional().describe(`CSV 본문 — 줄마다 첫 칸이 코드다. 첫 줄의 첫 칸이 \`code\`면 머리글로 보고 건너뛴다. 한 번에 ${MAX_CODES_PER_UPLOAD}줄까지`),
-	expiresAt: z.iso.datetime({ offset: true }).optional().describe("이 업로드 코드의 유효기간 (ISO 8601). 지나면 배정하지 않고 만료로 바꾼다")
-}).refine((value) => value.codes === void 0 !== (value.csv === void 0), { message: "codes와 csv 중 하나만 보내야 합니다" });
-/** 받지 않은 줄 */
-const fulfillmentCodeRejectionSchema = z.object({
-	line: z.number().int().describe("요청 안의 위치 (1부터). CSV는 머리글을 포함한 줄 번호다"),
-	reason: z.string().describe("사유. `DUPLICATE`(이미 있는 코드이거나 요청 안에서 겹침)·`TOO_LONG`(200자 초과)·`INVALID_CHARACTER`(제어 문자). 값이 추가될 수 있어 문자열로 받는다")
-});
-/** 업로드 결과 — 배치 요약 */
-const fulfillmentCodeBatchSchema = z.object({
-	batchId: z.string(),
-	productId: z.string(),
-	variantId: z.string(),
-	total: z.number().int().describe("요청에서 읽은 코드 수(빈 줄·머리글 제외)"),
-	accepted: z.number().int().describe("받은 코드 수 — 재고가 이만큼 는다"),
-	duplicates: z.number().int().describe("중복이라 받지 않은 코드 수"),
-	rejected: z.array(fulfillmentCodeRejectionSchema).describe("받지 않은 줄(중복 포함). 최대 1,000개까지 싣는다"),
-	expiresAt: z.string().nullable(),
-	createdAt: z.string()
-});
-/** 코드 목록의 한 줄 — **가린 값만** 싣는다 */
-const fulfillmentCodeSchema = z.object({
-	codeId: z.string(),
-	productId: z.string(),
-	variantId: z.string(),
-	batchId: z.string().nullable().describe("업로드 배치. 수동 제공으로 셀러가 넘긴 코드는 null"),
-	hint: z.string().describe("가린 코드 — 끝 4자만 보인다(예: `****AB12`)"),
-	status: z.string().describe("코드 상태. `AVAILABLE`·`ASSIGNED`·`REVOKED`·`EXPIRED`·`VOID`. 값이 추가될 수 있어 문자열로 받는다"),
-	orderItemId: z.string().nullable().describe("배정된 주문상품. 배정 전이면 null"),
-	assignedAt: z.string().nullable(),
-	revealedAt: z.string().nullable().describe("구매자가 처음 열람한 시각 — 제공 개시 증거다"),
-	expiresAt: z.string().nullable(),
-	createdAt: z.string()
-});
-const fulfillmentCodePageSchema = pageSchema(fulfillmentCodeSchema).extend({ available: z.number().int().describe("판매 가능한 코드 수(필터와 무관한 상품 전체)") });
-/** `GET /v1/products/{productId}/codes` 쿼리 */
-const fulfillmentCodeListQuerySchema = z.object({
-	status: fulfillmentCodeStatusSchema.optional().describe("상태 필터"),
-	variantId: z.string().optional().describe("옵션 필터"),
-	batchId: z.string().optional().describe("업로드 배치 필터"),
-	orderItemId: z.string().optional().describe("주문상품 필터"),
-	...pageQueryShape()
-});
-/** 셀러 콘솔 코드 열람 응답 — `POST /v1/fulfillment-codes/{codeId}/reveal` */
-const fulfillmentCodeRevealSchema = z.object({
-	codeId: z.string(),
-	code: z.string().describe("코드 평문. 응답은 캐시하지 않는다(`Cache-Control: no-store`)")
-});
-/** 주문상품에 배정된 코드의 가린 값 — 주문 응답의 `fulfillment.codes` */
-const orderItemCodeSchema = z.object({
-	codeId: z.string(),
-	hint: z.string().describe("가린 코드 — 끝 4자만 보인다"),
-	status: z.string().describe("`ASSIGNED`(유효)·`REVOKED`(환불로 회수). 값이 추가될 수 있어 문자열로 받는다"),
-	revealedAt: z.string().nullable().describe("구매자가 처음 열람한 시각. 열람 전이면 null")
-});
-//#endregion
 //#region src/schemas/login.ts
 /** 소셜 로그인 공급자 */
 const loginProviderSchema = z.enum([
@@ -2507,83 +2374,43 @@ const reviewReportResultSchema = z.object({
 //#endregion
 //#region src/schemas/fulfillment.ts
 /**
-* 상품 유형과 제공 방식 (이슈 #48) — 배송이 필요 없는 상품을 팔기 위한 축이다.
+* 상품 유형 (이슈 #48·#57) — 배송이 필요한 상품과 필요 없는 상품을 가르는 축이다.
 *
-* **상품 유형은 제공 방식 하나로 표현한다.** `fulfillmentType` 한 필드가 배송 필요 여부, 이행 흐름, 재고 의미를 정한다.
+* **상품 유형은 이행 방식 하나로 표현한다.** `fulfillment.type`이 배송 필요 여부, 이행 흐름, 클레임 규칙을 정한다.
 * 코드 곳곳에서 유형 이름으로 분기하지 않고 이 파일의 판정 함수(`requiresShipping`·`fulfillmentRuleOf`)를 지난다.
-* 유형이 늘어나도 판정표 한 곳만 고치면 배송비 계산·결제 시작·클레임·콘솔 버튼이 같이 따라온다.
 *
 * 주문상품 상태 enum은 바꾸지 않는다. 비실물의 **제공 완료는 `DELIVERED`를 재사용한다** — 새 상태를 더하면 기존 소비자의
-* 상태 분기(배송완료 뒤 구매확정 대기, 반품 가능 판정)가 새 값을 모른다. 표시는 `fulfillmentType`으로 가른다.
+* 상태 분기(배송완료 뒤 구매확정 대기, 반품 가능 판정)가 새 값을 모른다. 표시는 유형으로 가른다.
 */
 /**
 * 상품 유형.
-* - `SHIPPING` 배송 상품(기본, 이 필드 이전의 상품 전부)
-* - `DOWNLOAD` 파일 다운로드
-* - `CODE` 코드 발급(라이선스 키·기프트 코드)
-* - `SERVICE` 이용권·상품권·서비스(예약 없음)
-* - `PICKUP` 방문 수령 실물
+* - `SHIPPING` 배송 상품. 택배로 발송하고 송장·배송 추적으로 배송완료가 된다
+* - `MANUAL` 배송 없는 상품(비실물). 셀러가 제공 처리(`POST /v1/order-items/{orderItemId}/fulfill`)로 제공 완료를 기록한다
+*
+* 비실물의 세부 구분(파일 다운로드·코드 발급·이용권·방문 수령)은 2026-09-28에 제품에서 뺐다(이슈 #48 범위 축소).
+* 이름은 이행 방식이다 — `SHIPPING`이 택배 발송이듯 `MANUAL`은 셀러가 직접 제공한다는 뜻이다.
 */
-const fulfillmentTypeSchema = z.enum([
-	"SHIPPING",
-	"DOWNLOAD",
-	"CODE",
-	"SERVICE",
-	"PICKUP"
-]);
-/** 제공 방식 — `AUTO`는 결제 확정과 함께 제공하고, `MANUAL`은 셀러가 제공 처리한다 */
-const fulfillmentModeSchema = z.enum(["AUTO", "MANUAL"]);
+const fulfillmentTypeSchema = z.enum(["SHIPPING", "MANUAL"]);
 /**
 * 응답 스키마용 유형 — 서버가 나중에 유형을 더해도 옛 SDK가 응답 파싱에서 깨지지 않게 문자열로 받는다.
 * 요청은 `fulfillmentTypeSchema`(닫힌 enum)로 검증한다.
 */
-const fulfillmentTypeResponseSchema = z.string().describe("상품 유형. 현재 값은 `SHIPPING`(배송 상품)·`DOWNLOAD`(파일 다운로드)·`CODE`(코드 발급)·`SERVICE`(이용권·서비스)·`PICKUP`(방문 수령)이고 값이 추가될 수 있어 문자열로 받는다");
-/**
-* 유형별 규칙표 — **유일한 원천이다.**
-*
-* `PICKUP`은 실물이라 반품 수거와 교환을 받지만 택배 배송은 없다. `DOWNLOAD`는 결제 즉시 권한을 발급하므로 `AUTO`만,
-* `PICKUP`은 셀러가 수령 완료를 누르므로 `MANUAL`만 둔다.
-*/
+const fulfillmentTypeResponseSchema = z.string().describe("상품 유형. 현재 값은 `SHIPPING`(배송 상품)·`MANUAL`(배송 없는 상품, 셀러가 제공 처리)이고 값이 추가될 수 있어 문자열로 받는다");
+/** 유형별 규칙표 — **유일한 원천이다.** */
 const FULFILLMENT_RULES = {
 	SHIPPING: {
 		requiresShipping: true,
-		modes: [],
-		defaultMode: null,
 		requiresCollection: true,
 		exchangeSupported: true
 	},
-	DOWNLOAD: {
-		requiresShipping: false,
-		modes: ["AUTO"],
-		defaultMode: "AUTO",
-		requiresCollection: false,
-		exchangeSupported: false
-	},
-	CODE: {
-		requiresShipping: false,
-		modes: ["AUTO", "MANUAL"],
-		defaultMode: "AUTO",
-		requiresCollection: false,
-		exchangeSupported: false
-	},
-	SERVICE: {
+	MANUAL: {
 		requiresShipping: false,
-		modes: ["MANUAL", "AUTO"],
-		defaultMode: "MANUAL",
 		requiresCollection: false,
 		exchangeSupported: false
-	},
-	PICKUP: {
-		requiresShipping: false,
-		modes: ["MANUAL"],
-		defaultMode: "MANUAL",
-		requiresCollection: true,
-		exchangeSupported: true
 	}
 };
 /**
-* 저장된 값 → 유형. null·모르는 값은 `SHIPPING`이다 — 이 필드 이전의 주문상품(`order_items.fulfillment_type` null)과
-* 상품은 모두 배송 상품이었다.
+* 저장된 값 → 유형. null·모르는 값은 `SHIPPING`이다 — 이 필드 이전의 상품·주문상품은 모두 배송 상품이었다.
 */
 function fulfillmentTypeOf(value) {
 	const parsed = fulfillmentTypeSchema.safeParse(value);
@@ -2602,16 +2429,6 @@ function requiresCollection(type) {
 	return fulfillmentRuleOf(type).requiresCollection;
 }
 /**
-* 유효 제공 방식 — 요청 값이 유형에 허용되면 그 값, 생략이면 유형 기본값이다. 배송 상품은 null이다.
-* 허용되지 않는 값은 `null`을 돌려주지 않고 호출부가 거부하도록 `undefined`를 돌려준다.
-*/
-function resolveFulfillmentMode(type, mode) {
-	const rule = FULFILLMENT_RULES[type];
-	if (rule.modes.length === 0) return null;
-	if (mode === null || mode === void 0) return rule.defaultMode;
-	return rule.modes.includes(mode) ? mode : void 0;
-}
-/**
 * 배송이 없는 주문상품의 배송 묶음 키 (`order_items.delivery_bundle_key`).
 *
 * null로 두면 환불 정산이 #29 이전 주문의 레거시 폴백(「묶음 = 같은 상품」, 상품의 **현재** 배송비)을 탄다.
@@ -2625,16 +2442,10 @@ const deliveryTypeSchema = z.enum([
 	"PAID",
 	"CONDITIONAL_FREE"
 ]);
-/** 파일 다운로드 기본값 — 횟수 5회·기간 30일(#48 결정 8) */
-const DOWNLOAD_DEFAULTS = {
-	limit: 5,
-	days: 30
-};
 const KNOWN_FULFILLMENT_TYPES = fulfillmentTypeSchema.options;
 const ADDRESS_ID_DESCRIPTIONS = {
 	shipping: "출고지 주소 id(`GET /v1/seller-addresses?type=SHIPPING`). 등록에서 생략하면 그 시점 스토어 기본 출고지를 저장한다. `null`이면 비워 둔다(스토어 기본 출고지를 따른다). 이 스토어의 `SHIPPING` 주소가 아니면 거부한다",
-	return: "반품지 주소 id(`GET /v1/seller-addresses?type=RETURN`). 등록에서 생략하면 그 시점 스토어 기본 반품지를 저장한다. `null`이면 비워 둔다(스토어 기본 반품지를 따른다). 이 스토어의 `RETURN` 주소가 아니면 거부한다",
-	pickup: "방문 수령지 주소 id(`GET /v1/seller-addresses?type=PICKUP`). 등록에서 생략하면 그 시점 스토어 기본 방문 수령지를 저장하고, 기본 방문 수령지도 없으면 400 `PICKUP_ADDRESS_REQUIRED`다. 이 스토어의 `PICKUP` 주소가 아니면 거부한다"
+	return: "반품지 주소 id(`GET /v1/seller-addresses?type=RETURN`). 등록에서 생략하면 그 시점 스토어 기본 반품지를 저장한다. `null`이면 비워 둔다(스토어 기본 반품지를 따른다). 이 스토어의 `RETURN` 주소가 아니면 거부한다"
 };
 /**
 * 배송비 필드 사이의 일관성 — FREE의 배송비, 조건부 무료가 아닌 상품의 무료 기준을 조용히 0·null로 바꿔 저장하지 않고 400으로 돌려준다
@@ -2667,51 +2478,13 @@ const shippingCreateSchema = z.strictObject({
 	shippingAddressId: z.string().nullable().optional().describe(ADDRESS_ID_DESCRIPTIONS.shipping),
 	returnAddressId: z.string().nullable().optional().describe(ADDRESS_ID_DESCRIPTIONS.return)
 }).superRefine(refineShippingConsistency);
-const downloadCreateSchema = z.strictObject({
-	limit: z.number().int().min(1).max(100).default(DOWNLOAD_DEFAULTS.limit).describe("다운로드 횟수 한도(수량 1개당). 생략하면 5회"),
-	days: z.number().int().min(1).max(3650).default(DOWNLOAD_DEFAULTS.days).describe("다운로드 기간(제공일부터 일수). 생략하면 30일"),
-	stockTracking: z.boolean().default(false).describe("재고를 세는가. 생략하면 false(재고와 무관하게 판다)"),
-	withdrawalRestricted: z.boolean().default(false).describe("청약철회 제한 대상인가. true면 주문서가 제한 고지 동의를 받고, 첫 다운로드 뒤 구매자 단순 변심 취소·반품을 받지 않는다")
-});
-const codeCreateSchema = z.strictObject({
-	mode: fulfillmentModeSchema.default("AUTO").describe("제공 방식. `AUTO`는 코드 풀에서 결제 확정과 함께 배정하고, `MANUAL`은 셀러가 제공 처리 때 코드를 넘긴다"),
-	withdrawalRestricted: z.boolean().default(false).describe("청약철회 제한 대상인가. true면 첫 열람 뒤 구매자 단순 변심 취소·반품을 받지 않는다")
-});
-const serviceCreateSchema = z.strictObject({ mode: fulfillmentModeSchema.default("MANUAL").describe("제공 방식. `AUTO`는 결제 확정과 함께 제공 완료, `MANUAL`은 셀러가 제공 처리한다") });
-const pickupCreateSchema = z.strictObject({ addressId: z.string().optional().describe(ADDRESS_ID_DESCRIPTIONS.pickup) });
 /**
-* 상품 이행 — 등록(POST). 유형 키를 생략하면 그 유형의 기본값이다(`{ "type": "DOWNLOAD" }`만으로 등록할 수 있다).
+* 상품 이행 — 등록(POST). 배송 상품의 `shipping`을 생략하면 기본값(유료 배송·스토어 기본 배송비·기본 출고지·반품지)이다.
 */
-const productFulfillmentCreateSchema = z.discriminatedUnion("type", [
-	z.strictObject({
-		type: z.literal("SHIPPING"),
-		shipping: shippingCreateSchema.optional()
-	}),
-	z.strictObject({
-		type: z.literal("DOWNLOAD"),
-		download: downloadCreateSchema.default({
-			limit: DOWNLOAD_DEFAULTS.limit,
-			days: DOWNLOAD_DEFAULTS.days,
-			stockTracking: false,
-			withdrawalRestricted: false
-		})
-	}),
-	z.strictObject({
-		type: z.literal("CODE"),
-		code: codeCreateSchema.default({
-			mode: "AUTO",
-			withdrawalRestricted: false
-		})
-	}),
-	z.strictObject({
-		type: z.literal("SERVICE"),
-		service: serviceCreateSchema.default({ mode: "MANUAL" })
-	}),
-	z.strictObject({
-		type: z.literal("PICKUP"),
-		pickup: pickupCreateSchema.default({})
-	})
-]);
+const productFulfillmentCreateSchema = z.discriminatedUnion("type", [z.strictObject({
+	type: z.literal("SHIPPING"),
+	shipping: shippingCreateSchema.optional()
+}), z.strictObject({ type: z.literal("MANUAL") })]);
 const shippingUpdateSchema = z.strictObject({
 	deliveryType: deliveryTypeSchema.describe(deliveryTypeDescription),
 	deliveryFee: z.number().int().min(0).describe("배송비. 원 단위. FREE면 0"),
@@ -2723,76 +2496,24 @@ const shippingUpdateSchema = z.strictObject({
 * 상품 이행 — 수정(PUT·PATCH). 통째 교체이고 유형 키와 그 안의 필드가 **모두 필수**다. 서버는 현재 값과 병합하지 않는다.
 * `fulfillment` 자체를 생략하면 이행을 바꾸지 않는다.
 */
-const productFulfillmentUpdateSchema = z.discriminatedUnion("type", [
-	z.strictObject({
-		type: z.literal("SHIPPING"),
-		shipping: shippingUpdateSchema
-	}),
-	z.strictObject({
-		type: z.literal("DOWNLOAD"),
-		download: z.strictObject({
-			limit: z.number().int().min(1).max(100),
-			days: z.number().int().min(1).max(3650),
-			stockTracking: z.boolean(),
-			withdrawalRestricted: z.boolean()
-		})
-	}),
-	z.strictObject({
-		type: z.literal("CODE"),
-		code: z.strictObject({
-			mode: fulfillmentModeSchema,
-			withdrawalRestricted: z.boolean()
-		})
-	}),
-	z.strictObject({
-		type: z.literal("SERVICE"),
-		service: z.strictObject({ mode: fulfillmentModeSchema })
-	}),
-	z.strictObject({
-		type: z.literal("PICKUP"),
-		pickup: z.strictObject({ addressId: z.string().describe(ADDRESS_ID_DESCRIPTIONS.pickup) })
-	})
-]);
+const productFulfillmentUpdateSchema = z.discriminatedUnion("type", [z.strictObject({
+	type: z.literal("SHIPPING"),
+	shipping: shippingUpdateSchema
+}), z.strictObject({ type: z.literal("MANUAL") })]);
 /**
 * 저장된 상품 이행 — 알려진 유형의 닫힌 유니온. 서버의 상품 엔티티와 응답이 이 모양을 쓴다.
 * 응답 파싱은 `productFulfillmentResponseSchema`(열린 유니온)를 쓴다.
 */
-const productFulfillmentSchema = z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("SHIPPING"),
-		shipping: z.object({
-			deliveryType: deliveryTypeSchema,
-			deliveryFee: z.number().int().describe("배송비. 원 단위. FREE면 0"),
-			conditionalFreeAmount: z.number().int().nullable().describe("조건부 무료 기준 묶음 소계. CONDITIONAL_FREE가 아니면 null"),
-			shippingAddressId: z.string().nullable().describe("출고지 주소 id. null이면 스토어 기본 출고지를 따른다"),
-			returnAddressId: z.string().nullable().describe("반품지 주소 id. null이면 스토어 기본 반품지를 따른다")
-		})
-	}),
-	z.object({
-		type: z.literal("DOWNLOAD"),
-		download: z.object({
-			limit: z.number().int().describe("다운로드 횟수 한도(수량 1개당)"),
-			days: z.number().int().describe("다운로드 기간(제공일부터 일수)"),
-			stockTracking: z.boolean().describe("재고를 세는가"),
-			withdrawalRestricted: z.boolean().describe("청약철회 제한 대상인가")
-		})
-	}),
-	z.object({
-		type: z.literal("CODE"),
-		code: z.object({
-			mode: fulfillmentModeSchema.describe("제공 방식"),
-			withdrawalRestricted: z.boolean().describe("청약철회 제한 대상인가")
-		})
-	}),
-	z.object({
-		type: z.literal("SERVICE"),
-		service: z.object({ mode: fulfillmentModeSchema.describe("제공 방식") })
-	}),
-	z.object({
-		type: z.literal("PICKUP"),
-		pickup: z.object({ addressId: z.string().nullable().describe("방문 수령지 주소 id. null은 수령지가 지워진 상품이다(수령지를 다시 지정할 때까지 팔 수 없다)") })
+const productFulfillmentSchema = z.discriminatedUnion("type", [z.object({
+	type: z.literal("SHIPPING"),
+	shipping: z.object({
+		deliveryType: deliveryTypeSchema,
+		deliveryFee: z.number().int().describe("배송비. 원 단위. FREE면 0"),
+		conditionalFreeAmount: z.number().int().nullable().describe("조건부 무료 기준 묶음 소계. CONDITIONAL_FREE가 아니면 null"),
+		shippingAddressId: z.string().nullable().describe("출고지 주소 id. null이면 스토어 기본 출고지를 따른다"),
+		returnAddressId: z.string().nullable().describe("반품지 주소 id. null이면 스토어 기본 반품지를 따른다")
 	})
-]);
+}), z.object({ type: z.literal("MANUAL") })]);
 /**
 * 열린 응답 유니온 — 알려진 유형은 판별 유니온으로 검사하고, **모르는 유형만** `{ type: "OTHER", rawType }`로 읽는다.
 *
@@ -2806,72 +2527,18 @@ function openFulfillmentUnion(known) {
 	}))]);
 }
 const productFulfillmentResponseSchema = openFulfillmentUnion(productFulfillmentSchema).describe("상품 이행. `type`이 유형이고 같은 이름의 키가 유형별 속성이다. 값이 추가될 수 있어 SDK는 모르는 유형을 `{ type: \"OTHER\", rawType }`로 읽는다");
-/** 제공 방식 — CODE·SERVICE는 저장된 값, DOWNLOAD는 AUTO, PICKUP은 MANUAL, 배송 상품은 null */
-function fulfillmentModeOf(fulfillment) {
-	switch (fulfillment.type) {
-		case "CODE": return fulfillment.code.mode;
-		case "SERVICE": return fulfillment.service.mode;
-		default: return FULFILLMENT_RULES[fulfillment.type].defaultMode;
-	}
-}
-/** 재고를 세는가 — 파일 다운로드만 끌 수 있다 */
-function stockTrackingOf(fulfillment) {
-	return fulfillment.type === "DOWNLOAD" ? fulfillment.download.stockTracking : true;
-}
-/** 청약철회 제한 대상인가 — 파일 다운로드·코드 발급만 켤 수 있다(전자상거래법 제17조 제2항 제5호, 디지털 콘텐츠) */
-function withdrawalRestrictedOf(fulfillment) {
-	if (fulfillment.type === "DOWNLOAD") return fulfillment.download.withdrawalRestricted;
-	if (fulfillment.type === "CODE") return fulfillment.code.withdrawalRestricted;
-	return false;
-}
-/** 코드 풀을 쓰는가 — 코드 발급 + 자동 제공. 재고가 판매 가능 코드 수다 */
-function usesCodePool(fulfillment) {
-	return fulfillment.type === "CODE" && fulfillment.code.mode === "AUTO";
-}
-/** 결제 확정과 함께 제공까지 끝내는가 — 비실물 + 자동 제공 */
-function autoFulfillableOf(fulfillment) {
-	return !FULFILLMENT_RULES[fulfillment.type].requiresShipping && fulfillmentModeOf(fulfillment) === "AUTO";
-}
 /**
 * 주문상품의 주문 시점 이행 — 결제 확정이 주문서 줄에서 굳힌다. 상품의 현재 값이 아니다. 서버는 주문상품 컬럼
-* (`fulfillment_type`·`delivery_bundle_key`·`stock_tracked`·`withdrawal_restricted`)과 jsonb(`fulfillment_snapshot`)를 합쳐 이 모양을 만든다.
-*
-* `mode`는 **주문 시점 상품의 방식**이다. 실제 제공 방식은 제공 기록(`fulfillment.mode`)에 있고 다를 수 있다(자동 제공 상품의 수동 복구).
+* (`fulfillment_type`·`delivery_bundle_key`)과 jsonb(`fulfillment_snapshot`)를 합쳐 이 모양을 만든다.
 */
-const orderItemFulfillmentSnapshotSchema = z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("SHIPPING"),
-		shipping: z.object({
-			bundleKey: z.string().nullable().describe("배송 묶음 키. 같은 키의 주문상품이 배송비를 한 번 낸 한 묶음이다. #29 이전 주문은 null"),
-			returnAddressId: z.string().nullable().describe("주문 시점 반품지 주소 id. null이거나 지워진 주소면 스토어 기본 반품지로 안내한다")
-		})
-	}),
-	z.object({
-		type: z.literal("DOWNLOAD"),
-		download: z.object({
-			limit: z.number().int().describe("주문 시점 다운로드 횟수 한도(수량 1개당)"),
-			days: z.number().int().describe("주문 시점 다운로드 기간(제공일부터 일수)"),
-			stockTracked: z.boolean().describe("주문 시점에 재고를 뺐는가"),
-			withdrawalRestricted: z.boolean().describe("구매자가 제한 고지에 동의한 청약철회 제한 주문상품인가")
-		})
-	}),
-	z.object({
-		type: z.literal("CODE"),
-		code: z.object({
-			mode: z.string().describe("주문 시점 상품의 제공 방식. 현재 값은 `AUTO`·`MANUAL`"),
-			withdrawalRestricted: z.boolean().describe("구매자가 제한 고지에 동의한 청약철회 제한 주문상품인가")
-		})
-	}),
-	z.object({
-		type: z.literal("SERVICE"),
-		service: z.object({ mode: z.string().describe("주문 시점 상품의 제공 방식. 현재 값은 `AUTO`·`MANUAL`") })
-	}),
-	z.object({
-		type: z.literal("PICKUP"),
-		pickup: z.object({ addressId: z.string().nullable().describe("주문 시점 방문 수령지 주소 id") })
+const orderItemFulfillmentSnapshotSchema = z.discriminatedUnion("type", [z.object({
+	type: z.literal("SHIPPING"),
+	shipping: z.object({
+		bundleKey: z.string().nullable().describe("배송 묶음 키. 같은 키의 주문상품이 배송비를 한 번 낸 한 묶음이다. #29 이전 주문은 null"),
+		returnAddressId: z.string().nullable().describe("주문 시점 반품지 주소 id. null이거나 지워진 주소면 스토어 기본 반품지로 안내한다")
 	})
-]);
-const orderItemFulfillmentSnapshotResponseSchema = openFulfillmentUnion(orderItemFulfillmentSnapshotSchema).describe("주문 시점 이행 스냅샷. 상품을 나중에 고쳐도 바뀌지 않는다. 실제 제공 기록은 `fulfillment`에 있다. 값이 추가될 수 있어 SDK는 모르는 유형을 `OTHER`로 읽는다");
+}), z.object({ type: z.literal("MANUAL") })]);
+const orderItemFulfillmentSnapshotResponseSchema = openFulfillmentUnion(orderItemFulfillmentSnapshotSchema).describe("주문 시점 이행 스냅샷. 상품을 나중에 고쳐도 바뀌지 않는다. 제공 기록은 `fulfillment`에 있다. 값이 추가될 수 있어 SDK는 모르는 유형을 `OTHER`로 읽는다");
 //#endregion
 //#region src/schemas/payment.ts
 /**
@@ -3221,507 +2888,327 @@ const paymentListQuerySchema = z.object({
 	size: z.string().optional().describe("페이지 크기 (기본 20, 최대 100)")
 });
 //#endregion
-//#region src/schemas/order.ts
-const orderSummarySchema = z.object({
-	orderId: z.string(),
-	ordererName: z.string(),
-	itemCount: z.number().int(),
-	totalAmount: z.number().int(),
-	representativeStatus: orderItemStatusSchema,
-	orderedAt: z.string(),
-	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다. 상품을 발송하지 않도록 주의하십시오")
+//#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 shippingAddressSchema = z.object({
-	receiverName: z.string(),
-	phone: z.string(),
-	zipCode: z.string(),
-	address1: z.string(),
-	address2: z.string().nullish(),
-	deliveryMemo: z.string().nullish(),
-	entranceCode: z.string().nullish()
+const uploadTicketSchema = z.object({
+	/** 업로드 완료 후 공개될 주소 */
+	url: z.url(),
+	/** 파일 바이트를 PUT할 presigned URL. 1시간 유효 */
+	uploadUrl: z.url()
 });
-/** 비실물 주문상품의 제공 정보 (이슈 #48) */
-const orderItemFulfillmentSchema = z.object({
-	status: z.string().describe("제공 상태. `FULFILLED`(제공함)·`REVOKED`(환불 등으로 회수함). 값이 추가될 수 있어 문자열로 받는다"),
-	mode: z.string().nullable().describe("제공 방식. `AUTO`·`MANUAL`"),
-	fulfilledAt: z.string().describe("제공 시각 (ISO 8601)"),
-	note: z.string().nullable().describe("셀러가 남긴 이용 안내. 없으면 null"),
-	codes: z.array(orderItemCodeSchema).optional().default([]).describe("코드 발급 상품에 배정한 코드의 가린 값. 평문은 싣지 않는다. 코드 상품이 아니면 빈 배열. 서버는 항상 싣는다"),
-	download: orderItemDownloadSchema.nullable().optional().default(null).describe("파일 다운로드 상품의 횟수·기한·파일 목록. 파일 주소는 싣지 않는다. 다른 유형은 null. 서버는 항상 싣는다"),
-	mail: z.object({
-		status: z.string().describe("제공 안내 메일 상태. 현재 값은 `PENDING`(보낼 예정)·`SENDING`·`SENT`·`FAILED`·`SKIPPED`(보내지 않음: 스토어 설정 꺼짐·받을 주소 없음)이고 값이 추가될 수 있다"),
-		sentAt: z.string().nullable(),
-		errorCode: z.string().nullable().describe("실패·건너뜀 사유 코드")
-	}).nullable().optional().default(null).describe("구매자에게 보낸 제공 안내 메일(이슈 #48). 기록이 없으면 null. 서버는 항상 싣는다")
-});
-/** 제공 안내 메일 재발송 결과 */
-const fulfillmentMailResendSchema = z.object({ mailStatus: z.string().describe("재발송 뒤 메일 상태 — `SENT`·`PENDING`(곧 다시 보낸다)·`FAILED`·`SKIPPED`") });
-const orderItemSchema = z.object({
-	orderItemId: z.string(),
-	orderId: z.string(),
-	status: orderItemStatusSchema,
-	claimStatus: z.enum([
-		"CANCEL_REQUESTED",
-		"RETURN_REQUESTED",
-		"EXCHANGE_REQUESTED"
-	]).nullable(),
+//#endregion
+//#region src/schemas/product.ts
+const productStatusSchema = z.enum([
+	"SALE",
+	"SUSPENDED",
+	"OUT_OF_STOCK",
+	"CLOSED"
+]);
+const productSummarySchema = z.object({
 	productId: z.string(),
-	productName: z.string(),
-	optionId: z.string().nullable(),
-	optionName: z.string().nullable(),
-	sellerCode: z.string().nullable(),
-	fulfillmentSnapshot: orderItemFulfillmentSnapshotResponseSchema.describe("주문 시점 이행 스냅샷(이슈 #57). `type`이 주문 시점 상품 유형이다. 배송 상품이 아니면 발송·배송완료 대신 제공 처리를 하고, `DELIVERED`는 제공 완료(방문 수령은 수령 완료)다. 상품을 나중에 고쳐도 바뀌지 않는다. 실제 제공 기록은 `fulfillment`에 있다"),
-	quantity: z.number().int().describe("주문 수량"),
-	canceledQuantity: z.number().int().describe("취소·반품으로 환불된 누적 수량. 수량 단위 부분 취소가 없었으면 0이다"),
-	activeQuantity: z.number().int().describe("살아 있는 수량 (`quantity` − `canceledQuantity`). 0이면 주문상품이 전량 취소됐다"),
-	unitPrice: z.number().int(),
-	discountAmount: z.number().int(),
-	totalPrice: z.number().int().describe("주문상품 금액 (즉시할인 반영 단가 × 주문 수량). 쿠폰 할인 전 금액이다"),
-	couponDiscountAmount: z.number().int().optional().default(0).describe("이 주문상품에 배분된 쿠폰 할인 — 상품 쿠폰 + 주문 쿠폰 배분. 실결제 금액은 `totalPrice − couponDiscountAmount`이고 취소·반품 환불은 실결제 금액을 수량 비율로 나눈다. 쿠폰이 없으면 0. 서버는 항상 싣는다"),
-	hold: z.object({
-		reason: z.string(),
-		expectedDispatchDate: z.string()
-	}).nullable(),
-	fulfillment: orderItemFulfillmentSchema.nullable().optional().default(null).describe("비실물 상품의 제공 정보(이슈 #48). 제공 전이거나 배송 상품이면 null이다. 코드 평문·파일 주소는 싣지 않는다. 서버는 항상 싣는다"),
-	autoDecisionDate: z.string().nullable(),
-	sellerMemo: z.string().nullable(),
-	orderedAt: z.string(),
-	lastChangedAt: z.string(),
-	lastChangedType: changeTypeSchema,
-	testPayment: z.boolean().describe("소속 주문이 테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다")
+	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()
 });
-/** 주문이 받은 쿠폰 한 장 (이슈 #47) */
-const orderDiscountSchema = z.object({
-	couponId: z.string().describe("쿠폰 id"),
-	name: z.string().describe("주문 시점 쿠폰 이름"),
-	kind: z.string().describe("쿠폰 종류. 현재 값은 `ORDER`(주문 쿠폰)·`PRODUCT`(상품 쿠폰)·`DELIVERY`(배송비 쿠폰)이고 값이 추가될 수 있어 문자열로 받는다"),
-	discountAmount: z.number().int().describe("이 쿠폰의 할인액 (원)"),
-	issueId: z.string().nullable().describe("발급 쿠폰 id. 코드 입력형은 null")
+/** 옵션 축(그룹)이 가지는 값 하나 — 예: 축 "색상"의 값 "블랙" */
+const optionValueSchema = z.object({
+	valueId: z.string(),
+	name: z.string(),
+	sortOrder: z.number().int()
 });
-const orderSchema = z.object({
-	orderId: z.string(),
-	orderedAt: z.string(),
-	orderer: z.object({
-		name: z.string(),
-		phone: z.string(),
-		email: z.email().optional()
-	}),
-	requiresShipping: z.boolean().optional().default(true).describe("택배 배송이 필요한 주문상품이 있는가. false면 `shippingAddress`는 주문자 이름·연락처만 있고 주소는 빈 문자열이다. 서버는 항상 싣는다"),
-	shippingAddress: shippingAddressSchema,
-	payment: z.object({
-		method: z.enum([
-			"CARD",
-			"BANK_TRANSFER",
-			"VIRTUAL_ACCOUNT",
-			"MOBILE",
-			"POINT",
-			"MIXED"
-		]).describe("method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다"),
-		approvedMethod: z.string().nullable().optional().default(null).describe("실제 결제수단. method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다. 현재 값은 `pgPaymentMethodSchema`(`PgPaymentMethod`: CARD·BANK_TRANSFER·VIRTUAL_ACCOUNT·MOBILE·EASY_PAY)이고 매출 리포트·스토어프론트·환불 원장과 같은 값이다. 값이 추가될 수 있어 문자열로 받는다. PG가 알려 주지 않았으면 요청 수단, 시도 기록이 없는 오래된 주문은 null. 서버는 항상 싣는다"),
-		easyPayProvider: easyPayProviderResponseSchema.nullable().optional().default(null).describe("승인된 간편결제사. `approvedMethod`가 `EASY_PAY`일 때만 값이 있고, PG가 알려 주지 않았으면 요청한 간편결제사다. 그 밖의 결제수단과 간편결제 이전 주문은 null. 서버는 항상 싣는다. 현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 값이 추가될 수 있어 문자열로 받는다"),
-		productAmount: z.number().int().describe("상품 금액 합 (즉시할인 반영, 쿠폰 전)"),
-		deliveryFee: z.number().int().describe("배송비 (쿠폰 전)"),
-		discountAmount: z.number().int().describe("즉시할인 합 (정가 − 할인 단가) × 수량. 쿠폰 할인은 `couponDiscountAmount`로 따로 온다"),
-		couponDiscountAmount: z.number().int().optional().default(0).describe("상품·주문 쿠폰 할인 합계. 쿠폰이 없으면 0. 서버는 항상 싣는다"),
-		deliveryDiscountAmount: z.number().int().optional().default(0).describe("배송비 쿠폰 할인. 쿠폰이 없으면 0. 서버는 항상 싣는다"),
-		discounts: z.array(orderDiscountSchema).optional().default([]).describe("주문이 받은 쿠폰. 쿠폰이 없으면 빈 배열. 서버는 항상 싣는다"),
-		totalAmount: z.number().int().describe("결제 금액 = productAmount + deliveryFee − couponDiscountAmount − deliveryDiscountAmount. 쿠폰이 없는 주문은 productAmount + deliveryFee다"),
-		paidAt: z.string().nullable(),
-		cashReceipt: cashReceiptSchema.nullable().optional().default(null).describe("현금영수증. 구매자가 계좌이체·가상계좌 결제에서 신청했을 때만 있고 그 밖에는 null. 서버는 항상 싣는다")
-	}),
-	withdrawalAgreedAt: z.string().nullable().optional().default(null).describe("청약철회 제한 안내에 동의한 시각(이슈 #48). 제한 상품이 없던 주문은 null. 서버는 항상 싣는다"),
-	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다. 상품을 발송하지 않도록 주의하십시오"),
-	items: z.array(orderItemSchema)
+/** 옵션 축(그룹) — 예: "색상", "사이즈" */
+const optionGroupSchema = z.object({
+	groupId: z.string(),
+	name: z.string(),
+	sortOrder: z.number().int(),
+	values: z.array(optionValueSchema)
 });
-/** 주문 목록 응답 — `GET /v1/orders` */
-const orderSummaryPageSchema = pageSchema(orderSummarySchema);
-/** 주문상품 변경 목록 응답 — `GET /v1/order-items` */
-const orderItemPageSchema = pageSchema(orderItemSchema);
-const testPaymentQuery = z.enum(["true", "false"]).optional().describe("테스트 결제(샌드박스 결제) 필터. `true`면 테스트 결제만, `false`면 실결제만, 생략하면 전부입니다");
-const pageQuery = { page: z.string().optional().describe("페이지 번호 (1부터, 기본 1)") };
 /**
-* `GET /v1/orders` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 검증 규칙은 서버가 적용한다:
-* `orderedFrom` 누락 400 `MISSING_PARAMETER`, 날짜 형식 오류 400 `INVALID_PARAMETER`, 31일 초과 400 `RANGE_TOO_WIDE`,
-* `testPayment`가 `true`·`false`가 아니면 400 `INVALID_PARAMETER`
+* 판매 단위(SKU). variantId는 기존 optionId 값 공간을 승계하므로
+* 카트·주문·리뷰·클레임의 optionId가 곧 variantId다.
 */
-const orderListQuerySchema = z.object({
-	orderedFrom: z.string().describe("조회 시작 시각 (ISO 8601 날짜 또는 일시, 포함). 필수"),
-	orderedTo: z.string().optional().describe("조회 끝 시각 (ISO 8601, 포함). 생략하면 orderedFrom부터 31일. 기간은 최대 31일"),
-	status: orderItemStatusSchema.optional().describe("주문상품 상태 필터 — 이 상태의 주문상품이 하나라도 있는 주문"),
-	keyword: z.string().optional().describe("주문번호(일치)·주문자명·수령인명(포함) 검색"),
-	fulfillmentType: z.string().optional().describe("상품 유형 필터(이슈 #48) — 이 유형(`SHIPPING`·`DOWNLOAD`·`CODE`·`SERVICE`·`PICKUP`)의 주문상품이 하나라도 있는 주문"),
-	testPayment: testPaymentQuery,
-	...pageQuery,
-	size: z.string().optional().describe("페이지 크기 (기본 20, 최대 100)")
+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;
 /**
-* `GET /v1/order-items` 쿼리 — OpenAPI 문서용 형태. `lastChangedFrom` 누락 400 `MISSING_PARAMETER`, 형식 오류 400
-* `INVALID_PARAMETER`, 24시간 초과 400 `RANGE_TOO_WIDE`, `testPayment` 값 오류 400 `INVALID_PARAMETER`
+* 옵션 값 정렬 순서 — 등록순·가나다순·낮은 추가금순·높은 추가금순. 서버가 저장할 때 이 순서로 값의 `sortOrder`를 매긴다.
+* 추가금순은 추가 선택 값이면 값의 추가금, 조합 값이면 그 값이 든 조합 추가금의 최솟값으로 비교하고 같으면 등록순이다.
 */
-const orderItemListQuerySchema = z.object({
-	lastChangedFrom: z.string().describe("마지막 변경 시각 조회 시작 (ISO 8601, 포함). 필수"),
-	lastChangedTo: z.string().optional().describe("마지막 변경 시각 조회 끝 (ISO 8601, 포함). 생략하면 시작부터 24시간. 기간은 최대 24시간"),
-	lastChangedType: changeTypeSchema.optional().describe("마지막 변경 유형 필터"),
-	testPayment: testPaymentQuery,
-	...pageQuery,
-	size: z.string().optional().describe("페이지 크기 (기본 100, 최대 300)")
-});
-const deliveryMethodSchema = z.enum([
-	"COURIER",
-	"DIRECT",
-	"QUICK",
-	"NOTHING"
+const optionSortSchema = z.enum([
+	"REGISTERED",
+	"NAME",
+	"PRICE_ASC",
+	"PRICE_DESC"
 ]);
-const dispatchRequestSchema = z.object({
-	deliveryMethod: deliveryMethodSchema,
-	carrierCode: z.string().optional(),
-	trackingNumber: z.string().optional(),
-	/**
-	* 발송 시각. ISO 8601이고 시간대(`Z` 또는 `+09:00`)를 포함해야 한다. 생략하면 현재 시각이다.
-	*
-	* 전에는 `z.string()`이라 아무 문자열이나 그대로 저장됐다. 이 값은 배송 정보 jsonb에 들어가
-	* 자동 배송완료·추적 동기화 잡의 대상 선별 조건이 된다 — 잘못된 한 행이 스토어 구분 없이 도는
-	* 잡 전체를 멈출 수 있어 입력에서 좁혔다. 검증을 통과한 값도 저장 전에 UTC ISO로 정규화한다.
-	*/
-	dispatchedAt: z.iso.datetime({ offset: true }).optional()
-}).refine((value) => value.deliveryMethod === "DIRECT" || value.deliveryMethod === "NOTHING" ? true : !!value.carrierCode && !!value.trackingNumber, { message: "COURIER/QUICK 발송은 carrierCode와 trackingNumber가 필수입니다" });
-const deliveryInfoSchema = z.object({
-	orderItemId: z.string(),
-	deliveryMethod: deliveryMethodSchema,
-	carrierCode: z.string().nullable(),
-	carrierName: z.string().nullable(),
-	trackingNumber: z.string().nullable(),
-	trackingUrl: z.url().nullable(),
-	status: z.enum([
-		"DISPATCHED",
-		"DELIVERING",
-		"DELIVERED"
-	]),
-	dispatchedAt: z.string(),
-	deliveredAt: z.string().nullable()
-});
-/**
-* 택배 추적 단계. 응답에서는 문자열로 받는다(값이 추가될 수 있다) — 현재 값은 `ACCEPTED`(접수)·`IN_TRANSIT`(이동 중)·
-* `OUT_FOR_DELIVERY`(배송 출발)·`DELIVERED`(배송완료)다.
-*/
-const trackingStageResponseSchema = z.string();
-/** `GET /v1/order-items/{orderItemId}/delivery` 응답 — 배송 정보 + 배송 추적 이벤트 */
-const deliveryStatusSchema = deliveryInfoSchema.extend({
-	trackingEvents: z.array(z.object({
-		status: z.string().describe("택배사가 알려 준 처리 내용(예: 집화처리, 배송출발)"),
-		location: z.string().describe("처리 장소. 모르면 빈 문자열"),
-		occurredAt: z.string(),
-		stage: trackingStageResponseSchema.nullable().optional().default(null).describe("이 이벤트의 추적 단계. 배달 실패처럼 단계로 나눌 수 없는 이벤트는 null. 서버는 항상 싣는다. 현재 값은 `ACCEPTED`·`IN_TRANSIT`·`OUT_FOR_DELIVERY`·`DELIVERED`이고 값이 추가될 수 있어 문자열로 받는다")
-	})).optional().describe("배송 추적 이력. 시각 오름차순(오래된 것부터)"),
-	tracking: z.object({
-		result: z.string().nullable().describe("마지막 추적 조회 결과. 조회에 성공한 적이 없으면 null. 현재 값은 `FOUND`(조회됨)·`NOT_FOUND`(택배사 전산에 송장 없음)·`UNSUPPORTED_CARRIER`(추적을 지원하지 않는 택배사)이고 값이 추가될 수 있어 문자열로 받는다"),
-		stage: trackingStageResponseSchema.nullable().describe("현재 추적 단계. 조회되지 않았으면 null. 현재 값은 `ACCEPTED`·`IN_TRANSIT`·`OUT_FOR_DELIVERY`·`DELIVERED`이고 값이 추가될 수 있어 문자열로 받는다"),
-		checkedAt: z.string().nullable().describe("택배사에서 추적 정보를 마지막으로 받아 온 시각(ISO 8601)"),
-		carrierDeliveredAt: z.string().nullable().describe("택배사가 알려 준 배송완료 시각(ISO 8601). 추적으로 배송완료가 반영되면 주문상품의 `deliveredAt`은 반영 시각이라 이 값과 다를 수 있다")
-	}).nullable().optional().default(null).describe("택배 추적 요약. 택배 발송이 아니거나 추적을 쓰지 않으면 null. 추적이 배송완료면 주문상품이 자동으로 배송완료된다. 서버는 항상 싣는다")
-});
-/** `PUT /v1/order-items/{orderItemId}/dispatch/tracking` 응답 — 바뀐 송장 */
-const trackingUpdateResultSchema = z.object({
-	orderItemId: z.string(),
-	carrierCode: z.string(),
-	trackingNumber: z.string()
-});
-const carrierSchema = z.object({
-	carrierCode: z.string(),
+/** 추가 선택 값 — 예: 옵션명 "선물 포장"의 값 "포장함"(+2,000원) */
+const addonValueSchema = z.object({
+	valueId: z.string(),
 	name: z.string(),
-	trackingUrlTemplate: z.string()
-});
-const holdOrderItemRequestSchema = z.object({
-	reason: z.enum([
-		"OUT_OF_STOCK",
-		"CUSTOMER_REQUEST",
-		"CUSTOMS",
-		"ETC"
-	]),
-	detail: z.string().max(500).optional(),
-	expectedDispatchDate: z.string()
+	sortOrder: z.number().int(),
+	additionalPrice: z.number().int().describe("이 값을 고르면 단가에 더하는 금액(원, 0 이상)"),
+	usable: z.boolean().describe("사용 여부. false면 구매자에게 보이지 않고 고를 수 없다")
 });
-const cancelBySellerRequestSchema = z.object({
-	reason: z.enum([
-		"OUT_OF_STOCK",
-		"PRICE_ERROR",
-		"DELIVERY_IMPOSSIBLE",
-		"ETC"
-	]),
-	detail: z.string().max(500).optional(),
-	quantity: z.number().int().min(1).optional().describe("취소할 수량. 생략하면 남은 수량 전체다. 남은 수량보다 크면 400 `INVALID_QUANTITY`. 일부만 취소하면 주문상품은 상태를 유지한 채 `canceledQuantity`가 늘고, 전 수량이 소진되면 `CANCELED`가 된다")
+/** 추가 선택 옵션명 */
+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()
 });
 /**
-* 제공 처리 요청 (이슈 #48) — `POST /v1/order-items/{orderItemId}/fulfill`. 수동 제공 비실물 주문상품(이용권·방문 수령 등)을
-* 제공 완료(`DELIVERED`)로 바꾼다.
+* 직접 입력 항목명에 쓸 수 없는 개인정보성 단어 — 콘솔 검사와 서버 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. 공백·기호·대소문자·전각을 무시한다.
+* 서버는 항목명과 입력 안내 둘 다 이 함수로 검사한다(안내에 「연락처를 적어 주십시오」라고 쓰는 우회를 막는다).
 */
-const fulfillRequestSchema = z.object({
-	note: z.string().trim().max(1e3).optional().describe("구매자에게 보일 이용 안내(예: 예약 방법, 수령 장소). 주문 상세에 실린다"),
-	codes: z.array(z.string().trim().min(1).max(200)).min(1).max(100).optional().describe("수동 제공 코드 발급 상품의 코드 — 셀러 시스템이 발급한 코드를 넘긴다. 남은 수량만큼 보낸다(`CODE_COUNT_MISMATCH`). 암호화해 저장하고 구매자가 열람할 때만 평문으로 나간다. 다른 유형은 보내지 않는다")
+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)
 });
-/** 제공 처리 일괄 요청 — `POST /v1/order-items/fulfill` */
-const fulfillBulkRequestSchema = z.object({
-	orderItemIds: z.array(z.string()).min(1).max(100),
-	note: fulfillRequestSchema.shape.note
+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)
 });
-/** `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()
+/**
+* 주문상품·장바구니·주문서 줄의 옵션 선택 스냅샷 한 칸 — 주문 시점 이름이다(상품을 고쳐도 바뀌지 않는다).
+* 조합 옵션은 옵션명마다 한 칸이고 추가금은 조합 단위라 0이다(조합 추가금은 단가에 들어 있다). 추가 선택은 값의 추가금이다.
+*/
+const optionSelectionSchema = z.object({
+	kind: z.string().describe("옵션명 방식. 현재 값은 `combination`·`addon`이고 값이 추가될 수 있어 문자열로 받는다"),
+	groupName: z.string(),
+	valueName: z.string(),
+	additionalPrice: z.number().int()
 });
-/** `PUT /v1/order-items/{orderItemId}/memo` 응답 — 빈 문자열로 저장하면 메모가 지워져 `null`이다 */
-const orderItemMemoResultSchema = z.object({
-	orderItemId: z.string(),
-	sellerMemo: z.string().nullable()
+/** 구매자가 적은 직접 입력값 — 주문 시점 항목명과 값 */
+const customInputValueSchema = z.object({
+	label: z.string(),
+	value: z.string()
 });
-/** `POST /v1/order-items/{orderItemId}/purchase-decision/request` 응답 */
-const purchaseDecisionRequestResultSchema = z.object({
-	orderItemId: z.string(),
-	requestedAt: 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()
 });
-/** `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 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;
 /**
-* `GET /v1/orders/{orderId}/address-change-requests` 응답 — 배송지 변경 요청 플로우는 아직 제공하지 않아
-* 현재는 항상 빈 배열이다
+* 상품 이미지 주소의 와이어 형식 — URL이고 2048자 이하다.
+*
+* https·확장자 규칙은 여기서 강제하지 않고 `productImageRejection`이 판정한다. 서버가
+* **새로 추가된 주소에만** 그 규칙을 적용해야 하기 때문이다(규칙이 생기기 전에 저장된
+* 주소 하나로 상품 수정 전체가 막히면 셀러가 빠져나갈 길이 없다).
+*
+* 응답 스키마(`productSchema.images`)도 넓게 둔다. 과거에 저장된 주소를 파싱 오류로
+* 만들면 상품 조회 자체가 막힌다.
 */
-const addressChangeRequestListSchema = z.array(z.record(z.string(), z.unknown())).describe("배송지 변경 요청 목록 (현재 항상 빈 배열)");
-//#endregion
-//#region src/schemas/upload.ts
+const productImageUrlSchema = z.url().max(2048).describe("상품 이미지 주소. https만 허용하고, 확장자가 있으면 이미지 형식이어야 한다");
 /**
-* 업로드 용도. 허용 확장자와 크기 상한이 용도별로 다르다.
-*
-* - `product-image`: 상품 목록·상세의 상품 이미지. 목록 썸네일로 쓰이므로 정지 이미지만 받는다.
-* - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
-* - `digital-asset`: 파일 다운로드 상품의 판매 파일(이슈 #48). **비공개 객체**로 올라가고 공개 주소가 없다 — 구매자는 제공된
-*   주문상품에서 수명 300초의 서명 주소로만 받는다.
-*/
-const uploadPurposeSchema = z.enum([
-	"product-image",
-	"description",
-	"digital-asset"
-]);
-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
-	},
-	"digital-asset": {
-		extensions: [
-			"pdf",
-			"epub",
-			"zip",
-			"mp3",
-			"wav",
-			"flac",
-			"m4a",
-			"mp4",
-			"mov",
-			"jpg",
-			"jpeg",
-			"png",
-			"webp",
-			"psd",
-			"ai",
-			"txt",
-			"csv",
-			"xlsx",
-			"docx",
-			"pptx"
-		],
-		maxBytes: 200 * MB
-	}
-};
-/** 비공개 업로드(판매 파일)의 PUT 필수 헤더 — CDN이 이 값으로 공개 조회를 막는다 */
-const PRIVATE_UPLOAD_HEADERS = { "x-amz-meta-visibility": "private" };
-/** 파일명의 소문자 확장자. 확장자가 없으면 `""` */
-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({
-	/** 업로드 완료 후 공개될 주소. 비공개 업로드(`digital-asset`)는 이 주소로 받을 수 없다 */
-	url: z.url(),
-	/** 파일 바이트를 PUT할 presigned URL. 1시간 유효 */
-	uploadUrl: z.url(),
-	key: z.string().optional().describe("객체 키. 비공개 업로드(`digital-asset`)는 이 값으로 상품에 파일을 연결한다(`POST /v1/products/{productId}/digital-assets`). 공개 업로드에는 없다"),
-	headers: z.record(z.string(), z.string()).optional().default({}).describe("PUT에 반드시 실을 헤더. 비공개 업로드는 `x-amz-meta-visibility: private`이고 빠뜨리면 공개 객체가 된다. 공개 업로드는 빈 객체다")
-});
-//#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()
-});
-/** 상품 하나에 등록할 수 있는 이미지 최대 장수 — 첫 장이 대표(썸네일)다 */
-const MAX_PRODUCT_IMAGES = 10;
-/**
-* 상품 이미지 주소의 와이어 형식 — URL이고 2048자 이하다.
-*
-* https·확장자 규칙은 여기서 강제하지 않고 `productImageRejection`이 판정한다. 서버가
-* **새로 추가된 주소에만** 그 규칙을 적용해야 하기 때문이다(규칙이 생기기 전에 저장된
-* 주소 하나로 상품 수정 전체가 막히면 셀러가 빠져나갈 길이 없다).
-*
-* 응답 스키마(`productSchema.images`)도 넓게 둔다. 과거에 저장된 주소를 파싱 오류로
-* 만들면 상품 조회 자체가 막힌다.
-*/
-const productImageUrlSchema = z.url().max(2048).describe("상품 이미지 주소. https만 허용하고, 확장자가 있으면 이미지 형식이어야 한다");
-/**
-* 상품에 **새로 붙이는** 이미지 주소의 규칙. 통과하면 `null`.
+* 상품에 **새로 붙이는** 이미지 주소의 규칙. 통과하면 `null`.
 *
 * - https만 받는다. http는 https 스토어프론트에서 혼합 콘텐츠로 차단되고 `data:`·`javascript:`는
 *   상세 화면에 박히는 주입 경로가 된다.
@@ -3755,139 +3242,511 @@ function productImageRejection(url) {
 	};
 	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이 나간다.
+* 식별 코드 — 빈 문자열·공백만 있는 값은 거부한다.
+* `""`를 통과시키면 서버 중복 사전 검사(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(),
+	ordererName: z.string(),
+	itemCount: z.number().int(),
+	totalAmount: z.number().int(),
+	representativeStatus: orderItemStatusSchema,
+	orderedAt: z.string(),
+	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다. 상품을 발송하지 않도록 주의하십시오")
+});
+const shippingAddressSchema = z.object({
+	receiverName: z.string(),
+	phone: z.string(),
+	zipCode: z.string(),
+	address1: z.string(),
+	address2: z.string().nullish(),
+	deliveryMemo: z.string().nullish(),
+	entranceCode: z.string().nullish()
+});
+/** 배송 없는 주문상품(`MANUAL`)의 제공 기록 (이슈 #48) — 셀러의 제공 처리가 만든다 */
+const orderItemFulfillmentSchema = z.object({
+	status: z.string().describe("제공 상태. `FULFILLED`(제공함)·`REVOKED`(전량 취소·환불로 회수함). 값이 추가될 수 있어 문자열로 받는다"),
+	fulfilledAt: z.string().describe("제공 시각 (ISO 8601)"),
+	note: z.string().nullable().describe("셀러가 제공 처리 때 남긴 이용 안내. 없으면 null"),
+	mode: z.string().optional().describe("**Deprecated** — 항상 `MANUAL`이다. 자동 제공을 없앴고(이슈 #48) store-sdk 0.19 이하 호환으로만 싣는다. 게시된 연동이 store-sdk 0.20 이상으로 넘어간 뒤 다음 릴리스에서 뺀다")
+});
+const orderItemSchema = z.object({
+	orderItemId: z.string(),
+	orderId: z.string(),
+	status: orderItemStatusSchema,
+	claimStatus: z.enum([
+		"CANCEL_REQUESTED",
+		"RETURN_REQUESTED",
+		"EXCHANGE_REQUESTED"
+	]).nullable(),
+	productId: z.string(),
+	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("주문 수량"),
+	canceledQuantity: z.number().int().describe("취소·반품으로 환불된 누적 수량. 수량 단위 부분 취소가 없었으면 0이다"),
+	activeQuantity: z.number().int().describe("살아 있는 수량 (`quantity` − `canceledQuantity`). 0이면 주문상품이 전량 취소됐다"),
+	unitPrice: z.number().int(),
+	discountAmount: z.number().int(),
+	totalPrice: z.number().int().describe("주문상품 금액 (즉시할인 반영 단가 × 주문 수량). 쿠폰 할인 전 금액이다"),
+	couponDiscountAmount: z.number().int().optional().default(0).describe("이 주문상품에 배분된 쿠폰 할인 — 상품 쿠폰 + 주문 쿠폰 배분. 실결제 금액은 `totalPrice − couponDiscountAmount`이고 취소·반품 환불은 실결제 금액을 수량 비율로 나눈다. 쿠폰이 없으면 0. 서버는 항상 싣는다"),
+	hold: z.object({
+		reason: z.string(),
+		expectedDispatchDate: z.string()
+	}).nullable(),
+	fulfillment: orderItemFulfillmentSchema.nullable().optional().default(null).describe("배송 없는 상품의 제공 기록(이슈 #48). 제공 전이거나 배송 상품이면 null이다. 서버는 항상 싣는다"),
+	autoDecisionDate: z.string().nullable(),
+	sellerMemo: z.string().nullable(),
+	orderedAt: z.string(),
+	lastChangedAt: z.string(),
+	lastChangedType: changeTypeSchema,
+	testPayment: z.boolean().describe("소속 주문이 테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다")
+});
+/** 주문이 받은 쿠폰 한 장 (이슈 #47) */
+const orderDiscountSchema = z.object({
+	couponId: z.string().describe("쿠폰 id"),
+	name: z.string().describe("주문 시점 쿠폰 이름"),
+	kind: z.string().describe("쿠폰 종류. 현재 값은 `ORDER`(주문 쿠폰)·`PRODUCT`(상품 쿠폰)·`DELIVERY`(배송비 쿠폰)이고 값이 추가될 수 있어 문자열로 받는다"),
+	discountAmount: z.number().int().describe("이 쿠폰의 할인액 (원)"),
+	issueId: z.string().nullable().describe("발급 쿠폰 id. 코드 입력형은 null")
+});
+const orderSchema = z.object({
+	orderId: z.string(),
+	orderedAt: z.string(),
+	orderer: z.object({
+		name: z.string(),
+		phone: z.string(),
+		email: z.email().optional()
+	}),
+	requiresShipping: z.boolean().optional().default(true).describe("택배 배송이 필요한 주문상품이 있는가. false면 `shippingAddress`는 주문자 이름·연락처만 있고 주소는 빈 문자열이다. 서버는 항상 싣는다"),
+	shippingAddress: shippingAddressSchema,
+	payment: z.object({
+		method: z.enum([
+			"CARD",
+			"BANK_TRANSFER",
+			"VIRTUAL_ACCOUNT",
+			"MOBILE",
+			"POINT",
+			"MIXED"
+		]).describe("method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다"),
+		approvedMethod: z.string().nullable().optional().default(null).describe("실제 결제수단. method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다. 현재 값은 `pgPaymentMethodSchema`(`PgPaymentMethod`: CARD·BANK_TRANSFER·VIRTUAL_ACCOUNT·MOBILE·EASY_PAY)이고 매출 리포트·스토어프론트·환불 원장과 같은 값이다. 값이 추가될 수 있어 문자열로 받는다. PG가 알려 주지 않았으면 요청 수단, 시도 기록이 없는 오래된 주문은 null. 서버는 항상 싣는다"),
+		easyPayProvider: easyPayProviderResponseSchema.nullable().optional().default(null).describe("승인된 간편결제사. `approvedMethod`가 `EASY_PAY`일 때만 값이 있고, PG가 알려 주지 않았으면 요청한 간편결제사다. 그 밖의 결제수단과 간편결제 이전 주문은 null. 서버는 항상 싣는다. 현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 값이 추가될 수 있어 문자열로 받는다"),
+		productAmount: z.number().int().describe("상품 금액 합 (즉시할인 반영, 쿠폰 전)"),
+		deliveryFee: z.number().int().describe("배송비 (쿠폰 전)"),
+		discountAmount: z.number().int().describe("즉시할인 합 (정가 − 할인 단가) × 수량. 쿠폰 할인은 `couponDiscountAmount`로 따로 온다"),
+		couponDiscountAmount: z.number().int().optional().default(0).describe("상품·주문 쿠폰 할인 합계. 쿠폰이 없으면 0. 서버는 항상 싣는다"),
+		deliveryDiscountAmount: z.number().int().optional().default(0).describe("배송비 쿠폰 할인. 쿠폰이 없으면 0. 서버는 항상 싣는다"),
+		discounts: z.array(orderDiscountSchema).optional().default([]).describe("주문이 받은 쿠폰. 쿠폰이 없으면 빈 배열. 서버는 항상 싣는다"),
+		totalAmount: z.number().int().describe("결제 금액 = productAmount + deliveryFee − couponDiscountAmount − deliveryDiscountAmount. 쿠폰이 없는 주문은 productAmount + deliveryFee다"),
+		paidAt: z.string().nullable(),
+		cashReceipt: cashReceiptSchema.nullable().optional().default(null).describe("현금영수증. 구매자가 계좌이체·가상계좌 결제에서 신청했을 때만 있고 그 밖에는 null. 서버는 항상 싣는다")
+	}),
+	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다. 상품을 발송하지 않도록 주의하십시오"),
+	items: z.array(orderItemSchema)
+});
+/** 주문 목록 응답 — `GET /v1/orders` */
+const orderSummaryPageSchema = pageSchema(orderSummarySchema);
+/** 주문상품 변경 목록 응답 — `GET /v1/order-items` */
+const orderItemPageSchema = pageSchema(orderItemSchema);
+const testPaymentQuery = z.enum(["true", "false"]).optional().describe("테스트 결제(샌드박스 결제) 필터. `true`면 테스트 결제만, `false`면 실결제만, 생략하면 전부입니다");
+const pageQuery = { page: z.string().optional().describe("페이지 번호 (1부터, 기본 1)") };
+/**
+* `GET /v1/orders` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 검증 규칙은 서버가 적용한다:
+* `orderedFrom` 누락 400 `MISSING_PARAMETER`, 날짜 형식 오류 400 `INVALID_PARAMETER`, 31일 초과 400 `RANGE_TOO_WIDE`,
+* `testPayment`가 `true`·`false`가 아니면 400 `INVALID_PARAMETER`
+*/
+const orderListQuerySchema = z.object({
+	orderedFrom: z.string().describe("조회 시작 시각 (ISO 8601 날짜 또는 일시, 포함). 필수"),
+	orderedTo: z.string().optional().describe("조회 끝 시각 (ISO 8601, 포함). 생략하면 orderedFrom부터 31일. 기간은 최대 31일"),
+	status: orderItemStatusSchema.optional().describe("주문상품 상태 필터 — 이 상태의 주문상품이 하나라도 있는 주문"),
+	keyword: z.string().optional().describe("주문번호(일치)·주문자명·수령인명(포함) 검색"),
+	fulfillmentType: z.string().optional().describe("상품 유형 필터(이슈 #48) — 이 유형(`SHIPPING`·`MANUAL`)의 주문상품이 하나라도 있는 주문"),
+	testPayment: testPaymentQuery,
+	...pageQuery,
+	size: z.string().optional().describe("페이지 크기 (기본 20, 최대 100)")
+});
+/**
+* `GET /v1/order-items` 쿼리 — OpenAPI 문서용 형태. `lastChangedFrom` 누락 400 `MISSING_PARAMETER`, 형식 오류 400
+* `INVALID_PARAMETER`, 24시간 초과 400 `RANGE_TOO_WIDE`, `testPayment` 값 오류 400 `INVALID_PARAMETER`
+*/
+const orderItemListQuerySchema = z.object({
+	lastChangedFrom: z.string().describe("마지막 변경 시각 조회 시작 (ISO 8601, 포함). 필수"),
+	lastChangedTo: z.string().optional().describe("마지막 변경 시각 조회 끝 (ISO 8601, 포함). 생략하면 시작부터 24시간. 기간은 최대 24시간"),
+	lastChangedType: changeTypeSchema.optional().describe("마지막 변경 유형 필터"),
+	testPayment: testPaymentQuery,
+	...pageQuery,
+	size: z.string().optional().describe("페이지 크기 (기본 100, 최대 300)")
+});
+const deliveryMethodSchema = z.enum([
+	"COURIER",
+	"DIRECT",
+	"QUICK",
+	"NOTHING"
+]);
+const dispatchRequestSchema = z.object({
+	deliveryMethod: deliveryMethodSchema,
+	carrierCode: z.string().optional(),
+	trackingNumber: z.string().optional(),
+	/**
+	* 발송 시각. ISO 8601이고 시간대(`Z` 또는 `+09:00`)를 포함해야 한다. 생략하면 현재 시각이다.
+	*
+	* 전에는 `z.string()`이라 아무 문자열이나 그대로 저장됐다. 이 값은 배송 정보 jsonb에 들어가
+	* 자동 배송완료·추적 동기화 잡의 대상 선별 조건이 된다 — 잘못된 한 행이 스토어 구분 없이 도는
+	* 잡 전체를 멈출 수 있어 입력에서 좁혔다. 검증을 통과한 값도 저장 전에 UTC ISO로 정규화한다.
+	*/
+	dispatchedAt: z.iso.datetime({ offset: true }).optional()
+}).refine((value) => value.deliveryMethod === "DIRECT" || value.deliveryMethod === "NOTHING" ? true : !!value.carrierCode && !!value.trackingNumber, { message: "COURIER/QUICK 발송은 carrierCode와 trackingNumber가 필수입니다" });
+const deliveryInfoSchema = z.object({
+	orderItemId: z.string(),
+	deliveryMethod: deliveryMethodSchema,
+	carrierCode: z.string().nullable(),
+	carrierName: z.string().nullable(),
+	trackingNumber: z.string().nullable(),
+	trackingUrl: z.url().nullable(),
+	status: z.enum([
+		"DISPATCHED",
+		"DELIVERING",
+		"DELIVERED"
+	]),
+	dispatchedAt: z.string(),
+	deliveredAt: z.string().nullable()
+});
+/**
+* 택배 추적 단계. 응답에서는 문자열로 받는다(값이 추가될 수 있다) — 현재 값은 `ACCEPTED`(접수)·`IN_TRANSIT`(이동 중)·
+* `OUT_FOR_DELIVERY`(배송 출발)·`DELIVERED`(배송완료)다.
+*/
+const trackingStageResponseSchema = z.string();
+/** `GET /v1/order-items/{orderItemId}/delivery` 응답 — 배송 정보 + 배송 추적 이벤트 */
+const deliveryStatusSchema = deliveryInfoSchema.extend({
+	trackingEvents: z.array(z.object({
+		status: z.string().describe("택배사가 알려 준 처리 내용(예: 집화처리, 배송출발)"),
+		location: z.string().describe("처리 장소. 모르면 빈 문자열"),
+		occurredAt: z.string(),
+		stage: trackingStageResponseSchema.nullable().optional().default(null).describe("이 이벤트의 추적 단계. 배달 실패처럼 단계로 나눌 수 없는 이벤트는 null. 서버는 항상 싣는다. 현재 값은 `ACCEPTED`·`IN_TRANSIT`·`OUT_FOR_DELIVERY`·`DELIVERED`이고 값이 추가될 수 있어 문자열로 받는다")
+	})).optional().describe("배송 추적 이력. 시각 오름차순(오래된 것부터)"),
+	tracking: z.object({
+		result: z.string().nullable().describe("마지막 추적 조회 결과. 조회에 성공한 적이 없으면 null. 현재 값은 `FOUND`(조회됨)·`NOT_FOUND`(택배사 전산에 송장 없음)·`UNSUPPORTED_CARRIER`(추적을 지원하지 않는 택배사)이고 값이 추가될 수 있어 문자열로 받는다"),
+		stage: trackingStageResponseSchema.nullable().describe("현재 추적 단계. 조회되지 않았으면 null. 현재 값은 `ACCEPTED`·`IN_TRANSIT`·`OUT_FOR_DELIVERY`·`DELIVERED`이고 값이 추가될 수 있어 문자열로 받는다"),
+		checkedAt: z.string().nullable().describe("택배사에서 추적 정보를 마지막으로 받아 온 시각(ISO 8601)"),
+		carrierDeliveredAt: z.string().nullable().describe("택배사가 알려 준 배송완료 시각(ISO 8601). 추적으로 배송완료가 반영되면 주문상품의 `deliveredAt`은 반영 시각이라 이 값과 다를 수 있다")
+	}).nullable().optional().default(null).describe("택배 추적 요약. 택배 발송이 아니거나 추적을 쓰지 않으면 null. 추적이 배송완료면 주문상품이 자동으로 배송완료된다. 서버는 항상 싣는다")
+});
+/** `PUT /v1/order-items/{orderItemId}/dispatch/tracking` 응답 — 바뀐 송장 */
+const trackingUpdateResultSchema = z.object({
+	orderItemId: z.string(),
+	carrierCode: z.string(),
+	trackingNumber: z.string()
+});
+const carrierSchema = z.object({
+	carrierCode: z.string(),
+	name: z.string(),
+	trackingUrlTemplate: z.string()
+});
+const holdOrderItemRequestSchema = z.object({
+	reason: z.enum([
+		"OUT_OF_STOCK",
+		"CUSTOMER_REQUEST",
+		"CUSTOMS",
+		"ETC"
+	]),
+	detail: z.string().max(500).optional(),
+	expectedDispatchDate: z.string()
+});
+const cancelBySellerRequestSchema = z.object({
+	reason: z.enum([
+		"OUT_OF_STOCK",
+		"PRICE_ERROR",
+		"DELIVERY_IMPOSSIBLE",
+		"ETC"
+	]),
+	detail: z.string().max(500).optional(),
+	quantity: z.number().int().min(1).optional().describe("취소할 수량. 생략하면 남은 수량 전체다. 남은 수량보다 크면 400 `INVALID_QUANTITY`. 일부만 취소하면 주문상품은 상태를 유지한 채 `canceledQuantity`가 늘고, 전 수량이 소진되면 `CANCELED`가 된다")
+});
+/**
+* 제공 처리 요청 (이슈 #48) — `POST /v1/order-items/{orderItemId}/fulfill`. 배송 없는 주문상품(`MANUAL`)을
+* 제공 완료(`DELIVERED`)로 바꾼다.
 */
-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 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 optionGroupRequestSchema = z.object({
-	/** 전달 시 기존 축 행을 유지(UPDATE). 생략하면 신규 발급 */
-	groupId: z.string().optional(),
-	name: z.string().min(1).max(50),
-	values: z.array(optionValueRequestSchema).min(1).max(100)
+/** `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 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)
+/** `PUT /v1/order-items/{orderItemId}/memo` 응답 — 빈 문자열로 저장하면 메모가 지워져 `null`이다 */
+const orderItemMemoResultSchema = z.object({
+	orderItemId: z.string(),
+	sellerMemo: z.string().nullable()
 });
-/** 축 × 값 → variant 전체 교체 요청 (PUT /products/{productId}/options) */
-const optionModelRequestSchema = z.object({
-	optionGroups: z.array(optionGroupRequestSchema).max(3).default([]),
-	variants: z.array(productVariantRequestSchema).min(1).max(500)
+/** `POST /v1/order-items/{orderItemId}/purchase-decision/request` 응답 */
+const purchaseDecisionRequestResultSchema = z.object({
+	orderItemId: z.string(),
+	requestedAt: z.string()
 });
-/** GET /products/{productId}/options 응답 */
-const optionModelSchema = z.object({
-	optionGroups: z.array(optionGroupSchema),
-	variants: z.array(productVariantSchema)
+/** `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)
 });
 /**
-* 재고 변경 택일 위반 문구 — SDK `.refine`과 서버 DomainException이 공유하는 단일 원천.
-* 경로에 따라 셀러가 다른 문구를 받지 않게 한다.
+* `GET /v1/orders/{orderId}/address-change-requests` 응답 — 배송지 변경 요청 플로우는 아직 제공하지 않아
+* 현재는 항상 빈 배열이다
 */
-const VARIANT_STOCK_EXCLUSIVE_MESSAGE = "stockQuantity 또는 adjustment 중 하나만 전달해야 합니다";
+const addressChangeRequestListSchema = z.array(z.record(z.string(), z.unknown())).describe("배송지 변경 요청 목록 (현재 항상 빈 배열)");
+//#endregion
+//#region src/schemas/saved-option-set.ts
 /**
-* variant 재고 변경 요청 — 절대값(`stockQuantity`) 또는 증감(`adjustment`) 택일.
-* 서버도 같은 규칙을 400 VALIDATION_FAILED로 검증한다(이중 방어).
+* 저장 옵션 (이슈 #59) — 자주 쓰는 옵션 구성을 이름 붙여 두고 상품 등록에서 불러온다.
+*
+* **불러오기는 복사다.** 저장 옵션을 고치거나 지워도 이미 불러온 상품의 옵션은 그대로다. 재고·SKU·사용 여부는 상품마다
+* 달라 저장하지 않는다. 추가금은 조합별이 아니라 **값별**로 둔다 — 조합 옵션으로 불러오면 조합 추가금은 고른 값 추가금의 합이다.
 */
-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 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 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 savedOptionValueRequestSchema = z.object({
+	name: nameSchema,
+	additionalPrice: z.number().int().min(0).default(0)
+});
+const savedOptionGroupRequestSchema = z.object({
+	name: nameSchema,
+	kind: optionGroupKindSchema,
+	required: z.boolean().default(false).describe("추가 선택만 쓴다. 조합 옵션명에 true를 주면 400이다"),
+	values: z.array(savedOptionValueRequestSchema).min(1).max(100)
+});
+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)
 });
 /**
-* 상품 쓰기 요청의 공통 필드 — 등록(POST)과 전체 수정(PUT)이 같다. 이행(`fulfillment`)만 두 요청의 스키마가 다르다.
-*
-* 최상위가 `strictObject`다. 모르는 필드는 400이다 — 이슈 #57 이전의 평면 필드(`deliveryFee`·`fulfillmentType`·`returnFee` 등)를
-* 보낸 요청이 조용히 무시되지 않게 한다. 옛 필드는 `fulfillment.{유형}.…`과 `refundPolicy`로 옮겼다.
+* 저장 옵션 만들기·수정 본문. 조합 옵션명은 최대 `MAX_OPTION_GROUPS`개, 추가 선택은 최대 `MAX_ADDON_GROUPS`개이고
+* 옵션명과 직접 입력 항목이 모두 비면 400이다. 수정(PUT)은 통째로 바꾼다.
 */
-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 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([])
 });
-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"
+/**
+* 상품에서 저장 (`POST /v1/saved-option-sets/from-product`) — 상품의 현재 옵션을 저장 옵션으로 만든다.
+*
+* 조합 추가금이 값별 추가금의 합으로 되돌려지면 값별로 저장하고, 조합마다 제각각이면 추가금을 빼고
+* 응답 `additionalPriceDropped: true`로 알린다. `replaceOptionSetId`를 주면 그 저장 옵션을 덮어쓴다(이름 중복의 덮어쓰기).
+*/
+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
@@ -4427,8 +4286,6 @@ const updateStoreRequestSchema = z.object({
 	analyticsAllowedOrigins: z.array(analyticsOriginSchema).max(20).optional().describe("@deprecated `storefrontOrigins`를 쓴다(같은 목록). 방문 분석 수집을 받을 스토어프론트 오리진(최대 20개). 비우면 모든 오리진에서 받는다. 넣으면 목록에 없는 오리진의 수집 요청은 403 `ORIGIN_NOT_ALLOWED`이고, 페이지 URL이 목록 밖인 이벤트는 버린다"),
 	storefrontOrigins: z.array(analyticsOriginSchema).max(20).optional().describe("스토어프론트 도메인(최대 20개) — 소셜 로그인 뒤 돌아갈 주소와 방문 분석 수집을 함께 제한한다. `analyticsAllowedOrigins`와 같은 목록이다(둘 다 주면 이 값이 이긴다)"),
 	guestCheckoutEnabled: z.boolean().optional().describe("비회원 주문 허용. false(회원만)면 로그인하지 않은 구매자의 주문서 생성·결제 요청이 403 `GUEST_CHECKOUT_DISABLED`다. 장바구니 담기와 이미 받은 비회원 주문의 조회·취소는 막지 않는다"),
-	fulfillmentMailEnabled: z.boolean().optional().describe("비실물 상품 제공 안내 메일(이슈 #48). 켜면(기본) 제공이 끝났을 때 구매자에게 안내 메일을 보낸다. 코드·파일 주소는 싣지 않는다"),
-	withdrawalNotice: z.string().trim().min(1).max(1e3).nullable().optional().describe("청약철회 제한 고지 문구(이슈 #48). 제한 상품이 있는 주문서에 보인다. null이면 플랫폼 기본 문구를 쓴다"),
 	autoDeliverDays: z.number().int().min(0).max(30).optional().describe(autoDeliverDaysDescription),
 	autoConfirmDays: z.number().int().min(0).max(30).optional().describe(autoConfirmDaysDescription),
 	refundPolicy: refundPolicyPatchSchema.optional().describe("스토어 기본 환불 정책 — 준 항목만 바꾼다. 상품별 정책(`products.refundPolicy`)이 없는 상품에 적용된다"),
@@ -4454,8 +4311,6 @@ const storeSchema = z.object({
 	analyticsAllowedOrigins: z.array(z.string()).describe("방문 분석 수집을 받는 스토어프론트 오리진. 비어 있으면 모든 오리진에서 받는다"),
 	storefrontOrigins: z.array(z.string()).describe("스토어프론트 도메인 — 소셜 로그인 리디렉트와 방문 분석 수집이 함께 쓴다(`analyticsAllowedOrigins`와 같은 값)"),
 	guestCheckoutEnabled: z.boolean().describe("비회원 주문 허용. false면 회원만 주문할 수 있다"),
-	fulfillmentMailEnabled: z.boolean().optional().default(true).describe("비실물 상품 제공 안내 메일(이슈 #48). 서버는 항상 싣는다"),
-	withdrawalNotice: z.string().nullable().optional().default(null).describe("청약철회 제한 고지 문구(이슈 #48). null이면 플랫폼 기본 문구다. 서버는 항상 싣는다"),
 	autoDeliverDays: z.number().int().describe(autoDeliverDaysDescription),
 	autoConfirmDays: z.number().int().describe(autoConfirmDaysDescription),
 	refundPolicy: refundPolicySchema.describe("스토어 기본 환불 정책. 스토어가 정하지 않은 항목은 플랫폼 기본값으로 채워 항상 전부 싣는다"),
@@ -4527,14 +4382,9 @@ const storeMemberRoleUpdatedSchema = z.object({
 	role: z.enum(["ADMIN", "STAFF"])
 });
 /**
-* 주소 유형 — 출고지·반품지·방문 수령지(이슈 #48). 방문 수령지(`PICKUP`)는 목록에서 `type=PICKUP`으로 조회할 때만 나온다
-* (이 값을 모르는 옛 SDK의 목록 파싱이 깨지지 않게).
+* 주소 유형 — 출고지·반품지.
 */
-const addressTypeSchema = z.enum([
-	"SHIPPING",
-	"RETURN",
-	"PICKUP"
-]);
+const addressTypeSchema = z.enum(["SHIPPING", "RETURN"]);
 /** `GET /v1/seller-addresses` 쿼리 — OpenAPI 문서용 형태. 기본 주소 우선, 그다음 등록순이다 */
 const sellerAddressListQuerySchema = z.object({ type: addressTypeSchema.optional().describe("주소 유형 필터") });
 const sellerAddressSchema = z.object({
@@ -4579,10 +4429,28 @@ 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` — 호스팅 끄기 확인 입력이 현재 슬러그와 다르다
 * - 503 `STOREFRONT_PREVIEW_NOT_CONFIGURED` — 미리보기 서명 키가 설정되지 않았다
+*
+* 편집(M2b, `/v1/storefront/site/editing`·`files/**`·`checks/**`·`verify`·`builds/**`, 버전 만들기):
+* - 403 `STOREFRONT_EDITING_DISABLED` — 플랫폼 편집 스위치가 꺼져 있다
+* - 503 `STOREFRONT_EDITING_NOT_CONFIGURED` — 편집 Sandbox가 설정되지 않았다
+* - 409 `EDIT_CAPACITY_FULL` — 플랫폼 전체 동시 편집 상한에 걸렸다. `error.details.retryAfterSeconds` 뒤에 다시 한다
+* - 409 `EDIT_SESSION_REQUIRED` — 편집 미리보기 링크: 편집 환경이 없다
+* - 409 `CHECK_RUNNING` — 이 사이트에서 다른 종류의 검사가 돌고 있다(`error.details.checkId`)
+* - 404 `STOREFRONT_CHECK_NOT_FOUND`
+* - 409 `FILE_CHANGED` — 해시 조건이 어긋났다. 아무것도 쓰지 않았다(`error.details.conflicts: [{ path, currentHash }]`)
+* - 409 `FILE_EXISTS` — 옮길 자리에 파일이 있다(`overwrite: true`로 덮는다)
+* - 404 `FILE_NOT_FOUND` — 파일이 없다
+* - 400 `INVALID_FILE_PATH` — 경로 형식이 틀렸거나 편집할 수 없는 경로다(`node_modules`·`dist`·`.env*` 등). 쓸 수 있는 곳은
+*   `src/**`·`public/**`와 루트 설정 파일 몇 개이고, `package.json`·`pnpm-lock.yaml`은 읽기만 된다
+* - 413 `FILE_TOO_LARGE`·`WORKSPACE_TOO_LARGE` — 파일 하나 1MiB, 작업 트리 전체 20MiB·2,000개를 넘는다
+* - 409 `STOREFRONT_BUILD_IN_PROGRESS` — 이 사이트에 끝나지 않은 빌드가 있다(사이트당 하나)
+* - 404 `STOREFRONT_BUILD_NOT_FOUND`
+* - 502 `STOREFRONT_SANDBOX_UNAVAILABLE` — 편집 Sandbox 호출이 실패했다. 잠시 뒤 다시 한다
 */
 /**
 * 슬러그 형식 — 스토어 코드와 같은 DNS 라벨 규칙(소문자·숫자·하이픈 3~30자, 하이픈으로 시작·끝 불가)에
@@ -4607,8 +4475,22 @@ const RESERVED_STOREFRONT_SLUGS = [
 	"control",
 	"outbound"
 ];
+/**
+* 편집 미리보기 호스트 접미사 — 편집 미리보기 주소는 `{사이트 id 정규화}-preview.{호스팅 도메인}`이다(M2b). 사이트 주소와 같은
+* 1단계 이름이라 슬러그가 이 모양이면 남의 편집 미리보기 주소와 겹칠 수 있어 슬러그로 쓰지 못한다.
+*/
+const STOREFRONT_EDIT_PREVIEW_SUFFIX = "-preview";
 function isReservedStorefrontSlug(slug) {
-	return RESERVED_STOREFRONT_SLUGS.includes(slug.toLowerCase());
+	const lower = slug.toLowerCase();
+	return RESERVED_STOREFRONT_SLUGS.includes(lower) || lower.endsWith("-preview");
+}
+/**
+* 편집 미리보기 호스트 이름의 라벨 — 사이트 id의 `_`를 `-`로 바꾸고 `-preview`를 붙인다(`sfs_ab12cd34` → `sfs-ab12cd34-preview`).
+* 편집 Sandbox Worker(`apps/hosting-sandbox/src/preview-host.ts`)가 같은 규칙의 복제본을 들고 있고 api
+* `test/storefront-hosting-parity.spec.ts`가 둘을 대조한다. 규칙을 바꾸면 두 곳을 같이 고친다.
+*/
+function storefrontEditPreviewLabelOf(siteId) {
+	return `${siteId.replaceAll("_", "-")}${STOREFRONT_EDIT_PREVIEW_SUFFIX}`;
 }
 const storefrontSlugSchema = z.string().regex(STOREFRONT_SLUG_PATTERN, "소문자·숫자·하이픈 3~30자여야 하고 하이픈으로 시작하거나 끝날 수 없습니다").refine((slug) => !slug.includes("--"), "하이픈을 연달아 쓸 수 없습니다").refine((slug) => !isReservedStorefrontSlug(slug), "플랫폼이 쓰는 이름이라 쓸 수 없습니다").describe("주소 슬러그. `{slug}.{호스팅 도메인}`이 사이트 주소가 된다");
 /** 바꾼 슬러그를 다른 사이트가 가져가지 못하게 막는 기간(일). 보류 동안 옛 주소는 새 주소로 301한다 */
@@ -4629,8 +4511,10 @@ const storefrontTemplateSchema = z.object({
 	isDefault: z.boolean().describe("기본 템플릿인가 (스토어 생성 시 자동 생성에 쓴다)")
 });
 /**
-* 버전 상태 — M1은 템플릿 빌드 산출물을 그대로 쓰므로 만들 때 곧바로 `READY`다. `BUILDING`·`FAILED`는
-* 셀러 편집 빌드(M2)가 쓴다. 발행 여부는 상태가 아니라 사이트의 발행 포인터가 원천이다(`published`).
+* 버전 상태 — 템플릿 버전(`source: TEMPLATE`)은 템플릿 산출물을 그대로 쓰므로 만들 때 곧바로 `READY`다. 편집 버전
+* (`source: EDIT`, M2b)은 작업 트리 스냅샷을 빌드하는 동안 `BUILDING`이고, 빌드·규칙 검증을 통과하면 `READY`, 실패하면
+* `FAILED`다(실패 단계·로그 꼬리는 `buildId`의 빌드). 발행할 수 있는 것은 `READY`뿐이다. 발행 여부는 상태가 아니라 사이트의
+* 발행 포인터가 원천이다(`published`).
 */
 const storefrontVersionStatusSchema = z.enum([
 	"BUILDING",
@@ -4646,6 +4530,8 @@ const storefrontVersionSchema = z.object({
 	published: z.boolean().describe("지금 발행된 버전인가"),
 	publishedAt: z.string().nullable().describe("마지막으로 발행한 시각 (ISO 8601). 발행한 적 없으면 null"),
 	message: z.string().nullable().describe("버전 메모"),
+	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`). 늘어날 수 있다"),
 	createdAt: z.string().describe("만든 시각 (ISO 8601)")
 });
@@ -4676,6 +4562,19 @@ const storefrontProvisioningSchema = z.object({
 	lastErrorCode: z.string().nullable().describe("마지막 반영 실패 코드. 없으면 null"),
 	syncedAt: z.string().nullable().describe("마지막으로 반영한 시각 (ISO 8601)")
 });
+/**
+* 편집 미리보기 주소(M2b) — 사이트마다 `{사이트 id 정규화}-preview.{호스팅 도메인}` 호스트 하나다. 호스팅 도메인의 와일드카드
+* 인증서가 덮으므로 따로 준비할 것이 없다. 이 주소는 편집 미리보기 링크(콘솔 전용)로 받은 쿠키가 있어야 열린다.
+*/
+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("주소 슬러그"),
@@ -4688,7 +4587,9 @@ const storefrontSiteSchema = z.object({
 	visibility: storefrontVisibilitySchema,
 	publishedVersion: storefrontVersionSchema.nullable().describe("지금 발행된 버전"),
 	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()
 });
@@ -4696,6 +4597,7 @@ const storefrontSiteSchema = z.object({
 const storefrontHostingSchema = z.object({
 	enabled: z.boolean().describe("새 사이트를 만들 수 있는가 (플랫폼 스위치)"),
 	domain: z.string().describe("호스팅 도메인 (예: `sayren.co`). 사이트 주소는 `{slug}.{domain}`"),
+	editingEnabled: z.boolean().describe("파일 편집·버전 만들기를 쓸 수 있는가 (플랫폼 편집 스위치와 Sandbox 설정)"),
 	site: storefrontSiteSchema.nullable()
 });
 const storefrontSlugAvailabilitySchema = z.object({
@@ -4745,6 +4647,330 @@ const storefrontPreviewLinkSchema = z.object({
 	url: z.string().describe("미리보기 링크 — 5분 안에 연다"),
 	expiresAt: z.string().describe("링크 만료 시각 (ISO 8601)")
 });
+/** 플랫폼 전체 동시 편집 환경 상한 */
+const STOREFRONT_EDIT_CAPACITY = 20;
+/** 활동이 없으면 편집 환경이 잠드는 시간(분). 작업 트리는 보존된다 */
+const STOREFRONT_EDIT_IDLE_MINUTES = 15;
+/**
+* 편집 작업(파일 쓰기·검사·버전 만들기·편집 미리보기 링크 발급)이 없으면 서버가 편집 환경을 닫는 시간(분). 미리보기 탭만 열어 두면
+* 유휴 잠들기(`STOREFRONT_EDIT_IDLE_MINUTES`)가 걸리지 않으므로 이 한도가 편집 환경을 끝낸다. 작업 트리는 보존된다
+*/
+const STOREFRONT_EDIT_ACTIVITY_TIMEOUT_MINUTES = 30;
+/** 파일 하나의 최대 크기(바이트) */
+const STOREFRONT_FILE_MAX_BYTES = 1048576;
+/** 작업 트리 전체 최대 크기(바이트) — 파일 수는 2,000개까지 */
+const STOREFRONT_WORKSPACE_MAX_BYTES = 20971520;
+/** 일괄 쓰기 한 번의 최대 파일 수 */
+const STOREFRONT_FILE_BATCH_MAX = 50;
+/** 편집할 수 없는 경로 조각 — 설치물·산출물 폴더 */
+const STOREFRONT_BLOCKED_PATH_SEGMENTS = [
+	"node_modules",
+	"dist",
+	".output",
+	".tanstack",
+	".wrangler",
+	".git",
+	".nitro",
+	".vinxi"
+];
+/** 경로 조각에 쓸 수 있는 문자 — 편집 Sandbox Worker의 경로 규칙(sandbox-api.md §2.1)과 같다. TanStack Router 파일명(`$id.tsx`·`_layout`·`(group)`·`[.]`)이 들어간다 */
+const STOREFRONT_PATH_SEGMENT_PATTERN = /^[A-Za-z0-9$_.()[\]@+=,-]+$/;
+/**
+* 보이지 않거나 표시 방향을 바꾸는 문자 — 제로폭(U+200B~U+200D, U+FEFF)과 bidi 제어(U+202A~U+202E, U+2066~U+2069). 비슷해 보이는
+* 경로로 규칙 검사를 피하거나 리뷰어를 속이는 데 쓰인다. 문자 규칙이 이미 막지만 이유를 따로 드러내려고 먼저 본다.
+*/
+const INVISIBLE_OR_BIDI = /[\u200B-\u200D\uFEFF\u202A-\u202E\u2066-\u2069]/;
+/** 경로 정규화 — NFC. 비교·저장은 이 값으로 한다(같아 보이는 두 경로가 다른 파일이 되지 않게) */
+function normalizeStorefrontPath(path) {
+	return path.normalize("NFC");
+}
+/**
+* 작업 트리 상대 경로인가(정규화한 값 기준) — `/`로 구분하고 `/`로 시작하지 않는다. `.`·`..`·빈 조각, 조각 문자 규칙
+* (`STOREFRONT_PATH_SEGMENT_PATTERN`, 공백·역슬래시·제어·제로폭·bidi 문자 불가) 밖, 설치물·산출물 폴더
+* (`STOREFRONT_BLOCKED_PATH_SEGMENTS`), `.env`로 시작하는 조각(파일·폴더)은 받지 않는다. 최대 256자·깊이 16.
+* 어디에 쓸 수 있는지(`src/**`·`public/**`·루트 설정 파일)는 편집 Sandbox가 판정한다(400 `INVALID_FILE_PATH`).
+* 편집 Sandbox Worker가 같은 규칙의 복제본을 들고 있다(api `test/storefront-hosting-parity.spec.ts`가 대조한다).
+*/
+function isEditableStorefrontPath(path) {
+	if (path.length === 0 || path.length > 256) return false;
+	if (INVISIBLE_OR_BIDI.test(path)) return false;
+	if (path !== normalizeStorefrontPath(path)) return false;
+	if (path.startsWith("/")) return false;
+	const segments = path.split("/");
+	if (segments.length > 16) return false;
+	for (const segment of segments) {
+		if (segment === "" || segment === "." || segment === "..") return false;
+		if (!STOREFRONT_PATH_SEGMENT_PATTERN.test(segment)) return false;
+		if (STOREFRONT_BLOCKED_PATH_SEGMENTS.includes(segment)) return false;
+		if (segment.startsWith(".env")) return false;
+	}
+	return true;
+}
+/** 경로 입력 — NFC로 정규화한 뒤 규칙을 본다 */
+const storefrontFilePathSchema = z.string().transform(normalizeStorefrontPath).refine(isEditableStorefrontPath, "편집할 수 없는 경로입니다").describe("작업 트리 상대 경로 (예: `src/routes/index.tsx`). NFC로 정규화한다");
+/** 파일 해시 — 내용 바이트의 SHA-256 hex(소문자 64자) */
+const storefrontFileHashSchema = z.string().regex(/^[0-9a-f]{64}$/, "SHA-256 hex여야 합니다").describe("내용 바이트의 SHA-256 (소문자 hex)");
+const storefrontFileEncodingSchema = z.enum(["utf8", "base64"]).describe("`utf8` 텍스트 · `base64` 바이너리(이미지 등)");
+/**
+* 편집 환경 상태 — `STARTING`은 컨테이너를 띄우고 작업 트리를 복원해 dev 서버를 올리는 중이다(보통 30초 안, 최대
+* 90초). `RUNNING`이면 미리보기와 파일 쓰기가 바로 반영된다(HMR).
+*/
+const storefrontEditSessionStatusSchema = z.enum(["STARTING", "RUNNING"]).describe("`STARTING` 띄우는 중 · `RUNNING` 사용 중");
+/** 편집 환경을 띄우는 단계 — 콘솔 진행 표시용이다. 값은 늘어날 수 있다 */
+const STOREFRONT_EDIT_START_STAGES = [
+	"CONTAINER",
+	"RESTORE",
+	"DEV_SERVER"
+];
+const storefrontEditSessionSchema = z.object({
+	sessionId: z.string(),
+	status: storefrontEditSessionStatusSchema,
+	startStage: z.string().nullable().describe("`STARTING`일 때 지금 단계 (`CONTAINER` 컨테이너 기동 · `RESTORE` 작업 트리 복원 · `DEV_SERVER` 개발 서버 기동). 늘어날 수 있다. `RUNNING`이면 null"),
+	startedAt: z.string().describe("연 시각 (ISO 8601)"),
+	lastEditedAt: z.string().nullable().describe("이 편집 환경에서 마지막으로 파일을 바꾼 시각. 없으면 null"),
+	lastActiveAt: z.string().describe("마지막 활동 시각 (파일 도구·검사·미리보기)"),
+	idleExpiresAt: z.string().describe(`이 시각까지 활동이 없으면 잠든다 (마지막 활동 + 15분). 잠들어도 작업 트리는 보존된다`),
+	closesAt: z.string().describe(`이 시각까지 편집 작업(파일 쓰기·검사·버전 만들기·미리보기 링크 발급)이 없으면 서버가 편집 환경을 닫는다 (마지막 편집 작업 + 30분). 미리보기만 보고 있어도 닫힌다. 작업 트리는 보존된다`)
+});
+/** `GET·POST·DELETE /v1/storefront/site/editing` — 편집 환경 상태 */
+const storefrontEditingSchema = z.object({
+	enabled: z.boolean().describe("편집을 쓸 수 있는가 (플랫폼 스위치와 Sandbox 설정)"),
+	session: storefrontEditSessionSchema.nullable().describe("열린 편집 환경. 잠들었거나 닫았으면 null"),
+	capacity: z.object({
+		limit: z.number().int().describe("플랫폼 전체 동시 편집 환경 상한"),
+		inUse: z.number().int().describe("지금 열린 편집 환경 수")
+	}),
+	preview: storefrontEditPreviewSchema.describe("편집 미리보기 주소 (사이트의 `editPreview`와 같다)"),
+	workingTree: z.object({
+		modified: z.boolean().describe("템플릿에서 한 번이라도 고쳤는가 (사이트 `sourceMode`가 `CUSTOM`)"),
+		lastEditedAt: z.string().nullable().describe("마지막으로 파일을 바꾼 시각")
+	})
+});
+const storefrontFileEntrySchema = z.object({
+	path: z.string(),
+	size: z.number().int().min(0).describe("바이트 수"),
+	hash: storefrontFileHashSchema
+});
+/** `GET /v1/storefront/site/files?prefix=` — 작업 트리 파일 목록(편집 환경이 없어도 된다. 편집 환경을 깨우지 않는다) */
+const storefrontFileListSchema = z.object({
+	files: z.array(storefrontFileEntrySchema).describe("경로 사전순"),
+	totalBytes: z.number().int().min(0).describe("작업 트리 전체 바이트 수")
+});
+const storefrontFileListQuerySchema = z.object({ prefix: z.string().max(256).optional().describe("이 접두사로 시작하는 경로만 (예: `src/routes/`)") });
+const storefrontFileContentQuerySchema = z.object({ path: z.string().describe("읽을 파일 경로") });
+/** `GET /v1/storefront/site/files/content?path=` — 편집 환경이 없어도 된다 */
+const storefrontFileContentSchema = z.object({
+	path: z.string(),
+	content: z.string().describe("내용 (`encoding`에 따라 텍스트 또는 base64)"),
+	encoding: storefrontFileEncodingSchema,
+	hash: storefrontFileHashSchema,
+	size: z.number().int().min(0)
+});
+/**
+* `POST /v1/storefront/site/files/batch` — 여러 파일을 한 번에 쓴다. 편집 환경이 없어도 된다(잠든 작업 트리에 바로 쓰고,
+* 편집 환경이 떠 있으면 미리보기에 곧바로 반영된다). `expectedHash`: 생략하면 조건 없이 쓴다 · `null`이면 파일이 없어야 한다(새 파일) · 값이면 지금
+* 해시가 같아야 한다. 조건을 **모두** 확인한 뒤 쓰고, 하나라도 어긋나면 아무것도 쓰지 않는다(409 `FILE_CHANGED`,
+* `error.details.conflicts`).
+*/
+const writeStorefrontFilesRequestSchema = z.object({ files: z.array(z.object({
+	path: storefrontFilePathSchema,
+	content: z.string().describe("내용 (`encoding`에 따라 텍스트 또는 base64)"),
+	encoding: storefrontFileEncodingSchema.optional().describe("기본 `utf8`"),
+	expectedHash: storefrontFileHashSchema.nullable().optional().describe("쓰기 조건. 생략 = 조건 없음 · null = 새 파일 · 값 = 지금 해시가 같을 때만")
+})).min(1).max(50).refine((files) => new Set(files.map((file) => file.path)).size === files.length, { message: "같은 경로를 두 번 실을 수 없습니다" }) });
+const storefrontFileWriteResultSchema = z.object({ files: z.array(storefrontFileEntrySchema).describe("쓴 파일의 새 해시·크기 (요청 순서)") });
+/** 409 `FILE_CHANGED`의 `error.details` */
+const storefrontFileConflictDetailsSchema = z.object({ conflicts: z.array(z.object({
+	path: z.string(),
+	currentHash: storefrontFileHashSchema.nullable().describe("지금 해시. 파일이 없으면 null")
+})) });
+/** `POST /v1/storefront/site/files/delete` — 없는 파일이면 `deleted: false`(조건을 주면 409 `FILE_CHANGED`) */
+const deleteStorefrontFileRequestSchema = z.object({
+	path: storefrontFilePathSchema,
+	expectedHash: storefrontFileHashSchema.optional().describe("주면 지금 해시가 같을 때만 지운다")
+});
+const storefrontFileDeleteResultSchema = z.object({
+	path: z.string(),
+	deleted: z.boolean()
+});
+/** `POST /v1/storefront/site/files/move` — 이름 바꾸기·옮기기 */
+const moveStorefrontFileRequestSchema = z.object({
+	from: storefrontFilePathSchema,
+	to: storefrontFilePathSchema,
+	expectedHash: storefrontFileHashSchema.optional().describe("주면 `from`의 지금 해시가 같을 때만"),
+	overwrite: z.boolean().optional().describe("`to`에 파일이 있으면 덮는가 (기본 false → 409 `FILE_EXISTS`)")
+});
+const storefrontFileMoveResultSchema = z.object({
+	from: z.string(),
+	to: z.string(),
+	hash: storefrontFileHashSchema,
+	size: z.number().int().min(0)
+});
+/** `POST /v1/storefront/site/files/search` — 텍스트 파일 내용 검색(편집 환경이 없어도 된다) */
+/** 정규식 검색의 패턴 길이 상한 — 편집 Sandbox가 실행 비용을 막으려고 더 좁게 받는다(sandbox-api §4.6) */
+const STOREFRONT_SEARCH_REGEX_MAX_LENGTH = 100;
+const searchStorefrontFilesRequestSchema = z.object({
+	query: z.string().min(1).max(200),
+	regex: z.boolean().optional().describe("`query`를 정규식으로 본다 (기본 false = 글자 그대로). 정규식은 100자까지이고 중첩 수량자(`(a+)+`)·반복되는 선택(`(a|b)+`)·역참조·뒤 보기, 가변 수량자(`*`·`+`·`?`·`{n,m}`, 넓은 범위는 2로 센다) 차수 4 초과는 400 `INVALID_REQUEST`다. 차수가 클수록 긴 줄은 건너뛰고 비용이 크면 `truncated`로 끊는다"),
+	caseSensitive: z.boolean().optional().describe("대소문자를 가리는가 (기본 false)"),
+	pathPrefix: z.string().max(256).optional(),
+	maxResults: z.number().int().min(1).max(200).optional().describe("기본 50")
+}).refine((body) => !body.regex || body.query.length <= 100, {
+	message: `정규식은 100자까지입니다`,
+	path: ["query"]
+});
+const storefrontFileSearchResultSchema = z.object({
+	matches: z.array(z.object({
+		path: z.string(),
+		line: z.number().int().min(1),
+		column: z.number().int().min(1).optional(),
+		text: z.string().describe("일치한 줄 (일치 앞뒤 200자까지)")
+	})),
+	truncated: z.boolean().describe("`maxResults`에서 끊었는가")
+});
+/**
+* `POST /v1/storefront/site/checks` (202) — 작업 트리에 명령 하나를 돌린다(`typecheck` 타입 검사 · `lint` · `test`). 편집 환경이
+* 없어도 된다(일회용 검사 컨테이너에서 돈다). 검사는 30초를 넘길 수 있어 **항상 202로 검사 id만 주고** 결과는
+* `GET /v1/storefront/site/checks/{checkId}`로 조회한다(권장 2~3초 간격). 사이트당 끝나지 않은 검사는 하나다 — 같은 종류가 돌고
+* 있으면 그 검사를 다시 돌려주고, 다른 종류면 409 `CHECK_RUNNING`(`error.details.checkId`)이다. 출력은 꼬리만 준다.
+*/
+const runStorefrontCheckRequestSchema = z.object({ check: z.enum([
+	"typecheck",
+	"lint",
+	"test"
+]) });
+const storefrontCheckStatusSchema = z.enum([
+	"QUEUED",
+	"RUNNING",
+	"PASSED",
+	"FAILED",
+	"TIMED_OUT",
+	"UNKNOWN"
+]).describe("`QUEUED` 대기 · `RUNNING` 실행 중 · `PASSED` 통과 · `FAILED` 실패(명령 실패 또는 `errorCode`) · `TIMED_OUT` 마감(150초)에 걸려 끊김 · `UNKNOWN` 결과를 모른다(다시 실행하지 않는다, 새 검사를 요청한다)");
+/** 끝난 검사 상태 */
+const STOREFRONT_CHECK_TERMINAL_STATUSES = [
+	"PASSED",
+	"FAILED",
+	"TIMED_OUT",
+	"UNKNOWN"
+];
+const storefrontCheckSchema = z.object({
+	checkId: z.string(),
+	check: z.string().describe("`typecheck`·`lint`·`test`"),
+	status: storefrontCheckStatusSchema,
+	exitCode: z.number().int().nullable().describe("명령 종료 코드. 명령이 끝나지 않았으면 null"),
+	durationMs: z.number().int().min(0).nullable().describe("명령 시간. 끝나지 않았으면 null"),
+	outputTail: z.string().nullable().describe("출력 꼬리 (최대 16KiB). 끝나지 않았으면 null"),
+	errorCode: z.string().nullable().describe("명령 밖의 실패 이유 (`CHECK_BUSY`·`SANDBOX_UNAVAILABLE`·`RESULT_UNKNOWN`, 늘어날 수 있다). 명령 결과로 끝났으면 null"),
+	message: z.string().nullable().describe("`errorCode`가 있을 때 사용자용 안내"),
+	createdAt: z.string(),
+	startedAt: z.string().nullable(),
+	finishedAt: z.string().nullable()
+});
+/** 규칙 심각도 — `error`는 버전 발행을 막는다(빌드 `VERIFY` 실패), `warning`은 알리기만 한다. 없으면 `error`로 본다 */
+const storefrontRuleSeveritySchema = z.enum(["error", "warning"]);
+/** 규칙 하나의 검사 결과 — MCP 계측(`mcpRuleResultSchema`)과 같은 모양에 심각도를 더한다 */
+const storefrontRuleResultSchema = z.object({
+	ruleId: z.string(),
+	status: z.enum(["pass", "violation"]),
+	count: z.number().int().min(0),
+	severity: storefrontRuleSeveritySchema.optional()
+});
+/**
+* 규칙 검증 보고서 — `@sayren/mcp`의 `verify_storefront`와 같은 모양이다(원천 `apps/mcp/src/verify.ts`). 위반마다
+* 고칠 자리(`file`·`line`)와 방법(`fix`·`example`)을 싣는다. `POST /v1/storefront/site/verify`(편집 환경이 잠들어 있어도
+* 된다)와 빌드의 `verify`가 이 모양이다.
+*/
+const storefrontVerifyReportSchema = z.object({
+	ok: z.boolean().describe("차단(`error`) 위반이 없는가"),
+	checkedFiles: z.number().int().min(0),
+	summary: z.object({
+		rules: z.number().int(),
+		passed: z.number().int(),
+		violated: z.number().int(),
+		findings: z.number().int()
+	}),
+	results: z.array(storefrontRuleResultSchema),
+	findings: z.array(z.object({
+		ruleId: z.string(),
+		rule: z.string(),
+		file: z.string(),
+		line: z.number().int().optional(),
+		detail: z.string(),
+		cause: z.string(),
+		fix: z.string(),
+		example: z.string(),
+		doc: z.string(),
+		docUrl: z.string(),
+		templateFile: z.string().optional(),
+		severity: storefrontRuleSeveritySchema.optional()
+	})),
+	message: z.string(),
+	nextSteps: z.array(z.string())
+});
+const storefrontBuildStatusSchema = z.enum([
+	"QUEUED",
+	"RUNNING",
+	"SUCCEEDED",
+	"FAILED",
+	"TIMED_OUT"
+]).describe("`QUEUED` 대기 · `RUNNING` 빌드 중 · `SUCCEEDED` 성공(버전 `READY`) · `FAILED` 실패 · `TIMED_OUT` 시간 초과(10분)");
+/** 끝난 빌드 상태 */
+const STOREFRONT_BUILD_TERMINAL_STATUSES = [
+	"SUCCEEDED",
+	"FAILED",
+	"TIMED_OUT"
+];
+/**
+* 빌드 단계 — 이 순서로 돈다. 첫 실패에서 멈추지만 규칙 검증(`VERIFY`)은 실패해도 타입 검사까지 이어서 해 한 번에 알려 준다.
+* `UPLOAD`는 사이트 버전 Worker 업로드다(성공하면 발행할 수 있다). 값은 늘어날 수 있다.
+*/
+const STOREFRONT_BUILD_STAGES = [
+	"VERIFY",
+	"RESTORE",
+	"INSTALL",
+	"TYPECHECK",
+	"BUILD",
+	"BUNDLE",
+	"PACK",
+	"UPLOAD"
+];
+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"),
+	logTail: z.string().nullable().describe("실패 단계 출력 꼬리 (최대 8KB). 없으면 null"),
+	stages: z.array(z.object({
+		stage: z.string(),
+		ok: z.boolean(),
+		durationMs: z.number().int().min(0)
+	})).describe("끝난 단계 (도는 순서)"),
+	verify: storefrontVerifyReportSchema.nullable().describe("규칙 검증 보고서(위반 상세는 50건까지). 그 단계까지 가지 못했으면 null"),
+	queuedAt: z.string(),
+	startedAt: z.string().nullable(),
+	finishedAt: z.string().nullable(),
+	durationMs: z.number().int().nullable().describe("빌드 시간 (시작 → 끝)")
+});
+const storefrontBuildListQuerySchema = z.object({ limit: z.coerce.number().int().min(1).max(50).optional().describe("기본 20, 최신 먼저") });
+/**
+* `POST /v1/storefront/site/versions` — 지금 작업 트리를 고정해 버전을 만든다(빌드 시작). 사이트당 끝나지 않은 빌드는
+* 하나다(409 `STOREFRONT_BUILD_IN_PROGRESS`). 편집 환경이 없어도 된다.
+*/
+const createStorefrontVersionRequestSchema = z.object({ message: z.string().max(200).optional().describe("버전 메모 (에이전트는 바꾼 내용 요약)") });
+/** 버전 만들기 응답 (201) — 버전은 `BUILDING`, 빌드는 `QUEUED`로 시작한다. 결과는 `GET builds/{buildId}`로 본다 */
+const storefrontVersionCreatedSchema = z.object({
+	version: storefrontVersionSchema,
+	build: storefrontBuildSchema
+});
+/**
+* `POST /v1/storefront/site/editing/preview-link` — 편집 미리보기(dev 서버) 링크. 콘솔에서 로그인한 OWNER·ADMIN만
+* 받는다(PAT·에이전트 불가). 5분 안에 열면 그 브라우저에 미리보기 호스트 전용 쿠키(12시간)가 생긴다. 편집 환경이
+* 없으면 409 `EDIT_SESSION_REQUIRED`다(편집 환경이 `STARTING`이면 링크는 주고, 미리보기 화면이 기동 대기를 보여 준다).
+*/
+const createStorefrontEditPreviewLinkRequestSchema = createStorefrontPreviewLinkRequestSchema;
 //#endregion
 //#region src/client.ts
 function formBody(fields) {
@@ -4895,10 +5121,7 @@ function createStoreClient(options) {
 				}) });
 				const put = await fetchFn(ticket.uploadUrl, {
 					method: "PUT",
-					headers: {
-						...ticket.headers,
-						"content-type": file.type || "application/octet-stream"
-					},
+					headers: { "content-type": file.type || "application/octet-stream" },
 					body: file
 				});
 				if (!put.ok) throw new ApiError(put.status, "UPLOAD_PUT_FAILED", `업로드에 실패했습니다: ${filename}`);
@@ -4933,37 +5156,23 @@ function createStoreClient(options) {
 			updateVariantStock: (productId, variantId, body) => storeHttp.request("PATCH", path`/products/${productId}/variants/${variantId}/stock`, variantStockSchema, { body: variantStockRequestSchema.parse(body) }),
 			getDiscount: (productId) => storeHttp.request("GET", path`/products/${productId}/discount`, discountSchema),
 			setDiscount: (productId, body) => storeHttp.request("PUT", path`/products/${productId}/discount`, discountSchema, { body: discountRequestSchema.parse(body) }),
-			removeDiscount: (productId) => storeHttp.requestVoid("DELETE", path`/products/${productId}/discount`),
-			/**
-			* 코드 일괄 업로드 (이슈 #48) — 코드 발급·자동 제공 상품의 코드 풀에 올린다. `codes`와 `csv` 중 하나만 보낸다.
-			* 받은 코드 수만큼 재고가 는다. 에러: 409 `NOT_CODE_PRODUCT`·`CODE_POOL_NOT_USED`·`CODE_UPLOAD_CONFLICT`, 400 `TOO_MANY_CODES`
-			*/
-			uploadCodes: (productId, body, idempotencyKey) => storeHttp.request("POST", path`/products/${productId}/codes`, fulfillmentCodeBatchSchema, {
-				body: fulfillmentCodeUploadRequestSchema.parse(body),
-				headers: idempotency(idempotencyKey)
-			}),
-			/** 코드 목록 — 가린 값(`hint`)만 싣는다. `available`은 필터와 무관한 판매 가능 코드 수다 */
-			listCodes: (productId, params) => storeHttp.request("GET", path`/products/${productId}/codes`, fulfillmentCodePageSchema, { query: params }),
-			/** 판매 가능 코드 폐기 — 재고가 1 준다. 배정된 코드는 409 `CODE_NOT_AVAILABLE` */
-			voidCode: (productId, codeId) => storeHttp.request("POST", path`/products/${productId}/codes/${codeId}/void`, fulfillmentCodeSchema),
-			/**
-			* 판매 파일 연결 (이슈 #48) — `uploads.create({ purpose: "digital-asset" })`로 받은 `key`에 파일을 올린 뒤 연결한다.
-			* 이후 주문부터 이 파일을 준다. 에러: 400 `INVALID_ASSET_KEY`, 409 `NOT_DOWNLOAD_PRODUCT`·`ASSET_ALREADY_ATTACHED`
-			*/
-			attachDigitalAsset: (productId, body) => storeHttp.request("POST", path`/products/${productId}/digital-assets`, digitalAssetSchema, { body: digitalAssetAttachRequestSchema.parse(body) }),
-			/** 판매 파일 목록 — 해제한 파일도 싣는다. 객체 키·주소는 없다 */
-			listDigitalAssets: (productId) => storeHttp.request("GET", path`/products/${productId}/digital-assets`, z.array(digitalAssetSchema)),
-			/** 판매 파일 해제 — 새 주문에 주지 않는다. 이미 산 구매자는 계속 받는다 */
-			removeDigitalAsset: (productId, assetId) => storeHttp.request("DELETE", path`/products/${productId}/digital-assets/${assetId}`, digitalAssetSchema),
-			/** 판매 파일 확인 주소 — 수명 300초의 서명 주소 */
-			previewDigitalAsset: (productId, assetId) => storeHttp.request("POST", path`/products/${productId}/digital-assets/${assetId}/preview-url`, digitalAssetPreviewSchema)
+			removeDiscount: (productId) => storeHttp.requestVoid("DELETE", path`/products/${productId}/discount`)
 		},
-		fulfillmentCodes: { 
 		/**
-		* 코드 평문 열람 — 콘솔에서 로그인한 OWNER·ADMIN만 된다(403 `INSUFFICIENT_ROLE`). 열람 기록과 감사 로그가 남는다.
-		* 평문은 화면에 보인 뒤 저장하지 않는다
+		* 저장 옵션 (이슈 #59) — 자주 쓰는 옵션 구성. 불러오기는 복사라 저장 옵션을 고쳐도 불러온 상품은 바뀌지 않는다.
+		* 권한은 상품과 같다(`product:r`·`product:rw`).
 		*/
-reveal: (codeId) => storeHttp.request("POST", path`/fulfillment-codes/${codeId}/reveal`, fulfillmentCodeRevealSchema) },
+		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 } }),
@@ -5030,12 +5239,7 @@ reveal: (codeId) => storeHttp.request("POST", path`/fulfillment-codes/${codeId}/
 				headers: idempotency(idempotencyKey)
 			}),
 			/**
-			* 제공 안내 메일 재발송 (이슈 #48) — 제공된 주문상품의 안내 메일을 다시 보낸다. 주문상품당 하루 3회(429).
-			* 코드·파일 주소는 메일에 없다
-			*/
-			resendFulfillmentMail: (orderItemId) => storeHttp.request("POST", path`/order-items/${orderItemId}/fulfillment/mail`, fulfillmentMailResendSchema),
-			/**
-			* 제공 처리 (이슈 #48) — 수동 제공 비실물 주문상품(이용권·방문 수령)을 `PAID`·`CONFIRMED`에서 제공 완료(`DELIVERED`)로
+			* 제공 처리 (이슈 #48) — 배송 없는 주문상품(`MANUAL`)을 `PAID`·`CONFIRMED`에서 제공 완료(`DELIVERED`)로
 			* 바꾼다. `note`는 구매자 주문 상세에 이용 안내로 실린다. 배송 상품은 409 `SHIPPING_REQUIRED`
 			*/
 			fulfill: (orderItemId, body = {}, idempotencyKey) => storeHttp.request("POST", path`/order-items/${orderItemId}/fulfill`, orderItemSchema, {
@@ -5380,7 +5584,54 @@ list: (params) => storeHttp.request("GET", "/audit-logs", auditLogPageSchema, {
 			*/
 			createPreviewLink: (body = {}) => storeHttp.request("POST", "/storefront/site/preview-link", storefrontPreviewLinkSchema, { body: createStorefrontPreviewLinkRequestSchema.parse(body) }),
 			/** `POST /v1/storefront/site/disable` — 호스팅을 끈다(사이트 `CLOSED`, 슬러그 90일 보류). 다시 만들 수 있다 */
-			disable: (body) => storeHttp.request("POST", "/storefront/site/disable", storefrontSiteSchema, { body: disableStorefrontHostingRequestSchema.parse(body) })
+			disable: (body) => storeHttp.request("POST", "/storefront/site/disable", storefrontSiteSchema, { body: disableStorefrontHostingRequestSchema.parse(body) }),
+			/** `GET /v1/storefront/site/editing` — 편집 환경 상태(열린 환경·동시 상한·미리보기 인증서) */
+			getEditing: () => storeHttp.request("GET", "/storefront/site/editing", storefrontEditingSchema),
+			/**
+			* `POST /v1/storefront/site/editing` — 편집 환경을 연다(이미 열려 있으면 그대로). 플랫폼 동시 상한에 걸리면 409
+			* `EDIT_CAPACITY_FULL`(`details.retryAfterSeconds`). 띄우는 데 보통 30초가 걸린다(`session.status: STARTING`)
+			*/
+			startEditing: () => storeHttp.request("POST", "/storefront/site/editing", storefrontEditingSchema, { body: {} }),
+			/** `DELETE /v1/storefront/site/editing` — 편집 환경을 닫는다(작업 트리는 보존된다) */
+			stopEditing: () => storeHttp.request("DELETE", "/storefront/site/editing", storefrontEditingSchema),
+			/**
+			* `POST /v1/storefront/site/editing/preview-link` — 편집 미리보기(dev 서버) 5분짜리 링크.
+			* 콘솔에서 로그인한 OWNER·ADMIN만 받는다(에이전트 불가)
+			*/
+			createEditPreviewLink: (body = {}) => storeHttp.request("POST", "/storefront/site/editing/preview-link", storefrontPreviewLinkSchema, { body: createStorefrontEditPreviewLinkRequestSchema.parse(body) }),
+			/** `GET /v1/storefront/site/files?prefix=` — 작업 트리 파일 목록 */
+			listFiles: (params = {}) => storeHttp.request("GET", "/storefront/site/files", storefrontFileListSchema, { query: params }),
+			/** `GET /v1/storefront/site/files/content?path=` — 파일 하나 읽기 */
+			readFile: (filePath) => storeHttp.request("GET", "/storefront/site/files/content", storefrontFileContentSchema, { query: { path: filePath } }),
+			/**
+			* `POST /v1/storefront/site/files/batch` — 여러 파일 쓰기(해시 조건). 조건이 하나라도 어긋나면 아무것도 쓰지 않고 409
+			* `FILE_CHANGED`(`details.conflicts`). 편집 환경이 없으면 연다
+			*/
+			writeFiles: (body) => storeHttp.request("POST", "/storefront/site/files/batch", storefrontFileWriteResultSchema, { body: writeStorefrontFilesRequestSchema.parse(body) }),
+			/** `POST /v1/storefront/site/files/delete` */
+			deleteFile: (body) => storeHttp.request("POST", "/storefront/site/files/delete", storefrontFileDeleteResultSchema, { body: deleteStorefrontFileRequestSchema.parse(body) }),
+			/** `POST /v1/storefront/site/files/move` */
+			moveFile: (body) => storeHttp.request("POST", "/storefront/site/files/move", storefrontFileMoveResultSchema, { body: moveStorefrontFileRequestSchema.parse(body) }),
+			/** `POST /v1/storefront/site/files/search` — 내용 검색 */
+			searchFiles: (body) => storeHttp.request("POST", "/storefront/site/files/search", storefrontFileSearchResultSchema, { body: searchStorefrontFilesRequestSchema.parse(body) }),
+			/**
+			* `POST /v1/storefront/site/checks` (202) — 타입 검사·lint·test 하나를 시작한다. 결과는 `getCheck`로 끝날 때까지 조회한다
+			* (`STOREFRONT_CHECK_TERMINAL_STATUSES`)
+			*/
+			runCheck: (body) => storeHttp.request("POST", "/storefront/site/checks", storefrontCheckSchema, { body: runStorefrontCheckRequestSchema.parse(body) }),
+			/** `GET /v1/storefront/site/checks/{checkId}` — 검사 상태·종료 코드·출력 꼬리 */
+			getCheck: (checkId) => storeHttp.request("GET", path`/storefront/site/checks/${checkId}`, storefrontCheckSchema),
+			/** `POST /v1/storefront/site/verify` — 작업 트리 규칙 검증(`verify_storefront`와 같은 보고서) */
+			verify: () => storeHttp.request("POST", "/storefront/site/verify", storefrontVerifyReportSchema, { body: {} }),
+			/**
+			* `POST /v1/storefront/site/versions` (201) — 지금 작업 트리로 버전을 만든다(빌드 시작). 버전은 `BUILDING`, 빌드가
+			* 끝나면 `READY` 또는 `FAILED`다
+			*/
+			createVersion: (body = {}) => storeHttp.request("POST", "/storefront/site/versions", storefrontVersionCreatedSchema, { body: createStorefrontVersionRequestSchema.parse(body) }),
+			/** `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)
 		},
 		store: {
 			get: () => storeHttp.request("GET", "/store", storeSchema),
@@ -5621,20 +5872,24 @@ const orderWebhookEventDataSchema = z.object({
 	status: orderItemStatusSchema.describe("이벤트 발생 시점의 주문 대표 상태"),
 	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`이 `SHIPPING`이 아니다. `orderItemId`가 있는 이벤트에만 실린다")
+	orderItemId: z.string().optional().describe("이벤트를 만든 주문상품 ID. 배송 없는 상품 제공으로 보내는 `ORDER.DELIVERED`에만 실린다. 택배 배송완료와 그 밖의 주문 이벤트에는 없다"),
+	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` — 비실물 주문상품(파일·코드·이용권·방문 수령)을 제공했다(이슈 #48). 자동 제공은 결제 확정과 함께,
-* 수동 제공은 셀러의 제공 처리(`POST /v1/order-items/{orderItemId}/fulfill`)로 온다. 기존 구독자를 위해 같은 순간
-* `ORDER.DELIVERED`도 함께 보낸다. **코드·파일 주소는 싣지 않는다** — 관리 API로 조회한다.
+* `ORDER.FULFILLED` — 배송 없는 주문상품(`MANUAL`)을 제공했다(이슈 #48). 셀러의 제공 처리
+* (`POST /v1/order-items/{orderItemId}/fulfill`)로 온다. 기존 구독자를 위해 같은 순간 `ORDER.DELIVERED`도 함께 보낸다.
 */
 const orderFulfilledWebhookEventDataSchema = z.object({
 	orderId: z.string().describe("주문 ID"),
 	orderItemId: z.string().describe("제공한 주문상품 ID"),
 	status: orderItemStatusSchema.describe("이벤트 발생 시점의 주문 대표 상태"),
 	fulfillmentSnapshot: orderItemFulfillmentSnapshotResponseSchema.describe("제공한 주문상품의 주문 시점 이행 스냅샷(주문상품 응답의 `fulfillmentSnapshot`과 같다, 이슈 #57)"),
-	fulfillment: z.object({ mode: z.string().describe("실제 제공 방식. `AUTO`(결제 확정과 함께)·`MANUAL`(셀러 제공 처리). 주문상품 제공 기록의 `mode`와 같다") }).describe("제공 기록"),
+	fulfillment: z.object({ mode: z.string() }).optional().describe("**Deprecated** — 항상 `{ mode: \"MANUAL\" }`이다. 자동 제공을 없앴고(이슈 #48) store-sdk 0.19 이하 호환으로만 싣는다. 게시된 연동이 store-sdk 0.20 이상으로 넘어간 뒤 다음 릴리스에서 뺀다"),
 	fulfilledAt: z.string().describe("제공 시각 (ISO 8601). 주문상품의 `deliveredAt`과 같다"),
 	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다")
 });
@@ -5893,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, DOWNLOAD_DEFAULTS, FULFILLMENT_RULES, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_CODES_PER_UPLOAD, MAX_CODE_LENGTH, 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, PRIVATE_UPLOAD_HEADERS, REFUND_POLICY_DEFAULTS, REFUND_POLICY_DELIVERY_FEE_KEYS, REMOTE_AREA_ZIP_RANGES, RESERVED_STOREFRONT_SLUGS, RESERVED_STORE_CODES, SHIPPING_POLICY_DEFAULTS, STOREFRONT_SITE_CREATE_LIMIT, STOREFRONT_SLUG_CHANGE_LIMIT, STOREFRONT_SLUG_CHANGE_WINDOW_DAYS, STOREFRONT_SLUG_HOLD_DAYS, STOREFRONT_SLUG_PATTERN, 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, autoFulfillableOf, 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, createStorefrontPreviewLinkRequestSchema, createStorefrontSiteRequestSchema, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerCouponSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, digitalAssetAttachRequestSchema, digitalAssetPreviewSchema, digitalAssetSchema, disableStorefrontHostingRequestSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, fulfillBulkRequestSchema, fulfillRequestSchema, fulfillmentCodeBatchSchema, fulfillmentCodeListQuerySchema, fulfillmentCodePageSchema, fulfillmentCodeRejectionSchema, fulfillmentCodeRevealSchema, fulfillmentCodeSchema, fulfillmentCodeStatusSchema, fulfillmentCodeUploadRequestSchema, fulfillmentMailResendSchema, fulfillmentModeOf, fulfillmentModeSchema, fulfillmentRuleOf, fulfillmentTypeOf, fulfillmentTypeResponseSchema, fulfillmentTypeSchema, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationDeliveryStatusSchema, invitationListQuerySchema, invitationSchema, inviteMemberRequestSchema, isCouponTargetLine, isReservedStoreCode, isReservedStorefrontSlug, isStoreScope, isWebOrigin, issueCouponRequestSchema, issueCouponResultSchema, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, mcpRuleResultSchema, mcpToolEventSchema, myAccountSchema, myStoreSchema, normalizeCouponCode, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, openFulfillmentUnion, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderCanceledWebhookEventDataSchema, orderCanceledWebhookEventSchema, orderDiscountSchema, orderFulfilledWebhookEventDataSchema, orderFulfilledWebhookEventSchema, orderItemCodeSchema, orderItemDownloadSchema, 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, resolveFulfillmentMode, resolveRefundPolicy, resolveShippingPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, rollbackStorefrontRequestSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, setStorefrontVisibilityRequestSchema, settleCouponShortfall, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, stockTrackingOf, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, storefrontDomainSchema, storefrontHostingSchema, storefrontPreviewLinkSchema, storefrontProvisioningSchema, storefrontSiteSchema, storefrontSiteStatusSchema, storefrontSlugAvailabilityQuerySchema, storefrontSlugAvailabilitySchema, storefrontSlugSchema, storefrontSourceModeSchema, storefrontTemplateSchema, storefrontVersionSchema, storefrontVersionStatusSchema, storefrontVisibilitySchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, updateCouponRequestSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updateMemberRoleRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, usesCodePool, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema, withdrawalRestrictedOf, writeDryRunResultSchema, writePreviewSchema };
+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 };