@mohasinac/appkit 2.3.2 → 2.4.0

package/dist/features/media/upload/MediaUploadField.js

@@ -31,13 +31,63 @@ function filenameFromUrl(url) {
         return url;
     }
 }
-export function MediaUploadField({ label, value, onChange, onChangeField, onUpload, accept = "*", maxSizeMB = 50, disabled = false, helperText, captureSource = "file-only", captureMode = "photo", enableTrim = true, enableThumbnail = true, onThumbnailChange, onAbort, onStagedUrlsChange, isPersisted = false, }) {
+function extractYouTubeId(input) {
+    const trimmed = input.trim();
+    // Already just an ID (11 chars, alphanumeric + _ -)
+    if (/^[\w-]{11}$/.test(trimmed))
+        return trimmed;
+    try {
+        const url = new URL(trimmed);
+        return (url.searchParams.get("v") ||
+            (url.hostname === "youtu.be" ? url.pathname.slice(1) : null));
+    }
+    catch {
+        return null;
+    }
+}
+export function MediaUploadField({ label, value, onChange, onChangeField, onUpload, accept = "*", maxSizeMB = 50, disabled = false, helperText, captureSource = "both", captureMode = "photo", enableTrim = true, enableThumbnail = true, onThumbnailChange, showYoutube = false, showExternal = false, onAbort, onStagedUrlsChange, isPersisted = false, }) {
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
     const [pendingVideoUrl, setPendingVideoUrl] = useState(null);
     const [showTrimModal, setShowTrimModal] = useState(false);
     const [showThumbnailModal, setShowThumbnailModal] = useState(false);
     const [inputMode, setInputMode] = useState("file");
+    const [sourceTab, setSourceTab] = useState("upload");
+    const [ytInput, setYtInput] = useState("");
+    const [ytError, setYtError] = useState("");
+    const [extInput, setExtInput] = useState("");
+    const [extError, setExtError] = useState("");
+    const hasAlternateSources = showYoutube || showExternal;
+    function handleYtApply() {
+        const id = extractYouTubeId(ytInput);
+        if (!id) {
+            setYtError("Enter a valid YouTube video ID or URL.");
+            return;
+        }
+        const url = `https://www.youtube.com/watch?v=${id}`;
+        const thumb = `https://img.youtube.com/vi/${id}/maxresdefault.jpg`;
+        onChange(url);
+        onChangeField?.({ url, type: "video", source: "youtube", youtubeId: id, thumbnailUrl: thumb });
+        setYtError("");
+    }
+    function handleExtApply() {
+        const trimmed = extInput.trim();
+        if (!trimmed) {
+            setExtError("Enter a URL.");
+            return;
+        }
+        try {
+            new URL(trimmed);
+        }
+        catch {
+            setExtError("Enter a valid URL.");
+            return;
+        }
+        const type = /\.(mp4|webm|ogg|mov|avi)(\?|$)/i.test(trimmed) ? "video" : "image";
+        onChange(trimmed);
+        onChangeField?.({ url: trimmed, type, source: "external" });
+        setExtError("");
+    }
     const fileInputRef = useRef(null);
     const mobileCaptureRef = useRef(null);
     const stagedUrlsRef = useRef([]);
@@ -194,11 +244,14 @@ export function MediaUploadField({ label, value, onChange, onChangeField, onUplo
             setIsLoading(false);
         }
     };
-    return (_jsxs(Div, { className: "space-y-2", children: [_jsx(Label, { className: "block text-sm font-medium text-zinc-600 dark:text-zinc-400", children: label }), value && !isLoading && (_jsxs(Div, { className: "rounded-lg border border-zinc-200 dark:border-zinc-700 bg-zinc-50 dark:bg-zinc-900 p-3", children: [isVideo(value) ? (_jsx(Div, { className: "relative aspect-video overflow-hidden rounded-lg", children: _jsx(MediaVideo, { src: value, alt: label, controls: true, objectFit: "contain" }) })) : isImage(value) ? (_jsx(Div, { className: "relative aspect-video overflow-hidden rounded-lg", children: _jsx(MediaImage, { src: value, alt: label, size: "card", objectFit: "contain" }) })) : (_jsx("a", { href: value, target: "_blank", rel: "noopener noreferrer", className: "text-sm underline break-all text-blue-600 dark:text-blue-400", children: filenameFromUrl(value) })), !disabled && (_jsxs(Row, { wrap: true, gap: "sm", className: "mt-2", children: [isVideo(value) && (enableTrim || enableThumbnail) && (_jsx(Button, { type: "button", onClick: () => {
+    return (_jsxs(Div, { className: "space-y-2", children: [_jsx(Label, { className: "block text-sm font-medium text-zinc-600 dark:text-zinc-400", children: label }), hasAlternateSources && !disabled && (_jsx(Row, { gap: "none", className: "appkit-media-upload__source-tabs", children: ["upload", ...(showYoutube ? ["youtube"] : []), ...(showExternal ? ["external"] : [])].map((tab) => (_jsx("button", { type: "button", onClick: () => setSourceTab(tab), className: [
+                        "appkit-media-upload__source-tab",
+                        sourceTab === tab ? "appkit-media-upload__source-tab--active" : "",
+                    ].filter(Boolean).join(" "), children: tab === "upload" ? "Upload" : tab === "youtube" ? "YouTube" : "External URL" }, tab))) })), hasAlternateSources && sourceTab === "youtube" && !disabled && (_jsxs(Div, { className: "space-y-2", children: [_jsxs(Row, { gap: "sm", children: [_jsx("input", { type: "text", value: ytInput, onChange: (e) => { setYtInput(e.target.value); setYtError(""); }, placeholder: "YouTube video ID or URL", className: "appkit-input flex-1" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", onClick: handleYtApply, children: "Apply" })] }), ytError && _jsx(Alert, { variant: "error", children: ytError }), value?.includes("youtube.com") && (_jsxs(Text, { size: "xs", variant: "secondary", children: ["YouTube embed: ", value] }))] })), hasAlternateSources && sourceTab === "external" && !disabled && (_jsxs(Div, { className: "space-y-2", children: [_jsxs(Row, { gap: "sm", children: [_jsx("input", { type: "url", value: extInput, onChange: (e) => { setExtInput(e.target.value); setExtError(""); }, placeholder: "https://example.com/image.jpg", className: "appkit-input flex-1" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", onClick: handleExtApply, children: "Apply" })] }), extError && _jsx(Alert, { variant: "error", children: extError }), _jsx(Text, { size: "xs", variant: "secondary", children: "External URLs are stored as-is and are not watermarked." })] })), (!hasAlternateSources || sourceTab === "upload") && value && !isLoading && (_jsxs(Div, { className: "rounded-lg border border-zinc-200 dark:border-zinc-700 bg-zinc-50 dark:bg-zinc-900 p-3", children: [isVideo(value) ? (_jsx(Div, { className: "relative aspect-video overflow-hidden rounded-lg", children: _jsx(MediaVideo, { src: value, alt: label, controls: true, objectFit: "contain" }) })) : isImage(value) ? (_jsx(Div, { className: "relative aspect-video overflow-hidden rounded-lg", children: _jsx(MediaImage, { src: value, alt: label, size: "card", objectFit: "contain" }) })) : (_jsx("a", { href: value, target: "_blank", rel: "noopener noreferrer", className: "text-sm underline break-all text-blue-600 dark:text-blue-400", children: filenameFromUrl(value) })), !disabled && (_jsxs(Row, { wrap: true, gap: "sm", className: "mt-2", children: [isVideo(value) && (enableTrim || enableThumbnail) && (_jsx(Button, { type: "button", onClick: () => {
                                     setPendingVideoUrl(value);
                                     if (enableTrim)
                                         setShowTrimModal(true);
                                     else
                                         setShowThumbnailModal(true);
-                                }, variant: "secondary", size: "sm", children: tMediaEditor("editVideo") })), _jsx(Button, { type: "button", onClick: handleRemove, variant: "danger", size: "sm", children: tUpload("remove") })] }))] })), !disabled && !isLoading && (_jsxs(_Fragment, { children: [captureSource === "both" && isCameraSupported && (_jsxs(Row, { className: "gap-2", children: [_jsx(Button, { type: "button", variant: inputMode === "file" ? "primary" : "outline", size: "sm", onClick: () => setInputMode("file"), children: t("switchToUpload") }), _jsx(Button, { type: "button", variant: inputMode === "camera" ? "primary" : "outline", size: "sm", onClick: () => setInputMode("camera"), children: t("switchToCamera") })] })), showCamera && isCameraSupported && (_jsx(CameraCapture, { mode: captureMode, facingMode: "environment", onCapture: handleCameraCapture, onError: (msg) => setError(msg) })), showCamera && !isCameraSupported && (_jsx(Button, { type: "button", onClick: () => mobileCaptureRef.current?.click(), variant: "ghost", className: "w-full py-3 border-2 border-dashed border-zinc-200 dark:border-zinc-700 rounded-xl text-sm text-zinc-500 dark:text-zinc-400", children: t("switchToCamera") })), showFileInput && (_jsx(Button, { type: "button", onClick: () => fileInputRef.current?.click(), variant: "ghost", className: "w-full py-3 border-2 border-dashed border-zinc-200 dark:border-zinc-700 rounded-xl text-sm text-zinc-500 dark:text-zinc-400", children: value ? tUpload("replaceFile") : tUpload("chooseFile") }))] })), isLoading && (_jsxs(Row, { className: "gap-2", children: [_jsx(Spinner, { size: "sm" }), _jsx(Text, { size: "sm", variant: "secondary", children: tUpload("uploading") })] })), _jsx("input", { ref: fileInputRef, type: "file", accept: accept, onChange: handleFileChange, className: "hidden", "aria-hidden": "true" }), showCamera && !isCameraSupported && (_jsx("input", { ref: mobileCaptureRef, type: "file", accept: captureModeAccept, capture: "environment", onChange: handleFileChange, className: "hidden", "aria-hidden": "true" })), helperText && !error && (_jsx(Text, { variant: "secondary", size: "xs", children: helperText })), error && _jsx(Alert, { variant: "error", children: error }), pendingVideoUrl && (_jsx(VideoTrimModal, { isOpen: showTrimModal, videoUrl: pendingVideoUrl, onClose: handleTrimClose, onSave: handleTrimSave })), pendingVideoUrl && (_jsx(VideoThumbnailSelector, { isOpen: showThumbnailModal, videoUrl: pendingVideoUrl, onClose: handleThumbnailClose, onSelect: handleThumbnailSelect, onUpload: onUpload }))] }));
+                                }, variant: "secondary", size: "sm", children: tMediaEditor("editVideo") })), _jsx(Button, { type: "button", onClick: handleRemove, variant: "danger", size: "sm", children: tUpload("remove") })] }))] })), !disabled && !isLoading && (!hasAlternateSources || sourceTab === "upload") && (_jsxs(_Fragment, { children: [captureSource === "both" && isCameraSupported && (_jsxs(Row, { className: "gap-2", children: [_jsx(Button, { type: "button", variant: inputMode === "file" ? "primary" : "outline", size: "sm", onClick: () => setInputMode("file"), children: t("switchToUpload") }), _jsx(Button, { type: "button", variant: inputMode === "camera" ? "primary" : "outline", size: "sm", onClick: () => setInputMode("camera"), children: t("switchToCamera") })] })), showCamera && isCameraSupported && (_jsx(CameraCapture, { mode: captureMode, facingMode: "environment", onCapture: handleCameraCapture, onError: (msg) => setError(msg) })), showCamera && !isCameraSupported && (_jsx(Button, { type: "button", onClick: () => mobileCaptureRef.current?.click(), variant: "ghost", className: "w-full py-3 border-2 border-dashed border-zinc-200 dark:border-zinc-700 rounded-xl text-sm text-zinc-500 dark:text-zinc-400", children: t("switchToCamera") })), showFileInput && (_jsx(Button, { type: "button", onClick: () => fileInputRef.current?.click(), variant: "ghost", className: "w-full py-3 border-2 border-dashed border-zinc-200 dark:border-zinc-700 rounded-xl text-sm text-zinc-500 dark:text-zinc-400", children: value ? tUpload("replaceFile") : tUpload("chooseFile") }))] })), isLoading && (_jsxs(Row, { className: "gap-2", children: [_jsx(Spinner, { size: "sm" }), _jsx(Text, { size: "sm", variant: "secondary", children: tUpload("uploading") })] })), _jsx("input", { ref: fileInputRef, type: "file", accept: accept, onChange: handleFileChange, className: "hidden", "aria-hidden": "true" }), showCamera && !isCameraSupported && (_jsx("input", { ref: mobileCaptureRef, type: "file", accept: captureModeAccept, capture: "environment", onChange: handleFileChange, className: "hidden", "aria-hidden": "true" })), helperText && !error && (_jsx(Text, { variant: "secondary", size: "xs", children: helperText })), error && _jsx(Alert, { variant: "error", children: error }), pendingVideoUrl && (_jsx(VideoTrimModal, { isOpen: showTrimModal, videoUrl: pendingVideoUrl, onClose: handleTrimClose, onSave: handleTrimSave })), pendingVideoUrl && (_jsx(VideoThumbnailSelector, { isOpen: showThumbnailModal, videoUrl: pendingVideoUrl, onClose: handleThumbnailClose, onSelect: handleThumbnailSelect, onUpload: onUpload }))] }));
 }

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

@@ -0,0 +1,36 @@
+/**
+ * Messages / Conversations Firestore Document Types & Constants
+ *
+ * Architecture: one `conversations` document per buyer↔seller pair on a product.
+ * Messages are embedded as an array for seed purposes; production can migrate to
+ * a subcollection when the thread exceeds ~200 messages.
+ */
+export interface ConversationMessage {
+    id: string;
+    senderId: string;
+    senderRole: "buyer" | "seller";
+    body: string;
+    isRead: boolean;
+    sentAt: Date;
+    attachments?: string[];
+}
+export interface ConversationDocument {
+    id: string;
+    buyerId: string;
+    buyerDisplayName: string;
+    storeId: string;
+    storeName: string;
+    sellerDisplayName: string;
+    productId?: string;
+    productTitle?: string;
+    messages: ConversationMessage[];
+    lastMessage: string;
+    lastMessageAt: Date;
+    unreadBuyer: number;
+    unreadSeller: number;
+    status: "active" | "archived" | "blocked";
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const CONVERSATIONS_COLLECTION: "conversations";
+export declare const CONVERSATIONS_INDEXED_FIELDS: readonly ["buyerId", "storeId", "productId", "status", "lastMessageAt", "createdAt"];

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

@@ -0,0 +1,16 @@
+/**
+ * Messages / Conversations Firestore Document Types & Constants
+ *
+ * Architecture: one `conversations` document per buyer↔seller pair on a product.
+ * Messages are embedded as an array for seed purposes; production can migrate to
+ * a subcollection when the thread exceeds ~200 messages.
+ */
+export const CONVERSATIONS_COLLECTION = "conversations";
+export const CONVERSATIONS_INDEXED_FIELDS = [
+    "buyerId",
+    "storeId",
+    "productId",
+    "status",
+    "lastMessageAt",
+    "createdAt",
+];

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

@@ -85,7 +85,7 @@ declare class OrderRepository extends BaseRepository<OrderDocument> {
             canFilter: boolean;
             canSort: boolean;
         };
-        sellerId: {
+        storeId: {
             canFilter: boolean;
             canSort: boolean;
         };
@@ -176,7 +176,7 @@ declare class OrderRepository extends BaseRepository<OrderDocument> {
         userId: string;
         userName: string;
         userEmail: string;
-        sellerId?: string;
+        storeId?: string;
         amount: number;
         currency: string;
         auctionProductId: string;

package/dist/features/orders/repository/orders.repository.js

@@ -249,7 +249,7 @@ class OrderRepository extends BaseRepository {
             userId: input.userId,
             userName: input.userName,
             userEmail: input.userEmail,
-            sellerId: input.sellerId ?? null,
+            storeId: input.storeId ?? null,
             quantity: 1,
             unitPrice: input.amount,
             totalPrice: input.amount,
@@ -282,7 +282,7 @@ OrderRepository.ADMIN_SIEVE_FIELDS = {
     userId: { canFilter: true, canSort: false },
     userName: { canFilter: true, canSort: true },
     userEmail: { canFilter: true, canSort: true },
-    sellerId: { canFilter: true, canSort: false },
+    storeId: { canFilter: true, canSort: false },
     productId: { canFilter: true, canSort: false },
     productTitle: { canFilter: true, canSort: true },
     status: { canFilter: true, canSort: true },

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

@@ -54,6 +54,15 @@ export interface OrderDocumentItem {
     unitPrice: number;
     totalPrice: number;
 }
+/** One applied discount/coupon saved on the order for accounting and display */
+export interface AppliedOrderDiscount {
+    code: string;
+    couponId?: string;
+    type: "coupon" | "deal" | "auto";
+    discountAmount: number;
+    scope?: "admin" | "seller";
+    storeId?: string;
+}
 export interface OrderDocument {
     id: string;
     productId: string;
@@ -61,8 +70,8 @@ export interface OrderDocument {
     userId: string;
     userName: string;
     userEmail: string;
-    sellerId?: string;
-    sellerName?: string;
+    storeId?: string;
+    storeName?: string;
     items?: OrderDocumentItem[];
     orderType?: OrderType;
     imageUrls?: string[];
@@ -87,6 +96,10 @@ export interface OrderDocument {
     refundFeeDeducted?: number;
     refundNetAmount?: number;
     refundNote?: string;
+    couponCode?: string;
+    couponDiscount?: number;
+    /** Full list of all applied coupons/discounts for this order group */
+    appliedDiscounts?: AppliedOrderDiscount[];
     platformFee?: number;
     depositAmount?: number;
     codRemainingAmount?: number;
@@ -106,7 +119,7 @@ export interface OrderDocument {
     updatedAt: Date;
 }
 export declare const ORDER_COLLECTION: "orders";
-export declare const ORDER_INDEXED_FIELDS: readonly ["userId", "productId", "sellerId", "status", "paymentStatus", "payoutStatus", "shippingMethod", "orderDate", "createdAt"];
+export declare const ORDER_INDEXED_FIELDS: readonly ["userId", "productId", "storeId", "status", "paymentStatus", "payoutStatus", "shippingMethod", "orderDate", "createdAt"];
 export declare const DEFAULT_ORDER_DATA: Partial<OrderDocument>;
 export declare const ORDER_PUBLIC_FIELDS: readonly ["id", "productId", "productTitle", "quantity", "unitPrice", "totalPrice", "currency", "status", "paymentStatus", "shippingAddress", "trackingNumber", "notes", "orderDate", "shippingDate", "deliveryDate", "createdAt"];
 export declare const ORDER_UPDATABLE_FIELDS: readonly ["notes", "shippingAddress"];
@@ -115,7 +128,7 @@ export type OrderUpdateInput = Partial<Pick<OrderDocument, (typeof ORDER_UPDATAB
 export type OrderAdminUpdateInput = Partial<Omit<OrderDocument, "id" | "createdAt">>;
 export declare const orderQueryHelpers: {
     readonly byUser: (userId: string) => readonly ["userId", "==", string];
-    readonly bySeller: (sellerId: string) => readonly ["sellerId", "==", string];
+    readonly byStore: (storeId: string) => readonly ["storeId", "==", string];
     readonly byProduct: (productId: string) => readonly ["productId", "==", string];
     readonly byStatus: (status: OrderStatus) => readonly ["status", "==", OrderStatus];
     readonly byPaymentStatus: (status: PaymentStatus) => readonly ["paymentStatus", "==", PaymentStatus];

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

@@ -46,7 +46,7 @@ export const ORDER_COLLECTION = "orders";
 export const ORDER_INDEXED_FIELDS = [
     "userId",
     "productId",
-    "sellerId",
+    "storeId",
     "status",
     "paymentStatus",
     "payoutStatus",
@@ -80,7 +80,7 @@ export const ORDER_PUBLIC_FIELDS = [
 export const ORDER_UPDATABLE_FIELDS = ["notes", "shippingAddress"];
 export const orderQueryHelpers = {
     byUser: (userId) => ["userId", "==", userId],
-    bySeller: (sellerId) => ["sellerId", "==", sellerId],
+    byStore: (storeId) => ["storeId", "==", storeId],
     byProduct: (productId) => ["productId", "==", productId],
     byStatus: (status) => ["status", "==", status],
     byPaymentStatus: (status) => ["paymentStatus", "==", status],

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

@@ -8,24 +8,24 @@ export declare const orderItemSchema: z.ZodObject<{
     price: z.ZodNumber;
     quantity: z.ZodNumber;
     currency: z.ZodOptional<z.ZodString>;
-    sellerId: z.ZodOptional<z.ZodString>;
+    storeId: z.ZodOptional<z.ZodString>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     title: string;
     productId: string;
-    price: number;
     quantity: number;
+    price: number;
     image?: string | undefined;
-    sellerId?: string | undefined;
+    storeId?: string | undefined;
     currency?: string | undefined;
     attributes?: Record<string, string> | undefined;
 }, {
     title: string;
     productId: string;
-    price: number;
     quantity: number;
+    price: number;
     image?: string | undefined;
-    sellerId?: string | undefined;
+    storeId?: string | undefined;
     currency?: string | undefined;
     attributes?: Record<string, string> | undefined;
 }>;
@@ -68,24 +68,24 @@ export declare const orderSchema: z.ZodObject<{
         price: z.ZodNumber;
         quantity: z.ZodNumber;
         currency: z.ZodOptional<z.ZodString>;
-        sellerId: z.ZodOptional<z.ZodString>;
+        storeId: z.ZodOptional<z.ZodString>;
         attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
         title: string;
         productId: string;
-        price: number;
         quantity: number;
+        price: number;
         image?: string | undefined;
-        sellerId?: string | undefined;
+        storeId?: string | undefined;
         currency?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }, {
         title: string;
         productId: string;
-        price: number;
         quantity: number;
+        price: number;
         image?: string | undefined;
-        sellerId?: string | undefined;
+        storeId?: string | undefined;
         currency?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }>, "many">;
@@ -127,10 +127,10 @@ export declare const orderSchema: z.ZodObject<{
     items: {
         title: string;
         productId: string;
-        price: number;
         quantity: number;
+        price: number;
         image?: string | undefined;
-        sellerId?: string | undefined;
+        storeId?: string | undefined;
         currency?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }[];
@@ -143,13 +143,13 @@ export declare const orderSchema: z.ZodObject<{
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     notes?: string | undefined;
-    tax?: number | undefined;
     trackingNumber?: string | undefined;
+    tax?: number | undefined;
+    couponCode?: string | undefined;
     shippingCarrier?: string | undefined;
     paymentGateway?: string | undefined;
     shippingCost?: number | undefined;
     discount?: number | undefined;
-    couponCode?: string | undefined;
     timeline?: {
         status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested";
         timestamp: string;
@@ -162,10 +162,10 @@ export declare const orderSchema: z.ZodObject<{
     items: {
         title: string;
         productId: string;
-        price: number;
         quantity: number;
+        price: number;
         image?: string | undefined;
-        sellerId?: string | undefined;
+        storeId?: string | undefined;
         currency?: string | undefined;
         attributes?: Record<string, string> | undefined;
     }[];
@@ -178,13 +178,13 @@ export declare const orderSchema: z.ZodObject<{
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     notes?: string | undefined;
-    tax?: number | undefined;
     trackingNumber?: string | undefined;
+    tax?: number | undefined;
+    couponCode?: string | undefined;
     shippingCarrier?: string | undefined;
     paymentGateway?: string | undefined;
     shippingCost?: number | undefined;
     discount?: number | undefined;
-    couponCode?: string | undefined;
     timeline?: {
         status: "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned" | "return_requested";
         timestamp: string;

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

@@ -19,8 +19,8 @@ export const orderItemSchema = z.object({
     price: z.number(),
     quantity: z.number(),
     currency: z.string().optional(),
-    sellerId: z.string().optional(),
-    attributes: z.record(z.string()).optional(),
+    storeId: z.string().optional(),
+    attributes: z.record(z.string(), z.string()).optional(),
 });
 export const orderTimelineSchema = z.object({
     status: orderStatusSchema,
@@ -47,7 +47,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.unknown()),
+    address: z.record(z.string(), z.unknown()),
     orderStatus: orderStatusSchema,
     paymentStatus: z.string(),
     paymentGateway: z.string().optional(),

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

@@ -21,7 +21,7 @@ export interface OrderItem {
     price: number;
     quantity: number;
     currency?: string;
-    sellerId?: string;
+    storeId?: string;
     attributes?: Record<string, string>;
 }
 export interface OrderTimeline {

package/dist/features/orders/utils/order-splitter.d.ts

@@ -6,7 +6,7 @@ export interface OrderGroup<T> {
 export declare function splitCartIntoOrderGroups<T extends {
     item: {
         itemId: string;
-        sellerId?: string;
+        storeId?: string;
         isAuction?: boolean;
         isPreOrder?: boolean;
         isOffer?: boolean;

package/dist/features/orders/utils/order-splitter.js

@@ -13,11 +13,11 @@ export function splitCartIntoOrderGroups(checks) {
             orderType = "offer";
         }
         else if (item.isPreOrder) {
-            key = `preorder:${item.sellerId ?? "unknown"}`;
+            key = `preorder:${item.storeId ?? "unknown"}`;
             orderType = "preorder";
         }
         else {
-            key = `standard:${item.sellerId ?? "unknown"}`;
+            key = `standard:${item.storeId ?? "unknown"}`;
             orderType = "standard";
         }
         if (!groups.has(key)) {

package/dist/features/payments/repository/payout.repository.d.ts

@@ -24,11 +24,11 @@ export declare class PayoutRepository extends BaseRepository<PayoutDocument> {
     /**
      * Find all payouts for a specific seller, newest first
      */
-    findBySeller(sellerId: string): Promise<PayoutDocument[]>;
+    findByStore(storeId: string): Promise<PayoutDocument[]>;
     /**
      * Find payouts for a seller by status, newest first
      */
-    findBySellerAndStatus(sellerId: string, status: PayoutStatus): Promise<PayoutDocument[]>;
+    findByStoreAndStatus(storeId: string, status: PayoutStatus): Promise<PayoutDocument[]>;
     /**
      * Find payouts by status
      */
@@ -56,13 +56,13 @@ export declare class PayoutRepository extends BaseRepository<PayoutDocument> {
      * Get all order IDs that have already been paid out for a seller.
      * Used to avoid double-paying the same orders.
      */
-    getPaidOutOrderIds(sellerId: string): Promise<Set<string>>;
+    getPaidOutOrderIds(storeId: string): Promise<Set<string>>;
     static readonly SIEVE_FIELDS: {
         id: {
             canFilter: boolean;
             canSort: boolean;
         };
-        sellerId: {
+        storeId: {
             canFilter: boolean;
             canSort: boolean;
         };

package/dist/features/payments/repository/payout.repository.js

@@ -67,10 +67,10 @@ export class PayoutRepository extends BaseRepository {
     /**
      * Find all payouts for a specific seller, newest first
      */
-    async findBySeller(sellerId) {
+    async findByStore(storeId) {
         const snapshot = await this.db
             .collection(this.collection)
-            .where(PAYOUT_FIELDS.SELLER_ID, "==", sellerId)
+            .where(PAYOUT_FIELDS.STORE_ID, "==", storeId)
             .orderBy(PAYOUT_FIELDS.CREATED_AT, "desc")
             .get();
         return snapshot.docs.map((doc) => this.decryptPayout({
@@ -81,10 +81,10 @@ export class PayoutRepository extends BaseRepository {
     /**
      * Find payouts for a seller by status, newest first
      */
-    async findBySellerAndStatus(sellerId, status) {
+    async findByStoreAndStatus(storeId, status) {
         const snapshot = await this.db
             .collection(this.collection)
-            .where(PAYOUT_FIELDS.SELLER_ID, "==", sellerId)
+            .where(PAYOUT_FIELDS.STORE_ID, "==", storeId)
             .where(PAYOUT_FIELDS.STATUS, "==", status)
             .orderBy(PAYOUT_FIELDS.CREATED_AT, "desc")
             .get();
@@ -159,10 +159,10 @@ export class PayoutRepository extends BaseRepository {
      * Get all order IDs that have already been paid out for a seller.
      * Used to avoid double-paying the same orders.
      */
-    async getPaidOutOrderIds(sellerId) {
+    async getPaidOutOrderIds(storeId) {
         const snapshot = await this.db
             .collection(this.collection)
-            .where(PAYOUT_FIELDS.SELLER_ID, "==", sellerId)
+            .where(PAYOUT_FIELDS.STORE_ID, "==", storeId)
             .where(PAYOUT_FIELDS.STATUS, "in", ["pending", "processing", "completed"])
             .get();
         const ids = new Set();
@@ -187,7 +187,7 @@ export class PayoutRepository extends BaseRepository {
 // ---------------------------------------------------------------------------
 PayoutRepository.SIEVE_FIELDS = {
     id: { canFilter: true, canSort: false },
-    sellerId: { canFilter: true, canSort: false },
+    storeId: { canFilter: true, canSort: false },
     sellerEmailIndex: { canFilter: true, canSort: false },
     sellerName: { canFilter: true, canSort: true },
     sellerEmail: { canFilter: false, canSort: false }, // encrypted — use sellerEmailIndex

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

@@ -18,7 +18,7 @@ export declare const PayoutStatusValues: {
 export type PayoutPaymentMethod = "bank_transfer" | "upi";
 export interface PayoutDocument {
     id: string;
-    sellerId: string;
+    storeId: string;
     sellerName: string;
     sellerEmail: string;
     amount: number;
@@ -44,11 +44,11 @@ export interface PayoutDocument {
     updatedAt: Date;
 }
 export declare const PAYOUT_COLLECTION: "payouts";
-export declare const PAYOUT_INDEXED_FIELDS: readonly ["sellerId", "status", "requestedAt", "createdAt"];
+export declare const PAYOUT_INDEXED_FIELDS: readonly ["storeId", "status", "requestedAt", "createdAt"];
 export declare const DEFAULT_PLATFORM_FEE_RATE: 0.05;
 export declare const DEFAULT_PAYOUT_DATA: Partial<PayoutDocument>;
 export declare const PAYOUT_FIELDS: {
-    readonly SELLER_ID: "sellerId";
+    readonly STORE_ID: "storeId";
     readonly SELLER_NAME: "sellerName";
     readonly SELLER_EMAIL: "sellerEmail";
     readonly SELLER_EMAIL_INDEX: "sellerEmailIndex";
@@ -62,13 +62,13 @@ export declare const PAYOUT_FIELDS: {
         readonly FAILED: PayoutStatus;
     };
 };
-export declare const PAYOUT_PUBLIC_FIELDS: readonly ["id", "sellerId", "amount", "currency", "status", "paymentMethod", "requestedAt", "processedAt", "createdAt"];
+export declare const PAYOUT_PUBLIC_FIELDS: readonly ["id", "storeId", "amount", "currency", "status", "paymentMethod", "requestedAt", "processedAt", "createdAt"];
 export declare const PAYOUT_ADMIN_UPDATEABLE_FIELDS: readonly ["status", "adminNote", "processedAt"];
 export type PayoutCreateInput = Omit<PayoutDocument, "id" | "createdAt" | "updatedAt" | "status" | "requestedAt">;
 export type PayoutUpdateInput = Partial<Pick<PayoutDocument, (typeof PAYOUT_ADMIN_UPDATEABLE_FIELDS)[number]>>;
 export declare const payoutQueryHelpers: {
-    readonly bySeller: (sellerId: string) => readonly ["sellerId", "==", string];
+    readonly byStore: (storeId: string) => readonly ["storeId", "==", string];
     readonly byStatus: (status: PayoutStatus) => readonly ["status", "==", PayoutStatus];
-    readonly pendingForSeller: (sellerId: string) => readonly [readonly ["sellerId", "==", string], readonly ["status", "==", "pending"]];
+    readonly pendingForStore: (storeId: string) => readonly [readonly ["storeId", "==", string], readonly ["status", "==", "pending"]];
 };
 export declare function createPayoutId(input: GeneratePayoutIdInput): string;

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

@@ -10,7 +10,7 @@ export const PayoutStatusValues = {
 };
 export const PAYOUT_COLLECTION = "payouts";
 export const PAYOUT_INDEXED_FIELDS = [
-    "sellerId",
+    "storeId",
     "status",
     "requestedAt",
     "createdAt",
@@ -22,7 +22,7 @@ export const DEFAULT_PAYOUT_DATA = {
     orderIds: [],
 };
 export const PAYOUT_FIELDS = {
-    SELLER_ID: "sellerId",
+    STORE_ID: "storeId",
     SELLER_NAME: "sellerName",
     SELLER_EMAIL: "sellerEmail",
     SELLER_EMAIL_INDEX: "sellerEmailIndex",
@@ -38,7 +38,7 @@ export const PAYOUT_FIELDS = {
 };
 export const PAYOUT_PUBLIC_FIELDS = [
     "id",
-    "sellerId",
+    "storeId",
     "amount",
     "currency",
     "status",
@@ -53,10 +53,10 @@ export const PAYOUT_ADMIN_UPDATEABLE_FIELDS = [
     "processedAt",
 ];
 export const payoutQueryHelpers = {
-    bySeller: (sellerId) => ["sellerId", "==", sellerId],
+    byStore: (storeId) => ["storeId", "==", storeId],
     byStatus: (status) => ["status", "==", status],
-    pendingForSeller: (sellerId) => [
-        ["sellerId", "==", sellerId],
+    pendingForStore: (storeId) => [
+        ["storeId", "==", storeId],
         ["status", "==", "pending"],
     ],
 };