@sayren/mcp 0.12.0 → 0.13.0

package/dist/index.mjs

@@ -283,7 +283,7 @@ function describeWriteResult(result) {
 
 //#endregion
 //#region package.json
-var version = "0.12.0";
+var version = "0.13.0";
 
 //#endregion
 //#region src/user-agent.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/mcp",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "type": "module",
   "bin": {
     "sayren-mcp": "./dist/index.mjs"
@@ -12,8 +12,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.22.0",
     "zod": "^4.6.5",
-    "@sayren/storefront-sdk": "^0.15.0",
-    "@sayren/store-sdk": "^0.19.0"
+    "@sayren/store-sdk": "^0.20.0",
+    "@sayren/storefront-sdk": "^0.16.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.19.0",
-    "@sayren/storefront-sdk": "0.15.0",
+    "@sayren/store-sdk": "0.20.0",
+    "@sayren/storefront-sdk": "0.16.0",
     "@sayren/ui": "0.1.0"
   }
 }

package/template/src/lib/form-schemas.test.ts

@@ -1,10 +1,5 @@
 import { describe, expect, it } from "vitest";
-import {
-  checkoutFormSchema,
-  guestOrderLookupSchema,
-  signupFormSchema,
-  WITHDRAWAL_AGREEMENT_MESSAGE,
-} from "./form-schemas";
+import { checkoutFormSchema, guestOrderLookupSchema, signupFormSchema } from "./form-schemas";
 
 const messageOf = (result: { success: boolean; error?: { issues: { message: string }[] } }) =>
   result.error?.issues[0]?.message;
@@ -119,21 +114,6 @@ describe("주문서 폼", () => {
     expect(messageOf(result)).toBe("주문 조회 비밀번호는 6자 이상이어야 합니다");
   });
 
-  it("청약철회 제한 상품이 있으면 동의를 요구하고, 없으면 묻지 않는다", () => {
-    const restricted = checkoutFormSchema({
-      guest: false,
-      cashReceiptOptionKeys: cashKeys,
-      withdrawal: true,
-    });
-    expect(messageOf(restricted.safeParse({ ...shipping, withdrawalAgreed: false }))).toBe(
-      WITHDRAWAL_AGREEMENT_MESSAGE,
-    );
-    expect(restricted.safeParse({ ...shipping }).success).toBe(false);
-    expect(restricted.safeParse({ ...shipping, withdrawalAgreed: true }).success).toBe(true);
-    const plain = checkoutFormSchema({ guest: false, cashReceiptOptionKeys: cashKeys });
-    expect(plain.safeParse({ ...shipping, withdrawalAgreed: false }).success).toBe(true);
-  });
-
   it("현금영수증은 받을 수 있는 결제 옵션에서 신청했을 때만 번호를 검사한다", () => {
     const schema = checkoutFormSchema({ guest: false, cashReceiptOptionKeys: cashKeys });
     const on = { ...shipping, cashReceiptOn: true, cashReceiptNumber: "12" };

package/template/src/lib/form-schemas.ts

@@ -63,24 +63,17 @@ export type GuestOrderLookup = z.output<typeof guestOrderLookupSchema>;
 
 // ── 주문서 ───────────────────────────────────────────────────────────────
 
-/** 청약철회 제한 동의 누락 — 폼 검사와 서버 400 `WITHDRAWAL_AGREEMENT_REQUIRED`가 같은 문구를 쓴다 */
-export const WITHDRAWAL_AGREEMENT_MESSAGE = "청약철회 제한 안내에 동의해 주십시오";
-
 /**
  * 주문서 폼. 비회원 주문 정보는 비회원일 때만 받고, 현금영수증은 계좌이체·가상계좌 옵션을 골랐고 신청을 켰을 때만
  * 검사한다(`cashReceiptOptionKeys`는 그런 결제 옵션의 키).
  *
- * 배송지는 주문서의 `requiresShipping`이 true일 때만 받는다(`shipping`, 생략하면 true). 배송이 필요 없는 주문(이용권·방문
- * 수령 등)은 배송지 칸이 없고, 연락처는 비회원 주문자 연락처로만 받는다.
- *
- * 청약철회 제한 동의는 주문서의 `withdrawal.required`가 true일 때만 요구한다(`withdrawal`, 생략하면 false). 결제 시작이
- * `withdrawalAgreement: true`로 보낸다.
+ * 배송지는 주문서의 `requiresShipping`이 true일 때만 받는다(`shipping`, 생략하면 true). 배송이 필요 없는 주문(배송 없는
+ * 상품만 담은 주문)은 배송지 칸이 없고, 연락처는 비회원 주문자 연락처로만 받는다.
  */
 export function checkoutFormSchema(options: {
   guest: boolean;
   cashReceiptOptionKeys: ReadonlySet<string>;
   shipping?: boolean;
-  withdrawal?: boolean;
 }) {
   const shipping = shippingAddressInputSchema.shape;
   const address = options.shipping ?? true;
@@ -105,10 +98,6 @@ export function checkoutFormSchema(options: {
       cashReceiptOn: z.boolean(),
       cashReceiptType: cashReceiptTypeSchema,
       cashReceiptNumber: z.string().optional(),
-      // 체크박스는 체크 전 false다 — 제한 상품이 있는 주문만 true를 요구한다
-      withdrawalAgreed: options.withdrawal
-        ? z.boolean().refine((agreed) => agreed, WITHDRAWAL_AGREEMENT_MESSAGE)
-        : z.boolean().optional(),
     })
     .superRefine((value, ctx) => {
       if (!value.cashReceiptOn || !options.cashReceiptOptionKeys.has(value.paymentOption)) return;

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

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { guestLookupLockedMessage } from "./guest-order";
+import { guestLookupLockedMessage, normalizePhone } from "./guest-order";
 
 describe("guestLookupLockedMessage", () => {
   it("남은 시간을 분 단위로 올려 알린다", () => {
@@ -16,3 +16,9 @@ describe("guestLookupLockedMessage", () => {
     expect(guestLookupLockedMessage("30")).toContain("잠시 후");
   });
 });
+
+describe("normalizePhone", () => {
+  it("숫자만 남긴다", () => {
+    expect(normalizePhone("010-1234 5678")).toBe("01012345678");
+  });
+});

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

@@ -11,3 +11,8 @@ export function guestLookupLockedMessage(retryAfterSeconds: unknown): string {
     ? `조회 시도가 너무 많습니다. ${minutes}분 뒤에 다시 시도해 주십시오`
     : "조회 시도가 너무 많습니다. 잠시 후 다시 시도해 주십시오";
 }
+
+/** 비회원 조회에 싣는 연락처 — 숫자만 남긴다 */
+export function normalizePhone(phone: string): string {
+  return phone.replace(/[^0-9]/g, "");
+}

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

@@ -1,9 +1,8 @@
 import { describe, expect, it } from "vitest";
-import { orderItemStatusLabel, withdrawalRestrictedLabel } from "./order-status";
+import { orderItemStatusLabel } 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;
+const MANUAL = { type: "MANUAL", requiresShipping: false } as const;
 
 describe("주문 상품 상태 라벨", () => {
   it("배송 상품은 배송 단계로 보인다", () => {
@@ -12,11 +11,10 @@ describe("주문 상품 상태 라벨", () => {
     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("결제 완료");
+  it("배송이 없는 상품의 DELIVERED는 제공 완료다", () => {
+    expect(orderItemStatusLabel("DELIVERED", MANUAL)).toBe("제공 완료");
+    expect(orderItemStatusLabel("CONFIRMED", MANUAL)).toBe("준비 중");
+    expect(orderItemStatusLabel("PAID", MANUAL)).toBe("결제 완료");
     // 모르는 유형도 배송 여부로 가른다
     expect(orderItemStatusLabel("DELIVERED", { type: "OTHER", requiresShipping: false })).toBe(
       "제공 완료",
@@ -24,21 +22,6 @@ describe("주문 상품 상태 라벨", () => {
   });
 
   it("모르는 상태는 코드 그대로다", () => {
-    expect(orderItemStatusLabel("ON_HOLD", SERVICE)).toBe("ON_HOLD");
-  });
-});
-
-describe("청약철회 제한 표시", () => {
-  it("제한 주문상품에만 라벨을 붙인다", () => {
-    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();
+    expect(orderItemStatusLabel("ON_HOLD", MANUAL)).toBe("ON_HOLD");
   });
 });

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

@@ -1,8 +1,4 @@
-import {
-  type MyOrderItemFulfillmentSnapshot,
-  type OrderItemStatus,
-  withdrawalRestrictedOfView,
-} from "@sayren/storefront-sdk";
+import type { MyOrderItemFulfillmentSnapshot, OrderItemStatus } from "@sayren/storefront-sdk";
 
 /** 주문 상품 상태 라벨 — 화면에 코드 대신 보인다. 서버가 상태를 더하면 코드 그대로 보인다 */
 const ORDER_ITEM_STATUS_LABELS: Record<OrderItemStatus, string> = {
@@ -17,12 +13,11 @@ const ORDER_ITEM_STATUS_LABELS: Record<OrderItemStatus, string> = {
 };
 
 /**
- * 배송이 없는 상품(이용권·방문 수령 등)의 상태 라벨. 제공 완료는 `DELIVERED`를 그대로 쓰므로 표시만 바꾼다 —
- * 방문 수령은 「수령 완료」, 그 밖의 유형은 「제공 완료」다.
+ * 배송이 없는 상품의 상태 라벨. 판매자가 제공 처리하면 `DELIVERED`가 되므로 표시만 「제공 완료」로 바꾼다.
  */
-function nonShippingLabel(status: string, fulfillmentType: string): string | null {
+function nonShippingLabel(status: string): string | null {
   if (status === "CONFIRMED") return "준비 중";
-  if (status === "DELIVERED") return fulfillmentType === "PICKUP" ? "수령 완료" : "제공 완료";
+  if (status === "DELIVERED") return "제공 완료";
   return null;
 }
 
@@ -35,22 +30,8 @@ export function orderItemStatusLabel(
   fulfillment?: Pick<MyOrderItemFulfillmentSnapshot, "type" | "requiresShipping"> | null,
 ): string {
   if (fulfillment && !fulfillment.requiresShipping) {
-    const label = nonShippingLabel(status, fulfillment.type);
+    const label = nonShippingLabel(status);
     if (label) return label;
   }
   return ORDER_ITEM_STATUS_LABELS[status as OrderItemStatus] ?? status;
 }
-
-/**
- * 청약철회 제한 주문상품(이슈 #48) — 구매자가 결제 전에 동의했고, 제공이 시작되면(첫 다운로드·열람) 단순 변심 취소·반품을
- * 받지 않는다. 주문 상세·비회원 주문 조회가 상품 옆에 붙인다.
- */
-export function withdrawalRestrictedLabel(item: {
-  fulfillmentSnapshot: MyOrderItemFulfillmentSnapshot;
-}): string | null {
-  return withdrawalRestrictedOfView(item.fulfillmentSnapshot) ? "청약철회 제한 상품" : null;
-}
-
-/** 제공이 시작된 청약철회 제한 상품의 취소·반품 접수 거절(409 `WITHDRAWAL_RESTRICTED`) 안내 */
-export const WITHDRAWAL_RESTRICTED_CLAIM_MESSAGE =
-  "제공이 시작된 상품이라 취소·반품을 접수할 수 없습니다.";

package/template/src/routes/cart.tsx

@@ -168,7 +168,7 @@ function CartPage() {
             <dt className="text-muted">상품 금액</dt>
             <dd>{formatPrice(cart.summary.productAmount)}</dd>
           </div>
-          {/* 배송이 필요 없는 상품(이용권·방문 수령 등)만 담았으면 배송비가 없다 */}
+          {/* 배송이 필요 없는 상품만 담았으면 배송비가 없다 */}
           {cart.summary.requiresShipping ? (
             <div className="flex justify-between">
               <dt className="text-muted">배송비</dt>

package/template/src/routes/checkout.index.tsx

@@ -29,12 +29,7 @@ import {
   couponErrorMessage,
   couponRejectMessage,
 } from "../lib/coupon-code";
-import {
-  type CheckoutForm,
-  type CheckoutFormInput,
-  checkoutFormSchema,
-  WITHDRAWAL_AGREEMENT_MESSAGE,
-} from "../lib/form-schemas";
+import { type CheckoutForm, type CheckoutFormInput, checkoutFormSchema } from "../lib/form-schemas";
 import { formatPrice } from "../lib/format";
 import { pageTitle } from "../lib/page-title";
 import { forgetPaymentOptions, rememberPaymentOptions } from "../lib/payment-options";
@@ -132,7 +127,7 @@ const paymentForm = z.object({
   option: paymentOptionSchema,
   /** 결제에 실패하면 돌아올 주문서 주소 */
   back: z.string(),
-  /** 배송지를 보내는가 — 주문서의 `requiresShipping`. false면(이용권·방문 수령 등) 배송지를 싣지 않는다 */
+  /** 배송지를 보내는가 — 주문서의 `requiresShipping`. false면(배송 없는 상품만 담은 주문) 배송지를 싣지 않는다 */
   requiresShipping: z.boolean(),
   receiverName: z.string(),
   phone: z.string(),
@@ -147,8 +142,6 @@ const paymentForm = z.object({
   cashReceipt: cashReceiptRequestSchema.optional(),
   /** 적용한 쿠폰 코드 — 미리보기로 확인한 값 */
   couponCode: z.string().regex(COUPON_CODE_PATTERN).optional(),
-  /** 청약철회 제한 동의 — 주문서의 `withdrawal.required`가 true일 때 구매자가 체크한 값 */
-  withdrawalAgreement: z.boolean().optional(),
 });
 
 /** 결제 시작은 서버에서 한다 — 토큰이 브라우저 JS에 노출되지 않는다. 결제창 호출 값(공개 값)만 내려준다 */
@@ -184,8 +177,6 @@ const startPayment = createServerFn({ method: "POST" })
             },
         cashReceipt: data.cashReceipt,
         ...(data.couponCode ? { coupons: [{ code: data.couponCode }] } : {}),
-        // 제한 상품이 없는 주문은 보내지 않는다 — 빠지면 서버가 400 WITHDRAWAL_AGREEMENT_REQUIRED다
-        ...(data.withdrawalAgreement ? { withdrawalAgreement: true } : {}),
       });
       // 결제 시작 값은 JSON으로 넘기고 브라우저에서 SDK 스키마로 다시 읽는다 — 서버 함수 직렬화 타입에 맞춘다
       return { start: JSON.stringify(start), error: null, couponFailed: false };
@@ -220,8 +211,6 @@ function startErrorMessage(error: unknown): string {
       return "결제창을 준비하지 못했습니다. 다른 결제수단으로 시도해 주십시오.";
     case "PAYMENT_NOT_CONFIGURED":
       return "결제 수단을 준비하고 있습니다. 잠시 후 다시 시도해 주십시오.";
-    case "WITHDRAWAL_AGREEMENT_REQUIRED":
-      return WITHDRAWAL_AGREEMENT_MESSAGE;
     case "CASH_RECEIPT_NOT_AVAILABLE":
       return "현금영수증은 계좌이체·가상계좌 결제에서만 신청할 수 있습니다.";
     case "COUPON_NOT_APPLICABLE": {
@@ -259,10 +248,8 @@ function Checkout() {
   const [notice, setNotice] = useState<string | null>(null);
   const [submitting, setSubmitting] = useState(false);
   const options = checkout.paymentOptions;
-  /** 배송이 필요한 주문인가 — false면(이용권·방문 수령 등만 담은 주문) 배송지·배송비를 보이지 않는다 */
+  /** 배송이 필요한 주문인가 — false면(배송 없는 상품만 담은 주문) 배송지·배송비를 보이지 않는다 */
   const shipping = checkout.requiresShipping;
-  /** 청약철회 제한 상품(제공이 시작되면 취소·반품할 수 없는 파일·코드·이용권)이 있는가 — 결제 전에 안내하고 동의를 받는다 */
-  const withdrawal = checkout.withdrawal;
   const defaultOptionKey = options[0] ? paymentOptionKey(options[0]) : "";
   /**
    * 폼 스키마는 주문서마다 한 번 만든다 — 비회원 여부와 현금영수증을 받을 수 있는 결제 옵션이 주문서에서 정해진다.
@@ -273,12 +260,11 @@ function Checkout() {
       checkoutFormSchema({
         guest: !member,
         shipping,
-        withdrawal: withdrawal.required,
         cashReceiptOptionKeys: new Set(
           options.filter((option) => cashReceiptAvailable(option.method)).map(paymentOptionKey),
         ),
       }),
-    [member, options, shipping, withdrawal.required],
+    [member, options, shipping],
   );
   const form = useForm<CheckoutFormInput, unknown, CheckoutForm>({
     resolver: zodResolver(schema),
@@ -287,7 +273,6 @@ function Checkout() {
       paymentOption: defaultOptionKey,
       cashReceiptOn: false,
       cashReceiptType: "INCOME_DEDUCTION",
-      withdrawalAgreed: false,
     },
   });
   const { errors } = form.formState;
@@ -482,7 +467,6 @@ function Checkout() {
         orderPassword: values.orderPassword ?? "",
         cashReceipt,
         couponCode: coupon?.code,
-        withdrawalAgreement: withdrawal.required ? values.withdrawalAgreed === true : undefined,
       },
     })
       .then(async ({ start, error, couponFailed }) => {
@@ -515,7 +499,7 @@ function Checkout() {
   return (
     <div className="grid gap-8 md:grid-cols-[minmax(0,1.4fr)_minmax(0,1fr)] md:items-start">
       <form onSubmit={handleSubmit} className="space-y-6">
-        {/* 배송이 필요 없는 주문(이용권·방문 수령 등)은 배송지를 받지 않는다 */}
+        {/* 배송이 필요 없는 주문(배송 없는 상품만 담은 주문)은 배송지를 받지 않는다 */}
         {shipping ? (
           <section className="space-y-3">
             <h2 className="font-bold text-lg">배송지</h2>
@@ -723,24 +707,6 @@ function Checkout() {
           ) : null}
         </section>
 
-        {withdrawal.required ? (
-          <section className="space-y-3">
-            <h2 className="font-bold text-lg">청약철회 제한 안내</h2>
-            <p className="whitespace-pre-line rounded-md bg-chip px-3 py-2 text-sm">
-              {withdrawal.notice}
-            </p>
-            <label className="flex items-start gap-2 text-sm">
-              <input type="checkbox" className="mt-1" {...form.register("withdrawalAgreed")} />
-              <span>위 청약철회 제한 안내를 확인했으며 동의합니다</span>
-            </label>
-            {errors.withdrawalAgreed ? (
-              <p role="alert" className="text-point text-xs">
-                {errors.withdrawalAgreed.message}
-              </p>
-            ) : null}
-          </section>
-        ) : null}
-
         <SubmitButton
           disabled={submitting || couponBusy || options.length === 0}
           className="h-12 w-full rounded-md bg-ink font-semibold text-white disabled:opacity-50"

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

@@ -5,22 +5,18 @@ import { createServerFn } from "@tanstack/react-start";
 import { useState } from "react";
 import { useForm } from "react-hook-form";
 import { z } from "zod";
-import { FulfillmentCodes } from "../components/fulfillment-codes";
-import { FulfillmentDownloads } from "../components/fulfillment-downloads";
 import { ProductThumb } from "../components/product-thumb";
 import { SubmitButton } from "../components/submit-button";
 import { TextField } from "../components/text-field";
 import { apiFor } from "../lib/api.server";
-import { type CodeRevealResult, codeRevealErrorMessage, normalizePhone } from "../lib/code-reveal";
-import { type DownloadResult, downloadErrorMessage } from "../lib/download";
 import {
   type GuestOrderLookup,
   type GuestOrderLookupInput,
   guestOrderLookupSchema,
 } from "../lib/form-schemas";
 import { formatDateTime, formatPrice } from "../lib/format";
-import { guestLookupLockedMessage } from "../lib/guest-order";
-import { orderItemStatusLabel, withdrawalRestrictedLabel } from "../lib/order-status";
+import { guestLookupLockedMessage, normalizePhone } from "../lib/guest-order";
+import { orderItemStatusLabel } from "../lib/order-status";
 import { pageTitle } from "../lib/page-title";
 
 const guestOrderSearch = z.object({
@@ -58,58 +54,6 @@ const lookupGuestOrder = createServerFn({ method: "POST" })
     }
   });
 
-/**
- * 비회원 코드 열람 — 조회에 쓴 연락처·주문 조회 비밀번호로 다시 확인한다(주문 조회와 같은 시도 한도).
- * 비밀번호는 서버 함수 본문(POST)으로만 보내고 주소에 남기지 않는다.
- */
-const revealGuestCode = createServerFn({ method: "POST" })
-  .validator(
-    z.object({
-      orderId: z.string(),
-      orderItemId: z.string(),
-      phone: z.string(),
-      orderPassword: z.string(),
-    }),
-  )
-  .handler(async ({ data }): Promise<CodeRevealResult> => {
-    try {
-      const result = await apiFor().myOrders.revealGuestCode(data.orderId, data.orderItemId, {
-        phone: normalizePhone(data.phone),
-        orderPassword: data.orderPassword,
-      });
-      return { codes: result.codes, error: null };
-    } catch (error) {
-      return { codes: null, error: codeRevealErrorMessage(error) };
-    }
-  });
-
-/**
- * 비회원 파일 받기 — 조회에 쓴 연락처·주문 조회 비밀번호로 다시 확인하고 서명 주소(수명 300초)를 받는다. 받을 때마다
- * 횟수를 하나 쓴다. 비밀번호는 서버 함수 본문(POST)으로만 보내고 주소에 남기지 않는다.
- */
-const createGuestDownload = createServerFn({ method: "POST" })
-  .validator(
-    z.object({
-      orderId: z.string(),
-      orderItemId: z.string(),
-      assetId: z.string(),
-      phone: z.string(),
-      orderPassword: z.string(),
-    }),
-  )
-  .handler(async ({ data }): Promise<DownloadResult> => {
-    try {
-      const link = await apiFor().myOrders.createGuestDownload(data.orderId, data.orderItemId, {
-        phone: normalizePhone(data.phone),
-        orderPassword: data.orderPassword,
-        assetId: data.assetId,
-      });
-      return { url: link.url, fileName: link.fileName, remaining: link.remaining, error: null };
-    } catch (error) {
-      return { url: null, error: downloadErrorMessage(error) };
-    }
-  });
-
 export const Route = createFileRoute("/guest-order")({
   validateSearch: guestOrderSearch,
   head: ({ matches }) => ({
@@ -125,8 +69,6 @@ export const Route = createFileRoute("/guest-order")({
 function GuestOrder() {
   const { orderId } = Route.useSearch();
   const [order, setOrder] = useState<MyOrder | null>(null);
-  // 코드 열람에 다시 쓰는 조회 값 — 이 컴포넌트 상태에만 둔다(주소·스토리지에 남기지 않는다)
-  const [lookup, setLookup] = useState<GuestOrderLookup | null>(null);
   const [error, setError] = useState<string | null>(null);
   const form = useForm<GuestOrderLookupInput, unknown, GuestOrderLookup>({
     resolver: zodResolver(guestOrderLookupSchema),
@@ -138,11 +80,9 @@ function GuestOrder() {
     try {
       const result = await lookupGuestOrder({ data: values });
       setOrder(result.order);
-      setLookup(result.order ? values : null);
       setError(result.error);
     } catch {
       setOrder(null);
-      setLookup(null);
       setError("조회하지 못했습니다. 잠시 후 다시 시도해 주십시오");
     }
   });
@@ -218,42 +158,14 @@ function GuestOrder() {
                       {orderItemStatusLabel(item.status, item.fulfillmentSnapshot)} · 수량{" "}
                       {item.quantity}개
                     </span>
-                    {withdrawalRestrictedLabel(item) ? (
-                      <span className="text-muted text-xs">{withdrawalRestrictedLabel(item)}</span>
-                    ) : null}
                   </span>
                   <span>{formatPrice(item.totalPrice)}</span>
                 </div>
-                {lookup ? (
-                  <FulfillmentCodes
-                    item={item}
-                    reveal={() =>
-                      revealGuestCode({
-                        data: {
-                          orderId: order.orderId,
-                          orderItemId: item.orderItemId,
-                          phone: lookup.phone,
-                          orderPassword: lookup.orderPassword,
-                        },
-                      })
-                    }
-                  />
-                ) : null}
-                {lookup ? (
-                  <FulfillmentDownloads
-                    item={item}
-                    download={(assetId) =>
-                      createGuestDownload({
-                        data: {
-                          orderId: order.orderId,
-                          orderItemId: item.orderItemId,
-                          assetId,
-                          phone: lookup.phone,
-                          orderPassword: lookup.orderPassword,
-                        },
-                      })
-                    }
-                  />
+                {item.fulfillment?.status === "FULFILLED" && item.fulfillment.note ? (
+                  <dl className="space-y-0.5 rounded-md bg-chip p-3 text-xs">
+                    <dt className="font-semibold">이용 안내</dt>
+                    <dd className="whitespace-pre-line">{item.fulfillment.note}</dd>
+                  </dl>
                 ) : null}
               </li>
             ))}

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

@@ -11,19 +11,11 @@ import { createFileRoute, Link, notFound, redirect, useRouter } from "@tanstack/
 import { createServerFn } from "@tanstack/react-start";
 import { useState } from "react";
 import { z } from "zod";
-import { FulfillmentCodes } from "../components/fulfillment-codes";
-import { FulfillmentDownloads } from "../components/fulfillment-downloads";
 import { ProductThumb } from "../components/product-thumb";
 import { SubmitButton } from "../components/submit-button";
 import { apiFor } from "../lib/api.server";
-import { type CodeRevealResult, codeRevealErrorMessage } from "../lib/code-reveal";
-import { type DownloadResult, downloadErrorMessage } from "../lib/download";
 import { formatDateTime, formatPrice } from "../lib/format";
-import {
-  orderItemStatusLabel,
-  WITHDRAWAL_RESTRICTED_CLAIM_MESSAGE,
-  withdrawalRestrictedLabel,
-} from "../lib/order-status";
+import { orderItemStatusLabel } from "../lib/order-status";
 import { pageTitle } from "../lib/page-title";
 import { readToken } from "../lib/session.server";
 
@@ -42,42 +34,6 @@ const getOrder = createServerFn({ method: "GET" })
     }
   });
 
-/**
- * 코드 열람 — 코드 발급 상품의 평문 코드를 받는다. 처음 연 시각이 기록된다. 구매자 토큰은 서버에만 두므로 서버
- * 함수에서 부르고, 평문은 응답으로만 돌려준다(저장하지 않는다).
- */
-const revealCode = createServerFn({ method: "POST" })
-  .validator(z.object({ orderItemId: z.string() }))
-  .handler(async ({ data }): Promise<CodeRevealResult> => {
-    const accessToken = readToken();
-    if (!accessToken) throw redirect({ to: "/login", search: { redirectTo: "/orders" } });
-    try {
-      const result = await apiFor({ accessToken }).myOrders.revealCode(data.orderItemId);
-      return { codes: result.codes, error: null };
-    } catch (error) {
-      return { codes: null, error: codeRevealErrorMessage(error) };
-    }
-  });
-
-/**
- * 파일 받기 — 파일 다운로드 상품의 서명 주소(수명 300초)를 받는다. 받을 때마다 횟수를 하나 쓴다. 구매자 토큰은 서버에만
- * 두므로 서버 함수에서 부르고, 주소는 응답으로만 돌려준다(저장하지 않는다).
- */
-const createDownload = createServerFn({ method: "POST" })
-  .validator(z.object({ orderItemId: z.string(), assetId: z.string() }))
-  .handler(async ({ data }): Promise<DownloadResult> => {
-    const accessToken = readToken();
-    if (!accessToken) throw redirect({ to: "/login", search: { redirectTo: "/orders" } });
-    try {
-      const link = await apiFor({ accessToken }).myOrders.createDownload(data.orderItemId, {
-        assetId: data.assetId,
-      });
-      return { url: link.url, fileName: link.fileName, remaining: link.remaining, error: null };
-    } catch (error) {
-      return { url: null, error: downloadErrorMessage(error) };
-    }
-  });
-
 /**
  * 취소·반품 접수 — 수량을 실으면 그 수량만 접수된다(생략하면 남은 수량 전체).
  * 상한은 주문 상품의 `activeQuantity`이고 넘기면 서버가 400 `INVALID_QUANTITY`로 거절한다.
@@ -118,8 +74,6 @@ function claimErrorMessage(error: unknown): string {
       return "지금은 신청할 수 없는 상태입니다. 주문 상태를 확인해 주십시오.";
     case "PERIOD_EXPIRED":
       return "반품·교환 가능 기간이 지났습니다.";
-    case "WITHDRAWAL_RESTRICTED":
-      return WITHDRAWAL_RESTRICTED_CLAIM_MESSAGE;
     default:
       return error.message || "접수하지 못했습니다. 잠시 후 다시 시도해 주십시오.";
   }
@@ -236,24 +190,11 @@ function OrderDetail() {
                     ? ` · 취소·반품 ${item.canceledQuantity}개 · 남은 수량 ${item.activeQuantity}개`
                     : null}
                 </span>
-                {withdrawalRestrictedLabel(item) ? (
-                  <span className="text-muted text-xs">{withdrawalRestrictedLabel(item)}</span>
-                ) : null}
               </span>
               <span className="text-sm">{formatPrice(item.totalPrice)}</span>
             </div>
 
             <FulfillmentInfo item={item} />
-            <FulfillmentCodes
-              item={item}
-              reveal={() => revealCode({ data: { orderItemId: item.orderItemId } })}
-            />
-            <FulfillmentDownloads
-              item={item}
-              download={(assetId) =>
-                createDownload({ data: { orderItemId: item.orderItemId, assetId } })
-              }
-            />
 
             {claimableTypes(item.status).length > 0 &&
             !item.claimStatus &&
@@ -310,34 +251,16 @@ function OrderDetail() {
 }
 
 /**
- * 배송이 없는 상품의 받는 방법 — 방문 수령 장소와 셀러가 제공 처리하며 남긴 이용 안내(이슈 #48).
- * 배송 상품이거나 보여 줄 것이 없으면 그리지 않는다. 배송 상품이 아니므로 배송 조회 링크가 없다.
+ * 배송이 없는 상품의 이용 안내 — 판매자가 제공 처리하며 남긴 안내(이슈 #48). 배송 상품이거나 안내가 없으면 그리지 않는다.
+ * 배송 상품이 아니므로 배송 조회 링크가 없다.
  */
 function FulfillmentInfo({ item }: { item: MyOrderItem }) {
-  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;
+  if (!note) return null;
   return (
-    <dl className="space-y-2 rounded-md bg-chip p-3 text-xs">
-      {pickup ? (
-        <div className="space-y-0.5">
-          <dt className="font-semibold">수령 장소</dt>
-          <dd>{pickup.name}</dd>
-          <dd className="text-muted">
-            ({pickup.zipCode}) {pickup.address1}
-            {pickup.address2 ? ` ${pickup.address2}` : ""}
-          </dd>
-          <dd className="text-muted">{pickup.phone}</dd>
-        </div>
-      ) : null}
-      {note ? (
-        <div className="space-y-0.5">
-          <dt className="font-semibold">이용 안내</dt>
-          <dd className="whitespace-pre-line">{note}</dd>
-        </div>
-      ) : null}
+    <dl className="space-y-0.5 rounded-md bg-chip p-3 text-xs">
+      <dt className="font-semibold">이용 안내</dt>
+      <dd className="whitespace-pre-line">{note}</dd>
     </dl>
   );
 }

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

@@ -59,7 +59,7 @@ export const Route = createFileRoute("/products/$productId")({
   component: ProductDetail,
 });
 
-/** 상품 상세의 받는 방법 한 줄 — 배송 상품은 배송비·예상 기간, 그 밖의 유형은 배송 없이 받는 방법이다 */
+/** 상품 상세의 받는 방법 한 줄 — 배송 상품은 배송비·예상 기간, 배송 없는 상품은 판매자가 직접 제공한다 */
 function deliveryNoteOf(fulfillment: ProductFulfillmentView): string {
   switch (fulfillment.type) {
     case "SHIPPING": {
@@ -67,14 +67,8 @@ function deliveryNoteOf(fulfillment: ProductFulfillmentView): string {
       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}`
-        : "방문 수령";
+    case "MANUAL":
+      return "배송 없이 판매자가 제공";
     default:
       return fulfillment.requiresShipping ? "택배 배송" : "배송 없이 제공";
   }

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

@@ -1,110 +0,0 @@
-import type { FulfillmentReveal, MyOrderItem } from "@sayren/storefront-sdk";
-import { useHydrated } from "@tanstack/react-router";
-import { useState } from "react";
-import type { CodeRevealResult } from "../lib/code-reveal";
-import { formatDateTime } from "../lib/format";
-
-type RevealedCode = FulfillmentReveal["codes"][number];
-
-/**
- * 코드 발급 상품의 코드 — 가린 값을 보이고 「코드 보기」를 누르면 평문을 받아 이 컴포넌트 상태에만 둔다.
- * 평문은 주소·스토리지에 남기지 않는다. 코드 발급 상품이 아니거나 받은 코드가 없으면 그리지 않는다.
- *
- * `reveal`은 서버 함수를 부르는 호출부 몫이다 — 회원은 액세스 토큰, 비회원은 조회에 쓴 연락처·비밀번호로 확인한다.
- */
-export function FulfillmentCodes({
-  item,
-  reveal,
-}: {
-  item: MyOrderItem;
-  reveal: () => Promise<CodeRevealResult>;
-}) {
-  const hydrated = useHydrated();
-  const [revealed, setRevealed] = useState<RevealedCode[] | null>(null);
-  const [pending, setPending] = useState(false);
-  const [error, setError] = useState<string | null>(null);
-  const codes = item.fulfillment?.status === "FULFILLED" ? (item.fulfillment.codes ?? []) : [];
-  if (item.fulfillmentSnapshot.type !== "CODE" || codes.length === 0) return null;
-
-  const open = async () => {
-    setPending(true);
-    setError(null);
-    try {
-      const result = await reveal();
-      if (result.error !== null) setError(result.error);
-      else setRevealed(result.codes);
-    } catch {
-      setError("코드를 불러오지 못했습니다. 잠시 후 다시 시도해 주십시오");
-    } finally {
-      setPending(false);
-    }
-  };
-
-  return (
-    <section aria-label="코드" className="space-y-2 rounded-md bg-chip p-3 text-xs">
-      <p className="font-semibold">코드</p>
-      {revealed ? (
-        <ul className="space-y-1.5">
-          {revealed.map((code) => (
-            <li key={code.codeId} className="flex flex-wrap items-center gap-2">
-              <code className="break-all rounded bg-white px-2 py-1 font-mono text-sm">
-                {code.code}
-              </code>
-              <CopyButton value={code.code} />
-            </li>
-          ))}
-        </ul>
-      ) : (
-        <>
-          <ul className="space-y-1">
-            {codes.map((code) => (
-              <li key={code.codeId} className="flex flex-wrap items-center gap-2">
-                <code className="font-mono text-sm">{code.hint}</code>
-                {code.revealedAt ? (
-                  <span className="text-muted">처음 연 시각 {formatDateTime(code.revealedAt)}</span>
-                ) : null}
-              </li>
-            ))}
-          </ul>
-          <div className="flex flex-wrap items-center gap-3">
-            <button
-              type="button"
-              disabled={!hydrated || pending}
-              onClick={() => void open()}
-              className="h-8 rounded-md bg-ink px-3 font-semibold text-white disabled:opacity-50"
-            >
-              코드 보기
-            </button>
-            <span className="text-muted">코드를 처음 연 시각이 기록됩니다.</span>
-          </div>
-        </>
-      )}
-      {error ? (
-        <p role="alert" className="text-point">
-          {error}
-        </p>
-      ) : null}
-    </section>
-  );
-}
-
-function CopyButton({ value }: { value: string }) {
-  const [copied, setCopied] = useState(false);
-  return (
-    <button
-      type="button"
-      onClick={() => {
-        navigator.clipboard
-          .writeText(value)
-          .then(() => {
-            setCopied(true);
-            setTimeout(() => setCopied(false), 1500);
-          })
-          .catch(() => undefined);
-      }}
-      className="h-7 rounded-md border border-line bg-white px-2 text-xs"
-    >
-      {copied ? "복사함" : "복사"}
-    </button>
-  );
-}

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

@@ -1,88 +0,0 @@
-import type { MyOrderItem } from "@sayren/storefront-sdk";
-import { useHydrated } from "@tanstack/react-router";
-import { useState } from "react";
-import { type DownloadResult, formatFileSize } from "../lib/download";
-import { formatDateTime } from "../lib/format";
-
-/**
- * 파일 다운로드 상품의 파일 — 남은 횟수·기한과 파일마다 「다운로드」 버튼을 보인다. 누르면 서명 주소(수명 300초)를 받아
- * 브라우저가 바로 그 주소로 간다. 받을 때마다 횟수를 하나 쓴다. 파일 다운로드 상품이 아니거나 제공 전이면 그리지 않는다.
- *
- * `download`는 서버 함수를 부르는 호출부 몫이다 — 회원은 액세스 토큰, 비회원은 조회에 쓴 연락처·비밀번호로 확인한다.
- */
-export function FulfillmentDownloads({
-  item,
-  download,
-}: {
-  item: MyOrderItem;
-  download: (assetId: string) => Promise<DownloadResult>;
-}) {
-  const hydrated = useHydrated();
-  const [pendingAssetId, setPendingAssetId] = useState<string | null>(null);
-  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.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();
-
-  const start = async (assetId: string) => {
-    setPendingAssetId(assetId);
-    setError(null);
-    try {
-      const result = await download(assetId);
-      if (result.error !== null) {
-        setError(result.error);
-        return;
-      }
-      setRemaining(result.remaining);
-      // 서명 주소는 곧 만료된다 — 저장하지 않고 바로 받는다
-      window.location.assign(result.url);
-    } catch {
-      setError("파일을 받지 못했습니다. 잠시 후 다시 시도해 주십시오");
-    } finally {
-      setPendingAssetId(null);
-    }
-  };
-
-  return (
-    <section aria-label="다운로드" className="space-y-2 rounded-md bg-chip p-3 text-xs">
-      <p className="font-semibold">다운로드</p>
-      <p className="text-muted">
-        남은 횟수 {left}/{info.limit}회
-        {info.expiresAt ? ` · 기한 ${formatDateTime(info.expiresAt)}` : ""}
-      </p>
-      {info.files.length === 0 ? (
-        <p className="text-muted">받을 파일이 없습니다.</p>
-      ) : (
-        <ul className="space-y-1.5">
-          {info.files.map((file) => (
-            <li key={file.assetId} className="flex flex-wrap items-center gap-2">
-              <span className="break-all text-sm">{file.fileName}</span>
-              {file.sizeBytes !== null ? (
-                <span className="text-muted">{formatFileSize(file.sizeBytes)}</span>
-              ) : null}
-              <button
-                type="button"
-                aria-label={`${file.fileName} 다운로드`}
-                disabled={!hydrated || pendingAssetId !== null || left <= 0 || expired}
-                onClick={() => void start(file.assetId)}
-                className="ml-auto h-8 rounded-md bg-ink px-3 font-semibold text-white disabled:opacity-50"
-              >
-                다운로드
-              </button>
-            </li>
-          ))}
-        </ul>
-      )}
-      {left <= 0 ? <p className="text-muted">다운로드 횟수를 모두 사용했습니다.</p> : null}
-      {expired && left > 0 ? <p className="text-muted">다운로드 기간이 지났습니다.</p> : null}
-      {error ? (
-        <p role="alert" className="text-point">
-          {error}
-        </p>
-      ) : null}
-    </section>
-  );
-}

package/template/src/lib/code-reveal.test.ts

@@ -1,30 +0,0 @@
-import { ApiError } from "@sayren/storefront-sdk";
-import { describe, expect, it } from "vitest";
-import { codeRevealErrorMessage, normalizePhone } from "./code-reveal";
-
-describe("codeRevealErrorMessage", () => {
-  it("열람할 코드가 없으면(404) 주문 상태를 확인하게 한다", () => {
-    expect(codeRevealErrorMessage(new ApiError(404, "FULFILLMENT_NOT_FOUND", "x"))).toBe(
-      "열람할 코드가 없습니다. 주문 상태를 확인해 주십시오",
-    );
-  });
-
-  it("시도 한도(429)는 남은 시간을 알린다", () => {
-    const error = new ApiError(429, "TOO_MANY_REQUESTS", "x", undefined, undefined, {
-      retryAfterSeconds: 600,
-    });
-    expect(codeRevealErrorMessage(error)).toContain("10분 뒤");
-  });
-
-  it("그 밖의 실패는 다시 시도하게 한다", () => {
-    expect(codeRevealErrorMessage(new Error("network"))).toBe(
-      "코드를 불러오지 못했습니다. 잠시 후 다시 시도해 주십시오",
-    );
-  });
-});
-
-describe("normalizePhone", () => {
-  it("숫자만 남긴다", () => {
-    expect(normalizePhone("010-1234 5678")).toBe("01012345678");
-  });
-});

package/template/src/lib/code-reveal.ts

@@ -1,32 +0,0 @@
-import { ApiError, type FulfillmentReveal } from "@sayren/storefront-sdk";
-import { guestLookupLockedMessage } from "./guest-order";
-
-/**
- * 코드 발급 상품의 코드 열람 (sayren 이슈 #48).
- *
- * 주문 상세의 코드는 가린 값(`hint`)만 온다. 평문은 구매자가 「코드 보기」를 누를 때 서버 함수가
- * `myOrders.revealCode`(회원)·`myOrders.revealGuestCode`(비회원)로 받아 그 화면에만 보인다. 평문은
- * 주소·스토리지·쿠키에 두지 않는다. 처음 연 시각이 기록되고 셀러가 청약철회를 판단하는 근거가 된다.
- */
-
-/** 서버 함수 결과 — ApiError는 서버 함수 경계를 넘지 못하므로 문구로 바꿔 돌려준다 */
-export type CodeRevealResult =
-  | { codes: FulfillmentReveal["codes"]; error: null }
-  | { codes: null; error: string };
-
-/** 코드 열람 실패 → 구매자에게 보일 문구 */
-export function codeRevealErrorMessage(error: unknown): string {
-  if (error instanceof ApiError) {
-    if (error.status === 404) {
-      return "열람할 코드가 없습니다. 주문 상태를 확인해 주십시오";
-    }
-    // 비회원 열람은 비회원 주문 조회와 같은 시도 한도를 쓴다
-    if (error.status === 429) return guestLookupLockedMessage(error.details?.retryAfterSeconds);
-  }
-  return "코드를 불러오지 못했습니다. 잠시 후 다시 시도해 주십시오";
-}
-
-/** 비회원 열람에 싣는 연락처 — 조회 화면과 같게 숫자만 남긴다 */
-export function normalizePhone(phone: string): string {
-  return phone.replace(/[^0-9]/g, "");
-}

package/template/src/lib/download.test.ts

@@ -1,41 +0,0 @@
-import { ApiError } from "@sayren/storefront-sdk";
-import { describe, expect, it } from "vitest";
-import { downloadErrorMessage, formatFileSize } from "./download";
-
-describe("downloadErrorMessage", () => {
-  it("횟수를 다 썼거나 기간이 지나면 그대로 알린다", () => {
-    expect(downloadErrorMessage(new ApiError(409, "DOWNLOAD_LIMIT_REACHED", "x"))).toBe(
-      "다운로드 횟수를 모두 사용했습니다",
-    );
-    expect(downloadErrorMessage(new ApiError(409, "DOWNLOAD_EXPIRED", "x"))).toBe(
-      "다운로드 기간이 지났습니다",
-    );
-  });
-
-  it("받을 파일이 없으면(404) 주문 상태를 확인하게 한다", () => {
-    expect(downloadErrorMessage(new ApiError(404, "FULFILLMENT_NOT_FOUND", "x"))).toBe(
-      "받을 파일이 없습니다. 주문 상태를 확인해 주십시오",
-    );
-  });
-
-  it("시도 한도(429)는 남은 시간을 알린다", () => {
-    const error = new ApiError(429, "TOO_MANY_REQUESTS", "x", undefined, undefined, {
-      retryAfterSeconds: 600,
-    });
-    expect(downloadErrorMessage(error)).toContain("10분 뒤");
-  });
-
-  it("그 밖의 실패는 다시 시도하게 한다", () => {
-    expect(downloadErrorMessage(new Error("network"))).toBe(
-      "파일을 받지 못했습니다. 잠시 후 다시 시도해 주십시오",
-    );
-  });
-});
-
-describe("formatFileSize", () => {
-  it("1024 단위로 줄이고 모르면 빈 문자열이다", () => {
-    expect(formatFileSize(512)).toBe("512B");
-    expect(formatFileSize(1536)).toBe("1.5KB");
-    expect(formatFileSize(null)).toBe("");
-  });
-});

package/template/src/lib/download.ts

@@ -1,41 +0,0 @@
-import { ApiError } from "@sayren/storefront-sdk";
-import { guestLookupLockedMessage } from "./guest-order";
-
-/**
- * 파일 다운로드 상품의 파일 받기 (sayren 이슈 #48).
- *
- * 주문 상세에는 횟수·기한·파일 이름만 온다. 「다운로드」를 누르면 서버 함수가 `myOrders.createDownload`(회원)·
- * `myOrders.createGuestDownload`(비회원)로 수명 300초의 서명 주소를 받아 브라우저가 바로 그 주소로 간다.
- * 주소는 받을 때마다 횟수를 하나 쓰므로 저장하거나 공유하지 않는다.
- */
-
-/** 서버 함수 결과 — ApiError는 서버 함수 경계를 넘지 못하므로 문구로 바꿔 돌려준다 */
-export type DownloadResult =
-  | { url: string; fileName: string; remaining: number; error: null }
-  | { url: null; error: string };
-
-/** 다운로드 실패 → 구매자에게 보일 문구 */
-export function downloadErrorMessage(error: unknown): string {
-  if (error instanceof ApiError) {
-    if (error.code === "DOWNLOAD_LIMIT_REACHED") return "다운로드 횟수를 모두 사용했습니다";
-    if (error.code === "DOWNLOAD_EXPIRED") return "다운로드 기간이 지났습니다";
-    if (error.status === 404) return "받을 파일이 없습니다. 주문 상태를 확인해 주십시오";
-    // 비회원 다운로드는 비회원 주문 조회와 같은 시도 한도를 쓴다
-    if (error.status === 429) return guestLookupLockedMessage(error.details?.retryAfterSeconds);
-  }
-  return "파일을 받지 못했습니다. 잠시 후 다시 시도해 주십시오";
-}
-
-/** 파일 크기 — 1024 단위, 소수 한 자리. 모르면 빈 문자열 */
-export function formatFileSize(bytes: number | null | undefined): string {
-  if (bytes === null || bytes === undefined || bytes < 0) return "";
-  if (bytes < 1024) return `${bytes}B`;
-  const units = ["KB", "MB", "GB"];
-  let size = bytes / 1024;
-  let unit = 0;
-  while (size >= 1024 && unit < units.length - 1) {
-    size /= 1024;
-    unit += 1;
-  }
-  return `${size.toFixed(1)}${units[unit]}`;
-}