@mohasinac/appkit 3.2.19 → 3.3.0

package/dist/features/products/schemas/product-features.d.ts

@@ -20,7 +20,7 @@ export declare const MAX_STORE_CUSTOM_FEATURES = 20;
 export declare const MAX_FEATURES_PER_PRODUCT = 10;
 export type ProductFeatureScope = "platform" | "store";
 export type ProductFeatureCategory = "shipping" | "seller" | "condition" | "platform" | "auction" | "preorder" | "custom";
-export type ProductFeatureProductType = "product" | "auction" | "preorder" | "prize-draw" | "classified" | "digital-code" | "live" | "all";
+export type ProductFeatureProductType = "product" | "auction" | "preorder" | "prize-draw" | "classified" | "digital-code" | "live" | "art" | "stickers" | "all";
 /**
  * Either an appkit icon-set name key (e.g. "truck") or a raw SVG path-d string.
  * Path strings must start with "M " — see isFeatureIconPath().

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

@@ -1,6 +1,6 @@
 import type { MediaField } from "../../media/types/index";
-import type { CustomField, CustomSection } from "../schemas/firestore";
-export type { CustomField, CustomSection } from "../schemas/firestore";
+import type { CustomField, CustomSection, ProductPrintMeta } from "../schemas/firestore";
+export type { CustomField, CustomSection, ProductPrintMeta } from "../schemas/firestore";
 export type ProductStatus = "draft" | "published" | "in_review" | "archived";
 export type ProductCondition = "new" | "like_new" | "good" | "fair" | "poor" | "used" | "refurbished" | "broken" | "graded";
 /**
@@ -10,7 +10,7 @@ export type ProductCondition = "new" | "like_new" | "good" | "fair" | "poor" | "
  * accepts legacy alias tokens (`preorder` → `pre-order`, `product` → `standard`)
  * but stored values are always one of these five.
  */
-export type ListingType = "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
+export type ListingType = "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live" | "art" | "stickers";
 export interface ProductImage {
     url: string;
     thumbnailUrl?: string;
@@ -39,6 +39,8 @@ export interface ProductItem {
     };
     featured?: boolean;
     isPromoted?: boolean;
+    allowShipBeforeEmiComplete?: boolean;
+    printMeta?: ProductPrintMeta;
     currentBid?: number;
     availableQuantity?: number;
     /** @deprecated Use categorySlugs[0] */

package/dist/features/products/utils/listing-type.d.ts

@@ -33,3 +33,9 @@ export declare const isDigitalCodeListing: (input?: {
 export declare const isLiveListing: (input?: {
     listingType?: ListingType;
 }) => boolean;
+export declare const isArtListing: (input?: {
+    listingType?: ListingType;
+}) => boolean;
+export declare const isStickersListing: (input?: {
+    listingType?: ListingType;
+}) => boolean;

package/dist/features/products/utils/listing-type.js

@@ -19,6 +19,9 @@ export const isPrizeDrawListing = (input) => normalizeListingType(input) === "pr
 export const isClassifiedListing = (input) => normalizeListingType(input) === "classified";
 export const isDigitalCodeListing = (input) => normalizeListingType(input) === "digital-code";
 export const isLiveListing = (input) => normalizeListingType(input) === "live";
+// Art/stickers session — printed-only physical-goods listing types.
+export const isArtListing = (input) => normalizeListingType(input) === "art";
+export const isStickersListing = (input) => normalizeListingType(input) === "stickers";
 // SB-UNI-D — isBundleListing removed. Bundles are now a categoryType
 // discriminator on CategoryDocument; consumers should query
 // `categoriesRepository.findBySlugAndType(slug, "bundle")` instead.

package/dist/features/reviews/api/[id]/route.js

@@ -13,6 +13,7 @@ import { z } from "zod";
 import { getProviders } from "../../../../contracts";
 import { createRouteHandler } from "../../../../next";
 import { normalizeError } from "../../../../errors/normalize";
+import { isAdminUser, isModeratorUser } from "../../../auth/role-predicates";
 const ERR_REVIEW_NOT_FOUND = "Review not found";
 // ---- GET /api/reviews/[id] ---------------------------------------------------
 export async function GET(_request, context) {
@@ -70,8 +71,8 @@ export const reviewItemPATCH = createRouteHandler({
         if (!review)
             return NextResponse.json({ success: false, error: ERR_REVIEW_NOT_FOUND }, { status: 404 });
         const isOwner = review.userId === user.uid;
-        const isModerator = user.role === "moderator";
-        const isAdmin = user.role === "admin";
+        const isModerator = isModeratorUser(user);
+        const isAdmin = isAdminUser(user);
         if (!isOwner && !isModerator && !isAdmin) {
             return NextResponse.json({ success: false, error: "Forbidden" }, { status: 403 });
         }
@@ -101,8 +102,8 @@ export const reviewItemDELETE = createRouteHandler({
         if (!review)
             return NextResponse.json({ success: false, error: ERR_REVIEW_NOT_FOUND }, { status: 404 });
         const isOwner = review.userId === user.uid;
-        const isModerator = user.role === "moderator";
-        const isAdmin = user.role === "admin";
+        const isModerator = isModeratorUser(user);
+        const isAdmin = isAdminUser(user);
         if (!isOwner && !isModerator && !isAdmin) {
             return NextResponse.json({ success: false, error: "Forbidden" }, { status: 403 });
         }

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

@@ -5,13 +5,11 @@
  * explicit params. Called by letitrip thin wrappers that handle auth,
  * rate-limiting, and user-facing validation.
  *
- * Note: Shiprocket-specific actions (updateSellerShipping,
- * verifyShiprocketPickupOtp, shiprocketShipOrder) remain in the letitrip
- * thin wrapper because they use the @/lib/shiprocket/client SDK which is
- * a permanent letitrip-only dependency.
+ * Note: updateSellerShipping remains in the letitrip thin wrapper
+ * (src/actions/seller.actions.ts) alongside the other seller server actions.
  */
 import type { JsonValue } from "../../../schemas/types";
-import type { SellerPayoutDetails } from "../../auth/schemas/firestore";
+import type { SellerPayoutDetails, SellerShippingConfig } from "../../auth/schemas/firestore";
 import type { StoreDocument } from "../../stores/schemas/firestore";
 import type { ProductDocument } from "../../products/schemas/firestore";
 import type { OrderDocument } from "../../orders/schemas/firestore";
@@ -86,6 +84,14 @@ export interface CustomShipOrderInput {
     trackingNumber: string;
     trackingUrl: string;
 }
+export interface MarkEmiInstallmentPaidInput {
+    /** 1-based installment number, matches EmiInstallment.index. */
+    installmentIndex: number;
+    /** Buyer-supplied UTR/reference number for this installment's manual payment. */
+    transactionId?: string;
+    /** Signed-URL media slug for the buyer's payment proof for this installment. */
+    proofUrl?: string;
+}
 export interface SellerListParams {
     filters?: string;
     sorts?: string;
@@ -109,15 +115,7 @@ export declare function requestPayout(userId: string, userName: string, userEmai
 export declare function bulkSellerOrder(userId: string, userRole: string, userDisplayName: string, userEmail: string, orderIds: string[]): Promise<BulkSellerOrderResult>;
 export declare function createSellerProduct(userId: string, userName: string, userEmail: string, input: Record<string, JsonValue>): Promise<void>;
 export declare function getSellerStore(userId: string): Promise<StoreDocument | null>;
-export declare function getSellerShipping(userId: string): Promise<{
-    method: import("../../auth").SellerShippingMethod;
-    customShippingPrice?: number;
-    customCarrierName?: string;
-    shiprocketEmail?: string;
-    shiprocketTokenExpiry?: Date;
-    pickupAddress?: import("../../auth").SellerPickupAddress;
-    isConfigured: boolean;
-} | null>;
+export declare function getSellerShipping(userId: string): Promise<SellerShippingConfig | null>;
 export declare function getSellerPayoutSettings(userId: string): Promise<SellerPayoutDetails | {
     method: string;
     isConfigured: boolean;
@@ -166,8 +164,25 @@ export declare function listSellerMyProducts(userId: string, params?: SellerList
 }>;
 export declare function sellerUpdateProduct(userId: string, userRole: string, productId: string, input: Record<string, JsonValue>): Promise<ProductDocument>;
 export declare function sellerDeleteProduct(userId: string, userRole: string, productId: string): Promise<void>;
+/**
+ * EMI orders stay unshipped until every installment is paid, UNLESS every
+ * product in the order has its `allowShipBeforeEmiComplete` flag set. This
+ * is the single choke point for the "ship" transition, so it can't be
+ * bypassed by a different route/action reaching `orderRepository.update`
+ * directly with `status: "shipped"`.
+ */
+export declare function assertEmiShippable(order: OrderDocument): Promise<void>;
 export declare function customShipOrder(userId: string, userRole: string, orderId: string, input: CustomShipOrderInput): Promise<{
     orderId: string;
     method: string;
 }>;
+/**
+ * Records collection of one EMI installment. Seller/admin marks the
+ * installment paid after verifying the buyer's manual transfer (UTR +
+ * proof). Recomputes `emiRemainingBalance` from the still-pending
+ * installments and flips `emiComplete` once none remain — that flag is the
+ * single gate `assertEmiShippable` reads, so this is the only place an
+ * EMI order can become shippable.
+ */
+export declare function markEmiInstallmentPaid(userId: string, userRole: string, orderId: string, input: MarkEmiInstallmentPaidInput): Promise<OrderDocument>;
 export {};

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

@@ -5,10 +5,8 @@
  * explicit params. Called by letitrip thin wrappers that handle auth,
  * rate-limiting, and user-facing validation.
  *
- * Note: Shiprocket-specific actions (updateSellerShipping,
- * verifyShiprocketPickupOtp, shiprocketShipOrder) remain in the letitrip
- * thin wrapper because they use the @/lib/shiprocket/client SDK which is
- * a permanent letitrip-only dependency.
+ * Note: updateSellerShipping remains in the letitrip thin wrapper
+ * (src/actions/seller.actions.ts) alongside the other seller server actions.
  */
 import { serverLogger } from "../../../monitoring";
 import { isAdminUser, isSellerUser } from "../../auth/role-predicates";
@@ -23,7 +21,8 @@ import { payoutRepository } from "../../payments/repository/payout.repository";
 import { PAYOUT_FIELDS } from "../../payments/schemas";
 import { couponsRepository } from "../../promotions/repository/coupons.repository";
 import { generateStoreSlug } from "../../stores/schemas/firestore";
-import { DEFAULT_PLATFORM_FEE_RATE } from "../../payments/schemas/firestore";
+import { siteSettingsRepository } from "../../admin/repository/site-settings.repository";
+import { computePayoutDeduction } from "../../../_internal/shared/fees/calculator";
 import { getDefaultCurrency } from "../../../core/baseline-resolver";
 import { finalizeStagedMediaUrl, finalizeStagedMediaField, finalizeStagedMediaArray, } from "../../media/finalize";
 // --- Helper -------------------------------------------------------------------
@@ -169,14 +168,17 @@ async function computeSellerEarnings(sellerId) {
     const paidOutIds = await payoutRepository.getPaidOutOrderIds(sellerId);
     const eligibleOrders = deliveredOrders.filter((o) => !paidOutIds.has(o.id));
     const grossAmount = eligibleOrders.reduce((sum, o) => sum + (o.totalPrice ?? 0), 0);
-    const platformFee = parseFloat((grossAmount * DEFAULT_PLATFORM_FEE_RATE).toFixed(2));
-    const netAmount = parseFloat((grossAmount - platformFee).toFixed(2));
+    const siteSettings = await siteSettingsRepository.getSingleton();
+    const deduction = computePayoutDeduction(grossAmount, siteSettings.commissions);
     return {
         eligibleOrders,
         grossAmount,
-        platformFee,
-        netAmount,
+        platformFee: deduction.platformFee,
+        gatewayFee: deduction.gatewayFee,
+        gstAmount: deduction.gstOnFee,
+        netAmount: deduction.netAmount,
         productCount: products.length,
+        commissions: siteSettings.commissions,
     };
 }
 export async function requestPayout(userId, userName, userEmail, input) {
@@ -195,7 +197,11 @@ export async function requestPayout(userId, userName, userEmail, input) {
         amount: earnings.netAmount,
         grossAmount: earnings.grossAmount,
         platformFee: earnings.platformFee,
-        platformFeeRate: DEFAULT_PLATFORM_FEE_RATE,
+        platformFeeRate: earnings.commissions.platformFeePercent / 100,
+        gatewayFee: earnings.gatewayFee,
+        gatewayFeeRate: (earnings.commissions.gatewayFeePercent ?? 0) / 100,
+        gstAmount: earnings.gstAmount,
+        gstRate: earnings.commissions.gstPercent / 100,
         currency: getDefaultCurrency(),
         paymentMethod: input.paymentMethod,
         ...(input.bankAccount && { bankAccount: input.bankAccount }),
@@ -245,23 +251,32 @@ export async function bulkSellerOrder(userId, userRole, userDisplayName, userEma
             skipped.push(id);
             continue;
         }
+        if (order.emiEnabled && !order.emiComplete) {
+            // Delivered via the seller's allowShipBeforeEmiComplete override, but the
+            // buyer hasn't finished paying — hold the payout until emiComplete.
+            skipped.push(id);
+            continue;
+        }
         eligible.push(order);
     }
     if (eligible.length === 0)
         throw new ValidationError("No eligible orders found.");
-    const PLATFORM_COMMISSION_RATE = DEFAULT_PLATFORM_FEE_RATE;
     const grossAmount = eligible.reduce((sum, o) => sum + (o.totalPrice ?? 0), 0);
-    const platformFee = Math.round(grossAmount * PLATFORM_COMMISSION_RATE * 100) / 100;
-    const netAmount = Math.round((grossAmount - platformFee) * 100) / 100;
+    const bulkSiteSettings = await siteSettingsRepository.getSingleton();
+    const bulkDeduction = computePayoutDeduction(grossAmount, bulkSiteSettings.commissions);
     const payoutDoc = await payoutRepository.create({
         storeId: userId,
         sellerName: userDisplayName,
         sellerEmail: userEmail,
         orderIds: eligible.map((o) => o.id),
-        amount: netAmount,
+        amount: bulkDeduction.netAmount,
         grossAmount,
-        platformFee,
-        platformFeeRate: PLATFORM_COMMISSION_RATE,
+        platformFee: bulkDeduction.platformFee,
+        platformFeeRate: bulkSiteSettings.commissions.platformFeePercent / 100,
+        gatewayFee: bulkDeduction.gatewayFee,
+        gatewayFeeRate: (bulkSiteSettings.commissions.gatewayFeePercent ?? 0) / 100,
+        gstAmount: bulkDeduction.gstOnFee,
+        gstRate: bulkSiteSettings.commissions.gstPercent / 100,
         currency: getDefaultCurrency(),
         paymentMethod: userDoc.payoutDetails.method === "upi"
             ? "upi"
@@ -281,7 +296,7 @@ export async function bulkSellerOrder(userId, userRole, userDisplayName, userEma
         userId,
         payoutId,
         orderCount: eligible.length,
-        netAmount,
+        netAmount: bulkDeduction.netAmount,
     });
     return {
         payoutId,
@@ -289,9 +304,9 @@ export async function bulkSellerOrder(userId, userRole, userDisplayName, userEma
         skipped,
         eligibleCount: eligible.length,
         skippedCount: skipped.length,
-        netAmount,
+        netAmount: bulkDeduction.netAmount,
         grossAmount,
-        platformFee,
+        platformFee: bulkDeduction.platformFee,
     };
 }
 // --- Create Seller Product ----------------------------------------------------
@@ -314,14 +329,7 @@ export async function getSellerShipping(userId) {
     const userData = await userRepository.findById(userId);
     if (!userData)
         return null;
-    const config = userData.shippingConfig;
-    if (!config)
-        return null;
-    if (config.method === "shiprocket" && config.shiprocketToken) {
-        const { shiprocketToken: _removed, ...safe } = config;
-        return safe;
-    }
-    return config;
+    return userData.shippingConfig ?? null;
 }
 export async function getSellerPayoutSettings(userId) {
     const userData = await userRepository.findById(userId);
@@ -458,6 +466,23 @@ export async function sellerDeleteProduct(userId, userRole, productId) {
     serverLogger.info("sellerDeleteProduct", { userId, productId });
 }
 // --- Custom Ship Order --------------------------------------------------------
+/**
+ * EMI orders stay unshipped until every installment is paid, UNLESS every
+ * product in the order has its `allowShipBeforeEmiComplete` flag set. This
+ * is the single choke point for the "ship" transition, so it can't be
+ * bypassed by a different route/action reaching `orderRepository.update`
+ * directly with `status: "shipped"`.
+ */
+export async function assertEmiShippable(order) {
+    if (!order.emiEnabled || order.emiComplete)
+        return;
+    const productIds = (order.items ?? []).map((i) => i.productId).filter(Boolean);
+    const products = await Promise.all(productIds.map((id) => productRepository.findById(id)));
+    const allAllowEarlyShip = products.length > 0 && products.every((p) => p?.allowShipBeforeEmiComplete === true);
+    if (!allAllowEarlyShip) {
+        throw new ValidationError("This order is still on an EMI plan — it can't ship until all installments are paid, unless the seller has enabled early shipping for every item in the order.");
+    }
+}
 export async function customShipOrder(userId, userRole, orderId, input) {
     const order = await orderRepository.findById(orderId);
     if (!order)
@@ -469,6 +494,7 @@ export async function customShipOrder(userId, userRole, orderId, input) {
         throw new ValidationError("Order is already shipped");
     if (order.status !== OrderStatusValues.CONFIRMED)
         throw new ValidationError("Order must be confirmed before shipping");
+    await assertEmiShippable(order);
     await orderRepository.update(orderId, {
         status: OrderStatusValues.SHIPPED,
         shippingMethod: "custom",
@@ -485,3 +511,51 @@ export async function customShipOrder(userId, userRole, orderId, input) {
     });
     return { orderId, method: "custom" };
 }
+/**
+ * Records collection of one EMI installment. Seller/admin marks the
+ * installment paid after verifying the buyer's manual transfer (UTR +
+ * proof). Recomputes `emiRemainingBalance` from the still-pending
+ * installments and flips `emiComplete` once none remain — that flag is the
+ * single gate `assertEmiShippable` reads, so this is the only place an
+ * EMI order can become shippable.
+ */
+export async function markEmiInstallmentPaid(userId, userRole, orderId, input) {
+    const order = await orderRepository.findById(orderId);
+    if (!order)
+        throw new NotFoundError("Order not found");
+    if (userRole !== "admin" && order.storeId !== userId)
+        throw new AuthorizationError("You do not own this order");
+    if (!order.emiEnabled)
+        throw new ValidationError("This order is not on an EMI plan");
+    const installments = order.emiInstallments ?? [];
+    const target = installments.find((i) => i.index === input.installmentIndex);
+    if (!target)
+        throw new ValidationError(`Installment ${input.installmentIndex} not found on this order`);
+    if (target.status === "paid")
+        throw new ValidationError("This installment is already marked paid");
+    const updatedInstallments = installments.map((i) => i.index === input.installmentIndex
+        ? {
+            ...i,
+            status: "paid",
+            paidAt: new Date(),
+            transactionId: input.transactionId,
+            proofUrl: input.proofUrl,
+        }
+        : i);
+    const emiRemainingBalance = updatedInstallments
+        .filter((i) => i.status !== "paid")
+        .reduce((sum, i) => sum + i.amount, 0);
+    const emiComplete = updatedInstallments.every((i) => i.status === "paid");
+    const updated = await orderRepository.update(orderId, {
+        emiInstallments: updatedInstallments,
+        emiRemainingBalance,
+        emiComplete,
+    });
+    serverLogger.info("markEmiInstallmentPaid", {
+        orderId,
+        userId,
+        installmentIndex: input.installmentIndex,
+        emiComplete,
+    });
+    return updated;
+}

package/dist/features/seller/components/FulfillmentView.js

@@ -31,7 +31,6 @@ export function FulfillmentView({ currentUserId, }) {
     const [actionLoadingId, setActionLoadingId] = useState(null);
     const { showToast } = useToast();
     const fetchOrders = useCallback(async () => {
-        // toast-intentionally-silent: background data loader — normalizeError logs, no user-facing toast needed
         setIsLoadingOrders(true);
         try {
             const res = await apiClient.get(SELLER_ENDPOINTS.ORDERS_FULFILLMENT);

package/dist/features/seller/components/SellerAddressesView.js

@@ -68,7 +68,6 @@ export function SellerAddressesView({ apiBase = SELLER_ENDPOINTS.STORE_ADDRESSES
     const [saveError, setSaveError] = useState(null);
     const [deleteTargetAddr, setDeleteTargetAddr] = useState(null);
     const load = useCallback(async () => {
-        // toast-intentionally-silent: background address loader — error displayed in inline errorMessage state
         setIsLoading(true);
         setErrorMessage(null);
         try {

package/dist/features/seller/components/SellerArtView.d.ts

@@ -0,0 +1,7 @@
+export interface SellerArtViewProps {
+    onCreateClick?: () => void;
+    onEditClick?: (id: string) => void;
+    onDelete?: (id: string) => Promise<void>;
+    onBulkDelete?: (ids: string[]) => Promise<void>;
+}
+export declare function SellerArtView({ onCreateClick, onEditClick, onDelete, onBulkDelete, }: SellerArtViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/seller/components/SellerArtView.js

@@ -0,0 +1,114 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * SellerArtView — seller browse/manage of art print listings
+ * (EMI/art-stickers session). Mirrors SellerClassifiedView's pattern.
+ */
+import { Badge, sortBy } from "@mohasinac/appkit";
+import { useState, useCallback } from "react";
+import { useEntityDelete } from "../../../react/hooks/useEntityDelete";
+import { ConfirmDeleteModal, RowActionMenu, Text } from "../../../ui";
+import { SELLER_ENDPOINTS } from "../../../constants/api-endpoints";
+import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
+import { ROUTES } from "../../..";
+import { toRecordArray, toRelativeDate, toRupees, toStringValue, } from "../../admin/hooks/useAdminListingData";
+import { DataListingView } from "../../admin/components/DataListingView";
+const COLUMNS = [
+    { key: "title", header: "Listing", render: (row) => _jsx(Text, { size: "sm", weight: "medium", children: row.title }) },
+    { key: "price", header: "Price", render: (row) => _jsx(Text, { className: "tabular-nums", size: "sm", children: row.price }) },
+    {
+        key: "size",
+        header: "Size",
+        render: (row) => _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: row.size || "—" }),
+    },
+    {
+        key: "status",
+        header: "Status",
+        render: (row) => (_jsx(Badge, { variant: row.status === "active" ? "active" : "inactive", size: "xs", className: "capitalize", children: row.status })),
+    },
+    {
+        key: "createdAt",
+        header: "Created",
+        render: (row) => _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: row.createdAt }),
+    },
+];
+export function SellerArtView({ onCreateClick, onEditClick, onDelete, onBulkDelete, }) {
+    const [deleteTargetId, setDeleteTargetId] = useState(null);
+    const { deletingId, handleDelete: performDelete } = useEntityDelete({
+        endpoint: (id) => `/api/store/products/${id}`,
+        deleteFn: onDelete,
+        successMessage: "Listing deleted.",
+        fetchOptions: { credentials: "include" },
+    });
+    const handleDelete = useCallback(async (id) => {
+        await performDelete(id);
+        setDeleteTargetId(null);
+    }, [performDelete]);
+    const handleEdit = useCallback((id) => {
+        if (onEditClick)
+            onEditClick(id);
+        else
+            window.location.href = String(ROUTES.STORE.ART_EDIT(id));
+    }, [onEditClick]);
+    const handleCreate = useCallback(() => {
+        if (onCreateClick)
+            onCreateClick();
+        else
+            window.location.href = String(ROUTES.STORE.ART_NEW);
+    }, [onCreateClick]);
+    const config = {
+        portal: "seller",
+        title: "Art",
+        searchPlaceholder: "Search art prints...",
+        emptyLabel: "No art listings yet — list your first print",
+        filterKeys: [],
+        defaultSort: sortBy("createdAt", "DESC"),
+        queryKey: ["seller", "art"],
+        endpoint: SELLER_ENDPOINTS.PRODUCTS,
+        sortOptions: [
+            { value: sortBy("createdAt", "DESC"), label: "Newest" },
+            { value: sortBy("createdAt", "ASC"), label: "Oldest" },
+            { value: "productTitle", label: "Name A–Z" },
+            { value: sortBy("price", "ASC"), label: "Price: Low–High" },
+            { value: sortBy("price", "DESC"), label: "Price: High–Low" },
+        ],
+        columns: COLUMNS,
+        mapRows: (response) => toRecordArray(response.products).map((item, index) => {
+            const printMeta = (item.printMeta ?? {});
+            return {
+                id: toStringValue(item.id, `art-${index}`),
+                title: toStringValue(item.productTitle ?? item.title, "Untitled"),
+                price: toRupees(item.price),
+                size: toStringValue(printMeta.size, ""),
+                status: toStringValue(item.status, "draft"),
+                createdAt: toRelativeDate(item.createdAt),
+            };
+        }),
+        getTotal: (response, mappedRows) => typeof response.meta?.total === "number" ? response.meta.total : mappedRows.length,
+        buildFilters: () => "listingType==art",
+        primaryAction: { label: "New Art Print", onClick: () => handleCreate() },
+        buildBulkActions: onBulkDelete
+            ? (selection) => [
+                {
+                    id: "bulk-delete",
+                    label: ACTIONS.STORE["delete-listing"].label,
+                    variant: "danger",
+                    onClick: async () => {
+                        await onBulkDelete(selection.selectedIds);
+                        selection.clearSelection();
+                    },
+                },
+            ]
+            : undefined,
+        renderRowActions: (row) => (_jsx(RowActionMenu, { actions: [
+                { label: ACTIONS.STORE["edit-listing"].label, onClick: () => handleEdit(row.id) },
+                {
+                    label: ACTIONS.STORE["delete-listing"].label,
+                    destructive: true,
+                    onClick: () => setDeleteTargetId(row.id),
+                    disabled: deletingId === row.id,
+                },
+            ] })),
+    };
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), deleteTargetId && (_jsx(ConfirmDeleteModal, { isOpen: true, title: "Delete Art Listing", message: "Are you sure you want to delete this art listing? This cannot be undone.", onConfirm: () => handleDelete(deleteTargetId), onClose: () => setDeleteTargetId(null), isDeleting: deletingId === deleteTargetId }))] }));
+}

package/dist/features/seller/components/SellerOffersPanel.js

@@ -117,7 +117,6 @@ export function SellerOffersPanel({ fetchEndpoint = "/api/store/offers", onRespo
     const [showLoginModal, setShowLoginModal] = useState(false);
     const [statusFilter, setStatusFilter] = useState("all");
     const loadOffers = useCallback(async () => {
-        // toast-intentionally-silent: background data loader — error displayed in inline fetchError state
         setLoading(true);
         setFetchError("");
         try {

package/dist/features/seller/components/SellerOrdersView.js

@@ -48,6 +48,11 @@ const UPDATE_STATUS_OPTIONS = [
     { value: "delivered", label: "Delivered" },
     { value: "cancelled", label: "Cancelled" },
 ];
+const EMI_INSTALLMENT_BADGE_VARIANT = {
+    paid: "success",
+    pending: "warning",
+    overdue: "danger",
+};
 // ---------------------------------------------------------------------------
 // Order Detail Drawer
 // ---------------------------------------------------------------------------
@@ -61,6 +66,9 @@ function OrderDetailDrawer({ orderId, apiBase, onClose, }) {
     const [trackingNumber, setTrackingNumber] = useState("");
     const [carrier, setCarrier] = useState("");
     const [trackingUrl, setTrackingUrl] = useState("");
+    const [markingPaidIndex, setMarkingPaidIndex] = useState(null);
+    const [emiError, setEmiError] = useState(null);
+    const { showToast } = useToast();
     React.useEffect(() => {
         setLoading(true);
         setFetchError(null);
@@ -76,6 +84,31 @@ function OrderDetailDrawer({ orderId, apiBase, onClose, }) {
             .catch(() => setFetchError("Failed to load order details"))
             .finally(() => setLoading(false));
     }, [orderId, apiBase]);
+    const handleMarkInstallmentPaid = async (installmentIndex) => {
+        setMarkingPaidIndex(installmentIndex);
+        setEmiError(null);
+        try {
+            const res = await fetch(`${apiBase}/${orderId}/emi-installment`, {
+                method: "PATCH",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ installmentIndex }),
+            });
+            const json = await res.json().catch(() => ({}));
+            if (!res.ok)
+                throw new Error(json?.error ?? "Failed to mark installment paid");
+            setOrder(json?.data ?? json);
+            showToast("Installment marked paid.", "success");
+        }
+        catch (err) {
+            void normalizeError(err);
+            const message = err instanceof Error ? err.message : "Failed to mark installment paid.";
+            setEmiError(message);
+            showToast(message, "error");
+        }
+        finally {
+            setMarkingPaidIndex(null);
+        }
+    };
     const handleSave = async () => {
         if (!order)
             return;
@@ -118,7 +151,11 @@ function OrderDetailDrawer({ orderId, apiBase, onClose, }) {
     };
     const addr = order?.shippingAddress ?? {};
     const addrLine = [addr.addressLine1, addr.city, addr.state, addr.pincode].filter(Boolean).join(", ");
-    return (_jsxs(SideDrawer, { isOpen: true, title: `Order ${order?.id ?? orderId}`, onClose: onClose, children: [loading && (_jsx(Row, { align: "center", justify: "center", padding: "y-4xl", children: _jsx(Div, { className: "h-6 w-6 animate-spin border-2 border-[var(--appkit-color-primary)] border-t-transparent", rounded: "full" }) })), fetchError && (_jsx(Div, { textSize: "sm", className: "mx-4 mt-4 border border-error/20", color: "error", surface: "danger-surface", padding: "inline", rounded: "lg", children: fetchError })), order && !loading && (_jsxs(Stack, { gap: "none", children: [_jsxs(Stack, { className: `flex-1 ${__O.yAuto}`, gap: "5", padding: "md", children: [_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Badge, { variant: STATUS_BADGE_VARIANT[order.status?.toUpperCase()] ?? "default", children: order.status ?? "Unknown" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: toRelativeDate(order.createdAt) })] }), (order.items ?? []).length > 0 && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-primary)] mb-2", weight: "semibold", children: "Items" }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.items ?? []).map((item, i) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { className: "min-w-0", children: [_jsx(Text, { size: "sm", className: "truncate", weight: "medium", children: item.title ?? item.productId ?? "Item" }), _jsxs(Text, { size: "xs", className: "text-[var(--appkit-color-text-secondary)]", children: ["Qty: ", item.quantity ?? 1] })] }), _jsx(Text, { size: "sm", className: "shrink-0", weight: "medium", children: toRupees(item.price ?? 0) })] }, i))) })] })), _jsxs(Row, { surface: "muted", padding: "inline", align: "center", justify: "between", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Total" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-primary)]", weight: "bold", children: toRupees(order.totalAmount ?? 0) })] }), addrLine && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Shipping address" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: [String(addr.fullName ?? ""), addrLine].filter(Boolean).join(" · ") })] })), order.paymentMethod && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Payment" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", transform: "capitalize", children: order.paymentMethod })] })), _jsxs(Stack, { className: "border-t border-[var(--appkit-color-border)]", padding: "t-md", gap: "3", children: [_jsx(Heading, { level: 4, size: "sm", weight: "semibold", children: "Update order" }), _jsx(Select, { label: "New status", value: newStatus, options: UPDATE_STATUS_OPTIONS, onChange: (e) => setNewStatus(e.target.value) }), _jsx(Input, { label: "Tracking number", value: trackingNumber, onChange: (e) => setTrackingNumber(e.target.value), placeholder: "e.g. 12345678901234" }), _jsx(Input, { label: "Carrier", value: carrier, onChange: (e) => setCarrier(e.target.value), placeholder: "e.g. Delhivery, Bluedart" }), _jsx(Input, { label: "Tracking URL (optional)", value: trackingUrl, onChange: (e) => setTrackingUrl(e.target.value), placeholder: "https://...", type: "url" }), saveError && (_jsx(Div, { textSize: "xs", className: "border border-error/20", color: "error", surface: "danger-surface", padding: "inlineSm", rounded: "lg", children: saveError }))] })] }), _jsxs(Row, { border: "top", paddingY: "y-sm-tall", padding: "x-md", align: "center", justify: "end", gap: "3", children: [_jsx(Button, { variant: "outline", onClick: onClose, disabled: saving, children: "Close" }), _jsx(Button, { onClick: handleSave, isLoading: saving, disabled: saving, children: "Save" })] })] }))] }));
+    return (_jsxs(SideDrawer, { isOpen: true, title: `Order ${order?.id ?? orderId}`, onClose: onClose, children: [loading && (_jsx(Row, { align: "center", justify: "center", padding: "y-4xl", children: _jsx(Div, { className: "h-6 w-6 animate-spin border-2 border-[var(--appkit-color-primary)] border-t-transparent", rounded: "full" }) })), fetchError && (_jsx(Div, { textSize: "sm", className: "mx-4 mt-4 border border-error/20", color: "error", surface: "danger-surface", padding: "inline", rounded: "lg", children: fetchError })), order && !loading && (_jsxs(Stack, { gap: "none", children: [_jsxs(Stack, { className: `flex-1 ${__O.yAuto}`, gap: "5", padding: "md", children: [_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Badge, { variant: STATUS_BADGE_VARIANT[order.status?.toUpperCase()] ?? "default", children: order.status ?? "Unknown" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: toRelativeDate(order.createdAt) })] }), (order.items ?? []).length > 0 && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-primary)] mb-2", weight: "semibold", children: "Items" }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.items ?? []).map((item, i) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { className: "min-w-0", children: [_jsx(Text, { size: "sm", className: "truncate", weight: "medium", children: item.title ?? item.productId ?? "Item" }), _jsxs(Text, { size: "xs", className: "text-[var(--appkit-color-text-secondary)]", children: ["Qty: ", item.quantity ?? 1] })] }), _jsx(Text, { size: "sm", className: "shrink-0", weight: "medium", children: toRupees(item.price ?? 0) })] }, i))) })] })), _jsxs(Row, { surface: "muted", padding: "inline", align: "center", justify: "between", rounded: "lg", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Total" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-primary)]", weight: "bold", children: toRupees(order.totalAmount ?? 0) })] }), addrLine && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Shipping address" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", children: [String(addr.fullName ?? ""), addrLine].filter(Boolean).join(" · ") })] })), order.paymentMethod && (_jsxs(Div, { children: [_jsx(Text, { size: "sm", className: "mb-1", weight: "semibold", children: "Payment" }), _jsx(Text, { size: "sm", className: "text-[var(--appkit-color-text-secondary)]", transform: "capitalize", children: order.paymentMethod })] })), order.emiEnabled && (_jsxs(Div, { className: "border-t border-[var(--appkit-color-border)]", padding: "t-md", children: [_jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsxs(Text, { size: "sm", weight: "semibold", children: ["EMI plan ", order.emiTenureMonths ? `· ${order.emiTenureMonths} months` : ""] }), _jsx(Badge, { variant: order.emiComplete ? "success" : "warning", children: order.emiComplete ? "Fully paid" : "In progress" })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-2", children: [_jsx(Text, { size: "xs", color: "muted", children: "Token collected" }), _jsx(Text, { size: "xs", weight: "medium", children: toRupees(order.emiTokenAmount ?? 0) })] }), _jsxs(Row, { align: "center", justify: "between", className: "mb-3", children: [_jsx(Text, { size: "xs", color: "muted", children: "Remaining balance" }), _jsx(Text, { size: "xs", weight: "medium", children: toRupees(order.emiRemainingBalance ?? 0) })] }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)] border border-[var(--appkit-color-border)]", rounded: "lg", children: (order.emiInstallments ?? []).map((inst) => (_jsxs(Row, { paddingY: "y-xs-tall", padding: "x-sm", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { className: "min-w-0", children: [_jsxs(Text, { size: "sm", weight: "medium", children: ["Installment ", inst.index, " \u00B7 ", toRupees(inst.amount)] }), _jsx(Text, { size: "xs", color: "muted", children: inst.status === "paid" && inst.paidAt
+                                                                ? `Paid ${toRelativeDate(inst.paidAt)}`
+                                                                : inst.dueDate
+                                                                    ? `Due ${toRelativeDate(inst.dueDate)}`
+                                                                    : "" })] }), _jsxs(Row, { align: "center", gap: "sm", className: "shrink-0", children: [_jsx(Badge, { variant: EMI_INSTALLMENT_BADGE_VARIANT[inst.status] ?? "default", children: inst.status }), inst.status !== "paid" && (_jsx(Button, { action: ACTIONS.STORE["mark-installment-paid"], size: "sm", variant: "outline", isLoading: markingPaidIndex === inst.index, disabled: markingPaidIndex !== null, onClick: () => handleMarkInstallmentPaid(inst.index), children: "Mark paid" }))] })] }, inst.index))) }), emiError && (_jsx(Div, { textSize: "xs", className: "mt-2 border border-error/20", color: "error", surface: "danger-surface", padding: "inlineSm", rounded: "lg", children: emiError }))] })), _jsxs(Stack, { className: "border-t border-[var(--appkit-color-border)]", padding: "t-md", gap: "3", children: [_jsx(Heading, { level: 4, size: "sm", weight: "semibold", children: "Update order" }), _jsx(Select, { label: "New status", value: newStatus, options: UPDATE_STATUS_OPTIONS, onChange: (e) => setNewStatus(e.target.value) }), _jsx(Input, { label: "Tracking number", value: trackingNumber, onChange: (e) => setTrackingNumber(e.target.value), placeholder: "e.g. 12345678901234" }), _jsx(Input, { label: "Carrier", value: carrier, onChange: (e) => setCarrier(e.target.value), placeholder: "e.g. Delhivery, Bluedart" }), _jsx(Input, { label: "Tracking URL (optional)", value: trackingUrl, onChange: (e) => setTrackingUrl(e.target.value), placeholder: "https://...", type: "url" }), saveError && (_jsx(Div, { textSize: "xs", className: "border border-error/20", color: "error", surface: "danger-surface", padding: "inlineSm", rounded: "lg", children: saveError }))] })] }), _jsxs(Row, { border: "top", paddingY: "y-sm-tall", padding: "x-md", align: "center", justify: "end", gap: "3", children: [_jsx(Button, { variant: "outline", onClick: onClose, disabled: saving, children: "Close" }), _jsx(Button, { onClick: handleSave, isLoading: saving, disabled: saving, children: "Save" })] })] }))] }));
 }
 // ---------------------------------------------------------------------------
 // Main view