@sellosh/commerce 0.1.0 → 0.2.0

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { AuthProviders, AuthResult, AuthUser, CartItemInput, ConfirmTossInput, ConfirmTossResult, MetaConfig, Order, OrderWithItems, PaymentConfig, ProductDetailResult, ProductListResult, ProfileInput, ReviewListParams, ReviewListResult } from "./types";
+import type { AuthProviders, AuthResult, AuthUser, CartItemInput, ConfirmTossInput, ConfirmTossResult, CouponPreview, MetaConfig, Order, OrderWithItems, PaymentConfig, ProductDetailResult, ProductListResult, ProfileInput, ReviewListParams, ReviewListResult } from "./types";
 export interface SelloClientConfig {
     /** API 베이스 URL. "" = 동일 출처(프록시/리라이트). 예: "https://www.sello.sh" */
     apiBase?: string;
@@ -12,6 +12,12 @@ export interface CreateOrderInput {
     customer_name: string;
     phone: string;
     address: string;
+    couponCode?: string;
+}
+export interface ValidateCouponInput {
+    code: string;
+    items: CartItemInput[];
+    businessSlug?: string;
 }
 export interface SelloClient {
     readonly businessSlug: string | null;
@@ -43,6 +49,8 @@ export interface SelloClient {
             status: string;
         };
     }>;
+    /** 쿠폰 적용 미리보기 (읽기 전용 — 사용횟수 차감 없음). 서버가 상품합계 재계산 후 할인 산출. */
+    validateCoupon(input: ValidateCouponInput): Promise<CouponPreview>;
     register(input: {
         slug: string;
         email: string;

package/dist/client.js

@@ -43,6 +43,14 @@ export function createSelloClient(config = {}) {
         }),
         claimOrder: (id, guestToken) => req(`/api/frontend/orders/${id}/claim`, { method: "POST", body: JSON.stringify({ guestToken }) }, true),
         createOrder: (input) => req(`/api/frontend/orders`, { method: "POST", body: JSON.stringify(input) }, true),
+        validateCoupon: (input) => req(`/api/frontend/coupons/validate`, {
+            method: "POST",
+            body: JSON.stringify({
+                code: input.code,
+                items: input.items,
+                businessSlug: requireSlug(input.businessSlug),
+            }),
+        }, true),
         register: (input) => req(`/api/frontend/auth/register`, {
             method: "POST",
             body: JSON.stringify(input),

package/dist/draft.d.ts

@@ -7,6 +7,8 @@ export interface CheckoutDraft {
     email?: string | null;
     amount: number;
     businessSlug?: string;
+    /** 적용한 쿠폰 코드(선택) — 승인 페이지가 confirm 호출 시 그대로 전달, 서버가 재검증 */
+    couponCode?: string;
     /** 바로구매(단품) 주문 — true 면 결제 성공 후 장바구니를 비우지 않는다(카트 보존) */
     instant?: boolean;
 }

package/dist/types.d.ts

@@ -61,6 +61,8 @@ export interface Order {
     id: number;
     status: OrderStatus | string;
     total: number;
+    discount_amount?: number;
+    coupon_code?: string | null;
     customer_name?: string;
     phone?: string;
     address?: string;
@@ -105,7 +107,7 @@ export interface PaymentConfig {
     provider: string;
     tossClientKey: string;
 }
-/** 토스 결제 승인 입력 — 서버가 buildOrder 로 가격·재고 재검증 후 total === amount 확인. */
+/** 토스 결제 승인 입력 — 서버가 buildOrder 로 가격·재고 재검증 후 (할인 적용)finalTotal === amount 확인. */
 export interface ConfirmTossInput {
     paymentKey: string;
     orderId: string;
@@ -116,6 +118,18 @@ export interface ConfirmTossInput {
     address: string;
     email?: string;
     businessSlug?: string;
+    couponCode?: string;
+}
+/** 쿠폰 적용 미리보기 — 서버가 상품합계를 재계산해 산출. valid=false 면 error 에 사유. */
+export interface CouponPreview {
+    valid: boolean;
+    error?: string;
+    code?: string;
+    discount_type?: "percent" | "fixed";
+    discount_value?: number;
+    discount?: number;
+    subtotal: number;
+    finalTotal?: number;
 }
 export interface ConfirmTossResult {
     order: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellosh/commerce",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "type": "module",
   "description": "Sello 커머스 SDK — 모든 스토어프론트(손코딩/AI생성)가 공유하는 타입드 클라이언트 + React 훅. 결제·재고·인증의 안전 경계를 한 곳에 둔다.",