@mohasinac/appkit 4.11.1 → 4.11.2

package/dist/_internal/shared/checkout/lanes.d.ts

@@ -0,0 +1,41 @@
+export declare const CART_LANE: {
+    readonly AUCTION: "auction";
+    readonly OFFER: "offer";
+    readonly STANDARD: "standard";
+};
+export type CartLane = (typeof CART_LANE)[keyof typeof CART_LANE];
+/**
+ * Highest obligation first. An auction win is a completed sale the buyer already
+ * committed to by bidding; an accepted offer is a price the seller has held for
+ * them on a clock; ordinary cart items carry no commitment at all.
+ */
+export declare const CART_LANE_PRIORITY: readonly CartLane[];
+export declare const CART_LANE_LABELS: Record<CartLane, string>;
+/** The two lanes whose price is fixed outside the listing. */
+export declare function isLockedLane(lane: CartLane): boolean;
+/** Minimal shape this module needs — works on cart documents and client rows alike. */
+export interface LaneAssignable {
+    isAuctionWin?: boolean;
+    isOffer?: boolean;
+    offerId?: string;
+    bidId?: string;
+}
+export declare function laneOf(item: LaneAssignable): CartLane;
+export declare function laneItems<T extends LaneAssignable>(items: readonly T[], lane: CartLane): T[];
+export declare function laneCounts(items: readonly LaneAssignable[]): Record<CartLane, number>;
+/**
+ * The one lane the buyer may check out right now, or null for an empty cart.
+ */
+export declare function activeLane(items: readonly LaneAssignable[]): CartLane | null;
+export declare function isLaneCheckoutable(items: readonly LaneAssignable[], lane: CartLane): boolean;
+/**
+ * Why `lane` can't be checked out right now — null when it can.
+ * Phrased for the buyer, naming the lane that's blocking and what to do.
+ */
+export declare function laneBlockReason(items: readonly LaneAssignable[], lane: CartLane): string | null;
+/**
+ * Whether a NEW item may be added to the cart at all. While a higher-obligation
+ * lane is pending, adding more shopping would let the buyer keep deferring the
+ * thing they already committed to.
+ */
+export declare function canAddNewItems(items: readonly LaneAssignable[]): boolean;

package/dist/_internal/shared/checkout/lanes.js

@@ -0,0 +1,106 @@
+/*
+ * WHY: A cart can hold three kinds of line with three different obligations — a
+ *      won auction (you owe it), an accepted offer (you negotiated it, at a
+ *      locked price, on a deadline), and ordinary shopping. Mixing them into one
+ *      total lets a buyer settle a ₹200 sticker while a ₹30,000 auction win they
+ *      already committed to sits unpaid, and makes every total ambiguous.
+ * WHAT: The lane model — a derived (never stored) partition of the cart, with a
+ *       strict priority order. Exactly one lane is checkout-able at a time: the
+ *       highest-priority non-empty one. Lower lanes stay visible but disabled,
+ *       and while a higher lane is pending nothing new may be added to the cart.
+ *
+ * Derived on purpose. A stored `lane` mirror field would drift the first time a
+ * write path forgot it (CLAUDE.md Root Cause #42), exactly as the manual-payment
+ * queue state is derived rather than stored.
+ *
+ * EXPORTS:
+ *   CartLane, CART_LANE_PRIORITY, CART_LANE_LABELS, laneOf, activeLane,
+ *   laneItems, laneCounts, isLaneCheckoutable, laneBlockReason, isLockedLane
+ *
+ * @tag domain:checkout,cart
+ * @tag layer:shared
+ * @tag pattern:none
+ * @tag access:isomorphic
+ * @tag consumers:CartRouteClient,CheckoutRouteClient,cart-actions,order-splitter,checkout/actions
+ * @tag sideEffects:none
+ */
+export const CART_LANE = {
+    AUCTION: "auction",
+    OFFER: "offer",
+    STANDARD: "standard",
+};
+/**
+ * Highest obligation first. An auction win is a completed sale the buyer already
+ * committed to by bidding; an accepted offer is a price the seller has held for
+ * them on a clock; ordinary cart items carry no commitment at all.
+ */
+export const CART_LANE_PRIORITY = [
+    CART_LANE.AUCTION,
+    CART_LANE.OFFER,
+    CART_LANE.STANDARD,
+];
+export const CART_LANE_LABELS = {
+    auction: "Auction wins",
+    offer: "Accepted offers",
+    standard: "Cart",
+};
+/** The two lanes whose price is fixed outside the listing. */
+export function isLockedLane(lane) {
+    return lane === CART_LANE.AUCTION || lane === CART_LANE.OFFER;
+}
+export function laneOf(item) {
+    if (item.isAuctionWin || item.bidId)
+        return CART_LANE.AUCTION;
+    if (item.isOffer || item.offerId)
+        return CART_LANE.OFFER;
+    return CART_LANE.STANDARD;
+}
+export function laneItems(items, lane) {
+    return items.filter((i) => laneOf(i) === lane);
+}
+export function laneCounts(items) {
+    const counts = { auction: 0, offer: 0, standard: 0 };
+    for (const item of items)
+        counts[laneOf(item)] += 1;
+    return counts;
+}
+/**
+ * The one lane the buyer may check out right now, or null for an empty cart.
+ */
+export function activeLane(items) {
+    const counts = laneCounts(items);
+    return CART_LANE_PRIORITY.find((lane) => counts[lane] > 0) ?? null;
+}
+export function isLaneCheckoutable(items, lane) {
+    return activeLane(items) === lane;
+}
+/**
+ * Why `lane` can't be checked out right now — null when it can.
+ * Phrased for the buyer, naming the lane that's blocking and what to do.
+ */
+export function laneBlockReason(items, lane) {
+    const active = activeLane(items);
+    if (active === lane)
+        return null;
+    const counts = laneCounts(items);
+    if (counts[lane] === 0)
+        return "There's nothing in this tab yet.";
+    if (active === CART_LANE.AUCTION) {
+        const n = counts.auction;
+        return `Settle your ${n} won auction${n === 1 ? "" : "s"} first — auction wins are already committed purchases.`;
+    }
+    if (active === CART_LANE.OFFER) {
+        const n = counts.offer;
+        return `Complete your ${n} accepted offer${n === 1 ? "" : "s"} first — the agreed price is only held for a limited time.`;
+    }
+    return "This tab can't be checked out right now.";
+}
+/**
+ * Whether a NEW item may be added to the cart at all. While a higher-obligation
+ * lane is pending, adding more shopping would let the buyer keep deferring the
+ * thing they already committed to.
+ */
+export function canAddNewItems(items) {
+    const active = activeLane(items);
+    return active === null || active === CART_LANE.STANDARD;
+}

package/dist/_internal/shared/checkout/order-math.d.ts

@@ -6,6 +6,25 @@
  */
 import type { CartItemDocument } from "../../../features/cart/schemas/firestore";
 import type { ProductDocument } from "../../../features/products/schemas/firestore";
+/**
+ * The single source of truth for "what do we charge for this line".
+ *
+ * Three cases, in priority order:
+ *
+ *  1. **A locked price** — an accepted offer or a won auction. `lockedPrice` is
+ *     the negotiated/won amount and it OVERRIDES the current listing price, which
+ *     is the whole point of the negotiation. Until 2026-08-21 none of the five
+ *     copies of this function looked at `lockedPrice`, so an accepted offer was
+ *     billed at the seller's listed price while the cart UI displayed the agreed
+ *     one (`item.lockedPrice ?? item.price`) — the buyer saw ₹X and paid ₹Y.
+ *  2. **A bundle line** (SB-UNI-5 2026-05-13) — `item.price` is the bundle price
+ *     locked at add-time.
+ *  3. **Everything else** — the live Firestore price, so a stale cart-cached
+ *     price is never charged on a COD/UPI order.
+ *
+ * `product` may be null for a locked line whose listing has since been archived;
+ * the locked price is still owed, so that case must not dereference `product`.
+ */
 export declare function unitPriceFor(item: CartItemDocument, product: ProductDocument | null): number;
 /**
  * P-6 — pre-order groups charge each product's own `preOrderDepositPercent`

package/dist/_internal/shared/checkout/order-math.js

@@ -1,11 +1,35 @@
 import { roundRupees } from "../../../utils/number.formatter";
-// SB-UNI-5 2026-05-13 — bundle cart-lines use item.price (locked bundle price
-// at add-time); regular lines use product.price (current Firestore). Prevents
-// stale cart-cached prices from being charged on COD/UPI orders.
+/**
+ * The single source of truth for "what do we charge for this line".
+ *
+ * Three cases, in priority order:
+ *
+ *  1. **A locked price** — an accepted offer or a won auction. `lockedPrice` is
+ *     the negotiated/won amount and it OVERRIDES the current listing price, which
+ *     is the whole point of the negotiation. Until 2026-08-21 none of the five
+ *     copies of this function looked at `lockedPrice`, so an accepted offer was
+ *     billed at the seller's listed price while the cart UI displayed the agreed
+ *     one (`item.lockedPrice ?? item.price`) — the buyer saw ₹X and paid ₹Y.
+ *  2. **A bundle line** (SB-UNI-5 2026-05-13) — `item.price` is the bundle price
+ *     locked at add-time.
+ *  3. **Everything else** — the live Firestore price, so a stale cart-cached
+ *     price is never charged on a COD/UPI order.
+ *
+ * `product` may be null for a locked line whose listing has since been archived;
+ * the locked price is still owed, so that case must not dereference `product`.
+ */
 export function unitPriceFor(item, product) {
-    return item.bundleCategorySlug && item.bundleProductIds?.length
-        ? item.price
-        : product.price;
+    if (typeof item.lockedPrice === "number" && item.lockedPrice > 0) {
+        return item.lockedPrice;
+    }
+    if (item.bundleCategorySlug && item.bundleProductIds?.length) {
+        return item.price;
+    }
+    // Null-safe fallback: one of the four call sites this replaced (the cart
+    // summary/preview path) already guarded with `product?.price ?? item.price`,
+    // and collapsing onto a non-null assertion would have regressed it into a
+    // crash whenever a cart line outlives its listing.
+    return product?.price ?? item.price;
 }
 /**
  * P-6 — pre-order groups charge each product's own `preOrderDepositPercent`

package/dist/_internal/shared/listing-types/feature-flags.d.ts

@@ -28,6 +28,7 @@ interface FeatureFlagSnapshot {
  */
 export declare function isListingTypeEnabled(type: ListingType, settings: FeatureFlagSnapshot | null | undefined): boolean;
 export declare function isCategoryTypeEnabled(type: CategoryType, settings: FeatureFlagSnapshot | null | undefined): boolean;
+export declare const ALL_LISTING_TYPES: ListingType[];
 /** Pull the full list of enabled listing types in canonical iteration order. */
 export declare function enabledListingTypes(settings: FeatureFlagSnapshot | null | undefined): ListingType[];
 export declare function enabledCategoryTypes(settings: FeatureFlagSnapshot | null | undefined): CategoryType[];

package/dist/_internal/shared/listing-types/feature-flags.js

@@ -26,18 +26,32 @@ export function isCategoryTypeEnabled(type, settings) {
     const flag = settings?.featureFlags?.categoryTypes?.[type];
     return flag !== false;
 }
+/**
+ * Every listing type, in canonical iteration order.
+ *
+ * Declared as `Record<ListingType, true>` rather than a plain array on purpose:
+ * adding a member to the `ListingType` union without adding it here is then a
+ * COMPILE error, not a silent omission. `art` / `stickers` were missing from
+ * the old hand-written array for exactly that reason, which meant
+ * `/api/products`' "strip disabled types" post-filter dropped every art and
+ * sticker row from any call that didn't name a listingType explicitly
+ * (homepage, search, related-items).
+ */
+const ALL_LISTING_TYPES_MAP = {
+    standard: true,
+    auction: true,
+    "pre-order": true,
+    "prize-draw": true,
+    classified: true,
+    "digital-code": true,
+    live: true,
+    art: true,
+    stickers: true,
+};
+export const ALL_LISTING_TYPES = Object.keys(ALL_LISTING_TYPES_MAP);
 /** Pull the full list of enabled listing types in canonical iteration order. */
 export function enabledListingTypes(settings) {
-    const all = [
-        "standard",
-        "auction",
-        "pre-order",
-        "prize-draw",
-        "classified",
-        "digital-code",
-        "live",
-    ];
-    return all.filter((t) => isListingTypeEnabled(t, settings));
+    return ALL_LISTING_TYPES.filter((t) => isListingTypeEnabled(t, settings));
 }
 export function enabledCategoryTypes(settings) {
     const all = ["category", "sublisting", "brand", "bundle"];

package/dist/client.d.ts

@@ -321,7 +321,7 @@ export type { GuestHistoryItem, GuestHistoryType, UserHistoryItem, HistoryProduc
 export type { TrackArgs as TrackHistoryArgs } from "./features/history/hooks/useHistory";
 export { WISHLIST_MAX, HISTORY_MAX, CART_MAX_ITEMS, } from "./constants/limits";
 export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, isArtListing, isStickersListing, } from "./features/products/utils/listing-type";
-export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, } from "./_internal/shared/listing-types/feature-flags";
+export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, } from "./_internal/shared/listing-types/feature-flags";
 export { actionTracker, setActionTrackerSink, resetActionTrackerSink, type ActionEvent, type ActionTrackerSink, } from "./_internal/shared/listing-types/action-tracker";
 export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_internal/shared/listing-types/cart-shipping";
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, type ActionDef, type ActionKind, type ActionResource, type ActionTree, type ActionConfirmation, } from "./_internal/shared/actions/action-registry";
@@ -410,3 +410,4 @@ export { API_ENDPOINTS } from "./constants/index";
 export { SELLER_LISTING_TABS, type SellerListingTabId, } from "./features/products/constants/listing-tabs";
 export { ALL_TAB, EMPTY_TAB, ADMIN_PRODUCT_STATUS_TABS, ADMIN_PRODUCT_LISTING_TYPE_TABS, ADMIN_BLOG_STATUS_TABS, ADMIN_USER_STATUS_TABS, ADMIN_USER_ROLE_TABS, ADMIN_STORE_STATUS_TABS, ADMIN_PAYOUT_STATUS_TABS, ADMIN_ORDER_STATUS_TABS, ADMIN_REVIEW_STATUS_TABS, ADMIN_REVIEW_RATING_TABS, ADMIN_BID_STATUS_TABS, ADMIN_CONTACT_STATUS_TABS, ADMIN_NEWSLETTER_STATUS_TABS, ADMIN_EVENT_ENTRY_STATUS_TABS, ADMIN_EVENT_STATUS_TABS, ADMIN_CART_OWNERSHIP_TABS, ADMIN_COUPON_TYPE_TABS, SELLER_PRODUCT_STATUS_TABS, SELLER_AUCTION_STATUS_TABS, SELLER_ORDER_STATUS_TABS, SELLER_OFFER_STATUS_TABS, SELLER_BID_STATUS_TABS, } from "./features/admin/constants/filter-tabs";
 export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, EVENT_FIELDS, EVENT_ENTRY_FIELDS, PAYOUT_FIELDS, STORE_FIELDS, CATEGORY_FIELDS, BLOG_FIELDS, USER_FIELDS, ADDRESS_FIELDS, BRAND_FIELDS, CART_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, NOTIFICATION_FIELDS, SESSION_FIELDS, COUPON_USAGE_FIELDS, CONVERSATION_FIELDS, SCAMMER_FIELDS, SUPPORT_TICKET_FIELDS, CAROUSEL_FIELDS, COUPON_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
+export { CART_LANE, CART_LANE_PRIORITY, CART_LANE_LABELS, laneOf, activeLane, laneItems, laneCounts, isLaneCheckoutable, laneBlockReason, isLockedLane, canAddNewItems, type CartLane, type LaneAssignable, } from "./_internal/shared/checkout/lanes";

package/dist/client.js

@@ -319,7 +319,7 @@ export { WISHLIST_MAX, HISTORY_MAX, CART_MAX_ITEMS, } from "./constants/limits";
 // SB-UNI-F 2026-05-13 — Phase 2 predicates surfaced through client barrel.
 export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, isArtListing, isStickersListing, } from "./features/products/utils/listing-type";
 // SB-UNI-X4 2026-05-13 — per-type feature-flag helpers (client-safe).
-export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, } from "./_internal/shared/listing-types/feature-flags";
+export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, } from "./_internal/shared/listing-types/feature-flags";
 // SB-UNI-X5 2026-05-13 — action telemetry sink (client-safe; defaults to
 // a no-op + console.debug in dev).
 export { actionTracker, setActionTrackerSink, resetActionTrackerSink, } from "./_internal/shared/listing-types/action-tracker";
@@ -393,3 +393,6 @@ export { API_ENDPOINTS } from "./constants/index";
 export { SELLER_LISTING_TABS, } from "./features/products/constants/listing-tabs";
 export { ALL_TAB, EMPTY_TAB, ADMIN_PRODUCT_STATUS_TABS, ADMIN_PRODUCT_LISTING_TYPE_TABS, ADMIN_BLOG_STATUS_TABS, ADMIN_USER_STATUS_TABS, ADMIN_USER_ROLE_TABS, ADMIN_STORE_STATUS_TABS, ADMIN_PAYOUT_STATUS_TABS, ADMIN_ORDER_STATUS_TABS, ADMIN_REVIEW_STATUS_TABS, ADMIN_REVIEW_RATING_TABS, ADMIN_BID_STATUS_TABS, ADMIN_CONTACT_STATUS_TABS, ADMIN_NEWSLETTER_STATUS_TABS, ADMIN_EVENT_ENTRY_STATUS_TABS, ADMIN_EVENT_STATUS_TABS, ADMIN_CART_OWNERSHIP_TABS, ADMIN_COUPON_TYPE_TABS, SELLER_PRODUCT_STATUS_TABS, SELLER_AUCTION_STATUS_TABS, SELLER_ORDER_STATUS_TABS, SELLER_OFFER_STATUS_TABS, SELLER_BID_STATUS_TABS, } from "./features/admin/constants/filter-tabs";
 export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, EVENT_FIELDS, EVENT_ENTRY_FIELDS, PAYOUT_FIELDS, STORE_FIELDS, CATEGORY_FIELDS, BLOG_FIELDS, USER_FIELDS, ADDRESS_FIELDS, BRAND_FIELDS, CART_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, NOTIFICATION_FIELDS, SESSION_FIELDS, COUPON_USAGE_FIELDS, CONVERSATION_FIELDS, SCAMMER_FIELDS, SUPPORT_TICKET_FIELDS, CAROUSEL_FIELDS, COUPON_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
+// Checkout lanes — the derived auction > offer > standard partition of the
+// cart, and the priority rule that decides which one may be checked out.
+export { CART_LANE, CART_LANE_PRIORITY, CART_LANE_LABELS, laneOf, activeLane, laneItems, laneCounts, isLaneCheckoutable, laneBlockReason, isLockedLane, canAddNewItems, } from "./_internal/shared/checkout/lanes";

package/dist/features/account/components/NotificationBell.js

@@ -22,6 +22,7 @@ const DEFAULT_ICONS = {
     bid_outbid: "⚡",
     bid_won: "🏆",
     bid_lost: "😔",
+    auction_ended: "🔚",
     review_approved: "⭐",
     review_replied: "💬",
     product_available: "🔔",

package/dist/features/account/components/UserOffersPanel.js

@@ -79,8 +79,15 @@ export function UserOffersPanel({ fetchEndpoint = ACCOUNT_ENDPOINTS.OFFERS, onAc
                 }
                 throw new Error(`Error ${res.status}`);
             }
+            // `/api/user/offers` replies through `successResponse`, i.e.
+            // `{ success, data: { items, total, … } }`. This used to read `json.items`
+            // straight off the envelope — always undefined — so "My Offers" showed
+            // "No offers yet" for every buyer, forever, with no error to notice.
+            // Both shapes are still accepted so an unwrapped caller keeps working.
             const json = (await res.json());
-            const items = Array.isArray(json) ? json : (json.items ?? []);
+            const items = Array.isArray(json)
+                ? json
+                : (json.data?.items ?? json.items ?? []);
             setOffers(items);
         }
         catch (err) {

package/dist/features/admin/actions/notification-actions.js

@@ -106,7 +106,7 @@ export async function sendNotification(input) {
         order_placed: "orderUpdates", order_confirmed: "orderUpdates",
         order_shipped: "orderUpdates", order_delivered: "orderUpdates",
         order_cancelled: "orderUpdates",
-        bid_placed: "bids", bid_outbid: "bids", bid_won: "bids", bid_lost: "bids",
+        bid_placed: "bids", bid_outbid: "bids", bid_won: "bids", bid_lost: "bids", auction_ended: "bids",
         review_approved: "reviews", review_replied: "reviews",
         promotion: "promotions",
         system: "system", welcome: "system", account_action: "system",

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

@@ -4,7 +4,7 @@
  */
 import type { AboutContentDocument } from "../../about/schemas/firestore";
 export declare const ADMIN_CHECKOUT_BYPASS_FLAG_KEY: "adminCheckoutBypass";
-export type NotificationType = "order_placed" | "order_confirmed" | "order_shipped" | "order_delivered" | "order_cancelled" | "bid_placed" | "bid_outbid" | "bid_won" | "bid_lost" | "review_approved" | "review_replied" | "product_available" | "promotion" | "system" | "welcome" | "account_action" | "offer_received" | "offer_responded" | "offer_expired" | "offer_counter_accepted" | "refund_initiated" | "prize_won" | "prize_reveal_expired" | "emi_installment_due_soon" | "emi_installment_overdue" | "payment_review";
+export type NotificationType = "order_placed" | "order_confirmed" | "order_shipped" | "order_delivered" | "order_cancelled" | "bid_placed" | "bid_outbid" | "bid_won" | "bid_lost" | "auction_ended" | "review_approved" | "review_replied" | "product_available" | "promotion" | "system" | "welcome" | "account_action" | "offer_received" | "offer_responded" | "offer_expired" | "offer_counter_accepted" | "refund_initiated" | "prize_won" | "prize_reveal_expired" | "emi_installment_due_soon" | "emi_installment_overdue" | "payment_review";
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export type NotificationPriority = "low" | "normal" | "high";
 export interface NotificationDocument extends BaseDocument {
@@ -53,6 +53,7 @@ export declare const NOTIFICATION_FIELDS: {
         readonly BID_OUTBID: NotificationType;
         readonly BID_WON: NotificationType;
         readonly BID_LOST: NotificationType;
+        readonly AUCTION_ENDED: NotificationType;
         readonly REVIEW_APPROVED: NotificationType;
         readonly REVIEW_REPLIED: NotificationType;
         readonly PRODUCT_AVAILABLE: NotificationType;

package/dist/features/admin/schemas/firestore.js

@@ -41,6 +41,7 @@ export const NOTIFICATION_FIELDS = {
         BID_OUTBID: "bid_outbid",
         BID_WON: "bid_won",
         BID_LOST: "bid_lost",
+        AUCTION_ENDED: "auction_ended",
         REVIEW_APPROVED: "review_approved",
         REVIEW_REPLIED: "review_replied",
         PRODUCT_AVAILABLE: "product_available",

package/dist/features/auctions/actions/bid-actions.d.ts

@@ -13,9 +13,19 @@ export interface BuyNowAuctionInput {
     productId: string;
 }
 export interface BuyNowAuctionResult {
-    orderId: string;
+    /**
+     * Buy-Now no longer creates an order directly. It writes a LOCKED CART LINE
+     * (same shape auction settlement produces for a winning bidder) and the buyer
+     * completes the real order through the auction checkout lane. The old
+     * behaviour created a document that no orders UI could render and no payment
+     * path could reach — see auctionSettlement.ts for the full writeup.
+     */
+    cartLocked: true;
+    productId: string;
     amount: number;
     currency: string;
+    /** Where to send the buyer to actually pay. */
+    checkoutUrl: string;
 }
 export declare function buyNowAuction(userId: string, userName: string, userEmail: string, input: BuyNowAuctionInput): Promise<BuyNowAuctionResult>;
 export declare function listBidsByProduct(productId: string, params?: {

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

@@ -22,6 +22,14 @@ import { ERROR_MESSAGES, AuthorizationError, ValidationError, NotFoundError, } f
 import { BID_ERROR_CODES } from "../../../errors/error-codes";
 import { increment } from "../../../contracts/field-ops";
 import { getDefaultCurrency } from "../../../core/baseline-resolver";
+import { cartRepository } from "../../cart/repository/cart.repository";
+import { ROUTES } from "../../../next/routing/route-map";
+import { CART_LANE } from "../../../_internal/shared/checkout/lanes";
+/**
+ * Buy-Now and auction settlement give the buyer the same 48h window to pay for
+ * a locked line. Kept identical on purpose — both are "you now owe this".
+ */
+const AUCTION_CHECKOUT_WINDOW_MS = 48 * 60 * 60 * 1000;
 import { resolveDate } from "../../../utils";
 // --- Domain Functions ----------------------------------------------------------
 export async function placeBid(userId, userEmail, input) {
@@ -194,33 +202,39 @@ export async function buyNowAuction(userId, userName, userEmail, input) {
         throw new ValidationError(ERROR_MESSAGES.BID.BUY_NOW_BIDS_STARTED, { code: BID_ERROR_CODES.BUY_NOW_BIDS_STARTED });
     }
     const currency = getDefaultCurrency();
-    let orderId = "";
     await unitOfWork.runBatch((batch) => {
-        const orderRef = unitOfWork.orders.createFromAuction(batch, {
-            productId,
-            productTitle: product.title,
-            userId,
-            userName,
-            userEmail,
-            storeId: product.storeId,
-            amount: buyNowPrice,
-            currency,
-            auctionProductId: productId,
-        });
-        orderId = orderRef.id;
         unitOfWork.products.updateInBatch(batch, productId, {
             isSold: true,
             availableQuantity: 0,
             auctionEndDate: new Date(),
         });
     });
+    // Locked cart line, not an order — see BuyNowAuctionResult above. Written
+    // through the repository directly (auctions are canAddToCart:false for
+    // user-initiated adds), the same deliberate bypass checkoutOffer uses.
+    await cartRepository.addItem(userId, {
+        productId,
+        productTitle: product.title,
+        productImage: product.mainImage ?? "",
+        price: buyNowPrice,
+        currency,
+        quantity: 1,
+        storeId: product.storeId,
+        storeName: product.storeName ?? "",
+        listingType: "auction",
+        isAuctionWin: true,
+        auctionId: productId,
+        lockedPrice: buyNowPrice,
+        checkoutDeadline: new Date(Date.now() + AUCTION_CHECKOUT_WINDOW_MS),
+        locked: true,
+    });
+    const checkoutUrl = `${String(ROUTES.USER.CHECKOUT)}?lane=${CART_LANE.AUCTION}`;
     serverLogger.info("buyNowAuction", {
-        orderId,
         productId,
         userId,
         amount: buyNowPrice,
     });
-    return { orderId, amount: buyNowPrice, currency };
+    return { cartLocked: true, productId, amount: buyNowPrice, currency, checkoutUrl };
 }
 export async function listBidsByProduct(productId, params) {
     const result = await bidRepository.list({

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

@@ -2,7 +2,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useMemo, useState } from "react";
 import { ChevronRight } from "lucide-react";
-import { Badge, Button, Div, Row, Span, Stack, Text } from "../../../ui";
+import { Badge, Button, Div, Row, Span, Stack, Text, TextLink } from "../../../ui";
+import { ROUTES } from "../../../next/routing/route-map";
+import { CART_LANE } from "../../../_internal/shared/checkout/lanes";
 import { Pagination } from "../../../ui/components/Pagination";
 const __O = {
     hidden: "overflow-hidden",
@@ -58,7 +60,9 @@ function AuctionRow({ auction, portal, }) {
     const sorted = useMemo(() => [...auction.bids].sort((a, b) => +new Date(b.bidDate) - +new Date(a.bidDate)), [auction.bids]);
     const highest = auction.bids.reduce((max, b) => Math.max(max, b.bidAmount), 0);
     const isWinning = auction.bids.some((b) => b.isWinning);
-    return (_jsxs(Div, { className: `border border-[var(--appkit-color-border)] ${__O.hidden} bg-[var(--appkit-color-surface)]`, rounded: "xl", shadow: "sm", children: [_jsxs(Button, { type: "button", variant: "ghost", onClick: () => setExpanded((v) => !v), gap: "lg", paddingX: "md", paddingY: "md", className: "w-full text-left", "aria-expanded": expanded, children: [_jsx(ChevronRight, { className: `shrink-0 text-[var(--appkit-color-text-muted)] transition-transform ${expanded ? "rotate-90" : ""}`, size: 16 }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(Text, { className: "text-[var(--appkit-color-text)] line-clamp-1", size: "sm", weight: "semibold", children: auction.productTitle }) }), _jsxs(Row, { gap: "sm", className: "shrink-0", children: [isWinning && (_jsx(Badge, { variant: "active", children: "Winning" })), _jsxs(Text, { variant: "secondary", size: "xs", children: [auction.bids.length, " bid", auction.bids.length !== 1 ? "s" : ""] }), _jsx(Text, { className: "text-[var(--appkit-color-text)]", size: "sm", weight: "semibold", children: formatBidAmount(highest) })] })] }), expanded && (_jsxs(Div, { className: "border-t border-[var(--appkit-color-border)]", children: [_jsxs(Div, { textSize: "xs", textWeight: "medium", paddingX: "x-md", paddingY: "y-xs", className: `grid text-[var(--appkit-color-text-muted)] uppercase tracking-wide border-b border-[var(--appkit-color-border-subtle)] ${portal === "buyer" ? "[grid-template-columns:1fr_auto_auto]" : "[grid-template-columns:1fr_1fr_auto_auto]"}`, children: [_jsx(Span, { children: portal === "buyer" ? "Amount" : "Bidder" }), portal !== "buyer" && _jsx(Span, { children: "Amount" }), _jsx(Span, { children: "Status" }), _jsx(Span, { className: "text-right", children: "Time" })] }), sorted.map((bid) => (_jsxs(Div, { layout: "grid", align: "center", paddingX: "x-md", paddingY: "y-xs-tall", className: `border-b border-[var(--appkit-color-border-subtle)] last:border-0 hover:bg-[var(--appkit-color-border-subtle)] transition-colors ${portal === "buyer" ? "[grid-template-columns:1fr_auto_auto]" : "[grid-template-columns:1fr_1fr_auto_auto]"}`, children: [portal !== "buyer" && (_jsx(Text, { className: "text-[var(--appkit-color-text)] truncate pr-[0.75rem]", size: "sm", children: bid.userName || bid.userId })), _jsx(Text, { className: "text-[var(--appkit-color-text)]", size: "sm", weight: "medium", children: formatBidAmount(bid.bidAmount) }), _jsx(Badge, { variant: STATUS_VARIANT[bid.status] ?? "pending", className: "capitalize", children: bid.status }), _jsx(Text, { variant: "secondary", size: "xs", align: "end", children: relDate(bid.bidDate) })] }, bid.id)))] }))] }));
+    return (_jsxs(Div, { className: `border border-[var(--appkit-color-border)] ${__O.hidden} bg-[var(--appkit-color-surface)]`, rounded: "xl", shadow: "sm", children: [_jsxs(Button, { type: "button", variant: "ghost", onClick: () => setExpanded((v) => !v), gap: "lg", paddingX: "md", paddingY: "md", className: "w-full text-left", "aria-expanded": expanded, children: [_jsx(ChevronRight, { className: `shrink-0 text-[var(--appkit-color-text-muted)] transition-transform ${expanded ? "rotate-90" : ""}`, size: 16 }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(Text, { className: "text-[var(--appkit-color-text)] line-clamp-1", size: "sm", weight: "semibold", children: auction.productTitle }) }), _jsxs(Row, { gap: "sm", className: "shrink-0", children: [isWinning && (_jsx(Badge, { variant: "active", children: "Winning" })), _jsxs(Text, { variant: "secondary", size: "xs", children: [auction.bids.length, " bid", auction.bids.length !== 1 ? "s" : ""] }), _jsx(Text, { className: "text-[var(--appkit-color-text)]", size: "sm", weight: "semibold", children: formatBidAmount(highest) })] })] }), expanded && (_jsxs(Div, { className: "border-t border-[var(--appkit-color-border)]", children: [_jsxs(Div, { textSize: "xs", textWeight: "medium", paddingX: "x-md", paddingY: "y-xs", className: `grid text-[var(--appkit-color-text-muted)] uppercase tracking-wide border-b border-[var(--appkit-color-border-subtle)] ${portal === "buyer" ? "[grid-template-columns:1fr_auto_auto]" : "[grid-template-columns:1fr_1fr_auto_auto]"}`, children: [_jsx(Span, { children: portal === "buyer" ? "Amount" : "Bidder" }), portal !== "buyer" && _jsx(Span, { children: "Amount" }), _jsx(Span, { children: "Status" }), _jsx(Span, { className: "text-right", children: "Time" })] }), sorted.map((bid) => (_jsxs(Div, { layout: "grid", align: "center", paddingX: "x-md", paddingY: "y-xs-tall", className: `border-b border-[var(--appkit-color-border-subtle)] last:border-0 hover:bg-[var(--appkit-color-border-subtle)] transition-colors ${portal === "buyer" ? "[grid-template-columns:1fr_auto_auto]" : "[grid-template-columns:1fr_1fr_auto_auto]"}`, children: [portal !== "buyer" && (_jsx(Text, { className: "text-[var(--appkit-color-text)] truncate pr-[0.75rem]", size: "sm", children: bid.userName || bid.userId })), _jsx(Text, { className: "text-[var(--appkit-color-text)]", size: "sm", weight: "medium", children: formatBidAmount(bid.bidAmount) }), _jsx(Badge, { variant: STATUS_VARIANT[bid.status] ?? "pending", className: "capitalize", children: bid.status }), _jsxs(Stack, { gap: "xs", className: "items-end", children: [_jsx(Text, { variant: "secondary", size: "xs", align: "end", children: relDate(bid.bidDate) }), portal === "buyer" && bid.status === "won" && (_jsx(TextLink, { href: bid.orderId
+                                            ? String(ROUTES.USER.ORDER_DETAIL(bid.orderId))
+                                            : `${String(ROUTES.USER.CHECKOUT)}?lane=${CART_LANE.AUCTION}`, size: "xs", weight: "semibold", children: bid.orderId ? "View order" : "Pay now →" }))] })] }, bid.id)))] }))] }));
 }
 export function AuctionBidsTable({ bids, portal = "buyer", emptyLabel = "No bids found.", totalPages, currentPage, onPageChange, }) {
     const auctions = useMemo(() => groupByAuction(bids), [bids]);

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

@@ -1,62 +1,21 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
-import { productRepository } from "../../../repositories";
 import { Container, Heading, Main, Section } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
-import { parseListingSearchParams } from "../../../utils/listing-params";
 import { AuctionsIndexListing } from "../../products/components/AuctionsIndexListing";
-const DEFAULT_PAGE = 1;
+import { listPublicProducts, parsePublicProductParams, } from "../../../_internal/server/features/products/list-public";
+const AUCTION_LISTING_TYPES = ["auction"];
 const DEFAULT_PAGE_SIZE = 24;
 const DEFAULT_SORT = "auctionEndDate";
-function sp(params, key) {
-    const v = params[key];
-    return Array.isArray(v) ? v[0] ?? "" : v ?? "";
-}
-function buildAuctionFilters(params) {
-    const parts = ["status==published", "listingType==auction"];
-    const minBid = sp(params, "minBid");
-    const maxBid = sp(params, "maxBid");
-    if (minBid)
-        parts.push(sieveFilter("currentBid", SIEVE_OP.GTE, minBid));
-    if (maxBid)
-        parts.push(sieveFilter("currentBid", SIEVE_OP.LTE, maxBid));
-    const store = sp(params, "store");
-    if (store) {
-        const values = store.split("|").filter(Boolean);
-        if (values.length === 1)
-            parts.push(sieveFilter("storeId", SIEVE_OP.EQ, values[0]));
-        else if (values.length > 1)
-            parts.push(sieveFilter("storeId", SIEVE_OP.EQ, values.join("|")));
-    }
-    // Mirror AuctionsIndexListing's client-side default (Root Cause pattern —
-    // SSR initialData is seeded into React Query with staleTime:Infinity, so if
-    // this SSR filter doesn't already exclude ended auctions, the client never
-    // refetches and ended auctions leak into the default "Show ended" off view).
-    const showEnded = sp(params, "showEnded") === "true";
-    const dateFrom = showEnded
-        ? sp(params, "dateFrom")
-        : sp(params, "dateFrom") || new Date().toISOString();
-    const dateTo = sp(params, "dateTo");
-    if (dateFrom)
-        parts.push(sieveFilter("auctionEndDate", SIEVE_OP.GTE, dateFrom));
-    if (dateTo)
-        parts.push(sieveFilter("auctionEndDate", SIEVE_OP.LTE, dateTo));
-    return parts.join(",");
-}
 export async function AuctionsListView({ searchParams = {} }) {
-    const std = parseListingSearchParams(searchParams);
-    const sort = std.sorts ?? DEFAULT_SORT;
-    const page = std.page ?? DEFAULT_PAGE;
-    const pageSize = std.pageSize ?? DEFAULT_PAGE_SIZE;
-    const filters = buildAuctionFilters(searchParams);
-    const result = await productRepository
-        .list({
-        filters,
-        sorts: sort,
-        page,
-        pageSize,
-    })
-        .catch(() => null);
-    const initial = result ?? null;
+    // Shared with /api/products. `hideEndedByDefault` mirrors
+    // AuctionsIndexListing's `showEnded ? … : dateFrom=now` default; because the
+    // default sort IS auctionEndDate, listPublicProducts pushes that range into
+    // Firestore rather than filtering in memory.
+    const initial = await listPublicProducts(parsePublicProductParams(searchParams, {
+        listingTypes: AUCTION_LISTING_TYPES,
+        pageSize: DEFAULT_PAGE_SIZE,
+        sorts: DEFAULT_SORT,
+        hideEndedByDefault: true,
+    }));
     return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-8", color: "primary", size: "3xl", weight: "semibold", children: "Live Auctions" }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(AuctionsIndexListing, { initialData: initial }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
 }

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

@@ -96,7 +96,16 @@ export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, start
                     return;
                 }
                 setSuccess(true);
-                router.refresh();
+                // Buy-Now writes a locked cart line, so send the buyer straight to the
+                // auction checkout lane to pay for it. This used to just call
+                // `router.refresh()` and discard the action's result entirely, leaving
+                // the buyer on the product page with no indication that anything was
+                // owed — the action returned an orderId nobody ever used.
+                const checkoutUrl = result?.checkoutUrl;
+                if (checkoutUrl)
+                    router.push(checkoutUrl);
+                else
+                    router.refresh();
             }
             catch (err) {
                 void normalizeError(err);

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

@@ -50,6 +50,21 @@ export declare class BidRepository extends BaseRepository<BidDocument> {
         data: BidDocument;
     } | null>;
     markWon(batch: WriteBatch, ref: DocumentReference): void;
+    /**
+     * Link a won bid to the order it eventually became.
+     *
+     * `BidDocument` had no `orderId` at all before 2026-08-21, so a won bid and
+     * the thing the buyer paid for were two unrelated records — the "Won" row in
+     * /user/bids could not link anywhere, and nothing could tell a settled win
+     * from an unpaid one.
+     */
+    attachOrder(bidId: string, orderId: string): Promise<void>;
+    /**
+     * The winner never paid within their checkout window. Distinct from "lost"
+     * (outbid) — this bidder won and then defaulted, which a seller may want to
+     * act on.
+     */
+    markForfeited(bidId: string): Promise<void>;
     markLost(batch: WriteBatch, ref: DocumentReference): void;
     markOutbid(batch: WriteBatch, ref: DocumentReference): void;
     markWinning(batch: WriteBatch, ref: DocumentReference): void;