@sayren/store-sdk 0.19.0 → 0.20.0

package/dist/index.d.mts

@@ -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;
@@ -921,8 +921,8 @@ export declare const oauthClientRegistrationRequestSchema: z.ZodObject<{
   }>>;
   redirect_uris: z.ZodOptional<z.ZodArray<z.ZodString>>;
   grant_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-    authorization_code: "authorization_code";
     refresh_token: "refresh_token";
+    authorization_code: "authorization_code";
     client_credentials: "client_credentials";
     "urn:ietf:params:oauth:grant-type:token-exchange": "urn:ietf:params:oauth:grant-type:token-exchange";
   }>>>;
@@ -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;
@@ -3645,29 +3246,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 +3266,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 +3364,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;
@@ -3839,29 +3395,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 +3415,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>;
@@ -3989,29 +3501,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 +3521,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 +3730,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` */
@@ -5459,35 +4926,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, {
@@ -5662,35 +5101,7 @@ 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">>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
@@ -5749,35 +5160,7 @@ 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">>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
@@ -5843,35 +5226,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>;
@@ -5969,8 +5324,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 +5362,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 +5420,8 @@ export declare const invitationSchema: z.ZodObject<{
     STAFF: "STAFF";
   }>;
   status: z.ZodEnum<{
-    EXPIRED: "EXPIRED";
     PENDING: "PENDING";
+    EXPIRED: "EXPIRED";
     ACCEPTED: "ACCEPTED";
     CANCELED: "CANCELED";
   }>;
@@ -6109,8 +5460,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 +5476,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 +5487,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 +5494,6 @@ export declare const sellerAddressSchema: z.ZodObject<{
   addressId: z.ZodString;
   type: z.ZodEnum<{
     SHIPPING: "SHIPPING";
-    PICKUP: "PICKUP";
     RETURN: "RETURN";
   }>;
   name: z.ZodString;
@@ -6162,7 +5509,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;
@@ -6198,6 +5544,23 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
  * - 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 +5569,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 +5601,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 +5625,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 +5677,14 @@ 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>;
 export declare const storefrontSiteSchema: z.ZodObject<{
   siteId: z.ZodString;
   slug: z.ZodString;
@@ -6341,7 +5730,12 @@ export declare const storefrontSiteSchema: z.ZodObject<{
     published: z.ZodBoolean;
     publishedAt: z.ZodNullable<z.ZodString>;
     message: z.ZodNullable<z.ZodString>;
-    createdByType: z.ZodString;
+    source: z.ZodEnum<{
+      TEMPLATE: "TEMPLATE";
+      EDIT: "EDIT";
+    }>;
+    buildId: z.ZodNullable<z.ZodString>;
+    createdByType: z.ZodString;
     createdAt: z.ZodString;
   }, z.core.$strip>>;
   provisioning: z.ZodObject<{
@@ -6353,6 +5747,9 @@ 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;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
@@ -6362,6 +5759,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 +5805,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,6 +5822,9 @@ 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;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -6498,6 +5904,515 @@ export declare const storefrontPreviewLinkSchema: z.ZodObject<{
   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>;
+/**
+ * `POST /v1/storefront/site/versions` — 지금 작업 트리를 고정해 버전을 만든다(빌드 시작). 사이트당 끝나지 않은 빌드는
+ * 하나다(409 `STOREFRONT_BUILD_IN_PROGRESS`). 편집 환경이 없어도 된다.
+ */
+export declare const createStorefrontVersionRequestSchema: z.ZodObject<{
+  message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+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>;
+/**
+ * `POST /v1/storefront/site/editing/preview-link` — 편집 미리보기(dev 서버) 링크. 콘솔에서 로그인한 OWNER·ADMIN만
+ * 받는다(PAT·에이전트 불가). 5분 안에 열면 그 브라우저에 미리보기 호스트 전용 쿠키(12시간)가 생긴다. 편집 환경이
+ * 없으면 409 `EDIT_SESSION_REQUIRED`다(편집 환경이 `STARTING`이면 링크는 주고, 미리보기 화면이 기동 대기를 보여 준다).
+ */
+export declare const createStorefrontEditPreviewLinkRequestSchema: z.ZodObject<{
+  path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateStorefrontEditPreviewLinkRequest = CreateStorefrontPreviewLinkRequest;
 //#endregion
 //#region src/schemas/upload.d.ts
 /**
@@ -6505,13 +6420,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 +6438,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 +6463,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 +6470,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 +6751,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: UploadRequest) => Promise<{
       url: string;
       uploadUrl: string;
-      headers: Record<string, string>;
-      key?: string | undefined;
     }>;
     /**
      * 자리 발급 + 바이트 PUT을 한 번에 — 끝나면 `url`이 공개 주소다.
@@ -6923,29 +6828,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: {
@@ -7017,29 +6900,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: {
@@ -7111,29 +6972,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: {
@@ -7251,110 +7090,6 @@ 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<{
-      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;
-        createdAt: 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;
-      createdAt: 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;
-      createdAt: 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;
-      createdAt: 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;
-    }>;
   };
   categories: {
     list: (params?: {
@@ -7585,7 +7320,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
           updatedAt: string;
         } | null;
       };
-      withdrawalAgreedAt: string | null;
       testPayment: boolean;
       items: {
         orderItemId: string;
@@ -7604,29 +7338,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 +7353,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;
@@ -7723,29 +7413,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 +7428,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;
@@ -7870,29 +7516,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 +7531,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 +7554,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<{
@@ -7979,29 +7574,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 +7589,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 +9845,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 +9895,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 +9947,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 +9995,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 +10092,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 +10127,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: () => Promise<{
       enabled: boolean;
       domain: string;
+      editingEnabled: boolean;
       site: {
         siteId: string;
         slug: string;
@@ -10601,6 +10153,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,6 +10163,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
           lastErrorCode: string | null;
           syncedAt: string | null;
         };
+        editPreview: {
+          hostname: string | null;
+        };
         slugChangesRemaining: number;
         createdAt: string;
         updatedAt: string;
@@ -10646,6 +10203,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,6 +10213,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
@@ -10684,6 +10246,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,6 +10256,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
@@ -10706,6 +10273,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 +10304,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,6 +10314,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
@@ -10773,6 +10347,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,6 +10357,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
@@ -10811,6 +10390,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,6 +10400,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
@@ -10849,6 +10433,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,6 +10443,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
@@ -10895,6 +10484,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,10 +10494,389 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
+      editPreview: {
+        hostname: string | null;
+      };
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
     }>;
+    /** `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: {
     get: () => Promise<{
@@ -10921,8 +10891,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 +10932,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 +10978,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 +10996,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 +11011,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;
@@ -11868,29 +11834,7 @@ 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, {
@@ -11900,9 +11844,8 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
 }, 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 +11867,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,29 +11997,7 @@ 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, {
@@ -12133,38 +12032,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,29 +12197,7 @@ 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, {
@@ -12376,38 +12231,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>;