@mohasinac/appkit 4.33.0 → 4.34.0

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();

package/dist/features/seller/utils/product-draft-mapping.d.ts

@@ -0,0 +1,117 @@
+import type { SellerProductDraft } from "../components/SellerProductShell";
+/**
+ * Seller listing form draft <-> product write payload.
+ *
+ * ## The bug this closes
+ *
+ * `SellerProductDraft` is FLAT — `classifiedCity`, `liveSpecies`,
+ * `digitalCodeDelivery`, `printSize` — because that is the shape a form wants:
+ * one key per control, no nesting to thread through `onChange`.
+ *
+ * `productCreateSchema` is NESTED — `classified.meetupArea.city`,
+ * `liveItem.species`, `digitalCode.codeDeliveryMethod`, `printMeta.size` —
+ * because that is the shape `ProductDocument` stores.
+ *
+ * Nothing translated between them. Every `store/*\/new/page.tsx` spread the
+ * draft straight into `createSellerProductAction`, and `productBaseSchema` is
+ * a plain `z.object()` with no `.passthrough()`, so **every flat per-type key
+ * was stripped before the write**. A seller filled in a classified's meetup
+ * city, a live animal's species and permitted jurisdictions, a digital code's
+ * delivery method, or an art print's size and edition — pressed Publish, got a
+ * success toast — and the listing was saved without the fields that made it
+ * that KIND of listing.
+ *
+ * ## Why this lives in the ACTION, not in the pages
+ *
+ * There are ~10 `new/page.tsx` and ~10 `[id]/edit/page.tsx` files and every
+ * one of them does `{ ...draft, listingType, status }`. Applying the mapping
+ * at each is 20 chances to forget, and a new listing type's page would start
+ * out broken in exactly the way this fixes. `createSellerProductAction` and
+ * `sellerUpdateProductAction` are the single choke point every seller write
+ * already passes through, so the mapping happens once and cannot be bypassed
+ * by a page that did not know about it (the lesson of Root Cause #75).
+ *
+ * ## Round-trip
+ *
+ * `draftToProductInput` and `productToDraft` are a matched pair in one file so
+ * they cannot drift: a field added to one and not the other is visible in a
+ * single screen of code. The edit pages need the inverse to seed the form from
+ * a stored document.
+ */
+/**
+ * The parts of a stored product this mapper reads.
+ *
+ * Declared structurally rather than importing `ProductDocument`: the inbound
+ * value comes from a server action's `JsonValue` payload where dates are
+ * strings, and every block is optional because documents written before the
+ * nested shapes existed carry none of them.
+ */
+export interface StoredProductBlocks {
+    finalSale?: boolean;
+    returnPolicy?: string;
+    classified?: {
+        meetupArea?: {
+            city?: string;
+            locality?: string;
+            pincode?: string;
+        };
+        acceptsShipping?: boolean;
+        negotiable?: boolean;
+    };
+    digitalCode?: {
+        codeDeliveryMethod?: string;
+        codePoolSize?: number;
+        redemptionInstructions?: string;
+        expiresAt?: string;
+    };
+    liveItem?: {
+        species?: string;
+        ageMonths?: number;
+        sex?: string;
+        careInfo?: string;
+        transport?: {
+            method?: string;
+            handlingFee?: number;
+        };
+        jurisdictionAllowed?: string[];
+        cites?: string;
+    };
+    printMeta?: {
+        size?: string;
+        material?: string;
+        finish?: string;
+        editionSize?: number;
+    };
+}
+/**
+ * The nested blocks this mapper WRITES, plus whatever else the draft carried.
+ * `ProductWritePayload` is deliberately not `ProductDocument`: the draft holds
+ * form-shaped values (ISO date strings, a `MediaField` video) that the write
+ * schema coerces, so typing it as the document would be a lie the compiler
+ * would then make everyone cast around.
+ */
+export interface ProductWritePayload {
+    classified?: NonNullable<StoredProductBlocks["classified"]>;
+    digitalCode?: NonNullable<StoredProductBlocks["digitalCode"]>;
+    liveItem?: NonNullable<StoredProductBlocks["liveItem"]>;
+    printMeta?: NonNullable<StoredProductBlocks["printMeta"]>;
+    [key: string]: unknown;
+}
+/**
+ * Fold the draft's flat per-type keys into the nested blocks the write schema
+ * expects. Every other key passes through untouched.
+ *
+ * A block is emitted only when the draft actually carries something for it, so
+ * saving a standard listing does not write an empty `classified: {}`.
+ */
+export declare function draftToProductInput(draft: SellerProductDraft & {
+    [key: string]: unknown;
+}): ProductWritePayload;
+/**
+ * The inverse — seed the form from a stored document.
+ *
+ * Tolerant of documents written before the nested blocks existed: a missing
+ * block yields undefined flat keys, which render as empty inputs rather than
+ * throwing.
+ */
+export declare function productToDraft(product: StoredProductBlocks): Partial<SellerProductDraft>;