@lmnto/h-mall-shared 1.0.13 → 1.0.15

package/package.json

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

package/shared/components/payments/RequestProcessingWithCancelConfirm.tsx

@@ -26,6 +26,8 @@ export type RequestProcessingWithCancelConfirmProps = {
   confirmBeforeClose?: boolean;
   /** Called when the user confirms leaving the payment flow (e.g. navigate home). */
   onConfirmLeavePayment?: () => void;
+  /** Optional copy variant for cancel confirmation dialog. Defaults to nowpayments wording. */
+  cancelConfirmVariant?: "nowpayments" | "stripe";
 };
 
 /**
@@ -41,9 +43,11 @@ export function RequestProcessingWithCancelConfirm({
   paymentDetails,
   confirmBeforeClose,
   onConfirmLeavePayment,
+  cancelConfirmVariant = "nowpayments",
 }: RequestProcessingWithCancelConfirmProps) {
   const scopeT = _useScopedI18n("payment.requestProcessingDialog");
   const cancelT = _useScopedI18n("payment.cancelPaymentConfirm");
+  const stripeCancelT = _useScopedI18n("payment.cancelPaymentConfirmStripe");
   const hasPaymentDetails = Boolean(paymentDetails);
   const [cancelConfirmOpen, setCancelConfirmOpen] = useState(false);
 
@@ -69,6 +73,8 @@ export function RequestProcessingWithCancelConfirm({
     setCancelConfirmOpen(false);
   }, []);
 
+  const isStripeVariant = cancelConfirmVariant === "stripe";
+
   return (
     <>
       <Dialog
@@ -200,21 +206,31 @@ export function RequestProcessingWithCancelConfirm({
             variant="h4"
             className="text-base md:text-xl font-semibold text-black-500"
           >
-            {cancelT("title")}
+            {isStripeVariant ? stripeCancelT("title") : cancelT("title")}
           </Typography>
           <ul className="list-disc space-y-3 pl-5 text-sm leading-relaxed text-slate-600 marker:text-slate-500">
-            <li>{cancelT("completedItem")}</li>
-            <li>
-              <span className="block">{cancelT("notSentIntro")}</span>
-              <ul className="mt-2 list-[circle] space-y-2 pl-5 marker:text-slate-400">
-                <li>{cancelT("notSentSub1")}</li>
-                <li>{cancelT("notSentSub2")}</li>
-                <li>{cancelT("notSentSub3")}</li>
-              </ul>
-            </li>
+            {isStripeVariant ? (
+              <>
+                <li>{stripeCancelT("item1")}</li>
+                <li>{stripeCancelT("item2")}</li>
+                <li>{stripeCancelT("item3")}</li>
+              </>
+            ) : (
+              <>
+                <li>{cancelT("completedItem")}</li>
+                <li>
+                  <span className="block">{cancelT("notSentIntro")}</span>
+                  <ul className="mt-2 list-[circle] space-y-2 pl-5 marker:text-slate-400">
+                    <li>{cancelT("notSentSub1")}</li>
+                    <li>{cancelT("notSentSub2")}</li>
+                    <li>{cancelT("notSentSub3")}</li>
+                  </ul>
+                </li>
+              </>
+            )}
           </ul>
           <Typography className="text-sm leading-relaxed text-slate-600">
-            {cancelT("closing")}
+            {isStripeVariant ? stripeCancelT("closing") : cancelT("closing")}
           </Typography>
         </DialogBody>
         <DialogFooter className="flex flex-col-reverse gap-2 p-0 pt-2 sm:flex-row sm:justify-end">
@@ -224,10 +240,10 @@ export function RequestProcessingWithCancelConfirm({
             className="normal-case rounded-xl border-slate-300 px-4 py-2.5 text-sm font-semibold text-slate-700 shadow-sm hover:border-slate-400 hover:bg-slate-50"
             onClick={handleStayOnPayment}
           >
-            {cancelT("stayBtn")}
+            {isStripeVariant ? stripeCancelT("stayBtn") : cancelT("stayBtn")}
           </Button>
           <ButtonCustom icon={undefined} onClick={handleConfirmLeave}>
-            {cancelT("leaveBtn")}
+            {isStripeVariant ? stripeCancelT("leaveBtn") : cancelT("leaveBtn")}
           </ButtonCustom>
         </DialogFooter>
       </Dialog>

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: {
@@ -364,6 +374,19 @@ export default {
       stayBtn: "Stay and pay",
       leaveBtn: "Leave without paying",
     },
+    cancelPaymentConfirmStripe: {
+      title: "Leave card payment?",
+      item1:
+        "If your card was declined, no funds were captured and you can retry with another card.",
+      item2:
+        "If authentication is still pending (e.g. 3D Secure), leaving now may interrupt payment completion.",
+      item3:
+        "You can return to checkout anytime to complete payment for this order.",
+      closing:
+        "If you are unsure whether payment went through, check your order status before trying again.",
+      stayBtn: "Stay and complete payment",
+      leaveBtn: "Leave checkout",
+    },
     paybyWalletItemComponent: {
       insufficientBalanceMsg: "Insufficient wallet balance. Please recharge.",
       avlBalance: "Avl Balance",

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: {
@@ -353,6 +363,19 @@ export default {
       stayBtn: "Resta e paga",
       leaveBtn: "Esci senza pagare",
     },
+    cancelPaymentConfirmStripe: {
+      title: "Vuoi uscire dal pagamento con carta?",
+      item1:
+        "Se la carta è stata rifiutata, non è stato addebitato alcun importo e puoi riprovare con un'altra carta.",
+      item2:
+        "Se l'autenticazione è ancora in corso (es. 3D Secure), uscire ora può interrompere il completamento del pagamento.",
+      item3:
+        "Puoi tornare al checkout in qualsiasi momento per completare il pagamento di questo ordine.",
+      closing:
+        "Se non sei sicuro che il pagamento sia andato a buon fine, controlla lo stato dell'ordine prima di riprovare.",
+      stayBtn: "Resta e completa il pagamento",
+      leaveBtn: "Esci dal checkout",
+    },
     paybyWalletItemComponent: {
       insufficientBalanceMsg:
         "Saldo del portafoglio insufficiente. Si prega di ricaricare.",

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");
+  }
+}