@mohasinac/appkit 4.9.5 → 4.10.0

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

@@ -1,6 +1,6 @@
 "use server";
 import { wrapAction } from "@mohasinac/appkit/server";
-import { bidRepository, productRepository, userRepository } from "../../../../repositories";
+import { bidRepository, productRepository, userRepository, siteSettingsRepository } from "../../../../repositories";
 import { requireRoleUser } from "../../../../providers/auth-firebase/helpers";
 import { placeBidSchema } from "../../../shared/features/auctions/schema";
 import { assertAuctionActive, assertBidAmount, assertNotAuctionOwner, shouldAutoExtend, computeExtendedEndDate, } from "./service";
@@ -14,7 +14,8 @@ export async function placeBidAction(input) {
         const { auctionId, amount } = parsed.data;
         const product = await assertAuctionActive(auctionId);
         assertNotAuctionOwner(product, user.uid);
-        assertBidAmount(product, amount);
+        const settings = await siteSettingsRepository.getSingleton();
+        assertBidAmount(product, amount, settings.auctionConfig?.bidIncrementTiers ?? []);
         const profile = await userRepository.findById(user.uid).catch(() => null);
         const userName = profile?.displayName ?? user.name ?? "Anonymous";
         // Mark all current bids for this auction as outbid, then set new winning bid

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

@@ -1,10 +1,11 @@
+import { type BidIncrementTier } from "../../../shared/features/auctions/config";
 import type { ProductDocument } from "../../../shared/features/products/types";
 /** Assert an auction exists, is published, and is still active. Returns the product. */
 export declare function assertAuctionActive(auctionId: string): Promise<ProductDocument>;
-/** Compute the minimum valid bid given the current state. */
-export declare function computeMinBid(product: ProductDocument): number;
+/** Compute the minimum valid bid given the current state and the admin's tier table. */
+export declare function computeMinBid(product: ProductDocument, tiers: BidIncrementTier[]): number;
 /** Assert a bid amount is valid against the current auction state. */
-export declare function assertBidAmount(product: ProductDocument, amount: number): void;
+export declare function assertBidAmount(product: ProductDocument, amount: number, tiers: BidIncrementTier[]): void;
 /** Assert the bidder is not the auction owner. */
 export declare function assertNotAuctionOwner(product: ProductDocument, bidderId: string): void;
 /** Return true if the bid was placed within the sniping window and the auction should auto-extend. */

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

@@ -1,7 +1,7 @@
 import { productRepository } from "../../../../repositories";
 import { isAuctionListing } from "../../../../features/products/utils/listing-type";
 import { AuctionNotFoundError, AuctionEndedError, BidTooLowError, BidOnOwnAuctionError, } from "../../../shared/features/auctions/errors";
-import { AUCTION_MIN_BID_INCREMENT, AUCTION_SNIPING_WINDOW_SECONDS, AUCTION_DEFAULT_EXTENSION_MINUTES, } from "../../../shared/features/auctions/config";
+import { AUCTION_SNIPING_WINDOW_SECONDS, AUCTION_DEFAULT_EXTENSION_MINUTES, resolveMinBidIncrement, } from "../../../shared/features/auctions/config";
 /** Assert an auction exists, is published, and is still active. Returns the product. */
 export async function assertAuctionActive(auctionId) {
     const product = await productRepository.findByIdOrSlug(auctionId).catch(() => null);
@@ -16,15 +16,15 @@ export async function assertAuctionActive(auctionId) {
         throw new AuctionEndedError(auctionId);
     return product;
 }
-/** Compute the minimum valid bid given the current state. */
-export function computeMinBid(product) {
+/** Compute the minimum valid bid given the current state and the admin's tier table. */
+export function computeMinBid(product, tiers) {
     const current = product.currentBid ?? product.startingBid ?? 0;
-    const increment = product.minBidIncrement ?? AUCTION_MIN_BID_INCREMENT;
+    const increment = resolveMinBidIncrement(current, tiers, product.minBidIncrement);
     return current + increment;
 }
 /** Assert a bid amount is valid against the current auction state. */
-export function assertBidAmount(product, amount) {
-    const minBid = computeMinBid(product);
+export function assertBidAmount(product, amount, tiers) {
+    const minBid = computeMinBid(product, tiers);
     if (amount < minBid)
         throw new BidTooLowError(minBid);
 }

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

@@ -45,3 +45,12 @@ export declare function resolveBundleOriginalTotal(productIds: string[]): Promis
  * `limit` (default 8) and filtered to `isActive: true` server-side.
  */
 export declare const listFeaturedBundles: (limit?: number, _opts?: BundleDataOptions) => Promise<CategoryDocument[]>;
+/**
+ * "Related Bundles" for the bundle detail page — every other active bundle,
+ * excluding the current one. Bundles are a CategoryDocument, not a
+ * ProductDocument, so this mirrors BrandDetailPageView's "Related Brands"
+ * pattern (all active siblings of the same categoryType) rather than the
+ * product-based 4-signal computeRelatedItems() used elsewhere — bundle
+ * detail pages had no related section at all before this.
+ */
+export declare const getRelatedBundles: (bundle: Pick<CategoryDocument, "id">, limit?: number) => Promise<CategoryDocument[]>;

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

@@ -79,3 +79,17 @@ export const listFeaturedBundles = cache(async (limit = 8, _opts) => {
         .catch(() => []);
     return all;
 });
+/**
+ * "Related Bundles" for the bundle detail page — every other active bundle,
+ * excluding the current one. Bundles are a CategoryDocument, not a
+ * ProductDocument, so this mirrors BrandDetailPageView's "Related Brands"
+ * pattern (all active siblings of the same categoryType) rather than the
+ * product-based 4-signal computeRelatedItems() used elsewhere — bundle
+ * detail pages had no related section at all before this.
+ */
+export const getRelatedBundles = cache(async (bundle, limit = 8) => {
+    const all = await categoriesRepository
+        .listByType("bundle", { activeOnly: true, limit: limit + 1 })
+        .catch(() => []);
+    return all.filter((b) => b.id !== bundle.id).slice(0, limit);
+});

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

@@ -1,4 +1,4 @@
-export { getBundleForDetail, listBundleMembers, listFeaturedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, type BundleDataOptions, } from "./data";
+export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, type BundleDataOptions, } from "./data";
 export { buildBundleMetadata, type BundleMetadataOptions } from "./metadata";
 export { renderBundleOg, renderBundleOgImage, type BundleOgData, } from "./og";
 export { addBundleToCartAction } from "./actions";

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

@@ -1,4 +1,4 @@
-export { getBundleForDetail, listBundleMembers, listFeaturedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, } from "./data";
+export { getBundleForDetail, listBundleMembers, listFeaturedBundles, getRelatedBundles, resolveBundleMemberIds, resolveBundleOriginalTotal, } from "./data";
 export { buildBundleMetadata } from "./metadata";
 // S-SBUNI-4 2026-05-13 — bundle OG renderer.
 export { renderBundleOg, renderBundleOgImage, } from "./og";

package/dist/_internal/server/features/catalogue/og.d.ts

@@ -0,0 +1,20 @@
+import type { ReactElement } from "react";
+export interface CatalogueItemOgData {
+    title: string;
+    ownerName?: string | null;
+    priceLabel?: string | null;
+    imageUrl?: string | null;
+}
+interface CatalogueItemDocLike {
+    title?: string | null;
+    price?: number | null;
+    mainImage?: string | null;
+    images?: (string | null | undefined)[] | null;
+}
+export declare function renderCatalogueItemOg(doc: CatalogueItemDocLike | null | undefined, opts: {
+    siteName: string;
+    baseUrl?: string;
+    ownerName?: string | null;
+}): ReactElement;
+export declare function renderCatalogueItemOgImage(data: CatalogueItemOgData, siteName: string): ReactElement;
+export {};

package/dist/_internal/server/features/catalogue/og.js

@@ -0,0 +1,27 @@
+import { renderOgLayout } from "../seo/og-layout";
+import { resolveOgImageUrl } from "../seo/og";
+export function renderCatalogueItemOg(doc, opts) {
+    const priceLabel = doc?.price != null && doc.price > 0
+        ? new Intl.NumberFormat("en-IN", {
+            style: "currency",
+            currency: "INR",
+            maximumFractionDigits: 0,
+        }).format(doc.price)
+        : null;
+    return renderCatalogueItemOgImage({
+        title: doc?.title ?? "Catalogue Item",
+        ownerName: opts.ownerName,
+        priceLabel,
+        imageUrl: resolveOgImageUrl(doc?.mainImage || doc?.images?.[0] || null, opts.baseUrl),
+    }, opts.siteName);
+}
+export function renderCatalogueItemOgImage(data, siteName) {
+    return renderOgLayout({
+        title: data.title,
+        subtitle: data.ownerName ? `Owned by ${data.ownerName}` : undefined,
+        imageUrl: data.imageUrl,
+        siteName: `${siteName} · Catalogue`,
+        accentSlot: data.priceLabel,
+        theme: { accentColor: "#a78bfa" },
+    });
+}

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

@@ -18,6 +18,18 @@ export interface ListGroupedListingsParams {
 export declare function listGroupedListings(params?: ListGroupedListingsParams): Promise<GroupedListingDocument[]>;
 /** Featured grouped listings for homepage strips. */
 export declare const listFeaturedGroupedListings: (limit?: number) => Promise<GroupedListingDocument[]>;
+/**
+ * Groups a product belongs to that are eligible to render publicly —
+ * powers the "You might also like" / "Same character" / etc. carousel
+ * on product-based listing detail pages. Deduped per request.
+ */
+export declare const getGroupsForProduct: (productId: string) => Promise<GroupedListingDocument[]>;
+/**
+ * Groups a product belongs to, each hydrated with its OTHER member products
+ * (the current product is excluded from its own group's item list) — ready
+ * to render directly as a public GroupedListingsCarousel section.
+ */
+export declare const getGroupsWithItemsForProduct: (productId: string) => Promise<GroupedListingWithItems[]>;
 export interface SitemapGroupedListing {
     slug: string;
     updatedAt: Date;

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

@@ -3,7 +3,7 @@ import { getAdminDb } from "../../../../providers/db-firebase";
 import { normalizeError } from "../../../../errors/normalize";
 import { serverLogger } from "../../../../monitoring/server-logger";
 import { GROUPED_LISTINGS_COLLECTION, } from "../../../../features/grouped/schemas/firestore";
-import { productRepository } from "../../../../repositories";
+import { productRepository, groupedListingsRepository } from "../../../../repositories";
 import { PRODUCT_FIELDS, CATEGORY_FIELDS } from "../../../../constants/field-names";
 import { GROUPED_LISTINGS_FEATURED_LIMIT, GROUPED_LISTINGS_PAGE_SIZE, GROUPED_LISTINGS_SITEMAP_LIMIT, } from "../../../shared/features/grouped/config";
 function mapDoc(doc) {
@@ -107,6 +107,31 @@ export async function listGroupedListings(params = {}) {
 export const listFeaturedGroupedListings = cache(async (limit = GROUPED_LISTINGS_FEATURED_LIMIT) => {
     return listGroupedListings({ featuredOnly: true, limit });
 });
+/**
+ * Groups a product belongs to that are eligible to render publicly —
+ * powers the "You might also like" / "Same character" / etc. carousel
+ * on product-based listing detail pages. Deduped per request.
+ */
+export const getGroupsForProduct = cache(async (productId) => {
+    return groupedListingsRepository.findByProductId(productId).catch((err) => {
+        void normalizeError(err);
+        serverLogger.warn("grouped-data: getGroupsForProduct failed — returning empty", { productId, error: err instanceof Error ? err.message : String(err) });
+        return [];
+    });
+});
+/**
+ * Groups a product belongs to, each hydrated with its OTHER member products
+ * (the current product is excluded from its own group's item list) — ready
+ * to render directly as a public GroupedListingsCarousel section.
+ */
+export const getGroupsWithItemsForProduct = cache(async (productId) => {
+    const groups = await getGroupsForProduct(productId);
+    return Promise.all(groups.map(async (group) => {
+        const otherIds = group.productIds.filter((id) => id !== productId);
+        const items = await Promise.all(otherIds.map((id) => productRepository.findByIdOrSlug(id).catch(() => null)));
+        return { ...group, items: items.filter((p) => p !== null) };
+    }));
+});
 export async function listSitemapGroupedListings() {
     try {
         const db = getAdminDb();

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

@@ -1,2 +1,2 @@
-export { getGroupedListingForDetail, getGroupedListingWithItems, listGroupedListings, listFeaturedGroupedListings, listSitemapGroupedListings, type GroupedListingWithItems, type ListGroupedListingsParams, type SitemapGroupedListing, } from "./data";
+export { getGroupedListingForDetail, getGroupedListingWithItems, listGroupedListings, listFeaturedGroupedListings, listSitemapGroupedListings, getGroupsForProduct, getGroupsWithItemsForProduct, 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

@@ -1,2 +1,2 @@
-export { getGroupedListingForDetail, getGroupedListingWithItems, listGroupedListings, listFeaturedGroupedListings, listSitemapGroupedListings, } from "./data";
+export { getGroupedListingForDetail, getGroupedListingWithItems, listGroupedListings, listFeaturedGroupedListings, listSitemapGroupedListings, getGroupsForProduct, getGroupsWithItemsForProduct, } 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/products/data.d.ts

@@ -1,9 +1,16 @@
 import type { ProductDocument } from "../../../../features/products/schemas/firestore";
 import type { ListingType } from "../../../../features/products/types";
+import type { ProductItem } from "../../../../features/products/types";
+import type { FirestoreDocument } from "../../../../schemas/types";
+import type { Review } from "../../../../features/reviews/types";
 /** Fetch a single product by slug or id, deduped per request. */
 export declare const getProductForDetail: (slugOrId: string) => Promise<ProductDocument | null>;
 /** Fetch the first page of approved reviews for a product, deduped per request. */
 export declare const getReviewsForProduct: (productId: string) => Promise<unknown[]>;
+/** Firestore review doc → client Review shape. Shared by every listing-type detail page's reviews tab. */
+export declare function toReview(doc: FirestoreDocument): Review;
+/** Fetch + map approved reviews for a product straight to the client Review shape, deduped per request. */
+export declare const getReviewItemsForProduct: (productId: string) => Promise<Review[]>;
 /** Minimal product fields needed for sitemap generation. */
 export interface SitemapProduct {
     slugOrId: string;
@@ -13,3 +20,19 @@ export interface SitemapProduct {
 }
 /** List all published products for sitemap generation. */
 export declare function listSitemapProducts(): Promise<SitemapProduct[]>;
+export interface RelatedItemsResult {
+    relatedItems: ProductItem[];
+    relatedByBrand: ProductItem[];
+    relatedByTags: ProductItem[];
+    relatedByStore: ProductItem[];
+}
+/** Firestore doc → card-grid shape. Shared by every related/similar-items carousel. */
+export declare function toProductItem(doc: FirestoreDocument): ProductItem;
+/**
+ * Same 4-signal related-items computation used across every listing-type
+ * detail page (category / brand / tag-overlap / same-store), each excluding
+ * invalid states for that item's own listing type. Extracted from
+ * ProductDetailPageView so pre-order/prize-draw/classified/digital-code/live
+ * pages can reuse it instead of having no related section at all.
+ */
+export declare const computeRelatedItems: (product: ProductDocument) => Promise<RelatedItemsResult>;

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

@@ -7,6 +7,7 @@ import { serverLogger } from "../../../../monitoring/server-logger";
 import { PRODUCT_COLLECTION } from "../../../../features/products/schemas/firestore";
 import { PRODUCTS_SITEMAP_LIMIT } from "../../../shared/features/products/config";
 import { PRODUCT_FIELDS } from "../../../../constants/field-names";
+import { SIEVE_OP, sieveAnd, sieveFilter, sortBy } from "../../../../utils/sieve-builder";
 // ---------------------------------------------------------------------------
 // Request-scoped cache — each function is deduplicated per RSC render tree.
 // Both generateMetadata() and the page component get the same promise.
@@ -23,6 +24,38 @@ export const getProductForDetail = cache(async (slugOrId) => {
 export const getReviewsForProduct = cache(async (productId) => {
     return reviewRepository.findApprovedByProduct(productId).catch(() => []);
 });
+/** Firestore review doc → client Review shape. Shared by every listing-type detail page's reviews tab. */
+export function toReview(doc) {
+    const images = Array.isArray(doc.images) ? doc.images : undefined;
+    const createdAt = doc.createdAt instanceof Date
+        ? doc.createdAt.toISOString()
+        : typeof doc.createdAt === "string"
+            ? doc.createdAt
+            : undefined;
+    const rawRating = typeof doc.rating === "number" ? doc.rating : 3;
+    const rating = Math.min(5, Math.max(1, Math.round(rawRating)));
+    return {
+        id: String(doc.id ?? ""),
+        productId: String(doc.productId ?? ""),
+        userId: String(doc.userId ?? ""),
+        userName: String(doc.userName ?? "Anonymous"),
+        userAvatar: typeof doc.userAvatar === "string" ? doc.userAvatar : undefined,
+        rating,
+        title: typeof doc.title === "string" ? doc.title : undefined,
+        comment: typeof doc.comment === "string" ? doc.comment : undefined,
+        images,
+        status: doc.status ?? "approved",
+        helpfulCount: typeof doc.helpfulCount === "number" ? doc.helpfulCount : undefined,
+        verified: doc.verified === true,
+        featured: doc.featured === true,
+        createdAt,
+    };
+}
+/** Fetch + map approved reviews for a product straight to the client Review shape, deduped per request. */
+export const getReviewItemsForProduct = cache(async (productId) => {
+    const docs = await reviewRepository.findApprovedByProduct(productId).catch(() => []);
+    return docs.map(toReview);
+});
 /** List all published products for sitemap generation. */
 export async function listSitemapProducts() {
     try {
@@ -54,3 +87,129 @@ export async function listSitemapProducts() {
         return [];
     }
 }
+// ---------------------------------------------------------------------------
+// Related items — same 4-signal computation shared by every listing-type
+// detail page (category / brand / tag-overlap / same-store).
+// ---------------------------------------------------------------------------
+const RELATED_QUERY_PAGE_SIZE = 9;
+const RELATED_DISPLAY_LIMIT = 8;
+/** Firestore doc → card-grid shape. Shared by every related/similar-items carousel. */
+export function toProductItem(doc) {
+    return {
+        id: String(doc.id ?? ""),
+        title: String(doc.title ?? doc.name ?? ""),
+        price: typeof doc.price === "number" ? doc.price : 0,
+        originalPrice: typeof doc.originalPrice === "number" ? doc.originalPrice : undefined,
+        mainImage: Array.isArray(doc.images)
+            ? doc.images[0]
+            : typeof doc.mainImage === "string"
+                ? doc.mainImage
+                : undefined,
+        status: doc.status ?? "published",
+        slug: typeof doc.slug === "string" ? doc.slug : undefined,
+        storeName: typeof doc.storeName === "string" ? doc.storeName : undefined,
+        rating: typeof doc.rating === "number" ? doc.rating : undefined,
+        reviewCount: typeof doc.reviewCount === "number" ? doc.reviewCount : undefined,
+        // Without this, every related-item card silently linked to the standard
+        // PDP regardless of its real type (pluginFor() defaults to "standard"
+        // when listingType is missing) — same bug class as the Phase 1 routing
+        // fix, one hop further downstream in the related-items card link path.
+        listingType: doc.listingType ?? undefined,
+    };
+}
+/**
+ * Excludes the current product plus any listing-type-specific "invalid to
+ * surface as related" state: sold/archived/out-of-stock/draft, ended
+ * auctions, closed prize-draws, sold-out pre-orders, depleted digital-code
+ * pools.
+ */
+function isValidRelatedItem(r, currentProductId, now) {
+    if (r.id === currentProductId)
+        return false;
+    const s = r.status;
+    if (s && ["sold", "out_of_stock", "archived", "discontinued", "draft"].includes(s))
+        return false;
+    if (r.isSold === true)
+        return false;
+    if (r.availableQuantity === 0)
+        return false;
+    if (r.listingType === "auction" && r.auctionEndDate) {
+        const end = r.auctionEndDate;
+        const endDate = typeof end.toDate === "function"
+            ? end.toDate()
+            : end instanceof Date
+                ? end
+                : new Date(String(end));
+        if (endDate <= now)
+            return false;
+    }
+    if (r.listingType === "prize-draw" && r.prizeRevealStatus === "closed")
+        return false;
+    if (r.listingType === "pre-order" &&
+        typeof r.preOrderMaxQuantity === "number" &&
+        typeof r.preOrderCurrentCount === "number" &&
+        r.preOrderCurrentCount >= r.preOrderMaxQuantity) {
+        return false;
+    }
+    if (r.listingType === "digital-code" && r.codesAvailable === 0)
+        return false;
+    return true;
+}
+function toRelatedItems(docs, currentProductId) {
+    const now = new Date();
+    return docs
+        .filter((r) => isValidRelatedItem(r, currentProductId, now))
+        .slice(0, RELATED_DISPLAY_LIMIT)
+        .map(toProductItem);
+}
+/**
+ * Same 4-signal related-items computation used across every listing-type
+ * detail page (category / brand / tag-overlap / same-store), each excluding
+ * invalid states for that item's own listing type. Extracted from
+ * ProductDetailPageView so pre-order/prize-draw/classified/digital-code/live
+ * pages can reuse it instead of having no related section at all.
+ */
+export const computeRelatedItems = cache(async (product) => {
+    const p = product;
+    const primaryCategorySlug = Array.isArray(p.categorySlugs) ? p.categorySlugs[0] : undefined;
+    const brand = typeof p.brand === "string" ? p.brand : undefined;
+    const tags = Array.isArray(p.tags) ? p.tags : [];
+    const storeId = typeof p.storeId === "string" ? p.storeId : undefined;
+    const currentProductId = product.id;
+    const [sameCategoryDocs, sameBrandDocs, tagOverlapDocs, sameStoreDocs] = await Promise.all([
+        primaryCategorySlug
+            ? productRepository.findByCategory(primaryCategorySlug).catch(() => [])
+            : Promise.resolve([]),
+        brand
+            ? productRepository
+                .list({
+                filters: sieveAnd(sieveFilter("status", SIEVE_OP.EQ, "published"), sieveFilter("brand", SIEVE_OP.EQ, brand)),
+                sorts: sortBy("createdAt", "DESC"),
+                page: 1,
+                pageSize: RELATED_QUERY_PAGE_SIZE,
+            })
+                .then((r) => r.items)
+                .catch(() => [])
+            : Promise.resolve([]),
+        tags.length > 0
+            ? productRepository.findByTagsOverlap(tags, RELATED_QUERY_PAGE_SIZE).catch(() => [])
+            : Promise.resolve([]),
+        storeId
+            ? productRepository
+                .list({
+                filters: sieveAnd(sieveFilter("status", SIEVE_OP.EQ, "published"), sieveFilter("storeId", SIEVE_OP.EQ, storeId)),
+                sorts: sortBy("createdAt", "DESC"),
+                page: 1,
+                pageSize: RELATED_QUERY_PAGE_SIZE,
+            })
+                .then((r) => r.items)
+                .catch(() => [])
+            : Promise.resolve([]),
+    ]);
+    return {
+        relatedItems: toRelatedItems(sameCategoryDocs, currentProductId),
+        relatedByBrand: toRelatedItems(sameBrandDocs, currentProductId),
+        relatedByTags: toRelatedItems(tagOverlapDocs, currentProductId),
+        relatedByStore: toRelatedItems(sameStoreDocs, currentProductId),
+    };
+});

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

@@ -1,4 +1,4 @@
-export { getProductForDetail, getReviewsForProduct, listSitemapProducts, type SitemapProduct, } from "./data";
+export { getProductForDetail, getReviewsForProduct, listSitemapProducts, type SitemapProduct, computeRelatedItems, toProductItem, toReview, getReviewItemsForProduct, type RelatedItemsResult, } from "./data";
 export { assertProductOwnership, assertStatusTransition, assertInStock, effectivePrice, isAvailableForPurchase, } from "./service";
 export { createProductAction, createAuctionAction, createPreOrderAction, updateProductAction, deleteProductAction, setProductStatusAction, setProductFeaturedAction, } from "./actions";
 export { PRODUCTS_PAGE_SIZE, PRODUCTS_FEATURED_LIMIT, PRODUCTS_RELATED_LIMIT, PRODUCTS_SITEMAP_LIMIT } from "../../../shared/features/products/config";

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

@@ -1,4 +1,4 @@
-export { getProductForDetail, getReviewsForProduct, listSitemapProducts, } from "./data";
+export { getProductForDetail, getReviewsForProduct, listSitemapProducts, computeRelatedItems, toProductItem, toReview, getReviewItemsForProduct, } from "./data";
 export { assertProductOwnership, assertStatusTransition, assertInStock, effectivePrice, isAvailableForPurchase, } from "./service";
 export { createProductAction, createAuctionAction, createPreOrderAction, updateProductAction, deleteProductAction, setProductStatusAction, setProductFeaturedAction, } from "./actions";
 export { PRODUCTS_PAGE_SIZE, PRODUCTS_FEATURED_LIMIT, PRODUCTS_RELATED_LIMIT, PRODUCTS_SITEMAP_LIMIT } from "../../../shared/features/products/config";

package/dist/_internal/shared/features/auctions/config.d.ts

@@ -4,3 +4,23 @@ export declare const AUCTIONS_SITEMAP_LIMIT = 5000;
 export declare const AUCTION_DEFAULT_EXTENSION_MINUTES = 5;
 export declare const AUCTION_MIN_BID_INCREMENT = 1;
 export declare const AUCTION_SNIPING_WINDOW_SECONDS = 300;
+export interface BidIncrementTier {
+    /** Upper bound (inclusive) of this band's current-bid range. `null` = open-ended ("and above"), must be the last tier. */
+    upTo: number | null;
+    increment: number;
+}
+/** Seed/fallback tier table — single source of truth reused by both DEFAULT_SITE_SETTINGS_DATA and the admin editor's initial state. */
+export declare const DEFAULT_AUCTION_BID_INCREMENT_TIERS: BidIncrementTier[];
+/**
+ * Resolve the tiered minimum bid increment for a given current bid amount.
+ * Tier lookup is inclusive of each band's upper bound — e.g. with the
+ * default tiers, a current bid of exactly 1000 resolves to the 100
+ * increment (the 100-1000 tier), not the 200 increment of the next band.
+ */
+export declare function resolveTieredBidIncrement(currentBidAmount: number, tiers: BidIncrementTier[]): number;
+/**
+ * Effective minimum bid increment = max(admin tier floor, per-listing
+ * override). A seller's per-listing "Minimum Bid Increment" can require
+ * MORE than the platform tier, but can never undercut it.
+ */
+export declare function resolveMinBidIncrement(currentBidAmount: number, tiers: BidIncrementTier[], override?: number | null): number;

package/dist/_internal/shared/features/auctions/config.js

@@ -2,5 +2,35 @@ export const AUCTIONS_PAGE_SIZE = 20;
 export const AUCTIONS_ACTIVE_LIMIT = 50;
 export const AUCTIONS_SITEMAP_LIMIT = 5000;
 export const AUCTION_DEFAULT_EXTENSION_MINUTES = 5;
-export const AUCTION_MIN_BID_INCREMENT = 1; // ₹1
+export const AUCTION_MIN_BID_INCREMENT = 1; // ₹1 — last-resort fallback when bidIncrementTiers is empty/missing
 export const AUCTION_SNIPING_WINDOW_SECONDS = 300; // 5 minutes — triggers auto-extend
+/** Seed/fallback tier table — single source of truth reused by both DEFAULT_SITE_SETTINGS_DATA and the admin editor's initial state. */
+export const DEFAULT_AUCTION_BID_INCREMENT_TIERS = [
+    { upTo: 100, increment: 10 },
+    { upTo: 1000, increment: 100 },
+    { upTo: 5000, increment: 200 },
+    { upTo: 10000, increment: 500 },
+    { upTo: null, increment: 1000 },
+];
+/**
+ * Resolve the tiered minimum bid increment for a given current bid amount.
+ * Tier lookup is inclusive of each band's upper bound — e.g. with the
+ * default tiers, a current bid of exactly 1000 resolves to the 100
+ * increment (the 100-1000 tier), not the 200 increment of the next band.
+ */
+export function resolveTieredBidIncrement(currentBidAmount, tiers) {
+    for (const tier of tiers) {
+        if (tier.upTo === null || currentBidAmount <= tier.upTo)
+            return tier.increment;
+    }
+    return tiers[tiers.length - 1]?.increment ?? AUCTION_MIN_BID_INCREMENT;
+}
+/**
+ * Effective minimum bid increment = max(admin tier floor, per-listing
+ * override). A seller's per-listing "Minimum Bid Increment" can require
+ * MORE than the platform tier, but can never undercut it.
+ */
+export function resolveMinBidIncrement(currentBidAmount, tiers, override) {
+    const tierValue = resolveTieredBidIncrement(currentBidAmount, tiers);
+    return typeof override === "number" && override > tierValue ? override : tierValue;
+}

package/dist/_internal/shared/listing-types/art/config.d.ts

@@ -8,7 +8,7 @@ export declare const config: {
     badge: {
         label: string;
         className: string;
-    } | undefined;
+    };
     priceLabel: string;
     typeLabel: string;
     showsStockQuantity: boolean;

package/dist/_internal/shared/listing-types/art/config.js

@@ -7,7 +7,7 @@ export const config = {
     slugPrefix: "art-",
     cartLine: "single-product",
     detailRoute: (idOrSlug) => String(ROUTES.PUBLIC.PRODUCT_DETAIL(idOrSlug)),
-    badge: undefined,
+    badge: { label: "Art Print", className: "bg-primary-700 text-white" },
     priceLabel: "Price (₹)",
     typeLabel: "Art Print",
     showsStockQuantity: true,

package/dist/_internal/shared/listing-types/classified/config.d.ts

@@ -8,7 +8,7 @@ export declare const config: {
     badge: {
         label: string;
         className: string;
-    } | undefined;
+    };
     priceLabel: string;
     typeLabel: string;
     showsStockQuantity: boolean;

package/dist/_internal/shared/listing-types/classified/config.js

@@ -7,7 +7,7 @@ export const config = {
     slugPrefix: "classified-",
     cartLine: "blocked",
     detailRoute: (idOrSlug) => String(ROUTES.PUBLIC.CLASSIFIED_DETAIL(idOrSlug)),
-    badge: undefined,
+    badge: { label: "Classified", className: "bg-secondary text-white" },
     priceLabel: "Asking Price (₹)",
     typeLabel: "Classified",
     showsStockQuantity: true,

package/dist/_internal/shared/listing-types/digital-code/config.d.ts

@@ -8,7 +8,7 @@ export declare const config: {
     badge: {
         label: string;
         className: string;
-    } | undefined;
+    };
     priceLabel: string;
     typeLabel: string;
     showsStockQuantity: boolean;

package/dist/_internal/shared/listing-types/digital-code/config.js

@@ -7,7 +7,7 @@ export const config = {
     slugPrefix: "digitalcode-",
     cartLine: "single-product",
     detailRoute: (idOrSlug) => String(ROUTES.PUBLIC.DIGITAL_CODE_DETAIL(idOrSlug)),
-    badge: undefined,
+    badge: { label: "Digital Code", className: "bg-success-surface text-success" },
     priceLabel: "Price per Code (₹)",
     typeLabel: "Digital Code",
     showsStockQuantity: false,

package/dist/_internal/shared/listing-types/live/config.d.ts

@@ -8,7 +8,7 @@ export declare const config: {
     badge: {
         label: string;
         className: string;
-    } | undefined;
+    };
     priceLabel: string;
     typeLabel: string;
     showsStockQuantity: boolean;

package/dist/_internal/shared/listing-types/live/config.js

@@ -7,7 +7,7 @@ export const config = {
     slugPrefix: "live-",
     cartLine: "single-product",
     detailRoute: (idOrSlug) => String(ROUTES.PUBLIC.LIVE_DETAIL(idOrSlug)),
-    badge: undefined,
+    badge: { label: "Live Item", className: "bg-danger-surface text-error" },
     priceLabel: "Price (₹)",
     typeLabel: "Live Item",
     showsStockQuantity: true,

package/dist/_internal/shared/listing-types/prize-draw/config.d.ts

@@ -8,7 +8,7 @@ export declare const config: {
     badge: {
         label: string;
         className: string;
-    } | undefined;
+    };
     priceLabel: string;
     typeLabel: string;
     showsStockQuantity: boolean;

package/dist/_internal/shared/listing-types/prize-draw/config.js

@@ -7,7 +7,7 @@ export const config = {
     slugPrefix: "prizedraw-",
     cartLine: "single-product",
     detailRoute: (idOrSlug) => String(ROUTES.PUBLIC.PRIZE_DRAW_DETAIL(idOrSlug)),
-    badge: undefined,
+    badge: { label: "Prize Draw", className: "bg-primary text-white" },
     priceLabel: "Price (₹)",
     typeLabel: "Prize Draw",
     showsStockQuantity: false,

package/dist/_internal/shared/listing-types/stickers/config.d.ts

@@ -8,7 +8,7 @@ export declare const config: {
     badge: {
         label: string;
         className: string;
-    } | undefined;
+    };
     priceLabel: string;
     typeLabel: string;
     showsStockQuantity: boolean;