@mohasinac/appkit 2.4.10 → 2.5.0

package/dist/react/hooks/useInfiniteScroll.d.ts

@@ -0,0 +1,52 @@
+/**
+ * useInfiniteScroll (Q6 — S13)
+ *
+ * Lightweight IntersectionObserver wrapper for cursor-based listings.
+ * Attach the returned `sentinelRef` to a sentinel `<div />` at the bottom
+ * of your list. When that div scrolls into view the hook calls `onLoadMore`.
+ *
+ * The hook keeps no domain state — callers own items, cursor, hasMore.
+ * Concerns it does handle:
+ *   - Guard against re-firing while a load is already in flight.
+ *   - Auto-disable when `hasMore === false`.
+ *   - Disconnect on unmount.
+ *
+ * Pair with `ListingProcessorResponse.cursor` returned from /api/products.
+ *
+ * @example
+ * const { sentinelRef, isLoadingMore } = useInfiniteScroll({
+ *   hasMore: page.hasMore,
+ *   onLoadMore: () => fetchNext(page.cursor),
+ * });
+ * return (
+ *   <>
+ *     {items.map(...)}
+ *     <div ref={sentinelRef} />
+ *     {isLoadingMore && <SkeletonCards />}
+ *   </>
+ * );
+ */
+export interface UseInfiniteScrollOptions {
+    /** Whether more pages are available. Hook short-circuits when false. */
+    hasMore: boolean;
+    /** Called when the sentinel enters the viewport AND no load is in flight. */
+    onLoadMore: () => void | Promise<void>;
+    /**
+     * Margin around the root before the sentinel is considered "in view".
+     * Defaults to "200px" so the next page starts loading before the user
+     * actually hits the bottom.
+     */
+    rootMargin?: string;
+    /**
+     * Set to true to temporarily pause the observer (e.g. during a hard
+     * pagination reset). Re-enables on next render.
+     */
+    disabled?: boolean;
+}
+export interface UseInfiniteScrollResult {
+    /** Attach to the bottom sentinel `<div />`. */
+    sentinelRef: (node: HTMLDivElement | null) => void;
+    /** True while `onLoadMore` is in flight. */
+    isLoadingMore: boolean;
+}
+export declare function useInfiniteScroll(opts: UseInfiniteScrollOptions): UseInfiniteScrollResult;

package/dist/react/hooks/useInfiniteScroll.js

@@ -0,0 +1,45 @@
+"use client";
+import { useEffect, useRef, useState } from "react";
+export function useInfiniteScroll(opts) {
+    const { hasMore, onLoadMore, rootMargin = "200px", disabled = false } = opts;
+    const [isLoadingMore, setIsLoadingMore] = useState(false);
+    const observerRef = useRef(null);
+    const loadingRef = useRef(false);
+    const onLoadMoreRef = useRef(onLoadMore);
+    useEffect(() => {
+        onLoadMoreRef.current = onLoadMore;
+    }, [onLoadMore]);
+    const sentinelRef = (node) => {
+        if (observerRef.current) {
+            observerRef.current.disconnect();
+            observerRef.current = null;
+        }
+        if (!node || disabled || !hasMore)
+            return;
+        observerRef.current = new IntersectionObserver((entries) => {
+            const entry = entries[0];
+            if (!entry?.isIntersecting)
+                return;
+            if (loadingRef.current)
+                return;
+            loadingRef.current = true;
+            setIsLoadingMore(true);
+            Promise.resolve(onLoadMoreRef.current())
+                .catch(() => {
+                // Caller surfaces errors; hook only releases the lock.
+            })
+                .finally(() => {
+                loadingRef.current = false;
+                setIsLoadingMore(false);
+            });
+        }, { rootMargin });
+        observerRef.current.observe(node);
+    };
+    useEffect(() => {
+        return () => {
+            observerRef.current?.disconnect();
+            observerRef.current = null;
+        };
+    }, []);
+    return { sentinelRef, isLoadingMore };
+}

package/dist/repositories/index.d.ts

@@ -21,6 +21,7 @@ export { siteSettingsRepository } from "../features/admin/repository/site-settin
 export { notificationRepository } from "../features/admin/repository/notification.repository";
 export { chatRepository } from "../features/admin/repository/chat.repository";
 export { carouselRepository } from "../features/homepage/repository/carousel.repository";
+export { carouselsRepository, CarouselsRepository } from "../features/homepage/repository/carousels.repository";
 export { homepageSectionsRepository } from "../features/homepage/repository/homepage-sections.repository";
 export { CategoriesRepository, categoriesRepository, } from "../features/categories/repository/categories.repository";
 export { couponsRepository } from "../features/promotions/repository/coupons.repository";
@@ -28,7 +29,8 @@ export { FAQsRepository, FirebaseFAQsRepository, faqsRepository, } from "../feat
 export { BlogRepository, blogRepository, } from "../features/blog/repository/blog.repository";
 export { payoutRepository } from "../features/payments/repository/payout.repository";
 export { OfferRepository, offerRepository, } from "../features/seller/repository/offer.repository";
-export { wishlistRepository, type UserWishlistItem as WishlistItem, } from "../features/wishlist/repository/user-wishlist.repository";
+export { wishlistRepository, type UserWishlistItem as WishlistItem, WishlistFullError, } from "../features/wishlist/repository/user-wishlist.repository";
+export { historyRepository, type UserHistoryItem, type HistoryProductType, } from "../features/history/repository/user-history.repository";
 export { EventRepository, EventsRepository, eventRepository, } from "../features/events/repository/events.repository";
 export { EventEntryRepository, EventEntriesRepository, eventEntryRepository, } from "../features/events/repository/event-entry.repository";
 export { NewsletterRepository, newsletterRepository, } from "../core/newsletter.repository";
@@ -40,3 +42,9 @@ export type { CopilotFeedback, CopilotLogDocument, CopilotLogCreateInput, } from
 export { ScammerRepository, scammerRepository, } from "../features/scams/repository/scammer.repository";
 export { SublistingCategoriesRepository, sublistingCategoriesRepository, } from "../features/products/repository/sublisting-categories.repository";
 export type { SublistingCategoryDocument, SublistingCategoryCreateInput, SublistingCategoryUpdateInput, } from "../features/products/schemas/sublisting-categories";
+export { ProductTemplateRepository, productTemplateRepository, } from "../features/products/repository/product-templates.repository";
+export type { ProductTemplateDocument, ProductTemplateCreateInput, ProductTemplateUpdateInput, } from "../features/products/schemas/product-templates";
+export { ProductFeaturesRepository, productFeaturesRepository, } from "../features/products/repository/product-features.repository";
+export type { ProductFeatureListFilter } from "../features/products/repository/product-features.repository";
+export { loadProductFeaturesForStore } from "../features/products/repository/loadProductFeatures";
+export { BundlesRepository, bundlesRepository, } from "../features/bundles/repository";

package/dist/repositories/index.js

@@ -24,6 +24,7 @@ export { siteSettingsRepository } from "../features/admin/repository/site-settin
 export { notificationRepository } from "../features/admin/repository/notification.repository";
 export { chatRepository } from "../features/admin/repository/chat.repository";
 export { carouselRepository } from "../features/homepage/repository/carousel.repository";
+export { carouselsRepository, CarouselsRepository } from "../features/homepage/repository/carousels.repository";
 export { homepageSectionsRepository } from "../features/homepage/repository/homepage-sections.repository";
 export { CategoriesRepository, categoriesRepository, } from "../features/categories/repository/categories.repository";
 export { couponsRepository } from "../features/promotions/repository/coupons.repository";
@@ -31,7 +32,8 @@ export { FAQsRepository, FirebaseFAQsRepository, faqsRepository, } from "../feat
 export { BlogRepository, blogRepository, } from "../features/blog/repository/blog.repository";
 export { payoutRepository } from "../features/payments/repository/payout.repository";
 export { OfferRepository, offerRepository, } from "../features/seller/repository/offer.repository";
-export { wishlistRepository, } from "../features/wishlist/repository/user-wishlist.repository";
+export { wishlistRepository, WishlistFullError, } from "../features/wishlist/repository/user-wishlist.repository";
+export { historyRepository, } from "../features/history/repository/user-history.repository";
 // Feature repositories already appkit-owned
 export { EventRepository, EventsRepository, eventRepository, } from "../features/events/repository/events.repository";
 export { EventEntryRepository, EventEntriesRepository, eventEntryRepository, } from "../features/events/repository/event-entry.repository";
@@ -40,3 +42,8 @@ export { CopilotLogRepository, copilotLogRepository } from "../core";
 export { BrandsRepository, brandsRepository, } from "../features/brands/repository/brands.repository";
 export { ScammerRepository, scammerRepository, } from "../features/scams/repository/scammer.repository";
 export { SublistingCategoriesRepository, sublistingCategoriesRepository, } from "../features/products/repository/sublisting-categories.repository";
+export { ProductTemplateRepository, productTemplateRepository, } from "../features/products/repository/product-templates.repository";
+export { ProductFeaturesRepository, productFeaturesRepository, } from "../features/products/repository/product-features.repository";
+export { loadProductFeaturesForStore } from "../features/products/repository/loadProductFeatures";
+// SB1-H — bundles
+export { BundlesRepository, bundlesRepository, } from "../features/bundles/repository";

package/dist/seed/_bundle-constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared seed-side constants for bundle fixtures. Kept out of feature code so
+ * the seed package doesn't leak fixture-only IDs into runtime imports.
+ */
+/** Slug-prefix enforced on every bundle document. */
+export declare const BUNDLE_PREFIX: "bundle-";
+/**
+ * Minimum + maximum items per bundle — mirrored from the Zod schema in
+ * `appkit/src/features/products/schemas/index.ts`. Re-declared here to keep the
+ * seed authoring assertions self-contained (a test util can `expect(items.length)
+ * .toBeGreaterThanOrEqual(BUNDLE_MIN_ITEMS)`).
+ */
+export declare const BUNDLE_MIN_ITEMS: 3;
+export declare const BUNDLE_MAX_ITEMS: 16;

package/dist/seed/_bundle-constants.js

@@ -0,0 +1,14 @@
+/**
+ * Shared seed-side constants for bundle fixtures. Kept out of feature code so
+ * the seed package doesn't leak fixture-only IDs into runtime imports.
+ */
+/** Slug-prefix enforced on every bundle document. */
+export const BUNDLE_PREFIX = "bundle-";
+/**
+ * Minimum + maximum items per bundle — mirrored from the Zod schema in
+ * `appkit/src/features/products/schemas/index.ts`. Re-declared here to keep the
+ * seed authoring assertions self-contained (a test util can `expect(items.length)
+ * .toBeGreaterThanOrEqual(BUNDLE_MIN_ITEMS)`).
+ */
+export const BUNDLE_MIN_ITEMS = 3;
+export const BUNDLE_MAX_ITEMS = 16;

package/dist/seed/actions/demo-seed-actions.d.ts

@@ -6,7 +6,7 @@
  * the actual collection-specific seeding logic (800+ lines with PII encryption,
  * Auth user creation, subcollection handling, etc.).
  */
-export type SeedCollectionName = "users" | "addresses" | "brands" | "categories" | "stores" | "products" | "orders" | "reviews" | "bids" | "coupons" | "carouselSlides" | "homepageSections" | "siteSettings" | "faqs" | "notifications" | "payouts" | "blogPosts" | "events" | "eventEntries" | "sessions" | "storeAddresses" | "carts" | "wishlists" | "conversations" | "sublistingCategories" | "groupedListings" | "scammerProfiles";
+export type SeedCollectionName = "users" | "addresses" | "brands" | "categories" | "stores" | "products" | "orders" | "reviews" | "bids" | "coupons" | "carousels" | "carouselSlides" | "homepageSections" | "siteSettings" | "faqs" | "notifications" | "payouts" | "blogPosts" | "events" | "eventEntries" | "sessions" | "storeAddresses" | "carts" | "wishlists" | "history" | "conversations" | "sublistingCategories" | "groupedListings" | "bundles" | "scammerProfiles" | "productFeatures";
 export interface SeedOperationResult {
     success?: boolean;
     message: string;

package/dist/seed/bids-seed-data.js

@@ -440,4 +440,169 @@ export const bidsSeedData = [
         createdAt: daysAgo(30),
         updatedAt: daysAgo(30),
     },
+    // ═══════════════════════════════════════════════════════════════════════════
+    // auction-pokemon-lugia-neo-genesis-psa9 — active, 7 bids → ₹69,999
+    // ═══════════════════════════════════════════════════════════════════════════
+    ...buildBidLadder({
+        productId: "auction-pokemon-lugia-neo-genesis-psa9",
+        productTitle: "Pokémon Neo Genesis Lugia #9 Holo — PSA 9 MINT (AUCTION)",
+        amounts: [3499900, 4000000, 4500000, 5000000, 5500000, 6000000, 6999900],
+        bidders: [
+            { id: "user-rahul-sharma", name: "Rahul Sharma", email: "rahul.sharma@gmail.com" },
+            { id: "user-meera-nair", name: "Meera Nair", email: "meera.nair@gmail.com" },
+            { id: "user-arjun-singh", name: "Arjun Singh", email: "arjun.singh@gmail.com" },
+            { id: "user-kavya-iyer", name: "Kavya Iyer", email: "kavya.iyer@gmail.com" },
+            { id: "user-priya-patel", name: "Priya Patel", email: "priya.patel@gmail.com" },
+            { id: "user-rahul-sharma", name: "Rahul Sharma", email: "rahul.sharma@gmail.com" },
+            { id: "user-arjun-singh", name: "Arjun Singh", email: "arjun.singh@gmail.com" },
+        ],
+        daysAgoForFirst: 9,
+        endsActive: true,
+        slugPrefix: "bid-lugia-neo",
+    }),
+    // ═══════════════════════════════════════════════════════════════════════════
+    // auction-funko-stan-lee-glow-chase — active, 4 bids → ₹10,999
+    // ═══════════════════════════════════════════════════════════════════════════
+    ...buildBidLadder({
+        productId: "auction-funko-stan-lee-glow-chase",
+        productTitle: "Funko Pop Stan Lee Glow-in-the-Dark Chase Variant — Vaulted (AUCTION)",
+        amounts: [599900, 749900, 899900, 1099900],
+        bidders: [
+            { id: "user-kartik-nair", name: "Kartik Nair", email: "kartik.nair@gmail.com" },
+            { id: "user-sneha-kumar", name: "Sneha Kumar", email: "sneha.kumar@gmail.com" },
+            { id: "user-naman-gupta", name: "Naman Gupta", email: "naman.gupta@gmail.com" },
+            { id: "user-kartik-nair", name: "Kartik Nair", email: "kartik.nair@gmail.com" },
+        ],
+        daysAgoForFirst: 7,
+        endsActive: true,
+        slugPrefix: "bid-funko-stan-lee",
+    }),
+    // ═══════════════════════════════════════════════════════════════════════════
+    // auction-beyblade-spriggan-requiem-tournament — active, 6 bids → ₹8,999
+    // ═══════════════════════════════════════════════════════════════════════════
+    ...buildBidLadder({
+        productId: "auction-beyblade-spriggan-requiem-tournament",
+        productTitle: "Beyblade Burst B-100 Spriggan Requiem — Tournament Limited Edition (AUCTION)",
+        amounts: [399900, 499900, 599900, 699900, 799900, 899900],
+        bidders: [
+            { id: "user-aryan-kapoor", name: "Aryan Kapoor", email: "aryan.kapoor@gmail.com" },
+            { id: "user-rohit-joshi", name: "Rohit Joshi", email: "rohit.joshi@gmail.com" },
+            { id: "user-tanvi-desai", name: "Tanvi Desai", email: "tanvi.desai@gmail.com" },
+            { id: "user-aryan-kapoor", name: "Aryan Kapoor", email: "aryan.kapoor@gmail.com" },
+            { id: "user-ankit-gupta", name: "Ankit Gupta", email: "ankit.gupta@gmail.com" },
+            { id: "user-tanvi-desai", name: "Tanvi Desai", email: "tanvi.desai@gmail.com" },
+        ],
+        daysAgoForFirst: 6,
+        endsActive: true,
+        slugPrefix: "bid-spriggan-req",
+    }),
+    // ═══════════════════════════════════════════════════════════════════════════
+    // auction-shf-goku-ultra-instinct — ENDED (3 days ago), 6 bids → ₹14,999 WON
+    // ═══════════════════════════════════════════════════════════════════════════
+    ...buildBidLadder({
+        productId: "auction-shf-goku-ultra-instinct",
+        productTitle: "S.H.Figuarts Son Goku Ultra Instinct — Tamashii Limited (AUCTION ENDED)",
+        amounts: [599900, 799900, 999900, 1199900, 1349900, 1499900],
+        bidders: [
+            { id: "user-rohit-verma", name: "Rohit Verma", email: "rohit.verma@gmail.com" },
+            { id: "user-divya-menon", name: "Divya Menon", email: "divya.menon@gmail.com" },
+            { id: "user-siddharth-rao", name: "Siddharth Rao", email: "siddharth.rao@gmail.com" },
+            { id: "user-rohit-verma", name: "Rohit Verma", email: "rohit.verma@gmail.com" },
+            { id: "user-pooja-sharma", name: "Pooja Sharma", email: "pooja.sharma@gmail.com" },
+            { id: "user-divya-menon", name: "Divya Menon", email: "divya.menon@gmail.com" },
+        ],
+        daysAgoForFirst: 17,
+        endsActive: false,
+        closedDaysAgo: 3,
+        winningIndex: 5,
+        slugPrefix: "bid-goku-ui",
+    }),
+    // ═══════════════════════════════════════════════════════════════════════════
+    // auction-pokemon-blastoise-shadowless-bgs — ENDED (14d ago), 8 bids → ₹39,999 WON
+    // ═══════════════════════════════════════════════════════════════════════════
+    ...buildBidLadder({
+        productId: "auction-pokemon-blastoise-shadowless-bgs",
+        productTitle: "Pokémon Base Set Shadowless Blastoise #2 Holo — BGS 8.5 (AUCTION ENDED)",
+        amounts: [1499900, 1799900, 2099900, 2499900, 2899900, 3299900, 3599900, 3999900],
+        bidders: [
+            { id: "user-priya-singh", name: "Priya Singh", email: "priya.singh@gmail.com" },
+            { id: "user-amit-sharma", name: "Amit Sharma", email: "amit.sharma@gmail.com" },
+            { id: "user-arjun-singh", name: "Arjun Singh", email: "arjun.singh@gmail.com" },
+            { id: "user-priya-singh", name: "Priya Singh", email: "priya.singh@gmail.com" },
+            { id: "user-rahul-sharma", name: "Rahul Sharma", email: "rahul.sharma@gmail.com" },
+            { id: "user-amit-sharma", name: "Amit Sharma", email: "amit.sharma@gmail.com" },
+            { id: "user-arjun-singh", name: "Arjun Singh", email: "arjun.singh@gmail.com" },
+            { id: "user-rahul-sharma", name: "Rahul Sharma", email: "rahul.sharma@gmail.com" },
+        ],
+        daysAgoForFirst: 28,
+        endsActive: false,
+        closedDaysAgo: 14,
+        winningIndex: 7,
+        slugPrefix: "bid-blastoise-sl",
+    }),
+    // ═══════════════════════════════════════════════════════════════════════════
+    // auction-vintage-tomica-skyline-no-reserve-fail — ENDED no-winner, 3 bids
+    // ═══════════════════════════════════════════════════════════════════════════
+    ...buildBidLadder({
+        productId: "auction-vintage-tomica-skyline-no-reserve-fail",
+        productTitle: "Vintage Tomica Nissan Skyline GT-R Hakosuka 1973 — Reserve Not Met (AUCTION ENDED)",
+        amounts: [199900, 349900, 499900],
+        bidders: [
+            { id: "user-kiran-reddy", name: "Kiran Reddy", email: "kiran.reddy@gmail.com" },
+            { id: "user-preeti-joshi", name: "Preeti Joshi", email: "preeti.joshi@gmail.com" },
+            { id: "user-varun-bhat", name: "Varun Bhat", email: "varun.bhat@gmail.com" },
+        ],
+        daysAgoForFirst: 20,
+        endsActive: false,
+        closedDaysAgo: 10,
+        winningIndex: -1, // reserve not met — no winner
+        slugPrefix: "bid-skyline-fail",
+    }),
 ];
+/**
+ * Builds a strictly-increasing bid ladder for an auction. Status flags are
+ * applied so consumers can reason about isWinning + outbid history without
+ * recomputing from raw amounts.
+ */
+function buildBidLadder({ productId, productTitle, amounts, bidders, daysAgoForFirst, endsActive, closedDaysAgo, winningIndex, slugPrefix, }) {
+    if (amounts.length !== bidders.length) {
+        throw new Error(`buildBidLadder: amounts.length (${amounts.length}) !== bidders.length (${bidders.length}) for ${productId}`);
+    }
+    const last = amounts.length - 1;
+    const winIdx = winningIndex ?? (endsActive ? -1 : last);
+    return amounts.map((amount, i) => {
+        const bidder = bidders[i];
+        const isLast = i === last;
+        // Spread bid times linearly across (first → now/close)
+        const totalSpanDays = endsActive
+            ? daysAgoForFirst
+            : daysAgoForFirst - (closedDaysAgo ?? 0);
+        const offsetDays = totalSpanDays * (1 - i / Math.max(1, last));
+        const ageDays = (closedDaysAgo ?? 0) + offsetDays;
+        const status = winIdx === i
+            ? endsActive
+                ? "active"
+                : "won"
+            : isLast && endsActive
+                ? "active"
+                : !endsActive && winIdx === -1
+                    ? "outbid"
+                    : "outbid";
+        return {
+            id: `${slugPrefix}-${bidder.id.replace("user-", "")}-${i + 1}`,
+            productId,
+            productTitle,
+            userId: bidder.id,
+            userName: bidder.name,
+            userEmail: bidder.email,
+            bidAmount: amount,
+            currency: "INR",
+            status,
+            isWinning: isLast && endsActive ? true : winIdx === i,
+            previousBidAmount: i > 0 ? amounts[i - 1] : undefined,
+            bidDate: daysAgo(ageDays),
+            createdAt: daysAgo(ageDays),
+            updatedAt: daysAgo(ageDays),
+        };
+    });
+}