@mohasinac/appkit 3.0.3 → 3.0.6

package/dist/_internal/client/features/filters/filter-load-options.js

@@ -1,4 +1,14 @@
-"use client";
+/**
+ * filter-load-options.ts
+ *
+ * Factory functions that return `loadOptions(query, page)` callbacks for use
+ * with AsyncFacetSection and PaginatedSelect. Each factory hits a paginated API
+ * endpoint and maps the response to { items: PaginatedSelectOption[], hasMore: boolean }.
+ *
+ * Usage:
+ *   const load = makeCategoryLoadOptions();
+ *   <AsyncFacetSection loadOptions={load} ... />
+ */
 const PAGE_SIZE = 25;
 function buildUrl(base, q, page, extra) {
     const params = new URLSearchParams({

package/dist/_internal/client/features/layout/filterNavItems.js

@@ -1,4 +1,3 @@
-"use client";
 /**
  * Filters nav items by:
  * 1. siteSettings.navConfig[item.id].enabled (admin toggle)

package/dist/_internal/client/features/layout/index.js

@@ -1,4 +1,3 @@
-"use client";
 /** Layout feature — client islands barrel. */
 export { DashboardLayoutClient } from "./DashboardLayoutClient";
 export { RoleGuard } from "./RoleGuard";

package/dist/_internal/client/features/maintenance/views/MaintenanceDashboardView.js

@@ -1,4 +1,3 @@
-"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Anchor, Div, Heading, Li, Nav, Section, Span, Text, Ul } from "@mohasinac/appkit";
 const card = {

package/dist/_internal/client/features/maintenance/views/ServerErrorDetailView.js

@@ -1,4 +1,3 @@
-"use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Anchor, Div, Heading, Li, Pre, Section, Text, Ul } from "@mohasinac/appkit";
 function fmt(t) {

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

@@ -1,4 +1,2 @@
-import type { ProductDocument } from "../../../../features/products/schemas/firestore";
-import type { ProductFeatureDocument } from "../../../../features/products/schemas/product-features";
-export declare const getAuctionForDetail: (slugOrId: string) => Promise<ProductDocument | null>;
-export declare const getProductFeaturesForAuction: (storeId: string | null) => Promise<ProductFeatureDocument[]>;
+export declare const getAuctionForDetail: (slugOrId: string) => Promise<import("../../../..").ProductDocument | null>;
+export declare const getProductFeaturesForAuction: (storeId: string | null) => Promise<import("../../../..").ProductFeatureDocument[]>;

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

@@ -1,9 +1,3 @@
-import { cache } from "react";
-import { productRepository } from "../../../../repositories";
-import { loadProductFeaturesForStore } from "../../../../features/products/repository/loadProductFeatures";
-export const getAuctionForDetail = cache(async (slugOrId) => {
-    return (await productRepository.findByIdOrSlug(slugOrId).catch(() => undefined)) ?? null;
-});
-export const getProductFeaturesForAuction = cache(async (storeId) => {
-    return loadProductFeaturesForStore(storeId).catch(() => []);
-});
+import { makeGetListingForDetail, getProductFeaturesForStore } from "../shared/listing-data-factory";
+export const getAuctionForDetail = makeGetListingForDetail("auction");
+export const getProductFeaturesForAuction = getProductFeaturesForStore;

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

@@ -258,7 +258,7 @@ export async function createCheckoutOrderAction(input) {
         if (!addressId) {
             failedCheckoutRepository
                 .logCheckout(uid, "address_not_found", "Address required for physical cart", { addressId: "", paymentMethod })
-                .catch(() => { });
+                .catch(console.error);
             throw new NotFoundError(ERROR_MESSAGES.CHECKOUT.ADDRESS_REQUIRED);
         }
         const addressDoc = await unitOfWork.addresses.findById(addressId);
@@ -269,7 +269,7 @@ export async function createCheckoutOrderAction(input) {
         if (!resolvedAddress) {
             failedCheckoutRepository
                 .logCheckout(uid, "address_not_found", "Address not found", { addressId, paymentMethod })
-                .catch(() => { });
+                .catch(console.error);
             throw new NotFoundError(ERROR_MESSAGES.CHECKOUT.ADDRESS_REQUIRED);
         }
         shippingAddress = formatShippingAddress(resolvedAddress);
@@ -408,7 +408,7 @@ export async function createCheckoutOrderAction(input) {
             addressId,
             paymentMethod,
         })
-            .catch(() => { });
+            .catch(console.error);
         throw err;
     }
     const { available, unavailable, emailOtpUsed } = stockResult;
@@ -419,7 +419,7 @@ export async function createCheckoutOrderAction(input) {
             paymentMethod,
             cartItemCount: cartItems.length,
         })
-            .catch(() => { });
+            .catch(console.error);
         throw new ValidationError(ERROR_MESSAGES.CHECKOUT.INSUFFICIENT_STOCK);
     }
     const appliedCoupons = cart.appliedCoupons ?? [];
@@ -663,7 +663,7 @@ export async function verifyAndPlaceRazorpayOrderAction(input) {
             gatewayPaymentId: razorpay_payment_id,
             addressId,
         })
-            .catch(() => { });
+            .catch(console.error);
         throw new ValidationError(ERROR_MESSAGES.CHECKOUT.PAYMENT_FAILED);
     }
     const cart = await unitOfWork.carts.getOrCreate(uid);
@@ -705,7 +705,7 @@ export async function verifyAndPlaceRazorpayOrderAction(input) {
                 gatewayPaymentId: razorpay_payment_id,
                 addressId,
             })
-                .catch(() => { });
+                .catch(console.error);
             throw new ApiError(403, "Order verification required. Please complete OTP verification and retry.");
         }
     }
@@ -756,7 +756,7 @@ export async function verifyAndPlaceRazorpayOrderAction(input) {
                 gatewayPaymentId: razorpay_payment_id,
                 addressId,
             })
-                .catch(() => { });
+                .catch(console.error);
             throw new ValidationError(exists
                 ? ERROR_MESSAGES.CHECKOUT.INSUFFICIENT_STOCK
                 : ERROR_MESSAGES.CHECKOUT.PRODUCT_UNAVAILABLE);
@@ -784,7 +784,7 @@ export async function verifyAndPlaceRazorpayOrderAction(input) {
                 amountRs: paidAmountRs,
                 addressId,
             })
-                .catch(() => { });
+                .catch(console.error);
             throw new ValidationError(ERROR_MESSAGES.CHECKOUT.PAYMENT_FAILED);
         }
     }
@@ -990,7 +990,7 @@ export async function verifyAndPlaceRazorpayOrderAction(input) {
     });
     if (!isDigitalCartRazorpay && addressId) {
         const otpRefForDelete = consentOtpRef(db, uid, addressId);
-        otpRefForDelete.delete().catch(() => { });
+        otpRefForDelete.delete().catch(console.error);
     }
     if (emailsToSend.length > 0) {
         Promise.all(emailsToSend.map((e) => sendOrderConfirmationEmail(e))).catch((err) => serverLogger.error("Order confirmation email error:", err));

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

@@ -1,21 +1,8 @@
 import type { ProductDocument, ProductClassifiedMeta } from "../../../../features/products/schemas/firestore";
-export interface ClassifiedClientShape {
-    id: string;
-    title: string;
-    description: string;
-    price: number;
-    priceLabel: string;
-    currency: string;
-    mainImage: string | null;
-    images: string[];
-    storeId: string;
-    storeName: string | null;
-    category: string;
+import { type BaseListingClientShape } from "../shared/listing-adapters";
+export interface ClassifiedClientShape extends BaseListingClientShape {
     condition: ProductDocument["condition"] | null;
-    tags: string[];
     classified: ProductClassifiedMeta | null;
-    status: ProductDocument["status"];
-    createdAt: string;
 }
 /** Maps a raw `ProductDocument` to the client-safe classified shape. */
 export declare function toClientClassified(doc: ProductDocument): ClassifiedClientShape;

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

@@ -1,24 +1,9 @@
-import { formatCurrency } from "../../../../utils/number.formatter";
+import { mapBaseListingFields } from "../shared/listing-adapters";
 /** Maps a raw `ProductDocument` to the client-safe classified shape. */
 export function toClientClassified(doc) {
     return {
-        id: doc.id,
-        title: doc.title,
-        description: doc.description,
-        price: doc.price,
-        priceLabel: formatCurrency(doc.price, doc.currency ?? "INR"),
-        currency: doc.currency ?? "INR",
-        mainImage: doc.mainImage || doc.images?.[0] || null,
-        images: doc.images ?? [],
-        storeId: doc.storeId,
-        storeName: doc.storeName ?? null,
-        category: doc.categorySlugs?.[0] ?? doc.category ?? "",
+        ...mapBaseListingFields(doc),
         condition: doc.condition ?? null,
-        tags: doc.tags ?? [],
         classified: doc.classified ?? null,
-        status: doc.status,
-        createdAt: doc.createdAt instanceof Date
-            ? doc.createdAt.toISOString()
-            : String(doc.createdAt),
     };
 }

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

@@ -1,6 +1 @@
-import type { ProductDocument } from "../../../../features/products/schemas/firestore";
-export interface ClassifiedDataOptions {
-    _reserved?: never;
-}
-/** Fetch a single classified listing by slug, deduped per RSC render. */
-export declare const getClassifiedForDetail: (slug: string, _opts?: ClassifiedDataOptions) => Promise<ProductDocument | null>;
+export declare const getClassifiedForDetail: (slugOrId: string) => Promise<import("../../../..").ProductDocument | null>;

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

@@ -1,10 +1,2 @@
-import { cache } from "react";
-import { productRepository } from "../../../../repositories";
-/** Fetch a single classified listing by slug, deduped per RSC render. */
-export const getClassifiedForDetail = cache(async (slug, _opts) => {
-    void _opts;
-    const product = await productRepository.findByIdOrSlug(slug).catch(() => undefined);
-    if (!product || product.listingType !== "classified")
-        return null;
-    return product;
-});
+import { makeGetListingForDetail } from "../shared/listing-data-factory";
+export const getClassifiedForDetail = makeGetListingForDetail("classified");

package/dist/_internal/server/features/digital-code/adapters.d.ts

@@ -1,21 +1,8 @@
 import type { ProductDocument, ProductDigitalCodeMeta } from "../../../../features/products/schemas/firestore";
-export interface DigitalCodeClientShape {
-    id: string;
-    title: string;
-    description: string;
-    price: number;
-    priceLabel: string;
-    currency: string;
-    mainImage: string | null;
-    images: string[];
-    storeId: string;
-    storeName: string | null;
-    category: string;
-    tags: string[];
+import { type BaseListingClientShape } from "../shared/listing-adapters";
+export interface DigitalCodeClientShape extends BaseListingClientShape {
     /** Delivery method and redemption instructions — codesAvailable intentionally omitted (operational). */
     digitalCode: Pick<ProductDigitalCodeMeta, "codeDeliveryMethod" | "redemptionInstructions"> | null;
-    status: ProductDocument["status"];
-    createdAt: string;
 }
 /** Maps a raw `ProductDocument` to the client-safe digital-code shape. Strips codesAvailable/codePoolSize (operational counters). */
 export declare function toClientDigitalCode(doc: ProductDocument): DigitalCodeClientShape;

package/dist/_internal/server/features/digital-code/adapters.js

@@ -1,29 +1,14 @@
-import { formatCurrency } from "../../../../utils/number.formatter";
+import { mapBaseListingFields } from "../shared/listing-adapters";
 /** Maps a raw `ProductDocument` to the client-safe digital-code shape. Strips codesAvailable/codePoolSize (operational counters). */
 export function toClientDigitalCode(doc) {
     const dc = doc.digitalCode ?? null;
     return {
-        id: doc.id,
-        title: doc.title,
-        description: doc.description,
-        price: doc.price,
-        priceLabel: formatCurrency(doc.price, doc.currency ?? "INR"),
-        currency: doc.currency ?? "INR",
-        mainImage: doc.mainImage || doc.images?.[0] || null,
-        images: doc.images ?? [],
-        storeId: doc.storeId,
-        storeName: doc.storeName ?? null,
-        category: doc.categorySlugs?.[0] ?? doc.category ?? "",
-        tags: doc.tags ?? [],
+        ...mapBaseListingFields(doc),
         digitalCode: dc
             ? {
                 codeDeliveryMethod: dc.codeDeliveryMethod,
                 redemptionInstructions: dc.redemptionInstructions,
             }
             : null,
-        status: doc.status,
-        createdAt: doc.createdAt instanceof Date
-            ? doc.createdAt.toISOString()
-            : String(doc.createdAt),
     };
 }

package/dist/_internal/server/features/digital-code/data.d.ts

@@ -1,6 +1 @@
-import type { ProductDocument } from "../../../../features/products/schemas/firestore";
-export interface DigitalCodeDataOptions {
-    _reserved?: never;
-}
-/** Fetch a single digital-code listing by slug, deduped per RSC render. */
-export declare const getDigitalCodeForDetail: (slug: string, _opts?: DigitalCodeDataOptions) => Promise<ProductDocument | null>;
+export declare const getDigitalCodeForDetail: (slugOrId: string) => Promise<import("../../../..").ProductDocument | null>;

package/dist/_internal/server/features/digital-code/data.js

@@ -1,10 +1,2 @@
-import { cache } from "react";
-import { productRepository } from "../../../../repositories";
-/** Fetch a single digital-code listing by slug, deduped per RSC render. */
-export const getDigitalCodeForDetail = cache(async (slug, _opts) => {
-    void _opts;
-    const product = await productRepository.findByIdOrSlug(slug).catch(() => undefined);
-    if (!product || product.listingType !== "digital-code")
-        return null;
-    return product;
-});
+import { makeGetListingForDetail } from "../shared/listing-data-factory";
+export const getDigitalCodeForDetail = makeGetListingForDetail("digital-code");

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

@@ -1,21 +1,8 @@
 import type { ProductDocument, ProductLiveItemMeta } from "../../../../features/products/schemas/firestore";
-export interface LiveItemClientShape {
-    id: string;
-    title: string;
-    description: string;
-    price: number;
-    priceLabel: string;
-    currency: string;
-    mainImage: string | null;
-    images: string[];
-    storeId: string;
-    storeName: string | null;
-    category: string;
-    tags: string[];
+import { type BaseListingClientShape } from "../shared/listing-adapters";
+export interface LiveItemClientShape extends BaseListingClientShape {
     /** Live-item meta — vendorVerified is intentionally omitted (admin-only). */
     liveItem: Omit<ProductLiveItemMeta, "vendorVerified"> | null;
-    status: ProductDocument["status"];
-    createdAt: string;
 }
 /** Maps a raw `ProductDocument` to the client-safe live-item shape. Strips vendorVerified (admin-only). */
 export declare function toClientLiveItem(doc: ProductDocument): LiveItemClientShape;

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

@@ -1,20 +1,9 @@
-import { formatCurrency } from "../../../../utils/number.formatter";
+import { mapBaseListingFields } from "../shared/listing-adapters";
 /** Maps a raw `ProductDocument` to the client-safe live-item shape. Strips vendorVerified (admin-only). */
 export function toClientLiveItem(doc) {
     const li = doc.liveItem ?? null;
     return {
-        id: doc.id,
-        title: doc.title,
-        description: doc.description,
-        price: doc.price,
-        priceLabel: formatCurrency(doc.price, doc.currency ?? "INR"),
-        currency: doc.currency ?? "INR",
-        mainImage: doc.mainImage || doc.images?.[0] || null,
-        images: doc.images ?? [],
-        storeId: doc.storeId,
-        storeName: doc.storeName ?? null,
-        category: doc.categorySlugs?.[0] ?? doc.category ?? "",
-        tags: doc.tags ?? [],
+        ...mapBaseListingFields(doc),
         liveItem: li
             ? {
                 species: li.species,
@@ -26,9 +15,5 @@ export function toClientLiveItem(doc) {
                 cites: li.cites,
             }
             : null,
-        status: doc.status,
-        createdAt: doc.createdAt instanceof Date
-            ? doc.createdAt.toISOString()
-            : String(doc.createdAt),
     };
 }

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

@@ -1,6 +1 @@
-import type { ProductDocument } from "../../../../features/products/schemas/firestore";
-export interface LiveDataOptions {
-    _reserved?: never;
-}
-/** Fetch a single live-item listing by slug, deduped per RSC render. */
-export declare const getLiveItemForDetail: (slug: string, _opts?: LiveDataOptions) => Promise<ProductDocument | null>;
+export declare const getLiveItemForDetail: (slugOrId: string) => Promise<import("../../../..").ProductDocument | null>;

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

@@ -1,10 +1,2 @@
-import { cache } from "react";
-import { productRepository } from "../../../../repositories";
-/** Fetch a single live-item listing by slug, deduped per RSC render. */
-export const getLiveItemForDetail = cache(async (slug, _opts) => {
-    void _opts;
-    const product = await productRepository.findByIdOrSlug(slug).catch(() => undefined);
-    if (!product || product.listingType !== "live")
-        return null;
-    return product;
-});
+import { makeGetListingForDetail } from "../shared/listing-data-factory";
+export const getLiveItemForDetail = makeGetListingForDetail("live");

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

@@ -1,4 +1,2 @@
-import type { ProductDocument } from "../../../../features/products/schemas/firestore";
-import type { ProductFeatureDocument } from "../../../../features/products/schemas/product-features";
-export declare const getPreOrderForDetail: (slugOrId: string) => Promise<ProductDocument | null>;
-export declare const getProductFeaturesForPreOrder: (storeId: string | null) => Promise<ProductFeatureDocument[]>;
+export declare const getPreOrderForDetail: (slugOrId: string) => Promise<import("../../../..").ProductDocument | null>;
+export declare const getProductFeaturesForPreOrder: (storeId: string | null) => Promise<import("../../../..").ProductFeatureDocument[]>;

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

@@ -1,9 +1,3 @@
-import { cache } from "react";
-import { productRepository } from "../../../../repositories";
-import { loadProductFeaturesForStore } from "../../../../features/products/repository/loadProductFeatures";
-export const getPreOrderForDetail = cache(async (slugOrId) => {
-    return (await productRepository.findByIdOrSlug(slugOrId).catch(() => undefined)) ?? null;
-});
-export const getProductFeaturesForPreOrder = cache(async (storeId) => {
-    return loadProductFeaturesForStore(storeId).catch(() => []);
-});
+import { makeGetListingForDetail, getProductFeaturesForStore } from "../shared/listing-data-factory";
+export const getPreOrderForDetail = makeGetListingForDetail("pre-order");
+export const getProductFeaturesForPreOrder = getProductFeaturesForStore;

package/dist/_internal/server/features/prize-draws/actions.d.ts

@@ -0,0 +1,2 @@
+import { type ActionResult } from "@mohasinac/appkit/server";
+export declare function enterPrizeDrawAction(input: unknown): Promise<ActionResult<unknown>>;

package/dist/_internal/server/features/prize-draws/actions.js

@@ -0,0 +1,22 @@
+"use server";
+import { wrapAction } from "@mohasinac/appkit/server";
+import { productRepository } from "../../../../repositories";
+import { requireRoleUser } from "../../../../providers/auth-firebase/helpers";
+import { assertPrizeDrawOpen } from "./service";
+export async function enterPrizeDrawAction(input) {
+    return wrapAction(async () => {
+        const user = await requireRoleUser(["user", "buyer", "seller", "admin"]);
+        const { prizeDrawId } = input;
+        if (!prizeDrawId)
+            throw new Error("prizeDrawId is required.");
+        const product = await productRepository.findByIdOrSlug(prizeDrawId).catch(() => null);
+        if (!product)
+            throw new Error("Prize draw not found.");
+        assertPrizeDrawOpen(product);
+        // Increment the entry count — server-side only, not exposed to the client adapter.
+        await productRepository.update(prizeDrawId, {
+            prizeCurrentEntries: (product.prizeCurrentEntries ?? 0) + 1,
+        });
+        return { entryRecorded: true, userId: user.uid };
+    });
+}

package/dist/_internal/server/features/prize-draws/data.d.ts

@@ -1,17 +1 @@
-/**
- * Prize Draw data layer — OG-coverage-followup 2026-05-23.
- *
- * Prize draws live as products with `listingType:"prize-draw"`. This file
- * wraps the repo call in `React.cache` so the OG renderer and any future
- * page/generateMetadata pair share one Firestore read per request.
- */
-import type { ProductDocument } from "../../../../features/products/schemas/firestore";
-export interface PrizeDrawDataOptions {
-    _reserved?: never;
-}
-/**
- * Fetch a single prize-draw product by slug or id. Returns null when the
- * slug is empty or no matching product exists. The caller is responsible
- * for asserting `listingType === "prize-draw"` if a strict gate is required.
- */
-export declare const getPrizeDrawForDetail: (slugOrId: string, _opts?: PrizeDrawDataOptions) => Promise<ProductDocument | null>;
+export declare const getPrizeDrawForDetail: (slugOrId: string) => Promise<import("../../../..").ProductDocument | null>;

package/dist/_internal/server/features/prize-draws/data.js

@@ -1,20 +1,2 @@
-/**
- * Prize Draw data layer — OG-coverage-followup 2026-05-23.
- *
- * Prize draws live as products with `listingType:"prize-draw"`. This file
- * wraps the repo call in `React.cache` so the OG renderer and any future
- * page/generateMetadata pair share one Firestore read per request.
- */
-import { cache } from "react";
-import { productRepository } from "../../../../repositories";
-/**
- * Fetch a single prize-draw product by slug or id. Returns null when the
- * slug is empty or no matching product exists. The caller is responsible
- * for asserting `listingType === "prize-draw"` if a strict gate is required.
- */
-export const getPrizeDrawForDetail = cache(async (slugOrId, _opts) => {
-    void _opts;
-    if (!slugOrId)
-        return null;
-    return (await productRepository.findByIdOrSlug(slugOrId).catch(() => null)) ?? null;
-});
+import { makeGetListingForDetail } from "../shared/listing-data-factory";
+export const getPrizeDrawForDetail = makeGetListingForDetail("prize-draw");

package/dist/_internal/server/features/prize-draws/index.d.ts

@@ -1,2 +1,4 @@
-export { getPrizeDrawForDetail, type PrizeDrawDataOptions } from "./data";
+export { getPrizeDrawForDetail } from "./data";
+export { enterPrizeDrawAction } from "./actions";
+export { assertPrizeDrawOpen } from "./service";
 export { renderPrizeDrawOg, renderPrizeDrawOgImage, type PrizeDrawOgData, } from "./og";

package/dist/_internal/server/features/prize-draws/index.js

@@ -1,2 +1,4 @@
 export { getPrizeDrawForDetail } from "./data";
+export { enterPrizeDrawAction } from "./actions";
+export { assertPrizeDrawOpen } from "./service";
 export { renderPrizeDrawOg, renderPrizeDrawOgImage, } from "./og";

package/dist/_internal/server/features/prize-draws/service.d.ts

@@ -0,0 +1,3 @@
+import type { ProductDocument } from "../../../../features/products/schemas/firestore";
+/** Assert the prize draw is accepting entries (published, reveal not started, slots not exhausted). */
+export declare function assertPrizeDrawOpen(product: ProductDocument): void;

package/dist/_internal/server/features/prize-draws/service.js

@@ -0,0 +1,19 @@
+import { ValidationError, CapacityError, ExpiredError } from "../../../shared/errors/index";
+/** Assert the prize draw is accepting entries (published, reveal not started, slots not exhausted). */
+export function assertPrizeDrawOpen(product) {
+    if (product.listingType !== "prize-draw") {
+        throw new ValidationError("Not a prize draw listing.");
+    }
+    if (product.status !== "published") {
+        throw new ValidationError("Prize draw is not active.");
+    }
+    const max = product.prizeMaxEntries ?? null;
+    const current = product.prizeCurrentEntries ?? 0;
+    if (typeof max === "number" && current >= max) {
+        throw new CapacityError("Prize draw is fully subscribed.");
+    }
+    const reveal = product.prizeRevealWindowStart;
+    if (reveal && new Date(reveal) <= new Date()) {
+        throw new ExpiredError("Prize draw entry window");
+    }
+}

package/dist/_internal/server/features/shared/listing-adapters.d.ts

@@ -0,0 +1,19 @@
+import type { ProductDocument } from "../../../../features/products/schemas/firestore";
+export interface BaseListingClientShape {
+    id: string;
+    title: string;
+    description: string;
+    price: number;
+    priceLabel: string;
+    currency: string;
+    mainImage: string | null;
+    images: string[];
+    storeId: string;
+    storeName: string | null;
+    category: string;
+    tags: string[];
+    status: ProductDocument["status"];
+    createdAt: string;
+}
+/** Maps the 11 shared fields from a raw Firestore ProductDocument. */
+export declare function mapBaseListingFields(doc: ProductDocument): BaseListingClientShape;

package/dist/_internal/server/features/shared/listing-adapters.js

@@ -0,0 +1,20 @@
+import { formatCurrency } from "../../../../utils/number.formatter";
+/** Maps the 11 shared fields from a raw Firestore ProductDocument. */
+export function mapBaseListingFields(doc) {
+    return {
+        id: doc.id,
+        title: doc.title,
+        description: doc.description,
+        price: doc.price,
+        priceLabel: formatCurrency(doc.price, doc.currency ?? "INR"),
+        currency: doc.currency ?? "INR",
+        mainImage: doc.mainImage || doc.images?.[0] || null,
+        images: doc.images ?? [],
+        storeId: doc.storeId,
+        storeName: doc.storeName ?? null,
+        category: doc.categorySlugs?.[0] ?? doc.category ?? "",
+        tags: doc.tags ?? [],
+        status: doc.status,
+        createdAt: doc.createdAt instanceof Date ? doc.createdAt.toISOString() : String(doc.createdAt),
+    };
+}

package/dist/_internal/server/features/shared/listing-data-factory.d.ts

@@ -0,0 +1,9 @@
+import type { ListingType } from "../../../../features/products/types";
+import type { ProductDocument } from "../../../../features/products/schemas/firestore";
+import type { ProductFeatureDocument } from "../../../../features/products/schemas/product-features";
+export declare function makeGetListingForDetail(type: ListingType): (slugOrId: string) => Promise<ProductDocument | null>;
+export declare const getProductFeaturesForStore: (storeId: string | null) => Promise<ProductFeatureDocument[]>;
+export declare function makeGetStoreListingsInitial(type: ListingType, pageSize: number): (storeId: string, page?: number) => Promise<{
+    items: ProductDocument[];
+    total: number;
+}>;

package/dist/_internal/server/features/shared/listing-data-factory.js

@@ -0,0 +1,33 @@
+import { cache } from "react";
+import { productRepository } from "../../../../repositories";
+import { loadProductFeaturesForStore } from "../../../../features/products/repository/loadProductFeatures";
+// Returns a React.cache()-wrapped fetch gated on one listing type.
+// The guard prevents cross-type URL collisions (e.g. /auctions/classified-slug returning wrong product).
+export function makeGetListingForDetail(type) {
+    return cache(async (slugOrId) => {
+        if (!slugOrId)
+            return null;
+        const product = await productRepository.findByIdOrSlug(slugOrId).catch(() => undefined);
+        if (!product || product.listingType !== type)
+            return null;
+        return product;
+    });
+}
+// Product-feature badges are keyed by store, not listing type.
+// Per-type data.ts files re-export this under a type-specific name.
+export const getProductFeaturesForStore = cache(async (storeId) => loadProductFeaturesForStore(storeId).catch(() => []));
+// Returns a React.cache()-wrapped function for store SSR first-page data.
+// Export names in stores/data.ts stay identical so consumers need no changes.
+export function makeGetStoreListingsInitial(type, pageSize) {
+    return cache(async (storeId, page = 1) => {
+        const result = await productRepository
+            .list({
+            filters: `storeId==${storeId},status==published,listingType==${type}`,
+            sorts: "-createdAt",
+            page,
+            pageSize,
+        })
+            .catch(() => null);
+        return { items: result?.items ?? [], total: result?.total ?? 0 };
+    });
+}