@mohasinac/appkit 4.59.0 → 4.60.1

package/dist/features/admin/schemas/site-settings-form.js

@@ -41,6 +41,13 @@
  * @tag sideEffects:none
  */
 import { z } from "zod";
+/*
+ * The floor lives with the payout-hold resolver that enforces it at read
+ * time, so the validation message and the honoured behaviour cannot drift —
+ * two copies of "7" is how `payoutHoldDays: 2` coexisted with a hardcoded 7
+ * for months (D28).
+ */
+import { PAYOUT_HOLD_FLOOR_DAYS } from "../../../_internal/shared/fees/payout-hold.js";
 /** A percentage a human types into a settings box. */
 const percent = (label) => z.coerce
     .number({ invalid_type_error: `${label} must be a number.` })
@@ -102,7 +109,29 @@ export const siteSettingsFormSchema = z
         gatewayFeePercent: percent("Gateway fee"),
         platformFeeMax: money("Platform fee cap"),
         minPayoutAmount: money("Minimum payout"),
-        payoutHoldDays: z.coerce.number().int().min(0).max(365).optional(),
+        /*
+         * 🛑 `.min(PAYOUT_HOLD_FLOOR_DAYS)`, not `.min(0)` — and the floor is
+         * not arbitrary.
+         *
+         * The hold must outlast every window during which money can still
+         * flow back OUT of the order: the 7-day return window
+         * (`returns.windowDays`) and the 7-day sale-protection claim window
+         * (`PROTECTION_CLAIM_WINDOW_HOURS.sale` = 168h). Allowing 0 let an
+         * admin release a seller's money before the buyer could even claim
+         * against protection WE had already sold and would have to fund —
+         * and the stored value was seeded **2**, i.e. inside that window.
+         *
+         * `resolvePayoutHoldDays` already clamps up to the floor at read
+         * time, so behaviour is correct either way. This exists so the admin
+         * is TOLD, at the moment they try it, instead of setting 2 and
+         * believing it took effect.
+         */
+        payoutHoldDays: z.coerce
+            .number()
+            .int()
+            .min(PAYOUT_HOLD_FLOOR_DAYS, `Payout hold must be at least ${PAYOUT_HOLD_FLOOR_DAYS} days — it has to outlast the return window and the protection claim window, or a seller is paid before a buyer can claim.`)
+            .max(365)
+            .optional(),
         codHandlingFee: money("COD handling fee"),
         codDepositPercent: percent("COD deposit"),
     })

package/dist/features/auctions/actions/bid-actions.js

@@ -312,7 +312,19 @@ export async function buyNowAuction(userId, userName, userEmail, input) {
     // Replaces the old `bidsHaveStarted` gate. Buy Now used to vanish the instant
     // anybody bid, eBay-style, which hid it on almost every real auction. What
     // actually matters is whether it is still a better deal than the bidding.
-    if (!isBuyNowAvailable({ buyNowPrice, currentBid: standingBid, isEnded: false, isSold: product.isSold })) {
+    /*
+     * 🛑 `reservePrice` is passed HERE above all: this is the server-side money
+     * gate for a buyout. Omitting it is what let a Buy-Now below the seller's
+     * floor complete (D53) — the reserve was enforced only in
+     * `auctionSettlement`, i.e. only on the competitive path.
+     */
+    if (!isBuyNowAvailable({
+        buyNowPrice,
+        currentBid: standingBid,
+        isEnded: false,
+        isSold: product.isSold,
+        reservePrice: product.reservePrice,
+    })) {
         throw new ValidationError(ERROR_MESSAGES.BID.BUY_NOW_UNAVAILABLE, {
             code: BID_ERROR_CODES.BUY_NOW_UNAVAILABLE,
         });

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

@@ -39,7 +39,7 @@ function formatCountdownLabel(remaining) {
  * button can report an error or route to `/checkout?lane=auction`.
  */
 export function AuctionBottomActions(props) {
-    const { currentBid, currency, bidCount, isEnded: ssrIsEnded, auctionEndDate, buyNowPrice } = props;
+    const { currentBid, currency, bidCount, isEnded: ssrIsEnded, auctionEndDate, buyNowPrice, reservePrice } = props;
     /*
      * Derived client-side — see `useIsAuctionEnded`. This bar is a FIXED, always-
      * visible row on mobile, so a stale "Place bid" here is the most prominent
@@ -55,7 +55,7 @@ export function AuctionBottomActions(props) {
     const buyNowMeta = ACTION_META[ACTION_ID.BUY_NOW_AUCTION];
     // Same single predicate the form and the card use. `!!props.onBuyNow` matters
     // because the preview/demo mount passes no action.
-    const buyNowAvailable = isBuyNowAvailable({ buyNowPrice, currentBid, isEnded }) && !!props.onBuyNow;
+    const buyNowAvailable = isBuyNowAvailable({ buyNowPrice, currentBid, isEnded, reservePrice }) && !!props.onBuyNow;
     useBottomActions(isEnded
         ? {}
         : {

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

@@ -52,7 +52,7 @@ function toDescriptionHtml(raw) {
 }
 function renderAuctionInfoPanel(props) {
     const { productId, storeId, title, currentBid, currency, bidCount, isEnded, endDate, buyNowPrice, buyNowAvailable, featured, freeShipping, condition, finalSale, 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" }), _jsx(AuctionLiveStatusBadge, { auctionEndDate: endDate, initialIsEnded: isEnded })] }), _jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: title, storeId: storeId, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(productId)) }), _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()] })] }), buyNowAvailable && buyNowPrice !== null && (_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: _jsx(GatedPrice, { label: "Sign in to see the Buy Now price", children: formatCurrency(buyNowPrice, currency) }) }), _jsx(Span, { size: "xs", color: "faint", children: "\u2014 in \u201CPlace a bid\u201D" })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, finalSale: finalSale, labels: { featured: "Featured", fasterDelivery: "Faster Delivery", ratedSeller: "Rated Seller", condition: "Condition", conditionNew: "New", conditionUsed: "Used", conditionBroken: "For Parts", conditionRefurbished: "Refurbished", returnable: "Returnable", finalSale: "Final Sale", 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-surface hover:text-primary-700 dark:hover:border-primary-700/60 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-surface hover:text-primary-700 dark:hover:border-primary-700/60 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" }), _jsx(AuctionLiveStatusBadge, { auctionEndDate: endDate, initialIsEnded: isEnded })] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title }), _jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: title, storeId: storeId, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(productId)) })] }), _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()] })] }), buyNowAvailable && buyNowPrice !== null && (_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: _jsx(GatedPrice, { label: "Sign in to see the Buy Now price", children: formatCurrency(buyNowPrice, currency) }) }), _jsx(Span, { size: "xs", color: "faint", children: "\u2014 in \u201CPlace a bid\u201D" })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, finalSale: finalSale, labels: { featured: "Featured", fasterDelivery: "Faster Delivery", ratedSeller: "Rated Seller", condition: "Condition", conditionNew: "New", conditionUsed: "Used", conditionBroken: "For Parts", conditionRefurbished: "Refurbished", returnable: "Returnable", finalSale: "Final Sale", 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-surface hover:text-primary-700 dark:hover:border-primary-700/60 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-surface hover:text-primary-700 dark:hover:border-primary-700/60 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" })] }) }))] }));
 }
 /**
  * Store reviews for the auction's seller.
@@ -171,6 +171,8 @@ export async function AuctionDetailPageView({ id, initialAuction, onPlaceBid, on
         currentBid,
         isEnded,
         isSold: p.isSold === true,
+        // D53 — so the button is not offered for a buyout the server will refuse.
+        reservePrice: typeof p.reservePrice === "number" ? p.reservePrice : null,
     });
     const condition = typeof p.condition === "string" ? p.condition : null;
     const featured = p.featured === true;

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

@@ -29,6 +29,17 @@ export interface MarketplaceAuctionCardData {
      * (Root Cause #48).
      */
     isSold?: boolean;
+    /**
+     * D53 — the reserve, read by `isBuyNowAvailable` so a card cannot advertise
+     * a buyout the server will refuse.
+     *
+     * 🛑 Declared late: the predicate already read `product.reservePrice` while
+     * this type did not carry it, so the card was a type error AND every
+     * doc→card mapper was free to drop it. That is the exact failure the
+     * `isSold` note directly above warns about — a shared predicate reading a
+     * field the card shape does not guarantee.
+     */
+    reservePrice?: number | null;
     /**
      * The seller. Absent from this hand-rolled type entirely until now, so the
      * auction card could not show a seller even where every other card did —

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

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { ProductOwnerQuickActions } from "../../products/components/ProductOwnerQuickActions.js";
+import { RecordOwnerQuickActions } from "../../admin/components/RecordOwnerQuickActions.js";
 import { normalizeError } from "../../../errors/normalize.js";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { useRouter } from "next/navigation.js";
@@ -123,6 +123,8 @@ export function MarketplaceAuctionCard({ product, buyoutPrice, className = "", v
         currentBid: product.currentBid,
         isEnded,
         isSold: product.isSold === true,
+        // D53 — a card must not advertise a buyout price the server refuses.
+        reservePrice: typeof product.reservePrice === "number" ? product.reservePrice : null,
     })
         ? rawBuyoutPrice
         : undefined;
@@ -192,7 +194,7 @@ export function MarketplaceAuctionCard({ product, buyoutPrice, className = "", v
     const ownerActions = renderOwnerActions
         ? renderOwnerActions()
         : product.id
-            ? (_jsx(ProductOwnerQuickActions, { productId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined, recordLabel: product.title, placement: "card" }))
+            ? (_jsx(RecordOwnerQuickActions, { resource: "PRODUCT", recordId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined, recordLabel: product.title, placement: "card" }))
             : null;
     if (!ownerActions)
         return card;
@@ -200,5 +202,5 @@ export function MarketplaceAuctionCard({ product, buyoutPrice, className = "", v
      * Sibling of the card, never a child — see the prop's docstring. `z-20`
      * clears this card's own overlays, which all sit at `z-10`.
      */
-    return (_jsxs(Div, { className: "relative h-full", children: [card, _jsx(Div, { className: "absolute right-2 bottom-2 z-20", children: ownerActions })] }));
+    return (_jsxs(Div, { className: "flex h-full flex-col", children: [card, _jsx(Div, { className: "flex justify-end px-[var(--appkit-space-3)] pb-[var(--appkit-space-3)]", children: ownerActions })] }));
 }

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

@@ -40,12 +40,19 @@ export interface PlaceBidFormClientProps {
     isEnded: boolean;
     auctionEndDate: Date | null;
     buyNowPrice: number | null;
+    /**
+     * The seller's floor (D53). Threaded so the Buy-Now control is not offered
+     * for a buyout the server will refuse — `isBuyNowAvailable` now rejects
+     * `buyNowPrice < reservePrice`, and without this prop the button would
+     * render and then error on click.
+     */
+    reservePrice?: number | null;
     bidCount: number;
     tags?: string[];
     onPlaceBid: (input: PlaceBidInput) => Promise<BidActionEnvelope<unknown>>;
     onBuyNow?: () => Promise<BidActionEnvelope<BuyNowSuccess>>;
 }
-export declare function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded: ssrIsEnded, auctionEndDate, buyNowPrice, bidCount: ssrBidCount, tags, onPlaceBid, onBuyNow, }: PlaceBidFormClientProps): React.JSX.Element;
+export declare function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded: ssrIsEnded, auctionEndDate, buyNowPrice, reservePrice, 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

@@ -37,7 +37,7 @@ const __P = {
 /** Feature-specific last resort. Authored copy, never derived from an error. */
 const BID_FALLBACK = "Failed to place bid. Please try again.";
 const BUY_NOW_FALLBACK = "Buy Now failed. Please try again.";
-export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded: ssrIsEnded, auctionEndDate, buyNowPrice, bidCount: ssrBidCount, tags = [], onPlaceBid, onBuyNow, }) {
+export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded: ssrIsEnded, auctionEndDate, buyNowPrice, reservePrice, bidCount: ssrBidCount, tags = [], onPlaceBid, onBuyNow, }) {
     /*
      * 🛑 Derived here, not trusted from the server.
      *
@@ -142,7 +142,7 @@ export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, start
     // `currentBid` here is the LIVE SSE price, so the button hides itself the
     // moment another bidder passes the buyout price — without a page reload, and
     // without this component owning a second copy of the rule.
-    const buyNowAvailable = isBuyNowAvailable({ buyNowPrice, currentBid, isEnded }) && !!onBuyNow;
+    const buyNowAvailable = isBuyNowAvailable({ buyNowPrice, currentBid, isEnded, reservePrice }) && !!onBuyNow;
     const schema = placeBidSchema(minBid, formatCurrency(minBid, currency));
     async function submitBid(amount, setFieldError) {
         try {

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

@@ -30,6 +30,20 @@ export declare const AdminAuditActionValues: {
      * offer's own `statusHistory`.
      */
     readonly OFFER_CANCEL: "offer_cancel";
+    /**
+     * Admin credited or debited a buyer's points by hand.
+     *
+     * 🛑 Belongs here rather than only in the ledger, even though the ledger is
+     * already append-only and already records `actorUid` and `adminReason`. The
+     * two answer different questions: the ledger answers "why does THIS ACCOUNT
+     * have 53 points", this answers "what have admins done lately" — and the
+     * second is the one you need when the account is not yet suspected.
+     *
+     * 1 point = ₹1 of spendable discount, so a credit is a liability the platform
+     * must honour and a debit removes value a buyer already holds. That is the
+     * same class as `payout_mark_paid` and `coupon_update`, which are both here.
+     */
+    readonly POINTS_ADJUST: "points_adjust";
 };
 export type AdminAuditAction = (typeof AdminAuditActionValues)[keyof typeof AdminAuditActionValues];
 export interface AdminAuditLogDocument extends BaseDocument {
@@ -69,5 +83,19 @@ export declare const ADMIN_AUDIT_LOG_FIELDS: {
          * offer's own `statusHistory`.
          */
         readonly OFFER_CANCEL: "offer_cancel";
+        /**
+         * Admin credited or debited a buyer's points by hand.
+         *
+         * 🛑 Belongs here rather than only in the ledger, even though the ledger is
+         * already append-only and already records `actorUid` and `adminReason`. The
+         * two answer different questions: the ledger answers "why does THIS ACCOUNT
+         * have 53 points", this answers "what have admins done lately" — and the
+         * second is the one you need when the account is not yet suspected.
+         *
+         * 1 point = ₹1 of spendable discount, so a credit is a liability the platform
+         * must honour and a debit removes value a buyer already holds. That is the
+         * same class as `payout_mark_paid` and `coupon_update`, which are both here.
+         */
+        readonly POINTS_ADJUST: "points_adjust";
     };
 };

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

@@ -28,6 +28,20 @@ export const AdminAuditActionValues = {
      * offer's own `statusHistory`.
      */
     OFFER_CANCEL: "offer_cancel",
+    /**
+     * Admin credited or debited a buyer's points by hand.
+     *
+     * 🛑 Belongs here rather than only in the ledger, even though the ledger is
+     * already append-only and already records `actorUid` and `adminReason`. The
+     * two answer different questions: the ledger answers "why does THIS ACCOUNT
+     * have 53 points", this answers "what have admins done lately" — and the
+     * second is the one you need when the account is not yet suspected.
+     *
+     * 1 point = ₹1 of spendable discount, so a credit is a liability the platform
+     * must honour and a debit removes value a buyer already holds. That is the
+     * same class as `payout_mark_paid` and `coupon_update`, which are both here.
+     */
+    POINTS_ADJUST: "points_adjust",
 };
 export const ADMIN_AUDIT_LOG_FIELDS = {
     ACTOR_UID: "actorUid",

package/dist/features/auth/permissions/constants.d.ts

@@ -37,7 +37,23 @@ export type Permission = "admin:dashboard:view" | "admin:users:read" | "admin:us
  * mechanism — and revoking it is a permission change, which the admin audit
  * log already records.
  */
- | "tester:admin-surfaces" | "admin:events:read" | "admin:events:write" | "admin:events:delete" | "admin:event-entries:read" | "admin:event-entries:write" | "admin:support-tickets:read" | "admin:support-tickets:write" | "admin:shipments:read" | "admin:shipments:write" | "admin:catalogue:read" | "admin:catalogue:write" | "admin:grouped-listings:read" | "admin:grouped-listings:write" | "admin:support-tickets:assign" | "admin:support-tickets:close" | "admin:scammers:read" | "admin:scammers:write" | "admin:scammers:verify" | "admin:scammers:delete" | "admin:sessions:read" | "admin:sessions:delete" | "admin:notifications:read" | "admin:notifications:write" | "admin:carts:read" | "admin:wishlists:read" | "admin:feature-flags:read" | "admin:feature-flags:write" | "admin:team:read" | "admin:team:write" | "admin:maintenance:view-server-errors" | "admin:maintenance:view-client-errors" | "admin:maintenance:view-function-errors" | "admin:maintenance:view-cloud-logs" | "admin:maintenance:view-payment-rollbacks" | "admin:maintenance:run-analysis" | "admin:maintenance:purge-errors";
+ | "tester:admin-surfaces" | "admin:events:read" | "admin:events:write" | "admin:events:delete" | "admin:event-entries:read" | "admin:event-entries:write" | "admin:support-tickets:read" | "admin:support-tickets:write" | "admin:shipments:read" | "admin:shipments:write" | "admin:catalogue:read" | "admin:catalogue:write" | "admin:inventory:read" | "admin:inventory:write" | "admin:grouped-listings:read" | "admin:grouped-listings:write" | "admin:support-tickets:assign" | "admin:support-tickets:close" | "admin:scammers:read" | "admin:scammers:write" | "admin:scammers:verify" | "admin:scammers:delete" | "admin:sessions:read" | "admin:sessions:delete" | "admin:notifications:read" | "admin:notifications:write" | "admin:carts:read" | "admin:wishlists:read" | "admin:feature-flags:read" | "admin:feature-flags:write" | "admin:team:read" | "admin:team:write" | "admin:maintenance:view-server-errors" | "admin:maintenance:view-client-errors" | "admin:maintenance:view-function-errors" | "admin:maintenance:view-cloud-logs" | "admin:maintenance:view-payment-rollbacks" | "admin:maintenance:run-analysis" | "admin:maintenance:purge-errors" | "admin:maintenance:view-gateway-events" | "admin:maintenance:view-obligations" | "admin:payment-cases:read" | "admin:payment-cases:write" | "admin:protection-claims:read" | "admin:protection-claims:write"
+/**
+ * Credit or debit a buyer's points by hand.
+ *
+ * 🛑 WRITE ONLY, with no matching `:read`, and that asymmetry is deliberate:
+ * a buyer's balance and ledger are already visible on the admin user detail
+ * page under the permissions that get you there. What needs its own gate is
+ * the act of CREATING SPENDABLE MONEY — 1 point = ₹1 against a future order,
+ * so a credit is a liability the platform must honour.
+ *
+ * Granted to no employee bundle. `createRouteHandler` lets an effective admin
+ * through without consulting the array at all, so this exists to be the thing
+ * an employee bundle would have to name explicitly — and nothing names it.
+ * Same reasoning as `admin:payment-cases:*`: a queue an analyst may read is
+ * different from a decision that moves money.
+ */
+ | "admin:points:write";
 /**
  * Granular user actions that can be soft-banned individually.
  * A user may have multiple simultaneous soft bans of different types.

package/dist/features/auth/permissions/constants.js

@@ -262,6 +262,16 @@ export const PERMISSION_GROUPS = {
         "admin:maintenance:view-cloud-logs",
         "admin:maintenance:view-payment-rollbacks",
         "admin:maintenance:run-analysis",
+        /*
+         * The two new diagnostics surfaces DO belong to this role — a stuck
+         * gateway event and an overdue obligation are exactly what a maintenance
+         * employee should be able to look at.
+         *
+         * 🛑 `admin:payment-cases:*` and `admin:protection-claims:*` deliberately
+         * are NOT here. Those decide money and carry external deadlines.
+         */
+        "admin:maintenance:view-gateway-events",
+        "admin:maintenance:view-obligations",
     ],
 };
 // ============================================================================
@@ -284,6 +294,9 @@ export const ROUTE_PERMISSION_MAP = {
     "/admin/payouts": "admin:payouts:read",
     "/admin/audit-log": "admin:audit-log:read",
     "/admin/shipments": "admin:shipments:read",
+    "/admin/inventory": "admin:inventory:read",
+    "/admin/inventory/boxes": "admin:inventory:read",
+    "/admin/inventory/movements": "admin:inventory:read",
     "/admin/catalogue-approvals": "admin:catalogue:read",
     "/admin/grouped-listings": "admin:grouped-listings:read",
     "/admin/categories": "admin:categories:read",
@@ -326,6 +339,11 @@ export const ROUTE_PERMISSION_MAP = {
     "/admin/maintenance/cloud-logs": "admin:maintenance:view-cloud-logs",
     "/admin/maintenance/payment-rollbacks": "admin:maintenance:view-payment-rollbacks",
     "/admin/maintenance/analysis": "admin:maintenance:run-analysis",
+    "/admin/maintenance/gateway-events": "admin:maintenance:view-gateway-events",
+    "/admin/maintenance/obligations": "admin:maintenance:view-obligations",
+    // Payment protection — admin-only, see the permission union's own 🛑 note.
+    "/admin/money-cases": "admin:payment-cases:read",
+    "/admin/protection-claims": "admin:protection-claims:read",
 };
 /**
  * Every capability, as a runtime value.

package/dist/features/blog/components/BlogPostView.js

@@ -56,5 +56,5 @@ export function BlogPostView({ slug, initialData, labels = {}, renderImage, rend
         })
         : "";
     const coverImageUrl = getMediaUrl(post.coverImage);
-    return (_jsxs(Div, { className: `min-h-screen ${className}`, children: [coverImageUrl && (_jsxs(Div, { className: `relative h-72 md:h-96 ${__O.hidden}`, children: [renderImage ? (renderImage(post)) : (_jsx(MediaImage, { src: coverImageUrl, alt: post.title, size: "hero" })), _jsx(Scrim, { direction: "bottom-up", intensity: "subtle", className: "absolute inset-0" })] })), _jsxs(Div, { className: "max-w-3xl mx-auto", paddingY: "y-3xl", paddingX: "x-md", children: [renderBlogPostHeader(post, date, labels), post.youtubeId && /^[A-Za-z0-9_-]{6,20}$/.test(post.youtubeId) && (_jsx(Div, { className: "mb-8", children: _jsx(Iframe, { src: `https://www.youtube-nocookie.com/embed/${post.youtubeId}`, title: `${post.title} — video`, aspect: "video", rounded: "lg" }) })), post.tags && post.tags.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mb-8", children: post.tags.map((tag) => (_jsxs(Link, { href: `${String(ROUTES.BLOG.LIST)}?tags=${encodeURIComponent(tag)}`, className: "inline-block px-[var(--appkit-space-3)] py-[var(--appkit-space-1)] rounded-full bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)] hover:bg-primary/10 text-[var(--appkit-color-text-muted)] hover:text-primary text-[length:var(--appkit-text-xs)] font-medium transition-colors", children: ["#", tag] }, tag))) })), renderAuthorBio && _jsx(Div, { className: "mb-6", children: renderAuthorBio(post) }), _jsx(Div, { surface: "card", padding: "xl", className: "mb-12", children: renderContent ? renderContent(post) : (_jsx(RichText, { html: normalizeRichTextHtml(post.content ?? ""), proseClass: "prose max-w-none dark:prose-invert" })) }), _jsxs(Stack, { gap: "xl", children: [renderBlogPostRelated(related, labels?.relatedTitle ?? "Related Posts", renderRelatedCard), renderBlogPostRelated(relatedByTags, labels?.relatedByTagsTitle ?? "You might also like", renderRelatedCard), renderBlogPostRelated(relatedByAuthor, labels?.relatedByAuthorTitle ?? `More from ${post.authorName}`, renderRelatedCard)] }), renderBackButton && _jsx(Div, { border: "default", className: "mt-10 border-t", padding: "t-xl", children: renderBackButton() })] })] }));
+    return (_jsxs(Div, { className: `min-h-screen ${className}`, children: [coverImageUrl && (_jsxs(Div, { className: `relative h-72 md:h-96 ${__O.hidden}`, children: [renderImage ? (renderImage(post)) : (_jsx(MediaImage, { src: coverImageUrl, alt: post.title, size: "hero" })), _jsx(Scrim, { direction: "bottom-up", intensity: "subtle", className: "absolute inset-0" })] })), _jsxs(Div, { className: "max-w-3xl mx-auto", paddingY: "y-3xl", paddingX: "x-md", children: [renderBlogPostHeader(post, date, labels), post.youtubeId && /^[A-Za-z0-9_-]{6,20}$/.test(post.youtubeId) && (_jsx(Div, { className: "mb-8", children: _jsx(Iframe, { src: `https://www.youtube-nocookie.com/embed/${post.youtubeId}`, title: `${post.title} — video`, aspect: "video", rounded: "lg" }) })), post.tags && post.tags.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mb-8", children: post.tags.map((tag) => (_jsxs(Link, { href: `${String(ROUTES.BLOG.LIST)}?tags=${encodeURIComponent(tag)}`, className: "inline-block px-[var(--appkit-space-3)] py-[var(--appkit-space-1)] rounded-full bg-[var(--appkit-color-surface-elevated)] hover:bg-primary/10 text-[var(--appkit-color-text-muted)] hover:text-primary text-[length:var(--appkit-text-xs)] font-medium transition-colors", children: ["#", tag] }, tag))) })), renderAuthorBio && _jsx(Div, { className: "mb-6", children: renderAuthorBio(post) }), _jsx(Div, { surface: "card", padding: "xl", className: "mb-12", children: renderContent ? renderContent(post) : (_jsx(RichText, { html: normalizeRichTextHtml(post.content ?? ""), proseClass: "prose max-w-none dark:prose-invert" })) }), _jsxs(Stack, { gap: "xl", children: [renderBlogPostRelated(related, labels?.relatedTitle ?? "Related Posts", renderRelatedCard), renderBlogPostRelated(relatedByTags, labels?.relatedByTagsTitle ?? "You might also like", renderRelatedCard), renderBlogPostRelated(relatedByAuthor, labels?.relatedByAuthorTitle ?? `More from ${post.authorName}`, renderRelatedCard)] }), renderBackButton && _jsx(Div, { border: "default", className: "mt-10 border-t", padding: "t-xl", children: renderBackButton() })] })] }));
 }

package/dist/features/catalogue/components/AdminCatalogueApprovalsView.js

@@ -81,5 +81,5 @@ export function AdminCatalogueApprovalsView() {
                             }, children: "Reject" }), _jsx(Button, { isLoading: approveMutation.isPending, onClick: () => {
                                 approveMutation.mutate(selected.id);
                                 setSelected(null);
-                            }, children: "Approve" })] })) : null }), _jsx(Modal, { isOpen: !!rejectTarget, onClose: () => setRejectTarget(null), title: "Reject this catalogue listing?", size: "sm", children: _jsxs(Stack, { gap: "md", children: [_jsx(Text, { variant: "secondary", children: "The owner will see this reason." }), _jsx(Textarea, { value: rejectReason, onChange: (e) => setRejectReason(e.target.value), rows: 3, placeholder: "Reason for rejection" }), _jsx(Button, { isLoading: rejectMutation.isPending, disabled: !rejectReason.trim(), variant: "danger", onClick: () => rejectMutation.mutate(), children: "Reject" })] }) })] }));
+                            }, children: "Approve" })] })) : null }), _jsx(Modal, { isOpen: !!rejectTarget, onClose: () => setRejectTarget(null), title: "Reject this catalogue listing?", size: "sm", children: _jsxs(Stack, { gap: "md", children: [_jsx(Text, { variant: "secondary", children: "The owner will see this reason." }), _jsx(Textarea, { label: "Reason for rejection", value: rejectReason, onChange: (e) => setRejectReason(e.target.value), rows: 3, placeholder: "Reason for rejection" }), _jsx(Button, { isLoading: rejectMutation.isPending, disabled: !rejectReason.trim(), variant: "danger", onClick: () => rejectMutation.mutate(), children: "Reject" })] }) })] }));
 }

package/dist/features/categories/api/[id]/description-template/route.js

@@ -51,7 +51,46 @@ import { serverLogger } from "../../../../../monitoring/index.js";
 import { categoriesRepository } from "../../../repository/categories.repository.js";
 import { usedPlaceholders } from "../../../../../_internal/shared/templating/placeholders.js";
 import { getCompositionsForCategory } from "../../../../../_internal/server/features/parts/data.js";
+import { getBeysForCategory } from "../../../../../_internal/server/features/beys/data.js";
 import { PART_BREAKDOWN_SLOT, formatPartBreakdown, stripSlotLine, } from "../../../../parts/utils/part-breakdown.js";
+/**
+ * ── The TAXONOMY slots ────────────────────────────────────────────────────
+ *
+ * Measured across the seeded bodies: 45 `{{title}}` · 21 `{{siteName}}` ·
+ * 18 `{{series}}` · 17 `{{category}}` · 13 `{{condition}}` · 6 `{{brand}}` ·
+ * 5 `{{partBreakdown}}` · 3 `{{categoryPath}}`. The seller form supplies four
+ * of those from the draft it is holding (title, brand, condition, siteName)
+ * and this route supplied exactly one (`partBreakdown`) — so
+ * **`{{category}}`, `{{categoryPath}}`, `{{series}}` and `{{system}}` could
+ * never resolve on any listing**, and the picker reported "4 of 9 slots could
+ * not be filled" on every single category, forever.
+ *
+ * All four are facts about the CATEGORY, not the draft, so the form cannot
+ * compute them and this is the only place that can. They ride the existing
+ * response exactly as `partBreakdown` does.
+ *
+ * 🛑 `series` and `system` are REAL FIELDS, not invented from the tree.
+ * `BeyDocument.series` is "the retail series" (`Beyblade Burst QuadStrike`)
+ * and `BeyDocument.system` is "the hardware generation" (`4D System`,
+ * `Hybrid Wheel System`) — which is why the seeded body renders them as two
+ * separate rows. A leaf pairs with a bey through `BeyDocument.categoryId`,
+ * and `getBeysForCategory` is the inverse of exactly that.
+ *
+ * 🛑 Resolved against the LEAF, never an ancestor — a bey describes one
+ * model, so inheriting a line's would tell every listing on that line it is
+ * the model that happened to join to the line node.
+ */
+const TAXONOMY_SLOTS = ["category", "categoryPath", "series", "system"];
+/** Slots that need the bey read. Checked before paying for it. */
+const BEY_SLOTS = ["series", "system"];
+/**
+ * `Spinning Tops › Beyblade X › Attack Types › Dran Sword`.
+ *
+ * A chevron rather than a slash: the body renders it inside
+ * `<li><strong>Category:</strong> …</li>` next to prose, and a slash there
+ * reads as a URL.
+ */
+const CATEGORY_PATH_SEPARATOR = " › ";
 /**
  * The variants a caller may ask for.
  *
@@ -172,6 +211,10 @@ async function resolveInherited(parentIds, variant, seed) {
      * that it came from the line.
      */
     const byId = new Map(ancestors.map((a) => [a.id, a]));
+    // See `Inherited.ancestorNames` — before the loop, which may break early.
+    out.ancestorNames = nearestFirst
+        .map((pid) => byId.get(pid)?.name?.trim())
+        .filter((n) => Boolean(n));
     for (const pid of nearestFirst) {
         const d = byId.get(pid);
         if (!d)
@@ -208,11 +251,12 @@ export async function GET(request, context) {
          * referenced, so the per-field merge below cannot mutate the document the
          * repository cached.
          */
-        const { template, inheritedFrom, inheritedFromName, defaults } = await resolveInherited(parentIds, variant, {
+        const { template, inheritedFrom, inheritedFromName, defaults, ancestorNames } = await resolveInherited(parentIds, variant, {
             template: pickTemplate(leaf, variant),
             inheritedFrom: null,
             inheritedFromName: null,
             defaults: { ...(leaf.productDefaults ?? {}) },
+            ancestorNames: [],
         });
         /*
          * 🛑 `placeholders` is RE-DERIVED here and not trusted from the stored
@@ -256,6 +300,68 @@ export async function GET(request, context) {
             else
                 body = stripSlotLine(body, PART_BREAKDOWN_SLOT);
         }
+        /*
+         * ── The taxonomy slots ────────────────────────────────────────────────
+         *
+         * See TAXONOMY_SLOTS. `category` and `categoryPath` are free — the leaf
+         * and its ancestors are already in hand — so they are built
+         * unconditionally and the `placeholders` check below decides whether they
+         * are sent.
+         *
+         * The bey read is gated on the body actually asking, the same way the
+         * composition read is: nothing outside the Beyblade lines carries
+         * `{{series}}`/`{{system}}`, so a TCG set or a Hot Wheels casting pays
+         * nothing for a concept it does not have.
+         */
+        if (template) {
+            const taxonomy = {
+                category: (leaf.name ?? "").trim(),
+                // Root-first: `ancestorNames` is nearest-first, so reverse it and put
+                // the leaf on the end. This is the order a breadcrumb reads in.
+                categoryPath: [...ancestorNames]
+                    .reverse()
+                    .concat((leaf.name ?? "").trim())
+                    .filter(Boolean)
+                    .join(CATEGORY_PATH_SEPARATOR),
+            };
+            if (BEY_SLOTS.some((s) => placeholders.includes(s))) {
+                const beys = await getBeysForCategory(id);
+                /*
+                 * The first pairing only, matching `formatPartBreakdown`'s rule and
+                 * for the same reason: 22 leaves pair with more than one bey (a
+                 * remake shares a model's name), and concatenating two retail series
+                 * would describe a release that does not exist.
+                 */
+                const bey = beys[0];
+                taxonomy.series = (bey?.series ?? "").trim();
+                taxonomy.system = (bey?.system ?? "").trim();
+            }
+            for (const slot of TAXONOMY_SLOTS) {
+                if (!placeholders.includes(slot))
+                    continue;
+                const value = taxonomy[slot] ?? "";
+                if (value) {
+                    slots[slot] = value;
+                    continue;
+                }
+                /*
+                 * 🛑 ABSENCE REMOVES THE LINE — `partBreakdown`'s contract, applied
+                 * here for the same reason: `interpolate` resolves an unfilled slot
+                 * to an empty string, so `<li><strong>System:</strong> {{system}}</li>`
+                 * would render an empty bullet that reads as broken data.
+                 *
+                 * 🛑 KNOWN CONSEQUENCE, stated rather than guarded against (as the
+                 * strip helper's own header does): `{{series}}` appears both as a
+                 * standalone row AND mid-sentence ("from the {{series}} line"), so a
+                 * leaf with no paired bey loses that whole sentence instead of
+                 * printing "from the  line". Losing a sentence is the better of the
+                 * two, and the seller sees the picker's note either way — but a
+                 * template author adding an inline slot should know the line goes
+                 * with it.
+                 */
+                body = stripSlotLine(body, slot);
+            }
+        }
         return NextResponse.json({
             success: true,
             data: {

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

@@ -177,7 +177,7 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
     const ldFaq = brand?.faqs && brand.faqs.length > 0
         ? faqJsonLd(brand.faqs.map((f) => ({ question: f.question, answer: f.answer })))
         : null;
-    return (_jsxs(Main, { children: [_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldBreadcrumb) } }), _jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldCollection) } }), ldFaq && (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldFaq) } })), _jsxs(Section, { className: `relative ${__O.hidden} ${hasCover ? "min-h-[220px] md:min-h-[280px]" : "bg-[var(--appkit-color-bg)]"}`, children: [hasCover && (_jsxs(_Fragment, { children: [_jsx(Div, { className: "absolute inset-0", children: _jsx(MediaImage, { src: coverImage, alt: "", size: "banner" }) }), _jsx(Div, { surface: "overlay-md", className: "absolute inset-0" })] })), !hasCover && (_jsx(DynamicBgDiv, { color: brandColor, className: "absolute inset-0 opacity-10" })), _jsxs(Div, { className: "relative z-10 max-w-7xl mx-auto", paddingY: hasCover ? "y-3xl" : "y-xl", padding: "x-md", children: [_jsxs(Nav, { layout: "flex", gap: "2xs", textSize: "sm", className: "mb-4", "aria-label": "Breadcrumb", children: [_jsx(Link, { href: String(ROUTES.HOME), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-[var(--appkit-color-text-muted)] hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Home" }), _jsx(Span, { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.BRANDS), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-[var(--appkit-color-text-muted)] hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Brands" }), _jsx(Span, { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Span, { weight: "medium", className: hasCover ? "text-white" : "text-[var(--appkit-color-text)]", children: brand?.name ?? slug })] }), _jsxs(Row, { className: "mb-3", align: "center", gap: "md", children: [brand?.display?.icon && (_jsx(Span, { className: "leading-none", size: "5xl", children: brand.display.icon })), _jsxs(_Fragment, { children: [brand?.id && (_jsx(RecordOwnerQuickActions, { resource: "BRAND", recordId: brand.id, placement: "detail", 
+    return (_jsxs(Main, { children: [_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldBreadcrumb) } }), _jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldCollection) } }), ldFaq && (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldFaq) } })), _jsxs(Section, { className: `relative ${__O.hidden} ${hasCover ? "min-h-[220px] md:min-h-[280px]" : "bg-[var(--appkit-color-bg)]"}`, children: [hasCover && (_jsxs(_Fragment, { children: [_jsx(Div, { className: "absolute inset-0", children: _jsx(MediaImage, { src: coverImage, alt: "", size: "banner" }) }), _jsx(Div, { surface: "overlay-md", className: "absolute inset-0" })] })), !hasCover && (_jsx(DynamicBgDiv, { color: brandColor, className: "absolute inset-0 opacity-10" })), _jsxs(Div, { className: "relative z-10 max-w-7xl mx-auto", paddingY: hasCover ? "y-3xl" : "y-xl", padding: "x-md", children: [_jsxs(Nav, { layout: "flex", gap: "2xs", textSize: "sm", className: "mb-4", "aria-label": "Breadcrumb", children: [_jsx(Link, { href: String(ROUTES.HOME), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-[var(--appkit-color-text-muted)] hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Home" }), _jsx(Span, { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.BRANDS), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-[var(--appkit-color-text-muted)] hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Brands" }), _jsx(Span, { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Span, { weight: "medium", className: hasCover ? "text-white" : "text-[var(--appkit-color-text)]", children: brand?.name ?? slug })] }), _jsxs(Row, { className: "mb-3", align: "center", gap: "md", children: [brand?.display?.icon && (_jsx(Span, { className: "leading-none", size: "5xl", children: brand.display.icon })), _jsxs(Stack, { gap: "xs", className: "min-w-0", children: [_jsx(Heading, { color: "inverse", level: 1, className: `${hasCover ? "" : "text-[var(--appkit-color-text)]"}`, size: "3xl", mdSize: "4xl", weight: "bold", children: brand?.name ?? slug }), brand?.id && (_jsx(RecordOwnerQuickActions, { resource: "BRAND", recordId: brand.id, placement: "detail", 
                                                 /* See CategoryDetailPageView — ghost ink is invisible on the cover hero. */
-                                                onMedia: hasCover, className: "mb-2", recordLabel: brand.name ?? slug })), _jsx(Heading, { color: "inverse", level: 1, className: `${hasCover ? "" : "text-[var(--appkit-color-text)]"}`, size: "3xl", mdSize: "4xl", weight: "bold", children: brand?.name ?? slug }), brand?.description && typeof brand.description === "string" && !brand.description.startsWith("{") && (_jsx(Text, { color: hasCover ? "inverse" : "muted", className: `max-w-2xl mt-1 ${hasCover ? "/80" : ""}`, size: "base", children: brand.description }))] })] }), _jsxs(Row, { gap: "sm", wrap: true, className: "mt-3", children: [(counts.products ?? 0) > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: "inverse", size: "xs", weight: "medium", className: `${hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "bg-primary/10 text-primary-700 dark:text-primary-400"}`, rounded: "full", padding: "pill-sm-tall", children: [counts.products.toLocaleString(), " ", counts.products === 1 ? "product" : "products"] })), (counts.auctions ?? 0) > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: hasCover ? "inverse" : "warning", surface: hasCover ? undefined : "warning-surface", size: "xs", weight: "medium", className: hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "", rounded: "full", padding: "pill-sm-tall", children: [counts.auctions.toLocaleString(), " ", counts.auctions === 1 ? "auction" : "auctions"] })), (counts["pre-orders"] ?? 0) > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: hasCover ? "inverse" : "info", surface: hasCover ? undefined : "info-surface", size: "xs", weight: "medium", className: hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "", rounded: "full", padding: "pill-sm-tall", children: [counts["pre-orders"].toLocaleString(), " ", counts["pre-orders"] === 1 ? "pre-order" : "pre-orders"] })), totalItems === 0 && (_jsx(Span, { size: "sm", className: hasCover ? "text-white/60" : "text-zinc-400", children: "No items listed yet" }))] })] })] }), (brand?.brandWebsite || brand?.brandCountry || brand?.brandFounded) && (_jsx(Section, { border: "subtle", surface: "default", className: "border-b", padding: "y-md", children: _jsx(Container, { size: "xl", children: _jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, size: "sm", weight: "semibold", color: "muted", transform: "uppercase", children: "About this brand" }), _jsxs(Dl, { divide: "subtle", rounded: "xl", border: "subtle", className: "overflow-hidden max-w-lg", children: [brand?.brandWebsite && (_jsxs(Row, { gap: "md", oddEven: "zebra", surface: "default", padding: "inline", children: [_jsx(Dt, { className: "w-32 flex-shrink-0", color: "primary", weight: "medium", children: "Website" }), _jsx(Dd, { className: "flex-1", children: _jsx(Anchor, { href: brand.brandWebsite, tone: "brand", underline: "hover", children: brand.brandWebsite }) })] })), brand?.brandCountry && (_jsxs(Row, { gap: "md", oddEven: "zebra", surface: "default", padding: "inline", children: [_jsx(Dt, { className: "w-32 flex-shrink-0", color: "primary", weight: "medium", children: "Country" }), _jsx(Dd, { className: "flex-1", color: "muted", children: brand.brandCountry })] })), brand?.brandFounded && (_jsxs(Row, { gap: "md", oddEven: "zebra", surface: "default", padding: "inline", children: [_jsx(Dt, { className: "w-32 flex-shrink-0", color: "primary", weight: "medium", children: "Founded" }), _jsx(Dd, { className: "flex-1", color: "muted", children: brand.brandFounded })] }))] })] }) }) })), brandContentBody && brandContentBody.trim().length > 0 && (_jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "xl", children: _jsx(RichTextRenderer, { html: brandContentBody }) }) })), _jsx(CategoryHighlightsAndFaqSection, { highlights: brand?.highlights, faqs: brand?.faqs }), _jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "xl", children: brandName ? (_jsx(BrandDetailTabs, { brandName: brandName, initialProductsData: productsResult ?? undefined, initialBundles: brandBundles, counts: counts, totals: totals, enabledListingTypes: enabledListingTypes(settings), enabledCategoryTypes: enabledCategoryTypes(settings) })) : (_jsx(Text, { paddingY: "3xl", color: "muted", size: "sm", align: "start", children: "Brand not found." })) }) }), groupedListings.length > 0 && (_jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "xl", children: _jsx(GroupedListingsCarousel, { groups: groupedListings }) }) })), relatedBrands.length > 0 && (_jsx(Section, { border: "subtle", surface: "default", className: "border-t", padding: "y-lg", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 2, className: "mb-4", size: "xl", weight: "semibold", children: "Related Brands" }), _jsx(CategoryGrid, { categories: relatedBrands, getHref: (b) => String(ROUTES.PUBLIC.BRAND_DETAIL(b.slug)) })] }) }))] }));
+                                                onMedia: hasCover, className: "mb-2", recordLabel: brand.name ?? slug })), brand?.description && typeof brand.description === "string" && !brand.description.startsWith("{") && (_jsx(Text, { color: hasCover ? "inverse" : "muted", className: "max-w-2xl mt-1", size: "base", children: brand.description }))] })] }), _jsxs(Row, { gap: "sm", wrap: true, className: "mt-3", children: [(counts.products ?? 0) > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: "inverse", size: "xs", weight: "medium", className: `${hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "bg-primary/10 text-primary-700 dark:text-primary-400"}`, rounded: "full", padding: "pill-sm-tall", children: [counts.products.toLocaleString(), " ", counts.products === 1 ? "product" : "products"] })), (counts.auctions ?? 0) > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: hasCover ? "inverse" : "warning", surface: hasCover ? undefined : "warning-surface", size: "xs", weight: "medium", className: hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "", rounded: "full", padding: "pill-sm-tall", children: [counts.auctions.toLocaleString(), " ", counts.auctions === 1 ? "auction" : "auctions"] })), (counts["pre-orders"] ?? 0) > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: hasCover ? "inverse" : "info", surface: hasCover ? undefined : "info-surface", size: "xs", weight: "medium", className: hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "", rounded: "full", padding: "pill-sm-tall", children: [counts["pre-orders"].toLocaleString(), " ", counts["pre-orders"] === 1 ? "pre-order" : "pre-orders"] })), totalItems === 0 && (_jsx(Span, { size: "sm", className: hasCover ? "text-white/60" : "text-zinc-400", children: "No items listed yet" }))] })] })] }), (brand?.brandWebsite || brand?.brandCountry || brand?.brandFounded) && (_jsx(Section, { border: "subtle", surface: "default", className: "border-b", padding: "y-md", children: _jsx(Container, { size: "xl", children: _jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, size: "sm", weight: "semibold", color: "muted", transform: "uppercase", children: "About this brand" }), _jsxs(Dl, { divide: "subtle", rounded: "xl", border: "subtle", className: "overflow-hidden max-w-lg", children: [brand?.brandWebsite && (_jsxs(Row, { gap: "md", oddEven: "zebra", surface: "default", padding: "inline", children: [_jsx(Dt, { className: "w-32 flex-shrink-0", color: "primary", weight: "medium", children: "Website" }), _jsx(Dd, { className: "flex-1", children: _jsx(Anchor, { href: brand.brandWebsite, tone: "brand", underline: "hover", children: brand.brandWebsite }) })] })), brand?.brandCountry && (_jsxs(Row, { gap: "md", oddEven: "zebra", surface: "default", padding: "inline", children: [_jsx(Dt, { className: "w-32 flex-shrink-0", color: "primary", weight: "medium", children: "Country" }), _jsx(Dd, { className: "flex-1", color: "muted", children: brand.brandCountry })] })), brand?.brandFounded && (_jsxs(Row, { gap: "md", oddEven: "zebra", surface: "default", padding: "inline", children: [_jsx(Dt, { className: "w-32 flex-shrink-0", color: "primary", weight: "medium", children: "Founded" }), _jsx(Dd, { className: "flex-1", color: "muted", children: brand.brandFounded })] }))] })] }) }) })), brandContentBody && brandContentBody.trim().length > 0 && (_jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "xl", children: _jsx(RichTextRenderer, { html: brandContentBody }) }) })), _jsx(CategoryHighlightsAndFaqSection, { highlights: brand?.highlights, faqs: brand?.faqs }), _jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "xl", children: brandName ? (_jsx(BrandDetailTabs, { brandName: brandName, initialProductsData: productsResult ?? undefined, initialBundles: brandBundles, counts: counts, totals: totals, enabledListingTypes: enabledListingTypes(settings), enabledCategoryTypes: enabledCategoryTypes(settings) })) : (_jsx(Text, { paddingY: "3xl", color: "muted", size: "sm", align: "start", children: "Brand not found." })) }) }), groupedListings.length > 0 && (_jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "xl", children: _jsx(GroupedListingsCarousel, { groups: groupedListings }) }) })), relatedBrands.length > 0 && (_jsx(Section, { border: "subtle", surface: "default", className: "border-t", padding: "y-lg", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 2, className: "mb-4", size: "xl", weight: "semibold", children: "Related Brands" }), _jsx(CategoryGrid, { categories: relatedBrands, getHref: (b) => String(ROUTES.PUBLIC.BRAND_DETAIL(b.slug)) })] }) }))] }));
 }

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

@@ -66,7 +66,13 @@ export function BreadcrumbTrail({ crumbs, category, rootLabel = "All Categories"
      * missing and gave them no way to reach it.
      */
     const leadCount = hasCollapsed ? split.lead.length : 0;
-    return (_jsxs(Div, { className: className, children: [_jsxs(Row, { align: "center", gap: "xs", wrap: true, children: [_jsx(Breadcrumb, { items: visible.slice(0, leadCount), tone: tone }), hasCollapsed && (_jsxs(Details, { tone: "card", padding: "sm", rounded: "lg", children: [_jsx(Summary, { size: "xs", color: "muted", ariaLabel: `Show ${split.collapsed.length} hidden category levels`, children: `… ${split.collapsed.length} more` }), _jsx(Div, { padding: "t-xs", children: _jsx(Stack, { align: "start", gap: "xs", children: split.collapsed.map((c) => (_jsx(TextLink, { href: c.url ?? rootHref, size: "xs", children: c.name }, c.url ?? c.name))) }) })] })), _jsx(Breadcrumb, { items: hasCollapsed ? visible.slice(leadCount) : visible, tone: tone })] }), alt.mode === "inline" && (_jsxs(Span, { size: "xs", color: "muted", children: ["Also in", " ", alt.items.map((a, i) => (_jsxs(React.Fragment, { children: [i > 0 && " · ", _jsx(TextLink, { href: a.url ?? rootHref, size: "xs", children: a.name })] }, a.url ?? a.name)))] })), alt.mode === "dropdown" && (_jsxs(Details, { tone: "card", padding: "sm", rounded: "lg", children: [_jsx(Summary, { size: "xs", color: "muted", ariaLabel: "Other categories this listing is filed under", children: `Also in ${alt.items.length} more` }), _jsx(Div, { padding: "t-xs", children: _jsx(Stack, { align: "start", gap: "xs", children: alt.items.map((a) => (_jsx(TextLink, { href: a.url ?? rootHref, size: "xs", children: a.name }, a.url ?? a.name))) }) })] }))] }));
+    return (
+    /*
+     * No marker class here — it lives on the `<Breadcrumb>` primitive this
+     * renders below, which is also what the scam registry's pages use
+     * directly. One owner; see `Breadcrumb.tsx`.
+     */
+    _jsxs(Div, { className: className, children: [_jsxs(Row, { align: "center", gap: "xs", wrap: true, children: [_jsx(Breadcrumb, { items: visible.slice(0, leadCount), tone: tone }), hasCollapsed && (_jsxs(Details, { tone: "card", padding: "sm", rounded: "lg", children: [_jsx(Summary, { size: "xs", color: "muted", ariaLabel: `Show ${split.collapsed.length} hidden category levels`, children: `… ${split.collapsed.length} more` }), _jsx(Div, { padding: "t-xs", children: _jsx(Stack, { align: "start", gap: "xs", children: split.collapsed.map((c) => (_jsx(TextLink, { href: c.url ?? rootHref, size: "xs", children: c.name }, c.url ?? c.name))) }) })] })), _jsx(Breadcrumb, { items: hasCollapsed ? visible.slice(leadCount) : visible, tone: tone })] }), alt.mode === "inline" && (_jsxs(Span, { size: "xs", color: "muted", children: ["Also in", " ", alt.items.map((a, i) => (_jsxs(React.Fragment, { children: [i > 0 && " · ", _jsx(TextLink, { href: a.url ?? rootHref, size: "xs", children: a.name })] }, a.url ?? a.name)))] })), alt.mode === "dropdown" && (_jsxs(Details, { tone: "card", padding: "sm", rounded: "lg", children: [_jsx(Summary, { size: "xs", color: "muted", ariaLabel: "Other categories this listing is filed under", children: `Also in ${alt.items.length} more` }), _jsx(Div, { padding: "t-xs", children: _jsx(Stack, { align: "start", gap: "xs", children: alt.items.map((a) => (_jsx(TextLink, { href: a.url ?? rootHref, size: "xs", children: a.name }, a.url ?? a.name))) }) })] }))] }));
 }
 function fromCrumb(c) {
     return c.url ? { label: c.name, href: c.url } : { label: c.name };

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

@@ -26,7 +26,7 @@ export function BundleDetailView({ bundle, members = [], onBuyNow, onAddToCart,
         ? formatCurrency(bundle.bundlePrice, "INR")
         : BUNDLE_COPY.detail.priceFallback;
     const discount = computeBundleDiscount(bundle.bundlePrice, bundle.bundleOriginalTotal);
-    return (_jsxs(Main, { children: [_jsx(Section, { padding: "y-2xl", children: _jsx(Container, { size: "xl", children: _jsxs(Stack, { gap: "lg", children: [_jsxs(Stack, { gap: "lg", direction: "md-row", align: "start", children: [_jsx(Div, { className: "w-full md:w-2/5", children: members.length > 0 ? (_jsx(BundleCollage, { members: members })) : (_jsx(Div, { className: `aspect-video w-full ${__O.hidden}`, rounded: "2xl", surface: "subtle", children: _jsx(Div, { className: "h-full w-full", children: _jsx(MediaImage, { src: cover, alt: bundle.name, size: "hero", fallback: PLACEHOLDER_EMOJI }) }) })) }), _jsxs(Stack, { gap: "md", className: "flex-1", children: [_jsx(RecordOwnerQuickActions, { resource: "BUNDLE", recordId: String(bundle.id), placement: "detail", recordLabel: String(bundle.name) }), _jsx(Heading, { level: 1, size: "3xl", weight: "semibold", color: "primary", children: bundle.name }), _jsxs(Row, { gap: "sm", align: "center", wrap: true, children: [_jsx(Text, { size: "lg", weight: "bold", children: _jsx(GatedPrice, { label: "Sign in to see the bundle price", children: priceLabel }) }), discount && (
+    return (_jsxs(Main, { children: [_jsx(Section, { padding: "y-2xl", children: _jsx(Container, { size: "xl", children: _jsxs(Stack, { gap: "lg", children: [_jsxs(Stack, { gap: "lg", direction: "md-row", align: "start", children: [_jsx(Div, { className: "w-full md:w-2/5", children: members.length > 0 ? (_jsx(BundleCollage, { members: members })) : (_jsx(Div, { className: `aspect-video w-full ${__O.hidden}`, rounded: "2xl", surface: "subtle", children: _jsx(Div, { className: "h-full w-full", children: _jsx(MediaImage, { src: cover, alt: bundle.name, size: "hero", fallback: PLACEHOLDER_EMOJI }) }) })) }), _jsxs(Stack, { gap: "md", className: "flex-1", children: [_jsx(Heading, { level: 1, size: "3xl", weight: "semibold", color: "primary", children: bundle.name }), _jsx(RecordOwnerQuickActions, { resource: "BUNDLE", recordId: String(bundle.id), placement: "detail", recordLabel: String(bundle.name) }), _jsxs(Row, { gap: "sm", align: "center", wrap: true, children: [_jsx(Text, { size: "lg", weight: "bold", children: _jsx(GatedPrice, { label: "Sign in to see the bundle price", children: priceLabel }) }), discount && (
                                                     // Both the struck-through total and the "N% off" badge are
                                                     // derived from the bundle price, so they disclose it even
                                                     // though the badge carries no currency symbol.