create-brainerce-store 1.72.0 → 1.73.0

package/templates/nextjs/base/src/components/account/order-status-timeline.tsx

@@ -1,85 +1,85 @@
-'use client';
-
-import type { Order, OrderStatus } from 'brainerce';
-import { useTranslations } from '@/core/lib/translations';
-import { cn } from '@/core/lib/utils';
-
-/**
- * Message key for every order status the API can return.
- *
- * The API sends these values UPPERCASE and verbatim (`PENDING`, `ON_HOLD`,
- * ...). Never lowercase them before the lookup: a lowercase key silently
- * misses and every row falls through to the default label.
- */
-export type OrderStatusLabelKey =
-  | 'statusDraft'
-  | 'statusPending'
-  | 'statusProcessing'
-  | 'statusOnHold'
-  | 'statusPaid'
-  | 'statusShipped'
-  | 'statusDelivered'
-  | 'statusCompleted'
-  | 'statusFulfilled'
-  | 'statusCancelled'
-  | 'statusRefunded'
-  | 'statusPartiallyRefunded';
-
-export const ORDER_STATUS_LABEL_KEYS: Record<OrderStatus, OrderStatusLabelKey> = {
-  DRAFT: 'statusDraft',
-  PENDING: 'statusPending',
-  PROCESSING: 'statusProcessing',
-  ON_HOLD: 'statusOnHold',
-  PAID: 'statusPaid',
-  SHIPPED: 'statusShipped',
-  DELIVERED: 'statusDelivered',
-  COMPLETED: 'statusCompleted',
-  FULFILLED: 'statusFulfilled',
-  CANCELLED: 'statusCancelled',
-  REFUNDED: 'statusRefunded',
-  PARTIALLY_REFUNDED: 'statusPartiallyRefunded',
-};
-
-interface OrderStatusTimelineProps {
-  history: Order['statusHistory'];
-  className?: string;
-}
-
-export function OrderStatusTimeline({ history, className }: OrderStatusTimelineProps) {
-  const t = useTranslations('account');
-  if (!history || history.length === 0) return null;
-
-  return (
-    <div className={cn('border-border border-t pt-2', className)}>
-      <p className="text-foreground mb-2 text-sm font-medium">{t('statusTimeline')}</p>
-      <ol className="space-y-1.5">
-        {history.map((entry, idx) => {
-          const key = ORDER_STATUS_LABEL_KEYS[entry.status] || 'statusPending';
-          const when = new Date(entry.at);
-          const whenStr = isNaN(when.getTime())
-            ? entry.at
-            : when.toLocaleString(undefined, {
-                year: 'numeric',
-                month: 'short',
-                day: 'numeric',
-                hour: '2-digit',
-                minute: '2-digit',
-              });
-          return (
-            <li key={`${entry.status}-${idx}`} className="flex items-center gap-2 text-xs">
-              <span
-                className={cn(
-                  'bg-primary inline-block h-2 w-2 flex-shrink-0 rounded-full',
-                  idx === history.length - 1 ? 'opacity-100' : 'opacity-60'
-                )}
-              />
-              <span className="text-foreground font-medium">{t(key)}</span>
-              <span className="text-muted-foreground">· {whenStr}</span>
-              {entry.note && <span className="text-muted-foreground truncate">({entry.note})</span>}
-            </li>
-          );
-        })}
-      </ol>
-    </div>
-  );
-}
+'use client';
+
+import type { Order, OrderStatus } from 'brainerce';
+import { useTranslations } from '@/core/lib/translations';
+import { cn } from '@/core/lib/utils';
+
+/**
+ * Message key for every order status the API can return.
+ *
+ * The API sends these values UPPERCASE and verbatim (`PENDING`, `ON_HOLD`,
+ * ...). Never lowercase them before the lookup: a lowercase key silently
+ * misses and every row falls through to the default label.
+ */
+export type OrderStatusLabelKey =
+  | 'statusDraft'
+  | 'statusPending'
+  | 'statusProcessing'
+  | 'statusOnHold'
+  | 'statusPaid'
+  | 'statusShipped'
+  | 'statusDelivered'
+  | 'statusCompleted'
+  | 'statusFulfilled'
+  | 'statusCancelled'
+  | 'statusRefunded'
+  | 'statusPartiallyRefunded';
+
+export const ORDER_STATUS_LABEL_KEYS: Record<OrderStatus, OrderStatusLabelKey> = {
+  DRAFT: 'statusDraft',
+  PENDING: 'statusPending',
+  PROCESSING: 'statusProcessing',
+  ON_HOLD: 'statusOnHold',
+  PAID: 'statusPaid',
+  SHIPPED: 'statusShipped',
+  DELIVERED: 'statusDelivered',
+  COMPLETED: 'statusCompleted',
+  FULFILLED: 'statusFulfilled',
+  CANCELLED: 'statusCancelled',
+  REFUNDED: 'statusRefunded',
+  PARTIALLY_REFUNDED: 'statusPartiallyRefunded',
+};
+
+interface OrderStatusTimelineProps {
+  history: Order['statusHistory'];
+  className?: string;
+}
+
+export function OrderStatusTimeline({ history, className }: OrderStatusTimelineProps) {
+  const t = useTranslations('account');
+  if (!history || history.length === 0) return null;
+
+  return (
+    <div className={cn('border-border border-t pt-2', className)}>
+      <p className="text-foreground mb-2 text-sm font-medium">{t('statusTimeline')}</p>
+      <ol className="space-y-1.5">
+        {history.map((entry, idx) => {
+          const key = ORDER_STATUS_LABEL_KEYS[entry.status] || 'statusPending';
+          const when = new Date(entry.at);
+          const whenStr = isNaN(when.getTime())
+            ? entry.at
+            : when.toLocaleString(undefined, {
+                year: 'numeric',
+                month: 'short',
+                day: 'numeric',
+                hour: '2-digit',
+                minute: '2-digit',
+              });
+          return (
+            <li key={`${entry.status}-${idx}`} className="flex items-center gap-2 text-xs">
+              <span
+                className={cn(
+                  'bg-primary inline-block h-2 w-2 flex-shrink-0 rounded-full',
+                  idx === history.length - 1 ? 'opacity-100' : 'opacity-60'
+                )}
+              />
+              <span className="text-foreground font-medium">{t(key)}</span>
+              <span className="text-muted-foreground">· {whenStr}</span>
+              {entry.note && <span className="text-muted-foreground truncate">({entry.note})</span>}
+            </li>
+          );
+        })}
+      </ol>
+    </div>
+  );
+}

package/templates/nextjs/base/src/core/hooks/use-cart-page.ts

@@ -1,127 +1,127 @@
-'use client';
-
-import { useCallback, useEffect, useRef, useState } from 'react';
-import type {
-  Cart,
-  CartItem,
-  CartRecommendationsResponse,
-  CartUpgradesResponse,
-  CartBundlesResponse,
-} from 'brainerce';
-import { getClient } from '@/core/lib/brainerce';
-import { useCart } from '@/core/providers/store-provider';
-
-export interface UseCartPageResult {
-  cart: Cart | null;
-  cartLoading: boolean;
-  refreshCart: () => Promise<void>;
-  itemCount: number;
-  /** Cross-sell recommendations for the current cart contents. */
-  cartRecs: CartRecommendationsResponse | null;
-  /** Per-item upgrade suggestions keyed by productId. */
-  upgrades: CartUpgradesResponse | null;
-  /** Bundle offers matching the current cart. */
-  bundles: CartBundlesResponse | null;
-  /**
-   * True once the stock reservation on this cart has run out and the refreshed
-   * cart still carries the same expired window. Goes back to false on its own
-   * if the server hands back a fresh reservation.
-   */
-  reservationExpired: boolean;
-  /** Lines the server says cannot be bought right now (`isAvailable === false`). */
-  unavailableItems: CartItem[];
-  /**
-   * False while the reservation is expired or any line is unavailable. The
-   * proceed-to-checkout action must be genuinely disabled on false, not just
-   * styled as disabled.
-   */
-  canProceedToCheckout: boolean;
-  /**
-   * Hand this to `<ReservationCountdown onExpire={...}>`. It refreshes the
-   * cart once per expiry window: the server, not the client timer, decides
-   * what is still purchasable.
-   */
-  onReservationExpired: () => void;
-}
-
-/**
- * Cart-page behavior: the shared cart state (from StoreProvider) plus the
- * enrichment fetch (recommendations / upgrades / bundles) that runs whenever
- * the cart contents change. Pure data/behavior — rendering lives in
- * `ui/cart/cart-view.tsx`.
- */
-export function useCartPage(): UseCartPageResult {
-  const { cart, cartLoading, refreshCart, itemCount } = useCart();
-  const [cartRecs, setCartRecs] = useState<CartRecommendationsResponse | null>(null);
-  const [upgrades, setUpgrades] = useState<CartUpgradesResponse | null>(null);
-  const [bundles, setBundles] = useState<CartBundlesResponse | null>(null);
-
-  // Load recommendations, upgrades, and bundles in a single request
-  useEffect(() => {
-    if (!cart?.id || cart.items.length === 0) {
-      setCartRecs(null);
-      setUpgrades(null);
-      setBundles(null);
-      return;
-    }
-    const client = getClient();
-    client
-      .getCart(cart.id, { include: ['recommendations', 'upgrades', 'bundles'] })
-      .then((enriched) => {
-        setCartRecs(enriched.recommendations ?? null);
-        setUpgrades(enriched.upgrades ?? null);
-        setBundles(enriched.bundles ?? null);
-      })
-      .catch(() => {});
-  }, [cart?.id, cart?.items.length]);
-
-  // ---- Reservation expiry ----
-  //
-  // The countdown component only ticks. Expiry is handled here, once, so all
-  // three design variants share one behaviour and a user redesigning the
-  // countdown cannot delete the gate along with the markup.
-  //
-  // Both pieces of state key on the reservation's `expiresAt`, which is the
-  // only stable identity a reservation window has:
-  //  - `handledExpiryRef` stops the refresh loop (refresh remounts the
-  //    countdown, which would otherwise report the same expiry again).
-  //  - comparing `expiredWindow` to the CURRENT `expiresAt` means a server
-  //    that renews the reservation clears the expired state by itself.
-  const reservationExpiresAt = cart?.reservation?.expiresAt ?? null;
-  const handledExpiryRef = useRef<string | null>(null);
-  const [expiredWindow, setExpiredWindow] = useState<string | null>(null);
-
-  const onReservationExpired = useCallback(() => {
-    if (!reservationExpiresAt) return;
-    setExpiredWindow(reservationExpiresAt);
-    if (handledExpiryRef.current === reservationExpiresAt) return;
-    handledExpiryRef.current = reservationExpiresAt;
-    // Re-read from the server: it is the source of truth for what survived
-    // the released reservation. `isAvailable` on each line comes back updated.
-    void refreshCart();
-  }, [reservationExpiresAt, refreshCart]);
-
-  const reservationExpired =
-    expiredWindow !== null &&
-    expiredWindow === reservationExpiresAt &&
-    cart?.reservation?.hasReservation === true;
-
-  const unavailableItems = cart?.items.filter((item) => item.isAvailable === false) ?? [];
-
-  const canProceedToCheckout =
-    !!cart && cart.items.length > 0 && !reservationExpired && unavailableItems.length === 0;
-
-  return {
-    cart,
-    cartLoading,
-    refreshCart,
-    itemCount,
-    cartRecs,
-    upgrades,
-    bundles,
-    reservationExpired,
-    unavailableItems,
-    canProceedToCheckout,
-    onReservationExpired,
-  };
-}
+'use client';
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+import type {
+  Cart,
+  CartItem,
+  CartRecommendationsResponse,
+  CartUpgradesResponse,
+  CartBundlesResponse,
+} from 'brainerce';
+import { getClient } from '@/core/lib/brainerce';
+import { useCart } from '@/core/providers/store-provider';
+
+export interface UseCartPageResult {
+  cart: Cart | null;
+  cartLoading: boolean;
+  refreshCart: () => Promise<void>;
+  itemCount: number;
+  /** Cross-sell recommendations for the current cart contents. */
+  cartRecs: CartRecommendationsResponse | null;
+  /** Per-item upgrade suggestions keyed by productId. */
+  upgrades: CartUpgradesResponse | null;
+  /** Bundle offers matching the current cart. */
+  bundles: CartBundlesResponse | null;
+  /**
+   * True once the stock reservation on this cart has run out and the refreshed
+   * cart still carries the same expired window. Goes back to false on its own
+   * if the server hands back a fresh reservation.
+   */
+  reservationExpired: boolean;
+  /** Lines the server says cannot be bought right now (`isAvailable === false`). */
+  unavailableItems: CartItem[];
+  /**
+   * False while the reservation is expired or any line is unavailable. The
+   * proceed-to-checkout action must be genuinely disabled on false, not just
+   * styled as disabled.
+   */
+  canProceedToCheckout: boolean;
+  /**
+   * Hand this to `<ReservationCountdown onExpire={...}>`. It refreshes the
+   * cart once per expiry window: the server, not the client timer, decides
+   * what is still purchasable.
+   */
+  onReservationExpired: () => void;
+}
+
+/**
+ * Cart-page behavior: the shared cart state (from StoreProvider) plus the
+ * enrichment fetch (recommendations / upgrades / bundles) that runs whenever
+ * the cart contents change. Pure data/behavior — rendering lives in
+ * `ui/cart/cart-view.tsx`.
+ */
+export function useCartPage(): UseCartPageResult {
+  const { cart, cartLoading, refreshCart, itemCount } = useCart();
+  const [cartRecs, setCartRecs] = useState<CartRecommendationsResponse | null>(null);
+  const [upgrades, setUpgrades] = useState<CartUpgradesResponse | null>(null);
+  const [bundles, setBundles] = useState<CartBundlesResponse | null>(null);
+
+  // Load recommendations, upgrades, and bundles in a single request
+  useEffect(() => {
+    if (!cart?.id || cart.items.length === 0) {
+      setCartRecs(null);
+      setUpgrades(null);
+      setBundles(null);
+      return;
+    }
+    const client = getClient();
+    client
+      .getCart(cart.id, { include: ['recommendations', 'upgrades', 'bundles'] })
+      .then((enriched) => {
+        setCartRecs(enriched.recommendations ?? null);
+        setUpgrades(enriched.upgrades ?? null);
+        setBundles(enriched.bundles ?? null);
+      })
+      .catch(() => {});
+  }, [cart?.id, cart?.items.length]);
+
+  // ---- Reservation expiry ----
+  //
+  // The countdown component only ticks. Expiry is handled here, once, so all
+  // three design variants share one behaviour and a user redesigning the
+  // countdown cannot delete the gate along with the markup.
+  //
+  // Both pieces of state key on the reservation's `expiresAt`, which is the
+  // only stable identity a reservation window has:
+  //  - `handledExpiryRef` stops the refresh loop (refresh remounts the
+  //    countdown, which would otherwise report the same expiry again).
+  //  - comparing `expiredWindow` to the CURRENT `expiresAt` means a server
+  //    that renews the reservation clears the expired state by itself.
+  const reservationExpiresAt = cart?.reservation?.expiresAt ?? null;
+  const handledExpiryRef = useRef<string | null>(null);
+  const [expiredWindow, setExpiredWindow] = useState<string | null>(null);
+
+  const onReservationExpired = useCallback(() => {
+    if (!reservationExpiresAt) return;
+    setExpiredWindow(reservationExpiresAt);
+    if (handledExpiryRef.current === reservationExpiresAt) return;
+    handledExpiryRef.current = reservationExpiresAt;
+    // Re-read from the server: it is the source of truth for what survived
+    // the released reservation. `isAvailable` on each line comes back updated.
+    void refreshCart();
+  }, [reservationExpiresAt, refreshCart]);
+
+  const reservationExpired =
+    expiredWindow !== null &&
+    expiredWindow === reservationExpiresAt &&
+    cart?.reservation?.hasReservation === true;
+
+  const unavailableItems = cart?.items.filter((item) => item.isAvailable === false) ?? [];
+
+  const canProceedToCheckout =
+    !!cart && cart.items.length > 0 && !reservationExpired && unavailableItems.length === 0;
+
+  return {
+    cart,
+    cartLoading,
+    refreshCart,
+    itemCount,
+    cartRecs,
+    upgrades,
+    bundles,
+    reservationExpired,
+    unavailableItems,
+    canProceedToCheckout,
+    onReservationExpired,
+  };
+}