@sayren/mcp 0.8.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/mcp",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "type": "module",
   "bin": {
     "sayren-mcp": "./dist/index.mjs"
@@ -12,8 +12,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.22.0",
     "zod": "^4.6.5",
-    "@sayren/store-sdk": "^0.17.0",
-    "@sayren/storefront-sdk": "^0.14.0"
+    "@sayren/store-sdk": "^0.18.0",
+    "@sayren/storefront-sdk": "^0.15.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.14",

package/template/.template-meta.json

@@ -8,8 +8,8 @@
   },
   "versions": {
     "@sayren/contracts": "0.1.0",
-    "@sayren/store-sdk": "0.17.0",
-    "@sayren/storefront-sdk": "0.14.0",
+    "@sayren/store-sdk": "0.18.0",
+    "@sayren/storefront-sdk": "0.15.0",
     "@sayren/ui": "0.1.0"
   }
 }

package/template/src/components/fulfillment-codes.tsx

@@ -24,7 +24,7 @@ export function FulfillmentCodes({
   const [pending, setPending] = useState(false);
   const [error, setError] = useState<string | null>(null);
   const codes = item.fulfillment?.status === "FULFILLED" ? (item.fulfillment.codes ?? []) : [];
-  if (item.fulfillmentType !== "CODE" || codes.length === 0) return null;
+  if (item.fulfillmentSnapshot.type !== "CODE" || codes.length === 0) return null;
 
   const open = async () => {
     setPending(true);

package/template/src/components/fulfillment-downloads.tsx

@@ -22,7 +22,7 @@ export function FulfillmentDownloads({
   const [remaining, setRemaining] = useState<number | null>(null);
   const [error, setError] = useState<string | null>(null);
   const info = item.fulfillment?.status === "FULFILLED" ? item.fulfillment.download : null;
-  if (item.fulfillmentType !== "DOWNLOAD" || !info) return null;
+  if (item.fulfillmentSnapshot.type !== "DOWNLOAD" || !info) return null;
 
   const left = remaining ?? Math.max(info.limit - info.count, 0);
   const expired = info.expiresAt !== null && new Date(info.expiresAt).getTime() <= Date.now();

package/template/src/lib/order-status.test.ts

@@ -1,29 +1,44 @@
 import { describe, expect, it } from "vitest";
 import { orderItemStatusLabel, withdrawalRestrictedLabel } from "./order-status";
 
+const SHIPPING = { type: "SHIPPING", requiresShipping: true } as const;
+const SERVICE = { type: "SERVICE", requiresShipping: false } as const;
+const PICKUP = { type: "PICKUP", requiresShipping: false } as const;
+
 describe("주문 상품 상태 라벨", () => {
   it("배송 상품은 배송 단계로 보인다", () => {
     expect(orderItemStatusLabel("DELIVERED")).toBe("배송 완료");
-    expect(orderItemStatusLabel("DELIVERED", "SHIPPING")).toBe("배송 완료");
-    expect(orderItemStatusLabel("CONFIRMED", "SHIPPING")).toBe("발송 준비");
+    expect(orderItemStatusLabel("DELIVERED", SHIPPING)).toBe("배송 완료");
+    expect(orderItemStatusLabel("CONFIRMED", SHIPPING)).toBe("발송 준비");
   });
 
   it("배송이 없는 상품의 DELIVERED는 제공 완료, 방문 수령은 수령 완료다", () => {
-    expect(orderItemStatusLabel("DELIVERED", "SERVICE")).toBe("제공 완료");
-    expect(orderItemStatusLabel("DELIVERED", "PICKUP")).toBe("수령 완료");
-    expect(orderItemStatusLabel("CONFIRMED", "SERVICE")).toBe("준비 중");
-    expect(orderItemStatusLabel("PAID", "PICKUP")).toBe("결제 완료");
+    expect(orderItemStatusLabel("DELIVERED", SERVICE)).toBe("제공 완료");
+    expect(orderItemStatusLabel("DELIVERED", PICKUP)).toBe("수령 완료");
+    expect(orderItemStatusLabel("CONFIRMED", SERVICE)).toBe("준비 중");
+    expect(orderItemStatusLabel("PAID", PICKUP)).toBe("결제 완료");
+    // 모르는 유형도 배송 여부로 가른다
+    expect(orderItemStatusLabel("DELIVERED", { type: "OTHER", requiresShipping: false })).toBe(
+      "제공 완료",
+    );
   });
 
   it("모르는 상태는 코드 그대로다", () => {
-    expect(orderItemStatusLabel("ON_HOLD", "SERVICE")).toBe("ON_HOLD");
+    expect(orderItemStatusLabel("ON_HOLD", SERVICE)).toBe("ON_HOLD");
   });
 });
 
 describe("청약철회 제한 표시", () => {
   it("제한 주문상품에만 라벨을 붙인다", () => {
-    expect(withdrawalRestrictedLabel({ withdrawalRestricted: true })).toBe("청약철회 제한 상품");
-    expect(withdrawalRestrictedLabel({ withdrawalRestricted: false })).toBeNull();
-    expect(withdrawalRestrictedLabel({})).toBeNull();
+    const download = (withdrawalRestricted: boolean) => ({
+      fulfillmentSnapshot: {
+        type: "DOWNLOAD" as const,
+        requiresShipping: false as const,
+        download: { withdrawalRestricted },
+      },
+    });
+    expect(withdrawalRestrictedLabel(download(true))).toBe("청약철회 제한 상품");
+    expect(withdrawalRestrictedLabel(download(false))).toBeNull();
+    expect(withdrawalRestrictedLabel({ fulfillmentSnapshot: SERVICE })).toBeNull();
   });
 });

package/template/src/lib/order-status.ts

@@ -1,4 +1,8 @@
-import { isShippingFulfillment, type OrderItemStatus } from "@sayren/storefront-sdk";
+import {
+  type MyOrderItemFulfillmentSnapshot,
+  type OrderItemStatus,
+  withdrawalRestrictedOfView,
+} from "@sayren/storefront-sdk";
 
 /** 주문 상품 상태 라벨 — 화면에 코드 대신 보인다. 서버가 상태를 더하면 코드 그대로 보인다 */
 const ORDER_ITEM_STATUS_LABELS: Record<OrderItemStatus, string> = {
@@ -22,9 +26,16 @@ function nonShippingLabel(status: string, fulfillmentType: string): string | nul
   return null;
 }
 
-export function orderItemStatusLabel(status: string, fulfillmentType?: string | null): string {
-  if (fulfillmentType && !isShippingFulfillment(fulfillmentType)) {
-    const label = nonShippingLabel(status, fulfillmentType);
+/**
+ * 주문 상품 상태 라벨. `fulfillment`는 주문상품의 `fulfillmentSnapshot`(주문 시점 이행)이다 — 배송이 없는 상품은 제공 단계로
+ * 보인다. 모르는 유형도 `requiresShipping`으로 가른다
+ */
+export function orderItemStatusLabel(
+  status: string,
+  fulfillment?: Pick<MyOrderItemFulfillmentSnapshot, "type" | "requiresShipping"> | null,
+): string {
+  if (fulfillment && !fulfillment.requiresShipping) {
+    const label = nonShippingLabel(status, fulfillment.type);
     if (label) return label;
   }
   return ORDER_ITEM_STATUS_LABELS[status as OrderItemStatus] ?? status;
@@ -34,8 +45,10 @@ export function orderItemStatusLabel(status: string, fulfillmentType?: string |
  * 청약철회 제한 주문상품(이슈 #48) — 구매자가 결제 전에 동의했고, 제공이 시작되면(첫 다운로드·열람) 단순 변심 취소·반품을
  * 받지 않는다. 주문 상세·비회원 주문 조회가 상품 옆에 붙인다.
  */
-export function withdrawalRestrictedLabel(item: { withdrawalRestricted?: boolean }): string | null {
-  return item.withdrawalRestricted ? "청약철회 제한 상품" : null;
+export function withdrawalRestrictedLabel(item: {
+  fulfillmentSnapshot: MyOrderItemFulfillmentSnapshot;
+}): string | null {
+  return withdrawalRestrictedOfView(item.fulfillmentSnapshot) ? "청약철회 제한 상품" : null;
 }
 
 /** 제공이 시작된 청약철회 제한 상품의 취소·반품 접수 거절(409 `WITHDRAWAL_RESTRICTED`) 안내 */

package/template/src/routes/guest-order.tsx

@@ -215,7 +215,7 @@ function GuestOrder() {
                       <span className="text-muted text-xs">{item.optionName}</span>
                     ) : null}
                     <span className="text-muted text-xs">
-                      {orderItemStatusLabel(item.status, item.fulfillmentType)} · 수량{" "}
+                      {orderItemStatusLabel(item.status, item.fulfillmentSnapshot)} · 수량{" "}
                       {item.quantity}개
                     </span>
                     {withdrawalRestrictedLabel(item) ? (

package/template/src/routes/orders.$orderId.tsx

@@ -230,7 +230,8 @@ function OrderDetail() {
                   <span className="text-muted text-xs">{item.optionName}</span>
                 ) : null}
                 <span className="text-muted text-xs">
-                  {orderItemStatusLabel(item.status, item.fulfillmentType)} · 수량 {item.quantity}개
+                  {orderItemStatusLabel(item.status, item.fulfillmentSnapshot)} · 수량{" "}
+                  {item.quantity}개
                   {item.canceledQuantity > 0
                     ? ` · 취소·반품 ${item.canceledQuantity}개 · 남은 수량 ${item.activeQuantity}개`
                     : null}
@@ -313,7 +314,9 @@ function OrderDetail() {
  * 배송 상품이거나 보여 줄 것이 없으면 그리지 않는다. 배송 상품이 아니므로 배송 조회 링크가 없다.
  */
 function FulfillmentInfo({ item }: { item: MyOrderItem }) {
-  const pickup = item.fulfillmentType === "PICKUP" ? item.pickupLocation : null;
+  const snapshot = item.fulfillmentSnapshot;
+  // 수령 장소는 주문 시점 스냅샷이다 — 셀러가 나중에 수령지를 바꿔도 이 주문의 안내는 그대로다
+  const pickup = snapshot.type === "PICKUP" ? snapshot.pickup.location : null;
   const note = item.fulfillment?.status === "FULFILLED" ? item.fulfillment.note : null;
   if (!pickup && !note) return null;
   return (

package/template/src/routes/products.$productId.tsx

@@ -1,4 +1,4 @@
-import { ApiError } from "@sayren/storefront-sdk";
+import { ApiError, type ProductFulfillmentView } from "@sayren/storefront-sdk";
 import { createFileRoute, Link, notFound, useNavigate } from "@tanstack/react-router";
 import { createServerFn } from "@tanstack/react-start";
 import { useState } from "react";
@@ -59,6 +59,27 @@ export const Route = createFileRoute("/products/$productId")({
   component: ProductDetail,
 });
 
+/** 상품 상세의 받는 방법 한 줄 — 배송 상품은 배송비·예상 기간, 그 밖의 유형은 배송 없이 받는 방법이다 */
+function deliveryNoteOf(fulfillment: ProductFulfillmentView): string {
+  switch (fulfillment.type) {
+    case "SHIPPING": {
+      const { deliveryType, deliveryFee, estimatedDays } = fulfillment.shipping;
+      const fee = deliveryType === "FREE" ? "무료배송" : `배송비 ${formatPrice(deliveryFee)}`;
+      return estimatedDays ? `${fee} · ${estimatedDays}` : fee;
+    }
+    case "DOWNLOAD":
+      return "결제 후 바로 내려받기";
+    case "CODE":
+      return "결제 후 코드 제공";
+    case "PICKUP":
+      return fulfillment.pickup.location
+        ? `방문 수령 · ${fulfillment.pickup.location.name}`
+        : "방문 수령";
+    default:
+      return fulfillment.requiresShipping ? "택배 배송" : "배송 없이 제공";
+  }
+}
+
 function ProductDetail() {
   const product = Route.useLoaderData();
   useTrack({ name: "product_view", productId: product.productId });
@@ -98,12 +119,7 @@ function ProductDetail() {
         <div className="space-y-2">
           <h1 className="font-bold text-2xl">{product.name}</h1>
           <p className="font-bold text-xl">{formatPrice(price)}</p>
-          <p className="text-muted text-sm">
-            {product.delivery.type === "FREE"
-              ? "무료배송"
-              : `배송비 ${formatPrice(product.delivery.fee)}`}
-            {product.delivery.estimatedDays ? ` · ${product.delivery.estimatedDays}` : ""}
-          </p>
+          <p className="text-muted text-sm">{deliveryNoteOf(product.fulfillment)}</p>
         </div>
 
         <form