@mohasinac/appkit 2.2.0 → 2.3.1

package/dist/features/admin/repository/site-settings.repository.js

@@ -4,6 +4,7 @@
  * Manages site-wide configuration settings (singleton document)
  */
 import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { cacheManager } from "../../../core";
 import { SITE_SETTINGS_COLLECTION, DEFAULT_SITE_SETTINGS_DATA, } from "../schemas";
 import { DatabaseError } from "../../../errors";
 import { decryptSecret, encryptSecret, maskSecret } from "../../../security";
@@ -20,6 +21,9 @@ export class SiteSettingsRepository extends BaseRepository {
          */
         this.SINGLETON_ID = "global";
     }
+    cacheKey() {
+        return `repo:site-settings:${this.SINGLETON_ID}`;
+    }
     /**
      * Get the global site settings
      * Creates default settings if not exists
@@ -27,6 +31,9 @@ export class SiteSettingsRepository extends BaseRepository {
      * @returns Promise<SiteSettingsDocument>
      */
     async getSingleton() {
+        const cached = cacheManager.get(this.cacheKey());
+        if (cached)
+            return cached;
         try {
             const doc = await this.db
                 .collection(this.collection)
@@ -44,9 +51,16 @@ export class SiteSettingsRepository extends BaseRepository {
                     .collection(this.collection)
                     .doc(this.SINGLETON_ID)
                     .set(prepareForFirestore(defaultSettings));
+                cacheManager.set(this.cacheKey(), defaultSettings, {
+                    ttl: SiteSettingsRepository.CACHE_TTL_MS,
+                });
                 return defaultSettings;
             }
-            return this.mapDoc(doc);
+            const mapped = this.mapDoc(doc);
+            cacheManager.set(this.cacheKey(), mapped, {
+                ttl: SiteSettingsRepository.CACHE_TTL_MS,
+            });
+            return mapped;
         }
         catch (error) {
             throw new DatabaseError(`Failed to retrieve site settings: ${error instanceof Error ? error.message : "Unknown error"}`);
@@ -63,6 +77,7 @@ export class SiteSettingsRepository extends BaseRepository {
      */
     async updateSingleton(updates) {
         try {
+            cacheManager.delete(this.cacheKey());
             let finalUpdates = updates;
             if (updates.credentials) {
                 const existing = await this.getSingleton();
@@ -85,7 +100,11 @@ export class SiteSettingsRepository extends BaseRepository {
                 .collection(this.collection)
                 .doc(this.SINGLETON_ID)
                 .update(updateData);
-            return await this.getSingleton();
+            const latest = await this.getSingleton();
+            cacheManager.set(this.cacheKey(), latest, {
+                ttl: SiteSettingsRepository.CACHE_TTL_MS,
+            });
+            return latest;
         }
         catch (error) {
             throw new DatabaseError(`Failed to update site settings: ${error instanceof Error ? error.message : "Unknown error"}`);
@@ -207,8 +226,12 @@ export class SiteSettingsRepository extends BaseRepository {
             .collection(this.collection)
             .doc(this.SINGLETON_ID)
             .set(prepareForFirestore(defaultSettings));
+        cacheManager.set(this.cacheKey(), defaultSettings, {
+            ttl: SiteSettingsRepository.CACHE_TTL_MS,
+        });
         return defaultSettings;
     }
 }
+SiteSettingsRepository.CACHE_TTL_MS = 60000;
 // Export singleton instance
 export const siteSettingsRepository = new SiteSettingsRepository();

package/dist/features/admin/schemas/firestore.d.ts

@@ -288,6 +288,10 @@ export interface SiteSettingsDocument {
         };
         newsletterEnabled?: boolean;
     };
+    announcementBar?: {
+        enabled: boolean;
+        message: string;
+    };
     /** Encrypted provider credentials � never return raw to the client. */
     credentials?: SiteSettingsCredentials;
     featuredResults?: FeaturedResult[];
@@ -305,7 +309,7 @@ export interface FeatureFlagMeta {
 export declare const SITE_SETTINGS_COLLECTION: "siteSettings";
 export declare const SITE_SETTINGS_INDEXED_FIELDS: readonly [];
 export declare const DEFAULT_SITE_SETTINGS_DATA: Partial<SiteSettingsDocument>;
-export declare const SITE_SETTINGS_PUBLIC_FIELDS: readonly ["siteName", "motto", "logo", "background", "contact.email", "contact.phone", "payment", "commissions", "socialLinks", "seo", "features", "featureFlags", "faq.variables"];
+export declare const SITE_SETTINGS_PUBLIC_FIELDS: readonly ["siteName", "motto", "logo", "background", "contact.email", "contact.phone", "payment", "commissions", "socialLinks", "seo", "features", "featureFlags", "faq.variables", "announcementBar"];
 export type SiteSettingsUpdateInput = Partial<Omit<SiteSettingsDocument, "id" | "createdAt" | "updatedAt">>;
 export declare const DEFAULT_TRUST_BAR_ITEMS: TrustBarItem[];
 export declare const FEATURE_FLAG_META: FeatureFlagMeta[];

package/dist/features/admin/schemas/firestore.js

@@ -163,6 +163,10 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
     returns: {
         windowDays: 7,
     },
+    announcementBar: {
+        enabled: true,
+        message: "🎉 Up to 15% Off on Pokémon TCG this week — Use code SAVE15",
+    },
 };
 export const SITE_SETTINGS_PUBLIC_FIELDS = [
     "siteName",
@@ -178,6 +182,7 @@ export const SITE_SETTINGS_PUBLIC_FIELDS = [
     "features",
     "featureFlags",
     "faq.variables",
+    "announcementBar",
 ];
 export const DEFAULT_TRUST_BAR_ITEMS = [
     { icon: "??", label: "Free Shipping", visible: true },

package/dist/features/admin/server.d.ts

@@ -3,7 +3,6 @@
  *
  * Server-only entry point for admin API route handlers.
  */
-import "server-only";
 export * from "./actions";
 export { notificationRepository } from "./repository/notification.repository";
 export { chatRepository } from "./repository/chat.repository";

package/dist/features/admin/server.js

@@ -3,7 +3,6 @@
  *
  * Server-only entry point for admin API route handlers.
  */
-import "server-only";
 export * from "./actions";
 export { notificationRepository } from "./repository/notification.repository";
 export { chatRepository } from "./repository/chat.repository";

package/dist/features/auctions/actions/bid-actions.js

@@ -14,7 +14,7 @@ import { maskPublicBid } from "../../../security";
 import { ERROR_MESSAGES, AuthorizationError, ValidationError, NotFoundError, } from "../../../errors";
 import { getDefaultCurrency } from "../../../core/baseline-resolver";
 import { resolveDate } from "../../../utils";
-// ─── Domain Functions ──────────────────────────────────────────────────────────
+// --- Domain Functions ----------------------------------------------------------
 export async function placeBid(userId, userEmail, input) {
     const { productId, bidAmount, autoMaxBid } = input;
     const product = await productRepository.findById(productId);

package/dist/features/auctions/api/route.js

@@ -20,7 +20,7 @@ function numParam(url, key, fallback) {
     const n = v !== null ? Number(v) : NaN;
     return Number.isFinite(n) ? n : fallback;
 }
-// ─── GET /api/bids ────────────────────────────────────────────────────────────
+// --- GET /api/bids ------------------------------------------------------------
 // Query params:
 //   auctionId — filter bids for a specific auction product (recommended)
 //   bidderId  — filter bids placed by a specific user

package/dist/features/auctions/columns/index.js

@@ -1,5 +1,5 @@
 import { buildColumns, } from "../../../ui/columns";
-// ─── Auction columns ──────────────────────────────────────────────────────────
+// --- Auction columns ----------------------------------------------------------
 /**
  * Default admin column definitions for an auction table.
  *
@@ -42,7 +42,7 @@ export const auctionAdminColumns = [
 export function buildAuctionColumns(opts) {
     return buildColumns(auctionAdminColumns, opts);
 }
-// ─── Bid columns ──────────────────────────────────────────────────────────────
+// --- Bid columns --------------------------------------------------------------
 export const bidAdminColumns = [
     { key: "bidderDisplayName", header: "Bidder" },
     {

package/dist/features/auctions/components/AuctionCard.js

@@ -4,6 +4,7 @@ import { useState, useEffect } from "react";
 import { Article, Button, Div, Heading, Row, Span, Text } from "../../../ui";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { getDefaultCurrency } from "../../../core/baseline-resolver";
+import { THEME_CONSTANTS } from "../../../tokens";
 function useCountdown(endsAt) {
     const [msLeft, setMsLeft] = useState(() => new Date(endsAt).getTime() - Date.now());
     useEffect(() => {
@@ -26,10 +27,10 @@ export function AuctionCountdown({ endsAt, className = "", labels = {}, }) {
         return (_jsx(Span, { className: `text-sm font-medium text-red-600 ${className}`, children: labels.ended ?? "Ended" }));
     }
     const pad = (n) => String(n).padStart(2, "0");
-    return (_jsxs(Row, { className: `gap-1 text-sm font-mono ${className}`, children: [_jsx(Span, { className: "rounded bg-gray-900 px-1.5 py-0.5 text-white", children: pad(countdown.h) }), _jsx(Span, { className: "text-gray-400", children: ":" }), _jsx(Span, { className: "rounded bg-gray-900 px-1.5 py-0.5 text-white", children: pad(countdown.m) }), _jsx(Span, { className: "text-gray-400", children: ":" }), _jsx(Span, { className: "rounded bg-gray-900 px-1.5 py-0.5 text-white", children: pad(countdown.s) })] }));
+    return (_jsxs(Row, { className: `gap-1 text-sm font-mono ${className}`, children: [_jsx(Span, { className: "rounded bg-gray-900 dark:bg-slate-700 px-1.5 py-0.5 text-white", children: pad(countdown.h) }), _jsx(Span, { className: "text-gray-400 dark:text-zinc-500", children: ":" }), _jsx(Span, { className: "rounded bg-gray-900 dark:bg-slate-700 px-1.5 py-0.5 text-white", children: pad(countdown.m) }), _jsx(Span, { className: "text-gray-400 dark:text-zinc-500", children: ":" }), _jsx(Span, { className: "rounded bg-gray-900 dark:bg-slate-700 px-1.5 py-0.5 text-white", children: pad(countdown.s) })] }));
 }
 export function AuctionCard({ auction, labels = {}, onBid, className = "", }) {
     const hasEnded = new Date(auction.auctionEndDate) <= new Date();
     const displayBid = auction.currentBid ?? auction.startingBid;
-    return (_jsxs(Article, { className: `rounded-xl border border-gray-200 bg-white overflow-hidden shadow-sm hover:shadow-md transition-shadow ${className}`, children: [auction.mainImage && (_jsxs(Div, { className: "aspect-square overflow-hidden relative", children: [_jsx(Div, { role: "img", "aria-label": auction.title, className: "h-full w-full bg-center bg-cover", style: { backgroundImage: `url(${auction.mainImage})` } }), _jsx(Span, { className: "absolute top-2 left-2 rounded-full bg-orange-500 px-2 py-0.5 text-xs font-bold text-white", children: "AUCTION" })] })), _jsxs(Div, { className: "p-4", children: [_jsx(Heading, { level: 3, className: "font-semibold text-gray-900 text-sm leading-snug mb-2 line-clamp-2", children: auction.title }), _jsxs(Row, { justify: "between", className: "mb-2", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-xs text-gray-400", children: labels.currentBid ?? "Current bid" }), _jsx(Text, { className: "text-base font-bold text-gray-900", children: formatCurrency(displayBid, auction.currency ?? getDefaultCurrency()) })] }), _jsx(Div, { className: "text-right", children: _jsxs(Text, { className: "text-xs text-gray-400", children: [auction.bidCount, " ", labels.bids ?? "bids"] }) })] }), _jsx(Div, { className: "mb-3", children: _jsx(AuctionCountdown, { endsAt: auction.auctionEndDate, labels: { ended: labels.ended } }) }), !hasEnded && onBid && (_jsx(Button, { type: "button", variant: "warning", onClick: () => onBid(auction), className: "w-full rounded-lg bg-orange-500 py-2 text-sm font-medium text-white hover:bg-orange-600 transition-colors", children: labels.placeBid ?? "Place Bid" }))] })] }));
+    return (_jsxs(Article, { className: `rounded-xl border border-gray-200 dark:border-slate-700 bg-white dark:bg-slate-900 overflow-hidden shadow-sm hover:shadow-md transition-shadow ${className}`, children: [auction.mainImage && (_jsxs(Div, { className: "aspect-square overflow-hidden relative", children: [_jsx(Div, { role: "img", "aria-label": auction.title, className: "h-full w-full bg-center bg-cover", style: { backgroundImage: `url(${auction.mainImage})` } }), _jsx(Span, { className: "absolute top-2 left-2 rounded-full bg-orange-500 px-2 py-0.5 text-xs font-bold text-white", children: "AUCTION" })] })), _jsxs(Div, { className: "p-4", children: [_jsx(Heading, { level: 3, className: `font-semibold text-gray-900 dark:text-zinc-100 text-sm leading-snug mb-2 ${THEME_CONSTANTS.utilities.textClamp2}`, children: auction.title }), _jsxs(Row, { justify: "between", className: "mb-2", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-xs text-gray-400 dark:text-zinc-500", children: labels.currentBid ?? "Current bid" }), _jsx(Text, { className: "text-base font-bold text-gray-900 dark:text-zinc-100", children: formatCurrency(displayBid, getDefaultCurrency()) })] }), _jsx(Div, { className: "text-right", children: _jsxs(Text, { className: "text-xs text-gray-400 dark:text-zinc-500", children: [auction.bidCount, " ", labels.bids ?? "bids"] }) })] }), _jsx(Div, { className: "mb-3", children: _jsx(AuctionCountdown, { endsAt: auction.auctionEndDate, labels: { ended: labels.ended } }) }), !hasEnded && onBid && (_jsx(Button, { type: "button", variant: "warning", onClick: () => onBid(auction), className: "w-full rounded-lg bg-orange-500 py-2 text-sm font-medium text-white hover:bg-orange-600 transition-colors", children: labels.placeBid ?? "Place Bid" }))] })] }));
 }

package/dist/features/auctions/components/AuctionDetailPageView.d.ts

@@ -0,0 +1,4 @@
+export interface AuctionDetailPageViewProps {
+    id: string;
+}
+export declare function AuctionDetailPageView({ id }: AuctionDetailPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;

package/dist/features/auctions/components/AuctionDetailPageView.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { productRepository } from "../../../repositories";
+import { listBidsByProduct } from "../../auctions/actions/bid-actions";
+import { ROUTES } from "../../../next";
+import { getDefaultCurrency } from "../../../core/baseline-resolver";
+import { Button, Container, Div, Heading, Input, Main, Row, Section, Span, Stack, Text, } from "../../../ui";
+import { AuctionDetailView } from "../../products/components/AuctionDetailView";
+import { BidHistory } from "../../products/components/BidHistory";
+import { RelatedProducts } from "../../products/components/RelatedProducts";
+import { MarketplaceAuctionGrid } from "./MarketplaceAuctionGrid";
+export async function AuctionDetailPageView({ id }) {
+    const [product, bidsResult] = await Promise.all([
+        productRepository.findByIdOrSlug(id).catch(() => undefined),
+        listBidsByProduct(id, { pageSize: 20 }).catch(() => null),
+    ]);
+    const relatedDocs = product
+        ? await productRepository
+            .findByCategory(product.category ?? "")
+            .catch(() => [])
+        : [];
+    if (!product) {
+        return (_jsx(Main, { children: _jsx(Section, { className: "py-20", children: _jsx(Container, { size: "md", children: _jsxs(Stack, { align: "center", gap: "md", className: "text-center", children: [_jsx(Heading, { level: 1, className: "text-2xl font-semibold text-zinc-900 dark:text-zinc-50", children: "Auction Not Found" }), _jsx(Text, { className: "text-zinc-500", children: "This auction may have ended or the link is incorrect." }), _jsx(Link, { href: String(ROUTES.PUBLIC.AUCTIONS), className: "text-sm font-medium text-primary-600 hover:underline", children: "Browse Auctions" })] }) }) }) }));
+    }
+    const p = product;
+    const currency = p.currency || getDefaultCurrency();
+    const currentBid = typeof p.currentBid === "number" ? p.currentBid : p.startingBid ?? p.price ?? 0;
+    const currentBidFormatted = new Intl.NumberFormat(undefined, {
+        style: "currency",
+        currency,
+    }).format(currentBid);
+    const startingBidFormatted = new Intl.NumberFormat(undefined, {
+        style: "currency",
+        currency,
+    }).format(p.startingBid ?? p.price ?? 0);
+    const images = Array.isArray(p.images) ? p.images : p.imageUrl ? [p.imageUrl] : [];
+    const primaryImage = images[0];
+    const endDate = p.auctionEndDate ? new Date(p.auctionEndDate) : null;
+    const isEnded = endDate ? endDate < new Date() : false;
+    const bidCount = typeof p.bidCount === "number" ? p.bidCount : 0;
+    return (_jsx(AuctionDetailView, { renderGallery: () => primaryImage ? (_jsx(Div, { className: "overflow-hidden rounded-xl border border-zinc-100 dark:border-zinc-800", children: _jsx(Div, { role: "img", "aria-label": p.title ?? p.name ?? "Auction item", className: "aspect-square w-full bg-cover bg-center", style: { backgroundImage: `url(${primaryImage})` } }) })) : (_jsx(Div, { className: "overflow-hidden rounded-xl border border-zinc-100 bg-zinc-50 dark:border-zinc-800 dark:bg-zinc-900", children: _jsx(Div, { className: "flex aspect-square items-center justify-center text-zinc-300 dark:text-zinc-700", children: _jsxs("svg", { width: "64", height: "64", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.5", "aria-hidden": "true", children: [_jsx("rect", { x: "3", y: "3", width: "18", height: "18", rx: "2" }), _jsx("circle", { cx: "8.5", cy: "8.5", r: "1.5" }), _jsx("path", { d: "M21 15l-5-5L5 21" })] }) }) })), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 1, className: "text-2xl font-bold text-zinc-900 dark:text-zinc-50", children: p.title ?? p.name ?? "Auction Item" }), _jsxs(Row, { align: "center", gap: "sm", wrap: true, children: [_jsx(Span, { className: "text-2xl font-semibold text-primary-600 dark:text-primary-400", children: currentBidFormatted }), _jsxs(Span, { className: "text-sm text-zinc-500", children: [bidCount, " ", bidCount === 1 ? "bid" : "bids"] }), isEnded && (_jsx(Span, { className: "rounded-full bg-red-100 px-2.5 py-0.5 text-xs font-medium text-red-700 dark:bg-red-900/30 dark:text-red-400", children: "Ended" }))] }), endDate && !isEnded && (_jsxs(Text, { className: "text-sm text-zinc-600 dark:text-zinc-400", children: ["Ends: ", endDate.toLocaleString()] })), p.description && (_jsx(Text, { className: "text-sm leading-relaxed text-zinc-600 dark:text-zinc-400", children: typeof p.description === "string" ? p.description : "" })), p.sellerName && (_jsxs(Row, { align: "center", gap: "xs", children: [_jsx(Span, { className: "text-xs text-zinc-500", children: "Listed by" }), _jsx(Span, { className: "text-xs font-medium text-zinc-700 dark:text-zinc-300", children: p.sellerName })] }))] })), renderBidForm: () => (_jsx(Div, { className: "rounded-xl border border-zinc-100 bg-zinc-50 p-5 dark:border-zinc-800 dark:bg-zinc-900", children: _jsxs(Stack, { gap: "sm", children: [_jsxs(Text, { className: "text-sm font-medium text-zinc-700 dark:text-zinc-300", children: ["Current bid: ", currentBidFormatted] }), _jsxs(Text, { className: "text-xs text-zinc-500", children: ["Starting bid: ", startingBidFormatted] }), _jsx(Input, { type: "number", placeholder: `Minimum bid`, min: currentBid + 1, "aria-label": "Your bid amount", disabled: isEnded }), _jsx(Button, { variant: "primary", size: "md", className: "w-full", disabled: isEnded, children: isEnded ? "Auction Ended" : "Place Bid" })] }) })), renderMobileBidForm: () => !isEnded ? (_jsx(Div, { className: "rounded-xl border border-zinc-100 bg-zinc-50 p-4 dark:border-zinc-800 dark:bg-zinc-900 lg:hidden", children: _jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Span, { className: "text-base font-semibold text-primary-600", children: currentBidFormatted }), _jsxs(Span, { className: "text-xs text-zinc-500", children: [bidCount, " bids"] })] }), _jsx(Button, { variant: "primary", size: "md", className: "w-full", children: "Place Bid" })] }) })) : null, renderBidHistory: () => {
+            const bids = (bidsResult?.items ?? []).map((b) => ({
+                id: b.id,
+                bidderId: b.userId ?? b.bidderId ?? "",
+                bidderName: b.bidderName ?? b.userName,
+                amount: b.bidAmount ?? b.amount ?? 0,
+                placedAt: b.createdAt ?? b.bidAt ?? "",
+            }));
+            return (_jsx(BidHistory, { bids: bids, isEmpty: bids.length === 0, labels: { title: "Bid History" } }));
+        }, renderRelated: () => {
+            const related = relatedDocs
+                .filter((r) => r.id !== product.id && r.isAuction !== false)
+                .slice(0, 4)
+                .map((r) => ({
+                id: String(r.id ?? ""),
+                title: String(r.name ?? r.title ?? "Auction Item"),
+                price: typeof r.price === "number" ? r.price : 0,
+                currency: typeof r.currency === "string" ? r.currency : undefined,
+                mainImage: Array.isArray(r.images) ? r.images[0] : typeof r.imageUrl === "string" ? r.imageUrl : undefined,
+                isAuction: true,
+                auctionEndDate: r.auctionEndDate,
+                startingBid: typeof r.startingBid === "number" ? r.startingBid : undefined,
+                currentBid: typeof r.currentBid === "number" ? r.currentBid : undefined,
+                bidCount: typeof r.bidCount === "number" ? r.bidCount : undefined,
+                slug: typeof r.slug === "string" ? r.slug : undefined,
+            }));
+            if (related.length === 0)
+                return null;
+            return (_jsx(RelatedProducts, { labels: { title: "Similar Auctions" }, renderGrid: () => (_jsx(MarketplaceAuctionGrid, { auctions: related, gridClassName: "grid grid-cols-2 gap-4 sm:grid-cols-3 lg:grid-cols-4" })) }));
+        } }));
+}

package/dist/features/auctions/components/AuctionsListView.d.ts

@@ -0,0 +1 @@
+export declare function AuctionsListView(): Promise<import("react/jsx-runtime").JSX.Element>;

package/dist/features/auctions/components/AuctionsListView.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { productRepository } from "../../../repositories";
+import { Container, Heading, Main, Section } from "../../../ui";
+import { AdSlot } from "../../homepage/components/AdSlot";
+import { AuctionsIndexListing } from "../../products/components/AuctionsIndexListing";
+export async function AuctionsListView() {
+    const result = await productRepository
+        .list({
+        filters: "status==published,isAuction==true",
+        sorts: "auctionEndDate",
+        page: 1,
+        pageSize: 24,
+    })
+        .catch(() => null);
+    const initial = result ?? null;
+    return (_jsx(Main, { children: _jsx(Section, { className: "py-10", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-8 text-3xl font-semibold text-zinc-900", children: "Live Auctions" }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(AuctionsIndexListing, { initialData: initial }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
+}

package/dist/features/auctions/components/MarketplaceAuctionCard.js

@@ -8,7 +8,10 @@ import { useWishlistToggle } from "../../wishlist";
 import { useCountdown } from "../../../react";
 import { ROUTES } from "../../../next";
 import { formatCurrency } from "../../../utils";
-import { BaseListingCard, Button, Caption, Div, Row, Span, Text, TextLink, } from "../../../ui";
+import { getDefaultCurrency } from "../../../core/baseline-resolver";
+import { BaseListingCard, Button, Caption, Div, RichText, Row, Span, Text, TextLink, } from "../../../ui";
+import { normalizeRichTextHtml } from "../../../utils/string.formatter";
+import { THEME_CONSTANTS } from "../../../tokens";
 const DEFAULT_LABELS = {
     selectItem: "Select item",
     deselectItem: "Deselect item",
@@ -108,5 +111,5 @@ export function MarketplaceAuctionCard({ product, buyoutPrice, className = "", v
             : "bg-emerald-50 text-emerald-700";
     return (_jsxs(BaseListingCard, { isSelected: isSelected, isDisabled: isEnded, variant: baseVariant, className: className, children: [_jsxs(BaseListingCard.Hero, { aspect: "square", variant: baseVariant, onMouseEnter: () => setHovered(true), onMouseLeave: () => setHovered(false), children: [_jsx(TextLink, { href: auctionHref, className: "absolute inset-0 block", children: _jsx(MediaImage, { src: currentSrc, alt: product.title, size: "card", fallback: "Auction image", className: `transition-transform duration-500 ${hovered && images.length > 1 ? "scale-105" : "scale-100"}` }) }), hasVideo && imageIndex === 0 ? (_jsx(Div, { className: "absolute right-2 top-2", children: _jsx(Span, { className: "flex h-8 w-8 items-center justify-center rounded-full bg-black/50 text-white", children: _jsx(Play, { className: "h-4 w-4", "aria-label": mergedLabels.videoLabel }) }) })) : null, images.length > 1 ? (_jsx(Div, { className: "pointer-events-none absolute bottom-2 left-1/2 flex -translate-x-1/2 gap-1", children: images.map((_, index) => (_jsx(Span, { className: `rounded-full transition-all duration-200 ${index === imageIndex ? "h-1.5 w-3 bg-white" : "h-1.5 w-1.5 bg-white/60"}` }, `${product.id}-image-${index}`))) })) : null, product.featured ? (_jsx(Div, { className: "pointer-events-none absolute left-2 top-2 z-10", children: _jsx(Star, { className: "h-5 w-5 fill-amber-400 text-amber-400" }) })) : null, selectable ? (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: handleSelect, label: isSelected ? mergedLabels.deselectItem : mergedLabels.selectItem })) : null, _jsxs(Div, { className: `absolute left-2 z-10 flex flex-col gap-1 ${product.featured ? "top-8" : "top-2"}`, children: [!isEnded ? (_jsx(Span, { className: "rounded-full bg-rose-600/90 px-2 py-0.5 text-xs font-bold text-white", children: mergedLabels.liveBadge })) : null, isEndingSoon ? (_jsx(Span, { className: "rounded-full bg-amber-500/90 px-2 py-0.5 text-xs font-bold text-white", children: mergedLabels.endingSoon })) : null, isEnded ? (_jsx(Span, { className: "rounded-full bg-zinc-600/90 px-2 py-0.5 text-xs font-bold text-white", children: mergedLabels.ended })) : null, product.status === "sold" ? (_jsx(Span, { className: "rounded-full bg-zinc-700/90 px-2 py-0.5 text-xs font-bold text-white", children: mergedLabels.sold })) : null] }), _jsx(Div, { className: "pointer-events-none absolute bottom-2 right-2 z-10", children: _jsxs(Span, { className: "inline-flex items-center gap-1 rounded-full bg-amber-600/90 px-2 py-0.5 text-xs font-semibold text-white", children: [_jsx(Gavel, { className: "h-3 w-3" }), mergedLabels.typeBadge] }) })] }), _jsxs(BaseListingCard.Info, { variant: baseVariant, children: [_jsxs(Div, { className: "flex items-start gap-2", children: [_jsx(TextLink, { href: auctionHref, className: "min-w-0 flex-1 text-sm font-medium leading-snug text-zinc-900 transition-colors hover:text-primary", children: product.title }), wishlistActions ? (_jsx(Button, { type: "button", variant: "ghost", onClick: handleWishlist, disabled: wishlistLoading, "aria-label": inWishlist
                                     ? mergedLabels.removeFromWishlist
-                                    : mergedLabels.addToWishlist, className: "-mt-0.5 rounded-full p-1", children: _jsx(Heart, { className: `h-4 w-4 ${inWishlist ? "fill-rose-500 text-rose-500" : "text-zinc-400"}` }) })) : null] }), variant === "list" && product.description ? (_jsx(Text, { className: "line-clamp-2 text-xs text-zinc-500", children: product.description })) : null, _jsxs(Div, { children: [_jsx(Caption, { children: hasCurrentBid ? mergedLabels.currentBid : mergedLabels.startingBid }), _jsx(Text, { className: "text-base font-bold leading-none text-primary", children: formatCurrency(displayBid, product.currency) })] }), _jsxs(Row, { wrap: true, justify: "between", gap: "sm", className: "gap-x-2 gap-y-1", children: [_jsxs(Div, { className: `inline-flex items-center gap-1 rounded-full px-2.5 py-1 text-xs font-semibold ${countdownClass}`, children: [_jsx(Clock, { className: "h-3 w-3" }), _jsx(Span, { children: formatCountdownLabel(remaining, mergedLabels.ended) })] }), _jsx(Caption, { children: mergedLabels.totalBids(bidCount) })] }), _jsx(Row, { wrap: true, gap: "xs", className: "mt-auto", children: isEnded ? (_jsx(Button, { type: "button", variant: "ghost", size: "sm", className: "flex-1 cursor-not-allowed gap-1 px-2 text-xs opacity-60", disabled: true, children: _jsx(Span, { children: mergedLabels.ended }) })) : (_jsxs(_Fragment, { children: [_jsxs(Button, { type: "button", variant: "warning", size: "sm", className: "flex-1 gap-1 px-2 text-xs", onClick: handleNavigate, children: [_jsx(Gavel, { className: "h-3 w-3" }), _jsx(Span, { children: mergedLabels.placeBid })] }), resolvedBuyoutPrice ? (_jsxs(Button, { type: "button", variant: "danger", size: "sm", className: "flex-1 gap-1 px-2 text-xs", onClick: handleNavigate, children: [_jsx(ShoppingBag, { className: "h-3 w-3" }), _jsx(Span, { children: mergedLabels.buyout })] })) : null] })) })] })] }));
+                                    : mergedLabels.addToWishlist, className: "-mt-0.5 rounded-full p-1", children: _jsx(Heart, { className: `h-4 w-4 ${inWishlist ? "fill-rose-500 text-rose-500" : "text-zinc-400"}` }) })) : null] }), variant === "list" && product.description ? (_jsx(RichText, { html: normalizeRichTextHtml(product.description), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: `${THEME_CONSTANTS.utilities.textClamp2} text-xs text-zinc-500` })) : null, _jsxs(Div, { children: [_jsx(Caption, { children: hasCurrentBid ? mergedLabels.currentBid : mergedLabels.startingBid }), _jsx(Text, { className: "text-base font-bold leading-none text-primary", children: formatCurrency(displayBid, getDefaultCurrency()) })] }), _jsxs(Row, { wrap: true, justify: "between", gap: "sm", className: "gap-x-2 gap-y-1", children: [_jsxs(Div, { className: `inline-flex items-center gap-1 rounded-full px-2.5 py-1 text-xs font-semibold ${countdownClass}`, children: [_jsx(Clock, { className: "h-3 w-3" }), _jsx(Span, { children: formatCountdownLabel(remaining, mergedLabels.ended) })] }), _jsx(Caption, { children: mergedLabels.totalBids(bidCount) })] }), _jsx(Row, { wrap: true, gap: "xs", className: "mt-auto", children: isEnded ? (_jsx(Button, { type: "button", variant: "ghost", size: "sm", className: "flex-1 cursor-not-allowed gap-1 px-2 text-xs opacity-60", disabled: true, children: _jsx(Span, { children: mergedLabels.ended }) })) : (_jsxs(_Fragment, { children: [_jsxs(Button, { type: "button", variant: "warning", size: "sm", className: "flex-1 gap-1 px-2 text-xs", onClick: handleNavigate, children: [_jsx(Gavel, { className: "h-3 w-3" }), _jsx(Span, { children: mergedLabels.placeBid })] }), resolvedBuyoutPrice ? (_jsxs(Button, { type: "button", variant: "danger", size: "sm", className: "flex-1 gap-1 px-2 text-xs", onClick: handleNavigate, children: [_jsx(ShoppingBag, { className: "h-3 w-3" }), _jsx(Span, { children: mergedLabels.buyout })] })) : null] })) })] })] }));
 }

package/dist/features/auctions/components/MarketplaceAuctionGrid.js

@@ -1,4 +1,3 @@
-"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Gavel } from "lucide-react";
 import { Div, Row, Stack, Text } from "../../../ui";

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

@@ -1,3 +1,6 @@
 export { AuctionCard, AuctionCountdown } from "./AuctionCard";
 export { MarketplaceAuctionCard, type MarketplaceAuctionCardData, type MarketplaceAuctionCardLabels, type MarketplaceAuctionCardProps, } from "./MarketplaceAuctionCard";
 export { MarketplaceAuctionGrid, type MarketplaceAuctionGridLabels, type MarketplaceAuctionGridProps, } from "./MarketplaceAuctionGrid";
+export { AuctionsListView } from "./AuctionsListView";
+export { AuctionDetailPageView } from "./AuctionDetailPageView";
+export type { AuctionDetailPageViewProps } from "./AuctionDetailPageView";

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

@@ -1,3 +1,5 @@
 export { AuctionCard, AuctionCountdown } from "./AuctionCard";
 export { MarketplaceAuctionCard, } from "./MarketplaceAuctionCard";
 export { MarketplaceAuctionGrid, } from "./MarketplaceAuctionGrid";
+export { AuctionsListView } from "./AuctionsListView";
+export { AuctionDetailPageView } from "./AuctionDetailPageView";

package/dist/features/auctions/hooks/useAuctions.js

@@ -1,4 +1,3 @@
-"use client";
 import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { AUCTION_ENDPOINTS, BID_ENDPOINTS, PRODUCT_ENDPOINTS } from "../../../constants/api-endpoints";

package/dist/features/auctions/hooks/usePlaceBid.js

@@ -1,4 +1,3 @@
-"use client";
 import { useMutation, useQueryClient } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { BID_ENDPOINTS } from "../../../constants/api-endpoints";

package/dist/features/auctions/repository/bid.repository.js

@@ -3,7 +3,7 @@
  *
  * Data access layer for bid documents in Firestore
  */
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BaseRepository, getFirestoreCount, prepareForFirestore, } from "../../../providers/db-firebase";
 import { DatabaseError } from "../../../errors";
 import { BID_COLLECTION, createBidId } from "../schemas";
 import { encryptPiiFields, decryptPiiFields, BID_PII_FIELDS, } from "../../../security";
@@ -292,12 +292,7 @@ export class BidRepository extends BaseRepository {
      */
     async countByProduct(productId) {
         try {
-            const snapshot = await this.db
-                .collection(this.collection)
-                .where("productId", "==", productId)
-                .count()
-                .get();
-            return snapshot.data().count;
+            return await getFirestoreCount(this.db.collection(this.collection).where("productId", "==", productId));
         }
         catch (error) {
             throw new DatabaseError(`Failed to count bids for product: ${productId}`, error);
@@ -308,12 +303,7 @@ export class BidRepository extends BaseRepository {
      */
     async countByUser(userId) {
         try {
-            const snapshot = await this.db
-                .collection(this.collection)
-                .where("userId", "==", userId)
-                .count()
-                .get();
-            return snapshot.data().count;
+            return await getFirestoreCount(this.db.collection(this.collection).where("userId", "==", userId));
         }
         catch (error) {
             throw new DatabaseError(`Failed to count bids for user: ${userId}`, error);

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

@@ -27,13 +27,13 @@ export declare const auctionItemSchema: z.ZodObject<{
         alt: z.ZodOptional<z.ZodString>;
         thumbnailUrl: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        type: "video" | "image" | "file";
         url: string;
+        type: "video" | "image" | "file";
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
     }, {
-        type: "video" | "image" | "file";
         url: string;
+        type: "video" | "image" | "file";
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
     }>, "many">>;
@@ -53,56 +53,56 @@ export declare const auctionItemSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     id: string;
+    title: string;
+    status: "draft" | "published" | "archived" | "sold";
     createdAt: string;
     updatedAt: string;
     sellerId: string;
-    status: "draft" | "published" | "archived" | "sold";
     currency: string;
-    title: string;
-    price: number;
-    isAuction: true;
     slug: string;
     featured: boolean;
-    auctionEndDate: string;
+    price: number;
+    isAuction: true;
     startingBid: number;
     bidCount: number;
+    auctionEndDate: string;
     media?: {
-        type: "video" | "image" | "file";
         url: string;
+        type: "video" | "image" | "file";
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
     }[] | undefined;
+    images?: string[] | undefined;
     description?: string | undefined;
-    storeId?: string | undefined;
     storeSlug?: string | undefined;
-    images?: string[] | undefined;
+    storeId?: string | undefined;
     mainImage?: string | undefined;
     currentBid?: number | undefined;
 }, {
     id: string;
+    title: string;
+    status: "draft" | "published" | "archived" | "sold";
     createdAt: string;
     updatedAt: string;
     sellerId: string;
-    status: "draft" | "published" | "archived" | "sold";
     currency: string;
-    title: string;
-    price: number;
-    isAuction: true;
     slug: string;
     featured: boolean;
-    auctionEndDate: string;
+    price: number;
+    isAuction: true;
     startingBid: number;
     bidCount: number;
+    auctionEndDate: string;
     media?: {
-        type: "video" | "image" | "file";
         url: string;
+        type: "video" | "image" | "file";
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
     }[] | undefined;
+    images?: string[] | undefined;
     description?: string | undefined;
-    storeId?: string | undefined;
     storeSlug?: string | undefined;
-    images?: string[] | undefined;
+    storeId?: string | undefined;
     mainImage?: string | undefined;
     currentBid?: number | undefined;
 }>;
@@ -119,18 +119,18 @@ export declare const bidRecordSchema: z.ZodObject<{
     id: string;
     amount: number;
     currency: string;
+    bidderId: string;
     isWinning: boolean;
     auctionId: string;
-    bidderId: string;
     placedAt: string;
     bidderDisplayName?: string | undefined;
 }, {
     id: string;
     amount: number;
     currency: string;
+    bidderId: string;
     isWinning: boolean;
     auctionId: string;
-    bidderId: string;
     placedAt: string;
     bidderDisplayName?: string | undefined;
 }>;
@@ -142,14 +142,14 @@ export declare const auctionListParamsSchema: z.ZodObject<{
     filters: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     sort?: string | undefined;
+    page?: number | undefined;
     pageSize?: number | undefined;
     filters?: string | undefined;
-    page?: number | undefined;
     storeSlug?: string | undefined;
 }, {
     sort?: string | undefined;
+    page?: number | undefined;
     pageSize?: number | undefined;
     filters?: string | undefined;
-    page?: number | undefined;
     storeSlug?: string | undefined;
 }>;

package/dist/features/auctions/schemas/index.js

@@ -1,14 +1,14 @@
 export * from "./firestore";
 import { z } from "zod";
 import { mediaFieldSchema } from "../../media/types/index";
-// ─── Sub-schemas ──────────────────────────────────────────────────────────────
+// --- Sub-schemas --------------------------------------------------------------
 export const auctionStatusSchema = z.enum([
     "published",
     "draft",
     "archived",
     "sold",
 ]);
-// ─── Base item schema ─────────────────────────────────────────────────────────
+// --- Base item schema ---------------------------------------------------------
 /**
  * Base Zod schema for an auction item.
  * Apps can extend this to add their own fields:

package/dist/features/auctions/server.d.ts

@@ -3,7 +3,6 @@
  *
  * Server-only entry point for auction API route handlers.
  */
-import "server-only";
 export * from "./actions";
 export { AuctionsRepository } from "./repository/auctions.repository";
 export { bidRepository } from "./repository/bid.repository";

package/dist/features/auctions/server.js

@@ -3,7 +3,6 @@
  *
  * Server-only entry point for auction API route handlers.
  */
-import "server-only";
 export * from "./actions";
 export { AuctionsRepository } from "./repository/auctions.repository";
 export { bidRepository } from "./repository/bid.repository";

package/dist/features/auth/api/route.js

@@ -9,7 +9,7 @@
 import { NextResponse } from "next/server.js";
 import { createRouteHandler } from "../../../next";
 import { getProviders } from "../../../contracts";
-// ─── Transform ────────────────────────────────────────────────────────────────
+// --- Transform ----------------------------------------------------------------
 function toClientUser(u) {
     return {
         id: u.uid,
@@ -20,7 +20,7 @@ function toClientUser(u) {
         isEmailVerified: u.emailVerified,
     };
 }
-// ─── GET /api/auth/me ─────────────────────────────────────────────────────────
+// --- GET /api/auth/me ---------------------------------------------------------
 /**
  * Return the currently authenticated user's profile.
  * Reads the `__session` HTTP-only cookie → verifies via ISessionProvider →

package/dist/features/auth/components/AuthStatusPanel.js

@@ -1,11 +1,11 @@
-"use client";
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { Div, Heading, Text } from "../../../ui";
+import { THEME_CONSTANTS } from "../../../tokens";
 function toneClass(tone) {
     if (tone === "success")
-        return "text-green-500 dark:text-green-400";
+        return THEME_CONSTANTS.themed.textSuccess;
     if (tone === "error")
-        return "text-red-500 dark:text-red-400";
+        return THEME_CONSTANTS.themed.textError;
     return "text-primary";
 }
 function iconPath(tone) {