@mohasinac/appkit 2.3.1 → 2.3.2

package/dist/client.d.ts

@@ -59,10 +59,13 @@ export type { NavigationLoaderProps } from "./ui/index";
 export { ZodSetup } from "./validation/ZodSetup";
 export type { ZodSetupProps } from "./validation/ZodSetup";
 export { AdminSidebar } from "./features/admin/components/AdminSidebar";
-export { AdminDashboardView, AdminAnalyticsView } from "./features/admin/index";
+export { AdminDashboardView, AdminAnalyticsView, AdminListingScaffold, useAdminListingData, toRecordArray, toStringValue, toRelativeDate, toRupees } from "./features/admin/index";
 export type { AdminDashboardViewProps, AdminAnalyticsViewProps, AdminAnalyticsViewLabels } from "./features/admin/index";
+export { ADMIN_ENDPOINTS } from "./constants/index";
 export { UserSidebar } from "./features/account/components/UserSidebar";
-export type { UserSidebarProps, UserNavItem } from "./features/account/components/UserSidebar";
+export type { UserSidebarProps, UserNavItem, UserNavGroup } from "./features/account/components/UserSidebar";
+export { CouponsIndexListing } from "./features/promotions/components/CouponsIndexListing";
+export type { CouponsIndexListingProps } from "./features/promotions/components/CouponsIndexListing";
 export { NotificationBell } from "./features/account/components/NotificationBell";
 export { ProtectedRoute, AuthStatusPanel, ForgotPasswordView, LoginForm, RegisterForm, ResetPasswordView, VerifyEmailView } from "./features/auth/index";
 export type { AuthGuardUser, ForgotPasswordViewProps, LoginFormProps, LoginFormValues, RegisterFormProps, RegisterFormValues, ResetPasswordViewProps, VerifyEmailViewProps, } from "./features/auth/index";
@@ -76,19 +79,20 @@ export { CategoryProductsView, CategoriesListView } from "./features/categories/
 export type { CategoryItem } from "./features/categories/index";
 export { MediaImage } from "./features/media/index";
 export { ReviewsListView } from "./features/reviews/index";
-export { SellerSidebar } from "./features/seller/components/SellerSidebar";
-export type { SellerNavItem } from "./features/seller/components/SellerSidebar";
+export { StoreSidebar, SellerSidebar } from "./features/seller/components/SellerSidebar";
+export type { StoreNavItem, SellerNavItem } from "./features/seller/components/SellerSidebar";
 export { StoreProductsView } from "./features/stores/index";
 export type { StoreProductItem } from "./features/stores/index";
 export { AdSlot } from "./features/homepage/components/AdSlot";
 export { registerAdSlot, registerAdSlots, unregisterAdSlot, clearAdRegistry, setAdConsentGranted, isAdConsentGranted, isAdSlotRenderable, } from "./features/homepage/ad-registry";
 export type { AdSlotId, AdProvider, AdSlotConfig } from "./features/homepage/ad-registry";
-export { WishlistView } from "./features/wishlist/index";
-export type { WishlistViewProps } from "./features/wishlist/index";
+export { WishlistView, useGuestWishlist, useWishlistWithGuest } from "./features/wishlist/index";
+export type { WishlistViewProps, GuestWishlistItem } from "./features/wishlist/index";
+export { getGuestWishlistItems, addToGuestWishlist, removeFromGuestWishlist, isInGuestWishlist, clearGuestWishlist, getGuestWishlistCount, getGuestWishlistByType, } from "./features/wishlist/utils/guest-wishlist";
 export { InteractiveProductCard } from "./features/products/index";
 export type { InteractiveProductCardProps } from "./features/products/index";
-export { SellerDashboardView, useSellerDashboard } from "./features/seller/index";
-export type { SellerDashboardViewProps } from "./features/seller/index";
+export { SellerDashboardView as StoreDashboardView, SellerDashboardView, useSellerDashboard as useStoreDashboard, useSellerDashboard } from "./features/seller/index";
+export type { SellerDashboardViewProps as StoreDashboardViewProps, SellerDashboardViewProps } from "./features/seller/index";
 export { UserAccountHubView, UserOrdersView } from "./features/account/index";
 export type { UserAccountHubViewProps, UserAccountHubViewLabels, UserOrdersViewProps, UserOrdersViewLabels } from "./features/account/index";
 export { useOrders, OrdersList } from "./features/orders/index";

package/dist/client.js

@@ -121,8 +121,10 @@ export { Search } from "./features/search/components";
 export { ToastProvider, SkipToMain, NavigationLoader } from "./ui/index";
 export { ZodSetup } from "./validation/ZodSetup";
 export { AdminSidebar } from "./features/admin/components/AdminSidebar";
-export { AdminDashboardView, AdminAnalyticsView } from "./features/admin/index";
+export { AdminDashboardView, AdminAnalyticsView, AdminListingScaffold, useAdminListingData, toRecordArray, toStringValue, toRelativeDate, toRupees } from "./features/admin/index";
+export { ADMIN_ENDPOINTS } from "./constants/index";
 export { UserSidebar } from "./features/account/components/UserSidebar";
+export { CouponsIndexListing } from "./features/promotions/components/CouponsIndexListing";
 export { NotificationBell } from "./features/account/components/NotificationBell";
 export { ProtectedRoute, AuthStatusPanel, ForgotPasswordView, LoginForm, RegisterForm, ResetPasswordView, VerifyEmailView } from "./features/auth/index";
 export { useLogout, useLogin, useGoogleLogin, useRegister, useForgotPassword, useResetPassword, useVerifyEmail } from "./features/auth/index";
@@ -131,13 +133,14 @@ export { useAddresses } from "./features/account/index";
 export { CategoryProductsView, CategoriesListView } from "./features/categories/index";
 export { MediaImage } from "./features/media/index";
 export { ReviewsListView } from "./features/reviews/index";
-export { SellerSidebar } from "./features/seller/components/SellerSidebar";
+export { StoreSidebar, SellerSidebar } from "./features/seller/components/SellerSidebar";
 export { StoreProductsView } from "./features/stores/index";
 export { AdSlot } from "./features/homepage/components/AdSlot";
 export { registerAdSlot, registerAdSlots, unregisterAdSlot, clearAdRegistry, setAdConsentGranted, isAdConsentGranted, isAdSlotRenderable, } from "./features/homepage/ad-registry";
-export { WishlistView } from "./features/wishlist/index";
+export { WishlistView, useGuestWishlist, useWishlistWithGuest } from "./features/wishlist/index";
+export { getGuestWishlistItems, addToGuestWishlist, removeFromGuestWishlist, isInGuestWishlist, clearGuestWishlist, getGuestWishlistCount, getGuestWishlistByType, } from "./features/wishlist/utils/guest-wishlist";
 export { InteractiveProductCard } from "./features/products/index";
-export { SellerDashboardView, useSellerDashboard } from "./features/seller/index";
+export { SellerDashboardView as StoreDashboardView, SellerDashboardView, useSellerDashboard as useStoreDashboard, useSellerDashboard } from "./features/seller/index";
 export { UserAccountHubView, UserOrdersView } from "./features/account/index";
 export { useOrders, OrdersList } from "./features/orders/index";
 export { useCouponValidate } from "./features/promotions/hooks/useCouponValidate";

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

@@ -71,6 +71,8 @@ export declare const ADMIN_ENDPOINTS: {
     readonly EVENT_ENTRY_BY_ID: (eventId: string, entryId: string) => string;
     readonly COUPONS: "/api/admin/coupons";
     readonly SECTIONS: "/api/admin/sections";
+    readonly NEWSLETTER: "/api/admin/newsletter";
+    readonly CONTACT_SUBMISSIONS: "/api/admin/contact-submissions";
 };
 export declare const CHAT_ENDPOINTS: {
     readonly LIST: "/api/chat";
@@ -284,6 +286,8 @@ export declare const API_ENDPOINTS: {
         readonly EVENT_ENTRY_BY_ID: (eventId: string, entryId: string) => string;
         readonly COUPONS: "/api/admin/coupons";
         readonly SECTIONS: "/api/admin/sections";
+        readonly NEWSLETTER: "/api/admin/newsletter";
+        readonly CONTACT_SUBMISSIONS: "/api/admin/contact-submissions";
     };
     readonly CHAT: {
         readonly LIST: "/api/chat";

package/dist/constants/api-endpoints.js

@@ -89,6 +89,8 @@ export const ADMIN_ENDPOINTS = {
     EVENT_ENTRY_BY_ID: (eventId, entryId) => `/api/admin/events/${eventId}/entries/${entryId}`,
     COUPONS: "/api/admin/coupons",
     SECTIONS: "/api/admin/sections",
+    NEWSLETTER: "/api/admin/newsletter",
+    CONTACT_SUBMISSIONS: "/api/admin/contact-submissions",
 };
 // ---------------------------------------------------------------------------
 // Chat

package/dist/core/contact-submissions.repository.d.ts

@@ -0,0 +1,32 @@
+import type { IRepository, PagedResult } from "../contracts/repository";
+export interface ContactSubmissionDocument {
+    id: string;
+    name: string;
+    email: string;
+    subject: string;
+    message: string;
+    status: "new" | "read" | "resolved";
+    ipAddress?: string;
+    createdAt: Date;
+    updatedAt?: Date;
+}
+export type ContactSubmissionCreateInput = Omit<ContactSubmissionDocument, "id" | "status" | "createdAt" | "updatedAt">;
+export interface ContactSubmissionListModel {
+    filters?: string;
+    sorts?: string;
+    page?: string;
+    pageSize?: string;
+}
+export declare const CONTACT_SUBMISSIONS_COLLECTION: "contactSubmissions";
+export declare class ContactSubmissionsRepository {
+    private _repo;
+    constructor(repo?: IRepository<ContactSubmissionDocument> | null);
+    private get repo();
+    list(model: ContactSubmissionListModel): Promise<PagedResult<ContactSubmissionDocument>>;
+    findById(id: string): Promise<ContactSubmissionDocument | null>;
+    save(input: ContactSubmissionCreateInput): Promise<ContactSubmissionDocument>;
+    markRead(id: string): Promise<void>;
+    markResolved(id: string): Promise<void>;
+    deleteById(id: string): Promise<void>;
+}
+export declare const contactSubmissionsRepository: ContactSubmissionsRepository;

package/dist/core/contact-submissions.repository.js

@@ -0,0 +1,49 @@
+import { getProviders } from "../contracts/registry";
+export const CONTACT_SUBMISSIONS_COLLECTION = "contactSubmissions";
+function resolveRepository() {
+    const provider = getProviders().db;
+    if (!provider) {
+        throw new Error("DB provider is not registered. Configure providers before using ContactSubmissionsRepository.");
+    }
+    return provider.getRepository(CONTACT_SUBMISSIONS_COLLECTION);
+}
+export class ContactSubmissionsRepository {
+    constructor(repo = null) {
+        this._repo = repo;
+    }
+    get repo() {
+        if (!this._repo) {
+            this._repo = resolveRepository();
+        }
+        return this._repo;
+    }
+    async list(model) {
+        const page = Number(model.page || "1");
+        const perPage = Number(model.pageSize || "50");
+        return this.repo.findAll({
+            filters: model.filters,
+            sort: model.sorts || "-createdAt",
+            page: Number.isFinite(page) ? page : 1,
+            perPage: Number.isFinite(perPage) ? perPage : 50,
+        });
+    }
+    async findById(id) {
+        return this.repo.findById(id);
+    }
+    async save(input) {
+        return this.repo.create({
+            ...input,
+            status: "new",
+        });
+    }
+    async markRead(id) {
+        await this.repo.update(id, { status: "read", updatedAt: new Date() });
+    }
+    async markResolved(id) {
+        await this.repo.update(id, { status: "resolved", updatedAt: new Date() });
+    }
+    async deleteById(id) {
+        await this.repo.delete(id);
+    }
+}
+export const contactSubmissionsRepository = new ContactSubmissionsRepository();

package/dist/core/index.d.ts

@@ -22,6 +22,8 @@ export { COPILOT_LOGS_COLLECTION, COPILOT_LOGS_INDEXED_FIELDS, copilotLogQueryHe
 export { useSiteSettings } from "./hooks/useSiteSettings";
 export { NEWSLETTER_SUBSCRIBER_FIELDS, NEWSLETTER_SUBSCRIBERS_COLLECTION, NEWSLETTER_SUBSCRIBER_INDEXED_FIELDS, newsletterRepository, } from "./newsletter.repository";
 export type { NewsletterSubscriberDocument, NewsletterSubscriberCreateInput, NewsletterSubscriberUpdateInput, } from "./newsletter.repository";
+export { CONTACT_SUBMISSIONS_COLLECTION, contactSubmissionsRepository, } from "./contact-submissions.repository";
+export type { ContactSubmissionDocument, ContactSubmissionCreateInput, } from "./contact-submissions.repository";
 export { subscribeNewsletter, type SubscribeNewsletterActionInput, type SupportedNewsletterSource, } from "./newsletter-actions";
 export { unitOfWork } from "./unit-of-work";
 export type { UnitOfWork } from "./unit-of-work";

package/dist/core/index.js

@@ -14,6 +14,7 @@ export { CopilotLogRepository, copilotLogRepository, } from "./copilot-log.repos
 export { COPILOT_LOGS_COLLECTION, COPILOT_LOGS_INDEXED_FIELDS, copilotLogQueryHelpers, } from "./copilot-log.repository";
 export { useSiteSettings } from "./hooks/useSiteSettings";
 export { NEWSLETTER_SUBSCRIBER_FIELDS, NEWSLETTER_SUBSCRIBERS_COLLECTION, NEWSLETTER_SUBSCRIBER_INDEXED_FIELDS, newsletterRepository, } from "./newsletter.repository";
+export { CONTACT_SUBMISSIONS_COLLECTION, contactSubmissionsRepository, } from "./contact-submissions.repository";
 export { subscribeNewsletter, } from "./newsletter-actions";
 export { unitOfWork } from "./unit-of-work";
 export { createServerAction, setActionMiddleware, _resetActionMiddleware, } from "./server-action";

package/dist/features/about/components/HowPayoutsWorkView.js

@@ -83,5 +83,5 @@ export async function HowPayoutsWorkView({ heroBannerClass = DEFAULT_HERO_CLASS,
             desc: t("diagramStep5Desc"),
         },
     ];
-    return (_jsxs("div", { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", "data-section": "howpayoutsworkview-div-151", children: [_jsx(Section, { className: `${heroBannerClass} text-white py-14 md:py-16 lg:py-20`, children: _jsxs("div", { className: `${page.container.md} text-center`, "data-section": "howpayoutsworkview-div-152", children: [_jsx(Heading, { level: 1, variant: "none", className: "mb-4 text-white", children: t("title") }), _jsx(Text, { variant: "none", className: "text-white/80 max-w-2xl mx-auto", children: t("subtitle") })] }) }), _jsxs("div", { className: `${page.container.md} py-10 md:py-12 lg:py-16 space-y-14`, "data-section": "howpayoutsworkview-div-153", children: [_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-8 text-center", children: t("stepsTitle") }), _jsx(Stack, { gap: "md", className: "gap-5", children: STEPS.map(({ number, icon, title, text }) => (_jsxs("div", { className: `flex items-start gap-4 p-5 rounded-xl border ${themed.border} ${themed.bgPrimary}`, "data-section": "howpayoutsworkview-div-154", children: [_jsx("div", { className: `flex-shrink-0 w-10 h-10 rounded-full bg-primary/10 dark:bg-primary/15 ${flex.center} text-xl`, "data-section": "howpayoutsworkview-div-155", children: icon }), _jsxs("div", { "data-section": "howpayoutsworkview-div-156", children: [_jsxs(Text, { className: "font-semibold mb-0.5", children: [number, ". ", title] }), _jsx(Text, { variant: "secondary", className: "text-sm leading-relaxed", children: text })] })] }, number))) })] }), _jsx(Section, { children: _jsx(FlowDiagram, { title: `💸 ${t("diagramTitle")}`, titleClass: "text-primary", connectorClass: "bg-primary/20 dark:bg-primary/30", steps: DIAGRAM_STEPS, centered: true }) }), _jsx(Section, { children: _jsx("div", { className: "grid gap-5 md:grid-cols-2", "data-section": "howpayoutsworkview-div-157", children: INFO_CARDS.map(({ icon: Icon, title, text, color, iconColor }) => (_jsxs("div", { className: `rounded-xl border p-5 ${color}`, "data-section": "howpayoutsworkview-div-158", children: [_jsx("div", { className: `w-10 h-10 rounded-lg bg-white/60 dark:bg-white/10 ${flex.center} mb-3`, "data-section": "howpayoutsworkview-div-159", children: _jsx(Icon, { className: `w-5 h-5 ${iconColor}` }) }), _jsx(Text, { className: "font-semibold mb-1", children: title }), _jsx(Text, { variant: "secondary", className: "text-sm leading-relaxed", children: text })] }, title))) }) }), _jsxs(Section, { className: `rounded-2xl p-8 text-center ${themed.bgSecondary} border ${themed.border}`, children: [_jsx(Heading, { level: 2, className: "mb-3", children: t("ctaTitle") }), _jsx(Text, { variant: "secondary", className: "mb-6 max-w-lg mx-auto", children: t("ctaText") }), _jsxs("div", { className: `${flex.center} gap-4 flex-wrap`, "data-section": "howpayoutsworkview-div-160", children: [_jsx(TextLink, { href: String(ROUTES.SELLER.PAYOUT_SETTINGS), children: t("ctaPayoutSettings") }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.FEES), variant: "muted", children: t("ctaFees") })] })] })] })] }));
+    return (_jsxs("div", { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", "data-section": "howpayoutsworkview-div-151", children: [_jsx(Section, { className: `${heroBannerClass} text-white py-14 md:py-16 lg:py-20`, children: _jsxs("div", { className: `${page.container.md} text-center`, "data-section": "howpayoutsworkview-div-152", children: [_jsx(Heading, { level: 1, variant: "none", className: "mb-4 text-white", children: t("title") }), _jsx(Text, { variant: "none", className: "text-white/80 max-w-2xl mx-auto", children: t("subtitle") })] }) }), _jsxs("div", { className: `${page.container.md} py-10 md:py-12 lg:py-16 space-y-14`, "data-section": "howpayoutsworkview-div-153", children: [_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-8 text-center", children: t("stepsTitle") }), _jsx(Stack, { gap: "md", className: "gap-5", children: STEPS.map(({ number, icon, title, text }) => (_jsxs("div", { className: `flex items-start gap-4 p-5 rounded-xl border ${themed.border} ${themed.bgPrimary}`, "data-section": "howpayoutsworkview-div-154", children: [_jsx("div", { className: `flex-shrink-0 w-10 h-10 rounded-full bg-primary/10 dark:bg-primary/15 ${flex.center} text-xl`, "data-section": "howpayoutsworkview-div-155", children: icon }), _jsxs("div", { "data-section": "howpayoutsworkview-div-156", children: [_jsxs(Text, { className: "font-semibold mb-0.5", children: [number, ". ", title] }), _jsx(Text, { variant: "secondary", className: "text-sm leading-relaxed", children: text })] })] }, number))) })] }), _jsx(Section, { children: _jsx(FlowDiagram, { title: `💸 ${t("diagramTitle")}`, titleClass: "text-primary", connectorClass: "bg-primary/20 dark:bg-primary/30", steps: DIAGRAM_STEPS, centered: true }) }), _jsx(Section, { children: _jsx("div", { className: "grid gap-5 md:grid-cols-2", "data-section": "howpayoutsworkview-div-157", children: INFO_CARDS.map(({ icon: Icon, title, text, color, iconColor }) => (_jsxs("div", { className: `rounded-xl border p-5 ${color}`, "data-section": "howpayoutsworkview-div-158", children: [_jsx("div", { className: `w-10 h-10 rounded-lg bg-white/60 dark:bg-white/10 ${flex.center} mb-3`, "data-section": "howpayoutsworkview-div-159", children: _jsx(Icon, { className: `w-5 h-5 ${iconColor}` }) }), _jsx(Text, { className: "font-semibold mb-1", children: title }), _jsx(Text, { variant: "secondary", className: "text-sm leading-relaxed", children: text })] }, title))) }) }), _jsxs(Section, { className: `rounded-2xl p-8 text-center ${themed.bgSecondary} border ${themed.border}`, children: [_jsx(Heading, { level: 2, className: "mb-3", children: t("ctaTitle") }), _jsx(Text, { variant: "secondary", className: "mb-6 max-w-lg mx-auto", children: t("ctaText") }), _jsxs("div", { className: `${flex.center} gap-4 flex-wrap`, "data-section": "howpayoutsworkview-div-160", children: [_jsx(TextLink, { href: String(ROUTES.STORE.PAYOUT_SETTINGS), children: t("ctaPayoutSettings") }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.FEES), variant: "muted", children: t("ctaFees") })] })] })] })] }));
 }

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

@@ -0,0 +1,5 @@
+import type { UrlTable } from "../../filters/FilterPanel";
+export interface AddressFiltersProps {
+    table: UrlTable;
+}
+export declare function AddressFilters({ table }: AddressFiltersProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useTranslations } from "next-intl";
+import { FilterFacetSection } from "../../filters/FilterFacetSection";
+import { SwitchFilter } from "../../filters/SwitchFilter";
+import { Div } from "../../../ui";
+export function AddressFilters({ table }) {
+    const t = useTranslations("filters");
+    const typeOptions = [
+        { value: "home", label: t("addressTypeHome") },
+        { value: "work", label: t("addressTypeWork") },
+        { value: "shipping", label: t("addressTypeShipping") },
+        { value: "billing", label: t("addressTypeBilling") },
+        { value: "business", label: t("addressTypeBusiness") },
+        { value: "other", label: t("addressTypeOther") },
+    ];
+    const selectedTypes = table.get("addressType")
+        ? table.get("addressType").split("|").filter(Boolean)
+        : [];
+    return (_jsxs(Div, { children: [_jsx(FilterFacetSection, { title: t("addressType"), options: typeOptions, selected: selectedTypes, onChange: (vals) => table.set("addressType", vals.join("|")), searchable: false, defaultCollapsed: false }), _jsx(SwitchFilter, { title: t("addressVerified"), label: t("showVerifiedAddressOnly"), checked: table.get("verified") === "true", onChange: (v) => table.set("verified", v ? "true" : ""), defaultCollapsed: true }), _jsx(SwitchFilter, { title: t("addressActive"), label: t("showActiveAddressOnly"), checked: table.get("activeOnly") === "true", onChange: (v) => table.set("activeOnly", v ? "true" : ""), defaultCollapsed: true })] }));
+}

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

@@ -0,0 +1,6 @@
+export interface AddressesIndexListingProps {
+    onAdd?: () => void;
+    onEdit?: (address: any) => void;
+    onDelete?: (id: string) => void;
+}
+export declare function AddressesIndexListing({ onAdd, onEdit, onDelete, }: AddressesIndexListingProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,51 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState } from "react";
+import { Search, SlidersHorizontal, X } from "lucide-react";
+import { useAddresses } from "../hooks/useAddresses";
+import { AddressBook } from "./AddressBook";
+import { AddressFilters } from "./AddressFilters";
+function createLocalTable(params, setParams) {
+    return {
+        get: (key) => params[key] ?? "",
+        set: (key, value) => setParams({ ...params, [key]: value }),
+        setMany: (updates) => setParams({ ...params, ...updates }),
+        getNumber: (key, def) => {
+            const v = params[key];
+            return v ? Number(v) : def;
+        },
+        setPage: (page) => setParams({ ...params, page: String(page) }),
+        setSort: (sort) => setParams({ ...params, sort }),
+        setPageSize: (size) => setParams({ ...params, pageSize: String(size) }),
+        clear: (keys) => {
+            const next = { ...params };
+            (Array.isArray(keys) ? keys : [keys]).forEach((k) => delete next[k]);
+            setParams(next);
+        },
+        buildSieveParams: () => ({}),
+        buildSearchParams: () => new URLSearchParams(),
+    };
+}
+export function AddressesIndexListing({ onAdd, onEdit, onDelete, }) {
+    const [searchInput, setSearchInput] = useState("");
+    const [activeSearch, setActiveSearch] = useState("");
+    const [filterOpen, setFilterOpen] = useState(false);
+    const [filterParams, setFilterParams] = useState({});
+    const table = createLocalTable(filterParams, setFilterParams);
+    const { data: addresses = [], isLoading } = useAddresses({
+        filters: {
+            q: activeSearch || undefined,
+            addressType: filterParams.addressType || undefined,
+            verified: filterParams.verified === "true" || undefined,
+            activeOnly: filterParams.activeOnly === "true" || undefined,
+        },
+    });
+    const commitSearch = () => {
+        setActiveSearch(searchInput.trim());
+    };
+    const closeFilters = () => setFilterOpen(false);
+    if (isLoading) {
+        return (_jsx("div", { className: "grid sm:grid-cols-2 gap-4", children: Array.from({ length: 4 }).map((_, i) => (_jsxs("div", { className: "rounded-xl border border-zinc-200 dark:border-slate-700 animate-pulse p-4 space-y-2", children: [_jsx("div", { className: "h-4 bg-zinc-200 dark:bg-slate-700 rounded w-1/3" }), _jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-3/4" }), _jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-1/2" })] }, i))) }));
+    }
+    return (_jsxs("div", { className: "space-y-4", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsxs("button", { type: "button", onClick: () => setFilterOpen(true), className: "flex shrink-0 items-center gap-1.5 rounded-lg border border-zinc-300 dark:border-slate-600 px-3 py-2 text-sm font-medium text-zinc-700 dark:text-zinc-200 hover:bg-zinc-50 dark:hover:bg-slate-800 transition-colors", children: [_jsx(SlidersHorizontal, { className: "h-4 w-4" }), _jsx("span", { className: "hidden sm:inline", children: "Filters" })] }), _jsxs("div", { className: "flex flex-1 items-center overflow-hidden rounded-lg border border-zinc-300 dark:border-slate-600 bg-white dark:bg-slate-900", children: [_jsx("input", { type: "text", value: searchInput, onChange: (e) => setSearchInput(e.target.value), onKeyDown: (e) => e.key === "Enter" && commitSearch(), placeholder: "Search by address, postcode or label...", className: "min-w-0 flex-1 bg-transparent px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 outline-none" }), searchInput && (_jsx("button", { type: "button", onClick: () => { setSearchInput(""); setActiveSearch(""); }, className: "px-2 text-zinc-400 hover:text-zinc-600 dark:hover:text-zinc-300", "aria-label": "Clear", children: _jsx(X, { className: "h-3.5 w-3.5" }) })), _jsx("button", { type: "button", onClick: commitSearch, className: "flex shrink-0 items-center justify-center px-3 py-2 text-zinc-400 hover:text-primary transition-colors", "aria-label": "Search", children: _jsx(Search, { className: "h-4 w-4" }) })] })] }), addresses.length === 0 ? (_jsx("p", { className: "py-8 text-center text-sm text-zinc-500 dark:text-zinc-400", children: activeSearch ? `No addresses matching "${activeSearch}"` : "No saved addresses." })) : (_jsx(AddressBook, { addresses: addresses, onEdit: onEdit, onDelete: onDelete, onAdd: onAdd })), filterOpen && (_jsxs(_Fragment, { children: [_jsx("div", { className: "fixed inset-0 z-40 bg-black/40", "aria-hidden": "true", onClick: closeFilters }), _jsxs("div", { className: "fixed inset-y-0 left-0 z-50 flex w-80 flex-col bg-white dark:bg-slate-900 shadow-2xl", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-zinc-200 dark:border-slate-700 px-4 py-3.5", children: [_jsxs("span", { className: "flex items-center gap-2 text-base font-semibold text-zinc-900 dark:text-zinc-100", children: [_jsx(SlidersHorizontal, { className: "h-4 w-4" }), "Filters"] }), _jsx("button", { type: "button", onClick: closeFilters, "aria-label": "Close filters", className: "rounded-lg p-1.5 text-zinc-500 hover:bg-zinc-100 dark:hover:bg-slate-800 transition-colors", children: _jsx(X, { className: "h-5 w-5" }) })] }), _jsx("div", { className: "flex-1 overflow-y-auto px-4 py-4", children: _jsx(AddressFilters, { table: table }) }), _jsx("div", { className: "border-t border-zinc-200 dark:border-slate-700 px-4 py-3.5", children: _jsx("button", { type: "button", onClick: closeFilters, className: "w-full rounded-lg bg-primary py-2.5 text-sm font-semibold text-white hover:bg-primary-600 transition-colors", children: "Apply filters" }) })] })] }))] }));
+}

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

@@ -4,12 +4,16 @@ export interface UserNavItem {
     label: string;
     icon?: React.ReactNode;
 }
+export interface UserNavGroup {
+    title: string;
+    items: UserNavItem[];
+    defaultOpen?: boolean;
+}
 export interface UserSidebarProps {
     items: UserNavItem[];
-    /** Whether the mobile drawer is open */
+    groups?: UserNavGroup[];
     mobileOpen?: boolean;
-    /** Called when the mobile drawer should close */
     onCloseMobile?: () => void;
     className?: string;
 }
-export declare function UserSidebar({ items, mobileOpen, onCloseMobile, className, }: UserSidebarProps): import("react/jsx-runtime").JSX.Element;
+export declare function UserSidebar({ items, groups, mobileOpen, onCloseMobile, className, }: UserSidebarProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,18 +1,66 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useEffect, useCallback } from "react";
 import Link from "next/link";
 import { usePathname } from "next/navigation";
 import { Aside, Li, Nav, Span, Ul } from "../../../ui";
 import { BottomSheet } from "../../layout/BottomSheet";
-function SidebarContent({ items, activeHref, onItemClick, }) {
-    return (_jsx(Nav, { "aria-label": "User navigation", className: "flex-1 overflow-y-auto py-3", children: _jsx(Ul, { className: "space-y-0.5 px-2", children: items.map((item) => {
+const STORAGE_KEY = "user-sidebar-collapsed";
+function NavLink({ item, isActive, collapsed, onClick, }) {
+    return (_jsxs(Link, { href: item.href, onClick: onClick, title: collapsed ? item.label : undefined, className: `flex items-center rounded-lg py-2 text-sm transition-colors ${collapsed ? "justify-center px-2" : "gap-3 px-3"} ${isActive
+            ? "bg-primary-50 dark:bg-primary-900/20 text-primary-600 dark:text-primary-400 font-medium"
+            : "text-zinc-600 dark:text-zinc-300 hover:bg-zinc-50 dark:hover:bg-slate-800 hover:text-zinc-900 dark:hover:text-zinc-100"}`, children: [item.icon && _jsx(Span, { className: "shrink-0 text-[1.1rem]", children: item.icon }), !collapsed && _jsx(Span, { className: "flex-1 truncate", children: item.label })] }));
+}
+function DesktopContent({ items, activeHref, collapsed, }) {
+    return (_jsx(Nav, { "aria-label": "User navigation", className: "flex-1 overflow-y-auto py-2", children: _jsx(Ul, { className: `space-y-0.5 ${collapsed ? "px-1" : "px-2"}`, children: items.map((item) => {
                 const isActive = activeHref === item.href || activeHref.startsWith(item.href + "/");
-                return (_jsx(Li, { children: _jsxs(Link, { href: item.href, onClick: onItemClick, className: `flex items-center gap-3 rounded-lg px-3 py-2 text-sm transition-colors ${isActive
-                            ? "bg-primary-50 dark:bg-primary-900/20 text-primary-600 dark:text-primary-400 font-medium"
-                            : "text-zinc-600 dark:text-zinc-300 hover:bg-zinc-50 dark:hover:bg-slate-800 hover:text-zinc-900 dark:hover:text-zinc-100"}`, children: [item.icon && (_jsx(Span, { className: "shrink-0 text-[1.1rem]", children: item.icon })), _jsx(Span, { className: "flex-1 truncate", children: item.label })] }) }, item.href));
+                return (_jsx(Li, { children: _jsx(NavLink, { item: item, isActive: isActive, collapsed: collapsed }) }, item.href));
             }) }) }));
 }
-export function UserSidebar({ items, mobileOpen = false, onCloseMobile, className = "", }) {
+function MobileContent({ groups, items, activeHref, onItemClick, }) {
+    const [openGroups, setOpenGroups] = useState(() => {
+        if (!groups)
+            return {};
+        return Object.fromEntries(groups.map((g) => [g.title, g.defaultOpen ?? true]));
+    });
+    const toggle = useCallback((title) => setOpenGroups((prev) => ({ ...prev, [title]: !prev[title] })), []);
+    if (!groups || groups.length === 0) {
+        return (_jsx(Nav, { "aria-label": "User navigation", className: "py-2", children: _jsx(Ul, { className: "space-y-0.5 px-2", children: items.map((item) => {
+                    const isActive = activeHref === item.href || activeHref.startsWith(item.href + "/");
+                    return (_jsx(Li, { children: _jsx(NavLink, { item: item, isActive: isActive, onClick: onItemClick }) }, item.href));
+                }) }) }));
+    }
+    return (_jsx(Nav, { "aria-label": "User navigation", className: "py-2 space-y-1", children: groups.map((group) => {
+            const isOpen = openGroups[group.title] ?? true;
+            return (_jsxs("div", { children: [_jsxs("button", { type: "button", onClick: () => toggle(group.title), className: "flex w-full items-center justify-between px-4 py-2 text-xs font-semibold uppercase tracking-wider text-zinc-400 dark:text-zinc-500 hover:text-zinc-700 dark:hover:text-zinc-300 transition-colors", children: [_jsx("span", { children: group.title }), _jsx("span", { className: `transition-transform duration-150 text-[0.65rem] ${isOpen ? "rotate-180" : ""}`, children: "\u25BE" })] }), isOpen && (_jsx(Ul, { className: "space-y-0.5 px-2 pb-2", children: group.items.map((item) => {
+                            const isActive = activeHref === item.href ||
+                                activeHref.startsWith(item.href + "/");
+                            return (_jsx(Li, { children: _jsx(NavLink, { item: item, isActive: isActive, onClick: onItemClick }) }, item.href));
+                        }) }))] }, group.title));
+        }) }));
+}
+export function UserSidebar({ items, groups, mobileOpen = false, onCloseMobile, className = "", }) {
     const pathname = usePathname();
-    return (_jsxs(_Fragment, { children: [_jsx(Aside, { className: `hidden md:flex w-56 shrink-0 flex-col bg-white dark:bg-slate-900 border-r border-zinc-200 dark:border-slate-700 ${className}`, children: _jsx(SidebarContent, { items: items, activeHref: pathname }) }), _jsx(BottomSheet, { open: mobileOpen, onClose: onCloseMobile ?? (() => { }), title: "My Account", children: _jsx(SidebarContent, { items: items, activeHref: pathname, onItemClick: onCloseMobile }) })] }));
+    const [collapsed, setCollapsed] = useState(false);
+    useEffect(() => {
+        try {
+            setCollapsed(localStorage.getItem(STORAGE_KEY) === "true");
+        }
+        catch {
+            // ignore
+        }
+    }, []);
+    const toggleCollapsed = useCallback(() => {
+        setCollapsed((prev) => {
+            const next = !prev;
+            try {
+                localStorage.setItem(STORAGE_KEY, String(next));
+            }
+            catch {
+                // ignore
+            }
+            return next;
+        });
+    }, []);
+    return (_jsxs(_Fragment, { children: [_jsxs(Aside, { className: `hidden md:flex flex-col bg-white dark:bg-slate-900 border-l border-zinc-200 dark:border-slate-700 shrink-0 transition-[width] duration-200 overflow-hidden ${collapsed ? "w-12" : "w-56"} ${className}`, children: [_jsx("div", { className: `flex pt-3 pb-1 ${collapsed ? "justify-center px-1" : "justify-end px-3"}`, children: _jsx("button", { type: "button", onClick: toggleCollapsed, title: collapsed ? "Expand menu" : "Collapse menu", className: "rounded-md p-1.5 text-zinc-400 hover:bg-zinc-100 dark:hover:bg-slate-800 hover:text-zinc-600 dark:hover:text-zinc-300 transition-colors text-xs leading-none", children: collapsed ? "›" : "‹" }) }), _jsx(DesktopContent, { items: items, activeHref: pathname, collapsed: collapsed })] }), _jsx(BottomSheet, { open: mobileOpen, onClose: onCloseMobile ?? (() => { }), title: "My Account", children: _jsx(MobileContent, { groups: groups, items: items, activeHref: pathname, onItemClick: onCloseMobile }) })] }));
 }

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

@@ -26,9 +26,16 @@ export interface AddressFormData {
 interface SetDefaultAddressData {
     addressId: string;
 }
+export interface AddressFilterParams {
+    q?: string;
+    addressType?: string;
+    verified?: boolean;
+    activeOnly?: boolean;
+}
 export declare function useAddresses(options?: {
     enabled?: boolean;
     listEndpoint?: string;
+    filters?: AddressFilterParams;
 }): import("@tanstack/react-query").UseQueryResult<Address[], Error>;
 export declare function useAddress(id: string, options?: {
     enabled?: boolean;

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

@@ -7,7 +7,18 @@ const DEFAULT_ENDPOINTS = {
     setDefault: ACCOUNT_ENDPOINTS.ADDRESS_SET_DEFAULT,
 };
 export function useAddresses(options) {
-    const endpoint = options?.listEndpoint ?? DEFAULT_ENDPOINTS.list;
+    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");
+    const qs = sp.toString();
+    const base = options?.listEndpoint ?? DEFAULT_ENDPOINTS.list;
+    const endpoint = qs ? `${base}?${qs}` : base;
     return useQuery({
         queryKey: ["addresses", endpoint],
         queryFn: () => apiClient.get(endpoint),

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

@@ -103,3 +103,15 @@ export declare function listAdminSessions(params?: {
         recentActivity: number;
     };
 }>;
+export declare function listAdminNewsletterSubscribers(params?: {
+    filters?: string;
+    sorts?: string;
+    page?: number;
+    pageSize?: number;
+}): Promise<import("../../..").PagedResult<import("../../..").NewsletterSubscriberDocument>>;
+export declare function listAdminContactSubmissions(params?: {
+    filters?: string;
+    sorts?: string;
+    page?: number;
+    pageSize?: number;
+}): Promise<import("../../..").PagedResult<import("../server").ContactSubmissionDocument>>;

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

@@ -11,6 +11,8 @@ import { blogRepository } from "../../blog/repository/blog.repository";
 import { storeRepository } from "../../stores/repository/store.repository";
 import { bidRepository } from "../../auctions/repository/bid.repository";
 import { payoutRepository } from "../../payments/repository/payout.repository";
+import { newsletterRepository } from "../../../core/newsletter.repository";
+import { contactSubmissionsRepository } from "../../../core/contact-submissions.repository";
 import { formatMonthYear } from "../../../utils";
 import { ProductStatusValues } from "../../products/schemas";
 export async function getAdminDashboardStats() {
@@ -170,3 +172,19 @@ export async function listAdminSessions(params) {
         limit: params?.limit ?? 100,
     });
 }
+export async function listAdminNewsletterSubscribers(params) {
+    return newsletterRepository.list({
+        filters: params?.filters,
+        sorts: params?.sorts,
+        page: String(params?.page ?? 1),
+        pageSize: String(params?.pageSize ?? 50),
+    });
+}
+export async function listAdminContactSubmissions(params) {
+    return contactSubmissionsRepository.list({
+        filters: params?.filters,
+        sorts: params?.sorts,
+        page: String(params?.page ?? 1),
+        pageSize: String(params?.pageSize ?? 50),
+    });
+}

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

@@ -7,9 +7,20 @@ import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } fr
 import { AdminListingScaffold } from "./AdminListingScaffold";
 export function AdminBlogView({ children, ...props }) {
     const hasChildren = React.Children.count(children) > 0;
+    const [q, setQ] = React.useState("");
+    const [statusFilter, setStatusFilter] = React.useState("");
+    const [featuredFilter, setFeaturedFilter] = React.useState("");
+    const filterParts = [];
+    if (statusFilter && statusFilter !== "All")
+        filterParts.push(`status==${statusFilter}`);
+    if (featuredFilter === "Featured Only")
+        filterParts.push("isFeatured==true");
+    const filters = filterParts.join(",") || undefined;
     const { rows, total, isLoading, errorMessage } = useAdminListingData({
-        queryKey: ["admin", "blog", "listing"],
+        queryKey: ["admin", "blog", "listing", q, filters ?? ""],
         endpoint: ADMIN_ENDPOINTS.BLOG,
+        filters,
+        q,
         mapRows: (response) => toRecordArray(response.posts).map((item, index) => ({
             id: toStringValue(item.id, `post-${index}`),
             primary: toStringValue(item.title, "Untitled post"),
@@ -33,5 +44,18 @@ export function AdminBlogView({ children, ...props }) {
     if (hasChildren) {
         return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
     }
-    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Blog Publishing", subtitle: "Manage editorial drafts, featured placement, and publish readiness in the shared listing frame.", actionLabel: "New article", searchPlaceholder: "Search articles, authors, or tags", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No blog posts found", resultSummary: `Showing ${rows.length} of ${total} posts` }));
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Blog Publishing", subtitle: "Manage editorial drafts, featured placement, and publish readiness in the shared listing frame.", actionLabel: "New article", searchPlaceholder: "Search articles, authors, or tags", onSearch: setQ, searchValue: q, rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No blog posts found", resultSummary: `Showing ${rows.length} of ${total} posts`, filterGroups: [
+            {
+                title: "Status",
+                options: ["All", "published", "draft", "archived"],
+                active: statusFilter || "All",
+                onSelect: (opt) => setStatusFilter(opt === "All" ? "" : opt),
+            },
+            {
+                title: "Featured",
+                options: ["All", "Featured Only"],
+                active: featuredFilter || "All",
+                onSelect: (opt) => setFeaturedFilter(opt === "All" ? "" : opt),
+            },
+        ] }));
 }

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

@@ -7,9 +7,18 @@ import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } fr
 import { AdminListingScaffold } from "./AdminListingScaffold";
 export function AdminCarouselView({ children, ...props }) {
     const hasChildren = React.Children.count(children) > 0;
+    const [q, setQ] = React.useState("");
+    const [statusFilter, setStatusFilter] = React.useState("");
+    const filterParts = [];
+    if (statusFilter && statusFilter !== "All") {
+        filterParts.push(statusFilter === "Active" ? "active==true" : "active==false");
+    }
+    const filters = filterParts.join(",") || undefined;
     const { rows, total, isLoading, errorMessage } = useAdminListingData({
-        queryKey: ["admin", "carousel", "listing"],
+        queryKey: ["admin", "carousel", "listing", q, filters ?? ""],
         endpoint: `${HOMEPAGE_ENDPOINTS.CAROUSEL}?includeInactive=true`,
+        filters,
+        q,
         mapRows: (response) => {
             const sourceItems = Array.isArray(response.data)
                 ? response.data
@@ -36,5 +45,12 @@ export function AdminCarouselView({ children, ...props }) {
     if (hasChildren) {
         return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
     }
-    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Homepage Carousel", subtitle: "Manage hero slide ordering, activation state, and destination links in one listing workflow.", actionLabel: "New slide", searchPlaceholder: "Search slide titles or link URLs", rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No carousel slides found", resultSummary: `Showing ${rows.length} of ${total} slides` }));
+    return (_jsx(AdminListingScaffold, { portal: "admin", ...props, title: "Homepage Carousel", subtitle: "Manage hero slide ordering, activation state, and destination links in one listing workflow.", actionLabel: "New slide", searchPlaceholder: "Search slide titles or link URLs", onSearch: setQ, searchValue: q, rows: rows, isLoading: isLoading, errorMessage: errorMessage, emptyLabel: "No carousel slides found", resultSummary: `Showing ${rows.length} of ${total} slides`, filterGroups: [
+            {
+                title: "Status",
+                options: ["All", "Active", "Inactive"],
+                active: statusFilter || "All",
+                onSelect: (opt) => setStatusFilter(opt === "All" ? "" : opt),
+            },
+        ] }));
 }