@mohasinac/appkit 4.11.3 → 4.12.1

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

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useState, useTransition } from "react";
+import { useEffect, useRef, useState, useTransition } from "react";
 import { useRouter } from "next/navigation";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { isAuthError } from "../../../utils/auth-error";
@@ -10,7 +10,7 @@ import { FieldInput } from "../../../ui/forms/FieldInput";
 import { applyZodIssues } from "../../../ui/forms/FormShell";
 import { placeBidSchema } from "../schemas/bid-input";
 import { useLiveAuctionBid } from "../hooks/useLiveAuctionBid";
-import { resolveMinBidIncrement, } from "../../../_internal/shared/features/auctions/config";
+import { BID_PRESET_MULTIPLIERS, resolveMinBid, resolveMinBidIncrement, } from "../../../_internal/shared/features/auctions/config";
 import { normalizeError } from "../../../errors/normalize";
 const __P = {
     p5: "p-[var(--appkit-space-5)]",
@@ -32,19 +32,73 @@ export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, start
     // Tiered, floor-raising: resolves fresh whenever the live current bid
     // crosses a tier boundary while this modal is open.
     const minBidIncrement = resolveMinBidIncrement(currentBid, tiers, minBidIncrementOverride);
-    const minBid = currentBid + minBidIncrement;
+    // Mirrors `placeBid`'s own `hasBids`. The `currentBid` prop already falls
+    // back to `startingBid` when the auction has no bids, so it can't be tested
+    // for `> 0` the way the server tests the raw document field — `bidCount`, or
+    // a price that has moved past the opening one, is the equivalent signal.
+    const hasBids = bidCount > 0 || currentBid > startingBid;
+    // Same helper `placeBid` uses server-side, so the seeded amount below can
+    // never be one the server rejects.
+    const minBid = resolveMinBid(currentBid, tiers, minBidIncrementOverride, { hasBids });
     const [bidAmount, setBidAmount] = useState(String(minBid));
-    const [stepMul, setStepMul] = useState(1);
+    const [stepMul, setStepMul] = useState(BID_PRESET_MULTIPLIERS[0]);
     const [isPending, startTransition] = useTransition();
     const [isBuyNowPending, startBuyNowTransition] = useTransition();
     const [success, setSuccess] = useState(false);
     const [showLoginModal, setShowLoginModal] = useState(false);
+    /** Last amount the form itself wrote — see `seedAmount` below. */
+    const lastSeeded = useRef(minBid);
+    /**
+     * The bid a given preset multiplier resolves to at the live price.
+     *
+     * Anchored on `minBid` rather than `currentBid` so the first preset is always
+     * exactly the minimum acceptable bid. With bids present that is identical to
+     * the old `currentBid + increment * n`; with none it makes the opening preset
+     * the starting bid itself instead of an amount the seller never asked for.
+     */
+    function presetAmount(n) {
+        return minBid + minBidIncrement * (n - 1);
+    }
+    /**
+     * Write an amount the FORM chose (not the buyer). Tracking these separately
+     * from buyer keystrokes is what lets the live-price effect below tell "this
+     * value is still ours to update" from "the buyer typed this".
+     */
+    function seedAmount(value) {
+        lastSeeded.current = value;
+        setBidAmount(String(value));
+    }
     function applyPreset(n) {
         setStepMul(n);
-        setBidAmount(String(currentBid + minBidIncrement * n));
+        seedAmount(presetAmount(n));
     }
+    // Re-seed the amount whenever the live price moves under a preset selection.
+    //
+    // `bidAmount` was previously only ever written on mount or on click, but
+    // `currentBid` keeps updating from the `/auction-bids/{id}` SSE channel while
+    // this form is open. A buyer who opened the modal, sat on it while another
+    // bidder moved the price, then hit "Place Bid" was submitting an amount now
+    // below the minimum — a guaranteed BID_AMOUNT_TOO_LOW rejection, with the
+    // preset buttons above already relabelled to the new tier so the number in
+    // the field visibly disagreed with the button that was highlighted.
+    //
+    // Custom is deliberately left alone: a typed amount is the buyer's own, and
+    // the schema + `min` attribute already surface it if the price outran them.
+    useEffect(() => {
+        if (stepMul === "custom")
+            return;
+        const next = presetAmount(stepMul);
+        if (String(next) === bidAmount)
+            return;
+        // Only follow the live price, never fight the buyer's own edits.
+        if (bidAmount !== String(lastSeeded.current))
+            return;
+        seedAmount(next);
+        // 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;
-    const schema = placeBidSchema(minBid, minBidIncrement);
+    const schema = placeBidSchema(minBid, formatCurrency(minBid, currency));
     async function submitBid(amount, setFieldError) {
         try {
             const result = await onPlaceBid({ productId, bidAmount: amount });
@@ -54,8 +108,15 @@ export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, start
                 return;
             }
             setSuccess(true);
-            setBidAmount(String(amount + minBidIncrement));
-            setStepMul(1);
+            // Provisional next-bid seed, corrected by the live-price effect above as
+            // soon as the SSE tick for this bid lands. It is only provisional because
+            // under proxy-bid semantics `placeBid` treats the submission as a MAXIMUM
+            // — the resulting visible price is usually lower than `amount`, and if the
+            // bid lost to a higher standing proxy cap it is higher. The old
+            // `amount + increment` was therefore rarely the next valid bid; taking the
+            // max against the live price keeps this from ever seeding below minimum.
+            setStepMul(BID_PRESET_MULTIPLIERS[0]);
+            seedAmount(resolveMinBid(Math.max(currentBid, amount), tiers, minBidIncrementOverride));
             // The bid history list and any duplicated static current-bid/bid-count
             // text elsewhere on this SSR'd page (info panel, page-level summary
             // cards) are frozen server props — refresh so they reflect this bid
@@ -114,16 +175,30 @@ export function PlaceBidFormClient({ productId, currentBid: ssrCurrentBid, start
             }
         });
     }
-    return (_jsxs(Stack, { className: `${__P.p5}`, border: "subtle", gap: "md", rounded: "xl", surface: "muted", children: [_jsxs(Stack, { gap: "xs", children: [_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { size: "xs", color: "muted", children: "Current bid" }), _jsx(Text, { size: "xs", color: "muted", children: "Starting bid" })] }), _jsxs(Row, { justify: "between", align: "baseline", children: [_jsx(Span, { size: "xl", weight: "bold", className: "text-primary-600 dark:text-primary-400", children: formatCurrency(currentBid, currency) }), _jsx(Span, { size: "sm", color: "muted", children: formatCurrency(startingBid, currency) })] }), _jsxs(Text, { size: "xs", color: "faint", children: [bidCount, " ", bidCount === 1 ? "bid" : "bids", " \u00B7 min increment", " ", formatCurrency(minBidIncrement, currency)] })] }), _jsx(LoginRequiredModal, { isOpen: showLoginModal, onClose: () => setShowLoginModal(false), message: "You need to be signed in to place a bid. Please log in or create an account to continue." }), _jsx(Form, { onSubmit: (e) => {
+    return (_jsxs(Stack, { className: `${__P.p5}`, border: "subtle", gap: "md", rounded: "xl", surface: "muted", children: [_jsxs(Stack, { gap: "xs", children: [_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { size: "xs", color: "muted", children: hasBids ? "Current bid" : "Starting bid" }), _jsx(Text, { size: "xs", color: "muted", children: hasBids ? "Starting bid" : "Minimum bid" })] }), _jsxs(Row, { justify: "between", align: "baseline", children: [_jsx(Span, { size: "xl", weight: "bold", className: "text-primary-600 dark:text-primary-400", children: formatCurrency(currentBid, currency) }), _jsx(Span, { size: "sm", color: "muted", children: formatCurrency(hasBids ? startingBid : minBid, currency) })] }), _jsxs(Text, { size: "xs", color: "faint", children: [bidCount, " ", bidCount === 1 ? "bid" : "bids", " \u00B7 min increment", " ", formatCurrency(minBidIncrement, currency)] })] }), _jsx(LoginRequiredModal, { isOpen: showLoginModal, onClose: () => setShowLoginModal(false), message: "You need to be signed in to place a bid. Please log in or create an account to continue." }), _jsx(Form, { onSubmit: (e) => {
                     // handler wired through render-prop below — keeps setFieldError in scope
                     e.preventDefault();
-                }, children: ({ setFieldError, clearErrors }) => (_jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { gap: "xs", wrap: true, role: "radiogroup", "aria-label": "Bid amount preset", children: [[1, 5, 10].map((n) => (_jsxs(Button, { type: "button", variant: stepMul === n ? "primary" : "secondary", size: "sm", role: "radio", "aria-checked": stepMul === n, disabled: isEnded || isPending, onClick: () => {
-                                        clearErrors();
-                                        applyPreset(n);
-                                    }, children: ["+", formatCurrency(minBidIncrement * n, currency)] }, n))), _jsx(Button, { type: "button", variant: stepMul === "custom" ? "primary" : "ghost", size: "sm", role: "radio", "aria-checked": stepMul === "custom", disabled: isEnded || isPending, onClick: () => setStepMul("custom"), children: "Custom" })] }), _jsx(FieldInput, { name: "bidAmount", type: "number", value: bidAmount, readOnly: stepMul !== "custom", onChange: (value) => {
+                }, children: ({ setFieldError, clearErrors }) => (_jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { gap: "xs", wrap: true, role: "radiogroup", "aria-label": "Bid amount preset", children: [BID_PRESET_MULTIPLIERS.map((n) => {
+                                    const amount = presetAmount(n);
+                                    const delta = amount - currentBid;
+                                    // `delta` is 0 only for the opening preset on a bid-free
+                                    // auction, where the minimum IS the starting bid — "+₹0" would
+                                    // read as a broken button, so name what it actually is.
+                                    const stepLabel = delta > 0 ? `+${formatCurrency(delta, currency)}` : "Minimum";
+                                    return (_jsx(Button, { type: "button", variant: stepMul === n ? "primary" : "secondary", size: "sm", role: "radio", "aria-checked": stepMul === n, disabled: isEnded || isPending, "aria-label": delta > 0
+                                            ? `Bid ${formatCurrency(amount, currency)} — ${formatCurrency(delta, currency)} above the current bid`
+                                            : `Bid ${formatCurrency(amount, currency)} — the minimum accepted bid`, onClick: () => {
+                                            clearErrors();
+                                            applyPreset(n);
+                                        }, children: _jsxs(Stack, { gap: "none", align: "center", children: [_jsx(Span, { size: "xs", weight: "semibold", children: stepLabel }), _jsx(Span, { size: "xs", color: "muted", children: formatCurrency(amount, currency) })] }) }, n));
+                                }), _jsx(Button, { type: "button", variant: stepMul === "custom" ? "primary" : "ghost", size: "sm", role: "radio", "aria-checked": stepMul === "custom", disabled: isEnded || isPending, onClick: () => setStepMul("custom"), children: "Custom" })] }), _jsx(FieldInput, { name: "bidAmount", type: "number", value: bidAmount, readOnly: stepMul !== "custom", onChange: (value) => {
                                 setBidAmount(value);
                                 clearErrors();
-                            }, placeholder: `At least ${formatCurrency(minBid, currency)}`, min: minBid, "aria-label": "Your bid amount", disabled: isEnded || isPending }), stepMul === "custom" && (_jsxs(Text, { size: "xs", color: "muted", "aria-live": "polite", children: ["Any amount \u2265 ", formatCurrency(minBid, currency), " is accepted."] })), success && (_jsx(Text, { className: "text-success", size: "xs", children: "\u2713 Bid placed successfully!" })), !isEnded && auctionEndDate && (_jsxs(Text, { align: "center", size: "xs", color: "muted", children: ["Ends in ", _jsx(CountdownDisplay, { targetDate: auctionEndDate, format: "auto", expiredLabel: "Ended" })] })), _jsx(Button, { variant: "primary", size: "md", className: "w-full", disabled: isEnded || isPending, isLoading: isPending, type: "button", onClick: () => {
+                            }, placeholder: `At least ${formatCurrency(minBid, currency)}`, min: minBid, "aria-label": "Your bid amount", disabled: isEnded || isPending }), _jsx(Text, { size: "xs", color: "muted", "aria-live": "polite", children: stepMul === "custom"
+                                ? `Any amount from ${formatCurrency(minBid, currency)} up is accepted — it need not be an exact multiple of the increment.`
+                                : hasBids
+                                    ? `Minimum next bid ${formatCurrency(minBid, currency)} (current bid + ${formatCurrency(minBidIncrement, currency)} increment).`
+                                    : `Minimum opening bid ${formatCurrency(minBid, currency)} — the seller's starting bid. The ${formatCurrency(minBidIncrement, currency)} increment applies from the second bid on.` }), success && (_jsx(Text, { className: "text-success", size: "xs", children: "\u2713 Bid placed successfully!" })), !isEnded && auctionEndDate && (_jsxs(Text, { align: "center", size: "xs", color: "muted", children: ["Ends in ", _jsx(CountdownDisplay, { targetDate: auctionEndDate, format: "auto", expiredLabel: "Ended" })] })), _jsx(Button, { variant: "primary", size: "md", className: "w-full", disabled: isEnded || isPending, isLoading: isPending, type: "button", onClick: () => {
                                 clearErrors();
                                 const parsed = schema.safeParse({ bidAmount });
                                 if (!parsed.success)

package/dist/features/auctions/schemas/bid-input.d.ts

@@ -1,14 +1,27 @@
 import { z } from "zod";
 /**
  * Client-side schema for the place-bid form. Used by PlaceBidFormClient via
- * <Form> + FieldInput. Schema-driven so all messages are localised by a single
- * Zod custom-message map.
+ * <Form> + FieldInput.
  *
- * `minBid` and `minBidIncrement` are derived from the auction state and passed
- * to `placeBidSchema(minBid, minBidIncrement)` at render time.
+ * `minBid` is the auction's live minimum acceptable next bid, resolved by
+ * `resolveMinBid()` (`_internal/shared/features/auctions/config`) — the same
+ * helper `placeBid` uses server-side, so this form can never seed or accept an
+ * amount the server will then reject.
+ *
+ * `minBidLabel` is the currency-formatted rendering of `minBid` (e.g. "₹1,100")
+ * — the schema takes it pre-formatted rather than importing a formatter so the
+ * inline error reads in the buyer's currency instead of a bare number.
+ *
+ * Deliberately NOT enforced here: that the bid is an exact multiple of the
+ * increment. `placeBid` only requires `amount >= currentBid + increment`, so
+ * adding a multiple-of rule client-side would reject bids the server accepts.
+ * A refinement claiming to do that used to exist but was a no-op — its
+ * predicate was `(v - minBid) % inc === 0 || (v - minBid) >= 0`, and the
+ * right-hand disjunct is always true once the `v >= minBid` check above has
+ * passed, so it could never fail.
  */
-export declare const placeBidSchema: (minBid: number, minBidIncrement: number) => z.ZodObject<{
-    bidAmount: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodNumber, number, number>, number, number>, number, number>;
+export declare const placeBidSchema: (minBid: number, minBidLabel: string) => z.ZodObject<{
+    bidAmount: z.ZodEffects<z.ZodEffects<z.ZodNumber, number, number>, number, number>;
 }, "strip", z.ZodTypeAny, {
     bidAmount: number;
 }, {

package/dist/features/auctions/schemas/bid-input.js

@@ -1,16 +1,28 @@
 import { z } from "zod";
 /**
  * Client-side schema for the place-bid form. Used by PlaceBidFormClient via
- * <Form> + FieldInput. Schema-driven so all messages are localised by a single
- * Zod custom-message map.
+ * <Form> + FieldInput.
  *
- * `minBid` and `minBidIncrement` are derived from the auction state and passed
- * to `placeBidSchema(minBid, minBidIncrement)` at render time.
+ * `minBid` is the auction's live minimum acceptable next bid, resolved by
+ * `resolveMinBid()` (`_internal/shared/features/auctions/config`) — the same
+ * helper `placeBid` uses server-side, so this form can never seed or accept an
+ * amount the server will then reject.
+ *
+ * `minBidLabel` is the currency-formatted rendering of `minBid` (e.g. "₹1,100")
+ * — the schema takes it pre-formatted rather than importing a formatter so the
+ * inline error reads in the buyer's currency instead of a bare number.
+ *
+ * Deliberately NOT enforced here: that the bid is an exact multiple of the
+ * increment. `placeBid` only requires `amount >= currentBid + increment`, so
+ * adding a multiple-of rule client-side would reject bids the server accepts.
+ * A refinement claiming to do that used to exist but was a no-op — its
+ * predicate was `(v - minBid) % inc === 0 || (v - minBid) >= 0`, and the
+ * right-hand disjunct is always true once the `v >= minBid` check above has
+ * passed, so it could never fail.
  */
-export const placeBidSchema = (minBid, minBidIncrement) => z.object({
+export const placeBidSchema = (minBid, minBidLabel) => z.object({
     bidAmount: z.coerce
         .number({ required_error: "Enter a bid amount" })
         .refine((v) => Number.isFinite(v) && v > 0, "Enter a valid bid amount")
-        .refine((v) => v >= minBid, `Bid must be at least ${minBid}`)
-        .refine((v) => (v - minBid) % minBidIncrement === 0 || (v - minBid) >= 0, `Bid must respect the minimum increment of ${minBidIncrement}`),
+        .refine((v) => v >= minBid, `Bid must be at least ${minBidLabel}`),
 });

package/dist/features/auth/repository/user.repository.js

@@ -257,6 +257,12 @@ UserRepository.SIEVE_FIELDS = {
     emailVerified: { canFilter: true, canSort: false },
     disabled: { canFilter: true, canSort: true },
     storeStatus: { canFilter: true, canSort: false },
+    // AdminTeamView's permission-group filter emits `permissionGroup==X` and
+    // /api/admin/team merges it into `role==employee,permissionGroup==X`. Without
+    // this entry Sieve (throwExceptions:false) dropped the clause silently and the
+    // filter matched every employee. The composite indexes it needs are already
+    // declared and deployed — (permissionGroup, role, createdAt|displayName).
+    permissionGroup: { canFilter: true, canSort: false },
     createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
     updatedAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };

package/dist/features/cart/components/CartDrawer.d.ts

@@ -7,8 +7,16 @@ interface CartItemRowProps {
     href?: string;
     /** When true: grays out item, shows "Out of Stock" badge, locks qty stepper */
     isOutOfStock?: boolean;
+    /**
+     * `"card"` (default) — self-contained card with its own surface + padding,
+     * for the cart drawer where each line stands alone.
+     * `"row"` — bare row for the cart page, where the seller group is already the
+     * card. Nesting a card inside a card there produced the card-in-a-card look
+     * and gave the overflow nowhere to be clipped.
+     */
+    variant?: "card" | "row";
 }
-export declare function CartItemRow({ item, onQtyChange, onRemove, href, isOutOfStock }: CartItemRowProps): import("react").JSX.Element;
+export declare function CartItemRow({ item, onQtyChange, onRemove, href, isOutOfStock, variant }: CartItemRowProps): import("react").JSX.Element;
 interface CartDrawerProps {
     isOpen: boolean;
     onClose: () => void;

package/dist/features/cart/components/CartDrawer.js

@@ -13,11 +13,12 @@ const __O = {
     yAuto: "overflow-y-auto",
 };
 const CLS_REMOVE_BTN = "self-start text-[var(--appkit-color-text-faint)] transition hover:text-error";
-export function CartItemRow({ item, onQtyChange, onRemove, href, isOutOfStock = false }) {
-    return (_jsxs(Div, { layout: "flex", gap: "4", surface: "card", padding: "sm", className: `transition-opacity ${isOutOfStock ? "opacity-60" : ""}`, children: [_jsx(Div, { surface: "muted", className: `relative h-20 w-20 flex-shrink-0 ${__O.hidden}`, rounded: "lg", children: item.meta.image && (_jsx(MediaImage, { src: item.meta.image, alt: item.meta.title, size: "thumbnail" })) }), _jsxs(Stack, { justify: "between", className: "flex-1 min-w-0", children: [_jsxs(Row, { gap: "xs", className: "", align: "start", children: [href ? (_jsx(TextLink, { href: href, target: "_blank", rel: "noopener noreferrer", weight: "medium", className: "text-[var(--appkit-color-text)] hover:underline underline-offset-2 line-clamp-2", children: item.meta.title })) : (_jsx(Text, { truncate: 2, weight: "medium", color: "primary", children: item.meta.title })), isOutOfStock && (_jsx(Span, { padding: "pill-2xs", color: "error", surface: "danger-surface", weight: "semibold", className: "flex-shrink-0 text-[10px] tracking-wide", rounded: "default", transform: "uppercase", children: "Out of Stock" }))] }), item.meta.attributes &&
+export function CartItemRow({ item, onQtyChange, onRemove, href, isOutOfStock = false, variant = "card" }) {
+    const isRow = variant === "row";
+    return (_jsxs(Div, { layout: "flex", gap: isRow ? "3" : "4", surface: isRow ? "none" : "card", padding: isRow ? "none" : "sm", className: `min-w-0 transition-opacity ${isOutOfStock ? "opacity-60" : ""}`, children: [_jsx(Div, { surface: "muted", className: `relative ${isRow ? "h-16 w-16" : "h-20 w-20"} flex-shrink-0 ${__O.hidden}`, rounded: "lg", children: item.meta.image && (_jsx(MediaImage, { src: item.meta.image, alt: item.meta.title, size: "thumbnail" })) }), _jsxs(Stack, { justify: "between", className: "flex-1 min-w-0", children: [_jsxs(Row, { gap: "xs", className: "min-w-0", align: "start", children: [href ? (_jsx(TextLink, { href: href, target: "_blank", rel: "noopener noreferrer", weight: "medium", className: "text-[var(--appkit-color-text)] hover:underline underline-offset-2 line-clamp-2", children: item.meta.title })) : (_jsx(Text, { truncate: 2, weight: "medium", color: "primary", children: item.meta.title })), isOutOfStock && (_jsx(Span, { padding: "pill-2xs", color: "error", surface: "danger-surface", weight: "semibold", className: "flex-shrink-0 text-[10px] tracking-wide", rounded: "default", transform: "uppercase", children: "Out of Stock" }))] }), item.meta.attributes &&
                         Object.keys(item.meta.attributes).length > 0 && (_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "xs", truncate: 1, children: Object.entries(item.meta.attributes)
                             .map(([k, v]) => `${k}: ${v}`)
-                            .join(", ") })), _jsxs(Row, { justify: "between", children: [_jsx(Text, { className: "text-[var(--appkit-color-text)]", weight: "semibold", children: formatCurrency(item.meta.price * item.quantity, item.meta.currency) }), onQtyChange && !isOutOfStock && (_jsxs(Row, { gap: "sm", children: [_jsx(Button, { rounded: "full", onClick: () => onQtyChange(item.id, item.quantity - 1), disabled: item.quantity <= 1, variant: "outline", size: "sm", className: "h-7 w-7 justify-center border border-neutral-200 border-[var(--appkit-color-border)] text-[length:var(--appkit-text-sm)] disabled:opacity-40", children: "\u2212" }), _jsx(Span, { size: "sm", className: "min-w-[1.5rem]", align: "center", children: item.quantity }), _jsx(Button, { rounded: "full", onClick: () => onQtyChange(item.id, item.quantity + 1), variant: "outline", size: "sm", className: "h-7 w-7 justify-center border border-neutral-200 border-[var(--appkit-color-border)] text-[length:var(--appkit-text-sm)]", children: "+" })] })), isOutOfStock && (_jsxs(Span, { size: "xs", color: "muted", children: ["Qty: ", item.quantity] }))] })] }), onRemove && (_jsx(Button, { onClick: () => onRemove(item.id), variant: "ghost", size: "sm", "aria-label": ACTIONS.CART["remove-item"].ariaLabel, className: CLS_REMOVE_BTN, children: "\u2715" }))] }));
+                            .join(", ") })), _jsxs(Row, { justify: "between", className: "min-w-0", gap: "sm", children: [_jsx(Text, { className: "text-[var(--appkit-color-text)]", weight: "semibold", children: formatCurrency(item.meta.price * item.quantity, item.meta.currency) }), onQtyChange && !isOutOfStock && (_jsxs(Row, { gap: "sm", children: [_jsx(Button, { rounded: "full", onClick: () => onQtyChange(item.id, item.quantity - 1), disabled: item.quantity <= 1, variant: "outline", size: "sm", className: "h-7 w-7 justify-center border border-neutral-200 border-[var(--appkit-color-border)] text-[length:var(--appkit-text-sm)] disabled:opacity-40", children: "\u2212" }), _jsx(Span, { size: "sm", className: "min-w-[1.5rem]", align: "center", children: item.quantity }), _jsx(Button, { rounded: "full", onClick: () => onQtyChange(item.id, item.quantity + 1), variant: "outline", size: "sm", className: "h-7 w-7 justify-center border border-neutral-200 border-[var(--appkit-color-border)] text-[length:var(--appkit-text-sm)]", children: "+" })] })), isOutOfStock && (_jsxs(Span, { size: "xs", color: "muted", children: ["Qty: ", item.quantity] }))] })] }), onRemove && (_jsx(Button, { onClick: () => onRemove(item.id), variant: "ghost", size: "sm", "aria-label": ACTIONS.CART["remove-item"].ariaLabel, className: CLS_REMOVE_BTN, children: "\u2715" }))] }));
 }
 export function CartDrawer({ isOpen, onClose, items, subtotal = 0, currency, isLoading, onQtyChange, onRemove, onCheckout, labels = {}, }) {
     const { hand } = useHandMode();

package/dist/features/cart/components/CartPriceBreakdown.d.ts

@@ -0,0 +1,61 @@
+import React from "react";
+/**
+ * The aggregate price breakdown shown in the cart's expandable preview and in
+ * the checkout Order Summary.
+ *
+ * Deliberately flat: one line per fee type, with a `× N` qualifier on the fees
+ * that accumulate per store. The per-store detail lives on each seller card in
+ * the cart, where the store's items and its add-on checkboxes already are —
+ * repeating it here would make the panel a second, competing place to read the
+ * same numbers.
+ *
+ * Every figure comes from the server's pricing preview, which prices only the
+ * items actually selected for checkout. A deselected item contributes to no
+ * line, and a store with nothing selected forms no order group at all, so it
+ * contributes no shipping and no add-ons.
+ */
+/** Mirrors `CheckoutPricingPreviewStore` without importing server code. */
+export interface CartPriceBreakdownStore {
+    storeId: string;
+    storeName: string;
+    subtotal: number;
+    shippingFee: number;
+    codHandlingFee: number;
+    whatsappNotifyFee: number;
+    giftWrapFee: number;
+    shipmentProtectionFee: number;
+    gstAmount: number;
+    couponDiscount: number;
+    total: number;
+}
+/** Mirrors `CheckoutPricingPreview` without importing server code. */
+export interface CartPriceBreakdownData {
+    subtotal: number;
+    shippingFee: number;
+    codHandlingFee: number;
+    whatsappNotifyFee: number;
+    giftWrapFee: number;
+    shipmentProtectionFee: number;
+    gstAmount: number;
+    couponDiscount: number;
+    platformFee: number;
+    gstOnFee: number;
+    total: number;
+    stores: CartPriceBreakdownStore[];
+}
+export interface CartPriceBreakdownProps {
+    preview: CartPriceBreakdownData | null;
+    /** Number of items included — shown in the subtotal line so a deselection is visible. */
+    itemCount?: number;
+    currency?: string;
+    /**
+     * Shown instead of the fee lines when no server preview is available (a
+     * signed-out cart). The subtotal still renders from whatever is known.
+     */
+    unavailableNote?: React.ReactNode;
+    /** Subtotal to show when `preview` is null (guest carts). */
+    fallbackSubtotal?: number;
+    isLoading?: boolean;
+    className?: string;
+}
+export declare function CartPriceBreakdown({ preview, itemCount, currency, unavailableNote, fallbackSubtotal, isLoading, className, }: CartPriceBreakdownProps): React.JSX.Element;

package/dist/features/cart/components/CartPriceBreakdown.js

@@ -0,0 +1,25 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Div, Row, Stack, Text } from "../../../ui";
+import { formatCurrency } from "../../../utils/number.formatter";
+function Line({ label, amount, tone = "muted", strong = false, }) {
+    return (_jsxs(Row, { align: "center", justify: "between", gap: "sm", className: "min-w-0", children: [_jsx(Text, { size: "sm", color: tone, weight: strong ? "semibold" : undefined, className: "min-w-0", truncate: 1, children: label }), _jsx(Text, { size: "sm", color: tone, weight: strong ? "semibold" : undefined, className: "flex-shrink-0 tabular-nums", children: amount })] }));
+}
+/** "Shipping (2 stores)" — only qualifies when more than one store contributes. */
+function withStoreCount(label, count) {
+    return count > 1 ? `${label} (${count} stores)` : label;
+}
+export function CartPriceBreakdown({ preview, itemCount, currency = "INR", unavailableNote, fallbackSubtotal = 0, isLoading = false, className = "", }) {
+    const money = (value) => formatCurrency(value, currency);
+    if (!preview) {
+        return (_jsxs(Stack, { gap: "xs", className: className, children: [_jsx(Line, { label: itemCount !== undefined ? `Subtotal (${itemCount} item${itemCount !== 1 ? "s" : ""})` : "Subtotal", amount: money(fallbackSubtotal) }), unavailableNote && (_jsx(Text, { size: "xs", color: "muted", children: unavailableNote }))] }));
+    }
+    const storeCount = preview.stores.length;
+    // Count how many stores are actually charged each per-store add-on, so the
+    // "× N" reads as the real multiplier rather than the store count.
+    const countCharged = (pick) => preview.stores.filter((s) => pick(s) > 0).length;
+    const subtotalLabel = itemCount !== undefined
+        ? `Subtotal (${itemCount} item${itemCount !== 1 ? "s" : ""}${storeCount > 1 ? `, ${storeCount} stores` : ""})`
+        : "Subtotal";
+    return (_jsxs(Stack, { gap: "xs", className: className, children: [_jsx(Line, { label: subtotalLabel, amount: money(preview.subtotal) }), preview.shippingFee > 0 && (_jsx(Line, { label: withStoreCount("Shipping", storeCount), amount: money(preview.shippingFee) })), preview.codHandlingFee > 0 && (_jsx(Line, { label: "COD handling fee", amount: money(preview.codHandlingFee) })), preview.whatsappNotifyFee > 0 && (_jsx(Line, { label: withStoreCount("WhatsApp updates", countCharged((s) => s.whatsappNotifyFee)), amount: money(preview.whatsappNotifyFee) })), preview.giftWrapFee > 0 && (_jsx(Line, { label: withStoreCount("Gift wrap", countCharged((s) => s.giftWrapFee)), amount: money(preview.giftWrapFee) })), preview.shipmentProtectionFee > 0 && (_jsx(Line, { label: withStoreCount("Shipment protection", countCharged((s) => s.shipmentProtectionFee)), amount: money(preview.shipmentProtectionFee) })), preview.platformFee > 0 && _jsx(Line, { label: "Platform fee", amount: money(preview.platformFee) }), (preview.gstAmount > 0 || preview.gstOnFee > 0) && (_jsx(Line, { label: "GST", amount: money(preview.gstAmount + preview.gstOnFee) })), preview.couponDiscount > 0 && (_jsx(Line, { label: "Coupon discount", amount: `−${money(preview.couponDiscount)}`, tone: "success" })), _jsx(Div, { border: "top-subtle", paddingY: "t-sm", children: _jsx(Line, { label: "Total", amount: money(preview.total), tone: "primary", strong: true }) }), isLoading && (_jsx(Text, { size: "xs", color: "muted", children: "Updating\u2026" }))] }));
+}

package/dist/features/cart/components/StoreAddonsPicker.d.ts

@@ -0,0 +1,47 @@
+import React from "react";
+/**
+ * Paid add-on checkboxes for ONE store.
+ *
+ * Add-on fees are billed per order group (= per store), so they are chosen per
+ * store: ticking "WhatsApp updates" for one seller must not bill it for every
+ * seller in the cart. Rendered inside that store's card in the cart, and inside
+ * that store's row of the checkout summary — Buy Now skips the cart entirely,
+ * so both surfaces have to be able to edit them.
+ */
+export interface StoreAddonsValue {
+    whatsappNotifyAddon?: boolean;
+    giftWrapAddon?: boolean;
+    giftWrapMessage?: string;
+    shipmentProtectionAddon?: boolean;
+}
+/** The subset of `siteSettings.commissions` that gates and prices the add-ons. */
+export interface StoreAddonsRates {
+    whatsappNotifyFeeEnabled?: boolean;
+    whatsappNotifyFee?: number;
+    giftWrapFeeEnabled?: boolean;
+    giftWrapFee?: number;
+    shipmentProtectionFeeEnabled?: boolean;
+    shipmentProtectionFeePercent?: number;
+    shipmentProtectionFeeMin?: number;
+}
+export interface StoreAddonsPickerProps {
+    storeId: string;
+    /** This store's subtotal — shipment protection is a percentage of it. */
+    storeSubtotal: number;
+    value: StoreAddonsValue;
+    onChange: (storeId: string, next: StoreAddonsValue) => void;
+    rates: StoreAddonsRates | null;
+    /**
+     * When true the controls render disabled with `disabledReason`. Used in the
+     * cart when none of this store's items are selected — the fees genuinely
+     * aren't being charged, and silently hiding the controls would read as the
+     * add-ons having vanished.
+     */
+    disabled?: boolean;
+    disabledReason?: string;
+    /** Gift messages don't belong in a collapsed cart sheet — checkout only. */
+    showGiftMessage?: boolean;
+    currency?: string;
+    className?: string;
+}
+export declare function StoreAddonsPicker({ storeId, storeSubtotal, value, onChange, rates, disabled, disabledReason, showGiftMessage, currency, className, }: StoreAddonsPickerProps): React.JSX.Element | null;

package/dist/features/cart/components/StoreAddonsPicker.js

@@ -0,0 +1,21 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Gift, MessageCircle, ShieldCheck } from "lucide-react";
+import { Div, Row, Stack, Text } from "../../../ui";
+import { IconBox } from "../../../ui/components/IconBox";
+import { FieldCheckbox } from "../../../ui/forms/FieldCheckbox";
+import { FieldTextarea } from "../../../ui/forms/FieldTextarea";
+import { formatCurrency } from "../../../utils/number.formatter";
+export function StoreAddonsPicker({ storeId, storeSubtotal, value, onChange, rates, disabled = false, disabledReason, showGiftMessage = false, currency = "INR", className = "", }) {
+    const anyEnabled = !!rates &&
+        (rates.whatsappNotifyFeeEnabled ||
+            rates.giftWrapFeeEnabled ||
+            rates.shipmentProtectionFeeEnabled);
+    if (!anyEnabled)
+        return null;
+    const money = (value) => formatCurrency(value, currency);
+    const set = (patch) => onChange(storeId, { ...value, ...patch });
+    // Mirrors computeShipmentProtectionFee so the label states the real charge.
+    const protectionFee = Math.max(rates.shipmentProtectionFeeMin ?? 30, Math.round(storeSubtotal * ((rates.shipmentProtectionFeePercent ?? 2) / 100) * 100) / 100);
+    return (_jsxs(Stack, { gap: "xs", className: `min-w-0 ${className}`, children: [disabled && disabledReason && (_jsx(Text, { size: "xs", color: "muted", children: disabledReason })), rates.whatsappNotifyFeeEnabled && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(MessageCircle, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `whatsappNotifyAddon-${storeId}`, label: `WhatsApp order updates (+${money(rates.whatsappNotifyFee ?? 10)})`, checked: !!value.whatsappNotifyAddon, onChange: (checked) => set({ whatsappNotifyAddon: checked }), disabled: disabled }) })] })), rates.giftWrapFeeEnabled && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(Gift, { size: 14 }) }), _jsxs(Stack, { gap: "xs", className: "flex-1 min-w-0", children: [_jsx(FieldCheckbox, { name: `giftWrapAddon-${storeId}`, label: `Gift wrap (+${money(rates.giftWrapFee ?? 49)})`, checked: !!value.giftWrapAddon, onChange: (checked) => set({ giftWrapAddon: checked }), disabled: disabled }), showGiftMessage && value.giftWrapAddon && (_jsx(FieldTextarea, { name: `giftWrapMessage-${storeId}`, label: "Gift message (optional)", value: value.giftWrapMessage ?? "", onChange: (next) => set({ giftWrapMessage: next.slice(0, 500) }), rows: 2, maxLength: 500, showCharCount: true, placeholder: "Add a note for the recipient\u2026", disabled: disabled }))] })] })), rates.shipmentProtectionFeeEnabled && storeSubtotal > 0 && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(ShieldCheck, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `shipmentProtectionAddon-${storeId}`, label: `Shipment protection (+${money(protectionFee)})`, checked: !!value.shipmentProtectionAddon, onChange: (checked) => set({ shipmentProtectionAddon: checked }), disabled: disabled }) })] }))] }));
+}

package/dist/features/cart/components/index.d.ts

@@ -3,6 +3,10 @@ export { CartView } from "./CartView";
 export type { CartViewProps, CartOrderGroup } from "./CartView";
 export { CartSummary } from "./CartSummary";
 export type { CartSummaryProps } from "./CartSummary";
+export { StoreAddonsPicker } from "./StoreAddonsPicker";
+export type { StoreAddonsPickerProps, StoreAddonsValue, StoreAddonsRates, } from "./StoreAddonsPicker";
+export { CartPriceBreakdown } from "./CartPriceBreakdown";
+export type { CartPriceBreakdownProps, CartPriceBreakdownData, CartPriceBreakdownStore, } from "./CartPriceBreakdown";
 export { CheckoutView } from "./CheckoutView";
 export type { CheckoutViewProps } from "./CheckoutView";
 export { CheckoutAddressStep } from "./CheckoutAddressStep";

package/dist/features/cart/components/index.js

@@ -1,6 +1,8 @@
 export { CartItemRow, CartDrawer } from "./CartDrawer";
 export { CartView } from "./CartView";
 export { CartSummary } from "./CartSummary";
+export { StoreAddonsPicker } from "./StoreAddonsPicker";
+export { CartPriceBreakdown } from "./CartPriceBreakdown";
 export { CheckoutView } from "./CheckoutView";
 export { CheckoutAddressStep } from "./CheckoutAddressStep";
 export { CheckoutSuccessView } from "./CheckoutSuccessView";

package/dist/features/cart/repository/cart.repository.d.ts

@@ -1,7 +1,7 @@
-import type { DocumentReference } from "firebase-admin/firestore";
+import { type DocumentReference } from "firebase-admin/firestore";
 import type { DocumentSnapshot } from "../../../providers/db-firebase";
 import { BaseRepository, type FirebaseSieveResult, type SieveModel } from "../../../providers/db-firebase";
-import { type AddToCartInput, type CartAppliedCoupon, type CartDocument, type CartItemDocument, type UpdateCartItemInput } from "../schemas";
+import { type AddToCartInput, type CartAppliedCoupon, type CartDocument, type CartStoreAddons, type CartItemDocument, type UpdateCartItemInput } from "../schemas";
 export declare class CartRepository extends BaseRepository<CartDocument> {
     private static readonly SIEVE_FIELDS;
     constructor();
@@ -45,6 +45,24 @@ export declare class CartRepository extends BaseRepository<CartDocument> {
     updateItemShipping(userId: string, itemId: string, providerId: string, fee: number): Promise<CartDocument>;
     clearAllCoupons(userId: string): Promise<void>;
     setSelectedItems(userId: string, itemIds: string[] | null): Promise<void>;
+    /**
+     * Set (or clear) one store's add-on selections.
+     *
+     * Scoped to a single storeId so two stores' selections can't clobber each
+     * other, and written with a dotted field path so a concurrent write to a
+     * different store merges rather than overwriting the whole map.
+     *
+     * Passing an empty selection deletes the entry outright instead of leaving
+     * `{}` behind — an all-false record and an absent record mean the same thing,
+     * and keeping both shapes around invites readers that handle only one.
+     */
+    setStoreAddons(userId: string, storeId: string, addons: CartStoreAddons | null): Promise<void>;
+    /**
+     * Drop a store's add-on entry once its last item leaves the cart, so the map
+     * doesn't accumulate orphans. Cosmetic — an orphan is already unreachable,
+     * because a store with no items forms no order group.
+     */
+    pruneStoreAddons(userId: string, keepStoreIds: string[]): Promise<void>;
     /**
      * Cloud Functions: return refs of stale carts not updated within TTL.
      */

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

@@ -1,4 +1,5 @@
 import { randomUUID } from "crypto";
+import { FieldValue } from "firebase-admin/firestore";
 import { DatabaseError, NotFoundError, ValidationError } from "../../../errors";
 import { CART_FIELDS } from "../../../constants/field-names";
 import { normalizeError } from "../../../errors/normalize";
@@ -337,6 +338,54 @@ export class CartRepository extends BaseRepository {
             .doc(userId)
             .set({ selectedItemIds: itemIds ?? null, updatedAt: new Date() }, { merge: true });
     }
+    /**
+     * Set (or clear) one store's add-on selections.
+     *
+     * Scoped to a single storeId so two stores' selections can't clobber each
+     * other, and written with a dotted field path so a concurrent write to a
+     * different store merges rather than overwriting the whole map.
+     *
+     * Passing an empty selection deletes the entry outright instead of leaving
+     * `{}` behind — an all-false record and an absent record mean the same thing,
+     * and keeping both shapes around invites readers that handle only one.
+     */
+    async setStoreAddons(userId, storeId, addons) {
+        const isEmpty = !addons ||
+            (!addons.whatsappNotifyAddon &&
+                !addons.giftWrapAddon &&
+                !addons.shipmentProtectionAddon);
+        await this.db
+            .collection(this.collection)
+            .doc(userId)
+            .set({
+            storeAddons: {
+                [storeId]: isEmpty ? FieldValue.delete() : addons,
+            },
+            updatedAt: new Date(),
+        }, { merge: true });
+    }
+    /**
+     * Drop a store's add-on entry once its last item leaves the cart, so the map
+     * doesn't accumulate orphans. Cosmetic — an orphan is already unreachable,
+     * because a store with no items forms no order group.
+     */
+    async pruneStoreAddons(userId, keepStoreIds) {
+        const cart = await this.findByUserId(userId);
+        const existing = cart?.storeAddons;
+        if (!existing)
+            return;
+        const keep = new Set(keepStoreIds);
+        const stale = Object.keys(existing).filter((storeId) => !keep.has(storeId));
+        if (stale.length === 0)
+            return;
+        await this.db
+            .collection(this.collection)
+            .doc(userId)
+            .set({
+            storeAddons: Object.fromEntries(stale.map((storeId) => [storeId, FieldValue.delete()])),
+            updatedAt: new Date(),
+        }, { merge: true });
+    }
     /**
      * Cloud Functions: return refs of stale carts not updated within TTL.
      */

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

@@ -83,6 +83,21 @@ export interface CartAppliedCoupon {
     /** Item IDs (CartItemDocument.itemId) this coupon was calculated against */
     applicableItemIds?: string[];
 }
+/**
+ * Paid add-ons the buyer opted into, for ONE store.
+ *
+ * Add-on fees have always been billed per order group (= per store) by
+ * `createOrderForGroup` / `previewCheckoutPricing`, but the selection used to be
+ * a single cart-wide boolean — so one tick on "WhatsApp updates" quietly billed
+ * ₹10 × every store in the cart, with no way to opt in for just one seller.
+ * Keying the selection by storeId makes the choice match the billing.
+ */
+export interface CartStoreAddons {
+    whatsappNotifyAddon?: boolean;
+    giftWrapAddon?: boolean;
+    giftWrapMessage?: string;
+    shipmentProtectionAddon?: boolean;
+}
 export interface CartDocument extends BaseDocument {
     userId: string;
     items: CartItemDocument[];
@@ -90,6 +105,17 @@ export interface CartDocument extends BaseDocument {
     appliedCoupons?: CartAppliedCoupon[];
     /** Item IDs the user has selected for the next checkout (undefined = all items) */
     selectedItemIds?: string[];
+    /**
+     * Per-store add-on selections, keyed by `storeId` — the same key
+     * `splitCartIntoOrderGroups` groups on.
+     *
+     * This map is the source of truth for what gets charged; the checkout request
+     * no longer carries addon booleans. A store with no selected items forms no
+     * order group, so its entry is simply never read — that is what makes
+     * "only charge a store whose items are actually checking out" structural
+     * rather than a flag someone has to remember to check.
+     */
+    storeAddons?: Record<string, CartStoreAddons>;
 }
 export declare const CART_COLLECTION: "carts";
 export declare const CART_INDEXED_FIELDS: string[];