@hhgtech/hhg-components 1.19.0-beta-5 → 1.19.0-beta-7

package/src/ecom/dataFormatter/index.ts

@@ -0,0 +1,933 @@
+import { theme } from 'src/misc/theme'
+
+import {
+  AutoCompleteAddressApi,
+  CategoryApi,
+  HelpfulUrlApi,
+  HotSearchKeywordApi,
+  NavigationApi,
+  FooterInfoApi,
+  PriceInfoApi,
+  BlogPostApi,
+  BannerApi,
+  BlogPostDataReviewedUserApi,
+  BrandApi,
+  HomePageApi,
+  ProductApi,
+  CategoryPageApi,
+  PaginationApi,
+  BrandPageApi,
+  ProductDetailPageApi,
+  ProductReviewApi,
+  PromotionApi,
+  AddressApi,
+  OrderApi,
+  ProvinceApi,
+  DistrictApi,
+  CommuneApi,
+  ProvinceListApi,
+  DistrictListApi,
+  CommuneListApi,
+  CustomAttributesApi,
+  StatisticApi,
+  CartItemApi,
+  CartAddressApi,
+  CartLoggedInCustomerApi,
+  CartApi,
+  CartTotalApi,
+  EstimatedShippingApi,
+  OrderConfirmationApi,
+  ProductPromotionApi,
+  CouponListApi,
+  CouponApi,
+  ShippingApi,
+  PaymentMethodsApi,
+  ShippingInformation,
+} from './lib/apiTypes'
+import {
+  Address,
+  AutoCompleteAddress,
+  Banner,
+  BlogPost,
+  BlogPostDataReviewedUser,
+  Brand,
+  BrandPage,
+  Category,
+  CategoryPage,
+  HelpfulUrl,
+  HomePage,
+  Navigation,
+  Pagination,
+  PopularSearchType,
+  PriceInfo,
+  Product,
+  ProductDetailPage,
+  ProductReview,
+  Promotion,
+  Order,
+  Province,
+  District,
+  Commune,
+  Statistic,
+  CartItem,
+  CartAddress,
+  EstimatedShipping,
+  CartLoggedInCustomer,
+  Cart,
+  CartTotal,
+  PaymentInformation,
+  OrderConfirmation,
+  ProductPromotion,
+  Coupon,
+  Shipping,
+  PaymentMethodInfo,
+} from './lib/dataTypes'
+import { isDefined } from './lib/utils'
+
+export const dataFormatter = {
+  formatAutoCompleteAddress: (
+    address: AutoCompleteAddressApi,
+  ): AutoCompleteAddress | null => {
+    if (!address || !address.place_id) return null
+    return {
+      placeId: address.place_id,
+      description: address.description || '',
+    }
+  },
+  formatPrice: (price: string | number, locale?: string) => {
+    const formattedPrice = typeof price === 'string' ? parseInt(price) : price
+
+    return new Intl.NumberFormat(locale || 'vi-VN').format(formattedPrice)
+  },
+  formatHotSearchKeyword: (data: HotSearchKeywordApi): PopularSearchType => {
+    return {
+      text: data?.name || '',
+    }
+  },
+  formatHelpfulUrl: (data: HelpfulUrlApi): HelpfulUrl => {
+    return {
+      name: data?.name || '',
+      featuredImage: data?.featured_image || '',
+      url: data?.url || '',
+    }
+  },
+  formatCategory: function (
+    data: CategoryApi,
+    parentId?: number,
+    parentFullSlug?: string,
+  ): Category {
+    const currentFullSlug = parentFullSlug
+      ? parentFullSlug + '/' + data.slug
+      : data.slug
+    const children =
+      data?.children?.map?.((childCategory) => {
+        return dataFormatter.formatCategory(
+          childCategory,
+          data.id,
+          currentFullSlug,
+        )
+      }) || []
+    return {
+      id: data?.id,
+      name: data?.name || '',
+      logo: data?.logo || '',
+      slug: data?.slug || '',
+      fullSlug: currentFullSlug || '',
+      children,
+      backgroundColor: data.color || theme.colors.teal50,
+      parentId: parentId || 0,
+      products:
+        (data.products?.map(dataFormatter.formatProduct) as Product[]) || [],
+    }
+  },
+  formatFooterInfo: (data: FooterInfoApi | undefined): FooterInfoApi => {
+    const branches: { flag: string; name: string; url: string }[] =
+      data?.branch?.branch?.map?.((branch) => {
+        return {
+          flag: branch.flag || '',
+          name: branch.name || '',
+          url: branch.url || '',
+        }
+      }) || []
+
+    const verified: {
+      image: string
+      url: string
+    }[] =
+      data?.general?.verified?.map?.((verifiedItem) => {
+        return {
+          image: verifiedItem.image || '',
+          url: verifiedItem.url || '',
+        }
+      }) || []
+
+    const menu: {
+      menu_title: string
+      items: {
+        title: string
+        url: string
+      }[]
+    }[] =
+      data?.menu?.map?.((menuItem) => {
+        return {
+          menu_title: menuItem.menu_title,
+          items: menuItem.items?.map?.((item) => {
+            return {
+              title: item.title,
+              url: item.url,
+            }
+          }),
+        }
+      }) || []
+
+    const socials: {
+      icon: string
+      name: string
+      url: string
+    }[] =
+      data?.social?.socials?.map?.((social) => {
+        return {
+          icon: social.icon || '',
+          name: social.name || '',
+          url: social.url || '',
+        }
+      }) || []
+
+    return {
+      branch: {
+        title: data?.branch?.title || '',
+        branch: branches,
+      },
+      general: {
+        logo: data?.general?.logo ?? '',
+        content: data?.general?.content ?? '',
+        copyright: data?.general?.copyright ?? '',
+        verified,
+      },
+      menu,
+      social: {
+        title: data?.social?.title || '',
+        socials,
+      },
+    }
+  },
+  formatNavigation: function (
+    data: NavigationApi | null | undefined,
+  ): Navigation {
+    return {
+      hotSearchKeywords:
+        data?.hot_search_keywords?.map?.(
+          dataFormatter.formatHotSearchKeyword,
+        ) || [],
+      helpfulUrls:
+        data?.helpful_urls?.map?.(dataFormatter.formatHelpfulUrl) || [],
+      categories:
+        data?.categories?.map?.((category) =>
+          dataFormatter.formatCategory(category),
+        ) || [],
+      footer: dataFormatter.formatFooterInfo(data?.footer),
+      storeId: data?.store_id || 0,
+      customerId: data?.customer_id || 0,
+      cartItemsQty:
+        typeof data?.cart_items_qty === 'number' ? data.cart_items_qty : null,
+    }
+  },
+
+  // === ECOM TYPES FORMAT ===
+  formatPriceInfo: (priceInfoApi?: PriceInfoApi): PriceInfo | null => {
+    if (!priceInfoApi) return null
+    return {
+      final: priceInfoApi.final || 0,
+      regular: priceInfoApi.regular || 0,
+      discountPercent: priceInfoApi.discount_percent || 0,
+    }
+  },
+  formatProduct: function (productApi?: ProductApi): Product | null {
+    if (!productApi) return null
+    const defaultPriceInfo = {
+      final: 0,
+      regular: 0,
+      discountPercent: 0,
+    }
+    return {
+      id: productApi.id || 0,
+      price: productApi.price
+        ? dataFormatter.formatPriceInfo(productApi.price) || defaultPriceInfo
+        : defaultPriceInfo,
+      thumbnail: productApi.thumbnail || '',
+      name: productApi.name || '',
+      averageRating: Number((productApi.average_rating || 0).toFixed(2)),
+      reviewsCount: productApi.reviews_count || 0,
+      tag: productApi.tag || null,
+      sku: productApi.sku || '',
+      slug: productApi.slug || '',
+      images: productApi.images || [],
+      tags: productApi.tags || [],
+      unit: productApi.unit || '',
+      brand: productApi.brand
+        ? {
+            name: productApi.brand.name || '',
+            image: productApi.brand.image || '',
+            slug: productApi.brand.slug || '',
+            productsCount: productApi.brand.products_count || 0,
+          }
+        : null,
+      description: productApi.description || '',
+      productPromotions:
+        productApi.product_promotions
+          ?.map?.(dataFormatter.formatProductPromotion)
+          .filter(isDefined) || [],
+      categories:
+        productApi.categories
+          ?.map?.((c) => dataFormatter.formatCategory(c))
+          .filter(isDefined) || [],
+      isInStock: productApi?.is_in_stock || false,
+    }
+  },
+  formatBanner: (bannerApi?: BannerApi): Banner | null => {
+    if (!bannerApi) return null
+    return {
+      name: bannerApi.name || '',
+      url: bannerApi.url || '',
+      featuredImage: bannerApi.featured_image || '',
+      alt: bannerApi.image_alt,
+    }
+  },
+  formatBlogPost: (blogPostApi?: BlogPostApi): BlogPost | null => {
+    if (!blogPostApi) return null
+    return {
+      title: blogPostApi.title || '',
+      image: blogPostApi.image || '',
+      link: blogPostApi.link || '',
+      postData: blogPostApi.post_data
+        ? {
+            reviewed: blogPostApi.post_data.reviewed
+              ? {
+                  author: dataFormatter.formatBlogPostDataReviewedUser(
+                    blogPostApi.post_data.reviewed.author || undefined,
+                  ),
+                  editor: dataFormatter.formatBlogPostDataReviewedUser(
+                    blogPostApi.post_data.reviewed.editor || undefined,
+                  ),
+                  expert: dataFormatter.formatBlogPostDataReviewedUser(
+                    blogPostApi.post_data.reviewed.expert || undefined,
+                  ),
+                  factCheck: dataFormatter.formatBlogPostDataReviewedUser(
+                    blogPostApi.post_data.reviewed.fact_check || undefined,
+                  ),
+                  isAuthor: Boolean(blogPostApi.post_data.reviewed.is_author),
+                }
+              : null,
+            categories: blogPostApi.post_data.categories
+              ? blogPostApi.post_data.categories.map?.((item) => ({
+                  termId: item.term_id || 0,
+                  name: item.name || '',
+                  permalink: item.permalink || '',
+                  textColor: item.text_color || '',
+                }))
+              : [],
+            postDate: blogPostApi.post_data.post_date || '',
+            postModified: blogPostApi.post_data.post_modified || '',
+            modifiedTime: blogPostApi.post_data.modified_time || '',
+          }
+        : null,
+    }
+  },
+  formatBlogPostDataReviewedUser: (
+    blogPostDataReviewedUserApi?: BlogPostDataReviewedUserApi,
+  ): BlogPostDataReviewedUser | null => {
+    if (!blogPostDataReviewedUserApi) return null
+    return {
+      id: blogPostDataReviewedUserApi.ID || 0,
+      userId: blogPostDataReviewedUserApi.user_id || 0,
+      formerRole: blogPostDataReviewedUserApi.former_role || '',
+      role: blogPostDataReviewedUserApi.role || '',
+      slug: blogPostDataReviewedUserApi.slug || '',
+      displayName: blogPostDataReviewedUserApi.display_name || '',
+      description: blogPostDataReviewedUserApi.description || '',
+      profileUrl: blogPostDataReviewedUserApi.profile_url || '',
+      avatar: blogPostDataReviewedUserApi.avatar || '',
+      avatarThumbnail: blogPostDataReviewedUserApi.avatar_thumbnail || '',
+      turnOffProfile: Boolean(blogPostDataReviewedUserApi.turn_off_profile),
+    }
+  },
+  formatBrand: function (brandApi?: BrandApi): Brand | null {
+    if (!brandApi) return null
+    return {
+      id: brandApi.id || 0,
+      image: brandApi.image || '',
+      position: brandApi.position || '',
+      isPopular: brandApi.is_popular || false,
+      summary: brandApi.summary || '',
+      name: brandApi.name || '',
+      slug: brandApi.slug || '',
+      description: brandApi.description || null,
+      banners:
+        brandApi.banners?.map?.(dataFormatter.formatBanner).filter(isDefined) ||
+        [],
+      bestsellerProducts:
+        brandApi.bestseller_products
+          ?.map?.(dataFormatter.formatProduct)
+          .filter(isDefined) || [],
+    } as Brand
+  },
+  formatHomePage: (homePageApi?: HomePageApi): HomePage | null => {
+    if (!homePageApi) return null
+    return {
+      brands: homePageApi.brands
+        ? homePageApi.brands.map?.(dataFormatter.formatBrand).filter(isDefined)
+        : [],
+      hotDeals: homePageApi.hot_deals
+        ? homePageApi.hot_deals
+            .map?.(dataFormatter.formatProduct)
+            .filter(isDefined)
+        : [],
+      newProducts: homePageApi.new_products
+        ? homePageApi.new_products
+            .map?.(dataFormatter.formatProduct)
+            .filter(isDefined)
+        : [],
+      slideBanners: homePageApi.slide_banners
+        ? homePageApi.slide_banners
+            .map?.(dataFormatter.formatBanner)
+            .filter(isDefined)
+        : [],
+      subBanners: homePageApi.sub_banners
+        ? homePageApi.sub_banners
+            .map?.(dataFormatter.formatBanner)
+            .filter(isDefined)
+        : [],
+      footerBanners: homePageApi.footer_banners
+        ? homePageApi.footer_banners
+            .map?.(dataFormatter.formatBanner)
+            .filter(isDefined)
+        : [],
+      blogPosts: homePageApi.blog_posts
+        ? homePageApi.blog_posts
+            .map?.(dataFormatter.formatBlogPost)
+            .filter(isDefined)
+        : [],
+      popularCategories: homePageApi.popular_categories
+        ? homePageApi.popular_categories
+            .map?.((c) => dataFormatter.formatCategory(c))
+            .filter(isDefined)
+        : [],
+      suggestProducts: homePageApi.suggest_products
+        ? homePageApi.suggest_products
+            .map?.((c) => dataFormatter.formatCategory(c))
+            .filter(isDefined)
+        : [],
+      promotions: homePageApi.promotions
+        ? homePageApi.promotions
+            .map?.((c) => dataFormatter.formatPromotion(c))
+            .filter(isDefined)
+        : [],
+    }
+  },
+  formatCategoryPage: function (
+    categoryPageApi?: CategoryPageApi,
+  ): CategoryPage | null {
+    if (!categoryPageApi) return null
+    return {
+      id: categoryPageApi.id || 0,
+      name: categoryPageApi.name || '',
+      slug: categoryPageApi.slug || '',
+      description: categoryPageApi.description || null,
+      banners:
+        categoryPageApi.banners
+          ?.map?.(dataFormatter.formatBanner)
+          .filter(isDefined) || [],
+      bestsellerProducts:
+        categoryPageApi.bestseller_products
+          ?.map?.(dataFormatter.formatProduct)
+          .filter(isDefined) || [],
+    }
+  },
+  formatBrandPage: function (brandPageApi?: BrandPageApi): BrandPage | null {
+    if (!brandPageApi) return null
+    return dataFormatter.formatBrand(brandPageApi)
+  },
+  formatPagination: (paginationApi?: PaginationApi): Pagination | null => {
+    if (!paginationApi) return null
+    return {
+      current: paginationApi.current || 0,
+      first: paginationApi.first || 0,
+      itemsPerPage: paginationApi.items_per_page || 0,
+      last: paginationApi.last || 0,
+      next: paginationApi.next || 0,
+      prev: paginationApi.prev || 0,
+      totalItems: paginationApi.total_items || 0,
+    }
+  },
+  formatProductDetailPage: function (
+    productDetailPageApi?: ProductDetailPageApi,
+  ): ProductDetailPage | null {
+    if (!productDetailPageApi) return null
+    return {
+      ...(dataFormatter.formatProduct(productDetailPageApi) as Product),
+      relatedProducts:
+        productDetailPageApi.related_products
+          ?.map?.(dataFormatter.formatProduct)
+          .filter(isDefined) || [],
+      bestsellerProducts:
+        productDetailPageApi.bestseller_products
+          ?.map?.(dataFormatter.formatProduct)
+          .filter(isDefined) || [],
+      viewedProducts:
+        productDetailPageApi.viewed_products
+          ?.map?.(dataFormatter.formatProduct)
+          .filter(isDefined) || [],
+      promotions:
+        productDetailPageApi.promotions
+          ?.map?.(dataFormatter.formatPromotion)
+          .filter(isDefined) || [],
+    }
+  },
+  formatProductReview: (
+    productReview?: ProductReviewApi,
+  ): ProductReview | null => {
+    if (!productReview) return null
+
+    // TODO: avatar, images
+    return {
+      reviewId: productReview.review_id || '',
+      createdAt: productReview.created_at || '',
+      title: productReview.title || '',
+      detail: productReview.detail || '',
+      nickname: productReview.nick_name || '',
+      avatar: productReview.avatar || '',
+      ratingVotes:
+        productReview.rating_votes?.map?.((vote) => {
+          return {
+            ratingCode: vote.rating_code || '',
+            value: Number(vote.value) || 0,
+            percent: Number(vote.percent) || 0,
+          }
+        }) || [],
+      images: productReview.images || [],
+    }
+  },
+  formatProductPromotion: (
+    productPromotionApi?: ProductPromotionApi,
+  ): ProductPromotion | null => {
+    if (!productPromotionApi) return null
+
+    return {
+      id: productPromotionApi.id || 0,
+      name: productPromotionApi.name || '',
+      thumbnail: productPromotionApi.thumbnail || '',
+      expirationDate: productPromotionApi.expiration_date || '',
+    }
+  },
+  formatPromotion: (promotionApi?: PromotionApi): Promotion | null => {
+    if (!promotionApi) return null
+
+    return {
+      id: promotionApi.id || 0,
+      name: promotionApi.name || '',
+      slug: promotionApi.slug || '',
+      thumbnail: promotionApi.thumbnail || '',
+      expiredDate: promotionApi.expired_date || '',
+      banners: promotionApi.banners || [],
+      points: 0,
+      description: promotionApi.description || '',
+      metaTitle: promotionApi.meta_title || '',
+      metaKeywords: promotionApi.meta_keywords || '',
+      metaDescription: promotionApi.meta_description || '',
+    }
+  },
+  formatCustomAttributes: (
+    customAttributesApi: CustomAttributesApi[],
+    type: string,
+  ): string | '' => {
+    if (!customAttributesApi?.length) return ''
+    return (
+      customAttributesApi?.find(
+        (item: CustomAttributesApi) => item.attribute_code === type,
+      )?.value || ''
+    )
+  },
+
+  formatAddress: (addressApi?: AddressApi): Address | null => {
+    if (!addressApi) return null
+    return {
+      id: addressApi.id || 0,
+      fullName: addressApi.firstname || '',
+      telephone: addressApi.telephone || '',
+      province:
+        {
+          value: addressApi.region?.region_id,
+          label: addressApi.region?.region,
+        } || null,
+      district: {
+        value: dataFormatter.formatCustomAttributes(
+          addressApi.custom_attributes,
+          'district_id',
+        ),
+        label: dataFormatter.formatCustomAttributes(
+          addressApi.custom_attributes,
+          'district',
+        ),
+      },
+      commune: {
+        value: dataFormatter.formatCustomAttributes(
+          addressApi.custom_attributes,
+          'ward_id',
+        ),
+        label: dataFormatter.formatCustomAttributes(
+          addressApi.custom_attributes,
+          'ward',
+        ),
+      },
+      street: addressApi?.street?.length ? addressApi?.street[0] : '',
+      isDefault:
+        (addressApi.default_billing && addressApi.default_shipping) || false,
+      fullAddress: addressApi?.extension_attributes?.full_address || '',
+    }
+  },
+
+  formatProvince: (provinceApi?: ProvinceListApi): Province[] | [] => {
+    if (!provinceApi?.available_regions) return []
+
+    return provinceApi.available_regions.map((province: ProvinceApi) => ({
+      value: province.id || '',
+      label: province.name || '',
+    }))
+  },
+
+  formatDistrict: (districtApi?: DistrictListApi): District[] | [] => {
+    if (!districtApi?.districts) return []
+
+    return districtApi.districts.map((district: DistrictApi) => ({
+      value: district.id || '',
+      label: district.name || '',
+    }))
+  },
+
+  formatCommune: (communeApi?: CommuneListApi): Commune[] | [] => {
+    if (!communeApi?.communes) return []
+
+    return communeApi.communes.map((commune: CommuneApi) => ({
+      value: commune.id || '',
+      label: commune.name || '',
+    }))
+  },
+
+  formatOrder: (orderApi?: OrderApi): Order | null => {
+    if (!orderApi) return null
+    return {
+      orderNumber: orderApi?.order_number || '',
+      shippingData: orderApi?.shipping_data
+        ? {
+            shippingMethod: orderApi.shipping_data.shipping_method || '',
+            shippingDescription:
+              orderApi.shipping_data.shipping_description || '',
+            shippingAddress: orderApi.shipping_data.shipping_address
+              ? {
+                  fullName:
+                    orderApi.shipping_data.shipping_address.firstname || '',
+                  fullAddress:
+                    orderApi.shipping_data.shipping_address.full_address || '',
+                  telephone:
+                    orderApi.shipping_data.shipping_address.telephone || '',
+                }
+              : null,
+            storeAddress: null,
+          }
+        : null,
+      orderedDate: orderApi?.ordered_date || '',
+      status: orderApi?.status || null,
+      totals: orderApi?.totals
+        ? {
+            subtotal: orderApi.totals.subtotal || 0,
+            shippingAmount: orderApi.totals.shipping_amount || 0,
+            discountAmount: orderApi.totals.discount_amount || 0,
+            grandTotal: orderApi.totals.grand_total || 0,
+          }
+        : null,
+      products:
+        orderApi?.products?.map?.((p) => ({
+          sku: p.sku || '',
+          name: p.name || '',
+          price: p.price || 0,
+          rowTotal: p.row_total || 0,
+          image: p.image || '',
+          qty: p.qty || 0,
+        })) || [],
+
+      paymentMethod: orderApi?.payment_method || '',
+    }
+  },
+  formatStatistic: (statistic?: StatisticApi[]): Statistic => {
+    if (!statistic) return {} as Statistic
+    return {
+      pending:
+        Number(
+          statistic?.find((stt: StatisticApi) => stt.status === 'pending')
+            ?.amount,
+        ) || 0,
+      processing:
+        Number(
+          statistic?.find((stt: StatisticApi) => stt.status === 'processing')
+            ?.amount,
+        ) || 0,
+      delivering:
+        Number(
+          statistic?.find((stt: StatisticApi) => stt.status === 'delivering')
+            ?.amount,
+        ) || 0,
+      complete:
+        Number(
+          statistic?.find((stt: StatisticApi) => stt.status === 'complete')
+            ?.amount,
+        ) || 0,
+      canceled:
+        Number(
+          statistic?.find((stt: StatisticApi) => stt.status === 'canceled')
+            ?.amount,
+        ) || 0,
+    } as Statistic
+  },
+  formatCartItem: (cartItemApi?: CartItemApi): CartItem | null => {
+    if (!cartItemApi) return null
+    return {
+      itemId: cartItemApi.item_id || 0,
+      sku: cartItemApi.sku || '',
+      qty: cartItemApi.qty || 0,
+      name: cartItemApi.name || '',
+      price: cartItemApi.price || 0,
+      basePrice: cartItemApi.extension_attributes?.base_price || 0,
+      productType: cartItemApi.product_type || '',
+      quoteId: cartItemApi.quote_id || '',
+      thumbnail: cartItemApi.extension_attributes?.thumbnail || '',
+      rowTotal: cartItemApi.extension_attributes?.row_total || 0,
+      promotions: (cartItemApi.extension_attributes?.promotions?.map?.(
+        dataFormatter.formatProductPromotion,
+      ) || []) as ProductPromotion[],
+      isInStock: cartItemApi.extension_attributes?.is_in_stock || false,
+      urlProduct: cartItemApi.extension_attributes?.url_key || '',
+    }
+  },
+  formatCartAddress: (cartAddressApi?: CartAddressApi): CartAddress | null => {
+    if (!cartAddressApi) return null
+    return {
+      customerAddressId: cartAddressApi?.customer_address_id || 0,
+      id: cartAddressApi.id || 0,
+      region: cartAddressApi.region || '',
+      regionId: cartAddressApi.region_id || 0,
+      regionCode: cartAddressApi.region_code || '',
+      countryId: cartAddressApi.country_id || '',
+      street: cartAddressApi.street || [],
+      postcode: cartAddressApi.postcode || '',
+      city: cartAddressApi.city || '',
+      firstname: cartAddressApi.firstname || '',
+      lastname: cartAddressApi.lastname || '',
+      customerId: cartAddressApi.customer_id || 0,
+      email: cartAddressApi.email || '',
+      telephone: cartAddressApi.telephone || '',
+      sameAsBilling: cartAddressApi.same_as_billing || 0,
+      saveInAddressBook: cartAddressApi.save_in_address_book || 0,
+      fullAddress: cartAddressApi.extension_attributes?.full_address || '',
+    }
+  },
+  formatEstimatedShipping: (
+    estimatedShippingApi?: EstimatedShippingApi,
+  ): EstimatedShipping | null => {
+    if (!estimatedShippingApi) return null
+    return {
+      carrierCode: estimatedShippingApi.carrier_code || '',
+      methodCode: estimatedShippingApi.method_code || '',
+      carrierTitle: estimatedShippingApi.carrier_title || '',
+      methodTitle: estimatedShippingApi.method_title || '',
+      amount: estimatedShippingApi.amount || 0,
+      baseAmount: estimatedShippingApi.base_amount || 0,
+      available: estimatedShippingApi.available || false,
+      errorMessage: estimatedShippingApi.error_message || '',
+      priceExclTax: estimatedShippingApi.price_excl_tax || 0,
+      priceInclTax: estimatedShippingApi.price_incl_tax || 0,
+    }
+  },
+  formatCartLoggedInCustomer: (
+    cartLoggedInCustomerApi?: Partial<CartLoggedInCustomerApi>,
+  ): CartLoggedInCustomer | null => {
+    if (!cartLoggedInCustomerApi) return null
+    return {
+      email: cartLoggedInCustomerApi.email || '',
+      firstname: cartLoggedInCustomerApi.firstname || '',
+      lastname: cartLoggedInCustomerApi.lastname || '',
+      id: cartLoggedInCustomerApi.id || 0,
+      groupId: cartLoggedInCustomerApi.group_id || 0,
+      createdAt: cartLoggedInCustomerApi.created_at || '',
+      updatedAt: cartLoggedInCustomerApi.updated_at || '',
+      createdIn: cartLoggedInCustomerApi.created_in || '',
+      storeId: cartLoggedInCustomerApi.store_id || 0,
+      websiteId: cartLoggedInCustomerApi.website_id || 0,
+      addresses: (cartLoggedInCustomerApi.addresses?.map?.(
+        dataFormatter.formatCartAddress,
+      ) || []) as CartAddress[],
+      disableAutoGroupChange:
+        cartLoggedInCustomerApi.disable_auto_group_change || 0,
+      isSubscribed:
+        cartLoggedInCustomerApi.extension_attributes?.is_subscribed || false,
+    }
+  },
+  formatCart: (cartApi?: CartApi): Cart | null => {
+    if (!cartApi) return null
+    return {
+      id: cartApi.id || 0,
+      createdAt: cartApi.created_at || '',
+      updatedAt: cartApi.updated_at || '',
+      isActive: cartApi.is_active || false,
+      isVirtual: cartApi.is_virtual || false,
+      items: (cartApi.items
+        ?.map?.(dataFormatter.formatCartItem)
+        ?.sort((a, b) => Number(b?.isInStock) - Number(a?.isInStock)) ||
+        []) as CartItem[],
+      itemsCount: cartApi.items_count || 0,
+      itemsQty: cartApi.items_qty || 0,
+      customer: cartApi.customer
+        ? dataFormatter.formatCartLoggedInCustomer(cartApi.customer)
+        : null,
+      billingAddress: cartApi.billing_address
+        ? dataFormatter.formatCartAddress(cartApi.billing_address)
+        : null,
+      origOrderId: cartApi.orig_order_id || 0,
+      currency: {
+        globalCurrencyCode: cartApi.currency?.global_currency_code || '',
+        baseCurrencyCode: cartApi.currency?.base_currency_code || '',
+        storeCurrencyCode: cartApi.currency?.store_currency_code || '',
+        quoteCurrencyCode: cartApi.currency?.quote_currency_code || '',
+        storeToBaseRate: cartApi.currency?.store_to_base_rate || 0,
+        storeToQuoteRate: cartApi.currency?.store_to_quote_rate || 0,
+        baseToGlobalRate: cartApi.currency?.base_to_global_rate || 0,
+        baseToQuoteRate: cartApi.currency?.base_to_quote_rate || 0,
+      },
+      customerIsGuest: cartApi.customer_is_guest || false,
+      customerNoteNotify: cartApi.customer_note_notify || false,
+      customerTaxClassId: cartApi.customer_tax_class_id || 0,
+      storeId: cartApi.store_id || 0,
+      shippingAssignments:
+        cartApi.extension_attributes?.shipping_assignments?.map?.((s) => ({
+          shipping: {
+            address: s.shipping.address
+              ? dataFormatter.formatCartAddress(s.shipping.address)
+              : null,
+            method: s.shipping?.method || '',
+          },
+          items: (s.items.map?.(dataFormatter.formatCartItem) ||
+            []) as CartItem[],
+        })),
+    }
+  },
+  formatCartTotal: (cartTotalApi?: CartTotalApi): CartTotal | null => {
+    if (!cartTotalApi) return null
+    return {
+      grandTotal: cartTotalApi.grand_total || 0,
+      baseGrandTotal: cartTotalApi.base_grand_total || 0,
+      subtotal: cartTotalApi.subtotal || 0,
+      baseSubtotal: cartTotalApi.base_subtotal || 0,
+      discountAmount: cartTotalApi.discount_amount || 0,
+      baseDiscountAmount: cartTotalApi.base_discount_amount || 0,
+      subtotalWithDiscount: cartTotalApi.subtotal_with_discount || 0,
+      baseSubtotalWithDiscount: cartTotalApi.base_subtotal_with_discount || 0,
+      shippingAmount: cartTotalApi.shipping_amount || 0,
+      baseShippingAmount: cartTotalApi.base_shipping_amount || 0,
+      shippingDiscountAmount: cartTotalApi.shipping_discount_amount || 0,
+      baseShippingDiscountAmount:
+        cartTotalApi.base_shipping_discount_amount || 0,
+      taxAmount: cartTotalApi.tax_amount || 0,
+      baseTaxAmount: cartTotalApi.base_tax_amount || 0,
+      weeeTaxAppliedAmount: cartTotalApi.weee_tax_applied_amount || 0,
+      shippingTaxAmount: cartTotalApi.shipping_tax_amount || 0,
+      baseShippingTaxAmount: cartTotalApi.base_shipping_tax_amount || 0,
+      subtotalInclTax: cartTotalApi.subtotal_incl_tax || 0,
+      shippingInclTax: cartTotalApi.shipping_incl_tax || 0,
+      baseShippingInclTax: cartTotalApi.base_shipping_incl_tax || 0,
+      baseCurrencyCode: cartTotalApi.base_currency_code || '',
+      quoteCurrencyCode: cartTotalApi.quote_currency_code || '',
+      itemsQty: cartTotalApi.items_qty || 0,
+      coupon: {
+        couponCode: cartTotalApi.coupon_code || '',
+        couponDescription:
+          cartTotalApi?.extension_attributes?.coupon_description_text || '',
+      },
+      items:
+        cartTotalApi.items?.map?.((item) => ({
+          itemId: item.item_id || 0,
+          price: item.price || 0,
+          basePrice: item.base_price || 0,
+          qty: item.qty || 0,
+          rowTotal: item.row_total || 0,
+          baseRowTotal: item.base_row_total || 0,
+          rowTotalWithDiscount: item.row_total_with_discount || 0,
+          taxAmount: item.tax_amount || 0,
+          baseTaxAmount: item.base_tax_amount || 0,
+          taxPercent: item.tax_percent || 0,
+          discountAmount: item.discount_amount || 0,
+          baseDiscountAmount: item.base_discount_amount || 0,
+          discountPercent: item.discount_percent || 0,
+          priceInclTax: item.price_incl_tax || 0,
+          basePriceInclTax: item.base_price_incl_tax || 0,
+          rowTotalInclTax: item.row_total_incl_tax || 0,
+          baseRowTotalInclTax: item.base_row_total_incl_tax || 0,
+          options: item.options || '',
+          weeeTaxAppliedAmount: item.weee_tax_applied_amount || 0,
+          weeeTaxApplied: item.weee_tax_applied || 0,
+          name: item.name || '',
+        })) || [],
+      totalSegments: cartTotalApi.total_segments || [],
+    }
+  },
+  formatPaymentMethod: (
+    methods?: PaymentMethodsApi[],
+  ): PaymentMethodInfo[] | null => {
+    if (!methods) return null
+    return methods?.map((method: PaymentMethodsApi) => ({
+      code: method?.payment_code || '',
+      title: method?.payment_title || '',
+      thumbnail: method?.payment_thumbnail || '',
+    }))
+  },
+  formatPaymentInformation: (
+    paymentInformationApi?: ShippingInformation,
+  ): PaymentInformation | null => {
+    if (!paymentInformationApi) return null
+    return {
+      paymentMethods:
+        dataFormatter.formatPaymentMethod(
+          paymentInformationApi?.extension_attributes?.payment_detail_info,
+        ) || [],
+      totals: dataFormatter.formatCartTotal(paymentInformationApi.totals),
+    }
+  },
+  formatOrderConfirmation: (
+    orderConfirmationApi?: OrderConfirmationApi,
+  ): OrderConfirmation | null => {
+    if (!orderConfirmationApi) return null
+    return {
+      isSuccess: orderConfirmationApi.is_success || false,
+      orderInfo: dataFormatter.formatOrder(orderConfirmationApi.order_info),
+    }
+  },
+  formatCoupons: (couponListApi?: CouponListApi): Coupon[] | null => {
+    if (!couponListApi?.items?.length) return null
+    return couponListApi.items.map((couponApi: CouponApi) => ({
+      code: couponApi?.code || '',
+      name: couponApi?.name || '',
+      thumbnail: couponApi?.thumbnail || '',
+      description: couponApi?.expired_date || '',
+    }))
+  },
+  formatShippings: (shippingsApi?: ShippingApi[]): Shipping[] => {
+    if (!shippingsApi) return [] as Shipping[]
+
+    return shippingsApi.map((shippingApi: ShippingApi) => ({
+      carrierCode: shippingApi.carrier_code || '',
+      methodCode: shippingApi.method_code || '',
+      title: shippingApi.carrier_title || '',
+      description: shippingApi.method_title || '',
+      price: shippingApi?.base_amount || 0,
+      thumbnail: shippingApi?.extension_attributes?.thumbnail || '',
+    }))
+  },
+}