@mohasinac/appkit 4.71.0 → 4.72.0

package/dist/features/account/components/UserAccountHubView.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import type { StackedViewShellProps } from "../../../ui/components/StackedViewShell";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface UserAccountHubViewLabels {
     title?: string;
     recentOrders?: string;
@@ -9,5 +10,7 @@ export interface UserAccountHubViewProps extends Omit<StackedViewShellProps, "se
     renderProfile?: () => React.ReactNode;
     renderNav?: () => React.ReactNode;
     renderRecentOrders?: () => React.ReactNode;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function UserAccountHubView({ labels, renderProfile, renderNav, renderRecentOrders, ...rest }: UserAccountHubViewProps): React.JSX.Element;
+export declare function UserAccountHubView({ labels, renderProfile, renderNav, renderRecentOrders, pageRegionCards, ...rest }: UserAccountHubViewProps): React.JSX.Element;

package/dist/features/account/components/UserAccountHubView.js

@@ -1,5 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { StackedViewShell } from "../../../ui/components/StackedViewShell.js";
-export function UserAccountHubView({ labels = {}, renderProfile, renderNav, renderRecentOrders, ...rest }) {
-    return (_jsx(StackedViewShell, { portal: "user", ...rest, title: labels.title, sections: [renderProfile?.(), renderNav?.(), renderRecentOrders?.()] }));
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
+export function UserAccountHubView({ labels = {}, renderProfile, renderNav, renderRecentOrders, pageRegionCards = [], ...rest }) {
+    return (_jsx(StackedViewShell, { portal: "user", ...rest, title: labels.title, sections: [
+            _jsx(AdminComposableRegion, { pageId: "user", initialCards: pageRegionCards }, "page-region"),
+            renderProfile?.(),
+            renderNav?.(),
+            renderRecentOrders?.(),
+        ] }));
 }

package/dist/features/account/components/UserBidsView.d.ts

@@ -1 +1,6 @@
-export declare function UserBidsView(): import("react").JSX.Element;
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+export interface UserBidsViewProps {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
+}
+export declare function UserBidsView({ pageRegionCards }?: UserBidsViewProps): import("react").JSX.Element;

package/dist/features/account/components/UserBidsView.js

@@ -9,11 +9,12 @@ import { Span } from "../../../ui/components/Typography.js";
 import { Stack } from "../../../ui/components/Layout.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
 import { RecordDetailModal } from "../../../ui/components/RecordDetailModal.js";
-import { buildBidDetailFields, bidStatusBadge } from "../../auctions/components/bid-detail-fields.js";
+import { buildBidDetailFields, bidStatusBadge } from "../../collector-drops/components/bid-detail-fields.js";
 import { FieldSelect } from "../../../ui/forms/index.js";
-import { AuctionBidsTable } from "../../auctions/components/AuctionBidsTable.js";
+import { CollectorDropBidsTable } from "../../collector-drops/components/CollectorDropBidsTable.js";
 import { DataListingView } from "../../admin/components/DataListingView.js";
 import { useListingTypeFlags } from "../../../react/hooks/useListingTypeFlags.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const SORT_OPTIONS = [
     { value: sortBy("bidDate", "DESC"), label: "Newest first" },
     { value: "bidDate", label: "Oldest first" },
@@ -27,18 +28,26 @@ const STATUS_OPTIONS = [
     { value: "won", label: "Won" },
     { value: "cancelled", label: "Cancelled" },
 ];
-export function UserBidsView() {
+export function UserBidsView({ pageRegionCards = [] } = {}) {
     // A bid could be seen in this list and never opened — no row click, no row
-    // action, no detail page. The "Browse auctions" link in the empty state is
+    // action, no detail page. The "Browse collector drops" link in the empty state is
     // not an affordance: it is not row-scoped, and it only shows when there are
     // no bids at all.
     const [detail, setDetail] = useState(null);
-    const auctionsEnabled = useListingTypeFlags().auction;
+    /*
+     * 🛑 `isListed`, not the indexed/`isEnabled` form. This gates a LINK a
+     * visitor clicks, and an `"unlisted"` type is one the owner asked to leave
+     * with "no way to jump to them" while its own pages keep serving. The
+     * indexed form answers "does the site still sell this", which stays true for
+     * unlisted — so reading it here put this link back on screen after the type
+     * was unlisted, which is exactly the dead end the comment below forbids.
+     */
+    const collectorDropsListed = useListingTypeFlags().isListed("collector-drop");
     const config = {
         portal: "user",
         title: "My Bids",
         search: {
-            placeholder: "Search by auction title…",
+            placeholder: "Search by collector drop title…",
             // `/api/user/bids` filters in memory: `(b.productTitle ?? "").includes(q)`.
             // The bid document carries no other text.
             fields: ["productTitle"],
@@ -58,9 +67,9 @@ export function UserBidsView() {
             if (isLoading) {
                 return (_jsx(Stack, { gap: "md", children: Array.from({ length: 3 }).map((_, i) => (_jsx(Div, { className: "h-16 animate-pulse border border-[var(--appkit-color-border)]", rounded: "xl" }, i))) }));
             }
-            return (_jsx(AuctionBidsTable, { bids: rows, portal: "buyer", onRowClick: (bid) => setDetail(bid), totalPages: 1, currentPage: 1, onPageChange: () => { }, emptyLabel: _jsxs(Span, { children: ["You haven't placed any bids yet.", auctionsEnabled && (_jsxs(_Fragment, { children: [" ", _jsx(TextLink, { href: String(ROUTES.PUBLIC.AUCTIONS), children: "Browse auctions" })] }))] }) }));
+            return (_jsx(CollectorDropBidsTable, { bids: rows, portal: "buyer", onRowClick: (bid) => setDetail(bid), totalPages: 1, currentPage: 1, onPageChange: () => { }, emptyLabel: _jsxs(Span, { children: ["You haven't placed any bids yet.", collectorDropsListed && (_jsxs(_Fragment, { children: [" ", _jsx(TextLink, { href: String(ROUTES.PUBLIC.COLLECTOR_DROPS), children: "Browse collector drops" })] }))] }) }));
         },
     };
     const badge = detail ? bidStatusBadge(detail.status) : null;
-    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(RecordDetailModal, { isOpen: detail !== null, onClose: () => setDetail(null), title: detail?.productTitle || "Bid", badges: badge ? [{ label: badge.label }] : undefined, fields: detail ? buildBidDetailFields(detail, "buyer") : undefined, footer: detail ? (_jsxs(_Fragment, { children: [_jsx(TextLink, { href: String(ROUTES.USER.BID_DETAIL(detail.id)), children: "Open full page \u2192" }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.AUCTION_DETAIL(detail.productId)), children: "View auction \u2192" })] })) : undefined })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(AdminComposableRegion, { pageId: "user-bids", initialCards: pageRegionCards }), _jsx(RecordDetailModal, { isOpen: detail !== null, onClose: () => setDetail(null), title: detail?.productTitle || "Bid", badges: badge ? [{ label: badge.label }] : undefined, fields: detail ? buildBidDetailFields(detail, "buyer") : undefined, footer: detail ? (_jsxs(_Fragment, { children: [_jsx(TextLink, { href: String(ROUTES.USER.BID_DETAIL(detail.id)), children: "Open full page \u2192" }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.COLLECTOR_DROP_DETAIL(detail.productId)), children: "View collector drop \u2192" })] })) : undefined })] }));
 }

package/dist/features/account/components/UserOrderTrackView.d.ts

@@ -1,5 +1,6 @@
 import type { ReactNode } from "react";
 import type { StackedViewShellProps } from "../../../ui/components/StackedViewShell";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface UserOrderTrackViewLabels {
     title?: string;
     backLabel?: string;
@@ -12,5 +13,7 @@ export interface UserOrderTrackViewProps extends Omit<StackedViewShellProps, "se
     renderTracking?: () => ReactNode;
     renderNotFound?: () => ReactNode;
     isNotFound?: boolean;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function UserOrderTrackView({ renderBack, renderTracking, renderNotFound, isNotFound, ...rest }: UserOrderTrackViewProps): import("react").JSX.Element;
+export declare function UserOrderTrackView({ renderBack, renderTracking, renderNotFound, isNotFound, pageRegionCards, ...rest }: UserOrderTrackViewProps): import("react").JSX.Element;

package/dist/features/account/components/UserOrderTrackView.js

@@ -1,8 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { StackedViewShell } from "../../../ui/components/StackedViewShell.js";
-export function UserOrderTrackView({ renderBack, renderTracking, renderNotFound, isNotFound = false, ...rest }) {
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
+export function UserOrderTrackView({ renderBack, renderTracking, renderNotFound, isNotFound = false, pageRegionCards = [], ...rest }) {
     return (_jsx(StackedViewShell, { portal: "user", ...rest, sections: [
             renderBack?.(),
             isNotFound ? renderNotFound?.() : renderTracking?.(),
+            _jsx(AdminComposableRegion, { pageId: "user-orders-id-track", initialCards: pageRegionCards }, "page-region"),
         ] }));
 }

package/dist/features/account/components/UserOrdersView.d.ts

@@ -1,5 +1,8 @@
 import type { Order } from "../../orders/types";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface UserOrdersViewProps {
     onOrderClick?: (order: Order) => void;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function UserOrdersView({ onOrderClick }: UserOrdersViewProps): import("react").JSX.Element;
+export declare function UserOrdersView({ onOrderClick, pageRegionCards }: UserOrdersViewProps): import("react").JSX.Element;

package/dist/features/account/components/UserOrdersView.js

@@ -16,6 +16,7 @@ import { OrderCard } from "../../orders/components/OrdersList.js";
 import { useOrderScope } from "../../orders/components/OrderScopeTabs.js";
 import { ORDER_LANE_TABS } from "../../orders/constants/order-lane-tabs.js";
 import { useSearchParams } from "next/navigation.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const CANCELLABLE_STATUSES = new Set(["pending", "confirmed", "processing"]);
 /*
  * 🛑 Every PRE-DELIVERY status, not just "shipped".
@@ -60,8 +61,8 @@ const SORT_OPTIONS = [
  *
  * 🛑 EMI is not a lane and not a status, which is why it could not join
  * either existing control: `orderType` records how the order was WON
- * (standard / auction / offer) and the scope records where it IS. How it is
- * being PAID is orthogonal to both — an auction win can be on an EMI plan.
+ * (standard / collector drop / offer) and the scope records where it IS. How it is
+ * being PAID is orthogonal to both — a collector drop win can be on an EMI plan.
  *
  * Every id is exactly a stored `OrderDocument.paymentMethod` value, and
  * `paymentMethod` is `canFilter: true` in the orders SIEVE_FIELDS — checked
@@ -100,7 +101,7 @@ const STATUS_OPTIONS = [
     { value: "refunded", label: "Refunded" },
     { value: "return_requested", label: "Return requested" },
 ];
-export function UserOrdersView({ onOrderClick }) {
+export function UserOrdersView({ onOrderClick, pageRegionCards = [] }) {
     const orderScope = useOrderScope();
     /*
      * 🛑 A FILTERED empty result is not an empty account, and saying so is a lie
@@ -170,7 +171,7 @@ export function UserOrdersView({ onOrderClick }) {
             .filter(Boolean)
             .join(",") || undefined,
         // The lifecycle scope sits alongside the lane tabs as a second,
-        // independent axis: a buyer can ask "which of my auction wins are still
+        // independent axis: a buyer can ask "which of my collector drop wins are still
         // in flight" without those two questions fighting over one control.
         buildExtraParams: () => orderScope.extraParams,
         renderAboveContent: orderScope.renderAboveContent,
@@ -190,5 +191,5 @@ export function UserOrdersView({ onOrderClick }) {
             return (_jsx(Grid, { gap: "md", className: "grid-cols-1", children: rows.map((order) => (_jsx(OrderCard, { order: order, onClick: onOrderClick, renderActions: () => (_jsxs(_Fragment, { children: [_jsx(Button, { asChild: true, variant: "outline", size: "sm", children: _jsx(TextLink, { href: String(ROUTES.USER.ORDER_DETAIL(order.id)), children: ACTIONS.USER["view-order"].label }) }), TRACKABLE_STATUSES.has(order.orderStatus) && (_jsx(Button, { asChild: true, variant: "ghost", size: "sm", children: _jsx(TextLink, { href: String(ROUTES.USER.ORDER_TRACK(order.id)), children: ACTIONS.USER["track-order"].label }) })), CANCELLABLE_STATUSES.has(order.orderStatus) && (_jsx(Button, { asChild: true, variant: "ghost", size: "sm", children: _jsx(TextLink, { href: String(ROUTES.USER.ORDER_CANCEL(order.id)), children: ACTIONS.USER["cancel-order"].label }) }))] })) }, order.id))) }));
         },
     };
-    return _jsx(DataListingView, { config: config });
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(AdminComposableRegion, { pageId: "user-orders", initialCards: pageRegionCards })] }));
 }

package/dist/features/account/components/UserReturnsView.d.ts

@@ -1,8 +1,11 @@
 import type { Order } from "../../orders/types";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface UserReturnsViewProps {
     /**
      * Optional override. When omitted the card still opens — see below.
      */
     onOrderClick?: (order: Order) => void;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function UserReturnsView({ onOrderClick }: UserReturnsViewProps): import("react").JSX.Element;
+export declare function UserReturnsView({ onOrderClick, pageRegionCards }: UserReturnsViewProps): import("react").JSX.Element;

package/dist/features/account/components/UserReturnsView.js

@@ -1,5 +1,5 @@
 "use client";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { sortBy } from "../../../constants/sort.js";
 import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { Div } from "../../../ui/components/Div.js";
@@ -9,12 +9,13 @@ import { useRouter } from "next/navigation.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
 import { DataListingView } from "../../admin/components/DataListingView.js";
 import { OrderCard } from "../../orders/components/OrdersList.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const SORT_OPTIONS = [
     { value: sortBy("updatedAt", "DESC"), label: "Recently updated" },
     { value: sortBy("createdAt", "DESC"), label: "Newest" },
     { value: sortBy("createdAt", "ASC"), label: "Oldest" },
 ];
-export function UserReturnsView({ onOrderClick }) {
+export function UserReturnsView({ onOrderClick, pageRegionCards = [] }) {
     const router = useRouter();
     // Client-side navigation, not a full reload — the row is a link in behaviour
     // even though the card itself contains its own controls, so wrapping it in
@@ -58,5 +59,5 @@ export function UserReturnsView({ onOrderClick }) {
                     onClick: onOrderClick ?? openOrder }, order.id))) }));
         },
     };
-    return _jsx(DataListingView, { config: config });
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(AdminComposableRegion, { pageId: "user-returns", initialCards: pageRegionCards })] }));
 }

package/dist/features/account/components/UserSidebar.js

@@ -1,6 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useState, useCallback, useEffect } from "react";
+import { DASHBOARD_ACCENT_CLASSES } from "../../../_internal/shared/features/layout/config.js";
+import { useState, useCallback, useEffect, useRef } from "react";
 import { createPortal } from "react-dom";
 import Link from "next/link.js";
 import { usePathname } from "next/navigation.js";
@@ -18,6 +19,7 @@ import { useSidebarSearch } from "../../../_internal/client/features/layout/useS
 import { findActiveNavGroup, findActiveNavItem } from "../../../_internal/client/features/layout/navActive.js";
 import { getSidebarRailClasses, getSidebarOverlayClasses } from "../../../_internal/client/features/layout/sidebarPositionClasses.js";
 import { useHandMode } from "../../../_internal/client/hand-mode/index.js";
+import { useClickOutside } from "../../../react/hooks/useClickOutside.js";
 const __O = {
     hidden: "overflow-hidden",
     yAuto: "overflow-y-auto",
@@ -33,7 +35,7 @@ function NavLink({ item, isActive, onClick }) {
         onClick?.();
     };
     const linkClass = `flex items-center justify-end gap-[var(--appkit-space-2-5)] rounded-lg px-[var(--appkit-space-3)] py-[var(--appkit-space-2)] text-[0.8125rem] font-medium leading-tight transition-colors ${isActive
-        ? "bg-primary-50 dark:bg-primary-900/25 text-primary-700 dark:text-primary-300"
+        ? `${DASHBOARD_ACCENT_CLASSES.user.activeBg} ${DASHBOARD_ACCENT_CLASSES.user.activeText}`
         : "text-[var(--appkit-color-text-muted)] hover:bg-surface-hover hover:text-zinc-900 dark:hover:text-zinc-100"}`;
     return (_jsxs(_Fragment, { children: [_jsxs(Link, { href: item.href, onClick: handleClick, className: linkClass, children: [item.icon && _jsx(Span, { size: "base", className: "shrink-0 opacity-70", children: item.icon }), _jsx(Span, { className: "truncate", children: item.label })] }), showConfirm && item.confirm && (_jsx(ConfirmDeleteModal, { isOpen: true, title: item.confirm.title ?? "Confirm", message: item.confirm.message, confirmText: "Continue", variant: "warning", onConfirm: () => {
                     setShowConfirm(false);
@@ -94,6 +96,8 @@ export function UserSidebar({ items, groups, mobileOpen = false, onCloseMobile,
     const { hand } = useHandMode();
     const rail = getSidebarRailClasses(hand);
     const [mounted, setMounted] = useState(false);
+    const desktopPanelRef = useRef(null);
+    const handleToggle = onToggle ?? close;
     useEffect(() => { setMounted(true); }, []);
     useEffect(() => {
         if (variant !== "sidebar") {
@@ -101,10 +105,16 @@ export function UserSidebar({ items, groups, mobileOpen = false, onCloseMobile,
             return () => { document.body.style.overflow = ""; };
         }
     }, [mobileOpen, variant]);
+    // Outside-click dismissal only applies to the persistent desktop "sidebar"
+    // variant — the "overlay" variant already closes via its own backdrop's
+    // onClick. `enabled` keeps this inert (no listener attached) everywhere
+    // else, so calling the hook unconditionally here is free, not just safe.
+    useClickOutside(desktopPanelRef, handleToggle, {
+        enabled: variant === "sidebar" && desktopOpen,
+    });
     // ── Persistent sidebar variant (desktop left slide-over, mobile bottom-sheet) ──────
     if (variant === "sidebar") {
-        const handleToggle = onToggle ?? close;
-        return (_jsxs(_Fragment, { children: [_jsxs(Div, { className: `hidden lg:flex fixed ${rail.edgeClass} z-40 transition-transform duration-300 top-[var(--header-height,3.5rem)] h-[calc(100vh-var(--header-height,3.5rem))] w-[18rem] ${desktopOpen ? "translate-x-0" : rail.collapsedTranslateClass}`, children: [_jsxs(Stack, { border: "default", surface: "default", className: `flex-1 ${rail.borderClass} dark:border-[var(--appkit-color-border)] ${__O.hidden}`, shadow: "xl", children: [_jsx(Div, { border: "bottom-subtle", paddingY: "y-sm-tall", className: "shrink-0", padding: "x-md", children: _jsx(Span, { size: "xs", weight: "semibold", transform: "uppercase", color: "muted", children: "My Account" }) }), _jsx(Div, { className: `flex-1 ${__O.yAuto}`, children: _jsx(DrawerContent, { groups: groups, items: items, activeHref: pathname }) }), renderFooter && _jsx(Div, { border: "top", padding: "inline", children: renderFooter() })] }), _jsx(SidebarCollapseToggle, { expanded: desktopOpen, onToggle: handleToggle, edge: hand })] }), _jsx(Div, { className: "lg:hidden", children: _jsx(BottomSheet, { open: mobileOpen, onClose: close, title: "My Account", children: _jsx(DrawerContent, { groups: groups, items: items, activeHref: pathname, onItemClick: close }) }) })] }));
+        return (_jsxs(_Fragment, { children: [_jsxs(Div, { ref: desktopPanelRef, className: `hidden lg:flex fixed ${rail.edgeClass} z-40 transition-transform duration-300 top-[var(--header-height,3.5rem)] h-[calc(100vh-var(--header-height,3.5rem))] w-[18rem] ${desktopOpen ? "translate-x-0" : rail.collapsedTranslateClass}`, children: [_jsxs(Stack, { border: "default", surface: "default", className: `flex-1 ${rail.borderClass} dark:border-[var(--appkit-color-border)] ${__O.hidden}`, shadow: "xl", children: [_jsx(Div, { border: "bottom-subtle", paddingY: "y-sm-tall", className: "shrink-0", padding: "x-md", children: _jsx(Span, { size: "xs", weight: "semibold", transform: "uppercase", color: "muted", children: "My Account" }) }), _jsx(Div, { className: `flex-1 ${__O.yAuto}`, children: _jsx(DrawerContent, { groups: groups, items: items, activeHref: pathname, onItemClick: handleToggle }) }), renderFooter && _jsx(Div, { border: "top", padding: "inline", children: renderFooter() })] }), _jsx(SidebarCollapseToggle, { expanded: desktopOpen, onToggle: handleToggle, edge: hand })] }), _jsx(Div, { className: "lg:hidden", children: _jsx(BottomSheet, { open: mobileOpen, onClose: close, title: "My Account", children: _jsx(DrawerContent, { groups: groups, items: items, activeHref: pathname, onItemClick: close }) }) })] }));
     }
     // ── Overlay variant (default) — portal on desktop, bottom-sheet on mobile ─
     const content = (_jsx(DrawerContent, { groups: groups, items: items, activeHref: pathname, onItemClick: close }));

package/dist/features/account/hooks/useNotifications.d.ts

@@ -1,4 +1,4 @@
-import type { JsonValue } from "@mohasinac/appkit";
+import type { JsonValue } from "../../../schemas/types";
 export interface BaseNotificationItem {
     id: string;
     read?: boolean;

package/dist/features/account/hooks/useProfile.d.ts

@@ -1,4 +1,5 @@
 import type { JsonValue } from "../../../schemas/types";
+import type { RecentlyVisitedMap, SavedCardsMap } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface UserProfile {
     uid: string;
     email: string | null;
@@ -19,6 +20,12 @@ export interface UserProfile {
         sectionState?: Record<string, string[]>;
         dataViewMode?: "table" | "grid" | "list";
         handMode?: "left" | "right";
+        /** scope ("{portal}:hub") -> hidden hub-card keys. See useHiddenHubCards. */
+        hiddenHubCards?: Record<string, string[]>;
+        /** scope ("{portal}:hub") -> recently-visited/used cards. See useRecentlyVisited. */
+        recentlyVisited?: RecentlyVisitedMap;
+        /** scope ("{portal}:hub") -> user-curated, UNCAPPED dashboard cards (Phase 9-ii). */
+        savedCards?: SavedCardsMap;
     };
 }
 export interface UpdateCurrentProfileInput {
@@ -43,6 +50,12 @@ export interface UpdateCurrentProfileInput {
         sectionState?: Record<string, string[]>;
         dataViewMode?: "table" | "grid" | "list";
         handMode?: "left" | "right";
+        /** scope ("{portal}:hub") -> hidden hub-card keys. See useHiddenHubCards. */
+        hiddenHubCards?: Record<string, string[]>;
+        /** scope ("{portal}:hub") -> recently-visited/used cards. See useRecentlyVisited. */
+        recentlyVisited?: RecentlyVisitedMap;
+        /** scope ("{portal}:hub") -> user-curated, UNCAPPED dashboard cards (Phase 9-ii). */
+        savedCards?: SavedCardsMap;
     };
 }
 export declare function useCurrentProfile(options?: {

package/dist/features/account/hooks/usePublicProfile.d.ts

@@ -11,7 +11,17 @@ export interface PublicUserProfile {
         };
         zoom: number;
     } | null;
+    /** Legacy scalar — the highest-ranked role. Never gate on it alone. */
     role: string;
+    /**
+     * THE role authority, projected by `USER_PUBLIC_FIELDS`.
+     *
+     * Optional because a cached API response from before this projection
+     * carries only `role`; `rolesOf()` falls back to it.
+     */
+    roles?: string[];
+    /** Display label only. */
+    primaryRole?: string;
     email?: string | null;
     phoneNumber?: string | null;
     createdAt?: Date | string;
@@ -30,7 +40,7 @@ export interface PublicUserProfile {
     };
     stats?: {
         totalOrders?: number;
-        auctionsWon?: number;
+        collectorDropsWon?: number;
         itemsSold?: number;
         reviewsCount?: number;
         rating?: number;

package/dist/features/account/hooks/usePublicProfile.js

@@ -14,7 +14,12 @@ export function usePublicProfile(userId, options) {
     });
     const user = profileData?.user;
     const profileError = fetchError?.message ?? null;
-    const isSeller = hasRole((user?.role ?? "user"), "seller");
+    /*
+     * `hasRole` takes the whole profile now, so it reads the role SET and
+     * returns true for a seller who also holds another role. Previously it was
+     * handed the single scalar, which a seller+employee resolves away from.
+     */
+    const isSeller = hasRole(user ?? null, "seller");
     const { data: productsData, isLoading: productsLoading } = useQuery({
         queryKey: ["profile-products", userId],
         queryFn: async () => {

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

@@ -60,10 +60,10 @@ export declare const userProfileSchema: z.ZodObject<{
     updatedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
+    displayName?: string | undefined;
+    email?: string | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
-    email?: string | undefined;
-    displayName?: string | undefined;
     photoURL?: string | undefined;
     bio?: string | undefined;
     phone?: string | undefined;
@@ -76,10 +76,10 @@ export declare const userProfileSchema: z.ZodObject<{
     } | undefined;
 }, {
     id: string;
+    displayName?: string | undefined;
+    email?: string | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
-    email?: string | undefined;
-    displayName?: string | undefined;
     photoURL?: string | undefined;
     bio?: string | undefined;
     phone?: string | undefined;

package/dist/features/addresses/schemas/address-form.d.ts

@@ -176,9 +176,9 @@ export declare const adminAddressCreateSchema: z.ZodEffects<z.ZodObject<{
     ownerId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     country: string;
+    label: string;
     ownerId: string;
     ownerType: "user" | "store";
-    label: string;
     fullName: string;
     phone: string;
     addressLine1: string;
@@ -189,9 +189,9 @@ export declare const adminAddressCreateSchema: z.ZodEffects<z.ZodObject<{
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }, {
+    label: string;
     ownerId: string;
     ownerType: "user" | "store";
-    label: string;
     fullName: string;
     phone: string;
     addressLine1: string;
@@ -204,9 +204,9 @@ export declare const adminAddressCreateSchema: z.ZodEffects<z.ZodObject<{
     landmark?: string | undefined;
 }>, {
     country: string;
+    label: string;
     ownerId: string;
     ownerType: "user" | "store";
-    label: string;
     fullName: string;
     phone: string;
     addressLine1: string;
@@ -217,9 +217,9 @@ export declare const adminAddressCreateSchema: z.ZodEffects<z.ZodObject<{
     addressLine2?: string | undefined;
     landmark?: string | undefined;
 }, {
+    label: string;
     ownerId: string;
     ownerType: "user" | "store";
-    label: string;
     fullName: string;
     phone: string;
     addressLine1: string;
@@ -247,9 +247,9 @@ export declare const adminAddressUpdateSchema: z.ZodEffects<z.ZodObject<{
     ownerId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     country?: string | undefined;
+    label?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
-    label?: string | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;
@@ -261,9 +261,9 @@ export declare const adminAddressUpdateSchema: z.ZodEffects<z.ZodObject<{
     landmark?: string | undefined;
 }, {
     country?: string | undefined;
+    label?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
-    label?: string | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;
@@ -275,9 +275,9 @@ export declare const adminAddressUpdateSchema: z.ZodEffects<z.ZodObject<{
     landmark?: string | undefined;
 }>, {
     country?: string | undefined;
+    label?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
-    label?: string | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;
@@ -289,9 +289,9 @@ export declare const adminAddressUpdateSchema: z.ZodEffects<z.ZodObject<{
     landmark?: string | undefined;
 }, {
     country?: string | undefined;
+    label?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
-    label?: string | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;
@@ -335,9 +335,9 @@ export declare const adminAddressPatchSchema: z.ZodEffects<z.ZodObject<{
     banReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     country?: string | undefined;
+    label?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
-    label?: string | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;
@@ -351,9 +351,9 @@ export declare const adminAddressPatchSchema: z.ZodEffects<z.ZodObject<{
     banReason?: string | undefined;
 }, {
     country?: string | undefined;
+    label?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
-    label?: string | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;
@@ -367,9 +367,9 @@ export declare const adminAddressPatchSchema: z.ZodEffects<z.ZodObject<{
     banReason?: string | undefined;
 }>, {
     country?: string | undefined;
+    label?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
-    label?: string | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;
@@ -383,9 +383,9 @@ export declare const adminAddressPatchSchema: z.ZodEffects<z.ZodObject<{
     banReason?: string | undefined;
 }, {
     country?: string | undefined;
+    label?: string | undefined;
     ownerId?: string | undefined;
     ownerType?: "user" | "store" | undefined;
-    label?: string | undefined;
     fullName?: string | undefined;
     phone?: string | undefined;
     addressLine1?: string | undefined;

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

@@ -33,6 +33,7 @@ export declare const addressFirestoreSchema: z.ZodObject<{
     isDefault: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
     country: string;
+    label: string;
     id: string;
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
@@ -42,7 +43,6 @@ export declare const addressFirestoreSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     ownerId: string;
     ownerType: "user" | "store";
-    label: string;
     fullName: string;
     phone: string;
     addressLine1: string;
@@ -54,6 +54,7 @@ export declare const addressFirestoreSchema: z.ZodObject<{
     landmark?: string | undefined;
 }, {
     country: string;
+    label: string;
     id: string;
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
@@ -63,7 +64,6 @@ export declare const addressFirestoreSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     ownerId: string;
     ownerType: "user" | "store";
-    label: string;
     fullName: string;
     phone: string;
     addressLine1: string;

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

@@ -16,7 +16,7 @@ import { finalizeStagedMediaUrl, finalizeStagedMediaField, finalizeStagedMediaAr
 import { getProviders } from "../../../contracts/index.js";
 import { getAdminAuth } from "../../../providers/db-firebase/index.js";
 import { isAdminUser } from "../../auth/role-predicates.js";
-import { assertPrizeDrawNotLocked, assertPrizeDrawWonItemsImmutable, } from "../../../_internal/server/features/products/service.js";
+import { assertClearanceNotLocked, assertClearanceWonItemsImmutable, } from "../../../_internal/server/features/products/service.js";
 import { resolveStoreFields } from "../../../_internal/server/features/stores/denormalize.js";
 import { recordAdminAction } from "../../../_internal/server/features/audit-log/actions.js";
 import { AdminAuditActionValues } from "../../audit-log/schemas/firestore.js";
@@ -230,9 +230,9 @@ export async function adminUpdateProduct(adminId, id, input) {
         throw new NotFoundError("Product not found");
     }
     if (input.status && input.status !== "published" && existing.status === "published") {
-        assertPrizeDrawNotLocked(existing, "unpublished or archived");
+        assertClearanceNotLocked(existing, "unpublished or archived");
     }
-    assertPrizeDrawWonItemsImmutable(existing, input.prizeDrawItems);
+    assertClearanceWonItemsImmutable(existing, input.prizeDrawItems);
     const finalized = { ...input };
     if (typeof finalized.mainImage === "string" && finalized.mainImage) {
         finalized.mainImage = await finalizeStagedMediaUrl(finalized.mainImage);
@@ -297,7 +297,7 @@ export async function adminDeleteProduct(adminId, id) {
     if (!existing) {
         throw new NotFoundError("Product not found");
     }
-    assertPrizeDrawNotLocked(existing, "deleted");
+    assertClearanceNotLocked(existing, "deleted");
     await productRepository.delete(id);
     serverLogger.info("adminDeleteProduct", {
         adminId,

package/dist/features/admin/actions/admin-read-actions.d.ts

@@ -10,7 +10,7 @@ import type { UserDocument } from "../../auth/schemas/firestore";
 import type { ProductDocument } from "../../products/schemas/firestore";
 import type { BlogPostDocument } from "../../blog/schemas/firestore";
 import type { StoreDocument } from "../../stores/schemas/firestore";
-import type { BidDocument } from "../../auctions/schemas/firestore";
+import type { BidDocument } from "../../collector-drops/schemas/firestore";
 export declare function getAdminDashboardStats(): Promise<{
     users: {
         total: number;

package/dist/features/admin/actions/admin-read-actions.js

@@ -9,7 +9,7 @@ import { userRepository } from "../../auth/repository/user.repository.js";
 import { productRepository } from "../../products/repository/products.repository.js";
 import { blogRepository } from "../../blog/repository/blog.repository.js";
 import { storeRepository } from "../../stores/repository/store.repository.js";
-import { bidRepository } from "../../auctions/repository/bid.repository.js";
+import { bidRepository } from "../../collector-drops/repository/bid.repository.js";
 import { payoutRepository } from "../../payments/repository/payout.repository.js";
 import { newsletterRepository } from "../../../core/newsletter.repository.js";
 import { contactSubmissionsRepository } from "../../../core/contact-submissions.repository.js";

package/dist/features/admin/actions/notification-actions.js

@@ -171,10 +171,10 @@ export async function sendNotification(input) {
      * the siteSettings read and before the user-prefs read — is what makes the
      * expensive fan-outs free:
      *
-     *   `auctionSettlement` sends `bid_lost` to up to 50 losing bidders in
-     *   parallel per auction. Each of those calls would otherwise pay TWO
+     *   `collectorDropSettlement` sends `bid_lost` to up to 50 losing bidders in
+     *   parallel per collector drop. Each of those calls would otherwise pay TWO
      *   Firestore reads (settings + user doc) to arrive at "skipped". That is
-     *   100 reads per auction to send nothing, and every expired auction settles
+     *   100 reads per collector drop to send nothing, and every expired collector drop settles
      *   concurrently.
      *
      * Returning here costs zero reads, and it is also what lets the daily send
@@ -252,7 +252,7 @@ export async function sendNotification(input) {
         order_placed: "orderUpdates", order_confirmed: "orderUpdates",
         order_shipped: "orderUpdates", order_delivered: "orderUpdates",
         order_cancelled: "orderUpdates",
-        bid_placed: "bids", bid_outbid: "bids", bid_won: "bids", bid_lost: "bids", auction_ended: "bids",
+        bid_placed: "bids", bid_outbid: "bids", bid_won: "bids", bid_lost: "bids", collector_drop_ended: "bids",
         review_approved: "reviews", review_replied: "reviews",
         promotion: "promotions",
         system: "system", welcome: "system", account_action: "system",