@lmnto/h-mall-shared 1.0.14 → 1.0.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lmnto/h-mall-shared",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "private": false,
   "sideEffects": false,
   "scripts": {

package/shared/hooks/useCart.ts

@@ -1,3 +1,5 @@
+"use client";
+
 import { useMutation, useQuery } from "@tanstack/react-query";
 import { useCallback, useEffect, useState } from "react";
 
@@ -8,11 +10,24 @@ import { ShippingMethodsService } from "../services/api";
 import { useCartStore } from "../stores/cartStore";
 import { countriesStore } from "../stores/countriesStore";
 import { withTimeout } from "../utils/app.util";
+import { notification } from "../utils/notifications.util";
+import { UsaHomeStationErrorCode } from "../utils/usa-home-station-error.constants";
+import { useUsaHomeStationErrorMessage } from "./useUsaHomeStationErrorMessage";
+
+function isUsaHomeStationApiError(error: { body?: { code?: string }; code?: string }) {
+  const code = error?.body?.code ?? error?.code;
+  return (
+    code === UsaHomeStationErrorCode.QUOTA_EXCEEDED ||
+    code === UsaHomeStationErrorCode.ELIGIBILITY_CHECK_FAILED ||
+    code === UsaHomeStationErrorCode.USER_NOT_FOUND
+  );
+}
 
 export function useCart() {
   const [revalidateCartSuccess, setRevalidateCartSuccess] = useState(false);
   const { triggerInvalidDialog } = useMainContext();
   const { setShippingCountries } = countriesStore();
+  const resolveUsaHomeStationError = useUsaHomeStationErrorMessage();
 
   //
   const { cart, commissionNonEligibleFound, setLoading, setCart } =
@@ -51,6 +66,9 @@ export function useCart() {
         triggerInvalidDialog();
         return;
       }
+      if (isUsaHomeStationApiError(error)) {
+        notification.notifyError(resolveUsaHomeStationError(error));
+      }
     },
   });
 
@@ -81,7 +99,12 @@ export function useCart() {
     onSuccess: async () => {
       revalidateCart();
     },
-    onError: () => setLoading(false),
+    onError: (error: any) => {
+      setLoading(false);
+      if (isUsaHomeStationApiError(error)) {
+        notification.notifyError(resolveUsaHomeStationError(error));
+      }
+    },
   });
 
   const updateCartAddresses = useMutation({
@@ -89,7 +112,12 @@ export function useCart() {
     mutationFn: CartsService.cartsControllerUpdateAddresses,
     onMutate: () => setLoading(true),
     onSuccess: () => revalidateCart(),
-    onError: () => setLoading(false),
+    onError: (error: any) => {
+      setLoading(false);
+      if (isUsaHomeStationApiError(error)) {
+        notification.notifyError(resolveUsaHomeStationError(error));
+      }
+    },
   });
 
   //#TODO Update with the Update shipping address API
@@ -98,7 +126,12 @@ export function useCart() {
     mutationFn: CartsService.cartsControllerShippingAddresses,
     onMutate: () => setLoading(true),
     onSuccess: () => revalidateCart(),
-    onError: () => setLoading(false),
+    onError: (error: any) => {
+      setLoading(false);
+      if (isUsaHomeStationApiError(error)) {
+        notification.notifyError(resolveUsaHomeStationError(error));
+      }
+    },
   });
 
   const updatePaymentMethod = useMutation({

package/shared/hooks/useUsaHomeStationErrorMessage.ts

@@ -0,0 +1,18 @@
+"use client";
+
+import { useCallback } from "react";
+
+import { _useScopedI18n } from "../i18n/client";
+import { resolveUsaHomeStationErrorMessage } from "../utils/usa-home-station-error.util";
+
+export function useUsaHomeStationErrorMessage() {
+  const t = _useScopedI18n("cart.usaHomeStation");
+
+  return useCallback(
+    (error: unknown) =>
+      resolveUsaHomeStationErrorMessage(error, (key, params) =>
+        t(key as "quotaExceeded", params),
+      ),
+    [t],
+  );
+}

package/shared/i18n/locales/en.ts

@@ -206,6 +206,16 @@ export default {
         addNewShippingAddress: "Add New Shipping Address",
       },
     },
+    usaHomeStation: {
+      quotaExceeded:
+        "Shipping to the United States allows {defaultAllowance} Nx1 Home Station by default (max {max} based on {downline} direct first-line referral(s) on NodeLink). You already have {past} from previous US shipped order(s) and {cart} in your cart.",
+      userNotFound:
+        "We could not verify your account for US Home Station shipping. Please sign in again.",
+      eligibilityCheckFailed:
+        "We could not verify your Nx1 Home Station purchase limit. Please try again.",
+      generic:
+        "Unable to complete this action because of US Home Station shipping limits.",
+    },
   },
   sharedComponents: {
     addressFormComponent: {

package/shared/i18n/locales/it.ts

@@ -193,6 +193,16 @@ export default {
         addNewShippingAddress: "Aggiungi un nuovo indirizzo di spedizione",
       },
     },
+    usaHomeStation: {
+      quotaExceeded:
+        "La spedizione negli Stati Uniti consente {defaultAllowance} Nx1 Home Station di default (max {max} in base a {downline} referral diretti di prima linea su NodeLink). Hai già {past} da ordini precedenti spediti negli USA e {cart} nel carrello.",
+      userNotFound:
+        "Impossibile verificare il tuo account per la spedizione US Home Station. Accedi di nuovo.",
+      eligibilityCheckFailed:
+        "Impossibile verificare il limite di acquisto Nx1 Home Station. Riprova.",
+      generic:
+        "Impossibile completare l'azione a causa dei limiti di spedizione US Home Station.",
+    },
   },
   sharedComponents: {
     addressFormComponent: {

package/shared/utils/usa-home-station-error.constants.ts

@@ -0,0 +1,6 @@
+/** Keep in sync with h-mall-api `usa-home-station.errors.ts` */
+export const UsaHomeStationErrorCode = {
+  QUOTA_EXCEEDED: 'USA_HOME_STATION_QUOTA_EXCEEDED',
+  ELIGIBILITY_CHECK_FAILED: 'USA_HOME_STATION_ELIGIBILITY_CHECK_FAILED',
+  USER_NOT_FOUND: 'USA_HOME_STATION_USER_NOT_FOUND',
+} as const;

package/shared/utils/usa-home-station-error.util.ts

@@ -0,0 +1,64 @@
+import { UsaHomeStationErrorCode } from './usa-home-station-error.constants';
+
+export type UsaHomeStationErrorPayload = {
+  maxMachinesAllowed?: number;
+  downlineUsersCount?: number;
+  pastPurchasedQuantity?: number;
+  cartQuantity?: number;
+  totalRequestedQuantity?: number;
+};
+
+type ApiErrorShape = {
+  code?: string;
+  msg?: string;
+  message?: string;
+  data?: UsaHomeStationErrorPayload;
+  error?: UsaHomeStationErrorPayload;
+  body?: {
+    code?: string;
+    msg?: string;
+    message?: string;
+    data?: UsaHomeStationErrorPayload;
+    error?: UsaHomeStationErrorPayload;
+  };
+};
+
+type TranslateFn = (
+  key: string,
+  params?: Record<string, string | number>,
+) => string;
+
+/**
+ * Maps US Nx1 Home Station API error codes to i18n messages.
+ * Falls back to API msg when code is unknown.
+ */
+export function resolveUsaHomeStationErrorMessage(
+  error: unknown,
+  translate: TranslateFn,
+): string {
+  const err = error as ApiErrorShape;
+  const code = err?.body?.code ?? err?.code;
+  const payload = (err?.body?.data ??
+    err?.body?.error ??
+    err?.data ??
+    err?.error) as UsaHomeStationErrorPayload | undefined;
+  const fallback =
+    err?.body?.msg ?? err?.body?.message ?? err?.msg ?? err?.message;
+
+  switch (code) {
+    case UsaHomeStationErrorCode.QUOTA_EXCEEDED:
+      return translate("quotaExceeded", {
+        defaultAllowance: 1,
+        max: payload?.maxMachinesAllowed ?? 0,
+        downline: payload?.downlineUsersCount ?? 0,
+        past: payload?.pastPurchasedQuantity ?? 0,
+        cart: payload?.cartQuantity ?? 0,
+      });
+    case UsaHomeStationErrorCode.USER_NOT_FOUND:
+      return translate("userNotFound");
+    case UsaHomeStationErrorCode.ELIGIBILITY_CHECK_FAILED:
+      return translate("eligibilityCheckFailed");
+    default:
+      return fallback ?? translate("generic");
+  }
+}