@lmnto/h-mall-shared 1.0.14 → 1.0.16

package/package.json

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

package/shared/components/AddressFormComponent.tsx

@@ -17,12 +17,14 @@ export type AddressFormComponentProps = {
   isLoading: boolean;
   proceedSubmit: FormEventHandler<HTMLButtonElement>;
   onCancel?: () => void;
+  enforceCheckoutEnabled?: boolean;
 };
 
 export default function AddressFormComponent({
   formId,
   isLoading,
   proceedSubmit,
+  enforceCheckoutEnabled = false,
 }: AddressFormComponentProps) {
   //
   const scopeT = _useScopedI18n("sharedComponents.addressFormComponent");
@@ -126,6 +128,7 @@ export default function AddressFormComponent({
               name="countryId"
               formId={formId}
               onCountrySelected={handleGetState}
+              enforceCheckoutEnabled={enforceCheckoutEnabled}
             />
           </div>
           <div className="col-span-12 md:col-span-6 relative">

package/shared/components/AddressShippingFormComponent.tsx

@@ -18,12 +18,14 @@ export type AddressShippingFormComponentProps = {
   isLoading: boolean;
   proceedSubmit: FormEventHandler<HTMLButtonElement>;
   onCancel?: () => void;
+  enforceCheckoutEnabled?: boolean;
 };
 
 export default function AddressShippingFormComponent({
   formId,
   isLoading,
   proceedSubmit,
+  enforceCheckoutEnabled = false,
 }: AddressShippingFormComponentProps) {
   //
   const scopeT = _useScopedI18n("sharedComponents.addressFormComponent");
@@ -134,6 +136,7 @@ export default function AddressShippingFormComponent({
               formId={formId}
               onCountrySelected={handleGetState}
               forShipping={true}
+              enforceCheckoutEnabled={enforceCheckoutEnabled}
             />
           </div>
           <div className="col-span-12 md:col-span-6 relative">

package/shared/components/SelectCountries.tsx

@@ -18,6 +18,8 @@ export interface InputFieldProps {
   formId: string;
   forShipping?: boolean;
   forPickUp?: boolean;
+  /** When true, only countries with isCheckoutEnabled are shown (checkout flows). */
+  enforceCheckoutEnabled?: boolean;
   onCountrySelected?: (value: string | number) => void;
 }
 
@@ -29,10 +31,12 @@ export function SelectCountries({
   formId,
   forShipping = true,
   forPickUp = false,
+  enforceCheckoutEnabled = false,
   onCountrySelected,
 }: InputFieldProps) {
   const {
     countries,
+    shippingCountries,
     setStates,
     setShippingStates,
     setCities,
@@ -50,8 +54,14 @@ export function SelectCountries({
   const [error, setError] = useState<any>(null);
   const [search, setSearch] = useState<string>("");
 
-  const countriesType = countries;
-  const filteredCountries = countriesType?.filter((country) =>
+  const baseCountries =
+    forShipping && shippingCountries?.length
+      ? shippingCountries
+      : countries;
+  const checkoutFiltered = enforceCheckoutEnabled
+    ? baseCountries?.filter((country) => country.isCheckoutEnabled !== false)
+    : baseCountries;
+  const filteredCountries = checkoutFiltered?.filter((country) =>
     country.name.toLowerCase().includes(search.toLowerCase()),
   );
 
@@ -73,7 +83,7 @@ export function SelectCountries({
   // Handle change logic for country selection
   const handleOnChange = (value: any) => {
     const countryId = +value.id; // Ensure it's a number
-    const selectedCountry = countries.find((c) => c.id === countryId);
+    const selectedCountry = checkoutFiltered?.find((c) => c.id === countryId);
 
     if (!selectedCountry) return; // Handle invalid selection safely
 
@@ -138,7 +148,7 @@ export function SelectCountries({
                     focus:bg-offWhite
                     shadow-none ${className}
                 `}
-        items={filteredCountries}
+        items={filteredCountries ?? []}
         searchKey="name"
         placeholder={placeholder}
         renderOption={(_item, country) => {

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/types/addressForm.ts

@@ -24,4 +24,6 @@ export interface ICountries {
   zipCodeExists: boolean;
   zipCodeRegex: string;
   zipCodeExample: string;
+  /** Partner Hub checkout eligibility; used to filter checkout country pickers only. */
+  isCheckoutEnabled?: boolean;
 }

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