@sellosh/commerce 0.1.0 → 0.3.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, ShippingConfig, ProductDetailResult, ProductListResult, ProfileInput, ReviewListParams, ReviewListResult } from "./types";
 export interface SelloClientConfig {
     /** API 베이스 URL. "" = 동일 출처(프록시/리라이트). 예: "https://www.sello.sh" */
     apiBase?: string;
@@ -12,12 +12,20 @@ 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;
     listProducts(slug?: string): Promise<ProductListResult>;
     getProduct(id: number, slug?: string): Promise<ProductDetailResult>;
     getPaymentConfig(slug?: string): Promise<PaymentConfig>;
+    /** 배송 설정 조회 (배송비 + 무료배송 기준). 최종 결제액은 서버가 재검증. */
+    getShippingConfig(slug?: string): Promise<ShippingConfig>;
     confirmTossPayment(input: ConfirmTossInput): Promise<ConfirmTossResult>;
     listOrders(): Promise<{
         orders: Order[];
@@ -43,6 +51,8 @@ export interface SelloClient {
             status: string;
         };
     }>;
+    /** 쿠폰 적용 미리보기 (읽기 전용 — 사용횟수 차감 없음). 서버가 상품합계 재계산 후 할인 산출. */
+    validateCoupon(input: ValidateCouponInput): Promise<CouponPreview>;
     register(input: {
         slug: string;
         email: string;

package/dist/client.js

@@ -34,6 +34,7 @@ export function createSelloClient(config = {}) {
         listProducts: (slug) => req(`/api/frontend/products?business=${q(requireSlug(slug))}`),
         getProduct: (id, slug) => req(`/api/frontend/products/${id}?business=${q(requireSlug(slug))}`),
         getPaymentConfig: (slug) => req(`/api/frontend/payments/config?business=${q(requireSlug(slug))}`),
+        getShippingConfig: (slug) => req(`/api/frontend/shipping/config?business=${q(requireSlug(slug))}`),
         confirmTossPayment: (input) => req(`/api/frontend/payments/toss/confirm`, { method: "POST", body: JSON.stringify(input) }, true),
         listOrders: () => req(`/api/frontend/orders`, {}, true),
         getOrder: (id, opts) => req(`/api/frontend/orders/${id}${opts?.guestToken ? `?guestToken=${q(opts.guestToken)}` : ""}`, {}, true),
@@ -43,6 +44,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,9 @@ export interface Order {
     id: number;
     status: OrderStatus | string;
     total: number;
+    discount_amount?: number;
+    coupon_code?: string | null;
+    shipping_fee?: number;
     customer_name?: string;
     phone?: string;
     address?: string;
@@ -105,7 +108,12 @@ export interface PaymentConfig {
     provider: string;
     tossClientKey: string;
 }
-/** 토스 결제 승인 입력 — 서버가 buildOrder 로 가격·재고 재검증 후 total === amount 확인. */
+/** 공개 배송 설정 — 스토어가 결제 전 배송비를 표시·합산. 최종액은 서버가 재검증. */
+export interface ShippingConfig {
+    shippingFee: number;
+    freeShippingThreshold: number | null;
+}
+/** 토스 결제 승인 입력 — 서버가 buildOrder 로 가격·재고 재검증 후 (할인 적용)finalTotal === amount 확인. */
 export interface ConfirmTossInput {
     paymentKey: string;
     orderId: string;
@@ -116,6 +124,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.3.0",
   "license": "MIT",
   "type": "module",
   "description": "Sello 커머스 SDK — 모든 스토어프론트(손코딩/AI생성)가 공유하는 타입드 클라이언트 + React 훅. 결제·재고·인증의 안전 경계를 한 곳에 둔다.",