@mohasinac/appkit 2.4.10 → 2.5.0

package/dist/features/admin/components/sections/adminSectionsTypes.d.ts

@@ -1,4 +1,4 @@
-export declare const SECTION_TYPE_OPTIONS: readonly ["welcome", "stats", "trust-indicators", "categories", "brands", "products", "pre-orders", "auctions", "banner", "features", "reviews", "whatsapp-community", "faq", "blog-articles", "newsletter", "stores", "events", "social-feed", "carousel", "custom-cards", "google-reviews"];
+export declare const SECTION_TYPE_OPTIONS: readonly ["welcome", "stats", "trust-indicators", "categories", "brands", "products", "pre-orders", "auctions", "banner", "features", "reviews", "whatsapp-community", "faq", "blog-articles", "newsletter", "stores", "events", "social-feed", "carousel", "custom-cards", "google-reviews", "featured-bundles", "prize-draws", "event-raffles", "collection-cards"];
 export type SectionType = (typeof SECTION_TYPE_OPTIONS)[number];
 export interface SectionPatchPayload {
     enabled: boolean;
@@ -49,12 +49,24 @@ export interface AuctionsBuilderState {
     maxCount: ResourceMaxCount;
     loop: boolean;
 }
+export type StatsStatSource = "static" | "live-preset" | "live-collection";
 export interface StatsBuilderState {
     title: string;
     stats: Array<{
         key: string;
         label: string;
         value: string;
+        source: StatsStatSource;
+        /** Preset metric key when source is "live-preset". */
+        metric: string;
+        /** Firestore collection name when source is "live-collection". */
+        collection: string;
+        /** Optional field to filter by when source is "live-collection". */
+        filterField: string;
+        /** Filter value (string form) when source is "live-collection". */
+        filterValue: string;
+        /** Appended after the live value, e.g. "+" or "★". */
+        suffix: string;
     }>;
 }
 export interface PreOrdersBuilderState {
@@ -248,6 +260,51 @@ export interface GoogleReviewsBuilderState {
     linkToGoogleMaps: boolean;
     googleMapsUrl: string;
 }
+export interface FeaturedBundlesBuilderState {
+    title: string;
+    subtitle: string;
+    maxItems: number;
+    storeId: string;
+    categorySlug: string;
+    sortBy: "newest" | "savings-desc" | "price-asc";
+    showSavingsBadge: boolean;
+}
+export interface PrizeDrawsBuilderState {
+    title: string;
+    subtitle: string;
+    maxItems: number;
+    storeId: string;
+    revealStatus: "pending" | "open" | "all";
+    showCountdown: boolean;
+    showEntriesRemaining: boolean;
+}
+export interface EventRafflesBuilderState {
+    title: string;
+    subtitle: string;
+    maxItems: number;
+    raffleType: "raffle" | "spin_wheel" | "all";
+    showEntryCount: boolean;
+    showCountdown: boolean;
+}
+export type CollectionCardEntryType = "products" | "auctions" | "pre-orders" | "stores" | "events" | "blog-posts" | "reviews" | "brands" | "categories";
+export interface CollectionCardsEntryBuilderState {
+    type: CollectionCardEntryType;
+    label: string;
+    limit: number;
+    storeId: string;
+    categorySlug: string;
+    brandSlug: string;
+    featuredOnly: boolean;
+}
+export interface CollectionCardsBuilderState {
+    title: string;
+    subtitle: string;
+    layout: "carousel" | "grid" | "mixed-row";
+    itemsPerRow: 3 | 4 | 5;
+    maxItems: number;
+    showCollectionTabs: boolean;
+    collections: CollectionCardsEntryBuilderState[];
+}
 export declare const DEFAULT_PRODUCTS_BUILDER: ProductsBuilderState;
 export declare const DEFAULT_AUCTIONS_BUILDER: AuctionsBuilderState;
 export declare const DEFAULT_STATS_BUILDER: StatsBuilderState;
@@ -269,6 +326,10 @@ export declare const DEFAULT_NEWSLETTER_BUILDER: NewsletterBuilderState;
 export declare const DEFAULT_CAROUSEL_BUILDER: CarouselBuilderState;
 export declare const DEFAULT_CUSTOM_CARDS_BUILDER: CustomCardsBuilderState;
 export declare const DEFAULT_GOOGLE_REVIEWS_BUILDER: GoogleReviewsBuilderState;
+export declare const DEFAULT_FEATURED_BUNDLES_BUILDER: FeaturedBundlesBuilderState;
+export declare const DEFAULT_PRIZE_DRAWS_BUILDER: PrizeDrawsBuilderState;
+export declare const DEFAULT_EVENT_RAFFLES_BUILDER: EventRafflesBuilderState;
+export declare const DEFAULT_COLLECTION_CARDS_BUILDER: CollectionCardsBuilderState;
 export declare const SUPPORTED_TYPED_BUILDERS: SectionType[];
 export declare const RESOURCE_SORT_OPTIONS: readonly [{
     readonly label: "Latest";

package/dist/features/admin/components/sections/adminSectionsTypes.js

@@ -20,6 +20,10 @@ export const SECTION_TYPE_OPTIONS = [
     "carousel",
     "custom-cards",
     "google-reviews",
+    "featured-bundles",
+    "prize-draws",
+    "event-raffles",
+    "collection-cards",
 ];
 export const DEFAULT_PRODUCTS_BUILDER = {
     title: "Featured Products",
@@ -53,13 +57,21 @@ export const DEFAULT_AUCTIONS_BUILDER = {
     maxCount: 10,
     loop: false,
 };
+const DEFAULT_STAT_ROW = {
+    source: "static",
+    metric: "",
+    collection: "",
+    filterField: "",
+    filterValue: "",
+    suffix: "",
+};
 export const DEFAULT_STATS_BUILDER = {
     title: "Marketplace Stats",
     stats: [
-        { key: "products", label: "Products Listed", value: "10,000+" },
-        { key: "sellers", label: "Verified Sellers", value: "2,000+" },
-        { key: "buyers", label: "Happy Buyers", value: "50,000+" },
-        { key: "rating", label: "Average Rating", value: "4.8/5" },
+        { ...DEFAULT_STAT_ROW, key: "products", label: "Products Listed", value: "10,000+", source: "live-preset", metric: "total_listings", suffix: "+" },
+        { ...DEFAULT_STAT_ROW, key: "sellers", label: "Verified Sellers", value: "2,000+", source: "live-preset", metric: "verified_sellers", suffix: "+" },
+        { ...DEFAULT_STAT_ROW, key: "buyers", label: "Happy Buyers", value: "50,000+", source: "live-preset", metric: "total_buyers", suffix: "+" },
+        { ...DEFAULT_STAT_ROW, key: "rating", label: "Average Rating", value: "4.8/5", source: "live-preset", metric: "platform_rating" },
     ],
 };
 export const DEFAULT_PRE_ORDERS_BUILDER = {
@@ -235,6 +247,43 @@ export const DEFAULT_GOOGLE_REVIEWS_BUILDER = {
     linkToGoogleMaps: true,
     googleMapsUrl: "",
 };
+export const DEFAULT_FEATURED_BUNDLES_BUILDER = {
+    title: "Curated Bundles",
+    subtitle: "Everything you need in one deal",
+    maxItems: 8,
+    storeId: "",
+    categorySlug: "",
+    sortBy: "savings-desc",
+    showSavingsBadge: true,
+};
+export const DEFAULT_PRIZE_DRAWS_BUILDER = {
+    title: "Prize Draws",
+    subtitle: "Enter for a chance to win rare collectibles",
+    maxItems: 6,
+    storeId: "",
+    revealStatus: "all",
+    showCountdown: true,
+    showEntriesRemaining: true,
+};
+export const DEFAULT_EVENT_RAFFLES_BUILDER = {
+    title: "Live Raffles & Spin Wheels",
+    subtitle: "Participate in community events and win prizes",
+    maxItems: 4,
+    raffleType: "all",
+    showEntryCount: true,
+    showCountdown: true,
+};
+export const DEFAULT_COLLECTION_CARDS_BUILDER = {
+    title: "Featured Collections",
+    subtitle: "",
+    layout: "mixed-row",
+    itemsPerRow: 4,
+    maxItems: 12,
+    showCollectionTabs: false,
+    collections: [
+        { type: "products", label: "", limit: 4, storeId: "", categorySlug: "", brandSlug: "", featuredOnly: true },
+    ],
+};
 export const SUPPORTED_TYPED_BUILDERS = [
     "products",
     "auctions",
@@ -257,6 +306,10 @@ export const SUPPORTED_TYPED_BUILDERS = [
     "carousel",
     "custom-cards",
     "google-reviews",
+    "featured-bundles",
+    "prize-draws",
+    "event-raffles",
+    "collection-cards",
 ];
 export const RESOURCE_SORT_OPTIONS = [
     { label: "Latest", value: "latest" },

package/dist/features/admin/hooks/useChat.d.ts

@@ -19,6 +19,6 @@ export declare function useChat(chatId: string | null, options?: {
 export declare function useChatRooms(): import("@tanstack/react-query").UseQueryResult<unknown[], Error>;
 export declare function useCreateChatRoom(): import("@tanstack/react-query").UseMutationResult<unknown, Error, {
     orderId: string;
-    sellerId: string;
+    ownerId: string;
 }, unknown>;
 export declare function useDeleteChatRoom(): import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;

package/dist/features/admin/repository/chat.repository.d.ts

@@ -31,9 +31,9 @@ declare class ChatRepository extends BaseRepository<ChatRoomDocument> {
      */
     create(input: ChatRoomCreateInput): Promise<ChatRoomDocument>;
     /**
-     * Find existing room by buyerId + sellerId + orderId (idempotent create)
+     * Find existing room by buyerId + ownerId + orderId (idempotent create)
      */
-    findRoom(buyerId: string, sellerId: string, orderId: string): Promise<ChatRoomDocument | null>;
+    findRoom(buyerId: string, ownerId: string, orderId: string): Promise<ChatRoomDocument | null>;
     /**
      * Get all chat room IDs that the user can currently access.
      * Excludes rooms where the user has soft-deleted or where adminDeleted=true.

package/dist/features/admin/repository/chat.repository.js

@@ -42,7 +42,7 @@ class ChatRepository extends BaseRepository {
     async create(input) {
         const id = input.isGroup
             ? `chat_group_${Date.now()}`
-            : `chat_${input.buyerId}_${input.sellerId}_${input.orderId}`;
+            : `chat_${input.buyerId}_${input.ownerId}_${input.orderId}`;
         const doc = {
             ...input,
             deletedBy: [],
@@ -58,10 +58,10 @@ class ChatRepository extends BaseRepository {
         return { id, ...doc }; // return plaintext to caller
     }
     /**
-     * Find existing room by buyerId + sellerId + orderId (idempotent create)
+     * Find existing room by buyerId + ownerId + orderId (idempotent create)
      */
-    async findRoom(buyerId, sellerId, orderId) {
-        const id = `chat_${buyerId}_${sellerId}_${orderId}`;
+    async findRoom(buyerId, ownerId, orderId) {
+        const id = `chat_${buyerId}_${ownerId}_${orderId}`;
         return this.findById(id);
     }
     /**
@@ -76,7 +76,7 @@ class ChatRepository extends BaseRepository {
                     .where("adminDeleted", "==", false)
                     .get(),
                 this.getCollection()
-                    .where("sellerId", "==", userId)
+                    .where("ownerId", "==", userId)
                     .where("adminDeleted", "==", false)
                     .get(),
             ]);
@@ -106,7 +106,7 @@ class ChatRepository extends BaseRepository {
                     .orderBy("updatedAt", "desc")
                     .get(),
                 this.getCollection()
-                    .where("sellerId", "==", userId)
+                    .where("ownerId", "==", userId)
                     .where("adminDeleted", "==", false)
                     .orderBy("updatedAt", "desc")
                     .get(),
@@ -169,7 +169,7 @@ class ChatRepository extends BaseRepository {
             const deletedBy = Array.from(new Set([...(data.deletedBy ?? []), uid]));
             const bothDeleted = !data.isGroup &&
                 deletedBy.includes(data.buyerId) &&
-                deletedBy.includes(data.sellerId);
+                deletedBy.includes(data.ownerId);
             if (bothDeleted) {
                 // Permanently remove Firestore doc + RTDB messages
                 await docRef.delete();

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

@@ -79,12 +79,12 @@ export declare const notificationQueryHelpers: {
 export interface ChatRoomDocument {
     id: string;
     buyerId: string;
-    sellerId: string;
+    ownerId: string;
     orderId: string;
     productId?: string;
     productTitle?: string;
     buyerName: string;
-    sellerName: string;
+    ownerName: string;
     lastMessage?: string;
     lastMessageAt?: Date;
     createdAt: Date;
@@ -93,22 +93,22 @@ export interface ChatRoomDocument {
     deletedBy: string[];
     /** True for admin-created group chats (> 2 participants). */
     isGroup: boolean;
-    /** All participant UIDs. For 1-1 rooms: [buyerId, sellerId]. */
+    /** All participant UIDs. For 1-1 rooms: [buyerId, ownerId]. */
     participantIds: string[];
     /** Set by admin to permanently revoke all access. */
     adminDeleted: boolean;
 }
 export declare const CHAT_ROOM_COLLECTION: "chatRooms";
-export declare const CHAT_ROOM_INDEXED_FIELDS: readonly ["buyerId", "sellerId", "orderId", "participantIds", "adminDeleted", "updatedAt"];
+export declare const CHAT_ROOM_INDEXED_FIELDS: readonly ["buyerId", "ownerId", "orderId", "participantIds", "adminDeleted", "updatedAt"];
 export declare const CHAT_ROOM_FIELDS: {
     readonly ID: "id";
     readonly BUYER_ID: "buyerId";
-    readonly SELLER_ID: "sellerId";
+    readonly OWNER_ID: "ownerId";
     readonly ORDER_ID: "orderId";
     readonly PRODUCT_ID: "productId";
     readonly PRODUCT_TITLE: "productTitle";
     readonly BUYER_NAME: "buyerName";
-    readonly SELLER_NAME: "sellerName";
+    readonly OWNER_NAME: "ownerName";
     readonly LAST_MESSAGE: "lastMessage";
     readonly LAST_MESSAGE_AT: "lastMessageAt";
     readonly CREATED_AT: "createdAt";
@@ -123,7 +123,7 @@ export type ChatRoomCreateInput = Omit<ChatRoomDocument, "id" | "createdAt" | "u
 export type ChatRoomUpdateInput = Pick<ChatRoomDocument, "lastMessage" | "lastMessageAt" | "updatedAt">;
 export declare const chatRoomQueryHelpers: {
     readonly byBuyer: (buyerId: string) => readonly ["buyerId", "==", string];
-    readonly bySeller: (sellerId: string) => readonly ["sellerId", "==", string];
+    readonly byOwner: (ownerId: string) => readonly ["ownerId", "==", string];
     readonly byOrder: (orderId: string) => readonly ["orderId", "==", string];
     readonly active: () => readonly ["adminDeleted", "==", false];
 };
@@ -318,8 +318,43 @@ export interface SiteSettingsDocument {
         enabled: boolean;
         message: string;
     };
+    /**
+     * Image watermark configuration applied by the `/api/media/[...slug]` CDN
+     * proxy. When absent the proxy falls back to text watermark "letitrip.in" at
+     * 30% width with 20% opacity.
+     */
+    watermark?: {
+        /** `"text"` renders the `text` field; `"image"` overlays `imageUrl`. */
+        type: "text" | "image";
+        /** Text content for `type: "text"`. Default `"letitrip.in"`. */
+        text?: string;
+        /**
+         * `/media/<slug>` proxy URL of the watermark image (when `type: "image"`).
+         * Never store raw `firebasestorage.googleapis.com` URLs.
+         */
+        imageUrl?: string;
+        /** Percentage of target image width (0–100). 0 disables the watermark. */
+        size?: number;
+        /** Percentage opacity (0–100). Default 20. */
+        opacity?: number;
+    };
     /** Encrypted provider credentials � never return raw to the client. */
     credentials?: SiteSettingsCredentials;
+    /**
+     * Theme color overrides — injected as CSS custom properties by LayoutShellClient.
+     * Keys map to --appkit-color-* variables (e.g. primary → --appkit-color-primary).
+     * When absent, the compiled token defaults from dist/tokens.css apply.
+     */
+    theme?: {
+        /** Light-mode brand colour overrides (default / all modes when dark variants absent) */
+        primary?: string;
+        secondary?: string;
+        accent?: string;
+        /** Dark-mode brand colour overrides — applied under .dark selector */
+        primaryDark?: string;
+        secondaryDark?: string;
+        accentDark?: string;
+    };
     featuredResults?: FeaturedResult[];
     createdAt: Date;
     updatedAt: Date;

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

@@ -83,7 +83,7 @@ export const notificationQueryHelpers = {
 export const CHAT_ROOM_COLLECTION = "chatRooms";
 export const CHAT_ROOM_INDEXED_FIELDS = [
     "buyerId",
-    "sellerId",
+    "ownerId",
     "orderId",
     "participantIds",
     "adminDeleted",
@@ -92,12 +92,12 @@ export const CHAT_ROOM_INDEXED_FIELDS = [
 export const CHAT_ROOM_FIELDS = {
     ID: "id",
     BUYER_ID: "buyerId",
-    SELLER_ID: "sellerId",
+    OWNER_ID: "ownerId",
     ORDER_ID: "orderId",
     PRODUCT_ID: "productId",
     PRODUCT_TITLE: "productTitle",
     BUYER_NAME: "buyerName",
-    SELLER_NAME: "sellerName",
+    OWNER_NAME: "ownerName",
     LAST_MESSAGE: "lastMessage",
     LAST_MESSAGE_AT: "lastMessageAt",
     CREATED_AT: "createdAt",
@@ -109,10 +109,10 @@ export const CHAT_ROOM_FIELDS = {
 };
 export const DEFAULT_CHAT_ROOM_DATA = {
     buyerId: "",
-    sellerId: "",
+    ownerId: "",
     orderId: "",
     buyerName: "",
-    sellerName: "",
+    ownerName: "",
     deletedBy: [],
     isGroup: false,
     participantIds: [],
@@ -120,7 +120,7 @@ export const DEFAULT_CHAT_ROOM_DATA = {
 };
 export const chatRoomQueryHelpers = {
     byBuyer: (buyerId) => ["buyerId", "==", buyerId],
-    bySeller: (sellerId) => ["sellerId", "==", sellerId],
+    byOwner: (ownerId) => ["ownerId", "==", ownerId],
     byOrder: (orderId) => ["orderId", "==", orderId],
     active: () => ["adminDeleted", "==", false],
 };
@@ -155,7 +155,7 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         notifications: true,
         sellerRegistration: true,
         preOrders: false,
-        seedPanel: false,
+        seedPanel: true,
     },
     shipping: {
         estimatedDays: 5,

package/dist/features/admin/types/product.types.d.ts

@@ -47,7 +47,8 @@ export interface AdminProduct {
     insurance?: boolean;
     insuranceCost?: number;
     shippingPaidBy?: "seller" | "buyer";
-    isAuction?: boolean;
+    /** Canonical listing-kind discriminator (SB1-G Phase 4 — booleans removed). */
+    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
     auctionEndDate?: string;
     startingBid?: number;
     currentBid?: number;
@@ -62,7 +63,6 @@ export interface AdminProduct {
     isPromoted?: boolean;
     promotionEndDate?: string;
     pickupAddressId?: string;
-    isPreOrder?: boolean;
     preOrderDeliveryDate?: string;
     preOrderDepositPercent?: number;
     preOrderMaxQuantity?: number;

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

@@ -7,6 +7,7 @@
 import { serverLogger } from "../../../monitoring";
 import { bidRepository } from "../repository/bid.repository";
 import { productRepository } from "../../products/repository/products.repository";
+import { isAuctionListing } from "../../products/utils/listing-type";
 import { userRepository } from "../../auth/repository/user.repository";
 import { unitOfWork } from "../../../core/unit-of-work";
 import { storeRepository } from "../../stores/repository/store.repository";
@@ -21,7 +22,7 @@ export async function placeBid(userId, userEmail, input) {
     const product = await productRepository.findById(productId);
     if (!product)
         throw new NotFoundError(ERROR_MESSAGES.BID.AUCTION_NOT_FOUND);
-    if (!product.isAuction)
+    if (!isAuctionListing(product))
         throw new ValidationError(ERROR_MESSAGES.BID.NOT_AN_AUCTION);
     if (product.auctionEndDate) {
         const endDate = resolveDate(product.auctionEndDate);
@@ -96,7 +97,7 @@ export async function placeBid(userId, userEmail, input) {
 export async function listBidsByProduct(productId, params) {
     const result = await bidRepository.list({
         filters: `productId==${productId}`,
-        sorts: "-bidAmount",
+        sorts: "-bidDate",
         page: params?.page ?? 1,
         pageSize: params?.pageSize ?? 20,
     });

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

@@ -1,6 +1,16 @@
+import type { ProductFeatureDocument } from "../../products/schemas/product-features";
 import type { PlaceBidInput } from "./PlaceBidFormClient";
 export interface AuctionDetailPageViewProps {
     id: string;
+    /**
+     * Pre-fetched auction document from the page's server data layer.
+     * When provided, the internal repository call is skipped — deduplicating
+     * the fetch with generateMetadata() via React.cache().
+     * When absent, falls back to fetching by slug/id (backward compat).
+     */
+    initialAuction?: import("../../products/schemas/firestore").ProductDocument | null;
     onPlaceBid?: (input: PlaceBidInput) => Promise<unknown>;
+    /** SSR-loaded productFeatures (platform + store-scope). See ProductDetailPageView for semantics. */
+    productFeatures?: ProductFeatureDocument[];
 }
-export declare function AuctionDetailPageView({ id, onPlaceBid }: AuctionDetailPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function AuctionDetailPageView({ id, initialAuction, onPlaceBid, productFeatures }: AuctionDetailPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;