@mohasinac/appkit 4.11.3 → 4.12.0

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

@@ -1,4 +1,8 @@
 export declare const CHECKOUT_DEFAULT_COMMISSIONS: {
+    readonly platformFeePercent: 5;
+    readonly gstPercent: 18;
+    readonly minimumTransactionFee: 0;
+    readonly platformFeeMax: 10;
     readonly codDepositPercent: 10;
     readonly codHandlingFeeMin: 200;
     readonly codHandlingFeePercent: 10;

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

@@ -1,4 +1,12 @@
 export const CHECKOUT_DEFAULT_COMMISSIONS = {
+    // Platform-commission rates. Previously absent here because no checkout path
+    // computed a buyer-facing platform fee — the moment one did, a siteSettings
+    // document that failed to load would have produced NaN fees rather than a
+    // sane fallback. Mirrors the SiteSettingsDocument defaults.
+    platformFeePercent: 5,
+    gstPercent: 18,
+    minimumTransactionFee: 0,
+    platformFeeMax: 10,
     codDepositPercent: 10,
     codHandlingFeeMin: 200,
     codHandlingFeePercent: 10,

package/dist/_internal/shared/fees/calculator.d.ts

@@ -18,17 +18,49 @@ export interface FeeCommissionRates {
     platformFeePercent: number;
     gstPercent: number;
     /** Rupee floor (not paise) — matches the existing `minimumTransactionFee` doc convention. */ minimumTransactionFee?: number;
+    /**
+     * Rupee ceiling on the buyer-facing platform commission. Optional so
+     * siteSettings documents saved before this field existed keep working —
+     * falls back to DEFAULT_PLATFORM_FEE_MAX (₹10).
+     *
+     * Applies to `computeCheckoutFees` (what the BUYER pays) only. The seller-side
+     * `computePayoutDeduction` is deliberately uncapped — that is a separate
+     * commercial decision, not the same number.
+     */ platformFeeMax?: number;
     gatewayFeePercent?: number;
 }
 export interface CheckoutFees {
-    /** Platform commission in decimal rupees. */
+    /** Platform commission in decimal rupees, capped at `platformFeeMax`. */
     platformFee: number;
-    /** GST on the platform fee, in decimal rupees. */
+    /** GST on the (already capped) platform fee, in decimal rupees. */
     gstOnFee: number;
     /** platformFee + gstOnFee, floored at minimumTransactionFee. */
     totalFee: number;
 }
+/**
+ * What the buyer pays on top of the subtotal.
+ *
+ * The cap is applied to the commission BEFORE GST is computed, because GST is
+ * levied on the commission actually charged — capping afterwards would bill tax
+ * on money that was never collected.
+ */
 export declare function computeCheckoutFees(subtotal: number, commissions: FeeCommissionRates): CheckoutFees;
+/**
+ * Split one checkout's platform commission across the orders it produces.
+ *
+ * The buyer is charged a single capped commission for the transaction, but the
+ * cart splits into one order per store, and each `OrderDocument` records its own
+ * `platformFee` (invoices, reconciliation). Apportioning pro-rata by group
+ * subtotal keeps those per-order figures meaningful; giving the last group the
+ * rounding remainder guarantees they sum to exactly what was charged, so the
+ * orders can never quietly total a rupee more or less than the buyer paid.
+ *
+ * @param groupSubtotals `[storeId, subtotal]` pairs, in stable order.
+ */
+export declare function allocateCheckoutFees(groupSubtotals: readonly (readonly [string, number])[], fees: CheckoutFees): Map<string, {
+    platformFee: number;
+    gstOnFee: number;
+}>;
 export interface PayoutDeduction {
     /** Platform commission in decimal rupees. */
     platformFee: number;

package/dist/_internal/shared/fees/calculator.js

@@ -15,12 +15,56 @@
  * All money amounts are in decimal rupees.
  */
 import { roundRupees } from "../../../utils/number.formatter";
+/** Buyer-facing platform commission ceiling, in decimal rupees. */
+const DEFAULT_PLATFORM_FEE_MAX = 10;
+/**
+ * What the buyer pays on top of the subtotal.
+ *
+ * The cap is applied to the commission BEFORE GST is computed, because GST is
+ * levied on the commission actually charged — capping afterwards would bill tax
+ * on money that was never collected.
+ */
 export function computeCheckoutFees(subtotal, commissions) {
-    const platformFee = roundRupees(subtotal * (commissions.platformFeePercent / 100));
+    const uncapped = roundRupees(subtotal * (commissions.platformFeePercent / 100));
+    const cap = commissions.platformFeeMax ?? DEFAULT_PLATFORM_FEE_MAX;
+    const platformFee = Math.min(uncapped, cap);
     const gstOnFee = roundRupees(platformFee * (commissions.gstPercent / 100));
     const totalFee = Math.max(platformFee + gstOnFee, commissions.minimumTransactionFee ?? 0);
     return { platformFee, gstOnFee, totalFee };
 }
+/**
+ * Split one checkout's platform commission across the orders it produces.
+ *
+ * The buyer is charged a single capped commission for the transaction, but the
+ * cart splits into one order per store, and each `OrderDocument` records its own
+ * `platformFee` (invoices, reconciliation). Apportioning pro-rata by group
+ * subtotal keeps those per-order figures meaningful; giving the last group the
+ * rounding remainder guarantees they sum to exactly what was charged, so the
+ * orders can never quietly total a rupee more or less than the buyer paid.
+ *
+ * @param groupSubtotals `[storeId, subtotal]` pairs, in stable order.
+ */
+export function allocateCheckoutFees(groupSubtotals, fees) {
+    const allocation = new Map();
+    if (groupSubtotals.length === 0)
+        return allocation;
+    const total = groupSubtotals.reduce((sum, [, subtotal]) => sum + subtotal, 0);
+    let platformRemaining = fees.platformFee;
+    let gstRemaining = fees.gstOnFee;
+    groupSubtotals.forEach(([storeId, subtotal], index) => {
+        const isLast = index === groupSubtotals.length - 1;
+        // An all-zero cart can't be apportioned by share — fall back to giving the
+        // whole (necessarily zero-ish) fee to the last group rather than dividing
+        // by zero.
+        const share = total > 0 ? subtotal / total : 0;
+        const platformFee = isLast ? roundRupees(platformRemaining) : roundRupees(fees.platformFee * share);
+        const gstOnFee = isLast ? roundRupees(gstRemaining) : roundRupees(fees.gstOnFee * share);
+        platformRemaining = roundRupees(platformRemaining - platformFee);
+        gstRemaining = roundRupees(gstRemaining - gstOnFee);
+        allocation.set(storeId, { platformFee, gstOnFee });
+    });
+    return allocation;
+}
 export function computePayoutDeduction(grossAmount, commissions) {
     const platformFee = roundRupees(grossAmount * (commissions.platformFeePercent / 100));
     const gatewayFee = roundRupees(grossAmount * ((commissions.gatewayFeePercent ?? 0) / 100));

package/dist/client.d.ts

@@ -207,7 +207,9 @@ export { ProtectedRoute, AuthStatusPanel, ForgotPasswordView, LoginForm, Registe
 export type { AuthGuardUser, ForgotPasswordViewProps, LoginFormProps, LoginFormValues, RegisterFormProps, RegisterFormValues, ResetPasswordViewProps, VerifyEmailViewProps, } from "./features/auth/index";
 export { useLogout, useLogin, useGoogleLogin, useLinkGoogleAccount, useRegister, useForgotPassword, useResetPassword, useVerifyEmail, useChangeEmail } from "./features/auth/index";
 export type { LoginCredentials, RegisterData, ForgotPasswordData, ResetPasswordData, VerifyEmailData, ChangeEmailData } from "./features/auth/index";
-export { CartView, CartItemRow, CartSummary, CartDrawer, CheckoutView, CheckoutSuccessView, CheckoutAddressStep, useGuestCart, useCartCount, useAddToCart, useCart, useGuestCartMerge, useCartQuery } from "./features/cart/index";
+export { CartView, CartItemRow, CartSummary, CartPriceBreakdown, CartDrawer, CheckoutView, CheckoutSuccessView, CheckoutAddressStep, useGuestCart, useCartCount, useAddToCart, useCart, useGuestCartMerge, useCartQuery } from "./features/cart/index";
+export { StoreAddonsPicker } from "./features/cart/index";
+export type { CartPriceBreakdownData, CartPriceBreakdownStore, StoreAddonsValue, StoreAddonsRates } from "./features/cart/index";
 export { getCartOps, CART_OPS_CHANGE_EVENT } from "./features/cart/utils/pending-ops";
 export type { CartOp } from "./features/cart/utils/pending-ops";
 export type { CartItem, CartItemMeta, CartData, GuestCartItem } from "./features/cart/index";
@@ -300,6 +302,10 @@ export type { UserAccountHubViewProps, UserAccountHubViewLabels, UserOrdersViewP
 export { useOrders, useOrder, OrdersList } from "./features/orders/index";
 export { OrderStatusTimeline } from "./features/orders/components/OrderStatusTimeline";
 export type { OrderStatusTimelineProps } from "./features/orders/components/OrderStatusTimeline";
+export { CountdownDisplay } from "./ui/components/CountdownDisplay";
+export type { CountdownDisplayProps } from "./ui/components/CountdownDisplay";
+export { OrderAddonBadges } from "./features/orders/components/OrderAddonBadges";
+export type { OrderAddonBadgesOrder, OrderAddonBadgesProps } from "./features/orders/components/OrderAddonBadges";
 export { MANUAL_PAYMENT_METHODS, isManualPaymentMethod, PAYMENT_REVIEW_QUEUE_MODES, isPaymentReviewQueueMode, PAYMENT_WINDOW_MINUTES, } from "./features/orders/constants/payment-window";
 export type { PaymentReviewQueueMode } from "./features/orders/constants/payment-window";
 export { UserOrderTrackView } from "./features/account/components/UserOrderTrackView";

package/dist/client.js

@@ -238,7 +238,8 @@ export { PAGE_VIEW_ENTITY_TYPES } from "./features/analytics/types";
 export { AuctionBidsTable } from "./features/auctions/components/AuctionBidsTable";
 export { ProtectedRoute, AuthStatusPanel, ForgotPasswordView, LoginForm, RegisterForm, ResetPasswordView, VerifyEmailView } from "./features/auth/index";
 export { useLogout, useLogin, useGoogleLogin, useLinkGoogleAccount, useRegister, useForgotPassword, useResetPassword, useVerifyEmail, useChangeEmail } from "./features/auth/index";
-export { CartView, CartItemRow, CartSummary, CartDrawer, CheckoutView, CheckoutSuccessView, CheckoutAddressStep, useGuestCart, useCartCount, useAddToCart, useCart, useGuestCartMerge, useCartQuery } from "./features/cart/index";
+export { CartView, CartItemRow, CartSummary, CartPriceBreakdown, CartDrawer, CheckoutView, CheckoutSuccessView, CheckoutAddressStep, useGuestCart, useCartCount, useAddToCart, useCart, useGuestCartMerge, useCartQuery } from "./features/cart/index";
+export { StoreAddonsPicker } from "./features/cart/index";
 export { getCartOps, CART_OPS_CHANGE_EVENT } from "./features/cart/utils/pending-ops";
 export { useAddresses, useCreateAddress, useUpdateAddress, useDeleteAddress, useSetDefaultAddress, useAddress } from "./features/account/index";
 export { AddressBook, AddressCard, AddressForm } from "./features/account/index";
@@ -301,6 +302,8 @@ export { SellerPayoutSettingsView, SellerShippingView, SellerReviewsView, Seller
 export { UserAccountHubView, UserOrdersView, UserBidsView, OrderDetailView, UserNotificationsView, UserReturnsView, UserSupportView, useNotifications } from "./features/account/index";
 export { useOrders, useOrder, OrdersList } from "./features/orders/index";
 export { OrderStatusTimeline } from "./features/orders/components/OrderStatusTimeline";
+export { CountdownDisplay } from "./ui/components/CountdownDisplay";
+export { OrderAddonBadges } from "./features/orders/components/OrderAddonBadges";
 // Manual-payment (cash / UPI / EMI) shared constants — pure data + predicates,
 // no server deps. Used by the buyer proof-upload page and order-detail CTAs.
 export { MANUAL_PAYMENT_METHODS, isManualPaymentMethod, PAYMENT_REVIEW_QUEUE_MODES, isPaymentReviewQueueMode, PAYMENT_WINDOW_MINUTES, } from "./features/orders/constants/payment-window";

package/dist/constants/api-endpoints.d.ts

@@ -234,6 +234,8 @@ export declare const CART_ENDPOINTS: {
     readonly BY_ITEM_ID: (itemId: string) => string;
     readonly VALIDATE: "/api/cart/validate";
     readonly SELECTION: "/api/cart/selection";
+    /** Per-store paid add-on selections — the source of truth for what's charged. */
+    readonly ADDONS: "/api/cart/addons";
     readonly COUPON: "/api/cart/coupon";
 };
 export declare const CATEGORY_ENDPOINTS: {
@@ -686,6 +688,8 @@ export declare const API_ENDPOINTS: {
         readonly BY_ITEM_ID: (itemId: string) => string;
         readonly VALIDATE: "/api/cart/validate";
         readonly SELECTION: "/api/cart/selection";
+        /** Per-store paid add-on selections — the source of truth for what's charged. */
+        readonly ADDONS: "/api/cart/addons";
         readonly COUPON: "/api/cart/coupon";
     };
     readonly CATEGORIES: {
@@ -1140,6 +1144,8 @@ export declare const API_ROUTES: {
         readonly BY_ITEM_ID: (itemId: string) => string;
         readonly VALIDATE: "/api/cart/validate";
         readonly SELECTION: "/api/cart/selection";
+        /** Per-store paid add-on selections — the source of truth for what's charged. */
+        readonly ADDONS: "/api/cart/addons";
         readonly COUPON: "/api/cart/coupon";
     };
     readonly CATEGORIES: {

package/dist/constants/api-endpoints.js

@@ -274,6 +274,8 @@ export const CART_ENDPOINTS = {
     BY_ITEM_ID: (itemId) => `/api/cart/${encodeURIComponent(itemId)}`,
     VALIDATE: "/api/cart/validate",
     SELECTION: "/api/cart/selection",
+    /** Per-store paid add-on selections — the source of truth for what's charged. */
+    ADDONS: "/api/cart/addons",
     COUPON: "/api/cart/coupon",
 };
 // ---------------------------------------------------------------------------

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

@@ -1,7 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { sortBy } from "@mohasinac/appkit/client";
-import { useState } from "react";
+import { useUrlTable } from "../../../react/hooks/useUrlTable";
 import { useQueryClient } from "@tanstack/react-query";
 import { Badge, Div, FilterChipGroup, Span, Stack, Text, useToast } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -47,18 +47,22 @@ const ADDRESS_COLUMNS = [
         render: (row) => _jsx(Span, { size: "sm", color: "muted", children: row.updatedAt }),
     },
 ];
-function buildAddressConfig(banStatus, onAction) {
+function buildAddressConfig(onAction) {
     return {
         portal: "admin",
         title: "Address Management",
         searchPlaceholder: "Search by city or owner",
         emptyLabel: "No addresses found",
-        filterKeys: [],
+        // URL-synced via filterKeys (2026-08-21). The ban-status chips used to
+        // live outside this config in local useState, so the selection was not in
+        // the URL, not shareable, not counted by activeFilterCount, and lost on
+        // back-navigation. banStatus is a plain query param rather than a Sieve
+        // clause, which is exactly what buildExtraParams is for.
+        filterKeys: ["banStatus"],
         defaultSort: sortBy("bannedAt", "DESC"),
-        queryKey: ["admin", "addresses", banStatus],
-        endpoint: banStatus
-            ? `${ADMIN_ENDPOINTS.ADDRESSES}?banStatus=${encodeURIComponent(banStatus)}`
-            : ADMIN_ENDPOINTS.ADDRESSES,
+        queryKey: ["admin", "addresses"],
+        endpoint: ADMIN_ENDPOINTS.ADDRESSES,
+        buildExtraParams: (state) => state.banStatus ? { banStatus: state.banStatus } : undefined,
         sortOptions: [
             // -bannedAt (newest flagged first) to match defaultSort — the option was
             // "bannedAt" (oldest first), so the dropdown opened with nothing selected.
@@ -121,7 +125,11 @@ function buildAddressConfig(banStatus, onAction) {
     };
 }
 export function AdminAddressesView(_props) {
-    const [banStatus, setBanStatus] = useState("");
+    // Independent useUrlTable() against the same URL param DataListingView's own
+    // table reads via filterKeys — safe because useUrlTable holds no local state
+    // (the documented Root Cause #35 pattern).
+    const chipTable = useUrlTable({ defaults: {} });
+    const banStatus = chipTable.get("banStatus");
     const queryClient = useQueryClient();
     const { showToast } = useToast();
     const actionMutation = useApiMutation({
@@ -139,6 +147,6 @@ export function AdminAddressesView(_props) {
     const handleAction = (id, action) => {
         actionMutation.mutate({ id, action });
     };
-    const config = buildAddressConfig(banStatus, handleAction);
-    return (_jsxs(Stack, { gap: "md", children: [_jsx(Div, { padding: "inline", border: "default", className: "border-b", children: _jsx(FilterChipGroup, { label: "Status", tabs: BAN_STATUS_TABS, value: banStatus, onChange: (v) => setBanStatus(v) }) }), _jsx(DataListingView, { config: config })] }));
+    const config = buildAddressConfig(handleAction);
+    return (_jsxs(Stack, { gap: "md", children: [_jsx(Div, { padding: "inline", border: "default", className: "border-b", children: _jsx(FilterChipGroup, { label: "Status", tabs: BAN_STATUS_TABS, value: banStatus, onChange: (v) => chipTable.set("banStatus", v) }) }), _jsx(DataListingView, { config: config })] }));
 }

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

@@ -1,3 +1,12 @@
+/**
+ * AdminArtView — admin browse of art listings.
+ *
+ * A thin wrapper over the shared per-listing-type config. This file (and its
+ * four siblings) used to carry a full hand-written ListingViewConfig; all five
+ * were the same config with a different listingType, and all five shipped
+ * an empty filterKeys array — no filter drawer at all — plus their own copy
+ * of a three-option sort array. See listing-type-listing-config.ts.
+ */
 import React from "react";
 import type { ListingLayoutProps } from "../../../ui";
 export type AdminArtViewProps = ListingLayoutProps;

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

@@ -1,50 +1,26 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
- * AdminArtView — admin browse of art print listings (EMI/art-stickers session).
- * Mirrors AdminClassifiedView's thin config-driven pattern.
+ * AdminArtView — admin browse of art listings.
+ *
+ * A thin wrapper over the shared per-listing-type config. This file (and its
+ * four siblings) used to carry a full hand-written ListingViewConfig; all five
+ * were the same config with a different listingType, and all five shipped
+ * an empty filterKeys array — no filter drawer at all — plus their own copy
+ * of a three-option sort array. See listing-type-listing-config.ts.
  */
-import { sortBy } from "@mohasinac/appkit/client";
 import React from "react";
 import { ListingLayout } from "../../../ui";
-import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
-import { toRecordArray, toRelativeDate, toCurrency, toStringValue, } from "../hooks/useAdminListingData";
+import { buildListingTypeListingConfig } from "../../products/config/listing-type-listing-config";
 import { DataListingView } from "./DataListingView";
-import { ROUTES } from "../../../next/routing/route-map";
-const ADMIN_ART_CONFIG = {
-    portal: "admin",
+const CONFIG = buildListingTypeListingConfig("art", {
     title: "Art",
     searchPlaceholder: "Search art prints by name or seller",
     emptyLabel: "No art listings",
-    filterKeys: [],
-    defaultSort: sortBy("createdAt", "DESC"),
-    queryKey: ["admin", "art", "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, `art-${index}`),
-        primary: toStringValue(item.title ?? item.productTitle, "Untitled print"),
-        secondary: [
-            toStringValue(item.sellerName, "Unknown seller"),
-            toCurrency(item.price),
-        ].join(" · "),
-        status: toStringValue(item.status, "draft"),
-        updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
-        image: toStringValue(item.mainImage, "") || undefined,
-    })),
-    getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
-    buildFilters: () => "listingType==art",
-    // Art listings are products (filtered by listingType) — reuse the real
-    // admin product edit page rather than leaving rows non-navigable.
-    rowHrefTemplate: String(ROUTES.ADMIN.PRODUCTS_EDIT("{id}")),
-};
+});
 export function AdminArtView({ children, ...props }) {
     if (React.Children.count(children) > 0) {
         return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
     }
-    return _jsx(DataListingView, { config: ADMIN_ART_CONFIG });
+    return _jsx(DataListingView, { config: CONFIG });
 }

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

@@ -1,3 +1,12 @@
+/**
+ * AdminClassifiedView — admin browse of classified listings.
+ *
+ * A thin wrapper over the shared per-listing-type config. This file (and its
+ * four siblings) used to carry a full hand-written ListingViewConfig; all five
+ * were the same config with a different listingType, and all five shipped
+ * an empty filterKeys array — no filter drawer at all — plus their own copy
+ * of a three-option sort array. See listing-type-listing-config.ts.
+ */
 import React from "react";
 import type { ListingLayoutProps } from "../../../ui";
 export type AdminClassifiedViewProps = ListingLayoutProps;

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

@@ -1,50 +1,26 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
- * AdminClassifiedView — admin browse of classified listings (W1-29).
- * Read-only summary with edit-handoff to the seller-portal edit route.
+ * AdminClassifiedView — admin browse of classified listings.
+ *
+ * A thin wrapper over the shared per-listing-type config. This file (and its
+ * four siblings) used to carry a full hand-written ListingViewConfig; all five
+ * were the same config with a different listingType, and all five shipped
+ * an empty filterKeys array — no filter drawer at all — plus their own copy
+ * of a three-option sort array. See listing-type-listing-config.ts.
  */
-import { sortBy } from "@mohasinac/appkit/client";
 import React from "react";
 import { ListingLayout } from "../../../ui";
-import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
-import { toRecordArray, toRelativeDate, toCurrency, toStringValue, } from "../hooks/useAdminListingData";
+import { buildListingTypeListingConfig } from "../../products/config/listing-type-listing-config";
 import { DataListingView } from "./DataListingView";
-import { ROUTES } from "../../../next/routing/route-map";
-const ADMIN_CLASSIFIED_CONFIG = {
-    portal: "admin",
+const CONFIG = buildListingTypeListingConfig("classified", {
     title: "Classified",
     searchPlaceholder: "Search classified by name or seller",
     emptyLabel: "No classified listings",
-    filterKeys: [],
-    defaultSort: sortBy("createdAt", "DESC"),
-    queryKey: ["admin", "classified", "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, `classified-${index}`),
-        primary: toStringValue(item.title ?? item.productTitle, "Untitled classified"),
-        secondary: [
-            toStringValue(item.sellerName, "Unknown seller"),
-            toCurrency(item.price),
-        ].join(" · "),
-        status: toStringValue(item.status, "draft"),
-        updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
-        image: toStringValue(item.mainImage, "") || undefined,
-    })),
-    getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
-    buildFilters: () => "listingType==classified",
-    // Classified listings are products (filtered by listingType) — reuse the
-    // real admin product edit page rather than leaving rows non-navigable.
-    rowHrefTemplate: String(ROUTES.ADMIN.PRODUCTS_EDIT("{id}")),
-};
+});
 export function AdminClassifiedView({ children, ...props }) {
     if (React.Children.count(children) > 0) {
         return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
     }
-    return _jsx(DataListingView, { config: ADMIN_CLASSIFIED_CONFIG });
+    return _jsx(DataListingView, { config: CONFIG });
 }

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

@@ -1,3 +1,12 @@
+/**
+ * AdminDigitalCodesView — admin browse of digital codes listings.
+ *
+ * A thin wrapper over the shared per-listing-type config. This file (and its
+ * four siblings) used to carry a full hand-written ListingViewConfig; all five
+ * were the same config with a different listingType, and all five shipped
+ * an empty filterKeys array — no filter drawer at all — plus their own copy
+ * of a three-option sort array. See listing-type-listing-config.ts.
+ */
 import React from "react";
 import type { ListingLayoutProps } from "../../../ui";
 export type AdminDigitalCodesViewProps = ListingLayoutProps;

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

@@ -1,57 +1,26 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
- * AdminDigitalCodesView — admin browse of digital-code listings (W1-29).
+ * AdminDigitalCodesView — admin browse of digital codes listings.
+ *
+ * A thin wrapper over the shared per-listing-type config. This file (and its
+ * four siblings) used to carry a full hand-written ListingViewConfig; all five
+ * were the same config with a different listingType, and all five shipped
+ * an empty filterKeys array — no filter drawer at all — plus their own copy
+ * of a three-option sort array. See listing-type-listing-config.ts.
  */
-import { sortBy } from "@mohasinac/appkit/client";
 import React from "react";
 import { ListingLayout } from "../../../ui";
-import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
-import { toRecordArray, toRelativeDate, toCurrency, toStringValue, } from "../hooks/useAdminListingData";
+import { buildListingTypeListingConfig } from "../../products/config/listing-type-listing-config";
 import { DataListingView } from "./DataListingView";
-import { ROUTES } from "../../../next/routing/route-map";
-const ADMIN_DIGITAL_CODES_CONFIG = {
-    portal: "admin",
+const CONFIG = buildListingTypeListingConfig("digital-code", {
     title: "Digital Codes",
     searchPlaceholder: "Search digital code listings",
     emptyLabel: "No digital code listings",
-    filterKeys: [],
-    defaultSort: sortBy("createdAt", "DESC"),
-    queryKey: ["admin", "digital-codes", "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) => {
-        const dc = (item.digitalCode ?? {});
-        return {
-            id: toStringValue(item.id, `dc-${index}`),
-            primary: toStringValue(item.title ?? item.productTitle, "Untitled digital code"),
-            secondary: [
-                toStringValue(item.sellerName, "Unknown seller"),
-                toCurrency(item.price),
-                typeof dc.codesAvailable === "number"
-                    ? `${dc.codesAvailable} avail`
-                    : null,
-            ]
-                .filter(Boolean)
-                .join(" · "),
-            status: toStringValue(item.status, "draft"),
-            updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
-            image: toStringValue(item.mainImage, "") || undefined,
-        };
-    }),
-    getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
-    buildFilters: () => "listingType==digital-code",
-    // Digital-code listings are products (filtered by listingType) — reuse
-    // the real admin product edit page rather than leaving rows non-navigable.
-    rowHrefTemplate: String(ROUTES.ADMIN.PRODUCTS_EDIT("{id}")),
-};
+});
 export function AdminDigitalCodesView({ children, ...props }) {
     if (React.Children.count(children) > 0) {
         return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
     }
-    return _jsx(DataListingView, { config: ADMIN_DIGITAL_CODES_CONFIG });
+    return _jsx(DataListingView, { config: CONFIG });
 }

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

@@ -1,3 +1,12 @@
+/**
+ * AdminLiveView — admin browse of live items listings.
+ *
+ * A thin wrapper over the shared per-listing-type config. This file (and its
+ * four siblings) used to carry a full hand-written ListingViewConfig; all five
+ * were the same config with a different listingType, and all five shipped
+ * an empty filterKeys array — no filter drawer at all — plus their own copy
+ * of a three-option sort array. See listing-type-listing-config.ts.
+ */
 import React from "react";
 import type { ListingLayoutProps } from "../../../ui";
 export type AdminLiveViewProps = ListingLayoutProps;

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

@@ -1,56 +1,26 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
- * AdminLiveView — admin browse of live-item listings (W1-29).
+ * AdminLiveView — admin browse of live items listings.
+ *
+ * A thin wrapper over the shared per-listing-type config. This file (and its
+ * four siblings) used to carry a full hand-written ListingViewConfig; all five
+ * were the same config with a different listingType, and all five shipped
+ * an empty filterKeys array — no filter drawer at all — plus their own copy
+ * of a three-option sort array. See listing-type-listing-config.ts.
  */
-import { sortBy } from "@mohasinac/appkit/client";
 import React from "react";
 import { ListingLayout } from "../../../ui";
-import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
-import { toRecordArray, toRelativeDate, toCurrency, toStringValue, } from "../hooks/useAdminListingData";
+import { buildListingTypeListingConfig } from "../../products/config/listing-type-listing-config";
 import { DataListingView } from "./DataListingView";
-import { ROUTES } from "../../../next/routing/route-map";
-const ADMIN_LIVE_CONFIG = {
-    portal: "admin",
+const CONFIG = buildListingTypeListingConfig("live", {
     title: "Live Items",
     searchPlaceholder: "Search live items",
     emptyLabel: "No live item listings",
-    filterKeys: [],
-    defaultSort: sortBy("createdAt", "DESC"),
-    queryKey: ["admin", "live-items", "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) => {
-        const live = (item.liveItem ?? {});
-        return {
-            id: toStringValue(item.id, `live-${index}`),
-            primary: toStringValue(item.title ?? item.productTitle, "Untitled live item"),
-            secondary: [
-                toStringValue(item.sellerName, "Unknown seller"),
-                toCurrency(item.price),
-                toStringValue(live.species, ""),
-                Boolean(live.vendorVerified) ? "verified" : "pending",
-            ]
-                .filter(Boolean)
-                .join(" · "),
-            status: toStringValue(item.status, "draft"),
-            updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
-            image: toStringValue(item.mainImage, "") || undefined,
-        };
-    }),
-    getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
-    buildFilters: () => "listingType==live",
-    // Live-item listings are products (filtered by listingType) — reuse the
-    // real admin product edit page rather than leaving rows non-navigable.
-    rowHrefTemplate: String(ROUTES.ADMIN.PRODUCTS_EDIT("{id}")),
-};
+});
 export function AdminLiveView({ children, ...props }) {
     if (React.Children.count(children) > 0) {
         return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
     }
-    return _jsx(DataListingView, { config: ADMIN_LIVE_CONFIG });
+    return _jsx(DataListingView, { config: CONFIG });
 }

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

@@ -1,3 +1,4 @@
+import { type OrderAddonBadgesOrder } from "../../orders/components/OrderAddonBadges";
 import React from "react";
 export interface AdminOrderItemRow {
     productId: string;
@@ -23,5 +24,11 @@ export interface AdminOrderEditorViewProps {
     paymentUpiMismatch?: boolean;
     buyerMarkedPaid?: boolean;
     buyerFraudAgreementAccepted?: boolean;
+    /**
+     * Paid add-ons + applied coupon for this order. Operational, not decorative:
+     * `whatsappNotifyAddon` is who a status change should message, and the
+     * coupon is what an admin needs when reconciling a discounted order.
+     */
+    addons?: OrderAddonBadgesOrder;
 }
-export declare function AdminOrderEditorView({ open, onClose, orderId, orderLabel, currentStatus, items, paymentProofUrl, paymentTransactionId, paymentMethod, paymentStatus, displayedUpiId, buyerReportedUpiId, paymentUpiMismatch, buyerMarkedPaid, buyerFraudAgreementAccepted, }: AdminOrderEditorViewProps): React.JSX.Element;
+export declare function AdminOrderEditorView({ open, onClose, orderId, orderLabel, currentStatus, items, paymentProofUrl, paymentTransactionId, paymentMethod, paymentStatus, displayedUpiId, buyerReportedUpiId, paymentUpiMismatch, buyerMarkedPaid, buyerFraudAgreementAccepted, addons, }: AdminOrderEditorViewProps): React.JSX.Element;