@sayren/store-sdk 0.17.0 → 0.19.0

package/dist/index.d.mts

@@ -33,8 +33,8 @@ export declare const auditLogSourceSchema: z.ZodEnum<{
 }>;
 export type AuditLogSource = z.infer<typeof auditLogSourceSchema>;
 export declare const auditLogOutcomeSchema: z.ZodEnum<{
-  SUCCEEDED: "SUCCEEDED";
   FAILED: "FAILED";
+  SUCCEEDED: "SUCCEEDED";
   PENDING_APPROVAL: "PENDING_APPROVAL";
   DENIED: "DENIED";
   DRY_RUN: "DRY_RUN";
@@ -69,8 +69,8 @@ export declare const auditLogSchema: z.ZodObject<{
   path: z.ZodNullable<z.ZodString>;
   statusCode: z.ZodNullable<z.ZodNumber>;
   outcome: z.ZodNullable<z.ZodEnum<{
-    SUCCEEDED: "SUCCEEDED";
     FAILED: "FAILED";
+    SUCCEEDED: "SUCCEEDED";
     PENDING_APPROVAL: "PENDING_APPROVAL";
     DENIED: "DENIED";
     DRY_RUN: "DRY_RUN";
@@ -102,8 +102,8 @@ export declare const auditLogListQuerySchema: z.ZodObject<{
     DOMAIN: "DOMAIN";
   }>>;
   outcome: z.ZodOptional<z.ZodEnum<{
-    SUCCEEDED: "SUCCEEDED";
     FAILED: "FAILED";
+    SUCCEEDED: "SUCCEEDED";
     PENDING_APPROVAL: "PENDING_APPROVAL";
     DENIED: "DENIED";
     DRY_RUN: "DRY_RUN";
@@ -149,8 +149,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
     path: z.ZodNullable<z.ZodString>;
     statusCode: z.ZodNullable<z.ZodNumber>;
     outcome: z.ZodNullable<z.ZodEnum<{
-      SUCCEEDED: "SUCCEEDED";
       FAILED: "FAILED";
+      SUCCEEDED: "SUCCEEDED";
       PENDING_APPROVAL: "PENDING_APPROVAL";
       DENIED: "DENIED";
       DRY_RUN: "DRY_RUN";
@@ -166,8 +166,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
   DENIED: "DENIED";
-  ALLOW: "ALLOW";
   APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+  ALLOW: "ALLOW";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
 export declare const writePreviewSchema: z.ZodObject<{
@@ -191,8 +191,8 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
     DENIED: "DENIED";
-    ALLOW: "ALLOW";
     APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+    ALLOW: "ALLOW";
   }>;
   reason: z.ZodNullable<z.ZodString>;
   preview: z.ZodObject<{
@@ -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<{
-  SUCCEEDED: "SUCCEEDED";
-  FAILED: "FAILED";
+  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<{
-    SUCCEEDED: "SUCCEEDED";
-    FAILED: "FAILED";
+    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<{
-    SUCCEEDED: "SUCCEEDED";
-    FAILED: "FAILED";
+    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<{
-      SUCCEEDED: "SUCCEEDED";
-      FAILED: "FAILED";
+      EXPIRED: "EXPIRED";
       PENDING: "PENDING";
+      FAILED: "FAILED";
+      SUCCEEDED: "SUCCEEDED";
       EXECUTING: "EXECUTING";
       UNKNOWN: "UNKNOWN";
       REJECTED: "REJECTED";
-      EXPIRED: "EXPIRED";
     }>;
     operationId: z.ZodString;
     method: z.ZodString;
@@ -581,10 +581,10 @@ export declare const analyticsProductsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AnalyticsProducts = z.infer<typeof analyticsProductsSchema>;
 export declare const analyticsChannelSchema: z.ZodEnum<{
-  UNKNOWN: "UNKNOWN";
   PAID: "PAID";
   DIRECT: "DIRECT";
   CAMPAIGN: "CAMPAIGN";
+  UNKNOWN: "UNKNOWN";
   ORGANIC_SEARCH: "ORGANIC_SEARCH";
   SOCIAL: "SOCIAL";
   EMAIL: "EMAIL";
@@ -615,10 +615,10 @@ export declare const analyticsSourcesQuerySchema: z.ZodObject<{
 export type AnalyticsSourcesParams = z.infer<typeof analyticsSourcesQuerySchema>;
 export declare const analyticsSourceRowSchema: z.ZodObject<{
   channel: z.ZodNullable<z.ZodEnum<{
-    UNKNOWN: "UNKNOWN";
     PAID: "PAID";
     DIRECT: "DIRECT";
     CAMPAIGN: "CAMPAIGN";
+    UNKNOWN: "UNKNOWN";
     ORGANIC_SEARCH: "ORGANIC_SEARCH";
     SOCIAL: "SOCIAL";
     EMAIL: "EMAIL";
@@ -651,10 +651,10 @@ export declare const analyticsSourcesSchema: z.ZodObject<{
   }>;
   rows: z.ZodArray<z.ZodObject<{
     channel: z.ZodNullable<z.ZodEnum<{
-      UNKNOWN: "UNKNOWN";
       PAID: "PAID";
       DIRECT: "DIRECT";
       CAMPAIGN: "CAMPAIGN";
+      UNKNOWN: "UNKNOWN";
       ORGANIC_SEARCH: "ORGANIC_SEARCH";
       SOCIAL: "SOCIAL";
       EMAIL: "EMAIL";
@@ -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<{
-    refresh_token: "refresh_token";
     authorization_code: "authorization_code";
+    refresh_token: "refresh_token";
     client_credentials: "client_credentials";
     "urn:ietf:params:oauth:grant-type:token-exchange": "urn:ietf:params:oauth:grant-type:token-exchange";
   }>>>;
@@ -2379,10 +2379,10 @@ export type OrderItemDownload = z.infer<typeof orderItemDownloadSchema>;
  * - `VOID` 셀러가 폐기함
  */
 export declare const fulfillmentCodeStatusSchema: z.ZodEnum<{
-  EXPIRED: "EXPIRED";
   REVOKED: "REVOKED";
   AVAILABLE: "AVAILABLE";
   ASSIGNED: "ASSIGNED";
+  EXPIRED: "EXPIRED";
   VOID: "VOID";
 }>;
 export type FulfillmentCodeStatus = z.infer<typeof fulfillmentCodeStatusSchema>;
@@ -2463,10 +2463,10 @@ export declare const fulfillmentCodeListQuerySchema: z.ZodObject<{
   page: z.ZodOptional<z.ZodString>;
   size: z.ZodOptional<z.ZodString>;
   status: z.ZodOptional<z.ZodEnum<{
-    EXPIRED: "EXPIRED";
     REVOKED: "REVOKED";
     AVAILABLE: "AVAILABLE";
     ASSIGNED: "ASSIGNED";
+    EXPIRED: "EXPIRED";
     VOID: "VOID";
   }>>;
   variantId: z.ZodOptional<z.ZodString>;
@@ -2833,10 +2833,10 @@ export declare const webhookSecretRotatedSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WebhookSecretRotated = z.infer<typeof webhookSecretRotatedSchema>;
 export declare const webhookDeliveryStatusSchema: z.ZodEnum<{
-  FAILED: "FAILED";
   PENDING: "PENDING";
   PENDING_RETRY: "PENDING_RETRY";
   SUCCESS: "SUCCESS";
+  FAILED: "FAILED";
 }>;
 export type WebhookDeliveryStatus = z.infer<typeof webhookDeliveryStatusSchema>;
 export declare const webhookDeliveryErrorCodeSchema: z.ZodEnum<{
@@ -2898,10 +2898,10 @@ export declare const webhookDeliverySchema: z.ZodObject<{
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
-    FAILED: "FAILED";
     PENDING: "PENDING";
     PENDING_RETRY: "PENDING_RETRY";
     SUCCESS: "SUCCESS";
+    FAILED: "FAILED";
   }>;
   responseStatusCode: z.ZodNullable<z.ZodNumber>;
   responseTimeMs: z.ZodNullable<z.ZodNumber>;
@@ -2951,10 +2951,10 @@ export declare const webhookDeliveryDetailSchema: z.ZodObject<{
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
-    FAILED: "FAILED";
     PENDING: "PENDING";
     PENDING_RETRY: "PENDING_RETRY";
     SUCCESS: "SUCCESS";
+    FAILED: "FAILED";
   }>;
   responseStatusCode: z.ZodNullable<z.ZodNumber>;
   responseTimeMs: z.ZodNullable<z.ZodNumber>;
@@ -2989,10 +2989,10 @@ export type WebhookDeliveryDetail = z.infer<typeof webhookDeliveryDetailSchema>;
 /** 전송 기록 조회 쿼리 — `GET /webhooks/{id}/deliveries` */
 export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodEnum<{
-    FAILED: "FAILED";
     PENDING: "PENDING";
     PENDING_RETRY: "PENDING_RETRY";
     SUCCESS: "SUCCESS";
+    FAILED: "FAILED";
   }>>;
   eventType: z.ZodOptional<z.ZodEnum<{
     "ORDER.PAID": "ORDER.PAID";
@@ -3232,6 +3232,323 @@ export declare function resolveFulfillmentMode(type: FulfillmentType, mode: Fulf
  * 정책 지문 키(`b:…`)와 겹치지 않는다.
  */
 export declare const NO_SHIPPING_BUNDLE_KEY = "none";
+/** 배송비 유형 — 무료·유료·조건부 무료 */
+export declare const deliveryTypeSchema: z.ZodEnum<{
+  FREE: "FREE";
+  PAID: "PAID";
+  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" }`만으로 등록할 수 있다).
+ */
+export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodOptional<z.ZodObject<{
+    deliveryType: z.ZodDefault<z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>>;
+    deliveryFee: z.ZodOptional<z.ZodNumber>;
+    conditionalFreeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    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>>;
+}, z.core.$strict>], "type">;
+export type ProductFulfillmentCreate = z.infer<typeof productFulfillmentCreateSchema>;
+/** 등록 요청의 입력 모양 — 기본값이 채워지기 전(생략 가능한 필드가 optional) */
+export type ProductFulfillmentCreateInput = z.input<typeof productFulfillmentCreateSchema>;
+/**
+ * 상품 이행 — 수정(PUT·PATCH). 통째 교체이고 유형 키와 그 안의 필드가 **모두 필수**다. 서버는 현재 값과 병합하지 않는다.
+ * `fulfillment` 자체를 생략하면 이행을 바꾸지 않는다.
+ */
+export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    deliveryType: z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>;
+    deliveryFee: z.ZodNumber;
+    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+    shippingAddressId: z.ZodNullable<z.ZodString>;
+    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>;
+}, z.core.$strict>], "type">;
+export type ProductFulfillmentUpdate = z.infer<typeof productFulfillmentUpdateSchema>;
+/**
+ * 저장된 상품 이행 — 알려진 유형의 닫힌 유니온. 서버의 상품 엔티티와 응답이 이 모양을 쓴다.
+ * 응답 파싱은 `productFulfillmentResponseSchema`(열린 유니온)를 쓴다.
+ */
+export declare const productFulfillmentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    deliveryType: z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>;
+    deliveryFee: z.ZodNumber;
+    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+    shippingAddressId: z.ZodNullable<z.ZodString>;
+    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>;
+}, z.core.$strip>], "type">;
+export type ProductFulfillment = z.infer<typeof productFulfillmentSchema>;
+/** 유형 이름 → 그 유형의 저장된 이행 */
+export type ProductFulfillmentOf<T extends FulfillmentType> = Extract<ProductFulfillment, {
+  type: T;
+}>;
+/** 응답이 알려 주는 모르는 유형 — SDK가 아직 모르는 유형(서버가 나중에 더한 유형) */
+export interface UnknownFulfillment {
+  type: "OTHER";
+  /** 서버가 보낸 유형 이름 */
+  rawType: string;
+}
+/**
+ * 열린 응답 유니온 — 알려진 유형은 판별 유니온으로 검사하고, **모르는 유형만** `{ type: "OTHER", rawType }`로 읽는다.
+ *
+ * `type: z.string()` 가지를 그대로 두면 TS가 `type === "SHIPPING"`으로 좁혀도 문자열 가지가 남는다. `OTHER` 리터럴로 바꿔 좁히기를
+ * 지킨다. 알려진 유형의 모양이 틀린 응답은 폴백으로 숨기지 않고 파싱 오류로 둔다.
+ */
+export declare function openFulfillmentUnion<T extends z.ZodType>(known: T): z.ZodUnion<readonly [T, z.ZodPipe<z.ZodObject<{
+  type: z.ZodString;
+}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+  [x: string]: unknown;
+  type: string;
+}>>]>;
+export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    deliveryType: z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>;
+    deliveryFee: z.ZodNumber;
+    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+    shippingAddressId: z.ZodNullable<z.ZodString>;
+    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>;
+}, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+  type: z.ZodString;
+}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+  [x: string]: unknown;
+  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`)에 있고 다를 수 있다(자동 제공 상품의 수동 복구).
+ */
+export declare const orderItemFulfillmentSnapshotSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    bundleKey: z.ZodNullable<z.ZodString>;
+    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>;
+}, z.core.$strip>], "type">;
+export type OrderItemFulfillmentSnapshot = z.infer<typeof orderItemFulfillmentSnapshotSchema>;
+export declare const orderItemFulfillmentSnapshotResponseSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    bundleKey: z.ZodNullable<z.ZodString>;
+    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>;
+}, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+  type: z.ZodString;
+}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+  [x: string]: unknown;
+  type: string;
+}>>]>;
+export type OrderItemFulfillmentSnapshotView = z.infer<typeof orderItemFulfillmentSnapshotResponseSchema>;
 //#endregion
 //#region src/schemas/order.d.ts
 export declare const orderSummarySchema: z.ZodObject<{
@@ -3321,7 +3638,42 @@ export declare const orderItemSchema: z.ZodObject<{
   optionId: z.ZodNullable<z.ZodString>;
   optionName: z.ZodNullable<z.ZodString>;
   sellerCode: z.ZodNullable<z.ZodString>;
-  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      bundleKey: z.ZodNullable<z.ZodString>;
+      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>;
+  }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+    type: z.ZodString;
+  }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+    [x: string]: unknown;
+    type: string;
+  }>>]>;
   quantity: z.ZodNumber;
   canceledQuantity: z.ZodNumber;
   activeQuantity: z.ZodNumber;
@@ -3377,7 +3729,6 @@ export declare const orderItemSchema: z.ZodObject<{
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
     "CLAIM.COMPLETED": "CLAIM.COMPLETED";
   }>;
-  withdrawalRestricted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
 export type OrderItem = z.infer<typeof orderItemSchema>;
@@ -3481,7 +3832,42 @@ export declare const orderSchema: z.ZodObject<{
     optionId: z.ZodNullable<z.ZodString>;
     optionName: z.ZodNullable<z.ZodString>;
     sellerCode: z.ZodNullable<z.ZodString>;
-    fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        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>;
+    }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+      type: z.ZodString;
+    }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+      [x: string]: unknown;
+      type: string;
+    }>>]>;
     quantity: z.ZodNumber;
     canceledQuantity: z.ZodNumber;
     activeQuantity: z.ZodNumber;
@@ -3537,7 +3923,6 @@ export declare const orderSchema: z.ZodObject<{
       "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
       "CLAIM.COMPLETED": "CLAIM.COMPLETED";
     }>;
-    withdrawalRestricted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -3597,7 +3982,42 @@ export declare const orderItemPageSchema: z.ZodObject<{
     optionId: z.ZodNullable<z.ZodString>;
     optionName: z.ZodNullable<z.ZodString>;
     sellerCode: z.ZodNullable<z.ZodString>;
-    fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        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>;
+    }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+      type: z.ZodString;
+    }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+      [x: string]: unknown;
+      type: string;
+    }>>]>;
     quantity: z.ZodNumber;
     canceledQuantity: z.ZodNumber;
     activeQuantity: z.ZodNumber;
@@ -3653,7 +4073,6 @@ export declare const orderItemPageSchema: z.ZodObject<{
       "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
       "CLAIM.COMPLETED": "CLAIM.COMPLETED";
     }>;
-    withdrawalRestricted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -3717,7 +4136,7 @@ export interface OrderListParams extends PageParams {
   status?: z.infer<typeof orderItemStatusSchema>;
   keyword?: string;
   /** 상품 유형 필터 — 이 유형의 주문상품이 하나라도 있는 주문(이슈 #48) */
-  fulfillmentType?: z.infer<typeof fulfillmentTypeResponseSchema>;
+  fulfillmentType?: string;
   /** 테스트 결제 필터 — `"true"` 테스트 결제만, `"false"` 실결제만, 생략하면 전부 */
   testPayment?: "true" | "false";
 }
@@ -3939,8 +4358,8 @@ export declare const pgEnvironmentSchema: z.ZodEnum<{
 }>;
 export type PgEnvironment = z.infer<typeof pgEnvironmentSchema>;
 export declare const pgVerificationResultSchema: z.ZodEnum<{
-  FAILED: "FAILED";
   SUCCESS: "SUCCESS";
+  FAILED: "FAILED";
 }>;
 export type PgVerificationResult = z.infer<typeof pgVerificationResultSchema>;
 /**
@@ -4089,8 +4508,8 @@ export declare const paymentCredentialSetSchema: z.ZodObject<{
   }, z.core.$strip>>;
   lastVerification: z.ZodNullable<z.ZodObject<{
     result: z.ZodEnum<{
-      FAILED: "FAILED";
       SUCCESS: "SUCCESS";
+      FAILED: "FAILED";
     }>;
     message: z.ZodNullable<z.ZodString>;
     checkedAt: z.ZodString;
@@ -4191,8 +4610,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
   }, z.core.$strip>>;
   lastVerification: z.ZodNullable<z.ZodObject<{
     result: z.ZodEnum<{
-      FAILED: "FAILED";
       SUCCESS: "SUCCESS";
+      FAILED: "FAILED";
     }>;
     message: z.ZodNullable<z.ZodString>;
     checkedAt: z.ZodString;
@@ -4228,8 +4647,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
       }, z.core.$strip>>;
       lastVerification: z.ZodNullable<z.ZodObject<{
         result: z.ZodEnum<{
-          FAILED: "FAILED";
           SUCCESS: "SUCCESS";
+          FAILED: "FAILED";
         }>;
         message: z.ZodNullable<z.ZodString>;
         checkedAt: z.ZodString;
@@ -4264,8 +4683,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
       }, z.core.$strip>>;
       lastVerification: z.ZodNullable<z.ZodObject<{
         result: z.ZodEnum<{
-          FAILED: "FAILED";
           SUCCESS: "SUCCESS";
+          FAILED: "FAILED";
         }>;
         message: z.ZodNullable<z.ZodString>;
         checkedAt: z.ZodString;
@@ -4340,8 +4759,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
     }, z.core.$strip>>;
     lastVerification: z.ZodNullable<z.ZodObject<{
       result: z.ZodEnum<{
-        FAILED: "FAILED";
         SUCCESS: "SUCCESS";
+        FAILED: "FAILED";
       }>;
       message: z.ZodNullable<z.ZodString>;
       checkedAt: z.ZodString;
@@ -4377,8 +4796,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
         }, z.core.$strip>>;
         lastVerification: z.ZodNullable<z.ZodObject<{
           result: z.ZodEnum<{
-            FAILED: "FAILED";
             SUCCESS: "SUCCESS";
+            FAILED: "FAILED";
           }>;
           message: z.ZodNullable<z.ZodString>;
           checkedAt: z.ZodString;
@@ -4413,8 +4832,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
         }, z.core.$strip>>;
         lastVerification: z.ZodNullable<z.ZodObject<{
           result: z.ZodEnum<{
-            FAILED: "FAILED";
             SUCCESS: "SUCCESS";
+            FAILED: "FAILED";
           }>;
           message: z.ZodNullable<z.ZodString>;
           checkedAt: z.ZodString;
@@ -4461,8 +4880,8 @@ export declare const paymentProviderVerificationSchema: z.ZodObject<{
     LIVE: "LIVE";
   }>;
   result: z.ZodEnum<{
-    FAILED: "FAILED";
     SUCCESS: "SUCCESS";
+    FAILED: "FAILED";
   }>;
   message: z.ZodNullable<z.ZodString>;
   checkedAt: z.ZodString;
@@ -4592,8 +5011,8 @@ export type SalesReport = z.infer<typeof salesReportSchema>;
  * - `FAILED`: 승인되지 않고 끝났다(거절·준비 장애·구매자 취소·만료)
  */
 export declare const paymentRecordStatusSchema: z.ZodEnum<{
-  FAILED: "FAILED";
   PENDING: "PENDING";
+  FAILED: "FAILED";
   APPROVED: "APPROVED";
   PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
   REFUNDED: "REFUNDED";
@@ -4640,8 +5059,8 @@ export declare const paymentRecordSchema: z.ZodObject<{
   orderName: z.ZodString;
   customerName: z.ZodString;
   status: z.ZodEnum<{
-    FAILED: "FAILED";
     PENDING: "PENDING";
+    FAILED: "FAILED";
     APPROVED: "APPROVED";
     PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
     REFUNDED: "REFUNDED";
@@ -4686,8 +5105,8 @@ export declare const paymentRecordPageSchema: z.ZodObject<{
     orderName: z.ZodString;
     customerName: z.ZodString;
     status: z.ZodEnum<{
-      FAILED: "FAILED";
       PENDING: "PENDING";
+      FAILED: "FAILED";
       APPROVED: "APPROVED";
       PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
       REFUNDED: "REFUNDED";
@@ -4775,8 +5194,8 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
   orderName: z.ZodString;
   customerName: z.ZodString;
   status: z.ZodEnum<{
-    FAILED: "FAILED";
     PENDING: "PENDING";
+    FAILED: "FAILED";
     APPROVED: "APPROVED";
     PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
     REFUNDED: "REFUNDED";
@@ -4909,12 +5328,6 @@ export declare const productStatusSchema: z.ZodEnum<{
   CLOSED: "CLOSED";
 }>;
 export type ProductStatus = z.infer<typeof productStatusSchema>;
-export declare const deliveryTypeSchema: z.ZodEnum<{
-  FREE: "FREE";
-  PAID: "PAID";
-  CONDITIONAL_FREE: "CONDITIONAL_FREE";
-}>;
-export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
 export declare const productSummarySchema: z.ZodObject<{
   productId: z.ZodString;
   name: z.ZodString;
@@ -4930,7 +5343,9 @@ export declare const productSummarySchema: z.ZodObject<{
   categoryId: z.ZodNullable<z.ZodString>;
   thumbnailUrl: z.ZodOptional<z.ZodURL>;
   hasOptions: z.ZodBoolean;
-  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  fulfillment: z.ZodObject<{
+    type: z.ZodString;
+  }, z.core.$strip>;
   updatedAt: z.ZodString;
 }, z.core.$strip>;
 export type ProductSummary = z.infer<typeof productSummarySchema>;
@@ -4999,25 +5414,6 @@ export declare const productSchema: z.ZodObject<{
   thumbnailUrl: z.ZodOptional<z.ZodURL>;
   hasOptions: z.ZodBoolean;
   updatedAt: z.ZodString;
-  discount: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-    productId: z.ZodString;
-    discountType: z.ZodEnum<{
-      RATE: "RATE";
-      AMOUNT: "AMOUNT";
-    }>;
-    discountValue: z.ZodNumber;
-    discountedPrice: z.ZodNumber;
-    startAt: z.ZodNullable<z.ZodString>;
-    endAt: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>>>;
-  createdAt: z.ZodOptional<z.ZodString>;
-  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-  fulfillmentMode: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-  stockTracking: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-  downloadLimit: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
-  downloadDays: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
-  withdrawalRestricted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-  pickupAddressId: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   description: z.ZodOptional<z.ZodString>;
   descriptionJson: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   originalPrice: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -5049,31 +5445,82 @@ export declare const productSchema: z.ZodObject<{
     sellerCode: z.ZodNullable<z.ZodString>;
     usable: z.ZodBoolean;
   }, z.core.$strip>>;
-  deliveryType: z.ZodOptional<z.ZodEnum<{
-    FREE: "FREE";
-    PAID: "PAID";
-    CONDITIONAL_FREE: "CONDITIONAL_FREE";
-  }>>;
-  deliveryFee: z.ZodOptional<z.ZodNumber>;
-  conditionalFreeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-  returnFee: z.ZodOptional<z.ZodNumber>;
-  exchangeFee: z.ZodOptional<z.ZodNumber>;
-  refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+  fulfillment: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      deliveryType: z.ZodEnum<{
+        FREE: "FREE";
+        PAID: "PAID";
+        CONDITIONAL_FREE: "CONDITIONAL_FREE";
+      }>;
+      deliveryFee: z.ZodNumber;
+      conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+      shippingAddressId: z.ZodNullable<z.ZodString>;
+      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>;
+  }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+    type: z.ZodString;
+  }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+    [x: string]: unknown;
+    type: string;
+  }>>]>;
+  fulfillmentTypeLocked: z.ZodBoolean;
+  refundPolicy: z.ZodNullable<z.ZodObject<{
     preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
     returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
     exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
     sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
     conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
-  }, z.core.$strict>>>;
-  shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-export type Product = z.infer<typeof productSchema>;
-/** 상품 하나에 등록할 수 있는 이미지 최대 장수 — 첫 장이 대표(썸네일)다 */
-export declare const MAX_PRODUCT_IMAGES = 10;
-/**
- * 상품 이미지 주소의 와이어 형식 — URL이고 2048자 이하다.
- *
+  }, z.core.$strict>>;
+  discount: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    productId: z.ZodString;
+    discountType: z.ZodEnum<{
+      RATE: "RATE";
+      AMOUNT: "AMOUNT";
+    }>;
+    discountValue: z.ZodNumber;
+    discountedPrice: z.ZodNumber;
+    startAt: z.ZodNullable<z.ZodString>;
+    endAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>>;
+  createdAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Product = z.infer<typeof productSchema>;
+/** 상품 하나에 등록할 수 있는 이미지 최대 장수 — 첫 장이 대표(썸네일)다 */
+export declare const MAX_PRODUCT_IMAGES = 10;
+/**
+ * 상품 이미지 주소의 와이어 형식 — URL이고 2048자 이하다.
+ *
  * https·확장자 규칙은 여기서 강제하지 않고 `productImageRejection`이 판정한다. 서버가
  * **새로 추가된 주소에만** 그 규칙을 적용해야 하기 때문이다(규칙이 생기기 전에 저장된
  * 주소 하나로 상품 수정 전체가 막히면 셀러가 빠져나갈 길이 없다).
@@ -5201,22 +5648,70 @@ export declare const variantStockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type VariantStock = z.infer<typeof variantStockSchema>;
 export declare const productCreateRequestSchema: z.ZodObject<{
-  fulfillmentType: z.ZodOptional<z.ZodEnum<{
-    SHIPPING: "SHIPPING";
-    DOWNLOAD: "DOWNLOAD";
-    CODE: "CODE";
-    SERVICE: "SERVICE";
-    PICKUP: "PICKUP";
-  }>>;
-  fulfillmentMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-    AUTO: "AUTO";
-    MANUAL: "MANUAL";
-  }>>>;
-  stockTracking: z.ZodOptional<z.ZodBoolean>;
-  downloadLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-  downloadDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-  withdrawalRestricted: z.ZodOptional<z.ZodBoolean>;
-  pickupAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  fulfillment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodOptional<z.ZodObject<{
+      deliveryType: z.ZodDefault<z.ZodEnum<{
+        FREE: "FREE";
+        PAID: "PAID";
+        CONDITIONAL_FREE: "CONDITIONAL_FREE";
+      }>>;
+      deliveryFee: z.ZodOptional<z.ZodNumber>;
+      conditionalFreeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      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>>;
+  }, z.core.$strict>], "type">>;
+  optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodOptional<z.ZodString>;
+      name: z.ZodString;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  variants: z.ZodArray<z.ZodObject<{
+    variantId: z.ZodOptional<z.ZodString>;
+    valueNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    additionalPrice: z.ZodDefault<z.ZodNumber>;
+    stockQuantity: z.ZodOptional<z.ZodNumber>;
+    sku: z.ZodOptional<z.ZodString>;
+    barcode: z.ZodOptional<z.ZodString>;
+    costPrice: z.ZodOptional<z.ZodNumber>;
+    weightGram: z.ZodOptional<z.ZodNumber>;
+    sellerCode: z.ZodOptional<z.ZodString>;
+    usable: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>;
   name: z.ZodString;
   categoryId: z.ZodString;
   salePrice: z.ZodNumber;
@@ -5228,15 +5723,6 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     attributeId: z.ZodString;
     value: z.ZodString;
   }, z.core.$strip>>>;
-  deliveryType: z.ZodDefault<z.ZodEnum<{
-    FREE: "FREE";
-    PAID: "PAID";
-    CONDITIONAL_FREE: "CONDITIONAL_FREE";
-  }>>;
-  deliveryFee: z.ZodOptional<z.ZodNumber>;
-  conditionalFreeAmount: z.ZodOptional<z.ZodNumber>;
-  returnFee: z.ZodDefault<z.ZodNumber>;
-  exchangeFee: z.ZodDefault<z.ZodNumber>;
   refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
     preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
     returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -5244,8 +5730,55 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
     conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strict>>>;
-  shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type ProductCreateRequest = z.infer<typeof productCreateRequestSchema>;
+export type ProductCreateRequestInput = z.input<typeof productCreateRequestSchema>;
+/** 전체 수정(PUT) — 공통 필드는 등록과 같고, 이행은 생략하면 현재 값 유지, 주면 필드가 모두 필수다 */
+export declare const productReplaceRequestSchema: z.ZodObject<{
+  fulfillment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      deliveryType: z.ZodEnum<{
+        FREE: "FREE";
+        PAID: "PAID";
+        CONDITIONAL_FREE: "CONDITIONAL_FREE";
+      }>;
+      deliveryFee: z.ZodNumber;
+      conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+      shippingAddressId: z.ZodNullable<z.ZodString>;
+      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>;
+  }, z.core.$strict>], "type">>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -5266,25 +5799,28 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     sellerCode: z.ZodOptional<z.ZodString>;
     usable: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
-}, z.core.$strip>;
-export type ProductCreateRequest = z.infer<typeof productCreateRequestSchema>;
+  name: z.ZodString;
+  categoryId: z.ZodString;
+  salePrice: z.ZodNumber;
+  originalPrice: z.ZodOptional<z.ZodNumber>;
+  description: z.ZodOptional<z.ZodString>;
+  descriptionJson: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  images: z.ZodOptional<z.ZodArray<z.ZodURL>>;
+  attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    attributeId: z.ZodString;
+    value: z.ZodString;
+  }, z.core.$strip>>>;
+  refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
+    returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
+    conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ProductReplaceRequest = z.infer<typeof productReplaceRequestSchema>;
+export type ProductReplaceRequestInput = z.input<typeof productReplaceRequestSchema>;
 export declare const productPatchRequestSchema: z.ZodObject<{
-  fulfillmentType: z.ZodOptional<z.ZodEnum<{
-    SHIPPING: "SHIPPING";
-    DOWNLOAD: "DOWNLOAD";
-    CODE: "CODE";
-    SERVICE: "SERVICE";
-    PICKUP: "PICKUP";
-  }>>;
-  fulfillmentMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-    AUTO: "AUTO";
-    MANUAL: "MANUAL";
-  }>>>;
-  stockTracking: z.ZodOptional<z.ZodBoolean>;
-  downloadLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-  downloadDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-  withdrawalRestricted: z.ZodOptional<z.ZodBoolean>;
-  pickupAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   name: z.ZodOptional<z.ZodString>;
   salePrice: z.ZodOptional<z.ZodNumber>;
   status: z.ZodOptional<z.ZodEnum<{
@@ -5293,10 +5829,58 @@ export declare const productPatchRequestSchema: z.ZodObject<{
     OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
   }>>;
-  deliveryFee: z.ZodOptional<z.ZodNumber>;
-  shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
+  fulfillment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      deliveryType: z.ZodEnum<{
+        FREE: "FREE";
+        PAID: "PAID";
+        CONDITIONAL_FREE: "CONDITIONAL_FREE";
+      }>;
+      deliveryFee: z.ZodNumber;
+      conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+      shippingAddressId: z.ZodNullable<z.ZodString>;
+      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>;
+  }, z.core.$strict>], "type">>;
+  refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
+    returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
+    conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
 export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 export declare const productSortSchema: z.ZodEnum<{
   "createdAt.desc": "createdAt.desc";
@@ -5485,8 +6069,8 @@ export declare const invitationSchema: z.ZodObject<{
     STAFF: "STAFF";
   }>;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
     EXPIRED: "EXPIRED";
+    PENDING: "PENDING";
     ACCEPTED: "ACCEPTED";
     CANCELED: "CANCELED";
   }>;
@@ -5525,8 +6109,8 @@ export type UpdateMemberRoleRequest = z.infer<typeof updateMemberRoleRequestSche
 /** `GET /v1/store/invitations` 쿼리 — OpenAPI 문서용 형태 */
 export declare const invitationListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodEnum<{
-    PENDING: "PENDING";
     EXPIRED: "EXPIRED";
+    PENDING: "PENDING";
     ACCEPTED: "ACCEPTED";
     CANCELED: "CANCELED";
   }>>;
@@ -5590,6 +6174,331 @@ export declare const sellerAddressRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
 //#endregion
+//#region src/schemas/storefront-hosting.d.ts
+/**
+ * 스토어프론트 호스팅 (이슈 #53, M1: 템플릿 발행) — 관리 API `/v1/storefront/**`의 계약이다.
+ *
+ * 셀러는 템플릿을 골라 사이트를 만들고 `{slug}.{호스팅 도메인}` 주소를 받는다. 발행은 버전 단위이고,
+ * 되돌리기는 이전 버전을 다시 발행하는 것이다(재빌드 없음). 상태의 원천은 api DB이고 Cloudflare 쪽 반영
+ * (라우팅 표·사이트 Worker)은 커밋 뒤 비동기다 — 반영 상태는 `provisioning`으로 본다.
+ *
+ * 스코프는 조회 `storefront:r`, 쓰기 `storefront:rw`(역할 OWNER·ADMIN)다. 에이전트(MCP)의 발행·되돌리기·템플릿 변경·
+ * 공개 전환·슬러그 변경·호스팅 끄기는 승인(`APPROVAL_REQUIRED`)이다 — 구매자가 보는 화면을 바꾸는 쓰기다.
+ *
+ * 오류 코드:
+ * - 403 `STOREFRONT_HOSTING_DISABLED` — 플랫폼 스위치가 꺼져 새 사이트를 만들 수 없다
+ * - 404 `STOREFRONT_SITE_NOT_FOUND` · `STOREFRONT_TEMPLATE_NOT_FOUND` · `STOREFRONT_VERSION_NOT_FOUND`
+ * - 409 `STOREFRONT_SITE_EXISTS` — 이미 사이트가 있다(스토어당 1개)
+ * - 409 `STOREFRONT_SLUG_TAKEN` — 다른 사이트가 쓰거나 보류 중인 슬러그다
+ * - 409 `STOREFRONT_SLUG_CHANGE_LIMIT` — 슬러그는 스토어당 30일에 3번까지 바꾼다
+ * - 409 `STOREFRONT_SITE_CREATE_LIMIT` — 사이트는 스토어당 30일에 3번까지 만든다
+ * - 409 `STOREFRONT_SITE_CHANGED` — 읽은 상태(`expected*`)와 현재 상태가 다르다. 다시 읽고 시도한다
+ * - 409 `STOREFRONT_SITE_NOT_ACTIVE` — 정지(`SUSPENDED`)된 사이트는 바꾸거나 끌 수 없다
+ * - 409 `STOREFRONT_VERSION_NOT_READY` — 빌드가 끝나지 않았거나 실패한 버전은 발행할 수 없다
+ * - 409 `STOREFRONT_NO_ROLLBACK_TARGET` — 되돌릴 이전 발행 버전이 없다
+ * - 400 `STOREFRONT_SLUG_CONFIRM_MISMATCH` — 호스팅 끄기 확인 입력이 현재 슬러그와 다르다
+ * - 503 `STOREFRONT_PREVIEW_NOT_CONFIGURED` — 미리보기 서명 키가 설정되지 않았다
+ */
+/**
+ * 슬러그 형식 — 스토어 코드와 같은 DNS 라벨 규칙(소문자·숫자·하이픈 3~30자, 하이픈으로 시작·끝 불가)에
+ * 연속 하이픈 금지를 더한다. `--`는 버전 미리보기 주소(`v3--{slug}`)와 punycode(`xn--`)가 쓰는 구분자다.
+ */
+export declare const STOREFRONT_SLUG_PATTERN: RegExp;
+/** 호스팅 도메인에서 플랫폼이 쓰거나 쓸 이름 — 스토어 코드 예약어에 호스팅 전용 이름을 더한다 */
+export declare const RESERVED_STOREFRONT_SLUGS: readonly string[];
+export declare function isReservedStorefrontSlug(slug: string): boolean;
+export declare const storefrontSlugSchema: z.ZodString;
+/** 바꾼 슬러그를 다른 사이트가 가져가지 못하게 막는 기간(일). 보류 동안 옛 주소는 새 주소로 301한다 */
+export declare const STOREFRONT_SLUG_HOLD_DAYS = 90;
+/** 슬러그 변경 한도 — 이 기간(일) 안에 */
+export declare const STOREFRONT_SLUG_CHANGE_WINDOW_DAYS = 30;
+/** 슬러그 변경 한도 — 횟수(스토어 단위. 끄고 다시 만들어도 이어서 센다) */
+export declare const STOREFRONT_SLUG_CHANGE_LIMIT = 3;
+/** 사이트 만들기 한도 — 같은 창(30일) 안의 횟수(스토어 단위). 끄고 만들기를 되풀이해 이름을 묶어 두지 못하게 한다 */
+export declare const STOREFRONT_SITE_CREATE_LIMIT = 3;
+export declare const storefrontTemplateSchema: z.ZodObject<{
+  templateId: z.ZodString;
+  name: z.ZodString;
+  industry: z.ZodString;
+  description: z.ZodString;
+  thumbnailUrl: z.ZodNullable<z.ZodString>;
+  version: z.ZodString;
+  isDefault: z.ZodBoolean;
+}, z.core.$strip>;
+export type StorefrontTemplate = z.infer<typeof storefrontTemplateSchema>;
+/**
+ * 버전 상태 — M1은 템플릿 빌드 산출물을 그대로 쓰므로 만들 때 곧바로 `READY`다. `BUILDING`·`FAILED`는
+ * 셀러 편집 빌드(M2)가 쓴다. 발행 여부는 상태가 아니라 사이트의 발행 포인터가 원천이다(`published`).
+ */
+export declare const storefrontVersionStatusSchema: z.ZodEnum<{
+  FAILED: "FAILED";
+  BUILDING: "BUILDING";
+  READY: "READY";
+}>;
+export type StorefrontVersionStatus = z.infer<typeof storefrontVersionStatusSchema>;
+export declare const storefrontVersionSchema: 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>;
+  createdByType: z.ZodString;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontVersion = z.infer<typeof storefrontVersionSchema>;
+export declare const storefrontSiteStatusSchema: z.ZodEnum<{
+  ACTIVE: "ACTIVE";
+  SUSPENDED: "SUSPENDED";
+  CLOSED: "CLOSED";
+}>;
+export type StorefrontSiteStatus = z.infer<typeof storefrontSiteStatusSchema>;
+export declare const storefrontVisibilitySchema: z.ZodEnum<{
+  COMING_SOON: "COMING_SOON";
+  PUBLIC: "PUBLIC";
+}>;
+export type StorefrontVisibility = z.infer<typeof storefrontVisibilitySchema>;
+export declare const storefrontSourceModeSchema: z.ZodEnum<{
+  CUSTOM: "CUSTOM";
+  MANAGED: "MANAGED";
+}>;
+export declare const storefrontDomainSchema: z.ZodObject<{
+  hostname: z.ZodString;
+  kind: z.ZodEnum<{
+    PLATFORM: "PLATFORM";
+    CUSTOM: "CUSTOM";
+  }>;
+  status: z.ZodEnum<{
+    ACTIVE: "ACTIVE";
+    HELD: "HELD";
+  }>;
+  isPrimary: z.ZodBoolean;
+  holdUntil: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontDomain = z.infer<typeof storefrontDomainSchema>;
+/**
+ * 호스팅 반영 상태 — 발행·슬러그·공개 전환은 DB에 먼저 확정되고 Cloudflare 반영은 커밋 뒤에 한다.
+ * `PENDING`이면 반영 중이거나 재시도 대기다(잡이 다시 한다). 반영 뒤에도 라우팅 전파에 최대 1분이 걸린다.
+ */
+export declare const storefrontProvisioningSchema: z.ZodObject<{
+  status: z.ZodEnum<{
+    PENDING: "PENDING";
+    FAILED: "FAILED";
+    SYNCED: "SYNCED";
+  }>;
+  lastErrorCode: z.ZodNullable<z.ZodString>;
+  syncedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontProvisioning = z.infer<typeof storefrontProvisioningSchema>;
+export declare const storefrontSiteSchema: z.ZodObject<{
+  siteId: z.ZodString;
+  slug: z.ZodString;
+  hostname: z.ZodString;
+  url: z.ZodString;
+  domains: z.ZodArray<z.ZodObject<{
+    hostname: z.ZodString;
+    kind: z.ZodEnum<{
+      PLATFORM: "PLATFORM";
+      CUSTOM: "CUSTOM";
+    }>;
+    status: z.ZodEnum<{
+      ACTIVE: "ACTIVE";
+      HELD: "HELD";
+    }>;
+    isPrimary: z.ZodBoolean;
+    holdUntil: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  templateId: z.ZodString;
+  sourceMode: z.ZodEnum<{
+    CUSTOM: "CUSTOM";
+    MANAGED: "MANAGED";
+  }>;
+  status: z.ZodEnum<{
+    ACTIVE: "ACTIVE";
+    SUSPENDED: "SUSPENDED";
+    CLOSED: "CLOSED";
+  }>;
+  visibility: z.ZodEnum<{
+    COMING_SOON: "COMING_SOON";
+    PUBLIC: "PUBLIC";
+  }>;
+  publishedVersion: z.ZodNullable<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>;
+    createdByType: z.ZodString;
+    createdAt: z.ZodString;
+  }, z.core.$strip>>;
+  provisioning: z.ZodObject<{
+    status: z.ZodEnum<{
+      PENDING: "PENDING";
+      FAILED: "FAILED";
+      SYNCED: "SYNCED";
+    }>;
+    lastErrorCode: z.ZodNullable<z.ZodString>;
+    syncedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  slugChangesRemaining: z.ZodNumber;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontSite = z.infer<typeof storefrontSiteSchema>;
+/** `GET /v1/storefront/site` — 스위치 상태와 현재 사이트(없으면 null. 끈 사이트는 싣지 않는다) */
+export declare const storefrontHostingSchema: z.ZodObject<{
+  enabled: z.ZodBoolean;
+  domain: z.ZodString;
+  site: z.ZodNullable<z.ZodObject<{
+    siteId: z.ZodString;
+    slug: z.ZodString;
+    hostname: z.ZodString;
+    url: z.ZodString;
+    domains: z.ZodArray<z.ZodObject<{
+      hostname: z.ZodString;
+      kind: z.ZodEnum<{
+        PLATFORM: "PLATFORM";
+        CUSTOM: "CUSTOM";
+      }>;
+      status: z.ZodEnum<{
+        ACTIVE: "ACTIVE";
+        HELD: "HELD";
+      }>;
+      isPrimary: z.ZodBoolean;
+      holdUntil: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    templateId: z.ZodString;
+    sourceMode: z.ZodEnum<{
+      CUSTOM: "CUSTOM";
+      MANAGED: "MANAGED";
+    }>;
+    status: z.ZodEnum<{
+      ACTIVE: "ACTIVE";
+      SUSPENDED: "SUSPENDED";
+      CLOSED: "CLOSED";
+    }>;
+    visibility: z.ZodEnum<{
+      COMING_SOON: "COMING_SOON";
+      PUBLIC: "PUBLIC";
+    }>;
+    publishedVersion: z.ZodNullable<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>;
+      createdByType: z.ZodString;
+      createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    provisioning: z.ZodObject<{
+      status: z.ZodEnum<{
+        PENDING: "PENDING";
+        FAILED: "FAILED";
+        SYNCED: "SYNCED";
+      }>;
+      lastErrorCode: z.ZodNullable<z.ZodString>;
+      syncedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    slugChangesRemaining: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type StorefrontHosting = z.infer<typeof storefrontHostingSchema>;
+export declare const storefrontSlugAvailabilitySchema: z.ZodObject<{
+  slug: z.ZodString;
+  available: z.ZodBoolean;
+  reason: z.ZodNullable<z.ZodEnum<{
+    RESERVED: "RESERVED";
+    INVALID: "INVALID";
+    TAKEN: "TAKEN";
+    CURRENT: "CURRENT";
+  }>>;
+}, z.core.$strip>;
+export type StorefrontSlugAvailability = z.infer<typeof storefrontSlugAvailabilitySchema>;
+export declare const createStorefrontSiteRequestSchema: z.ZodObject<{
+  templateId: z.ZodString;
+  slug: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateStorefrontSiteRequest = z.infer<typeof createStorefrontSiteRequestSchema>;
+export declare const changeStorefrontTemplateRequestSchema: z.ZodObject<{
+  templateId: z.ZodString;
+  publish: z.ZodOptional<z.ZodBoolean>;
+  message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ChangeStorefrontTemplateRequest = z.infer<typeof changeStorefrontTemplateRequestSchema>;
+/**
+ * 발행·되돌리기 — 발행은 사이트의 발행 포인터를 바꾸는 조건부 쓰기다. `expectedPublishedVersionId`를 주면
+ * 지금 발행 버전이 그 값일 때만 바꾼다(화면을 본 뒤 다른 사람이 바꿨으면 409 `STOREFRONT_SITE_CHANGED`).
+ * 이미 그 버전이 발행돼 있으면 아무것도 바꾸지 않고 200이다(같은 요청의 재실행이 안전하다).
+ */
+export declare const publishStorefrontVersionRequestSchema: z.ZodObject<{
+  expectedPublishedVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type PublishStorefrontVersionRequest = z.infer<typeof publishStorefrontVersionRequestSchema>;
+export declare const rollbackStorefrontRequestSchema: z.ZodObject<{
+  versionId: z.ZodOptional<z.ZodString>;
+  expectedPublishedVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type RollbackStorefrontRequest = z.infer<typeof rollbackStorefrontRequestSchema>;
+export declare const changeStorefrontSlugRequestSchema: z.ZodObject<{
+  slug: z.ZodString;
+}, z.core.$strip>;
+export type ChangeStorefrontSlugRequest = z.infer<typeof changeStorefrontSlugRequestSchema>;
+export declare const setStorefrontVisibilityRequestSchema: z.ZodObject<{
+  visibility: z.ZodEnum<{
+    COMING_SOON: "COMING_SOON";
+    PUBLIC: "PUBLIC";
+  }>;
+  expectedVisibility: z.ZodOptional<z.ZodEnum<{
+    COMING_SOON: "COMING_SOON";
+    PUBLIC: "PUBLIC";
+  }>>;
+}, z.core.$strip>;
+export type SetStorefrontVisibilityRequest = z.infer<typeof setStorefrontVisibilityRequestSchema>;
+/** 호스팅 끄기 — 사이트를 닫고(`CLOSED`) 슬러그를 보류한다. 확인 입력은 현재 슬러그다 */
+export declare const disableStorefrontHostingRequestSchema: z.ZodObject<{
+  confirmSlug: z.ZodString;
+}, z.core.$strip>;
+export type DisableStorefrontHostingRequest = z.infer<typeof disableStorefrontHostingRequestSchema>;
+export declare const storefrontSlugAvailabilityQuerySchema: z.ZodObject<{
+  slug: z.ZodString;
+}, z.core.$strip>;
+/**
+ * 오픈 준비 중 미리보기 링크 — 콘솔에서 로그인한 OWNER·ADMIN만 받는다(PAT·에이전트 불가). 링크는 5분 안에 한 번 열면
+ * 그 브라우저에 12시간짜리 미리보기 쿠키가 생기고 오픈 준비 중인 사이트의 실제 화면을 본다. 링크를 남에게 넘기면 그 사람도
+ * 볼 수 있으므로 공유하지 않는다.
+ */
+export declare const createStorefrontPreviewLinkRequestSchema: z.ZodObject<{
+  path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateStorefrontPreviewLinkRequest = z.infer<typeof createStorefrontPreviewLinkRequestSchema>;
+export declare const storefrontPreviewLinkSchema: z.ZodObject<{
+  url: z.ZodString;
+  expiresAt: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontPreviewLink = z.infer<typeof storefrontPreviewLinkSchema>;
+//#endregion
 //#region src/schemas/upload.d.ts
 /**
  * 업로드 용도. 허용 확장자와 크기 상한이 용도별로 다르다.
@@ -5964,7 +6873,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         stockQuantity: number;
         categoryId: string | null;
         hasOptions: boolean;
-        fulfillmentType: string;
+        fulfillment: {
+          type: string;
+        };
         updatedAt: string;
         thumbnailUrl?: string | undefined;
       }[];
@@ -5979,13 +6890,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
       categoryId: string | null;
       hasOptions: boolean;
       updatedAt: string;
-      fulfillmentType: string;
-      fulfillmentMode: string | null;
-      stockTracking: boolean;
-      downloadLimit: number | null;
-      downloadDays: number | null;
-      withdrawalRestricted: boolean;
-      pickupAddressId: string | null;
       optionGroups: {
         groupId: string;
         name: string;
@@ -6009,16 +6913,49 @@ export declare function createStoreClient(options: StoreClientOptions): {
         sellerCode: string | null;
         usable: boolean;
       }[];
+      fulfillment: UnknownFulfillment | {
+        type: "SHIPPING";
+        shipping: {
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
+          deliveryFee: number;
+          conditionalFreeAmount: number | null;
+          shippingAddressId: string | null;
+          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;
+        };
+      };
+      fulfillmentTypeLocked: boolean;
+      refundPolicy: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null;
       thumbnailUrl?: string | undefined;
-      discount?: {
-        productId: string;
-        discountType: "RATE" | "AMOUNT";
-        discountValue: number;
-        discountedPrice: number;
-        startAt: string | null;
-        endAt: string | null;
-      } | null | undefined;
-      createdAt?: string | undefined;
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
       originalPrice?: number | null | undefined;
@@ -6027,22 +6964,17 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
-      deliveryType?: "FREE" | "PAID" | "CONDITIONAL_FREE" | undefined;
-      deliveryFee?: number | undefined;
-      conditionalFreeAmount?: number | null | undefined;
-      returnFee?: number | undefined;
-      exchangeFee?: number | undefined;
-      refundPolicy?: {
-        preShipmentDeliveryFeeRefund?: boolean | undefined;
-        returnDeliveryFee?: number | undefined;
-        exchangeDeliveryFee?: number | undefined;
-        sellerFaultFreeShipping?: boolean | undefined;
-        conditionalFreeShortfallCharge?: boolean | undefined;
+      discount?: {
+        productId: string;
+        discountType: "RATE" | "AMOUNT";
+        discountValue: number;
+        discountedPrice: number;
+        startAt: string | null;
+        endAt: string | null;
       } | null | undefined;
-      shippingAddressId?: string | null | undefined;
-      returnAddressId?: string | null | undefined;
+      createdAt?: string | undefined;
     }>;
-    create: (body: ProductCreateRequest, idempotencyKey?: string) => Promise<{
+    create: (body: ProductCreateRequestInput, idempotencyKey?: string) => Promise<{
       productId: string;
       name: string;
       status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
@@ -6052,13 +6984,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
       categoryId: string | null;
       hasOptions: boolean;
       updatedAt: string;
-      fulfillmentType: string;
-      fulfillmentMode: string | null;
-      stockTracking: boolean;
-      downloadLimit: number | null;
-      downloadDays: number | null;
-      withdrawalRestricted: boolean;
-      pickupAddressId: string | null;
       optionGroups: {
         groupId: string;
         name: string;
@@ -6082,16 +7007,49 @@ export declare function createStoreClient(options: StoreClientOptions): {
         sellerCode: string | null;
         usable: boolean;
       }[];
+      fulfillment: UnknownFulfillment | {
+        type: "SHIPPING";
+        shipping: {
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
+          deliveryFee: number;
+          conditionalFreeAmount: number | null;
+          shippingAddressId: string | null;
+          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;
+        };
+      };
+      fulfillmentTypeLocked: boolean;
+      refundPolicy: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null;
       thumbnailUrl?: string | undefined;
-      discount?: {
-        productId: string;
-        discountType: "RATE" | "AMOUNT";
-        discountValue: number;
-        discountedPrice: number;
-        startAt: string | null;
-        endAt: string | null;
-      } | null | undefined;
-      createdAt?: string | undefined;
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
       originalPrice?: number | null | undefined;
@@ -6100,22 +7058,17 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
-      deliveryType?: "FREE" | "PAID" | "CONDITIONAL_FREE" | undefined;
-      deliveryFee?: number | undefined;
-      conditionalFreeAmount?: number | null | undefined;
-      returnFee?: number | undefined;
-      exchangeFee?: number | undefined;
-      refundPolicy?: {
-        preShipmentDeliveryFeeRefund?: boolean | undefined;
-        returnDeliveryFee?: number | undefined;
-        exchangeDeliveryFee?: number | undefined;
-        sellerFaultFreeShipping?: boolean | undefined;
-        conditionalFreeShortfallCharge?: boolean | undefined;
+      discount?: {
+        productId: string;
+        discountType: "RATE" | "AMOUNT";
+        discountValue: number;
+        discountedPrice: number;
+        startAt: string | null;
+        endAt: string | null;
       } | null | undefined;
-      shippingAddressId?: string | null | undefined;
-      returnAddressId?: string | null | undefined;
+      createdAt?: string | undefined;
     }>;
-    update: (productId: string, body: ProductCreateRequest) => Promise<{
+    update: (productId: string, body: ProductReplaceRequestInput) => Promise<{
       productId: string;
       name: string;
       status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
@@ -6125,13 +7078,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
       categoryId: string | null;
       hasOptions: boolean;
       updatedAt: string;
-      fulfillmentType: string;
-      fulfillmentMode: string | null;
-      stockTracking: boolean;
-      downloadLimit: number | null;
-      downloadDays: number | null;
-      withdrawalRestricted: boolean;
-      pickupAddressId: string | null;
       optionGroups: {
         groupId: string;
         name: string;
@@ -6155,16 +7101,49 @@ export declare function createStoreClient(options: StoreClientOptions): {
         sellerCode: string | null;
         usable: boolean;
       }[];
+      fulfillment: UnknownFulfillment | {
+        type: "SHIPPING";
+        shipping: {
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
+          deliveryFee: number;
+          conditionalFreeAmount: number | null;
+          shippingAddressId: string | null;
+          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;
+        };
+      };
+      fulfillmentTypeLocked: boolean;
+      refundPolicy: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null;
       thumbnailUrl?: string | undefined;
-      discount?: {
-        productId: string;
-        discountType: "RATE" | "AMOUNT";
-        discountValue: number;
-        discountedPrice: number;
-        startAt: string | null;
-        endAt: string | null;
-      } | null | undefined;
-      createdAt?: string | undefined;
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
       originalPrice?: number | null | undefined;
@@ -6173,20 +7152,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
-      deliveryType?: "FREE" | "PAID" | "CONDITIONAL_FREE" | undefined;
-      deliveryFee?: number | undefined;
-      conditionalFreeAmount?: number | null | undefined;
-      returnFee?: number | undefined;
-      exchangeFee?: number | undefined;
-      refundPolicy?: {
-        preShipmentDeliveryFeeRefund?: boolean | undefined;
-        returnDeliveryFee?: number | undefined;
-        exchangeDeliveryFee?: number | undefined;
-        sellerFaultFreeShipping?: boolean | undefined;
-        conditionalFreeShortfallCharge?: boolean | undefined;
+      discount?: {
+        productId: string;
+        discountType: "RATE" | "AMOUNT";
+        discountValue: number;
+        discountedPrice: number;
+        startAt: string | null;
+        endAt: string | null;
       } | null | undefined;
-      shippingAddressId?: string | null | undefined;
-      returnAddressId?: string | null | undefined;
+      createdAt?: string | undefined;
     }>;
     patch: (productId: string, body: ProductPatchRequest) => Promise<void>;
     remove: (productId: string) => Promise<void>;
@@ -6623,7 +7597,37 @@ export declare function createStoreClient(options: StoreClientOptions): {
         optionId: string | null;
         optionName: string | null;
         sellerCode: string | null;
-        fulfillmentType: string;
+        fulfillmentSnapshot: UnknownFulfillment | {
+          type: "SHIPPING";
+          shipping: {
+            bundleKey: string | null;
+            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;
+          };
+        };
         quantity: number;
         canceledQuantity: number;
         activeQuantity: number;
@@ -6668,7 +7672,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
         orderedAt: string;
         lastChangedAt: string;
         lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
-        withdrawalRestricted: boolean;
         testPayment: boolean;
       }[];
     }>;
@@ -6713,7 +7716,37 @@ export declare function createStoreClient(options: StoreClientOptions): {
         optionId: string | null;
         optionName: string | null;
         sellerCode: string | null;
-        fulfillmentType: string;
+        fulfillmentSnapshot: UnknownFulfillment | {
+          type: "SHIPPING";
+          shipping: {
+            bundleKey: string | null;
+            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;
+          };
+        };
         quantity: number;
         canceledQuantity: number;
         activeQuantity: number;
@@ -6758,7 +7791,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
         orderedAt: string;
         lastChangedAt: string;
         lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
-        withdrawalRestricted: boolean;
         testPayment: boolean;
       }[];
     }>;
@@ -6831,7 +7863,37 @@ export declare function createStoreClient(options: StoreClientOptions): {
       optionId: string | null;
       optionName: string | null;
       sellerCode: string | null;
-      fulfillmentType: string;
+      fulfillmentSnapshot: UnknownFulfillment | {
+        type: "SHIPPING";
+        shipping: {
+          bundleKey: string | null;
+          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;
+        };
+      };
       quantity: number;
       canceledQuantity: number;
       activeQuantity: number;
@@ -6876,7 +7938,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
       orderedAt: string;
       lastChangedAt: string;
       lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
-      withdrawalRestricted: boolean;
       testPayment: boolean;
     }>;
     /** 배송완료 일괄 처리 — 항목별 부분 성공이다 */
@@ -6911,7 +7972,37 @@ export declare function createStoreClient(options: StoreClientOptions): {
       optionId: string | null;
       optionName: string | null;
       sellerCode: string | null;
-      fulfillmentType: string;
+      fulfillmentSnapshot: UnknownFulfillment | {
+        type: "SHIPPING";
+        shipping: {
+          bundleKey: string | null;
+          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;
+        };
+      };
       quantity: number;
       canceledQuantity: number;
       activeQuantity: number;
@@ -6956,7 +8047,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
       orderedAt: string;
       lastChangedAt: string;
       lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
-      withdrawalRestricted: boolean;
       testPayment: boolean;
     }>;
     /** 제공 처리 일괄 — 항목별 부분 성공이다 */
@@ -8017,7 +9107,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     sources: (params: AnalyticsSourcesParams) => Promise<{
       groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
       rows: {
-        channel: "UNKNOWN" | "PAID" | "DIRECT" | "CAMPAIGN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
+        channel: "PAID" | "DIRECT" | "CAMPAIGN" | "UNKNOWN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
         source: string | null;
         medium: string | null;
         campaign: string | null;
@@ -8152,7 +9242,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         orderId: string | null;
         orderName: string;
         customerName: string;
-        status: "FAILED" | "PENDING" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
+        status: "PENDING" | "FAILED" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
         amount: number;
         refundedAmount: number;
         provider: "tosspayments" | "portone" | null;
@@ -8176,7 +9266,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       orderId: string | null;
       orderName: string;
       customerName: string;
-      status: "FAILED" | "PENDING" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
+      status: "PENDING" | "FAILED" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
       amount: number;
       refundedAmount: number;
       provider: "tosspayments" | "portone" | null;
@@ -8275,7 +9365,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           masked: string | null;
         }[];
         lastVerification: {
-          result: "FAILED" | "SUCCESS";
+          result: "SUCCESS" | "FAILED";
           message: string | null;
           checkedAt: string;
         } | null;
@@ -8300,7 +9390,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "FAILED" | "SUCCESS";
+              result: "SUCCESS" | "FAILED";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -8324,7 +9414,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "FAILED" | "SUCCESS";
+              result: "SUCCESS" | "FAILED";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -8376,7 +9466,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           masked: string | null;
         }[];
         lastVerification: {
-          result: "FAILED" | "SUCCESS";
+          result: "SUCCESS" | "FAILED";
           message: string | null;
           checkedAt: string;
         } | null;
@@ -8401,7 +9491,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "FAILED" | "SUCCESS";
+              result: "SUCCESS" | "FAILED";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -8425,7 +9515,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "FAILED" | "SUCCESS";
+              result: "SUCCESS" | "FAILED";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -8482,7 +9572,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "FAILED" | "SUCCESS";
+        result: "SUCCESS" | "FAILED";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -8507,7 +9597,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "FAILED" | "SUCCESS";
+            result: "SUCCESS" | "FAILED";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -8531,7 +9621,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "FAILED" | "SUCCESS";
+            result: "SUCCESS" | "FAILED";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -8578,7 +9668,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "FAILED" | "SUCCESS";
+        result: "SUCCESS" | "FAILED";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -8603,7 +9693,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "FAILED" | "SUCCESS";
+            result: "SUCCESS" | "FAILED";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -8627,7 +9717,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "FAILED" | "SUCCESS";
+            result: "SUCCESS" | "FAILED";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -8684,7 +9774,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "FAILED" | "SUCCESS";
+        result: "SUCCESS" | "FAILED";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -8709,7 +9799,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "FAILED" | "SUCCESS";
+            result: "SUCCESS" | "FAILED";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -8733,7 +9823,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "FAILED" | "SUCCESS";
+            result: "SUCCESS" | "FAILED";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -8780,7 +9870,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "FAILED" | "SUCCESS";
+        result: "SUCCESS" | "FAILED";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -8805,7 +9895,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "FAILED" | "SUCCESS";
+            result: "SUCCESS" | "FAILED";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -8829,7 +9919,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "FAILED" | "SUCCESS";
+            result: "SUCCESS" | "FAILED";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -8885,7 +9975,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "FAILED" | "SUCCESS";
+        result: "SUCCESS" | "FAILED";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -8910,7 +10000,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "FAILED" | "SUCCESS";
+            result: "SUCCESS" | "FAILED";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -8934,7 +10024,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "FAILED" | "SUCCESS";
+            result: "SUCCESS" | "FAILED";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -8962,7 +10052,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     verify: (provider: PgProvider, body?: VerifyPaymentProviderRequest) => Promise<{
       provider: "tosspayments" | "portone";
       environment: "TEST" | "LIVE";
-      result: "FAILED" | "SUCCESS";
+      result: "SUCCESS" | "FAILED";
       message: string | null;
       checkedAt: string;
     }>;
@@ -9028,7 +10118,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       eventId: string;
       eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
       url: string;
-      status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
+      status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
       responseTimeMs: number | null;
       responseBodyExcerpt: string | null;
@@ -9055,7 +10145,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       eventId: string;
       eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
       url: string;
-      status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
+      status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
       responseTimeMs: number | null;
       responseBodyExcerpt: string | null;
@@ -9090,7 +10180,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       eventId: string;
       eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
       url: string;
-      status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
+      status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
       responseTimeMs: number | null;
       responseBodyExcerpt: string | null;
@@ -9186,7 +10276,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         method: string | null;
         path: string | null;
         statusCode: number | null;
-        outcome: "SUCCEEDED" | "FAILED" | "PENDING_APPROVAL" | "DENIED" | "DRY_RUN" | null;
+        outcome: "FAILED" | "SUCCEEDED" | "PENDING_APPROVAL" | "DENIED" | "DRY_RUN" | null;
         errorCode: string | null;
         traceId: string | null;
         idempotencyKey: string | null;
@@ -9204,7 +10294,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: (params?: ApprovalListOptions) => Promise<{
       items: {
         approvalId: string;
-        status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+        status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
         operationId: string;
         method: string;
         path: string;
@@ -9254,7 +10344,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (approvalId: string) => Promise<{
       approvalId: string;
-      status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
       operationId: string;
       method: string;
       path: string;
@@ -9306,7 +10396,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
       operationId: string;
       method: string;
       path: string;
@@ -9354,7 +10444,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "EXPIRED" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED";
       operationId: string;
       method: string;
       path: string;
@@ -9466,6 +10556,358 @@ export declare function createStoreClient(options: StoreClientOptions): {
     remove: (addressId: string) => Promise<void>;
     setDefault: (addressId: string) => Promise<void>;
   };
+  /**
+   * 스토어프론트 호스팅 (이슈 #53) — 조회 `storefront:r`, 쓰기 `storefront:rw`(OWNER·ADMIN).
+   * 쓰기 응답은 바뀐 사이트다. Cloudflare 반영은 커밋 뒤라 `provisioning.status`가 잠시 `PENDING`일 수 있다.
+   * 에이전트 토큰의 발행·되돌리기·템플릿 변경·공개 전환·슬러그 변경·끄기는 승인 대기(`ApprovalPendingError`)다.
+   */
+  storefront: {
+    /** `GET /v1/storefront/templates` — 템플릿 카탈로그 */
+    listTemplates: () => Promise<{
+      templateId: string;
+      name: string;
+      industry: string;
+      description: string;
+      thumbnailUrl: string | null;
+      version: string;
+      isDefault: boolean;
+    }[]>;
+    /** `GET /v1/storefront/site` — 스위치 상태와 현재 사이트(없으면 `site: null`) */
+    get: () => Promise<{
+      enabled: boolean;
+      domain: string;
+      site: {
+        siteId: string;
+        slug: string;
+        hostname: string;
+        url: string;
+        domains: {
+          hostname: string;
+          kind: "PLATFORM" | "CUSTOM";
+          status: "ACTIVE" | "HELD";
+          isPrimary: boolean;
+          holdUntil: string | null;
+        }[];
+        templateId: string;
+        sourceMode: "CUSTOM" | "MANAGED";
+        status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+        visibility: "COMING_SOON" | "PUBLIC";
+        publishedVersion: {
+          versionId: string;
+          number: number;
+          templateId: string;
+          templateVersion: string;
+          status: "FAILED" | "BUILDING" | "READY";
+          published: boolean;
+          publishedAt: string | null;
+          message: string | null;
+          createdByType: string;
+          createdAt: string;
+        } | null;
+        provisioning: {
+          status: "PENDING" | "FAILED" | "SYNCED";
+          lastErrorCode: string | null;
+          syncedAt: string | null;
+        };
+        slugChangesRemaining: number;
+        createdAt: string;
+        updatedAt: string;
+      } | null;
+    }>;
+    /** `GET /v1/storefront/slug-availability?slug=` — 슬러그를 쓸 수 있는가 */
+    checkSlug: (slug: string) => Promise<{
+      slug: string;
+      available: boolean;
+      reason: "RESERVED" | "INVALID" | "TAKEN" | "CURRENT" | null;
+    }>;
+    /** `POST /v1/storefront/site` (201) — 템플릿으로 사이트를 만들고 v1을 발행한다. 공개 상태는 오픈 준비 중이다 */
+    create: (body: CreateStorefrontSiteRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** `POST /v1/storefront/site/template` — 템플릿을 바꾼다. 새 버전을 만들고 기본으로 곧바로 발행한다 */
+    changeTemplate: (body: ChangeStorefrontTemplateRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** `GET /v1/storefront/site/versions` — 버전 목록(최신 먼저) */
+    listVersions: () => Promise<{
+      versionId: string;
+      number: number;
+      templateId: string;
+      templateVersion: string;
+      status: "FAILED" | "BUILDING" | "READY";
+      published: boolean;
+      publishedAt: string | null;
+      message: string | null;
+      createdByType: string;
+      createdAt: string;
+    }[]>;
+    /** `POST /v1/storefront/site/versions/{versionId}/publish` — 그 버전을 발행한다(이미 발행돼 있으면 그대로 200) */
+    publish: (versionId: string, body?: PublishStorefrontVersionRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** `POST /v1/storefront/site/rollback` — 이전 발행 버전으로 되돌린다(재빌드 없음) */
+    rollback: (body?: RollbackStorefrontRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** `PUT /v1/storefront/site/slug` — 슬러그를 바꾼다. 옛 슬러그는 90일 보류되고 새 주소로 301한다 */
+    changeSlug: (body: ChangeStorefrontSlugRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** `PUT /v1/storefront/site/visibility` — 오픈 준비 중 ↔ 공개 */
+    setVisibility: (body: SetStorefrontVisibilityRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /**
+     * `POST /v1/storefront/site/preview-link` — 오픈 준비 중인 사이트를 구성원이 볼 수 있는 5분짜리 링크.
+     * 콘솔에서 로그인한 OWNER·ADMIN만 받는다
+     */
+    createPreviewLink: (body?: CreateStorefrontPreviewLinkRequest) => Promise<{
+      url: string;
+      expiresAt: string;
+    }>;
+    /** `POST /v1/storefront/site/disable` — 호스팅을 끈다(사이트 `CLOSED`, 슬러그 90일 보류). 다시 만들 수 있다 */
+    disable: (body: DisableStorefrontHostingRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+  };
   store: {
     get: () => Promise<{
       storeId: string;
@@ -9570,7 +11012,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
+      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -9588,7 +11030,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
+      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -9603,7 +11045,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
+      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -10049,32 +11491,28 @@ export declare const productRefundPolicyPatchSchema: z.ZodObject<{
   sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
   conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
-/** 정책 해석에 쓰는 상품 값 — 상품별 덮어쓰기와 레거시 배송비 필드 */
+/** 정책 해석에 쓰는 상품 값 — 상품별 덮어쓰기 */
 export interface RefundPolicyProductInput {
   /** 상품별 덮어쓰기. 없으면 스토어 기본을 그대로 쓴다 */
   refundPolicy?: RefundPolicyPatch | null;
-  /** @deprecated 레거시 상품 반품비 — `refundPolicy`가 없는 옛 상품의 값이다 */
-  returnFee?: number | null;
-  /** @deprecated 레거시 상품 교환비 — `refundPolicy`가 없는 옛 상품의 값이다 */
-  exchangeFee?: number | null;
 }
 /**
  * 유효 정책 해석 — 상품별 덮어쓰기 → 스토어 기본 → `REFUND_POLICY_DEFAULTS` 순이다.
  *
- * 반품비·교환비는 레거시 필드(`products.returnFee`·`exchangeFee`)와 **연결**한다. 상품이
- * `refundPolicy.returnDeliveryFee`를 정하면 그 값이 원천이고(서버가 `returnFee`도 같은 값으로 맞춘다),
- * 정하지 않았으면 레거시 값이 0보다 클 때 그 값을 쓴다. 0이면 스토어 기본을 따른다 —
- * 정책이 생기기 전에 만든 상품(반품비 0)이 스토어 기본을 물려받게 하는 규칙이다.
+ * 반품·교환 배송비의 원천은 정책 하나다(이슈 #57 결정 3). 상품의 레거시 반품비·교환비 필드와의 연결은 없앴고,
+ * 레거시 값은 마이그레이션이 상품별 정책으로 옮겼다.
  */
 export declare function resolveRefundPolicy(storePolicy?: RefundPolicyPatch | null, product?: RefundPolicyProductInput | null): RefundPolicy;
 /**
- * 상품의 **덮어쓰기 자체** — 레거시 반품비·교환비를 같은 형태로 승격한 값이다. 덮어쓰기가 없으면 null.
+ * 상품의 **덮어쓰기 자체** — 덮어쓰기가 없으면 null.
  *
  * `resolveRefundPolicy`가 합친 결과로는 "상품이 정한 값"과 "스토어 기본을 물려받은 값"을 가를 수 없다.
  * 관리 API 응답의 `refundPolicy`와 콘솔 폼의 덮어쓰기 스위치가 이 함수를 원천으로 쓴다 — 가르지 못하면
- * 스토어 기본을 쓰는 상품을 저장할 때 그 순간의 기본값이 상품에 박히거나, 레거시 값이 조용히 사라진다.
+ * 스토어 기본을 쓰는 상품을 저장할 때 그 순간의 기본값이 상품에 박힌다.
  */
 export declare function productRefundPolicyOverride(product?: RefundPolicyProductInput | null): RefundPolicyPatch | null;
+/** 반품·교환 배송비 키 — 배송이 없는 상품의 정책에는 두지 않는다 */
+export declare const REFUND_POLICY_DELIVERY_FEE_KEYS: readonly ["returnDeliveryFee", "exchangeDeliveryFee"];
 /**
  * 수량 단위 부분 취소의 환불 기준액 — **누적 내림의 차분**이다.
  *
@@ -10119,6 +11557,7 @@ export declare const STORE_SCOPE_RESOURCES: {
   readonly customer: readonly ["r", "rw"];
   readonly audit: readonly ["r"];
   readonly promotion: readonly ["r", "rw"];
+  readonly storefront: readonly ["r", "rw"];
 };
 export type StoreScopeResource = keyof typeof STORE_SCOPE_RESOURCES;
 export declare const storeScopeResourceSchema: z.ZodEnum<{
@@ -10136,6 +11575,7 @@ export declare const storeScopeResourceSchema: z.ZodEnum<{
   customer: "customer";
   audit: "audit";
   promotion: "promotion";
+  storefront: "storefront";
 }>;
 /** 카탈로그상 존재하는 스코프 문자열인가 (예: `settlement:rw`는 false) */
 export declare function isStoreScope(scope: string): boolean;
@@ -10145,8 +11585,8 @@ export declare function isStoreScope(scope: string): boolean;
  * 발급 시 지정한 스코프만 갖는다(발급자 보유 스코프 이내).
  */
 export declare const STORE_ROLE_SCOPES: {
-  readonly OWNER: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "settlement:r", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw"];
-  readonly ADMIN: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw"];
+  readonly OWNER: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "settlement:r", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw", "storefront:rw"];
+  readonly ADMIN: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw", "storefront:rw"];
   readonly STAFF: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "customer:r", "promotion:r"];
 };
 //#endregion
@@ -10421,7 +11861,42 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
   testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   orderItemId: z.ZodOptional<z.ZodString>;
-  fulfillmentType: z.ZodOptional<z.ZodString>;
+  fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      bundleKey: z.ZodNullable<z.ZodString>;
+      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>;
+  }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+    type: z.ZodString;
+  }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+    [x: string]: unknown;
+    type: string;
+  }>>]>>;
 }, z.core.$strip>;
 export type OrderWebhookEventData = z.infer<typeof orderWebhookEventDataSchema>;
 /**
@@ -10442,8 +11917,45 @@ export declare const orderFulfilledWebhookEventDataSchema: z.ZodObject<{
     DELIVERED: "DELIVERED";
     PURCHASE_DECIDED: "PURCHASE_DECIDED";
   }>;
-  fulfillmentType: z.ZodString;
-  fulfillmentMode: z.ZodNullable<z.ZodString>;
+  fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"SHIPPING">;
+    shipping: z.ZodObject<{
+      bundleKey: z.ZodNullable<z.ZodString>;
+      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>;
+  }, 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<{
+    mode: z.ZodString;
+  }, z.core.$strip>;
   fulfilledAt: z.ZodString;
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
@@ -10557,7 +12069,42 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     orderItemId: z.ZodOptional<z.ZodString>;
-    fulfillmentType: z.ZodOptional<z.ZodString>;
+    fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        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>;
+    }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+      type: z.ZodString;
+    }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+      [x: string]: unknown;
+      type: string;
+    }>>]>>;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
@@ -10579,8 +12126,45 @@ export declare const orderFulfilledWebhookEventSchema: z.ZodObject<{
       DELIVERED: "DELIVERED";
       PURCHASE_DECIDED: "PURCHASE_DECIDED";
     }>;
-    fulfillmentType: z.ZodString;
-    fulfillmentMode: z.ZodNullable<z.ZodString>;
+    fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        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>;
+    }, 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<{
+      mode: z.ZodString;
+    }, z.core.$strip>;
     fulfilledAt: z.ZodString;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>;
@@ -10729,7 +12313,42 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     orderItemId: z.ZodOptional<z.ZodString>;
-    fulfillmentType: z.ZodOptional<z.ZodString>;
+    fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        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>;
+    }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+      type: z.ZodString;
+    }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+      [x: string]: unknown;
+      type: string;
+    }>>]>>;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
@@ -10750,8 +12369,45 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       DELIVERED: "DELIVERED";
       PURCHASE_DECIDED: "PURCHASE_DECIDED";
     }>;
-    fulfillmentType: z.ZodString;
-    fulfillmentMode: z.ZodNullable<z.ZodString>;
+    fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"SHIPPING">;
+      shipping: z.ZodObject<{
+        bundleKey: z.ZodNullable<z.ZodString>;
+        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>;
+    }, 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<{
+      mode: z.ZodString;
+    }, z.core.$strip>;
     fulfilledAt: z.ZodString;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>;