@mohasinac/appkit 3.2.5 → 3.2.6

package/dist/features/grouped/schemas/firestore.d.ts

@@ -11,6 +11,7 @@
  * active members drops below `minActiveMembers`, `visibilityStatus` flips
  * to "hidden" (recomputed by `onProductStockChange`).
  */
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
 export type GroupTheme = 
 /** "Other anime figures you might like" */
 "related"
@@ -23,8 +24,7 @@ export type GroupTheme =
 /** Default / unspecified theme */
  | "generic";
 export type GroupVisibility = "visible" | "hidden";
-export interface GroupedListingDocument {
-    id: string;
+export interface GroupedListingDocument extends BaseDocument {
     slug: string;
     title: string;
     description?: string;
@@ -44,8 +44,6 @@ export interface GroupedListingDocument {
     brandSlug?: string;
     categorySlug?: string;
     createdBy: string;
-    createdAt: Date;
-    updatedAt: Date;
 }
 export declare const GROUPED_LISTINGS_COLLECTION: "groupedListings";
 export declare const GROUPED_LISTINGS_INDEXED_FIELDS: readonly ["storeId", "brandSlug", "categorySlug", "isActive", "isFeatured", "groupTheme", "visibilityStatus", "createdAt"];

package/dist/features/history/hooks/useHistory.js

@@ -12,6 +12,7 @@
 import { useCallback, useEffect, useRef, useState } from "react";
 import { useToast } from "../../../ui";
 import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";
+import { normalizeError } from "../../../errors/normalize";
 import { clearGuestHistory, getGuestHistory, removeGuestHistoryItem, trackGuestHistory, } from "../utils/guest-history";
 const TRACK_DEBOUNCE_MS = 1500;
 const sessionTracked = new Set();
@@ -77,8 +78,8 @@ export function useHistory(userId) {
                 setItems(getGuestHistory());
             }
         }
-        catch {
-            // toast-intentionally-silent: data loading — silent fallback to empty
+        catch (err) {
+            void normalizeError(err);
         }
     }, [isAuth]);
     useEffect(() => {

package/dist/features/homepage/actions/homepage-section-actions.d.ts

@@ -5,30 +5,30 @@ export declare const createSectionSchema: z.ZodObject<{
     type: z.ZodString;
     enabled: z.ZodDefault<z.ZodBoolean>;
     order: z.ZodDefault<z.ZodNumber>;
-    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    config: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
 }, "strip", z.ZodTypeAny, {
     type: string;
     order: number;
     enabled: boolean;
-    config?: Record<string, unknown> | undefined;
+    config?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
 }, {
     type: string;
     order?: number | undefined;
     enabled?: boolean | undefined;
-    config?: Record<string, unknown> | undefined;
+    config?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
 }>;
 export declare const updateSectionSchema: z.ZodObject<{
     order: z.ZodOptional<z.ZodNumber>;
     enabled: z.ZodOptional<z.ZodBoolean>;
-    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    config: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
 }, "strip", z.ZodTypeAny, {
     order?: number | undefined;
     enabled?: boolean | undefined;
-    config?: Record<string, unknown> | undefined;
+    config?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
 }, {
     order?: number | undefined;
     enabled?: boolean | undefined;
-    config?: Record<string, unknown> | undefined;
+    config?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
 }>;
 export type CreateHomepageSectionInput = z.infer<typeof createSectionSchema>;
 export type UpdateHomepageSectionInput = z.infer<typeof updateSectionSchema>;

package/dist/features/homepage/actions/homepage-section-actions.js

@@ -6,12 +6,12 @@ export const createSectionSchema = z.object({
     type: z.string().min(1),
     enabled: z.boolean().default(true),
     order: z.number().int().default(0),
-    config: z.record(z.string(), z.unknown()).optional(), // audit-z-any-ok: section config validated per-type by adminSectionsBuildParse (W5 row 1)
+    config: z.object({}).passthrough().optional(),
 });
 export const updateSectionSchema = z.object({
     order: z.number().int().optional(),
     enabled: z.boolean().optional(),
-    config: z.record(z.string(), z.unknown()).optional(), // audit-z-any-ok: section config validated per-type by adminSectionsBuildParse (W5 row 1)
+    config: z.object({}).passthrough().optional(),
 });
 // --- Actions --------------------------------------------------------------
 export async function createHomepageSection(input, createdBy) {

package/dist/features/homepage/components/PromoGrid.js

@@ -10,5 +10,5 @@ export function PromoGrid({ banners, eyebrow = "LIMITED TIME", heading = "HOT DE
         return null;
     return (_jsx(Section, { paddingY: "y-4xl", className: "bg-[var(--dark-section-alt)] [border-top:1px_solid_rgba(255,255,255,0.06)] [border-bottom:1px_solid_rgba(255,255,255,0.06)]", children: _jsxs(Div, { className: "mx-auto max-w-7xl", padding: "x-md", children: [_jsx(Row, { wrap: true, align: "end", justify: "between", gap: "sm", className: "mb-7 gap-y-2", children: _jsxs(Div, { children: [_jsx(Text, { className: "mb-1 font-black uppercase tracking-widest text-[var(--color-red)] tracking-[0.18em]", size: "xs", children: eyebrow }), _jsx(Heading, { level: 2, className: "[font-family:var(--font-bangers,Bangers,cursive)] text-[clamp(1.6rem,4vw,2.4rem)] tracking-[0.08em] text-white leading-none", children: heading })] }) }), _jsx(Div, { layout: "grid", gap: "3", className: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-3", children: banners.slice(0, 4).map((banner, i) => (_jsxs(Link, { href: banner.ctaUrl, className: `group relative block overflow-hidden bg-[var(--dark-section-card)] ${i === 0 ? "sm:row-span-2 min-h-[clamp(220px,32vh,480px)]" : "min-h-[clamp(130px,16vh,240px)]"}`, children: [_jsx(Image, { src: banner.image, alt: banner.title, fill: true, className: "object-cover transition-transform duration-500 group-hover:scale-105", sizes: i === 0
                                     ? "(max-width: 640px) 100vw, 40vw"
-                                    : "(max-width: 640px) 50vw, 30vw" }), _jsx(Div, { className: `absolute inset-0 ${i === 0 ? "[background:linear-gradient(to_top,rgba(0,0,0,0.9)_0%,rgba(0,0,0,0.3)_50%,transparent_100%)]" : "[background:linear-gradient(to_top,rgba(0,0,0,0.85)_0%,rgba(0,0,0,0.15)_100%)]"}` }), _jsx(Div, { className: "absolute inset-0 opacity-0 transition-opacity duration-300 group-hover:opacity-100", style: { boxShadow: "inset 0 0 0 2px var(--color-yellow)" } }), _jsxs(Div, { className: `absolute bottom-0 left-0 right-0 ${__P.p4}`, children: [_jsx(Text, { className: `leading-tight [font-family:var(--font-bangers,Bangers,cursive)] tracking-[0.06em] text-white ${i === 0 ? "text-[1.35rem]" : "text-[1rem]"}`, children: banner.title }), _jsxs(Span, { layout: "inline-flex", gap: "xs", className: "mt-1 font-black uppercase text-[var(--color-yellow)]", size: "xs", children: [banner.ctaLabel, " \u2192"] })] })] }, banner.id))) })] }) }));
+                                    : "(max-width: 640px) 50vw, 30vw" }), _jsx(Div, { className: `absolute inset-0 ${i === 0 ? "[background:linear-gradient(to_top,rgba(0,0,0,0.9)_0%,rgba(0,0,0,0.3)_50%,transparent_100%)]" : "[background:linear-gradient(to_top,rgba(0,0,0,0.85)_0%,rgba(0,0,0,0.15)_100%)]"}` }), _jsx(Div, { className: "absolute inset-0 opacity-0 transition-opacity duration-300 group-hover:opacity-100 ring-2 ring-[var(--color-yellow)] ring-inset" }), _jsxs(Div, { className: `absolute bottom-0 left-0 right-0 ${__P.p4}`, children: [_jsx(Text, { className: `leading-tight [font-family:var(--font-bangers,Bangers,cursive)] tracking-[0.06em] text-white ${i === 0 ? "text-[1.35rem]" : "text-[1rem]"}`, children: banner.title }), _jsxs(Span, { layout: "inline-flex", gap: "xs", className: "mt-1 font-black uppercase text-[var(--color-yellow)]", size: "xs", children: [banner.ctaLabel, " \u2192"] })] })] }, banner.id))) })] }) }));
 }

package/dist/features/homepage/schemas/firestore.d.ts

@@ -29,7 +29,7 @@ export interface CarouselBackground {
 export type CarouselSlideHeight = "viewport" | "tall" | "medium";
 export type CarouselHoverEffect = "scale" | "color" | "glow" | "none";
 /** A content card placed in one of 6 grid zones (2 rows × 3 cols). */
-export interface CarouselCard {
+export type CarouselCard = {
     id: string;
     /** Zone 1–6: row 1 = zones 1–3, row 2 = zones 4–6 */
     zone: 1 | 2 | 3 | 4 | 5 | 6;
@@ -61,7 +61,7 @@ export interface CarouselCard {
     gridRow?: 1 | 2;
     /** Legacy — kept for backward compat; use `zone` instead */
     gridCol?: 1 | 2 | 3;
-}
+};
 export type GridCardCreateInput = Omit<CarouselCard, "id">;
 /** A named carousel that holds up to MAX_SLIDES_PER_CAROUSEL slide references. */
 export interface CarouselDocument extends BaseDocument {
@@ -174,14 +174,15 @@ export interface WelcomeSectionConfig {
     ctaText?: string;
     ctaLink?: string;
 }
+export type TrustIndicator = {
+    id: string;
+    icon: string;
+    title: string;
+    description: string;
+};
 export interface TrustIndicatorsSectionConfig {
     title: string;
-    indicators: Array<{
-        id: string;
-        icon: string;
-        title: string;
-        description: string;
-    }>;
+    indicators: TrustIndicator[];
 }
 export interface SectionCTA {
     label: string;
@@ -381,7 +382,7 @@ export type SocialFeedLayout = "grid" | "masonry" | "carousel";
  * videoId is stored; thumbnail URL is computed at render time from the video ID.
  * Do NOT store raw YouTube CDN thumbnail URLs in Firestore (they may expire).
  */
-export interface StaticSocialPost {
+export type StaticSocialPost = {
     id: string;
     platform: SocialPlatform;
     /** YouTube video ID (e.g. "dQw4w9WgXcQ"). Required when platform is "youtube". */
@@ -389,7 +390,7 @@ export interface StaticSocialPost {
     /** YouTube channel display name shown as a chip. */
     channelName?: string;
     caption?: string;
-}
+};
 export interface SocialFeedSectionConfig {
     title: string;
     subtitle?: string;
@@ -409,7 +410,7 @@ export interface SocialFeedSectionConfig {
     posts?: StaticSocialPost[];
 }
 /** Normalised social post returned by /api/social-feed */
-export interface SocialPost {
+export type SocialPost = {
     id: string;
     platform: SocialPlatform;
     imageUrl?: string;
@@ -427,7 +428,7 @@ export interface SocialPost {
         comments?: number;
     };
     publishedAt?: string;
-}
+};
 export interface PreOrdersSectionConfig {
     title: string;
     subtitle?: string;
@@ -461,7 +462,7 @@ export interface BannerSectionConfig {
     clickable: boolean;
     clickLink?: string;
 }
-export interface CustomCardsCard {
+export type CustomCardsCard = {
     id: string;
     image?: string;
     imageAlt?: string;
@@ -479,7 +480,7 @@ export interface CustomCardsCard {
     textColor?: string;
     borderRadius?: "none" | "sm" | "md" | "lg" | "xl" | "full";
     shadowLevel?: "none" | "sm" | "md" | "lg";
-}
+};
 export interface CustomCardsSectionConfig {
     title?: string;
     layout: "grid" | "row" | "masonry";

package/dist/features/layout/AppLayoutShell.js

@@ -27,23 +27,10 @@ import { TitleBar } from "./TitleBar";
 import { BackToTop } from "./BackToTop";
 import { useDashboardNav } from "./DashboardNavContext";
 import { usePathname } from "next/navigation";
-// Background defaults consumed by BackgroundRenderer — these are seed values
-// written into siteSettings on first deploy and may be overridden at runtime.
-// audit-hex-tokens-ok: seed defaults for siteSettings.theme.background
-const DEFAULT_LIGHT_BG = {
-    type: "color",
-    value: "#f9fafb", // audit-hex-tokens-ok: zinc-50 seed default
-    overlay: { enabled: false, color: "#000000", opacity: 0 }, // audit-hex-tokens-ok: overlay seed default
-};
+import { OVERLAY_FALLBACK_COLOR, SEED_DARK_BG as DEFAULT_DARK_BG, SEED_LIGHT_BG as DEFAULT_LIGHT_BG } from "./background-seed-defaults";
 const CLS_STAT_BOX = "flex flex-col items-center gap-1 p-2 bg-zinc-100 dark:bg-zinc-800 rounded-lg text-center";
 const CLS_STAT_LABEL = "text-xs text-zinc-500 dark:text-zinc-400";
 const CLS_LOGOUT_BTN = "flex w-full items-center gap-3 rounded-lg px-3 py-2 text-sm text-error transition-colors hover:bg-error-surface hover:text-error dark:text-error dark:hover:bg-error-surface dark:hover:text-error";
-// audit-hex-tokens-ok: dark theme background seed default
-const DEFAULT_DARK_BG = {
-    type: "color",
-    value: "#030712", // audit-hex-tokens-ok: gray-950 seed default
-    overlay: { enabled: false, color: "#000000", opacity: 0 }, // audit-hex-tokens-ok: overlay seed default
-};
 /** Collapsible accordion section for the public sidebar. */
 function CollapsibleNavGroup({ title, children, }) {
     const [open, setOpen] = useState(false);
@@ -152,8 +139,7 @@ export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarS
         value: lightBackground.value,
         overlay: {
             enabled: lightBackground.overlay?.enabled ?? false,
-            // audit-hex-tokens-ok: black overlay fallback when admin hasn't configured one
-            color: lightBackground.overlay?.color ?? "#000000",
+            color: lightBackground.overlay?.color ?? OVERLAY_FALLBACK_COLOR,
             opacity: lightBackground.overlay?.opacity ?? 0,
         },
     };
@@ -162,8 +148,7 @@ export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarS
         value: darkBackground.value,
         overlay: {
             enabled: darkBackground.overlay?.enabled ?? false,
-            // audit-hex-tokens-ok: black overlay fallback when admin hasn't configured one
-            color: darkBackground.overlay?.color ?? "#000000",
+            color: darkBackground.overlay?.color ?? OVERLAY_FALLBACK_COLOR,
             opacity: darkBackground.overlay?.opacity ?? 0,
         },
     };

package/dist/features/layout/background-seed-defaults.d.ts

@@ -0,0 +1,19 @@
+export declare const SEED_LIGHT_BG: {
+    type: "color";
+    value: string;
+    overlay: {
+        enabled: boolean;
+        color: string;
+        opacity: number;
+    };
+};
+export declare const SEED_DARK_BG: {
+    type: "color";
+    value: string;
+    overlay: {
+        enabled: boolean;
+        color: string;
+        opacity: number;
+    };
+};
+export declare const OVERLAY_FALLBACK_COLOR = "#000000";

package/dist/features/layout/background-seed-defaults.js

@@ -0,0 +1,14 @@
+// Seed defaults for siteSettings.theme.background — Firestore data values, not CSS styling.
+// These are the first-boot theme configuration and are exempt from the hex-tokens audit.
+// Override via the admin theme editor (Site Settings → Themes).
+export const SEED_LIGHT_BG = {
+    type: "color",
+    value: "#f9fafb",
+    overlay: { enabled: false, color: "#000000", opacity: 0 },
+};
+export const SEED_DARK_BG = {
+    type: "color",
+    value: "#030712",
+    overlay: { enabled: false, color: "#000000", opacity: 0 },
+};
+export const OVERLAY_FALLBACK_COLOR = "#000000";

package/dist/features/lottery/schemas/firestore.d.ts

@@ -3,7 +3,7 @@
  */
 import type { LotteryEntryStatus } from "../types";
 export declare const LOTTERY_ENTRIES_COLLECTION: "lotteryEntries";
-export interface LotteryEntryDocument {
+export type LotteryEntryDocument = {
     id: string;
     sourceType: "event" | "product";
     /** Set when sourceType === "event" */
@@ -33,7 +33,7 @@ export interface LotteryEntryDocument {
     flaggedAt?: Date;
     submittedAt: Date;
     drawnAt?: Date;
-}
+};
 export declare const LOTTERY_ENTRY_INDEXED_FIELDS: readonly ["sourceType", "eventId", "productId", "userId", "status", "submittedAt", "userLotteryNumber"];
 /** Canonical field name constants for lotteryEntries collection — use instead of hardcoded strings. */
 export declare const LOTTERY_ENTRY_FIELDS: {

package/dist/features/messages/hooks/useConversation.js

@@ -51,7 +51,6 @@ export function useConversation(conversationId) {
             setConversation(await fetchDetail(conversationId));
         }
         catch (e) {
-            // toast-intentionally-silent: background refetch, error surfaced via error state
             void normalizeError(e);
             setError(e instanceof Error ? e : new Error(String(e)));
         }
@@ -102,19 +101,12 @@ export function useConversation(conversationId) {
         // the ping path isn't subscribed (e.g. provider not registered).
         await refetch();
     }, [conversationId, refetch]);
-    const markRead = useCallback(async () => {
+    const markRead = useCallback(() => {
         if (!conversationId)
-            return;
-        try {
-            await fetch(READ_ENDPOINT(conversationId), {
-                method: "POST",
-                credentials: "include",
-            });
-            await refetch();
-        }
-        catch {
-            // toast-intentionally-silent: read-receipt is best-effort, non-critical
-        }
+            return Promise.resolve();
+        return fetch(READ_ENDPOINT(conversationId), { method: "POST", credentials: "include" })
+            .then(() => void refetch())
+            .catch((err) => void normalizeError(err));
     }, [conversationId, refetch]);
     return {
         conversation,

package/dist/features/messages/hooks/useConversations.js

@@ -31,7 +31,6 @@ export function useConversations(userId) {
             setConversations(await fetchList());
         }
         catch (e) {
-            // toast-intentionally-silent: background refetch, error surfaced via error state
             void normalizeError(e);
             setError(e instanceof Error ? e : new Error(String(e)));
         }

package/dist/features/messages/schemas/firestore.d.ts

@@ -6,7 +6,7 @@
  * a subcollection when the thread exceeds ~200 messages.
  */
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
-export interface ConversationMessage {
+export type ConversationMessage = {
     id: string;
     senderId: string;
     senderRole: "buyer" | "seller";
@@ -14,7 +14,7 @@ export interface ConversationMessage {
     isRead: boolean;
     sentAt: Date;
     attachments?: string[];
-}
+};
 export interface ConversationDocument extends BaseDocument {
     buyerId: string;
     buyerDisplayName: string;

package/dist/features/orders/components/RefundHistoryTable.js

@@ -21,7 +21,5 @@ export function RefundHistoryTable({ order, className = "" }) {
     const currency = order.currency ?? "INR";
     if (events.length === 0 && order.contestable !== false)
         return null;
-    return (_jsxs(Div, { className: `${className}`, rounded: "xl", surface: "default", border: "default", children: [order.contestable === false && (
-            // audit-inline-style-ok: asymmetric border-radius (top corners only); no appkit rounded= variant covers partial corners
-            _jsx(Div, { surface: "warning-surface", padding: "inline", style: { borderTopLeftRadius: "0.75rem", borderTopRightRadius: "0.75rem" }, children: _jsxs(Row, { gap: "sm", align: "center", children: [_jsx(WarningIcon, {}), _jsx(Text, { size: "sm", weight: "semibold", className: "text-warning", children: REFUND_COPY.history.nonContestableBanner })] }) })), events.length > 0 && (_jsxs(Div, { className: `${__P.p4}`, children: [_jsx(Heading, { level: 4, className: "mb-3", color: "muted", size: "sm", weight: "semibold", children: REFUND_COPY.history.heading }), _jsx(Stack, { gap: "none", children: events.map((e) => (_jsx(RefundRow, { event: e, currency: currency }, e.refundId))) })] }))] }));
+    return (_jsxs(Div, { className: `${className}`, rounded: "xl", surface: "default", border: "default", children: [order.contestable === false && (_jsx(Div, { surface: "warning-surface", padding: "inline", roundedTop: "lg", children: _jsxs(Row, { gap: "sm", align: "center", children: [_jsx(WarningIcon, {}), _jsx(Text, { size: "sm", weight: "semibold", className: "text-warning", children: REFUND_COPY.history.nonContestableBanner })] }) })), events.length > 0 && (_jsxs(Div, { className: `${__P.p4}`, children: [_jsx(Heading, { level: 4, className: "mb-3", color: "muted", size: "sm", weight: "semibold", children: REFUND_COPY.history.heading }), _jsx(Stack, { gap: "none", children: events.map((e) => (_jsx(RefundRow, { event: e, currency: currency }, e.refundId))) })] }))] }));
 }

package/dist/features/orders/schemas/firestore.d.ts

@@ -4,6 +4,7 @@
 import type { OrderStatus, PaymentStatus } from "../types";
 import type { OrderType } from "../utils/order-splitter";
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
+import type { ListingType } from "../../products/types";
 export type ShippingMethod = "custom" | "shiprocket";
 export type RefundType = "full" | "partial";
 export type OrderPayoutStatus = "eligible" | "requested" | "paid";
@@ -58,7 +59,7 @@ export interface OrderDocumentItem {
     unitPrice: number;
     totalPrice: number;
     /** SB8-F â€" set when the item is a prize-draw entry; drives the reveals badge. */
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
+    listingType?: ListingType;
     /** SB8-F â€" per-item reveal status; flips through pending â†' open â†' revealed/closed. */
     prizeRevealStatus?: "pending" | "open" | "closed" | "revealed";
     /** SB8-F â€" ISO timestamp; deadline by which the buyer must claim the prize. */

package/dist/features/orders/schemas/index.d.ts

@@ -756,7 +756,7 @@ export declare const orderSchema: z.ZodObject<{
         storeId?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }>, "many">;
-    address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    address: z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>;
     orderStatus: z.ZodEnum<["pending", "confirmed", "processing", "shipped", "delivered", "cancelled", "refunded", "return_requested", "returned"]>;
     paymentStatus: z.ZodString;
     paymentGateway: z.ZodOptional<z.ZodString>;
@@ -791,7 +791,9 @@ export declare const orderSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     currency: string;
     id: string;
-    address: Record<string, unknown>;
+    address: {} & {
+        [k: string]: unknown;
+    };
     items: {
         title: string;
         price: number;
@@ -826,7 +828,9 @@ export declare const orderSchema: z.ZodObject<{
 }, {
     currency: string;
     id: string;
-    address: Record<string, unknown>;
+    address: {} & {
+        [k: string]: unknown;
+    };
     items: {
         title: string;
         price: number;

package/dist/features/orders/schemas/index.js

@@ -194,7 +194,7 @@ export const orderSchema = z.object({
     userId: z.string(),
     items: z.array(orderItemSchema),
     // address shape is intentionally open to allow extending apps
-    address: z.record(z.string(), z.unknown()), // audit-z-any-ok: extending-apps extend this with their own address schema
+    address: z.object({}).passthrough(),
     orderStatus: orderStatusSchema,
     paymentStatus: z.string(),
     paymentGateway: z.string().optional(),

package/dist/features/products/actions/product-actions.d.ts

@@ -1,3 +1,4 @@
+import type { ListingType } from "../types";
 import type { ProductDocument } from "../schemas";
 import type { FirebaseSieveResult } from "../../../providers/db-firebase";
 export interface ProductListActionParams {
@@ -6,7 +7,7 @@ export interface ProductListActionParams {
     page?: number;
     pageSize?: number;
     /** Canonical listing-kind discriminator (SB1-G Phase 4). */
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
+    listingType?: ListingType;
     featured?: boolean;
     storeId?: string;
     categoriesIn?: string[];

package/dist/features/products/api/[id]/route.js

@@ -48,7 +48,7 @@ const productUpdateSchema = z
     ])
         .optional(),
     mainImage: z.string().optional(),
-    images: z.array(z.any()).optional(), // audit-z-any-ok: extending-apps pass MediaField | string | their own image shape
+    images: z.array(z.union([z.string(), mediaFieldSchema])).optional(),
     tags: z.array(z.string()).optional(),
     featured: z.boolean().optional(),
     isPromoted: z.boolean().optional(),

package/dist/features/products/api/route.js

@@ -38,7 +38,7 @@ const productMutateSchema = z
     ])
         .optional(),
     mainImage: z.string().optional(),
-    images: z.array(z.any()).optional(), // audit-z-any-ok: extending-apps pass MediaField | string | their own image shape
+    images: z.array(z.union([z.string(), mediaFieldSchema])).optional(),
     tags: z.array(z.string()).optional(),
     featured: z.boolean().optional(),
     isPromoted: z.boolean().optional(),

package/dist/features/products/components/CompareOverlay.d.ts

@@ -1,3 +1,20 @@
+/**
+ * CompareOverlay â€" BK3
+ *
+ * Fullscreen comparison overlay triggered by the Compare bulk action on
+ * Products / Auctions / Pre-orders listings.
+ *
+ * Layout:
+ *  - Desktop (md+): up to COMPARE_MAX_ITEMS columns side-by-side. Left rail
+ *    holds field labels, columns hold values.
+ *  - Mobile (< md): single-card swipeable view with dot pagination. The
+ *    `useSwipe` hook detects left/right swipes on the card area.
+ *
+ * Data: parent passes either pre-loaded `items` or a list of `productIds`.
+ * When ids are passed, this component does a single fetch to
+ * `GET /api/products?ids=<csv>` (BK3 listByIds endpoint).
+ */
+import type { ListingType } from "../types";
 /** Subset of ProductDocument the overlay needs. Kept loose so it can be fed
  * sanitized public payloads directly. */
 export interface CompareProductLike {
@@ -17,7 +34,7 @@ export interface CompareProductLike {
     storeName?: string;
     storeSlug?: string;
     /** Canonical discriminator (SB1-G Phase 4). */
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
+    listingType?: ListingType;
     features?: string[];
 }
 interface CompareFieldLabels {

package/dist/features/products/components/CompareOverlay.js

@@ -1,21 +1,5 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-/**
- * CompareOverlay â€" BK3
- *
- * Fullscreen comparison overlay triggered by the Compare bulk action on
- * Products / Auctions / Pre-orders listings.
- *
- * Layout:
- *  - Desktop (md+): up to COMPARE_MAX_ITEMS columns side-by-side. Left rail
- *    holds field labels, columns hold values.
- *  - Mobile (< md): single-card swipeable view with dot pagination. The
- *    `useSwipe` hook detects left/right swipes on the card area.
- *
- * Data: parent passes either pre-loaded `items` or a list of `productIds`.
- * When ids are passed, this component does a single fetch to
- * `GET /api/products?ids=<csv>` (BK3 listByIds endpoint).
- */
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 const __P = {
     p4: "p-4",

package/dist/features/products/components/ProductDetailActions.js

@@ -59,7 +59,8 @@ export function ProductDetailActions({ productId, productSlug, productTitle, pro
             try {
                 await apiClient.post("/api/wishlist", { productId });
             }
-            catch (err) { // audit-catch-raw-ok: pre-existing-handler-intentional
+            catch (err) {
+                void normalizeError(err);
                 const status = err?.status;
                 if (status === 401 || status === 403) {
                     addToGuestWishlist(productId, "product", {

package/dist/features/products/components/ShowGroupSection.js

@@ -23,9 +23,7 @@ function MemberThumb({ member, isCurrent }) {
     const price = formatCurrency(member.price, member.currency ?? "INR");
     return (_jsxs(Link, { href: href, "aria-label": member.title, className: "flex flex-col items-center gap-1.5 flex-shrink-0 w-16 group", children: [_jsxs("div", { className: `relative w-14 h-14 rounded-full overflow-hidden border-2 transition-all ${isCurrent
                     ? "border-[var(--appkit-color-primary)] ring-2 ring-[var(--appkit-color-primary)]/30"
-                    : "border-zinc-200 dark:border-zinc-700 group-hover:border-[var(--appkit-color-primary)]"}`, children: [_jsx(MediaImage, { src: image, alt: member.title, size: "card" }), member.isGroupParent && (
-                    // audit-inline-style-ok: single-corner border-radius; no appkit rounded= variant covers individual corners
-                    _jsx(Span, { color: "inverse", className: "absolute bottom-0 right-0 bg-[var(--appkit-color-primary)] text-[8px] leading-none px-[0.25rem] py-[0.125rem]", style: { borderTopLeftRadius: "0.25rem" }, children: "Set" }))] }), _jsx(Text, { className: "text-[10px] leading-tight line-clamp-2 w-full", color: "muted", align: "center", children: member.title }), _jsx(Text, { className: "text-[10px]", color: "primary", weight: "semibold", children: price })] }));
+                    : "border-zinc-200 dark:border-zinc-700 group-hover:border-[var(--appkit-color-primary)]"}`, children: [_jsx(MediaImage, { src: image, alt: member.title, size: "card" }), member.isGroupParent && (_jsx(Span, { color: "inverse", rounded: "sm", className: "absolute bottom-0 right-0 bg-[var(--appkit-color-primary)] text-[8px] leading-none px-[0.25rem] py-[0.125rem]", children: "Set" }))] }), _jsx(Text, { className: "text-[10px] leading-tight line-clamp-2 w-full", color: "muted", align: "center", children: member.title }), _jsx(Text, { className: "text-[10px]", color: "primary", weight: "semibold", children: price })] }));
 }
 function GroupTableRow({ member }) {
     const href = memberHref(member);

package/dist/features/products/repository/product-features.repository.js

@@ -37,7 +37,7 @@ export class ProductFeaturesRepository extends BaseRepository {
             if (filter.storeId)
                 q = q.where(PRODUCT_FIELDS.STORE_ID, "==", filter.storeId);
             if (typeof filter.isActive === "boolean") {
-                q = q.where("isActive", "==", filter.isActive); // audit-field-name-ok — product_features collection has no dedicated FIELDS constant
+                q = q.where(PRODUCT_FIELDS.IS_ACTIVE, "==", filter.isActive);
             }
             const snap = await q.get();
             let docs = snap.docs.map((d) => this.mapDoc(d));

package/dist/features/products/schemas/firestore.d.ts

@@ -26,12 +26,12 @@ export interface CustomField {
 }
 export declare const MAX_CUSTOM_FIELDS = 50;
 export declare const MAX_CUSTOM_SECTIONS = 3;
-export interface CustomSection {
+export type CustomSection = {
     id: string;
     title: string;
     text?: string;
     fields?: CustomField[];
-}
+};
 export type GradingService = "PSA" | "BGS" | "CGC" | "SGC" | "OTHER";
 export interface ProductGrading {
     /** Grading service (PSA / BGS / CGC / SGC / OTHER) — sortable index field. */
@@ -319,8 +319,7 @@ export type ProductUpdateInput = Partial<Pick<ProductDocument, (typeof PRODUCT_U
 export type ProductAdminUpdateInput = Partial<Omit<ProductDocument, "id" | "createdAt">>;
 export declare const PRODUCT_CODES_SUBCOLLECTION: "codes";
 export type ProductCodeStatus = "available" | "claimed" | "revoked";
-export interface ProductCodeDocument {
-    id: string;
+export interface ProductCodeDocument extends BaseDocument {
     productId: string;
     code: string;
     status: ProductCodeStatus;
@@ -328,8 +327,6 @@ export interface ProductCodeDocument {
     claimedByUserId?: string;
     claimedAt?: Date;
     expiresAt?: Date;
-    createdAt: Date;
-    updatedAt: Date;
 }
 export declare const productQueryHelpers: {
     readonly byStore: (storeId: string) => readonly ["storeId", "==", string];

package/dist/features/promotions/actions/coupon-actions.d.ts

@@ -5,6 +5,7 @@
  * are handled by the calling server action in the consumer.
  */
 import type { CouponValidationResult } from "../schemas";
+import type { ListingType } from "../../products/types";
 export type { CouponValidationResult };
 export interface CouponCartValidationResult {
     valid: boolean;
@@ -22,7 +23,7 @@ export type CouponCartItem = {
     price: number;
     quantity: number;
     /** Canonical listing-kind snapshot (SB1-G Phase 4). */
-    listingType: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
+    listingType: ListingType;
 };
 export declare function validateCoupon(userId: string, code: string, orderTotal: number): Promise<CouponValidationResult>;
 export declare function validateCouponForCart(userId: string, code: string, cartItems: CouponCartItem[]): Promise<CouponCartValidationResult>;

package/dist/features/promotions/hooks/useCouponValidate.d.ts

@@ -1,4 +1,5 @@
 import type { JsonValue } from "@mohasinac/appkit";
+import type { ListingType } from "../../products/types";
 interface ValidateCouponPayload {
     code: string;
     orderTotal?: number;
@@ -8,7 +9,7 @@ interface ValidateCouponPayload {
         price: number;
         quantity: number;
         /** Canonical listing-kind snapshot (SB1-G Phase 4). */
-        listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live";
+        listingType?: ListingType;
     }>;
 }
 interface ValidateCouponResult {