@mohasinac/appkit 2.4.11 → 2.5.1

package/dist/_internal/server/features/grouped/data.js

@@ -0,0 +1,116 @@
+import { cache } from "react";
+import { getAdminDb } from "../../../../providers/db-firebase";
+import { GROUPED_LISTINGS_COLLECTION, } from "../../../../features/grouped/schemas/firestore";
+import { productRepository } from "../../../../repositories";
+import { GROUPED_LISTINGS_FEATURED_LIMIT, GROUPED_LISTINGS_PAGE_SIZE, GROUPED_LISTINGS_SITEMAP_LIMIT, } from "../../../shared/features/grouped/config";
+function mapDoc(doc) {
+    const data = doc.data();
+    const ts = (v) => {
+        const d = v?.toDate?.();
+        return d ?? (v instanceof Date ? v : new Date());
+    };
+    return {
+        id: doc.id,
+        slug: data.slug ?? doc.id,
+        title: data.title ?? "",
+        description: data.description,
+        productIds: Array.isArray(data.productIds) ? data.productIds : [],
+        coverImage: data.coverImage,
+        bundlePrice: data.bundlePrice,
+        originalPrice: data.originalPrice,
+        discountPercent: data.discountPercent,
+        currency: (data.currency ?? "INR"),
+        isActive: data.isActive === true,
+        isFeatured: data.isFeatured === true,
+        storeId: data.storeId,
+        brandSlug: data.brandSlug,
+        categorySlug: data.categorySlug,
+        createdBy: data.createdBy ?? "",
+        createdAt: ts(data.createdAt),
+        updatedAt: ts(data.updatedAt),
+    };
+}
+/** Fetch a grouped listing by slug, deduped per request. */
+export const getGroupedListingForDetail = cache(async (slug) => {
+    try {
+        const db = getAdminDb();
+        const snap = await db
+            .collection(GROUPED_LISTINGS_COLLECTION)
+            .where("slug", "==", slug)
+            .limit(1)
+            .get();
+        if (snap.empty) {
+            const byId = await db.collection(GROUPED_LISTINGS_COLLECTION).doc(slug).get();
+            if (!byId.exists)
+                return null;
+            return mapDoc(byId);
+        }
+        return mapDoc(snap.docs[0]);
+    }
+    catch {
+        return null;
+    }
+});
+/** Fetch a grouped listing with its member products resolved, deduped per request. */
+export const getGroupedListingWithItems = cache(async (slug) => {
+    const doc = await getGroupedListingForDetail(slug);
+    if (!doc)
+        return null;
+    const items = [];
+    for (const productId of doc.productIds) {
+        const product = await productRepository.findByIdOrSlug(productId).catch(() => null);
+        if (product)
+            items.push(product);
+    }
+    return { ...doc, items };
+});
+/** List active grouped listings, newest first. */
+export async function listGroupedListings(params = {}) {
+    try {
+        const db = getAdminDb();
+        let q = db
+            .collection(GROUPED_LISTINGS_COLLECTION)
+            .where("isActive", "==", true);
+        if (params.featuredOnly)
+            q = q.where("isFeatured", "==", true);
+        if (params.storeId)
+            q = q.where("storeId", "==", params.storeId);
+        if (params.brandSlug)
+            q = q.where("brandSlug", "==", params.brandSlug);
+        if (params.categorySlug)
+            q = q.where("categorySlug", "==", params.categorySlug);
+        const snap = await q
+            .orderBy("createdAt", "desc")
+            .limit(params.limit ?? GROUPED_LISTINGS_PAGE_SIZE)
+            .get();
+        return snap.docs.map(mapDoc);
+    }
+    catch {
+        return [];
+    }
+}
+/** Featured grouped listings for homepage strips. */
+export const listFeaturedGroupedListings = cache(async (limit = GROUPED_LISTINGS_FEATURED_LIMIT) => {
+    return listGroupedListings({ featuredOnly: true, limit });
+});
+export async function listSitemapGroupedListings() {
+    try {
+        const db = getAdminDb();
+        const snap = await db
+            .collection(GROUPED_LISTINGS_COLLECTION)
+            .where("isActive", "==", true)
+            .select("slug", "updatedAt")
+            .limit(GROUPED_LISTINGS_SITEMAP_LIMIT)
+            .get();
+        return snap.docs.map((d) => {
+            const data = d.data();
+            return {
+                slug: data.slug ?? d.id,
+                updatedAt: data.updatedAt?.toDate?.() ?? new Date(),
+            };
+        });
+    }
+    catch {
+        return [];
+    }
+}

package/dist/_internal/server/features/grouped/index.d.ts

@@ -0,0 +1,2 @@
+export { getGroupedListingForDetail, getGroupedListingWithItems, listGroupedListings, listFeaturedGroupedListings, listSitemapGroupedListings, type GroupedListingWithItems, type ListGroupedListingsParams, type SitemapGroupedListing, } from "./data";
+export { GROUPED_LISTINGS_PAGE_SIZE, GROUPED_LISTINGS_FEATURED_LIMIT, GROUPED_LISTINGS_SITEMAP_LIMIT, } from "../../../shared/features/grouped/config";

package/dist/_internal/server/features/grouped/index.js

@@ -0,0 +1,2 @@
+export { getGroupedListingForDetail, getGroupedListingWithItems, listGroupedListings, listFeaturedGroupedListings, listSitemapGroupedListings, } from "./data";
+export { GROUPED_LISTINGS_PAGE_SIZE, GROUPED_LISTINGS_FEATURED_LIMIT, GROUPED_LISTINGS_SITEMAP_LIMIT, } from "../../../shared/features/grouped/config";

package/dist/_internal/server/features/history/actions.d.ts

@@ -0,0 +1,8 @@
+import { type UserHistoryItem, type HistoryProductType } from "../../../../repositories";
+export declare function trackProductViewAction(productId: string, productType: HistoryProductType, productSnapshot?: UserHistoryItem["productSnapshot"]): Promise<void>;
+export declare function mergeGuestHistoryAction(guestItems: Array<{
+    productId: string;
+    productType: HistoryProductType;
+    viewedAt?: Date;
+    productSnapshot?: UserHistoryItem["productSnapshot"];
+}>): Promise<number>;

package/dist/_internal/server/features/history/actions.js

@@ -0,0 +1,15 @@
+"use server";
+import { requireRoleUser } from "../../../../providers/auth-firebase/helpers";
+import { historyRepository, } from "../../../../repositories";
+export async function trackProductViewAction(productId, productType, productSnapshot) {
+    const user = await requireRoleUser(["buyer", "seller", "admin"]);
+    await historyRepository.track(user.uid, {
+        productId,
+        productType,
+        productSnapshot,
+    });
+}
+export async function mergeGuestHistoryAction(guestItems) {
+    const user = await requireRoleUser(["buyer", "seller", "admin"]);
+    return historyRepository.merge(user.uid, guestItems);
+}

package/dist/_internal/server/features/history/data.d.ts

@@ -0,0 +1,7 @@
+import { type UserHistoryItem } from "../../../../repositories";
+export declare const getHistoryForUser: (userId: string) => Promise<{
+    items: UserHistoryItem[];
+    meta: {
+        total: number;
+    };
+}>;

package/dist/_internal/server/features/history/data.js

@@ -0,0 +1,6 @@
+import { cache } from "react";
+import { historyRepository } from "../../../../repositories";
+export const getHistoryForUser = cache(async (userId) => {
+    const items = await historyRepository.getHistory(userId).catch(() => []);
+    return { items, meta: { total: items.length } };
+});

package/dist/_internal/server/features/history/index.d.ts

@@ -0,0 +1,3 @@
+export { getHistoryForUser } from "./data";
+export { trackProductViewAction, mergeGuestHistoryAction } from "./actions";
+export { HISTORY_MAX, HISTORY_GUEST_STORAGE_KEY } from "../../../shared/features/history/config";

package/dist/_internal/server/features/history/index.js

@@ -0,0 +1,3 @@
+export { getHistoryForUser } from "./data";
+export { trackProductViewAction, mergeGuestHistoryAction } from "./actions";
+export { HISTORY_MAX, HISTORY_GUEST_STORAGE_KEY } from "../../../shared/features/history/config";

package/dist/_internal/server/features/homepage/data.d.ts

@@ -0,0 +1,18 @@
+export declare const getHomepageSections: () => Promise<never[] | import("../../../..").HomepageSectionDocument[]>;
+export declare const getHeroCarouselSlides: () => Promise<never[] | import("../../../..").CarouselSlideDocument[]>;
+/**
+ * One parallel fetch returning every piece of data the homepage sections need.
+ * Page components call this once; React.cache() deduplicates per request.
+ */
+export declare const getHomepageInitial: () => Promise<{
+    sections: never[] | import("../../../..").HomepageSectionDocument[];
+    carouselSlides: never[] | import("../../../..").CarouselSlideDocument[];
+    featuredProducts: never[] | import("../../../..").ProductDocument[];
+    activeAuctions: never[] | import("../../../..").ProductDocument[];
+    activePreOrders: never[] | import("../../../..").ProductDocument[];
+    activeBrands: never[] | import("../../../..").BrandDocument[];
+    featuredReviews: never[] | import("../../../..").ReviewDocument[];
+    recentBlogPosts: never[] | import("../../../..").BlogPostDocument[];
+    activeEvents: never[] | import("../../../..").EventDocument[];
+    featuredCategories: never[] | import("../../../..").CategoryDocument[];
+}>;

package/dist/_internal/server/features/homepage/data.js

@@ -0,0 +1,39 @@
+import { cache } from "react";
+import { homepageSectionsRepository, carouselRepository, productRepository, brandsRepository, reviewRepository, blogRepository, eventRepository, categoriesRepository, } from "../../../../repositories";
+import { HOMEPAGE_FEATURED_REVIEWS_LIMIT, HOMEPAGE_RECENT_BLOG_POSTS_LIMIT, } from "../../../shared/features/homepage/config";
+export const getHomepageSections = cache(async () => {
+    return homepageSectionsRepository.getEnabledSections().catch(() => []);
+});
+export const getHeroCarouselSlides = cache(async () => {
+    return carouselRepository.getActiveSlides().catch(() => []);
+});
+/**
+ * One parallel fetch returning every piece of data the homepage sections need.
+ * Page components call this once; React.cache() deduplicates per request.
+ */
+export const getHomepageInitial = cache(async () => {
+    const [sections, carouselSlides, featuredProducts, activeAuctions, activePreOrders, activeBrands, featuredReviews, recentBlogPosts, activeEvents, featuredCategories,] = await Promise.all([
+        homepageSectionsRepository.getEnabledSections().catch(() => []),
+        carouselRepository.getActiveSlides().catch(() => []),
+        productRepository.findFeatured().catch(() => []),
+        productRepository.findActiveAuctions().catch(() => []),
+        productRepository.findActivePreOrders().catch(() => []),
+        brandsRepository.findActive().catch(() => []),
+        reviewRepository.findFeatured(HOMEPAGE_FEATURED_REVIEWS_LIMIT).catch(() => []),
+        blogRepository.listPublished({}, { page: 1, pageSize: HOMEPAGE_RECENT_BLOG_POSTS_LIMIT, sorts: "-publishedAt" }).then((r) => r.items ?? []).catch(() => []),
+        eventRepository.listActive().catch(() => []),
+        categoriesRepository.getFeaturedCategories().catch(() => []),
+    ]);
+    return {
+        sections,
+        carouselSlides,
+        featuredProducts,
+        activeAuctions,
+        activePreOrders,
+        activeBrands,
+        featuredReviews,
+        recentBlogPosts,
+        activeEvents,
+        featuredCategories,
+    };
+});

package/dist/_internal/server/features/homepage/index.d.ts

@@ -0,0 +1,2 @@
+export { getHomepageInitial, getHomepageSections, getHeroCarouselSlides, } from "./data";
+export { HOMEPAGE_FEATURED_REVIEWS_LIMIT, HOMEPAGE_RECENT_BLOG_POSTS_LIMIT, HOMEPAGE_MAX_SECTIONS, } from "../../../shared/features/homepage/config";

package/dist/_internal/server/features/homepage/index.js

@@ -0,0 +1,2 @@
+export { getHomepageInitial, getHomepageSections, getHeroCarouselSlides, } from "./data";
+export { HOMEPAGE_FEATURED_REVIEWS_LIMIT, HOMEPAGE_RECENT_BLOG_POSTS_LIMIT, HOMEPAGE_MAX_SECTIONS, } from "../../../shared/features/homepage/config";

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

@@ -0,0 +1,6 @@
+/**
+ * Messages server actions — thin re-exports. Keeps RTDB ping-channel behaviour
+ * (firestore canonical + RTDB notification) in the source action so consumers
+ * cannot bypass it.
+ */
+export { sendMessage as sendMessageAction, markConversationRead as markConversationReadAction, MESSAGE_MAX_LENGTH, } from "../../../../features/messages/actions/messages-actions";

package/dist/_internal/server/features/messages/actions.js

@@ -0,0 +1,6 @@
+/**
+ * Messages server actions — thin re-exports. Keeps RTDB ping-channel behaviour
+ * (firestore canonical + RTDB notification) in the source action so consumers
+ * cannot bypass it.
+ */
+export { sendMessage as sendMessageAction, markConversationRead as markConversationReadAction, MESSAGE_MAX_LENGTH, } from "../../../../features/messages/actions/messages-actions";

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

@@ -0,0 +1,10 @@
+/**
+ * Messages data layer — server-only fetchers with React.cache dedup.
+ * RTDB ping channel is preserved (the actions module owns that side effect).
+ */
+export interface MessagesDataOptions {
+    _reserved?: never;
+}
+export declare const listConversationsForBuyer: (buyerId: string, _opts?: MessagesDataOptions) => Promise<import("../../../..").ConversationDocument[]>;
+export declare const listConversationsForStore: (storeId: string, _opts?: MessagesDataOptions) => Promise<import("../../../..").ConversationDocument[]>;
+export declare const getConversation: (convId: string, _opts?: MessagesDataOptions) => Promise<import("../../../..").ConversationDocument | null>;

package/dist/_internal/server/features/messages/data.js

@@ -0,0 +1,24 @@
+/**
+ * Messages data layer — server-only fetchers with React.cache dedup.
+ * RTDB ping channel is preserved (the actions module owns that side effect).
+ */
+import { cache } from "react";
+import { listConversationsForBuyer as _listConversationsForBuyer, listConversationsForStore as _listConversationsForStore, getConversation as _getConversation, } from "../../../../features/messages/actions/messages-actions";
+export const listConversationsForBuyer = cache(async (buyerId, _opts) => {
+    void _opts;
+    if (!buyerId)
+        return [];
+    return _listConversationsForBuyer(buyerId);
+});
+export const listConversationsForStore = cache(async (storeId, _opts) => {
+    void _opts;
+    if (!storeId)
+        return [];
+    return _listConversationsForStore(storeId);
+});
+export const getConversation = cache(async (convId, _opts) => {
+    void _opts;
+    if (!convId)
+        return null;
+    return _getConversation(convId);
+});

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

@@ -0,0 +1,2 @@
+export * from "./data";
+export * from "./actions";

package/dist/_internal/server/features/messages/index.js

@@ -0,0 +1,2 @@
+export * from "./data";
+export * from "./actions";

package/dist/_internal/server/features/orders/actions.d.ts

@@ -0,0 +1,4 @@
+export declare function createOrderAction(input: unknown): Promise<import("../../../..").OrderDocument>;
+export declare function cancelOrderAction(input: unknown): Promise<import("../../../..").OrderDocument>;
+export declare function requestReturnAction(input: unknown): Promise<import("../../../..").OrderDocument>;
+export declare function updateOrderStatusAction(input: unknown): Promise<import("../../../..").OrderDocument>;

package/dist/_internal/server/features/orders/actions.js

@@ -0,0 +1,50 @@
+"use server";
+import { orderRepository } from "../../../../repositories";
+import { requireRoleUser } from "../../../../providers/auth-firebase/helpers";
+import { createOrderSchema, updateOrderStatusSchema, cancelOrderSchema, } from "../../../shared/features/orders/schema";
+import { assertOrderCancellable, assertReturnWindowOpen } from "./service";
+import { ValidationError } from "../../../shared/errors/index";
+import { OrderNotFoundError, OrderOwnershipError } from "../../../shared/features/orders/errors";
+export async function createOrderAction(input) {
+    const user = await requireRoleUser(["buyer", "seller", "admin"]);
+    const parsed = createOrderSchema.safeParse(input);
+    if (!parsed.success)
+        throw new ValidationError(parsed.error.errors[0]?.message ?? "Invalid order input");
+    return orderRepository.create({
+        ...parsed.data,
+        userId: user.uid,
+        status: "pending",
+    });
+}
+export async function cancelOrderAction(input) {
+    const user = await requireRoleUser(["buyer", "seller", "admin"]);
+    const parsed = cancelOrderSchema.safeParse(input);
+    if (!parsed.success)
+        throw new ValidationError(parsed.error.errors[0]?.message ?? "Invalid input");
+    await assertOrderCancellable(parsed.data.orderId, user.uid);
+    return orderRepository.cancelOrder(parsed.data.orderId, parsed.data.reason ?? "Cancelled by user");
+}
+export async function requestReturnAction(input) {
+    const user = await requireRoleUser(["buyer", "seller", "admin"]);
+    const parsed = cancelOrderSchema.safeParse(input);
+    if (!parsed.success)
+        throw new ValidationError(parsed.error.errors[0]?.message ?? "Invalid input");
+    await assertReturnWindowOpen(parsed.data.orderId, user.uid);
+    return orderRepository.updateStatus(parsed.data.orderId, "return_requested");
+}
+export async function updateOrderStatusAction(input) {
+    const user = await requireRoleUser(["seller", "admin"]);
+    const parsed = updateOrderStatusSchema.safeParse(input);
+    if (!parsed.success)
+        throw new ValidationError(parsed.error.errors[0]?.message ?? "Invalid input");
+    const order = await orderRepository.findById(parsed.data.orderId).catch(() => null);
+    if (!order)
+        throw new OrderNotFoundError(parsed.data.orderId);
+    if (user.role !== "admin" && order.storeId !== user.uid) {
+        throw new OrderOwnershipError(parsed.data.orderId);
+    }
+    return orderRepository.updateStatus(parsed.data.orderId, parsed.data.status, {
+        trackingNumber: parsed.data.trackingNumber,
+        shippingCarrier: parsed.data.carrier,
+    });
+}

package/dist/_internal/server/features/orders/adapters.d.ts

@@ -0,0 +1,3 @@
+import type { Order } from "../../../../features/orders/types";
+import type { OrderDocument } from "../../../../features/orders/schemas/firestore";
+export declare function orderDocumentToOrder(doc: OrderDocument): Order;

package/dist/_internal/server/features/orders/adapters.js

@@ -0,0 +1,56 @@
+export function orderDocumentToOrder(doc) {
+    const items = doc.items?.length
+        ? doc.items.map((item) => ({
+            productId: item.productId,
+            title: item.productTitle,
+            price: item.unitPrice,
+            quantity: item.quantity,
+            currency: doc.currency,
+            storeId: doc.storeId,
+        }))
+        : [
+            {
+                productId: doc.productId,
+                title: doc.productTitle,
+                image: doc.imageUrls?.[0],
+                price: doc.unitPrice,
+                quantity: doc.quantity,
+                currency: doc.currency,
+                storeId: doc.storeId,
+            },
+        ];
+    const address = {
+        id: doc.id,
+        line1: doc.shippingAddress ?? "",
+        city: "",
+        state: "",
+        postalCode: "",
+        country: "India",
+    };
+    const shippingCost = doc.shippingFee ?? 0;
+    const discount = doc.couponDiscount ?? 0;
+    const subtotal = doc.totalPrice - shippingCost + discount;
+    return {
+        id: doc.id,
+        userId: doc.userId,
+        items,
+        address,
+        orderStatus: doc.status,
+        paymentStatus: doc.paymentStatus,
+        subtotal,
+        shippingCost: shippingCost || undefined,
+        discount: discount || undefined,
+        total: doc.totalPrice,
+        currency: doc.currency,
+        couponCode: doc.couponCode,
+        trackingNumber: doc.trackingNumber,
+        shippingCarrier: doc.shippingCarrier,
+        notes: doc.notes,
+        createdAt: doc.createdAt instanceof Date
+            ? doc.createdAt.toISOString()
+            : String(doc.createdAt),
+        updatedAt: doc.updatedAt instanceof Date
+            ? doc.updatedAt.toISOString()
+            : String(doc.updatedAt),
+    };
+}

package/dist/_internal/server/features/orders/data.d.ts

@@ -0,0 +1,10 @@
+export declare const getOrderForDetail: (orderId: string) => Promise<import("../../../..").OrderDocument | null>;
+export declare const getOrdersForBuyer: (userId: string, page?: number, pageSize?: number) => Promise<import("../../../..").FirebaseSieveResult<import("../../../..").OrderDocument> | {
+    items: never[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    hasMore: boolean;
+}>;
+export declare const getRecentOrdersForBuyer: (userId: string) => Promise<never[] | import("../../../..").OrderDocument[]>;

package/dist/_internal/server/features/orders/data.js

@@ -0,0 +1,18 @@
+import { cache } from "react";
+import { orderRepository } from "../../../../repositories";
+export const getOrderForDetail = cache(async (orderId) => {
+    return (await orderRepository.findById(orderId).catch(() => undefined)) ?? null;
+});
+export const getOrdersForBuyer = cache(async (userId, page = 1, pageSize = 20) => {
+    return orderRepository.listForUser(userId, { page, pageSize }).catch(() => ({
+        items: [],
+        total: 0,
+        page,
+        pageSize,
+        totalPages: 0,
+        hasMore: false,
+    }));
+});
+export const getRecentOrdersForBuyer = cache(async (userId) => {
+    return orderRepository.findRecentByUser(userId).catch(() => []);
+});

package/dist/_internal/server/features/orders/index.d.ts

@@ -0,0 +1,5 @@
+export { getOrderForDetail, getOrdersForBuyer, getRecentOrdersForBuyer } from "./data";
+export { orderDocumentToOrder } from "./adapters";
+export { assertOrderOwnership, assertOrderCancellable } from "./service";
+export { createOrderAction, cancelOrderAction, requestReturnAction, updateOrderStatusAction } from "./actions";
+export { ORDERS_PAGE_SIZE, ORDER_CANCELLABLE_STATUSES, ORDER_RETURN_WINDOW_DAYS } from "../../../shared/features/orders/config";

package/dist/_internal/server/features/orders/index.js

@@ -0,0 +1,5 @@
+export { getOrderForDetail, getOrdersForBuyer, getRecentOrdersForBuyer } from "./data";
+export { orderDocumentToOrder } from "./adapters";
+export { assertOrderOwnership, assertOrderCancellable } from "./service";
+export { createOrderAction, cancelOrderAction, requestReturnAction, updateOrderStatusAction } from "./actions";
+export { ORDERS_PAGE_SIZE, ORDER_CANCELLABLE_STATUSES, ORDER_RETURN_WINDOW_DAYS } from "../../../shared/features/orders/config";

package/dist/_internal/server/features/orders/service.d.ts

@@ -0,0 +1,4 @@
+import type { OrderDocument } from "../../../../features/orders/schemas";
+export declare function assertOrderOwnership(orderId: string, userId: string): Promise<OrderDocument>;
+export declare function assertOrderCancellable(orderId: string, userId: string): Promise<OrderDocument>;
+export declare function assertReturnWindowOpen(orderId: string, userId: string): Promise<OrderDocument>;

package/dist/_internal/server/features/orders/service.js

@@ -0,0 +1,30 @@
+import { orderRepository } from "../../../../repositories";
+import { OrderNotFoundError, OrderCancelError, OrderOwnershipError, OrderReturnWindowError, } from "../../../shared/features/orders/errors";
+import { ORDER_CANCELLABLE_STATUSES, ORDER_RETURN_WINDOW_MS, } from "../../../shared/features/orders/config";
+export async function assertOrderOwnership(orderId, userId) {
+    const order = await orderRepository.findById(orderId).catch(() => null);
+    if (!order)
+        throw new OrderNotFoundError(orderId);
+    if (order.userId !== userId)
+        throw new OrderOwnershipError(orderId);
+    return order;
+}
+export async function assertOrderCancellable(orderId, userId) {
+    const order = await assertOrderOwnership(orderId, userId);
+    const cancellable = ORDER_CANCELLABLE_STATUSES;
+    if (!cancellable.includes(order.status)) {
+        throw new OrderCancelError(order.status);
+    }
+    return order;
+}
+export async function assertReturnWindowOpen(orderId, userId) {
+    const order = await assertOrderOwnership(orderId, userId);
+    if (order.status !== "delivered")
+        throw new OrderCancelError(order.status);
+    const deliveredAt = order.deliveryDate instanceof Date
+        ? order.deliveryDate
+        : new Date(order.updatedAt ?? Date.now());
+    if (Date.now() - deliveredAt.getTime() > ORDER_RETURN_WINDOW_MS)
+        throw new OrderReturnWindowError();
+    return order;
+}

package/dist/_internal/server/features/payments/actions.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Payments server actions (appkit).
+ *
+ * Wraps the Razorpay primitives in a single createPaymentIntentAction. The
+ * existing /api/payment/create-order route becomes a thin wrapper over this
+ * once consumer wiring lands (S7). Webhook + verify routes remain in the
+ * consumer because they parse provider-specific request bodies.
+ */
+export interface CreatePaymentIntentInput {
+    userId: string;
+    /** Base amount in rupees (the cart total before the Razorpay fee). */
+    amount: number;
+    currency?: string;
+    receipt?: string;
+}
+export interface CreatePaymentIntentResult {
+    razorpayOrderId: string;
+    amount: number;
+    currency: string;
+    keyId: string;
+    platformFee: number;
+    baseAmount: number;
+}
+export declare function createPaymentIntentAction(input: CreatePaymentIntentInput): Promise<CreatePaymentIntentResult>;
+export interface VerifyPaymentSignatureInput {
+    orderId: string;
+    paymentId: string;
+    signature: string;
+}
+export declare function verifyPaymentSignatureAction(input: VerifyPaymentSignatureInput): Promise<boolean>;

package/dist/_internal/server/features/payments/actions.js

@@ -0,0 +1,45 @@
+/**
+ * Payments server actions (appkit).
+ *
+ * Wraps the Razorpay primitives in a single createPaymentIntentAction. The
+ * existing /api/payment/create-order route becomes a thin wrapper over this
+ * once consumer wiring lands (S7). Webhook + verify routes remain in the
+ * consumer because they parse provider-specific request bodies.
+ */
+import { ApiError } from "../../../../errors";
+import { serverLogger } from "../../../../monitoring";
+import { createRazorpayOrder, rupeesToPaise, verifyPaymentSignatureWithKeys, } from "../../../../providers/payment-razorpay/index";
+import { getDefaultCurrency } from "../../../../core/index";
+import { PAYMENTS_RECEIPT_PREFIX } from "../../../shared/features/payments/config";
+import { resolvePaymentFee } from "./data";
+export async function createPaymentIntentAction(input) {
+    const keyId = process.env.RAZORPAY_KEY_ID;
+    if (!keyId) {
+        throw new ApiError(500, "Razorpay is not configured on this server");
+    }
+    const currency = input.currency ?? getDefaultCurrency();
+    const fee = await resolvePaymentFee(input.amount);
+    const amountInPaise = rupeesToPaise(fee.totalAmount);
+    const razorpayOrder = await createRazorpayOrder({
+        amount: amountInPaise,
+        currency,
+        receipt: input.receipt ?? `${PAYMENTS_RECEIPT_PREFIX}${input.userId}_${Date.now()}`,
+        notes: { userId: input.userId },
+    });
+    serverLogger.info(`createPaymentIntentAction: ${razorpayOrder.id} uid=${input.userId} base=${fee.baseAmount} fee=${fee.platformFee} total=${fee.totalAmount}`);
+    return {
+        razorpayOrderId: razorpayOrder.id,
+        amount: razorpayOrder.amount,
+        currency: razorpayOrder.currency,
+        keyId,
+        platformFee: fee.platformFee,
+        baseAmount: fee.baseAmount,
+    };
+}
+export async function verifyPaymentSignatureAction(input) {
+    return verifyPaymentSignatureWithKeys({
+        razorpay_order_id: input.orderId,
+        razorpay_payment_id: input.paymentId,
+        razorpay_signature: input.signature,
+    });
+}

package/dist/_internal/server/features/payments/data.d.ts

@@ -0,0 +1,11 @@
+export interface ResolvedPaymentFee {
+    baseAmount: number;
+    platformFee: number;
+    totalAmount: number;
+}
+/**
+ * Returns the cart total inflated by the configured Razorpay processing fee.
+ * The percent comes from siteSettings.commissions.razorpayFeePercent and
+ * falls back to the default if unset.
+ */
+export declare function resolvePaymentFee(baseAmount: number): Promise<ResolvedPaymentFee>;

package/dist/_internal/server/features/payments/data.js

@@ -0,0 +1,14 @@
+import { siteSettingsRepository } from "../../../../repositories";
+import { PAYMENTS_DEFAULT_RAZORPAY_FEE_PERCENT } from "../../../shared/features/payments/config";
+/**
+ * Returns the cart total inflated by the configured Razorpay processing fee.
+ * The percent comes from siteSettings.commissions.razorpayFeePercent and
+ * falls back to the default if unset.
+ */
+export async function resolvePaymentFee(baseAmount) {
+    const siteSettings = await siteSettingsRepository.getSingleton();
+    const razorpayFeePercent = siteSettings?.commissions?.razorpayFeePercent ?? PAYMENTS_DEFAULT_RAZORPAY_FEE_PERCENT;
+    const platformFee = Math.round(baseAmount * (razorpayFeePercent / 100) * 100) / 100;
+    const totalAmount = baseAmount + platformFee;
+    return { baseAmount, platformFee, totalAmount };
+}

package/dist/_internal/server/features/payments/index.d.ts

@@ -0,0 +1,3 @@
+export { createPaymentIntentAction, verifyPaymentSignatureAction, type CreatePaymentIntentInput, type CreatePaymentIntentResult, type VerifyPaymentSignatureInput, } from "./actions";
+export { resolvePaymentFee, type ResolvedPaymentFee } from "./data";
+export { PAYMENTS_DEFAULT_RAZORPAY_FEE_PERCENT, PAYMENTS_RECEIPT_PREFIX, } from "../../../shared/features/payments/config";

package/dist/_internal/server/features/payments/index.js

@@ -0,0 +1,3 @@
+export { createPaymentIntentAction, verifyPaymentSignatureAction, } from "./actions";
+export { resolvePaymentFee } from "./data";
+export { PAYMENTS_DEFAULT_RAZORPAY_FEE_PERCENT, PAYMENTS_RECEIPT_PREFIX, } from "../../../shared/features/payments/config";

package/dist/_internal/server/features/pre-orders/actions.d.ts

@@ -0,0 +1,7 @@
+export declare function reservePreOrderAction(input: unknown): Promise<{
+    preOrderId: string;
+    buyerId: string;
+    quantity: number;
+    depositAmount: number;
+    status: string;
+}>;