@diffsome/sdk 3.0.0 → 3.2.1

package/README.md

@@ -1,70 +1,69 @@
 # @diffsome/sdk
 
-Diffsome 공식 SDK - 헤드리스 CMS + 이커머스 + AI 기능을 제공합니다.
+Diffsome Official SDK - Headless CMS + E-commerce + AI platform.
 
-**버전: 2.18.0**
+**Version: 3.2.0**
 
-## 설치
+## Installation
 
 ```bash
 npm install @diffsome/sdk
 ```
 
-## 빠른 시작
+## Quick Start
 
 ```typescript
 import { Diffsome } from '@diffsome/sdk';
 
 const client = new Diffsome({
   tenantId: 'your-tenant-id',
-  apiKey: 'pky_xxxxxxxxxxxxxxxx',  // 필수 - Dashboard > Settings > API Tokens
-  baseUrl: 'https://diffsome.com',  // 선택
+  apiKey: 'pky_xxxxxxxxxxxxxxxx',  // Required - Dashboard > Settings > API Tokens
+  baseUrl: 'https://diffsome.com',  // Optional
 
-  // 토큰 자동 저장 (로그인 유지)
+  // Token auto-save (persistent login)
   persistToken: true,
-  storageType: 'localStorage',  // 또는 'sessionStorage'
+  storageType: 'localStorage',  // or 'sessionStorage'
   onAuthStateChange: (token, user) => {
     console.log('Auth changed:', user);
   },
 });
 
-// 블로그 조회
+// Blog posts
 const { data: posts } = await client.blog.list();
 
-// 상품 조회
+// Products
 const { data: products } = await client.shop.listProducts();
 ```
 
 ---
 
-## 인증 (Auth)
+## Authentication (Auth)
 
-### 기본 설정
+### Basic Setup
 
 ```typescript
 const client = new Diffsome({
   tenantId: 'demo',
-  apiKey: 'pky_xxxxxxxxxxxxxxxx',  // 필수
-  persistToken: true,  // 토큰 자동 저장
+  apiKey: 'pky_xxxxxxxxxxxxxxxx',  // Required
+  persistToken: true,  // Auto-save token
 });
 ```
 
-### 토큰 자동 저장
+### Token Persistence
 
-`persistToken: true` 설정 시:
-- **로그인**: `localStorage`에 자동 저장
-- **새로고침**: 토큰 자동 복원
-- **로그아웃**: 토큰 자동 삭제
-- **저장 키**: `promptly_auth_token_{tenantId}`
+With `persistToken: true`:
+- **Login**: Auto-saved to `localStorage`
+- **Refresh**: Token auto-restored
+- **Logout**: Token auto-removed
+- **Storage key**: `diffsome_auth_token_{tenantId}`
 
 ```typescript
 const client = new Diffsome({
   tenantId: 'demo',
   apiKey: 'pky_xxx',
   persistToken: true,
-  storageType: 'localStorage',  // 기본값, 또는 'sessionStorage'
+  storageType: 'localStorage',  // Default, or 'sessionStorage'
   onAuthStateChange: (token, user) => {
-    // 로그인/로그아웃 시 호출
     if (token) {
       console.log('Logged in:', user);
     } else {
@@ -74,10 +73,10 @@ const client = new Diffsome({
 });
 ```
 
-### 로그인/회원가입
+### Login / Register
 
 ```typescript
-// 회원가입
+// Register
 await client.auth.register({
   name: 'John Doe',
   email: 'john@example.com',
@@ -85,47 +84,47 @@ await client.auth.register({
   password_confirmation: 'password',
 });
 
-// 로그인 (토큰 자동 저장됨)
+// Login (token auto-saved)
 const { member, token } = await client.auth.login({
   email: 'john@example.com',
   password: 'password',
 });
 
-// 로그아웃 (토큰 자동 삭제됨)
+// Logout (token auto-removed)
 await client.auth.logout();
 
-// 인증 상태 확인
+// Check auth status
 client.auth.isAuthenticated();  // true/false
 
-// 현재 사용자
+// Current user
 const me = await client.auth.me();
 
-// 프로필 수정
+// Update profile
 await client.auth.updateProfile({ name: 'New Name' });
 ```
 
-### 소셜 로그인
+### Social Login
 
 ```typescript
-// 사용 가능한 프로바이더
+// Available providers
 const providers = await client.auth.getSocialProviders();
 // ['google', 'kakao', 'naver']
 
-// 로그인 URL 획득
+// Get login URL
 const { url } = await client.auth.getSocialAuthUrl('google');
 window.location.href = url;
 
-// 콜백 처리 (리다이렉트 후)
+// Handle callback (after redirect)
 const { member, token } = await client.auth.socialCallback('google', code);
 ```
 
-### 비밀번호 재설정
+### Password Reset
 
 ```typescript
-// 재설정 이메일 발송
+// Send reset email
 await client.auth.forgotPassword({ email: 'john@example.com' });
 
-// 비밀번호 재설정
+// Reset password
 await client.auth.resetPassword({
   token: 'reset-token',
   email: 'john@example.com',
@@ -139,7 +138,7 @@ await client.auth.resetPassword({
 ## Blog API
 
 ```typescript
-// 목록 조회
+// List posts
 const { data, meta } = await client.blog.list({
   page: 1,
   per_page: 10,
@@ -148,17 +147,17 @@ const { data, meta } = await client.blog.list({
   search: 'keyword',
 });
 
-// 상세 조회
+// Get post by slug
 const post = await client.blog.get('post-slug');
 
-// 추천 글
+// Featured posts
 const featured = await client.blog.featured(5);
 
-// 카테고리/태그별 필터
+// Filter by category/tag
 const { data } = await client.blog.byCategory('news');
 const { data } = await client.blog.byTag('featured');
 
-// 카테고리/태그 목록
+// Get categories/tags
 const categories = await client.blog.categories();  // string[]
 const tags = await client.blog.tags();  // string[]
 ```
@@ -168,23 +167,23 @@ const tags = await client.blog.tags();  // string[]
 ## Boards API
 
 ```typescript
-// 게시판 목록
+// List boards
 const { data: boards } = await client.boards.list();
 
-// 게시판 조회
+// Get board
 const board = await client.boards.get('board-slug');
 
-// 게시글 목록
+// List posts
 const { data: posts } = await client.boards.listPosts('board-slug', {
   page: 1,
   per_page: 10,
   search: 'keyword',
 });
 
-// 게시글 상세
+// Get post
 const post = await client.boards.getPost(postId);
 
-// 게시글 작성 (인증 필요)
+// Create post (auth required)
 await client.boards.createPost({
   board_id: 1,
   title: 'Title',
@@ -192,7 +191,7 @@ await client.boards.createPost({
   is_secret: false,
 });
 
-// 게시글 수정/삭제
+// Update/Delete post
 await client.boards.updatePost(postId, { title: 'New Title' });
 await client.boards.deletePost(postId);
 ```
@@ -201,31 +200,31 @@ await client.boards.deletePost(postId);
 
 ## Comments API
 
-게시판, 블로그, 독립 댓글(방명록) 지원
+Supports board posts, blog posts, and standalone pages (guestbook).
 
 ```typescript
-// 게시판 댓글
+// Board post comments
 const { data } = await client.comments.boardPost(postId);
 await client.comments.createBoardPost(postId, {
   author_name: 'John',
   content: 'Great!',
-  password: '1234',  // 비회원 댓글
+  password: '1234',  // Guest comment
 });
 
-// 블로그 댓글
+// Blog post comments
 const { data } = await client.comments.blogPost('post-slug');
 await client.comments.createBlogPost('post-slug', {
   content: 'Nice article!',
 });
 
-// 독립 댓글 (방명록)
+// Standalone comments (guestbook)
 const { data } = await client.comments.standalone('guestbook');
 await client.comments.createStandalone('guestbook', {
   author_name: 'Visitor',
   content: 'Hello!',
 });
 
-// 공통
+// Common operations
 await client.comments.update(commentId, { content: 'Updated' });
 await client.comments.delete(commentId, { password: '1234' });
 await client.comments.like(commentId);
@@ -235,10 +234,10 @@ await client.comments.like(commentId);
 
 ## Shop API
 
-### 상품
+### Products
 
 ```typescript
-// 상품 목록
+// List products
 const { data: products } = await client.shop.listProducts({
   category: 'shoes',
   is_featured: true,
@@ -247,75 +246,126 @@ const { data: products } = await client.shop.listProducts({
   search: 'keyword',
 });
 
-// 상품 상세
+// Get product by slug
 const product = await client.shop.getProduct('product-slug');
 
-// 추천 상품
+// Featured products
 const featured = await client.shop.featuredProducts(8);
 
-// 카테고리 목록
-const categories = await client.shop.listCategories();
+// Categories
+const { data: categories } = await client.shop.listCategories();
 ```
 
-### 상품 리뷰
+### Product Types
 
 ```typescript
-// 리뷰 목록
+// Filter by product type
+const { data } = await client.shop.listProductsByType('digital');
+const { data } = await client.shop.getDigitalProducts();
+const { data } = await client.shop.getSubscriptionProducts();
+const { data } = await client.shop.getBundleProducts();
+```
+
+### Product Reviews
+
+```typescript
+// List reviews
 const { data: reviews, stats } = await client.shop.getProductReviews('product-slug', {
   page: 1,
   per_page: 10,
-  rating: 5,  // 별점 필터
+  rating: 5,  // Filter by rating
 });
 
-// 리뷰 통계
+// Review stats
 // stats = { average_rating: 4.5, total_count: 123, rating_counts: { 5: 80, 4: 30, ... } }
 
-// 리뷰 작성 (인증 + 구매 필요)
-await client.shop.createProductReview('product-slug', {
+// Create review (auth + purchase required)
+await client.shop.createReview('product-slug', {
   rating: 5,
   title: 'Great product!',
   content: 'Highly recommended.',
   images: ['https://...'],
 });
 
-// 리뷰 수정/삭제
-await client.shop.updateProductReview(reviewId, { rating: 4 });
-await client.shop.deleteProductReview(reviewId);
+// Check if can review
+const { can_review, reason } = await client.shop.canReviewProduct('product-slug');
 
-// 도움이 됐어요
+// Update/Delete review
+await client.shop.updateReview(reviewId, { rating: 4 });
+await client.shop.deleteReview(reviewId);
+
+// Mark as helpful
 await client.shop.markReviewHelpful(reviewId);
 
-// 내 리뷰 목록
-const { data: myReviews } = await client.shop.getMyReviews();
+// My reviews
+const { data: myReviews } = await client.shop.myReviews();
 ```
 
-### 장바구니 (인증 필요)
+### Cart
+
+Works for both authenticated users and guests. Guest carts use session ID persistence.
 
 ```typescript
-// 장바구니 조회
+// Get cart
 const cart = await client.shop.getCart();
 
-// 상품 추가
+// Add item
 await client.shop.addToCart({
   product_id: 1,
   quantity: 2,
-  variant_id: 3,  // 옵션 상품
+  variant_id: 3,  // Variant option
 });
 
-// 수량 변경
+// Update quantity
 await client.shop.updateCartItem(itemId, { quantity: 3 });
 
-// 상품 제거
+// Remove item
 await client.shop.removeFromCart(itemId);
 
-// 장바구니 비우기
+// Clear cart
 await client.shop.clearCart();
 ```
 
-### 주문 (인증 필요)
+### Wishlist (Auth Required)
 
 ```typescript
-// 주문 생성
+// Get wishlist
+const { data: items } = await client.shop.getWishlist();
+
+// Add to wishlist
+await client.shop.addToWishlist({
+  product_id: 1,
+  variant_id: 2,
+  note: 'Birthday gift',
+});
+
+// Toggle wishlist (add if not in, remove if in)
+const { action, in_wishlist } = await client.shop.toggleWishlist(productId);
+
+// Check if in wishlist
+const isInWishlist = await client.shop.isInWishlist(productId);
+
+// Bulk check (for product list pages)
+const wishlistStatus = await client.shop.checkWishlistBulk([1, 2, 3]);
+// { '1': true, '2': false, '3': true }
+
+// Wishlist count
+const count = await client.shop.getWishlistCount();
+
+// Move to cart
+const { moved, failed, moved_count } = await client.shop.moveWishlistToCart();
+
+// Update note
+await client.shop.updateWishlistNote(wishlistId, 'New note');
+
+// Remove from wishlist
+await client.shop.removeFromWishlist(wishlistId);
+```
+
+### Orders (Auth Required)
+
+```typescript
+// Create order
 const order = await client.shop.createOrder({
   orderer_name: 'John Doe',
   orderer_email: 'john@example.com',
@@ -323,76 +373,173 @@ const order = await client.shop.createOrder({
   shipping_name: 'John Doe',
   shipping_phone: '010-1234-5678',
   shipping_zipcode: '12345',
-  shipping_address: '서울시 강남구',
-  shipping_address_detail: '101동 101호',
-  shipping_memo: '부재시 경비실',
+  shipping_address: 'Seoul, Gangnam',
+  shipping_address_detail: 'Apt 101',
+  shipping_memo: 'Leave at door',
   coupon_code: 'SAVE10',
 });
 
-// 주문 목록
+// List orders
 const { data: orders } = await client.shop.listOrders();
 
-// 주문 상세
+// Get order
 const orderDetail = await client.shop.getOrder(orderId);
 
-// 주문 취소
+// Cancel order
 await client.shop.cancelOrder(orderId);
 ```
 
-### 결제 (토스페이먼츠)
+### Payments - Toss Payments
 
 ```typescript
-// 결제 준비
-const payment = await client.shop.preparePayment({
+// Prepare payment
+const payment = await client.shop.tossPaymentReady({
   order_number: 'ORD-123',
   success_url: 'https://mysite.com/payment/success',
   fail_url: 'https://mysite.com/payment/fail',
 });
-// payment = { client_key, order_id, order_name, amount, customer_name, ... }
+// { client_key, order_id, order_name, amount, customer_name, ... }
 
-// 결제 승인 (토스 결제 완료 후)
-await client.shop.confirmPayment({
+// Confirm payment (after Toss redirect)
+const result = await client.shop.tossPaymentConfirm({
   payment_key: 'toss_payment_key',
   order_id: 'ORD-123',
   amount: 50000,
 });
+
+// Cancel payment
+await client.shop.tossPaymentCancel('ORD-123', 'Customer request', 50000);
 ```
 
-### 쿠폰
+### Payments - Stripe
 
 ```typescript
-// 쿠폰 검증
+// Create Checkout Session
+const { session_id, checkout_url } = await client.shop.stripeCheckout({
+  order_number: 'ORD-123',
+  success_url: 'https://mysite.com/payment/success',
+  cancel_url: 'https://mysite.com/payment/cancel',
+});
+
+// Redirect to Stripe
+window.location.href = checkout_url;
+
+// Verify payment (after Stripe redirect)
+const result = await client.shop.stripeVerify({
+  session_id: 'cs_xxx',
+});
+
+// Refund
+await client.shop.stripeRefund('ORD-123', 'Customer request', 50000);
+```
+
+### Payment Status
+
+```typescript
+// Check available payment methods
+const status = await client.shop.getPaymentStatus();
+// {
+//   toss: { available: true },
+//   stripe: { available: true, publishable_key: 'pk_xxx' }
+// }
+```
+
+### Coupons
+
+```typescript
+// Validate coupon
 const result = await client.shop.validateCoupon('SAVE10', 50000);
 // { valid: true, discount_amount: 5000, coupon: { ... } }
 
-// 내 쿠폰 목록
+// My coupons
 const coupons = await client.shop.myCoupons();
 ```
 
-### 배송 설정
+### Digital Downloads (Auth Required)
+
+```typescript
+// Get all my downloads
+const downloads = await client.shop.getMyDownloads();
+
+// Get downloads for specific order
+const orderDownloads = await client.shop.getOrderDownloads('ORD-123');
+
+// Get download URL
+const downloadUrl = await client.shop.downloadFile(token);
+
+// Get download info without downloading
+const info = await client.shop.getDownloadInfo(token);
+// {
+//   id, token, file: { name, file_size_human, extension },
+//   download_count, download_limit, remaining_downloads,
+//   can_download, blocked_reason, expires_at
+// }
+```
+
+### Subscriptions (Auth Required)
+
+```typescript
+// Get my subscriptions
+const subscriptions = await client.shop.getSubscriptions();
+
+// Get subscription detail
+const subscription = await client.shop.getSubscription(id);
+// {
+//   id, product, plan: { interval, price, trial_days, features },
+//   status, is_active, on_trial, current_period_end, ...
+// }
+
+// Create subscription (requires Stripe payment method)
+const { subscription, client_secret } = await client.shop.createSubscription({
+  plan_id: 1,
+  payment_method_id: 'pm_xxx',
+});
+
+// Create setup intent for adding payment method
+const { client_secret } = await client.shop.createSetupIntent();
+
+// Cancel subscription
+await client.shop.cancelSubscription(id);           // At end of period
+await client.shop.cancelSubscription(id, true);     // Immediately
+
+// Pause/Resume subscription
+await client.shop.pauseSubscription(id);
+await client.shop.resumeSubscription(id);
+```
+
+### Bundle Products
 
 ```typescript
-const settings = await client.shop.getShippingSettings();
-// { base_fee, free_shipping_threshold, ... }
+// Get bundle items and pricing
+const bundle = await client.shop.getBundleItems('product-slug');
+// {
+//   items: [{ product_id, name, quantity, unit_price, subtotal }],
+//   original_total: 100000,
+//   discount_type: 'percent',
+//   discount_value: 20,
+//   discount_amount: 20000,
+//   final_price: 80000,
+//   savings_percent: 20
+// }
 ```
 
 ---
 
 ## Reservation API
 
-### 공개 API
+### Public API
 
 ```typescript
-// 예약 설정
+// Reservation settings
 const settings = await client.reservation.getSettings();
 
-// 서비스 목록
+// Services list
 const services = await client.reservation.listServices();
 
-// 담당자 목록
+// Staff list
 const staff = await client.reservation.listStaff(serviceId);
 
-// 예약 가능 날짜
+// Available dates
 const dates = await client.reservation.getAvailableDates({
   service_id: 1,
   staff_id: 2,
@@ -400,7 +547,7 @@ const dates = await client.reservation.getAvailableDates({
   end_date: '2026-01-31',
 });
 
-// 예약 가능 시간
+// Available time slots
 const slots = await client.reservation.getAvailableSlots({
   service_id: 1,
   date: '2026-01-15',
@@ -408,10 +555,10 @@ const slots = await client.reservation.getAvailableSlots({
 });
 ```
 
-### 예약 관리 (인증 필요)
+### Reservation Management (Auth Required)
 
 ```typescript
-// 예약 생성
+// Create reservation
 await client.reservation.create({
   service_id: 1,
   staff_id: 2,
@@ -420,18 +567,18 @@ await client.reservation.create({
   customer_name: 'John Doe',
   customer_phone: '010-1234-5678',
   customer_email: 'john@example.com',
-  notes: '요청사항',
+  notes: 'Special request',
 });
 
-// 내 예약 목록
+// My reservations
 const { data } = await client.reservation.list({ status: 'confirmed' });
 
-// 다가오는/지난 예약
+// Upcoming/Past reservations
 const upcoming = await client.reservation.upcoming(5);
 const past = await client.reservation.past(10);
 
-// 예약 취소
-await client.reservation.cancel('RES-20260115-001', '일정 변경');
+// Cancel reservation
+await client.reservation.cancel('RES-20260115-001', 'Schedule change');
 ```
 
 ---
@@ -439,38 +586,38 @@ await client.reservation.cancel('RES-20260115-001', '일정 변경');
 ## Forms API
 
 ```typescript
-// 폼 목록
+// List forms
 const { data: forms } = await client.forms.list();
 
-// 폼 상세 (필드 정보 포함)
+// Get form (includes field definitions)
 const form = await client.forms.get('contact');
 
-// 폼 제출
+// Submit form
 await client.forms.submit('contact', {
   name: 'John Doe',
   email: 'john@example.com',
   message: 'Hello!',
 });
 
-// 내 제출 목록 (인증 필요)
+// My submissions (auth required)
 const { data: submissions } = await client.forms.mySubmissions();
 ```
 
 ---
 
-## Media API (인증 필요)
+## Media API (Auth Required)
 
 ```typescript
-// 파일 업로드
+// Upload file
 const media = await client.media.upload(file);
 
-// 여러 파일 업로드
+// Upload multiple files
 const mediaList = await client.media.uploadMultiple([file1, file2]);
 
-// 내 미디어 목록
+// My media list
 const { data: myMedia } = await client.media.list({ type: 'image/jpeg' });
 
-// 미디어 삭제
+// Delete media
 await client.media.delete(mediaId);
 ```
 
@@ -478,18 +625,18 @@ await client.media.delete(mediaId);
 
 ## Custom Entities API
 
-동적 데이터 구조 생성/관리
+Dynamic data structure creation and management.
 
-### 엔티티 정의
+### Entity Definition
 
 ```typescript
-// 엔티티 목록
+// List entities
 const entities = await client.entities.list();
 
-// 엔티티 조회
+// Get entity
 const entity = await client.entities.get('customers');
 
-// 엔티티 생성
+// Create entity
 await client.entities.create({
   name: 'Customer',
   slug: 'customers',
@@ -505,36 +652,36 @@ await client.entities.create({
   },
 });
 
-// 엔티티 수정/삭제
+// Update/Delete entity
 await client.entities.update('customers', { name: 'Clients' });
 await client.entities.delete('customers', true);  // force
 ```
 
-### 레코드
+### Records
 
 ```typescript
-// 레코드 목록
+// List records
 const { data: records } = await client.entities.listRecords('customers', {
   search: 'ACME',
   filters: JSON.stringify({ status: 'active' }),
 });
 
-// 레코드 조회
+// Get record
 const record = await client.entities.getRecord('customers', 1);
 
-// 레코드 생성
+// Create record
 await client.entities.createRecord('customers', {
   company: 'ACME Corp',
   email: 'contact@acme.com',
   status: 'active',
 });
 
-// 레코드 수정/삭제
+// Update/Delete record
 await client.entities.updateRecord('customers', 1, { status: 'inactive' });
 await client.entities.deleteRecord('customers', 1);
 ```
 
-### TypeScript 지원
+### TypeScript Support
 
 ```typescript
 interface Customer {
@@ -549,13 +696,13 @@ const { data } = await customers.list();  // data: Customer[]
 
 ---
 
-## 응답 타입
+## Response Types
 
-모든 목록 API는 일관된 형식 반환:
+All list APIs return consistent format:
 
 ```typescript
 interface ListResponse<T> {
-  data: T[];  // 항상 배열, null 아님
+  data: T[];  // Always array, never null
   meta: {
     current_page: number;
     last_page: number;
@@ -569,15 +716,15 @@ interface ListResponse<T> {
 
 ---
 
-## 에러 처리
+## Error Handling
 
 ```typescript
-import { Promptly, PromptlyError } from '@diffsome/sdk';
+import { Diffsome, DiffsomeError } from '@diffsome/sdk';
 
 try {
   await client.auth.login({ email: 'wrong@email.com', password: 'wrong' });
 } catch (error) {
-  if (error instanceof PromptlyError) {
+  if (error instanceof DiffsomeError) {
     console.log(error.message);  // "Invalid credentials"
     console.log(error.status);   // 401
     console.log(error.errors);   // { email: ["Invalid email or password"] }
@@ -587,7 +734,7 @@ try {
 
 ---
 
-## React 예시
+## React Example
 
 ```tsx
 'use client';
@@ -595,10 +742,10 @@ try {
 import { useState, useEffect } from 'react';
 import { Diffsome } from '@diffsome/sdk';
 
-// 싱글톤 클라이언트
+// Singleton client
 const client = new Diffsome({
-  tenantId: process.env.NEXT_PUBLIC_PROMPTLY_TENANT_ID!,
-  apiKey: process.env.NEXT_PUBLIC_PROMPTLY_API_KEY!,
+  tenantId: process.env.NEXT_PUBLIC_DIFFSOME_TENANT_ID!,
+  apiKey: process.env.NEXT_PUBLIC_DIFFSOME_API_KEY!,
   persistToken: true,
 });
 
@@ -631,37 +778,56 @@ function BlogList() {
 
 ## Changelog
 
+### v3.2.0
+- Bundle product support
+- `getBundleItems()` API
+- Product type filter (`listProductsByType()`)
+
+### v3.1.0
+- Subscription management API
+- `getSubscriptions()`, `createSubscription()`, `cancelSubscription()`
+- `pauseSubscription()`, `resumeSubscription()`
+- Stripe setup intent for payment method
+
+### v3.0.0
+- **Breaking:** Renamed from `Promptly` to `Diffsome`
+- **Breaking:** Storage key changed from `promptly_auth_token_` to `diffsome_auth_token_`
+- Digital download API (`getMyDownloads()`, `downloadFile()`)
+- Wishlist API (full CRUD + bulk operations)
+- Guest cart with session persistence
+- Stripe payment integration
+
 ### v2.18.0
-- 상품 리뷰 API 추가
-- 배송 설정 API 추가
+- Product review API
+- Shipping settings API
 
 ### v2.15.0
-- 토스페이먼츠 결제 API 추가
+- Toss Payments integration
 
 ### v2.12.0
-- 블로그 카테고리/태그 필터 추가
-- `category`, `tags`, `views`, `published_at` 필드 추가
+- Blog category/tag filters
+- Added `category`, `tags`, `views`, `published_at` fields
 
 ### v2.10.0
-- `persistToken` 옵션 추가 (토큰 자동 저장)
-- `onAuthStateChange` 콜백 추가
-- `storageType` 옵션 추가
+- `persistToken` option for auto token storage
+- `onAuthStateChange` callback
+- `storageType` option
 
 ### v2.5.0
-- 게시판 비밀글 지원 (`is_secret`, `is_mine`)
+- Secret posts support (`is_secret`, `is_mine`)
 
 ### v2.3.0
-- 다형성 댓글 API (board, blog, standalone)
+- Polymorphic comments API (board, blog, standalone)
 
 ### v2.0.0
-- **Breaking:** API key 필수
+- **Breaking:** API key required
 
 ### v1.3.0
-- `ListResponse<T>` 통일
-- 예약 시스템 지원
+- `ListResponse<T>` unified format
+- Reservation system support
 
 ---
 
-## 라이선스
+## License
 
 MIT