@mohasinac/appkit 2.6.2 → 2.6.4

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

@@ -1,10 +1,11 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState, useEffect } from "react";
-import { Article, Button, Div, Heading, Row, Span, Text } from "../../../ui";
+import { Article, BaseListingCard, Button, Div, Heading, Row, Span, Text } from "../../../ui";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { getDefaultCurrency } from "../../../core/baseline-resolver";
 import { THEME_CONSTANTS } from "../../../tokens";
+import { useLongPress } from "../../../react/hooks/useLongPress";
 function useCountdown(endsAt) {
     const [msLeft, setMsLeft] = useState(() => new Date(endsAt).getTime() - Date.now());
     useEffect(() => {
@@ -29,8 +30,9 @@ export function AuctionCountdown({ endsAt, className = "", labels = {}, }) {
     const pad = (n) => String(n).padStart(2, "0");
     return (_jsxs(Row, { className: `gap-1 text-sm font-mono ${className}`, children: [_jsx(Span, { className: "rounded bg-gray-900 dark:bg-slate-700 px-1.5 py-0.5 text-white", children: pad(countdown.h) }), _jsx(Span, { className: "text-gray-400 dark:text-zinc-500", children: ":" }), _jsx(Span, { className: "rounded bg-gray-900 dark:bg-slate-700 px-1.5 py-0.5 text-white", children: pad(countdown.m) }), _jsx(Span, { className: "text-gray-400 dark:text-zinc-500", children: ":" }), _jsx(Span, { className: "rounded bg-gray-900 dark:bg-slate-700 px-1.5 py-0.5 text-white", children: pad(countdown.s) })] }));
 }
-export function AuctionCard({ auction, labels = {}, onBid, className = "", }) {
+export function AuctionCard({ auction, labels = {}, onBid, className = "", selectable = false, isSelected = false, onSelect, }) {
     const hasEnded = new Date(auction.auctionEndDate) <= new Date();
     const displayBid = auction.currentBid ?? auction.startingBid;
-    return (_jsxs(Article, { className: `rounded-xl border border-gray-200 dark:border-slate-700 bg-white dark:bg-slate-900 overflow-hidden shadow-sm hover:shadow-md transition-shadow ${className}`, children: [auction.mainImage && (_jsxs(Div, { className: "aspect-square overflow-hidden relative", children: [_jsx(Div, { role: "img", "aria-label": auction.title, className: "h-full w-full bg-center bg-cover", style: { backgroundImage: `url(${auction.mainImage})` } }), _jsx(Span, { className: "absolute top-2 left-2 rounded-full bg-orange-500 px-2 py-0.5 text-xs font-bold text-white", children: "AUCTION" })] })), _jsxs(Div, { className: "p-4", children: [_jsx(Heading, { level: 3, className: `font-semibold text-gray-900 dark:text-zinc-100 text-sm leading-snug mb-2 ${THEME_CONSTANTS.utilities.textClamp2}`, children: auction.title }), _jsxs(Row, { justify: "between", className: "mb-2", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-xs text-gray-400 dark:text-zinc-500", children: labels.currentBid ?? "Current bid" }), _jsx(Text, { className: "text-base font-bold text-gray-900 dark:text-zinc-100", children: formatCurrency(displayBid, getDefaultCurrency()) })] }), _jsx(Div, { className: "text-right", children: _jsxs(Text, { className: "text-xs text-gray-400 dark:text-zinc-500", children: [auction.bidCount, " ", labels.bids ?? "bids"] }) })] }), _jsx(Div, { className: "mb-3", children: _jsx(AuctionCountdown, { endsAt: auction.auctionEndDate, labels: { ended: labels.ended } }) }), !hasEnded && onBid && (_jsx(Button, { type: "button", variant: "warning", onClick: () => onBid(auction), className: "w-full rounded-lg bg-orange-500 py-2 text-sm font-medium text-white hover:bg-orange-600 transition-colors", children: labels.placeBid ?? "Place Bid" }))] })] }));
+    const longPress = useLongPress(() => onSelect?.(auction.id, !isSelected));
+    return (_jsxs(Article, { className: `group relative rounded-xl border bg-white dark:bg-slate-900 overflow-hidden shadow-sm hover:shadow-md transition-shadow ${isSelected ? "border-primary outline outline-2 outline-primary" : "border-gray-200 dark:border-slate-700"} ${className}`, onMouseDown: onSelect && !isSelected ? longPress.onMouseDown : undefined, onMouseUp: onSelect && !isSelected ? longPress.onMouseUp : undefined, onMouseLeave: onSelect && !isSelected ? longPress.onMouseLeave : undefined, onTouchStart: onSelect && !isSelected ? longPress.onTouchStart : undefined, onTouchEnd: onSelect && !isSelected ? longPress.onTouchEnd : undefined, children: [onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: (e) => { e.preventDefault(); onSelect(auction.id, !isSelected); }, label: isSelected ? "Deselect auction" : "Select auction", position: "top-2 right-2", className: selectable || isSelected ? "opacity-100" : "opacity-0 group-hover:opacity-100 transition-opacity" })), auction.mainImage && (_jsxs(Div, { className: "aspect-square overflow-hidden relative", children: [_jsx(Div, { role: "img", "aria-label": auction.title, className: "h-full w-full bg-center bg-cover", style: { backgroundImage: `url(${auction.mainImage})` } }), _jsx(Span, { className: "absolute top-2 left-2 rounded-full bg-orange-500 px-2 py-0.5 text-xs font-bold text-white", children: "AUCTION" })] })), _jsxs(Div, { className: "p-4", children: [_jsx(Heading, { level: 3, className: `font-semibold text-gray-900 dark:text-zinc-100 text-sm leading-snug mb-2 ${THEME_CONSTANTS.utilities.textClamp2}`, children: auction.title }), _jsxs(Row, { justify: "between", className: "mb-2", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-xs text-gray-400 dark:text-zinc-500", children: labels.currentBid ?? "Current bid" }), _jsx(Text, { className: "text-base font-bold text-gray-900 dark:text-zinc-100", children: formatCurrency(displayBid, getDefaultCurrency()) })] }), _jsx(Div, { className: "text-right", children: _jsxs(Text, { className: "text-xs text-gray-400 dark:text-zinc-500", children: [auction.bidCount, " ", labels.bids ?? "bids"] }) })] }), _jsx(Div, { className: "mb-3", children: _jsx(AuctionCountdown, { endsAt: auction.auctionEndDate, labels: { ended: labels.ended } }) }), !hasEnded && onBid && (_jsx(Button, { type: "button", variant: "warning", onClick: () => onBid(auction), className: "w-full rounded-lg bg-orange-500 py-2 text-sm font-medium text-white hover:bg-orange-600 transition-colors", children: labels.placeBid ?? "Place Bid" }))] })] }));
 }

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

@@ -133,7 +133,7 @@ export async function AuctionDetailPageView({ id, initialAuction, onPlaceBid, pr
                                 bidderId: String(b.userId ?? b.bidderId ?? ""),
                                 bidderName: (b.bidderName ?? b.userName),
                                 amount: (typeof b.bidAmount === "number" ? b.bidAmount : typeof b.amount === "number" ? b.amount : 0),
-                                placedAt: (b.createdAt ?? b.bidAt ?? ""),
+                                placedAt: (b.bidDate ?? b.createdAt ?? b.bidAt ?? ""),
                             }));
                             return _jsx(CollapsibleBidHistory, { bids: bids, currency: currency });
                         }, renderRelated: () => {

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

@@ -11,8 +11,8 @@ export interface MarketplaceAuctionCardData {
         url?: string;
         thumbnailUrl?: string;
     };
-    /** Canonical discriminator (SB1-G Phase 4). */
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
+    /** Canonical discriminator (SB1-G Phase 4 · SB-UNI-F 2026-05-13 union extension). */
+    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
     auctionEndDate?: string | Date;
     startingBid?: number;
     currentBid?: number;

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

@@ -20,12 +20,22 @@ export function PlaceBidFormClient({ productId, currentBid, startingBid, minBidI
         setSuccess(false);
         startTransition(async () => {
             try {
-                await onPlaceBid({ productId, bidAmount: amount });
+                const result = await onPlaceBid({ productId, bidAmount: amount });
+                if (result &&
+                    typeof result === "object" &&
+                    "ok" in result &&
+                    result.ok === false) {
+                    const msg = result.error;
+                    setError(msg || "Failed to place bid. Please try again.");
+                    return;
+                }
                 setSuccess(true);
                 setBidAmount(String(amount + minBidIncrement));
             }
             catch (err) {
-                setError(err instanceof Error ? err.message : "Failed to place bid. Please try again.");
+                setError(err instanceof Error && err.message
+                    ? err.message
+                    : "Failed to place bid. Please try again.");
             }
         });
     }

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

@@ -65,8 +65,8 @@ export declare const auctionItemSchema: z.ZodObject<{
     status: "draft" | "published" | "archived" | "sold";
     title: string;
     price: number;
-    featured: boolean;
     listingType: "auction";
+    featured: boolean;
     slug: string;
     auctionEndDate: string;
     startingBid: number;
@@ -94,8 +94,8 @@ export declare const auctionItemSchema: z.ZodObject<{
     status: "draft" | "published" | "archived" | "sold";
     title: string;
     price: number;
-    featured: boolean;
     listingType: "auction";
+    featured: boolean;
     slug: string;
     auctionEndDate: string;
     startingBid: number;

package/dist/features/auth/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./types";
 export * from "./schemas";
+export * from "./role-predicates";
 export * from "./auth-helpers";
 export * from "./token-helpers";
 export * from "./hooks/useAuth";

package/dist/features/auth/index.js

@@ -1,5 +1,6 @@
 export * from "./types";
 export * from "./schemas";
+export * from "./role-predicates";
 export * from "./auth-helpers";
 export * from "./token-helpers";
 export * from "./hooks/useAuth";

package/dist/features/auth/role-predicates.d.ts

@@ -0,0 +1,16 @@
+import type { UserRole } from "./types";
+export declare const isAdminUser: (input?: {
+    role?: UserRole;
+}) => boolean;
+export declare const isSellerUser: (input?: {
+    role?: UserRole;
+}) => boolean;
+export declare const isModeratorUser: (input?: {
+    role?: UserRole;
+}) => boolean;
+export declare const isEmployeeUser: (input?: {
+    role?: UserRole;
+}) => boolean;
+export declare const isBuyerUser: (input?: {
+    role?: UserRole;
+}) => boolean;

package/dist/features/auth/role-predicates.js

@@ -0,0 +1,15 @@
+/**
+ * Canonical user-role predicates — mirror of the listing-type accessors in
+ * `features/products/utils/listing-type.ts`. Read the canonical role
+ * discriminator off an `AuthUser`/`UserDocument`-shaped object and return a
+ * boolean. Undefined input falls back to `"user"` so legacy payloads classify
+ * safely without a separate guard. SB-UNI-E 2026-05-13.
+ */
+function normalizeRole(input) {
+    return input?.role ?? "user";
+}
+export const isAdminUser = (input) => normalizeRole(input) === "admin";
+export const isSellerUser = (input) => normalizeRole(input) === "seller";
+export const isModeratorUser = (input) => normalizeRole(input) === "moderator";
+export const isEmployeeUser = (input) => normalizeRole(input) === "employee";
+export const isBuyerUser = (input) => normalizeRole(input) === "user";

package/dist/features/blog/components/BlogFeaturedCard.d.ts

@@ -7,5 +7,8 @@ export interface BlogFeaturedCardProps {
         readTime?: string;
     };
     className?: string;
+    selectable?: boolean;
+    isSelected?: boolean;
+    onSelect?: (id: string, selected: boolean) => void;
 }
-export declare function BlogFeaturedCard({ post, href, labels, className, }: BlogFeaturedCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function BlogFeaturedCard({ post, href, labels, className, selectable, isSelected, onSelect, }: BlogFeaturedCardProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,9 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Article, Div, Heading, Row, Span, Text, TextLink } from "../../../ui";
+import { Article, BaseListingCard, Div, Heading, Row, Span, Text, TextLink } from "../../../ui";
 import { THEME_CONSTANTS } from "../../../tokens";
 import { getMediaUrl } from "../../media/types/index";
 import { getDefaultLocale } from "../../../core/baseline-resolver";
 import { safeDisplayName } from "../../../security";
+import { useLongPress } from "../../../react/hooks/useLongPress";
 const CATEGORY_BADGE = {
     news: "bg-blue-100 text-blue-800 dark:bg-blue-900/40 dark:text-blue-300",
     tips: "bg-emerald-100 text-emerald-800 dark:bg-emerald-900/40 dark:text-emerald-300",
@@ -11,7 +12,8 @@ const CATEGORY_BADGE = {
     updates: "bg-purple-100 text-purple-800 dark:bg-purple-900/40 dark:text-purple-300",
     community: "bg-orange-100 text-orange-800 dark:bg-orange-900/40 dark:text-orange-300",
 };
-export function BlogFeaturedCard({ post, href, labels = {}, className = "", }) {
+export function BlogFeaturedCard({ post, href, labels = {}, className = "", selectable = false, isSelected = false, onSelect, }) {
+    const longPress = useLongPress(() => onSelect?.(post.id, !isSelected));
     const safeTitle = post.title?.trim() || "Untitled post";
     const coverImageUrl = getMediaUrl(post.coverImage);
     const date = post.publishedAt
@@ -21,5 +23,5 @@ export function BlogFeaturedCard({ post, href, labels = {}, className = "", }) {
             day: "numeric",
         })
         : "";
-    return (_jsx(TextLink, { href: href, className: "block h-full", children: _jsxs(Article, { className: `flex h-full flex-col overflow-hidden rounded-xl border border-neutral-200 dark:border-slate-700 bg-white dark:bg-slate-900 shadow-sm hover:shadow-md transition-shadow duration-200 ${className}`, children: [_jsx(Div, { className: "aspect-video overflow-hidden flex-shrink-0", children: coverImageUrl ? (_jsx(Div, { role: "img", "aria-label": safeTitle, className: "h-full w-full bg-cover bg-center transition-transform duration-300 group-hover:scale-105", style: { backgroundImage: `url(${coverImageUrl})` } })) : (_jsx(Div, { role: "img", "aria-label": safeTitle, className: "h-full w-full bg-gradient-to-br from-zinc-200 via-zinc-100 to-zinc-300 dark:from-slate-800 dark:via-slate-700 dark:to-slate-900" })) }), _jsxs(Div, { className: "flex flex-1 flex-col p-4", children: [_jsxs(Row, { className: "gap-1.5 mb-2 flex-wrap", children: [_jsx(Span, { className: `inline-block px-2 py-0.5 rounded-full text-xs font-medium capitalize ${CATEGORY_BADGE[post.category] ?? "bg-zinc-100 text-zinc-700"}`, children: post.category }), post.isFeatured && (_jsx(Span, { className: "bg-yellow-100 text-yellow-800 dark:bg-yellow-900/40 dark:text-yellow-300 px-2 py-0.5 rounded-full text-xs font-medium", children: labels.featuredBadge ?? "Featured" }))] }), _jsx(Heading, { level: 3, className: `font-semibold text-neutral-900 dark:text-zinc-100 text-base leading-snug mb-1 ${THEME_CONSTANTS.utilities.textClamp2}`, children: safeTitle }), post.excerpt && (_jsx(Text, { className: `text-neutral-500 dark:text-zinc-400 text-sm ${THEME_CONSTANTS.utilities.textClamp2} mb-3`, children: post.excerpt })), _jsxs(Row, { className: "mt-auto gap-3 text-xs text-neutral-400 dark:text-zinc-500 flex-wrap", children: [post.authorName && (_jsx(Span, { children: safeDisplayName(post.authorName, "Author") })), post.readTimeMinutes != null && (_jsxs(Span, { children: [post.readTimeMinutes, " ", labels.readTime ?? "min read"] })), date && _jsx(Span, { children: date })] })] })] }) }));
+    return (_jsxs(Article, { className: `group relative flex h-full flex-col overflow-hidden rounded-xl border border-neutral-200 dark:border-slate-700 bg-white dark:bg-slate-900 shadow-sm hover:shadow-md transition-shadow duration-200 ${isSelected ? "ring-2 ring-primary outline outline-2 outline-primary" : ""} ${className}`, onMouseDown: onSelect && !isSelected ? longPress.onMouseDown : undefined, onMouseUp: onSelect && !isSelected ? longPress.onMouseUp : undefined, onMouseLeave: onSelect && !isSelected ? longPress.onMouseLeave : undefined, onTouchStart: onSelect && !isSelected ? longPress.onTouchStart : undefined, onTouchEnd: onSelect && !isSelected ? longPress.onTouchEnd : undefined, children: [onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: (e) => { e.preventDefault(); onSelect(post.id, !isSelected); }, label: isSelected ? "Deselect post" : "Select post", position: "top-2 left-2", className: selectable || isSelected ? "opacity-100" : "opacity-0 group-hover:opacity-100 transition-opacity" })), _jsxs(TextLink, { href: href, className: "flex h-full flex-col", children: [_jsx(Div, { className: "aspect-video overflow-hidden flex-shrink-0", children: coverImageUrl ? (_jsx(Div, { role: "img", "aria-label": safeTitle, className: "h-full w-full bg-cover bg-center transition-transform duration-300 group-hover:scale-105", style: { backgroundImage: `url(${coverImageUrl})` } })) : (_jsx(Div, { role: "img", "aria-label": safeTitle, className: "h-full w-full bg-gradient-to-br from-zinc-200 via-zinc-100 to-zinc-300 dark:from-slate-800 dark:via-slate-700 dark:to-slate-900" })) }), _jsxs(Div, { className: "flex flex-1 flex-col p-4", children: [_jsxs(Row, { className: "gap-1.5 mb-2 flex-wrap", children: [_jsx(Span, { className: `inline-block px-2 py-0.5 rounded-full text-xs font-medium capitalize ${CATEGORY_BADGE[post.category] ?? "bg-zinc-100 text-zinc-700"}`, children: post.category }), post.isFeatured && (_jsx(Span, { className: "bg-yellow-100 text-yellow-800 dark:bg-yellow-900/40 dark:text-yellow-300 px-2 py-0.5 rounded-full text-xs font-medium", children: labels.featuredBadge ?? "Featured" }))] }), _jsx(Heading, { level: 3, className: `font-semibold text-neutral-900 dark:text-zinc-100 text-base leading-snug mb-1 ${THEME_CONSTANTS.utilities.textClamp2}`, children: safeTitle }), post.excerpt && (_jsx(Text, { className: `text-neutral-500 dark:text-zinc-400 text-sm ${THEME_CONSTANTS.utilities.textClamp2} mb-3`, children: post.excerpt })), _jsxs(Row, { className: "mt-auto gap-3 text-xs text-neutral-400 dark:text-zinc-500 flex-wrap", children: [post.authorName && (_jsx(Span, { children: safeDisplayName(post.authorName, "Author") })), post.readTimeMinutes != null && (_jsxs(Span, { children: [post.readTimeMinutes, " ", labels.readTime ?? "min read"] })), date && _jsx(Span, { children: date })] })] })] })] }));
 }

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

@@ -14,3 +14,4 @@ export declare function mergeGuestCart(userId: string, items: Array<{
     quantity: number;
 }>): Promise<void>;
 export declare function getCart(userId: string): Promise<CartDocument | null>;
+export declare function updateCartItemShipping(userId: string, itemId: string, providerId: string, feeInPaise: number): Promise<CartDocument>;

package/dist/features/cart/actions/cart-actions.js

@@ -5,12 +5,20 @@
  * are handled by the calling server action in the consumer.
  */
 import { serverLogger } from "../../../monitoring";
+import { ValidationError } from "../../../errors";
 import { cartRepository } from "../repository/cart.repository";
 import { productRepository } from "../../products/repository/products.repository";
 import { normalizeListingType } from "../../products/utils/listing-type";
 import { getDefaultCurrency } from "../../../core/baseline-resolver";
 export async function addItemToCart(userId, input) {
     serverLogger.debug("addItemToCart", { userId, productId: input.productId });
+    // SB-UNI-F 2026-05-13 — capability gate. Classified + live listings reject
+    // add-to-cart at the action layer. UI surfaces a chat-only / jurisdiction
+    // CTA for those types instead.
+    const { canAddToCart } = await import("../../../_internal/shared/listing-types/capabilities");
+    if (!canAddToCart(input.listingType)) {
+        throw new ValidationError(`Listings of type "${input.listingType}" cannot be added to the cart.`);
+    }
     return cartRepository.addItem(userId, input);
 }
 export async function updateCartItem(userId, itemId, input) {
@@ -51,3 +59,11 @@ export async function mergeGuestCart(userId, items) {
 export async function getCart(userId) {
     return cartRepository.findByUserId(userId);
 }
+export async function updateCartItemShipping(userId, itemId, providerId, feeInPaise) {
+    if (!itemId || !providerId)
+        throw new ValidationError("itemId and providerId are required");
+    if (!Number.isFinite(feeInPaise) || feeInPaise < 0) {
+        throw new ValidationError("feeInPaise must be a non-negative number");
+    }
+    return cartRepository.updateItemShipping(userId, itemId, providerId, feeInPaise);
+}

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

@@ -1,4 +1,15 @@
 import React from "react";
+/** Minimal shape of a per-store/per-type order group surfaced to the slot. */
+export interface CartOrderGroup {
+    /** Unique key for this group (e.g. `${storeId}:${orderType}`). */
+    key: string;
+    storeId: string;
+    storeName: string;
+    orderType: string;
+    items: unknown[];
+    subtotalInPaise: number;
+    shippingFeeInPaise: number;
+}
 export interface CartViewProps {
     labels?: {
         title?: string;
@@ -6,6 +17,13 @@ export interface CartViewProps {
         checkoutButton?: string;
     };
     renderItems: (isLoading: boolean) => React.ReactNode;
+    /**
+     * When provided, replaces `renderItems` + `renderPromoCode` with a
+     * per-group tabbed breakdown. Each group shows its own subtotal + shipping.
+     */
+    renderGroups?: (groups: CartOrderGroup[], isLoading: boolean) => React.ReactNode;
+    /** Computed groups passed to `renderGroups`. Ignored when `renderGroups` is absent. */
+    groups?: CartOrderGroup[];
     renderSummary?: () => React.ReactNode;
     renderPromoCode?: () => React.ReactNode;
     renderCheckoutButton?: (onCheckout: () => void, isLoading: boolean) => React.ReactNode;
@@ -14,4 +32,4 @@ export interface CartViewProps {
     isLoading?: boolean;
     className?: string;
 }
-export declare function CartView({ labels, renderItems, renderSummary, renderPromoCode, renderCheckoutButton, renderEmpty, isEmpty, isLoading, className, }: CartViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function CartView({ labels, renderItems, renderGroups, groups, renderSummary, renderPromoCode, renderCheckoutButton, renderEmpty, isEmpty, isLoading, className, }: CartViewProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,7 +1,7 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Div, Heading } from "../../../ui";
-export function CartView({ labels = {}, renderItems, renderSummary, renderPromoCode, renderCheckoutButton, renderEmpty, isEmpty = false, isLoading = false, className = "", }) {
+export function CartView({ labels = {}, renderItems, renderGroups, groups = [], renderSummary, renderPromoCode, renderCheckoutButton, renderEmpty, isEmpty = false, isLoading = false, className = "", }) {
     if (isEmpty && renderEmpty)
         return _jsx(_Fragment, { children: renderEmpty() });
-    return (_jsxs(Div, { className: className, children: [labels.title && (_jsx(Heading, { level: 1, className: "text-2xl font-bold mb-6", children: labels.title })), _jsxs(Div, { className: "flex flex-col gap-6 lg:flex-row lg:gap-8", children: [_jsxs(Div, { className: "flex-1", children: [renderItems(isLoading), renderPromoCode?.()] }), _jsxs(Div, { className: "w-full lg:w-80", children: [renderSummary?.(), renderCheckoutButton?.(() => { }, isLoading)] })] })] }));
+    return (_jsxs(Div, { className: className, children: [labels.title && (_jsx(Heading, { level: 1, className: "text-2xl font-bold mb-6", children: labels.title })), _jsxs(Div, { className: "flex flex-col gap-6 lg:flex-row lg:gap-8", children: [_jsxs(Div, { className: "flex-1", children: [renderGroups ? renderGroups(groups, isLoading) : renderItems(isLoading), !renderGroups && renderPromoCode?.(), renderGroups && renderPromoCode?.()] }), _jsxs(Div, { className: "w-full lg:w-80", children: [renderSummary?.(), renderCheckoutButton?.(() => { }, isLoading)] })] })] }));
 }

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

@@ -0,0 +1,13 @@
+import type { ShippingProviderConfig } from "../../stores/schemas/firestore";
+export interface ShippingPickerProps {
+    providers: ShippingProviderConfig[];
+    /** Currently persisted provider id (from CartItemDocument.chosenShippingProviderId). */
+    selectedProviderId?: string;
+    /** Order subtotal in paise — used to evaluate freeAboveInPaise + percentOfOrder rules. */
+    subtotalInPaise?: number;
+    /** Called when the buyer picks (or changes) a provider. */
+    onPickProvider: (providerId: string, feeInPaise: number) => void | Promise<void>;
+    isLoading?: boolean;
+    className?: string;
+}
+export declare function ShippingPicker({ providers, selectedProviderId, subtotalInPaise, onPickProvider, isLoading, className, }: ShippingPickerProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,48 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ShippingPicker — buyer-facing shipping provider selector.
+ *
+ * Renders the store's configured shipping providers as a radio list.
+ * The selected provider's id + calculated fee are surfaced via the
+ * `onPickProvider` callback so the parent can persist them to the cart item.
+ */
+import { useState } from "react";
+import { Button, Div, Row, Stack, Text } from "../../../ui";
+import { formatCurrency } from "../../../utils/number.formatter";
+import { REFUND_COPY } from "../../../_internal/shared/features/orders/refund-copy";
+/** Resolve the effective flat fee for a provider given the current subtotal. */
+function resolveProviderFee(p, subtotalInPaise) {
+    const { fee } = p;
+    if (fee.freeAboveInPaise !== undefined && subtotalInPaise >= fee.freeAboveInPaise)
+        return 0;
+    let total = fee.flatInPaise ?? 0;
+    if (fee.percentOfOrder !== undefined) {
+        total += Math.round((fee.percentOfOrder / 100) * subtotalInPaise);
+    }
+    if (fee.minInPaise !== undefined)
+        total = Math.max(total, fee.minInPaise);
+    return total;
+}
+export function ShippingPicker({ providers, selectedProviderId, subtotalInPaise = 0, onPickProvider, isLoading = false, className = "", }) {
+    const [pending, setPending] = useState(false);
+    if (providers.length === 0) {
+        return (_jsx(Text, { size: "sm", color: "muted", className: className, children: REFUND_COPY.shipping.noOptions }));
+    }
+    const handleSelect = async (p) => {
+        const fee = resolveProviderFee(p, subtotalInPaise);
+        setPending(true);
+        try {
+            await onPickProvider(p.providerId, fee);
+        }
+        finally {
+            setPending(false);
+        }
+    };
+    return (_jsx(Stack, { gap: "xs", className: className, role: "radiogroup", "aria-label": "Shipping options", children: providers.map((p) => {
+            const fee = resolveProviderFee(p, subtotalInPaise);
+            const selected = p.providerId === selectedProviderId;
+            const disabled = isLoading || pending;
+            return (_jsx(Button, { type: "button", variant: selected ? "primary" : "outline", size: "sm", disabled: disabled, onClick: () => handleSelect(p), "aria-checked": selected, role: "radio", className: "w-full justify-start text-left", children: _jsxs(Row, { gap: "sm", className: "w-full flex-wrap", align: "center", children: [_jsxs(Div, { className: "flex-1", children: [_jsx(Text, { size: "sm", weight: selected ? "semibold" : "normal", children: p.label }), _jsx(Text, { size: "xs", color: "muted", children: REFUND_COPY.shipping.etaFormat(p.etaDaysMin, p.etaDaysMax) })] }), _jsx(Text, { size: "sm", weight: "semibold", children: fee === 0 ? REFUND_COPY.shipping.freeLabel : formatCurrency(fee / 100, "INR") })] }) }, p.providerId));
+        }) }));
+}

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

@@ -1,6 +1,6 @@
 export { CartItemRow, CartDrawer } from "./CartDrawer";
 export { CartView } from "./CartView";
-export type { CartViewProps } from "./CartView";
+export type { CartViewProps, CartOrderGroup } from "./CartView";
 export { CartSummary } from "./CartSummary";
 export type { CartSummaryProps } from "./CartSummary";
 export { CheckoutView } from "./CheckoutView";
@@ -11,3 +11,5 @@ export { CheckoutOtpModal } from "./CheckoutOtpModal";
 export type { CheckoutOtpModalProps } from "./CheckoutOtpModal";
 export { CheckoutSuccessView } from "./CheckoutSuccessView";
 export type { CheckoutSuccessViewProps } from "./CheckoutSuccessView";
+export { ShippingPicker } from "./ShippingPicker";
+export type { ShippingPickerProps } from "./ShippingPicker";

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

@@ -5,3 +5,4 @@ export { CheckoutView } from "./CheckoutView";
 export { CheckoutAddressStep } from "./CheckoutAddressStep";
 export { CheckoutOtpModal } from "./CheckoutOtpModal";
 export { CheckoutSuccessView } from "./CheckoutSuccessView";
+export { ShippingPicker } from "./ShippingPicker";

package/dist/features/cart/hooks/useCartCount.js

@@ -16,5 +16,11 @@ export function useCartCount(enabled = false) {
         queryFn: () => apiClient.get(CART_ENDPOINTS.GET),
         enabled,
     });
-    return data?.itemCount ?? guestCount;
+    // When authenticated, the server is authoritative — never mix in the guest
+    // count, otherwise stale localStorage entries leak into the badge after
+    // login (the cart-merge clears the local store but `useGuestCart`'s React
+    // state holds the pre-clear snapshot until remount).
+    if (enabled)
+        return data?.itemCount ?? 0;
+    return guestCount;
 }

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

@@ -16,6 +16,7 @@ export declare class CartRepository extends BaseRepository<CartDocument> {
     getSubtotal(cart: CartDocument): number;
     addCoupon(userId: string, coupon: CartAppliedCoupon): Promise<void>;
     removeCoupon(userId: string, code: string): Promise<void>;
+    updateItemShipping(userId: string, itemId: string, providerId: string, feeInPaise: number): Promise<CartDocument>;
     clearAllCoupons(userId: string): Promise<void>;
     setSelectedItems(userId: string, itemIds: string[] | null): Promise<void>;
     /**

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

@@ -84,6 +84,13 @@ export class CartRepository extends BaseRepository {
                     ...(input.lockedPrice !== undefined && {
                         lockedPrice: input.lockedPrice,
                     }),
+                    // SB-UNI-4 2026-05-13 — propagate bundle identifiers when present.
+                    ...(input.bundleCategorySlug !== undefined && {
+                        bundleCategorySlug: input.bundleCategorySlug,
+                    }),
+                    ...(input.bundleProductIds !== undefined && {
+                        bundleProductIds: input.bundleProductIds,
+                    }),
                     addedAt: new Date(),
                     updatedAt: new Date(),
                 };
@@ -209,6 +216,34 @@ export class CartRepository extends BaseRepository {
             .doc(userId)
             .set({ appliedCoupons: updated, updatedAt: new Date() }, { merge: true });
     }
+    async updateItemShipping(userId, itemId, providerId, feeInPaise) {
+        try {
+            const cart = await this.findByUserId(userId);
+            if (!cart)
+                throw new NotFoundError("Cart not found");
+            const itemIndex = cart.items.findIndex((item) => item.itemId === itemId);
+            if (itemIndex < 0)
+                throw new NotFoundError("Cart item not found");
+            const items = [...cart.items];
+            items[itemIndex] = {
+                ...items[itemIndex],
+                chosenShippingProviderId: providerId,
+                chosenShippingFeeInPaise: feeInPaise,
+                updatedAt: new Date(),
+            };
+            const updatedCart = { ...cart, items, updatedAt: new Date() };
+            await this.db
+                .collection(this.collection)
+                .doc(userId)
+                .set(prepareForFirestore(updatedCart));
+            return updatedCart;
+        }
+        catch (error) {
+            if (error instanceof DatabaseError || error instanceof NotFoundError)
+                throw error;
+            throw new DatabaseError("Failed to update cart item shipping", error);
+        }
+    }
     async clearAllCoupons(userId) {
         await this.db
             .collection(this.collection)

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

@@ -21,12 +21,33 @@ export interface CartItemDocument {
      * carts) and cart-side UI badges. Replaces the legacy `isAuction`/`isPreOrder`
      * pair on the cart item.
      */
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw";
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
     /** True when item was added from an accepted Make-an-Offer */
     isOffer?: boolean;
     offerId?: string;
     /** Locked offer price — overrides normal product price at checkout */
     lockedPrice?: number;
+    /**
+     * SB-UNI-4 2026-05-13 — bundle identifier when this cart line represents a
+     * bundle (categoryType:"bundle" row on the categories collection). When set,
+     * `productId` points at the bundle category's id, `price` is the locked
+     * bundlePriceInPaise, and `bundleProductIds` snapshots the member product
+     * ids at add-to-cart time. Order-side fan-out into per-product OrderItem
+     * entries lands in S-SBUNI-5 (checkout-side stock decrement + per-store
+     * grouping); until then the foundation is here but BundleDetailView keeps
+     * the "Add to cart coming soon" notice up.
+     */
+    bundleCategorySlug?: string;
+    /** Snapshot of `bundle.bundleProductIds` at add-to-cart time. */
+    bundleProductIds?: string[];
+    /**
+     * S-SBUNI-RULES 2026-05-13 — buyer's chosen shipping provider for this
+     * item, snapshotted at cart time. Locked at checkout; the per-tab
+     * ShippingPicker writes this when the buyer selects a provider.
+     */
+    chosenShippingProviderId?: string;
+    /** Fee in paise for the chosen provider, snapshotted at cart time. */
+    chosenShippingFeeInPaise?: number;
     addedAt: Date;
     updatedAt: Date;
 }
@@ -89,10 +110,14 @@ export type AddToCartInput = {
     /** Store slug (= storeId = store.id) */
     storeId: string;
     storeName: string;
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw";
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
     isOffer?: boolean;
     offerId?: string;
     lockedPrice?: number;
+    /** SB-UNI-4 2026-05-13 — bundle identifier when the line is a bundle. */
+    bundleCategorySlug?: string;
+    /** Snapshot of bundle members at add-to-cart time. */
+    bundleProductIds?: string[];
 };
 export type UpdateCartItemInput = {
     quantity: number;

package/dist/features/categories/components/BundleAddToCartCta.d.ts

@@ -0,0 +1,16 @@
+export interface BundleAddToCartCtaProps {
+    /** Bundle slug — `categories/{bundle-...}` row. */
+    bundleSlug: string;
+    /** True when bundleStockStatus === "out_of_stock". Renders disabled CTA. */
+    outOfStock?: boolean;
+    /**
+     * Server-action callback. Returning successfully marks the toast as success;
+     * any thrown error surfaces inline + as an error toast. Typed as a generic
+     * async fn so consumers can wrap the underlying action however they like.
+     */
+    onAddToCart: (input: {
+        bundleSlug: string;
+        quantity: number;
+    }) => Promise<unknown>;
+}
+export declare function BundleAddToCartCta({ bundleSlug, outOfStock, onAddToCart, }: BundleAddToCartCtaProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,54 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * BundleAddToCartCta — S-SBUNI-5 2026-05-13.
+ *
+ * Client island for the bundle detail page CTA. Replaces the "coming soon"
+ * disabled-CTA notice from S-SBUNI-3 + S-SBUNI-4 now that the cart-line
+ * foundation + per-member stock decrement at checkout are wired.
+ *
+ * Receives the bundle slug + an `onAddToCart` callback (typically the
+ * `addBundleToCartAction` server action from the consumer app). Renders
+ * a qty input + Add button + inline error / toast feedback.
+ *
+ * Out-of-stock bundles render a disabled button with `ctaOutOfStock` text.
+ */
+import { useState, useCallback } from "react";
+import { Button, Input, Row, Stack, Text } from "../../../ui";
+import { useToast } from "../../../ui";
+import { BUNDLE_COPY } from "../../../_internal/shared/features/categories/bundle-copy";
+const MIN_QTY = 1;
+const MAX_QTY = 10;
+export function BundleAddToCartCta({ bundleSlug, outOfStock = false, onAddToCart, }) {
+    const { showToast } = useToast();
+    const [quantity, setQuantity] = useState(MIN_QTY);
+    const [submitting, setSubmitting] = useState(false);
+    const [error, setError] = useState(null);
+    const handleClick = useCallback(async () => {
+        setError(null);
+        setSubmitting(true);
+        try {
+            await onAddToCart({ bundleSlug, quantity });
+            showToast(BUNDLE_COPY.detail.ctaSuccess, "success");
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : BUNDLE_COPY.detail.ctaErrorFallback;
+            setError(message);
+            showToast(message, "error");
+        }
+        finally {
+            setSubmitting(false);
+        }
+    }, [bundleSlug, quantity, onAddToCart, showToast]);
+    if (outOfStock) {
+        return (_jsxs(Stack, { gap: "xs", "aria-live": "polite", children: [_jsx(Button, { variant: "primary", disabled: true, "aria-disabled": true, children: BUNDLE_COPY.detail.ctaOutOfStock }), _jsx(Text, { size: "xs", color: "muted", children: BUNDLE_COPY.detail.ctaHint })] }));
+    }
+    return (_jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { gap: "sm", align: "center", className: "flex-wrap", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", color: "muted", children: BUNDLE_COPY.detail.qtyLabel }), _jsx(Input, { type: "number", inputMode: "numeric", min: MIN_QTY, max: MAX_QTY, step: 1, value: String(quantity), "aria-label": BUNDLE_COPY.detail.qtyAriaLabel, onChange: (e) => {
+                                    const next = Number(e.target.value);
+                                    if (Number.isFinite(next)) {
+                                        setQuantity(Math.min(Math.max(MIN_QTY, Math.floor(next)), MAX_QTY));
+                                    }
+                                }, disabled: submitting, className: "w-20" })] }), _jsx(Button, { variant: "primary", onClick: handleClick, disabled: submitting, "aria-busy": submitting, children: submitting
+                            ? BUNDLE_COPY.detail.ctaAdding
+                            : BUNDLE_COPY.detail.ctaAddToCart })] }), error && (_jsx(Text, { size: "sm", color: "danger", role: "alert", children: error }))] }));
+}

package/dist/features/categories/components/BundleBuyNowCta.d.ts

@@ -0,0 +1,8 @@
+export interface BundleBuyNowCtaProps {
+    bundleSlug: string;
+    outOfStock?: boolean;
+    onBuyNow: (input: {
+        bundleSlug: string;
+    }) => Promise<unknown>;
+}
+export declare function BundleBuyNowCta({ bundleSlug, outOfStock, onBuyNow, }: BundleBuyNowCtaProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,37 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * BundleBuyNowCta — direct-checkout CTA for bundle detail pages.
+ *
+ * Replaces BundleAddToCartCta (deleted). Bundles bypass the cart and go
+ * straight to checkout via the `directBundleCheckoutAction` server action.
+ * No qty input — bundles are always qty=1 per checkout.
+ */
+import { useState, useCallback } from "react";
+import { Button, Stack, Text } from "../../../ui";
+import { useToast } from "../../../ui";
+import { BUNDLE_COPY } from "../../../_internal/shared/features/categories/bundle-copy";
+export function BundleBuyNowCta({ bundleSlug, outOfStock = false, onBuyNow, }) {
+    const { showToast } = useToast();
+    const [submitting, setSubmitting] = useState(false);
+    const [error, setError] = useState(null);
+    const handleClick = useCallback(async () => {
+        setError(null);
+        setSubmitting(true);
+        try {
+            await onBuyNow({ bundleSlug });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : BUNDLE_COPY.detail.ctaErrorFallback;
+            setError(message);
+            showToast(message, "error");
+        }
+        finally {
+            setSubmitting(false);
+        }
+    }, [bundleSlug, onBuyNow, showToast]);
+    if (outOfStock) {
+        return (_jsxs(Stack, { gap: "xs", "aria-live": "polite", children: [_jsx(Button, { variant: "primary", disabled: true, "aria-disabled": true, children: BUNDLE_COPY.detail.ctaOutOfStock }), _jsx(Text, { size: "xs", color: "muted", children: BUNDLE_COPY.detail.ctaHint })] }));
+    }
+    return (_jsxs(Stack, { gap: "sm", children: [_jsx(Button, { variant: "primary", onClick: handleClick, disabled: submitting, "aria-busy": submitting, children: submitting ? BUNDLE_COPY.detail.ctaAdding : BUNDLE_COPY.detail.ctaBuyNow }), error && (_jsx(Text, { size: "sm", color: "danger", role: "alert", children: error }))] }));
+}