@sayren/storefront-sdk 0.14.0 → 0.16.0

package/src/schemas/order.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { easyPayProviderResponseSchema, paymentMethodSchema } from "./checkout";
-import { fulfillmentTypeField, orderItemStatusSchema, requiresShippingField } from "./common";
+import { orderItemStatusSchema } from "./common";
+import { myOrderItemFulfillmentSnapshotSchema } from "./fulfillment";
 
 export const myOrderItemSchema = z.object({
   orderItemId: z.string(),
@@ -30,77 +31,25 @@ export const myOrderItemSchema = z.object({
       "이 주문상품에 배분된 쿠폰 할인. 실결제 금액은 `totalPrice − couponDiscountAmount`다. 쿠폰이 없으면 0. 서버는 항상 싣는다",
     ),
   status: orderItemStatusSchema,
-  fulfillmentType: fulfillmentTypeField(),
-  withdrawalRestricted: z
-    .boolean()
-    .optional()
-    .default(false)
-    .describe(
-      "청약철회 제한 주문상품인가(이슈 #48). 구매자가 결제 전에 동의했고 제공이 시작되면(다운로드·열람·이용 시작) 구매자 취소·반품을 받지 않는다. 서버는 항상 싣는다",
-    ),
+  fulfillmentSnapshot: myOrderItemFulfillmentSnapshotSchema.describe(
+    "주문 시점 이행 스냅샷(이슈 #57). `type`이 주문 시점 상품 유형이다. 배송 없는 상품(`MANUAL`)이면 `DELIVERED`는 제공 완료다",
+  ),
   fulfillment: z
     .object({
       status: z
         .string()
         .describe(
-          "제공 상태. `FULFILLED`(제공함)·`REVOKED`(환불 등으로 회수함). 값이 추가될 수 있어 문자열로 받는다",
+          "제공 상태. `FULFILLED`(제공함)·`REVOKED`(전량 취소·환불로 회수함). 값이 추가될 수 있어 문자열로 받는다",
         ),
       fulfilledAt: z.string().describe("제공 시각 (ISO 8601)"),
-      note: z.string().nullable().describe("셀러가 남긴 이용 안내. 없으면 null"),
-      codes: z
-        .array(
-          z.object({
-            codeId: z.string(),
-            hint: z.string().describe("가린 코드 — 끝 4자만 보인다(예: `****AB12`)"),
-            revealedAt: z.string().nullable().describe("처음 열람한 시각. 열람 전이면 null"),
-          }),
-        )
-        .optional()
-        .default([])
-        .describe(
-          "코드 발급 상품의 코드(가린 값). 평문은 `fulfillment/reveal`로 연다. 환불로 회수된 코드는 싣지 않는다. 서버는 항상 싣는다",
-        ),
-      download: z
-        .object({
-          count: z.number().int().describe("지금까지 받은 횟수"),
-          limit: z.number().int().describe("받을 수 있는 횟수"),
-          expiresAt: z.string().nullable().describe("받을 수 있는 기한 (ISO 8601)"),
-          files: z.array(
-            z.object({
-              assetId: z.string(),
-              fileName: z.string(),
-              sizeBytes: z.number().int().nullable(),
-            }),
-          ),
-        })
-        .nullable()
-        .optional()
-        .default(null)
-        .describe(
-          "파일 다운로드 상품의 횟수·기한·파일 목록. 파일 주소는 `downloads`로 받는다. 다른 유형은 null. 서버는 항상 싣는다",
-        ),
+      note: z.string().nullable().describe("판매자가 제공 처리 때 남긴 이용 안내. 없으면 null"),
     })
     .nullable()
     .optional()
     .default(null)
     .describe(
-      "비실물 상품(이용권·방문 수령 등)의 제공 정보(이슈 #48). 제공 전이거나 배송 상품이면 null이다. " +
-        "비실물의 `DELIVERED`는 제공 완료(방문 수령은 수령 완료)로 표시한다. 서버는 항상 싣는다",
-    ),
-  pickupLocation: z
-    .object({
-      name: z.string().describe("수령 장소 이름"),
-      zipCode: z.string(),
-      address1: z.string(),
-      address2: z.string().nullable(),
-      phone: z.string().describe("수령 장소 연락처"),
-    })
-    .nullable()
-    .optional()
-    .default(null)
-    .describe(
-      "방문 수령 장소(이슈 #48). 방문 수령 상품(`fulfillmentType` = `PICKUP`)이고 셀러가 수령지를 지정했을 때만 있다. " +
-        "상품의 현재 수령지다. 서버는 항상 싣는다",
+      "배송 없는 상품의 제공 기록(이슈 #48). 제공 전이거나 배송 상품이면 null이다. " +
+        "배송 없는 상품의 `DELIVERED`는 제공 완료로 표시한다. 서버는 항상 싣는다",
     ),
   claimStatus: z.string().nullable(),
   reviewWritten: z.boolean(),
@@ -132,9 +81,11 @@ export const myOrderSchema = z.object({
   orderId: z.string(),
   orderedAt: z.string(),
   items: z.array(myOrderItemSchema),
-  requiresShipping: requiresShippingField(
-    "택배 배송이 필요한 주문상품이 있는가. false면 `shippingAddress`는 주문자 이름·연락처만 있고 주소는 빈 문자열이다.",
-  ),
+  requiresShipping: z
+    .boolean()
+    .describe(
+      "택배 배송이 필요한 주문상품이 있는가. false면 `shippingAddress`는 주문자 이름·연락처만 있고 주소는 빈 문자열이다",
+    ),
   shippingAddress: orderShippingAddressSchema,
   payment: z.object({
     method: paymentMethodSchema.describe(
@@ -181,14 +132,6 @@ export const myOrderSchema = z.object({
     paidAt: z.string().nullable(),
     receiptUrl: z.url().nullable(),
   }),
-  withdrawalAgreedAt: z
-    .string()
-    .nullable()
-    .optional()
-    .default(null)
-    .describe(
-      "청약철회 제한 안내에 동의한 시각(이슈 #48). 제한 상품이 없던 주문은 null. 서버는 항상 싣는다",
-    ),
   testPayment: z
     .boolean()
     .describe(
@@ -255,43 +198,3 @@ export const purchaseDecisionResultSchema = z.object({
 });
 
 export type PurchaseDecisionResult = z.infer<typeof purchaseDecisionResultSchema>;
-
-/**
- * 코드 열람 응답 (이슈 #48) — `POST /storefront/v1/me/order-items/{orderItemId}/fulfillment/reveal`(회원)·
- * `POST /storefront/v1/guest/orders/{orderId}/order-items/{orderItemId}/fulfillment/reveal`(비회원).
- * 평문 코드는 이 응답에만 있다. 화면에 보인 뒤 저장하지 않는다(응답은 `Cache-Control: no-store`).
- * 첫 열람 시각은 청약철회 판단의 근거(제공 개시)로 남는다.
- */
-export const fulfillmentRevealSchema = z.object({
-  orderItemId: z.string(),
-  codes: z.array(
-    z.object({
-      codeId: z.string(),
-      code: z.string().describe("코드 평문"),
-      revealedAt: z.string().describe("처음 열람한 시각"),
-    }),
-  ),
-});
-
-export type FulfillmentReveal = z.infer<typeof fulfillmentRevealSchema>;
-
-/**
- * 다운로드 요청 (이슈 #48) — `POST /storefront/v1/me/order-items/{orderItemId}/downloads`(회원)·
- * `POST /storefront/v1/guest/orders/{orderId}/order-items/{orderItemId}/downloads`(비회원, 연락처·비밀번호를 함께 보낸다).
- * 파일이 하나면 `assetId`를 생략할 수 있다.
- */
-export const downloadRequestSchema = z.object({
-  assetId: z.string().min(1).max(64).optional().describe("받을 파일. 파일이 여러 개면 필수다"),
-});
-
-export type DownloadRequest = z.infer<typeof downloadRequestSchema>;
-
-/** 다운로드 응답 — 수명 300초의 서명 주소. 받을 때마다 횟수가 하나 준다 */
-export const downloadLinkSchema = z.object({
-  url: z.url().describe("서명 주소. 300초 뒤 만료된다 — 받아서 바로 쓰고 저장하지 않는다"),
-  expiresAt: z.string().describe("서명 주소 만료 시각"),
-  fileName: z.string(),
-  remaining: z.number().int().describe("남은 다운로드 횟수"),
-});
-
-export type DownloadLink = z.infer<typeof downloadLinkSchema>;