create-brainerce-store 1.72.0 → 1.74.0

package/templates/nextjs/base/src/ui/cart/reservation-countdown.tsx

@@ -1,137 +1,137 @@
-'use client';
-
-import { useState, useEffect, useCallback, useRef } from 'react';
-import { Clock } from 'lucide-react';
-import type { ReservationInfo } from 'brainerce';
-import { useTranslations } from '@/core/lib/translations';
-import { cn } from '@/core/lib/utils';
-
-interface ReservationCountdownProps {
-  reservation: ReservationInfo;
-  /**
-   * Fired once per reservation window when the timer reaches zero, including
-   * when the page opens on an already-expired reservation. The handler is
-   * expected to refresh the cart and gate checkout: this component only
-   * displays, it never decides what is still purchasable. Wire it to
-   * `useCartPage().onReservationExpired`.
-   */
-  onExpire?: () => void;
-  className?: string;
-}
-
-export function ReservationCountdown({
-  reservation,
-  onExpire,
-  className,
-}: ReservationCountdownProps) {
-  const t = useTranslations('reservation');
-  // `null` means "not measured yet". Server-rendered HTML must not compute a
-  // time, or it disagrees with the client on hydration; starting at 0 instead
-  // would render the expired banner for one frame on a perfectly live
-  // reservation, and would fire onExpire on every mount.
-  const [remainingSeconds, setRemainingSeconds] = useState<number | null>(null);
-
-  const calculateRemaining = useCallback(() => {
-    if (!reservation.expiresAt) return 0;
-    const expiresAtMs = new Date(reservation.expiresAt).getTime();
-    const nowMs = Date.now();
-    return Math.max(0, Math.floor((expiresAtMs - nowMs) / 1000));
-  }, [reservation.expiresAt]);
-
-  // Report each expiry window at most once. Keyed on `expiresAt` rather than a
-  // boolean, so the cart refresh that expiry triggers (which remounts this
-  // component) cannot bounce straight back into a second report.
-  const expiresAt = reservation.expiresAt;
-  const reportedExpiryRef = useRef<string | null>(null);
-  const onExpireRef = useRef(onExpire);
-  // Kept in a ref, and synced in an effect rather than during render, so a
-  // caller passing an inline arrow does not restart the timer every render.
-  useEffect(() => {
-    onExpireRef.current = onExpire;
-  }, [onExpire]);
-
-  const reportExpired = useCallback(() => {
-    if (!expiresAt) return;
-    if (reportedExpiryRef.current === expiresAt) return;
-    reportedExpiryRef.current = expiresAt;
-    onExpireRef.current?.();
-  }, [expiresAt]);
-
-  useEffect(() => {
-    const initial = calculateRemaining();
-    setRemainingSeconds(initial);
-    if (initial <= 0) reportExpired();
-
-    const interval = setInterval(() => {
-      const remaining = calculateRemaining();
-      setRemainingSeconds(remaining);
-
-      if (remaining <= 0) {
-        clearInterval(interval);
-        reportExpired();
-      }
-    }, 1000);
-
-    return () => clearInterval(interval);
-  }, [calculateRemaining, reportExpired]);
-
-  if (!reservation.hasReservation) return null;
-
-  const displaySeconds = remainingSeconds ?? 0;
-  const minutes = Math.floor(displaySeconds / 60);
-  const seconds = displaySeconds % 60;
-  const isExpired = remainingSeconds !== null && remainingSeconds <= 0;
-  const isUrgent = displaySeconds > 0 && displaySeconds < 120;
-
-  const displayMessage = reservation.countdownMessage
-    ? reservation.countdownMessage.replace(
-        '{time}',
-        `${minutes}:${seconds.toString().padStart(2, '0')}`
-      )
-    : null;
-
-  return (
-    <div
-      className={cn(
-        'flex items-center gap-3 rounded-lg px-4 py-3 text-sm',
-        isExpired
-          ? 'bg-destructive/10 border-destructive/20 text-destructive border'
-          : isUrgent
-            ? 'border border-orange-200 bg-orange-50 text-orange-800 dark:border-orange-800 dark:bg-orange-950/30 dark:text-orange-300'
-            : 'bg-primary/5 border-primary/20 text-foreground border',
-        className
-      )}
-    >
-      <Clock
-        className={cn(
-          'h-5 w-5 flex-shrink-0',
-          isExpired
-            ? 'text-destructive'
-            : isUrgent
-              ? 'text-orange-600 dark:text-orange-400'
-              : 'text-primary'
-        )}
-        aria-hidden="true"
-      />
-
-      <div className="flex-1">
-        {isExpired ? (
-          <>
-            <p className="font-medium">{t('expired')}</p>
-            <p className="text-xs opacity-90">{t('expiredHint')}</p>
-          </>
-        ) : displayMessage ? (
-          <p>{displayMessage}</p>
-        ) : (
-          <p>
-            {isUrgent ? `${t('hurry')} ` : ''}
-            {t('reservedFor')}{' '}
-            <span className="font-semibold tabular-nums">
-              {minutes}:{seconds.toString().padStart(2, '0')}
-            </span>
-          </p>
-        )}
-      </div>
-    </div>
-  );
-}
+'use client';
+
+import { useState, useEffect, useCallback, useRef } from 'react';
+import { Clock } from 'lucide-react';
+import type { ReservationInfo } from 'brainerce';
+import { useTranslations } from '@/core/lib/translations';
+import { cn } from '@/core/lib/utils';
+
+interface ReservationCountdownProps {
+  reservation: ReservationInfo;
+  /**
+   * Fired once per reservation window when the timer reaches zero, including
+   * when the page opens on an already-expired reservation. The handler is
+   * expected to refresh the cart and gate checkout: this component only
+   * displays, it never decides what is still purchasable. Wire it to
+   * `useCartPage().onReservationExpired`.
+   */
+  onExpire?: () => void;
+  className?: string;
+}
+
+export function ReservationCountdown({
+  reservation,
+  onExpire,
+  className,
+}: ReservationCountdownProps) {
+  const t = useTranslations('reservation');
+  // `null` means "not measured yet". Server-rendered HTML must not compute a
+  // time, or it disagrees with the client on hydration; starting at 0 instead
+  // would render the expired banner for one frame on a perfectly live
+  // reservation, and would fire onExpire on every mount.
+  const [remainingSeconds, setRemainingSeconds] = useState<number | null>(null);
+
+  const calculateRemaining = useCallback(() => {
+    if (!reservation.expiresAt) return 0;
+    const expiresAtMs = new Date(reservation.expiresAt).getTime();
+    const nowMs = Date.now();
+    return Math.max(0, Math.floor((expiresAtMs - nowMs) / 1000));
+  }, [reservation.expiresAt]);
+
+  // Report each expiry window at most once. Keyed on `expiresAt` rather than a
+  // boolean, so the cart refresh that expiry triggers (which remounts this
+  // component) cannot bounce straight back into a second report.
+  const expiresAt = reservation.expiresAt;
+  const reportedExpiryRef = useRef<string | null>(null);
+  const onExpireRef = useRef(onExpire);
+  // Kept in a ref, and synced in an effect rather than during render, so a
+  // caller passing an inline arrow does not restart the timer every render.
+  useEffect(() => {
+    onExpireRef.current = onExpire;
+  }, [onExpire]);
+
+  const reportExpired = useCallback(() => {
+    if (!expiresAt) return;
+    if (reportedExpiryRef.current === expiresAt) return;
+    reportedExpiryRef.current = expiresAt;
+    onExpireRef.current?.();
+  }, [expiresAt]);
+
+  useEffect(() => {
+    const initial = calculateRemaining();
+    setRemainingSeconds(initial);
+    if (initial <= 0) reportExpired();
+
+    const interval = setInterval(() => {
+      const remaining = calculateRemaining();
+      setRemainingSeconds(remaining);
+
+      if (remaining <= 0) {
+        clearInterval(interval);
+        reportExpired();
+      }
+    }, 1000);
+
+    return () => clearInterval(interval);
+  }, [calculateRemaining, reportExpired]);
+
+  if (!reservation.hasReservation) return null;
+
+  const displaySeconds = remainingSeconds ?? 0;
+  const minutes = Math.floor(displaySeconds / 60);
+  const seconds = displaySeconds % 60;
+  const isExpired = remainingSeconds !== null && remainingSeconds <= 0;
+  const isUrgent = displaySeconds > 0 && displaySeconds < 120;
+
+  const displayMessage = reservation.countdownMessage
+    ? reservation.countdownMessage.replace(
+        '{time}',
+        `${minutes}:${seconds.toString().padStart(2, '0')}`
+      )
+    : null;
+
+  return (
+    <div
+      className={cn(
+        'flex items-center gap-3 rounded-lg px-4 py-3 text-sm',
+        isExpired
+          ? 'bg-destructive/10 border-destructive/20 text-destructive border'
+          : isUrgent
+            ? 'border border-orange-200 bg-orange-50 text-orange-800 dark:border-orange-800 dark:bg-orange-950/30 dark:text-orange-300'
+            : 'bg-primary/5 border-primary/20 text-foreground border',
+        className
+      )}
+    >
+      <Clock
+        className={cn(
+          'h-5 w-5 flex-shrink-0',
+          isExpired
+            ? 'text-destructive'
+            : isUrgent
+              ? 'text-orange-600 dark:text-orange-400'
+              : 'text-primary'
+        )}
+        aria-hidden="true"
+      />
+
+      <div className="flex-1">
+        {isExpired ? (
+          <>
+            <p className="font-medium">{t('expired')}</p>
+            <p className="text-xs opacity-90">{t('expiredHint')}</p>
+          </>
+        ) : displayMessage ? (
+          <p>{displayMessage}</p>
+        ) : (
+          <p>
+            {isUrgent ? `${t('hurry')} ` : ''}
+            {t('reservedFor')}{' '}
+            <span className="font-semibold tabular-nums">
+              {minutes}:{seconds.toString().padStart(2, '0')}
+            </span>
+          </p>
+        )}
+      </div>
+    </div>
+  );
+}

package/templates/nextjs/base/src/ui/cart/tax-estimate-line.tsx

@@ -0,0 +1,108 @@
+'use client';
+
+/**
+ * Non-binding tax preview for the cart.
+ *
+ * Shoppers in VAT markets expect a tax figure before they reach the address
+ * form, and "calculated at checkout" reads as an unpleasant surprise waiting
+ * to happen. `estimateTax` gives them a number early without pretending it is
+ * final.
+ *
+ * ⛔ NEVER PRESENT THIS AS THE REAL TAX. The authoritative calculation runs at
+ * checkout against the full shipping address. A preview has no province, so a
+ * Canadian estimate shows federal GST alone and the provincial PST/QST joins
+ * it at checkout. That is what `note` is for, and why the "calculated at
+ * checkout" caveat stays on the row even when a figure is showing.
+ *
+ * ⛔ NO ESTIMATE IS RENDERED when `appliesTax` is false, which is what an
+ * empty or freshly created store returns: tax is off, no country reached us,
+ * or no active rate covers it. In that case (and when the call fails, and
+ * while it is in flight, and on an empty cart) this falls back to EXACTLY the
+ * row the cart shipped with before the estimate existed: "Tax / calculated at
+ * checkout". There is no spinner, no error box, and no empty amount.
+ *
+ * `getStoreTaxClasses()` would let you add a separate "9% VAT" transparency
+ * badge, but `rateName` + `rate` already come back on this response and say
+ * the same thing, so a second request would buy nothing.
+ */
+
+import { useEffect, useState } from 'react';
+import type { TaxEstimateResponse } from 'brainerce';
+import { formatPrice } from 'brainerce';
+import { getClient } from '@/core/lib/brainerce';
+import { useTranslations } from '@/core/lib/translations';
+import { useCart, useRegion } from '@/core/providers/store-provider';
+
+export function useTaxEstimate(): TaxEstimateResponse | null {
+  const { totals } = useCart();
+  // The same country the region lookup already extracted from the edge. Asking
+  // for it twice would be two sources that can disagree.
+  const { buyerCountry } = useRegion();
+  const [estimate, setEstimate] = useState<TaxEstimateResponse | null>(null);
+  const subtotal = totals.subtotal;
+
+  useEffect(() => {
+    // An empty cart has nothing to tax. Skipping the call also keeps a
+    // brand-new store from firing a request on every page load forever.
+    if (!(subtotal > 0)) {
+      setEstimate(null);
+      return;
+    }
+    let cancelled = false;
+    getClient()
+      .estimateTax({ ...(buyerCountry ? { country: buyerCountry } : {}), subtotal })
+      .then((result) => {
+        if (!cancelled) setEstimate(result);
+      })
+      .catch(() => {
+        // Swallowed on purpose. A tax preview is a courtesy; it must never
+        // take the cart down with it. The caller falls back to the plain
+        // "calculated at checkout" row.
+        if (!cancelled) setEstimate(null);
+      });
+    return () => {
+      cancelled = true;
+    };
+  }, [subtotal, buyerCountry]);
+
+  return estimate;
+}
+
+export function TaxEstimateLine() {
+  const t = useTranslations('cart');
+  const tc = useTranslations('common');
+  const estimate = useTaxEstimate();
+
+  // No estimate: the row the cart has always shown.
+  if (!estimate || !estimate.appliesTax) {
+    return (
+      <div className="flex items-center justify-between">
+        <span className="text-muted-foreground">{tc('tax')}</span>
+        <span className="text-muted-foreground text-xs">{t('taxAtCheckout')}</span>
+      </div>
+    );
+  }
+
+  // `rateName` is one rate or several joined ("GST + QST"); `rate` is the
+  // summed effective percent and is null when no rule matched.
+  const label =
+    estimate.rateName && estimate.rate != null
+      ? `${estimate.rateName} ${estimate.rate}%`
+      : (estimate.rateName ?? tc('tax'));
+
+  return (
+    <div className="space-y-1">
+      <div className="flex items-center justify-between">
+        <span className="text-muted-foreground">{label}</span>
+        <span className="text-foreground font-medium">
+          {formatPrice(estimate.estimatedTax, { currency: estimate.currency }) as string}
+        </span>
+      </div>
+      {/* The caveat travels WITH the number, not in a footnote nobody reads. */}
+      <p className="text-muted-foreground text-xs">{t('taxAtCheckout')}</p>
+      {/* Server-written and already localized. Never replace it with copy of
+          your own, it is what explains a partial estimate. */}
+      {estimate.note ? <p className="text-muted-foreground text-xs">{estimate.note}</p> : null}
+    </div>
+  );
+}

package/templates/nextjs/base/src/ui/home/home-client.tsx

@@ -1,29 +1,27 @@
-'use client';
-
-import { useStoreInfo } from '@/core/providers/store-provider';
-import { useHomeData } from '@/core/hooks/use-home-data';
-import { LoadingSpinner } from '@/ui/shared/loading-spinner';
-import { DiscountBannerStrip } from './discount-banner-strip';
-import { HeroSection } from './hero-section';
-import { FeaturedProductsSection } from './featured-products-section';
-
-export function HomeClient() {
-  const { storeInfo, loading: storeLoading } = useStoreInfo();
-  const { products, banners, loading } = useHomeData();
-
-  if (storeLoading || loading) {
-    return (
-      <div className="flex min-h-[60vh] items-center justify-center">
-        <LoadingSpinner size="lg" />
-      </div>
-    );
-  }
-
-  return (
-    <div>
-      <DiscountBannerStrip banners={banners} />
-      <HeroSection storeName={storeInfo?.name} />
-      <FeaturedProductsSection products={products} />
-    </div>
-  );
-}
+'use client';
+
+import { useStoreInfo } from '@/core/providers/store-provider';
+import { useHomeData } from '@/core/hooks/use-home-data';
+import { LoadingSpinner } from '@/ui/shared/loading-spinner';
+import { HeroSection } from './hero-section';
+import { FeaturedProductsSection } from './featured-products-section';
+
+export function HomeClient() {
+  const { storeInfo, loading: storeLoading } = useStoreInfo();
+  const { products, loading } = useHomeData();
+
+  if (storeLoading || loading) {
+    return (
+      <div className="flex min-h-[60vh] items-center justify-center">
+        <LoadingSpinner size="lg" />
+      </div>
+    );
+  }
+
+  return (
+    <div>
+      <HeroSection storeName={storeInfo?.name} />
+      <FeaturedProductsSection products={products} />
+    </div>
+  );
+}