create-brainerce-store 1.72.0 → 1.74.0

package/templates/nextjs/base/src/ui/cart/cart-view.tsx

@@ -1,176 +1,219 @@
-'use client';
-
-import { ShoppingBag } from 'lucide-react';
-import { Link } from '@/core/lib/navigation';
-import { useCartPage } from '@/core/hooks/use-cart-page';
-import { CartItem } from '@/ui/cart/cart-item';
-import { CartUpgradeBanner } from '@/ui/cart/cart-upgrade-banner';
-import { CartBundleOfferCard } from '@/ui/cart/cart-bundle-offer';
-import { CartSummary } from '@/ui/cart/cart-summary';
-import { CouponInput } from '@/ui/cart/coupon-input';
-import { CartNudges } from '@/ui/cart/cart-nudges';
-import { FreeShippingBar } from '@/ui/cart/free-shipping-bar';
-import { ReservationCountdown } from '@/ui/cart/reservation-countdown';
-import { CartRecommendationSection } from '@/ui/product/recommendation-section';
-import { LoadingSpinner } from '@/ui/shared/loading-spinner';
-import { Button } from '@/components/ui/button';
-import { Card } from '@/components/ui/card';
-import { Separator } from '@/components/ui/separator';
-import { useTranslations } from '@/core/lib/translations';
-
-export function CartView() {
-  const t = useTranslations('cart');
-  const tc = useTranslations('common');
-  const tr = useTranslations('reservation');
-  const {
-    cart,
-    cartLoading,
-    refreshCart,
-    itemCount,
-    cartRecs,
-    upgrades,
-    bundles,
-    reservationExpired,
-    unavailableItems,
-    canProceedToCheckout,
-    onReservationExpired,
-  } = useCartPage();
-
-  if (cartLoading) {
-    return (
-      <div className="flex min-h-[60vh] items-center justify-center">
-        <LoadingSpinner size="lg" />
-      </div>
-    );
-  }
-
-  // Empty cart state
-  if (!cart || cart.items.length === 0) {
-    return (
-      <div className="mx-auto max-w-7xl px-4 py-16 text-center sm:px-6 lg:px-8">
-        <ShoppingBag
-          className="text-muted-foreground mx-auto mb-4 h-16 w-16"
-          strokeWidth={1.5}
-          aria-hidden="true"
-        />
-        <h1 className="text-foreground text-2xl font-bold">{t('emptyTitle')}</h1>
-        <p className="text-muted-foreground mt-2">{t('emptySubtitle')}</p>
-        <Button asChild size="lg" className="mt-6 rounded px-6 text-base">
-          <Link href="/products">{tc('continueShopping')}</Link>
-        </Button>
-      </div>
-    );
-  }
-
-  return (
-    <div className="mx-auto max-w-7xl px-4 py-8 sm:px-6 lg:px-8">
-      <h1 className="text-foreground mb-6 text-2xl font-bold">
-        {t('title')} ({itemCount} {itemCount === 1 ? tc('item') : tc('items')})
-      </h1>
-
-      {/* Reservation countdown. onExpire refreshes the cart and closes the
-          checkout gate below. Passing it is what makes expiry mean anything. */}
-      {cart.reservation?.hasReservation && (
-        <ReservationCountdown
-          reservation={cart.reservation}
-          onExpire={onReservationExpired}
-          className="mb-6"
-        />
-      )}
-
-      <div className="grid grid-cols-1 gap-8 lg:grid-cols-3">
-        {/* Cart Items */}
-        <div className="lg:col-span-2">
-          {/* Nudges */}
-          {cart.nudges && cart.nudges.length > 0 && (
-            <CartNudges nudges={cart.nudges} className="mb-4" />
-          )}
-
-          {/* Cart items */}
-          <div>
-            {cart.items.map((item) => (
-              <div key={item.id}>
-                <CartItem item={item} onUpdate={refreshCart} />
-                {upgrades?.upgrades?.[item.productId] && (
-                  <CartUpgradeBanner
-                    suggestion={upgrades.upgrades[item.productId]}
-                    cartItem={item}
-                    onUpgrade={refreshCart}
-                    className="mb-2 ms-24"
-                  />
-                )}
-              </div>
-            ))}
-          </div>
-
-          {/* Bundle offers */}
-          {bundles?.bundles && bundles.bundles.length > 0 && (
-            <div className="mt-6 space-y-3">
-              <h3 className="text-foreground text-sm font-semibold">{t('bundleOffers')}</h3>
-              {bundles.bundles.map((offer) => (
-                <CartBundleOfferCard
-                  key={offer.id}
-                  offer={offer}
-                  cartId={cart.id}
-                  onAdd={refreshCart}
-                />
-              ))}
-            </div>
-          )}
-
-          {/* Coupon input */}
-          <Separator className="mt-6" />
-          <div className="pt-4">
-            <CouponInput cart={cart} onUpdate={refreshCart} />
-          </div>
-        </div>
-
-        {/* Summary sidebar */}
-        <div className="lg:col-span-1">
-          <Card className="bg-muted/50 sticky top-24 p-6 shadow-none">
-            <FreeShippingBar className="mb-4" />
-            <CartSummary />
-
-            {/* Proceed to checkout. When the gate is closed this must be a
-                real disabled control, never a styled-down link: an anchor
-                ignores `disabled` and would still navigate. */}
-            {canProceedToCheckout ? (
-              <Button asChild size="lg" className="mt-6 w-full rounded px-6 text-sm">
-                <Link href="/checkout">{t('proceedToCheckout')}</Link>
-              </Button>
-            ) : (
-              <>
-                <Button disabled size="lg" className="mt-6 w-full rounded px-6 text-sm">
-                  {t('proceedToCheckout')}
-                </Button>
-                <p className="text-destructive mt-2 text-xs">
-                  {unavailableItems.length > 0
-                    ? t('unavailableItemsHint')
-                    : reservationExpired
-                      ? tr('expiredHint')
-                      : null}
-                </p>
-              </>
-            )}
-
-            <Link
-              href="/products"
-              className="text-muted-foreground hover:text-foreground mt-3 inline-flex w-full items-center justify-center px-6 py-2 text-sm transition-colors"
-            >
-              {tc('continueShopping')}
-            </Link>
-          </Card>
-        </div>
-      </div>
-
-      {/* Cross-sell recommendations */}
-      {cartRecs?.recommendations && cartRecs.recommendations.length > 0 && (
-        <CartRecommendationSection
-          title={t('youMightAlsoNeed')}
-          items={cartRecs.recommendations}
-          className="mt-10"
-        />
-      )}
-    </div>
-  );
-}
+'use client';
+
+import { ShoppingBag } from 'lucide-react';
+import { Link } from '@/core/lib/navigation';
+import { useCartPage } from '@/core/hooks/use-cart-page';
+import { CartItem } from '@/ui/cart/cart-item';
+import { CartUpgradeBanner } from '@/ui/cart/cart-upgrade-banner';
+import { CartBundleOfferCard } from '@/ui/cart/cart-bundle-offer';
+import { CartSummary } from '@/ui/cart/cart-summary';
+import { CouponInput } from '@/ui/cart/coupon-input';
+import { CartNudges } from '@/ui/cart/cart-nudges';
+import { FreeShippingBar } from '@/ui/cart/free-shipping-bar';
+import { ReservationCountdown } from '@/ui/cart/reservation-countdown';
+import { CartRecommendationSection } from '@/ui/product/recommendation-section';
+import { LoadingSpinner } from '@/ui/shared/loading-spinner';
+import { Button } from '@/components/ui/button';
+import { Checkbox } from '@/components/ui/checkbox';
+import { Card } from '@/components/ui/card';
+import { Separator } from '@/components/ui/separator';
+import { useTranslations } from '@/core/lib/translations';
+
+export function CartView() {
+  const t = useTranslations('cart');
+  const tc = useTranslations('common');
+  const tr = useTranslations('reservation');
+  const {
+    cart,
+    cartLoading,
+    refreshCart,
+    itemCount,
+    cartRecs,
+    upgrades,
+    bundles,
+    reservationExpired,
+    unavailableItems,
+    selectedItemIds,
+    selectedItems,
+    toggleItemSelected,
+    allSelected,
+    setAllSelected,
+    checkoutHref,
+    canProceedToCheckout,
+    onReservationExpired,
+  } = useCartPage();
+
+  if (cartLoading) {
+    return (
+      <div className="flex min-h-[60vh] items-center justify-center">
+        <LoadingSpinner size="lg" />
+      </div>
+    );
+  }
+
+  // Empty cart state
+  if (!cart || cart.items.length === 0) {
+    return (
+      <div className="mx-auto max-w-7xl px-4 py-16 text-center sm:px-6 lg:px-8">
+        <ShoppingBag
+          className="text-muted-foreground mx-auto mb-4 h-16 w-16"
+          strokeWidth={1.5}
+          aria-hidden="true"
+        />
+        <h1 className="text-foreground text-2xl font-bold">{t('emptyTitle')}</h1>
+        <p className="text-muted-foreground mt-2">{t('emptySubtitle')}</p>
+        <Button asChild size="lg" className="mt-6 rounded px-6 text-base">
+          <Link href="/products">{tc('continueShopping')}</Link>
+        </Button>
+      </div>
+    );
+  }
+
+  return (
+    <div className="mx-auto max-w-7xl px-4 py-8 sm:px-6 lg:px-8">
+      <h1 className="text-foreground mb-6 text-2xl font-bold">
+        {t('title')} ({itemCount} {itemCount === 1 ? tc('item') : tc('items')})
+      </h1>
+
+      {/* Reservation countdown. onExpire refreshes the cart and closes the
+          checkout gate below. Passing it is what makes expiry mean anything. */}
+      {cart.reservation?.hasReservation && (
+        <ReservationCountdown
+          reservation={cart.reservation}
+          onExpire={onReservationExpired}
+          className="mb-6"
+        />
+      )}
+
+      <div className="grid grid-cols-1 gap-8 lg:grid-cols-3">
+        {/* Cart Items */}
+        <div className="lg:col-span-2">
+          {/* Nudges */}
+          {cart.nudges && cart.nudges.length > 0 && (
+            <CartNudges nudges={cart.nudges} className="mb-4" />
+          )}
+
+          {/* Select-all. Partial checkout: only the ticked lines are sent to
+              createCheckout, and whatever stays unticked is still in the cart
+              (and still for sale) after payment. */}
+          <div className="border-border mb-2 flex items-center gap-3 border-b pb-3">
+            <Checkbox
+              id="cart-select-all"
+              checked={allSelected}
+              onCheckedChange={(checked) => setAllSelected(checked === true)}
+            />
+            <label htmlFor="cart-select-all" className="text-foreground cursor-pointer text-sm">
+              {tc('all')}
+            </label>
+          </div>
+
+          {/* Cart items */}
+          <div>
+            {cart.items.map((item) => (
+              <div key={item.id}>
+                <div className="flex items-start gap-3">
+                  <Checkbox
+                    className="mt-6"
+                    checked={selectedItemIds.includes(item.id)}
+                    onCheckedChange={() => toggleItemSelected(item.id)}
+                    aria-label={item.product.name}
+                  />
+                  <CartItem item={item} onUpdate={refreshCart} className="flex-1" />
+                </div>
+                {upgrades?.upgrades?.[item.productId] && (
+                  <CartUpgradeBanner
+                    suggestion={upgrades.upgrades[item.productId]}
+                    cartItem={item}
+                    onUpgrade={refreshCart}
+                    className="mb-2 ms-24"
+                  />
+                )}
+              </div>
+            ))}
+          </div>
+
+          {/* Bundle offers */}
+          {bundles?.bundles && bundles.bundles.length > 0 && (
+            <div className="mt-6 space-y-3">
+              <h3 className="text-foreground text-sm font-semibold">{t('bundleOffers')}</h3>
+              {bundles.bundles.map((offer) => (
+                <CartBundleOfferCard
+                  key={offer.id}
+                  offer={offer}
+                  cartId={cart.id}
+                  onAdd={refreshCart}
+                />
+              ))}
+            </div>
+          )}
+
+          {/* Coupon input */}
+          <Separator className="mt-6" />
+          <div className="pt-4">
+            <CouponInput cart={cart} onUpdate={refreshCart} />
+          </div>
+        </div>
+
+        {/* Summary sidebar */}
+        <div className="lg:col-span-1">
+          <Card className="bg-muted/50 sticky top-24 p-6 shadow-none">
+            <FreeShippingBar className="mb-4" />
+            {/* Totals are for the WHOLE cart. A partial selection is priced
+                authoritatively on the checkout page, which is the only place
+                the server has scoped the discounts and tax to the subset. */}
+            <CartSummary />
+
+            {/* Shown once the shopper unticks anything. At zero selected this
+                is what explains the disabled button below — a count, so it
+                needs no copy of its own. */}
+            {!allSelected && (
+              <p className="text-muted-foreground mt-3 text-center text-xs">
+                {selectedItems.length} {selectedItems.length === 1 ? tc('item') : tc('items')}
+              </p>
+            )}
+
+            {/* Proceed to checkout. When the gate is closed this must be a
+                real disabled control, never a styled-down link: an anchor
+                ignores `disabled` and would still navigate. */}
+            {canProceedToCheckout ? (
+              <Button asChild size="lg" className="mt-6 w-full rounded px-6 text-sm">
+                {/* `checkoutHref` carries `?items=` only for a strict subset;
+                    a full cart links to a bare /checkout exactly as before. */}
+                <Link href={checkoutHref}>{t('proceedToCheckout')}</Link>
+              </Button>
+            ) : (
+              <>
+                <Button disabled size="lg" className="mt-6 w-full rounded px-6 text-sm">
+                  {t('proceedToCheckout')}
+                </Button>
+                <p className="text-destructive mt-2 text-xs">
+                  {unavailableItems.length > 0
+                    ? t('unavailableItemsHint')
+                    : reservationExpired
+                      ? tr('expiredHint')
+                      : null}
+                </p>
+              </>
+            )}
+
+            <Link
+              href="/products"
+              className="text-muted-foreground hover:text-foreground mt-3 inline-flex w-full items-center justify-center px-6 py-2 text-sm transition-colors"
+            >
+              {tc('continueShopping')}
+            </Link>
+          </Card>
+        </div>
+      </div>
+
+      {/* Cross-sell recommendations */}
+      {cartRecs?.recommendations && cartRecs.recommendations.length > 0 && (
+        <CartRecommendationSection
+          title={t('youMightAlsoNeed')}
+          items={cartRecs.recommendations}
+          className="mt-10"
+        />
+      )}
+    </div>
+  );
+}

package/templates/nextjs/base/src/ui/cart/gift-card-input.tsx

@@ -0,0 +1,191 @@
+'use client';
+
+import { useState } from 'react';
+import { Gift } from 'lucide-react';
+import type { Checkout } from 'brainerce';
+import { getClient } from '@/core/lib/brainerce';
+import { useTranslations } from '@/core/lib/translations';
+import { LoadingSpinner } from '@/ui/shared/loading-spinner';
+import { Button } from '@/components/ui/button';
+import { Input } from '@/components/ui/input';
+import { cn } from '@/core/lib/utils';
+
+interface GiftCardInputProps {
+  checkoutId: string;
+  /**
+   * Cards already on this checkout. Each is removed by its own tenderId.
+   *
+   * Derived from `Checkout` rather than written out, and deliberately NOT the
+   * `CheckoutTender` that `applyGiftCard` returns — that one carries a third
+   * field, `providerAmountDue`, because an apply response reports the new
+   * amount due alongside the tender it just created. Reading a checkout puts
+   * that figure at the top level instead, once, since it describes the whole
+   * checkout and not any single card. Naming the source type here keeps the two
+   * from being confused again.
+   */
+  tenders: NonNullable<Checkout['tenders']>;
+  /** Formats an amount in the checkout's currency. */
+  formatAmount: (value: string) => string;
+  onUpdate: () => void;
+  className?: string;
+}
+
+/**
+ * Redeem a gift card at checkout.
+ *
+ * ## A gift card is NOT a coupon
+ *
+ * This sits beside the coupon field and behaves nothing like it. A coupon
+ * reduces what the order is worth; a gift card pays for an order that is still
+ * worth what it was. The order total does not move, tax is unchanged, and what
+ * drops is only the amount the payment provider is charged.
+ *
+ * Rendering it as a discount would misstate the order to the shopper and, on a
+ * receipt, misstate the taxable base. That is why the applied card appears on
+ * its own line near the total rather than inside the discount row.
+ *
+ * ## Checkout only, despite living in `ui/cart/`
+ *
+ * It sits beside `coupon-input.tsx` because a shopper reaches for both in the
+ * same place — but a coupon has a cart-level call and a gift card does not.
+ * `applyGiftCard` needs a checkout, so `checkoutId` is a REQUIRED prop: the type
+ * system, not a convention, is what stops this being dropped onto a cart page.
+ *
+ * ## More than one card
+ *
+ * A checkout can carry several. Each is removed by its `tenderId`, never by the
+ * code — the code is bearer value and is not kept anywhere after it is applied.
+ *
+ * ## Refusals say one thing
+ *
+ * The server answers identically for "no such code", "expired", "already spent"
+ * and "wrong currency". That is deliberate: any response that distinguishes them
+ * is an oracle someone walks the code space against. Show what the server said;
+ * never guess a more specific reason.
+ */
+export function GiftCardInput({
+  checkoutId,
+  tenders,
+  formatAmount,
+  onUpdate,
+  className,
+}: GiftCardInputProps) {
+  const t = useTranslations('giftCard');
+  const tc = useTranslations('common');
+  const [code, setCode] = useState('');
+  const [applying, setApplying] = useState(false);
+  const [removingId, setRemovingId] = useState<string | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  async function handleApply() {
+    const trimmed = code.trim();
+    if (!trimmed || applying) return;
+
+    try {
+      setApplying(true);
+      setError(null);
+      await getClient().applyGiftCard(checkoutId, trimmed);
+      // Cleared on success only. A rejected code stays in the field so the
+      // shopper can fix a typo instead of re-reading it off the card.
+      setCode('');
+      onUpdate();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : t('invalidCode'));
+    } finally {
+      setApplying(false);
+    }
+  }
+
+  async function handleRemove(tenderId: string) {
+    if (removingId) return;
+    try {
+      setRemovingId(tenderId);
+      setError(null);
+      await getClient().removeGiftCard(checkoutId, tenderId);
+      onUpdate();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : t('removeFailed'));
+    } finally {
+      setRemovingId(null);
+    }
+  }
+
+  return (
+    <div className={cn('space-y-2', className)}>
+      {tenders.length > 0 && (
+        <ul className="space-y-2">
+          {tenders.map((tender) => (
+            <li
+              key={tender.tenderId}
+              className="bg-muted flex items-center justify-between rounded px-3 py-2"
+            >
+              <div className="flex min-w-0 items-center gap-2">
+                <Gift className="text-primary h-4 w-4 flex-shrink-0" aria-hidden="true" />
+                <span className="text-foreground truncate text-sm font-medium">
+                  {/* What was applied, not what the card holds. A ₪200 card on a
+                      ₪50 order applies ₪50 and keeps the rest for next time —
+                      showing the balance here would look like a lost ₪150. */}
+                  {t('applied', { amount: formatAmount(tender.amountApplied) })}
+                </span>
+              </div>
+              <button
+                type="button"
+                onClick={() => handleRemove(tender.tenderId)}
+                disabled={removingId === tender.tenderId}
+                className="text-destructive hover:text-destructive/80 text-xs transition-colors disabled:opacity-40"
+              >
+                {removingId === tender.tenderId ? tc('removing') : tc('remove')}
+              </button>
+            </li>
+          ))}
+        </ul>
+      )}
+
+      <div className="flex gap-2">
+        <Input
+          type="text"
+          value={code}
+          onChange={(e) => {
+            setCode(e.target.value);
+            if (error) setError(null);
+          }}
+          onKeyDown={(e) => {
+            if (e.key === 'Enter') {
+              e.preventDefault();
+              handleApply();
+            }
+          }}
+          placeholder={t('placeholder')}
+          aria-label={t('placeholder')}
+          aria-invalid={!!error}
+          // A gift card code is Latin and case-insensitive but the server
+          // normalises it, so the shopper may type it however it is printed.
+          // LTR because the code is Latin even on an RTL storefront.
+          dir="ltr"
+          autoComplete="off"
+          spellCheck={false}
+          className={cn('h-9 flex-1 rounded font-mono', error && 'border-destructive')}
+        />
+        <Button
+          type="button"
+          variant="outline"
+          onClick={handleApply}
+          disabled={applying || !code.trim()}
+          className="hover:bg-muted h-9 rounded px-4"
+        >
+          {applying ? (
+            <LoadingSpinner size="sm" className="border-muted-foreground/30 border-t-foreground" />
+          ) : (
+            tc('apply')
+          )}
+        </Button>
+      </div>
+
+      {error && (
+        <p role="alert" className="text-destructive text-xs">
+          {error}
+        </p>
+      )}
+    </div>
+  );
+}