@diffsome/sdk 3.0.0 → 3.2.0

package/dist/index.d.mts

@@ -8387,8 +8387,18 @@ interface SocialAuthUrl {
     url: string;
     provider: string;
 }
+interface BlogCategory {
+    id: number;
+    name: string;
+    slug: string;
+    description?: string;
+    color?: string;
+    icon?: string;
+    posts_count?: number;
+}
 interface BlogListParams extends ListParams {
     category?: string;
+    category_id?: number;
     tag?: string;
     search?: string;
 }
@@ -8919,6 +8929,156 @@ interface ReservationListParams extends ListParams {
     start_date?: string;
     end_date?: string;
 }
+interface WishlistItem {
+    id: number;
+    product_id: number;
+    variant_id?: number;
+    note?: string;
+    product?: {
+        id: number;
+        name: string;
+        slug: string;
+        thumbnail?: string;
+        sale_price?: number;
+        regular_price?: number;
+        status: string;
+        stock_quantity?: number;
+        in_stock: boolean;
+    };
+    variant?: {
+        id: number;
+        option_values?: Record<string, string>;
+        sale_price?: number;
+        regular_price?: number;
+        stock_quantity?: number;
+        image?: string;
+        is_active: boolean;
+    };
+    created_at: string;
+}
+interface WishlistToggleResult {
+    action: 'added' | 'removed';
+    in_wishlist: boolean;
+}
+interface WishlistCheckResult {
+    in_wishlist: boolean;
+}
+interface WishlistCheckBulkResult {
+    items: Record<string, boolean>;
+}
+interface WishlistMoveToCartResult {
+    moved: Array<{
+        id: number;
+        product_id: number;
+        variant_id?: number;
+    }>;
+    failed: Array<{
+        id: number;
+        product_id: number;
+        reason: string;
+    }>;
+    moved_count: number;
+    failed_count: number;
+}
+interface AddToWishlistData {
+    product_id: number;
+    variant_id?: number;
+    note?: string;
+}
+interface WishlistListParams extends ListParams {
+}
+type ProductType = 'physical' | 'digital' | 'subscription' | 'bundle';
+interface DigitalFile {
+    id: number;
+    name: string;
+    original_filename: string;
+    mime_type?: string;
+    file_size: number;
+    file_size_human: string;
+    extension: string;
+}
+interface DigitalDownloadLink {
+    id: number;
+    token: string;
+    file?: DigitalFile;
+    order_id: number;
+    download_count: number;
+    download_limit?: number;
+    remaining_downloads?: number;
+    can_download: boolean;
+    blocked_reason?: 'expired' | 'limit_exceeded';
+    expires_at?: string;
+    first_downloaded_at?: string;
+    last_downloaded_at?: string;
+    created_at: string;
+}
+type SubscriptionInterval = 'day' | 'week' | 'month' | 'year';
+type SubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'paused' | 'canceled' | 'expired';
+interface SubscriptionPlan {
+    id: number;
+    name?: string;
+    interval: SubscriptionInterval;
+    interval_count: number;
+    interval_label: string;
+    price: number;
+    price_display: string;
+    trial_days: number;
+    features?: string[];
+}
+interface MemberSubscription {
+    id: number;
+    product?: {
+        id: number;
+        name: string;
+        slug: string;
+        thumbnail?: string;
+    };
+    plan?: SubscriptionPlan;
+    status: SubscriptionStatus;
+    status_label: string;
+    current_price: number;
+    is_active: boolean;
+    on_trial: boolean;
+    is_canceled: boolean;
+    is_paused: boolean;
+    days_until_renewal?: number;
+    trial_ends_at?: string;
+    current_period_start?: string;
+    current_period_end?: string;
+    canceled_at?: string;
+    created_at: string;
+}
+interface CreateSubscriptionData {
+    plan_id: number;
+    payment_method_id: string;
+}
+interface CreateSubscriptionResult {
+    subscription: MemberSubscription;
+    client_secret?: string;
+}
+interface SetupIntentResult {
+    client_secret: string;
+}
+interface BundleItem {
+    product_id: number;
+    variant_id?: number;
+    name: string;
+    quantity: number;
+    unit_price: number;
+    subtotal: number;
+}
+interface BundlePricing {
+    items: BundleItem[];
+    original_total: number;
+    discount_type?: 'fixed' | 'percent';
+    discount_value: number;
+    discount_amount: number;
+    final_price: number;
+    savings_percent: number;
+}
+interface ProductListParamsExtended extends ProductListParams {
+    type?: ProductType;
+}
 
 /**
  * HTTP Client for Diffsome SDK
@@ -8974,6 +9134,10 @@ declare class HttpClient {
      * Get current API key
      */
     getApiKey(): string | null;
+    /**
+     * Get the base URL with tenant path
+     */
+    getBaseUrl(): string;
     /**
      * Set cart session ID (for guest cart persistence)
      */
@@ -9192,9 +9356,9 @@ declare class BlogResource {
     search(query: string, params?: Omit<BlogListParams, 'search'>): Promise<ListResponse<BlogPost>>;
     /**
      * Get blog categories
-     * @returns Array of category names (always an array)
+     * @returns Array of blog categories with details
      */
-    categories(): Promise<string[]>;
+    categories(): Promise<BlogCategory[]>;
     /**
      * Get blog tags
      * @returns Array of tag names (always an array)
@@ -9467,6 +9631,132 @@ declare class ShopResource {
         per_page?: number;
         page?: number;
     }): Promise<ListResponse<ProductReview>>;
+    /**
+     * Get wishlist items
+     * Requires authentication
+     */
+    getWishlist(params?: WishlistListParams): Promise<ListResponse<WishlistItem>>;
+    /**
+     * Add product to wishlist
+     * Requires authentication
+     */
+    addToWishlist(data: AddToWishlistData): Promise<WishlistItem>;
+    /**
+     * Remove item from wishlist
+     * Requires authentication
+     */
+    removeFromWishlist(wishlistId: number): Promise<void>;
+    /**
+     * Toggle wishlist (add if not in wishlist, remove if in wishlist)
+     * Requires authentication
+     */
+    toggleWishlist(productId: number, variantId?: number): Promise<WishlistToggleResult>;
+    /**
+     * Check if product is in wishlist
+     */
+    isInWishlist(productId: number, variantId?: number): Promise<boolean>;
+    /**
+     * Check multiple products' wishlist status
+     * Useful for product list pages
+     */
+    checkWishlistBulk(productIds: number[]): Promise<Record<string, boolean>>;
+    /**
+     * Get wishlist count
+     */
+    getWishlistCount(): Promise<number>;
+    /**
+     * Move wishlist items to cart
+     * @param wishlistIds - Optional array of wishlist item IDs to move. If empty, moves all items.
+     */
+    moveWishlistToCart(wishlistIds?: number[]): Promise<WishlistMoveToCartResult>;
+    /**
+     * Update wishlist item note
+     */
+    updateWishlistNote(wishlistId: number, note: string): Promise<WishlistItem>;
+    /**
+     * Get product's wishlist count (how many users added this product)
+     */
+    getProductWishlistCount(productSlug: string): Promise<number>;
+    /**
+     * Get my download links
+     * Requires authentication
+     */
+    getMyDownloads(): Promise<DigitalDownloadLink[]>;
+    /**
+     * Get download links for a specific order
+     * Requires authentication
+     */
+    getOrderDownloads(orderNumber: string): Promise<DigitalDownloadLink[]>;
+    /**
+     * Get download file URL
+     * Returns the direct download URL for the file
+     * Requires authentication
+     */
+    downloadFile(token: string): Promise<string>;
+    /**
+     * Get download link info (without triggering download)
+     * Requires authentication
+     */
+    getDownloadInfo(token: string): Promise<DigitalDownloadLink>;
+    /**
+     * Get my subscriptions
+     * Requires authentication
+     */
+    getSubscriptions(): Promise<MemberSubscription[]>;
+    /**
+     * Get subscription by ID
+     * Requires authentication
+     */
+    getSubscription(id: number): Promise<MemberSubscription>;
+    /**
+     * Create a new subscription
+     * Requires Stripe payment method ID
+     * Requires authentication
+     */
+    createSubscription(data: CreateSubscriptionData): Promise<CreateSubscriptionResult>;
+    /**
+     * Cancel subscription
+     * @param immediately - If true, cancel immediately. Otherwise, cancel at end of billing period.
+     * Requires authentication
+     */
+    cancelSubscription(id: number, immediately?: boolean): Promise<MemberSubscription>;
+    /**
+     * Pause subscription
+     * Requires authentication
+     */
+    pauseSubscription(id: number): Promise<MemberSubscription>;
+    /**
+     * Resume paused subscription
+     * Requires authentication
+     */
+    resumeSubscription(id: number): Promise<MemberSubscription>;
+    /**
+     * Create Stripe Setup Intent for adding payment method
+     * Use with Stripe.js to collect card details
+     * Requires authentication
+     */
+    createSetupIntent(): Promise<SetupIntentResult>;
+    /**
+     * Get bundle items and pricing
+     * Returns all products in the bundle with calculated pricing
+     */
+    getBundleItems(productSlug: string): Promise<BundlePricing>;
+    /**
+     * List products with type filter
+     */
+    listProductsByType(type: ProductType, params?: ProductListParams): Promise<ListResponse<Product>>;
+    /**
+     * Get digital products
+     */
+    getDigitalProducts(params?: ProductListParams): Promise<ListResponse<Product>>;
+    /**
+     * Get subscription products
+     */
+    getSubscriptionProducts(params?: ProductListParams): Promise<ListResponse<Product>>;
+    /**
+     * Get bundle products
+     */
+    getBundleProducts(params?: ProductListParams): Promise<ListResponse<Product>>;
 }
 
 /**
@@ -9807,18 +10097,6 @@ declare class Diffsome {
     /** Reservations - booking services and time slots */
     readonly reservation: ReservationResource;
     constructor(config: DiffsomeConfig);
-    /**
-     * Get site theme settings
-     */
-    getTheme(): Promise<{
-        name: string;
-        colors: Record<string, string>;
-        fonts: Record<string, string>;
-    }>;
-    /**
-     * Get site settings
-     */
-    getSettings(): Promise<Record<string, any>>;
     /**
      * Check if user is authenticated
      */
@@ -9853,4 +10131,4 @@ declare class Diffsome {
     getApiKey(): string | null;
 }
 
-export { type $defs, type AddToCartData, type ApiError, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogListParams, type BlogPost, type BlogPostCollection, type Board, type BoardCollection, type BoardComment, type BoardListParams, type BoardPost, type BoardPostCollection, type BoardPostListParams, type CanReviewResponse, type Cart, type CartItem, type CartShippingInfo, type Comment, type CommentCollection, type CommentListParams$1 as CommentListParams, type Coupon, type CouponType, type CouponValidation, type CreateBoardPostData, type CreateCommentData, type CreateEntityData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateProductReviewData, type CreateReservationData, type CreateReservationResult, type CustomEntity, Diffsome, type DiffsomeConfig, DiffsomeError, type Entity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormListParams, type FormSubmission, type FormSubmissionData, 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 ProductAttribute, type ProductAttributeValue, type ProductCategory, type ProductCategoryCollection, type ProductCollection, type ProductListParams, type ProductOption, type ProductOptionValue, type ProductReview, type ProductReviewAuthor, type ProductReviewListParams, type ProductReviewStats, type ProductStatus, type ProductVariant, Diffsome as Promptly, type PromptlyConfig, DiffsomeError as PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, 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 UpdateBoardPostData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProductReviewData, type UpdateProfileData, type components, Diffsome as default, type operations, type paths, type webhooks };
+export { type $defs, type AddToCartData, type AddToWishlistData, type ApiError, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogCategory, type BlogListParams, type BlogPost, type BlogPostCollection, type Board, type BoardCollection, type BoardComment, type BoardListParams, type BoardPost, type BoardPostCollection, type BoardPostListParams, type BundleItem, type BundlePricing, type CanReviewResponse, type Cart, type CartItem, type CartShippingInfo, type Comment, type CommentCollection, type CommentListParams$1 as CommentListParams, type Coupon, type CouponType, type CouponValidation, type CreateBoardPostData, type CreateCommentData, type CreateEntityData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateProductReviewData, type CreateReservationData, type CreateReservationResult, type CreateSubscriptionData, type CreateSubscriptionResult, type CustomEntity, Diffsome, type DiffsomeConfig, DiffsomeError, type DigitalDownloadLink, type DigitalFile, type Entity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormListParams, type FormSubmission, type FormSubmissionData, type ListParams, type ListResponse, type LoginCredentials, type Media, type Member, type MemberSubscription, 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 ProductAttribute, type ProductAttributeValue, type ProductCategory, type ProductCategoryCollection, type ProductCollection, type ProductListParams, type ProductListParamsExtended, type ProductOption, type ProductOptionValue, type ProductReview, type ProductReviewAuthor, type ProductReviewListParams, type ProductReviewStats, type ProductStatus, type ProductType, type ProductVariant, Diffsome as Promptly, type PromptlyConfig, DiffsomeError as PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, type ResetPasswordData, type SetupIntentResult, type SocialAuthUrl, type SocialProvider, type StripeCheckoutData, type StripeCheckoutResponse, type StripeVerifyData, type StripeVerifyResponse, type SubmissionListParams, type SubmitFormData, type SubscriptionInterval, type SubscriptionPlan, type SubscriptionStatus, type TossPaymentConfirmData, type TossPaymentConfirmResponse, type TossPaymentReadyData, type TossPaymentReadyResponse, type UpdateBoardPostData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProductReviewData, type UpdateProfileData, type WishlistCheckBulkResult, type WishlistCheckResult, type WishlistItem, type WishlistListParams, type WishlistMoveToCartResult, type WishlistToggleResult, type components, Diffsome as default, type operations, type paths, type webhooks };