@mohasinac/appkit 3.4.8 → 3.5.0

package/dist/features/media/upload/MediaUploadList.js

@@ -9,7 +9,7 @@ import { normalizeError } from "../../../errors/normalize";
 const __O = {
     hidden: "overflow-hidden",
 };
-const CLS_PDF_LINK = "text-sm underline break-all text-info dark:text-info";
+const CLS_PDF_LINK = "text-[length:var(--appkit-text-sm)] underline break-all text-info dark:text-info";
 function fileNameFromUrl(url) {
     try {
         const parts = new URL(url).pathname.split("/");

package/dist/features/messages/hooks/useConversation.js

@@ -14,6 +14,7 @@ import { getClientRealtimeProvider } from "../../../contracts/client-realtime";
 import { conversationPingPath, userConversationsPingPath, } from "../realtime";
 import { normalizeError } from "../../../errors/normalize";
 import { apiClient, ApiClientError } from "../../../http/ApiClient";
+import { CONVERSATION_ENDPOINTS } from "../../../constants/api-endpoints";
 /**
  * @deprecated Re-exported for backwards compat — import `conversationPingPath`
  * from `@mohasinac/appkit` instead.
@@ -24,9 +25,9 @@ export const CONVERSATIONS_PING_PATH = conversationPingPath;
  * `userConversationsPingPath` from `@mohasinac/appkit` instead.
  */
 export const CONVERSATIONS_PING_USER_PATH = userConversationsPingPath;
-const DETAIL_ENDPOINT = (id) => `/api/user/conversations/${encodeURIComponent(id)}`;
-const SEND_ENDPOINT = (id) => `/api/user/conversations/${encodeURIComponent(id)}/messages`;
-const READ_ENDPOINT = (id) => `/api/user/conversations/${encodeURIComponent(id)}/read`;
+const DETAIL_ENDPOINT = CONVERSATION_ENDPOINTS.BY_ID;
+const SEND_ENDPOINT = CONVERSATION_ENDPOINTS.MESSAGES;
+const READ_ENDPOINT = CONVERSATION_ENDPOINTS.READ;
 async function fetchDetail(id) {
     try {
         return await apiClient.get(DETAIL_ENDPOINT(id));

package/dist/features/messages/hooks/useConversations.js

@@ -9,7 +9,8 @@ import { getClientRealtimeProvider } from "../../../contracts/client-realtime";
 import { userConversationsPingPath } from "../realtime";
 import { normalizeError } from "../../../errors/normalize";
 import { apiClient } from "../../../http/ApiClient";
-const LIST_ENDPOINT = "/api/user/conversations";
+import { CONVERSATION_ENDPOINTS } from "../../../constants/api-endpoints";
+const LIST_ENDPOINT = CONVERSATION_ENDPOINTS.LIST;
 async function fetchList() {
     const data = await apiClient.get(LIST_ENDPOINT);
     return data.items ?? [];

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

@@ -108,15 +108,15 @@ export declare const conversationFirestoreSchema: z.ZodObject<{
     status: z.ZodEnum<["active", "archived", "blocked"]>;
 }, "strip", z.ZodTypeAny, {
     status: "archived" | "active" | "blocked";
-    storeId: string;
+    id: string;
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    storeName: string;
-    id: string;
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
+    storeId: string;
+    storeName: string;
     messages: {
         id: string;
         body: string;
@@ -141,15 +141,15 @@ export declare const conversationFirestoreSchema: z.ZodObject<{
     productTitle?: string | undefined;
 }, {
     status: "archived" | "active" | "blocked";
-    storeId: string;
+    id: string;
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    storeName: string;
-    id: string;
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
+    storeId: string;
+    storeName: string;
     messages: {
         id: string;
         body: string;

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

@@ -6,7 +6,7 @@ import { BaseListingCard, Button, Caption, Row, Span, Stack, StatusBadge, Text,
 import { formatCurrency, formatDate } from "../../../utils";
 import { OrderStatusValues } from "../schemas";
 import { useLongPress } from "../../../react/hooks/useLongPress";
-const CLS_ACTION_BUTTON = "min-w-0 flex-1 px-2 text-xs";
+const CLS_ACTION_BUTTON = "min-w-0 flex-1 px-[var(--appkit-space-2)] text-[length:var(--appkit-text-xs)]";
 const STATUS_MAP = {
     pending: "pending",
     confirmed: "info",

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

@@ -0,0 +1,16 @@
+/**
+ * OrderPaymentSummary — the single place both admin and seller order-detail
+ * views render payment info from, regardless of how the buyer paid (manual
+ * cash/UPI proof, Razorpay, or COD). Reads `order.paymentRecord` when present;
+ * falls back to an adapter over the pre-existing legacy fields
+ * (`paymentMethod`/`paymentId`/`paymentProofUrl`/`paymentTransactionId`) for
+ * orders placed before Feature C shipped, so old orders keep rendering
+ * correctly instead of showing a blank/broken Payment section.
+ */
+import React from "react";
+import type { OrderDocument } from "../schemas";
+export interface OrderPaymentSummaryProps {
+    order: OrderDocument;
+    className?: string;
+}
+export declare function OrderPaymentSummary({ order, className }: OrderPaymentSummaryProps): React.JSX.Element;

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

@@ -0,0 +1,32 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Badge, Div, Heading, Row, Stack, Text } from "../../../ui";
+import { formatCurrency } from "../../../utils/number.formatter";
+const METHOD_LABEL = {
+    manual: "Manual (Cash / UPI)",
+    razorpay: "Razorpay",
+    cod: "Cash on Delivery",
+};
+function legacyFallback(order) {
+    if (!order.paymentMethod)
+        return null;
+    const method = order.paymentMethod === "razorpay" || order.paymentMethod === "online"
+        ? "razorpay"
+        : order.paymentMethod === "cod"
+            ? "cod"
+            : "manual";
+    return {
+        method,
+        transactionId: order.paymentTransactionId ?? order.paymentId,
+        proofUrl: order.paymentProofUrl,
+        amountPaise: order.totalPrice,
+        verificationMethod: method === "razorpay" ? "webhook" : method === "cod" ? "cod_collection" : "manual_review",
+    };
+}
+export function OrderPaymentSummary({ order, className = "" }) {
+    const record = order.paymentRecord ?? legacyFallback(order);
+    if (!record) {
+        return (_jsx(Div, { className: className, rounded: "xl", padding: "md", surface: "muted", border: "default", children: _jsx(Text, { size: "sm", color: "muted", children: "No payment information recorded yet." }) }));
+    }
+    return (_jsxs(Div, { className: className, rounded: "xl", padding: "md", surface: "muted", border: "default", children: [_jsxs(Row, { justify: "between", align: "center", className: "mb-2", children: [_jsx(Heading, { level: 3, size: "sm", weight: "semibold", color: "muted", children: "Payment" }), _jsx(Badge, { variant: order.paymentStatus === "paid" ? "success" : "default", children: order.paymentStatus ?? "pending" })] }), _jsxs(Stack, { gap: "xs", children: [_jsxs(Row, { justify: "between", children: [_jsx(Text, { size: "sm", color: "muted", children: "Method" }), _jsx(Text, { size: "sm", weight: "medium", children: METHOD_LABEL[record.method] })] }), _jsxs(Row, { justify: "between", children: [_jsx(Text, { size: "sm", color: "muted", children: "Amount" }), _jsx(Text, { size: "sm", weight: "medium", children: formatCurrency(record.amountPaise / 100, order.currency ?? "INR") })] }), record.transactionId && (_jsxs(Row, { justify: "between", children: [_jsx(Text, { size: "sm", color: "muted", children: "Reference" }), _jsx(Text, { size: "sm", weight: "medium", children: record.transactionId })] })), record.paidAt && (_jsxs(Row, { justify: "between", children: [_jsx(Text, { size: "sm", color: "muted", children: "Paid at" }), _jsx(Text, { size: "sm", children: new Date(record.paidAt).toLocaleString() })] })), record.verifiedBy && (_jsxs(Row, { justify: "between", children: [_jsx(Text, { size: "sm", color: "muted", children: "Verified by" }), _jsx(Text, { size: "sm", children: record.verifiedBy })] })), record.gatewayRef?.paymentId && (_jsxs(Row, { justify: "between", children: [_jsx(Text, { size: "sm", color: "muted", children: "Gateway payment ID" }), _jsx(Text, { size: "sm", children: record.gatewayRef.paymentId })] }))] })] }));
+}

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

@@ -11,6 +11,6 @@ export function OrderSiblingPayments({ siblings, currentOrderId, className = "",
         return null;
     return (_jsxs(Div, { className: `${className}`, rounded: "xl", padding: "md", surface: "muted", border: "default", children: [_jsx(Heading, { level: 3, className: "mb-3", color: "muted", size: "sm", weight: "semibold", children: REFUND_COPY.siblingPayments.heading(others.length) }), _jsx(Stack, { gap: "xs", children: others.map((o) => {
                     const href = String(ROUTES.USER.ORDER_DETAIL(o.id));
-                    return (_jsxs(Row, { justify: "between", align: "center", gap: "sm", children: [_jsx(Link, { href: href, className: "text-sm font-medium text-[color:var(--appkit-color-primary)] hover:underline", children: o.id }), _jsxs(Row, { gap: "sm", align: "center", children: [_jsx(Text, { size: "xs", color: "muted", transform: "capitalize", children: o.status }), _jsx(Text, { size: "xs", weight: "semibold", children: formatCurrency(o.totalPrice / 100, o.currency ?? "INR") })] })] }, o.id));
+                    return (_jsxs(Row, { justify: "between", align: "center", gap: "sm", children: [_jsx(Link, { href: href, className: "text-[length:var(--appkit-text-sm)] font-medium text-[color:var(--appkit-color-primary)] hover:underline", children: o.id }), _jsxs(Row, { gap: "sm", align: "center", children: [_jsx(Text, { size: "xs", color: "muted", transform: "capitalize", children: o.status }), _jsx(Text, { size: "xs", weight: "semibold", children: formatCurrency(o.totalPrice / 100, o.currency ?? "INR") })] })] }, o.id));
                 }) })] }));
 }

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

@@ -1,10 +1,13 @@
+import type React from "react";
 import type { Order } from "../types";
 interface OrderCardProps {
     order: Order;
     onClick?: (order: Order) => void;
     labels?: Record<string, string>;
+    /** Optional quick-action slot (e.g. Track/Cancel) rendered in the card footer — click-reduction so buyers don't have to open the detail page for a single action. */
+    renderActions?: (order: Order) => React.ReactNode;
 }
-export declare function OrderCard({ order, onClick, labels }: OrderCardProps): import("react").JSX.Element;
+export declare function OrderCard({ order, onClick, labels, renderActions }: OrderCardProps): React.JSX.Element;
 interface OrdersListProps {
     orders: Order[];
     isLoading?: boolean;
@@ -13,6 +16,8 @@ interface OrdersListProps {
     currentPage?: number;
     onPageChange?: (page: number) => void;
     emptyLabel?: string;
+    /** Optional per-card quick-action slot (e.g. Track/Cancel) — see OrderCardProps.renderActions. */
+    renderActions?: (order: Order) => React.ReactNode;
 }
-export declare function OrdersList({ orders, isLoading, onOrderClick, totalPages, currentPage, onPageChange, emptyLabel, }: OrdersListProps): import("react").JSX.Element;
+export declare function OrdersList({ orders, isLoading, onOrderClick, totalPages, currentPage, onPageChange, emptyLabel, renderActions, }: OrdersListProps): React.JSX.Element;
 export {};

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

@@ -3,7 +3,7 @@ import { Div, Pagination, Row, Span, Stack, Text } from "../../../ui";
 import { MediaImage } from "../../media/MediaImage";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { getDefaultLocale } from "../../../core/baseline-resolver";
-const CLS_PRIZE_BADGE = "inline-flex items-center rounded-full bg-fuchsia-100 dark:bg-fuchsia-900/30 px-2.5 py-0.5 text-fuchsia-700 dark:text-fuchsia-300";
+const CLS_PRIZE_BADGE = "inline-flex items-center rounded-full bg-fuchsia-100 dark:bg-fuchsia-900/30 px-[var(--appkit-space-2-5)] py-[var(--appkit-space-0-5)] text-fuchsia-700 dark:text-fuchsia-300";
 const STATUS_COLORS = {
     pending: "bg-warning-surface text-warning",
     confirmed: "bg-info-surface text-info",
@@ -15,7 +15,7 @@ const STATUS_COLORS = {
     return_requested: "bg-warning-surface text-warning",
     returned: "bg-[var(--appkit-color-surface)] text-[var(--appkit-color-text-muted)] bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text-muted)]",
 };
-export function OrderCard({ order, onClick, labels = {} }) {
+export function OrderCard({ order, onClick, labels = {}, renderActions }) {
     const date = order.createdAt
         ? new Date(order.createdAt).toLocaleDateString(getDefaultLocale(), {
             year: "numeric",
@@ -35,14 +35,14 @@ export function OrderCard({ order, onClick, labels = {} }) {
         .sort()[0];
     return (_jsxs(Div, { padding: "5", role: onClick ? "button" : undefined, tabIndex: onClick ? 0 : undefined, onKeyDown: onClick
             ? (e) => (e.key === "Enter" || e.key === " ") && onClick(order)
-            : undefined, onClick: onClick ? () => onClick(order) : undefined, className: `border border-neutral-200 ${onClick ? "cursor-pointer transition hover:shadow-md" : ""}`, rounded: "xl", surface: "default", children: [_jsxs(Row, { wrap: true, align: "start", justify: "between", gap: "3", children: [_jsxs(Div, { children: [_jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "xs", children: ["Order #", order.id.slice(-8).toUpperCase()] }), date && (_jsx(Text, { className: "mt-0.5", color: "faint", size: "xs", children: date }))] }), _jsx(Span, { size: "xs", weight: "semibold", className: `capitalize ${statusColor}`, rounded: "full", padding: "pill-md", children: labels[order.orderStatus] ?? order.orderStatus.replace(/_/g, " ") })] }), revealsRemaining > 0 && (_jsxs(Row, { gap: "sm", className: "mt-2", children: [_jsxs(Span, { size: "xs", weight: "semibold", className: CLS_PRIZE_BADGE, children: [revealsRemaining, " ", revealsRemaining === 1 ? "reveal" : "reveals", " pending"] }), earliestDeadline && (_jsxs(Span, { size: "xs", color: "muted", children: ["before ", new Date(earliestDeadline).toLocaleDateString(getDefaultLocale(), { month: "short", day: "numeric" })] }))] })), _jsxs(Row, { wrap: true, gap: "3", className: "mt-4", children: [order.items.slice(0, 3).map((item, i) => (_jsxs(Row, { gap: "sm", children: [item.image && (_jsx(Div, { className: "relative h-10 w-10 flex-shrink-0", rounded: "lg", overflow: "hidden", children: _jsx(MediaImage, { src: item.image, alt: item.title, size: "thumbnail" }) })), _jsxs(Div, { children: [_jsx(Text, { truncate: true, size: "sm", weight: "medium", color: "primary", children: item.title }), _jsxs(Text, { size: "xs", color: "faint", children: ["\u00D7", item.quantity] })] })] }, i))), order.items.length > 3 && (_jsxs(Span, { size: "xs", className: "self-center", color: "faint", children: ["+", order.items.length - 3, " more"] }))] }), _jsxs(Row, { justify: "between", className: "mt-4 border-t border-neutral-100", padding: "t-sm", children: [_jsxs(Span, { size: "sm", className: "text-[var(--appkit-color-text-muted)]", children: [order.currency ?? "", " Total"] }), _jsx(Span, { weight: "semibold", className: "text-[var(--appkit-color-text)]", children: formatCurrency(order.total, order.currency) })] })] }));
+            : undefined, onClick: onClick ? () => onClick(order) : undefined, className: `border border-neutral-200 ${onClick ? "cursor-pointer transition hover:shadow-md" : ""}`, rounded: "xl", surface: "default", children: [_jsxs(Row, { wrap: true, align: "start", justify: "between", gap: "3", children: [_jsxs(Div, { children: [_jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "xs", children: ["Order #", order.id.slice(-8).toUpperCase()] }), date && (_jsx(Text, { className: "mt-0.5", color: "faint", size: "xs", children: date }))] }), _jsx(Span, { size: "xs", weight: "semibold", className: `capitalize ${statusColor}`, rounded: "full", padding: "pill-md", children: labels[order.orderStatus] ?? order.orderStatus.replace(/_/g, " ") })] }), revealsRemaining > 0 && (_jsxs(Row, { gap: "sm", className: "mt-2", children: [_jsxs(Span, { size: "xs", weight: "semibold", className: CLS_PRIZE_BADGE, children: [revealsRemaining, " ", revealsRemaining === 1 ? "reveal" : "reveals", " pending"] }), earliestDeadline && (_jsxs(Span, { size: "xs", color: "muted", children: ["before ", new Date(earliestDeadline).toLocaleDateString(getDefaultLocale(), { month: "short", day: "numeric" })] }))] })), _jsxs(Row, { wrap: true, gap: "3", className: "mt-4", children: [order.items.slice(0, 3).map((item, i) => (_jsxs(Row, { gap: "sm", children: [item.image && (_jsx(Div, { className: "relative h-10 w-10 flex-shrink-0", rounded: "lg", overflow: "hidden", children: _jsx(MediaImage, { src: item.image, alt: item.title, size: "thumbnail" }) })), _jsxs(Div, { children: [_jsx(Text, { truncate: true, size: "sm", weight: "medium", color: "primary", children: item.title }), _jsxs(Text, { size: "xs", color: "faint", children: ["\u00D7", item.quantity] })] })] }, i))), order.items.length > 3 && (_jsxs(Span, { size: "xs", className: "self-center", color: "faint", children: ["+", order.items.length - 3, " more"] }))] }), _jsxs(Row, { justify: "between", className: "mt-4 border-t border-neutral-100", padding: "t-sm", children: [_jsxs(Span, { size: "sm", className: "text-[var(--appkit-color-text-muted)]", children: [order.currency ?? "", " Total"] }), _jsx(Span, { weight: "semibold", className: "text-[var(--appkit-color-text)]", children: formatCurrency(order.total, order.currency) })] }), renderActions && (_jsx(Row, { justify: "end", gap: "sm", className: "mt-3", onClick: (e) => e.stopPropagation(), children: renderActions(order) }))] }));
 }
-export function OrdersList({ orders, isLoading, onOrderClick, totalPages = 1, currentPage = 1, onPageChange, emptyLabel = "No orders found", }) {
+export function OrdersList({ orders, isLoading, onOrderClick, totalPages = 1, currentPage = 1, onPageChange, emptyLabel = "No orders found", renderActions, }) {
     if (isLoading) {
         return (_jsx(Stack, { gap: "md", children: Array.from({ length: 3 }).map((_, i) => (_jsxs(Div, { padding: "5", className: "animate-pulse border border-neutral-200", rounded: "xl", children: [_jsxs(Row, { justify: "between", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Div, { className: "h-3 w-20 bg-neutral-200", rounded: "default" }), _jsx(Div, { className: "h-3 w-16 bg-neutral-200", rounded: "default" })] }), _jsx(Div, { className: "h-6 w-20 bg-neutral-200", rounded: "full" })] }), _jsxs(Div, { layout: "flex", gap: "3", className: "mt-4", children: [_jsx(Div, { className: "h-10 w-10 bg-neutral-200", rounded: "lg" }), _jsx(Div, { className: "h-10 w-10 bg-neutral-200", rounded: "lg" })] })] }, i))) }));
     }
     if (orders.length === 0) {
         return (_jsx(Text, { paddingY: "3xl", color: "muted", size: "sm", align: "center", children: emptyLabel }));
     }
-    return (_jsxs(Stack, { gap: "lg", children: [_jsx(Stack, { gap: "md", children: orders.map((order) => (_jsx(OrderCard, { order: order, onClick: onOrderClick }, order.id))) }), totalPages > 1 && onPageChange && (_jsx(Row, { justify: "center", children: _jsx(Pagination, { currentPage: currentPage, totalPages: totalPages, onPageChange: onPageChange }) }))] }));
+    return (_jsxs(Stack, { gap: "lg", children: [_jsx(Stack, { gap: "md", children: orders.map((order) => (_jsx(OrderCard, { order: order, onClick: onOrderClick, renderActions: renderActions }, order.id))) }), totalPages > 1 && onPageChange && (_jsx(Row, { justify: "center", children: _jsx(Pagination, { currentPage: currentPage, totalPages: totalPages, onPageChange: onPageChange }) }))] }));
 }

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

@@ -3,7 +3,7 @@ import { Badge, Div, Heading, Row, Stack, Text } from "../../../ui";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { REFUND_COPY } from "../../../_internal/shared/features/orders/refund-copy";
 const __P = {
-    p4: "p-4",
+    p4: "p-[var(--appkit-space-4)]",
 };
 function formatDate(d) {
     const dt = d instanceof Date ? d : new Date(d);

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

@@ -17,7 +17,7 @@ import { REFUND_COPY } from "../../../_internal/shared/features/orders/refund-co
 import { formatCurrency } from "../../../utils/number.formatter";
 import { normalizeError } from "../../../errors/normalize";
 const ACK_COUNT = REFUND_COPY.request.acknowledgments.length;
-const CLS_WARN_PANEL = "rounded-xl border border-warning bg-warning-surface p-4 dark:border-warning";
+const CLS_WARN_PANEL = "rounded-xl border border-warning bg-warning-surface p-[var(--appkit-space-4)] dark:border-warning";
 export function RefundRequestView({ order, onSubmitRequest, isLoading = false, className = "", }) {
     const [acknowledged, setAcknowledged] = useState(Array(ACK_COUNT).fill(false));
     const [reason, setReason] = useState("");

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

@@ -4,6 +4,8 @@ export { OrderFilters, ORDER_FILTER_KEYS, ORDER_ADMIN_SORT_OPTIONS, ORDER_SELLER
 export type { OrderFiltersProps, OrderFilterVariant } from "./OrderFilters";
 export { OrderSiblingPayments } from "./OrderSiblingPayments";
 export type { OrderSiblingPaymentsProps } from "./OrderSiblingPayments";
+export { OrderPaymentSummary } from "./OrderPaymentSummary";
+export type { OrderPaymentSummaryProps } from "./OrderPaymentSummary";
 export { RefundHistoryTable } from "./RefundHistoryTable";
 export type { RefundHistoryTableProps } from "./RefundHistoryTable";
 export { RefundRequestView } from "./RefundRequestView";

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

@@ -2,5 +2,6 @@ export { OrderCard, OrdersList } from "./OrdersList";
 export { MarketplaceOrderCard, } from "./MarketplaceOrderCard";
 export { OrderFilters, ORDER_FILTER_KEYS, ORDER_ADMIN_SORT_OPTIONS, ORDER_SELLER_SORT_OPTIONS, ORDER_USER_SORT_OPTIONS, getOrderFilterKeys, getOrderSortOptions, } from "./OrderFilters";
 export { OrderSiblingPayments } from "./OrderSiblingPayments";
+export { OrderPaymentSummary } from "./OrderPaymentSummary";
 export { RefundHistoryTable } from "./RefundHistoryTable";
 export { RefundRequestView } from "./RefundRequestView";

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

@@ -19,6 +19,14 @@ declare class OrderRepository extends BaseRepository<OrderDocument> {
     unassignWorker(orderId: string): Promise<OrderDocument>;
     markPicked(orderId: string): Promise<OrderDocument>;
     markPacked(orderId: string): Promise<OrderDocument>;
+    /**
+     * Payment Detail Parity (Feature C) — the COD counterpart to the manual
+     * proof-upload / Razorpay-webhook write paths. Seller or admin confirms
+     * the cash was physically collected; there is no external gateway to
+     * verify against, so `verifiedBy` is the acting user's uid and
+     * `verificationMethod` is always "cod_collection".
+     */
+    markCodCollected(orderId: string, verifiedBy: string, note?: string): Promise<OrderDocument>;
     findFulfillmentQueue(storeId: string): Promise<OrderDocument[]>;
     updatePaymentStatus(orderId: string, paymentStatus: PaymentStatus, paymentId?: string): Promise<OrderDocument>;
     cancelOrder(orderId: string, reason: string, refundAmount?: number): Promise<OrderDocument>;

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

@@ -87,6 +87,30 @@ class OrderRepository extends BaseRepository {
     async markPacked(orderId) {
         return this.update(orderId, { packedAt: new Date(), updatedAt: new Date() });
     }
+    /**
+     * Payment Detail Parity (Feature C) — the COD counterpart to the manual
+     * proof-upload / Razorpay-webhook write paths. Seller or admin confirms
+     * the cash was physically collected; there is no external gateway to
+     * verify against, so `verifiedBy` is the acting user's uid and
+     * `verificationMethod` is always "cod_collection".
+     */
+    async markCodCollected(orderId, verifiedBy, note) {
+        const order = await this.findById(orderId);
+        if (!order)
+            throw new NotFoundError(`Order ${orderId} not found`);
+        return this.update(orderId, {
+            paymentStatus: "paid",
+            paymentRecord: {
+                method: "cod",
+                transactionId: note,
+                amountPaise: order.totalPrice,
+                paidAt: new Date(),
+                verifiedBy,
+                verificationMethod: "cod_collection",
+            },
+            updatedAt: new Date(),
+        });
+    }
     async findFulfillmentQueue(storeId) {
         const snap = await this.db
             .collection(this.collection)

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

@@ -45,6 +45,19 @@ export declare const PaymentMethodValues: {
     readonly ADMIN_BYPASS: "admin_bypass";
     readonly EMI: "emi";
 };
+/**
+ * Buyer-chosen policy for what happens when an item in the cart becomes
+ * unavailable between add-to-cart and checkout — either COD/UPI (stock
+ * validated in the checkout transaction) or Razorpay (stock validated after
+ * payment capture). "skip_items" ships whatever remains available; "cancel_order"
+ * rejects the whole checkout batch if anything is short.
+ */
+export type OutOfStockPolicy = "cancel_order" | "skip_items";
+/** Runtime-accessible out-of-stock policy values — use instead of bare string literals. */
+export declare const OutOfStockPolicyValues: {
+    readonly CANCEL_ORDER: "cancel_order";
+    readonly SKIP_ITEMS: "skip_items";
+};
 export type EmiInstallmentStatus = "pending" | "paid" | "overdue";
 export interface EmiInstallment {
     /** 1-based installment number. */
@@ -245,6 +258,52 @@ export interface OrderDocument extends BaseDocument {
     paymentProofMimeType?: string;
     /** When the buyer submitted the proof. */
     paymentProofUploadedAt?: Date;
+    /**
+     * Same-shape payment record regardless of how the buyer paid — manual
+     * (cash/UPI proof), Razorpay (webhook-verified), or COD (collected on
+     * delivery). Additive: legacy fields above (`paymentProofUrl`,
+     * `paymentTransactionId`, `paymentId`, `paymentMethod`) are left in place
+     * for backward compatibility with pre-existing orders — `OrderPaymentSummary`
+     * falls back to them when `paymentRecord` is unset. Never renamed/removed.
+     */
+    paymentRecord?: OrderPaymentRecord;
+    /**
+     * The buyer's chosen policy at checkout for what to do when a cart item is
+     * unavailable. Set on every order created by the same checkout call — one
+     * checkout call is one buyer decision, so a multi-store/bundle checkout's
+     * sibling orders all carry the same policy + the full session's dropped
+     * items (they aren't cleanly attributable to a single store/order).
+     */
+    outOfStockPolicy?: OutOfStockPolicy;
+    /** Items from this checkout session that were dropped because they were unavailable ("skip_items" policy only). */
+    droppedItems?: {
+        productId: string;
+        productTitle: string;
+        requestedQty: number;
+        availableQty: number;
+    }[];
+    /** Set true only when an automatic partial refund (for dropped Razorpay items) failed and needs manual follow-up. */
+    refundPending?: boolean;
+}
+export type OrderPaymentRecordMethod = "manual" | "razorpay" | "cod";
+export type OrderPaymentVerificationMethod = "manual_review" | "webhook" | "cod_collection";
+export interface OrderPaymentRecord {
+    method: OrderPaymentRecordMethod;
+    /** UTR (manual) | razorpay_payment_id (razorpay) | collector note/ref (COD). */
+    transactionId?: string;
+    /** Manual proof upload | COD collection receipt photo (optional) | n/a for razorpay. */
+    proofUrl?: string;
+    amountPaise: number;
+    paidAt?: Date;
+    /** Admin/seller uid (manual/COD) | "razorpay-webhook" (razorpay, automatic). */
+    verifiedBy?: string;
+    verificationMethod: OrderPaymentVerificationMethod;
+    /** Razorpay audit trail only. */
+    gatewayRef?: {
+        orderId?: string;
+        paymentId?: string;
+        signature?: string;
+    };
 }
 export declare const ORDER_COLLECTION: "orders";
 export declare const ORDER_INDEXED_FIELDS: readonly ["userId", "productId", "storeId", "status", "paymentStatus", "payoutStatus", "shippingMethod", "orderDate", "createdAt", "assignedWorkerId", "pickedAt", "packedAt"];

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

@@ -37,6 +37,11 @@ export const PaymentMethodValues = {
     ADMIN_BYPASS: "admin_bypass",
     EMI: "emi",
 };
+/** Runtime-accessible out-of-stock policy values — use instead of bare string literals. */
+export const OutOfStockPolicyValues = {
+    CANCEL_ORDER: "cancel_order",
+    SKIP_ITEMS: "skip_items",
+};
 /** Runtime-accessible refund status values â€" use instead of bare string literals. */
 export const RefundStatusValues = {
     PENDING: "pending",