@mohasinac/appkit 4.11.0 → 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/features/products/to-product-item.d.ts

@@ -0,0 +1,25 @@
+/**
+ * toProductItem — Firestore doc → card-grid `ProductItem` mapper.
+ *
+ * Lives in `_internal/shared/` (client+server safe), NOT in
+ * `_internal/server/features/products/data.ts` where it was originally
+ * written. It is a pure field mapping with no server dependencies of its
+ * own, but `data.ts` transitively reaches `providers/db-firebase/admin.js`
+ * (firebase-admin), and `GroupedListingsCarousel.tsx` is a `"use client"`
+ * component that imports this function as a VALUE. Turbopack resolves a
+ * module's full static import graph before tree-shaking, so that single
+ * import dragged the whole firebase-admin chain into the client bundle and
+ * failed the production build outright:
+ *
+ *   Module not found: .../providers/db-firebase/admin.js
+ *     [Client Component Browser] → GroupedListingsCarousel
+ *     → _internal/server/features/products/data.js
+ *
+ * This is the Turbopack client-bundle trap from CLAUDE.md's appkit Export
+ * Rules / Recurrent Root Cause #6, reached through an ordinary deep import
+ * rather than a barrel. Keep this file free of any server-only import so a
+ * client component can always call it directly.
+ */
+import type { FirestoreDocument } from "../../../../schemas/types";
+import type { ProductItem } from "../../../../features/products/types";
+export declare function toProductItem(doc: FirestoreDocument): ProductItem;

package/dist/_internal/shared/features/products/to-product-item.js

@@ -0,0 +1,45 @@
+/**
+ * toProductItem — Firestore doc → card-grid `ProductItem` mapper.
+ *
+ * Lives in `_internal/shared/` (client+server safe), NOT in
+ * `_internal/server/features/products/data.ts` where it was originally
+ * written. It is a pure field mapping with no server dependencies of its
+ * own, but `data.ts` transitively reaches `providers/db-firebase/admin.js`
+ * (firebase-admin), and `GroupedListingsCarousel.tsx` is a `"use client"`
+ * component that imports this function as a VALUE. Turbopack resolves a
+ * module's full static import graph before tree-shaking, so that single
+ * import dragged the whole firebase-admin chain into the client bundle and
+ * failed the production build outright:
+ *
+ *   Module not found: .../providers/db-firebase/admin.js
+ *     [Client Component Browser] → GroupedListingsCarousel
+ *     → _internal/server/features/products/data.js
+ *
+ * This is the Turbopack client-bundle trap from CLAUDE.md's appkit Export
+ * Rules / Recurrent Root Cause #6, reached through an ordinary deep import
+ * rather than a barrel. Keep this file free of any server-only import so a
+ * client component can always call it directly.
+ */
+export function toProductItem(doc) {
+    return {
+        id: String(doc.id ?? ""),
+        title: String(doc.title ?? doc.name ?? ""),
+        price: typeof doc.price === "number" ? doc.price : 0,
+        originalPrice: typeof doc.originalPrice === "number" ? doc.originalPrice : undefined,
+        mainImage: Array.isArray(doc.images)
+            ? doc.images[0]
+            : typeof doc.mainImage === "string"
+                ? doc.mainImage
+                : undefined,
+        status: doc.status ?? "published",
+        slug: typeof doc.slug === "string" ? doc.slug : undefined,
+        storeName: typeof doc.storeName === "string" ? doc.storeName : undefined,
+        rating: typeof doc.rating === "number" ? doc.rating : undefined,
+        reviewCount: typeof doc.reviewCount === "number" ? doc.reviewCount : undefined,
+        // Without this, every related-item card silently linked to the standard
+        // PDP regardless of its real type (pluginFor() defaults to "standard"
+        // when listingType is missing) — same bug class as the Phase 1 routing
+        // fix, one hop further downstream in the related-items card link path.
+        listingType: doc.listingType ?? undefined,
+    };
+}

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]);