@mohasinac/appkit 4.33.1 → 4.34.1

package/dist/features/seller/components/SellerProductShell.d.ts

@@ -28,6 +28,13 @@ export interface SellerProductDraft {
     insuranceCost?: number;
     gstRate?: 0 | 5 | 12 | 18 | 28;
     hsnCode?: string;
+    /**
+     * Absent means FINAL SALE — the form seeds it explicitly so the toggle has
+     * a value to render, but a draft that never touched the section still saves
+     * `undefined`, which the platform reads as final sale. Read via isFinalSale.
+     */
+    finalSale?: boolean;
+    returnPolicy?: string;
     status?: "draft" | "published";
     seoTitle?: string;
     seoDescription?: string;

package/dist/features/seller/components/SellerProductShell.js

@@ -12,6 +12,8 @@ import { QuickProductForm } from "./QuickProductForm";
 import { BarcodeField } from "./BarcodeField";
 import { pluginFor } from "../../../_internal/shared/listing-types/_registry";
 import { DEFAULT_MIN_OFFER_PERCENT } from "../../../_internal/shared/features/offers/config";
+import { PRODUCT_MAX_IMAGES, PRODUCT_MAX_VIDEOS, PRODUCT_IMAGE_INDEX_MAX, } from "../../../_internal/shared/media/limits";
+import { isFinalSale } from "../../products/constants/final-sale";
 import { normalizeError } from "../../../errors/normalize";
 import { toUserMessage } from "../../../errors/error-display-map";
 /**
@@ -46,8 +48,13 @@ const sellerProductSchema = z.object({
     category: z.string().optional(),
     brand: z.string().optional(),
     isActive: z.boolean().optional(),
-    images: z.array(z.string()).max(5, "Up to 5 gallery images allowed").optional(),
+    images: z
+        .array(z.string())
+        .max(PRODUCT_MAX_IMAGES, `Up to ${PRODUCT_MAX_IMAGES} gallery images allowed`)
+        .optional(),
     video: productVideoSchema.optional(),
+    finalSale: z.boolean().optional(),
+    returnPolicy: z.string().max(1000).optional(),
 }).passthrough();
 const CONDITION_OPTIONS = [
     { value: "new", label: "New" },
@@ -76,26 +83,64 @@ function StepBasic({ values, onChange, renderCategorySelector, renderBrandSelect
 function StepMedia({ values, onChange, storeSlug = "store", }) {
     const { upload } = useMediaUpload();
     const idxRef = useRef(0);
-    const galleryFields = (values.images ?? []).map((url) => ({
-        url,
-        type: "image",
-    }));
+    /*
+     * One control for both media kinds.
+     *
+     * The document keeps `images: string[]` and a single `video` — unchanged —
+     * so this seeds from both and splits again on write. Collapsing the two
+     * into one stored `media[]` would be a Firestore migration touching cards,
+     * detail, cart, orders and search; the input surface is what needed fixing.
+     */
+    const galleryFields = [
+        ...(values.images ?? []).map((url) => ({ url, type: "image" })),
+        ...(values.video?.url
+            ? [{
+                    url: values.video.url,
+                    type: "video",
+                    ...(values.video.thumbnailUrl ? { thumbnailUrl: values.video.thumbnailUrl } : {}),
+                }]
+            : []),
+    ];
+    /** Split a mixed gallery back into the document's two fields. */
+    const applyGallery = (fields) => {
+        const video = fields.find((f) => f.type === "video");
+        onChange({
+            images: fields.filter((f) => f.type === "image").map((f) => f.url),
+            video: video
+                ? {
+                    ...(values.video ?? { type: "video", source: "upload" }),
+                    ...video,
+                    type: "video",
+                }
+                : undefined,
+        });
+    };
     return (_jsxs(Stack, { gap: "md", children: [_jsx(ImageUpload, { currentImage: values.mainImage, onUpload: (file) => upload(file, "products", true, {
                     type: "product-image",
                     index: 1,
                     name: values.title ?? "product",
                     store: storeSlug,
                     category: values.category ?? "uncategorized",
-                }), onChange: (url) => onChange({ mainImage: url }), label: "Main Image", helperText: "Recommended: 800\u00D7800px square (JPG, PNG, WebP \u2014 max 10 MB)", enableAdvancedCrop: true, cropAspectRatio: 1 }), _jsx(MediaUploadList, { label: "Gallery Images (up to 5)", value: galleryFields, onChange: (fields) => onChange({ images: fields.map((f) => f.url) }), onUpload: (file) => {
+                }), onChange: (url) => onChange({ mainImage: url }), label: "Main Image", helperText: "Recommended: 800\u00D7800px square (JPG, PNG, WebP \u2014 max 10 MB)", enableAdvancedCrop: true, cropAspectRatio: 1 }), _jsx(MediaUploadList, { label: `Gallery (up to ${PRODUCT_MAX_IMAGES} images + ${PRODUCT_MAX_VIDEOS} video)`, value: galleryFields, onChange: applyGallery, onUpload: (file) => {
+                    /*
+                     * The gallery occupies indices 2..N — index 1 is the main image, and
+                     * `generateMediaFilename` bakes the index into the filename that the
+                     * server's `indexGuard` then checks.
+                     *
+                     * This was `idxRef.current + 1` off a ref starting at 0, so the FIRST
+                     * gallery image was index 2 and the fifth was index 6 — one past the
+                     * server's ceiling of 5. The last slot of every product form returned
+                     * a 400.
+                     */
                     idxRef.current += 1;
                     return upload(file, "products", true, {
-                        type: "product-image",
-                        index: idxRef.current + 1,
+                        type: file.type.startsWith("video/") ? "product-video" : "product-image",
+                        index: Math.min(idxRef.current + 1, PRODUCT_IMAGE_INDEX_MAX),
                         name: values.title ?? "product",
                         store: storeSlug,
                         category: values.category ?? "uncategorized",
                     });
-                }, accept: "image/*,video/*", maxItems: 5, maxSizeMB: 10, helperText: "Show multiple angles, grading details, or box contents." }), _jsx(MediaUploadField, { label: "Product Video (optional)", value: values.video?.url ?? "", onChange: (url) => onChange({
+                }, accept: "image/*,video/*", maxItems: PRODUCT_MAX_IMAGES + PRODUCT_MAX_VIDEOS, maxImages: PRODUCT_MAX_IMAGES, maxVideos: PRODUCT_MAX_VIDEOS, maxSizeMB: 50, helperText: "Show multiple angles, grading details, or box contents. A video can go here too." }), _jsx(MediaUploadField, { label: "Video options \u2014 YouTube, external URL, trim and poster", value: values.video?.url ?? "", onChange: (url) => onChange({
                     video: url
                         ? { ...(values.video ?? { type: "video", source: "upload" }), url }
                         : undefined,
@@ -103,7 +148,7 @@ function StepMedia({ values, onChange, storeSlug = "store", }) {
                     type: "product-video",
                     name: values.title ?? "product",
                     store: storeSlug,
-                }), kind: "video", helperText: "MP4, WebM or QuickTime \u2014 max 50 MB" }), _jsx(FormField, { name: "externalVideoUrl", label: "3rd-party video URL (YouTube / Vimeo)", type: "text", value: values.externalVideoUrl ?? "", onChange: (v) => onChange({ externalVideoUrl: v }), placeholder: "https://www.youtube.com/watch?v=\u2026", hint: "External video links are queued for moderation and become visible to buyers after admin approval." }), _jsx(FormField, { name: "youtubeId", label: "YouTube Video ID (optional)", type: "text", value: values.youtubeId ?? "", onChange: (v) => onChange({ youtubeId: v }), placeholder: "e.g. dQw4w9WgXcQ", helpText: "Paste the 11-character ID from the YouTube URL" })] }));
+                }), kind: "auto", helperText: "The gallery above accepts a video file directly. Use this panel for a YouTube or external URL, or to trim and pick a poster frame." }), _jsx(FormField, { name: "externalVideoUrl", label: "3rd-party video URL (YouTube / Vimeo)", type: "text", value: values.externalVideoUrl ?? "", onChange: (v) => onChange({ externalVideoUrl: v }), placeholder: "https://www.youtube.com/watch?v=\u2026", hint: "External video links are queued for moderation and become visible to buyers after admin approval." }), _jsx(FormField, { name: "youtubeId", label: "YouTube Video ID (optional)", type: "text", value: values.youtubeId ?? "", onChange: (v) => onChange({ youtubeId: v }), placeholder: "e.g. dQw4w9WgXcQ", helpText: "Paste the 11-character ID from the YouTube URL" })] }));
 }
 // ── Step 3: Auction Settings ───────────────────────────────────────────────
 function StepAuctionSettings({ values, onChange, }) {
@@ -263,6 +308,25 @@ function StepShipping({ values, onChange, renderAddressSelector, }) {
                     { value: "28", label: "28%" },
                 ] }), _jsx(FormField, { name: "hsnCode", label: "HSN Code", value: values.hsnCode ?? "", onChange: (v) => onChange({ hsnCode: v }), placeholder: "e.g. 9503" })] }));
 }
+// ── Step: Returns ─────────────────────────────────────────────────────────
+/**
+ * Final sale + return policy.
+ *
+ * `returnPolicy` had no seller-facing editor at all before this section — the
+ * only place it could be authored was the admin field group, so a seller could
+ * never state their own terms.
+ *
+ * The toggle is phrased positively ("Accept returns") rather than as
+ * "Final sale", because a switch whose ON state means "fewer rights for the
+ * buyer" reads backwards and invites the seller to flip it by accident. The
+ * stored field is still `finalSale`, and OFF is its default.
+ */
+function StepReturns({ values, onChange, }) {
+    const acceptsReturns = !isFinalSale(values);
+    return (_jsxs(Stack, { gap: "md", children: [_jsx(Toggle, { checked: acceptsReturns, onChange: (checked) => onChange({ finalSale: !checked }), label: "Accept change-of-mind returns" }), _jsx(Alert, { variant: acceptsReturns ? "info" : "warning", children: acceptsReturns
+                    ? "Buyers can return this item within the platform return window for any reason, including simply changing their mind."
+                    : "This is a FINAL SALE — the default. Buyers cannot return it for changing their mind. They can still claim if the item never arrived, arrived damaged, was the wrong item, was not as described, or was counterfeit." }), _jsx(FormField, { name: "returnPolicy", label: "Return policy (optional)", type: "textarea", value: values.returnPolicy ?? "", onChange: (v) => onChange({ returnPolicy: v }), placeholder: "Any extra detail buyers should know \u2014 condition on return, who pays return shipping, how long you take to refund.", hint: "Shown on the listing under Delivery & Returns. This is your own wording; it does not change what the platform allows above." })] }));
+}
 // ── Step: Publish / SEO ───────────────────────────────────────────────────
 function StepPublish({ values, onChange, }) {
     return (_jsxs(Stack, { gap: "md", children: [_jsx(FormField, { name: "status", label: "Listing Status", type: "select", value: values.status ?? "draft", onChange: (v) => onChange({ status: v }), options: [
@@ -276,6 +340,7 @@ const EDIT_SECTIONS = [
     { id: "media", label: "Media" },
     { id: "pricing", label: "Pricing" },
     { id: "shipping", label: "Shipping" },
+    { id: "returns", label: "Returns" },
     { id: "publish", label: "Publish" },
 ];
 // ── Main SellerProductShell ───────────────────────────────────────────────
@@ -447,6 +512,12 @@ export function SellerProductShell({ mode, listingType = "standard", initialValu
             fields: ["shippingPaidBy", "pickupAddressId", "insurance", "insuranceCost"],
             render: ({ values, onChange }) => (_jsx(StepShipping, { values: values, onChange: onChange, renderAddressSelector: renderAddressSelector })),
         },
+        {
+            id: "returns",
+            label: "Returns",
+            fields: ["finalSale", "returnPolicy"],
+            render: ({ values, onChange }) => (_jsx(StepReturns, { values: values, onChange: onChange })),
+        },
         {
             id: "publish",
             label: "Publish",
@@ -505,5 +576,5 @@ export function SellerProductShell({ mode, listingType = "standard", initialValu
         ...EDIT_SECTIONS,
         ...(typeSpecificSection ? [{ id: typeSpecificSection.id, label: typeSpecificSection.label }] : []),
     ];
-    return (_jsx(FormShell, { isOpen: true, onClose: handleDiscard, title: title, breadcrumb: breadcrumb, isDirty: isDirty, isLoading: isLoading, sections: editSections, onSaveDraft: handleSave, onPublish: handlePublish, saveLabel: "Save Changes", publishLabel: "Update", previewSlot: previewSlot, footerTopSlot: _jsx(FormShellContext.Provider, { value: shellCtx, children: _jsx(FormErrorSummary, {}) }), children: _jsx(FormShellContext.Provider, { value: shellCtx, children: _jsxs(Stack, { gap: "lg", children: [_jsxs(Section, { id: "basic", children: [_jsx(Heading, { level: 3, className: "mb-4", children: "Basic Info" }), _jsx(StepBasic, { values: draft, onChange: update, renderCategorySelector: renderCategorySelector, renderBrandSelector: renderBrandSelector, renderTemplateSelector: renderTemplateSelector })] }), _jsxs(Section, { id: "media", children: [_jsx(Heading, { level: 3, className: "mb-4", children: "Media" }), _jsx(StepMedia, { values: draft, onChange: update, storeSlug: storeSlug })] }), typeSpecificSection && (_jsxs(Section, { id: typeSpecificSection.id, children: [_jsx(Heading, { level: 3, className: "mb-4", children: typeSpecificSection.sectionHeading ?? typeSpecificSection.label }), typeSpecificSection.render({ values: draft, onChange: update, errors: {} })] })), _jsxs(Section, { id: "pricing", children: [_jsx(Heading, { level: 3, className: "mb-4", children: "Pricing" }), _jsx(StepPricing, { values: draft, onChange: update, listingType: listingType })] }), _jsxs(Section, { id: "shipping", children: [_jsx(Heading, { level: 3, className: "mb-4", children: "Shipping" }), _jsx(StepShipping, { values: draft, onChange: update, renderAddressSelector: renderAddressSelector })] }), _jsxs(Section, { id: "publish", children: [_jsx(Heading, { level: 3, className: "mb-4", children: "Publish" }), _jsx(StepPublish, { values: draft, onChange: update }), onSaveAsTemplate && (_jsxs(Div, { className: "mt-4 border-t border-[var(--appkit-color-border)]", padding: "t-md", children: [_jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onSaveAsTemplate(draft), children: "Save as Template" }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-secondary-text)]", size: "xs", children: "Save these settings as a reusable template for future listings." })] }))] })] }) }) }));
+    return (_jsx(FormShell, { isOpen: true, onClose: handleDiscard, title: title, breadcrumb: breadcrumb, isDirty: isDirty, isLoading: isLoading, sections: editSections, onSaveDraft: handleSave, onPublish: handlePublish, saveLabel: "Save Changes", publishLabel: "Update", previewSlot: previewSlot, footerTopSlot: _jsx(FormShellContext.Provider, { value: shellCtx, children: _jsx(FormErrorSummary, {}) }), children: _jsx(FormShellContext.Provider, { value: shellCtx, children: _jsxs(Stack, { gap: "lg", children: [_jsxs(Section, { id: "basic", children: [_jsx(Heading, { level: 3, className: "mb-4", children: "Basic Info" }), _jsx(StepBasic, { values: draft, onChange: update, renderCategorySelector: renderCategorySelector, renderBrandSelector: renderBrandSelector, renderTemplateSelector: renderTemplateSelector })] }), _jsxs(Section, { id: "media", children: [_jsx(Heading, { level: 3, className: "mb-4", children: "Media" }), _jsx(StepMedia, { values: draft, onChange: update, storeSlug: storeSlug })] }), typeSpecificSection && (_jsxs(Section, { id: typeSpecificSection.id, children: [_jsx(Heading, { level: 3, className: "mb-4", children: typeSpecificSection.sectionHeading ?? typeSpecificSection.label }), typeSpecificSection.render({ values: draft, onChange: update, errors: {} })] })), _jsxs(Section, { id: "pricing", children: [_jsx(Heading, { level: 3, className: "mb-4", children: "Pricing" }), _jsx(StepPricing, { values: draft, onChange: update, listingType: listingType })] }), _jsxs(Section, { id: "shipping", children: [_jsx(Heading, { level: 3, className: "mb-4", children: "Shipping" }), _jsx(StepShipping, { values: draft, onChange: update, renderAddressSelector: renderAddressSelector })] }), _jsxs(Section, { id: "returns", children: [_jsx(Heading, { level: 3, className: "mb-4", children: "Returns" }), _jsx(StepReturns, { values: draft, onChange: update })] }), _jsxs(Section, { id: "publish", children: [_jsx(Heading, { level: 3, className: "mb-4", children: "Publish" }), _jsx(StepPublish, { values: draft, onChange: update }), onSaveAsTemplate && (_jsxs(Div, { className: "mt-4 border-t border-[var(--appkit-color-border)]", padding: "t-md", children: [_jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onSaveAsTemplate(draft), children: "Save as Template" }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-secondary-text)]", size: "xs", children: "Save these settings as a reusable template for future listings." })] }))] })] }) }) }));
 }

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

@@ -8,3 +8,4 @@ export * from "./components";
 export * from "./schemas";
 export * from "./columns";
 export { manifest } from "./manifest";
+export { draftToProductInput, productToDraft } from "./utils/product-draft-mapping";

package/dist/features/seller/index.js

@@ -8,3 +8,4 @@ export * from "./components";
 export * from "./schemas";
 export * from "./columns";
 export { manifest } from "./manifest";
+export { draftToProductInput, productToDraft } from "./utils/product-draft-mapping";

package/dist/features/seller/schemas/product-form.d.ts

@@ -0,0 +1,304 @@
+import { z } from "zod";
+/**
+ * The seller listing form's DRAFT schema — the flat, form-shaped view of a
+ * product, registered as `SCHEMAS.forms.product`.
+ *
+ * ## Why this exists as a separate file
+ *
+ * It is registered so `roundtrip-diff` can check it. That tool reads
+ * `SCHEMAS.forms`, parses real documents through each registered schema, and
+ * reports every key the schema would DELETE — and its own header names
+ * `productBaseSchema` eating the `classified*` / `liveItem*` fields as the
+ * reason it was written.
+ *
+ * `product` was never registered. So the one tool built to catch exactly this
+ * bug could not see the entity the bug was about, and the registry's own
+ * docstring said why: *"an entity absent from it has no such protection,
+ * which is the whole reason to register early."*
+ *
+ * ## Draft-shaped, deliberately
+ *
+ * This models what the user TYPES — flat `classifiedCity`, `liveSpecies`,
+ * `printSize` — not what is stored. `draftToProductInput` translates between
+ * the two. `roundtrip-diff` lists `product` in its `DRAFT_SHAPED` set for the
+ * same reason `blog` and `event` are there: real documents legitimately fail
+ * to parse against a draft, and only the DROPPED-KEY half of the check is
+ * meaningful. That half is the half that matters.
+ *
+ * Kept permissive (`.passthrough()`, almost everything optional): a draft is
+ * saved continuously while half-filled, so this must accept an in-progress
+ * listing. The strict rules live in `productCreateSchema` at the write
+ * boundary, which is where refusing a bad listing is useful.
+ */
+export declare const productDraftSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    brand: z.ZodOptional<z.ZodString>;
+    condition: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    mainImage: z.ZodOptional<z.ZodString>;
+    images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    video: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodLiteral<"video">>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodLiteral<"video">>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodLiteral<"video">>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    youtubeId: z.ZodOptional<z.ZodString>;
+    externalVideoUrl: z.ZodOptional<z.ZodString>;
+    price: z.ZodOptional<z.ZodNumber>;
+    compareAtPrice: z.ZodOptional<z.ZodNumber>;
+    stockQuantity: z.ZodOptional<z.ZodNumber>;
+    featured: z.ZodOptional<z.ZodBoolean>;
+    isPromoted: z.ZodOptional<z.ZodBoolean>;
+    isNew: z.ZodOptional<z.ZodBoolean>;
+    isOnSale: z.ZodOptional<z.ZodBoolean>;
+    allowOffers: z.ZodOptional<z.ZodBoolean>;
+    minOfferPercent: z.ZodOptional<z.ZodNumber>;
+    shippingPaidBy: z.ZodOptional<z.ZodEnum<["buyer", "seller"]>>;
+    pickupAddressId: z.ZodOptional<z.ZodString>;
+    insurance: z.ZodOptional<z.ZodBoolean>;
+    insuranceCost: z.ZodOptional<z.ZodNumber>;
+    gstRate: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<5>, z.ZodLiteral<12>, z.ZodLiteral<18>, z.ZodLiteral<28>]>>;
+    hsnCode: z.ZodOptional<z.ZodString>;
+    finalSale: z.ZodOptional<z.ZodBoolean>;
+    returnPolicy: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["draft", "published"]>>;
+    seoTitle: z.ZodOptional<z.ZodString>;
+    seoDescription: z.ZodOptional<z.ZodString>;
+    barcodeId: z.ZodOptional<z.ZodString>;
+    startingBid: z.ZodOptional<z.ZodNumber>;
+    reservePrice: z.ZodOptional<z.ZodNumber>;
+    buyNowPrice: z.ZodOptional<z.ZodNumber>;
+    minBidIncrement: z.ZodOptional<z.ZodNumber>;
+    auctionEndDate: z.ZodOptional<z.ZodString>;
+    auctionShippingPaidBy: z.ZodOptional<z.ZodEnum<["winner", "seller"]>>;
+    autoExtendable: z.ZodOptional<z.ZodBoolean>;
+    auctionExtensionMinutes: z.ZodOptional<z.ZodNumber>;
+    preOrderDeliveryDate: z.ZodOptional<z.ZodString>;
+    preOrderDepositPercent: z.ZodOptional<z.ZodNumber>;
+    preOrderMaxQuantity: z.ZodOptional<z.ZodNumber>;
+    preOrderProductionStatus: z.ZodOptional<z.ZodEnum<["upcoming", "in_production", "ready_to_ship"]>>;
+    preOrderCancellable: z.ZodOptional<z.ZodBoolean>;
+    classifiedCity: z.ZodOptional<z.ZodString>;
+    classifiedLocality: z.ZodOptional<z.ZodString>;
+    classifiedPincode: z.ZodOptional<z.ZodString>;
+    classifiedContactMethod: z.ZodOptional<z.ZodEnum<["chat", "phone", "both"]>>;
+    classifiedAcceptsShipping: z.ZodOptional<z.ZodBoolean>;
+    classifiedNegotiable: z.ZodOptional<z.ZodBoolean>;
+    digitalCodeDelivery: z.ZodOptional<z.ZodEnum<["auto-claim", "manual-email"]>>;
+    digitalCodePoolSize: z.ZodOptional<z.ZodNumber>;
+    digitalCodeRedemptionInstructions: z.ZodOptional<z.ZodString>;
+    digitalCodeExpiresAt: z.ZodOptional<z.ZodString>;
+    liveSpecies: z.ZodOptional<z.ZodString>;
+    liveAgeMonths: z.ZodOptional<z.ZodNumber>;
+    liveSex: z.ZodOptional<z.ZodEnum<["male", "female", "unknown", "n/a"]>>;
+    liveCareInfo: z.ZodOptional<z.ZodString>;
+    liveTransportMethod: z.ZodOptional<z.ZodEnum<["courier", "in-person", "specialist"]>>;
+    liveHandlingFee: z.ZodOptional<z.ZodNumber>;
+    liveJurisdictions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    liveCites: z.ZodOptional<z.ZodBoolean>;
+    printSize: z.ZodOptional<z.ZodString>;
+    printMaterial: z.ZodOptional<z.ZodString>;
+    printFinish: z.ZodOptional<z.ZodString>;
+    printEditionSize: z.ZodOptional<z.ZodNumber>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    title: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    brand: z.ZodOptional<z.ZodString>;
+    condition: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    mainImage: z.ZodOptional<z.ZodString>;
+    images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    video: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodLiteral<"video">>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodLiteral<"video">>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodLiteral<"video">>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    youtubeId: z.ZodOptional<z.ZodString>;
+    externalVideoUrl: z.ZodOptional<z.ZodString>;
+    price: z.ZodOptional<z.ZodNumber>;
+    compareAtPrice: z.ZodOptional<z.ZodNumber>;
+    stockQuantity: z.ZodOptional<z.ZodNumber>;
+    featured: z.ZodOptional<z.ZodBoolean>;
+    isPromoted: z.ZodOptional<z.ZodBoolean>;
+    isNew: z.ZodOptional<z.ZodBoolean>;
+    isOnSale: z.ZodOptional<z.ZodBoolean>;
+    allowOffers: z.ZodOptional<z.ZodBoolean>;
+    minOfferPercent: z.ZodOptional<z.ZodNumber>;
+    shippingPaidBy: z.ZodOptional<z.ZodEnum<["buyer", "seller"]>>;
+    pickupAddressId: z.ZodOptional<z.ZodString>;
+    insurance: z.ZodOptional<z.ZodBoolean>;
+    insuranceCost: z.ZodOptional<z.ZodNumber>;
+    gstRate: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<5>, z.ZodLiteral<12>, z.ZodLiteral<18>, z.ZodLiteral<28>]>>;
+    hsnCode: z.ZodOptional<z.ZodString>;
+    finalSale: z.ZodOptional<z.ZodBoolean>;
+    returnPolicy: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["draft", "published"]>>;
+    seoTitle: z.ZodOptional<z.ZodString>;
+    seoDescription: z.ZodOptional<z.ZodString>;
+    barcodeId: z.ZodOptional<z.ZodString>;
+    startingBid: z.ZodOptional<z.ZodNumber>;
+    reservePrice: z.ZodOptional<z.ZodNumber>;
+    buyNowPrice: z.ZodOptional<z.ZodNumber>;
+    minBidIncrement: z.ZodOptional<z.ZodNumber>;
+    auctionEndDate: z.ZodOptional<z.ZodString>;
+    auctionShippingPaidBy: z.ZodOptional<z.ZodEnum<["winner", "seller"]>>;
+    autoExtendable: z.ZodOptional<z.ZodBoolean>;
+    auctionExtensionMinutes: z.ZodOptional<z.ZodNumber>;
+    preOrderDeliveryDate: z.ZodOptional<z.ZodString>;
+    preOrderDepositPercent: z.ZodOptional<z.ZodNumber>;
+    preOrderMaxQuantity: z.ZodOptional<z.ZodNumber>;
+    preOrderProductionStatus: z.ZodOptional<z.ZodEnum<["upcoming", "in_production", "ready_to_ship"]>>;
+    preOrderCancellable: z.ZodOptional<z.ZodBoolean>;
+    classifiedCity: z.ZodOptional<z.ZodString>;
+    classifiedLocality: z.ZodOptional<z.ZodString>;
+    classifiedPincode: z.ZodOptional<z.ZodString>;
+    classifiedContactMethod: z.ZodOptional<z.ZodEnum<["chat", "phone", "both"]>>;
+    classifiedAcceptsShipping: z.ZodOptional<z.ZodBoolean>;
+    classifiedNegotiable: z.ZodOptional<z.ZodBoolean>;
+    digitalCodeDelivery: z.ZodOptional<z.ZodEnum<["auto-claim", "manual-email"]>>;
+    digitalCodePoolSize: z.ZodOptional<z.ZodNumber>;
+    digitalCodeRedemptionInstructions: z.ZodOptional<z.ZodString>;
+    digitalCodeExpiresAt: z.ZodOptional<z.ZodString>;
+    liveSpecies: z.ZodOptional<z.ZodString>;
+    liveAgeMonths: z.ZodOptional<z.ZodNumber>;
+    liveSex: z.ZodOptional<z.ZodEnum<["male", "female", "unknown", "n/a"]>>;
+    liveCareInfo: z.ZodOptional<z.ZodString>;
+    liveTransportMethod: z.ZodOptional<z.ZodEnum<["courier", "in-person", "specialist"]>>;
+    liveHandlingFee: z.ZodOptional<z.ZodNumber>;
+    liveJurisdictions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    liveCites: z.ZodOptional<z.ZodBoolean>;
+    printSize: z.ZodOptional<z.ZodString>;
+    printMaterial: z.ZodOptional<z.ZodString>;
+    printFinish: z.ZodOptional<z.ZodString>;
+    printEditionSize: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    title: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    brand: z.ZodOptional<z.ZodString>;
+    condition: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    mainImage: z.ZodOptional<z.ZodString>;
+    images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    video: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodLiteral<"video">>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodLiteral<"video">>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodLiteral<"video">>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    youtubeId: z.ZodOptional<z.ZodString>;
+    externalVideoUrl: z.ZodOptional<z.ZodString>;
+    price: z.ZodOptional<z.ZodNumber>;
+    compareAtPrice: z.ZodOptional<z.ZodNumber>;
+    stockQuantity: z.ZodOptional<z.ZodNumber>;
+    featured: z.ZodOptional<z.ZodBoolean>;
+    isPromoted: z.ZodOptional<z.ZodBoolean>;
+    isNew: z.ZodOptional<z.ZodBoolean>;
+    isOnSale: z.ZodOptional<z.ZodBoolean>;
+    allowOffers: z.ZodOptional<z.ZodBoolean>;
+    minOfferPercent: z.ZodOptional<z.ZodNumber>;
+    shippingPaidBy: z.ZodOptional<z.ZodEnum<["buyer", "seller"]>>;
+    pickupAddressId: z.ZodOptional<z.ZodString>;
+    insurance: z.ZodOptional<z.ZodBoolean>;
+    insuranceCost: z.ZodOptional<z.ZodNumber>;
+    gstRate: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<5>, z.ZodLiteral<12>, z.ZodLiteral<18>, z.ZodLiteral<28>]>>;
+    hsnCode: z.ZodOptional<z.ZodString>;
+    finalSale: z.ZodOptional<z.ZodBoolean>;
+    returnPolicy: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["draft", "published"]>>;
+    seoTitle: z.ZodOptional<z.ZodString>;
+    seoDescription: z.ZodOptional<z.ZodString>;
+    barcodeId: z.ZodOptional<z.ZodString>;
+    startingBid: z.ZodOptional<z.ZodNumber>;
+    reservePrice: z.ZodOptional<z.ZodNumber>;
+    buyNowPrice: z.ZodOptional<z.ZodNumber>;
+    minBidIncrement: z.ZodOptional<z.ZodNumber>;
+    auctionEndDate: z.ZodOptional<z.ZodString>;
+    auctionShippingPaidBy: z.ZodOptional<z.ZodEnum<["winner", "seller"]>>;
+    autoExtendable: z.ZodOptional<z.ZodBoolean>;
+    auctionExtensionMinutes: z.ZodOptional<z.ZodNumber>;
+    preOrderDeliveryDate: z.ZodOptional<z.ZodString>;
+    preOrderDepositPercent: z.ZodOptional<z.ZodNumber>;
+    preOrderMaxQuantity: z.ZodOptional<z.ZodNumber>;
+    preOrderProductionStatus: z.ZodOptional<z.ZodEnum<["upcoming", "in_production", "ready_to_ship"]>>;
+    preOrderCancellable: z.ZodOptional<z.ZodBoolean>;
+    classifiedCity: z.ZodOptional<z.ZodString>;
+    classifiedLocality: z.ZodOptional<z.ZodString>;
+    classifiedPincode: z.ZodOptional<z.ZodString>;
+    classifiedContactMethod: z.ZodOptional<z.ZodEnum<["chat", "phone", "both"]>>;
+    classifiedAcceptsShipping: z.ZodOptional<z.ZodBoolean>;
+    classifiedNegotiable: z.ZodOptional<z.ZodBoolean>;
+    digitalCodeDelivery: z.ZodOptional<z.ZodEnum<["auto-claim", "manual-email"]>>;
+    digitalCodePoolSize: z.ZodOptional<z.ZodNumber>;
+    digitalCodeRedemptionInstructions: z.ZodOptional<z.ZodString>;
+    digitalCodeExpiresAt: z.ZodOptional<z.ZodString>;
+    liveSpecies: z.ZodOptional<z.ZodString>;
+    liveAgeMonths: z.ZodOptional<z.ZodNumber>;
+    liveSex: z.ZodOptional<z.ZodEnum<["male", "female", "unknown", "n/a"]>>;
+    liveCareInfo: z.ZodOptional<z.ZodString>;
+    liveTransportMethod: z.ZodOptional<z.ZodEnum<["courier", "in-person", "specialist"]>>;
+    liveHandlingFee: z.ZodOptional<z.ZodNumber>;
+    liveJurisdictions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    liveCites: z.ZodOptional<z.ZodBoolean>;
+    printSize: z.ZodOptional<z.ZodString>;
+    printMaterial: z.ZodOptional<z.ZodString>;
+    printFinish: z.ZodOptional<z.ZodString>;
+    printEditionSize: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ProductDraftInput = z.infer<typeof productDraftSchema>;

package/dist/features/seller/schemas/product-form.js

@@ -0,0 +1,132 @@
+import { z } from "zod";
+import { PRODUCT_MAX_IMAGES } from "../../../_internal/shared/media/limits";
+/**
+ * The seller listing form's DRAFT schema — the flat, form-shaped view of a
+ * product, registered as `SCHEMAS.forms.product`.
+ *
+ * ## Why this exists as a separate file
+ *
+ * It is registered so `roundtrip-diff` can check it. That tool reads
+ * `SCHEMAS.forms`, parses real documents through each registered schema, and
+ * reports every key the schema would DELETE — and its own header names
+ * `productBaseSchema` eating the `classified*` / `liveItem*` fields as the
+ * reason it was written.
+ *
+ * `product` was never registered. So the one tool built to catch exactly this
+ * bug could not see the entity the bug was about, and the registry's own
+ * docstring said why: *"an entity absent from it has no such protection,
+ * which is the whole reason to register early."*
+ *
+ * ## Draft-shaped, deliberately
+ *
+ * This models what the user TYPES — flat `classifiedCity`, `liveSpecies`,
+ * `printSize` — not what is stored. `draftToProductInput` translates between
+ * the two. `roundtrip-diff` lists `product` in its `DRAFT_SHAPED` set for the
+ * same reason `blog` and `event` are there: real documents legitimately fail
+ * to parse against a draft, and only the DROPPED-KEY half of the check is
+ * meaningful. That half is the half that matters.
+ *
+ * Kept permissive (`.passthrough()`, almost everything optional): a draft is
+ * saved continuously while half-filled, so this must accept an in-progress
+ * listing. The strict rules live in `productCreateSchema` at the write
+ * boundary, which is where refusing a bad listing is useful.
+ */
+export const productDraftSchema = z
+    .object({
+    title: z.string().max(200).optional(),
+    slug: z.string().optional(),
+    description: z.string().max(10000).optional(),
+    category: z.string().optional(),
+    brand: z.string().optional(),
+    condition: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    // Media
+    mainImage: z.string().optional(),
+    images: z.array(z.string()).max(PRODUCT_MAX_IMAGES).optional(),
+    /*
+     * Spelled out rather than `z.record(z.unknown())`: a draft's video can
+     * come from an upload, a YouTube id or an external URL, and each source
+     * fills a different subset. Naming the fields is what lets this schema
+     * report a video the form would fail to carry.
+     */
+    video: z
+        .object({
+        url: z.string(),
+        type: z.literal("video").optional(),
+        thumbnailUrl: z.string().optional(),
+        source: z.enum(["upload", "youtube", "external"]).optional(),
+        youtubeId: z.string().optional(),
+        duration: z.number().optional(),
+    })
+        .passthrough()
+        .optional(),
+    youtubeId: z.string().optional(),
+    externalVideoUrl: z.string().optional(),
+    // Pricing
+    price: z.number().optional(),
+    compareAtPrice: z.number().optional(),
+    stockQuantity: z.number().optional(),
+    featured: z.boolean().optional(),
+    isPromoted: z.boolean().optional(),
+    isNew: z.boolean().optional(),
+    isOnSale: z.boolean().optional(),
+    allowOffers: z.boolean().optional(),
+    minOfferPercent: z.number().optional(),
+    // Shipping
+    shippingPaidBy: z.enum(["buyer", "seller"]).optional(),
+    pickupAddressId: z.string().optional(),
+    insurance: z.boolean().optional(),
+    insuranceCost: z.number().optional(),
+    gstRate: z.union([z.literal(0), z.literal(5), z.literal(12), z.literal(18), z.literal(28)]).optional(),
+    hsnCode: z.string().optional(),
+    // Returns
+    finalSale: z.boolean().optional(),
+    returnPolicy: z.string().max(1000).optional(),
+    // Publish
+    status: z.enum(["draft", "published"]).optional(),
+    seoTitle: z.string().optional(),
+    seoDescription: z.string().optional(),
+    barcodeId: z.string().optional(),
+    // Auction
+    startingBid: z.number().optional(),
+    reservePrice: z.number().optional(),
+    buyNowPrice: z.number().optional(),
+    minBidIncrement: z.number().optional(),
+    auctionEndDate: z.string().optional(),
+    auctionShippingPaidBy: z.enum(["winner", "seller"]).optional(),
+    autoExtendable: z.boolean().optional(),
+    auctionExtensionMinutes: z.number().optional(),
+    // Pre-order
+    preOrderDeliveryDate: z.string().optional(),
+    preOrderDepositPercent: z.number().optional(),
+    preOrderMaxQuantity: z.number().optional(),
+    preOrderProductionStatus: z.enum(["upcoming", "in_production", "ready_to_ship"]).optional(),
+    preOrderCancellable: z.boolean().optional(),
+    // Classified — FLAT here, nested on the document.
+    classifiedCity: z.string().optional(),
+    classifiedLocality: z.string().optional(),
+    classifiedPincode: z.string().optional(),
+    classifiedContactMethod: z.enum(["chat", "phone", "both"]).optional(),
+    classifiedAcceptsShipping: z.boolean().optional(),
+    classifiedNegotiable: z.boolean().optional(),
+    // Digital code — FLAT here, nested on the document.
+    digitalCodeDelivery: z.enum(["auto-claim", "manual-email"]).optional(),
+    digitalCodePoolSize: z.number().optional(),
+    digitalCodeRedemptionInstructions: z.string().optional(),
+    digitalCodeExpiresAt: z.string().optional(),
+    // Live item — FLAT here, nested on the document.
+    liveSpecies: z.string().optional(),
+    liveAgeMonths: z.number().optional(),
+    liveSex: z.enum(["male", "female", "unknown", "n/a"]).optional(),
+    liveCareInfo: z.string().optional(),
+    liveTransportMethod: z.enum(["courier", "in-person", "specialist"]).optional(),
+    liveHandlingFee: z.number().optional(),
+    liveJurisdictions: z.array(z.string()).optional(),
+    liveCites: z.boolean().optional(),
+    // Print meta (art + stickers) — FLAT here, nested on the document.
+    printSize: z.string().optional(),
+    printMaterial: z.string().optional(),
+    printFinish: z.string().optional(),
+    printEditionSize: z.number().optional(),
+})
+    .passthrough();