@mohasinac/appkit 2.7.17 → 2.7.18

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

@@ -232,15 +232,27 @@ export interface SiteSettingsDocument {
         codEnabled: boolean;
     };
     commissions: {
-        razorpayFeePercent: number;
+        /** Our platform cut charged to the buyer as a % of order value (e.g. 5 = 5%). */
+        platformFeePercent: number;
+        /** GST applied on top of our platform fee (18%). buyer pays platformFee × (1 + gstPercent/100). */
+        gstPercent: number;
+        /** Per-transaction gateway minimum fee in rupees. Ensures total charge is never below this floor. 0 = no minimum. */
+        minimumTransactionFee: number;
+        /** Razorpay gateway cost % (absorbed by platform, not passed through separately). */
+        gatewayFeePercent: number;
         codDepositPercent: number;
         sellerShippingFixed: number;
         platformShippingPercent: number;
         platformShippingFixedMin: number;
-        processingFeePercent?: number;
-        gstPercent?: number;
-        gatewayFeePercent?: number;
         autoPayoutWindowDays?: number;
+        /** Days before a settled order's funds are released for payout. */
+        payoutHoldDays?: number;
+        /** Minimum payout amount in rupees. */
+        minPayoutAmount?: number;
+        auctionListingFee?: number;
+        preOrderListingFee?: number;
+        featuredSlotFee?: number;
+        promotedSlotFee?: number;
     };
     socialLinks: {
         facebook?: string;
@@ -280,6 +292,8 @@ export interface SiteSettingsDocument {
         sellerRegistration: boolean;
         preOrders: boolean;
         seedPanel: boolean;
+        /** When true, admin users see a bypass button in checkout that skips OTP and payment. Server-enforced. */
+        adminCheckoutBypass?: boolean;
         listingTypes?: {
             standard?: boolean;
             auction?: boolean;

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

@@ -136,11 +136,21 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         codEnabled: true,
     },
     commissions: {
-        razorpayFeePercent: 5,
+        platformFeePercent: 5,
+        gstPercent: 18,
+        minimumTransactionFee: 0,
+        gatewayFeePercent: 2,
         codDepositPercent: 10,
         sellerShippingFixed: 0,
         platformShippingPercent: 10,
         platformShippingFixedMin: 0,
+        autoPayoutWindowDays: 7,
+        payoutHoldDays: 2,
+        minPayoutAmount: 100,
+        auctionListingFee: 0,
+        preOrderListingFee: 0,
+        featuredSlotFee: 999,
+        promotedSlotFee: 499,
     },
     featureFlags: {
         chats: true,

package/dist/features/categories/components/BundleBuyNowCta.d.ts

@@ -4,5 +4,7 @@ export interface BundleBuyNowCtaProps {
     onBuyNow: (input: {
         bundleSlug: string;
     }) => Promise<unknown>;
+    /** Renders a smaller single-line button suited for list cards. */
+    compact?: boolean;
 }
-export declare function BundleBuyNowCta({ bundleSlug, outOfStock, onBuyNow, }: BundleBuyNowCtaProps): import("react/jsx-runtime").JSX.Element;
+export declare function BundleBuyNowCta({ bundleSlug, outOfStock, onBuyNow, compact, }: BundleBuyNowCtaProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/categories/components/BundleBuyNowCta.js

@@ -12,7 +12,7 @@ import { Button, LoginRequiredModal, Stack, Text } from "../../../ui";
 import { useToast } from "../../../ui";
 import { isAuthError } from "../../../utils/auth-error";
 import { BUNDLE_COPY } from "../../../_internal/shared/features/categories/bundle-copy";
-export function BundleBuyNowCta({ bundleSlug, outOfStock = false, onBuyNow, }) {
+export function BundleBuyNowCta({ bundleSlug, outOfStock = false, onBuyNow, compact = false, }) {
     const { showToast } = useToast();
     const [submitting, setSubmitting] = useState(false);
     const [error, setError] = useState(null);
@@ -38,7 +38,7 @@ export function BundleBuyNowCta({ bundleSlug, outOfStock = false, onBuyNow, }) {
         }
     }, [bundleSlug, onBuyNow, showToast]);
     if (outOfStock) {
-        return (_jsxs(Stack, { gap: "xs", "aria-live": "polite", children: [_jsx(Button, { variant: "primary", disabled: true, "aria-disabled": true, children: BUNDLE_COPY.detail.ctaOutOfStock }), _jsx(Text, { size: "xs", color: "muted", children: BUNDLE_COPY.detail.ctaHint })] }));
+        return (_jsxs(Stack, { gap: "xs", "aria-live": "polite", children: [_jsx(Button, { variant: "primary", size: compact ? "sm" : "md", disabled: true, "aria-disabled": true, className: compact ? "w-full" : undefined, children: BUNDLE_COPY.detail.ctaOutOfStock }), !compact && (_jsx(Text, { size: "xs", color: "muted", children: BUNDLE_COPY.detail.ctaHint }))] }));
     }
-    return (_jsxs(_Fragment, { children: [_jsx(LoginRequiredModal, { isOpen: showLoginModal, onClose: () => setShowLoginModal(false), message: "You need to be signed in to purchase this bundle. Please log in or create an account to continue." }), _jsxs(Stack, { gap: "sm", children: [_jsx(Button, { variant: "primary", onClick: handleClick, disabled: submitting, "aria-busy": submitting, children: submitting ? BUNDLE_COPY.detail.ctaAdding : BUNDLE_COPY.detail.ctaBuyNow }), error && (_jsx(Text, { size: "sm", color: "danger", role: "alert", children: error }))] })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(LoginRequiredModal, { isOpen: showLoginModal, onClose: () => setShowLoginModal(false), message: "You need to be signed in to purchase this bundle. Please log in or create an account to continue." }), _jsxs(Stack, { gap: "sm", children: [_jsx(Button, { variant: "primary", size: compact ? "sm" : "md", onClick: handleClick, disabled: submitting, "aria-busy": submitting, className: compact ? "w-full" : undefined, children: submitting ? BUNDLE_COPY.detail.ctaAdding : BUNDLE_COPY.detail.ctaBuyNow }), error && (_jsx(Text, { size: "sm", color: "danger", role: "alert", children: error }))] })] }));
 }

package/dist/features/categories/components/BundleDynamicRuleEditor.d.ts

@@ -4,7 +4,7 @@ type DynamicRule = {
         categorySlug?: string;
         brandSlug?: string;
         tags?: string[];
-        listingType?: "standard" | "pre-order";
+        listingType?: "standard" | "pre-order" | "prize-draw";
     };
     orderBy?: "price-asc" | "price-desc" | "createdAt-desc";
     limit: number;

package/dist/features/categories/components/BundleDynamicRuleEditor.js

@@ -29,9 +29,10 @@ const ORDER_BY_OPTIONS = [
     { label: "Price (high → low)", value: "price-desc" },
 ];
 const LISTING_TYPE_OPTIONS = [
-    { label: "Any (standard + pre-order)", value: "" },
+    { label: "Any", value: "" },
     { label: "Standard only", value: "standard" },
     { label: "Pre-order only", value: "pre-order" },
+    { label: "Prize draw only", value: "prize-draw" },
 ];
 export function BundleDynamicRuleEditor({ value, onChange, disabled = false, }) {
     const rule = value ?? DEFAULT_DYNAMIC_RULE;

package/dist/features/categories/components/BundlesListView.d.ts

@@ -1,6 +1,9 @@
 type SearchParams = Record<string, string | string[]>;
 export interface BundlesListViewProps {
     searchParams?: SearchParams;
+    onBuyNow?: (input: {
+        bundleSlug: string;
+    }) => Promise<unknown>;
 }
 /**
  * Public `/bundles` index. Bundles live as `categoryType:"bundle"` rows on
@@ -9,5 +12,5 @@ export interface BundlesListViewProps {
  * Optional `?storeId=…` post-filters to a single seller's bundles.
  * Sort UI is owned by `CategoryBundlesListing` (client).
  */
-export declare function BundlesListView({ searchParams, }: BundlesListViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function BundlesListView({ searchParams, onBuyNow, }: BundlesListViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
 export {};

package/dist/features/categories/components/BundlesListView.js

@@ -15,7 +15,7 @@ function sp(params, key) {
  * Optional `?storeId=…` post-filters to a single seller's bundles.
  * Sort UI is owned by `CategoryBundlesListing` (client).
  */
-export async function BundlesListView({ searchParams = {}, }) {
+export async function BundlesListView({ searchParams = {}, onBuyNow, }) {
     const storeId = sp(searchParams, "storeId");
     const all = await categoriesRepository
         .listByType("bundle", { activeOnly: true, limit: DEFAULT_LIMIT })
@@ -23,5 +23,5 @@ export async function BundlesListView({ searchParams = {}, }) {
     const bundles = storeId
         ? all.filter((c) => c.createdByStoreId === storeId)
         : all;
-    return (_jsx(Main, { children: _jsx(Section, { className: "py-10", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-2 text-3xl font-semibold text-zinc-900 dark:text-zinc-100", children: "Collectible Bundles" }), _jsx(Text, { className: "mb-6 text-sm text-[var(--appkit-color-text-muted)]", children: "Curated multi-product bundles \u2014 Pok\u00E9mon starter sets, Beyblade tournament packs, Hot Wheels collector boxes and more. One price, one checkout, one shipment." }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(CategoryBundlesListing, { initialBundles: bundles }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
+    return (_jsx(Main, { children: _jsx(Section, { className: "py-10", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-2 text-3xl font-semibold text-zinc-900 dark:text-zinc-100", children: "Collectible Bundles" }), _jsx(Text, { className: "mb-6 text-sm text-[var(--appkit-color-text-muted)]", children: "Curated multi-product bundles \u2014 Pok\u00E9mon starter sets, Beyblade tournament packs, Hot Wheels collector boxes and more. One price, one checkout, one shipment." }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(CategoryBundlesListing, { initialBundles: bundles, onBuyNow: onBuyNow }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
 }

package/dist/features/categories/components/CategoryBundlesListing.d.ts

@@ -2,5 +2,8 @@ import type { CategoryDocument } from "../schemas";
 export interface CategoryBundlesListingProps {
     initialBundles: CategoryDocument[];
     brandName?: string;
+    onBuyNow?: (input: {
+        bundleSlug: string;
+    }) => Promise<unknown>;
 }
-export declare function CategoryBundlesListing({ initialBundles, brandName, }: CategoryBundlesListingProps): import("react/jsx-runtime").JSX.Element;
+export declare function CategoryBundlesListing({ initialBundles, brandName, onBuyNow, }: CategoryBundlesListingProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/categories/components/CategoryBundlesListing.js

@@ -12,6 +12,7 @@ import Link from "next/link";
 import { Badge, Div, Row, Select, Stack, Text } from "../../../ui";
 import { ROUTES } from "../../../next/routing/route-map";
 import { formatCurrency } from "../../../utils/number.formatter";
+import { BundleBuyNowCta } from "./BundleBuyNowCta";
 const SORT_OPTIONS = [
     { label: "Newest", value: "newest" },
     { label: "Price ↑", value: "price-asc" },
@@ -47,7 +48,7 @@ function comparator(sort) {
         return bT - aT;
     };
 }
-export function CategoryBundlesListing({ initialBundles, brandName, }) {
+export function CategoryBundlesListing({ initialBundles, brandName, onBuyNow, }) {
     const [sort, setSort] = useState("newest");
     const filtered = useMemo(() => initialBundles
         .filter((c) => c.categoryType === "bundle")
@@ -56,17 +57,17 @@ export function CategoryBundlesListing({ initialBundles, brandName, }) {
     if (filtered.length === 0) {
         return (_jsx(Div, { className: "rounded-2xl border border-dashed border-zinc-200 py-16 text-center dark:border-zinc-700", children: _jsxs(Text, { color: "muted", children: [COPY.empty, brandName ? COPY.forBrand(brandName) : "", COPY.yetSuffix] }) }));
     }
-    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "end", children: [_jsx(Text, { size: "sm", color: "muted", children: COPY.sortLabel }), _jsx(Select, { options: SORT_OPTIONS, value: sort, onValueChange: setSort, "aria-label": COPY.sortLabel })] }), _jsx(Div, { className: "grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-3", children: filtered.map((bundle) => (_jsx(BundleCard, { bundle: bundle }, bundle.id))) })] }));
+    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "end", children: [_jsx(Text, { size: "sm", color: "muted", children: COPY.sortLabel }), _jsx(Select, { options: SORT_OPTIONS, value: sort, onValueChange: setSort, "aria-label": COPY.sortLabel })] }), _jsx(Div, { className: "grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-3", children: filtered.map((bundle) => (_jsx(BundleCard, { bundle: bundle, onBuyNow: onBuyNow }, bundle.id))) })] }));
 }
-function BundleCard({ bundle }) {
+function BundleCard({ bundle, onBuyNow }) {
     const memberCount = bundle.bundleProductIds?.length ?? 0;
     const stock = bundle.bundleStockStatus ?? "in_stock";
     const badge = STOCK_BADGE_TEXT[stock];
     const cover = bundle.display?.coverImage;
     const href = String(ROUTES.PUBLIC.BUNDLE_DETAIL?.(bundle.slug) ?? "#");
-    return (_jsxs(Link, { href: href, className: "group rounded-xl border border-zinc-200 bg-white p-3 transition-colors hover:border-zinc-300 dark:border-zinc-800 dark:bg-zinc-900 dark:hover:border-zinc-700", children: [_jsx(Div, { className: "mb-2 aspect-video overflow-hidden rounded-lg bg-zinc-100 dark:bg-zinc-800", children: cover ? (
-                // eslint-disable-next-line @next/next/no-img-element
-                _jsx("img", { src: cover, alt: bundle.name, className: "h-full w-full object-cover transition-transform group-hover:scale-105", loading: "lazy" })) : (_jsx(Div, { className: "flex h-full w-full items-center justify-center text-3xl", children: PLACEHOLDER_EMOJI })) }), _jsx(Text, { className: "line-clamp-2 text-sm font-semibold", children: bundle.name }), _jsxs(Row, { gap: "sm", align: "center", className: "mt-1", children: [_jsx(Text, { size: "sm", weight: "bold", children: bundle.bundlePriceInPaise
-                            ? formatCurrency(bundle.bundlePriceInPaise / 100, "INR")
-                            : COPY.priceFallback }), _jsx(Text, { size: "xs", color: "muted", children: COPY.items(memberCount) })] }), badge && (_jsx(Badge, { variant: STOCK_BADGE_VARIANT[stock], className: "mt-1", children: badge }))] }));
+    return (_jsxs(Stack, { gap: "none", className: "rounded-xl border border-zinc-200 bg-white dark:border-zinc-800 dark:bg-zinc-900", children: [_jsxs(Link, { href: href, className: "group block p-3 hover:no-underline", children: [_jsx(Div, { className: "mb-2 aspect-video overflow-hidden rounded-lg bg-zinc-100 dark:bg-zinc-800", children: cover ? (
+                        // eslint-disable-next-line @next/next/no-img-element
+                        _jsx("img", { src: cover, alt: bundle.name, className: "h-full w-full object-cover transition-transform group-hover:scale-105", loading: "lazy" })) : (_jsx(Div, { className: "flex h-full w-full items-center justify-center text-3xl", children: PLACEHOLDER_EMOJI })) }), _jsx(Text, { className: "line-clamp-2 text-sm font-semibold", children: bundle.name }), _jsxs(Row, { gap: "sm", align: "center", className: "mt-1", children: [_jsx(Text, { size: "sm", weight: "bold", children: bundle.bundlePriceInPaise
+                                    ? formatCurrency(bundle.bundlePriceInPaise / 100, "INR")
+                                    : COPY.priceFallback }), _jsx(Text, { size: "xs", color: "muted", children: COPY.items(memberCount) })] }), badge && (_jsx(Badge, { variant: STOCK_BADGE_VARIANT[stock], className: "mt-1", children: badge }))] }), onBuyNow && (_jsx(Div, { className: "border-t border-zinc-100 p-3 pt-2 dark:border-zinc-800", children: _jsx(BundleBuyNowCta, { bundleSlug: bundle.slug, outOfStock: stock === "out_of_stock", onBuyNow: onBuyNow, compact: true }) }))] }));
 }

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

@@ -27,11 +27,24 @@ export type BundleQueryRule = {
         categorySlug?: string;
         brandSlug?: string;
         tags?: string[];
-        listingType?: "standard" | "pre-order";
+        /** Eligible listing types that may appear in a dynamic bundle. */
+        listingType?: "standard" | "pre-order" | "prize-draw";
     };
     orderBy?: "price-asc" | "price-desc" | "createdAt-desc";
     limit: number;
 };
+/**
+ * Per-member metadata stored alongside `bundleProductIds`.
+ * `drawCount` — only meaningful when the member product has
+ * `listingType === "prize-draw"`. Represents how many draw entries
+ * the buyer receives for that product when they purchase the bundle
+ * (e.g. drawCount=5 means 5 raffle entries, not 5 copies of the draw).
+ */
+export interface BundleItemDetail {
+    productId: string;
+    /** Number of draw entries included when product is a prize-draw. */
+    drawCount?: number;
+}
 /** Full Firestore category document (includes server-only fields) */
 export interface CategoryDocumentSEO {
     title: string;
@@ -100,6 +113,14 @@ export interface CategoryDocument {
     brandFounded?: number;
     /** Banner image for the brand storefront page — categoryType==="brand". */
     brandBannerImage?: string;
+    /**
+     * "special" — admin-curated bundle; writes reverse `partOfBundleIds`
+     * pointers on member products and shows the "Bundled" badge on cards.
+     *
+     * "brand" — auto-generated brand collection (dynamic brandSlug query).
+     * Does NOT update `partOfBundleIds`; used as a discovery surface only.
+     */
+    bundleKind?: "special" | "brand";
     /** Discounted bundle price in paise. */
     bundlePriceInPaise?: number;
     /** Rule resolving the bundle's member products — static list or live query. */
@@ -110,6 +131,13 @@ export interface CategoryDocument {
     bundleQueryResolvedAt?: Date;
     /** Hand-picked products list (mirror of bundleQueryRule for static rules); kept for index-friendly queries. */
     bundleProductIds?: string[];
+    /**
+     * Per-member metadata parallel to `bundleProductIds`.
+     * Carries `drawCount` for prize-draw members (how many raffle entries
+     * the buyer receives). Flat `bundleProductIds` is kept for Firestore
+     * array-contains queries; this array holds the richer shape.
+     */
+    bundleItemDetails?: BundleItemDetail[];
     seo: CategoryDocumentSEO;
     display: CategoryDocumentDisplay;
     isActive: boolean;

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

@@ -17,4 +17,15 @@ export declare function verifyCheckoutConsentOtp(userId: string, addressId: stri
  * registered phone number.
  */
 export declare function grantCheckoutConsentViaSms(userId: string, userPhone: string | undefined, addressId: string): Promise<void>;
+/**
+ * Grants checkout consent for an admin test order, bypassing the normal OTP flow.
+ *
+ * The resulting Firestore doc is identical to a verified consent OTP so that
+ * `createCheckoutOrderAction` can proceed without modification.  The
+ * `verifiedVia: "admin_bypass"` marker prevents bypass-credit grants.
+ *
+ * Security: callers MUST verify the requesting user is an admin AND that
+ * `siteSettings.featureFlags.adminCheckoutBypass === true` before calling this.
+ */
+export declare function grantAdminCheckoutBypass(userId: string, addressId: string, bypassingAdminUid: string): Promise<void>;
 export { userRepository };

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

@@ -94,4 +94,30 @@ export async function grantCheckoutConsentViaSms(userId, userPhone, addressId) {
     });
     serverLogger.info(`Checkout consent granted via SMS: uid=${userId} addressId=${addressId}`);
 }
+/**
+ * Grants checkout consent for an admin test order, bypassing the normal OTP flow.
+ *
+ * The resulting Firestore doc is identical to a verified consent OTP so that
+ * `createCheckoutOrderAction` can proceed without modification.  The
+ * `verifiedVia: "admin_bypass"` marker prevents bypass-credit grants.
+ *
+ * Security: callers MUST verify the requesting user is an admin AND that
+ * `siteSettings.featureFlags.adminCheckoutBypass === true` before calling this.
+ */
+export async function grantAdminCheckoutBypass(userId, addressId, bypassingAdminUid) {
+    const address = await findUserAddress(userId, addressId);
+    if (!address)
+        throw new ValidationError("Address not found.");
+    await saveConsentOtp(userId, addressId, {
+        codeHash: "",
+        expiresAt: new Date(Date.now() + CONSENT_OTP_EXPIRY_MS),
+        attempts: 0,
+        verified: true,
+        verifiedVia: "admin_bypass",
+        adminBypassBy: bypassingAdminUid,
+        addressId,
+        createdAt: new Date(),
+    });
+    serverLogger.info(`Admin checkout bypass granted: uid=${userId} addressId=${addressId} bypassedBy=${bypassingAdminUid}`);
+}
 export { userRepository };

package/dist/features/filters/FilterFacetSection.d.ts

@@ -15,10 +15,15 @@ export interface FilterFacetSectionProps {
     onToggle?: () => void;
     onClear?: () => void;
     className?: string;
+    /**
+     * "accordion" (default) — collapsible inline section inside a filter drawer.
+     * "dropdown" — compact pill button with a floating panel; use in horizontal toolbars.
+     */
+    displayAs?: "accordion" | "dropdown";
 }
 /**
  * FilterFacetSection — collapsible checkbox/radio filter section.
  * Supports single-select and multi-select modes.
  * When searchable, the search input is always visible and typing auto-expands.
  */
-export declare function FilterFacetSection({ title, options, selected, onChange, selectionMode, defaultCollapsed, searchable, isOpen: controlledOpen, onToggle, onClear, className, }: FilterFacetSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function FilterFacetSection({ title, options, selected, onChange, selectionMode, defaultCollapsed, searchable, isOpen: controlledOpen, onToggle, onClear, className, displayAs, }: FilterFacetSectionProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/filters/FilterFacetSection.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from "react";
+import { useEffect, useRef, useState } from "react";
 import { Button, Div, Input, Row, Span, Text } from "../../ui";
 import { cn } from "./filterUtils";
 /**
@@ -8,10 +8,23 @@ import { cn } from "./filterUtils";
  * Supports single-select and multi-select modes.
  * When searchable, the search input is always visible and typing auto-expands.
  */
-export function FilterFacetSection({ title, options, selected, onChange, selectionMode = "multi", defaultCollapsed = true, searchable = false, isOpen: controlledOpen, onToggle, onClear, className = "", }) {
+export function FilterFacetSection({ title, options, selected, onChange, selectionMode = "multi", defaultCollapsed = true, searchable = false, isOpen: controlledOpen, onToggle, onClear, className = "", displayAs = "accordion", }) {
     const isControlled = controlledOpen !== undefined;
     const [internalCollapsed, setInternalCollapsed] = useState(defaultCollapsed);
     const [search, setSearch] = useState("");
+    const [dropdownOpen, setDropdownOpen] = useState(false);
+    const dropdownRef = useRef(null);
+    useEffect(() => {
+        if (displayAs !== "dropdown")
+            return;
+        function handleOutsideClick(e) {
+            if (dropdownRef.current && !dropdownRef.current.contains(e.target)) {
+                setDropdownOpen(false);
+            }
+        }
+        document.addEventListener("mousedown", handleOutsideClick);
+        return () => document.removeEventListener("mousedown", handleOutsideClick);
+    }, [displayAs]);
     const isCollapsed = isControlled ? !controlledOpen : internalCollapsed;
     const handleToggle = () => {
         if (onToggle)
@@ -44,6 +57,16 @@ export function FilterFacetSection({ title, options, selected, onChange, selecti
     const selectedLabels = selected
         .map((v) => options.find((o) => o.value === v)?.label ?? v)
         .slice(0, 3);
+    // ── Dropdown variant ────────────────────────────────────────────────────
+    if (displayAs === "dropdown") {
+        return (_jsxs(Div, { ref: dropdownRef, className: cn("relative inline-block", className), children: [_jsxs(Button, { type: "button", onClick: () => setDropdownOpen((o) => !o), variant: "ghost", className: cn("inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-sm font-medium transition-colors", hasValue
+                        ? "border-emerald-500 bg-emerald-50 text-emerald-700 dark:border-emerald-500/60 dark:bg-emerald-900/20 dark:text-emerald-300"
+                        : "border-zinc-200 bg-white text-zinc-700 hover:border-zinc-400 dark:border-slate-700 dark:bg-slate-900 dark:text-zinc-200 dark:hover:border-slate-500"), children: [title, hasValue && (_jsx(Span, { className: "inline-flex h-4 w-4 items-center justify-center rounded-full bg-emerald-600 text-[10px] font-bold text-white", children: selected.length })), _jsx("svg", { className: cn("h-3.5 w-3.5 text-zinc-400 transition-transform", dropdownOpen ? "rotate-180" : ""), fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", strokeWidth: 2, "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M19 9l-7 7-7-7" }) })] }), dropdownOpen && (_jsxs(Div, { className: "absolute left-0 top-full z-[var(--appkit-z-dropdown,50)] mt-1 min-w-[180px] max-w-[260px] rounded-xl border border-zinc-200 bg-white shadow-lg dark:border-slate-700 dark:bg-slate-900", children: [searchable && (_jsx(Div, { className: "border-b border-zinc-100 p-2 dark:border-slate-800", children: _jsx(Input, { type: "search", placeholder: "Search\u2026", value: search, onChange: (e) => handleSearch(e.target.value), className: "w-full rounded-md border border-zinc-200 bg-white px-2 py-1 text-xs text-zinc-900 focus:outline-none dark:border-slate-700 dark:bg-slate-800/60 dark:text-zinc-100" }) })), _jsxs(Div, { className: "max-h-56 overflow-y-auto py-1", children: [filtered.map((option) => {
+                                    const isSelected = selected.includes(option.value);
+                                    return (_jsxs(Row, { gap: "xs", className: "cursor-pointer rounded-lg px-3 py-1.5 hover:bg-zinc-50 dark:hover:bg-slate-800 mx-1", onClick: () => toggle(option.value), children: [_jsx("input", { type: selectionMode === "single" ? "radio" : "checkbox", checked: isSelected, onChange: () => toggle(option.value), "aria-label": option.label, className: "h-3.5 w-3.5 flex-shrink-0 cursor-pointer rounded border-zinc-300 text-primary-600 dark:border-slate-600 dark:text-secondary-500" }), _jsx(Span, { className: "flex-1 truncate text-xs text-zinc-700 dark:text-zinc-300", children: option.label }), option.count !== undefined && (_jsx(Span, { className: "flex-shrink-0 text-[10px] tabular-nums text-zinc-400 dark:text-zinc-500", children: option.count }))] }, option.value));
+                                }), filtered.length === 0 && (_jsx(Text, { className: "px-3 py-2 text-xs text-zinc-400 dark:text-zinc-500", children: "No results" }))] }), hasValue && (_jsx(Div, { className: "border-t border-zinc-100 p-1 dark:border-slate-800", children: _jsx(Button, { type: "button", variant: "ghost", size: "sm", className: "w-full py-1 text-xs text-zinc-400 transition-colors hover:text-red-600", onClick: () => { onChange([]); onClear?.(); setDropdownOpen(false); }, children: "Clear" }) }))] }))] }));
+    }
+    // ── Accordion variant (default) ─────────────────────────────────────────
     return (_jsxs(Div, { className: cn("p-4 border-b border-zinc-200 dark:border-slate-700 last:border-b-0", className), children: [_jsxs(Row, { gap: "xs", children: [_jsxs(Button, { type: "button", onClick: handleToggle, variant: "ghost", size: "sm", className: "flex flex-1 items-center justify-between text-sm font-semibold text-zinc-900 dark:text-zinc-50 py-1 hover:opacity-80 transition-opacity", "aria-expanded": !isCollapsed, children: [_jsxs(Row, { as: Span, gap: "xs", children: [title, hasValue && (_jsx(Span, { className: "inline-flex items-center justify-center w-5 h-5 text-xs rounded-full bg-emerald-50 dark:bg-emerald-900/30 text-emerald-700 dark:text-emerald-300 ring-1 ring-emerald-600/20 dark:ring-emerald-400/20", children: selected.length }))] }), _jsx("svg", { className: cn("w-4 h-4 text-zinc-500 dark:text-zinc-400 transition-transform duration-200", isCollapsed ? "" : "rotate-180"), fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", strokeWidth: 2, "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M19 9l-7 7-7-7" }) })] }), onClear && hasValue && (_jsx(Button, { type: "button", onClick: onClear, variant: "ghost", size: "sm", className: "inline-flex items-center justify-center w-5 h-5 p-0 text-zinc-500 dark:text-zinc-400 hover:text-red-600 dark:hover:text-red-400 hover:bg-zinc-100 dark:hover:bg-slate-700 transition-colors rounded-full", "aria-label": "Clear filter", children: _jsx("svg", { className: "w-3 h-3", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", strokeWidth: 2.5, "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M6 18L18 6M6 6l12 12" }) }) }))] }), isCollapsed && hasValue && (_jsxs(Div, { className: "mt-2 flex flex-wrap gap-1", children: [selectedLabels.map((label) => (_jsx(Span, { className: "inline-flex items-center px-2 py-0.5 rounded-full text-xs bg-zinc-100 dark:bg-slate-700 text-zinc-700 dark:text-zinc-300 border border-zinc-200 dark:border-slate-600", children: label }, label))), selected.length > 3 && (_jsxs(Span, { className: "inline-flex items-center px-2 py-0.5 rounded-full text-xs text-zinc-400 dark:text-zinc-500", children: ["+", selected.length - 3, " more"] }))] })), searchable && (_jsx(Div, { className: "mt-2", children: _jsx(Input, { type: "search", placeholder: "Search\u2026", value: search, onChange: (e) => handleSearch(e.target.value), className: "w-full rounded-md border border-zinc-200 dark:border-slate-700 bg-white dark:bg-slate-800/60 px-2.5 py-1.5 text-xs text-zinc-900 dark:text-zinc-100 focus:outline-none focus:ring-2 focus:ring-primary-500/20 dark:focus:ring-secondary-400/20" }) })), !isCollapsed && (_jsxs(Div, { className: "mt-3 space-y-1", children: [filtered.map((option) => {
                         const isSelected = selected.includes(option.value);
                         return (_jsxs(Row, { gap: "2.5", className: "py-1 cursor-pointer group", children: [selectionMode === "single" ? (_jsx("input", { type: "radio", checked: isSelected, onChange: () => toggle(option.value), "aria-label": option.label, className: cn("flex-shrink-0 border-zinc-300 dark:border-slate-600 cursor-pointer", "w-4 h-4 rounded-full text-primary-600 dark:text-secondary-500", "focus:ring-primary-500/30 dark:focus:ring-secondary-400/30") })) : (_jsx("input", { type: "checkbox", checked: isSelected, onChange: () => toggle(option.value), "aria-label": option.label, className: cn("flex-shrink-0 border-zinc-300 dark:border-slate-600 cursor-pointer", "w-4 h-4 rounded text-primary-600 dark:text-secondary-500 checked:bg-primary-600 dark:checked:bg-secondary-500", "focus:ring-primary-500/30 dark:focus:ring-secondary-400/30") })), _jsx(Span, { className: "flex-1 text-sm text-zinc-700 dark:text-zinc-300 group-hover:text-zinc-900 dark:group-hover:text-zinc-100 transition-colors truncate", children: option.label }), option.count !== undefined && (_jsx(Span, { className: "text-xs text-zinc-400 dark:text-zinc-500 tabular-nums flex-shrink-0", children: option.count }))] }, option.value));

package/dist/features/homepage/components/FeaturedBundlesSection.d.ts

@@ -12,5 +12,8 @@ export interface FeaturedBundlesSectionProps {
     description?: string;
     initialItems?: CategoryDocument[];
     className?: string;
+    onBuyNow?: (input: {
+        bundleSlug: string;
+    }) => Promise<unknown>;
 }
-export declare function FeaturedBundlesSection({ title, description, initialItems, className, }: FeaturedBundlesSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function FeaturedBundlesSection({ title, description, initialItems, className, onBuyNow, }: FeaturedBundlesSectionProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/homepage/components/FeaturedBundlesSection.js

@@ -4,19 +4,20 @@ import { Badge, Div, Heading, Row, Section, Stack, Text } from "../../../ui";
 import { ROUTES } from "../../../next/routing/route-map";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { BUNDLE_COPY, BUNDLE_STOCK_VARIANT, } from "../../../_internal/shared/features/categories/bundle-copy";
+import { BundleBuyNowCta } from "../../categories/components/BundleBuyNowCta";
 const PLACEHOLDER_EMOJI = "📦";
-export function FeaturedBundlesSection({ title = BUNDLE_COPY.featuredDefaultTitle, description, initialItems = [], className = "", }) {
+export function FeaturedBundlesSection({ title = BUNDLE_COPY.featuredDefaultTitle, description, initialItems = [], className = "", onBuyNow, }) {
     const items = initialItems.filter((c) => c.categoryType === "bundle");
-    return (_jsx(Section, { className: `py-10 ${className}`, children: _jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "between", className: "flex-wrap", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, className: "text-2xl font-semibold text-zinc-900 dark:text-zinc-100", children: title }), description && (_jsx(Text, { size: "sm", color: "muted", children: description }))] }), _jsx(Link, { href: String(ROUTES.PUBLIC.BUNDLES ?? "/bundles"), className: "text-sm font-medium text-[var(--appkit-color-primary)] hover:underline", children: BUNDLE_COPY.featured.viewAll })] }), items.length === 0 ? (_jsx(Div, { className: "rounded-xl border border-dashed border-zinc-200 py-12 text-center dark:border-zinc-700", children: _jsx(Text, { color: "muted", children: BUNDLE_COPY.featured.empty }) })) : (_jsx(Div, { className: "grid grid-cols-2 gap-3 sm:grid-cols-3 lg:grid-cols-4", children: items.map((bundle) => (_jsx(FeaturedBundleCard, { bundle: bundle }, bundle.id))) }))] }) }));
+    return (_jsx(Section, { className: `py-10 ${className}`, children: _jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "between", className: "flex-wrap", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, className: "text-2xl font-semibold text-zinc-900 dark:text-zinc-100", children: title }), description && (_jsx(Text, { size: "sm", color: "muted", children: description }))] }), _jsx(Link, { href: String(ROUTES.PUBLIC.BUNDLES ?? "/bundles"), className: "text-sm font-medium text-[var(--appkit-color-primary)] hover:underline", children: BUNDLE_COPY.featured.viewAll })] }), items.length === 0 ? (_jsx(Div, { className: "rounded-xl border border-dashed border-zinc-200 py-12 text-center dark:border-zinc-700", children: _jsx(Text, { color: "muted", children: BUNDLE_COPY.featured.empty }) })) : (_jsx(Div, { className: "grid grid-cols-2 gap-3 sm:grid-cols-3 lg:grid-cols-4", children: items.map((bundle) => (_jsx(FeaturedBundleCard, { bundle: bundle, onBuyNow: onBuyNow }, bundle.id))) }))] }) }));
 }
-function FeaturedBundleCard({ bundle }) {
+function FeaturedBundleCard({ bundle, onBuyNow }) {
     const stock = bundle.bundleStockStatus ?? "in_stock";
     const memberCount = bundle.bundleProductIds?.length ?? 0;
     const cover = bundle.display?.coverImage;
     const href = String(ROUTES.PUBLIC.BUNDLE_DETAIL?.(bundle.slug) ?? "#");
-    return (_jsxs(Link, { href: href, className: "group rounded-xl border border-zinc-200 bg-white p-3 transition-colors hover:border-zinc-300 dark:border-zinc-800 dark:bg-zinc-900 dark:hover:border-zinc-700", children: [_jsx(Div, { className: "mb-2 aspect-square overflow-hidden rounded-lg bg-zinc-100 dark:bg-zinc-800", children: cover ? (
-                // eslint-disable-next-line @next/next/no-img-element, lir/no-raw-media-elements
-                _jsx("img", { src: cover, alt: bundle.name, className: "h-full w-full object-cover transition-transform group-hover:scale-105", loading: "lazy" })) : (_jsx(Div, { className: "flex h-full w-full items-center justify-center text-3xl", children: PLACEHOLDER_EMOJI })) }), _jsx(Text, { className: "line-clamp-2 text-sm font-semibold", children: bundle.name }), _jsxs(Row, { gap: "sm", align: "center", className: "mt-1 flex-wrap", children: [_jsx(Text, { size: "sm", weight: "bold", children: bundle.bundlePriceInPaise
-                            ? formatCurrency(bundle.bundlePriceInPaise / 100, "INR")
-                            : BUNDLE_COPY.featured.priceFallback }), _jsxs(Text, { size: "xs", color: "muted", children: ["\u00B7 ", BUNDLE_COPY.featured.itemCount(memberCount)] }), stock !== "in_stock" && (_jsx(Badge, { variant: BUNDLE_STOCK_VARIANT[stock], children: BUNDLE_COPY.stockBadge.listVariantOutOfStock }))] })] }));
+    return (_jsxs(Stack, { gap: "none", className: "rounded-xl border border-zinc-200 bg-white dark:border-zinc-800 dark:bg-zinc-900", children: [_jsxs(Link, { href: href, className: "group block p-3 hover:no-underline", children: [_jsx(Div, { className: "mb-2 aspect-square overflow-hidden rounded-lg bg-zinc-100 dark:bg-zinc-800", children: cover ? (
+                        // eslint-disable-next-line @next/next/no-img-element, lir/no-raw-media-elements
+                        _jsx("img", { src: cover, alt: bundle.name, className: "h-full w-full object-cover transition-transform group-hover:scale-105", loading: "lazy" })) : (_jsx(Div, { className: "flex h-full w-full items-center justify-center text-3xl", children: PLACEHOLDER_EMOJI })) }), _jsx(Text, { className: "line-clamp-2 text-sm font-semibold", children: bundle.name }), _jsxs(Row, { gap: "sm", align: "center", className: "mt-1 flex-wrap", children: [_jsx(Text, { size: "sm", weight: "bold", children: bundle.bundlePriceInPaise
+                                    ? formatCurrency(bundle.bundlePriceInPaise / 100, "INR")
+                                    : BUNDLE_COPY.featured.priceFallback }), _jsxs(Text, { size: "xs", color: "muted", children: ["\u00B7 ", BUNDLE_COPY.featured.itemCount(memberCount)] }), stock !== "in_stock" && (_jsx(Badge, { variant: BUNDLE_STOCK_VARIANT[stock], children: BUNDLE_COPY.stockBadge.listVariantOutOfStock }))] })] }), onBuyNow && (_jsx(Div, { className: "border-t border-zinc-100 p-3 pt-2 dark:border-zinc-800", children: _jsx(BundleBuyNowCta, { bundleSlug: bundle.slug, outOfStock: stock === "out_of_stock", onBuyNow: onBuyNow, compact: true }) }))] }));
 }

package/dist/features/orders/actions/refund-actions.js

@@ -11,7 +11,8 @@ import { orderRepository } from "../../orders/repository/orders.repository";
 import { RefundStatusValues } from "../../orders/schemas";
 import { siteSettingsRepository } from "../../admin/repository/site-settings.repository";
 import { notificationRepository } from "../../admin/repository/notification.repository";
-const DEFAULT_PROCESSING_FEE_PERCENT = 2.36;
+const DEFAULT_PLATFORM_FEE_PERCENT = 5;
+const DEFAULT_GST_PERCENT = 18;
 export async function issuePartialRefund(adminUid, orderId, deductFees, refundNote) {
     const order = await orderRepository.findById(orderId);
     if (!order)
@@ -21,11 +22,12 @@ export async function issuePartialRefund(adminUid, orderId, deductFees, refundNo
     if (order.refundStatus === RefundStatusValues.COMPLETED)
         throw new ValidationError("Order has already been fully refunded.");
     const settings = await siteSettingsRepository.getSingleton();
-    const feePercent = settings.commissions?.processingFeePercent ??
-        DEFAULT_PROCESSING_FEE_PERCENT;
+    const platformFeePercent = settings.commissions?.platformFeePercent ?? DEFAULT_PLATFORM_FEE_PERCENT;
+    const gstPercent = settings.commissions?.gstPercent ?? DEFAULT_GST_PERCENT;
+    const effectiveRate = platformFeePercent * (1 + gstPercent / 100);
     const grossRefund = order.totalPrice;
     const feeDeducted = deductFees
-        ? parseFloat(((grossRefund * feePercent) / 100).toFixed(2))
+        ? parseFloat(((grossRefund * effectiveRate) / 100).toFixed(2))
         : 0;
     const netRefund = parseFloat((grossRefund - feeDeducted).toFixed(2));
     await orderRepository.update(orderId, {
@@ -73,10 +75,11 @@ export async function previewCancellationRefund(userId, orderId) {
     if (order.paymentStatus !== "paid")
         return null;
     const settings = await siteSettingsRepository.getSingleton();
-    const feePercent = settings.commissions?.processingFeePercent ??
-        DEFAULT_PROCESSING_FEE_PERCENT;
+    const platformFeePercent = settings.commissions?.platformFeePercent ?? DEFAULT_PLATFORM_FEE_PERCENT;
+    const gstPercent = settings.commissions?.gstPercent ?? DEFAULT_GST_PERCENT;
+    const effectiveRate = platformFeePercent * (1 + gstPercent / 100);
     const grossRefund = order.totalPrice;
-    const feeDeducted = parseFloat(((grossRefund * feePercent) / 100).toFixed(2));
+    const feeDeducted = parseFloat(((grossRefund * effectiveRate) / 100).toFixed(2));
     const netRefund = parseFloat((grossRefund - feeDeducted).toFixed(2));
     return {
         orderId,

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

@@ -7,12 +7,12 @@ export type ShippingMethod = "custom" | "shiprocket";
 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. */
+/** 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. */
+/** Runtime-accessible order status values â€" use instead of bare string literals. */
 export declare const OrderStatusValues: {
     readonly PENDING: "pending";
     readonly CONFIRMED: "confirmed";
@@ -24,7 +24,7 @@ export declare const OrderStatusValues: {
     readonly RETURN_REQUESTED: "return_requested";
     readonly RETURNED: "returned";
 };
-/** Runtime-accessible payment status values — use instead of bare string literals. */
+/** Runtime-accessible payment status values â€" use instead of bare string literals. */
 export declare const PaymentStatusValues: {
     readonly PENDING: "pending";
     readonly PROCESSING: "processing";
@@ -33,34 +33,35 @@ export declare const PaymentStatusValues: {
     readonly REFUNDED: "refunded";
     readonly PARTIAL_REFUND: "partial_refund";
 };
-/** Runtime-accessible payment method values — use instead of bare string literals. */
+/** Runtime-accessible payment method values â€" use instead of bare string literals. */
 export declare const PaymentMethodValues: {
     readonly COD: "cod";
     readonly ONLINE: "online";
     readonly UPI_MANUAL: "upi_manual";
     readonly RAZORPAY: "razorpay";
+    readonly ADMIN_BYPASS: "admin_bypass";
 };
-/** Runtime-accessible refund status values — use instead of bare string literals. */
+/** Runtime-accessible refund status values â€" use instead of bare string literals. */
 export declare const RefundStatusValues: {
     readonly PENDING: "pending";
     readonly PROCESSING: "processing";
     readonly COMPLETED: "completed";
     readonly REJECTED: "rejected";
 };
-/** Firestore storage shape for an order line item — distinct from the API display model OrderItem */
+/** Firestore storage shape for an order line item â€" distinct from the API display model OrderItem */
 export interface OrderDocumentItem {
     productId: string;
     productTitle: string;
     quantity: number;
     unitPrice: number;
     totalPrice: number;
-    /** SB8-F — set when the item is a prize-draw entry; drives the reveals badge. */
+    /** SB8-F â€" set when the item is a prize-draw entry; drives the reveals badge. */
     listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
-    /** SB8-F — per-item reveal status; flips through pending → open → revealed/closed. */
+    /** SB8-F â€" per-item reveal status; flips through pending â†' open â†' revealed/closed. */
     prizeRevealStatus?: "pending" | "open" | "closed" | "revealed";
-    /** SB8-F — ISO timestamp; deadline by which the buyer must claim the prize. */
+    /** SB8-F â€" ISO timestamp; deadline by which the buyer must claim the prize. */
     prizeRevealDeadline?: string;
-    /** SB8-F — set after the reveal API picks a winner. */
+    /** SB8-F â€" set after the reveal API picks a winner. */
     revealedItemNumber?: number;
 }
 /**
@@ -163,13 +164,13 @@ export interface OrderDocument {
     };
     /** Deadline for the buyer to claim the won prize (typically 7 days). */
     prizeRevealDeadline?: Date;
-    /** True once `prizeRevealDeadline` passes without a claim — auto-forfeit. */
+    /** True once `prizeRevealDeadline` passes without a claim â€" auto-forfeit. */
     prizeRevealExpired?: boolean;
     /** Source product id when the order came from a prize-draw entry. */
     prizeDrawProductId?: string;
     /** True for prize-draw entries and bundle purchases that bypass refund. */
     isNonRefundable?: boolean;
-    /** Set when the order came from a bundle — points back to `bundles/{id}`. */
+    /** Set when the order came from a bundle â€" points back to `bundles/{id}`. */
     bundleId?: string;
     /**
      * Internal reference linking sibling orders created from the same checkout
@@ -184,11 +185,13 @@ export interface OrderDocument {
     refunds?: OrderRefundEvent[];
     /**
      * False once ANY refund (full or partial) has been posted. Once false it
-     * stays false — no dispute, RMA request, or “Item Not Received” claim may
+     * stays false — no dispute, RMA request, or "Item Not Received" claim may
      * be filed. Both buyer and seller must acknowledge this in the refund UI
      * via `confirmIrrevocable: true` before the refund is posted.
      */
     contestable?: boolean;
+    /** UID of the admin who triggered an admin-bypass checkout. Set only when paymentMethod === "admin_bypass". */
+    adminBypassBy?: string;
     /** Signed-URL media slug for a shipping-proof document (label, AWB scan). */
     shippingProofUrl?: string;
     shippingProofMimeType?: string;