@mohasinac/appkit 2.4.10 → 2.5.0

package/dist/features/messages/repository/conversations.repository.js

@@ -0,0 +1,180 @@
+/**
+ * ConversationsRepository — buyer↔seller messaging.
+ *
+ * One document per buyer×storeId×productId tuple. Messages are embedded in
+ * the document as an array (good up to ~200 entries; migrate to subcollection
+ * later if threads explode).
+ *
+ * All mutations are transactional so concurrent writes don't drop messages
+ * or unread counters.
+ */
+import { getAdminDb } from "../../../providers/db-firebase";
+import { serverLogger } from "../../../monitoring";
+import { CONVERSATIONS_COLLECTION, } from "../schemas/firestore";
+function toDate(raw) {
+    if (raw instanceof Date)
+        return raw;
+    if (raw && typeof raw.toDate === "function") {
+        return raw.toDate();
+    }
+    if (typeof raw === "string" || typeof raw === "number")
+        return new Date(raw);
+    return new Date();
+}
+function normaliseMessage(raw) {
+    const r = (raw ?? {});
+    return {
+        id: String(r.id ?? ""),
+        senderId: String(r.senderId ?? ""),
+        senderRole: r.senderRole ?? "buyer",
+        body: String(r.body ?? ""),
+        isRead: r.isRead === true,
+        sentAt: toDate(r.sentAt),
+        attachments: Array.isArray(r.attachments)
+            ? r.attachments
+            : undefined,
+    };
+}
+function normaliseDoc(id, raw) {
+    return {
+        id,
+        buyerId: String(raw.buyerId ?? ""),
+        buyerDisplayName: String(raw.buyerDisplayName ?? ""),
+        storeId: String(raw.storeId ?? ""),
+        storeName: String(raw.storeName ?? ""),
+        sellerDisplayName: String(raw.sellerDisplayName ?? ""),
+        productId: typeof raw.productId === "string" ? raw.productId : undefined,
+        productTitle: typeof raw.productTitle === "string" ? raw.productTitle : undefined,
+        messages: Array.isArray(raw.messages) ? raw.messages.map(normaliseMessage) : [],
+        lastMessage: String(raw.lastMessage ?? ""),
+        lastMessageAt: toDate(raw.lastMessageAt),
+        unreadBuyer: typeof raw.unreadBuyer === "number" ? raw.unreadBuyer : 0,
+        unreadSeller: typeof raw.unreadSeller === "number" ? raw.unreadSeller : 0,
+        status: raw.status ?? "active",
+        createdAt: toDate(raw.createdAt),
+        updatedAt: toDate(raw.updatedAt),
+    };
+}
+export class ConversationFullError extends Error {
+    constructor() {
+        super(...arguments);
+        this.code = "CONVERSATION_FULL";
+    }
+}
+export class ConversationsRepository {
+    collection() {
+        return getAdminDb().collection(CONVERSATIONS_COLLECTION);
+    }
+    async findById(id) {
+        const snap = await this.collection().doc(id).get();
+        if (!snap.exists)
+            return null;
+        return normaliseDoc(snap.id, snap.data() ?? {});
+    }
+    async listByBuyer(buyerId) {
+        const snap = await this.collection()
+            .where("buyerId", "==", buyerId)
+            .orderBy("lastMessageAt", "desc")
+            .get();
+        return snap.docs.map((d) => normaliseDoc(d.id, d.data()));
+    }
+    async listByStore(storeId) {
+        const snap = await this.collection()
+            .where("storeId", "==", storeId)
+            .orderBy("lastMessageAt", "desc")
+            .get();
+        return snap.docs.map((d) => normaliseDoc(d.id, d.data()));
+    }
+    /**
+     * Append a message to a conversation in a transaction. Bumps the counterparty
+     * unread counter; updates lastMessage / lastMessageAt / updatedAt.
+     */
+    async appendMessage(conversationId, msg) {
+        const db = getAdminDb();
+        const ref = this.collection().doc(conversationId);
+        try {
+            return await db.runTransaction(async (tx) => {
+                const snap = await tx.get(ref);
+                if (!snap.exists) {
+                    throw new Error("Conversation not found");
+                }
+                const data = snap.data() ?? {};
+                const existing = Array.isArray(data.messages)
+                    ? data.messages.map(normaliseMessage)
+                    : [];
+                const now = msg.sentAt ?? new Date();
+                const newMessage = {
+                    id: msg.id ?? `msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+                    senderId: msg.senderId,
+                    senderRole: msg.senderRole,
+                    body: msg.body,
+                    isRead: false,
+                    sentAt: now,
+                    attachments: msg.attachments,
+                };
+                const nextMessages = [...existing, newMessage];
+                const unreadBuyer = msg.senderRole === "seller"
+                    ? (typeof data.unreadBuyer === "number" ? data.unreadBuyer : 0) + 1
+                    : (typeof data.unreadBuyer === "number" ? data.unreadBuyer : 0);
+                const unreadSeller = msg.senderRole === "buyer"
+                    ? (typeof data.unreadSeller === "number" ? data.unreadSeller : 0) + 1
+                    : (typeof data.unreadSeller === "number" ? data.unreadSeller : 0);
+                const patch = {
+                    messages: nextMessages,
+                    lastMessage: msg.body,
+                    lastMessageAt: now,
+                    unreadBuyer,
+                    unreadSeller,
+                    updatedAt: now,
+                };
+                tx.update(ref, patch);
+                return normaliseDoc(conversationId, { ...data, ...patch });
+            });
+        }
+        catch (error) {
+            serverLogger.error("ConversationsRepository.appendMessage error", {
+                conversationId,
+                error,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Zero out the unread counter for one party. Also flips `isRead` on the
+     * embedded messages sent by the other party so the seller side can see what
+     * the buyer has already read.
+     */
+    async markRead(conversationId, role) {
+        const db = getAdminDb();
+        const ref = this.collection().doc(conversationId);
+        try {
+            await db.runTransaction(async (tx) => {
+                const snap = await tx.get(ref);
+                if (!snap.exists)
+                    return;
+                const data = snap.data() ?? {};
+                const messages = Array.isArray(data.messages)
+                    ? data.messages.map(normaliseMessage)
+                    : [];
+                // role="buyer" means the buyer just opened the chat → mark all
+                // seller-sent messages read.
+                const otherRole = role === "buyer" ? "seller" : "buyer";
+                const nextMessages = messages.map((m) => m.senderRole === otherRole && !m.isRead ? { ...m, isRead: true } : m);
+                tx.update(ref, {
+                    messages: nextMessages,
+                    [role === "buyer" ? "unreadBuyer" : "unreadSeller"]: 0,
+                    updatedAt: new Date(),
+                });
+            });
+        }
+        catch (error) {
+            serverLogger.error("ConversationsRepository.markRead error", {
+                conversationId,
+                role,
+                error,
+            });
+            throw error;
+        }
+    }
+}
+export const conversationsRepository = new ConversationsRepository();

package/dist/features/messages/server.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @mohasinac/appkit/features/messages/server
+ * Server-only entry point for the messages domain.
+ */
+export * from "./actions";
+export { ConversationsRepository, conversationsRepository, ConversationFullError, } from "./repository/conversations.repository";

package/dist/features/messages/server.js

@@ -0,0 +1,6 @@
+/**
+ * @mohasinac/appkit/features/messages/server
+ * Server-only entry point for the messages domain.
+ */
+export * from "./actions";
+export { ConversationsRepository, conversationsRepository, ConversationFullError, } from "./repository/conversations.repository";

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

@@ -115,6 +115,27 @@ export interface OrderDocument {
     payoutStatus?: OrderPayoutStatus;
     payoutId?: string;
     offerId?: string;
+    /**
+     * Populated when the linked product is a prize-draw and the reveal has
+     * assigned a prize to this order. `wonAt` is the moment of assignment, not
+     * the moment the order was placed.
+     */
+    prizeWon?: {
+        itemNumber: number;
+        title: string;
+        images: string[];
+        wonAt: Date;
+    };
+    /** Deadline for the buyer to claim the won prize (typically 7 days). */
+    prizeRevealDeadline?: Date;
+    /** True once `prizeRevealDeadline` passes without a claim — auto-forfeit. */
+    prizeRevealExpired?: boolean;
+    /** Source product id when the order came from a prize-draw entry. */
+    prizeDrawProductId?: string;
+    /** True for prize-draw entries and bundle purchases that bypass refund. */
+    isNonRefundable?: boolean;
+    /** Set when the order came from a bundle — points back to `bundles/{id}`. */
+    bundleId?: string;
     createdAt: Date;
     updatedAt: Date;
 }

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

@@ -15,18 +15,18 @@ export declare const orderItemSchema: z.ZodObject<{
     productId: string;
     quantity: number;
     price: number;
-    image?: string | undefined;
-    storeId?: string | undefined;
     currency?: string | undefined;
+    storeId?: string | undefined;
+    image?: string | undefined;
     attributes?: Record<string, string> | undefined;
 }, {
     title: string;
     productId: string;
     quantity: number;
     price: number;
-    image?: string | undefined;
-    storeId?: string | undefined;
     currency?: string | undefined;
+    storeId?: string | undefined;
+    image?: string | undefined;
     attributes?: Record<string, string> | undefined;
 }>;
 export declare const orderTimelineSchema: z.ZodObject<{
@@ -35,12 +35,12 @@ export declare const orderTimelineSchema: z.ZodObject<{
     timestamp: z.ZodString;
     actor: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested";
+    status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned";
     timestamp: string;
     message?: string | undefined;
     actor?: string | undefined;
 }, {
-    status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested";
+    status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned";
     timestamp: string;
     message?: string | undefined;
     actor?: string | undefined;
@@ -75,18 +75,18 @@ export declare const orderSchema: z.ZodObject<{
         productId: string;
         quantity: number;
         price: number;
-        image?: string | undefined;
-        storeId?: string | undefined;
         currency?: string | undefined;
+        storeId?: string | undefined;
+        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }, {
         title: string;
         productId: string;
         quantity: number;
         price: number;
-        image?: string | undefined;
-        storeId?: string | undefined;
         currency?: string | undefined;
+        storeId?: string | undefined;
+        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }>, "many">;
     address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -109,12 +109,12 @@ export declare const orderSchema: z.ZodObject<{
         timestamp: z.ZodString;
         actor: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested";
+        status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned";
         timestamp: string;
         message?: string | undefined;
         actor?: string | undefined;
     }, {
-        status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested";
+        status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned";
         timestamp: string;
         message?: string | undefined;
         actor?: string | undefined;
@@ -122,6 +122,7 @@ export declare const orderSchema: z.ZodObject<{
     createdAt: z.ZodOptional<z.ZodString>;
     updatedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    currency: string;
     id: string;
     address: Record<string, unknown>;
     items: {
@@ -129,34 +130,34 @@ export declare const orderSchema: z.ZodObject<{
         productId: string;
         quantity: number;
         price: number;
-        image?: string | undefined;
-        storeId?: string | undefined;
         currency?: string | undefined;
+        storeId?: string | undefined;
+        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }[];
-    currency: string;
     total: number;
     userId: string;
     subtotal: number;
     paymentStatus: string;
-    orderStatus: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested";
+    orderStatus: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned";
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     notes?: string | undefined;
-    trackingNumber?: string | undefined;
     tax?: number | undefined;
+    trackingNumber?: string | undefined;
     couponCode?: string | undefined;
     shippingCarrier?: string | undefined;
     paymentGateway?: string | undefined;
     shippingCost?: number | undefined;
     discount?: number | undefined;
     timeline?: {
-        status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested";
+        status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned";
         timestamp: string;
         message?: string | undefined;
         actor?: string | undefined;
     }[] | undefined;
 }, {
+    currency: string;
     id: string;
     address: Record<string, unknown>;
     items: {
@@ -164,29 +165,28 @@ export declare const orderSchema: z.ZodObject<{
         productId: string;
         quantity: number;
         price: number;
-        image?: string | undefined;
-        storeId?: string | undefined;
         currency?: string | undefined;
+        storeId?: string | undefined;
+        image?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }[];
-    currency: string;
     total: number;
     userId: string;
     subtotal: number;
     paymentStatus: string;
-    orderStatus: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested";
+    orderStatus: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned";
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     notes?: string | undefined;
-    trackingNumber?: string | undefined;
     tax?: number | undefined;
+    trackingNumber?: string | undefined;
     couponCode?: string | undefined;
     shippingCarrier?: string | undefined;
     paymentGateway?: string | undefined;
     shippingCost?: number | undefined;
     discount?: number | undefined;
     timeline?: {
-        status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested";
+        status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned";
         timestamp: string;
         message?: string | undefined;
         actor?: string | undefined;
@@ -202,16 +202,16 @@ export declare const orderListParamsSchema: z.ZodObject<{
     perPage: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     sort?: string | undefined;
-    page?: number | undefined;
     perPage?: number | undefined;
+    page?: number | undefined;
     userId?: string | undefined;
     paymentStatus?: string | undefined;
-    orderStatus?: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested" | undefined;
+    orderStatus?: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned" | undefined;
 }, {
     sort?: string | undefined;
-    page?: number | undefined;
     perPage?: number | undefined;
+    page?: number | undefined;
     userId?: string | undefined;
     paymentStatus?: string | undefined;
-    orderStatus?: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested" | undefined;
+    orderStatus?: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "return_requested" | "returned" | undefined;
 }>;

package/dist/features/orders/utils/order-splitter.d.ts

@@ -3,12 +3,22 @@ export interface OrderGroup<T> {
     items: T[];
     orderType: OrderType;
 }
+/**
+ * Split a sequence of cart-items into order groups by `OrderType`.
+ *
+ * Auctions and offers each settle as their own single-item order (the auction
+ * win is one transaction; an accepted offer is locked to one item). Pre-orders
+ * and standard items are grouped per-store so each store gets a single
+ * shipment.
+ *
+ * SB1-G Phase 4 — keys off the canonical `CartItem.listingType` discriminator
+ * instead of the legacy `isAuction` / `isPreOrder` booleans.
+ */
 export declare function splitCartIntoOrderGroups<T extends {
     item: {
         itemId: string;
         storeId?: string;
-        isAuction?: boolean;
-        isPreOrder?: boolean;
+        listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
         isOffer?: boolean;
     };
 }>(checks: T[]): OrderGroup<T>[];

package/dist/features/orders/utils/order-splitter.js

@@ -1,10 +1,21 @@
+/**
+ * Split a sequence of cart-items into order groups by `OrderType`.
+ *
+ * Auctions and offers each settle as their own single-item order (the auction
+ * win is one transaction; an accepted offer is locked to one item). Pre-orders
+ * and standard items are grouped per-store so each store gets a single
+ * shipment.
+ *
+ * SB1-G Phase 4 — keys off the canonical `CartItem.listingType` discriminator
+ * instead of the legacy `isAuction` / `isPreOrder` booleans.
+ */
 export function splitCartIntoOrderGroups(checks) {
     const groups = new Map();
     for (const check of checks) {
         const { item } = check;
         let key;
         let orderType;
-        if (item.isAuction) {
+        if (item.listingType === "auction") {
             key = `auction:${item.itemId}`;
             orderType = "auction";
         }
@@ -12,7 +23,7 @@ export function splitCartIntoOrderGroups(checks) {
             key = `offer:${item.itemId}`;
             orderType = "offer";
         }
-        else if (item.isPreOrder) {
+        else if (item.listingType === "pre-order") {
             key = `preorder:${item.storeId ?? "unknown"}`;
             orderType = "preorder";
         }

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

@@ -38,10 +38,10 @@ export declare const paymentRecordSchema: z.ZodObject<{
     status: z.ZodDefault<z.ZodEnum<["pending", "authorized", "captured", "failed", "refunded", "partially_refunded"]>>;
     createdAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    currency: string;
     id: string;
-    status: "pending" | "failed" | "captured" | "authorized" | "refunded" | "partially_refunded";
+    status: "failed" | "captured" | "pending" | "authorized" | "refunded" | "partially_refunded";
     amount: number;
-    currency: string;
     orderId: string;
     gateway: "bank_transfer" | "upi" | "razorpay" | "stripe" | "paypal" | "cod" | "whatsapp";
     createdAt?: string | undefined;
@@ -51,9 +51,9 @@ export declare const paymentRecordSchema: z.ZodObject<{
     amount: number;
     orderId: string;
     gateway: "bank_transfer" | "upi" | "razorpay" | "stripe" | "paypal" | "cod" | "whatsapp";
-    status?: "pending" | "failed" | "captured" | "authorized" | "refunded" | "partially_refunded" | undefined;
-    createdAt?: string | undefined;
     currency?: string | undefined;
+    createdAt?: string | undefined;
+    status?: "failed" | "captured" | "pending" | "authorized" | "refunded" | "partially_refunded" | undefined;
     gatewayPaymentId?: string | undefined;
 }>;
 export declare const paymentGatewayConfigSchema: z.ZodObject<{
@@ -64,14 +64,14 @@ export declare const paymentGatewayConfigSchema: z.ZodObject<{
     sortOrder: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    displayName: string;
     gateway: "bank_transfer" | "upi" | "razorpay" | "stripe" | "paypal" | "cod" | "whatsapp";
     isEnabled: boolean;
+    displayName: string;
     sortOrder: number;
 }, {
     id: string;
-    displayName: string;
     gateway: "bank_transfer" | "upi" | "razorpay" | "stripe" | "paypal" | "cod" | "whatsapp";
+    displayName: string;
     isEnabled?: boolean | undefined;
     sortOrder?: number | undefined;
 }>;

package/dist/features/pre-orders/api/route.js

@@ -10,20 +10,19 @@
  */
 import { NextResponse } from "next/server.js";
 import { getProviders } from "../../../contracts";
-function numParam(url, key, fallback) {
-    const v = url.searchParams.get(key);
-    const n = v !== null ? Number(v) : NaN;
-    return Number.isFinite(n) ? n : fallback;
-}
+import { parseListingParams } from "../../../utils/listing-params";
+const DEFAULT_PAGE = 1;
+const DEFAULT_PAGE_SIZE = 20;
+const MAX_PAGE_SIZE = 100;
+const DEFAULT_SORT = "-createdAt";
 export async function GET(request) {
     try {
         const url = new URL(request.url);
-        const page = Math.max(1, numParam(url, "page", 1));
-        const pageSize = Math.min(100, Math.max(1, numParam(url, "pageSize", 20)));
-        const filters = url.searchParams.get("filters") ?? undefined;
-        const sort = url.searchParams.get("sorts") ??
-            url.searchParams.get("sort") ??
-            "-createdAt";
+        const std = parseListingParams(url);
+        const page = Math.max(1, std.page ?? DEFAULT_PAGE);
+        const pageSize = Math.min(MAX_PAGE_SIZE, Math.max(1, std.pageSize ?? DEFAULT_PAGE_SIZE));
+        const filters = std.filters ?? undefined;
+        const sort = std.sorts ?? DEFAULT_SORT;
         const { db } = getProviders();
         if (!db)
             return NextResponse.json({ success: false, error: "DB not configured" }, { status: 503 });

package/dist/features/pre-orders/components/PreOrderDetailPageView.d.ts

@@ -1,5 +1,15 @@
+import type { ProductFeatureDocument } from "../../products/schemas/product-features";
 export interface PreOrderDetailPageViewProps {
     id: string;
+    /**
+     * Pre-fetched product 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).
+     */
+    initialPreOrder?: import("../../products/schemas/firestore").ProductDocument | null;
     onReserveNow?: (productId: string) => Promise<void>;
+    /** SSR-loaded productFeatures (platform + store-scope). See ProductDetailPageView for semantics. */
+    productFeatures?: ProductFeatureDocument[];
 }
-export declare function PreOrderDetailPageView({ id, onReserveNow }: PreOrderDetailPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow, productFeatures }: PreOrderDetailPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;