@mohasinac/appkit 4.53.1 → 4.54.0

package/dist/features/layout/useIsDesktop.js

@@ -0,0 +1,48 @@
+"use client";
+import { useEffect, useState } from "react";
+/**
+ * The line at which the layout stops being a phone.
+ *
+ * 64rem is Tailwind's `lg` — deliberately the same breakpoint `BottomNavbar`
+ * disappears at, so every decision that depends on "is there a tab bar at the
+ * bottom of this screen" flips at one place.
+ */
+export const DESKTOP_QUERY = "(min-width: 64rem)";
+/**
+ * `true` at `lg` and up.
+ *
+ * ── 🛑 WHY A HOOK AND NOT A `lg:` CLASS ────────────────────────────────────
+ *
+ * Three callers need the breakpoint as a VALUE, not as styling:
+ *
+ *   - `BottomChrome` must know which CSS variable to publish — a media query
+ *     can move the box but cannot tell a `ResizeObserver` which end of the
+ *     screen it landed at.
+ *   - `SideActionDock` and `BottomActions` are the two halves of one control
+ *     and must never both be mounted: two toolbars reading the same context,
+ *     both `fixed`, both dispatching the same callbacks. Hiding one with
+ *     `display:none` would still mount it, still run its observers, and still
+ *     let a stray `:focus` land inside an invisible bar.
+ *
+ * And the class form is actively unsafe here. Both Tailwind configs set
+ * `important: true`, so a `lg:` override and its unprefixed base tie on
+ * specificity AND on `!important` — a media query adds no specificity — and
+ * the winner is decided by EMISSION ORDER in the built CSS, which is invisible
+ * from the call site. That is exactly how `BottomChrome` ended up anchored to
+ * both edges at once and published an 801px phantom bar (see its header).
+ *
+ * SSR renders the mobile branch, because that is the branch that is correct
+ * when nothing is known: a phone that briefly gets the dock has lost its only
+ * CTA, while a desktop that briefly gets the bar has a bar.
+ */
+export function useIsDesktop() {
+    const [isDesktop, setIsDesktop] = useState(false);
+    useEffect(() => {
+        const mq = window.matchMedia(DESKTOP_QUERY);
+        const sync = () => setIsDesktop(mq.matches);
+        sync();
+        mq.addEventListener("change", sync);
+        return () => mq.removeEventListener("change", sync);
+    }, []);
+    return isDesktop;
+}

package/dist/features/live/components/LiveItemDetailPageView.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import Link from "next/link.js";
+import { OwnerQuickActions } from "../../../features/admin/components/OwnerQuickActions.js";
 import { getLiveItemForDetail } from "../../../_internal/server/features/live/data.js";
 const CLS_BREADCRUMB_LINK = "hover:text-primary-600 dark:hover:text-primary-400 transition-colors";
 const CLS_LIVE_ITEM_BADGE = "inline-block rounded-full bg-lime-100 dark:bg-lime-900/30 px-[var(--appkit-space-2-5)] py-[var(--appkit-space-0-5)] text-lime-700 dark:text-lime-300";
@@ -24,6 +25,7 @@ import { GroupedListingsCarousel } from "../../grouped/components/GroupedListing
 import { getGroupsWithItemsForProduct } from "../../../_internal/server/features/grouped/data.js";
 import { ReviewsListingPanel } from "../../reviews/components/ReviewsListingPanel.js";
 import { ListingBottomActions } from "../../products/components/ListingBottomActions.js";
+import { productImageUrls } from "../../products/schemas/firestore.js";
 function toDescriptionHtml(raw) {
     if (!raw)
         return "";
@@ -44,7 +46,15 @@ export async function LiveItemDetailPageView({ slug, initialProduct, renderActio
     const currency = p.currency || getDefaultCurrency();
     const title = String(p.title ?? p.name ?? "Live Listing");
     const price = typeof p.price === "number" ? p.price : null;
-    const images = Array.isArray(p.images) ? p.images : typeof p.mainImage === "string" ? [p.mainImage] : [];
+    // `images` is `ProductImage[]` since A6 — `productImageUrls` is the one
+    // normaliser (it also accepts the legacy `string[]`). Casting it to
+    // `string[]` handed the gallery objects and rendered a placeholder.
+    const galleryUrls = productImageUrls(p.images);
+    const images = galleryUrls.length > 0
+        ? galleryUrls
+        : typeof p.mainImage === "string"
+            ? [p.mainImage]
+            : [];
     const productVideo = p.video;
     const meta = product.liveItem;
     const jurisdictions = meta?.jurisdictionAllowed ?? [];
@@ -69,5 +79,5 @@ export async function LiveItemDetailPageView({ slug, initialProduct, renderActio
                     price: price ?? undefined,
                     storeId: typeof p.storeId === "string" ? p.storeId : undefined,
                     storeName: storeName ?? undefined,
-                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.LIVE), className: CLS_BREADCRUMB_LINK, children: "Live" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => _jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title }), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_LIVE_ITEM_BADGE, children: "Live Item" }), meta?.vendorVerified && (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Verified Seller" })), meta?.cites && (_jsxs(Span, { color: "warning", surface: "warning-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: ["CITES: ", meta.cites] }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title }), meta?.species && (_jsxs(Text, { className: "italic mt-1", color: "muted", size: "sm", children: [meta.species, meta.sex && meta.sex !== "n/a" && ` · ${meta.sex}`, meta.ageMonths !== undefined && ` · ${meta.ageMonths}mo`] }))] }), price !== null && (_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { children: formatCurrency(price, currency) }) })), jurisdictions.length > 0 && (_jsxs(Div, { className: CLS_WARN_BOX, children: [_jsx(Text, { className: CLS_WARN_TITLE, children: "Delivery restrictions" }), _jsxs(Text, { className: CLS_WARN_BODY, children: ["This item can only be shipped to: ", jurisdictions.join(", ")] })] })), transport && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Transport" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Method: ", transport.method, transport.handlingFee !== undefined && (_jsx(PricesOnly, { children: ` · Handling: ${formatCurrency(transport.handlingFee, "INR")}` })), transport.insuranceIncluded && " · Insurance included"] })] })), meta?.careInfo && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Care information" }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-text-muted)]", children: meta.careInfo })] })), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { border: "subtle", rounded: "xl", surface: "muted", padding: "md", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] }) }))] })), renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(SpecTable, { rows: specs })) : undefined, reviewsContent: _jsx(ReviewsListingPanel, { source: { kind: "product", productId: product.id }, stateMode: "local", context: "listing", initialData: initialReviews, emptyLabel: "No reviews yet \u2014 be the first to review this product." }), customTabs: toCustomSectionTabs(p.customSections) })), renderBuyBar: () => _jsx(Div, { id: "live-item-buy-bar", children: renderActions?.(product) }), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand, storeLabel: storeName ?? undefined })] })) }), _jsx(ListingBottomActions, { listingType: "live", anchorId: "live-item-buy-bar", price: price, currency: currency })] })] }));
+                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.LIVE), className: CLS_BREADCRUMB_LINK, children: "Live" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => _jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title }), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_LIVE_ITEM_BADGE, children: "Live Item" }), meta?.vendorVerified && (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Verified Seller" })), meta?.cites && (_jsxs(Span, { color: "warning", surface: "warning-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: ["CITES: ", meta.cites] }))] }), _jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: String(p.title ?? p.slug ?? p.id), storeId: p.storeId ? String(p.storeId) : undefined, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(String(p.id))) }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title }), meta?.species && (_jsxs(Text, { className: "italic mt-1", color: "muted", size: "sm", children: [meta.species, meta.sex && meta.sex !== "n/a" && ` · ${meta.sex}`, meta.ageMonths !== undefined && ` · ${meta.ageMonths}mo`] }))] }), price !== null && (_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { children: formatCurrency(price, currency) }) })), jurisdictions.length > 0 && (_jsxs(Div, { className: CLS_WARN_BOX, children: [_jsx(Text, { className: CLS_WARN_TITLE, children: "Delivery restrictions" }), _jsxs(Text, { className: CLS_WARN_BODY, children: ["This item can only be shipped to: ", jurisdictions.join(", ")] })] })), transport && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Transport" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Method: ", transport.method, transport.handlingFee !== undefined && (_jsx(PricesOnly, { children: ` · Handling: ${formatCurrency(transport.handlingFee, "INR")}` })), transport.insuranceIncluded && " · Insurance included"] })] })), meta?.careInfo && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Care information" }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-text-muted)]", children: meta.careInfo })] })), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { border: "subtle", rounded: "xl", surface: "muted", padding: "md", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] }) }))] })), renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(SpecTable, { rows: specs })) : undefined, reviewsContent: _jsx(ReviewsListingPanel, { source: { kind: "product", productId: product.id }, stateMode: "local", context: "listing", initialData: initialReviews, emptyLabel: "No reviews yet \u2014 be the first to review this product." }), customTabs: toCustomSectionTabs(p.customSections) })), renderBuyBar: () => _jsx(Div, { id: "live-item-buy-bar", children: renderActions?.(product) }), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand, storeLabel: storeName ?? undefined })] })) }), _jsx(ListingBottomActions, { listingType: "live", anchorId: "live-item-buy-bar", price: price, currency: currency })] })] }));
 }

package/dist/features/orders/actions/refund-actions.js

@@ -49,7 +49,6 @@ export async function issuePartialRefund(adminUid, orderId, deductFees, refundNo
             : `Your full refund of ₹${grossRefund} is being processed.`,
         relatedId: orderId,
         relatedType: "order",
-        orderWhatsappAddonPaid: order.whatsappNotifyAddon === true,
     });
     serverLogger.info("Admin partial refund initiated", {
         adminUid,

package/dist/features/orders/components/OrderAddonBadges.d.ts

@@ -2,7 +2,7 @@ import React from "react";
 /**
  * Icon badges for an order's paid add-ons and applied coupon.
  *
- * These are fulfilment instructions, not decoration: WhatsApp tells the
+ * These are fulfilment instructions, not decoration: gift wrap tells the
  * status-change notifier to message this buyer, gift wrap tells the packer to
  * wrap the parcel and enclose the message, and either protection changes how a
  * claim is handled. They are recorded on the order (and filterable in the
@@ -14,8 +14,6 @@ import React from "react";
  * at once instead of being wired per screen.
  */
 export interface OrderAddonBadgesOrder {
-    whatsappNotifyAddon?: boolean;
-    whatsappNotifyFee?: number;
     giftWrapAddon?: boolean;
     giftWrapFee?: number;
     giftWrapMessage?: string;

package/dist/features/orders/components/OrderAddonBadges.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Gift, MessageCircle, ShieldAlert, ShieldCheck, Tag } from "lucide-react";
+import { Gift, ShieldAlert, ShieldCheck, Tag } from "lucide-react";
 import { Row, Span, Stack, Text } from "../../../ui/index.js";
 import { formatCurrency } from "../../../utils/number.formatter.js";
 const CHIP_BASE = "inline-flex items-center gap-[var(--appkit-space-1)] rounded-full px-[var(--appkit-space-2)] py-[var(--appkit-space-0-5)] text-[length:var(--appkit-text-xs)] font-medium";
@@ -15,15 +15,14 @@ function Chip({ icon, label, tone, title, }) {
 export function OrderAddonBadges({ order, variant = "compact", showCoupon = true, currency = "INR", className = "", }) {
     const money = (v) => (typeof v === "number" && v > 0 ? formatCurrency(v, currency) : undefined);
     const hasCoupon = showCoupon && !!order.couponCode;
-    const hasAny = order.whatsappNotifyAddon ||
-        order.giftWrapAddon ||
+    const hasAny = order.giftWrapAddon ||
         order.shipmentProtectionAddon ||
         order.saleProtectionAddon ||
         hasCoupon;
     if (!hasAny)
         return null;
     const isDetail = variant === "detail";
-    return (_jsxs(Stack, { gap: "xs", className: `min-w-0 ${className}`, children: [_jsxs(Row, { gap: "xs", align: "center", wrap: true, className: "min-w-0", children: [order.whatsappNotifyAddon && (_jsx(Chip, { icon: _jsx(MessageCircle, { size: 12 }), label: isDetail && money(order.whatsappNotifyFee) ? `WhatsApp updates · ${money(order.whatsappNotifyFee)}` : "WhatsApp updates", tone: "success", title: "Buyer opted into WhatsApp order-status updates \u2014 status changes on this order should notify them on WhatsApp." })), order.giftWrapAddon && (_jsx(Chip, { icon: _jsx(Gift, { size: 12 }), label: isDetail && money(order.giftWrapFee) ? `Gift wrap · ${money(order.giftWrapFee)}` : "Gift wrap", tone: "brand", title: "This parcel must be gift-wrapped before dispatch." })), order.shipmentProtectionAddon && (_jsx(Chip, { icon: _jsx(ShieldCheck, { size: 12 }), label: isDetail && money(order.shipmentProtectionFee) ? `Protected · ${money(order.shipmentProtectionFee)}` : "Protected", tone: "info", title: "Shipment protection purchased \u2014 loss or damage in transit is covered, claimed against the held funds." })), order.saleProtectionAddon && (_jsx(Chip, { icon: _jsx(ShieldAlert, { size: 12 }), label: isDetail && money(order.saleProtectionFee) ? `Sale protected · ${money(order.saleProtectionFee)}` : "Sale protected", tone: "info", title: "Sale protection purchased \u2014 if the item is not as described the buyer is refunded, no questions asked." })), hasCoupon && (_jsx(Chip, { icon: _jsx(Tag, { size: 12 }), label: isDetail && money(order.couponDiscount)
+    return (_jsxs(Stack, { gap: "xs", className: `min-w-0 ${className}`, children: [_jsxs(Row, { gap: "xs", align: "center", wrap: true, className: "min-w-0", children: [order.giftWrapAddon && (_jsx(Chip, { icon: _jsx(Gift, { size: 12 }), label: isDetail && money(order.giftWrapFee) ? `Gift wrap · ${money(order.giftWrapFee)}` : "Gift wrap", tone: "brand", title: "This parcel must be gift-wrapped before dispatch." })), order.shipmentProtectionAddon && (_jsx(Chip, { icon: _jsx(ShieldCheck, { size: 12 }), label: isDetail && money(order.shipmentProtectionFee) ? `Protected · ${money(order.shipmentProtectionFee)}` : "Protected", tone: "info", title: "Shipment protection purchased \u2014 loss or damage in transit is covered, claimed against the held funds." })), order.saleProtectionAddon && (_jsx(Chip, { icon: _jsx(ShieldAlert, { size: 12 }), label: isDetail && money(order.saleProtectionFee) ? `Sale protected · ${money(order.saleProtectionFee)}` : "Sale protected", tone: "info", title: "Sale protection purchased \u2014 if the item is not as described the buyer is refunded, no questions asked." })), hasCoupon && (_jsx(Chip, { icon: _jsx(Tag, { size: 12 }), label: isDetail && money(order.couponDiscount)
                             ? `${order.couponCode} · −${money(order.couponDiscount)}`
                             : order.couponCode, tone: "success", title: `Coupon ${order.couponCode} applied to this order.` }))] }), isDetail && order.giftWrapAddon && order.giftWrapMessage && (_jsxs(Stack, { gap: "xs", className: "min-w-0", children: [_jsx(Text, { size: "xs", color: "muted", weight: "semibold", transform: "uppercase", className: "tracking-wide", children: "Gift message" }), _jsx(Text, { size: "sm", color: "primary", className: "min-w-0 whitespace-pre-wrap break-words", children: order.giftWrapMessage })] }))] }));
 }

package/dist/features/orders/components/OrderPaymentSummary.js

@@ -5,13 +5,26 @@ import { formatCurrency } from "../../../utils/number.formatter.js";
 const METHOD_LABEL = {
     manual: "Manual (Cash / UPI)",
     phonepe: "PhonePe",
+    razorpay: "Razorpay",
     cod: "Cash on Delivery",
 };
 function legacyFallback(order) {
     if (!order.paymentMethod)
         return null;
+    /*
+     * Only reached by orders written before `paymentRecord` existed, so the
+     * gateway behind a bare `paymentMethod: "online"` has to be inferred.
+     *
+     * 🛑 It is inferred as RAZORPAY, not PhonePe, and the reason is evidence
+     * rather than preference: PhonePe has never processed a payment in any
+     * environment — `payment.phonepeEnabled` has been false throughout and
+     * every PhonePe credential is still a placeholder — so no `online` order
+     * can be its. Every such order predates the Razorpay→PhonePe migration.
+     * Orders placed from now on carry a real `paymentRecord` naming the live
+     * gateway, so this inference never applies to them in either direction.
+     */
     const method = order.paymentMethod === "online"
-        ? "phonepe"
+        ? "razorpay"
         : order.paymentMethod === "cod"
             ? "cod"
             : "manual";
@@ -20,7 +33,7 @@ function legacyFallback(order) {
         transactionId: order.paymentTransactionId ?? order.paymentId,
         proofUrl: order.paymentProofUrl,
         amount: order.totalPrice,
-        verificationMethod: method === "phonepe" ? "order_status" : method === "cod" ? "cod_collection" : "manual_review",
+        verificationMethod: method === "cod" ? "cod_collection" : method === "manual" ? "manual_review" : "order_status",
     };
 }
 export function OrderPaymentSummary({ order, className = "" }) {

package/dist/features/orders/components/YourPurchaseStrip.d.ts

@@ -0,0 +1,24 @@
+export interface PurchaseContext {
+    order: {
+        id: string;
+        shortRef: string;
+        status: string;
+        orderDate: string | null;
+        trackHref: string;
+        detailHref: string;
+    } | null;
+    review: {
+        id: string;
+        rating: number;
+        status: string;
+    } | null;
+    windowDays: number;
+}
+export interface YourPurchaseStripProps {
+    productId: string;
+    /** Opens the review editor. Omit to render the review half as a link only. */
+    onEditReview?: (reviewId: string) => void;
+    onWriteReview?: () => void;
+    className?: string;
+}
+export declare function YourPurchaseStrip({ productId, onEditReview, onWriteReview, className, }: YourPurchaseStripProps): import("react").JSX.Element | null;

package/dist/features/orders/components/YourPurchaseStrip.js

@@ -0,0 +1,77 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * "You ordered this — track it" and "your review — edit it", on a product page.
+ *
+ * ── Why this exists ───────────────────────────────────────────────────────
+ *
+ * A buyer looking at an item they already own had no link to their own order
+ * and no link to their own review. Both records exist; nothing connected them
+ * to the product page, so the route was: remember you bought it, go to
+ * /user/orders, page through, find it.
+ *
+ * ── Three rules this component is built around ────────────────────────────
+ *
+ * 🛑 NO MONEY. An order total here would need the guest-price gate, and the
+ * strip is signed-in-only by construction — omitting the amount removes the
+ * question entirely rather than answering it carefully.
+ *
+ * 🛑 SAY THE WINDOW. The lookup is bounded to 90 days (see the route: order
+ * `items[]` holds objects, so there is no index for "order containing this
+ * product"). When nothing is found the copy is "No order in the last 90 days",
+ * never "you haven't bought this". A filtered empty result reported as an
+ * absolute zero is a lie the buyer cannot check — the same defect
+ * `UserOrdersView` carries a long comment about.
+ *
+ * 🛑 RENDER NOTHING UNTIL RESOLVED. Public product pages are ISR and read no
+ * session, so `loading` starts true on every hard load even for signed-in
+ * users. Showing the signed-out state first would flash "no order" at someone
+ * who has one.
+ *
+ * @tag domain:orders
+ * @tag layer:components
+ * @tag access:client
+ */
+import { useApiQuery } from "../../../client/api/useApiQuery.js";
+import { apiClient } from "../../../http/index.js";
+import { useOptionalSession } from "../../../react/contexts/SessionContext.js";
+import { ACTIONS } from "../../../_internal/shared/actions/action-registry.js";
+import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { ROUTES } from "../../../next/routing/route-map.js";
+import { Button, Div, Row, Span, Stack, Text, TextLink } from "../../../ui/index.js";
+import { Icon } from "../../../ui/components/Icon.js";
+import { formatDate } from "../../../utils/index.js";
+export function YourPurchaseStrip({ productId, onEditReview, onWriteReview, className = "", }) {
+    const session = useOptionalSession();
+    const signedIn = Boolean(session?.user?.uid);
+    const query = useApiQuery({
+        queryKey: ["user", "purchases", productId],
+        queryFn: async () => {
+            const res = await apiClient.get(ACCOUNT_ENDPOINTS.PURCHASE_CONTEXT(productId));
+            return (res?.data ?? { order: null, review: null, windowDays: 90 });
+        },
+        // Only ask once we know there is somebody to ask about.
+        enabled: signedIn,
+        staleTime: 60000,
+        silentBackgroundFailures: true,
+    });
+    /*
+     * A guest, or auth not yet resolved, renders nothing at all. There is no
+     * useful signed-out state here: "sign in to see your order" is noise on a
+     * page whose primary job is selling the item.
+     */
+    if (!session || session.loading || !signedIn)
+        return null;
+    if (query.isLoading || !query.data)
+        return null;
+    const { order, review, windowDays } = query.data;
+    // Nothing bought and nothing written — stay out of the way entirely.
+    if (!order && !review)
+        return null;
+    return (_jsx(Div, { surface: "muted", rounded: "xl", padding: "md", border: "subtle", className: className, children: _jsxs(Stack, { gap: "sm", children: [order ? (_jsxs(Row, { align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Icon, { name: "order", size: "sm", tone: "muted" }), _jsxs(Text, { size: "sm", children: ["You ordered this", order.orderDate ? ` on ${formatDate(order.orderDate)}` : "", " \u00B7", " ", _jsxs(Span, { className: "font-mono", children: ["#", order.shortRef] })] })] }), _jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Button, { asChild: true, variant: "outline", size: "sm", children: _jsx(TextLink, { href: order.trackHref, children: ACTIONS.USER["track-order"].label }) }), _jsx(Button, { asChild: true, variant: "ghost", size: "sm", children: _jsx(TextLink, { href: order.detailHref, children: ACTIONS.USER["view-order"].label }) })] })] })) : (
+                /*
+                 * 🛑 Bounded, and it says so. Not "you haven't bought this".
+                 */
+                _jsxs(Text, { size: "sm", color: "muted", children: ["No order for this item in the last ", windowDays, " days.", " ", _jsx(TextLink, { href: String(ROUTES.USER.ORDERS), children: "See all your orders" })] })), review ? (_jsxs(Row, { align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Icon, { name: "review", size: "sm", tone: "muted", filled: true }), _jsxs(Text, { size: "sm", children: ["Your review: ", review.rating, "/5", review.status !== "approved" ? ` · ${review.status}` : ""] })] }), onEditReview && (_jsx(Button, { variant: "outline", size: "sm", onClick: () => onEditReview(review.id), children: ACTIONS.REVIEW.edit.label }))] })) : (order &&
+                    onWriteReview && (_jsxs(Row, { align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsx(Text, { size: "sm", color: "muted", children: "You have not reviewed this yet." }), _jsx(Button, { variant: "outline", size: "sm", onClick: onWriteReview, children: ACTIONS.REVIEW.write.label })] })))] }) }));
+}

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

@@ -1,6 +1,5 @@
 export { OrderCard, OrdersList } from "./OrdersList";
 export { OrderAddonBadges, type OrderAddonBadgesOrder, type OrderAddonBadgesProps, } from "./OrderAddonBadges";
-export { MarketplaceOrderCard, type MarketplaceOrderCardLabels, type MarketplaceOrderCardLinks, type MarketplaceOrderCardOrder, type MarketplaceOrderCardProps, } from "./MarketplaceOrderCard";
 export { OrderFilters, ORDER_FILTER_KEYS, ORDER_ADMIN_SORT_OPTIONS, ORDER_SELLER_SORT_OPTIONS, ORDER_USER_SORT_OPTIONS, getOrderFilterKeys, getOrderSortOptions, } from "./OrderFilters";
 export type { OrderFiltersProps, OrderFilterVariant } from "./OrderFilters";
 export { OrderSiblingPayments } from "./OrderSiblingPayments";
@@ -13,3 +12,5 @@ export { RefundHistoryTable } from "./RefundHistoryTable";
 export type { RefundHistoryTableProps } from "./RefundHistoryTable";
 export { RefundRequestView } from "./RefundRequestView";
 export type { RefundRequestViewProps } from "./RefundRequestView";
+export { YourPurchaseStrip } from "./YourPurchaseStrip";
+export type { YourPurchaseStripProps, PurchaseContext } from "./YourPurchaseStrip";

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

@@ -1,9 +1,9 @@
 export { OrderCard, OrdersList } from "./OrdersList.js";
 export { OrderAddonBadges, } from "./OrderAddonBadges.js";
-export { MarketplaceOrderCard, } from "./MarketplaceOrderCard.js";
 export { OrderFilters, ORDER_FILTER_KEYS, ORDER_ADMIN_SORT_OPTIONS, ORDER_SELLER_SORT_OPTIONS, ORDER_USER_SORT_OPTIONS, getOrderFilterKeys, getOrderSortOptions, } from "./OrderFilters.js";
 export { OrderSiblingPayments } from "./OrderSiblingPayments.js";
 export { OrderPaymentSummary } from "./OrderPaymentSummary.js";
 export { OrderStatusTimeline } from "./OrderStatusTimeline.js";
 export { RefundHistoryTable } from "./RefundHistoryTable.js";
 export { RefundRequestView } from "./RefundRequestView.js";
+export { YourPurchaseStrip } from "./YourPurchaseStrip.js";

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

@@ -156,10 +156,6 @@ declare class OrderRepository extends BaseRepository<OrderDocument> {
             canFilter: boolean;
             canSort: boolean;
         };
-        whatsappNotifyAddon: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
         giftWrapAddon: {
             canFilter: boolean;
             canSort: boolean;
@@ -280,10 +276,6 @@ declare class OrderRepository extends BaseRepository<OrderDocument> {
             canFilter: boolean;
             canSort: boolean;
         };
-        whatsappNotifyAddon: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
         giftWrapAddon: {
             canFilter: boolean;
             canSort: boolean;

package/dist/features/orders/repository/orders.repository.js

@@ -722,7 +722,6 @@ OrderRepository.SELLER_SIEVE_FIELDS = {
     // Fulfilment flags. Filterable so "which of my orders need gift wrap?" is a
     // query against the orders themselves — the whole point of recording the
     // add-on on the order rather than keeping a side list of who asked for what.
-    whatsappNotifyAddon: { canFilter: true, canSort: false },
     giftWrapAddon: { canFilter: true, canSort: false },
     shipmentProtectionAddon: { canFilter: true, canSort: false },
     saleProtectionAddon: { canFilter: true, canSort: false },
@@ -755,7 +754,6 @@ OrderRepository.ADMIN_SIEVE_FIELDS = {
     // Same fulfilment flags as SELLER_SIEVE_FIELDS — admin needs to answer
     // "who opted into WhatsApp updates?" when a status change goes out, without
     // maintaining a parallel tracker.
-    whatsappNotifyAddon: { canFilter: true, canSort: false },
     giftWrapAddon: { canFilter: true, canSort: false },
     shipmentProtectionAddon: { canFilter: true, canSort: false },
     saleProtectionAddon: { canFilter: true, canSort: false },

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

@@ -304,6 +304,8 @@ export interface OrderRefundEvent {
     refundedBy: string;
     /** Set when PhonePe processed the refund. */
     phonepeRefundId?: string;
+    /** Set when Razorpay processed the refund (`rfnd_…`). Mutually exclusive with `phonepeRefundId` — one online gateway runs at a time. */
+    razorpayRefundId?: string;
     /** Set when refund was processed manually (offline). */
     manualTransactionId?: string;
     /** Proof document URL (via /api/media signed-URL flow). */
@@ -449,10 +451,6 @@ export interface OrderDocument extends BaseDocument {
     codRemainingAmount?: number;
     /** COD handling fee charged to the buyer: max(codHandlingFeeMin, subtotal × codHandlingFeePercent / 100). Only set when paymentMethod === "cod". */
     codHandlingFee?: number;
-    /** Buyer opted into WhatsApp order-update messages at checkout (unchecked by default). */
-    whatsappNotifyAddon?: boolean;
-    /** Fee charged for the WhatsApp addon, decimal rupees — snapshot of siteSettings.commissions.whatsappNotifyFee at order time. */
-    whatsappNotifyFee?: number;
     /** Buyer opted into gift wrapping at checkout (unchecked by default). */
     giftWrapAddon?: boolean;
     /** Fee charged for gift wrap, decimal rupees — snapshot of siteSettings.commissions.giftWrapFee at order time. */
@@ -743,23 +741,33 @@ export interface OrderDocument extends BaseDocument {
     /** Set true only when an automatic partial refund (for dropped Razorpay items) failed and needs manual follow-up. */
     refundPending?: boolean;
 }
-export type OrderPaymentRecordMethod = "manual" | "phonepe" | "cod";
+export type OrderPaymentRecordMethod = "manual" | "phonepe" | "razorpay" | "cod";
 export type OrderPaymentVerificationMethod = "manual_review" | "webhook" | "cod_collection" | "order_status";
 export interface OrderPaymentRecord {
     method: OrderPaymentRecordMethod;
-    /** UTR (manual) | PhonePe transactionId (phonepe) | collector note/ref (COD). */
+    /** UTR (manual) | PhonePe transactionId / Razorpay `pay_…` (gateway) | collector note/ref (COD). */
     transactionId?: string;
-    /** Manual proof upload | COD collection receipt photo (optional) | n/a for phonepe. */
+    /** Manual proof upload | COD collection receipt photo (optional) | n/a for a gateway. */
     proofUrl?: string;
     amount: number;
     paidAt?: Date;
-    /** Admin/seller uid (manual/COD) | "phonepe-order-status" or "phonepe-webhook" (phonepe, automatic). */
+    /** Admin/seller uid (manual/COD) | "{gateway}-order-status" or "{gateway}-webhook" (automatic). */
     verifiedBy?: string;
     verificationMethod: OrderPaymentVerificationMethod;
-    /** PhonePe audit trail only. */
+    /**
+     * Gateway audit trail only.
+     *
+     * `merchantOrderId` is the id this codebase stores as `order.paymentId` and
+     * keys every lookup on, whichever gateway is live — PhonePe's own
+     * `merchantOrderId`, or Razorpay's `order_…`. The provider-specific fields
+     * below record the gateway's extra ids when it has them.
+     */
     gatewayRef?: {
         merchantOrderId?: string;
         phonepeOrderId?: string;
+        razorpayOrderId?: string;
+        /** Razorpay's payment id (`pay_…`) — the key its refund API needs. */
+        razorpayPaymentId?: string;
         transactionId?: string;
     };
 }

package/dist/features/orders/types/index.d.ts

@@ -216,15 +216,12 @@ export interface Order {
     /**
      * Paid add-ons the buyer opted into for THIS order (= this store).
      *
-     * These are operational flags, not just billing records: `whatsappNotifyAddon`
-     * is what the status-change notifier checks to decide whether to send a
-     * WhatsApp message, and `giftWrapAddon`/`shipmentProtectionAddon` are what
+     * These are operational flags, not just billing records:
+     * `giftWrapAddon`/`shipmentProtectionAddon` are what
      * the packer needs to see before dispatch. They live on the order itself and
      * are filterable (`orders` SIEVE_FIELDS) precisely so nobody has to keep a
      * separate list of who asked for what.
      */
-    whatsappNotifyAddon?: boolean;
-    whatsappNotifyFee?: number;
     giftWrapAddon?: boolean;
     giftWrapFee?: number;
     /** The buyer's gift message — the packer has to physically include this. */

package/dist/features/orders/utils/order-announcement-message.d.ts

@@ -0,0 +1,18 @@
+export interface PurchaseAnnouncementInput {
+    buyerName: string;
+    firstItemName: string;
+    /** 0 if only one item in the order */
+    additionalItemCount: number;
+    /** Total order amount in decimal rupees */
+    totalAmount: number;
+    orderId: string;
+}
+/**
+ * Plain-text body for the "New order placed" staff notification row.
+ *
+ * Originally built for the WhatsApp purchase announcement. That integration
+ * was removed 2026-10-20, but the builder survives because its output is now
+ * the `adminNotifications` body the admin inbox renders and the daily digest
+ * counts — a durable record rather than a per-admin blast.
+ */
+export declare function buildPurchaseAnnouncementMessage(input: PurchaseAnnouncementInput): string;

package/dist/features/orders/utils/order-announcement-message.js

@@ -0,0 +1,16 @@
+/**
+ * Plain-text body for the "New order placed" staff notification row.
+ *
+ * Originally built for the WhatsApp purchase announcement. That integration
+ * was removed 2026-10-20, but the builder survives because its output is now
+ * the `adminNotifications` body the admin inbox renders and the daily digest
+ * counts — a durable record rather than a per-admin blast.
+ */
+export function buildPurchaseAnnouncementMessage(input) {
+    const { buyerName, firstItemName, additionalItemCount, totalAmount, orderId } = input;
+    const extra = additionalItemCount > 0
+        ? ` + ${additionalItemCount} more item${additionalItemCount > 1 ? "s" : ""}`
+        : "";
+    const amount = totalAmount.toLocaleString("en-IN");
+    return `🛍️ New order! ${buyerName} purchased ${firstItemName}${extra} for ₹${amount}. Order #${orderId}`;
+}

package/dist/features/orders/utils/payment-proof-message.d.ts

@@ -0,0 +1,20 @@
+export interface PaymentProofReviewMessageInput {
+    orderId: string;
+    buyerName: string;
+    productTitle: string;
+    totalAmount: number;
+    reviewUrl: string;
+}
+/**
+ * Tier PP — message body for the buyer/seller "share for review" `wa.me`
+ * link on the order payment page.
+ *
+ * Pure string builder with no crypto and no network, so it is safe to export
+ * from the client-safe barrel. It used to live beside the WhatsApp Cloud API
+ * senders in `features/whatsapp-bot/`, isolated into its own file precisely
+ * because those siblings carried a top-level `import { createHmac } from
+ * "crypto"`. The Cloud API integration was removed 2026-10-20; this builder
+ * survived because it feeds an ordinary `wa.me` deep link, which needs no
+ * token, no registered number and no Meta billing relationship.
+ */
+export declare function buildPaymentProofReviewMessage(input: PaymentProofReviewMessageInput): string;

package/dist/features/orders/utils/payment-proof-message.js

@@ -0,0 +1,17 @@
+/**
+ * Tier PP — message body for the buyer/seller "share for review" `wa.me`
+ * link on the order payment page.
+ *
+ * Pure string builder with no crypto and no network, so it is safe to export
+ * from the client-safe barrel. It used to live beside the WhatsApp Cloud API
+ * senders in `features/whatsapp-bot/`, isolated into its own file precisely
+ * because those siblings carried a top-level `import { createHmac } from
+ * "crypto"`. The Cloud API integration was removed 2026-10-20; this builder
+ * survived because it feeds an ordinary `wa.me` deep link, which needs no
+ * token, no registered number and no Meta billing relationship.
+ */
+export function buildPaymentProofReviewMessage(input) {
+    const { orderId, buyerName, productTitle, totalAmount, reviewUrl } = input;
+    const amount = totalAmount.toLocaleString("en-IN");
+    return `💳 Payment proof submitted! ${buyerName} uploaded proof for "${productTitle}" (₹${amount}). Order #${orderId}. Please review within 2 hours or it auto-confirms: ${reviewUrl}`;
+}