@back23/promptly-sdk 2.8.0 → 2.10.0

package/dist/index.d.mts

@@ -583,6 +583,73 @@ interface PaymentCancelData {
     cancel_reason: string;
     cancel_amount?: number;
 }
+interface TossPaymentReadyData {
+    order_number: string;
+    success_url: string;
+    fail_url: string;
+}
+interface TossPaymentReadyResponse {
+    success: boolean;
+    payment_id: number;
+    order_id: string;
+    order_name: string;
+    amount: number;
+    customer_name: string;
+    customer_email: string;
+    success_url: string;
+    fail_url: string;
+    client_key: string;
+}
+interface TossPaymentConfirmData {
+    payment_key: string;
+    order_id: string;
+    amount: number;
+}
+interface TossPaymentConfirmResponse {
+    order_number: string;
+    status: string;
+    status_label: string;
+    payment_status: string;
+    payment?: {
+        method: string;
+        method_label: string;
+        method_detail?: string;
+        receipt_url?: string;
+        approved_at?: string;
+    };
+}
+interface StripeCheckoutData {
+    order_number: string;
+    success_url: string;
+    cancel_url: string;
+}
+interface StripeCheckoutResponse {
+    success: boolean;
+    session_id: string;
+    checkout_url: string;
+}
+interface StripeVerifyData {
+    session_id: string;
+}
+interface StripeVerifyResponse {
+    order_number: string;
+    status: string;
+    status_label: string;
+    payment_status: string;
+    payment?: {
+        method: string;
+        approved_at?: string;
+    };
+}
+interface PaymentStatusResponse {
+    toss: {
+        available: boolean;
+    };
+    stripe: {
+        available: boolean;
+        publishable_key?: string;
+    };
+}
 type CouponType = 'fixed' | 'percent';
 interface Coupon {
     id: number;
@@ -611,6 +678,62 @@ interface CouponValidation {
     discount_amount?: number;
     coupon?: Coupon;
 }
+interface ProductReviewAuthor {
+    id: number;
+    name: string;
+}
+interface ProductReview {
+    id: number;
+    rating: number;
+    title?: string;
+    content: string;
+    images?: string[];
+    is_verified_purchase: boolean;
+    is_featured: boolean;
+    helpful_count: number;
+    author?: ProductReviewAuthor;
+    admin_reply?: string;
+    admin_replied_at?: string;
+    product?: {
+        id: number;
+        name: string;
+        slug: string;
+        thumbnail?: string;
+    };
+    created_at: string;
+    updated_at: string;
+}
+interface ProductReviewStats {
+    average_rating: number;
+    total_count: number;
+    rating_counts: {
+        5: number;
+        4: number;
+        3: number;
+        2: number;
+        1: number;
+    };
+}
+interface ProductReviewListParams extends ListParams {
+    rating?: number;
+    sort?: 'newest' | 'oldest' | 'highest' | 'lowest' | 'helpful';
+}
+interface CreateProductReviewData {
+    rating: number;
+    title?: string;
+    content: string;
+    images?: string[];
+}
+interface UpdateProductReviewData {
+    rating?: number;
+    title?: string;
+    content?: string;
+    images?: string[];
+}
+interface CanReviewResponse {
+    can_review: boolean;
+    reason?: 'not_logged_in' | 'already_reviewed' | 'not_purchased';
+}
 
 /**
  * Custom Entity types for Promptly SDK
@@ -1225,18 +1348,46 @@ declare class ShopResource {
      */
     getPayment(orderId: number): Promise<Payment>;
     /**
-     * Prepare payment (get payment key)
+     * Get payment status (available payment methods)
+     */
+    getPaymentStatus(): Promise<PaymentStatusResponse>;
+    /**
+     * Prepare Toss payment (get client key and payment info)
+     */
+    tossPaymentReady(data: TossPaymentReadyData): Promise<TossPaymentReadyResponse>;
+    /**
+     * Confirm Toss payment (after redirect)
+     */
+    tossPaymentConfirm(data: TossPaymentConfirmData): Promise<TossPaymentConfirmResponse>;
+    /**
+     * Cancel Toss payment
+     */
+    tossPaymentCancel(orderNumber: string, cancelReason: string, cancelAmount?: number): Promise<void>;
+    /**
+     * Create Stripe Checkout Session
+     */
+    stripeCheckout(data: StripeCheckoutData): Promise<StripeCheckoutResponse>;
+    /**
+     * Verify Stripe payment (after redirect)
+     */
+    stripeVerify(data: StripeVerifyData): Promise<StripeVerifyResponse>;
+    /**
+     * Refund Stripe payment
+     */
+    stripeRefund(orderNumber: string, reason?: string, amount?: number): Promise<void>;
+    /**
+     * @deprecated Use tossPaymentReady instead
      */
     preparePayment(data: PaymentReadyData): Promise<{
         paymentKey: string;
         orderId: string;
     }>;
     /**
-     * Confirm payment (after Toss redirect)
+     * @deprecated Use tossPaymentConfirm instead
      */
     confirmPayment(data: PaymentConfirmData): Promise<Payment>;
     /**
-     * Cancel payment
+     * @deprecated Use tossPaymentCancel instead
      */
     cancelPayment(paymentId: number, data: PaymentCancelData): Promise<Payment>;
     /**
@@ -1248,6 +1399,48 @@ declare class ShopResource {
      * @returns Array of coupons (always an array)
      */
     myCoupons(): Promise<Coupon[]>;
+    /**
+     * Get reviews for a product
+     * @param productSlug - Product slug
+     * @param params - Optional list params (rating, sort, per_page)
+     * @returns Reviews with stats
+     */
+    getProductReviews(productSlug: string, params?: ProductReviewListParams): Promise<{
+        data: ProductReview[];
+        meta: any;
+        stats: ProductReviewStats;
+    }>;
+    /**
+     * Check if current user can review a product
+     * Requires: logged in + purchased the product + not already reviewed
+     */
+    canReviewProduct(productSlug: string): Promise<CanReviewResponse>;
+    /**
+     * Create a product review (requires purchase)
+     */
+    createReview(productSlug: string, data: CreateProductReviewData): Promise<ProductReview>;
+    /**
+     * Update your own review
+     */
+    updateReview(reviewId: number, data: UpdateProductReviewData): Promise<ProductReview>;
+    /**
+     * Delete your own review
+     */
+    deleteReview(reviewId: number): Promise<void>;
+    /**
+     * Mark a review as helpful
+     */
+    markReviewHelpful(reviewId: number): Promise<{
+        helpful_count: number;
+    }>;
+    /**
+     * Get my reviews
+     * @returns Array of reviews written by the current user
+     */
+    myReviews(params?: {
+        per_page?: number;
+        page?: number;
+    }): Promise<ListResponse<ProductReview>>;
 }
 
 /**
@@ -1632,4 +1825,4 @@ declare class Promptly {
     getApiKey(): string | null;
 }
 
-export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogListParams, type BlogPost, type Board, type BoardComment, type BoardListParams, type BoardPost, type Cart, type CartItem, type CartShippingInfo, type Comment, type CommentCreateData, type CommentDeleteData, type CommentListParams, type CommentListResponse, type CommentUpdateData, type Coupon, type CouponType, type CouponValidation, type CreateCommentData, type CreateEntityData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateReservationData, type CreateReservationResult, type CustomEntity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormField, type FormFieldOption, type FormFieldType, type FormFieldValidation, type FormListParams, type FormSettings, type FormSubmission, type ListParams, type ListResponse, type LoginCredentials, type Media, type Member, type Order, type OrderItem, type OrderListParams, type OrderOrderer, type OrderShipping, type OrderStatus, type PaginatedResponse, type PaginationMeta, type Payment, type PaymentCancelData, type PaymentConfirmData, type PaymentMethod, type PaymentReadyData, type PaymentStatus, type PostListParams, type Product, type ProductCategory, type ProductListParams, type ProductOption, type ProductOptionValue, type ProductStatus, type ProductVariant, Promptly, type PromptlyConfig, PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, type ReservationStaffSummary, type ResetPasswordData, type SocialAuthUrl, type SocialProvider, type SubmissionListParams, type SubmitFormData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProfileData, Promptly as default };
+export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogListParams, type BlogPost, type Board, type BoardComment, type BoardListParams, type BoardPost, type CanReviewResponse, type Cart, type CartItem, type CartShippingInfo, type Comment, type CommentCreateData, type CommentDeleteData, type CommentListParams, type CommentListResponse, type CommentUpdateData, type Coupon, type CouponType, type CouponValidation, type CreateCommentData, type CreateEntityData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateProductReviewData, type CreateReservationData, type CreateReservationResult, type CustomEntity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormField, type FormFieldOption, type FormFieldType, type FormFieldValidation, type FormListParams, type FormSettings, type FormSubmission, type ListParams, type ListResponse, type LoginCredentials, type Media, type Member, type Order, type OrderItem, type OrderListParams, type OrderOrderer, type OrderShipping, type OrderStatus, type PaginatedResponse, type PaginationMeta, type Payment, type PaymentCancelData, type PaymentConfirmData, type PaymentMethod, type PaymentReadyData, type PaymentStatus, type PaymentStatusResponse, type PostListParams, type Product, type ProductCategory, type ProductListParams, type ProductOption, type ProductOptionValue, type ProductReview, type ProductReviewAuthor, type ProductReviewListParams, type ProductReviewStats, type ProductStatus, type ProductVariant, Promptly, type PromptlyConfig, PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, type ReservationStaffSummary, type ResetPasswordData, type SocialAuthUrl, type SocialProvider, type StripeCheckoutData, type StripeCheckoutResponse, type StripeVerifyData, type StripeVerifyResponse, type SubmissionListParams, type SubmitFormData, type TossPaymentConfirmData, type TossPaymentConfirmResponse, type TossPaymentReadyData, type TossPaymentReadyResponse, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProductReviewData, type UpdateProfileData, Promptly as default };

package/dist/index.d.ts

@@ -583,6 +583,73 @@ interface PaymentCancelData {
     cancel_reason: string;
     cancel_amount?: number;
 }
+interface TossPaymentReadyData {
+    order_number: string;
+    success_url: string;
+    fail_url: string;
+}
+interface TossPaymentReadyResponse {
+    success: boolean;
+    payment_id: number;
+    order_id: string;
+    order_name: string;
+    amount: number;
+    customer_name: string;
+    customer_email: string;
+    success_url: string;
+    fail_url: string;
+    client_key: string;
+}
+interface TossPaymentConfirmData {
+    payment_key: string;
+    order_id: string;
+    amount: number;
+}
+interface TossPaymentConfirmResponse {
+    order_number: string;
+    status: string;
+    status_label: string;
+    payment_status: string;
+    payment?: {
+        method: string;
+        method_label: string;
+        method_detail?: string;
+        receipt_url?: string;
+        approved_at?: string;
+    };
+}
+interface StripeCheckoutData {
+    order_number: string;
+    success_url: string;
+    cancel_url: string;
+}
+interface StripeCheckoutResponse {
+    success: boolean;
+    session_id: string;
+    checkout_url: string;
+}
+interface StripeVerifyData {
+    session_id: string;
+}
+interface StripeVerifyResponse {
+    order_number: string;
+    status: string;
+    status_label: string;
+    payment_status: string;
+    payment?: {
+        method: string;
+        approved_at?: string;
+    };
+}
+interface PaymentStatusResponse {
+    toss: {
+        available: boolean;
+    };
+    stripe: {
+        available: boolean;
+        publishable_key?: string;
+    };
+}
 type CouponType = 'fixed' | 'percent';
 interface Coupon {
     id: number;
@@ -611,6 +678,62 @@ interface CouponValidation {
     discount_amount?: number;
     coupon?: Coupon;
 }
+interface ProductReviewAuthor {
+    id: number;
+    name: string;
+}
+interface ProductReview {
+    id: number;
+    rating: number;
+    title?: string;
+    content: string;
+    images?: string[];
+    is_verified_purchase: boolean;
+    is_featured: boolean;
+    helpful_count: number;
+    author?: ProductReviewAuthor;
+    admin_reply?: string;
+    admin_replied_at?: string;
+    product?: {
+        id: number;
+        name: string;
+        slug: string;
+        thumbnail?: string;
+    };
+    created_at: string;
+    updated_at: string;
+}
+interface ProductReviewStats {
+    average_rating: number;
+    total_count: number;
+    rating_counts: {
+        5: number;
+        4: number;
+        3: number;
+        2: number;
+        1: number;
+    };
+}
+interface ProductReviewListParams extends ListParams {
+    rating?: number;
+    sort?: 'newest' | 'oldest' | 'highest' | 'lowest' | 'helpful';
+}
+interface CreateProductReviewData {
+    rating: number;
+    title?: string;
+    content: string;
+    images?: string[];
+}
+interface UpdateProductReviewData {
+    rating?: number;
+    title?: string;
+    content?: string;
+    images?: string[];
+}
+interface CanReviewResponse {
+    can_review: boolean;
+    reason?: 'not_logged_in' | 'already_reviewed' | 'not_purchased';
+}
 
 /**
  * Custom Entity types for Promptly SDK
@@ -1225,18 +1348,46 @@ declare class ShopResource {
      */
     getPayment(orderId: number): Promise<Payment>;
     /**
-     * Prepare payment (get payment key)
+     * Get payment status (available payment methods)
+     */
+    getPaymentStatus(): Promise<PaymentStatusResponse>;
+    /**
+     * Prepare Toss payment (get client key and payment info)
+     */
+    tossPaymentReady(data: TossPaymentReadyData): Promise<TossPaymentReadyResponse>;
+    /**
+     * Confirm Toss payment (after redirect)
+     */
+    tossPaymentConfirm(data: TossPaymentConfirmData): Promise<TossPaymentConfirmResponse>;
+    /**
+     * Cancel Toss payment
+     */
+    tossPaymentCancel(orderNumber: string, cancelReason: string, cancelAmount?: number): Promise<void>;
+    /**
+     * Create Stripe Checkout Session
+     */
+    stripeCheckout(data: StripeCheckoutData): Promise<StripeCheckoutResponse>;
+    /**
+     * Verify Stripe payment (after redirect)
+     */
+    stripeVerify(data: StripeVerifyData): Promise<StripeVerifyResponse>;
+    /**
+     * Refund Stripe payment
+     */
+    stripeRefund(orderNumber: string, reason?: string, amount?: number): Promise<void>;
+    /**
+     * @deprecated Use tossPaymentReady instead
      */
     preparePayment(data: PaymentReadyData): Promise<{
         paymentKey: string;
         orderId: string;
     }>;
     /**
-     * Confirm payment (after Toss redirect)
+     * @deprecated Use tossPaymentConfirm instead
      */
     confirmPayment(data: PaymentConfirmData): Promise<Payment>;
     /**
-     * Cancel payment
+     * @deprecated Use tossPaymentCancel instead
      */
     cancelPayment(paymentId: number, data: PaymentCancelData): Promise<Payment>;
     /**
@@ -1248,6 +1399,48 @@ declare class ShopResource {
      * @returns Array of coupons (always an array)
      */
     myCoupons(): Promise<Coupon[]>;
+    /**
+     * Get reviews for a product
+     * @param productSlug - Product slug
+     * @param params - Optional list params (rating, sort, per_page)
+     * @returns Reviews with stats
+     */
+    getProductReviews(productSlug: string, params?: ProductReviewListParams): Promise<{
+        data: ProductReview[];
+        meta: any;
+        stats: ProductReviewStats;
+    }>;
+    /**
+     * Check if current user can review a product
+     * Requires: logged in + purchased the product + not already reviewed
+     */
+    canReviewProduct(productSlug: string): Promise<CanReviewResponse>;
+    /**
+     * Create a product review (requires purchase)
+     */
+    createReview(productSlug: string, data: CreateProductReviewData): Promise<ProductReview>;
+    /**
+     * Update your own review
+     */
+    updateReview(reviewId: number, data: UpdateProductReviewData): Promise<ProductReview>;
+    /**
+     * Delete your own review
+     */
+    deleteReview(reviewId: number): Promise<void>;
+    /**
+     * Mark a review as helpful
+     */
+    markReviewHelpful(reviewId: number): Promise<{
+        helpful_count: number;
+    }>;
+    /**
+     * Get my reviews
+     * @returns Array of reviews written by the current user
+     */
+    myReviews(params?: {
+        per_page?: number;
+        page?: number;
+    }): Promise<ListResponse<ProductReview>>;
 }
 
 /**
@@ -1632,4 +1825,4 @@ declare class Promptly {
     getApiKey(): string | null;
 }
 
-export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogListParams, type BlogPost, type Board, type BoardComment, type BoardListParams, type BoardPost, type Cart, type CartItem, type CartShippingInfo, type Comment, type CommentCreateData, type CommentDeleteData, type CommentListParams, type CommentListResponse, type CommentUpdateData, type Coupon, type CouponType, type CouponValidation, type CreateCommentData, type CreateEntityData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateReservationData, type CreateReservationResult, type CustomEntity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormField, type FormFieldOption, type FormFieldType, type FormFieldValidation, type FormListParams, type FormSettings, type FormSubmission, type ListParams, type ListResponse, type LoginCredentials, type Media, type Member, type Order, type OrderItem, type OrderListParams, type OrderOrderer, type OrderShipping, type OrderStatus, type PaginatedResponse, type PaginationMeta, type Payment, type PaymentCancelData, type PaymentConfirmData, type PaymentMethod, type PaymentReadyData, type PaymentStatus, type PostListParams, type Product, type ProductCategory, type ProductListParams, type ProductOption, type ProductOptionValue, type ProductStatus, type ProductVariant, Promptly, type PromptlyConfig, PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, type ReservationStaffSummary, type ResetPasswordData, type SocialAuthUrl, type SocialProvider, type SubmissionListParams, type SubmitFormData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProfileData, Promptly as default };
+export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogListParams, type BlogPost, type Board, type BoardComment, type BoardListParams, type BoardPost, type CanReviewResponse, type Cart, type CartItem, type CartShippingInfo, type Comment, type CommentCreateData, type CommentDeleteData, type CommentListParams, type CommentListResponse, type CommentUpdateData, type Coupon, type CouponType, type CouponValidation, type CreateCommentData, type CreateEntityData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateProductReviewData, type CreateReservationData, type CreateReservationResult, type CustomEntity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormField, type FormFieldOption, type FormFieldType, type FormFieldValidation, type FormListParams, type FormSettings, type FormSubmission, type ListParams, type ListResponse, type LoginCredentials, type Media, type Member, type Order, type OrderItem, type OrderListParams, type OrderOrderer, type OrderShipping, type OrderStatus, type PaginatedResponse, type PaginationMeta, type Payment, type PaymentCancelData, type PaymentConfirmData, type PaymentMethod, type PaymentReadyData, type PaymentStatus, type PaymentStatusResponse, type PostListParams, type Product, type ProductCategory, type ProductListParams, type ProductOption, type ProductOptionValue, type ProductReview, type ProductReviewAuthor, type ProductReviewListParams, type ProductReviewStats, type ProductStatus, type ProductVariant, Promptly, type PromptlyConfig, PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, type ReservationStaffSummary, type ResetPasswordData, type SocialAuthUrl, type SocialProvider, type StripeCheckoutData, type StripeCheckoutResponse, type StripeVerifyData, type StripeVerifyResponse, type SubmissionListParams, type SubmitFormData, type TossPaymentConfirmData, type TossPaymentConfirmResponse, type TossPaymentReadyData, type TossPaymentReadyResponse, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProductReviewData, type UpdateProfileData, Promptly as default };

package/dist/index.js

@@ -820,19 +820,78 @@ var ShopResource = class {
     return this.http.get(`/orders/${orderId}/payment`);
   }
   /**
-   * Prepare payment (get payment key)
+   * Get payment status (available payment methods)
+   */
+  async getPaymentStatus() {
+    return this.http.get("/payments/status");
+  }
+  // ============================================
+  // Toss Payments
+  // ============================================
+  /**
+   * Prepare Toss payment (get client key and payment info)
+   */
+  async tossPaymentReady(data) {
+    return this.http.post("/payments/toss/ready", data);
+  }
+  /**
+   * Confirm Toss payment (after redirect)
+   */
+  async tossPaymentConfirm(data) {
+    return this.http.post("/payments/toss/confirm", data);
+  }
+  /**
+   * Cancel Toss payment
+   */
+  async tossPaymentCancel(orderNumber, cancelReason, cancelAmount) {
+    await this.http.post("/payments/toss/cancel", {
+      order_number: orderNumber,
+      cancel_reason: cancelReason,
+      cancel_amount: cancelAmount
+    });
+  }
+  // ============================================
+  // Stripe Payments
+  // ============================================
+  /**
+   * Create Stripe Checkout Session
+   */
+  async stripeCheckout(data) {
+    return this.http.post("/payments/stripe/checkout", data);
+  }
+  /**
+   * Verify Stripe payment (after redirect)
+   */
+  async stripeVerify(data) {
+    return this.http.post("/payments/stripe/verify", data);
+  }
+  /**
+   * Refund Stripe payment
+   */
+  async stripeRefund(orderNumber, reason, amount) {
+    await this.http.post("/payments/stripe/refund", {
+      order_number: orderNumber,
+      reason,
+      amount
+    });
+  }
+  // ============================================
+  // Legacy Payment Methods (deprecated)
+  // ============================================
+  /**
+   * @deprecated Use tossPaymentReady instead
    */
   async preparePayment(data) {
     return this.http.post(`/payments/ready`, data);
   }
   /**
-   * Confirm payment (after Toss redirect)
+   * @deprecated Use tossPaymentConfirm instead
    */
   async confirmPayment(data) {
     return this.http.post("/payments/confirm", data);
   }
   /**
-   * Cancel payment
+   * @deprecated Use tossPaymentCancel instead
    */
   async cancelPayment(paymentId, data) {
     return this.http.post(`/payments/${paymentId}/cancel`, data);
@@ -857,6 +916,67 @@ var ShopResource = class {
     const response = await this.http.getList("/coupons");
     return response.data;
   }
+  // ============================================
+  // Product Reviews
+  // ============================================
+  /**
+   * Get reviews for a product
+   * @param productSlug - Product slug
+   * @param params - Optional list params (rating, sort, per_page)
+   * @returns Reviews with stats
+   */
+  async getProductReviews(productSlug, params) {
+    return this.http.get(`/products/${productSlug}/reviews`, params);
+  }
+  /**
+   * Check if current user can review a product
+   * Requires: logged in + purchased the product + not already reviewed
+   */
+  async canReviewProduct(productSlug) {
+    const response = await this.http.get(
+      `/products/${productSlug}/reviews/can-review`
+    );
+    return response;
+  }
+  /**
+   * Create a product review (requires purchase)
+   */
+  async createReview(productSlug, data) {
+    const response = await this.http.post(
+      `/products/${productSlug}/reviews`,
+      data
+    );
+    return response.data;
+  }
+  /**
+   * Update your own review
+   */
+  async updateReview(reviewId, data) {
+    const response = await this.http.put(
+      `/reviews/${reviewId}`,
+      data
+    );
+    return response.data;
+  }
+  /**
+   * Delete your own review
+   */
+  async deleteReview(reviewId) {
+    await this.http.delete(`/reviews/${reviewId}`);
+  }
+  /**
+   * Mark a review as helpful
+   */
+  async markReviewHelpful(reviewId) {
+    return this.http.post(`/reviews/${reviewId}/helpful`);
+  }
+  /**
+   * Get my reviews
+   * @returns Array of reviews written by the current user
+   */
+  async myReviews(params) {
+    return this.http.getList("/my/reviews", params);
+  }
 };
 
 // src/resources/media.ts

package/dist/index.mjs

@@ -792,19 +792,78 @@ var ShopResource = class {
     return this.http.get(`/orders/${orderId}/payment`);
   }
   /**
-   * Prepare payment (get payment key)
+   * Get payment status (available payment methods)
+   */
+  async getPaymentStatus() {
+    return this.http.get("/payments/status");
+  }
+  // ============================================
+  // Toss Payments
+  // ============================================
+  /**
+   * Prepare Toss payment (get client key and payment info)
+   */
+  async tossPaymentReady(data) {
+    return this.http.post("/payments/toss/ready", data);
+  }
+  /**
+   * Confirm Toss payment (after redirect)
+   */
+  async tossPaymentConfirm(data) {
+    return this.http.post("/payments/toss/confirm", data);
+  }
+  /**
+   * Cancel Toss payment
+   */
+  async tossPaymentCancel(orderNumber, cancelReason, cancelAmount) {
+    await this.http.post("/payments/toss/cancel", {
+      order_number: orderNumber,
+      cancel_reason: cancelReason,
+      cancel_amount: cancelAmount
+    });
+  }
+  // ============================================
+  // Stripe Payments
+  // ============================================
+  /**
+   * Create Stripe Checkout Session
+   */
+  async stripeCheckout(data) {
+    return this.http.post("/payments/stripe/checkout", data);
+  }
+  /**
+   * Verify Stripe payment (after redirect)
+   */
+  async stripeVerify(data) {
+    return this.http.post("/payments/stripe/verify", data);
+  }
+  /**
+   * Refund Stripe payment
+   */
+  async stripeRefund(orderNumber, reason, amount) {
+    await this.http.post("/payments/stripe/refund", {
+      order_number: orderNumber,
+      reason,
+      amount
+    });
+  }
+  // ============================================
+  // Legacy Payment Methods (deprecated)
+  // ============================================
+  /**
+   * @deprecated Use tossPaymentReady instead
    */
   async preparePayment(data) {
     return this.http.post(`/payments/ready`, data);
   }
   /**
-   * Confirm payment (after Toss redirect)
+   * @deprecated Use tossPaymentConfirm instead
    */
   async confirmPayment(data) {
     return this.http.post("/payments/confirm", data);
   }
   /**
-   * Cancel payment
+   * @deprecated Use tossPaymentCancel instead
    */
   async cancelPayment(paymentId, data) {
     return this.http.post(`/payments/${paymentId}/cancel`, data);
@@ -829,6 +888,67 @@ var ShopResource = class {
     const response = await this.http.getList("/coupons");
     return response.data;
   }
+  // ============================================
+  // Product Reviews
+  // ============================================
+  /**
+   * Get reviews for a product
+   * @param productSlug - Product slug
+   * @param params - Optional list params (rating, sort, per_page)
+   * @returns Reviews with stats
+   */
+  async getProductReviews(productSlug, params) {
+    return this.http.get(`/products/${productSlug}/reviews`, params);
+  }
+  /**
+   * Check if current user can review a product
+   * Requires: logged in + purchased the product + not already reviewed
+   */
+  async canReviewProduct(productSlug) {
+    const response = await this.http.get(
+      `/products/${productSlug}/reviews/can-review`
+    );
+    return response;
+  }
+  /**
+   * Create a product review (requires purchase)
+   */
+  async createReview(productSlug, data) {
+    const response = await this.http.post(
+      `/products/${productSlug}/reviews`,
+      data
+    );
+    return response.data;
+  }
+  /**
+   * Update your own review
+   */
+  async updateReview(reviewId, data) {
+    const response = await this.http.put(
+      `/reviews/${reviewId}`,
+      data
+    );
+    return response.data;
+  }
+  /**
+   * Delete your own review
+   */
+  async deleteReview(reviewId) {
+    await this.http.delete(`/reviews/${reviewId}`);
+  }
+  /**
+   * Mark a review as helpful
+   */
+  async markReviewHelpful(reviewId) {
+    return this.http.post(`/reviews/${reviewId}/helpful`);
+  }
+  /**
+   * Get my reviews
+   * @returns Array of reviews written by the current user
+   */
+  async myReviews(params) {
+    return this.http.getList("/my/reviews", params);
+  }
 };
 
 // src/resources/media.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@back23/promptly-sdk",
-  "version": "2.8.0",
+  "version": "2.10.0",
   "description": "Promptly AI CMS SDK for JavaScript/TypeScript",
   "main": "dist/index.js",
   "module": "dist/index.mjs",