@mohasinac/appkit 2.6.2 → 2.6.4

package/dist/features/products/actions/product-actions.js

@@ -3,7 +3,7 @@ import { ProductStatusValues } from "../schemas";
 /**
  * Reusable Sieve clauses. Single source of truth for the listing-type
  * discriminator across every action helper in this file. SB1-G (S21 2026-05-12)
- * routes everything through `listingType==X` — the legacy boolean flags are
+ * routes everything through `listingType==X` — the legacy boolean flags are
  * never emitted by code under our control any more.
  */
 const PUBLISHED_CLAUSE = "status==published";

package/dist/features/products/components/CompareOverlay.d.ts

@@ -15,7 +15,7 @@ export interface CompareProductLike {
     storeName?: string;
     storeSlug?: string;
     /** Canonical discriminator (SB1-G Phase 4). */
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
+    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
     features?: string[];
 }
 interface CompareFieldLabels {
@@ -38,7 +38,7 @@ export interface CompareOverlayProps {
     isOpen: boolean;
     /** Pre-loaded items. Takes precedence over `productIds`. */
     items?: CompareProductLike[];
-    /** When provided, the overlay fetches /api/products?ids=… on open. */
+    /** When provided, the overlay fetches /api/products?ids=… on open. */
     productIds?: string[];
     /** Discriminates which detail-page ROUTE to link to. */
     productType?: "product" | "auction" | "preorder";

package/dist/features/products/components/CompareOverlay.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /**
- * CompareOverlay — BK3
+ * CompareOverlay — BK3
  *
  * Fullscreen comparison overlay triggered by the Compare bulk action on
  * Products / Auctions / Pre-orders listings.
@@ -58,7 +58,7 @@ function detailHref(item, type) {
 }
 function priceLabel(item) {
     if (typeof item.price !== "number")
-        return "—";
+        return "—";
     return formatCurrency(item.price, item.currency ?? "INR");
 }
 function FieldRow({ label, children }) {
@@ -69,7 +69,7 @@ function CompareColumn({ item, productType, labels, onRemove, onClose }) {
     const img = item.mainImage ?? item.images?.[0];
     return (_jsxs(Stack, { gap: "md", className: COLUMN_CARD_CLASS, children: [_jsxs(Row, { justify: "between", align: "start", gap: "sm", children: [_jsx(Link, { href: href, target: "_blank", rel: "noopener noreferrer", className: "text-sm font-semibold text-zinc-900 dark:text-zinc-100 hover:underline line-clamp-2", children: item.title ?? item.id }), onRemove && (_jsx("button", { type: "button", onClick: () => onRemove(item.id), "aria-label": `${labels.remove} ${item.title ?? item.id}`, className: "shrink-0 rounded-full p-1 text-zinc-400 hover:bg-zinc-100 hover:text-rose-500 dark:hover:bg-zinc-800", children: _jsx(X, { className: "h-4 w-4" }) }))] }), _jsx(FieldRow, { label: labels.field.image, children: _jsx(Link, { href: href, target: "_blank", rel: "noopener noreferrer", children: _jsx(Div, { className: "relative aspect-square overflow-hidden rounded-lg bg-zinc-100 dark:bg-zinc-800", children: img ? (
                         // eslint-disable-next-line @next/next/no-img-element
-                        _jsx("img", { src: img, alt: item.title ?? item.id, className: "h-full w-full object-cover" })) : null }) }) }), _jsx(FieldRow, { label: labels.field.price, children: _jsx(Text, { className: "text-base font-semibold text-zinc-900 dark:text-zinc-100", children: priceLabel(item) }) }), _jsx(FieldRow, { label: labels.field.condition, children: _jsx(Text, { children: item.condition ? _jsx("span", { className: CHIP_CLASS, children: item.condition }) : "—" }) }), _jsx(FieldRow, { label: labels.field.brand, children: _jsx(Text, { children: item.brand ? _jsx("span", { className: CHIP_CLASS, children: item.brand }) : "—" }) }), _jsx(FieldRow, { label: labels.field.category, children: _jsx(Text, { children: item.categoryName || item.category ? (_jsx("span", { className: CHIP_CLASS, children: item.categoryName ?? item.category })) : ("—") }) }), _jsx(FieldRow, { label: labels.field.store, children: _jsx(Text, { className: "text-sm text-zinc-700 dark:text-zinc-300", children: item.storeName ?? "—" }) }), _jsx(Button, { asChild: true, variant: "primary", size: "sm", className: "mt-auto", children: _jsx(Link, { href: href, target: "_blank", rel: "noopener noreferrer", onClick: onClose, children: labels.view }) })] }));
+                        _jsx("img", { src: img, alt: item.title ?? item.id, className: "h-full w-full object-cover" })) : null }) }) }), _jsx(FieldRow, { label: labels.field.price, children: _jsx(Text, { className: "text-base font-semibold text-zinc-900 dark:text-zinc-100", children: priceLabel(item) }) }), _jsx(FieldRow, { label: labels.field.condition, children: _jsx(Text, { children: item.condition ? _jsx("span", { className: CHIP_CLASS, children: item.condition }) : "—" }) }), _jsx(FieldRow, { label: labels.field.brand, children: _jsx(Text, { children: item.brand ? _jsx("span", { className: CHIP_CLASS, children: item.brand }) : "—" }) }), _jsx(FieldRow, { label: labels.field.category, children: _jsx(Text, { children: item.categoryName || item.category ? (_jsx("span", { className: CHIP_CLASS, children: item.categoryName ?? item.category })) : ("—") }) }), _jsx(FieldRow, { label: labels.field.store, children: _jsx(Text, { className: "text-sm text-zinc-700 dark:text-zinc-300", children: item.storeName ?? "—" }) }), _jsx(Button, { asChild: true, variant: "primary", size: "sm", className: "mt-auto", children: _jsx(Link, { href: href, target: "_blank", rel: "noopener noreferrer", onClick: onClose, children: labels.view }) })] }));
 }
 function useFetchedProducts(productIds, passedItems, isOpen) {
     const [fetched, setFetched] = useState([]);
@@ -146,7 +146,7 @@ export function CompareOverlay({ isOpen, items: passedItems, productIds, product
     }, [onRemove]);
     if (!isOpen)
         return null;
-    return (_jsxs(Div, { className: OVERLAY_CLASS, style: OVERLAY_STYLE, role: "dialog", "aria-modal": "true", "aria-label": labels.title, children: [_jsxs(Row, { justify: "between", align: "center", className: HEADER_CLASS, children: [_jsx(Heading, { level: 2, className: "text-base font-semibold", children: labels.title }), _jsx("button", { type: "button", onClick: onClose, "aria-label": labels.close, className: "rounded-full p-2 text-zinc-500 hover:bg-zinc-100 dark:hover:bg-zinc-800", children: _jsx(X, { className: "h-5 w-5" }) })] }), _jsx(Div, { className: "flex-1 overflow-auto p-4", children: isLoading ? (_jsx(Text, { variant: "secondary", className: "text-center py-12", children: "Loading\u2026" })) : trimmed.length === 0 ? (_jsx(Text, { variant: "secondary", className: "text-center py-12", children: labels.empty })) : (_jsxs(_Fragment, { children: [_jsx(Div, { className: "hidden md:grid gap-4", style: {
+    return (_jsxs(Div, { className: OVERLAY_CLASS, style: OVERLAY_STYLE, role: "dialog", "aria-modal": "true", "aria-label": labels.title, children: [_jsxs(Row, { justify: "between", align: "center", className: HEADER_CLASS, children: [_jsx(Heading, { level: 2, className: "text-base font-semibold", children: labels.title }), _jsx("button", { type: "button", onClick: onClose, "aria-label": labels.close, className: "rounded-full p-2 text-zinc-500 hover:bg-zinc-100 dark:hover:bg-zinc-800", children: _jsx(X, { className: "h-5 w-5" }) })] }), _jsx(Div, { className: "flex-1 overflow-auto p-4", children: isLoading ? (_jsx(Text, { variant: "secondary", className: "text-center py-12", children: "Loading\u00E2\u20AC\u00A6" })) : trimmed.length === 0 ? (_jsx(Text, { variant: "secondary", className: "text-center py-12", children: labels.empty })) : (_jsxs(_Fragment, { children: [_jsx(Div, { className: "hidden md:grid gap-4", style: {
                                 gridTemplateColumns: `repeat(${trimmed.length}, minmax(0, 1fr))`,
                             }, children: trimmed.map((item) => (_jsx(CompareColumn, { item: item, productType: productType, labels: labels, onRemove: onRemove ? handleRemove : undefined, onClose: onClose }, item.id))) }), _jsxs(Div, { className: "md:hidden", children: [_jsx(Div, { ref: swipeRef, className: "touch-pan-y", children: trimmed[activeIndex] && (_jsx(CompareColumn, { item: trimmed[activeIndex], productType: productType, labels: labels, onRemove: onRemove ? handleRemove : undefined, onClose: onClose })) }), trimmed.length > 1 && (_jsx(Row, { justify: "center", gap: "xs", className: "mt-4", children: trimmed.map((it, idx) => (_jsx("button", { type: "button", "aria-label": `Show item ${idx + 1}`, onClick: () => setActiveIndex(idx), className: `h-2 w-2 rounded-full transition-colors ${idx === activeIndex
                                             ? "bg-primary"

package/dist/features/products/components/InteractiveProductCard.js

@@ -2,16 +2,11 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import Link from "next/link";
 import { ProductCard } from "./ProductGrid";
 export function InteractiveProductCard({ product, href, className, selectable, isSelected, onSelect, isWishlisted = false, onToggleWishlist, onAddToCart, onBuyNow, }) {
-    return (_jsx(Link, { href: href, className: [
-            "block",
-            selectable ? "cursor-pointer" : "",
-            isSelected ? "ring-2 ring-primary-600" : "",
-        ]
-            .filter(Boolean)
-            .join(" "), onClick: selectable && onSelect
-            ? (e) => {
-                e.preventDefault();
-                onSelect(product.id, !isSelected);
-            }
-            : undefined, children: _jsx(ProductCard, { product: product, className: className, isWishlisted: isWishlisted, onAddToWishlist: onToggleWishlist, onAddToCart: onAddToCart, onBuyNow: onBuyNow }) }));
+    // When selection is enabled, render ProductCard directly so its built-in
+    // checkbox + long-press (BaseListingCard.Checkbox) work; wrap with Link
+    // only outside of selection mode.
+    if (onSelect) {
+        return (_jsx(ProductCard, { product: product, className: className, isWishlisted: isWishlisted, onAddToWishlist: onToggleWishlist, onAddToCart: onAddToCart, onBuyNow: onBuyNow, selectionMode: selectable, isSelected: isSelected, onSelect: (id) => onSelect(id, !isSelected) }));
+    }
+    return (_jsx(Link, { href: href, className: "block", children: _jsx(ProductCard, { product: product, className: className, isWishlisted: isWishlisted, onAddToWishlist: onToggleWishlist, onAddToCart: onAddToCart, onBuyNow: onBuyNow }) }));
 }

package/dist/features/products/components/NonRefundableConsentModal.d.ts

@@ -1,4 +1,4 @@
-export type NonRefundableListingType = "bundle" | "prize-draw";
+export type NonRefundableListingType = "prize-draw";
 export interface NonRefundableConsentModalProps {
     /** Modal visibility — controlled by the parent. */
     open: boolean;

package/dist/features/products/components/NonRefundableConsentModal.js

@@ -15,16 +15,6 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useEffect, useId, useState } from "react";
 import { Button, Checkbox, Modal, Stack, Text, } from "../../../ui";
 const COPY = {
-    bundle: {
-        heading: "This bundle is non-refundable once paid",
-        bullets: [
-            "All items in the bundle ship together. We don't process partial refunds for individual items inside the bundle.",
-            "If the seller cancels the bundle before shipping, your full payment is refunded automatically.",
-            "Once shipped, normal item-level shipping/return guarantees apply — but the bundle price itself is final.",
-        ],
-        cta: "Agree & Buy Bundle",
-        consent: "I understand this purchase is non-refundable once paid. The seller will ship all items together.",
-    },
     "prize-draw": {
         heading: "Entry fee is non-refundable",
         bullets: [

package/dist/features/products/components/ProductGrid.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import React from "react";
 import Link from "next/link";
-import { Button, Div, Grid, Row, Span, Text } from "../../../ui";
+import { BaseListingCard, Button, Div, Grid, Row, Span, Text } from "../../../ui";
 import { MediaImage } from "../../media/MediaImage";
 import { THEME_CONSTANTS } from "../../../tokens";
 import { formatCurrency } from "../../../utils/number.formatter";
@@ -47,15 +47,9 @@ export function ProductCard({ product, href, onClick, onAddToWishlist, isWishlis
             className,
         ]
             .filter(Boolean)
-            .join(" "), children: [_jsxs(Div, { className: "relative overflow-hidden bg-zinc-100 dark:bg-slate-800 aspect-square", children: [product.mainImage ? (_jsx(MediaImage, { src: product.mainImage, alt: product.title, size: "card", className: "transition-transform duration-500 group-hover:scale-105" })) : (_jsx(Div, { className: "h-full w-full flex items-center justify-center bg-gradient-to-br from-zinc-100 to-zinc-200 dark:from-slate-800 dark:to-slate-700", children: _jsx(Span, { className: "text-4xl opacity-30", children: "\uD83D\uDECD\uFE0F" }) })), _jsxs(Div, { className: "absolute left-2 top-2 flex flex-col gap-1", children: [onSelect && (_jsx(Div, { onClick: (e) => { e.preventDefault(); e.stopPropagation(); onSelect(product.id); }, "aria-label": isSelected ? "Deselect" : "Select", className: [
-                                    "flex h-6 w-6 items-center justify-center rounded-md border-2 shadow-sm transition-all duration-150 cursor-pointer",
-                                    isSelected
-                                        ? "bg-primary border-primary text-white opacity-100"
-                                        : "bg-white/90 dark:bg-slate-800/90 border-zinc-300 dark:border-slate-500",
-                                    selectionMode || isSelected ? "opacity-100" : "opacity-0 group-hover:opacity-100",
-                                ].join(" "), children: isSelected && (_jsx("svg", { className: "h-3.5 w-3.5", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: 2.5, "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M2 6l3 3 5-5" }) })) })), !selectionMode && !isSelected && (_jsxs(_Fragment, { children: [discount && (_jsxs(Span, { className: "rounded-full bg-rose-500 px-2 py-0.5 text-[10px] font-bold text-white shadow-sm", children: ["-", discount, "%"] })), typeBadge && (_jsx(Span, { className: `rounded-full px-2 py-0.5 text-[10px] font-bold shadow-sm ${typeBadge.cls}`, children: typeBadge.label })), product.partOfBundleIds && product.partOfBundleIds.length > 0 && (_jsx(Span, { className: "rounded-full bg-teal-600 px-2 py-0.5 text-[10px] font-bold text-white shadow-sm", title: product.partOfBundleTitles && product.partOfBundleTitles.length > 0
-                                            ? `In bundle: ${product.partOfBundleTitles[0]}`
-                                            : "In a bundle", children: "Bundled" }))] }))] }), onAddToWishlist && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: (e) => {
+            .join(" "), children: [_jsxs(Div, { className: "relative overflow-hidden bg-zinc-100 dark:bg-slate-800 aspect-square", children: [product.mainImage ? (_jsx(MediaImage, { src: product.mainImage, alt: product.title, size: "card", className: "transition-transform duration-500 group-hover:scale-105" })) : (_jsx(Div, { className: "h-full w-full flex items-center justify-center bg-gradient-to-br from-zinc-100 to-zinc-200 dark:from-slate-800 dark:to-slate-700", children: _jsx(Span, { className: "text-4xl opacity-30", children: "\uD83D\uDECD\uFE0F" }) })), onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: (e) => { e.preventDefault(); onSelect(product.id); }, label: isSelected ? "Deselect" : "Select", position: "top-2 left-2", className: selectionMode || isSelected ? "opacity-100" : "opacity-0 group-hover:opacity-100 transition-opacity" })), _jsx(Div, { className: `absolute top-2 flex flex-col gap-1 ${onSelect ? "left-10" : "left-2"}`, children: !selectionMode && !isSelected && (_jsxs(_Fragment, { children: [discount && (_jsxs(Span, { className: "rounded-full bg-rose-500 px-2 py-0.5 text-[10px] font-bold text-white shadow-sm", children: ["-", discount, "%"] })), typeBadge && (_jsx(Span, { className: `rounded-full px-2 py-0.5 text-[10px] font-bold shadow-sm ${typeBadge.cls}`, children: typeBadge.label })), product.partOfBundleIds && product.partOfBundleIds.length > 0 && (_jsx(Span, { className: "rounded-full bg-teal-600 px-2 py-0.5 text-[10px] font-bold text-white shadow-sm", title: product.partOfBundleTitles && product.partOfBundleTitles.length > 0
+                                        ? `In bundle: ${product.partOfBundleTitles[0]}`
+                                        : "In a bundle", children: "Bundled" }))] })) }), onAddToWishlist && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: (e) => {
                             e.stopPropagation();
                             e.preventDefault();
                             onAddToWishlist(product.id);
@@ -68,7 +62,18 @@ export function ProductCard({ product, href, onClick, onAddToWishlist, isWishlis
                         ].join(" "), children: _jsx("svg", { className: "h-4 w-4", fill: isWishlisted ? "currentColor" : "none", stroke: "currentColor", strokeWidth: 2, viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M21 8.25c0-2.485-2.099-4.5-4.688-4.5-1.935 0-3.597 1.126-4.312 2.733-.715-1.607-2.377-2.733-4.313-2.733C5.1 3.75 3 5.765 3 8.25c0 7.22 9 12 9 12s9-4.78 9-12z" }) }) }))] }), _jsxs(Div, { className: "flex flex-1 flex-col p-3 pt-2.5", children: [_jsx(Text, { className: `${THEME_CONSTANTS.utilities.textClamp2} text-sm font-semibold text-zinc-900 dark:text-white leading-snug`, children: product.title }), (product.categoryName || product.brand) && (_jsxs(Row, { className: "mt-1 gap-1 flex-wrap", children: [product.categoryName && (_jsx(Span, { className: "rounded-full bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 text-[10px] text-zinc-500 dark:text-zinc-400 truncate max-w-[90px]", children: product.categoryName })), product.brand && (_jsx(Span, { className: "rounded-full bg-zinc-100 dark:bg-zinc-800 px-1.5 py-0.5 text-[10px] text-zinc-500 dark:text-zinc-400 truncate max-w-[80px]", children: product.brand }))] })), (() => {
                         const seller = safeDisplayName(product.storeName, "");
                         return seller ? (_jsxs(Text, { className: "mt-0.5 text-[11px] text-zinc-400 dark:text-zinc-500 truncate", children: ["by ", seller] })) : null;
-                    })(), product.rating !== undefined && (_jsxs(Row, { className: "mt-1 gap-1 items-center", children: [_jsx(Span, { className: "text-[11px] text-amber-400", children: "\u2605" }), _jsxs(Span, { className: "text-[11px] text-zinc-500 dark:text-zinc-400", children: [product.rating.toFixed(1), product.reviewCount ? ` (${product.reviewCount})` : ""] })] })), _jsxs(Div, { className: "mt-auto pt-2", children: [_jsxs(Row, { className: "items-baseline gap-2", children: [_jsx(Span, { className: "text-base font-bold text-primary dark:text-primary-400", children: formatCurrency(product.price, getDefaultCurrency()) }), product.originalPrice && product.originalPrice > product.price && (_jsx(Span, { className: "text-xs text-zinc-400 line-through dark:text-zinc-500", children: formatCurrency(product.originalPrice, getDefaultCurrency()) }))] }), featuresList && product.features && product.features.length > 0 && (_jsx(FeatureBadgeList, { productFeatureIds: product.features, features: featuresList, maxVisible: PRODUCT_FEATURE_CARD_MAX_VISIBLE, className: "mt-2" })), (onAddToCart || onBuyNow) && (_jsxs(Div, { className: "mt-2 grid gap-1.5", style: { gridTemplateColumns: onBuyNow && onAddToCart ? "1fr 1fr" : "1fr" }, children: [onBuyNow && (_jsxs(Button, { type: "button", onClick: (e) => {
+                    })(), product.rating !== undefined && (_jsxs(Row, { className: "mt-1 gap-1 items-center", children: [_jsx(Span, { className: "text-[11px] text-amber-400", children: "\u2605" }), _jsxs(Span, { className: "text-[11px] text-zinc-500 dark:text-zinc-400", children: [product.rating.toFixed(1), product.reviewCount ? ` (${product.reviewCount})` : ""] })] })), _jsxs(Div, { className: "mt-auto pt-2", children: [_jsxs(Row, { className: "items-baseline gap-2", children: [_jsx(Span, { className: "text-base font-bold text-primary dark:text-primary-400", children: formatCurrency(product.price, getDefaultCurrency()) }), product.originalPrice && product.originalPrice > product.price && (_jsx(Span, { className: "text-xs text-zinc-400 line-through dark:text-zinc-500", children: formatCurrency(product.originalPrice, getDefaultCurrency()) }))] }), (() => {
+                                const stock = product.stockCount ?? product.stockQuantity ?? product.availableQuantity;
+                                if (stock === undefined || isAuction)
+                                    return null;
+                                if (stock <= 0) {
+                                    return (_jsx(Text, { className: "mt-1 text-[11px] font-semibold text-rose-500", children: "Out of stock" }));
+                                }
+                                const low = stock <= 5;
+                                return (_jsx(Text, { className: `mt-1 text-[11px] font-medium ${low
+                                        ? "text-amber-600 dark:text-amber-400"
+                                        : "text-zinc-500 dark:text-zinc-400"}`, children: low ? `Only ${stock} left` : `${stock} in stock` }));
+                            })(), featuresList && product.features && product.features.length > 0 && (_jsx(FeatureBadgeList, { productFeatureIds: product.features, features: featuresList, maxVisible: PRODUCT_FEATURE_CARD_MAX_VISIBLE, className: "mt-2" })), (onAddToCart || onBuyNow) && (_jsxs(Div, { className: "mt-2 grid gap-1.5", style: { gridTemplateColumns: onBuyNow && onAddToCart ? "1fr 1fr" : "1fr" }, children: [onBuyNow && (_jsxs(Button, { type: "button", onClick: (e) => {
                                             e.stopPropagation();
                                             e.preventDefault();
                                             onBuyNow(product);
@@ -99,7 +104,18 @@ function ProductListRow({ product, onClick, onAddToWishlist, isWishlisted, }) {
             onClick ? "cursor-pointer" : "",
         ]
             .filter(Boolean)
-            .join(" "), children: [_jsx(Div, { className: "flex-shrink-0 w-16 h-16 sm:w-20 sm:h-20 rounded-lg overflow-hidden bg-neutral-100 dark:bg-zinc-800", children: product.mainImage ? (_jsx(MediaImage, { src: product.mainImage, alt: product.title, size: "thumbnail" })) : (_jsx(Div, { className: "w-full h-full bg-neutral-200 dark:bg-zinc-700" })) }), _jsxs(Div, { className: "flex flex-1 flex-col min-w-0 gap-0.5", children: [_jsx(Text, { className: `${THEME_CONSTANTS.utilities.textClamp2} text-sm font-medium text-zinc-900 dark:text-zinc-100`, children: product.title }), (product.categoryName || product.brand) && (_jsx(Span, { className: "text-[11px] text-zinc-400 dark:text-zinc-500 truncate", children: [product.categoryName, product.brand].filter(Boolean).join(" · ") })), _jsxs(Div, { className: "flex items-center gap-2 flex-wrap mt-0.5", children: [_jsx(Span, { className: "text-sm font-semibold text-primary", children: formatCurrency(product.price, getDefaultCurrency()) }), discount && (_jsxs(Span, { className: "text-[10px] font-bold text-rose-500", children: ["-", discount, "%"] })), product.rating !== undefined && (_jsxs(Span, { className: "text-[11px] text-zinc-400 dark:text-zinc-500 flex items-center gap-0.5", children: [_jsx(Span, { className: "text-amber-400", children: "\u2605" }), product.rating.toFixed(1)] }))] })] }), onAddToWishlist && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: (e) => {
+            .join(" "), children: [_jsx(Div, { className: "flex-shrink-0 w-16 h-16 sm:w-20 sm:h-20 rounded-lg overflow-hidden bg-neutral-100 dark:bg-zinc-800", children: product.mainImage ? (_jsx(MediaImage, { src: product.mainImage, alt: product.title, size: "thumbnail" })) : (_jsx(Div, { className: "w-full h-full bg-neutral-200 dark:bg-zinc-700" })) }), _jsxs(Div, { className: "flex flex-1 flex-col min-w-0 gap-0.5", children: [_jsx(Text, { className: `${THEME_CONSTANTS.utilities.textClamp2} text-sm font-medium text-zinc-900 dark:text-zinc-100`, children: product.title }), (product.categoryName || product.brand) && (_jsx(Span, { className: "text-[11px] text-zinc-400 dark:text-zinc-500 truncate", children: [product.categoryName, product.brand].filter(Boolean).join(" · ") })), _jsxs(Div, { className: "flex items-center gap-2 flex-wrap mt-0.5", children: [_jsx(Span, { className: "text-sm font-semibold text-primary", children: formatCurrency(product.price, getDefaultCurrency()) }), discount && (_jsxs(Span, { className: "text-[10px] font-bold text-rose-500", children: ["-", discount, "%"] })), product.rating !== undefined && (_jsxs(Span, { className: "text-[11px] text-zinc-400 dark:text-zinc-500 flex items-center gap-0.5", children: [_jsx(Span, { className: "text-amber-400", children: "\u2605" }), product.rating.toFixed(1)] })), (() => {
+                                const stock = product.stockCount ?? product.stockQuantity ?? product.availableQuantity;
+                                if (stock === undefined)
+                                    return null;
+                                if (stock <= 0) {
+                                    return (_jsx(Span, { className: "text-[11px] font-semibold text-rose-500", children: "Out of stock" }));
+                                }
+                                const low = stock <= 5;
+                                return (_jsx(Span, { className: `text-[11px] font-medium ${low
+                                        ? "text-amber-600 dark:text-amber-400"
+                                        : "text-zinc-400 dark:text-zinc-500"}`, children: low ? `Only ${stock} left` : `${stock} in stock` }));
+                            })()] })] }), onAddToWishlist && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: (e) => {
                     e.stopPropagation();
                     onAddToWishlist(product.id);
                 }, "aria-label": isWishlisted ? "Remove from wishlist" : "Add to wishlist", className: `flex-shrink-0 h-8 w-8 flex items-center justify-center rounded-full text-base leading-none ${isWishlisted ? "text-rose-500" : "text-zinc-300 dark:text-zinc-600 hover:text-rose-400"}`, children: isWishlisted ? "♥" : "♡" }))] }));

package/dist/features/products/components/ShowGroupSection.js

@@ -20,7 +20,7 @@ function MemberThumb({ member, isCurrent }) {
                     ? "border-[var(--appkit-color-primary,#6366f1)] ring-2 ring-[var(--appkit-color-primary,#6366f1)]/30"
                     : "border-zinc-200 dark:border-zinc-700 group-hover:border-[var(--appkit-color-primary,#6366f1)]"}`, children: [image ? (
                     // eslint-disable-next-line @next/next/no-img-element
-                    _jsx("img", { src: image, alt: member.title, className: "w-full h-full object-cover", loading: "lazy" })) : (_jsx("div", { className: "w-full h-full bg-zinc-100 dark:bg-zinc-800 flex items-center justify-center text-zinc-400 text-xs", children: "\u25EF" })), member.isGroupParent && (_jsx("span", { className: "absolute bottom-0 right-0 bg-[var(--appkit-color-primary,#6366f1)] text-white text-[8px] leading-none px-1 py-0.5 rounded-tl", children: "Set" }))] }), _jsx(Text, { className: "text-[10px] text-center text-zinc-600 dark:text-zinc-400 leading-tight line-clamp-2 w-full", children: member.title }), _jsx(Text, { className: "text-[10px] font-semibold text-zinc-800 dark:text-zinc-200", children: price })] }));
+                    _jsx("img", { src: image, alt: member.title, className: "w-full h-full object-cover", loading: "lazy" })) : (_jsx("div", { className: "w-full h-full bg-zinc-100 dark:bg-zinc-800 flex items-center justify-center text-zinc-400 text-xs", children: "\u00E2\u2014\u00AF" })), member.isGroupParent && (_jsx("span", { className: "absolute bottom-0 right-0 bg-[var(--appkit-color-primary,#6366f1)] text-white text-[8px] leading-none px-1 py-0.5 rounded-tl", children: "Set" }))] }), _jsx(Text, { className: "text-[10px] text-center text-zinc-600 dark:text-zinc-400 leading-tight line-clamp-2 w-full", children: member.title }), _jsx(Text, { className: "text-[10px] font-semibold text-zinc-800 dark:text-zinc-200", children: price })] }));
 }
 function GroupTableRow({ member }) {
     const href = memberHref(member);
@@ -28,7 +28,7 @@ function GroupTableRow({ member }) {
     const image = member.images?.[0] ?? "";
     return (_jsxs("tr", { className: "border-b border-zinc-100 dark:border-zinc-800 last:border-0", children: [_jsx("td", { className: "py-2 pr-3", children: _jsx("div", { className: "w-10 h-10 rounded-full overflow-hidden border border-zinc-200 dark:border-zinc-700", children: image ? (
                     // eslint-disable-next-line @next/next/no-img-element
-                    _jsx("img", { src: image, alt: member.title, className: "w-full h-full object-cover", loading: "lazy" })) : (_jsx("div", { className: "w-full h-full bg-zinc-100 dark:bg-zinc-800" })) }) }), _jsxs("td", { className: "py-2 pr-3", children: [_jsx(Text, { className: "text-sm text-zinc-800 dark:text-zinc-200 font-medium line-clamp-2", children: member.title }), member.isGroupParent && (_jsx("span", { className: "text-[10px] text-[var(--appkit-color-primary,#6366f1)] font-semibold", children: "Parent" }))] }), _jsx("td", { className: "py-2 pr-3", children: _jsx(Text, { className: "text-sm text-zinc-700 dark:text-zinc-300", children: price }) }), _jsx("td", { className: "py-2 pr-3", children: _jsx(Text, { className: "text-xs text-zinc-500 dark:text-zinc-400 capitalize", children: member.condition ?? "—" }) }), _jsx("td", { className: "py-2", children: _jsx(Link, { href: href, className: "text-xs text-[var(--appkit-color-primary,#6366f1)] hover:underline", children: "View \u2192" }) })] }));
+                    _jsx("img", { src: image, alt: member.title, className: "w-full h-full object-cover", loading: "lazy" })) : (_jsx("div", { className: "w-full h-full bg-zinc-100 dark:bg-zinc-800" })) }) }), _jsxs("td", { className: "py-2 pr-3", children: [_jsx(Text, { className: "text-sm text-zinc-800 dark:text-zinc-200 font-medium line-clamp-2", children: member.title }), member.isGroupParent && (_jsx("span", { className: "text-[10px] text-[var(--appkit-color-primary,#6366f1)] font-semibold", children: "Parent" }))] }), _jsx("td", { className: "py-2 pr-3", children: _jsx(Text, { className: "text-sm text-zinc-700 dark:text-zinc-300", children: price }) }), _jsx("td", { className: "py-2 pr-3", children: _jsx(Text, { className: "text-xs text-zinc-500 dark:text-zinc-400 capitalize", children: member.condition ?? "—" }) }), _jsx("td", { className: "py-2", children: _jsx(Link, { href: href, className: "text-xs text-[var(--appkit-color-primary,#6366f1)] hover:underline", children: "View \u00E2\u2020\u2019" }) })] }));
 }
 export function ShowGroupSection({ groupId, currentSlug, isParent, groupTitle }) {
     const [open, setOpen] = useState(false);
@@ -51,7 +51,7 @@ export function ShowGroupSection({ groupId, currentSlug, isParent, groupTitle })
     const parentLabel = isParent ? `Parts in this group: ${label}` : `Part of: ${label}`;
     const useDrawer = members.length >= 5;
     const tableContent = (_jsx("div", { className: "overflow-x-auto", children: _jsxs("table", { className: "w-full text-left min-w-[400px]", children: [_jsx("thead", { children: _jsxs("tr", { className: "border-b border-zinc-200 dark:border-zinc-700", children: [_jsx("th", { className: "pb-2 pr-3 text-xs font-semibold text-zinc-500 dark:text-zinc-400", children: "Image" }), _jsx("th", { className: "pb-2 pr-3 text-xs font-semibold text-zinc-500 dark:text-zinc-400", children: "Name" }), _jsx("th", { className: "pb-2 pr-3 text-xs font-semibold text-zinc-500 dark:text-zinc-400", children: "Price" }), _jsx("th", { className: "pb-2 pr-3 text-xs font-semibold text-zinc-500 dark:text-zinc-400", children: "Condition" }), _jsx("th", { className: "pb-2 text-xs font-semibold text-zinc-500 dark:text-zinc-400" })] }) }), _jsx("tbody", { children: members.map((m) => _jsx(GroupTableRow, { member: m }, m.id)) })] }) }));
-    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "rounded-xl border border-zinc-200 dark:border-zinc-700 bg-zinc-50/60 dark:bg-zinc-800/40 overflow-hidden", children: [_jsxs("button", { type: "button", onClick: () => setOpen((v) => !v), className: "w-full flex items-center justify-between px-4 py-3 text-left hover:bg-zinc-100/70 dark:hover:bg-zinc-800/70 transition-colors", "aria-expanded": open, children: [_jsxs(Row, { align: "center", gap: "xs", children: [_jsx("span", { className: "text-xs text-zinc-400 dark:text-zinc-500 mr-1", children: open ? "▼" : "▶" }), _jsx(Text, { className: "text-sm font-medium text-zinc-800 dark:text-zinc-200", children: parentLabel }), _jsx("span", { className: "ml-1 rounded-full bg-zinc-200 dark:bg-zinc-700 px-2 py-0.5 text-xs text-zinc-600 dark:text-zinc-400", children: members.length })] }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); setShowAll(true); }, className: "text-xs text-[var(--appkit-color-primary,#6366f1)] hover:underline ml-3 flex-shrink-0", children: "View whole group \u2192" })] }), open && (_jsx("div", { className: "px-4 pb-4 pt-1 overflow-x-auto", children: _jsx("div", { className: "flex gap-3 min-w-0", children: [...members]
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "rounded-xl border border-zinc-200 dark:border-zinc-700 bg-zinc-50/60 dark:bg-zinc-800/40 overflow-hidden", children: [_jsxs("button", { type: "button", onClick: () => setOpen((v) => !v), className: "w-full flex items-center justify-between px-4 py-3 text-left hover:bg-zinc-100/70 dark:hover:bg-zinc-800/70 transition-colors", "aria-expanded": open, children: [_jsxs(Row, { align: "center", gap: "xs", children: [_jsx("span", { className: "text-xs text-zinc-400 dark:text-zinc-500 mr-1", children: open ? "â–¼" : "â–¶" }), _jsx(Text, { className: "text-sm font-medium text-zinc-800 dark:text-zinc-200", children: parentLabel }), _jsx("span", { className: "ml-1 rounded-full bg-zinc-200 dark:bg-zinc-700 px-2 py-0.5 text-xs text-zinc-600 dark:text-zinc-400", children: members.length })] }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); setShowAll(true); }, className: "text-xs text-[var(--appkit-color-primary,#6366f1)] hover:underline ml-3 flex-shrink-0", children: "View whole group \u00E2\u2020\u2019" })] }), open && (_jsx("div", { className: "px-4 pb-4 pt-1 overflow-x-auto", children: _jsx("div", { className: "flex gap-3 min-w-0", children: [...members]
                                 .sort((a, b) => (b.isGroupParent ? 1 : 0) - (a.isGroupParent ? 1 : 0))
                                 .map((m) => (_jsx(MemberThumb, { member: m, isCurrent: m.slug === currentSlug || m.id === currentSlug }, m.id))) }) }))] }), useDrawer ? (_jsx(SideDrawer, { isOpen: showAll, onClose: () => setShowAll(false), title: label, children: tableContent })) : (_jsx(Modal, { open: showAll, onClose: () => setShowAll(false), title: label, children: tableContent }))] }));
 }

package/dist/features/products/components/SublistingCarouselSection.js

@@ -22,7 +22,7 @@ function ListingThumb({ listing, isCurrent, }) {
                     ? "border-[var(--appkit-color-primary,#6366f1)] ring-2 ring-[var(--appkit-color-primary,#6366f1)]/30"
                     : "border-zinc-200 dark:border-zinc-700 group-hover:border-[var(--appkit-color-primary,#6366f1)]"}`, children: image ? (
                 // eslint-disable-next-line @next/next/no-img-element
-                _jsx("img", { src: image, alt: listing.title, className: "w-full h-full object-cover", loading: "lazy" })) : (_jsx("div", { className: "w-full h-full bg-zinc-100 dark:bg-zinc-800 flex items-center justify-center text-zinc-400 text-xs", children: "\u25EF" })) }), _jsx(Text, { className: "text-[10px] text-center text-zinc-600 dark:text-zinc-400 leading-tight line-clamp-2 w-full", children: listing.title }), _jsx(Text, { className: "text-[10px] font-semibold text-zinc-800 dark:text-zinc-200", children: price })] }));
+                _jsx("img", { src: image, alt: listing.title, className: "w-full h-full object-cover", loading: "lazy" })) : (_jsx("div", { className: "w-full h-full bg-zinc-100 dark:bg-zinc-800 flex items-center justify-center text-zinc-400 text-xs", children: "\u00E2\u2014\u00AF" })) }), _jsx(Text, { className: "text-[10px] text-center text-zinc-600 dark:text-zinc-400 leading-tight line-clamp-2 w-full", children: listing.title }), _jsx(Text, { className: "text-[10px] font-semibold text-zinc-800 dark:text-zinc-200", children: price })] }));
 }
 export function SublistingCarouselSection({ sublistingCategoryId, currentListingId }) {
     const [open, setOpen] = useState(false);
@@ -50,5 +50,5 @@ export function SublistingCarouselSection({ sublistingCategoryId, currentListing
     if (others.length === 0)
         return null;
     const label = category?.name ?? "More listings like this";
-    return (_jsxs("div", { className: "rounded-xl border border-zinc-200 dark:border-zinc-700 bg-zinc-50/60 dark:bg-zinc-800/40 overflow-hidden", children: [_jsxs("button", { type: "button", onClick: () => setOpen((v) => !v), className: "w-full flex items-center justify-between px-4 py-3 text-left hover:bg-zinc-100/70 dark:hover:bg-zinc-800/70 transition-colors", "aria-expanded": open, children: [_jsxs(Row, { align: "center", gap: "xs", children: [_jsx("span", { className: "text-xs text-zinc-400 dark:text-zinc-500 mr-1", children: open ? "▼" : "▶" }), _jsxs(Text, { className: "text-sm font-medium text-zinc-800 dark:text-zinc-200", children: ["More listings like this:", " ", _jsx("span", { className: "text-[var(--appkit-color-primary,#6366f1)]", children: label })] }), _jsx("span", { className: "ml-1 rounded-full bg-zinc-200 dark:bg-zinc-700 px-2 py-0.5 text-xs text-zinc-600 dark:text-zinc-400", children: listings.length })] }), category && (_jsx(Link, { href: String(ROUTES.PUBLIC.SUBLISTING_CATEGORY(category.slug)), onClick: (e) => e.stopPropagation(), className: "text-xs text-[var(--appkit-color-primary,#6366f1)] hover:underline ml-3 flex-shrink-0", children: "View all \u2192" }))] }), open && (_jsx("div", { className: "px-4 pb-4 pt-1 overflow-x-auto", children: _jsx("div", { className: "flex gap-3 min-w-0", children: listings.map((listing) => (_jsx(ListingThumb, { listing: listing, isCurrent: listing.id === currentListingId }, listing.id))) }) }))] }));
+    return (_jsxs("div", { className: "rounded-xl border border-zinc-200 dark:border-zinc-700 bg-zinc-50/60 dark:bg-zinc-800/40 overflow-hidden", children: [_jsxs("button", { type: "button", onClick: () => setOpen((v) => !v), className: "w-full flex items-center justify-between px-4 py-3 text-left hover:bg-zinc-100/70 dark:hover:bg-zinc-800/70 transition-colors", "aria-expanded": open, children: [_jsxs(Row, { align: "center", gap: "xs", children: [_jsx("span", { className: "text-xs text-zinc-400 dark:text-zinc-500 mr-1", children: open ? "â–¼" : "â–¶" }), _jsxs(Text, { className: "text-sm font-medium text-zinc-800 dark:text-zinc-200", children: ["More listings like this:", " ", _jsx("span", { className: "text-[var(--appkit-color-primary,#6366f1)]", children: label })] }), _jsx("span", { className: "ml-1 rounded-full bg-zinc-200 dark:bg-zinc-700 px-2 py-0.5 text-xs text-zinc-600 dark:text-zinc-400", children: listings.length })] }), category && (_jsx(Link, { href: String(ROUTES.PUBLIC.SUBLISTING_CATEGORY(category.slug)), onClick: (e) => e.stopPropagation(), className: "text-xs text-[var(--appkit-color-primary,#6366f1)] hover:underline ml-3 flex-shrink-0", children: "View all \u00E2\u2020\u2019" }))] }), open && (_jsx("div", { className: "px-4 pb-4 pt-1 overflow-x-auto", children: _jsx("div", { className: "flex gap-3 min-w-0", children: listings.map((listing) => (_jsx(ListingThumb, { listing: listing, isCurrent: listing.id === currentListingId }, listing.id))) }) }))] }));
 }

package/dist/features/products/components/index.d.ts

@@ -17,10 +17,6 @@ export { MarketplacePrizeDrawCard } from "./MarketplacePrizeDrawCard";
 export type { MarketplacePrizeDrawCardProps, MarketplacePrizeDrawCardData, MarketplacePrizeDrawCardLabels, } from "./MarketplacePrizeDrawCard";
 export { PrizeDrawsIndexListing } from "./PrizeDrawsIndexListing";
 export type { PrizeDrawsIndexListingProps } from "./PrizeDrawsIndexListing";
-export { PrizeDrawsListingView } from "./PrizeDrawsListingView";
-export type { PrizeDrawsListingViewProps } from "./PrizeDrawsListingView";
-export { PrizeDrawDetailPageView } from "./PrizeDrawDetailPageView";
-export type { PrizeDrawDetailPageViewProps } from "./PrizeDrawDetailPageView";
 export { PrizeDrawEntryActions } from "./PrizeDrawEntryActions";
 export type { PrizeDrawEntryActionsProps } from "./PrizeDrawEntryActions";
 export { ProductFeaturesSelector } from "./ProductFeaturesSelector";

package/dist/features/products/components/index.js

@@ -8,8 +8,11 @@ export { PrizeDrawCollage } from "./PrizeDrawCollage";
 export { PrizeRevealModal } from "./PrizeRevealModal";
 export { MarketplacePrizeDrawCard } from "./MarketplacePrizeDrawCard";
 export { PrizeDrawsIndexListing } from "./PrizeDrawsIndexListing";
-export { PrizeDrawsListingView } from "./PrizeDrawsListingView";
-export { PrizeDrawDetailPageView } from "./PrizeDrawDetailPageView";
+// PrizeDrawsListingView + PrizeDrawDetailPageView are server components that
+// import productRepository (→ firebase-admin). Re-exporting them from this
+// client-mixed barrel pulls firebase-admin into client bundles via webpack/
+// Turbopack tree-shaking gaps (see CLAUDE.md "appkit Export Rules"). Consume
+// them directly from their file paths via the appkit main index instead.
 export { PrizeDrawEntryActions } from "./PrizeDrawEntryActions";
 export { ProductFeaturesSelector } from "./ProductFeaturesSelector";
 export { ProductFeatureBadges } from "./ProductFeatureBadges";

package/dist/features/products/index.d.ts

@@ -9,5 +9,5 @@ export * from "./components";
 export * from "./schemas";
 export * from "./columns";
 export { manifest } from "./manifest";
-export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, } from "./utils/listing-type";
+export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, } from "./utils/listing-type";
 export { sanitizeProductForPublic, sanitizeProductsForPublic, } from "./utils/sanitize";

package/dist/features/products/index.js

@@ -9,5 +9,7 @@ export * from "./components";
 export * from "./schemas";
 export * from "./columns";
 export { manifest } from "./manifest";
-export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, } from "./utils/listing-type";
+export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, 
+// SB-UNI-F 2026-05-13 — Phase 2 predicates.
+isClassifiedListing, isDigitalCodeListing, isLiveListing, } from "./utils/listing-type";
 export { sanitizeProductForPublic, sanitizeProductsForPublic, } from "./utils/sanitize";

package/dist/features/products/repository/products.repository.js

@@ -401,6 +401,10 @@ export class ProductRepository extends BaseRepository {
         batch.update(this.db.collection(this.collection).doc(productId), {
             currentBid,
             bidCount: increment(1),
+            // SB-UNI-H 2026-05-13 — flip `bidsHaveStarted` when any bid lands.
+            // Idempotent on subsequent bids; the BIN button is hidden by the PDP
+            // as soon as this is true (eBay-style hybrid auction rule).
+            bidsHaveStarted: true,
             updatedAt: serverTimestamp(),
         });
     }

package/dist/features/products/schemas/catalog-product.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Catalog Product schema — SB-UNI-L Phase 4 foundation slice 2026-05-13.
+ *
+ * Splits the per-seller `ProductDocument` (now `SellerOfferDocument` in
+ * spirit — see the optional `catalogProductId` link added in firestore.ts)
+ * out from a shared catalog row that aggregates N offers for the same SKU.
+ *
+ * Two modes per offer:
+ *   1. catalog-linked — `SellerOffer.catalogProductId` points at a
+ *      `CatalogProductDocument`. The PDP at `/catalog/{slug}` aggregates
+ *      every offer linked to the catalog row; sellers compete on price/
+ *      condition. Used for graded cards, sealed boxes, mass-produced toys.
+ *   2. standalone — `catalogProductId` is undefined. PDP renders at
+ *      `/products/{slug}` (the current path). Used for one-of-a-kind items
+ *      (custom dioramas, signed memorabilia, prototypes).
+ *
+ * The full PDP routing + admin "Promote to catalog" workflow lands in the
+ * Phase 4 second cohort. This file is the schema foundation — types, slug
+ * prefix, capability flag — so consumers can start writing against the
+ * shape today.
+ */
+import type { GradingService, ProductCardMetadata } from "./firestore";
+/** Identifier types attached to a catalog row for SKU-level deduplication. */
+export interface CatalogIdentifiers {
+    /** Industry standard SKU. */
+    gtin?: string;
+    /** Manufacturer part number. */
+    mpn?: string;
+    /** Internal catalog id (e.g. TCGPlayer product id). */
+    externalId?: string;
+}
+/**
+ * Top-level catalog row. One per SKU; offers link via `catalogProductId`.
+ *
+ * Slug prefix: `catalog-{slug}` (added to CLAUDE.md table by this commit).
+ */
+export interface CatalogProductDocument {
+    id: string;
+    slug: string;
+    title: string;
+    description?: string;
+    brandSlug?: string;
+    categorySlug?: string;
+    /** Card metadata reused from the per-offer schema for indexing parity. */
+    card?: ProductCardMetadata;
+    /** Optional grading service if the catalog row tracks slabs. */
+    gradingService?: GradingService;
+    /** Canonical images shared by all linked offers. */
+    images: string[];
+    /** Catalog-level identifiers (GTIN / MPN / external). */
+    identifiers?: CatalogIdentifiers;
+    /** Denormalised — count of active offers linking to this catalog row. */
+    offerCount: number;
+    /** Denormalised — minimum priceInPaise across active linked offers. */
+    minOfferPriceInPaise?: number;
+    /** Catalog is searchable / showable on `/catalog/{slug}`. */
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+    /** Admin who promoted this catalog from an offer (audit trail). */
+    promotedBy?: string;
+}
+export declare const CATALOG_COLLECTION: "catalogProducts";
+export declare const CATALOG_PUBLIC_FIELDS: readonly ["id", "slug", "title", "description", "brandSlug", "categorySlug", "card", "gradingService", "images", "identifiers", "offerCount", "minOfferPriceInPaise", "isActive", "createdAt", "updatedAt"];
+export declare const CATALOG_UPDATABLE_FIELDS: readonly ["title", "description", "brandSlug", "categorySlug", "card", "gradingService", "images", "identifiers", "isActive"];
+export type CatalogProductCreateInput = Omit<CatalogProductDocument, "id" | "createdAt" | "updatedAt" | "offerCount" | "minOfferPriceInPaise"> & {
+    offerCount?: number;
+    minOfferPriceInPaise?: number;
+};
+export type CatalogProductUpdateInput = Partial<Pick<CatalogProductDocument, (typeof CATALOG_UPDATABLE_FIELDS)[number]>>;

package/dist/features/products/schemas/catalog-product.js

@@ -0,0 +1,50 @@
+/**
+ * Catalog Product schema — SB-UNI-L Phase 4 foundation slice 2026-05-13.
+ *
+ * Splits the per-seller `ProductDocument` (now `SellerOfferDocument` in
+ * spirit — see the optional `catalogProductId` link added in firestore.ts)
+ * out from a shared catalog row that aggregates N offers for the same SKU.
+ *
+ * Two modes per offer:
+ *   1. catalog-linked — `SellerOffer.catalogProductId` points at a
+ *      `CatalogProductDocument`. The PDP at `/catalog/{slug}` aggregates
+ *      every offer linked to the catalog row; sellers compete on price/
+ *      condition. Used for graded cards, sealed boxes, mass-produced toys.
+ *   2. standalone — `catalogProductId` is undefined. PDP renders at
+ *      `/products/{slug}` (the current path). Used for one-of-a-kind items
+ *      (custom dioramas, signed memorabilia, prototypes).
+ *
+ * The full PDP routing + admin "Promote to catalog" workflow lands in the
+ * Phase 4 second cohort. This file is the schema foundation — types, slug
+ * prefix, capability flag — so consumers can start writing against the
+ * shape today.
+ */
+export const CATALOG_COLLECTION = "catalogProducts";
+export const CATALOG_PUBLIC_FIELDS = [
+    "id",
+    "slug",
+    "title",
+    "description",
+    "brandSlug",
+    "categorySlug",
+    "card",
+    "gradingService",
+    "images",
+    "identifiers",
+    "offerCount",
+    "minOfferPriceInPaise",
+    "isActive",
+    "createdAt",
+    "updatedAt",
+];
+export const CATALOG_UPDATABLE_FIELDS = [
+    "title",
+    "description",
+    "brandSlug",
+    "categorySlug",
+    "card",
+    "gradingService",
+    "images",
+    "identifiers",
+    "isActive",
+];