@gofynd/fdk-client-javascript 1.1.6 → 1.2.0

package/sdk/application/Cart/CartApplicationModel.js

@@ -1,25 +1,958 @@
 const Joi = require("joi");
 
-class CartModel {
+/**
+ * @typedef ActionQuery
+ * @property {string[]} [product_slug] - Contains list of product slug
+ */
+
+/**
+ * @typedef AddCartDetailResponse
+ * @property {CartDetailResponse} [cart]
+ * @property {string} [message]
+ * @property {boolean} [partial] - When adding multiple items check if all
+ *   added. True if only few are added.
+ * @property {boolean} [success] - True if all items are added successfully.
+ *   False if partially added or not added.
+ */
+
+/**
+ * @typedef AddCartRequest
+ * @property {AddProductCart[]} [items]
+ * @property {boolean} [new_cart]
+ */
+
+/**
+ * @typedef AddProductCart
+ * @property {Object} [_custom_json]
+ * @property {Object} [article_assignment]
+ * @property {string} [article_id]
+ * @property {string} [display]
+ * @property {Object} [extra_meta]
+ * @property {number} [item_id]
+ * @property {string} [item_size]
+ * @property {Object} [meta]
+ * @property {Object[]} [parent_item_identifiers]
+ * @property {boolean} [pos]
+ * @property {string[]} [product_group_tags]
+ * @property {number} [quantity]
+ * @property {number} [seller_id]
+ * @property {number} [store_id]
+ */
+
+/**
+ * @typedef Address
+ * @property {Object} [_custom_json]
+ * @property {string} [address]
+ * @property {string} [address_type]
+ * @property {string} [area]
+ * @property {string} [area_code]
+ * @property {string} [area_code_slug]
+ * @property {string} [checkout_mode]
+ * @property {string} [city]
+ * @property {string} [country]
+ * @property {string} [country_code]
+ * @property {string} [country_iso_code]
+ * @property {string} [country_phone_code]
+ * @property {string} [created_by_user_id]
+ * @property {string} [email]
+ * @property {GeoLocation} [geo_location]
+ * @property {Object} [google_map_point]
+ * @property {string} [id]
+ * @property {boolean} [is_active]
+ * @property {boolean} [is_default_address]
+ * @property {string} [landmark]
+ * @property {Object} [meta]
+ * @property {string} [name]
+ * @property {string} [phone]
+ * @property {string} [state]
+ * @property {string[]} [tags]
+ * @property {string} [user_id]
+ */
+
+/**
+ * @typedef AppliedFreeArticles
+ * @property {string} [article_id] - Free article id
+ * @property {FreeGiftItem} [free_gift_item_details] - Free gift items details
+ * @property {string} [parent_item_identifier] - Parent item identifier for free article
+ * @property {number} [quantity] - Free article quantity
+ */
+
+/**
+ * @typedef AppliedPromotion
+ * @property {number} [amount] - Per unit discount amount applied with current promotion
+ * @property {AppliedFreeArticles[]} [applied_free_articles] - Applied free
+ *   article for free gift item promotions
+ * @property {number} [article_quantity] - Quantity of article on which
+ *   promotion is applicable
+ * @property {BuyRules[]} [buy_rules] - Buy rules for promotions
+ * @property {DiscountRulesApp[]} [discount_rules] - Discount rules for promotions
+ * @property {boolean} [mrp_promotion] - If applied promotion is applied on
+ *   product MRP or ESP
+ * @property {string} [offer_text] - Offer text of current promotion
+ * @property {Ownership} [ownership] - Ownership of promotion
+ * @property {string} [promo_id] - Promotion id
+ * @property {string} [promotion_group] - Promotion group for the promotion
+ * @property {string} [promotion_name] - Promotion name of current promotion
+ * @property {string} [promotion_type] - Promotion type of current promotion
+ */
+
+/**
+ * @typedef ApplyCouponRequest
+ * @property {string} coupon_code - Coupon code to be applied
+ */
+
+/**
+ * @typedef ArticleGiftDetail
+ * @property {GiftDetail} [article_id]
+ */
+
+/**
+ * @typedef ArticlePriceInfo
+ * @property {BasePrice} [base]
+ * @property {BasePrice} [converted]
+ */
+
+/**
+ * @typedef BaseInfo
+ * @property {string} [name]
+ * @property {number} [uid]
+ */
+
+/**
+ * @typedef BasePrice
+ * @property {string} [currency_code]
+ * @property {string} [currency_symbol]
+ * @property {number} [effective]
+ * @property {number} [marked]
+ */
+
+/**
+ * @typedef BulkPriceOffer
+ * @property {OfferItem[]} [offers]
+ * @property {OfferSeller} [seller]
+ */
+
+/**
+ * @typedef BulkPriceResponse
+ * @property {BulkPriceOffer[]} [data] - Consist of offers from multiple seller
+ */
+
+/**
+ * @typedef BuyRules
+ * @property {Object} [cart_conditions] - Cart conditions details for promotion
+ * @property {Object} [item_criteria] - Item criteria of promotion
+ */
+
+/**
+ * @typedef CartBreakup
+ * @property {CouponBreakup} [coupon]
+ * @property {DisplayBreakup[]} [display]
+ * @property {LoyaltyPoints} [loyalty_points]
+ * @property {RawBreakup} [raw]
+ */
+
+/**
+ * @typedef CartCheckoutCustomMeta
+ * @property {string} key
+ * @property {string} value
+ */
+
+/**
+ * @typedef CartCheckoutDetailRequest
+ * @property {string} [address_id]
+ * @property {string} [aggregator]
+ * @property {Object} [billing_address]
+ * @property {string} [billing_address_id]
+ * @property {string} [callback_url]
+ * @property {CartCheckoutCustomMeta[]} [custom_meta]
+ * @property {CustomerDetails} [customer_details] - Customer details
+ * @property {Object} [delivery_address]
+ * @property {Object} [extra_meta]
+ * @property {string} [id]
+ * @property {string} [merchant_code]
+ * @property {Object} [meta]
+ * @property {string} [order_type]
+ * @property {number} [ordering_store]
+ * @property {boolean} [payment_auto_confirm]
+ * @property {string} [payment_identifier]
+ * @property {string} payment_mode
+ * @property {Object} [payment_params]
+ * @property {StaffCheckout} [staff]
+ */
+
+/**
+ * @typedef CartCheckoutDetailV2Request
+ * @property {string} [address_id]
+ * @property {string} [aggregator]
+ * @property {Object} [billing_address]
+ * @property {string} [billing_address_id]
+ * @property {string} [callback_url]
+ * @property {string} [cart_id]
+ * @property {Object} [custom_meta]
+ * @property {CustomerDetails} [customer_details] - Customer details
+ * @property {Object} [delivery_address]
+ * @property {Object} [extra_meta]
+ * @property {string} [id]
+ * @property {string} [merchant_code]
+ * @property {Object} [meta]
+ * @property {string} [order_type]
+ * @property {number} [ordering_store]
+ * @property {boolean} [payment_auto_confirm]
+ * @property {string} [payment_identifier]
+ * @property {PaymentMethod[]} payment_methods
+ * @property {string} payment_mode
+ * @property {Object} [payment_params]
+ * @property {StaffCheckout} [staff]
+ */
+
+/**
+ * @typedef CartCheckoutResponse
+ * @property {string} [app_intercept_url]
+ * @property {string} [callback_url]
+ * @property {CheckCart} [cart]
+ * @property {Object} [data]
+ * @property {string} [message]
+ * @property {string} [order_id]
+ * @property {string} [payment_confirm_url]
+ * @property {boolean} [success]
+ */
+
+/**
+ * @typedef CartCurrency
+ * @property {string} [code] - Currency code defined by ISO 4217:2015
+ * @property {string} [symbol]
+ */
+
+/**
+ * @typedef CartDetailResponse
+ * @property {AppliedPromotion[]} [applied_promo_details]
+ * @property {CartBreakup} [breakup_values]
+ * @property {boolean} [buy_now]
+ * @property {string} [checkout_mode]
+ * @property {string} [comment]
+ * @property {string} [coupon_text]
+ * @property {CartCurrency} [currency]
+ * @property {string} [delivery_charge_info]
+ * @property {ShipmentPromise} [delivery_promise]
+ * @property {string} [gstin]
+ * @property {string} [id]
+ * @property {boolean} [is_valid]
+ * @property {CartProductInfo[]} [items]
+ * @property {string} [last_modified]
+ * @property {string} [message]
+ * @property {Object} [pan_config]
+ * @property {string} [pan_no]
+ * @property {PaymentSelectionLock} [payment_selection_lock]
+ * @property {boolean} [restrict_checkout]
+ */
+
+/**
+ * @typedef CartItemCountResponse
+ * @property {number} [user_cart_items_count] - Item count present in cart
+ */
+
+/**
+ * @typedef CartMetaMissingResponse
+ * @property {string[]} [errors]
+ */
+
+/**
+ * @typedef CartMetaRequest
+ * @property {string} [checkout_mode]
+ * @property {string} [comment]
+ * @property {Object} [delivery_slots]
+ * @property {ArticleGiftDetail} [gift_details]
+ * @property {string} [gstin]
+ * @property {Object} [pick_up_customer_details] - Customer contact details for
+ *   customer pickup at store
+ */
+
+/**
+ * @typedef CartMetaResponse
+ * @property {boolean} [is_valid]
+ * @property {string} [message]
+ */
+
+/**
+ * @typedef CartProduct
+ * @property {Object} [_custom_json]
+ * @property {ProductAction} [action]
+ * @property {BaseInfo} [brand]
+ * @property {CategoryInfo[]} [categories]
+ * @property {ProductImage[]} [images]
+ * @property {string} [item_code]
+ * @property {string} [name]
+ * @property {string} [slug] - Unique product url name generated via product
+ *   name and other meta data
+ * @property {string[]} [tags]
+ * @property {Tags} [teaser_tag]
+ * @property {string} [type]
+ * @property {number} [uid]
+ */
+
+/**
+ * @typedef CartProductIdentifer
+ * @property {string} [identifier] - Article idenfier generated by cart
+ */
+
+/**
+ * @typedef CartProductInfo
+ * @property {ProductArticle} [article]
+ * @property {ProductAvailability} [availability]
+ * @property {Object} [bulk_offer]
+ * @property {CouponDetails} [coupon]
+ * @property {string} [coupon_message]
+ * @property {Object} [custom_order]
+ * @property {ShipmentPromise} [delivery_promise]
+ * @property {string} [discount]
+ * @property {CartProductIdentifer} identifiers
+ * @property {boolean} [is_set]
+ * @property {string} [key]
+ * @property {string} [message]
+ * @property {Object} [moq]
+ * @property {Object} [parent_item_identifiers]
+ * @property {ProductPriceInfo} [price]
+ * @property {ProductPriceInfo} [price_per_unit]
+ * @property {CartProduct} [product]
+ * @property {PromoMeta} [promo_meta]
+ * @property {AppliedPromotion[]} [promotions_applied]
+ * @property {number} [quantity]
+ */
+
+/**
+ * @typedef CartShipmentsResponse
+ * @property {CartBreakup} [breakup_values]
+ * @property {boolean} [buy_now]
+ * @property {number} [cart_id]
+ * @property {string} [checkout_mode]
+ * @property {string} [comment]
+ * @property {string} [coupon_text]
+ * @property {CartCurrency} [currency]
+ * @property {string} [delivery_charge_info]
+ * @property {ShipmentPromise} [delivery_promise]
+ * @property {boolean} [error]
+ * @property {string} [gstin]
+ * @property {string} [id]
+ * @property {boolean} [is_valid]
+ * @property {string} [last_modified]
+ * @property {string} [message]
+ * @property {PaymentSelectionLock} [payment_selection_lock]
+ * @property {boolean} [restrict_checkout]
+ * @property {ShipmentResponse[]} [shipments]
+ * @property {string} [uid]
+ */
+
+/**
+ * @typedef CategoryInfo
+ * @property {string} [name]
+ * @property {number} [uid] - Product Category Id
+ */
+
+/**
+ * @typedef CheckCart
+ * @property {CartBreakup} [breakup_values]
+ * @property {boolean} [buy_now]
+ * @property {number} [cart_id]
+ * @property {string} [checkout_mode]
+ * @property {boolean} [cod_available]
+ * @property {number} [cod_charges]
+ * @property {string} [cod_message]
+ * @property {string} [comment]
+ * @property {string} [coupon_text]
+ * @property {CartCurrency} [currency]
+ * @property {string} [delivery_charge_info]
+ * @property {number} [delivery_charge_order_value]
+ * @property {number} [delivery_charges]
+ * @property {ShipmentPromise} [delivery_promise]
+ * @property {string} [error_message]
+ * @property {string} [gstin]
+ * @property {string} [id]
+ * @property {boolean} [is_valid]
+ * @property {CartProductInfo[]} [items]
+ * @property {string} [last_modified]
+ * @property {string} [message]
+ * @property {string} [order_id]
+ * @property {PaymentSelectionLock} [payment_selection_lock]
+ * @property {boolean} [restrict_checkout]
+ * @property {string} [store_code]
+ * @property {Object[]} [store_emps]
+ * @property {boolean} [success]
+ * @property {string} [uid]
+ * @property {string} [user_type]
+ */
+
+/**
+ * @typedef Coupon
+ * @property {string} [coupon_code]
+ * @property {string} [coupon_type]
+ * @property {number} [coupon_value]
+ * @property {string} [description]
+ * @property {string} [expires_on]
+ * @property {boolean} [is_applicable]
+ * @property {boolean} [is_applied]
+ * @property {number} [max_discount_value]
+ * @property {string} [message]
+ * @property {number} [minimum_cart_value]
+ * @property {string} [sub_title]
+ * @property {string} [title]
+ */
+
+/**
+ * @typedef CouponBreakup
+ * @property {string} [code]
+ * @property {string} [coupon_type]
+ * @property {number} [coupon_value]
+ * @property {string} [description]
+ * @property {boolean} [is_applied]
+ * @property {number} [max_discount_value]
+ * @property {string} [message]
+ * @property {number} [minimum_cart_value]
+ * @property {string} [sub_title]
+ * @property {string} [title]
+ * @property {string} [type]
+ * @property {string} [uid]
+ * @property {number} [value]
+ */
+
+/**
+ * @typedef CouponDetails
+ * @property {string} [code]
+ * @property {number} [discount_single_quantity]
+ * @property {number} [discount_total_quantity]
+ */
+
+/**
+ * @typedef CouponValidity
+ * @property {string} [code]
+ * @property {number} [discount]
+ * @property {string} [display_message_en]
+ * @property {boolean} [next_validation_required]
+ * @property {string} [title]
+ * @property {boolean} [valid]
+ */
+
+/**
+ * @typedef CurrencyInfo
+ * @property {string} [code]
+ * @property {string} [symbol]
+ */
+
+/**
+ * @typedef CustomerDetails
+ * @property {string} [email]
+ * @property {string} mobile
+ * @property {string} [name]
+ */
+
+/**
+ * @typedef DeleteAddressResponse
+ * @property {string} [id]
+ * @property {boolean} [is_deleted]
+ */
+
+/**
+ * @typedef DeleteCartDetailResponse
+ * @property {string} [message]
+ * @property {boolean} [success] - True if cart is archived successfully. False
+ *   if not archived.
+ */
+
+/**
+ * @typedef DiscountRulesApp
+ * @property {Object} [item_criteria] - Item criteria of promotion
+ * @property {string[]} [matched_buy_rules] - Matched buy rules for promotion
+ * @property {Object} [offer] - Offer for promotion
+ * @property {Object} [raw_offer] - Raw offer details for promotion
+ */
+
+/**
+ * @typedef DisplayBreakup
+ * @property {string} [currency_code]
+ * @property {string} [currency_symbol]
+ * @property {string} [display]
+ * @property {string} [key]
+ * @property {string[]} [message]
+ * @property {number} [value]
+ */
+
+/**
+ * @typedef FreeGiftItem
+ * @property {string} [item_brand_name] - Item brand name
+ * @property {number} [item_id] - Item id
+ * @property {string[]} [item_images_url] - Item images URL
+ * @property {string} [item_name] - Item name
+ * @property {Object} [item_price_details] - Item price details
+ * @property {string} [item_slug] - Item slug
+ */
+
+/**
+ * @typedef FreeGiftItems
+ * @property {string} [item_brand_name] - Item brand name
+ * @property {number} [item_id] - Item id
+ * @property {string[]} [item_images_url] - Item images URL
+ * @property {string} [item_name] - Item name
+ * @property {Object} [item_price_details] - Item price details
+ * @property {string} [item_slug] - Item slug
+ */
+
+/**
+ * @typedef GeoLocation
+ * @property {number} [latitude]
+ * @property {number} [longitude]
+ */
+
+/**
+ * @typedef GetAddressesResponse
+ * @property {Address[]} [address]
+ * @property {boolean} [pii_masking]
+ */
+
+/**
+ * @typedef GetCouponResponse
+ * @property {Coupon[]} [available_coupon_list]
+ * @property {PageCoupon} [page]
+ */
+
+/**
+ * @typedef GetShareCartLinkRequest
+ * @property {string} [id] - Cart uid for generating sharing
+ * @property {Object} [meta] - Staff, Ordering store or any other data. This
+ *   data will be used to generate link as well as sent as shared details.
+ */
+
+/**
+ * @typedef GetShareCartLinkResponse
+ * @property {string} [share_url] - Short shareable final url
+ * @property {string} [token] - Short url unique id
+ */
+
+/**
+ * @typedef GiftDetail
+ * @property {string} [gift_message]
+ * @property {boolean} [is_gift_applied]
+ */
+
+/**
+ * @typedef LadderOfferItem
+ * @property {number} [margin] - Percentage value of discount
+ * @property {number} [max_quantity] - Minimum quantity upto which offer is
+ *   applicable. If not present that offer is applicable on all quantities
+ * @property {number} [min_quantity] - Minimum quantity from which offer is applicable
+ * @property {LadderPrice} [price]
+ * @property {string} [type] - Offer type
+ */
+
+/**
+ * @typedef LadderPrice
+ * @property {string} [currency_code] - Currency code for all amounts
+ * @property {string} [currency_symbol] - Currency symbol for currency
+ * @property {number} [effective] - Current per unit price of product after
+ *   existing deductions
+ * @property {number} [marked] - Original price of product
+ * @property {number} [offer_price] - Discounted per unit price for current offer object
+ */
+
+/**
+ * @typedef LadderPriceOffer
+ * @property {Object} [buy_rules] - Buy rules of promotions
+ * @property {string} [calculate_on] - If this ladder offer is to be calculated
+ *   on MRP or ESP price
+ * @property {string} [description] - Offer details including T&C
+ * @property {Object[]} [discount_rules] - Discount rules of promotions
+ * @property {FreeGiftItems[]} [free_gift_items] - Details of free gift items
+ * @property {string} [id] - Promotion id
+ * @property {LadderOfferItem[]} [offer_prices]
+ * @property {string} [offer_text] - Offer title
+ * @property {string} [promotion_group] - Group of promotion belongs to
+ * @property {string} [valid_till] - Datetime ISOString for promotion end date
+ */
+
+/**
+ * @typedef LadderPriceOffers
+ * @property {LadderPriceOffer[]} [available_offers]
+ * @property {CurrencyInfo} [currency]
+ */
+
+/**
+ * @typedef LoyaltyPoints
+ * @property {number} [applicable]
+ * @property {string} [description]
+ * @property {boolean} [is_applied]
+ * @property {number} [total]
+ */
+
+/**
+ * @typedef OfferItem
+ * @property {boolean} [auto_applied] - Whether offer discount is auto applied in cart
+ * @property {boolean} [best] - Is true for best offer from all offers present
+ *   for all sellers
+ * @property {number} [margin] - Percentage value of discount
+ * @property {OfferPrice} [price]
+ * @property {number} [quantity] - Quantity on which offer is applicable
+ * @property {number} [total] - Total price of offer quantity with discount
+ * @property {string} [type] - Offer type
+ */
+
+/**
+ * @typedef OfferPrice
+ * @property {number} [bulk_effective] - Discounted per unit price for current
+ *   offer object
+ * @property {string} [currency_code] - Currency code for all amounts
+ * @property {string} [currency_symbol] - Currency symbol for currency
+ * @property {number} [effective] - Current per unit price of product after
+ *   existing deductions
+ * @property {number} [marked] - Original price of product
+ */
+
+/**
+ * @typedef OfferSeller
+ * @property {string} [name]
+ * @property {number} [uid] - Seller id
+ */
+
+/**
+ * @typedef OperationErrorResponse
+ * @property {string} [message]
+ * @property {boolean} [success]
+ */
+
+/**
+ * @typedef Ownership
+ * @property {string} [payable_by] - Promo amount bearable party
+ * @property {string} [payable_category] - Promo amount payable category
+ */
+
+/**
+ * @typedef PageCoupon
+ * @property {number} [current]
+ * @property {boolean} [has_next]
+ * @property {boolean} [has_previous]
+ * @property {number} [total]
+ * @property {number} [total_item_count]
+ */
+
+/**
+ * @typedef PaymentCouponValidate
+ * @property {CouponValidity} [coupon_validity]
+ * @property {string} [message]
+ * @property {boolean} success
+ */
+
+/**
+ * @typedef PaymentMeta
+ * @property {string} [merchant_code]
+ * @property {string} [payment_gateway]
+ * @property {string} [payment_identifier]
+ * @property {string} [type]
+ */
+
+/**
+ * @typedef PaymentMethod
+ * @property {number} [amount]
+ * @property {string} mode
+ * @property {string} [name]
+ * @property {string} [payment]
+ * @property {PaymentMeta} payment_meta
+ */
+
+/**
+ * @typedef PaymentSelectionLock
+ * @property {string} [default_options]
+ * @property {boolean} [enabled]
+ * @property {string} [payment_identifier]
+ */
+
+/**
+ * @typedef ProductAction
+ * @property {ActionQuery} [query]
+ * @property {string} [type]
+ * @property {string} [url]
+ */
+
+/**
+ * @typedef ProductArticle
+ * @property {Object} [_custom_json]
+ * @property {Object} [cart_item_meta]
+ * @property {Object} [extra_meta]
+ * @property {Object} [gift_card]
+ * @property {Object} [identifier]
+ * @property {boolean} [is_gift_visible]
+ * @property {Object} [meta]
+ * @property {number} [mto_quantity]
+ * @property {Object} [parent_item_identifiers]
+ * @property {ArticlePriceInfo} [price]
+ * @property {string[]} [product_group_tags]
+ * @property {number} [quantity]
+ * @property {BaseInfo} [seller]
+ * @property {string} [seller_identifier]
+ * @property {string} [size]
+ * @property {StoreInfo} [store]
+ * @property {string} [type]
+ * @property {string} [uid]
+ */
+
+/**
+ * @typedef ProductAvailability
+ * @property {ProductAvailabilitySize[]} [available_sizes]
+ * @property {boolean} [deliverable]
+ * @property {boolean} [is_valid]
+ * @property {number} [other_store_quantity]
+ * @property {boolean} [out_of_stock]
+ * @property {string[]} [sizes]
+ */
+
+/**
+ * @typedef ProductAvailabilitySize
+ * @property {string} [display]
+ * @property {boolean} [is_available]
+ * @property {string} [value]
+ */
+
+/**
+ * @typedef ProductImage
+ * @property {string} [aspect_ratio]
+ * @property {string} [secure_url]
+ * @property {string} [url]
+ */
+
+/**
+ * @typedef ProductPrice
+ * @property {number} [add_on]
+ * @property {string} [currency_code]
+ * @property {string} [currency_symbol]
+ * @property {number} [effective]
+ * @property {number} [marked]
+ * @property {number} [selling]
+ */
+
+/**
+ * @typedef ProductPriceInfo
+ * @property {ProductPrice} [base]
+ * @property {ProductPrice} [converted]
+ */
+
+/**
+ * @typedef PromiseFormatted
+ * @property {string} [max]
+ * @property {string} [min]
+ */
+
+/**
+ * @typedef PromiseTimestamp
+ * @property {number} [max]
+ * @property {number} [min]
+ */
+
+/**
+ * @typedef PromoMeta
+ * @property {string} [message]
+ */
+
+/**
+ * @typedef PromotionOffer
+ * @property {Object} [buy_rules] - Buy rules of promotions
+ * @property {string} [description] - Offer details including T&C
+ * @property {Object[]} [discount_rules] - Discount rules of promotions
+ * @property {FreeGiftItems[]} [free_gift_items] - Details of free gift items
+ * @property {string} [id] - Promotion id
+ * @property {string} [offer_text] - Offer title
+ * @property {string} [promotion_group] - Group of promotion belongs to
+ * @property {string} [valid_till] - Datetime ISOString for promotion end date
+ */
+
+/**
+ * @typedef PromotionOffersResponse
+ * @property {PromotionOffer[]} [available_promotions]
+ */
+
+/**
+ * @typedef RawBreakup
+ * @property {number} [cod_charge]
+ * @property {number} [convenience_fee]
+ * @property {number} [coupon]
+ * @property {number} [delivery_charge]
+ * @property {number} [discount]
+ * @property {number} [fynd_cash]
+ * @property {number} [gift_card]
+ * @property {number} [gst_charges]
+ * @property {number} [mrp_total]
+ * @property {number} [subtotal]
+ * @property {number} [total]
+ * @property {number} [vog]
+ * @property {number} [you_saved]
+ */
+
+/**
+ * @typedef RewardPointRequest
+ * @property {boolean} points
+ */
+
+/**
+ * @typedef SaveAddressResponse
+ * @property {string} [id]
+ * @property {boolean} [is_default_address]
+ * @property {boolean} [success]
+ */
+
+/**
+ * @typedef SelectCartAddressRequest
+ * @property {string} [billing_address_id]
+ * @property {string} [cart_id]
+ * @property {string} [id]
+ */
+
+/**
+ * @typedef SharedCart
+ * @property {CartBreakup} [breakup_values]
+ * @property {boolean} [buy_now]
+ * @property {number} [cart_id]
+ * @property {string} [checkout_mode]
+ * @property {string} [comment]
+ * @property {string} [coupon_text]
+ * @property {CartCurrency} [currency]
+ * @property {string} [delivery_charge_info]
+ * @property {ShipmentPromise} [delivery_promise]
+ * @property {string} [gstin]
+ * @property {string} [id]
+ * @property {boolean} [is_valid]
+ * @property {CartProductInfo[]} [items]
+ * @property {string} [last_modified]
+ * @property {string} [message]
+ * @property {PaymentSelectionLock} [payment_selection_lock]
+ * @property {boolean} [restrict_checkout]
+ * @property {SharedCartDetails} [shared_cart_details]
+ * @property {string} [uid]
+ */
+
+/**
+ * @typedef SharedCartDetails
+ * @property {string} [created_on]
+ * @property {Object} [meta] - Meta data sent while generating share cart link
+ * @property {Object} [source] - Share link device and other source information
+ * @property {string} [token] - Short link id
+ * @property {Object} [user] - User details of who generated share link
+ */
+
+/**
+ * @typedef SharedCartResponse
+ * @property {SharedCart} [cart]
+ * @property {string} [error]
+ */
+
+/**
+ * @typedef ShipmentPromise
+ * @property {PromiseFormatted} [formatted]
+ * @property {PromiseTimestamp} [timestamp]
+ */
+
+/**
+ * @typedef ShipmentResponse
+ * @property {string} [box_type]
+ * @property {string} [dp_id]
+ * @property {Object} [dp_options]
+ * @property {number} [fulfillment_id]
+ * @property {string} [fulfillment_type]
+ * @property {CartProductInfo[]} [items]
+ * @property {string} [order_type]
+ * @property {ShipmentPromise} [promise]
+ * @property {string} [shipment_type]
+ * @property {number} [shipments]
+ */
+
+/**
+ * @typedef StaffCheckout
+ * @property {string} _id
+ * @property {string} [employee_code]
+ * @property {string} first_name
+ * @property {string} last_name
+ * @property {string} user
+ */
+
+/**
+ * @typedef StoreInfo
+ * @property {string} [name]
+ * @property {string} [store_code]
+ * @property {number} [uid]
+ */
+
+/**
+ * @typedef Tags
+ * @property {Object} [tags]
+ */
+
+/**
+ * @typedef UpdateAddressResponse
+ * @property {string} [id]
+ * @property {boolean} [is_default_address]
+ * @property {boolean} [is_updated]
+ * @property {boolean} [success]
+ */
+
+/**
+ * @typedef UpdateCartDetailResponse
+ * @property {CartDetailResponse} [cart]
+ * @property {string} [message]
+ * @property {boolean} [success] - True if all items are added successfully.
+ *   False if partially added or not added.
+ */
+
+/**
+ * @typedef UpdateCartPaymentRequest
+ * @property {string} [address_id]
+ * @property {string} [aggregator_name]
+ * @property {string} [id]
+ * @property {string} [merchant_code]
+ * @property {string} [payment_identifier]
+ * @property {string} [payment_mode]
+ */
+
+/**
+ * @typedef UpdateCartRequest
+ * @property {UpdateProductCart[]} [items]
+ * @property {string} operation
+ */
+
+/**
+ * @typedef UpdateProductCart
+ * @property {Object} [_custom_json]
+ * @property {string} [article_id]
+ * @property {Object} [extra_meta]
+ * @property {CartProductIdentifer} identifiers
+ * @property {number} [item_id]
+ * @property {number} [item_index]
+ * @property {string} [item_size]
+ * @property {Object} [meta]
+ * @property {Object} [parent_item_identifiers]
+ * @property {number} [quantity]
+ */
+
+class CartApplicationModel {
+  /** @returns {ActionQuery} */
   static ActionQuery() {
     return Joi.object({
       product_slug: Joi.array().items(Joi.string().allow("")),
     });
   }
+
+  /** @returns {AddCartDetailResponse} */
   static AddCartDetailResponse() {
     return Joi.object({
-      cart: CartModel.CartDetailResponse(),
+      cart: CartApplicationModel.CartDetailResponse(),
       message: Joi.string().allow(""),
       partial: Joi.boolean(),
       success: Joi.boolean(),
     });
   }
+
+  /** @returns {AddCartRequest} */
   static AddCartRequest() {
     return Joi.object({
-      items: Joi.array().items(CartModel.AddProductCart()),
+      items: Joi.array().items(CartApplicationModel.AddProductCart()),
       new_cart: Joi.boolean(),
     });
   }
+
+  /** @returns {AddProductCart} */
   static AddProductCart() {
     return Joi.object({
       _custom_json: Joi.any(),
@@ -40,6 +973,8 @@ class CartModel {
       store_id: Joi.number(),
     });
   }
+
+  /** @returns {Address} */
   static Address() {
     return Joi.object({
       _custom_json: Joi.any(),
@@ -56,7 +991,7 @@ class CartModel {
       country_phone_code: Joi.string().allow(""),
       created_by_user_id: Joi.string().allow(""),
       email: Joi.string().allow(""),
-      geo_location: CartModel.GeoLocation(),
+      geo_location: CartApplicationModel.GeoLocation(),
       google_map_point: Joi.any(),
       id: Joi.string().allow(""),
       is_active: Joi.boolean(),
@@ -70,52 +1005,70 @@ class CartModel {
       user_id: Joi.string().allow(""),
     });
   }
+
+  /** @returns {AppliedFreeArticles} */
   static AppliedFreeArticles() {
     return Joi.object({
       article_id: Joi.string().allow(""),
-      free_gift_item_details: CartModel.FreeGiftItem(),
+      free_gift_item_details: CartApplicationModel.FreeGiftItem(),
       parent_item_identifier: Joi.string().allow(""),
       quantity: Joi.number(),
     });
   }
+
+  /** @returns {AppliedPromotion} */
   static AppliedPromotion() {
     return Joi.object({
       amount: Joi.number(),
-      applied_free_articles: Joi.array().items(CartModel.AppliedFreeArticles()),
+      applied_free_articles: Joi.array().items(
+        CartApplicationModel.AppliedFreeArticles()
+      ),
       article_quantity: Joi.number(),
-      buy_rules: Joi.array().items(CartModel.BuyRules()),
-      discount_rules: Joi.array().items(CartModel.DiscountRulesApp()),
+      buy_rules: Joi.array().items(CartApplicationModel.BuyRules()),
+      discount_rules: Joi.array().items(
+        CartApplicationModel.DiscountRulesApp()
+      ),
       mrp_promotion: Joi.boolean(),
       offer_text: Joi.string().allow(""),
-      ownership: CartModel.Ownership(),
+      ownership: CartApplicationModel.Ownership(),
       promo_id: Joi.string().allow(""),
       promotion_group: Joi.string().allow(""),
       promotion_name: Joi.string().allow(""),
       promotion_type: Joi.string().allow(""),
     });
   }
+
+  /** @returns {ApplyCouponRequest} */
   static ApplyCouponRequest() {
     return Joi.object({
       coupon_code: Joi.string().allow("").required(),
     });
   }
+
+  /** @returns {ArticleGiftDetail} */
   static ArticleGiftDetail() {
     return Joi.object({
-      article_id: CartModel.GiftDetail(),
+      article_id: CartApplicationModel.GiftDetail(),
     });
   }
+
+  /** @returns {ArticlePriceInfo} */
   static ArticlePriceInfo() {
     return Joi.object({
-      base: CartModel.BasePrice(),
-      converted: CartModel.BasePrice(),
+      base: CartApplicationModel.BasePrice(),
+      converted: CartApplicationModel.BasePrice(),
     });
   }
+
+  /** @returns {BaseInfo} */
   static BaseInfo() {
     return Joi.object({
       name: Joi.string().allow(""),
       uid: Joi.number(),
     });
   }
+
+  /** @returns {BasePrice} */
   static BasePrice() {
     return Joi.object({
       currency_code: Joi.string().allow(""),
@@ -124,37 +1077,49 @@ class CartModel {
       marked: Joi.number(),
     });
   }
+
+  /** @returns {BulkPriceOffer} */
   static BulkPriceOffer() {
     return Joi.object({
-      offers: Joi.array().items(CartModel.OfferItem()),
-      seller: CartModel.OfferSeller(),
+      offers: Joi.array().items(CartApplicationModel.OfferItem()),
+      seller: CartApplicationModel.OfferSeller(),
     });
   }
+
+  /** @returns {BulkPriceResponse} */
   static BulkPriceResponse() {
     return Joi.object({
-      data: Joi.array().items(CartModel.BulkPriceOffer()),
+      data: Joi.array().items(CartApplicationModel.BulkPriceOffer()),
     });
   }
+
+  /** @returns {BuyRules} */
   static BuyRules() {
     return Joi.object({
       cart_conditions: Joi.any(),
       item_criteria: Joi.any(),
     });
   }
+
+  /** @returns {CartBreakup} */
   static CartBreakup() {
     return Joi.object({
-      coupon: CartModel.CouponBreakup(),
-      display: Joi.array().items(CartModel.DisplayBreakup()),
-      loyalty_points: CartModel.LoyaltyPoints(),
-      raw: CartModel.RawBreakup(),
+      coupon: CartApplicationModel.CouponBreakup(),
+      display: Joi.array().items(CartApplicationModel.DisplayBreakup()),
+      loyalty_points: CartApplicationModel.LoyaltyPoints(),
+      raw: CartApplicationModel.RawBreakup(),
     });
   }
+
+  /** @returns {CartCheckoutCustomMeta} */
   static CartCheckoutCustomMeta() {
     return Joi.object({
       key: Joi.string().allow("").required(),
       value: Joi.string().allow("").required(),
     });
   }
+
+  /** @returns {CartCheckoutDetailRequest} */
   static CartCheckoutDetailRequest() {
     return Joi.object({
       address_id: Joi.string().allow(""),
@@ -162,8 +1127,10 @@ class CartModel {
       billing_address: Joi.any(),
       billing_address_id: Joi.string().allow(""),
       callback_url: Joi.string().allow("").allow(null),
-      custom_meta: Joi.array().items(CartModel.CartCheckoutCustomMeta()),
-      customer_details: CartModel.CustomerDetails(),
+      custom_meta: Joi.array().items(
+        CartApplicationModel.CartCheckoutCustomMeta()
+      ),
+      customer_details: CartApplicationModel.CustomerDetails(),
       delivery_address: Joi.any(),
       extra_meta: Joi.any(),
       id: Joi.string().allow("").allow(null),
@@ -175,9 +1142,11 @@ class CartModel {
       payment_identifier: Joi.string().allow("").allow(null),
       payment_mode: Joi.string().allow("").required(),
       payment_params: Joi.any().allow(null),
-      staff: CartModel.StaffCheckout(),
+      staff: CartApplicationModel.StaffCheckout(),
     });
   }
+
+  /** @returns {CartCheckoutDetailV2Request} */
   static CartCheckoutDetailV2Request() {
     return Joi.object({
       address_id: Joi.string().allow(""),
@@ -187,7 +1156,7 @@ class CartModel {
       callback_url: Joi.string().allow("").allow(null),
       cart_id: Joi.string().allow(""),
       custom_meta: Joi.any(),
-      customer_details: CartModel.CustomerDetails(),
+      customer_details: CartApplicationModel.CustomerDetails(),
       delivery_address: Joi.any(),
       extra_meta: Joi.any(),
       id: Joi.string().allow("").allow(null),
@@ -197,17 +1166,21 @@ class CartModel {
       ordering_store: Joi.number().allow(null),
       payment_auto_confirm: Joi.boolean(),
       payment_identifier: Joi.string().allow("").allow(null),
-      payment_methods: Joi.array().items(CartModel.PaymentMethod()).required(),
+      payment_methods: Joi.array()
+        .items(CartApplicationModel.PaymentMethod())
+        .required(),
       payment_mode: Joi.string().allow("").required(),
       payment_params: Joi.any().allow(null),
-      staff: CartModel.StaffCheckout(),
+      staff: CartApplicationModel.StaffCheckout(),
     });
   }
+
+  /** @returns {CartCheckoutResponse} */
   static CartCheckoutResponse() {
     return Joi.object({
       app_intercept_url: Joi.string().allow(""),
       callback_url: Joi.string().allow(""),
-      cart: CartModel.CheckCart(),
+      cart: CartApplicationModel.CheckCart(),
       data: Joi.any(),
       message: Joi.string().allow(""),
       order_id: Joi.string().allow(""),
@@ -215,138 +1188,166 @@ class CartModel {
       success: Joi.boolean(),
     });
   }
+
+  /** @returns {CartCurrency} */
   static CartCurrency() {
     return Joi.object({
       code: Joi.string().allow(""),
       symbol: Joi.string().allow(""),
     });
   }
+
+  /** @returns {CartDetailResponse} */
   static CartDetailResponse() {
     return Joi.object({
-      applied_promo_details: Joi.array().items(CartModel.AppliedPromotion()),
-      breakup_values: CartModel.CartBreakup(),
+      applied_promo_details: Joi.array().items(
+        CartApplicationModel.AppliedPromotion()
+      ),
+      breakup_values: CartApplicationModel.CartBreakup(),
       buy_now: Joi.boolean(),
       checkout_mode: Joi.string().allow(""),
       comment: Joi.string().allow(""),
       coupon_text: Joi.string().allow(""),
-      currency: CartModel.CartCurrency(),
+      currency: CartApplicationModel.CartCurrency(),
       delivery_charge_info: Joi.string().allow(""),
-      delivery_promise: CartModel.ShipmentPromise(),
+      delivery_promise: CartApplicationModel.ShipmentPromise(),
       gstin: Joi.string().allow(""),
       id: Joi.string().allow(""),
       is_valid: Joi.boolean(),
-      items: Joi.array().items(CartModel.CartProductInfo()),
+      items: Joi.array().items(CartApplicationModel.CartProductInfo()),
       last_modified: Joi.string().allow(""),
       message: Joi.string().allow(""),
       pan_config: Joi.any(),
       pan_no: Joi.string().allow(""),
-      payment_selection_lock: CartModel.PaymentSelectionLock(),
+      payment_selection_lock: CartApplicationModel.PaymentSelectionLock(),
       restrict_checkout: Joi.boolean(),
     });
   }
+
+  /** @returns {CartItemCountResponse} */
   static CartItemCountResponse() {
     return Joi.object({
       user_cart_items_count: Joi.number(),
     });
   }
+
+  /** @returns {CartMetaMissingResponse} */
   static CartMetaMissingResponse() {
     return Joi.object({
       errors: Joi.array().items(Joi.string().allow("")),
     });
   }
+
+  /** @returns {CartMetaRequest} */
   static CartMetaRequest() {
     return Joi.object({
       checkout_mode: Joi.string().allow(""),
       comment: Joi.string().allow(""),
       delivery_slots: Joi.any(),
-      gift_details: CartModel.ArticleGiftDetail(),
+      gift_details: CartApplicationModel.ArticleGiftDetail(),
       gstin: Joi.string().allow(""),
       pick_up_customer_details: Joi.any(),
     });
   }
+
+  /** @returns {CartMetaResponse} */
   static CartMetaResponse() {
     return Joi.object({
       is_valid: Joi.boolean(),
       message: Joi.string().allow(""),
     });
   }
+
+  /** @returns {CartProduct} */
   static CartProduct() {
     return Joi.object({
       _custom_json: Joi.any(),
-      action: CartModel.ProductAction(),
-      brand: CartModel.BaseInfo(),
-      categories: Joi.array().items(CartModel.CategoryInfo()),
-      images: Joi.array().items(CartModel.ProductImage()),
+      action: CartApplicationModel.ProductAction(),
+      brand: CartApplicationModel.BaseInfo(),
+      categories: Joi.array().items(CartApplicationModel.CategoryInfo()),
+      images: Joi.array().items(CartApplicationModel.ProductImage()),
       item_code: Joi.string().allow("").allow(null),
       name: Joi.string().allow(""),
       slug: Joi.string().allow(""),
       tags: Joi.array().items(Joi.string().allow("")),
-      teaser_tag: CartModel.Tags(),
+      teaser_tag: CartApplicationModel.Tags(),
       type: Joi.string().allow(""),
       uid: Joi.number(),
     });
   }
+
+  /** @returns {CartProductIdentifer} */
   static CartProductIdentifer() {
     return Joi.object({
       identifier: Joi.string().allow(""),
     });
   }
+
+  /** @returns {CartProductInfo} */
   static CartProductInfo() {
     return Joi.object({
-      article: CartModel.ProductArticle(),
-      availability: CartModel.ProductAvailability(),
+      article: CartApplicationModel.ProductArticle(),
+      availability: CartApplicationModel.ProductAvailability(),
       bulk_offer: Joi.any(),
-      coupon: CartModel.CouponDetails(),
+      coupon: CartApplicationModel.CouponDetails(),
       coupon_message: Joi.string().allow(""),
       custom_order: Joi.any(),
-      delivery_promise: CartModel.ShipmentPromise(),
+      delivery_promise: CartApplicationModel.ShipmentPromise(),
       discount: Joi.string().allow(""),
-      identifiers: CartModel.CartProductIdentifer().required(),
+      identifiers: CartApplicationModel.CartProductIdentifer().required(),
       is_set: Joi.boolean(),
       key: Joi.string().allow(""),
       message: Joi.string().allow(""),
       moq: Joi.any(),
       parent_item_identifiers: Joi.any(),
-      price: CartModel.ProductPriceInfo(),
-      price_per_unit: CartModel.ProductPriceInfo(),
-      product: CartModel.CartProduct(),
-      promo_meta: CartModel.PromoMeta(),
-      promotions_applied: Joi.array().items(CartModel.AppliedPromotion()),
+      price: CartApplicationModel.ProductPriceInfo(),
+      price_per_unit: CartApplicationModel.ProductPriceInfo(),
+      product: CartApplicationModel.CartProduct(),
+      promo_meta: CartApplicationModel.PromoMeta(),
+      promotions_applied: Joi.array().items(
+        CartApplicationModel.AppliedPromotion()
+      ),
       quantity: Joi.number(),
     });
   }
+
+  /** @returns {CartShipmentsResponse} */
   static CartShipmentsResponse() {
     return Joi.object({
-      breakup_values: CartModel.CartBreakup(),
+      breakup_values: CartApplicationModel.CartBreakup(),
       buy_now: Joi.boolean(),
       cart_id: Joi.number(),
       checkout_mode: Joi.string().allow(""),
       comment: Joi.string().allow(""),
       coupon_text: Joi.string().allow(""),
-      currency: CartModel.CartCurrency(),
+      currency: CartApplicationModel.CartCurrency(),
       delivery_charge_info: Joi.string().allow(""),
-      delivery_promise: CartModel.ShipmentPromise(),
+      delivery_promise: CartApplicationModel.ShipmentPromise(),
       error: Joi.boolean(),
       gstin: Joi.string().allow(""),
       id: Joi.string().allow(""),
       is_valid: Joi.boolean(),
       last_modified: Joi.string().allow(""),
       message: Joi.string().allow(""),
-      payment_selection_lock: CartModel.PaymentSelectionLock(),
+      payment_selection_lock: CartApplicationModel.PaymentSelectionLock(),
       restrict_checkout: Joi.boolean(),
-      shipments: Joi.array().items(CartModel.ShipmentResponse()),
+      shipments: Joi.array().items(CartApplicationModel.ShipmentResponse()),
       uid: Joi.string().allow(""),
     });
   }
+
+  /** @returns {CategoryInfo} */
   static CategoryInfo() {
     return Joi.object({
       name: Joi.string().allow(""),
       uid: Joi.number(),
     });
   }
+
+  /** @returns {CheckCart} */
   static CheckCart() {
     return Joi.object({
-      breakup_values: CartModel.CartBreakup(),
+      breakup_values: CartApplicationModel.CartBreakup(),
       buy_now: Joi.boolean(),
       cart_id: Joi.number(),
       checkout_mode: Joi.string().allow(""),
@@ -355,20 +1356,20 @@ class CartModel {
       cod_message: Joi.string().allow(""),
       comment: Joi.string().allow(""),
       coupon_text: Joi.string().allow(""),
-      currency: CartModel.CartCurrency(),
+      currency: CartApplicationModel.CartCurrency(),
       delivery_charge_info: Joi.string().allow(""),
       delivery_charge_order_value: Joi.number(),
       delivery_charges: Joi.number(),
-      delivery_promise: CartModel.ShipmentPromise(),
+      delivery_promise: CartApplicationModel.ShipmentPromise(),
       error_message: Joi.string().allow(""),
       gstin: Joi.string().allow(""),
       id: Joi.string().allow(""),
       is_valid: Joi.boolean(),
-      items: Joi.array().items(CartModel.CartProductInfo()),
+      items: Joi.array().items(CartApplicationModel.CartProductInfo()),
       last_modified: Joi.string().allow(""),
       message: Joi.string().allow(""),
       order_id: Joi.string().allow(""),
-      payment_selection_lock: CartModel.PaymentSelectionLock(),
+      payment_selection_lock: CartApplicationModel.PaymentSelectionLock(),
       restrict_checkout: Joi.boolean(),
       store_code: Joi.string().allow(""),
       store_emps: Joi.array().items(Joi.any()),
@@ -377,6 +1378,8 @@ class CartModel {
       user_type: Joi.string().allow(""),
     });
   }
+
+  /** @returns {Coupon} */
   static Coupon() {
     return Joi.object({
       coupon_code: Joi.string().allow(""),
@@ -393,6 +1396,8 @@ class CartModel {
       title: Joi.string().allow(""),
     });
   }
+
+  /** @returns {CouponBreakup} */
   static CouponBreakup() {
     return Joi.object({
       code: Joi.string().allow(""),
@@ -410,6 +1415,8 @@ class CartModel {
       value: Joi.number(),
     });
   }
+
+  /** @returns {CouponDetails} */
   static CouponDetails() {
     return Joi.object({
       code: Joi.string().allow(""),
@@ -417,6 +1424,8 @@ class CartModel {
       discount_total_quantity: Joi.number(),
     });
   }
+
+  /** @returns {CouponValidity} */
   static CouponValidity() {
     return Joi.object({
       code: Joi.string().allow("").allow(null),
@@ -427,12 +1436,16 @@ class CartModel {
       valid: Joi.boolean(),
     });
   }
+
+  /** @returns {CurrencyInfo} */
   static CurrencyInfo() {
     return Joi.object({
       code: Joi.string().allow(""),
       symbol: Joi.string().allow(""),
     });
   }
+
+  /** @returns {CustomerDetails} */
   static CustomerDetails() {
     return Joi.object({
       email: Joi.string().allow("").allow(null),
@@ -440,18 +1453,24 @@ class CartModel {
       name: Joi.string().allow(""),
     });
   }
+
+  /** @returns {DeleteAddressResponse} */
   static DeleteAddressResponse() {
     return Joi.object({
       id: Joi.string().allow(""),
       is_deleted: Joi.boolean(),
     });
   }
+
+  /** @returns {DeleteCartDetailResponse} */
   static DeleteCartDetailResponse() {
     return Joi.object({
       message: Joi.string().allow(""),
       success: Joi.boolean(),
     });
   }
+
+  /** @returns {DiscountRulesApp} */
   static DiscountRulesApp() {
     return Joi.object({
       item_criteria: Joi.any(),
@@ -460,6 +1479,8 @@ class CartModel {
       raw_offer: Joi.any(),
     });
   }
+
+  /** @returns {DisplayBreakup} */
   static DisplayBreakup() {
     return Joi.object({
       currency_code: Joi.string().allow(""),
@@ -470,6 +1491,8 @@ class CartModel {
       value: Joi.number(),
     });
   }
+
+  /** @returns {FreeGiftItem} */
   static FreeGiftItem() {
     return Joi.object({
       item_brand_name: Joi.string().allow(""),
@@ -480,6 +1503,8 @@ class CartModel {
       item_slug: Joi.string().allow(""),
     });
   }
+
+  /** @returns {FreeGiftItems} */
   static FreeGiftItems() {
     return Joi.object({
       item_brand_name: Joi.string().allow(""),
@@ -490,51 +1515,67 @@ class CartModel {
       item_slug: Joi.string().allow(""),
     });
   }
+
+  /** @returns {GeoLocation} */
   static GeoLocation() {
     return Joi.object({
       latitude: Joi.number(),
       longitude: Joi.number(),
     });
   }
+
+  /** @returns {GetAddressesResponse} */
   static GetAddressesResponse() {
     return Joi.object({
-      address: Joi.array().items(CartModel.Address()),
+      address: Joi.array().items(CartApplicationModel.Address()),
       pii_masking: Joi.boolean(),
     });
   }
+
+  /** @returns {GetCouponResponse} */
   static GetCouponResponse() {
     return Joi.object({
-      available_coupon_list: Joi.array().items(CartModel.Coupon()),
-      page: CartModel.PageCoupon(),
+      available_coupon_list: Joi.array().items(CartApplicationModel.Coupon()),
+      page: CartApplicationModel.PageCoupon(),
     });
   }
+
+  /** @returns {GetShareCartLinkRequest} */
   static GetShareCartLinkRequest() {
     return Joi.object({
       id: Joi.string().allow(""),
       meta: Joi.any(),
     });
   }
+
+  /** @returns {GetShareCartLinkResponse} */
   static GetShareCartLinkResponse() {
     return Joi.object({
       share_url: Joi.string().allow(""),
       token: Joi.string().allow(""),
     });
   }
+
+  /** @returns {GiftDetail} */
   static GiftDetail() {
     return Joi.object({
       gift_message: Joi.string().allow(""),
       is_gift_applied: Joi.boolean(),
     });
   }
+
+  /** @returns {LadderOfferItem} */
   static LadderOfferItem() {
     return Joi.object({
       margin: Joi.number(),
       max_quantity: Joi.number(),
       min_quantity: Joi.number(),
-      price: CartModel.LadderPrice(),
+      price: CartApplicationModel.LadderPrice(),
       type: Joi.string().allow(""),
     });
   }
+
+  /** @returns {LadderPrice} */
   static LadderPrice() {
     return Joi.object({
       currency_code: Joi.string().allow(""),
@@ -544,26 +1585,34 @@ class CartModel {
       offer_price: Joi.number(),
     });
   }
+
+  /** @returns {LadderPriceOffer} */
   static LadderPriceOffer() {
     return Joi.object({
       buy_rules: Joi.any(),
       calculate_on: Joi.string().allow(""),
       description: Joi.string().allow(""),
       discount_rules: Joi.array().items(Joi.any()),
-      free_gift_items: Joi.array().items(CartModel.FreeGiftItems()),
+      free_gift_items: Joi.array().items(CartApplicationModel.FreeGiftItems()),
       id: Joi.string().allow(""),
-      offer_prices: Joi.array().items(CartModel.LadderOfferItem()),
+      offer_prices: Joi.array().items(CartApplicationModel.LadderOfferItem()),
       offer_text: Joi.string().allow(""),
       promotion_group: Joi.string().allow(""),
       valid_till: Joi.string().allow(""),
     });
   }
+
+  /** @returns {LadderPriceOffers} */
   static LadderPriceOffers() {
     return Joi.object({
-      available_offers: Joi.array().items(CartModel.LadderPriceOffer()),
-      currency: CartModel.CurrencyInfo(),
+      available_offers: Joi.array().items(
+        CartApplicationModel.LadderPriceOffer()
+      ),
+      currency: CartApplicationModel.CurrencyInfo(),
     });
   }
+
+  /** @returns {LoyaltyPoints} */
   static LoyaltyPoints() {
     return Joi.object({
       applicable: Joi.number(),
@@ -572,17 +1621,21 @@ class CartModel {
       total: Joi.number(),
     });
   }
+
+  /** @returns {OfferItem} */
   static OfferItem() {
     return Joi.object({
       auto_applied: Joi.boolean(),
       best: Joi.boolean(),
       margin: Joi.number(),
-      price: CartModel.OfferPrice(),
+      price: CartApplicationModel.OfferPrice(),
       quantity: Joi.number(),
       total: Joi.number(),
       type: Joi.string().allow(""),
     });
   }
+
+  /** @returns {OfferPrice} */
   static OfferPrice() {
     return Joi.object({
       bulk_effective: Joi.number(),
@@ -592,24 +1645,32 @@ class CartModel {
       marked: Joi.number(),
     });
   }
+
+  /** @returns {OfferSeller} */
   static OfferSeller() {
     return Joi.object({
       name: Joi.string().allow(""),
       uid: Joi.number(),
     });
   }
+
+  /** @returns {OperationErrorResponse} */
   static OperationErrorResponse() {
     return Joi.object({
       message: Joi.string().allow(""),
       success: Joi.boolean(),
     });
   }
+
+  /** @returns {Ownership} */
   static Ownership() {
     return Joi.object({
       payable_by: Joi.string().allow(""),
       payable_category: Joi.string().allow(""),
     });
   }
+
+  /** @returns {PageCoupon} */
   static PageCoupon() {
     return Joi.object({
       current: Joi.number(),
@@ -619,13 +1680,17 @@ class CartModel {
       total_item_count: Joi.number(),
     });
   }
+
+  /** @returns {PaymentCouponValidate} */
   static PaymentCouponValidate() {
     return Joi.object({
-      coupon_validity: CartModel.CouponValidity(),
+      coupon_validity: CartApplicationModel.CouponValidity(),
       message: Joi.string().allow(""),
       success: Joi.boolean().required(),
     });
   }
+
+  /** @returns {PaymentMeta} */
   static PaymentMeta() {
     return Joi.object({
       merchant_code: Joi.string().allow(""),
@@ -634,15 +1699,19 @@ class CartModel {
       type: Joi.string().allow(""),
     });
   }
+
+  /** @returns {PaymentMethod} */
   static PaymentMethod() {
     return Joi.object({
       amount: Joi.number().allow(null),
       mode: Joi.string().allow("").required(),
       name: Joi.string().allow(""),
       payment: Joi.string().allow(""),
-      payment_meta: CartModel.PaymentMeta().required(),
+      payment_meta: CartApplicationModel.PaymentMeta().required(),
     });
   }
+
+  /** @returns {PaymentSelectionLock} */
   static PaymentSelectionLock() {
     return Joi.object({
       default_options: Joi.string().allow(""),
@@ -650,13 +1719,17 @@ class CartModel {
       payment_identifier: Joi.string().allow(""),
     });
   }
+
+  /** @returns {ProductAction} */
   static ProductAction() {
     return Joi.object({
-      query: CartModel.ActionQuery(),
+      query: CartApplicationModel.ActionQuery(),
       type: Joi.string().allow(""),
       url: Joi.string().allow(""),
     });
   }
+
+  /** @returns {ProductArticle} */
   static ProductArticle() {
     return Joi.object({
       _custom_json: Joi.any(),
@@ -668,20 +1741,24 @@ class CartModel {
       meta: Joi.any(),
       mto_quantity: Joi.number(),
       parent_item_identifiers: Joi.any(),
-      price: CartModel.ArticlePriceInfo(),
+      price: CartApplicationModel.ArticlePriceInfo(),
       product_group_tags: Joi.array().items(Joi.string().allow("")),
       quantity: Joi.number(),
-      seller: CartModel.BaseInfo(),
+      seller: CartApplicationModel.BaseInfo(),
       seller_identifier: Joi.string().allow(""),
       size: Joi.string().allow(""),
-      store: CartModel.StoreInfo(),
+      store: CartApplicationModel.StoreInfo(),
       type: Joi.string().allow(""),
       uid: Joi.string().allow(""),
     });
   }
+
+  /** @returns {ProductAvailability} */
   static ProductAvailability() {
     return Joi.object({
-      available_sizes: Joi.array().items(CartModel.ProductAvailabilitySize()),
+      available_sizes: Joi.array().items(
+        CartApplicationModel.ProductAvailabilitySize()
+      ),
       deliverable: Joi.boolean(),
       is_valid: Joi.boolean(),
       other_store_quantity: Joi.number(),
@@ -689,6 +1766,8 @@ class CartModel {
       sizes: Joi.array().items(Joi.string().allow("")),
     });
   }
+
+  /** @returns {ProductAvailabilitySize} */
   static ProductAvailabilitySize() {
     return Joi.object({
       display: Joi.string().allow(""),
@@ -696,6 +1775,8 @@ class CartModel {
       value: Joi.string().allow(""),
     });
   }
+
+  /** @returns {ProductImage} */
   static ProductImage() {
     return Joi.object({
       aspect_ratio: Joi.string().allow(""),
@@ -703,6 +1784,8 @@ class CartModel {
       url: Joi.string().allow(""),
     });
   }
+
+  /** @returns {ProductPrice} */
   static ProductPrice() {
     return Joi.object({
       add_on: Joi.number(),
@@ -713,46 +1796,62 @@ class CartModel {
       selling: Joi.number(),
     });
   }
+
+  /** @returns {ProductPriceInfo} */
   static ProductPriceInfo() {
     return Joi.object({
-      base: CartModel.ProductPrice(),
-      converted: CartModel.ProductPrice(),
+      base: CartApplicationModel.ProductPrice(),
+      converted: CartApplicationModel.ProductPrice(),
     });
   }
+
+  /** @returns {PromiseFormatted} */
   static PromiseFormatted() {
     return Joi.object({
       max: Joi.string().allow(""),
       min: Joi.string().allow(""),
     });
   }
+
+  /** @returns {PromiseTimestamp} */
   static PromiseTimestamp() {
     return Joi.object({
       max: Joi.number(),
       min: Joi.number(),
     });
   }
+
+  /** @returns {PromoMeta} */
   static PromoMeta() {
     return Joi.object({
       message: Joi.string().allow(""),
     });
   }
+
+  /** @returns {PromotionOffer} */
   static PromotionOffer() {
     return Joi.object({
       buy_rules: Joi.any(),
       description: Joi.string().allow(""),
       discount_rules: Joi.array().items(Joi.any()),
-      free_gift_items: Joi.array().items(CartModel.FreeGiftItems()),
+      free_gift_items: Joi.array().items(CartApplicationModel.FreeGiftItems()),
       id: Joi.string().allow(""),
       offer_text: Joi.string().allow(""),
       promotion_group: Joi.string().allow(""),
       valid_till: Joi.string().allow(""),
     });
   }
+
+  /** @returns {PromotionOffersResponse} */
   static PromotionOffersResponse() {
     return Joi.object({
-      available_promotions: Joi.array().items(CartModel.PromotionOffer()),
+      available_promotions: Joi.array().items(
+        CartApplicationModel.PromotionOffer()
+      ),
     });
   }
+
+  /** @returns {RawBreakup} */
   static RawBreakup() {
     return Joi.object({
       cod_charge: Joi.number(),
@@ -770,11 +1869,15 @@ class CartModel {
       you_saved: Joi.number(),
     });
   }
+
+  /** @returns {RewardPointRequest} */
   static RewardPointRequest() {
     return Joi.object({
       points: Joi.boolean().required(),
     });
   }
+
+  /** @returns {SaveAddressResponse} */
   static SaveAddressResponse() {
     return Joi.object({
       id: Joi.string().allow(""),
@@ -782,6 +1885,8 @@ class CartModel {
       success: Joi.boolean(),
     });
   }
+
+  /** @returns {SelectCartAddressRequest} */
   static SelectCartAddressRequest() {
     return Joi.object({
       billing_address_id: Joi.string().allow(""),
@@ -789,29 +1894,33 @@ class CartModel {
       id: Joi.string().allow(""),
     });
   }
+
+  /** @returns {SharedCart} */
   static SharedCart() {
     return Joi.object({
-      breakup_values: CartModel.CartBreakup(),
+      breakup_values: CartApplicationModel.CartBreakup(),
       buy_now: Joi.boolean(),
       cart_id: Joi.number(),
       checkout_mode: Joi.string().allow(""),
       comment: Joi.string().allow(""),
       coupon_text: Joi.string().allow(""),
-      currency: CartModel.CartCurrency(),
+      currency: CartApplicationModel.CartCurrency(),
       delivery_charge_info: Joi.string().allow(""),
-      delivery_promise: CartModel.ShipmentPromise(),
+      delivery_promise: CartApplicationModel.ShipmentPromise(),
       gstin: Joi.string().allow(""),
       id: Joi.string().allow(""),
       is_valid: Joi.boolean(),
-      items: Joi.array().items(CartModel.CartProductInfo()),
+      items: Joi.array().items(CartApplicationModel.CartProductInfo()),
       last_modified: Joi.string().allow(""),
       message: Joi.string().allow(""),
-      payment_selection_lock: CartModel.PaymentSelectionLock(),
+      payment_selection_lock: CartApplicationModel.PaymentSelectionLock(),
       restrict_checkout: Joi.boolean(),
-      shared_cart_details: CartModel.SharedCartDetails(),
+      shared_cart_details: CartApplicationModel.SharedCartDetails(),
       uid: Joi.string().allow(""),
     });
   }
+
+  /** @returns {SharedCartDetails} */
   static SharedCartDetails() {
     return Joi.object({
       created_on: Joi.string().allow(""),
@@ -821,18 +1930,24 @@ class CartModel {
       user: Joi.any(),
     });
   }
+
+  /** @returns {SharedCartResponse} */
   static SharedCartResponse() {
     return Joi.object({
-      cart: CartModel.SharedCart(),
+      cart: CartApplicationModel.SharedCart(),
       error: Joi.string().allow(""),
     });
   }
+
+  /** @returns {ShipmentPromise} */
   static ShipmentPromise() {
     return Joi.object({
-      formatted: CartModel.PromiseFormatted(),
-      timestamp: CartModel.PromiseTimestamp(),
+      formatted: CartApplicationModel.PromiseFormatted(),
+      timestamp: CartApplicationModel.PromiseTimestamp(),
     });
   }
+
+  /** @returns {ShipmentResponse} */
   static ShipmentResponse() {
     return Joi.object({
       box_type: Joi.string().allow("").allow(null),
@@ -840,13 +1955,15 @@ class CartModel {
       dp_options: Joi.any().allow(null),
       fulfillment_id: Joi.number(),
       fulfillment_type: Joi.string().allow(""),
-      items: Joi.array().items(CartModel.CartProductInfo()),
+      items: Joi.array().items(CartApplicationModel.CartProductInfo()),
       order_type: Joi.string().allow(""),
-      promise: CartModel.ShipmentPromise(),
+      promise: CartApplicationModel.ShipmentPromise(),
       shipment_type: Joi.string().allow(""),
       shipments: Joi.number(),
     });
   }
+
+  /** @returns {StaffCheckout} */
   static StaffCheckout() {
     return Joi.object({
       _id: Joi.string().allow("").required(),
@@ -856,6 +1973,8 @@ class CartModel {
       user: Joi.string().allow("").required(),
     });
   }
+
+  /** @returns {StoreInfo} */
   static StoreInfo() {
     return Joi.object({
       name: Joi.string().allow(""),
@@ -863,11 +1982,15 @@ class CartModel {
       uid: Joi.number(),
     });
   }
+
+  /** @returns {Tags} */
   static Tags() {
     return Joi.object({
       tags: Joi.any(),
     });
   }
+
+  /** @returns {UpdateAddressResponse} */
   static UpdateAddressResponse() {
     return Joi.object({
       id: Joi.string().allow(""),
@@ -876,13 +1999,17 @@ class CartModel {
       success: Joi.boolean(),
     });
   }
+
+  /** @returns {UpdateCartDetailResponse} */
   static UpdateCartDetailResponse() {
     return Joi.object({
-      cart: CartModel.CartDetailResponse(),
+      cart: CartApplicationModel.CartDetailResponse(),
       message: Joi.string().allow(""),
       success: Joi.boolean(),
     });
   }
+
+  /** @returns {UpdateCartPaymentRequest} */
   static UpdateCartPaymentRequest() {
     return Joi.object({
       address_id: Joi.string().allow(""),
@@ -893,18 +2020,22 @@ class CartModel {
       payment_mode: Joi.string().allow(""),
     });
   }
+
+  /** @returns {UpdateCartRequest} */
   static UpdateCartRequest() {
     return Joi.object({
-      items: Joi.array().items(CartModel.UpdateProductCart()),
+      items: Joi.array().items(CartApplicationModel.UpdateProductCart()),
       operation: Joi.string().allow("").required(),
     });
   }
+
+  /** @returns {UpdateProductCart} */
   static UpdateProductCart() {
     return Joi.object({
       _custom_json: Joi.any(),
       article_id: Joi.string().allow(""),
       extra_meta: Joi.any(),
-      identifiers: CartModel.CartProductIdentifer().required(),
+      identifiers: CartApplicationModel.CartProductIdentifer().required(),
       item_id: Joi.number(),
       item_index: Joi.number(),
       item_size: Joi.string().allow(""),
@@ -914,4 +2045,4 @@ class CartModel {
     });
   }
 }
-module.exports = CartModel;
+module.exports = CartApplicationModel;