@mohasinac/appkit 4.9.5 → 4.11.0

package/dist/_internal/client/features/layout/DashboardLayoutClient.d.ts

@@ -35,7 +35,12 @@ export interface DashboardLayoutClientProps {
     permissions?: string[] | null;
     /** Override active-link highlight. Defaults to usePathname(). */
     activeHref?: string;
-    /** Responsive controls — currently only hideAt is honoured. */
+    /**
+     * Responsive controls — accepted for interface parity with the generic
+     * `SectionResponsive` shape used elsewhere, but not currently honoured by
+     * this component (no caller passes it today). Wire `hideAt`/`showAt`/
+     * `compactAt` to real chrome behaviour before relying on this prop.
+     */
     responsive?: SectionResponsive;
     /**
      * Cross-dashboard nav links shown in the sidebar footer. Plain hrefs

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

@@ -155,7 +155,10 @@ function DashboardBottomNav({ items, activeHref }) {
 const DEFAULT_CONTENT_PADDING_RIGHT = "px-[var(--appkit-space-5)] py-[var(--appkit-space-8)] lg:pl-14 lg:pr-6 xl:pl-16 xl:pr-10";
 const DEFAULT_CONTENT_PADDING_LEFT = "px-[var(--appkit-space-5)] py-[var(--appkit-space-8)] lg:pr-14 lg:pl-6 xl:pr-16 xl:pl-10";
 const DEFAULT_CONTENT_MAX_WIDTH = "max-w-screen-2xl";
-export function DashboardLayoutClient({ variant, groups, permissions, activeHref: explicitActiveHref, responsive: _responsive, crossNav, className, contentPadding, contentSurface, contentMaxWidth, lightBackground, darkBackground, children, }) {
+export function DashboardLayoutClient({ variant, groups, permissions, activeHref: explicitActiveHref, 
+// audit-dead-underscore-prop-ok: accepted for interface parity, not yet
+// wired — see the doc comment on `responsive` above; no caller passes it.
+responsive: _responsive, crossNav, className, contentPadding, contentSurface, contentMaxWidth, lightBackground, darkBackground, children, }) {
     const pathname = usePathname();
     const activeHref = explicitActiveHref ?? pathname ?? "";
     const storageKey = `appkit:sidebar-open:${variant}`;

package/dist/_internal/client/features/lottery/LotteryPullForm.d.ts

@@ -16,5 +16,5 @@ interface LotteryPullFormProps {
  * Submits TX ID + phone + payment time + item number.
  * On success, shows the user their lottery number and assigned prize slot.
  */
-export declare function LotteryPullForm({ sourceType, eventId, productId, totalSlots, maxPullsPerUser: _maxPullsPerUser, onSuccess, }: LotteryPullFormProps): React.JSX.Element;
+export declare function LotteryPullForm({ sourceType, eventId, productId, totalSlots, maxPullsPerUser, onSuccess, }: LotteryPullFormProps): React.JSX.Element;
 export {};

package/dist/_internal/client/features/lottery/LotteryPullForm.js

@@ -10,7 +10,7 @@ import { apiClient } from "../../../../http";
  * Submits TX ID + phone + payment time + item number.
  * On success, shows the user their lottery number and assigned prize slot.
  */
-export function LotteryPullForm({ sourceType, eventId, productId, totalSlots, maxPullsPerUser: _maxPullsPerUser, onSuccess, }) {
+export function LotteryPullForm({ sourceType, eventId, productId, totalSlots, maxPullsPerUser, onSuccess, }) {
     const [result, setResult] = useState(null);
     const [transactionId, setTransactionId] = useState("");
     const [paymentTime, setPaymentTime] = useState("");
@@ -39,7 +39,7 @@ export function LotteryPullForm({ sourceType, eventId, productId, totalSlots, ma
     if (result) {
         return (_jsxs(Stack, { gap: "sm", padding: "md", rounded: "2xl", surface: "success-surface", className: "border border-success/20", children: [_jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Span, { layout: "inline-flex", color: "inverse", weight: "semibold", className: "bg-success text-[11px] tracking-wide", padding: "pill-sm", rounded: "full", transform: "uppercase", children: "Entry Confirmed" }), _jsxs(Heading, { level: 2, className: "text-success", size: "lg", weight: "bold", children: ["You're #", result.userLotteryNumber, "!"] })] }), _jsxs(Text, { className: "text-success", size: "sm", children: ["You've been assigned", " ", _jsxs(Span, { weight: "bold", children: ["Slot #", result.assignedPrizeSlotNumber] }), result.slotName ? ` — ${result.slotName}` : "", ". Good luck!"] })] }));
     }
-    return (_jsx(Form, { onSubmit: (e) => e.preventDefault(), className: "space-y-4", children: ({ setFieldError, clearErrors }) => (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", children: "Submit Your Entry" }), _jsx(Text, { size: "sm", color: "muted", children: "Enter your UPI Transaction ID and payment details to claim your slot." }), _jsx(FieldInput, { name: "transactionId", label: "Transaction ID (UPI Ref / Payment Ref)", placeholder: "e.g. 123456789012", required: true, value: transactionId, onChange: (v) => { setTransactionId(v); clearErrors(); } }), _jsx(FieldInput, { name: "paymentTime", label: "Payment Date & Time", type: "datetime-local", required: true, value: paymentTime, onChange: (v) => { setPaymentTime(v); clearErrors(); } }), _jsx(FieldInput, { name: "itemNumber", label: `Slot Number (1 – ${totalSlots})`, type: "number", placeholder: `Enter a number between 1 and ${totalSlots}`, required: true, value: itemNumber, onChange: (v) => { setItemNumber(v); clearErrors(); } }), _jsx(FieldInput, { name: "userPhone", label: "Your Phone Number", type: "tel", placeholder: "e.g. 9876543210", required: true, value: userPhone, onChange: (v) => { setUserPhone(v); clearErrors(); } }), _jsx(Button, { type: "submit", variant: "primary", isLoading: mutation.isPending, onClick: () => {
+    return (_jsx(Form, { onSubmit: (e) => e.preventDefault(), className: "space-y-4", children: ({ setFieldError, clearErrors }) => (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", children: "Submit Your Entry" }), _jsxs(Text, { size: "sm", color: "muted", children: ["Enter your UPI Transaction ID and payment details to claim your slot.", " ", "You may enter up to ", maxPullsPerUser, " time", maxPullsPerUser === 1 ? "" : "s", "."] }), _jsx(FieldInput, { name: "transactionId", label: "Transaction ID (UPI Ref / Payment Ref)", placeholder: "e.g. 123456789012", required: true, value: transactionId, onChange: (v) => { setTransactionId(v); clearErrors(); } }), _jsx(FieldInput, { name: "paymentTime", label: "Payment Date & Time", type: "datetime-local", required: true, value: paymentTime, onChange: (v) => { setPaymentTime(v); clearErrors(); } }), _jsx(FieldInput, { name: "itemNumber", label: `Slot Number (1 – ${totalSlots})`, type: "number", placeholder: `Enter a number between 1 and ${totalSlots}`, required: true, value: itemNumber, onChange: (v) => { setItemNumber(v); clearErrors(); } }), _jsx(FieldInput, { name: "userPhone", label: "Your Phone Number", type: "tel", placeholder: "e.g. 9876543210", required: true, value: userPhone, onChange: (v) => { setUserPhone(v); clearErrors(); } }), _jsx(Button, { type: "submit", variant: "primary", isLoading: mutation.isPending, onClick: () => {
                         clearErrors();
                         const num = parseInt(itemNumber, 10);
                         let valid = true;

package/dist/_internal/server/features/admin/daily-digest-actions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Manual trigger for the daily status digest.
+ *
+ * The digest normally runs from the `dailyStatusDigest` scheduled Firebase
+ * Function (10:00 IST). Firebase has no "run on first deploy" trigger, so
+ * this exists to fire the exact same core function on demand — e.g. right
+ * after a fresh deploy, to confirm the whole chain works without waiting
+ * for the next morning. Both paths share one implementation; there is no
+ * second copy of the digest logic.
+ */
+import { type DailyStatusDigestResult } from "../../jobs/core/dailyStatusDigest";
+export declare function triggerDailyStatusDigest(): Promise<DailyStatusDigestResult>;
+/**
+ * Fires the digest once per deployment version, from server startup.
+ * Safe to call on every cold start — `runDeploymentDigest` claims the
+ * version in a Firestore transaction and no-ops if it's already been sent.
+ */
+export declare function triggerDeploymentDigest(version: string): Promise<DailyStatusDigestResult>;

package/dist/_internal/server/features/admin/daily-digest-actions.js

@@ -0,0 +1,37 @@
+/**
+ * Manual trigger for the daily status digest.
+ *
+ * The digest normally runs from the `dailyStatusDigest` scheduled Firebase
+ * Function (10:00 IST). Firebase has no "run on first deploy" trigger, so
+ * this exists to fire the exact same core function on demand — e.g. right
+ * after a fresh deploy, to confirm the whole chain works without waiting
+ * for the next morning. Both paths share one implementation; there is no
+ * second copy of the digest logic.
+ */
+import { getAdminDb } from "../../../../providers/db-firebase";
+import { serverLogger } from "../../../../monitoring";
+import { runDailyStatusDigest, runDeploymentDigest, } from "../../jobs/core/dailyStatusDigest";
+function buildManualJobContext(job) {
+    return {
+        job,
+        db: getAdminDb(),
+        logger: {
+            info: (message, meta) => serverLogger.info(message, meta),
+            warn: (message, meta) => serverLogger.warn(message, meta),
+            error: (message, err, meta) => serverLogger.error(message, { err, ...(meta ?? {}) }),
+        },
+        env: (key) => process.env[key],
+        now: new Date(),
+    };
+}
+export async function triggerDailyStatusDigest() {
+    return runDailyStatusDigest(buildManualJobContext("dailyStatusDigest:manual"));
+}
+/**
+ * Fires the digest once per deployment version, from server startup.
+ * Safe to call on every cold start — `runDeploymentDigest` claims the
+ * version in a Firestore transaction and no-ops if it's already been sent.
+ */
+export async function triggerDeploymentDigest(version) {
+    return runDeploymentDigest(buildManualJobContext("dailyStatusDigest:deploy"), version);
+}

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/audit-log/actions.d.ts

@@ -0,0 +1,25 @@
+/**
+ * recordAdminAction — the single write-site for the admin audit trail.
+ *
+ * MVP scope: instruments the highest-value already-privileged admin actions
+ * (bans, checkout bypass, coupon edits, payout mark-paid, store status
+ * changes, role changes) rather than sweeping every write path in the app —
+ * see CLAUDE.md's "Admin Audit Log" section for the full instrumented-action
+ * list and rationale.
+ *
+ * Callers should treat this as best-effort/non-blocking — a failure to write
+ * an audit entry must never fail the underlying privileged action itself.
+ */
+import type { AdminAuditAction } from "../../../../features/audit-log/schemas/firestore";
+import type { JsonValue } from "../../../../schemas/types";
+export interface RecordAdminActionInput {
+    actorUid: string;
+    actorName?: string;
+    action: AdminAuditAction;
+    targetType: string;
+    targetId: string;
+    targetLabel?: string;
+    reason?: string;
+    metadata?: Record<string, JsonValue>;
+}
+export declare function recordAdminAction(input: RecordAdminActionInput): Promise<void>;

package/dist/_internal/server/features/audit-log/actions.js

@@ -0,0 +1,38 @@
+/**
+ * recordAdminAction — the single write-site for the admin audit trail.
+ *
+ * MVP scope: instruments the highest-value already-privileged admin actions
+ * (bans, checkout bypass, coupon edits, payout mark-paid, store status
+ * changes, role changes) rather than sweeping every write path in the app —
+ * see CLAUDE.md's "Admin Audit Log" section for the full instrumented-action
+ * list and rationale.
+ *
+ * Callers should treat this as best-effort/non-blocking — a failure to write
+ * an audit entry must never fail the underlying privileged action itself.
+ */
+import { adminAuditLogRepository } from "../../../../features/audit-log/repository/audit-log.repository";
+import { normalizeError } from "../../../../errors/normalize";
+import { serverLogger } from "../../../../monitoring";
+export async function recordAdminAction(input) {
+    try {
+        await adminAuditLogRepository.create({
+            actorUid: input.actorUid,
+            actorName: input.actorName,
+            action: input.action,
+            targetType: input.targetType,
+            targetId: input.targetId,
+            targetLabel: input.targetLabel,
+            reason: input.reason,
+            metadata: input.metadata,
+        });
+    }
+    catch (err) {
+        const normalized = normalizeError(err);
+        serverLogger.warn("recordAdminAction failed (non-critical)", {
+            action: input.action,
+            targetType: input.targetType,
+            targetId: input.targetId,
+            error: normalized.message,
+        });
+    }
+}

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

@@ -26,8 +26,6 @@ function brandInputToCategoryFields(input) {
         out.brandCountry = input.country;
     if (input.founded !== undefined)
         out.brandFounded = input.founded;
-    if (input.bannerURL !== undefined)
-        out.brandBannerImage = input.bannerURL;
     if (input.logoURL !== undefined) {
         out.display = { coverImage: input.logoURL, showInMenu: false, showInFooter: false };
     }

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

@@ -7,7 +7,10 @@ export interface BrandOgData {
 interface BrandDocLike {
     name?: string | null;
     description?: string | null;
-    logoURL?: string | null;
+    /** CategoryDocument has no `logoURL` field — the brand's image lives at `display.coverImage`, the same field the hero banner and generateMetadata's OG meta tag already use. */
+    display?: {
+        coverImage?: string | null;
+    } | null;
 }
 /** High-level OG renderer — accepts the raw brand document from `getBrandForDetail`. */
 export declare function renderBrandOg(doc: BrandDocLike | null | undefined, opts: {

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

@@ -7,7 +7,7 @@ export function renderBrandOg(doc, opts) {
         name,
         description: doc?.description?.slice(0, 120) ??
             `Shop authentic ${name} collectibles on ${opts.siteName}.`,
-        logoUrl: resolveOgImageUrl(doc?.logoURL ?? null, opts.baseUrl),
+        logoUrl: resolveOgImageUrl(doc?.display?.coverImage ?? null, opts.baseUrl),
     }, opts.siteName);
 }
 export function renderBrandOgImage(data, siteName) {

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,22 @@ 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[]>;
+/** Groups tagged to a category, hydrated with all member products — for the category detail page's GroupedListingsCarousel. */
+export declare const getGroupsForCategory: (categorySlug: string) => Promise<GroupedListingWithItems[]>;
+/** Groups tagged to a brand, hydrated with all member products — for the brand detail page's GroupedListingsCarousel. */
+export declare const getGroupsForBrand: (brandSlug: 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,55 @@ 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) };
+    }));
+});
+/** Groups tagged to a category, hydrated with all member products — for the category detail page's GroupedListingsCarousel. */
+export const getGroupsForCategory = cache(async (categorySlug) => {
+    const groups = await groupedListingsRepository.findByCategorySlug(categorySlug).catch((err) => {
+        void normalizeError(err);
+        serverLogger.warn("grouped-data: getGroupsForCategory failed — returning empty", { categorySlug, error: err instanceof Error ? err.message : String(err) });
+        return [];
+    });
+    return Promise.all(groups.map(async (group) => {
+        const items = await Promise.all(group.productIds.map((id) => productRepository.findByIdOrSlug(id).catch(() => null)));
+        return { ...group, items: items.filter((p) => p !== null) };
+    }));
+});
+/** Groups tagged to a brand, hydrated with all member products — for the brand detail page's GroupedListingsCarousel. */
+export const getGroupsForBrand = cache(async (brandSlug) => {
+    const groups = await groupedListingsRepository.findByBrandSlug(brandSlug).catch((err) => {
+        void normalizeError(err);
+        serverLogger.warn("grouped-data: getGroupsForBrand failed — returning empty", { brandSlug, error: err instanceof Error ? err.message : String(err) });
+        return [];
+    });
+    return Promise.all(groups.map(async (group) => {
+        const items = await Promise.all(group.productIds.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, getGroupsForCategory, getGroupsForBrand, 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, getGroupsForCategory, getGroupsForBrand, } 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/orders/actions.js

@@ -161,6 +161,15 @@ export async function attachPaymentProofAction(orderId, proof) {
             buyerFraudAgreementAcceptedAt: new Date(),
             buyerReportedUpiId: proof.buyerReportedUpiId,
             paymentUpiMismatch,
+            // A re-upload after `adminRequestProofReuploadAction` must clear the
+            // stale `reupload_requested` outcome. Both the 2-hour auto-approve
+            // sweep (`getUnreviewedProofPastDeadline`) and the admin
+            // "Awaiting verification" queue treat *any* set outcome as "already
+            // decided" — leaving it set meant a corrected proof was invisible to
+            // both: never auto-approved, never surfaced for manual review.
+            paymentReviewOutcome: null,
+            paymentReviewedBy: null,
+            paymentReviewedAt: null,
         });
         notifyAdminsOfPaymentProof({
             id: orderId,

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

@@ -1,3 +1,6 @@
+function toIsoOrUndefined(value) {
+    return value instanceof Date ? value.toISOString() : undefined;
+}
 export function orderDocumentToOrder(doc) {
     const items = doc.items?.length
         ? doc.items.map((item) => ({
@@ -55,10 +58,32 @@ export function orderDocumentToOrder(doc) {
         couponCode: doc.couponCode,
         trackingNumber: doc.trackingNumber,
         shippingCarrier: doc.shippingCarrier,
+        trackingUrl: doc.trackingUrl,
         notes: doc.notes,
+        orderDate: toIsoOrUndefined(doc.orderDate),
+        shippingDate: toIsoOrUndefined(doc.shippingDate),
+        deliveryDate: toIsoOrUndefined(doc.deliveryDate),
+        cancellationDate: toIsoOrUndefined(doc.cancellationDate),
         autoApproved: doc.autoApproved,
         disputeRaised: doc.disputeRaised,
         disputeStatus: doc.disputeStatus,
+        // Manual-payment (cash / UPI / EMI) passthrough. These were previously
+        // dropped here, which silently disabled the entire buyer proof-upload
+        // flow: `/user/orders/[id]/payment` branches on `paymentMethod` and so
+        // rendered "this order does not require manual payment upload" for every
+        // order, with no UPI ID and no countdown.
+        paymentMethod: doc.paymentMethod,
+        displayedUpiId: doc.displayedUpiId,
+        paymentDeadline: toIsoOrUndefined(doc.paymentDeadline),
+        paymentProofUrl: doc.paymentProofUrl,
+        paymentProofUploadedAt: toIsoOrUndefined(doc.paymentProofUploadedAt),
+        paymentTransactionId: doc.paymentTransactionId,
+        buyerReportedUpiId: doc.buyerReportedUpiId,
+        buyerMarkedPaid: doc.buyerMarkedPaid,
+        paymentUpiMismatch: doc.paymentUpiMismatch,
+        paymentReviewOutcome: doc.paymentReviewOutcome,
+        paymentReviewNote: doc.paymentReviewNote,
+        cancellationReason: doc.cancellationReason,
         createdAt: doc.createdAt instanceof Date
             ? doc.createdAt.toISOString()
             : String(doc.createdAt),

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>;