@mohasinac/appkit 2.6.1 → 2.6.3

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

@@ -21,7 +21,7 @@ export interface CartItemDocument {
      * carts) and cart-side UI badges. Replaces the legacy `isAuction`/`isPreOrder`
      * pair on the cart item.
      */
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw";
     /** True when item was added from an accepted Make-an-Offer */
     isOffer?: boolean;
     offerId?: string;
@@ -89,7 +89,7 @@ export type AddToCartInput = {
     /** Store slug (= storeId = store.id) */
     storeId: string;
     storeName: string;
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw";
     isOffer?: boolean;
     offerId?: string;
     lockedPrice?: number;

package/dist/features/categories/components/BrandDetailPageView.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import Link from "next/link";
-import { categoriesRepository, productRepository } from "../../../repositories";
+import { categoriesRepository, productRepository, } from "../../../repositories";
 import { ROUTES } from "../../../next";
 import { Container, Main, Section } from "../../../ui";
 import { BrandDetailTabs } from "./BrandDetailTabs";
@@ -9,7 +9,7 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
         .getCategoryBySlug(slug)
         .catch(() => undefined)));
     const brandName = brand?.name;
-    const [productsResult, auctionsResult, preOrdersResult] = await Promise.all([
+    const [productsResult, auctionsResult, preOrdersResult, prizeDrawsResult, allBundles] = await Promise.all([
         brandName
             ? productRepository
                 .list({
@@ -40,7 +40,32 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
             })
                 .catch(() => null)
             : Promise.resolve(null),
+        brandName
+            ? productRepository
+                .list({
+                filters: `status==published,brand==${brandName},listingType==prize-draw`,
+                sorts: "-createdAt",
+                page: 1,
+                pageSize: 1,
+            })
+                .catch(() => null)
+            : Promise.resolve(null),
+        // SB-UNI-D — bundles are categoryType:"bundle" rows on the categories
+        // collection. We pull all bundle categories and filter client-side by
+        // brand affinity until the bundle storage carries an explicit brandSlug.
+        brandName
+            ? categoriesRepository
+                .listByType("bundle", { activeOnly: true, limit: 50 })
+                .catch(() => [])
+            : Promise.resolve([]),
     ]);
+    const brandLower = brandName?.toLowerCase();
+    const brandBundles = brandLower
+        ? allBundles.filter((b) => {
+            const seo = b.seo?.keywords?.map((k) => k.toLowerCase()) ?? [];
+            return seo.includes(brandLower);
+        })
+        : [];
     const coverImage = brand?.display?.coverImage;
     const hasCover = Boolean(coverImage);
     const brandColor = brand?.display?.color || "#6366f1";
@@ -48,7 +73,13 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
         products: productsResult?.total ?? brand?.metrics?.productCount ?? 0,
         auctions: auctionsResult?.total ?? brand?.metrics?.auctionCount ?? 0,
         preOrders: preOrdersResult?.total ?? 0,
+        prizeDraws: prizeDrawsResult?.total ?? 0,
+        bundles: brandBundles.length,
     };
-    const totalItems = counts.products + counts.auctions + counts.preOrders;
-    return (_jsxs(Main, { children: [_jsxs("section", { className: `relative overflow-hidden ${hasCover ? "min-h-[220px] md:min-h-[280px]" : "bg-zinc-50 dark:bg-zinc-900"}`, children: [hasCover && (_jsxs(_Fragment, { children: [_jsx("div", { className: "absolute inset-0 bg-center bg-cover", style: { backgroundImage: `url(${coverImage})` } }), _jsx("div", { className: "absolute inset-0 bg-black/55" })] })), !hasCover && (_jsx("div", { className: "absolute inset-0 opacity-10", style: { backgroundColor: brandColor } })), _jsxs("div", { className: `relative z-10 max-w-7xl mx-auto px-4 ${hasCover ? "py-12" : "py-8"}`, children: [_jsxs("nav", { className: "flex items-center gap-1.5 text-sm mb-4", "aria-label": "Breadcrumb", children: [_jsx(Link, { href: String(ROUTES.HOME), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-zinc-500 hover:text-primary-600 transition-colors", children: "Home" }), _jsx("span", { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.BRANDS ?? "/brands"), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-zinc-500 hover:text-primary-600 transition-colors", children: "Brands" }), _jsx("span", { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx("span", { className: hasCover ? "text-white font-medium" : "text-zinc-900 dark:text-zinc-100 font-medium", children: brand?.name ?? slug })] }), _jsxs("div", { className: "flex items-center gap-4 mb-3", children: [brand?.display?.icon && (_jsx("span", { className: `text-5xl leading-none ${!hasCover ? "" : ""}`, children: brand.display.icon })), _jsxs("div", { children: [_jsx("h1", { className: `text-3xl md:text-4xl font-bold ${hasCover ? "text-white" : "text-zinc-900 dark:text-zinc-50"}`, children: brand?.name ?? slug }), brand?.description && typeof brand.description === "string" && !brand.description.startsWith("{") && (_jsx("p", { className: `text-base max-w-2xl mt-1 ${hasCover ? "text-white/80" : "text-zinc-600 dark:text-zinc-400"}`, children: brand.description }))] })] }), _jsxs("div", { className: "flex flex-wrap gap-2 mt-3", children: [counts.products > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-primary/10 text-primary-700 dark:text-primary-400"}`, children: [counts.products.toLocaleString(), " ", counts.products === 1 ? "product" : "products"] })), counts.auctions > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-amber-100 text-amber-700 dark:bg-amber-900/30 dark:text-amber-400"}`, children: [counts.auctions.toLocaleString(), " ", counts.auctions === 1 ? "auction" : "auctions"] })), counts.preOrders > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-violet-100 text-violet-700 dark:bg-violet-900/30 dark:text-violet-400"}`, children: [counts.preOrders.toLocaleString(), " ", counts.preOrders === 1 ? "pre-order" : "pre-orders"] })), totalItems === 0 && (_jsx("span", { className: `text-sm ${hasCover ? "text-white/60" : "text-zinc-400"}`, children: "No items listed yet" }))] })] })] }), _jsx(Section, { className: "py-6", children: _jsx(Container, { size: "xl", children: brandName ? (_jsx(BrandDetailTabs, { brandName: brandName, initialProductsData: productsResult ?? undefined, counts: counts })) : (_jsx("p", { className: "py-12 text-center text-sm text-zinc-500 dark:text-zinc-400", children: "Brand not found." })) }) })] }));
+    const totalItems = counts.products +
+        counts.auctions +
+        counts.preOrders +
+        counts.prizeDraws +
+        counts.bundles;
+    return (_jsxs(Main, { children: [_jsxs("section", { className: `relative overflow-hidden ${hasCover ? "min-h-[220px] md:min-h-[280px]" : "bg-zinc-50 dark:bg-zinc-900"}`, children: [hasCover && (_jsxs(_Fragment, { children: [_jsx("div", { className: "absolute inset-0 bg-center bg-cover", style: { backgroundImage: `url(${coverImage})` } }), _jsx("div", { className: "absolute inset-0 bg-black/55" })] })), !hasCover && (_jsx("div", { className: "absolute inset-0 opacity-10", style: { backgroundColor: brandColor } })), _jsxs("div", { className: `relative z-10 max-w-7xl mx-auto px-4 ${hasCover ? "py-12" : "py-8"}`, children: [_jsxs("nav", { className: "flex items-center gap-1.5 text-sm mb-4", "aria-label": "Breadcrumb", children: [_jsx(Link, { href: String(ROUTES.HOME), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-zinc-500 hover:text-primary-600 transition-colors", children: "Home" }), _jsx("span", { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.BRANDS ?? "/brands"), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-zinc-500 hover:text-primary-600 transition-colors", children: "Brands" }), _jsx("span", { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx("span", { className: hasCover ? "text-white font-medium" : "text-zinc-900 dark:text-zinc-100 font-medium", children: brand?.name ?? slug })] }), _jsxs("div", { className: "flex items-center gap-4 mb-3", children: [brand?.display?.icon && (_jsx("span", { className: `text-5xl leading-none ${!hasCover ? "" : ""}`, children: brand.display.icon })), _jsxs("div", { children: [_jsx("h1", { className: `text-3xl md:text-4xl font-bold ${hasCover ? "text-white" : "text-zinc-900 dark:text-zinc-50"}`, children: brand?.name ?? slug }), brand?.description && typeof brand.description === "string" && !brand.description.startsWith("{") && (_jsx("p", { className: `text-base max-w-2xl mt-1 ${hasCover ? "text-white/80" : "text-zinc-600 dark:text-zinc-400"}`, children: brand.description }))] })] }), _jsxs("div", { className: "flex flex-wrap gap-2 mt-3", children: [counts.products > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-primary/10 text-primary-700 dark:text-primary-400"}`, children: [counts.products.toLocaleString(), " ", counts.products === 1 ? "product" : "products"] })), counts.auctions > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-amber-100 text-amber-700 dark:bg-amber-900/30 dark:text-amber-400"}`, children: [counts.auctions.toLocaleString(), " ", counts.auctions === 1 ? "auction" : "auctions"] })), counts.preOrders > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-violet-100 text-violet-700 dark:bg-violet-900/30 dark:text-violet-400"}`, children: [counts.preOrders.toLocaleString(), " ", counts.preOrders === 1 ? "pre-order" : "pre-orders"] })), totalItems === 0 && (_jsx("span", { className: `text-sm ${hasCover ? "text-white/60" : "text-zinc-400"}`, children: "No items listed yet" }))] })] })] }), _jsx(Section, { className: "py-6", children: _jsx(Container, { size: "xl", children: brandName ? (_jsx(BrandDetailTabs, { brandName: brandName, initialProductsData: productsResult ?? undefined, initialBundles: brandBundles, counts: counts })) : (_jsx("p", { className: "py-12 text-center text-sm text-zinc-500 dark:text-zinc-400", children: "Brand not found." })) }) })] }));
 }

package/dist/features/categories/components/BrandDetailTabs.d.ts

@@ -1,10 +1,14 @@
+import type { CategoryDocument } from "../schemas";
 export interface BrandDetailTabsProps {
     brandName: string;
     initialProductsData?: any;
+    initialBundles?: CategoryDocument[];
     counts?: {
         products?: number;
         auctions?: number;
         preOrders?: number;
+        prizeDraws?: number;
+        bundles?: number;
     };
 }
-export declare function BrandDetailTabs({ brandName, initialProductsData, counts }: BrandDetailTabsProps): import("react/jsx-runtime").JSX.Element;
+export declare function BrandDetailTabs({ brandName, initialProductsData, initialBundles, counts, }: BrandDetailTabsProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/categories/components/BrandDetailTabs.js

@@ -4,19 +4,33 @@ import { useState } from "react";
 import { CategoryProductsListing } from "./CategoryProductsListing";
 import { AuctionsIndexListing } from "../../products/components/AuctionsIndexListing";
 import { PreOrdersIndexListing } from "../../pre-orders/components/PreOrdersIndexListing";
+import { PrizeDrawsIndexListing } from "../../products/components/PrizeDrawsIndexListing";
+import { CategoryBundlesListing } from "./CategoryBundlesListing";
+import { CATEGORY_PAGE_TABS } from "../../products/constants/listing-tabs";
 function tabLabel(label, count) {
     if (!count)
         return label;
     return `${label} (${count.toLocaleString()})`;
 }
-export function BrandDetailTabs({ brandName, initialProductsData, counts }) {
+export function BrandDetailTabs({ brandName, initialProductsData, initialBundles = [], counts, }) {
     const [activeTab, setActiveTab] = useState("products");
-    const TABS = [
-        { id: "products", label: tabLabel("Products", counts?.products) },
-        { id: "auctions", label: tabLabel("Auctions", counts?.auctions) },
-        { id: "pre-orders", label: tabLabel("Pre-Orders", counts?.preOrders) },
-    ];
-    return (_jsxs("div", { children: [_jsx("div", { className: "flex border-b border-zinc-200 dark:border-slate-700 mb-6", children: TABS.map((t) => (_jsx("button", { type: "button", onClick: () => setActiveTab(t.id), className: `px-5 py-2.5 text-sm font-medium transition-colors -mb-px border-b-2 ${activeTab === t.id
+    const countFor = (id) => {
+        switch (id) {
+            case "products":
+                return counts?.products;
+            case "auctions":
+                return counts?.auctions;
+            case "pre-orders":
+                return counts?.preOrders;
+            case "prize-draws":
+                return counts?.prizeDraws;
+            case "bundles":
+                return counts?.bundles;
+            default:
+                return undefined;
+        }
+    };
+    return (_jsxs("div", { children: [_jsx("div", { className: "flex border-b border-zinc-200 dark:border-slate-700 mb-6 overflow-x-auto", children: CATEGORY_PAGE_TABS.map((t) => (_jsx("button", { type: "button", onClick: () => setActiveTab(t.id), className: `px-5 py-2.5 text-sm font-medium whitespace-nowrap transition-colors -mb-px border-b-2 ${activeTab === t.id
                         ? "border-primary text-primary"
-                        : "border-transparent text-zinc-500 hover:text-zinc-900 dark:hover:text-zinc-100"}`, children: t.label }, t.id))) }), activeTab === "products" && (_jsx(CategoryProductsListing, { categorySlug: "", brandName: brandName, initialData: initialProductsData })), activeTab === "auctions" && (_jsx(AuctionsIndexListing, { brandName: brandName })), activeTab === "pre-orders" && (_jsx(PreOrdersIndexListing, { brandName: brandName }))] }));
+                        : "border-transparent text-zinc-500 hover:text-zinc-900 dark:hover:text-zinc-100"}`, children: tabLabel(t.label, countFor(t.id)) }, t.id))) }), activeTab === "products" && (_jsx(CategoryProductsListing, { categorySlug: "", brandName: brandName, initialData: initialProductsData })), activeTab === "auctions" && (_jsx(AuctionsIndexListing, { brandName: brandName })), activeTab === "pre-orders" && (_jsx(PreOrdersIndexListing, { brandName: brandName })), activeTab === "prize-draws" && (_jsx(PrizeDrawsIndexListing, { brandName: brandName })), activeTab === "bundles" && (_jsx(CategoryBundlesListing, { initialBundles: initialBundles, brandName: brandName }))] }));
 }

package/dist/features/categories/components/CategoryBundlesListing.d.ts

@@ -0,0 +1,6 @@
+import type { CategoryDocument } from "../schemas";
+export interface CategoryBundlesListingProps {
+    initialBundles: CategoryDocument[];
+    brandName?: string;
+}
+export declare function CategoryBundlesListing({ initialBundles, brandName, }: CategoryBundlesListingProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/categories/components/CategoryBundlesListing.js

@@ -0,0 +1,74 @@
+"use client";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * CategoryBundlesListing — SB-UNI-D + V replacement for the deleted
+ * BundlesByCategoryListing. Renders a sortable list of bundles that live
+ * as `categoryType:"bundle"` rows on the categories collection.
+ *
+ * Parent server-fetches the list; client owns only the sort state.
+ */
+import { useMemo, useState } from "react";
+import Link from "next/link";
+import { Badge, Div, Row, Select, Stack, Text } from "../../../ui";
+import { ROUTES } from "../../../next/routing/route-map";
+import { formatCurrency } from "../../../utils/number.formatter";
+const SORT_OPTIONS = [
+    { label: "Newest", value: "newest" },
+    { label: "Price ↑", value: "price-asc" },
+    { label: "Price ↓", value: "price-desc" },
+];
+const STOCK_BADGE_TEXT = {
+    in_stock: "",
+    partial: "Partial",
+    out_of_stock: "Out of stock",
+};
+const STOCK_BADGE_VARIANT = {
+    in_stock: "success",
+    partial: "warning",
+    out_of_stock: "danger",
+};
+const PLACEHOLDER_EMOJI = "📦";
+const COPY = {
+    empty: "No bundles available",
+    forBrand: (name) => ` for ${name}`,
+    yetSuffix: " yet.",
+    sortLabel: "Sort:",
+    items: (n) => `${n} item${n !== 1 ? "s" : ""}`,
+    priceFallback: "—",
+};
+function comparator(sort) {
+    return (a, b) => {
+        if (sort === "price-asc") {
+            return (a.bundlePriceInPaise ?? 0) - (b.bundlePriceInPaise ?? 0);
+        }
+        if (sort === "price-desc") {
+            return (b.bundlePriceInPaise ?? 0) - (a.bundlePriceInPaise ?? 0);
+        }
+        const aT = a.createdAt instanceof Date ? a.createdAt.getTime() : 0;
+        const bT = b.createdAt instanceof Date ? b.createdAt.getTime() : 0;
+        return bT - aT;
+    };
+}
+export function CategoryBundlesListing({ initialBundles, brandName, }) {
+    const [sort, setSort] = useState("newest");
+    const filtered = useMemo(() => initialBundles
+        .filter((c) => c.categoryType === "bundle")
+        .slice()
+        .sort(comparator(sort)), [initialBundles, sort]);
+    if (filtered.length === 0) {
+        return (_jsx(Div, { className: "rounded-2xl border border-dashed border-zinc-200 py-16 text-center dark:border-zinc-700", children: _jsxs(Text, { color: "muted", children: [COPY.empty, brandName ? COPY.forBrand(brandName) : "", COPY.yetSuffix] }) }));
+    }
+    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "end", children: [_jsx(Text, { size: "sm", color: "muted", children: COPY.sortLabel }), _jsx(Select, { options: SORT_OPTIONS, value: sort, onValueChange: setSort, "aria-label": COPY.sortLabel })] }), _jsx(Div, { className: "grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-3", children: filtered.map((bundle) => (_jsx(BundleCard, { bundle: bundle }, bundle.id))) })] }));
+}
+function BundleCard({ bundle }) {
+    const memberCount = bundle.bundleProductIds?.length ?? 0;
+    const stock = bundle.bundleStockStatus ?? "in_stock";
+    const badge = STOCK_BADGE_TEXT[stock];
+    const cover = bundle.display?.coverImage;
+    const href = String(ROUTES.PUBLIC.BUNDLE_DETAIL?.(bundle.slug) ?? "#");
+    return (_jsxs(Link, { href: href, className: "group rounded-xl border border-zinc-200 bg-white p-3 transition-colors hover:border-zinc-300 dark:border-zinc-800 dark:bg-zinc-900 dark:hover:border-zinc-700", children: [_jsx(Div, { className: "mb-2 aspect-video overflow-hidden rounded-lg bg-zinc-100 dark:bg-zinc-800", children: cover ? (
+                // eslint-disable-next-line @next/next/no-img-element
+                _jsx("img", { src: cover, alt: bundle.name, className: "h-full w-full object-cover transition-transform group-hover:scale-105", loading: "lazy" })) : (_jsx(Div, { className: "flex h-full w-full items-center justify-center text-3xl", children: PLACEHOLDER_EMOJI })) }), _jsx(Text, { className: "line-clamp-2 text-sm font-semibold", children: bundle.name }), _jsxs(Row, { gap: "sm", align: "center", className: "mt-1", children: [_jsx(Text, { size: "sm", weight: "bold", children: bundle.bundlePriceInPaise
+                            ? formatCurrency(bundle.bundlePriceInPaise / 100, "INR")
+                            : COPY.priceFallback }), _jsx(Text, { size: "xs", color: "muted", children: COPY.items(memberCount) })] }), badge && (_jsx(Badge, { variant: STOCK_BADGE_VARIANT[stock], className: "mt-1", children: badge }))] }));
+}

package/dist/features/categories/components/CategoryDetailPageView.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import Link from "next/link";
-import { categoriesRepository, productRepository } from "../../../repositories";
+import { categoriesRepository, productRepository, } from "../../../repositories";
 import { ROUTES } from "../../../next";
 import { Container, Main, Section } from "../../../ui";
 import { CategoryDetailTabs } from "./CategoryDetailTabs";
@@ -8,7 +8,7 @@ export async function CategoryDetailPageView({ slug }) {
     const category = await categoriesRepository
         .getCategoryBySlug(slug)
         .catch(() => undefined);
-    const [productsResult, auctionsCountResult, preOrdersCountResult, childCategories] = await Promise.all([
+    const [productsResult, auctionsCountResult, preOrdersCountResult, prizeDrawsCountResult, bundlesResult, childCategories] = await Promise.all([
         category?.id
             ? productRepository
                 .list({
@@ -39,6 +39,23 @@ export async function CategoryDetailPageView({ slug }) {
             })
                 .catch(() => null)
             : Promise.resolve(null),
+        category?.id
+            ? productRepository
+                .list({
+                filters: `status==published,category==${category.id},listingType==prize-draw`,
+                sorts: "-createdAt",
+                page: 1,
+                pageSize: 1,
+            })
+                .catch(() => null)
+            : Promise.resolve(null),
+        // SB-UNI-D — bundles fetched from the categories collection. We pull
+        // all active bundle rows; the carousel filters by category affinity.
+        category?.id
+            ? categoriesRepository
+                .listByType("bundle", { activeOnly: true, limit: 50 })
+                .catch(() => [])
+            : Promise.resolve([]),
         category?.id
             ? categoriesRepository.getChildren(category.id).catch(() => [])
             : Promise.resolve([]),
@@ -46,8 +63,16 @@ export async function CategoryDetailPageView({ slug }) {
     const productCount = productsResult?.total ?? category?.metrics?.productCount ?? 0;
     const auctionCount = auctionsCountResult?.total ?? category?.metrics?.auctionCount ?? 0;
     const preOrderCount = preOrdersCountResult?.total ?? 0;
-    const totalCount = productCount + auctionCount + preOrderCount;
+    const prizeDrawCount = prizeDrawsCountResult?.total ?? 0;
+    const bundleCount = bundlesResult?.length ?? 0;
+    const totalCount = productCount + auctionCount + preOrderCount + prizeDrawCount + bundleCount;
     const coverImage = category?.display?.coverImage;
     const hasCover = Boolean(coverImage);
-    return (_jsxs(Main, { children: [_jsxs("section", { className: `relative overflow-hidden ${hasCover ? "min-h-[220px] md:min-h-[280px]" : "bg-zinc-50 dark:bg-zinc-900"}`, children: [hasCover && (_jsxs(_Fragment, { children: [_jsx("div", { className: "absolute inset-0 bg-center bg-cover", style: { backgroundImage: `url(${coverImage})` } }), _jsx("div", { className: "absolute inset-0 bg-black/55" })] })), _jsxs("div", { className: `relative z-10 max-w-7xl mx-auto px-4 ${hasCover ? "py-12" : "py-8"}`, children: [_jsxs("nav", { className: "flex items-center gap-1.5 text-sm mb-4", "aria-label": "Breadcrumb", children: [_jsx(Link, { href: String(ROUTES.HOME), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-zinc-500 hover:text-primary-600 transition-colors", children: "Home" }), _jsx("span", { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORIES), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-zinc-500 hover:text-primary-600 transition-colors", children: "Categories" }), _jsx("span", { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx("span", { className: hasCover ? "text-white font-medium" : "text-zinc-900 dark:text-zinc-100 font-medium", children: category?.name ?? slug })] }), _jsx("h1", { className: `text-3xl md:text-4xl font-bold mb-2 ${hasCover ? "text-white" : "text-zinc-900 dark:text-zinc-50"}`, children: category?.name ?? slug }), category?.description && typeof category.description === "string" && !category.description.startsWith("{") && (_jsx("p", { className: `text-base max-w-2xl mb-4 ${hasCover ? "text-white/80" : "text-zinc-600 dark:text-zinc-400"}`, children: category.description })), _jsxs("div", { className: "flex flex-wrap gap-2", children: [productCount > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-primary/10 text-primary-700 dark:text-primary-400"}`, children: [productCount.toLocaleString(), " ", productCount === 1 ? "product" : "products"] })), auctionCount > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-amber-100 text-amber-700 dark:bg-amber-900/30 dark:text-amber-400"}`, children: [auctionCount.toLocaleString(), " ", auctionCount === 1 ? "auction" : "auctions"] })), preOrderCount > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-violet-100 text-violet-700 dark:bg-violet-900/30 dark:text-violet-400"}`, children: [preOrderCount.toLocaleString(), " ", preOrderCount === 1 ? "pre-order" : "pre-orders"] }))] })] })] }), childCategories.length > 0 && (_jsx("section", { className: "border-b border-zinc-100 dark:border-zinc-800 bg-white dark:bg-zinc-900", children: _jsx("div", { className: "max-w-7xl mx-auto px-4 py-3", children: _jsx("div", { className: "flex gap-2.5 overflow-x-auto pb-1", style: { scrollbarWidth: "none" }, children: childCategories.map((child) => (_jsxs(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(child.slug)), className: "flex-shrink-0 flex items-center gap-1.5 rounded-full border border-zinc-200 dark:border-zinc-700 bg-zinc-50 dark:bg-zinc-800 px-4 py-1.5 text-sm font-medium text-zinc-700 dark:text-zinc-200 hover:border-primary hover:text-primary transition-colors whitespace-nowrap", children: [child.display?.icon && (_jsx("span", { className: "text-base leading-none", children: child.display.icon })), child.name, (child.metrics?.productCount ?? 0) > 0 && (_jsx("span", { className: "text-xs text-zinc-400 dark:text-zinc-500", children: (child.metrics?.productCount ?? 0).toLocaleString() }))] }, child.id))) }) }) })), _jsx(Section, { className: "py-6", children: _jsx(Container, { size: "xl", children: _jsx(CategoryDetailTabs, { categorySlug: slug, categoryId: category?.id, initialProductsData: productsResult ?? undefined, counts: { products: productCount, auctions: auctionCount, preOrders: preOrderCount } }) }) })] }));
+    return (_jsxs(Main, { children: [_jsxs("section", { className: `relative overflow-hidden ${hasCover ? "min-h-[220px] md:min-h-[280px]" : "bg-zinc-50 dark:bg-zinc-900"}`, children: [hasCover && (_jsxs(_Fragment, { children: [_jsx("div", { className: "absolute inset-0 bg-center bg-cover", style: { backgroundImage: `url(${coverImage})` } }), _jsx("div", { className: "absolute inset-0 bg-black/55" })] })), _jsxs("div", { className: `relative z-10 max-w-7xl mx-auto px-4 ${hasCover ? "py-12" : "py-8"}`, children: [_jsxs("nav", { className: "flex items-center gap-1.5 text-sm mb-4", "aria-label": "Breadcrumb", children: [_jsx(Link, { href: String(ROUTES.HOME), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-zinc-500 hover:text-primary-600 transition-colors", children: "Home" }), _jsx("span", { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORIES), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-zinc-500 hover:text-primary-600 transition-colors", children: "Categories" }), _jsx("span", { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx("span", { className: hasCover ? "text-white font-medium" : "text-zinc-900 dark:text-zinc-100 font-medium", children: category?.name ?? slug })] }), _jsx("h1", { className: `text-3xl md:text-4xl font-bold mb-2 ${hasCover ? "text-white" : "text-zinc-900 dark:text-zinc-50"}`, children: category?.name ?? slug }), category?.description && typeof category.description === "string" && !category.description.startsWith("{") && (_jsx("p", { className: `text-base max-w-2xl mb-4 ${hasCover ? "text-white/80" : "text-zinc-600 dark:text-zinc-400"}`, children: category.description })), _jsxs("div", { className: "flex flex-wrap gap-2", children: [productCount > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-primary/10 text-primary-700 dark:text-primary-400"}`, children: [productCount.toLocaleString(), " ", productCount === 1 ? "product" : "products"] })), auctionCount > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-amber-100 text-amber-700 dark:bg-amber-900/30 dark:text-amber-400"}`, children: [auctionCount.toLocaleString(), " ", auctionCount === 1 ? "auction" : "auctions"] })), preOrderCount > 0 && (_jsxs("span", { className: `inline-flex items-center gap-1 text-xs font-medium px-2.5 py-1 rounded-full ${hasCover ? "bg-white/20 text-white backdrop-blur-sm" : "bg-violet-100 text-violet-700 dark:bg-violet-900/30 dark:text-violet-400"}`, children: [preOrderCount.toLocaleString(), " ", preOrderCount === 1 ? "pre-order" : "pre-orders"] }))] })] })] }), childCategories.length > 0 && (_jsx("section", { className: "border-b border-zinc-100 dark:border-zinc-800 bg-white dark:bg-zinc-900", children: _jsx("div", { className: "max-w-7xl mx-auto px-4 py-3", children: _jsx("div", { className: "flex gap-2.5 overflow-x-auto pb-1", style: { scrollbarWidth: "none" }, children: childCategories.map((child) => (_jsxs(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(child.slug)), className: "flex-shrink-0 flex items-center gap-1.5 rounded-full border border-zinc-200 dark:border-zinc-700 bg-zinc-50 dark:bg-zinc-800 px-4 py-1.5 text-sm font-medium text-zinc-700 dark:text-zinc-200 hover:border-primary hover:text-primary transition-colors whitespace-nowrap", children: [child.display?.icon && (_jsx("span", { className: "text-base leading-none", children: child.display.icon })), child.name, (child.metrics?.productCount ?? 0) > 0 && (_jsx("span", { className: "text-xs text-zinc-400 dark:text-zinc-500", children: (child.metrics?.productCount ?? 0).toLocaleString() }))] }, child.id))) }) }) })), _jsx(Section, { className: "py-6", children: _jsx(Container, { size: "xl", children: _jsx(CategoryDetailTabs, { categorySlug: slug, categoryId: category?.id, initialProductsData: productsResult ?? undefined, initialBundles: bundlesResult ?? [], counts: {
+                            products: productCount,
+                            auctions: auctionCount,
+                            preOrders: preOrderCount,
+                            prizeDraws: prizeDrawCount,
+                            bundles: bundleCount,
+                        } }) }) })] }));
 }

package/dist/features/categories/components/CategoryDetailTabs.d.ts

@@ -1,11 +1,15 @@
+import type { CategoryDocument } from "../schemas";
 export interface CategoryDetailTabsProps {
     categorySlug: string;
     categoryId?: string;
     initialProductsData?: any;
+    initialBundles?: CategoryDocument[];
     counts?: {
         products?: number;
         auctions?: number;
         preOrders?: number;
+        prizeDraws?: number;
+        bundles?: number;
     };
 }
-export declare function CategoryDetailTabs({ categorySlug, categoryId, initialProductsData, counts }: CategoryDetailTabsProps): import("react/jsx-runtime").JSX.Element;
+export declare function CategoryDetailTabs({ categorySlug, categoryId, initialProductsData, initialBundles, counts, }: CategoryDetailTabsProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/categories/components/CategoryDetailTabs.js

@@ -4,19 +4,33 @@ import { useState } from "react";
 import { CategoryProductsListing } from "./CategoryProductsListing";
 import { AuctionsIndexListing } from "../../products/components/AuctionsIndexListing";
 import { PreOrdersIndexListing } from "../../pre-orders/components/PreOrdersIndexListing";
+import { PrizeDrawsIndexListing } from "../../products/components/PrizeDrawsIndexListing";
+import { CategoryBundlesListing } from "./CategoryBundlesListing";
+import { CATEGORY_PAGE_TABS } from "../../products/constants/listing-tabs";
 function tabLabel(label, count) {
     if (!count)
         return label;
     return `${label} (${count.toLocaleString()})`;
 }
-export function CategoryDetailTabs({ categorySlug, categoryId, initialProductsData, counts }) {
+export function CategoryDetailTabs({ categorySlug, categoryId, initialProductsData, initialBundles = [], counts, }) {
     const [activeTab, setActiveTab] = useState("products");
-    const TABS = [
-        { id: "products", label: tabLabel("Products", counts?.products) },
-        { id: "auctions", label: tabLabel("Auctions", counts?.auctions) },
-        { id: "pre-orders", label: tabLabel("Pre-Orders", counts?.preOrders) },
-    ];
-    return (_jsxs("div", { children: [_jsx("div", { className: "flex border-b border-zinc-200 dark:border-slate-700 mb-6", children: TABS.map((t) => (_jsx("button", { type: "button", onClick: () => setActiveTab(t.id), className: `px-5 py-2.5 text-sm font-medium transition-colors -mb-px border-b-2 ${activeTab === t.id
+    const countFor = (id) => {
+        switch (id) {
+            case "products":
+                return counts?.products;
+            case "auctions":
+                return counts?.auctions;
+            case "pre-orders":
+                return counts?.preOrders;
+            case "prize-draws":
+                return counts?.prizeDraws;
+            case "bundles":
+                return counts?.bundles;
+            default:
+                return undefined;
+        }
+    };
+    return (_jsxs("div", { children: [_jsx("div", { className: "flex border-b border-zinc-200 dark:border-slate-700 mb-6 overflow-x-auto", children: CATEGORY_PAGE_TABS.map((t) => (_jsx("button", { type: "button", onClick: () => setActiveTab(t.id), className: `px-5 py-2.5 text-sm font-medium whitespace-nowrap transition-colors -mb-px border-b-2 ${activeTab === t.id
                         ? "border-primary text-primary"
-                        : "border-transparent text-zinc-500 hover:text-zinc-900 dark:hover:text-zinc-100"}`, children: t.label }, t.id))) }), activeTab === "products" && (_jsx(CategoryProductsListing, { categorySlug: categorySlug, categoryId: categoryId, initialData: initialProductsData })), activeTab === "auctions" && (_jsx(AuctionsIndexListing, { categorySlug: categorySlug })), activeTab === "pre-orders" && (_jsx(PreOrdersIndexListing, { categorySlug: categorySlug }))] }));
+                        : "border-transparent text-zinc-500 hover:text-zinc-900 dark:hover:text-zinc-100"}`, children: tabLabel(t.label, countFor(t.id)) }, t.id))) }), activeTab === "products" && (_jsx(CategoryProductsListing, { categorySlug: categorySlug, categoryId: categoryId, initialData: initialProductsData })), activeTab === "auctions" && (_jsx(AuctionsIndexListing, { categorySlug: categorySlug })), activeTab === "pre-orders" && (_jsx(PreOrdersIndexListing, { categorySlug: categorySlug })), activeTab === "prize-draws" && (_jsx(PrizeDrawsIndexListing, { categorySlug: categorySlug })), activeTab === "bundles" && (_jsx(CategoryBundlesListing, { initialBundles: initialBundles }))] }));
 }

package/dist/features/categories/migrations.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationStep } from "../../_internal/shared/schema-versions";
+export declare const migrations: Record<number, MigrationStep<any>>;

package/dist/features/categories/migrations.js

@@ -0,0 +1,10 @@
+// SB-UNI X3 — migrations shell for category.
+// v1 schema is current; no migrations needed yet.
+//
+// To add a migration:
+//   1. Bump the relevant SCHEMA_VERSIONS entry in
+//      `_internal/shared/schema-versions.ts` (e.g. `categories: 2`)
+//   2. Add a row below keyed by the FROM-version, returning the upgraded doc
+//   3. Repository wraps reads with `migrateDocument(doc, current, migrations)`
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const migrations = {};

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

@@ -26,5 +26,34 @@ export declare class CategoriesRepository extends BaseRepository<CategoryDocumen
      * Cloud Functions: full-overwrite category metrics (used by nightly reconciliation job).
      */
     setMetrics(categoryId: string, productCount: number, auctionCount: number, productIds: string[], auctionIds: string[]): Promise<void>;
+    /** SB-UNI — discriminator-keyed listing (sublistings, brands, bundles). */
+    listByType(type: import("../types").CategoryType, opts?: {
+        limit?: number;
+        activeOnly?: boolean;
+    }): Promise<CategoryDocument[]>;
+    /** SB-UNI — locate a category by slug, optionally constrained by discriminator. */
+    findBySlugAndType(slug: string, type?: import("../types").CategoryType): Promise<CategoryDocument | null>;
+    /**
+     * SB-UNI-B — fetch products linked to a sublisting category (legacy
+     * sublistingCategoryId field on ProductDocument), ordered by price asc.
+     * Used by /api/sublisting-categories/[slug]/listings.
+     */
+    getSublistingListings(sublistingId: string, limit?: number): Promise<Record<string, unknown>[]>;
+    /**
+     * SB-UNI-B — delete a sublisting category and unlink all products
+     * that referenced it. Mirrors the cascade behavior of the old
+     * SublistingCategoriesRepository.delete().
+     */
+    deleteWithSublistingUnlink(categoryId: string): Promise<void>;
+    /**
+     * SB-UNI-C — list active brand categories ordered by displayOrder.
+     * Replaces the old `brandsRepository.findActive()` call site.
+     */
+    findActiveBrands(): Promise<CategoryDocument[]>;
+    /**
+     * SB-UNI-B — derive the canonical `sublisting-{slug}` ID from a
+     * human-entered category name.
+     */
+    generateSublistingId(name: string): string;
 }
 export declare const categoriesRepository: CategoriesRepository;

package/dist/features/categories/repository/categories.repository.js

@@ -364,6 +364,88 @@ export class CategoriesRepository extends BaseRepository {
             updatedAt: new Date(),
         });
     }
+    /** SB-UNI — discriminator-keyed listing (sublistings, brands, bundles). */
+    async listByType(type, opts = {}) {
+        let q = this.db
+            .collection(this.collection)
+            .where("categoryType", "==", type);
+        if (opts.activeOnly)
+            q = q.where("isActive", "==", true);
+        if (opts.limit)
+            q = q.limit(opts.limit);
+        const snap = await q.get();
+        return snap.docs.map((d) => this.mapDoc(d));
+    }
+    /** SB-UNI — locate a category by slug, optionally constrained by discriminator. */
+    async findBySlugAndType(slug, type) {
+        let q = this.db
+            .collection(this.collection)
+            .where("slug", "==", slug)
+            .limit(1);
+        if (type)
+            q = q.where("categoryType", "==", type);
+        const snap = await q.get();
+        if (snap.empty)
+            return null;
+        return this.mapDoc(snap.docs[0]);
+    }
+    /**
+     * SB-UNI-B — fetch products linked to a sublisting category (legacy
+     * sublistingCategoryId field on ProductDocument), ordered by price asc.
+     * Used by /api/sublisting-categories/[slug]/listings.
+     */
+    async getSublistingListings(sublistingId, limit = 20) {
+        const snap = await this.db
+            .collection("products")
+            .where("sublistingCategoryId", "==", sublistingId)
+            .where("status", "==", "published")
+            .orderBy("price", "asc")
+            .limit(limit)
+            .get();
+        return snap.docs.map((d) => ({ id: d.id, ...d.data() }));
+    }
+    /**
+     * SB-UNI-B — delete a sublisting category and unlink all products
+     * that referenced it. Mirrors the cascade behavior of the old
+     * SublistingCategoriesRepository.delete().
+     */
+    async deleteWithSublistingUnlink(categoryId) {
+        const batch = this.db.batch();
+        const productsSnap = await this.db
+            .collection("products")
+            .where("sublistingCategoryId", "==", categoryId)
+            .get();
+        for (const doc of productsSnap.docs) {
+            batch.update(doc.ref, { sublistingCategoryId: null, updatedAt: new Date() });
+        }
+        batch.delete(this.db.collection(this.collection).doc(categoryId));
+        await batch.commit();
+    }
+    /**
+     * SB-UNI-C — list active brand categories ordered by displayOrder.
+     * Replaces the old `brandsRepository.findActive()` call site.
+     */
+    async findActiveBrands() {
+        const snap = await this.db
+            .collection(this.collection)
+            .where("categoryType", "==", "brand")
+            .where("isActive", "==", true)
+            .orderBy("order", "asc")
+            .get();
+        return snap.docs.map((d) => this.mapDoc(d));
+    }
+    /**
+     * SB-UNI-B — derive the canonical `sublisting-{slug}` ID from a
+     * human-entered category name.
+     */
+    generateSublistingId(name) {
+        const base = name
+            .toLowerCase()
+            .trim()
+            .replace(/[^a-z0-9]+/g, "-")
+            .replace(/^-+|-+$/g, "");
+        return base.startsWith("sublisting-") ? base : `sublisting-${base}`;
+    }
 }
 CategoriesRepository.SIEVE_FIELDS = {
     name: { canFilter: true, canSort: true },
@@ -372,6 +454,7 @@ CategoriesRepository.SIEVE_FIELDS = {
     isActive: { canFilter: true, canSort: false },
     isFeatured: { canFilter: true, canSort: false },
     isBrand: { canFilter: true, canSort: false },
+    categoryType: { canFilter: true, canSort: false },
     isSearchable: { canFilter: true, canSort: false },
     parentId: { canFilter: true, canSort: false, path: "parentIds" },
     order: { canFilter: true, canSort: true },

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

@@ -6,6 +6,32 @@
  */
 import type { CategoryAncestor, CategoryMetrics, CategoryDisplay } from "../types";
 export type { CategoryAncestor, CategoryMetrics };
+/**
+ * How a bundle resolves its member products.
+ *
+ * `static` — hand-picked product IDs. The admin editor multi-select writes
+ * here; bundleProductIds mirrors for index-friendly queries.
+ *
+ * `dynamic` — publisher-pack style: filter against the products collection
+ * (e.g. "all Pokémon TCG products in this category, ordered by price asc,
+ * limit N"). Resolved by onProductStockChange + a scheduled job; the
+ * resolved IDs are cached on `bundleProductIds` with a `bundleQueryResolvedAt`
+ * timestamp.
+ */
+export type BundleQueryRule = {
+    type: "static";
+    productIds: string[];
+} | {
+    type: "dynamic";
+    filter: {
+        categorySlug?: string;
+        brandSlug?: string;
+        tags?: string[];
+        listingType?: "standard" | "pre-order";
+    };
+    orderBy?: "price-asc" | "price-desc" | "createdAt-desc";
+    limit: number;
+};
 /** Full Firestore category document (includes server-only fields) */
 export interface CategoryDocumentSEO {
     title: string;
@@ -56,8 +82,34 @@ export interface CategoryDocument {
     metrics: CategoryDocumentMetrics;
     isFeatured: boolean;
     featuredPriority?: number;
+    /** @deprecated Use categoryType === "brand". Will be removed once seed + admin form fully migrate. */
     isBrand?: boolean;
-    type?: import("../types").CategoryType;
+    /**
+     * Discriminator — distinguishes plain categories from sublistings (tier-4
+     * leaf groups under a parent category) and brands (storefront-facing
+     * brand pages). SB-UNI-D will add `"bundle"` to this union.
+     */
+    categoryType?: import("../types").CategoryType;
+    /** Sublisting/grading code (e.g. "108/120", "PSA 10") — categoryType==="sublisting". */
+    itemCode?: string;
+    /** Brand homepage URL — categoryType==="brand". */
+    brandWebsite?: string;
+    /** Brand country of origin — categoryType==="brand". */
+    brandCountry?: string;
+    /** Brand founding year — categoryType==="brand". */
+    brandFounded?: number;
+    /** Banner image for the brand storefront page — categoryType==="brand". */
+    brandBannerImage?: string;
+    /** Discounted bundle price in paise. */
+    bundlePriceInPaise?: number;
+    /** Rule resolving the bundle's member products — static list or live query. */
+    bundleQueryRule?: BundleQueryRule;
+    /** Snapshot stock state — recomputed by onProductStockChange. */
+    bundleStockStatus?: "in_stock" | "partial" | "out_of_stock";
+    /** Timestamp of the last dynamic-rule resolution. */
+    bundleQueryResolvedAt?: Date;
+    /** Hand-picked products list (mirror of bundleQueryRule for static rules); kept for index-friendly queries. */
+    bundleProductIds?: string[];
     seo: CategoryDocumentSEO;
     display: CategoryDocumentDisplay;
     isActive: boolean;
@@ -75,7 +127,7 @@ export interface CategoryDocument {
     ancestors: CategoryAncestor[];
 }
 export declare const CATEGORIES_COLLECTION: "categories";
-export declare const CATEGORIES_INDEXED_FIELDS: readonly ["slug", "rootId", "tier", "parentIds", "isLeaf", "isFeatured", "featuredPriority", "isBrand", "isActive", "isSearchable", "showOnHomepage", "createdBy", "createdByType", "createdByStoreId", "createdAt"];
+export declare const CATEGORIES_INDEXED_FIELDS: readonly ["slug", "rootId", "tier", "parentIds", "isLeaf", "isFeatured", "featuredPriority", "isBrand", "categoryType", "isActive", "isSearchable", "showOnHomepage", "createdBy", "createdByType", "createdByStoreId", "createdAt"];
 export declare const MIN_ITEMS_FOR_FEATURED: 8;
 export declare const MAX_FEATURED_CATEGORIES: 4;
 export declare const DEFAULT_CATEGORY_DATA: Partial<CategoryDocument>;
@@ -103,7 +155,12 @@ export declare const categoryQueryHelpers: {
     readonly byRootId: (rootId: string) => readonly ["rootId", "==", string];
     readonly children: (parentId: string) => readonly ["parentIds", "array-contains", string];
     readonly featured: () => readonly ["isFeatured", "==", true];
+    /** @deprecated Use byCategoryType("brand"). */
     readonly brands: () => readonly ["isBrand", "==", true];
+    /** SB-UNI B + C + D — discriminator-based listing. */
+    readonly byCategoryType: (type: import("../types").CategoryType) => readonly ["categoryType", "==", import("..").CategoryType];
+    readonly sublistings: () => readonly ["categoryType", "==", "sublisting"];
+    readonly brandPages: () => readonly ["categoryType", "==", "brand"];
     readonly active: () => readonly ["isActive", "==", true];
     readonly searchable: () => readonly ["isSearchable", "==", true];
     readonly byCreator: (userId: string) => readonly ["createdBy", "==", string];