@mohasinac/appkit 2.8.9 → 3.0.0

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

@@ -1,5 +1,212 @@
 export * from "./firestore";
 import { z } from "zod";
+export declare const blogPostStatusEnumSchema: z.ZodEnum<["draft", "published", "archived"]>;
+export declare const blogPostFirestoreSchema: z.ZodObject<{
+    createdAt: z.ZodUnion<[z.ZodDate, z.ZodString, z.ZodObject<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">>]>;
+    updatedAt: z.ZodUnion<[z.ZodDate, z.ZodString, z.ZodObject<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">>]>;
+    id: z.ZodString;
+    title: z.ZodString;
+    slug: z.ZodString;
+    excerpt: z.ZodString;
+    content: z.ZodString;
+    coverImage: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodEnum<["image", "video", "file"]>;
+        alt: z.ZodOptional<z.ZodString>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    }, {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    }>>;
+    contentImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodEnum<["image", "video", "file"]>;
+        alt: z.ZodOptional<z.ZodString>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    }, {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    }>, "many">>;
+    additionalImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodEnum<["image", "video", "file"]>;
+        alt: z.ZodOptional<z.ZodString>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    }, {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    }>, "many">>;
+    category: z.ZodString;
+    tags: z.ZodArray<z.ZodString, "many">;
+    isFeatured: z.ZodBoolean;
+    status: z.ZodEnum<["draft", "published", "archived"]>;
+    publishedAt: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodString, z.ZodObject<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">>]>>;
+    authorId: z.ZodString;
+    authorName: z.ZodString;
+    authorAvatar: z.ZodOptional<z.ZodString>;
+    readTimeMinutes: z.ZodNumber;
+    views: z.ZodNumber;
+    metaTitle: z.ZodOptional<z.ZodString>;
+    metaDescription: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "draft" | "published" | "archived";
+    category: string;
+    createdAt: string | Date | z.objectOutputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">;
+    id: string;
+    title: string;
+    slug: string;
+    tags: string[];
+    updatedAt: string | Date | z.objectOutputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">;
+    content: string;
+    isFeatured: boolean;
+    excerpt: string;
+    authorId: string;
+    authorName: string;
+    readTimeMinutes: number;
+    views: number;
+    publishedAt?: string | Date | z.objectOutputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    coverImage?: {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    } | undefined;
+    metaTitle?: string | undefined;
+    metaDescription?: string | undefined;
+    contentImages?: {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    }[] | undefined;
+    additionalImages?: {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    }[] | undefined;
+    authorAvatar?: string | undefined;
+}, {
+    status: "draft" | "published" | "archived";
+    category: string;
+    createdAt: string | Date | z.objectInputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">;
+    id: string;
+    title: string;
+    slug: string;
+    tags: string[];
+    updatedAt: string | Date | z.objectInputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">;
+    content: string;
+    isFeatured: boolean;
+    excerpt: string;
+    authorId: string;
+    authorName: string;
+    readTimeMinutes: number;
+    views: number;
+    publishedAt?: string | Date | z.objectInputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    coverImage?: {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    } | undefined;
+    metaTitle?: string | undefined;
+    metaDescription?: string | undefined;
+    contentImages?: {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    }[] | undefined;
+    additionalImages?: {
+        url: string;
+        type: "image" | "video" | "file";
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        source?: "upload" | "youtube" | "external" | undefined;
+        youtubeId?: string | undefined;
+    }[] | undefined;
+    authorAvatar?: string | undefined;
+}>;
+export type BlogPostFromSchema = z.infer<typeof blogPostFirestoreSchema>;
 export declare const blogPostCategorySchema: z.ZodEnum<["news", "tips", "guides", "updates", "community"]>;
 export declare const blogPostStatusSchema: z.ZodEnum<["draft", "published", "archived"]>;
 /**
@@ -165,9 +372,9 @@ export declare const blogPostSchema: z.ZodObject<{
     authorName?: string | undefined;
     readTimeMinutes?: number | undefined;
     views?: number | undefined;
-    authorAvatar?: string | undefined;
     metaTitle?: string | undefined;
     metaDescription?: string | undefined;
+    authorAvatar?: string | undefined;
 }, {
     status: "draft" | "published" | "archived";
     category: "news" | "tips" | "guides" | "updates" | "community";
@@ -193,6 +400,8 @@ export declare const blogPostSchema: z.ZodObject<{
     authorName?: string | undefined;
     readTimeMinutes?: number | undefined;
     views?: number | undefined;
+    metaTitle?: string | undefined;
+    metaDescription?: string | undefined;
     contentImages?: {
         url: string;
         type: "image" | "video" | "file";
@@ -210,8 +419,6 @@ export declare const blogPostSchema: z.ZodObject<{
         youtubeId?: string | undefined;
     }[] | undefined;
     authorAvatar?: string | undefined;
-    metaTitle?: string | undefined;
-    metaDescription?: string | undefined;
 }>;
 /** Base Zod schema for list-query parameters. */
 export declare const blogListParamsSchema: z.ZodObject<{

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

@@ -1,6 +1,33 @@
 export * from "./firestore";
 import { z } from "zod";
 import { mediaFieldSchema } from "../../media/types/index";
+import { auditTimestampsShape, firestoreDateSchema } from "../../../schemas/firestore-helpers";
+// ─── Firestore document schema (W2) ───────────────────────────────────────────
+// Mirrors BlogPostDocument in ./firestore.ts. Registered into SCHEMAS.firestore.blogPosts.
+export const blogPostStatusEnumSchema = z.enum(["draft", "published", "archived"]);
+export const blogPostFirestoreSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    slug: z.string(),
+    excerpt: z.string(),
+    content: z.string(),
+    coverImage: mediaFieldSchema.optional(),
+    contentImages: z.array(mediaFieldSchema).optional(),
+    additionalImages: z.array(mediaFieldSchema).optional(),
+    category: z.string(),
+    tags: z.array(z.string()),
+    isFeatured: z.boolean(),
+    status: blogPostStatusEnumSchema,
+    publishedAt: firestoreDateSchema.optional(),
+    authorId: z.string(),
+    authorName: z.string(),
+    authorAvatar: z.string().optional(),
+    readTimeMinutes: z.number().int().nonnegative(),
+    views: z.number().int().nonnegative(),
+    metaTitle: z.string().optional(),
+    metaDescription: z.string().optional(),
+    ...auditTimestampsShape,
+});
 const blogCoverImageSchema = z
     .union([
     mediaFieldSchema,

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

@@ -10,6 +10,7 @@
  */
 import { NextResponse } from "next/server.js";
 import { getProviders } from "../../../../contracts";
+import { normalizeError } from "../../../../errors/normalize";
 export async function PATCH(request, { params }) {
     try {
         const { id } = await params;
@@ -31,6 +32,7 @@ export async function PATCH(request, { params }) {
         });
     }
     catch (error) {
+        void normalizeError(error);
         return NextResponse.json({
             success: false,
             error: error instanceof Error ? error.message : "Internal server error",
@@ -54,6 +56,7 @@ export async function DELETE(request, { params }) {
         });
     }
     catch (error) {
+        void normalizeError(error);
         return NextResponse.json({
             success: false,
             error: error instanceof Error ? error.message : "Internal server error",

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

@@ -10,6 +10,7 @@
  */
 import { NextResponse } from "next/server.js";
 import { getProviders } from "../../../contracts";
+import { normalizeError } from "../../../errors/normalize";
 function numParam(url, key, fallback) {
     const v = url.searchParams.get(key);
     const n = v !== null ? Number(v) : NaN;
@@ -48,6 +49,7 @@ export async function GET(request) {
         });
     }
     catch (error) {
+        void normalizeError(error);
         return NextResponse.json({
             success: false,
             error: error instanceof Error ? error.message : "Internal server error",
@@ -71,6 +73,7 @@ export async function POST(request) {
         }, { status: 201 });
     }
     catch (error) {
+        void normalizeError(error);
         return NextResponse.json({
             success: false,
             error: error instanceof Error ? error.message : "Internal server error",

package/dist/features/cart/components/CartDrawer.js

@@ -1,7 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Aside, Button, Div, Heading, Row, Span, Text } from "../../../ui";
+import { Aside, Button, Div, Heading, Row, Span, Stack, Text } from "../../../ui";
 import { formatCurrency } from "../../../utils/number.formatter";
-import { THEME_CONSTANTS } from "../../../tokens";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
 const __P = {
     p4: "p-4",
@@ -10,17 +9,19 @@ const __O = {
     hidden: "overflow-hidden",
     yAuto: "overflow-y-auto",
 };
-const CLS_REMOVE_BTN = "self-start text-zinc-400 dark:text-zinc-400 transition hover:text-red-500";
+const CLS_REMOVE_BTN = "self-start text-zinc-400 dark:text-zinc-400 transition hover:text-error";
 export function CartItemRow({ item, onQtyChange, onRemove, href, isOutOfStock = false }) {
-    return (_jsxs(Div, { surface: "card", padding: "sm", className: `flex gap-4 transition-opacity ${isOutOfStock ? "opacity-60" : ""}`, children: [_jsx(Div, { className: `h-20 w-20 flex-shrink-0 ${__O.hidden} rounded-lg bg-neutral-100 dark:bg-slate-800`, children: item.meta.image && (_jsx(Div, { role: "img", "aria-label": item.meta.title, className: "h-full w-full bg-center bg-cover", 
+    return (_jsxs(Div, { layout: "flex", gap: "4", surface: "card", padding: "sm", className: `transition-opacity ${isOutOfStock ? "opacity-60" : ""}`, children: [_jsx(Div, { surface: "muted", className: `h-20 w-20 flex-shrink-0 ${__O.hidden}`, rounded: "lg", children: item.meta.image && (_jsx(Div, { role: "img", "aria-label": item.meta.title, className: "h-full w-full bg-center bg-cover", 
                     // audit-inline-style-ok: dynamic image URL
-                    style: { backgroundImage: `url(${item.meta.image})` } })) }), _jsxs(Div, { className: "flex flex-1 flex-col justify-between", children: [_jsxs(Div, { className: "flex items-start gap-1.5", children: [href ? (_jsx("a", { href: href, target: "_blank", rel: "noopener noreferrer", className: `font-medium text-neutral-900 dark:text-zinc-100 hover:underline underline-offset-2 ${THEME_CONSTANTS.utilities.textClamp2}`, children: item.meta.title })) : (_jsx(Text, { className: `font-medium text-neutral-900 dark:text-zinc-100 ${THEME_CONSTANTS.utilities.textClamp2}`, children: item.meta.title })), isOutOfStock && (_jsx(Span, { weight: "semibold", className: "flex-shrink-0 rounded bg-error-surface px-1.5 py-0.5 text-[10px] uppercase tracking-wide text-error", children: "Out of Stock" }))] }), item.meta.attributes &&
-                        Object.keys(item.meta.attributes).length > 0 && (_jsx(Text, { className: "text-xs text-neutral-500 dark:text-zinc-400", children: Object.entries(item.meta.attributes)
+                    style: { backgroundImage: `url(${item.meta.image})` } })) }), _jsxs(Stack, { justify: "between", className: "flex-1", children: [_jsxs(Row, { gap: "xs", className: "", align: "start", children: [href ? (_jsx("a", { href: href, target: "_blank", rel: "noopener noreferrer", className: "font-medium text-neutral-900 dark:text-zinc-100 hover:underline underline-offset-2 line-clamp-2", children: item.meta.title })) : (_jsx(Text, { truncate: 2, weight: "medium", color: "primary", children: item.meta.title })), isOutOfStock && (_jsx(Span, { padding: "pill-2xs", color: "error", surface: "danger-surface", weight: "semibold", className: "flex-shrink-0 text-[10px] tracking-wide", rounded: "default", transform: "uppercase", children: "Out of Stock" }))] }), item.meta.attributes &&
+                        Object.keys(item.meta.attributes).length > 0 && (_jsx(Text, { className: "text-neutral-500 dark:text-neutral-400", size: "xs", children: Object.entries(item.meta.attributes)
                             .map(([k, v]) => `${k}: ${v}`)
-                            .join(", ") })), _jsxs(Row, { justify: "between", children: [_jsx(Text, { className: "font-semibold text-neutral-900 dark:text-zinc-100", children: formatCurrency(item.meta.price * item.quantity, item.meta.currency) }), onQtyChange && !isOutOfStock && (_jsxs(Row, { className: "gap-2", children: [_jsx(Button, { onClick: () => onQtyChange(item.id, item.quantity - 1), disabled: item.quantity <= 1, variant: "outline", size: "sm", className: "flex h-7 w-7 items-center justify-center rounded-full border border-neutral-200 dark:border-slate-600 text-sm disabled:opacity-40", children: "\u2212" }), _jsx(Span, { size: "sm", className: "min-w-[1.5rem] text-center", children: item.quantity }), _jsx(Button, { onClick: () => onQtyChange(item.id, item.quantity + 1), variant: "outline", size: "sm", className: "flex h-7 w-7 items-center justify-center rounded-full border border-neutral-200 dark:border-slate-600 text-sm", children: "+" })] })), isOutOfStock && (_jsxs(Span, { size: "xs", className: "text-zinc-400 dark:text-zinc-400", children: ["Qty: ", item.quantity] }))] })] }), onRemove && (_jsx(Button, { onClick: () => onRemove(item.id), variant: "ghost", size: "sm", "aria-label": ACTIONS.CART["remove-item"].ariaLabel, className: CLS_REMOVE_BTN, children: "\u2715" }))] }));
+                            .join(", ") })), _jsxs(Row, { justify: "between", children: [_jsx(Text, { className: "text-neutral-900 dark:text-neutral-100", weight: "semibold", children: formatCurrency(item.meta.price * item.quantity, item.meta.currency) }), onQtyChange && !isOutOfStock && (_jsxs(Row, { gap: "sm", children: [_jsx(Button, { rounded: "full", onClick: () => onQtyChange(item.id, item.quantity - 1), disabled: item.quantity <= 1, variant: "outline", size: "sm", className: "h-7 w-7 justify-center border border-neutral-200 dark:border-slate-600 text-sm disabled:opacity-40", children: "\u2212" }), _jsx(Span, { size: "sm", className: "min-w-[1.5rem]", align: "center", children: item.quantity }), _jsx(Button, { rounded: "full", onClick: () => onQtyChange(item.id, item.quantity + 1), variant: "outline", size: "sm", className: "h-7 w-7 justify-center border border-neutral-200 dark:border-slate-600 text-sm", children: "+" })] })), isOutOfStock && (_jsxs(Span, { size: "xs", color: "muted", children: ["Qty: ", item.quantity] }))] })] }), onRemove && (_jsx(Button, { onClick: () => onRemove(item.id), variant: "ghost", size: "sm", "aria-label": ACTIONS.CART["remove-item"].ariaLabel, className: CLS_REMOVE_BTN, children: "\u2715" }))] }));
 }
 export function CartDrawer({ isOpen, onClose, items, subtotal = 0, currency, isLoading, onQtyChange, onRemove, onCheckout, labels = {}, }) {
     if (!isOpen)
         return null;
-    return (_jsxs(_Fragment, { children: [_jsx(Div, { role: "presentation", className: "fixed inset-0 z-40 bg-black/40", onClick: onClose }), _jsxs(Aside, { className: "fixed inset-y-0 right-0 z-50 flex w-full max-w-sm flex-col bg-white dark:bg-slate-900 shadow-xl", children: [_jsxs(Row, { justify: "between", className: `border-b border-neutral-200 dark:border-slate-700 ${__P.p4}`, children: [_jsx(Heading, { level: 2, className: "text-lg font-semibold", children: labels.title ?? "Cart" }), _jsx(Button, { onClick: onClose, variant: "ghost", size: "sm", "aria-label": "Close cart", className: "text-neutral-500 dark:text-zinc-400 hover:text-neutral-900 dark:hover:text-zinc-100", children: "\u2715" })] }), _jsx(Div, { className: `flex-1 ${__O.yAuto} ${__P.p4} space-y-3`, children: isLoading ? (_jsx(Div, { className: "flex justify-center py-12", children: _jsx(Div, { className: "h-8 w-8 animate-spin rounded-full border-2 border-neutral-300 dark:border-slate-600 border-t-neutral-800 dark:border-t-zinc-200" }) })) : items.length === 0 ? (_jsx(Text, { className: "py-12 text-center text-sm text-neutral-500 dark:text-zinc-400", children: labels.empty ?? "Your cart is empty" })) : (items.map((item) => (_jsx(CartItemRow, { item: item, onQtyChange: onQtyChange, onRemove: onRemove }, item.id)))) }), items.length > 0 && (_jsxs(Div, { className: `border-t border-neutral-200 dark:border-slate-700 ${__P.p4} space-y-4`, children: [_jsxs(Row, { justify: "between", className: "text-sm", children: [_jsx(Span, { className: "text-neutral-600 dark:text-zinc-300", children: labels.subtotal ?? "Subtotal" }), _jsx(Span, { weight: "semibold", children: formatCurrency(subtotal, currency) })] }), onCheckout && (_jsx(Button, { onClick: onCheckout, variant: "primary", className: "w-full rounded-xl bg-neutral-900 py-3 text-sm font-semibold text-white transition hover:bg-neutral-800", children: labels.checkout ?? ACTIONS.CART["checkout"].label }))] }))] })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(Div, { surface: "overlay-xs", role: "presentation", className: "fixed inset-0 z-40", onClick: onClose }), _jsxs(Aside, { className: "fixed inset-y-0 right-0 z-50 flex w-full max-w-sm flex-col bg-white dark:bg-slate-900 shadow-xl", children: [_jsxs(Row, { justify: "between", border: "bottom", className: __P.p4, children: [_jsx(Heading, { level: 2, size: "lg", weight: "semibold", children: labels.title ?? "Cart" }), _jsx(Button, { onClick: onClose, variant: "ghost", size: "sm", "aria-label": "Close cart", textColor: "faint", className: "hover:text-neutral-900 dark:hover:text-zinc-100", children: "\u2715" })] }), _jsx(Stack, { className: `flex-1 ${__O.yAuto} ${__P.p4}`, gap: "3", children: isLoading ? (_jsx(Row, { justify: "center", padding: "y-3xl", children: _jsx(Div, { className: "h-8 w-8 animate-spin border-2 border-neutral-300 border-t-neutral-800 dark:border-t-zinc-200", rounded: "full" }) })) : items.length === 0 ? (_jsx(Text, { paddingY: "3xl", className: "text-neutral-500 dark:text-neutral-400", size: "sm", align: "center", children: labels.empty ?? "Your cart is empty" })) : (items.map((item) => (_jsx(CartItemRow, { item: item, onQtyChange: onQtyChange, onRemove: onRemove }, item.id)))) }), items.length > 0 && (_jsxs(Stack, { border: "top", className: __P.p4, gap: "md", children: [_jsxs(Row, { textSize: "sm", justify: "between", children: [_jsx(Span, { className: "text-neutral-600 dark:text-neutral-400", children: labels.subtotal ?? "Subtotal" }), _jsx(Span, { weight: "semibold", children: formatCurrency(subtotal, currency) })] }), onCheckout && (
+                            // audit-variant-ok: checkout CTA — bespoke dark surface bg-neutral-900 + py-3 + font-semibold; Button.variant lacks dark/charcoal tone
+                            _jsx(Button, { rounded: "xl", onClick: onCheckout, variant: "primary", textSize: "sm", className: "w-full bg-neutral-900 py-3 font-semibold text-white transition hover:bg-neutral-800", children: labels.checkout ?? ACTIONS.CART["checkout"].label }))] }))] })] }));
 }

package/dist/features/cart/components/CartSummary.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Div, Heading } from "../../../ui";
+import { Heading, Stack } from "../../../ui";
 export function CartSummary({ renderBreakdown, renderTotal, renderCheckoutAction, renderPromoCode, renderContinueShopping, labels = {}, className = "", }) {
-    return (_jsxs(Div, { className: `space-y-4 ${className}`, children: [labels.title && (_jsx(Heading, { level: 2, className: "text-base font-bold", variant: "none", children: labels.title })), renderBreakdown?.(), renderPromoCode?.(), renderTotal?.(), renderCheckoutAction?.(), renderContinueShopping?.()] }));
+    return (_jsxs(Stack, { className: `${className}`, gap: "md", children: [labels.title && (_jsx(Heading, { level: 2, variant: "none", size: "base", weight: "bold", children: labels.title })), renderBreakdown?.(), renderPromoCode?.(), renderTotal?.(), renderCheckoutAction?.(), renderContinueShopping?.()] }));
 }

package/dist/features/cart/components/CartView.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import type { JsonArray } from "@mohasinac/appkit";
 /** Minimal shape of a per-store/per-type order group surfaced to the slot. */
 export interface CartOrderGroup {
     /** Unique key for this group (e.g. `${storeId}:${orderType}`). */
@@ -6,7 +7,7 @@ export interface CartOrderGroup {
     storeId: string;
     storeName: string;
     orderType: string;
-    items: unknown[];
+    items: JsonArray;
     subtotalInPaise: number;
     shippingFeeInPaise: number;
 }

package/dist/features/cart/components/CartView.js

@@ -1,8 +1,8 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Div, Heading } from "../../../ui";
+import { Div, Heading, Stack } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
 export function CartView({ labels = {}, renderItems, renderGroups, groups = [], renderSummary, renderPromoCode, renderCheckoutButton, renderEmpty, isEmpty = false, isLoading = false, className = "", }) {
     if (isEmpty && renderEmpty)
         return _jsx(_Fragment, { children: renderEmpty() });
-    return (_jsxs(Div, { className: className, children: [labels.title && (_jsx(Heading, { level: 1, className: "text-2xl font-bold mb-6", children: labels.title })), _jsxs(Div, { className: "flex flex-col gap-6 lg:flex-row lg:gap-8", children: [_jsxs(Div, { className: "flex-1", children: [renderGroups ? renderGroups(groups, isLoading) : renderItems(isLoading), !renderGroups && renderPromoCode?.(), renderGroups && renderPromoCode?.(), _jsx(AdSlot, { id: "cart-upsell", className: "mt-6" })] }), _jsxs(Div, { className: "w-full lg:w-80", children: [renderSummary?.(), renderCheckoutButton?.(() => { }, isLoading)] })] })] }));
+    return (_jsxs(Div, { className: className, children: [labels.title && (_jsx(Heading, { level: 1, className: "mb-6", size: "2xl", weight: "bold", children: labels.title })), _jsxs(Stack, { direction: "lg-row", className: "lg:gap-8", gap: "lg", children: [_jsxs(Div, { className: "flex-1", children: [renderGroups ? renderGroups(groups, isLoading) : renderItems(isLoading), !renderGroups && renderPromoCode?.(), renderGroups && renderPromoCode?.(), _jsx(AdSlot, { id: "cart-upsell", className: "mt-6" })] }), _jsxs(Div, { className: "w-full lg:w-80", children: [renderSummary?.(), renderCheckoutButton?.(() => { }, isLoading)] })] })] }));
 }

package/dist/features/cart/components/CheckoutAddressStep.js

@@ -1,8 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
-import { Div, Heading } from "../../../ui";
+import { Div, Heading, Stack } from "../../../ui";
 export function CheckoutAddressStep({ labels = {}, addresses, selectedAddressId, getAddressId, onSelectAddress, renderAddressCard, renderEmptyState, renderAddNew, className = "", }) {
-    return (_jsxs(Div, { className: className, children: [labels.title && (_jsx(Heading, { level: 2, className: "text-lg mb-4", children: labels.title })), addresses.length === 0 ? ((renderEmptyState?.() ?? null)) : (_jsx(Div, { className: "space-y-3", children: addresses.map((address) => {
+    return (_jsxs(Div, { className: className, children: [labels.title && (_jsx(Heading, { level: 2, className: "mb-4", size: "lg", children: labels.title })), addresses.length === 0 ? ((renderEmptyState?.() ?? null)) : (_jsx(Stack, { gap: "3", children: addresses.map((address) => {
                     const addressId = getAddressId(address);
                     const isSelected = addressId === selectedAddressId;
                     const select = () => onSelectAddress(addressId, address);

package/dist/features/cart/components/CheckoutView.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
-import { Div, Heading } from "../../../ui";
+import { Div, Heading, Stack } from "../../../ui";
 import { AdSlot } from "../../homepage/components/AdSlot";
 export function CheckoutView({ labels = {}, renderStep, renderStepIndicator, renderOrderSummary, totalSteps = 3, initialStep = 0, activeStep, onStepChange, className = "", }) {
     const [internalStep, setInternalStep] = React.useState(initialStep);
@@ -15,5 +15,5 @@ export function CheckoutView({ labels = {}, renderStep, renderStepIndicator, ren
         }
         onStepChange?.(nextStep);
     }, [activeStep, onStepChange, step]);
-    return (_jsxs(Div, { className: className, children: [labels.title && (_jsx(Heading, { level: 1, className: "text-2xl font-bold mb-6", children: labels.title })), renderStepIndicator?.(step, totalSteps, setStep), _jsxs(Div, { className: "flex flex-col gap-6 lg:flex-row lg:gap-8", children: [_jsxs(Div, { className: "flex-1", children: [renderStep(step, setStep), _jsx(AdSlot, { id: "checkout-upsell", className: "mt-6" })] }), renderOrderSummary && (_jsx(Div, { className: "w-full lg:w-80", children: renderOrderSummary() }))] })] }));
+    return (_jsxs(Div, { className: className, children: [labels.title && (_jsx(Heading, { level: 1, className: "mb-6", size: "2xl", weight: "bold", children: labels.title })), renderStepIndicator?.(step, totalSteps, setStep), _jsxs(Stack, { direction: "lg-row", className: "lg:gap-8", gap: "lg", children: [_jsxs(Div, { className: "flex-1", children: [renderStep(step, setStep), _jsx(AdSlot, { id: "checkout-upsell", className: "mt-6" })] }), renderOrderSummary && (_jsx(Div, { className: "w-full lg:w-80", children: renderOrderSummary() }))] })] }));
 }

package/dist/features/cart/components/ShippingPicker.js

@@ -43,6 +43,6 @@ export function ShippingPicker({ providers, selectedProviderId, subtotalInPaise
             const fee = resolveProviderFee(p, subtotalInPaise);
             const selected = p.providerId === selectedProviderId;
             const disabled = isLoading || pending;
-            return (_jsx(Button, { type: "button", variant: selected ? "primary" : "outline", size: "sm", disabled: disabled, onClick: () => handleSelect(p), "aria-checked": selected, role: "radio", className: "w-full justify-start text-left", children: _jsxs(Row, { gap: "sm", className: "w-full flex-wrap", align: "center", children: [_jsxs(Div, { className: "flex-1", children: [_jsx(Text, { size: "sm", weight: selected ? "semibold" : "normal", children: p.label }), _jsx(Text, { size: "xs", color: "muted", children: REFUND_COPY.shipping.etaFormat(p.etaDaysMin, p.etaDaysMax) })] }), _jsx(Text, { size: "sm", weight: "semibold", children: fee === 0 ? REFUND_COPY.shipping.freeLabel : formatCurrency(fee / 100, "INR") })] }) }, p.providerId));
+            return (_jsx(Button, { type: "button", variant: selected ? "primary" : "outline", size: "sm", disabled: disabled, onClick: () => handleSelect(p), "aria-checked": selected, role: "radio", className: "w-full justify-start text-left", children: _jsxs(Row, { gap: "sm", className: "w-full", wrap: true, align: "center", children: [_jsxs(Div, { className: "flex-1", children: [_jsx(Text, { size: "sm", weight: selected ? "semibold" : "normal", children: p.label }), _jsx(Text, { size: "xs", color: "muted", children: REFUND_COPY.shipping.etaFormat(p.etaDaysMin, p.etaDaysMax) })] }), _jsx(Text, { size: "sm", weight: "semibold", children: fee === 0 ? REFUND_COPY.shipping.freeLabel : formatCurrency(fee / 100, "INR") })] }) }, p.providerId));
         }) }));
 }

package/dist/features/cart/hooks/useAddToCart.d.ts

@@ -1,4 +1,5 @@
 import { type ApiClientError } from "../../../http";
+import type { JsonValue } from "@mohasinac/appkit";
 interface AddToCartPayload {
     productId: string;
     quantity: number;
@@ -7,7 +8,7 @@ interface AddToCartPayload {
     price?: number;
     storeId?: string;
     storeName?: string;
-    [key: string]: unknown;
+    [key: string]: JsonValue | undefined;
 }
 interface UseAddToCartOptions {
     endpoint?: string;

package/dist/features/cart/hooks/useAddToCart.js

@@ -1,4 +1,5 @@
 "use client";
+import { normalizeError } from "../../../errors/normalize";
 import { useCallback, useEffect, useRef } from "react";
 import { useMutation, useQueryClient } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
@@ -29,6 +30,7 @@ export function useAddToCart(options) {
             return await serverMutation.mutateAsync(data);
         }
         catch (err) {
+            void normalizeError(err);
             const apiErr = err;
             if (apiErr?.status === 401 || apiErr?.status === 403) {
                 addToGuestCart(data.productId, data.quantity, {

package/dist/features/cart/hooks/useCart.d.ts

@@ -12,6 +12,6 @@ export declare function useCart(userIdOrSession: string, opts?: UseCartOptions):
     itemCount: number;
     isLoading: boolean;
     error: Error | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<CartData, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<CartData>, Error>>;
 };
 export {};

package/dist/features/cart/hooks/useCartQuery.d.ts

@@ -1,8 +1,9 @@
+import type { FirestoreValue } from "@mohasinac/appkit";
 interface UseCartQueryOptions<TData> {
     endpoint: string;
-    queryKey?: unknown[];
+    queryKey?: readonly FirestoreValue[];
     enabled?: boolean;
     initialData?: TData;
 }
-export declare function useCartQuery<TData = unknown>(options: UseCartQueryOptions<TData>): import("@tanstack/react-query").UseQueryResult<import("@tanstack/query-core").NoInfer<TData>, Error>;
+export declare function useCartQuery<TData = unknown>(options: UseCartQueryOptions<TData>): import("@tanstack/react-query").UseQueryResult<NoInfer<TData>, Error>;
 export {};

package/dist/features/cart/hooks/useCheckoutReadQueries.d.ts

@@ -1,14 +1,15 @@
+import type { JsonArray } from "@mohasinac/appkit";
 interface UseCheckoutReadQueriesOptions<TAddress, TCart> {
     addressesEndpoint: string;
     cartEndpoint: string;
-    addressesQueryKey?: unknown[];
-    cartQueryKey?: unknown[];
+    addressesQueryKey?: JsonArray;
+    cartQueryKey?: JsonArray;
     enabled?: boolean;
     initialAddresses?: TAddress[];
     initialCart?: TCart;
 }
 export declare function useCheckoutReadQueries<TAddress = unknown, TCart = unknown>(options: UseCheckoutReadQueriesOptions<TAddress, TCart>): {
-    addressQuery: import("@tanstack/react-query").UseQueryResult<TAddress[], Error>;
-    cartQuery: import("@tanstack/react-query").UseQueryResult<import("@tanstack/query-core").NoInfer<TCart>, Error>;
+    addressQuery: import("@tanstack/react-query").UseQueryResult<NoInfer<TAddress[]>, Error>;
+    cartQuery: import("@tanstack/react-query").UseQueryResult<NoInfer<TCart>, Error>;
 };
 export {};

package/dist/features/cart/hooks/useOrder.d.ts

@@ -5,9 +5,9 @@ interface UseOrderOptions<TOrder> {
     initialData?: TOrder | null;
 }
 export declare function useOrder<TOrder = unknown>(orderId: string | null, options?: UseOrderOptions<TOrder>): {
-    order: NonNullable<import("@tanstack/query-core").NoInfer<TOrder | null>> | null;
+    order: NonNullable<NoInfer<TOrder | null>> | null;
     isLoading: boolean;
     error: Error | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("@tanstack/query-core").NoInfer<TOrder | null>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<TOrder | null>, Error>>;
 };
 export {};

package/dist/features/cart/repository/cart.repository.js

@@ -1,6 +1,7 @@
 import { randomUUID } from "crypto";
 import { DatabaseError, NotFoundError, ValidationError } from "../../../errors";
 import { CART_FIELDS } from "../../../constants/field-names";
+import { normalizeError } from "../../../errors/normalize";
 const ERR_CART_ITEM_NOT_FOUND = "Cart item not found";
 const ERR_CART_ITEM_LOCKED = "This item requires payment and cannot be removed or modified.";
 import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
@@ -24,6 +25,7 @@ export class CartRepository extends BaseRepository {
                     ? (decryptPii(item.storeName) ?? item.storeName)
                     : item.storeName,
             })),
+            // audit-unknown-ok: TS structural escape — generic param
         };
     }
     async findByUserId(userId) {
@@ -52,6 +54,7 @@ export class CartRepository extends BaseRepository {
             return cartData;
         }
         catch (error) {
+            void normalizeError(error);
             throw new DatabaseError("Failed to create cart", error);
         }
     }

package/dist/features/categories/api/[id]/route.d.ts

@@ -5,7 +5,7 @@
  * ```ts
  * // app/api/categories/[id]/route.ts
  * export { categoryItemGET as GET, categoryItemPATCH as PATCH, categoryItemDELETE as DELETE }
- *   from "@mohasinac/feat-categories";
+ * from "@mohasinac/feat-categories";
  * ```
  */
 import { NextResponse } from "next/server.js";

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

@@ -5,13 +5,14 @@
  * ```ts
  * // app/api/categories/[id]/route.ts
  * export { categoryItemGET as GET, categoryItemPATCH as PATCH, categoryItemDELETE as DELETE }
- *   from "@mohasinac/feat-categories";
+ * from "@mohasinac/feat-categories";
  * ```
  */
 import { NextResponse } from "next/server.js";
 import { z } from "zod";
 import { getProviders } from "../../../../contracts";
 import { createRouteHandler } from "../../../../next";
+import { normalizeError } from "../../../../errors/normalize";
 const ERR_CATEGORY_NOT_FOUND = "Category not found";
 // ---- GET /api/categories/[id] ------------------------------------------------
 export async function GET(_request, context) {
@@ -29,6 +30,7 @@ export async function GET(_request, context) {
         return NextResponse.json({ success: true, data: category });
     }
     catch (error) {
+        void normalizeError(error);
         console.error("[feat-categories] GET /api/categories/[id] failed", error);
         return NextResponse.json({ success: false, error: "Failed to fetch category" }, { status: 500 });
     }

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

@@ -16,6 +16,7 @@ import { NextResponse } from "next/server.js";
 import { z } from "zod";
 import { getProviders } from "../../../contracts";
 import { createRouteHandler } from "../../../next";
+import { normalizeError } from "../../../errors/normalize";
 const CACHE_CONTROL_PUBLIC = "public, max-age=3600, s-maxage=3600, stale-while-revalidate=86400";
 function buildTreeFromFlat(items, rootId) {
     const byId = new Map(items.map((i) => [i.id, i]));
@@ -157,6 +158,7 @@ export async function GET(request) {
         return res;
     }
     catch (error) {
+        void normalizeError(error);
         console.error("[feat-categories] GET /api/categories failed", error);
         return NextResponse.json({ success: false, error: "Failed to fetch categories" }, { status: 500 });
     }
@@ -195,6 +197,7 @@ export const POST = createRouteHandler({
             ...body,
             createdAt: now,
             updatedAt: now,
+            // audit-unknown-ok: TS structural escape — CategoryItem
         });
         return NextResponse.json({ success: true, data: created }, { status: 201 });
     },