@mohasinac/appkit 3.1.7 → 3.2.0

package/dist/_internal/client/features/layout/DashboardLayoutClient.js

@@ -34,36 +34,65 @@ import { Div } from "../../../../ui";
  * Hoisted drawer-state hook — the matchMedia-aware open/close logic that was
  * triplicated across admin/store/user layouts. Used internally by
  * DashboardLayoutClient; not exported because it's not generically useful.
+ *
+ * storageKey: variant-scoped localStorage key (`appkit:sidebar-open:{variant}`)
+ * so admin/store/user each persist their own collapse state independently.
  */
-function useResponsiveDrawer() {
+function useResponsiveDrawer(storageKey) {
     const [desktopOpen, setDesktopOpen] = useState(false);
     const [mobileOpen, setMobileOpen] = useState(false);
     const { registerNav, unregisterNav } = useDashboardNav();
     const isDesktop = useCallback(() => typeof window !== "undefined" && window.matchMedia(DASHBOARD_DESKTOP_MEDIA_QUERY).matches, []);
+    // Restore persisted desktop-open state after hydration (avoids SSR mismatch).
+    useEffect(() => {
+        try {
+            if (localStorage.getItem(storageKey) === "true")
+                setDesktopOpen(true);
+        }
+        catch { /* localStorage unavailable (private-browse / SSR fallback) */ }
+    }, [storageKey]);
     const open = useCallback(() => {
         startTransition(() => {
-            if (isDesktop())
+            if (isDesktop()) {
+                try {
+                    localStorage.setItem(storageKey, "true");
+                }
+                catch { /* noop */ }
                 setDesktopOpen(true);
+            }
             else
                 setMobileOpen(true);
         });
-    }, [isDesktop]);
+    }, [isDesktop, storageKey]);
     const close = useCallback(() => {
         startTransition(() => {
-            if (isDesktop())
+            if (isDesktop()) {
+                try {
+                    localStorage.setItem(storageKey, "false");
+                }
+                catch { /* noop */ }
                 setDesktopOpen(false);
+            }
             else
                 setMobileOpen(false);
         });
-    }, [isDesktop]);
+    }, [isDesktop, storageKey]);
     const toggle = useCallback(() => {
         startTransition(() => {
-            if (isDesktop())
-                setDesktopOpen((prev) => !prev);
+            if (isDesktop()) {
+                setDesktopOpen((prev) => {
+                    const next = !prev;
+                    try {
+                        localStorage.setItem(storageKey, String(next));
+                    }
+                    catch { /* noop */ }
+                    return next;
+                });
+            }
             else
                 setMobileOpen((prev) => !prev);
         });
-    }, [isDesktop]);
+    }, [isDesktop, storageKey]);
     useEffect(() => {
         registerNav({ open, close, toggle });
         return () => unregisterNav();
@@ -87,7 +116,8 @@ const DEFAULT_CONTENT_MAX_WIDTH = "max-w-screen-2xl";
 export function DashboardLayoutClient({ variant, groups, permissions, activeHref: explicitActiveHref, responsive: _responsive, className, contentPadding, contentSurface, contentMaxWidth, children, }) {
     const pathname = usePathname();
     const activeHref = explicitActiveHref ?? pathname ?? "";
-    const { desktopOpen, mobileOpen, close, toggle } = useResponsiveDrawer();
+    const storageKey = `appkit:sidebar-open:${variant}`;
+    const { desktopOpen, mobileOpen, close, toggle } = useResponsiveDrawer(storageKey);
     const { data: settings } = useSiteSettings();
     const navConfig = settings?.navConfig;
     const filteredGroups = filterGroups(groups, navConfig, permissions);

package/dist/_internal/client/features/tour/TourProvider.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+export interface TourContextValue {
+    startTour: () => void;
+}
+export declare function useTour(): TourContextValue;
+/**
+ * TourProvider — skeleton shell for Patch 1.
+ * driver.js steps are wired in Patch 2+; this provider is an identity wrapper.
+ */
+export declare function TourProvider({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/_internal/client/features/tour/TourProvider.js

@@ -0,0 +1,19 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+const TourContext = React.createContext({
+    startTour: () => { },
+});
+export function useTour() {
+    return React.useContext(TourContext);
+}
+/**
+ * TourProvider — skeleton shell for Patch 1.
+ * driver.js steps are wired in Patch 2+; this provider is an identity wrapper.
+ */
+export function TourProvider({ children }) {
+    const startTour = React.useCallback(() => {
+        // driver.js will be imported and configured here in Patch 2+.
+    }, []);
+    return (_jsx(TourContext.Provider, { value: { startTour }, children: children }));
+}

package/dist/_internal/server/features/checkout/actions.js

@@ -232,12 +232,18 @@ export async function createCheckoutOrderAction(input) {
     const { userId: uid, userName, userEmail, addressId, paymentMethod, notes, excludedProductIds = [], adminBypass = false, adminBypassBy, } = input;
     const siteSettings = await siteSettingsRepository.getSingleton();
     const commissions = siteSettings?.commissions ?? CHECKOUT_DEFAULT_COMMISSIONS;
-    // W1-43 — enforce COD toggle. Admin bypass + non-COD payments still flow through.
+    // W1-43 — enforce COD toggle.
     if (!adminBypass &&
         paymentMethod === "cod" &&
         siteSettings?.payment?.codEnabled === false) {
         throw new ValidationError("Cash on Delivery is not currently accepted. Please choose another payment method.");
     }
+    // P-1 — enforce UPI/cash manual payment toggle.
+    if (!adminBypass &&
+        (paymentMethod === "upi_manual" || paymentMethod === "cash") &&
+        siteSettings?.payment?.upiManualEnabled === false) {
+        throw new ValidationError("Manual UPI / cash payment is not currently accepted. Please choose another payment method.");
+    }
     const cart = await unitOfWork.carts.getOrCreate(uid);
     if (!cart.items || cart.items.length === 0) {
         throw new ValidationError(ERROR_MESSAGES.CHECKOUT.CART_EMPTY);
@@ -470,7 +476,7 @@ export async function createCheckoutOrderAction(input) {
         });
         const totalQuantity = group.reduce((sum, { item }) => sum + item.quantity, 0);
         const { shippingFee, storeOwnerId } = await resolveShippingCost(firstItem.storeId, groupTotal, commissions);
-        const isCodLike = paymentMethod === "cod" || paymentMethod === "upi_manual";
+        const isCodLike = paymentMethod === "cod" || paymentMethod === "upi_manual" || paymentMethod === "cash";
         const depositAmount = isCodLike
             ? Math.round(groupTotal * (commissions.codDepositPercent / 100) * 100) / 100
             : undefined;

package/dist/_internal/server/features/media/contextGuards.js

@@ -45,7 +45,7 @@ export const CONTEXT_LIMITS = {
     RICH_TEXT_IMAGE_MAX: 20,
 };
 // Contexts that accept both image and PDF (proof documents).
-const IMAGE_OR_PDF_CONTEXTS = ["shipping-proof", "refund-proof"];
+const IMAGE_OR_PDF_CONTEXTS = ["shipping-proof", "refund-proof", "payment-proof"];
 const PDF_ONLY_CONTEXTS = ["invoice", "payout-doc"];
 const IMAGE_ONLY_CONTEXT_TYPES = new Set([
     "store-logo",
@@ -215,7 +215,7 @@ export function applyMediaContextGuards({ detectedMime, context: ctx, }) {
         return {
             ok: false,
             status: 400,
-            error: "PDF uploads are only allowed for invoice, payout-doc, shipping-proof, or refund-proof contexts",
+            error: "PDF uploads are only allowed for invoice, payout-doc, shipping-proof, refund-proof, or payment-proof contexts",
             details: { context: ctx.type, detected: detectedMime },
         };
     }

package/dist/_internal/server/features/orders/actions.d.ts

@@ -3,3 +3,9 @@ export declare function createOrderAction(input: unknown): Promise<ActionResult<
 export declare function cancelOrderAction(input: unknown): Promise<ActionResult<unknown>>;
 export declare function requestReturnAction(input: unknown): Promise<ActionResult<unknown>>;
 export declare function updateOrderStatusAction(input: unknown): Promise<ActionResult<unknown>>;
+export declare function attachPaymentProofAction(orderId: string, proof: {
+    proofUrl: string;
+    transactionId?: string;
+    mimeType?: string;
+}): Promise<ActionResult<void>>;
+export declare function adminVerifyPaymentAction(orderId: string): Promise<ActionResult<void>>;

package/dist/_internal/server/features/orders/actions.js

@@ -6,7 +6,7 @@ import { createOrderSchema, updateOrderStatusSchema, cancelOrderSchema, } from "
 import { assertOrderCancellable, assertReturnWindowOpen } from "./service";
 import { ValidationError } from "../../../shared/errors/index";
 import { OrderNotFoundError, OrderOwnershipError } from "../../../shared/features/orders/errors";
-import { isAdminUser } from "../../../../features/auth/role-predicates";
+import { isAdminUser, isModeratorUser } from "../../../../features/auth/role-predicates";
 export async function createOrderAction(input) {
     return wrapAction(async () => {
         const user = await requireRoleUser(["buyer", "seller", "admin"]);
@@ -58,3 +58,45 @@ export async function updateOrderStatusAction(input) {
         });
     });
 }
+// ── P-1 Manual payment proof ─────────────────────────────────────────────────
+export async function attachPaymentProofAction(orderId, proof) {
+    return wrapAction(async () => {
+        const user = await requireRoleUser(["buyer", "seller", "admin"]);
+        const order = await orderRepository.findById(orderId).catch(() => null);
+        if (!order)
+            throw new OrderNotFoundError(orderId);
+        if (!isAdminUser(user) && order.userId !== user.uid)
+            throw new OrderOwnershipError(orderId);
+        const pm = order.paymentMethod ?? "";
+        if (pm !== "cash" && pm !== "upi_manual") {
+            throw new ValidationError("Payment proof can only be attached to cash or UPI orders");
+        }
+        if (order.paymentProofUrl) {
+            throw new ValidationError("PROOF_ALREADY_ATTACHED");
+        }
+        await orderRepository.update(orderId, {
+            paymentProofUrl: proof.proofUrl,
+            paymentTransactionId: proof.transactionId,
+            paymentProofMimeType: proof.mimeType,
+            paymentProofUploadedAt: new Date(),
+        });
+    });
+}
+export async function adminVerifyPaymentAction(orderId) {
+    return wrapAction(async () => {
+        const user = await requireRoleUser(["admin", "moderator"]);
+        if (!isAdminUser(user) && !isModeratorUser(user)) {
+            throw new ValidationError("Only admin or moderator can verify payments");
+        }
+        const order = await orderRepository.findById(orderId).catch(() => null);
+        if (!order)
+            throw new OrderNotFoundError(orderId);
+        if (order.paymentStatus === "paid")
+            return; // idempotent
+        await orderRepository.update(orderId, {
+            paymentStatus: "paid",
+            paymentId: order.paymentTransactionId ?? order.paymentId ?? `manual-${orderId}`,
+            status: "processing",
+        });
+    });
+}

package/dist/_internal/server/jobs/core/assignSpinPrize.js

@@ -8,6 +8,10 @@ const EVENTS_COLLECTION = "events";
 const EVENT_ENTRIES_COLLECTION = "eventEntries";
 const COUPONS_COLLECTION = "coupons";
 export async function runAssignSpinPrize(input, ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping spin prize assignment");
+        return { eventId: input.eventId, userId: input.userId, reason: "feature_disabled" };
+    }
     const { eventId, userId } = input;
     const eventSnap = await ctx.db.collection(EVENTS_COLLECTION).doc(eventId).get();
     if (!eventSnap.exists) {

package/dist/_internal/server/jobs/core/auctionSettlement.js

@@ -57,6 +57,10 @@ async function settleAuction(ctx, product) {
     });
 }
 export async function runAuctionSettlement(ctx) {
+    if (ctx.env("FEATURE_AUCTIONS") !== "true") {
+        ctx.logger.info("FEATURE_AUCTIONS disabled — skipping auction settlement");
+        return;
+    }
     ctx.logger.info("Starting auction settlement sweep");
     const expired = await productRepository.getExpiredAuctions(ctx.now);
     if (expired.length === 0) {

package/dist/_internal/server/jobs/core/autoPayoutEligibility.js

@@ -13,6 +13,10 @@ function getBusinessDayCutoff(daysAgo) {
     return cutoff;
 }
 export async function runAutoPayoutEligibility(ctx) {
+    if (ctx.env("FEATURE_PAYOUTS") !== "true") {
+        ctx.logger.info("FEATURE_PAYOUTS disabled — skipping auto-payout eligibility");
+        return;
+    }
     ctx.logger.info("Starting daily auto-payout eligibility sweep", {
         windowDays: AUTO_PAYOUT_WINDOW_DAYS,
     });

package/dist/_internal/server/jobs/core/bundleStockSync.js

@@ -36,6 +36,10 @@ async function computeBundleStockStatus(productIds, ctx) {
     return "in_stock";
 }
 export async function runBundleStockSync(ctx) {
+    if (ctx.env("FEATURE_BUNDLES") !== "true") {
+        ctx.logger.info("FEATURE_BUNDLES disabled — skipping bundle stock sync");
+        return;
+    }
     ctx.logger.info("Bundle stock sync starting (SB-UNI-V categories)");
     const snap = await ctx.db
         .collection(CATEGORIES_COLLECTION)

package/dist/_internal/server/jobs/core/payoutBatch.js

@@ -87,6 +87,10 @@ async function dispatch(ctx, entry) {
     }
 }
 export async function runPayoutBatch(ctx) {
+    if (ctx.env("FEATURE_PAYOUTS") !== "true") {
+        ctx.logger.info("FEATURE_PAYOUTS disabled — skipping payout batch");
+        return;
+    }
     ctx.logger.info("Starting payout batch sweep");
     const pending = await payoutRepository.getPending();
     if (pending.length === 0) {

package/dist/_internal/server/jobs/core/prizeRevealClose.js

@@ -2,6 +2,10 @@ import { PRODUCT_FIELDS, COMMON_FIELDS } from "../../../../constants/field-names
 const PRODUCT_COLLECTION = "products";
 const PRIZE_DRAW_LISTING_TYPE = "prize-draw";
 export async function runPrizeRevealClose(ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping prize reveal close");
+        return;
+    }
     ctx.logger.info("Prize reveal close sweep starting");
     const snap = await ctx.db
         .collection(PRODUCT_COLLECTION)

package/dist/_internal/server/jobs/core/prizeRevealExpiry.js

@@ -3,6 +3,10 @@ import { sendNotification } from "../../../../features/admin/actions/notificatio
 import { ORDER_FIELDS, PRODUCT_FIELDS, COMMON_FIELDS } from "../../../../constants/field-names";
 const ORDER_COLLECTION = "orders";
 export async function runPrizeRevealExpiry(ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping prize reveal expiry");
+        return;
+    }
     ctx.logger.info("Prize reveal expiry sweep starting");
     const snap = await ctx.db
         .collection(ORDER_COLLECTION)

package/dist/_internal/server/jobs/core/prizeRevealOpen.js

@@ -5,6 +5,10 @@ const PRODUCT_COLLECTION = "products";
 const ORDER_COLLECTION = "orders";
 const PRIZE_DRAW_LISTING_TYPE = "prize-draw";
 export async function runPrizeRevealOpen(ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping prize reveal open");
+        return;
+    }
     ctx.logger.info("Prize reveal open sweep starting");
     const snap = await ctx.db
         .collection(PRODUCT_COLLECTION)

package/dist/_internal/server/jobs/core/prizeRevealReminder.js

@@ -4,6 +4,10 @@ import { ORDER_FIELDS, PRODUCT_FIELDS } from "../../../../constants/field-names"
 const ORDER_COLLECTION = "orders";
 const ONE_DAY_MS = 86400000;
 export async function runPrizeRevealReminder(ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping prize reveal reminder");
+        return;
+    }
     ctx.logger.info("Prize reveal reminder sweep starting");
     const cutoff = new Date(ctx.now.getTime() + ONE_DAY_MS);
     const snap = await ctx.db

package/dist/_internal/server/jobs/core/promotions.js

@@ -6,6 +6,10 @@ import { ProductStatusValues } from "../../../../features/products/schemas/fires
  * (coupon.startDate IS NULL OR <= now) filter Firestore can't express.
  */
 export async function runPromotions(_input, ctx) {
+    if (ctx.env("FEATURE_EVENTS") !== "true") {
+        ctx.logger.info("FEATURE_EVENTS disabled — skipping promotions");
+        return { promotedProducts: [], featuredProducts: [], activeCoupons: [] };
+    }
     ctx.logger.info("Promotions data requested");
     const now = new Date();
     const nowIso = now.toISOString();

package/dist/_internal/server/jobs/core/triggerEventRaffle.js

@@ -7,6 +7,10 @@ import { EVENT_ENTRY_FIELDS } from "../../../../constants/field-names";
 const EVENTS_COLLECTION = "events";
 const EVENT_ENTRIES_COLLECTION = "eventEntries";
 export async function runTriggerEventRaffle(input, ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping event raffle");
+        return { eventId: input.eventId, raffleEntryCount: 0 };
+    }
     const eventRef = ctx.db.collection(EVENTS_COLLECTION).doc(input.eventId);
     const eventSnap = await eventRef.get();
     if (!eventSnap.exists) {

package/dist/_internal/server/jobs/core/weeklyPayoutEligibility.js

@@ -7,6 +7,10 @@ import { BATCH_LIMIT } from "../handlers/messages";
 import { getDefaultCurrency } from "../../../../core";
 const PLATFORM_COMMISSION_RATE = 0.05;
 export async function runWeeklyPayoutEligibility(ctx) {
+    if (ctx.env("FEATURE_PAYOUTS") !== "true") {
+        ctx.logger.info("FEATURE_PAYOUTS disabled — skipping weekly payout eligibility");
+        return;
+    }
     ctx.logger.info("Starting weekly payout eligibility sweep");
     const eligible = await orderRepository.getEligibleShiprocket();
     if (eligible.length === 0) {

package/dist/_internal/shared/actions/action-registry.js

@@ -835,6 +835,19 @@ export const ACTIONS = {
             kind: "secondary",
             permissions: ["admin"],
         },
+        "verify-payment": {
+            id: "admin.verify-payment",
+            label: "Verify Payment",
+            ariaLabel: "Mark payment as received and verified",
+            description: "Confirms manual cash/UPI payment was received. Moves order to Processing.",
+            kind: "primary",
+            permissions: ["admin", "moderator"],
+            confirmation: {
+                title: "Verify payment?",
+                body: "This marks the payment as received. The order will move to Processing. This action cannot be undone.",
+                confirmLabel: "Yes, verify",
+            },
+        },
         "verify-vendor": {
             id: "admin.verify-vendor",
             label: "Verify vendor",

package/dist/_internal/shared/features/checkout/config.d.ts

@@ -4,5 +4,5 @@ export declare const CHECKOUT_DEFAULT_COMMISSIONS: {
     readonly platformShippingPercent: 10;
     readonly platformShippingFixedMin: 50;
 };
-export declare const CHECKOUT_PAYMENT_METHODS: readonly ["cod", "online", "upi_manual", "admin_bypass"];
+export declare const CHECKOUT_PAYMENT_METHODS: readonly ["cash", "cod", "online", "upi_manual", "admin_bypass"];
 export type CheckoutPaymentMethod = (typeof CHECKOUT_PAYMENT_METHODS)[number];

package/dist/_internal/shared/features/checkout/config.js

@@ -4,4 +4,4 @@ export const CHECKOUT_DEFAULT_COMMISSIONS = {
     platformShippingPercent: 10,
     platformShippingFixedMin: 50,
 };
-export const CHECKOUT_PAYMENT_METHODS = ["cod", "online", "upi_manual", "admin_bypass"];
+export const CHECKOUT_PAYMENT_METHODS = ["cash", "cod", "online", "upi_manual", "admin_bypass"];

package/dist/features/admin/components/AdminOrderEditorView.d.ts

@@ -4,5 +4,9 @@ export interface AdminOrderEditorViewProps {
     orderId?: string;
     orderLabel?: string;
     currentStatus?: string;
+    paymentProofUrl?: string;
+    paymentTransactionId?: string;
+    paymentMethod?: string;
+    paymentStatus?: string;
 }
-export declare function AdminOrderEditorView({ open, onClose, orderId, orderLabel, currentStatus, }: AdminOrderEditorViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminOrderEditorView({ open, onClose, orderId, orderLabel, currentStatus, paymentProofUrl, paymentTransactionId, paymentMethod, paymentStatus, }: AdminOrderEditorViewProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,11 +1,14 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useApiMutation } from "@mohasinac/appkit/client";
-import React from "react";
+import React, { useState } from "react";
+import { normalizeError } from "../../../errors/normalize";
 import { useQueryClient } from "@tanstack/react-query";
-import { Button, Form, FormActions, Input, Label, Select, SideDrawer, Stack, useToast } from "../../../ui";
+import { Button, Div, Form, FormActions, Input, Label, Select, SideDrawer, Stack, Text, useToast } from "../../../ui";
+import { MediaImage } from "../../media";
 import { apiClient } from "../../../http";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
 const STATUS_OPTIONS = [
     { label: "Pending", value: "pending" },
     { label: "Processing", value: "processing" },
@@ -25,7 +28,7 @@ const CARRIER_OPTIONS = [
     { label: "Other", value: "Other" },
 ];
 // --- Component ---------------------------------------------------------------
-export function AdminOrderEditorView({ open, onClose, orderId, orderLabel, currentStatus, }) {
+export function AdminOrderEditorView({ open, onClose, orderId, orderLabel, currentStatus, paymentProofUrl, paymentTransactionId, paymentMethod, paymentStatus, }) {
     const queryClient = useQueryClient();
     const { showToast } = useToast();
     const [status, setStatus] = React.useState(currentStatus ?? "pending");
@@ -33,6 +36,9 @@ export function AdminOrderEditorView({ open, onClose, orderId, orderLabel, curre
     const [carrier, setCarrier] = React.useState("");
     const [notes, setNotes] = React.useState("");
     const [refundAmount, setRefundAmount] = React.useState("");
+    const [isVerifyingPayment, setIsVerifyingPayment] = useState(false);
+    const isCashOrUpi = paymentMethod === "cash" || paymentMethod === "upi_manual";
+    const needsVerification = isCashOrUpi && paymentStatus === "pending";
     React.useEffect(() => {
         if (open) {
             setStatus(currentStatus ?? "pending");
@@ -68,8 +74,28 @@ export function AdminOrderEditorView({ open, onClose, orderId, orderLabel, curre
             showToast(err?.message ?? "Failed to update order.", "error");
         },
     });
+    const handleVerifyPayment = async () => {
+        if (!orderId)
+            return;
+        setIsVerifyingPayment(true);
+        try {
+            await apiClient.patch(`/api/admin/orders/${orderId}/payment-verify`, {});
+            showToast("Payment verified. Order moved to Processing.", "success");
+            queryClient.invalidateQueries({ queryKey: ["admin", "orders"] });
+            onClose();
+        }
+        catch (err) {
+            void normalizeError(err);
+            showToast(err?.message ?? "Failed to verify payment.", "error");
+        }
+        finally {
+            setIsVerifyingPayment(false);
+        }
+    };
     return (_jsx(SideDrawer, { isOpen: open, onClose: onClose, title: orderLabel ? `Order: ${orderLabel}` : "Update Order", children: _jsxs(Form, { onSubmit: (e) => {
                 e.preventDefault();
                 saveMutation.mutate();
-            }, spacing: "md", padding: "md", children: [_jsx(Select, { label: "Order status", options: STATUS_OPTIONS, value: status, onValueChange: setStatus }), _jsx(Input, { label: "Tracking number (optional)", value: trackingNumber, onChange: (e) => setTrackingNumber(e.target.value), placeholder: "e.g. DEL1234567890IN" }), _jsx(Select, { label: "Carrier (optional)", options: CARRIER_OPTIONS, value: carrier, onValueChange: setCarrier }), _jsxs(Stack, { gap: "xs", children: [_jsx(Label, { size: "sm", weight: "medium", color: "primary", children: "Internal note (optional)" }), _jsx("textarea", { value: notes, onChange: (e) => setNotes(e.target.value), rows: 3, placeholder: "Reason for status change, escalation notes\u2026", className: "w-full rounded-lg border border-zinc-300 dark:border-zinc-700 bg-white dark:bg-zinc-800 px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 focus:outline-none focus:ring-2 focus:ring-primary-500" })] }), (status === "refunded" || status === "return_requested") && (_jsx(Input, { label: "Refund amount \u20B9 (optional)", type: "number", min: "0", step: "0.01", value: refundAmount, onChange: (e) => setRefundAmount(e.target.value), placeholder: "e.g. 499.00" })), _jsxs(FormActions, { align: "right", children: [_jsx(Button, { type: "button", variant: "secondary", onClick: onClose, children: "Cancel" }), _jsx(Button, { type: "submit", isLoading: saveMutation.isPending, disabled: !orderId || saveMutation.isPending, children: "Save changes" })] })] }) }));
+            }, spacing: "md", padding: "md", children: [_jsx(Select, { label: "Order status", options: STATUS_OPTIONS, value: status, onValueChange: setStatus }), _jsx(Input, { label: "Tracking number (optional)", value: trackingNumber, onChange: (e) => setTrackingNumber(e.target.value), placeholder: "e.g. DEL1234567890IN" }), _jsx(Select, { label: "Carrier (optional)", options: CARRIER_OPTIONS, value: carrier, onValueChange: setCarrier }), _jsxs(Stack, { gap: "xs", children: [_jsx(Label, { size: "sm", weight: "medium", color: "primary", children: "Internal note (optional)" }), _jsx("textarea", { value: notes, onChange: (e) => setNotes(e.target.value), rows: 3, placeholder: "Reason for status change, escalation notes\u2026", className: "w-full rounded-lg border border-zinc-300 dark:border-zinc-700 bg-white dark:bg-zinc-800 px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 focus:outline-none focus:ring-2 focus:ring-primary-500" })] }), (status === "refunded" || status === "return_requested") && (_jsx(Input, { label: "Refund amount \u20B9 (optional)", type: "number", min: "0", step: "0.01", value: refundAmount, onChange: (e) => setRefundAmount(e.target.value), placeholder: "e.g. 499.00" })), isCashOrUpi && (_jsxs(Stack, { gap: "xs", children: [_jsx(Label, { size: "sm", weight: "medium", color: "primary", children: "Payment Proof" }), paymentProofUrl ? (_jsxs(Stack, { gap: "xs", children: [_jsx(MediaImage, { src: paymentProofUrl, alt: "Payment screenshot", size: "card", className: "rounded-lg border border-zinc-200 dark:border-zinc-700" }), paymentTransactionId && (_jsxs(Text, { size: "xs", color: "muted", children: ["UTR: ", _jsx(Text, { as: "span", size: "xs", weight: "medium", children: paymentTransactionId })] })), needsVerification && (_jsx(Button, { type: "button", action: ACTIONS.ADMIN["verify-payment"], onClick: handleVerifyPayment, isLoading: isVerifyingPayment, disabled: isVerifyingPayment, variant: "primary", className: "mt-1 w-full" })), !needsVerification && paymentStatus === "paid" && (
+                                // audit-variant-ok: themed success border color not in BORDER_MAP
+                                _jsx(Div, { rounded: "lg", padding: "inlineSm", className: "border border-success/20", surface: "success-surface", children: _jsx(Text, { size: "xs", className: "text-success", weight: "medium", children: "Payment verified" }) }))] })) : (_jsx(Text, { size: "xs", color: "faint", children: "No proof uploaded yet." }))] })), _jsxs(FormActions, { align: "right", children: [_jsx(Button, { type: "button", variant: "secondary", onClick: onClose, children: "Cancel" }), _jsx(Button, { type: "submit", isLoading: saveMutation.isPending, disabled: !orderId || saveMutation.isPending, children: "Save changes" })] })] }) }));
 }

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

@@ -51,6 +51,10 @@ export function AdminOrdersView({ children, ...props }) {
             ].join(" · "),
             status: toStringValue(item.status, "Unknown"),
             updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
+            paymentProofUrl: toStringValue(item.paymentProofUrl, "") || undefined,
+            paymentTransactionId: toStringValue(item.paymentTransactionId, "") || undefined,
+            paymentMethod: toStringValue(item.paymentMethod, "") || undefined,
+            paymentStatus: toStringValue(item.paymentStatus, "") || undefined,
         })),
         getTotal: (response, mappedRows) => typeof response.meta?.total === "number" ? response.meta.total : mappedRows.length,
         buildFilters: (f) => (f.status && f.status !== "All" ? sieveFilter("status", SIEVE_OP.EQ, f.status) : undefined),
@@ -117,5 +121,5 @@ export function AdminOrdersView({ children, ...props }) {
             ] })),
         renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsx(FilterChipGroup, { label: "Status", tabs: ADMIN_ORDER_STATUS_TABS, value: pendingFilters.status ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, status: id })) })),
     };
-    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(AdminOrderEditorView, { open: drawerOpen, onClose: () => setDrawerOpen(false), orderId: selectedRow?.id, orderLabel: selectedRow?.primary, currentStatus: selectedRow?.status })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(AdminOrderEditorView, { open: drawerOpen, onClose: () => setDrawerOpen(false), orderId: selectedRow?.id, orderLabel: selectedRow?.primary, currentStatus: selectedRow?.status, paymentProofUrl: selectedRow?.paymentProofUrl, paymentTransactionId: selectedRow?.paymentTransactionId, paymentMethod: selectedRow?.paymentMethod, paymentStatus: selectedRow?.paymentStatus })] }));
 }

package/dist/features/layout/AppLayoutShell.d.ts

@@ -88,6 +88,8 @@ export interface AppLayoutShellProps {
         logout?: string;
     };
     eventBannerSlot?: React.ReactNode;
+    /** When provided, renders a tour-start icon button in the title bar. Null in Patch 1. */
+    onTourStart?: () => void;
     /**
      * Override className for the main content wrapper div.
      * When set, replaces the default `w-full px-4 py-6 …`
@@ -113,4 +115,4 @@ export interface AppLayoutShellProps {
         };
     };
 }
-export declare function AppLayoutShell({ children, navItems, sidebarItems, sidebarSections, sidebarPrimaryActions, sidebarTitle, hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle, suppressDashboardNav, hideSidebarToggle, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar, sidebarProfileLabels, eventBannerSlot, contentClassName, lightBackground, darkBackground, }: AppLayoutShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function AppLayoutShell({ children, navItems, sidebarItems, sidebarSections, sidebarPrimaryActions, sidebarTitle, hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle, suppressDashboardNav, hideSidebarToggle, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar, sidebarProfileLabels, eventBannerSlot, onTourStart, contentClassName, lightBackground, darkBackground, }: AppLayoutShellProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/layout/AppLayoutShell.js

@@ -104,7 +104,7 @@ function SidebarContent({ sidebarItems, sidebarSections, sidebarPrimaryActions,
                     ].join(" "), children: action.label }, `${action.href}-${action.label}`))) })), isAuthenticated && (_jsx(CollapsibleNavGroup, { title: labels.sectionTitle, children: _jsxs(Ul, { spacing: "2xs", children: [_jsx(Li, { children: _jsx(TextLink, { href: profileHref, variant: "none", className: navItemClass, children: labels.profile }) }), userOrdersHref && (_jsx(Li, { children: _jsx(TextLink, { href: userOrdersHref, variant: "none", className: navItemClass, children: labels.orders }) })), userWishlistHref && (_jsx(Li, { children: _jsx(TextLink, { href: userWishlistHref, variant: "none", className: navItemClass, children: labels.wishlist }) })), userSettingsHref && (_jsx(Li, { children: _jsx(TextLink, { href: userSettingsHref, variant: "none", className: navItemClass, children: labels.settings }) }))] }) })), isAuthenticated && user?.stats && (_jsxs(Div, { layout: "grid", gap: "2", className: "grid-cols-2", children: [user.stats.totalOrders != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.totalOrders }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Orders" })] })), user.stats.reviewsCount != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.reviewsCount }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Reviews" })] })), user.stats.auctionsWon != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.auctionsWon }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Auctions Won" })] })), user.stats.itemsSold != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.itemsSold }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Items Sold" })] }))] })), isAuthenticated && isAdminOrSeller && (adminHref || resolvedStoreHref) && (_jsx(CollapsibleNavGroup, { title: labels.dashboardSectionTitle, children: _jsxs(Ul, { spacing: "2xs", children: [adminHref && role === "admin" && (_jsx(Li, { children: _jsx(TextLink, { href: adminHref, variant: "none", className: navItemClass, children: labels.adminDashboard }) })), resolvedStoreHref && isAdminOrSeller && (_jsx(Li, { children: _jsx(TextLink, { href: resolvedStoreHref, variant: "none", className: navItemClass, children: labels.storeDashboard }) }))] }) })), normalizedSections.map((section, sectionIndex) => (_jsx(CollapsibleSidebarSection, { section: section, navItemClass: navItemClass }, `sidebar-section-${sectionIndex}`))), (sidebarLocaleSlot || showThemeToggleInSidebar || (isAuthenticated && onLogout)) && (_jsxs(Stack, { border: "default", className: "border-t dark:border-slate-800", padding: "t-md", gap: "3", children: [sidebarLocaleSlot, showThemeToggleInSidebar && (_jsxs("button", { type: "button", onClick: toggleTheme, className: "flex w-full items-center gap-3 rounded-lg px-3 py-2 text-sm text-zinc-700 transition-colors hover:bg-primary-50 hover:text-primary-800 dark:text-zinc-300 dark:hover:bg-slate-800 dark:hover:text-secondary-300", children: [_jsx(Span, { "aria-hidden": "true", children: theme === "dark" ? "☀️" : "🌙" }), theme === "dark" ? "Light mode" : "Dark mode"] })), isAuthenticated && onLogout && (_jsx("button", { type: "button", onClick: () => { onLogout(); onAfterLogout(); }, className: CLS_LOGOUT_BTN, children: labels.logout }))] }))] }));
 }
 // ─── Main component ────────────────────────────────────────────────────────────
-export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarSections, sidebarPrimaryActions, sidebarTitle = "Navigation", hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle = false, suppressDashboardNav = false, hideSidebarToggle = false, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar = false, sidebarProfileLabels, eventBannerSlot, contentClassName, lightBackground = DEFAULT_LIGHT_BG, darkBackground = DEFAULT_DARK_BG, }) {
+export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarSections, sidebarPrimaryActions, sidebarTitle = "Navigation", hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle = false, suppressDashboardNav = false, hideSidebarToggle = false, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar = false, sidebarProfileLabels, eventBannerSlot, onTourStart, contentClassName, lightBackground = DEFAULT_LIGHT_BG, darkBackground = DEFAULT_DARK_BG, }) {
     // QueryClientProvider used to be created here so AppLayoutShell could stand
     // alone. The real cause of the 2026-06-10/11 "No QueryClient set" prod crash
     // turned out to be a peer-dep duplicate of @tanstack/query-core under
@@ -164,5 +164,5 @@ export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarS
             opacity: darkBackground.overlay?.opacity ?? 0,
         },
     };
-    return (_jsx(_Fragment, { children: _jsxs(Stack, { className: "min-h-screen w-full overflow-x-clip transition-colors duration-300", children: [_jsx(BackgroundRenderer, { mode: theme === "dark" ? "dark" : "light", lightMode: normalizedLightBackground, darkMode: normalizedDarkBackground }), _jsxs(Div, { ref: headerRef, className: "sticky top-0 z-50 w-full", children: [_jsx(TitleBar, { onToggleSidebar: handleTogglePublicSidebar, sidebarOpen: sidebarOpen, onSearchToggle: () => setSearchOpen((prev) => !prev), searchOpen: searchOpen, brandName: brandName, brandShortName: brandShortName, siteLogoUrl: siteLogoUrl, logoHref: logoHref, promotionsHref: promotionsHref, cartHref: cartHref, wishlistHref: wishlistHref, userId: userId, profileHref: profileHref, loginHref: loginHref, registerHref: registerHref, user: user, navSlot: titleBarNavSlot, notificationSlot: titleBarNotificationSlot, devSlot: titleBarDevSlot, promoStripText: titleBarPromoStripText, isDark: theme === "dark", onToggleTheme: showThemeToggle ? toggleTheme : undefined, onBeforeToggleDashboardNav: handleBeforeDashboardNavToggle, suppressDashboardNav: suppressDashboardNav, hideSidebarToggle: hideSidebarToggle }), _jsx(NavbarWithSettings, { navItems: navItems, hiddenNavItems: hiddenNavItems, permissions: authUser?.permissions }), searchOpen && (searchSlotRenderer ? searchSlotRenderer(() => setSearchOpen(false)) : searchSlot)] }), eventBannerSlot, _jsx(AutoBreadcrumbs, {}), _jsxs(Div, { layout: "flex", className: "relative w-full flex-1 overflow-x-clip", children: [_jsx(SidebarLayout, { isOpen: sidebarOpen, ariaLabel: "Secondary navigation", header: user ? (_jsx(SidebarUserHeader, { user: user, onClose: () => setSidebarOpen(false) })) : (_jsx(SidebarGuestHeader, { sidebarTitle: sidebarTitle, onClose: () => setSidebarOpen(false) })), onClose: () => setSidebarOpen(false), children: sidebarContent }), _jsx(Main, { id: "main-content", className: `w-full flex-1 flex flex-col ${hasBottomActions ? "mb-28" : "mb-16"} md:mb-0`, children: _jsx(Div, { padding: "y-lg", className: `flex-1 ${contentClassName ?? "w-full px-5 md:px-6 lg:px-8"}`, children: children }) })] }), _jsx(BackToTop, {}), _jsx(FooterLayout, { ...footer }), _jsx(BottomActions, {}), _jsx(BottomNavbar, { user: user, homeHref: homeHref, shopHref: shopHref, cartHref: cartHref, profileHref: profileHref, loginHref: loginHref, onSearchToggle: () => setSearchOpen((prev) => !prev), navItems: navItems, onMoreToggle: hasDashboardNav ? toggleDashboardNav : handleTogglePublicSidebar }), _jsx(UnsavedChangesModal, {})] }) }));
+    return (_jsx(_Fragment, { children: _jsxs(Stack, { className: "min-h-screen w-full overflow-x-clip transition-colors duration-300", children: [_jsx(BackgroundRenderer, { mode: theme === "dark" ? "dark" : "light", lightMode: normalizedLightBackground, darkMode: normalizedDarkBackground }), _jsxs(Div, { ref: headerRef, className: "sticky top-0 z-50 w-full", children: [_jsx(TitleBar, { onToggleSidebar: handleTogglePublicSidebar, sidebarOpen: sidebarOpen, onSearchToggle: () => setSearchOpen((prev) => !prev), searchOpen: searchOpen, brandName: brandName, brandShortName: brandShortName, siteLogoUrl: siteLogoUrl, logoHref: logoHref, promotionsHref: promotionsHref, cartHref: cartHref, wishlistHref: wishlistHref, userId: userId, profileHref: profileHref, loginHref: loginHref, registerHref: registerHref, user: user, navSlot: titleBarNavSlot, notificationSlot: titleBarNotificationSlot, devSlot: titleBarDevSlot, promoStripText: titleBarPromoStripText, isDark: theme === "dark", onToggleTheme: showThemeToggle ? toggleTheme : undefined, onTourStart: onTourStart, onBeforeToggleDashboardNav: handleBeforeDashboardNavToggle, suppressDashboardNav: suppressDashboardNav, hideSidebarToggle: hideSidebarToggle }), _jsx(NavbarWithSettings, { navItems: navItems, hiddenNavItems: hiddenNavItems, permissions: authUser?.permissions }), searchOpen && (searchSlotRenderer ? searchSlotRenderer(() => setSearchOpen(false)) : searchSlot)] }), eventBannerSlot, _jsx(AutoBreadcrumbs, {}), _jsxs(Div, { layout: "flex", className: "relative w-full flex-1 overflow-x-clip", children: [_jsx(SidebarLayout, { isOpen: sidebarOpen, ariaLabel: "Secondary navigation", header: user ? (_jsx(SidebarUserHeader, { user: user, onClose: () => setSidebarOpen(false) })) : (_jsx(SidebarGuestHeader, { sidebarTitle: sidebarTitle, onClose: () => setSidebarOpen(false) })), onClose: () => setSidebarOpen(false), children: sidebarContent }), _jsx(Main, { id: "main-content", className: `w-full flex-1 flex flex-col ${hasBottomActions ? "mb-28" : "mb-16"} md:mb-0`, children: _jsx(Div, { padding: "y-lg", className: `flex-1 ${contentClassName ?? "w-full px-5 md:px-6 lg:px-8"}`, children: children }) })] }), _jsx(BackToTop, {}), _jsx(FooterLayout, { ...footer }), _jsx(BottomActions, {}), _jsx(BottomNavbar, { user: user, homeHref: homeHref, shopHref: shopHref, cartHref: cartHref, profileHref: profileHref, loginHref: loginHref, onSearchToggle: () => setSearchOpen((prev) => !prev), navItems: navItems, onMoreToggle: hasDashboardNav ? toggleDashboardNav : handleTogglePublicSidebar }), _jsx(UnsavedChangesModal, {})] }) }));
 }

package/dist/features/layout/TitleBarLayout.d.ts

@@ -52,6 +52,8 @@ export interface TitleBarLayoutProps {
     onToggleDashboardNav?: () => void;
     /** Hide the public sidebar toggle button when nested layouts own navigation. */
     hideSidebarToggle?: boolean;
+    /** When provided, renders a tour-start icon button before the theme toggle. Null in Patch 1. */
+    onTourStart?: () => void;
     id?: string;
     className?: string;
 }
@@ -64,4 +66,4 @@ export interface TitleBarLayoutProps {
  *
  * Receives all domain data as props — zero domain imports.
  */
-export declare function TitleBarLayout({ onToggleSidebar, sidebarOpen, onSearchToggle, searchOpen: _searchOpen, brandName, brandShortName: _brandShortName, siteLogoUrl, logoHref, promotionsHref, compareHref, wishlistHref, wishlistCount, cartHref, cartCount, profileHref, unreadNotificationCount, notificationsHref, loginHref, registerHref, user, notificationSlot, devSlot, navSlot, promoStripText, isDark, onToggleTheme, hasDashboardNav, onToggleDashboardNav, hideSidebarToggle, id, className, }: TitleBarLayoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function TitleBarLayout({ onToggleSidebar, sidebarOpen, onSearchToggle, searchOpen: _searchOpen, brandName, brandShortName: _brandShortName, siteLogoUrl, logoHref, promotionsHref, compareHref, wishlistHref, wishlistCount, cartHref, cartCount, profileHref, unreadNotificationCount, notificationsHref, loginHref, registerHref, user, notificationSlot, devSlot, navSlot, promoStripText, isDark, onToggleTheme, onTourStart, hasDashboardNav, onToggleDashboardNav, hideSidebarToggle, id, className, }: TitleBarLayoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/layout/TitleBarLayout.js

@@ -14,10 +14,11 @@ const countBadge = "absolute -top-0.5 -right-0.5 flex items-center justify-cente
  *
  * Receives all domain data as props — zero domain imports.
  */
-export function TitleBarLayout({ onToggleSidebar, sidebarOpen, onSearchToggle, searchOpen: _searchOpen, brandName, brandShortName: _brandShortName, siteLogoUrl, logoHref, promotionsHref, compareHref, wishlistHref, wishlistCount = 0, cartHref, cartCount = 0, profileHref, unreadNotificationCount = 0, notificationsHref, loginHref, registerHref, user, notificationSlot, devSlot, navSlot, promoStripText, isDark = false, onToggleTheme, hasDashboardNav, onToggleDashboardNav, hideSidebarToggle = false, id = "titlebar", className = "", }) {
+export function TitleBarLayout({ onToggleSidebar, sidebarOpen, onSearchToggle, searchOpen: _searchOpen, brandName, brandShortName: _brandShortName, siteLogoUrl, logoHref, promotionsHref, compareHref, wishlistHref, wishlistCount = 0, cartHref, cartCount = 0, profileHref, unreadNotificationCount = 0, notificationsHref, loginHref, registerHref, user, notificationSlot, devSlot, navSlot, promoStripText, isDark = false, onToggleTheme, onTourStart, hasDashboardNav, onToggleDashboardNav, hideSidebarToggle = false, id = "titlebar", className = "", }) {
     // ── Element builders ────────────────────────────────────────────────────────
     const promotionsEl = promotionsHref ? (_jsxs(Link, { href: promotionsHref, "aria-label": "Today's deals", className: "flex items-center gap-1 px-3 py-1 rounded-full text-xs font-bold bg-primary-100 text-primary-700 dark:bg-secondary-900/40 dark:text-secondary-400 hover:bg-primary-200 dark:hover:bg-secondary-900/60 transition-colors border border-primary-200/60 dark:border-secondary-700/40", children: [_jsx("svg", { className: "w-3 h-3", viewBox: "0 0 24 24", fill: "currentColor", "aria-hidden": "true", children: _jsx("path", { d: "M21.41 11.58l-9-9C12.05 2.22 11.55 2 11 2H4c-1.1 0-2 .9-2 2v7c0 .55.22 1.05.59 1.42l9 9c.36.37.86.58 1.41.58.55 0 1.05-.21 1.41-.59l7-7c.37-.36.59-.86.59-1.41 0-.55-.23-1.06-.59-1.42zM5.5 7C4.67 7 4 6.33 4 5.5S4.67 4 5.5 4 7 4.67 7 5.5 6.33 7 5.5 7z" }) }), _jsx(Span, { className: "hidden sm:inline", children: "Today's Deals" })] })) : null;
     const themeBtn = onToggleTheme ? (_jsx(Button, { type: "button", variant: "ghost", size: "sm", "aria-label": isDark ? "Switch to light mode" : "Switch to dark mode", onClick: onToggleTheme, className: iconBtn, children: isDark ? (_jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M12 3v1m0 16v1m8.66-9h-1M4.34 12h-1m15.07-6.07-.71.71M6.34 17.66l-.71.71m12.73 0-.71-.71M6.34 6.34l-.71-.71M12 5a7 7 0 1 0 0 14A7 7 0 0 0 12 5z" }) })) : (_jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M21 12.79A9 9 0 1 1 11.21 3a7 7 0 1 0 9.79 9.79z" }) })) })) : null;
+    const tourBtn = onTourStart ? (_jsx(Button, { type: "button", variant: "ghost", size: "sm", "aria-label": "Start product tour", onClick: onTourStart, className: iconBtn, children: _jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M8.228 9c.549-1.165 2.03-2 3.772-2 2.21 0 4 1.343 4 3 0 1.4-1.278 2.575-3.006 2.907-.542.104-.994.54-.994 1.093m0 3h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" }) }) })) : null;
     const hamburgerBtn = !hideSidebarToggle ? (_jsx(Button, { type: "button", variant: "ghost", size: "sm", "aria-label": sidebarOpen ? "Close menu" : hasDashboardNav ? "Open dashboard navigation" : "Open menu", "aria-expanded": sidebarOpen, "aria-controls": "secondary-sidebar", onClick: hasDashboardNav && onToggleDashboardNav ? onToggleDashboardNav : onToggleSidebar, className: iconBtn, children: _jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: sidebarOpen ? (_jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" })) : (_jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M4 6h16M4 12h16M4 18h16" })) }) })) : null;
     // Compare is always lg+ (desktop-only feature, less critical on mobile)
     const compareEl = compareHref ? (_jsx(Link, { href: compareHref, "aria-label": "Compare items", className: `${iconBtn} hidden lg:flex`, children: _jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z" }) }) })) : null;
@@ -34,5 +35,5 @@ export function TitleBarLayout({ onToggleSidebar, sidebarOpen, onSearchToggle, s
     // ── Render ───────────────────────────────────────────────────────────────────
     return (_jsxs(BlockHeader, { id: id, className: `sticky top-0 z-50 bg-white/95 dark:bg-slate-950/95 backdrop-blur-md border-b border-zinc-100 dark:border-slate-800 shadow-sm ${className}`, children: [promoStripText && (_jsx(Section, { color: "inverse", tone: "accent-banner", className: "text-xs text-center font-medium", padding: "y-2xs", children: promoStripText })), _jsxs(Div, { paddingX: "x-page", className: "container mx-auto max-w-[1920px]", children: [_jsxs(Row, { justify: "between", gap: "none", className: "relative h-14", children: [_jsx(Row, { gap: "3", children: _jsx(Link, { href: logoHref, "aria-label": brandName, className: "flex items-center transition-opacity hover:opacity-80", children: _jsx(SiteLogo, { title: brandName, size: "md" }) }) }), siteLogoUrl ? (_jsx(Row, { className: "absolute inset-y-0 left-1/2 -translate-x-1/2", align: "center", children: _jsx(Link, { href: logoHref, "aria-label": brandName, className: "flex items-center transition-opacity hover:opacity-80", children: _jsx(SiteLogo, { src: siteLogoUrl, title: brandName, size: "md" }) }) })) : (navSlot && _jsx(Div, { className: "hidden md:flex", children: navSlot })), _jsxs(Row, { gap: "xs", children: [devSlot, compareEl, notificationSlot, notificationsEl && _jsx(Div, { className: "hidden lg:flex", children: notificationsEl }), wishlistEl && _jsx(Div, { className: "hidden lg:flex", children: wishlistEl }), cartEl && _jsx(Div, { className: "hidden lg:flex", children: cartEl }), user
                                         ? profileEl && _jsx(Div, { className: "hidden lg:flex", children: profileEl })
-                                        : authButtonsEl ?? (profileEl && _jsx(Div, { className: "hidden lg:flex", children: profileEl })), searchBtn, promotionsEl, themeBtn, hamburgerBtn] })] }), hasTb2 && (_jsxs(Row, { border: "subtle", as: "nav", "aria-label": "Account actions", justify: "end", gap: "xs", className: "flex lg:hidden h-10 border-t px-1", children: [notificationsEl, wishlistEl, cartEl, profileEl] }))] })] }));
+                                        : authButtonsEl ?? (profileEl && _jsx(Div, { className: "hidden lg:flex", children: profileEl })), searchBtn, promotionsEl, tourBtn, themeBtn, hamburgerBtn] })] }), hasTb2 && (_jsxs(Row, { border: "subtle", as: "nav", "aria-label": "Account actions", justify: "end", gap: "xs", className: "flex lg:hidden h-10 border-t px-1", children: [notificationsEl, wishlistEl, cartEl, profileEl] }))] })] }));
 }

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

@@ -37,6 +37,7 @@ export declare const PaymentStatusValues: {
 /** Runtime-accessible payment method values â€" use instead of bare string literals. */
 export declare const PaymentMethodValues: {
     readonly COD: "cod";
+    readonly CASH: "cash";
     readonly ONLINE: "online";
     readonly UPI_MANUAL: "upi_manual";
     readonly RAZORPAY: "razorpay";
@@ -209,6 +210,14 @@ export interface OrderDocument extends BaseDocument {
     pickedAt?: Date;
     /** Timestamp when the order was packed and ready for courier handoff. */
     packedAt?: Date;
+    /** Media slug for buyer-uploaded UPI/bank screenshot (via /api/media proxy). */
+    paymentProofUrl?: string;
+    /** UTR / transaction reference entered by the buyer. */
+    paymentTransactionId?: string;
+    /** MIME type detected at finalize step (image/jpeg, image/png, application/pdf). */
+    paymentProofMimeType?: string;
+    /** When the buyer submitted the proof. */
+    paymentProofUploadedAt?: Date;
 }
 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

@@ -31,6 +31,7 @@ export const PaymentStatusValues = {
 /** Runtime-accessible payment method values â€" use instead of bare string literals. */
 export const PaymentMethodValues = {
     COD: "cod",
+    CASH: "cash",
     ONLINE: "online",
     UPI_MANUAL: "upi_manual",
     RAZORPAY: "razorpay",

package/dist/features/products/components/ProductForm.js

@@ -11,6 +11,7 @@ import { ImageUpload, MediaUploadField, MediaUploadList, } from "../../media";
 import { useMediaUpload } from "../../media";
 import { resolveDate } from "../../../utils/date.formatter";
 import { normalizeRichTextHtml } from "../../../utils/string.formatter";
+import { useListingTypeFlags } from "../../../react/hooks/useListingTypeFlags";
 import { isAuctionListing, isPreOrderListing, isPrizeDrawListing, } from "../utils/listing-type";
 import { PrizeDrawItemsEditor } from "./PrizeDrawItemsEditor";
 export const PRODUCT_STATUS_OPTIONS = [
@@ -30,6 +31,7 @@ export function ProductForm({ product, onChange, isReadonly = false, renderDescr
     const t = useTranslations("adminProducts");
     const { upload } = useMediaUpload();
     const galleryIndexRef = useRef(0);
+    const listingTypeFlags = useListingTypeFlags();
     const update = (partial) => {
         onChange({ ...product, ...partial });
     };
@@ -133,7 +135,7 @@ export function ProductForm({ product, onChange, isReadonly = false, renderDescr
                         ] })] }), _jsx(Checkbox, { label: t("formInsurance"), checked: !!product.insurance, onChange: (e) => update({
                     insurance: e.target.checked,
                     insuranceCost: e.target.checked ? product.insuranceCost || 0 : undefined,
-                }), disabled: isReadonly }), product.insurance && (_jsxs(_Fragment, { children: [_jsx(Alert, { variant: "info", title: t("formInsuranceHelp"), children: t("formInsuranceHelp") }), _jsx(FormField, { name: "insuranceCost", label: t("formInsuranceCost"), type: "number", value: String(product.insuranceCost ?? ""), onChange: (value) => update({ insuranceCost: Number(value) }), disabled: isReadonly, placeholder: `${currencyPrefix}0` })] })), _jsx(Heading, { level: 4, className: "mt-4", children: t("sectionAuctionSettings") }), _jsx(Checkbox, { label: t("formIsAuction"), checked: isAuctionListing(product), onChange: (e) => update({ listingType: e.target.checked ? "auction" : "standard" }), disabled: isReadonly }), isAuctionListing(product) && (_jsxs(_Fragment, { children: [_jsxs(FormGroup, { columns: 2, children: [_jsx(FormField, { name: "startingBid", label: t("formStartingBid"), type: "number", value: String(product.startingBid ?? ""), onChange: (value) => update({ startingBid: Number(value) }), disabled: isReadonly, placeholder: "0" }), _jsx(FormField, { name: "auctionEndDate", label: t("formAuctionEndDate"), type: "datetime-local", value: (() => {
+                }), disabled: isReadonly }), product.insurance && (_jsxs(_Fragment, { children: [_jsx(Alert, { variant: "info", title: t("formInsuranceHelp"), children: t("formInsuranceHelp") }), _jsx(FormField, { name: "insuranceCost", label: t("formInsuranceCost"), type: "number", value: String(product.insuranceCost ?? ""), onChange: (value) => update({ insuranceCost: Number(value) }), disabled: isReadonly, placeholder: `${currencyPrefix}0` })] })), listingTypeFlags.auction && (_jsxs(_Fragment, { children: [_jsx(Heading, { level: 4, className: "mt-4", children: t("sectionAuctionSettings") }), _jsx(Checkbox, { label: t("formIsAuction"), checked: isAuctionListing(product), onChange: (e) => update({ listingType: e.target.checked ? "auction" : "standard" }), disabled: isReadonly })] })), isAuctionListing(product) && (_jsxs(_Fragment, { children: [_jsxs(FormGroup, { columns: 2, children: [_jsx(FormField, { name: "startingBid", label: t("formStartingBid"), type: "number", value: String(product.startingBid ?? ""), onChange: (value) => update({ startingBid: Number(value) }), disabled: isReadonly, placeholder: "0" }), _jsx(FormField, { name: "auctionEndDate", label: t("formAuctionEndDate"), type: "datetime-local", value: (() => {
                                     const d = resolveDate(product.auctionEndDate);
                                     if (!d)
                                         return "";
@@ -143,8 +145,8 @@ export function ProductForm({ product, onChange, isReadonly = false, renderDescr
                         }), disabled: isReadonly, options: [
                             { value: "winner", label: t("formAuctionShippingPaidByWinner") },
                             { value: "seller", label: t("formAuctionShippingPaidBySeller") },
-                        ] }), _jsx(Text, { variant: "secondary", weight: "semibold", className: "mt-2", children: t("sectionAuctionAdvanced") }), _jsx(Checkbox, { label: t("formAutoExtendable"), checked: !!product.autoExtendable, onChange: (e) => update({ autoExtendable: e.target.checked }), disabled: isReadonly }), product.autoExtendable && (_jsxs(_Fragment, { children: [_jsx(Alert, { variant: "info", title: t("formAutoExtendableHelp"), children: t("formAutoExtendableHelp") }), _jsx(FormField, { name: "auctionExtensionMinutes", label: t("formAuctionExtensionMinutes"), type: "number", value: String(product.auctionExtensionMinutes ?? 5), onChange: (value) => update({ auctionExtensionMinutes: Number(value) || 5 }), disabled: isReadonly, placeholder: "5", helpText: t("formAuctionExtensionMinutesHelp") })] }))] })), _jsx(Heading, { level: 4, className: "mt-4", children: t("sectionPreOrderSettings") }), _jsx(Checkbox, { label: t("formIsPreOrder"), checked: isPreOrderListing(product), onChange: (e) => update({ listingType: e.target.checked ? "pre-order" : "standard" }), disabled: isReadonly }), _jsx(Heading, { level: 4, className: "mt-4", children: "Prize Draw Settings" }), _jsx(Checkbox, { label: "This is a prize-draw listing", checked: isPrizeDrawListing(product), onChange: (e) => update({ listingType: e.target.checked ? "prize-draw" : "standard" }), disabled: isReadonly ||
-                    (product.prizeDrawItems ?? []).some((it) => it.isWon) }), isPrizeDrawListing(product) && ((() => {
+                        ] }), _jsx(Text, { variant: "secondary", weight: "semibold", className: "mt-2", children: t("sectionAuctionAdvanced") }), _jsx(Checkbox, { label: t("formAutoExtendable"), checked: !!product.autoExtendable, onChange: (e) => update({ autoExtendable: e.target.checked }), disabled: isReadonly }), product.autoExtendable && (_jsxs(_Fragment, { children: [_jsx(Alert, { variant: "info", title: t("formAutoExtendableHelp"), children: t("formAutoExtendableHelp") }), _jsx(FormField, { name: "auctionExtensionMinutes", label: t("formAuctionExtensionMinutes"), type: "number", value: String(product.auctionExtensionMinutes ?? 5), onChange: (value) => update({ auctionExtensionMinutes: Number(value) || 5 }), disabled: isReadonly, placeholder: "5", helpText: t("formAuctionExtensionMinutesHelp") })] }))] })), listingTypeFlags["pre-order"] && (_jsxs(_Fragment, { children: [_jsx(Heading, { level: 4, className: "mt-4", children: t("sectionPreOrderSettings") }), _jsx(Checkbox, { label: t("formIsPreOrder"), checked: isPreOrderListing(product), onChange: (e) => update({ listingType: e.target.checked ? "pre-order" : "standard" }), disabled: isReadonly })] })), listingTypeFlags["prize-draw"] && (_jsxs(_Fragment, { children: [_jsx(Heading, { level: 4, className: "mt-4", children: "Prize Draw Settings" }), _jsx(Checkbox, { label: "This is a prize-draw listing", checked: isPrizeDrawListing(product), onChange: (e) => update({ listingType: e.target.checked ? "prize-draw" : "standard" }), disabled: isReadonly ||
+                            (product.prizeDrawItems ?? []).some((it) => it.isWon) })] })), isPrizeDrawListing(product) && ((() => {
                 const prizeItems = (product.prizeDrawItems ?? []);
                 const anyWon = prizeItems.some((it) => it.isWon);
                 const lockedForReveal = anyWon;

package/dist/next/routing/route-map.d.ts

@@ -127,6 +127,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly ORDER_CANCEL: (id: string) => string;
         readonly ORDER_TRACK: (id: string) => string;
         readonly ORDER_INVOICE: (id: string) => string;
+        readonly ORDER_PAYMENT: (id: string) => string;
         readonly NOTIFICATIONS: "/user/notifications";
         readonly MESSAGES: "/user/messages";
         /** Plan §10 — claimed-coupons wallet (Active / Expired / Used tabs). */
@@ -463,6 +464,7 @@ export declare const ROUTES: {
         readonly ORDER_CANCEL: (id: string) => string;
         readonly ORDER_TRACK: (id: string) => string;
         readonly ORDER_INVOICE: (id: string) => string;
+        readonly ORDER_PAYMENT: (id: string) => string;
         readonly NOTIFICATIONS: "/user/notifications";
         readonly MESSAGES: "/user/messages";
         /** Plan §10 — claimed-coupons wallet (Active / Expired / Used tabs). */

package/dist/next/routing/route-map.js

@@ -115,6 +115,7 @@ export const DEFAULT_ROUTE_MAP = {
         ORDER_CANCEL: (id) => `/user/orders/${id}/cancel`,
         ORDER_TRACK: (id) => `/user/orders/${id}/track`,
         ORDER_INVOICE: (id) => `/user/orders/${id}/invoice`,
+        ORDER_PAYMENT: (id) => `/user/orders/${id}/payment`,
         NOTIFICATIONS: "/user/notifications",
         MESSAGES: "/user/messages",
         /** Plan §10 — claimed-coupons wallet (Active / Expired / Used tabs). */

package/dist/seed/orders-seed-data.js

@@ -291,4 +291,58 @@ for (let i = _rawOrdersSeedData.length; i < 50; i++) {
         updatedAt: daysAgo(Math.max(0, daysBack - 10)),
     });
 }
-export const ordersSeedData = [..._rawOrdersSeedData, ...expandedOrders].slice(0, 50);
+// P-1 MVP: two cash/UPI manual payment orders for demo purposes.
+// cashOrderPendingProof: buyer submitted proof, admin has NOT yet verified.
+const cashOrderPendingProof = {
+    id: "order-1-20260729-cash01",
+    productId: "product-dark-magician-lob-1st",
+    productTitle: "Dark Magician — LOB 1st Edition",
+    userId: "user-yugi-muto",
+    userName: "Yugi Muto",
+    userEmail: "yugi@duelkingdom.in",
+    storeId: "store-kaiba-corp-cards",
+    quantity: 1,
+    unitPrice: 499900,
+    totalPrice: 499900,
+    currency: "INR",
+    status: "pending",
+    paymentStatus: "pending",
+    paymentMethod: "cash",
+    paymentProofUrl: "/media/payment-proof-demo-pending.jpg",
+    paymentTransactionId: "UPI-DEMO-20260728-PROOF",
+    paymentProofMimeType: "image/jpeg",
+    paymentProofUploadedAt: daysAgo(1),
+    shippingAddress: "addr-yugi-home",
+    orderDate: daysAgo(2),
+    createdAt: daysAgo(2),
+    updatedAt: daysAgo(1),
+};
+const cashOrderVerified = {
+    id: "order-1-20260729-cash02",
+    productId: "product-hot-wheels-redline-vintage",
+    productTitle: "Hot Wheels Redline — Vintage",
+    userId: "user-yugi-muto",
+    userName: "Yugi Muto",
+    userEmail: "yugi@duelkingdom.in",
+    storeId: "store-diecast-depot",
+    quantity: 1,
+    unitPrice: 129900,
+    totalPrice: 129900,
+    currency: "INR",
+    status: "processing",
+    paymentStatus: "paid",
+    paymentMethod: "cash",
+    paymentProofUrl: "/media/payment-proof-demo-verified.jpg",
+    paymentTransactionId: "UPI-DEMO-20260727-YUGI",
+    paymentProofMimeType: "image/jpeg",
+    paymentProofUploadedAt: daysAgo(3),
+    shippingAddress: "addr-yugi-home",
+    orderDate: daysAgo(4),
+    createdAt: daysAgo(4),
+    updatedAt: daysAgo(2),
+};
+export const ordersSeedData = [
+    cashOrderPendingProof,
+    cashOrderVerified,
+    ...[..._rawOrdersSeedData, ...expandedOrders].slice(0, 48),
+];

package/dist/seed/site-settings-seed-data.js

@@ -374,16 +374,26 @@ export const siteSettingsSeedData = {
         smsVerification: true,
         translations: true,
         wishlists: true,
-        auctions: true,
+        auctions: false,
         reviews: true,
-        events: true,
-        blog: true,
-        coupons: true,
+        events: false,
+        blog: false,
+        coupons: false,
         notifications: true,
         sellerRegistration: true,
-        preOrders: true,
+        preOrders: false,
         seedPanel: true,
         adminCheckoutBypass: false,
+        // P-1 MVP: only standard listing type active; others unlocked in later patches.
+        listingTypes: {
+            standard: true,
+            auction: false,
+            "pre-order": false,
+            "prize-draw": false,
+            classified: false,
+            "digital-code": false,
+            live: false,
+        },
     },
     credentials: {
         razorpayKeyId: "rzp_test_PLACEHOLDER",

package/dist/server.d.ts

@@ -6,6 +6,7 @@ export { SERVER_ERRORS_COLLECTION, SERVER_ERROR_FIELDS, SERVER_ERROR_STACK_MAX_B
 export type { ServerErrorDocument, ServerErrorSource, } from "./features/server-errors/schemas/firestore";
 export { wrapAction, isOk, unwrap, } from "./_internal/shared/types/action-result";
 export type { ActionResult } from "./_internal/shared/types/action-result";
+export { attachPaymentProofAction, adminVerifyPaymentAction, } from "./_internal/server/features/orders/actions";
 export { wrapJobHandler, wrapScheduleHandler, wrapTriggerHandler, wrapCallableHandler, } from "./_internal/server/jobs/core/wrapJobHandler";
 export { analyzeLogs } from "./_internal/server/features/maintenance/analyze";
 export type { AnalyzeOptions, AnalyzeReport, } from "./_internal/server/features/maintenance/analyze";

package/dist/server.js

@@ -11,6 +11,8 @@ export { SERVER_ERRORS_COLLECTION, SERVER_ERROR_FIELDS, SERVER_ERROR_STACK_MAX_B
 // [SERVER-ONLY] ActionResult envelope + wrapAction helper for "use server" functions.
 // Mirrors the routeHandler envelope so client wrappers consume both surfaces uniformly.
 export { wrapAction, isOk, unwrap, } from "./_internal/shared/types/action-result";
+// [SERVER-ONLY] P-1 manual payment proof server actions.
+export { attachPaymentProofAction, adminVerifyPaymentAction, } from "./_internal/server/features/orders/actions";
 // [SERVER-ONLY] Cloud Function handler wrappers — persist exceptions to
 // serverErrors (source: "function") before re-throwing so retry semantics
 // are preserved. Apply at the consumer's runtime adapter boundary.

package/dist/utils/id-generators.d.ts

@@ -242,6 +242,12 @@ export type MediaFilenameContext = ({
     refundId: string;
     ext?: string;
     date?: Date;
+} | {
+    type: "payment-proof";
+    orderId: string;
+    buyerName: string;
+    ext?: string;
+    date?: Date;
 };
 export declare function generateMediaFilename(ctx: MediaFilenameContext): string;
 export declare function validateMediaFilename(filename: string): boolean;

package/dist/utils/id-generators.js

@@ -384,6 +384,15 @@ export function generateMediaFilename(ctx) {
             const ext = ctx.ext ?? "pdf";
             return `refund-proof-${ctx.orderId}-${ctx.refundId}-${y}${m}${day}.${ext}`;
         }
+        case "payment-proof": {
+            const d = ctx.date ?? new Date();
+            const y = d.getFullYear();
+            const m = String(d.getMonth() + 1).padStart(2, "0");
+            const day = String(d.getDate()).padStart(2, "0");
+            const ext = ctx.ext ?? "jpg";
+            const name = ctx.buyerName.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "").slice(0, 20);
+            return `payment-proof-${ctx.orderId}-${name}-${y}${m}${day}.${ext}`;
+        }
     }
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "3.1.7",
+  "version": "3.2.0",
   "license": "MIT",
   "publishConfig": {
     "access": "public"