@sayren/store-sdk 0.19.0 → 0.21.0

package/src/schemas/product.ts

@@ -76,10 +76,188 @@ export const productVariantSchema = z.object({
   weightGram: z.number().int().nullable(),
   sellerCode: z.string().nullable(),
   usable: z.boolean(),
+  hasOrders: z
+    .boolean()
+    .optional()
+    .describe(
+      "주문에 담긴 적이 있는 조합인가(이슈 #59). true인 조합은 옵션 교체에서 뺄 수 없고(409 `OPTION_HAS_ORDERS`) `usable: false`로 판매를 끈다. 서버는 항상 싣는다. 요청에는 쓰지 않는다",
+    ),
 });
 
 export type ProductVariant = z.infer<typeof productVariantSchema>;
 
+/** 옵션 축(그룹) 최대 개수 — 스키마 상한의 단일 원천 */
+export const MAX_OPTION_GROUPS = 3;
+/** 축 하나가 가질 수 있는 값의 최대 개수 */
+export const MAX_VALUES_PER_GROUP = 100;
+/** 상품 하나가 가질 수 있는 variant(SKU) 최대 개수 */
+export const MAX_VARIANTS = 500;
+
+// ─── 추가 선택 옵션·직접 입력 항목 (이슈 #59) ─────────────────────
+//
+// 옵션명은 두 방식이다. **조합**(`optionGroups`)은 값의 조합이 판매 단위(variant)가 되고 재고·SKU·추가금이 조합에 붙는다.
+// **추가 선택**(`addonGroups`)은 재고가 없고 값마다 추가금만 있다 — 구매자가 조합(옵션이 없으면 기본 판매 단위)을 고른 뒤
+// 옵션명마다 값 하나를 더 고르고, 재고는 고른 조합에서 빠진다. 직접 입력 항목(`customInputs`)은 구매자가 글자를 적는 칸이다.
+
+/** 추가 선택 옵션명 최대 개수 */
+export const MAX_ADDON_GROUPS = 5;
+/** 직접 입력 항목 최대 개수 */
+export const MAX_CUSTOM_INPUTS = 5;
+/** 직접 입력 항목 최대 글자 수의 상한 */
+export const MAX_CUSTOM_INPUT_LENGTH = 200;
+/** 조합 수가 이 값 이상이면 콘솔이 경고한다(상한은 `MAX_VARIANTS`) */
+export const VARIANT_COUNT_WARNING = 100;
+
+/**
+ * 옵션 값 정렬 순서 — 등록순·가나다순·낮은 추가금순·높은 추가금순. 서버가 저장할 때 이 순서로 값의 `sortOrder`를 매긴다.
+ * 추가금순은 추가 선택 값이면 값의 추가금, 조합 값이면 그 값이 든 조합 추가금의 최솟값으로 비교하고 같으면 등록순이다.
+ */
+export const optionSortSchema = z.enum(["REGISTERED", "NAME", "PRICE_ASC", "PRICE_DESC"]);
+
+export type OptionSort = z.infer<typeof optionSortSchema>;
+
+/** 추가 선택 값 — 예: 옵션명 "선물 포장"의 값 "포장함"(+2,000원) */
+export const addonValueSchema = z.object({
+  valueId: z.string(),
+  name: z.string(),
+  sortOrder: z.number().int(),
+  additionalPrice: z.number().int().describe("이 값을 고르면 단가에 더하는 금액(원, 0 이상)"),
+  usable: z.boolean().describe("사용 여부. false면 구매자에게 보이지 않고 고를 수 없다"),
+});
+
+export type AddonValue = z.infer<typeof addonValueSchema>;
+
+/** 추가 선택 옵션명 */
+export const addonGroupSchema = z.object({
+  groupId: z.string(),
+  name: z.string(),
+  sortOrder: z.number().int(),
+  required: z.boolean().describe("구매자가 꼭 골라야 하는가. false면 고르지 않아도 된다"),
+  values: z.array(addonValueSchema),
+});
+
+export type AddonGroup = z.infer<typeof addonGroupSchema>;
+
+/** 직접 입력 항목 — 예: 각인 문구 */
+export const customInputSchema = z.object({
+  inputId: z.string(),
+  label: z.string().describe("항목명"),
+  placeholder: z.string().nullable().describe("입력 안내(구매자 입력 칸의 안내 문구). 없으면 null"),
+  maxLength: z.number().int().describe("최대 글자 수"),
+  required: z.boolean(),
+  usable: z.boolean().describe("사용 여부. false면 구매자에게 보이지 않는다"),
+  sortOrder: z.number().int(),
+});
+
+export type CustomInput = z.infer<typeof customInputSchema>;
+
+/**
+ * 직접 입력 항목명에 쓸 수 없는 개인정보성 단어 — 콘솔 검사와 서버 400(`CUSTOM_INPUT_LABEL_FORBIDDEN`)이 이 목록 하나를 쓴다.
+ * 구매자 개인정보는 주문 정보로 받는다. 직접 입력 항목으로 받으면 보관·파기 규칙 밖에 남는다.
+ */
+export const CUSTOM_INPUT_FORBIDDEN_WORDS = [
+  "연락처",
+  "전화",
+  "휴대폰",
+  "핸드폰",
+  "폰번호",
+  "메일",
+  "주소",
+  "주민",
+  "생년월일",
+  "생일",
+  "실명",
+  "계좌",
+  "카드번호",
+  "비밀번호",
+  "여권",
+  "통관",
+  "phone",
+  "mobile",
+  "mail",
+  "address",
+] as const;
+
+/** 금지어 비교용 정규화 — NFKC(전각·호환 문자를 보통 문자로)·소문자 뒤 문자·숫자만 남긴다(공백·기호·제로폭 문자로 쪼갠 우회를 막는다) */
+function forbiddenWordKeyOf(text: string): string {
+  return text
+    .normalize("NFKC")
+    .toLowerCase()
+    .replace(/[^\p{L}\p{N}]/gu, "");
+}
+
+/**
+ * 직접 입력 항목명·입력 안내에 든 개인정보성 금지어. 없으면 null. 공백·기호·대소문자·전각을 무시한다.
+ * 서버는 항목명과 입력 안내 둘 다 이 함수로 검사한다(안내에 「연락처를 적어 주십시오」라고 쓰는 우회를 막는다).
+ */
+export function customInputLabelForbiddenWord(label: string): string | null {
+  const normalized = forbiddenWordKeyOf(label);
+  return (
+    CUSTOM_INPUT_FORBIDDEN_WORDS.find((word) => normalized.includes(forbiddenWordKeyOf(word))) ??
+    null
+  );
+}
+
+/** 옵션명·값 이름 — 앞뒤 공백을 지우고 빈 값은 받지 않는다 */
+const optionNameSchema = z.string().trim().min(1).max(50);
+
+export const addonValueRequestSchema = z.object({
+  /** 전달 시 기존 값 행을 유지(UPDATE). 생략하면 신규 발급 */
+  valueId: z.string().optional(),
+  name: optionNameSchema,
+  additionalPrice: z.number().int().min(0).default(0).describe("추가금(원, 0 이상)"),
+  usable: z.boolean().default(true),
+});
+
+export type AddonValueRequest = z.infer<typeof addonValueRequestSchema>;
+
+export const addonGroupRequestSchema = z.object({
+  /** 전달 시 기존 옵션명 행을 유지(UPDATE). 조합 옵션명의 id는 줄 수 없다(방식을 바꾸려면 새 옵션명으로 보낸다) */
+  groupId: z.string().optional(),
+  name: optionNameSchema,
+  required: z.boolean().default(false),
+  values: z.array(addonValueRequestSchema).min(1).max(MAX_VALUES_PER_GROUP),
+});
+
+export type AddonGroupRequest = z.infer<typeof addonGroupRequestSchema>;
+
+export const customInputRequestSchema = z.object({
+  /** 전달 시 기존 항목 행을 유지(UPDATE). 생략하면 신규 발급 */
+  inputId: z.string().optional(),
+  label: z.string().trim().min(1).max(30),
+  placeholder: z.string().trim().max(100).nullish(),
+  maxLength: z.number().int().min(1).max(MAX_CUSTOM_INPUT_LENGTH),
+  required: z.boolean().default(false),
+  usable: z.boolean().default(true),
+});
+
+export type CustomInputRequest = z.infer<typeof customInputRequestSchema>;
+
+/**
+ * 주문상품·장바구니·주문서 줄의 옵션 선택 스냅샷 한 칸 — 주문 시점 이름이다(상품을 고쳐도 바뀌지 않는다).
+ * 조합 옵션은 옵션명마다 한 칸이고 추가금은 조합 단위라 0이다(조합 추가금은 단가에 들어 있다). 추가 선택은 값의 추가금이다.
+ */
+export const optionSelectionSchema = z.object({
+  kind: z
+    .string()
+    .describe(
+      "옵션명 방식. 현재 값은 `combination`·`addon`이고 값이 추가될 수 있어 문자열로 받는다",
+    ),
+  groupName: z.string(),
+  valueName: z.string(),
+  additionalPrice: z.number().int(),
+});
+
+export type OptionSelection = z.infer<typeof optionSelectionSchema>;
+
+/** 구매자가 적은 직접 입력값 — 주문 시점 항목명과 값 */
+export const customInputValueSchema = z.object({
+  label: z.string(),
+  value: z.string(),
+});
+
+export type CustomInputValue = z.infer<typeof customInputValueSchema>;
+
 export const discountSchema = z.object({
   productId: z.string(),
   discountType: z.enum(["RATE", "AMOUNT"]),
@@ -104,6 +282,22 @@ export const productSchema = productSummarySchema.extend({
   optionGroups: z.array(optionGroupSchema),
   /** 모든 상품이 최소 1개 variant를 갖는다 (옵션 없으면 default variant 1개) */
   variants: z.array(productVariantSchema),
+  addonGroups: z
+    .array(addonGroupSchema)
+    .optional()
+    .default([])
+    .describe("추가 선택 옵션명(이슈 #59). 없으면 빈 배열. 서버는 항상 싣는다"),
+  customInputs: z
+    .array(customInputSchema)
+    .optional()
+    .default([])
+    .describe(
+      "직접 입력 항목(이슈 #59). 사용하지 않는 항목도 싣는다. 없으면 빈 배열. 서버는 항상 싣는다",
+    ),
+  optionSort: optionSortSchema
+    .optional()
+    .default("REGISTERED")
+    .describe("옵션 값 정렬 순서(이슈 #59). 서버는 항상 싣는다"),
   fulfillment: productFulfillmentResponseSchema,
   fulfillmentTypeLocked: z
     .boolean()
@@ -187,13 +381,6 @@ export function productImageRejection(url: string): ProductImageRejection | null
   return null;
 }
 
-/** 옵션 축(그룹) 최대 개수 — 스키마 상한의 단일 원천 */
-export const MAX_OPTION_GROUPS = 3;
-/** 축 하나가 가질 수 있는 값의 최대 개수 */
-export const MAX_VALUES_PER_GROUP = 100;
-/** 상품 하나가 가질 수 있는 variant(SKU) 최대 개수 */
-export const MAX_VARIANTS = 500;
-
 /**
  * 식별 코드 — 빈 문자열·공백만 있는 값은 거부한다.
  * `""`를 통과시키면 서버 중복 사전 검사(falsy skip)와 DB partial unique
@@ -244,6 +431,25 @@ export type ProductVariantRequest = z.infer<typeof productVariantRequestSchema>;
 export const optionModelRequestSchema = z.object({
   optionGroups: z.array(optionGroupRequestSchema).max(MAX_OPTION_GROUPS).default([]),
   variants: z.array(productVariantRequestSchema).min(1).max(MAX_VARIANTS),
+  addonGroups: z
+    .array(addonGroupRequestSchema)
+    .max(MAX_ADDON_GROUPS)
+    .optional()
+    .describe(
+      "추가 선택 옵션명 전체(이슈 #59). 주면 통째로 바꾸고, 생략하면 등록은 없음·수정은 현재 값을 그대로 둔다. 끄려면 빈 배열을 보낸다. 기능이 열리기 전에는 비어 있지 않은 값이 409 `OPTION_ADDONS_UNAVAILABLE`이다",
+    ),
+  customInputs: z
+    .array(customInputRequestSchema)
+    .max(MAX_CUSTOM_INPUTS)
+    .optional()
+    .describe(
+      "직접 입력 항목 전체(이슈 #59). 배열 순서가 표시 순서다. 주면 통째로 바꾸고, 생략하면 등록은 없음·수정은 현재 값을 그대로 둔다. 항목명에 개인정보성 단어(`CUSTOM_INPUT_FORBIDDEN_WORDS`)가 있으면 400 `CUSTOM_INPUT_LABEL_FORBIDDEN`, 기능이 열리기 전에는 비어 있지 않은 값이 409 `OPTION_ADDONS_UNAVAILABLE`이다",
+    ),
+  optionSort: optionSortSchema
+    .optional()
+    .describe(
+      "옵션 값 정렬 순서(이슈 #59). 서버가 이 순서로 값의 `sortOrder`를 다시 매긴다. 생략하면 등록은 `REGISTERED`, 수정은 현재 값이다",
+    ),
 });
 
 export type OptionModelRequest = z.infer<typeof optionModelRequestSchema>;
@@ -252,6 +458,20 @@ export type OptionModelRequest = z.infer<typeof optionModelRequestSchema>;
 export const optionModelSchema = z.object({
   optionGroups: z.array(optionGroupSchema),
   variants: z.array(productVariantSchema),
+  addonGroups: z
+    .array(addonGroupSchema)
+    .optional()
+    .default([])
+    .describe("추가 선택 옵션명(이슈 #59). 없으면 빈 배열. 서버는 항상 싣는다"),
+  customInputs: z
+    .array(customInputSchema)
+    .optional()
+    .default([])
+    .describe("직접 입력 항목(이슈 #59). 없으면 빈 배열. 서버는 항상 싣는다"),
+  optionSort: optionSortSchema
+    .optional()
+    .default("REGISTERED")
+    .describe("옵션 값 정렬 순서(이슈 #59). 서버는 항상 싣는다"),
 });
 
 export type OptionModel = z.infer<typeof optionModelSchema>;
@@ -322,6 +542,13 @@ const productWriteShape = {
         "반품·교환 배송비(`returnDeliveryFee`·`exchangeDeliveryFee`)는 배송 상품에만 줄 수 있다(다른 유형은 400)",
     ),
   ...optionModelRequestSchema.shape,
+  sourceOptionSetIds: z
+    .array(z.string())
+    .max(10)
+    .optional()
+    .describe(
+      "쓰기 전용(이슈 #59) — 이 저장으로 옵션을 불러온 저장 옵션 id. 상품 저장과 같은 트랜잭션에서 불러오기 기록을 남겨 저장 옵션의 `importedProductCount`를 센다. 없는 id는 무시한다",
+    ),
 };
 
 export const productCreateRequestSchema = z.strictObject({

package/src/schemas/promotion.ts

@@ -158,6 +158,7 @@ export const couponRejectReasonSchema = z
     "NO_ELIGIBLE_ITEMS",
     "MIN_ORDER_AMOUNT",
     "LINE_NOT_ELIGIBLE",
+    "LINE_AMBIGUOUS",
     "NO_DISCOUNT",
   ])
   .describe(
@@ -165,7 +166,8 @@ export const couponRejectReasonSchema = z
       "`STACK_LIMIT`=같은 종류의 쿠폰이 이미 적용됨(주문 쿠폰·배송비 쿠폰은 주문당 1장, 상품 쿠폰은 주문상품 한 줄에 1장), " +
       "`NOT_STARTED`=사용 기간 전, `EXPIRED`=사용 기간 지남, `MEMBER_ONLY`=회원 전용, `FIRST_ORDER_ONLY`=첫 구매 전용, " +
       "`NO_ELIGIBLE_ITEMS`=대상 상품이 주문에 없음, `MIN_ORDER_AMOUNT`=최소 주문 금액 미달, " +
-      "`LINE_NOT_ELIGIBLE`=지정한 주문상품이 대상이 아니거나 이미 상품 쿠폰이 있음, `NO_DISCOUNT`=할인할 금액이 없음",
+      "`LINE_NOT_ELIGIBLE`=지정한 주문상품이 대상이 아니거나 이미 상품 쿠폰이 있음, " +
+      "`LINE_AMBIGUOUS`=지정한 `optionId`의 줄이 여럿이라 줄을 정할 수 없음(`lineId`로 지목한다), `NO_DISCOUNT`=할인할 금액이 없음",
   );
 export type CouponRejectReason = z.infer<typeof couponRejectReasonSchema>;
 

package/src/schemas/saved-option-set.ts

@@ -0,0 +1,168 @@
+import { z } from "zod";
+import { type PageParams, pageQueryShape } from "./common";
+import {
+  MAX_ADDON_GROUPS,
+  MAX_CUSTOM_INPUT_LENGTH,
+  MAX_CUSTOM_INPUTS,
+  MAX_OPTION_GROUPS,
+  MAX_VALUES_PER_GROUP,
+  optionSortSchema,
+} from "./product";
+
+/**
+ * 저장 옵션 (이슈 #59) — 자주 쓰는 옵션 구성을 이름 붙여 두고 상품 등록에서 불러온다.
+ *
+ * **불러오기는 복사다.** 저장 옵션을 고치거나 지워도 이미 불러온 상품의 옵션은 그대로다. 재고·SKU·사용 여부는 상품마다
+ * 달라 저장하지 않는다. 추가금은 조합별이 아니라 **값별**로 둔다 — 조합 옵션으로 불러오면 조합 추가금은 고른 값 추가금의 합이다.
+ */
+
+/** 스토어당 저장 옵션 최대 개수 */
+export const MAX_SAVED_OPTION_SETS = 200;
+/** 저장 옵션 이름 최대 글자 수 */
+export const MAX_SAVED_OPTION_SET_NAME = 50;
+
+/** 옵션명 방식 — `combination`(조합: 값의 조합이 판매 단위가 된다)·`addon`(추가 선택: 재고 없이 추가금만) */
+export const optionGroupKindSchema = z.enum(["combination", "addon"]);
+
+export type OptionGroupKind = z.infer<typeof optionGroupKindSchema>;
+
+const nameSchema = z.string().trim().min(1).max(50);
+
+export const savedOptionValueSchema = z.object({
+  name: z.string(),
+  additionalPrice: z.number().int().describe("값별 추가금(원, 0 이상)"),
+});
+
+export const savedOptionGroupSchema = z.object({
+  name: z.string(),
+  kind: z
+    .string()
+    .describe(
+      "옵션명 방식. 현재 값은 `combination`·`addon`이고 값이 추가될 수 있어 문자열로 받는다",
+    ),
+  required: z.boolean().describe("추가 선택을 구매자가 꼭 고르는가. 조합 옵션명은 항상 false다"),
+  values: z.array(savedOptionValueSchema),
+});
+
+export type SavedOptionGroup = z.infer<typeof savedOptionGroupSchema>;
+
+export const savedCustomInputSchema = z.object({
+  label: z.string(),
+  placeholder: z.string().nullable(),
+  maxLength: z.number().int(),
+  required: z.boolean(),
+});
+
+export type SavedCustomInput = z.infer<typeof savedCustomInputSchema>;
+
+export const savedOptionSetSchema = z.object({
+  optionSetId: z.string(),
+  name: z.string(),
+  optionSort: optionSortSchema,
+  groups: z.array(savedOptionGroupSchema).describe("옵션명. 배열 순서가 입력 순서다"),
+  customInputs: z.array(savedCustomInputSchema),
+  importedProductCount: z
+    .number()
+    .int()
+    .describe("이 저장 옵션을 불러온 상품 수(중복 없이, 지운 상품 제외). 불러오기 기록으로 센다"),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+export type SavedOptionSet = z.infer<typeof savedOptionSetSchema>;
+
+export const savedOptionValueRequestSchema = z.object({
+  name: nameSchema,
+  additionalPrice: z.number().int().min(0).default(0),
+});
+
+export const savedOptionGroupRequestSchema = z.object({
+  name: nameSchema,
+  kind: optionGroupKindSchema,
+  required: z
+    .boolean()
+    .default(false)
+    .describe("추가 선택만 쓴다. 조합 옵션명에 true를 주면 400이다"),
+  values: z.array(savedOptionValueRequestSchema).min(1).max(MAX_VALUES_PER_GROUP),
+});
+
+export type SavedOptionGroupRequest = z.infer<typeof savedOptionGroupRequestSchema>;
+
+export const savedCustomInputRequestSchema = z.object({
+  label: z.string().trim().min(1).max(30),
+  placeholder: z.string().trim().max(100).nullish(),
+  maxLength: z.number().int().min(1).max(MAX_CUSTOM_INPUT_LENGTH),
+  required: z.boolean().default(false),
+});
+
+/**
+ * 저장 옵션 만들기·수정 본문. 조합 옵션명은 최대 `MAX_OPTION_GROUPS`개, 추가 선택은 최대 `MAX_ADDON_GROUPS`개이고
+ * 옵션명과 직접 입력 항목이 모두 비면 400이다. 수정(PUT)은 통째로 바꾼다.
+ */
+export const savedOptionSetRequestSchema = z.object({
+  name: z.string().trim().min(1).max(MAX_SAVED_OPTION_SET_NAME),
+  optionSort: optionSortSchema.default("REGISTERED"),
+  groups: z
+    .array(savedOptionGroupRequestSchema)
+    .max(MAX_OPTION_GROUPS + MAX_ADDON_GROUPS)
+    .default([]),
+  customInputs: z.array(savedCustomInputRequestSchema).max(MAX_CUSTOM_INPUTS).default([]),
+});
+
+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 const savedOptionSetFromProductRequestSchema = z.object({
+  productId: z.string(),
+  name: z.string().trim().min(1).max(MAX_SAVED_OPTION_SET_NAME),
+  includeOptions: z.boolean().default(true).describe("옵션명(조합·추가 선택)을 저장하는가"),
+  includeCustomInputs: z.boolean().default(true).describe("직접 입력 항목을 저장하는가"),
+  replaceOptionSetId: z.string().optional().describe("덮어쓸 저장 옵션 id. 생략하면 새로 만든다"),
+});
+
+export type SavedOptionSetFromProductRequest = z.infer<
+  typeof savedOptionSetFromProductRequestSchema
+>;
+export type SavedOptionSetFromProductRequestInput = z.input<
+  typeof savedOptionSetFromProductRequestSchema
+>;
+
+export const savedOptionSetFromProductResultSchema = z.object({
+  optionSet: savedOptionSetSchema,
+  additionalPriceDropped: z
+    .boolean()
+    .describe("조합 추가금을 값별 추가금으로 되돌릴 수 없어 추가금을 빼고 저장했는가"),
+});
+
+export type SavedOptionSetFromProductResult = z.infer<typeof savedOptionSetFromProductResultSchema>;
+
+/** 구성 필터 — 조합 옵션명·추가 선택 옵션명·직접 입력 항목을 가진 저장 옵션 */
+export const savedOptionSetCompositionSchema = z.enum(["combination", "addon", "customInput"]);
+
+export const savedOptionSetSortSchema = z.enum([
+  "updatedAt.desc",
+  "name.asc",
+  "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 const savedOptionSetListQuerySchema = z.object({
+  keyword: z.string().optional().describe("이름 검색 (포함, 대소문자 무시)"),
+  composition: savedOptionSetCompositionSchema.optional().describe("구성 필터"),
+  sort: savedOptionSetSortSchema.optional().describe("정렬 (기본 updatedAt.desc)"),
+  ...pageQueryShape({ defaultSize: 20, maxSize: 200 }),
+});

package/src/schemas/store.ts

@@ -166,22 +166,6 @@ export const updateStoreRequestSchema = z
         "비회원 주문 허용. false(회원만)면 로그인하지 않은 구매자의 주문서 생성·결제 요청이 403 `GUEST_CHECKOUT_DISABLED`다. " +
           "장바구니 담기와 이미 받은 비회원 주문의 조회·취소는 막지 않는다",
       ),
-    fulfillmentMailEnabled: z
-      .boolean()
-      .optional()
-      .describe(
-        "비실물 상품 제공 안내 메일(이슈 #48). 켜면(기본) 제공이 끝났을 때 구매자에게 안내 메일을 보낸다. 코드·파일 주소는 싣지 않는다",
-      ),
-    withdrawalNotice: z
-      .string()
-      .trim()
-      .min(1)
-      .max(1000)
-      .nullable()
-      .optional()
-      .describe(
-        "청약철회 제한 고지 문구(이슈 #48). 제한 상품이 있는 주문서에 보인다. null이면 플랫폼 기본 문구를 쓴다",
-      ),
     autoDeliverDays: z
       .number()
       .int()
@@ -247,17 +231,6 @@ export const storeSchema = z.object({
       "스토어프론트 도메인 — 소셜 로그인 리디렉트와 방문 분석 수집이 함께 쓴다(`analyticsAllowedOrigins`와 같은 값)",
     ),
   guestCheckoutEnabled: z.boolean().describe("비회원 주문 허용. false면 회원만 주문할 수 있다"),
-  fulfillmentMailEnabled: z
-    .boolean()
-    .optional()
-    .default(true)
-    .describe("비실물 상품 제공 안내 메일(이슈 #48). 서버는 항상 싣는다"),
-  withdrawalNotice: z
-    .string()
-    .nullable()
-    .optional()
-    .default(null)
-    .describe("청약철회 제한 고지 문구(이슈 #48). null이면 플랫폼 기본 문구다. 서버는 항상 싣는다"),
   autoDeliverDays: z.number().int().describe(autoDeliverDaysDescription),
   autoConfirmDays: z.number().int().describe(autoConfirmDaysDescription),
   refundPolicy: refundPolicySchema.describe(
@@ -361,10 +334,9 @@ export const storeMemberRoleUpdatedSchema = z.object({
 export type StoreMemberRoleUpdated = z.infer<typeof storeMemberRoleUpdatedSchema>;
 
 /**
- * 주소 유형 — 출고지·반품지·방문 수령지(이슈 #48). 방문 수령지(`PICKUP`)는 목록에서 `type=PICKUP`으로 조회할 때만 나온다
- * (이 값을 모르는 옛 SDK의 목록 파싱이 깨지지 않게).
+ * 주소 유형 — 출고지·반품지.
  */
-export const addressTypeSchema = z.enum(["SHIPPING", "RETURN", "PICKUP"]);
+export const addressTypeSchema = z.enum(["SHIPPING", "RETURN"]);
 
 export type AddressType = z.infer<typeof addressTypeSchema>;