@mohasinac/appkit 2.4.10 → 2.5.0

package/dist/features/bundles/repository/bundles.repository.js

@@ -0,0 +1,148 @@
+/**
+ * bundlesRepository — SB1-H (S20 2026-05-12).
+ *
+ * Provides CRUD + targeted query helpers over the `bundles` collection.
+ * Stock sync is best-effort transactional: `markItemSold` flips the matching
+ * `bundleItems[].isSold` and re-derives bundle-level `status` from the items.
+ *
+ * Additive: no consumers wire this in yet. API routes + views land in later
+ * SB sessions (S21+).
+ */
+import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BUNDLES_COLLECTION, } from "../schemas";
+const BUNDLE_FIELDS = {
+    STORE_ID: "storeId",
+    CATEGORY: "category",
+    CATEGORY_SLUG: "categorySlug",
+    STATUS: "status",
+    IS_FEATURED: "isFeatured",
+    IS_PROMOTED: "isPromoted",
+    PART_OF: "partOfBundleProductIds",
+    CREATED_AT: "createdAt",
+    SLUG: "slug",
+};
+export class BundlesRepository extends BaseRepository {
+    constructor() {
+        super(BUNDLES_COLLECTION);
+    }
+    mapDoc(snap) {
+        return super.mapDoc(snap);
+    }
+    async findAll() {
+        const snap = await this.db
+            .collection(this.collection)
+            .orderBy(BUNDLE_FIELDS.CREATED_AT, "desc")
+            .limit(100)
+            .get();
+        return snap.docs.map((d) => this.mapDoc(d));
+    }
+    async findByStore(storeId, status) {
+        let query = this.db
+            .collection(this.collection)
+            .where(BUNDLE_FIELDS.STORE_ID, "==", storeId);
+        if (status)
+            query = query.where(BUNDLE_FIELDS.STATUS, "==", status);
+        const snap = await query
+            .orderBy(BUNDLE_FIELDS.CREATED_AT, "desc")
+            .limit(100)
+            .get();
+        return snap.docs.map((d) => this.mapDoc(d));
+    }
+    async findByCategory(category) {
+        const snap = await this.db
+            .collection(this.collection)
+            .where(BUNDLE_FIELDS.CATEGORY_SLUG, "==", category)
+            .where(BUNDLE_FIELDS.STATUS, "==", "published")
+            .orderBy(BUNDLE_FIELDS.CREATED_AT, "desc")
+            .limit(50)
+            .get();
+        return snap.docs.map((d) => this.mapDoc(d));
+    }
+    async findFeatured() {
+        const snap = await this.db
+            .collection(this.collection)
+            .where(BUNDLE_FIELDS.IS_FEATURED, "==", true)
+            .where(BUNDLE_FIELDS.STATUS, "==", "published")
+            .orderBy(BUNDLE_FIELDS.CREATED_AT, "desc")
+            .limit(20)
+            .get();
+        return snap.docs.map((d) => this.mapDoc(d));
+    }
+    async findBySlug(slug) {
+        const snap = await this.db
+            .collection(this.collection)
+            .where(BUNDLE_FIELDS.SLUG, "==", slug)
+            .limit(1)
+            .get();
+        if (snap.empty)
+            return null;
+        return this.mapDoc(snap.docs[0]);
+    }
+    async findContainingProduct(productId) {
+        const snap = await this.db
+            .collection(this.collection)
+            .where(BUNDLE_FIELDS.PART_OF, "array-contains", productId)
+            .limit(20)
+            .get();
+        return snap.docs.map((d) => this.mapDoc(d));
+    }
+    async create(data) {
+        const id = data.id ?? data.slug;
+        if (!id) {
+            throw new Error("bundlesRepository.create requires id or slug");
+        }
+        const now = new Date();
+        const doc = {
+            ...data,
+            id,
+            slug: data.slug ?? id,
+            createdAt: data.createdAt ?? now,
+            updatedAt: now,
+            partOfBundleProductIds: data.partOfBundleProductIds ??
+                (data.bundleItems ?? []).map((it) => it.productId),
+        };
+        await this.db
+            .collection(this.collection)
+            .doc(id)
+            .set(prepareForFirestore(doc));
+        return doc;
+    }
+    /**
+     * SB1-H stock sync — flips the matching `bundleItems[].isSold` to true and
+     * re-derives bundle-level `status`. If ANY item is sold, bundle goes to
+     * `out_of_stock`. Idempotent: re-marking an already-sold item is a no-op.
+     */
+    async markItemSold(bundleId, productId) {
+        const ref = this.db.collection(this.collection).doc(bundleId);
+        return this.db.runTransaction(async (txn) => {
+            const snap = await txn.get(ref);
+            if (!snap.exists)
+                return null;
+            const current = this.mapDoc(snap);
+            const items = current.bundleItems.map((it) => it.productId === productId ? { ...it, isSold: true } : it);
+            const anySold = items.some((it) => it.isSold);
+            const next = {
+                ...current,
+                bundleItems: items,
+                status: anySold && current.status === "published"
+                    ? "out_of_stock"
+                    : current.status,
+                updatedAt: new Date(),
+            };
+            txn.set(ref, prepareForFirestore(next));
+            return next;
+        });
+    }
+    /**
+     * Read-only stock check — returns the live bundle doc with item flags
+     * without mutating anything. Useful when the caller wants to *display*
+     * stock state without triggering a write.
+     */
+    async checkBundleStock(bundleId) {
+        const snap = await this.db.collection(this.collection).doc(bundleId).get();
+        if (!snap.exists)
+            return null;
+        return this.mapDoc(snap);
+    }
+}
+export const bundlesRepository = new BundlesRepository();

package/dist/features/bundles/repository/index.d.ts

@@ -0,0 +1 @@
+export * from "./bundles.repository";

package/dist/features/bundles/repository/index.js

@@ -0,0 +1 @@
+export * from "./bundles.repository";

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

@@ -0,0 +1,88 @@
+/**
+ * Bundle Firestore schemas (SB1-E — S19 2026-05-12).
+ *
+ * A bundle groups 3–16 existing products into a single sellable unit with a
+ * bundle price (typically lower than the sum of item prices). Bundle items
+ * keep their original product docs; the bundle doc references them via
+ * `bundleItems[].productId` and the products gain a reverse pointer via
+ * `partOfBundleIds[]` on `ProductDocument` (added in SB1-B same session).
+ *
+ * Stored at top-level `bundles/{bundle-slug}` collection (matches `BUNDLES_COLLECTION`).
+ * id === slug convention, `bundle-` prefix enforced.
+ *
+ * This is additive: no existing code consumes BundleDocument yet. Repository
+ * methods, API routes, and views land in subsequent SB sessions (S20+).
+ */
+export declare const BUNDLES_COLLECTION: "bundles";
+export type BundleStatus = "draft" | "published" | "out_of_stock" | "archived";
+/**
+ * Bundles are restricted to homogeneous listing types — either all-standard
+ * or all-preorder. Mixing auctions/prize-draws into bundles is intentionally
+ * disallowed (the price + quantity semantics don't compose cleanly).
+ */
+export type BundleItemListingType = "standard" | "pre-order";
+export interface BundleItem {
+    productId: string;
+    productSlug: string;
+    title: string;
+    listingType: BundleItemListingType;
+    images: string[];
+    video?: {
+        url: string;
+        thumbnailUrl?: string;
+    };
+    /** Per-unit price at the time the bundle was assembled (paise). */
+    price: number;
+    quantity: number;
+    /**
+     * True when this specific line item in the bundle has been fulfilled or
+     * its underlying product moved to a non-sellable state. Bundle-level
+     * `status` flips to `out_of_stock` once any item flips.
+     */
+    isSold: boolean;
+}
+export interface BundleDocument {
+    id: string;
+    slug: string;
+    title: string;
+    description?: string;
+    storeId: string;
+    storeName: string;
+    status: BundleStatus;
+    /** Must equal every `bundleItems[].listingType` — enforced by SB1-C Zod. */
+    bundleItemType: BundleItemListingType;
+    bundleItems: BundleItem[];
+    /** Discounted bundle price (paise) — the actual sale price. */
+    bundlePrice: number;
+    /** Sum of `bundleItems[].price * quantity` at assembly time (paise). */
+    bundleOriginalTotal: number;
+    currency: "INR";
+    category?: string;
+    categorySlug?: string;
+    subcategory?: string;
+    sublistingCategoryId?: string;
+    brandSlug?: string;
+    tags?: string[];
+    images?: string[];
+    video?: {
+        url: string;
+        thumbnailUrl?: string;
+    };
+    maxPerUser?: number;
+    isFeatured?: boolean;
+    isPromoted?: boolean;
+    /**
+     * Reverse-derived list of `productId`s that are members of this bundle.
+     * Duplicates `bundleItems[].productId` for index-friendly queries; kept in
+     * sync by the bundles repository on write.
+     */
+    partOfBundleProductIds: string[];
+    createdBy: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Indexed fields for Firestore composite indexes. Wired into
+ * `appkit/firebase/base/firestore.indexes.json` in a later SB session.
+ */
+export declare const BUNDLE_INDEXED_FIELDS: readonly ["storeId", "status", "categorySlug", "brandSlug", "isFeatured", "isPromoted", "createdAt"];

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

@@ -0,0 +1,29 @@
+/**
+ * Bundle Firestore schemas (SB1-E — S19 2026-05-12).
+ *
+ * A bundle groups 3–16 existing products into a single sellable unit with a
+ * bundle price (typically lower than the sum of item prices). Bundle items
+ * keep their original product docs; the bundle doc references them via
+ * `bundleItems[].productId` and the products gain a reverse pointer via
+ * `partOfBundleIds[]` on `ProductDocument` (added in SB1-B same session).
+ *
+ * Stored at top-level `bundles/{bundle-slug}` collection (matches `BUNDLES_COLLECTION`).
+ * id === slug convention, `bundle-` prefix enforced.
+ *
+ * This is additive: no existing code consumes BundleDocument yet. Repository
+ * methods, API routes, and views land in subsequent SB sessions (S20+).
+ */
+export const BUNDLES_COLLECTION = "bundles";
+/**
+ * Indexed fields for Firestore composite indexes. Wired into
+ * `appkit/firebase/base/firestore.indexes.json` in a later SB session.
+ */
+export const BUNDLE_INDEXED_FIELDS = [
+    "storeId",
+    "status",
+    "categorySlug",
+    "brandSlug",
+    "isFeatured",
+    "isPromoted",
+    "createdAt",
+];

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

@@ -0,0 +1 @@
+export * from "./firestore";

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

@@ -0,0 +1 @@
+export * from "./firestore";

package/dist/features/cart/actions/cart-actions.js

@@ -7,6 +7,7 @@
 import { serverLogger } from "../../../monitoring";
 import { cartRepository } from "../repository/cart.repository";
 import { productRepository } from "../../products/repository/products.repository";
+import { normalizeListingType } from "../../products/utils/listing-type";
 import { getDefaultCurrency } from "../../../core/baseline-resolver";
 export async function addItemToCart(userId, input) {
     serverLogger.debug("addItemToCart", { userId, productId: input.productId });
@@ -39,7 +40,7 @@ export async function mergeGuestCart(userId, items) {
             quantity: safeQty,
             storeId: product.storeId,
             storeName: product.storeName ?? "",
-            isAuction: product.isAuction ?? false,
+            listingType: normalizeListingType(product),
         });
     }
     serverLogger.info("mergeGuestCart completed", {

package/dist/features/cart/repository/cart.repository.js

@@ -78,8 +78,7 @@ export class CartRepository extends BaseRepository {
                     quantity: input.quantity,
                     storeId: input.storeId,
                     storeName: input.storeName,
-                    isAuction: input.isAuction ?? false,
-                    isPreOrder: input.isPreOrder ?? false,
+                    listingType: input.listingType,
                     ...(input.isOffer !== undefined && { isOffer: input.isOffer }),
                     ...(input.offerId !== undefined && { offerId: input.offerId }),
                     ...(input.lockedPrice !== undefined && {

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

@@ -15,8 +15,13 @@ export interface CartItemDocument {
     /** Store slug (= storeId = store.id) used for order grouping and store link (/stores/[storeId]) */
     storeId: string;
     storeName: string;
-    isAuction: boolean;
-    isPreOrder: boolean;
+    /**
+     * Snapshot of the product's listing-kind at add-to-cart time (SB1-G Phase 4).
+     * Drives order-grouping (auctions/pre-orders settle separately from standard
+     * carts) and cart-side UI badges. Replaces the legacy `isAuction`/`isPreOrder`
+     * pair on the cart item.
+     */
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
     /** True when item was added from an accepted Make-an-Offer */
     isOffer?: boolean;
     offerId?: string;
@@ -67,8 +72,7 @@ export declare const CART_FIELDS: {
         readonly QUANTITY: "quantity";
         readonly STORE_ID: "storeId";
         readonly STORE_NAME: "storeName";
-        readonly IS_AUCTION: "isAuction";
-        readonly IS_PRE_ORDER: "isPreOrder";
+        readonly LISTING_TYPE: "listingType";
         readonly ADDED_AT: "addedAt";
         readonly UPDATED_AT: "updatedAt";
     };
@@ -85,8 +89,7 @@ export type AddToCartInput = {
     /** Store slug (= storeId = store.id) */
     storeId: string;
     storeName: string;
-    isAuction?: boolean;
-    isPreOrder?: boolean;
+    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
     isOffer?: boolean;
     offerId?: string;
     lockedPrice?: number;

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

@@ -22,8 +22,7 @@ export const CART_FIELDS = {
         QUANTITY: "quantity",
         STORE_ID: "storeId",
         STORE_NAME: "storeName",
-        IS_AUCTION: "isAuction",
-        IS_PRE_ORDER: "isPreOrder",
+        LISTING_TYPE: "listingType",
         ADDED_AT: "addedAt",
         UPDATED_AT: "updatedAt",
     },

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

@@ -7,9 +7,9 @@ export declare const cartItemMetaSchema: z.ZodObject<{
     slug: z.ZodOptional<z.ZodString>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
+    currency: string;
     title: string;
     price: number;
-    currency: string;
     slug?: string | undefined;
     attributes?: Record<string, string> | undefined;
 }, {
@@ -42,9 +42,9 @@ export declare const cartItemSchema: z.ZodObject<{
         slug: z.ZodOptional<z.ZodString>;
         attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
+        currency: string;
         title: string;
         price: number;
-        currency: string;
         slug?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }, {
@@ -60,9 +60,9 @@ export declare const cartItemSchema: z.ZodObject<{
     productId: string;
     quantity: number;
     meta?: {
+        currency: string;
         title: string;
         price: number;
-        currency: string;
         slug?: string | undefined;
         attributes?: Record<string, string> | undefined;
     } | undefined;
@@ -98,9 +98,9 @@ export declare const cartSummarySchema: z.ZodObject<{
             slug: z.ZodOptional<z.ZodString>;
             attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
+            currency: string;
             title: string;
             price: number;
-            currency: string;
             slug?: string | undefined;
             attributes?: Record<string, string> | undefined;
         }, {
@@ -116,9 +116,9 @@ export declare const cartSummarySchema: z.ZodObject<{
         productId: string;
         quantity: number;
         meta?: {
+            currency: string;
             title: string;
             price: number;
-            currency: string;
             slug?: string | undefined;
             attributes?: Record<string, string> | undefined;
         } | undefined;
@@ -144,14 +144,15 @@ export declare const cartSummarySchema: z.ZodObject<{
     currency: z.ZodDefault<z.ZodString>;
     itemCount: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
+    currency: string;
     items: {
         id: string;
         productId: string;
         quantity: number;
         meta?: {
+            currency: string;
             title: string;
             price: number;
-            currency: string;
             slug?: string | undefined;
             attributes?: Record<string, string> | undefined;
         } | undefined;
@@ -159,7 +160,6 @@ export declare const cartSummarySchema: z.ZodObject<{
         userId?: string | undefined;
         addedAt?: string | undefined;
     }[];
-    currency: string;
     subtotal: number;
     itemCount: number;
 }, {

package/dist/features/cart/utils/guest-cart.d.ts

@@ -1,3 +1,9 @@
+export declare class CartFullError extends Error {
+    readonly code: "CART_FULL";
+    readonly limit = 50;
+    readonly current: number;
+    constructor(current: number);
+}
 export interface GuestCartItem {
     productId: string;
     quantity: number;

package/dist/features/cart/utils/guest-cart.js

@@ -1,9 +1,19 @@
+import { CART_MAX_ITEMS } from "../../../constants/limits";
 const DEFAULT_GUEST_CART_KEY = process.env.NEXT_PUBLIC_APP_ID
     ? `${process.env.NEXT_PUBLIC_APP_ID}_guest_cart`
     : "guest_cart";
 const DEFAULT_GUEST_RETURN_TO_KEY = process.env.NEXT_PUBLIC_APP_ID
     ? `${process.env.NEXT_PUBLIC_APP_ID}_guest_return_to`
     : "guest_return_to";
+export class CartFullError extends Error {
+    constructor(current) {
+        super(`Cart full (${current}/${CART_MAX_ITEMS})`);
+        this.code = "CART_FULL";
+        this.limit = CART_MAX_ITEMS;
+        this.name = "CartFullError";
+        this.current = current;
+    }
+}
 function getDefaultStorage() {
     if (typeof window === "undefined")
         return null;
@@ -34,6 +44,10 @@ export function getGuestCartItems(storage = getDefaultStorage(), key = DEFAULT_G
 export function addToGuestCart(productId, quantity, snapshot, storage = getDefaultStorage(), key = DEFAULT_GUEST_CART_KEY) {
     const items = readItems(storage, key);
     const existing = items.find((i) => i.productId === productId);
+    // Cart hard-cap: distinct items only. Quantity bumps to an existing item are unrestricted.
+    if (!existing && items.length >= CART_MAX_ITEMS) {
+        throw new CartFullError(items.length);
+    }
     const updated = existing
         ? items.map((i) => i.productId === productId
             ? { ...i, quantity: Math.min(i.quantity + quantity, 99) }

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

@@ -1,4 +1,6 @@
+import type { CategoryDocument } from "../schemas/firestore";
 export interface BrandDetailPageViewProps {
     slug: string;
+    initialBrand?: CategoryDocument | null;
 }
-export declare function BrandDetailPageView({ slug }: BrandDetailPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function BrandDetailPageView({ slug, initialBrand }: BrandDetailPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;

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

@@ -4,16 +4,16 @@ import { categoriesRepository, productRepository } from "../../../repositories";
 import { ROUTES } from "../../../next";
 import { Container, Main, Section } from "../../../ui";
 import { BrandDetailTabs } from "./BrandDetailTabs";
-export async function BrandDetailPageView({ slug }) {
-    const brand = await categoriesRepository
+export async function BrandDetailPageView({ slug, initialBrand }) {
+    const brand = (initialBrand ?? (await categoriesRepository
         .getCategoryBySlug(slug)
-        .catch(() => undefined);
+        .catch(() => undefined)));
     const brandName = brand?.name;
     const [productsResult, auctionsResult, preOrdersResult] = await Promise.all([
         brandName
             ? productRepository
                 .list({
-                filters: `status==published,brand==${brandName},isAuction==false,isPreOrder==false`,
+                filters: `status==published,brand==${brandName},listingType==standard`,
                 sorts: "-createdAt",
                 page: 1,
                 pageSize: 24,
@@ -23,7 +23,7 @@ export async function BrandDetailPageView({ slug }) {
         brandName
             ? productRepository
                 .list({
-                filters: `status==published,brand==${brandName},isAuction==true`,
+                filters: `status==published,brand==${brandName},listingType==auction`,
                 sorts: "auctionEndDate",
                 page: 1,
                 pageSize: 1,
@@ -33,7 +33,7 @@ export async function BrandDetailPageView({ slug }) {
         brandName
             ? productRepository
                 .list({
-                filters: `status==published,brand==${brandName},isPreOrder==true`,
+                filters: `status==published,brand==${brandName},listingType==pre-order`,
                 sorts: "-createdAt",
                 page: 1,
                 pageSize: 1,

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

@@ -12,7 +12,7 @@ export async function CategoryDetailPageView({ slug }) {
         category?.id
             ? productRepository
                 .list({
-                filters: `status==published,category==${category.id},isAuction==false,isPreOrder==false`,
+                filters: `status==published,category==${category.id},listingType==standard`,
                 sorts: "-createdAt",
                 page: 1,
                 pageSize: 24,
@@ -22,7 +22,7 @@ export async function CategoryDetailPageView({ slug }) {
         category?.id
             ? productRepository
                 .list({
-                filters: `status==published,category==${category.id},isAuction==true`,
+                filters: `status==published,category==${category.id},listingType==auction`,
                 sorts: "auctionEndDate",
                 page: 1,
                 pageSize: 1,
@@ -32,7 +32,7 @@ export async function CategoryDetailPageView({ slug }) {
         category?.id
             ? productRepository
                 .list({
-                filters: `status==published,category==${category.id},isPreOrder==true`,
+                filters: `status==published,category==${category.id},listingType==pre-order`,
                 sorts: "-createdAt",
                 page: 1,
                 pageSize: 1,

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

@@ -31,7 +31,7 @@ export function CategoryProductsListing({ categorySlug, categoryId, brandName, i
         sort: table.get("sort") || "-createdAt",
         page: table.getNumber("page", 1),
         perPage: table.getNumber("pageSize", 24),
-        isAuction: false,
+        listingType: "standard",
     };
     const { products, total, totalPages, page, isLoading } = useProducts(params, { initialData });
     const commitSearch = useCallback(() => {