@mohasinac/appkit 2.7.36 → 2.7.38

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

@@ -16,8 +16,8 @@ export declare const orderItemSchema: z.ZodObject<{
     productId: string;
     quantity: number;
     currency?: string | undefined;
-    storeId?: string | undefined;
     image?: string | undefined;
+    storeId?: string | undefined;
     attributes?: Record<string, string> | undefined;
 }, {
     title: string;
@@ -25,8 +25,8 @@ export declare const orderItemSchema: z.ZodObject<{
     productId: string;
     quantity: number;
     currency?: string | undefined;
-    storeId?: string | undefined;
     image?: string | undefined;
+    storeId?: string | undefined;
     attributes?: Record<string, string> | undefined;
 }>;
 export declare const orderTimelineSchema: z.ZodObject<{
@@ -76,8 +76,8 @@ export declare const orderSchema: z.ZodObject<{
         productId: string;
         quantity: number;
         currency?: string | undefined;
-        storeId?: string | undefined;
         image?: string | undefined;
+        storeId?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }, {
         title: string;
@@ -85,8 +85,8 @@ export declare const orderSchema: z.ZodObject<{
         productId: string;
         quantity: number;
         currency?: string | undefined;
-        storeId?: string | undefined;
         image?: string | undefined;
+        storeId?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }>, "many">;
     address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -131,8 +131,8 @@ export declare const orderSchema: z.ZodObject<{
         productId: string;
         quantity: number;
         currency?: string | undefined;
-        storeId?: string | undefined;
         image?: string | undefined;
+        storeId?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }[];
     total: number;
@@ -143,10 +143,10 @@ export declare const orderSchema: z.ZodObject<{
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     notes?: string | undefined;
+    tax?: number | undefined;
     trackingNumber?: string | undefined;
     couponCode?: string | undefined;
     shippingCarrier?: string | undefined;
-    tax?: number | undefined;
     discount?: number | undefined;
     paymentGateway?: string | undefined;
     shippingCost?: number | undefined;
@@ -166,8 +166,8 @@ export declare const orderSchema: z.ZodObject<{
         productId: string;
         quantity: number;
         currency?: string | undefined;
-        storeId?: string | undefined;
         image?: string | undefined;
+        storeId?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }[];
     total: number;
@@ -178,10 +178,10 @@ export declare const orderSchema: z.ZodObject<{
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     notes?: string | undefined;
+    tax?: number | undefined;
     trackingNumber?: string | undefined;
     couponCode?: string | undefined;
     shippingCarrier?: string | undefined;
-    tax?: number | undefined;
     discount?: number | undefined;
     paymentGateway?: string | undefined;
     shippingCost?: number | undefined;
@@ -202,15 +202,15 @@ export declare const orderListParamsSchema: z.ZodObject<{
     perPage: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     sort?: string | undefined;
-    perPage?: number | undefined;
     page?: number | undefined;
+    perPage?: number | undefined;
     userId?: string | undefined;
     paymentStatus?: string | undefined;
     orderStatus?: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned" | undefined;
 }, {
     sort?: string | undefined;
-    perPage?: number | undefined;
     page?: number | undefined;
+    perPage?: number | undefined;
     userId?: string | undefined;
     paymentStatus?: string | undefined;
     orderStatus?: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned" | undefined;

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

@@ -71,6 +71,11 @@ export interface Order {
     shippingCarrier?: string;
     notes?: string;
     timeline?: OrderTimeline[];
+    physicalLocation?: {
+        zone: string;
+        shelf: string;
+        bin: string;
+    };
     createdAt?: string;
     updatedAt?: string;
 }

package/dist/features/payments/schemas/index.d.ts

@@ -39,8 +39,8 @@ export declare const paymentRecordSchema: z.ZodObject<{
     createdAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     currency: string;
+    status: "pending" | "failed" | "captured" | "authorized" | "refunded" | "partially_refunded";
     id: string;
-    status: "failed" | "captured" | "pending" | "authorized" | "refunded" | "partially_refunded";
     amount: number;
     orderId: string;
     gateway: "bank_transfer" | "upi" | "razorpay" | "stripe" | "paypal" | "cod" | "whatsapp";
@@ -52,8 +52,8 @@ export declare const paymentRecordSchema: z.ZodObject<{
     orderId: string;
     gateway: "bank_transfer" | "upi" | "razorpay" | "stripe" | "paypal" | "cod" | "whatsapp";
     currency?: string | undefined;
+    status?: "pending" | "failed" | "captured" | "authorized" | "refunded" | "partially_refunded" | undefined;
     createdAt?: string | undefined;
-    status?: "failed" | "captured" | "pending" | "authorized" | "refunded" | "partially_refunded" | undefined;
     gatewayPaymentId?: string | undefined;
 }>;
 export declare const paymentGatewayConfigSchema: z.ZodObject<{
@@ -64,14 +64,14 @@ export declare const paymentGatewayConfigSchema: z.ZodObject<{
     sortOrder: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     id: string;
+    displayName: string;
     gateway: "bank_transfer" | "upi" | "razorpay" | "stripe" | "paypal" | "cod" | "whatsapp";
     isEnabled: boolean;
-    displayName: string;
     sortOrder: number;
 }, {
     id: string;
-    gateway: "bank_transfer" | "upi" | "razorpay" | "stripe" | "paypal" | "cod" | "whatsapp";
     displayName: string;
+    gateway: "bank_transfer" | "upi" | "razorpay" | "stripe" | "paypal" | "cod" | "whatsapp";
     isEnabled?: boolean | undefined;
     sortOrder?: number | undefined;
 }>;

package/dist/features/pre-orders/schemas/index.d.ts

@@ -22,18 +22,18 @@ export declare const preorderItemSchema: z.ZodObject<{
         source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
         youtubeId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        type: "video" | "image" | "file";
         url: string;
-        source?: "upload" | "youtube" | "external" | undefined;
+        type: "image" | "video" | "file";
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }, {
-        type: "video" | "image" | "file";
         url: string;
-        source?: "upload" | "youtube" | "external" | undefined;
+        type: "image" | "video" | "file";
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }>, "many">>;
     salePrice: z.ZodNumber;
@@ -56,11 +56,11 @@ export declare const preorderItemSchema: z.ZodObject<{
     brand?: string | undefined;
     images?: string[] | undefined;
     media?: {
-        type: "video" | "image" | "file";
         url: string;
-        source?: "upload" | "youtube" | "external" | undefined;
+        type: "image" | "video" | "file";
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
     franchise?: string | undefined;
@@ -75,11 +75,11 @@ export declare const preorderItemSchema: z.ZodObject<{
     brand?: string | undefined;
     images?: string[] | undefined;
     media?: {
-        type: "video" | "image" | "file";
         url: string;
-        source?: "upload" | "youtube" | "external" | undefined;
+        type: "image" | "video" | "file";
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
     active?: boolean | undefined;

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

@@ -93,7 +93,7 @@ export function PrizeDrawItemsEditor({ items, onChange, onUploadImage, onUploadV
                                                     }), disabled: locked, placeholder: "2999" }) })] }), _jsxs(Stack, { gap: "xs", children: [_jsxs(Text, { className: "text-sm font-medium", children: ["Images (", (it.images ?? []).length, "/", MAX_IMAGES_PER_ITEM, ")"] }), _jsx(Row, { gap: "sm", className: "flex-wrap", children: Array.from({ length: MAX_IMAGES_PER_ITEM }).map((_, slot) => {
                                                     const existing = (it.images ?? [])[slot];
                                                     return (_jsxs(Div, { className: "w-40", children: [_jsx(ImageUpload, { currentImage: existing, label: existing ? "Replace" : `Image ${slot + 1}`, onUpload: (file) => onUploadImage(file, it.itemNumber), onChange: (url) => setImage(index, slot, url) }), existing && !locked ? (_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => removeImage(index, slot), children: "Remove" })) : null] }, slot));
-                                                }) })] }), onUploadVideo ? (_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { className: "text-sm font-medium", children: "Video (optional)" }), _jsx("input", { type: "file", accept: "video/mp4,video/webm", disabled: locked, onChange: (e) => handleVideoFileChange(e, index, it.itemNumber) }), it.video?.url ? (_jsxs(Text, { className: "text-xs text-[var(--appkit-color-text-muted)] truncate", children: ["Current: ", it.video.url] })) : null] })) : null] })] }, `prize-item-${it.itemNumber}-${index}`));
+                                                }) })] }), onUploadVideo ? (_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { className: "text-sm font-medium", children: "Video (optional)" }), _jsx("input", { type: "file", accept: "video/*", disabled: locked, onChange: (e) => handleVideoFileChange(e, index, it.itemNumber) }), it.video?.url ? (_jsxs(Text, { className: "text-xs text-[var(--appkit-color-text-muted)] truncate", children: ["Current: ", it.video.url] })) : null] })) : null] })] }, `prize-item-${it.itemNumber}-${index}`));
                 }) }), items.length < MIN_ITEMS ? (_jsxs(Div, { className: "rounded border border-red-400/40 bg-red-50 px-3 py-2 text-sm text-red-900 dark:bg-red-900/30 dark:text-red-100", children: ["At least ", MIN_ITEMS, " prizes are required."] })) : null] }));
 }
 export default PrizeDrawItemsEditor;

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

@@ -0,0 +1,16 @@
+export interface ProductDetailActionsProps {
+    productId: string;
+    productSlug: string;
+    productTitle: string;
+    productImage?: string;
+    price?: number;
+    currency?: string;
+    inStock: boolean;
+    variant?: "desktop" | "mobile";
+}
+/**
+ * Wires the three primary product-detail CTAs (Buy Now / Add to Cart / Wishlist)
+ * to the server APIs with guest-fallback. Replaces the previously-unwired
+ * placeholder buttons inside ProductDetailPageView.
+ */
+export declare function ProductDetailActions({ productId, productSlug, productTitle, productImage, price, inStock, variant, }: ProductDetailActionsProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,94 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { useRouter } from "next/navigation";
+import { Button, Stack, LoginRequiredModal } from "../../../ui";
+import { useToast } from "../../../ui/components/Toast";
+import { useAddToCart } from "../../cart/hooks/useAddToCart";
+import { apiClient } from "../../../http";
+import { addToGuestWishlist } from "../../wishlist/utils/guest-wishlist";
+import { ROUTES } from "../../../next";
+import { useAuthGate } from "../../../react/hooks/useAuthGate";
+import { ACTION_ID } from "../constants/action-defs";
+/**
+ * Wires the three primary product-detail CTAs (Buy Now / Add to Cart / Wishlist)
+ * to the server APIs with guest-fallback. Replaces the previously-unwired
+ * placeholder buttons inside ProductDetailPageView.
+ */
+export function ProductDetailActions({ productId, productSlug, productTitle, productImage, price, inStock, variant = "desktop", }) {
+    const router = useRouter();
+    const { showToast } = useToast();
+    const { requireAuth, modalOpen, modalMessage, closeModal } = useAuthGate();
+    const [busy, setBusy] = useState(null);
+    const [wishlisted, setWishlisted] = useState(false);
+    const addCart = useAddToCart({
+        onSuccess: () => showToast("Added to cart", "success"),
+        onError: (err) => showToast(err?.message ?? "Could not add to cart", "error"),
+    });
+    async function handleAddToCart(then) {
+        setBusy("cart");
+        try {
+            await addCart.mutate({
+                productId,
+                quantity: 1,
+                productTitle,
+                productImage,
+                price,
+            });
+            then?.();
+        }
+        finally {
+            setBusy(null);
+        }
+    }
+    async function handleBuyNow() {
+        requireAuth(ACTION_ID.BUY_NOW, async () => {
+            await handleAddToCart(() => router.push(String(ROUTES.USER.CHECKOUT)));
+        });
+    }
+    async function doWishlistAdd() {
+        if (wishlisted)
+            return;
+        setBusy("wish");
+        try {
+            try {
+                await apiClient.post("/api/wishlist", { productId });
+            }
+            catch (err) {
+                const status = err?.status;
+                if (status === 401 || status === 403) {
+                    addToGuestWishlist(productId, "product", {
+                        title: productTitle,
+                        image: productImage,
+                    });
+                }
+                else {
+                    throw err;
+                }
+            }
+            setWishlisted(true);
+            showToast("Saved to wishlist", "success");
+        }
+        catch (err) {
+            const msg = err?.message ?? "Could not save to wishlist";
+            showToast(msg, "error");
+        }
+        finally {
+            setBusy(null);
+        }
+    }
+    function handleWishlist() {
+        requireAuth(ACTION_ID.ADD_TO_WISHLIST, () => {
+            void doWishlistAdd();
+        });
+    }
+    const authModal = (_jsx(LoginRequiredModal, { isOpen: modalOpen, onClose: closeModal, message: modalMessage }));
+    if (variant === "mobile") {
+        return (_jsxs(_Fragment, { children: [authModal, _jsx(Button, { variant: "secondary", size: "sm", className: "shrink-0", disabled: !inStock || busy !== null, onClick: () => handleAddToCart(), children: busy === "cart" ? "Adding…" : "Add to Cart" }), _jsx(Button, { variant: "primary", size: "sm", className: "flex-1", disabled: !inStock || busy !== null, onClick: handleBuyNow, children: !inStock
+                        ? "Out of Stock"
+                        : busy === "buy"
+                            ? "Loading…"
+                            : "Buy Now" })] }));
+    }
+    return (_jsxs(_Fragment, { children: [authModal, _jsxs(Stack, { gap: "sm", children: [_jsx(Button, { variant: "primary", size: "md", className: "w-full", disabled: !inStock || busy !== null, onClick: handleBuyNow, children: !inStock ? "Out of Stock" : busy === "buy" ? "Loading…" : "Buy Now" }), _jsx(Button, { variant: "secondary", size: "md", className: "w-full", disabled: !inStock || busy !== null, onClick: () => handleAddToCart(), children: !inStock ? "Out of Stock" : busy === "cart" ? "Adding…" : "Add to Cart" }), _jsx(Button, { variant: "ghost", size: "md", className: "w-full", disabled: busy !== null || wishlisted, onClick: handleWishlist, children: wishlisted ? "♥ In Wishlist" : "♡ Add to Wishlist" })] })] }));
+}

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

@@ -18,6 +18,21 @@ export interface ProductDetailPageViewProps {
         currency: string;
         minOfferPercent: number;
     }) => React.ReactNode;
+    /**
+     * Renders the primary action buttons (Buy Now / Add to Cart / Wishlist).
+     * Receives variant so a single consumer can render desktop + mobile differently.
+     * When omitted, disabled placeholder buttons render — a loud signal of drift.
+     */
+    renderPrimaryActions?: (opts: {
+        productId: string;
+        productSlug: string;
+        productTitle: string;
+        productImage?: string;
+        price: number | null;
+        currency: string;
+        inStock: boolean;
+        variant: "desktop" | "mobile";
+    }) => React.ReactNode;
     /**
      * SSR-loaded productFeatures (platform + store-scope). When present, the
      * product.features[] IDs render as FeatureBadge pills; the legacy text
@@ -26,4 +41,4 @@ export interface ProductDetailPageViewProps {
      */
     productFeatures?: ProductFeatureDocument[];
 }
-export declare function ProductDetailPageView({ slug, initialProduct, renderOfferAction, productFeatures, }: ProductDetailPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function ProductDetailPageView({ slug, initialProduct, renderOfferAction, renderPrimaryActions, productFeatures, }: ProductDetailPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;

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

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import Link from "next/link";
 import { productRepository, reviewRepository } from "../../../repositories";
 const CLS_BREADCRUMB_LINK = "hover:text-primary-600 transition-colors";
+const ACTION_NOT_WIRED = "Action not wired";
 import { ROUTES } from "../../../next";
 import { getDefaultCurrency } from "../../../core/baseline-resolver";
 import { Button, Container, Div, Heading, Main, RichText, Row, Section, Span, Stack, Text, } from "../../../ui";
@@ -88,7 +89,7 @@ function StarRating({ value }) {
 // ---------------------------------------------------------------------------
 // Component
 // ---------------------------------------------------------------------------
-export async function ProductDetailPageView({ slug, initialProduct, renderOfferAction, productFeatures, }) {
+export async function ProductDetailPageView({ slug, initialProduct, renderOfferAction, renderPrimaryActions, productFeatures, }) {
     // Use pre-fetched data when available to avoid a redundant repository call.
     // The page layer wraps getProductForDetail in React.cache(), so both
     // generateMetadata() and this component share the same in-flight promise.
@@ -247,7 +248,16 @@ export async function ProductDetailPageView({ slug, initialProduct, renderOfferA
                                         codAvailable: "Cash on Delivery",
                                         wishlistCount: (n) => `${n} wishlisted`,
                                         categoryProductCount: (n, cat) => `${n} in ${cat}`,
-                                    } }), productFeatures && features.length > 0 && (_jsx(FeatureBadgeList, { productFeatureIds: features, features: productFeatures })), !productFeatures && features.length > 0 && (_jsxs(Div, { className: "rounded-xl border border-zinc-100 dark:border-zinc-800 bg-zinc-50 dark:bg-zinc-900/60 px-4 py-3", children: [_jsx(Text, { className: "mb-2 text-xs font-semibold uppercase tracking-wide text-zinc-500 dark:text-zinc-400", children: "About this product" }), _jsx("ul", { className: "space-y-1.5", children: features.map((f, i) => (_jsxs("li", { className: "flex items-start gap-2 text-sm text-zinc-700 dark:text-zinc-300", 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-sm leading-relaxed text-zinc-600 dark:text-zinc-400 line-clamp-4" })), safeSeller && (_jsx(Div, { className: "rounded-xl border border-zinc-100 dark:border-zinc-800 bg-zinc-50 dark:bg-zinc-900/60 p-3", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] uppercase tracking-wide text-zinc-400 dark:text-zinc-500 mb-0.5", children: "Sold by" }), _jsx(Text, { className: "text-sm font-semibold text-zinc-800 dark:text-zinc-200", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-3 py-1.5 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" }))] }) }))] })), renderActions: () => (_jsxs(Div, { className: "rounded-xl border border-zinc-100 dark:border-zinc-800 bg-zinc-50 dark:bg-zinc-900/60 p-5 space-y-4", children: [formattedPrice && (_jsxs(Div, { children: [_jsxs(Row, { align: "baseline", gap: "sm", wrap: true, children: [_jsx(Text, { className: "text-2xl font-bold text-zinc-900 dark:text-zinc-50", children: formattedPrice }), formattedOriginal && discount && (_jsxs(_Fragment, { children: [_jsx(Span, { className: "text-sm text-zinc-400 line-through dark:text-zinc-500", children: formattedOriginal }), _jsxs(Span, { className: "rounded-full bg-red-500 px-2 py-0.5 text-xs font-bold text-white", children: ["-", discount, "%"] })] }))] }), inStock && effectiveStock !== null && effectiveStock <= 10 && (_jsxs(Text, { className: "mt-1 text-xs text-amber-600 dark:text-amber-400", children: ["Only ", effectiveStock, " left \u2014 order soon!"] }))] })), _jsxs(Stack, { gap: "sm", children: [_jsx(Button, { variant: "primary", size: "md", className: "w-full", disabled: !inStock, children: inStock ? "Buy Now" : "Out of Stock" }), _jsx(Button, { variant: "secondary", size: "md", className: "w-full", disabled: !inStock, children: inStock ? "Add to Cart" : "Out of Stock" }), _jsx(Button, { variant: "ghost", size: "md", className: "w-full", children: "\u2661 Add to Wishlist" }), allowOffers && productType === "simple" && price !== null && renderOfferAction?.({
+                                    } }), productFeatures && features.length > 0 && (_jsx(FeatureBadgeList, { productFeatureIds: features, features: productFeatures })), !productFeatures && features.length > 0 && (_jsxs(Div, { className: "rounded-xl border border-zinc-100 dark:border-zinc-800 bg-zinc-50 dark:bg-zinc-900/60 px-4 py-3", children: [_jsx(Text, { className: "mb-2 text-xs font-semibold uppercase tracking-wide text-zinc-500 dark:text-zinc-400", children: "About this product" }), _jsx("ul", { className: "space-y-1.5", children: features.map((f, i) => (_jsxs("li", { className: "flex items-start gap-2 text-sm text-zinc-700 dark:text-zinc-300", 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-sm leading-relaxed text-zinc-600 dark:text-zinc-400 line-clamp-4" })), safeSeller && (_jsx(Div, { className: "rounded-xl border border-zinc-100 dark:border-zinc-800 bg-zinc-50 dark:bg-zinc-900/60 p-3", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] uppercase tracking-wide text-zinc-400 dark:text-zinc-500 mb-0.5", children: "Sold by" }), _jsx(Text, { className: "text-sm font-semibold text-zinc-800 dark:text-zinc-200", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-3 py-1.5 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" }))] }) }))] })), renderActions: () => (_jsxs(Div, { className: "rounded-xl border border-zinc-100 dark:border-zinc-800 bg-zinc-50 dark:bg-zinc-900/60 p-5 space-y-4", children: [formattedPrice && (_jsxs(Div, { children: [_jsxs(Row, { align: "baseline", gap: "sm", wrap: true, children: [_jsx(Text, { className: "text-2xl font-bold text-zinc-900 dark:text-zinc-50", children: formattedPrice }), formattedOriginal && discount && (_jsxs(_Fragment, { children: [_jsx(Span, { className: "text-sm text-zinc-400 line-through dark:text-zinc-500", children: formattedOriginal }), _jsxs(Span, { className: "rounded-full bg-red-500 px-2 py-0.5 text-xs font-bold text-white", children: ["-", discount, "%"] })] }))] }), inStock && effectiveStock !== null && effectiveStock <= 10 && (_jsxs(Text, { className: "mt-1 text-xs text-amber-600 dark:text-amber-400", children: ["Only ", effectiveStock, " left \u2014 order soon!"] }))] })), _jsxs(Stack, { gap: "sm", children: [renderPrimaryActions ? (renderPrimaryActions({
+                                            productId: product.id,
+                                            productSlug: product.slug ?? slug,
+                                            productTitle: product.title,
+                                            productImage: product.mainImage,
+                                            price,
+                                            currency,
+                                            inStock,
+                                            variant: "desktop",
+                                        })) : (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "primary", size: "md", className: "w-full", disabled: true, title: ACTION_NOT_WIRED, children: inStock ? "Buy Now" : "Out of Stock" }), _jsx(Button, { variant: "secondary", size: "md", className: "w-full", disabled: true, title: ACTION_NOT_WIRED, children: inStock ? "Add to Cart" : "Out of Stock" }), _jsx(Button, { variant: "ghost", size: "md", className: "w-full", disabled: true, title: ACTION_NOT_WIRED, children: "\u2661 Add to Wishlist" })] })), allowOffers && productType === "simple" && price !== null && renderOfferAction?.({
                                             productId: product.id,
                                             price,
                                             currency,
@@ -266,5 +276,14 @@ export async function ProductDetailPageView({ slug, initialProduct, renderOfferA
                                 content: _jsx(CustomSectionTabContent, { section: s }),
                             })) })), renderBundleSection: bundleMemberships.length > 0
                             ? () => (_jsxs("div", { className: "rounded-xl border border-teal-200 dark:border-teal-800/60 bg-teal-50/60 dark:bg-teal-900/20 p-5", children: [_jsxs("div", { className: "flex items-center gap-2 mb-3", children: [_jsx(Span, { className: "text-teal-600 dark:text-teal-400 text-base", "aria-hidden": "true", children: "\uD83D\uDCE6" }), _jsxs(Text, { className: "text-sm font-semibold text-teal-800 dark:text-teal-200", children: ["Part of ", bundleMemberships.length === 1 ? "a bundle" : `${bundleMemberships.length} bundles`] })] }), _jsx("div", { className: "flex flex-col gap-3", children: bundleMemberships.map((b) => (_jsxs("div", { className: "flex items-center justify-between gap-4 rounded-lg border border-teal-200 dark:border-teal-800/50 bg-white dark:bg-teal-900/30 px-4 py-3", children: [_jsxs("div", { className: "min-w-0", children: [_jsx(Text, { className: "text-xs text-teal-600 dark:text-teal-400 font-medium uppercase tracking-wide mb-0.5", children: "Included in bundle" }), _jsx(Text, { className: "text-sm font-semibold text-zinc-800 dark:text-zinc-100 truncate", children: b.title })] }), _jsx(Link, { href: String(ROUTES.PUBLIC.BUNDLE_DETAIL(b.id)), className: "flex-shrink-0 rounded-lg bg-teal-600 hover:bg-teal-700 px-3 py-1.5 text-xs font-semibold text-white transition-colors", children: "View Bundle \u2192" })] }, b.id))) })] }))
-                            : undefined, renderRelated: () => relatedItems.length > 0 ? (_jsx(RelatedProductsCarousel, { items: relatedItems })) : null }), _jsxs(BuyBar, { children: [formattedPrice && (_jsx(Span, { className: "mr-auto text-sm font-bold text-zinc-900 dark:text-zinc-50", children: formattedPrice })), _jsx(Button, { variant: "secondary", size: "sm", className: "shrink-0", disabled: !inStock, children: "Add to Cart" }), _jsx(Button, { variant: "primary", size: "sm", className: "flex-1", disabled: !inStock, children: inStock ? "Buy Now" : "Out of Stock" })] })] })] }));
+                            : undefined, renderRelated: () => relatedItems.length > 0 ? (_jsx(RelatedProductsCarousel, { items: relatedItems })) : null }), _jsxs(BuyBar, { children: [formattedPrice && (_jsx(Span, { className: "mr-auto text-sm font-bold text-zinc-900 dark:text-zinc-50", children: formattedPrice })), renderPrimaryActions ? (renderPrimaryActions({
+                                productId: product.id,
+                                productSlug: product.slug ?? slug,
+                                productTitle: product.title,
+                                productImage: product.mainImage,
+                                price,
+                                currency,
+                                inStock,
+                                variant: "mobile",
+                            })) : (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "secondary", size: "sm", className: "shrink-0", disabled: true, title: ACTION_NOT_WIRED, children: "Add to Cart" }), _jsx(Button, { variant: "primary", size: "sm", className: "flex-1", disabled: true, title: ACTION_NOT_WIRED, children: inStock ? "Buy Now" : "Out of Stock" })] }))] })] })] }));
 }

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

@@ -90,7 +90,7 @@ export function ProductForm({ product, onChange, isReadonly = false, renderDescr
                     name: product.title || "product",
                     category: (product.categorySlugs?.[0] ?? product.category) || "uncategorized",
                     store: product.storeName || "store",
-                }), onChange: (url) => update({ mainImage: url }), label: t("formMainImage"), helperText: "Recommended: 800x800px (1:1)" })), isReadonly && product.mainImage && (_jsx(FormField, { name: "mainImage", label: t("formMainImage"), type: "text", value: product.mainImage, onChange: () => { }, disabled: true })), !isReadonly && (_jsx(MediaUploadList, { label: t("formGalleryImages"), value: galleryImages, onChange: (fields) => update({ images: fields.map((f) => f.url) }), onUpload: handleGalleryUpload, accept: "image/*", maxItems: 5, maxSizeMB: 10, helperText: t("formGalleryImagesHelper"), onAbort: onMediaAbort })), !isReadonly && (_jsx(MediaUploadField, { label: t("formVideo"), value: product.video?.url || "", onChange: (url) => update({
+                }), onChange: (url) => update({ mainImage: url }), label: t("formMainImage"), helperText: "Recommended: 800x800px (1:1)" })), isReadonly && product.mainImage && (_jsx(FormField, { name: "mainImage", label: t("formMainImage"), type: "text", value: product.mainImage, onChange: () => { }, disabled: true })), !isReadonly && (_jsx(MediaUploadList, { label: t("formGalleryImages"), value: galleryImages, onChange: (fields) => update({ images: fields.map((f) => f.url) }), onUpload: handleGalleryUpload, accept: "image/*,video/*", maxItems: 5, maxSizeMB: 10, helperText: t("formGalleryImagesHelper"), onAbort: onMediaAbort })), !isReadonly && (_jsx(MediaUploadField, { label: t("formVideo"), value: product.video?.url || "", onChange: (url) => update({
                     video: url
                         ? {
                             url,
@@ -178,5 +178,23 @@ export function ProductForm({ product, onChange, isReadonly = false, renderDescr
                     ? "auction"
                     : isPreOrderListing(product)
                         ? "preorder"
-                        : "product"), storeId: product.storeId, disabled: isReadonly }), _jsxs(Div, { children: [_jsx(Heading, { level: 3, className: "mb-1 text-sm font-semibold text-zinc-700 dark:text-zinc-300", children: "Custom Sections" }), _jsx(Text, { className: "mb-3 text-xs text-zinc-500 dark:text-zinc-400", children: "Add up to 3 custom tabs to your product page \u2014 e.g. \"Box Contents\", \"Compatibility\", \"Grading Details\"." }), _jsx(CustomSectionsEditor, { sections: product.customSections ?? [], onChange: (sections) => update({ customSections: sections }) })] }), _jsx(FormField, { name: "shippingInfo", label: t("formShipping"), type: "textarea", value: product.shippingInfo || "", onChange: (value) => update({ shippingInfo: value }), disabled: isReadonly, placeholder: "Shipping information..." }), _jsx(FormField, { name: "returnPolicy", label: t("formReturnPolicy"), type: "textarea", value: product.returnPolicy || "", onChange: (value) => update({ returnPolicy: value }), disabled: isReadonly, placeholder: "Return policy details..." }), product.storeName && (_jsx(FormField, { name: "storeName", label: t("formSeller"), type: "text", value: product.storeName, onChange: () => { }, disabled: true }))] }));
+                        : "product"), storeId: product.storeId, disabled: isReadonly }), _jsxs(Div, { children: [_jsx(Heading, { level: 3, className: "mb-1 text-sm font-semibold text-zinc-700 dark:text-zinc-300", children: "Custom Sections" }), _jsx(Text, { className: "mb-3 text-xs text-zinc-500 dark:text-zinc-400", children: "Add up to 3 custom tabs to your product page \u2014 e.g. \"Box Contents\", \"Compatibility\", \"Grading Details\"." }), _jsx(CustomSectionsEditor, { sections: product.customSections ?? [], onChange: (sections) => update({ customSections: sections }) })] }), _jsx(FormField, { name: "shippingInfo", label: t("formShipping"), type: "textarea", value: product.shippingInfo || "", onChange: (value) => update({ shippingInfo: value }), disabled: isReadonly, placeholder: "Shipping information..." }), _jsx(FormField, { name: "returnPolicy", label: t("formReturnPolicy"), type: "textarea", value: product.returnPolicy || "", onChange: (value) => update({ returnPolicy: value }), disabled: isReadonly, placeholder: "Return policy details..." }), _jsxs(Div, { children: [_jsx(Heading, { level: 3, className: "mb-1 text-sm font-semibold text-zinc-700 dark:text-zinc-300", children: "Physical Inventory" }), _jsx(Text, { className: "mb-3 text-xs text-zinc-500 dark:text-zinc-400", children: "Assign a storage location for warehouse or shelf organisation. Used by the Print & Label Center." }), _jsxs(FormGroup, { columns: 3, children: [_jsx(FormField, { name: "physicalLocation.zone", label: "Zone", type: "text", placeholder: "e.g. A", value: product.physicalLocation?.zone ?? "", onChange: (v) => update({
+                                    physicalLocation: {
+                                        zone: v,
+                                        shelf: product.physicalLocation?.shelf ?? "",
+                                        bin: product.physicalLocation?.bin ?? "",
+                                    },
+                                }), disabled: isReadonly }), _jsx(FormField, { name: "physicalLocation.shelf", label: "Shelf", type: "text", placeholder: "e.g. 3", value: product.physicalLocation?.shelf ?? "", onChange: (v) => update({
+                                    physicalLocation: {
+                                        zone: product.physicalLocation?.zone ?? "",
+                                        shelf: v,
+                                        bin: product.physicalLocation?.bin ?? "",
+                                    },
+                                }), disabled: isReadonly }), _jsx(FormField, { name: "physicalLocation.bin", label: "Bin", type: "text", placeholder: "e.g. Blue", value: product.physicalLocation?.bin ?? "", onChange: (v) => update({
+                                    physicalLocation: {
+                                        zone: product.physicalLocation?.zone ?? "",
+                                        shelf: product.physicalLocation?.shelf ?? "",
+                                        bin: v,
+                                    },
+                                }), disabled: isReadonly })] })] }), product.storeName && (_jsx(FormField, { name: "storeName", label: t("formSeller"), type: "text", value: product.storeName, onChange: () => { }, disabled: true }))] }));
 }

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

@@ -239,7 +239,7 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
     /**
      * Cloud Functions: stage an atomic bid-count increment into a caller-owned WriteBatch.
      */
-    incrementBidCountInBatch(batch: WriteBatch, productId: string, currentBid: number): void;
+    incrementBidCountInBatch(batch: WriteBatch, productId: string, currentBid: number, leadingBidderId?: string): void;
     /**
      * SB6-C / SB4-H — atomically bump `prizeCurrentEntries` by `count`. The
      * checkout transaction calls this after pool-cap validation; the reveal
@@ -248,6 +248,8 @@ export declare class ProductRepository extends BaseRepository<ProductDocument> {
      */
     incrementPrizeEntriesInBatch(batch: WriteBatch, productId: string, count: number): void;
     productRef(productId: string): DocumentReference;
+    /** Cloud Functions: returns refs for draft products older than `cutoff` (for 30-day prune). */
+    getStaleDraftRefs(cutoff: Date): Promise<DocumentReference[]>;
 }
 export declare class ProductsRepository extends ProductRepository {
 }

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

@@ -385,10 +385,11 @@ export class ProductRepository extends BaseRepository {
     /**
      * Cloud Functions: stage an atomic bid-count increment into a caller-owned WriteBatch.
      */
-    incrementBidCountInBatch(batch, productId, currentBid) {
+    incrementBidCountInBatch(batch, productId, currentBid, leadingBidderId) {
         batch.update(this.db.collection(this.collection).doc(productId), {
             currentBid,
             bidCount: increment(1),
+            ...(leadingBidderId && { leadingBidderId }),
             // 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).
@@ -411,6 +412,16 @@ export class ProductRepository extends BaseRepository {
     productRef(productId) {
         return this.db.collection(this.collection).doc(productId);
     }
+    /** Cloud Functions: returns refs for draft products older than `cutoff` (for 30-day prune). */
+    async getStaleDraftRefs(cutoff) {
+        const snap = await this.db
+            .collection(this.collection)
+            .where("status", "==", "draft")
+            .where("updatedAt", "<", cutoff)
+            .limit(200)
+            .get();
+        return snap.docs.map((d) => d.ref);
+    }
 }
 ProductRepository.CACHE_TTL_MS = 30000;
 ProductRepository.SIEVE_FIELDS = {

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

@@ -146,6 +146,7 @@ export interface ProductDocument {
     startingBid?: number;
     currentBid?: number;
     bidCount?: number;
+    leadingBidderId?: string;
     reservePrice?: number;
     buyNowPrice?: number;
     minBidIncrement?: number;
@@ -237,6 +238,12 @@ export interface ProductDocument {
             etaDaysMax?: number;
         }>;
     };
+    /** Physical storage location for inventory management (Print & Label Center). */
+    physicalLocation?: {
+        zone: string;
+        shelf: string;
+        bin: string;
+    };
     createdAt: Date;
     updatedAt: Date;
 }