@mohasinac/appkit 2.3.1 → 2.4.0

package/dist/features/media/MediaPickerModal.js

@@ -0,0 +1,72 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback } from "react";
+import { Modal } from "../../ui/components/Modal";
+import { Button, Input, Label, Row, Stack, Text, Alert } from "../../ui";
+import { MediaUploadField } from "./upload/MediaUploadField";
+import { useMediaUpload, useMediaCleanup } from "./index";
+/**
+ * MediaPickerModal — pick or upload a media file for use in a form field.
+ *
+ * Two tabs:
+ * - Upload: drag/drop or click to upload a new file → "Use this file" button
+ * - URL: paste an external image/video URL directly
+ *
+ * @example
+ * ```tsx
+ * <MediaPickerModal
+ *   isOpen={open}
+ *   onClose={() => setOpen(false)}
+ *   onSelect={(url) => form.setValue("imageUrl", url)}
+ * />
+ * ```
+ */
+export function MediaPickerModal({ isOpen, onClose, onSelect, accept = "image/*", maxSizeMB = 10, uploadPath = "media", title = "Pick Media", }) {
+    const [tab, setTab] = useState("upload");
+    const [uploadedUrl, setUploadedUrl] = useState("");
+    const [externalUrl, setExternalUrl] = useState("");
+    const [urlError, setUrlError] = useState("");
+    const { upload } = useMediaUpload();
+    const { cleanup } = useMediaCleanup();
+    const handleUpload = useCallback((file) => upload(file, uploadPath, true), [upload, uploadPath]);
+    const handleAbort = useCallback((urls) => { void cleanup(urls); }, [cleanup]);
+    function handleUseUpload() {
+        if (!uploadedUrl)
+            return;
+        onSelect(uploadedUrl);
+        resetAndClose();
+    }
+    function handleUseExternal() {
+        const trimmed = externalUrl.trim();
+        if (!trimmed) {
+            setUrlError("Please enter a URL.");
+            return;
+        }
+        try {
+            new URL(trimmed);
+        }
+        catch {
+            setUrlError("Enter a valid URL starting with https://");
+            return;
+        }
+        onSelect(trimmed);
+        resetAndClose();
+    }
+    function resetAndClose() {
+        setUploadedUrl("");
+        setExternalUrl("");
+        setUrlError("");
+        setTab("upload");
+        onClose();
+    }
+    const tabBtnClass = (active) => [
+        "appkit-media-picker__tab-btn",
+        active ? "appkit-media-picker__tab-btn--active" : "",
+    ]
+        .filter(Boolean)
+        .join(" ");
+    return (_jsx(Modal, { isOpen: isOpen, onClose: resetAndClose, title: title, size: "lg", actions: _jsxs(Row, { gap: "sm", justify: "end", children: [_jsx(Button, { variant: "ghost", onClick: resetAndClose, children: "Cancel" }), tab === "upload" ? (_jsx(Button, { variant: "primary", onClick: handleUseUpload, disabled: !uploadedUrl, children: "Use this file" })) : (_jsx(Button, { variant: "primary", onClick: handleUseExternal, disabled: !externalUrl.trim(), children: "Use this URL" }))] }), children: _jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "none", className: "appkit-media-picker__tabs", children: [_jsx("button", { type: "button", className: tabBtnClass(tab === "upload"), onClick: () => setTab("upload"), children: "Upload file" }), _jsx("button", { type: "button", className: tabBtnClass(tab === "url"), onClick: () => setTab("url"), children: "External URL" })] }), tab === "upload" && (_jsx(MediaUploadField, { label: "File", value: uploadedUrl, onChange: setUploadedUrl, onUpload: handleUpload, accept: accept, maxSizeMB: maxSizeMB, onAbort: handleAbort })), tab === "url" && (_jsxs(Stack, { gap: "sm", children: [_jsx(Label, { htmlFor: "media-picker-url", children: "Image or video URL" }), _jsx(Input, { id: "media-picker-url", value: externalUrl, onChange: (e) => {
+                                setExternalUrl(e.target.value);
+                                setUrlError("");
+                            }, placeholder: "https://example.com/image.jpg" }), urlError && _jsx(Alert, { variant: "error", children: urlError }), _jsx(Text, { size: "sm", color: "muted", children: "External URLs are stored as-is and are not watermarked." })] }))] }) }));
+}

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

@@ -10,6 +10,8 @@ export { MediaSlider } from "./components/MediaSlider";
 export type { MediaSliderProps } from "./components/MediaSlider";
 export { useMediaUpload, useMediaAbort, useMediaCrop, useMediaTrim, useMediaCleanup, } from "./hooks/useMedia";
 export type { MediaUploadResult, MediaCropInput, MediaTrimInput, } from "./hooks/useMedia";
+export { MediaPickerModal } from "./MediaPickerModal";
+export type { MediaPickerModalProps } from "./MediaPickerModal";
 export { ImageCropModal } from "./modals/ImageCropModal";
 export type { ImageCropData, ImageCropModalProps, } from "./modals/ImageCropModal";
 export { VideoTrimModal } from "./modals/VideoTrimModal";
@@ -23,7 +25,7 @@ export type { MediaUploadFieldProps } from "./upload/MediaUploadField";
 export { MediaUploadList } from "./upload/MediaUploadList";
 export type { MediaUploadListProps } from "./upload/MediaUploadList";
 export { coerceMediaField, coerceMediaFieldArray, getMediaUrl, inferMediaTypeFromMime, mediaFieldSchema, } from "./types/index";
-export type { MediaField, MediaFieldInput, MediaFieldType, } from "./types/index";
+export type { MediaField, MediaFieldInput, MediaFieldType, MediaSource, } from "./types/index";
 export { default as CameraCapture } from "./upload/CameraCapture";
 export type { CameraCaptureProps } from "./upload/CameraCapture";
 export { AvatarUpload } from "./AvatarUpload";

package/dist/features/media/index.js

@@ -9,6 +9,7 @@ export { MediaSlider } from "./components/MediaSlider";
 // Hooks
 export { useMediaUpload, useMediaAbort, useMediaCrop, useMediaTrim, useMediaCleanup, } from "./hooks/useMedia";
 // Modals
+export { MediaPickerModal } from "./MediaPickerModal";
 export { ImageCropModal } from "./modals/ImageCropModal";
 export { VideoTrimModal } from "./modals/VideoTrimModal";
 export { VideoThumbnailSelector } from "./modals/VideoThumbnailSelector";

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

@@ -1,27 +1,39 @@
 import { z } from "zod";
 export type MediaFieldType = "image" | "video" | "file";
+/** Where the media originates: Firebase Storage upload, YouTube embed, or external URL. */
+export type MediaSource = "upload" | "youtube" | "external";
 export type MediaFieldInput = MediaField | string | null | undefined;
 export interface MediaField {
     url: string;
     type: MediaFieldType;
     alt?: string;
     thumbnailUrl?: string;
+    /** Media origin. Omitted / "upload" = Firebase Storage proxy URL. */
+    source?: MediaSource;
+    /** YouTube video ID. Only set when source === "youtube". */
+    youtubeId?: string;
 }
 export declare const mediaFieldSchema: 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;
 }>;
 export declare function coerceMediaField(value: MediaFieldInput, fallbackType?: MediaFieldType): MediaField | null;
 export declare function coerceMediaFieldArray(values: Array<MediaField | string> | null | undefined, fallbackType?: MediaFieldType): MediaField[];

package/dist/features/media/types/index.js

@@ -1,9 +1,11 @@
 import { z } from "zod";
 export const mediaFieldSchema = z.object({
-    url: z.string().url(),
+    url: z.string(),
     type: z.enum(["image", "video", "file"]),
     alt: z.string().optional(),
-    thumbnailUrl: z.string().url().optional(),
+    thumbnailUrl: z.string().optional(),
+    source: z.enum(["upload", "youtube", "external"]).optional(),
+    youtubeId: z.string().optional(),
 });
 export function coerceMediaField(value, fallbackType = "image") {
     if (!value) {

package/dist/features/media/upload/MediaUploadField.d.ts

@@ -14,6 +14,10 @@ export interface MediaUploadFieldProps {
     enableTrim?: boolean;
     enableThumbnail?: boolean;
     onThumbnailChange?: (url: string) => void;
+    /** Show a "YouTube URL" tab to embed a YouTube video by ID or URL. */
+    showYoutube?: boolean;
+    /** Show an "External URL" tab to link a third-party image/video URL. */
+    showExternal?: boolean;
     /**
      * Called with every URL that was staged (uploaded) but never persisted.
      * The parent form should call `DELETE /api/media?url=…` for each entry.
@@ -28,4 +32,4 @@ export interface MediaUploadFieldProps {
      */
     isPersisted?: boolean;
 }
-export declare function MediaUploadField({ label, value, onChange, onChangeField, onUpload, accept, maxSizeMB, disabled, helperText, captureSource, captureMode, enableTrim, enableThumbnail, onThumbnailChange, onAbort, onStagedUrlsChange, isPersisted, }: MediaUploadFieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function MediaUploadField({ label, value, onChange, onChangeField, onUpload, accept, maxSizeMB, disabled, helperText, captureSource, captureMode, enableTrim, enableThumbnail, onThumbnailChange, showYoutube, showExternal, onAbort, onStagedUrlsChange, isPersisted, }: MediaUploadFieldProps): import("react/jsx-runtime").JSX.Element;

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;
         };