@mohasinac/appkit 2.7.26 → 2.7.30

package/dist/_internal/client/features/classified/ClassifiedDetailView.js

@@ -2,7 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from "react";
 import Link from "next/link";
-import { Badge, Container, Div, Heading, Row, Section, Stack, Text, } from "../../../../ui";
+import { Badge, Button, Container, Div, Heading, Row, Section, Stack, Text, } from "../../../../ui";
 import { ROUTES } from "../../../../next/routing/route-map";
 import { formatCurrency } from "../../../../utils/number.formatter";
 export function ClassifiedDetailView({ product, isLoading = false, onContactSeller, }) {
@@ -31,5 +31,5 @@ export function ClassifiedDetailView({ product, isLoading = false, onContactSell
             setPending(false);
         }
     }
-    return (_jsx(Container, { children: _jsx(Section, { className: "py-8", children: _jsxs(Stack, { gap: "lg", children: [product.images.length > 0 && (_jsx(Div, { className: "overflow-hidden rounded-lg bg-muted", children: _jsx("img", { src: product.mainImage || product.images[0], alt: product.title, className: "h-80 w-full object-contain" }) })), _jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { className: "flex-wrap gap-2", children: [_jsx(Badge, { variant: "secondary", children: "Classified" }), meta?.negotiable && _jsx(Badge, { variant: "secondary", children: "Negotiable" }), meta?.acceptsShipping && _jsx(Badge, { variant: "secondary", children: "Shipping available" })] }), _jsx(Heading, { level: 1, className: "text-2xl font-bold", children: product.title }), _jsx(Text, { className: "text-2xl font-semibold text-primary", children: price }), location && (_jsx(Text, { className: "text-sm text-muted-foreground", children: location })), _jsx(Text, { className: "text-muted-foreground", children: product.description })] }), conversation ? (_jsxs(Div, { className: "rounded-lg border border-border bg-muted/40 p-4", children: [_jsx(Text, { className: "mb-2 font-medium", children: "Conversation started!" }), _jsx(Link, { href: ROUTES.USER.MESSAGES, className: "text-primary underline underline-offset-2", children: "Go to your messages \u2192" })] })) : (_jsxs(Stack, { gap: "sm", children: [error && (_jsx(Text, { className: "text-sm text-destructive", children: error })), _jsx("button", { type: "button", disabled: pending, onClick: handleContactSeller, className: "w-full rounded-lg bg-primary px-6 py-3 font-semibold text-primary-foreground transition hover:bg-primary/90 disabled:opacity-60", children: pending ? "Opening chat…" : "Contact Seller" })] }))] }) }) }));
+    return (_jsx(Container, { children: _jsx(Section, { className: "py-8", children: _jsxs(Stack, { gap: "lg", children: [product.images.length > 0 && (_jsx(Div, { className: "overflow-hidden rounded-lg bg-muted", children: _jsx("img", { src: product.mainImage || product.images[0], alt: product.title, className: "h-80 w-full object-contain" }) })), _jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { className: "flex-wrap gap-2", children: [_jsx(Badge, { variant: "secondary", children: "Classified" }), meta?.negotiable && _jsx(Badge, { variant: "secondary", children: "Negotiable" }), meta?.acceptsShipping && _jsx(Badge, { variant: "secondary", children: "Shipping available" })] }), _jsx(Heading, { level: 1, className: "text-2xl font-bold", children: product.title }), _jsx(Text, { className: "text-2xl font-semibold text-primary", children: price }), location && (_jsx(Text, { className: "text-sm text-muted-foreground", children: location })), _jsx(Text, { className: "text-muted-foreground", children: product.description })] }), conversation ? (_jsxs(Div, { className: "rounded-lg border border-border bg-muted/40 p-4", children: [_jsx(Text, { className: "mb-2 font-medium", children: "Conversation started!" }), _jsx(Link, { href: ROUTES.USER.MESSAGES, className: "text-primary underline underline-offset-2", children: "Go to your messages \u2192" })] })) : (_jsxs(Stack, { gap: "sm", children: [error && (_jsx(Text, { className: "text-sm text-destructive", children: error })), _jsx(Button, { type: "button", variant: "primary", size: "lg", isLoading: pending, disabled: pending, onClick: handleContactSeller, className: "w-full", children: "Contact Seller" })] }))] }) }) }));
 }

package/dist/_internal/client/features/digital-code/CodeRevealPanel.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from "react";
-import { Div, Stack, Text } from "../../../../ui";
+import { Button, Div, Span, Stack, Text } from "../../../../ui";
 export function CodeRevealPanel({ orderId, redemptionInstructions, fetchCode, }) {
     const [pending, setPending] = useState(false);
     const [revealed, setRevealed] = useState(null);
@@ -28,5 +28,5 @@ export function CodeRevealPanel({ orderId, redemptionInstructions, fetchCode, })
         setCopied(true);
         setTimeout(() => setCopied(false), 2000);
     }
-    return (_jsx(Div, { className: "rounded-lg border border-border bg-muted/40 p-4", children: _jsxs(Stack, { gap: "sm", children: [_jsx(Text, { className: "font-medium", children: "Your Digital Code" }), !revealed ? (_jsxs(Stack, { gap: "sm", children: [error && _jsx(Text, { className: "text-sm text-destructive", children: error }), _jsx("button", { type: "button", disabled: pending, onClick: handleReveal, className: "w-full rounded-lg bg-primary px-6 py-3 font-semibold text-primary-foreground transition hover:bg-primary/90 disabled:opacity-60", children: pending ? "Loading…" : "Reveal Code" })] })) : (_jsxs(Stack, { gap: "sm", children: [_jsxs(Div, { className: "flex items-center gap-2 rounded-md border border-border bg-background px-3 py-2 font-mono text-lg", children: [_jsx("span", { className: "flex-1 select-all", children: revealed.code }), _jsx("button", { type: "button", onClick: handleCopy, className: "shrink-0 text-xs text-muted-foreground hover:text-foreground", children: copied ? "Copied!" : "Copy" })] }), redemptionInstructions && (_jsx(Text, { className: "text-sm text-muted-foreground", children: redemptionInstructions }))] }))] }) }));
+    return (_jsx(Div, { className: "rounded-lg border border-border bg-muted/40 p-4", children: _jsxs(Stack, { gap: "sm", children: [_jsx(Text, { className: "font-medium", children: "Your Digital Code" }), !revealed ? (_jsxs(Stack, { gap: "sm", children: [error && _jsx(Text, { className: "text-sm text-destructive", children: error }), _jsx(Button, { type: "button", variant: "primary", size: "lg", isLoading: pending, disabled: pending, onClick: handleReveal, className: "w-full", children: "Reveal Code" })] })) : (_jsxs(Stack, { gap: "sm", children: [_jsxs(Div, { className: "flex items-center gap-2 rounded-md border border-border bg-background px-3 py-2 font-mono text-lg", children: [_jsx(Span, { className: "flex-1 select-all", children: revealed.code }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: handleCopy, className: "shrink-0", children: copied ? "Copied!" : "Copy" })] }), redemptionInstructions && (_jsx(Text, { className: "text-sm text-muted-foreground", children: redemptionInstructions }))] }))] }) }));
 }

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

@@ -91,5 +91,5 @@ export function DashboardLayoutClient({ variant, groups, permissions, activeHref
     const adminGroups = variant === "admin"
         ? filteredGroups
         : groups;
-    return (_jsxs(_Fragment, { children: [variant === "admin" && (_jsx(AdminSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, activePath: activeHref, groups: adminGroups, onCloseMobile: close, onToggle: toggle, className: className })), variant === "store" && (_jsx(StoreSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, activeHref: activeHref, items: [], groups: filteredGroups, onCloseMobile: close, onToggle: toggle, className: className })), variant === "user" && (_jsx(UserSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, items: filteredGroups.flatMap((g) => g.items), groups: filteredGroups, onCloseMobile: close, onToggle: toggle, className: className })), children] }));
+    return (_jsxs(_Fragment, { children: [variant === "admin" && (_jsx(AdminSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, activePath: activeHref, groups: adminGroups, onCloseMobile: close, onToggle: toggle, className: className })), variant === "store" && (_jsx(StoreSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, activeHref: activeHref, items: [], groups: filteredGroups, onCloseMobile: close, onToggle: toggle, className: className })), variant === "user" && (_jsx(UserSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, items: filteredGroups.flatMap((g) => g.items), groups: filteredGroups, onCloseMobile: close, onToggle: toggle, className: className })), _jsx("div", { className: "w-full px-4 py-6 md:pl-5 md:pr-6 lg:pr-8 min-h-[calc(100dvh-var(--header-height,3.5rem))]", children: children })] }));
 }

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

@@ -92,6 +92,45 @@ function emitOrderPlacedNotifications(args) {
         : Promise.resolve();
     void Promise.all([buyerNotif, sellerNotif]);
 }
+function accumulateCouponUsage(accumulator, couponCode, couponId, discountAmount) {
+    const entry = accumulator.get(couponCode) ?? {
+        couponId,
+        code: couponCode,
+        orderIds: [],
+        totalDiscount: 0,
+    };
+    entry.totalDiscount += discountAmount;
+    accumulator.set(couponCode, entry);
+}
+async function resolveShippingCost(storeId, groupTotal, commissions) {
+    if (!storeId)
+        return { shippingFee: 0, storeOwnerId: undefined };
+    const store = await storeRepository.findById(storeId);
+    const storeOwnerId = store?.ownerId;
+    if (!storeOwnerId)
+        return { shippingFee: 0, storeOwnerId: undefined };
+    const sellerUser = await userRepository.findById(storeOwnerId);
+    const shippingConfig = sellerUser?.shippingConfig;
+    if (!shippingConfig?.isConfigured)
+        return { shippingFee: 0, storeOwnerId };
+    if (shippingConfig.method === "custom") {
+        return { shippingFee: shippingConfig.customShippingPrice ?? 0, storeOwnerId };
+    }
+    if (shippingConfig.method === "shiprocket") {
+        const percentFee = groupTotal * (commissions.platformShippingPercent / 100);
+        return { shippingFee: Math.max(percentFee, commissions.platformShippingFixedMin), storeOwnerId };
+    }
+    return { shippingFee: 0, storeOwnerId };
+}
+function buildStockUpdatePayload(product, qtyDelta) {
+    const lt = (product.listingType ?? "standard");
+    const rule = getListingRule(lt);
+    return {
+        availableQuantity: product.availableQuantity - qtyDelta,
+        updatedAt: new Date(),
+        ...rule.stockDecrementExtras(product, qtyDelta),
+    };
+}
 /**
  * Place order(s) from the user's cart in a single Firestore transaction.
  *
@@ -239,13 +278,7 @@ export async function createCheckoutOrderAction(input) {
                     const product = productById.get(pid);
                     if (!product)
                         continue;
-                    const lt = (product.listingType ?? "standard");
-                    const rule = getListingRule(lt);
-                    const update = {
-                        availableQuantity: product.availableQuantity - qtyDelta,
-                        updatedAt: new Date(),
-                        ...rule.stockDecrementExtras(product, qtyDelta),
-                    };
+                    const update = buildStockUpdatePayload(product, qtyDelta);
                     tx.update(productRefById.get(pid), update);
                 }
             }
@@ -330,26 +363,7 @@ export async function createCheckoutOrderAction(input) {
             return itemRule.decorateOrderItem(baseLine, product);
         });
         const totalQuantity = group.reduce((sum, { item }) => sum + item.quantity, 0);
-        let shippingFee = 0;
-        let storeOwnerId;
-        const storeId = firstItem.storeId;
-        if (storeId) {
-            const store = await storeRepository.findById(storeId);
-            storeOwnerId = store?.ownerId;
-            if (storeOwnerId) {
-                const sellerUser = await userRepository.findById(storeOwnerId);
-                const shippingConfig = sellerUser?.shippingConfig;
-                if (shippingConfig?.isConfigured) {
-                    if (shippingConfig.method === "custom") {
-                        shippingFee = shippingConfig.customShippingPrice ?? 0;
-                    }
-                    else if (shippingConfig.method === "shiprocket") {
-                        const percentFee = groupTotal * (commissions.platformShippingPercent / 100);
-                        shippingFee = Math.max(percentFee, commissions.platformShippingFixedMin);
-                    }
-                }
-            }
-        }
+        const { shippingFee, storeOwnerId } = await resolveShippingCost(firstItem.storeId, groupTotal, commissions);
         const isCodLike = paymentMethod === "cod" || paymentMethod === "upi_manual";
         const depositAmount = isCodLike
             ? Math.round(groupTotal * (commissions.codDepositPercent / 100) * 100) / 100
@@ -395,14 +409,7 @@ export async function createCheckoutOrderAction(input) {
                     storeId: coupon.storeId,
                 });
                 if (coupon.couponId) {
-                    const entry = couponUsageAccumulator.get(coupon.code) ?? {
-                        couponId: coupon.couponId,
-                        code: coupon.code,
-                        orderIds: [],
-                        totalDiscount: 0,
-                    };
-                    entry.totalDiscount += couponGroupDiscount;
-                    couponUsageAccumulator.set(coupon.code, entry);
+                    accumulateCouponUsage(couponUsageAccumulator, coupon.code, coupon.couponId, couponGroupDiscount);
                     groupCouponCodes.add(coupon.code);
                 }
             }

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

@@ -0,0 +1,21 @@
+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;
+    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

@@ -0,0 +1,24 @@
+import { formatCurrency } from "../../../../utils/number.formatter";
+/** 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.category,
+        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/index.d.ts

@@ -1,2 +1,5 @@
 export * from "./data";
 export * from "./actions";
+export * from "./adapters";
+export * from "./metadata";
+export * from "./og";

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

@@ -1,2 +1,5 @@
 export * from "./data";
 export * from "./actions";
+export * from "./adapters";
+export * from "./metadata";
+export * from "./og";

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

@@ -0,0 +1,8 @@
+import type { Metadata } from "next";
+import type { ProductDocument } from "../../../../features/products/schemas/firestore";
+export interface ClassifiedMetadataOptions {
+    siteName?: string;
+    siteUrl?: string;
+    ogImageUrl?: string;
+}
+export declare function buildClassifiedMetadata(product: ProductDocument | null, opts?: ClassifiedMetadataOptions): Metadata;

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

@@ -0,0 +1,43 @@
+export function buildClassifiedMetadata(product, opts) {
+    const siteName = opts?.siteName?.trim() || "";
+    const suffix = siteName ? ` — ${siteName}` : "";
+    if (!product) {
+        return {
+            title: `Listing not found${suffix}`,
+            description: "This classified listing is unavailable or has been removed.",
+            robots: { index: false },
+        };
+    }
+    const location = product.classified?.meetupArea
+        ? [product.classified.meetupArea.locality, product.classified.meetupArea.city]
+            .filter(Boolean)
+            .join(", ")
+        : null;
+    const title = `${product.title}${suffix}`;
+    const description = product.seoDescription?.trim()
+        ? product.seoDescription.trim()
+        : location
+            ? `${product.description?.slice(0, 120) ?? ""} — Available in ${location}.`
+            : product.description?.slice(0, 160) ?? "";
+    const image = opts?.ogImageUrl ?? (product.mainImage || product.images?.[0] || null);
+    const siteUrl = opts?.siteUrl?.replace(/\/+$/, "");
+    const canonical = siteUrl ? `${siteUrl}/classified/${product.id}` : undefined;
+    return {
+        title,
+        description,
+        alternates: canonical ? { canonical } : undefined,
+        openGraph: {
+            title,
+            description,
+            url: canonical,
+            type: "website",
+            images: image ? [{ url: image }] : undefined,
+        },
+        twitter: {
+            card: image ? "summary_large_image" : "summary",
+            title,
+            description,
+            images: image ? [image] : undefined,
+        },
+    };
+}

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

@@ -0,0 +1,30 @@
+import type { ReactElement } from "react";
+import type { ProductDocument } from "../../../../features/products/schemas/firestore";
+export interface ClassifiedOgData {
+    title: string;
+    priceLabel?: string | null;
+    location?: string | null;
+    imageUrl?: string | null;
+}
+interface ClassifiedDocLike {
+    title?: string | null;
+    price?: number | null;
+    currency?: string | null;
+    mainImage?: string | null;
+    images?: (string | null | undefined)[] | null;
+    classified?: {
+        meetupArea?: {
+            city?: string;
+            locality?: string;
+        };
+    } | null;
+}
+export declare function renderClassifiedOg(doc: ClassifiedDocLike | null | undefined, opts: {
+    siteName: string;
+}): ReactElement;
+export declare function renderClassifiedOgImage(data: ClassifiedOgData, siteName: string): ReactElement;
+/** Type-safe overload that accepts the full ProductDocument. */
+export declare function renderClassifiedOgFromDoc(doc: ProductDocument | null | undefined, opts: {
+    siteName: string;
+}): ReactElement;
+export {};

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

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function renderClassifiedOg(doc, opts) {
+    const meta = doc?.classified;
+    const location = meta?.meetupArea
+        ? [meta.meetupArea.locality, meta.meetupArea.city].filter(Boolean).join(", ")
+        : null;
+    const priceLabel = doc?.price != null
+        ? new Intl.NumberFormat("en-IN", {
+            style: "currency",
+            currency: doc.currency ?? "INR",
+            maximumFractionDigits: 0,
+        }).format(doc.price / 100)
+        : null;
+    return renderClassifiedOgImage({
+        title: doc?.title ?? "Classified Listing",
+        priceLabel,
+        location,
+        imageUrl: doc?.mainImage || doc?.images?.[0] || null,
+    }, opts.siteName);
+}
+export function renderClassifiedOgImage(data, siteName) {
+    const { title, priceLabel, location, imageUrl } = data;
+    return (_jsxs("div", { style: {
+            display: "flex",
+            width: "100%",
+            height: "100%",
+            background: "#0f172a",
+            fontFamily: "sans-serif",
+            position: "relative",
+            overflow: "hidden",
+        }, children: [imageUrl && (_jsx("img", { src: imageUrl, alt: "", style: {
+                    position: "absolute",
+                    inset: 0,
+                    width: "100%",
+                    height: "100%",
+                    objectFit: "cover",
+                    opacity: 0.12,
+                } })), _jsx("div", { style: {
+                    position: "absolute",
+                    inset: 0,
+                    background: "linear-gradient(135deg, rgba(15,23,42,0.96) 0%, rgba(15,23,42,0.82) 100%)",
+                } }), _jsxs("div", { style: {
+                    position: "relative",
+                    display: "flex",
+                    width: "100%",
+                    height: "100%",
+                    padding: "60px",
+                    gap: "48px",
+                    alignItems: "center",
+                }, children: [imageUrl && (_jsx("img", { src: imageUrl, alt: title, style: {
+                            width: 400,
+                            height: 400,
+                            objectFit: "contain",
+                            borderRadius: 16,
+                            flexShrink: 0,
+                        } })), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 20, flex: 1 }, children: [_jsxs("div", { style: {
+                                    fontSize: 18,
+                                    color: "#38bdf8",
+                                    fontWeight: 600,
+                                    letterSpacing: 2,
+                                    textTransform: "uppercase",
+                                }, children: [siteName, " \u00B7 Classified"] }), _jsx("div", { style: {
+                                    fontSize: imageUrl ? 44 : 56,
+                                    fontWeight: 700,
+                                    color: "#f1f5f9",
+                                    lineHeight: 1.2,
+                                    display: "-webkit-box",
+                                    WebkitLineClamp: 3,
+                                    WebkitBoxOrient: "vertical",
+                                    overflow: "hidden",
+                                }, children: title }), priceLabel && (_jsx("div", { style: { fontSize: 32, fontWeight: 700, color: "#4ade80" }, children: priceLabel })), location && (_jsx("div", { style: { fontSize: 22, color: "#94a3b8" }, children: location }))] })] })] }));
+}
+/** Type-safe overload that accepts the full ProductDocument. */
+export function renderClassifiedOgFromDoc(doc, opts) {
+    return renderClassifiedOg(doc, opts);
+}

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

@@ -0,0 +1,21 @@
+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[];
+    /** 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

@@ -0,0 +1,29 @@
+import { formatCurrency } from "../../../../utils/number.formatter";
+/** 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.category,
+        tags: doc.tags ?? [],
+        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/index.d.ts

@@ -1 +1,4 @@
 export * from "./data";
+export * from "./adapters";
+export * from "./metadata";
+export * from "./og";

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

@@ -1 +1,4 @@
 export * from "./data";
+export * from "./adapters";
+export * from "./metadata";
+export * from "./og";

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

@@ -0,0 +1,8 @@
+import type { Metadata } from "next";
+import type { ProductDocument } from "../../../../features/products/schemas/firestore";
+export interface DigitalCodeMetadataOptions {
+    siteName?: string;
+    siteUrl?: string;
+    ogImageUrl?: string;
+}
+export declare function buildDigitalCodeMetadata(product: ProductDocument | null, opts?: DigitalCodeMetadataOptions): Metadata;

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

@@ -0,0 +1,36 @@
+export function buildDigitalCodeMetadata(product, opts) {
+    const siteName = opts?.siteName?.trim() || "";
+    const suffix = siteName ? ` — ${siteName}` : "";
+    if (!product) {
+        return {
+            title: `Digital code not found${suffix}`,
+            description: "This digital code listing is unavailable or has been removed.",
+            robots: { index: false },
+        };
+    }
+    const title = `${product.title}${suffix}`;
+    const description = product.seoDescription?.trim()
+        ? product.seoDescription.trim()
+        : product.description?.slice(0, 160) ?? "";
+    const image = opts?.ogImageUrl ?? (product.mainImage || product.images?.[0] || null);
+    const siteUrl = opts?.siteUrl?.replace(/\/+$/, "");
+    const canonical = siteUrl ? `${siteUrl}/digital-codes/${product.id}` : undefined;
+    return {
+        title,
+        description,
+        alternates: canonical ? { canonical } : undefined,
+        openGraph: {
+            title,
+            description,
+            url: canonical,
+            type: "website",
+            images: image ? [{ url: image }] : undefined,
+        },
+        twitter: {
+            card: image ? "summary_large_image" : "summary",
+            title,
+            description,
+            images: image ? [image] : undefined,
+        },
+    };
+}

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

@@ -0,0 +1,27 @@
+import type { ReactElement } from "react";
+import type { ProductDocument } from "../../../../features/products/schemas/firestore";
+export interface DigitalCodeOgData {
+    title: string;
+    priceLabel?: string | null;
+    deliveryMethod?: string | null;
+    imageUrl?: string | null;
+}
+interface DigitalCodeDocLike {
+    title?: string | null;
+    price?: number | null;
+    currency?: string | null;
+    mainImage?: string | null;
+    images?: (string | null | undefined)[] | null;
+    digitalCode?: {
+        codeDeliveryMethod?: string;
+    } | null;
+}
+export declare function renderDigitalCodeOg(doc: DigitalCodeDocLike | null | undefined, opts: {
+    siteName: string;
+}): ReactElement;
+export declare function renderDigitalCodeOgImage(data: DigitalCodeOgData, siteName: string): ReactElement;
+/** Type-safe overload that accepts the full ProductDocument. */
+export declare function renderDigitalCodeOgFromDoc(doc: ProductDocument | null | undefined, opts: {
+    siteName: string;
+}): ReactElement;
+export {};

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

@@ -0,0 +1,77 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function renderDigitalCodeOg(doc, opts) {
+    const priceLabel = doc?.price != null
+        ? new Intl.NumberFormat("en-IN", {
+            style: "currency",
+            currency: doc.currency ?? "INR",
+            maximumFractionDigits: 0,
+        }).format(doc.price / 100)
+        : null;
+    const deliveryMethod = doc?.digitalCode?.codeDeliveryMethod === "auto-claim"
+        ? "Instant delivery"
+        : doc?.digitalCode?.codeDeliveryMethod === "manual-email"
+            ? "Delivered via email"
+            : null;
+    return renderDigitalCodeOgImage({
+        title: doc?.title ?? "Digital Code",
+        priceLabel,
+        deliveryMethod,
+        imageUrl: doc?.mainImage || doc?.images?.[0] || null,
+    }, opts.siteName);
+}
+export function renderDigitalCodeOgImage(data, siteName) {
+    const { title, priceLabel, deliveryMethod, imageUrl } = data;
+    return (_jsxs("div", { style: {
+            display: "flex",
+            width: "100%",
+            height: "100%",
+            background: "#0c0a1e",
+            fontFamily: "sans-serif",
+            position: "relative",
+            overflow: "hidden",
+        }, children: [imageUrl && (_jsx("img", { src: imageUrl, alt: "", style: {
+                    position: "absolute",
+                    inset: 0,
+                    width: "100%",
+                    height: "100%",
+                    objectFit: "cover",
+                    opacity: 0.1,
+                } })), _jsx("div", { style: {
+                    position: "absolute",
+                    inset: 0,
+                    background: "linear-gradient(135deg, rgba(12,10,30,0.97) 0%, rgba(12,10,30,0.83) 100%)",
+                } }), _jsxs("div", { style: {
+                    position: "relative",
+                    display: "flex",
+                    width: "100%",
+                    height: "100%",
+                    padding: "60px",
+                    gap: "48px",
+                    alignItems: "center",
+                }, children: [imageUrl && (_jsx("img", { src: imageUrl, alt: title, style: {
+                            width: 400,
+                            height: 400,
+                            objectFit: "contain",
+                            borderRadius: 16,
+                            flexShrink: 0,
+                        } })), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 20, flex: 1 }, children: [_jsxs("div", { style: {
+                                    fontSize: 18,
+                                    color: "#a78bfa",
+                                    fontWeight: 600,
+                                    letterSpacing: 2,
+                                    textTransform: "uppercase",
+                                }, children: [siteName, " \u00B7 Digital Code"] }), _jsx("div", { style: {
+                                    fontSize: imageUrl ? 44 : 56,
+                                    fontWeight: 700,
+                                    color: "#f1f5f9",
+                                    lineHeight: 1.2,
+                                    display: "-webkit-box",
+                                    WebkitLineClamp: 3,
+                                    WebkitBoxOrient: "vertical",
+                                    overflow: "hidden",
+                                }, children: title }), priceLabel && (_jsx("div", { style: { fontSize: 32, fontWeight: 700, color: "#4ade80" }, children: priceLabel })), deliveryMethod && (_jsx("div", { style: { fontSize: 22, color: "#94a3b8" }, children: deliveryMethod }))] })] })] }));
+}
+/** Type-safe overload that accepts the full ProductDocument. */
+export function renderDigitalCodeOgFromDoc(doc, opts) {
+    return renderDigitalCodeOg(doc, opts);
+}

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

@@ -0,0 +1,21 @@
+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[];
+    /** 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;