@sayren/store-sdk 0.20.0 → 0.21.0

package/dist/index.d.mts

@@ -165,8 +165,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
-  DENIED: "DENIED";
   APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+  DENIED: "DENIED";
   ALLOW: "ALLOW";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
@@ -190,8 +190,8 @@ export type WritePreview = z.infer<typeof writePreviewSchema>;
 export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
-    DENIED: "DENIED";
     APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+    DENIED: "DENIED";
     ALLOW: "ALLOW";
   }>;
   reason: z.ZodNullable<z.ZodString>;
@@ -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";
   }>>>;
@@ -1171,11 +1171,11 @@ export type ApiTokenCreateRequest = z.infer<typeof apiTokenCreateRequestSchema>;
 //#endregion
 //#region src/schemas/category.d.ts
 export declare const categoryProductSortSchema: z.ZodEnum<{
+  NAME: "NAME";
   RECENT: "RECENT";
   POPULAR: "POPULAR";
   PRICE_LOW: "PRICE_LOW";
   PRICE_HIGH: "PRICE_HIGH";
-  NAME: "NAME";
 }>;
 export type CategoryProductSort = z.infer<typeof categoryProductSortSchema>;
 export declare const categorySchema: z.ZodObject<{
@@ -1191,11 +1191,11 @@ export declare const categorySchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
+    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
-    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1221,11 +1221,11 @@ export declare const categoryWithPathSchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
+    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
-    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1246,11 +1246,11 @@ export declare const categoryWithPathSchema: z.ZodObject<{
     showPc: z.ZodBoolean;
     showMobile: z.ZodBoolean;
     productSort: z.ZodEnum<{
+      NAME: "NAME";
       RECENT: "RECENT";
       POPULAR: "POPULAR";
       PRICE_LOW: "PRICE_LOW";
       PRICE_HIGH: "PRICE_HIGH";
-      NAME: "NAME";
     }>;
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
@@ -1274,11 +1274,11 @@ export declare const categorySearchResultSchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
+    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
-    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1299,11 +1299,11 @@ export declare const categorySearchResultSchema: z.ZodObject<{
     showPc: z.ZodBoolean;
     showMobile: z.ZodBoolean;
     productSort: z.ZodEnum<{
+      NAME: "NAME";
       RECENT: "RECENT";
       POPULAR: "POPULAR";
       PRICE_LOW: "PRICE_LOW";
       PRICE_HIGH: "PRICE_HIGH";
-      NAME: "NAME";
     }>;
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
@@ -1335,11 +1335,11 @@ export declare const categoryCreateRequestSchema: z.ZodObject<{
   showPc: z.ZodOptional<z.ZodBoolean>;
   showMobile: z.ZodOptional<z.ZodBoolean>;
   productSort: z.ZodOptional<z.ZodEnum<{
+    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
-    NAME: "NAME";
   }>>;
   metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1354,11 +1354,11 @@ export declare const categoryPatchRequestSchema: z.ZodObject<{
   showPc: z.ZodOptional<z.ZodBoolean>;
   showMobile: z.ZodOptional<z.ZodBoolean>;
   productSort: z.ZodOptional<z.ZodEnum<{
+    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
-    NAME: "NAME";
   }>>;
   metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -3238,6 +3238,16 @@ export declare const orderItemSchema: z.ZodObject<{
   productName: z.ZodString;
   optionId: z.ZodNullable<z.ZodString>;
   optionName: z.ZodNullable<z.ZodString>;
+  optionSelections: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    kind: z.ZodString;
+    groupName: z.ZodString;
+    valueName: z.ZodString;
+    additionalPrice: z.ZodNumber;
+  }, z.core.$strip>>>>;
+  customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+  }, z.core.$strip>>>>;
   sellerCode: z.ZodNullable<z.ZodString>;
   fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
@@ -3387,6 +3397,16 @@ export declare const orderSchema: z.ZodObject<{
     productName: z.ZodString;
     optionId: z.ZodNullable<z.ZodString>;
     optionName: z.ZodNullable<z.ZodString>;
+    optionSelections: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      kind: z.ZodString;
+      groupName: z.ZodString;
+      valueName: z.ZodString;
+      additionalPrice: z.ZodNumber;
+    }, z.core.$strip>>>>;
+    customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodString;
+    }, z.core.$strip>>>>;
     sellerCode: z.ZodNullable<z.ZodString>;
     fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"SHIPPING">;
@@ -3493,6 +3513,16 @@ export declare const orderItemPageSchema: z.ZodObject<{
     productName: z.ZodString;
     optionId: z.ZodNullable<z.ZodString>;
     optionName: z.ZodNullable<z.ZodString>;
+    optionSelections: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      kind: z.ZodString;
+      groupName: z.ZodString;
+      valueName: z.ZodString;
+      additionalPrice: z.ZodNumber;
+    }, z.core.$strip>>>>;
+    customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodString;
+    }, z.core.$strip>>>>;
     sellerCode: z.ZodNullable<z.ZodString>;
     fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"SHIPPING">;
@@ -4851,8 +4881,124 @@ export declare const productVariantSchema: z.ZodObject<{
   weightGram: z.ZodNullable<z.ZodNumber>;
   sellerCode: z.ZodNullable<z.ZodString>;
   usable: z.ZodBoolean;
+  hasOrders: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type ProductVariant = z.infer<typeof productVariantSchema>;
+/** 옵션 축(그룹) 최대 개수 — 스키마 상한의 단일 원천 */
+export declare const MAX_OPTION_GROUPS = 3;
+/** 축 하나가 가질 수 있는 값의 최대 개수 */
+export declare const MAX_VALUES_PER_GROUP = 100;
+/** 상품 하나가 가질 수 있는 variant(SKU) 최대 개수 */
+export declare const MAX_VARIANTS = 500;
+/** 추가 선택 옵션명 최대 개수 */
+export declare const MAX_ADDON_GROUPS = 5;
+/** 직접 입력 항목 최대 개수 */
+export declare const MAX_CUSTOM_INPUTS = 5;
+/** 직접 입력 항목 최대 글자 수의 상한 */
+export declare const MAX_CUSTOM_INPUT_LENGTH = 200;
+/** 조합 수가 이 값 이상이면 콘솔이 경고한다(상한은 `MAX_VARIANTS`) */
+export declare const VARIANT_COUNT_WARNING = 100;
+/**
+ * 옵션 값 정렬 순서 — 등록순·가나다순·낮은 추가금순·높은 추가금순. 서버가 저장할 때 이 순서로 값의 `sortOrder`를 매긴다.
+ * 추가금순은 추가 선택 값이면 값의 추가금, 조합 값이면 그 값이 든 조합 추가금의 최솟값으로 비교하고 같으면 등록순이다.
+ */
+export declare const optionSortSchema: z.ZodEnum<{
+  REGISTERED: "REGISTERED";
+  NAME: "NAME";
+  PRICE_ASC: "PRICE_ASC";
+  PRICE_DESC: "PRICE_DESC";
+}>;
+export type OptionSort = z.infer<typeof optionSortSchema>;
+/** 추가 선택 값 — 예: 옵션명 "선물 포장"의 값 "포장함"(+2,000원) */
+export declare const addonValueSchema: z.ZodObject<{
+  valueId: z.ZodString;
+  name: z.ZodString;
+  sortOrder: z.ZodNumber;
+  additionalPrice: z.ZodNumber;
+  usable: z.ZodBoolean;
+}, z.core.$strip>;
+export type AddonValue = z.infer<typeof addonValueSchema>;
+/** 추가 선택 옵션명 */
+export declare const addonGroupSchema: z.ZodObject<{
+  groupId: z.ZodString;
+  name: z.ZodString;
+  sortOrder: z.ZodNumber;
+  required: z.ZodBoolean;
+  values: z.ZodArray<z.ZodObject<{
+    valueId: z.ZodString;
+    name: z.ZodString;
+    sortOrder: z.ZodNumber;
+    additionalPrice: z.ZodNumber;
+    usable: z.ZodBoolean;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AddonGroup = z.infer<typeof addonGroupSchema>;
+/** 직접 입력 항목 — 예: 각인 문구 */
+export declare const customInputSchema: z.ZodObject<{
+  inputId: z.ZodString;
+  label: z.ZodString;
+  placeholder: z.ZodNullable<z.ZodString>;
+  maxLength: z.ZodNumber;
+  required: z.ZodBoolean;
+  usable: z.ZodBoolean;
+  sortOrder: z.ZodNumber;
+}, z.core.$strip>;
+export type CustomInput = z.infer<typeof customInputSchema>;
+/**
+ * 직접 입력 항목명에 쓸 수 없는 개인정보성 단어 — 콘솔 검사와 서버 400(`CUSTOM_INPUT_LABEL_FORBIDDEN`)이 이 목록 하나를 쓴다.
+ * 구매자 개인정보는 주문 정보로 받는다. 직접 입력 항목으로 받으면 보관·파기 규칙 밖에 남는다.
+ */
+export declare const CUSTOM_INPUT_FORBIDDEN_WORDS: readonly ["연락처", "전화", "휴대폰", "핸드폰", "폰번호", "메일", "주소", "주민", "생년월일", "생일", "실명", "계좌", "카드번호", "비밀번호", "여권", "통관", "phone", "mobile", "mail", "address"];
+/**
+ * 직접 입력 항목명·입력 안내에 든 개인정보성 금지어. 없으면 null. 공백·기호·대소문자·전각을 무시한다.
+ * 서버는 항목명과 입력 안내 둘 다 이 함수로 검사한다(안내에 「연락처를 적어 주십시오」라고 쓰는 우회를 막는다).
+ */
+export declare function customInputLabelForbiddenWord(label: string): string | null;
+export declare const addonValueRequestSchema: z.ZodObject<{
+  valueId: z.ZodOptional<z.ZodString>;
+  name: z.ZodString;
+  additionalPrice: z.ZodDefault<z.ZodNumber>;
+  usable: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AddonValueRequest = z.infer<typeof addonValueRequestSchema>;
+export declare const addonGroupRequestSchema: z.ZodObject<{
+  groupId: z.ZodOptional<z.ZodString>;
+  name: z.ZodString;
+  required: z.ZodDefault<z.ZodBoolean>;
+  values: z.ZodArray<z.ZodObject<{
+    valueId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    additionalPrice: z.ZodDefault<z.ZodNumber>;
+    usable: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AddonGroupRequest = z.infer<typeof addonGroupRequestSchema>;
+export declare const customInputRequestSchema: z.ZodObject<{
+  inputId: z.ZodOptional<z.ZodString>;
+  label: z.ZodString;
+  placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  maxLength: z.ZodNumber;
+  required: z.ZodDefault<z.ZodBoolean>;
+  usable: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CustomInputRequest = z.infer<typeof customInputRequestSchema>;
+/**
+ * 주문상품·장바구니·주문서 줄의 옵션 선택 스냅샷 한 칸 — 주문 시점 이름이다(상품을 고쳐도 바뀌지 않는다).
+ * 조합 옵션은 옵션명마다 한 칸이고 추가금은 조합 단위라 0이다(조합 추가금은 단가에 들어 있다). 추가 선택은 값의 추가금이다.
+ */
+export declare const optionSelectionSchema: z.ZodObject<{
+  kind: z.ZodString;
+  groupName: z.ZodString;
+  valueName: z.ZodString;
+  additionalPrice: z.ZodNumber;
+}, z.core.$strip>;
+export type OptionSelection = z.infer<typeof optionSelectionSchema>;
+/** 구매자가 적은 직접 입력값 — 주문 시점 항목명과 값 */
+export declare const customInputValueSchema: z.ZodObject<{
+  label: z.ZodString;
+  value: z.ZodString;
+}, z.core.$strip>;
+export type CustomInputValue = z.infer<typeof customInputValueSchema>;
 export declare const discountSchema: z.ZodObject<{
   productId: z.ZodString;
   discountType: z.ZodEnum<{
@@ -4911,7 +5057,36 @@ export declare const productSchema: z.ZodObject<{
     weightGram: z.ZodNullable<z.ZodNumber>;
     sellerCode: z.ZodNullable<z.ZodString>;
     usable: z.ZodBoolean;
+    hasOrders: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>;
+  addonGroups: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodString;
+    name: z.ZodString;
+    sortOrder: z.ZodNumber;
+    required: z.ZodBoolean;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodString;
+      name: z.ZodString;
+      sortOrder: z.ZodNumber;
+      additionalPrice: z.ZodNumber;
+      usable: z.ZodBoolean;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>>;
+  customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    inputId: z.ZodString;
+    label: z.ZodString;
+    placeholder: z.ZodNullable<z.ZodString>;
+    maxLength: z.ZodNumber;
+    required: z.ZodBoolean;
+    usable: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+  }, z.core.$strip>>>>;
+  optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>>;
   fulfillment: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
@@ -4982,12 +5157,6 @@ export interface ProductImageRejection {
  *   — 외부 이미지 CDN은 확장자 없는 키를 쓰는 경우가 흔하고, 주소만으로는 실제 형식을 알 수 없다.
  */
 export declare function productImageRejection(url: string): ProductImageRejection | null;
-/** 옵션 축(그룹) 최대 개수 — 스키마 상한의 단일 원천 */
-export declare const MAX_OPTION_GROUPS = 3;
-/** 축 하나가 가질 수 있는 값의 최대 개수 */
-export declare const MAX_VALUES_PER_GROUP = 100;
-/** 상품 하나가 가질 수 있는 variant(SKU) 최대 개수 */
-export declare const MAX_VARIANTS = 500;
 export declare const optionValueRequestSchema: z.ZodObject<{
   valueId: z.ZodOptional<z.ZodString>;
   name: z.ZodString;
@@ -5037,6 +5206,31 @@ export declare const optionModelRequestSchema: z.ZodObject<{
     sellerCode: z.ZodOptional<z.ZodString>;
     usable: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
+  addonGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodOptional<z.ZodString>;
+      name: z.ZodString;
+      additionalPrice: z.ZodDefault<z.ZodNumber>;
+      usable: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  customInputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    inputId: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxLength: z.ZodNumber;
+    required: z.ZodDefault<z.ZodBoolean>;
+    usable: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>>;
+  optionSort: z.ZodOptional<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>;
 }, z.core.$strip>;
 export type OptionModelRequest = z.infer<typeof optionModelRequestSchema>;
 /** GET /products/{productId}/options 응답 */
@@ -5063,7 +5257,36 @@ export declare const optionModelSchema: z.ZodObject<{
     weightGram: z.ZodNullable<z.ZodNumber>;
     sellerCode: z.ZodNullable<z.ZodString>;
     usable: z.ZodBoolean;
+    hasOrders: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>;
+  addonGroups: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodString;
+    name: z.ZodString;
+    sortOrder: z.ZodNumber;
+    required: z.ZodBoolean;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodString;
+      name: z.ZodString;
+      sortOrder: z.ZodNumber;
+      additionalPrice: z.ZodNumber;
+      usable: z.ZodBoolean;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>>;
+  customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    inputId: z.ZodString;
+    label: z.ZodString;
+    placeholder: z.ZodNullable<z.ZodString>;
+    maxLength: z.ZodNumber;
+    required: z.ZodBoolean;
+    usable: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+  }, z.core.$strip>>>>;
+  optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>>;
 }, z.core.$strip>;
 export type OptionModel = z.infer<typeof optionModelSchema>;
 /**
@@ -5103,6 +5326,7 @@ export declare const productCreateRequestSchema: z.ZodObject<{
   }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"MANUAL">;
   }, z.core.$strict>], "type">>;
+  sourceOptionSetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -5123,6 +5347,31 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     sellerCode: z.ZodOptional<z.ZodString>;
     usable: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
+  addonGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodOptional<z.ZodString>;
+      name: z.ZodString;
+      additionalPrice: z.ZodDefault<z.ZodNumber>;
+      usable: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  customInputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    inputId: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxLength: z.ZodNumber;
+    required: z.ZodDefault<z.ZodBoolean>;
+    usable: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>>;
+  optionSort: z.ZodOptional<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>;
   name: z.ZodString;
   categoryId: z.ZodString;
   salePrice: z.ZodNumber;
@@ -5162,6 +5411,7 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
   }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"MANUAL">;
   }, z.core.$strict>], "type">>;
+  sourceOptionSetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -5182,6 +5432,31 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
     sellerCode: z.ZodOptional<z.ZodString>;
     usable: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
+  addonGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodOptional<z.ZodString>;
+      name: z.ZodString;
+      additionalPrice: z.ZodDefault<z.ZodNumber>;
+      usable: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  customInputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    inputId: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxLength: z.ZodNumber;
+    required: z.ZodDefault<z.ZodBoolean>;
+    usable: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>>;
+  optionSort: z.ZodOptional<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>;
   name: z.ZodString;
   categoryId: z.ZodString;
   salePrice: z.ZodNumber;
@@ -5284,6 +5559,210 @@ export declare const discountRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type DiscountRequest = z.infer<typeof discountRequestSchema>;
 //#endregion
+//#region src/schemas/saved-option-set.d.ts
+/**
+ * 저장 옵션 (이슈 #59) — 자주 쓰는 옵션 구성을 이름 붙여 두고 상품 등록에서 불러온다.
+ *
+ * **불러오기는 복사다.** 저장 옵션을 고치거나 지워도 이미 불러온 상품의 옵션은 그대로다. 재고·SKU·사용 여부는 상품마다
+ * 달라 저장하지 않는다. 추가금은 조합별이 아니라 **값별**로 둔다 — 조합 옵션으로 불러오면 조합 추가금은 고른 값 추가금의 합이다.
+ */
+/** 스토어당 저장 옵션 최대 개수 */
+export declare const MAX_SAVED_OPTION_SETS = 200;
+/** 저장 옵션 이름 최대 글자 수 */
+export declare const MAX_SAVED_OPTION_SET_NAME = 50;
+/** 옵션명 방식 — `combination`(조합: 값의 조합이 판매 단위가 된다)·`addon`(추가 선택: 재고 없이 추가금만) */
+export declare const optionGroupKindSchema: z.ZodEnum<{
+  combination: "combination";
+  addon: "addon";
+}>;
+export type OptionGroupKind = z.infer<typeof optionGroupKindSchema>;
+export declare const savedOptionValueSchema: z.ZodObject<{
+  name: z.ZodString;
+  additionalPrice: z.ZodNumber;
+}, z.core.$strip>;
+export declare const savedOptionGroupSchema: z.ZodObject<{
+  name: z.ZodString;
+  kind: z.ZodString;
+  required: z.ZodBoolean;
+  values: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    additionalPrice: z.ZodNumber;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SavedOptionGroup = z.infer<typeof savedOptionGroupSchema>;
+export declare const savedCustomInputSchema: z.ZodObject<{
+  label: z.ZodString;
+  placeholder: z.ZodNullable<z.ZodString>;
+  maxLength: z.ZodNumber;
+  required: z.ZodBoolean;
+}, z.core.$strip>;
+export type SavedCustomInput = z.infer<typeof savedCustomInputSchema>;
+export declare const savedOptionSetSchema: z.ZodObject<{
+  optionSetId: z.ZodString;
+  name: z.ZodString;
+  optionSort: z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>;
+  groups: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodString;
+    required: z.ZodBoolean;
+    values: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      additionalPrice: z.ZodNumber;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  customInputs: z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    placeholder: z.ZodNullable<z.ZodString>;
+    maxLength: z.ZodNumber;
+    required: z.ZodBoolean;
+  }, z.core.$strip>>;
+  importedProductCount: z.ZodNumber;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type SavedOptionSet = z.infer<typeof savedOptionSetSchema>;
+export declare const savedOptionValueRequestSchema: z.ZodObject<{
+  name: z.ZodString;
+  additionalPrice: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const savedOptionGroupRequestSchema: z.ZodObject<{
+  name: z.ZodString;
+  kind: z.ZodEnum<{
+    combination: "combination";
+    addon: "addon";
+  }>;
+  required: z.ZodDefault<z.ZodBoolean>;
+  values: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    additionalPrice: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SavedOptionGroupRequest = z.infer<typeof savedOptionGroupRequestSchema>;
+export declare const savedCustomInputRequestSchema: z.ZodObject<{
+  label: z.ZodString;
+  placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  maxLength: z.ZodNumber;
+  required: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * 저장 옵션 만들기·수정 본문. 조합 옵션명은 최대 `MAX_OPTION_GROUPS`개, 추가 선택은 최대 `MAX_ADDON_GROUPS`개이고
+ * 옵션명과 직접 입력 항목이 모두 비면 400이다. 수정(PUT)은 통째로 바꾼다.
+ */
+export declare const savedOptionSetRequestSchema: z.ZodObject<{
+  name: z.ZodString;
+  optionSort: z.ZodDefault<z.ZodEnum<{
+    REGISTERED: "REGISTERED";
+    NAME: "NAME";
+    PRICE_ASC: "PRICE_ASC";
+    PRICE_DESC: "PRICE_DESC";
+  }>>;
+  groups: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodEnum<{
+      combination: "combination";
+      addon: "addon";
+    }>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    values: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      additionalPrice: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  customInputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxLength: z.ZodNumber;
+    required: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type SavedOptionSetRequest = z.infer<typeof savedOptionSetRequestSchema>;
+export type SavedOptionSetRequestInput = z.input<typeof savedOptionSetRequestSchema>;
+/**
+ * 상품에서 저장 (`POST /v1/saved-option-sets/from-product`) — 상품의 현재 옵션을 저장 옵션으로 만든다.
+ *
+ * 조합 추가금이 값별 추가금의 합으로 되돌려지면 값별로 저장하고, 조합마다 제각각이면 추가금을 빼고
+ * 응답 `additionalPriceDropped: true`로 알린다. `replaceOptionSetId`를 주면 그 저장 옵션을 덮어쓴다(이름 중복의 덮어쓰기).
+ */
+export declare const savedOptionSetFromProductRequestSchema: z.ZodObject<{
+  productId: z.ZodString;
+  name: z.ZodString;
+  includeOptions: z.ZodDefault<z.ZodBoolean>;
+  includeCustomInputs: z.ZodDefault<z.ZodBoolean>;
+  replaceOptionSetId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SavedOptionSetFromProductRequest = z.infer<typeof savedOptionSetFromProductRequestSchema>;
+export type SavedOptionSetFromProductRequestInput = z.input<typeof savedOptionSetFromProductRequestSchema>;
+export declare const savedOptionSetFromProductResultSchema: z.ZodObject<{
+  optionSet: z.ZodObject<{
+    optionSetId: z.ZodString;
+    name: z.ZodString;
+    optionSort: z.ZodEnum<{
+      REGISTERED: "REGISTERED";
+      NAME: "NAME";
+      PRICE_ASC: "PRICE_ASC";
+      PRICE_DESC: "PRICE_DESC";
+    }>;
+    groups: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      kind: z.ZodString;
+      required: z.ZodBoolean;
+      values: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        additionalPrice: z.ZodNumber;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    customInputs: z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      placeholder: z.ZodNullable<z.ZodString>;
+      maxLength: z.ZodNumber;
+      required: z.ZodBoolean;
+    }, z.core.$strip>>;
+    importedProductCount: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+  }, z.core.$strip>;
+  additionalPriceDropped: z.ZodBoolean;
+}, z.core.$strip>;
+export type SavedOptionSetFromProductResult = z.infer<typeof savedOptionSetFromProductResultSchema>;
+/** 구성 필터 — 조합 옵션명·추가 선택 옵션명·직접 입력 항목을 가진 저장 옵션 */
+export declare const savedOptionSetCompositionSchema: z.ZodEnum<{
+  combination: "combination";
+  addon: "addon";
+  customInput: "customInput";
+}>;
+export declare const savedOptionSetSortSchema: z.ZodEnum<{
+  "updatedAt.desc": "updatedAt.desc";
+  "name.asc": "name.asc";
+  "importedProductCount.desc": "importedProductCount.desc";
+}>;
+export type SavedOptionSetSort = z.infer<typeof savedOptionSetSortSchema>;
+export interface SavedOptionSetListParams extends PageParams {
+  keyword?: string;
+  composition?: z.infer<typeof savedOptionSetCompositionSchema>;
+  sort?: SavedOptionSetSort;
+}
+/** `GET /v1/saved-option-sets` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
+export declare const savedOptionSetListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  keyword: z.ZodOptional<z.ZodString>;
+  composition: z.ZodOptional<z.ZodEnum<{
+    combination: "combination";
+    addon: "addon";
+    customInput: "customInput";
+  }>>;
+  sort: z.ZodOptional<z.ZodEnum<{
+    "updatedAt.desc": "updatedAt.desc";
+    "name.asc": "name.asc";
+    "importedProductCount.desc": "importedProductCount.desc";
+  }>>;
+}, z.core.$strip>;
+//#endregion
 //#region src/schemas/store.d.ts
 /**
  * 스토어 코드 규칙 — 스토어프론트 API가 테넌트를 가르는 값이다(`X-Store-Code` 헤더).
@@ -5540,6 +6019,7 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
  * - 409 `STOREFRONT_SITE_CREATE_LIMIT` — 사이트는 스토어당 30일에 3번까지 만든다
  * - 409 `STOREFRONT_SITE_CHANGED` — 읽은 상태(`expected*`)와 현재 상태가 다르다. 다시 읽고 시도한다
  * - 409 `STOREFRONT_SITE_NOT_ACTIVE` — 정지(`SUSPENDED`)된 사이트는 바꾸거나 끌 수 없다
+ * - 409 `STORE_SUSPENDED` — 정지된 스토어에는 사이트를 만들 수 없다
  * - 409 `STOREFRONT_VERSION_NOT_READY` — 빌드가 끝나지 않았거나 실패한 버전은 발행할 수 없다
  * - 409 `STOREFRONT_NO_ROLLBACK_TARGET` — 되돌릴 이전 발행 버전이 없다
  * - 400 `STOREFRONT_SLUG_CONFIRM_MISMATCH` — 호스팅 끄기 확인 입력이 현재 슬러그와 다르다
@@ -5685,6 +6165,15 @@ export declare const storefrontEditPreviewSchema: z.ZodObject<{
   hostname: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type StorefrontEditPreview = z.infer<typeof storefrontEditPreviewSchema>;
+/**
+ * 사이트 정지 — 운영 정책에 따라 플랫폼 운영자가 사이트를 정지한다. 정지 중에는 방문자에게 정지 안내가 보이고 발행·되돌리기·템플릿 변경·
+ * 공개 전환·슬러그 변경·끄기·편집이 409 `STOREFRONT_SITE_NOT_ACTIVE`다. 셀러가 풀 수 없다(고객센터로 문의한다).
+ */
+export declare const storefrontSuspensionSchema: z.ZodObject<{
+  reason: z.ZodNullable<z.ZodString>;
+  suspendedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontSuspension = z.infer<typeof storefrontSuspensionSchema>;
 export declare const storefrontSiteSchema: z.ZodObject<{
   siteId: z.ZodString;
   slug: z.ZodString;
@@ -5751,6 +6240,10 @@ export declare const storefrontSiteSchema: z.ZodObject<{
     hostname: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
   slugChangesRemaining: z.ZodNumber;
+  suspension: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    reason: z.ZodNullable<z.ZodString>;
+    suspendedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>>;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
 }, z.core.$strip>;
@@ -5826,6 +6319,10 @@ export declare const storefrontHostingSchema: z.ZodObject<{
       hostname: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
     slugChangesRemaining: z.ZodNumber;
+    suspension: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      reason: z.ZodNullable<z.ZodString>;
+      suspendedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
@@ -6817,7 +7314,31 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        hasOrders?: boolean | undefined;
       }[];
+      addonGroups: {
+        groupId: string;
+        name: string;
+        sortOrder: number;
+        required: boolean;
+        values: {
+          valueId: string;
+          name: string;
+          sortOrder: number;
+          additionalPrice: number;
+          usable: boolean;
+        }[];
+      }[];
+      customInputs: {
+        inputId: string;
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+        usable: boolean;
+        sortOrder: number;
+      }[];
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
@@ -6889,7 +7410,31 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        hasOrders?: boolean | undefined;
       }[];
+      addonGroups: {
+        groupId: string;
+        name: string;
+        sortOrder: number;
+        required: boolean;
+        values: {
+          valueId: string;
+          name: string;
+          sortOrder: number;
+          additionalPrice: number;
+          usable: boolean;
+        }[];
+      }[];
+      customInputs: {
+        inputId: string;
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+        usable: boolean;
+        sortOrder: number;
+      }[];
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
@@ -6961,7 +7506,31 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        hasOrders?: boolean | undefined;
+      }[];
+      addonGroups: {
+        groupId: string;
+        name: string;
+        sortOrder: number;
+        required: boolean;
+        values: {
+          valueId: string;
+          name: string;
+          sortOrder: number;
+          additionalPrice: number;
+          usable: boolean;
+        }[];
+      }[];
+      customInputs: {
+        inputId: string;
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+        usable: boolean;
+        sortOrder: number;
       }[];
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
@@ -7037,7 +7606,31 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        hasOrders?: boolean | undefined;
       }[];
+      addonGroups: {
+        groupId: string;
+        name: string;
+        sortOrder: number;
+        required: boolean;
+        values: {
+          valueId: string;
+          name: string;
+          sortOrder: number;
+          additionalPrice: number;
+          usable: boolean;
+        }[];
+      }[];
+      customInputs: {
+        inputId: string;
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+        usable: boolean;
+        sortOrder: number;
+      }[];
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
     }>;
     /**
      * 옵션 모델 전체 교체 — variants는 valueNames로 축 값을 지목한다.
@@ -7066,7 +7659,31 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        hasOrders?: boolean | undefined;
       }[];
+      addonGroups: {
+        groupId: string;
+        name: string;
+        sortOrder: number;
+        required: boolean;
+        values: {
+          valueId: string;
+          name: string;
+          sortOrder: number;
+          additionalPrice: number;
+          usable: boolean;
+        }[];
+      }[];
+      customInputs: {
+        inputId: string;
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+        usable: boolean;
+        sortOrder: number;
+      }[];
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
     }>;
     /** 재고 변경 — stockQuantity(절대값) 또는 adjustment(증감) 하나만 전달한다 */
     updateVariantStock: (productId: string, variantId: string, body: VariantStockRequest) => Promise<{
@@ -7091,6 +7708,140 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     removeDiscount: (productId: string) => Promise<void>;
   };
+  /**
+   * 저장 옵션 (이슈 #59) — 자주 쓰는 옵션 구성. 불러오기는 복사라 저장 옵션을 고쳐도 불러온 상품은 바뀌지 않는다.
+   * 권한은 상품과 같다(`product:r`·`product:rw`).
+   */
+  savedOptionSets: {
+    list: (params?: SavedOptionSetListParams) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        optionSetId: string;
+        name: string;
+        optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+        groups: {
+          name: string;
+          kind: string;
+          required: boolean;
+          values: {
+            name: string;
+            additionalPrice: number;
+          }[];
+        }[];
+        customInputs: {
+          label: string;
+          placeholder: string | null;
+          maxLength: number;
+          required: boolean;
+        }[];
+        importedProductCount: number;
+        createdAt: string;
+        updatedAt: string;
+      }[];
+    }>;
+    get: (optionSetId: string) => Promise<{
+      optionSetId: string;
+      name: string;
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      groups: {
+        name: string;
+        kind: string;
+        required: boolean;
+        values: {
+          name: string;
+          additionalPrice: number;
+        }[];
+      }[];
+      customInputs: {
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+      }[];
+      importedProductCount: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** 이름이 겹치면 409 `OPTION_SET_NAME_TAKEN`, 스토어당 200개를 넘으면 409 `OPTION_SET_LIMIT_EXCEEDED` */
+    create: (body: SavedOptionSetRequestInput) => Promise<{
+      optionSetId: string;
+      name: string;
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      groups: {
+        name: string;
+        kind: string;
+        required: boolean;
+        values: {
+          name: string;
+          additionalPrice: number;
+        }[];
+      }[];
+      customInputs: {
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+      }[];
+      importedProductCount: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** 통째로 바꾼다. 불러온 상품은 바뀌지 않는다 */
+    update: (optionSetId: string, body: SavedOptionSetRequestInput) => Promise<{
+      optionSetId: string;
+      name: string;
+      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      groups: {
+        name: string;
+        kind: string;
+        required: boolean;
+        values: {
+          name: string;
+          additionalPrice: number;
+        }[];
+      }[];
+      customInputs: {
+        label: string;
+        placeholder: string | null;
+        maxLength: number;
+        required: boolean;
+      }[];
+      importedProductCount: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    remove: (optionSetId: string) => Promise<void>;
+    /** 상품의 현재 옵션을 저장 옵션으로 만든다(또는 `replaceOptionSetId`를 덮어쓴다) */
+    saveFromProduct: (body: SavedOptionSetFromProductRequestInput) => Promise<{
+      optionSet: {
+        optionSetId: string;
+        name: string;
+        optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+        groups: {
+          name: string;
+          kind: string;
+          required: boolean;
+          values: {
+            name: string;
+            additionalPrice: number;
+          }[];
+        }[];
+        customInputs: {
+          label: string;
+          placeholder: string | null;
+          maxLength: number;
+          required: boolean;
+        }[];
+        importedProductCount: number;
+        createdAt: string;
+        updatedAt: string;
+      };
+      additionalPriceDropped: boolean;
+    }>;
+  };
   categories: {
     list: (params?: {
       parentId?: string;
@@ -7107,7 +7858,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -7127,7 +7878,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -7146,7 +7897,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         visible: boolean;
         showPc: boolean;
         showMobile: boolean;
-        productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+        productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
         metaTitle: string | null;
         metaDescription: string | null;
         metaKeywords: string | null;
@@ -7166,7 +7917,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -7185,7 +7936,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         visible: boolean;
         showPc: boolean;
         showMobile: boolean;
-        productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+        productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
         metaTitle: string | null;
         metaDescription: string | null;
         metaKeywords: string | null;
@@ -7214,7 +7965,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -7233,7 +7984,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
+      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -7330,6 +8081,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
         productName: string;
         optionId: string | null;
         optionName: string | null;
+        optionSelections: {
+          kind: string;
+          groupName: string;
+          valueName: string;
+          additionalPrice: number;
+        }[];
+        customInputs: {
+          label: string;
+          value: string;
+        }[];
         sellerCode: string | null;
         fulfillmentSnapshot: UnknownFulfillment | {
           type: "SHIPPING";
@@ -7405,6 +8166,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
         productName: string;
         optionId: string | null;
         optionName: string | null;
+        optionSelections: {
+          kind: string;
+          groupName: string;
+          valueName: string;
+          additionalPrice: number;
+        }[];
+        customInputs: {
+          label: string;
+          value: string;
+        }[];
         sellerCode: string | null;
         fulfillmentSnapshot: UnknownFulfillment | {
           type: "SHIPPING";
@@ -7508,6 +8279,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
       productName: string;
       optionId: string | null;
       optionName: string | null;
+      optionSelections: {
+        kind: string;
+        groupName: string;
+        valueName: string;
+        additionalPrice: number;
+      }[];
+      customInputs: {
+        label: string;
+        value: string;
+      }[];
       sellerCode: string | null;
       fulfillmentSnapshot: UnknownFulfillment | {
         type: "SHIPPING";
@@ -7566,6 +8347,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
       productName: string;
       optionId: string | null;
       optionName: string | null;
+      optionSelections: {
+        kind: string;
+        groupName: string;
+        valueName: string;
+        additionalPrice: number;
+      }[];
+      customInputs: {
+        label: string;
+        value: string;
+      }[];
       sellerCode: string | null;
       fulfillmentSnapshot: UnknownFulfillment | {
         type: "SHIPPING";
@@ -10169,6 +10960,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
         slugChangesRemaining: number;
         createdAt: string;
         updatedAt: string;
+        suspension?: {
+          reason: string | null;
+          suspendedAt: string | null;
+        } | null | undefined;
       } | null;
     }>;
     /** `GET /v1/storefront/slug-availability?slug=` — 슬러그를 쓸 수 있는가 */
@@ -10219,6 +11014,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /** `POST /v1/storefront/site/template` — 템플릿을 바꾼다. 새 버전을 만들고 기본으로 곧바로 발행한다 */
     changeTemplate: (body: ChangeStorefrontTemplateRequest) => Promise<{
@@ -10262,6 +11061,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /** `GET /v1/storefront/site/versions` — 버전 목록(최신 먼저) */
     listVersions: () => Promise<{
@@ -10320,6 +11123,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /** `POST /v1/storefront/site/rollback` — 이전 발행 버전으로 되돌린다(재빌드 없음) */
     rollback: (body?: RollbackStorefrontRequest) => Promise<{
@@ -10363,6 +11170,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /** `PUT /v1/storefront/site/slug` — 슬러그를 바꾼다. 옛 슬러그는 90일 보류되고 새 주소로 301한다 */
     changeSlug: (body: ChangeStorefrontSlugRequest) => Promise<{
@@ -10406,6 +11217,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /** `PUT /v1/storefront/site/visibility` — 오픈 준비 중 ↔ 공개 */
     setVisibility: (body: SetStorefrontVisibilityRequest) => Promise<{
@@ -10449,6 +11264,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /**
      * `POST /v1/storefront/site/preview-link` — 오픈 준비 중인 사이트를 구성원이 볼 수 있는 5분짜리 링크.
@@ -10500,6 +11319,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
     }>;
     /** `GET /v1/storefront/site/editing` — 편집 환경 상태(열린 환경·동시 상한·미리보기 인증서) */
     getEditing: () => Promise<{
@@ -11172,6 +11995,7 @@ export declare const couponRejectReasonSchema: z.ZodEnum<{
   NO_ELIGIBLE_ITEMS: "NO_ELIGIBLE_ITEMS";
   MIN_ORDER_AMOUNT: "MIN_ORDER_AMOUNT";
   LINE_NOT_ELIGIBLE: "LINE_NOT_ELIGIBLE";
+  LINE_AMBIGUOUS: "LINE_AMBIGUOUS";
   NO_DISCOUNT: "NO_DISCOUNT";
 }>;
 export type CouponRejectReason = z.infer<typeof couponRejectReasonSchema>;
@@ -11841,6 +12665,19 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
     [x: string]: unknown;
     type: string;
   }>>]>>;
+  itemOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    orderItemId: z.ZodString;
+    optionSelections: z.ZodArray<z.ZodObject<{
+      kind: z.ZodString;
+      groupName: z.ZodString;
+      valueName: z.ZodString;
+      additionalPrice: z.ZodNumber;
+    }, z.core.$strip>>;
+    customInputs: z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodString;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type OrderWebhookEventData = z.infer<typeof orderWebhookEventDataSchema>;
 /**
@@ -12004,6 +12841,19 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
       [x: string]: unknown;
       type: string;
     }>>]>>;
+    itemOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      orderItemId: z.ZodString;
+      optionSelections: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        groupName: z.ZodString;
+        valueName: z.ZodString;
+        additionalPrice: z.ZodNumber;
+      }, z.core.$strip>>;
+      customInputs: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
@@ -12204,6 +13054,19 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       [x: string]: unknown;
       type: string;
     }>>]>>;
+    itemOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      orderItemId: z.ZodString;
+      optionSelections: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        groupName: z.ZodString;
+        valueName: z.ZodString;
+        additionalPrice: z.ZodNumber;
+      }, z.core.$strip>>;
+      customInputs: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;