@mohasinac/appkit 4.11.1 → 4.11.3

package/dist/features/auctions/components/AuctionDetailPageView.js

@@ -9,8 +9,6 @@ const __P = {
 };
 const CLS_BREADCRUMB_LINK = "hover:text-primary-600 transition-colors";
 const CLS_LIVE_BADGE = "inline-block rounded-full bg-warning-surface dark:bg-warning-surface px-[var(--appkit-space-2-5)] py-[var(--appkit-space-0-5)] text-warning dark:text-warning";
-const CLS_STAR_ON = "text-warning";
-const CLS_STAR_OFF = "text-zinc-200 dark:text-zinc-700";
 import { ROUTES } from "../../../next";
 import { getDefaultCurrency } from "../../../core/baseline-resolver";
 import { formatCurrency } from "../../../utils/number.formatter";
@@ -30,7 +28,7 @@ import { FeatureBadgeList } from "../../products/components/FeatureBadge";
 import { HistoryTracker } from "../../history/components/HistoryTracker";
 import { ShareButton } from "../../products/components/ShareButton";
 import { MarketplaceAuctionGrid } from "./MarketplaceAuctionGrid";
-import { listReviewsBySeller } from "../../reviews/actions/review-actions";
+import { ReviewsListingPanel } from "../../reviews/components/ReviewsListingPanel";
 import { PlaceBidModalButton } from "./PlaceBidFormClient";
 import { CollapsibleBidHistory } from "./CollapsibleBidHistory";
 import { LiveBidPrice } from "./LiveBidPrice";
@@ -50,11 +48,18 @@ function renderAuctionInfoPanel(props) {
     const { productId, title, currentBid, currency, bidCount, isEnded, endDate, buyNowPrice, featured, freeShipping, condition, category, categoryName, brand, brandSlug, productFeatures, features, descriptionHtml, safeSeller, storeHref } = props;
     return (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_LIVE_BADGE, children: "\uD83C\uDFF7\uFE0F Live Auction" }), isEnded ? (_jsx(Span, { color: "error", surface: "danger-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Ended" })) : (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Active" }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), _jsxs(Div, { children: [_jsx(Text, { className: "mb-0.5", color: "muted", size: "xs", children: "Current bid" }), _jsx(LiveBidPrice, { productId: productId, currentBid: currentBid, bidCount: bidCount, currency: currency, isEnded: isEnded, priceSize: "2xl", badgeSize: "sm" }), endDate && !isEnded && (_jsxs(Text, { className: "mt-1.5", color: "muted", size: "sm", children: ["Ends in ", _jsx(Span, { weight: "medium", color: "muted", children: _jsx(CountdownDisplay, { targetDate: endDate, format: "auto", expiredLabel: "Ended" }) })] })), endDate && _jsxs(Text, { className: "mt-0.5", color: "faint", size: "xs", children: [isEnded ? "Ended" : "Ends", " ", endDate.toLocaleString()] })] }), buyNowPrice !== null && !isEnded && (_jsxs(Row, { align: "center", gap: "sm", className: "border border-[var(--appkit-color-primary-200)] dark:border-[var(--appkit-color-primary-800)] bg-primary-50 dark:bg-primary-900/20", padding: "inlineSm", rounded: "lg", children: [_jsx(Span, { size: "xs", color: "muted", children: "Buy Now:" }), _jsx(Span, { size: "base", weight: "bold", className: "text-primary-700 dark:text-primary-300", children: formatCurrency(buyNowPrice, currency) })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, labels: { featured: "Featured", fasterDelivery: "Faster Delivery", ratedSeller: "Rated Seller", condition: "Condition", conditionNew: "New", conditionUsed: "Used", conditionBroken: "For Parts", conditionRefurbished: "Refurbished", returnable: "Returnable", freeShipping: "Free Shipping", codAvailable: "Cash on Delivery", emiAvailable: "EMI Available", wishlistCount: (n) => `${n} wishlisted`, categoryProductCount: (n, cat) => `${n} in ${cat}` } }), (categoryName || category || brand) && (_jsxs(Row, { gap: "sm", wrap: true, children: [category && _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-50 hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:bg-primary-900/20 dark:hover:text-primary-400", children: categoryName || category }), !category && categoryName && _jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: categoryName }), brand && brandSlug && _jsx(Link, { href: String(ROUTES.PUBLIC.BRAND_DETAIL(brandSlug)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-50 hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:bg-primary-900/20 dark:hover:text-primary-400", children: brand }), brand && !brandSlug && _jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: brand })] })), productFeatures && features.length > 0 && _jsx(FeatureBadgeList, { productFeatureIds: features, features: productFeatures }), !productFeatures && features.length > 0 && (_jsxs(Div, { border: "subtle", surface: "muted", padding: "inline", rounded: "xl", children: [_jsx(Text, { className: "mb-2 tracking-wide", color: "muted", size: "xs", weight: "semibold", transform: "uppercase", children: "About this item" }), _jsx(Ul, { spacing: "comfortable", size: "sm", color: "primary", children: features.map((f, i) => _jsxs(Li, { layout: "flex-start", gap: "2", children: [_jsx(Span, { className: "mt-0.5 flex-shrink-0 text-primary-500", children: "\u2022" }), f] }, i)) })] })), descriptionHtml && _jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" }), safeSeller && (_jsx(Div, { className: `${__P.p3}`, border: "subtle", rounded: "xl", surface: "muted", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Listed by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && _jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" })] }) }))] }));
 }
-function renderAuctionStoreReviews(storeReviews) {
-    if (storeReviews.length === 0)
+/**
+ * Store reviews for the auction's seller.
+ *
+ * Was a bespoke `slice(0, 10)` block over `listReviewsBySeller()` — which concatenates
+ * per-product batches, so the "latest 10" it showed were in product order, not date
+ * order, and reviews 11+ were unreachable. `ReviewsListingPanel` pages the real
+ * store-reviews endpoint instead.
+ */
+function renderAuctionStoreReviews(storeSlug) {
+    if (!storeSlug)
         return null;
-    const avg = storeReviews.reduce((s, r) => s + r.rating, 0) / storeReviews.length;
-    return (_jsxs(Section, { className: "mt-10", children: [_jsx(Heading, { level: 2, className: "mb-2", color: "primary", size: "xl", weight: "semibold", children: "Store Reviews" }), _jsxs(Row, { className: "mb-4", align: "center", gap: "3", children: [_jsx(Span, { weight: "bold", size: "3xl", color: "primary", children: avg.toFixed(1) }), _jsxs(Div, { children: [_jsx(Row, { gap: "xs", children: [1, 2, 3, 4, 5].map((star) => _jsx(Span, { className: star <= Math.round(avg) ? CLS_STAR_ON : CLS_STAR_OFF, children: "\u2605" }, star)) }), _jsxs(Text, { size: "xs", color: "muted", children: [storeReviews.length, " review", storeReviews.length !== 1 ? "s" : ""] })] })] }), _jsx(Stack, { gap: "sm", children: storeReviews.slice(0, 10).map((review) => (_jsxs(Stack, { gap: "xs", surface: "card", padding: "sm", className: "", children: [_jsx(Row, { justify: "between", align: "center", children: _jsxs(Row, { gap: "xs", align: "center", children: [_jsx(Span, { size: "sm", weight: "medium", color: "primary", children: review.userName }), _jsx(Row, { gap: "xs", children: [1, 2, 3, 4, 5].map((star) => _jsx(Span, { size: "xs", className: star <= review.rating ? CLS_STAR_ON : CLS_STAR_OFF, children: "\u2605" }, star)) })] }) }), review.title && _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: review.title }), _jsx(Text, { className: "leading-relaxed", color: "muted", size: "sm", children: review.comment }), _jsx(Text, { size: "xs", color: "faint", children: review.productTitle })] }, review.id))) })] }));
+    return (_jsxs(Section, { className: "mt-10", children: [_jsx(Heading, { level: 2, className: "mb-2", color: "primary", size: "xl", weight: "semibold", children: "Store Reviews" }), _jsx(ReviewsListingPanel, { source: { kind: "store", storeSlug }, stateMode: "local", context: "store", emptyLabel: "This store has no reviews yet." })] }));
 }
 export async function AuctionDetailPageView({ id, initialAuction, onPlaceBid, onBuyNow, productFeatures }) {
     const product = initialAuction !== undefined
@@ -64,9 +69,6 @@ export async function AuctionDetailPageView({ id, initialAuction, onPlaceBid, on
         ? await listBidsByProduct(String(product.id), { pageSize: 5 }).catch(() => null)
         : null;
     const storeId = product?.storeId;
-    const storeReviews = storeId
-        ? await listReviewsBySeller(storeId).catch(() => [])
-        : [];
     if (!product) {
         return (_jsx(Main, { children: _jsx(Section, { padding: "y-5xl", children: _jsx(Container, { size: "md", children: _jsxs(Stack, { align: "start", gap: "md", className: "text-left", children: [_jsx(Heading, { level: 1, size: "2xl", weight: "semibold", color: "primary", children: "Auction Not Found" }), _jsx(Text, { color: "muted", children: "This auction may have ended or the link is incorrect." }), _jsx(Link, { href: String(ROUTES.PUBLIC.AUCTIONS), className: "text-[length:var(--appkit-text-sm)] font-medium text-primary-600 hover:underline", children: "Browse Auctions" })] }) }) }) }));
     }
@@ -191,5 +193,5 @@ export async function AuctionDetailPageView({ id, initialAuction, onPlaceBid, on
                                 slug: typeof r.slug === "string" ? r.slug : undefined,
                             }));
                             return (_jsxs(Stack, { gap: "xl", children: [related.length > 0 && (_jsx(RelatedProducts, { labels: { title: "Similar Auctions" }, renderGrid: () => (_jsx(MarketplaceAuctionGrid, { auctions: related, gridClassName: "grid grid-cols-2 gap-[var(--appkit-space-4)] sm:grid-cols-3 lg:grid-cols-4" })) })), _jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand || undefined, storeLabel: storeName || undefined })] }));
-                        } }), renderAuctionStoreReviews(storeReviews), _jsx(AuctionBottomActions, { currentBid: currentBid, currency: currency, bidCount: bidCount, isEnded: isEnded, auctionEndDate: endDate })] })] }));
+                        } }), renderAuctionStoreReviews(storeId), _jsx(AuctionBottomActions, { currentBid: currentBid, currency: currency, bidCount: bidCount, isEnded: isEnded, auctionEndDate: endDate })] })] }));
 }

package/dist/features/auctions/components/AuctionsListView.js

@@ -1,62 +1,21 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
-import { productRepository } from "../../../repositories";
 import { Container, Heading, Main, Section } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
-import { parseListingSearchParams } from "../../../utils/listing-params";
 import { AuctionsIndexListing } from "../../products/components/AuctionsIndexListing";
-const DEFAULT_PAGE = 1;
+import { listPublicProducts, parsePublicProductParams, } from "../../../_internal/server/features/products/list-public";
+const AUCTION_LISTING_TYPES = ["auction"];
 const DEFAULT_PAGE_SIZE = 24;
 const DEFAULT_SORT = "auctionEndDate";
-function sp(params, key) {
-    const v = params[key];
-    return Array.isArray(v) ? v[0] ?? "" : v ?? "";
-}
-function buildAuctionFilters(params) {
-    const parts = ["status==published", "listingType==auction"];
-    const minBid = sp(params, "minBid");
-    const maxBid = sp(params, "maxBid");
-    if (minBid)
-        parts.push(sieveFilter("currentBid", SIEVE_OP.GTE, minBid));
-    if (maxBid)
-        parts.push(sieveFilter("currentBid", SIEVE_OP.LTE, maxBid));
-    const store = sp(params, "store");
-    if (store) {
-        const values = store.split("|").filter(Boolean);
-        if (values.length === 1)
-            parts.push(sieveFilter("storeId", SIEVE_OP.EQ, values[0]));
-        else if (values.length > 1)
-            parts.push(sieveFilter("storeId", SIEVE_OP.EQ, values.join("|")));
-    }
-    // Mirror AuctionsIndexListing's client-side default (Root Cause pattern —
-    // SSR initialData is seeded into React Query with staleTime:Infinity, so if
-    // this SSR filter doesn't already exclude ended auctions, the client never
-    // refetches and ended auctions leak into the default "Show ended" off view).
-    const showEnded = sp(params, "showEnded") === "true";
-    const dateFrom = showEnded
-        ? sp(params, "dateFrom")
-        : sp(params, "dateFrom") || new Date().toISOString();
-    const dateTo = sp(params, "dateTo");
-    if (dateFrom)
-        parts.push(sieveFilter("auctionEndDate", SIEVE_OP.GTE, dateFrom));
-    if (dateTo)
-        parts.push(sieveFilter("auctionEndDate", SIEVE_OP.LTE, dateTo));
-    return parts.join(",");
-}
 export async function AuctionsListView({ searchParams = {} }) {
-    const std = parseListingSearchParams(searchParams);
-    const sort = std.sorts ?? DEFAULT_SORT;
-    const page = std.page ?? DEFAULT_PAGE;
-    const pageSize = std.pageSize ?? DEFAULT_PAGE_SIZE;
-    const filters = buildAuctionFilters(searchParams);
-    const result = await productRepository
-        .list({
-        filters,
-        sorts: sort,
-        page,
-        pageSize,
-    })
-        .catch(() => null);
-    const initial = result ?? null;
+    // Shared with /api/products. `hideEndedByDefault` mirrors
+    // AuctionsIndexListing's `showEnded ? … : dateFrom=now` default; because the
+    // default sort IS auctionEndDate, listPublicProducts pushes that range into
+    // Firestore rather than filtering in memory.
+    const initial = await listPublicProducts(parsePublicProductParams(searchParams, {
+        listingTypes: AUCTION_LISTING_TYPES,
+        pageSize: DEFAULT_PAGE_SIZE,
+        sorts: DEFAULT_SORT,
+        hideEndedByDefault: true,
+    }));
     return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-8", color: "primary", size: "3xl", weight: "semibold", children: "Live Auctions" }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(AuctionsIndexListing, { initialData: initial }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
 }

package/dist/features/auctions/components/PlaceBidFormClient.js

@@ -96,7 +96,16 @@ export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, start
                     return;
                 }
                 setSuccess(true);
-                router.refresh();
+                // Buy-Now writes a locked cart line, so send the buyer straight to the
+                // auction checkout lane to pay for it. This used to just call
+                // `router.refresh()` and discard the action's result entirely, leaving
+                // the buyer on the product page with no indication that anything was
+                // owed — the action returned an orderId nobody ever used.
+                const checkoutUrl = result?.checkoutUrl;
+                if (checkoutUrl)
+                    router.push(checkoutUrl);
+                else
+                    router.refresh();
             }
             catch (err) {
                 void normalizeError(err);

package/dist/features/auctions/repository/bid.repository.d.ts

@@ -50,6 +50,21 @@ export declare class BidRepository extends BaseRepository<BidDocument> {
         data: BidDocument;
     } | null>;
     markWon(batch: WriteBatch, ref: DocumentReference): void;
+    /**
+     * Link a won bid to the order it eventually became.
+     *
+     * `BidDocument` had no `orderId` at all before 2026-08-21, so a won bid and
+     * the thing the buyer paid for were two unrelated records — the "Won" row in
+     * /user/bids could not link anywhere, and nothing could tell a settled win
+     * from an unpaid one.
+     */
+    attachOrder(bidId: string, orderId: string): Promise<void>;
+    /**
+     * The winner never paid within their checkout window. Distinct from "lost"
+     * (outbid) — this bidder won and then defaulted, which a seller may want to
+     * act on.
+     */
+    markForfeited(bidId: string): Promise<void>;
     markLost(batch: WriteBatch, ref: DocumentReference): void;
     markOutbid(batch: WriteBatch, ref: DocumentReference): void;
     markWinning(batch: WriteBatch, ref: DocumentReference): void;

package/dist/features/auctions/repository/bid.repository.js

@@ -122,6 +122,25 @@ export class BidRepository extends BaseRepository {
             updatedAt: new Date(),
         });
     }
+    /**
+     * Link a won bid to the order it eventually became.
+     *
+     * `BidDocument` had no `orderId` at all before 2026-08-21, so a won bid and
+     * the thing the buyer paid for were two unrelated records — the "Won" row in
+     * /user/bids could not link anywhere, and nothing could tell a settled win
+     * from an unpaid one.
+     */
+    async attachOrder(bidId, orderId) {
+        await this.update(bidId, { orderId, updatedAt: new Date() });
+    }
+    /**
+     * The winner never paid within their checkout window. Distinct from "lost"
+     * (outbid) — this bidder won and then defaulted, which a seller may want to
+     * act on.
+     */
+    async markForfeited(bidId) {
+        await this.update(bidId, { status: "forfeited", isWinning: false, updatedAt: new Date() });
+    }
     markLost(batch, ref) {
         batch.update(ref, {
             status: "lost",

package/dist/features/auctions/schemas/firestore.d.ts

@@ -3,7 +3,9 @@
  */
 import { type GenerateBidIdInput } from "../../../utils/id-generators";
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
-export type BidStatus = "active" | "outbid" | "won" | "lost" | "cancelled";
+export type BidStatus = "active" | "outbid" | "won" | "lost" | "cancelled"
+/** Won, then the buyer let the 48h payment window lapse. */
+ | "forfeited";
 /** Runtime-accessible bid status values — use instead of bare string literals. */
 export declare const BidStatusValues: {
     readonly ACTIVE: "active";
@@ -11,6 +13,7 @@ export declare const BidStatusValues: {
     readonly WON: "won";
     readonly LOST: "lost";
     readonly CANCELLED: "cancelled";
+    readonly FORFEITED: "forfeited";
 };
 export interface BidDocument extends BaseDocument {
     productId: string;
@@ -25,6 +28,13 @@ export interface BidDocument extends BaseDocument {
     previousBidAmount?: number;
     bidDate: Date;
     autoMaxBid?: number;
+    /**
+     * The order this winning bid was settled into. Written by
+     * `finalizeLockedLines` once the winner actually pays; absent on a won-but-
+     * unpaid bid, which is what lets /user/bids show a "Pay now" CTA rather than
+     * a dead status badge.
+     */
+    orderId?: string;
 }
 export declare const BID_COLLECTION: "bids";
 export declare const BID_INDEXED_FIELDS: readonly ["productId", "userId", "status", "isWinning", "bidDate", "createdAt"];

package/dist/features/auctions/schemas/firestore.js

@@ -9,6 +9,7 @@ export const BidStatusValues = {
     WON: "won",
     LOST: "lost",
     CANCELLED: "cancelled",
+    FORFEITED: "forfeited",
 };
 export const BID_COLLECTION = "bids";
 export const BID_INDEXED_FIELDS = [

package/dist/features/cart/actions/cart-actions.d.ts

@@ -6,6 +6,17 @@
  */
 import type { AddToCartInput, CartDocument, UpdateCartItemInput } from "../schemas";
 export declare function addItemToCart(userId: string, input: AddToCartInput): Promise<CartDocument>;
+/** Error code the client maps to a lane-aware message. */
+export declare const CART_LANE_BLOCKED = "CART_LANE_BLOCKED";
+/**
+ * Won-auction lines are non-removable and fixed-quantity — the buyer committed
+ * to the purchase by bidding, and letting them delete it would turn every
+ * auction into a free option. That's already enforced one layer down:
+ * `cartRepository.updateItem` / `removeItem` both reject a `locked` line, and
+ * auction settlement is the only writer that sets `locked: true`. Accepted
+ * offers deliberately do NOT set it — declining to buy is the buyer's right,
+ * and the offer simply lapses at its `checkoutDeadline`.
+ */
 export declare function updateCartItem(userId: string, itemId: string, input: UpdateCartItemInput): Promise<CartDocument>;
 export declare function removeCartItem(userId: string, itemId: string): Promise<CartDocument>;
 export declare function clearCart(userId: string): Promise<CartDocument>;

package/dist/features/cart/actions/cart-actions.js

@@ -11,6 +11,7 @@ import { productRepository } from "../../products/repository/products.repository
 import { storeRepository } from "../../stores/repository/store.repository";
 import { normalizeListingType } from "../../products/utils/listing-type";
 import { getDefaultCurrency } from "../../../core/baseline-resolver";
+import { CART_LANE, activeLane, canAddNewItems, } from "../../../_internal/shared/checkout/lanes";
 /**
  * Product documents don't always carry a denormalized `storeName` — the
  * create routes only set it when the caller explicitly passes one, so
@@ -35,9 +36,32 @@ export async function addItemToCart(userId, input) {
     if (!canAddToCart(input.listingType)) {
         throw new ValidationError(`Listings of type "${input.listingType}" cannot be added to the cart.`);
     }
+    // Lane gate. While a higher-obligation lane (a won auction, then an accepted
+    // offer) is outstanding, no NEW shopping may be added — otherwise the buyer
+    // can keep deferring something they already committed to by piling more into
+    // the cart. Enforced here, on the server, not only in the UI: the UI hint is
+    // a courtesy, this is the rule.
+    const cart = await cartRepository.getOrCreate(userId);
+    if (!canAddNewItems(cart.items ?? [])) {
+        const blocking = activeLane(cart.items ?? []);
+        throw new ValidationError(blocking === CART_LANE.AUCTION
+            ? "Settle your won auction first — you can add other items once it's paid for."
+            : "Complete your accepted offer first — you can add other items once it's paid for.", { code: CART_LANE_BLOCKED });
+    }
     const storeName = await resolveStoreName(input.storeId, input.storeName);
     return cartRepository.addItem(userId, { ...input, storeName });
 }
+/** Error code the client maps to a lane-aware message. */
+export const CART_LANE_BLOCKED = "CART_LANE_BLOCKED";
+/**
+ * Won-auction lines are non-removable and fixed-quantity — the buyer committed
+ * to the purchase by bidding, and letting them delete it would turn every
+ * auction into a free option. That's already enforced one layer down:
+ * `cartRepository.updateItem` / `removeItem` both reject a `locked` line, and
+ * auction settlement is the only writer that sets `locked: true`. Accepted
+ * offers deliberately do NOT set it — declining to buy is the buyer's right,
+ * and the offer simply lapses at its `checkoutDeadline`.
+ */
 export async function updateCartItem(userId, itemId, input) {
     return cartRepository.updateItem(userId, itemId, input);
 }

package/dist/features/cart/repository/cart.repository.d.ts

@@ -1,7 +1,7 @@
 import type { DocumentReference } from "firebase-admin/firestore";
 import type { DocumentSnapshot } from "../../../providers/db-firebase";
 import { BaseRepository, type FirebaseSieveResult, type SieveModel } from "../../../providers/db-firebase";
-import { type AddToCartInput, type CartAppliedCoupon, type CartDocument, type UpdateCartItemInput } from "../schemas";
+import { type AddToCartInput, type CartAppliedCoupon, type CartDocument, type CartItemDocument, type UpdateCartItemInput } from "../schemas";
 export declare class CartRepository extends BaseRepository<CartDocument> {
     private static readonly SIEVE_FIELDS;
     constructor();
@@ -19,6 +19,29 @@ export declare class CartRepository extends BaseRepository<CartDocument> {
     getSubtotal(cart: CartDocument): number;
     addCoupon(userId: string, coupon: CartAppliedCoupon): Promise<void>;
     removeCoupon(userId: string, code: string): Promise<void>;
+    /**
+     * Drop every locked line matching a predicate, bypassing the `locked` guard
+     * that blocks user-initiated removal.
+     *
+     * Only the expiry sweeps call this: a locked line whose claim has lapsed must
+     * be cleared, or it keeps the buyer's auction/offer lane non-empty forever
+     * and the lane gate blocks their ordinary checkout on something they can no
+     * longer act on.
+     */
+    private removeLockedLines;
+    /** Clear the cart line created for a specific accepted offer. */
+    removeItemsByOfferId(userId: string, offerId: string): Promise<number>;
+    /** Clear the cart line created for a specific won auction bid. */
+    removeItemsByBidId(userId: string, bidId: string): Promise<number>;
+    /**
+     * Every locked line across all carts whose `checkoutDeadline` has passed.
+     * Bounded per Rule #6 — the sweep runs on a schedule, so a backlog drains
+     * over successive runs rather than in one unbounded scan.
+     */
+    findExpiredLockedLines(now: Date, limit?: number): Promise<Array<{
+        userId: string;
+        item: CartItemDocument;
+    }>>;
     updateItemShipping(userId: string, itemId: string, providerId: string, fee: number): Promise<CartDocument>;
     clearAllCoupons(userId: string): Promise<void>;
     setSelectedItems(userId: string, itemIds: string[] | null): Promise<void>;

package/dist/features/cart/repository/cart.repository.js

@@ -61,14 +61,20 @@ export class CartRepository extends BaseRepository {
         try {
             const cart = await this.getOrCreate(userId);
             const items = [...cart.items];
-            if (input.offerId) {
-                const alreadyAdded = items.some((item) => item.offerId === input.offerId);
-                if (alreadyAdded)
-                    return cart;
+            // A locked line (accepted offer / won auction) is identified by its
+            // offerId or bidId, never merged by productId — two separate wins on the
+            // same listing are two separate obligations, and re-running the
+            // settlement sweep must not duplicate a line it already wrote.
+            if (input.offerId && items.some((item) => item.offerId === input.offerId)) {
+                return cart;
             }
-            const existingIndex = input.offerId
+            if (input.bidId && items.some((item) => item.bidId === input.bidId)) {
+                return cart;
+            }
+            const isLockedLine = Boolean(input.offerId || input.bidId);
+            const existingIndex = isLockedLine
                 ? -1
-                : items.findIndex((item) => item.productId === input.productId && !item.offerId);
+                : items.findIndex((item) => item.productId === input.productId && !item.offerId && !item.bidId);
             if (existingIndex >= 0) {
                 items[existingIndex] = {
                     ...items[existingIndex],
@@ -90,9 +96,15 @@ export class CartRepository extends BaseRepository {
                     listingType: input.listingType,
                     ...(input.isOffer !== undefined && { isOffer: input.isOffer }),
                     ...(input.offerId !== undefined && { offerId: input.offerId }),
+                    ...(input.isAuctionWin !== undefined && { isAuctionWin: input.isAuctionWin }),
+                    ...(input.auctionId !== undefined && { auctionId: input.auctionId }),
+                    ...(input.bidId !== undefined && { bidId: input.bidId }),
                     ...(input.lockedPrice !== undefined && {
                         lockedPrice: input.lockedPrice,
                     }),
+                    ...(input.checkoutDeadline !== undefined && {
+                        checkoutDeadline: input.checkoutDeadline,
+                    }),
                     ...(input.locked !== undefined && { locked: input.locked }),
                     // SB-UNI-4 2026-05-13 — propagate bundle identifiers when present.
                     ...(input.bundleCategorySlug !== undefined && {
@@ -231,6 +243,59 @@ export class CartRepository extends BaseRepository {
             .doc(userId)
             .set({ appliedCoupons: updated, updatedAt: new Date() }, { merge: true });
     }
+    /**
+     * Drop every locked line matching a predicate, bypassing the `locked` guard
+     * that blocks user-initiated removal.
+     *
+     * Only the expiry sweeps call this: a locked line whose claim has lapsed must
+     * be cleared, or it keeps the buyer's auction/offer lane non-empty forever
+     * and the lane gate blocks their ordinary checkout on something they can no
+     * longer act on.
+     */
+    async removeLockedLines(userId, matches) {
+        const cart = await this.findByUserId(userId);
+        if (!cart)
+            return 0;
+        const items = cart.items.filter((item) => !matches(item));
+        const removed = cart.items.length - items.length;
+        if (removed === 0)
+            return 0;
+        await this.db
+            .collection(this.collection)
+            .doc(userId)
+            .set(prepareForFirestore({ ...cart, items, updatedAt: new Date() }));
+        return removed;
+    }
+    /** Clear the cart line created for a specific accepted offer. */
+    async removeItemsByOfferId(userId, offerId) {
+        return this.removeLockedLines(userId, (item) => item.offerId === offerId);
+    }
+    /** Clear the cart line created for a specific won auction bid. */
+    async removeItemsByBidId(userId, bidId) {
+        return this.removeLockedLines(userId, (item) => item.bidId === bidId);
+    }
+    /**
+     * Every locked line across all carts whose `checkoutDeadline` has passed.
+     * Bounded per Rule #6 — the sweep runs on a schedule, so a backlog drains
+     * over successive runs rather than in one unbounded scan.
+     */
+    async findExpiredLockedLines(now, limit = 200) {
+        const snapshot = await this.getCollection().limit(limit).get();
+        const out = [];
+        for (const doc of snapshot.docs) {
+            const cart = this.mapDoc(doc);
+            for (const item of cart.items ?? []) {
+                if (!item.checkoutDeadline)
+                    continue;
+                const deadline = item.checkoutDeadline instanceof Date
+                    ? item.checkoutDeadline
+                    : new Date(item.checkoutDeadline);
+                if (deadline <= now)
+                    out.push({ userId: cart.userId ?? doc.id, item });
+            }
+        }
+        return out;
+    }
     async updateItemShipping(userId, itemId, providerId, fee) {
         try {
             const cart = await this.findByUserId(userId);

package/dist/features/cart/schemas/firestore.d.ts

@@ -20,15 +20,32 @@ export interface CartItemDocument {
     /**
      * Snapshot of the product's listing-kind at add-to-cart time (SB1-G Phase 4).
      * Drives order-grouping (auctions/pre-orders settle separately from standard
-     * carts) and cart-side UI badges. Replaces the legacy `isAuction`/`isPreOrder`
+     * carts) and cart-side UI badges. Replaces the legacy `isAuctionWin`/`isPreOrder`
      * pair on the cart item.
      */
     listingType: ListingType;
     /** True when item was added from an accepted Make-an-Offer */
     isOffer?: boolean;
     offerId?: string;
-    /** Locked offer price — overrides normal product price at checkout */
+    /**
+     * True when the line was created by auction settlement for the winning
+     * bidder. Auctions are `canAddToCart: false` for user-initiated adds — this
+     * line is written by the settlement job through the repository directly, and
+     * is the ONLY way an auction reaches the cart.
+     */
+    isAuctionWin?: boolean;
+    /** The auction product this win refers to (= productId, kept explicit). */
+    auctionId?: string;
+    /** The winning bid, so the resulting order can be linked back to it. */
+    bidId?: string;
+    /** Locked offer/winning-bid price — overrides normal product price at checkout */
     lockedPrice?: number;
+    /**
+     * When the claim on this locked price lapses. Mirrors the offer's own
+     * `checkoutDeadline`; set to now + 48h for a won auction. The expiry sweep
+     * clears lines past this point.
+     */
+    checkoutDeadline?: Date;
     /** When true the item cannot be removed or have its quantity changed. Set on won-auction and accepted-offer items that require mandatory payment. */
     locked?: boolean;
     /**
@@ -65,8 +82,6 @@ export interface CartAppliedCoupon {
     storeId?: string;
     /** Item IDs (CartItemDocument.itemId) this coupon was calculated against */
     applicableItemIds?: string[];
-    /** Mirrors CouponDocument.restrictions.combineWithSellerCoupons — used for conflict detection when adding future coupons */
-    combineWithSellerCoupons?: boolean;
 }
 export interface CartDocument extends BaseDocument {
     userId: string;
@@ -114,7 +129,11 @@ export type AddToCartInput = {
     listingType: ListingType;
     isOffer?: boolean;
     offerId?: string;
+    isAuctionWin?: boolean;
+    auctionId?: string;
+    bidId?: string;
     lockedPrice?: number;
+    checkoutDeadline?: Date;
     locked?: boolean;
     /** SB-UNI-4 2026-05-13 — bundle identifier when the line is a bundle. */
     bundleCategorySlug?: string;

package/dist/features/categories/components/BrandDetailTabs.js

@@ -7,14 +7,35 @@ import { AuctionsIndexListing } from "../../products/components/AuctionsIndexLis
 import { PreOrdersIndexListing } from "../../pre-orders/components/PreOrdersIndexListing";
 import { PrizeDrawsIndexListing } from "../../products/components/PrizeDrawsIndexListing";
 import { CategoryBundlesListing } from "./CategoryBundlesListing";
-import { CATEGORY_PAGE_TABS } from "../../products/constants/listing-tabs";
+import { CATEGORY_PAGE_TABS, ART_STICKERS_LISTING_TYPES, } from "../../products/constants/listing-tabs";
+import { ALL_LISTING_TYPES } from "../../../_internal/shared/listing-types/feature-flags";
+import { pluginFor } from "../../../_internal/shared/listing-types/_registry";
+/**
+ * Tab slug → listing/category type, derived (2026-08-21). The hand-written
+ * version covered 5 of 10 tabs, and this view's filter did `if (!mapping)
+ * return false` — so classifieds, digital codes, live items and art were
+ * silently DROPPED from every brand page rather than rendering blank (the
+ * failure mode its category-page twin had). Same root gap, opposite symptom.
+ *
+ * `stores` is intentionally absent: a brand has no store roster, which is the
+ * one real difference between this component and CategoryDetailTabs (see
+ * CLAUDE.md's Categories & Brands Reference on why the duplication stands).
+ */
 const TAB_TYPE_MAP = {
-    products: { kind: "listing", type: "standard" },
-    auctions: { kind: "listing", type: "auction" },
-    "pre-orders": { kind: "listing", type: "pre-order" },
-    "prize-draws": { kind: "listing", type: "prize-draw" },
+    ...Object.fromEntries(ALL_LISTING_TYPES.map((type) => [
+        pluginFor(type).tabSlug,
+        { kind: "listing", type },
+    ])),
     bundles: { kind: "category", type: "bundle" },
 };
+/** Listing types rendered by the shared products listing rather than a dedicated one. */
+const GENERIC_TAB_LISTING_TYPES = {
+    [pluginFor("standard").tabSlug]: ["standard"],
+    [pluginFor("classified").tabSlug]: ["classified"],
+    [pluginFor("digital-code").tabSlug]: ["digital-code"],
+    [pluginFor("live").tabSlug]: ["live"],
+    [pluginFor("art").tabSlug]: ART_STICKERS_LISTING_TYPES,
+};
 export function BrandDetailTabs({ brandName, initialProductsData, initialBundles = [], counts, enabledListingTypes, enabledCategoryTypes, }) {
     const countFor = (id) => {
         switch (id) {
@@ -28,11 +49,10 @@ export function BrandDetailTabs({ brandName, initialProductsData, initialBundles
     };
     const visibleTabs = CATEGORY_PAGE_TABS.filter((t) => {
         const mapping = TAB_TYPE_MAP[t.id];
-        // This view only has content renderers for the 5 tab ids in
-        // TAB_TYPE_MAP (products/auctions/pre-orders/prize-draws/bundles) — any
-        // other CATEGORY_PAGE_TABS id (stores, classifieds, etc.) has no case in
-        // the render switch below and would show a blank tab, so exclude those
-        // here rather than rely on downstream JSX to silently render nothing.
+        // A tab with no mapping has no render branch below and would show a blank
+        // panel, so drop it here rather than let downstream JSX render nothing.
+        // Today that's only `stores` — a brand has no store roster. Every listing
+        // type IS mapped now (it used to also silently drop four real types).
         if (!mapping)
             return false;
         if (mapping.kind === "listing" && enabledListingTypes) {
@@ -49,5 +69,5 @@ export function BrandDetailTabs({ brandName, initialProductsData, initialBundles
     });
     const firstTabId = (visibleTabs[0]?.id ?? "products");
     const [activeTab, setActiveTab] = useState(firstTabId);
-    return (_jsxs(_Fragment, { children: [_jsx(Tabs, { value: activeTab, onChange: (v) => setActiveTab(v), className: "mb-6", children: _jsx(TabsList, { children: visibleTabs.map((t) => (_jsx(TabsTrigger, { value: t.id, badge: countFor(t.id), children: t.label }, t.id))) }) }), activeTab === "products" && (_jsx(CategoryProductsListing, { categorySlug: "", brandName: brandName, initialData: initialProductsData })), activeTab === "auctions" && (_jsx(AuctionsIndexListing, { brandName: brandName })), activeTab === "pre-orders" && (_jsx(PreOrdersIndexListing, { brandName: brandName })), activeTab === "prize-draws" && (_jsx(PrizeDrawsIndexListing, { brandName: brandName })), activeTab === "bundles" && (_jsx(CategoryBundlesListing, { initialBundles: initialBundles, brandName: brandName }))] }));
+    return (_jsxs(_Fragment, { children: [_jsx(Tabs, { value: activeTab, onChange: (v) => setActiveTab(v), className: "mb-6", children: _jsx(TabsList, { children: visibleTabs.map((t) => (_jsx(TabsTrigger, { value: t.id, badge: countFor(t.id), children: t.label }, t.id))) }) }), GENERIC_TAB_LISTING_TYPES[activeTab] && (_jsx(CategoryProductsListing, { categorySlug: "", brandName: brandName, listingTypes: GENERIC_TAB_LISTING_TYPES[activeTab], initialData: activeTab === pluginFor("standard").tabSlug ? initialProductsData : undefined })), activeTab === pluginFor("auction").tabSlug && (_jsx(AuctionsIndexListing, { brandName: brandName })), activeTab === pluginFor("pre-order").tabSlug && (_jsx(PreOrdersIndexListing, { brandName: brandName })), activeTab === pluginFor("prize-draw").tabSlug && (_jsx(PrizeDrawsIndexListing, { brandName: brandName })), activeTab === "bundles" && (_jsx(CategoryBundlesListing, { initialBundles: initialBundles, brandName: brandName }))] }));
 }