@sazito/client-sdk 1.2.0 → 1.2.2

package/dist/index.d.ts

@@ -31,6 +31,12 @@ interface SazitoConfig {
 /**
  * Common types used throughout the SDK
  */
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+interface JsonObject {
+    [key: string]: JsonValue;
+}
+type JsonArray = JsonValue[];
 /**
  * Unified response pattern for all API calls
  * No exceptions are thrown - errors are returned in the error field
@@ -41,7 +47,7 @@ interface SazitoResponse<T> {
         status?: number;
         message: string;
         type: 'network' | 'api' | 'validation';
-        details?: any;
+        details?: JsonValue;
     };
 }
 /**
@@ -54,7 +60,7 @@ interface PaginatedResponse<T> {
     pageSize: number;
 }
 /**
- * Request options that can be passed to any API call
+ * Request options that can be passed to an API call
  */
 interface RequestOptions {
     retries?: number;
@@ -84,7 +90,6 @@ interface Image {
     alt?: string;
     width?: number;
     height?: number;
-    order?: number;
     createdAt: string;
     updatedAt: string;
 }
@@ -95,12 +100,29 @@ interface ProductAttribute {
     name: string;
     value: string;
 }
+/**
+ * Normalized product snapshot embedded in checkout entities
+ * (cart items, invoice items, successful order items).
+ */
+interface CheckoutProductSnapshot {
+    variantId: number;
+    productId?: number;
+    name: string;
+    url?: string;
+    image?: Image;
+    attributes: ProductAttribute[];
+    productType?: string;
+    hasMaxOrder?: boolean;
+    maxOrderQuantity?: number;
+    minOrderQuantity?: number;
+}
 /**
  * Region (استان)
  */
 interface Region$1 {
     id: number;
     name: string;
+    cities?: City$1[];
 }
 /**
  * City (شهر)
@@ -109,6 +131,8 @@ interface City$1 {
     id: number;
     name: string;
     regionId?: number;
+    latitude?: number;
+    longitude?: number;
 }
 
 /**
@@ -133,7 +157,7 @@ interface ProductVariant {
     dynamicFormId?: number;
     sortIndex: number;
     imageId?: number;
-    commercialFiles?: any[];
+    commercialFiles?: JsonValue[];
     createdAt: string;
     updatedAt: string;
 }
@@ -143,7 +167,7 @@ interface Product {
     url: string;
     enabled: boolean;
     productType: string;
-    themeConfig?: any;
+    themeConfig?: JsonObject;
     dynamicFormId?: number;
     eventEntityId?: number;
     attributes?: ProductAttribute[];
@@ -160,7 +184,7 @@ interface ProductCategory {
     enabled?: boolean;
     description?: string;
     productsCount?: number;
-    themeConfig?: any;
+    themeConfig?: JsonObject;
     attributes?: ProductAttribute[];
     createdAt?: string;
     updatedAt?: string;
@@ -188,36 +212,39 @@ interface ProductFilters {
  * Cart-related types
  */
 
+interface SchedulerBookingAttributes {
+    eventEntityId: string | number;
+    eventTitle?: string;
+    eventId?: string;
+    startDateTimeLocal: string;
+    endDateTimeLocal: string;
+    timezone: string;
+}
+interface UploadedFormFileAttribute {
+    serveKey: string;
+    fileName: string;
+}
+type FormAttributeValue = string | number | boolean | null | UploadedFormFileAttribute;
 interface CartProduct {
-    id: number;
-    product: {
-        variantId: number;
-        name: string;
-        url: string;
-        image: Image;
-        attributes: ProductAttribute[];
-        hasMaxOrder: boolean;
-        maxOrderQuantity: number;
-        minOrderQuantity: number;
-    };
+    id: number | string;
+    productVariantId: number;
+    quantity: number;
     unitPrice: number;
     lineTotal: number;
-    quantity: number;
-    formAttributes?: Record<string, any>;
-    bookingAttributes?: {
-        eventEntityId?: number;
-        timezone?: string;
-    };
-    formFields?: Record<string, any>;
+    product: CheckoutProductSnapshot;
+    formAttributes?: Record<string, FormAttributeValue>;
+    formFields?: JsonObject;
+    bookingAttributes?: SchedulerBookingAttributes;
 }
 interface Cart {
     id: number;
     identifier: string;
     items: CartProduct[];
-    subtotal: number;
-    total: number;
+    netTotal: number;
+    grossTotal?: number;
     needsShipping: boolean;
-    deleteCoupon: boolean;
+    minBasketLimitViolated: boolean;
+    deleteCoupon?: boolean;
 }
 interface CartCredentials {
     id: number;
@@ -226,75 +253,109 @@ interface CartCredentials {
 interface AddToCartInput {
     id: number;
     count: number;
-    formAttributes?: Record<string, any>;
-    schedulerBookingAttributes?: {
-        eventEntityId: number;
-        timezone: string;
-    };
+    formAttributes?: Record<string, FormAttributeValue>;
 }
 interface CreateCartInput {
     coupon?: string;
     variants: AddToCartInput[];
-    formAttributes?: Record<string, any>;
-    schedulerBookingAttributes?: {
-        eventEntityId: number;
-        timezone: string;
-    };
+    formAttributes?: Record<string, FormAttributeValue>;
+    schedulerBookingAttributes?: SchedulerBookingAttributes;
 }
 
 /**
  * Invoice and checkout-related types
  */
 
+interface InvoiceItemFormAttributes {
+    formId?: number;
+    formData: Record<string, {
+        label: string;
+        value: JsonValue;
+        type: string;
+    }>;
+}
 interface InvoiceItem {
-    id: number;
-    variant: {
-        id: number;
-        product: any;
-        attributes: ProductAttribute[];
-    };
-    image: Image;
+    id: number | string;
+    productVariantId: number;
+    productId?: number;
     name: string;
+    url?: string;
+    attributes: ProductAttribute[];
+    productType?: string;
+    hasMaxOrder?: boolean;
+    maxOrderQuantity?: number;
+    minOrderQuantity?: number;
+    image?: Image;
+    quantity: number;
     unitPrice: number;
     lineTotal: number;
-    quantity: number;
-    formAttributes?: Record<string, any>;
-    bookingAttributes?: Record<string, any>;
-    formFields?: Record<string, any>;
+    rawPrice: number;
+    customerProfit: number;
+    commercialFiles?: JsonValue;
+    formAttributes?: Record<string, FormAttributeValue> | InvoiceItemFormAttributes;
+    bookingAttributes?: SchedulerBookingAttributes;
+    formFields?: JsonObject;
 }
 interface ShippingItem {
-    invoiceItemIds: number[];
+    invoiceItemIds: Array<number | string>;
     rate: {
         id: number;
-        shippingMethodId: number;
-        cost: number;
-        deliveryTime: string;
-        minDays: number;
-        maxDays: number;
+        name: string;
+        price: number;
+        icon?: string;
+        color?: string;
+        type?: string;
     };
 }
+interface ShippingAddressRegion {
+    id: number;
+    name: string;
+}
+interface ShippingAddressCity {
+    id: number;
+    name: string;
+    regionId?: number;
+    latitude?: number;
+    longitude?: number;
+}
 interface ShippingAddress {
     id: number;
     identifier: string;
     firstName: string;
     lastName: string;
-    mobilePhone: string;
+    mobilePhone?: string;
     phoneNumber?: string;
     email?: string;
-    region: Region$1;
-    city: City$1;
+    region?: ShippingAddressRegion;
+    city: ShippingAddressCity;
+    address: string;
+    postalCode?: string;
+    latitude?: number;
+    longitude?: number;
+    userSetCoordinatesBefore?: boolean;
+}
+interface InvoiceShippingAddressRegion extends ShippingAddressRegion {
+    city: ShippingAddressCity;
+}
+interface InvoiceShippingAddress {
+    identifier: string;
+    firstName: string;
+    lastName: string;
+    mobilePhone?: string;
+    phoneNumber?: string;
+    email?: string;
+    region?: InvoiceShippingAddressRegion;
     address: string;
     postalCode?: string;
     latitude?: number;
     longitude?: number;
     userSetCoordinatesBefore?: boolean;
-    createdAt: string;
-    updatedAt: string;
 }
 interface User {
-    id: number;
+    id?: number;
     email?: string;
     mobilePhone?: string;
+    phoneNumber?: string;
     firstName?: string;
     lastName?: string;
     birthDate?: string;
@@ -303,21 +364,32 @@ interface Invoice {
     id: number;
     identifier: string;
     items: InvoiceItem[];
-    shippingAddress?: ShippingAddress;
+    shippingAddress?: InvoiceShippingAddress;
     shippingItems: ShippingItem[];
-    shippingMethod?: string;
     needsShipping: boolean;
-    user?: User;
-    comment?: string;
-    subtotal: number;
-    total: number;
+    userComment?: string;
+    netTotal: number;
     finalTotal: number;
+    vat: number;
+    vatPercent: number;
+    itemsDiscount: number;
     discountTotal: number;
+    customerProfit: number;
+    customerProfitPercentage: number;
+    itemsTotalRawPrice: number;
+    couponTotal: number;
     shippingTotal: number;
-    taxTotal: number;
+    creditTotal: number;
+    discountUsages: Array<{
+        discountCode: {
+            code: string;
+            userSegment?: string;
+        };
+    }>;
+    coupon?: {
+        userSegment?: string;
+    };
     discountCode?: string;
-    createdAt: string;
-    updatedAt: string;
 }
 interface InvoiceCredentials {
     id: number;
@@ -338,21 +410,25 @@ interface RefreshInvoiceInput {
  */
 interface ShippingMethod {
     id: number;
-    code: string;
     name: string;
-    description: string;
-    enabled: boolean;
-    isFree: boolean;
-    isCourier: boolean;
-    isPost: boolean;
+    type: string;
 }
 interface ShippingRate {
     id: number;
-    shippingMethodId: number;
-    cost: number;
-    deliveryTime: string;
-    minDays: number;
-    maxDays: number;
+    name: string;
+    price: number;
+    icon?: string;
+    color?: string;
+    type?: string;
+}
+interface ItemShippingRate {
+    invoiceItemId: number | string;
+    shippingRate: ShippingRate;
+}
+interface ApplicableShippingMethods {
+    shippingMethods: ShippingMethod[];
+    groupedShippingRates: Record<string, ShippingRate[]>;
+    itemsShippingRate: ItemShippingRate[];
 }
 interface ShippingAddressInput {
     firstName: string;
@@ -360,12 +436,13 @@ interface ShippingAddressInput {
     mobilePhone: string;
     phoneNumber?: string;
     email?: string;
-    regionId: number;
-    cityId: number;
+    regionId?: number;
+    cityId?: number;
     address: string;
     postalCode?: string;
     latitude?: number;
     longitude?: number;
+    showMap?: boolean;
     userSetCoordinatesBefore?: boolean;
 }
 interface ShippingAddressCredentials {
@@ -374,41 +451,63 @@ interface ShippingAddressCredentials {
 }
 interface ShippingAssignment {
     rateId: number;
-    invoiceItemIds: string[];
+    invoiceItemIds: Array<string | number>;
+}
+
+/**
+ * Order-related types
+ */
+
+interface Order {
+    id: number;
+    orderNumber: string;
+    orderIdentifier: string;
+    invoice: {
+        shippingItems: JsonObject[];
+        invoiceItems: InvoiceItem[];
+    };
+}
+interface OrdersListResponse {
+    orders: Order[];
+    totalCount: number;
+    totalCountRaw: number;
+    totalNotSeen: number;
+    totalSeen: number;
+}
+interface OrderFilters {
+    pageNumber?: number;
+    pageSize?: number;
+    filters?: Array<{
+        name: string;
+        value: JsonValue;
+    }>;
 }
 
 /**
  * Payment-related types
  */
+
 type PaymentGateway = 'mellatpayment' | 'pecpayment' | 'sadadpayment' | 'zarinpalpayment' | 'paypingpayment' | 'podpayment' | 'uppayment' | 'seppayment' | 'vandarpayment' | 'yourgatepayment' | 'bazarpayment' | 'zifypayment' | 'zibalpayment' | 'snapppayment' | 'torobpaypayment' | 'azkipayment' | 'digipaypayment' | 'novapaypayment' | 'zarinpluspayment' | 'tomanpayment' | 'tarapayment' | 'ozonpayment' | 'millipaypayment' | 'ayriapayment' | 'sabinpayment' | 'paymentinplace' | 'cardtocardpayment' | 'freepayment';
 type PaymentStatus = 'PENDING' | 'PROCESSING' | 'PAID' | 'FAILED' | 'CANCELLED' | 'REFUNDED';
 interface PaymentMethod {
     id: number;
     code: PaymentGateway;
-    name: string;
-    description: {
-        description: string;
-        cardNumber?: string;
-        cardDescription?: string;
-        uploadNeeded?: boolean;
-    };
-    enabled: boolean;
-    config?: Record<string, any>;
+    isDefault: boolean;
 }
 interface Payment {
     id: number;
     identifier: string;
-    paymentType: PaymentMethod;
+    paymentType: {
+        id?: number;
+        code: PaymentGateway;
+    };
     amount: number;
-    invoiceId: number;
-    status: PaymentStatus;
-    createdAt: string;
-    updatedAt: string;
 }
 interface PaymentAction {
-    action: 'POST' | 'REDIRECT' | 'UPLOAD' | 'FAIL' | 'StockViolated';
+    action: 'POST' | 'REDIRECT' | 'UPLOAD' | 'pending' | 'showOrder' | 'StockViolated' | 'FAIL';
     address?: string;
-    payload?: Record<string, any>;
+    payload?: JsonObject;
+    order?: Order;
     time?: number;
     message?: string;
 }
@@ -422,39 +521,17 @@ interface CreatePaymentInput {
     paymentType: number;
 }
 interface PaymentStepInput {
-    identifier: string;
+    id?: number;
+    paymentIdentifier?: string;
+    payload?: JsonObject;
+    tatoken?: string;
+    trackingData?: JsonObject;
     isFailed?: string;
     imageUrl?: string;
     code?: string;
 }
-
-/**
- * Order-related types
- */
-
-type OrderStatus = 'PENDING' | 'PROCESSING' | 'SHIPPED' | 'DELIVERED' | 'CANCELLED' | 'REFUNDED';
-interface Order {
-    id: number;
-    orderNumber: string;
-    status: OrderStatus;
-    items: InvoiceItem[];
-    shippingAddress?: ShippingAddress;
-    paymentMethod?: PaymentMethod;
-    subtotal: number;
-    discountTotal: number;
-    shippingTotal: number;
-    taxTotal: number;
-    total: number;
-    trackingNumber?: string;
-    notes?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-interface OrderFilters {
-    status?: OrderStatus;
-    page?: number;
-    pageSize?: number;
-}
+type PaymentStepFormValue = string | number | boolean | null | undefined;
+type PaymentStepFormFields = Record<string, PaymentStepFormValue>;
 
 /**
  * Search-related types
@@ -476,7 +553,7 @@ interface BlogPage {
     content?: string;
     summary?: string;
     image?: Image;
-    themeConfig?: any;
+    themeConfig?: JsonObject;
     attributes?: ProductAttribute[];
     createdAt: string;
     updatedAt: string;
@@ -493,7 +570,7 @@ interface CmsPage {
     content?: string;
     summary?: string;
     image?: Image;
-    themeConfig?: any;
+    themeConfig?: JsonObject;
     attributes?: ProductAttribute[];
     createdAt: string;
     updatedAt: string;
@@ -706,6 +783,7 @@ declare class HttpClient {
      * Get request headers
      */
     private getHeaders;
+    private isMultipartBody;
     /**
      * Check if status code should trigger a retry
      */
@@ -770,7 +848,7 @@ interface CategoryTreeNode {
     entityType: 'product_category';
     entityId: number;
     entity: ProductCategory;
-    details: any;
+    details: JsonObject;
     children: CategoryTreeNode[];
     createdAt: string;
     updatedAt: string;
@@ -878,10 +956,21 @@ declare class CredentialsManager {
  * Supports both authenticated and guest users via credentials
  */
 
+interface AddItemAttributesInput {
+    formAttributes?: Record<string, FormAttributeValue>;
+    schedulerBookingAttributes?: CreateCartInput['schedulerBookingAttributes'];
+    coupon?: string;
+}
+interface UpdateItemAttributesInput {
+    formAttributes?: Record<string, FormAttributeValue>;
+    coupon?: string;
+    deleteCoupon?: boolean;
+}
 declare class CartAPI {
     private http;
     private credentials;
     constructor(http: HttpClient, credentials: CredentialsManager);
+    private persistCartCredentials;
     /**
      * Get current cart
      */
@@ -893,15 +982,23 @@ declare class CartAPI {
     /**
      * Add item to cart
      */
-    addItem(variantId: number, count: number, formAttributes?: Record<string, any>, options?: RequestOptions): Promise<SazitoResponse<Cart>>;
+    addItem(variantId: number, count: number, formAttributes?: Record<string, FormAttributeValue>, options?: RequestOptions): Promise<SazitoResponse<Cart>>;
+    /**
+     * Add item to cart with standardized attributes payload.
+     */
+    addItemWithAttributes(variantId: number, count: number, attributes?: AddItemAttributesInput, options?: RequestOptions): Promise<SazitoResponse<Cart>>;
     /**
      * Update cart item quantity
      */
-    updateItem(cartProductId: number, count: number, options?: RequestOptions): Promise<SazitoResponse<Cart>>;
+    updateItem(cartProductId: number | string, variantId: number, count: number, formAttributes?: Record<string, FormAttributeValue>, options?: RequestOptions): Promise<SazitoResponse<Cart>>;
+    /**
+     * Update cart item quantity and optional coupon mutations.
+     */
+    updateItemWithAttributes(cartProductId: number | string, variantId: number, count: number, attributes?: UpdateItemAttributesInput, options?: RequestOptions): Promise<SazitoResponse<Cart>>;
     /**
      * Remove item from cart
      */
-    removeItem(cartProductId: number, variantId: number, options?: RequestOptions): Promise<SazitoResponse<Cart>>;
+    removeItem(cartProductId: number | string, variantId: number, options?: RequestOptions): Promise<SazitoResponse<Cart>>;
     /**
      * Clear current cart credentials
      */
@@ -919,7 +1016,7 @@ declare class OrdersAPI {
     /**
      * List orders (requires authentication)
      */
-    list(filters?: OrderFilters, options?: RequestOptions): Promise<SazitoResponse<PaginatedResponse<Order>>>;
+    list(filters?: OrderFilters, options?: RequestOptions): Promise<SazitoResponse<OrdersListResponse>>;
     /**
      * Get single order by ID (requires authentication)
      */
@@ -930,10 +1027,16 @@ declare class OrdersAPI {
  * Invoices API (Checkout)
  */
 
+interface AddInvoiceFormInput {
+    formAttributes: JsonObject;
+    invoiceIdentifier?: string;
+    identifier?: string;
+}
 declare class InvoicesAPI {
     private http;
     private credentials;
     constructor(http: HttpClient, credentials: CredentialsManager);
+    private normalizeInvoiceResponse;
     /**
      * Get current invoice
      */
@@ -962,10 +1065,26 @@ declare class InvoicesAPI {
      * Add invoice details (user comment)
      */
     addDetails(comment: string, options?: RequestOptions): Promise<SazitoResponse<Invoice>>;
+    /**
+     * Attach checkout dynamic form data to invoice.
+     */
+    addForm(input: AddInvoiceFormInput, options?: RequestOptions): Promise<SazitoResponse<Invoice>>;
+    /**
+     * Apply wallet credit to invoice.
+     */
+    addCredit(options?: RequestOptions): Promise<SazitoResponse<Invoice>>;
+    /**
+     * Remove wallet credit from invoice.
+     */
+    removeCredit(options?: RequestOptions): Promise<SazitoResponse<Invoice>>;
+    /**
+     * Toggle wallet credit based on current invoice state.
+     */
+    toggleCredit(options?: RequestOptions): Promise<SazitoResponse<Invoice>>;
     /**
      * Get applicable shipping methods for invoice
      */
-    getApplicableShippingMethods(options?: RequestOptions): Promise<SazitoResponse<ShippingMethod[]>>;
+    getApplicableShippingMethods(options?: RequestOptions): Promise<SazitoResponse<ApplicableShippingMethods>>;
     /**
      * Clear current invoice credentials
      */
@@ -980,6 +1099,7 @@ declare class ShippingAPI {
     private http;
     private credentials;
     constructor(http: HttpClient, credentials: CredentialsManager);
+    private sanitizeAddressInput;
     /**
      * Create shipping address
      */
@@ -1009,6 +1129,7 @@ declare class ShippingAPI {
 declare class PaymentsAPI {
     private http;
     private credentials;
+    private readonly pinchedPayments;
     constructor(http: HttpClient, credentials: CredentialsManager);
     /**
      * Get list of payment methods for invoice
@@ -1025,11 +1146,25 @@ declare class PaymentsAPI {
     /**
      * Process payment step (for card-to-card or multi-step payments)
      */
-    processStep(input: PaymentStepInput, options?: RequestOptions): Promise<SazitoResponse<any>>;
+    processStep(input: PaymentStepInput, options?: RequestOptions): Promise<SazitoResponse<PaymentAction>>;
+    /**
+     * Process payment step in form mode (non-JSON content-type).
+     */
+    processStepForm(input: FormData | PaymentStepFormFields, options?: RequestOptions): Promise<SazitoResponse<PaymentAction>>;
+    /**
+     * Poll payment state every 15 seconds until action changes from pending.
+     */
+    pollUntilSettled(options?: RequestOptions, intervalMs?: number): Promise<SazitoResponse<PaymentAction>>;
     /**
      * Clear payment credentials
      */
     clearPayment(): void;
+    private withExactJsonHeader;
+    private buildProcessStepFormData;
+    private appendFormValue;
+    private normalizePayment;
+    private normalizeAction;
+    private callPinchAfterSuccessfulPayment;
 }
 
 /**
@@ -1118,6 +1253,8 @@ interface LoginResponse {
 declare class UsersAPI {
     private http;
     constructor(http: HttpClient);
+    private normalizeUserResponse;
+    private normalizeLoginResponse;
     /**
      * Login with email and password
      */
@@ -1190,9 +1327,118 @@ declare class SearchAPI {
 }
 
 /**
- * Feedbacks API (Comments and reviews)
+ * Feedbacks API (Tajrobe reviews + legacy feedback methods)
  */
 
+type RecommendationStatus = 'RECOMMENDED' | 'NEUTRAL' | 'NOT-RECOMMENDED' | 'NONE';
+interface FeedbackProductAttribute {
+    name: string;
+    value: string;
+}
+interface FeedbackProductImage {
+    url: string;
+    alt: string;
+}
+interface FeedbackSeedItem {
+    productId: string;
+    productVariantId: string;
+    productName: string;
+    productAttributes: FeedbackProductAttribute[];
+    productImage: FeedbackProductImage;
+}
+interface FeedbackSeed {
+    orderId: string;
+    orderIdentifier: string;
+    hasCommentAlready: boolean;
+    items: FeedbackSeedItem[];
+}
+interface CreateOrderRatingInput {
+    orderId: string;
+    orderIdentifier: string;
+    orderRate: number;
+}
+interface CommentResponse {
+    id: string;
+}
+interface ProductReviewRequest {
+    commentId: string;
+    productId: string;
+    productVariantId: string;
+    productName: string;
+    productAttributes: FeedbackProductAttribute[];
+    productImage: FeedbackProductImage;
+    productRate: number;
+    text: string;
+    pros: string[];
+    cons: string[];
+    recommendationStatus: RecommendationStatus;
+    attachmentsServeKeys: string[];
+    owner: boolean;
+    isAnonymous: boolean;
+}
+interface ProductStatistics {
+    productStatistics: {
+        averageRate: number;
+        totalCount: number;
+        recommendations: {
+            recommendedPercentage: number;
+            recommendedTotalCount: number;
+        };
+    };
+}
+interface ProductReview {
+    productRate: number;
+    userFirstName: string;
+    userLastName: string;
+    createdAt: string;
+    owner: boolean;
+    text: string;
+    recommendationStatus: RecommendationStatus;
+    pros: string[];
+    cons: string[];
+    isAnonymous: boolean;
+    metadata: {
+        variantOptions: any[];
+        productName: string;
+        variantId: string;
+    };
+    attachments: Array<{
+        serveUrl: string;
+    }>;
+}
+interface ProductReviewsFilters {
+    pageNumber?: number;
+    pageSize?: number;
+}
+interface ProductReviewsResponse {
+    entities: ProductReview[];
+    pageNumber: number;
+    pageSize: number;
+    totalCount: number;
+    averageRate: number;
+    recommendations: {
+        recommendedPercentage: number;
+        recommendedTotalCount: number;
+    };
+}
+interface ReviewAttachmentInput {
+    file: File | Blob;
+    name?: string;
+    alt?: string;
+}
+interface ReviewUploadedImage {
+    id: string;
+    url: string;
+    alt: string;
+    serveUrl: string;
+    serveKey: string;
+}
+interface ReviewImageUploadResponse {
+    images: ReviewUploadedImage[];
+}
+/**
+ * Legacy feedback model kept for backwards compatibility.
+ */
 interface Feedback {
     id: number;
     user?: {
@@ -1206,11 +1452,17 @@ interface Feedback {
     createdAt: string;
     updatedAt: string;
 }
+/**
+ * Legacy create payload kept for backwards compatibility.
+ */
 interface CreateFeedbackInput {
     productId?: number;
     rating?: number;
     comment: string;
 }
+/**
+ * Legacy filters kept for backwards compatibility.
+ */
 interface FeedbackFilters {
     productId?: number;
     page?: number;
@@ -1219,17 +1471,45 @@ interface FeedbackFilters {
 declare class FeedbacksAPI {
     private http;
     constructor(http: HttpClient);
-    private transformFilters;
+    private normalizeSeedItem;
+    private normalizeSeed;
+    private normalizeProductReview;
+    private normalizeProductReviewsResponse;
+    private transformLegacyFilters;
+    /**
+     * Validate order and get products that can be reviewed.
+     */
+    getSeed(orderIdentifier: string, options?: RequestOptions): Promise<SazitoResponse<FeedbackSeed>>;
+    /**
+     * Submit order/shop rating and get a comment identifier for product review steps.
+     */
+    createOrderRating(input: CreateOrderRatingInput, options?: RequestOptions): Promise<SazitoResponse<CommentResponse>>;
+    /**
+     * Submit product-level review details.
+     */
+    submitProductReview(input: ProductReviewRequest, options?: RequestOptions): Promise<SazitoResponse<void>>;
+    /**
+     * Fetch product review statistics (without review list).
+     */
+    getProductStatistics(productId: string, options?: RequestOptions): Promise<SazitoResponse<ProductStatistics>>;
     /**
-     * List feedbacks
+     * Fetch paginated product reviews.
+     */
+    getProductReviews(productId: string, filters?: ProductReviewsFilters, options?: RequestOptions): Promise<SazitoResponse<ProductReviewsResponse>>;
+    /**
+     * Upload review images and get serve keys for attachments.
+     */
+    uploadReviewImages(images: ReviewAttachmentInput[], options?: RequestOptions): Promise<SazitoResponse<ReviewImageUploadResponse>>;
+    /**
+     * Legacy list method kept for backwards compatibility.
      */
     list(filters?: FeedbackFilters, options?: RequestOptions): Promise<SazitoResponse<PaginatedResponse<Feedback>>>;
     /**
-     * Create feedback/review
+     * Legacy create method kept for backwards compatibility.
      */
     create(input: CreateFeedbackInput, options?: RequestOptions): Promise<SazitoResponse<Feedback>>;
     /**
-     * Get single feedback
+     * Legacy get method kept for backwards compatibility.
      */
     get(feedbackId: number, options?: RequestOptions): Promise<SazitoResponse<Feedback>>;
 }
@@ -1404,69 +1684,114 @@ declare class VisitsAPI {
 }
 
 /**
- * Booking API (Event scheduling and appointments)
+ * Booking API (Scheduler and appointments)
  */
 
+/**
+ * Legacy event shape returned by some scheduler list endpoints.
+ */
 interface Event {
     id: number;
     title: string;
     description?: string;
-    start_time: string;
-    end_time: string;
-    capacity: number;
-    booked_count: number;
-    available_slots: number;
+    startTime?: string;
+    endTime?: string;
+    capacity?: number;
+    bookedCount?: number;
+    availableSlots?: number;
     price?: number;
     location?: string;
-    created_at: string;
+    createdAt?: string;
 }
-interface Booking {
-    id: number;
-    event_id: number;
-    event: Event;
-    user_id?: number;
-    attendee_name: string;
-    attendee_email?: string;
-    attendee_phone?: string;
-    status: 'pending' | 'confirmed' | 'cancelled';
-    booking_time: string;
-    created_at: string;
+/**
+ * Event details used in product booking flow.
+ */
+interface SchedulerEvent {
+    entityId: number;
+    title: string;
+    description: string;
+    durationsMinute: number[];
+}
+interface BookingTimeSlot {
+    startTimeLocal: string;
+    endTimeLocal: string;
+    isAvailable: boolean;
+    remainingCapacity: number;
+}
+interface BookingAvailableDay {
+    date: string;
+    timeSlots: BookingTimeSlot[];
+}
+interface EventAvailabilitiesResponse {
+    availableDays: BookingAvailableDay[];
+}
+interface EventAvailabilityFilters {
+    eventEntityId: number;
+    duration: number;
+    fromDate: string;
+    toDate: string;
+    timezone?: string;
 }
 interface CreateBookingInput {
-    event_entity_id: number;
+    eventEntityId?: number;
+    event_entity_id?: number;
     timezone: string;
-    attendee_name: string;
+    attendeeName?: string;
+    attendee_name?: string;
+    attendeeEmail?: string;
     attendee_email?: string;
+    attendeePhone?: string;
     attendee_phone?: string;
 }
+interface Booking {
+    id: number;
+    eventId: number;
+    event: Event;
+    userId?: number;
+    attendeeName: string;
+    attendeeEmail?: string;
+    attendeePhone?: string;
+    status: 'pending' | 'confirmed' | 'cancelled';
+    bookingTime: string;
+    createdAt: string;
+}
 interface EventFilters {
+    startDate?: string;
     start_date?: string;
+    endDate?: string;
     end_date?: string;
+    availableOnly?: boolean;
     available_only?: boolean;
     page?: number;
+    pageSize?: number;
     page_size?: number;
 }
 declare class BookingAPI {
     private http;
     constructor(http: HttpClient);
+    private transformEventFilters;
     /**
-     * List available events
+     * List available events (legacy scheduler listing).
      */
     listEvents(filters?: EventFilters, options?: RequestOptions): Promise<SazitoResponse<PaginatedResponse<Event>>>;
     /**
-     * Get single event
+     * Get event details used for booking (durations, title, description).
      */
-    getEvent(eventId: number, options?: RequestOptions): Promise<SazitoResponse<Event>>;
+    getEvent(entityId: number, options?: RequestOptions): Promise<SazitoResponse<SchedulerEvent>>;
     /**
-     * Create booking
+     * Get available days and time slots for an event.
+     */
+    getEventAvailabilities(filters: EventAvailabilityFilters, options?: RequestOptions): Promise<SazitoResponse<EventAvailabilitiesResponse>>;
+    /**
+     * Create booking (legacy endpoint kept for backward compatibility).
      */
     createBooking(input: CreateBookingInput, options?: RequestOptions): Promise<SazitoResponse<Booking>>;
     /**
-     * List user bookings (requires authentication)
+     * List user bookings (requires authentication).
      */
     listBookings(options?: RequestOptions): Promise<SazitoResponse<PaginatedResponse<Booking>>>;
     /**
-     * Cancel booking
+     * Cancel booking.
      */
     cancelBooking(bookingId: number, options?: RequestOptions): Promise<SazitoResponse<Booking>>;
 }
@@ -1653,6 +1978,78 @@ declare class GeneralAPI {
     getTajrobeConfig(options?: RequestOptions): Promise<SazitoResponse<TajrobeConfig>>;
 }
 
+/**
+ * Dynamic Forms API
+ */
+
+type DynamicFormFieldType = 'TextBox' | 'TextArea' | 'Select' | 'Checkbox' | 'StatusBox' | 'Number' | 'Password' | 'NationalId' | 'PhoneNumber' | 'IBAN' | 'Separator' | 'Uploader';
+interface SelectOption {
+    value: string;
+    label: string;
+}
+interface DynamicFormField {
+    key: string;
+    name: string;
+    type: DynamicFormFieldType;
+    label: string;
+    value: any;
+    placeholder: string;
+    required: boolean;
+    inputOptions: SelectOption[];
+    allowedExtensions: string[];
+}
+interface DynamicForm {
+    id: number;
+    title: string;
+    description: string;
+    fields: DynamicFormField[];
+}
+interface UploadedDynamicFormFile {
+    serveKey: string;
+}
+declare class DynamicFormsAPI {
+    private http;
+    constructor(http: HttpClient);
+    private normalizeField;
+    private normalizeForm;
+    /**
+     * Fetch dynamic form definition by ID.
+     */
+    getForm(formId: number, options?: RequestOptions): Promise<SazitoResponse<DynamicForm>>;
+    /**
+     * Upload file for uploader fields in product dynamic forms.
+     */
+    uploadProductFormFile(file: File | Blob, options?: RequestOptions): Promise<SazitoResponse<UploadedDynamicFormFile>>;
+}
+
+/**
+ * Regions API
+ */
+
+interface RegionCity {
+    id: number;
+    name: string;
+    latitude: number;
+    longitude: number;
+}
+interface RegionWithCities {
+    id: number;
+    name: string;
+    cities: RegionCity[];
+}
+declare class RegionsAPI {
+    private http;
+    constructor(http: HttpClient);
+    private normalizeCity;
+    private normalizeRegion;
+    private extractRegions;
+    private sortAlphabetically;
+    /**
+     * Get all regions with nested cities (sorted by name).
+     */
+    list(options?: RequestOptions): Promise<SazitoResponse<RegionWithCities[]>>;
+}
+
 /**
  * Main Sazito SDK Client
  */
@@ -1679,6 +2076,8 @@ declare class SazitoClient {
     readonly entityRoutes: EntityRoutesAPI;
     readonly menu: MenuAPI;
     readonly general: GeneralAPI;
+    readonly dynamicForms: DynamicFormsAPI;
+    readonly regions: RegionsAPI;
     constructor(config: SazitoConfig);
     /**
      * Set authentication token (stored in localStorage with cookie fallback)
@@ -1759,54 +2158,60 @@ declare function createMenuAPI(configOrContext: SazitoConfig | ModuleContext): M
 
 declare function createGeneralAPI(configOrContext: SazitoConfig | ModuleContext): GeneralAPI;
 
-/**
- * API Data Transformers
- * Convert between SDK-friendly camelCase and backend snake_case
- */
+declare function createDynamicFormsAPI(configOrContext: SazitoConfig | ModuleContext): DynamicFormsAPI;
+
+declare function createRegionsAPI(configOrContext: SazitoConfig | ModuleContext): RegionsAPI;
+
+type TransformScalar = string | number | boolean | null | undefined;
+type TransformValue = TransformScalar | TransformObject | TransformValue[] | object;
+interface TransformObject {
+    [key: string]: TransformValue;
+}
+interface ApiResponseEnvelope {
+    data?: {
+        result?: TransformObject;
+    };
+}
 /**
  * Transform object keys from snake_case to camelCase with field name beautification
  * @param obj - Object to transform
  * @returns Transformed object with camelCase keys and beautiful field names
  */
-declare function transformResponseKeys(obj: any): any;
+declare function transformResponseKeys(obj: TransformValue | object): TransformValue;
 /**
  * Transform object keys from camelCase to snake_case for API requests
  * @param obj - Object to transform
  * @returns Transformed object with snake_case keys
  */
-declare function transformRequestKeys(obj: any): any;
+declare function transformRequestKeys(obj: TransformValue | object): TransformValue;
 /**
  * Transform API response data structure
  * Unwraps the { data: { result: { ... } } } structure and transforms keys
  */
-declare function transformApiResponse<T = any>(response: any): T;
+declare function transformApiResponse<T = TransformObject>(response: TransformValue | ApiResponseEnvelope | object): T;
 /**
  * Specific transformer for cart responses
  * Handles the cart-specific data structure
  */
-declare function transformCartResponse(response: any): any;
-/**
- * Specific transformer for invoice responses
- * Handles the invoice-specific data structure
- */
-declare function transformInvoiceResponse(response: any): any;
+declare function transformCartResponse<T = TransformObject>(response: TransformValue | ApiResponseEnvelope | object): T;
+declare function transformInvoiceResponse<T = TransformObject>(response: TransformValue | ApiResponseEnvelope | object): T;
 /**
  * Specific transformer for product list responses
  * Handles paginated product lists
  */
-declare function transformProductListResponse(response: any): any;
+declare function transformProductListResponse<T = TransformObject>(response: TransformValue | ApiResponseEnvelope | object): T;
 /**
  * Transform shipping address input for API request
  */
-declare function transformShippingAddressInput(input: any): any;
+declare function transformShippingAddressInput(input: TransformValue): TransformObject;
 /**
  * Transform add to cart input for API request
  */
-declare function transformAddToCartInput(variantId: number, quantity: number, formAttributes?: any): any;
+declare function transformAddToCartInput(variantId: number, quantity: number, formAttributes?: TransformValue): TransformObject;
 /**
  * Transform create cart input for API request
  */
-declare function transformCreateCartInput(input: any): any;
+declare function transformCreateCartInput(input: TransformValue): TransformObject;
 
-export { CredentialsManager, HttpClient, SazitoClient, TokenStorage, createBookingAPI as booking, createCartAPI as cart, createCategoriesAPI as categories, createCMSAPI as cms, createBookingAPI, createCMSAPI, createCartAPI, createCategoriesAPI, createEntityRoutesAPI, createFeedbacksAPI, createGeneralAPI, createImagesAPI, createInvoicesAPI, createMenuAPI, createOrdersAPI, createPaymentsAPI, createProductsAPI, createSazitoClient, createSearchAPI, createShippingAPI, createUsersAPI, createVisitsAPI, createWalletAPI, createEntityRoutesAPI as entityRoutes, createFeedbacksAPI as feedbacks, createGeneralAPI as general, createImagesAPI as images, createInvoicesAPI as invoices, createMenuAPI as menu, createOrdersAPI as orders, createPaymentsAPI as payments, createProductsAPI as products, createSearchAPI as search, createShippingAPI as shipping, transformAddToCartInput, transformApiResponse, transformCartResponse, transformCreateCartInput, transformInvoiceResponse, transformProductListResponse, transformRequestKeys, transformResponseKeys, transformShippingAddressInput, createUsersAPI as users, createVisitsAPI as visits, createWalletAPI as wallet };
-export type { AddToCartInput, BlogPage, BlogPageEntityRoute, CMSPageEntityRoute, CMSPageType, CacheConfig, Cart, CartCredentials, CartProduct, City$1 as City, CmsPage, CookieOptions, CreateCartInput, CreateInvoiceInput, CreatePaymentInput, EntityRoute, EntityRouteResponse, EntityType, Image, Invoice, InvoiceCredentials, InvoiceItem, MenuItem, MenuNode, MenuTree, Order, OrderFilters, OrderStatus, PaginatedResponse, Payment, PaymentAction, PaymentCredentials, PaymentGateway, PaymentMethod, PaymentStatus, PaymentStepInput, Product, ProductAttribute, ProductCategory, ProductCategoryEntityRoute, ProductEntityRoute, ProductFilters, ProductSort, ProductVariant, RefreshInvoiceInput, Region$1 as Region, RequestOptions, RetryConfig, SazitoConfig, SazitoResponse, SearchFilters, SearchResponse, ShippingAddress, ShippingAddressCredentials, ShippingAddressInput, ShippingAssignment, ShippingItem, ShippingMethod, ShippingRate, Tag, UnknownEntityRoute, User };
+export { CredentialsManager, HttpClient, SazitoClient, TokenStorage, createBookingAPI as booking, createCartAPI as cart, createCategoriesAPI as categories, createCMSAPI as cms, createBookingAPI, createCMSAPI, createCartAPI, createCategoriesAPI, createDynamicFormsAPI, createEntityRoutesAPI, createFeedbacksAPI, createGeneralAPI, createImagesAPI, createInvoicesAPI, createMenuAPI, createOrdersAPI, createPaymentsAPI, createProductsAPI, createRegionsAPI, createSazitoClient, createSearchAPI, createShippingAPI, createUsersAPI, createVisitsAPI, createWalletAPI, createDynamicFormsAPI as dynamicForms, createEntityRoutesAPI as entityRoutes, createFeedbacksAPI as feedbacks, createGeneralAPI as general, createImagesAPI as images, createInvoicesAPI as invoices, createMenuAPI as menu, createOrdersAPI as orders, createPaymentsAPI as payments, createProductsAPI as products, createRegionsAPI as regions, createSearchAPI as search, createShippingAPI as shipping, transformAddToCartInput, transformApiResponse, transformCartResponse, transformCreateCartInput, transformInvoiceResponse, transformProductListResponse, transformRequestKeys, transformResponseKeys, transformShippingAddressInput, createUsersAPI as users, createVisitsAPI as visits, createWalletAPI as wallet };
+export type { AddToCartInput, ApplicableShippingMethods, BlogPage, BlogPageEntityRoute, CMSPageEntityRoute, CMSPageType, CacheConfig, Cart, CartCredentials, CartProduct, CheckoutProductSnapshot, City$1 as City, CmsPage, CookieOptions, CreateCartInput, CreateInvoiceInput, CreatePaymentInput, EntityRoute, EntityRouteResponse, EntityType, FormAttributeValue, Image, Invoice, InvoiceCredentials, InvoiceItem, InvoiceItemFormAttributes, InvoiceShippingAddress, InvoiceShippingAddressRegion, ItemShippingRate, JsonArray, JsonObject, JsonPrimitive, JsonValue, MenuItem, MenuNode, MenuTree, Order, OrderFilters, OrdersListResponse, PaginatedResponse, Payment, PaymentAction, PaymentCredentials, PaymentGateway, PaymentMethod, PaymentStatus, PaymentStepFormFields, PaymentStepFormValue, PaymentStepInput, Product, ProductAttribute, ProductCategory, ProductCategoryEntityRoute, ProductEntityRoute, ProductFilters, ProductSort, ProductVariant, RefreshInvoiceInput, Region$1 as Region, RequestOptions, RetryConfig, SazitoConfig, SazitoResponse, SchedulerBookingAttributes, SearchFilters, SearchResponse, ShippingAddress, ShippingAddressCity, ShippingAddressCredentials, ShippingAddressInput, ShippingAddressRegion, ShippingAssignment, ShippingItem, ShippingMethod, ShippingRate, Tag, UnknownEntityRoute, UploadedFormFileAttribute, User };