@commercengine/storefront-sdk 0.3.12 → 0.4.1

package/dist/{types/storefront.d.ts → index.d.cts}

@@ -1,9 +1,11 @@
+import createClient from 'openapi-fetch';
+
 /**
  * This file was auto-generated by openapi-typescript.
  * Do not make direct changes to the file.
  */
 
-export interface paths {
+interface paths {
     "/catalog/products": {
         parameters: {
             query?: never;
@@ -1840,8 +1842,7 @@ export interface paths {
         trace?: never;
     };
 }
-export type webhooks = Record<string, never>;
-export interface components {
+interface components {
     schemas: {
         /** Product */
         Product: {
@@ -2499,36 +2500,18 @@ export interface components {
              * @description Subtotal including tax.
              */
             subtotal_including_tax: number;
-            /**
-             * Format: double
-             * @description Estimated cost of shipping.
-             */
-            shipping_estimated_cost: number;
-            /**
-             * Format: double
-             * @description Discount applied on estimated shipping cost.
-             */
-            shipping_discount_amount: number;
-            /**
-             * Format: double
-             * @description Shipping amount chargable to customer.
-             */
-            shipping_amount: number;
-            /**
-             * Format: double
-             * @description Shipping tax rate applied on shipping amount.
-             */
-            shipping_tax_rate: number;
-            /**
-             * Format: double
-             * @description Tax applied on shipping_amount.
-             */
-            shipping_tax_amount: number;
-            /**
-             * Format: double
-             * @description Shipping amount including shipping tax.
-             */
-            shipping_amount_including_tax: number;
+            /** @description Estimated cost of shipping. */
+            shipping_estimated_cost: number | null;
+            /** @description Discount applied on estimated shipping cost. */
+            shipping_discount_amount: number | null;
+            /** @description Shipping amount chargable to customer. */
+            shipping_amount: number | null;
+            /** @description Shipping tax rate applied on shipping amount. */
+            shipping_tax_rate: number | null;
+            /** @description Tax applied on shipping_amount. */
+            shipping_tax_amount: number | null;
+            /** @description Shipping amount including shipping tax. */
+            shipping_amount_including_tax: number | null;
             shipping_provider_id: string | null;
             shipping_provider_name: string | null;
             courier_company_id: string | null;
@@ -4545,8 +4528,7 @@ export interface components {
     headers: never;
     pathItems: never;
 }
-export type $defs = Record<string, never>;
-export interface operations {
+interface operations {
     "list-products": {
         parameters: {
             query?: {
@@ -8681,3 +8663,1487 @@ export interface operations {
         };
     };
 }
+
+type ApiResult<T> = {
+    data: T;
+    error: null;
+    response: Response;
+} | {
+    data: null;
+    error: ApiErrorResponse;
+    response: Response;
+};
+type ApiErrorResponse = {
+    success?: boolean;
+    error?: any;
+    code?: string;
+    message?: string;
+};
+type ListProductsResponse = paths['/catalog/products']['get']['responses'][200]['content']['application/json'];
+type ListProductsContent = ListProductsResponse['content'];
+type ListProductsQuery = paths['/catalog/products']['get']['parameters']['query'];
+type ListProductsHeaderParams = paths['/catalog/products']['get']['parameters']['header'];
+type ListSkusResponse = paths['/catalog/skus']['get']['responses'][200]['content']['application/json'];
+type ListSkusContent = ListSkusResponse['content'];
+type ListSkusQuery = paths['/catalog/skus']['get']['parameters']['query'];
+type ListSkusHeaderParams = paths['/catalog/skus']['get']['parameters']['header'];
+type GetProductDetailResponse = paths['/catalog/products/{product_id_or_slug}']['get']['responses'][200]['content']['application/json'];
+type GetProductDetailContent = GetProductDetailResponse['content'];
+type GetProductDetailPathParams = paths['/catalog/products/{product_id_or_slug}']['get']['parameters']['path'];
+type GetProductDetailHeaderParams = paths['/catalog/products/{product_id_or_slug}']['get']['parameters']['header'];
+type ListProductVariantsResponse = paths['/catalog/products/{product_id}/variants']['get']['responses'][200]['content']['application/json'];
+type ListProductVariantsContent = ListProductVariantsResponse['content'];
+type ListProductVariantsPathParams = paths['/catalog/products/{product_id}/variants']['get']['parameters']['path'];
+type ListProductVariantsHeaderParams = paths['/catalog/products/{product_id}/variants']['get']['parameters']['header'];
+type GetVariantDetailResponse = paths['/catalog/products/{product_id}/variants/{variant_id}']['get']['responses'][200]['content']['application/json'];
+type GetVariantDetailContent = GetVariantDetailResponse['content'];
+type GetVariantDetailPathParams = paths['/catalog/products/{product_id}/variants/{variant_id}']['get']['parameters']['path'];
+type GetVariantDetailHeaderParams = paths['/catalog/products/{product_id}/variants/{variant_id}']['get']['parameters']['header'];
+type ListCategoriesResponse = paths['/catalog/categories']['get']['responses'][200]['content']['application/json'];
+type ListCategoriesContent = ListCategoriesResponse['content'];
+type ListCategoriesQuery = paths['/catalog/categories']['get']['parameters']['query'];
+type ListProductReviewsResponse = paths['/catalog/products/{product_id}/reviews']['get']['responses'][200]['content']['application/json'];
+type ListProductReviewsContent = ListProductReviewsResponse['content'];
+type ListProductReviewsQuery = paths['/catalog/products/{product_id}/reviews']['get']['parameters']['query'];
+type ListProductReviewsPathParams = paths['/catalog/products/{product_id}/reviews']['get']['parameters']['path'];
+type CreateProductReviewResponse = paths['/catalog/products/{product_id}/reviews']['post']['responses'][200]['content']['application/json'];
+type CreateProductReviewPathParams = paths['/catalog/products/{product_id}/reviews']['post']['parameters']['path'];
+type CreateProductReviewFormData = NonNullable<paths['/catalog/products/{product_id}/reviews']['post']['requestBody']>['content']['multipart/form-data'];
+type ListSimilarProductsResponse = paths['/catalog/products/similar']['get']['responses'][200]['content']['application/json'];
+type ListSimilarProductsContent = ListSimilarProductsResponse['content'];
+type ListSimilarProductsQuery = paths['/catalog/products/similar']['get']['parameters']['query'];
+type ListSimilarProductsHeaderParams = paths['/catalog/products/similar']['get']['parameters']['header'];
+type ListUpsellProductsResponse = paths['/catalog/products/up-sell']['get']['responses'][200]['content']['application/json'];
+type ListUpsellProductsContent = ListUpsellProductsResponse['content'];
+type ListUpsellProductsQuery = paths['/catalog/products/up-sell']['get']['parameters']['query'];
+type ListUpsellProductsHeaderParams = paths['/catalog/products/up-sell']['get']['parameters']['header'];
+type ListCrosssellProductsResponse = paths['/catalog/products/cross-sell']['get']['responses'][200]['content']['application/json'];
+type ListCrosssellProductsContent = ListCrosssellProductsResponse['content'];
+type ListCrosssellProductsQuery = paths['/catalog/products/cross-sell']['get']['parameters']['query'];
+type ListCrosssellProductsHeaderParams = paths['/catalog/products/cross-sell']['get']['parameters']['header'];
+type SearchProductsResponse = paths['/catalog/products/search']['post']['responses'][200]['content']['application/json'];
+type SearchProductsContent = SearchProductsResponse['content'];
+type SearchProductsHeaderParams = paths['/catalog/products/search']['post']['parameters']['header'];
+type SearchProductsBody = NonNullable<paths['/catalog/products/search']['post']['requestBody']>['content']['application/json'];
+type CreateCartResponse = paths['/carts']['post']['responses'][200]['content']['application/json'];
+type CreateCartContent = CreateCartResponse['content'];
+type CreateCartBody = NonNullable<paths['/carts']['post']['requestBody']>['content']['application/json'];
+type GetCartResponse = paths['/carts/{id}']['get']['responses'][200]['content']['application/json'];
+type GetCartContent = GetCartResponse['content'];
+type GetCartPathParams = paths['/carts/{id}']['get']['parameters']['path'];
+type DeleteCartResponse = paths['/carts/{id}']['delete']['responses'][200]['content']['application/json'];
+type DeleteCartPathParams = paths['/carts/{id}']['delete']['parameters']['path'];
+type GetUserCartResponse = paths['/carts/users/{user_id}']['get']['responses'][200]['content']['application/json'];
+type GetUserCartContent = GetUserCartResponse['content'];
+type GetUserCartPathParams = paths['/carts/users/{user_id}']['get']['parameters']['path'];
+type DeleteUserCartResponse = paths['/carts/users/{user_id}']['delete']['responses'][200]['content']['application/json'];
+type DeleteUserCartPathParams = paths['/carts/users/{user_id}']['delete']['parameters']['path'];
+type UpdateCartResponse = paths['/carts/{id}/items']['post']['responses'][200]['content']['application/json'];
+type UpdateCartContent = UpdateCartResponse['content'];
+type UpdateCartPathParams = paths['/carts/{id}/items']['post']['parameters']['path'];
+type UpdateCartBody = NonNullable<paths['/carts/{id}/items']['post']['requestBody']>['content']['application/json'];
+type CreateCartAddressResponse = paths['/carts/{id}/address']['post']['responses'][200]['content']['application/json'];
+type CreateCartAddressContent = CreateCartAddressResponse['content'];
+type CreateCartAddressPathParams = paths['/carts/{id}/address']['post']['parameters']['path'];
+type CreateCartAddressBody = NonNullable<paths['/carts/{id}/address']['post']['requestBody']>['content']['application/json'];
+type UpdateShippingMethodResponse = paths['/carts/{id}/shipping-method']['post']['responses'][200]['content']['application/json'];
+type UpdateShippingMethodContent = UpdateShippingMethodResponse['content'];
+type UpdateShippingMethodPathParams = paths['/carts/{id}/shipping-method']['post']['parameters']['path'];
+type UpdateShippingMethodBody = NonNullable<paths['/carts/{id}/shipping-method']['post']['requestBody']>['content']['application/json'];
+type ApplyCouponResponse = paths['/carts/{id}/coupon']['post']['responses'][200]['content']['application/json'];
+type ApplyCouponContent = ApplyCouponResponse['content'];
+type ApplyCouponPathParams = paths['/carts/{id}/coupon']['post']['parameters']['path'];
+type ApplyCouponBody = NonNullable<paths['/carts/{id}/coupon']['post']['requestBody']>['content']['application/json'];
+type RemoveCouponResponse = paths['/carts/{id}/coupon']['delete']['responses'][200]['content']['application/json'];
+type RemoveCouponContent = RemoveCouponResponse['content'];
+type RemoveCouponPathParams = paths['/carts/{id}/coupon']['delete']['parameters']['path'];
+type RedeemLoyaltyPointsResponse = paths['/carts/{id}/loyalty-points']['post']['responses'][200]['content']['application/json'];
+type RedeemLoyaltyPointsContent = RedeemLoyaltyPointsResponse['content'];
+type RedeemLoyaltyPointsPathParams = paths['/carts/{id}/loyalty-points']['post']['parameters']['path'];
+type RedeemLoyaltyPointsBody = NonNullable<paths['/carts/{id}/loyalty-points']['post']['requestBody']>['content']['application/json'];
+type RemoveLoyaltyPointsResponse = paths['/carts/{id}/loyalty-points']['delete']['responses'][200]['content']['application/json'];
+type RemoveLoyaltyPointsContent = RemoveLoyaltyPointsResponse['content'];
+type RemoveLoyaltyPointsPathParams = paths['/carts/{id}/loyalty-points']['delete']['parameters']['path'];
+type RedeemCreditBalanceResponse = paths['/carts/{id}/credit-balance']['post']['responses'][200]['content']['application/json'];
+type RedeemCreditBalanceContent = RedeemCreditBalanceResponse['content'];
+type RedeemCreditBalancePathParams = paths['/carts/{id}/credit-balance']['post']['parameters']['path'];
+type RedeemCreditBalanceBody = NonNullable<paths['/carts/{id}/credit-balance']['post']['requestBody']>['content']['application/json'];
+type RemoveCreditBalanceResponse = paths['/carts/{id}/credit-balance']['delete']['responses'][200]['content']['application/json'];
+type RemoveCreditBalanceContent = RemoveCreditBalanceResponse['content'];
+type RemoveCreditBalancePathParams = paths['/carts/{id}/credit-balance']['delete']['parameters']['path'];
+type RedeemGiftCardResponse = paths['/carts/{id}/gift-card']['post']['responses'][200]['content']['application/json'];
+type RedeemGiftCardContent = RedeemGiftCardResponse['content'];
+type RedeemGiftCardPathParams = paths['/carts/{id}/gift-card']['post']['parameters']['path'];
+type RedeemGiftCardBody = NonNullable<paths['/carts/{id}/gift-card']['post']['requestBody']>['content']['application/json'];
+type RemoveGiftCardResponse = paths['/carts/{id}/gift-card']['delete']['responses'][200]['content']['application/json'];
+type RemoveGiftCardContent = RemoveGiftCardResponse['content'];
+type RemoveGiftCardPathParams = paths['/carts/{id}/gift-card']['delete']['parameters']['path'];
+type ListCouponsResponse = paths['/carts/available-coupons']['get']['responses'][200]['content']['application/json'];
+type ListCouponsContent = ListCouponsResponse['content'];
+type ListCouponsHeaderParams = paths['/carts/available-coupons']['get']['parameters']['header'];
+type ListPromotionsResponse = paths['/carts/available-promotions']['get']['responses'][200]['content']['application/json'];
+type ListPromotionsContent = ListPromotionsResponse['content'];
+type ListPromotionsHeaderParams = paths['/carts/available-promotions']['get']['parameters']['header'];
+type GetWishlistResponse = paths['/wishlist/{user_id}']['get']['responses'][200]['content']['application/json'];
+type GetWishlistContent = GetWishlistResponse['content'];
+type GetWishlistPathParams = paths['/wishlist/{user_id}']['get']['parameters']['path'];
+type AddToWishlistResponse = paths['/wishlist/{user_id}']['post']['responses'][200]['content']['application/json'];
+type AddToWishlistContent = AddToWishlistResponse['content'];
+type AddToWishlistPathParams = paths['/wishlist/{user_id}']['post']['parameters']['path'];
+type AddToWishlistBody = NonNullable<paths['/wishlist/{user_id}']['post']['requestBody']>['content']['application/json'];
+type DeleteFromWishlistResponse = paths['/wishlist/{user_id}']['delete']['responses'][200]['content']['application/json'];
+type DeleteFromWishlistContent = DeleteFromWishlistResponse['content'];
+type DeleteFromWishlistPathParams = paths['/wishlist/{user_id}']['delete']['parameters']['path'];
+type DeleteFromWishlistBody = NonNullable<paths['/wishlist/{user_id}']['delete']['requestBody']>['content']['application/json'];
+type CreateCustomerResponse = paths['/customers']['post']['responses'][200]['content']['application/json'];
+type CreateCustomerContent = CreateCustomerResponse['content'];
+type CreateCustomerBody = NonNullable<paths['/customers']['post']['requestBody']>['content']['application/json'];
+type GetCustomerDetailResponse = paths['/customers/{id}']['get']['responses'][200]['content']['application/json'];
+type GetCustomerDetailContent = GetCustomerDetailResponse['content'];
+type GetCustomerDetailPathParams = paths['/customers/{id}']['get']['parameters']['path'];
+type UpdateCustomerResponse = paths['/customers/{id}']['put']['responses'][200]['content']['application/json'];
+type UpdateCustomerContent = UpdateCustomerResponse['content'];
+type UpdateCustomerPathParams = paths['/customers/{id}']['put']['parameters']['path'];
+type UpdateCustomerBody = NonNullable<paths['/customers/{id}']['put']['requestBody']>['content']['application/json'];
+type ListAddressesResponse = paths['/customers/{user_id}/addresses']['get']['responses'][200]['content']['application/json'];
+type ListAddressesContent = ListAddressesResponse['content'];
+type ListAddressesQuery = paths['/customers/{user_id}/addresses']['get']['parameters']['query'];
+type ListAddressesPathParams = paths['/customers/{user_id}/addresses']['get']['parameters']['path'];
+type CreateAddressResponse = paths['/customers/{user_id}/addresses']['post']['responses'][200]['content']['application/json'];
+type CreateAddressContent = CreateAddressResponse['content'];
+type CreateAddressPathParams = paths['/customers/{user_id}/addresses']['post']['parameters']['path'];
+type CreateAddressBody = NonNullable<paths['/customers/{user_id}/addresses']['post']['requestBody']>['content']['application/json'];
+type GetAddressDetailResponse = paths['/customers/{user_id}/addresses/{address_id}']['get']['responses'][200]['content']['application/json'];
+type GetAddressDetailContent = GetAddressDetailResponse['content'];
+type GetAddressDetailPathParams = paths['/customers/{user_id}/addresses/{address_id}']['get']['parameters']['path'];
+type UpdateAddressDetailResponse = paths['/customers/{user_id}/addresses/{address_id}']['put']['responses'][200]['content']['application/json'];
+type UpdateAddressDetailContent = UpdateAddressDetailResponse['content'];
+type UpdateAddressDetailPathParams = paths['/customers/{user_id}/addresses/{address_id}']['put']['parameters']['path'];
+type UpdateAddressDetailBody = NonNullable<paths['/customers/{user_id}/addresses/{address_id}']['put']['requestBody']>['content']['application/json'];
+type DeleteAddressResponse = paths['/customers/{user_id}/addresses/{address_id}']['delete']['responses'][200]['content']['application/json'];
+type DeleteAddressPathParams = paths['/customers/{user_id}/addresses/{address_id}']['delete']['parameters']['path'];
+type ListKycDocumentResponse = paths['/store/kyc-document']['get']['responses'][200]['content']['application/json'];
+type ListKycDocumentContent = ListKycDocumentResponse['content'];
+type GetConfigResponse = paths['/store/config']['get']['responses'][200]['content']['application/json'];
+type GetConfigContent = GetConfigResponse['content'];
+type ListDocumentsResponse = paths['/customers/{id}/documents']['get']['responses'][200]['content']['application/json'];
+type ListDocumentsContent = ListDocumentsResponse['content'];
+type ListDocumentsPathParams = paths['/customers/{id}/documents']['get']['parameters']['path'];
+type CreateDocumentResponse = paths['/customers/{id}/documents']['post']['responses'][200]['content']['application/json'];
+type CreateDocumentContent = CreateDocumentResponse['content'];
+type CreateDocumentPathParams = paths['/customers/{id}/documents']['post']['parameters']['path'];
+type CreateDocumentFormData = NonNullable<paths['/customers/{id}/documents']['post']['requestBody']>['content']['multipart/form-data'];
+type GetDocumentResponse = paths['/customers/{id}/documents/{document_id}']['get']['responses'][200]['content']['application/json'];
+type GetDocumentContent = GetDocumentResponse['content'];
+type GetDocumentPathParams = paths['/customers/{id}/documents/{document_id}']['get']['parameters']['path'];
+type UpdateDocumentResponse = paths['/customers/{id}/documents/{document_id}']['put']['responses'][200]['content']['application/json'];
+type UpdateDocumentContent = UpdateDocumentResponse['content'];
+type UpdateDocumentPathParams = paths['/customers/{id}/documents/{document_id}']['put']['parameters']['path'];
+type UpdateDocumentFormData = NonNullable<paths['/customers/{id}/documents/{document_id}']['put']['requestBody']>['content']['multipart/form-data'];
+type DeleteDocumentResponse = paths['/customers/{id}/documents/{document_id}']['delete']['responses'][200]['content']['application/json'];
+type DeleteDocumentPathParams = paths['/customers/{id}/documents/{document_id}']['delete']['parameters']['path'];
+type VerifyDocumentResponse = paths['/customers/{id}/documents/verify']['post']['responses'][200]['content']['application/json'];
+type VerifyDocumentContent = VerifyDocumentResponse['content'];
+type VerifyDocumentPathParams = paths['/customers/{id}/documents/verify']['post']['parameters']['path'];
+type VerifyDocumentBody = NonNullable<paths['/customers/{id}/documents/verify']['post']['requestBody']>['content']['application/json'];
+type GetLoyaltyDetailsResponse = paths['/customers/{user_id}/loyalty']['get']['responses'][200]['content']['application/json'];
+type GetLoyaltyDetailsContent = GetLoyaltyDetailsResponse['content'];
+type GetLoyaltyDetailsPathParams = paths['/customers/{user_id}/loyalty']['get']['parameters']['path'];
+type ListLoyaltyActivitiesResponse = paths['/customers/{user_id}/loyalty-points-activity']['get']['responses'][200]['content']['application/json'];
+type ListLoyaltyActivitiesContent = ListLoyaltyActivitiesResponse['content'];
+type ListLoyaltyActivitiesQuery = paths['/customers/{user_id}/loyalty-points-activity']['get']['parameters']['query'];
+type ListLoyaltyActivitiesPathParams = paths['/customers/{user_id}/loyalty-points-activity']['get']['parameters']['path'];
+type ListOrdersResponse = paths['/orders']['get']['responses'][200]['content']['application/json'];
+type ListOrdersContent = ListOrdersResponse['content'];
+type ListOrdersQuery = paths['/orders']['get']['parameters']['query'];
+type CreateOrderResponse = paths['/orders']['post']['responses'][200]['content']['application/json'];
+type CreateOrderContent = CreateOrderResponse['content'];
+type CreateOrderBody = NonNullable<paths['/orders']['post']['requestBody']>['content']['application/json'];
+type GetOrderDetailResponse = paths['/orders/{order_number}']['get']['responses'][200]['content']['application/json'];
+type GetOrderDetailContent = GetOrderDetailResponse['content'];
+type GetOrderDetailPathParams = paths['/orders/{order_number}']['get']['parameters']['path'];
+type GetPaymentStatusResponse = paths['/orders/{order_number}/payment-status']['get']['responses'][200]['content']['application/json'];
+type GetPaymentStatusContent = GetPaymentStatusResponse['content'];
+type GetPaymentStatusPathParams = paths['/orders/{order_number}/payment-status']['get']['parameters']['path'];
+type ListOrderShipmentsResponse = paths['/orders/{order_number}/shipments']['get']['responses'][200]['content']['application/json'];
+type ListOrderShipmentsContent = ListOrderShipmentsResponse['content'];
+type ListOrderShipmentsPathParams = paths['/orders/{order_number}/shipments']['get']['parameters']['path'];
+type ListOrderRefundsResponse = paths['/orders/{order_number}/refunds']['get']['responses'][200]['content']['application/json'];
+type ListOrderRefundsContent = ListOrderRefundsResponse['content'];
+type ListOrderRefundsPathParams = paths['/orders/{order_number}/refunds']['get']['parameters']['path'];
+type ListOrderPaymentsResponse = paths['/orders/{order_number}/payments']['get']['responses'][200]['content']['application/json'];
+type ListOrderPaymentsContent = ListOrderPaymentsResponse['content'];
+type ListOrderPaymentsPathParams = paths['/orders/{order_number}/payments']['get']['parameters']['path'];
+type CreateOrderReturnResponse = paths['/orders/{order_number}/return']['post']['responses'][200]['content']['application/json'];
+type CreateOrderReturnContent = CreateOrderReturnResponse['content'];
+type CreateOrderReturnPathParams = paths['/orders/{order_number}/return']['post']['parameters']['path'];
+type CreateOrderReturnBody = NonNullable<paths['/orders/{order_number}/return']['post']['requestBody']>['content']['application/json'];
+type GetOrderReturnDetailResponse = paths['/orders/{order_number}/return/{return_id}']['get']['responses'][200]['content']['application/json'];
+type GetOrderReturnDetailContent = GetOrderReturnDetailResponse['content'];
+type GetOrderReturnDetailPathParams = paths['/orders/{order_number}/return/{return_id}']['get']['parameters']['path'];
+type CancelOrderResponse = paths['/orders/{order_number}/cancel']['post']['responses'][200]['content']['application/json'];
+type CancelOrderContent = CancelOrderResponse['content'];
+type CancelOrderPathParams = paths['/orders/{order_number}/cancel']['post']['parameters']['path'];
+type CancelOrderBody = NonNullable<paths['/orders/{order_number}/cancel']['post']['requestBody']>['content']['application/json'];
+type RetryOrderPaymentResponse = paths['/orders/{order_number}/retry-payment']['post']['responses'][200]['content']['application/json'];
+type RetryOrderPaymentContent = RetryOrderPaymentResponse['content'];
+type RetryOrderPaymentPathParams = paths['/orders/{order_number}/retry-payment']['post']['parameters']['path'];
+type RetryOrderPaymentBody = NonNullable<paths['/orders/{order_number}/retry-payment']['post']['requestBody']>['content']['application/json'];
+type GetShippingMethodsResponse = paths['/shipping/shipping-methods']['post']['responses'][200]['content']['application/json'];
+type GetShippingMethodsContent = GetShippingMethodsResponse['content'];
+type GetShippingMethodsBody = NonNullable<paths['/shipping/shipping-methods']['post']['requestBody']>['content']['application/json'];
+type CheckPincodeServiceabilityResponse = paths['/shipping/serviceability/{pincode}']['get']['responses'][200]['content']['application/json'];
+type CheckPincodeServiceabilityContent = CheckPincodeServiceabilityResponse['content'];
+type CheckPincodeServiceabilityPathParams = paths['/shipping/serviceability/{pincode}']['get']['parameters']['path'];
+type GetAnonymousTokenResponse = paths['/auth/anonymous']['post']['responses'][200]['content']['application/json'];
+type GetAnonymousTokenContent = GetAnonymousTokenResponse['content'];
+type LoginWithPhoneResponse = paths['/auth/login/phone']['post']['responses'][200]['content']['application/json'];
+type LoginWithPhoneContent = LoginWithPhoneResponse['content'];
+type LoginWithPhoneBody = NonNullable<paths['/auth/login/phone']['post']['requestBody']>['content']['application/json'];
+type LoginWithEmailResponse = paths['/auth/login/email']['post']['responses'][200]['content']['application/json'];
+type LoginWithEmailContent = LoginWithEmailResponse['content'];
+type LoginWithEmailBody = NonNullable<paths['/auth/login/email']['post']['requestBody']>['content']['application/json'];
+type LoginWithWhatsappResponse = paths['/auth/login/whatsapp']['post']['responses'][200]['content']['application/json'];
+type LoginWithWhatsappContent = LoginWithWhatsappResponse['content'];
+type LoginWithWhatsappBody = NonNullable<paths['/auth/login/whatsapp']['post']['requestBody']>['content']['application/json'];
+type LoginWithPasswordResponse = paths['/auth/login/password']['post']['responses'][200]['content']['application/json'];
+type LoginWithPasswordContent = LoginWithPasswordResponse['content'];
+type LoginWithPasswordBody = NonNullable<paths['/auth/login/password']['post']['requestBody']>['content']['application/json'];
+type VerifyOtpResponse = paths['/auth/verify-otp']['post']['responses'][200]['content']['application/json'];
+type VerifyOtpContent = VerifyOtpResponse['content'];
+type VerifyOtpBody = NonNullable<paths['/auth/verify-otp']['post']['requestBody']>['content']['application/json'];
+type RegisterWithPhoneResponse = paths['/auth/register/phone']['post']['responses'][200]['content']['application/json'];
+type RegisterWithPhoneContent = RegisterWithPhoneResponse['content'];
+type RegisterWithPhoneBody = NonNullable<paths['/auth/register/phone']['post']['requestBody']>['content']['application/json'];
+type RegisterWithEmailResponse = paths['/auth/register/email']['post']['responses'][200]['content']['application/json'];
+type RegisterWithEmailContent = RegisterWithEmailResponse['content'];
+type RegisterWithEmailBody = NonNullable<paths['/auth/register/email']['post']['requestBody']>['content']['application/json'];
+type RegisterWithWhatsappResponse = paths['/auth/register/whatsapp']['post']['responses'][200]['content']['application/json'];
+type RegisterWithWhatsappContent = RegisterWithWhatsappResponse['content'];
+type RegisterWithWhatsappBody = NonNullable<paths['/auth/register/whatsapp']['post']['requestBody']>['content']['application/json'];
+type RegisterWithPasswordResponse = paths['/auth/register/password']['post']['responses'][200]['content']['application/json'];
+type RegisterWithPasswordContent = RegisterWithPasswordResponse['content'];
+type RegisterWithPasswordBody = NonNullable<paths['/auth/register/password']['post']['requestBody']>['content']['application/json'];
+type GetUserDetailResponse = paths['/auth/user/{id}']['get']['responses'][200]['content']['application/json'];
+type GetUserDetailContent = GetUserDetailResponse['content'];
+type GetUserDetailPathParams = paths['/auth/user/{id}']['get']['parameters']['path'];
+type UpdateUserResponse = paths['/auth/user/{id}']['put']['responses'][200]['content']['application/json'];
+type UpdateUserContent = UpdateUserResponse['content'];
+type UpdateUserPathParams = paths['/auth/user/{id}']['put']['parameters']['path'];
+type UpdateUserBody = NonNullable<paths['/auth/user/{id}']['put']['requestBody']>['content']['application/json'];
+type GetProfileImageResponse = paths['/auth/user/{id}/profile-image']['get']['responses'][200]['content']['application/json'];
+type GetProfileImageContent = GetProfileImageResponse['content'];
+type GetProfileImagePathParams = paths['/auth/user/{id}/profile-image']['get']['parameters']['path'];
+type UpdateProfileImageResponse = paths['/auth/user/{id}/profile-image']['put']['responses'][200]['content']['application/json'];
+type UpdateProfileImageContent = UpdateProfileImageResponse['content'];
+type UpdateProfileImagePathParams = paths['/auth/user/{id}/profile-image']['put']['parameters']['path'];
+type UpdateProfileImageFormData = NonNullable<paths['/auth/user/{id}/profile-image']['put']['requestBody']>['content']['multipart/form-data'];
+type AddProfileImageResponse = paths['/auth/user/{id}/profile-image']['post']['responses'][200]['content']['application/json'];
+type AddProfileImageContent = AddProfileImageResponse['content'];
+type AddProfileImagePathParams = paths['/auth/user/{id}/profile-image']['post']['parameters']['path'];
+type AddProfileImageFormData = NonNullable<paths['/auth/user/{id}/profile-image']['post']['requestBody']>['content']['multipart/form-data'];
+type RemoveProfileImageResponse = paths['/auth/user/{id}/profile-image']['delete']['responses'][200]['content']['application/json'];
+type RemoveProfileImagePathParams = paths['/auth/user/{id}/profile-image']['delete']['parameters']['path'];
+type DeactivateUserResponse = paths['/auth/user/{id}/deactivate']['put']['responses'][200]['content']['application/json'];
+type DeactivateUserPathParams = paths['/auth/user/{id}/deactivate']['put']['parameters']['path'];
+type RefreshTokenResponse = paths['/auth/refresh-token']['post']['responses'][200]['content']['application/json'];
+type RefreshTokenContent = RefreshTokenResponse['content'];
+type RefreshTokenBody = NonNullable<paths['/auth/refresh-token']['post']['requestBody']>['content']['application/json'];
+type ChangePasswordResponse = paths['/auth/change-password']['post']['responses'][200]['content']['application/json'];
+type ChangePasswordContent = ChangePasswordResponse['content'];
+type ChangePasswordBody = NonNullable<paths['/auth/change-password']['post']['requestBody']>['content']['application/json'];
+type ForgotPasswordResponse = paths['/auth/forgot-password']['post']['responses'][200]['content']['application/json'];
+type ForgotPasswordContent = ForgotPasswordResponse['content'];
+type ForgotPasswordBody = NonNullable<paths['/auth/forgot-password']['post']['requestBody']>['content']['application/json'];
+type ResetPasswordResponse = paths['/auth/reset-password']['post']['responses'][200]['content']['application/json'];
+type ResetPasswordContent = ResetPasswordResponse['content'];
+type ResetPasswordBody = NonNullable<paths['/auth/reset-password']['post']['requestBody']>['content']['application/json'];
+type GetNotificationPreferencesResponse = paths['/auth/user/{id}/notification-preferences']['get']['responses'][200]['content']['application/json'];
+type GetNotificationPreferencesContent = GetNotificationPreferencesResponse['content'];
+type GetNotificationPreferencesPathParams = paths['/auth/user/{id}/notification-preferences']['get']['parameters']['path'];
+type UpdateNotificationPreferencesResponse = paths['/auth/user/{id}/notification-preferences']['put']['responses'][200]['content']['application/json'];
+type UpdateNotificationPreferencesContent = UpdateNotificationPreferencesResponse['content'];
+type UpdateNotificationPreferencesPathParams = paths['/auth/user/{id}/notification-preferences']['put']['parameters']['path'];
+type UpdateNotificationPreferencesBody = NonNullable<paths['/auth/user/{id}/notification-preferences']['put']['requestBody']>['content']['application/json'];
+type CreateNotificationPreferencesResponse = paths['/auth/user/{id}/notification-preferences']['post']['responses'][200]['content']['application/json'];
+type CreateNotificationPreferencesContent = CreateNotificationPreferencesResponse['content'];
+type CreateNotificationPreferencesPathParams = paths['/auth/user/{id}/notification-preferences']['post']['parameters']['path'];
+type CreateNotificationPreferencesBody = NonNullable<paths['/auth/user/{id}/notification-preferences']['post']['requestBody']>['content']['application/json'];
+type GenerateOtpResponse = paths['/auth/generate-otp']['post']['responses'][200]['content']['application/json'];
+type GenerateOtpContent = GenerateOtpResponse['content'];
+type GenerateOtpBody = NonNullable<paths['/auth/generate-otp']['post']['requestBody']>['content']['application/json'];
+type LogoutResponse = paths['/auth/logout']['post']['responses'][200]['content']['application/json'];
+type LogoutContent = LogoutResponse['content'];
+type ListUserReviewsResponse = paths['/customers/{user_id}/reviews']['get']['responses'][200]['content']['application/json'];
+type ListUserReviewsContent = ListUserReviewsResponse['content'];
+type ListUserReviewsPathParams = paths['/customers/{user_id}/reviews']['get']['parameters']['path'];
+type CheckVerificationStatusResponse = paths['/auth/verified-email-phone']['post']['responses'][200]['content']['application/json'];
+type CheckVerificationStatusContent = CheckVerificationStatusResponse['content'];
+type CheckVerificationStatusBody = NonNullable<paths['/auth/verified-email-phone']['post']['requestBody']>['content']['application/json'];
+type GenerateHashResponse = paths['/payments/generate-hash']['post']['responses'][200]['content']['application/json'];
+type GenerateHashContent = GenerateHashResponse['content'];
+type GenerateHashBody = NonNullable<paths['/payments/generate-hash']['post']['requestBody']>['content']['application/json'];
+type ListPaymentMethodsResponse = paths['/payments/payment-methods']['get']['responses'][200]['content']['application/json'];
+type ListPaymentMethodsContent = ListPaymentMethodsResponse['content'];
+type ListPaymentMethodsQuery = paths['/payments/payment-methods']['get']['parameters']['query'];
+type ListSavedCardsResponse = paths['/payments/cards']['get']['responses'][200]['content']['application/json'];
+type ListSavedCardsContent = ListSavedCardsResponse['content'];
+type ListSavedCardsQuery = paths['/payments/cards']['get']['parameters']['query'];
+type AddCardResponse = paths['/payments/cards']['post']['responses'][200]['content']['application/json'];
+type AddCardContent = AddCardResponse['content'];
+type AddCardBody = NonNullable<paths['/payments/cards']['post']['requestBody']>['content']['application/json'];
+type VerifyVpaResponse = paths['/payments/verify-vpa']['get']['responses'][200]['content']['application/json'];
+type VerifyVpaContent = VerifyVpaResponse['content'];
+type VerifyVpaQuery = paths['/payments/verify-vpa']['get']['parameters']['query'];
+type CreateJuspayOrderResponse = paths['/payments/juspay/create-order']['post']['responses'][200]['content']['application/json'];
+type CreateJuspayOrderContent = CreateJuspayOrderResponse['content'];
+type CreateJuspayOrderBody = NonNullable<paths['/payments/juspay/create-order']['post']['requestBody']>['content']['application/json'];
+type CreateJuspayCustomerResponse = paths['/payments/juspay/customers']['post']['responses'][200]['content']['application/json'];
+type CreateJuspayCustomerContent = CreateJuspayCustomerResponse['content'];
+type CreateJuspayCustomerBody = NonNullable<paths['/payments/juspay/customers']['post']['requestBody']>['content']['application/json'];
+type GetJuspayCustomerResponse = paths['/payments/juspay/customers/{user-id}']['get']['responses'][200]['content']['application/json'];
+type GetJuspayCustomerContent = GetJuspayCustomerResponse['content'];
+type GetJuspayCustomerPathParams = paths['/payments/juspay/customers/{user-id}']['get']['parameters']['path'];
+type ListCountriesResponse = paths['/common/countries']['get']['responses'][200]['content']['application/json'];
+type ListCountriesContent = ListCountriesResponse['content'];
+type ListCountryStatesResponse = paths['/common/countries/{country_iso_code}/states']['get']['responses'][200]['content']['application/json'];
+type ListCountryStatesContent = ListCountryStatesResponse['content'];
+type ListCountryStatesPathParams = paths['/common/countries/{country_iso_code}/states']['get']['parameters']['path'];
+type ListCountryPincodesResponse = paths['/common/countries/{country_iso_code}/pincodes']['get']['responses'][200]['content']['application/json'];
+type ListCountryPincodesContent = ListCountryPincodesResponse['content'];
+type ListCountryPincodesQuery = paths['/common/countries/{country_iso_code}/pincodes']['get']['parameters']['query'];
+type ListCountryPincodesPathParams = paths['/common/countries/{country_iso_code}/pincodes']['get']['parameters']['path'];
+type ListReturnsResponse = paths['/orders/returns']['get']['responses'][200]['content']['application/json'];
+type ListReturnsContent = ListReturnsResponse['content'];
+type TrackAnalyticsEventResponse = paths['/analytics/track']['post']['responses'][200]['content']['application/json'];
+type TrackAnalyticsEventBody = NonNullable<paths['/analytics/track']['post']['requestBody']>['content']['application/json'];
+type SubscribeNewsletterResponse = paths['/campaigns/newsletter-subscribe']['post']['responses'][200]['content']['application/json'];
+type SubscribeNewsletterBody = NonNullable<paths['/campaigns/newsletter-subscribe']['post']['requestBody']>['content']['application/json'];
+type ListSubscriptionsResponse = paths['/subscriptions']['get']['responses'][200]['content']['application/json'];
+type ListSubscriptionsContent = ListSubscriptionsResponse['content'];
+type CreateSubscriptionResponse = paths['/subscriptions']['post']['responses'][200]['content']['application/json'];
+type CreateSubscriptionContent = CreateSubscriptionResponse['content'];
+type CreateSubscriptionBody = NonNullable<paths['/subscriptions']['post']['requestBody']>['content']['application/json'];
+type GetSubscriptionResponse = paths['/subscriptions/{id}']['get']['responses'][200]['content']['application/json'];
+type GetSubscriptionContent = GetSubscriptionResponse['content'];
+type GetSubscriptionPathParams = paths['/subscriptions/{id}']['get']['parameters']['path'];
+type UpdateSubscriptionResponse = paths['/subscriptions/{id}']['put']['responses'][200]['content']['application/json'];
+type UpdateSubscriptionContent = UpdateSubscriptionResponse['content'];
+type UpdateSubscriptionPathParams = paths['/subscriptions/{id}']['put']['parameters']['path'];
+type UpdateSubscriptionBody = NonNullable<paths['/subscriptions/{id}']['put']['requestBody']>['content']['application/json'];
+
+/**
+ * Available API environments
+ */
+declare enum Environment {
+    /**
+     * Staging environment
+     */
+    Staging = "staging",
+    /**
+     * Production environment
+     */
+    Production = "production"
+}
+/**
+ * Base API client for Storefront API
+ */
+declare class StorefrontAPIClient {
+    protected client: ReturnType<typeof createClient<paths>>;
+    protected config: StorefrontSDKOptions;
+    private readonly baseUrl;
+    private initializationPromise;
+    /**
+     * Create a new StorefrontAPIClient
+     *
+     * @param config - Configuration for the API client
+     */
+    constructor(config: StorefrontSDKOptions);
+    /**
+     * Set up timeout middleware
+     */
+    private setupTimeoutMiddleware;
+    /**
+     * Constructs the base URL from the configuration
+     *
+     * @param config - The client configuration
+     * @returns The constructed base URL
+     */
+    private getBaseUrlFromConfig;
+    /**
+     * Get the base URL of the API
+     *
+     * @returns The base URL of the API
+     */
+    getBaseUrl(): string;
+    /**
+     * Get the authorization header value
+     * If using token storage, gets the current token from storage
+     * Otherwise returns the manual token
+     *
+     * @returns The Authorization header value or empty string if no token is set
+     */
+    getAuthorizationHeader(): Promise<string>;
+    /**
+     * Set authentication tokens
+     *
+     * @param accessToken - The access token (required)
+     * @param refreshToken - The refresh token (optional)
+     *
+     * Behavior:
+     * - If tokenStorage is provided: Stores tokens for automatic management
+     * - If tokenStorage is not provided: Only stores access token for manual management
+     */
+    setTokens(accessToken: string, refreshToken?: string): Promise<void>;
+    /**
+     * Clear all authentication tokens
+     *
+     * Behavior:
+     * - If tokenStorage is provided: Clears both access and refresh tokens from storage
+     * - If tokenStorage is not provided: Clears the manual access token
+     */
+    clearTokens(): Promise<void>;
+    /**
+     * Set the X-Api-Key header
+     *
+     * @param apiKey - The API key to set
+     */
+    setApiKey(apiKey: string): void;
+    /**
+     * Clear the X-Api-Key header
+     */
+    clearApiKey(): void;
+    /**
+     * Execute a request and handle the response
+     *
+     * @param apiCall - Function that executes the API request
+     * @returns Promise with the API response
+     */
+    protected executeRequest<T>(apiCall: () => Promise<{
+        data?: {
+            message?: string;
+            success?: boolean;
+            content?: T;
+        };
+        error?: ApiErrorResponse;
+        response: Response;
+    }>): Promise<ApiResult<T>>;
+    /**
+     * Initialize tokens in storage (private helper method)
+     */
+    private initializeTokens;
+    /**
+     * Merge default headers with method-level headers
+     * Method-level headers take precedence over default headers
+     *
+     * @param methodHeaders - Headers passed to the specific method call
+     * @returns Merged headers object with proper HTTP header names
+     */
+    protected mergeHeaders<T extends Record<string, any> = Record<string, any>>(methodHeaders?: T): T;
+}
+
+/**
+ * Client for interacting with catalog endpoints
+ */
+declare class CatalogClient extends StorefrontAPIClient {
+    /**
+     * List all products
+     *
+     * @param options - Optional query parameters
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with products and pagination info
+     */
+    listProducts(options?: ListProductsQuery, headers?: ListProductsHeaderParams): Promise<ApiResult<ListProductsContent>>;
+    /**
+     * List all skus
+     *
+     * @param options - Optional query parameters
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with skus and pagination info
+     */
+    listSkus(options?: ListSkusQuery, headers?: ListSkusHeaderParams): Promise<ApiResult<ListSkusContent>>;
+    /**
+     * Get details for a specific product
+     *
+     * @param pathParams - The path parameters (product ID or slug)
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with product details
+     */
+    getProductDetail(pathParams: GetProductDetailPathParams, headers?: GetProductDetailHeaderParams): Promise<ApiResult<GetProductDetailContent>>;
+    /**
+     * List variants for a specific product
+     *
+     * @param pathParams - The path parameters (product ID)
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with variants
+     */
+    listProductVariants(pathParams: ListProductVariantsPathParams, headers?: ListProductVariantsHeaderParams): Promise<ApiResult<ListProductVariantsContent>>;
+    /**
+     * Get details for a specific variant
+     *
+     * @param pathParams - The path parameters (product ID and variant ID)
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with variant details
+     */
+    getVariantDetail(pathParams: GetVariantDetailPathParams, headers?: GetVariantDetailHeaderParams): Promise<ApiResult<GetVariantDetailContent>>;
+    /**
+     * List all categories
+     *
+     * @param options - Optional query parameters
+     * @returns Promise with categories and pagination info
+     */
+    listCategories(options?: ListCategoriesQuery): Promise<ApiResult<ListCategoriesContent>>;
+    /**
+     * List reviews for a specific product
+     *
+     * @param pathParams - The path parameters (product ID)
+     * @param queryParams - Optional query parameters
+     * @returns Promise with reviews and pagination info
+     */
+    listProductReviews(pathParams: ListProductReviewsPathParams, queryParams?: ListProductReviewsQuery): Promise<ApiResult<ListProductReviewsContent>>;
+    /**
+     * Create a review for a specific product
+     *
+     * @param pathParams - The path parameters (product ID)
+     * @param formData - The review data
+     * @returns Promise that resolves when the review is created
+     */
+    createProductReview(pathParams: CreateProductReviewPathParams, formData: CreateProductReviewFormData): Promise<ApiResult<CreateProductReviewResponse>>;
+    /**
+     * Search for products
+     *
+     * @param searchData - The search parameters
+     * @returns Promise with search results, facet distribution, facet stats, and pagination
+     */
+    searchProducts(searchData: SearchProductsBody, headers?: SearchProductsHeaderParams): Promise<ApiResult<SearchProductsContent>>;
+    /**
+     * List cross-sell products
+     *
+     * @param options - Optional query parameters
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with cross-sell products
+     */
+    listCrossSellProducts(options?: ListCrosssellProductsQuery, headers?: ListCrosssellProductsHeaderParams): Promise<ApiResult<ListCrosssellProductsContent>>;
+    /**
+     * List up-sell products
+     *
+     * @param options - Optional query parameters
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with up-sell products
+     */
+    listUpSellProducts(options?: ListUpsellProductsQuery, headers?: ListUpsellProductsHeaderParams): Promise<ApiResult<ListUpsellProductsContent>>;
+    /**
+     * List similar products
+     *
+     * @param options - Optional query parameters
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with similar products
+     */
+    listSimilarProducts(options?: ListSimilarProductsQuery, headers?: ListSimilarProductsHeaderParams): Promise<ApiResult<ListSimilarProductsContent>>;
+}
+
+/**
+ * Client for interacting with cart endpoints
+ */
+declare class CartClient extends StorefrontAPIClient {
+    /**
+     * Create a new cart
+     *
+     * @param payload - Object containing the items to add to the cart
+     * @returns Promise with the created cart
+     */
+    createCart(payload: CreateCartBody): Promise<ApiResult<CreateCartContent>>;
+    /**
+     * Get cart details - either by ID or using the stored cart ID
+     *
+     * @param cartId - The ID of the cart
+     * @returns Promise with cart details
+     */
+    getCart(cartId: GetCartPathParams): Promise<ApiResult<GetCartContent>>;
+    /**
+     * Delete a cart - either by ID or using the stored cart ID
+     *
+     * @param cartId - The ID of the cart
+     * @returns Promise that resolves when the cart is deleted
+     */
+    deleteCart(cartId: DeleteCartPathParams): Promise<ApiResult<DeleteCartResponse>>;
+    /**
+     * Update cart items (add, update quantity, remove)
+     *
+     * @param cartId - The cart id
+     * @param body - The body of the request
+     * @returns Promise with updated cart
+     */
+    addDeleteCartItem(cartId: UpdateCartPathParams, body: UpdateCartBody): Promise<ApiResult<UpdateCartContent>>;
+    /**
+     * Get cart details by user ID
+     *
+     * @param userId - The ID of the user
+     * @returns Promise with cart details
+     */
+    getUserCart(userId: GetUserCartPathParams): Promise<ApiResult<GetUserCartContent>>;
+    /**
+     * Delete a cart by user ID
+     *
+     * @param userId - The ID of the user
+     * @returns Promise that resolves when the cart is deleted
+     */
+    deleteUserCart(userId: DeleteUserCartPathParams): Promise<ApiResult<DeleteUserCartResponse>>;
+    /**
+     * Update cart addresses
+     *
+     * @param cartId - The ID of the cart
+     * @param addressData - The address data
+     * @returns Promise with updated cart
+     */
+    updateCartAddress(cartId: CreateCartAddressPathParams, addressData: CreateCartAddressBody): Promise<ApiResult<CreateCartAddressContent>>;
+    /**
+     * Apply a coupon to the cart
+     *
+     * @param cartId - The ID of the cart
+     * @param couponCode - The coupon code
+     * @returns Promise with updated cart
+     */
+    applyCoupon(cartId: ApplyCouponPathParams, couponCode: ApplyCouponBody): Promise<ApiResult<ApplyCouponContent>>;
+    /**
+     * Remove a coupon from the cart
+     *
+     * @param cartId - The ID of the cart
+     * @returns Promise with updated cart
+     */
+    removeCoupon(cartId: RemoveCouponPathParams): Promise<ApiResult<RemoveCouponContent>>;
+    /**
+     * Redeem loyalty points
+     *
+     * @param cartId - The ID of the cart
+     * @param points - The number of points to redeem
+     * @returns Promise with updated cart
+     */
+    redeemLoyaltyPoints(cartId: RedeemLoyaltyPointsPathParams, points: RedeemLoyaltyPointsBody): Promise<ApiResult<RedeemLoyaltyPointsContent>>;
+    /**
+     * Remove loyalty points
+     *
+     * @param cartId - The ID of the cart
+     * @returns Promise with updated cart
+     */
+    removeLoyaltyPoints(cartId: RemoveLoyaltyPointsPathParams): Promise<ApiResult<RemoveLoyaltyPointsContent>>;
+    /**
+     * Update shipping method
+     *
+     * @param cartId - The ID of the cart
+     * @param body - The body of the request
+     * @returns Promise with updated cart
+     */
+    updateShippingMethod(cartId: UpdateShippingMethodPathParams, body: UpdateShippingMethodBody): Promise<ApiResult<UpdateShippingMethodContent>>;
+    /**
+     * Use credit balance
+     *
+     * @param cartId - The ID of the cart
+     * @param body - The body of the request
+     * @returns Promise with updated cart
+     */
+    redeemCreditBalance(cartId: RedeemCreditBalancePathParams, body: RedeemCreditBalanceBody): Promise<ApiResult<RedeemCreditBalanceContent>>;
+    /**
+     * Remove credit balance
+     *
+     * @param cartId - The ID of the cart
+     * @returns Promise with updated cart
+     */
+    removeCreditBalance(cartId: RemoveCreditBalancePathParams): Promise<ApiResult<RemoveCreditBalanceContent>>;
+    /**
+     * Redeem gift card
+     *
+     * @param cartId - The ID of the cart
+     * @param body - The body of the request
+     * @returns Promise with updated cart
+     */
+    redeemGiftCard(cartId: RedeemGiftCardPathParams, body: RedeemGiftCardBody): Promise<ApiResult<RedeemGiftCardContent>>;
+    /**
+     * Remove gift card
+     *
+     * @param cartId - The ID of the cart
+     * @returns Promise with updated cart
+     */
+    removeGiftCard(cartId: RemoveGiftCardPathParams): Promise<ApiResult<RemoveGiftCardContent>>;
+    /**
+     * Get wishlist items
+     *
+     * @param userId - The ID of the user
+     * @returns Promise with wishlist items
+     */
+    getWishlist(userId: GetWishlistPathParams): Promise<ApiResult<GetWishlistContent>>;
+    /**
+     * Add item to wishlist
+     *
+     * @param userId - The ID of the user
+     * @param itemId - The ID of the item
+     * @returns Promise with updated wishlist
+     */
+    addToWishlist(userId: AddToWishlistPathParams, itemId: AddToWishlistBody): Promise<ApiResult<AddToWishlistContent>>;
+    /**
+     * Remove item from wishlist
+     *
+     * @param userId - The ID of the user
+     * @param itemId - The ID of the item
+     * @returns Promise with updated wishlist
+     */
+    removeFromWishlist(userId: DeleteFromWishlistPathParams, body: DeleteFromWishlistBody): Promise<ApiResult<DeleteFromWishlistContent>>;
+    /**
+     * Get all available coupons
+     *
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with all available coupons
+     */
+    getAvailableCoupons(headers?: ListCouponsHeaderParams): Promise<ApiResult<ListCouponsContent>>;
+    /**
+     * Get all available promotions
+     *
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with all available promotions
+     */
+    getAvailablePromotions(headers?: ListPromotionsHeaderParams): Promise<ApiResult<ListPromotionsContent>>;
+}
+
+/**
+ * Client for interacting with authentication endpoints
+ */
+declare class AuthClient extends StorefrontAPIClient {
+    /**
+     * Get anonymous token for guest users
+     */
+    getAnonymousToken(): Promise<ApiResult<GetAnonymousTokenContent>>;
+    /**
+     * Login with phone number
+     *
+     * @param phoneNumber - Phone number (without country code)
+     * @param countryCode - Country code (defaults to +91)
+     * @param registerIfNotExists - Whether to register if user doesn't exist
+     * @returns Promise with OTP token and action
+     */
+    loginWithPhone(body: LoginWithPhoneBody): Promise<ApiResult<LoginWithPhoneContent>>;
+    /**
+     * Login with WhatsApp
+     *
+     * @param phoneNumber - Phone number (without country code)
+     * @param countryCode - Country code (defaults to +91)
+     * @param registerIfNotExists - Whether to register if user doesn't exist
+     * @returns Promise with OTP token and action
+     */
+    loginWithWhatsApp(body: LoginWithWhatsappBody): Promise<ApiResult<LoginWithWhatsappContent>>;
+    /**
+     * Login with email
+     *
+     * @param email - Email address
+     * @param registerIfNotExists - Whether to register if user doesn't exist
+     * @returns Promise with OTP token and action
+     */
+    loginWithEmail(body: LoginWithEmailBody): Promise<ApiResult<LoginWithEmailContent>>;
+    /**
+     * Login with password
+     *
+     * @param credentials - Login credentials
+     * @returns Promise with user info and tokens
+     */
+    loginWithPassword(body: LoginWithPasswordBody): Promise<ApiResult<LoginWithPasswordContent>>;
+    /**
+     * Forgot password
+     *
+     * @param email - Email address
+     * @returns Promise with user info and tokens
+     */
+    forgotPassword(body: ForgotPasswordBody): Promise<ApiResult<ForgotPasswordContent>>;
+    /**
+     * Reset password
+     *
+     * @param email - Email address
+     * @returns Promise with user info and tokens
+     */
+    resetPassword(body: ResetPasswordBody): Promise<ApiResult<ResetPasswordContent>>;
+    /**
+     * Change password
+     *
+     * @param oldPassword - Old password
+     * @param newPassword - New password
+     * @param newPasswordConfirmation - New password confirmation
+     * @returns Promise with new access token and refresh token
+     */
+    changePassword(body: ChangePasswordBody): Promise<ApiResult<ChangePasswordContent>>;
+    /**
+     * Verify OTP
+     *
+     * @param otp - One-time password
+     * @param otpToken - OTP token from login request
+     * @param otpAction - OTP action from login request
+     * @returns Promise with user info and tokens
+     */
+    verifyOtp(body: VerifyOtpBody): Promise<ApiResult<VerifyOtpContent>>;
+    /**
+     * Register with phone
+     *
+     * @param options - Registration details
+     * @returns Promise with user info and tokens
+     */
+    registerWithPhone(body: RegisterWithPhoneBody): Promise<ApiResult<RegisterWithPhoneContent>>;
+    /**
+     * Register with email
+     *
+     * @param options - Registration details
+     * @returns Promise with user info and tokens
+     */
+    registerWithEmail(body: RegisterWithEmailBody): Promise<ApiResult<RegisterWithEmailContent>>;
+    /**
+     * Refresh the access token using a refresh token
+     * @param refreshToken - The refresh token to use for refreshing the access token
+     * @returns Promise with the new access token and refresh token
+     */
+    refreshToken(body: RefreshTokenBody): Promise<ApiResult<RefreshTokenContent>>;
+    /**
+     * Logout
+     *
+     * @returns Promise that resolves when logout is complete
+     */
+    logout(): Promise<ApiResult<LogoutContent>>;
+    /**
+     * Get user details
+     *
+     * @param userId - User ID
+     * @returns Promise with user details
+     */
+    getUserDetails(pathParams: GetUserDetailPathParams): Promise<ApiResult<GetUserDetailContent>>;
+    /**
+     * Update user details
+     *
+     * @param userId - User ID
+     * @returns Promise with user details
+     */
+    updateUserDetails(pathParams: UpdateUserPathParams, body: UpdateUserBody): Promise<ApiResult<UpdateUserContent>>;
+    /**
+     * Add profile image
+     *
+     * @param userId - User ID
+     * @returns Promise with user details
+     */
+    addProfileImage(pathParams: AddProfileImagePathParams, formData: AddProfileImageFormData): Promise<ApiResult<AddProfileImageContent>>;
+    /**
+     * Update profile image
+     *
+     * @param userId - User ID
+     * @returns Promise with user details
+     */
+    updateProfileImage(pathParams: UpdateProfileImagePathParams, formData: UpdateProfileImageFormData): Promise<ApiResult<UpdateProfileImageContent>>;
+    /**
+     * Delete profile image
+     *
+     * @param userId - User ID
+     * @returns Promise with user details
+     */
+    deleteProfileImage(pathParams: RemoveProfileImagePathParams): Promise<ApiResult<RemoveProfileImageResponse>>;
+    /**
+     * Get profile image
+     *
+     * @param userId - User ID
+     * @returns Promise with user details
+     */
+    getProfileImage(pathParams: GetProfileImagePathParams): Promise<ApiResult<GetProfileImageContent>>;
+    /**
+     * Deactivate user account
+     *
+     * @param userId - User ID
+     * @returns Promise with user details
+     */
+    deactivateUserAccount(pathParams: DeactivateUserPathParams): Promise<ApiResult<DeactivateUserResponse>>;
+    /**
+     * Get user notification preferences
+     *
+     * @param userId - User ID
+     * @returns Promise with user details
+     */
+    getUserNotificationPreferences(pathParams: GetNotificationPreferencesPathParams): Promise<ApiResult<GetNotificationPreferencesContent>>;
+    /**
+     * Update user notification preferences
+     *
+     * @param userId - User ID
+     * @returns Promise with user details
+     */
+    updateUserNotificationPreferences(pathParams: UpdateNotificationPreferencesPathParams, body: UpdateNotificationPreferencesBody): Promise<ApiResult<UpdateNotificationPreferencesContent>>;
+    /**
+     * Create user notification preference
+     *
+     * @param userId - User ID
+     * @returns Promise with user details
+     */
+    createUserNotificationPreference(pathParams: CreateNotificationPreferencesPathParams, body: CreateNotificationPreferencesBody): Promise<ApiResult<CreateNotificationPreferencesContent>>;
+    /**
+     * Generate OTP
+     *
+     * @param body - OTP generation body
+     * @returns Promise with OTP generation response
+     */
+    generateOtp(body: GenerateOtpBody): Promise<ApiResult<GenerateOtpContent>>;
+    /**
+     * Check whether email or phone is already verified
+     *
+     * @param body - OTP generation body
+     * @returns Promise with OTP generation response
+     */
+    checkEmailOrPhoneIsVerified(body: CheckVerificationStatusBody): Promise<ApiResult<CheckVerificationStatusContent>>;
+}
+
+/**
+ * Client for interacting with order endpoints
+ */
+declare class OrderClient extends StorefrontAPIClient {
+    /**
+     * Get order details
+     *
+     * @param orderNumber - Order number
+     * @returns Promise with order details
+     */
+    getOrderDetails(pathParams: GetOrderDetailPathParams): Promise<ApiResult<GetOrderDetailContent>>;
+    /**
+     * Create order
+     *
+     * @param cartId - Cart ID
+     * @param paymentGateway - Payment gateway
+     * @param paymentGatewayParams - Params for the selected payment gateway
+     * @returns Promise with order details
+     */
+    createOrder(body: CreateOrderBody): Promise<ApiResult<CreateOrderContent>>;
+    /**
+     * List all orders
+     *
+     * @param queryParams - Query parameters
+     * @returns Promise with order details
+     */
+    listOrders(queryParams: ListOrdersQuery): Promise<ApiResult<ListOrdersContent>>;
+    /**
+     * Get payment status for an order
+     *
+     * @param orderNumber - Order number
+     * @returns Promise with payment status
+     */
+    getPaymentStatus(orderNumber: string): Promise<ApiResult<GetPaymentStatusContent>>;
+    /**
+     * Get all shipments for an order
+     *
+     * @param orderNumber - Order number
+     * @returns Promise with shipments
+     */
+    listOrderShipments(pathParams: ListOrderShipmentsPathParams): Promise<ApiResult<ListOrderShipmentsContent>>;
+    /**
+     * List order payments
+     *
+     * @param orderNumber - Order number
+     * @returns Promise with payments
+     */
+    listOrderPayments(pathParams: ListOrderPaymentsPathParams): Promise<ApiResult<ListOrderPaymentsContent>>;
+    /**
+     * List order refunds
+     *
+     * @param orderNumber - Order number
+     * @returns Promise with refunds
+     */
+    listOrderRefunds(pathParams: ListOrderRefundsPathParams): Promise<ApiResult<ListOrderRefundsContent>>;
+    /**
+     * Cancel an order
+     *
+     * @param orderNumber - Order number
+     * @returns Promise with order details
+     */
+    cancelOrder(pathParams: CancelOrderPathParams, body: CancelOrderBody): Promise<ApiResult<CancelOrderContent>>;
+    /**
+     * Retry payment for an order
+     *
+     * @param orderNumber - Order number
+     * @returns Promise with order details
+     */
+    retryOrderPayment(pathParams: RetryOrderPaymentPathParams, body: RetryOrderPaymentBody): Promise<ApiResult<RetryOrderPaymentContent>>;
+}
+
+/**
+ * Client for interacting with shipping endpoints
+ */
+declare class ShippingClient extends StorefrontAPIClient {
+    /**
+     * Get shipping options for an order
+     *
+     * @param body - Shipping methods body
+     * @returns Promise with shipping options
+     */
+    getShippingMethods(body: GetShippingMethodsBody): Promise<ApiResult<GetShippingMethodsContent>>;
+    /**
+     * Check pincode deliverability
+     *
+     * @param pathParams - Path parameters
+     * @returns Promise with pincode deliverability result
+     */
+    checkPincodeDeliverability(pathParams: CheckPincodeServiceabilityPathParams): Promise<ApiResult<CheckPincodeServiceabilityContent>>;
+}
+
+/**
+ * Client for interacting with helper endpoints
+ */
+declare class HelpersClient extends StorefrontAPIClient {
+    /**
+     * Get a list of countries
+     *
+     * @returns Promise with countries
+     */
+    listCountries(): Promise<ApiResult<ListCountriesContent>>;
+    /**
+     * - Get a list of states for a country
+     *
+     * @param pathParams - Path parameters
+     * @returns Promise with states
+     */
+    listCountryStates(pathParams: ListCountryStatesPathParams): Promise<ApiResult<ListCountryStatesContent>>;
+    /**
+     * Get pincodes for a country
+     *
+     * @param pathParams - Path parameters
+     * @returns Promise with pincodes
+     */
+    listCountryPincodes(pathParams: ListCountryPincodesPathParams): Promise<ApiResult<ListCountryPincodesContent>>;
+}
+
+/**
+ * Client for interacting with customer endpoints
+ */
+declare class CustomerClient extends StorefrontAPIClient {
+    /**
+     * Create a customer
+     *
+     * @param body - Customer creation body
+     * @returns Promise with customer details
+     */
+    createCustomer(body: CreateCustomerBody): Promise<ApiResult<CreateCustomerContent>>;
+    /**
+     * Get customer details
+     *
+     * @param pathParams - Path parameters
+     * @returns Promise with customer details
+     */
+    getCustomer(pathParams: GetCustomerDetailPathParams): Promise<ApiResult<GetCustomerDetailContent>>;
+    /**
+     * Update a customer
+     *
+     * @param pathParams - Path parameters
+     * @param body - Customer update body
+     * @returns Promise with customer details
+     */
+    updateCustomer(pathParams: UpdateCustomerPathParams, body: UpdateCustomerBody): Promise<ApiResult<UpdateCustomerContent>>;
+    /**
+     * Get all saved addresses for a customer
+     *
+     * @param pathParams - Path parameters
+     * @returns Promise with addresses
+     */
+    listAddresses(pathParams: ListAddressesPathParams): Promise<ApiResult<ListAddressesContent>>;
+    /**
+     * Create a new address for a customer
+     *
+     * @param pathParams - Path parameters
+     * @param body - Address creation body
+     * @returns Promise with address details
+     */
+    createAddress(pathParams: CreateAddressPathParams, body: CreateAddressBody): Promise<ApiResult<CreateAddressContent>>;
+    /**
+     * Get an address for a customer
+     *
+     * @param pathParams - Path parameters
+     * @returns Promise with address details
+     */
+    getAddress(pathParams: GetAddressDetailPathParams): Promise<ApiResult<GetAddressDetailContent>>;
+    /**
+     * Update an address for a customer
+     *
+     * @param pathParams - Path parameters
+     * @param body - Address update body
+     * @returns Promise with address details
+     */
+    updateAddress(pathParams: UpdateAddressDetailPathParams, body: UpdateAddressDetailBody): Promise<ApiResult<UpdateAddressDetailContent>>;
+    /**
+     * Delete an address for a customer
+     *
+     * @param pathParams - Path parameters
+     * @returns Promise with address details
+     */
+    deleteAddress(pathParams: DeleteAddressPathParams): Promise<ApiResult<DeleteAddressResponse>>;
+    /**
+     * Get customer loyalty details
+     *
+     * @param pathParams - Path parameters
+     * @returns Promise with loyalty details
+     */
+    getLoyaltyDetails(pathParams: GetLoyaltyDetailsPathParams): Promise<ApiResult<GetLoyaltyDetailsContent>>;
+    /**
+     * List all loyalty points activity for a customer
+     *
+     * @param pathParams - Path parameters
+     * @returns Promise with loyalty points activity
+     */
+    listLoyaltyPointsActivity(pathParams: ListLoyaltyActivitiesPathParams): Promise<ApiResult<ListLoyaltyActivitiesContent>>;
+    /**
+     * List all reviews left by a customer
+     *
+     * @param pathParams - Path parameters
+     * @returns Promise with reviews
+     */
+    listCustomerReviews(pathParams: ListUserReviewsPathParams): Promise<ApiResult<ListUserReviewsContent>>;
+}
+
+/**
+ * Token storage interface for the auth middleware
+ */
+interface TokenStorage {
+    getAccessToken(): Promise<string | null>;
+    setAccessToken(token: string): Promise<void>;
+    getRefreshToken(): Promise<string | null>;
+    setRefreshToken(token: string): Promise<void>;
+    clearTokens(): Promise<void>;
+}
+/**
+ * Simple in-memory token storage implementation
+ */
+declare class MemoryTokenStorage implements TokenStorage {
+    private accessToken;
+    private refreshToken;
+    getAccessToken(): Promise<string | null>;
+    setAccessToken(token: string): Promise<void>;
+    getRefreshToken(): Promise<string | null>;
+    setRefreshToken(token: string): Promise<void>;
+    clearTokens(): Promise<void>;
+}
+/**
+ * Browser localStorage token storage implementation
+ */
+declare class BrowserTokenStorage implements TokenStorage {
+    private accessTokenKey;
+    private refreshTokenKey;
+    constructor(prefix?: string);
+    getAccessToken(): Promise<string | null>;
+    setAccessToken(token: string): Promise<void>;
+    getRefreshToken(): Promise<string | null>;
+    setRefreshToken(token: string): Promise<void>;
+    clearTokens(): Promise<void>;
+}
+/**
+ * Cookie-based token storage implementation
+ */
+declare class CookieTokenStorage implements TokenStorage {
+    private accessTokenKey;
+    private refreshTokenKey;
+    private options;
+    constructor(options?: CookieTokenStorageOptions);
+    getAccessToken(): Promise<string | null>;
+    setAccessToken(token: string): Promise<void>;
+    getRefreshToken(): Promise<string | null>;
+    setRefreshToken(token: string): Promise<void>;
+    clearTokens(): Promise<void>;
+    private getCookie;
+    private setCookie;
+    private deleteCookie;
+}
+/**
+ * Configuration options for CookieTokenStorage
+ */
+interface CookieTokenStorageOptions {
+    /**
+     * Prefix for cookie names (default: "storefront_")
+     */
+    prefix?: string;
+    /**
+     * Maximum age of cookies in seconds (default: 7 days)
+     */
+    maxAge?: number;
+    /**
+     * Cookie path (default: "/")
+     */
+    path?: string;
+    /**
+     * Cookie domain (default: current domain)
+     */
+    domain?: string;
+    /**
+     * Whether cookies should be secure (default: auto-detect based on protocol)
+     */
+    secure?: boolean;
+    /**
+     * SameSite cookie attribute (default: "Lax")
+     */
+    sameSite?: "Strict" | "Lax" | "None";
+}
+
+/**
+ * User information extracted from JWT token
+ */
+interface UserInfo {
+    id: string;
+    email: string | null;
+    phone: string | null;
+    username: string;
+    firstName: string | null;
+    lastName: string | null;
+    storeId: string;
+    isLoggedIn: boolean;
+    isAnonymous: boolean;
+    customerId: string | null;
+    customerGroupId: string | null;
+    anonymousId: string;
+    tokenExpiry: Date;
+    tokenIssuedAt: Date;
+}
+
+/**
+ * Debug logger function interface
+ */
+interface DebugLoggerFn {
+    (level: "info" | "warn" | "error", message: string, data?: any): void;
+}
+/**
+ * Response utilities for debugging and working with Response objects
+ */
+declare class ResponseUtils {
+    /**
+     * Get response headers as a plain object
+     */
+    static getHeaders(response: Response): Record<string, string>;
+    /**
+     * Get specific header value
+     */
+    static getHeader(response: Response, name: string): string | null;
+    /**
+     * Check if response was successful
+     */
+    static isSuccess(response: Response): boolean;
+    /**
+     * Get response metadata
+     */
+    static getMetadata(response: Response): {
+        status: number;
+        statusText: string;
+        ok: boolean;
+        url: string;
+        redirected: boolean;
+        type: ResponseType;
+        headers: {
+            [k: string]: string;
+        };
+    };
+    /**
+     * Clone and read response as text (useful for debugging)
+     * Note: This can only be called once per response
+     */
+    static getText(response: Response): Promise<string>;
+    /**
+     * Clone and read response as JSON (useful for debugging)
+     * Note: This can only be called once per response
+     */
+    static getJSON(response: Response): Promise<any>;
+    /**
+     * Format response information for debugging
+     */
+    static format(response: Response): string;
+}
+
+/**
+ * Supported default headers that can be set at the SDK level
+ * Only includes headers that are actually supported by API endpoints
+ */
+interface SupportedDefaultHeaders {
+    /**
+     * Customer group ID used for pricing, promotions, and subscription rates
+     * If not provided, the API will use default pricing
+     */
+    customer_group_id?: string;
+}
+/**
+ * SDK initialization options
+ */
+interface StorefrontSDKOptions {
+    /**
+     * Store ID for the API requests
+     */
+    storeId: string;
+    /**
+     * Environment to use (defaults to Production)
+     */
+    environment?: Environment;
+    /**
+     * Custom base URL (overrides environment if provided)
+     */
+    baseUrl?: string;
+    /**
+     * Optional initial access token
+     * - If tokenStorage is provided: Used as initial token value, then managed automatically
+     * - If tokenStorage is not provided: Used for manual token management
+     */
+    accessToken?: string;
+    /**
+     * Optional initial refresh token
+     * - Only used when tokenStorage is provided
+     * - Allows initialization with both access and refresh tokens
+     */
+    refreshToken?: string;
+    /**
+     * X-Api-Key for anonymous authentication endpoints
+     * Required for initial authentication
+     */
+    apiKey?: string;
+    /**
+     * Optional timeout in milliseconds
+     */
+    timeout?: number;
+    /**
+     * Optional token storage for automatic token management
+     * If provided, enables automatic token refresh and management
+     */
+    tokenStorage?: TokenStorage;
+    /**
+     * Callback when tokens are updated (login/refresh)
+     */
+    onTokensUpdated?: (accessToken: string, refreshToken: string) => void;
+    /**
+     * Callback when tokens are cleared (logout/error)
+     */
+    onTokensCleared?: () => void;
+    /**
+     * Default headers to include with API requests
+     * These can be overridden at the method level
+     * Only supports headers that are actually available in the API
+     */
+    defaultHeaders?: SupportedDefaultHeaders;
+    /**
+     * Enable debug mode for detailed request/response logging
+     * When enabled, detailed debug information will be logged via the logger
+     * Note: Response objects are always included in ApiResult regardless of debug mode
+     */
+    debug?: boolean;
+    /**
+     * Custom logger function for debug information
+     * If not provided and debug is enabled, will use console.log
+     */
+    logger?: DebugLoggerFn;
+}
+/**
+ * Main SDK class for the Storefront API
+ */
+declare class StorefrontSDK {
+    /**
+     * Client for catalog-related endpoints (products, categories, etc.)
+     */
+    readonly catalog: CatalogClient;
+    /**
+     * Client for cart-related endpoints
+     */
+    readonly cart: CartClient;
+    /**
+     * Client for authentication-related endpoints
+     */
+    readonly auth: AuthClient;
+    /**
+     * Client for customer-related endpoints
+     */
+    readonly customer: CustomerClient;
+    /**
+     * Client for helper-related endpoints
+     */
+    readonly helpers: HelpersClient;
+    /**
+     * Client for shipping-related endpoints
+     */
+    readonly shipping: ShippingClient;
+    /**
+     * Client for order-related endpoints
+     */
+    readonly order: OrderClient;
+    /**
+     * Create a new StorefrontSDK instance
+     *
+     * @param options - Configuration options for the SDK
+     */
+    constructor(options: StorefrontSDKOptions);
+    /**
+     * Set authentication tokens for all clients
+     *
+     * @param accessToken - The access token (required)
+     * @param refreshToken - The refresh token (optional)
+     *
+     * Behavior:
+     * - If tokenStorage is provided: Stores tokens for automatic management
+     * - If tokenStorage is not provided: Only stores access token for manual management
+     */
+    setTokens(accessToken: string, refreshToken?: string): Promise<void>;
+    /**
+     * Clear all authentication tokens from all clients
+     *
+     * Behavior:
+     * - If tokenStorage is provided: Clears both access and refresh tokens from storage
+     * - If tokenStorage is not provided: Clears the manual access token
+     */
+    clearTokens(): Promise<void>;
+    /**
+     * Set the API key for all clients
+     *
+     * @param apiKey - The API key to set
+     */
+    setApiKey(apiKey: string): void;
+    /**
+     * Clear the API key from all clients
+     */
+    clearApiKey(): void;
+    /**
+     * Get the current access token if using token storage
+     */
+    getAccessToken(): Promise<string | null>;
+    /**
+     * Get user information from the current access token
+     *
+     * @returns User information extracted from JWT token, or null if no token or invalid token
+     */
+    getUserInfo(): Promise<UserInfo | null>;
+    /**
+     * Get the current user ID from the access token
+     *
+     * @returns User ID (ulid) or null if no token or invalid token
+     */
+    getUserId(): Promise<string | null>;
+    /**
+     * Check if the current user is logged in (not anonymous)
+     *
+     * @returns True if user is logged in, false if anonymous or no token
+     */
+    isLoggedIn(): Promise<boolean>;
+    /**
+     * Check if the current user is anonymous
+     *
+     * @returns True if user is anonymous or no token, false if logged in
+     */
+    isAnonymous(): Promise<boolean>;
+    /**
+     * Get the customer ID from the current access token
+     *
+     * @returns Customer ID or null if no token, invalid token, or user has no customer ID
+     */
+    getCustomerId(): Promise<string | null>;
+    /**
+     * Get the customer group ID from the current access token
+     *
+     * @returns Customer group ID or null if no token, invalid token, or user has no customer group
+     */
+    getCustomerGroupId(): Promise<string | null>;
+    /**
+     * Set default headers for all clients
+     *
+     * @param headers - Default headers to set (only supported headers allowed)
+     */
+    setDefaultHeaders(headers: SupportedDefaultHeaders): void;
+    /**
+     * Get current default headers
+     *
+     * @returns Current default headers
+     */
+    getDefaultHeaders(): SupportedDefaultHeaders | undefined;
+}
+
+export { type AddCardBody, type AddCardContent, type AddCardResponse, type AddProfileImageContent, type AddProfileImageFormData, type AddProfileImagePathParams, type AddProfileImageResponse, type AddToWishlistBody, type AddToWishlistContent, type AddToWishlistPathParams, type AddToWishlistResponse, type ApiErrorResponse, type ApiResult, type ApplyCouponBody, type ApplyCouponContent, type ApplyCouponPathParams, type ApplyCouponResponse, AuthClient, BrowserTokenStorage, type CancelOrderBody, type CancelOrderContent, type CancelOrderPathParams, type CancelOrderResponse, CartClient, CatalogClient, type ChangePasswordBody, type ChangePasswordContent, type ChangePasswordResponse, type CheckPincodeServiceabilityContent, type CheckPincodeServiceabilityPathParams, type CheckPincodeServiceabilityResponse, type CheckVerificationStatusBody, type CheckVerificationStatusContent, type CheckVerificationStatusResponse, CookieTokenStorage, type CookieTokenStorageOptions, type CreateAddressBody, type CreateAddressContent, type CreateAddressPathParams, type CreateAddressResponse, type CreateCartAddressBody, type CreateCartAddressContent, type CreateCartAddressPathParams, type CreateCartAddressResponse, type CreateCartBody, type CreateCartContent, type CreateCartResponse, type CreateCustomerBody, type CreateCustomerContent, type CreateCustomerResponse, type CreateDocumentContent, type CreateDocumentFormData, type CreateDocumentPathParams, type CreateDocumentResponse, type CreateJuspayCustomerBody, type CreateJuspayCustomerContent, type CreateJuspayCustomerResponse, type CreateJuspayOrderBody, type CreateJuspayOrderContent, type CreateJuspayOrderResponse, type CreateNotificationPreferencesBody, type CreateNotificationPreferencesContent, type CreateNotificationPreferencesPathParams, type CreateNotificationPreferencesResponse, type CreateOrderBody, type CreateOrderContent, type CreateOrderResponse, type CreateOrderReturnBody, type CreateOrderReturnContent, type CreateOrderReturnPathParams, type CreateOrderReturnResponse, type CreateProductReviewFormData, type CreateProductReviewPathParams, type CreateProductReviewResponse, type CreateSubscriptionBody, type CreateSubscriptionContent, type CreateSubscriptionResponse, CustomerClient, type DeactivateUserPathParams, type DeactivateUserResponse, type DebugLoggerFn, type DeleteAddressPathParams, type DeleteAddressResponse, type DeleteCartPathParams, type DeleteCartResponse, type DeleteDocumentPathParams, type DeleteDocumentResponse, type DeleteFromWishlistBody, type DeleteFromWishlistContent, type DeleteFromWishlistPathParams, type DeleteFromWishlistResponse, type DeleteUserCartPathParams, type DeleteUserCartResponse, Environment, type ForgotPasswordBody, type ForgotPasswordContent, type ForgotPasswordResponse, type GenerateHashBody, type GenerateHashContent, type GenerateHashResponse, type GenerateOtpBody, type GenerateOtpContent, type GenerateOtpResponse, type GetAddressDetailContent, type GetAddressDetailPathParams, type GetAddressDetailResponse, type GetAnonymousTokenContent, type GetAnonymousTokenResponse, type GetCartContent, type GetCartPathParams, type GetCartResponse, type GetConfigContent, type GetConfigResponse, type GetCustomerDetailContent, type GetCustomerDetailPathParams, type GetCustomerDetailResponse, type GetDocumentContent, type GetDocumentPathParams, type GetDocumentResponse, type GetJuspayCustomerContent, type GetJuspayCustomerPathParams, type GetJuspayCustomerResponse, type GetLoyaltyDetailsContent, type GetLoyaltyDetailsPathParams, type GetLoyaltyDetailsResponse, type GetNotificationPreferencesContent, type GetNotificationPreferencesPathParams, type GetNotificationPreferencesResponse, type GetOrderDetailContent, type GetOrderDetailPathParams, type GetOrderDetailResponse, type GetOrderReturnDetailContent, type GetOrderReturnDetailPathParams, type GetOrderReturnDetailResponse, type GetPaymentStatusContent, type GetPaymentStatusPathParams, type GetPaymentStatusResponse, type GetProductDetailContent, type GetProductDetailHeaderParams, type GetProductDetailPathParams, type GetProductDetailResponse, type GetProfileImageContent, type GetProfileImagePathParams, type GetProfileImageResponse, type GetShippingMethodsBody, type GetShippingMethodsContent, type GetShippingMethodsResponse, type GetSubscriptionContent, type GetSubscriptionPathParams, type GetSubscriptionResponse, type GetUserCartContent, type GetUserCartPathParams, type GetUserCartResponse, type GetUserDetailContent, type GetUserDetailPathParams, type GetUserDetailResponse, type GetVariantDetailContent, type GetVariantDetailHeaderParams, type GetVariantDetailPathParams, type GetVariantDetailResponse, type GetWishlistContent, type GetWishlistPathParams, type GetWishlistResponse, HelpersClient, type ListAddressesContent, type ListAddressesPathParams, type ListAddressesQuery, type ListAddressesResponse, type ListCategoriesContent, type ListCategoriesQuery, type ListCategoriesResponse, type ListCountriesContent, type ListCountriesResponse, type ListCountryPincodesContent, type ListCountryPincodesPathParams, type ListCountryPincodesQuery, type ListCountryPincodesResponse, type ListCountryStatesContent, type ListCountryStatesPathParams, type ListCountryStatesResponse, type ListCouponsContent, type ListCouponsHeaderParams, type ListCouponsResponse, type ListCrosssellProductsContent, type ListCrosssellProductsHeaderParams, type ListCrosssellProductsQuery, type ListCrosssellProductsResponse, type ListDocumentsContent, type ListDocumentsPathParams, type ListDocumentsResponse, type ListKycDocumentContent, type ListKycDocumentResponse, type ListLoyaltyActivitiesContent, type ListLoyaltyActivitiesPathParams, type ListLoyaltyActivitiesQuery, type ListLoyaltyActivitiesResponse, type ListOrderPaymentsContent, type ListOrderPaymentsPathParams, type ListOrderPaymentsResponse, type ListOrderRefundsContent, type ListOrderRefundsPathParams, type ListOrderRefundsResponse, type ListOrderShipmentsContent, type ListOrderShipmentsPathParams, type ListOrderShipmentsResponse, type ListOrdersContent, type ListOrdersQuery, type ListOrdersResponse, type ListPaymentMethodsContent, type ListPaymentMethodsQuery, type ListPaymentMethodsResponse, type ListProductReviewsContent, type ListProductReviewsPathParams, type ListProductReviewsQuery, type ListProductReviewsResponse, type ListProductVariantsContent, type ListProductVariantsHeaderParams, type ListProductVariantsPathParams, type ListProductVariantsResponse, type ListProductsContent, type ListProductsHeaderParams, type ListProductsQuery, type ListProductsResponse, type ListPromotionsContent, type ListPromotionsHeaderParams, type ListPromotionsResponse, type ListReturnsContent, type ListReturnsResponse, type ListSavedCardsContent, type ListSavedCardsQuery, type ListSavedCardsResponse, type ListSimilarProductsContent, type ListSimilarProductsHeaderParams, type ListSimilarProductsQuery, type ListSimilarProductsResponse, type ListSkusContent, type ListSkusHeaderParams, type ListSkusQuery, type ListSkusResponse, type ListSubscriptionsContent, type ListSubscriptionsResponse, type ListUpsellProductsContent, type ListUpsellProductsHeaderParams, type ListUpsellProductsQuery, type ListUpsellProductsResponse, type ListUserReviewsContent, type ListUserReviewsPathParams, type ListUserReviewsResponse, type LoginWithEmailBody, type LoginWithEmailContent, type LoginWithEmailResponse, type LoginWithPasswordBody, type LoginWithPasswordContent, type LoginWithPasswordResponse, type LoginWithPhoneBody, type LoginWithPhoneContent, type LoginWithPhoneResponse, type LoginWithWhatsappBody, type LoginWithWhatsappContent, type LoginWithWhatsappResponse, type LogoutContent, type LogoutResponse, MemoryTokenStorage, OrderClient, type RedeemCreditBalanceBody, type RedeemCreditBalanceContent, type RedeemCreditBalancePathParams, type RedeemCreditBalanceResponse, type RedeemGiftCardBody, type RedeemGiftCardContent, type RedeemGiftCardPathParams, type RedeemGiftCardResponse, type RedeemLoyaltyPointsBody, type RedeemLoyaltyPointsContent, type RedeemLoyaltyPointsPathParams, type RedeemLoyaltyPointsResponse, type RefreshTokenBody, type RefreshTokenContent, type RefreshTokenResponse, type RegisterWithEmailBody, type RegisterWithEmailContent, type RegisterWithEmailResponse, type RegisterWithPasswordBody, type RegisterWithPasswordContent, type RegisterWithPasswordResponse, type RegisterWithPhoneBody, type RegisterWithPhoneContent, type RegisterWithPhoneResponse, type RegisterWithWhatsappBody, type RegisterWithWhatsappContent, type RegisterWithWhatsappResponse, type RemoveCouponContent, type RemoveCouponPathParams, type RemoveCouponResponse, type RemoveCreditBalanceContent, type RemoveCreditBalancePathParams, type RemoveCreditBalanceResponse, type RemoveGiftCardContent, type RemoveGiftCardPathParams, type RemoveGiftCardResponse, type RemoveLoyaltyPointsContent, type RemoveLoyaltyPointsPathParams, type RemoveLoyaltyPointsResponse, type RemoveProfileImagePathParams, type RemoveProfileImageResponse, type ResetPasswordBody, type ResetPasswordContent, type ResetPasswordResponse, ResponseUtils, type RetryOrderPaymentBody, type RetryOrderPaymentContent, type RetryOrderPaymentPathParams, type RetryOrderPaymentResponse, type SearchProductsBody, type SearchProductsContent, type SearchProductsHeaderParams, type SearchProductsResponse, ShippingClient, StorefrontAPIClient, StorefrontSDK, type StorefrontSDKOptions, type SubscribeNewsletterBody, type SubscribeNewsletterResponse, type SupportedDefaultHeaders, type TokenStorage, type TrackAnalyticsEventBody, type TrackAnalyticsEventResponse, type UpdateAddressDetailBody, type UpdateAddressDetailContent, type UpdateAddressDetailPathParams, type UpdateAddressDetailResponse, type UpdateCartBody, type UpdateCartContent, type UpdateCartPathParams, type UpdateCartResponse, type UpdateCustomerBody, type UpdateCustomerContent, type UpdateCustomerPathParams, type UpdateCustomerResponse, type UpdateDocumentContent, type UpdateDocumentFormData, type UpdateDocumentPathParams, type UpdateDocumentResponse, type UpdateNotificationPreferencesBody, type UpdateNotificationPreferencesContent, type UpdateNotificationPreferencesPathParams, type UpdateNotificationPreferencesResponse, type UpdateProfileImageContent, type UpdateProfileImageFormData, type UpdateProfileImagePathParams, type UpdateProfileImageResponse, type UpdateShippingMethodBody, type UpdateShippingMethodContent, type UpdateShippingMethodPathParams, type UpdateShippingMethodResponse, type UpdateSubscriptionBody, type UpdateSubscriptionContent, type UpdateSubscriptionPathParams, type UpdateSubscriptionResponse, type UpdateUserBody, type UpdateUserContent, type UpdateUserPathParams, type UpdateUserResponse, type UserInfo, type VerifyDocumentBody, type VerifyDocumentContent, type VerifyDocumentPathParams, type VerifyDocumentResponse, type VerifyOtpBody, type VerifyOtpContent, type VerifyOtpResponse, type VerifyVpaContent, type VerifyVpaQuery, type VerifyVpaResponse, type components, StorefrontSDK as default, type operations, type paths };