@mohasinac/appkit 2.3.1 → 2.4.0

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

@@ -26,64 +26,86 @@ export declare const blogPostSchema: z.ZodObject<{
         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: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }, {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }>, z.ZodEffects<z.ZodString, {
         url: string;
         type: "image";
     }, string>]>>>, {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     } | {
         url: string;
         type: "image";
     } | null, string | {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     } | null | undefined>;
     contentImages: z.ZodDefault<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: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }, {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }>, "many">>>;
     additionalImages: z.ZodDefault<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: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }, {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }>, "many">>>;
     category: z.ZodEnum<["news", "tips", "guides", "updates", "community"]>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -107,8 +129,10 @@ export declare const blogPostSchema: z.ZodObject<{
     coverImage: {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     } | {
         url: string;
         type: "image";
@@ -116,30 +140,34 @@ export declare const blogPostSchema: z.ZodObject<{
     additionalImages: {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }[];
     slug: string;
     contentImages: {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }[];
     content?: string | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     tags?: string[] | undefined;
-    authorName?: string | undefined;
-    isFeatured?: boolean | undefined;
     publishedAt?: string | undefined;
-    views?: number | undefined;
+    isFeatured?: boolean | undefined;
+    authorName?: string | undefined;
     excerpt?: string | undefined;
+    metaTitle?: string | undefined;
+    metaDescription?: string | undefined;
+    views?: number | undefined;
     authorId?: string | undefined;
     authorAvatar?: string | undefined;
     readTimeMinutes?: number | undefined;
-    metaTitle?: string | undefined;
-    metaDescription?: string | undefined;
 }, {
     id: string;
     title: string;
@@ -152,32 +180,38 @@ export declare const blogPostSchema: z.ZodObject<{
     coverImage?: string | {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     } | null | undefined;
     additionalImages?: {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }[] | undefined;
     tags?: string[] | undefined;
-    authorName?: string | undefined;
-    isFeatured?: boolean | undefined;
     publishedAt?: string | undefined;
-    views?: number | undefined;
+    isFeatured?: boolean | undefined;
+    authorName?: string | undefined;
     excerpt?: string | undefined;
+    metaTitle?: string | undefined;
+    metaDescription?: string | undefined;
+    views?: number | undefined;
     contentImages?: {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }[] | undefined;
     authorId?: string | undefined;
     authorAvatar?: string | undefined;
     readTimeMinutes?: number | undefined;
-    metaTitle?: string | undefined;
-    metaDescription?: string | undefined;
 }>;
 /** Base Zod schema for list-query parameters. */
 export declare const blogListParamsSchema: z.ZodObject<{
@@ -191,16 +225,16 @@ export declare const blogListParamsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     sort?: string | undefined;
     q?: string | undefined;
-    page?: number | undefined;
     category?: "news" | "tips" | "guides" | "updates" | "community" | undefined;
+    page?: number | undefined;
     perPage?: number | undefined;
     tags?: string | undefined;
     featured?: boolean | undefined;
 }, {
     sort?: string | undefined;
     q?: string | undefined;
-    page?: number | undefined;
     category?: "news" | "tips" | "guides" | "updates" | "community" | undefined;
+    page?: number | undefined;
     perPage?: number | undefined;
     tags?: string | undefined;
     featured?: boolean | undefined;

package/dist/features/brands/actions/brand-actions.d.ts

@@ -0,0 +1,2 @@
+import type { BrandDocument } from "../schemas";
+export declare function getBrandBySlug(slug: string): Promise<BrandDocument | null>;

package/dist/features/brands/actions/brand-actions.js

@@ -0,0 +1,5 @@
+import { BrandsRepository } from "../repository/brands.repository";
+const brandsRepository = new BrandsRepository();
+export async function getBrandBySlug(slug) {
+    return brandsRepository.findBySlug(slug);
+}

package/dist/features/brands/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./schemas";
+export * from "./repository/brands.repository";
+export * from "./actions/brand-actions";

package/dist/features/brands/index.js

@@ -0,0 +1,3 @@
+export * from "./schemas";
+export * from "./repository/brands.repository";
+export * from "./actions/brand-actions";

package/dist/features/brands/repository/brands.repository.d.ts

@@ -0,0 +1,13 @@
+import { BaseRepository, type FirebaseSieveFields, type FirebaseSieveResult, type SieveModel } from "../../../providers/db-firebase";
+import { type BrandDocument, type BrandCreateInput, type BrandUpdateInput } from "../schemas";
+export declare class BrandsRepository extends BaseRepository<BrandDocument> {
+    constructor();
+    static readonly SIEVE_FIELDS: FirebaseSieveFields;
+    list(model: SieveModel): Promise<FirebaseSieveResult<BrandDocument>>;
+    findBySlug(slug: string): Promise<BrandDocument | null>;
+    findActive(): Promise<BrandDocument[]>;
+    create(input: BrandCreateInput): Promise<BrandDocument>;
+    update(id: string, input: BrandUpdateInput): Promise<BrandDocument>;
+    delete(id: string): Promise<void>;
+}
+export declare const brandsRepository: BrandsRepository;

package/dist/features/brands/repository/brands.repository.js

@@ -0,0 +1,60 @@
+import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BRANDS_COLLECTION, BRAND_FIELDS, } from "../schemas";
+import { serverLogger } from "../../../monitoring";
+export class BrandsRepository extends BaseRepository {
+    constructor() {
+        super(BRANDS_COLLECTION);
+    }
+    async list(model) {
+        return this.sieveQuery(model, BrandsRepository.SIEVE_FIELDS);
+    }
+    async findBySlug(slug) {
+        const snap = await this.getCollection()
+            .where(BRAND_FIELDS.SLUG, "==", slug)
+            .limit(1)
+            .get();
+        if (snap.empty)
+            return null;
+        return this.mapDoc(snap.docs[0]);
+    }
+    async findActive() {
+        const snap = await this.getCollection()
+            .where(BRAND_FIELDS.IS_ACTIVE, "==", true)
+            .orderBy(BRAND_FIELDS.DISPLAY_ORDER)
+            .get();
+        return snap.docs.map((d) => this.mapDoc(d));
+    }
+    async create(input) {
+        const now = new Date();
+        const ref = this.getCollection().doc(input.slug);
+        const data = prepareForFirestore({
+            ...input,
+            id: ref.id,
+            createdAt: now,
+            updatedAt: now,
+        });
+        await ref.set(data);
+        serverLogger.info("Brand created", { id: ref.id, name: input.name });
+        return { ...data, id: ref.id };
+    }
+    async update(id, input) {
+        const data = prepareForFirestore({ ...input, updatedAt: new Date() });
+        await this.getCollection().doc(id).update(data);
+        const updated = await this.findById(id);
+        if (!updated)
+            throw new Error(`Brand ${id} not found after update`);
+        return updated;
+    }
+    async delete(id) {
+        await this.getCollection().doc(id).delete();
+        serverLogger.info("Brand deleted", { id });
+    }
+}
+BrandsRepository.SIEVE_FIELDS = {
+    name: { canFilter: true, canSort: true },
+    slug: { canFilter: true, canSort: false },
+    isActive: { canFilter: true, canSort: false },
+    displayOrder: { canFilter: false, canSort: true },
+    createdAt: { canFilter: true, canSort: true },
+};
+export const brandsRepository = new BrandsRepository();

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

@@ -0,0 +1,33 @@
+export declare const BRANDS_COLLECTION: "brands";
+export interface BrandDocument {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    logoURL?: string;
+    bannerURL?: string;
+    website?: string;
+    country?: string;
+    founded?: number;
+    isActive: boolean;
+    displayOrder?: number;
+    productCount?: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export type BrandCreateInput = Omit<BrandDocument, "id" | "createdAt" | "updatedAt" | "productCount">;
+export type BrandUpdateInput = Partial<BrandCreateInput>;
+export declare const BRAND_FIELDS: {
+    readonly ID: "id";
+    readonly NAME: "name";
+    readonly SLUG: "slug";
+    readonly DESCRIPTION: "description";
+    readonly LOGO_URL: "logoURL";
+    readonly BANNER_URL: "bannerURL";
+    readonly WEBSITE: "website";
+    readonly IS_ACTIVE: "isActive";
+    readonly DISPLAY_ORDER: "displayOrder";
+    readonly PRODUCT_COUNT: "productCount";
+    readonly CREATED_AT: "createdAt";
+    readonly UPDATED_AT: "updatedAt";
+};

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

@@ -0,0 +1,15 @@
+export const BRANDS_COLLECTION = "brands";
+export const BRAND_FIELDS = {
+    ID: "id",
+    NAME: "name",
+    SLUG: "slug",
+    DESCRIPTION: "description",
+    LOGO_URL: "logoURL",
+    BANNER_URL: "bannerURL",
+    WEBSITE: "website",
+    IS_ACTIVE: "isActive",
+    DISPLAY_ORDER: "displayOrder",
+    PRODUCT_COUNT: "productCount",
+    CREATED_AT: "createdAt",
+    UPDATED_AT: "updatedAt",
+};

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

@@ -0,0 +1,7 @@
+/**
+ * @mohasinac/appkit/features/brands/server
+ *
+ * Server-only entry point — repositories and actions.
+ */
+export * from "./actions/brand-actions";
+export { BrandsRepository } from "./repository/brands.repository";

package/dist/features/brands/server.js

@@ -0,0 +1,7 @@
+/**
+ * @mohasinac/appkit/features/brands/server
+ *
+ * Server-only entry point — repositories and actions.
+ */
+export * from "./actions/brand-actions";
+export { BrandsRepository } from "./repository/brands.repository";

package/dist/features/cart/actions/cart-actions.js

@@ -37,8 +37,8 @@ export async function mergeGuestCart(userId, items) {
             price: product.price,
             currency: product.currency ?? getDefaultCurrency(),
             quantity: safeQty,
-            sellerId: product.sellerId,
-            sellerName: product.sellerName ?? "",
+            storeId: product.storeId,
+            storeName: product.storeName ?? "",
             isAuction: product.isAuction ?? false,
         });
     }

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

@@ -3,8 +3,12 @@ interface CartItemRowProps {
     item: CartItem;
     onQtyChange?: (id: string, qty: number) => void;
     onRemove?: (id: string) => void;
+    /** Product detail URL — if provided, title becomes a link */
+    href?: string;
+    /** When true: grays out item, shows "Out of Stock" badge, locks qty stepper */
+    isOutOfStock?: boolean;
 }
-export declare function CartItemRow({ item, onQtyChange, onRemove }: CartItemRowProps): import("react/jsx-runtime").JSX.Element;
+export declare function CartItemRow({ item, onQtyChange, onRemove, href, isOutOfStock }: CartItemRowProps): import("react/jsx-runtime").JSX.Element;
 interface CartDrawerProps {
     isOpen: boolean;
     onClose: () => void;

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

@@ -2,11 +2,11 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { Aside, Button, Div, Heading, Row, Span, Text } from "../../../ui";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { THEME_CONSTANTS } from "../../../tokens";
-export function CartItemRow({ item, onQtyChange, onRemove }) {
-    return (_jsxs(Div, { className: "flex gap-4 rounded-xl border border-neutral-200 dark:border-slate-700 bg-white dark:bg-slate-900 p-4", children: [_jsx(Div, { className: "h-20 w-20 flex-shrink-0 overflow-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", style: { backgroundImage: `url(${item.meta.image})` } })) }), _jsxs(Div, { className: "flex flex-1 flex-col justify-between", children: [_jsx(Text, { className: `font-medium text-neutral-900 dark:text-zinc-100 ${THEME_CONSTANTS.utilities.textClamp2}`, children: item.meta.title }), item.meta.attributes &&
+export function CartItemRow({ item, onQtyChange, onRemove, href, isOutOfStock = false }) {
+    return (_jsxs(Div, { className: `flex gap-4 rounded-xl border bg-white dark:bg-slate-900 p-4 transition-opacity ${isOutOfStock ? "border-neutral-200 dark:border-slate-700 opacity-60" : "border-neutral-200 dark:border-slate-700"}`, children: [_jsx(Div, { className: "h-20 w-20 flex-shrink-0 overflow-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", 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, { className: "flex-shrink-0 rounded bg-red-100 dark:bg-red-900/30 px-1.5 py-0.5 text-[10px] font-semibold uppercase tracking-wide text-[var(--appkit-color-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)
                             .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 && (_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, { className: "min-w-[1.5rem] text-center text-sm", 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: "+" })] }))] })] }), onRemove && (_jsx(Button, { onClick: () => onRemove(item.id), variant: "ghost", size: "sm", "aria-label": "Remove from cart", className: "self-start text-neutral-400 dark:text-zinc-500 transition hover:text-red-500", children: "\u2715" }))] }));
+                            .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, { className: "min-w-[1.5rem] text-center text-sm", 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, { className: "text-xs text-neutral-400 dark:text-zinc-500", children: ["Qty: ", item.quantity] }))] })] }), onRemove && (_jsx(Button, { onClick: () => onRemove(item.id), variant: "ghost", size: "sm", "aria-label": "Remove from cart", className: "self-start text-neutral-400 dark:text-zinc-500 transition hover:text-red-500", children: "\u2715" }))] }));
 }
 export function CartDrawer({ isOpen, onClose, items, subtotal = 0, currency, isLoading, onQtyChange, onRemove, onCheckout, labels = {}, }) {
     if (!isOpen)

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

@@ -2,6 +2,7 @@
  * useCartCount
  *
  * Returns a live cart count, preferring server cart data when available
- * and falling back to guest-cart storage.
+ * and falling back to guest-cart storage. Pass `enabled=true` only when
+ * a user session exists — prevents unauthenticated API calls sitewide.
  */
-export declare function useCartCount(): number;
+export declare function useCartCount(enabled?: boolean): number;

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

@@ -6,13 +6,15 @@ import { CART_ENDPOINTS } from "../../../constants/api-endpoints";
  * useCartCount
  *
  * Returns a live cart count, preferring server cart data when available
- * and falling back to guest-cart storage.
+ * and falling back to guest-cart storage. Pass `enabled=true` only when
+ * a user session exists — prevents unauthenticated API calls sitewide.
  */
-export function useCartCount() {
+export function useCartCount(enabled = false) {
     const { count: guestCount } = useGuestCart();
     const { data } = useQuery({
         queryKey: ["cart"],
         queryFn: () => apiClient.get(CART_ENDPOINTS.GET),
+        enabled,
     });
     return data?.itemCount ?? guestCount;
 }

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

@@ -30,7 +30,7 @@ export function useGuestCartMerge(options) {
         }
         const mergeFn = options.mergeFn ??
             (async (payload) => {
-                await apiClient.post(options.mergeEndpoint ?? CART_ENDPOINTS.MERGE, payload);
+                await apiClient.post(options.mergeEndpoint ?? CART_ENDPOINTS.MERGE, { items: payload });
             });
         mergeFn(items)
             .then(() => {

package/dist/features/cart/index.d.ts

@@ -11,4 +11,5 @@ export * from "./hooks/useAddToCart";
 export * from "./hooks/useGuestCartMerge";
 export * from "./components";
 export * from "./utils/guest-cart";
+export * from "./utils/pending-ops";
 export { manifest } from "./manifest";

package/dist/features/cart/index.js

@@ -11,4 +11,5 @@ export * from "./hooks/useAddToCart";
 export * from "./hooks/useGuestCartMerge";
 export * from "./components";
 export * from "./utils/guest-cart";
+export * from "./utils/pending-ops";
 export { manifest } from "./manifest";

package/dist/features/cart/repository/cart.repository.d.ts

@@ -1,7 +1,7 @@
 import type { DocumentReference } from "firebase-admin/firestore";
 import type { DocumentSnapshot } from "../../../providers/db-firebase";
 import { BaseRepository } from "../../../providers/db-firebase";
-import { type AddToCartInput, type CartDocument, type UpdateCartItemInput } from "../schemas";
+import { type AddToCartInput, type CartAppliedCoupon, type CartDocument, type UpdateCartItemInput } from "../schemas";
 export declare class CartRepository extends BaseRepository<CartDocument> {
     constructor();
     protected mapDoc<D = CartDocument>(snap: DocumentSnapshot): D;
@@ -14,6 +14,10 @@ export declare class CartRepository extends BaseRepository<CartDocument> {
     clearCart(userId: string): Promise<CartDocument>;
     getItemCount(cart: CartDocument): number;
     getSubtotal(cart: CartDocument): number;
+    addCoupon(userId: string, coupon: CartAppliedCoupon): Promise<void>;
+    removeCoupon(userId: string, code: string): Promise<void>;
+    clearAllCoupons(userId: string): Promise<void>;
+    setSelectedItems(userId: string, itemIds: string[] | null): Promise<void>;
     /**
      * Cloud Functions: return refs of stale carts not updated within TTL.
      */

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

@@ -13,9 +13,9 @@ export class CartRepository extends BaseRepository {
             ...raw,
             items: (raw.items ?? []).map((item) => ({
                 ...item,
-                sellerName: typeof item.sellerName === "string"
-                    ? (decryptPii(item.sellerName) ?? item.sellerName)
-                    : item.sellerName,
+                storeName: typeof item.storeName === "string"
+                    ? (decryptPii(item.storeName) ?? item.storeName)
+                    : item.storeName,
             })),
         };
     }
@@ -76,8 +76,8 @@ export class CartRepository extends BaseRepository {
                     price: input.price,
                     currency: input.currency,
                     quantity: input.quantity,
-                    sellerId: input.sellerId,
-                    sellerName: input.sellerName,
+                    storeId: input.storeId,
+                    storeName: input.storeName,
                     isAuction: input.isAuction ?? false,
                     isPreOrder: input.isPreOrder ?? false,
                     ...(input.isOffer !== undefined && { isOffer: input.isOffer }),
@@ -192,6 +192,37 @@ export class CartRepository extends BaseRepository {
     getSubtotal(cart) {
         return cart.items.reduce((sum, item) => sum + item.price * item.quantity, 0);
     }
+    async addCoupon(userId, coupon) {
+        const cart = await this.getOrCreate(userId);
+        const existing = cart.appliedCoupons ?? [];
+        // Replace if same code already applied (re-apply updates discount amount)
+        const filtered = existing.filter((c) => c.code !== coupon.code);
+        await this.db
+            .collection(this.collection)
+            .doc(userId)
+            .set({ appliedCoupons: [...filtered, coupon], updatedAt: new Date() }, { merge: true });
+    }
+    async removeCoupon(userId, code) {
+        const cart = await this.getOrCreate(userId);
+        const updated = (cart.appliedCoupons ?? []).filter((c) => c.code !== code);
+        await this.db
+            .collection(this.collection)
+            .doc(userId)
+            .set({ appliedCoupons: updated, updatedAt: new Date() }, { merge: true });
+    }
+    async clearAllCoupons(userId) {
+        await this.db
+            .collection(this.collection)
+            .doc(userId)
+            .set({ appliedCoupons: [], updatedAt: new Date() }, { merge: true });
+    }
+    async setSelectedItems(userId, itemIds) {
+        // null means "all items selected" — clears the field
+        await this.db
+            .collection(this.collection)
+            .doc(userId)
+            .set({ selectedItemIds: itemIds ?? null, updatedAt: new Date() }, { merge: true });
+    }
     /**
      * Cloud Functions: return refs of stale carts not updated within TTL.
      */

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

@@ -12,8 +12,9 @@ export interface CartItemDocument {
     price: number;
     currency: string;
     quantity: number;
-    sellerId: string;
-    sellerName: string;
+    /** Store slug (= storeId = store.id) used for order grouping and store link (/stores/[storeId]) */
+    storeId: string;
+    storeName: string;
     isAuction: boolean;
     isPreOrder: boolean;
     /** True when item was added from an accepted Make-an-Offer */
@@ -24,10 +25,27 @@ export interface CartItemDocument {
     addedAt: Date;
     updatedAt: Date;
 }
+export interface CartAppliedCoupon {
+    code: string;
+    discountAmount: number;
+    couponId?: string;
+    /** "admin" coupons apply across all stores; "seller" coupons apply to one store's items */
+    scope?: "admin" | "seller";
+    /** For seller-scoped coupons, the storeId whose items this applies to */
+    storeId?: string;
+    /** Item IDs (CartItemDocument.itemId) this coupon was calculated against */
+    applicableItemIds?: string[];
+    /** Mirrors CouponDocument.restrictions.combineWithSellerCoupons — used for conflict detection when adding future coupons */
+    combineWithSellerCoupons?: boolean;
+}
 export interface CartDocument {
     id: string;
     userId: string;
     items: CartItemDocument[];
+    /** Multiple coupons/deals applied at cart level */
+    appliedCoupons?: CartAppliedCoupon[];
+    /** Item IDs the user has selected for the next checkout (undefined = all items) */
+    selectedItemIds?: string[];
     createdAt: Date;
     updatedAt: Date;
 }
@@ -47,8 +65,8 @@ export declare const CART_FIELDS: {
         readonly PRICE: "price";
         readonly CURRENCY: "currency";
         readonly QUANTITY: "quantity";
-        readonly SELLER_ID: "sellerId";
-        readonly SELLER_NAME: "sellerName";
+        readonly STORE_ID: "storeId";
+        readonly STORE_NAME: "storeName";
         readonly IS_AUCTION: "isAuction";
         readonly IS_PRE_ORDER: "isPreOrder";
         readonly ADDED_AT: "addedAt";
@@ -64,8 +82,9 @@ export type AddToCartInput = {
     price: number;
     currency: string;
     quantity: number;
-    sellerId: string;
-    sellerName: string;
+    /** Store slug (= storeId = store.id) */
+    storeId: string;
+    storeName: string;
     isAuction?: boolean;
     isPreOrder?: boolean;
     isOffer?: boolean;

package/dist/features/cart/schemas/firestore.js

@@ -20,8 +20,8 @@ export const CART_FIELDS = {
         PRICE: "price",
         CURRENCY: "currency",
         QUANTITY: "quantity",
-        SELLER_ID: "sellerId",
-        SELLER_NAME: "sellerName",
+        STORE_ID: "storeId",
+        STORE_NAME: "storeName",
         IS_AUCTION: "isAuction",
         IS_PRE_ORDER: "isPreOrder",
         ADDED_AT: "addedAt",