@mohasinac/appkit 2.6.3 → 2.6.5

package/dist/features/admin/constants/filter-tabs.js

@@ -0,0 +1,216 @@
+/**
+ * Admin filter-chip tab sets (SB10-C completion, S8 2026-05-13).
+ *
+ * Match current view-filter values exactly so migrating an inline
+ * `STATUS_OPTIONS` array to one of these constants is a behaviour-preserving
+ * rename. The `ALL_TAB` sentinel collapses to an empty filter string when
+ * clicked.
+ *
+ * Each entry is a typed `{ id, label }` row so views render with one
+ * primitive and stay in sync when statuses are added.
+ */
+export const ALL_TAB = { id: "All", label: "All" };
+/** Admin > Products — listing status filter chip set. */
+export const ADMIN_PRODUCT_STATUS_TABS = [
+    ALL_TAB,
+    { id: "pending", label: "Pending" },
+    { id: "published", label: "Published" },
+    { id: "draft", label: "Draft" },
+    { id: "archived", label: "Archived" },
+];
+/** Admin > Products — listing-type filter chip set. Legacy label-as-id IDs
+ *  preserved so the existing Sieve filter values keep matching. */
+export const ADMIN_PRODUCT_LISTING_TYPE_TABS = [
+    ALL_TAB,
+    { id: "Products", label: "Products" },
+    { id: "Auctions", label: "Auctions" },
+    { id: "Pre-orders", label: "Pre-orders" },
+    { id: "Prize Draws", label: "Prize Draws" },
+];
+/** Admin > Blog — post status filter chip set. */
+export const ADMIN_BLOG_STATUS_TABS = [
+    ALL_TAB,
+    { id: "published", label: "Published" },
+    { id: "draft", label: "Draft" },
+    { id: "archived", label: "Archived" },
+];
+/** Admin > Users — account-state filter chip set. */
+export const ADMIN_USER_STATUS_TABS = [
+    ALL_TAB,
+    { id: "Active", label: "Active" },
+    { id: "Disabled", label: "Disabled" },
+];
+/** Admin > Users — role filter chip set. */
+export const ADMIN_USER_ROLE_TABS = [
+    ALL_TAB,
+    { id: "admin", label: "Admin" },
+    { id: "seller", label: "Seller" },
+    { id: "buyer", label: "Buyer" },
+    { id: "moderator", label: "Moderator" },
+];
+/** Admin > Stores — seller-onboarding state filter chip set. */
+export const ADMIN_STORE_STATUS_TABS = [
+    ALL_TAB,
+    { id: "active", label: "Active" },
+    { id: "pending", label: "Pending" },
+    { id: "suspended", label: "Suspended" },
+    { id: "rejected", label: "Rejected" },
+];
+/** Admin > Payouts — payout state filter chip set. Uppercase IDs match the
+ *  `PayoutDocument.status` enum on the server. */
+export const ADMIN_PAYOUT_STATUS_TABS = [
+    ALL_TAB,
+    { id: "PENDING", label: "Pending" },
+    { id: "PROCESSING", label: "Processing" },
+    { id: "PAID", label: "Paid" },
+    { id: "FAILED", label: "Failed" },
+];
+/** Admin > Orders — order-state filter chip set. Uppercase IDs match the
+ *  `OrderDocument.status` enum on the server. */
+export const ADMIN_ORDER_STATUS_TABS = [
+    ALL_TAB,
+    { id: "PENDING", label: "Pending" },
+    { id: "PROCESSING", label: "Processing" },
+    { id: "SHIPPED", label: "Shipped" },
+    { id: "DELIVERED", label: "Delivered" },
+    { id: "CANCELLED", label: "Cancelled" },
+    { id: "REFUNDED", label: "Refunded" },
+    { id: "RETURN_REQUESTED", label: "Return Requested" },
+];
+/** Admin > Reviews — moderation state filter chip set. */
+export const ADMIN_REVIEW_STATUS_TABS = [
+    ALL_TAB,
+    { id: "approved", label: "Approved" },
+    { id: "pending", label: "Pending" },
+    { id: "rejected", label: "Rejected" },
+];
+/** Admin > Reviews — star-rating filter chip set. */
+export const ADMIN_REVIEW_RATING_TABS = [
+    ALL_TAB,
+    { id: "5", label: "5★" },
+    { id: "4", label: "4★" },
+    { id: "3", label: "3★" },
+    { id: "2", label: "2★" },
+    { id: "1", label: "1★" },
+];
+/** Admin > Bids — bid-state filter chip set. */
+export const ADMIN_BID_STATUS_TABS = [
+    ALL_TAB,
+    { id: "active", label: "Active" },
+    { id: "outbid", label: "Outbid" },
+    { id: "won", label: "Won" },
+    { id: "cancelled", label: "Cancelled" },
+];
+/** Admin > Contact — submission triage state filter chip set. */
+export const ADMIN_CONTACT_STATUS_TABS = [
+    ALL_TAB,
+    { id: "new", label: "New" },
+    { id: "read", label: "Read" },
+    { id: "resolved", label: "Resolved" },
+];
+/** Admin > Newsletter — subscription state filter chip set. */
+export const ADMIN_NEWSLETTER_STATUS_TABS = [
+    ALL_TAB,
+    { id: "active", label: "Active" },
+    { id: "unsubscribed", label: "Unsubscribed" },
+];
+/** Admin > Event Entries — entry-state filter chip set. Uppercase IDs match
+ *  the canonical `EventEntryDocument.status` enum. */
+export const ADMIN_EVENT_ENTRY_STATUS_TABS = [
+    ALL_TAB,
+    { id: "CONFIRMED", label: "Confirmed" },
+    { id: "WAITLISTED", label: "Waitlisted" },
+    { id: "CANCELLED", label: "Cancelled" },
+];
+/** Admin > Events — event-state filter chip set. */
+export const ADMIN_EVENT_STATUS_TABS = [
+    ALL_TAB,
+    { id: "published", label: "Published" },
+    { id: "draft", label: "Draft" },
+    { id: "active", label: "Active" },
+    { id: "ended", label: "Ended" },
+];
+/** Admin > Carts — cart-ownership filter chip set. */
+export const ADMIN_CART_OWNERSHIP_TABS = [
+    ALL_TAB,
+    { id: "guest", label: "Guest" },
+    { id: "auth", label: "Authenticated" },
+];
+/** Admin > Coupons — coupon-type filter chip set. Matches the
+ *  `CouponDocument.type` discriminator. */
+export const ADMIN_COUPON_TYPE_TABS = [
+    ALL_TAB,
+    { id: "percentage", label: "Percentage" },
+    { id: "fixed", label: "Fixed" },
+    { id: "free_shipping", label: "Free Shipping" },
+    { id: "buy_x_get_y", label: "Buy X Get Y" },
+];
+// ---------------------------------------------------------------------------
+// Seller-dashboard filter-chip tab sets
+// ---------------------------------------------------------------------------
+/** Empty-sentinel variant for views (like SellerBidsView) that drive the
+ *  filter URL with `""` instead of `"All"` so the `"" == no filter` invariant
+ *  stays a single shape across queries. */
+export const EMPTY_TAB = { id: "", label: "All" };
+/** Seller > Products — listing-state filter chip set. */
+export const SELLER_PRODUCT_STATUS_TABS = [
+    ALL_TAB,
+    { id: "active", label: "Active" },
+    { id: "draft", label: "Draft" },
+    { id: "archived", label: "Archived" },
+    { id: "sold", label: "Sold" },
+];
+/** Seller > Auctions — auction-state filter chip set. */
+export const SELLER_AUCTION_STATUS_TABS = [
+    ALL_TAB,
+    { id: "active", label: "Active" },
+    { id: "draft", label: "Draft" },
+    { id: "ended", label: "Ended" },
+    { id: "cancelled", label: "Cancelled" },
+];
+/** Seller > Pre-orders — pre-order-state filter chip set. */
+export const SELLER_PRE_ORDER_STATUS_TABS = [
+    ALL_TAB,
+    { id: "active", label: "Active" },
+    { id: "draft", label: "Draft" },
+    { id: "archived", label: "Archived" },
+    { id: "cancelled", label: "Cancelled" },
+];
+/** Seller > Prize Draws — draw-state filter chip set. */
+export const SELLER_PRIZE_DRAW_STATUS_TABS = [
+    ALL_TAB,
+    { id: "active", label: "Active" },
+    { id: "draft", label: "Draft" },
+    { id: "ended", label: "Ended" },
+    { id: "cancelled", label: "Cancelled" },
+];
+/** Seller > Orders — order-state filter chip set. Subset of
+ *  `ADMIN_ORDER_STATUS_TABS` — sellers don't see `RETURN_REQUESTED` until
+ *  the buyer initiates one through support. */
+export const SELLER_ORDER_STATUS_TABS = [
+    ALL_TAB,
+    { id: "PENDING", label: "Pending" },
+    { id: "PROCESSING", label: "Processing" },
+    { id: "SHIPPED", label: "Shipped" },
+    { id: "DELIVERED", label: "Delivered" },
+    { id: "CANCELLED", label: "Cancelled" },
+    { id: "REFUNDED", label: "Refunded" },
+];
+/** Seller > Offers — offer-state filter chip set. */
+export const SELLER_OFFER_STATUS_TABS = [
+    ALL_TAB,
+    { id: "pending", label: "Pending" },
+    { id: "accepted", label: "Accepted" },
+    { id: "rejected", label: "Rejected" },
+    { id: "expired", label: "Expired" },
+];
+/** Seller > Bids — bid-state filter chip set. Uses the empty-sentinel
+ *  variant (see `EMPTY_TAB`). */
+export const SELLER_BID_STATUS_TABS = [
+    EMPTY_TAB,
+    { id: "active", label: "Active" },
+    { id: "outbid", label: "Outbid" },
+    { id: "won", label: "Won" },
+    { id: "lost", label: "Lost" },
+    { id: "cancelled", label: "Cancelled" },
+];

package/dist/features/admin/hooks/useAdminListingData.d.ts

@@ -19,6 +19,7 @@ export interface UseAdminListingDataResult<TRow extends {
     total: number;
     isLoading: boolean;
     errorMessage?: string;
+    refetch: () => void;
 }
 export declare function useAdminListingData<TResponse, TRow extends {
     id: string;

package/dist/features/admin/hooks/useAdminListingData.js

@@ -34,6 +34,7 @@ export function useAdminListingData({ queryKey, endpoint, page = 1, pageSize = 2
             : query.error
                 ? "Unable to load records"
                 : undefined,
+        refetch: () => { void query.refetch(); },
     };
 }
 export function toRecordArray(value) {

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

@@ -280,6 +280,21 @@ export interface SiteSettingsDocument {
         sellerRegistration: boolean;
         preOrders: boolean;
         seedPanel: boolean;
+        listingTypes?: {
+            standard?: boolean;
+            auction?: boolean;
+            "pre-order"?: boolean;
+            "prize-draw"?: boolean;
+            classified?: boolean;
+            "digital-code"?: boolean;
+            live?: boolean;
+        };
+        categoryTypes?: {
+            category?: boolean;
+            sublisting?: boolean;
+            brand?: boolean;
+            bundle?: boolean;
+        };
     };
     legalPages: {
         termsOfService: string;

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

@@ -156,6 +156,24 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         sellerRegistration: true,
         preOrders: false,
         seedPanel: true,
+        // SB-UNI-X4 2026-05-13 — Phase 1 types enabled by default; Phase 2 types
+        // (classified / digital-code / live) gated until per-type Phase 3 + 5
+        // surfaces ship. Admin Feature Flags UI lets the operator flip them.
+        listingTypes: {
+            standard: true,
+            auction: true,
+            "pre-order": true,
+            "prize-draw": true,
+            classified: false,
+            "digital-code": false,
+            live: false,
+        },
+        categoryTypes: {
+            category: true,
+            sublisting: true,
+            brand: true,
+            bundle: true,
+        },
     },
     shipping: {
         estimatedDays: 5,

package/dist/features/admin/types/product.types.d.ts

@@ -47,8 +47,8 @@ export interface AdminProduct {
     insurance?: boolean;
     insuranceCost?: number;
     shippingPaidBy?: "seller" | "buyer";
-    /** Canonical listing-kind discriminator (SB1-G Phase 4 — booleans removed). */
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
+    /** Canonical listing-kind discriminator (SB1-G Phase 4 — booleans removed). */
+    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
     auctionEndDate?: string;
     startingBid?: number;
     currentBid?: number;

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

@@ -21,6 +21,9 @@ interface AuctionCardProps {
     };
     onBid?: (auction: AuctionItem) => void;
     className?: string;
+    selectable?: boolean;
+    isSelected?: boolean;
+    onSelect?: (id: string, selected: boolean) => void;
 }
-export declare function AuctionCard({ auction, labels, onBid, className, }: AuctionCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function AuctionCard({ auction, labels, onBid, className, selectable, isSelected, onSelect, }: AuctionCardProps): import("react/jsx-runtime").JSX.Element;
 export {};

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;