@mohasinac/appkit 4.62.1 → 4.63.0

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

@@ -157,7 +157,7 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    category: "general" | "order_issue" | "billing_payment" | "account" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
+    category: "general" | "account" | "order_issue" | "billing_payment" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
     priority: "normal" | "high" | "low" | "urgent";
     description: string;
     userId: string;
@@ -200,7 +200,7 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    category: "general" | "order_issue" | "billing_payment" | "account" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
+    category: "general" | "account" | "order_issue" | "billing_payment" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
     priority: "normal" | "high" | "low" | "urgent";
     description: string;
     userId: string;

package/dist/index.d.ts

@@ -550,6 +550,8 @@ export { scammerRepository } from "./repositories/index";
 export { supportRepository, SupportRepository } from "./repositories/index";
 export type { SupportTicketDocument, SupportTicketCreateInput, SupportTicketUpdateInput, TicketMessage, TicketCategory, TicketStatus, TicketPriority, } from "./repositories/index";
 export { ELIGIBLE_ORDER_STATUSES_FOR_TICKET, SUPPORT_TICKET_COLLECTION, ACTIVE_TICKET_STATUSES, SUPPORT_TICKET_FIELDS, TicketCategoryValues, TicketStatusValues, TicketPriorityValues, } from "./features/support/schemas/firestore";
+export { AdminIntegrationsView } from "./features/admin/components/AdminIntegrationsView";
+export type { AdminIntegrationsViewProps } from "./features/admin/components/AdminIntegrationsView";
 export { AdminTaxCodesView } from "./features/admin/components/AdminTaxCodesView";
 export type { AdminTaxCodesViewProps } from "./features/admin/components/AdminTaxCodesView";
 export { AdminTaxCodeEditorView } from "./features/admin/components/AdminTaxCodeEditorView";
@@ -2201,6 +2203,9 @@ export type { ProtectionKind, ProtectionAvailability, ProtectionTierInput, Prote
 export type { FeeCommissionRates, CheckoutFees, PayoutDeduction, CodHandlingFeeRates, GiftWrapFeeRates, ShipmentProtectionFeeRates, SaleProtectionFeeRates, GstBreakdown, } from "./_internal/shared/fees/calculator";
 export { checkEmiEligibility, computeEmiSchedule, computeBuyerEmiQuote } from "./_internal/shared/features/emi/schedule";
 export type { BuyerEmiQuote } from "./_internal/shared/features/emi/schedule";
+export { amountDueNow, groupEmiGate, groupEmiQuote, groupEmiSchedule, emiOrderFields } from "./_internal/shared/features/emi/group";
+export { emiTenderFor, resolveEmiChoice, emiTenderBlockReason, isTenderCompatibleWithEmi } from "./_internal/shared/features/emi/choice";
+export type { EmiChoice, EmiTender } from "./_internal/shared/features/emi/choice";
 export { toBuyerFacingFees, toBuyerEmiSettings, } from "./_internal/shared/features/site-settings/fees";
 export type { BuyerFacingFees, BuyerEmiSettings, } from "./_internal/shared/features/site-settings/fees";
 export { GSTIN_PATTERN, gstinCheckCharacter, isValidGstin, validateGstEnablement, canEnableGst, } from "./_internal/shared/features/site-settings/gst-registration";

package/dist/index.js

@@ -1090,6 +1090,15 @@ export { ELIGIBLE_ORDER_STATUSES_FOR_TICKET, SUPPORT_TICKET_COLLECTION, ACTIVE_T
 // SB-UNI-B â€" sublistingCategoriesRepository + SublistingCategoryDocument deleted.
 // Use categoriesRepository.findBySlugAndType(slug, "sublisting") and CategoryDocument with categoryType:"sublisting".
 // [DB]-Database layer â€" uses firebase-admin; server-only.
+/*
+ * AdminIntegrationsView (12b) — /admin/integrations.
+ *
+ * The caller `INTEGRATIONS` / `integrationPatch` / `allIntegrationsPatch` were
+ * missing: the model landed with every route guard resolving through it and
+ * nothing in the UI reading it, which made those three exports speculative
+ * infra. This is what reads them.
+ */
+export { AdminIntegrationsView } from "./features/admin/components/AdminIntegrationsView.js";
 // AdminTaxCodesView / AdminTaxCodeEditorView (B3) — /admin/tax-codes.
 export { AdminTaxCodesView } from "./features/admin/components/AdminTaxCodesView.js";
 export { AdminTaxCodeEditorView } from "./features/admin/components/AdminTaxCodeEditorView.js";
@@ -4097,6 +4106,16 @@ export { searchPriceIndex, PRICE_INDEX_SEARCH_LIMIT, PRICE_INDEX_MIN_QUERY_LENGT
 export { protectionAvailability, computeProtectionFees, adjudicateClaim, badgesFor, showsRiskNotice, showsSafetyBadge, returnDestination, rtoDestination, PROTECTION_KINDS, } from "./_internal/shared/features/shipping/protections.js";
 // EMI eligibility + schedule computation (pure, client-safe — used for checkout quotes).
 export { checkEmiEligibility, computeEmiSchedule, computeBuyerEmiQuote } from "./_internal/shared/features/emi/schedule.js";
+/*
+ * 0f — the per-group instalment helpers. Exported because the CAPTURE amount
+ * is computed in a consumer route (`/api/payment/create-order`), and that
+ * route is one of the four money paths that must agree about an EMI order.
+ * There is no `./_internal/*` subpath, deliberately, so the barrel is how a
+ * consumer reaches shared checkout maths — exactly as `lineTotalFor` and
+ * `resolveShippingCost` already are.
+ */
+export { amountDueNow, groupEmiGate, groupEmiQuote, groupEmiSchedule, emiOrderFields } from "./_internal/shared/features/emi/group.js";
+export { emiTenderFor, resolveEmiChoice, emiTenderBlockReason, isTenderCompatibleWithEmi } from "./_internal/shared/features/emi/choice.js";
 // Buyer-facing projections of siteSettings.commissions / .emi — the single
 // definition of "safe to send to a browser" for fee data. See fees.ts header.
 export { toBuyerFacingFees, toBuyerEmiSettings, } from "./_internal/shared/features/site-settings/fees.js";

package/dist/next/routing/route-map.d.ts

@@ -21,6 +21,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly AUCTIONS: "/auctions";
         readonly AUCTION_DETAIL: (id: string) => string;
         readonly PRE_ORDERS: "/pre-orders";
+        /** D56 — the public rate card + self-serve booking form. */
+        readonly ADVERTISE: "/advertise";
         readonly PRE_ORDER_DETAIL: (id: string) => string;
         readonly BUNDLES: "/bundles";
         readonly BUNDLE_DETAIL: (slug: string) => string;
@@ -157,6 +159,16 @@ export declare const DEFAULT_ROUTE_MAP: {
     };
     readonly USER: {
         readonly DASHBOARD: "/user";
+        /**
+         * A dashboard SECTION hub — the screens of one sidebar group, each with a
+         * sentence on what it is for.
+         *
+         * One parametric route serves every section of the portal; the slug is
+         * `hubSectionSlug(group.title)` and is DERIVED, so there is no list of
+         * section keys here to drift from the nav. `audit-dashboard-hub-coverage`
+         * cross-checks the two.
+         */
+        readonly SECTION: (slug: string) => string;
         readonly PROFILE: "/user/profile";
         readonly SETTINGS: "/user/settings";
         readonly ORDERS: "/user/orders";
@@ -177,6 +189,17 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly ORDER_CLAIM: (id: string) => string;
         readonly ORDER_INVOICE: (id: string) => string;
         readonly ORDER_PAYMENT: (id: string) => string;
+        /**
+         * Raise a dispute on one order.
+         *
+         * Deep-linkable on purpose: a notification `actionUrl` points here, and
+         * `/user/orders/view/{id}` carries a "Report a problem" button to the same
+         * place. One surface, two ways in — an email link that works only while
+         * the buyer still has the email is the shape Root Cause #57 records,
+         * where `ORDER_PAYMENT` had exactly ONE caller and a buyer who navigated
+         * away could not get back.
+         */
+        readonly ORDER_DISPUTE: (id: string) => string;
         readonly NOTIFICATIONS: "/user/notifications";
         /** Plan §10 — claimed-coupons wallet (Active / Expired / Used tabs). */
         readonly CLAIMED_COUPONS: "/user/coupons";
@@ -198,6 +221,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly SUPPORT_NEW: "/user/support/new";
         readonly SUPPORT_TICKET: (id: string) => string;
         readonly PRE_ORDERS: "/user/pre-orders";
+        /** D56 — the advertiser's own bookings and their moderation state. */
+        readonly AD_BOOKINGS: "/user/ad-bookings";
         readonly DIGITAL_CODES: "/user/digital-codes";
         readonly PRIZE_DRAWS: "/user/prize-draws";
         readonly EVENTS: "/user/events";
@@ -210,6 +235,8 @@ export declare const DEFAULT_ROUTE_MAP: {
     };
     readonly STORE: {
         readonly DASHBOARD: "/store";
+        /** A dashboard SECTION hub — see `USER.SECTION` for the derivation. */
+        readonly SECTION: (slug: string) => string;
         readonly PRODUCTS: "/store/products";
         readonly PRODUCTS_NEW: "/store/products/new";
         readonly PRODUCTS_EDIT: (id: string) => string;
@@ -300,6 +327,18 @@ export declare const DEFAULT_ROUTE_MAP: {
     };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
+        /**
+         * The sectioned landing at `/admin` — what used to `redirect()` to
+         * `DASHBOARD`.
+         *
+         * 🛑 `DASHBOARD` is `/admin/dashboard` and stays a separate page: it is the
+         * metrics screen, and the sidebar's "Dashboard" entry points at it. This
+         * key is the index that lists the twelve sections. Collapsing the two would
+         * either bury the metrics or make the index unreachable.
+         */
+        readonly HOME: "/admin";
+        /** A dashboard SECTION hub — see `USER.SECTION` for the derivation. */
+        readonly SECTION: (slug: string) => string;
         readonly SHIPMENTS: "/admin/shipments";
         readonly INVENTORY_BOXES: "/admin/inventory/boxes";
         readonly INVENTORY_BOX_DETAIL: (id: string) => string;
@@ -315,6 +354,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly USER_DETAIL: (id: string) => string;
         readonly USER_EDIT: (id: string) => string;
         readonly SITE: "/admin/site";
+        readonly INTEGRATIONS: "/admin/integrations";
         readonly CAROUSEL: "/admin/carousel";
         readonly CAROUSEL_NEW: "/admin/carousel/new";
         readonly CAROUSEL_EDIT: (id: string) => string;
@@ -374,6 +414,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly ANALYTICS: "/admin/analytics";
         readonly PAYOUTS: "/admin/payouts";
         readonly PAYOUT_DETAIL: (id: string) => string;
+        readonly PRICING: "/admin/pricing";
         readonly AUDIT_LOG: "/admin/audit-log";
         readonly MONEY_CASES: "/admin/money-cases";
         readonly MONEY_CASE_DETAIL: (id: string) => string;
@@ -399,6 +440,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly ADS: "/admin/ads";
         readonly ADS_NEW: "/admin/ads/new";
         readonly ADS_EDIT: (id: string) => string;
+        /** D56 — the self-serve creative moderation queue. */
+        readonly AD_BOOKINGS: "/admin/ads/bookings";
         readonly NEWSLETTER: "/admin/newsletter";
         readonly CONTACT: "/admin/contact";
         readonly SESSIONS: "/admin/sessions";
@@ -433,6 +476,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly TEAM_NEW: "/admin/team/new";
         readonly TEAM_EDIT: (id: string) => string;
         readonly SUPPORT_TICKETS: "/admin/support-tickets";
+        /** Staff curation of the reasons a buyer can pick when disputing. */
+        readonly DISPUTE_REASONS: "/admin/dispute-reasons";
         readonly SUPPORT_TICKET_BY_ID: (id: string) => string;
         readonly SCAMMERS: "/admin/scammers";
         readonly SCAMMER_BY_ID: (id: string) => string;
@@ -485,6 +530,8 @@ export declare const ROUTES: {
         readonly AUCTIONS: "/auctions";
         readonly AUCTION_DETAIL: (id: string) => string;
         readonly PRE_ORDERS: "/pre-orders";
+        /** D56 — the public rate card + self-serve booking form. */
+        readonly ADVERTISE: "/advertise";
         readonly PRE_ORDER_DETAIL: (id: string) => string;
         readonly BUNDLES: "/bundles";
         readonly BUNDLE_DETAIL: (slug: string) => string;
@@ -621,6 +668,16 @@ export declare const ROUTES: {
     };
     readonly USER: {
         readonly DASHBOARD: "/user";
+        /**
+         * A dashboard SECTION hub — the screens of one sidebar group, each with a
+         * sentence on what it is for.
+         *
+         * One parametric route serves every section of the portal; the slug is
+         * `hubSectionSlug(group.title)` and is DERIVED, so there is no list of
+         * section keys here to drift from the nav. `audit-dashboard-hub-coverage`
+         * cross-checks the two.
+         */
+        readonly SECTION: (slug: string) => string;
         readonly PROFILE: "/user/profile";
         readonly SETTINGS: "/user/settings";
         readonly ORDERS: "/user/orders";
@@ -641,6 +698,17 @@ export declare const ROUTES: {
         readonly ORDER_CLAIM: (id: string) => string;
         readonly ORDER_INVOICE: (id: string) => string;
         readonly ORDER_PAYMENT: (id: string) => string;
+        /**
+         * Raise a dispute on one order.
+         *
+         * Deep-linkable on purpose: a notification `actionUrl` points here, and
+         * `/user/orders/view/{id}` carries a "Report a problem" button to the same
+         * place. One surface, two ways in — an email link that works only while
+         * the buyer still has the email is the shape Root Cause #57 records,
+         * where `ORDER_PAYMENT` had exactly ONE caller and a buyer who navigated
+         * away could not get back.
+         */
+        readonly ORDER_DISPUTE: (id: string) => string;
         readonly NOTIFICATIONS: "/user/notifications";
         /** Plan §10 — claimed-coupons wallet (Active / Expired / Used tabs). */
         readonly CLAIMED_COUPONS: "/user/coupons";
@@ -662,6 +730,8 @@ export declare const ROUTES: {
         readonly SUPPORT_NEW: "/user/support/new";
         readonly SUPPORT_TICKET: (id: string) => string;
         readonly PRE_ORDERS: "/user/pre-orders";
+        /** D56 — the advertiser's own bookings and their moderation state. */
+        readonly AD_BOOKINGS: "/user/ad-bookings";
         readonly DIGITAL_CODES: "/user/digital-codes";
         readonly PRIZE_DRAWS: "/user/prize-draws";
         readonly EVENTS: "/user/events";
@@ -674,6 +744,8 @@ export declare const ROUTES: {
     };
     readonly STORE: {
         readonly DASHBOARD: "/store";
+        /** A dashboard SECTION hub — see `USER.SECTION` for the derivation. */
+        readonly SECTION: (slug: string) => string;
         readonly PRODUCTS: "/store/products";
         readonly PRODUCTS_NEW: "/store/products/new";
         readonly PRODUCTS_EDIT: (id: string) => string;
@@ -764,6 +836,18 @@ export declare const ROUTES: {
     };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
+        /**
+         * The sectioned landing at `/admin` — what used to `redirect()` to
+         * `DASHBOARD`.
+         *
+         * 🛑 `DASHBOARD` is `/admin/dashboard` and stays a separate page: it is the
+         * metrics screen, and the sidebar's "Dashboard" entry points at it. This
+         * key is the index that lists the twelve sections. Collapsing the two would
+         * either bury the metrics or make the index unreachable.
+         */
+        readonly HOME: "/admin";
+        /** A dashboard SECTION hub — see `USER.SECTION` for the derivation. */
+        readonly SECTION: (slug: string) => string;
         readonly SHIPMENTS: "/admin/shipments";
         readonly INVENTORY_BOXES: "/admin/inventory/boxes";
         readonly INVENTORY_BOX_DETAIL: (id: string) => string;
@@ -779,6 +863,7 @@ export declare const ROUTES: {
         readonly USER_DETAIL: (id: string) => string;
         readonly USER_EDIT: (id: string) => string;
         readonly SITE: "/admin/site";
+        readonly INTEGRATIONS: "/admin/integrations";
         readonly CAROUSEL: "/admin/carousel";
         readonly CAROUSEL_NEW: "/admin/carousel/new";
         readonly CAROUSEL_EDIT: (id: string) => string;
@@ -838,6 +923,7 @@ export declare const ROUTES: {
         readonly ANALYTICS: "/admin/analytics";
         readonly PAYOUTS: "/admin/payouts";
         readonly PAYOUT_DETAIL: (id: string) => string;
+        readonly PRICING: "/admin/pricing";
         readonly AUDIT_LOG: "/admin/audit-log";
         readonly MONEY_CASES: "/admin/money-cases";
         readonly MONEY_CASE_DETAIL: (id: string) => string;
@@ -863,6 +949,8 @@ export declare const ROUTES: {
         readonly ADS: "/admin/ads";
         readonly ADS_NEW: "/admin/ads/new";
         readonly ADS_EDIT: (id: string) => string;
+        /** D56 — the self-serve creative moderation queue. */
+        readonly AD_BOOKINGS: "/admin/ads/bookings";
         readonly NEWSLETTER: "/admin/newsletter";
         readonly CONTACT: "/admin/contact";
         readonly SESSIONS: "/admin/sessions";
@@ -897,6 +985,8 @@ export declare const ROUTES: {
         readonly TEAM_NEW: "/admin/team/new";
         readonly TEAM_EDIT: (id: string) => string;
         readonly SUPPORT_TICKETS: "/admin/support-tickets";
+        /** Staff curation of the reasons a buyer can pick when disputing. */
+        readonly DISPUTE_REASONS: "/admin/dispute-reasons";
         readonly SUPPORT_TICKET_BY_ID: (id: string) => string;
         readonly SCAMMERS: "/admin/scammers";
         readonly SCAMMER_BY_ID: (id: string) => string;
@@ -940,6 +1030,8 @@ export declare const ROUTES: {
 /** @deprecated Use ROUTES.STORE instead */
 export declare const SELLER_ROUTES: {
     readonly DASHBOARD: "/store";
+    /** A dashboard SECTION hub — see `USER.SECTION` for the derivation. */
+    readonly SECTION: (slug: string) => string;
     readonly PRODUCTS: "/store/products";
     readonly PRODUCTS_NEW: "/store/products/new";
     readonly PRODUCTS_EDIT: (id: string) => string;

package/dist/next/routing/route-map.js

@@ -9,6 +9,8 @@ export const DEFAULT_ROUTE_MAP = {
         AUCTIONS: "/auctions",
         AUCTION_DETAIL: (id) => `/auctions/${id}`,
         PRE_ORDERS: "/pre-orders",
+        /** D56 — the public rate card + self-serve booking form. */
+        ADVERTISE: "/advertise",
         PRE_ORDER_DETAIL: (id) => `/pre-orders/${id}`,
         // SB1-J — bundles + prize draws (additive, pages not yet built)
         BUNDLES: "/bundles",
@@ -261,6 +263,16 @@ export const DEFAULT_ROUTE_MAP = {
     },
     USER: {
         DASHBOARD: "/user",
+        /**
+         * A dashboard SECTION hub — the screens of one sidebar group, each with a
+         * sentence on what it is for.
+         *
+         * One parametric route serves every section of the portal; the slug is
+         * `hubSectionSlug(group.title)` and is DERIVED, so there is no list of
+         * section keys here to drift from the nav. `audit-dashboard-hub-coverage`
+         * cross-checks the two.
+         */
+        SECTION: (slug) => `/user/sections/${slug}`,
         PROFILE: "/user/profile",
         SETTINGS: "/user/settings",
         ORDERS: "/user/orders",
@@ -297,6 +309,17 @@ export const DEFAULT_ROUTE_MAP = {
         ORDER_CLAIM: (id) => `/user/orders/${id}/claim`,
         ORDER_INVOICE: (id) => `/user/orders/${id}/invoice`,
         ORDER_PAYMENT: (id) => `/user/orders/${id}/payment`,
+        /**
+         * Raise a dispute on one order.
+         *
+         * Deep-linkable on purpose: a notification `actionUrl` points here, and
+         * `/user/orders/view/{id}` carries a "Report a problem" button to the same
+         * place. One surface, two ways in — an email link that works only while
+         * the buyer still has the email is the shape Root Cause #57 records,
+         * where `ORDER_PAYMENT` had exactly ONE caller and a buyer who navigated
+         * away could not get back.
+         */
+        ORDER_DISPUTE: (id) => `/user/orders/${id}/dispute`,
         NOTIFICATIONS: "/user/notifications",
         /** Plan §10 — claimed-coupons wallet (Active / Expired / Used tabs). */
         CLAIMED_COUPONS: "/user/coupons",
@@ -333,6 +356,8 @@ export const DEFAULT_ROUTE_MAP = {
         SUPPORT_NEW: "/user/support/new",
         SUPPORT_TICKET: (id) => `/user/support/${id}`,
         PRE_ORDERS: "/user/pre-orders",
+        /** D56 — the advertiser's own bookings and their moderation state. */
+        AD_BOOKINGS: "/user/ad-bookings",
         DIGITAL_CODES: "/user/digital-codes",
         PRIZE_DRAWS: "/user/prize-draws",
         EVENTS: "/user/events",
@@ -345,6 +370,8 @@ export const DEFAULT_ROUTE_MAP = {
     },
     STORE: {
         DASHBOARD: "/store",
+        /** A dashboard SECTION hub — see `USER.SECTION` for the derivation. */
+        SECTION: (slug) => `/store/sections/${slug}`,
         PRODUCTS: "/store/products",
         PRODUCTS_NEW: "/store/products/new",
         PRODUCTS_EDIT: (id) => `/store/products/${id}/edit`,
@@ -441,6 +468,18 @@ export const DEFAULT_ROUTE_MAP = {
     },
     ADMIN: {
         DASHBOARD: "/admin/dashboard",
+        /**
+         * The sectioned landing at `/admin` — what used to `redirect()` to
+         * `DASHBOARD`.
+         *
+         * 🛑 `DASHBOARD` is `/admin/dashboard` and stays a separate page: it is the
+         * metrics screen, and the sidebar's "Dashboard" entry points at it. This
+         * key is the index that lists the twelve sections. Collapsing the two would
+         * either bury the metrics or make the index unreachable.
+         */
+        HOME: "/admin",
+        /** A dashboard SECTION hub — see `USER.SECTION` for the derivation. */
+        SECTION: (slug) => `/admin/sections/${slug}`,
         SHIPMENTS: "/admin/shipments",
         /*
          * 🛑 There is deliberately NO `INVENTORY: "/admin/inventory"` key.
@@ -476,6 +515,15 @@ export const DEFAULT_ROUTE_MAP = {
         USER_DETAIL: (id) => `/admin/users/${id}`,
         USER_EDIT: (id) => `/admin/users/${id}/edit`,
         SITE: "/admin/site",
+        /*
+         * The integration kill switches — its OWN page, not a Site Settings tab.
+         *
+         * A switch that stops money has to be findable without hunting a tab
+         * strip, and this is the one surface where all four are visible together
+         * (which matters, because their off-states are not comparable: three stop
+         * something and one selects a working alternative).
+         */
+        INTEGRATIONS: "/admin/integrations",
         CAROUSEL: "/admin/carousel",
         CAROUSEL_NEW: "/admin/carousel/new",
         CAROUSEL_EDIT: (id) => `/admin/carousel/${id}/edit`,
@@ -563,6 +611,7 @@ export const DEFAULT_ROUTE_MAP = {
         ANALYTICS: "/admin/analytics",
         PAYOUTS: "/admin/payouts",
         PAYOUT_DETAIL: (id) => `/admin/payouts/${id}/view`,
+        PRICING: "/admin/pricing",
         AUDIT_LOG: "/admin/audit-log",
         /*
          * 🛑 MONEY_CASES is deliberately NOT under `/admin/maintenance/`.
@@ -601,6 +650,8 @@ export const DEFAULT_ROUTE_MAP = {
         ADS: "/admin/ads",
         ADS_NEW: "/admin/ads/new",
         ADS_EDIT: (id) => `/admin/ads/${id}/edit`,
+        /** D56 — the self-serve creative moderation queue. */
+        AD_BOOKINGS: "/admin/ads/bookings",
         NEWSLETTER: "/admin/newsletter",
         CONTACT: "/admin/contact",
         SESSIONS: "/admin/sessions",
@@ -644,6 +695,8 @@ export const DEFAULT_ROUTE_MAP = {
         TEAM_NEW: "/admin/team/new",
         TEAM_EDIT: (id) => `/admin/team/${id}/edit`,
         SUPPORT_TICKETS: "/admin/support-tickets",
+        /** Staff curation of the reasons a buyer can pick when disputing. */
+        DISPUTE_REASONS: "/admin/dispute-reasons",
         SUPPORT_TICKET_BY_ID: (id) => `/admin/support-tickets/${id}`,
         SCAMMERS: "/admin/scammers",
         SCAMMER_BY_ID: (id) => `/admin/scammers/${id}`,

package/dist/react/contexts/SessionContext.d.ts

@@ -40,7 +40,23 @@ export interface SessionUser {
     /** Orthogonal to isTester — unlocks admin-only checklist items and real /admin/** RBAC access. */
     canTestAdmin?: boolean;
     publicProfile?: FirestoreDocument;
-    stats?: FirestoreDocument;
+    /**
+     * Buyer activity counts, DERIVED by `/api/user/profile` — orders placed,
+     * auctions won, reviews written. Each is optional and `undefined` means the
+     * count could not be taken, which is NOT the same as zero: render nothing.
+     *
+     * 🛑 Not the `users/{uid}.stats` document field, which has no writer at all
+     * and holds seed literals. Do not "restore" it by reading the profile
+     * document here; see `getBuyerActivityStats`.
+     *
+     * Seller numbers are deliberately absent. This is the account holder's own
+     * record; what their store has sold belongs to the store.
+     */
+    stats?: {
+        totalOrders?: number;
+        auctionsWon?: number;
+        reviewsCount?: number;
+    };
     metadata?: FirestoreDocument;
     scamAwarenessAcknowledgedAt?: Date | null;
     /** RBAC permission keys granted to this user (from their role's permission set). */

package/dist/schemas/registry.d.ts

@@ -170,6 +170,7 @@ export declare const SCHEMAS: {
             category: import("zod").ZodString;
             tags: import("zod").ZodArray<import("zod").ZodString, "many">;
             isFeatured: import("zod").ZodBoolean;
+            isPinned: import("zod").ZodBoolean;
             status: import("zod").ZodEnum<["draft", "published", "archived"]>;
             publishedAt: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodDate, import("zod").ZodString, import("zod").ZodObject<{
                 toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
@@ -205,6 +206,7 @@ export declare const SCHEMAS: {
             authorId: string;
             authorName: string;
             readTimeMinutes: number;
+            isPinned: boolean;
             publishedAt?: string | Date | import("zod").objectOutputType<{
                 toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
             }, import("zod").ZodTypeAny, "passthrough"> | undefined;
@@ -258,6 +260,7 @@ export declare const SCHEMAS: {
             authorId: string;
             authorName: string;
             readTimeMinutes: number;
+            isPinned: boolean;
             publishedAt?: string | Date | import("zod").objectInputType<{
                 toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
             }, import("zod").ZodTypeAny, "passthrough"> | undefined;
@@ -816,16 +819,16 @@ export declare const SCHEMAS: {
                 opacity?: number | undefined;
                 subtitle?: string | undefined;
             } | undefined;
+            settings?: {
+                height?: "medium" | "viewport" | "tall" | undefined;
+                autoplayDelayMs?: number | undefined;
+            } | undefined;
             analytics?: {
                 views: number;
                 lastViewed?: string | Date | import("zod").objectOutputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough"> | undefined;
             } | undefined;
-            settings?: {
-                height?: "medium" | "viewport" | "tall" | undefined;
-                autoplayDelayMs?: number | undefined;
-            } | undefined;
             carouselId?: string | null | undefined;
         }, {
             id: string;
@@ -925,16 +928,16 @@ export declare const SCHEMAS: {
                 opacity?: number | undefined;
                 subtitle?: string | undefined;
             } | undefined;
+            settings?: {
+                height?: "medium" | "viewport" | "tall" | undefined;
+                autoplayDelayMs?: number | undefined;
+            } | undefined;
             analytics?: {
                 views: number;
                 lastViewed?: string | Date | import("zod").objectInputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough"> | undefined;
             } | undefined;
-            settings?: {
-                height?: "medium" | "viewport" | "tall" | undefined;
-                autoplayDelayMs?: number | undefined;
-            } | undefined;
             carouselId?: string | null | undefined;
         }>;
         readonly categories: import("zod").ZodObject<{
@@ -3061,6 +3064,7 @@ export declare const SCHEMAS: {
                 prizeRevealStatus?: "closed" | "open" | "pending" | "revealed" | undefined;
             }[] | undefined;
             bundleId?: string | undefined;
+            orderType?: string | undefined;
             prizeWon?: {
                 title: string;
                 images: string[];
@@ -3077,7 +3081,6 @@ export declare const SCHEMAS: {
                 bin: string;
             } | undefined;
             offerId?: string | undefined;
-            orderType?: string | undefined;
             isNonRefundable?: boolean | undefined;
             imageUrls?: string[] | undefined;
             refundFeeDeducted?: number | undefined;
@@ -3220,6 +3223,7 @@ export declare const SCHEMAS: {
                 prizeRevealStatus?: "closed" | "open" | "pending" | "revealed" | undefined;
             }[] | undefined;
             bundleId?: string | undefined;
+            orderType?: string | undefined;
             prizeWon?: {
                 title: string;
                 images: string[];
@@ -3236,7 +3240,6 @@ export declare const SCHEMAS: {
                 bin: string;
             } | undefined;
             offerId?: string | undefined;
-            orderType?: string | undefined;
             isNonRefundable?: boolean | undefined;
             imageUrls?: string[] | undefined;
             refundFeeDeducted?: number | undefined;
@@ -4151,13 +4154,13 @@ export declare const SCHEMAS: {
                 totalReviews: import("zod").ZodNumber;
                 averageRating: import("zod").ZodOptional<import("zod").ZodNumber>;
             }, "strip", import("zod").ZodTypeAny, {
-                itemsSold: number;
                 totalProducts: number;
+                itemsSold: number;
                 totalReviews: number;
                 averageRating?: number | undefined;
             }, {
-                itemsSold: number;
                 totalProducts: number;
+                itemsSold: number;
                 totalReviews: number;
                 averageRating?: number | undefined;
             }>>;
@@ -4296,8 +4299,8 @@ export declare const SCHEMAS: {
             location?: string | undefined;
             returnPolicy?: string | undefined;
             stats?: {
-                itemsSold: number;
                 totalProducts: number;
+                itemsSold: number;
                 totalReviews: number;
                 averageRating?: number | undefined;
             } | undefined;
@@ -4365,8 +4368,8 @@ export declare const SCHEMAS: {
             location?: string | undefined;
             returnPolicy?: string | undefined;
             stats?: {
-                itemsSold: number;
                 totalProducts: number;
+                itemsSold: number;
                 totalReviews: number;
                 averageRating?: number | undefined;
             } | undefined;
@@ -4521,7 +4524,7 @@ export declare const SCHEMAS: {
             updatedAt: string | Date | import("zod").objectOutputType<{
                 toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
             }, import("zod").ZodTypeAny, "passthrough">;
-            category: "general" | "order_issue" | "billing_payment" | "account" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
+            category: "general" | "account" | "order_issue" | "billing_payment" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
             priority: "normal" | "high" | "low" | "urgent";
             description: string;
             userId: string;
@@ -4564,7 +4567,7 @@ export declare const SCHEMAS: {
             updatedAt: string | Date | import("zod").objectInputType<{
                 toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
             }, import("zod").ZodTypeAny, "passthrough">;
-            category: "general" | "order_issue" | "billing_payment" | "account" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
+            category: "general" | "account" | "order_issue" | "billing_payment" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
             priority: "normal" | "high" | "low" | "urgent";
             description: string;
             userId: string;
@@ -4891,6 +4894,7 @@ export declare const SCHEMAS: {
             publishedAt: import("zod").ZodString;
             authorName: import("zod").ZodString;
             isFeatured: import("zod").ZodBoolean;
+            isPinned: import("zod").ZodBoolean;
         }, "strip", import("zod").ZodTypeAny, {
             status: "published" | "draft" | "archived";
             title: string;
@@ -4904,6 +4908,7 @@ export declare const SCHEMAS: {
             excerpt: string;
             coverImage: string;
             authorName: string;
+            isPinned: boolean;
             metaTitle: string;
             metaDescription: string;
         }, {
@@ -4919,6 +4924,7 @@ export declare const SCHEMAS: {
             excerpt: string;
             coverImage: string;
             authorName: string;
+            isPinned: boolean;
             metaTitle: string;
             metaDescription: string;
         }>;

package/dist/security/pii-schemas.d.ts

@@ -29,7 +29,7 @@ export declare const USER_PII_INDEX_MAP: Record<string, string>;
 /** PII fields in the addresses subcollection */
 export declare const ADDRESS_PII_FIELDS: readonly ["fullName", "phone", "addressLine1", "addressLine2"];
 /** PII fields in orders (denormalized buyer/seller data) */
-export declare const ORDER_PII_FIELDS: readonly ["userName", "userEmail", "sellerEmail"];
+export declare const ORDER_PII_FIELDS: readonly ["userName", "userEmail", "sellerEmail", "deliveryFullName", "deliveryPhone", "deliveryAddressLine1", "deliveryAddressLine2", "deliveryLandmark", "deliveryAmendments[].fullName", "deliveryAmendments[].phone", "deliveryAmendments[].addressLine1", "deliveryAmendments[].addressLine2", "deliveryAmendments[].landmark"];
 /** PII fields in payouts */
 export declare const PAYOUT_PII_FIELDS: readonly ["sellerEmail", "upiId"];
 /** Blind-index mapping for queryable payout PII */