@mohasinac/appkit 3.2.20 → 3.3.1

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/promotions/components/CouponCard.d.ts

@@ -41,5 +41,5 @@ interface CouponCardProps {
     /** Source enum forwarded to /api/user/coupons/claim for analytics. */
     claimSource?: "manual" | "promo" | "spin" | "raffle" | "prize-draw";
 }
-export declare function CouponCard({ coupon, labels: labelsProp, onCopy, className, selectable, isSelected, onSelect, onEdit, onToggleActive, onDelete, hideClaim, claimSource, }: CouponCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function CouponCard({ coupon, labels: labelsProp, onCopy, className, selectable, isSelected, onSelect, onEdit, onToggleActive, onDelete, hideClaim, claimSource, }: CouponCardProps): import("react").JSX.Element;
 export {};

package/dist/features/promotions/components/CouponsIndexListing.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 export interface CouponsIndexListingProps {
     /** Pre-fetched coupons to show on first render */
     initialCoupons?: any[];
@@ -6,4 +7,4 @@ export interface CouponsIndexListingProps {
     /** If set, only show coupons from this store (id, for filtering) */
     storeId?: string;
 }
-export declare function CouponsIndexListing({ initialCoupons, storeSlug, storeId, }: CouponsIndexListingProps): import("react/jsx-runtime").JSX.Element;
+export declare function CouponsIndexListing({ initialCoupons, storeSlug, storeId, }: CouponsIndexListingProps): React.JSX.Element;

package/dist/features/promotions/components/PromotionsView.d.ts

@@ -12,7 +12,7 @@ export interface PromotionsViewProductSectionProps {
     renderProducts: () => React.ReactNode;
     hasProducts?: boolean;
 }
-export declare function PromotionsViewProductSection({ title, subtitle, renderProducts, hasProducts, }: PromotionsViewProductSectionProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function PromotionsViewProductSection({ title, subtitle, renderProducts, hasProducts, }: PromotionsViewProductSectionProps): React.JSX.Element | null;
 export interface PromotionsHeroProps {
     labels: {
         exclusiveOffersBadge: string;
@@ -22,7 +22,7 @@ export interface PromotionsHeroProps {
     heroBannerClass?: string;
 }
 /** Slim hero banner for the promotions page — tabs + content live in the page. */
-export declare function PromotionsHero({ labels, heroBannerClass, }: PromotionsHeroProps): import("react/jsx-runtime").JSX.Element;
+export declare function PromotionsHero({ labels, heroBannerClass, }: PromotionsHeroProps): React.JSX.Element;
 export interface PromotionsViewProps {
     labels: {
         exclusiveOffersBadge: string;
@@ -46,4 +46,4 @@ export interface PromotionsViewProps {
     renderFeaturedSection?: () => React.ReactNode;
 }
 /** @deprecated Use PromotionsHero + per-tab content in your page instead. */
-export declare function PromotionsView({ labels, hasContent, heroBannerClass, renderCoupons, couponsCount, renderDealsSection, renderFeaturedSection, }: PromotionsViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function PromotionsView({ labels, hasContent, heroBannerClass, renderCoupons, couponsCount, renderDealsSection, renderFeaturedSection, }: PromotionsViewProps): React.JSX.Element;

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/reviews/components/ReviewDetailPageView.d.ts

@@ -1,4 +1,5 @@
+import React from "react";
 export interface ReviewDetailPageViewProps {
     id: string;
 }
-export declare function ReviewDetailPageView({ id }: ReviewDetailPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function ReviewDetailPageView({ id }: ReviewDetailPageViewProps): Promise<React.JSX.Element>;

package/dist/features/reviews/components/ReviewDetailShell.d.ts

@@ -1,7 +1,8 @@
+import React from "react";
 import type { Review } from "../types";
 interface ReviewDetailShellProps {
     review: Review;
     storeHref?: string | null;
 }
-export declare function ReviewDetailShell({ review, storeHref }: ReviewDetailShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function ReviewDetailShell({ review, storeHref }: ReviewDetailShellProps): React.JSX.Element;
 export {};

package/dist/features/reviews/components/ReviewFilters.d.ts

@@ -71,4 +71,4 @@ export interface ReviewFiltersProps {
     /** Optional brand options for filter by brand */
     brandOptions?: FacetOption[];
 }
-export declare function ReviewFilters({ table, variant, brandOptions, }: ReviewFiltersProps): import("react/jsx-runtime").JSX.Element;
+export declare function ReviewFilters({ table, variant, brandOptions, }: ReviewFiltersProps): import("react").JSX.Element;

package/dist/features/reviews/components/ReviewModal.d.ts

@@ -8,4 +8,4 @@ export interface ViewReviewModalProps {
  * ViewReviewModal — full review details in a Modal overlay.
  * Shows all images, the full comment, and seller response if present.
  */
-export declare function ViewReviewModal({ review, isOpen, onClose, }: ViewReviewModalProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ViewReviewModal({ review, isOpen, onClose, }: ViewReviewModalProps): import("react").JSX.Element | null;

package/dist/features/reviews/components/ReviewSummary.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 export interface ReviewSummaryProps {
     averageRating: number;
     totalReviews: number;
@@ -13,4 +14,4 @@ export interface ReviewSummaryProps {
  *  - "N reviews" count
  *  - Per-star percentage bars (5★ ... 1★)
  */
-export declare function ReviewSummary({ averageRating, totalReviews, distribution, className, }: ReviewSummaryProps): import("react/jsx-runtime").JSX.Element;
+export declare function ReviewSummary({ averageRating, totalReviews, distribution, className, }: ReviewSummaryProps): React.JSX.Element;

package/dist/features/reviews/components/ReviewsIndexListing.d.ts

@@ -1,6 +1,7 @@
+import React from "react";
 import type { ReviewListResponse } from "../types";
 export interface ReviewsIndexListingProps {
     initialData?: ReviewListResponse;
     variant?: "admin" | "seller" | "public";
 }
-export declare function ReviewsIndexListing({ initialData, variant, }: ReviewsIndexListingProps): import("react/jsx-runtime").JSX.Element;
+export declare function ReviewsIndexListing({ initialData, variant, }: ReviewsIndexListingProps): React.JSX.Element;

package/dist/features/reviews/components/ReviewsIndexPageView.d.ts

@@ -1,6 +1,7 @@
+import React from "react";
 type SearchParams = Record<string, string | string[]>;
 export interface ReviewsIndexPageViewProps {
     searchParams?: SearchParams;
 }
-export declare function ReviewsIndexPageView({ searchParams }: ReviewsIndexPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function ReviewsIndexPageView({ searchParams }: ReviewsIndexPageViewProps): Promise<React.JSX.Element>;
 export {};

package/dist/features/reviews/components/ReviewsList.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 import type { Review } from "../types";
 export type ReviewCardContext = "listing" | "store" | "general";
 export interface ReviewCardProps {
@@ -5,7 +6,7 @@ export interface ReviewCardProps {
     context?: ReviewCardContext;
     className?: string;
 }
-export declare function ReviewCard({ review, context, className }: ReviewCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function ReviewCard({ review, context, className }: ReviewCardProps): React.JSX.Element;
 export interface ReviewsListProps {
     reviews: Review[];
     context?: ReviewCardContext;
@@ -15,4 +16,4 @@ export interface ReviewsListProps {
     onPageChange?: (page: number) => void;
     emptyLabel?: string;
 }
-export declare function ReviewsList({ reviews, context, isLoading, totalPages, currentPage, onPageChange, emptyLabel, }: ReviewsListProps): import("react/jsx-runtime").JSX.Element;
+export declare function ReviewsList({ reviews, context, isLoading, totalPages, currentPage, onPageChange, emptyLabel, }: ReviewsListProps): React.JSX.Element;

package/dist/features/scams/components/ScamAwarenessModal.d.ts

@@ -1,5 +1,6 @@
+import React from "react";
 export interface ScamAwarenessModalProps {
     isOpen: boolean;
     onAcknowledged: () => void;
 }
-export declare function ScamAwarenessModal({ isOpen, onAcknowledged }: ScamAwarenessModalProps): import("react/jsx-runtime").JSX.Element;
+export declare function ScamAwarenessModal({ isOpen, onAcknowledged }: ScamAwarenessModalProps): React.JSX.Element;

package/dist/features/scams/components/ScamProfileView.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 import type { ScammerDocument, ScammerIncidentDocument, ScammerCommentDocument } from "../schemas/firestore";
 export interface ScamProfileViewProps {
     scammer: ScammerDocument;
@@ -7,4 +8,4 @@ export interface ScamProfileViewProps {
     comments?: ScammerCommentDocument[];
     relatedScammers?: ScammerDocument[];
 }
-export declare function ScamProfileView({ scammer, isAuthenticated, incidents, comments, relatedScammers, }: ScamProfileViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function ScamProfileView({ scammer, isAuthenticated, incidents, comments, relatedScammers, }: ScamProfileViewProps): React.JSX.Element;

package/dist/features/scams/components/ScamRegistryView.d.ts

@@ -1,6 +1,7 @@
+import React from "react";
 type SearchParams = Record<string, string | string[]>;
 export interface ScamRegistryViewProps {
     searchParams?: SearchParams;
 }
-export declare function ScamRegistryView({ searchParams }: ScamRegistryViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function ScamRegistryView({ searchParams }: ScamRegistryViewProps): Promise<React.JSX.Element>;
 export {};

package/dist/features/search/components/Search.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 import type { LucideIcon } from "lucide-react";
 import type { NavSuggestionRecord } from "../hooks/useNavSuggestions";
 export type SearchResourceType = "products" | "auctions" | "pre-orders" | "prize-draws" | "bundles" | "classified" | "digital-codes" | "live" | "stores" | "categories" | "brands" | "events" | "blog" | "faqs";
@@ -47,4 +48,4 @@ export interface SearchProps {
     defaultResourceType?: SearchResourceType;
     storageKey?: string;
 }
-export declare function Search({ isOpen, onClose, onSearch, onOpen, value, onChange, placeholder, deferred, debounceMs, onClear, className, router, quickLinks, labels, suggestionTypeIcons, suggestionTypeBadges, resourceTypes, defaultResourceType, storageKey, }: SearchProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function Search({ isOpen, onClose, onSearch, onOpen, value, onChange, placeholder, deferred, debounceMs, onClear, className, router, quickLinks, labels, suggestionTypeIcons, suggestionTypeBadges, resourceTypes, defaultResourceType, storageKey, }: SearchProps): React.JSX.Element | null;

package/dist/features/search/components/SearchFiltersRow.d.ts

@@ -18,5 +18,5 @@ interface SearchFiltersRowProps {
         clearFilters?: string;
     };
 }
-export declare function SearchFiltersRow({ urlCategory, categories, urlMinPrice, urlMaxPrice, showClear, onCategoryChange, onPriceFilter, onClearFilters, labels, }: SearchFiltersRowProps): import("react/jsx-runtime").JSX.Element;
+export declare function SearchFiltersRow({ urlCategory, categories, urlMinPrice, urlMaxPrice, showClear, onCategoryChange, onPriceFilter, onClearFilters, labels, }: SearchFiltersRowProps): import("react").JSX.Element;
 export {};

package/dist/features/search/components/SearchResultsSection.d.ts

@@ -50,4 +50,4 @@ export interface SearchResultsSectionProps {
         nextPage?: string;
     };
 }
-export declare function SearchResultsSection({ products, total, totalPages, urlQ, urlSort, urlPage, isLoading, onSortChange, onPageChange, renderItem, renderLoading, renderEmpty, renderProducts, renderSortBar, renderPagination, sortOptions, labels, }: SearchResultsSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function SearchResultsSection({ products, total, totalPages, urlQ, urlSort, urlPage, isLoading, onSortChange, onPageChange, renderItem, renderLoading, renderEmpty, renderProducts, renderSortBar, renderPagination, sortOptions, labels, }: SearchResultsSectionProps): React.JSX.Element;

package/dist/features/search/components/SearchView.d.ts

@@ -26,4 +26,4 @@ export interface SearchViewProps {
     renderPagination?: () => React.ReactNode;
     className?: string;
 }
-export declare function SearchView({ query, total, isLoading, labels, renderSearchInput, renderFilters, renderActiveFilters, renderToolbar, renderResults, renderPagination, className, }: SearchViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function SearchView({ query, total, isLoading, labels, renderSearchInput, renderFilters, renderActiveFilters, renderToolbar, renderResults, renderPagination, className, }: SearchViewProps): React.JSX.Element;

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/BarcodeField.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 export interface BarcodeFieldProps {
     label?: string;
     value: string;
@@ -14,4 +15,4 @@ export interface BarcodeFieldProps {
  * Scanners type characters rapidly (< 50 ms per keydown) then send Enter.
  * onScan is called when Enter follows rapid input; manual typing is ignored.
  */
-export declare function BarcodeField({ label, value, onChange, onScan, placeholder, helperText, autoFocus, readOnly, }: BarcodeFieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function BarcodeField({ label, value, onChange, onScan, placeholder, helperText, autoFocus, readOnly, }: BarcodeFieldProps): React.JSX.Element;

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

@@ -1,3 +1,4 @@
+import React from "react";
 export interface BrandInlineSelectProps {
     value: string;
     onChange: (v: string) => void;
@@ -6,4 +7,4 @@ export interface BrandInlineSelectProps {
     /** Show the "+ Create new brand" option. Defaults to true for sellers. */
     allowCreate?: boolean;
 }
-export declare function BrandInlineSelect({ value, onChange, placeholder, disabled, allowCreate, }: BrandInlineSelectProps): import("react/jsx-runtime").JSX.Element;
+export declare function BrandInlineSelect({ value, onChange, placeholder, disabled, allowCreate, }: BrandInlineSelectProps): React.JSX.Element;

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

@@ -1,3 +1,4 @@
+import React from "react";
 export interface CategoryInlineSelectProps {
     value: string;
     onChange: (v: string) => void;
@@ -6,4 +7,4 @@ export interface CategoryInlineSelectProps {
     /** Show the "+ Create new category" option. Defaults to false (search-only for sellers). */
     allowCreate?: boolean;
 }
-export declare function CategoryInlineSelect({ value, onChange, placeholder, disabled, allowCreate, }: CategoryInlineSelectProps): import("react/jsx-runtime").JSX.Element;
+export declare function CategoryInlineSelect({ value, onChange, placeholder, disabled, allowCreate, }: CategoryInlineSelectProps): React.JSX.Element;

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

@@ -1,3 +1,4 @@
+import React from "react";
 type Scope = "admin" | "store";
 interface BaseProps {
     /** Which API to query. "store" hits the seller's own coupons; "admin" hits the admin pool. */
@@ -18,5 +19,5 @@ interface MultiProps extends BaseProps {
     onChange: (v: string[]) => void;
 }
 export type CouponInlineSelectProps = SingleProps | MultiProps;
-export declare function CouponInlineSelect(props: CouponInlineSelectProps): import("react/jsx-runtime").JSX.Element;
+export declare function CouponInlineSelect(props: CouponInlineSelectProps): React.JSX.Element;
 export {};

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

@@ -1,5 +1,6 @@
+import React from "react";
 export interface FulfillmentViewProps {
     currentUserId?: string;
     currentUserName?: string;
 }
-export declare function FulfillmentView({ currentUserId, }: FulfillmentViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function FulfillmentView({ currentUserId, }: FulfillmentViewProps): React.JSX.Element;