@mohasinac/appkit 4.70.0 → 4.71.2

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

@@ -7,6 +7,8 @@ export interface RouteMap {
     USER: Record<string, RoutePath>;
     /** Store management dashboard (requires seller role). Replaces the old SELLER section. */
     STORE: Record<string, RoutePath>;
+    /** The `employee.<domain>` catch-all portal — see DEFAULT_ROUTE_MAP.EMPLOYEE. */
+    EMPLOYEE: Record<string, RoutePath>;
     ADMIN: Record<string, RoutePath>;
     BLOG: Record<string, RoutePath>;
 }
@@ -18,11 +20,12 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly PROFILE: (userId: string) => string;
         readonly PRODUCTS: "/products";
         readonly PRODUCT_DETAIL: (slugOrId: string) => string;
-        readonly AUCTIONS: "/auctions";
-        readonly AUCTION_DETAIL: (id: string) => string;
+        readonly COLLECTOR_DROPS: "/collector-drops";
+        readonly COLLECTOR_DROP_DETAIL: (id: string) => string;
         readonly PRE_ORDERS: "/pre-orders";
         /** D56 — the public rate card + self-serve booking form. */
         readonly ADVERTISE: "/advertise";
+        readonly ASSISTANT: "/assistant";
         readonly PRE_ORDER_DETAIL: (id: string) => string;
         readonly BUNDLES: "/bundles";
         readonly BUNDLE_DETAIL: (slug: string) => string;
@@ -32,18 +35,18 @@ export declare const DEFAULT_ROUTE_MAP: {
          * detail page — see § "Bundles vs Product Groups vs Grouped Listings".
          */
         readonly GROUP_DETAIL: (slug: string) => string;
-        readonly PRIZE_DRAWS: "/prize-draws";
-        readonly PRIZE_DRAW_DETAIL: (slug: string) => string;
+        readonly CLEARANCE: "/clearance";
+        readonly CLEARANCE_DETAIL: (slug: string) => string;
         readonly SELLER_GUIDE_BUNDLES: "/seller-guide/bundles";
-        readonly SELLER_GUIDE_PRIZE_DRAWS: "/seller-guide/prize-draws";
+        readonly SELLER_GUIDE_CLEARANCE: "/seller-guide/clearance";
         readonly SELLERS: "/sellers";
         readonly SELLER_DETAIL: (id: string) => string;
         readonly STORES: "/stores";
         readonly STORE_DETAIL: (storeSlug: string) => string;
         readonly STORE_PRODUCTS: (storeSlug: string) => string;
-        readonly STORE_AUCTIONS: (storeSlug: string) => string;
+        readonly STORE_COLLECTOR_DROPS: (storeSlug: string) => string;
         readonly STORE_PRE_ORDERS: (storeSlug: string) => string;
-        readonly STORE_PRIZE_DRAWS: (storeSlug: string) => string;
+        readonly STORE_CLEARANCE: (storeSlug: string) => string;
         readonly STORE_BUNDLES: (storeSlug: string) => string;
         readonly STORE_REVIEWS: (storeSlug: string) => string;
         readonly STORE_ABOUT: (storeSlug: string) => string;
@@ -68,7 +71,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly CONTACT: "/contact";
         readonly HELP: "/help";
         readonly HELP_SHOPPING: "/help/shopping";
-        readonly HELP_AUCTIONS: "/help/auctions";
+        readonly HELP_COLLECTOR_DROPS: "/help/collector-drops";
         readonly HELP_ORDERS: "/help/orders";
         readonly HELP_ACCOUNT: "/help/account";
         readonly HELP_SELLER_BADGES: "/help/seller-badges";
@@ -96,7 +99,7 @@ export declare const DEFAULT_ROUTE_MAP: {
          * designation, contact and a response commitment.
          */
         readonly GRIEVANCE: "/grievance";
-        readonly HOW_AUCTIONS_WORK: "/how-auctions-work";
+        readonly HOW_COLLECTOR_DROPS_WORK: "/how-collector-drops-work";
         readonly HOW_PRE_ORDERS_WORK: "/how-pre-orders-work";
         readonly HOW_OFFERS_WORK: "/how-offers-work";
         readonly HOW_CHECKOUT_WORKS: "/how-checkout-works";
@@ -115,8 +118,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly EVENT_LEADERBOARD: (id: string) => string;
         readonly EVENT_WINNER: (id: string) => string;
         readonly EVENT_SPIN_RESULTS: (id: string) => string;
-        readonly LOTTERIES: "/lottery";
-        readonly LOTTERY_DETAIL: (id: string) => string;
+        readonly LOTTERIES: "/giveaway";
+        readonly GIVEAWAY_DETAIL: (id: string) => string;
         readonly SUBLISTING_CATEGORY: (slug: string) => string;
         readonly SUPPORT: "/support";
         readonly SCAMS: "/scams";
@@ -225,7 +228,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         /** 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 CLEARANCE: "/user/clearance";
         readonly EVENTS: "/user/events";
         readonly CATALOGUE: "/user/catalogue";
         readonly CATALOGUE_NEW: "/user/catalogue/new";
@@ -243,9 +246,9 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly PRODUCTS_EDIT: (id: string) => string;
         readonly ORDERS: "/store/orders";
         readonly ORDER_DETAIL: (id: string) => string;
-        readonly AUCTIONS: "/store/auctions";
-        readonly AUCTIONS_NEW: "/store/auctions/new";
-        readonly AUCTIONS_EDIT: (id: string) => string;
+        readonly COLLECTOR_DROPS: "/store/collector-drops";
+        readonly COLLECTOR_DROPS_NEW: "/store/collector-drops/new";
+        readonly COLLECTOR_DROPS_EDIT: (id: string) => string;
         readonly PRE_ORDERS: "/store/pre-orders";
         readonly PRE_ORDERS_NEW: "/store/pre-orders/new";
         readonly PRE_ORDERS_EDIT: (id: string) => string;
@@ -278,10 +281,10 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly BUNDLES: "/store/bundles";
         readonly BUNDLES_NEW: "/store/bundles/new";
         readonly BUNDLES_EDIT: (id: string) => string;
-        readonly PRIZE_DRAWS: "/store/prize-draws";
-        readonly PRIZE_DRAWS_NEW: "/store/prize-draws/new";
-        readonly PRIZE_DRAWS_EDIT: (id: string) => string;
-        readonly PRIZE_DRAW_ENTRIES: (id: string) => string;
+        readonly CLEARANCE: "/store/clearance";
+        readonly CLEARANCE_NEW: "/store/clearance/new";
+        readonly CLEARANCE_EDIT: (id: string) => string;
+        readonly CLEARANCE_ENTRIES: (id: string) => string;
         readonly CLASSIFIED: "/store/classified";
         readonly CLASSIFIED_NEW: "/store/classified/new";
         readonly CLASSIFIED_EDIT: (id: string) => string;
@@ -327,6 +330,24 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly GUIDE_CAPABILITIES: "/store/guide/capabilities";
         readonly GUIDE_SETTINGS: "/store/guide/settings";
     };
+    /**
+     * The `employee.<domain>` portal — the catch-all entry point for every role
+     * that is not `admin`, `seller` or `user` (owner, 2026-11-07: "3 main and
+     * rest go to employee"). `moderator`, `tester`, and the future auditor /
+     * bookkeeping / management roles all arrive here.
+     *
+     * 🛑 Deliberately TINY, and it must stay that way. `employee.<domain>` is an
+     * ENTRY POINT, not a section with its own screens: what a visitor sees is
+     * resolved from their ROLE SET, and for a privileged role that resolution
+     * lands on the existing permission-scoped admin dashboard rather than a
+     * parallel copy of it. Growing a second tree of employee screens here is how
+     * the two-divergent-copies failure starts; a screen an employee needs belongs
+     * in `ADMIN` behind a permission, which is already how `admin/layout.tsx`
+     * admits non-admins.
+     */
+    readonly EMPLOYEE: {
+        readonly HOME: "/employee";
+    };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
         /**
@@ -357,13 +378,6 @@ export declare const DEFAULT_ROUTE_MAP: {
         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;
-        readonly CAROUSELS: "/admin/carousels";
-        readonly CAROUSEL_DETAIL: (id: string) => string;
-        readonly CAROUSELS_NEW: "/admin/carousels/new";
-        readonly CAROUSELS_EDIT: (id: string) => string;
         readonly SECTIONS: "/admin/sections";
         readonly NAVIGATION: "/admin/navigation";
         readonly ACTION_INDEX: "/admin/action-index";
@@ -468,12 +482,12 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly BUNDLES: "/admin/bundles";
         readonly BUNDLES_NEW: "/admin/bundles/new";
         readonly BUNDLES_EDIT: (id: string) => string;
-        readonly PRIZE_DRAWS: "/admin/prize-draws";
-        readonly PRIZE_DRAWS_EDIT: (id: string) => string;
-        readonly PRIZE_DRAWS_ENTRIES: (id: string) => string;
-        readonly LOTTERIES: "/admin/lotteries";
-        readonly LOTTERY_CONFIG: (id: string) => string;
-        readonly LOTTERY_ENTRIES: (id: string) => string;
+        readonly CLEARANCE: "/admin/clearance";
+        readonly CLEARANCE_EDIT: (id: string) => string;
+        readonly CLEARANCE_ENTRIES: (id: string) => string;
+        readonly LOTTERIES: "/admin/giveaways";
+        readonly GIVEAWAY_CONFIG: (id: string) => string;
+        readonly GIVEAWAY_ENTRIES: (id: string) => string;
         readonly TEAM: "/admin/team";
         readonly TEAM_NEW: "/admin/team/new";
         readonly TEAM_EDIT: (id: string) => string;
@@ -529,11 +543,12 @@ export declare const ROUTES: {
         readonly PROFILE: (userId: string) => string;
         readonly PRODUCTS: "/products";
         readonly PRODUCT_DETAIL: (slugOrId: string) => string;
-        readonly AUCTIONS: "/auctions";
-        readonly AUCTION_DETAIL: (id: string) => string;
+        readonly COLLECTOR_DROPS: "/collector-drops";
+        readonly COLLECTOR_DROP_DETAIL: (id: string) => string;
         readonly PRE_ORDERS: "/pre-orders";
         /** D56 — the public rate card + self-serve booking form. */
         readonly ADVERTISE: "/advertise";
+        readonly ASSISTANT: "/assistant";
         readonly PRE_ORDER_DETAIL: (id: string) => string;
         readonly BUNDLES: "/bundles";
         readonly BUNDLE_DETAIL: (slug: string) => string;
@@ -543,18 +558,18 @@ export declare const ROUTES: {
          * detail page — see § "Bundles vs Product Groups vs Grouped Listings".
          */
         readonly GROUP_DETAIL: (slug: string) => string;
-        readonly PRIZE_DRAWS: "/prize-draws";
-        readonly PRIZE_DRAW_DETAIL: (slug: string) => string;
+        readonly CLEARANCE: "/clearance";
+        readonly CLEARANCE_DETAIL: (slug: string) => string;
         readonly SELLER_GUIDE_BUNDLES: "/seller-guide/bundles";
-        readonly SELLER_GUIDE_PRIZE_DRAWS: "/seller-guide/prize-draws";
+        readonly SELLER_GUIDE_CLEARANCE: "/seller-guide/clearance";
         readonly SELLERS: "/sellers";
         readonly SELLER_DETAIL: (id: string) => string;
         readonly STORES: "/stores";
         readonly STORE_DETAIL: (storeSlug: string) => string;
         readonly STORE_PRODUCTS: (storeSlug: string) => string;
-        readonly STORE_AUCTIONS: (storeSlug: string) => string;
+        readonly STORE_COLLECTOR_DROPS: (storeSlug: string) => string;
         readonly STORE_PRE_ORDERS: (storeSlug: string) => string;
-        readonly STORE_PRIZE_DRAWS: (storeSlug: string) => string;
+        readonly STORE_CLEARANCE: (storeSlug: string) => string;
         readonly STORE_BUNDLES: (storeSlug: string) => string;
         readonly STORE_REVIEWS: (storeSlug: string) => string;
         readonly STORE_ABOUT: (storeSlug: string) => string;
@@ -579,7 +594,7 @@ export declare const ROUTES: {
         readonly CONTACT: "/contact";
         readonly HELP: "/help";
         readonly HELP_SHOPPING: "/help/shopping";
-        readonly HELP_AUCTIONS: "/help/auctions";
+        readonly HELP_COLLECTOR_DROPS: "/help/collector-drops";
         readonly HELP_ORDERS: "/help/orders";
         readonly HELP_ACCOUNT: "/help/account";
         readonly HELP_SELLER_BADGES: "/help/seller-badges";
@@ -607,7 +622,7 @@ export declare const ROUTES: {
          * designation, contact and a response commitment.
          */
         readonly GRIEVANCE: "/grievance";
-        readonly HOW_AUCTIONS_WORK: "/how-auctions-work";
+        readonly HOW_COLLECTOR_DROPS_WORK: "/how-collector-drops-work";
         readonly HOW_PRE_ORDERS_WORK: "/how-pre-orders-work";
         readonly HOW_OFFERS_WORK: "/how-offers-work";
         readonly HOW_CHECKOUT_WORKS: "/how-checkout-works";
@@ -626,8 +641,8 @@ export declare const ROUTES: {
         readonly EVENT_LEADERBOARD: (id: string) => string;
         readonly EVENT_WINNER: (id: string) => string;
         readonly EVENT_SPIN_RESULTS: (id: string) => string;
-        readonly LOTTERIES: "/lottery";
-        readonly LOTTERY_DETAIL: (id: string) => string;
+        readonly LOTTERIES: "/giveaway";
+        readonly GIVEAWAY_DETAIL: (id: string) => string;
         readonly SUBLISTING_CATEGORY: (slug: string) => string;
         readonly SUPPORT: "/support";
         readonly SCAMS: "/scams";
@@ -736,7 +751,7 @@ export declare const ROUTES: {
         /** 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 CLEARANCE: "/user/clearance";
         readonly EVENTS: "/user/events";
         readonly CATALOGUE: "/user/catalogue";
         readonly CATALOGUE_NEW: "/user/catalogue/new";
@@ -754,9 +769,9 @@ export declare const ROUTES: {
         readonly PRODUCTS_EDIT: (id: string) => string;
         readonly ORDERS: "/store/orders";
         readonly ORDER_DETAIL: (id: string) => string;
-        readonly AUCTIONS: "/store/auctions";
-        readonly AUCTIONS_NEW: "/store/auctions/new";
-        readonly AUCTIONS_EDIT: (id: string) => string;
+        readonly COLLECTOR_DROPS: "/store/collector-drops";
+        readonly COLLECTOR_DROPS_NEW: "/store/collector-drops/new";
+        readonly COLLECTOR_DROPS_EDIT: (id: string) => string;
         readonly PRE_ORDERS: "/store/pre-orders";
         readonly PRE_ORDERS_NEW: "/store/pre-orders/new";
         readonly PRE_ORDERS_EDIT: (id: string) => string;
@@ -789,10 +804,10 @@ export declare const ROUTES: {
         readonly BUNDLES: "/store/bundles";
         readonly BUNDLES_NEW: "/store/bundles/new";
         readonly BUNDLES_EDIT: (id: string) => string;
-        readonly PRIZE_DRAWS: "/store/prize-draws";
-        readonly PRIZE_DRAWS_NEW: "/store/prize-draws/new";
-        readonly PRIZE_DRAWS_EDIT: (id: string) => string;
-        readonly PRIZE_DRAW_ENTRIES: (id: string) => string;
+        readonly CLEARANCE: "/store/clearance";
+        readonly CLEARANCE_NEW: "/store/clearance/new";
+        readonly CLEARANCE_EDIT: (id: string) => string;
+        readonly CLEARANCE_ENTRIES: (id: string) => string;
         readonly CLASSIFIED: "/store/classified";
         readonly CLASSIFIED_NEW: "/store/classified/new";
         readonly CLASSIFIED_EDIT: (id: string) => string;
@@ -838,6 +853,24 @@ export declare const ROUTES: {
         readonly GUIDE_CAPABILITIES: "/store/guide/capabilities";
         readonly GUIDE_SETTINGS: "/store/guide/settings";
     };
+    /**
+     * The `employee.<domain>` portal — the catch-all entry point for every role
+     * that is not `admin`, `seller` or `user` (owner, 2026-11-07: "3 main and
+     * rest go to employee"). `moderator`, `tester`, and the future auditor /
+     * bookkeeping / management roles all arrive here.
+     *
+     * 🛑 Deliberately TINY, and it must stay that way. `employee.<domain>` is an
+     * ENTRY POINT, not a section with its own screens: what a visitor sees is
+     * resolved from their ROLE SET, and for a privileged role that resolution
+     * lands on the existing permission-scoped admin dashboard rather than a
+     * parallel copy of it. Growing a second tree of employee screens here is how
+     * the two-divergent-copies failure starts; a screen an employee needs belongs
+     * in `ADMIN` behind a permission, which is already how `admin/layout.tsx`
+     * admits non-admins.
+     */
+    readonly EMPLOYEE: {
+        readonly HOME: "/employee";
+    };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
         /**
@@ -868,13 +901,6 @@ export declare const ROUTES: {
         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;
-        readonly CAROUSELS: "/admin/carousels";
-        readonly CAROUSEL_DETAIL: (id: string) => string;
-        readonly CAROUSELS_NEW: "/admin/carousels/new";
-        readonly CAROUSELS_EDIT: (id: string) => string;
         readonly SECTIONS: "/admin/sections";
         readonly NAVIGATION: "/admin/navigation";
         readonly ACTION_INDEX: "/admin/action-index";
@@ -979,12 +1005,12 @@ export declare const ROUTES: {
         readonly BUNDLES: "/admin/bundles";
         readonly BUNDLES_NEW: "/admin/bundles/new";
         readonly BUNDLES_EDIT: (id: string) => string;
-        readonly PRIZE_DRAWS: "/admin/prize-draws";
-        readonly PRIZE_DRAWS_EDIT: (id: string) => string;
-        readonly PRIZE_DRAWS_ENTRIES: (id: string) => string;
-        readonly LOTTERIES: "/admin/lotteries";
-        readonly LOTTERY_CONFIG: (id: string) => string;
-        readonly LOTTERY_ENTRIES: (id: string) => string;
+        readonly CLEARANCE: "/admin/clearance";
+        readonly CLEARANCE_EDIT: (id: string) => string;
+        readonly CLEARANCE_ENTRIES: (id: string) => string;
+        readonly LOTTERIES: "/admin/giveaways";
+        readonly GIVEAWAY_CONFIG: (id: string) => string;
+        readonly GIVEAWAY_ENTRIES: (id: string) => string;
         readonly TEAM: "/admin/team";
         readonly TEAM_NEW: "/admin/team/new";
         readonly TEAM_EDIT: (id: string) => string;
@@ -1031,6 +1057,23 @@ export declare const ROUTES: {
         readonly ARTICLE: (slug: string) => string;
     };
 };
+/**
+ * The route map as it should RENDER on a given portal host.
+ *
+ * ```ts
+ * const R = routesForPortal(portalSectionForHost(host)); // "/admin" | null
+ * R.ADMIN.PRODUCTS; // "/products" on admin.<domain>, "/admin/products" on www
+ * R.USER.PROFILE;   // "/user/profile" on BOTH — it leaves the admin section,
+ *                   // so its prefix is load-bearing and is kept
+ * ```
+ *
+ * Only the ACTIVE section is stripped. That asymmetry is the correctness
+ * property: a cross-portal link must keep its prefix or it would resolve to the
+ * wrong portal's page (and, before the proxy fix that came with this, to a
+ * 404 — `/user/profile` on the admin host was being rewritten to
+ * `/admin/user/profile`).
+ */
+export declare function routesForPortal(section: string | null): RouteMap;
 /** @deprecated Use ROUTES.STORE instead */
 export declare const SELLER_ROUTES: {
     readonly DASHBOARD: "/store";
@@ -1041,9 +1084,9 @@ export declare const SELLER_ROUTES: {
     readonly PRODUCTS_EDIT: (id: string) => string;
     readonly ORDERS: "/store/orders";
     readonly ORDER_DETAIL: (id: string) => string;
-    readonly AUCTIONS: "/store/auctions";
-    readonly AUCTIONS_NEW: "/store/auctions/new";
-    readonly AUCTIONS_EDIT: (id: string) => string;
+    readonly COLLECTOR_DROPS: "/store/collector-drops";
+    readonly COLLECTOR_DROPS_NEW: "/store/collector-drops/new";
+    readonly COLLECTOR_DROPS_EDIT: (id: string) => string;
     readonly PRE_ORDERS: "/store/pre-orders";
     readonly PRE_ORDERS_NEW: "/store/pre-orders/new";
     readonly PRE_ORDERS_EDIT: (id: string) => string;
@@ -1076,10 +1119,10 @@ export declare const SELLER_ROUTES: {
     readonly BUNDLES: "/store/bundles";
     readonly BUNDLES_NEW: "/store/bundles/new";
     readonly BUNDLES_EDIT: (id: string) => string;
-    readonly PRIZE_DRAWS: "/store/prize-draws";
-    readonly PRIZE_DRAWS_NEW: "/store/prize-draws/new";
-    readonly PRIZE_DRAWS_EDIT: (id: string) => string;
-    readonly PRIZE_DRAW_ENTRIES: (id: string) => string;
+    readonly CLEARANCE: "/store/clearance";
+    readonly CLEARANCE_NEW: "/store/clearance/new";
+    readonly CLEARANCE_EDIT: (id: string) => string;
+    readonly CLEARANCE_ENTRIES: (id: string) => string;
     readonly CLASSIFIED: "/store/classified";
     readonly CLASSIFIED_NEW: "/store/classified/new";
     readonly CLASSIFIED_EDIT: (id: string) => string;