@sayren/store-sdk 0.19.0 → 0.21.0

package/src/schemas/fulfillment.ts

@@ -1,33 +1,27 @@
 import { z } from "zod";
 
 /**
- * 상품 유형과 제공 방식 (이슈 #48) — 배송이 필요 없는 상품을 팔기 위한 축이다.
+ * 상품 유형 (이슈 #48·#57) — 배송이 필요한 상품과 필요 없는 상품을 가르는 축이다.
  *
- * **상품 유형은 제공 방식 하나로 표현한다.** `fulfillmentType` 한 필드가 배송 필요 여부, 이행 흐름, 재고 의미를 정한다.
+ * **상품 유형은 이행 방식 하나로 표현한다.** `fulfillment.type`이 배송 필요 여부, 이행 흐름, 클레임 규칙을 정한다.
  * 코드 곳곳에서 유형 이름으로 분기하지 않고 이 파일의 판정 함수(`requiresShipping`·`fulfillmentRuleOf`)를 지난다.
- * 유형이 늘어나도 판정표 한 곳만 고치면 배송비 계산·결제 시작·클레임·콘솔 버튼이 같이 따라온다.
  *
  * 주문상품 상태 enum은 바꾸지 않는다. 비실물의 **제공 완료는 `DELIVERED`를 재사용한다** — 새 상태를 더하면 기존 소비자의
- * 상태 분기(배송완료 뒤 구매확정 대기, 반품 가능 판정)가 새 값을 모른다. 표시는 `fulfillmentType`으로 가른다.
+ * 상태 분기(배송완료 뒤 구매확정 대기, 반품 가능 판정)가 새 값을 모른다. 표시는 유형으로 가른다.
  */
 
 /**
  * 상품 유형.
- * - `SHIPPING` 배송 상품(기본, 이 필드 이전의 상품 전부)
- * - `DOWNLOAD` 파일 다운로드
- * - `CODE` 코드 발급(라이선스 키·기프트 코드)
- * - `SERVICE` 이용권·상품권·서비스(예약 없음)
- * - `PICKUP` 방문 수령 실물
+ * - `SHIPPING` 배송 상품. 택배로 발송하고 송장·배송 추적으로 배송완료가 된다
+ * - `MANUAL` 배송 없는 상품(비실물). 셀러가 제공 처리(`POST /v1/order-items/{orderItemId}/fulfill`)로 제공 완료를 기록한다
+ *
+ * 비실물의 세부 구분(파일 다운로드·코드 발급·이용권·방문 수령)은 2026-09-28에 제품에서 뺐다(이슈 #48 범위 축소).
+ * 이름은 이행 방식이다 — `SHIPPING`이 택배 발송이듯 `MANUAL`은 셀러가 직접 제공한다는 뜻이다.
  */
-export const fulfillmentTypeSchema = z.enum(["SHIPPING", "DOWNLOAD", "CODE", "SERVICE", "PICKUP"]);
+export const fulfillmentTypeSchema = z.enum(["SHIPPING", "MANUAL"]);
 
 export type FulfillmentType = z.infer<typeof fulfillmentTypeSchema>;
 
-/** 제공 방식 — `AUTO`는 결제 확정과 함께 제공하고, `MANUAL`은 셀러가 제공 처리한다 */
-export const fulfillmentModeSchema = z.enum(["AUTO", "MANUAL"]);
-
-export type FulfillmentMode = z.infer<typeof fulfillmentModeSchema>;
-
 /**
  * 응답 스키마용 유형 — 서버가 나중에 유형을 더해도 옛 SDK가 응답 파싱에서 깨지지 않게 문자열로 받는다.
  * 요청은 `fulfillmentTypeSchema`(닫힌 enum)로 검증한다.
@@ -35,71 +29,35 @@ export type FulfillmentMode = z.infer<typeof fulfillmentModeSchema>;
 export const fulfillmentTypeResponseSchema = z
   .string()
   .describe(
-    "상품 유형. 현재 값은 `SHIPPING`(배송 상품)·`DOWNLOAD`(파일 다운로드)·`CODE`(코드 발급)·`SERVICE`(이용권·서비스)·" +
-      "`PICKUP`(방문 수령)이고 값이 추가될 수 있어 문자열로 받는다",
+    "상품 유형. 현재 값은 `SHIPPING`(배송 상품)·`MANUAL`(배송 없는 상품, 셀러가 제공 처리)이고 값이 추가될 수 있어 문자열로 받는다",
   );
 
-/** 유형 하나의 규칙 — 배송·제공·재고·클레임이 이 표를 읽는다 */
+/** 유형 하나의 규칙 — 배송·클레임이 이 표를 읽는다 */
 export interface FulfillmentRule {
   /** 택배 배송이 필요한가 — 배송비·배송지·발송 흐름의 대상인가 */
   requiresShipping: boolean;
-  /** 허용하는 제공 방식. 배송 상품은 제공 방식이 없다(빈 배열) */
-  modes: readonly FulfillmentMode[];
-  /** 제공 방식을 정하지 않았을 때의 기본값. 배송 상품은 null */
-  defaultMode: FulfillmentMode | null;
-  /** 반품에 수거가 필요한가 — 실물만 수거한다(방문 수령 포함) */
+  /** 반품에 수거가 필요한가 — 실물만 수거한다 */
   requiresCollection: boolean;
   /** 교환을 받는가 — 실물만 받는다 */
   exchangeSupported: boolean;
 }
 
-/**
- * 유형별 규칙표 — **유일한 원천이다.**
- *
- * `PICKUP`은 실물이라 반품 수거와 교환을 받지만 택배 배송은 없다. `DOWNLOAD`는 결제 즉시 권한을 발급하므로 `AUTO`만,
- * `PICKUP`은 셀러가 수령 완료를 누르므로 `MANUAL`만 둔다.
- */
+/** 유형별 규칙표 — **유일한 원천이다.** */
 export const FULFILLMENT_RULES: Readonly<Record<FulfillmentType, FulfillmentRule>> = {
   SHIPPING: {
     requiresShipping: true,
-    modes: [],
-    defaultMode: null,
     requiresCollection: true,
     exchangeSupported: true,
   },
-  DOWNLOAD: {
-    requiresShipping: false,
-    modes: ["AUTO"],
-    defaultMode: "AUTO",
-    requiresCollection: false,
-    exchangeSupported: false,
-  },
-  CODE: {
+  MANUAL: {
     requiresShipping: false,
-    modes: ["AUTO", "MANUAL"],
-    defaultMode: "AUTO",
     requiresCollection: false,
     exchangeSupported: false,
   },
-  SERVICE: {
-    requiresShipping: false,
-    modes: ["MANUAL", "AUTO"],
-    defaultMode: "MANUAL",
-    requiresCollection: false,
-    exchangeSupported: false,
-  },
-  PICKUP: {
-    requiresShipping: false,
-    modes: ["MANUAL"],
-    defaultMode: "MANUAL",
-    requiresCollection: true,
-    exchangeSupported: true,
-  },
 };
 
 /**
- * 저장된 값 → 유형. null·모르는 값은 `SHIPPING`이다 — 이 필드 이전의 주문상품(`order_items.fulfillment_type` null)과
- * 상품은 모두 배송 상품이었다.
+ * 저장된 값 → 유형. null·모르는 값은 `SHIPPING`이다 — 이 필드 이전의 상품·주문상품은 모두 배송 상품이었다.
  */
 export function fulfillmentTypeOf(value: string | null | undefined): FulfillmentType {
   const parsed = fulfillmentTypeSchema.safeParse(value);
@@ -121,20 +79,6 @@ export function requiresCollection(type: string | null | undefined): boolean {
   return fulfillmentRuleOf(type).requiresCollection;
 }
 
-/**
- * 유효 제공 방식 — 요청 값이 유형에 허용되면 그 값, 생략이면 유형 기본값이다. 배송 상품은 null이다.
- * 허용되지 않는 값은 `null`을 돌려주지 않고 호출부가 거부하도록 `undefined`를 돌려준다.
- */
-export function resolveFulfillmentMode(
-  type: FulfillmentType,
-  mode: FulfillmentMode | null | undefined,
-): FulfillmentMode | null | undefined {
-  const rule = FULFILLMENT_RULES[type];
-  if (rule.modes.length === 0) return null;
-  if (mode === null || mode === undefined) return rule.defaultMode;
-  return rule.modes.includes(mode) ? mode : undefined;
-}
-
 /**
  * 배송이 없는 주문상품의 배송 묶음 키 (`order_items.delivery_bundle_key`).
  *
@@ -146,11 +90,12 @@ export const NO_SHIPPING_BUNDLE_KEY = "none";
 
 // ─── 상품 이행 (이슈 #57) ─────────────────────────────────────
 //
-// 상품은 공통 필드 + `fulfillment` 판별 유니온이다. 유형 키 안에 그 유형의 속성만 있다(서버는 `product_{type}` 1:1 테이블).
+// 상품은 공통 필드 + `fulfillment` 판별 유니온이다. 유형 키 안에 그 유형의 속성만 있다(서버는 배송 상품만 `product_shipping` 1:1 테이블).
+// 배송 없는 상품(`MANUAL`)은 유형 속성이 없어 `{ "type": "MANUAL" }`뿐이다.
 // - 요청은 닫힌 유니온이다. 모르는 `type`·다른 유형의 키·오타는 400이다(`strictObject`).
 // - 등록은 유형 안 필드에 기본값이 있다. 수정(PUT·PATCH)은 `fulfillment`를 통째로 받고 **유형 안 필드가 모두 필수다** —
-//   통째 교체에 기본값을 두면 부분 수정이 출고지·청약철회 제한을 조용히 되돌린다.
-// - 응답은 열린 유니온이다. 서버가 유형을 더해도(#56 `RESERVATION`) SDK가 깨지지 않게 모르는 유형은
+//   통째 교체에 기본값을 두면 부분 수정이 출고지를 조용히 되돌린다.
+// - 응답은 열린 유니온이다. 서버가 유형을 더해도 SDK가 깨지지 않게 모르는 유형은
 //   `{ type: "OTHER", rawType }`로 읽는다. 알려진 유형의 모양이 틀리면 파싱 오류다.
 
 /** 배송비 유형 — 무료·유료·조건부 무료 */
@@ -158,9 +103,6 @@ export const deliveryTypeSchema = z.enum(["FREE", "PAID", "CONDITIONAL_FREE"]);
 
 export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
 
-/** 파일 다운로드 기본값 — 횟수 5회·기간 30일(#48 결정 8) */
-export const DOWNLOAD_DEFAULTS = { limit: 5, days: 30 } as const;
-
 const KNOWN_FULFILLMENT_TYPES: readonly string[] = fulfillmentTypeSchema.options;
 
 const ADDRESS_ID_DESCRIPTIONS = {
@@ -170,9 +112,6 @@ const ADDRESS_ID_DESCRIPTIONS = {
   return:
     "반품지 주소 id(`GET /v1/seller-addresses?type=RETURN`). 등록에서 생략하면 그 시점 스토어 기본 반품지를 저장한다. " +
     "`null`이면 비워 둔다(스토어 기본 반품지를 따른다). 이 스토어의 `RETURN` 주소가 아니면 거부한다",
-  pickup:
-    "방문 수령지 주소 id(`GET /v1/seller-addresses?type=PICKUP`). 등록에서 생략하면 그 시점 스토어 기본 방문 수령지를 저장하고, " +
-    "기본 방문 수령지도 없으면 400 `PICKUP_ADDRESS_REQUIRED`다. 이 스토어의 `PICKUP` 주소가 아니면 거부한다",
 } as const;
 
 /**
@@ -236,78 +175,12 @@ const shippingCreateSchema = z
   })
   .superRefine(refineShippingConsistency);
 
-const downloadCreateSchema = z.strictObject({
-  limit: z
-    .number()
-    .int()
-    .min(1)
-    .max(100)
-    .default(DOWNLOAD_DEFAULTS.limit)
-    .describe("다운로드 횟수 한도(수량 1개당). 생략하면 5회"),
-  days: z
-    .number()
-    .int()
-    .min(1)
-    .max(3650)
-    .default(DOWNLOAD_DEFAULTS.days)
-    .describe("다운로드 기간(제공일부터 일수). 생략하면 30일"),
-  stockTracking: z
-    .boolean()
-    .default(false)
-    .describe("재고를 세는가. 생략하면 false(재고와 무관하게 판다)"),
-  withdrawalRestricted: z
-    .boolean()
-    .default(false)
-    .describe(
-      "청약철회 제한 대상인가. true면 주문서가 제한 고지 동의를 받고, 첫 다운로드 뒤 구매자 단순 변심 취소·반품을 받지 않는다",
-    ),
-});
-
-const codeCreateSchema = z.strictObject({
-  mode: fulfillmentModeSchema
-    .default("AUTO")
-    .describe(
-      "제공 방식. `AUTO`는 코드 풀에서 결제 확정과 함께 배정하고, `MANUAL`은 셀러가 제공 처리 때 코드를 넘긴다",
-    ),
-  withdrawalRestricted: z
-    .boolean()
-    .default(false)
-    .describe("청약철회 제한 대상인가. true면 첫 열람 뒤 구매자 단순 변심 취소·반품을 받지 않는다"),
-});
-
-const serviceCreateSchema = z.strictObject({
-  mode: fulfillmentModeSchema
-    .default("MANUAL")
-    .describe("제공 방식. `AUTO`는 결제 확정과 함께 제공 완료, `MANUAL`은 셀러가 제공 처리한다"),
-});
-
-const pickupCreateSchema = z.strictObject({
-  addressId: z.string().optional().describe(ADDRESS_ID_DESCRIPTIONS.pickup),
-});
-
 /**
- * 상품 이행 — 등록(POST). 유형 키를 생략하면 그 유형의 기본값이다(`{ "type": "DOWNLOAD" }`만으로 등록할 수 있다).
+ * 상품 이행 — 등록(POST). 배송 상품의 `shipping`을 생략하면 기본값(유료 배송·스토어 기본 배송비·기본 출고지·반품지)이다.
  */
 export const productFulfillmentCreateSchema = z.discriminatedUnion("type", [
   z.strictObject({ type: z.literal("SHIPPING"), shipping: shippingCreateSchema.optional() }),
-  z.strictObject({
-    type: z.literal("DOWNLOAD"),
-    download: downloadCreateSchema.default({
-      limit: DOWNLOAD_DEFAULTS.limit,
-      days: DOWNLOAD_DEFAULTS.days,
-      stockTracking: false,
-      withdrawalRestricted: false,
-    }),
-  }),
-  z.strictObject({
-    type: z.literal("CODE"),
-    code: codeCreateSchema.default({ mode: "AUTO", withdrawalRestricted: false }),
-  }),
-  z.strictObject({
-    type: z.literal("SERVICE"),
-    service: serviceCreateSchema.default({ mode: "MANUAL" }),
-  }),
-  z.strictObject({ type: z.literal("PICKUP"), pickup: pickupCreateSchema.default({}) }),
+  z.strictObject({ type: z.literal("MANUAL") }),
 ]);
 
 export type ProductFulfillmentCreate = z.infer<typeof productFulfillmentCreateSchema>;
@@ -337,27 +210,7 @@ const shippingUpdateSchema = z
  */
 export const productFulfillmentUpdateSchema = z.discriminatedUnion("type", [
   z.strictObject({ type: z.literal("SHIPPING"), shipping: shippingUpdateSchema }),
-  z.strictObject({
-    type: z.literal("DOWNLOAD"),
-    download: z.strictObject({
-      limit: z.number().int().min(1).max(100),
-      days: z.number().int().min(1).max(3650),
-      stockTracking: z.boolean(),
-      withdrawalRestricted: z.boolean(),
-    }),
-  }),
-  z.strictObject({
-    type: z.literal("CODE"),
-    code: z.strictObject({ mode: fulfillmentModeSchema, withdrawalRestricted: z.boolean() }),
-  }),
-  z.strictObject({
-    type: z.literal("SERVICE"),
-    service: z.strictObject({ mode: fulfillmentModeSchema }),
-  }),
-  z.strictObject({
-    type: z.literal("PICKUP"),
-    pickup: z.strictObject({ addressId: z.string().describe(ADDRESS_ID_DESCRIPTIONS.pickup) }),
-  }),
+  z.strictObject({ type: z.literal("MANUAL") }),
 ]);
 
 export type ProductFulfillmentUpdate = z.infer<typeof productFulfillmentUpdateSchema>;
@@ -389,37 +242,7 @@ export const productFulfillmentSchema = z.discriminatedUnion("type", [
         .describe("반품지 주소 id. null이면 스토어 기본 반품지를 따른다"),
     }),
   }),
-  z.object({
-    type: z.literal("DOWNLOAD"),
-    download: z.object({
-      limit: z.number().int().describe("다운로드 횟수 한도(수량 1개당)"),
-      days: z.number().int().describe("다운로드 기간(제공일부터 일수)"),
-      stockTracking: z.boolean().describe("재고를 세는가"),
-      withdrawalRestricted: z.boolean().describe("청약철회 제한 대상인가"),
-    }),
-  }),
-  z.object({
-    type: z.literal("CODE"),
-    code: z.object({
-      mode: fulfillmentModeSchema.describe("제공 방식"),
-      withdrawalRestricted: z.boolean().describe("청약철회 제한 대상인가"),
-    }),
-  }),
-  z.object({
-    type: z.literal("SERVICE"),
-    service: z.object({ mode: fulfillmentModeSchema.describe("제공 방식") }),
-  }),
-  z.object({
-    type: z.literal("PICKUP"),
-    pickup: z.object({
-      addressId: z
-        .string()
-        .nullable()
-        .describe(
-          "방문 수령지 주소 id. null은 수령지가 지워진 상품이다(수령지를 다시 지정할 때까지 팔 수 없다)",
-        ),
-    }),
-  }),
+  z.object({ type: z.literal("MANUAL") }),
 ]);
 
 export type ProductFulfillment = z.infer<typeof productFulfillmentSchema>;
@@ -464,52 +287,11 @@ export const productFulfillmentResponseSchema = openFulfillmentUnion(
 
 export type ProductFulfillmentView = z.infer<typeof productFulfillmentResponseSchema>;
 
-// ── 판정 헬퍼 ──
-
-/** 제공 방식 — CODE·SERVICE는 저장된 값, DOWNLOAD는 AUTO, PICKUP은 MANUAL, 배송 상품은 null */
-export function fulfillmentModeOf(fulfillment: ProductFulfillment): FulfillmentMode | null {
-  switch (fulfillment.type) {
-    case "CODE":
-      return fulfillment.code.mode;
-    case "SERVICE":
-      return fulfillment.service.mode;
-    default:
-      return FULFILLMENT_RULES[fulfillment.type].defaultMode;
-  }
-}
-
-/** 재고를 세는가 — 파일 다운로드만 끌 수 있다 */
-export function stockTrackingOf(fulfillment: ProductFulfillment): boolean {
-  return fulfillment.type === "DOWNLOAD" ? fulfillment.download.stockTracking : true;
-}
-
-/** 청약철회 제한 대상인가 — 파일 다운로드·코드 발급만 켤 수 있다(전자상거래법 제17조 제2항 제5호, 디지털 콘텐츠) */
-export function withdrawalRestrictedOf(fulfillment: ProductFulfillment): boolean {
-  if (fulfillment.type === "DOWNLOAD") return fulfillment.download.withdrawalRestricted;
-  if (fulfillment.type === "CODE") return fulfillment.code.withdrawalRestricted;
-  return false;
-}
-
-/** 코드 풀을 쓰는가 — 코드 발급 + 자동 제공. 재고가 판매 가능 코드 수다 */
-export function usesCodePool(fulfillment: ProductFulfillment): boolean {
-  return fulfillment.type === "CODE" && fulfillment.code.mode === "AUTO";
-}
-
-/** 결제 확정과 함께 제공까지 끝내는가 — 비실물 + 자동 제공 */
-export function autoFulfillableOf(fulfillment: ProductFulfillment): boolean {
-  return (
-    !FULFILLMENT_RULES[fulfillment.type].requiresShipping &&
-    fulfillmentModeOf(fulfillment) === "AUTO"
-  );
-}
-
 // ─── 주문상품 이행 스냅샷 (이슈 #57) ─────────────────────────────
 
 /**
  * 주문상품의 주문 시점 이행 — 결제 확정이 주문서 줄에서 굳힌다. 상품의 현재 값이 아니다. 서버는 주문상품 컬럼
- * (`fulfillment_type`·`delivery_bundle_key`·`stock_tracked`·`withdrawal_restricted`)과 jsonb(`fulfillment_snapshot`)를 합쳐 이 모양을 만든다.
- *
- * `mode`는 **주문 시점 상품의 방식**이다. 실제 제공 방식은 제공 기록(`fulfillment.mode`)에 있고 다를 수 있다(자동 제공 상품의 수동 복구).
+ * (`fulfillment_type`·`delivery_bundle_key`)과 jsonb(`fulfillment_snapshot`)를 합쳐 이 모양을 만든다.
  */
 export const orderItemFulfillmentSnapshotSchema = z.discriminatedUnion("type", [
   z.object({
@@ -529,38 +311,7 @@ export const orderItemFulfillmentSnapshotSchema = z.discriminatedUnion("type", [
         ),
     }),
   }),
-  z.object({
-    type: z.literal("DOWNLOAD"),
-    download: z.object({
-      limit: z.number().int().describe("주문 시점 다운로드 횟수 한도(수량 1개당)"),
-      days: z.number().int().describe("주문 시점 다운로드 기간(제공일부터 일수)"),
-      stockTracked: z.boolean().describe("주문 시점에 재고를 뺐는가"),
-      withdrawalRestricted: z
-        .boolean()
-        .describe("구매자가 제한 고지에 동의한 청약철회 제한 주문상품인가"),
-    }),
-  }),
-  z.object({
-    type: z.literal("CODE"),
-    code: z.object({
-      mode: z.string().describe("주문 시점 상품의 제공 방식. 현재 값은 `AUTO`·`MANUAL`"),
-      withdrawalRestricted: z
-        .boolean()
-        .describe("구매자가 제한 고지에 동의한 청약철회 제한 주문상품인가"),
-    }),
-  }),
-  z.object({
-    type: z.literal("SERVICE"),
-    service: z.object({
-      mode: z.string().describe("주문 시점 상품의 제공 방식. 현재 값은 `AUTO`·`MANUAL`"),
-    }),
-  }),
-  z.object({
-    type: z.literal("PICKUP"),
-    pickup: z.object({
-      addressId: z.string().nullable().describe("주문 시점 방문 수령지 주소 id"),
-    }),
-  }),
+  z.object({ type: z.literal("MANUAL") }),
 ]);
 
 export type OrderItemFulfillmentSnapshot = z.infer<typeof orderItemFulfillmentSnapshotSchema>;
@@ -568,7 +319,7 @@ export type OrderItemFulfillmentSnapshot = z.infer<typeof orderItemFulfillmentSn
 export const orderItemFulfillmentSnapshotResponseSchema = openFulfillmentUnion(
   orderItemFulfillmentSnapshotSchema,
 ).describe(
-  "주문 시점 이행 스냅샷. 상품을 나중에 고쳐도 바뀌지 않는다. 실제 제공 기록은 `fulfillment`에 있다. 값이 추가될 수 있어 SDK는 모르는 유형을 `OTHER`로 읽는다",
+  "주문 시점 이행 스냅샷. 상품을 나중에 고쳐도 바뀌지 않는다. 제공 기록은 `fulfillment`에 있다. 값이 추가될 수 있어 SDK는 모르는 유형을 `OTHER`로 읽는다",
 );
 
 export type OrderItemFulfillmentSnapshotView = z.infer<

package/src/schemas/misc.ts

@@ -149,7 +149,7 @@ export const eventTypeSchema = z
     "ORDER.ADDRESS_CHANGE_REQUESTED",
     // 셀러 직권취소 (이슈 #50). 뒤에 붙여 기존 값의 순서를 바꾸지 않는다
     "ORDER.CANCELED",
-    // 비실물 상품 제공 (이슈 #48). 구독한 수신자에게만 간다
+    // 배송 없는 상품 제공 (이슈 #48). 구독한 수신자에게만 간다
     "ORDER.FULFILLED",
     "CLAIM.CANCEL_REQUESTED",
     "CLAIM.RETURN_REQUESTED",

package/src/schemas/order.ts

@@ -1,9 +1,8 @@
 import { z } from "zod";
 import { changeTypeSchema, orderItemStatusSchema, type PageParams, pageSchema } from "./common";
-import { orderItemDownloadSchema } from "./digital-asset";
 import { orderItemFulfillmentSnapshotResponseSchema } from "./fulfillment";
-import { MAX_CODE_LENGTH, orderItemCodeSchema } from "./fulfillment-code";
 import { cashReceiptSchema, easyPayProviderResponseSchema } from "./payment";
+import { customInputValueSchema, optionSelectionSchema } from "./product";
 
 export const orderSummarySchema = z.object({
   orderId: z.string(),
@@ -33,55 +32,23 @@ export const shippingAddressSchema = z.object({
 
 export type ShippingAddress = z.infer<typeof shippingAddressSchema>;
 
-/** 비실물 주문상품의 제공 정보 (이슈 #48) */
+/** 배송 없는 주문상품(`MANUAL`)의 제공 기록 (이슈 #48) — 셀러의 제공 처리가 만든다 */
 export const orderItemFulfillmentSchema = z.object({
   status: z
     .string()
     .describe(
-      "제공 상태. `FULFILLED`(제공함)·`REVOKED`(환불 등으로 회수함). 값이 추가될 수 있어 문자열로 받는다",
+      "제공 상태. `FULFILLED`(제공함)·`REVOKED`(전량 취소·환불로 회수함). 값이 추가될 수 있어 문자열로 받는다",
     ),
-  mode: z.string().nullable().describe("제공 방식. `AUTO`·`MANUAL`"),
   fulfilledAt: z.string().describe("제공 시각 (ISO 8601)"),
-  note: z.string().nullable().describe("셀러가 남긴 이용 안내. 없으면 null"),
-  codes: z
-    .array(orderItemCodeSchema)
-    .optional()
-    .default([])
-    .describe(
-      "코드 발급 상품에 배정한 코드의 가린 값. 평문은 싣지 않는다. 코드 상품이 아니면 빈 배열. 서버는 항상 싣는다",
-    ),
-  download: orderItemDownloadSchema
-    .nullable()
+  note: z.string().nullable().describe("셀러가 제공 처리 때 남긴 이용 안내. 없으면 null"),
+  mode: z
+    .string()
     .optional()
-    .default(null)
     .describe(
-      "파일 다운로드 상품의 횟수·기한·파일 목록. 파일 주소는 싣지 않는다. 다른 유형은 null. 서버는 항상 싣는다",
+      "**Deprecated** — 항상 `MANUAL`이다. 자동 제공을 없앴고(이슈 #48) store-sdk 0.19 이하 호환으로만 싣는다. 게시된 연동이 store-sdk 0.20 이상으로 넘어간 뒤 다음 릴리스에서 뺀다",
     ),
-  mail: z
-    .object({
-      status: z
-        .string()
-        .describe(
-          "제공 안내 메일 상태. 현재 값은 `PENDING`(보낼 예정)·`SENDING`·`SENT`·`FAILED`·`SKIPPED`(보내지 않음: 스토어 설정 꺼짐·받을 주소 없음)이고 값이 추가될 수 있다",
-        ),
-      sentAt: z.string().nullable(),
-      errorCode: z.string().nullable().describe("실패·건너뜀 사유 코드"),
-    })
-    .nullable()
-    .optional()
-    .default(null)
-    .describe("구매자에게 보낸 제공 안내 메일(이슈 #48). 기록이 없으면 null. 서버는 항상 싣는다"),
 });
 
-/** 제공 안내 메일 재발송 결과 */
-export const fulfillmentMailResendSchema = z.object({
-  mailStatus: z
-    .string()
-    .describe("재발송 뒤 메일 상태 — `SENT`·`PENDING`(곧 다시 보낸다)·`FAILED`·`SKIPPED`"),
-});
-
-export type FulfillmentMailResend = z.infer<typeof fulfillmentMailResendSchema>;
-
 export type OrderItemFulfillment = z.infer<typeof orderItemFulfillmentSchema>;
 
 export const orderItemSchema = z.object({
@@ -93,10 +60,24 @@ export const orderItemSchema = z.object({
   productName: z.string(),
   optionId: z.string().nullable(),
   optionName: z.string().nullable(),
+  optionSelections: z
+    .array(optionSelectionSchema)
+    .optional()
+    .default([])
+    .describe(
+      "주문 시점 옵션 선택(이슈 #59) — 조합 옵션(옵션명마다 한 칸, 추가금 0)과 추가 선택(값의 추가금). 옵션이 없거나 이 필드 이전 주문은 빈 배열. 서버는 항상 싣는다",
+    ),
+  customInputs: z
+    .array(customInputValueSchema)
+    .optional()
+    .default([])
+    .describe(
+      "구매자가 적은 직접 입력값(주문 시점 항목명과 값, 이슈 #59). 없으면 빈 배열. 서버는 항상 싣는다",
+    ),
   sellerCode: z.string().nullable(),
   fulfillmentSnapshot: orderItemFulfillmentSnapshotResponseSchema.describe(
     "주문 시점 이행 스냅샷(이슈 #57). `type`이 주문 시점 상품 유형이다. 배송 상품이 아니면 발송·배송완료 대신 제공 처리를 하고, " +
-      "`DELIVERED`는 제공 완료(방문 수령은 수령 완료)다. 상품을 나중에 고쳐도 바뀌지 않는다. 실제 제공 기록은 `fulfillment`에 있다",
+      "`DELIVERED`는 제공 완료다. 상품을 나중에 고쳐도 바뀌지 않는다. 제공 기록은 `fulfillment`에 있다",
   ),
   quantity: z.number().int().describe("주문 수량"),
   canceledQuantity: z
@@ -128,7 +109,7 @@ export const orderItemSchema = z.object({
     .optional()
     .default(null)
     .describe(
-      "비실물 상품의 제공 정보(이슈 #48). 제공 전이거나 배송 상품이면 null이다. 코드 평문·파일 주소는 싣지 않는다. 서버는 항상 싣는다",
+      "배송 없는 상품의 제공 기록(이슈 #48). 제공 전이거나 배송 상품이면 null이다. 서버는 항상 싣는다",
     ),
   autoDecisionDate: z.string().nullable(),
   sellerMemo: z.string().nullable(),
@@ -242,14 +223,6 @@ export const orderSchema = z.object({
         "현금영수증. 구매자가 계좌이체·가상계좌 결제에서 신청했을 때만 있고 그 밖에는 null. 서버는 항상 싣는다",
       ),
   }),
-  withdrawalAgreedAt: z
-    .string()
-    .nullable()
-    .optional()
-    .default(null)
-    .describe(
-      "청약철회 제한 안내에 동의한 시각(이슈 #48). 제한 상품이 없던 주문은 null. 서버는 항상 싣는다",
-    ),
   testPayment: z
     .boolean()
     .describe(
@@ -298,7 +271,7 @@ export const orderListQuerySchema = z.object({
     .string()
     .optional()
     .describe(
-      "상품 유형 필터(이슈 #48) — 이 유형(`SHIPPING`·`DOWNLOAD`·`CODE`·`SERVICE`·`PICKUP`)의 주문상품이 하나라도 있는 주문",
+      "상품 유형 필터(이슈 #48) — 이 유형(`SHIPPING`·`MANUAL`)의 주문상품이 하나라도 있는 주문",
     ),
   testPayment: testPaymentQuery,
   ...pageQuery,
@@ -489,7 +462,7 @@ export const cancelBySellerRequestSchema = z.object({
 export type CancelBySellerRequest = z.infer<typeof cancelBySellerRequestSchema>;
 
 /**
- * 제공 처리 요청 (이슈 #48) — `POST /v1/order-items/{orderItemId}/fulfill`. 수동 제공 비실물 주문상품(이용권·방문 수령 등)을
+ * 제공 처리 요청 (이슈 #48) — `POST /v1/order-items/{orderItemId}/fulfill`. 배송 없는 주문상품(`MANUAL`)을
  * 제공 완료(`DELIVERED`)로 바꾼다.
  */
 export const fulfillRequestSchema = z.object({
@@ -499,15 +472,6 @@ export const fulfillRequestSchema = z.object({
     .max(1000)
     .optional()
     .describe("구매자에게 보일 이용 안내(예: 예약 방법, 수령 장소). 주문 상세에 실린다"),
-  codes: z
-    .array(z.string().trim().min(1).max(MAX_CODE_LENGTH))
-    .min(1)
-    .max(100)
-    .optional()
-    .describe(
-      "수동 제공 코드 발급 상품의 코드 — 셀러 시스템이 발급한 코드를 넘긴다. 남은 수량만큼 보낸다(`CODE_COUNT_MISMATCH`). " +
-        "암호화해 저장하고 구매자가 열람할 때만 평문으로 나간다. 다른 유형은 보내지 않는다",
-    ),
 });
 
 export type FulfillRequest = z.infer<typeof fulfillRequestSchema>;