@mohasinac/appkit 3.2.20 → 3.3.0

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

@@ -0,0 +1,45 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * AdminStickersView — admin browse of sticker listings (EMI/art-stickers session).
+ * Mirrors AdminClassifiedView's thin config-driven pattern.
+ */
+import { sortBy } from "@mohasinac/appkit";
+import React from "react";
+import { ListingLayout } from "../../../ui";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { toRecordArray, toRelativeDate, toRupees, toStringValue, } from "../hooks/useAdminListingData";
+import { DataListingView } from "./DataListingView";
+const ADMIN_STICKERS_CONFIG = {
+    portal: "admin",
+    title: "Stickers",
+    searchPlaceholder: "Search stickers by name or seller",
+    emptyLabel: "No sticker listings",
+    filterKeys: [],
+    defaultSort: sortBy("createdAt", "DESC"),
+    queryKey: ["admin", "stickers", "listing"],
+    endpoint: ADMIN_ENDPOINTS.PRODUCTS,
+    sortOptions: [
+        { value: sortBy("createdAt", "DESC"), label: "Newest" },
+        { value: sortBy("createdAt", "ASC"), label: "Oldest" },
+        { value: "title", label: "Title A–Z" },
+    ],
+    mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
+        id: toStringValue(item.id, `stickers-${index}`),
+        primary: toStringValue(item.title ?? item.productTitle, "Untitled sticker listing"),
+        secondary: [
+            toStringValue(item.sellerName, "Unknown seller"),
+            toRupees(item.price),
+        ].join(" · "),
+        status: toStringValue(item.status, "draft"),
+        updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
+    })),
+    getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
+    buildFilters: () => "listingType==stickers",
+};
+export function AdminStickersView({ children, ...props }) {
+    if (React.Children.count(children) > 0) {
+        return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
+    }
+    return _jsx(DataListingView, { config: ADMIN_STICKERS_CONFIG });
+}

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

@@ -40,6 +40,10 @@ export { AdminDigitalCodesView } from "./AdminDigitalCodesView";
 export type { AdminDigitalCodesViewProps } from "./AdminDigitalCodesView";
 export { AdminLiveView } from "./AdminLiveView";
 export type { AdminLiveViewProps } from "./AdminLiveView";
+export { AdminArtView } from "./AdminArtView";
+export type { AdminArtViewProps } from "./AdminArtView";
+export { AdminStickersView } from "./AdminStickersView";
+export type { AdminStickersViewProps } from "./AdminStickersView";
 export { AdminGroupedListingsView } from "./AdminGroupedListingsView";
 export type { AdminGroupedListingsViewProps } from "./AdminGroupedListingsView";
 export { AdminBundlesView } from "./AdminBundlesView";
@@ -157,6 +161,8 @@ export { AdminFulfillmentView } from "./AdminFulfillmentView";
 export type { AdminFulfillmentViewProps } from "./AdminFulfillmentView";
 export { AdminAddressesView } from "./AdminAddressesView";
 export type { AdminAddressesViewProps } from "./AdminAddressesView";
+export { AdminAddressBookView } from "./AdminAddressBookView";
+export type { AdminAddressBookViewProps } from "./AdminAddressBookView";
 export { AdminAddressClustersView } from "./AdminAddressClustersView";
 export type { AdminAddressClustersViewProps } from "./AdminAddressClustersView";
 export { AdminPaymentMethodsView } from "./AdminPaymentMethodsView";

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

@@ -22,6 +22,9 @@ export { AdminPrizeDrawsView } from "./AdminPrizeDrawsView";
 export { AdminClassifiedView } from "./AdminClassifiedView";
 export { AdminDigitalCodesView } from "./AdminDigitalCodesView";
 export { AdminLiveView } from "./AdminLiveView";
+// EMI/art-stickers session — admin listing views for art / stickers.
+export { AdminArtView } from "./AdminArtView";
+export { AdminStickersView } from "./AdminStickersView";
 export { AdminGroupedListingsView } from "./AdminGroupedListingsView";
 // S-SBUNI-4 2026-05-13 — admin bundle CRUD views.
 export { AdminBundlesView } from "./AdminBundlesView";
@@ -82,6 +85,7 @@ export { AdminScammersView } from "./AdminScammersView";
 export { AdminScammerEditorView } from "./AdminScammerEditorView";
 export { AdminFulfillmentView } from "./AdminFulfillmentView";
 export { AdminAddressesView } from "./AdminAddressesView";
+export { AdminAddressBookView } from "./AdminAddressBookView";
 export { AdminAddressClustersView } from "./AdminAddressClustersView";
 export { AdminPaymentMethodsView } from "./AdminPaymentMethodsView";
 export { AdminPaymentClustersView } from "./AdminPaymentClustersView";

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

@@ -3,7 +3,7 @@
  * Covers: notifications, chat rooms, site settings
  */
 export declare const ADMIN_CHECKOUT_BYPASS_FLAG_KEY: "adminCheckoutBypass";
-export type NotificationType = "order_placed" | "order_confirmed" | "order_shipped" | "order_delivered" | "order_cancelled" | "bid_placed" | "bid_outbid" | "bid_won" | "bid_lost" | "review_approved" | "review_replied" | "product_available" | "promotion" | "system" | "welcome" | "account_action" | "offer_received" | "offer_responded" | "offer_expired" | "offer_counter_accepted" | "refund_initiated" | "prize_reveal_ready" | "prize_reveal_expired" | "prize_reveal_reminder";
+export type NotificationType = "order_placed" | "order_confirmed" | "order_shipped" | "order_delivered" | "order_cancelled" | "bid_placed" | "bid_outbid" | "bid_won" | "bid_lost" | "review_approved" | "review_replied" | "product_available" | "promotion" | "system" | "welcome" | "account_action" | "offer_received" | "offer_responded" | "offer_expired" | "offer_counter_accepted" | "refund_initiated" | "prize_reveal_ready" | "prize_reveal_expired" | "prize_reveal_reminder" | "emi_installment_due_soon" | "emi_installment_overdue";
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export type NotificationPriority = "low" | "normal" | "high";
 export interface NotificationDocument extends BaseDocument {
@@ -143,8 +143,6 @@ export interface SiteSettingsCredentials {
     razorpayWebhookSecret?: string;
     resendApiKey?: string;
     whatsappApiKey?: string;
-    shiprocketEmail?: string;
-    shiprocketPassword?: string;
     metaAppId?: string;
     metaAppSecret?: string;
     metaPageAccessToken?: string;
@@ -171,8 +169,6 @@ export interface SiteSettingsCredentialsMasked {
     razorpayWebhookSecret?: string;
     resendApiKey?: string;
     whatsappApiKey?: string;
-    shiprocketEmail?: string;
-    shiprocketPassword?: string;
     metaAppId?: string;
     metaAppSecret?: string;
     metaPageAccessToken?: string;
@@ -293,6 +289,21 @@ export interface SiteSettingsDocument extends BaseDocument {
         upiManualEnabled: boolean;
         codEnabled: boolean;
     };
+    /** Site-wide EMI (installment) settings. A seller must ALSO have `StoreDocument.emiEnabled` on for EMI to appear at checkout for their items. */
+    emi: {
+        enabled: boolean;
+        /** Paise — a seller's cart subtotal must exceed this for EMI to appear as an option. */
+        minOrderValueInPaise: number;
+        tenureOptions: number[];
+        /** Down payment % collected at checkout. */
+        tokenPercent: number;
+        /** Day of month (1–10) each installment is due. */
+        billingDay: number;
+        /** Extra % of principal per month of tenure — the "excess EMI fee" the buyer pays for spreading payment. */
+        surchargePercentPerMonth: number;
+        /** Share of the surcharge that goes to the seller (0–100); the rest is the platform's cut. */
+        surchargeSellerSharePercent: number;
+    };
     commissions: {
         /** Our platform cut charged to the buyer as a % of order value (e.g. 5 = 5%). */
         platformFeePercent: number;
@@ -303,6 +314,9 @@ export interface SiteSettingsDocument extends BaseDocument {
         /** Razorpay gateway cost % (absorbed by platform, not passed through separately). */
         gatewayFeePercent: number;
         codDepositPercent: number;
+        /** COD handling fee charged to the buyer: max(codHandlingFeeMinInPaise, subtotal × codHandlingFeePercent / 100). */
+        codHandlingFeeMinInPaise: number;
+        codHandlingFeePercent: number;
         sellerShippingFixed: number;
         platformShippingPercent: number;
         platformShippingFixedMin: number;
@@ -362,12 +376,6 @@ export interface SiteSettingsDocument extends BaseDocument {
          * if this is ever true. Default false.
          */
         useMockPayment?: boolean;
-        /**
-         * Track H — when true and NODE_ENV !== "production", the shipping provider
-         * resolver returns MockShiprocketProvider. In production the resolver throws
-         * if this is ever true. Default false.
-         */
-        useMockShipping?: boolean;
         listingTypes?: {
             standard?: boolean;
             auction?: boolean;

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

@@ -167,16 +167,27 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
     motto: "Your Marketplace, Your Rules",
     theme: DEFAULT_SITE_SETTINGS_THEME,
     payment: {
-        razorpayEnabled: true,
+        razorpayEnabled: false,
         upiManualEnabled: true,
         codEnabled: true,
     },
+    emi: {
+        enabled: false,
+        minOrderValueInPaise: 1000000,
+        tenureOptions: [2, 3, 4, 5, 6],
+        tokenPercent: 10,
+        billingDay: 5,
+        surchargePercentPerMonth: 1,
+        surchargeSellerSharePercent: 50,
+    },
     commissions: {
         platformFeePercent: 5,
         gstPercent: 18,
         minimumTransactionFee: 0,
         gatewayFeePercent: 2,
         codDepositPercent: 10,
+        codHandlingFeeMinInPaise: 20000,
+        codHandlingFeePercent: 10,
         sellerShippingFixed: 0,
         platformShippingPercent: 10,
         platformShippingFixedMin: 0,
@@ -205,7 +216,6 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         // Track H — both mock-provider flags default to false. Production
         // deployments must never flip these on (the resolver throws if they are).
         useMockPayment: false,
-        useMockShipping: false,
         // W1-37 2026-05-23 — Phase 2 listing types enabled by default; all per-type
         // surfaces (seller + admin via W1-29 + public) are now shipped.
         listingTypes: {

package/dist/features/auctions/components/MarketplaceAuctionCard.d.ts

@@ -1,4 +1,5 @@
 import { type WishlistToggleActions } from "../../wishlist";
+import type { ListingType } from "../../products/types/index";
 export interface MarketplaceAuctionCardData {
     id: string;
     title: string;
@@ -11,8 +12,8 @@ export interface MarketplaceAuctionCardData {
         url?: string;
         thumbnailUrl?: string;
     };
-    /** Canonical discriminator (SB1-G Phase 4 · SB-UNI-F 2026-05-13 union extension). */
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
+    /** Canonical discriminator (SB1-G Phase 4). */
+    listingType?: ListingType;
     auctionEndDate?: string | Date;
     startingBid?: number;
     currentBid?: number;

package/dist/features/auth/hooks/useAuth.js

@@ -57,6 +57,17 @@ export function useGoogleLogin(options) {
     const [popupPending, setPopupPending] = useState(false);
     // calledRef prevents both RTDB and postMessage from firing the callbacks
     const calledRef = useRef(false);
+    // Polls for the popup being closed manually (without completing sign-in).
+    // Without this, a user who closes the popup before RTDB/postMessage
+    // resolves leaves popupPending stuck true forever — the button never
+    // recovers from its loading state.
+    const closePollRef = useRef(null);
+    const clearClosePoll = useCallback(() => {
+        if (closePollRef.current !== null) {
+            clearInterval(closePollRef.current);
+            closePollRef.current = null;
+        }
+    }, []);
     const onSuccessRef = useRef(options?.onSuccess);
     const onErrorRef = useRef(options?.onError);
     const onSessionSyncedRef = useRef(options?.onSessionSynced);
@@ -65,6 +76,8 @@ export function useGoogleLogin(options) {
     useEffect(() => { onErrorRef.current = options?.onError; }, [options?.onError]);
     useEffect(() => { onSessionSyncedRef.current = options?.onSessionSynced; }, [options?.onSessionSynced]);
     useEffect(() => { authEventResetRef.current = authEvent.reset; }, [authEvent.reset]);
+    // Stop polling for popup-closed if the component unmounts mid-flow.
+    useEffect(() => clearClosePoll, [clearClosePoll]);
     // RTDB status watcher — fast path when RTDB is available.
     // FAILED is intentionally not forwarded to onError here: RTDB connection
     // failures (e.g. missing database URL) should fall through to the postMessage
@@ -75,6 +88,7 @@ export function useGoogleLogin(options) {
             if (calledRef.current)
                 return;
             calledRef.current = true;
+            clearClosePoll();
             Promise.resolve(onSessionSyncedRef.current?.()).then(() => {
                 onSuccessRef.current?.(authEvent.data);
             });
@@ -85,10 +99,11 @@ export function useGoogleLogin(options) {
             if (calledRef.current)
                 return;
             calledRef.current = true;
+            clearClosePoll();
             onErrorRef.current?.(new Error(authEvent.error ?? "Sign-in timed out. Please try again."));
         }
         // FAILED: do not call onError — wait for the postMessage from /auth/close
-    }, [authEvent.status, authEvent.error, authEvent.data]);
+    }, [authEvent.status, authEvent.error, authEvent.data, clearClosePoll]);
     // postMessage fallback — fires when /auth/close sends window.opener.postMessage.
     // This covers two cases:
     //   1. RTDB is unavailable (the primary channel failed)
@@ -104,6 +119,7 @@ export function useGoogleLogin(options) {
                 return;
             calledRef.current = true;
             setPopupPending(false);
+            clearClosePoll();
             authEventResetRef.current();
             if (event.data.status === "success") {
                 const data = event.data.uid
@@ -119,7 +135,7 @@ export function useGoogleLogin(options) {
         };
         window.addEventListener("message", handleMessage);
         return () => window.removeEventListener("message", handleMessage);
-    }, []); // mount once — uses refs, no stale closure risk
+    }, [clearClosePoll]); // clearClosePoll has a stable identity — effectively mount-once
     const mutate = useCallback(async () => {
         calledRef.current = false; // reset for each new auth flow
         const popup = window.open(`${window.location.origin}/auth.html`, "oauth_google", "width=500,height=660,left=400,top=100");
@@ -128,6 +144,16 @@ export function useGoogleLogin(options) {
             return;
         }
         setPopupPending(true);
+        clearClosePoll();
+        closePollRef.current = setInterval(() => {
+            if (popup.closed && !calledRef.current) {
+                calledRef.current = true;
+                clearClosePoll();
+                setPopupPending(false);
+                authEventResetRef.current();
+                onErrorRef.current?.(new Error("Sign-in was cancelled."));
+            }
+        }, 500);
         try {
             setInitiating(true);
             authEvent.reset();
@@ -142,6 +168,7 @@ export function useGoogleLogin(options) {
         }
         catch (err) {
             void normalizeError(err);
+            clearClosePoll();
             popup.close();
             setPopupPending(false);
             onErrorRef.current?.(err instanceof Error ? err : new Error("Failed to start sign-in."));
@@ -149,7 +176,7 @@ export function useGoogleLogin(options) {
         finally {
             setInitiating(false);
         }
-    }, [authEvent]);
+    }, [authEvent, clearClosePoll]);
     const isLoading = initiating ||
         popupPending ||
         authEvent.status === RealtimeEventStatus.SUBSCRIBING ||
@@ -166,13 +193,12 @@ export function useRegister(options) {
                 displayName: data.displayName?.trim() || "",
                 acceptTerms: data.acceptTerms,
             });
-            // Sign in via client SDK and exchange ID token for a server session cookie
+            // /api/auth/register already created the server-side session cookie +
+            // Firestore session doc. Sign in via the client SDK only so
+            // `auth.currentUser` is populated for client-side Firebase usage
+            // (RTDB presence, etc) — do NOT call /api/auth/session again here,
+            // that would create a second, orphaned session document.
             await getClientAuthProvider().signInWithEmailAndPassword(data.email.trim(), data.password);
-            const currentUser = getClientSessionAdapter().getCurrentUser();
-            if (currentUser) {
-                const idToken = await currentUser.getIdToken(true);
-                await apiClient.post(AUTH_ENDPOINTS.SESSION, { idToken });
-            }
             return { success: true, ...response };
         },
         onSuccess: options?.onSuccess,

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

@@ -109,7 +109,8 @@ export interface UserSoftBan {
     /** Null or absent = permanent. Past date = expired (treated as lifted without deletion). */
     expiresAt?: Date | null;
 }
-export type SellerShippingMethod = "custom" | "shiprocket";
+/** Manual shipping is the only supported method — sellers enter carrier + tracking directly, no carrier API integration. */
+export type SellerShippingMethod = "custom";
 export interface SellerPickupAddress {
     locationName: string;
     name: string;
@@ -122,16 +123,11 @@ export interface SellerPickupAddress {
     pincode: string;
     country: string;
     isVerified: boolean;
-    shiprocketAddressId?: number;
 }
 export interface SellerShippingConfig {
     method: SellerShippingMethod;
     customShippingPrice?: number;
     customCarrierName?: string;
-    shiprocketEmail?: string;
-    /** Shiprocket JWT — server-only, never returned to client. */
-    shiprocketToken?: string;
-    shiprocketTokenExpiry?: Date;
     pickupAddress?: SellerPickupAddress;
     isConfigured: boolean;
 }

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

@@ -5,6 +5,7 @@
  * for the cart feature.
  */
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
+import type { ListingType } from "../../products/types/index";
 export interface CartItemDocument {
     itemId: string;
     productId: string;
@@ -22,7 +23,7 @@ export interface CartItemDocument {
      * carts) and cart-side UI badges. Replaces the legacy `isAuction`/`isPreOrder`
      * pair on the cart item.
      */
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
+    listingType: ListingType;
     /** True when item was added from an accepted Make-an-Offer */
     isOffer?: boolean;
     offerId?: string;
@@ -110,7 +111,7 @@ export type AddToCartInput = {
     /** Store slug (= storeId = store.id) */
     storeId: string;
     storeName: string;
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
+    listingType: ListingType;
     isOffer?: boolean;
     offerId?: string;
     lockedPrice?: number;

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

@@ -26,7 +26,7 @@ export declare const consultationBookingSchema: z.ZodObject<{
     adminNote: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    status: "cancelled" | "pending" | "completed" | "confirmed" | "no_show";
+    status: "cancelled" | "pending" | "confirmed" | "completed" | "no_show";
     id: string;
     name: string;
     email: string;
@@ -43,7 +43,7 @@ export declare const consultationBookingSchema: z.ZodObject<{
     id: string;
     name: string;
     email: string;
-    status?: "cancelled" | "pending" | "completed" | "confirmed" | "no_show" | undefined;
+    status?: "cancelled" | "pending" | "confirmed" | "completed" | "no_show" | undefined;
     message?: string | undefined;
     phone?: string | undefined;
     createdAt?: string | undefined;

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

@@ -9,12 +9,12 @@ export declare const coinHistoryEntrySchema: z.ZodObject<{
     orderId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    reason: "expiry" | "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit";
+    reason: "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit" | "expiry";
     delta: number;
     orderId?: string | undefined;
     timestamp?: string | undefined;
 }, {
-    reason: "expiry" | "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit";
+    reason: "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit" | "expiry";
     delta: number;
     orderId?: string | undefined;
     timestamp?: string | undefined;
@@ -38,12 +38,12 @@ export declare const loyaltyBalanceSchema: z.ZodObject<{
         orderId: z.ZodOptional<z.ZodString>;
         timestamp: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        reason: "expiry" | "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit";
+        reason: "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit" | "expiry";
         delta: number;
         orderId?: string | undefined;
         timestamp?: string | undefined;
     }, {
-        reason: "expiry" | "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit";
+        reason: "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit" | "expiry";
         delta: number;
         orderId?: string | undefined;
         timestamp?: string | undefined;
@@ -52,7 +52,7 @@ export declare const loyaltyBalanceSchema: z.ZodObject<{
     uid: string;
     hcCoins: number;
     coinHistory?: {
-        reason: "expiry" | "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit";
+        reason: "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit" | "expiry";
         delta: number;
         orderId?: string | undefined;
         timestamp?: string | undefined;
@@ -61,7 +61,7 @@ export declare const loyaltyBalanceSchema: z.ZodObject<{
     uid: string;
     hcCoins?: number | undefined;
     coinHistory?: {
-        reason: "expiry" | "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit";
+        reason: "redemption" | "order_reward" | "referral" | "review_reward" | "manual_credit" | "manual_debit" | "expiry";
         delta: number;
         orderId?: string | undefined;
         timestamp?: string | undefined;

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

@@ -181,9 +181,14 @@ declare class OrderRepository extends BaseRepository<OrderDocument> {
         data: OrderDocument;
     }>>;
     /**
-     * Cloud Functions: find shiprocket-shipped delivered orders eligible for payout.
+     * Cloud Functions: find delivered orders eligible for the weekly payout sweep.
+     *
+     * EMI orders that still have unpaid installments are excluded — the seller
+     * is only eligible once the buyer has fully paid off the order, not merely
+     * once it's delivered (a seller-enabled `allowShipBeforeEmiComplete` item
+     * can be delivered long before EMI collection finishes).
      */
-    getEligibleShiprocket(): Promise<Array<{
+    getEligibleForPayoutSweep(): Promise<Array<{
         id: string;
         ref: DocumentReference;
         data: OrderDocument;
@@ -192,12 +197,25 @@ declare class OrderRepository extends BaseRepository<OrderDocument> {
      * Cloud Functions: find auto-payout eligible delivered orders older than windowDays business days.
      * @param windowDays - number of business days since delivery
      * @param cutoff - pre-computed business-day cutoff date (computed by caller)
+     *
+     * See {@link getEligibleForPayoutSweep} for the EMI-incomplete exclusion rationale.
      */
     getEligibleAutomatic(cutoff: Date): Promise<Array<{
         id: string;
         ref: DocumentReference;
         data: OrderDocument;
     }>>;
+    /**
+     * Cloud Functions: EMI reminder sweep — orders on an active (not yet fully
+     * paid) EMI plan. Per-installment due-date filtering happens in the job
+     * itself since `emiInstallments` is an array field Firestore can't range-
+     * query on.
+     */
+    getActiveEmiOrders(): Promise<Array<{
+        id: string;
+        ref: DocumentReference;
+        data: OrderDocument;
+    }>>;
     /**
      * Cloud Functions: stage a payout-requested update into a caller-owned WriteBatch.
      */

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

@@ -268,26 +268,34 @@ class OrderRepository extends BaseRepository {
         }));
     }
     /**
-     * Cloud Functions: find shiprocket-shipped delivered orders eligible for payout.
+     * Cloud Functions: find delivered orders eligible for the weekly payout sweep.
+     *
+     * EMI orders that still have unpaid installments are excluded — the seller
+     * is only eligible once the buyer has fully paid off the order, not merely
+     * once it's delivered (a seller-enabled `allowShipBeforeEmiComplete` item
+     * can be delivered long before EMI collection finishes).
      */
-    async getEligibleShiprocket() {
+    async getEligibleForPayoutSweep() {
         const snap = await this.db
             .collection(this.collection)
             .where(ORDER_FIELDS.PAYOUT_STATUS, "==", "eligible")
-            .where(ORDER_FIELDS.SHIPPING_METHOD, "==", "shiprocket")
             .where(ORDER_FIELDS.STATUS, "==", OrderStatusValues.DELIVERED)
             .limit(500)
             .get();
-        return snap.docs.map((d) => ({
+        return snap.docs
+            .map((d) => ({
             id: d.id,
             ref: d.ref,
             data: this.decryptOrder({ id: d.id, ...d.data() }),
-        }));
+        }))
+            .filter((o) => !o.data.emiEnabled || o.data.emiComplete);
     }
     /**
      * Cloud Functions: find auto-payout eligible delivered orders older than windowDays business days.
      * @param windowDays - number of business days since delivery
      * @param cutoff - pre-computed business-day cutoff date (computed by caller)
+     *
+     * See {@link getEligibleForPayoutSweep} for the EMI-incomplete exclusion rationale.
      */
     async getEligibleAutomatic(cutoff) {
         const snap = await this.db
@@ -297,6 +305,27 @@ class OrderRepository extends BaseRepository {
             .where(ORDER_FIELDS.UPDATED_AT, "<=", cutoff)
             .limit(500)
             .get();
+        return snap.docs
+            .map((d) => ({
+            id: d.id,
+            ref: d.ref,
+            data: this.decryptOrder({ id: d.id, ...d.data() }),
+        }))
+            .filter((o) => !o.data.emiEnabled || o.data.emiComplete);
+    }
+    /**
+     * Cloud Functions: EMI reminder sweep — orders on an active (not yet fully
+     * paid) EMI plan. Per-installment due-date filtering happens in the job
+     * itself since `emiInstallments` is an array field Firestore can't range-
+     * query on.
+     */
+    async getActiveEmiOrders() {
+        const snap = await this.db
+            .collection(this.collection)
+            .where("emiEnabled", "==", true)
+            .where("emiComplete", "==", false)
+            .limit(500)
+            .get();
         return snap.docs.map((d) => ({
             id: d.id,
             ref: d.ref,

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

@@ -5,14 +5,14 @@ import type { OrderStatus, PaymentStatus } from "../types";
 import type { OrderType } from "../utils/order-splitter";
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 import type { ListingType } from "../../products/types";
-export type ShippingMethod = "custom" | "shiprocket";
+/** Manual shipping is the only supported method — sellers enter carrier + tracking directly, no carrier API integration. */
+export type ShippingMethod = "custom";
 export type RefundType = "full" | "partial";
 export type OrderPayoutStatus = "eligible" | "requested" | "paid";
 export type RefundStatus = "pending" | "processing" | "completed" | "rejected";
 /** Runtime-accessible shipping method values â€" use instead of bare string literals. */
 export declare const ShippingMethodValues: {
     readonly CUSTOM: "custom";
-    readonly SHIPROCKET: "shiprocket";
 };
 /** Runtime-accessible order status values â€" use instead of bare string literals. */
 export declare const OrderStatusValues: {
@@ -43,7 +43,24 @@ export declare const PaymentMethodValues: {
     readonly UPI_MANUAL: "upi_manual";
     readonly RAZORPAY: "razorpay";
     readonly ADMIN_BYPASS: "admin_bypass";
+    readonly EMI: "emi";
 };
+export type EmiInstallmentStatus = "pending" | "paid" | "overdue";
+export interface EmiInstallment {
+    /** 1-based installment number. */
+    index: number;
+    dueDate: Date;
+    /** Installment amount in paise (principal share + surcharge share for this installment). */
+    amount: number;
+    status: EmiInstallmentStatus;
+    paidAt?: Date;
+    /** Buyer-uploaded 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;
+    /** Set once the reminder sweep has notified the buyer for this installment, so it isn't re-sent on every sweep run. */
+    reminderSentAt?: Date;
+}
 /** Runtime-accessible refund status values â€" use instead of bare string literals. */
 export declare const RefundStatusValues: {
     readonly PENDING: "pending";
@@ -141,15 +158,24 @@ export interface OrderDocument extends BaseDocument {
     platformFee?: number;
     depositAmount?: number;
     codRemainingAmount?: number;
+    /** COD handling fee charged to the buyer: max(codHandlingFeeMinInPaise, subtotal × codHandlingFeePercent / 100). Only set when paymentMethod === "cod". */
+    codHandlingFee?: number;
+    emiEnabled?: boolean;
+    /** Number of monthly installments the buyer chose (2–6). */
+    emiTenureMonths?: number;
+    /** Down payment collected at checkout, in paise (emiTokenPercent × seller subtotal). */
+    emiTokenAmount?: number;
+    /** Extra cost of choosing EMI over full payment, in paise — split between platform and seller. */
+    emiSurchargeAmount?: number;
+    emiInstallments?: EmiInstallment[];
+    /** Sum of unpaid installment amounts, in paise. 0 once all installments are paid. */
+    emiRemainingBalance?: number;
+    /** True once every installment's status is "paid". Gates shipment unless the product's `allowShipBeforeEmiComplete` flag is set. */
+    emiComplete?: boolean;
     shippingFee?: number;
     shippingMethod?: ShippingMethod;
     shippingCarrier?: string;
     trackingUrl?: string;
-    shiprocketOrderId?: number;
-    shiprocketShipmentId?: number;
-    shiprocketAWB?: string;
-    shiprocketStatus?: string;
-    shiprocketUpdatedAt?: Date;
     payoutStatus?: OrderPayoutStatus;
     payoutId?: string;
     offerId?: string;

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

@@ -5,7 +5,6 @@ import { generateOrderId } from "../../../utils/id-generators";
 /** Runtime-accessible shipping method values â€" use instead of bare string literals. */
 export const ShippingMethodValues = {
     CUSTOM: "custom",
-    SHIPROCKET: "shiprocket",
 };
 /** Runtime-accessible order status values â€" use instead of bare string literals. */
 export const OrderStatusValues = {
@@ -36,6 +35,7 @@ export const PaymentMethodValues = {
     UPI_MANUAL: "upi_manual",
     RAZORPAY: "razorpay",
     ADMIN_BYPASS: "admin_bypass",
+    EMI: "emi",
 };
 /** Runtime-accessible refund status values â€" use instead of bare string literals. */
 export const RefundStatusValues = {