create-brainerce-store 1.78.0 → 1.80.0

package/templates/nextjs/base/src/ui/product/product-card.tsx

@@ -1,221 +1,230 @@
-'use client';
-
-import { useState } from 'react';
-import { Check, Image as ImageIcon, Plus, ShoppingCart, Star } from 'lucide-react';
-import { Link, useRouter } from '@/core/lib/navigation';
-import { CdnImage as Image } from '@/ui/shared/cdn-image';
-import type { Product } from 'brainerce';
-import { getProductPriceInfo, formatPrice } from 'brainerce';
-import { pickDisplayPrice, pickDisplayPriceRange } from '@/core/lib/display-price';
-import { useTranslations } from '@/core/lib/translations';
-import { PriceDisplay } from '@/ui/product/price-display';
-import { StockBadge } from '@/ui/product/stock-badge';
-import { DiscountBadge } from '@/ui/product/discount-badge';
-import { Badge } from '@/components/ui/badge';
-import { Button } from '@/components/ui/button';
-import { Card } from '@/components/ui/card';
-import { useCart } from '@/core/providers/store-provider';
-import { useCurrency } from '@/core/lib/use-currency';
-import { trackAddToCart } from '@/core/lib/tracking';
-import { cn } from '@/core/lib/utils';
-
-interface ProductCardProps {
-  product: Product;
-  className?: string;
-}
-
-function VariantPriceRange({ product }: { product: Product }) {
-  const fallbackCurrency = useCurrency();
-  // ⛔ Region-aware. A range built from priceMin/priceMax alone stays in the
-  // store currency while the single-price card beside it converts, so a
-  // variable product would quote a different currency from its neighbours.
-  const range = pickDisplayPriceRange(product, fallbackCurrency);
-  if (!range) return null;
-  const { min, max, currency } = range;
-
-  return (
-    <span className="text-foreground text-sm font-medium">
-      {min === max
-        ? (formatPrice(min, { currency }) as string)
-        : `${formatPrice(min, { currency })} – ${formatPrice(max, { currency })}`}
-    </span>
-  );
-}
-
-export function ProductCard({ product, className }: ProductCardProps) {
-  const t = useTranslations('common');
-  const tp = useTranslations('productDetail');
-  const tProd = useTranslations('products');
-  const tr = useTranslations('reviews');
-  const router = useRouter();
-  const { refreshCart } = useCart();
-  const fallbackCurrency = useCurrency();
-  // FX overlay (PRD §23): prefer the region-converted display values when the
-  // storefront passed regionId to getProducts. Otherwise fall back to the
-  // canonical store-currency basePrice / salePrice.
-  const display = pickDisplayPrice(product, fallbackCurrency);
-  const { price, originalPrice, isOnSale } = getProductPriceInfo(product);
-  const mainImage = product.images?.[0];
-  const imageUrl = mainImage?.url || null;
-  const slug = product.slug || product.id;
-  const isVariable = product.type === 'VARIABLE';
-
-  const [adding, setAdding] = useState(false);
-  const [added, setAdded] = useState(false);
-
-  // `!== false`, not `=== true`, and that matters for KIT products: a kit
-  // carries NO `inventory` object of its own (its availability is derived from
-  // its components), so a strict truthy check would render every kit as out of
-  // stock. A kit also falls through `isVariable` above and adds by `productId`
-  // alone, which is correct — kits take no variantId and no selections.
-  const canPurchase = product.inventory?.canPurchase !== false;
-
-  async function handleAddToCart(e: React.MouseEvent) {
-    e.preventDefault();
-    e.stopPropagation();
-
-    if (isVariable) {
-      router.push(`/products/${slug}`);
-      return;
-    }
-
-    if (adding || !canPurchase) return;
-
-    try {
-      setAdding(true);
-      const { getClient } = await import('@/core/lib/brainerce');
-      const client = getClient();
-      await client.smartAddToCart({ productId: product.id, quantity: 1 });
-      await refreshCart();
-      // Quick-add from a grid card is a real add_to_cart — without this the
-      // ad platforms only ever see adds made from a product page. Reported in
-      // the DISPLAYED currency (region-converted when the storefront passed a
-      // regionId), because that is what the shopper is actually being charged.
-      trackAddToCart(product, null, 1, display.salePrice ?? display.price, display.currency);
-      setAdded(true);
-      setTimeout(() => setAdded(false), 2000);
-    } catch (err) {
-      console.error('Failed to add to cart:', err);
-    } finally {
-      setAdding(false);
-    }
-  }
-
-  return (
-    <Card
-      className={cn(
-        'group block overflow-hidden shadow-none transition-shadow hover:shadow-md',
-        className
-      )}
-    >
-      {/* Image — clickable */}
-      <Link href={`/products/${slug}`} className="block">
-        <div className="bg-muted relative aspect-square overflow-hidden">
-          {imageUrl ? (
-            <Image
-              src={imageUrl}
-              alt={mainImage?.alt || product.name}
-              fill
-              sizes="(max-width: 640px) 100vw, (max-width: 1024px) 50vw, 25vw"
-              className="object-cover transition-transform duration-300 group-hover:scale-105"
-            />
-          ) : (
-            <div className="text-muted-foreground absolute inset-0 flex items-center justify-center">
-              <ImageIcon className="h-12 w-12" strokeWidth={1.5} aria-hidden="true" />
-            </div>
-          )}
-
-          {/* Badges */}
-          <div className="absolute start-2 top-2 flex flex-col items-start gap-1">
-            {isOnSale && (
-              <Badge variant="destructive" className="rounded px-2 py-1 font-bold">
-                {t('sale')}
-              </Badge>
-            )}
-            <DiscountBadge discount={product.discount} />
-            {product.isDownloadable && (
-              <Badge className="rounded px-2 py-1 font-bold">{tp('digitalProduct')}</Badge>
-            )}
-          </div>
-
-          {/* Add to cart overlay button */}
-          {(isVariable || canPurchase) && (
-            <Button
-              size="icon"
-              onClick={handleAddToCart}
-              disabled={adding}
-              aria-label={isVariable ? tProd('selectOptions') : tp('addToCart')}
-              className={cn(
-                'absolute bottom-2 end-2 h-8 w-8 rounded-full shadow-md transition-all',
-                'translate-y-2 opacity-0 group-hover:translate-y-0 group-hover:opacity-100',
-                added && 'bg-green-500 text-white hover:bg-green-500'
-              )}
-            >
-              {added ? (
-                <Check strokeWidth={2.5} aria-hidden="true" />
-              ) : isVariable ? (
-                <Plus aria-hidden="true" />
-              ) : (
-                <ShoppingCart aria-hidden="true" />
-              )}
-            </Button>
-          )}
-        </div>
-      </Link>
-
-      {/* Content */}
-      <div className="space-y-2 p-3">
-        {/* Categories */}
-        {product.categories && product.categories.length > 0 && (
-          <div className="flex flex-wrap gap-1">
-            {product.categories.slice(0, 2).map((cat) => (
-              <Badge
-                key={cat.id}
-                variant="secondary"
-                className="text-muted-foreground bg-muted rounded px-1.5 py-0.5 text-[10px] font-normal"
-              >
-                {cat.name}
-              </Badge>
-            ))}
-          </div>
-        )}
-
-        {/* Name — clickable */}
-        <Link href={`/products/${slug}`}>
-          <h3 className="text-foreground hover:text-primary line-clamp-2 text-sm font-medium transition-colors">
-            {product.name}
-          </h3>
-        </Link>
-
-        {/* Star rating. `avgRating` / `reviewCount` are denormalized rollups
-            the API returns on every product fetch. Auto-hides on a store with
-            no reviews yet: `reviewCount` is 0 (or absent) and the whole block
-            is skipped, so nothing renders and the card keeps its layout. */}
-        {product.reviewCount ? (
-          <div className="flex items-center gap-1" aria-label={tr('starRating')}>
-            <Star className="h-3.5 w-3.5 fill-amber-400 text-amber-400" aria-hidden="true" />
-            <span className="text-foreground text-xs font-medium">
-              {(product.avgRating ?? 0).toFixed(1)}
-            </span>
-            <span className="text-muted-foreground text-xs">({product.reviewCount})</span>
-          </div>
-        ) : null}
-
-        {/* Price */}
-        {isVariable ? (
-          <VariantPriceRange product={product} />
-        ) : (
-          <PriceDisplay
-            price={display.price ?? originalPrice}
-            salePrice={display.salePrice ?? (isOnSale ? price : undefined)}
-            currency={display.currency}
-            size="sm"
-          />
-        )}
-
-        {/* Stock */}
-        <StockBadge inventory={product.inventory} />
-      </div>
-    </Card>
-  );
-}
+'use client';
+
+import { useState } from 'react';
+import { Check, Image as ImageIcon, Plus, ShoppingCart, Star } from 'lucide-react';
+import { Link, useRouter } from '@/core/lib/navigation';
+import { CdnImage as Image } from '@/ui/shared/cdn-image';
+import type { Product } from 'brainerce';
+import { getProductPriceInfo, formatPrice } from 'brainerce';
+import { pickDisplayPrice, pickDisplayPriceRange } from '@/core/lib/display-price';
+import { useTranslations } from '@/core/lib/translations';
+import { PriceDisplay } from '@/ui/product/price-display';
+import { StockBadge } from '@/ui/product/stock-badge';
+import { canPurchaseProduct } from '@/core/lib/kit';
+import { DiscountBadge } from '@/ui/product/discount-badge';
+import { Badge } from '@/components/ui/badge';
+import { Button } from '@/components/ui/button';
+import { Card } from '@/components/ui/card';
+import { useCart } from '@/core/providers/store-provider';
+import { useCurrency } from '@/core/lib/use-currency';
+import { trackAddToCart } from '@/core/lib/tracking';
+import { cn } from '@/core/lib/utils';
+
+interface ProductCardProps {
+  product: Product;
+  className?: string;
+}
+
+function VariantPriceRange({ product }: { product: Product }) {
+  const fallbackCurrency = useCurrency();
+  // ⛔ Region-aware. A range built from priceMin/priceMax alone stays in the
+  // store currency while the single-price card beside it converts, so a
+  // variable product would quote a different currency from its neighbours.
+  const range = pickDisplayPriceRange(product, fallbackCurrency);
+  if (!range) return null;
+  const { min, max, currency } = range;
+
+  return (
+    <span className="text-foreground text-sm font-medium">
+      {min === max
+        ? (formatPrice(min, { currency }) as string)
+        : `${formatPrice(min, { currency })} – ${formatPrice(max, { currency })}`}
+    </span>
+  );
+}
+
+export function ProductCard({ product, className }: ProductCardProps) {
+  const t = useTranslations('common');
+  const tp = useTranslations('productDetail');
+  const tProd = useTranslations('products');
+  const tr = useTranslations('reviews');
+  const router = useRouter();
+  const { refreshCart } = useCart();
+  const fallbackCurrency = useCurrency();
+  // FX overlay (PRD §23): prefer the region-converted display values when the
+  // storefront passed regionId to getProducts. Otherwise fall back to the
+  // canonical store-currency basePrice / salePrice.
+  const display = pickDisplayPrice(product, fallbackCurrency);
+  const { price, originalPrice, isOnSale } = getProductPriceInfo(product);
+  const mainImage = product.images?.[0];
+  const imageUrl = mainImage?.url || null;
+  const slug = product.slug || product.id;
+  const isVariable = product.type === 'VARIABLE';
+
+  const [adding, setAdding] = useState(false);
+  const [added, setAdded] = useState(false);
+
+  // ⛔ A KIT carries NO `inventory` object — its stock is on `kitAvailable`
+  // (`null` = unlimited, `0` = not sellable). Reading `inventory` here left a
+  // SOLD-OUT kit with an enabled add-to-cart button, because
+  // `undefined?.canPurchase !== false` is `true`. `canPurchaseProduct` reads
+  // the right field per product type, and keeps the `!== false` rule so a store
+  // that tracks no inventory at all can still sell.
+  // A kit also falls through `isVariable` above and adds by `productId` alone,
+  // which is correct — kits take no variantId and no selections.
+  const canPurchase = canPurchaseProduct(product);
+
+  async function handleAddToCart(e: React.MouseEvent) {
+    e.preventDefault();
+    e.stopPropagation();
+
+    if (isVariable) {
+      router.push(`/products/${slug}`);
+      return;
+    }
+
+    if (adding || !canPurchase) return;
+
+    try {
+      setAdding(true);
+      const { getClient } = await import('@/core/lib/brainerce');
+      const client = getClient();
+      await client.smartAddToCart({ productId: product.id, quantity: 1 });
+      await refreshCart();
+      // Quick-add from a grid card is a real add_to_cart — without this the
+      // ad platforms only ever see adds made from a product page. Reported in
+      // the DISPLAYED currency (region-converted when the storefront passed a
+      // regionId), because that is what the shopper is actually being charged.
+      trackAddToCart(product, null, 1, display.salePrice ?? display.price, display.currency);
+      setAdded(true);
+      setTimeout(() => setAdded(false), 2000);
+    } catch (err) {
+      console.error('Failed to add to cart:', err);
+    } finally {
+      setAdding(false);
+    }
+  }
+
+  return (
+    <Card
+      className={cn(
+        'group block overflow-hidden shadow-none transition-shadow hover:shadow-md',
+        className
+      )}
+    >
+      {/* Image — clickable */}
+      <Link href={`/products/${slug}`} className="block">
+        <div className="bg-muted relative aspect-square overflow-hidden">
+          {imageUrl ? (
+            <Image
+              src={imageUrl}
+              alt={mainImage?.alt || product.name}
+              fill
+              sizes="(max-width: 640px) 100vw, (max-width: 1024px) 50vw, 25vw"
+              className="object-cover transition-transform duration-300 group-hover:scale-105"
+            />
+          ) : (
+            <div className="text-muted-foreground absolute inset-0 flex items-center justify-center">
+              <ImageIcon className="h-12 w-12" strokeWidth={1.5} aria-hidden="true" />
+            </div>
+          )}
+
+          {/* Badges */}
+          <div className="absolute start-2 top-2 flex flex-col items-start gap-1">
+            {isOnSale && (
+              <Badge variant="destructive" className="rounded px-2 py-1 font-bold">
+                {t('sale')}
+              </Badge>
+            )}
+            <DiscountBadge discount={product.discount} />
+            {product.isDownloadable && (
+              <Badge className="rounded px-2 py-1 font-bold">{tp('digitalProduct')}</Badge>
+            )}
+          </div>
+
+          {/* Add to cart overlay button */}
+          {(isVariable || canPurchase) && (
+            <Button
+              size="icon"
+              onClick={handleAddToCart}
+              disabled={adding}
+              aria-label={isVariable ? tProd('selectOptions') : tp('addToCart')}
+              className={cn(
+                'absolute bottom-2 end-2 h-8 w-8 rounded-full shadow-md transition-all',
+                'translate-y-2 opacity-0 group-hover:translate-y-0 group-hover:opacity-100',
+                added && 'bg-green-500 text-white hover:bg-green-500'
+              )}
+            >
+              {added ? (
+                <Check strokeWidth={2.5} aria-hidden="true" />
+              ) : isVariable ? (
+                <Plus aria-hidden="true" />
+              ) : (
+                <ShoppingCart aria-hidden="true" />
+              )}
+            </Button>
+          )}
+        </div>
+      </Link>
+
+      {/* Content */}
+      <div className="space-y-2 p-3">
+        {/* Categories */}
+        {product.categories && product.categories.length > 0 && (
+          <div className="flex flex-wrap gap-1">
+            {product.categories.slice(0, 2).map((cat) => (
+              <Badge
+                key={cat.id}
+                variant="secondary"
+                className="text-muted-foreground bg-muted rounded px-1.5 py-0.5 text-[10px] font-normal"
+              >
+                {cat.name}
+              </Badge>
+            ))}
+          </div>
+        )}
+
+        {/* Name — clickable */}
+        <Link href={`/products/${slug}`}>
+          <h3 className="text-foreground hover:text-primary line-clamp-2 text-sm font-medium transition-colors">
+            {product.name}
+          </h3>
+        </Link>
+
+        {/* Star rating. `avgRating` / `reviewCount` are denormalized rollups
+            the API returns on every product fetch. Auto-hides on a store with
+            no reviews yet: `reviewCount` is 0 (or absent) and the whole block
+            is skipped, so nothing renders and the card keeps its layout. */}
+        {product.reviewCount ? (
+          <div className="flex items-center gap-1" aria-label={tr('starRating')}>
+            <Star className="h-3.5 w-3.5 fill-amber-400 text-amber-400" aria-hidden="true" />
+            <span className="text-foreground text-xs font-medium">
+              {(product.avgRating ?? 0).toFixed(1)}
+            </span>
+            <span className="text-muted-foreground text-xs">({product.reviewCount})</span>
+          </div>
+        ) : null}
+
+        {/* Price */}
+        {isVariable ? (
+          <VariantPriceRange product={product} />
+        ) : (
+          <PriceDisplay
+            price={display.price ?? originalPrice}
+            salePrice={display.salePrice ?? (isOnSale ? price : undefined)}
+            currency={display.currency}
+            size="sm"
+          />
+        )}
+
+        {/* Stock */}
+        <StockBadge
+          inventory={product.inventory}
+          // Only a KIT has kit stock. Gating on `type` here keeps the badge and
+          // `resolveStockInfo()` using ONE definition of 'this is a kit'.
+          kitAvailable={product.type === 'KIT' ? product.kitAvailable : undefined}
+        />
+      </div>
+    </Card>
+  );
+}