@sayren/store-sdk 0.19.0 → 0.21.0

package/dist/index.d.mts

@@ -165,8 +165,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
-  DENIED: "DENIED";
   APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+  DENIED: "DENIED";
   ALLOW: "ALLOW";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
@@ -190,8 +190,8 @@ export type WritePreview = z.infer<typeof writePreviewSchema>;
 export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
-    DENIED: "DENIED";
     APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+    DENIED: "DENIED";
     ALLOW: "ALLOW";
   }>;
   reason: z.ZodNullable<z.ZodString>;
@@ -213,25 +213,25 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WriteDryRunResult = z.infer<typeof writeDryRunResultSchema>;
 export declare const approvalStatusSchema: z.ZodEnum<{
-  EXPIRED: "EXPIRED";
   PENDING: "PENDING";
   FAILED: "FAILED";
   SUCCEEDED: "SUCCEEDED";
   EXECUTING: "EXECUTING";
   UNKNOWN: "UNKNOWN";
   REJECTED: "REJECTED";
+  EXPIRED: "EXPIRED";
 }>;
 export type ApprovalStatus = z.infer<typeof approvalStatusSchema>;
 export declare const approvalRequestSchema: z.ZodObject<{
   approvalId: z.ZodString;
   status: z.ZodEnum<{
-    EXPIRED: "EXPIRED";
     PENDING: "PENDING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
     UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
+    EXPIRED: "EXPIRED";
   }>;
   operationId: z.ZodString;
   method: z.ZodString;
@@ -287,13 +287,13 @@ export declare const approvalRequestSchema: z.ZodObject<{
 export type ApprovalRequest = z.infer<typeof approvalRequestSchema>;
 export declare const approvalListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodEnum<{
-    EXPIRED: "EXPIRED";
     PENDING: "PENDING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
     UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
+    EXPIRED: "EXPIRED";
   }>>>>;
   cursor: z.ZodOptional<z.ZodString>;
   limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -306,13 +306,13 @@ export declare const approvalPageSchema: z.ZodObject<{
   items: z.ZodArray<z.ZodObject<{
     approvalId: z.ZodString;
     status: z.ZodEnum<{
-      EXPIRED: "EXPIRED";
       PENDING: "PENDING";
       FAILED: "FAILED";
       SUCCEEDED: "SUCCEEDED";
       EXECUTING: "EXECUTING";
       UNKNOWN: "UNKNOWN";
       REJECTED: "REJECTED";
+      EXPIRED: "EXPIRED";
     }>;
     operationId: z.ZodString;
     method: z.ZodString;
@@ -1171,11 +1171,11 @@ export type ApiTokenCreateRequest = z.infer<typeof apiTokenCreateRequestSchema>;
 //#endregion
 //#region src/schemas/category.d.ts
 export declare const categoryProductSortSchema: z.ZodEnum<{
+  NAME: "NAME";
   RECENT: "RECENT";
   POPULAR: "POPULAR";
   PRICE_LOW: "PRICE_LOW";
   PRICE_HIGH: "PRICE_HIGH";
-  NAME: "NAME";
 }>;
 export type CategoryProductSort = z.infer<typeof categoryProductSortSchema>;
 export declare const categorySchema: z.ZodObject<{
@@ -1191,11 +1191,11 @@ export declare const categorySchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
+    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
-    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1221,11 +1221,11 @@ export declare const categoryWithPathSchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
+    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
-    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1246,11 +1246,11 @@ export declare const categoryWithPathSchema: z.ZodObject<{
     showPc: z.ZodBoolean;
     showMobile: z.ZodBoolean;
     productSort: z.ZodEnum<{
+      NAME: "NAME";
       RECENT: "RECENT";
       POPULAR: "POPULAR";
       PRICE_LOW: "PRICE_LOW";
       PRICE_HIGH: "PRICE_HIGH";
-      NAME: "NAME";
     }>;
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
@@ -1274,11 +1274,11 @@ export declare const categorySearchResultSchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
+    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
-    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1299,11 +1299,11 @@ export declare const categorySearchResultSchema: z.ZodObject<{
     showPc: z.ZodBoolean;
     showMobile: z.ZodBoolean;
     productSort: z.ZodEnum<{
+      NAME: "NAME";
       RECENT: "RECENT";
       POPULAR: "POPULAR";
       PRICE_LOW: "PRICE_LOW";
       PRICE_HIGH: "PRICE_HIGH";
-      NAME: "NAME";
     }>;
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
@@ -1335,11 +1335,11 @@ export declare const categoryCreateRequestSchema: z.ZodObject<{
   showPc: z.ZodOptional<z.ZodBoolean>;
   showMobile: z.ZodOptional<z.ZodBoolean>;
   productSort: z.ZodOptional<z.ZodEnum<{
+    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
-    NAME: "NAME";
   }>>;
   metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1354,11 +1354,11 @@ export declare const categoryPatchRequestSchema: z.ZodObject<{
   showPc: z.ZodOptional<z.ZodBoolean>;
   showMobile: z.ZodOptional<z.ZodBoolean>;
   productSort: z.ZodOptional<z.ZodEnum<{
+    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
-    NAME: "NAME";
   }>>;
   metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1725,8 +1725,8 @@ export declare const couponStatusSchema: z.ZodEnum<{
 export type CouponStatus = z.infer<typeof couponStatusSchema>;
 /** 지금 만들 수 있는 발급 방식 — 다운로드·가입 자동 지급은 뒤 단계다 */
 export declare const couponIssueMethodSchema: z.ZodEnum<{
-  CODE: "CODE";
   MANUAL: "MANUAL";
+  CODE: "CODE";
 }>;
 export type CouponIssueMethod = z.infer<typeof couponIssueMethodSchema>;
 /** 코드 형식 — 영문·숫자·`-`·`_` 6~30자. 대소문자를 구분하지 않고 서버가 대문자로 저장한다 */
@@ -1777,8 +1777,8 @@ export declare const createCouponRequestSchema: z.ZodObject<{
     excludeCategoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
   }, z.core.$strict>>;
   issueMethod: z.ZodEnum<{
-    CODE: "CODE";
     MANUAL: "MANUAL";
+    CODE: "CODE";
   }>;
   code: z.ZodOptional<z.ZodString>;
   startsAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
@@ -1895,8 +1895,8 @@ export declare const couponListQuerySchema: z.ZodObject<{
     DELIVERY: "DELIVERY";
   }>>;
   issueMethod: z.ZodOptional<z.ZodEnum<{
-    CODE: "CODE";
     MANUAL: "MANUAL";
+    CODE: "CODE";
   }>>;
   q: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -2314,180 +2314,6 @@ export declare const customerWithdrawalBlockedDetailsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type CustomerWithdrawalBlockedDetails = z.infer<typeof customerWithdrawalBlockedDetailsSchema>;
 //#endregion
-//#region src/schemas/digital-asset.d.ts
-/**
- * 파일 다운로드 상품의 판매 파일 (이슈 #48 단계 3).
- *
- * 파일은 CDN **비공개 객체**다. `POST /v1/uploads`(`purpose: "digital-asset"`)로 자리를 받아 응답의 `headers`와 함께 PUT하고,
- * 응답의 `key`로 상품에 연결한다. 객체 키와 파일 주소는 어떤 응답에도 싣지 않는다 — 구매자는 제공된 주문상품에서
- * 수명 300초의 서명 주소로만 받는다. 주문은 주문 시점 파일을 스냅샷하므로 파일을 바꿔도 이미 산 구매자는 옛 파일을 받는다.
- */
-export declare const digitalAssetAttachRequestSchema: z.ZodObject<{
-  key: z.ZodString;
-  fileName: z.ZodString;
-  sizeBytes: z.ZodOptional<z.ZodNumber>;
-  contentType: z.ZodOptional<z.ZodString>;
-  variantId: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type DigitalAssetAttachRequest = z.infer<typeof digitalAssetAttachRequestSchema>;
-/** 판매 파일 — 객체 키·주소는 싣지 않는다 */
-export declare const digitalAssetSchema: z.ZodObject<{
-  assetId: z.ZodString;
-  productId: z.ZodString;
-  variantId: z.ZodNullable<z.ZodString>;
-  fileName: z.ZodString;
-  contentType: z.ZodNullable<z.ZodString>;
-  sizeBytes: z.ZodNullable<z.ZodNumber>;
-  status: z.ZodString;
-  createdAt: z.ZodString;
-}, z.core.$strip>;
-export type DigitalAsset = z.infer<typeof digitalAssetSchema>;
-/** 셀러 확인용 서명 주소 — `POST /v1/products/{productId}/digital-assets/{assetId}/preview-url` */
-export declare const digitalAssetPreviewSchema: z.ZodObject<{
-  url: z.ZodURL;
-  expiresAt: z.ZodString;
-}, z.core.$strip>;
-export type DigitalAssetPreview = z.infer<typeof digitalAssetPreviewSchema>;
-/** 주문상품의 다운로드 제공 정보 — 주문 응답의 `fulfillment.download` */
-export declare const orderItemDownloadSchema: z.ZodObject<{
-  count: z.ZodNumber;
-  limit: z.ZodNumber;
-  expiresAt: z.ZodNullable<z.ZodString>;
-  firstDownloadedAt: z.ZodNullable<z.ZodString>;
-  files: z.ZodArray<z.ZodObject<{
-    assetId: z.ZodString;
-    fileName: z.ZodString;
-    sizeBytes: z.ZodNullable<z.ZodNumber>;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-export type OrderItemDownload = z.infer<typeof orderItemDownloadSchema>;
-//#endregion
-//#region src/schemas/fulfillment-code.d.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` 셀러가 폐기함
- */
-export declare const fulfillmentCodeStatusSchema: z.ZodEnum<{
-  REVOKED: "REVOKED";
-  AVAILABLE: "AVAILABLE";
-  ASSIGNED: "ASSIGNED";
-  EXPIRED: "EXPIRED";
-  VOID: "VOID";
-}>;
-export type FulfillmentCodeStatus = z.infer<typeof fulfillmentCodeStatusSchema>;
-/** 한 번에 올릴 수 있는 코드 수 */
-export declare const MAX_CODES_PER_UPLOAD = 10000;
-/** 코드 한 개의 최대 길이 */
-export declare const MAX_CODE_LENGTH = 200;
-/**
- * 코드 일괄 업로드 요청 — `POST /v1/products/{productId}/codes`. `codes`(배열)와 `csv`(본문) 중 하나를 보낸다.
- * 앞뒤 공백은 지우고 빈 줄은 건너뛴다. 같은 상품에 이미 있는 코드와 요청 안의 중복은 받지 않는다(`duplicates`).
- */
-export declare const fulfillmentCodeUploadRequestSchema: z.ZodObject<{
-  variantId: z.ZodOptional<z.ZodString>;
-  codes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  csv: z.ZodOptional<z.ZodString>;
-  expiresAt: z.ZodOptional<z.ZodISODateTime>;
-}, z.core.$strip>;
-export type FulfillmentCodeUploadRequest = z.infer<typeof fulfillmentCodeUploadRequestSchema>;
-/** 받지 않은 줄 */
-export declare const fulfillmentCodeRejectionSchema: z.ZodObject<{
-  line: z.ZodNumber;
-  reason: z.ZodString;
-}, z.core.$strip>;
-/** 업로드 결과 — 배치 요약 */
-export declare const fulfillmentCodeBatchSchema: z.ZodObject<{
-  batchId: z.ZodString;
-  productId: z.ZodString;
-  variantId: z.ZodString;
-  total: z.ZodNumber;
-  accepted: z.ZodNumber;
-  duplicates: z.ZodNumber;
-  rejected: z.ZodArray<z.ZodObject<{
-    line: z.ZodNumber;
-    reason: z.ZodString;
-  }, z.core.$strip>>;
-  expiresAt: z.ZodNullable<z.ZodString>;
-  createdAt: z.ZodString;
-}, z.core.$strip>;
-export type FulfillmentCodeBatch = z.infer<typeof fulfillmentCodeBatchSchema>;
-/** 코드 목록의 한 줄 — **가린 값만** 싣는다 */
-export declare const fulfillmentCodeSchema: z.ZodObject<{
-  codeId: z.ZodString;
-  productId: z.ZodString;
-  variantId: z.ZodString;
-  batchId: z.ZodNullable<z.ZodString>;
-  hint: z.ZodString;
-  status: z.ZodString;
-  orderItemId: z.ZodNullable<z.ZodString>;
-  assignedAt: z.ZodNullable<z.ZodString>;
-  revealedAt: z.ZodNullable<z.ZodString>;
-  expiresAt: z.ZodNullable<z.ZodString>;
-  createdAt: z.ZodString;
-}, z.core.$strip>;
-export type FulfillmentCode = z.infer<typeof fulfillmentCodeSchema>;
-export declare const fulfillmentCodePageSchema: z.ZodObject<{
-  page: z.ZodNumber;
-  size: z.ZodNumber;
-  totalElements: z.ZodNumber;
-  totalPages: z.ZodNumber;
-  contents: z.ZodArray<z.ZodObject<{
-    codeId: z.ZodString;
-    productId: z.ZodString;
-    variantId: z.ZodString;
-    batchId: z.ZodNullable<z.ZodString>;
-    hint: z.ZodString;
-    status: z.ZodString;
-    orderItemId: z.ZodNullable<z.ZodString>;
-    assignedAt: z.ZodNullable<z.ZodString>;
-    revealedAt: z.ZodNullable<z.ZodString>;
-    expiresAt: z.ZodNullable<z.ZodString>;
-    createdAt: z.ZodString;
-  }, z.core.$strip>>;
-  available: z.ZodNumber;
-}, z.core.$strip>;
-export type FulfillmentCodePage = z.infer<typeof fulfillmentCodePageSchema>;
-/** `GET /v1/products/{productId}/codes` 쿼리 */
-export declare const fulfillmentCodeListQuerySchema: z.ZodObject<{
-  page: z.ZodOptional<z.ZodString>;
-  size: z.ZodOptional<z.ZodString>;
-  status: z.ZodOptional<z.ZodEnum<{
-    REVOKED: "REVOKED";
-    AVAILABLE: "AVAILABLE";
-    ASSIGNED: "ASSIGNED";
-    EXPIRED: "EXPIRED";
-    VOID: "VOID";
-  }>>;
-  variantId: z.ZodOptional<z.ZodString>;
-  batchId: z.ZodOptional<z.ZodString>;
-  orderItemId: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-/** 셀러 콘솔 코드 열람 응답 — `POST /v1/fulfillment-codes/{codeId}/reveal` */
-export declare const fulfillmentCodeRevealSchema: z.ZodObject<{
-  codeId: z.ZodString;
-  code: z.ZodString;
-}, z.core.$strip>;
-export type FulfillmentCodeReveal = z.infer<typeof fulfillmentCodeRevealSchema>;
-/** 주문상품에 배정된 코드의 가린 값 — 주문 응답의 `fulfillment.codes` */
-export declare const orderItemCodeSchema: z.ZodObject<{
-  codeId: z.ZodString;
-  hint: z.ZodString;
-  status: z.ZodString;
-  revealedAt: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-export type OrderItemCode = z.infer<typeof orderItemCodeSchema>;
-//#endregion
 //#region src/schemas/login.d.ts
 /** 소셜 로그인 공급자 */
 export declare const loginProviderSchema: z.ZodEnum<{
@@ -3152,65 +2978,45 @@ export type ReviewReportResult = z.infer<typeof reviewReportResultSchema>;
 //#endregion
 //#region src/schemas/fulfillment.d.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`은 셀러가 직접 제공한다는 뜻이다.
  */
 export declare const fulfillmentTypeSchema: z.ZodEnum<{
   SHIPPING: "SHIPPING";
-  DOWNLOAD: "DOWNLOAD";
-  CODE: "CODE";
-  SERVICE: "SERVICE";
-  PICKUP: "PICKUP";
-}>;
-export type FulfillmentType = z.infer<typeof fulfillmentTypeSchema>;
-/** 제공 방식 — `AUTO`는 결제 확정과 함께 제공하고, `MANUAL`은 셀러가 제공 처리한다 */
-export declare const fulfillmentModeSchema: z.ZodEnum<{
-  AUTO: "AUTO";
   MANUAL: "MANUAL";
 }>;
-export type FulfillmentMode = z.infer<typeof fulfillmentModeSchema>;
+export type FulfillmentType = z.infer<typeof fulfillmentTypeSchema>;
 /**
  * 응답 스키마용 유형 — 서버가 나중에 유형을 더해도 옛 SDK가 응답 파싱에서 깨지지 않게 문자열로 받는다.
  * 요청은 `fulfillmentTypeSchema`(닫힌 enum)로 검증한다.
  */
 export declare const fulfillmentTypeResponseSchema: z.ZodString;
-/** 유형 하나의 규칙 — 배송·제공·재고·클레임이 이 표를 읽는다 */
+/** 유형 하나의 규칙 — 배송·클레임이 이 표를 읽는다 */
 export interface FulfillmentRule {
   /** 택배 배송이 필요한가 — 배송비·배송지·발송 흐름의 대상인가 */
   requiresShipping: boolean;
-  /** 허용하는 제공 방식. 배송 상품은 제공 방식이 없다(빈 배열) */
-  modes: readonly FulfillmentMode[];
-  /** 제공 방식을 정하지 않았을 때의 기본값. 배송 상품은 null */
-  defaultMode: FulfillmentMode | null;
-  /** 반품에 수거가 필요한가 — 실물만 수거한다(방문 수령 포함) */
+  /** 반품에 수거가 필요한가 — 실물만 수거한다 */
   requiresCollection: boolean;
   /** 교환을 받는가 — 실물만 받는다 */
   exchangeSupported: boolean;
 }
-/**
- * 유형별 규칙표 — **유일한 원천이다.**
- *
- * `PICKUP`은 실물이라 반품 수거와 교환을 받지만 택배 배송은 없다. `DOWNLOAD`는 결제 즉시 권한을 발급하므로 `AUTO`만,
- * `PICKUP`은 셀러가 수령 완료를 누르므로 `MANUAL`만 둔다.
- */
+/** 유형별 규칙표 — **유일한 원천이다.** */
 export declare const FULFILLMENT_RULES: Readonly<Record<FulfillmentType, FulfillmentRule>>;
 /**
- * 저장된 값 → 유형. null·모르는 값은 `SHIPPING`이다 — 이 필드 이전의 주문상품(`order_items.fulfillment_type` null)과
- * 상품은 모두 배송 상품이었다.
+ * 저장된 값 → 유형. null·모르는 값은 `SHIPPING`이다 — 이 필드 이전의 상품·주문상품은 모두 배송 상품이었다.
  */
 export declare function fulfillmentTypeOf(value: string | null | undefined): FulfillmentType;
 /** 유형의 규칙 — 모르는 값은 배송 상품 규칙이다 */
@@ -3219,11 +3025,6 @@ export declare function fulfillmentRuleOf(type: string | null | undefined): Fulf
 export declare function requiresShipping(type: string | null | undefined): boolean;
 /** 반품에 수거가 필요한가 — 비실물 반품은 수거 등록·수거 완료 없이 승인한다 */
 export declare function requiresCollection(type: string | null | undefined): boolean;
-/**
- * 유효 제공 방식 — 요청 값이 유형에 허용되면 그 값, 생략이면 유형 기본값이다. 배송 상품은 null이다.
- * 허용되지 않는 값은 `null`을 돌려주지 않고 호출부가 거부하도록 `undefined`를 돌려준다.
- */
-export declare function resolveFulfillmentMode(type: FulfillmentType, mode: FulfillmentMode | null | undefined): FulfillmentMode | null | undefined;
 /**
  * 배송이 없는 주문상품의 배송 묶음 키 (`order_items.delivery_bundle_key`).
  *
@@ -3239,13 +3040,8 @@ export declare const deliveryTypeSchema: z.ZodEnum<{
   CONDITIONAL_FREE: "CONDITIONAL_FREE";
 }>;
 export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
-/** 파일 다운로드 기본값 — 횟수 5회·기간 30일(#48 결정 8) */
-export declare const DOWNLOAD_DEFAULTS: {
-  readonly limit: 5;
-  readonly days: 30;
-};
 /**
- * 상품 이행 — 등록(POST). 유형 키를 생략하면 그 유형의 기본값이다(`{ "type": "DOWNLOAD" }`만으로 등록할 수 있다).
+ * 상품 이행 — 등록(POST). 배송 상품의 `shipping`을 생략하면 기본값(유료 배송·스토어 기본 배송비·기본 출고지·반품지)이다.
  */
 export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   type: z.ZodLiteral<"SHIPPING">;
@@ -3261,35 +3057,7 @@ export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.
     returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   }, z.core.$strict>>;
 }, z.core.$strict>, z.ZodObject<{
-  type: z.ZodLiteral<"DOWNLOAD">;
-  download: z.ZodDefault<z.ZodObject<{
-    limit: z.ZodDefault<z.ZodNumber>;
-    days: z.ZodDefault<z.ZodNumber>;
-    stockTracking: z.ZodDefault<z.ZodBoolean>;
-    withdrawalRestricted: z.ZodDefault<z.ZodBoolean>;
-  }, z.core.$strict>>;
-}, z.core.$strict>, z.ZodObject<{
-  type: z.ZodLiteral<"CODE">;
-  code: z.ZodDefault<z.ZodObject<{
-    mode: z.ZodDefault<z.ZodEnum<{
-      AUTO: "AUTO";
-      MANUAL: "MANUAL";
-    }>>;
-    withdrawalRestricted: z.ZodDefault<z.ZodBoolean>;
-  }, z.core.$strict>>;
-}, z.core.$strict>, z.ZodObject<{
-  type: z.ZodLiteral<"SERVICE">;
-  service: z.ZodDefault<z.ZodObject<{
-    mode: z.ZodDefault<z.ZodEnum<{
-      AUTO: "AUTO";
-      MANUAL: "MANUAL";
-    }>>;
-  }, z.core.$strict>>;
-}, z.core.$strict>, z.ZodObject<{
-  type: z.ZodLiteral<"PICKUP">;
-  pickup: z.ZodDefault<z.ZodObject<{
-    addressId: z.ZodOptional<z.ZodString>;
-  }, z.core.$strict>>;
+  type: z.ZodLiteral<"MANUAL">;
 }, z.core.$strict>], "type">;
 export type ProductFulfillmentCreate = z.infer<typeof productFulfillmentCreateSchema>;
 /** 등록 요청의 입력 모양 — 기본값이 채워지기 전(생략 가능한 필드가 optional) */
@@ -3312,35 +3080,7 @@ export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.
     returnAddressId: z.ZodNullable<z.ZodString>;
   }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
-  type: z.ZodLiteral<"DOWNLOAD">;
-  download: z.ZodObject<{
-    limit: z.ZodNumber;
-    days: z.ZodNumber;
-    stockTracking: z.ZodBoolean;
-    withdrawalRestricted: z.ZodBoolean;
-  }, z.core.$strict>;
-}, z.core.$strict>, z.ZodObject<{
-  type: z.ZodLiteral<"CODE">;
-  code: z.ZodObject<{
-    mode: z.ZodEnum<{
-      AUTO: "AUTO";
-      MANUAL: "MANUAL";
-    }>;
-    withdrawalRestricted: z.ZodBoolean;
-  }, z.core.$strict>;
-}, z.core.$strict>, z.ZodObject<{
-  type: z.ZodLiteral<"SERVICE">;
-  service: z.ZodObject<{
-    mode: z.ZodEnum<{
-      AUTO: "AUTO";
-      MANUAL: "MANUAL";
-    }>;
-  }, z.core.$strict>;
-}, z.core.$strict>, z.ZodObject<{
-  type: z.ZodLiteral<"PICKUP">;
-  pickup: z.ZodObject<{
-    addressId: z.ZodString;
-  }, z.core.$strict>;
+  type: z.ZodLiteral<"MANUAL">;
 }, z.core.$strict>], "type">;
 export type ProductFulfillmentUpdate = z.infer<typeof productFulfillmentUpdateSchema>;
 /**
@@ -3361,35 +3101,7 @@ export declare const productFulfillmentSchema: z.ZodDiscriminatedUnion<[z.ZodObj
     returnAddressId: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"DOWNLOAD">;
-  download: z.ZodObject<{
-    limit: z.ZodNumber;
-    days: z.ZodNumber;
-    stockTracking: z.ZodBoolean;
-    withdrawalRestricted: z.ZodBoolean;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"CODE">;
-  code: z.ZodObject<{
-    mode: z.ZodEnum<{
-      AUTO: "AUTO";
-      MANUAL: "MANUAL";
-    }>;
-    withdrawalRestricted: z.ZodBoolean;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"SERVICE">;
-  service: z.ZodObject<{
-    mode: z.ZodEnum<{
-      AUTO: "AUTO";
-      MANUAL: "MANUAL";
-    }>;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"PICKUP">;
-  pickup: z.ZodObject<{
-    addressId: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>;
+  type: z.ZodLiteral<"MANUAL">;
 }, z.core.$strip>], "type">;
 export type ProductFulfillment = z.infer<typeof productFulfillmentSchema>;
 /** 유형 이름 → 그 유형의 저장된 이행 */
@@ -3428,35 +3140,7 @@ export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.Zo
     returnAddressId: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"DOWNLOAD">;
-  download: z.ZodObject<{
-    limit: z.ZodNumber;
-    days: z.ZodNumber;
-    stockTracking: z.ZodBoolean;
-    withdrawalRestricted: z.ZodBoolean;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"CODE">;
-  code: z.ZodObject<{
-    mode: z.ZodEnum<{
-      AUTO: "AUTO";
-      MANUAL: "MANUAL";
-    }>;
-    withdrawalRestricted: z.ZodBoolean;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"SERVICE">;
-  service: z.ZodObject<{
-    mode: z.ZodEnum<{
-      AUTO: "AUTO";
-      MANUAL: "MANUAL";
-    }>;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"PICKUP">;
-  pickup: z.ZodObject<{
-    addressId: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>;
+  type: z.ZodLiteral<"MANUAL">;
 }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
   type: z.ZodString;
 }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -3464,21 +3148,9 @@ export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.Zo
   type: string;
 }>>]>;
 export type ProductFulfillmentView = z.infer<typeof productFulfillmentResponseSchema>;
-/** 제공 방식 — CODE·SERVICE는 저장된 값, DOWNLOAD는 AUTO, PICKUP은 MANUAL, 배송 상품은 null */
-export declare function fulfillmentModeOf(fulfillment: ProductFulfillment): FulfillmentMode | null;
-/** 재고를 세는가 — 파일 다운로드만 끌 수 있다 */
-export declare function stockTrackingOf(fulfillment: ProductFulfillment): boolean;
-/** 청약철회 제한 대상인가 — 파일 다운로드·코드 발급만 켤 수 있다(전자상거래법 제17조 제2항 제5호, 디지털 콘텐츠) */
-export declare function withdrawalRestrictedOf(fulfillment: ProductFulfillment): boolean;
-/** 코드 풀을 쓰는가 — 코드 발급 + 자동 제공. 재고가 판매 가능 코드 수다 */
-export declare function usesCodePool(fulfillment: ProductFulfillment): boolean;
-/** 결제 확정과 함께 제공까지 끝내는가 — 비실물 + 자동 제공 */
-export declare function autoFulfillableOf(fulfillment: ProductFulfillment): boolean;
 /**
  * 주문상품의 주문 시점 이행 — 결제 확정이 주문서 줄에서 굳힌다. 상품의 현재 값이 아니다. 서버는 주문상품 컬럼
- * (`fulfillment_type`·`delivery_bundle_key`·`stock_tracked`·`withdrawal_restricted`)과 jsonb(`fulfillment_snapshot`)를 합쳐 이 모양을 만든다.
- *
- * `mode`는 **주문 시점 상품의 방식**이다. 실제 제공 방식은 제공 기록(`fulfillment.mode`)에 있고 다를 수 있다(자동 제공 상품의 수동 복구).
+ * (`fulfillment_type`·`delivery_bundle_key`)과 jsonb(`fulfillment_snapshot`)를 합쳐 이 모양을 만든다.
  */
 export declare const orderItemFulfillmentSnapshotSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   type: z.ZodLiteral<"SHIPPING">;
@@ -3487,29 +3159,7 @@ export declare const orderItemFulfillmentSnapshotSchema: z.ZodDiscriminatedUnion
     returnAddressId: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"DOWNLOAD">;
-  download: z.ZodObject<{
-    limit: z.ZodNumber;
-    days: z.ZodNumber;
-    stockTracked: z.ZodBoolean;
-    withdrawalRestricted: z.ZodBoolean;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"CODE">;
-  code: z.ZodObject<{
-    mode: z.ZodString;
-    withdrawalRestricted: z.ZodBoolean;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"SERVICE">;
-  service: z.ZodObject<{
-    mode: z.ZodString;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"PICKUP">;
-  pickup: z.ZodObject<{
-    addressId: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>;
+  type: z.ZodLiteral<"MANUAL">;
 }, z.core.$strip>], "type">;
 export type OrderItemFulfillmentSnapshot = z.infer<typeof orderItemFulfillmentSnapshotSchema>;
 export declare const orderItemFulfillmentSnapshotResponseSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -3519,29 +3169,7 @@ export declare const orderItemFulfillmentSnapshotResponseSchema: z.ZodUnion<read
     returnAddressId: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"DOWNLOAD">;
-  download: z.ZodObject<{
-    limit: z.ZodNumber;
-    days: z.ZodNumber;
-    stockTracked: z.ZodBoolean;
-    withdrawalRestricted: z.ZodBoolean;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"CODE">;
-  code: z.ZodObject<{
-    mode: z.ZodString;
-    withdrawalRestricted: z.ZodBoolean;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"SERVICE">;
-  service: z.ZodObject<{
-    mode: z.ZodString;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"PICKUP">;
-  pickup: z.ZodObject<{
-    addressId: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>;
+  type: z.ZodLiteral<"MANUAL">;
 }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
   type: z.ZodString;
 }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -3580,40 +3208,13 @@ export declare const shippingAddressSchema: z.ZodObject<{
   entranceCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type ShippingAddress = z.infer<typeof shippingAddressSchema>;
-/** 비실물 주문상품의 제공 정보 (이슈 #48) */
+/** 배송 없는 주문상품(`MANUAL`)의 제공 기록 (이슈 #48) — 셀러의 제공 처리가 만든다 */
 export declare const orderItemFulfillmentSchema: z.ZodObject<{
   status: z.ZodString;
-  mode: z.ZodNullable<z.ZodString>;
   fulfilledAt: z.ZodString;
   note: z.ZodNullable<z.ZodString>;
-  codes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-    codeId: z.ZodString;
-    hint: z.ZodString;
-    status: z.ZodString;
-    revealedAt: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>>>>;
-  download: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-    count: z.ZodNumber;
-    limit: z.ZodNumber;
-    expiresAt: z.ZodNullable<z.ZodString>;
-    firstDownloadedAt: z.ZodNullable<z.ZodString>;
-    files: z.ZodArray<z.ZodObject<{
-      assetId: z.ZodString;
-      fileName: z.ZodString;
-      sizeBytes: z.ZodNullable<z.ZodNumber>;
-    }, z.core.$strip>>;
-  }, z.core.$strip>>>>;
-  mail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-    status: z.ZodString;
-    sentAt: z.ZodNullable<z.ZodString>;
-    errorCode: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>>>>;
+  mode: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-/** 제공 안내 메일 재발송 결과 */
-export declare const fulfillmentMailResendSchema: z.ZodObject<{
-  mailStatus: z.ZodString;
-}, z.core.$strip>;
-export type FulfillmentMailResend = z.infer<typeof fulfillmentMailResendSchema>;
 export type OrderItemFulfillment = z.infer<typeof orderItemFulfillmentSchema>;
 export declare const orderItemSchema: z.ZodObject<{
   orderItemId: z.ZodString;
@@ -3637,6 +3238,16 @@ export declare const orderItemSchema: z.ZodObject<{
   productName: z.ZodString;
   optionId: z.ZodNullable<z.ZodString>;
   optionName: z.ZodNullable<z.ZodString>;
+  optionSelections: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    kind: z.ZodString;
+    groupName: z.ZodString;
+    valueName: z.ZodString;
+    additionalPrice: z.ZodNumber;
+  }, z.core.$strip>>>>;
+  customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+  }, z.core.$strip>>>>;
   sellerCode: z.ZodNullable<z.ZodString>;
   fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
@@ -3645,29 +3256,7 @@ export declare const orderItemSchema: z.ZodObject<{
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
   }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"DOWNLOAD">;
-    download: z.ZodObject<{
-      limit: z.ZodNumber;
-      days: z.ZodNumber;
-      stockTracked: z.ZodBoolean;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"CODE">;
-    code: z.ZodObject<{
-      mode: z.ZodString;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"SERVICE">;
-    service: z.ZodObject<{
-      mode: z.ZodString;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"PICKUP">;
-    pickup: z.ZodObject<{
-      addressId: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>;
+    type: z.ZodLiteral<"MANUAL">;
   }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
     type: z.ZodString;
   }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -3687,31 +3276,9 @@ export declare const orderItemSchema: z.ZodObject<{
   }, z.core.$strip>>;
   fulfillment: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
     status: z.ZodString;
-    mode: z.ZodNullable<z.ZodString>;
     fulfilledAt: z.ZodString;
     note: z.ZodNullable<z.ZodString>;
-    codes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-      codeId: z.ZodString;
-      hint: z.ZodString;
-      status: z.ZodString;
-      revealedAt: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>>>;
-    download: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-      count: z.ZodNumber;
-      limit: z.ZodNumber;
-      expiresAt: z.ZodNullable<z.ZodString>;
-      firstDownloadedAt: z.ZodNullable<z.ZodString>;
-      files: z.ZodArray<z.ZodObject<{
-        assetId: z.ZodString;
-        fileName: z.ZodString;
-        sizeBytes: z.ZodNullable<z.ZodNumber>;
-      }, z.core.$strip>>;
-    }, z.core.$strip>>>>;
-    mail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-      status: z.ZodString;
-      sentAt: z.ZodNullable<z.ZodString>;
-      errorCode: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>>>;
+    mode: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>>>;
   autoDecisionDate: z.ZodNullable<z.ZodString>;
   sellerMemo: z.ZodNullable<z.ZodString>;
@@ -3807,7 +3374,6 @@ export declare const orderSchema: z.ZodObject<{
       updatedAt: z.ZodString;
     }, z.core.$strip>>>>;
   }, z.core.$strip>;
-  withdrawalAgreedAt: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   testPayment: z.ZodBoolean;
   items: z.ZodArray<z.ZodObject<{
     orderItemId: z.ZodString;
@@ -3831,6 +3397,16 @@ export declare const orderSchema: z.ZodObject<{
     productName: z.ZodString;
     optionId: z.ZodNullable<z.ZodString>;
     optionName: z.ZodNullable<z.ZodString>;
+    optionSelections: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      kind: z.ZodString;
+      groupName: z.ZodString;
+      valueName: z.ZodString;
+      additionalPrice: z.ZodNumber;
+    }, z.core.$strip>>>>;
+    customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodString;
+    }, z.core.$strip>>>>;
     sellerCode: z.ZodNullable<z.ZodString>;
     fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"SHIPPING">;
@@ -3839,29 +3415,7 @@ export declare const orderSchema: z.ZodObject<{
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"DOWNLOAD">;
-      download: z.ZodObject<{
-        limit: z.ZodNumber;
-        days: z.ZodNumber;
-        stockTracked: z.ZodBoolean;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"CODE">;
-      code: z.ZodObject<{
-        mode: z.ZodString;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"SERVICE">;
-      service: z.ZodObject<{
-        mode: z.ZodString;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"PICKUP">;
-      pickup: z.ZodObject<{
-        addressId: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>;
+      type: z.ZodLiteral<"MANUAL">;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -3881,31 +3435,9 @@ export declare const orderSchema: z.ZodObject<{
     }, z.core.$strip>>;
     fulfillment: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
       status: z.ZodString;
-      mode: z.ZodNullable<z.ZodString>;
       fulfilledAt: z.ZodString;
       note: z.ZodNullable<z.ZodString>;
-      codes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-        codeId: z.ZodString;
-        hint: z.ZodString;
-        status: z.ZodString;
-        revealedAt: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>>>>;
-      download: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        count: z.ZodNumber;
-        limit: z.ZodNumber;
-        expiresAt: z.ZodNullable<z.ZodString>;
-        firstDownloadedAt: z.ZodNullable<z.ZodString>;
-        files: z.ZodArray<z.ZodObject<{
-          assetId: z.ZodString;
-          fileName: z.ZodString;
-          sizeBytes: z.ZodNullable<z.ZodNumber>;
-        }, z.core.$strip>>;
-      }, z.core.$strip>>>>;
-      mail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        status: z.ZodString;
-        sentAt: z.ZodNullable<z.ZodString>;
-        errorCode: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>>>>;
+      mode: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
     autoDecisionDate: z.ZodNullable<z.ZodString>;
     sellerMemo: z.ZodNullable<z.ZodString>;
@@ -3981,6 +3513,16 @@ export declare const orderItemPageSchema: z.ZodObject<{
     productName: z.ZodString;
     optionId: z.ZodNullable<z.ZodString>;
     optionName: z.ZodNullable<z.ZodString>;
+    optionSelections: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      kind: z.ZodString;
+      groupName: z.ZodString;
+      valueName: z.ZodString;
+      additionalPrice: z.ZodNumber;
+    }, z.core.$strip>>>>;
+    customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodString;
+    }, z.core.$strip>>>>;
     sellerCode: z.ZodNullable<z.ZodString>;
     fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"SHIPPING">;
@@ -3989,29 +3531,7 @@ export declare const orderItemPageSchema: z.ZodObject<{
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"DOWNLOAD">;
-      download: z.ZodObject<{
-        limit: z.ZodNumber;
-        days: z.ZodNumber;
-        stockTracked: z.ZodBoolean;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"CODE">;
-      code: z.ZodObject<{
-        mode: z.ZodString;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"SERVICE">;
-      service: z.ZodObject<{
-        mode: z.ZodString;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"PICKUP">;
-      pickup: z.ZodObject<{
-        addressId: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>;
+      type: z.ZodLiteral<"MANUAL">;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -4031,31 +3551,9 @@ export declare const orderItemPageSchema: z.ZodObject<{
     }, z.core.$strip>>;
     fulfillment: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
       status: z.ZodString;
-      mode: z.ZodNullable<z.ZodString>;
       fulfilledAt: z.ZodString;
       note: z.ZodNullable<z.ZodString>;
-      codes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-        codeId: z.ZodString;
-        hint: z.ZodString;
-        status: z.ZodString;
-        revealedAt: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>>>>;
-      download: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        count: z.ZodNumber;
-        limit: z.ZodNumber;
-        expiresAt: z.ZodNullable<z.ZodString>;
-        firstDownloadedAt: z.ZodNullable<z.ZodString>;
-        files: z.ZodArray<z.ZodObject<{
-          assetId: z.ZodString;
-          fileName: z.ZodString;
-          sizeBytes: z.ZodNullable<z.ZodNumber>;
-        }, z.core.$strip>>;
-      }, z.core.$strip>>>>;
-      mail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        status: z.ZodString;
-        sentAt: z.ZodNullable<z.ZodString>;
-        errorCode: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>>>>;
+      mode: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
     autoDecisionDate: z.ZodNullable<z.ZodString>;
     sellerMemo: z.ZodNullable<z.ZodString>;
@@ -4262,12 +3760,11 @@ export declare const cancelBySellerRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type CancelBySellerRequest = z.infer<typeof cancelBySellerRequestSchema>;
 /**
- * 제공 처리 요청 (이슈 #48) — `POST /v1/order-items/{orderItemId}/fulfill`. 수동 제공 비실물 주문상품(이용권·방문 수령 등)을
+ * 제공 처리 요청 (이슈 #48) — `POST /v1/order-items/{orderItemId}/fulfill`. 배송 없는 주문상품(`MANUAL`)을
  * 제공 완료(`DELIVERED`)로 바꾼다.
  */
 export declare const fulfillRequestSchema: z.ZodObject<{
   note: z.ZodOptional<z.ZodString>;
-  codes: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type FulfillRequest = z.infer<typeof fulfillRequestSchema>;
 /** 제공 처리 일괄 요청 — `POST /v1/order-items/fulfill` */
@@ -5384,30 +4881,146 @@ export declare const productVariantSchema: z.ZodObject<{
   weightGram: z.ZodNullable<z.ZodNumber>;
   sellerCode: z.ZodNullable<z.ZodString>;
   usable: z.ZodBoolean;
+  hasOrders: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type ProductVariant = z.infer<typeof productVariantSchema>;
-export declare const discountSchema: z.ZodObject<{
-  productId: z.ZodString;
-  discountType: z.ZodEnum<{
-    RATE: "RATE";
-    AMOUNT: "AMOUNT";
-  }>;
-  discountValue: z.ZodNumber;
-  discountedPrice: z.ZodNumber;
-  startAt: z.ZodNullable<z.ZodString>;
-  endAt: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-export type Discount = z.infer<typeof discountSchema>;
-export declare const productSchema: z.ZodObject<{
-  productId: z.ZodString;
-  name: z.ZodString;
-  status: z.ZodEnum<{
-    SALE: "SALE";
-    SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
-    CLOSED: "CLOSED";
-  }>;
-  salePrice: z.ZodNumber;
+/** 옵션 축(그룹) 최대 개수 — 스키마 상한의 단일 원천 */
+export declare const MAX_OPTION_GROUPS = 3;
+/** 축 하나가 가질 수 있는 값의 최대 개수 */
+export declare const MAX_VALUES_PER_GROUP = 100;
+/** 상품 하나가 가질 수 있는 variant(SKU) 최대 개수 */
+export declare const MAX_VARIANTS = 500;
+/** 추가 선택 옵션명 최대 개수 */
+export declare const MAX_ADDON_GROUPS = 5;
+/** 직접 입력 항목 최대 개수 */
+export declare const MAX_CUSTOM_INPUTS = 5;
+/** 직접 입력 항목 최대 글자 수의 상한 */
+export declare const MAX_CUSTOM_INPUT_LENGTH = 200;
+/** 조합 수가 이 값 이상이면 콘솔이 경고한다(상한은 `MAX_VARIANTS`) */
+export declare const VARIANT_COUNT_WARNING = 100;
+/**
+ * 옵션 값 정렬 순서 — 등록순·가나다순·낮은 추가금순·높은 추가금순. 서버가 저장할 때 이 순서로 값의 `sortOrder`를 매긴다.
+ * 추가금순은 추가 선택 값이면 값의 추가금, 조합 값이면 그 값이 든 조합 추가금의 최솟값으로 비교하고 같으면 등록순이다.
+ */
+export declare const optionSortSchema: z.ZodEnum<{
+  REGISTERED: "REGISTERED";
+  NAME: "NAME";
+  PRICE_ASC: "PRICE_ASC";
+  PRICE_DESC: "PRICE_DESC";
+}>;
+export type OptionSort = z.infer<typeof optionSortSchema>;
+/** 추가 선택 값 — 예: 옵션명 "선물 포장"의 값 "포장함"(+2,000원) */
+export declare const addonValueSchema: z.ZodObject<{
+  valueId: z.ZodString;
+  name: z.ZodString;
+  sortOrder: z.ZodNumber;
+  additionalPrice: z.ZodNumber;
+  usable: z.ZodBoolean;
+}, z.core.$strip>;
+export type AddonValue = z.infer<typeof addonValueSchema>;
+/** 추가 선택 옵션명 */
+export declare const addonGroupSchema: z.ZodObject<{
+  groupId: z.ZodString;
+  name: z.ZodString;
+  sortOrder: z.ZodNumber;
+  required: z.ZodBoolean;
+  values: z.ZodArray<z.ZodObject<{
+    valueId: z.ZodString;
+    name: z.ZodString;
+    sortOrder: z.ZodNumber;
+    additionalPrice: z.ZodNumber;
+    usable: z.ZodBoolean;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AddonGroup = z.infer<typeof addonGroupSchema>;
+/** 직접 입력 항목 — 예: 각인 문구 */
+export declare const customInputSchema: z.ZodObject<{
+  inputId: z.ZodString;
+  label: z.ZodString;
+  placeholder: z.ZodNullable<z.ZodString>;
+  maxLength: z.ZodNumber;
+  required: z.ZodBoolean;
+  usable: z.ZodBoolean;
+  sortOrder: z.ZodNumber;
+}, z.core.$strip>;
+export type CustomInput = z.infer<typeof customInputSchema>;
+/**
+ * 직접 입력 항목명에 쓸 수 없는 개인정보성 단어 — 콘솔 검사와 서버 400(`CUSTOM_INPUT_LABEL_FORBIDDEN`)이 이 목록 하나를 쓴다.
+ * 구매자 개인정보는 주문 정보로 받는다. 직접 입력 항목으로 받으면 보관·파기 규칙 밖에 남는다.
+ */
+export declare const CUSTOM_INPUT_FORBIDDEN_WORDS: readonly ["연락처", "전화", "휴대폰", "핸드폰", "폰번호", "메일", "주소", "주민", "생년월일", "생일", "실명", "계좌", "카드번호", "비밀번호", "여권", "통관", "phone", "mobile", "mail", "address"];
+/**
+ * 직접 입력 항목명·입력 안내에 든 개인정보성 금지어. 없으면 null. 공백·기호·대소문자·전각을 무시한다.
+ * 서버는 항목명과 입력 안내 둘 다 이 함수로 검사한다(안내에 「연락처를 적어 주십시오」라고 쓰는 우회를 막는다).
+ */
+export declare function customInputLabelForbiddenWord(label: string): string | null;
+export declare const addonValueRequestSchema: z.ZodObject<{
+  valueId: z.ZodOptional<z.ZodString>;
+  name: z.ZodString;
+  additionalPrice: z.ZodDefault<z.ZodNumber>;
+  usable: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AddonValueRequest = z.infer<typeof addonValueRequestSchema>;
+export declare const addonGroupRequestSchema: z.ZodObject<{
+  groupId: z.ZodOptional<z.ZodString>;
+  name: z.ZodString;
+  required: z.ZodDefault<z.ZodBoolean>;
+  values: z.ZodArray<z.ZodObject<{
+    valueId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    additionalPrice: z.ZodDefault<z.ZodNumber>;
+    usable: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AddonGroupRequest = z.infer<typeof addonGroupRequestSchema>;
+export declare const customInputRequestSchema: z.ZodObject<{
+  inputId: z.ZodOptional<z.ZodString>;
+  label: z.ZodString;
+  placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  maxLength: z.ZodNumber;
+  required: z.ZodDefault<z.ZodBoolean>;
+  usable: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CustomInputRequest = z.infer<typeof customInputRequestSchema>;
+/**
+ * 주문상품·장바구니·주문서 줄의 옵션 선택 스냅샷 한 칸 — 주문 시점 이름이다(상품을 고쳐도 바뀌지 않는다).
+ * 조합 옵션은 옵션명마다 한 칸이고 추가금은 조합 단위라 0이다(조합 추가금은 단가에 들어 있다). 추가 선택은 값의 추가금이다.
+ */
+export declare const optionSelectionSchema: z.ZodObject<{
+  kind: z.ZodString;
+  groupName: z.ZodString;
+  valueName: z.ZodString;
+  additionalPrice: z.ZodNumber;
+}, z.core.$strip>;
+export type OptionSelection = z.infer<typeof optionSelectionSchema>;
+/** 구매자가 적은 직접 입력값 — 주문 시점 항목명과 값 */
+export declare const customInputValueSchema: z.ZodObject<{
+  label: z.ZodString;
+  value: z.ZodString;
+}, z.core.$strip>;
+export type CustomInputValue = z.infer<typeof customInputValueSchema>;
+export declare const discountSchema: z.ZodObject<{
+  productId: z.ZodString;
+  discountType: z.ZodEnum<{
+    RATE: "RATE";
+    AMOUNT: "AMOUNT";
+  }>;
+  discountValue: z.ZodNumber;
+  discountedPrice: z.ZodNumber;
+  startAt: z.ZodNullable<z.ZodString>;
+  endAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type Discount = z.infer<typeof discountSchema>;
+export declare const productSchema: z.ZodObject<{
+  productId: z.ZodString;
+  name: z.ZodString;
+  status: z.ZodEnum<{
+    SALE: "SALE";
+    SUSPENDED: "SUSPENDED";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
+    CLOSED: "CLOSED";
+  }>;
+  salePrice: z.ZodNumber;
   discountedPrice: z.ZodNullable<z.ZodNumber>;
   stockQuantity: z.ZodNumber;
   categoryId: z.ZodNullable<z.ZodString>;
@@ -5444,7 +5057,36 @@ export declare const productSchema: z.ZodObject<{
     weightGram: z.ZodNullable<z.ZodNumber>;
     sellerCode: z.ZodNullable<z.ZodString>;
     usable: z.ZodBoolean;
+    hasOrders: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>;
+  addonGroups: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodString;
+    name: z.ZodString;
+    sortOrder: z.ZodNumber;
+    required: z.ZodBoolean;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodString;
+      name: z.ZodString;
+      sortOrder: z.ZodNumber;
+      additionalPrice: z.ZodNumber;
+      usable: z.ZodBoolean;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>>;
+  customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    inputId: z.ZodString;
+    label: z.ZodString;
+    placeholder: z.ZodNullable<z.ZodString>;
+    maxLength: z.ZodNumber;
+    required: z.ZodBoolean;
+    usable: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+  }, z.core.$strip>>>>;
+  optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>>;
   fulfillment: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
@@ -5459,35 +5101,7 @@ export declare const productSchema: z.ZodObject<{
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
   }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"DOWNLOAD">;
-    download: z.ZodObject<{
-      limit: z.ZodNumber;
-      days: z.ZodNumber;
-      stockTracking: z.ZodBoolean;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"CODE">;
-    code: z.ZodObject<{
-      mode: z.ZodEnum<{
-        AUTO: "AUTO";
-        MANUAL: "MANUAL";
-      }>;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"SERVICE">;
-    service: z.ZodObject<{
-      mode: z.ZodEnum<{
-        AUTO: "AUTO";
-        MANUAL: "MANUAL";
-      }>;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"PICKUP">;
-    pickup: z.ZodObject<{
-      addressId: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>;
+    type: z.ZodLiteral<"MANUAL">;
   }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
     type: z.ZodString;
   }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -5543,12 +5157,6 @@ export interface ProductImageRejection {
  *   — 외부 이미지 CDN은 확장자 없는 키를 쓰는 경우가 흔하고, 주소만으로는 실제 형식을 알 수 없다.
  */
 export declare function productImageRejection(url: string): ProductImageRejection | null;
-/** 옵션 축(그룹) 최대 개수 — 스키마 상한의 단일 원천 */
-export declare const MAX_OPTION_GROUPS = 3;
-/** 축 하나가 가질 수 있는 값의 최대 개수 */
-export declare const MAX_VALUES_PER_GROUP = 100;
-/** 상품 하나가 가질 수 있는 variant(SKU) 최대 개수 */
-export declare const MAX_VARIANTS = 500;
 export declare const optionValueRequestSchema: z.ZodObject<{
   valueId: z.ZodOptional<z.ZodString>;
   name: z.ZodString;
@@ -5598,6 +5206,31 @@ export declare const optionModelRequestSchema: z.ZodObject<{
     sellerCode: z.ZodOptional<z.ZodString>;
     usable: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
+  addonGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodOptional<z.ZodString>;
+      name: z.ZodString;
+      additionalPrice: z.ZodDefault<z.ZodNumber>;
+      usable: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  customInputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    inputId: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxLength: z.ZodNumber;
+    required: z.ZodDefault<z.ZodBoolean>;
+    usable: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>>;
+  optionSort: z.ZodOptional<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>;
 }, z.core.$strip>;
 export type OptionModelRequest = z.infer<typeof optionModelRequestSchema>;
 /** GET /products/{productId}/options 응답 */
@@ -5624,7 +5257,36 @@ export declare const optionModelSchema: z.ZodObject<{
     weightGram: z.ZodNullable<z.ZodNumber>;
     sellerCode: z.ZodNullable<z.ZodString>;
     usable: z.ZodBoolean;
+    hasOrders: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>;
+  addonGroups: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodString;
+    name: z.ZodString;
+    sortOrder: z.ZodNumber;
+    required: z.ZodBoolean;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodString;
+      name: z.ZodString;
+      sortOrder: z.ZodNumber;
+      additionalPrice: z.ZodNumber;
+      usable: z.ZodBoolean;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>>;
+  customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    inputId: z.ZodString;
+    label: z.ZodString;
+    placeholder: z.ZodNullable<z.ZodString>;
+    maxLength: z.ZodNumber;
+    required: z.ZodBoolean;
+    usable: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+  }, z.core.$strip>>>>;
+  optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>>;
 }, z.core.$strip>;
 export type OptionModel = z.infer<typeof optionModelSchema>;
 /**
@@ -5662,36 +5324,9 @@ export declare const productCreateRequestSchema: z.ZodObject<{
       returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strict>>;
   }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"DOWNLOAD">;
-    download: z.ZodDefault<z.ZodObject<{
-      limit: z.ZodDefault<z.ZodNumber>;
-      days: z.ZodDefault<z.ZodNumber>;
-      stockTracking: z.ZodDefault<z.ZodBoolean>;
-      withdrawalRestricted: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strict>>;
-  }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"CODE">;
-    code: z.ZodDefault<z.ZodObject<{
-      mode: z.ZodDefault<z.ZodEnum<{
-        AUTO: "AUTO";
-        MANUAL: "MANUAL";
-      }>>;
-      withdrawalRestricted: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strict>>;
-  }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"SERVICE">;
-    service: z.ZodDefault<z.ZodObject<{
-      mode: z.ZodDefault<z.ZodEnum<{
-        AUTO: "AUTO";
-        MANUAL: "MANUAL";
-      }>>;
-    }, z.core.$strict>>;
-  }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"PICKUP">;
-    pickup: z.ZodDefault<z.ZodObject<{
-      addressId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
+    type: z.ZodLiteral<"MANUAL">;
   }, z.core.$strict>], "type">>;
+  sourceOptionSetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -5712,6 +5347,31 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     sellerCode: z.ZodOptional<z.ZodString>;
     usable: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
+  addonGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodOptional<z.ZodString>;
+      name: z.ZodString;
+      additionalPrice: z.ZodDefault<z.ZodNumber>;
+      usable: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  customInputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    inputId: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxLength: z.ZodNumber;
+    required: z.ZodDefault<z.ZodBoolean>;
+    usable: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>>;
+  optionSort: z.ZodOptional<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>;
   name: z.ZodString;
   categoryId: z.ZodString;
   salePrice: z.ZodNumber;
@@ -5749,36 +5409,9 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
   }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"DOWNLOAD">;
-    download: z.ZodObject<{
-      limit: z.ZodNumber;
-      days: z.ZodNumber;
-      stockTracking: z.ZodBoolean;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strict>;
-  }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"CODE">;
-    code: z.ZodObject<{
-      mode: z.ZodEnum<{
-        AUTO: "AUTO";
-        MANUAL: "MANUAL";
-      }>;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strict>;
-  }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"SERVICE">;
-    service: z.ZodObject<{
-      mode: z.ZodEnum<{
-        AUTO: "AUTO";
-        MANUAL: "MANUAL";
-      }>;
-    }, z.core.$strict>;
-  }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"PICKUP">;
-    pickup: z.ZodObject<{
-      addressId: z.ZodString;
-    }, z.core.$strict>;
+    type: z.ZodLiteral<"MANUAL">;
   }, z.core.$strict>], "type">>;
+  sourceOptionSetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -5799,6 +5432,31 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
     sellerCode: z.ZodOptional<z.ZodString>;
     usable: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
+  addonGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodOptional<z.ZodString>;
+      name: z.ZodString;
+      additionalPrice: z.ZodDefault<z.ZodNumber>;
+      usable: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  customInputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    inputId: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxLength: z.ZodNumber;
+    required: z.ZodDefault<z.ZodBoolean>;
+    usable: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>>;
+  optionSort: z.ZodOptional<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>;
   name: z.ZodString;
   categoryId: z.ZodString;
   salePrice: z.ZodNumber;
@@ -5843,35 +5501,7 @@ export declare const productPatchRequestSchema: z.ZodObject<{
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
   }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"DOWNLOAD">;
-    download: z.ZodObject<{
-      limit: z.ZodNumber;
-      days: z.ZodNumber;
-      stockTracking: z.ZodBoolean;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strict>;
-  }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"CODE">;
-    code: z.ZodObject<{
-      mode: z.ZodEnum<{
-        AUTO: "AUTO";
-        MANUAL: "MANUAL";
-      }>;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strict>;
-  }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"SERVICE">;
-    service: z.ZodObject<{
-      mode: z.ZodEnum<{
-        AUTO: "AUTO";
-        MANUAL: "MANUAL";
-      }>;
-    }, z.core.$strict>;
-  }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"PICKUP">;
-    pickup: z.ZodObject<{
-      addressId: z.ZodString;
-    }, z.core.$strict>;
+    type: z.ZodLiteral<"MANUAL">;
   }, z.core.$strict>], "type">>;
   refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
     preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
@@ -5929,6 +5559,210 @@ export declare const discountRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type DiscountRequest = z.infer<typeof discountRequestSchema>;
 //#endregion
+//#region src/schemas/saved-option-set.d.ts
+/**
+ * 저장 옵션 (이슈 #59) — 자주 쓰는 옵션 구성을 이름 붙여 두고 상품 등록에서 불러온다.
+ *
+ * **불러오기는 복사다.** 저장 옵션을 고치거나 지워도 이미 불러온 상품의 옵션은 그대로다. 재고·SKU·사용 여부는 상품마다
+ * 달라 저장하지 않는다. 추가금은 조합별이 아니라 **값별**로 둔다 — 조합 옵션으로 불러오면 조합 추가금은 고른 값 추가금의 합이다.
+ */
+/** 스토어당 저장 옵션 최대 개수 */
+export declare const MAX_SAVED_OPTION_SETS = 200;
+/** 저장 옵션 이름 최대 글자 수 */
+export declare const MAX_SAVED_OPTION_SET_NAME = 50;
+/** 옵션명 방식 — `combination`(조합: 값의 조합이 판매 단위가 된다)·`addon`(추가 선택: 재고 없이 추가금만) */
+export declare const optionGroupKindSchema: z.ZodEnum<{
+  combination: "combination";
+  addon: "addon";
+}>;
+export type OptionGroupKind = z.infer<typeof optionGroupKindSchema>;
+export declare const savedOptionValueSchema: z.ZodObject<{
+  name: z.ZodString;
+  additionalPrice: z.ZodNumber;
+}, z.core.$strip>;
+export declare const savedOptionGroupSchema: z.ZodObject<{
+  name: z.ZodString;
+  kind: z.ZodString;
+  required: z.ZodBoolean;
+  values: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    additionalPrice: z.ZodNumber;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SavedOptionGroup = z.infer<typeof savedOptionGroupSchema>;
+export declare const savedCustomInputSchema: z.ZodObject<{
+  label: z.ZodString;
+  placeholder: z.ZodNullable<z.ZodString>;
+  maxLength: z.ZodNumber;
+  required: z.ZodBoolean;
+}, z.core.$strip>;
+export type SavedCustomInput = z.infer<typeof savedCustomInputSchema>;
+export declare const savedOptionSetSchema: z.ZodObject<{
+  optionSetId: z.ZodString;
+  name: z.ZodString;
+  optionSort: z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>;
+  groups: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodString;
+    required: z.ZodBoolean;
+    values: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      additionalPrice: z.ZodNumber;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  customInputs: z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    placeholder: z.ZodNullable<z.ZodString>;
+    maxLength: z.ZodNumber;
+    required: z.ZodBoolean;
+  }, z.core.$strip>>;
+  importedProductCount: z.ZodNumber;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type SavedOptionSet = z.infer<typeof savedOptionSetSchema>;
+export declare const savedOptionValueRequestSchema: z.ZodObject<{
+  name: z.ZodString;
+  additionalPrice: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const savedOptionGroupRequestSchema: z.ZodObject<{
+  name: z.ZodString;
+  kind: z.ZodEnum<{
+    combination: "combination";
+    addon: "addon";
+  }>;
+  required: z.ZodDefault<z.ZodBoolean>;
+  values: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    additionalPrice: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SavedOptionGroupRequest = z.infer<typeof savedOptionGroupRequestSchema>;
+export declare const savedCustomInputRequestSchema: z.ZodObject<{
+  label: z.ZodString;
+  placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  maxLength: z.ZodNumber;
+  required: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * 저장 옵션 만들기·수정 본문. 조합 옵션명은 최대 `MAX_OPTION_GROUPS`개, 추가 선택은 최대 `MAX_ADDON_GROUPS`개이고
+ * 옵션명과 직접 입력 항목이 모두 비면 400이다. 수정(PUT)은 통째로 바꾼다.
+ */
+export declare const savedOptionSetRequestSchema: z.ZodObject<{
+  name: z.ZodString;
+  optionSort: z.ZodDefault<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>;
+  groups: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodEnum<{
+      combination: "combination";
+      addon: "addon";
+    }>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    values: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      additionalPrice: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  customInputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxLength: z.ZodNumber;
+    required: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type SavedOptionSetRequest = z.infer<typeof savedOptionSetRequestSchema>;
+export type SavedOptionSetRequestInput = z.input<typeof savedOptionSetRequestSchema>;
+/**
+ * 상품에서 저장 (`POST /v1/saved-option-sets/from-product`) — 상품의 현재 옵션을 저장 옵션으로 만든다.
+ *
+ * 조합 추가금이 값별 추가금의 합으로 되돌려지면 값별로 저장하고, 조합마다 제각각이면 추가금을 빼고
+ * 응답 `additionalPriceDropped: true`로 알린다. `replaceOptionSetId`를 주면 그 저장 옵션을 덮어쓴다(이름 중복의 덮어쓰기).
+ */
+export declare const savedOptionSetFromProductRequestSchema: z.ZodObject<{
+  productId: z.ZodString;
+  name: z.ZodString;
+  includeOptions: z.ZodDefault<z.ZodBoolean>;
+  includeCustomInputs: z.ZodDefault<z.ZodBoolean>;
+  replaceOptionSetId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SavedOptionSetFromProductRequest = z.infer<typeof savedOptionSetFromProductRequestSchema>;
+export type SavedOptionSetFromProductRequestInput = z.input<typeof savedOptionSetFromProductRequestSchema>;
+export declare const savedOptionSetFromProductResultSchema: z.ZodObject<{
+  optionSet: z.ZodObject<{
+    optionSetId: z.ZodString;
+    name: z.ZodString;
+    optionSort: z.ZodEnum<{
+      REGISTERED: "REGISTERED";
+      NAME: "NAME";
+      PRICE_ASC: "PRICE_ASC";
+      PRICE_DESC: "PRICE_DESC";
+    }>;
+    groups: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      kind: z.ZodString;
+      required: z.ZodBoolean;
+      values: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        additionalPrice: z.ZodNumber;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    customInputs: z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      placeholder: z.ZodNullable<z.ZodString>;
+      maxLength: z.ZodNumber;
+      required: z.ZodBoolean;
+    }, z.core.$strip>>;
+    importedProductCount: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+  }, z.core.$strip>;
+  additionalPriceDropped: z.ZodBoolean;
+}, z.core.$strip>;
+export type SavedOptionSetFromProductResult = z.infer<typeof savedOptionSetFromProductResultSchema>;
+/** 구성 필터 — 조합 옵션명·추가 선택 옵션명·직접 입력 항목을 가진 저장 옵션 */
+export declare const savedOptionSetCompositionSchema: z.ZodEnum<{
+  combination: "combination";
+  addon: "addon";
+  customInput: "customInput";
+}>;
+export declare const savedOptionSetSortSchema: z.ZodEnum<{
+  "updatedAt.desc": "updatedAt.desc";
+  "name.asc": "name.asc";
+  "importedProductCount.desc": "importedProductCount.desc";
+}>;
+export type SavedOptionSetSort = z.infer<typeof savedOptionSetSortSchema>;
+export interface SavedOptionSetListParams extends PageParams {
+  keyword?: string;
+  composition?: z.infer<typeof savedOptionSetCompositionSchema>;
+  sort?: SavedOptionSetSort;
+}
+/** `GET /v1/saved-option-sets` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
+export declare const savedOptionSetListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  keyword: z.ZodOptional<z.ZodString>;
+  composition: z.ZodOptional<z.ZodEnum<{
+    combination: "combination";
+    addon: "addon";
+    customInput: "customInput";
+  }>>;
+  sort: z.ZodOptional<z.ZodEnum<{
+    "updatedAt.desc": "updatedAt.desc";
+    "name.asc": "name.asc";
+    "importedProductCount.desc": "importedProductCount.desc";
+  }>>;
+}, z.core.$strip>;
+//#endregion
 //#region src/schemas/store.d.ts
 /**
  * 스토어 코드 규칙 — 스토어프론트 API가 테넌트를 가르는 값이다(`X-Store-Code` 헤더).
@@ -5969,8 +5803,6 @@ export declare const updateStoreRequestSchema: z.ZodObject<{
   analyticsAllowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
   storefrontOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
   guestCheckoutEnabled: z.ZodOptional<z.ZodBoolean>;
-  fulfillmentMailEnabled: z.ZodOptional<z.ZodBoolean>;
-  withdrawalNotice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   autoDeliverDays: z.ZodOptional<z.ZodNumber>;
   autoConfirmDays: z.ZodOptional<z.ZodNumber>;
   refundPolicy: z.ZodOptional<z.ZodObject<{
@@ -6009,8 +5841,6 @@ export declare const storeSchema: z.ZodObject<{
   analyticsAllowedOrigins: z.ZodArray<z.ZodString>;
   storefrontOrigins: z.ZodArray<z.ZodString>;
   guestCheckoutEnabled: z.ZodBoolean;
-  fulfillmentMailEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-  withdrawalNotice: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   autoDeliverDays: z.ZodNumber;
   autoConfirmDays: z.ZodNumber;
   refundPolicy: z.ZodObject<{
@@ -6069,8 +5899,8 @@ export declare const invitationSchema: z.ZodObject<{
     STAFF: "STAFF";
   }>;
   status: z.ZodEnum<{
-    EXPIRED: "EXPIRED";
     PENDING: "PENDING";
+    EXPIRED: "EXPIRED";
     ACCEPTED: "ACCEPTED";
     CANCELED: "CANCELED";
   }>;
@@ -6109,8 +5939,8 @@ export type UpdateMemberRoleRequest = z.infer<typeof updateMemberRoleRequestSche
 /** `GET /v1/store/invitations` 쿼리 — OpenAPI 문서용 형태 */
 export declare const invitationListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodEnum<{
-    EXPIRED: "EXPIRED";
     PENDING: "PENDING";
+    EXPIRED: "EXPIRED";
     ACCEPTED: "ACCEPTED";
     CANCELED: "CANCELED";
   }>>;
@@ -6125,12 +5955,10 @@ export declare const storeMemberRoleUpdatedSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type StoreMemberRoleUpdated = z.infer<typeof storeMemberRoleUpdatedSchema>;
 /**
- * 주소 유형 — 출고지·반품지·방문 수령지(이슈 #48). 방문 수령지(`PICKUP`)는 목록에서 `type=PICKUP`으로 조회할 때만 나온다
- * (이 값을 모르는 옛 SDK의 목록 파싱이 깨지지 않게).
+ * 주소 유형 — 출고지·반품지.
  */
 export declare const addressTypeSchema: z.ZodEnum<{
   SHIPPING: "SHIPPING";
-  PICKUP: "PICKUP";
   RETURN: "RETURN";
 }>;
 export type AddressType = z.infer<typeof addressTypeSchema>;
@@ -6138,7 +5966,6 @@ export type AddressType = z.infer<typeof addressTypeSchema>;
 export declare const sellerAddressListQuerySchema: z.ZodObject<{
   type: z.ZodOptional<z.ZodEnum<{
     SHIPPING: "SHIPPING";
-    PICKUP: "PICKUP";
     RETURN: "RETURN";
   }>>;
 }, z.core.$strip>;
@@ -6146,7 +5973,6 @@ export declare const sellerAddressSchema: z.ZodObject<{
   addressId: z.ZodString;
   type: z.ZodEnum<{
     SHIPPING: "SHIPPING";
-    PICKUP: "PICKUP";
     RETURN: "RETURN";
   }>;
   name: z.ZodString;
@@ -6162,7 +5988,6 @@ export type SellerAddress = z.infer<typeof sellerAddressSchema>;
 export declare const sellerAddressRequestSchema: z.ZodObject<{
   type: z.ZodEnum<{
     SHIPPING: "SHIPPING";
-    PICKUP: "PICKUP";
     RETURN: "RETURN";
   }>;
   name: z.ZodString;
@@ -6194,10 +6019,28 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
  * - 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자, 하이픈으로 시작·끝 불가)에
@@ -6206,7 +6049,18 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
 export declare const STOREFRONT_SLUG_PATTERN: RegExp;
 /** 호스팅 도메인에서 플랫폼이 쓰거나 쓸 이름 — 스토어 코드 예약어에 호스팅 전용 이름을 더한다 */
 export declare const RESERVED_STOREFRONT_SLUGS: readonly string[];
+/**
+ * 편집 미리보기 호스트 접미사 — 편집 미리보기 주소는 `{사이트 id 정규화}-preview.{호스팅 도메인}`이다(M2b). 사이트 주소와 같은
+ * 1단계 이름이라 슬러그가 이 모양이면 남의 편집 미리보기 주소와 겹칠 수 있어 슬러그로 쓰지 못한다.
+ */
+export declare const STOREFRONT_EDIT_PREVIEW_SUFFIX = "-preview";
 export declare function isReservedStorefrontSlug(slug: string): boolean;
+/**
+ * 편집 미리보기 호스트 이름의 라벨 — 사이트 id의 `_`를 `-`로 바꾸고 `-preview`를 붙인다(`sfs_ab12cd34` → `sfs-ab12cd34-preview`).
+ * 편집 Sandbox Worker(`apps/hosting-sandbox/src/preview-host.ts`)가 같은 규칙의 복제본을 들고 있고 api
+ * `test/storefront-hosting-parity.spec.ts`가 둘을 대조한다. 규칙을 바꾸면 두 곳을 같이 고친다.
+ */
+export declare function storefrontEditPreviewLabelOf(siteId: string): string;
 export declare const storefrontSlugSchema: z.ZodString;
 /** 바꾼 슬러그를 다른 사이트가 가져가지 못하게 막는 기간(일). 보류 동안 옛 주소는 새 주소로 301한다 */
 export declare const STOREFRONT_SLUG_HOLD_DAYS = 90;
@@ -6227,8 +6081,10 @@ export declare const storefrontTemplateSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type StorefrontTemplate = z.infer<typeof storefrontTemplateSchema>;
 /**
- * 버전 상태 — M1은 템플릿 빌드 산출물을 그대로 쓰므로 만들 때 곧바로 `READY`다. `BUILDING`·`FAILED`는
- * 셀러 편집 빌드(M2)가 쓴다. 발행 여부는 상태가 아니라 사이트의 발행 포인터가 원천이다(`published`).
+ * 버전 상태 — 템플릿 버전(`source: TEMPLATE`)은 템플릿 산출물을 그대로 쓰므로 만들 때 곧바로 `READY`다. 편집 버전
+ * (`source: EDIT`, M2b)은 작업 트리 스냅샷을 빌드하는 동안 `BUILDING`이고, 빌드·규칙 검증을 통과하면 `READY`, 실패하면
+ * `FAILED`다(실패 단계·로그 꼬리는 `buildId`의 빌드). 발행할 수 있는 것은 `READY`뿐이다. 발행 여부는 상태가 아니라 사이트의
+ * 발행 포인터가 원천이다(`published`).
  */
 export declare const storefrontVersionStatusSchema: z.ZodEnum<{
   FAILED: "FAILED";
@@ -6249,6 +6105,11 @@ export declare const storefrontVersionSchema: z.ZodObject<{
   published: z.ZodBoolean;
   publishedAt: z.ZodNullable<z.ZodString>;
   message: z.ZodNullable<z.ZodString>;
+  source: z.ZodEnum<{
+    TEMPLATE: "TEMPLATE";
+    EDIT: "EDIT";
+  }>;
+  buildId: z.ZodNullable<z.ZodString>;
   createdByType: z.ZodString;
   createdAt: z.ZodString;
 }, z.core.$strip>;
@@ -6296,6 +6157,23 @@ export declare const storefrontProvisioningSchema: z.ZodObject<{
   syncedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type StorefrontProvisioning = z.infer<typeof storefrontProvisioningSchema>;
+/**
+ * 편집 미리보기 주소(M2b) — 사이트마다 `{사이트 id 정규화}-preview.{호스팅 도메인}` 호스트 하나다. 호스팅 도메인의 와일드카드
+ * 인증서가 덮으므로 따로 준비할 것이 없다. 이 주소는 편집 미리보기 링크(콘솔 전용)로 받은 쿠키가 있어야 열린다.
+ */
+export declare const storefrontEditPreviewSchema: z.ZodObject<{
+  hostname: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontEditPreview = z.infer<typeof storefrontEditPreviewSchema>;
+/**
+ * 사이트 정지 — 운영 정책에 따라 플랫폼 운영자가 사이트를 정지한다. 정지 중에는 방문자에게 정지 안내가 보이고 발행·되돌리기·템플릿 변경·
+ * 공개 전환·슬러그 변경·끄기·편집이 409 `STOREFRONT_SITE_NOT_ACTIVE`다. 셀러가 풀 수 없다(고객센터로 문의한다).
+ */
+export declare const storefrontSuspensionSchema: z.ZodObject<{
+  reason: z.ZodNullable<z.ZodString>;
+  suspendedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontSuspension = z.infer<typeof storefrontSuspensionSchema>;
 export declare const storefrontSiteSchema: z.ZodObject<{
   siteId: z.ZodString;
   slug: z.ZodString;
@@ -6341,6 +6219,11 @@ export declare const storefrontSiteSchema: z.ZodObject<{
     published: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
     message: z.ZodNullable<z.ZodString>;
+    source: z.ZodEnum<{
+      TEMPLATE: "TEMPLATE";
+      EDIT: "EDIT";
+    }>;
+    buildId: z.ZodNullable<z.ZodString>;
     createdByType: z.ZodString;
     createdAt: z.ZodString;
   }, z.core.$strip>>;
@@ -6353,7 +6236,14 @@ export declare const storefrontSiteSchema: z.ZodObject<{
     lastErrorCode: z.ZodNullable<z.ZodString>;
     syncedAt: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
+  editPreview: z.ZodObject<{
+    hostname: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
   slugChangesRemaining: z.ZodNumber;
+  suspension: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    reason: z.ZodNullable<z.ZodString>;
+    suspendedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>>;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
 }, z.core.$strip>;
@@ -6362,6 +6252,7 @@ export type StorefrontSite = z.infer<typeof storefrontSiteSchema>;
 export declare const storefrontHostingSchema: z.ZodObject<{
   enabled: z.ZodBoolean;
   domain: z.ZodString;
+  editingEnabled: z.ZodBoolean;
   site: z.ZodNullable<z.ZodObject<{
     siteId: z.ZodString;
     slug: z.ZodString;
@@ -6407,6 +6298,11 @@ export declare const storefrontHostingSchema: z.ZodObject<{
       published: z.ZodBoolean;
       publishedAt: z.ZodNullable<z.ZodString>;
       message: z.ZodNullable<z.ZodString>;
+      source: z.ZodEnum<{
+        TEMPLATE: "TEMPLATE";
+        EDIT: "EDIT";
+      }>;
+      buildId: z.ZodNullable<z.ZodString>;
       createdByType: z.ZodString;
       createdAt: z.ZodString;
     }, z.core.$strip>>;
@@ -6419,7 +6315,14 @@ export declare const storefrontHostingSchema: z.ZodObject<{
       lastErrorCode: z.ZodNullable<z.ZodString>;
       syncedAt: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
+    editPreview: z.ZodObject<{
+      hostname: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
     slugChangesRemaining: z.ZodNumber;
+    suspension: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      reason: z.ZodNullable<z.ZodString>;
+      suspendedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
@@ -6440,64 +6343,573 @@ export declare const createStorefrontSiteRequestSchema: z.ZodObject<{
   templateId: z.ZodString;
   slug: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type CreateStorefrontSiteRequest = z.infer<typeof createStorefrontSiteRequestSchema>;
-export declare const changeStorefrontTemplateRequestSchema: z.ZodObject<{
-  templateId: z.ZodString;
-  publish: z.ZodOptional<z.ZodBoolean>;
-  message: z.ZodOptional<z.ZodString>;
+export type CreateStorefrontSiteRequest = z.infer<typeof createStorefrontSiteRequestSchema>;
+export declare const changeStorefrontTemplateRequestSchema: z.ZodObject<{
+  templateId: z.ZodString;
+  publish: z.ZodOptional<z.ZodBoolean>;
+  message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ChangeStorefrontTemplateRequest = z.infer<typeof changeStorefrontTemplateRequestSchema>;
+/**
+ * 발행·되돌리기 — 발행은 사이트의 발행 포인터를 바꾸는 조건부 쓰기다. `expectedPublishedVersionId`를 주면
+ * 지금 발행 버전이 그 값일 때만 바꾼다(화면을 본 뒤 다른 사람이 바꿨으면 409 `STOREFRONT_SITE_CHANGED`).
+ * 이미 그 버전이 발행돼 있으면 아무것도 바꾸지 않고 200이다(같은 요청의 재실행이 안전하다).
+ */
+export declare const publishStorefrontVersionRequestSchema: z.ZodObject<{
+  expectedPublishedVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type PublishStorefrontVersionRequest = z.infer<typeof publishStorefrontVersionRequestSchema>;
+export declare const rollbackStorefrontRequestSchema: z.ZodObject<{
+  versionId: z.ZodOptional<z.ZodString>;
+  expectedPublishedVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type RollbackStorefrontRequest = z.infer<typeof rollbackStorefrontRequestSchema>;
+export declare const changeStorefrontSlugRequestSchema: z.ZodObject<{
+  slug: z.ZodString;
+}, z.core.$strip>;
+export type ChangeStorefrontSlugRequest = z.infer<typeof changeStorefrontSlugRequestSchema>;
+export declare const setStorefrontVisibilityRequestSchema: z.ZodObject<{
+  visibility: z.ZodEnum<{
+    COMING_SOON: "COMING_SOON";
+    PUBLIC: "PUBLIC";
+  }>;
+  expectedVisibility: z.ZodOptional<z.ZodEnum<{
+    COMING_SOON: "COMING_SOON";
+    PUBLIC: "PUBLIC";
+  }>>;
+}, z.core.$strip>;
+export type SetStorefrontVisibilityRequest = z.infer<typeof setStorefrontVisibilityRequestSchema>;
+/** 호스팅 끄기 — 사이트를 닫고(`CLOSED`) 슬러그를 보류한다. 확인 입력은 현재 슬러그다 */
+export declare const disableStorefrontHostingRequestSchema: z.ZodObject<{
+  confirmSlug: z.ZodString;
+}, z.core.$strip>;
+export type DisableStorefrontHostingRequest = z.infer<typeof disableStorefrontHostingRequestSchema>;
+export declare const storefrontSlugAvailabilityQuerySchema: z.ZodObject<{
+  slug: z.ZodString;
+}, z.core.$strip>;
+/**
+ * 오픈 준비 중 미리보기 링크 — 콘솔에서 로그인한 OWNER·ADMIN만 받는다(PAT·에이전트 불가). 링크는 5분 안에 한 번 열면
+ * 그 브라우저에 12시간짜리 미리보기 쿠키가 생기고 오픈 준비 중인 사이트의 실제 화면을 본다. 링크를 남에게 넘기면 그 사람도
+ * 볼 수 있으므로 공유하지 않는다.
+ */
+export declare const createStorefrontPreviewLinkRequestSchema: z.ZodObject<{
+  path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateStorefrontPreviewLinkRequest = z.infer<typeof createStorefrontPreviewLinkRequestSchema>;
+export declare const storefrontPreviewLinkSchema: z.ZodObject<{
+  url: z.ZodString;
+  expiresAt: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontPreviewLink = z.infer<typeof storefrontPreviewLinkSchema>;
+/** 플랫폼 전체 동시 편집 환경 상한 */
+export declare const STOREFRONT_EDIT_CAPACITY = 20;
+/** 활동이 없으면 편집 환경이 잠드는 시간(분). 작업 트리는 보존된다 */
+export declare const STOREFRONT_EDIT_IDLE_MINUTES = 15;
+/**
+ * 편집 작업(파일 쓰기·검사·버전 만들기·편집 미리보기 링크 발급)이 없으면 서버가 편집 환경을 닫는 시간(분). 미리보기 탭만 열어 두면
+ * 유휴 잠들기(`STOREFRONT_EDIT_IDLE_MINUTES`)가 걸리지 않으므로 이 한도가 편집 환경을 끝낸다. 작업 트리는 보존된다
+ */
+export declare const STOREFRONT_EDIT_ACTIVITY_TIMEOUT_MINUTES = 30;
+/** 파일 하나의 최대 크기(바이트) */
+export declare const STOREFRONT_FILE_MAX_BYTES: number;
+/** 작업 트리 전체 최대 크기(바이트) — 파일 수는 2,000개까지 */
+export declare const STOREFRONT_WORKSPACE_MAX_BYTES: number;
+/** 일괄 쓰기 한 번의 최대 파일 수 */
+export declare const STOREFRONT_FILE_BATCH_MAX = 50;
+/** 편집할 수 없는 경로 조각 — 설치물·산출물 폴더 */
+export declare const STOREFRONT_BLOCKED_PATH_SEGMENTS: readonly string[];
+/** 경로 조각에 쓸 수 있는 문자 — 편집 Sandbox Worker의 경로 규칙(sandbox-api.md §2.1)과 같다. TanStack Router 파일명(`$id.tsx`·`_layout`·`(group)`·`[.]`)이 들어간다 */
+export declare const STOREFRONT_PATH_SEGMENT_PATTERN: RegExp;
+/** 경로 정규화 — NFC. 비교·저장은 이 값으로 한다(같아 보이는 두 경로가 다른 파일이 되지 않게) */
+export declare function normalizeStorefrontPath(path: string): string;
+/**
+ * 작업 트리 상대 경로인가(정규화한 값 기준) — `/`로 구분하고 `/`로 시작하지 않는다. `.`·`..`·빈 조각, 조각 문자 규칙
+ * (`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`가 대조한다).
+ */
+export declare function isEditableStorefrontPath(path: string): boolean;
+/** 경로 입력 — NFC로 정규화한 뒤 규칙을 본다 */
+export declare const storefrontFilePathSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+/** 파일 해시 — 내용 바이트의 SHA-256 hex(소문자 64자) */
+export declare const storefrontFileHashSchema: z.ZodString;
+export declare const storefrontFileEncodingSchema: z.ZodEnum<{
+  utf8: "utf8";
+  base64: "base64";
+}>;
+/**
+ * 편집 환경 상태 — `STARTING`은 컨테이너를 띄우고 작업 트리를 복원해 dev 서버를 올리는 중이다(보통 30초 안, 최대
+ * 90초). `RUNNING`이면 미리보기와 파일 쓰기가 바로 반영된다(HMR).
+ */
+export declare const storefrontEditSessionStatusSchema: z.ZodEnum<{
+  STARTING: "STARTING";
+  RUNNING: "RUNNING";
+}>;
+/** 편집 환경을 띄우는 단계 — 콘솔 진행 표시용이다. 값은 늘어날 수 있다 */
+export declare const STOREFRONT_EDIT_START_STAGES: readonly ["CONTAINER", "RESTORE", "DEV_SERVER"];
+export declare const storefrontEditSessionSchema: z.ZodObject<{
+  sessionId: z.ZodString;
+  status: z.ZodEnum<{
+    STARTING: "STARTING";
+    RUNNING: "RUNNING";
+  }>;
+  startStage: z.ZodNullable<z.ZodString>;
+  startedAt: z.ZodString;
+  lastEditedAt: z.ZodNullable<z.ZodString>;
+  lastActiveAt: z.ZodString;
+  idleExpiresAt: z.ZodString;
+  closesAt: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontEditSession = z.infer<typeof storefrontEditSessionSchema>;
+/** `GET·POST·DELETE /v1/storefront/site/editing` — 편집 환경 상태 */
+export declare const storefrontEditingSchema: z.ZodObject<{
+  enabled: z.ZodBoolean;
+  session: z.ZodNullable<z.ZodObject<{
+    sessionId: z.ZodString;
+    status: z.ZodEnum<{
+      STARTING: "STARTING";
+      RUNNING: "RUNNING";
+    }>;
+    startStage: z.ZodNullable<z.ZodString>;
+    startedAt: z.ZodString;
+    lastEditedAt: z.ZodNullable<z.ZodString>;
+    lastActiveAt: z.ZodString;
+    idleExpiresAt: z.ZodString;
+    closesAt: z.ZodString;
+  }, z.core.$strip>>;
+  capacity: z.ZodObject<{
+    limit: z.ZodNumber;
+    inUse: z.ZodNumber;
+  }, z.core.$strip>;
+  preview: z.ZodObject<{
+    hostname: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  workingTree: z.ZodObject<{
+    modified: z.ZodBoolean;
+    lastEditedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+export type StorefrontEditing = z.infer<typeof storefrontEditingSchema>;
+export declare const storefrontFileEntrySchema: z.ZodObject<{
+  path: z.ZodString;
+  size: z.ZodNumber;
+  hash: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontFileEntry = z.infer<typeof storefrontFileEntrySchema>;
+/** `GET /v1/storefront/site/files?prefix=` — 작업 트리 파일 목록(편집 환경이 없어도 된다. 편집 환경을 깨우지 않는다) */
+export declare const storefrontFileListSchema: z.ZodObject<{
+  files: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    size: z.ZodNumber;
+    hash: z.ZodString;
+  }, z.core.$strip>>;
+  totalBytes: z.ZodNumber;
+}, z.core.$strip>;
+export type StorefrontFileList = z.infer<typeof storefrontFileListSchema>;
+export declare const storefrontFileListQuerySchema: z.ZodObject<{
+  prefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const storefrontFileContentQuerySchema: z.ZodObject<{
+  path: z.ZodString;
+}, z.core.$strip>;
+/** `GET /v1/storefront/site/files/content?path=` — 편집 환경이 없어도 된다 */
+export declare const storefrontFileContentSchema: z.ZodObject<{
+  path: z.ZodString;
+  content: z.ZodString;
+  encoding: z.ZodEnum<{
+    utf8: "utf8";
+    base64: "base64";
+  }>;
+  hash: z.ZodString;
+  size: z.ZodNumber;
+}, z.core.$strip>;
+export type StorefrontFileContent = z.infer<typeof storefrontFileContentSchema>;
+/**
+ * `POST /v1/storefront/site/files/batch` — 여러 파일을 한 번에 쓴다. 편집 환경이 없어도 된다(잠든 작업 트리에 바로 쓰고,
+ * 편집 환경이 떠 있으면 미리보기에 곧바로 반영된다). `expectedHash`: 생략하면 조건 없이 쓴다 · `null`이면 파일이 없어야 한다(새 파일) · 값이면 지금
+ * 해시가 같아야 한다. 조건을 **모두** 확인한 뒤 쓰고, 하나라도 어긋나면 아무것도 쓰지 않는다(409 `FILE_CHANGED`,
+ * `error.details.conflicts`).
+ */
+export declare const writeStorefrontFilesRequestSchema: z.ZodObject<{
+  files: z.ZodArray<z.ZodObject<{
+    path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    content: z.ZodString;
+    encoding: z.ZodOptional<z.ZodEnum<{
+      utf8: "utf8";
+      base64: "base64";
+    }>>;
+    expectedHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WriteStorefrontFilesRequest = z.infer<typeof writeStorefrontFilesRequestSchema>;
+export declare const storefrontFileWriteResultSchema: z.ZodObject<{
+  files: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    size: z.ZodNumber;
+    hash: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type StorefrontFileWriteResult = z.infer<typeof storefrontFileWriteResultSchema>;
+/** 409 `FILE_CHANGED`의 `error.details` */
+export declare const storefrontFileConflictDetailsSchema: z.ZodObject<{
+  conflicts: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    currentHash: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type StorefrontFileConflictDetails = z.infer<typeof storefrontFileConflictDetailsSchema>;
+/** `POST /v1/storefront/site/files/delete` — 없는 파일이면 `deleted: false`(조건을 주면 409 `FILE_CHANGED`) */
+export declare const deleteStorefrontFileRequestSchema: z.ZodObject<{
+  path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+  expectedHash: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DeleteStorefrontFileRequest = z.infer<typeof deleteStorefrontFileRequestSchema>;
+export declare const storefrontFileDeleteResultSchema: z.ZodObject<{
+  path: z.ZodString;
+  deleted: z.ZodBoolean;
+}, z.core.$strip>;
+export type StorefrontFileDeleteResult = z.infer<typeof storefrontFileDeleteResultSchema>;
+/** `POST /v1/storefront/site/files/move` — 이름 바꾸기·옮기기 */
+export declare const moveStorefrontFileRequestSchema: z.ZodObject<{
+  from: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+  to: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+  expectedHash: z.ZodOptional<z.ZodString>;
+  overwrite: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type MoveStorefrontFileRequest = z.infer<typeof moveStorefrontFileRequestSchema>;
+export declare const storefrontFileMoveResultSchema: z.ZodObject<{
+  from: z.ZodString;
+  to: z.ZodString;
+  hash: z.ZodString;
+  size: z.ZodNumber;
+}, z.core.$strip>;
+export type StorefrontFileMoveResult = z.infer<typeof storefrontFileMoveResultSchema>;
+/** `POST /v1/storefront/site/files/search` — 텍스트 파일 내용 검색(편집 환경이 없어도 된다) */
+/** 정규식 검색의 패턴 길이 상한 — 편집 Sandbox가 실행 비용을 막으려고 더 좁게 받는다(sandbox-api §4.6) */
+export declare const STOREFRONT_SEARCH_REGEX_MAX_LENGTH = 100;
+export declare const searchStorefrontFilesRequestSchema: z.ZodObject<{
+  query: z.ZodString;
+  regex: z.ZodOptional<z.ZodBoolean>;
+  caseSensitive: z.ZodOptional<z.ZodBoolean>;
+  pathPrefix: z.ZodOptional<z.ZodString>;
+  maxResults: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type SearchStorefrontFilesRequest = z.infer<typeof searchStorefrontFilesRequestSchema>;
+export declare const storefrontFileSearchResultSchema: z.ZodObject<{
+  matches: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodOptional<z.ZodNumber>;
+    text: z.ZodString;
+  }, z.core.$strip>>;
+  truncated: z.ZodBoolean;
+}, z.core.$strip>;
+export type StorefrontFileSearchResult = z.infer<typeof storefrontFileSearchResultSchema>;
+/**
+ * `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`)이다. 출력은 꼬리만 준다.
+ */
+export declare const runStorefrontCheckRequestSchema: z.ZodObject<{
+  check: z.ZodEnum<{
+    typecheck: "typecheck";
+    lint: "lint";
+    test: "test";
+  }>;
+}, z.core.$strip>;
+export type RunStorefrontCheckRequest = z.infer<typeof runStorefrontCheckRequestSchema>;
+export declare const storefrontCheckStatusSchema: z.ZodEnum<{
+  FAILED: "FAILED";
+  UNKNOWN: "UNKNOWN";
+  RUNNING: "RUNNING";
+  QUEUED: "QUEUED";
+  PASSED: "PASSED";
+  TIMED_OUT: "TIMED_OUT";
+}>;
+export type StorefrontCheckStatus = z.infer<typeof storefrontCheckStatusSchema>;
+/** 끝난 검사 상태 */
+export declare const STOREFRONT_CHECK_TERMINAL_STATUSES: readonly StorefrontCheckStatus[];
+export declare const storefrontCheckSchema: z.ZodObject<{
+  checkId: z.ZodString;
+  check: z.ZodString;
+  status: z.ZodEnum<{
+    FAILED: "FAILED";
+    UNKNOWN: "UNKNOWN";
+    RUNNING: "RUNNING";
+    QUEUED: "QUEUED";
+    PASSED: "PASSED";
+    TIMED_OUT: "TIMED_OUT";
+  }>;
+  exitCode: z.ZodNullable<z.ZodNumber>;
+  durationMs: z.ZodNullable<z.ZodNumber>;
+  outputTail: z.ZodNullable<z.ZodString>;
+  errorCode: z.ZodNullable<z.ZodString>;
+  message: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+  startedAt: z.ZodNullable<z.ZodString>;
+  finishedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontCheck = z.infer<typeof storefrontCheckSchema>;
+/** 규칙 심각도 — `error`는 버전 발행을 막는다(빌드 `VERIFY` 실패), `warning`은 알리기만 한다. 없으면 `error`로 본다 */
+export declare const storefrontRuleSeveritySchema: z.ZodEnum<{
+  error: "error";
+  warning: "warning";
+}>;
+export type StorefrontRuleSeverity = z.infer<typeof storefrontRuleSeveritySchema>;
+/** 규칙 하나의 검사 결과 — MCP 계측(`mcpRuleResultSchema`)과 같은 모양에 심각도를 더한다 */
+export declare const storefrontRuleResultSchema: z.ZodObject<{
+  ruleId: z.ZodString;
+  status: z.ZodEnum<{
+    pass: "pass";
+    violation: "violation";
+  }>;
+  count: z.ZodNumber;
+  severity: z.ZodOptional<z.ZodEnum<{
+    error: "error";
+    warning: "warning";
+  }>>;
+}, z.core.$strip>;
+export type StorefrontRuleResult = z.infer<typeof storefrontRuleResultSchema>;
+/**
+ * 규칙 검증 보고서 — `@sayren/mcp`의 `verify_storefront`와 같은 모양이다(원천 `apps/mcp/src/verify.ts`). 위반마다
+ * 고칠 자리(`file`·`line`)와 방법(`fix`·`example`)을 싣는다. `POST /v1/storefront/site/verify`(편집 환경이 잠들어 있어도
+ * 된다)와 빌드의 `verify`가 이 모양이다.
+ */
+export declare const storefrontVerifyReportSchema: z.ZodObject<{
+  ok: z.ZodBoolean;
+  checkedFiles: z.ZodNumber;
+  summary: z.ZodObject<{
+    rules: z.ZodNumber;
+    passed: z.ZodNumber;
+    violated: z.ZodNumber;
+    findings: z.ZodNumber;
+  }, z.core.$strip>;
+  results: z.ZodArray<z.ZodObject<{
+    ruleId: z.ZodString;
+    status: z.ZodEnum<{
+      pass: "pass";
+      violation: "violation";
+    }>;
+    count: z.ZodNumber;
+    severity: z.ZodOptional<z.ZodEnum<{
+      error: "error";
+      warning: "warning";
+    }>>;
+  }, z.core.$strip>>;
+  findings: z.ZodArray<z.ZodObject<{
+    ruleId: z.ZodString;
+    rule: z.ZodString;
+    file: z.ZodString;
+    line: z.ZodOptional<z.ZodNumber>;
+    detail: z.ZodString;
+    cause: z.ZodString;
+    fix: z.ZodString;
+    example: z.ZodString;
+    doc: z.ZodString;
+    docUrl: z.ZodString;
+    templateFile: z.ZodOptional<z.ZodString>;
+    severity: z.ZodOptional<z.ZodEnum<{
+      error: "error";
+      warning: "warning";
+    }>>;
+  }, z.core.$strip>>;
+  message: z.ZodString;
+  nextSteps: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontVerifyReport = z.infer<typeof storefrontVerifyReportSchema>;
+export declare const storefrontBuildStatusSchema: z.ZodEnum<{
+  FAILED: "FAILED";
+  SUCCEEDED: "SUCCEEDED";
+  RUNNING: "RUNNING";
+  QUEUED: "QUEUED";
+  TIMED_OUT: "TIMED_OUT";
+}>;
+export type StorefrontBuildStatus = z.infer<typeof storefrontBuildStatusSchema>;
+/** 끝난 빌드 상태 */
+export declare const STOREFRONT_BUILD_TERMINAL_STATUSES: readonly StorefrontBuildStatus[];
+/**
+ * 빌드 단계 — 이 순서로 돈다. 첫 실패에서 멈추지만 규칙 검증(`VERIFY`)은 실패해도 타입 검사까지 이어서 해 한 번에 알려 준다.
+ * `UPLOAD`는 사이트 버전 Worker 업로드다(성공하면 발행할 수 있다). 값은 늘어날 수 있다.
+ */
+export declare const STOREFRONT_BUILD_STAGES: readonly ["VERIFY", "RESTORE", "INSTALL", "TYPECHECK", "BUILD", "BUNDLE", "PACK", "UPLOAD"];
+export declare const storefrontBuildSchema: z.ZodObject<{
+  buildId: z.ZodString;
+  versionId: z.ZodString;
+  versionNumber: z.ZodNumber;
+  status: z.ZodEnum<{
+    FAILED: "FAILED";
+    SUCCEEDED: "SUCCEEDED";
+    RUNNING: "RUNNING";
+    QUEUED: "QUEUED";
+    TIMED_OUT: "TIMED_OUT";
+  }>;
+  failureStage: z.ZodNullable<z.ZodString>;
+  errorCode: z.ZodNullable<z.ZodString>;
+  logTail: z.ZodNullable<z.ZodString>;
+  stages: z.ZodArray<z.ZodObject<{
+    stage: z.ZodString;
+    ok: z.ZodBoolean;
+    durationMs: z.ZodNumber;
+  }, z.core.$strip>>;
+  verify: z.ZodNullable<z.ZodObject<{
+    ok: z.ZodBoolean;
+    checkedFiles: z.ZodNumber;
+    summary: z.ZodObject<{
+      rules: z.ZodNumber;
+      passed: z.ZodNumber;
+      violated: z.ZodNumber;
+      findings: z.ZodNumber;
+    }, z.core.$strip>;
+    results: z.ZodArray<z.ZodObject<{
+      ruleId: z.ZodString;
+      status: z.ZodEnum<{
+        pass: "pass";
+        violation: "violation";
+      }>;
+      count: z.ZodNumber;
+      severity: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+      }>>;
+    }, z.core.$strip>>;
+    findings: z.ZodArray<z.ZodObject<{
+      ruleId: z.ZodString;
+      rule: z.ZodString;
+      file: z.ZodString;
+      line: z.ZodOptional<z.ZodNumber>;
+      detail: z.ZodString;
+      cause: z.ZodString;
+      fix: z.ZodString;
+      example: z.ZodString;
+      doc: z.ZodString;
+      docUrl: z.ZodString;
+      templateFile: z.ZodOptional<z.ZodString>;
+      severity: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+      }>>;
+    }, z.core.$strip>>;
+    message: z.ZodString;
+    nextSteps: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>>;
+  queuedAt: z.ZodString;
+  startedAt: z.ZodNullable<z.ZodString>;
+  finishedAt: z.ZodNullable<z.ZodString>;
+  durationMs: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type StorefrontBuild = z.infer<typeof storefrontBuildSchema>;
+export declare const storefrontBuildListQuerySchema: z.ZodObject<{
+  limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
-export type ChangeStorefrontTemplateRequest = z.infer<typeof changeStorefrontTemplateRequestSchema>;
 /**
- * 발행·되돌리기 — 발행은 사이트의 발행 포인터를 바꾸는 조건부 쓰기다. `expectedPublishedVersionId`를 주면
- * 지금 발행 버전이 그 값일 때만 바꾼다(화면을 본 뒤 다른 사람이 바꿨으면 409 `STOREFRONT_SITE_CHANGED`).
- * 이미 그 버전이 발행돼 있으면 아무것도 바꾸지 않고 200이다(같은 요청의 재실행이 안전하다).
+ * `POST /v1/storefront/site/versions` — 지금 작업 트리를 고정해 버전을 만든다(빌드 시작). 사이트당 끝나지 않은 빌드는
+ * 하나다(409 `STOREFRONT_BUILD_IN_PROGRESS`). 편집 환경이 없어도 된다.
  */
-export declare const publishStorefrontVersionRequestSchema: z.ZodObject<{
-  expectedPublishedVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-export type PublishStorefrontVersionRequest = z.infer<typeof publishStorefrontVersionRequestSchema>;
-export declare const rollbackStorefrontRequestSchema: z.ZodObject<{
-  versionId: z.ZodOptional<z.ZodString>;
-  expectedPublishedVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-export type RollbackStorefrontRequest = z.infer<typeof rollbackStorefrontRequestSchema>;
-export declare const changeStorefrontSlugRequestSchema: z.ZodObject<{
-  slug: z.ZodString;
-}, z.core.$strip>;
-export type ChangeStorefrontSlugRequest = z.infer<typeof changeStorefrontSlugRequestSchema>;
-export declare const setStorefrontVisibilityRequestSchema: z.ZodObject<{
-  visibility: z.ZodEnum<{
-    COMING_SOON: "COMING_SOON";
-    PUBLIC: "PUBLIC";
-  }>;
-  expectedVisibility: z.ZodOptional<z.ZodEnum<{
-    COMING_SOON: "COMING_SOON";
-    PUBLIC: "PUBLIC";
-  }>>;
-}, z.core.$strip>;
-export type SetStorefrontVisibilityRequest = z.infer<typeof setStorefrontVisibilityRequestSchema>;
-/** 호스팅 끄기 — 사이트를 닫고(`CLOSED`) 슬러그를 보류한다. 확인 입력은 현재 슬러그다 */
-export declare const disableStorefrontHostingRequestSchema: z.ZodObject<{
-  confirmSlug: z.ZodString;
+export declare const createStorefrontVersionRequestSchema: z.ZodObject<{
+  message: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type DisableStorefrontHostingRequest = z.infer<typeof disableStorefrontHostingRequestSchema>;
-export declare const storefrontSlugAvailabilityQuerySchema: z.ZodObject<{
-  slug: z.ZodString;
+export type CreateStorefrontVersionRequest = z.infer<typeof createStorefrontVersionRequestSchema>;
+/** 버전 만들기 응답 (201) — 버전은 `BUILDING`, 빌드는 `QUEUED`로 시작한다. 결과는 `GET builds/{buildId}`로 본다 */
+export declare const storefrontVersionCreatedSchema: z.ZodObject<{
+  version: z.ZodObject<{
+    versionId: z.ZodString;
+    number: z.ZodNumber;
+    templateId: z.ZodString;
+    templateVersion: z.ZodString;
+    status: z.ZodEnum<{
+      FAILED: "FAILED";
+      BUILDING: "BUILDING";
+      READY: "READY";
+    }>;
+    published: z.ZodBoolean;
+    publishedAt: z.ZodNullable<z.ZodString>;
+    message: z.ZodNullable<z.ZodString>;
+    source: z.ZodEnum<{
+      TEMPLATE: "TEMPLATE";
+      EDIT: "EDIT";
+    }>;
+    buildId: z.ZodNullable<z.ZodString>;
+    createdByType: z.ZodString;
+    createdAt: z.ZodString;
+  }, z.core.$strip>;
+  build: z.ZodObject<{
+    buildId: z.ZodString;
+    versionId: z.ZodString;
+    versionNumber: z.ZodNumber;
+    status: z.ZodEnum<{
+      FAILED: "FAILED";
+      SUCCEEDED: "SUCCEEDED";
+      RUNNING: "RUNNING";
+      QUEUED: "QUEUED";
+      TIMED_OUT: "TIMED_OUT";
+    }>;
+    failureStage: z.ZodNullable<z.ZodString>;
+    errorCode: z.ZodNullable<z.ZodString>;
+    logTail: z.ZodNullable<z.ZodString>;
+    stages: z.ZodArray<z.ZodObject<{
+      stage: z.ZodString;
+      ok: z.ZodBoolean;
+      durationMs: z.ZodNumber;
+    }, z.core.$strip>>;
+    verify: z.ZodNullable<z.ZodObject<{
+      ok: z.ZodBoolean;
+      checkedFiles: z.ZodNumber;
+      summary: z.ZodObject<{
+        rules: z.ZodNumber;
+        passed: z.ZodNumber;
+        violated: z.ZodNumber;
+        findings: z.ZodNumber;
+      }, z.core.$strip>;
+      results: z.ZodArray<z.ZodObject<{
+        ruleId: z.ZodString;
+        status: z.ZodEnum<{
+          pass: "pass";
+          violation: "violation";
+        }>;
+        count: z.ZodNumber;
+        severity: z.ZodOptional<z.ZodEnum<{
+          error: "error";
+          warning: "warning";
+        }>>;
+      }, z.core.$strip>>;
+      findings: z.ZodArray<z.ZodObject<{
+        ruleId: z.ZodString;
+        rule: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        detail: z.ZodString;
+        cause: z.ZodString;
+        fix: z.ZodString;
+        example: z.ZodString;
+        doc: z.ZodString;
+        docUrl: z.ZodString;
+        templateFile: z.ZodOptional<z.ZodString>;
+        severity: z.ZodOptional<z.ZodEnum<{
+          error: "error";
+          warning: "warning";
+        }>>;
+      }, z.core.$strip>>;
+      message: z.ZodString;
+      nextSteps: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    queuedAt: z.ZodString;
+    startedAt: z.ZodNullable<z.ZodString>;
+    finishedAt: z.ZodNullable<z.ZodString>;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>;
 }, z.core.$strip>;
+export type StorefrontVersionCreated = z.infer<typeof storefrontVersionCreatedSchema>;
 /**
- * 오픈 준비 중 미리보기 링크 — 콘솔에서 로그인한 OWNER·ADMIN만 받는다(PAT·에이전트 불가). 링크는 5분 안에 한 번 열면
- * 그 브라우저에 12시간짜리 미리보기 쿠키가 생기고 오픈 준비 중인 사이트의 실제 화면을 본다. 링크를 남에게 넘기면 그 사람도
- * 볼 수 있으므로 공유하지 않는다.
+ * `POST /v1/storefront/site/editing/preview-link` — 편집 미리보기(dev 서버) 링크. 콘솔에서 로그인한 OWNER·ADMIN만
+ * 받는다(PAT·에이전트 불가). 5분 안에 열면 그 브라우저에 미리보기 호스트 전용 쿠키(12시간)가 생긴다. 편집 환경이
+ * 없으면 409 `EDIT_SESSION_REQUIRED`다(편집 환경이 `STARTING`이면 링크는 주고, 미리보기 화면이 기동 대기를 보여 준다).
  */
-export declare const createStorefrontPreviewLinkRequestSchema: z.ZodObject<{
+export declare const createStorefrontEditPreviewLinkRequestSchema: z.ZodObject<{
   path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type CreateStorefrontPreviewLinkRequest = z.infer<typeof createStorefrontPreviewLinkRequestSchema>;
-export declare const storefrontPreviewLinkSchema: z.ZodObject<{
-  url: z.ZodString;
-  expiresAt: z.ZodString;
-}, z.core.$strip>;
-export type StorefrontPreviewLink = z.infer<typeof storefrontPreviewLinkSchema>;
+export type CreateStorefrontEditPreviewLinkRequest = CreateStorefrontPreviewLinkRequest;
 //#endregion
 //#region src/schemas/upload.d.ts
 /**
@@ -6505,13 +6917,10 @@ export type StorefrontPreviewLink = z.infer<typeof storefrontPreviewLinkSchema>;
  *
  * - `product-image`: 상품 목록·상세의 상품 이미지. 목록 썸네일로 쓰이므로 정지 이미지만 받는다.
  * - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
- * - `digital-asset`: 파일 다운로드 상품의 판매 파일(이슈 #48). **비공개 객체**로 올라가고 공개 주소가 없다 — 구매자는 제공된
- *   주문상품에서 수명 300초의 서명 주소로만 받는다.
  */
 export declare const uploadPurposeSchema: z.ZodEnum<{
   "product-image": "product-image";
   description: "description";
-  "digital-asset": "digital-asset";
 }>;
 export type UploadPurpose = z.infer<typeof uploadPurposeSchema>;
 export interface UploadPurposeLimit {
@@ -6526,8 +6935,6 @@ export interface UploadPurposeLimit {
  * 직접 PUT되므로 이 검사는 셀러가 올리기 전에 알게 하는 장치이고, 실제 상한은 CDN이 강제한다.
  */
 export declare const UPLOAD_PURPOSE_LIMITS: Record<UploadPurpose, UploadPurposeLimit>;
-/** 비공개 업로드(판매 파일)의 PUT 필수 헤더 — CDN이 이 값으로 공개 조회를 막는다 */
-export declare const PRIVATE_UPLOAD_HEADERS: Readonly<Record<string, string>>;
 /** 파일명의 소문자 확장자. 확장자가 없으면 `""` */
 export declare function uploadExtensionOf(filename: string): string;
 export interface UploadRejection {
@@ -6553,7 +6960,6 @@ export declare const uploadRequestSchema: z.ZodObject<{
   purpose: z.ZodDefault<z.ZodEnum<{
     "product-image": "product-image";
     description: "description";
-    "digital-asset": "digital-asset";
   }>>;
   size: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -6561,8 +6967,6 @@ export type UploadRequest = z.infer<typeof uploadRequestSchema>;
 export declare const uploadTicketSchema: z.ZodObject<{
   url: z.ZodURL;
   uploadUrl: z.ZodURL;
-  key: z.ZodOptional<z.ZodString>;
-  headers: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, z.core.$strip>;
 export type UploadTicket = z.infer<typeof uploadTicketSchema>;
 //#endregion
@@ -6844,8 +7248,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: UploadRequest) => Promise<{
       url: string;
       uploadUrl: string;
-      headers: Record<string, string>;
-      key?: string | undefined;
     }>;
     /**
      * 자리 발급 + 바이트 PUT을 한 번에 — 끝나면 `url`이 공개 주소다.
@@ -6912,7 +7314,31 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        hasOrders?: boolean | undefined;
+      }[];
+      addonGroups: {
+        groupId: string;
+        name: string;
+        sortOrder: number;
+        required: boolean;
+        values: {
+          valueId: string;
+          name: string;
+          sortOrder: number;
+          additionalPrice: number;
+          usable: boolean;
+        }[];
+      }[];
+      customInputs: {
+        inputId: string;
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+        usable: boolean;
+        sortOrder: number;
       }[];
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
@@ -6923,29 +7349,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           returnAddressId: string | null;
         };
       } | {
-        type: "DOWNLOAD";
-        download: {
-          limit: number;
-          days: number;
-          stockTracking: boolean;
-          withdrawalRestricted: boolean;
-        };
-      } | {
-        type: "CODE";
-        code: {
-          mode: "AUTO" | "MANUAL";
-          withdrawalRestricted: boolean;
-        };
-      } | {
-        type: "SERVICE";
-        service: {
-          mode: "AUTO" | "MANUAL";
-        };
-      } | {
-        type: "PICKUP";
-        pickup: {
-          addressId: string | null;
-        };
+        type: "MANUAL";
       };
       fulfillmentTypeLocked: boolean;
       refundPolicy: {
@@ -7006,7 +7410,31 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        hasOrders?: boolean | undefined;
+      }[];
+      addonGroups: {
+        groupId: string;
+        name: string;
+        sortOrder: number;
+        required: boolean;
+        values: {
+          valueId: string;
+          name: string;
+          sortOrder: number;
+          additionalPrice: number;
+          usable: boolean;
+        }[];
+      }[];
+      customInputs: {
+        inputId: string;
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+        usable: boolean;
+        sortOrder: number;
       }[];
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
@@ -7017,29 +7445,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           returnAddressId: string | null;
         };
       } | {
-        type: "DOWNLOAD";
-        download: {
-          limit: number;
-          days: number;
-          stockTracking: boolean;
-          withdrawalRestricted: boolean;
-        };
-      } | {
-        type: "CODE";
-        code: {
-          mode: "AUTO" | "MANUAL";
-          withdrawalRestricted: boolean;
-        };
-      } | {
-        type: "SERVICE";
-        service: {
-          mode: "AUTO" | "MANUAL";
-        };
-      } | {
-        type: "PICKUP";
-        pickup: {
-          addressId: string | null;
-        };
+        type: "MANUAL";
       };
       fulfillmentTypeLocked: boolean;
       refundPolicy: {
@@ -7100,7 +7506,31 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        hasOrders?: boolean | undefined;
+      }[];
+      addonGroups: {
+        groupId: string;
+        name: string;
+        sortOrder: number;
+        required: boolean;
+        values: {
+          valueId: string;
+          name: string;
+          sortOrder: number;
+          additionalPrice: number;
+          usable: boolean;
+        }[];
+      }[];
+      customInputs: {
+        inputId: string;
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+        usable: boolean;
+        sortOrder: number;
       }[];
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
@@ -7111,29 +7541,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           returnAddressId: string | null;
         };
       } | {
-        type: "DOWNLOAD";
-        download: {
-          limit: number;
-          days: number;
-          stockTracking: boolean;
-          withdrawalRestricted: boolean;
-        };
-      } | {
-        type: "CODE";
-        code: {
-          mode: "AUTO" | "MANUAL";
-          withdrawalRestricted: boolean;
-        };
-      } | {
-        type: "SERVICE";
-        service: {
-          mode: "AUTO" | "MANUAL";
-        };
-      } | {
-        type: "PICKUP";
-        pickup: {
-          addressId: string | null;
-        };
+        type: "MANUAL";
       };
       fulfillmentTypeLocked: boolean;
       refundPolicy: {
@@ -7198,7 +7606,31 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        hasOrders?: boolean | undefined;
+      }[];
+      addonGroups: {
+        groupId: string;
+        name: string;
+        sortOrder: number;
+        required: boolean;
+        values: {
+          valueId: string;
+          name: string;
+          sortOrder: number;
+          additionalPrice: number;
+          usable: boolean;
+        }[];
+      }[];
+      customInputs: {
+        inputId: string;
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+        usable: boolean;
+        sortOrder: number;
       }[];
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
     }>;
     /**
      * 옵션 모델 전체 교체 — variants는 valueNames로 축 값을 지목한다.
@@ -7227,7 +7659,31 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        hasOrders?: boolean | undefined;
+      }[];
+      addonGroups: {
+        groupId: string;
+        name: string;
+        sortOrder: number;
+        required: boolean;
+        values: {
+          valueId: string;
+          name: string;
+          sortOrder: number;
+          additionalPrice: number;
+          usable: boolean;
+        }[];
+      }[];
+      customInputs: {
+        inputId: string;
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+        usable: boolean;
+        sortOrder: number;
       }[];
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
     }>;
     /** 재고 변경 — stockQuantity(절대값) 또는 adjustment(증감) 하나만 전달한다 */
     updateVariantStock: (productId: string, variantId: string, body: VariantStockRequest) => Promise<{
@@ -7251,109 +7707,139 @@ export declare function createStoreClient(options: StoreClientOptions): {
       endAt: string | null;
     }>;
     removeDiscount: (productId: string) => Promise<void>;
-    /**
-     * 코드 일괄 업로드 (이슈 #48) — 코드 발급·자동 제공 상품의 코드 풀에 올린다. `codes`와 `csv` 중 하나만 보낸다.
-     * 받은 코드 수만큼 재고가 는다. 에러: 409 `NOT_CODE_PRODUCT`·`CODE_POOL_NOT_USED`·`CODE_UPLOAD_CONFLICT`, 400 `TOO_MANY_CODES`
-     */
-    uploadCodes: (productId: string, body: FulfillmentCodeUploadRequest, idempotencyKey?: string) => Promise<{
-      batchId: string;
-      productId: string;
-      variantId: string;
-      total: number;
-      accepted: number;
-      duplicates: number;
-      rejected: {
-        line: number;
-        reason: string;
-      }[];
-      expiresAt: string | null;
-      createdAt: string;
-    }>;
-    /** 코드 목록 — 가린 값(`hint`)만 싣는다. `available`은 필터와 무관한 판매 가능 코드 수다 */
-    listCodes: (productId: string, params?: PageParams & Omit<z.input<typeof fulfillmentCodeListQuerySchema>, "page" | "size">) => Promise<{
+  };
+  /**
+   * 저장 옵션 (이슈 #59) — 자주 쓰는 옵션 구성. 불러오기는 복사라 저장 옵션을 고쳐도 불러온 상품은 바뀌지 않는다.
+   * 권한은 상품과 같다(`product:r`·`product:rw`).
+   */
+  savedOptionSets: {
+    list: (params?: SavedOptionSetListParams) => Promise<{
       page: number;
       size: number;
       totalElements: number;
       totalPages: number;
       contents: {
-        codeId: string;
-        productId: string;
-        variantId: string;
-        batchId: string | null;
-        hint: string;
-        status: string;
-        orderItemId: string | null;
-        assignedAt: string | null;
-        revealedAt: string | null;
-        expiresAt: string | null;
+        optionSetId: string;
+        name: string;
+        optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+        groups: {
+          name: string;
+          kind: string;
+          required: boolean;
+          values: {
+            name: string;
+            additionalPrice: number;
+          }[];
+        }[];
+        customInputs: {
+          label: string;
+          placeholder: string | null;
+          maxLength: number;
+          required: boolean;
+        }[];
+        importedProductCount: number;
         createdAt: string;
+        updatedAt: string;
       }[];
-      available: number;
     }>;
-    /** 판매 가능 코드 폐기 — 재고가 1 준다. 배정된 코드는 409 `CODE_NOT_AVAILABLE` */
-    voidCode: (productId: string, codeId: string) => Promise<{
-      codeId: string;
-      productId: string;
-      variantId: string;
-      batchId: string | null;
-      hint: string;
-      status: string;
-      orderItemId: string | null;
-      assignedAt: string | null;
-      revealedAt: string | null;
-      expiresAt: string | null;
+    get: (optionSetId: string) => Promise<{
+      optionSetId: string;
+      name: string;
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      groups: {
+        name: string;
+        kind: string;
+        required: boolean;
+        values: {
+          name: string;
+          additionalPrice: number;
+        }[];
+      }[];
+      customInputs: {
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+      }[];
+      importedProductCount: number;
       createdAt: string;
+      updatedAt: string;
     }>;
-    /**
-     * 판매 파일 연결 (이슈 #48) — `uploads.create({ purpose: "digital-asset" })`로 받은 `key`에 파일을 올린 뒤 연결한다.
-     * 이후 주문부터 이 파일을 준다. 에러: 400 `INVALID_ASSET_KEY`, 409 `NOT_DOWNLOAD_PRODUCT`·`ASSET_ALREADY_ATTACHED`
-     */
-    attachDigitalAsset: (productId: string, body: DigitalAssetAttachRequest) => Promise<{
-      assetId: string;
-      productId: string;
-      variantId: string | null;
-      fileName: string;
-      contentType: string | null;
-      sizeBytes: number | null;
-      status: string;
+    /** 이름이 겹치면 409 `OPTION_SET_NAME_TAKEN`, 스토어당 200개를 넘으면 409 `OPTION_SET_LIMIT_EXCEEDED` */
+    create: (body: SavedOptionSetRequestInput) => Promise<{
+      optionSetId: string;
+      name: string;
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      groups: {
+        name: string;
+        kind: string;
+        required: boolean;
+        values: {
+          name: string;
+          additionalPrice: number;
+        }[];
+      }[];
+      customInputs: {
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+      }[];
+      importedProductCount: number;
       createdAt: string;
+      updatedAt: string;
     }>;
-    /** 판매 파일 목록 — 해제한 파일도 싣는다. 객체 키·주소는 없다 */
-    listDigitalAssets: (productId: string) => Promise<{
-      assetId: string;
-      productId: string;
-      variantId: string | null;
-      fileName: string;
-      contentType: string | null;
-      sizeBytes: number | null;
-      status: string;
-      createdAt: string;
-    }[]>;
-    /** 판매 파일 해제 — 새 주문에 주지 않는다. 이미 산 구매자는 계속 받는다 */
-    removeDigitalAsset: (productId: string, assetId: string) => Promise<{
-      assetId: string;
-      productId: string;
-      variantId: string | null;
-      fileName: string;
-      contentType: string | null;
-      sizeBytes: number | null;
-      status: string;
+    /** 통째로 바꾼다. 불러온 상품은 바뀌지 않는다 */
+    update: (optionSetId: string, body: SavedOptionSetRequestInput) => Promise<{
+      optionSetId: string;
+      name: string;
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      groups: {
+        name: string;
+        kind: string;
+        required: boolean;
+        values: {
+          name: string;
+          additionalPrice: number;
+        }[];
+      }[];
+      customInputs: {
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+      }[];
+      importedProductCount: number;
       createdAt: string;
+      updatedAt: string;
     }>;
-    /** 판매 파일 확인 주소 — 수명 300초의 서명 주소 */
-    previewDigitalAsset: (productId: string, assetId: string) => Promise<{
-      url: string;
-      expiresAt: string;
-    }>;
-  };
-  fulfillmentCodes: {
-    /**
-     * 코드 평문 열람 — 콘솔에서 로그인한 OWNER·ADMIN만 된다(403 `INSUFFICIENT_ROLE`). 열람 기록과 감사 로그가 남는다.
-     * 평문은 화면에 보인 뒤 저장하지 않는다
-     */
-    reveal: (codeId: string) => Promise<{
-      codeId: string;
-      code: string;
+    remove: (optionSetId: string) => Promise<void>;
+    /** 상품의 현재 옵션을 저장 옵션으로 만든다(또는 `replaceOptionSetId`를 덮어쓴다) */
+    saveFromProduct: (body: SavedOptionSetFromProductRequestInput) => Promise<{
+      optionSet: {
+        optionSetId: string;
+        name: string;
+        optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+        groups: {
+          name: string;
+          kind: string;
+          required: boolean;
+          values: {
+            name: string;
+            additionalPrice: number;
+          }[];
+        }[];
+        customInputs: {
+          label: string;
+          placeholder: string | null;
+          maxLength: number;
+          required: boolean;
+        }[];
+        importedProductCount: number;
+        createdAt: string;
+        updatedAt: string;
+      };
+      additionalPriceDropped: boolean;
     }>;
   };
   categories: {
@@ -7372,7 +7858,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -7392,7 +7878,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -7411,7 +7897,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         visible: boolean;
         showPc: boolean;
         showMobile: boolean;
-        productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+        productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
         metaTitle: string | null;
         metaDescription: string | null;
         metaKeywords: string | null;
@@ -7431,7 +7917,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -7450,7 +7936,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         visible: boolean;
         showPc: boolean;
         showMobile: boolean;
-        productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+        productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
         metaTitle: string | null;
         metaDescription: string | null;
         metaKeywords: string | null;
@@ -7479,7 +7965,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -7498,7 +7984,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -7585,7 +8071,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
           updatedAt: string;
         } | null;
       };
-      withdrawalAgreedAt: string | null;
       testPayment: boolean;
       items: {
         orderItemId: string;
@@ -7596,6 +8081,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
         productName: string;
         optionId: string | null;
         optionName: string | null;
+        optionSelections: {
+          kind: string;
+          groupName: string;
+          valueName: string;
+          additionalPrice: number;
+        }[];
+        customInputs: {
+          label: string;
+          value: string;
+        }[];
         sellerCode: string | null;
         fulfillmentSnapshot: UnknownFulfillment | {
           type: "SHIPPING";
@@ -7604,29 +8099,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             returnAddressId: string | null;
           };
         } | {
-          type: "DOWNLOAD";
-          download: {
-            limit: number;
-            days: number;
-            stockTracked: boolean;
-            withdrawalRestricted: boolean;
-          };
-        } | {
-          type: "CODE";
-          code: {
-            mode: string;
-            withdrawalRestricted: boolean;
-          };
-        } | {
-          type: "SERVICE";
-          service: {
-            mode: string;
-          };
-        } | {
-          type: "PICKUP";
-          pickup: {
-            addressId: string | null;
-          };
+          type: "MANUAL";
         };
         quantity: number;
         canceledQuantity: number;
@@ -7641,31 +8114,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         } | null;
         fulfillment: {
           status: string;
-          mode: string | null;
           fulfilledAt: string;
           note: string | null;
-          codes: {
-            codeId: string;
-            hint: string;
-            status: string;
-            revealedAt: string | null;
-          }[];
-          download: {
-            count: number;
-            limit: number;
-            expiresAt: string | null;
-            firstDownloadedAt: string | null;
-            files: {
-              assetId: string;
-              fileName: string;
-              sizeBytes: number | null;
-            }[];
-          } | null;
-          mail: {
-            status: string;
-            sentAt: string | null;
-            errorCode: string | null;
-          } | null;
+          mode?: string | undefined;
         } | null;
         autoDecisionDate: string | null;
         sellerMemo: string | null;
@@ -7715,6 +8166,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
         productName: string;
         optionId: string | null;
         optionName: string | null;
+        optionSelections: {
+          kind: string;
+          groupName: string;
+          valueName: string;
+          additionalPrice: number;
+        }[];
+        customInputs: {
+          label: string;
+          value: string;
+        }[];
         sellerCode: string | null;
         fulfillmentSnapshot: UnknownFulfillment | {
           type: "SHIPPING";
@@ -7723,29 +8184,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             returnAddressId: string | null;
           };
         } | {
-          type: "DOWNLOAD";
-          download: {
-            limit: number;
-            days: number;
-            stockTracked: boolean;
-            withdrawalRestricted: boolean;
-          };
-        } | {
-          type: "CODE";
-          code: {
-            mode: string;
-            withdrawalRestricted: boolean;
-          };
-        } | {
-          type: "SERVICE";
-          service: {
-            mode: string;
-          };
-        } | {
-          type: "PICKUP";
-          pickup: {
-            addressId: string | null;
-          };
+          type: "MANUAL";
         };
         quantity: number;
         canceledQuantity: number;
@@ -7760,31 +8199,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         } | null;
         fulfillment: {
           status: string;
-          mode: string | null;
           fulfilledAt: string;
           note: string | null;
-          codes: {
-            codeId: string;
-            hint: string;
-            status: string;
-            revealedAt: string | null;
-          }[];
-          download: {
-            count: number;
-            limit: number;
-            expiresAt: string | null;
-            firstDownloadedAt: string | null;
-            files: {
-              assetId: string;
-              fileName: string;
-              sizeBytes: number | null;
-            }[];
-          } | null;
-          mail: {
-            status: string;
-            sentAt: string | null;
-            errorCode: string | null;
-          } | null;
+          mode?: string | undefined;
         } | null;
         autoDecisionDate: string | null;
         sellerMemo: string | null;
@@ -7862,6 +8279,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
       productName: string;
       optionId: string | null;
       optionName: string | null;
+      optionSelections: {
+        kind: string;
+        groupName: string;
+        valueName: string;
+        additionalPrice: number;
+      }[];
+      customInputs: {
+        label: string;
+        value: string;
+      }[];
       sellerCode: string | null;
       fulfillmentSnapshot: UnknownFulfillment | {
         type: "SHIPPING";
@@ -7870,29 +8297,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           returnAddressId: string | null;
         };
       } | {
-        type: "DOWNLOAD";
-        download: {
-          limit: number;
-          days: number;
-          stockTracked: boolean;
-          withdrawalRestricted: boolean;
-        };
-      } | {
-        type: "CODE";
-        code: {
-          mode: string;
-          withdrawalRestricted: boolean;
-        };
-      } | {
-        type: "SERVICE";
-        service: {
-          mode: string;
-        };
-      } | {
-        type: "PICKUP";
-        pickup: {
-          addressId: string | null;
-        };
+        type: "MANUAL";
       };
       quantity: number;
       canceledQuantity: number;
@@ -7907,31 +8312,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | null;
       fulfillment: {
         status: string;
-        mode: string | null;
         fulfilledAt: string;
         note: string | null;
-        codes: {
-          codeId: string;
-          hint: string;
-          status: string;
-          revealedAt: string | null;
-        }[];
-        download: {
-          count: number;
-          limit: number;
-          expiresAt: string | null;
-          firstDownloadedAt: string | null;
-          files: {
-            assetId: string;
-            fileName: string;
-            sizeBytes: number | null;
-          }[];
-        } | null;
-        mail: {
-          status: string;
-          sentAt: string | null;
-          errorCode: string | null;
-        } | null;
+        mode?: string | undefined;
       } | null;
       autoDecisionDate: string | null;
       sellerMemo: string | null;
@@ -7952,14 +8335,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
     }>;
     /**
-     * 제공 안내 메일 재발송 (이슈 #48) — 제공된 주문상품의 안내 메일을 다시 보낸다. 주문상품당 하루 3회(429).
-     * 코드·파일 주소는 메일에 없다
-     */
-    resendFulfillmentMail: (orderItemId: string) => Promise<{
-      mailStatus: string;
-    }>;
-    /**
-     * 제공 처리 (이슈 #48) — 수동 제공 비실물 주문상품(이용권·방문 수령)을 `PAID`·`CONFIRMED`에서 제공 완료(`DELIVERED`)로
+     * 제공 처리 (이슈 #48) — 배송 없는 주문상품(`MANUAL`)을 `PAID`·`CONFIRMED`에서 제공 완료(`DELIVERED`)로
      * 바꾼다. `note`는 구매자 주문 상세에 이용 안내로 실린다. 배송 상품은 409 `SHIPPING_REQUIRED`
      */
     fulfill: (orderItemId: string, body?: FulfillRequest, idempotencyKey?: string) => Promise<{
@@ -7971,6 +8347,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
       productName: string;
       optionId: string | null;
       optionName: string | null;
+      optionSelections: {
+        kind: string;
+        groupName: string;
+        valueName: string;
+        additionalPrice: number;
+      }[];
+      customInputs: {
+        label: string;
+        value: string;
+      }[];
       sellerCode: string | null;
       fulfillmentSnapshot: UnknownFulfillment | {
         type: "SHIPPING";
@@ -7979,29 +8365,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           returnAddressId: string | null;
         };
       } | {
-        type: "DOWNLOAD";
-        download: {
-          limit: number;
-          days: number;
-          stockTracked: boolean;
-          withdrawalRestricted: boolean;
-        };
-      } | {
-        type: "CODE";
-        code: {
-          mode: string;
-          withdrawalRestricted: boolean;
-        };
-      } | {
-        type: "SERVICE";
-        service: {
-          mode: string;
-        };
-      } | {
-        type: "PICKUP";
-        pickup: {
-          addressId: string | null;
-        };
+        type: "MANUAL";
       };
       quantity: number;
       canceledQuantity: number;
@@ -8016,31 +8380,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | null;
       fulfillment: {
         status: string;
-        mode: string | null;
         fulfilledAt: string;
         note: string | null;
-        codes: {
-          codeId: string;
-          hint: string;
-          status: string;
-          revealedAt: string | null;
-        }[];
-        download: {
-          count: number;
-          limit: number;
-          expiresAt: string | null;
-          firstDownloadedAt: string | null;
-          files: {
-            assetId: string;
-            fileName: string;
-            sizeBytes: number | null;
-          }[];
-        } | null;
-        mail: {
-          status: string;
-          sentAt: string | null;
-          errorCode: string | null;
-        } | null;
+        mode?: string | undefined;
       } | null;
       autoDecisionDate: string | null;
       sellerMemo: string | null;
@@ -10294,7 +10636,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: (params?: ApprovalListOptions) => Promise<{
       items: {
         approvalId: string;
-        status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
+        status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
         operationId: string;
         method: string;
         path: string;
@@ -10344,7 +10686,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (approvalId: string) => Promise<{
       approvalId: string;
-      status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -10396,7 +10738,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -10444,7 +10786,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -10541,7 +10883,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
   sellerAddresses: {
     list: (type?: AddressType) => Promise<{
       addressId: string;
-      type: "SHIPPING" | "PICKUP" | "RETURN";
+      type: "SHIPPING" | "RETURN";
       name: string;
       isDefault: boolean;
       contactName: string;
@@ -10576,6 +10918,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: () => Promise<{
       enabled: boolean;
       domain: string;
+      editingEnabled: boolean;
       site: {
         siteId: string;
         slug: string;
@@ -10601,6 +10944,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
           published: boolean;
           publishedAt: string | null;
           message: string | null;
+          source: "TEMPLATE" | "EDIT";
+          buildId: string | null;
           createdByType: string;
           createdAt: string;
         } | null;
@@ -10609,9 +10954,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
           lastErrorCode: string | null;
           syncedAt: string | null;
         };
+        editPreview: {
+          hostname: string | null;
+        };
         slugChangesRemaining: number;
         createdAt: string;
         updatedAt: string;
+        suspension?: {
+          reason: string | null;
+          suspendedAt: string | null;
+        } | null | undefined;
       } | null;
     }>;
     /** `GET /v1/storefront/slug-availability?slug=` — 슬러그를 쓸 수 있는가 */
@@ -10646,6 +10998,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         published: boolean;
         publishedAt: string | null;
         message: string | null;
+        source: "TEMPLATE" | "EDIT";
+        buildId: string | null;
         createdByType: string;
         createdAt: string;
       } | null;
@@ -10654,9 +11008,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /** `POST /v1/storefront/site/template` — 템플릿을 바꾼다. 새 버전을 만들고 기본으로 곧바로 발행한다 */
     changeTemplate: (body: ChangeStorefrontTemplateRequest) => Promise<{
@@ -10684,6 +11045,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         published: boolean;
         publishedAt: string | null;
         message: string | null;
+        source: "TEMPLATE" | "EDIT";
+        buildId: string | null;
         createdByType: string;
         createdAt: string;
       } | null;
@@ -10692,9 +11055,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /** `GET /v1/storefront/site/versions` — 버전 목록(최신 먼저) */
     listVersions: () => Promise<{
@@ -10706,6 +11076,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       published: boolean;
       publishedAt: string | null;
       message: string | null;
+      source: "TEMPLATE" | "EDIT";
+      buildId: string | null;
       createdByType: string;
       createdAt: string;
     }[]>;
@@ -10735,6 +11107,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         published: boolean;
         publishedAt: string | null;
         message: string | null;
+        source: "TEMPLATE" | "EDIT";
+        buildId: string | null;
         createdByType: string;
         createdAt: string;
       } | null;
@@ -10743,9 +11117,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /** `POST /v1/storefront/site/rollback` — 이전 발행 버전으로 되돌린다(재빌드 없음) */
     rollback: (body?: RollbackStorefrontRequest) => Promise<{
@@ -10773,6 +11154,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         published: boolean;
         publishedAt: string | null;
         message: string | null;
+        source: "TEMPLATE" | "EDIT";
+        buildId: string | null;
         createdByType: string;
         createdAt: string;
       } | null;
@@ -10781,9 +11164,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /** `PUT /v1/storefront/site/slug` — 슬러그를 바꾼다. 옛 슬러그는 90일 보류되고 새 주소로 301한다 */
     changeSlug: (body: ChangeStorefrontSlugRequest) => Promise<{
@@ -10811,6 +11201,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         published: boolean;
         publishedAt: string | null;
         message: string | null;
+        source: "TEMPLATE" | "EDIT";
+        buildId: string | null;
         createdByType: string;
         createdAt: string;
       } | null;
@@ -10819,9 +11211,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /** `PUT /v1/storefront/site/visibility` — 오픈 준비 중 ↔ 공개 */
     setVisibility: (body: SetStorefrontVisibilityRequest) => Promise<{
@@ -10849,6 +11248,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         published: boolean;
         publishedAt: string | null;
         message: string | null;
+        source: "TEMPLATE" | "EDIT";
+        buildId: string | null;
         createdByType: string;
         createdAt: string;
       } | null;
@@ -10857,9 +11258,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /**
      * `POST /v1/storefront/site/preview-link` — 오픈 준비 중인 사이트를 구성원이 볼 수 있는 5분짜리 링크.
@@ -10895,6 +11303,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         published: boolean;
         publishedAt: string | null;
         message: string | null;
+        source: "TEMPLATE" | "EDIT";
+        buildId: string | null;
         createdByType: string;
         createdAt: string;
       } | null;
@@ -10903,9 +11313,392 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
+    }>;
+    /** `GET /v1/storefront/site/editing` — 편집 환경 상태(열린 환경·동시 상한·미리보기 인증서) */
+    getEditing: () => Promise<{
+      enabled: boolean;
+      session: {
+        sessionId: string;
+        status: "STARTING" | "RUNNING";
+        startStage: string | null;
+        startedAt: string;
+        lastEditedAt: string | null;
+        lastActiveAt: string;
+        idleExpiresAt: string;
+        closesAt: string;
+      } | null;
+      capacity: {
+        limit: number;
+        inUse: number;
+      };
+      preview: {
+        hostname: string | null;
+      };
+      workingTree: {
+        modified: boolean;
+        lastEditedAt: string | null;
+      };
+    }>;
+    /**
+     * `POST /v1/storefront/site/editing` — 편집 환경을 연다(이미 열려 있으면 그대로). 플랫폼 동시 상한에 걸리면 409
+     * `EDIT_CAPACITY_FULL`(`details.retryAfterSeconds`). 띄우는 데 보통 30초가 걸린다(`session.status: STARTING`)
+     */
+    startEditing: () => Promise<{
+      enabled: boolean;
+      session: {
+        sessionId: string;
+        status: "STARTING" | "RUNNING";
+        startStage: string | null;
+        startedAt: string;
+        lastEditedAt: string | null;
+        lastActiveAt: string;
+        idleExpiresAt: string;
+        closesAt: string;
+      } | null;
+      capacity: {
+        limit: number;
+        inUse: number;
+      };
+      preview: {
+        hostname: string | null;
+      };
+      workingTree: {
+        modified: boolean;
+        lastEditedAt: string | null;
+      };
+    }>;
+    /** `DELETE /v1/storefront/site/editing` — 편집 환경을 닫는다(작업 트리는 보존된다) */
+    stopEditing: () => Promise<{
+      enabled: boolean;
+      session: {
+        sessionId: string;
+        status: "STARTING" | "RUNNING";
+        startStage: string | null;
+        startedAt: string;
+        lastEditedAt: string | null;
+        lastActiveAt: string;
+        idleExpiresAt: string;
+        closesAt: string;
+      } | null;
+      capacity: {
+        limit: number;
+        inUse: number;
+      };
+      preview: {
+        hostname: string | null;
+      };
+      workingTree: {
+        modified: boolean;
+        lastEditedAt: string | null;
+      };
+    }>;
+    /**
+     * `POST /v1/storefront/site/editing/preview-link` — 편집 미리보기(dev 서버) 5분짜리 링크.
+     * 콘솔에서 로그인한 OWNER·ADMIN만 받는다(에이전트 불가)
+     */
+    createEditPreviewLink: (body?: CreateStorefrontEditPreviewLinkRequest) => Promise<{
+      url: string;
+      expiresAt: string;
+    }>;
+    /** `GET /v1/storefront/site/files?prefix=` — 작업 트리 파일 목록 */
+    listFiles: (params?: {
+      prefix?: string;
+    }) => Promise<{
+      files: {
+        path: string;
+        size: number;
+        hash: string;
+      }[];
+      totalBytes: number;
+    }>;
+    /** `GET /v1/storefront/site/files/content?path=` — 파일 하나 읽기 */
+    readFile: (filePath: string) => Promise<{
+      path: string;
+      content: string;
+      encoding: "utf8" | "base64";
+      hash: string;
+      size: number;
+    }>;
+    /**
+     * `POST /v1/storefront/site/files/batch` — 여러 파일 쓰기(해시 조건). 조건이 하나라도 어긋나면 아무것도 쓰지 않고 409
+     * `FILE_CHANGED`(`details.conflicts`). 편집 환경이 없으면 연다
+     */
+    writeFiles: (body: WriteStorefrontFilesRequest) => Promise<{
+      files: {
+        path: string;
+        size: number;
+        hash: string;
+      }[];
+    }>;
+    /** `POST /v1/storefront/site/files/delete` */
+    deleteFile: (body: DeleteStorefrontFileRequest) => Promise<{
+      path: string;
+      deleted: boolean;
+    }>;
+    /** `POST /v1/storefront/site/files/move` */
+    moveFile: (body: MoveStorefrontFileRequest) => Promise<{
+      from: string;
+      to: string;
+      hash: string;
+      size: number;
+    }>;
+    /** `POST /v1/storefront/site/files/search` — 내용 검색 */
+    searchFiles: (body: SearchStorefrontFilesRequest) => Promise<{
+      matches: {
+        path: string;
+        line: number;
+        text: string;
+        column?: number | undefined;
+      }[];
+      truncated: boolean;
+    }>;
+    /**
+     * `POST /v1/storefront/site/checks` (202) — 타입 검사·lint·test 하나를 시작한다. 결과는 `getCheck`로 끝날 때까지 조회한다
+     * (`STOREFRONT_CHECK_TERMINAL_STATUSES`)
+     */
+    runCheck: (body: RunStorefrontCheckRequest) => Promise<{
+      checkId: string;
+      check: string;
+      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      exitCode: number | null;
+      durationMs: number | null;
+      outputTail: string | null;
+      errorCode: string | null;
+      message: string | null;
+      createdAt: string;
+      startedAt: string | null;
+      finishedAt: string | null;
+    }>;
+    /** `GET /v1/storefront/site/checks/{checkId}` — 검사 상태·종료 코드·출력 꼬리 */
+    getCheck: (checkId: string) => Promise<{
+      checkId: string;
+      check: string;
+      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      exitCode: number | null;
+      durationMs: number | null;
+      outputTail: string | null;
+      errorCode: string | null;
+      message: string | null;
+      createdAt: string;
+      startedAt: string | null;
+      finishedAt: string | null;
+    }>;
+    /** `POST /v1/storefront/site/verify` — 작업 트리 규칙 검증(`verify_storefront`와 같은 보고서) */
+    verify: () => Promise<{
+      ok: boolean;
+      checkedFiles: number;
+      summary: {
+        rules: number;
+        passed: number;
+        violated: number;
+        findings: number;
+      };
+      results: {
+        ruleId: string;
+        status: "pass" | "violation";
+        count: number;
+        severity?: "error" | "warning" | undefined;
+      }[];
+      findings: {
+        ruleId: string;
+        rule: string;
+        file: string;
+        detail: string;
+        cause: string;
+        fix: string;
+        example: string;
+        doc: string;
+        docUrl: string;
+        line?: number | undefined;
+        templateFile?: string | undefined;
+        severity?: "error" | "warning" | undefined;
+      }[];
+      message: string;
+      nextSteps: string[];
+    }>;
+    /**
+     * `POST /v1/storefront/site/versions` (201) — 지금 작업 트리로 버전을 만든다(빌드 시작). 버전은 `BUILDING`, 빌드가
+     * 끝나면 `READY` 또는 `FAILED`다
+     */
+    createVersion: (body?: CreateStorefrontVersionRequest) => Promise<{
+      version: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        source: "TEMPLATE" | "EDIT";
+        buildId: string | null;
+        createdByType: string;
+        createdAt: string;
+      };
+      build: {
+        buildId: string;
+        versionId: string;
+        versionNumber: number;
+        status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
+        failureStage: string | null;
+        errorCode: string | null;
+        logTail: string | null;
+        stages: {
+          stage: string;
+          ok: boolean;
+          durationMs: number;
+        }[];
+        verify: {
+          ok: boolean;
+          checkedFiles: number;
+          summary: {
+            rules: number;
+            passed: number;
+            violated: number;
+            findings: number;
+          };
+          results: {
+            ruleId: string;
+            status: "pass" | "violation";
+            count: number;
+            severity?: "error" | "warning" | undefined;
+          }[];
+          findings: {
+            ruleId: string;
+            rule: string;
+            file: string;
+            detail: string;
+            cause: string;
+            fix: string;
+            example: string;
+            doc: string;
+            docUrl: string;
+            line?: number | undefined;
+            templateFile?: string | undefined;
+            severity?: "error" | "warning" | undefined;
+          }[];
+          message: string;
+          nextSteps: string[];
+        } | null;
+        queuedAt: string;
+        startedAt: string | null;
+        finishedAt: string | null;
+        durationMs: number | null;
+      };
+    }>;
+    /** `GET /v1/storefront/site/builds?limit=` — 빌드 목록(최신 먼저) */
+    listBuilds: (params?: {
+      limit?: number;
+    }) => Promise<{
+      buildId: string;
+      versionId: string;
+      versionNumber: number;
+      status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
+      failureStage: string | null;
+      errorCode: string | null;
+      logTail: string | null;
+      stages: {
+        stage: string;
+        ok: boolean;
+        durationMs: number;
+      }[];
+      verify: {
+        ok: boolean;
+        checkedFiles: number;
+        summary: {
+          rules: number;
+          passed: number;
+          violated: number;
+          findings: number;
+        };
+        results: {
+          ruleId: string;
+          status: "pass" | "violation";
+          count: number;
+          severity?: "error" | "warning" | undefined;
+        }[];
+        findings: {
+          ruleId: string;
+          rule: string;
+          file: string;
+          detail: string;
+          cause: string;
+          fix: string;
+          example: string;
+          doc: string;
+          docUrl: string;
+          line?: number | undefined;
+          templateFile?: string | undefined;
+          severity?: "error" | "warning" | undefined;
+        }[];
+        message: string;
+        nextSteps: string[];
+      } | null;
+      queuedAt: string;
+      startedAt: string | null;
+      finishedAt: string | null;
+      durationMs: number | null;
+    }[]>;
+    /** `GET /v1/storefront/site/builds/{buildId}` — 빌드 상태·실패 단계·로그 꼬리·규칙 결과 */
+    getBuild: (buildId: string) => Promise<{
+      buildId: string;
+      versionId: string;
+      versionNumber: number;
+      status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
+      failureStage: string | null;
+      errorCode: string | null;
+      logTail: string | null;
+      stages: {
+        stage: string;
+        ok: boolean;
+        durationMs: number;
+      }[];
+      verify: {
+        ok: boolean;
+        checkedFiles: number;
+        summary: {
+          rules: number;
+          passed: number;
+          violated: number;
+          findings: number;
+        };
+        results: {
+          ruleId: string;
+          status: "pass" | "violation";
+          count: number;
+          severity?: "error" | "warning" | undefined;
+        }[];
+        findings: {
+          ruleId: string;
+          rule: string;
+          file: string;
+          detail: string;
+          cause: string;
+          fix: string;
+          example: string;
+          doc: string;
+          docUrl: string;
+          line?: number | undefined;
+          templateFile?: string | undefined;
+          severity?: "error" | "warning" | undefined;
+        }[];
+        message: string;
+        nextSteps: string[];
+      } | null;
+      queuedAt: string;
+      startedAt: string | null;
+      finishedAt: string | null;
+      durationMs: number | null;
     }>;
   };
   store: {
@@ -10921,8 +11714,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
       analyticsAllowedOrigins: string[];
       storefrontOrigins: string[];
       guestCheckoutEnabled: boolean;
-      fulfillmentMailEnabled: boolean;
-      withdrawalNotice: string | null;
       autoDeliverDays: number;
       autoConfirmDays: number;
       refundPolicy: {
@@ -10964,8 +11755,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
       analyticsAllowedOrigins: string[];
       storefrontOrigins: string[];
       guestCheckoutEnabled: boolean;
-      fulfillmentMailEnabled: boolean;
-      withdrawalNotice: string | null;
       autoDeliverDays: number;
       autoConfirmDays: number;
       refundPolicy: {
@@ -11012,7 +11801,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
+      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -11030,7 +11819,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
+      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -11045,7 +11834,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
+      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -11206,6 +11995,7 @@ export declare const couponRejectReasonSchema: z.ZodEnum<{
   NO_ELIGIBLE_ITEMS: "NO_ELIGIBLE_ITEMS";
   MIN_ORDER_AMOUNT: "MIN_ORDER_AMOUNT";
   LINE_NOT_ELIGIBLE: "LINE_NOT_ELIGIBLE";
+  LINE_AMBIGUOUS: "LINE_AMBIGUOUS";
   NO_DISCOUNT: "NO_DISCOUNT";
 }>;
 export type CouponRejectReason = z.infer<typeof couponRejectReasonSchema>;
@@ -11868,41 +12658,31 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
   }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"DOWNLOAD">;
-    download: z.ZodObject<{
-      limit: z.ZodNumber;
-      days: z.ZodNumber;
-      stockTracked: z.ZodBoolean;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"CODE">;
-    code: z.ZodObject<{
-      mode: z.ZodString;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"SERVICE">;
-    service: z.ZodObject<{
-      mode: z.ZodString;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"PICKUP">;
-    pickup: z.ZodObject<{
-      addressId: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>;
+    type: z.ZodLiteral<"MANUAL">;
   }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
     type: z.ZodString;
   }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
     [x: string]: unknown;
     type: string;
   }>>]>>;
+  itemOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    orderItemId: z.ZodString;
+    optionSelections: z.ZodArray<z.ZodObject<{
+      kind: z.ZodString;
+      groupName: z.ZodString;
+      valueName: z.ZodString;
+      additionalPrice: z.ZodNumber;
+    }, z.core.$strip>>;
+    customInputs: z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodString;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type OrderWebhookEventData = z.infer<typeof orderWebhookEventDataSchema>;
 /**
- * `ORDER.FULFILLED` — 비실물 주문상품(파일·코드·이용권·방문 수령)을 제공했다(이슈 #48). 자동 제공은 결제 확정과 함께,
- * 수동 제공은 셀러의 제공 처리(`POST /v1/order-items/{orderItemId}/fulfill`)로 온다. 기존 구독자를 위해 같은 순간
- * `ORDER.DELIVERED`도 함께 보낸다. **코드·파일 주소는 싣지 않는다** — 관리 API로 조회한다.
+ * `ORDER.FULFILLED` — 배송 없는 주문상품(`MANUAL`)을 제공했다(이슈 #48). 셀러의 제공 처리
+ * (`POST /v1/order-items/{orderItemId}/fulfill`)로 온다. 기존 구독자를 위해 같은 순간 `ORDER.DELIVERED`도 함께 보낸다.
  */
 export declare const orderFulfilledWebhookEventDataSchema: z.ZodObject<{
   orderId: z.ZodString;
@@ -11924,38 +12704,16 @@ export declare const orderFulfilledWebhookEventDataSchema: z.ZodObject<{
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
   }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"DOWNLOAD">;
-    download: z.ZodObject<{
-      limit: z.ZodNumber;
-      days: z.ZodNumber;
-      stockTracked: z.ZodBoolean;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"CODE">;
-    code: z.ZodObject<{
-      mode: z.ZodString;
-      withdrawalRestricted: z.ZodBoolean;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"SERVICE">;
-    service: z.ZodObject<{
-      mode: z.ZodString;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"PICKUP">;
-    pickup: z.ZodObject<{
-      addressId: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>;
+    type: z.ZodLiteral<"MANUAL">;
   }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
     type: z.ZodString;
   }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
     [x: string]: unknown;
     type: string;
   }>>]>;
-  fulfillment: z.ZodObject<{
+  fulfillment: z.ZodOptional<z.ZodObject<{
     mode: z.ZodString;
-  }, z.core.$strip>;
+  }, z.core.$strip>>;
   fulfilledAt: z.ZodString;
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
@@ -12076,35 +12834,26 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"DOWNLOAD">;
-      download: z.ZodObject<{
-        limit: z.ZodNumber;
-        days: z.ZodNumber;
-        stockTracked: z.ZodBoolean;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"CODE">;
-      code: z.ZodObject<{
-        mode: z.ZodString;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"SERVICE">;
-      service: z.ZodObject<{
-        mode: z.ZodString;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"PICKUP">;
-      pickup: z.ZodObject<{
-        addressId: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>;
+      type: z.ZodLiteral<"MANUAL">;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
       [x: string]: unknown;
       type: string;
     }>>]>>;
+    itemOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      orderItemId: z.ZodString;
+      optionSelections: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        groupName: z.ZodString;
+        valueName: z.ZodString;
+        additionalPrice: z.ZodNumber;
+      }, z.core.$strip>>;
+      customInputs: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
@@ -12133,38 +12882,16 @@ export declare const orderFulfilledWebhookEventSchema: z.ZodObject<{
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"DOWNLOAD">;
-      download: z.ZodObject<{
-        limit: z.ZodNumber;
-        days: z.ZodNumber;
-        stockTracked: z.ZodBoolean;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"CODE">;
-      code: z.ZodObject<{
-        mode: z.ZodString;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"SERVICE">;
-      service: z.ZodObject<{
-        mode: z.ZodString;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"PICKUP">;
-      pickup: z.ZodObject<{
-        addressId: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>;
+      type: z.ZodLiteral<"MANUAL">;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
       [x: string]: unknown;
       type: string;
     }>>]>;
-    fulfillment: z.ZodObject<{
+    fulfillment: z.ZodOptional<z.ZodObject<{
       mode: z.ZodString;
-    }, z.core.$strip>;
+    }, z.core.$strip>>;
     fulfilledAt: z.ZodString;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>;
@@ -12320,35 +13047,26 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"DOWNLOAD">;
-      download: z.ZodObject<{
-        limit: z.ZodNumber;
-        days: z.ZodNumber;
-        stockTracked: z.ZodBoolean;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"CODE">;
-      code: z.ZodObject<{
-        mode: z.ZodString;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"SERVICE">;
-      service: z.ZodObject<{
-        mode: z.ZodString;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"PICKUP">;
-      pickup: z.ZodObject<{
-        addressId: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>;
+      type: z.ZodLiteral<"MANUAL">;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
       [x: string]: unknown;
       type: string;
     }>>]>>;
+    itemOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      orderItemId: z.ZodString;
+      optionSelections: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        groupName: z.ZodString;
+        valueName: z.ZodString;
+        additionalPrice: z.ZodNumber;
+      }, z.core.$strip>>;
+      customInputs: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
@@ -12376,38 +13094,16 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"DOWNLOAD">;
-      download: z.ZodObject<{
-        limit: z.ZodNumber;
-        days: z.ZodNumber;
-        stockTracked: z.ZodBoolean;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"CODE">;
-      code: z.ZodObject<{
-        mode: z.ZodString;
-        withdrawalRestricted: z.ZodBoolean;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"SERVICE">;
-      service: z.ZodObject<{
-        mode: z.ZodString;
-      }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"PICKUP">;
-      pickup: z.ZodObject<{
-        addressId: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>;
+      type: z.ZodLiteral<"MANUAL">;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
       [x: string]: unknown;
       type: string;
     }>>]>;
-    fulfillment: z.ZodObject<{
+    fulfillment: z.ZodOptional<z.ZodObject<{
       mode: z.ZodString;
-    }, z.core.$strip>;
+    }, z.core.$strip>>;
     fulfilledAt: z.ZodString;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>;