@mohasinac/appkit 4.30.18 → 4.31.0

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

@@ -1,6 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { normalizeError } from "../../../errors/normalize";
+import { toUserMessage } from "../../../errors/error-display-map";
 import { useCallback, useRef, useState } from "react";
 import { Button, Div, Heading, Li, Row, Span, Spinner, Stack, Text, TextLink, Ul, useToast } from "../../../ui";
 import { useClickOutside, useMessage } from "../../../react";
@@ -52,7 +53,7 @@ export function NotificationBell({ limit = 10, viewAllHref, labels, icons, rende
         }
         catch (err) {
             void normalizeError(err);
-            showToast(err instanceof Error ? err.message : "Failed to mark notification as read", "error");
+            showToast("Failed to mark notification as read", "error");
         }
     }, [markRead, refetch, showToast]);
     const emitSuccess = onMarkAllReadSuccess ?? showSuccess;
@@ -63,12 +64,12 @@ export function NotificationBell({ limit = 10, viewAllHref, labels, icons, rende
             emitSuccess(labels.markAllRead);
         }
         catch (err) {
-            void normalizeError(err);
+            const e = normalizeError(err);
             if (onMarkAllReadError) {
                 onMarkAllReadError(labels.error);
             }
             else {
-                showToast(err instanceof Error ? err.message : labels.error, "error");
+                showToast(toUserMessage(e.code, undefined, { fallback: labels.error }), "error");
             }
         }
     }, [

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

@@ -79,7 +79,7 @@ export function NotificationPreferencesPanel({ fetchUrl = ACCOUNT_ENDPOINTS.NOTI
         }
         catch (err) {
             void normalizeError(err);
-            showToast(err instanceof Error ? err.message : "Failed to save preferences.", "error");
+            showToast("Failed to save preferences.", "error");
         }
         finally {
             setSaving(false);

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

@@ -55,7 +55,7 @@ function BuyerOfferCard({ offer, onAcceptCounter, onWithdraw, onCheckout, onUpda
                     onNeedsLogin();
                 }
                 else {
-                    setError(err instanceof Error ? err.message : "Something went wrong.");
+                    setError("Something went wrong.");
                 }
             }
         });

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

@@ -1,8 +1,7 @@
+import type { SidebarNavItem } from "../../../_internal/shared/features/layout/types";
 import React from "react";
-export interface UserNavItem {
-    href: string;
-    label: string;
-    icon?: React.ReactNode;
+/** A user sidebar entry, plus the one field only this portal has. */
+export interface UserNavItem extends SidebarNavItem {
     /** When set, intercepts navigation with a confirmation prompt. */
     confirm?: {
         title?: string;

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

@@ -1,14 +1,18 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Li, useApiMutation } from "@mohasinac/appkit/client";
-import { useState } from "react";
+import { useMemo, useState } from "react";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
-import { Button, Div, FormActions, Row, Select, SideDrawer, Span, Stack, Text, Ul, useToast } from "../../../ui";
-import { FieldInput } from "../../../ui/forms/FieldInput";
+import { Button, Div, Row, SideDrawer, Span, Stack, Text, Ul, useToast } from "../../../ui";
 import { FieldTextarea } from "../../../ui/forms/FieldTextarea";
+import { FormErrorSummary } from "../../../ui/forms/FormErrorSummary";
+import { FormShellContext, useFormShellState } from "../../../ui/forms/FormShell";
+import { applyZodIssues } from "../../../ui/forms/apply-zod-issues";
+import { buildSectionsFromSchema, visibleValues } from "../../shell/build-sections";
+import { SectionForm, useSectionFormNav } from "../../shell/SectionForm";
 import { apiClient } from "../../../http";
 import { supportTicketCreateSchema } from "../../support/schemas/ticket-create-form";
-import { ValidationError } from "../../../errors/validation-error";
+import { TicketCategoryValues } from "../../support/schemas/firestore";
 import { SUPPORT_ENDPOINTS } from "../../../constants/api-endpoints";
 const __P = {
     p3: "p-[var(--appkit-space-3)]",
@@ -18,23 +22,44 @@ const __O = {
     yAuto: "overflow-y-auto",
 };
 // --- Constants ---------------------------------------------------------------
-const CATEGORY_OPTIONS = [
-    { label: "Order Issue", value: "order_issue" },
-    { label: "Billing / Payment", value: "billing_payment" },
-    { label: "Account", value: "account" },
-    { label: "Listing Dispute", value: "listing_dispute" },
-    { label: "Refund Request", value: "refund_request" },
-    { label: "Auction Dispute", value: "auction_dispute" },
+/**
+ * Category labels.
+ *
+ * Keyed off `TicketCategoryValues` rather than written as a parallel array, so
+ * a twelfth category cannot be added to the schema and silently omitted here —
+ * Root Cause #61, which the schema itself already guards on its own side.
+ *
+ * There are ten, so the generator renders this as a `PaginatedSelect`: it was
+ * a native `<Select>` with no `name`, which is over the five-option threshold
+ * AND unreachable by `applyZodIssues`.
+ */
+const CATEGORY_LABELS = {
+    [TicketCategoryValues.ORDER_ISSUE]: "Order issue",
+    [TicketCategoryValues.BILLING_PAYMENT]: "Billing / payment",
+    [TicketCategoryValues.ACCOUNT]: "Account",
+    [TicketCategoryValues.LISTING_DISPUTE]: "Listing dispute",
+    /*
+     * The hand-written array this replaced had TEN entries and the schema has
+     * ELEVEN — `scam_report` was simply missing, so a user could never file one
+     * from this drawer even though the route accepts it.
+     */
+    [TicketCategoryValues.SCAM_REPORT]: "Report a scam",
+    [TicketCategoryValues.REFUND_REQUEST]: "Refund request",
+    [TicketCategoryValues.AUCTION_DISPUTE]: "Auction dispute",
     // ST-4 — sellers use this to request changes to admin-controlled
     // store fields (status, capabilities, verification badge).
-    { label: "Store Change Request (sellers)", value: "store_change_request" },
+    [TicketCategoryValues.STORE_CHANGE_REQUEST]: "Store change request (sellers)",
     // ST-3 — buyers/sellers request mutation of order line items
-    { label: "Order Modification Request", value: "order_modification_request" },
+    [TicketCategoryValues.ORDER_MODIFICATION_REQUEST]: "Order modification request",
     // ST-5 — appeal a soft or hard ban; bypasses the create_support_tickets
     // soft-ban guard server-side.
-    { label: "Appeal a ban (unban request)", value: "unban_request" },
-    { label: "General", value: "general" },
-];
+    [TicketCategoryValues.UNBAN_REQUEST]: "Appeal a ban (unban request)",
+    [TicketCategoryValues.GENERAL]: "General",
+};
+const CATEGORY_OPTIONS = Object.values(TicketCategoryValues).map((value) => ({
+    value,
+    label: CATEGORY_LABELS[value] ?? value.replace(/_/g, " "),
+}));
 const CLS_MSG_USER = "border bg-[var(--appkit-color-surface)]/40 border-[var(--appkit-color-border)]";
 const CLS_MSG_STAFF = "bg-info-surface border border-info dark:bg-info-surface dark:border-info";
 const STATUS_BADGE = {
@@ -49,17 +74,20 @@ const ROLE_LABEL = {
     support: "Support",
     admin: "Admin",
 };
+const EMPTY_TICKET = {
+    category: TicketCategoryValues.GENERAL,
+    subject: "",
+    description: "",
+    orderId: "",
+};
 export function UserSupportView(_props) {
     const queryClient = useQueryClient();
     const { showToast } = useToast();
     const [detailOpen, setDetailOpen] = useState(false);
     const [selectedTicket, setSelectedTicket] = useState(null);
     const [newTicketOpen, setNewTicketOpen] = useState(false);
-    // New ticket form state
-    const [newSubject, setNewSubject] = useState("");
-    const [newCategory, setNewCategory] = useState("general");
-    const [newDescription, setNewDescription] = useState("");
-    const [newOrderId, setNewOrderId] = useState("");
+    const [newTicket, setNewTicket] = useState(EMPTY_TICKET);
+    const patchTicket = (partial) => setNewTicket((prev) => Object.assign({}, prev, partial));
     // Reply state
     const [replyBody, setReplyBody] = useState("");
     const { data, isLoading, error } = useQuery({
@@ -70,44 +98,45 @@ export function UserSupportView(_props) {
     const invalidate = () => queryClient.invalidateQueries({ queryKey: ["user", "support-tickets"] });
     const createMutation = useApiMutation({
         errorMessage: "Failed to create ticket.",
-        mutationFn: async () => {
-            /*
-             * This drawer validated NOTHING. Its sibling page
-             * (`/user/support/new`) hand-rolled a `canSubmit` boolean that required
-             * an order id for an `order_issue` ticket — a real rule, since an order
-             * complaint with no order is unactionable — and the route did not
-             * enforce it either. So the same ticket was acceptable or not purely
-             * depending on which surface the user happened to open.
-             *
-             * One schema now, across both surfaces and the route.
-             */
-            const parsed = supportTicketCreateSchema.safeParse({
-                subject: newSubject.trim(),
-                category: newCategory,
-                description: newDescription.trim(),
-                orderId: newOrderId.trim() || undefined,
-            });
-            if (!parsed.success) {
-                /*
-                 * ValidationError, not a bare Error — it carries the issue LIST, so
-                 * the failure keeps which field caused it. A plain Error flattens the
-                 * whole thing to one string, which is what `audit-unvalidated-safeparse`
-                 * exists to stop. It caught this in my own code.
-                 */
-                throw new ValidationError(parsed.error.issues[0]?.message ?? "Check the ticket details.", parsed.error.issues);
-            }
-            await apiClient.post(SUPPORT_ENDPOINTS.TICKETS, parsed.data);
-        },
+        mutationFn: async (values) => apiClient.post(SUPPORT_ENDPOINTS.TICKETS, values),
         onSuccess: () => {
             showToast("Support ticket created.", "success");
             setNewTicketOpen(false);
-            setNewSubject("");
-            setNewCategory("general");
-            setNewDescription("");
-            setNewOrderId("");
+            setNewTicket(EMPTY_TICKET);
             invalidate();
         },
     });
+    /*
+     * This drawer validated NOTHING before the schema landed, and its sibling
+     * page (`/user/support/new`) hand-rolled a `canSubmit` that required an
+     * order id for an `order_issue` ticket — a real rule the route did not
+     * enforce either, so the same ticket was acceptable or not depending purely
+     * on which surface the user opened. One schema now covers both and the
+     * route; the parse below is what reports it, per field.
+     */
+    const sections = useMemo(() => buildSectionsFromSchema(supportTicketCreateSchema, {
+        options: { category: CATEGORY_OPTIONS },
+    }), []);
+    const nav = useSectionFormNav(sections, newTicket, { scope: "user:support-ticket" });
+    const { shellCtx, setFieldError, clearErrors } = useFormShellState(supportTicketCreateSchema, {
+        sections: nav.sectionMeta,
+        onGoToSection: nav.goToSection,
+        fieldToSectionIndex: nav.fieldToSectionIndex,
+    });
+    const submitTicket = () => {
+        clearErrors();
+        /*
+         * `visibleValues` is what keeps an order id typed before switching
+         * category out of a ticket that has nothing to do with an order — the
+         * `when` on that field hides the control and never clears it.
+         */
+        const parsed = supportTicketCreateSchema.safeParse(visibleValues(supportTicketCreateSchema, newTicket));
+        if (!parsed.success) {
+            applyZodIssues(parsed.error.issues, setFieldError);
+            return;
+        }
+        createMutation.mutate(parsed.data);
+    };
     const replyMutation = useApiMutation({
         errorMessage: "Failed to send reply.",
         mutationFn: async () => {
@@ -119,16 +148,18 @@ export function UserSupportView(_props) {
             invalidate();
         },
     });
-    return (_jsxs(_Fragment, { children: [_jsxs(Div, { className: "mx-auto max-w-2xl", paddingY: "y-lg", paddingX: "x-md", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", children: [_jsx(Text, { size: "xl", weight: "semibold", color: "primary", children: "Support Tickets" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", onClick: () => setNewTicketOpen(true), children: "New ticket" })] }), renderTicketListArea({ isLoading, error, tickets, setSelectedTicket, setDetailOpen })] }), renderNewTicketDrawer({ newTicketOpen, setNewTicketOpen, newCategory, setNewCategory, newSubject, setNewSubject, newOrderId, setNewOrderId, newDescription, setNewDescription, createMutation }), renderTicketDetailDrawer({ detailOpen, setDetailOpen, selectedTicket, replyBody, setReplyBody, replyMutation })] }));
+    return (_jsxs(_Fragment, { children: [_jsxs(Div, { className: "mx-auto max-w-2xl", paddingY: "y-lg", paddingX: "x-md", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", children: [_jsx(Text, { size: "xl", weight: "semibold", color: "primary", children: "Support Tickets" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", onClick: () => setNewTicketOpen(true), children: "New ticket" })] }), renderTicketListArea({ isLoading, error, tickets, setSelectedTicket, setDetailOpen })] }), _jsx(SideDrawer, { isOpen: newTicketOpen, onClose: () => setNewTicketOpen(false), title: "Open a support ticket", children: _jsx(Stack, { className: `${__P.p4}`, gap: "md", children: _jsxs(FormShellContext.Provider, { value: shellCtx, children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: newTicket, onChange: patchTicket, onSubmit: submitTicket, schema: supportTicketCreateSchema, openIds: nav.openIds, onOpenChange: nav.setOpenIds, isLoading: createMutation.isPending, submitLabel: "Submit ticket", onCancel: () => setNewTicketOpen(false), 
+                                /*
+                                 * A drawer owns its own footer — `useIsInsideOverlay` already
+                                 * suppresses the viewport-fixed bar, which would otherwise
+                                 * render BEHIND the backdrop. Stated rather than relied on.
+                                 */
+                                bottomBar: false })] }) }) }), renderTicketDetailDrawer({ detailOpen, setDetailOpen, selectedTicket, replyBody, setReplyBody, replyMutation })] }));
 }
 function renderTicketListArea(props) {
     const { isLoading, error, tickets, setSelectedTicket, setDetailOpen } = props;
     return (_jsxs(_Fragment, { children: [isLoading && (_jsx(Stack, { gap: "3", children: [1, 2, 3].map((i) => _jsx(Div, { className: "h-16 animate-pulse", surface: "subtle", rounded: "lg" }, i)) })), error && (_jsx(Div, { textSize: "sm", className: "border border-error/20", color: "error", surface: "danger-surface", padding: "inline", rounded: "xl", children: "Failed to load support tickets." })), !isLoading && tickets.length === 0 && (_jsx(Div, { className: "text-left", surface: "muted", paddingY: "y-2xl", paddingX: "x-lg", rounded: "xl", border: "default", children: _jsx(Text, { size: "sm", color: "muted", children: "You haven't opened any support tickets yet." }) })), _jsx(Ul, { spacing: "loose", children: tickets.map((ticket) => (_jsx(Li, { children: _jsx(Button, { rounded: "xl", variant: "ghost", type: "button", shadow: "sm", border: "default", paddingX: "md", paddingY: "md", className: "w-full bg-[var(--appkit-color-surface)] text-left hover:border-[var(--appkit-color-primary-300)] transition-colors", onClick: () => { setSelectedTicket(ticket); setDetailOpen(true); }, children: _jsxs(Row, { align: "start", justify: "between", gap: "sm", children: [_jsxs(Div, { className: "min-w-0 flex-1", children: [_jsx(Text, { className: "truncate", color: "primary", weight: "medium", children: ticket.subject }), _jsxs(Text, { size: "xs", color: "muted", children: [ticket.category.replace(/_/g, " "), ticket.orderId ? ` · Order: ${ticket.orderId}` : ""] })] }), _jsx(Span, { size: "xs", weight: "medium", className: `shrink-0 inline-flex ${STATUS_BADGE[ticket.status] ?? STATUS_BADGE.open}`, padding: "pill-sm", rounded: "full", children: ticket.status.replace(/_/g, " ") })] }) }) }, ticket.id))) })] }));
 }
-function renderNewTicketDrawer(props) {
-    const { newTicketOpen, setNewTicketOpen, newCategory, setNewCategory, newSubject, setNewSubject, newOrderId, setNewOrderId, newDescription, setNewDescription, createMutation } = props;
-    return (_jsx(SideDrawer, { isOpen: newTicketOpen, onClose: () => setNewTicketOpen(false), title: "Open a support ticket", children: _jsxs(Stack, { className: `${__P.p4}`, gap: "md", children: [_jsx(Select, { label: "Category", options: CATEGORY_OPTIONS, value: newCategory, onValueChange: setNewCategory }), _jsx(FieldInput, { name: "subject", label: "Subject", type: "text", value: newSubject, onChange: setNewSubject, placeholder: "Brief description of the issue" }), newCategory === "order_issue" && (_jsx(FieldInput, { name: "orderId", label: "Order ID", type: "text", value: newOrderId, onChange: setNewOrderId, placeholder: "e.g. order-3-20260508-a1b2c3" })), _jsx(FieldTextarea, { name: "description", label: "Description", value: newDescription, onChange: setNewDescription, rows: 4, placeholder: "Describe the issue in detail\u2026" }), _jsxs(FormActions, { align: "right", children: [_jsx(Button, { type: "button", variant: "secondary", onClick: () => setNewTicketOpen(false), children: "Cancel" }), _jsx(Button, { type: "button", isLoading: createMutation.isPending, disabled: !newSubject.trim() || !newDescription.trim() || createMutation.isPending, onClick: () => createMutation.mutate(), children: "Submit ticket" })] })] }) }));
-}
 function renderTicketDetailDrawer(props) {
     const { detailOpen, setDetailOpen, selectedTicket, replyBody, setReplyBody, replyMutation } = props;
     return (_jsx(SideDrawer, { isOpen: detailOpen, onClose: () => setDetailOpen(false), title: selectedTicket?.subject ?? "Ticket", children: selectedTicket && (_jsxs(Stack, { className: `${__P.p4}`, gap: "md", children: [_jsxs(Row, { wrap: true, gap: "sm", children: [_jsx(Span, { size: "xs", weight: "medium", className: `inline-flex ${STATUS_BADGE[selectedTicket.status] ?? STATUS_BADGE.open}`, rounded: "full", padding: "pill-sm-tall", children: selectedTicket.status.replace(/_/g, " ") }), _jsx(Span, { size: "xs", rounded: "full", padding: "pill-sm-tall", surface: "subtle", color: "muted", children: selectedTicket.category.replace(/_/g, " ") }), selectedTicket.orderId && _jsxs(Span, { size: "xs", rounded: "full", padding: "pill-sm-tall", surface: "subtle", color: "muted", children: ["Order: ", selectedTicket.orderId] })] }), selectedTicket.description && (_jsxs(Div, { className: `${__P.p3}`, rounded: "lg", surface: "muted", border: "default", children: [_jsx(Text, { className: "mb-1 tracking-wide", size: "xs", weight: "semibold", color: "muted", transform: "uppercase", children: "Your description" }), _jsx(Text, { className: "whitespace-pre-wrap", color: "primary", size: "sm", children: selectedTicket.description })] })), (selectedTicket.messages ?? []).length > 0 && (_jsxs(Stack, { gap: "sm", children: [_jsx(Text, { className: "tracking-wide", color: "muted", size: "xs", weight: "semibold", transform: "uppercase", children: "Messages" }), _jsx(Stack, { className: `max-h-72 ${__O.yAuto}`, gap: "sm", children: (selectedTicket.messages ?? []).map((msg, i) => (_jsxs(Div, { textSize: "sm", className: `${__P.p3} ${msg.authorRole === "user" ? CLS_MSG_USER : CLS_MSG_STAFF}`, rounded: "lg", children: [_jsxs(Row, { color: "muted", textSize: "xs", className: "mb-1", align: "center", gap: "sm", children: [_jsx(Span, { weight: "medium", color: "muted", children: ROLE_LABEL[msg.authorRole ?? "user"] ?? msg.authorRole }), msg.createdAt && _jsx(Span, { children: new Date(msg.createdAt).toLocaleString() })] }), _jsx(Text, { className: "whitespace-pre-wrap", color: "primary", children: msg.body })] }, msg.id ?? i))) })] })), selectedTicket.status !== "closed" && selectedTicket.status !== "resolved" && (_jsxs(Stack, { gap: "sm", children: [_jsx(FieldTextarea, { name: "reply", label: "Reply", value: replyBody, onChange: setReplyBody, rows: 3, placeholder: "Add a message to your ticket\u2026" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", isLoading: replyMutation.isPending, disabled: !replyBody.trim() || replyMutation.isPending, onClick: () => replyMutation.mutate(), children: "Send reply" })] }))] })) }));

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

@@ -3,7 +3,7 @@ export type { UserSidebarProps, UserNavItem } from "./UserSidebar";
 export { AddressCard, AddressBook } from "./AddressBook";
 export type { AddressCardAddress, AddressCardProps } from "./AddressBook";
 export { AddressForm } from "./AddressForm";
-export type { AddressFormLabels, AddressFormPlaceholders } from "./AddressForm";
+export type { AddressFormLabels } from "./AddressForm";
 export { AddressSelectorCreate } from "./AddressSelectorCreate";
 export { NotificationBell } from "./NotificationBell";
 export type { NotificationBellLabels, NotificationBellProps, NotificationBellRenderLinkProps, } from "./NotificationBell";
@@ -27,12 +27,6 @@ export { UserNotificationsView } from "./UserNotificationsView";
 export type { UserNotificationsViewProps, UserNotificationsViewLabels, } from "./UserNotificationsView";
 export { UserOffersPanel } from "./UserOffersPanel";
 export type { UserOffersPanelProps } from "./UserOffersPanel";
-export { MessagesView } from "./MessagesView";
-export type { MessagesViewProps, MessagesViewLabels } from "./MessagesView";
-export { ChatList } from "./ChatList";
-export type { ChatListProps, ChatListLabels } from "./ChatList";
-export { ChatWindow } from "./ChatWindow";
-export type { ChatWindowProps, ChatWindowLabels } from "./ChatWindow";
 export { BecomeSellerView } from "./BecomeSellerView";
 export type { BecomeSellerViewProps, BecomeSellerViewLabels, } from "./BecomeSellerView";
 export { UserOrderTrackView } from "./UserOrderTrackView";

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

@@ -13,9 +13,6 @@ export { OrderDetailView } from "./OrderDetailView";
 export { UserAddressesView } from "./UserAddressesView";
 export { UserNotificationsView } from "./UserNotificationsView";
 export { UserOffersPanel } from "./UserOffersPanel";
-export { MessagesView } from "./MessagesView";
-export { ChatList } from "./ChatList";
-export { ChatWindow } from "./ChatWindow";
 export { BecomeSellerView } from "./BecomeSellerView";
 export { UserOrderTrackView } from "./UserOrderTrackView";
 export { UserReturnsView } from "./UserReturnsView";

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

@@ -42,9 +42,10 @@ interface SetDefaultAddressData {
 }
 export interface AddressFilterParams {
     q?: string;
-    addressType?: string;
-    verified?: boolean;
-    activeOnly?: boolean;
+    /** Only the owner's default address. */
+    defaultOnly?: boolean;
+    /** Pipe-joined `AddressBanStatus` values. */
+    banStatus?: string;
 }
 export declare function useAddresses(options?: {
     enabled?: boolean;

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

@@ -10,12 +10,10 @@ export function useAddresses(options) {
     const sp = new URLSearchParams();
     if (options?.filters?.q)
         sp.set("q", options.filters.q);
-    if (options?.filters?.addressType)
-        sp.set("addressType", options.filters.addressType);
-    if (options?.filters?.verified)
-        sp.set("verified", "true");
-    if (options?.filters?.activeOnly)
-        sp.set("activeOnly", "true");
+    if (options?.filters?.defaultOnly)
+        sp.set("defaultOnly", "true");
+    if (options?.filters?.banStatus)
+        sp.set("banStatus", options.filters.banStatus);
     const qs = sp.toString();
     const base = options?.listEndpoint ?? DEFAULT_ENDPOINTS.list;
     const endpoint = qs ? `${base}?${qs}` : base;

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

@@ -1,11 +1,47 @@
+export type SectionExpandMode = "multi" | "single";
+export interface UseSectionStateOptions {
+    /**
+     * `"{portal}:{surface}"`, e.g. `"admin:dashboard"` or `"store:product-form"`.
+     *
+     * **The empty string means EPHEMERAL** — in-memory only, no profile read, no
+     * profile write, no localStorage. It exists so a surface can adopt this hook
+     * before it has chosen a durable scope name, without every such surface
+     * writing junk under `sectionState[""]` and without the legacy-derivation
+     * branch below reading another page's `collapsedSections` into it.
+     */
+    scope: string;
+    /** Every section id this surface manages, in display order. */
+    sectionIds: string[];
+    /**
+     * Which sections are open for a user who has never touched this surface.
+     * Defaults to the FIRST section — "required first, everything else
+     * collapsed". Pass `[]` for all-collapsed.
+     */
+    defaultOpen?: string[];
+    /** `"multi"` (default) lets several sections be open at once. `"single"` is
+     * accordion: opening one closes its siblings. */
+    mode?: SectionExpandMode;
+}
+export interface UseSectionStateResult {
+    isOpen: (id: string) => boolean;
+    toggle: (id: string) => void;
+    /** Force a section open without closing anything — what a validation error
+     * needs. Never collapses, even under `mode: "single"`. */
+    open: (id: string) => void;
+    /** Replace the whole open set. For a caller that already computes the next
+     * array itself (`SectionForm`'s controlled/uncontrolled `setOpenIds`
+     * contract) rather than expressing the change as a per-id toggle. */
+    setOpenIds: (ids: string[]) => void;
+    openIds: string[];
+}
+export declare function useSectionState({ scope, sectionIds, defaultOpen, mode, }: UseSectionStateOptions): UseSectionStateResult;
 export interface UseCollapsedSectionsOptions {
-    /** Every section ID this page manages, in display order. IDs must be
-     * globally unique across pages (prefix with a page key, e.g.
-     * "admin-dashboard:alerts") — uiPreferences.collapsedSections is a single
-     * flat list shared by the whole user document, not namespaced server-side.
-     * A section ID absent from the saved list defaults to collapsed, which is
-     * also the state for a user who has never touched this page. */
+    /** Every section ID this page manages, in display order. */
     sectionIds: string[];
+    /** Scope key. Optional only so the pre-existing call sites keep compiling;
+     * they share `"legacy:collapsed-sections"`, which reproduces the old global
+     * behaviour exactly. New code should call `useSectionState` directly. */
+    scope?: string;
 }
 export interface UseCollapsedSectionsResult {
     isCollapsed: (id: string) => boolean;
@@ -14,7 +50,12 @@ export interface UseCollapsedSectionsResult {
      * everything collapsed. */
     toggle: (id: string) => void;
 }
-/** Persisted, per-user, accordion-scoped collapse state for a page's
- * dashboard sections. Debounces writes to PATCH /api/user/profile so rapid
- * toggling doesn't fire a request per click. */
-export declare function useCollapsedSections({ sectionIds, }: UseCollapsedSectionsOptions): UseCollapsedSectionsResult;
+/**
+ * @deprecated Prefer `useSectionState`, which is namespaced per surface,
+ * supports several sections open at once, and defaults to section 1 open.
+ *
+ * Kept so the existing dashboard call sites need no edit. Semantics are
+ * byte-identical to the original: default all-collapsed (`defaultOpen: []`)
+ * and accordion (`mode: "single"`).
+ */
+export declare function useCollapsedSections({ sectionIds, scope, }: UseCollapsedSectionsOptions): UseCollapsedSectionsResult;