@mohasinac/appkit 2.6.1 → 2.6.3

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

@@ -19,6 +19,22 @@ declare class OrderRepository extends BaseRepository<OrderDocument> {
     cancelOrder(orderId: string, reason: string, refundAmount?: number): Promise<OrderDocument>;
     findRecentByUser(userId: string): Promise<OrderDocument[]>;
     hasUserPurchased(userId: string, productId: string): Promise<boolean>;
+    /**
+     * SB6-B — count this user's "active" orders for a given product. Used by
+     * the order-creation API to enforce `product.maxPerUser` on pre-orders +
+     * prize draws. Active = pending / confirmed / processing / shipped /
+     * delivered. Cancelled + refunded are intentionally excluded.
+     *
+     * Firestore caveat: an `in` over the 5-status set keeps this a single
+     * round-trip; we filter in memory if the active set ever grows past 10.
+     */
+    countByUserAndProduct(userId: string, productId: string): Promise<number>;
+    /**
+     * SB6-B — count this user's active orders for a given bundle. Same
+     * active-status filter as `countByUserAndProduct`. Bundle orders set
+     * `order.bundleId` at creation time (SB3 / SB6-C).
+     */
+    countByUserAndBundle(userId: string, bundleId: string): Promise<number>;
     deleteByUser(userId: string): Promise<number>;
     static readonly SELLER_SIEVE_FIELDS: {
         id: {

package/dist/features/orders/repository/orders.repository.js

@@ -6,13 +6,30 @@ import { createOrderId, ORDER_COLLECTION, OrderStatusValues, } from "../schemas"
 const ORDER_FIELDS = {
     USER_ID: "userId",
     PRODUCT_ID: "productId",
+    BUNDLE_ID: "bundleId",
     STATUS: "status",
     STATUS_VALUES: {
+        PENDING: "pending",
         CONFIRMED: "confirmed",
+        PROCESSING: "processing",
         SHIPPED: "shipped",
         DELIVERED: "delivered",
+        CANCELLED: "cancelled",
+        REFUNDED: "refunded",
     },
 };
+/**
+ * Statuses that count toward a user's per-product / per-bundle purchase
+ * allowance (SB6 maxPerUser enforcement). Cancelled and refunded orders are
+ * intentionally excluded — the inventory was returned to circulation.
+ */
+const ACTIVE_ALLOWANCE_STATUSES = [
+    ORDER_FIELDS.STATUS_VALUES.PENDING,
+    ORDER_FIELDS.STATUS_VALUES.CONFIRMED,
+    ORDER_FIELDS.STATUS_VALUES.PROCESSING,
+    ORDER_FIELDS.STATUS_VALUES.SHIPPED,
+    ORDER_FIELDS.STATUS_VALUES.DELIVERED,
+];
 class OrderRepository extends BaseRepository {
     constructor() {
         super(ORDER_COLLECTION);
@@ -109,6 +126,38 @@ class OrderRepository extends BaseRepository {
             .get();
         return snapshot.docs.some((doc) => purchasedStatuses.has(doc.data()[ORDER_FIELDS.STATUS]));
     }
+    /**
+     * SB6-B — count this user's "active" orders for a given product. Used by
+     * the order-creation API to enforce `product.maxPerUser` on pre-orders +
+     * prize draws. Active = pending / confirmed / processing / shipped /
+     * delivered. Cancelled + refunded are intentionally excluded.
+     *
+     * Firestore caveat: an `in` over the 5-status set keeps this a single
+     * round-trip; we filter in memory if the active set ever grows past 10.
+     */
+    async countByUserAndProduct(userId, productId) {
+        const snapshot = await this.db
+            .collection(this.collection)
+            .where(ORDER_FIELDS.USER_ID, "==", userId)
+            .where(ORDER_FIELDS.PRODUCT_ID, "==", productId)
+            .where(ORDER_FIELDS.STATUS, "in", ACTIVE_ALLOWANCE_STATUSES)
+            .get();
+        return snapshot.size;
+    }
+    /**
+     * SB6-B — count this user's active orders for a given bundle. Same
+     * active-status filter as `countByUserAndProduct`. Bundle orders set
+     * `order.bundleId` at creation time (SB3 / SB6-C).
+     */
+    async countByUserAndBundle(userId, bundleId) {
+        const snapshot = await this.db
+            .collection(this.collection)
+            .where(ORDER_FIELDS.USER_ID, "==", userId)
+            .where(ORDER_FIELDS.BUNDLE_ID, "==", bundleId)
+            .where(ORDER_FIELDS.STATUS, "in", ACTIVE_ALLOWANCE_STATUSES)
+            .get();
+        return snapshot.size;
+    }
     async deleteByUser(userId) {
         try {
             const snapshot = await this.getCollection()

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

@@ -53,6 +53,14 @@ export interface OrderDocumentItem {
     quantity: number;
     unitPrice: number;
     totalPrice: number;
+    /** SB8-F — set when the item is a prize-draw entry; drives the reveals badge. */
+    listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
+    /** SB8-F — per-item reveal status; flips through pending → open → revealed/closed. */
+    prizeRevealStatus?: "pending" | "open" | "closed" | "revealed";
+    /** SB8-F — ISO timestamp; deadline by which the buyer must claim the prize. */
+    prizeRevealDeadline?: string;
+    /** SB8-F — set after the reveal API picks a winner. */
+    revealedItemNumber?: number;
 }
 /** One applied discount/coupon saved on the order for accounting and display */
 export interface AppliedOrderDiscount {

package/dist/features/orders/types/index.d.ts

@@ -23,6 +23,18 @@ export interface OrderItem {
     currency?: string;
     storeId?: string;
     attributes?: Record<string, string>;
+    /** Listing kind at the time of order — needed for prize-draw UI hints (SB8-F). */
+    listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
+    /**
+     * Per-item prize-draw reveal status (SB8-F). Populated by the checkout
+     * actions when listingType === "prize-draw". Used to render the
+     * "X reveals pending" badge on user orders.
+     */
+    prizeRevealStatus?: "pending" | "open" | "closed" | "revealed";
+    /** ISO timestamp — when the user must claim their reveal before forfeit. */
+    prizeRevealDeadline?: string;
+    /** Set after the reveal endpoint picks a winner — the prize item index. */
+    revealedItemNumber?: number;
 }
 export interface OrderTimeline {
     status: OrderStatus;

package/dist/features/orders/utils/order-splitter.d.ts

@@ -1,4 +1,4 @@
-export type OrderType = "standard" | "preorder" | "auction" | "offer";
+export type OrderType = "standard" | "preorder" | "auction" | "offer" | "prize-draw";
 export interface OrderGroup<T> {
     items: T[];
     orderType: OrderType;
@@ -18,7 +18,7 @@ export declare function splitCartIntoOrderGroups<T extends {
     item: {
         itemId: string;
         storeId?: string;
-        listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+        listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
         isOffer?: boolean;
     };
 }>(checks: T[]): OrderGroup<T>[];

package/dist/features/orders/utils/order-splitter.js

@@ -23,6 +23,11 @@ export function splitCartIntoOrderGroups(checks) {
             key = `offer:${item.itemId}`;
             orderType = "offer";
         }
+        else if (item.listingType === "prize-draw") {
+            // Each prize-draw entry is its own order (single reveal per order).
+            key = `prize-draw:${item.itemId}`;
+            orderType = "prize-draw";
+        }
         else if (item.listingType === "pre-order") {
             key = `preorder:${item.storeId ?? "unknown"}`;
             orderType = "preorder";

package/dist/features/payments/migrations.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationStep } from "../../_internal/shared/schema-versions";
+export declare const migrations: Record<number, MigrationStep<any>>;

package/dist/features/payments/migrations.js

@@ -0,0 +1,10 @@
+// SB-UNI X3 — migrations shell for payout.
+// v1 schema is current; no migrations needed yet.
+//
+// To add a migration:
+//   1. Bump the relevant SCHEMA_VERSIONS entry in
+//      `_internal/shared/schema-versions.ts` (e.g. `payments: 2`)
+//   2. Add a row below keyed by the FROM-version, returning the upgraded doc
+//   3. Repository wraps reads with `migrateDocument(doc, current, migrations)`
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const migrations = {};

package/dist/features/pre-orders/components/PreOrderDetailPageView.js

@@ -74,6 +74,9 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
         ? p.preOrderProductionStatus
         : null;
     const isCancellable = p.preOrderCancellable === true;
+    const maxPerUser = typeof p.maxPerUser === "number" && p.maxPerUser > 0
+        ? p.maxPerUser
+        : null;
     const condition = typeof p.condition === "string" ? p.condition : null;
     const featured = p.featured === true;
     const shippingPaidBy = p.shippingPaidBy;
@@ -111,7 +114,7 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
                     price: typeof p.price === "number" ? p.price : undefined,
                     storeId: typeof p.storeId === "string" ? p.storeId : undefined,
                     storeName: typeof p.storeName === "string" ? p.storeName : undefined,
-                } }), _jsxs(Container, { size: "xl", className: "px-4 py-6", children: [_jsxs("div", { className: "mb-4 flex items-center justify-between flex-wrap gap-2", children: [_jsxs("nav", { "aria-label": "Breadcrumb", className: "flex items-center gap-1.5 text-xs text-zinc-500 dark:text-zinc-400 flex-wrap", children: [_jsx(Link, { href: String(ROUTES.HOME), className: "hover:text-primary-600 transition-colors", children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.PRE_ORDERS), className: "hover:text-primary-600 transition-colors", children: "Pre-Orders" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: "hover:text-primary-600 transition-colors", children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "text-zinc-700 dark:text-zinc-300 truncate max-w-[200px]", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => (_jsx(ProductGalleryClient, { images: images, productName: title })), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", className: "mb-2 flex-wrap", children: [_jsx(Span, { className: "inline-block rounded-full bg-indigo-100 dark:bg-indigo-900/30 px-2.5 py-0.5 text-xs font-semibold text-indigo-700 dark:text-indigo-300", children: "Pre-Order" }), productionStatus && (_jsx(Span, { className: "inline-block rounded-full bg-zinc-100 dark:bg-zinc-800 px-2.5 py-0.5 text-xs font-medium text-zinc-600 dark:text-zinc-300", children: PRODUCTION_STATUS_LABELS[productionStatus] ?? productionStatus }))] }), _jsx(Heading, { level: 1, className: "text-xl font-bold leading-snug text-zinc-900 dark:text-zinc-50 sm:text-2xl", children: title })] }), deliveryDate && (_jsxs(Row, { align: "center", gap: "xs", className: "text-sm text-zinc-600 dark:text-zinc-400", children: [_jsx(Span, { children: "\uD83D\uDCC5" }), _jsx(Span, { children: "Estimated delivery:" }), _jsx(Span, { className: "font-medium", children: deliveryDate.toLocaleDateString(undefined, { year: "numeric", month: "long" }) })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, returnable: isCancellable, labels: {
+                } }), _jsxs(Container, { size: "xl", className: "px-4 py-6", children: [_jsxs("div", { className: "mb-4 flex items-center justify-between flex-wrap gap-2", children: [_jsxs("nav", { "aria-label": "Breadcrumb", className: "flex items-center gap-1.5 text-xs text-zinc-500 dark:text-zinc-400 flex-wrap", children: [_jsx(Link, { href: String(ROUTES.HOME), className: "hover:text-primary-600 transition-colors", children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.PRE_ORDERS), className: "hover:text-primary-600 transition-colors", children: "Pre-Orders" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: "hover:text-primary-600 transition-colors", children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "text-zinc-700 dark:text-zinc-300 truncate max-w-[200px]", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => (_jsx(ProductGalleryClient, { images: images, productName: title })), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", className: "mb-2 flex-wrap", children: [_jsx(Span, { className: "inline-block rounded-full bg-indigo-100 dark:bg-indigo-900/30 px-2.5 py-0.5 text-xs font-semibold text-indigo-700 dark:text-indigo-300", children: "Pre-Order" }), productionStatus && (_jsx(Span, { className: "inline-block rounded-full bg-zinc-100 dark:bg-zinc-800 px-2.5 py-0.5 text-xs font-medium text-zinc-600 dark:text-zinc-300", children: PRODUCTION_STATUS_LABELS[productionStatus] ?? productionStatus })), maxPerUser !== null && (_jsxs(Span, { className: "inline-block rounded-full bg-amber-100 dark:bg-amber-900/30 px-2.5 py-0.5 text-xs font-medium text-amber-800 dark:text-amber-200", children: ["Limit: ", maxPerUser, " per customer"] }))] }), _jsx(Heading, { level: 1, className: "text-xl font-bold leading-snug text-zinc-900 dark:text-zinc-50 sm:text-2xl", children: title })] }), deliveryDate && (_jsxs(Row, { align: "center", gap: "xs", className: "text-sm text-zinc-600 dark:text-zinc-400", children: [_jsx(Span, { children: "\uD83D\uDCC5" }), _jsx(Span, { children: "Estimated delivery:" }), _jsx(Span, { className: "font-medium", children: deliveryDate.toLocaleDateString(undefined, { year: "numeric", month: "long" }) })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, returnable: isCancellable, labels: {
                                         featured: "Featured",
                                         fasterDelivery: "Faster Delivery",
                                         ratedSeller: "Rated Seller",

package/dist/features/products/actions/product-actions.d.ts

@@ -6,7 +6,7 @@ export interface ProductListActionParams {
     page?: number;
     pageSize?: number;
     /** Canonical listing-kind discriminator (SB1-G Phase 4). */
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+    listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
     featured?: boolean;
     storeId?: string;
     categoriesIn?: string[];

package/dist/features/products/api/[id]/route.js

@@ -15,7 +15,14 @@ import { getProviders } from "../../../../contracts";
 import { createRouteHandler } from "../../../../next";
 import { mediaFieldSchema } from "../../../media/types/index";
 import { storeRepository } from "../../../stores/repository/store.repository";
+// SB-UNI-V — bundlesRepository deleted; bundle stock-sync moves to the
+// `onProductStockChange` Firebase Function (see functions/src/bundle-stock-sync.ts).
 import { sanitizeProductForPublic } from "../../utils/sanitize";
+const UNAVAILABLE_PRODUCT_STATUSES = new Set([
+    "sold",
+    "out_of_stock",
+    "discontinued",
+]);
 function getRepo() {
     const { db } = getProviders();
     if (!db)
@@ -102,10 +109,36 @@ export const PATCH = createRouteHandler({
         if (!isOwner && !isModerator && !isAdmin) {
             return NextResponse.json({ success: false, error: "Not authorized to update this product" }, { status: 403 });
         }
+        // SB4 — once any prize in a prize-draw listing has been won, the listing
+        // is frozen. Sellers can no longer edit it; admins inherit the same lock
+        // (anything they need to change should go through a new listing or a
+        // dedicated remediation script).
+        const prizeItems = product.prizeDrawItems ??
+            [];
+        const anyPrizeWon = prizeItems.some((it) => it?.isWon);
+        if (product.listingType === "prize-draw" &&
+            anyPrizeWon) {
+            return NextResponse.json({
+                success: false,
+                error: "This prize-draw listing is locked because at least one prize has been revealed. Clone it into a new listing if you want to rerun the draw.",
+            }, { status: 409 });
+        }
         const updated = await repo.update(id, {
             ...body,
             updatedAt: new Date().toISOString(),
         });
+        // SB1-H stock-sync — if this PATCH transitioned the product to an
+        // unavailable status, propagate `isSold` to every bundle that lists it.
+        const beforeStatus = product.status;
+        const afterStatus = body?.status;
+        const becameUnavailable = typeof afterStatus === "string" &&
+            UNAVAILABLE_PRODUCT_STATUSES.has(afterStatus) &&
+            beforeStatus !== afterStatus;
+        // SB-UNI-V — bundle stock-sync moved to onProductStockChange Function;
+        // the API route no longer fires fire-and-forget. The product write
+        // triggers the Function via Firestore onWrite. Reference to
+        // `becameUnavailable` retained for telemetry callers.
+        void becameUnavailable;
         return NextResponse.json({ success: true, data: updated });
     },
 });
@@ -134,6 +167,7 @@ export const DELETE = createRouteHandler({
             status: "discontinued",
             updatedAt: new Date().toISOString(),
         });
+        // SB-UNI-V — bundle stock-sync handled by onProductStockChange Function.
         return NextResponse.json({ success: true });
     },
 });

package/dist/features/products/api/route.js

@@ -43,8 +43,6 @@ const productMutateSchema = z
     tags: z.array(z.string()).optional(),
     featured: z.boolean().optional(),
     isPromoted: z.boolean().optional(),
-    isAuction: z.boolean().optional(),
-    isPreOrder: z.boolean().optional(),
     sellerId: z.string().optional(),
     sellerName: z.string().optional(),
     sellerEmail: z.string().email().optional(),
@@ -73,10 +71,7 @@ const SAFE_PRODUCT_FILTER_FIELDS = new Set([
     "storeId",
     "title",
     "price",
-    // SB1-G — canonical discriminator first; legacy booleans retained transitional.
     "listingType",
-    "isAuction",
-    "isPreOrder",
     "featured",
     "isPromoted",
     "stockQuantity",
@@ -126,24 +121,11 @@ function buildFilters(url) {
     const inStock = param(url, "inStock");
     if (inStock === "true")
         parts.push("stockQuantity>0");
-    // SB1-G — public URL still accepts the legacy boolean params; map them to
-    // the canonical listingType clause. ?listingType=auction|pre-order|standard
-    // takes precedence when present.
+    // SB1-G — canonical discriminator. Public URL accepts only ?listingType=X.
     const listingTypeParam = param(url, "listingType");
-    const isAuction = param(url, "isAuction");
-    const isPreOrder = param(url, "isPreOrder");
     if (listingTypeParam) {
         parts.push(`listingType==${listingTypeParam}`);
     }
-    else if (isAuction === "true") {
-        parts.push("listingType==auction");
-    }
-    else if (isPreOrder === "true") {
-        parts.push("listingType==pre-order");
-    }
-    else if (isAuction === "false" && isPreOrder === "false") {
-        parts.push("listingType==standard");
-    }
     const featured = param(url, "featured");
     if (featured === "true")
         parts.push("featured==true");

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" | "bundle";
+    listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
     features?: string[];
 }
 interface CompareFieldLabels {

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

@@ -0,0 +1,24 @@
+import type { ProductItem } from "../types";
+export type MarketplacePrizeDrawCardData = ProductItem;
+export interface MarketplacePrizeDrawCardLabels {
+    prizeDrawBadge?: string;
+    pendingBadge?: string;
+    openBadge?: string;
+    closedBadge?: string;
+    entriesRemainingLabel?: (remaining: number, max: number) => string;
+    pricePerEntryLabel?: string;
+    enterDraw?: string;
+}
+export interface MarketplacePrizeDrawCardProps {
+    product: MarketplacePrizeDrawCardData;
+    className?: string;
+    variant?: "grid" | "list";
+    selectable?: boolean;
+    isSelected?: boolean;
+    onSelect?: (id: string, selected: boolean) => void;
+    href?: string;
+    hrefBuilder?: (product: MarketplacePrizeDrawCardData) => string;
+    onNavigate?: (href: string) => void;
+    labels?: MarketplacePrizeDrawCardLabels;
+}
+export declare function MarketplacePrizeDrawCard({ product, className, variant, selectable, isSelected, onSelect, href, hrefBuilder, onNavigate, labels, }: MarketplacePrizeDrawCardProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,102 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback } from "react";
+import { useRouter } from "next/navigation";
+import { useLongPress } from "../../../react/hooks/useLongPress";
+import { ROUTES } from "../../../next";
+import { formatCurrency } from "../../../utils";
+import { getDefaultCurrency } from "../../../core/baseline-resolver";
+import { BaseListingCard, Button, Div, Row, Span, Text, TextLink, } from "../../../ui";
+import { THEME_CONSTANTS } from "../../../tokens";
+const DEFAULT_LABELS = {
+    prizeDrawBadge: "Prize draw",
+    pendingBadge: "Reveal pending",
+    openBadge: "Reveal open",
+    closedBadge: "Draw closed",
+    entriesRemainingLabel: (remaining, max) => `${remaining}/${max} entries left`,
+    pricePerEntryLabel: "per entry",
+    enterDraw: "Enter draw",
+};
+function statusVariant(status) {
+    switch (status) {
+        case "open":
+            return "bg-emerald-600 text-white";
+        case "closed":
+            return "bg-zinc-500 text-white";
+        case "pending":
+        default:
+            return "bg-amber-500 text-white";
+    }
+}
+function statusLabel(status, labels) {
+    switch (status) {
+        case "open":
+            return labels.openBadge;
+        case "closed":
+            return labels.closedBadge;
+        case "pending":
+        default:
+            return labels.pendingBadge;
+    }
+}
+function resolveHref(product, href, hrefBuilder) {
+    if (href)
+        return href;
+    if (hrefBuilder)
+        return hrefBuilder(product);
+    return ROUTES.PUBLIC.PRIZE_DRAW_DETAIL(product.slug ?? product.id);
+}
+function formatCountdown(target) {
+    if (!target)
+        return null;
+    const t = target instanceof Date ? target.getTime() : new Date(target).getTime();
+    if (Number.isNaN(t))
+        return null;
+    const diff = t - Date.now();
+    if (diff <= 0)
+        return null;
+    const days = Math.floor(diff / 86400000);
+    const hours = Math.floor((diff % 86400000) / 3600000);
+    if (days > 0)
+        return `${days}d ${hours}h`;
+    const minutes = Math.floor((diff % 3600000) / 60000);
+    return `${hours}h ${minutes}m`;
+}
+export function MarketplacePrizeDrawCard({ product, className = "", variant = "grid", selectable = false, isSelected = false, onSelect, href, hrefBuilder, onNavigate, labels, }) {
+    const router = useRouter();
+    const mergedLabels = { ...DEFAULT_LABELS, ...labels };
+    const detailHref = resolveHref(product, href, hrefBuilder);
+    const longPress = useLongPress(() => onSelect?.(product.id, !isSelected));
+    const items = product.prizeDrawItems ?? [];
+    const thumbItems = items.slice(0, 4);
+    const status = product.prizeRevealStatus;
+    const max = product.prizeMaxEntries ?? 0;
+    const current = product.prizeCurrentEntries ?? 0;
+    const remaining = Math.max(0, max - current);
+    const pricePerEntry = product.pricePerEntry ?? product.price;
+    const countdownTarget = status === "pending"
+        ? product.prizeRevealWindowStart
+        : status === "open"
+            ? product.prizeRevealWindowEnd
+            : undefined;
+    const countdown = formatCountdown(countdownTarget);
+    const handleNavigate = useCallback(() => {
+        if (onNavigate) {
+            onNavigate(String(detailHref));
+            return;
+        }
+        router.push(String(detailHref));
+    }, [detailHref, onNavigate, router]);
+    return (_jsxs(BaseListingCard, { isSelected: isSelected, variant: variant, className: className, onMouseDown: !isSelected ? longPress.onMouseDown : undefined, onMouseUp: !isSelected ? longPress.onMouseUp : undefined, onMouseLeave: !isSelected ? longPress.onMouseLeave : undefined, onTouchStart: !isSelected ? longPress.onTouchStart : undefined, onTouchEnd: !isSelected ? longPress.onTouchEnd : undefined, children: [_jsxs(BaseListingCard.Hero, { aspect: "square", variant: variant, children: [_jsx(TextLink, { href: String(detailHref), className: "absolute inset-0 block", children: thumbItems.length > 0 ? (_jsx(Div, { className: "grid grid-cols-2 grid-rows-2 gap-0.5 h-full w-full bg-[var(--appkit-color-surface-muted)]", children: Array.from({ length: 4 }).map((_, i) => {
+                                const it = thumbItems[i];
+                                const img = it?.images?.[0];
+                                return (_jsx(Div, { className: "relative overflow-hidden bg-[var(--appkit-color-surface-muted)]", children: img ? (
+                                    /* eslint-disable-next-line @next/next/no-raw-media-elements, @next/next/no-img-element */
+                                    _jsx("img", { src: img, alt: it?.title ?? `Prize ${i + 1}`, loading: "lazy", className: "absolute inset-0 h-full w-full object-cover" })) : null }, `thumb-${i}`));
+                            }) })) : (_jsx(Div, { className: "absolute inset-0 flex items-center justify-center bg-[var(--appkit-color-surface-muted)]", children: _jsx(Text, { className: "text-xs text-[var(--appkit-color-text-muted)]", children: "No prizes" }) })) }), _jsxs(Div, { className: "absolute right-2 top-2 flex flex-col items-end gap-1", children: [_jsx(Span, { className: "inline-flex items-center rounded-full bg-fuchsia-600 px-2 py-0.5 text-xs font-medium text-white", children: mergedLabels.prizeDrawBadge }), _jsx(Span, { className: `inline-flex items-center rounded-full px-2 py-0.5 text-xs font-medium ${statusVariant(status)}`, children: statusLabel(status, mergedLabels) })] }), status === "closed" ? (_jsx(Div, { className: "absolute inset-0 flex items-center justify-center bg-black/40", children: _jsx(Span, { className: "rounded bg-zinc-900/80 px-3 py-1 text-xs font-bold uppercase tracking-wider text-white", children: mergedLabels.closedBadge }) })) : null, onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: (event) => {
+                            event.stopPropagation();
+                            onSelect(product.id, !isSelected);
+                        }, className: selectable || isSelected
+                            ? "opacity-100"
+                            : "opacity-0 group-hover:opacity-100 transition-opacity" }))] }), _jsxs(BaseListingCard.Info, { variant: variant, children: [_jsx(TextLink, { href: String(detailHref), children: _jsx(Text, { className: `${THEME_CONSTANTS.utilities.textClamp2} text-sm font-medium text-zinc-900 dark:text-zinc-100`, children: product.title }) }), _jsxs(Row, { justify: "between", className: "mt-1 gap-2", children: [_jsxs(Text, { className: "text-sm font-semibold text-zinc-900 dark:text-zinc-100", children: [formatCurrency(pricePerEntry, getDefaultCurrency()), " ", _jsx(Span, { className: "text-xs font-normal text-[var(--appkit-color-text-muted)]", children: mergedLabels.pricePerEntryLabel })] }), max > 0 ? (_jsx(Text, { className: "text-xs text-[var(--appkit-color-text-muted)]", children: mergedLabels.entriesRemainingLabel(remaining, max) })) : null] }), countdown ? (_jsxs(Text, { className: "text-xs text-[var(--appkit-color-text-muted)]", children: [status === "pending" ? "Opens in" : "Closes in", " ", countdown] })) : null, _jsx(Button, { type: "button", variant: "primary", size: "sm", className: "mt-2 w-full text-xs", onClick: handleNavigate, disabled: status === "closed" || remaining === 0, children: mergedLabels.enterDraw })] })] }));
+}

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

@@ -0,0 +1,32 @@
+/**
+ * PrizeDrawCollage (SB4-B)
+ *
+ * Read-only display of a prize-draw's full prize pool. Each cell shows the
+ * primary image, item-number badge, and title. Items with `isWon === true`
+ * are dimmed under a diagonal overlay with a "Won" label so the public
+ * collage truthfully reflects what's still up for grabs.
+ *
+ * Optional `highlightItemNumber` (passed by the reveal modal during animation)
+ * adds an emphasis ring to the cell that just won.
+ */
+import type { PrizeDrawItem } from "../schemas/firestore";
+export interface PrizeDrawCollageProps {
+    items: PrizeDrawItem[];
+    highlightItemNumber?: number;
+    /** Custom click handler — e.g. open detail modal for an item. */
+    onItemClick?: (item: PrizeDrawItem) => void;
+    /** Defaults to "Won". Use for localisation. */
+    wonLabel?: string;
+    /**
+     * Public buyer surfaces pass `true` so the diagonal "Won" overlay never
+     * renders — otherwise potential buyers would see their favorite prize is
+     * already gone and drop out. The seller / admin / winner views leave this
+     * `false` (default) to show real pool state.
+     *
+     * The product adapter for public reads should ALSO strip `isWon` before
+     * sending the items array client-side; this prop is the visual fallback.
+     */
+    hideWonState?: boolean;
+}
+export declare function PrizeDrawCollage({ items, highlightItemNumber, onItemClick, wonLabel, hideWonState, }: PrizeDrawCollageProps): import("react/jsx-runtime").JSX.Element;
+export default PrizeDrawCollage;

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

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Div, Text } from "../../../ui";
+export function PrizeDrawCollage({ items, highlightItemNumber, onItemClick, wonLabel = "Won", hideWonState = false, }) {
+    if (!items.length) {
+        return (_jsx(Div, { className: "rounded border border-dashed border-[var(--appkit-color-border)] p-6 text-center", children: _jsx(Text, { className: "text-sm text-[var(--appkit-color-text-muted)]", children: "No prizes configured yet." }) }));
+    }
+    return (_jsx(Div, { className: "grid grid-cols-2 gap-3 sm:grid-cols-3 md:grid-cols-4", children: items.map((it) => {
+            const cover = it.images?.[0];
+            const isHighlight = highlightItemNumber === it.itemNumber;
+            const Cell = onItemClick ? "button" : "div";
+            return (_jsxs(Cell, { type: onItemClick ? "button" : undefined, onClick: onItemClick ? () => onItemClick(it) : undefined, className: [
+                    "group relative overflow-hidden rounded-lg border bg-[var(--appkit-color-surface)] text-left transition-transform",
+                    "border-[var(--appkit-color-border)]",
+                    isHighlight
+                        ? "ring-2 ring-offset-2 ring-[var(--appkit-color-primary)] scale-[1.02]"
+                        : "hover:scale-[1.01]",
+                ].join(" "), children: [_jsxs(Div, { className: "relative aspect-square w-full", children: [cover ? (
+                            /* eslint-disable-next-line @next/next/no-img-element */
+                            _jsx("img", { src: cover, alt: it.title || `Prize #${it.itemNumber}`, className: "absolute inset-0 h-full w-full object-cover", loading: "lazy" })) : (_jsx(Div, { className: "absolute inset-0 flex items-center justify-center bg-[var(--appkit-color-surface-muted)]", children: _jsx(Text, { className: "text-xs text-[var(--appkit-color-text-muted)]", children: "No image" }) })), _jsxs(Div, { className: "absolute left-2 top-2 rounded bg-black/70 px-1.5 py-0.5 text-xs font-semibold text-white", children: ["#", it.itemNumber] }), it.isWon && !hideWonState ? (_jsxs(_Fragment, { children: [_jsx(Div, { "aria-hidden": true, className: "absolute inset-0 bg-gradient-to-br from-black/60 via-black/30 to-black/60 mix-blend-multiply" }), _jsx(Div, { className: "absolute inset-0 flex items-center justify-center", children: _jsx(Text, { className: "rotate-[-12deg] rounded bg-red-600 px-3 py-1 text-xs font-bold uppercase tracking-wider text-white shadow", children: wonLabel }) })] })) : null] }), _jsxs(Div, { className: "p-2", children: [_jsx(Text, { className: "line-clamp-2 text-sm font-medium", children: it.title || `Prize #${it.itemNumber}` }), it.estimatedValue != null ? (_jsxs(Text, { className: "text-xs text-[var(--appkit-color-text-muted)]", children: ["est. \u20B9", (it.estimatedValue / 100).toLocaleString("en-IN")] })) : null] })] }, `collage-${it.itemNumber}`));
+        }) }));
+}
+export default PrizeDrawCollage;

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

@@ -0,0 +1,27 @@
+import type { ProductDocument } from "../schemas/firestore";
+export interface PrizeDrawDetailPageViewProps {
+    id: string;
+    /**
+     * Pre-fetched product document from the page's server data layer.
+     * When provided, the internal repository call is skipped — deduplicating
+     * the fetch with generateMetadata() via React.cache().
+     */
+    initialPrizeDraw?: ProductDocument | null;
+    /**
+     * Authenticated buyer's uid. When set, the view server-fetches the
+     * buyer's existing-entry count for this draw and renders the SB6-D
+     * personalised "You have X/Y entries used" badge.
+     */
+    currentUserId?: string;
+}
+/**
+ * Public prize-draw detail page (SB4-G).
+ *
+ * Server-fetches the prize-draw product, strips `isWon` from each item before
+ * passing it to `PrizeDrawCollage` so public buyers stay unspoiled, and
+ * delegates the buy-bar to the client `PrizeDrawEntryActions` which surfaces
+ * the `NonRefundableConsentModal` before any add-to-cart happens.
+ *
+ * Reuses the `PreOrderDetailView` (grid-2) shell for layout parity.
+ */
+export declare function PrizeDrawDetailPageView({ id, initialPrizeDraw, currentUserId, }: PrizeDrawDetailPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;