@mohasinac/appkit 4.9.5 → 4.11.0

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

@@ -16,7 +16,9 @@ import { getDefaultCurrency } from "../../../core/baseline-resolver";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { normalizeRichTextHtml } from "../../../utils/string.formatter";
 import { safeDisplayName } from "../../../security";
-import { Button, Container, Div, Heading, Input, Main, Nav, RichText, Row, Section, Span, Stack, Text, Ul, Li, Dl, Dt, Dd, } from "../../../ui";
+import { getSiteSettingsGlobal } from "../../admin/utils/getSiteSettingsGlobal";
+import { resolveMinBidIncrement, } from "../../../_internal/shared/features/auctions/config";
+import { Button, Container, CountdownDisplay, Div, Heading, Input, Main, Nav, RichText, Row, Section, Span, Stack, Text, Ul, Li, Dl, Dt, Dd, } from "../../../ui";
 import { AuctionDetailView } from "../../products/components/AuctionDetailView";
 import { ProductTabsShell } from "../../products/components/ProductTabsShell";
 import { CustomSectionTabContent } from "../../products/components/CustomSectionTabContent";
@@ -32,6 +34,11 @@ import { listReviewsBySeller } from "../../reviews/actions/review-actions";
 import { PlaceBidModalButton } from "./PlaceBidFormClient";
 import { CollapsibleBidHistory } from "./CollapsibleBidHistory";
 import { LiveBidPrice } from "./LiveBidPrice";
+import { LiveMinIncrement } from "./LiveMinIncrement";
+import { RelatedItemsSection } from "../../products/components/RelatedItemsSection";
+import { computeRelatedItems } from "../../../_internal/server/features/products/data";
+import { GroupedListingsCarousel } from "../../grouped/components/GroupedListingsCarousel";
+import { getGroupsWithItemsForProduct } from "../../../_internal/server/features/grouped/data";
 import { SublistingCarouselSection } from "../../products/components/SublistingCarouselSection";
 function toDescriptionHtml(raw) {
     if (!raw)
@@ -41,7 +48,7 @@ function toDescriptionHtml(raw) {
 }
 function renderAuctionInfoPanel(props) {
     const { productId, title, currentBid, currency, bidCount, isEnded, endDate, buyNowPrice, featured, freeShipping, condition, category, categoryName, brand, brandSlug, productFeatures, features, descriptionHtml, safeSeller, storeHref } = props;
-    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_LIVE_BADGE, children: "\uD83C\uDFF7\uFE0F Live Auction" }), isEnded ? (_jsx(Span, { color: "error", surface: "danger-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Ended" })) : (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Active" }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), _jsxs(Div, { children: [_jsx(Text, { className: "mb-0.5", color: "muted", size: "xs", children: "Current bid" }), _jsx(LiveBidPrice, { productId: productId, currentBid: currentBid, bidCount: bidCount, currency: currency, isEnded: isEnded, priceSize: "2xl", badgeSize: "sm" }), endDate && _jsxs(Text, { className: "mt-1.5", color: "muted", size: "sm", children: [isEnded ? "Ended" : "Ends", " ", _jsx(Span, { weight: "medium", color: "muted", children: endDate.toLocaleString() })] })] }), buyNowPrice !== null && !isEnded && (_jsxs(Row, { align: "center", gap: "sm", className: "border border-[var(--appkit-color-primary-200)] dark:border-[var(--appkit-color-primary-800)] bg-primary-50 dark:bg-primary-900/20", padding: "inlineSm", rounded: "lg", children: [_jsx(Span, { size: "xs", color: "muted", children: "Buy Now:" }), _jsx(Span, { size: "base", weight: "bold", className: "text-primary-700 dark:text-primary-300", children: formatCurrency(buyNowPrice, currency) })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, labels: { featured: "Featured", fasterDelivery: "Faster Delivery", ratedSeller: "Rated Seller", condition: "Condition", conditionNew: "New", conditionUsed: "Used", conditionBroken: "For Parts", conditionRefurbished: "Refurbished", returnable: "Returnable", freeShipping: "Free Shipping", codAvailable: "Cash on Delivery", emiAvailable: "EMI Available", wishlistCount: (n) => `${n} wishlisted`, categoryProductCount: (n, cat) => `${n} in ${cat}` } }), (categoryName || category || brand) && (_jsxs(Row, { gap: "sm", wrap: true, children: [category && _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-50 hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:bg-primary-900/20 dark:hover:text-primary-400", children: categoryName || category }), !category && categoryName && _jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: categoryName }), brand && brandSlug && _jsx(Link, { href: String(ROUTES.PUBLIC.BRAND_DETAIL(brandSlug)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-50 hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:bg-primary-900/20 dark:hover:text-primary-400", children: brand }), brand && !brandSlug && _jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: brand })] })), productFeatures && features.length > 0 && _jsx(FeatureBadgeList, { productFeatureIds: features, features: productFeatures }), !productFeatures && features.length > 0 && (_jsxs(Div, { border: "subtle", surface: "muted", padding: "inline", rounded: "xl", children: [_jsx(Text, { className: "mb-2 tracking-wide", color: "muted", size: "xs", weight: "semibold", transform: "uppercase", children: "About this item" }), _jsx(Ul, { spacing: "comfortable", size: "sm", color: "primary", children: features.map((f, i) => _jsxs(Li, { layout: "flex-start", gap: "2", children: [_jsx(Span, { className: "mt-0.5 flex-shrink-0 text-primary-500", children: "\u2022" }), f] }, i)) })] })), descriptionHtml && _jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" }), safeSeller && (_jsx(Div, { className: `${__P.p3}`, border: "subtle", rounded: "xl", surface: "muted", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Listed by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && _jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" })] }) }))] }));
+    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_LIVE_BADGE, children: "\uD83C\uDFF7\uFE0F Live Auction" }), isEnded ? (_jsx(Span, { color: "error", surface: "danger-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Ended" })) : (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Active" }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), _jsxs(Div, { children: [_jsx(Text, { className: "mb-0.5", color: "muted", size: "xs", children: "Current bid" }), _jsx(LiveBidPrice, { productId: productId, currentBid: currentBid, bidCount: bidCount, currency: currency, isEnded: isEnded, priceSize: "2xl", badgeSize: "sm" }), endDate && !isEnded && (_jsxs(Text, { className: "mt-1.5", color: "muted", size: "sm", children: ["Ends in ", _jsx(Span, { weight: "medium", color: "muted", children: _jsx(CountdownDisplay, { targetDate: endDate, format: "auto", expiredLabel: "Ended" }) })] })), endDate && _jsxs(Text, { className: "mt-0.5", color: "faint", size: "xs", children: [isEnded ? "Ended" : "Ends", " ", endDate.toLocaleString()] })] }), buyNowPrice !== null && !isEnded && (_jsxs(Row, { align: "center", gap: "sm", className: "border border-[var(--appkit-color-primary-200)] dark:border-[var(--appkit-color-primary-800)] bg-primary-50 dark:bg-primary-900/20", padding: "inlineSm", rounded: "lg", children: [_jsx(Span, { size: "xs", color: "muted", children: "Buy Now:" }), _jsx(Span, { size: "base", weight: "bold", className: "text-primary-700 dark:text-primary-300", children: formatCurrency(buyNowPrice, currency) })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, labels: { featured: "Featured", fasterDelivery: "Faster Delivery", ratedSeller: "Rated Seller", condition: "Condition", conditionNew: "New", conditionUsed: "Used", conditionBroken: "For Parts", conditionRefurbished: "Refurbished", returnable: "Returnable", freeShipping: "Free Shipping", codAvailable: "Cash on Delivery", emiAvailable: "EMI Available", wishlistCount: (n) => `${n} wishlisted`, categoryProductCount: (n, cat) => `${n} in ${cat}` } }), (categoryName || category || brand) && (_jsxs(Row, { gap: "sm", wrap: true, children: [category && _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-50 hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:bg-primary-900/20 dark:hover:text-primary-400", children: categoryName || category }), !category && categoryName && _jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: categoryName }), brand && brandSlug && _jsx(Link, { href: String(ROUTES.PUBLIC.BRAND_DETAIL(brandSlug)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-50 hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:bg-primary-900/20 dark:hover:text-primary-400", children: brand }), brand && !brandSlug && _jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: brand })] })), productFeatures && features.length > 0 && _jsx(FeatureBadgeList, { productFeatureIds: features, features: productFeatures }), !productFeatures && features.length > 0 && (_jsxs(Div, { border: "subtle", surface: "muted", padding: "inline", rounded: "xl", children: [_jsx(Text, { className: "mb-2 tracking-wide", color: "muted", size: "xs", weight: "semibold", transform: "uppercase", children: "About this item" }), _jsx(Ul, { spacing: "comfortable", size: "sm", color: "primary", children: features.map((f, i) => _jsxs(Li, { layout: "flex-start", gap: "2", children: [_jsx(Span, { className: "mt-0.5 flex-shrink-0 text-primary-500", children: "\u2022" }), f] }, i)) })] })), descriptionHtml && _jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" }), safeSeller && (_jsx(Div, { className: `${__P.p3}`, border: "subtle", rounded: "xl", surface: "muted", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Listed by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && _jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" })] }) }))] }));
 }
 function renderAuctionStoreReviews(storeReviews) {
     if (storeReviews.length === 0)
@@ -78,7 +85,7 @@ export async function AuctionDetailPageView({ id, initialAuction, onPlaceBid, on
         : typeof p.price === "number"
             ? p.price
             : 0;
-    const minBidIncrement = typeof p.minBidIncrement === "number" ? p.minBidIncrement : 1;
+    const minBidIncrementOverride = typeof p.minBidIncrement === "number" ? p.minBidIncrement : undefined;
     const images = Array.isArray(p.images)
         ? p.images
         : typeof p.mainImage === "string"
@@ -117,6 +124,13 @@ export async function AuctionDetailPageView({ id, initialAuction, onPlaceBid, on
     const relatedDocs = await productRepository
         .findByCategory(String(p.category ?? ""))
         .catch(() => []);
+    const [{ relatedItems, relatedByBrand, relatedByTags, relatedByStore }, groups, siteSettings] = await Promise.all([
+        computeRelatedItems(product),
+        getGroupsWithItemsForProduct(product.id),
+        getSiteSettingsGlobal(),
+    ]);
+    const bidIncrementTiers = siteSettings.auctionConfig?.bidIncrementTiers ?? [];
+    const initialMinBidIncrement = resolveMinBidIncrement(currentBid, bidIncrementTiers, minBidIncrementOverride);
     return (_jsxs(Main, { children: [_jsx(HistoryTracker, { productId: String(p.id ?? p.slug ?? ""), productType: "auction", snapshot: {
                     title: typeof p.title === "string" ? p.title : undefined,
                     thumb: typeof p.mainImage === "string"
@@ -127,9 +141,9 @@ export async function AuctionDetailPageView({ id, initialAuction, onPlaceBid, on
                     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", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.AUCTIONS), className: CLS_BREADCRUMB_LINK, children: "Auctions" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(AuctionDetailView, { renderGallery: () => (_jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title })), renderInfo: () => renderAuctionInfoPanel({ productId: String(product.id), title, currentBid, currency, bidCount, isEnded, endDate, buyNowPrice, featured, freeShipping, condition, category, categoryName, brand, brandSlug, productFeatures, features, descriptionHtml, safeSeller, storeHref }), renderBidForm: () => onPlaceBid ? (_jsx(Stack, { id: "auction-bid-form", gap: "3", children: _jsxs(Stack, { className: `${__P.p5}`, border: "subtle", gap: "3", rounded: "xl", surface: "muted", children: [_jsxs(Row, { justify: "between", align: "baseline", children: [_jsx(LiveBidPrice, { productId: String(product.id), currentBid: currentBid, bidCount: bidCount, currency: currency, isEnded: isEnded, priceSize: "xl", badgeSize: "xs" }), !isEnded && (_jsxs(Span, { size: "xs", color: "muted", children: ["min increment ", formatCurrency(minBidIncrement, currency)] }))] }), _jsx(PlaceBidModalButton, { productId: String(product.id), currentBid: currentBid, startingBid: startingBid, minBidIncrement: minBidIncrement, currency: currency, isEnded: isEnded, buyNowPrice: buyNowPrice, bidsHaveStarted: bidsHaveStarted, bidCount: bidCount, tags: tags, onPlaceBid: onPlaceBid, onBuyNow: onBuyNow, triggerClassName: "w-full" })] }) })) : (
+                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.AUCTIONS), className: CLS_BREADCRUMB_LINK, children: "Auctions" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(AuctionDetailView, { renderGallery: () => (_jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title })), renderInfo: () => renderAuctionInfoPanel({ productId: String(product.id), title, currentBid, currency, bidCount, isEnded, endDate, buyNowPrice, featured, freeShipping, condition, category, categoryName, brand, brandSlug, productFeatures, features, descriptionHtml, safeSeller, storeHref }), renderBidForm: () => onPlaceBid ? (_jsx(Stack, { id: "auction-bid-form", gap: "3", children: _jsxs(Stack, { className: `${__P.p5}`, border: "subtle", gap: "3", rounded: "xl", surface: "muted", children: [_jsxs(Row, { justify: "between", align: "baseline", children: [_jsx(LiveBidPrice, { productId: String(product.id), currentBid: currentBid, bidCount: bidCount, currency: currency, isEnded: isEnded, priceSize: "xl", badgeSize: "xs" }), !isEnded && (_jsx(LiveMinIncrement, { productId: String(product.id), currentBid: currentBid, bidCount: bidCount, currency: currency, isEnded: isEnded, tiers: bidIncrementTiers, minBidIncrementOverride: minBidIncrementOverride }))] }), !isEnded && endDate && (_jsxs(Text, { align: "center", size: "xs", color: "muted", children: ["Ends in ", _jsx(CountdownDisplay, { targetDate: endDate, format: "auto", expiredLabel: "Ended" })] })), _jsx(PlaceBidModalButton, { productId: String(product.id), currentBid: currentBid, startingBid: startingBid, tiers: bidIncrementTiers, minBidIncrementOverride: minBidIncrementOverride, currency: currency, isEnded: isEnded, auctionEndDate: endDate, buyNowPrice: buyNowPrice, bidsHaveStarted: bidsHaveStarted, bidCount: bidCount, tags: tags, onPlaceBid: onPlaceBid, onBuyNow: onBuyNow, triggerClassName: "w-full" })] }) })) : (
                         /* Read-only bid panel — shown when no bid action is wired (preview/demo) */
-                        _jsxs(Stack, { className: `${__P.p5}`, border: "subtle", gap: "md", rounded: "xl", surface: "muted", children: [_jsx(Stack, { gap: "xs", children: _jsxs(Text, { size: "xs", color: "muted", children: ["Starting bid: ", formatCurrency(startingBid, currency), !isEnded && _jsxs(_Fragment, { children: [" \u00B7 min increment ", formatCurrency(minBidIncrement, currency)] })] }) }), _jsxs(Stack, { gap: "sm", children: [_jsx(Input, { type: "number", placeholder: `At least ${formatCurrency(currentBid + minBidIncrement, currency)}`, min: currentBid + minBidIncrement, "aria-label": "Your bid amount", disabled: isEnded }), _jsx(Button, { variant: "primary", size: "md", className: "w-full", disabled: isEnded, children: isEnded ? "Auction Ended" : "Place Bid" }), buyNowPrice !== null && !isEnded && !bidsHaveStarted && (_jsxs(Button, { variant: "secondary", size: "md", className: "w-full", disabled: true, children: ["Buy Now \u2014 ", formatCurrency(buyNowPrice, currency)] }))] }), tags.length > 0 && (_jsx(Div, { border: "default", className: "border-t", padding: "t-md", children: _jsx(Row, { wrap: true, gap: "xs", children: tags.map((tag) => (_jsx(Span, { size: "xs", rounded: "full", padding: "pill-sm-tall", surface: "subtle", color: "muted", children: tag }, tag))) }) }))] })), renderMobileBidForm: () => !isEnded && onPlaceBid ? (_jsxs(Stack, { className: `lg:hidden ${__P.p4}`, border: "subtle", gap: "3", rounded: "xl", surface: "muted", children: [_jsx(LiveBidPrice, { productId: String(product.id), currentBid: currentBid, bidCount: bidCount, currency: currency, isEnded: isEnded, priceSize: "base", badgeSize: "xs" }), _jsx(PlaceBidModalButton, { productId: String(product.id), currentBid: currentBid, startingBid: startingBid, minBidIncrement: minBidIncrement, currency: currency, isEnded: isEnded, buyNowPrice: buyNowPrice, bidsHaveStarted: bidsHaveStarted, bidCount: bidCount, tags: tags, onPlaceBid: onPlaceBid, onBuyNow: onBuyNow, triggerClassName: "w-full" })] })) : !isEnded ? (_jsxs(Div, { className: `${__P.p4} lg:hidden`, border: "subtle", rounded: "xl", surface: "muted", children: [_jsxs(Row, { align: "center", gap: "sm", className: "mb-3", children: [_jsx(Span, { size: "base", weight: "bold", className: "text-primary-600 dark:text-primary-400", children: formatCurrency(currentBid, currency) }), _jsxs(Span, { size: "xs", color: "muted", children: [bidCount, " bids"] })] }), _jsx(Button, { variant: "primary", size: "md", className: "w-full", children: "Place Bid" })] })) : null, renderSublistingSection: sublistingCategoryId
+                        _jsxs(Stack, { className: `${__P.p5}`, border: "subtle", gap: "md", rounded: "xl", surface: "muted", children: [_jsx(Stack, { gap: "xs", children: _jsxs(Text, { size: "xs", color: "muted", children: ["Starting bid: ", formatCurrency(startingBid, currency), !isEnded && _jsxs(_Fragment, { children: [" \u00B7 min increment ", formatCurrency(initialMinBidIncrement, currency)] })] }) }), _jsxs(Stack, { gap: "sm", children: [_jsx(Input, { type: "number", placeholder: `At least ${formatCurrency(currentBid + initialMinBidIncrement, currency)}`, min: currentBid + initialMinBidIncrement, "aria-label": "Your bid amount", disabled: isEnded }), !isEnded && endDate && (_jsxs(Text, { align: "center", size: "xs", color: "muted", children: ["Ends in ", _jsx(CountdownDisplay, { targetDate: endDate, format: "auto", expiredLabel: "Ended" })] })), _jsx(Button, { variant: "primary", size: "md", className: "w-full", disabled: isEnded, children: isEnded ? "Auction Ended" : "Place Bid" }), buyNowPrice !== null && !isEnded && !bidsHaveStarted && (_jsxs(Button, { variant: "secondary", size: "md", className: "w-full", disabled: true, children: ["Buy Now \u2014 ", formatCurrency(buyNowPrice, currency)] }))] }), tags.length > 0 && (_jsx(Div, { border: "default", className: "border-t", padding: "t-md", children: _jsx(Row, { wrap: true, gap: "xs", children: tags.map((tag) => (_jsx(Span, { size: "xs", rounded: "full", padding: "pill-sm-tall", surface: "subtle", color: "muted", children: tag }, tag))) }) }))] })), renderMobileBidForm: () => !isEnded && onPlaceBid ? (_jsxs(Stack, { className: `lg:hidden ${__P.p4}`, border: "subtle", gap: "3", rounded: "xl", surface: "muted", children: [_jsx(LiveBidPrice, { productId: String(product.id), currentBid: currentBid, bidCount: bidCount, currency: currency, isEnded: isEnded, priceSize: "base", badgeSize: "xs" }), endDate && (_jsxs(Text, { align: "center", size: "xs", color: "muted", children: ["Ends in ", _jsx(CountdownDisplay, { targetDate: endDate, format: "auto", expiredLabel: "Ended" })] })), _jsx(PlaceBidModalButton, { productId: String(product.id), currentBid: currentBid, startingBid: startingBid, tiers: bidIncrementTiers, minBidIncrementOverride: minBidIncrementOverride, currency: currency, isEnded: isEnded, auctionEndDate: endDate, buyNowPrice: buyNowPrice, bidsHaveStarted: bidsHaveStarted, bidCount: bidCount, tags: tags, onPlaceBid: onPlaceBid, onBuyNow: onBuyNow, triggerClassName: "w-full" })] })) : !isEnded ? (_jsxs(Div, { className: `${__P.p4} lg:hidden`, border: "subtle", rounded: "xl", surface: "muted", children: [_jsxs(Row, { align: "center", gap: "sm", className: "mb-3", children: [_jsx(Span, { size: "base", weight: "bold", className: "text-primary-600 dark:text-primary-400", children: formatCurrency(currentBid, currency) }), _jsxs(Span, { size: "xs", color: "muted", children: [bidCount, " bids"] })] }), endDate && (_jsxs(Text, { align: "center", className: "mb-3", size: "xs", color: "muted", children: ["Ends in ", _jsx(CountdownDisplay, { targetDate: endDate, format: "auto", expiredLabel: "Ended" })] })), _jsx(Button, { variant: "primary", size: "md", className: "w-full", children: "Place Bid" })] })) : null, renderSublistingSection: sublistingCategoryId
                             ? () => (_jsx(SublistingCarouselSection, { sublistingCategoryId: sublistingCategoryId, currentListingId: String(product.id) }))
                             : undefined, renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(Dl, { divide: "subtle", rounded: "xl", border: "subtle", className: "overflow-hidden", children: specs.map((s, i) => (_jsxs(Row, { gap: "md", oddEven: "zebra", surface: "default", padding: "inline", children: [_jsx(Dt, { className: "w-36 flex-shrink-0", color: "primary", weight: "medium", children: s.name }), _jsxs(Dd, { className: "flex-1", color: "muted", children: [s.value, s.unit ? ` ${s.unit}` : ""] })] }, i))) })) : undefined, customTabs: customSections.map((s) => ({
                                 id: s.id,
@@ -176,8 +190,6 @@ export async function AuctionDetailPageView({ id, initialAuction, onPlaceBid, on
                                 bidCount: typeof r.bidCount === "number" ? r.bidCount : undefined,
                                 slug: typeof r.slug === "string" ? r.slug : undefined,
                             }));
-                            if (related.length === 0)
-                                return null;
-                            return (_jsx(RelatedProducts, { labels: { title: "Similar Auctions" }, renderGrid: () => (_jsx(MarketplaceAuctionGrid, { auctions: related, gridClassName: "grid grid-cols-2 gap-[var(--appkit-space-4)] sm:grid-cols-3 lg:grid-cols-4" })) }));
-                        } }), renderAuctionStoreReviews(storeReviews), _jsx(AuctionBottomActions, { currentBid: currentBid, currency: currency, bidCount: bidCount, isEnded: isEnded })] })] }));
+                            return (_jsxs(Stack, { gap: "xl", children: [related.length > 0 && (_jsx(RelatedProducts, { labels: { title: "Similar Auctions" }, renderGrid: () => (_jsx(MarketplaceAuctionGrid, { auctions: related, gridClassName: "grid grid-cols-2 gap-[var(--appkit-space-4)] sm:grid-cols-3 lg:grid-cols-4" })) })), _jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand || undefined, storeLabel: storeName || undefined })] }));
+                        } }), renderAuctionStoreReviews(storeReviews), _jsx(AuctionBottomActions, { currentBid: currentBid, currency: currency, bidCount: bidCount, isEnded: isEnded, auctionEndDate: endDate })] })] }));
 }

package/dist/features/auctions/components/LiveMinIncrement.d.ts

@@ -0,0 +1,18 @@
+import { type BidIncrementTier } from "../../../_internal/shared/features/auctions/config";
+export interface LiveMinIncrementProps {
+    productId: string;
+    currentBid: number;
+    bidCount: number;
+    currency: string;
+    isEnded: boolean;
+    tiers: BidIncrementTier[];
+    minBidIncrementOverride?: number;
+    size?: "xs" | "sm";
+}
+/**
+ * LiveMinIncrement — the "min increment ₹X" text, kept live via the same
+ * `/auction-bids/{id}` SSE channel `LiveBidPrice` uses. The effective
+ * increment depends on the current bid amount (tiered), so it must keep
+ * resolving against the live current bid, not just the SSR snapshot.
+ */
+export declare function LiveMinIncrement({ productId, currentBid, bidCount, currency, isEnded, tiers, minBidIncrementOverride, size, }: LiveMinIncrementProps): import("react").JSX.Element;

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

@@ -0,0 +1,17 @@
+"use client";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { Span } from "../../../ui";
+import { formatCurrency } from "../../../utils/number.formatter";
+import { useLiveAuctionBid } from "../hooks/useLiveAuctionBid";
+import { resolveMinBidIncrement, } from "../../../_internal/shared/features/auctions/config";
+/**
+ * LiveMinIncrement — the "min increment ₹X" text, kept live via the same
+ * `/auction-bids/{id}` SSE channel `LiveBidPrice` uses. The effective
+ * increment depends on the current bid amount (tiered), so it must keep
+ * resolving against the live current bid, not just the SSR snapshot.
+ */
+export function LiveMinIncrement({ productId, currentBid, bidCount, currency, isEnded, tiers, minBidIncrementOverride, size = "xs", }) {
+    const live = useLiveAuctionBid(productId, currentBid, bidCount, { enabled: !isEnded });
+    const increment = resolveMinBidIncrement(live.currentBid, tiers, minBidIncrementOverride);
+    return (_jsxs(Span, { size: size, color: "muted", children: ["min increment ", formatCurrency(increment, currency)] }));
+}

package/dist/features/auctions/components/PlaceBidFormClient.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import { type BidIncrementTier } from "../../../_internal/shared/features/auctions/config";
 export interface PlaceBidInput {
     productId: string;
     bidAmount: number;
@@ -8,9 +9,11 @@ export interface PlaceBidFormClientProps {
     productId: string;
     currentBid: number;
     startingBid: number;
-    minBidIncrement: number;
+    tiers: BidIncrementTier[];
+    minBidIncrementOverride?: number;
     currency: string;
     isEnded: boolean;
+    auctionEndDate: Date | null;
     buyNowPrice: number | null;
     bidsHaveStarted?: boolean;
     bidCount: number;
@@ -18,7 +21,7 @@ export interface PlaceBidFormClientProps {
     onPlaceBid: (input: PlaceBidInput) => Promise<unknown>;
     onBuyNow?: () => Promise<unknown>;
 }
-export declare function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, minBidIncrement, currency, isEnded, buyNowPrice, bidsHaveStarted, bidCount: ssrBidCount, tags, onPlaceBid, onBuyNow, }: PlaceBidFormClientProps): React.JSX.Element;
+export declare function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded, auctionEndDate, buyNowPrice, bidsHaveStarted, bidCount: ssrBidCount, tags, onPlaceBid, onBuyNow, }: PlaceBidFormClientProps): React.JSX.Element;
 /**
  * `PlaceBidModalButton` — opens a modal that hosts the same PlaceBidFormClient.
  *

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

@@ -4,12 +4,13 @@ import { useState, useTransition } from "react";
 import { useRouter } from "next/navigation";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { isAuthError } from "../../../utils/auth-error";
-import { Button, Div, LoginRequiredModal, Modal, Row, Span, Stack, Text } from "../../../ui";
+import { Button, CountdownDisplay, Div, LoginRequiredModal, Modal, Row, Span, Stack, Text } from "../../../ui";
 import { Form } from "../../../ui/components/Form";
 import { FieldInput } from "../../../ui/forms/FieldInput";
 import { applyZodIssues } from "../../../ui/forms/FormShell";
 import { placeBidSchema } from "../schemas/bid-input";
 import { useLiveAuctionBid } from "../hooks/useLiveAuctionBid";
+import { resolveMinBidIncrement, } from "../../../_internal/shared/features/auctions/config";
 import { normalizeError } from "../../../errors/normalize";
 const __P = {
     p5: "p-[var(--appkit-space-5)]",
@@ -21,13 +22,16 @@ const BID_ERROR_DISPLAY = {
     BID_SELF_BID: "You cannot bid on your own listing.",
     BID_USER_BANNED: "Your account is currently restricted from bidding. Contact support.",
 };
-export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, minBidIncrement, currency, isEnded, buyNowPrice, bidsHaveStarted = false, bidCount: ssrBidCount, tags = [], onPlaceBid, onBuyNow, }) {
+export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded, auctionEndDate, buyNowPrice, bidsHaveStarted = false, bidCount: ssrBidCount, tags = [], onPlaceBid, onBuyNow, }) {
     const router = useRouter();
     // Live-updates while the bid card is open — reflects other bidders'
     // activity on this auction, not just the bidder's own submission.
     const live = useLiveAuctionBid(productId, ssrCurrentBid, ssrBidCount, { enabled: !isEnded });
     const currentBid = live.currentBid;
     const bidCount = live.bidCount;
+    // Tiered, floor-raising: resolves fresh whenever the live current bid
+    // crosses a tier boundary while this modal is open.
+    const minBidIncrement = resolveMinBidIncrement(currentBid, tiers, minBidIncrementOverride);
     const minBid = currentBid + minBidIncrement;
     const [bidAmount, setBidAmount] = useState(String(minBid));
     const [stepMul, setStepMul] = useState(1);
@@ -110,7 +114,7 @@ export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, start
                                     }, children: ["+", formatCurrency(minBidIncrement * n, currency)] }, n))), _jsx(Button, { type: "button", variant: stepMul === "custom" ? "primary" : "ghost", size: "sm", role: "radio", "aria-checked": stepMul === "custom", disabled: isEnded || isPending, onClick: () => setStepMul("custom"), children: "Custom" })] }), _jsx(FieldInput, { name: "bidAmount", type: "number", value: bidAmount, readOnly: stepMul !== "custom", onChange: (value) => {
                                 setBidAmount(value);
                                 clearErrors();
-                            }, placeholder: `At least ${formatCurrency(minBid, currency)}`, min: minBid, "aria-label": "Your bid amount", disabled: isEnded || isPending }), stepMul === "custom" && (_jsxs(Text, { size: "xs", color: "muted", "aria-live": "polite", children: ["Any amount \u2265 ", formatCurrency(minBid, currency), " is accepted."] })), success && (_jsx(Text, { className: "text-success", size: "xs", children: "\u2713 Bid placed successfully!" })), _jsx(Button, { variant: "primary", size: "md", className: "w-full", disabled: isEnded || isPending, isLoading: isPending, type: "button", onClick: () => {
+                            }, placeholder: `At least ${formatCurrency(minBid, currency)}`, min: minBid, "aria-label": "Your bid amount", disabled: isEnded || isPending }), stepMul === "custom" && (_jsxs(Text, { size: "xs", color: "muted", "aria-live": "polite", children: ["Any amount \u2265 ", formatCurrency(minBid, currency), " is accepted."] })), success && (_jsx(Text, { className: "text-success", size: "xs", children: "\u2713 Bid placed successfully!" })), !isEnded && auctionEndDate && (_jsxs(Text, { align: "center", size: "xs", color: "muted", children: ["Ends in ", _jsx(CountdownDisplay, { targetDate: auctionEndDate, format: "auto", expiredLabel: "Ended" })] })), _jsx(Button, { variant: "primary", size: "md", className: "w-full", disabled: isEnded || isPending, isLoading: isPending, type: "button", onClick: () => {
                                 clearErrors();
                                 const parsed = schema.safeParse({ bidAmount });
                                 if (!parsed.success)

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

@@ -28,6 +28,7 @@ export declare const auctionItemSchema: z.ZodObject<{
         thumbnailUrl: z.ZodOptional<z.ZodString>;
         source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
         youtubeId: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         type: "video" | "image" | "file";
         url: string;
@@ -35,6 +36,7 @@ export declare const auctionItemSchema: z.ZodObject<{
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
+        duration?: number | undefined;
     }, {
         type: "video" | "image" | "file";
         url: string;
@@ -42,6 +44,7 @@ export declare const auctionItemSchema: z.ZodObject<{
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
+        duration?: number | undefined;
     }>, "many">>;
     currency: z.ZodString;
     price: z.ZodNumber;
@@ -84,6 +87,7 @@ export declare const auctionItemSchema: z.ZodObject<{
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
+        duration?: number | undefined;
     }[] | undefined;
     storeSlug?: string | undefined;
 }, {
@@ -113,6 +117,7 @@ export declare const auctionItemSchema: z.ZodObject<{
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
+        duration?: number | undefined;
     }[] | undefined;
     storeSlug?: string | undefined;
 }>;

package/dist/features/audit-log/repository/audit-log.repository.d.ts

@@ -0,0 +1,45 @@
+/**
+ * AdminAuditLogRepository — thin wrapper over the `adminAuditLog` collection.
+ * See `appkit/src/features/audit-log/schemas/firestore.ts` for the doc shape.
+ */
+import { BaseRepository, parseSieveDateValue, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
+import { type AdminAuditLogDocument } from "../schemas/firestore";
+export declare class AdminAuditLogRepository extends BaseRepository<AdminAuditLogDocument> {
+    constructor();
+    static readonly SIEVE_FIELDS: {
+        id: {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        actorUid: {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        actorName: {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        action: {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        targetType: {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        targetId: {
+            canFilter: boolean;
+            canSort: boolean;
+        };
+        createdAt: {
+            canFilter: boolean;
+            canSort: boolean;
+            parseValue: typeof parseSieveDateValue;
+        };
+    };
+    /**
+     * Paginated, Firestore-native audit-log list (admin use).
+     */
+    list(model: SieveModel): Promise<FirebaseSieveResult<AdminAuditLogDocument>>;
+}
+export declare const adminAuditLogRepository: AdminAuditLogRepository;

package/dist/features/audit-log/repository/audit-log.repository.js

@@ -0,0 +1,30 @@
+/**
+ * AdminAuditLogRepository — thin wrapper over the `adminAuditLog` collection.
+ * See `appkit/src/features/audit-log/schemas/firestore.ts` for the doc shape.
+ */
+import { BaseRepository, parseSieveDateValue, } from "../../../providers/db-firebase";
+import { ADMIN_AUDIT_LOG_COLLECTION } from "../schemas/firestore";
+export class AdminAuditLogRepository extends BaseRepository {
+    constructor() {
+        super(ADMIN_AUDIT_LOG_COLLECTION);
+    }
+    /**
+     * Paginated, Firestore-native audit-log list (admin use).
+     */
+    async list(model) {
+        return this.sieveQuery(model, AdminAuditLogRepository.SIEVE_FIELDS, {
+            defaultPageSize: 50,
+            maxPageSize: 200,
+        });
+    }
+}
+AdminAuditLogRepository.SIEVE_FIELDS = {
+    id: { canFilter: true, canSort: false },
+    actorUid: { canFilter: true, canSort: false },
+    actorName: { canFilter: true, canSort: false },
+    action: { canFilter: true, canSort: true },
+    targetType: { canFilter: true, canSort: false },
+    targetId: { canFilter: true, canSort: false },
+    createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
+};
+export const adminAuditLogRepository = new AdminAuditLogRepository();

package/dist/features/audit-log/schemas/firestore.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Admin Audit Log Firestore Document Types & Constants
+ *
+ * Collection: adminAuditLog
+ * Document ID: Firestore auto-ID (no slug prefix — see CLAUDE.md "True
+ * Firestore auto-IDs" list, same convention as `notifications`/`sessions`/`jobs`).
+ *
+ * A queryable record of high-value privileged admin actions — bans, checkout
+ * bypass, coupon edits, payout mark-paid, store status changes, role changes.
+ * This is deliberately an MVP scope (instrumenting existing high-value call
+ * sites), not an exhaustive every-write-path audit trail — see CLAUDE.md's
+ * "Admin Audit Log" section for the full instrumented-action list.
+ */
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
+import type { JsonValue } from "../../../schemas/types";
+export declare const ADMIN_AUDIT_LOG_COLLECTION = "adminAuditLog";
+export declare const AdminAuditActionValues: {
+    readonly USER_HARD_BAN: "user_hard_ban";
+    readonly USER_SOFT_BAN: "user_soft_ban";
+    readonly USER_UNBAN: "user_unban";
+    readonly CHECKOUT_BYPASS: "checkout_bypass";
+    readonly COUPON_UPDATE: "coupon_update";
+    readonly PAYOUT_MARK_PAID: "payout_mark_paid";
+    readonly STORE_STATUS_CHANGE: "store_status_change";
+    readonly USER_ROLE_CHANGE: "user_role_change";
+};
+export type AdminAuditAction = (typeof AdminAuditActionValues)[keyof typeof AdminAuditActionValues];
+export interface AdminAuditLogDocument extends BaseDocument {
+    actorUid: string;
+    actorName?: string;
+    action: AdminAuditAction;
+    /** e.g. "user" | "store" | "coupon" | "payout" — the kind of entity affected. */
+    targetType: string;
+    targetId: string;
+    /** Denormalized human-readable label (display name, coupon code, etc.) so the log list never needs a join. */
+    targetLabel?: string;
+    reason?: string;
+    metadata?: Record<string, JsonValue>;
+}
+export declare const ADMIN_AUDIT_LOG_FIELDS: {
+    readonly ACTOR_UID: "actorUid";
+    readonly ACTOR_NAME: "actorName";
+    readonly ACTION: "action";
+    readonly TARGET_TYPE: "targetType";
+    readonly TARGET_ID: "targetId";
+    readonly TARGET_LABEL: "targetLabel";
+    readonly REASON: "reason";
+    readonly CREATED_AT: "createdAt";
+    readonly ACTION_VALUES: {
+        readonly USER_HARD_BAN: "user_hard_ban";
+        readonly USER_SOFT_BAN: "user_soft_ban";
+        readonly USER_UNBAN: "user_unban";
+        readonly CHECKOUT_BYPASS: "checkout_bypass";
+        readonly COUPON_UPDATE: "coupon_update";
+        readonly PAYOUT_MARK_PAID: "payout_mark_paid";
+        readonly STORE_STATUS_CHANGE: "store_status_change";
+        readonly USER_ROLE_CHANGE: "user_role_change";
+    };
+};

package/dist/features/audit-log/schemas/firestore.js

@@ -0,0 +1,35 @@
+/**
+ * Admin Audit Log Firestore Document Types & Constants
+ *
+ * Collection: adminAuditLog
+ * Document ID: Firestore auto-ID (no slug prefix — see CLAUDE.md "True
+ * Firestore auto-IDs" list, same convention as `notifications`/`sessions`/`jobs`).
+ *
+ * A queryable record of high-value privileged admin actions — bans, checkout
+ * bypass, coupon edits, payout mark-paid, store status changes, role changes.
+ * This is deliberately an MVP scope (instrumenting existing high-value call
+ * sites), not an exhaustive every-write-path audit trail — see CLAUDE.md's
+ * "Admin Audit Log" section for the full instrumented-action list.
+ */
+export const ADMIN_AUDIT_LOG_COLLECTION = "adminAuditLog";
+export const AdminAuditActionValues = {
+    USER_HARD_BAN: "user_hard_ban",
+    USER_SOFT_BAN: "user_soft_ban",
+    USER_UNBAN: "user_unban",
+    CHECKOUT_BYPASS: "checkout_bypass",
+    COUPON_UPDATE: "coupon_update",
+    PAYOUT_MARK_PAID: "payout_mark_paid",
+    STORE_STATUS_CHANGE: "store_status_change",
+    USER_ROLE_CHANGE: "user_role_change",
+};
+export const ADMIN_AUDIT_LOG_FIELDS = {
+    ACTOR_UID: "actorUid",
+    ACTOR_NAME: "actorName",
+    ACTION: "action",
+    TARGET_TYPE: "targetType",
+    TARGET_ID: "targetId",
+    TARGET_LABEL: "targetLabel",
+    REASON: "reason",
+    CREATED_AT: "createdAt",
+    ACTION_VALUES: AdminAuditActionValues,
+};

package/dist/features/auth/actions/index.d.ts

@@ -1,3 +1,2 @@
 export * from "./profile-actions";
 export * from "./realtime-token-actions";
-export * from "./password-change-otp-actions";

package/dist/features/auth/actions/index.js

@@ -1,3 +1,2 @@
 export * from "./profile-actions";
 export * from "./realtime-token-actions";
-export * from "./password-change-otp-actions";

package/dist/features/auth/hooks/useAuth.d.ts

@@ -21,10 +21,6 @@ export interface RegisterData {
     displayName?: string;
     acceptTerms: boolean;
 }
-export interface ChangePasswordData {
-    currentPassword: string;
-    newPassword: string;
-}
 export interface ChangeEmailData {
     currentPassword: string;
     newEmail: string;
@@ -91,38 +87,15 @@ export declare function useResetPassword(options?: {
     onError?: (error: Error) => void;
 }): import("@tanstack/react-query").UseMutationResult<JsonValue, Error, ResetPasswordData, unknown>;
 /**
- * Password change is now a 3-step flow (root-caused 2026-08-20 — see
- * appkit/src/features/auth/password-change-otp.ts): the old single-step
- * reauthenticateAndChangePassword() applied the new password immediately
- * client-side, before any server-verified identity check beyond the
- * session cookie. Step order:
- *   1. useRequestPasswordChangeOtp — verifies currentPassword via Firebase
- *      reauth (proves the caller actually knows it, without changing
- *      anything yet), then emails a 6-digit code.
- *   2. useVerifyPasswordChangeOtp — verifies the code server-side.
- *   3. useChangePassword — only now actually applies newPassword; the API
- *      route rejects this call unless step 2 already succeeded.
+ * Password change is Firebase-only (no custom OTP code, no Resend) — the
+ * "Change Password" settings action sends the exact same reset-link email
+ * as "Forgot Password" (see useForgotPassword above), to the signed-in
+ * user's own address. Completing the link requires access to that inbox,
+ * which a stolen session cookie alone can't provide — closing the same gap
+ * the older OTP-code system existed for, through inbox possession instead
+ * of a typed code. There is no separate hook for this: consumers call
+ * useForgotPassword({ email: user.email }) directly from the settings page.
  */
-export declare function useRequestPasswordChangeOtp(options?: {
-    onSuccess?: (data: {
-        maskedEmail: string;
-    }) => void;
-    onError?: (error: Error) => void;
-}): import("@tanstack/react-query").UseMutationResult<{
-    maskedEmail: string;
-}, Error, {
-    currentPassword: string;
-}, unknown>;
-export declare function useVerifyPasswordChangeOtp(options?: {
-    onSuccess?: (data: JsonValue) => void;
-    onError?: (error: Error) => void;
-}): import("@tanstack/react-query").UseMutationResult<JsonValue, Error, {
-    code: string;
-}, unknown>;
-export declare function useChangePassword(options?: {
-    onSuccess?: (data: JsonValue) => void;
-    onError?: (error: Error) => void;
-}): import("@tanstack/react-query").UseMutationResult<JsonValue, Error, ChangePasswordData, unknown>;
 export declare function useChangeEmail(options?: {
     onSuccess?: (data: JsonValue) => void;
     onError?: (error: Error) => void;

package/dist/features/auth/hooks/useAuth.js

@@ -7,7 +7,7 @@ import { getClientSessionAdapter } from "../../../contracts/client-session";
 import { apiClient } from "../../../http";
 import { useAuthEvent } from "./useAuthEvent";
 import { RealtimeEventStatus } from "../../../react/hooks/useRealtimeEvent";
-import { AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, } from "../../../constants/api-endpoints";
+import { AUTH_ENDPOINTS, } from "../../../constants/api-endpoints";
 export function useCurrentUser(opts) {
     const query = useQuery({
         queryKey: ["auth", "me"],
@@ -307,7 +307,18 @@ export function useRegister(options) {
             // `auth.currentUser` is populated for client-side Firebase usage
             // (RTDB presence, etc) — do NOT call /api/auth/session again here,
             // that would create a second, orphaned session document.
-            await getClientAuthProvider().signInWithEmailAndPassword(data.email.trim(), data.password);
+            const authProvider = getClientAuthProvider();
+            await authProvider.signInWithEmailAndPassword(data.email.trim(), data.password);
+            // Verification email is Firebase-native only (no Resend) — see project
+            // policy on "profile related auth changes". Deliberately non-fatal:
+            // the account already exists at this point, so a send failure must not
+            // fail registration — the user can re-request verification later.
+            try {
+                await authProvider.sendEmailVerification();
+            }
+            catch (err) {
+                void normalizeError(err);
+            }
             return { success: true, ...response };
         },
         onSuccess: options?.onSuccess,
@@ -354,42 +365,15 @@ export function useResetPassword(options) {
     });
 }
 /**
- * Password change is now a 3-step flow (root-caused 2026-08-20 — see
- * appkit/src/features/auth/password-change-otp.ts): the old single-step
- * reauthenticateAndChangePassword() applied the new password immediately
- * client-side, before any server-verified identity check beyond the
- * session cookie. Step order:
- *   1. useRequestPasswordChangeOtp — verifies currentPassword via Firebase
- *      reauth (proves the caller actually knows it, without changing
- *      anything yet), then emails a 6-digit code.
- *   2. useVerifyPasswordChangeOtp — verifies the code server-side.
- *   3. useChangePassword — only now actually applies newPassword; the API
- *      route rejects this call unless step 2 already succeeded.
+ * Password change is Firebase-only (no custom OTP code, no Resend) — the
+ * "Change Password" settings action sends the exact same reset-link email
+ * as "Forgot Password" (see useForgotPassword above), to the signed-in
+ * user's own address. Completing the link requires access to that inbox,
+ * which a stolen session cookie alone can't provide — closing the same gap
+ * the older OTP-code system existed for, through inbox possession instead
+ * of a typed code. There is no separate hook for this: consumers call
+ * useForgotPassword({ email: user.email }) directly from the settings page.
  */
-export function useRequestPasswordChangeOtp(options) {
-    return useMutation({
-        mutationFn: async ({ currentPassword }) => {
-            await getClientAuthProvider().reauthenticateOnly(currentPassword);
-            return apiClient.post(ACCOUNT_ENDPOINTS.CHANGE_PASSWORD_OTP_REQUEST, {});
-        },
-        onSuccess: options?.onSuccess,
-        onError: options?.onError,
-    });
-}
-export function useVerifyPasswordChangeOtp(options) {
-    return useMutation({
-        mutationFn: async ({ code }) => apiClient.post(ACCOUNT_ENDPOINTS.CHANGE_PASSWORD_OTP_VERIFY, { code }),
-        onSuccess: options?.onSuccess,
-        onError: options?.onError,
-    });
-}
-export function useChangePassword(options) {
-    return useMutation({
-        mutationFn: async (data) => apiClient.post(ACCOUNT_ENDPOINTS.CHANGE_PASSWORD, data),
-        onSuccess: options?.onSuccess,
-        onError: options?.onError,
-    });
-}
 export function useChangeEmail(options) {
     return useMutation({
         mutationFn: async (data) => {