@mohasinac/appkit 4.13.1 → 4.15.0

package/dist/_internal/shared/checkout/lanes.js

@@ -24,6 +24,7 @@
  * @tag consumers:CartRouteClient,CheckoutRouteClient,cart-actions,order-splitter,checkout/actions
  * @tag sideEffects:none
  */
+import { ROUTES } from "../../../next/routing/route-map";
 export const CART_LANE = {
     AUCTION: "auction",
     OFFER: "offer",
@@ -72,6 +73,31 @@ export const LANE_CHECKOUT_WINDOW_HOURS = {
     auction: LANE_CHECKOUT_WINDOW_MS.auction / (60 * 60 * 1000),
     offer: LANE_CHECKOUT_WINDOW_MS.offer / (60 * 60 * 1000),
 };
+/**
+ * A BUYOUT hold is a third window, deliberately much shorter than the two above,
+ * even though it lands in the same auction lane.
+ *
+ * A settled win (`LANE_CHECKOUT_WINDOW_MS.auction`) is a finished auction: the
+ * clock already ran, nobody else is waiting, and 48 hours costs no one anything.
+ * A buyout is the opposite — the auction is still live and still taking bids
+ * while the hold exists, so a long window would let one buyer sit on a listing
+ * they may never pay for. One hour, and the hold is additionally clamped to the
+ * auction's own end time by `buyNowAuction` (see `AUCTION_BUYOUT_WINDOW_MS`
+ * callers): a buyout that hasn't been paid for by the time the auction ends
+ * fails, because by then the auction has settled to whoever actually won it.
+ */
+export const AUCTION_BUYOUT_WINDOW_MS = 60 * 60 * 1000;
+/** 1 hour, in minutes — for buyer-facing copy ("pay within 60 minutes"). */
+export const AUCTION_BUYOUT_WINDOW_MINUTES = AUCTION_BUYOUT_WINDOW_MS / (60 * 1000);
+/**
+ * Deep link that drops a buyer straight into the auction lane at checkout.
+ *
+ * Declared once here, with the lane it selects, because it was previously a
+ * const in `auctionSettlement.ts` AND an inline template literal in
+ * `bid-actions.ts` — the same two-copies problem `LANE_CHECKOUT_WINDOW_MS` was
+ * extracted to fix, one layer up.
+ */
+export const AUCTION_CHECKOUT_URL = `${String(ROUTES.USER.CHECKOUT)}?lane=${CART_LANE.AUCTION}`;
 /** The two lanes whose price is fixed outside the listing. */
 export function isLockedLane(lane) {
     return lane === CART_LANE.AUCTION || lane === CART_LANE.OFFER;

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

@@ -49,6 +49,33 @@ export interface ResolveMinBidOptions {
  * together with `{ hasBids: false }`.
  */
 export declare function resolveMinBid(currentBidAmount: number, tiers: BidIncrementTier[], override?: number | null, opts?: ResolveMinBidOptions): number;
+export interface BuyNowAvailabilityInput {
+    buyNowPrice: number | null | undefined;
+    /** The auction's live visible price. Pass the SSE value client-side. */
+    currentBid: number | null | undefined;
+    isEnded: boolean;
+    isSold?: boolean;
+}
+/**
+ * The single definition of "can this auction be bought outright right now".
+ *
+ * Written once for the same reason `resolveMinBid` is: the predicate had been
+ * hand-written in five places (the bid form, three spots on the auction detail
+ * page, the marketplace card) and they disagreed — the detail page advertised
+ * "Buy Now: ₹5,999" from a two-condition check while the button beneath it used
+ * a three-condition one, so most auctions showed a price with no button under
+ * it. That is the drift shape Root Cause #30 describes.
+ *
+ * The old third condition was `!bidsHaveStarted` (eBay's rule: BIN vanishes the
+ * moment anyone bids). It is deliberately gone. Buyout now stays available for
+ * as long as it is still a better deal than the standing bid, which is the
+ * condition that actually matters — a BIN price the bidding has already passed
+ * is meaningless, and one it hasn't is still a real offer.
+ *
+ * `isSold` is optional because client callers rendering a live auction page
+ * already know it isn't sold; server callers should always pass it.
+ */
+export declare function isBuyNowAvailable({ buyNowPrice, currentBid, isEnded, isSold, }: BuyNowAvailabilityInput): boolean;
 /**
  * Preset step multipliers offered by the bid form, as multiples of the
  * effective minimum increment. With a ₹100 increment this renders

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

@@ -70,6 +70,33 @@ export function resolveMinBid(currentBidAmount, tiers, override, opts) {
         return currentBidAmount;
     return currentBidAmount + resolveMinBidIncrement(currentBidAmount, tiers, override);
 }
+/**
+ * The single definition of "can this auction be bought outright right now".
+ *
+ * Written once for the same reason `resolveMinBid` is: the predicate had been
+ * hand-written in five places (the bid form, three spots on the auction detail
+ * page, the marketplace card) and they disagreed — the detail page advertised
+ * "Buy Now: ₹5,999" from a two-condition check while the button beneath it used
+ * a three-condition one, so most auctions showed a price with no button under
+ * it. That is the drift shape Root Cause #30 describes.
+ *
+ * The old third condition was `!bidsHaveStarted` (eBay's rule: BIN vanishes the
+ * moment anyone bids). It is deliberately gone. Buyout now stays available for
+ * as long as it is still a better deal than the standing bid, which is the
+ * condition that actually matters — a BIN price the bidding has already passed
+ * is meaningless, and one it hasn't is still a real offer.
+ *
+ * `isSold` is optional because client callers rendering a live auction page
+ * already know it isn't sold; server callers should always pass it.
+ */
+export function isBuyNowAvailable({ buyNowPrice, currentBid, isEnded, isSold, }) {
+    if (isEnded || isSold === true)
+        return false;
+    if (typeof buyNowPrice !== "number" || !Number.isFinite(buyNowPrice) || buyNowPrice <= 0) {
+        return false;
+    }
+    return buyNowPrice > (currentBid ?? 0);
+}
 /**
  * Preset step multipliers offered by the bid form, as multiples of the
  * effective minimum increment. With a ₹100 increment this renders

package/dist/_internal/shared/features/auctions/schema.d.ts

@@ -1,5 +1,17 @@
 import { z } from "zod";
-export declare const placeBidSchema: z.ZodObject<{
+/**
+ * Server-action input for placing a bid.
+ *
+ * Renamed from `placeBidSchema` 2026-08-24 (W3): a DIFFERENT `placeBidSchema`
+ * exists at `features/auctions/schemas/bid-input.ts`, and the two are not
+ * variants of one thing — that one is a client FORM factory taking the minimum
+ * bid and returning `{ bidAmount }`, this one is the action payload
+ * `{ auctionId, amount }`. Same name, different layer, different field names,
+ * incompatible shapes. Two same-named exports in one package is a defect even
+ * when both are correct, because the choice between them is invisible at the
+ * call site (Root Cause #36, one union over).
+ */
+export declare const placeBidActionSchema: z.ZodObject<{
     auctionId: z.ZodString;
     amount: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
@@ -26,5 +38,5 @@ export declare const buyNowSchema: z.ZodObject<{
 }, {
     auctionId: string;
 }>;
-export type PlaceBidInput = z.infer<typeof placeBidSchema>;
+export type PlaceBidActionInput = z.infer<typeof placeBidActionSchema>;
 export type CancelBidInput = z.infer<typeof cancelBidSchema>;

package/dist/_internal/shared/features/auctions/schema.js

@@ -1,5 +1,17 @@
 import { z } from "zod";
-export const placeBidSchema = z.object({
+/**
+ * Server-action input for placing a bid.
+ *
+ * Renamed from `placeBidSchema` 2026-08-24 (W3): a DIFFERENT `placeBidSchema`
+ * exists at `features/auctions/schemas/bid-input.ts`, and the two are not
+ * variants of one thing — that one is a client FORM factory taking the minimum
+ * bid and returning `{ bidAmount }`, this one is the action payload
+ * `{ auctionId, amount }`. Same name, different layer, different field names,
+ * incompatible shapes. Two same-named exports in one package is a defect even
+ * when both are correct, because the choice between them is invisible at the
+ * call site (Root Cause #36, one union over).
+ */
+export const placeBidActionSchema = z.object({
     auctionId: z.string().min(1),
     amount: z.number().positive("Bid amount must be a positive number"),
 });

package/dist/_internal/shared/features/blog/schema.d.ts

@@ -16,8 +16,8 @@ export declare const blogPostInputSchema: z.ZodObject<{
     status: "draft" | "published";
     title: string;
     content: string;
-    category: string;
     slug: string;
+    category: string;
     tags: string[];
     isFeatured: boolean;
     youtubeId?: string | undefined;
@@ -28,8 +28,8 @@ export declare const blogPostInputSchema: z.ZodObject<{
 }, {
     title: string;
     content: string;
-    category: string;
     slug: string;
+    category: string;
     status?: "draft" | "published" | undefined;
     youtubeId?: string | undefined;
     tags?: string[] | undefined;

package/dist/_internal/shared/features/cart/schema.d.ts

@@ -8,32 +8,32 @@ export declare const addToCartSchema: z.ZodObject<{
     storeId: z.ZodString;
     storeName: z.ZodDefault<z.ZodString>;
     quantity: z.ZodDefault<z.ZodNumber>;
-    listingType: z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "classified", "digital-code", "live"]>;
+    listingType: z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "classified", "digital-code", "live", "art", "stickers"]>;
     isOffer: z.ZodOptional<z.ZodBoolean>;
     offerId: z.ZodOptional<z.ZodString>;
     lockedPrice: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     currency: string;
     storeId: string;
-    listingType: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
     price: number;
-    storeName: string;
+    listingType: "art" | "stickers" | "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
     productId: string;
     productTitle: string;
     quantity: number;
+    storeName: string;
     productImage: string;
     offerId?: string | undefined;
     lockedPrice?: number | undefined;
     isOffer?: boolean | undefined;
 }, {
     storeId: string;
-    listingType: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
     price: number;
+    listingType: "art" | "stickers" | "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
     productId: string;
     productTitle: string;
     currency?: string | undefined;
-    storeName?: string | undefined;
     quantity?: number | undefined;
+    storeName?: string | undefined;
     productImage?: string | undefined;
     offerId?: string | undefined;
     lockedPrice?: number | undefined;
@@ -66,32 +66,32 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
         storeId: z.ZodString;
         storeName: z.ZodDefault<z.ZodString>;
         quantity: z.ZodDefault<z.ZodNumber>;
-        listingType: z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "classified", "digital-code", "live"]>;
+        listingType: z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "classified", "digital-code", "live", "art", "stickers"]>;
         isOffer: z.ZodOptional<z.ZodBoolean>;
         offerId: z.ZodOptional<z.ZodString>;
         lockedPrice: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         currency: string;
         storeId: string;
-        listingType: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
         price: number;
-        storeName: string;
+        listingType: "art" | "stickers" | "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
         productId: string;
         productTitle: string;
         quantity: number;
+        storeName: string;
         productImage: string;
         offerId?: string | undefined;
         lockedPrice?: number | undefined;
         isOffer?: boolean | undefined;
     }, {
         storeId: string;
-        listingType: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
         price: number;
+        listingType: "art" | "stickers" | "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
         productId: string;
         productTitle: string;
         currency?: string | undefined;
-        storeName?: string | undefined;
         quantity?: number | undefined;
+        storeName?: string | undefined;
         productImage?: string | undefined;
         offerId?: string | undefined;
         lockedPrice?: number | undefined;
@@ -101,12 +101,12 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
     guestItems: {
         currency: string;
         storeId: string;
-        listingType: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
         price: number;
-        storeName: string;
+        listingType: "art" | "stickers" | "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
         productId: string;
         productTitle: string;
         quantity: number;
+        storeName: string;
         productImage: string;
         offerId?: string | undefined;
         lockedPrice?: number | undefined;
@@ -115,18 +115,23 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
 }, {
     guestItems: {
         storeId: string;
-        listingType: "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
         price: number;
+        listingType: "art" | "stickers" | "classified" | "standard" | "auction" | "pre-order" | "prize-draw" | "digital-code" | "live";
         productId: string;
         productTitle: string;
         currency?: string | undefined;
-        storeName?: string | undefined;
         quantity?: number | undefined;
+        storeName?: string | undefined;
         productImage?: string | undefined;
         offerId?: string | undefined;
         lockedPrice?: number | undefined;
         isOffer?: boolean | undefined;
     }[];
 }>;
-export type AddToCartInput = z.infer<typeof addToCartSchema>;
+/**
+ * Renamed from `AddToCartInput` 2026-08-24 (W3) — `features/cart/schemas/
+ * firestore.ts` declares its own hand-written `AddToCartInput`, and a consumer
+ * importing the name had no way to tell which one it got.
+ */
+export type AddToCartActionInput = z.infer<typeof addToCartSchema>;
 export type MergeGuestCartInput = z.infer<typeof mergeGuestCartSchema>;

package/dist/_internal/shared/features/cart/schema.js

@@ -10,6 +10,19 @@ const cartItemBaseSchema = z.object({
     quantity: z.number().int().min(1).max(99).default(1),
     // SB1-G Phase 4 — canonical listing-kind snapshot.
     // SB-UNI-D — "bundle" removed from the listing-kind enum.
+    /*
+     * All NINE listing types. `art` and `stickers` were missing until
+     * 2026-08-24 (W3) — added to the union, the plugin registry, the capability
+     * map and the Sieve alias map, but not here.
+     *
+     * Not a live bug today, and verified rather than assumed (Rule #4): the real
+     * add-to-cart path is `POST /api/cart`, which takes only {productId,
+     * quantity} and derives the type server-side via `normalizeListingType`,
+     * never validating it against an enum. This enum sits on paths an art or
+     * sticker listing cannot currently reach. It was a trap waiting for the
+     * first caller that did — the third instalment of Root Cause #58, where a
+     * union member is added everywhere except the one allowlist that gates it.
+     */
     listingType: z.enum([
         "standard",
         "auction",
@@ -18,6 +31,8 @@ const cartItemBaseSchema = z.object({
         "classified",
         "digital-code",
         "live",
+        "art",
+        "stickers",
     ]),
     isOffer: z.boolean().optional(),
     offerId: z.string().optional(),

package/dist/_internal/shared/features/categories/bundle-schemas.d.ts

@@ -26,35 +26,35 @@ export declare const bundleQueryRuleSchema: z.ZodDiscriminatedUnion<"type", [z.Z
         /** Eligible listing types for a dynamic bundle rule. */
         listingType: z.ZodOptional<z.ZodEnum<["standard", "pre-order", "prize-draw"]>>;
     }, "strip", z.ZodTypeAny, {
-        listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+        categorySlug?: string | undefined;
         brandSlug?: string | undefined;
         tags?: string[] | undefined;
-        categorySlug?: string | undefined;
-    }, {
         listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+    }, {
+        categorySlug?: string | undefined;
         brandSlug?: string | undefined;
         tags?: string[] | undefined;
-        categorySlug?: string | undefined;
+        listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
     }>;
     orderBy: z.ZodOptional<z.ZodEnum<["price-asc", "price-desc", "createdAt-desc"]>>;
     limit: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     type: "dynamic";
     filter: {
-        listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+        categorySlug?: string | undefined;
         brandSlug?: string | undefined;
         tags?: string[] | undefined;
-        categorySlug?: string | undefined;
+        listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
     };
     limit: number;
     orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
 }, {
     type: "dynamic";
     filter: {
-        listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+        categorySlug?: string | undefined;
         brandSlug?: string | undefined;
         tags?: string[] | undefined;
-        categorySlug?: string | undefined;
+        listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
     };
     limit: number;
     orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
@@ -102,35 +102,35 @@ export declare const bundleCreateSchema: z.ZodObject<{
             /** Eligible listing types for a dynamic bundle rule. */
             listingType: z.ZodOptional<z.ZodEnum<["standard", "pre-order", "prize-draw"]>>;
         }, "strip", z.ZodTypeAny, {
-            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
-        }, {
             listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+        }, {
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
         }>;
         orderBy: z.ZodOptional<z.ZodEnum<["price-asc", "price-desc", "createdAt-desc"]>>;
         limit: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         type: "dynamic";
         filter: {
-            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
         };
         limit: number;
         orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
     }, {
         type: "dynamic";
         filter: {
-            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
         };
         limit: number;
         orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
@@ -172,10 +172,10 @@ export declare const bundleCreateSchema: z.ZodObject<{
     } | {
         type: "dynamic";
         filter: {
-            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
         };
         limit: number;
         orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
@@ -204,10 +204,10 @@ export declare const bundleCreateSchema: z.ZodObject<{
     } | {
         type: "dynamic";
         filter: {
-            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
         };
         limit: number;
         orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
@@ -250,35 +250,35 @@ export declare const bundleUpdateSchema: z.ZodObject<{
             /** Eligible listing types for a dynamic bundle rule. */
             listingType: z.ZodOptional<z.ZodEnum<["standard", "pre-order", "prize-draw"]>>;
         }, "strip", z.ZodTypeAny, {
-            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
-        }, {
             listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+        }, {
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
         }>;
         orderBy: z.ZodOptional<z.ZodEnum<["price-asc", "price-desc", "createdAt-desc"]>>;
         limit: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         type: "dynamic";
         filter: {
-            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
         };
         limit: number;
         orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
     }, {
         type: "dynamic";
         filter: {
-            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
         };
         limit: number;
         orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
@@ -331,10 +331,10 @@ export declare const bundleUpdateSchema: z.ZodObject<{
     } | {
         type: "dynamic";
         filter: {
-            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
         };
         limit: number;
         orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
@@ -362,10 +362,10 @@ export declare const bundleUpdateSchema: z.ZodObject<{
     } | {
         type: "dynamic";
         filter: {
-            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
             brandSlug?: string | undefined;
             tags?: string[] | undefined;
-            categorySlug?: string | undefined;
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
         };
         limit: number;
         orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;

package/dist/_internal/shared/features/emi/schedule.d.ts

@@ -44,13 +44,23 @@ export interface EmiInstallmentPlan {
     /** Decimal rupees. */
     amount: number;
 }
-export interface EmiScheduleResult {
+export interface EmiScheduleResult extends BuyerEmiQuote {
+    surchargeSellerShare: number;
+    surchargePlatformShare: number;
+}
+/**
+ * The buyer-visible half of an EMI schedule — everything the checkout UI
+ * renders, with the platform/seller surcharge split deliberately absent.
+ *
+ * This exists so the browser never needs `surchargeSellerSharePercent`, an
+ * internal revenue-split figure. `computeEmiSchedule` below adds the split
+ * back for the two server-side order-creation callers.
+ */
+export interface BuyerEmiQuote {
     /** Down payment collected at checkout, decimal rupees. */
     tokenAmount: number;
     /** Total surcharge across the whole tenure, decimal rupees. */
     surchargeAmount: number;
-    surchargeSellerShare: number;
-    surchargePlatformShare: number;
     installments: EmiInstallmentPlan[];
     /** Sum of all installment amounts — what's still owed after the token. */
     remainingBalance: number;
@@ -60,4 +70,15 @@ export interface EmiScheduleResult {
  * calendar month AFTER purchase, regardless of which day of the current
  * month the purchase happens on.
  */
+export declare function computeBuyerEmiQuote(sellerSubtotal: number, tenureMonths: number, settings: Pick<EmiSettings, "tokenPercent" | "billingDay" | "surchargePercentPerMonth">, purchaseDate?: Date): BuyerEmiQuote;
+/**
+ * Server-side schedule — the buyer quote plus the platform/seller surcharge
+ * split. Order creation needs the split; the checkout UI does not, and must
+ * use `computeBuyerEmiQuote` so `surchargeSellerSharePercent` never has to be
+ * shipped to the browser.
+ *
+ * `surchargeSellerSharePercent` stays REQUIRED here on purpose: defaulting it
+ * to 0 would let a server caller that forgot to pass it silently record a zero
+ * seller share on a real order.
+ */
 export declare function computeEmiSchedule(sellerSubtotal: number, tenureMonths: number, settings: Pick<EmiSettings, "tokenPercent" | "billingDay" | "surchargePercentPerMonth" | "surchargeSellerSharePercent">, purchaseDate?: Date): EmiScheduleResult;

package/dist/_internal/shared/features/emi/schedule.js

@@ -35,12 +35,10 @@ export function checkEmiEligibility(sellerSubtotal, sellerEmiEnabled, settings)
  * calendar month AFTER purchase, regardless of which day of the current
  * month the purchase happens on.
  */
-export function computeEmiSchedule(sellerSubtotal, tenureMonths, settings, purchaseDate = new Date()) {
+export function computeBuyerEmiQuote(sellerSubtotal, tenureMonths, settings, purchaseDate = new Date()) {
     const tokenAmount = roundRupees(sellerSubtotal * (settings.tokenPercent / 100));
     const principalRemaining = sellerSubtotal - tokenAmount;
     const surchargeAmount = roundRupees(principalRemaining * (settings.surchargePercentPerMonth / 100) * tenureMonths);
-    const surchargeSellerShare = roundRupees(surchargeAmount * (settings.surchargeSellerSharePercent / 100));
-    const surchargePlatformShare = roundRupees(surchargeAmount - surchargeSellerShare);
     const totalToInstall = roundRupees(principalRemaining + surchargeAmount);
     const baseInstallment = roundRupees(Math.floor((totalToInstall / tenureMonths) * 100) / 100);
     const remainder = roundRupees(totalToInstall - baseInstallment * tenureMonths);
@@ -55,9 +53,26 @@ export function computeEmiSchedule(sellerSubtotal, tenureMonths, settings, purch
     return {
         tokenAmount,
         surchargeAmount,
-        surchargeSellerShare,
-        surchargePlatformShare,
         installments,
         remainingBalance: totalToInstall,
     };
 }
+/**
+ * Server-side schedule — the buyer quote plus the platform/seller surcharge
+ * split. Order creation needs the split; the checkout UI does not, and must
+ * use `computeBuyerEmiQuote` so `surchargeSellerSharePercent` never has to be
+ * shipped to the browser.
+ *
+ * `surchargeSellerSharePercent` stays REQUIRED here on purpose: defaulting it
+ * to 0 would let a server caller that forgot to pass it silently record a zero
+ * seller share on a real order.
+ */
+export function computeEmiSchedule(sellerSubtotal, tenureMonths, settings, purchaseDate = new Date()) {
+    const quote = computeBuyerEmiQuote(sellerSubtotal, tenureMonths, settings, purchaseDate);
+    const surchargeSellerShare = roundRupees(quote.surchargeAmount * (settings.surchargeSellerSharePercent / 100));
+    return {
+        ...quote,
+        surchargeSellerShare,
+        surchargePlatformShare: roundRupees(quote.surchargeAmount - surchargeSellerShare),
+    };
+}

package/dist/_internal/shared/features/events/schema.d.ts

@@ -58,9 +58,9 @@ export declare const eventUpdateSchema: z.ZodObject<Omit<{
     location?: string | undefined;
     description?: string | undefined;
     tags?: string[] | undefined;
-    maxEntries?: number | undefined;
     startsAt?: string | undefined;
     endsAt?: string | undefined;
+    maxEntries?: number | undefined;
     imageUrl?: string | undefined;
     entryFee?: number | undefined;
     isOnline?: boolean | undefined;
@@ -70,9 +70,9 @@ export declare const eventUpdateSchema: z.ZodObject<Omit<{
     location?: string | undefined;
     description?: string | undefined;
     tags?: string[] | undefined;
-    maxEntries?: number | undefined;
     startsAt?: string | undefined;
     endsAt?: string | undefined;
+    maxEntries?: number | undefined;
     imageUrl?: string | undefined;
     entryFee?: number | undefined;
     isOnline?: boolean | undefined;

package/dist/_internal/shared/features/homepage/section-gate.d.ts

@@ -0,0 +1,14 @@
+import type { SectionType } from "../../../../features/homepage/schemas/firestore";
+import type { FeatureFlagKey } from "../../../../features/admin/schemas/firestore";
+/** Section types that require a feature flag to be enabled to show on the homepage. */
+export declare const SECTION_FEATURE_GATE: Partial<Record<SectionType, FeatureFlagKey>>;
+/**
+ * Drop sections whose feature flag is off.
+ *
+ * A section type with no gate entry always passes, and a MISSING flag value
+ * counts as enabled (`!== false`) — the flags map is partial, and a section
+ * must not vanish just because an admin has never opened Site Settings.
+ */
+export declare function filterSectionsByFeatureFlags<T extends {
+    type: string;
+}>(sections: readonly T[], flags: Partial<Record<FeatureFlagKey, unknown>> | null | undefined): T[];