@mohasinac/appkit 2.2.0 → 2.3.0

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

@@ -1,37 +0,0 @@
-"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";
-import { MarketplaceAuctionCard, } from "./MarketplaceAuctionCard";
-const DEFAULT_GRID_LABELS = {
-    emptyTitle: "No auctions found",
-    emptyDescription: "Check back later for live listings.",
-};
-function AuctionCardSkeleton({ variant = "grid", }) {
-    if (variant === "list") {
-        return (_jsxs(Div, { className: "flex min-h-[220px] flex-row overflow-hidden rounded-xl bg-zinc-200 animate-pulse", children: [_jsx(Div, { className: "aspect-square w-40 flex-shrink-0 bg-zinc-300" }), _jsxs(Div, { className: "flex-1 space-y-2 p-3", children: [_jsx(Div, { className: "h-4 w-2/3 rounded bg-zinc-300" }), _jsx(Div, { className: "h-3 w-full rounded bg-zinc-300" }), _jsx(Div, { className: "h-3 w-3/4 rounded bg-zinc-300" }), _jsx(Div, { className: "h-5 w-1/2 rounded bg-zinc-300" }), _jsxs(Row, { gap: "sm", children: [_jsx(Div, { className: "h-8 flex-1 rounded bg-zinc-300" }), _jsx(Div, { className: "h-8 flex-1 rounded bg-zinc-300" })] })] })] }));
-    }
-    return (_jsxs(Div, { className: "overflow-hidden rounded-xl bg-zinc-200 animate-pulse", children: [_jsx(Div, { className: "aspect-square bg-zinc-300" }), _jsxs(Div, { className: "space-y-2 p-3", children: [_jsx(Div, { className: "h-4 w-3/4 rounded bg-zinc-300" }), _jsx(Div, { className: "h-3 w-1/3 rounded bg-zinc-300" }), _jsx(Div, { className: "h-5 w-1/2 rounded bg-zinc-300" }), _jsxs(Row, { justify: "between", children: [_jsx(Div, { className: "h-3 w-1/4 rounded bg-zinc-300" }), _jsx(Div, { className: "h-3 w-1/3 rounded bg-zinc-300" })] }), _jsx(Row, { gap: "sm", children: _jsx(Div, { className: "h-8 flex-1 rounded bg-zinc-300" }) })] })] }));
-}
-export function MarketplaceAuctionGrid({ auctions, loading = false, skeletonCount = 12, variant = "grid", selectable = false, selectedIds = [], onSelectionChange, gridClassName, emptyIcon, labels, cardLabels, wishlistActions, }) {
-    const mergedLabels = { ...DEFAULT_GRID_LABELS, ...labels };
-    const handleSelect = (id, selected) => {
-        if (!onSelectionChange)
-            return;
-        if (selected) {
-            onSelectionChange([...selectedIds, id]);
-            return;
-        }
-        onSelectionChange(selectedIds.filter((selectedId) => selectedId !== id));
-    };
-    const containerClass = variant === "list"
-        ? "flex flex-col gap-4"
-        : `${gridClassName ?? "grid grid-cols-1 gap-6 sm:grid-cols-2 xl:grid-cols-4"}`;
-    if (loading) {
-        return (_jsx(Div, { className: containerClass, children: Array.from({ length: skeletonCount }).map((_, index) => (_jsx(AuctionCardSkeleton, { variant: variant }, `auction-skeleton-${index}`))) }));
-    }
-    if (auctions.length === 0) {
-        return (_jsxs(Stack, { align: "center", gap: "3", className: "justify-center py-24 text-center", children: [emptyIcon ?? _jsx(Gavel, { className: "h-16 w-16" }), _jsx(Text, { className: "text-xl font-medium text-zinc-900", children: mergedLabels.emptyTitle }), _jsx(Text, { className: "text-sm text-zinc-500", children: mergedLabels.emptyDescription })] }));
-    }
-    return (_jsx(Div, { className: containerClass, children: auctions.map((auction) => (_jsx(MarketplaceAuctionCard, { product: auction, variant: variant, selectable: selectable, isSelected: selectedIds.includes(auction.id), onSelect: handleSelect, labels: cardLabels, wishlistActions: wishlistActions }, auction.id))) }));
-}

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

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

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

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

package/dist/features/auctions/hooks/useAuctions.d.ts

@@ -1,50 +0,0 @@
-import type { AuctionListResponse, AuctionListParams, AuctionItem, PublicBid } from "../types";
-import type { ProductItem } from "../../products/types";
-type AuctionListQuery = AuctionListParams | URLSearchParams | string;
-interface UseAuctionsOptions {
-    enabled?: boolean;
-    endpoint?: string;
-    initialData?: AuctionListResponse;
-    queryKeyPrefix?: string;
-}
-interface UseAuctionDetailOptions {
-    enabled?: boolean;
-    productEndpoint?: string;
-    bidsEndpoint?: string;
-    refetchIntervalMs?: number;
-    productQueryKeyPrefix?: string;
-    bidsQueryKeyPrefix?: string;
-}
-export declare function useAuctions(params?: AuctionListQuery, opts?: UseAuctionsOptions): {
-    data: AuctionListResponse | undefined;
-    auctions: AuctionItem[];
-    total: number;
-    totalPages: number;
-    hasMore: boolean;
-    isLoading: boolean;
-    error: string | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<AuctionListResponse, Error>>;
-};
-export declare function useAuction(slug: string, opts?: {
-    enabled?: boolean;
-}): {
-    auction: AuctionItem | null;
-    isLoading: boolean;
-    error: string | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<AuctionItem | null, Error>>;
-};
-export declare function useAuctionBids(auctionSlug: string, limit?: number, opts?: {
-    enabled?: boolean;
-}): {
-    bids: import("..").BidRecord[];
-    total: number;
-    isLoading: boolean;
-    error: string | null;
-};
-export declare function useAuctionDetail(id: string, opts?: UseAuctionDetailOptions): {
-    productQuery: import("@tanstack/react-query").UseQueryResult<ProductItem | null, Error>;
-    product: ProductItem | null;
-    bidsQuery: import("@tanstack/react-query").UseQueryResult<PublicBid[], Error>;
-    bids: PublicBid[];
-};
-export {};

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

@@ -1,93 +0,0 @@
-"use client";
-import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { AUCTION_ENDPOINTS, BID_ENDPOINTS, PRODUCT_ENDPOINTS } from "../../../constants/api-endpoints";
-function toQueryString(params) {
-    if (typeof params === "string") {
-        return params.startsWith("?") ? params.slice(1) : params;
-    }
-    if (params instanceof URLSearchParams) {
-        return params.toString();
-    }
-    const sp = new URLSearchParams();
-    Object.entries(params).forEach(([key, value]) => {
-        if (value !== undefined && value !== null && value !== "") {
-            sp.set(key, String(value));
-        }
-    });
-    return sp.toString();
-}
-export function useAuctions(params = {}, opts) {
-    const endpoint = opts?.endpoint ?? AUCTION_ENDPOINTS.LIST;
-    const queryKeyPrefix = opts?.queryKeyPrefix ?? "auctions";
-    const qs = toQueryString(params);
-    const { data, isLoading, error, refetch } = useQuery({
-        queryKey: [queryKeyPrefix, endpoint, qs],
-        queryFn: () => apiClient.get(`${endpoint}${qs ? `?${qs}` : ""}`),
-        enabled: opts?.enabled ?? true,
-        initialData: opts?.initialData,
-    });
-    return {
-        data,
-        auctions: data?.items ?? [],
-        total: data?.total ?? 0,
-        totalPages: data?.totalPages ?? 1,
-        hasMore: data?.hasMore ?? false,
-        isLoading,
-        error: error instanceof Error ? error.message : null,
-        refetch,
-    };
-}
-export function useAuction(slug, opts) {
-    const { data, isLoading, error, refetch } = useQuery({
-        queryKey: ["auction", slug],
-        queryFn: () => apiClient.get(AUCTION_ENDPOINTS.BY_SLUG(slug)),
-        enabled: (opts?.enabled ?? true) && !!slug,
-    });
-    return {
-        auction: data ?? null,
-        isLoading,
-        error: error instanceof Error ? error.message : null,
-        refetch,
-    };
-}
-export function useAuctionBids(auctionSlug, limit = 10, opts) {
-    const { data, isLoading, error } = useQuery({
-        queryKey: ["auction-bids", auctionSlug, limit],
-        queryFn: () => apiClient.get(`${AUCTION_ENDPOINTS.BIDS(auctionSlug)}?limit=${limit}`),
-        enabled: (opts?.enabled ?? true) && !!auctionSlug,
-        refetchInterval: 15000, // refresh every 15 s for real-time feel
-    });
-    return {
-        bids: data?.items ?? [],
-        total: data?.total ?? 0,
-        isLoading,
-        error: error instanceof Error ? error.message : null,
-    };
-}
-export function useAuctionDetail(id, opts) {
-    const enabled = opts?.enabled ?? true;
-    const productEndpoint = opts?.productEndpoint ?? PRODUCT_ENDPOINTS.BY_ID(id);
-    const bidsEndpoint = opts?.bidsEndpoint ?? BID_ENDPOINTS.BY_PRODUCT(id);
-    const productQueryKeyPrefix = opts?.productQueryKeyPrefix ?? "product";
-    const bidsQueryKeyPrefix = opts?.bidsQueryKeyPrefix ?? "bids";
-    const refetchIntervalMs = opts?.refetchIntervalMs ?? 60000;
-    const productQuery = useQuery({
-        queryKey: [productQueryKeyPrefix, id, productEndpoint],
-        queryFn: () => apiClient.get(productEndpoint),
-        enabled: enabled && Boolean(id),
-    });
-    const product = productQuery.data ?? null;
-    const bidsQuery = useQuery({
-        queryKey: [bidsQueryKeyPrefix, id, bidsEndpoint],
-        queryFn: () => apiClient.get(bidsEndpoint),
-        enabled: enabled && Boolean(product?.isAuction),
-        refetchInterval: refetchIntervalMs,
-    });
-    return {
-        productQuery,
-        product,
-        bidsQuery,
-        bids: bidsQuery.data ?? [],
-    };
-}

package/dist/features/auctions/hooks/usePlaceBid.d.ts

@@ -1,24 +0,0 @@
-export interface BidResult {
-    id: string;
-    productId: string;
-    bidAmount: number;
-    isWinning: boolean;
-    currency: string;
-    [key: string]: unknown;
-}
-export interface PlaceBidPayload {
-    productId: string;
-    bidAmount: number;
-}
-/**
- * usePlaceBid
- *
- * Mutation hook for placing a bid on an auction product.
- * Invalidates bid list and auction detail queries on success so the UI
- * reflects the new highest bid without a manual reload.
- *
- * @example
- * const { mutateAsync, isPending } = usePlaceBid();
- * const bid = await mutateAsync({ productId, bidAmount: amount });
- */
-export declare function usePlaceBid(): import("@tanstack/react-query").UseMutationResult<BidResult, Error, PlaceBidPayload, unknown>;

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

@@ -1,29 +0,0 @@
-"use client";
-import { useMutation, useQueryClient } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { BID_ENDPOINTS } from "../../../constants/api-endpoints";
-/**
- * usePlaceBid
- *
- * Mutation hook for placing a bid on an auction product.
- * Invalidates bid list and auction detail queries on success so the UI
- * reflects the new highest bid without a manual reload.
- *
- * @example
- * const { mutateAsync, isPending } = usePlaceBid();
- * const bid = await mutateAsync({ productId, bidAmount: amount });
- */
-export function usePlaceBid() {
-    const queryClient = useQueryClient();
-    return useMutation({
-        mutationFn: async (data) => {
-            const result = await apiClient.post(BID_ENDPOINTS.LIST, data);
-            return result.bid;
-        },
-        onSuccess: async (_, { productId }) => {
-            await queryClient.invalidateQueries({ queryKey: ["bids", productId] });
-            await queryClient.invalidateQueries({ queryKey: ["auction", productId] });
-            await queryClient.invalidateQueries({ queryKey: ["product", productId] });
-        },
-    });
-}

package/dist/features/auctions/hooks/useRealtimeBids.d.ts

@@ -1,38 +0,0 @@
-export interface RealtimeBidData {
-    currentBid: number;
-    bidCount: number;
-    lastBid: {
-        amount: number;
-        bidderName: string;
-        timestamp: number;
-    } | null;
-    updatedAt: number;
-}
-export interface UseRealtimeBidsReturn {
-    /** Current highest bid — most recent value pushed from the server */
-    currentBid: number | null;
-    /** Total active bid count */
-    bidCount: number | null;
-    /** Info about the most recent bid placed */
-    lastBid: RealtimeBidData["lastBid"];
-    /** Whether the SSE connection is live */
-    connected: boolean;
-    /** Last time the data was updated (epoch ms) */
-    updatedAt: number | null;
-}
-/**
- * useRealtimeBids
- *
- * Subscribes to live auction bid updates via Server-Sent Events (SSE).
- *
- * Uses a streaming route that keeps a server-side listener open and pushes
- * updates to the browser via text/event-stream. No Firebase client SDK required.
- *
- * @param productId - The auction product ID to subscribe to, or null to disable
- * @param getEndpoint - Optional: override the SSE endpoint URL builder.
- *   Defaults to `/api/realtime/bids/{productId}`.
- *
- * @example
- * const { currentBid, bidCount, connected } = useRealtimeBids(productId);
- */
-export declare function useRealtimeBids(productId: string | null, getEndpoint?: (id: string) => string): UseRealtimeBidsReturn;

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

@@ -1,66 +0,0 @@
-"use client";
-import { useEffect, useState } from "react";
-import { logger } from "../../../core/Logger";
-import { BID_ENDPOINTS } from "../../../constants/api-endpoints";
-/**
- * useRealtimeBids
- *
- * Subscribes to live auction bid updates via Server-Sent Events (SSE).
- *
- * Uses a streaming route that keeps a server-side listener open and pushes
- * updates to the browser via text/event-stream. No Firebase client SDK required.
- *
- * @param productId - The auction product ID to subscribe to, or null to disable
- * @param getEndpoint - Optional: override the SSE endpoint URL builder.
- *   Defaults to `/api/realtime/bids/{productId}`.
- *
- * @example
- * const { currentBid, bidCount, connected } = useRealtimeBids(productId);
- */
-export function useRealtimeBids(productId, getEndpoint = BID_ENDPOINTS.REALTIME) {
-    const [data, setData] = useState(null);
-    const [connected, setConnected] = useState(false);
-    useEffect(() => {
-        if (!productId || typeof EventSource === "undefined") {
-            setConnected(false);
-            return;
-        }
-        const url = getEndpoint(productId);
-        const es = new EventSource(url);
-        es.onmessage = (event) => {
-            try {
-                const msg = JSON.parse(event.data);
-                if (msg.type === "connected") {
-                    setConnected(true);
-                }
-                else if (msg.type === "update") {
-                    setData(msg.data ?? null);
-                    setConnected(true);
-                }
-                else if (msg.type === "error") {
-                    setConnected(false);
-                }
-            }
-            catch {
-                logger.warn("[useRealtimeBids] Failed to parse SSE message");
-            }
-        };
-        es.onerror = () => {
-            // EventSource will attempt to reconnect automatically.
-            setConnected(false);
-            logger.warn("[useRealtimeBids] SSE connection error — will retry");
-        };
-        return () => {
-            es.close();
-            setConnected(false);
-        };
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [productId]);
-    return {
-        currentBid: data?.currentBid ?? null,
-        bidCount: data?.bidCount ?? null,
-        lastBid: data?.lastBid ?? null,
-        connected,
-        updatedAt: data?.updatedAt ?? null,
-    };
-}

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

@@ -1,8 +0,0 @@
-export * from "./schemas";
-export * from "./columns";
-export * from "./types";
-export * from "./hooks/useAuctions";
-export * from "./hooks/usePlaceBid";
-export * from "./hooks/useRealtimeBids";
-export * from "./components";
-export { manifest } from "./manifest";

package/dist/features/auctions/index.js

@@ -1,8 +0,0 @@
-export * from "./schemas";
-export * from "./columns";
-export * from "./types";
-export * from "./hooks/useAuctions";
-export * from "./hooks/usePlaceBid";
-export * from "./hooks/useRealtimeBids";
-export * from "./components";
-export { manifest } from "./manifest";

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

@@ -1,2 +0,0 @@
-import type { FeatureManifest } from "../../contracts";
-export declare const manifest: FeatureManifest;

package/dist/features/auctions/manifest.js

@@ -1,17 +0,0 @@
-export const manifest = {
-    name: "auctions",
-    i18nNamespace: "auctions",
-    envKeys: [],
-    routes: [
-        { segment: "[locale]/auctions", exports: { default: "AuctionsListView" } },
-        {
-            segment: "[locale]/auctions/[slug]",
-            exports: { default: "AuctionDetailView" },
-        },
-    ],
-    apiRoutes: [
-        { segment: "api/auctions", methods: ["GET"] },
-        { segment: "api/auctions/[slug]", methods: ["GET"] },
-        { segment: "api/auctions/[slug]/bid", methods: ["POST"] },
-    ],
-};

package/dist/features/auctions/messages/en.json

@@ -1,18 +0,0 @@
-{
-  "card": {
-    "currentBid": "Current bid",
-    "startingBid": "Starting bid",
-    "bids": "bids",
-    "placeBid": "Place Bid",
-    "ended": "Auction ended"
-  },
-  "countdown": {
-    "hours": "h",
-    "mins": "m",
-    "secs": "s"
-  },
-  "list": {
-    "title": "Live Auctions",
-    "empty": "No auctions running right now."
-  }
-}

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

@@ -1,12 +0,0 @@
-import type { IRepository, PagedResult, SieveQuery } from "../../../contracts";
-import type { AuctionItem } from "../types";
-export declare class AuctionsRepository {
-    private readonly repo;
-    constructor(repo: IRepository<AuctionItem>);
-    findAll(query?: SieveQuery): Promise<PagedResult<AuctionItem>>;
-    findById(id: string): Promise<AuctionItem | null>;
-    findBySlug(slug: string): Promise<AuctionItem | null>;
-    findActive(page?: number, perPage?: number): Promise<PagedResult<AuctionItem>>;
-    findByStore(storeSlug: string, page?: number, perPage?: number): Promise<PagedResult<AuctionItem>>;
-    findFeatured(limit?: number): Promise<AuctionItem[]>;
-}

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

@@ -1,42 +0,0 @@
-export class AuctionsRepository {
-    constructor(repo) {
-        this.repo = repo;
-    }
-    async findAll(query) {
-        return this.repo.findAll(query ?? {});
-    }
-    async findById(id) {
-        return this.repo.findById(id);
-    }
-    async findBySlug(slug) {
-        const result = await this.repo.findAll({
-            filters: `slug==${slug},status==published,isAuction==true`,
-            perPage: 1,
-        });
-        return result.data[0] ?? null;
-    }
-    async findActive(page = 1, perPage = 20) {
-        return this.repo.findAll({
-            filters: "status==published,isAuction==true",
-            sort: "auctionEndDate",
-            page,
-            perPage,
-        });
-    }
-    async findByStore(storeSlug, page = 1, perPage = 20) {
-        return this.repo.findAll({
-            filters: `storeSlug==${storeSlug},status==published,isAuction==true`,
-            sort: "auctionEndDate",
-            page,
-            perPage,
-        });
-    }
-    async findFeatured(limit = 6) {
-        const result = await this.repo.findAll({
-            filters: "status==published,isAuction==true,featured==true",
-            sort: "auctionEndDate",
-            perPage: limit,
-        });
-        return result.data;
-    }
-}

package/dist/features/auctions/repository/bid.repository.d.ts

@@ -1,145 +0,0 @@
-/**
- * Bid Repository
- *
- * Data access layer for bid documents in Firestore
- */
-import { BaseRepository } from "../../../providers/db-firebase";
-import type { DocumentReference, WriteBatch } from "firebase-admin/firestore";
-import type { SieveModel, FirebaseSieveResult } from "../../../providers/db-firebase";
-import type { BidDocument, BidCreateInput, BidUpdateInput, BidAdminUpdateInput, BidStatus } from "../schemas";
-export declare class BidRepository extends BaseRepository<BidDocument> {
-    constructor();
-    /** Override mapDoc to auto-decrypt PII on every bid read */
-    protected mapDoc<D = BidDocument>(snap: import("../../../providers/db-firebase").DocumentSnapshot): D;
-    /**
-     * Create new bid with auto-generated ID
-     */
-    create(input: BidCreateInput): Promise<BidDocument>;
-    /**
-     * Find bids by product ID
-     */
-    findByProduct(productId: string): Promise<BidDocument[]>;
-    /**
-     * Find bids by user ID
-     */
-    findByUser(userId: string): Promise<BidDocument[]>;
-    /**
-     * Find bids by status
-     */
-    findByStatus(status: BidStatus): Promise<BidDocument[]>;
-    /**
-     * Cloud Functions compatibility: active bids for a product with refs.
-     */
-    getActiveByProduct(productId: string): Promise<Array<{
-        id: string;
-        ref: DocumentReference;
-        data: BidDocument;
-    }>>;
-    /**
-     * Cloud Functions compatibility: current winning active bid with ref.
-     */
-    getWinningBid(productId: string): Promise<{
-        ref: DocumentReference;
-        data: BidDocument;
-    } | null>;
-    markWon(batch: WriteBatch, ref: DocumentReference): void;
-    markLost(batch: WriteBatch, ref: DocumentReference): void;
-    markOutbid(batch: WriteBatch, ref: DocumentReference): void;
-    markWinning(batch: WriteBatch, ref: DocumentReference): void;
-    /**
-     * Find current winning bid for a product
-     */
-    findWinningBid(productId: string): Promise<BidDocument | null>;
-    /**
-     * Find highest bid amount for a product
-     */
-    findHighestBid(productId: string): Promise<number>;
-    /**
-     * Find all bids for a product sorted by amount (descending)
-     */
-    findByProductSorted(productId: string): Promise<BidDocument[]>;
-    /**
-     * Update bid (user can only update autoMaxBid)
-     */
-    updateBid(bidId: string, data: BidUpdateInput): Promise<BidDocument>;
-    /**
-     * Admin update bid (can update any field except id and createdAt)
-     */
-    adminUpdateBid(bidId: string, data: BidAdminUpdateInput): Promise<BidDocument>;
-    /**
-     * Mark bid as winning and set all other bids for the product as outbid
-     */
-    setWinningBid(bidId: string, productId: string): Promise<void>;
-    /**
-     * End auction - mark winning bid as won and others as lost
-     */
-    endAuction(productId: string): Promise<void>;
-    /**
-     * Cancel all bids for a product (when product is deleted)
-     */
-    cancelProductBids(productId: string): Promise<void>;
-    /**
-     * Get bid count for a product
-     */
-    countByProduct(productId: string): Promise<number>;
-    /**
-     * Get user's bid count
-     */
-    countByUser(userId: string): Promise<number>;
-    /**
-     * Find a single bid by product, user, and status (database-layer query)
-     * Used instead of findBy() + Array.find() for efficiency
-     */
-    findOneByProductAndUser(productId: string, userId: string, status?: BidStatus): Promise<BidDocument | null>;
-    static readonly SIEVE_FIELDS: {
-        id: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
-        productId: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
-        productTitle: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
-        userId: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
-        userName: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
-        userEmail: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
-        bidAmount: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
-        status: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
-        isWinning: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
-        bidDate: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
-        createdAt: {
-            canFilter: boolean;
-            canSort: boolean;
-        };
-    };
-    /**
-     * Paginated, Firestore-native bid list (admin use).
-     */
-    list(model: SieveModel): Promise<FirebaseSieveResult<BidDocument>>;
-}
-export declare const bidRepository: BidRepository;