Function canUserBuy

canUserBuy(option: Variant, location?: string): boolean

Decides whether the current user may buy a single option (a product or one of its variants) given their location. Region, EU-only, unresolved-delivery, and buyer restrictions all exclude; a declaration-of-use requirement is informational and never excludes. An option with no restriction is buyable. euOnly is checked against EU_COUNTRY_CODES (the 27 EU member states), and an unknown user location is treated as ineligible for the safe EU-only case.

Parameters

option: Variant
The product or variant to check
Optionallocation: string
The user's ISO 3166-1 alpha-2 location code (may be undefined)

Returns boolean

True when the user may buy the option, false when it should be hidden

Example

canUserBuy({ purchaseRestriction: { excludedCountries: ["US"] } }, "US"); // false
canUserBuy({ purchaseRestriction: { euOnly: true } }, "PL"); // true
canUserBuy({ purchaseRestriction: { declarationOfUseRequired: true } }, "US"); // true
canUserBuy({}, "US"); // true

Source

export function canUserBuy(option: Variant, location?: string): boolean {
  const restriction = option.purchaseRestriction;
  if (!restriction) {
    return true;
  }
  if (restriction.excludedCountries?.some((code) => code === location)) {
    return false;
  }
  if (restriction.euOnly && (location === undefined || !EU_COUNTRY_CODES.has(location))) {
    return false;
  }
  if (restriction.restrictedDelivery) {
    return false;
  }
  if (restriction.buyerRestricted) {
    return false;
  }
  return true;
}