@mohasinac/appkit 4.53.1 → 4.54.0-next.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

@@ -24,6 +24,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 +45,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 ?? [];

package/dist/features/media/messages/en.json

@@ -1,67 +1,67 @@
-{
-  "mediaEditor": {
-    "cropTitle": "Crop Image",
-    "cropInstruction": "Drag to reposition. Use the zoom slider or +/- keys to zoom.",
-    "cropPreviewAlt": "Preview",
-    "cropZoom": "Zoom",
-    "cropZoomIn": "Zoom in",
-    "cropZoomOut": "Zoom out",
-    "cropRotateLeft": "Rotate left 90°",
-    "cropRotateRight": "Rotate right 90°",
-    "cropFlipH": "Flip horizontally",
-    "cropFlipV": "Flip vertically",
-    "cropWarningTitle": "Low zoom",
-    "cropWarningMessage": "Zoom in for better quality.",
-    "cropPosition": "Position",
-    "cropReset": "Reset",
-    "cropSave": "Save Crop",
-    "cropCancel": "Cancel",
-    "trimTitle": "Trim Video",
-    "trimInstruction": "Set the start and end times, then click Trim.",
-    "trimStart": "Start",
-    "trimEnd": "End",
-    "trimDuration": "Duration: {duration}s",
-    "trimQuality": "Quality",
-    "trimQualityLow": "Low",
-    "trimQualityMedium": "Medium",
-    "trimQualityHigh": "High",
-    "trimSave": "Trim Video",
-    "trimSkip": "Skip",
-    "trimming": "Trimming…",
-    "thumbnailTitle": "Select Thumbnail",
-    "thumbnailInstruction": "Seek to the frame you want to use as the thumbnail.",
-    "thumbnailCapture": "Use This Frame",
-    "thumbnailSkip": "Skip",
-    "thumbnailCapturing": "Capturing…",
-    "thumbnailUploading": "Uploading…",
-    "cropSuccess": "Image cropped",
-    "trimSuccess": "Video trimmed",
-    "thumbnailSuccess": "Thumbnail saved",
-    "cropError": "Failed to crop image",
-    "trimError": "Failed to trim video",
-    "thumbnailError": "Failed to capture thumbnail",
-    "editImage": "Edit / Crop",
-    "editVideo": "Trim / Thumbnail"
-  },
-  "camera": {
-    "takePhoto": "Take Photo",
-    "startRecording": "Start Recording",
-    "stopRecording": "Stop Recording",
-    "flipCamera": "Flip Camera",
-    "switchToCamera": "Use Camera",
-    "switchToUpload": "Upload File",
-    "cameraError": "Camera unavailable",
-    "permissionDenied": "Camera permission denied. Please allow access in your browser settings.",
-    "notSupported": "Camera is not supported on this device",
-    "starting": "Starting camera..."
-  },
-  "upload": {
-    "change": "Change",
-    "remove": "Remove",
-    "clickToUpload": "Click to upload",
-    "uploading": "Uploading…",
-    "uploadingProgress": "Uploading {progress}%…",
-    "replaceFile": "Replace file",
-    "chooseFile": "Choose file to upload"
-  }
-}
+{
+  "mediaEditor": {
+    "cropTitle": "Crop Image",
+    "cropInstruction": "Drag to reposition. Use the zoom slider or +/- keys to zoom.",
+    "cropPreviewAlt": "Preview",
+    "cropZoom": "Zoom",
+    "cropZoomIn": "Zoom in",
+    "cropZoomOut": "Zoom out",
+    "cropRotateLeft": "Rotate left 90°",
+    "cropRotateRight": "Rotate right 90°",
+    "cropFlipH": "Flip horizontally",
+    "cropFlipV": "Flip vertically",
+    "cropWarningTitle": "Low zoom",
+    "cropWarningMessage": "Zoom in for better quality.",
+    "cropPosition": "Position",
+    "cropReset": "Reset",
+    "cropSave": "Save Crop",
+    "cropCancel": "Cancel",
+    "trimTitle": "Trim Video",
+    "trimInstruction": "Set the start and end times, then click Trim.",
+    "trimStart": "Start",
+    "trimEnd": "End",
+    "trimDuration": "Duration: {duration}s",
+    "trimQuality": "Quality",
+    "trimQualityLow": "Low",
+    "trimQualityMedium": "Medium",
+    "trimQualityHigh": "High",
+    "trimSave": "Trim Video",
+    "trimSkip": "Skip",
+    "trimming": "Trimming…",
+    "thumbnailTitle": "Select Thumbnail",
+    "thumbnailInstruction": "Seek to the frame you want to use as the thumbnail.",
+    "thumbnailCapture": "Use This Frame",
+    "thumbnailSkip": "Skip",
+    "thumbnailCapturing": "Capturing…",
+    "thumbnailUploading": "Uploading…",
+    "cropSuccess": "Image cropped",
+    "trimSuccess": "Video trimmed",
+    "thumbnailSuccess": "Thumbnail saved",
+    "cropError": "Failed to crop image",
+    "trimError": "Failed to trim video",
+    "thumbnailError": "Failed to capture thumbnail",
+    "editImage": "Edit / Crop",
+    "editVideo": "Trim / Thumbnail"
+  },
+  "camera": {
+    "takePhoto": "Take Photo",
+    "startRecording": "Start Recording",
+    "stopRecording": "Stop Recording",
+    "flipCamera": "Flip Camera",
+    "switchToCamera": "Use Camera",
+    "switchToUpload": "Upload File",
+    "cameraError": "Camera unavailable",
+    "permissionDenied": "Camera permission denied. Please allow access in your browser settings.",
+    "notSupported": "Camera is not supported on this device",
+    "starting": "Starting camera..."
+  },
+  "upload": {
+    "change": "Change",
+    "remove": "Remove",
+    "clickToUpload": "Click to upload",
+    "uploading": "Uploading…",
+    "uploadingProgress": "Uploading {progress}%…",
+    "replaceFile": "Replace file",
+    "chooseFile": "Choose file to upload"
+  }
+}

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/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}`;
+}