@mohasinac/appkit 4.13.1 → 4.14.0

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

@@ -22,6 +22,13 @@ export interface MarketplaceAuctionCardData {
     status?: string;
     slug?: string;
     buyNowPrice?: number;
+    /**
+     * Feeds `isBuyNowAvailable` alongside `currentBid`/`auctionEndDate`. Every
+     * doc→card mapper must copy it: dropping one field a shared predicate reads
+     * is exactly how a card ends up advertising a buyout the detail page refuses
+     * (Root Cause #48).
+     */
+    isSold?: boolean;
     /** Display name of the auction winner — shown masked when the auction has ended */
     winnerDisplayName?: string;
 }

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

@@ -12,6 +12,7 @@ import { ROUTES } from "../../../next";
 import { formatCurrency } from "../../../utils";
 import { getDefaultCurrency } from "../../../core/baseline-resolver";
 import { BaseListingCard, Button, Caption, Div, Row, Span, Stack, Text, TextLink } from "../../../ui";
+import { isBuyNowAvailable } from "../../../_internal/shared/features/auctions/config";
 const CLS_STAR_ICON = "h-5 w-5 fill-warning text-warning";
 const CLS_LIVE_BADGE = "rounded-full bg-error-solid px-[var(--appkit-space-2)] py-[var(--appkit-space-0-5)] text-error-on-solid";
 const CLS_ENDING_BADGE = "rounded-full bg-warning-solid px-[var(--appkit-space-2)] py-[var(--appkit-space-0-5)] text-warning-on-solid";
@@ -28,7 +29,11 @@ function renderAuctionCardInfoList(props) {
 }
 function renderAuctionCardInfoGrid(props) {
     const { product, auctionHref, displayBid, bidCount, hasCurrentBid, isEnded, remaining, resolvedBuyoutPrice, inWishlist, wishlistLoading, wishlistActions, countdownClass, mergedLabels, handleWishlist, handleNavigate } = props;
-    return (_jsxs(_Fragment, { children: [_jsxs(Row, { align: "start", gap: "sm", children: [_jsx(TextLink, { href: auctionHref ?? "#", className: "min-w-0 flex-1 leading-snug transition-colors hover:text-primary", color: "primary", size: "sm", weight: "medium", children: product.title }), wishlistActions ? (_jsx(Button, { rounded: "full", type: "button", variant: "ghost", onClick: handleWishlist, disabled: wishlistLoading, "aria-label": inWishlist ? mergedLabels.removeFromWishlist : mergedLabels.addToWishlist, className: "-mt-0.5 p-[0.25rem]", children: _jsx(Heart, { className: `h-4 w-4 ${inWishlist ? CLS_HEART_ON : CLS_HEART_OFF}` }) })) : null] }), _jsxs(Div, { children: [_jsx(Caption, { children: isEnded && hasCurrentBid ? mergedLabels.winningBid : hasCurrentBid ? mergedLabels.currentBid : mergedLabels.startingBid }), _jsx(Text, { className: "leading-none text-primary", size: "base", weight: "bold", children: formatCurrency(displayBid, getDefaultCurrency()) }), isEnded && product.winnerDisplayName && (_jsxs(Caption, { className: "mt-0.5", color: "muted", children: [mergedLabels.wonBy, ": ", maskDisplayName(product.winnerDisplayName)] }))] }), _jsxs(Row, { wrap: true, justify: "between", gap: "sm", className: "gap-x-2 gap-y-1", children: [_jsxs(Div, { layout: "inline-flex", gap: "1", textWeight: "semibold", textSize: "xs", className: `items-[center] ${countdownClass}`, paddingY: "y-2xs", paddingX: "x-xs", rounded: "full", children: [_jsx(Clock, { className: "h-3 w-3" }), _jsx(Span, { children: formatCountdownLabel(remaining, mergedLabels.ended) })] }), _jsx(Caption, { children: mergedLabels.totalBids(bidCount) })] }), _jsx(Row, { wrap: true, gap: "xs", className: "mt-auto", children: isEnded ? (_jsx(Button, { gap: "xs", type: "button", variant: "ghost", size: "sm", textSize: "xs", paddingX: "xs", className: "flex-1 cursor-not-allowed opacity-60", disabled: true, children: _jsx(Span, { children: mergedLabels.ended }) })) : (_jsxs(_Fragment, { children: [_jsxs(Button, { gap: "xs", type: "button", variant: "warning", size: "sm", textSize: "xs", paddingX: "xs", className: "flex-1", onClick: handleNavigate, children: [_jsx(Gavel, { className: "h-3 w-3" }), _jsx(Span, { children: mergedLabels.placeBid })] }), resolvedBuyoutPrice ? (_jsxs(Button, { gap: "xs", type: "button", variant: "danger", size: "sm", textSize: "xs", paddingX: "xs", className: "flex-1", onClick: handleNavigate, children: [_jsx(ShoppingBag, { className: "h-3 w-3" }), _jsx(Span, { children: mergedLabels.buyout })] })) : null] })) })] }));
+    return (_jsxs(_Fragment, { children: [_jsxs(Row, { align: "start", gap: "sm", children: [_jsx(TextLink, { href: auctionHref ?? "#", className: "min-w-0 flex-1 leading-snug transition-colors hover:text-primary", color: "primary", size: "sm", weight: "medium", children: product.title }), wishlistActions ? (_jsx(Button, { rounded: "full", type: "button", variant: "ghost", onClick: handleWishlist, disabled: wishlistLoading, "aria-label": inWishlist ? mergedLabels.removeFromWishlist : mergedLabels.addToWishlist, className: "-mt-0.5 p-[0.25rem]", children: _jsx(Heart, { className: `h-4 w-4 ${inWishlist ? CLS_HEART_ON : CLS_HEART_OFF}` }) })) : null] }), _jsxs(Div, { children: [_jsx(Caption, { children: isEnded && hasCurrentBid ? mergedLabels.winningBid : hasCurrentBid ? mergedLabels.currentBid : mergedLabels.startingBid }), _jsx(Text, { className: "leading-none text-primary", size: "base", weight: "bold", children: formatCurrency(displayBid, getDefaultCurrency()) }), isEnded && product.winnerDisplayName && (_jsxs(Caption, { className: "mt-0.5", color: "muted", children: [mergedLabels.wonBy, ": ", maskDisplayName(product.winnerDisplayName)] }))] }), _jsxs(Row, { wrap: true, justify: "between", gap: "sm", className: "gap-x-2 gap-y-1", children: [_jsxs(Div, { layout: "inline-flex", gap: "1", textWeight: "semibold", textSize: "xs", className: `items-[center] ${countdownClass}`, paddingY: "y-2xs", paddingX: "x-xs", rounded: "full", children: [_jsx(Clock, { className: "h-3 w-3" }), _jsx(Span, { children: formatCountdownLabel(remaining, mergedLabels.ended) })] }), _jsx(Caption, { children: mergedLabels.totalBids(bidCount) })] }), _jsx(Row, { wrap: true, gap: "xs", className: "mt-auto", children: isEnded ? (_jsx(Button, { gap: "xs", type: "button", variant: "ghost", size: "sm", textSize: "xs", paddingX: "xs", className: "flex-1 cursor-not-allowed opacity-60", disabled: true, children: _jsx(Span, { children: mergedLabels.ended }) })) : (_jsxs(_Fragment, { children: [_jsxs(Button, { gap: "xs", type: "button", variant: "warning", size: "sm", textSize: "xs", paddingX: "xs", className: "flex-1", onClick: handleNavigate, children: [_jsx(Gavel, { className: "h-3 w-3" }), _jsx(Span, { children: mergedLabels.placeBid })] }), resolvedBuyoutPrice ? (
+                        /* `secondary`, not `danger` — this button only navigates to the
+                           PDP, and `danger` is reserved for destructive actions (Rule #7
+                           kinds). ACTIONS.AUCTION["buy-it-now"] is itself `secondary`. */
+                        _jsxs(Button, { gap: "xs", type: "button", variant: "secondary", size: "sm", textSize: "xs", paddingX: "xs", className: "flex-1", onClick: handleNavigate, children: [_jsx(ShoppingBag, { className: "h-3 w-3" }), _jsx(Span, { children: mergedLabels.buyout })] })) : null] })) })] }));
 }
 const DEFAULT_LABELS = {
     selectItem: "Select item",
@@ -107,7 +112,19 @@ export function MarketplaceAuctionCard({ product, buyoutPrice, className = "", v
     const bidCount = product.bidCount ?? 0;
     const hasCurrentBid = (product.currentBid ?? 0) > 0;
     const hasVideo = Boolean(product.video?.url);
-    const resolvedBuyoutPrice = buyoutPrice ?? product.buyNowPrice;
+    // Availability is folded in HERE rather than at the render site, so the chip
+    // can never advertise a buyout the detail page will refuse. It used to gate on
+    // the price merely EXISTING, so cards linked through to a PDP with no Buy Now
+    // button at all. `isBuyNowAvailable` is the same predicate that page uses.
+    const rawBuyoutPrice = buyoutPrice ?? product.buyNowPrice;
+    const resolvedBuyoutPrice = isBuyNowAvailable({
+        buyNowPrice: rawBuyoutPrice,
+        currentBid: product.currentBid,
+        isEnded,
+        isSold: product.isSold === true,
+    })
+        ? rawBuyoutPrice
+        : undefined;
     const images = [product.mainImage, ...(product.images ?? [])].filter(Boolean);
     const currentSrc = images[imageIndex] ?? product.mainImage;
     useEffect(() => {

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

@@ -15,13 +15,12 @@ export interface PlaceBidFormClientProps {
     isEnded: boolean;
     auctionEndDate: Date | null;
     buyNowPrice: number | null;
-    bidsHaveStarted?: boolean;
     bidCount: number;
     tags?: string[];
     onPlaceBid: (input: PlaceBidInput) => Promise<unknown>;
     onBuyNow?: () => Promise<unknown>;
 }
-export declare function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded, auctionEndDate, 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, 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

@@ -10,7 +10,8 @@ import { FieldInput } from "../../../ui/forms/FieldInput";
 import { applyZodIssues } from "../../../ui/forms/FormShell";
 import { placeBidSchema } from "../schemas/bid-input";
 import { useLiveAuctionBid } from "../hooks/useLiveAuctionBid";
-import { BID_PRESET_MULTIPLIERS, resolveMinBid, resolveMinBidIncrement, } from "../../../_internal/shared/features/auctions/config";
+import { AUCTION_BUYOUT_WINDOW_MINUTES } from "../../../_internal/shared/checkout/lanes";
+import { BID_PRESET_MULTIPLIERS, isBuyNowAvailable, resolveMinBid, resolveMinBidIncrement, } from "../../../_internal/shared/features/auctions/config";
 import { normalizeError } from "../../../errors/normalize";
 const __P = {
     p5: "p-[var(--appkit-space-5)]",
@@ -22,7 +23,7 @@ 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, tiers, minBidIncrementOverride, currency, isEnded, auctionEndDate, buyNowPrice, bidsHaveStarted = false, bidCount: ssrBidCount, tags = [], onPlaceBid, onBuyNow, }) {
+export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, startingBid, tiers, minBidIncrementOverride, currency, isEnded, auctionEndDate, buyNowPrice, 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.
@@ -97,7 +98,10 @@ export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, start
         // presetAmount is derived from currentBid/minBidIncrement, both in deps.
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [currentBid, minBidIncrement, stepMul]);
-    const buyNowAvailable = buyNowPrice !== null && !isEnded && !bidsHaveStarted && !!onBuyNow;
+    // `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 schema = placeBidSchema(minBid, formatCurrency(minBid, currency));
     async function submitBid(amount, setFieldError) {
         try {
@@ -205,7 +209,7 @@ export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, start
                                     return applyZodIssues(parsed.error.issues, setFieldError);
                                 setSuccess(false);
                                 startTransition(() => submitBid(parsed.data.bidAmount, setFieldError));
-                            }, children: isEnded ? "Auction Ended" : "Place Bid" }), buyNowAvailable && (_jsx(Button, { variant: "secondary", size: "md", className: "w-full", type: "button", disabled: isBuyNowPending || isPending, isLoading: isBuyNowPending, onClick: handleBuyNow, children: `Buy Now — ${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, { rounded: "full", padding: "pill-sm-tall", surface: "subtle", color: "muted", size: "xs", children: tag }, tag))) }) }))] }));
+                            }, children: isEnded ? "Auction Ended" : "Place Bid" }), buyNowAvailable && (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "secondary", size: "md", className: "w-full", type: "button", disabled: isBuyNowPending || isPending, isLoading: isBuyNowPending, onClick: handleBuyNow, children: `Buy Now — ${formatCurrency(buyNowPrice, currency)}` }), _jsxs(Text, { align: "center", size: "xs", color: "muted", children: ["Skips the bidding. The auction stays live until you pay \u2014 complete checkout within ", AUCTION_BUYOUT_WINDOW_MINUTES, " minutes."] })] }))] })) }), 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, { rounded: "full", padding: "pill-sm-tall", surface: "subtle", color: "muted", size: "xs", children: tag }, tag))) }) }))] }));
 }
 /**
  * `PlaceBidModalButton` — opens a modal that hosts the same PlaceBidFormClient.

package/dist/features/auctions/repository/bid.repository.d.ts

@@ -66,6 +66,19 @@ export declare class BidRepository extends BaseRepository<BidDocument> {
      */
     markForfeited(bidId: string): Promise<void>;
     markLost(batch: WriteBatch, ref: DocumentReference): void;
+    /**
+     * Batched "everyone else lost", for callers that are not already inside a
+     * batch of their own — a Buy Now purchase ends the auction outside the
+     * settlement job, and the losing bids can be any number, so this writes them
+     * in Firestore-batch chunks rather than one round-trip per bid.
+     */
+    markManyLost(refs: readonly DocumentReference[]): Promise<void>;
+    /**
+     * A pending Buy Now claim that never became a sale. Not `forfeited` — that
+     * status means "won, then defaulted", and a lapsed claim never won anything;
+     * the auction it was placed against carried on untouched.
+     */
+    markCancelled(bidId: string): Promise<void>;
     markOutbid(batch: WriteBatch, ref: DocumentReference): void;
     markWinning(batch: WriteBatch, ref: DocumentReference): void;
     /**

package/dist/features/auctions/repository/bid.repository.js

@@ -148,6 +148,29 @@ export class BidRepository extends BaseRepository {
             updatedAt: new Date(),
         });
     }
+    /**
+     * Batched "everyone else lost", for callers that are not already inside a
+     * batch of their own — a Buy Now purchase ends the auction outside the
+     * settlement job, and the losing bids can be any number, so this writes them
+     * in Firestore-batch chunks rather than one round-trip per bid.
+     */
+    async markManyLost(refs) {
+        const CHUNK = 400; // under Firestore's 500-write batch limit, with headroom
+        for (let i = 0; i < refs.length; i += CHUNK) {
+            const batch = this.db.batch();
+            for (const ref of refs.slice(i, i + CHUNK))
+                this.markLost(batch, ref);
+            await batch.commit();
+        }
+    }
+    /**
+     * A pending Buy Now claim that never became a sale. Not `forfeited` — that
+     * status means "won, then defaulted", and a lapsed claim never won anything;
+     * the auction it was placed against carried on untouched.
+     */
+    async markCancelled(bidId) {
+        await this.update(bidId, { status: "cancelled", isWinning: false, updatedAt: new Date() });
+    }
     markOutbid(batch, ref) {
         batch.update(ref, {
             status: "outbid",

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

@@ -35,6 +35,23 @@ export interface BidDocument extends BaseDocument {
      * a dead status badge.
      */
     orderId?: string;
+    /**
+     * True when this bid was created by Buy Now rather than by a buyer typing an
+     * amount. Its `bidAmount` is the listing's `buyNowPrice`.
+     *
+     * A buyout bid starts `active` like any other, but is NOT an ordinary bid in
+     * two respects and both are load-bearing:
+     *  1. **Auction settlement must ignore it.** A pending buyout sits at the BIN
+     *     price, so it would otherwise win by default the moment the auction's
+     *     clock ran out — awarding the item to someone who explicitly did not
+     *     complete their purchase in time.
+     *  2. **It never moves `product.currentBid`.** A pending claim is not a
+     *     public price, and inflating the visible bid to the BIN price would make
+     *     `isBuyNowAvailable` false for everybody else, silently making the
+     *     buyout single-occupancy. Concurrency is settled by the transaction in
+     *     `claimAuctionForCheckout`, not by blocking the second buyer up front.
+     */
+    isBuyout?: boolean;
 }
 export declare const BID_COLLECTION: "bids";
 export declare const BID_INDEXED_FIELDS: readonly ["productId", "userId", "status", "isWinning", "bidDate", "createdAt"];

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

@@ -67,19 +67,20 @@ export declare const auctionItemSchema: z.ZodObject<{
     title: string;
     createdAt: string;
     updatedAt: string;
-    featured: boolean;
-    listingType: "auction";
     slug: string;
     price: number;
+    sellerId: string;
+    featured: boolean;
+    listingType: "auction";
     auctionEndDate: string;
     startingBid: number;
     bidCount: number;
-    sellerId: string;
     storeId?: string | undefined;
     description?: string | undefined;
     mainImage?: string | undefined;
     images?: string[] | undefined;
     currentBid?: number | undefined;
+    storeSlug?: string | undefined;
     media?: {
         type: "video" | "image" | "file";
         url: string;
@@ -89,7 +90,6 @@ export declare const auctionItemSchema: z.ZodObject<{
         youtubeId?: string | undefined;
         duration?: number | undefined;
     }[] | undefined;
-    storeSlug?: string | undefined;
 }, {
     currency: string;
     status: "draft" | "published" | "archived" | "sold";
@@ -97,19 +97,20 @@ export declare const auctionItemSchema: z.ZodObject<{
     title: string;
     createdAt: string;
     updatedAt: string;
-    featured: boolean;
-    listingType: "auction";
     slug: string;
     price: number;
+    sellerId: string;
+    featured: boolean;
+    listingType: "auction";
     auctionEndDate: string;
     startingBid: number;
     bidCount: number;
-    sellerId: string;
     storeId?: string | undefined;
     description?: string | undefined;
     mainImage?: string | undefined;
     images?: string[] | undefined;
     currentBid?: number | undefined;
+    storeSlug?: string | undefined;
     media?: {
         type: "video" | "image" | "file";
         url: string;
@@ -119,7 +120,6 @@ export declare const auctionItemSchema: z.ZodObject<{
         youtubeId?: string | undefined;
         duration?: number | undefined;
     }[] | undefined;
-    storeSlug?: string | undefined;
 }>;
 export declare const bidRecordSchema: z.ZodObject<{
     id: z.ZodString;
@@ -134,18 +134,18 @@ export declare const bidRecordSchema: z.ZodObject<{
     currency: string;
     id: string;
     amount: number;
-    auctionId: string;
     bidderId: string;
     isWinning: boolean;
+    auctionId: string;
     placedAt: string;
     bidderDisplayName?: string | undefined;
 }, {
     currency: string;
     id: string;
     amount: number;
-    auctionId: string;
     bidderId: string;
     isWinning: boolean;
+    auctionId: string;
     placedAt: string;
     bidderDisplayName?: string | undefined;
 }>;
@@ -159,12 +159,12 @@ export declare const auctionListParamsSchema: z.ZodObject<{
     sort?: string | undefined;
     page?: number | undefined;
     pageSize?: number | undefined;
-    filters?: string | undefined;
     storeSlug?: string | undefined;
+    filters?: string | undefined;
 }, {
     sort?: string | undefined;
     page?: number | undefined;
     pageSize?: number | undefined;
-    filters?: string | undefined;
     storeSlug?: string | undefined;
+    filters?: string | undefined;
 }>;

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

@@ -11,7 +11,7 @@
  * Permission naming: admin:resource:action
  * Ban action naming: plain verb phrase — write_reviews, place_bids, etc.
  */
-export type Permission = "admin:dashboard:view" | "admin:users:read" | "admin:users:write" | "admin:users:delete" | "admin:user-bans:read" | "admin:user-bans:write" | "admin:products:read" | "admin:products:write" | "admin:products:delete" | "admin:orders:read" | "admin:orders:write" | "admin:returns:read" | "admin:returns:write" | "admin:stores:read" | "admin:stores:write" | "admin:store-addresses:read" | "admin:addresses:read" | "admin:addresses:write" | "admin:analytics:view" | "admin:payouts:read" | "admin:payouts:write" | "admin:audit-log:read" | "admin:categories:read" | "admin:categories:write" | "admin:categories:delete" | "admin:brands:read" | "admin:brands:write" | "admin:brands:delete" | "admin:coupons:read" | "admin:coupons:write" | "admin:coupons:delete" | "admin:deals:read" | "admin:deals:write" | "admin:featured:read" | "admin:featured:write" | "admin:reviews:read" | "admin:reviews:write" | "admin:reviews:delete" | "admin:blog:read" | "admin:blog:write" | "admin:blog:delete" | "admin:blog:publish" | "admin:bids:read" | "admin:bids:write" | "admin:media:read" | "admin:media:write" | "admin:media:delete" | "admin:site:read" | "admin:site:write" | "admin:settings:write" | "admin:navigation:read" | "admin:navigation:write" | "admin:sections:read" | "admin:sections:write" | "admin:carousel:read" | "admin:carousel:write" | "admin:carousel:delete" | "admin:ads:read" | "admin:ads:write" | "admin:ads:delete" | "admin:faqs:read" | "admin:faqs:write" | "admin:faqs:delete" | "admin:tester-checklist:read" | "admin:tester-checklist:write" | "admin:tester-checklist:delete" | "admin:tester-feedback:read" | "admin:tester-feedback:write" | "admin:newsletter:read" | "admin:newsletter:write" | "admin:contact:read" | "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: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:copilot:view" | "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";
+export type Permission = "admin:dashboard:view" | "admin:users:read" | "admin:users:write" | "admin:users:delete" | "admin:user-bans:read" | "admin:user-bans:write" | "admin:products:read" | "admin:products:write" | "admin:products:delete" | "admin:orders:read" | "admin:orders:write" | "admin:returns:read" | "admin:returns:write" | "admin:stores:read" | "admin:stores:write" | "admin:store-addresses:read" | "admin:addresses:read" | "admin:addresses:write" | "admin:analytics:view" | "admin:payouts:read" | "admin:payouts:write" | "admin:audit-log:read" | "admin:categories:read" | "admin:categories:write" | "admin:categories:delete" | "admin:brands:read" | "admin:brands:write" | "admin:brands:delete" | "admin:coupons:read" | "admin:coupons:write" | "admin:coupons:delete" | "admin:deals:read" | "admin:deals:write" | "admin:featured:read" | "admin:featured:write" | "admin:reviews:read" | "admin:reviews:write" | "admin:reviews:delete" | "admin:blog:read" | "admin:blog:write" | "admin:blog:delete" | "admin:blog:publish" | "admin:bids:read" | "admin:bids:write" | "admin:offers:read" | "admin:offers:write" | "admin:media:read" | "admin:media:write" | "admin:media:delete" | "admin:site:read" | "admin:site:write" | "admin:settings:write" | "admin:navigation:read" | "admin:navigation:write" | "admin:sections:read" | "admin:sections:write" | "admin:carousel:read" | "admin:carousel:write" | "admin:carousel:delete" | "admin:ads:read" | "admin:ads:write" | "admin:ads:delete" | "admin:faqs:read" | "admin:faqs:write" | "admin:faqs:delete" | "admin:tester-checklist:read" | "admin:tester-checklist:write" | "admin:tester-checklist:delete" | "admin:tester-feedback:read" | "admin:tester-feedback:write" | "admin:newsletter:read" | "admin:newsletter:write" | "admin:contact:read" | "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: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:copilot:view" | "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";
 /**
  * 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

@@ -161,6 +161,7 @@ export const PERMISSION_GROUPS = {
         "admin:carts:read",
         "admin:wishlists:read",
         "admin:bids:read",
+        "admin:offers:read",
     ],
     customer_support: [
         "admin:dashboard:view",
@@ -212,6 +213,8 @@ export const PERMISSION_GROUPS = {
         "admin:reviews:delete",
         "admin:bids:read",
         "admin:bids:write",
+        "admin:offers:read",
+        "admin:offers:write",
         "admin:sessions:read",
         "admin:sessions:delete",
         "admin:carts:read",
@@ -226,6 +229,8 @@ export const PERMISSION_GROUPS = {
         "admin:dashboard:view",
         "admin:bids:read",
         "admin:bids:write",
+        "admin:offers:read",
+        "admin:offers:write",
         "admin:products:read",
         "admin:orders:read",
         "admin:users:read",
@@ -280,6 +285,7 @@ export const ROUTE_PERMISSION_MAP = {
     "/admin/reviews": "admin:reviews:read",
     "/admin/blog": "admin:blog:read",
     "/admin/bids": "admin:bids:read",
+    "/admin/offers": "admin:offers:read",
     "/admin/media": "admin:media:read",
     "/admin/site": "admin:site:read",
     "/admin/settings": "admin:settings:write",
@@ -357,7 +363,10 @@ export const PERMISSION_DOMAINS = [
     { label: "Dashboard", prefix: "admin:dashboard:" },
     { label: "Users & Bans", prefix: "admin:users:|admin:user-bans:" },
     { label: "Products", prefix: "admin:products:" },
-    { label: "Orders & Returns", prefix: "admin:orders:|admin:returns:" },
+    // Offers sit with Orders, not with Content where Bids live: an offer is a
+    // commerce-pipeline object that ends in an order, and the permissions
+    // catalogue should group it where an operator would look for it.
+    { label: "Orders & Returns", prefix: "admin:orders:|admin:returns:|admin:offers:" },
     { label: "Stores", prefix: "admin:stores:|admin:store-addresses:" },
     { label: "Finance", prefix: "admin:analytics:|admin:payouts:" },
     { label: "Catalog", prefix: "admin:categories:|admin:brands:|admin:coupons:|admin:deals:|admin:featured:" },

package/dist/features/blog/actions/blog-actions.d.ts

@@ -72,8 +72,8 @@ export declare const createBlogPostSchema: z.ZodObject<{
     status: "draft" | "published" | "archived";
     title: string;
     content: string;
-    category: "news" | "tips" | "guides" | "updates" | "community";
     slug: string;
+    category: "news" | "tips" | "guides" | "updates" | "community";
     tags: string[];
     isFeatured: boolean;
     excerpt: string;
@@ -108,13 +108,13 @@ export declare const createBlogPostSchema: z.ZodObject<{
 }, {
     title: string;
     content: string;
-    category: "news" | "tips" | "guides" | "updates" | "community";
     slug: string;
+    category: "news" | "tips" | "guides" | "updates" | "community";
     excerpt: string;
     status?: "draft" | "published" | "archived" | undefined;
     tags?: string[] | undefined;
-    isFeatured?: boolean | undefined;
     publishedAt?: string | undefined;
+    isFeatured?: boolean | undefined;
     coverImage?: string | {
         type: "video" | "image" | "file";
         url: string;
@@ -211,11 +211,11 @@ export declare const updateBlogPostSchema: z.ZodObject<{
     status?: "draft" | "published" | "archived" | undefined;
     title?: string | undefined;
     content?: string | undefined;
-    category?: "news" | "tips" | "guides" | "updates" | "community" | undefined;
     slug?: string | undefined;
+    category?: "news" | "tips" | "guides" | "updates" | "community" | undefined;
     tags?: string[] | undefined;
-    isFeatured?: boolean | undefined;
     publishedAt?: string | undefined;
+    isFeatured?: boolean | undefined;
     excerpt?: string | undefined;
     coverImage?: {
         type: "video" | "image" | "file";
@@ -248,11 +248,11 @@ export declare const updateBlogPostSchema: z.ZodObject<{
     status?: "draft" | "published" | "archived" | undefined;
     title?: string | undefined;
     content?: string | undefined;
-    category?: "news" | "tips" | "guides" | "updates" | "community" | undefined;
     slug?: string | undefined;
+    category?: "news" | "tips" | "guides" | "updates" | "community" | undefined;
     tags?: string[] | undefined;
-    isFeatured?: boolean | undefined;
     publishedAt?: string | undefined;
+    isFeatured?: boolean | undefined;
     excerpt?: string | undefined;
     coverImage?: string | {
         type: "video" | "image" | "file";

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

@@ -125,8 +125,8 @@ export declare const blogPostFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    category: string;
     slug: string;
+    category: string;
     tags: string[];
     isFeatured: boolean;
     excerpt: string;
@@ -178,8 +178,8 @@ export declare const blogPostFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    category: string;
     slug: string;
+    category: string;
     tags: string[];
     isFeatured: boolean;
     excerpt: string;
@@ -358,8 +358,8 @@ export declare const blogPostSchema: z.ZodObject<{
     status: "draft" | "published" | "archived";
     id: string;
     title: string;
-    category: "news" | "tips" | "guides" | "updates" | "community";
     slug: string;
+    category: "news" | "tips" | "guides" | "updates" | "community";
     coverImage: {
         type: "video" | "image" | "file";
         url: string;
@@ -394,8 +394,8 @@ export declare const blogPostSchema: z.ZodObject<{
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     tags?: string[] | undefined;
-    isFeatured?: boolean | undefined;
     publishedAt?: string | undefined;
+    isFeatured?: boolean | undefined;
     excerpt?: string | undefined;
     authorId?: string | undefined;
     authorName?: string | undefined;
@@ -408,14 +408,14 @@ export declare const blogPostSchema: z.ZodObject<{
     status: "draft" | "published" | "archived";
     id: string;
     title: string;
-    category: "news" | "tips" | "guides" | "updates" | "community";
     slug: string;
+    category: "news" | "tips" | "guides" | "updates" | "community";
     content?: string | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     tags?: string[] | undefined;
-    isFeatured?: boolean | undefined;
     publishedAt?: string | undefined;
+    isFeatured?: boolean | undefined;
     excerpt?: string | undefined;
     coverImage?: string | {
         type: "video" | "image" | "file";

package/dist/features/cart/repository/cart.repository.js

@@ -100,6 +100,7 @@ export class CartRepository extends BaseRepository {
                     ...(input.isAuctionWin !== undefined && { isAuctionWin: input.isAuctionWin }),
                     ...(input.auctionId !== undefined && { auctionId: input.auctionId }),
                     ...(input.bidId !== undefined && { bidId: input.bidId }),
+                    ...(input.isBuyout !== undefined && { isBuyout: input.isBuyout }),
                     ...(input.lockedPrice !== undefined && {
                         lockedPrice: input.lockedPrice,
                     }),

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

@@ -38,6 +38,19 @@ export interface CartItemDocument {
     auctionId?: string;
     /** The winning bid, so the resulting order can be linked back to it. */
     bidId?: string;
+    /**
+     * True when this auction line came from Buy Now rather than from settlement.
+     *
+     * The two are NOT interchangeable even though both sit in the auction lane:
+     *  - a settlement line is a FINISHED auction — the item is already sold, the
+     *    buyer owes it, and the 48h window costs nobody anything;
+     *  - a buyout line is a CLAIM on an auction that is still live and still
+     *    taking bids. The item is not sold yet; it becomes sold only when
+     *    `claimAuctionForCheckout` commits at order time. Hence the 1h window,
+     *    and hence a lapse that cancels the bid rather than forfeiting it —
+     *    nothing was won, so nothing is forfeited, and the auction is untouched.
+     */
+    isBuyout?: boolean;
     /** Locked offer/winning-bid price — overrides normal product price at checkout */
     lockedPrice?: number;
     /**
@@ -158,6 +171,8 @@ export type AddToCartInput = {
     isAuctionWin?: boolean;
     auctionId?: string;
     bidId?: string;
+    /** See `CartItemDocument.isBuyout` — a claim on a live auction, not a win. */
+    isBuyout?: boolean;
     lockedPrice?: number;
     checkoutDeadline?: Date;
     locked?: boolean;

package/dist/features/catalogue/schemas/validation.d.ts

@@ -13,8 +13,8 @@ export declare const createCatalogueItemSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     title: string;
     images: string[];
-    visibility: "public" | "private";
     quantity: number;
+    visibility: "public" | "private";
     description?: string | undefined;
     categorySlugs?: string[] | undefined;
     brandSlug?: string | undefined;
@@ -30,8 +30,8 @@ export declare const createCatalogueItemSchema: z.ZodObject<{
     mainImage?: string | undefined;
     images?: string[] | undefined;
     condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
-    visibility?: "public" | "private" | undefined;
     quantity?: number | undefined;
+    visibility?: "public" | "private" | undefined;
 }>;
 export declare const updateCatalogueItemSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
@@ -53,8 +53,8 @@ export declare const updateCatalogueItemSchema: z.ZodObject<{
     mainImage?: string | undefined;
     images?: string[] | undefined;
     condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
-    visibility?: "public" | "private" | undefined;
     quantity?: number | undefined;
+    visibility?: "public" | "private" | undefined;
 }, {
     title?: string | undefined;
     description?: string | undefined;
@@ -64,8 +64,8 @@ export declare const updateCatalogueItemSchema: z.ZodObject<{
     mainImage?: string | undefined;
     images?: string[] | undefined;
     condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
-    visibility?: "public" | "private" | undefined;
     quantity?: number | undefined;
+    visibility?: "public" | "private" | undefined;
 }>;
 export type CreateCatalogueItemInput = z.infer<typeof createCatalogueItemSchema>;
 export type UpdateCatalogueItemInput = z.infer<typeof updateCatalogueItemSchema>;