@mohasinac/appkit 3.8.2 → 3.9.1

package/dist/features/admin/components/AdminSupportTicketDetailView.js

@@ -255,7 +255,7 @@ function OrderItemsPanel(props) {
         const q = Math.max(0, parseInt(raw, 10) || 0);
         setOrderItems((prev) => prev.map((p, i) => (i === idx ? { ...p, quantity: q } : p)));
     };
-    return (_jsxs(Stack, { padding: "sm", className: "border border-info/40 bg-[var(--appkit-color-info-surface)]/40", gap: "sm", rounded: "lg", children: [_jsx(Text, { className: "text-info tracking-wide", size: "xs", weight: "semibold", transform: "uppercase", children: "Modify order items" }), linkedOrderId ? (_jsxs(_Fragment, { children: [_jsxs(Text, { size: "xs", color: "muted", children: ["Editing order: ", _jsx(Code, { className: "font-mono", children: linkedOrderId })] }), !orderItemsOpen ? (_jsx(Button, { type: "button", variant: "secondary", size: "sm", isLoading: loadOrderItems.isPending, disabled: loadOrderItems.isPending, onClick: () => loadOrderItems.mutate(), children: "Load current items" })) : (_jsxs(_Fragment, { children: [orderItems.length === 0 ? (_jsx(Text, { size: "xs", color: "muted", children: "Order has no items." })) : (_jsx(Stack, { gap: "sm", children: orderItems.map((it, idx) => (_jsxs(Row, { paddingY: "y-2xs", padding: "x-xs", rounded: "default", align: "center", gap: "sm", border: "default", children: [_jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "truncate", size: "xs", weight: "medium", children: it.productTitle }), _jsxs(Text, { size: "xs", color: "muted", children: [it.productId, " \u00B7 \u20B9", (it.unitPrice / 100).toFixed(2), "/ea"] })] }), _jsx(Input, { bare: true, type: "number", min: "0", value: it.quantity, onChange: (e) => updateQty(idx, e.target.value), className: "w-16 rounded border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)]" })] }, `${it.productId}-${idx}`))) })), _jsxs(Row, { gap: "sm", children: [_jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: () => setOrderItemsOpen(false), children: "Cancel" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", isLoading: applyOrderItems.isPending, disabled: applyOrderItems.isPending, onClick: () => applyOrderItems.mutate(), children: "Apply changes" })] })] }))] })) : (_jsxs(Text, { size: "xs", color: "muted", children: ["Set the", " ", _jsx(Text, { as: "span", weight: "semibold", children: "Order ID" }), " ", "field in the Linked parties panel above to enable this action."] }))] }));
+    return (_jsxs(Stack, { padding: "sm", className: "border border-info/40 bg-[var(--appkit-color-info-surface)]/40", gap: "sm", rounded: "lg", children: [_jsx(Text, { className: "text-info tracking-wide", size: "xs", weight: "semibold", transform: "uppercase", children: "Modify order items" }), linkedOrderId ? (_jsxs(_Fragment, { children: [_jsxs(Text, { size: "xs", color: "muted", children: ["Editing order: ", _jsx(Code, { className: "font-mono", children: linkedOrderId })] }), !orderItemsOpen ? (_jsx(Button, { type: "button", variant: "secondary", size: "sm", isLoading: loadOrderItems.isPending, disabled: loadOrderItems.isPending, onClick: () => loadOrderItems.mutate(), children: "Load current items" })) : (_jsxs(_Fragment, { children: [orderItems.length === 0 ? (_jsx(Text, { size: "xs", color: "muted", children: "Order has no items." })) : (_jsx(Stack, { gap: "sm", children: orderItems.map((it, idx) => (_jsxs(Row, { paddingY: "y-2xs", padding: "x-xs", rounded: "default", align: "center", gap: "sm", border: "default", children: [_jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "truncate", size: "xs", weight: "medium", children: it.productTitle }), _jsxs(Text, { size: "xs", color: "muted", children: [it.productId, " \u00B7 \u20B9", it.unitPrice.toFixed(2), "/ea"] })] }), _jsx(Input, { bare: true, type: "number", min: "0", value: it.quantity, onChange: (e) => updateQty(idx, e.target.value), className: "w-16 rounded border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)]" })] }, `${it.productId}-${idx}`))) })), _jsxs(Row, { gap: "sm", children: [_jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: () => setOrderItemsOpen(false), children: "Cancel" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", isLoading: applyOrderItems.isPending, disabled: applyOrderItems.isPending, onClick: () => applyOrderItems.mutate(), children: "Apply changes" })] })] }))] })) : (_jsxs(Text, { size: "xs", color: "muted", children: ["Set the", " ", _jsx(Text, { as: "span", weight: "semibold", children: "Order ID" }), " ", "field in the Linked parties panel above to enable this action."] }))] }));
 }
 function StoreChangePanel(props) {
     const { linkedStoreId, storeStatus, setStoreStatus, storeIsVerified, setStoreIsVerified, storeIsFeatured, setStoreIsFeatured, applyStoreChange, } = props;

package/dist/features/admin/components/sections/adminSectionsBuildParse.js

@@ -190,7 +190,7 @@ export function parseProductsBuilder(config) {
         manualResourceIds: toStringArray(resources.ids).join(", "),
         filterByCategory: toStringValue(config.filterByCategory),
         maxCount: ([5, 10, 20].includes(maxCount) ? maxCount : 10),
-        loop: toBooleanValue(config.loop, false),
+        loop: toBooleanValue(config.loop, DEFAULT_PRODUCTS_BUILDER.loop),
     };
 }
 export function parseAuctionsBuilder(config) {
@@ -210,7 +210,7 @@ export function parseAuctionsBuilder(config) {
         manualResourceIds: toStringArray(resources.ids).join(", "),
         filterByCategory: toStringValue(config.filterByCategory),
         maxCount: ([5, 10, 20].includes(maxCount) ? maxCount : 10),
-        loop: toBooleanValue(config.loop, false),
+        loop: toBooleanValue(config.loop, DEFAULT_AUCTIONS_BUILDER.loop),
     };
 }
 export function parseStatsBuilder(config) {
@@ -271,7 +271,7 @@ export function parsePreOrdersBuilder(config) {
         manualResourceIds: toStringArray(resources.ids).join(", "),
         filterByCategory: toStringValue(config.filterByCategory),
         maxCount: ([5, 10, 20].includes(maxCount) ? maxCount : 10),
-        loop: toBooleanValue(config.loop, false),
+        loop: toBooleanValue(config.loop, DEFAULT_PRE_ORDERS_BUILDER.loop),
     };
 }
 export function parseStoresBuilder(config) {
@@ -292,7 +292,7 @@ export function parseStoresBuilder(config) {
         manualResourceIds: toStringArray(resources.ids).join(", "),
         filterByCategory: toStringValue(config.filterByCategory),
         maxCount: ([5, 10, 20].includes(maxCount) ? maxCount : 10),
-        loop: toBooleanValue(config.loop, false),
+        loop: toBooleanValue(config.loop, DEFAULT_STORES_BUILDER.loop),
     };
 }
 export function parseEventsBuilder(config) {
@@ -313,7 +313,7 @@ export function parseEventsBuilder(config) {
         manualResourceIds: toStringArray(resources.ids).join(", "),
         filterByCategory: toStringValue(config.filterByCategory),
         maxCount: ([5, 10, 20].includes(maxCount) ? maxCount : 10),
-        loop: toBooleanValue(config.loop, false),
+        loop: toBooleanValue(config.loop, DEFAULT_EVENTS_BUILDER.loop),
     };
 }
 export function buildSocialFeedConfig(builder) {
@@ -395,6 +395,7 @@ export function buildCategoriesConfig(builder) {
         maxCategories: builder.maxCategories,
         autoScroll: builder.autoScroll,
         scrollInterval: builder.scrollInterval,
+        loop: builder.loop,
     };
 }
 export function parseCategoriesBuilder(config) {
@@ -403,6 +404,7 @@ export function parseCategoriesBuilder(config) {
         maxCategories: toNumberValue(config.maxCategories, DEFAULT_CATEGORIES_BUILDER.maxCategories),
         autoScroll: toBooleanValue(config.autoScroll, DEFAULT_CATEGORIES_BUILDER.autoScroll),
         scrollInterval: toNumberValue(config.scrollInterval, DEFAULT_CATEGORIES_BUILDER.scrollInterval),
+        loop: toBooleanValue(config.loop, DEFAULT_CATEGORIES_BUILDER.loop),
     };
 }
 export function buildBrandsConfig(builder) {
@@ -412,6 +414,7 @@ export function buildBrandsConfig(builder) {
         maxBrands: builder.maxBrands,
         autoScroll: builder.autoScroll,
         scrollInterval: builder.scrollInterval,
+        loop: builder.loop,
     };
 }
 export function parseBrandsBuilder(config) {
@@ -421,6 +424,7 @@ export function parseBrandsBuilder(config) {
         maxBrands: toNumberValue(config.maxBrands, DEFAULT_BRANDS_BUILDER.maxBrands),
         autoScroll: toBooleanValue(config.autoScroll, DEFAULT_BRANDS_BUILDER.autoScroll),
         scrollInterval: toNumberValue(config.scrollInterval, DEFAULT_BRANDS_BUILDER.scrollInterval),
+        loop: toBooleanValue(config.loop, DEFAULT_BRANDS_BUILDER.loop),
     };
 }
 export function buildBannerConfig(builder) {
@@ -486,6 +490,7 @@ export function buildReviewsConfig(builder) {
         mobileItemsPerView: 1,
         autoScroll: builder.autoScroll,
         scrollInterval: builder.scrollInterval,
+        loop: builder.loop,
         source: builder.source,
         placeId: builder.source === "google" ? builder.placeId || undefined : undefined,
     };
@@ -497,6 +502,7 @@ export function parseReviewsBuilder(config) {
         itemsPerView: toNumberValue(config.itemsPerView, DEFAULT_REVIEWS_BUILDER.itemsPerView),
         autoScroll: toBooleanValue(config.autoScroll, DEFAULT_REVIEWS_BUILDER.autoScroll),
         scrollInterval: toNumberValue(config.scrollInterval, DEFAULT_REVIEWS_BUILDER.scrollInterval),
+        loop: toBooleanValue(config.loop, DEFAULT_REVIEWS_BUILDER.loop),
         source: toStringValue(config.source, "platform"),
         placeId: toStringValue(config.placeId),
     };
@@ -613,6 +619,7 @@ export function buildCustomCardsConfig(builder) {
         columns: builder.columns,
         autoScroll: builder.autoScroll,
         scrollIntervalMs: builder.scrollIntervalMs,
+        loop: builder.loop,
         cards: builder.cards.map((card, index) => ({
             id: card.id || `card-${index + 1}`,
             image: card.image || undefined,
@@ -639,6 +646,7 @@ export function parseCustomCardsBuilder(config) {
         columns: ([1, 2, 3, 4].includes(cols) ? cols : DEFAULT_CUSTOM_CARDS_BUILDER.columns),
         autoScroll: toBooleanValue(config.autoScroll, DEFAULT_CUSTOM_CARDS_BUILDER.autoScroll),
         scrollIntervalMs: toNumberValue(config.scrollIntervalMs, DEFAULT_CUSTOM_CARDS_BUILDER.scrollIntervalMs),
+        loop: toBooleanValue(config.loop, DEFAULT_CUSTOM_CARDS_BUILDER.loop),
         cards: cardsRaw.map((item, index) => {
             const c = (item ?? {});
             const br = toStringValue(c.borderRadius, "none");

package/dist/features/admin/components/sections/adminSectionsTypes.d.ts

@@ -150,6 +150,7 @@ export interface CategoriesBuilderState {
     maxCategories: number;
     autoScroll: boolean;
     scrollInterval: number;
+    loop: boolean;
 }
 export interface BrandsBuilderState {
     title: string;
@@ -157,6 +158,7 @@ export interface BrandsBuilderState {
     maxBrands: number;
     autoScroll: boolean;
     scrollInterval: number;
+    loop: boolean;
 }
 export interface BannerBuilderState {
     height: "sm" | "md" | "lg" | "xl";
@@ -185,6 +187,7 @@ export interface ReviewsBuilderState {
     itemsPerView: number;
     autoScroll: boolean;
     scrollInterval: number;
+    loop: boolean;
     source: "platform" | "google";
     placeId: string;
 }
@@ -249,6 +252,7 @@ export interface CustomCardsBuilderState {
     columns: 1 | 2 | 3 | 4;
     autoScroll: boolean;
     scrollIntervalMs: number;
+    loop: boolean;
     cards: CustomCardsCardBuilderEntry[];
 }
 export interface GoogleReviewsBuilderState {

package/dist/features/admin/components/sections/adminSectionsTypes.js

@@ -42,7 +42,7 @@ export const DEFAULT_PRODUCTS_BUILDER = {
     manualResourceIds: "",
     filterByCategory: "",
     maxCount: 10,
-    loop: false,
+    loop: true,
 };
 export const DEFAULT_AUCTIONS_BUILDER = {
     title: "Live Auctions",
@@ -57,7 +57,7 @@ export const DEFAULT_AUCTIONS_BUILDER = {
     manualResourceIds: "",
     filterByCategory: "",
     maxCount: 10,
-    loop: false,
+    loop: true,
 };
 const DEFAULT_STAT_ROW = {
     source: "static",
@@ -89,7 +89,7 @@ export const DEFAULT_PRE_ORDERS_BUILDER = {
     manualResourceIds: "",
     filterByCategory: "",
     maxCount: 10,
-    loop: false,
+    loop: true,
 };
 export const DEFAULT_STORES_BUILDER = {
     title: "Featured Stores",
@@ -105,7 +105,7 @@ export const DEFAULT_STORES_BUILDER = {
     manualResourceIds: "",
     filterByCategory: "",
     maxCount: 10,
-    loop: false,
+    loop: true,
 };
 export const DEFAULT_EVENTS_BUILDER = {
     title: "Events & Offers",
@@ -121,7 +121,7 @@ export const DEFAULT_EVENTS_BUILDER = {
     manualResourceIds: "",
     filterByCategory: "",
     maxCount: 10,
-    loop: false,
+    loop: true,
 };
 export const DEFAULT_SOCIAL_FEED_BUILDER = {
     title: "",
@@ -156,6 +156,7 @@ export const DEFAULT_CATEGORIES_BUILDER = {
     maxCategories: 8,
     autoScroll: false,
     scrollInterval: 5000,
+    loop: true,
 };
 export const DEFAULT_BRANDS_BUILDER = {
     title: "Top Brands",
@@ -163,6 +164,7 @@ export const DEFAULT_BRANDS_BUILDER = {
     maxBrands: 13,
     autoScroll: true,
     scrollInterval: 4000,
+    loop: true,
 };
 export const DEFAULT_BANNER_BUILDER = {
     height: "lg",
@@ -187,6 +189,7 @@ export const DEFAULT_REVIEWS_BUILDER = {
     itemsPerView: 3,
     autoScroll: true,
     scrollInterval: 5000,
+    loop: true,
     source: "platform",
     placeId: "",
 };
@@ -237,6 +240,7 @@ export const DEFAULT_CUSTOM_CARDS_BUILDER = {
     columns: 3,
     autoScroll: false,
     scrollIntervalMs: 4000,
+    loop: true,
     cards: [],
 };
 export const DEFAULT_GOOGLE_REVIEWS_BUILDER = {

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

@@ -32,6 +32,6 @@ export declare function useAdminListingData<TResponse, TRow extends {
 }>({ queryKey, endpoint, page, pageSize, sorts, filters, q, mapRows, getTotal, }: UseAdminListingDataOptions<TResponse, TRow>): UseAdminListingDataResult<TRow>;
 export declare function toRecordArray(value: unknown): ListingItemRecord[];
 export declare function toStringValue(value: unknown, fallback?: string): string;
-export declare function toRupees(value: unknown): string;
+export declare function toCurrency(value: unknown): string;
 export declare function toRelativeDate(value: unknown): string;
 export {};

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

@@ -1,6 +1,7 @@
 "use client";
 import { useQuery } from "@tanstack/react-query";
 import { apiClient, ApiClientError } from "../../../http";
+import { formatCurrency } from "../../../utils/number.formatter";
 function withQueryParams(endpoint, params) {
     const hasQuery = endpoint.includes("?");
     const query = new URLSearchParams(params).toString();
@@ -49,11 +50,11 @@ export function toStringValue(value, fallback = "-") {
     }
     return fallback;
 }
-export function toRupees(value) {
+export function toCurrency(value) {
     if (typeof value !== "number" || Number.isNaN(value)) {
         return "-";
     }
-    return `INR ${value.toLocaleString("en-IN")}`;
+    return formatCurrency(value);
 }
 export function toRelativeDate(value) {
     const date = parseDate(value);

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

@@ -3,7 +3,7 @@
  * Covers: notifications, chat rooms, site settings
  */
 export declare const ADMIN_CHECKOUT_BYPASS_FLAG_KEY: "adminCheckoutBypass";
-export type NotificationType = "order_placed" | "order_confirmed" | "order_shipped" | "order_delivered" | "order_cancelled" | "bid_placed" | "bid_outbid" | "bid_won" | "bid_lost" | "review_approved" | "review_replied" | "product_available" | "promotion" | "system" | "welcome" | "account_action" | "offer_received" | "offer_responded" | "offer_expired" | "offer_counter_accepted" | "refund_initiated" | "prize_reveal_ready" | "prize_reveal_expired" | "prize_reveal_reminder" | "emi_installment_due_soon" | "emi_installment_overdue";
+export type NotificationType = "order_placed" | "order_confirmed" | "order_shipped" | "order_delivered" | "order_cancelled" | "bid_placed" | "bid_outbid" | "bid_won" | "bid_lost" | "review_approved" | "review_replied" | "product_available" | "promotion" | "system" | "welcome" | "account_action" | "offer_received" | "offer_responded" | "offer_expired" | "offer_counter_accepted" | "refund_initiated" | "prize_reveal_ready" | "prize_reveal_expired" | "prize_reveal_reminder" | "emi_installment_due_soon" | "emi_installment_overdue" | "payment_review";
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export type NotificationPriority = "low" | "normal" | "high";
 export interface NotificationDocument extends BaseDocument {
@@ -288,12 +288,14 @@ export interface SiteSettingsDocument extends BaseDocument {
         razorpayEnabled: boolean;
         upiManualEnabled: boolean;
         codEnabled: boolean;
+        /** Tier PP — cart total (rupees) at/above which checkout requires OTP verification. Applies to all payment methods except COD. Optional — falls back to no OTP gate when unset. */
+        otpCheckoutThreshold?: number;
     };
     /** Site-wide EMI (installment) settings. A seller must ALSO have `StoreDocument.emiEnabled` on for EMI to appear at checkout for their items. */
     emi: {
         enabled: boolean;
-        /** Paise — a seller's cart subtotal must exceed this for EMI to appear as an option. */
-        minOrderValueInPaise: number;
+        /** Decimal rupees — a seller's cart subtotal must exceed this for EMI to appear as an option. */
+        minOrderValue: number;
         tenureOptions: number[];
         /** Down payment % collected at checkout. */
         tokenPercent: number;
@@ -314,8 +316,8 @@ export interface SiteSettingsDocument extends BaseDocument {
         /** Razorpay gateway cost % (absorbed by platform, not passed through separately). */
         gatewayFeePercent: number;
         codDepositPercent: number;
-        /** COD handling fee charged to the buyer: max(codHandlingFeeMinInPaise, subtotal × codHandlingFeePercent / 100). */
-        codHandlingFeeMinInPaise: number;
+        /** COD handling fee charged to the buyer: max(codHandlingFeeMin, subtotal × codHandlingFeePercent / 100). */
+        codHandlingFeeMin: number;
         codHandlingFeePercent: number;
         sellerShippingFixed: number;
         platformShippingPercent: number;
@@ -331,10 +333,10 @@ export interface SiteSettingsDocument extends BaseDocument {
         promotedSlotFee?: number;
     };
     /** Procurement Shipments (Feature A) — the hourly rate used to compute a
-     *  shipment's laborCostPaise, and the daily-hour cap used to project
+     *  shipment's laborCost, and the daily-hour cap used to project
      *  estimatedProcessingDays. */
     laborRate: {
-        hourlyRatePaise: number;
+        hourlyRate: number;
         maxHoursPerDay: number;
     };
     /** P-8 GST — Indian tax compliance. Distinct from commissions.gstPercent

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

@@ -170,10 +170,11 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         razorpayEnabled: false,
         upiManualEnabled: true,
         codEnabled: true,
+        otpCheckoutThreshold: 5000,
     },
     emi: {
         enabled: false,
-        minOrderValueInPaise: 1000000,
+        minOrderValue: 10000,
         tenureOptions: [2, 3, 4, 5, 6],
         tokenPercent: 10,
         billingDay: 5,
@@ -186,7 +187,7 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         minimumTransactionFee: 0,
         gatewayFeePercent: 2,
         codDepositPercent: 10,
-        codHandlingFeeMinInPaise: 20000,
+        codHandlingFeeMin: 200,
         codHandlingFeePercent: 10,
         sellerShippingFixed: 0,
         platformShippingPercent: 10,
@@ -200,7 +201,7 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         promotedSlotFee: 499,
     },
     laborRate: {
-        hourlyRatePaise: 20000,
+        hourlyRate: 200,
         maxHoursPerDay: 6,
     },
     gst: {

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

@@ -6,12 +6,12 @@ import { Badge, Button, Div, Row, Span, Stack, Text } from "../../../ui";
 const __O = {
     hidden: "overflow-hidden",
 };
-function paise(amount) {
+function formatBidAmount(amount) {
     return new Intl.NumberFormat("en-IN", {
         style: "currency",
         currency: "INR",
         maximumFractionDigits: 0,
-    }).format(amount / 100);
+    }).format(amount);
 }
 function relDate(d) {
     const ms = new Date(d).getTime();
@@ -54,7 +54,7 @@ function AuctionRow({ auction, portal, }) {
     const sorted = useMemo(() => [...auction.bids].sort((a, b) => b.bidAmount - a.bidAmount), [auction.bids]);
     const highest = sorted[0]?.bidAmount ?? 0;
     const isWinning = auction.bids.some((b) => b.isWinning);
-    return (_jsxs(Div, { className: `border border-[var(--appkit-color-border)] ${__O.hidden} bg-[var(--appkit-color-surface)]`, rounded: "xl", shadow: "sm", children: [_jsxs(Button, { type: "button", variant: "ghost", onClick: () => setExpanded((v) => !v), gap: "lg", paddingX: "md", paddingY: "md", className: "w-full text-left", "aria-expanded": expanded, children: [_jsx(ChevronRight, { className: `shrink-0 text-[var(--appkit-color-text-muted)] transition-transform ${expanded ? "rotate-90" : ""}`, size: 16 }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(Text, { className: "text-[var(--appkit-color-text)] line-clamp-1", size: "sm", weight: "semibold", children: auction.productTitle }) }), _jsxs(Row, { gap: "sm", className: "shrink-0", children: [isWinning && (_jsx(Badge, { variant: "active", children: "Winning" })), _jsxs(Text, { variant: "secondary", size: "xs", children: [auction.bids.length, " bid", auction.bids.length !== 1 ? "s" : ""] }), _jsx(Text, { className: "text-[var(--appkit-color-text)]", size: "sm", weight: "semibold", children: paise(highest) })] })] }), expanded && (_jsxs(Div, { className: "border-t border-[var(--appkit-color-border)]", children: [_jsxs(Div, { textSize: "xs", textWeight: "medium", paddingX: "x-md", paddingY: "y-xs", className: `grid text-[var(--appkit-color-text-muted)] uppercase tracking-wide border-b border-[var(--appkit-color-border-subtle)] ${portal === "buyer" ? "[grid-template-columns:1fr_auto_auto]" : "[grid-template-columns:1fr_1fr_auto_auto]"}`, children: [_jsx(Span, { children: portal === "buyer" ? "Amount" : "Bidder" }), portal !== "buyer" && _jsx(Span, { children: "Amount" }), _jsx(Span, { children: "Status" }), _jsx(Span, { className: "text-right", children: "Time" })] }), sorted.map((bid) => (_jsxs(Div, { layout: "grid", align: "center", paddingX: "x-md", paddingY: "y-xs-tall", className: `border-b border-[var(--appkit-color-border-subtle)] last:border-0 hover:bg-[var(--appkit-color-border-subtle)] transition-colors ${portal === "buyer" ? "[grid-template-columns:1fr_auto_auto]" : "[grid-template-columns:1fr_1fr_auto_auto]"}`, children: [portal !== "buyer" && (_jsx(Text, { className: "text-[var(--appkit-color-text)] truncate pr-[0.75rem]", size: "sm", children: bid.userName || bid.userId })), _jsx(Text, { className: "text-[var(--appkit-color-text)]", size: "sm", weight: "medium", children: paise(bid.bidAmount) }), _jsx(Badge, { variant: STATUS_VARIANT[bid.status] ?? "pending", className: "capitalize", children: bid.status }), _jsx(Text, { variant: "secondary", size: "xs", align: "end", children: relDate(bid.bidDate) })] }, bid.id)))] }))] }));
+    return (_jsxs(Div, { className: `border border-[var(--appkit-color-border)] ${__O.hidden} bg-[var(--appkit-color-surface)]`, rounded: "xl", shadow: "sm", children: [_jsxs(Button, { type: "button", variant: "ghost", onClick: () => setExpanded((v) => !v), gap: "lg", paddingX: "md", paddingY: "md", className: "w-full text-left", "aria-expanded": expanded, children: [_jsx(ChevronRight, { className: `shrink-0 text-[var(--appkit-color-text-muted)] transition-transform ${expanded ? "rotate-90" : ""}`, size: 16 }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(Text, { className: "text-[var(--appkit-color-text)] line-clamp-1", size: "sm", weight: "semibold", children: auction.productTitle }) }), _jsxs(Row, { gap: "sm", className: "shrink-0", children: [isWinning && (_jsx(Badge, { variant: "active", children: "Winning" })), _jsxs(Text, { variant: "secondary", size: "xs", children: [auction.bids.length, " bid", auction.bids.length !== 1 ? "s" : ""] }), _jsx(Text, { className: "text-[var(--appkit-color-text)]", size: "sm", weight: "semibold", children: formatBidAmount(highest) })] })] }), expanded && (_jsxs(Div, { className: "border-t border-[var(--appkit-color-border)]", children: [_jsxs(Div, { textSize: "xs", textWeight: "medium", paddingX: "x-md", paddingY: "y-xs", className: `grid text-[var(--appkit-color-text-muted)] uppercase tracking-wide border-b border-[var(--appkit-color-border-subtle)] ${portal === "buyer" ? "[grid-template-columns:1fr_auto_auto]" : "[grid-template-columns:1fr_1fr_auto_auto]"}`, children: [_jsx(Span, { children: portal === "buyer" ? "Amount" : "Bidder" }), portal !== "buyer" && _jsx(Span, { children: "Amount" }), _jsx(Span, { children: "Status" }), _jsx(Span, { className: "text-right", children: "Time" })] }), sorted.map((bid) => (_jsxs(Div, { layout: "grid", align: "center", paddingX: "x-md", paddingY: "y-xs-tall", className: `border-b border-[var(--appkit-color-border-subtle)] last:border-0 hover:bg-[var(--appkit-color-border-subtle)] transition-colors ${portal === "buyer" ? "[grid-template-columns:1fr_auto_auto]" : "[grid-template-columns:1fr_1fr_auto_auto]"}`, children: [portal !== "buyer" && (_jsx(Text, { className: "text-[var(--appkit-color-text)] truncate pr-[0.75rem]", size: "sm", children: bid.userName || bid.userId })), _jsx(Text, { className: "text-[var(--appkit-color-text)]", size: "sm", weight: "medium", children: formatBidAmount(bid.bidAmount) }), _jsx(Badge, { variant: STATUS_VARIANT[bid.status] ?? "pending", className: "capitalize", children: bid.status }), _jsx(Text, { variant: "secondary", size: "xs", align: "end", children: relDate(bid.bidDate) })] }, bid.id)))] }))] }));
 }
 export function AuctionBidsTable({ bids, portal = "buyer", emptyLabel = "No bids found.", }) {
     const auctions = useMemo(() => groupByAuction(bids), [bids]);

package/dist/features/auth/checkout-value-otp.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Checkout Value OTP — Tier PP.
+ *
+ * A distinct OTP purpose from `consent-otp.ts` (which gates third-party
+ * shipping consent): this one gates placing a checkout ≥ the site's
+ * `payment.otpCheckoutThreshold` (skipped for COD — see
+ * `createCheckoutOrderAction`). Deliberately a SEPARATE Firestore namespace
+ * (`checkoutValueOtps` vs `consentOtps`) rather than reusing the shipping-
+ * consent one — different purpose, different copy, independently tunable
+ * rate limits. Reuses `generateOtpCode()`/`hashOtp()` from `consent-otp.ts`
+ * rather than duplicating the crypto.
+ */
+import { generateOtpCode, hashOtp } from "./consent-otp";
+export { generateOtpCode, hashOtp };
+/** OTP validity window (10 minutes) — matches consent-OTP's window; independently tunable if policy diverges later. */
+export declare const CHECKOUT_VALUE_OTP_EXPIRY_MS: number;
+export declare const CHECKOUT_VALUE_OTP_EXPIRY_MINUTES = 10;
+/** Per-user send cooldown (15 minutes). */
+export declare const CHECKOUT_VALUE_OTP_COOLDOWN_MS: number;
+/** Maximum failed verification attempts before the OTP is locked. */
+export declare const CHECKOUT_VALUE_OTP_MAX_ATTEMPTS = 5;
+/** Rate-limit config for the verify endpoint / action (10 attempts per 5 min). */
+export declare const CHECKOUT_VALUE_OTP_VERIFY_RATE_LIMIT: {
+    readonly limit: 10;
+    readonly window: 300;
+};
+type Db = FirebaseFirestore.Firestore;
+/**
+ * Single-slot doc per user — unlike consent OTP (one per address), a buyer
+ * can only be mid-checkout once, so there's no per-context key needed.
+ */
+export declare function checkoutValueOtpRef(db: Db, uid: string): FirebaseFirestore.DocumentReference<FirebaseFirestore.DocumentData, FirebaseFirestore.DocumentData>;
+export declare function checkoutValueOtpRateLimitRef(db: Db, uid: string): FirebaseFirestore.DocumentReference<FirebaseFirestore.DocumentData, FirebaseFirestore.DocumentData>;
+export interface CheckoutValueOtpDoc {
+    codeHash: string;
+    expiresAt: FirebaseFirestore.Timestamp;
+    attempts: number;
+    verified: boolean;
+}
+/**
+ * Enforce the per-user send rate-limit.
+ * Throws AuthorizationError("checkoutValueOtpRateLimit") when throttled.
+ */
+export declare function enforceCheckoutValueOtpRateLimit(db: Db, uid: string): Promise<void>;
+/** Build the checkout-value OTP WhatsApp/SMS message body. */
+export declare function buildCheckoutValueOtpMessage(code: string, siteName: string): string;

package/dist/features/auth/checkout-value-otp.js

@@ -0,0 +1,73 @@
+/**
+ * Checkout Value OTP — Tier PP.
+ *
+ * A distinct OTP purpose from `consent-otp.ts` (which gates third-party
+ * shipping consent): this one gates placing a checkout ≥ the site's
+ * `payment.otpCheckoutThreshold` (skipped for COD — see
+ * `createCheckoutOrderAction`). Deliberately a SEPARATE Firestore namespace
+ * (`checkoutValueOtps` vs `consentOtps`) rather than reusing the shipping-
+ * consent one — different purpose, different copy, independently tunable
+ * rate limits. Reuses `generateOtpCode()`/`hashOtp()` from `consent-otp.ts`
+ * rather than duplicating the crypto.
+ */
+import { AuthorizationError } from "../../errors";
+import { resolveDate } from "../../utils";
+import { USER_COLLECTION } from "./schemas";
+import { generateOtpCode, hashOtp } from "./consent-otp";
+export { generateOtpCode, hashOtp };
+/** OTP validity window (10 minutes) — matches consent-OTP's window; independently tunable if policy diverges later. */
+export const CHECKOUT_VALUE_OTP_EXPIRY_MS = 10 * 60 * 1000;
+export const CHECKOUT_VALUE_OTP_EXPIRY_MINUTES = 10;
+/** Per-user send cooldown (15 minutes). */
+export const CHECKOUT_VALUE_OTP_COOLDOWN_MS = 15 * 60 * 1000;
+/** Maximum failed verification attempts before the OTP is locked. */
+export const CHECKOUT_VALUE_OTP_MAX_ATTEMPTS = 5;
+/** Rate-limit config for the verify endpoint / action (10 attempts per 5 min). */
+export const CHECKOUT_VALUE_OTP_VERIFY_RATE_LIMIT = {
+    limit: 10,
+    window: 300,
+};
+/**
+ * Single-slot doc per user — unlike consent OTP (one per address), a buyer
+ * can only be mid-checkout once, so there's no per-context key needed.
+ */
+export function checkoutValueOtpRef(db, uid) {
+    return db
+        .collection(USER_COLLECTION)
+        .doc(uid)
+        .collection("checkoutValueOtps")
+        .doc("current");
+}
+export function checkoutValueOtpRateLimitRef(db, uid) {
+    return db
+        .collection(USER_COLLECTION)
+        .doc(uid)
+        .collection("checkoutValueOtpRateLimit")
+        .doc("meta");
+}
+/**
+ * Enforce the per-user send rate-limit.
+ * Throws AuthorizationError("checkoutValueOtpRateLimit") when throttled.
+ */
+export async function enforceCheckoutValueOtpRateLimit(db, uid) {
+    const metaRef = checkoutValueOtpRateLimitRef(db, uid);
+    await db.runTransaction(async (tx) => {
+        const metaSnap = await tx.get(metaRef);
+        const meta = metaSnap.exists
+            ? metaSnap.data()
+            : null;
+        const lastSentMs = resolveDate(meta?.lastSentAt)?.getTime() ?? 0;
+        const elapsed = Date.now() - lastSentMs;
+        if (elapsed < CHECKOUT_VALUE_OTP_COOLDOWN_MS) {
+            throw new AuthorizationError("checkoutValueOtpRateLimit");
+        }
+        tx.set(metaRef, { lastSentAt: new Date() }, { merge: true });
+    });
+}
+/** Build the checkout-value OTP WhatsApp/SMS message body. */
+export function buildCheckoutValueOtpMessage(code, siteName) {
+    return (`*${siteName} — Order Verification*\n\n` +
+        `Your verification code for this high-value order is: *${code}*\n\n` +
+        `This code expires in ${CHECKOUT_VALUE_OTP_EXPIRY_MINUTES} minutes. ` +
+        `If you did not request this, please ignore this message.`);
+}

package/dist/features/auth/repository/user.repository.d.ts

@@ -16,6 +16,12 @@ export declare class UserRepository extends BaseRepository<UserDocument> {
     findByRole(role: UserRole): Promise<UserDocument[]>;
     findVerified(limit?: number): Promise<UserDocument[]>;
     findActive(limit?: number): Promise<UserDocument[]>;
+    /**
+     * Cloud Functions: temporary hard-bans past their `hardBanExpiresAt` —
+     * the `hardBanReinstatement` sweep re-enables Auth login for these.
+     * Permanent bans (`hardBanExpiresAt` null/absent) never match this query.
+     */
+    getExpiredHardBans(): Promise<UserDocument[]>;
     update(uid: string, data: Partial<UserDocument>): Promise<UserDocument>;
     markEmailAsVerified(uid: string): Promise<UserDocument>;
     disable(uid: string): Promise<UserDocument>;

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

@@ -106,6 +106,25 @@ export class UserRepository extends BaseRepository {
             throw new DatabaseError("Failed to fetch active users", error);
         }
     }
+    /**
+     * Cloud Functions: temporary hard-bans past their `hardBanExpiresAt` —
+     * the `hardBanReinstatement` sweep re-enables Auth login for these.
+     * Permanent bans (`hardBanExpiresAt` null/absent) never match this query.
+     */
+    async getExpiredHardBans() {
+        try {
+            const snapshot = await this.getCollection()
+                .where(USER_FIELDS.IS_DISABLED, "==", true)
+                .where(USER_FIELDS.HARD_BAN_EXPIRES_AT, "<=", new Date())
+                .limit(500)
+                .get();
+            return snapshot.docs.map((doc) => this.mapDoc(doc));
+        }
+        catch (error) {
+            void normalizeError(error);
+            throw new DatabaseError("Failed to fetch expired hard bans", error);
+        }
+    }
     async update(uid, data) {
         const encrypted = this.encryptUserData(data);
         return super.update(uid, encrypted);

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

@@ -44,6 +44,8 @@ export interface UserDocument extends BaseDocument {
     passwordHash?: string;
     emailVerified: boolean;
     disabled: boolean;
+    /** Hard-ban flag — disables Firebase Auth login. Distinct from `disabled` (used elsewhere); read alongside `hardBanReason`/`hardBannedAt`/`hardBannedBy`. Set by `hardBanCascade`, cleared by `hardBanReinstatement` for temporary bans. */
+    isDisabled?: boolean;
     storeId?: string;
     storeSlug?: string;
     storeStatus?: "pending" | "approved" | "rejected";
@@ -95,6 +97,12 @@ export interface UserDocument extends BaseDocument {
     hardBanReason?: string;
     hardBannedAt?: Date;
     hardBannedBy?: string;
+    /** Null/absent = permanent hard ban (the default). A future Date makes this a temporary ban, auto-reinstated by the `hardBanReinstatement` sweep — mirrors `UserSoftBan.expiresAt`'s null-vs-past-date convention. Set only by the payment-fraud-reject path today. */
+    hardBanExpiresAt?: Date | null;
+    /** Order that triggered a fraud-rejection ban, for traceability. */
+    hardBanFraudOrderId?: string;
+    /** Stamped by `hardBanReinstatement` when a temporary ban's `hardBanExpiresAt` passes and login is re-enabled. `hardBanReason`/`hardBannedAt`/`hardBannedBy`/`hardBanExpiresAt` are left in place as historical record — not cleared. */
+    hardBanReinstatedAt?: Date;
     /** Timestamp when user confirmed they read the scam awareness guide. Required before full platform access. */
     scamAwarenessAcknowledgedAt?: Date;
     /** User-controlled notification channel and type preferences. */
@@ -206,6 +214,8 @@ export declare const USER_FIELDS: {
     readonly PASSWORD_HASH: "passwordHash";
     readonly EMAIL_VERIFIED: "emailVerified";
     readonly DISABLED: "disabled";
+    readonly IS_DISABLED: "isDisabled";
+    readonly HARD_BAN_EXPIRES_AT: "hardBanExpiresAt";
     readonly CREATED_AT: "createdAt";
     readonly UPDATED_AT: "updatedAt";
     readonly STORE_ID: "storeId";

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

@@ -102,6 +102,8 @@ export const USER_FIELDS = {
     PASSWORD_HASH: "passwordHash",
     EMAIL_VERIFIED: "emailVerified",
     DISABLED: "disabled",
+    IS_DISABLED: "isDisabled",
+    HARD_BAN_EXPIRES_AT: "hardBanExpiresAt",
     CREATED_AT: "createdAt",
     UPDATED_AT: "updatedAt",
     STORE_ID: "storeId",

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

@@ -14,4 +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>;
+export declare function updateCartItemShipping(userId: string, itemId: string, providerId: string, fee: number): Promise<CartDocument>;

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

@@ -77,11 +77,11 @@ export async function mergeGuestCart(userId, items) {
 export async function getCart(userId) {
     return cartRepository.findByUserId(userId);
 }
-export async function updateCartItemShipping(userId, itemId, providerId, feeInPaise) {
+export async function updateCartItemShipping(userId, itemId, providerId, fee) {
     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");
+    if (!Number.isFinite(fee) || fee < 0) {
+        throw new ValidationError("fee must be a non-negative number");
     }
-    return cartRepository.updateItemShipping(userId, itemId, providerId, feeInPaise);
+    return cartRepository.updateItemShipping(userId, itemId, providerId, fee);
 }

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

@@ -8,8 +8,8 @@ export interface CartOrderGroup {
     storeName: string;
     orderType: string;
     items: JsonArray;
-    subtotalInPaise: number;
-    shippingFeeInPaise: number;
+    subtotal: number;
+    shippingFee: number;
 }
 export interface CartViewProps {
     labels?: {

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

@@ -11,11 +11,11 @@ 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;
+    /** Order subtotal, decimal rupees — used to evaluate freeAbove + percentOfOrder rules. */
+    subtotal?: number;
     /** Called when the buyer picks (or changes) a provider. */
-    onPickProvider: (providerId: string, feeInPaise: number) => void | Promise<void>;
+    onPickProvider: (providerId: string, fee: number) => void | Promise<void>;
     isLoading?: boolean;
     className?: string;
 }
-export declare function ShippingPicker({ providers, selectedProviderId, subtotalInPaise, onPickProvider, isLoading, className, }: ShippingPickerProps): React.JSX.Element;
+export declare function ShippingPicker({ providers, selectedProviderId, subtotal, onPickProvider, isLoading, className, }: ShippingPickerProps): React.JSX.Element;